Repository navigation
docs: cli.mdx os deploy flag table and § To a self-hosted runtime omit --confirm-upgrade and the "installed but not loaded" exit #31339
Description
domain:skills#3 · huangyiirene · session_01J8VVAj7CvjkGXvgXzd6RZ7
What is wrong
Read on main 604a2b3b9. content/docs/deployment/cli.mdx lags os deploy on a self-hosted runtime target:
- §
os deployflag table (≈L3237-L3244) has no--confirm-upgraderow, althoughos deploydeclares it beside--confirm-access-upgrade(packages/cli/src/commands/deploy.tsL140-L155, used ≈L339). - § To a self-hosted runtime, step 3 names only
--confirm-access-upgradeas the retry after an install refusal; the upgrade refusal's--confirm-upgrade <token>is missing. - § To a self-hosted runtime, step 4 leaves out the exit 1 for a package that is installed but not loaded (live after a restart), deploy.ts ≈L346-L352.
The platform skill (skills/objectstack-platform/references/operations.md) teaches all three after PR #31335 (#31235). Its dev listed these under other sites, and its contract review (6716322584) confirmed them. Eval 21 of skills/objectstack-platform/evals/ names only --confirm-access-upgrade. That is still true, but it is narrower than the skill.
Suggested shape
Add the flag row and the two missing cases to the page, measured from deploy.ts. Docs-only, no changeset beyond what the docs lane requires.
Activity
objectstack-fleet commentedon Nov 8, 2026
triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U
Path: none
Triage: audit · p3 ·
domain:devx· 2026-11-08T02:53Z⛔ Not a claim.
content/docs/deployment/cli.mdxlagsos deployon a self-hosted runtime target:--confirm-upgraderow in the flag table;--confirm-access-upgrade;domain:devx(content/docs).findingremoved,pm:queue.Generated by Claude Code
objectstack-fleet commentedon Nov 8, 2026
domain:devx#3 · os-project-manager · session_01FEkQ5njkh3xbcDN6EtSfw7
Claim: PM loop round 1
Session:
session_01FEkQ5njkh3xbcDN6EtSfw7Account:
os-project-managerBranch:
claude/project-thread-ayf60o(a project card thread,session_01FEkQ5kuCuTK9UtGmuBcaPR; the thread can push only its harness branch, a measured platform exception toclaude/issue-<n>-<slug>)Worktree:
objectstack-issue-31339Domain:
domain:devxSeat:
domain:devx#3File surface:
content/docs/deployment/cli.mdx; eval 21 inskills/objectstack-platform/evals/only if PR #31335 has merged by start.Container & model:
S,mode:thread,model: default — read dispatch-gates --tier on the real diff,effort: mediumClause-②: no
Metadata-protocol: none
Responsibility: n/a — docs text, no user door
Thread-read: 6716396816
Premise: holds on main
dc7f5c4b4. Theos deployflag table has no--confirm-upgraderow.Ruling-ref: p3 by triage 6716396816; 「p1 p2 处理完了，就可以处理 p3」 (maintainer, 2026-10-26T10:29Z).
Order:
pm-orders/devx/order-31339.md(project files), handed to the card thread in its opening message.objectstack-fleet commentedon Nov 8, 2026
domain:devx#3 · os-project-manager · session_01FEkQ5kuCuTK9UtGmuBcaPR
os-dev-report
{
"issue": 31339,
"status": "done",
"branch": "claude/project-thread-ayf60o",
"pr": "#31355",
"session": "session_01FEkQ5kuCuTK9UtGmuBcaPR",
"premise_still_valid": true,
"summary": "content/docs/deployment/cli.mdx, os deploy section only: the flag table gains a --confirm-upgrade row (self-hosted target only, schema findings, refused on ObjectOS Cloud); step 3 of To a self-hosted runtime names both confirmation flags as passed through, adds the schema upgrade refusal, and names each refusal retry (os deploy --confirm-access-upgrade TOKEN / os deploy --confirm-upgrade TOKEN); step 4 adds exit 1 for a package the runtime recorded but its running kernel could not load (live after a restart). Every fact read from packages/cli/src/commands/deploy.ts on main 4363945 (L149-L154, L169-L177, L321, L336-L340, L346-L353) and the retry lines in package/install.ts L468/L489. Eval 21 untouched: PR #31335 read open, merged false, at start.",
"tests": "None owed: docs text only, no behaviour change, so no test and no ablation.",
"gates": "head ef2c181. dispatch-gates --commands --repo objectstack-ai/objectstack: 44 families; all 44 run, exit 0 each, captured before any pipe. --ran: 44 derived families accounted for, 44 run, 0 NOT-MEASURED, exit 0. check:skill-examples first answered exit 3 (PREREQUISITE NOT MET, client-react dist unbuilt); after os-verify-lock build of @objectstack/client-react... (VERDICT command-exit 0) it answered exit 0 (285 prose examples). Prior build @objectstack/spec... + @objectstack/lint... VERDICT command-exit 0. check-governed-merges --branch HEAD exit 0: NOT governed. dispatch-gates --tier: no path-derived mandate. pnpm lint: no package touched, nothing scoped. CI families (Build Docs, Plan Test Core shards, type-check lanes, lint farm): PR #31355 check-runs in_progress at report time, not re-run locally. Gate record: pm-orders/devx/31339-gates-ran.txt.",
"line_budget": "+10 / -4, 1 file; under the 3000 human-merge threshold",
"files_changed": [
"content/docs/deployment/cli.mdx"
],
"changeset": "skip-changeset (content/docs publishes in no package), sent with pr_create, read back on the PR",
"deviations": "Labels: pr_create carried only skip-changeset (the one label the order names); the card documentation label was not copied onto the PR. No assignees sent, per the order (os-dev.md rule 2 still reads pr_create with assignees; the order wins for this lane and the conflict is named here).",
"dogfood_battery": "n/a — no ! in the PR title and no (narrowing) arm",
"mcp_calls": "0 — no MCP GitHub calls; reads via gh api REST",
"api_writes": "2 — relay pr_create (fleet-write run 42444470531, PR #31355, read-back identical), relay comment on #31339 (this report) via post-stamped; git push not counted",
"open_questions": [],
"security_findings": "none",
"out_of_scope_findings": [
"carrier: PR #31335 (#31235) · eval 21 of skills/objectstack-platform/evals names only --confirm-access-upgrade; left for a follow-up once #31335 merges, per the order · noted, not filed"
]
}
Generated by Claude Code
objectstack-fleet commentedon Nov 8, 2026
domain:devx#3 · os-project-manager · session_01FEkQ5njkh3xbcDN6EtSfw7
Landed 2026-11-08T04:39Z · PR #31355 merged through the merge queue at 2026-11-08T04:35Z, as
da7fce5903a6d0237eb1b3c3ba675c228a13ea6d.merged: true, merge commitda7fce5903, head reviewedef2c1811a4(ACCEPT 6716940067)Fixes #31339State change:
pm:dispatchedremoved. Left out on purpose: eval 21 inskills/objectstack-platform/evals/. It rides PR #31335 (#31235), which was still open when this card started.