Skip to content

Commit 3927969

Browse files
committed
docs(plans): destale MTPPS OQ-MTP-4 — HILBERT-L4 retired green
The HILBERT-L4 reference in OQ-MTP-4 was stale: #215 (44d104d) verified hilbert3d_encode GREEN first-hand (13/13 tests, level4_all_indices_unique bijective onto [0,4096) -- exactly what cascade addressing needs). The earlier encode([15,15,15],4)==4095 'red' was a wrong ORIENTATION expectation, not an encoder bug; 2925 is a valid endpoint under the shipped orientation. Consequence: 3-D ADDRESSING is sound and tested -> not a blocker. The only remaining octree gap is the 2-D BlockedGrid STORAGE container (z-slice / BlockedGrid3 / project-at-paint, deferred to a volumetric consumer). The L4 suite becomes a standing regression gate, not a blocker. Meta (blackboard): textbook spine-vs-flesh -- the red probe pattern-matched 'encoder broken' (flesh) but the cause was a wrong test expectation (assumption attacking the spine). https://claude.ai/code/session_0178q99yhgoVu9NPk8gmkRU8
1 parent ec15e61 commit 3927969

2 files changed

Lines changed: 27 additions & 7 deletions

File tree

.claude/blackboard.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,3 +162,14 @@ transition-table router — the router is D-MTP-1 work, not existing inventory.
162162
routing policy stays upstream (ndarray=hardware preserved).
163163
[ADDED] OQ-MTP-4: BlockedGrid is 2-D; quadtree native, octree volumes deferred
164164
(z-slice / BlockedGrid3 / project-at-paint — decide on demand).
165+
166+
## 2026-06-11 — MTPPS OQ-MTP-4 destale (HILBERT-L4 retired green)
167+
[CORRECTION] HILBERT-L4 is GREEN, not a blocker (#215, 44d104d7): 13/13 tests,
168+
level4_all_indices_unique bijective onto [0,4096). The "red" P0-4 expectation
169+
encode([15,15,15],4)==4095 was a wrong ORIENTATION assumption, not an encoder
170+
bug — 2925 is a valid endpoint. So 3-D ADDRESSING is sound+tested; the only
171+
octree gap left is the 2-D BlockedGrid STORAGE container. OQ-MTP-4 updated:
172+
addressing not-blocked, storage deferred, L4 suite is a standing regression gate.
173+
[META] Textbook spine-vs-flesh: the red probe pattern-matched "encoder broken"
174+
(flesh) but the cause was a wrong test expectation (assumption attacking spine);
175+
"fixing" the encoder to return 4095 would have broken a correct bijective curve.

.claude/plans/mtpps-markov-tile-pyramid-substrate-v1.md

Lines changed: 16 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -191,13 +191,22 @@ the inline-asm path stays clean; otherwise it follows.
191191
(palette-indexed, wire-ready) or `hpc::renderer` (RenderFrame double-buffer)?
192192
(Recommend: framebuffer for encode-parity — paint and code share the palette.)
193193
- **OQ-MTP-4:** `BlockedGrid` is **2-D** by design (PR-X3 header). Quadtree
194-
pyramids (maps, images, screen-space) are native. Octree *volumes* (3-D splat
195-
fields, the `ok:` implicit-tiling variant) are NOT directly covered — options:
196-
(a) z-sliced stack of 2-D grids per level (cheap, anisotropic), (b) a future
197-
`BlockedGrid3<T, BR, BC, BD>` (real work, own plan), (c) project-to-2-D at
198-
paint time and keep volumes upstream. v1 scopes to quadtree; the octree
199-
decision is deferred until a volumetric consumer demands it. Do NOT claim the
200-
2-D grid "is" the 3-D pyramid.
194+
pyramids (maps, images, screen-space) are native. The 3-D *addressing* is **not
195+
a blocker**`hilbert3d_encode` is **verified green** (#215, 2026-06-10:
196+
13/13 tests, `level4_all_indices_unique` bijective onto [0,4096), the exact
197+
property cascade addressing needs; the earlier `encode([15,15,15],4)==4095`
198+
"red" was a wrong *orientation expectation*, not an encoder bug — 2925 is a
199+
valid endpoint). So a 3-D address space exists and is tested; the remaining gap
200+
is only the *storage container*. Octree *volume storage* (3-D splat fields,
201+
the `ok:` implicit-tiling variant) is NOT yet covered by `BlockedGrid`
202+
options: (a) z-sliced stack of 2-D grids per level (cheap, anisotropic),
203+
(b) a future `BlockedGrid3<T, BR, BC, BD>` (real work, own plan),
204+
(c) project-to-2-D at paint time and keep volumes upstream. v1 scopes storage
205+
to quadtree; the octree-storage decision is deferred until a volumetric
206+
consumer demands it. The L4 Hilbert suite is a **standing regression gate**
207+
(any table change must keep it green before L-deep addressing claims), no
208+
longer a blocker. Do NOT claim the 2-D grid "is" the 3-D pyramid — but DO note
209+
the 3-D address math is already sound.
201210

202211
---
203212

0 commit comments

Comments
 (0)