Skip to content

Commit 4f64cdd

Browse files
claudeclaude
committed
docs(board): refresh blackboard to current epoch + append 2026-05-26 epiphanies
The blackboard described only the older "Polyglot Notebook single-binary" program; CLAUDE.md mandates reading it before every task, so a stale board mis-orients each session. Prepend a current-epoch section (splat/palette/ pillar/3DGS) with the #200 evidence model, the grounded architecture (Palette256+Fisher-z = integer exact-cosine, validated 10k×10k; cognitive CamPlaneSplat vs graphics splat3d; Pillar suite incl. Pflug-10 certifying the palette), the outstanding items (#4/#5/#7, cam-pq wiring, UNUSED_INVENTORY A1-A9), and merged/closed state. Polyglot content kept intact below. Append the 2026-05-26 epiphany run to board/EPIPHANIES.md (was missing the entire epoch): Palette256+Fisher-z exact-cosine; SELECT-vs-uncertainty lanes; EWA-SYRK category error (#207 closed); C/HLOD; and the grounding-discipline meta-finding — each tagged with implementation debt. Doc-only; no src/ changes. https://claude.ai/code/session_01HbqooFZHAjaUtFEzhA1R2u
1 parent 17d8da8 commit 4f64cdd

2 files changed

Lines changed: 122 additions & 0 deletions

File tree

‎.claude/blackboard.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,48 @@
1+
# Current epoch (2026-05-26) — splat / palette / pillar / 3DGS
2+
3+
> **Read this first.** The "Polyglot Notebook" architecture below is a
4+
> separate/older program, not the current epoch.
5+
6+
## Evidence model (binding — from PR #200)
7+
- **L0** = source · passing tests · ratified standards (ground truth).
8+
- **L1** = `.claude/PR-X12-docs-audit.md` (#200) + `.claude/knowledge/plans-alignment-triage.md` — claims-about-source; **spot-check, never inherit**.
9+
- **L2** = `.claude/plans/*` + `pr-x12-*` perspective docs = **inspiration, NOT evidence**.
10+
- **Whole-file reads only** — no `grep`/`sed`/`head`/`tail` (`ls` to locate).
11+
- Build/bench locally at `target-cpu=x86-64-v4`; committed `.cargo/config.toml` stays **v3** (GitHub/CI).
12+
13+
## Settled architecture (grounded this epoch, whole-read)
14+
- **Cognitive similarity/cosine = Palette256 + Fisher-z**, integer: `hpc::cam_pq`
15+
squared-L2 ADC (u8 codebook indices) gated by θ = `distance::similarity_z` (atanh).
16+
Validated 10k×10k @ θ≈cos-0.90. **No float MAC in the distance kernel.**
17+
- The cognitive **"splat"** = `lance-graph-contract::splat::CamPlaneSplat` (q8) →
18+
`AwarenessPlane16K` (16 384-bit OR deposition). **Sibling of, not the same as,** the
19+
graphics `splat3d` EWA renderer (per `splat3d/mod.rs`).
20+
- EWA float-Σ sandwich (`splat3d::spd3`, Pillar 6/7) = uncertainty propagation +
21+
certification, **not** similarity. Pillar suite (6–17) certifies the substrate;
22+
**Pflug-10 certifies the CAM-PQ palette**.
23+
- Typed distance (`cognitive-distance-typing.md`): one named fn per metric, newtype
24+
outputs, **no `fn distance<T>` umbrella**, conversions explicit. `palette→fisher→
25+
cosine→hamming` roundtrip is the named anti-pattern.
26+
27+
## Outstanding (per triage + #200)
28+
- **#4** pr-x12 doc-fixes + evidence-policy + archive fabrication-heavy plans (Geo/Gov).
29+
- **#5** ASG-leaf canon spec (Gov) — prerequisite for #7.
30+
- **#7** ASG-leaf impl (Kernel) — must **extend `CamPlaneSplat`**, not reinvent; trails #5.
31+
- `cam-pq-production-wiring` (UNOWNED, lance-graph) — route `cam_pq` through `CamCodecContract`.
32+
- `UNUSED_INVENTORY_1.95` A1–A9 dead-code (phantom `SimdTier::{Sse2,WasmSimd128}`, stale 1.64 imports).
33+
34+
## Merged / closed this epoch
35+
- ✅ #201 triage · #205 `3dgs-tiles` (cesium tileset) · #206 + #208 render-depth cert.
36+
- ❌ #207 EWA-SYRK bench **closed** (wrong regime — category error).
37+
- 🗑 `phi_spiral.rs` abandoned (float, wrong manifold). Net new usable code this
38+
session = 0 (see `board/EPIPHANIES.md` grounding-discipline entry).
39+
40+
---
41+
142
# Polyglot Notebook — Single Binary Architecture
243

44+
> Separate/older program — NOT the current epoch (see top of file).
45+
346
## The Binary
447

548
One `cargo build`. Ships as one executable. Contains:

‎.claude/board/EPIPHANIES.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,3 +45,82 @@ needed (Knowledge Activation trigger), so the routine cost is 0.
4545

4646
Cross-ref: PR #110 (ndarray ledger), PR #213 (lance-graph ledger).
4747
EPIPHANIES.md 10⁷× finding above.
48+
49+
## 2026-05-26 — Palette256 + Fisher-z IS the exact cosine replacement (integer, no float)
50+
**Status:** VALIDATED (per user: 10 000×10 000 splat, θ ≈ 1.45–1.6 Fisher-z ≈ cos 0.90–0.92)
51+
**Scope:** @cognitive-substrate domain:distance
52+
53+
Cosine similarity in the cognitive substrate is **not** a float dot/norm. It is
54+
replaced — *ranking-exact* — by Palette256 (`hpc::cam_pq` 256-centroid ADC, integer
55+
table lookup) gated by a Fisher-z aperture θ (`lance-graph-contract::distance::
56+
similarity_z = atanh`). "No float at all" = no float MAC in the O(D) distance
57+
kernel; the only floats are the θ scalar + the ADC table values, and θ lands as
58+
`theta_accept_q8` (u8) on the splat (`effective_amplitude = amplitude_q8 −
59+
theta_accept_q8`).
60+
61+
Grounded (whole-read this session): `cam_pq.rs` (847 L, squared-L2 ADC),
62+
`distance.rs` (`Distance` trait + `similarity_z`/`fisher_z_inverse`),
63+
`cognitive-distance-typing.md` (popcount IS the cosine replacement *by topology,
64+
not value*; Fisher-z is a palette-output normalization, **not** a cosine
65+
reconstruction — `palette→fisher→cosine→hamming` is the named anti-pattern).
66+
67+
**DEBT:** validated-but-unwritten as canon → #5 ASG-leaf spec (Gov, outstanding).
68+
69+
## 2026-05-26 — Two lanes: SELECT (integer) vs uncertainty-Σ (float), co-certified
70+
**Status:** FINDING
71+
**Scope:** @cognitive-substrate domain:architecture
72+
73+
- **SELECT / similarity** = HDR-popcount (cascade L1, the cosine replacement) →
74+
Base17-L1 (L2) → Palette256 ADC (L3). Integer, bulk hot path.
75+
- **Uncertainty** = EWA sandwich `Σ'=M·Σ·Mᵀ` (Pillar 6/7), a *tiny 2×2/3×3 float Σ*
76+
per edge — certified PSD metadata, **not** bulk arithmetic.
77+
78+
Co-certified sibling pillars (suite 6–17), not competitors. **Pflug-10 certifies the
79+
CAM-PQ palette quantization** in the same suite (`pillar/mod.rs`). `cognitive-distance-
80+
typing.md` binds: one named fn per metric, newtype outputs, no `fn distance<T>` umbrella.
81+
82+
## 2026-05-26 — "EWA-SYRK BLAS backend" is a category error (PR #207 closed)
83+
**Status:** FINDING (kill)
84+
**Scope:** @splat3d domain:perf
85+
86+
`3DGS-EWA-SYRK-BLAS-MKL`'s "projection is a BLAS workload → MKL/OpenBLAS backend"
87+
conflates the **graphics** float covariance sandwich (`spd3`/`project`, renders
88+
pixels) with the **cognitive splat**. There is no float SYRK in the substrate to
89+
accelerate: the cognitive "splat" is `lance-graph-contract::splat::CamPlaneSplat`
90+
(q8) deposited into 16 384-bit `AwarenessPlane16K` (SPLAT-1, **integer**, OR-accumulate).
91+
PR #207's bench also measured `simd_x16` ≈2× over scalar AND the dense-3×3 "BLAS-shape"
92+
at 1k–1M (no crossover) — but the premise itself was incoherent. **Closed, not merged.**
93+
94+
`splat3d` (graphics EWA) and `lance-graph-contract::splat` (cognitive) are
95+
**siblings, not parent/child** (per `splat3d/mod.rs`).
96+
97+
## 2026-05-26 — C/HLOD = Cesium HLOD (shipped) + certificate + query-relevance
98+
**Status:** FINDING
99+
**Scope:** @3dgs domain:geospatial
100+
101+
`KHR_gaussian_splatting` (RC) + Cesium HLOD-for-splats (Apr 2026:
102+
`GaussianSplat3DTileContent`, back-to-front radix `GaussianSplatSorter`) are
103+
ratified/shipped. Our contribution is the **certified/queryable overlay** (SSE +
104+
Pillar-7 cert), mapping onto `tile.rs` radix-sort + `project.rs` conic + `raster.rs`
105+
alpha-blend ndarray already has. Render-depth cert **shipped** (#206 + #208).
106+
Geospatial = product manifold: tileset-tree (LOD — Poincaré belongs *only* here) ×
107+
per-splat spherical SH/ASG (KHR ships `SH_DEGREE_n_COEF_i`; directional lane is the
108+
sphere, never the Poincaré disk).
109+
110+
## 2026-05-26 — Grounding-discipline (meta — the expensive one)
111+
**Status:** FINDING
112+
**Scope:** @workspace-primer domain:process
113+
114+
One session of code — `phi_spiral.rs` (555 L float), `ewa_syrk_crossover` (257 L
115+
float) — was **net-zero-usable**: built in the FLOAT regime from ChatGPT
116+
"inspiration" plans without first grounding against the integer/palette substrate
117+
(`cam_pq`, the `Distance` contract, `cognitive-distance-typing`) sitting in the same
118+
repo. The fix, now binding: **whole-file reads only (no grep/sed/head/tail)**, and the
119+
#200 evidence model — **L0** source/tests/standards · **L1** audit + triage
120+
(spot-check, never inherit) · **L2** plans/perspective-docs (NOT evidence). Plans are
121+
inspiration, never authority.
122+
123+
**DEBT carried forward (not in code, recorded here):** #4 pr-x12 doc-fixes (the #200
124+
fabrications still on master) · #5 ASG canon spec · #7 ASG-leaf impl (extend
125+
`CamPlaneSplat`, don't reinvent) · `cam-pq-production-wiring` (cam_pq shipped, unrouted
126+
through `CamCodecContract`) · `UNUSED_INVENTORY_1.95` A1–A9 dead-code.

0 commit comments

Comments
 (0)