check-doc-links 扫描面第三扩:CONTRIBUTING.md + ROADMAP.md + docs/**(实测 70 链接、今日零死链、纯配置三行)

[yinlianghui]

PM 立单(#3545 的 step 2 —— 该单随 PR #3571 关闭,step 2 依分诊座位"ship step 1 alone and re-file step 2"的建议重新安家)。查重:承接 #3545 线程,无其它同源单。

内容

scripts/check-doc-links.mjs 的 SCAN_ROOTS 表(#3542 起为数据表)追加三行:

{ path: 'CONTRIBUTING.md', rule: 'disk' },
{ path: 'ROADMAP.md',      rule: 'disk' },
{ path: 'docs',            rule: 'disk' },

为什么现在是纯收益(#3571 的实测,不是猜测)

• 三面合计 70 条链接 / 52 条可判定;docs/**(15 文件 49 链接)今日零死链(分诊座位曾警告这一面从未量过 —— 现在量了);
• CONTRIBUTING/ROADMAP 的三条死链已由 PR docs: 修正 CONTRIBUTING.md / ROADMAP.md 的 3 条死链 #3571 修掉 —— 扩展落地时零清理清单(对比 content/docs 有 16 个失效的相对链接,且 check-doc-links.mjs 对相对链接一律放行 #3479 带 16 处、content/docs 有 18 条链接在站上是 404,但 check-doc-links 按设计放行(1 条相对链接跑出 docs collection + 17 条 /spec /protocol /api /examples 绝对链接) #3490 带 18 处的入场费);
• 这两文件正是 CONTRIBUTING.md / ROADMAP.md 共 3 条死链:处在 check-doc-links 与 lychee 的双重扫描盲区 #3545 三条死链能积攒的原因:两个检查器盲区的交集,不扩就会再积。

验收

• 沿用 feat(scripts): check-doc-links 两向扩展 —— 扫描面扩到 examples/** 与根 README,自仓 GitHub URL 离线校验 #3542 的 fixture 风格补 reject/accept 用例(disk 规则已存在,新根不需要新规则类);
• 真仓跑:预告零红并确认(docs: 修正 CONTRIBUTING.md / ROADMAP.md 的 3 条死链 #3571 合并后);
• 逆向:临时植入一条 CONTRIBUTING 死链,contributing(或既有 example-relative)reason 正确拒绝;
• 已知边界如实写进头注释:围栏内代码(stripCode 抹掉)里的链接不在覆盖面(CONTRIBUTING.md 的 Documentation 一节有两处与仓库现状不符:门禁描述指错工具/触发条件,"✅ 正确链接示例" 里 3 条路由是死的 #3570 的三条死"正确示例"即此类,修它是 CONTRIBUTING.md 的 Documentation 一节有两处与仓库现状不符:门禁描述指错工具/触发条件,"✅ 正确链接示例" 里 3 条路由是死的 #3570 的事,不是本单的)。

Blocked-by: #3571

关联:#3545 / PR #3571(step 1 + 成本实测)、#3536 / PR #3542(SCAN_ROOTS 数据表)、#3570(围栏盲区实例)。

[yinlianghui]

解锁 + 认领 — Blocked-by PR #3571 已落 main(d126607),blocked 摘除。会话 session_01GTRjn8xBqp75dk7kFupVRt,分支 claude/issue-3572-scan-roots-third-ext。

按正文执行:SCAN_ROOTS 三行 + fixture 用例 + 真仓零红预告确认 + 逆向植入验证 + 头注释如实写围栏盲区边界。文件面:scripts/check-doc-links.mjs、scripts/__tests__/check-doc-links.test.ts。⚠️ 与 #3570(改 CONTRIBUTING.md 内容)同批在飞 —— 本单只改检查器,不碰 CONTRIBUTING.md;若真仓跑出 CONTRIBUTING 新红恰是 #3570 要修的三条死"示例",报告不修(它们在代码围栏内,stripCode 抹掉,理论上扫不到 —— 若扫到了说明实现有误,回头查)。越界即停。

---

Generated by Claude Code

[yinlianghui]

验收:ACCEPT — PR #3589。

核过 GitHub 实物(3 文件恰在围栏,ci-cd-pipeline.md 为披露过的最小事实修正)。裁定要点:

1. 反空转绿是本单的灵魂且做足了:两处 accept 型测试在写作期自查出"删行仍绿"并加对照链接(前后实证);逐根 count 下限补上钉扎自扩展的盲区(新根拼错 → collectFiles 返回空 → 全绿的假象);四路逆验证含"围栏内链接必须保持不可见"这一边界本身(b 例预告绿并中)。
2. 实测数字不留旧账:ci-cd-pipeline 的"61 links would be rejected"按新扫描面重算为 111 并更新 —— 过期测量与过期散文同罪。HINT 的表面清单同步修正。
3. 真仓零红按预告命中(70/52 独立复现);CONTRIBUTING 的 10 条围栏链接一条未报 —— 实现确实没有扫围栏,与 CONTRIBUTING.md 的 Documentation 一节有两处与仓库现状不符:门禁描述指错工具/触发条件,"✅ 正确链接示例" 里 3 条路由是死的 #3570 的并行协调闭环。
4. 注释失真:两处称 Lychee 是「weekly cron with continue-on-error」,实际工作流是 fail: true 且根本没有 PR 触发器 #3587(检查器 prose 把 lychee 机制写反的两处旧址)已核存在 —— 与 CONTRIBUTING.md 的 Documentation 一节有两处与仓库现状不符:门禁描述指错工具/触发条件,"✅ 正确链接示例" 里 3 条路由是死的 #3570 dev 纠正过的我派单同款错误,现在有了自己的单;⚠️ 改的是 check-doc-links.mjs 注释与其测试,等本 PR 落 main 后再派(同文件)。
5. 过程笔记有传播价值:curl 403 正文让 CI 等待循环瞬间假成功 —— "沉默不是成功"的又一实例,已进 PM 意识。

PR 转 ready + auto-merge。

---

Generated by Claude Code