Skip to content

docs: native-ref dispatch path is web-only in production#1095

Merged
thymikee merged 1 commit into
mainfrom
fix/native-ref-row-honesty
Jul 4, 2026
Merged

docs: native-ref dispatch path is web-only in production#1095
thymikee merged 1 commit into
mainfrom
fix/native-ref-row-honesty

Conversation

@thymikee

@thymikee thymikee commented Jul 4, 2026

Copy link
Copy Markdown
Member

While preparing the #1088 B-arm (Maestro suite with native-ref disabled), verification showed the experiment was moot: tapTarget/fillTarget appear zero times in the apple/android platforms — the only production wiring is webProvider?.clickRef (src/daemon/handlers/interaction-runtime.ts). The iOS Maestro suite can never exercise this path, so an A/B there would have compared identical binaries and produced a confidently wrong conclusion.

Records the fact on the registry row so the matrix stops implying mobile reach. Recommend closing #1088: there is no iOS round trip to retire, and web's stable-handle clickRef is clearly worth keeping.

tapTarget/fillTarget are wired solely to the web provider's clickRef
(interaction-runtime.ts); apple/android backends never define them.
Found while designing the #1088 retirement experiment, which this
dissolves: the hypothesized iOS runner round trip does not exist.
@github-actions

github-actions Bot commented Jul 4, 2026

Copy link
Copy Markdown

Size Report

Metric Base Current Diff
JS raw 1.5 MB 1.5 MB 0 B
JS gzip 489.8 kB 489.8 kB 0 B
npm tarball 588.9 kB 588.9 kB 0 B
npm unpacked 2.1 MB 2.1 MB 0 B

Startup median (7 runs, lower is better):

Scenario Base Current Diff
CLI --version 28.2 ms 28.5 ms +0.2 ms
CLI --help 52.6 ms 53.3 ms +0.7 ms

Top changed chunks: no changes in the largest emitted chunks.

@thymikee

thymikee commented Jul 4, 2026

Copy link
Copy Markdown
Member Author

Review status: no actionable blockers found.

I verified the key premise with a code search: apple/android platform code does not implement backend tapTarget/fillTarget; the production ref-native path is the web provider clickRef/fillRef wiring through interaction-runtime. That matches the now-closed #1088 conclusion, so the registry row correction is useful and prevents the matrix from implying mobile reach.

Focused validation on e5ab92f:

  • pnpm exec vitest run src/contracts/tests/interaction-guarantees.test.ts src/contracts/tests/interaction-contract-coverage.test.ts (11 tests)

GitHub checks are green (20/20). Added ready-for-human.

@thymikee thymikee added the ready-for-human Valid work that needs human implementation, judgment, or maintainer merge label Jul 4, 2026
@thymikee thymikee merged commit a6c2549 into main Jul 4, 2026
20 checks passed
@thymikee thymikee deleted the fix/native-ref-row-honesty branch July 4, 2026 15:28
@github-actions

github-actions Bot commented Jul 4, 2026

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-07-04 15:28 UTC

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-human Valid work that needs human implementation, judgment, or maintainer merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant