Skip to content

Commit 1120389

Browse files
docs(skills): os package install takes -u/--url and -t/--token in the platform skill's operations reference (#30821)
<!-- claude-projects-attribution: {"github_login":"os-elon-musk"} --> _Requested by **Elon** · [project thread](https://claude.ai/code/project/chan_01WedDzV26nniwxv7jC88B9D?thread=cmsg_01WedDzV26nniwxv7jC88B9D7vtFzrHkwUNVapRbBcUPii)_ domain:skills#1 · os-elon-musk · session_016WV4czuE7FD4NhcJptgwre Fixes #30772 Clause-②: no Metadata-protocol: none ## 维护者速读 - **改了什么**:`objectstack-platform` 技能运维参考页里 `os package install` 那一行,服务器参数从 `--runtime` 改成 `-u/--url`,凭据补上新的 `-t/--token`(环境变量 `OS_RUNTIME_TOKEN`),与 `--email/--password` 并列。 - **为什么改**:PR #30792(#30126 第 13 行,裁决 A)已把 `-r/--runtime` 改名为 `-u/--url` 且不留别名,并新增 `-t/--token`;技能还写旧参数,AI 照抄会被 CLI 当作未知参数拒绝。 - **风险与回滚**:只改技能文案一行;删掉该行里与下方引用块重复的「via its install-local endpoint」来付 token 额度(3119/3119,未抬上限)。回滚即撤这个 PR。 - **先看**:`skills/objectstack-platform/references/operations.md` 第 106 行。 - **两分钟验证**:对照 `packages/cli/src/commands/package/install.ts` 的 `static override flags`(`url` 为 `-u`、`OS_RUNTIME_URL`、默认 `http://localhost:3000`;`token` 为 `-t`、`OS_RUNTIME_TOKEN`),应与第 106 行一致。 - **需要你做的**:批准这个 Tier H PR(`skills/**` 需受管审批人 os-zhuang 或 hotlong 批准),之后席位落地。 ## What changes - `skills/objectstack-platform/references/operations.md` L106, the `os package install` row: the synopsis now reads `[--version │ -u/--url http://localhost:3000]` in place of `[--version │ --runtime http://localhost:3000]`, and the credential sentence names `-t/--token` beside `--email/--password`, with the env names `OS_RUNTIME_TOKEN` or `OS_RUNTIME_EMAIL`/`OS_RUNTIME_PASSWORD`. "Auths with the target runtime's session" becomes "Auths as a target runtime user", since a token is not a session sign-in. The row keeps its shape and still says the credential is not the cloud login. - Same row: "via its install-local endpoint" is removed. The blockquote under the table (L108-113) already says the cloud-connection plugins "expose the install-local endpoint that `os package install` targets". Removing the restatement pays for the token flag inside the ceiling. - `.changeset/30772-platform-skill-package-install-url.md`: `'@objectstack/skills': patch`. ## Why Ruling A on #30126 row 13 (record 6674432613). PR #30792 landed it on `main` at `2fbddd4c`, and this PR was merged with `origin/main` `7da99b79` before the gates. On that tree, `packages/cli/src/commands/package/install.ts` declares `url` (`char: 'u'`, `env: 'OS_RUNTIME_URL'`, default `http://localhost:3000`) and `token` (`char: 't'`, `env: 'OS_RUNTIME_TOKEN'`). There is no `runtime` flag left. `-v/--version` and `--email` / `--password` (`OS_RUNTIME_EMAIL` / `OS_RUNTIME_PASSWORD`) are unchanged, and a token together with `--email` / `--password` is refused. `content/docs/deployment/cli.mdx` (L3261-3279) says the same. ## Tests This PR changes skill prose only. No eval case names `os package install` (`git grep 'package install' skills/` hits only L106 and the blockquote's L112), so no eval was edited. No package code changed. After the change, `git grep -- '--runtime'` over `skills/**` and `.claude/**` returns nothing. ## Acceptance notes - **Readings (skills/\*\*).** `operations.md`: 199 → 199 lines, 12475 → 12474 bytes, 3119 → 3119 tokens (ceiling 3119, headroom 0 → 0; no ceiling raised). Bundle (sum of every `skills/*/SKILL.md`): unchanged at 4524 lines, since no SKILL.md is touched. - **PR #30764** (open, Tier H) also edits `operations.md`, in other hunks (L13, L42-58, a new section after L113, L192-193). This PR's single hunk is L106 and does not overlap them. Whichever lands second should re-run `check-skills-token-ratchet`. With #30764's −3 tokens, the merged file still fits. - The row does not say that `--runtime` was removed. The CLI refuses it as an unknown flag, and the `@objectstack/cli` changeset from #30792 carries the FROM → TO migration. ## Verification <details><summary>dispatch-gates on head b2d0f91: 43 derived, 43 run, all exit 0; pnpm lint exit 0</summary> `node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack` derived 43 commands for the two changed paths (merge base `7da99b79`). All 43 exited 0 on head `b2d0f914`, after a whole-tree `pnpm build --concurrency=2` under `os-verify-lock` (118 tasks, VERDICT command-exit 0), which clears the five dist-reading prerequisites (`check:doc-formula-expressions`, `check:dts-closure`, `check:dual-build-cjs-loads`, `check:lean-entry-closure`, `check:sourcemap-no-sources-content`). `check-skills-token-ratchet`: `operations.md` 3119 / 3119. `node scripts/pm/dispatch-gates.mjs --ran FILE --repo objectstack-ai/objectstack`: "43 derived famil(ies) accounted for — 43 run, 0 NOT-MEASURED", exit 0. `pnpm lint`: exit 0. ```text # head b2d0f91 node scripts/check-adr-0087-registration.mjs --base origin/main :: exit 0 node scripts/check-adr-0087-registration.mjs --self-test :: exit 0 node scripts/check-changeset-no-major.mjs --base origin/main :: exit 0 node scripts/check-closing-keyword-parity.mjs :: exit 0 node scripts/check-closing-keyword-parity.mjs --self-test :: exit 0 node scripts/check-comment-mask-corpus.mjs :: exit 0 node scripts/check-doc-route-spelling.mjs --advisory :: exit 0 node scripts/check-doc-route-spelling.mjs --self-test :: exit 0 node scripts/check-dts-emitted.mjs --self-test :: exit 0 node scripts/check-empty-changeset.mjs --base origin/main :: exit 0 node scripts/check-empty-changeset.mjs --self-test :: exit 0 node scripts/check-skills-token-ratchet.mjs :: exit 0 node scripts/check-skills-token-ratchet.mjs --self-test :: exit 0 node scripts/ci/assert-turbo-remote-cache.mjs --self-test :: exit 0 node scripts/ci/plan-test-core-shards.mjs --self-test :: exit 0 node scripts/ci/prune-turbo-cache.mjs --self-test :: exit 0 node scripts/pm/release-rehearsal-clone.mjs --self-test :: exit 0 node scripts/release-pending-publish.mjs --self-test :: exit 0 pnpm --filter @objectstack/lint run check:doc-formula-expressions :: exit 0 pnpm --filter @objectstack/spec run check:skill-refs :: exit 0 pnpm check:agent-test-spelling :: exit 0 pnpm check:changeset-gate-self-tests :: exit 0 pnpm check:ci-filter-parity :: exit 0 pnpm check:closed-ceremony-text :: exit 0 pnpm check:corpus-claim-drift :: exit 0 pnpm check:cross-package-test-inputs :: exit 0 pnpm check:doc-authoring :: exit 0 pnpm check:driver-memory-census :: exit 0 pnpm check:dts-closure :: exit 0 pnpm check:dual-build-cjs-loads :: exit 0 pnpm check:gitlink-declared :: exit 0 pnpm check:lean-entry-closure :: exit 0 pnpm check:nul-bytes :: exit 0 pnpm check:pm-governed-merges :: exit 0 pnpm check:pm-skill-id-lint :: exit 0 pnpm check:published-files :: exit 0 pnpm check:refd-timer-probe :: exit 0 pnpm check:role-word :: exit 0 pnpm check:skill-compatibility :: exit 0 pnpm check:skill-frame-sync :: exit 0 pnpm check:skill-identifier-liveness :: exit 0 pnpm check:sourcemap-no-sources-content :: exit 0 pnpm check:watch-hint-literal :: exit 0 pnpm lint :: exit 0 ``` </details> 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_016WV4czuE7FD4NhcJptgwre --- _Generated by [Claude Code](https://claude.ai/code/session_016WV4czuE7FD4NhcJptgwre)_ Co-authored-by: Claude <noreply@anthropic.com>
1 parent d003d3e commit 1120389

2 files changed

Lines changed: 9 additions & 1 deletion

File tree

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
'@objectstack/skills': patch
3+
---
4+
5+
docs(skills): objectstack-platform's `references/operations.md` spells `os package install`'s server flag `-u/--url` (in place of the removed `-r/--runtime`) and names the new `-t/--token` (env `OS_RUNTIME_TOKEN`) beside `--email/--password` as the target runtime's credential, matching the CLI
6+
7+
Clause-②: no
8+
Metadata-protocol: none

‎skills/objectstack-platform/references/operations.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ Port resolution is the same for `os dev` and `os start` (both spawn `os serve`):
102102
| `os register` | Register the local stack as a deployable target |
103103
| `os cloud login` / `logout` / `whoami` | Cloud auth subcommands (these three only — there are no `os cloud logs/metrics/status`) |
104104
| `os package publish [dist/objectstack.json] [--env … --install --visibility org]` | Upload the compiled artifact as a versioned package to the cloud catalog (ADR-0008 P3). Listing file, README, review and every screen the customer's administrator meets: [Marketplace handbook](https://objectstack.ai/docs/deployment/marketplace-handbook) |
105-
| `os package install <manifest-id │ ./dist/objectstack.json> [--version │ --runtime http://localhost:3000]` | Install a package into a **running** runtime via its install-local endpoint. Catalog mode (by manifest id) or air-gapped local-artifact mode. Auths with the **target runtime's** session (`--email/--password` or `OS_RUNTIME_EMAIL`/`OS_RUNTIME_PASSWORD`), not the cloud login |
105+
| `os package install <manifest-id │ ./dist/objectstack.json> [--version │ -u/--url http://localhost:3000]` | Install a package into a **running** runtime. Catalog mode (by manifest id) or air-gapped local-artifact mode. Auths as a **target runtime** user (`-t/--token` or `--email/--password`; env `OS_RUNTIME_TOKEN` or `OS_RUNTIME_EMAIL`/`OS_RUNTIME_PASSWORD`), not the cloud login |
106106

107107
> **Cloud connection & marketplace (`@objectstack/cloud-connection`, ADR-0008/0009).**
108108
> The open runtime-side cloud client. Its plugins —

0 commit comments

Comments
 (0)