Skip to content

Commit c9f171e

Browse files
committed
docs: clarify coupling and hop boundaries
1 parent a93527f commit c9f171e

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

‎docs/adr/0022-daemon-platform-runtime-coupling.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,15 @@ The daemon must not depend on concrete platform code. This boundary alone does n
1010

1111
## Decision
1212

13-
R76 prohibits every production daemon import of the root platform-runtime family or a root hub that reaches it. The ban includes static and dynamic imports. Process-root composition is outside the daemon zone. Composition-essential edges assemble neutral implementations there. Daemon-policy-essential edges own request admission, session ownership, conflicts, locking, cancellation, teardown ordering, artifact publication, or response and event semantics. Platform mechanics and state belong behind a deeper interface or adapter.
13+
R76 prohibits every production daemon import of the root platform-runtime family or a root hub that reaches it. The family consists of the root platform-runtime module and root modules whose names start with platform-runtime-. The ban includes static and dynamic imports. Process-root composition is outside the daemon zone. Composition-essential edges assemble neutral implementations there. Daemon-policy-essential edges own request admission, session ownership, conflicts, locking, cancellation, teardown ordering, artifact publication, or response and event semantics. Platform mechanics and state belong behind a deeper interface or adapter.
1414

1515
Apple session observation uses the neutral `AppleSessionObservation`. It supplies runner liveness, session identity, and sole-foreground-app observation. Recording health, device refresh, and open-hint policy consume it. Root composition supplies request-local inventory and its error classifier. The Apple platform package owns the probes. Selector production and lifecycle participation remain separate.
1616

1717
Platform owners participate through the existing lifecycle phases. Do not introduce a generic hook bag. Open-target plans and results remain separate from platform mechanics. The resolver remains the single construction path for an open plan. Selector reads use the `querySelector` operation on the request-bound runtime owner. Its declaration is conditional on the captured touch and gesture uses. Off-screen rescue uses the command's admitted binding. Do not add a second selector producer.
1818

1919
R75 measures `SessionState` shape and `SessionStore` authority by symbol. It fails when a handler file enters either set and the merge-base set does not contain that file. Handler files may leave either set. R75 does not ratchet reads outside the handler path. R7 and R10 own cross-module reads outside that path.
2020

21-
The route trace assigns each hop a role and tests each pass-through or translation hop for deletion. Collapse only hops that the deletion test proves removable. The audited runtime-types hop is the only endorsed collapse. The earlier ≤14 target is superseded. The request-spine guards are side-calls, not hops. [ADR 0023](0023-end-state-hop-trace.md) owns the trace and deletion tests.
21+
The route trace assigns each hop a role and tests each pass-through or translation hop for deletion. Collapse only pass-through or translation hops that the deletion test proves removable. The audited runtime-types hop is the only endorsed collapse. The earlier ≤14 target is superseded. The request-spine guards are side-calls, not hops. [ADR 0023](0023-end-state-hop-trace.md) owns the trace and deletion tests.
2222

2323
## Rationale and rejected alternatives
2424

0 commit comments

Comments
 (0)