Skip to content

Commit 58ed744

Browse files
committed
docs(adr): restore ADR 0004 contracts the drift check found
1 parent 06655d4 commit 58ed744

2 files changed

Lines changed: 9 additions & 2 deletions

File tree

‎apple/snapshot-bridge/README.md‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,9 @@ this Simulator's `SIMULATOR_UDID` and its executable path ends with the named
6464
executable, it returns the typed refusal
6565
`system-surface-host-present` with `surfaceHostExecutable`, without the app
6666
tree. If it cannot read the process table or place a matching process, it
67-
returns `system-surface-host-unverified`. The host sends that capture to
67+
returns `system-surface-host-unverified`. A host process that exited, gone or a zombie,
68+
is absent: it presents nothing, and an unverified answer would keep every warm
69+
capture off the bridge for as long as the process lingered. The host sends that capture to
6870
XCTest and keeps the app generation on the bridge, because both refusals are
6971
evidence about the screen. The host omits the check when a ready runner already
7072
reported every host off screen.
@@ -90,7 +92,10 @@ extension's process under a `_UISceneHostingView`. The guest returns the leaf as
9092
delivered; the host refuses a tree in which such a leaf sits under either host
9193
and reaches the viewport, or reports no frame (`remote-content-boundary`), and
9294
routes that app generation to XCTest, which resolves remote elements (#2484). A
93-
zero-area or off-screen leaf is published: it hosts nothing the capture can miss.
95+
zero-area or off-screen leaf is published: it hosts nothing the capture can miss. Remote
96+
elements under any other host are not classified, because no capture has shown one.
97+
If the node cap or the depth cap removes the host, the capture still discloses it
98+
as truncation.
9499

95100
## Coordinate space
96101

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,13 +56,15 @@ These two refusals have capture scope.
5656
`@agent-device/contracts/snapshot-presentation` holds the neutral acquisition-to-presented carrier and the clip-fold geometry contract.
5757
`@agent-device/capture-kit` owns host-side snapshot policy: planning, folding, projection, eligibility, semantic compaction, validation, and publication.
5858
Daemon assembly owns only the order of capture, compaction, occlusion, and ref publication.
59+
Android acquisition stays in its platform module and adapts its raw hierarchy to the shared carrier.
5960
New consumers must use the host-side policy facet in `@agent-device/capture-kit`. Do not add another daemon presentation path.
6061
The Swift runner keeps its own `SnapshotPresentation`, because it consumes the capture-plan tier before the process boundary.
6162
The shared engine fixtures prove that the Swift and TypeScript engines agree. They do not share an implementation.
6263
The macOS desktop surface arrives already presented and skips the iOS presentation engine.
6364

6465
**Presentation.** Acquisition backends serialize facts: every traversed node at raw traversal depth with its reported frame.
6566
Presentation applies visibility, eligibility, scope, and the regular depth cut.
67+
Every bridge result crosses the same presentation boundary before publication.
6668
Only `SnapshotPresentation` constructs `PresentedNode`, and backends read only the `CaptureHint`.
6769
A hint narrows acquisition only where the backend can prove the narrowing complete.
6870
A regular `--depth` request is a presentation cut, not an acquisition bound. Raw depth stays acquisition depth.

0 commit comments

Comments
 (0)