| ADR | Read when you touch… |
|---|---|
| 0001 Provider-First Integration Scenarios | integration testing strategy, provider transcripts, the scenario harness |
| 0002 Persistent Platform Helper Sessions | helper process lifecycle, keep-alive semantics |
| 0003 Daemon Command Registry (redirect) | redirects to 0008 for the daemon facet, predicates, and request-policy traits |
| 0004 iOS Snapshot Backend Strategy | the two public iOS snapshot modes, bridge acquisition and its XCTest fallback, presentation, the coordinate space a capture publishes, in-place system surfaces |
| 0005 iOS Runner Interaction Lifecycle | XCTest runner sessions, leases, adoption, idle-stop |
| 0006 Daemon RPC Protocol Version | remote daemon HTTP/JSON-RPC compatibility |
| 0007 Remote Device Leases | leases, tenancy, provider-owned devices |
| 0008 Command Descriptor Registry | command additions or changes, any surface projection (CLI/MCP/client/batch), timeout policy, daemon route and request-policy traits |
| 0009 Apple Platform Consolidation | Apple platform family, apple/appleOs axes, the apple-leak guard |
| 0010 Error system conventions | error codes, hints, normalizeError, typed error signals |
| 0011 Interaction Guarantee Contract | interaction dispatch paths, fast paths, guards, the guarantee matrix, parity tables |
| 0012 Interactive Replay | replay healing/--update, diagnostic resolution disclosure, bounded .ad target-binding evidence, bounded divergence wire/error handling, plan-bound replay-only --from semantics, and agent-supervised re-record repair ("heal-by-doing") |
| 0013 Unified Gesture Plans | gesture API/routing, contact topology, multi-touch geometry, native pointer injection, two-finger pan |
| 0014 Session Ref-Frame Lifetime | ref authorization epochs, complete/partial issuance, pre-side-effect expiration, replay/batch compatibility, and cross-platform stale-mutation policy |
| 0015 Direct Maestro Compatibility Engine | Maestro YAML parsing/execution, compatibility observation policy, conformance, performance gates, gesture integration |
| 0016 Active-Session Script Publication | publication of an armed open-to-destination .ad script that retains its live session |
| 0017 Parameterized Recorded Inputs | safe authoring of sensitive fill inputs as ${VAR} placeholders across recording, replay, and repair |
| 0018 Unified Request Event Journal (Proposed) | event/diagnostic vocabulary, journal scopes and sinks, progress-channel separation, observability-only state |
| 0019 Request-Bound Platform Runtime | platform-package boundaries/composition, device discovery, runtime facts/facets, request binding, provider ownership, platform-shaped session resources, durable reattachment, daemon-handler migration |
| 0020 Composable Recorded Fragments (Proposed) | lifecycle-free recorded fragment capture/composition, entry guards, fragment-local addresses/digests, staleness, and native .ad/Maestro composition |
| 0021 Simlock-Leased Devices Through Ordinary Local Runtimes | operation of a Simlock-leased simulator or emulator, and the reason for no agent-device allocator integration |
| 0022 Daemon — Platform Runtime Coupling Audit and Ownership Ratchets | daemon imports of root platform-runtime-* modules, the coupling ban that replaces R76 edge classification, the R75 session-authority ratchet, entry-to-platform hop routes and roles |
| 0023 End-State Entry-to-Platform Hop Trace | the definition of hop counts, ordered press/Android and dual-arm snapshot/iOS chains, per-hop roles, and the deletion test for numbers in ADR 0019 and ADR 0022 |
| 0024 Screen Recording — One Coordinator, Two Facts (Proposed) | record start/stop lifecycle, separate export-exists / recorder-stopped facts, backend stop-and-collect contract, coordinator recovery, the ADR 0019 §5 amendment, and the failed-finish cleanup fix |
| 0025 Foldable Apple Panels — Capture the Lit Panel | iPhone Duo outer/inner panels, the screen authority (CoreDevice display info in the default set, the guest panel read in a scoped set), black-panel capture from simctl's implicit display default, derived (never asserted) pose, fold pose control with guest hinge and scoped-set panel readback, and the Android emulator posture amendment |
| 0026 Scroll Clip Authority — Ownership Is the Parent Edge | iOS scroll indicators and the visible band, parent-edge ownership instead of ancestor traversal, permitted node removal from interactive snapshots, and ejection dispositions |
| 0027 Descriptor Root Size vs Eager-Closure Budget | accepted: the eager-closure budget permits only a statement-neutral hub split (containment + added-module novelty + flat top-level-statement weight); packages/command-registry/src/registry.ts may be split |
| 0028 Capability-Family Cell Vocabulary — Retain Compile-Checked Declarations | rejected single-source cell table; retained explicit input contract, exhaustive owner facts, optional-cell fallback, and lifecycle authority |
| 0029 Daemon Policy | AGENT_DEVICE_DAEMON_POLICY, limits on daemon commands, devices, or device shutdown, and where operator rules are enforced for batch/replay steps |
| 0030 Process Lock Exclusion | process-lock publication/reclaim/release, retained mutation guards, and the single-protocol upgrade boundary |
| 0031 macOS Native App Backend | AGENT_DEVICE_MACOS_APP_BACKEND, macOS app sessions without XCTest Automation Mode, the accessibility-only pointer action rule, and the ghost cursor |
| 0032 Layering Graph Engine | replacement evaluation for scripts/layering/ graph rules with dependency-cruiser or fallow boundaries, the reason that graph-based layering checks share one replaceable import model, the measured edge-set and parity gaps, and the revisit triggers |
| 0033 Collocation decision table | moves or additions for files in umbrella #3276 §5, renewed proposals for a move that the table refused, and a zone's collocation decisions |
| 0034 Provider plugin registry | provider plugins, the agent-device/plugins contract, plugin sources and order, duplicate provider ids, plugin failure isolation, the daemon plugin inventory and daemon status |
| 0035 Host-Scoped Devices | native macOS apps as devices of their own, the host/scoped-device overlap and claim rule, concurrent app sessions, and macos-app lease claims |
| 0036 Bounded Composite Resource Admission | resource operations, nested tests, session disposal, and claim recovery inside bounded batch/replay steps |
| 0037 Web Session Devices | web sessions as devices of their own, the session name rule, the p_/t_ backend key and tenant isolation, and first-open locking for web |
| 0038 Snapshot capture source routing | the source router for multi-source owners, one fallback, refusal scopes, surface proof, and the producer registry |
ADRs record rationale. The registries and gates they describe are the current source of truth. If prose and a registry disagree, the registry takes precedence. The ADR then needs a follow-up.
Use these shape conventions to keep ADRs inexpensive to consult:
- Put normative rules first. Put Status before a terse "Rules at a glance" summary. The summary lets readers stop there. Put full contracts and rationale below it.
- Retain rationale and rejected alternatives. They prevent repeated discussion of settled decisions. Put them below the summary.
- Process history is deleted once complete. Keep completed migration plans, per-step implementation tables, and point-in-time status logs only in git history. In Status, keep one line that states this deletion. In Status, also keep any accepted waiver or evidence gap that is still relevant.
- If a gate enforces a rule, retain its rationale and a gate pointer instead of repeated rule details.