Skip to content

Commit e36f117

Browse files
authored
docs(help): stale pinned refs are rejected on every platform, not just iOS (#3496)
ADR 0014 ref-frame admission is a daemon-side, platform-neutral decision (src/daemon/ref-frame.ts admitRefMutation): a pin whose generation was superseded, or whose frame expired, is refused with ref_generation_mismatch/ref_frame_expired on all platforms. The help workflow line still described pre-ADR iOS-only behavior. Closes #3489
1 parent c5bb0a2 commit e36f117

2 files changed

Lines changed: 2 additions & 2 deletions

File tree

‎src/commands/schema/cli-help-topics.test.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -197,7 +197,7 @@ test('usageForCommand resolves workflow help topic', async () => {
197197
assert.match(help, /never a placeholder \(@ref, @eN, @Label_Name\)/);
198198
assert.match(
199199
help,
200-
/iOS rejects a stale pinned ref -- refresh with snapshot -i or use a selector/,
200+
/every platform rejects a stale pinned ref -- refresh with snapshot -i or use a selector/,
201201
);
202202
assert.match(help, /Known flow: batch --steps-file \.\/steps\.json \(help batch\)/);
203203
assert.match(help, /Shapes and platform quirks: help gestures/);

‎src/commands/schema/cli-help.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ Command shapes, refs, selectors, waits, recovery, and platform limits for open -
8787
Command shape:
8888
Command lines only -- no prose, numbering, fences, pipes, or grep/head/tail/jq; raw output carries refs/hints for the next step. Order: subcommand, positionals, flags: agent-device open com.example.app --session checkout --platform android --relaunch
8989
Chain confident consecutive steps with &&: press 'label="Search"' --settle && fill 'label="Search"' "query" --settle. Fall back to one command at a time when a step is uncertain (ambiguous match, network-backed result, unseen screen).
90-
Refs look like @e12; use the exact ref from the latest snapshot -i, never a placeholder (@ref, @eN, @Label_Name). Pin with ~s<n> (press @e12~s4); iOS rejects a stale pinned ref -- refresh with snapshot -i or use a selector.
90+
Refs look like @e12; use the exact ref from the latest snapshot -i, never a placeholder (@ref, @eN, @Label_Name). Pin with ~s<n> (press @e12~s4); every platform rejects a stale pinned ref -- refresh with snapshot -i or use a selector.
9191
close = agent-device close. App back is back; system back is back --system. Taps are press/click. type never takes --settle: run type, then diff snapshot to verify. Known flow: batch --steps-file ./steps.json (help batch).
9292
Gestures: scroll/swipe for lists/flicks; gesture pan|fling|pinch|rotate|transform|drag for multi-touch. Shapes and platform quirks: help gestures.
9393

0 commit comments

Comments
 (0)