Skip to content

Commit 4aafd8a

Browse files
committed
docs: three-flavours-of-256 framing + review qualifications (X-Trans, A8-gated seek, integer-path replay, [H] dependence, landing-map scope)
Operator refinement of the §8 table-family paragraph — three flavours of 256: 1. CAM-PQ = 6x256^2 compressed to 6x256: latent per-subspace 256^2 centroid-distance families, shipped as per-query 6x256 f32 ADC rows (6 KB, cam_pq.rs:76-84), never materialized. 2. bgz17 = the explicit 256^2: one materialized 256^2 u16 table + kxk u8 compose per palette; the 388 KB SpoDistanceMatrices benchmark is this flavour on 3 S/P/O planes (3x128 KB = 384 KB). 3. V3 facet = explicit 6x256^2 as ADDRESS, codec-agnostic: 6x(u8:u8) rails = six coordinate pairs into 256^2 spaces = 96 bits; classid -> ClassView switches which codec's 256^2 family each rail indexes. Plus five external-review qualifications across knowledge doc / plan / blackboard: - X-Trans corrected to "repeating but less-regular 6x6 tile" (was "non-repeating"). - (a) reworded to phase-side seekability — CABAC's serial context chain remains; bitstream-level seek requires A8's framed/context-reset regions. - (f) bit-exact trajectory replay scoped to the proven CPU/wasm integer path; float/GPU stages outside the claim. - (g) period-17 "friendlier to Jirak" graded [H, probe-gated] — the permutation self-test proves bijectivity, not decorrelation; needs a correlation-spectrum probe vs a PRNG baseline. - Landing map aligned with the delivered diff (no §5 probe-queue changes were needed). Knowledge-doc suite green (117/117). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K3RyLEbuNSHxxB3NTTrGki
1 parent 33b8807 commit 4aafd8a

3 files changed

Lines changed: 106 additions & 65 deletions

File tree

.claude/blackboard.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -749,18 +749,23 @@ default is x86-64-v3 (avx2) so ndarray_simd activates on avx512 builds only.
749749
division of labor stated as a rule.
750750
- **§8 96-bit facet carving:** CAM-PQ 48b + helix `ResidueEdge` 24b +
751751
turbovec 24b = 96 bit = the V3 12-byte content-blind payload identity;
752-
`Signed360` (48b) is the out-of-row alternate carving. Table families
753-
disambiguated (post-review correction): 388KB benchmark = palette
754-
`SpoDistanceMatrices` 3×(256² u16 = 128KB); CAM-PQ ADC = per-query
755-
6×256 f32 = 6KB (`cam_pq.rs:76-84`), no fixed 256² footprint; bgz17 =
756-
one 256² u16 + k×k u8 compose per palette.
752+
`Signed360` (48b) is the out-of-row alternate carving. Three flavours
753+
of 256 (post-review correction + operator refinement): CAM-PQ =
754+
6×256² compressed to per-query 6×256 f32 ADC rows (6KB,
755+
`cam_pq.rs:76-84`); bgz17 = the explicit materialized 256² u16 (+ k×k
756+
u8 compose; 388KB benchmark = 3 S/P/O planes × 128KB); V3 facet =
757+
explicit 6×256² as codec-agnostic ADDRESS (6×(u8:u8) rails = 96 bit;
758+
classid→ClassView switches which codec's 256² family each rail
759+
indexes).
757760
- **§9 kernel-shape rule:** VNNI/AMX for matmul-shaped ops, LUT/texture
758761
for lookup-shaped ops — turbovec NativeLut measured **11.4×** faster
759762
than the VPDPBUSD GEMM polyfill (n=20k/dim=512/4-bit, FINDING). ITU
760763
claim scoped to compute kernels only (not CABAC/conformance/ECM count).
761764
- **§10 replayable-tile synergies:** 4×4 Morton tile as the shared
762-
object between H.268 (anti-CABAC seek, seekable grain, C6-scoped
763-
native tiling) and cognitive shaders (RNG-free exploration, replayable
764-
thinking, anti-confabulation, cache-native 192B working set) — all
765-
nine consequences stay **probe-gated** (D-MTS-1..3, PHASE-1/PERT-RHO/
766-
PYR-1, WHP-1..4, L4 doc-lock); no kill condition weakened.
765+
object between H.268 (phase-side seekability — entropy-level seek
766+
still A8-gated; seekable grain; C6-scoped native tiling) and cognitive
767+
shaders (RNG-free exploration, replayable thinking on the CPU/wasm
768+
integer path, anti-confabulation [H, needs correlation-spectrum
769+
probe], cache-native 192B working set) — all nine consequences stay
770+
**probe-gated** (D-MTS-1..3, PHASE-1/PERT-RHO/PYR-1, WHP-1..4, L4
771+
doc-lock); no kill condition weakened.

.claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md

Lines changed: 56 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -120,9 +120,11 @@ any float-path GPU bit-exactness claim.
120120
The Pythagorean comma is the residue of a stack of pure fifths that never
121121
closes back onto the octave; a piano tuner's real-world dodge (equal
122122
temperament) trades exactness for closure. Fujifilm's X-Trans sensor
123-
generalizes the same move spatially: its non-repeating 6×6 pixel arrangement
124-
is deliberately incommensurate with common demosaic/moiré periods, so the
125-
anti-aliasing filter can be thinned or dropped. Both are the same design
123+
generalizes the same move spatially: its 6×6 colour-filter tile — repeating,
124+
but far less regular than Bayer's 2×2 (a larger period with a quasi-random
125+
arrangement inside the tile) — is deliberately less commensurate with common
126+
demosaic/moiré periods, so the anti-aliasing filter can be thinned or
127+
dropped. Both are the same design
126128
pattern: **a generator that does not resonate with the sampling lattice
127129
avoids the periodic beat pattern (the comma) that a resonant generator
128130
produces.**
@@ -211,26 +213,33 @@ row — it is the **out-of-row / alternate-carving variant**, selected
211213
instead of (not in addition to) the `ResidueEdge` + turbovec pairing when
212214
full-sphere signed precision is needed.
213215

214-
**Table-family clarification (corrected 2026-07-16 post-review — do not
215-
conflate three distinct structures):**
216-
- The measured **388 KB `SpoDistanceMatrices` benchmark** (§1 above) is the
217-
**palette** structure: **3 S/P/O planes × one 256×256 u16 distance table
218-
(128 KB each) = 384 KB** (`palette_distance.rs:145-158` — `DistanceMatrix
219-
{ data: Vec<u16>, k }`, one per subject/predicate/object plane).
220-
- **CAM-PQ has no fixed 256×256 distance-table footprint.** Its 6-subspace
221-
structure is the per-vector 48-bit **code** (the §8 lane table above);
222-
its ADC distance tables are **per-query** `6 × 256` f32 = **6 KB**,
223-
recomputed per query and L1-resident (`cam_pq.rs:76-84`).
224-
- **bgz17's palette layer** is one 256×256 u16 distance table **plus** a
225-
k×k u8 compose table, per palette.
226-
The first and third share the "256×256 dense u16 LUT, texture-isomorphic"
227-
shape (§3 row 2 above); none of the three footprints should be added to or
228-
substituted for another. (An earlier draft of this paragraph attributed
229-
the 384 KB to "6 × 64 KB CAM-PQ tables" — wrong on both the arithmetic, a
230-
256×256 u16 table is 128 KB, and the attribution.)
231-
This carving is a `ClassView` projection over content-blind bytes — see
232-
lance-graph `le-contract.md §3` for the canonical 6×(u8:u8) / 4×(u8:u8:u8)
233-
/ 3×(u8:u8:u8:u8) readings the same 12-byte register supports.
216+
**Three flavours of 256 (table-family clarification, corrected + refined
217+
2026-07-16 post-review — operator framing):**
218+
- **CAM-PQ — 6×256² compressed to 6×256.** The latent structure is six
219+
per-subspace 256×256 centroid-distance families, but the shipped path
220+
never materializes them: ADC precomputes a **per-query 6×256 f32
221+
row-set** = **6 KB**, L1-resident, recomputed per query
222+
(`cam_pq.rs:76-84`) — the compressed, asymmetric projection of the
223+
latent 6×256². (A symmetric code↔code variant would materialize the
224+
full six tables; the shipped codec does not.)
225+
- **bgz17 — the explicit 256².** One materialized dense 256×256 u16
226+
distance table per palette, **plus** a k×k u8 compose table. The
227+
measured **388 KB `SpoDistanceMatrices` benchmark** (§1 above) is this
228+
flavour on the three S/P/O planes: **3 × (256² u16 = 128 KB) = 384 KB**
229+
(`palette_distance.rs:145-158`).
230+
- **V3 facet — explicit 6×256² as ADDRESS, codec-agnostic.** The 12-byte
231+
content-blind payload read as `6×(u8:u8)` rails = six coordinate pairs
232+
into 256×256 spaces = **96 bits of pure address**. The payload does not
233+
know whose tables its rails index — **`classid → ClassView` selects
234+
which codec's 256² family** (CAM-PQ subspace, bgz17 palette, helix
235+
residue) interprets each rail. See lance-graph `le-contract.md §3` for
236+
the canonical 6×(u8:u8) / 4×(u8:u8:u8) / 3×(u8:u8:u8:u8) readings of
237+
the same register.
238+
The first two are table *footprints* (compressed vs materialized); the
239+
third is the *addressing shape* they are consumed through. None of the
240+
footprints should be added to or substituted for another. (An earlier
241+
draft attributed the 384 KB to "6 × 64 KB CAM-PQ tables" — wrong on both
242+
the arithmetic, a 256² u16 table is 128 KB, and the attribution.)
234243

235244
## 9. The kernel-shape rule (engine follows operation shape)
236245

@@ -277,10 +286,15 @@ function of its address via the bijective coprime walk (§7), and the only
277286
bytes actually stored are magnitudes. Same object, two consumers.
278287

279288
**H.268 consequences:**
280-
- **(a) Anti-CABAC random access** — no serial phase state to carry, so a
281-
decoder can seek directly into a tile without replaying a bitstream
282-
prefix; strengthens the C4 path once A8 (region-addressable stream
283-
framing) lands.
289+
- **(a) Phase-side seekability (the anti-CABAC direction)** — the phase
290+
generator carries no serial state, so the *phase side* of any tile is
291+
reconstructible at any address with no prefix replay. This is NOT by
292+
itself CABAC random access: the entropy-coded magnitudes still carry
293+
CABAC's serial context chain, so bitstream-level seeking additionally
294+
requires independently framed / context-reset regions — which is
295+
precisely what A8 (region-addressable stream framing) provides. The
296+
consequence strengthens the C4 path **only once A8 lands**; until then
297+
it is phase-side seekability only.
284298
- **(b) Seekable grain** — unlike AV1's seeded film-grain synthesis
285299
(decoder must carry PRNG/seed bookkeeping), the integer walk regenerates
286300
identically from the address alone and survives a WGSL port per the C9
@@ -301,13 +315,21 @@ bytes actually stored are magnitudes. Same object, two consumers.
301315
loop (composes with `E-NOBODY-WAITS-1`).
302316
- **(f) Replayable thinking = auditable cognition** — combined with
303317
temporal-stream replayability (`E-MARKOV-TEMPORAL-STREAM-1`), a full
304-
trajectory including exploration noise re-runs bit-exactly;
305-
counterfactual replay therefore stores **zero** exploration state.
306-
- **(g) Anti-confabulation = anti-moiré in concept space** — a coprime
307-
probe schedule is decorrelated from the palette lattice by construction;
308-
a *known* period-17 dependence structure is friendlier to
309-
`I-NOISE-FLOOR-JIRAK`'s weak-dependence analysis than an *unknown* PRNG
310-
correlation structure would be.
318+
trajectory including exploration noise re-runs bit-exactly **on the
319+
proven CPU/wasm integer path** (the pinned-order five-backend contract);
320+
float and GPU stages stay outside the bit-exactness claim per §3 row 9
321+
(the integer-only GPU caveat) unless a deterministic-backend probe is
322+
added. Within that scope, counterfactual replay stores **zero**
323+
exploration state.
324+
- **(g) Anti-confabulation = anti-moiré in concept space [H, probe-gated]**
325+
— a coprime probe schedule is decorrelated from the palette lattice by
326+
construction, and a *known* period-17 dependence structure is plausibly
327+
friendlier to `I-NOISE-FLOOR-JIRAK`'s weak-dependence analysis than an
328+
*unknown* PRNG correlation structure. The "friendlier" half is an
329+
**unverified inference**: the period-17 permutation self-test proves
330+
bijectivity, NOT decorrelation. Promotion to FINDING requires a measured
331+
dependence probe — the walk's correlation spectrum against the palette
332+
lattice vs a PRNG baseline, judged under Jirak weak-dependence rates.
311333
- **(h) Exact phase-side unbinding** — sign is recomputable per address
312334
with no cleanup codebook needed; a cleanup codebook is only needed for
313335
magnitudes. The two-algebra rule (sign = XOR, magnitude = `vsa_bundle`,

.claude/plans/H268-comma-96bit-replayable-addendum-v1.md

Lines changed: 35 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -47,14 +47,18 @@
4747
indexes which table).
4848
- Budget constraint: `Signed360` (6B) does NOT fit alongside both other
4949
lanes; it is the out-of-row/alternate-carving variant.
50-
- Table-family clarification **(CORRECTED post Opus-review — the original
51-
bullet here claimed "six 256×256 CAM-PQ tables, 6×64KB=384KB", wrong on
52-
arithmetic AND attribution)**: the 388KB `SpoDistanceMatrices` benchmark
53-
is the **palette** structure — 3 S/P/O planes × one 256² u16 table
54-
(128KB each) = 384KB (`palette_distance.rs:145-158`); CAM-PQ has NO
55-
fixed 256² footprint — its ADC tables are per-query 6×256 f32 = 6KB
56-
(`cam_pq.rs:76-84`); bgz17's palette layer is one 256² u16 + k×k u8
57-
compose per palette.
50+
- Table-family clarification **(CORRECTED post Opus-review, REFINED per
51+
operator — the original bullet claimed "six 256×256 CAM-PQ tables,
52+
6×64KB=384KB", wrong on arithmetic AND attribution)**. Three flavours
53+
of 256: (1) **CAM-PQ = 6×256² compressed to 6×256** — latent
54+
per-subspace 256² families, shipped as per-query 6×256 f32 ADC rows =
55+
6KB (`cam_pq.rs:76-84`), never materialized; (2) **bgz17 = the explicit
56+
256²** — one materialized 256² u16 table + k×k u8 compose per palette;
57+
the 388KB `SpoDistanceMatrices` benchmark is this flavour on 3 S/P/O
58+
planes = 3×128KB = 384KB (`palette_distance.rs:145-158`); (3) **V3
59+
facet = explicit 6×256² as ADDRESS** — 6×(u8:u8) rails = six coordinate
60+
pairs into 256² spaces = 96 bits, codec-agnostic; `classid → ClassView`
61+
selects which codec's 256² family interprets each rail.
5862

5963
### B3 — Kernel-shape rule (new §9)
6064
- **Match engine to operation shape:** VNNI/AMX for matmul-shaped stages
@@ -72,23 +76,33 @@
7276
### B4 — Replayable-tile synergies: H.268 × cognitive shaders (new §10)
7377
The object: 4×4 Morton tile (2bit x ⊕ 2bit y), phase address-derived via the
7478
bijective walk, magnitudes the only stored content. Consequences:
75-
- H.268: (a) anti-CABAC random access (no serial phase state; strengthens
76-
the C4 path once A8 lands); (b) seekable grain (vs AV1 seed bookkeeping;
77-
integer walk survives WGSL per C9); (c) conformance = the period-
78-
permutation self-test; error localizes to magnitudes; (d) parallelism:
79-
16 cells = one SIMD lane group / wgpu workgroup tile — NATIVE to the
80-
H.268 scene codec; HEVC-compat lane keeps 8×8/64×64 (C6 correction
81-
preserved).
79+
- H.268: (a) phase-side seekability, the anti-CABAC *direction* (no serial
80+
phase state; NOT CABAC random access by itself — entropy-coded magnitudes
81+
keep CABAC's serial context chain, so bitstream-level seek additionally
82+
requires A8's independently framed/context-reset regions; strengthens the
83+
C4 path only once A8 lands) **[qualified post-review]**; (b) seekable
84+
grain (vs AV1 seed bookkeeping; integer walk survives WGSL per C9);
85+
(c) conformance = the period-permutation self-test; error localizes to
86+
magnitudes; (d) parallelism: 16 cells = one SIMD lane group / wgpu
87+
workgroup tile — NATIVE to the H.268 scene codec; HEVC-compat lane keeps
88+
8×8/64×64 (C6 correction preserved).
8289
- Cognitive shaders (the bigger half): (e) RNG-free exploration — phase =
8390
pure function of position; deletes the last shared-mutable-state
8491
candidate from the thinking loop (composes with E-NOBODY-WAITS-1);
8592
(f) replayable thinking = auditable cognition — with temporal-stream
8693
replayability (E-MARKOV-TEMPORAL-STREAM-1), full trajectory incl.
87-
exploration noise re-runs bit-exactly; counterfactual replay stores zero
88-
exploration state; (g) anti-confabulation = anti-moiré in concept space
89-
(coprime probe schedule decorrelated from the palette lattice; known
90-
period-17 dependence structure is friendlier to I-NOISE-FLOOR-JIRAK than
91-
unknown PRNG correlations); (h) exact phase-side unbinding (sign
94+
exploration noise re-runs bit-exactly **on the proven CPU/wasm integer
95+
path only** (pinned-order five-backend contract; float/GPU stages stay
96+
outside the claim per the integer-only GPU caveat) **[qualified
97+
post-review]**; counterfactual replay stores zero exploration state
98+
within that scope; (g) anti-confabulation = anti-moiré in concept space
99+
**[H, probe-gated — qualified post-review]** (coprime probe schedule
100+
decorrelated from the palette lattice by construction; the claim that
101+
known period-17 dependence is friendlier to I-NOISE-FLOOR-JIRAK than
102+
unknown PRNG correlations is an unverified inference — the permutation
103+
self-test proves bijectivity, not decorrelation; promotion needs a
104+
measured correlation-spectrum probe vs a PRNG baseline under Jirak
105+
rates); (h) exact phase-side unbinding (sign
92106
recomputable per address; cleanup codebook needed for magnitudes only;
93107
two-algebra rule intact); (i) the 4×4 tile = cache-native working set
94108
(16×2B ×6 lanes = 192B = 3 cache lines; L4 substrate is flat Morton SoA
@@ -105,7 +119,7 @@ bijective walk, magnitudes the only stored content. Consequences:
105119

106120
| Repo | Branch (restarted from default; both prior PRs merged) | Files |
107121
|---|---|---|
108-
| ndarray | `claude/x265-x266-plans-review-h9osnl` @ origin/master | matrix doc §7-§10 + probe-queue additions; this plan file; blackboard append |
122+
| ndarray | `claude/x265-x266-plans-review-h9osnl` @ origin/master | matrix doc §7-§10 (no §5 probe-queue changes needed — the standing queue already carries every probe §7-§10 references); this plan file; blackboard append |
109123
| lance-graph | `claude/x265-x266-plans-review-h9osnl` @ origin/main | EPIPHANIES prepend (E-H268-REPLAYABLE-TILE-1); capstone pointer line; PR_ARC #697 post-merge entry + LATEST_STATE entry (board-hygiene rule) |
110124

111125
Gates: ndarray knowledge-doc suite (117 tests) green; no affirmative stale

0 commit comments

Comments
 (0)