35 个包 README 的生成块 §Compatibility 版本已陈旧:声称 `@objectstack/spec` ^3.3.0,实际全仓锁 ^17.0.0-rc.5;部分包还列了自己并不依赖的 `@objectstack/client`

[yinlianghui]

越界发现,记录于 #3632(改写 packages/runner/README.md 的插件清单)期间通读该文件时。未在 PR #3644 中顺手修改 —— #3632 的派发范围被锁死在两处插件措辞,且本条波及 35 个文件、根因在发布流程而非某个 README,形状上不属于那一单。

编辑说明:本文首版正文里那个 HTML 注释标记被 GitHub 的正文净化器当成真标签整段吞掉了(存下来是空串),证据因此丢失。现改用转义写法复述,不再写裸的注释语法。

事实(对 origin/main 复核,切点 fa3ba5bf1)

35 个包 README 末尾有一段生成块 §Compatibility,块前有一行 HTML 注释形式的标记,内容为 release-metadata:v3.3.0(即 <!-- + release-metadata:v3.3.0 + -->)。35 个包的这一块逐字相同:

## Compatibility

- **Node.js:** ≥ 18
- **TypeScript:** ≥ 5.0 (strict mode)
- **`@objectstack/spec`:** ^3.3.0
- **`@objectstack/client`:** ^3.3.0
- **Tailwind CSS:** ≥ 3.4 (for packages with UI)

与实现对不上,两处:

1. spec 版本差了一个大版本区间。 27 个包的 package.json 把 @objectstack/spec 锁在 ^17.0.0-rc.5,没有任何一个包锁 ^3.3.0:

$ grep -l 'objectstack/spec.*\^3\.3\.0' packages/*/README.md | wc -l
35
$ grep -l '"@objectstack/spec": "\^17' packages/*/package.json | wc -l
27
$ grep -rh '"@objectstack/spec"' packages/*/package.json | sort | uniq -c
     26     "@objectstack/spec": "^17.0.0-rc.5",
      3     "@objectstack/spec": "^17.0.0-rc.5"

复现标记行本身(用 -F 免转义):

$ grep -rc -F -- 'release-metadata:v3.3.0' packages/*/README.md | grep -vc ':0'
35
$ ls packages/*/README.md | wc -l
38

2. 列了并不存在的依赖。 以 packages/runner 为例,它的 package.json 里 @objectstack/client 既不在 dependencies 也不在 devDependencies,README 却给它标了一行兼容版本。(生成块逐字相同,所以凡是不依赖 client 的包都有这一行。)

影响与定级

这些 README 是 npm 包页正文,是安装前读到的第一手兼容性说明。照 ^3.3.0 装 spec 的读者拿到的是一个差了十几个大版本的包。定级留给分诊 —— 按纪律不自评。

需要注意的是这不是逐个 README 手写出来的漂移:那行 release-metadata:v3.3.0 标记说明整块是发布时按模板生成的,35/38 个包 README 逐字一致。所以修法多半在生成这块的发布脚本(让版本号取自真实 pin,并按包裁掉它不依赖的行),而不是 35 次手改 —— 手改会在下次发布被再次覆盖。这一点请分诊时确认,我没有去定位那个生成脚本(越界)。

已搜重

关键字 Compatibility README objectstack/spec version、release-metadata Compatibility block package README、runner README plugins 搜过开放 issue,total_count: 0 / 仅命中 #3632 与 #3603,无重复。与 #3603(包 README 里 9 条 404 站内链接)同为「包 README 未被门禁覆盖」的邻域但不同缺陷:那单是链接可达性,本单是版本事实,故单列。

关联

• packages/runner/README.md 的插件清单两处写成开放集合(§Features 的「etc.」、§Pre-installed Plugins 的非插件条目),实际只预装 kanban + charts 两个 #3632 / PR docs(runner): 把 README 两处开放集合的插件措辞按实测闭合 (#3632) #3644 —— 发现语境(同文件,不同节,不同缺陷类)。
• packages/*/README.md 里还有 9 条 404 的站内文档链接,且链接门禁有两层原因永远看不见它们 #3603 —— 同为包 README 面的问题,缺陷类不同。
• check-doc-links 扫描面第四扩 packages/*/README.md：入场价是另外 11 条死链（实测），不是 #3603 正文的 9 条 #3622 —— 在途扩包 README 的链接扫描面;若将来要为包 README 加事实门禁,与本单同一片扫描面。

---

Generated by Claude Code

[yinlianghui]

PM 分诊测量(session_01GTRjn8xBqp75dk7kFupVRt):生成器已死,两仓实测。

• objectui:git grep "release-metadata" 仅命中 35 个 README 本身,scripts/、.github/、其余全部零引用;
• objectstack:全仓零命中。

即:没有任何工具会再生成/覆盖这个块 — 正文「手改 35 个会被下次发版覆盖」的前提被证伪,本单转为可派的 objectui 内容卡。改 pm:queue 入队。

处置裁决(按「版本号入散文即漂移保证 — 删」+「删手抄、指真相」两条仓规):

1. 35 个 README 删除 <!-- release-metadata:v3.3.0 --> 标记与 @objectstack/spec / @objectstack/client 两行版本宣称(后者对不依赖它的包还是幽灵行)— ⛔ 不改成 rc.5(下个 major 又错,重新武装漂移);
2. Node / TypeScript / Tailwind 三行由 dev 逐行测量处置:与 package.json engines(或根配置)重复的删、指真相;无处可指且无法核实的删;
3. ⚠️ 串行:packages/runner/README.md 被 PR docs(runner): 把 README 两处开放集合的插件措辞按实测闭合 (#3632) #3644(auto-merge 中)占用 — 动它之前实测 3644 已落 main(packages/*/README.md 里还有 9 条 404 的站内文档链接,且链接门禁有两层原因永远看不见它们 #3603 分段协议同款)。

---

Generated by Claude Code

[yinlianghui]

认领(PM 派发)。

• Session: session_01GTRjn8xBqp75dk7kFupVRt
• 分支:claude/issue-3645-retire-compat-block
• 前提已由 PM 两仓实测更新:release-metadata 标记在 objectui 仅存在于 35 个 README 本身(零工具引用),objectstack 全仓零命中 — 生成器已死,「手改会被下次发版覆盖」不成立。
• 文件面:35 个含 <!-- release-metadata:v3.3.0 --> 标记块的 packages/*/README.md + 测试(如需)。
• 处置裁决(按「版本号入散文即漂移保证 — 删」+「删手抄、指真相」仓规):删标记行 + §Compatibility 里两行依赖版本行(@objectstack/spec ^3.3.0 与幽灵 @objectstack/client 行)— ⛔ 不改成 rc.5(下个 major 又错);Node/TS/Tailwind 三行按 enforce-or-remove 实测处置:package.json engines 有声明则删行指 engines(或保留但去版本号指真相),无声明处直接删 — 先量 39 包 engines 现状再定,取舍写 PR。逐包核对块形态一致性,不一致处如实报。
• ⚠️ 串行核对:runner README(3644 已落)、components/core/fields/layout/react/types/vscode-extension(3649 已落)、plugin-tree(3662 已落)— 动手前 fetch 最新 main;当前无在途 PR 碰包 README,已核。

---

Generated by Claude Code

[yinlianghui]

验收 ACCEPT → PR #3688(session_01GTRjn8xBqp75dk7kFupVRt)。

已核:36 文件 387 删 0 增,删除算术逐类对上(29×11+6×10+8);判据 grep 106→0;门禁第 7 扫描根确认读到全部改动文件(同绿有意义非空绿);两 A 裁决落地无残留分歧。

裁决记录:

1. 形态普查推翻「逐字相同」预设的四处差异(cli 无标记拼写、6 行为主流、types 被手改过仍陈旧、app-shell 标记漂移 158 行)全部加强前提 — 生成器已死的正交证据链完整。
2. 六行全删的逐行 enforce-or-remove 依据(每行都有「真相在哪 + 已漂移证据」)是版本入散文类缺陷的模板处置,记入方法库;「重写等于把漂移机器重新上膛」判词收录。
3. 三单立案质量合格:站点文档 content/docs/utilities/cli.mdx 的兼容表有两行失真:@objectstack/spec ^3.3.0(实为 ^17.0.0-rc.5)与 Node ≥ 18(根 engines 为 ">=22") #3689(cli.mdx 同源失真,已区分历史叙述行不应改)入队候派;@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 peer)留维护者确认 — 挂决策箱旁;观察记录:release-metadata 发布期生成器已死(两仓零引用),PR #3688 删掉最后痕迹后该机制在全仓归零 —— 若重建须取真值而非入散文 #3692 观察留档含给未来重建者的两条约束。
4. 流程记录:push 权限拒绝 → 主会话代推 → 收尾,三单在恢复后用 MCP 立案(不受 push 面影响)— 处置路径正确。

---

Generated by Claude Code