Skip to content

Commit 061cc94

Browse files
docs(skills): the bootstrap example pins every @objectstack/* dependency to one exact version, as the scaffolder writes it (#25667)
<!-- claude-projects-attribution: {"github_login":"os-elon-musk"} --> _Requested by **Elon** · [project thread](https://claude.ai/code/project/chan_01WedDzV26nniwxv7jC88B9D?thread=cmsg_01WedDzV26nniwxv7jC88B9DMMchS2pMx7VafJmdzGaxFv)_ Fixes #25666 Clause-②: no Metadata-protocol: none ## 维护者速读(草稿) - **改了什么**:已发布技能 `objectstack-platform` 的 bootstrap 示例里,五个 `@objectstack/*` 依赖还写着 `^17.0.0`。改成和脚手架一样的精确版本 `18.1.0`。原计划加的一句说明被已发布技能的 token 上限挡住(只降不升),已删去,精确版本本身已表达同一意思。 - **为什么改**:PR #25539 起脚手架写精确版本,v18 文档也要求锁精确版本;照技能抄的人会装到 17.x,还是 caret 范围。 - **风险与代价(含回滚)**:纯文档,附一条 `@objectstack/skills` patch changeset;一次 revert 可回。 - **你要做的(一个动作)**:`skills/**` 属 Tier H,复核通过、CI 全绿后请您合并。 ## What changed - `skills/objectstack-platform/references/bootstrap.md` 〈Complete Working Example〉 `package.json`: `@objectstack/spec`, `runtime`, `driver-memory`, `plugin-hono-server`, `cli` go from `^17.0.0` to `18.1.0`; `typescript` keeps `^5.3.0`. No prose added: a first commit added one sentence (the scaffolder writes its own version, exactly), and the published skills token ratchet (`scripts/check-skills-token-ratchet.mjs`, #10473) refused it, 1391 tokens against a shrink-only ceiling of 1351; the second commit drops it (1350 / 1351) rather than ask for a ceiling ruling. - `.changeset/25666-skills-bootstrap-exact-pins.md`: `@objectstack/skills` patch. Grounds: `packages/create-objectstack/src/pkg-utils.ts` `syncObjectStackDeps` (`deps[dep] = version`, PR #25539); `content/docs/protocol/backward-compatibility.mdx` L206 and `content/docs/deployment/self-hosting.mdx` L64 (pin exact); `packages/create-objectstack/package.json` `18.1.0`. ## Gates On this head: `node scripts/check-skills-token-ratchet.mjs` ✓ (bootstrap.md 1350 / 1351), `pnpm check:skill-frame-sync` ✓, `pnpm check:skill-frame-freshness` ✓, `pnpm check:skill-identifier-liveness` ✓, `pnpm check:skill-compatibility` ✓, `scripts/check-empty-changeset.mjs` ✓, `scripts/check-commit-card-trailers.mjs --range origin/main..HEAD` ✓. `git grep -n '"\^1[0-9]\.' skills/` finds nothing (it found these five lines before). ## Acceptance notes - Not in scope: `engines: { protocol: '^17' }` in `objectstack-platform/SKILL.md` L142 is the protocol handshake range, a different value. The template baseline and its release-time stamping are PR #25665 (`domain:devx`). - The literal `18.1.0` will age with each release like any versioned example. - Governed surface `skills/**` (Tier H): lands by the maintainer's hand. Opened through the fleet-write relay `pr_create`; every later write goes through the relay too. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01REMuzhz6MWRjg8uohedMnM --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent a0fac02 commit 061cc94

2 files changed

Lines changed: 14 additions & 5 deletions

File tree

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
'@objectstack/skills': patch
3+
---
4+
5+
docs(skills): the objectstack-platform bootstrap example pins every `@objectstack/*` dependency to one exact version
6+
7+
Clause-②: no
8+
9+
The 〈Complete Working Example〉 `package.json` in `objectstack-platform/references/bootstrap.md` gave `^17.0.0` for its five `@objectstack/*` packages, a major behind and a caret range the v18 docs advise against. It now gives `18.1.0` for each, the exact form `create-objectstack` writes, with all of them on one version.

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -144,13 +144,13 @@ A minimal but complete project from scratch:
144144
"validate": "objectstack validate"
145145
},
146146
"dependencies": {
147-
"@objectstack/spec": "^17.0.0",
148-
"@objectstack/runtime": "^17.0.0",
149-
"@objectstack/driver-memory": "^17.0.0",
150-
"@objectstack/plugin-hono-server": "^17.0.0"
147+
"@objectstack/spec": "18.1.0",
148+
"@objectstack/runtime": "18.1.0",
149+
"@objectstack/driver-memory": "18.1.0",
150+
"@objectstack/plugin-hono-server": "18.1.0"
151151
},
152152
"devDependencies": {
153-
"@objectstack/cli": "^17.0.0",
153+
"@objectstack/cli": "18.1.0",
154154
"typescript": "^5.3.0"
155155
}
156156
}

0 commit comments

Comments
 (0)