Skip to content

docs(changelog): backfill protocol releases 10.0.0–11.10.0 in the root protocol changelog - #2590

Merged
os-zhuang merged 1 commit into
mainfrom
claude/bold-clarke-o4op29
Jul 4, 2026
Merged

docs(changelog): backfill protocol releases 10.0.0–11.10.0 in the root protocol changelog#2590
os-zhuang merged 1 commit into
mainfrom
claude/bold-clarke-o4op29

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Summary

The root CHANGELOG.md declares itself the ObjectStack Protocol changelog, but its released sections stop at [4.0.1] — 2026-03-31; the entire 10.x/11.x protocol era existed only in the raw per-package changesets record (packages/spec/CHANGELOG.md). This PR backfills the protocol-facing view:

  • One section per spec release 10.0.011.10.0 (release dates taken from the npm registry), curated strictly to the protocol surface: breaking changes, behavior changes, deprecations/retirements, additions to the authorable surface, and consumer-visible fixes — distilled from packages/spec/CHANGELOG.md, with PR/ADR references preserved.
  • A versioning note: from 10.0.0 onward the protocol version is the published @objectstack/spec version; releases 4.0.29.11.0 remain documented in the per-package changelogs; cross-links to docs/upgrading-to-11.md, ADR-0059 (compatibility gates) and ADR-0087 (upgrade-communication contract).

Notable outcomes of having this in one place:

  • The deprecation → retirement windows are now visible end-to-end (e.g. compactLayout deprecated 11.7.0 → retired 11.10.0; titleFormat, kind:'jsx', sqlPredicateToCel still open) — the traceability seed for ADR-0087 D4's spec-changes history.
  • Both majors are clearly delimited: 10.0.0 (sys_departmentsys_business_unit, ADR-0057 authz core, the 16 defineX factories) and 11.0.0 (MCP-only open edition, flow-node alias removals, IUIService removal, runAs enforcement), each pointing at the migration guide.
  • Empty releases (10.3.0, 11.6.0, 11.8.0) are stated as "no protocol-facing changes" rather than omitted, so the version sequence has no silent holes.

No content was invented: every entry traces to a packages/spec/CHANGELOG.md changeset entry, docs/upgrading-to-11.md, or the referenced ADR/PR.

Verification

  • Docs-only change; node scripts/check-doc-authoring.mjs passes (180 files clean).
  • Release dates cross-checked against npm view @objectstack/spec time (10.1.0 and 11.8.0 were not published to npm; dated by their neighboring releases).
  • Insertion point preserves Keep-a-Changelog descending order ([Unreleased]11.10.010.0.0[4.0.1]).

🤖 Generated with Claude Code

https://claude.ai/code/session_01HjDghc79qFSJkJt2zvBxtU


Generated by Claude Code

…t protocol changelog
The root CHANGELOG.md declares itself the ObjectStack Protocol changelog but
its released sections stopped at 4.0.1 (2026-03-31); the 10.x/11.x protocol
era existed only in the raw per-package changesets record
(packages/spec/CHANGELOG.md). This backfills the protocol-facing view:
- one section per spec release 10.0.0 → 11.10.0 (dates from the npm registry),
curated to the protocol surface: breaking changes, behavior changes,
deprecations/retirements, additions, consumer-visible fixes
- a versioning note: from 10.0.0 the protocol version is the published
@objectstack/spec version; 4.0.2–9.11.0 remain in per-package changelogs
- cross-links to docs/upgrading-to-11.md, ADR-0059 (compat gates) and
ADR-0087 (upgrade-communication contract)
Traceability seed for ADR-0087 D4 (spec-changes history): the deprecation →
retirement windows (compactLayout 11.7→11.10, jsx alias, titleFormat,
sqlPredicateToCel) are now visible in one place.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HjDghc79qFSJkJt2zvBxtU
@vercel

vercelBot commented Jul 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJul 4, 2026 3:47pm

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation size/m labels Jul 4, 2026
@os-zhuang
os-zhuang marked this pull request as ready for review July 4, 2026 16:07
@os-zhuang
os-zhuang merged commit 0fddd01 into mainJul 4, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the claude/bold-clarke-o4op29 branch July 4, 2026 16:08
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@os-zhuang@claude