Repository navigation
Docs and skill still type the MCP connect line by hand and describe os deploy as cloud-only #31235
Description
domain:skills#3 · huangyiirene · session_01J8VVAj7CvjkGXvgXzd6RZ7
What is wrong
PR #31225 (#31143) teaches os environments use-runtime (a self-hosted runtime as the os deploy target) and os mcp connect. Its contract review found these sites outside that card's claim. They still teach the old path only. Read on main:
content/docs/ai/agents.mdxL99, the per-client table, Claude Code row. It gives a hand-typedclaude mcp add --transport http objectstack https://<your-deployment>/api/v1/mcp.os mcp connect(packages/cli/src/commands/mcp/connect.ts) now resolves the environment's MCP URL and runs that line itself, andos mcp connect --url <base>registers a self-hosted or local server asobjectstack. The row could name the command first and keep the hand-typed line as the fallback.content/docs/getting-started/build-with-claude-code.mdxL477 and L480 (the two interactiveclaude mcp addlines). Same as above. L502, the headless--header "x-api-key: …"form, is not covered byos mcp connect(it stores no token), so it stays as it is.skills/objectstack-platform/references/operations.md, the "os deployexit 1" paragraph (≈L100 after docs(skills): teach os environments use-runtime and os mcp connect #31225). Every refusal it lists is the cloud path's (os cloud login,--env, the cloud build,--wait-timeout). With a use-runtime target, the exit-1 cases are the dry run and install refusals thatcontent/docs/deployment/cli.mdx§ To a self-hosted runtime lists. Note that this file's ratchet row sits at 0 headroom after docs(skills): teach os environments use-runtime and os mcp connect #31225, so any growth needs a same-file deletion or a ruling.content/docs/deployment/cli.mdx§os dev(≈L168-171): "when you are not logged in to ObjectOS Cloud the same key runsos cloud loginfirst". That is true for a cloud target only. With a use-runtime target, thedkey deploys to the runtime and asks for no cloud login (packages/cli/src/utils/dev-deploy-key.ts). The same page's § To a self-hosted runtime already says so.
Historical pages are left alone: the v16 release notes (L76, L468) and blog/the-ontology-is-the-software.mdx L282.
Evidence
Contract review on PR #31225, item 9 and nit N8.
Suggested shape
One docs and skill card. Sites 1, 2 and 4 are docs pages. Site 3 is the platform skill, which owes a '@objectstack/skills': patch changeset and is priced by the token ratchet.
Activity
objectstack-fleet commentedon Nov 7, 2026
triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U
Path: none
Triage: audit · p2 ·
domain:skills· 2026-11-07T19:54Z⛔ Not a claim.
os environments use-runtimeand the self-hostedos deploytarget (follow-up owed by #30888 / PR #31137) #31143) replaced:os mcp connectand anos environments use-runtimedeploy target. Three are docs pages (content/docs/ai/agents.mdx,getting-started/build-with-claude-code.mdx,deployment/cli.mdx§os dev). One is the platform skill (skills/objectstack-platform/references/operations.md, theos deployexit-1 paragraph). The headless--headerline stays, and so do the historical pages.domain:skills, because it is one card that carries the skill changeset and continues docs + skill: teachos environments use-runtimeand the self-hostedos deploytarget (follow-up owed by #30888 / PR #31137) #31143. The three docs pages ride the same PR.findingremoved,pm:queue.Generated by Claude Code
objectstack-fleet commentedon Nov 8, 2026
domain:skills#3 · huangyiirene · session_01J8VVAj7CvjkGXvgXzd6RZ7
Claim: PM loop round 28 · 2026-11-08T02:11Z
Session:
session_01J8VVAj7CvjkGXvgXzd6RZ7Account:
huangyiireneBranch:
claude/project-thread-g0jint(the card thread's designated branch; dev sessionsession_01J8VVAntMdbEQxYFD6N2ePk)Worktree:
objectstack-issue-31235Domain:
domain:skillsSeat:
domain:skills#3File surface:
content/docs/ai/agents.mdx(the Claude Code row);content/docs/getting-started/build-with-claude-code.mdx(the two interactiveclaude mcp addlines);content/docs/deployment/cli.mdx(§os dev, thedkey's cloud login sentence);skills/objectstack-platform/references/operations.md(theos deployexit-1 paragraph, and same-file deletions that pay its budget);skills/objectstack-platform/evals/*.json(only cases that reward the old claim);.changeset/*.md;scripts/check-skills-token-ratchet.mjsonly by standing ruling 6513306068 for a measured remainder, and only after the seat rules on the cuts (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(docs and the skill lag theos mcp connectanduse-runtimepaths PR #31225 shipped)Thread-read: 6712265901
Premise: holds on
main604a2b3b9: agents.mdx L99 and build-with-claude-code.mdx L477/L480 give only the hand-typedclaude mcp add; deployment/cli.mdx L169-L172 saysdrunsos cloud loginwhen logged out, with no use-runtime exception; operations.md L100 lists only cloud-path exit-1 cases.os mcp connect(packages/cli/src/commands/mcp/connect.ts) and the runtime branch of dev-deploy-key.ts are onmain.Serial constraints: none open. The seat runs serially (one card) by the maintainer's word of 2026-11-08.
Changeset
'@objectstack/skills': patch.Fixes #31235. Tier read bycheck-governed-mergesat the PR.objectstack-fleet commentedon Nov 8, 2026
domain:skills#3 · huangyiirene · session_01J8VVAj7CvjkGXvgXzd6RZ7
ACCEPT → PR #31335 comment 6716459996, head
a082087b. Tier H:pm:awaiting-merge, approval requested fromos-zhuangandhotlong. Contract review 6716322584 PASS with no must-fix. Ratchet: the operations.md row only, 3340 → 3375, by standing ruling 6513306068 after two same-file deletions. Should-fix items filed as #31338 and #31339.