Skip to content

Commit 8749a15

Browse files
committed
docs: plans-alignment-triage — rank ChatGPT 48h corpus against ground truth
PR #1 of the 7-PR cross-session program. Maps the ~62 ChatGPT-seeded .claude/plans/ docs (committed 2026-05-24/25) against evidence: real source files, ratified standards (KHR_gaussian_splatting / OGC 3D Tiles 2.0 / Cesium HLOD / ArcGIS ESRI_crs), and the merged #200 audit (PR-X12-docs-audit.md). NOT AUTHORITATIVE by construction — it ranks inspiration against ground truth and may not be cited as evidence (PR #200 Tier-4 model). Includes: - evidence model (evidence vs inspiration) per #200 Tier-4 - correction list (blasgraph canonical / bgz17 lossy sibling; ScalarCsr::spmv_min_plus is the real symbol; no batched_ssd_search; sigker PDE not buggy; per-arch crossovers uncalibrated; R-1..R-15 forward-conditional; directional lane is spherical not Poincaré) - supersedes-note recording all three sessions' in-thread errors (incl. this session's R-7/sigker/SSD assertions) with their fixes - 5-bucket inventory (USE-NOW / EPIPHANY / GROUND-FIRST / ARCHIVE / OUT-OF-SCOPE) with hop + cross-verified/single-session + grounds-onto - PR-X12-tensor-capstone downgraded to idea-USE-NOW / doc-RE-GROUND (carries #200 #1-#16 debt) - C/HLOD headline concept (Cesium HLOD shipping + certified overlay) - the forward 7-PR program + parking lot - honest scope boundary for the 2 plans not whole-read this pass No source changes. Pure .claude/knowledge addition.
1 parent 7bba056 commit 8749a15

1 file changed

Lines changed: 199 additions & 0 deletions

File tree

Lines changed: 199 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,199 @@
1+
# Plans Alignment Triage — ChatGPT 48h corpus vs ground truth
2+
3+
> **STATUS: NOT AUTHORITATIVE.** This document ranks *inspiration* — the
4+
> ChatGPT-seeded `.claude/plans/` corpus committed 2026-05-24/25 across
5+
> `ndarray` and `lance-graph` — against **ground truth**. It is **not a spec
6+
> to implement** and **may not be cited as evidence** for any claim about
7+
> current code.
8+
>
9+
> `USE-NOW` means only: "the idea coincides with verified code or a ratified
10+
> standard." Build from that ground truth, citing the plan as the idea's
11+
> *origin*, never as its authority. Where a plan diverges from code/canon/
12+
> standard, **the divergence is the correction list** below — ground truth
13+
> wins every time.
14+
15+
## Evidence model (from PR #200 Tier-4, = "inspiration ≠ authority")
16+
17+
| Tier | What | May be cited as evidence? |
18+
|---|---|---|
19+
| **Evidence** | source files · W1a contracts · ratified standards · the merged `.claude/PR-X12-docs-audit.md` (#200) | yes |
20+
| **Inspiration** | the `.claude/plans/` corpus · the `pr-x12-*` perspective docs · the R-1..R-15 series (forward-conditional, audit-flagged) | **no** |
21+
22+
## Ground-truth anchors (verified this session, whole-file)
23+
24+
- **code (ndarray):** `src/hpc/splat3d/{spd3,project,raster,sh,tile,gaussian}.rs`,
25+
`src/hpc/pillar/{ewa_sandwich_2d,ewa_sandwich_3d,splat_invariants}.rs`,
26+
`src/hpc/cam_pq.rs` (847 lines), `src/hpc/bgz17_bridge.rs`
27+
(`BASE_DIM=17`, `GOLDEN_STEP=11`, `Base17=[i16;17]`)
28+
- **code (lance-graph):** `crates/cognitive-shader-driver/*` (bindspace,
29+
mailbox_soa, token_agreement, codec_bridge, decode_kernel), `crates/jc`
30+
(Pillar 10 `pflug`, Pillar 11 `hambly_lyons`), `crates/sigker`,
31+
`crates/bgz17`, `crates/lance-graph/.../blasgraph`
32+
- **audit:** `.claude/PR-X12-docs-audit.md` (PR #200, merged) — the
33+
authority over the `pr-x12-*` doc layer
34+
- **standards:** `KHR_gaussian_splatting` (RC Feb 2026), OGC 3D Tiles 2.0,
35+
Cesium HLOD-for-splats (Apr 2026), ArcGIS `ESRI_crs`
36+
37+
## Correction list (plan ⟂ ground truth — ground truth wins)
38+
39+
Sourced from PR #200 (`PR-X12-docs-audit.md`) + first-party reads:
40+
41+
1. **blasgraph is the canonical bit-exact kernel; bgz17 is a *lossy sibling*.**
42+
The plans/docs that present bgz17 as "the actual kernel home" with
43+
blasgraph as "eventual abstraction" have it **inverted** (#200 §1, #1/#4).
44+
Substituting bgz17 for blasgraph is a soundness violation.
45+
2. The symbol `bgz17::scalar_sparse::tropical_spmv` **does not exist**; the
46+
real kernel is the method `ScalarCsr::spmv_min_plus` (#200 #2).
47+
3. `ndarray::hpc::blas_level2::batched_ssd_search` **does not exist** (#200 #5).
48+
4. `sigker::signature_kernel_pde` is **not buggy** — its own passing tests
49+
prove convergence to `I₀(2·√⟨u,v⟩)` (#200 #9). The "use truncated because
50+
pde is buggy" framing is wrong.
51+
5. Per-arch DCT crossover constants (SPR=64, ICX=32, Zen4=96, Apple=256,
52+
Graviton=128) are **uncalibrated estimates**, not commitments (#200 #6/#7).
53+
Mark `[uncalibrated]` until a bench measures them.
54+
6. `simd_soa.rs` is a **373-line PR-X1 layout carrier**, not a codec hub
55+
(#200 #24).
56+
7. The **R-1..R-15 series is forward-conditional planning**, not present-tense
57+
canon (#200 §2 truth #1).
58+
8. Manifold: the directional lane is **spherical** (KHR ships
59+
`SH_DEGREE_n_COEF_i`; `sh.rs` is degree-3 SH). Poincaré is reserved for the
60+
LOD tile-tree only — *not* the directional lane.
61+
9. GS payload = a glTF carrying the `KHR_gaussian_splatting` extension, not a
62+
peer `ContentKind::GaussianSplat3d`. SPZ = interop tier; PR-X12 = internal.
63+
64+
## Supersedes-note — this thread's own in-conversation errors
65+
66+
Recorded for honesty; the inventory below supersedes them:
67+
68+
- **Gov (this session):** repeatedly asserted the R-7 inversion
69+
(blasgraph-aspirational / `bgz17::scalar_sparse::tropical_spmv`-is-real), the
70+
sigker-PDE "bug", and `batched_ssd_search` — all falsified by #200.
71+
- **Geo session:** the `SplatShaderBlas` "blasgraph-aspirational / bgz17-is-the-
72+
kernel" inversion (retracted).
73+
- **Kernel session:** premature `phi_spiral.rs` on the wrong (flat-disk)
74+
manifold + the unverified "BGZ17 offset 17-27 / stride 2,4" annotation
75+
(corrected in `fc27775c`; real values `GOLDEN_STEP=11`).
76+
77+
## Legend
78+
79+
- **HOP** — 1 (coincides with verified code/standard) · 2 (one experiment
80+
away) · 3 (speculative / fenced)
81+
- **CV** — ✓ cross-verified (whole-read by ≥2 sessions) · ◑ single-session
82+
- **VERDICT** — USE-NOW / KEEP-EPIPHANY / GROUND-FIRST / ARCHIVE / OUT-OF-SCOPE
83+
84+
## Hop 1 — USE-NOW (idea coincides with verified code/standard)
85+
86+
| Plan | Repo | CV | Grounds onto |
87+
|---|---|---|---|
88+
| 3DGS-3D-Tiles-runtime | lance-graph || OGC 3D Tiles 1.1 + KHR |
89+
| 3DGS-Lance-Arrow-storage | lance-graph || Arrow/Lance schemas (foundation) |
90+
| 3DGS-HHTL-datalake-traversal | lance-graph || Lance/DataFusion pruning |
91+
| 3DGS-ArcGIS-Cesium-ingestion | lance-graph || real ArcGIS/Cesium + `ESRI_crs` |
92+
| 3DGS-certified-query-render | lance-graph || auditable skip/refine/hydrate |
93+
| 3DGS-integration-wiring | lance-graph || the lance-graph↔ndarray boundary |
94+
| 3DGS-Cesium-feature-mapping | lance-graph || 3D Tiles spec (gold-standard transfer) |
95+
| 3DGS-SIMD-forward-renderer | ndarray || real `splat3d/{project,raster,sh}` |
96+
| 3DGS-columnar-splat-codec | ndarray || f16 carrier + `splat3d` block views |
97+
| 3DGS-error-certification-pillars | ndarray || real Pillar-6/7/12 |
98+
| 3DGS-validation-benchmark | ndarray || real renderer/codec/pillar paths |
99+
| 3DGS-HHTL-CPU-cascade | ndarray || `hpc::{cascade,clam,cam_pq}` |
100+
| 3DGS-EWA-SYRK-BLAS-MKL | ndarray || `spd3::sandwich` + Pillar-7; **backend gated behind bench (PR-3)** |
101+
| cam-pq-production-wiring | lance-graph || real `cam_pq` (self-corrects 1300×→128×) · **UNOWNED cross-repo pick-up** |
102+
| codec-sweep-via-lab-infra | lance-graph || real `cognitive-shader-driver`; honest negative controls |
103+
| categorical-algebraic-inference | lance-graph || real grammar/VSA surface (categorical framing = labeled conjecture) |
104+
| archetype-scaffold | lance-graph || self-contained crate, runnable acceptance |
105+
| burn-ndarray-parity-sprint | lance-graph || real ndarray parity, pinned base SHA |
106+
| jc-pillars-runtime-wiring **+ ERRATUM** | lance-graph || real 12-pillar `jc`; ERRATUM de-risks layer attribution |
107+
| cognitive-substrate-convergence-v3 | lance-graph || canonical; tracks merged PRs #383–389 |
108+
109+
### Idea USE-NOW / doc RE-GROUND
110+
| Plan | Repo | CV | Note |
111+
|---|---|---|---|
112+
| PR-X12-tensor-container-expansion-capstone | ndarray || block grammar sound (R-1/R-2/R-9), but carries PR #200 #1#16 debt. Do not promote until PR-4 re-grounds. |
113+
114+
## Hop 2 — KEEP-EPIPHANY (true direction, preserve as vision, not build)
115+
116+
| Plan | Repo | Note |
117+
|---|---|---|
118+
| 3DGS-epiphany-roadmap | lance-graph | **source of C/HLOD** (now standard-backed by Cesium HLOD) |
119+
| 3DGS-blast-radius-application-map | lance-graph | Ring 1 grounded; Rings 2–4 speculative |
120+
| 3DGS-Cesium-BindSpace4-headstone | lance-graph | real anchors + unbuilt markdown |
121+
| tetrahedral-epiphany-splat-integration | lance-graph | "no runtime claimed"; idea source |
122+
| oxigraph-arigraph-cognitive-shader-soa-merge | lance-graph | core splat-thread (aspirational, in-program) |
123+
| ogit-g-context-bundle | lance-graph | the ontology↔codec "semantic exponent" bridge |
124+
| unified-ogit-architecture | lance-graph | anatomy north-star wires FMA + splat pillars |
125+
| thought-cycle-soa-awareness | lance-graph | ⚠ redefines `CausalEdge64` — collides with v3 canon; reconcile first |
126+
| 3DGS-4x4-cognitive-shader-integration | lance-graph | geospatial slice buildable; cross-domain lanes not |
127+
128+
## Hop 2/3 — GROUND-FIRST (needs an experiment/fixture before build)
129+
130+
| Plan | Repo | Note |
131+
|---|---|---|
132+
| 3DGS-4x4-cognitive-shader-SoA | ndarray | `(4×4)⁴` fanout speculative |
133+
| PhiSpiral256-SoA-cross-system | lance-graph | core lane markdown-only; needs the kernel |
134+
| 2026-05-06-splat-osint-ingestion | lance-graph | real EWA/jc spine; markdown-only SPLAT-1 types |
135+
| 3DGS-Blender-transcode-crosspollination | lance-graph | real bridges, speculative mappings |
136+
| 3DGS-SplatShaderBlas-BLASGraph | lance-graph | **plan inverts blasgraph/bgz17 (see correction #1); blasgraph is canonical** |
137+
| 3DGS-domain-adapter-strategy | lance-graph | trait stays plan-level until 2 adapters exist |
138+
| bindspace-columns | lance-graph | cols A–D real; E–H proposals |
139+
| causaledge64-mailbox-rename-soa | lance-graph | real crates; draft compartment layer |
140+
| anatomy-realtime | lance-graph | strong floor; depends on unmerged tiers + fixtures |
141+
| 3DGS-ultrasound-SaMD | lance-graph | no in-repo fixture; SaMD trajectory |
142+
| lance-graph-rdf-fma-snomed | lance-graph | grounds the ontology bridge; itself ontology ingest |
143+
| sprint-5-through-9-roadmap | lance-graph | only Sprint 7/9 touch splat/EWA/jc; rest compliance |
144+
| 3DGS-render-depth-certification | ndarray | point-cloud fallback per KHR · *pending whole-read* |
145+
146+
## Hop 3 — ARCHIVE (superseded / fabrication-heavy)
147+
148+
| Plan | Repo | Note |
149+
|---|---|---|
150+
| cognitive-substrate-convergence-v1 | lance-graph | superseded by v3 |
151+
| cognitive-substrate-convergence-v2 | lance-graph | superseded by v3 |
152+
| Palette256-3DSB-PhiSpiral-attention-integration | lance-graph | **most fabrication-heavy** — 5+ markdown-only primitives, no deliverables |
153+
154+
## Out of scope — a separate program (real/shipping, not codec/3DGS)
155+
156+
- **graph-DB / ontology:** lance-graph-ontology-v5, sql-spo-ontology-bridge,
157+
lf-integration-mapping, unified-integration, compile-time-consumer-binding
158+
- **business / SaaS / RBAC:** super-domain-rbac-tenancy, callcenter-membrane,
159+
supabase-subscriber, foundry-consumer-parity, foundry-roadmap-unified-smb-medcare,
160+
palantir-parity-cascade, q2-foundry-integration, ogit-cascade-supabase-callcenter,
161+
grammar-foundry-followup, elegant-herding-rocket
162+
163+
These reuse the shared VSA/CAM-PQ/bgz17 fingerprint substrate as a *storage
164+
layer* but are not about splatting.
165+
166+
## Headline concept: C/HLOD
167+
168+
`C/HLOD` (from `3DGS-epiphany-roadmap`) = **Cesium HLOD (shipping, Apr 2026) +
169+
error-certificate + query-relevance overlay.** The HLOD half is now a real,
170+
shipped Cesium feature (`GaussianSplat3DTileContent`, back-to-front radix
171+
`GaussianSplatSorter`); the contribution is the certified/queryable overlay,
172+
which maps onto `tile.rs` radix-sort + `project.rs` conic + `raster.rs`
173+
alpha-blend that ndarray already has.
174+
175+
## Forward program (7 PRs, 3 sessions — this doc is PR #1)
176+
177+
```
178+
W1 (independent): #1 triage [Gov] · #2 ada-3dtiles [Geo] · #3 EWA-SYRK bench [Kernel]
179+
W2 (spine): #4 pr-x12 fixes+archive [Geo] / evidence-policy [Gov] ── #5 canon specs (ASG·BGZ17·C/HLOD) [Gov]
180+
W3 (impl): #6 ErrorCertificate [Kernel] · #7 ASG lobe+recovery-gate [Kernel] (both trail #5)
181+
```
182+
183+
**Parked (deliberately unbuilt):** EWA-SYRK *backend* (gated behind #3's
184+
measurement; likely a 3×3 pessimization) · PR-X12 tensor capstone build
185+
(debt-laden until #4) · `phi_spiral.rs` (wrong manifold, superseded by #7).
186+
187+
## Scope boundary — not whole-read this pass
188+
189+
Honest boundary so the next session knows where to pick up:
190+
`3DGS-certified-field-kernel-substrate` and `3DGS-render-depth-certification`
191+
(ndarray, chat-added) were not in the 7-agent whole-read batches; their rows
192+
above are provisional. The `pr-x12-*` perspective docs are graded by PR #200,
193+
not re-read here.
194+
195+
## Convergence — comment surface
196+
197+
This PR is the comment surface. CodeRabbit, Codex, and the parallel sessions:
198+
please flag (1) mis-graded rows, (2) missed fabrications, (3) corrections to
199+
the correction-list. Hop-2/3 build work lands in PRs #4#7.

0 commit comments

Comments
 (0)