Skip to content

Make HTML compilation run-scoped - #1508

Merged
chubes4 merged 1 commit into
trunkfrom
refactor/canonical-block-materialization
Sep 1, 2026
Merged

Make HTML compilation run-scoped#1508
chubes4 merged 1 commit into
trunkfrom
refactor/canonical-block-materialization

Conversation

@chubes4

@chubes4 chubes4 commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Summary

  • turn HtmlTransformer into a stateless 40-line public facade over immutable runtime and analysis-cache inputs
  • run each document through a fresh HtmlCompilation with one stable session and collaborator graph
  • preserve public constants, emitted-block contracts, fallback reduction, diagnostic attribution, and shared analysis caching
  • redirect intentional white-box tests to the run-scoped compilation boundary

This is the lifetime prerequisite for replacing lazy transformer callbacks with typed session-bound collaborators. The implementation body is copied into the run-scoped class without conversion-policy changes.

Verification

  • composer test (292 parity fixtures and package-install proof)
  • 385 HTML fixtures: identical serialized-block hashes, 0 exceptions
  • reused-transformer state isolation and shared-analysis-cache contracts
  • Homeboy PR architecture audit: 0 introduced findings
  • git diff --check

AI assistance

GPT-5.6 Sol via OpenCode analyzed the session-lifetime coupling, implemented the run-scoped boundary, updated internal architecture contracts, and ran the full verification suite under human direction.

@chubes4
chubes4 merged commit 9ef0aaf into trunk Sep 1, 2026
10 checks passed
@chubes4
chubes4 deleted the refactor/canonical-block-materialization branch September 1, 2026 18:13
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.

1 participant