Public Home page + per-spec "plans → achievements" step (flagged)

[IanMayo]

What

Adds the demonstrator's public-facing Home / Overview page (the "welcome page"), wires it as the published site root, and turns the comms plan's stage-gate progress cadence into a per-spec "plans → achievements" discipline — recorded register-first as a flagged candidate.

The welcome page — docs/assay-home.html

Hand-authored Home page (comms plan §4, page 1; projects concept §1). Modern and graphical, self-contained and static (comms plan §6.4): inline CSS + inline SVG, no external fonts/scripts/CDNs, theme-aware (light + dark). It reuses the demonstrator's own band-pill / four-stop verdict colour language (ui-design §2, comms plan §8) so the site looks like the honesty it reports.

Sections:

• Objectives & premise — JIPOE knowledge made typed, banded, honestly exploitable.
• The spine diagram — Knowledge → Compile → Score → Analyse → Surfaces, status-coloured (demonstrated / in progress / planned).
• See it now — cards linking to the published surfaces: the component gallery (gallery/) and the role-surface wireframes (wireframes.html).
• Theses A–H with honest state chips (explored / planned / horizon).
• Where it is — a progress/achievements tracker (Stage 0/1 done, Stage 2 in progress, gate not yet reached).
• Reading — research notes (live) + a clearly-labelled forthcoming blog/embeds card (no dead link).
• The stance — banded honesty, register-first, every-number-traceable; fictional-Meridian framing stated throughout.

Honesty guardrails hold: nothing is shown as done that the repository does not contain.

Blog link

There are no blog posts in the repo or on gh-pages yet, so the "articles" card is a labelled forthcoming section tied to the roadmap rather than a dead link.

Publish wiring — scripts/build-site.ts

PR #17 merged to main during this work, so the previously-deferred integration is now included. build-site.ts copies docs/assay-home.html to site/index.html (replacing its minimal inline landing), so the demonstrator's front door is this reviewed page. Honest preview labelling is preserved: a <!--BUILD_BADGE--> placeholder is replaced with a preview of PR #N · <sha> badge only on PR-preview builds; production (main) and local builds ship badge-free — a preview must announce itself, the real site needs no label. The page's relative links (gallery/, wireframes.html) resolve to the surfaces the same build copies alongside it.

Process change — register-first (ASSAY-DEC-2)

Modifying the planning process is a decision, so it enters as a flagged candidate, not asserted into peer docs:

• concept.md §6.12 — flagged candidate: each build spec carries a home-page-currency step in its definition of "done" when it moves a thesis or stage from planned to demonstrated. Not yet ratified.
• comms-plan.md §9 + .specify/templates/tasks-template.md — the step wired in provisionally, marked pending ratification, mirroring the DEC-16-floor / sparse-channel "build against the flagged candidate under delegated authority" pattern.

On ratification this batch-propagates to the delivery plan §1.

Verification

• npm test — 89 passing; npm run typecheck clean.
• npm run build:site: production writes the Home page as root (gallery/ + wireframes.html alongside); preview build injects the badge + commit link; committed gallery output byte-identical (regeneration is a no-op).
• Rendered in headless Chromium, light and dark; hero, spine diagram, cards, theses, tracker, and honesty rows all verified. (Fixed a real defect during review: the hero status pill's stage class collided with the tracker's .stage { display: grid } rule and rendered full-width — resolved by renaming the hero modifier classes.)

🤖 Generated with Claude Code

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-07-12 20:39 UTC