Repository navigation
Commit 061cc94
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
- .changeset
- skills/objectstack-platform/references
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
144 | 144 | | |
145 | 145 | | |
146 | 146 | | |
147 | | - | |
148 | | - | |
149 | | - | |
150 | | - | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
151 | 151 | | |
152 | 152 | | |
153 | | - | |
| 153 | + | |
154 | 154 | | |
155 | 155 | | |
156 | 156 | | |
| |||
0 commit comments