fix(pi-bridge): 夹具移出测试文件(import 它会二次注册整套用例)+ 测试侧写点全部兜住 + 判据不再往 /tmp 留垃圾

pi 复核了探针形状(论证闭合),又报了三条,全部实测成立。

## 一、从测试文件 import 助手 ⇒ 那套用例被**再注册一遍**(最实质)

`env-guard.test.mjs` 曾从 `session-scan.test.mjs` 取 `writeSession`。`node --test`
默认每个文件一个子进程,模块导入是进程内的 ⇒ 那个文件的 16 条用例在 env-guard
的进程里**又注册了一遍**。

实测确认:TAP 里巨行用例(单条往临时目录写 ~12 MiB)出现**两次**
(`ok 87` / `ok 353`),测试总数 475。**判据自己在加倍压 /tmp** —— 而 /tmp 正是
这次事件的主角。修完:459 条,巨行用例 1 次。

修法就是 pi 指的形状,也正是 `translateEnvError` 那次的同一手法:
夹具移到**非测试模块** `lib/session-fixtures.mjs`(可被引用,不被注册进套件)。

## 二、测试侧写点还是裸的

`makeRoot()` 的 `mkdtempSync`、以及 `writeSession` 里在 try **之外**的 `mkdirSync`
(ENOSPC 也可能从这里出来)⇒ 绕过前置脚本时抛的仍是原始英文堆栈,
而"绕过前置也要说人话"正是这套兜底存在的理由。现在整段包一层,与 `selfCheck()`
同一形状:**覆盖范围不取决于"我以为的哪一行"**。

## 三、判据往共享 /tmp 里留垃圾

`writeSession(tmpdir(), '--probe--', …)` / `'--probe2--'` 每跑一次就留两个目录、
且永不清理。现在改用 `os.tmpdir()`(纯字符串,不 statfs)当根:那两条的创建都被
假写打断 ⇒ 目录根本不会建出来 ⇒ 既不读也不写真实临时目录。

## 四、一条新判据替代原来的文本接线检查

守**机制**:解析测试文件里的模块引用(静态 `from` / 动态 `import()` / `require()`),
任何指向另一个 `.test.mjs` 的引用都算违规 —— 注释里提到文件名不算(注释不会注册用例)。

这条判据自己踩了两次,都留在注释里:
  第 1 版 只匹配静态 from ⇒ 漏掉动态导入;
  第 2 版 "文件里出现别的测试文件名" ⇒ 把**注释里的散文引用**也算成违规
          (本仓库有 3 处这样的注释,逼人删掉有用的注释),
          而且**它被自己注释里的示例字面量扫到**。
**过宽和过窄都是坏的** —— 这正是这一串评审反复出现的同一族错误。

验证:`npm test` **459/459**(少了 16 条重复注册);巨行用例出现 1 次;
`--self-check` 18 条全过;`TMPDIR=/tmp node deploy/check-deploy-drift.mjs --self-check` ⇒ exit 2 + 人话。
This commit is contained in:
2026-09-14 19:51:44 +08:00
parent 6b7c12d9da
commit f1059c5a6b
3 changed files with 99 additions and 45 deletions

View File

@ -5,49 +5,15 @@ import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { createSessionScanner } from '../src/session-scan.mjs';
import { translateEnvError } from '../lib/env-error.mjs';
// ★ 夹具在 `lib/`(**不是测试模块**):从这里 `export` 它会让别人 import 本文件时
// 把本文件的所有用例在**他们那个进程里再注册一遍** —— 实测巨行用例被跑两次。
import { writeSession } from '../lib/session-fixtures.mjs';
/** 造一个会话目录树。返回根目录,用完由调用方删。 */
function makeRoot() {
return mkdtempSync(join(tmpdir(), 'pi-scan-'));
}
/** 写一条会话文件。lines 是 header 之后的行(对象,会被 JSON 化)。
*
* ★ 空间不足时**不要让它伪装成内存缺陷**(2026-09-14 实测的教训)。
*
* 本文件在 `/tmp` 是满的 tmpfs(`bavail` 一度真是 **0**)时会红一条
* `★巨大的 message 行不进内存也不影响解析`,报 `ENOSPC` —— 而那条用例的名字里
* 就写着"不进内存",于是那条红**长得像一个内存缺陷**,让人去 `session-scan.mjs`
* 里找一个不存在的东西。
*
* 正常的挡法在 `test/env-preflight.mjs`(由 `npm test` 先跑,不足时 exit 2)。
* 但 `node --test 'test/*.test.mjs'` 会绕过它,所以这里再兜一道:
* **ENOSPC 一律翻译成"环境不足"** —— 不管套件是怎么被调起来的。
*
* 翻译逻辑在 `lib/env-error.mjs`(纯函数,`env-guard.test.mjs` 用构造出来的
* ENOSPC 喂它验行为)。**别把判断写回这里**:写在这里就只能靠"读源码文本"去判,
* 而本段注释里本来就有 "ENOSPC" 这个词 —— 删掉逻辑只留注释,文本判据照样绿
* (pi 评审时就是这么指出来的)。
*
* `write` 只为测试存在(默认 `writeFileSync`):让这个接线能被喂一个必然 ENOSPC 的假写,
* 于是"机制在不在"是**行为**判据而不是文本判据。
*/
export function writeSession(root, cwdSlug, fileName, header, lines = [], write = writeFileSync) {
const dir = join(root, cwdSlug);
mkdirSync(dir, { recursive: true });
const file = join(dir, fileName);
const body = [JSON.stringify({ type: 'session', version: 3, ...header })]
.concat(lines.map((l) => JSON.stringify(l)))
.join('\n');
try {
write(file, `${body}\n`);
} catch (e) {
throw translateEnvError(e).error;
}
return file;
}
const msg = (text) => ({
type: 'message',
id: Math.random().toString(36).slice(2, 10),