[PM seat] domain:spec-tooling — 🟢 os-zhuang

[claude]

范围

协议工具链 / 门禁 / 生成器 + 其文档。

面:scripts/**(门禁类)、packages/spec/scripts/**、packages/spec/docs/**、packages/lint/**、content/docs/**。
⛔ 不碰:content/docs/releases/**、packages/spec/src/**/*.zod.ts、strictness-ledger 的 counts 产物。
⚠️ 与 domain:devx 按「是否围着 spec 契约转」切分;运行时门的派发侧是 packages/metadata*(他席),本车道只拥有 packages/lint 里的注册声明。
⛔ .claude/skills/** 不在本车道(已拆出 domain:skills,座位 #7623)。

当前 PM

• GitHub 账号:os-zhuang ⚠️ 舰队多账号在岗;认领评论的 session ID 才唯一标识座位。
• 会话:session_01WocN37om5bw81JDoEEMA2e
• 上任:2026-08-12T01:1xZ,自 session_01KJATVrh6V2ysutYUJigh3B(os-help)

继承台账

现值(2026-08-14T04:3xZ,第 9 轮收口):在飞 0 · 队列 0 · blocked 0 · 决策箱 0 · 挂起 3 · 未定级 finding 1

状态	卡
未定级 finding(⛔ 本席不定级,分诊首触轮的活)	#8607(2026-08-14T01:16Z 立)
pm:on-hold	#8360 — registry.ts 相邻 id 服务端冲突;重启:①相邻 id 真挤出 PR ②#7464 被拿起 ③#6957 重裁 #8133 — spec 18 个自足 entry bundle 无共享 chunk #7443 — 重启:真有第三个值被提议进 AUTHORING_SURFACES;⛔ runtimeTypes 增长不算
他席在办、与本席热文件相关	#8075 / PR #8230 也改 build-docs.ts 的 data/system 页表;本席 #8166 已先落 ⇒ 对方须 rebase

热文件串行队

文件	有序卡片	各自认领的区域
scripts/check-adr-0087-registration.mjs + docs/adr/0087-*.md	#8299(9cfdddd,已落)	处置词表 3 值 → 4 值(新增 D7 runtime-interface-only);ADR 首次写下整份词表;assertInputs 双向断言:门接受的类目与 ADR 记录的必须同集合 ⇒ 单改一侧即红。改任一侧的卡必须同时改另一侧
ADR-0087 生成投影(spec-changes.json、protocol-upgrade-guide.md)	#8344(b3b618b)	已测定:无驱动服务端合并永不「陈旧但干净」;冲突只在 id 相邻时。⛔ 分片它们买不回任何弹出
packages/spec/scripts/build-docs.ts	#7303 → #7658 → #8166(e019766)	integration 类目只剩 connector。⚠️ 活撞面 #8230
packages/lint/src/validate-visibility-predicates.ts	#7815(cdbffca)→ #8042(df72328)	2 处 *.form.ts 为故意保留,有源码级 pin ⛔ 不要"顺手清干净"
packages/lint/src/authoring-rules.ts	#7220 → #7503 → #7659 → #7576(全落)	#7443(hold)动轴本身;#7891 若派回本席动 validateSecurityPosture 块注册
scripts/check-*.mjs(跨包一致性门族)	#8002(2473cd2)	check:filter-alias-parity AST 读三处声明;已在 CI 观察到真跑并通过

常设承诺

派发前必查:

触发文件	点名
check-adr-0087-registration.mjs / ADR-0087 文本	#8299 落地注记:词表与 ADR 有双向断言,单改一侧即红;新类目需 路径#符号 记法(裸名在本仓不构成身份 —— PackagePublishResult 实测同名两处)
ADR-0087 entry 树 / 两投影 / registry.ts	#8344 测量结论 + #8360(hold):⛔ 不提「分片投影」
build-docs.ts 的 data / system 页表	#8075 / PR #8230
validate-visibility-predicates.ts 文案	#8042 落地注记
spec alias 表 / wire 表 / query-multiplicity.ts	check:filter-alias-parity(#8002)
任何「文档锚点已验证」断言	#7484
packages/spec/scripts/lib/zod-graph.ts	分诊关卡留的知识债

本席固定纪律:

1. 读数反常先怀疑自己的模式/区间;用既有邻居做阳性对照;⛔ 不用宽区间归因。
2. 计数不透过分页器;发布前找同量 pin 对账。
3. 注册表里的自述字段最不可信 —— 以运行的代码为准。
4. 族/计数类断言在派发时刻重新枚举;PM 的更正同样是线索,dev 应独立重跑(Observation: build-docs.ts integration category lists 9 page names with no emitting module — only connector produces a page #8166 实证:卡面 9/228 均错,实为 8/230)。
5. 「删除残留」类卡先确定谁写这个文件。
6. 绿色 sibling 只有在任务真正执行过时才是对照。
7. 云卡报告缺席走直接验收判据。
8. dev 说某门「红且既存」,先自己读那道门的 workflow 再采信。
9. SKILL 新鲜度以已知 tip 作基准,⛔ 不用共享检出 HEAD。
10. 测量先行卡:测量可以推翻卡自己的默认方向(spec-changes.json and protocol-upgrade-guide.md are unsharded generated artifacts whose merge safety rests on a LOCAL-only git driver — the merge queue rebuilds server-side, where no custom driver runs #8344 实证);裁定当众下,知识落进代码注释而非只留 issue。
11. ADR-class 卡(docs/adr/**):approval 门要求 approving review 且禁止已武装 auto-merge ⇒ ⛔ 本席既不清也不绕,复核后明示挂起。ADR-0087's changeset disposition has no category for published runtime TS interfaces with no metadata surface — the #8277 exemption argument is correct, unverifiable, and will be re-litigated #8299 实证的两条:① 批准到达后该门会自动重跑,旧 job URL 永远停在 failure —— 判状态要看新 attempt / Checks 面板,⛔ 不看直链;② 同事件可能触发一个被 cancelled 的重复 run,属正常取代非失败。
12. CI 红先归因再动手:枚举分支实改文件 → 与失败点比对 → 同 commit 重跑区分抖动(feat(gates): name the runtime-interface-only ADR-0087 disposition and check it (#8299) #8456 实证)。⚠️ ⛔ 不顺带声称抖动源健全。
13. list_issues 永不返回 assignees —— 清单只是候选名单,认领前每张必过完整 issue_read。
14. 解锁扫描连评论一起扫(body 被实体转义,Blocked-by: 类行可能落在评论首行)。
15. enable_pr_auto_merge 回显两向不可靠 —— 权威信号只有 timeline 队列事件与 MERGED;队列落地 ≈ 每 PR 15–30 分钟串行,⛔ 不据「还没落」提前判异常。
16. finding 恒 = 待首次定级,定级即离标(82ea3f59)—— 裸 finding 数即未定级数,hold 已换 pm:on-hold 不计入。车道座位可附证据/前提重验,⛔ 不定级不改标。

说明

快状态:本班 10 merged —— #7658/#7808、#7576/#7886、#7630/#7927、#7889/#7952、#7815/#8041、#8002/#8182、#8042/#8183、#8166/#8219、#8344/#8359、#8299/#8456(9cfdddd) · 0 返工 · 0 空派发 · 云容器 0 空转。#8456 为本班唯一 ADR-class 卡:本席复核后挂起,维护者 hotlong 于 04:13Z 前批准使 approval 门转绿,随后由共享账号翻 ready 并入队落地(⛔ 非本会话动作)。

协议版本:SKILL tip 82ea3f59(累积:b6ff173 wave-2 → 720fe14 subagent 前置快进 → 2c0b2f3 收班=状态 flush+看护移交 → 2de1be5 四条排程裁定〔取卡全序 p0 > pm:blocking > target 板 > Bug > 其余;pm:blocking 由分诊 sweep 维护 ⛔ 本席不手工挂;紧急卡直接分诊;简单跨车道阻塞项可由被挡座位直接接手〕→ ccd46760 fable 额度耗尽豁免 → 87e2faa0 七条实测读数规则 → 82ea3f59 findings 流水线〔纪律 16〕)。

环境:

• subagent 读本地检出,每批派发前 git pull --ff-only origin main。检出停在 main 分支。
• ⚠️ 快进后 stop hook 会报「N 个未推送提交」——那是 main 的历史,远端无本席分支,⛔ 不推。
• ⚠️ 一切读数用 git -C … origin/main:<path>;dev 一律专属 worktree;本容器 Bash 禁裸 sleep 链。

跨车道备忘:⛔ list_triggers 里除本席外的条目属于其它座位。

[baozhoutao]

审计:维护者 2026-08-06 15:2xZ 指示换任 —— 座位改为 ⏳ 待接管,前任会话 session_01559M8FVm6W6vDLABL3jvdW 自即刻起不再认领、不再派发,仅按「在飞认领由原认领者跟完」保留 #5278/#5827 一条线的收尾(等维护者裁决 → 执行落地 → 注销认领)。C 包收官全账在 #5163;新 PM 接手面与必读纪律已写入正文。

---

Generated by Claude Code

[os-zhuang]

接管审计(2026-08-06 15:2xZ):

• 新任:会话 session_014wsZeReNTqiceBfLb5Pyf5,由维护者启动 /pm-dispatch spec-tooling 接续本座位。前任 session_01559M8FVm6W6vDLABL3jvdW 已于 15:07Z 发 C 包收官帐(C 包 program card:协议工具链/门禁车道(domain:spec-tooling)—— 整包移交待接收 #5163)并宣布收官守望态(唯一开放项 [finding] DEBT ledger counts in check-type-check-coverage.mjs drift silently — @objectstack/metadata-protocol records 28, actually reports 63 #5278→ci(dx): DEBT/TEST_DEBT 台账数字改为每次重测的真棘轮 —— 实测 > 记录即红 (#5278) #5827)——本次为相位边界交接,非活性回收。
• 在飞认领不变:spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837 由 spec 座位按维护者指定跨域执行,不受影响;[finding] DEBT ledger counts in check-type-check-coverage.mjs drift silently — @objectstack/metadata-protocol records 28, actually reports 63 #5278 / PR ci(dx): DEBT/TEST_DEBT 台账数字改为每次重测的真棘轮 —— 实测 > 记录即红 (#5278) #5827 的停放守望随座位归本会话统一看护。前任会话下轮巡检读到本贴后请让行,⛔ 勿双守 ci(dx): DEBT/TEST_DEBT 台账数字改为每次重测的真棘轮 —— 实测 > 记录即红 (#5278) #5827(双向让行纪律:动手前读最近 30 分钟评论)。
• 接管时重建读数:车道 open 24(pm:queue 未认领 14 / finding 6 / 决策 2 / tracking 1 / 在飞 1),与收官帐「队列清空」的差 = 分诊今日路由入车道的新单,非账目错误。

---

Generated by Claude Code