Commit a641d10
docs(releases): curate the v17 platform release page and wire it into the nav
Layer 3 of the release history (docs/releases-maintenance.md) is a hand-curated
page per major, and v17 had none. The train carries 302 pending changesets — 45
of them marked breaking — so the page that third parties actually read to plan an
upgrade was the one artifact the release could not generate.
Adds content/docs/releases/v17.mdx, sourced from the pending changesets for the
backend and from the four bundled @objectstack/console refresh entries for the
frontend. It leads with breaking changes + migration (Node 22 floor, the opt-in
export axis, the ApiMethod shrink and its reporter codemod, user-less flow runs
refused, the three retired authorable aliases, agent.tools[], approval-request
participant visibility, sharing full/group, membership grade, better-auth 1.7
account identity, the deleted SDK surface, the GraphQL removal, the
ObjectStackProtocol alias, datasource fail-fast, per-tenant unique, the i18n
contract fixes and the dead-spec-cluster prune), then new capabilities (ADR-0104
files-as-records, dynamic approver routing, the reconciled SDK surface, write
observability, analytics correctness), a Console (Studio) section, an upgrade
checklist and a reference index.
Wires "v17" into content/docs/releases/meta.json so the page is navigable, and
adds its entry to the releases index — the two things check-release-notes will
demand the moment 17.0.0 lands in the spec CHANGELOG.
Also corrects the plugin manifest compatibility example in
content/docs/protocol/kernel/plugin-spec.mdx: it showed keys PluginManifest does
not declare (objectstack / node rather than minObjectStackVersion /
maxObjectStackVersion / nodeVersion) alongside a >=18.0.0 Node floor and a
>=2.0.0 <3.0.0 platform range, so the one copy-pasteable manifest example in the
protocol docs taught a shape the parser strips. #3825 restated the Node
prerequisite in ten user-facing places and missed this one.
The release page's two remaining uses of the reserved word "role" are the literal
sys_member.role column the ADR-0108 section is about; ratcheted into
scripts/role-word-baseline.json accordingly.
Verified: pnpm docs:build passes (411 doc routes, /en/docs/releases/v17 among
them), and check:release-notes, check:doc-authoring, check:role-word,
check:org-identifier, check:nul-bytes, check:node-version are green.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LXvaYR7TiJBCxYwjn51owH1 parent fc156fa commit a641d10
6 files changed
Lines changed: 861 additions & 2 deletions
File tree
- .changeset
- content/docs
- protocol/kernel
- releases
- scripts
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
160 | 160 | | |
161 | 161 | | |
162 | 162 | | |
163 | | - | |
164 | | - | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
165 | 166 | | |
166 | 167 | | |
167 | 168 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
| 21 | + | |
21 | 22 | | |
22 | 23 | | |
23 | 24 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
| 5 | + | |
5 | 6 | | |
6 | 7 | | |
7 | 8 | | |
| |||
0 commit comments