Skip to content

docs: H.268 addendum §7-§10 — comma closure, 96-bit facet carving, kernel-shape rule, replayable-tile synergies#243

Merged
AdaWorldAPI merged 4 commits into
masterfrom
claude/x265-x266-plans-review-h9osnl
Jul 16, 2026
Merged

docs: H.268 addendum §7-§10 — comma closure, 96-bit facet carving, kernel-shape rule, replayable-tile synergies#243
AdaWorldAPI merged 4 commits into
masterfrom
claude/x265-x266-plans-review-h9osnl

Conversation

@AdaWorldAPI

@AdaWorldAPI AdaWorldAPI commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

Doc-only addendum extending .claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md (merged in #242) with four new sections, per the new plan file .claude/plans/H268-comma-96bit-replayable-addendum-v1.md:

  • §7 Comma closure — the replayable irrational. Pythagorean-comma / Fujifilm X-Trans anti-moiré framing; the workspace's coprime-integer surrogate (helix CurveRuler stride-4-over-17, full permutation, banned Fibonacci-mod-17 pathology). D-QUANTGATE rationale restated to its three real legs (libm non-portability, WGSL floats not IEEE-pinned, bijective closure) — the "float constants round differently" leg is explicitly withdrawn with receipts (std::f64::consts::{GOLDEN_RATIO, EULER_GAMMA} compile bit-exact on the pinned toolchain, φ=0x3FF9E3779B97F4A8 / γ=0x3FE2788CFC6FB619; no std-SIMD const-constants path exists — the assumed spelling was const::simd::*, per helix constants.rs:17-23; the five-backend unfused bit-identical GEMM contract + wasm parity CI). φ-PLACES / walk-QUANTIZES / γ-CORRECTS division of labor. x264 vs AV1 vs address-derived contrast stays [H] behind the J2 fence.
  • §8 The 96-bit facet carving. 48 CAM-PQ + 24 helix ResidueEdge + 24 turbovec (6×4-bit) = 96 bit = exactly the V3 12-byte content-blind payload; ClassView as the carving/LUT selector (cross-ref le-contract.md §3); Signed360 as the out-of-row variant. Table families disambiguated (corrected post-review, commit 33b8807): the 388 KB SpoDistanceMatrices benchmark = the palette structure (3 S/P/O planes × 256² u16 @ 128 KB = 384 KB, palette_distance.rs:145-158); CAM-PQ has no fixed 256² footprint — its ADC tables are per-query 6×256 f32 = 6 KB (cam_pq.rs:76-84); bgz17 = one 256² u16 + k×k u8 compose per palette.
  • §9 The kernel-shape rule. VNNI/AMX for matmul-shaped stages, LUT/texture for lookup-shaped stages — anchored by the measured turbovec receipt (NativeLut 11.4× faster than the VPDPBUSD GEMM polyfill, n=20k/dim=512/4-bit). The ITU-implementability claim is scoped to compute kernels only (not CABAC serial contexts / conformance corners / ECM tool counts). Encode-AVX512 / decode-wgpu asymmetry endorsed with the existing C5/C9 caveats.
  • §10 Replayable-tile synergies — H.268 × cognitive shaders. The 4×4 Morton tile (address-derived phase, stored magnitudes only) as one substrate object with nine consequences across both domains — all probe-gated (D-MTS-1..3, PHASE-1/PERT-RHO/PYR-1 with the J2 dither-only fence unchanged, WHP-1..4); no kill condition weakened.

Old §6 Cross-references renumbered to §11. Blackboard entry appended. Companion lance-graph PR: AdaWorldAPI/lance-graph#698 (E-H268-REPLAYABLE-TILE-1 + #697 post-merge PR_ARC entry).

Review

An internal filigree review (overclaim/receipt/grade audit) ran before ready-for-review; its P1 (the §8 table-family paragraph was wrong on arithmetic and attribution) and both P2s (const-path spelling, le-contract cross-ref) are fixed in commit 33b8807. All other receipts verified against source, including an independent recomputation of the φ/γ bit patterns and the 11.4× turbovec measurement (lib.rs:39-47).

Verification

  • Knowledge-doc test suite: 117/117 green after both commits (python3 -m unittest tests.knowledge.test_pr_x12_knowledge_docs).
  • Stale-symbol grep clean (no affirmative tropical_spmv / scalar_sparse usages).
  • All receipts verified against source this session (helix constants.rs / residue.rs, cam_pq.rs, palette_distance.rs, turbovec lib.rs).

🤖 Generated with Claude Code

https://claude.ai/code/session_01K3RyLEbuNSHxxB3NTTrGki

…rnel-shape rule, replayable-tile synergies

Extends pr-x12-h268-morton-wgpu-synergies.md with four sections per the
new plan file (.claude/plans/H268-comma-96bit-replayable-addendum-v1.md):

- §7 comma closure: Pythagorean-comma/X-Trans anti-moire framing; the
  coprime-integer surrogate (helix CurveRuler stride-4-over-17);
  D-QUANTGATE rationale restated to its three real legs (libm cliff,
  WGSL floats, bijective closure) with the "floats round differently"
  leg explicitly withdrawn (std::f64::consts receipts, five-backend
  bit-identical contract).
- §8 96-bit facet carving: 48 CAM-PQ + 24 helix ResidueEdge + 24
  turbovec = the V3 12-byte content-blind payload; ClassView as
  carving/LUT selector; Signed360 as out-of-row variant; 6x256^2
  CAM-PQ vs bgz17 table-family clarification.
- §9 kernel-shape rule: VNNI/AMX for matmul-shaped, LUT/texture for
  lookup-shaped (turbovec NativeLut 11.4x measured receipt); ITU claim
  scoped to compute kernels only.
- §10 replayable-tile synergies: the 4x4 Morton tile serving H.268
  mode-decision AND cognitive-shader dispatch — nine consequences, all
  probe-gated; no kill condition weakened.

Old §6 Cross-references renumbered to §11; blackboard entry appended;
knowledge-doc test suite green (117/117).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K3RyLEbuNSHxxB3NTTrGki
@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@AdaWorldAPI, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 33 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 8e9a9a6d-8a31-4e19-81cd-3b0cdcd2225d

📥 Commits

Reviewing files that changed from the base of the PR and between 69d4aa3 and 02ff42f.

📒 Files selected for processing (3)
  • .claude/blackboard.md
  • .claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md
  • .claude/plans/H268-comma-96bit-replayable-addendum-v1.md
📝 Walkthrough

Walkthrough

The PR adds an H.268 addendum plan and records its comma-closure, 96-bit facet-carving, kernel-shape, and replayable-tile sections in related knowledge and blackboard documents.

Changes

H.268 Addendum

Layer / File(s) Summary
Addendum plan and execution record
.claude/plans/H268-comma-96bit-replayable-addendum-v1.md
Defines B1–B4 content, landing targets, verification gates, and assigned drafting and review roles.
Synthesis and blackboard integration
.claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md, .claude/blackboard.md
Adds the §7–§10 synthesis and matching blackboard record, renumbers cross-references, and updates the footer.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: claude

Poem

A rabbit hops through tiles of four,
With commas closing every door.
Ninety-six bits neatly align,
LUTs and matmuls draw the line.
Replay the trail—then check the gate! 🐇

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the doc-only addendum and its four new sections.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@cursor

cursor Bot commented Jul 16, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_12216f05-e457-47a8-8b39-e0e62b0809e6)

@AdaWorldAPI AdaWorldAPI marked this pull request as ready for review July 16, 2026 07:52
Review findings applied:

- P1: the "6x256^2 clarification" paragraph in §8 was wrong on both
  arithmetic and attribution — a 256x256 u16 table is 128 KB (not
  64 KB), and the 388 KB SpoDistanceMatrices benchmark is the PALETTE
  structure (3 S/P/O planes x 128 KB = 384 KB,
  palette_distance.rs:145-158), not CAM-PQ. CAM-PQ has no fixed 256^2
  distance-table footprint; its ADC tables are per-query 6x256 f32 =
  6 KB (cam_pq.rs:76-84). Corrected in the knowledge doc, the
  blackboard entry, and the plan file's B2 bullet (with the original
  wrong claim preserved as a stricken note).
- P2: the non-existent std-SIMD const path is documented in helix
  constants.rs:17-23 as `const::simd::*`, not `std::simd::const::*` —
  spelling aligned with the source.
- P2: added the le-contract.md §3 cross-ref for the ClassView carving
  granularities.

Knowledge-doc suite still green (117/117).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K3RyLEbuNSHxxB3NTTrGki

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 69d4aa3b20

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +213 to +216
**6×256² clarification (do not conflate the two table families):** the "six
256×256 tables" belong to **CAM-PQ** — 6 subspaces × one 256×256 u16
distance table each = 6 × 64 KB = **384 KB**, closely matching the measured
388 KB `SpoDistanceMatrices` benchmark footprint (§1 above). **bgz17's

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Correct the CAM-PQ table dimensions

When readers use this addendum to plan the GPU-LUT path, this reverses the table families: the shipped CAM-PQ path precomputes only 6 × 256 per-query distances (src/hpc/cam_pq.rs:76-84, 6 KB as f32), while the 256×256 u16 shape belongs to the palette/SPO distance-matrix family (src/hpc/palette_distance.rs:145-154). Describing CAM-PQ as six 256×256 tables creates a nonexistent 384 KB CAM-PQ asset and contradicts the earlier row that says the CAM-PQ path is six lookups, so downstream probe/memory planning will be routed to the wrong structure.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Confirmed and fixed in 33b8807 (an internal pre-review caught the same reversal concurrently). The paragraph now attributes the 388 KB benchmark to the palette SpoDistanceMatrices (3 S/P/O planes × 256² u16 @ 128 KB = 384 KB, palette_distance.rs:145-158), states that CAM-PQ has no fixed 256² footprint (per-query ADC tables are 6×256 f32 = 6 KB, cam_pq.rs:76-84), and keeps bgz17's one-table-per-palette shape separate. The same correction is propagated to the blackboard entry and the plan file's B2 bullet.


Generated by Claude Code

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md:
- Around line 123-125: Update the description of the X-Trans pattern in the
surrounding passage to characterize its 6×6 arrangement as
“less-regular/quasi-random” rather than “non-repeating,” while preserving the
comparison to Bayer and the anti-aliasing discussion.

In @.claude/plans/H268-comma-96bit-replayable-addendum-v1.md:
- Around line 80-82: Qualify the “bit-exact replay” claims in
.claude/plans/H268-comma-96bit-replayable-addendum-v1.md lines 80-82 and
.claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md lines 290-293 to apply
only to the proven CPU/wasm integer execution path, unless a deterministic
floating-point/backend probe is added; align both statements with the existing
integer-only GPU caveat.
- Around line 83-86: Grade the period-17 weak-dependence claim as [H] and mark
it probe-gated, adding the required statistical test for validating dependence
or correlation against the relevant baseline. Update the claim at
.claude/plans/H268-comma-96bit-replayable-addendum-v1.md:83-86 and mirror the
same qualification and probe requirement at
.claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md:294-298; do not treat the
permutation self-test as sufficient evidence.
- Around line 101-108: Update the ndarray landing-map entry to match the
delivered synthesis diff: either include the promised §5 probe-queue changes in
the landed scope, or remove “probe-queue additions” from the Files description.
Ensure the execution record accurately lists only the sections and artifacts
changed by the supplied diff.
- Around line 67-75: Qualify the address-derived phase claim so it describes
phase-side seekability, not CABAC random access, unless independently
framed/reset decoder regions are available. Update the anti-CABAC wording in
.claude/plans/H268-comma-96bit-replayable-addendum-v1.md lines 67-75, add the
required A8/context-reset precondition in
.claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md lines 267-271, and apply
the same qualified wording in .claude/blackboard.md lines 758-763.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1e9aed8c-01b9-40dd-b948-365c9f99bb42

📥 Commits

Reviewing files that changed from the base of the PR and between b66ddbd and 69d4aa3.

📒 Files selected for processing (3)
  • .claude/blackboard.md
  • .claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md
  • .claude/plans/H268-comma-96bit-replayable-addendum-v1.md

Comment thread .claude/knowledge/pr-x12-h268-morton-wgpu-synergies.md Outdated
Comment thread .claude/plans/H268-comma-96bit-replayable-addendum-v1.md Outdated
Comment thread .claude/plans/H268-comma-96bit-replayable-addendum-v1.md Outdated
Comment thread .claude/plans/H268-comma-96bit-replayable-addendum-v1.md Outdated
Comment thread .claude/plans/H268-comma-96bit-replayable-addendum-v1.md
claude added 2 commits July 16, 2026 08:01
… 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
…, Hambly-Lyons [S] anchor

Appends the operator-directed honourable mention to the three-flavours
block: bgz-tensor's AdaptiveRow (palette centroid index + Hadamard-rotated
residual, i8 outlier / i4+i2 cascade) as the index-PLACES/residual-CORRECTS
continuous-field exit; out-of-row like Signed360, in-row refinement stays
the turbovec nibble lane. Formal anchor graded [S]: Hambly-Lyons 2010
signature uniqueness, analogy-grade until a ladder->signature probe
exists. Canonical text lives on the lance-graph V3 substrate
(le-contract.md §3 + E-PALETTE-RESIDUAL-LADDER-1).

Knowledge-doc suite green (117/117).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K3RyLEbuNSHxxB3NTTrGki
@AdaWorldAPI AdaWorldAPI merged commit 61c59d0 into master Jul 16, 2026
19 checks passed
AdaWorldAPI pushed a commit that referenced this pull request Jul 16, 2026
…llar 11; only the ladder->signature mapping stays [S]

Follow-up to merged #243 (branch restarted from master). The §8
fourth-mode sentence said the Hambly-Lyons anchor was analogy-grade
"until a ladder->signature probe exists" without noting the theorem side
already ships in both repos:
- THIS repo: src/hpc/pillar/signature.rs (Pillar-11 B7 — signature
  transform + Hambly-Lyons sig-kernel, Gram-matrix PSD check,
  certification probe over 1,000 Levy paths).
- lance-graph: crates/jc/src/hambly_lyons.rs (Pillar 11, feature
  hambly-lyons -> sigker; forward/converse probes on
  signature_truncated).

Amended so only the ladder-levels -> signature-levels MAPPING for the
residual cascade stays [S], with its probe building on the existing
Pillar-11 harnesses. Blackboard note appended. Mirrors lance-graph
ec58954 (PR #700).

Knowledge-doc suite green (117/117).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K3RyLEbuNSHxxB3NTTrGki
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants