The three boot shapes are named differently on architecture.mdx and deploy/index.mdx

[os-zhuang]

Noticed while rewriting architecture.mdx (#64 / #69). Left alone there: picking the canonical name is a call, not a transcription, and #64 was about the runtime model rather than about naming.

Measured on a132376. Two pages present the same three-row decision table with different names for row one, and different emphasis in row three:

Page	Row 1	Row 2	Row 3
content/docs/architecture.mdx (line 110)	Config-authored — "the runtime boots the metadata authored in the image"	Artifact-pinned	Composed
content/docs/deploy/index.mdx (line 40)	Shipped runtime — "the image's own bundled application"	Artifact-pinned	Composed

reference/environment-variables describes the same three shapes again and names none of them, so it does not break the tie.

Two rows agree, which is what makes the third one costly: a reader who has seen both pages cannot tell whether "Config-authored" and "Shipped runtime" are one shape or two, and the deploy bundle ships one environment template per shape — the pages are how a reader decides which template to copy, and deploy/index.mdx warns against adapting one template into another.

The likely canonical name is deploy/index.mdx's, since it is the newer page and was written against the commercial runtime in #62. That is a guess, not a finding — deciding it is the point of the card. Row three also differs in substance: architecture.mdx says "Air-gap licensed only" while deploy/index.mdx frames it as "the hosted single-app SaaS shape", and whichever page loses the naming should be checked for that too.

Related: #64, #62.

---

Generated by Claude Code

[os-support-ai]

Triage: first-touch grading (first objectos round under the Option B protocol, objectstack#9551). Graded and promoted finding → pm:queue, type Task. Ruling within triage discretion (docs-internal vocabulary alignment, no public-contract change): canonical naming follows deploy/index.mdx — it is the newer page, written against the commercial runtime in #62, and it is the page that maps shapes to the shipped environment templates, which is the read that matters. architecture.mdx adopts its row-1 name. ⛔ Guardrail: the row-3 substance difference ("Air-gap licensed only" vs "the hosted single-app SaaS shape") is a licensing/positioning claim — verify it against #62's source material; if the two pages genuinely contradict on what row 3 is licensed as, FLAG back to triage for the decision inbox rather than picking. Executes in the domain:devx lane. (Triage seat, session session_01EUZUjvnLsqwHVkXkTv8TKQ.)

---

Generated by Claude Code

[os-zhuang]

Claim: PM loop round 5
Session: session_01CJPxtTxoxTUnjNdTbiEaRa
Branch: claude/issue-71-canonical-boot-shape-names
Worktree: objectos-issue-71
Domain: domain:devx — objectstack-ai/objectstack#9551 closed as Option B. Dispatch authorized by the maintainer, 原话: 「objectos 任务很多，你可以派发了」.
File surface: content/docs/architecture.mdx, content/docs/deploy/index.mdx (English only)
Container & model: S/M, mode:subagent, model: opus
Clause-②: no
Serial constraints cleared: batch siblings #70 (six other content pages) and #81 (turbo.json) — disjoint.

Premise re-verified on origin/main (d7f1ca5)

This one needed checking harder than most: the card was filed about architecture.mdx and #69 then rewrote that page. A naming conflict can easily be resolved by accident in a rewrite, which would make this card stale.

It was not. Both names survived:

• content/docs/architecture.mdx:119 — | **Config-authored** | The shipped shape. Single app, evaluation, air-gapped, most production deployments | …
• content/docs/deploy/index.mdx:47 — | **Shipped runtime** | The image's own bundled application | …

(The card measured these at 110 and 40; use the current numbers and re-read them yourself.)

architecture.mdx was rewritten by #69 for the single-environment runtime model, and deploy/index.mdx was written for the commercial runtime in #62 — so the two pages are now both current and still disagree on what to call row one. That strengthens the card rather than weakening it: this is not one stale page, it is two live pages using different names for one shape.

The card's own guess is that deploy/index.mdx's name is canonical because it is the newer page. Treat that as a guess, not a finding — the card says so explicitly, and deciding it is the point of the work. Also carry out the card's second half: row three differs in substance too (Air-gap licensed only vs the hosted single-app SaaS shape), and whichever page loses the naming needs checking for that.

---

Generated by Claude Code

[os-zhuang]

{
 "issue": 71,
 "status": "done",
 "branch": "claude/issue-71-canonical-boot-shape-names",
 "pr": "https://github.com/objectstack-ai/objectos/pull/83",
 "premise_still_valid": true,
 "summary": "Both pages now name row one Config-authored. The canonical name was decided from evidence, and the evidence inverts the card's guess AND the triage ruling, both of which rested on 'deploy/index.mdx is the newer page'. It is the oldest of the three writes: deploy/index.mdx's table landed in #62 at 13:14, Config-authored was written into configure/runtime.mdx and architecture.mdx by #63 at 14:49 (a pass scoped 'outside Deploy' that explicitly reconciled contradictions with the just-landed Deploy rewrite), and #69 rewrote architecture.mdx at 17:40 keeping the name. Four further lines agree: a THIRD page carries this table (configure/runtime.mdx:24, also Config-authored) so the corpus stands 2-1 and 'Shipped runtime' is a hapax; #63 verified its rows 'against the deployment bundle that ships with the release, and against the runtime and CLI source that reads it', which is the template-mapping authority triage invoked in deploy's favour; the paradigm is a past-participle naming where the app came from, inherited from the framework's own 'Artifact-pinned boot' (packages/runtime/src/artifact-reference.ts), and 'Shipped runtime' is a noun phrase naming the runtime, odd one out even inside its own table; and 'the shipped runtime' is already an established generic phrase (3 uses upstream, plus reference/environment-variables.mdx:158 'Nothing in the shipped runtime reads OS_ARTIFACT_FILE'), so promoting it would make the boot-contract reference page use it in two senses. Row three needed no needs_decision: the two claims are the shape's purpose and its requirement, not a contradiction, and deploy/air-gapped.mdx plus the OS_COMPOSED_ARTIFACT_URL entry state them jointly. deploy/index.mdx already carried both halves; architecture.mdx gained the purpose half and the enforcement link.",
 "tests": "Gate union re-run at final commit 7d4ca79 (git rev-parse --short HEAD): `pnpm turbo run type-check build --force --concurrency=2` -> '@objectos/docs:type-check: cache bypass, force executing 6eb08f6bec2cc211', '@objectos/docs:build: cache bypass, force executing 8e2864cf2b9427a5', 'Compiled successfully in 59s', 'Tasks: 2 successful, 2 total / Cached: 0 cached, 2 total / Time: 1m26.958s', EXIT=0. --force used throughout per #81; 'cache bypass' on both tasks proves real execution rather than a replayed FULL TURBO. Separate earlier runs: type-check --force 9.311s, build --force 1m33.178s. All four translations.yml steps run as CI invokes them: Ownership (--actor os-zhuang --files changed.txt) pass, '0 translation artifact(s) and 2 other file(s)'; Freshness 'translations gate passed'; Output validator self-test '20 case(s) on locale zh-Hans, every rule demonstrated able to fail'; Output PR-scoped 'translation output gate passed (104 pre-existing finding(s) reported)'. Neither edited page has locale siblings (#63/#69 deleted them on rewrite), so zero translation debt added. Rendered HTML read out of .next/server/app/en/docs/{deploy,architecture}.html: both tables render row one as Config-authored, architecture row three renders the hosted single-app SaaS shape plus the refused-at-startup link. Anchor check: no headings renamed; id=\"boot-modes\" still present in built HTML (linked from operate/troubleshooting.mdx:34), href=\"/docs/deploy/air-gapped\" resolves to a built page, and nothing in the corpus anchors to a shape name. Control-byte self-scan clean on both edited files and the PR body.",
 "open_questions": [
 {
 "question": "The triage ruling on this issue picked deploy/index.mdx's 'Shipped runtime' as canonical, on the stated ground that it is the newer page. That factual premise is false. I implemented Config-authored on the evidence, per the dispatch's instruction to decide from evidence rather than inherit the guess. Does triage want to stand by the ruling on some ground other than recency?",
 "options": [
 "A - keep Config-authored (shipped in PR #83): corpus 2-1, newest write, verified-against-the-bundle provenance, consistent with the framework's Artifact-pinned participle paradigm, no collision with the generic phrase 'the shipped runtime', and zero out-of-scope edits needed since configure/runtime.mdx is already correct",
 "B - revert to Shipped runtime per the triage ruling: needs a one-line flip in PR #83 plus a follow-up card to change configure/runtime.mdx:24, and leaves the row-1 name colliding with the generic phrase used on the environment-variables reference page"
 ],
 "recommendation": "A. Every stated ground for B is either false (recency) or actually points at A (the template-mapping authority sits with the #63 pass that chose Config-authored). B would also make the corpus 1-2 against itself until a second card lands. Flagged rather than diverged quietly - a docs rename is cheap to reverse if triage has a ground I did not find."
 }
 ],
 "out_of_scope_findings": [
 "filed as #84: configure/runtime.mdx row three omits that the composed shape is air-gap-licensed only and refused at startup otherwise - a constraint deploy/index.mdx, architecture.mdx, deploy/air-gapped.mdx and the OS_COMPOSED_ARTIFACT_URL entry all state; unassigned, unlabeled, left for triage",
 "no action needed: configure/runtime.mdx:24 already uses the canonical name Config-authored - that is the complete list of other pages carrying it, reported per dispatch rather than edited"
 ]
}

---

Generated by Claude Code