Skip to content

fix(docs): plugin-spec's package.json example silently installs a 2.x CLI — both @objectstack/* ranges repaired to ^17.0.0 #18186

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
claude merged 1 commit into from
Sep 14, 2026
+8 −3
Merged

fix(docs): plugin-spec's package.json example silently installs a 2.x CLI — both @objectstack/* ranges repaired to ^17.0.0 #18186

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions content/docs/protocol/kernel/plugin-spec.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -700,11 +700,11 @@ Plugins are distributed as **NPM packages** for easy versioning and distribution
],

"dependencies": {
"@objectstack/core": "^2.0.0"
"@objectstack/core": "^17.0.0"
},

"devDependencies": {
"@objectstack/cli": "^2.0.0",
"@objectstack/cli": "^17.0.0",
"typescript": "^5.3.0"
},

Expand All @@ -723,7 +723,12 @@ Plugins are distributed as **NPM packages** for easy versioning and distribution

The `typescript` floor above mirrors `SCAFFOLD_TYPESCRIPT_RANGE` in
`packages/cli/src/commands/init.ts` — that constant, not this snippet, is the
authority the scaffolders emit from.
authority the scaffolders emit from. The two `@objectstack/*` ranges have an
authority in the same file: every `@objectstack/*` package in this monorepo is
published on one shared release version, and the scaffolders caret-pin each
dependency to the version of the CLI that generated the project
(`getCliVersion()`). A hand-written example cannot carry that live value, so it
carries the **current major's floor** — track it when the major moves.

### Publishing to NPM

Expand Down
Loading