Skip to content

Latest commit

 

History

History
59 lines (55 loc) · 9.07 KB

README.md

File metadata and controls

59 lines (55 loc) · 9.07 KB

ADR index — read this when…

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.