fix(inbox): 收件箱按**工作区**收窄（三维地址的 path 位此前从未被使用）

用户 12 天前就提过（`552fbc7` 只修了 session_id 那一维），这轮才真修。
用户原话：「难道让一个不在项目工作区的 agentsession 去修工程吗？」

# 缺陷（生产实测，2026-09-26）

在 `mc` 工作区干活的 pi 读收件箱拿到 **200 封，其中 191 封属于
`/home/program/agentmail`** —— 它照着那些信里的断言去改 agentmail 的代码，
把手上的 mc 活丢在一边。用户当场问它「你怎么干着干着修 agentmail 去了？」
（这条对话就在 mc 会话的 jsonl 里）

根因：`ListInboxScoped` 的 WHERE 只有 `m.to_name = $1`（+ 可选 session_id），
**没有任何 workspace 条件**。三维地址 `name@path.session` 的 path 位
在收件箱侧从未生效 —— 那不是"另一种语义"，是没兑现契约。

# 三条守卫全部只覆盖自动转发，防不住这个

| 守卫 | 只覆盖 | 为何无效 |
| --- | --- | --- |
| 会话预算 | `relay != ""` 才扣 | 这批信 relay=0（模型主动发）⇒ 不扣 |
| maxRelayHops=5 | 同上，只数 relay | 同上 ⇒ 不进那个分支 |
| 插件自动转发守卫 | 插件代劳时 | 日志明说"本轮不自动转发" ⇒ 模型自己发的不受管 |

# 服务端

· `ListInboxScoped` / `CountUnreadScoped` / `MarkAllInboxReadForSession`
  三处统一加 `s.workspace = $N`（用会话的 workspace，不用 mails.to_workspace：
  后者是信封字段、可能是抄送或历史遗留；"线索属于哪个工作区"是会话属性）。
  ★ 三处必须是**同一个谓词** —— 列表看不到的信却被"全部标掉"标掉就是静默丢信
  （session_scope_test.go 记过这个形状）。
· **workspace 在 Agent 侧必需，缺了 400**（用户裁定：「不带 workspace 是错误
  发件格式，直接退回！」）。旧语义（不带=全部）正是缺陷本身，不留兼容回退。
· 人类侧**不过滤**（一个人跨工作区，WebUI 按 session_workspace 分组显示）——
  所以"必需"这条约束放在 Handler 而不是 repo 层：它是接口契约，不是数据层不变量。
· 新增 `UnreadWorkspaces`：心跳是**进程级**（一个桥服务所有工作区），没有
  "我的工作区"可言；但只有总数桥不知道去哪个工作区补投 ⇒ 心跳回
  `pending_workspaces` 清单，桥逐个消费。
· 决策载荷补 `workspace`（服务端知道 session→workspace，插件重启后推不出来）。
· `TouchAgentLastSeen` 从 HeartbeatAgent 拆出：middleware 在每个认证请求上都调它，
  而那时工作区还没解析（请求体没读），原来在白算一次 CountUnread。

# 三个插件（pi / opencode / dsh）

· 读类工具带 `workspace`；补投从"读一次全局收件箱"改为**逐工作区**读。
· pi：worker 信封的 `to_workspace` 经闭包递进工具（不是会话文件 header 的 cwd ——
  后者是"会话上次落在哪"，前者是"这封信寄到哪个工作区"）。
· opencode/dsh：插件常驻、信封在 deliverMail 那刻就消费掉了 ⇒ 新增
  `sessionWorkspace` 映射（键与既有 reverseMap 同一把）。
· 修一处真 bug：`UnreadWorkspaces` 原先会返回相对路径工作区（历史库里有
  `workspace='root'`），桥侧实测撞 400（`补投工作区 root 失败`）⇒ 只报可寻址的。

# 实测凭据

· 改前：`pi` 的收件箱 200 封混 3 个工作区（agentmail 191 / TrueAgent 7 / huawei 2）
· 改后：agentmail=100（total 228）、mc=16、TrueAgent=7 —— 各工作区独立
· 不带 workspace ⇒ **HTTP 400**，话术给出可执行步骤
· 桥日志：`rw=/home/newqqagent/plugindev/editdoc-upgrade` —— 终于是别的工作区了
  （改前 78 次 worker 启动**全部**是 `/home/program/agentmail`）

# 判据

· `server/internal/repo/workspace_scope_test.go`（3 条）：
  两向收窄 + **反向对照**（不带时两条都看得到 ⇒ 证明是收窄不是清空）+
  未读数同口径 + 相对路径必须报错
· `plugins/pi-mail-bridge/test/inbox-workspace-scope.test.mjs`（4 条）：接线 +
  取信封而非 cwd + 补投逐工作区 + 判据自检
· dsh 那条 `取不到会话时退回整体收件箱` **改了**：它钉的"退回整体"正是缺陷，
  现在钉"两维各自缺席时各自不带、服务端 400 让错误可见"
· 变异验证：服务端 2 处 + 插件 3 处，全部判红后恢复回绿

全量：server `go test ./...` 绿；三插件 513+340+403 全绿。

plugins/pi-mail-bridge/test/inbox-workspace-scope.test.mjs

@@ -0,0 +1,65 @@
+/**
+ * read_inbox 必须把列表收窄到**自己所在的工作区**（2026-09-26 用户报的缺陷）。
+ *
+ * # 缺陷（用户当场指出，此前已提过多次）
+ *
+ * 在 `mc` 工作区干活的 pi 读收件箱拿到 200 封，其中 **191 封属于
+ * `/home/program/agentmail`** —— 它照着那些信里的断言去改 agentmail 的代码，
+ * 把手上 mc 的活丢在一边。用户当场问「你怎么干着干着修 agentmail 去了？」
+ *
+ * 三维地址是 `name@path.session`：**path 位本来就该参与寻址**，而收件箱侧此前
+ * 完全没用它（`ListInboxScoped` 的 WHERE 里只有 `to_name`）。
+ *
+ * # 与 inbox-session-scope 的分工（两条判据、两维收窄，别混）
+ *
+ *   · `session_id` —— 只列**这条线索**的信。防的是"A 会话的 worker 标掉 B 会话的未读"。
+ *   · `workspace`  —— 只列**这个工作区**的信。防的是"在 mc 干活却读到 agentmail 的信"。
+ *
+ * 两维都要，缺一维就漏一类越界。这里只验**接线**；服务端语义
+ * （读 A 工作区不动 B）由 `server/internal/repo/workspace_scope_test.go` 负责。
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const tools = readFileSync(join(HERE, '..', 'src', 'tools.mjs'), 'utf8');
+const worker = readFileSync(join(HERE, '..', 'src', 'worker.mjs'), 'utf8');
+const index = readFileSync(join(HERE, '..', 'src', 'index.mjs'), 'utf8');
+
+test('read_inbox 的收窄参数带上 workspace', () => {
+  assert.match(tools, /workspace=\$\{encodeURIComponent\(ws\)\}/,
+    'scopeQS 要真的拼出 workspace=…（服务端缺它直接 400）');
+  assert.match(tools, /const ws = wsParam\(\);/,
+    'scopeQS 要消费 wsParam，而不是只留着函数不调');
+});
+
+test('worker 把"这封信寄到哪个工作区"递给工具', () => {
+  assert.match(worker, /getWorkspace: \(\) => mailContext\.workspace/,
+    '要传闭包而不是快照（worker 每回合的 mailContext 会变）');
+  assert.match(worker, /workspace: msg\.data\?\.to_workspace/,
+    '★ 取**信封的 path 位**（to_workspace），不是会话文件的 cwd —— ' +
+    '前者是"这封信寄到哪个工作区"，后者是"会话上次落在哪"');
+});
+
+test('补投逐工作区走，不再读一次全局收件箱', () => {
+  // 原来：client.get('/mail/inbox?status=unread&limit=20') —— 不带收窄，
+  // 于是桥会把所有工作区的漏投一起重放。
+  assert.match(index, /pending_workspaces/,
+    '心跳要消费 pending_workspaces 清单');
+  assert.match(index, /mail\/inbox\?status=unread&limit=20&workspace=\$\{encodeURIComponent\(ws\)\}/,
+    '每个工作区各读一次，且带上 workspace');
+  assert.doesNotMatch(index, /client\.get\('\/mail\/inbox\?status=unread&limit=20'\)/,
+    '旧的"不带收窄读全局"那条路必须消失（它就是跨工作区重放的载体）');
+});
+
+test('★ 判据自检：拿没带工作区收窄的旧写法喂进来必须判红', () => {
+  const oldScope = "const sid = typeof getMailSessionId === 'function' ? getMailSessionId() : '';\n  return sid ? `session_id=${encodeURIComponent(sid)}` : '';";
+  assert.equal(/workspace=\$\{encodeURIComponent\(ws\)\}/.test(oldScope), false);
+
+  const oldCatchup = "const box = await client.get('/mail/inbox?status=unread&limit=20');";
+  assert.match(oldCatchup, /client\.get\('\/mail\/inbox\?status=unread&limit=20'\)/,
+    '自检：旧写法确实能被那条 doesNotMatch 抓到');
+});