Skip to content

Commit edb1417

Browse files
committed
docs: correct native-ref exactness rationale and tiebreak doc
Native-ref forwards fallbackLabel to the backend; exact is justified by non-observability of any backend-side label recovery, not by non-forwarding. The tiebreak doc now states the derived winner-vs-runner-up decisive margin.
1 parent 9c20afc commit edb1417

2 files changed

Lines changed: 5 additions & 3 deletions

File tree

‎docs/adr/0012-interactive-replay.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -200,8 +200,10 @@ The ref paths disclose ref provenance. A lookup that resolves the `@ref` itself
200200
unusable `@ref` through its recorded trailing label (`tryResolveRefNode`'s `fallbackLabel` — a first-match
201201
label lookup, the replay recovery documented in Context), the response instead carries
202202
`{ source: "ref", phase: "pre-action", kind: "label-fallback" }`: label recovery is not exact ref
203-
provenance and must never claim it. The native-ref fast path always discloses `exact` — it dispatches the
204-
ref handle itself and never forwards the fallback label to the backend.
203+
provenance and must never claim it. The native-ref fast path always discloses `exact` — the ref handle is
204+
the dispatched target, and although the recorded `fallbackLabel` is forwarded to the backend, any
205+
label-based recovery a backend might perform with it is not observable daemon-side, so `exact` describes
206+
the daemon's own resolution and no more specific claim is possible on this path.
205207

206208
The accepted direct-iOS selector fast path has no daemon tree and the XCTest response cannot truthfully
207209
provide a match count, candidate refs, or a runtime tiebreak. It remains enabled for ordinary simple

‎src/contracts/interaction.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ export type ResolvedTarget =
3131
ref: string;
3232
};
3333

34-
/** The comparison that decided a resolveSelectorChain ambiguity, recorded by the comparator itself (ADR 0012). */
34+
/** The decisive criterion separating a resolveSelectorChain winner from its strongest runner-up (ADR 0012). */
3535
export type DisambiguationTiebreak = 'visible' | 'deepest' | 'smallest-area';
3636

3737
/**

0 commit comments

Comments
 (0)