Skip to content

Materialize pages before optional URL hydration - #819

Merged
chubes4 merged 5 commits into
mainfrom
feat/815-page-first-materialization
Aug 3, 2026
Merged

Materialize pages before optional URL hydration#819
chubes4 merged 5 commits into
mainfrom
feat/815-page-first-materialization

Conversation

@chubes4

@chubes4 chubes4 commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

Fixes #815

Summary

  • Persist and materialize a deterministic page_ready batch checkpoint after all requested HTML and stylesheet/font-critical dependencies are collected.
  • Continue optional asset hydration through the existing strict complete-snapshot collection path, then materialize the deterministic final artifact.
  • Report page-ready routes as materialized progress during cooperative deadline continuations.

Evidence

  • npm test passed: 44 selected checks, 0 failed.
  • php tests/smoke-url-batch-import.php passed, including interruption after page readiness, resume, and byte-for-byte final artifact equivalence with a clean run.
  • URL collector and URL import runtime smokes passed; all production PHP files passed php -l; git diff --check passed.
  • Scoped Homeboy whitespace gate passed: homeboy review lint --file includes/class-static-site-importer-url-batch-import.php --sniffs Generic.WhiteSpace.ScopeIndent,Generic.WhiteSpace.ArbitraryParenthesesSpacing,Squiz.ControlStructures.ControlSignature,WordPress.Arrays.ArrayKeySpacingRestrictions --placement local --summary.

Compatibility and Schema

  • The existing static-site-importer/url-site-batch-run/v1 manifest schema remains unchanged. page_ready is an additive batch state and reuses the existing batch result receipt field.
  • Strict callers retain complete-snapshot collection semantics. Page-first materialization is limited to deadline-governed cooperative URL batches.
  • A resumed page-ready batch verifies its persisted snapshot digest before optional hydration; mismatch fails closed.

AI assistance

OpenAI gpt-5.6-sol via OpenCode implemented the checkpoint, optional hydration continuation, formatting, and deterministic tests. Chris Huber reviewed and remains responsible for every line.

chubes4 added 5 commits August 3, 2026 09:57
AI assistance: OpenAI gpt-5.6-sol via OpenCode implemented the page-ready checkpoint, optional hydration resume path, and deterministic behavioral coverage. Chris Huber remains responsible for the change.
AI assistance: OpenAI gpt-5.6-sol via OpenCode resolved the main merge, repaired lint and static-analysis failures, and verified URL pipeline behavior. Chris Huber remains responsible for every line.
AI assistance: OpenAI gpt-5.6-sol via OpenCode resolved the latest main merge and verified lint, CI-equivalent tests, and URL pipeline smokes. Chris Huber remains responsible for every line.
AI assistance: OpenAI gpt-5.6-sol via OpenCode applied CI-reported formatting corrections and reverified URL pipeline smokes. Chris Huber remains responsible for every line.
AI assistance: OpenAI gpt-5.6-sol via OpenCode applied the remaining CI-reported alignment corrections and verified lint plus the URL batch smoke. Chris Huber remains responsible for every line.
@chubes4
chubes4 merged commit f6aea58 into main Aug 3, 2026
6 checks passed
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.

Materialize collected pages before optional asset hydration completes

1 participant