From 9876f226336fbc9ec7386a29714cd4dfa39a0672 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 14 Jul 2026 07:14:34 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20D-V1-GRACE-CARVINGS=20=E2=80=94=20the?= =?UTF-8?q?=20sanctioned=20V3=20waiting=20room=20for=20un-migrated=20V1=20?= =?UTF-8?q?classes=20(lance-graph=20mirror)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mirrors the operator ruling of 2026-07-13 (lance-graph le-contract.md §3a / legacy_outliers / E-V3-GRACE-WIDE-CARVINGS-1) into the OGAR canon, per the paired-merge discipline for cross-repo canon changes: - DISCOVERY-MAP §2.1: new ledger row D-V1-GRACE-CARVINGS appended after D-V1-TAIL-RETIRED (which it amends). An un-migrated class gets a legal V3 waiting room instead of a crash: three WIDE CONTIGUOUS carvings of the same 96-bit content-blind register — G1 3x(u16)+2x(u24) / G2 4x(u24) / G3 3x(u32) — tagged "strongly discouraged if god-object-related or lacking proper bucket rollover; migrate to cosine-replacement palette256 (L4)". Not a tail revival: one register read coarsely, no path/tail split; the V1 family:identity u24 fragment is the degenerate G1/G2 case; CascadeShape gains NO variants. - CLAUDE.md P0: dated grace-period amendment blockquote appended directly after the 2026-07-04 supersession note, so an OGAR-only reader no longer concludes "crash-or-migrate with no legal interim". Append-only: the supersession text itself is untouched. Doc-only; code home stays in lance-graph (lance_graph_contract:: legacy_outliers, PR #689 companion). Co-Authored-By: Claude Claude-Session: https://claude.ai/code/session_01Awg6TXocHcwTtc6eGsHcdD --- CLAUDE.md | 10 ++++++++++ docs/DISCOVERY-MAP.md | 1 + 2 files changed, 11 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 8d57ee2..003f449 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -24,6 +24,16 @@ > `docs/V3-TRANSPILER-ADR.md` RFC→adopted; reconcile `ogar-fma-skeleton::Guid` > classid 2→4 (F-2); invert `docs/NODEGUID-CANON-AUDIT.md` F-3 (see its dated note). +> **Grace-period amendment (operator, 2026-07-13 — D‑V1‑GRACE‑CARVINGS):** +> an un-migrated class does NOT crash — it gets a **legal V3 waiting room**: +> three **wide contiguous** carvings of the same 96-bit content-blind register +> (G1 `3×u16+2×u24` / G2 `4×u24` / G3 `3×u32`), **strongly discouraged if +> god-object-related or lacking proper bucket rollover; migrate to +> cosine-replacement palette256 (L4)**. Not a tail revival — one register read +> coarsely; the V1 `family:identity` u24 fragment is the degenerate G1/G2 case. +> Code home: lance-graph `lance_graph_contract::legacy_outliers`; catalogue: +> `le-contract.md` §3a; ledger: `docs/DISCOVERY-MAP.md` D‑V1‑GRACE‑CARVINGS. + ``` xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx classid HEEL HIP TWIG family-basin-leaf(6) + identity(6) ← V1-LEGACY tail (read-only; new units use the V3 4+12 facet, above) diff --git a/docs/DISCOVERY-MAP.md b/docs/DISCOVERY-MAP.md index bc21383..18889ed 100644 --- a/docs/DISCOVERY-MAP.md +++ b/docs/DISCOVERY-MAP.md @@ -131,6 +131,7 @@ two halves of a cell. ADR‑026 names the cascade that ties them. | D‑GUID‑TIER | The brutal uniform **`[256:256]` `[container:member]`** GUID (scale‑free: galaxy:planet … residue:atom); HhtlMode **Located** (Cesium 3D‑octree CRS) vs **Cascade** (self‑speaking ontology path); leaf = familyNode:identity. 3D‑octree HEEL/HIP (`morton3`), the ModalityProjection contract (ViT/X‑ray/US×Doppler `register`+`project` by Guid). 12+4 EdgeBlock removed (superseded by family nodes). | G | CODED | `crates/ogar-fma-skeleton/{guid,morton,projection}.rs` | D‑FMA‑SKELETON, D‑MORTON | | D‑NODEGUID‑AUDIT | Group‑by‑group audit of the FMA tier `Guid` vs lance‑graph `NodeGuid` (canon rule: wrappers audited against OGAR). **Caught F‑1: lance‑graph `CLASSID_FMA=0x0901` aliases OGAR `patient`** — this session's `0x0A` Anatomy domain resolves it. Also: classid/family/identity width + endianness + EdgeBlock divergences, each with a reconciliation. | G | CODED | `docs/NODEGUID-CANON-AUDIT.md` | D‑GUID‑TIER; lance‑graph `canonical_node.rs` | | D‑V1‑TAIL‑RETIRED | **MIGRATION MANDATORY (operator, 2026‑07‑04):** the flat `family:u24 ++ identity:u24` V1 tail is **FORBIDDEN for new units.** V3 is the content‑blind `classid(4) + 12B` facet — 12B an axis‑grouped register (`6×(u8:u8)` / `4×(u8:u8:u8)` / `3×(u8:u8:u8:u8)`), the ClassView holds every reading at once (`part_of:is_a` / `X:Y` / `palette256²` / `segment:taxonomy` / typed) and `u8:u8` is **never widened** (u16 = the deprecated V2 flat read; u24 = V1). A flat u24 has no axis → cannot carry a rail. Append‑only: u24 stays read‑only for pre‑flip GUIDs. Producer already V3: `ruff_spo_address::Facet` via `ogar‑from‑ruff`. Regrades D‑NODEGUID‑AUDIT F‑3; pin superseded in `CLAUDE.md` P0. | G | RULING | `CLAUDE.md` P0 (regraded) + `docs/NODEGUID-CANON-AUDIT.md` F‑3 (inverted) + `docs/V3-TRANSPILER-ADR.md` | D‑NODEGUID‑AUDIT; D‑GUID‑TIER; lance‑graph `E‑V3‑FACET‑4‑PLUS‑12` | +| D‑V1‑GRACE‑CARVINGS | **Grace‑period amendment to D‑V1‑TAIL‑RETIRED (operator, 2026‑07‑13):** an un‑migrated class gets a **legal V3 waiting room instead of a crash** — three **wide contiguous** carvings of the same 96‑bit content‑blind register: G1 `3×u16 + 2×u24` / G2 `4×u24` / G3 `3×u32`. **Strongly discouraged if god‑object‑related or lacking proper bucket rollover; migrate to cosine‑replacement palette256 (L4 `6×(8:8)`)** — the conditions are the diagnosis (god object → decompose; no rollover → silent saturation). NOT a tail revival (one register read coarsely, no path/tail split); the V1 `family:identity` u24 fragment = the degenerate G1/G2 case; `CascadeShape` gains **no** variants (stays byte‑axis‑only — a wide carving is what it refuses to bless). New classes MUST NOT be born into G1–G3. | G | RULING | lance‑graph `le-contract.md` §3a + `lance_graph_contract::legacy_outliers` (`LegacyOutlier::{WideMixed,WideTriple,WideQuad}`, LE round‑trip + degenerate‑case test) + `E‑V3‑GRACE‑WIDE‑CARVINGS‑1` | D‑V1‑TAIL‑RETIRED | ### 2.2 Selection & bounds