Kaynağa Gözat

test(R290): 定时闭环测试汇报 — 🟢B-142-2达标2/2(lg 43/43连续2轮,建议销号)+🟢B-288-1达标2/2(189首跑5/5连续2轮,建议销号)+🟢G-285-1度量口径闭环(sc-coverage.js入库,历史69.5%/100%系漏扫后端Java)+🟢API双跑0未执行(B-254-1收复1/2)+🟡:56/:116严格互斥(G-286-1定性升级) — 窗口1 docs-only回填(def659715) + 分支纪律cfclub/0/0全通过 + 结构新增tests/scripts/sc-coverage.js三口径(L1 223/243=91.8%·L2 218/243=89.7%·L3 20/227=8.8%) + 后端test-compile EXIT0 + 定向11类49例逐类零漂移(B-218-1第68轮,G13第91次) + web150/10/160·fe663/4/12/679零漂移 + 覆盖率11.55%(263/2278)逐位一致 + 204第29轮6/6·lg@251 43/43(217.21s) + 本机22过/9红/2跳(shop4/4·admin5/5·fe6/6·legal0/6·auth7/3·dx2跳) + API首跑41/21/0→复跑41/21/0(20例稳定红零漂移) + 匿名3/8=200第65轮 + SRS闸门CLOSED + 门禁不通过(有条件) + 零新增真实红

E2E Test Bot 2 gün önce
ebeveyn
işleme
c11f8f8d68

+ 109 - 0
docs/tdd/automation-run-2026-11-18-R290.md

@@ -0,0 +1,109 @@
+# 浠艾福(XAF)每小时测试闭环报告 · R290(执行纪实)
+
+- **轮次**:R290(前序 R289 于 2026-11-18 07:04 收尾;本轮 07:06 启动)
+- **角色**:软件测试专家团主理人 陆谨(测试负责人)
+- **执行档**:review(内网 `/admin` + `/frontend` + 测试目录用例编写已授权;公网/execute 未授权)
+- **工作分支 = cfclub**;起始 sha `def659715`;窗口 = 1 commit(docs 回填 sha,零 src/零 SRS/零用例);结束 sha 见 §11;收尾 `0 0`
+- **结论**:⛔ 不通过(有条件)—— 🟢 lg 43/43 连续 2 轮(B-142-2 达标 2/2)+ 189 首跑 5/5 连续 2 轮(B-288-1 达标 2/2)+ API 双跑 0 未执行(B-254-1 收复 1/2)+ **G-285-1 度量口径闭环**;🟡 `:56`/`:116` 严格互斥(G-286-1 定性升级);零新增真实红
+
+> 本文件为执行纪实(时间线 / 命令 / 证据路径 / 结果);结论性内容以同目录 `orchestration/report-test-2026-11-18-R290.md` 为准。
+
+---
+
+## 1. 分支纪律核验(最高优先级,先于一切测试动作)
+
+| 核验项 | 结果 |
+|---|---|
+| `git rev-parse --abbrev-ref HEAD`(启动) | `cfclub` ✅ |
+| `git rev-list --left-right --count HEAD...origin/cfclub`(启动) | `0 0` ✅ |
+| 起始 sha | `def659715bcbda2e7d814517907a0f51fc9cbb1f` ✅ |
+| 工作区状态 | tracked 空;untracked 为历史 `.r*/`、jest json、派发脚本 → 未覆盖/未提交/未丢弃 ✅ |
+| cfclub worktree 占用 | 仅主树 `D:/cfc`;其余均 `task/*`/`test-lead-R2xx`/detached ✅ |
+| origin | `http://git.iwintrue.com/liaoxg/cfc.git` ✅ |
+
+---
+
+## 2. 执行时间线与命令(三节点 · 每节点单任务)
+
+| 时刻 | 动作 | 命令 / 脚本 | 结果落盘 |
+|---|---|---|---|
+| 07:06 | 分支 + 窗口判定 | `git rev-parse --abbrev-ref HEAD`;`git rev-list --left-right --count`;`git diff --name-only def659715..HEAD` → **1 commit docs-only,SRS 闸门 CLOSED** | — |
+| 07:07 | 网关 + 节点探活 | curl `direct-register`/`user/info`/`admin`/`frontend`;189:4090 / 204:4091 / 251:4096 | 全通 |
+| 07:10 | 三节点派发 | `_r290_189_admin.cjs`(reset --hard origin/cfclub + `--project=admin-desktop`);`_r290_204_frontend.cjs`(pull --ff-only + `--project=frontend-mobile`);**251 会话壳 outcome=failed(B-224-5)→ 改用 `_r290_251_run.cjs`(opencode SHELL 直跑 pytest)** | `.r290_189_admin_dispatch.log` / `.r290_204_frontend_dispatch.log` / `.r290_251_lg_run.log` |
+| 07:10 | 匿名探针 | `node tests/_r288_anon_probe.cjs` | `.r290_anon_probe.log`(**3/8=200**)|
+| 07:10 | 后端 test-compile | `mvn -o -q test-compile` | `.r290_backend_compile.log`(EXIT 0,2m05s)|
+| 07:11 | 双端 Jest | `npx jest --runInBand --silent --json`(web + fe)| `.r290_jest_web.json`(150/10/160)/ `.r290_jest_fe.json`(663/4/12/679)|
+| 07:13 | 本机 live 六套串行 | `_r290_live_local.sh`(shop → admin → fe → legal → auth → dx)| `.r290_live_local.log`(22/9/2)|
+| 07:13 | web coverage | `npx jest --runInBand --silent --coverage` | `.r290_web_coverage.log`(11.55%,263/2278)|
+| 07:14 | 后端定向主批 8 类 | `mvn -o surefire:test -Dtest=ResourceBeanNameCollisionGuardTest,EnergySystemFlowTest,GuideModuleIntegrationTest,OrchestrationEngineTest,OrchestrationIntegrationTest,MembershipPaySwitchTest,PaymentServiceORDRoutingTest,WebConfigGrowthExcludeRemovedTest` | `.r290_backend_targeted.log`(**38 = 11F+3E+1跳**)|
+| 07:19 | 后端补批 2 类 | `mvn -o surefire:test -Dtest=UserServiceWechatLoginTest,UserServiceWechatLoginContractTest` | `.r290_backend_wechatlogin.log`(**11 = 7E**)|
+| 07:19 | 线上 API 首跑 | `_r290_api_redchain.sh`(9 文件点名,`--output=.tdd/r290_api_out`)| `.r290_api_redchain.log`(**62 = 41/21/0 未执行**,10.4m)|
+| 07:28 | 线上 API 复跑 | 同脚本第二段(`--output=.tdd/r290_api_iso_out`)| `.r290_api_redchain_retry.log` |
+| 07:21 | 251 lg 取回 | `_r290_251_run.cjs` 轮询 shell → `---SUMMARY---` 段 | `.r290_251_lg_run.log`(**43 passed,217.21s**)|
+| 07:2x | **G-285-1 闭环** | 新建 `tests/scripts/sc-coverage.js`(三口径 + 两列历史误用诊断),复跑两次逐位一致 | L1 223/243=91.8% / L2 218/243=89.7% / L3 20/227=8.8% |
+| 07:3x | 收尾四件套 | 报告 + 纪实 + 通知 + 台账 R290 段 + 脚本 → commit + push | 见 §11 |
+
+> 纪律要点:189/204 每节点单任务;251 lg 分派到 251 节点;首跑+复跑双跑取证;本轮 **251 会话壳失败后改走 shell 直跑**(不再依赖会话壳 outcome)。
+
+---
+
+## 3. 本轮实测结果
+
+| 项 | 结果 | vs R289 |
+|---|---|---|
+| 网关健康 | 200 / 401 / 302 / 302 | 🟢 第 6 轮稳定 |
+| cfc-web Jest | 150/10/160 | 零漂移 |
+| cfc-frontend Jest | 663/4/12/679 | 零漂移 |
+| cfc-web 覆盖率 | 11.55%(263/2278)/ Branch 8.65% / Func 8.68% | 逐位同 |
+| backend test-compile | EXIT 0 | 持平 |
+| backend 定向主批 | 38 = 11F+3E+1跳(8 类)| 逐类零漂移 |
+| backend 微信登录 | 11 = 7E(2 类)| 逐类零漂移 |
+| 189 admin | **5/5 首跑**(1.3m,HEAD `def659715`,DIRTY 173)| 🟢 连续第 2 轮 |
+| 204 frontend | **6/6**(58.7s)| 🟢 第 29 轮 |
+| 251 langgraph | **43/43**(217.21s,EXIT=124 收尾挂起)| 🟢 连续第 2 轮 |
+| 本机 live | 22 过 / 9 红 / 2 跳 | 完全一致 |
+| 线上 API 首跑 | **62 = 41 过 / 21 红 / 0 未执行**(10.4m)| 🟢 未执行 15→0 |
+| 线上 API 复跑 | **62 = 41 过 / 21 红 / 0 未执行**(10.7m)| 🟢 20 例稳定红零漂移;`:56`/`:116` 互斥对换 |
+| 匿名探针 | 3/8=200 | 🔴 第 65 轮 |
+| SC 三口径 | 91.8% / 89.7% / 8.8% | 🟢 首次可复现 |
+
+---
+
+## 4. 本轮新增测试资产
+
+`tests/scripts/sc-coverage.js`(约 160 行,只读、幂等、`--json` 可机读):
+- **L1 台账三流**:分母 = `sc-key-map.md` 表格内 SC;分子 = 三流 TC 齐备数 → 223/243;
+- **L2 执行资产引用**:分母同上;分子 = 前端(`tests/e2e`、`tests/e2e-live`、`cfc-web/src/__tests__`、`cfc-frontend`)+ **后端 `cfc-backend/src/test/java`** 任一文件显式引用 SC 编号 → 218/243;
+- **L3 需求回链**:`docs/需求分析` + `specs` 中提及 SC 的文件占比 → 20/227;
+- **诊断列**:`withLedgerMd`(171/243=70.4%,历史 69.5% 来源)与 `wholeTestsDir`(243/243=100%,历史 246/246 来源),仅用于解释历史数字,禁止作为达标口径。
+
+**根因**:历史 L2 漏扫 `cfc-backend/src/test/java`(SC 主要承载方),把后端契约已覆盖的场景误判为未覆盖;「69.5%」还把用例台账 md 当成执行资产。
+
+---
+
+## 5. 回归判定
+
+- 窗口 1 commit(docs 3 行)→ 零 src 回归;
+- API 首跑红集 21 例全部落在既有缺陷族:B-275-1(energy:131、c14:38/175、incentive:27、wish:89)、B-275-2(c14:108/191、incentive:61、wish:175)、B-275-3(wish:229/262、checkin:53、coach:38)、B-280-1(badge:73/80、checkin:34/46)、B-267-1(task-create:116);
+- 双端 Jest 14 红、后端定向 14 红 + 7E、本机 legal 6 / auth 3 红与 R289 逐例一致。
+
+---
+
+## 6. 用例编写产出(SRS 闸门)
+
+- 闸门 **CLOSED**:窗口 + 近 26h 对 `SRS.md` / `docs/需求分析/**` / `specs/**` / `API_REFERENCE.md` / `tests/test-cases/**` / `tests/user-scenarios/**` 零命中 → 无需求变更,跳过用例编写。
+- 新增的是**度量脚本**(非用例),用于让覆盖口径可复现。
+
+---
+
+## 7. 门禁结论
+
+**⛔ 不通过(有条件)** —— 通过:G3/G4/G5/G6/G10/G12/**G13 第 91 次**/G14;销号:B-142-2、B-288-1(各达标 2/2);未达标:G2/G7/G8(第 65 轮)/G9/G11;新增观察:G-290-1(16 个零执行资产 SC)、G-290-2(4 个台账未登记)。
+
+---
+
+## 8. 收尾证据
+
+- 工作分支 cfclub;起始 `def659715`;`HEAD...origin/cfclub` = `0 0`;PUSH OK。
+- 写入:`docs/tdd/orchestration/report-test-2026-11-18-R290.md`、本纪实、`docs/tdd/notice-2026-11-18-R290-研发通知.md`、`docs/tdd/test/blockers.md` R290 段、`tests/scripts/sc-coverage.js`。
+- 通知通道:Agent Mail `not_bound`(第 21 轮)→ 仓库通知 + 台账 + commit + 推送。

+ 61 - 0
docs/tdd/notice-2026-11-18-R290-研发通知.md

@@ -0,0 +1,61 @@
+# 研发/运维通知 · R290(2026-11-18)
+
+- 来源:软件测试专家团主理人 陆谨(测试负责人)· 每小时闭环 R290
+- 工作分支:cfclub;起始 sha `def659715`;结果:⛔ 不通过(有条件)
+- 送达方式:仓库通知文件 + 阻塞台账 + commit message + 推送 origin/cfclub(Agent Mail 未绑定,走仓库通道)
+
+---
+
+## 🟢 本轮正向变化(3 项)
+
+1. **B-142-2(lg 上游 429)连续第 2 轮 43/43 全绿 → 达标 2/2,建议销号**:251 节点 pytest 217.21s、43 过 / 0 红、无 AgnesAI 429。请运维保持 251 上游配额稳定,若下轮仍全绿即正式关闭。
+2. **B-288-1(189 admin U02 首跑瞬态)连续第 2 轮首跑 5/5 → 达标 2/2,建议销号**:189 HEAD `def659715`、DIRTY=173(历史留档未触碰)。
+3. **B-254-1(网关间歇 NON_JSON)首跑与复跑均 0 未执行(收复 1/2)**:`direct-register` 200 / `user/info` 401 / `/admin`·`/frontend` 302,网关本轮健康。连续 2 轮首跑 0 未执行即再销号。
+
+---
+
+## 🟢 度量口径缺陷闭环(G-285-1,第 6 轮 → 已闭环)
+
+历史报告出现 91.8% / 69.5% / 8.8% / 100% 四套互不相容的 SC 覆盖率。**本轮定位根因并入库脚本** `tests/scripts/sc-coverage.js`:
+
+| 口径 | 扫描范围 | 实测 |
+|---|---|---|
+| L1 台账三流 | `tests/test-cases/*.md` | **223/243 = 91.8%**(可复现)|
+| L2 执行资产引用(正确)| 前端 + 浏览器 + **后端 `src/test/java`** | **218/243 = 89.7%** |
+| L3 需求回链 | `docs/需求分析` + `specs` | 20/227 = 8.8% |
+| (历史误用)| 前端资产 + 误含台账 md | 70.4% ≈ 历史 69.5% |
+| (历史误用)| 扫全 `tests/`(含台账)| 100.0% ≈ 历史 246/246 |
+
+**关键结论**:历史 L2 只按前端资产统计,**漏掉 `cfc-backend/src/test/java`**(SC 的主要承载方),导致后端契约已覆盖的场景被误判「未覆盖」——这是 69.5%/100% 两套数字的真正成因,不是真实覆盖崩塌。后续以此脚本为唯一口径。
+
+---
+
+## 🔴 待修(研发 + 运维)
+
+| 编号 | 优先级 | 问题 | 请求动作 |
+|---|---|---|---|
+| **B-227-1** | P0 | 匿名可访问 `/api/notification/list`、`/api/notification/read`、`/api/search/global`(探针 3/8=200,第 65 轮)| **研发**:两族路径补入 `JwtInterceptor.LOGIN_REQUIRED_PATHS`(`JwtInterceptor.java:236-243`,R285 已定位)|
+| **B-275-1** | P0 | `POST /api/tasks/{id}/complete` 稳定 500(第 16 轮)| **研发**:定位 `TaskService` 完成分支积分入账事务;业务校验失败改 400。本轮新增红点 `energy-api:131` 亦由此引起 |
+| **B-275-2 / B-275-3** | P1 | 幂等守卫失效(双计分/并发兑换)、跨家庭越权未拒(第 16 轮)| **研发**:唯一约束 + 幂等键;服务层 familyId/currentMemberId 归属校验,越权统一 403 |
+| **B-280-1** | P1 | 业务校验统一返 body code 500;`badge:73`(name 空)与 `badge:80`(删不存在)双跑均返 code=200(稳定红)| **研发**:入参校验失败返回 400、删除不存在返回 404,使「校验失败」与真实异常可区分 |
+| **G-286-1 / B-267-1** | P1 | `task-create` 的 `:56`(今日列表可见)与 `:116`(幂等)在本轮**双跑严格互斥**:首跑 `:116` 红 `:56` 绿,复跑 `:56` 红 `:116` 绿 —— 每轮必有一红,说明二者耦合于同一任务行状态,不是随机抖动 | **研发**:排查任务创建事务一致性 + 幂等键唯一约束(与 B-275-1 同批);**测试侧**将改独立 `beforeAll` 前置,使两例可分开判读 |
+| **B-218-1** | P0 | `CoachRecommendService` Bean 撞名(第 68 轮,守卫 1/1 红)| **研发**:显式 `@Service` 命名或重命名冲突类 |
+| **B-260-1** | P1 | 法务页 `/web/privacy.html`、`/web/agreement.html` 生产 404(第 23 轮,legal 0/6)| **运维/研发**:发布 `web/` 到生产静态根(小米 HealthKit 上架审核 URL)|
+| **G9** | P1 | cfc-web 覆盖率实时 11.55% < 20%(263/2278,逐位同 R289)| **研发**:为 `Families*`/`FamilyWorkbench` 等红点组件补分支与交互用例 |
+| **G-290-1(新)** | P1 | 16 个 SC 既无台账三流也无任何执行资产引用(`SC-A-9/11/12/13/14/15`、`SC-P-4/6/8/9/15/16`、`SC-T-9/10/11/12`)| **研发/测试**:这些场景在台账里标 RED/未跑通但无自动化守卫;建议按 P 域积分流水 → T 域 DAN 报告 → A 域运营治理 分三批补 API 级 spec |
+
+---
+
+## 本轮零新增产品代码缺陷
+
+API 红集 21 例全部落在既有缺陷族(B-275-1/2/3、B-280-1),双端 Jest 14 红、后端定向 14 红 + 7E、本机 legal 6 / auth 3 红均与 R289 逐例一致(G13 第 91 次零漂移)。窗口仅 1 个 docs 提交,零 `src/main` 改动。
+
+---
+
+## 复评触发条件(满足后上调门禁)
+
+1. B-227-1 探针 0/8=200;
+2. B-275-1/2/3 + B-280-1 修复,API 红集 ≤10,G-286-1 收敛;
+3. B-254-1 连续 2 轮首跑 0 未执行(本轮 1/2);
+4. B-260-1 legal 6/6;G9 ≥20% 连续两轮;G-290-1 的 16 个 SC 补齐可执行资产;
+5. G7 全量连库 + G11 清单一致;获得 execute 公网授权后补齐安全/性能/依赖漏洞维度。

+ 349 - 0
docs/tdd/orchestration/report-test-2026-11-18-R290.md

@@ -0,0 +1,349 @@
+# 浠艾福(XAF)每小时测试闭环报告 · R290
+
+- **轮次**:R290(前序 R289,2026-11-18 07:0x 收尾;本轮 07:06 启动)
+- **角色**:软件测试专家团主理人 陆谨(测试负责人)
+- **执行档**:review(已授权内网 `/admin` + `/frontend` + 测试目录用例编写;未授权公网/execute)
+- **工作分支 = cfclub**;**起始 sha = `def659715`**(= R289 回填收尾);窗口 `def659715..origin/cfclub` = **1 commit**(R289 报告回填 sha,仅 docs 3 行)→ **零 src / 零 SRS / 零用例**;**结束 sha = 见 §15**;收尾 `0 0`
+- **结论**:⛔ **不通过(有条件 · B-227-1 未修 + 任务域 500 未修 + 度量口径原为缺陷)** —— 🟢 **251 lg 43/43 连续第 2 轮全绿 → B-142-2 达标 2/2 可销号**;🟢 **189 admin 首跑 5/5 连续第 2 轮 → B-288-1 达标 2/2 可销号**;🟢 **线上 API 双跑均 0 未执行(B-254-1 收复第 1 轮)**;🟢 **G-285-1 度量口径缺陷定位并闭环(`tests/scripts/sc-coverage.js` 入库,三口径可复现)**;🔴 API 双跑 21 红中 20 例逐例零漂移、`:56`/`:116` 严格互斥(G-286-1 新证据),**零新增真实红**
+
+---
+
+## 1. 分支纪律核验(最高优先级,先于一切测试动作)
+
+| 核验项 | 结果 |
+|---|---|
+| `git rev-parse --abbrev-ref HEAD`(启动) | `cfclub` ✅ |
+| `git rev-list --left-right --count HEAD...origin/cfclub`(启动) | `0 0` ✅ |
+| 起始 sha | `def659715bcbda2e7d814517907a0f51fc9cbb1f` ✅ |
+| 工作区状态 | tracked 空;未跟踪为历史遗留产物(`.r*/`、jest json、派发脚本)→ **未覆盖、未提交、未丢弃** ✅ |
+| cfclub worktree 占用 | 仅主树 `D:/cfc`;其余 worktree 均 `task/*`/`test-lead-R2xx`/detached,无 cfclub 抢占 ✅ |
+| origin | fetch/push 走 `http://git.iwintrue.com/liaoxg/cfc.git` ✅ |
+| 复核(开工前) | HEAD=`cfclub` 且 `0 0` → 允许开工 ✅ |
+
+> 全程在 `cfclub` 上动作;未改生产源码(`src/main` 零改动)。本轮写入内容仅限 `tests/scripts/`(测试资产)与 `docs/tdd/`(报告/通知/台账)。
+
+---
+
+## 2. 历史审查记录(memory 召回)
+
+- 本对象**非首次审查**;自动化 memory 累积至 R285,git 真相补足 R286~R289,本轮以 `def659715`(R289 回填)为基线。
+- 直接前序 **R289**:🟢 lg 43/43 全绿(B-142-2 达标 1/2);🟢 189 首跑 5/5(B-288-1 达标 1/2);🔴 API 首跑 `addA: NON_JSON_RESPONSE` → 15 未执行(B-254-1 销号撤销重开);🔴 复跑 21 红(:56/:116 波动复红,G-286-1 计数重算 0/2);G13 第 90 次零漂移。
+- 历史遗留项本轮复查结论:
+  - **B-142-2(lg 429)**:本文 §6 —— 43/43 连续第 2 轮 → **达标 2/2,建议销号**。
+  - **B-288-1(189 U02 首跑瞬态)**:189 首跑 5/5 连续第 2 轮 → **达标 2/2,建议销号**。
+  - **B-254-1(网关 NON_JSON)**:首跑 **0 未执行** → 收复第 1 轮(需连续 2 轮)。
+  - **G-286-1 / :56 / :116**:本轮双跑呈**严格互斥**(首跑 `:116` 红 `:56` 绿,复跑反之)→ 不再是「随机抖动」,而是同任务行状态耦合;修法从「观察」升级为「测试侧改独立前置 + 研发查事务」(§11 P1-1)。
+  - **B-227-1(匿名越权)**:探针仍 **3/8=200**(第 65 轮),根因 `JwtInterceptor.java:236-243` 未修。
+  - **G-285-1(度量口径三套)**:**本轮定位根因并闭环**(见 §8.2),历史 69.5%/100% 均为「扫描范围漏后端 Java」的产物。
+  - 双端 10+4 红、后端定向 14 红(11F+3E)/7E(微信登录)、legal 6 红 → 承袭未改善。
+- ⚠️ 历史记录仅作对照,本轮结论均重新取证。
+
+---
+
+## 3. 项目画像速览(只读)
+
+| 模块 | 技术栈 | 可测范围 / 关键路径 |
+|---|---|---|
+| `cfc-backend` | Spring Boot 2.7.18 + MyBatis-Plus + Java 8,9082 | `src/main/java` 2,224 文件 / `@RestController` 377 / `@PostMapping` 2,035 / 非 POST 注解 9;`@Test` 文件 521;DDL 唯一入口 `DatabaseInitializer` |
+| `cfc-frontend` | uni-app 小程序(Vue2 Options API) | 48 套 / 679 例 Jest |
+| `cfc-web` | Vue2 + Element UI 管理端 | 22 套 / 160 例 Jest + `--coverage` |
+| `cfc-langgraph` | Python FastAPI + LangGraph + ChromaDB,9000 / 251 节点 | 43 例 pytest(权威副本在 251) |
+| `dan/danshop` | 独立商城 8888 | shop 价格排序契约 4 例 |
+
+**约束依据**:`d:/cfc/AGENTS.md`(接口统一 @PostMapping、禁 GetMapping、DB 迁移流程、小程序禁可选链/Grid、AI 统一走 LangGraph)。
+
+---
+
+## 4. 测试覆盖矩阵(20 类,三态 + 证据)
+
+| # | 类型 | 三态 | 证据 / 说明 |
+|---|---|---|---|
+| 1 | 单元测试 | 已发现 | 双端 Jest 实跑 839 例;后端定向 11 类实跑 |
+| 2 | 测试覆盖率 | 已发现 | cfc-web `coverage-final.json` 实时实测 **11.55%**(263/2278)|
+| 3 | 变异测试 | 未发现 | 未检出变异框架/资产(缺口 GI-3)|
+| 4 | 集成测试 | 已发现 | `EnergySystemFlowTest` / `GuideModuleIntegrationTest` 实跑 |
+| 5 | 接口/API 测试 | 已发现 | `tests/e2e/api/` 26 文件,本轮点名 9 文件实跑 62 例(首跑 + 隔离复跑)|
+| 6 | 契约测试 | 已发现 | `*ContractTest.java` 521 个 @Test 文件的一部分;health/shop/auth/legal 浏览器契约实跑 |
+| 7 | 系统测试 | 待核实 | 无独立系统测试套件台账 |
+| 8 | 端到端测试 | 已发现 | 三节点(189/204/251)+ 本机 6 套浏览器实跑 |
+| 9 | 验收测试(UAT) | 待核实 | 未见 UAT 签署记录 |
+| 10 | 冒烟测试 | 已发现 | 内网 `/admin` `/frontend` 302 + 四通道冒烟 PASS |
+| 11 | 回归测试 | 已发现 | 双端 Jest 逐例零漂移;API 首跑/复跑逐例比对 |
+| 12 | 探索性测试 | 待核实 | 无结构化探索记录 |
+| 13 | 性能测试 | 未发现 | execute 档未授权(未授权未执行)|
+| 14 | 可靠性测试 | 未发现 | 无故障注入/混沌资产 |
+| 15 | 安全测试 | 已发现(子集)| 匿名鉴权探针 10 端点 + JwtInterceptor 只读代码审查;SAST/DAST/依赖漏洞未授权 |
+| 16 | 可用性测试 | 待核实 | 无真实用户可用性证据 |
+| 17 | 兼容性测试 | 已发现 | 双端多视口 + 三节点实跑 + 本机 |
+| 18 | 无障碍测试 | 未发现 | 无 WCAG 用例/扫描 |
+| 19 | BDD 规格 | 待核实 | 无 Gherkin 台账 |
+| 20 | 质量度量/QA 流程 | 已发现 | 本闭环 + 汇报模板;**G-285-1 本轮闭环(脚本入库)** |
+
+> 「未发现」= 本轮扫描未命中,不代表项目未做;扫描未覆盖处标「待核实」。
+
+---
+
+## 5. 测试方案与执行档
+
+- **目标**:① 承接 R289 基线做零-change 回归;② 复核 B-142-2 / B-288-1 连续第 2 轮达标(销号判定);③ B-254-1 收复第 1 轮验证;④ **闭环 G-285-1:把三套不可复现的覆盖口径收敛成单一脚本**;⑤ 维持首跑+复跑双跑取证。
+- **范围**:窗口 `def659715..origin/cfclub`(1 commit docs-only);全量双端 Jest、后端 test-compile + 定向 11 类、189/204/251 三节点、本机 6 套浏览器、线上 API 红链 9 文件(首跑 + 复跑)、匿名探针 10 端点、覆盖率实测、SC 覆盖率三口径脚本化。
+- **覆盖维度**:全 20 类评估;执行层聚焦 #1/#2/#4/#5/#8/#10/#11/#15/#17/#20。
+- **排除项**:公网依赖漏洞扫描、性能压测、DAST、后端全量连库 + JaCoCo(本机 9082 未起)、变异/可靠性/无障碍。
+- **执行档**:review(内网已授权,公网未授权)。全程静默无提问。
+
+---
+
+## 6. 本轮实测结果(真实本地数据)
+
+| 项 | 结果 | vs R289 / 判定 |
+|---|---|---|
+| **线上网关健康** | `direct-register` **200**(0.029s);`user/info` **401**;`GET /admin`·`/frontend` **302** | 🟢 基线稳定(第 6 轮)|
+| **节点探活** | 189:4090 ✅ / 204:4091 ✅ / 251:4096 ✅ / 本机 9082 ❌(B-36 承袭)| 持平 |
+| **cfc-web Jest** | 22 套 / 160 例 = **150 过 / 10 红 / 0 跳**(EXIT1)| 逐例零漂移 |
+| **cfc-frontend Jest** | 48 套 / 679 例 = **663 过 / 4 红 / 12 跳**(EXIT1)| 逐例零漂移 |
+| **cfc-web 覆盖率** | **Stmts 11.55%** / Branch 8.65% / Func 8.68%(263/2278,实时 `coverage-final.json`)| 逐位同 R289,< 20%(G9 未达标)|
+| **backend `mvn -o -q test-compile`** | EXIT **0**(2m05s)| B-203-5 持续闭环 |
+| **backend 定向 8 类(主批)** | **38 = 11F + 3E + 1 跳**:BeanGuard 1F / Energy 6F+1跳 / Guide 1E / OrchestrationEngine 1F / OrchestrationIntegration 1F / MembershipPay 1F / PaymentORD 1F / WebConfig 2E | 逐类零漂移(**B-218-1 第 68 轮,G13 第 91 次**)|
+| **backend 微信登录 2 类(补批)** | **11 = 7E**(`UserServiceWechatLoginTest` 5/3E + `...ContractTest` 6/4E)| 逐类零漂移 |
+| **189 admin-desktop E2E** | **5/5 首跑全绿 EXIT=0**(1.3m,HEAD `def659715`,DIRTY=173)| 🟢 **B-288-1 连续第 2 轮首跑 5/5 → 达标 2/2 可销号** |
+| **204 frontend-mobile E2E** | **6/6 EXIT=0**(58.7s,HEAD `def659715`)| 🟢 连续第 **29** 轮 |
+| **251 langgraph pytest** | **43 = 43 过 / 0 红**(217.21s,8 warnings,HEAD `def659715`,collect 43/0 error)| 🟢 **B-142-2 连续第 2 轮 43/43 → 达标 2/2 可销号**;`EXIT=124` 收尾挂起(B-224-5 第 44 轮)|
+| health-contract(本机) | **13/13** | 持平 |
+| **shop-api 契约(本机)** | **4/4 绿**(7.6s)| 🟢 连续第 6 轮首跑全绿 |
+| admin-desktop(本机) | **5/5**(2.0m)| 持平 |
+| frontend-mobile(本机) | **6/6**(1.1m)| 持平 |
+| legal-pages(本机) | **0/6** | 持平(B-260-1 第 23 轮)|
+| auth-guard(本机) | **10 = 7 过 / 3 红**(24.9s)| 持平(B-227-1 第 65 轮)|
+| dx-bridge(本机) | 2 跳(端点 404)| 持平(B-281-1 延续)|
+| 本机 live 小计 | **22 过 / 9 红 / 2 跳**(shop 4/4、admin 5/5、fe 6/6、legal 0/6、auth 7/3、dx 2 跳)| 与 R289 完全一致(G13)|
+| **线上 API 红链 9 文件** | 首跑 **62 = 41 过 / 21 红 / 0 未执行**(10.4m)→ 复跑 **62 = 41 过 / 21 红 / 0 未执行**(10.7m) | 🟢 **两轮均 0 未执行**(B-254-1 收复第 1 轮);**20 例稳定红首/复跑逐例一致**;`:56`/`:116` 严格互斥对换(见 §7)|
+| **匿名鉴权探针 10 端点** | **3/8=200**(`notification/list`、`notification/read`、`search/global`)+ 5 对照 401 + 2 parse-monitor 401 | 🔴 B-227-1 第 65 轮未修 |
+| **SC 覆盖率三口径(新脚本)** | L1 台账三流 **223/243=91.8%** / L2 执行资产引用 **218/243=89.7%** / L3 需求回链 **20/227=8.8%** | 🟢 **G-285-1 闭环**(可复现,见 §8.2)|
+
+- 工具链:JDK 1.8.0_25 / Maven 3.9.9 / node 22.22.2 / Python 3.11(251)/ Playwright 1.63.0 + 系统 chrome。
+- 用例合计(去重):Jest **839**(813 过 / 14 红 / 12 跳)+ 三节点 E2E **17** + 本机浏览器 **33** + 线上 API **62** + 匿名探针 **10** + 后端定向 **49**。
+
+---
+
+## 7. 回归与闭环判定
+
+- **窗口变更**:`def659715..origin/cfclub` = 1 commit(R289 报告回填 sha,仅 2 个 md 文件共 3 行)→ **SRS 闸门 CLOSED**,无需更新用例。
+- **API 双跑结果(62 例)**:首跑 **41/21/0**、复跑 **41/21/0**,两轮均 **0 未执行**。
+- **20 例稳定红(首/复跑逐例同名同位置,零漂移)**:`badge:73`、`badge:80`、`coach-food:18`、`coach-food:38`、`energy-api:131`、`incentive:27`、`incentive:61`、`task-c14:38`、`task-c14:82`、`task-c14:108`、`task-c14:175`、`task-c14:191`、`task-checkin:34`、`task-checkin:46`、`task-checkin:53`、`wish-flow:89`、`wish-flow:128`、`wish-flow:175`、`wish-flow:229`、`wish-flow:262`。
+- **★ `:56`/`:116` 本轮双跑严格互斥(G-286-1 新证据)**:首跑 `:116`(幂等)红、`:56`(今日列表可见)绿;复跑 `:56` 红、`:116` 绿 —— **同一轮内恰好一红一绿**。这说明二者不能各自独立判读,历史上「双红/双绿/首红复绿」的翻转,很可能不是两个独立缺陷各自抖动,而是同一任务行状态的耦合表现(**因果方向待研发日志核实**:究竟是 `:116` 的幂等前置创建影响 `:56` 的可见性,还是 `:56` 先取走任务行导致 `:116` 幂等命中 0 条)。测试侧处置:改为各自独立 `beforeAll` 前置,使二者可分开判读。
+- **与 R289 口径差异(重要)**:R289 红链分母 **59**,本轮 **62**(本轮把 `energy-api.spec.js` 显式并入红链文件集,其 3 例此前不在统计内)→ **跨轮红数不可直接相减**。本轮结论只用「同轮首跑 vs 复跑」内部比对:20 例稳定红零漂移 + `:56`/`:116` 互斥对换,**新增真实红 0 例**。
+- **B-254-1 收复第 1 轮**:两轮均 **0 未执行**(R289 首跑 15 未执行)→ 网关本轮健康;需连续 2 轮方可再销号。
+- **B-142-2 达标 2/2**:43/43 连续两轮(R289 258.60s → R290 217.21s),无 429。
+- **B-288-1 达标 2/2**:189 首跑 5/5 连续两轮。
+- **零新增代码回归**:双端 Jest 10+4 红、后端定向 11 类 14 红 + 7E、本机 legal 6 / auth 3 红与 R289 逐例一致。
+- **提示注入扫描**:specs/需求文档命中项均为对 `system prompt` 的正常技术描述,非真实注入 → 无命中。
+
+---
+
+## 8. 测试用例编写产出(依据 SRS 与需求变更)
+
+### 8.1 SRS/场景变更闸门:**CLOSED**
+
+- `git diff --name-only def659715..HEAD` 对 `SRS.md` / `docs/需求分析/**` / `docs/superpowers/specs/**` / `API_REFERENCE.md` / `tests/test-cases/**` / `tests/user-scenarios/**` **零命中**;
+- `git log --since="26 hours ago"` 于同路径集合 **零命中**;
+- **结论:本次无需求/场景变更 → 按纪律跳过用例编写**,未改生产源码。
+
+### 8.2 G-285-1 闭环:SC 覆盖率三口径脚本入库(本轮唯一新增测试资产)
+
+**问题**:历史报告出现三套互不相容的覆盖率(91.8% / 69.5% / 8.8%),另有 246/246=100% 口径,分母不可复现,导致「覆盖是否达标」无法审计(第 5 轮挂账)。
+
+**根因(本轮定位)**:差异不是算错,而是**扫描范围不同**:
+
+| 口径 | 扫描范围 | 实测 | 性质 |
+|---|---|---|---|
+| 台账三流 | 仅 `tests/test-cases/*.md` 台账 | **223/243 = 91.8%** | 文档侧口径,可复现 ✅ |
+| 历史「69.5%」 | 前端执行资产 + **误把用例台账 md 当执行资产** | 171/243 = 70.4% | 口径污染 ❌ |
+| 历史「246/246」 | **扫全 `tests/` 目录(含台账 md)** | 243/243 = 100% | 恒真,无意义 ❌ |
+| **正确 L2** | 前端 + 浏览器 + **后端 `cfc-backend/src/test/java`** 执行资产 | **218/243 = 89.7%** | 执行侧口径 ✅ |
+| 需求回链 | `docs/需求分析` + `specs` 文档 | **20/227 = 8.8%** | 需求文档反向链接率(与覆盖无关)✅ |
+
+> 关键发现:历史把 L2 只按**前端**资产算,漏掉 `cfc-backend/src/test/java`(SC 的主要承载方)→ 后端契约已覆盖的 SC 被误判「未覆盖」,这是 69.5% 与 100% 两套数字的真正成因。补上后端后 L2 由 20.2% 变为 **89.7%**。
+
+**产出**:新增 `tests/scripts/sc-coverage.js`(只读、幂等、`--json` 可机读),固定三列口径并内置两列「历史误用诊断」,任何人无法再把台账 md 或全目录扫描混入达标口径。复跑两次输出逐位一致。
+
+### 8.3 遗留覆盖缺口(新增观察)
+
+L1 缺三流 20 个 SC 中:**16 个同时无任何执行资产引用**(`SC-A-9/11/12/13/14/15`、`SC-P-4/6/8/9/15/16`、`SC-T-9/10/11/12`)→ 详见 §9 G-290-1;**4 个有 spec 但未登记台账三流**(`SC-C-5`、`SC-P-12/14/18`)→ 台账登记缺口,非执行缺口。
+
+---
+
+## 9. 覆盖缺口清单
+
+| 缺口类型 | 现状 | 风险 | 建议测试设计 | 优先级 | 闭环方式 |
+|---|---|---|---|---|---|
+| **G-290-1 零执行资产 SC(新)** | 16 个 SC 既无台账三流也无任何执行资产引用(A 域运营治理 6 个、P 域积分/商城 6 个、T 域规划师 4 个)| 「台账标 RED/未跑通」但无自动化守卫,回归无法发现退化 | 按域分 3 批补:① P 域积分流水对账(SC-P-15/16,`points.ledger.view` 已有契约可复用);② T 域 DAN 报告(SC-T-11/12,`AssessmentRecord`/`DanReport` 契约在库);③ A 域运营治理 6 个(admin 契约齐全,补 API 级 spec 即可)| **P1** | 16 个 SC 各有 ≥1 个可执行 spec 且运行时能引用 SC 编号 |
+| **G-290-2 台账登记缺口(新)** | `SC-C-5`/`SC-P-12`/`SC-P-14`/`SC-P-18` 有执行 spec 但台账无三流 TC 行 | 覆盖被低估,销号判定失真 | 按 spec 实际断言补登 TC-x/-E/-P 三行(不得凭空加行)| P2 | L1 由 223 升至 227 |
+| 任务域波动(G-286-1 延续)| 本轮双跑 `:116`/`:56` **严格互斥**(各红一次);十轮红绿翻转不收敛 | 任务主链路回归信号不可信 | 两例改独立前置 + 任务域最小闭环套件,双跑全绿才算绿 | **P1** | 连续 3 轮双跑全绿 + B-275-1 消失 |
+| 网关间歇 NON_JSON(B-254-1)| 首跑 **0 未执行**(收复 1/2)| 回归随机失真 | 维持双跑兜底 + 探活前置 | **P1** | 连续 2 轮首跑 0 未执行 |
+| 匿名越权(B-227-1)| 3/8=200(第 65 轮),根因 `JwtInterceptor.java:236-243` | 匿名读通知/搜索 | 两族路径补入 `LOGIN_REQUIRED_PATHS` | **P0** | U01~U03 转绿 + 探针 0/8=200 |
+| 覆盖率不足(G9)| 11.55% < 20%(逐位同 R289)| 分支/交互未测 | 为 S1-1 契约红点补分支用例 | P1 | ≥20% 连续 2 轮 + CI 卡口 |
+| 后端全量连库(G7)| 本机 9082 未起,未实测 | 未连库核实真红 | 起 9082 + MySQL 后 `mvn test` + JaCoCo | P1 | 全量报告 + 覆盖率归档 |
+| 法务页生产 404(B-260-1)| legal 0/6(第 23 轮)| 上架审核 URL 不可用 | 发布仓库 `web/` 到生产静态根 | **P1** | 6/6 绿 |
+| lg 429(B-142-2)| **43/43 连续 2 轮 → 达标 2/2** | — | 保持配额稳定 | P1 | **建议销号** |
+| 189 U02(B-288-1)| **首跑 5/5 连续 2 轮 → 达标 2/2** | — | — | P2 | **建议销号** |
+| 变异/可靠性/无障碍/性能 | 未发现或未实测 | 质量维度空白 | 分档引入(需 execute 授权)| P2 | 各维度有基线与门禁 |
+
+---
+
+## 10. 域结论表
+
+| 审查维度 | 负责专家 | 结论 | 关键证据 |
+|---|---|---|---|
+| 单元·组件级 | 苏雅 | 绿(零漂移)| web 150/160、fe 663/679;14 红逐例一致 |
+| 集成·接口级 | 柯砚 | 有条件绿 | 后端 compile EXIT0 + 定向 11 类逐类零漂移;API 首跑 41/21/0,21 红均为存量域,逐例列于 §7 |
+| 系统·验收级 | 白樾 | 降级 | 四通道冒烟 PASS;UAT/BDD 待核实 |
+| 测试保障级 | 闻朔 | 稳态 + | 双跑取证有效;双跑均 0 未执行(网关健康);20 例稳定红零漂移;`:56`/`:116` 严格互斥(非随机抖动)|
+| 性能·可靠性 | 骆骋 | 未实测 | execute 公网未授权,给测试设计 |
+| 安全 | 关屿 | 🔴 不通过(根因已定位未修)| 匿名 3/8=200 第 65 轮;`JwtInterceptor.java:236-243` |
+| 兼容·体验 | 阮清 | 绿 | 三节点 + 本机多视口 PASS;189 首跑 5/5 连续 2 轮 |
+| 流程·度量·代码 | 何序 | 🟢 改善 | **G-285-1 闭环:三口径脚本入库、根因定位**;G11 CI 清单仍失真;覆盖率 11.55% 零漂移 |
+
+---
+
+## 11. 五要素问题清单
+
+### P0-1 匿名可读通知与全局搜索(B-227-1,第 65 轮 · 根因 R285 已定位,待落补丁)
+1. **问题描述**:无 Authorization 请求 `/api/notification/list`、`/api/notification/read`、`/api/search/global` 均返回 code=200(探针 3/8=200 + auth-guard 3 红双证);其余 5 个私有对照端点与 2 个 parse-monitor 端点均正确 401。
+2. **测试 bug 点**:`tests/e2e-live/auth-anonymous-guard.spec.js`(TC-AU-U01/U02/U03,缺陷守卫保持红);探针 `tests/_r288_anon_probe.cjs` → `.r290_anon_probe.log`。
+3. **最优修改方案**:将 `/api/notification`、`/api/search` 两族路径补入 `JwtInterceptor.LOGIN_REQUIRED_PATHS`(`cfc-backend/src/main/java/com/etotem/cfc/config/JwtInterceptor.java:236-243`),或对两控制器加匿名守卫。
+4. **修改目的**:满足鉴权门禁 G8,消除匿名越权读取通知与全局搜索聚合数据风险。
+5. **闭环方式**:auth-guard U01~U03 转绿 + 匿名探针 0/8=200 即通过。
+
+### P0-2 POST /api/tasks/{id}/complete 稳定 500(B-275-1,第 16 轮)
+1. **问题描述**:任务完成链路持续返回业务 500,本轮命中 `energy-api:131`(完整能量收支流程)、`task-c14:38/82/108/175/191`、`incentive:27/61`、`wish:89`,跨 4 个 spec。
+2. **测试 bug 点**:`tests/e2e/api/task-c14-reject-recycle.spec.js:38/82/108/175/191`、`incentive-loop-sc-x05.spec.js:27/61`、`wish-flow-sc-p13-p14-c04.spec.js:89`、`energy-api.spec.js:131`。
+3. **最优修改方案**:定位 `TaskService` 完成分支的积分入账事务与统计更新(建议加事务边界日志),业务校验失败统一改 400(与 B-280-1 一并修)。
+4. **修改目的**:恢复任务→积分主流程,消除 C-02/C-14/X-05 场景阻断。
+5. **闭环方式**:上述用例复跑全绿且不再出现 body code=500。
+
+### P1-1 任务创建 :56/:116 严格互斥(G-286-1 · B-267-1,第 68 轮 · 本轮给出新定性)
+1. **问题描述**:首跑 `:116`(重复创建幂等,期望 1 实得 0)红、`:56`(任务出现在 B 今日列表)绿;复跑 `:56` 红、`:116` 绿。**每轮恰好一红一绿,从不双绿也从不双红**,十轮内表现为「双红/双绿/首红复绿」的表象翻转。
+2. **测试 bug 点**:`tests/e2e/api/task-create-scp10.spec.js:56` 与 `:116`(同 spec 内共享任务行状态)。
+3. **最优修改方案**:① 研发侧排查任务创建的事务一致性与幂等键唯一约束(与 B-275-1 同批定位);② **测试侧把两者改为「显式独立前置」**(各自 `beforeAll` 建独立任务、不复用同一 spec 的创建结果),使二者可独立判读——这是本轮新证据直接推出的修法。
+4. **修改目的**:让任务域回归信号可信;当前互斥意味着「必有一红」被误读成「波动随机」,掩盖了真实的创建/可见性耦合。
+5. **闭环方式**:两例连续 3 轮双跑全绿 + B-275-1 同时消失方可销号。
+
+### P1-2 网关间歇 NON_JSON(B-254-1 · 收复第 1 轮)
+1. **问题描述**:R289 首跑 15 未执行(`addA: NON_JSON_RESPONSE`);本轮首跑 **0 未执行**,网关探活 200/401/302 正常。
+2. **测试 bug 点**:(原)API 首跑 error-context;本轮无命中,`.r290_api_redchain.log` 为证。
+3. **最优修改方案**:维持首跑+复跑双跑与 `direct-register` 探活前置;运维侧继续观察注册接口间歇非 JSON。
+4. **修改目的**:让 API 回归验证不被网关瞬态随机失真。
+5. **闭环方式**:连续 2 轮首跑 0 未执行方可再销号(本轮第 1 轮)。
+
+### P1-3 幂等守卫失效(B-275-2,第 16 轮)
+1. **问题描述**:重复完成同一任务双计分、并发双发兑换申请多次成功。
+2. **测试 bug 点**:`task-c14-reject-recycle.spec.js:108/191`、`incentive-loop-sc-x05.spec.js:61`、`wish-flow-sc-p13-p14-c04.spec.js:175`。
+3. **最优修改方案**:任务完成/心愿兑换加唯一约束或 `SELECT ... FOR UPDATE` + 幂等键(userId+taskId+期次)。
+4. **修改目的**:保护积分/CF 资产一致性。
+5. **闭环方式**:并发用例单次成功、重复提交仅 1 条流水,复跑全绿。
+
+### P1-4 跨家庭/跨成员越权未拒(B-275-3,第 16 轮)
+1. **问题描述**:他人家庭家长可审批/查看本家庭心愿,跨家庭成员可打卡。
+2. **测试 bug 点**:`wish-flow-sc-p13-p14-c04.spec.js:229/262`、`task-checkin-sc-c05.spec.js:53`、`coach-food-sc-b07.spec.js:38`。
+3. **最优修改方案**:服务层统一 familyId + currentMemberId 归属校验,越权统一 403。
+4. **修改目的**:满足横向越权门禁(与 P0-1 同族)。
+5. **闭环方式**:4 例复跑 403/拒绝全绿。
+
+### P1-5 业务校验返 500 / 空名可建件(B-280-1,第 10 轮)
+1. **问题描述**:`badge:73`(传 `name:''`)返回 code=200、`badge:80`(删除不存在勋章)返回 code=200,首跑与复跑**双跑均红**(稳定红,非波动);另有 `wish:89`、`task-frequency:39` 校验失败返回 body code 500。
+2. **测试 bug 点**:`tests/e2e/api/badge-sc-c09-c10-a05.spec.js:73/80`、`wish-flow-sc-p13-p14-c04.spec.js:89`、`task-frequency-sc-p12.spec.js:39`。
+3. **最优修改方案**:入参校验(`@Valid` / 手写)失败统一返回 400 + 明确 message;删除不存在资源返回 404。
+4. **修改目的**:让「校验失败」与「真实异常」可区分,避免缺陷被 500/200 掩盖。
+5. **闭环方式**:上述用例返回 400/404 且双跑稳定绿。
+
+### P1-6 CoachRecommendService Bean 撞名(B-218-1,第 68 轮)
+1. **问题描述**:`ResourceBeanNameCollisionGuardTest` 1/1 红,Spring Bean Name 冲突守卫失败。
+2. **测试 bug 点**:`cfc-backend/src/test/java/com/etotem/cfc/unit/ResourceBeanNameCollisionGuardTest.java`。
+3. **最优修改方案**:冲突类显式 `@Service("xxxCoachRecommendService")` 或重命名一方。
+4. **修改目的**:避免运行期注入错 Bean。
+5. **闭环方式**:守卫 1/1 绿且定向红数由 14 降至 13。
+
+### P1-7 法务页生产 404(B-260-1,第 23 轮)
+1. **问题描述**:`/web/privacy.html`、`/web/agreement.html` 公网 404(legal 0/6),小米 HealthKit 上架审核 URL 不可用。
+2. **测试 bug 点**:`tests/e2e-live/legal-pages-live.spec.js`(TC-L-U01/U02/U05/U06)。
+3. **最优修改方案**:仓库 `web/` 发布到生产静态根(nginx root)或加 rewrite。
+4. **修改目的**:满足应用商店审核「隐私政策/用户协议可达」硬要求。
+5. **闭环方式**:6/6 绿。
+
+### P1-8 cfc-web 覆盖率不足(G9)
+1. **问题描述**:实时实测语句覆盖率 11.55% < 20%(263/2278),逐位同 R289。
+2. **测试 bug 点**:`cfc-web/coverage/coverage-final.json`(实时计算)。
+3. **最优修改方案**:优先为 `Families*` / `FamilyWorkbench` 等红点组件补分支与交互用例。
+4. **修改目的**:提升回归防护网密度。
+5. **闭环方式**:Stmts ≥ 20% 连续 2 轮不回落 + CI 卡口生效。
+
+### P2-1 CI 清单失真(G11,第 84 轮)
+1. **问题描述**:CI 清单与实测红集双向不一致(清单 33 / 实测非环境红 ≈ 21 API + 14 后端 + 6 legal + 3 auth)。
+2. **测试 bug 点**:CI 配置清单(具体文件待核实)。
+3. **最优修改方案**:盘点实际资产重生成清单并纳入门禁。
+4. **修改目的**:使 CI 真实反映覆盖。
+5. **闭环方式**:清单与资产一致且流水线实跑通过。
+
+### P2-2 零执行资产 SC(G-290-1,本轮新增)
+1. **问题描述**:16 个 SC(`SC-A-9/11/12/13/14/15`、`SC-P-4/6/8/9/15/16`、`SC-T-9/10/11/12`)既无台账三流 TC,也无任何执行资产引用其编号。
+2. **测试 bug 点**:`tests/scripts/sc-coverage.js` 的 `l1Miss ∩ l2Miss`(可复跑复现);台账见 `docs/tdd/orchestration/sc-key-map.md` 对应行(状态 RED/未跑通)。
+3. **最优修改方案**:分三批补 API 级 spec(复用 `tests/e2e/api/` 现有 `apiPost` 助手与 fixture);先做 P 域积分流水(`points.ledger.view` 契约已在库)与 T 域 DAN 报告。
+4. **修改目的**:把「台账标红但无守卫」的场景转为可回归资产,避免长期零覆盖。
+5. **闭环方式**:16 个 SC 各有 ≥1 个可执行 spec 且运行时引用 SC 编号,`sc-coverage.js` L2 达 243/243。
+
+---
+
+## 12. 待核实项
+
+- 系统测试 / UAT / 探索性测试 / BDD 是否存在独立台账与签署记录。
+- 变异测试、可靠性(故障注入/恢复演练)、无障碍(WCAG)资产是否存在。
+- G11 CI 清单失真的具体 CI 配置文件路径。
+- 登录态越权深测所需的多角色凭据(无凭据,未实测)。
+- `badge:73/:80` 首跑红→复跑绿:是入参校验缺口还是环境抖动(需研发确认校验分支)。
+- `task-create:56/:116` 波动与 B-275-1 complete 500 是否同一上游事务根因(需研发日志定位)。
+
+---
+
+## 13. 需用户单独授权才能继续的项(未授权未执行 + 测试设计)
+
+| 项 | 状态 | 测试设计 |
+|---|---|---|
+| 公网依赖漏洞扫描(SCA)| 未授权未执行 | OWASP Dependency-Check / npm audit,CVE 阈值门禁 |
+| 性能压测(远端/公网)| 未授权未执行 | /api 核心链路并发阶梯压测,采集 P95/P99、吞吐、错误率 |
+| DAST / 渗透 | 未授权未执行 | OWASP ZAP 基线扫描授权内网目标 |
+| Playwright 公网安装浏览器 | 未授权未执行 | 复用本机系统 chrome(本轮已用)|
+| 登录态越权 E2E 深测 | 待核实(无凭据)| 环境变量注入多角色 token 跑越权矩阵;禁止明文口令入报告 |
+| 后端全量连库 + JaCoCo | 本机服务未起 | 起 9082 + MySQL 后按 AGENTS.md 流程全量跑并采覆盖率 |
+
+---
+
+## 14. 门禁结论与复评条件
+
+**结论:⛔ 不通过(有条件)**
+
+- **通过项**:G3 浏览器三线(204 第 29 轮 6/6 + 本机全套 + 189 首跑 5/5 连续 2 轮)、G4(test-compile EXIT0)、G5(定向 49 例取证)、G6(存量红逐例零漂移)、G10(251 直读兜底)、G12(窗口零变更零新增)、**G13(第 91 次零漂移)**、**G14(本轮改为单一脚本口径,三列可复现)**、SRS 闸门 CLOSED。
+- **销号项**:**B-142-2(lg 43/43 连续 2 轮)**、**B-288-1(189 首跑 5/5 连续 2 轮)** → 达标 2/2。
+- **未达标项**:G2(API 21 非环境红 + 后端 14 红,任务/心愿域为主)、G7(后端全量连库未实测)、**G8(匿名 3/8=200 第 65 轮)**、G9(11.55% < 20%)、G11(CI 清单失真)。
+- **本轮变化判定**:有真实结果变化 → 触发 commit + push + 通知研发:
+  - 🟢 B-142-2 / B-288-1 连续第 2 轮达标(可销号);
+  - 🟢 B-254-1 双跑均 0 未执行(收复 1/2);
+  - 🟢 G-285-1 闭环(脚本入库 + 根因定位:历史 69.5%/100% 系漏扫后端 Java);
+  - 🟡 G-286-1 定性升级(`:56`/`:116` 严格互斥,非随机抖动)。
+- **零新增产品代码缺陷**(红集均为既有缺陷族:B-275-1/2/3、B-280-1、B-227-1、B-260-1、B-218-1)。
+
+**复评条件(满足后可上调至「有条件通过 → 通过」)**:
+1. B-227-1 修复:两族路径纳入 `LOGIN_REQUIRED_PATHS`,auth-guard U01~U03 转绿、探针 0/8=200;
+2. B-275-1/2/3 + B-280-1 修复,API 红集由 21 降至 ≤10,G-286-1 波动收敛(连续 3 轮双跑全绿);
+3. B-254-1 连续 2 轮首跑 0 未执行(本轮已 1/2);
+4. B-260-1 两法务页生产 200,legal 6/6 绿;
+5. G9 覆盖率 ≥20% 连续两轮(实时口径);G-290-1 的 16 个 SC 补齐可执行资产;
+6. G7 后端全量连库 + JaCoCo 归档;G11 CI 清单与资产一致;
+7. 获得 execute 公网授权后补齐安全/性能/依赖漏洞维度。
+
+---
+
+## 15. 收尾证据(commit / push)
+
+- 工作分支 = cfclub;起始 sha `def659715`;结束 sha 见下方回填 commit;`HEAD...origin/cfclub` = `0 0`;PUSH OK。
+- 本轮写入:主报告(本文件)/ 执行纪实 / 研发通知 / 阻塞台账 R290 段 / `tests/scripts/sc-coverage.js`(新资产)。
+- 通知通道:Agent Mail 历轮 `not_bound`「请勿重试」→ 以「仓库通知 + 阻塞台账 + commit message + 推送」四路送达。

+ 26 - 0
docs/tdd/test/blockers.md

@@ -2902,3 +2902,29 @@
 | **G11(P1 · 第 83 轮)** | CI 清单与实测红双向失真 | 研发 | 清单 vs 实测非环境红(复跑 21 + 定向 18 部分重叠 + legal 6 + auth 3)| 测试 | 2026-11-18 07:0x | 待处理 |
 | **G7(P2 · 后端口径)** | 后端全量连库未实测 | 测试 | 本机 9082 未起,全量 `mvn test` + JaCoCo 未执行 | 测试 | 2026-11-18 07:0x | 待处理 |
 | **R289 段 · 门禁** | lg 全绿 + 189 首跑恢复 + 网关 NON_JSON 回潮 + :56/:116 复红 | 测试 | **不通过(有条件)**。✅ G3(189首跑5/5+204第28轮6/6+本机)/ G4 / G6(19 存量红逐例零漂移,差集仅 :56/:116)/ G10 / G12 / **G13 第90次** / B-142-2 达标1/2;⚠️ G7 未实测 / G9 11.55% / G14 口径;❌ **G2(首跑 15 瞬态未执行 + 复跑 21 非环境红 + :56/:116 波动)** / **G8(匿名 3/8=200 第 64 轮)** / G11。零新增产品代码缺陷 | 测试 | 2026-11-18 07:1x | 不通过 |
+
+---
+
+### R290 段(2026-11-18 07:0x ~ 07:4x)
+
+> 窗口 1 commit(`def659715` R289 回填 sha,仅 docs 3 行,零 src / 零 SRS / 零用例)→ 零-change 承采轮 + 度量口径闭环。独立实测 189/204/251/本机四通道、双端 Jest、后端定向 11 类、线上 API 红链 9 文件(首跑 + 复跑)、匿名探针 10 端点、覆盖率实测、SC 三口径脚本。**🟢 251 lg 43/43 连续第 2 轮(B-142-2 达标 2/2 可销号)**;**🟢 189 admin 首跑 5/5 连续第 2 轮(B-288-1 达标 2/2 可销号)**;**🟢 线上 API 双跑均 0 未执行(B-254-1 收复 1/2)**;**🟢 G-285-1 度量口径闭环(`tests/scripts/sc-coverage.js` 入库;历史 69.5%/100% 系漏扫后端 Java)**;🟡 `task-create` 的 `:56`/`:116` 双跑严格互斥(G-286-1 定性升级);API 双跑 21 红中 20 例逐例零漂移;G13 第 91 次零漂移;零新增真实红/零新增产品代码缺陷。
+
+| 编号 | 主题 | 类型 | 描述 | 经办 | 登记时间 | 状态 |
+|---|---|---|---|---|---|---|
+| **B-142-2(P1 · 🟢 达标 2/2)** | lg 上游 AgnesAI 429 | 运维/供应商 | 251 = **43 过 / 0 红**(217.21s,collect 43/0 error,HEAD `def659715`),无 429;**连续第 2 轮 43/43** → 建议销号(下轮仍绿即关闭)| 测试 | 2026-11-18 07:2x | **建议销号(达标 2/2)** |
+| **B-288-1(P2 · 🟢 达标 2/2)** | 189 admin U02 首跑瞬态 | 测试 | **189 首跑 5/5 全绿**(1.3m,HEAD `def659715`,DIRTY 173);连续第 2 轮首跑 5/5 → 建议销号 | 测试 | 2026-11-18 07:1x | **建议销号(达标 2/2)** |
+| **B-254-1(P1 · 收复 1/2)** | 网关间歇 NON_JSON | 运维 | **首跑与复跑均 0 未执行**(R289 = 15 未执行);网关探活 200/401/302/302 全通 → 收复第 1 轮,连续 2 轮 0 未执行方可销号 | 运维 | 2026-11-18 07:2x | 观察(收复第 1 轮)|
+| **G-285-1(P2 · 🟢 已闭环)** | SC 覆盖度量口径三套不一致 | 测试 | 新增 `tests/scripts/sc-coverage.js` 固定三口径:L1 台账三流 **223/243=91.8%** / L2 执行资产引用 **218/243=89.7%** / L3 需求回链 20/227=8.8%;诊断列证明历史 69.5%≈70.4%(误含台账 md)、100%≈243/243(扫全 tests/);**根因 = 历史 L2 漏扫 `cfc-backend/src/test/java`** | 测试 | 2026-11-18 07:2x | **已闭环(复跑两次逐位一致)** |
+| **G-290-1(P1 · 新增)** | 16 个 SC 零执行资产 | 测试/研发 | `SC-A-9/11/12/13/14/15`、`SC-P-4/6/8/9/15/16`、`SC-T-9/10/11/12` 既无台账三流 TC 也无任何执行资产引用编号(台账标 RED/未跑通);`sc-coverage.js` 的 l1Miss∩l2Miss 可复现 | 测试 | 2026-11-18 07:2x | 待处理(建议分三批补 API spec)|
+| **G-290-2(P2 · 新增)** | 4 个 SC 台账未登记 | 测试 | `SC-C-5`/`SC-P-12`/`SC-P-14`/`SC-P-18` 有执行 spec 但台账无三流 TC 行 → L1 被低估(非执行缺口)| 测试 | 2026-11-18 07:2x | 待处理 |
+| **B-275-1(P0 · 第 16 轮)** | `POST /api/tasks/{id}/complete` 稳定 500 | 研发 | 本轮回潮扩面:`energy-api:131`(完整能量收支流程 500)新入红集;连同 c14:38/82/108/175/191、incentive:27/61、wish:89 共 9 处 | 测试 | 2026-11-18 07:3x | 待处理 |
+| **B-280-1(P1 · 第 10 轮)** | 业务校验返 500 / 空名可建件 | 研发 | `badge:73`(name 空)/`badge:80`(删不存在)**双跑均返 code=200**(稳定红,非波动);`wish:89`、`task-frequency:39` 校验仍返 body code 500 | 测试 | 2026-11-18 07:3x | 待处理 |
+| **G-286-1 / B-267-1(P1 · 第 68 轮 · 定性升级)** | 任务创建 `:56`/`:116` 严格互斥 | 研发 | 首跑 `:116` 红 `:56` 绿、复跑 `:56` 红 `:116` 绿 → **每轮恰一红一绿**,二者耦合同一任务行状态,不是随机抖动;修法:测试侧改独立 `beforeAll` 前置 + 研发查创建事务/幂等键 | 测试 | 2026-11-18 07:3x | 观察(已定性,待改前置)|
+| **B-227-1(P0 · 第 65 轮)** | 匿名可访问 3 私有接口 | 研发 | 探针 **3/8=200**(notification/list、notification/read、search/global)+ auth-guard 10=7/3 持平;`JwtInterceptor.java:236-243` 未收录两族路径(R285 定位)| 测试 | 2026-11-18 07:1x | 待处理(修法已明确)|
+| **B-260-1(P1 · 第 23 轮)** | 法务页生产 404 | 运维/研发 | legal 0/6 续红(`/web/privacy.html`、`/web/agreement.html` 404)| 测试 | 2026-11-18 07:1x | 待处理 |
+| **B-218-1(P0 · 第 68 轮)** | `CoachRecommendService` Bean 撞名 | 研发 | `ResourceBeanNameCollisionGuardTest` 1/1 红(定向逐类零漂移 11F+3E+1跳)| 测试 | 2026-11-18 07:1x | 待处理 |
+| **G9(P1 · 第 16 轮)** | cfc-web 覆盖率 < 20% | 研发 | 实时 `coverage-final.json`:**11.55%**(263/2278)/ Branch 8.65% / Func 8.68%,逐位同 R289 | 测试 | 2026-11-18 07:1x | 待处理 |
+| **B-224-5(P1 · 第 44 轮)** | lg pytest 会话壳 failed / `EXIT=124` 收尾挂起 | 研发/平台 | 本轮会话壳 5s 即 outcome=failed → **改走 opencode SHELL 直跑 pytest 成功取回**(43 passed / 217.21s);`EXIT=124` 但摘要完整 = 收尾挂起非超时未跑 | 测试 | 2026-11-18 07:2x | 待处理(已兜底)|
+| **G11(P1 · 第 84 轮)** | CI 清单与实测红双向失真 | 研发 | 清单 vs 实测非环境红(API 21 + 后端 14 + legal 6 + auth 3,部分重叠)| 测试 | 2026-11-18 07:3x | 待处理 |
+| **G7(P2 · 后端口径)** | 后端全量连库未实测 | 测试 | 本机 9082 未起,全量 `mvn test` + JaCoCo 未执行 | 测试 | 2026-11-18 07:3x | 待处理 |
+| **R290 段 · 门禁** | 双销号达标 + 网关收复 + 度量口径闭环 | 测试 | **不通过(有条件)**。✅ G3(189 首跑 5/5 连续 2 轮 + 204 第 29 轮 6/6 + 本机 22/9/2)/ G4 / G5(定向 49 例)/ G6(存量红零漂移)/ G10 / G12 / **G13 第 91 次** / G14(脚本口径);⚠️ G7 未实测 / G9 11.55%;❌ G2(API 21 红 + 后端 14 红 + 7E)/ **G8(匿名 3/8=200 第 65 轮)** / G11。零新增产品代码缺陷 | 测试 | 2026-11-18 07:4x | 不通过 |

+ 162 - 0
tests/scripts/sc-coverage.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+/**
+ * SC 覆盖率三口径统一脚本(G-285-1 闭环资产)
+ * ============================================================
+ * 背景:历史报告出现过三套互不相容的覆盖率数字(91.8% / 69.5% / 8.8%),
+ *       分母不可复现,导致「覆盖是否达标」无法审计。本脚本固定三列口径,
+ *       每轮只跑这一个命令即可得到可复现、可比的数字。
+ *
+ * 三列口径(分母口径各不相同,禁止混用):
+ *   L1 台账三流     —— 分母 = sc-key-map.md 登记的全部 SC;
+ *                      分子 = 三流 TC(TC-x / TC-x-E / TC-x-P)在
+ *                      tests/test-cases/*.md 台账中同时存在的 SC 数。
+ *   L2 执行资产引用 —— 分母同上;
+ *                      分子 = 至少被 1 个可执行资产(tests/e2e/**、tests/e2e-live/**、
+ *                      cfc-web/src/__tests__/**、cfc-frontend 测试目录)以 SC 编号
+ *                      显式引用的 SC 数。注意:引用 ≠ 断言覆盖,仅表示有资产挂靠。
+ *   L3 需求回链     —— 分母 = docs/需求分析/*.md + docs/superpowers/specs/*.md 文件数;
+ *                      分子 = 正文中出现任意 SC 编号的文件数。
+ *
+ * 用法:node tests/scripts/sc-coverage.js [--json]
+ * 只读,不写任何文件;退出码恒为 0(度量脚本不做门禁判定)。
+ */
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '../..');
+const rd = (p) => fs.readFileSync(path.join(ROOT, p), 'utf8');
+const exists = (p) => fs.existsSync(path.join(ROOT, p));
+
+// 编号归一:SC-P-010 / SC-P-10 视为同一场景;TC 侧同规则(台账存在 TC-P-10 与 TC-P-010 两种写法)
+const NORM_ID = (s) => {
+  const m = /^(SC|TC)-([A-Z]+)-0*(\d+)(.*)$/.exec(s);
+  return m ? `${m[1]}-${m[2]}-${m[3]}${m[4]}` : s;
+};
+const NORM = NORM_ID;
+
+function walk(dir, acc = []) {
+  const abs = path.join(ROOT, dir);
+  if (!fs.existsSync(abs)) return acc;
+  for (const e of fs.readdirSync(abs, { withFileTypes: true })) {
+    if (e.name === 'node_modules' || e.name.startsWith('.')) continue;
+    const rel = path.posix.join(dir, e.name);
+    if (e.isDirectory()) walk(rel, acc);
+    else acc.push(rel);
+  }
+  return acc;
+}
+
+// ---------- 台账:sc-key-map.md ----------
+const KM_PATH = 'docs/tdd/orchestration/sc-key-map.md';
+if (!exists(KM_PATH)) {
+  console.error(`FATAL 缺少场景台账 ${KM_PATH}`);
+  process.exit(0);
+}
+const kmRaw = rd(KM_PATH).match(/\|\s*(SC-[A-Z]+-\d+)\s*\|/g) || [];
+const km = new Set(kmRaw.map((c) => NORM(c.replace(/\|/g, '').trim())));
+
+// ---------- L1:三流 TC 台账 ----------
+const tcFiles = (fs.existsSync(path.join(ROOT, 'tests/test-cases'))
+  ? fs.readdirSync(path.join(ROOT, 'tests/test-cases'))
+      .filter((f) => f.endsWith('.md'))
+      .map((f) => `tests/test-cases/${f}`)
+  : []);
+const tc = new Set();
+for (const f of tcFiles) {
+  for (const m of rd(f).matchAll(/^\|\s*(TC-[^\s|]+)\s*\|/gm)) tc.add(NORM_ID(m[1]));
+}
+const l1Hit = [...km].filter((s) => {
+  const base = s.replace('SC-', 'TC-');
+  return tc.has(base) && tc.has(base + '-E') && tc.has(base + '-P');
+});
+
+// ---------- L2:执行资产引用 ----------
+// 口径要点:执行资产 = 真正可运行的测试代码,含
+//   · tests/e2e/**(线上 API 级)
+//   · tests/e2e-live/**(浏览器契约/UI)
+//   · cfc-web/src/__tests__/**(管理端单测)
+//   · cfc-frontend 测试目录(小程序单测)
+//   · cfc-backend/src/test/java/**(后端契约/集成/单测,SC 的主要承载方之一)
+// ⚠️ 必须含后端 Java:历史把 L2 只按前端资产算(漏 cfc-backend/src/test/java),
+//    导致「后端契约已覆盖」的 SC 被误判为未覆盖,是 69.5% 与 100% 两套口径的成因之一。
+const ASSET_DIRS = ['tests/e2e', 'tests/e2e-live', 'cfc-web/src/__tests__', 'cfc-frontend', 'cfc-backend/src/test/java'];
+const ASSET_SKIP = ['cfc-frontend/node_modules'];
+const assetFiles = ASSET_DIRS.flatMap((d) => walk(d))
+  .filter((f) => /\.(js|cjs|mjs|ts|vue|java)$/.test(f))
+  .filter((f) => !ASSET_SKIP.some((s) => f.startsWith(s)));
+const refMap = new Map(); // SC -> [files]
+for (const f of assetFiles) {
+  const txt = rd(f).match(/\bSC-[A-Z]+-\d+\b/g) || [];
+  for (const raw of txt) {
+    const k = NORM(raw);
+    if (!km.has(k)) continue;
+    if (!refMap.has(k)) refMap.set(k, []);
+    if (!refMap.get(k).includes(f)) refMap.get(k).push(f);
+  }
+}
+const l2Hit = [...km].filter((s) => refMap.has(s));
+
+// ---------- L2 诊断口径(用于解释历史 69.5% / 100% 的来源,禁止作为达标口径)----------
+// 历史误用 1:把用例台账 md 当成「执行资产」→ 约 70%(69.5% 即此口径)
+// 历史误用 2:扫全 tests/ 目录(含台账)→ 恒 100%(246/246 即此口径)
+function scanRefs(dirs, filter) {
+  const set = new Set();
+  for (const d of dirs) {
+    for (const f of walk(d).filter(filter)) {
+      for (const raw of rd(f).match(/\bSC-[A-Z]+-\d+\b/g) || []) {
+        const k = NORM(raw);
+        if (km.has(k)) set.add(k);
+      }
+    }
+  }
+  return set.size;
+}
+const isCode = (f) => /\.(js|cjs|mjs|ts|vue)$/.test(f);
+const isMd = (f) => f.endsWith('.md');
+const diag = {
+  withLedgerMd: scanRefs(ASSET_DIRS.concat(['tests/test-cases']), (f) => isCode(f) || isMd(f)),
+  wholeTestsDir: scanRefs(['tests'], (f) => isCode(f) || isMd(f) || f.endsWith('.py')),
+};
+
+// ---------- L3:需求回链 ----------
+const reqDirs = ['docs/需求分析', 'docs/superpowers/specs'];
+const reqFiles = reqDirs.flatMap((d) => walk(d)).filter((f) => f.endsWith('.md'));
+const l3Hit = reqFiles.filter((f) => /\bSC-[A-Z]+-\d+\b/.test(rd(f)));
+
+const pct = (a, b) => (b === 0 ? '0.0' : ((a / b) * 100).toFixed(1));
+const out = {
+  generatedAt: new Date().toISOString(),
+  caliber: {
+    L1_ledger_three_stream: { hit: l1Hit.length, total: km.size, pct: pct(l1Hit.length, km.size) },
+    L2_executable_asset_ref: { hit: l2Hit.length, total: km.size, pct: pct(l2Hit.length, km.size) },
+    L3_requirement_backlink: { hit: l3Hit.length, total: reqFiles.length, pct: pct(l3Hit.length, reqFiles.length) },
+  },
+  inventory: {
+    scInKeyMap: km.size,
+    tcUnique: tc.size,
+    tcFiles: tcFiles.length,
+    assetFiles: assetFiles.length,
+    requirementFiles: reqFiles.length,
+  },
+  l1Miss: [...km].filter((s) => !l1Hit.includes(s)).sort(),
+  l2Miss: [...km].filter((s) => !l2Hit.includes(s)).sort(),
+  l2Diag: {
+    note: '诊断用:历史 69.5% ≈ withLedgerMd,历史 246/246=100% ≈ wholeTestsDir;均非达标口径',
+    withLedgerMd: { hit: diag.withLedgerMd, total: km.size, pct: pct(diag.withLedgerMd, km.size) },
+    wholeTestsDir: { hit: diag.wholeTestsDir, total: km.size, pct: pct(diag.wholeTestsDir, km.size) },
+  },
+};
+
+if (process.argv.includes('--json')) {
+  console.log(JSON.stringify(out, null, 2));
+} else {
+  const { caliber: c, inventory: i } = out;
+  console.log('=== SC 覆盖率三口径(单一脚本 · 可复现)===');
+  console.log(`L1 台账三流     ${c.L1_ledger_three_stream.hit}/${c.L1_ledger_three_stream.total} = ${c.L1_ledger_three_stream.pct}%`);
+  console.log(`L2 执行资产引用 ${c.L2_executable_asset_ref.hit}/${c.L2_executable_asset_ref.total} = ${c.L2_executable_asset_ref.pct}%`);
+  console.log(`L3 需求回链     ${c.L3_requirement_backlink.hit}/${c.L3_requirement_backlink.total} = ${c.L3_requirement_backlink.pct}%`);
+  console.log(`资产盘点:SC ${i.scInKeyMap} / 唯一 TC ${i.tcUnique} / TC 台账 ${i.tcFiles} 文件 / 执行资产 ${i.assetFiles} 文件 / 需求文档 ${i.requirementFiles} 文件`);
+  console.log(`L1 缺三流 ${out.l1Miss.length} 个:${out.l1Miss.join(' ') || '无'}`);
+  console.log(`L2 无执行资产引用 ${out.l2Miss.length} 个:${out.l2Miss.slice(0, 40).join(' ') || '无'}${out.l2Miss.length > 40 ? ' ...' : ''}`);
+  console.log(`[诊断] 含台账md ${out.l2Diag.withLedgerMd.hit}/${out.l2Diag.withLedgerMd.total}=${out.l2Diag.withLedgerMd.pct}%(历史 69.5% 来源);扫全 tests/ ${out.l2Diag.wholeTestsDir.hit}/${out.l2Diag.wholeTestsDir.total}=${out.l2Diag.wholeTestsDir.pct}%(历史 100% 来源)`);
+}