Repository navigation
docs(skills): document observe --ttl and --full-screen in cu-automation skill - #6
Merged
Merged
Conversation
…on skill - Step 2 covers both capture selectors: --region and --full-screen <display_id[,display_id...]> with verbatim IDs from cu displays, mutually exclusive, no implicit current-desktop target - TTL note documents --ttl <positive-whole-seconds|unlimited>, expiresAt null for unlimited, checkpoint TTL inheritance, and the retryable:true recovery for observation_expired - Checkpoint branch notes TTL + capture-selection inheritance so agents keep reading coordinates off checkpoint.imagePath
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Completes the
cu-automationskill (added in #5) with the twoobserveoptions introduced in #4 that Step 2 did not yet cover:--regionand--full-screen <display_id[,display_id...]>— verbatim IDs fromcu displays, mutually exclusive with--region/--display, no implicit current-desktop target.--ttl <positive-whole-seconds|unlimited>(expiresAt: nullfor unlimited), checkpoint TTL inheritance, and theretryable: truerecovery forobservation_expired.checkpoint.imagePath.Contract And Safety Impact
.cu/state are absent from the diff.Contracts need no update: every statement added here mirrors
cu help observe,docs/design/cli-contract.md, andcli-receipts.mdfrom #4 (verified againstparseObservationTtl,parseDisplayIdList, and the checkpoint path insrc/act.tspassingttlMs: source.observationTtlMswith a rebuilt same-kind selector).Verification
npm run typecheck(clean)npm run build(clean)observe-cli.test.js+init-help.e2e.test.js— 23 pass, 0 failEffects Performed
None — read-only change and verification were side-effect free apart from the local build output (
dist/, ignored).Documentation
CHANGELOG.mdupdated for user-visible behavior.CHANGELOG not updated: preview changelog tracks released behavior; this only aligns skill guidance with already-shipped #4 behavior.
Residual Risk
dsp_…,obs_…); agents must copy real IDs from receipts.skills/(e.g. pisettings.jsonskills entry).