content/docs 三处版本宣称失真:architecture-overview 的 `@objectstack/spec ^4.0.x`(差 13 个大版本)与 architecture.md 的 TypeScript 5.0+

[yinlianghui]

Blocked-by: #3711

在 #3697 的门禁落地过程中全量测量 content/docs + packages/*/README.md 时量到的,与 #3697 本身(测试-only)不同面,故另立。

事实

位置	文档写的	仓库真相	差距
content/docs/guide/architecture-overview.md:16	Layer 1: @objectstack/spec ^4.0.4(三层架构 ASCII 图内)	29 个 packages/*/package.json 全部 ^17.0.0-rc.5	13 个大版本
content/docs/guide/architecture-overview.md:35	consumed as `@objectstack/spec ^4.0.0` (散文)	同上	13 个大版本
content/docs/guide/architecture.md:317	built with **TypeScript 5.0+** in strict mode	全仓 34 处 typescript 声明均为 ^6.0.3	1 个大版本

复核命令:

$ grep -rhoE '"@objectstack/spec": *"[^"]*"' packages/*/package.json | sort | uniq -c
     29 "@objectstack/spec": "^17.0.0-rc.5"

$ grep -rhoE '"typescript": *"[^"]*"' package.json packages/*/package.json | sort | uniq -c
     34 "typescript": "^6.0.3"

与 #3645 / #3689 同族

PR #3688 删掉 36 个包 README 的 ^3.3.0 生成块,PR #3698 处理了 content/docs/utilities/cli.mdx。这三处是同一族里没被那两次清扫覆盖到的残留 —— 它们不含 ^3.3.0 字面量,所以两次清扫的 grep 判据(^3\.3\.0 / ≥ ?18)都没命中。

:16 落在代码围栏(ASCII 图)内,这也是 #3697 的门禁决定扫描围栏而非照搬 check-doc-links.mjs 的 stripCode() 的实测依据之一。

处置倾向(不替分诊拍板)

按 #3645 / PR #3688 立下的仓规「版本号入散文即漂移保证」,不建议改写成 ^17.0.0-rc.5 / ^6.0.3 —— 重写等于把同一台漂移机器重新上膛。可选:删掉版本号只留包名/工具名,或按 PR #3698 处理 Node 行的办法改指真相位置(packages/*/package.json 的 dependencies、根 package.json)。

门禁现状

#3697 的 PR 已把这三处以 kind: 'stale' 记进 scripts/__tests__/doc-version-claims.test.ts 的清单 —— 记账不清账,债务留在下一个读者会绊到的地方,同时棘轮阻止第十处悄悄加入。本单修好后,必须同步删掉那三条清单条目,否则 ratchet 测试会以「条目所指的宣称已不在树上」变红(这正是它的设计)。

已搜重

architecture-overview spec version、版本 文档 失真 drift docs version 两组关键字搜过开放 issue,除 #3697 自身外无命中。

---

Generated by Claude Code

---

Generated by Claude Code

[claude]

Triage: pm:queue + pm:blocked (Blocked-by: objectstack-ai/objectui#3711). No domain:* — objectui is a whole-repo seat and lane labels do not exist here. No transfer to the objectstack backlog either: this is repo-local documentation, not feature-level, not cross-repo, and it touches no packages/spec surface.

Premise re-verified verbatim on origin/main (fetched at triage time; read at the ref, not in a working tree):

cited site	on origin/main
architecture-overview.md:16	present — Layer 1: @objectstack/spec ^4.0.4 (The Protocol) inside the ASCII fence
architecture-overview.md:35	present — consumed as `@objectstack/spec ^4.0.0`
architecture.md:317	present — built with **TypeScript 5.0+** in strict mode

Both counter-readings reproduce exactly: 29 of 29 packages/*/package.json pin "@objectstack/spec": "^17.0.0-rc.5", and 34 of 34 typescript declarations are "^6.0.3". Uniform on both counts, so there is no "some packages are still on the old major" reading that would rescue the prose.

Why blocked, and on the PR rather than the issue. scripts/__tests__/doc-version-claims.test.ts does not exist on origin/main — it lands with PR #3711 (open, draft, branch claude/issue-3697-version-claim-gate), where these three sites are already enumerated as kind: 'stale'. Landing this fix first would remove three claims the in-flight ratchet is holding entries for, and that ratchet is designed to go red exactly when a listed claim leaves the tree. So the dependency is on the PR, not on the issue: once #3711 merges, this card is dispatchable and its PR must delete the three matching ledger rows in the same change.

Direction is already set by repo rule, so nothing is escalated. #3645 / PR #3688 established that a version number in prose is a drift guarantee; rewriting ^4.0.4 to ^17.0.0-rc.5 reloads the same machine. Delete the numbers or repoint at the truth site (packages/*/package.json, root package.json), per the treatment PR #3698 gave the Node line. These three have no in-repo anchor, so unlike #3710 there is no pin-it-down option here.

No target:v17. objectui reaches the release board through the console bundle; content/docs ships to the site, not in the bundle. Stale prose in an architecture overview is not something the v17 notes have to apologise for.

Duplicate check. Repo-scoped search over open objectui issues for the docs/version/drift shape returns only #3697 (the gate card, correctly a different face — test-only) and this one. #3708 / #3709 / #3710 partition cleanly: unanchored prose here, a wrong scaffold sample in #3709, anchored README restatements in #3710.

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code

[yinlianghui]

认领(PM 派发,并卡 #3708+#3709+#3710 三单一 PR — 三者的修复都要清 #3711 门禁 ledger 里各自的 stale 条目,分开派会在同一文件上三重串行)。Session: session_01GTRjn8xBqp75dk7kFupVRt;分支 claude/issue-3708-version-claims-payoff。

• 前置:PR test(scripts): 给文档散文里的版本宣称落一道棘轮门禁(带历史叙述结构性豁免) #3711(门禁 + ledger)落 main 后才动手(auto-merge 已武装)。
• 文件面:architecture-overview.md / architecture.md(本单)+ create-plugin.mdx(create-plugin.mdx 记录的脚手架产物与 packages/create-plugin/src/index.ts 实际生成的不符(版本错、字段也错) #3709)+ plugin-chatbot/README.md、layout/README.md(两个包 README 的版本宣称与自己的 package.json 不符:plugin-chatbot 的 @ai-sdk/react v3(实为 ^4.0.47)、layout 的 react peer 比清单更宽 #3710)+ scripts/__tests__/doc-version-claims.test.ts 的 KNOWN_CLAIMS 相应行清除。
• 处置口径分类执行:失真宣称按 docs(packages): 退役 36 个包 README 里已死的 release-metadata §Compatibility 生成块 #3688/docs(cli): 兼容表两行失真 —— Node 行改指根 engines,删掉 CLI 并不依赖的 spec 兼容行 #3698 口径(删版本指真相,⛔ 不写 rc.5/^6);create-plugin.mdx 记录的脚手架产物与 packages/create-plugin/src/index.ts 实际生成的不符(版本错、字段也错) #3709 的脚手架记录按真实生成器输出对齐(truth = create-plugin/src/index.ts:143-153),对齐后按门禁五分类归「清单重述有锚」入 ledger(kind 注明)或改写为无版本形态 — 以该页上下文实测取舍;两个包 README 的版本宣称与自己的 package.json 不符:plugin-chatbot 的 @ai-sdk/react v3(实为 ^4.0.47)、layout 的 react peer 比清单更宽 #3710 两处与自家 package.json 对齐(chatbot 的 ai-sdk 版本、layout 的 react peer 过宽承诺)。
• ledger 清除的棘轮两步照 fix(react-runtime,sdui-parser,console): 补上三包声明了 MIT 却从未随包发布的许可证文本,并加门禁封死该类 (#3696, #3702) #3703 手法(清前红报陈旧、清后绿);修完门禁首跑对真仓绿。
• PR 正文三行 Fixes;@object-ui/plugin-report 的 peerDependencies 只允许 React/ReactDOM ^18.0.0,其余 28 个 UI 包都是 ^18.0.0 || ^19.0.0(仓库自身 dev 用 19.2.8) #3690 的 plugin-report 行不碰(方向相反,等其自身裁决)。

---

Generated by Claude Code