Repository navigation
docs + skill: teach os environments use-runtime and the self-hosted os deploy target (follow-up owed by #30888 / PR #31137) #31143
Description
domain:server#4 · marchtian · session_017ihL2dLQEXWGsE2SZ3Qn5F
Filing gate: ① a named location — a follow-up owed by landed work (#30888, PR #31137). The dev reported it under out-of-scope findings; the claim's file surface did not include docs or skills/**. ⛔ Not a claim.
维护者速读
#30888 新增了 os environments use-runtime 地址 --token 密钥：记住一个私有部署的运行时（Docker 社区版或企业版），之后 os deploy 和 os dev 里的 d 键直接部署到它，os package install 不写 -u/-t 时也用它。文档和平台技能还没写这些，开发者和 AI 助手读不到，只能继续手敲地址和令牌。
Where
content/docs/deployment/cli.mdx— theos environmentsandos deploysections (both already nameos environments switch).content/docs/deployment/publish-and-preview.mdx— the deploy loop page names only the cloud target.skills/objectstack-platform/references/operations.md— the deploy/publish operations reference (and its evals inskills/objectstack-platform/evals/config-plugins-ops.jsonif a case covers the deploy target).
Expected
- Document the command (
<url> --token <key>,--no-verify,--forget), where it is stored (~/.objectstack/cloud.json, 0600, its own record; cloud login/logout keep it), thatos environments switchmakes the cloud the target again, and the self-hostedos deploysequence (build → dry-run plan → inline install →hotLoaded),--confirm-access-upgrade, and theos package installfallback. - Every sentence is checked against the merged code (
packages/cli/src/commands/environments/use-runtime.ts,packages/cli/src/commands/deploy.ts,packages/cli/src/utils/runtime-target.ts). - Reader: the lane that owns docs and
skills/**after triage; it runs once PR feat(cli): os deploy and the os dev d key deploy to a self-hosted runtime remembered by os environments use-runtime #31137 is merged.
Dedupe (2026-11-07, open and closed): "environments use-runtime" is:issue → 1 hit (#30888 itself); self-hosted deploy docs is:issue is:open → 10 hits, #26688 (deployment docs, developer half) is the nearest and does not cover this command; the rest are epics, QA runs and seat posts.
Suggested-grade: p3 · docs/skill drift for a new CLI command.
Activity
objectstack-fleet commentedon Nov 7, 2026
domain:server#4 · marchtian · session_017ihL2dLQEXWGsE2SZ3Qn5F
Scope added (same family, one closing card):
os mcp connectfrom #30889 / PR #31149 is also undocumented. Teach it incontent/docs/deployment/cli.mdx(and the MCP connect section wherever the docs give theclaude mcp addline) and inskills/objectstack-platform/references/operations.md: environment resolution asos deploy(--env, active, only),--urlfor a self-hosted or local server (namedobjectstack),--name,--print,--client claude-codeonly, and that no token is stored — the client runs the environment's OAuth. Check every sentence againstpackages/cli/src/commands/mcp/connect.tsonce PR #31149 is merged.objectstack-fleet commentedon Nov 7, 2026
triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U
Path: none
Triage: audit · p2 ·
domain:skills· 2026-11-07T14:59Z⛔ Not a claim.
os devdeploy key can target a self-hosted runtime (Docker Enterprise or Community) — remembered target and credential, install-local underneath, the same plan and Q3 refusal (epic cloud#3652, self-hosted parity) #30888) addedos environments use-runtime <url> --token, which remembers a self-hosted runtime soos deploy, thedkey inos devandos package installdeploy to it. Neither the docs (cli.mdx,publish-and-preview.mdx) nor the platform skill's operations reference teach it yet.domain:skills, with the twocontent/docspages folded in under a cross-seat note, so the skill and the docs say the same thing.pm:queue.Generated by Claude Code
objectstack-fleet commentedon Nov 7, 2026
domain:skills#3 · huangyiirene · session_01J8VVAj7CvjkGXvgXzd6RZ7
Claim: PM loop round 20 · 2026-11-07T18:04Z
Session:
session_01J8VVAj7CvjkGXvgXzd6RZ7Account:
huangyiireneBranch:
claude/project-thread-0r0grk(the card thread's designated branch; dev sessionsession_01J8VVAnBUEjCrpMSAcQv3Gp)Worktree:
objectstack-issue-31143Domain:
domain:skillsSeat:
domain:skills#3File surface:
skills/objectstack-platform/references/operations.md(deploy/publish and MCP rows, plus same-file deletions that pay its budget);skills/objectstack-platform/evals/config-plugins-ops.json(one case per command at most);content/docs/deployment/cli.mdxandcontent/docs/deployment/publish-and-preview.mdx(cross-seat note: folded in by the triage so the skill and the docs say the same thing); any page giving theclaude mcp addline, only after the seat confirms it by name;.changeset/*.md;scripts/check-skills-token-ratchet.mjsonly by standing ruling 6513306068 for a measured remainder (stop on breach)Container & model:
M,mode:thread, project-default model,effort: high.dispatch-gates --tieris run by the thread and reported; any mandate above this thread's is waived by the maintainer's standing order in this project (2026-11-03) and said so in the PR body; this seat runs the contract review.Clause-②: no
Metadata-protocol: none
Responsibility:
n/a — not a defect card(published teaching lags two merged CLI commands, #30888 / PR #31137 and #30889 / PR #31149)Thread-read: 6708594558
Premise: holds on
main66bf5b4a: both PRs are merged, and neither the platform skill nor the two docs pages teachos environments use-runtimeoros mcp connect. Every taught sentence is read fromuse-runtime.ts,deploy.ts,runtime-target.tsandmcp/connect.ts.Serial constraints: none open. The seat runs serially (one card) by the maintainer's word of 2026-11-07.
Changeset
'@objectstack/skills': patch.Fixes #31143. Tier read bycheck-governed-mergesat the PR.objectstack-fleet commentedon Nov 7, 2026
domain:skills#3 · huangyiirene · session_01J8VVAj7CvjkGXvgXzd6RZ7
Claim confirmations (mid-flight seat rulings, put on the record before review) · 2026-11-07T18:35Z
claude mcp addpage is confirmed by name:content/docs/ai/connect-mcp.mdx§ "Claude Code (one command)". The claim allowed this page "only after the seat confirms it by name". Other pages that type the line by hand (agents.mdx,build-with-claude-code.mdx, the v16 release notes) stay outside the claim. They are other sites.skills/objectstack-platform/references/operations.md. Seven same-file cuts were approved, each with its home named in the PR body. Cut 7 deletes the two rows that state false facts:os login/logout/whoami"against the ObjectStack cloud control plane" (login.ts: the runtime server, withos cloud loginfor the hosted registry) andos register"Register the local stack as a deployable target" (register.ts: creates an account). Their home iscli.mdx§ Authentication. Any remainder still owed after those cuts raises only that file's ratchet row, by the measured amount, under standing ruling 6513306068.objectstack-fleet commentedon Nov 7, 2026
domain:skills#3 · huangyiirene · session_01J8VVAj7CvjkGXvgXzd6RZ7
ACCEPT → PR #31225 comment 6711967220, head
4e0b6486. Tier H:pm:awaiting-merge, approval requested fromos-zhuangandhotlong. Confirmations 6711424579 (theconnect-mcp.mdxsection by name; seven same-file cuts, with the remainder +53 raised under ruling 6513306068). Follow-up: #31235 (hand-typedclaude mcp addlines in two docs pages, and two passages that describeos deployas cloud-only).