docs(quickstart): re-transcribe both boot samples against CLI 17.2.0 - #248
Merged
os-project-manager merged 1 commit intoAug 29, 2026
Merged
Conversation
Re-boots both documented paths on `@objectstack/cli` 17.2.0 and re-diffs each raw capture against its published block. Both published blocks still reproduce verbatim, so neither sample was rewritten. What changed is what 17.2.0 adds around them: - Path B's compile summary gained `UI:`, `Logic:` and `Security:` counters beside the `Data:` line already published. Published rather than declared, because the page's existing rule (set by Path A's `Mode/Driver/Tenancy/ Plugins` group) is to keep a summary group whole and omit only its long continuation line. - Path B's run gained a `Boot diagnostics` block, now named as omitted. - Path A's `No objectstack.config.ts or artifact found` line was present at 17.1.0 too and was never declared. Named now. Both version pins move 17.1.0 -> 17.2.0, and Path B's compile timing is the one from this round's capture. Part of #141 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016TUrhcggSFrYctvp5dsV1A
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 #141
Both documented paths re-booted on
@objectstack/cli17.2.0 (published 2026-08-23T07:01:18.191Z), captured separately under a pty, and each raw capture diffed against its published block. Path B's banner was not assembled from Path A's — they are two independent captures, and the diffs below are machine-produced, not reasoned.Headline: neither published block was stale
Every line both blocks publish still appears verbatim in a 17.2.0 boot. The mechanical check, run against the edited file:
So this is not a rewrite. What changed is what 17.2.0 prints around the published blocks, plus two pins.
Item-by-item, against the card's re-arm record
1. Both blocks re-transcribed (independent captures).
Path A boots identically at 17.2.0. Two pristine boots (home moved aside between them) were byte-identical apart from timestamps inside the omitted diagnostics block.
Config:is still absent from Path A — still suppressed, not removed.Path B reproduces too, except the compile timing, which is per-machine; it now carries this round's measured value.
2. Port behaviour re-verified — no drift. Alone, the dev server binds 3000. With
os startalready holding 3000:Byte-exact against the sentence the page publishes. Controlled both ways: the literal appears exactly once in the contended capture and zero times in the uncontended one, so the match is a live probe rather than a string that is always present. The page and
reference/cli.mdxagree on 3000; my measurement agrees with both.3. Both pins 17.1.0 to 17.2.0 (Path A and Path B declaration sentences). Path B's scaffold pins caret ranges, and both the creating CLI and the resolved runtime were 17.2.0.
4. Declaration sentences re-checked by diffing, not by reasoning. Three omissions were unnamed. To tell genuine 17.2.0 drift from pre-existing under-declaration, I booted both paths again on 17.1.0 as a version control — for Path B that meant a second scaffold with dependencies pinned to exact
17.1.0, since the caret ranges otherwise resolve to 17.2.0.UI: 0 Apps/Logic: 0 Flows/Security: 0 Positions 0 PermissionsBoot diagnosticsblockNo objectstack.config.ts or artifact foundThe one judgment call, flagged for review
The three new Path B counters are published rather than declared, while the new diagnostics block is declared. The rule I applied is the one Path A already sets: keep a summary group whole, omit only its long continuation line. Path A publishes all four of
Mode/Driver/Tenancy/Pluginsand omits the plugin-name continuation; Path B was publishing one member of a four-line counter group, which leaves a hole in the middle of a summary a reader sees intact on their own screen.The alternative — leave the block at one counter and add "three further compile-summary counters" to the declaration sentence — is equally correct and three lines shorter. Happy to switch if you prefer the tighter block.
Verification
Gate union re-run on the final commit
ba72d38, tree clean against it. Exit codes captured before any pipe; verdicts are each gate's own printed line.pnpm turbo run build test type-check --force --continueTasks: 3 successful, 3 total(lock VERDICTcommand-exit 0)check-locale-surface.mjscheck-node-floor.mjscheck-translations.mjscheck-translation-ownership.mjs --actor ... --files ...check-translation-output.mjs --self-testcheck-translation-output.mjs --files ...Heavy runs went through the shared verify lock. Every server started was killed by explicit PID resolved through
/proc, never by name — siblings were running in this container — and ports 3000/3001 were confirmed free after teardown.Scope
content/docs/quickstart.mdxonly.reference/cli.mdxuntouched. No locale sibling touched — all seven remain the translation pass's input. Item 3 of the original card stays discharged: 0 hits for aWarningblockquote and 0 forsecurity-owd-unset, with a control confirming another> **blockquote is still present, so the zero is absence and not a dead probe. No new caveat appeared in 17.2.0's output.The seeded dev credential and its dev-only caveat are byte-identical at 17.1.0, at 17.2.0, and on the page. Transcribed faithfully, not altered; the standing exposure question is unchanged by this PR.
Generated by Claude Code