JianFeeeee
0b548b8fcf
现场（2026-09-14 实测）：`/tmp` 是 tmpfs，被别人占满，`statfsSync` 实读
`bavail*bsize` 只剩 **0.70 MiB**。此时 `npm test` 红一条
not ok 323 - ★巨大的 message 行不进内存也不影响解析
error: 'ENOSPC: no space left on device, write'
那条红的**形状指向内存**（用例名里就写着"不进内存"，而它恰好是往临时目录写文件的
用例）⇒ 下一个踩到的人会去 `session-scan.mjs` 找一个**不存在**的内存缺陷。
改：
- `lib/tmp-space.mjs`：测量与判据分开，判据是纯函数 `judgeSpace`，喂字节数即可验；
读不到可用空间（null/NaN）⇒ **不判红**（不知道 ≠ 不对，否则会造出"总在亮"的红灯）。
**但 0 字节不是"不知道"** —— 第一版把 `<=0` 一并当"没测到"，于是 `bavail` 只剩
712 字节时前置自检放行、紧接着 17 条用例 ENOSPC 全红：前置自检装了等于没装。
阈值 32 MiB = 实测单条用例最大写入量（`session-scan` 那条写 3×3 MiB 行 ≈ 12 MiB）
×2 + 8 MiB 机动，不是总容量的百分比（百分比在这套测试上没有依据）。
- `test/env-preflight.mjs`（名字不带 `.test.`，不被 glob 收进用例）：
`package.json` 的 test 改成先跑它；不足时打印实测/阈值/目录并 **exit 2**
—— 与 `deploy/redeploy-plugin.sh` 的 `2=环境问题` 同一套约定，看到 2 才知道
去查机器而不是查代码。文案里明写「这是环境不足，不是断言失败」。
- `session-scan.test.mjs`：兜底翻译 ENOSPC（`node --test 'test/*.test.mjs'` 会绕过
前置脚本，这一句不管套件怎么被调起来都生效）—— 这正是治那条误导的关键。
- `test/env-guard.test.mjs`：8 条自证 —— 纯函数两头 + 边界（≥阈值算够、<阈值不够）
+ 0 字节必须红 + 读不到不判红 + 阈值有据 + 端到端 exit 2 且文案对得上。
端到端那条**不假设本机 /tmp 仍然满**：先自己量一次，够用就跳过并说明原因，
免得它退化成一条"总在亮"或"总在绿"的假判据。
顺带修 `deploy/check-deploy-drift.mjs` 两处同源问题：
- `selfCheck()` 要在临时目录造两棵小树，`/tmp` 满时抛 ENOSPC —— 而它是**未捕获异常**，
堆栈指向本文件，看起来像检查器坏了。翻译成说得清的错并让 main() 报 2。
- 新增判据 ⑥「工作区干净」—— **只提示，不参与 exit code**。判据 ① 比的是
「仓库工作区→快照」这一跳，覆盖不到「HEAD→工作区」那一跳（实证：一行未提交的
死代码被 17:20 的快照带进生产，而 ① 报的是"逐字节一致"）。做成红灯就是一条
总在亮的判据（本文件头自己骂过的病），所以只说、不判。
验证：`npm test` 453/453（新增 8 条）；`npm test` 在 /tmp 满时 exit 2 且不再跑用例；
`node deploy/check-deploy-drift.mjs --self-check` 17 条全过（含 ⑥ 的三条正反面）。
63 lines
3.2 KiB
JavaScript
63 lines
3.2 KiB
JavaScript
/**
|
||
* 临时目录空间：**测量与判据分开**。
|
||
*
|
||
* # 为什么要有这个东西
|
||
*
|
||
* 2026-09-14 实测（本机）：`/tmp` 是 tmpfs，9.8G 被占满，`bavail` 只剩
|
||
* **0.70 MiB**（`statfs` 实读）。此时跑 `npm test` 会红一条
|
||
* `★巨大的 message 行不进内存也不影响解析`，报 `ENOSPC`。
|
||
*
|
||
* 那条红**看起来像内存缺陷**（用例名里就写着"不进内存"，而它恰好是往临时目录
|
||
* 写文件的用例）。下一次踩到的人会去读 `session-scan.mjs` 找内存 bug —— 找的是
|
||
* 一个**不存在**的东西。环境不足伪装成断言失败，是这个文件存在的全部理由。
|
||
*
|
||
* # 判据的形状（与仓库既有约定一致）
|
||
*
|
||
* - 这里只有**纯函数**：喂进"还剩多少字节"，吐出"够不够"。测量在调用方
|
||
* （`test/env-preflight.mjs`），因为 `statfsSync` 碰的是真实文件系统，
|
||
* 纯函数才可被反面样本喂。
|
||
* - **读不到不判红**：`availBytes` 为 `null`（读不到 / 平台不支持 / 字段为 0）
|
||
* 时返回 `ok: true` 并注明"不据此判定"。**不知道 ≠ 不对** —— 不确定就放行，
|
||
* 否则会在不认识的文件系统上制造一条总在亮的红灯，而"总在亮的红灯"
|
||
* 会被人学会忽略（`deploy/check-deploy-drift.mjs` 文件头骂过这个病）。
|
||
*/
|
||
|
||
/** 单条用例的最大临时写入量（实测）：`test/session-scan.test.mjs` 那条用例
|
||
* 写 3 条 3 MiB 的行（两条巨行 + 一条正常行）⇒ 约 12 MiB。 */
|
||
export const MEASURED_MAX_CASE_WRITE = 12 * 1024 * 1024;
|
||
|
||
/**
|
||
* 前置自检要求的最小可用空间。
|
||
*
|
||
* 取"实测用例写入量 × 2 + 8 MiB 机动"＝ 32 MiB，**不是**总容量的百分比：
|
||
* 百分比在 9.8G 的 tmpfs 上会给出一个和这套测试毫无关系的数，而这里要挡的是
|
||
* "一条 12 MiB 的用例写不进去"。×2 是因为临时目录可能同时有别的写入方
|
||
* （本机 `npm test` 之外还跑着 agent 的会话文件）。
|
||
*/
|
||
export const MIN_FREE_BYTES = MEASURED_MAX_CASE_WRITE * 2 + 8 * 1024 * 1024;
|
||
|
||
const mib = (n) => `${(n / 1048576).toFixed(1)} MiB`;
|
||
|
||
/**
|
||
* @param {{ availBytes: number|null, needBytes?: number }} args
|
||
* `availBytes` 为 `null` 表示"没测到"（读不到、平台不支持、字段缺）。
|
||
* @returns {{ ok: boolean, known: boolean, note: string }}
|
||
*/
|
||
export function judgeSpace({ availBytes, needBytes = MIN_FREE_BYTES }) {
|
||
// `null` / `NaN` 才是"没测到"。**注意 0 不是"没测到"** ——
|
||
// `statfsSync` 说不出话时会抛（已在测量层转成 null），它若返回 0，
|
||
// 意思就是"真的一点空间都没有"（实测踩过：把 `<= 0` 一并当"不知道"，
|
||
// 于是 `bavail` 只剩 712 字节时前置自检放行，接着 17 条用例 ENOSPC 全红）。
|
||
if (availBytes === null || availBytes === undefined || Number.isNaN(availBytes)) {
|
||
return { ok: true, known: false, note: '没测到可用空间（读不到或平台不支持）—— 不据此判定' };
|
||
}
|
||
if (availBytes >= needBytes) {
|
||
return { ok: true, known: true, note: `可用 ${mib(availBytes)} ≥ 需要 ${mib(needBytes)}` };
|
||
}
|
||
return {
|
||
ok: false,
|
||
known: true,
|
||
note: `可用 ${mib(availBytes)} < 需要 ${mib(needBytes)}`,
|
||
};
|
||
}
|