claude@clouddev1
628b250db6
Post-merge documentation accuracy pass (CI and website branches both merged to main; website deployed). - CLAUDE.md: rewrite the stale repository-layout tree; add a Website & docs-site decision bullet (Astro+Starlight, Cloudflare Pages via Gitea Actions, ADR-website-001, the website branch stays open); update the CI note (merged to main; release-macos dispatchable + verified working). - requirements.md: D1 — macOS targets now runtime-verified (release-macos dispatched end-to-end); DOC1 — canonical user docs now live on the deployed website. - ADR-ci-003 (+ docs/ci/adr README): Amendment 2 — CI on main, release-macos dispatched + verified; macOS runtime-verified. - docs/website/adr README: drop the stale "no CI yet". - .gitignore: ignore .wrangler/ (Cloudflare Wrangler cache) and .vscode/; remove the tracked website/.vscode/ an Astro template had added. D3 (package-manager manifests) + some install instructions remain open.
Website Architecture Decision Records
Decision records for the public website + documentation site subproject
(the Astro/Starlight site under website/). These are kept in their own
namespace, separate from the project-wide ADRs in
docs/adr/, so website decisions never compete with
the main global ADR sequence for numbers — see
ADR-0000 "Numbering discipline".
Numbering. Files are named <date>-adr-website-<NNN>.md and referenced
in prose as ADR-website-NNN. The <date> (the ADR's accepted/created day,
YYYYMMDD) plus the website segment keeps the namespace disjoint from
main's integers. Assign the next free NNN from this index. Every ADR
change updates this index in the same edit (the ADR-0000 index-upkeep rule
applies here too).
Index
- ADR-website-001 — Public website and documentation site — Accepted 2026-06-04 (formerly ADR-0044 in the main index; moved here 2026-06-10 to end recurring cross-branch number collisions). The first public website: a marketing landing page plus the canonical user docs. Stack Astro 6 + Starlight + Tailwind v4 (chosen over SvelteKit + Tailwind for a docs-heavy + marketing site; interactive bits as Astro islands). Showcase demos are asciinema
.castrecordings (scripted-input driver for paced, re-recordable sessions — nothistory.logreplay), reused inline in docs. The in-page WASM playground is deferred (OOS: deferred) behind a stableDemoseam, with the portable-core vs native-edge boundary recorded for a future ADR + iteration plan. Portable static build (Cloudflare target via Gitea Actions, host-agnostic); monorepo (website/). §4 update (CI implemented): the static→Cloudflare Pages deploy now runs via Gitea Actions (.gitea/workflows/website.yaml; the crate gate is skipped for website-only changes); bothwebsiteandmainare merged and the site is deployed. Docs cover the full supported feature set with "planned" callouts for the unshipped minority; two wording rules bind user-facing copy — no engine name (continues ADR-0002) and no "DSL" ("simple mode" / "advanced mode"). Install docs cover prebuilt binaries + package managers (D1–D3 track the release tooling). Plan:docs/website/plans/20260604-website-implementation-plan.md