JianFeeeee
4b841e019a
修复: "没读数"到不了读者 —— summary.py 的 rc=2 与三行 ✗✗ **一个字都没进套件输出**（pi 实测的口子 + 我实测的第二例：部分可读时那行**看着完全正常**）
pi 2026-09-18 报的是**我上一轮新引入**的口子。我复现了它，并实测出**第二种**它没提、
且**只靠它的修法①治不了**的情形。
## 一、pi 那一例：盲读时 `mutants=0` 与"真的没有变异体"长得一样
`run-all.mjs` 原来只做：
```js
const m = /(RESULT mutants=\d+ ran=\d+ skipped=\d+ on_new_criteria=\d+)/.exec(sp.stdout);
mutantsLine = m ? ` ${m[1]}` : ` mutants=（… status=${sp.status} …）`;
```
⇒ **只在正则不匹配时才看 `status`**。而盲读时 `summary.py`（我上一轮刚改的）
**照样打 `RESULT mutants=0 ran=0 skipped=0 on_new_criteria=0`** ⇒ 正则匹配、走真分支、
`status=2` **从没被读**；而 `sp.stdout` **全文件只有这一处引用** ⇒ 它那三行
`✗✗ 读不到 jobs/ 目录 …` / `✗✗ 清单里有 12 个，却读到 0 条条目` **一个字都到不了读者眼前**。
**复现（跑出来的，不是读代码）**：`nobody` 下跑真 `summary.py`，rc=2、三行 ✗✗ 都在，
再拿 run-all 里**那一行**的正则去匹配它：
```
m 为真? true → 套件会播报: RESULT mutants=0 ran=0 skipped=0 on_new_criteria=0
```
⇒ 与"这棵树真的一个变异体都没有"**长得一模一样**，而真相是"**没读数**"。
★ 我上一轮自己在 `summary.py` 注释里写过"那边也会看到 `mutants=0`"并当成**可接受** ——
理由是"这一行自己带 ✗✗ 说明"。**错了**：那几行不在套件的输出里，所以没有"自己带说明"。
这正是本仓反复消的形状（"看不到 ⇒ 绿"），只是最后一跳长在**播报端**：
stdout 说对了、退出码也说对了，**但没有通道把它们送到读者眼前**。
## 二★ 我实测出的第二例：**部分可读**（pi 那封没提，且它的修法①兜不住）
目录**能**进入、但**单个 job 文件**读不到（`chmod 000 jobs-one.json`）时：
```
$ runuser -u nobody -- python3 summary.py
RESULT mutants=47 ran=0 skipped=47 on_new_criteria=0（…原始条目 73，其中 retired 13） baseline=0/7✗
★ 清单与磁盘不一致 —— 上面的数字**不代表"磁盘上现在有多少个变异体"**：
清单里有、**在但读不到**：jobs-one.json（权限问题，不是缺失 —— 改权限，别删条目）
rc=2
```
那行 `mutants=47 …` **看着完全正常**，而且**它匹配正则**。⇒ pi 的修法①
（盲读时改打 `mutants=NO-READING`）**对它无效**，因为这里 `blind` 为假、数字是真算出来的。
**只有"先判 status"能兜住它** —— 所以两层修法不是叠保险，是各治一例。
## 三、修法：先判退出码，再把原因行**转印**出来
1. `summary.py` 盲读时改打 `RESULT mutants=NO-READING …`（不匹配该正则，让读数器
**自己说"我没读数"** —— 与我在 `summary.py` 里做的是同一件事，只是补上到套件这一段）。
2. `run-all.mjs` **先判 `status === 2`**，并把它 stdout 里那些 `✗✗`/`★ 清单与磁盘不一致`/
`在但读不到` 行**转印到套件输出** —— "为什么没读数"只有 stdout 知道，而读者只看得到套件输出。
非 0/2 的异常退出码也留痕（`（注意：summary.py status=N）`），不许静默。
**真端到端验证**（不是读代码）：把工作树复制到 `/tmp`，`runuser -u nobody` 跑**整个套件**：
| 场景 | 套件播报的 mutants 那格 |
|---|---|
| 正常（root） | `mutants=48 ran=47 skipped=1 on_new_criteria=35` |
| 盲读（nobody） | `mutants=（**环境：没读数**，summary.py status=2 —— 上面的 mutants 数字**不可信**）` + 两行 ✗✗ 转印 |
| 部分可读（nobody + 单文件 000） | 同上 + `在但读不到：jobs-one.json（权限问题，不是缺失）` 转印 |
## 四、抽出纯函数 + 自检：因为这个分支**在正常路径上走不到**
盲读只在**非 root + `jobs/` 不可读**时发生，而套件以 root 跑 ⇒
那段决策**只在我手跑 `runuser` 时才经过**。"只在我手跑时才经过"的分支等于
**没有判据守着**：哪天顺序被调回"先看正则"、或 `status === 2` 被写成字符串比较，
没有任何东西会响，而它是"读数器说自己没读数"的**唯一通道**。
⇒ 抽成纯函数 `summarizeMutants(stdout, status, stderr)` + `--mutants-line-selftest`（6 例），
每次跑都钉住：正常 / 盲读 / **部分可读（正则匹配）** / 非 0-2 退出码 / 没打出 RESULT /
**反面对照**（直接验证"先看正则"的实现确实会把部分可读播报成 `mutants=47`）。
**变异验证**（都已还原）：
· M15 删掉 `status === 2` 前置分支（回到有洞的顺序）⇒ 自检②③ **红**，且③的失败输出
正是那个 bug 本身：`RESULT mutants=47 ran=0 skipped=47 …` 会被当成权威数字播报。
· M16 `whyLines` 置空（不转印原因）⇒ 自检②③ **红**（转印 0 行，期望 1/2 行）。
## 五、验证与状态
· 全套件 `checks=459 pass=455 fail=4 skip=0 red=9 broken=0 unreported=0` —— 与改动前**同样 9 条**
（并发会话的"自报>清单" + 4 条 exit 1），`mutants=48 ran=47 skipped=1 on_new_criteria=35` 不变。
· `--mutants-line-selftest` 6/6 绿、`--skip-selftest` 5/5 绿、`--probe-selftest` 3/3 绿。
· 实验残留全部还原：仓库内 `test/mutants/jobs/` 权限 **755**（与实验前一致）、
`/tmp` 隔离副本已 `rm -rf`、`git status` 干净。