docs(knowledge): GUID canon + prefix routing — policy-side crystallization (quorum landing spot, deterministic phase, WHP bipolar)

.claude/board/EPIPHANIES.md

@@ -49,6 +49,58 @@ They are the SAME relation: the north-star template hierarchy IS the routing/sup
 **Phase B becomes:** stand up OGAR as the OGIT mirror + north-star template registry; seed entity_type↔NiblePath from it; the build-time round-trip proves the bijection. The surrealdb-coords blocker (N8 / Phase H) is unrelated and remains.
 
 **Cross-ref:** identity-architecture plan DECISION-2 + the north-star guard; E-IDENTITY-WHITEBOX-1 (NodeGuid composition); I-VSA-IDENTITIES (closed template vocabulary interns; Wikidata's open instance mass stays content, never a ClassId).
+## 2026-06-10 — E-WHP-BIPOLAR-1 — bipolar phase makes the perturbation pyramid a Walsh-Hadamard transform on VSA (deterministic, quantum-shaped, classical)
+
+**Status:** FINDING (operator-pinned in `OGAR/CLAUDE.md`; crystallized both sides).
+**Confidence:** High that receipts already exist (VSA bind/bundle is the iron-rule
+algebra; `Vsa16kF32` is bipolar; helix `CurveRuler` is the bit-exact integer phase
+generator); CONJECTURE on synthesis-as-Walsh-pyramid until WHP-1..4 land.
+
+When the deterministic phase from the §6 perturbation pin is made **signed (±1)** —
+one bit per (addr, level) — the cascade IS the Walsh-Hadamard transform of the
+address tree, carried on the workspace's existing VSA-bipolar algebra: signs compose
+by XOR (= `vsa_bind`), magnitudes compose by `vsa_bundle` (Chapman-Kolmogorov-
+respecting per `I-SUBSTRATE-MARKOV`). Each cell is a Walsh-resonance superposition
+recoverable by role-key unbind; `I-VSA-IDENTITIES` Test 1 (N ≤ √d/4 ≈ 32) IS the
+substrate's uncertainty principle. **Roundtrip bit-exact** because phase is
+generated from the address, not stored — Walsh-Hadamard is self-inverse up to
+scale. "Schrödinger's cat in a glass box": superposition is real, identity
+recoverable by key, no measurement randomness.
+
+**TWO-ALGEBRA RULE (load-bearing):** sign = XOR; magnitude = bundle, NEVER
+`MergeMode::Xor` (breaks Markov; the named anti-pattern is PP-13 P1-1 "raw-XOR
+ordering as 'nearest'"). Sign side preserves the write-back data-flow rule
+(single-target gated XOR is allowed); magnitude side preserves Parseval
+(L2 conservation → "top gaussian preserved", not Kombinatorik-style selection).
+
+Honest fences: "quantum-like" is the bundling algebra, not measurement randomness
+(no headline drift); bipolar = 1-bit phase (multi-bit stacks above when measured to
+be needed); Parseval requires the bundle, not just XOR. Probes WHP-1..4 land before
+any L2-conservation claim ships. Full treatment: ndarray
+`guid-prefix-shape-routing.md` §4b; policy mirror:
+`guid-canon-and-prefix-routing.md` §7; canon: `OGAR/CLAUDE.md`.
+
+## 2026-06-10 — E-CANON-GUID-1 — the canonical GUID's dash-groups are the cascade; routing/quorum crystallized before dilution
+
+**Status:** FINDING (canon operator-pinned in `OGAR/CLAUDE.md`; crystallization docs landed both sides)
+**Confidence:** High on the canon + receipts; CONJECTURE (probes named) on the new surfaces
+
+The operator-pinned canonical identity is HEX-counted — it IS the GUID:
+`classid(8)-HEEL(4)-HIP(4)-TWIG(4)-[basin·leaf(6)+identity(6)]`; the UUID
+dash-groups ARE the cascade delimiters. Key-of-key-value: node = key(128) +
+value(3968) = 4096 bits — the key routes/resolves/compares/scopes/names with
+zero value decode; Lance compresses the value freely (compression never costs
+addressability). 3×4 uniform tiers (`tier = nibble >> 2`); RFC 9562 = wrapper
+concern (wrappers adapt to canon, never the reverse). Centroid-tile reading
+[H]: path = 6 bytes = CAM-PQ 6×256; per-class codebooks scoped by class
+routing prefix (longest-prefix wins), 4⁴-hierarchical so nibble prefixes =
+centroid ancestry. Crystallized: this repo's policy side at
+`.claude/knowledge/guid-canon-and-prefix-routing.md`; ndarray's mechanism
+side at `ndarray/.claude/knowledge/guid-prefix-shape-routing.md` (the
+`PrefixShapeTable` + φ-quorum anti-eigenvalue-theater contract, with the
+PP-13 casebook as the named failure catalog). `contract::quorum` (#411
+scaffold) is the named landing spot for the quorum certificate. Probes:
+ROUTE-1, QUORUM-1, PHI-1, PYR-1, CODEBOOK-44, HILBERT-L4 (blocker).
 
 ## 2026-06-09 — E-IDENTITY-WHITEBOX-1 — structured identity + round-trip converts the substrate from black-box to CI-falsifiable
 

.claude/knowledge/guid-canon-and-prefix-routing.md

@@ -0,0 +1,132 @@
+# GUID Canon + Prefix Routing — the policy side (crystallization)
+
+> **READ BY:** integration-lead, truth-architect, family-codec-smith,
+> palette-engineer, any agent touching `identity.rs`, `hhtl.rs`,
+> `high_heel.rs`, `quorum.rs`, the ontology registry, or codebook builds.
+>
+> **Date:** 2026-06-10. **Canon source:** `OGAR/CLAUDE.md` (operator-pinned;
+> cited, never forked). **Counterpart:** ndarray
+> `.claude/knowledge/guid-prefix-shape-routing.md` (the mechanism side).
+> Conjectures are labeled; probes named (no unmarked conjectures).
+> **P0 pre-read honored:** `.claude/knowledge/encoding-ecosystem.md`
+> (codec/distance/representation context for the CAM-PQ and LUT claims
+> below).
+
+## 1. The canon (cited)
+
+**FINDING** (operator-pinned canon, `OGAR/CLAUDE.md` 2026-06-10 — the
+layout below is recorded design authority, not a derivation):
+
+```text
+xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx     32 hex = 128 bit = the GUID
+classid    HEEL   HIP    TWIG   basin·leaf(6)+identity(6)
+```
+
+- **Key-of-key-value:** node = key(128) + value(3968) = 4096 bits. The key
+  routes/resolves/compares/scopes/names with zero value decode.
+- **3×4 uniform** (`tier = nibble >> 2`); RFC 9562 = wrapper concern;
+  standing 3×4-vs-4×3 watch lives in `OGAR/CLAUDE.md`.
+- **Centroid tile [H]:** path = 6 bytes = CAM-PQ 6×256; per-tier 256×256
+  LUT distance; codebooks 4⁴-hierarchical; **scoped by class prefix**
+  (longest-prefix wins).
+- Wrapper audit direction: `contract::identity::NodeGuid` (#480) is the
+  carving of this GUID — audited against the canon **group-by-group**,
+  never the reverse. Groups 1–2 + the 24-bit `local` already match; the
+  Phase B question is groups 3–4 yielding all eight nibbles to HIP/TWIG.
+
+## 2. lance-graph owns POLICY (ndarray owns mechanism)
+
+| Concern | Where it lands | Status |
+|---|---|---|
+| `(entity_type ↔ NiblePath)` bijection mint | ontology registry — Phase B | CONJECTURE until Phase B lands ([H], identity plan) |
+| Per-class centroid codebooks (4⁴-hierarchical, prefix-scoped) | registry shelf, next to `ClassView`/`StructuralSignature` — minted with the class, trained once (amortized) | CONJECTURE → PROBE-CODEBOOK-44 (ndarray doc §6) |
+| `PrefixShapeTable` registration (classid/prefix → `ShapeId`) | lance-graph builds the table from the registry; ndarray routes by it, never knowing semantics | CONJECTURE → PROBE-ROUTE-1 |
+| Quorum certificate type | the **currently-UNEXPORTED `src/quorum.rs` scaffold** (#411, `todo!()`) — `lance-graph-contract/src/lib.rs` declares **no `pub mod quorum`** (Codex-verified on #482), so **step 1 of the implementation is the export itself**; do NOT import `lance_graph_contract::quorum` until then. `HighHeelBGZ`'s basin-merge L1-threshold consensus is the existing mechanism to generalize | CONJECTURE → export + PROBE-QUORUM-1 |
+| Escalation on quorum fail | HHTL tier escalation (`bgz-tensor::hhtl_cache::RouteAction::Escalate` is the shipped precedent) | FINDING: [G] mechanism / CONJECTURE: [H] wiring |
+
+## 3. The anti-theater rules, contract side
+
+The ndarray casebook (`pp13-brutally-honest-tester-verdict.md`) defines
+eigenvalue theater: cheap arithmetic wearing metric/spectral language it
+does not earn (unsatisfiable PSD gates; optimism thresholds; enforced
+placeholders; unrun "verified" claims; raw-XOR-u64 as "nearest").
+
+Contract-side consequences:
+1. **Cheap-path answers carry a quorum certificate** — k-of-n φ-stride
+   probes agree within τ; τ from measured anchors (ρ = 0.9973 HIP / 0.965
+   TWIG; Pflug-10 palette certification) under **I-NOISE-FLOOR-JIRAK**
+   (Jirak 2016 rates, never classical Berry-Esseen, never optimism).
+2. **Metrics are named typed fns** (`cognitive-distance-typing.md`
+   no-umbrella rule): popcount Hamming, palette L1 ADC — raw-XOR-u64
+   ordering is the named anti-pattern.
+3. **Quorum fail escalates a tier; never silently accepts.**
+4. **`ShapeId` is a register key** (I-VSA-IDENTITIES Test 0): points to a
+   shape; never bundled, never content-hashed.
+5. **No spectral language on the cheap path.** PSD/eigen/Σ claims route to
+   ndarray's pillar suite with relative tolerances and measured thresholds.
+
+## 4. Probes (shared numbering with the ndarray doc)
+
+PROBE-ROUTE-1 (batch parity + ≥4× bench) · PROBE-QUORUM-1 (accept ⇒ ρ ≥
+anchor; reject ⇒ escalate) · PROBE-PHI-1 (φ-stride discrepancy beats
+uniform) · PROBE-PYR-1 (perturbation pyramid byte-exact) ·
+PROBE-CODEBOOK-44 (4⁴ vs flat-256 within Pflug band) · PROBE-HILBERT-L4
+(**VERIFIED GREEN 2026-06-10, run first-hand**: 13/13 hilbert tests pass
+incl. `level4_all_indices_unique` — bijective onto [0,4096), exactly what
+cascade addressing needs — and `level4_curve_is_connected`; PP-13 P0-4's
+"expected 4095" was an orientation assumption, not the contract; the
+suite stays as the standing gate).
+
+## 5. Cross-references
+
+`OGAR/CLAUDE.md` (canon) · `OGAR/docs/INTEGRATION-MAP.md` (seams S1/S7/S9;
+gates F10–F14) · ndarray `guid-prefix-shape-routing.md` (mechanism) ·
+`EPIPHANIES.md` E-IDENTITY-WHITEBOX-1 (the bijection + roundtrip_eq
+whitening) · iron rules I-NOISE-FLOOR-JIRAK, I-VSA-IDENTITIES,
+I-LEGACY-API-FEATURE-GATED.
+
+## 6. Perturbation = deterministic phase (operator pin, 2026-06-10)
+
+The pyramid perturbation decomposes as **(exponent, location, phase,
+magnitude)**; exponent/location/phase derive from the KEY (level
+nibbles `>>2`, implied mantissa, coprime phase walk — helix
+`CurveRuler` stride-4-over-17 is the shipped, bit-exact integer
+generator) and only the **magnitude envelope is stored**
+(palette-quantized, coarse). Lossless for synthesis by construction —
+phase is convention, not data; the analysis remainder escalates to
+full-residual per the quorum certificate, never silently. Added
+probes: **PROBE-PHASE-1** (bit-exact cross-backend regeneration;
+integer walk only per D-QUANTGATE) · **PROBE-PERT-RHO** (magnitude-only
+meets ρ anchors; escalation rate reported). Bipolar sharpening (§7
+below). Full treatment: ndarray
+`guid-prefix-shape-routing.md` §4; canon: `OGAR/CLAUDE.md`.
+
+## 7. Bipolar-phase pyramid = Walsh-Hadamard on VSA (operator, 2026-06-10)
+
+Sharper form of §6: when the deterministic phase is **signed (±1)**,
+the cascade IS the Walsh-Hadamard transform of the address tree,
+carried on the workspace's existing `Vsa16kF32` bipolar algebra.
+**Signs compose by XOR (= `vsa_bind`)**; **magnitudes compose by
+`vsa_bundle`** (Markov-respecting per `I-SUBSTRATE-MARKOV`). Each cell
+is a Walsh-resonance superposition recoverable by role-key unbind;
+the Heisenberg-shaped capacity bound is `I-VSA-IDENTITIES` Test 1
+(N ≤ √d/4 ≈ 32) — the classical uncertainty principle of the substrate
+made explicit. Roundtrip bit-exact because phase is generated, not
+stored.
+
+**Two-algebra rule (load-bearing):** sign = XOR; magnitude = bundle,
+NEVER `MergeMode::Xor` (breaks Markov; the named anti-pattern is PP-13
+P1-1, "raw-XOR ordering as 'nearest'"). Receipts already exist:
+`vsa_bind` / `vsa_bundle` (iron-rule algebra), `Vsa16kF32` (bipolar
+carrier in `crystal/fingerprint.rs`), helix `CurveRuler` (bit-exact
+integer phase walk, D-QUANTGATE-compliant). Honest fences:
+"quantum-like" is the bundling algebra, NOT measurement randomness;
+bipolar = 1-bit phase; Parseval preservation requires the bundle (sum),
+not just XOR.
+
+**Probes added:** **WHP-1** (Parseval: `Σ|cell|² = Σ|M_L|²` within
+Jirak noise floor) · **WHP-2** (encode→decode→encode byte-identical
+cross-backend) · **WHP-3** (bind/unbind margin holds for N ≤ √d/4;
+fails cleanly past it) · **WHP-4** (explicit two-algebra guard:
+raw-XOR on magnitudes fails Chapman-Kolmogorov consistency). Full
+treatment: ndarray `guid-prefix-shape-routing.md` §4b.