Skip to content

Publish the JCB contextual compilation architecture white paper - #4

Merged
Llewellynvdm merged 18 commits into
mainfrom
compiler-architecture-white-paper
Sep 16, 2026
Merged

Llewellynvdm merged 18 commits into
mainfrom
compiler-architecture-white-paper

Conversation

@Llewellynvdm

@Llewellynvdm Llewellynvdm commented Sep 15, 2026 •

Copy link
Copy Markdown
Contributor

Ready for review

The compiler-centred white paper and publication site are ready for editorial review. All work remains on compiler-architecture-white-paper; main and production hosting have not been changed.

Architectural scope

The publication explains structured GUI intent, portable blueprint identities, local-first entity discovery, graph export/import, contextual classification, intermediate stores, deferred work, ordered binding, Power and namespace placement, target dispatch, complete extension generation, extrusion, self-generation, and maintenance. Language-neutral mathematics and executable reference mechanisms accompany the public Hello World blueprint/product traces and implementation source map.

The public compiler references use the official repository. The integrated extrusion coverage is documented without naming the supplementary development repository or attributing those files to an older core revision.

Publication alignment and failure fixes

  • Replaced the obsolete shared-template link with the current edition/source page.
  • Removed the large homepage wordmark; retained the small VDM mark, text-based JCB Architecture identity, author attribution, copyright, and licenses.
  • Aligned page titles, search text, citation metadata, machine-readable indexes, downloads, and archive naming with architecture.joomlacomponentbuilder.com.
  • Added end-to-end publication tests, including a negative test proving that broken links still fail validation.
  • Connected the existing pinned-source evidence verifier to the build workflow; all four Hello World snapshots are checked against their path/content fingerprints.
  • Retained the existing reading design and strengthened browser checks for every math region and image.

Verified results

Head commit: a84904a44b317fa0349d93558787f8196ab5326f

Successful Publication run #32:

  • 73 unit and offline integration tests pass.
  • Four pinned blueprint/product sources verify successfully.
  • All 62 pages pass generated-site validation; all 62 Markdown alternates are byte-exact.
  • 10,493 local links checked with zero errors.
  • All 62 pages checked in Chromium on desktop and mobile.
  • Mathematical rendering, diagrams, image loading, system/manual themes, search, Escape handling, and mobile navigation pass.
  • Built site archive and validation screenshots/reports are retained in the workflow artifacts.
  • The CI source archive was downloaded and all 100 source files matched the locally tested content.

These are publication and architectural-companion checks, not a fresh Joomla self-build. Deployment is deliberately skipped on the pull request. The maintainer retains the merge and production-domain activation decisions.

@Llewellynvdm Llewellynvdm changed the title Rewrite the JCB contextual compilation architecture white paper Publish the JCB contextual compilation architecture white paper Sep 16, 2026
@Llewellynvdm
Llewellynvdm marked this pull request as ready for review September 16, 2026 09:47
@Llewellynvdm
Llewellynvdm merged commit 7ac0ba8 into main Sep 16, 2026
2 checks passed
@Llewellynvdm
Llewellynvdm deleted the compiler-architecture-white-paper branch September 16, 2026 13:15
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