Skip to content

Commit f99ec7e

Browse files
committed
docs(crate-registry): add optional cesium reference crate (modesty clause)
Counterweight to reinvent-everything hubris. One OPTIONAL, feature-gated cesium reference crate is permitted as the runnable legacy pillar / parity oracle — runs the real Cesium/ArcGIS path, emits reference output to diff against. Walled off from the production hotpath (never a runtime dep; reads their JSON only as the reference path, so rule 3 no-JSON-in-hotpath still holds). It is the institutional 'measure, don't assert' discipline applied to our own reinvention claim, and the instrument that produces the rule-5 'strictly better' proof. Not a cesium-* production family — a single dev/ref crate.
1 parent 20edbf8 commit f99ec7e

1 file changed

Lines changed: 20 additions & 4 deletions

File tree

.claude/knowledge/crate-registry.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,25 @@ things, and nothing else:
2020
Using-ArcGIS vs reinventing-and-reverse-engineering is a completely different
2121
animal. 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

2943
2. **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

5771
5. **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

6176
6. **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

Comments
 (0)