|
|
b1eb0ab0c9
|
feat(criteria): ⑤b 负向清单的**两处副本**都要有守 —— 关掉我在 4598095 里明确留下的那条尾巴
`4598095` 结尾我写了「§7 那条同类无守…不在这条提交里改」—— 这条把它关掉。
## 形状（pi `7ec0044a` 指出，我逐条验证）
「已装二进制 = 当前 HEAD —— 不覆盖: ①脏树构建 ②部署后手工替换」这句话有**两份副本**:
```
deploy/check-deploy-drift.mjs `negative` 常量 + 自检格 ← **有守**
deploy/redeploy-gateway.sh:480 注释 + `ok` 文案（§7） ← **无守**
```
实测:
```
grep '已装二进制 = 当前 HEAD' 全仓 ⇒ **只命中 redeploy-gateway.sh 那一行**
redeploy-gateway.sh 的 `--self-check` 出现次数 = **0**（参数只有 --skip-tests/--skip-web/--dry-run/--help）
⇒ 同一个动作、同一句"不覆盖"的声明，**一处有守、一处没有**
```
★ 而**无守的那份恰是部署时打印到屏幕上的那份** —— 读者看到的就是它。
## 判据
`criteria-hygiene` 新增：两份副本都必须同时点名同一对失败类（`脏树` / `手工替换`）。
**变异验证**（两侧都验）:
```
shell 那份删掉"手工替换"（注释与 ok 文案都删）⇒ 该判据 **红**，点名
`redeploy-gateway.sh 未点名「手工替换」` ✓
恢复 ⇒ 绿 ✓
```
固定 8 → **9**，已同步 `run-all.mjs`。
## 归族
与上一条（发现路径）**同族**: 都防「**声明的副本**没有守卫」。
区别: 上一条防"没人知道工具存在"，这一条防"**声明漂了没人知道**"。
★ pi 的 ⑬″ 判法在这里的用法：先问"这句声明**在 R 内还是 R 外**"——
「不覆盖②」属于 R 内（该判据确实回答不了内容替换）⇒ 它不是"划出宣称"就能了事，
而是**必须说出来**，所以两处副本都要保住这句话。
验证: `criteria-hygiene` 9/9；`bash -n deploy/redeploy-gateway.sh` 未受影响（本提交没动它）。
|
2026-09-25 07:16:26 +08:00 |
|
|
|
0c6c506d7a
|
feat(criteria): 新建「非门禁工具必须有**发现路径**」判据 —— 补上改名制造的盲区（pi a6dd501c）
pi 指出、我复现的一个**盲区**：`check-*.sh` 族靠命名约定被 `readdirSync` 强制接线
（上一条判据管的就是"判据在但走不到"）。★ 而这条约定的**代价**是：
**为了躲开它而改名之后，没有任何判据管"改名后还找不找得到"**。
```
实测（我独立复现）:
recount-relay-counts.sh 非自身引用 = 1（只有 docs/DEBTS.json）
archive-stale-sessions.sh 非自身引用 = **0**（全仓只命中它自己）
对照: prune-deploy-artifacts.sh 在 docs/DEV-TOOLING.md:71 有**专节** ⇒ 那才是它被找到的原因
⇒ 两个机制不同、都要有:
check-* 族: 「判据在但**走不到**」（**执行**路径）—— readdirSync 强制
按需工具 : 「工具在但**没人知道它存在**」（**发现**路径）—— 本判据
改名正好绕开前者 ⇒ 后者必须独立存在
```
## 判据
`criteria-hygiene` 新增：每个非门禁 `deploy/*.sh` 至少要有**一处非自身引用**
（扫 docs/deploy/test/.githooks/scripts 的 .md/.mjs/.sh/.json，用 `prose()` —— 判的是散文）。
含反空真护栏（工具数 <2 报红）。
固定 7 → **8**，已同步 `run-all.mjs` 的登记数。
## ★★★ 建这条判据时我自己先假绿了一次（已修，值得记）
第一版判绿了，而 `archive-stale-sessions.sh` **明明是零引用**。原因:
```
我的判据注释里写着「archive-stale-sessions.sh —— 非自身引用 = **0**」
⇒ 判据扫"文件里有没有出现这个名字" ⇒ **它自己那句描述**被数成 1 个引用
⇒ 一个零引用的孤儿**因为被描述成孤儿**而看起来有引用 ⇒ 判绿
```
修法：扫描时**排除观察者自身**（`resolve(p) !== resolve(fileURLToPath(import.meta.url))`）。
⚠️ 我第一版排除的是 `SELF`，而本文件里 `SELF` 指的是 `lib/read.mjs`（另一个文件的变量）
⇒ 排错了对象，仍然假绿。**"我知道要排除自己"和"我排除的是自己"是两件事。**
泛化：**任何"扫全仓找引用"的判据都必须排除观察者本身**，
否则"描述缺陷"与"存在引用"不可区分（与 `stripComments` 那条同源）。
## 变异验证（两侧都验，不只验绿）
```
删掉 DEV-TOOLING 的"按需工具"整节 ⇒ 该判据 **红**（报出 archive-stale-sessions.sh）✓
恢复 ⇒ 绿 ✓
```
## 顺带
`docs/DEV-TOOLING.md` 加「按需工具」一节，逐个列出发现路径（5 个工具）+ 两个机制的对照表。
验证: `criteria-hygiene` 8/8；`run-all --test criteria-hygiene` 该文件不在红名单。
（另 4 个红文件为**既有**、与本改动无关: build-stamp 是前端产物未重建（expected 9e05322 /
actual 6c98ac2）、commit-hygiene 是 AGC 配置、cross-client-gesture 需设备、cross-client-theme
单独跑 21/21 绿 —— run-all 里那次红来自环境差异。）
|
2026-09-25 07:13:04 +08:00 |
|
|
|
9e053227f4
|
记录 pi 找到我 fail-closed 的"未写出前提"（3be8a091 → e44ae45）：两通道共模 ⇒ 单点改动同时哑掉两条 ⇒ 恰好不触发
★ (A) 洞: 我两条通道共享 (a) 同一个正则字面量 (b) 同一个 $body ⇒
fail-closed 的 `_had=1 ∧ _cnt=0` 只在"不一致"时触发 ⇒ 共模时两者"一致沉默" ⇒ 不触发
实测: 两处正则一起改 '^NOMATCH='，树上注入着 3 处裸赋值 ⇒ rc=0 且打出"裸赋值 0 处"（与真实相反）
★ (B) 记法: **"两条通道"要成为独立证据，须"不存在单点改动能同时哑掉两条"** ——
条数 ≥ 2 不是独立性判据；要检查共享的**字面量/变量/函数/上游命令**
⇒ **fail-closed 挡得住"一条通道坏了"，挡不住"两条因同一原因一起坏"**
★ (C) ★ 我补正向对照时多做一步，**实测盖住了 pi 自标的残余**:
pi 残余 = "只证明那个正则能匹配那个样本，盖不住别的环节（如过度 strip）静音"
我把扫描抽成**唯一函数** `_scan_text()`，正向对照与正式扫描**走同一函数**
⇒ 实测（strip 改成删整行、正则不变）rc=1 + 自检失败 ✓ ⇒ 对照的是**整条管线**
⇒ 记法: 正向对照要与正式判定**共用同一条实现路径**（否则对照的只是那个正则）
★ (D) 变异矩阵五向: [0]基线 rc=0（非恒红）/ [1]注入 rc=1 / [2]-q→-n rc=1 / [3]-n→-q rc=1 /
[4]共模 rc=1+自检失败 / [5]深层共模 rc=1+自检失败；每向还原复测 rc=0
★ criteria-hygiene 现 8/8 绿（含并发会话新增那条）
|
2026-09-25 07:09:54 +08:00 |
|
|
|
e44ae45dd3
|
★★★ pi 指出 fail-closed 的**未写出前提**（两通道须失效不相关）——而我的两通道共享正则字面量与 $body ⇒ 共模时 fail-closed 不触发；补**正向对照**（且走同一函数）
★ pi `3be8a091` 的论点我复现:
我的两条通道共享 2 处: (a) **同一个正则字面量**（两处逐字相同）(b) **同一个 $body**
⇒ fail-closed 条件是 `_had=1 ∧ _cnt=0`（**不一致**）⇒
**单点改动同时哑掉两条 ⇒ 两者"一致"（都沉默）⇒ 条件不成立 ⇒ 恰好不触发**
实测（照 pi 做）: 把两处正则字面量一起改成 '^NOMATCH='，而树上**注入着 3 处裸赋值**
⇒ rc=**0**，并打出"裸赋值 **0** 处" —— **与真实情况相反** ✓ 与 pi 一致
★ 记法（收 pi 的，并认为它比"条数≥2"准）:
**"两条通道"要成为独立证据，须"不存在单点改动能同时哑掉两条"** ——
条数 ≥ 2 **不是**独立性的判据；要检查两通道共享的**字面量/变量/函数/上游命令**。
即: **fail-closed 挡得住"一条通道坏了"，挡不住"两条因同一原因一起坏"**。
★ 补法: **正向对照**（用一个**已知违规样本**跑扫描；匹配不到 ⇒ 按红计 + 报"判据自检失败"）
★ 我加了一步 pi 没要求的，并**实测它把 pi 自己标的残余也一并盖住**:
pi 的残余是"正向对照只证明**那个正则**能匹配**那个样本**，
盖不住'正则对、但**别的**环节（如 body 被过度 strip）静音'"。
⇒ 我把扫描抽成**唯一函数** `_scan_text()`（strip + 匹配 + 行号输出），
正向对照与正式扫描**走同一个函数** ⇒ 对照的是**整条管线**，不只是那个正则。
实测: 注入 3 处裸赋值 + 把 strip 改成"删掉整行"（正则不变、别的环节静音）
⇒ rc=**1** 且报"判据自检失败" ✓ ⇒ 这条残余**被盖住**（不只是申报）。
★ 变异矩阵（五向，全部真跑 + 每次还原复测）:
[0] 基线无违规 ⇒ rc=**0**（**非恒红**）✓
[1] 注入 3 处裸赋值 ⇒ rc=1 ✓
[2] 判"有没有"处 -q→-n ⇒ rc=1 ✓
[3] 取行号处 -n→-q ⇒ rc=1 ✓
[4] ★共模（正则单点改错） ⇒ rc=1 + 报"判据自检失败" ✓（原版此处 rc=0/报"0 处"）
[5] ★深层共模（strip 改为删整行，正则不变）⇒ rc=1 + 自检失败 ✓
★ 另: criteria-hygiene 现 **8/8** 绿（并发会话新增的"非门禁工具发现路径"那条也在内）
|
2026-09-25 07:06:38 +08:00 |
|
|
|
de9e1e713c
|
复核 pi 54fbf46c: 其"自我指涉"论点我用自己的载体校准数据**证成**；★ 但它同一个数 11 同时挂在两个谓词上（真值 15 与 11），★ 而两个都不是它想指的集合（正确集 ①∧②=2）
★ (A) 形状总数 376 与"6 个尾部实例、无一失败报告"我复现一致 ✓
★ (B) ★ 它写「父∈failure-relay 的 = 11（我实测: subject 含'处理失败'的 11 封）」:
· ① 父的 relay_key LIKE '%failure%' = **15**
· ② 自己 subject LIKE '%处理失败%' = **11**
· |①\②|=13、|②\①|=9 ⇒ 只 2 个重合
⇒ 两个谓词被并成一个词，N 最多只对一个谓词成立
⇒ 记法: **报"其中 X 的 = N"时 X 必须是一个谓词**；括注换成另一谓词，N 就同时挂在两个上
★ (C) 两个谓词都不是"抑制可能碰到"的集合 —— 正确的是 ①∧② = **2**（附元素 id:
89178e1c / 85624acd）；①∧¬②=13、¬①∧②=9
★ (D) 它的"自我指涉"我**证成**: 载体A(relay_key)=98 vs 载体B(subject)=69，
|A\B|=**39**、|B\A|=**10** ⇒ subject **不是** relay_key 的忠实代理
⇒ 我本想用 subject 消解自我指涉，数据站它那边 ⇒ 收: **不是"今天 0 例"，是"用权威载体判不出来"**
★ (E) 只读 SQL；仓库与生产未动
|
2026-09-25 07:03:13 +08:00 |
|
|
|
302a447a90
|
记录 pi 抓到我"只修了一半"(95e50126 → 5d9a41c)；★ 且我第二版第一次尝试**仍有洞**，补了 fail-closed 才闭
★ (A) 我在同文件 :65 写下警告、:102 却没照做（仍是 `sed | grep -nE` 管道）
它不出事只因"恰好选了不早退的 -n"；pi 实验: 改成 -q ⇒ 3 个违规**全漏**、rc 由 1 变 0 ⇒ 我复现 ✓
⇒ **"恰好选了不早退的选项"不是正确性，是运气**
★ (B) ★ 我第二版做两样（去管道 + 两条独立通道）后**实测仍有洞**:
[C] 把取行号那处改成 -q ⇒ 报 0 个、rc=0 —— 因为 `fails` **计数**仍由行号输出驱动
⇒ 补 ③ **不一致时 fail-closed**（退出码说有 ∧ 行号通道没给 ⇒ 按"有违规"计 + 报出矛盾）
⇒ 补后 [C] rc=1 且 fail-closed 报出 3 次 ✓
⇒ 记法: **"计数"与"证据"走同一条通道时，那条通道静音就等于"没有"** ——
要么分通道，要么规定**静音=失败侧**。我"做了两样以为够了"正是把这条漏在自己身上
★ (C) pi 的机制细化我收: 决定 SIGPIPE 的是**匹配点之前的字节数**（8525⇒141 / 3180⇒0 / 2954⇒141）
⇒ "不稳定"其实是确定性，阈值(~4-8KB)藏在数据里 ⇒ **改改注释或挪挪那行，rc 就翻面**
我的补充: 单巨行 sed（一次读全再写）⇒ rc=0，与"生产者还有没有东西要写"一致
★ (D) 验证: 三变异全 rc=1 + fail-closed×3；每变异后还原复测 rc=0；仅 add 我的文件
（并发会话在改 check-deploy-drift.mjs，未 add 它的改动）；criteria-hygiene 7/7、env-guard 17/17
|
2026-09-25 07:01:49 +08:00 |
|
|
|
4598095b17
|
fix(drift): 补上负向清单**第②项的守护格** —— pi ⑬″ 指出的真洞（宣称 2 项，只有 1 项有人守）
pi `7ec0044a` 用**同一条量法**（`|R\C|`）打了我自己刚落地的那条 ⑬′：
```
我 b5989a9 的 ⑤b 负向清单宣称 2 项:
① 从脏树构建（含未提交代码） —— **有格**（:1610 modified=true ⇒ 绿 + note 点明）
② 部署后被手工替换/修改（只看内嵌 revision）—— **一格都没有**
grep '手工替换' 全文件 ⇒ 只命中清单自身
⇒ 所以 |R\C| 不是 1；② 是**只被"声明"、没被判据守**的那一项
```
★ 而这正是 ⑬′ 想防的形状的**镜像**: 我写了负向清单（防读者把绿读成"没问题"），
却**没有东西防我自己把清单写漂** —— 删掉一项、或以为它被覆盖了，都不会红。
## ⑬″ 的判法（pi 给的，我采纳）
```
每一项判一次: 「在 R 内 C 外」（真洞 ⇒ **加格**）还是「在 R 外」（⇒ **划出宣称**）
项②: ⑤b 宣称回答"这份二进制是不是当前代码" ⇒ **在 R 内**
而 C = {只读内嵌 revision}，同 revision 换内容照样绿 ⇒ **C 外**
⇒ **真洞 ⇒ 加格**（不是划出宣称）
```
## 落地
新增自检格 `★网关二进制：绿时 note 必须写明"①脏树构建②部署后手工替换"两项都不覆盖`，
**不要求改 ok** —— 内容替换确实判不了，只能"说出来"；它钉的是**那句话还在**。
★ 变异验证（这格**能失败**，否则等于没加）:
```
从 note 里删掉负向项② ⇒ 该格 **失败** ⇒ "判据自检失败 1 项"
```
自检 63 → **64 项**，0 失败。
## 一并记账：§7 那条同类无守（pi 同封指出，本条**未改**）
`redeploy-gateway.sh` §7 那句「已装二进制 = 当前 HEAD（…）—— 不覆盖: …」**全仓只命中它自己**，
而 `redeploy-gateway.sh` 没有 `--self-check` ⇒ **同一动作两处，一处有守一处无守**。
不在这条提交里改（要动部署脚本，且得先想清 §7 该怎么自检）—— 留给下一条，避免又造一次半截更新。
|
2026-09-25 07:01:36 +08:00 |
|
|
|
5d9a41c3d3
|
★ pi 指出我"只修了一半": check-require-declaration.sh 收集违规行那处仍是管道；实测 -n→-q 静默漏掉全部 3 个违规 ⇒ 判据判定落在**输出通道**上
★ pi 的实验我复现: 现行 `grep -n` 报 3 个违规/rc=1；改成 `grep -q` ⇒ 报 **0** 个/rc=**0**（3 个全漏）
⇒ 它**目前**不出事只因"恰好选了不早退的那个选项"（-n 要读完全部输入 ⇒ 无 SIGPIPE）
⇒ **那不是正确性，是运气**。与我上一版在 :78-82 修的是同一条，我却漏了 :102。
★ 修法**三样一起做**（我做前两样后**实测仍有洞**，故补第三样）:
① 去管道（<<< here-string）⇒ 生产者不再收 SIGPIPE，-n/-q 都不再有 141
② 两条**独立通道**: "有没有违规"用 `grep -q` 的**退出码**；"哪几行"用 `grep -n` 的**输出**
③ ★ **不一致时 fail-closed**: 若"退出码说有"而"行号通道没给出行号" ⇒ 判据内部自相矛盾
⇒ **按"有违规"计**并报出该矛盾。
实测缺 ③ 会怎样: 只做 ①② 时，把取行号那处改成 `-q` ⇒ 报 0 个、rc=**0**（又是全漏）
⇒ **"计数"与"证据"走同一条通道时，那条通道静音就等于"没有"** ⇒
要么分通道，要么规定**静音=失败侧**（本处取后者）。
★ 验证（全部真跑，含三个变异）:
· 基线 rc=0（3 个调用者，裸赋值 0 处）
· [A] 注入 3 处裸赋值 ⇒ rc=1 ✓
· [B] 判"有没有"那处 -q→-n ⇒ rc=1 ✓
· [C] 取行号那处 -n→-q（pi 的变异） ⇒ rc=1 ✓ 且 **fail-closed 报出 3 次** ✓
· 每个变异后还原并复测 rc=0；`git diff --numstat` 仅剩我的文件
（同目录另有并发会话在改 check-deploy-drift.mjs —— 未 add 它的改动）
· criteria-hygiene 7/7 绿、pi 的 env-guard 17/17 绿、bash -n 过；生产未动
|
2026-09-25 07:01:34 +08:00 |
|
|
|
e63a5ba81d
|
docs(debt): 给那条被我误判的"不该写进判据"加**醒目自我取代标记**
`88f4b8a` 已用"三个带"更正了这个判定，但**更正写在后面**，而误判那句留在前面 ——
一个读到那里就停的人（或一个 grep 抓单句的人）只会看到 "**不该写进判据**"，
而那正是我这条工作线上反复在防的"**半截更新**"。
原句划掉（`~~…~~`）+ 就地写明"我判错了、已被本节末取代、结论是**顺序约束**"。
⇒ 规矩: **更正一条已写下的判断时，要在被更正的那句旁边留标记** ——
只在末尾补一段，等于让"错的那句"继续独立生效。
（本节里那句的上下文是 pi `8f6f6e6e` §三；实测见同一节末"三个带"。）
验证: JSON 合法；`TestDebtLedgerMatchesMeasurement`/`TestDebtSummaryReadsAuthoritativeLedger` 通过；
`debt-visibility.test.mjs` 1/1。
|
2026-09-25 06:57:24 +08:00 |
|
|
|
f3bd9d6f3b
|
记录采纳 pi 反提案（d562f55）+ 判据自身两个 bug；★ 新记法: 假绿可以来自"判据读输入的那一步"（管道层）
★ (A) 采纳: 声明动作化 agentmail_require ⇒ "声明了但没检查"从表示上消失（我原判"记为边界"，pi 换掉了前提）
★ (B) 判据 bug① 假红: 我按 `deploy/**/*.sh` 划范围 ⇒ 把 `agentmail_require()` 体内的
`AGENTMAIL_REQUIRE="$*"`（**动作自己的实现**）判成违规
⇒ 改为按性质划: "调用者"= **真的 source 了本库**的文件（身份由 source 定义，不由目录猜）
★ (C) 判据 bug② **假阴且不稳定**: `sed | grep -q` 在 pipefail 下 ⇒ grep 早退 ⇒ sed 收 SIGPIPE(141)
⇒ 管道整体 141 ⇒ if 判假 ⇒ 文件被静默漏掉；实测两次分别 2 个/1 个调用者（实际 3 个）
⇒ 集合偏少且不稳 ⇒ "裸赋值 0 处"是**假绿**；改为收集到变量再 grep <<< ⇒ 修后 10 次稳定 3
★ 但机制不是"凡管道皆危险"（实测）: 多行 sed ⇒ 141；单巨行 sed ⇒ 0；
tr/cat/awk/sort ⇒ 不是 141；grep -o 作生产者 ⇒ 141
⇒ 真条件 = **"生产者还有东西要写" ∧ "消费者早退"**
★ (C') 本仓已有同族先例（非我发现）: check-sandbox.sh:57 注释写着同形状（"'被拒'和'被拒判据本身炸了'长得一模一样"）
⇒ 记为**同一族的第二个实例**（那次在沙箱判据，这次在集合枚举）
★ 记法: ⑨ 是**命令层**（命令不在≠输出为空）；这条是**管道层**（判据读输入那一步可以是假绿来源）——
不报错、不稳定、且**偏向"看起来更干净"的那一侧**
★ 验证: 四向变异 + 累积通道隔离测（未中止 + RC=1 + 后续诊断在）+ criteria-hygiene 7/7 + env-guard 17/17
|
2026-09-25 06:56:44 +08:00 |
|
|
|
88f4b8ab5e
|
fix(debt): 我上一条把 pi 的 hop 建议判成"假问题"——**判过头了**；实测有**三个带**，最坏那个会清零 hop 守卫
★ 更正我自己上一条 `a05509c`（同一天、我写的）。我写:
"`CountTrailingRelayHops` 是重算 ⇒ '计不计'由有没有落库唯一决定 ⇒ **不该写进判据**"
**那半对，但我漏了两个形**，而漏掉的那个正是最坏的。实测（`/tmp/hop.db` 合成库）:
```
基线 3 封全绑: 序列 1 1 1 ⇒ hops = 3
加 1 条占位行（mail_id NULL，无 mail 行）: 序列 1 1 1 ⇒ hops = 3 **不受影响**
加 1 封有 mail 行但未绑 relay: 序列 **0** 1 1 1 ⇒ break ⇒ **hops = 0**
```
⇒ 抑制点的位置有**三个带**，后果完全不同:
```
① 在 :384（CountTrailingRelayHops）之前 return ⇒ 既不落 mail 也不落 relay ⇒ 真正"不计" ✓
② :396(ClaimRelay) 之后、:474(CreateMail) 之前 ⇒ 落占位行 ⇒ hop 不变，但**白占幂等键** ⇒ 重试被挡
③ :474(CreateMail) **之后** ⇒ 落"有 mail 行、无 relay 绑定" ⇒ is_relay=0 ⇒
CountTrailingRelayHops **break ⇒ hops 归零** ⇒ **hop 上限对该会话失效**
```
★ ③ 不是"多算或少算 1"，而是**主动清零守卫** ⇒ 环可以**绕过 5 跳上限**。
而 ③ 恰是"抑制逻辑写在 CreateMail 之后"这种最自然的写法会落进去的带（那里才拿到 mailID）。
⇒ 所以 pi 的直觉**是对的**，我错在把它当成"可配的口径"而整体否掉。
正确的结论（取代上一条）: 这不是口径，是**必须满足的顺序约束**，而顺序约束**更要**进判据:
```
「抑制必须在 CountTrailingRelayHops 之前 return」——理由: 落在其后会造出"有 mail 行无 relay 绑定"
的邮件，把 hop 守卫清零
判据形状: 构造一封因抑制而不发的报告，断言同会话 CountTrailingRelayHops 不降为 0
（**能失败** —— 把抑制挪到 CreateMail 之后就红）
```
★ 教训与这条线同形: 我用"重算"这个**机制事实**否掉了一整条建议，而没有把机制在**所有落点**上跑一遍。
pi 说的是"位置影响读数"，我说的是"机制是重算" —— **两句都真，但我的那句不能推出"所以不必写"**。
验证: `TestDebtLedgerMatchesMeasurement`/`TestDebtSummaryReadsAuthoritativeLedger` 通过；
`debt-visibility.test.mjs` 1/1。
|
2026-09-25 06:56:29 +08:00 |
|
|
|
a05509c51c
|
docs(debt): 补记判据⑥（permission 分叉点）+ 判据清单落定 + 否掉一条落点细节
pi `8f6f6e6e` 提的三件事，我 `476d22ad` 已逐条答过；本条把**判据清单落定**进登记
（此前只活在邮件里 —— 与上一条同样的问题）。
## ⑥ permission 分叉点，必须钉住
```
pi 的判据: 「本封来信 id ∈ relayed_mails」 ⇒ 抑制
我的判据: 「parent 本身是 failure-relay」 ⇒ 抑制
构造: 一封 permission 询问（kind=permission，也是 relay）发出 → 对方处理失败 → 发失败报告
pi : 来信(permission) ∈ relayed_mails 为真 ⇒ **抑制**（错: 首报该发出去）
我 : parent 不是 failure 类 ⇒ **放行** ✓
```
**可达性我验了**（这是它必须钉住的原因）:
```
permission-relay 的子邮件 = **137**（mail_type: normal 58 / permission_decision 79）
⇒ 子邮件确实会被产生 ⇒ 那一侧处理失败就会产出失败报告 ⇒ 分叉点可达
当前: failure 报告的 parent 是 permission-relay 的 = **0** ⇒ 今天还没分叉
⇒ 而这正是"两条判据现在等价（都 10 / 差集 0）"的来源
```
★ 所以"等价"是**当前数据的性质，不是机制的保证**。选判据的理由不能是"它们现在等价"，
而是**我的判据把"是不是失败类"读了出来**，pi 的没有 —— 信息量更大的一点更耐久。
（判据清单 ①–⑥ 一并落定；⑥ 需要失败才能构造。）
## ⚠ 同时否掉一条落点细节（免得下一个人重走）
pi 建议"插在 `:384` 前 ⇒ 被抑制者不消耗 hop，这个口径要写进判据"。
我读实现后判它为**假问题**: `CountTrailingRelayHops`（`relayhops.go:54-80`）是**重算**
（每次 `mails LEFT JOIN relayed_mails` 现扫），不是自增计数器 ⇒ "计不计"由"有没有落库"
唯一决定，**不是口径选项** ⇒ **不该写进判据**（写进去会让人以为可配）。
唯一相关的事实（与 hop 无关）: 抑制点必须在 `ClaimRelay`（`mail.go:397`）**之前** return，
否则白占一个幂等键、把后来的重试也挡掉。
验证: `TestDebtLedgerMatchesMeasurement`/`TestDebtSummaryReadsAuthoritativeLedger` 通过；
`debt-visibility.test.mjs` 1/1。
|
2026-09-25 06:55:13 +08:00 |
|
|
|
efa07126c4
|
fix(debt): 更正我上一条自己写错的计数 —— **8 条语句 / 5 个文件**，不是"7 处 / 5 个包"
★ 这是我上一条 `3f394c8`（同一天、我写的）里的一处**未经核对的数**，而我刚刚还在
另一封里要求 pi 的规则"数必须有精确定义"。自证一下：
```
我写的 : 7 处 / 5 个包 / 3 种语言
按"生成 relay_key 的语句"逐条数:
plugins/dsh-mail-bridge/src/index.ts:1240 model-failure:
plugins/dsh-mail-bridge/src/index.ts:1749 empty-reply:
plugins/pi-mail-bridge/src/worker.mjs:625 model-failure:
plugins/pi-mail-bridge/src/worker.mjs:715 model-failure:
plugins/zcode-mail-bridge/src/index.mjs:304 zcode-failure:
plugins/homeagent-mail-bridge/plugin.go:929 homeagent:failure:
deploy/service-failure-notify.mjs:92 service-failure:（有 INVOCATION_ID）
deploy/service-failure-notify.mjs:94 service-failure:（退化为 sha256）
⇒ **8 条**（不是 7）
按文件去重: dsh / pi / zcode / homeagent / deploy = **5 个**（"包"→"文件"更准）
```
**错在哪**: 我先写了"7"，然后把它当成已知去查证 —— 而**没有回头数一遍**。
`service-failure-notify.mjs` 有**两处**（`INVOCATION_ID` 分支 + sha256 分支），
我数成了 1。⇒ 这正是"**报数必须给数据源/口径**"那条：口径写了（"产生点"），
但**没真按口径数**。
★ 讽刺的是这条修正**不改变任何结论**（8 vs 7 都是"散在多个包、无载体"），
但它必须改 —— 否则下一个引用它的人会带着一个错的数往下走，而**错数比错结论更难发现**
（结论有争论，数看着就像核过的）。这正是本会话反复吃的那族形状。
验证: `TestDebtLedgerMatchesMeasurement`/`TestDebtSummaryReadsAuthoritativeLedger` 通过。
|
2026-09-25 06:53:35 +08:00 |
|
|
|
3f394c83c7
|
docs(debt): 追加「失败报告抑制」的**前置**问题 —— 谓词"是不是失败报告"没有载体
pi `334710a1` 的 A/B 落点分析（网关侧抑制 vs 桥侧省调用）**都**要先回答
「parent 是不是失败报告」。我按实产查了它的全部产生点 —— 它没有载体。
## 实测：7 个产生点 / 5 个包 / 3 种语言，写法互不相同
```
dsh-mail-bridge/src/index.ts:1240 model-failure:${data.mail_id}
dsh-mail-bridge/src/index.ts:1749 **empty-reply**:${mailSessionID}
pi-mail-bridge/src/worker.mjs:625 model-failure:${...}
pi-mail-bridge/src/worker.mjs:715 model-failure:${...}
zcode-mail-bridge/src/index.mjs:304 zcode-failure:${...}
homeagent-mail-bridge/plugin.go:929 "homeagent:failure:"+replyTo ← Go
deploy/service-failure-notify.mjs service-failure:${INVOCATION_ID|sha256} ← systemd 脚本
```
网关侧一无所知：这几家前缀 + empty-reply 在 `server/**/*.go` 里 **0** 处引用。
★ "用现成的 `RelayKeyForMail` 判一下"只对一半 —— 它返回 `(relay_key, kind)`，而
**`kind` 区分不了失败**：`kind='summary'` 里 failure 98 / 非 failure **321** ⇒
用 kind 判会连 321 行普通搬运一起豁免，**正是已否掉的修法①**。
★★ 活反例：`empty-reply:` 是失败类但**不含 `failure` 字样** ⇒ `LIKE '%failure%'`
永远抓不到它（代码 1 处、当前 **0 行** ⇒ **将来第一次触发就是静默漏判**）。
⇒ 推论: 在网关硬编码这四家前缀 ⇒ 第 6 家桥出现时**静默漏判** ⇒ 报告不再被抑制 ⇒
环回来（假绿）。所以修法应**先把分类变成网关拥有的东西**（枚举第三类 / 或 relayed_mails
加一列），再由各桥**声明**而非拼串。
⚠ 加枚举会撞上一条**故意**的锁: `TestRelayKindsIsExactlyTwo`（`relay_test.go:60-64`）
"免配额类型是白名单…新增前请确认它确实是 harness 代劳" ⇒ 必须同步改它 ——
而那正是它本来就该问的问题。
验证: `TestDebtLedgerMatchesMeasurement`/`TestDebtSummaryReadsAuthoritativeLedger` 通过；
`debt-visibility.test.mjs` 1/1。
|
2026-09-25 06:52:53 +08:00 |
|
|
|
d562f55d78
|
采纳 pi 反提案: 声明动作化 agentmail_require + 新判据 check-require-declaration.sh（禁裸赋值）—— 把"声明了但没检查"从表示上消掉
★ 背景: 我上封把"调用者既不 export 表、又忘了调 report"记为**边界**，理由是"闭合它要本文件
知道调用者控制流 —— 做不到"。pi 指出**前提可以换掉**（我复核采纳）:
病根不是"控制流不可知"，而是"**声明**（赋值）与**检查**（调用）是两个可分离的动作"。
⇒ 把声明做成**动作**: `agentmail_require <命令…>` = 赋值 + 立刻检查 ⇒ 该状态**不存在**。
★ 改动:
· env-defaults.sh 加 `agentmail_require()`（内部就是赋值 + agentmail_env_check_require）
· 三个调用者由 `AGENTMAIL_REQUIRE="…"` 改为 `agentmail_require …`（各 1 行）
也顺带把"重新导出为环境变量"的写法去掉了 —— 表只在本进程内被 ③b 读，不需要 export
· 新判据 `deploy/check-require-declaration.sh`（755）: deploy/ 下的**调用者**不得写裸赋值
· install.sh 接线，走 `CHECK_GATE_RC` **累积**通道（照 check-file-modes.sh 的既有做法:
直接调会在 set -e 下中止，把后面的收尾诊断全吃掉）
★★ 判据自己的两个 bug，都是**实测**抓出来的（不是审出来的）:
① 假红: 我第一版按"`deploy/**/*.sh` 全扫"划范围 ⇒ 立刻把 `env-defaults.sh:449`
（`agentmail_require()` 函数体里的 `AGENTMAIL_REQUIRE="$*"` —— **动作自己的实现**）
判成违规。⇒ 改为按**性质**划: "调用者"= **真的 source 了本库**的文件，
减去定义动作的那个库自己（"调用者"这个身份由 source 这个动作定义，不由目录猜）。
② ★ 假阴且**不稳定**: `strip_comments "$f" | grep -q …` 在 `set -o pipefail` 下，
`grep -q` 一命中就退出 ⇒ `sed` 收 SIGPIPE（rc=141）⇒ **管道整体 141** ⇒ if 判假 ⇒ 漏文件。
实测同一个脚本两次分别找到 **2** 个与 **1** 个调用者（实际 3 个），
而 rc=141 被 if 静默吞掉 ⇒ 集合**偏少且不稳** ⇒ "裸赋值 0 处"会是**假绿**。
⇒ 改为先收集到变量、再 `grep <<<"$body"`（无管道）。修后重复 10 次**稳定 3 个**。
★ 验证（全部真跑）:
· 基线 rc=0（3 个调用者，裸赋值 0 处）；重复 10 次稳定 3
· 变异①: 把 redeploy-plugin.sh 改回裸赋值 ⇒ rc=**1** ✓
· 变异②: 注释掉一个调用者的 source（仍剩 2）⇒ rc=0 ✓ 非空转
· 变异③: 三个 source 全注释 ⇒ **集合空** ⇒ rc=**1** ✓（防空转，不是恒绿）
· 每个变异后**还原**并复测 rc=0；`git diff --numstat` 确认只有预期行
· criteria-hygiene **7/7** 绿（新 check-*.sh 已被 install.sh 真调用）
· pi 的 env-guard **17/17** 绿；五个脚本 bash -n 全过；生产未动
★ 残留（判据头已如实写）: 盖"字面裸赋值"，**不盖间接赋值**（经 eval/read/env 注入）——
补它需 shell 语义分析，超出"一条 grep 型判据"的射程。
|
2026-09-25 06:51:25 +08:00 |
|
|
|
91d3db767a
|
★★★ 我认: 我那条"更正"是**反的**（pi 308bc4bc 指出，独立复核成立）—— dsh 列的差全部来自 join，与"排不排机器回信"无关
★ 决定性证据是 2x2 交叉（不是总差）:
(a)不join不排=49 (b)不join排=49 (c)join不排=20 (d)join排=20
⇒ 排机器两侧影响都 **0**；join 两侧影响都 **29** ⇒ 差**全部**来自 join ✓ pi 原始归因对，我说反了
★ 绝对值 4 天后已漂（我 188/157/154 vs pi 112/81/72），但 **2x2 里那两个 0 与两个 29 完全稳定**
⇒ 要钉的是**关系**不是**数字**；归因要靠**不相交的结构条件**
★ 我的错法: 看到"排机器确实是个真实过滤器"（实测去掉 3 封），就把"**存在**这个效应"
当成了"**这个差**由它造成" ⇒ **"有一个真实效应" ≠ "这个差来自那个效应"**
★ 顺带复核 pi 自己收回的一笔(4fba2d28): `ABA\nABA\nABA\n` 的 `-o|wc` 我实测 **3**（GNU grep 3.8，纯 ASCII 无 NUL）
⇒ 它的撤回成立；它自述错法=拿**含 \0 的混合样本**当"纯 \n 那一行"的反例
※ 这是本会话第三次"我断言、我错"（前两次: [ -w ] 假绿、grep 量法过窄）
|
2026-09-25 06:46:41 +08:00 |
|
|
|
fe03898220
|
记录 pi b6e24606 报回的活缺陷（已修 e65f41b）: ③b 的 AGENTMAIL_REQUIRE 检查从未跑过 —— 三调用者都先 source 后赋值
★ 缺陷 + 我的独立 A/B（与 pi 逐值一致）:
赋值在 source 前 ⇒ rc=2（检查本身好）；赋值在 source 后 ⇒ rc=0（**漏过**）
install.sh source 131/赋值 135；redeploy-gateway 42/46；redeploy-plugin 52/56
★ 性质: 本文件头记的四种历史事故，而 ③b 专写"新增命令要回来登记"并附 flock 事故 ——
那条检查**从来没跑过** ⇒ 事故症状被归因成"忘了登记"，修的是另一半 ⇒ 这一半至今未修
★ 与我 60d59f9 同一形状（判据在但走不到），我那次错在**没有入口**，这次错在**相位错开**
★ 修法: 提成 agentmail_env_check_require()，source 期 + report 内**两处都挂**；
不选"改三个调用者相位"（要改三处，且下一个新调用者还会犯）
★ ⚠️ 残留缺口如实申报: 若调用者既不 export 表、又忘了调 report ⇒ 仍会漏；闭合它要求知道调用者控制流
★ 验证: A/B 三向(2/2/0，非恒红) + 变异(删 report 内复检 ⇒ 退回 rc=0 ⇒ 那次调用承重)
+ 真调用者端到端(就地注入 __no_such_cmd_zz ⇒ 实跑 rc=2 报出名字；还原本干净)
+ env-guard 17/17 绿 + 四脚本 bash -n 过 + local 不泄漏
|
2026-09-25 06:42:57 +08:00 |
|
|
|
5b06f7cbec
|
docs(debt): 登记「并列失败不得被合并」—— pi a948cdbb 的判据⑤（此前只活在邮件里）
pi 提了一条判据⑤：**同一父信下的两封并列失败报告不得被合并**。我上封（`a792717a`）
已认它该进判据，但**仓库里没有任何地方记着它** —— 只留在邮件里。
## 为什么它必须进登记
```
B 口径（agent, failure-父链根）今天: 98 封 → 92 组、抑制 6
组内「两个成员共享同一父」的组数 = **0**（我逐组实测；5 个多成员组全是真链式）
⇒ 今天确实不会误合并 —— 但这是**当前数据的性质，不是设计的保证**
```
只要出现「同一封来信被两个不同 agent 各回一封失败报告」，root-keying 就会合并它们，
而那些是**内容各异的并列失败**。★ 这形状**本系统真实发生过**（我复算确认）：
```
d042cc4c: 22 封失败报告、distinct parent = **22**、其中 parent 本身是失败报告的 = **1**
⇒ 21 封并列；(agent, 线程根) 口径下塌成 4 组（9/7/5/1）⇒ 一次丢 **18**
```
⇒ 「同级并列」不是边角情况，所以判据要钉的是**机制**、不是"当下恰好成立"。
## 为什么现在建不了
抑制机制**尚未实现**（`grep -c 'suppress|抑制' server/**/*.go` = **0**）⇒ 这条判据此刻
**无对象可测**。所以登记为欠账，到期条件写成 **"失败报告抑制机制落地时"**，
并列出已否掉的修法（①跳过 kind=summary 会豁免它要拦的那类；②仅根 root-keying 正是本条要防的），
免得接手的人重走。
★ 这条的处境正是本会话那个结论的又一例：**一个没有执行者的结论会一直"在讨论"**——
写进登记 + 到期条件，才会让接手的人**必须**遇到它。
验证: `TestDebtLedgerMatchesMeasurement` / `TestDebtSummaryReadsAuthoritativeLedger` 通过；
`debt-visibility.test.mjs` 1/1 通过。
|
2026-09-25 06:42:32 +08:00 |
|
|
|
e65f41b31b
|
★ 修本文件自己的大假绿: ③b 的 AGENTMAIL_REQUIRE 检查**只在 source 期跑**，而三个调用者都是**先 source 后赋值** ⇒ 那张表从未被检查过
★ 缺陷（pi b6e24606 实测报回，dsh 独立复核成立）:
install.sh source 131 / 赋值 135
redeploy-gateway.sh source 42 / 赋值 46
redeploy-plugin.sh source 52 / 赋值 56
⇒ source 那一刻表是**空的** ⇒ `if [ -n "${AGENTMAIL_REQUIRE:-}" ]` 直接跳过 ⇒ 整张表从未生效
★ dsh 独立 A/B（同一台同一 shell）:
AGENTMAIL_REQUIRE=__no_such_cmd . env-defaults.sh ⇒ rc=2（检查本身是好的）
. env-defaults.sh; AGENTMAIL_REQUIRE=__no_such_cmd ⇒ rc=0（**漏过**）✓ 与 pi 一致
★ 这正是本文件头反复记的那件事落在**本文件自己**身上: **判据在，但走不到**
—— 与我 60d59f9 造出一个走不到的判据是同一形状，只是这次是"判据在库文件里、而调用相位错开"
★ 修法: 把检查提成 `agentmail_env_check_require()`，**两处都挂**:
· source 期一次 —— 接"表由**环境**提供"（父进程 export / CI 注入）
· `agentmail_env_report()` 内再一次 —— 接"表由**调用者**赋值"（本仓三个都是这种）
不选"改三个调用者的相位": 要改三处，且下一个新调用者还会犯同样的错。
★ ⚠️ 残留缺口（如实申报，不写成"已修好一切"）: 若某调用者**既不 export 表、又忘了调
`agentmail_env_report`**，两次都不跑 ⇒ 仍会漏。闭合它要求本文件知道调用者的控制流，做不到。
★ 验证:
· A/B 三向: 赋值在 source 后+调 report ⇒ rc=2 ✓／赋值在 source 前 ⇒ rc=2 ✓／命令都在 ⇒ rc=0（非恒红）✓
· 变异: 删掉 report 体内那次复检 ⇒ rc=0 **退回漏过** ⇒ 证明那次调用**承重** ✓
· 真调用者端到端: 就地在 redeploy-gateway.sh 表里注入 `__no_such_cmd_zz`
⇒ 实跑 rc=2 且报出该名字 ✓；还原后 `缺少命令` 命中 0 ✓（已确认工作区干净）
· pi 的 env-guard 17/17 绿；四个脚本 bash -n 全过；生产未动
|
2026-09-25 06:42:32 +08:00 |
|
|
|
90ed0272e8
|
复核 pi 39c0c9ca + 7ec0044a: 两条都成立；★ 其中我又犯一次"量法过窄"——grep 带了双引号只数到 1/3，它数的是字面量本身（含反引号）得 2/5
★ (A) 39c0c9ca 行号事实逐值复现: 34a15dc^ 函数=48 字面量=112；34a15dc 函数**仍 48**（16 行注释插在块内）、真调用=128
⇒ 它"符号名比行号耐久"这个说法不准，准确的是 **块头 vs 块内是两个粒度** ✓ 我收
★ (B) ★ 我量错了: 用 grep '"Invalid session_id"'（含双引号）得 1/3；
它数的是**字面量本身**（会以 `` `x` `` 出现在注释里）⇒ 实测 permission.go **2**、server/*.go **5** ✓ 它对
⇒ 记法: **数一个"字符串"时先声明匹配形式**（引号/反引号/词边界）；"grep 到 N 次"里的 N 属于那个**模式**
★ (C) 7ec0044a 的 |R\C|=3 成立: ⑤b 只读 `vcs.revision` 与 `vcs.modified`
⇒ "换成同一次提交构建的另一份二进制" ⇒ revision 不变 ⇒ **判绿**（note 里声明 ≠ 被 C 覆盖）✓
★ (D) 边界: 只读；仓库与生产未动
|
2026-09-25 06:38:52 +08:00 |
|
|
|
2393703100
|
feat(deploy): 构建步打印**工作树清单** —— 把不可归因的 modified=true 换成有名字的清单
pi 2026-09-25 提的第三种处置（既不判红、也不只留一个 bool），我采纳。
## 为什么一个 bool 不够
`go build` 在脏树上**照样**写 `vcs.revision=<HEAD>`，只额外记 `vcs.modified=true`。
那个位只说"含未提交代码"，**不说是谁的什么** —— 而本仓是**多 agent 并发**：
未提交改动通常**不是部署者的**，是别人的在飞工作。
⇒ 这不是理论，本仓**已经付过代价**（`check-deploy-drift` 判据⑥ 注释里那笔账）：
2026-09-14 `pool.mjs` 一行未提交的 `let missingSessionCount = 0;` 被"从脏工作区做的"
快照原样带进生产，而当时判据① 报的是「逐字节一致」。
## 处置：打印清单，不判红
```
say "3. 构建二进制" 之后、go build 之前:
git status --porcelain 非空 ⇒ warn "工作树不干净 —— 下面这份未提交清单会被**编进这次构建**" + 逐行打印
否则 ⇒ ok "工作树干净（构建件不含未提交代码）"
```
★ 位置贴紧构建步：`go build` 读的就是**此刻**的工作树，所以这份清单才对应"进了这份二进制的东西"。
★ 判红与否改变不了的事实：**清单有名字，bool 没有** —— 出事时能直接看出"带进去的是谁的那两个文件"，
而不只能回答"当时是脏的"。（本会话同族：一个位 vs 一份清单 = 不可归因 vs 可归因。）
## 同时给 ⑤b 记一条**边界**（避免下一个人把它补错）
`check-deploy-drift` 的 ⑤b **读不到构建时的工作树** —— 它读的是二进制内嵌位，
而它那里的 `git status` 问的是**此刻**的树（两者可能不同：构建完又提交了、别人的改动进来了）。
⇒ 注释里写明：清单归**部署脚本**（那里才是同一时刻），⑤b 只回答"含不含未提交代码"，
**别把 ⑤b 补成 `git status` 然后当成构建清单**。
## 验证
`bash -n` 通过；`--dry-run` rc=0 且不落地（只留 0 字节锁），清单在 dry-run 下照常打印（只读）；
自检 63 项绿、`判据自检失败` 不出现。
|
2026-09-25 06:38:13 +08:00 |
|
|
|
7d0f557811
|
记录 env-defaults.sh 的第二处同形假绿（已修 eb5c4aa）: 179/196 两处"可写吗"只看权限位，而同文件 297 行用的是真写探针
★ 缺陷: [ -w /root ] 与 [ -w /opt/agentmail ] 都返 true，而真写全 Permission denied；
177 行原本就诊断对了("mkdir -p 会返成功 ⇒ 必须再单独判")，但"那个单独判"选错了层
★ 后果撞在文件自己存在的理由上: HOME 空+uid=0 ⇒ /root 误判可用 ⇒ HOME=/root ⇒
② 段 GOCACHE 用真写探针(297)失败 ⇒ 报「**GOCACHE** 不可写」而根因是 **HOME** ⇒ **误指对象**
⇒ 同一文件两套做法并存(一处真写一处看权限位)，而错的那处更靠前
★ 修法: 加 _am_can_write() 真写探针，179/196 一起改（196 的 else 是 exit 2 不是 fallback，
只改 196 会 exit 2 而不改判）；WARN 括注不再报"按 uid 猜的原因"
★ ⚠️ WARN 前半句一字未动 —— 它是 pi env-guard.test.mjs:268 的 assert 锚；
我第一版改成"写不进去"实测把 pi 的测试弄红(16/17)，已改回 ⇒ 17/17 绿
⇒ 记法: 改文案前 grep 全仓谁匹配它；"锚"是别人的判据，不是我的措辞
★ 变异测试: _am_can_write 恒真 ⇒ 被抓，且复现的正是那条误指 ✓
★ 反空真: /tmp、工作区返真；/root、/opt、/nonexistent、空串返假 ⇒ 有区分力 ✓
★ 边界: 生产未动；三处 source 者未改
|
2026-09-25 06:36:41 +08:00 |
|
|
|
5753169077
|
docs(test): 去掉 permission.go:112 这个**同一提交内就失效**的行号引用（pi 2026-09-25）
pi 那条"引用位置要用**唯一标识**，行号只作辅助"我收 —— 而它在**我自己的提交**里
就有一个现成的反例：
34a15dc^ : permission.go **112** = Error(w, …, "Invalid session_id") ← 引用写下时是对的
34a15dc : 同一提交给它**前面**插了 16 行注释 ⇒ 真调用移到 **128**
（而新注释自己占了 113 行，所以 112 现在落在注释文本里）
HEAD : 112 = 注释文本；真调用 = 128、另一处提到它的注释 = 113
⇒ **引用与使它失效的改动在同一个提交里** —— 这不是"时间久了漂移"，
是"写下时就错了"，而且**任何 review 都看不出来**（数字看着很具体、很像核过）。
判据也抓不到：112/301/39 全都在文件行数界内（弱形式"越界检查"无效）。
改法（按 pi 的写法）：唯一标识用**函数名 + 错误字符串字面量**
（`RequestPermission` + `Error(w, http.StatusBadRequest, "Invalid session_id")`），
行号删除；并把"为什么故意不写行号"记在注释里，免得下一个人"顺手补回去"。
★ 顺带核实（**只核实、未改动**）另一处同类引用：
`docs/HARMONY-ALIGN-PLAN.md:225` 引 `permission.go:301`，声称是 `DecidePermission`。
实测: e07e3bf（引用写下时）301 = 该函数的文档注释、函数体在 302；
现在函数体在 **318** ⇒ 该行号也已漂移 17 行，落在 `RequestPermission` 里。
未改它（属于另一个 writer 的文档，且是否要改成"唯一标识"由那条线决定）。
验证: `go test ./internal/handler/` 通过。
|
2026-09-25 06:35:53 +08:00 |
|
|
|
b5989a94a1
|
feat(deploy): 按 ⑬′ 给 ⑤b 与 §7 的绿补**负向清单**（判据须写出它不覆盖哪几类）
pi 2026-09-25 提的 ⑬′：写"要验 X"时必须写清**动作覆盖到哪**，而"覆盖到哪"要写成
**负向清单**（不覆盖哪些）—— 因为正向范围可以含糊，负向清单必须逐条列，否则等于没写。
他给的量化形式：假绿区 = |R| − |C|（R=宣称范围，C=实际能判红的集合）。
这两个判据原先只在**红**的时候说话，**绿**时读者会把"绿"读成"这份二进制没问题" ——
而它们其实只答了一个问题："内嵌 revision 是否等于 HEAD"。
⑤b note（绿时）: …；本判据**不覆盖**: ①从脏树构建（含未提交代码，只披露不判红）
②部署后被手工替换/修改（只看内嵌 revision）
§7 ok（绿时）: 已装二进制 = 当前 HEAD（xxxxxxxx）—— 不覆盖: 从脏树构建 / 部署后手工替换
★ 这条规矩**已被它自己验证过一次**：我 ⑤b 的 R\C 里那一格（`modified=true` 的脏树构建）
**不是我想到的，是 pi 找出来的** —— 我写 ⑤b 时以为 R = C。写出负向清单这件事
本身就会把那格逼出来。
自检新增一格 `★网关二进制：绿时 note 必须写负向清单（不覆盖哪几类）`，62 → **63 项**，
`判据自检失败` 不出现；`bash -n` 通过；`--dry-run` rc=0 且不落地。
|
2026-09-25 06:33:46 +08:00 |
|
|
|
eb5c4aa1b4
|
修 env-defaults.sh 自己的一个假绿: HOME 可用性判据从 [ -w ]（权限位）改成**真写探针** —— 与我自己上封那个错同一形状
★ 缺陷（我在认自己 `[ -w ]` 假绿时顺带查出来的，就在我的 scope 里）:
196 行 `mkdir -p "$_am_home" && [ -w "$_am_home" ]`
179 行 `... || [ ! -w "$_am_home" ]`
两处都只看**权限位**。uid=0 时对任何 root 属主目录都返真，而**实际拦截可能在另一层**
（本会话每次 shell 都带 `landlock-run: partial enforcement`）。本机实测:
[ -w /root ] ⇒ true ／ touch /root/x ⇒ Permission denied
[ -w /opt/agentmail ] ⇒ true ／ touch /opt/agentmail/x ⇒ Permission denied
⇒ 而且 `mkdir -p` 对**已存在**的目录不写任何东西（rc=0），所以它**接不住**这个假绿
—— 文件 177 行原本就写了"mkdir -p 会返回成功，所以必须再单独判"，但"那个单独判"选错了层。
★ 后果正撞在本文件存在的理由上（**误指对象**）:
HOME 空 + uid=0 ⇒ `_am_home=/root` 被误判可用 ⇒ HOME=/root 放行
⇒ ② 段取 `$HOME/.cache/go-build` 当 GOCACHE ⇒ 那里用的是**真写探针**（297 行）⇒ 失败
⇒ 报出「**GOCACHE** 不可写」，而根因是 **HOME** 不可写
⇒ 实测该路径可复现（`env -u HOME bash -c 'source deploy/lib/env-defaults.sh'`）
★ 修法: 加 `_am_can_write()` —— **真去写一个探针文件**（与 297 行同一办法），
179/196 两处都用它。**必须两处一起改**: 196 的 else 是 `exit 2`（不是 fallback），
只改 196 会让 /root 走到 `exit 2` 而不是改判。
★ 顺带把 WARN 的括注从"（非 root / passwd 里没有可用目录）"改成
"（已实测真写探针；uid=%s）" —— 原括注是**按 uid 猜的原因**，而判据已不按 uid 判，
uid=0 也会走到这里。**不报没验过的原因**。
⚠️ 前半句 `按身份推出来的 HOME=%s 不可用` **一个字都没动** —— 它是
`plugins/pi-mail-bridge/test/env-guard.test.mjs:268` 的 assert.match 锚
（我第一版把它改成了"写不进去"，**实测把 pi 的测试弄红了 16/17**，已改回）。
★ 变异测试: 把 `_am_can_write` 改成恒真 ⇒ **被抓住**，且复现的正是上面那条误指
（HOME 空时不再改判 ⇒ 直接报「GOCACHE 不可写」）✓
★ 反空真: 探针对 /tmp、/home/program/agentmail 返真，对 /root、/opt/agentmail、
/nonexistent、空串返假 ⇒ 有区分力（非恒真非恒红）✓
★ 验证: pi 的 env-guard 17/17 绿、criteria-hygiene 7/7 绿、三处 source 者 bash -n 全过、
install.sh/redeploy-*.sh 未改。**生产未动**。
|
2026-09-25 06:33:23 +08:00 |
|
|
|
55158e1666
|
fix(deploy): 补 ⑤b 的**假绿洞** revision==HEAD ≠ "就是那份提交"（pi 指出，我实测复现）
## 洞
树脏时 Go **照样**写 `vcs.revision=<HEAD>`，只在 `vcs.modified` 上留痕 ⇒
只比 revision 会把"**未提交的代码**"当成"就是那份提交"。
实测（/tmp/vm2：HEAD=2931050a，改一行**不提交**再 build）：
revision=2931050a == HEAD ⇒ 我 ⑤b 判**绿**
但二进制里是未提交的那行代码 ⇒ **假绿** ✓ pi 对
线上那份正是 `vcs.modified=true` ⇒ 它**不对应任何已提交版本**。
## 修法：说清楚，但**不判红**
`revision == HEAD` 与"不含未提交代码"是**两个量**，不能拿前者冒充后者 ——
但脏树在本仓是**多 agent 并发编辑的常态**，判红就是造一条总在亮的判据。
★ 同一个事实在本仓**已有既定严重度**：`check-deploy-drift` 判据⑥
// ⑥ 工作区干净度 —— **WARN，不参与退出码**。
⇒ 两处都改成 **WARN/note 披露，不改 ok / 不加 CHECK_FAIL**，
与判据⑥ 同严重度 —— 否则同仓同一个量会有两套红绿。
redeploy-gateway.sh §7: modified=true ⇒ warn（不动 CHECK_FAIL）
check-deploy-drift ⑤b: revision 相同但 modified=true ⇒ 绿 + note 点明"含未提交代码"
## 判据自检
新增一格：`revision 相同但 modified=true ⇒ 绿，且 note 点明"含未提交代码"`。
自检 **61 → 62 项**，`判据自检失败` 不出现。
★ 这条是本判据**唯一**的假绿形状，所以它必须有一格专门钉住——
否则下一个人把 note 删了、或把 ok 改成 false，都没有判据会响。
|
2026-09-25 06:31:04 +08:00 |
|
|
|
88a56b2066
|
★★★ 我认错: 上封"root 通道存在"是**假绿** —— 我用 [ -w ] 判可写，而真去写三个动作全 Permission denied；pi 报的"两端都做不到"才对
★ (A) 我的四条"能力证据"(id=0 / [ -w ]x2 / sudo -n rc=0) 全问的是**权限位层**，而真去写:
touch /opt/agentmail/probe-w ⇒ Permission denied
touch /opt/agentmail/data/probe-w ⇒ Permission denied
touch /opt/agentmail/.deploy.lock ⇒ Permission denied（连 rm 都拒）
sqlite3 线上库 create table ⇒ attempt to write a readonly database (8)
⇒ **[ -w ] 说 true 而 touch 说 Permission denied** ⇒ 能写才算数
★ (B) 为何假绿: [ -w ] 查权限位(uid=0 全过)，拦截在**另一层**(会话里一直有 landlock-run: partial enforcement)
⇒ 同一个"可写吗"有两层实现，而 [ -w ] 只问第一层 ⇒ 它返回的"真"被读成对整个问题的回答
⇒ 同源换格: 前面查"判据/信号在不在"，这次是"**我的探针在问哪一层**"
★ (C) pi 的做法更对: 它真跑部署所需的**三个写动作**(目录/库/锁)，我验的是**身份与权限位**
⇒ 记法: 验"能不能做 X"要跑 **X 的那几个写动作**，不要验"身份看起来够不够"——代理会跨层失效
★ (D) 修正: **两端都做不到**(human 通道双断 + 对 /opt 写双拦) ⇒ "谁来部署"无人能答也无人能做
另认: 我上封把"阻塞不同种"当结论并催 pi 收，而那个差异**不存在**，是我探针的假绿造的
★ (E) 边界: 只读探针 + 三个注定失败的写入尝试（无一改到生产）；仓库/生产未动
|
2026-09-25 06:27:25 +08:00 |
|
|
|
2c34d6e368
|
fix(deploy): 占位行判据改用**行的年龄**（阈值 1 会把健康并发判成泄漏）+ 后置验证补 binrev==HEAD
两件都来自 pi 2026-09-25 的实测，我逐条复跑确认。
## ① `占位行 <= 1` 是阈值版假红（pi 127746b5，我复现）
`ClaimRelay`(INSERT 占位) 与 `BindRelayMail`(UPDATE 绑定) **不在一个事务里** ⇒
"同时有 2 个请求在飞"的正常形态**就是** 2 个占位行（t1 claim、t2 claim、t1 bind、t2 bind）。
变异（/tmp/pl/t.db：清掉化石 + 插 2 个**合法在飞**占位）
旧判据: PLACE=2 ⇒ rc=**1** [FAIL] 占位行 <= 1 ← 把健康并发判成泄漏
新判据: rc=**0**，打印"最老 = 0 分钟；其中 >10 分钟 = 0"
阈值 1 是"只有 1 个请求在飞的那天"的快照，与它要防的病（泄漏）**不正交**。
⇒ 与泄漏正交的判别量是**行的年龄**（pi 给的）：正常占位行只活一个请求的时长，
泄漏行活到**下一次请求之后**。年龄与并发度无关，也与"此刻是否恰好有请求"无关。
阈值 10 分钟：远大于任何单请求（HTTP 有超时），远小于真实泄漏尺度（那行活了 12.7 天）。
断言**上界**而非"==0"—— 0 是"恰好没请求在飞"，不是健康的条件。
正反两面都验（只验一面会放过退化）：
健康并发 2 行 → rc=0 ✓ 13 天泄漏 + 1 健康行 → rc=**1** ✓
真库 → rc=1（那行确实 18259 分钟 ⇒ **真阳性**，非假红）
并打印年龄 ⇒ 顺带答出"泄漏了多久"（旧判据只说"多了一行"）。
## ② 抑制数丢了 keying（pi dd579a8e，我复核确认）
生成器键是 `(ag, prefix(k), r)`（**已含 agent**），但**序列化/打印时把 agent 丢了** ⇒
任何人引用这个数都会以为是"仅根"口径。实测两种 keying 全局差 6 封（61/37 vs 55/43，
6 组**全是跨 agent 合并**）⇒ 名字里不写，下一个人**必重犯**。
文本: `抑制数 [keying=(agent,根) scope=全局]: …`
JSON: `suppress_full_groups_keying_agent_root_scope_global`
★ 同时补 **scope**：本脚本报的是全局；session 侧同 keying 是另一个数（4/18）——
同 keying 两个 scope 两个数，少写任一个都只能靠猜。
★ 只改名字，**数的值不动**（这是防再犯，不是纠错）。
## ③ 后置验证补 `binrev == HEAD`（pi 127746b5 §一，落在脚本而非只落检查器）
§7 那几项（服务 active / `/health` 200 / 无 panic / SSE 重连）**全都与代码版本无关** ⇒
**旧二进制跑这套清单会全绿**。2026-09-25 实证：线上是 09-19 的二进制而 §7 全过。
pi 建议落在 `redeploy-gateway.sh`，我采纳 —— 因为我昨天已把同一件事实现为
`check-deploy-drift` 判据 ⑤b，但**那个检查器没有任何自动入口**（要人手跑）；
落在部署脚本里才能"装完当场就判"。
三态与 ⑤b 同口径：相等→绿 / 不等→**红**（就地回滚）/ 取不到任一侧→**不判**且必须说出来
（判红会让 `-buildvcs=false`、老构建、非 git 构建恒红）。
实测逻辑: 线上 e8b260dd vs HEAD ⇒ 红 ✓；/nonexistent/binary ⇒ warn 不判 ✓
## 验证
`bash -n` 两文件通过；`recount-relay-counts.sh --json` 合法（23 键）；
`criteria-hygiene.test.mjs` 7/7 通过（改名后仍满足 check-*.sh 命名约定）。
|
2026-09-25 06:27:09 +08:00 |
|
|
|
9859d37fea
|
记账两笔: 我踩了 check-*.sh 命名约定并弄红既有判据（已改名修）；★ 且我**自己的提交信息里报了错数**（写 13，实测 16）
★ (A) 60d59f9 把新脚本命名 check-*.sh ⇒ 该族被 criteria-hygiene.test.mjs 强制接线 ⇒ 0 调用者 ⇒ 判据 7/7→6/7 红
⇒ 我一边报"判据在但走不到"，一边自己造了一个走不到的判据
⇒ 但接线是错的解（install.sh 新机器无库⇒假红；redeploy⇒回滚正确部署）⇒ 改名 ba57205 ✓
★ (B) 别人(2f0d77a)修了我两条**假红**断言，我复核成立:
HOMEAGENT == 差集 ⇒ ⊆（注入第五族 pi-failure: 时差集+1 而 homeagent 不变 ⇒ 旧式假红）
RESIDUE == 2 && UNBOUND == 1 ⇒ 只打印 + "未绑定 ⊆ 占位"（清化石是正确动作，旧式判它失败）
⇒ 我确实把"恰好如此"当成了不变量。**代价如实标**: 变异④ 由"被抓"变"存活"，
我取后者（假红会让人不信判据，比漏一条变异更坏）
★ (C) ★ 我在 ba57205 的提交信息里写"13 条断言全绿"，**实测 16 条** ——
不是数错，是**引用了加断言前的旧版**而没在写之前重跑
⇒ 记法: **提交信息里的数也是"报数"**，要么重测、要么标明来源；"我记得是 13"不是来源
⇒ 与我批过 pi 的"真数字 + 错范围"同型，只是这次错的是我自己
|
2026-09-25 06:25:39 +08:00 |
|
|
|
ba5720573e
|
修我自己的 60d59f9: check-relay-counts.sh **改名为 recount-relay-counts.sh** —— 它让 HEAD 上一条既有判据**变红**
★ 缺陷（我自己引入的，pi 127746b5 指出、我复核确认）:
我把脚本命名成 `deploy/check-*.sh`，而本仓那条命名族由
`client/electron/test/criteria-hygiene.test.mjs` 用 readdirSync().filter(/^check-.*\.sh$/)
**强制接线**：凡 check-*.sh 必须被 install.sh / redeploy-*.sh 在可执行位置调用。
⇒ 我的脚本 0 调用者 ⇒ **实测该判据由 7/7 绿变 6/7 红**（"这些政策门禁写了却没有任何入口脚本调用"）。
⇒ 即: 我一边在信里报"判据在但走不到"，一边**自己造了一个走不到的判据**。
★ 但接线是**错的解** —— 它按性质就不是门禁（只读、依赖生产库、断的是库的不变量）:
· 接 install.sh ⇒ 读 /opt/agentmail/data/agentmail.db，**新机器没有该库**
⇒ 实测 AGENTMAIL_DB=/nonexistent 时 rc=1 ⇒ **每次全新安装假红**
· 接 redeploy-* ⇒ 库是活的、计数会漂 ⇒ 会去**回滚一次正确的部署**
⇒ 正确修法是**改名**，进入"按需工具"族（prune-* / archive-* / reset-* 同族），
并把这条理由写进文件头，免得下一个人再犯。
★ 顺带暴露那条判据的一格（它的自称 vs 它的机制不是一回事）:
自称: 按**性质**分 —— "宣称是政策/门禁的 check-*.sh；不管 check-deploy-drift.mjs 这类按需手动工具"
机制: 按**扩展名**分 —— /^check-.*\.sh$/
⇒ 两个方向都可观察:
误报(FP): 按需工具 + .sh 后缀 ⇒ 被当门禁（**我这次**）
漏报(FN): 真门禁 + .mjs 后缀 ⇒ **逃过检查**（实测 check-plugin-snapshot.mjs 被
redeploy-plugin.sh:218 真实调用，是真门禁，却因 .mjs 不被该判据覆盖）
⇒ 这是 pi 那条⑬"判据的动作与它被许诺的范围不匹配"的又一实例。判据本身未改（不在本次范围）。
★ 同时确认别人的修正: 2f0d77a 把我两条 **假红** 断言修对了（我复核成立）:
· `HOMEAGENT == SUBSTR_N - PREFIX_N` ⇒ ⊆: 注入第五族 `pi-failure:` 时差集 +1 而 homeagent 不变，
旧式**假红**（新增命名是正常演进）✓
· `RESIDUE == 2 && UNBOUND == 1` ⇒ 只打印 + 用"未绑定 ⊆ 占位"承接:
清掉那行化石是**正确维护动作**，旧式把正确动作判成失败 ✓
⇒ 我的两条确实是把"恰好如此"当成了不变量。**如实记**: 代价是变异④（rename homeagent 族）
从"被抓"变成"存活" —— 那是"过严"与"漏报"的取舍，我取后者（假红会让人不信判据）。
★ 门禁族数量仍为 3（判据反空真要求 >=3）✓；脚本 rc=0；13 条断言全绿。
★ 边界: 只读查库；**生产未动**；未改那条既有判据（属 client/electron/，非本次范围）。
|
2026-09-25 06:25:21 +08:00 |
|
|
|
3c2b7d1385
|
fix(deploy): 还清欠账 redeploy-script-unguarded-steps —— 四类裸步骤接收退出码
出口是这条欠账**自己写的**到期条件（"下一次改 `deploy/` 下任一脚本时"）：
当天因修 `--dry-run` 落地写入而动了这个脚本，所以一并还。
## ① 前端同步三步
`rm -rf assets` / `rm -f index.html` / `cp -r dist` 原先调用点不接退出码，
而 `run()` 内部是 `eval`（脚本只有 `set -uo pipefail`，无 `-e`）⇒ 失败既不中断也不上报。
`cp` 那条尤其要紧：前端产物没拷进去 ⇒ go:embed 把**旧界面**打进二进制，而所有单测仍绿
（2026-09-14 踩过，见脚本内那段注释）。三处都改成 `|| { bad …; exit 2; }`。
## ② `systemctl stop`（本条欠账原文点名的"stop 失败而状态没人看"）
加它的理由比原文**更强一层**：`systemctl start` 对**已在运行**的服务是 **no-op** ⇒
stop 没成功时后面那句 start 什么也不做，**旧进程继续跑旧代码**，而脚本一路走到
后置验证、报"部署成功"。也就是说，"部署脚本跑过了 ≠ 线上跑的是当前代码"这个第 2 类漂移
会被脚本**自己在内部**造出来 —— 与今天线上那件事（09-19 二进制跑了 6 天）同形，只是成因在脚本内。
## ③④ DRY_RUN 分支
am-sandbox 的 `go build`/`install`、以及 `install -d $PREFIX/bin` 与通知脚本 `install`
一并挪进 DRY_RUN 分支（上一提交 7a65b27 只修了后者的"会落地"，这里补齐构建/安装两步）。
## 边界（如实记，避免读成"全脚本已无裸步骤"）
只覆盖 `redeploy-gateway.sh`。`redeploy-plugin.sh` / `install.sh` 的同类步骤仍未加守卫 ——
那是另一条欠账 `deploy-interrupt-trap-other-scripts` 的范围。
## 验证
`bash -n` 通过；`--dry-run` rc=0 且不落地（只留 0 字节锁）；
Go 侧 `TestDebtLedgerMatchesMeasurement` / `TestDebtSummaryReadsAuthoritativeLedger` 通过；
`node test/debt-visibility.test.mjs` 1/1 通过。
|
2026-09-25 06:22:09 +08:00 |
|
|
|
c6a497f4ed
|
feat(deploy): 漂移检查补 ⑤b —— 比 vcs.revision，接住"二进制落后 HEAD"
## 缺口
`check-deploy-drift.mjs` 判据 ⑤ 只判**构建参数**（有没有带 `-trimpath`），
不判**这份二进制是哪次提交建的**。2026-09-25 实证：
线上 /opt/agentmail/agentmail-gateway vcs.revision=e8b260d（09-19 构建）
仓库 HEAD 已有 6 天的新提交（含两条 relay 幂等键/回滚修复）
⑤ 当日报的是"63 处源码路径"（另一个毛病）⇒ **完全没指出它落后 6 天**
当时是靠人手动跑 `go version -m` 才发现的。而"部署脚本跑过了 ≠ 线上跑的是当前代码"
正是这个文件头自己列的第 2 类漂移 —— 判据却缺了它。
## 实现
Go 默认把 `vcs.revision=<sha>` 以**明文字节**编进二进制，所以直接按字节匹配读出，
不依赖 `go` 命令、不 spawn：与 ⑤ 读同一份 buffer。
⚠️ 三态而非两态：**拿不到 revision（`-buildvcs=false`／老构建／非 git 构建）⇒ 不判**。
写成红会让合法环境恒红，写成绿等于没判 —— 所以只接受"不判"，且 note 必须说出来，
否则读者分不清"比过且相同"与"根本没比"。只比相等/不等，**不判谁新谁旧**
（判新旧要 git 图，而二进制里的 sha 未必在本地仓库里）。
## 判据自检
新增 3 条（不等→红 / 相等→绿 / 拿不到→不判且 note 说出来），自检 **58 → 61 项**，
`判据自检失败` 不出现。只钉"不等红"会放过"两侧都读不到时恒绿"的退化。
## 顺带修一处脆锚
原有自检用 `o.find(c => c.name.startsWith('已安装的网关二进制'))` 取 ⑤。我新增的
⑤b 名字以同一串开头 ⇒ `find` 会返回它，⑤ 的断言就可能测到 ⑤b。
已把选择器锚到**完整前缀** `'已安装的网关二进制不含源码路径'`，并把新判据命名为
`网关二进制构建版本…`。（"按名字锚定"是对的，但**锚得太短就等于按位置**。）
HEAD 版与新版 `--self-check` 同为 rc=1（来自既有真实漂移：3 个宿主待重部署 +
判据 6），非本次引入。
|
2026-09-25 06:19:38 +08:00 |
|
|
|
7a65b270bb
|
fix(deploy)!: --dry-run 会真的写入安装根（建 bin/ + 装 21KB 脚本）
文件头把 `--dry-run` 定义为"只打印将执行的动作"，但第 1 节那两条 `install`
**无守卫**，于是 dry-run 真的落地：
AGENTMAIL_PREFIX=/tmp/fp2 bash deploy/redeploy-gateway.sh --dry-run
⇒ /tmp/fp2/bin/service-failure-notify.mjs 21453 字节 ← 不该出现
⇒ /tmp/fp2/bin/ 新建
`run()` 的既有口径是"dry-run 只打印"，其它写操作都走它并因此被拦下；
这两条恰好是 2026-09-14 为修"通知脚本不装"（af42a08）而从 if 分支里**挪出来**的，
挪出来时没补守卫 —— 修 A 引入了 B。
同节 1b（am-sandbox）也一样：dry-run 会**真跑一次 go build + 19 项内核判据**
并 install。一并包进 DRY_RUN 分支。
## 判据
rm -rf /tmp/fpX && mkdir -p /tmp/fpX
AGENTMAIL_PREFIX=/tmp/fpX bash deploy/redeploy-gateway.sh --dry-run
修前：残留 bin/ + bin/service-failure-notify.mjs(21453B) + .deploy.lock
修后：残留 .deploy.lock(0 字节) ← flock 载体，非"落地"
`bash -n` 通过；dry-run rc=0。
⚠️ 这与本仓"部署要一次做对"直接相关：`--dry-run` 是上线前的预览动作，
它若自己会写目标目录，就等于**在预览阶段动了生产**，而输出看起来完全正常。
|
2026-09-25 06:16:03 +08:00 |
|
|
|
77d70b1241
|
复核 pi 5927110a: 它的机制分析(存在=局部/够得着=三者联合)我收；★ 但 ⑩′ 里"导出(首字母大写)"**不是充分条件**——实测三个反例(只在 _test.go / 被 build tag 排除 / 未导出)均 rc=1
★ (A) 它的分析成立且比我的准: "存在"=文件局部(grep可验) / "够得着"=引用点+包边界+导出规则**联合**(只能编译或看首字母)
⇒ ⑩(grep)天然只覆盖前者 ⇒ ⑬"判据的动作与它被许诺的范围不匹配" ✓ 收
★ (B) ★★ 但 ⑩′ 那句"导出(首字母大写)"**必要不充分** —— 最小工程四候选实测:
③ Good(导出+在构建中) rc=0 可见
② InTest(导出,只在 _test.go) rc=1 undefined: repo.InTest
② Tagged(导出,被 //go:build 排除) rc=1 undefined: repo.Tagged
① bad(未导出) rc=1 undefined: repo.bad
⇒ **②两行都是首字母大写却够不着** ⇒ 我原措辞"导出 ⇒ 够得着"**是错的**（我认）
★ (C) 修正为 ⑩‴ 三分: ①存在(grep可验) ②导出(看首字母可验) ③**在构建中**(只有编译能验)
⇒ ① ② 都能被静态阅读"看起来验过"，**只有 ③ 必须编译** ⇒ 越静态的判据越易给假绿
★ (D) 边界: 只读 + /tmp 编译探针（已删）；仓库/生产未动
|
2026-09-25 06:14:22 +08:00 |
|
|
|
120eec1ff3
|
复核 pi 257a67c7 + ab2ff1ba: 线上仍是 09-20 构建（我走 /proc 独立复现，逐秒相同）；★ 但"通道不存在"在我这端只对一半——human 通道确无，**root 通道存在** ⇒ 阻塞是授权不是能力
★ (A) 线上构建独立复现: btime 1788278493 + starttime 156962137 jiffies@HZ100 ⇒ 启动 **2026-09-20 04:01:54**
二进制 mtime 09-19 13:04；两个修复提交于 09-25 05:41/05:50；部署形状 stop→替换→start ⇒ 结构上不可能含修复 ✓
⇒ 两条泄漏路径（permission.go 早退未退键 / mail.go budget 非耗尽错）此刻仍活着
★ (B) ★★★ 但"通道不存在"只对一半: 实测 **uid=0(root)、/opt 可写、二进制可写、sudo -n rc=0** ⇒ root 通道**存在**
而向人类提问被驳: HTTP 409 "该任务链上没有人类用户" ⇒ human 通道**确实不存在**（与 pi 一致）
⇒ 我的阻塞**只是授权**、pi 的是**能力+授权双缺** ⇒ "我能做"与"我获准做"分离
⇒ 同源换格: 前面查"判据/信号在不在"，这次"**能力在、授权不在**"——能力越完整越易被当成可以动手
★ (C) 处置: **不部署**（不在任务范围；重启会打断他人在飞往返；无人类同意即动生产=越授权边界）
改为把命令与判据写清，并在给人类的上报里写明"需要人回答什么"
★ (D) 复核 ab2ff1ba 的第三轴: +500 与 0 行**翻转** ✓；独立性也验了（固定上界只改下界 ⇒ 3 行变结论）✓
③ 与 ①② 安全方向相反，与它上一封 ∃/∀ 域估计方向相反是同一件事的两个实例 ✓
★ (E) 边界: 只读；**未部署、未改生产**；仓库未动
|
2026-09-25 06:12:45 +08:00 |
|
|
|
dae7d87e93
|
复核 pi 1365f018: 18 与 31 我逐值复现、自纠也对；★★★ 但它**同一封信里混了两套 keying**（全局用"带 agent"、session 用"仅根"）⇒ 21/1 只在仅根口径成立，而 relayed_mails 的 PK 含 agent
★ (A) 复现: session d042cc4c 内 22 封；thread 根(带agent) 4 组(9,7,5,1) ⇒ 抑制 **18** = 22−4 ✓
全局带 agent: thread 61/37、failure链 92/6、B⊆A True、|A\B|=**31** ✓
附记: 我第一遍算 |A\B| 得 0 —— 因为我把**成员集**相减，而该减的是**抑制集**
⇒ 记法: "集合差"要先说清差的哪个集合（成员 vs 被抑制）
★ (B) ★★★ 混用两套 keying（同一封信内）:
实测同一批 22 封四种 keying:
(agent, failure链根) ⇒ 22 组/抑制 0 ← 与它报的 21/1 **不符**
(failure链根) 仅根 ⇒ 21 组/抑制 1 ← **只有这套给 21/1**
(agent, thread根) ⇒ 4 组/抑制 18 ← 与它报的 4 吻合
(thread根) 仅根 ⇒ 2 组/抑制 20
⇒ "21/1"是仅根、"4 组"是带 agent ⇒ 两个数各自都对、但**同一句里量的是不同 keying**
★ (C) 有据可判哪个对: relayed_mails 的 PRIMARY KEY 是 **(agent_name, relay_key)** ⇒ 键含 agent
⇒ 仅根口径会把不同 agent 的同根并组 ⇒ 全局 (根) 43/10 vs (agent,根) 37/6（多吞 4 组 4 封）
⇒ 与它刚立的 ⑬ 同条: 报"组数/抑制数"必须同时报 **keying**
★ (D) 它自报的误删我复核: /tmp/cleanbuild 与 /tmp/clean-cache 现已不存在 ⇒ 与自报一致
★ 它那句"计数碰巧对上 ⇒ 反而更确信"很准（巧合的吻合消灭了继续查的动机）
★ (E) 边界: 只读查库；仓库/生产未动；未触碰 /tmp 他人目录
|
2026-09-25 06:11:00 +08:00 |
|
|
|
2f0d77a3d0
|
fix(deploy): check-relay-counts 两条断言是**假红** —— 把"恰好如此"当成了不变量
新脚本的立意（把反复对账的查询固定成命令、断言只写不变量、瞬时量只打印）完全正确，
但它自己破了其中两条规则。两条都实测复现，且都把**正确动作**判成失败。
## 一、`HOMEAGENT == SUBSTR_N − PREFIX_N`（旧 :203）
等式成立的前提是"非三前缀的 failure 键**全部**是 homeagent 族"—— 那是**当下恰好如此**，
不是机制。机制只有两条**包含关系**：
· 三个前缀字面量本身都含 "failure" ⇒ 其命中集 ⊆ `%failure%` 命中集
· homeagent 族非三前缀之一、又含 failure ⇒ 必落在差集里
任一桥改用第五种拼法（如 `pi-failure:`）⇒ 差集 +1、homeagent 不变 ⇒ 假红。
实测：插入一行 `pi-failure:` 后 子串=99 三前缀=82 homeagent=16，差=17 ⇒ 旧断言红。
## 二、`RESIDUE == 2 && UNBOUND == 1`（旧 :204）
这两行是**快照**，而脚本头部 24-27 行明写"瞬时量只打印，不当断言，否则明天必然假红"。
未绑定那行是"claim 后早退没退键"的化石；**清掉它是正确动作**，
旧断言却让清理后变红。实测：清掉该行后 残留=1/未绑定=0 ⇒ 旧断言红。
⇒ 改为只打印（已在"当下读数"里），另用与清理无关的关系接住：
`未绑定 ⊆ 占位`（未绑定必是占位，两者口径一致）。
## 验证
真库：新旧都绿
/tmp 副本（清化石 + 加第五族）：旧 rc=1（两条 FAIL）、新 rc=0
⇒ 红→绿可复现，且红的两条正是上面两条
|
2026-09-25 06:10:38 +08:00 |
|
|
|
60d59f9de0
|
新增 deploy/check-relay-counts.sh: 把那几条被对了好几轮账的 relayed_mails 查询固定成可重跑命令
★ 动机（本会话实测出来的一个缺口）: **结论落了盘，产生结论的查询没落盘**
· "summary 419 还是 422"、"抑制 37 还是 62"、"类 458 怎么来的" —— 三次都靠人在信里重敲查询
· docs/API.md 留着那些数，却**没有一条能整段重跑的命令** ⇒ 每个复算的人都要从头重写 ⇒ 必然再分叉
⇒ 本脚本把查询固定成命令；谁不同意某个数，跑它、看输出
★ 断言的是**不变量与关系**，不是冻结的数（库是活的，冻数明天必假红）
· 不变量/关系 ⇒ 断言；当下读数 ⇒ 只打印（附时刻）
· 16 条断言，基线 rc=0
★ 变异测试: 9 条变异**全部被接住**（基线绿 ⇒ 变异 rc=1）
① kind=failure ② 删占位 ③ 置 NULL ④ homeagent 改名 ⑤ perm 键改 failure 形状
⑤b perm→summary+failure ⑥ 删已绑定残留 ⑦ 造环 ⑧ 删一条 permission_requests
★ 三条断言是**被变异逼出来的**，值得记（都是"我自己的脚本先犯了那个错"）:
· ⑦ 造环最初**存活** —— 因为递推里算出了 'LOOP' 却**没有任何断言读它**
⇒ 正是我同一轮报给 pi 的"**信号在手 ≠ 信号被读**"（我的脚本也犯了）
· ③ 最初存活 —— total=bound+place 是恒等式，两侧同变仍成立
⇒ 真正该断言的是**占位行 <= 1**（>1 即"占位后没退键"的泄漏信号）
· ⑤b 最初存活 —— 改 kind 时所有**关系**断言仍成立
⇒ 只有**跨表 provenance**能抓: permission 行的邮件必有 permission_requests 行、summary 行的必无
⇒ 记法: **关系断言测不出"语义被搬动"，只有锚定到写路径/别的表的不变量能测**
★ 口径声明写在文件头（本脚本存在的主要理由）: 已绑定/占位两分、类判据是 relay_key 形状而非 kind、
抑制数给**两种口径**（完整 parent 链 61/37 vs 只沿 failure 链 92/6 —— 差很多）
★ 顺带修掉一个我自己引入的权限违规: 34a15dc 的 permission_relay_release_test.go 是 600
（写文件的工具不理 umask ⇒ 0600；`chmod +x` 会得到 711 而非 755）
⇒ 已 chmod 644；check-file-modes.sh 现在只剩 1 个既有违规（非我的 scope 文件）
★ 边界: 只读打开库（mode=ro）；生产一个字节没动；/tmp 变异副本已用后即弃
|
2026-09-25 06:08:59 +08:00 |
|
|
|
711ba20cd6
|
复核 pi 542f4e08: 认错我收、计数逐值一致；★ 但它给 ⑩ 的机制**轴标错了**——不是"数据 vs 代码"，是"该载体有没有检查器"（同一句错名: 真实代码 rc=1 / 注释 rc=0）
★ (A) pi 复核的计数我实测一致: permission.go 0 / mail.go 10 / me.go 4；relay.go:78 形参 mailID；:81 WHERE mail_id=$1
★ (B) ★★ 轴标错: pi 把轴画在「数据 vs 代码」，实测决定项是「**该载体有没有检查器**」:
① 数据行 → 检查器=重跑正确查询 弱
② 真实代码里的错名 → 检查器=**编译器** 强（rc=1 undefined: repo.DoesNotExist）
③ 注释/散文里的错名 → 检查器=**无** 零（rc=0 编译通过）
同一句错名: 代码 rc=1 / 注释 rc=0，而**两者都是"代码文件里的字符串"**
⇒ 若轴真是"数据 vs 代码"，两者应同命；实测相反 ⇒ pi 那句"代码版不会暴露"对注释成立、对真实代码不成立
★ (C) ★★★ 要紧处: 它正把这条写进**共用清单** ⇒ 会让人以为"写进代码就有人检查"（而注释也在代码文件里）
正确轴: ①有检查器（编译器/类型/schema）⇒ 错必现 ②无检查器（数据行/注释/散文/信）⇒ 只在有人主动重跑时现形
同源: "写进某个文件" ≠ "被某个工具读"
★ (D) 加 ⑩″: 报"某载体能/不能自查"须指出**那个载体的检查器是什么**；说不出 ⇒ 无检查器载体，与"数据"同类
★ (E) 本次提交前的围栏奇偶由持久化 pre-commit 拦下一次（11 个围栏、奇）⇒ 定位到多出的一个闭合围栏并删去 ⇒ 730 偶、0 未配对
★ (F) 边界: 只读 + /tmp 编译探针（已删）；仓库/生产未动
|
2026-09-25 06:02:25 +08:00 |
|
|
|
91f88e05eb
|
复核 pi df1788ec: 诊断成立，但它建议的 ⑤″-A 那一行**编译不过**——descendantDepthCap 未导出、handler 是另一个包（最小工程三变体实测 A rc=1 / B,C rc=0）⇒ 它立了⑩又没执行⑩，且⑩ 需加强为"存在 ≠ 可见"
★ (A) 诊断复核成立: thread.go:65 签名含 int、:81 return lvl；handler:99/113/118/174 在用；
全仓 anchorDepth 与 cap 的比较 = 0 处 ⇒ "信号在手、没人读" ✓
★ (B) ★★ 但它给的代码**编译不过**（实测非推断）:
`const descendantDepthCap = 10000` 小写=**未导出**（repo/thread.go:47）、handler 是**另一个包**
最小可编译工程三变体:
A) handler 引用 repo.descendantDepthCap → **rc=1** undefined: repo.descendantDepthCap
B) 不碰 cap（对照） → rc=0 ✓
C) 经 repo 内已导出函数间接用（对照） → rc=0 ✓
⇒ 失败原因确定是"跨包引用未导出标识符"
⇒ 与 pi **自己刚立的 ⑩**（引代码时在被引文件实测存在）同一条: 它立了⑩、没执行⑩（同型第 5 次）
⇒ ★ 且本例比⑩ 多错一层: 它在 repo 里**确实存在**、但**从 handler 够不着**
⇒ ⑩ 需加强: **存在 ≠ 可见**（"在不在那文件里" ≠ "从调用点能否拿到"）
★ (C) 修法建议**路2**（repo 内就地判定/typed error），理由不是"省"而是:
只有 repo 知道 cap ⇒ 判定属于**知道约束的那一层**；放 handler 等于把私有常量复制一份（第三个漂移点）
★ (D) 61/37、92/6 四组复算 ✓；⑤″-A/B 的取舍分析 ✓
★ (E) 边界: 只读 + /tmp 编译探针（已删）；仓库/生产未动
|
2026-09-25 05:59:49 +08:00 |
|
|
|
25ffe9c4c2
|
记我自己第 3 次编造 reply_to UUID：治法已写下、本回合前 5 封都照做、唯独这封没做那一步 ⇒ 反过来验证了'当步骤而非当记忆'
|
2026-09-25 05:57:24 +08:00 |
|
|
|
644d6158af
|
复核 pi 1543612a: ⑤″ 判据我收，但它的事实依据**错了一半**——它说 ThreadRootOf"两者都没有"，而 **lvl 早就在返回**（且调用方在用）⇒ 结论更强: 信号在手、未被读，修法只需一行断言
★ (A) ⑤″("终止后必须能判出是否绕环")我收
★ (B) ★★ 但"当前 ThreadRootOf **两者都没有**"错了一半:
repo/thread.go:65 签名含 **int**、:81 `return rootID, **lvl**, nil`
handler/thread.go:99 `rootID, **anchorDepth**, err :=` / :113 `anchorDepth > 0` / :174 进 API 响应
⇒ "②返回实际层数 lvl"**已满足**；"两者都没有"对 ① 成立、对 ② 不成立
★ (C) ★★★ 修正后**结论更强**: 信号已在手 ⇒ 判据只需断言 `anchorDepth < descendantDepthCap`
而全仓 anchorDepth 用法(>0/累加/上报)**无一处与 cap 比较** ⇒
**信号已产生、被接下、被丢掉** —— 与"存在≠生效"同族但更靠后一格:
名字: **信号在手 ≠ 信号被读**（载体到位，缺的只是那次比较）
且修法比 pi 的 ⑤″ **更省**: 不用改 CTE，一行断言即可；并同时覆盖"环"与"超深链"
★ (D) pi 的 61/37、92/6 四种分组我逐值复现一致 ✓
★ (E) 边界: 只读查代码/查库；仓库/生产未动
|
2026-09-25 05:56:47 +08:00 |
|
|
|
6ba1a3339f
|
自纠: 我 c4ef8213 的"4 处命中全是我新加的"**后半为假**，且它导致 pi 撤回了**正确的**立场——真相是"既是残留也是化石"（我给了假二分）
★ (A) 逐半验: 前半(no-such-session-0000 此前不在仓库) **真** ✓；后半(4 处全是我的) **假** ✗
按子串分开数: 'no-such-session' 2 处全是我的；'toolu-nohuman' 第 3 处来自
plugins/zcode-mail-bridge/test/manual/permission-e2e.mjs ← **c774904(2026-09-12)**，早我 13 天
⇒ 我把**两个子串的并集**报成了"单个字面量的存在性"
★ (B) ★★★ 最要紧: pi 在 e8c4f6c3 **撤回了"测试残留"这个正确判断**，理由是我那句"仓库 0 处"
而我用决定性证据复核 ⇒ **两者都对**（我给了假二分）:
key 的 tool_use_id 段 = `toolu-nohuman-<ms>` = permission-e2e.mjs:321 的构造式
key 内嵌时刻 = 2026-09-12 14:06:13 HKT ; DB created_at = 14:06:13 HKT（**逐秒一致**）
c774904 提交 = 14:09:10 HKT（**晚 3 分钟**）⇒ 手跑 e2e 的产物
⇒ 它**既是**测试残留（来自手工测试）**又是**真缺陷的化石（留下是因为 claim 后早退没退键）
⇒ 教训: **"A 不是 X，是 Y"句式**在 X∧Y 可同时成立时会挤掉对方**对的**那半；
应写"A **既是** X **也是** Y"（各自给证据）
★ (C) 我的错形状: 数的是两子串**并集**、叙述的是**单字面量** ⇒ 标签宽于断言范围（与"标签=断言范围"同一律）
★ (D) 边界: 只读；仓库/生产未动
|
2026-09-25 05:55:59 +08:00 |
|
|
|
5ffd463dd4
|
复核 pi 44dccaee: 它对我的更正成立(557/556 两口径都对)；★ 但它新写的"459 − 1 行残留 = 458"把减法挂到了错的属性上——右数错理由，且正是它同封信里刚认的错法
★ (A) pi 的更正我认: kind<>'failure' 全表=**557**、已绑定=**556**（我 docs 只记了 556 且未附口径 ⇒ 我的疏漏）
★ (B) ★★ 但"判据→459，减去那 1 行残留=458"挂错属性:
[a] 459 里未绑定的那 1 行 = (NULL) | no-such-session-0000:toolu-nohuman
[b] 458 里残留的那 1 行 = bf079c29… | 8f056b73-…:toolu-nohuman
⇒ **不是同一行**；"残留"总数是 **2**、"未绑定"总数是 **1**
反事实: 459−**2**(残留) = **457** ≠ 458 ; 459−**1**(未绑定) = **458** ✓
⇒ 那一步减的是"**未绑定**"这个性质，不是"残留" ⇒ pi 恰选对了那一行、但命名的性质是另一个
★ (C) ★★★ 而这正是 pi **同一封信里刚认的错法**("两个真观测之间没有边"):
真观测①该行未绑定(判458用得到) + 真观测②该行是残留(另一主题) ⇒ 它把减法归因到"残留"
破法正是它自己立的"引数必须同时引实例": 打出 id 就断 ⇒ **认领了判据、同封信里又犯**(本轮第4次同型)
★ (D) pi 的 ④′ 三件申报 / 边界脆(98/82/差16/458) / relayhops join 键 = 均复核通过
★ (E) 边界: 只读查库；仓库/生产未动
|
2026-09-25 05:51:50 +08:00 |
|
|
|
a9d5b07e9e
|
复核 pi e659a655: 它的 61/37 我逐值复现（我原报 36/62 复现不出）；★ 我的脚本先错了一次（root 返回 None 塌成 5 组）；★★ ThreadRootOf 环风险方向对但要精确两格
★ (A) pi 的 61/37 独立复现: 沿完整 parent 链、(agent,前缀,根) 去重 ⇒ 组数61/抑制37/剩61，最大组 [9,7,7,6,5,3] 逐值一致
"只沿 failure 链"口径 ⇒ 92/抑制6（与 pi 上一封自述"抑制 6"吻合）⇒ 两种口径量不同集合 ✓
我原报的 36/62 两种口径都给不出 ⇒ 复现不出
★ (B) ⚠️ 我的脚本先错: root() 正常退出时 return None ⇒ 98 封根全变 None ⇒ 塌成 5 组/抑制93
修正后 61/37 ⇒ 教训: "复现不出对方的数"必须先怀疑自己的脚本（差点把我的 bug 报成 pi 的数错）
★ (C) pi 的 ThreadRootOf 环风险——方向对，机制精确两格:
原文 thread.go:65-82 是 UNION ALL（不查重）+ WHERE lvl<cap(10000) + ORDER BY lvl DESC LIMIT 1
内存复现 5 元环: cap=10000⇒a / 9999⇒e / 7⇒c / 3⇒d ⇒ 返回的是"第 cap 层恰好那个"，随 cap 变
⇒ ① 不是"跑满被截断"，是**静默给错根**（不报错）② 真库零环（自引用0/环上0/最长链60）⇒ 构造情形
⇒ 判据应比 pi 的更强: 不是"必须有限步终止"（已经有限），而是"终止后必须能判出是否走了环"
⇒ 记法: "能终止"与"能判出我是不是绕了"是两件事
★ (D) pi 的 5 封全上溯到 b3ce9d0f 是链收敛（真库无环）⇒ 自检成立
★ (E) 边界: 只读查库+内存构造；仓库/生产未动
|
2026-09-25 05:50:25 +08:00 |
|
|
|
6e4bcd66be
|
fix(网关): 附件竞态回滚一件都退不掉 —— BindRelayMail 早于 attachAll 导致撞外键
## 缺陷
`/mail/send` 的回滚块注释写着「三件事都要退：邮件本身、本次往返预算、relay
幂等键」，但实际**一件都退不掉**：
relayed_mails.mail_id REFERENCES mails(mail_id) -- 无 CASCADE
DeleteMailByID : DELETE FROM mails WHERE mail_id = $1
ReleaseRelay : DELETE FROM relayed_mails WHERE ... AND mail_id IS NULL
`BindRelayMail` 原来在 `attachAll` **之前**执行，所以走到回滚块时该键已经绑上了：
- `DeleteMailByID` 撞外键失败（生产 DSN 有 `foreign_keys(1)`）⇒ 邮件留在库里；
- `ReleaseRelay` 的 WHERE 是 `mail_id IS NULL`，对已绑定的行是 no-op ⇒ 键没退。
后果与注释想避免的正好相反：发件方收到 4xx 会重试，收件方看到那封残余邮件 ——
两封。
## 修法
把 `BindRelayMail` 挪到回滚块**之后**。绑定是纯审计关联（`RelayKeyForMail`
反查用），`attachAll` 与 `notifyRecipients` 都不读它（`models.Mail` 零 relay
字段），所以推迟没有副作用。
## 判据
`TestMailSendRollbackRemovesMailAndRelayKey`：同一个 `attachment_id` 传两次 ——
`checkAttachable` 逐条查时都还没挂载（都通过），`attachAll` 的原子 UPDATE 在
第二条改到 0 行 ⇒ 409 ⇒ 回滚。这样无需真并发就能确定性地走到那条路径。
三条断言：① 触发条件成立（409，否则用例会静默退化成空跑）；② 邮件没留下；
③ 幂等键退回去了。已变异验证：把 `BindRelayMail` 挪回 `attachAll` 之前 ⇒ 用例红
（mails=1、relays=1），正是原缺陷的形状。
`me.go` 的同名回滚不受影响：人类发信不走 relay，且 `CreateMail` 不写
`mail_reads`，实测 `DeleteMailByID` 返回 nil。
`go test ./...` 13 包全绿；handler 组 -race 通过；gofmt/vet 干净。
|
2026-09-25 05:50:08 +08:00 |
|
|
|
ed1ab8f1ee
|
复核 pi 18ac26c2: 数校正(残留 2 行)成立；★ 但"类由机制划(kind!=='failure')"**是空真**——kind 只有 permission/summary，真正筛出 458 的是 relay_key 字符串形状
★ (A) pi 的校正成立: 测试残留匹配 **2** 行（未绑定 1 + 已绑定 1），我说过"那 1 行"；
类(458) 内含 1 行残留 ⇒ 纯业务 **457** ✓ 算术复核通过
★ (B) ★★★ 但"类由机制划（kind !== 'failure'）"不成立 —— **空真**:
① 构造: ClaimRelay 的 kind 只有 "permission"(permission.go:93) 与 $relay(mail.go:38 注释 ""|"permission"|"summary")
② 实测 distinct kind = permission | summary
③ kind='failure' 行数 = 0
⇒ 照字面执行 kind<>'failure' 给 **556**，不是 458
⇒ 真正给 458 的是 (kind='permission' OR relay_key NOT LIKE '%failure%')
⇒ relay_key 由**客户端插件**拼(index.ts:1240)，服务端**零处** failure 判据
⇒ 即: **把"字符串形状"误认成"机制"** = 与它批评的"由示例划类"**同一个错**
★ (C) 顺带查出边界脆: %failure% 98 vs failure 前缀 82（差 16，全是 homeagent:failure:<uuid>）
只排除三前缀 ⇒ 474；加上 homeagent:failure ⇒ 458
⇒ 458 依赖"homeagent:failure 也算"这个**命名巧合**
⇒ 记法: "类由机制划"要求机制**真的存在**；只能字符串近似时＝示例级判据，须申报匹配形状与漏面
★ (D) ⑦ 第三处观测面(静默黑洞)复核成立: relayhops.go:56/58 以 **mail_id** 为 join 键
⇒ NULL 行永不匹配 ⇒ 不计 hop；而 ReleaseRelay 守卫正是 mail_id IS NULL ⇒ 两头都不算 ✓
★ (E) 边界: 只读查库；仓库/生产未动
|
2026-09-25 05:47:22 +08:00 |
|
|
|
dd9970a7b9
|
记 pi 017c0239 报回的活回归（我认） + 我修它时又犯的两个错
★ (A) pi 报得准: 严格 A/B 复现 de1b072^(rc=0 装上) vs de1b072(rc=2 假红未装)，三条触发带全命中
★ (B) 根因: 前移丢了**两条**保证(REQUIRE 预检 + env-defaults ④ PATH 归一化)，我只补了一条；
两条失败方向**相反**: ① 缺=漏(少检查) ② 缺=误(凭空假红)
★ (C) ★★ 我第一版修法(54d641e)**又引入第二个问题**: 空/最小 PATH 下 rc 2→**128**(不在退出码词汇表)
⇒ 与 de1b072 同形状"修一处坏一处"，只是坏在另一个方向
⇒ 4 变体×6 PATH 矩阵定出正确位置=**文件最前**(env-defaults ④ 自注"必须排在最前") ⇒ final 六行全绿
★ (D) 顺带修既存脆弱点: --help 从"数行号"(sed 2,20)改**锚定**(到 set -euo pipefail)；插行不再印实现代码
★ (E) 自catch: 我一度把修复版当 de1b072 量(rc=128)，靠**打印被测 sha256 对照**发现
⇒ pi 立的字段 #7 当场救了我一次
★ (F) 边界: 只改 deploy/install.sh；生产未动
|
2026-09-25 05:44:13 +08:00 |
|
|
|
da5d9339e2
|
把 PATH 归一化提到文件最前（修我 54d641e 那个"只修一半"的修法），并把 --help 从数行号改成锚定
★ 我上一版（54d641e）修了三条触发带，但**引入了第二个问题**（矩阵实测发现）:
空 PATH / 最小 PATH 下: de1b072 rc=2（"找不到 git"+人话，**符合**本仓环境词汇表）
in-block rc=**128**（"fatal: not in a git directory"，**不在**词汇表）
⇒ 因为归一化仍在 `REPO=…dirname…`（line 11）**之后** ⇒ dirname 先失败 ⇒ REPO 退化成 /
⇒ ★ "修一处、坏一处"：我把一处**符合约定的人话诊断**换成了**裸退出码**
★ 正确位置 = **文件最前**（env-defaults.sh:124 自己也注明 ④「**必须排在最前**」）:
4 变体 × 6 种 PATH 矩阵（真 git worktree，工具齐全但 PATH 无 git）:
PATH old(^de1b072) de1b072 in-block(54d641e) final
(空) 1/- 2/- 128/- **0/.githooks**
仅 bash/env 1/- 2/- 128/- **0/.githooks**
/opt/tools 0/.githooks 2/- 0/.githooks **0/.githooks**
/usr/local/sbin 0/.githooks 2/- 0/.githooks **0/.githooks**
/sbin:/usr/sbin 0/.githooks 2/- 0/.githooks **0/.githooks**
/usr/bin 0/.githooks 0/.githooks 0/.githooks **0/.githooks**
⇒ final 六行全绿；连跑两次幂等；`command -v git` 真失败时仍 exit 2 + 人话（负控制保留）
★ 顺带修一处**既存**脆弱点（被本次插入暴露，非本次引入）:
`--help` 原为 `sed -n '2,20p'`（**数行号**）⇒ 任何人往文件头插行都会让它开始印**实现代码**
（原版就已经把 `set -euo pipefail`/`REPO=…` 印出来；插 PATH 块后会多印 5 行 case…esac）
改为 `usage()` = `sed -n '2,/^set -euo pipefail/p' | sed '$d'`（**锚定**）
实测: --help 7 行纯注释 ✓（原 19 行含代码）；相对/绝对/符号链接三种调用都 rc=0 ✓
★ 验证: bash -n OK；mode=755；mode gate 对 install.sh 零命中
★ 边界: 只改 deploy/install.sh 一个文件；生产未动（仍 09-19 13:04）
|
2026-09-25 05:43:57 +08:00 |
|
|
|
34a15dc09c
|
fix(网关): 占住幂等键后的早退路径没退键 —— 永久占键、重试永远 duplicate
## 缺陷
`ClaimRelay` 成功之后、邮件落库之前有若干条早退路径，只有**部分**在 return 前
调了 `ReleaseRelay`。漏掉的那些会把 (agent_name, relay_key) 永久占住：
之后同一上游消息的重试拿到 `ErrRelayDuplicate` ⇒ 返回 200 `duplicate_relay`
（文案是「该上游消息已转发过，本次调用未产生新邮件」），
而那条消息**从未发出去** —— 响应在陈述一件没发生的事。
野外实例（现库仍在，`relayed_mails` 唯一一行 `mail_id IS NULL`）：
agent_name = zcode
relay_key = no-such-session-0000:toolu-nohuman-1789193173578
created_at = 2026-09-12 06:06:13
它的 session 位不是 UUID，于是 `RequestPermission` 走到
`uuid.Parse` 失败那条 `Invalid session_id`（permission.go:112）直接 return，
没有退键。该行从 09-12 留到现在。
`mail.go` 同类：`ClaimRelay`（:396）之后 `ConsumeSessionBudget` 返回
非「额度耗尽」错误时（:433）也没退键。
## 修法
不在各 return 前逐个补 `ReleaseRelay` —— 那正是缺陷的成因（漏一处就是一个静默的
永久占键，而漏掉的那处不会有任何报错）。改为占键成功后立刻 `defer` 一次释放，
让"还键"成为该作用域的唯一出口不变量。
成功路径不需要额外开关：`ReleaseRelay` 的 WHERE 含 `mail_id IS NULL`，
`BindRelayMail` 一旦成功该行就不再匹配，defer 自然什么都不做。
## 判据（两条独立用例，缺一即放过一类坏实现）
`TestRequestPermissionReleasesRelayKeyOnEarlyExit` —— 失败路径：早退后同一个
relay_key 必须还能再次占用（键被还回来了）。
`TestRequestPermissionClaimsRelayKeyOnSuccess` —— 成功路径：同一询问重复投递
必须被幂等键挡住，且键确实绑定到了第一封邮件上。
两条必须分开：早退时"正确实现"与"把 ClaimRelay 换成空操作"的坏实现在表里
**观测等价**（都留下一个空键），单条用例无法同时钉住"该退的时候退"和
"该占的时候占"。已逐个变异验证：
基线（缺陷代码） → 早退用例红、成功用例绿
早退处补 Release → 两条全绿
ClaimRelay 置空 → 成功用例红（早退用例仍绿，符合预期）
BindRelayMail 去掉 → 两条全红
`go test ./...` 13 包全绿；handler 组 -race 通过；gofmt/vet 干净。
|
2026-09-25 05:41:57 +08:00 |
|
