Add a changelog page generated from CHANGELOG.md

CHANGELOG.md

@@ -6,6 +6,36 @@ installed copy can be traced back to the release that applied it.
 
 This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## Unreleased
+
+### Added
+
+- The docs site has a changelog page. `site/changelog.html` is generated from
+  this file by `scripts/build-changelog.js` (`npm run build:changelog`) and
+  committed, because GitHub Pages serves `site/` verbatim and this file lives
+  outside `site/`, so the page cannot fetch it at runtime. `npm test` re-renders
+  and fails when the committed page has drifted, so this file stays the single
+  source of truth. The renderer supports only the markdown used here and fails
+  loudly on anything else, rather than printing literal markup on the site.
+
+### Changed
+
+- The mobile nav now collapses below 940px instead of 900px. The new Changelog
+  link makes the widest desktop nav row need about 930px, and between the old
+  breakpoint and that width the right-hand header pill ran past the rail and
+  gave every page a horizontal scroll. A test pins the breakpoint against the
+  measured width.
+
+### Fixed
+
+- The theme toggle's moon rendered as a lopsided blob rather than a crescent.
+  Its inner arc asked for radius 7 across endpoints 16.3 apart; per the SVG
+  spec a radius too small to span its endpoints is scaled up until it fits, so
+  the terminator became a semicircle mirroring the outer edge and the shape
+  lost its taper. It also overflowed the top and right of its 24x24 viewBox.
+  Replaced with a crescent whose arcs are geometrically consistent, on all
+  three pages.
+
 ## 1.1.0 - 2026-07-27
 
 ### Added

docs/testing.md

@@ -14,6 +14,27 @@ npm run check-profiles
 bundle's prompts with installed copies under `~/.config/opencode/agent/`.
 `check-profiles` verifies the model IDs in shipped profiles.
 
+### Changelog site page
+
+`site/changelog.html` is generated from `CHANGELOG.md` and committed, because
+GitHub Pages serves `site/` verbatim and the changelog lives outside it. After
+editing `CHANGELOG.md`, regenerate and commit the page:
+
+```powershell
+npm run build:changelog
+```
+
+`npm test` fails when the committed page has drifted from the changelog, so a
+forgotten rebuild is caught before release rather than shipping a stale page.
+`node scripts/build-changelog.js --check` reports the same drift without
+writing, which is the form to use in a pre-commit hook.
+
+Only the markdown `CHANGELOG.md` actually uses is supported: `##`/`###`
+headings, bullets with wrapped continuation lines, paragraphs, inline code,
+links, and emphasis. Anything else (fenced code, tables, nested bullets) makes
+the build fail with the offending line rather than rendering as literal markup.
+Extend the renderer, or reword the entry.
+
 To validate the lint fixture, run `npm run lint` with `test-playground/` as the
 working directory. Build and plan agents should use the tool's working-directory
 parameter because `npm --prefix test-playground run lint` may not match their

package.json

@@ -24,6 +24,7 @@
   "scripts": {
     "test": "node --test",
     "test:integration": "node scripts/run-integration.js",
+    "build:changelog": "node scripts/build-changelog.js",
     "check-install": "node scripts/check-install.js",
     "check-profiles": "node scripts/check-profiles.js"
   }