You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8834742
Browse filesBrowse the repository at this point in the historyBrowse files
feat(daemon): let a finishing mutation record the tree it acted through (#3471)
The history the gate reads. The session's deferred surface becomes a two-variant
claim — `stabilize` (the capture side still owes a quiet-window loop) or
`recheck` (a mutation dispatched through a captured tree whose own effect may
still be animating) — and a mutation that resolved a target records that tree at
the instant it finished, so the next press can ask whether its own coordinates
are still in play. ADR 0014's device side-effect seam retires the record, and a
press never erases a stabilization the capture side still owes.
The `targetStability` matrix cells, their Layer-3 scenarios on both runtime
paths, and the caller-facing help/docs land with it: the refusal is observable
from here.
Closes#3471.
"Intentional: the fused runner request queries the element and taps it inside one XCTest request, so the runner aims at the element's own live frame at tap time rather than at a rect the daemon captured earlier and carried across a round trip — the capture-to-dispatch distance #3471 closes does not exist on this route. Its hittability semantics stay the runner's, as the offscreen cell above already records.",
228
+
};
229
+
196
230
// The two runtime tree paths (selector and ref resolution) run the SAME shared
197
231
// guard/observation implementations; only how the target is found
198
232
// (disambiguation) and how failures are described (errorTaxonomy) differ.
'gap: target-authored drag has no --settle/--verify observation of the destination; the tap-shaped runtime paths are the only ones with an opt-in evidence route today.',
391
426
trackingIssue: GAPS_UMBRELLA_ISSUE,
392
427
},
428
+
targetStability: {
429
+
kind: 'inapplicable',
430
+
reason:
431
+
"Drag endpoints name contact coordinates for one uninterrupted pointer plan (ADR 0013); re-pointing an endpoint after resolution would split the plan the gesture's integrity depends on, and a drag whose surface moved mid-gesture is the surface behavior, not a misaimed tap. #3471 guards the tap-shaped paths, where one captured point is the whole action.",
'gap: the fast path observes no post-action outcome by default; --settle/--verify disable it and delegate to runtime-ref instead of running here.',
476
516
trackingIssue: GAPS_UMBRELLA_ISSUE,
477
517
},
518
+
targetStability: {
519
+
kind: 'inapplicable',
520
+
reason:
521
+
'The fast path activates a provider-owned semantic handle rather than a point the daemon aimed from a capture, so there is no daemon-captured position that could have gone stale — the exposure #3471 guards is created by capture-to-dispatch distance and this path has none. Where the daemon does read a rect on this path, its preflight reads the same stored node the other guards judge.',
'Coordinates name a point, not an element; there is no target existence to wait for.',
539
584
},
540
585
outcomeObservation: TAP_OUTCOME_NOT_OBSERVED_GAP,
586
+
targetStability: {
587
+
kind: 'inapplicable',
588
+
reason:
589
+
'Coordinates are the escape hatch that dispatches the point it was given; there is no resolved element whose position could be confirmed, and re-resolving a caller-authored coordinate would replace the instruction rather than verify it.',
Copy file name to clipboardExpand all lines: src/commands/interaction/metadata.ts
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -57,9 +57,9 @@ const FIND_ACTION_VALUES = [
57
57
58
58
constinteractionCommandDescriptions={
59
59
click:
60
-
'Activate a UI target by snapshot ref, selector, or coordinates. Prefer a ref or selector after a snapshot; use coordinates only when semantic targeting is unavailable. This can change app state. Success means the click was dispatched, not that it landed: use settle or verify to confirm the result without a follow-up snapshot, or wait for the expected screen.',
60
+
"Activate a UI target by snapshot ref, selector, or coordinates. Prefer a ref or selector after a snapshot; use coordinates only when semantic targeting is unavailable. This can change app state. Success means the click was dispatched, not that it landed: use settle or verify to confirm the result without a follow-up snapshot, or wait for the expected screen. A target still moving shortly after the session's previous action is re-observed and tapped at its resting position; one that has not stopped refuses with target_still_moving rather than tapping where it was.",
61
61
press:
62
-
'Short-press a UI target by snapshot ref, selector, or coordinates. Use longpress instead when the target requires a context-menu or hold gesture. Success means the press was dispatched, not that it landed: use settle or verify to confirm the result, or wait for the expected screen.',
62
+
"Short-press a UI target by snapshot ref, selector, or coordinates. Use longpress instead when the target requires a context-menu or hold gesture. Success means the press was dispatched, not that it landed: use settle or verify to confirm the result, or wait for the expected screen. A target still moving shortly after the session's previous action is re-observed and tapped at its resting position; one that has not stopped refuses with target_still_moving rather than tapping where it was.",
63
63
fill: 'Replace text in a UI input selected by snapshot ref, selector, or coordinates. Pass an empty text to clear the field. Inspect unconfirmed evidence and assert the expected value or resulting screen before continuing. Prefer refs or selectors after snapshot; use recordAs to keep sensitive text out of a recorded replay while sending it to the live app.',
64
64
longpress:
65
65
'Hold a UI target by snapshot ref, selector, or coordinates to open a context menu or perform another hold gesture. Set durationMs when the default hold duration is unsuitable.',
0 commit comments