2 commits

Author	SHA1	Message	Date
Claude	b823d85d28	docs(adr): R-12 — the two record amendments, the §5 verdict, and the §6 condition a NO-GO makes unsatisfiable ... Rank 1 on the adopted docket, and the cheapest item on it: two ratified ADRs whose records contradicted the code, plus the ADR-0252 obligation that Track A's ratified NO-GO created. All four land in two files because they are two files under one authority — splitting them would have bought two reviews of the same document. ADR-0146 (R-12a, option A) — the daemon it rejected, shipped. The Shape-A rejection stands AS REASONING: a background daemon does require process-supervision infrastructure that Shape B does not. That infrastructure was subsequently built. chat/always_on_daemon.py implements the three items "What is NOT in Scope" excludes, each mapped to where: - cross-process file locking -> advisory fcntl.flock(LOCK_EX|LOCK_NB) at :82, acquired BEFORE any signal or runtime setup so a second life fails fast - signal handling -> SIGINT/SIGTERM graceful stop at :145 - daemon synchronization -> the load-time strict-identity guard; the flag is forced at :48 and a different-identity checkpoint is refused, so a restart is the same life or it is nothing Shape B remains the persistence model and the CLI default; the daemon is an additional shape layered on it, owned by this ADR. A new ADR for a shape that shipped six weeks earlier adds a document without adding a decision. The stale bullet gets an INLINE pointer, not only a trailing addendum. H-8's mechanism is that an authoritative line converts "I should check" into "I already checked" — the reader who stops at the excluded-scope list is exactly the reader this gap is about, and they never scroll to the end. ADR-0252 (R-12b, option A) — the "34 organs" basis footnote. Footnote at the first use, marking the count as underived: the reproducible figure is 18 resolve_promotable_* organs, ALL in generate/derivation/ and none anywhere else, with exactly 32 modules in the package as the likely origin of "34". The diagnosis, supersession plan and §4 conformance bar are unaffected — none depends on the count. Option B (replace every "34" with "18") rejected: it rewrites a ratified document's prose where a note at the point of use is all that is owed. ADR-0252 §5 — the verdict banner. NO-GO, ratified. Criterion pre-registered at 299c92be BEFORE the run, run at 797ebad5, artifact digest b3d9d275…, with the mechanism stated in one measured sentence: the similarity quotient that delivers attribute-invariance is the same quotient that annihilates structural contrast. Scope held narrow on purpose — this refutes H1 for point-position role encodings aligned under similarity, not every Cl(4,1) representation, and not the symbolic lane. Also records N-8 (two prior GO verdicts on unmerged branches, both unsound) and G-21. ADR-0252 §6 — the amendment the NO-GO forces, and the load-bearing half. §6 retired the surface organs "until the structure-mapper proves out" and named no replacement for the NO-GO branch. Left alone that is a live instruction that can never fire — an authoritative-looking dead instrument, the H-9 class exactly. Amended: the organs are RETAINED, and that is the operative state rather than a pause in a transition; the retirement condition is re-stated as a demonstrated replacement passing the §5 criterion, which does not exist. The "Build (gated on §5 GO)" bullet is marked NOT AUTHORIZED with the reason. Retiring a working organ on the strength of a hypothesis ABOUT its replacement is backwards; the hypothesis has now been tested. Verification — every factual claim re-derived at ca5e614e rather than copied from the packet: 18 organs, 0 outside generate/derivation/, exactly 32 modules (tightening the draft's "~32"); lock, signals and identity guard each cited by line; report digest read back from the artifact file. Three things caught before landing, recorded because this commit is about records being wrong. 1. The date. The addendum drafted "landed 2026-06-14". This container's clone was SHALLOW — 168 commits, roots grafted at 2026-07-19 — so git log reported 2026-07-20, which is the shallow boundary and not a fact. Neither figure was verifiable until the clone was deepened to 2340 commits, which confirmed the packet: 18e25580, 2026-06-14, the same commit introducing both the lock and the signal handling. The addendum now cites the SHA. A date that cannot be re-derived is testimony. 2. A wrong section reference — the amendment cited §9 for a sentence in §8. 3. A misquote — "the existing reader" for "the existing 34-organ reader". Writing a misquote into a ratified document while amending that document for accuracy would have been this ruling's own failure mode committed inside its own fix. Both were found by re-reading the amendment against the source it quotes, which is standing philosophy 7. Records closed: H-8(a), H-8(b), G-15. Track A's outstanding obligation discharged. H-8(c)/(d) remain open on R-3 and land with PR-5. No runtime behavior. No test changes. Two ADR files and four register/plan files. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wcw2pnMBwyvmNyQg4uPEt4	2026-07-28 06:25:06 +00:00
Shay	54e6bfc0d0	docs: reorganize docs landscape ... Implements the 4-phase documentation reorganization master plan. - Consolidation: Merged brief/, handoff/, planning/, and decisions/ into briefs/, handoffs/, plans/, and adr/ respectively (101 ADRs relocated) - Root Cleanup: Relocated HANDOFF-gpt55-*.md and key top-level docs (runtime_contracts.md, etc.) to canonical folders. Added superseded alerts. - Indices & Navigation: Created docs/README.md navigation document, docs/sessions/README.md index, docs/adr/README.md index - Note: Also includes prior commit adding ADR-0200+ corpus hygiene governance (ADR-0225, dependency map, backfilled cross-references)	2026-06-30 16:59:36 -07:00

Renamed from docs/decisions/ADR-0146-l10-hybrid-engine-state-persistence.md (Browse further)