`saveMetaItem` 是 #4632 词表覆盖不到的持久性接缝:8 处 catch 完全静默吞掉元数据写入失败

[os-zhuang]

发现于 #4669 的修复过程(PR 分支 claude/issue-4669-permission-backfill-strict-spec)。未认领 —— 只是记录。

背景

#4632 立的规则(AGENTS.md「Degradation log levels」)由 pnpm check:durability-log-level 机械执行,但闸门自己声明了局限:它只认 DURABILITY_CRITICAL_CALLEES 这张显式词表,发现不了词表以外的持久性接缝。

#4669 正是这个类:ADR-0094 D4 的 permission-set backfill 调 protocol.saveMetaItem(),失败被 catch 成一条 warn,计数器不动 —— 整条投影路径 100% 停摆,却一个红灯都没有,跨了一个发布周期才被人在无关的 bump 日志里偶然看见。修复(PR 见上)把那两处提到了 error + 计数,但 saveMetaItem 本身没有进词表,所以同类接缝仍然不受保护。

测量:如果把 saveMetaItem 加进词表会怎样

在本地把 ['saveMetaItem', …] 加进 DURABILITY_CRITICAL_CALLEES 跑一次(探针脚本,未提交),得到 8 处违规,分布在 3 个包 4 个文件,而且全部是最糟的形态 —— catch 里连日志都没有,完全静默:

文件	命中数	形态
packages/runtime/src/domains/packages.ts	3	catch swallows the failure with no log at all
packages/rest/src/rest-server.ts	2	同上
packages/metadata-protocol/src/protocol.ts	2	同上
packages/runtime/src/domains/meta.ts	1	同上

(plugin-security 的两处不在名单里 —— 它们已被 #4669 的 PR 修成 error。)

为什么单独立一条

• 加词表和修 8 处别人的调用点是一个独立的清账,塞进 permission-set backfill (ADR-0094 D4) 现在 100% 失败：行里的 active 存储列喂进了 #4001 之后严格化的 permission spec #4669 的 PR 会把一个 3 文件的 bug 修复撑成跨 3 个包的横扫 —— 属于 Prime Directive chore: version packages #10 说的「太大不该顺手做」。
• 每一处都要逐个判断:有的 catch 可能是合法的「探测失败,继续」(那要走 durability-degradation.baseline.json,附理由,shrink-only),有的是真丢数据。不能一把 sed 成 error。
• 词表加一个条目会立刻让闸门变红,所以「加词表」和「修/基线化这 8 处」必须同一个 PR。

建议做法

1. 逐一读这 8 处,判定是持久性丢失还是功能性降级;
2. 真丢失的:按范本(packages/services/service-automation/src/plugin.ts start())改成 error + 写清后果与修复动作,或直接 rethrow;
3. 判定为可接受的:写进 scripts/durability-degradation.baseline.json,注明理由与关闭条件;
4. 同一 PR 里把 ['saveMetaItem', '元数据定义没有写进权威存储 —— 运行时看起来一切正常,重新 provision 时定义凭空消失。'] 加进 DURABILITY_CRITICAL_CALLEES。

复现

# 把 ['saveMetaItem', '…'] 插进 scripts/check-durability-degradation-log-level.mjs
# 的 DURABILITY_CRITICAL_CALLEES,然后:
node scripts/check-durability-degradation-log-level.mjs

[os-zhuang]

串行注记(PM 循环第 2 轮,会话 session_01Pbu27iNUfQCHeuS551Rqo7):本单本轮不派,两个原因:(1) 文件面含 packages/rest/src/rest-server.ts,与在飞的 #5093(cli 车道,endpoint 文档进 rest-server enrichment 管线)疑似相交,存疑即串行,待 #5093 落地后基于合并后 main 重核 8 处 catch 的现状(行号与形态都可能变);(2) 词表脚本 scripts/check-durability-degradation-log-level.mjs 属 devx 面,派发时按跨域单一认领在 claim 里全列文件面即可,但「加词表 + 修/基线化 8 处必须同一 PR」的约束要原样进派发词。bug 面清完后优先于 #4792。

---

Generated by Claude Code

[os-zhuang]

认领:PM 循环第 3 轮(串行解除:#5093/E6 已于 07:45Z 闭环,rest-server 面空闲;维护者已指示提速,批量升 5)
会话:session_01Pbu27iNUfQCHeuS551Rqo7
分支:claude/issue-4754-savemetaitem-durability-wordlist
Worktree:objectstack-issue-4754
域:domain:engine(词表脚本跨入 devx 面,已声明)
文件面:packages/runtime/src/domains/packages.ts / meta.ts、packages/rest/src/rest-server.ts、packages/metadata-protocol/src/protocol.ts、scripts/check-durability-degradation-log-level.mjs + scripts/durability-degradation.baseline.json、相关测试、changeset(越界即停,报告说明)

⚠️ 同日 churn:E6(#5093)今日改了 rest-server enrichment 管线与 http-dispatcher —— issue 里「8 处 / 3 包 4 文件」的清单必须重测,以探针脚本对当前 origin/main 的实际输出为准。⛔ 不碰 packages/metadata-protocol/src/seed-loader.ts(#5127 同批)。「加词表 + 修/基线化全部命中必须同一 PR」约束照单执行。

---

Generated by Claude Code