Skip to content

Commit e905700

Browse files
committed
docs(adr-0011): limit the shared surface seam to runner-routed captures
An eligible iOS simulator snapshot is served by the host AX bridge (packages/platform-apple/src/snapshot-route.ts), which never reaches the runner's prepareActiveCommandContext. The rescue's direct querySelector always does, so the two requests share that surface policy only when the capture is runner-routed too - which is the case #2448 forces for the system surface. Keep the unchanged statement that no surface identity crosses the two requests.
1 parent 2a52a4d commit e905700

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

‎packages/contracts/src/interaction-guarantees.ts‎

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -171,12 +171,14 @@ const RUNTIME_TREE_SHARED_GUARANTEES = {
171171
// hook, refuses on the visibility resolver's verdict unchanged — this is a
172172
// rescue-only override, never a way to relax a genuine refusal.
173173
// The live read is a SEPARATE runner request (the direct querySelector), so
174-
// only the per-request selection policy is shared: capture and rescue each
175-
// resolve their own active surface through the runner's single
176-
// prepareActiveCommandContext seam, in-place system surfaces included (the
177-
// web sign-in sheet, #2448). That is not a same-instant guarantee — no
178-
// captured surface identity crosses the two requests, so a surface that
179-
// appears or dismisses between them is undetected.
174+
// it shares the runner's prepareActiveCommandContext surface policy only with
175+
// a RUNNER-ROUTED capture: eligible simulator captures go to the host AX
176+
// bridge (packages/platform-apple/src/snapshot-route.ts), and a bridge-served
177+
// capture never reaches that seam. #2448 puts the system-surface case (the
178+
// web sign-in sheet) back on the runner, where both reads do share it. Either
179+
// way this is not a same-instant guarantee — no captured surface identity
180+
// crosses the two requests, so a surface that appears or dismisses between
181+
// them is undetected.
180182
offscreen: {
181183
kind: 'runtime',
182184
via: 'src/commands/interaction/runtime/resolution.ts#throwIfOffscreenInteractionTarget',

0 commit comments

Comments
 (0)