erik/acdream
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

docs(pipeline): spec 6.6 - EnvCell geomId-vs-fileId keying note for MP1c

Browse source 
MP1b review finding, verified against EnvCellRenderer.GetEnvCellGeomId:
runtime dedups interior geometry under a 64-bit content hash (bit 33),
not the cell fileId the pak keys by. MP1c maps at the RegisterCell seam
(read pak[cellFileId], register under geomId, dedup post-load as today);
duplicate blob content on disk is v1-acceptable. GeomId-keyed baking is
not viable in format v1 (hash exceeds PakKey's 56 usable bits).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Erik 2026-07-05 21:59:18 +02:00
parent a5926ebcfc
commit 8814a50f52
1 changed files with 14 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/superpowers/specs/2026-07-05-modern-pipeline-design.md
View file

@ -214,6 +214,20 @@ listed follow-up, not v1.
class gone; user visual gate (no missing/wrong geometry); legacy decode path deleted
from the streaming hot path in the gate commit.
### 6.6 MP1c design note — EnvCell keying (recorded 2026-07-05, MP1b review finding)
The runtime deduplicates interior-cell geometry under a **content hash**
(`EnvCellRenderer.GetEnvCellGeomId(environmentId, cellStructure, surfaces)`,
bit 33 set — verbatim WB), NOT under the cell's dat fileId; many cells share
one geometry. The pak keys EnvCell blobs by cell fileId. MP1c's cutover
therefore maps at the existing seam: `RegisterCell` has the concrete cell in
hand when it wants geometry for a geomId — read `pak[cellFileId]`, register
under the geomId, and post-load dedup continues exactly as today. Cost:
cells sharing geometry duplicate blob content on disk (v1-acceptable;
a one-blob-per-unique-content TOC-alias refinement is a future format
option). Baking under geomId keys directly is NOT viable in format v1 —
the hash is a full 64-bit value and does not fit PakKey's 56 usable bits.
## 7. MP2 — Distance-degrade port (hide-only first cut)
The already-scoped retail port from the 2026-06-23 handoff §3 (read it + the named