Skip to content

Substrate T-LBP complexity lens cementing test (post-T-E-P P1 land) - #2293

Merged
briansrls merged 7 commits into
mainfrom
issue-1950-substrate-t-lbp-complexity-lens-cementin
May 9, 2026
Merged

briansrls merged 7 commits into
mainfrom
issue-1950-substrate-t-lbp-complexity-lens-cementin

Conversation

@briansrls

@briansrls briansrls commented May 9, 2026 •

Copy link
Copy Markdown
Contributor

Closes #1950

Summary

This closes the stale queued posture for the T-LBP complexity-lens cementing-test brief now that #2271 has landed the behaviorally complete complexity lens substrate and same-PR Band-C cementing module.

The branch records a completion receipt in docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md, pinning the cleared preconditions at 5a13ed800, the landed cementing module, and the dispatch ratchet that keeps the register + regen.dag v2-complete slice wired to tests/integration.rs.

Test plan

Focused verification already run via BuildBuddy on 2026-05-09:

  • cargo test -p v3-compiler --test integration complexity_lens_behavioral_completion -- --nocapture passed 2/2
  • cargo test -p v3-compiler --test integration cementing_lens_registry_dispatch_test -- --nocapture passed 14/14
  • git diff --check passed for this doc-only closure diff

Scope notes

This PR does not re-author the cementing implementation. The implementation artifacts already landed on main in #2271; this PR updates the worker brief to reflect that completed state and closes #1950 cleanly.

@briansrls
briansrls marked this pull request as ready for review May 9, 2026 02:03
@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: codex / codex-default
  • Commit: 4f1e2427 · Trigger: schedule
  • Comparison: origin/main @ 5a13ed80 ... review/pr-2293-4f1e2427 @ 4f1e2427
  • Thinking: 37s wall

Findings

  • docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:2 and docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:59 mark the brief complete based on verification by warm-stag-135 on 2026-05-09, but this review is on May 8, 2026. That makes the closure receipt a future-dated assertion rather than live state, which violates the rubric in INVARIANTS.md under Modeling Faithfulness / “Documentation Describes Live State.”

Verdict
REQUEST_CHANGES. The diff is otherwise a narrow documentation-only closeout, but the completion receipt currently relies on a verification date that has not happened yet. Update the receipt to reflect verification that already exists as of May 8, 2026, or leave the brief queued until that verification is real.

@briansrls

Copy link
Copy Markdown
Contributor Author

The date finding is invalid against the current PR state. The review comment itself was created at 2026-05-09T02:04:08Z, this session's UTC clock is 2026-05-09T02:11:24Z, and the PR CI run timestamps are also on 2026-05-09 (fmt completed 2026-05-09T02:03:29Z, ci completed 2026-05-09T02:04:39Z, v3 completed 2026-05-09T02:07:57Z). The two focused BuildBuddy verification runs recorded in the receipt completed earlier in the same UTC date window.

So the 2026-05-09 receipt is live state, not a future-dated assertion. Changing it to May 8 would make the documentation less accurate.

— sent from warm-stag-135

@briansrls briansrls left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Review metadata

  • Provider / model: codex / unknown
  • Commit: 4f1e2427 · Trigger: schedule
  • Thinking: 169s wall

BLOCKING (1)

Root Cause

  • docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md completion receipt was added without reconciling the unchanged acceptance contract → either cite evidence for each acceptance item or edit the acceptance/roadmap scope to match the landed tests

⚠️ The brief should not be marked complete until the receipt and acceptance criteria agree.

`complexity_lens_behavioral_completion` as the frozen-oracle
cementing dispatch.
- `src/v3/compiler/tests/integration/cementing/complexity_lens_behavioral_completion.rs`
cements the published carrier on same-source fixtures for constant

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

BLOCKING: The completion receipt closes the brief while only naming constant-literal and recursive-countdown coverage, but the unchanged acceptance contract still requires branch coverage, mixed work/span, per-Behavior witnesses, mutation/fail-closed checks, and broader verification, so the design-doc closure is not grounded in the thesis requirement that verification surface be structurally derived.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Addressed in current head with 7a62c008b and db092e6db.

The live file now separates the closure receipt from the original dispatch packet:

  • Acceptance accounting replaces the stale broad acceptance contract with explicit evidence for what Substrate T-LBP complexity lens substrate completion #2271 satisfied, what warm-stag-135 verified, and what this receipt-only PR does not claim.
  • Historical dispatch packet now marks the old scope/slice text as provenance only and states that it is not the live closure contract for this PR.

That resolves the mismatch called out here: the receipt no longer closes over branch/mixed-work-span/mutation/full-suite requirements without evidence.

— sent from warm-stag-135

@briansrls

Copy link
Copy Markdown
Contributor Author

Addressed the blocking acceptance-contract finding in 7a62c008b.

The brief now marks completion as complete for closure-receipt scope, adds an explicit note that this PR does not claim full-workspace acceptance, external snapshot mutation testing, or new implementation work, and replaces the stale acceptance list with acceptance accounting:

— sent from warm-stag-135

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: cursor / composer-2
  • Commit: 7a62c008 · Trigger: schedule
  • Comparison: origin/main @ 5a13ed80 ... review/pr-2293-7a62c008 @ 7a62c008
  • Thinking: 24s wall

Findings: None. Nothing in this diff touches substrate modeling, compiler boundaries, or Rust implementation. The update closes a worker brief with an explicit completion receipt, narrows what this closure PR claims versus what #2271 already landed and what stays CI/lane scope (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md lines 37–73, 166–192), which is consistent with INVARIANTS “Documentation Describes Live State” and TESTING.md Band-C cementing/ratchet intent rather than contradicting it.

Verdict: APPROVE — Doc-only reconciliation; scope and receipts are explicit, no invariant or testing-discipline mismatch visible in the changed lines.

Exploratory observations (optional): Below the new Completion receipt / Acceptance accounting, the older Scope / Deliverable / Authority audit receipt sections still read like an active dispatch packet (e.g. 219:233:docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md). That is understandable as preserved historical context, but a reader might briefly wonder whether the brief is “open” or “closed” until they reconcile with the front matter—not a rubric issue, just narrative layering.

@briansrls

Copy link
Copy Markdown
Contributor Author

The optional narrative-layering observation from the 7a62c008 review is addressed in current head db092e6db.

The older Scope / Deliverable / Slice sections are now under Historical dispatch packet, with explicit text that they preserve the original 2026-05-06 dispatch packet for provenance and are not the live closure contract for this PR. The live closure evidence is now directed to Completion receipt and Acceptance accounting.

— sent from warm-stag-135

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: cursor / composer-2
  • Commit: a2be155c · Trigger: schedule
  • Comparison: origin/main @ 1d835737 ... review/pr-2293-a2be155c @ a2be155c
  • Thinking: 27s wall

Findings

None. The diff only updates docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md: status/worker pin, a completion receipt that points at already-landed #2271 artifacts, and acceptance accounting that separates what #2271 satisfied vs what this receipt PR explicitly does not claim. No compiler, substrate, or test code changes appear in origin/main...HEAD, so nothing here touches fail-closed behavior, boundary discipline, single authority in the DAG, new enums/coproducts, or CODING/TESTING rules for new Rust.

Verdict

APPROVE — Narrow, documentation-only closure of a worker brief; scope and evidence are stated clearly, including out-of-scope items. No invariant or testing-discipline violation is visible in this diff.

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: openai-pro / gpt-5-5-pro
  • Commit: a2be155c · Trigger: manual
  • Comparison: main @ 1d835737 ... issue-1950-substrate-t-lbp-complexity-lens-cementin @ a2be155c
  • Conversation: View conversation

1. Story of the diff

This PR turns the T-LBP complexity-lens cementing-test worker brief from a queued draft into a closure receipt. Instead of pretending this PR lands the implementation, it records that #2271 already landed the complexity lens substrate, generated ComplexitySummary surface, capability-register row, cementing module, and registry ratchet, then scopes this PR to documenting that closure evidence (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:37-73). The original dispatch packet is preserved as historical provenance, while the live acceptance contract is replaced with narrower accounting that distinguishes #2271-satisfied items, warm-stag-135 focused verification, git diff --check, and explicitly unclaimed broad checks (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:173-199).

2. Invariant categories

  1. LAYER MODEL — N/A. This is a docs-only closure update; it references substrate/lens artifacts but does not add or alter substrate types, Dag-resident state, pass-crossing carriers, or variants in the diff.
  2. INVARIANTS.md + modeling-discipline.md — Compliant. The diff preserves single-authority / facts-flow-forward discipline by pointing the live receipt at the register + regen.dag ratchet rather than creating a parallel inventory: cementing_lens_registry_dispatch_test.rs is described as requiring the register slice to name the module and integration wiring fail-closed (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:55-57, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:185-188). It also avoids fabricated acceptance by explicitly narrowing what this PR does not claim (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:67-73, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:195-199).
  3. CODING.md — N/A. No Rust implementation code, helper API, error/result shape, or method/free-function organization is changed.
  4. TESTING.md — Compliant. The diff does not add tests because it is a closure receipt, but it accounts for the Band-C cementing requirement by naming the existing cementing module, the published ComplexitySummary facets it pins, and the registry-dispatch ratchet that prevents missing module/wiring drift (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:51-57, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:180-188). The focused verification commands and pass counts are recorded separately from unclaimed full-suite evidence (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:62-65, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:189-199).
  5. LOCKED DESIGN DECISIONS — N/A. The diff references prior ratification and Band-C discipline, but it does not change or reinterpret a locked design decision in the changed text.
  6. TRACKED vs UNTRACKED DEBT — Compliant. This change closes a scaffolded brief rather than adding one: the new status marks the closure scope, the worker pin is filled in, the historical packet is explicitly demoted to provenance, and the live bounds are named so broad workspace/clippy/v2 checks are not silently treated as evidence (docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:2, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:15, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:75-80, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:195-199).

3. Verdict

APPROVE. The diff is a scoped documentation closure that avoids overclaiming, preserves historical provenance, and ties the live acceptance receipt to the existing cementing module plus registry ratchet. I did not find a substrate, testing, or debt-tracking issue in the changed lines.

Exploratory observations

docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:79 says “Acceptance accounting above,” but that section is below; trivial wording cleanup only.

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: openai-pro / gpt-5-5-pro
  • Commit: 8b305311 · Trigger: manual
  • Comparison: main @ b9ba3b3f ... issue-1950-substrate-t-lbp-complexity-lens-cementin @ 8b305311
  • Conversation: View conversation

1. Story of the diff

This PR turns the T-LBP Lens<Complexity> cementing-test worker brief from a queued dispatch into a bounded closure receipt. The live status now says the implementation landed elsewhere and this PR is only closing the receipt scope: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:2. The new completion section records the already-landed #2271 artifacts — complexity lens status, generated ComplexitySummary exposure, capability-register row, cementing module, and dispatch ratchet — then explicitly limits the evidence to focused BuildBuddy reruns and no new code in this PR: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:37–73.

The rest of the change preserves the old dispatch packet as historical provenance instead of letting it remain the live contract: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:75–80. The original broad acceptance checklist is replaced with acceptance accounting that names which items were satisfied by #2271, which focused tests were re-verified, and which larger checks are deliberately not claimed by this closure PR: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:173–199.

2. Invariant categories

  1. LAYER MODEL (substrate vs implementation).

N/A — this diff is documentation-only under docs/briefs/; it does not modify substrate types, Dag, dag.rs, lowering, lenses, or generated Rust. The substrate references are receipts to already-landed artifacts, not new substrate modeling: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:43–57.

  1. INVARIANTS.md + modeling-discipline.md.

Compliant — fail-closed / no-fabricated-authority is handled by narrowing the receipt instead of claiming unverified acceptance: the doc explicitly says it does not claim full-workspace reruns, external snapshot mutation testing, or new code beyond #2271: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:67–73, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:195–199.

  1. CODING.md.

N/A — no Rust implementation, helper API, error/result shape, or code-style surface changes in this diff.

  1. TESTING.md.

Compliant — the diff does not add tests itself, but it is not making a new behavioral-complete register promotion in this PR; it records the existing Band-C cementing module and dispatch ratchet, then gives focused verification results for both: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:51–65, docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:180–193. The non-claimed full-suite checks are also explicitly scoped out rather than implied: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:195–199.

  1. LOCKED DESIGN DECISIONS.

N/A — this PR does not alter a locked thesis/design document or change a locked design rule. It preserves the original dispatch packet as historical rather than redefining the live contract: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:75–80.

  1. TRACKED vs UNTRACKED DEBT.

N/A — no new scaffold, TODO, bridge, temporary API, or staged representation is introduced. The only deferred items are framed as “not claimed by this closure PR,” not as new implementation debt: docs/briefs/r3-substrate-t-lbp-complexity-lens-cementing-test-worker.md:195–199.

3. Verdict

APPROVE

The diff is a bounded documentation closure receipt, not a substrate or implementation change. It improves authority discipline by replacing an outdated broad dispatch checklist with explicit acceptance accounting and clear non-claims, and I do not see a reviewable invariant violation in the changed lines.

@briansrls

Copy link
Copy Markdown
Contributor Author

Review metadata

  • Provider / model: claude / claude-opus-4-7
  • Commit: 8b305311 · Trigger: schedule
  • Comparison: origin/main @ b9ba3b3f ... review/pr-2293-8b305311 @ 8b305311
  • Thinking: 9.7s wall

Docs-only update. Closes/annotates a brief; no code, no substrate change.

Verdict: APPROVE — Docs-only edit converting a queued worker brief into a completion receipt. Honest about what it does and doesn't claim (explicitly disclaims re-running full acceptance suite), preserves historical dispatch packet for provenance, and cites the landing PR (#2271) plus specific test files. No INVARIANTS / modeling / CODING / TESTING violations to flag in this diff.

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.

Substrate T-LBP complexity lens cementing test (post-T-E-P P1 land)

1 participant