Skip to content

Commit 93e53b0

Browse files
committed
site: getting-started rewritten from a real 1.0.4 run; six pillars with maturity labels
getting-started showed a scaffold 1.0.4 no longer writes: four wired generators, a src/db.ts stub, and deps declared by init. It now follows the real flow, captured from the published CLI in a scratch project: init (empty codegen/generators/, generators: []) → gen --list --probe → eject → install → wire → gen → write src/db.ts → migrate → curl. It also stops claiming the generated code has no MetaObjects dependency (the routes mount through runtime-ts), notes that the generated endpoints are unauthenticated, and the model now matches the ask above it. videos.html says the getting-started recording predates 1.0.4. Home: the Verify clause reads "fails or warns" (FR-042 §3 amendment). There are six pillars, each with a maturity label, Libraries is added, and the "less code, less drift" line is gone (measured false). Sharing a model across projects is claimed with its scope clause. requirements.html no longer says the verify checks ship in every port or that the gap "becomes a build failure". AGENTS.md: the CLI-mirror note names the init.ts constants that exist today, and says to verify from a real run outside /tmp. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BHEQGNA9McKNBwDkesNMDC
1 parent 1e873eb commit 93e53b0

6 files changed

Lines changed: 233 additions & 140 deletions

File tree

AGENTS.md

Lines changed: 18 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -20,22 +20,28 @@ This file is the project's committed home for project-intrinsic agent knowledge:
2020

2121
## Content that mirrors the CLI
2222

23-
Several code blocks on `www/getting-started.html` reproduce what `meta init` actually writes
24-
— the scaffold tree, and the `metaobjects.config.ts` example. Nothing checks that they still
25-
match, so they drift silently when the CLI's scaffold changes. The authoritative source is
26-
the monorepo's `server/typescript/packages/cli/src/commands/init.ts` (the
27-
`SCAFFOLDED_GENERATOR_NAMES`, `OWNED_GENERATORS_DIR`, `buildMetaobjectsConfigBody`, and
28-
`DB_STUB_*` constants). Read it before changing those blocks; don't work from memory.
29-
30-
The page also carries a doctrinal claim worth keeping intact: the generators under
31-
`codegen/generators/` are copied into the adopter's repo for them to **own and edit**, and
32-
`meta gen` runs those local copies rather than the packaged ones. `www/video/getting-started.vtt`
33-
states the same thing — if a page edit contradicts it, the page is the thing that is wrong.
23+
Several code blocks on `www/getting-started.html` reproduce real CLI output: the scaffold
24+
tree, `meta init`'s closing line, the `meta gen --list --probe` and `meta eject` excerpts, the
25+
wired `metaobjects.config.ts`, the `meta gen` and `meta migrate` runs, and the curl calls.
26+
Nothing checks that they still match, so they drift silently when the CLI changes. The
27+
scaffold's authoritative source is the monorepo's
28+
`server/typescript/packages/cli/src/commands/init.ts` (`OWNED_GENERATORS_DIR`,
29+
`buildMetaobjectsConfigBody`, `SCAFFOLD_SUMMARY`, `NEXT_STEPS`). For the rest, **run the flow
30+
end to end against the published CLI in a scratch project OUTSIDE `/tmp`** and copy from what
31+
it prints. A stale `/tmp/node_modules` shadows packages the project did not install, so a run
32+
there can pass on a page that fails for a newcomer. Don't work from memory or the CHANGELOG.
33+
34+
Since 1.0.4 (ADR-0034 Amendment 2) `meta init` scaffolds `codegen/generators/` EMPTY with
35+
`generators: []`, no dependencies, and no `src/db.ts`. The page's doctrinal claim is that the
36+
generators an adopter CHOOSES (`meta gen --list --probe`, then `meta eject <names>`) are copied
37+
into their repo to **own and edit**, and `meta gen` runs those local copies rather than the
38+
packaged ones. `www/video/getting-started.vtt` captions a recording made before 1.0.4, when
39+
`init` still scaffolded the generators; `www/videos.html` says so beside it.
3440

3541
## Editing the `pre.gs-code` blocks
3642

3743
`www/getting-started.html` hand-writes its syntax highlighting with `<span class="c">`
38-
(comment), `s` (string), `k` (keyword), `n` (the `NEW` marker). An unclosed span or a
44+
(comment), `s` (string), `k` (keyword), `n` (the `new` status in `meta gen` output). An unclosed span or a
3945
misaligned comment column does not show up in a diff review — render the page and look at
4046
the block before calling an edit done. In the scaffold tree, the `#` comments all sit at
4147
visible column 33.

0 commit comments

Comments
 (0)