Skip to content

Commit dc9d5fb

Browse files
committed
docs(adr): place ADR 0023 ordered chains at the pinned commit and define every role
1 parent 0d6c702 commit dc9d5fb

2 files changed

Lines changed: 5 additions & 3 deletions

File tree

‎docs/adr/0019-request-bound-platform-runtime.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -951,7 +951,7 @@ The proposed target is ≤ 60.
951951
The target concerns its remaining contents, not directory retirement.
952952

953953
**Entry-to-platform hop count.** The measurement was corrected on 2026-09-03 and repeated for #2278 at `27a97ee619`.
954-
[`0023-end-state-hop-trace.md`](./0023-end-state-hop-trace.md) contains the definition and roles; the [2026-09-03 hop trace evidence](../evidence/entry-to-platform-hop-trace-2026-09-03.md) holds the measured counts and ordered chains.
954+
[`0023-end-state-hop-trace.md`](./0023-end-state-hop-trace.md) contains the definition and roles; the [2026-09-03 hop trace evidence](../evidence/entry-to-platform-hop-trace-2026-09-03.md) holds the measured counts and links the ordered chains at pinned commit `0e7df74a1a`.
955955
It supersedes the earlier numbers below.
956956
A file-by-file re-trace at that HEAD measured 41 hops for `press`/Android and 47/49 for `snapshot`/iOS.
957957
The snapshot route shares 30 hops, with 17/19 per arm: in-simulator AX bridge primary and XCTest runner fallback.

‎docs/adr/0023-end-state-hop-trace.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## Status
44

55
Reference audit for the entry-to-platform hop counts in ADR 0019 and the coupling audit in ADR 0022.
6-
The measured counts and the ordered traces are in [the 2026-09-03 hop trace evidence](../evidence/entry-to-platform-hop-trace-2026-09-03.md).
6+
The measured counts are in [the 2026-09-03 hop trace evidence](../evidence/entry-to-platform-hop-trace-2026-09-03.md); the ordered chains are at pinned commit `0e7df74a1a`, linked from that file.
77

88
## Decision
99

@@ -17,8 +17,10 @@ Trace the snapshot runner fallback with an existing runner session.
1717

1818
Assign each file exactly one role: policy, orchestration, translation, adapter, or pass-through.
1919
A pass-through hop delegates to exactly one next call on the path without a branch or transformation.
20+
A policy hop decides admission, limits, retry, or routes, and can refuse or redirect a request.
21+
An orchestration hop coordinates multiple calls, binds or runs a runtime, or assembles the object graph that later hops need.
2022
A translation hop maps values or shapes without issuing the platform call.
21-
The ordered traces in the evidence define the other roles.
23+
An adapter hop encapsulates an external system boundary, such as a subprocess, a socket, or a fetch; the terminal adapter issues the platform call.
2224

2325
Apply the deletion test to each pass-through or translation hop.
2426
A hop is a collapse candidate if its caller, callee, or both can inline its handoff without losing admission, budget, isolation, a boundary declared in an ADR, or a testability seam.

0 commit comments

Comments
 (0)