Skip to content

Commit 8de856d

Browse files
committed
docs(knowledge): address Codex + CodeRabbit on #482
Codex P2 (verified correct): contract::quorum is NOT an exported module - lib.rs declares no 'pub mod quorum'; src/quorum.rs is an unexported scaffold. Doc now states step 1 of the quorum work IS the export, and warns against importing lance_graph_contract::quorum until then. HILBERT-L4 probe row updated to VERIFIED GREEN (run first-hand on the ndarray branch: 13/13 incl. level4_all_indices_unique = bijective onto [0,4096) and level4_curve_is_connected; PP-13 P0-4's 'expected 4095' was an orientation assumption, not the contract). CodeRabbit nits: MD040 language tag on the GUID fence (text); explicit FINDING label on the section-1 canon block; FINDING/CONJECTURE labels on the two unlabeled ownership-table rows; P0 pre-read acknowledgment for encoding-ecosystem.md added to the header. https://claude.ai/code/session_01PBTGaPCSnnt6u3pjXpbLwY
1 parent 08f4840 commit 8de856d

1 file changed

Lines changed: 15 additions & 5 deletions

File tree

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

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,16 @@
88
> cited, never forked). **Counterpart:** ndarray
99
> `.claude/knowledge/guid-prefix-shape-routing.md` (the mechanism side).
1010
> Conjectures are labeled; probes named (no unmarked conjectures).
11+
> **P0 pre-read honored:** `.claude/knowledge/encoding-ecosystem.md`
12+
> (codec/distance/representation context for the CAM-PQ and LUT claims
13+
> below).
1114
1215
## 1. The canon (cited)
1316

14-
```
17+
**FINDING** (operator-pinned canon, `OGAR/CLAUDE.md` 2026-06-10 — the
18+
layout below is recorded design authority, not a derivation):
19+
20+
```text
1521
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 32 hex = 128 bit = the GUID
1622
classid HEEL HIP TWIG basin·leaf(6)+identity(6)
1723
```
@@ -32,11 +38,11 @@ classid HEEL HIP TWIG basin·leaf(6)+identity(6)
3238

3339
| Concern | Where it lands | Status |
3440
|---|---|---|
35-
| `(entity_type ↔ NiblePath)` bijection mint | ontology registry — Phase B | [H], planned (identity plan) |
41+
| `(entity_type ↔ NiblePath)` bijection mint | ontology registry — Phase B | CONJECTURE until Phase B lands ([H], identity plan) |
3642
| 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) |
3743
| `PrefixShapeTable` registration (classid/prefix → `ShapeId`) | lance-graph builds the table from the registry; ndarray routes by it, never knowing semantics | CONJECTURE → PROBE-ROUTE-1 |
38-
| Quorum certificate type | `contract::quorum` — the #411 scaffold (`todo!()`) is the named landing spot; `HighHeelBGZ`'s basin-merge L1-threshold consensus is the existing mechanism to generalize | CONJECTURE → PROBE-QUORUM-1 |
39-
| Escalation on quorum fail | HHTL tier escalation (`bgz-tensor::hhtl_cache::RouteAction::Escalate` is the shipped precedent) | [G] mechanism / [H] wiring |
44+
| 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 |
45+
| Escalation on quorum fail | HHTL tier escalation (`bgz-tensor::hhtl_cache::RouteAction::Escalate` is the shipped precedent) | FINDING: [G] mechanism / CONJECTURE: [H] wiring |
4046

4147
## 3. The anti-theater rules, contract side
4248

@@ -65,7 +71,11 @@ PROBE-ROUTE-1 (batch parity + ≥4× bench) · PROBE-QUORUM-1 (accept ⇒ ρ ≥
6571
anchor; reject ⇒ escalate) · PROBE-PHI-1 (φ-stride discrepancy beats
6672
uniform) · PROBE-PYR-1 (perturbation pyramid byte-exact) ·
6773
PROBE-CODEBOOK-44 (4⁴ vs flat-256 within Pflug band) · PROBE-HILBERT-L4
68-
(ndarray P0-4 — blocks any L4 cascade-addressing claim until green).
74+
(**VERIFIED GREEN 2026-06-10, run first-hand**: 13/13 hilbert tests pass
75+
incl. `level4_all_indices_unique` — bijective onto [0,4096), exactly what
76+
cascade addressing needs — and `level4_curve_is_connected`; PP-13 P0-4's
77+
"expected 4095" was an orientation assumption, not the contract; the
78+
suite stays as the standing gate).
6979

7080
## 5. Cross-references
7181

0 commit comments

Comments
 (0)