@@ -20,11 +20,25 @@ things, and nothing else:
2020Using-ArcGIS vs reinventing-and-reverse-engineering is a completely different
2121animal. We are the latter, never the former.
2222
23+ ** Optional grounding pillar (modesty clause).** We keep * one* optional,
24+ feature-gated ` cesium ` ** reference** crate — never in the production hotpath,
25+ never a runtime dependency — whose only job is to run the real Cesium/ArcGIS
26+ path and emit reference output we diff against. This is the * runnable* form of
27+ the legacy pillar: it keeps "we're at parity / better" honest by ** measuring**
28+ against a live oracle instead of asserting it from a capability matrix. It is
29+ the institutional humility against reinvention-hubris — the same "measure,
30+ don't assert" discipline we apply everywhere, turned on our own reinvention
31+ claim. It reads their JSON because it * is* the reference path; that's fine —
32+ it's dev/reference, walled off from production, so rule 3 still holds.
33+
2334## Hard rules
2435
25- 1 . ** Single crate family: ` 3dgs-* ` .** No ` cesium-* ` , no ` ada-* ` (deprecated).
26- Naming is ` 3dgs-<role> ` (` 3dgs-tiles ` , ` 3dgs-ewa-syrk ` , future ` 3dgs-render ` ,
27- ` 3dgs-codec ` , …).
36+ 1 . ** Single production crate family: ` 3dgs-* ` .** No ` cesium-* ` * production*
37+ family, no ` ada-* ` (deprecated). Naming is ` 3dgs-<role> ` (` 3dgs-tiles ` ,
38+ ` 3dgs-ewa-syrk ` , future ` 3dgs-render ` , ` 3dgs-codec ` , …). ** One exception:** a
39+ single * optional, feature-gated* ` cesium ` ** reference** crate — the runnable
40+ legacy pillar / parity oracle (see Posture's modesty clause), never in the
41+ production hotpath, never a runtime dependency.
2842
29432 . ** CAM SoA is the mandatory representation.** CAM SoA =
3044 - ** content-addressable** — addressed by ` cam_pq ` (CAM-PQ) codebook index, not by position;
@@ -56,7 +70,8 @@ animal. We are the latter, never the former.
5670
57715 . ** Rethink clause.** Our CAM SoA is canonical. An external format is
5872 reconsidered ** only** on falsifiable proof it is strictly better — not by
59- default, not for interop convenience.
73+ default, not for interop convenience. The optional ` cesium ` reference crate
74+ (Posture / rule 1 exception) is the instrument that * produces* that proof.
6075
61766 . ** Creation gate.** A crate exists ** only with ≥1 real consumer** (≥2 for a
6277 generic abstraction — the ` certified-field-kernel-substrate ` self-fence).
@@ -72,6 +87,7 @@ this session carry a description; the rest are the catalogue checklist below.
7287| ---| ---| ---| ---| ---| ---|
7388| ` 3dgs-tiles ` | lance-graph | ` 3dgs-* ` | planned | 3D Tiles reader. ** Reverse-engineers** KHR_gaussian_splatting glTF + ESRI_crs → CAM SoA (donkey-bridge, transitional); JSON read-once at the cold boundary only | Geo |
7489| ` 3dgs-ewa-syrk ` | ndarray (` benches/ ` ) | ` 3dgs-* ` | planned | EWA-SYRK crossover bench (` project_batch ` vs cblas-batched sandwich) | Kernel |
90+ | ` cesium ` (reference) | tbd | ** optional/dev** | planned | runnable ** legacy pillar / parity oracle** — runs the real Cesium/ArcGIS path, emits reference output to diff against. Feature-gated, never hotpath, never a runtime dep. The grounding + modesty instrument | tbd |
7591| ` splat3d ` (module) | ndarray ` src/hpc/ ` | — (pre-conv.) | shipped | CPU-SIMD forward renderer (` spd3 ` /` project ` /` raster ` /` sh ` /` tile ` /` gaussian ` ) | — |
7692| ` cam_pq ` (module) | ndarray ` src/hpc/ ` | — | shipped | 6×256 CAM-PQ codebook — the ** CAM** in CAM SoA | — |
7793| ` simd_soa ` (module) | ndarray ` src/ ` | — | shipped | ` MultiLaneColumn ` lane carrier — the ** SoA** in CAM SoA | — |
0 commit comments