docs(releases): v17 page covers the 17.0.0-rc.2 window

[os-zhuang]

Docs-only, release-time curation of the layer-3 platform page ahead of the 17.0.0-rc.2 cut. Per docs/releases-maintenance.md, the page is compiled centrally from the changesets the window left pending plus the .objectui-sha pin — this is that pass, and it is a dedicated docs-only PR rather than a rider on code changes (CLAUDE.md, content/docs/releases/ is release-owned).

Source material

• 209 changesets pending since the rc.1 version commit (2bafe62e) — 46 major-class, 74 minor, 55 patch, 34 releasing nothing.
• ~200 framework commits in 2bafe62e..HEAD, cross-checked against the changesets with scripts/collect-release-notes.sh so commits that landed without one are still accounted for.
• .objectui-sha is unchanged at 785b8a5d432c, and the page's Console section already documents through that pin (docs(releases): v17 升级指南补 objectui#3203 作者破坏性迁移,console 段区间更新到 785b8a5d432c #4744), so rc.2 bundles no new Console delta. The page says so, and flags that a pin bump before the cut would need its own range — objectui main has moved past it.

What changed

New ## Landed since 17.0.0-rc.1 section, following the shape of the existing rc.0 section (what is already documented in place above is pointed at, not repeated):

• One name, one declaration — the ✅ spec 双源清账主单:基线 52 → 0(2026-08-03 收官)—— #4446 gate 落地后的偿还 worklist #4535 dual-source campaign closes all seventeen clusters (C1–C17), with a table of each name's resolution, plus [#4535·A2] MetadataFormat + CacheStrategy:./shared ≠ ./system 的枚举分歧收敛 #4537 / [#4535·A3] contracts 手写 interface 与域内 zod 推导类型收敛(3 簇 9 条) #4538 / [#4535·B] 跨形态同名三条:ShareRecipientType(type≠const)、TransformType(const≠type)、suggestFieldType(双实现 function) #4539 and the spec 缺一条「跨 barrel 同名导出」检查:api-surface.json 里同名跨入口目前可见但不报警(#4411 遗留裁决 2) #4446 symbol-identity ratchet. None of it is authorable metadata, so the migration is an import path or a name, caught as TS2305.
• The authorable surface closes — 未知键静默剥离仍是全仓默认:把 #3405 的 strict 收紧从一个 schema 推广到整个可授权面(ADR-0078 完整性闸门) #4001's final batches (object parse path, field, dashboard, action, mapping/agent/page, translation, the six validation variants, six registered types, Studio, view), strictObject, and the hollow protection-envelope invariant that was skipping 24 of 25 types.
• ADR-0049 enforce-or-remove reaches the driver and datasource contracts — a table covering the 31 DriverCapabilities bits, findStream, IDataEngine.batch, the four datasource blocks, openApi31, activationEvents, the standalone validation kind, the job runtime door, the six authorWarn keys, the five unwarnable keys, the fail-open area gates, sys_comment.visibility, data.field.changed, and the managedBy: 'system' → 'system-data' rename.
• Author-time gates — the ADR-0078 completeness gate with its rules table (each citing the runtime skip line), Phases 3 and 4 including the registration-time runtime twin, and the [runtime/metadata] 作者时规则只存在于 CLI:Studio/REST/MCP 的运行时授权面是第四扇门,26 条规则一条不跑——#4409 修完后最大的敞口 #4463 fourth door that gates runtime metadata writes with 422 INVALID_METADATA.
• Atomicity and durable migrations — ADR-0119 D1/D4 (atomic becomes a guarantee, default flips to false), D2 (runMigrationJournal / sys_migration_journal / os migrate resume), D3, and ADR-0118's actor contract.
• Protocol & wire changes, metadata authoring & runtime changes, security corrections and new backend capabilities for the window.

Upgrade checklist gains the rc.2 migrations: the spec import-path/rename table, datasource and driver cleanups, bulk/batch atomic semantics and the new per-row shape, hook and validation predicate behaviour, script nodes, standalone validation artifacts, jobs, managedBy: 'system-data', app areas, comments, getSuspendedScreen, runtime metadata writes, and a "run os validate first" note for the new completeness errors.

Two new highlights at the top of the page (one-name-one-declaration; the closed authorable surface) and a Landed since rc.1 line in References.

Also renames the four rc.2 subsection headings so they don't collide with the rc.0 section's in the table of contents.

Verification

• node scripts/check-release-notes.mjs — OK
• node scripts/check-doc-authoring.mjs — 215 files clean
• Scanned every added line for unfenced {/< and for | inside code spans within table rows (MDX/GFM hazards) — clean.

Releases nothing; the changeset carries empty frontmatter.

---

Generated by Claude Code

[vercel]

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 3, 2026 12:21pm