MailUI4Agents

Files

JianFeeeee 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

ALIGN-REFS.json

跨端: 左右滑动翻页（P6 第 3 步）+ 还 gesture-semantics 债 + 修跑不起来的判据基建

2026-09-19 14:01:21 +08:00

API.md

复核 pi 39c0c9ca + 7ec0044a: 两条都成立；★ 其中我又犯一次"量法过窄"——grep 带了双引号只数到 1/3，它数的是字面量本身（含反引号）得 2/5

2026-09-25 06:38:52 +08:00

DEBTS.json

docs(debt): 登记「并列失败不得被合并」—— pi a948cdbb 的判据⑤（此前只活在邮件里）

2026-09-25 06:42:32 +08:00

DEV-TOOLING.md

docs(dev-tooling): 第 21 条 —— 夹具把生产形状简化掉的那一角（一天内第二个实例：agentDir 与首回合 cwd）