The workflow set has grown (lint, android, ios, three e2e workflows,
pr-title, release) and the cross-cutting models — the required merge
queue, the single e2e gate, the secrets/trust boundary, the cost
controls on the paid device suite — were only legible by reading every
workflow's inline comments.

Add docs/TESTING.md as the maintainer-facing architecture doc: the seven
test layers and where each lives, a workflow→trigger→check map, the merge
queue + required-checks model (including the skipped-but-required gotcha
and the always-reporting gate), when the expensive e2e runs, the trust
boundary for Dependabot/fork PRs, and the BrowserStack e2e mechanics.

CONTRIBUTING.md stays the how-to; point it at the new doc and update its
merge-queue section for the e2e-in-the-queue / `run-e2e` strategy.

The e2e gate + `run-e2e` behaviour is introduced by #142; this doc
describes that target state and should land with or after it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

…o apps

Addresses review feedback on docs/TESTING.md:

- Add §3.1 enumerating every e2e-reusable job (changes, build-android,
  build-ios, the three uploads, the two test jobs, gate) with the
  holds-secrets / runs-PR-code split — the Build (Android)/(iOS) jobs
  were previously collapsed into "nested build/run jobs". Note
  e2e-trusted's remove-label / reset-on-push hygiene jobs too.
- Turn intra-doc §N references into anchor links to the headers.
- Add §2.1 "The two test apps" contrasting apps/example (compiled native
  XCTest/androidTest targets, run by xcodebuild/Gradle — layers 3–6)
  with apps/e2e (in-app JS suite driven by Maestro on BrowserStack —
  layer 7), and flag that apps/example is misleadingly named.
- Note the stale root open:ios/open:android scripts (point at example/,
  not apps/example/).

Both predated the apps/ reorg and referenced a top-level example/ app.

agents.md: update the directory tree to show apps/integration + apps/e2e
(and maestro/), point the Testing section at docs/TESTING.md, fix every
example/ path and "example app" reference to apps/integration, and drop
the "canonical" wording.

e2e/README.md: rewrite as a focused guide to the local helper scripts
(run-instrumented-tests.sh, run-e2e.sh) that points to docs/TESTING.md
for the architecture. Removes the stale Maestro-Cloud CI block, the
Node 18 prerequisite, the example/ paths, and the per-test tables that
had drifted — the test directories are the source of truth.

(agents.md and AGENTS.md are the same file on a case-insensitive FS;
git tracks agents.md.)

…ripts/

The top-level e2e/ folder ran integration tests (against apps/integration),
while the real end-to-end suite lives in maestro/ + apps/e2e — a confusing
inversion. The e2e/.maestro flows + run-e2e.sh were the original local
Maestro POC (untouched since #3), never wired into CI, and fully redundant:
the lifecycle/IPC behaviour they exercised is gated by the instrumented
tests (ServiceLifecycleTest, NodeJSIPCTest), and the full real-device path
is gated by the apps/e2e BrowserStack suite. Their only unique coverage was
a throughput number on a throwaway demo UI.

- Delete e2e/.maestro/ (5 flows) and e2e/run-e2e.sh.
- Move e2e/run-instrumented-tests.sh → scripts/run-instrumented-tests.sh
  (the local Android instrumented-test runner; same depth, paths unchanged).
- Drop the now-broken apps/integration `e2e:android` script and repoint
  `test:android` / `test:android:unit` at scripts/.
- e2e/README.md is removed; local-run guidance now lives in docs/TESTING.md
  (§7.2 runs the e2e suite locally; §8 the cheap layers + instrumented).
- Update agents.md, CONTRIBUTING.md, and the sentry plan for the new path.

Result: no e2e/ ↔ maestro/ inversion, one fewer test app's scaffolding to
maintain, and maestro/ is unambiguously the sole e2e flow.

Resolve the two e2e/ runner conflicts (main incidentally fixed their stale
`example/` → `apps/example/` paths in the rootkey-migration PR, both files this
branch had already removed/moved):
- e2e/run-e2e.sh: kept deleted — this branch removed the vestigial local Maestro
  suite (the e2e/.maestro flows it drives are gone too).
- scripts/run-instrumented-tests.sh: kept this branch's moved version
  (apps/integration paths); main's change was only the superseded example path.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>