Skip to content

Commit 5eb7322

Browse files
dmealingclaude
andcommitted
docs(plan): the website program is complete in-repo; two checks wait on a tag
Six of seven "done when" criteria verified today. The seventh — /reference showing the metamodel — cannot be checked until a tag carries site-reference/, which v0.24.5 predates. Records what the program added that the plan did not ask for, since all three came from one constraint the plan underestimated: the deploy pins to a release tag and installs nothing. That is why the reference renders here rather than at deploy, why the llms mirrors are gated on the tag, and why the tag itself had to stop being cut halfway through a coordinated release. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NynrRND6ZUwGvq3ZUTCfxG
1 parent 20b6e1e commit 5eb7322

1 file changed

Lines changed: 32 additions & 7 deletions

File tree

‎docs/superpowers/plans/2026-08-29-website-self-updating-codegen.md‎

Lines changed: 32 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2401,10 +2401,35 @@ Any nav link labelled "Reference" now points at the metamodel. Add a link to the
24012401
24022402
## Done when
24032403

2404-
- Every metadata and generated-code block on `metaobjects.dev` comes from `site-payload.json`.
2405-
- `bash scripts/ci-local.sh --only gates` is green, including `gate_site_payload` — and that lane still needs only `bun`, still runs offline, and still does not write to the working tree.
2406-
- The release preflight passes, verified via `--preflight-only` (**never** via `release.mjs <v> --dry-run`, which bumps 14 package.json files and regenerates the lockfile before it exits).
2407-
- Each of the eight gates has been seen to FAIL when its condition is broken, and then to pass again.
2408-
- The live site renders every block, `<details>` expands, and `view-source` shows no `<script>`.
2409-
- `/reference` shows the metamodel — all 69 `type.subType` pairs — and `/reference/example` shows the adopter model. No nav link 404s.
2410-
- `meta docs --metamodel --site` refuses with a message instead of silently dropping `--site`.
2404+
- [x] Every metadata and generated-code block on `metaobjects.dev` comes from `site-payload.json`.
2405+
- [x] `bash scripts/ci-local.sh --only gates` is green, including `gate_site_payload` — and that lane still needs only `bun`, still runs offline, and still does not write to the working tree.
2406+
- [x] The release preflight passes, verified via `--preflight-only` (**never** via `release.mjs <v> --dry-run`, which bumps 14 package.json files and regenerates the lockfile before it exits).
2407+
- [x] Each of the eight gates has been seen to FAIL when its condition is broken, and then to pass again.
2408+
- [x] The live site renders every block, `<details>` expands, and `view-source` shows no `<script>`.
2409+
- [~] `/reference` shows the metamodel — all 69 `type.subType` pairs — and `/reference/example` shows the adopter model. No nav link 404s.
2410+
- [x] `meta docs --metamodel --site` refuses with a message instead of silently dropping `--site`.
2411+
2412+
> **STATUS 2026-08-30 — the program is complete in this repo; two live verifications wait
2413+
> on the next release.**
2414+
>
2415+
> Verified today: 15 placeholders live on metaobjects.dev, all filled, zero `<script>`, 8
2416+
> `<details>` expanders; the `gates` lane green at 20 checks (now including `site reference
2417+
> is fresh`), offline, bun-only, leaving the tree clean; the release preflight green via
2418+
> `--preflight-only`; `site-reference/index.html` carries exactly **69** `type.subType`
2419+
> pairs.
2420+
>
2421+
> **The one criterion not yet met live is `/reference`**, and only because `v0.24.5`
2422+
> predates `site-reference/`. Both held site commits (`ef743d7` llms mirrors, `55f9aae`
2423+
> reference + example) go out immediately after the next release, which `finish-release.mjs`
2424+
> now guarantees will carry both the renderer output and fresh llms mirrors.
2425+
>
2426+
> **What this program added that the plan did not ask for, all forced by the same
2427+
> constraint** — the deploy pins to a release tag and installs nothing:
2428+
> - `scripts/finish-release.mjs`, because the tag was cut in the MIDDLE of a coordinated
2429+
> release and therefore named a tree stating three registry versions that were never
2430+
> published. The website reads that tree. Fixed as ORDER, gated six ways, proven by
2431+
> breaking each gate.
2432+
> - `site-reference/` rendered here rather than at deploy, and gated for freshness on both
2433+
> difference and orphan.
2434+
> - The llms freshness gate on the tag, for the same reason: the site copies from the tag,
2435+
> and the docs refresh had always been a post-tag commit.

0 commit comments

Comments
 (0)