Skip to content

Commit 2a52a4d

Browse files
committed
docs(adr-0011): narrow the offscreen rescue comment to the per-request surface policy
The snapshot capture and the live rescue are separate runner requests, and each calls prepareActiveCommandContext on its own, so only the selection policy is shared, not the surface instant. State that, and say plainly that a surface appearing or dismissing between the two requests is not detected. Closes #2452
1 parent a4e639d commit 2a52a4d

1 file changed

Lines changed: 7 additions & 5 deletions

File tree

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

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -170,11 +170,13 @@ const RUNTIME_TREE_SHARED_GUARANTEES = {
170170
// not the bulk one. Every other platform, and any backend that omits the
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.
173-
// The live read is the runner's direct querySelector, which runs against the
174-
// single activeApp that prepareActiveCommandContext resolved for the snapshot
175-
// tree as well — including an in-place system surface (the web sign-in sheet,
176-
// #2448). Tree and rescue therefore read the SAME surface: a confirmation can
177-
// never come from a different app than the refusal was computed on.
173+
// 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.
178180
offscreen: {
179181
kind: 'runtime',
180182
via: 'src/commands/interaction/runtime/resolution.ts#throwIfOffscreenInteractionTarget',

0 commit comments

Comments
 (0)