Skip to content

Commit edbd51d

Browse files
committed
docs(apple): fix the carrier path and restore two reasons
The acquisition carrier lives in @agent-device/contracts/ios-snapshot, and capture-kit owns the clip fold. A muted rejection is never recorded, so the runner session keeps its penalty and depth memory. Restore the distance reason for one-space geometry and source the query-sweep observation to #2621.
1 parent c79b782 commit edbd51d

3 files changed

Lines changed: 6 additions & 5 deletions

File tree

‎apple/runner/README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,8 @@ Every bounded main-thread dispatch that outlives its slice counts as occupying t
107107
Thus, if a viewport read takes too long, the plan skips the sweep instead of queueing it.
108108

109109
A failure that XCTest records ends `testCommand` when the main-thread block that recorded it returns, whatever `continueAfterFailure` says.
110-
Mute XCTest's AX-server rejection in both fetch wordings so a recorded failure does not end the runner session.
110+
Mute XCTest's AX-server rejection in both fetch wordings, so XCTest does not record it.
111+
Then the runner session continues and keeps its per-bundle penalty and depth memory.
111112

112113
### Screen space
113114

‎docs/adr/0004-ios-snapshot-backend-strategy.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ The bridge reads one process, so it refuses a tree in which remote web or scene-
3636
Refs from that tree would target the host views, and XCTest resolves remote elements (#2484).
3737

3838
**Ownership.** The Apple platform runtime owns acquisition routing and the generation-scoped fallback.
39-
`@agent-device/contracts/snapshot-presentation` holds the neutral acquisition-to-presented carrier and the clip-fold geometry contract. `@agent-device/capture-kit` owns host-side snapshot policy.
39+
`@agent-device/contracts/ios-snapshot` holds the acquisition carrier. `@agent-device/capture-kit` owns host-side snapshot policy, including the clip fold.
4040
Daemon assembly owns only the order of capture, compaction, occlusion, and ref publication.
4141
New consumers must use the capture-kit policy facet. Do not add another daemon presentation path.
4242
The Swift runner keeps its own `SnapshotPresentation` for the capture-plan tier before the process boundary.
@@ -71,7 +71,7 @@ Decision history: #3801 permits acquisition overflow from system alerts at large
7171
- The generation circuit costs a hybrid app's web screen one refused round trip for each generation, not one on every `wait` poll.
7272
- Activation (`XCUIApplication.activate()` or `simctl launch`) cancels an authentication session and makes the surface black. Without activation, a foreground host cannot have a stale tree.
7373
- A torn-down host can serve a richer tree than a live host, and under a system sheet the app stays the AX `primaryApp`. Thus, tree content cannot prove presence.
74-
- A published rect is an address, so a mixed-space tree is not half-usable. A rect and its actionability verdict share one oriented frame, so they cannot disagree.
74+
- A published rect is an address. No pair of rects in a mixed-space tree can answer "how far apart", so that tree is not half-usable. A rect and its actionability verdict share one oriented frame, so they cannot disagree.
7575

7676
## Rejected alternatives
7777

‎docs/evidence/ios-snapshot-adr-0004-measurements-2026-11-06.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,9 +45,9 @@ Route: `snapshot --depth N`, recursive tier, 15 warm captures per cell, against
4545

4646
Both screens walked their whole raw tree. The platform materializes the `XCUIElementSnapshot` tree in one call, and that call is where acquisition time goes.
4747

48-
## Query-sweep read failures
48+
## Query-sweep read failures (#2621)
4949

50-
On the observed app class, each `allElementsBoundByIndex` query-sweep read failed with `kAXErrorIllegalArgument` and recorded `Failed to resolve query: ...`.
50+
On the observed app class, each of the query sweep's 19 `allElementsBoundByIndex` reads failed with `kAXErrorIllegalArgument` and recorded `Failed to resolve query: ...`.
5151

5252
## Host process probe (#2751)
5353

0 commit comments

Comments
 (0)