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

vercel Bot commented Jul 4, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jul 4, 2026 3:47pm

Request Review

@github-actions github-actions Bot 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 main Jul 4, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the claude/bold-clarke-o4op29 branch July 4, 2026 16:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants