Hypothium Zero-Day Operator Guide

A static Astro site that presents the operator run path for the Hypothium zero-day revenue launch (PLAN-727): the ten steps, stop conditions, status meanings, the founder-day schedule, and the recovery matrix for one solo operator.

The site is documentation only. It does not run the plan, grant approvals, or change any Kanban, Git, or vendor state. The plan and its JSON contracts remain authoritative; where they disagree with this site, follow the stricter rule.

Requirements

• Node.js >= 22.12.0 (see package.json → engines).
• npm (ships with Node). A committed package-lock.json pins every dependency.
• mise is optional locally but is how CI runs the checks.

Local setup

npm ci        # reproducible install from package-lock.json
npm run dev    # dev server at http://localhost:4321/hypothium-zero-day-guide/

Exact checks

Each check is a single command and is also wired into mise run ci.

Check	Command	What it proves
Unit / content / a11y tests	npm test	Content contract and component accessibility.
Type & content diagnostics	npm run check	astro check under TypeScript strict mode, zero errors.
Production build	npm run build	Static output into dist/.
Links & expected content	npm run verify:dist	No broken internal link; required copy present; only hypothium named.
Source & Markdown limits	npm run verify:limits	Source files ≤ 200 lines; Markdown < 200 lines and < 20,000 chars.
Secret-pattern scan	npm run verify:secrets	No secret shapes in tracked source.
Action pin check	node scripts/check-action-pins.mjs	Workflow and README action versions match the required pins.
Voice check	node scripts/voice-check.mjs	No em or en dashes and no blocked words or phrases in source.

Run the whole sequence exactly as CI does:

mise run ci

mise run ci runs, in order: an engine check, the action pin check, the voice check, vitest run, astro check, astro build, then the verify-dist, verify-limits, and scan-secrets scripts.

Build output

npm run build writes a self-contained static site to dist/:

• One directory-style page each for /, /prerequisites/, /run/, /schedule/, /status/, /troubleshooting/, and /acceptance/.
• 404.html, favicon.svg, robots.txt, and sitemap-index.xml.
• No remote fonts, analytics, ad, cookie, tracking, or hosted script. Every style and the small progress script are bundled locally.

Preview the built output with npm run preview.

Deployment configuration

This project is configured for a manual GitHub Pages deployment. A live URL is claimed only after the workflow and live parity checks pass.

• Canonical URLs assume a project site at https://fantasymetals.github.io/hypothium-zero-day-guide/. The site base is /hypothium-zero-day-guide.
• To target a different location, set PAGES_SITE and PAGES_BASE at build time, e.g. PAGES_BASE=/ PAGES_SITE=https://example.com npm run build for a root domain.
• .github/workflows/ci.yml runs mise run ci on push and pull request using actions/checkout@v7, actions/setup-node@v7, and jdx/mise-action@v4.
• .github/workflows/deploy-pages.yml runs mise run ci, then builds and publishes with actions/checkout@v7, actions/setup-node@v7, jdx/mise-action@v4, withastro/action@v6, and actions/deploy-pages@v5. It is manual (workflow_dispatch only) so publication stays a separately approved action. Enable Pages under Settings → Pages → Source: GitHub Actions before the first approved run.

Accessibility and offline use

• Persistent left-rail navigation on desktop; a drawer with a sticky bar on mobile.
• Every step shows its start state, next action, expected result, and stop condition without any JavaScript-only interaction.
• Command copy buttons and locally-saved step progress are progressive enhancements; with JavaScript off, all instructions remain fully visible.
• Accessible tables, status badges with text labels, keyboard focus rings, a print stylesheet, and reduced-motion support are built in.

Project layout

src/
  data/         Typed content from the canonical guides and plan
  components/    Nav, StepCard, DataTable, StatusBadge, CommandBlock, Favicon
  layouts/       Base.astro: the page shell, head metadata, nav
  pages/         One .astro per route, plus 404.astro
  styles/        tokens / base / components / shell CSS
  scripts/       progress.ts (copy + local progress)
scripts/         Node verification scripts used by CI
tests/           vitest content-contract and accessibility tests

License and ownership

Internal operator documentation for the hypothium profile. Not for redistribution.