Repository navigation
Commit ab50f2a
authored
docs(adr): write runtime and architecture ADRs in ASD-STE100 (#3731)
* docs(adr): delete completed ADR 0019 checkpoint history
* docs(adr): write ADR 0019 in ASD-STE100
* docs(adr): write ADR 0021 in ASD-STE100
* docs(adr): delete retired ADR 0022 classification procedure
* docs(adr): write ADR 0022 in ASD-STE100
* docs(adr): delete completed ADR 0023 revision history
* docs(adr): write ADR 0023 in ASD-STE100
* docs(adr): delete superseded ADR 0025 Device Hub process
* docs(adr): write ADR 0025 in ASD-STE100
* docs(adr): write ADR 0026 in ASD-STE100
* docs(adr): write ADR 0027 in ASD-STE100
* docs(adr): write ADR 0029 in ASD-STE100
* docs(adr): write ADR 0030 in ASD-STE100
* docs(adr): write ADR 0031 in ASD-STE100
* docs(adr): write ADR 0032 in ASD-STE100
* docs(adr): delete completed ADR 0033 move batches
* docs(adr): write ADR 0033 in ASD-STE100
* docs(adr): delete completed ADR 0019 substrate adoption instructions
* docs(adr): restore the ADR 0019 move-unit size rule
The deletion of the completed checkpoint history (667484c) also removed the
operative size rule of section 8. The language commit re-added only one
sentence of it. Restore the full rule: the original-baseline and stack-base
bounds, the zero-or-negative expected delta, the root-versus-package byte
report, the named justification of each addition, type inflation as size
growth, and the #1739 evidence home.
* docs(adr): restore the frozen meaning in ADR 0021
Restore "replaced" in Status and the "ADR text before 2026-10-10"
recovery pointer. Restore the leased-device scope of remote access, the
"is the device leased" check, the Simlock owner of the HTTP API, and the
"address a device" requirement. Keep the base sentence about the adb
server, because its "which" referent is ambiguous.
* docs(adr): restore the frozen meaning in ADR 0022
Rewrite the R75 glance rule as the membership ratchet that the gate
enforces. Name the whole root platform-runtime family, which includes
src/platform-runtime.ts. Restore the querySelector CONDITIONAL attribution,
the separate landed child issues, "leaked", the generic hook bag
prohibition, the kill criterion, the request-spine guards, the owning seam,
and "fold"/"collapse" as two separate words.
* docs(adr): restore the frozen meaning in ADR 0023
Restore the comparability sentence for the counting definition, the
collapse and fold vocabulary of the ≤14 section, the decision (not the
wrappers) as the thing outside this route's ownership, the seam and kept-depth
terms, the wiring rows, "multiple" calls, the capture as the ineligible
subject, and adapter examples as examples. Revert the generalized 38/29
sentence to the base text; its stale "higher" claim is a discrepancy for the
PR body, not a language fix.
* docs(adr): restore the frozen meaning in ADR 0025
Restore the accepted gap that the hinge stream never ran on a physical
device, which the Device Hub deletion removed. Restore the glance rows for
an unsettled hinge, the refusal of any pose that never agrees, and the
panel-power-only pose report. Restore "only when neither window resolves",
the two facts of the ADR in the Android amendment, the 27.1 toolchain check,
the former half-open rule, the unverified refusal, and the dangling
private-API pointer.
* docs(adr): restore the frozen meaning in ADR 0026
Restore that a weak signal reaches only the scroll-band site and that
directional hints are its outlet only when nothing is the indicator's
parent. Restore "characterize each site before you reshape any of them",
the subject and "only" of the frame-change glance row, examples as
examples, the refuted alternatives as hypotheticals, and the pinned scroll
host as the test subject.
* docs(adr): restore the frozen meaning in ADR 0027
Restore "exactly when it is a split" as "if and only if", the glance rule
that the tolerance guarantees only flat weight over a preserved base
closure, and the code-quoted terms "wiring lines", "loading-shape probe",
"loading property", and "façade exactness". Restore "two or more shared"
statements, "exactly these facts", the like-for-like replacement scope, and
the refuted alternatives as hypotheticals.
* docs(adr): restore the frozen meaning in ADR 0029
Restore "the only exception" for the capability gate, the examples of
protocol plumbing as examples, the remote agent and the simulator as the
referents in Context, the three enforcement "points" and the backstop
rule, the client reuse of a daemon, "every" earlier admission decision,
and the per-daemon floor.
* docs(adr): restore the frozen meaning in ADR 0030
Restore that daemon registration keeps the same daemon.lock path and
refuses legacy files instead of reclaiming them. Make the separate state
directory conditional on the failure to stop every user again. Restore
"after that bound", "guard path", the scope "those paths" for the legacy
ban, the guard's paths, the unexpanded support contract, and "any retained"
guard. Keep the base "its directory guard": its referent is ambiguous.
* docs(adr): restore the frozen meaning in ADR 0031
Restore the code term "helper-routed" and "exactly", the passive
member-by-member assembly, the 48-level limit as a maximum, the runner as
the actor that moves the shared pointer, and "dropped" as the one word for
lost events.
* docs(adr): restore the frozen meaning in ADR 0032
Remove the added "only" from the fallow revisit rule. Make "replaceable"
describe the model implementation again. Restore the code term "lazy
seams", the parseImports miss as the gap, "misses none of these edges",
"with either engine", and "does not include" for tsconfig.
* docs(adr): restore the frozen meaning in ADR 0033
Restore "seam" wherever the base used it; "boundary" stays only where the
base used it. Restore that contracts holds wire vocabulary under R18, that
exports", path-keyed rules as examples of a class, the rejected proposal as
a hypothetical, and "the next pass re-opens it".
Keep the Follow-ups deletion: #3281 and #3294 are closed and every listed
move landed, so the suggested "moves continue under #3294" would be wrong.
* docs(adr): restore the frozen meaning in ADR 0019
Restore the shape rule in section 2 as a plain statement in force,
including the timing "at the point the shape is requested"; #2808, #2806,
and the web runtime tests already rely on it. The Status line keeps its
"proposed" wording, so the conflict stays visible.
Restore the operative half of the deleted section 6 substrate paragraph:
no duplication or package-to-root back-import of shared Apple-runner or
Android-helper mechanics, the injected-capability path, and one execution
owner. Repoint the dangling substrate references in sections 6, 10, and the
ADR 0009 relationship.
Restore the Status outcome of the adoption checkpoint, the kernel helper
scope, the only static value-import sites, the owning provider, owner cell,
freezes, the time-bound await using ban, the trust choke point, "seam" as
the code term, the conditional scope of the preferred/required rule, the
loading shape, the "yet" qualifiers of the End state, and the declared
host-port adapter.
* docs(adr): restore three conditions dropped by sentence splits
- ADR 0025: emit apple_display_primary_geometry_conflict only when the
primary panel is also the largest.
- ADR 0025: keep the pre-panel normalization only when the runner reports
no panel metadata.
- ADR 0032: the revisit trigger is an engine that can supply the shared import
model, not one that already supplies it.
Found in review round 2.
* docs(adr): keep translation hops in the ADR 0022 route-depth rule
The base decision applies the deletion test to pass-through and translation hops
and endorses only the proven removable hop. The glance named only pass-through
hops. Restore the selector "seam" term from the base rationale.
#3731 (comment)
* docs(adr): restore that the ADR 0033 managed-allocation move landed
The base text says the row and Batch 1 record a move that landed in #3287 and
that the package removal then deleted. The rewrite dropped that the move landed.
#3731 (comment)
* docs(adr): restore the ADR 0025 rule that the fold press is not evidence
The Device Hub deletion also removed the base sentence that fold sets the pose
and that only the read-back is evidence. Point to the HID amendment that
replaced the Device Hub press.
#3731 (comment)
* docs(adr): state the ADR 0022 route-depth rule with its base scope
Name pass-through and translation hops in one rule, as the base deletion test
does, and drop the commit hash that the base does not attach to the verdict.
#3731 (comment)
* docs(adr): cite R76's path-family ban in ADR 0033
ADR 0022 records that #3430 emptied the R76 inventory and reduced R76 to a
plain ban on the src/platform-runtime-*.ts family. The ban still keys on these
paths, so the retain-for-this-batch rationale holds; only the noun was stale.
#3731 (comment)
* docs(adr): mark the ADR 0033 managed-allocation row as landed and removed
The row is history: the move landed in #3287, and the package removal on
2026-10-10 deleted the file. State this in the row, as the Status note does,
so the row does not read as a live move target.
#3731 (comment)
* docs(adr): restore scope words in ADR 0033 rows and prose
Restore base scope dropped in the rewrite: "design, not a move" for the limrun
rows, the shared reason and "all" for snapshot-freshness, the fingerprint and
policy-file links, the real-seam conditions, "every edge" and "at all" for
client imports, "the platform package's", the capture-kit back-edge, R11's
"from a non-test file", and the daemon entry's re-export scope.
* docs(adr): restore scope words and a fixture ban in ADR 0019
Restore "provider" and "concrete" in the bindDevice glance, the conditional
parity evidence that explains why, "touches" for the SessionState unit, "not
pass-through layers" for the declared boundaries, and "grab bag". Restore the
operative ban that temporary fixtures never authorize a production bridge,
duplicate route, or package back-import; the section 7 deletion removed it.
* docs(adr): restore scope words found by the 12-ADR drift pass
ADR 0021: restore the two "so" consequences. ADR 0023: name `isEligible` as
the fallback condition, and describe the adb-host binding instead of a
permission. ADR 0025: limit "never promoted to a verified pose" to the
`screen` evidence. ADR 0026: name the ledger as the shape to extend, not an
order. ADR 0027: restore "carry no code", "new code", and "all". ADR 0029:
restore the "HTTP edge" term. ADR 0032: restore "only", "one more", the
"and" between edge kinds, and the "because" link.
* docs(adr): restore ADR 0022 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0023 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0031 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0032 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0033 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0025 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0026 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0027 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00.
* docs(adr): restore ADR 0019 wording dropped by the rewrite
Found by the second meaning-drift pass against base 59fdf00. Also repair the
review instruction that pointed at the deleted substrate paragraph.
* docs(adr): restore the ADR 0021 claim guard wording
Base: "device claims still guard against two sessions ... driving the same device".
"prevent" claimed a stronger guarantee.
* docs(adr): scope the ADR 0025 defensible-source claim to the recorded poses
Base: "Poses came from the hinge read-back, not from the pose that was requested;
the amendment above is why that is the only defensible source".
#3731 (comment)1 parent 8628e93 commit ab50f2a
12 files changed
Lines changed: 2830 additions & 2501 deletions
File tree
- docs/adr
Large diffs are not rendered by default.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
6 | | - | |
7 | | - | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | | - | |
12 | | - | |
| 11 | + | |
| 12 | + | |
13 | 13 | | |
14 | | - | |
15 | | - | |
16 | | - | |
17 | | - | |
18 | | - | |
19 | | - | |
20 | | - | |
21 | | - | |
22 | | - | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
23 | 21 | | |
24 | 22 | | |
25 | 23 | | |
26 | | - | |
27 | | - | |
28 | | - | |
29 | | - | |
30 | | - | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
31 | 28 | | |
32 | | - | |
33 | | - | |
34 | | - | |
35 | | - | |
36 | | - | |
37 | | - | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
38 | 40 | | |
39 | 41 | | |
40 | 42 | | |
41 | | - | |
42 | | - | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
43 | 46 | | |
44 | 47 | | |
45 | 48 | | |
46 | 49 | | |
47 | 50 | | |
48 | 51 | | |
49 | | - | |
50 | | - | |
51 | | - | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
52 | 56 | | |
53 | 57 | | |
54 | 58 | | |
55 | | - | |
56 | | - | |
57 | | - | |
58 | | - | |
59 | | - | |
60 | | - | |
61 | | - | |
62 | | - | |
63 | | - | |
64 | | - | |
65 | | - | |
66 | | - | |
67 | | - | |
68 | | - | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
69 | 78 | | |
70 | 79 | | |
71 | 80 | | |
72 | | - | |
73 | | - | |
74 | | - | |
75 | | - | |
76 | | - | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
0 commit comments