canon: retire the V1 u24+u24 GUID tail — migration mandatory#151
Merged
Conversation
…r 2026-07-04) The flat family(u24) ++ identity(u24) tail is V1-legacy and forbidden for new units. V3 is the content-blind classid(4)+12B facet (E-V3-FACET-4-PLUS-12): the 12B is an axis-grouped byte register — 6×(u8:u8) / 4×(u8:u8:u8) / 3×(u8:u8:u8:u8) — whose reading (part_of:is_a / X:Y / palette256² / segment:taxonomy / typed) the classid's ClassView holds all at once. u8:u8 is never widened; a flat u24 has no axis and cannot carry a rail. Append-only throughout — the u24 pin is regraded in place, kept read-only for pre-flip GUIDs, never deleted. - CLAUDE.md P0: dated supersession note above the pinned diagram; the tail line marked V1-LEGACY (read-only). - NODEGUID-CANON-AUDIT.md F-3: inverted — the byte-grouped facet IS the canon; the "u24 is canon, byte-direct is a constrained projection" framing is superseded; reconciliation now mandatory not "until ratified". - DISCOVERY-MAP.md: D-V1-TAIL-RETIRED ruling entry. Code already V3: ruff_spo_address::Facet via ogar-from-ruff. No code change here — doc/canon supersession only. Paired follow-ups (mandatory): promote V3-TRANSPILER-ADR RFC->adopted; reconcile ogar-fma-skeleton::Guid classid 2->4 (F-2). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MLBnPuScZy6w9di2QEjsXM
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Operator ruling (2026-07-04): the flat
family(u24) ++ identity(u24)GUID tail is V1-legacy and forbidden for new units; migration to V3 is mandatory. This lands the OGAR-side canon supersession — doc/canon only, no code change (OGAR's code already mints V3 viaruff_spo_address::Facetinogar-from-ruff; the audit found zero u24-tail production in OGAR code).V3 is content-blind:
classid(4) + 12-byte payload, the 12B an axis-grouped byte register —6×(u8:u8)/4×(u8:u8:u8)/3×(u8:u8:u8:u8)— whose reading (part_of:is_a/X:Y/palette256²/segment:taxonomy/ typed) the classid's ClassView holds all at once and picks per read.u8:u8is never widened (u16 = the deprecated V2 flat read; u24 = V1). A flat u24 has no axis → cannot carry a rail; that is why it is retired.Changes (all append-only — pinned text regraded in place, never deleted)
CLAUDE.mdP0 — dated⊘ SUPERSEDED — MIGRATION MANDATORYnote above the pinned diagram; thefamily-basin-leaf(6)+identity(6)line marked V1-LEGACY (read-only for pre-flip GUIDs). The operator pin is not removed — it is regraded, per OGAR's append-only canon rule.docs/NODEGUID-CANON-AUDIT.mdF-3 — inverted: the earlier "u24 is the canon; the byte-direct is a constrained projection, not a replacement" framing is superseded. The byte-grouped facet IS the canon; the class-local carve intuition survives but is the ClassView projecting the content-blind(u8:u8)register per classid, not a u24 width knob. Reconciliation is now mandatory, not "until ratified."docs/DISCOVERY-MAP.md—D-V1-TAIL-RETIREDruling entry.Paired mandatory follow-ups (not in this PR)
docs/V3-TRANSPILER-ADR.mdRFC → adopted.ogar-fma-skeleton::Guidclassid width 2→4 (tracked F-2).NodeGuid::new(V1) residues (ocr.rs:121,aiwar.rs:104) as mandatory-migration (separate lance-graph PR).Cross-ref: lance-graph
E-V3-FACET-4-PLUS-12(operator-locked 2026-07-02),soa_layout/le-contract.md§3.🤖 Generated with Claude Code
https://claude.ai/code/session_01MLBnPuScZy6w9di2QEjsXM
Generated by Claude Code