docs: re-derive the three scaffolded-project transcripts after the description drop (#9342) - #9429
Merged
os-steve merged 1 commit intoAug 18, 2026
Conversation
…scription drop (#9342) #9263 makes `create-objectstack` drop the blank template's own `manifest.description` at scaffold time, so no scaffolded project prints "Minimal ObjectStack environment — a clean slate for building." any more. Three pages still quoted it inside a scaffolded-project transcript. Re-derived from real runs against the CLI built at origin/main (b2d9e04), not hand-edited: * `os validate`, Support Desk — scaffolded `support-desk` from the `blank` template and applied build-with-claude-code.mdx's own listings (ticket object, resolve action, ticket views, Support app). Confirms #9152's work still reconstructs: the page's listings alone reproduce `2 Objects 6 Fields` / `1 Apps 1 Views 1 Actions` / `3 plugins`, and `Running author-time rules (41)`. * `os info`, my-app — scaffolded `my-app` from the same template with the ticket object, one view and one action (no app), reproducing `1 Views 1 Actions` and both object rows verbatim. Both printers guard on presence (`validate.ts:294`, `info.ts:64`), so the row does not become empty or `undefined` — it disappears entirely, and the surrounding rows are byte-identical to the run. Verified mechanically: each edited block now matches its run line for line, modulo the config path and the timings, which are machine identity and are left as #9151/#9262 left them. `cli.mdx`'s manifest-configuration example still shows a `description:` key. That is a hand-authored config, not a scaffolded-project transcript, and `description` remains an authorable manifest field — only the scaffolder's carry-over went away. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XqDQYVU5smx29ts9pAErja
This was referenced Aug 18, 2026
os-steve
marked this pull request as ready for review
August 18, 2026 01:10
This was referenced Aug 18, 2026
os-steve
deleted the
claude/issue-9342-scaffold-description-transcripts
branch
August 18, 2026 01:23
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #9342
#9263 (merged via PR #9335) makes
create-objectstackdrop the blank template's ownmanifest.descriptionat scaffold time. Three docs pages still quoted that line inside a scaffolded-project transcript, so all three had gone stale together.Both printers guard on presence (
packages/cli/src/commands/validate.ts:294,packages/cli/src/commands/info.ts:64), so the row does not become empty orundefined— it disappears entirely. Confirmed in my own runs, not inherited.Re-derived from real runs — not hand-edited
CLI and scaffolder built at
origin/main(b2d9e04d1); both fixtures scaffolded from theblanktemplate with the builtcreate-objectstack.Fixture A — Support Desk (
os validate). Scaffoldedsupport-desk, then appliedbuild-with-claude-code.mdx's own listings: the ticket object, the resolve action, the ticket views and the Support app, wired through thesrc/objects/index.tsbarrel and theactions:/views:/apps:arrays exactly as the page's prose describes.Fixture B — my-app (
os info). A different command surface, which is why this page could not be fixed from #9263's one-page framing. Scaffoldedmy-app, added the ticket object, one view and one action (no app), reproducing1 Views 1 Actionsand both object rows verbatim.Verified mechanically, not by eye. Each edited block was diffed line by line against its run after normalising the config path and the timings. All three match; the only residual difference is
Loaded in 59msvs88msoncli.mdx. Timings and the sanitised/path/to/...are machine identity, not fixture identity, and are left as #9151 / #9262 left them.#9152's work does reconstruct
The Support Desk fixture was built only from
build-with-claude-code.mdx's own listings, and it reproduces every documented row —2 Objects 6 Fields,1 Apps 1 Views 1 Actions,3 plugins, andRunning author-time rules (41). The self-reconstructibility PR #9262 established is intact; no regression to report there.Scope
Three line deletions, nothing else. Deliberately untouched:
cli.mdx's Data migrations section — its row is docs:os migrate duplicatesneeds its row in the data-migration table, and the #8686 backfill guidance owes it the cross-reference the ruling asked for #9382's work, already verified on that card.cli.mdx'sos compileblock — re-derived by docs: two sample transcripts still print the pre-#4409 per-concern step list that the author-time rule registry collapsed into one line #9092 / PR docs: re-derive the os compile / os validate transcripts from real runs #9151.cli.mdx:1461's manifest-configuration example, which still shows adescription:key. That is a hand-authored config, not a scaffolded-project transcript, anddescriptionremains an authorable manifest field — only the scaffolder's carry-over went away.The card's own acceptance check now holds:
git grep -n "Minimal ObjectStack environment" -- content/docs/returns no hits.Gates
Union re-derived from the actual changed paths with
node scripts/pm/dispatch-gates.mjs, run after the final commit, ate92291332— all green:check:nul-bytes·check:docs-audit-scope·check:docs-redirects·check:role-word·spec check:empty-state·spec check:liveness·spec check:strictness-ledger·spec check:variant-docs·check-cross-package-test-inputsPlus a control-byte self-scan over the three changed files (no hits).
Docs-only, releases nothing —
skip-changeset.Generated by Claude Code