Resolve facade locators and snapshot refs across frames
Composes facade locators through same-origin and out-of-process frames and preserves global snapshot references without duplicating unresolved frame maps. Adds operator documentation for ownership. Deadline and disconnect documentation follows in #2893 and #2894.
Also repairs failures exposed by stack CI:
- Background-tab screenshots activate their target and serialize activation/capture across the browser. Setup and cleanup are serialized per page, so a stalled page cannot block other tabs. Capture deadlines stop waiting for stalled CDP responses; late responses cannot re-enter cleanup. Calls on a page with unfinished timeout recovery fail promptly until cleanup settles, after which screenshots resume.
- The Vantech Journal scorer identifies the archive’s Load more link by destination and text instead of an obsolete absolute XPath. Strict DOM element-identity scoring and the 80% gate remain unchanged.
- CLI test deadlines account for the bounded child processes they launch, including multi-command tests.
Validation: 24 local screenshot/lifecycle tests and 66 CLI/help tests passed, along with relevant typechecks and Go extension archive checks. Tests cover timeout rejection, isolation across tabs, and recovery after delayed setup/cleanup settles. Live Chrome verification accepts the recorded correct Vantech observation and rejects an unrelated element.
Stack position: 4/11. Base: evals/consolidation-05-locator-wait-contract.
Reviewer entry points:
Reordered stack: #2891 → #2892 → #2895 → #2896 → #2897 → #2898 → #2899 → #2900 → #2901 → #2893 → #2894.
Readiness: CI passed on 6d79622f5a. Review threads are triaged and resolved.