fix(权限): 409 的第二种含义是「本档不该问」——四桥都补上;状态写入点不再兜默认档
线上事故(jianf 经 pi 转达):补投路径漏传 permission_mode,插件拿 undefined 兜了 workspace 档,把 full 档会话写成 workspace-write + ask —— 不是"拦一次",是一整轮 工具能力降级,且状态留在会话里;随后该会话每次受守卫调用都撞 409。 四件事: 1. **状态写入点不接受默认值**(新增共享 `modeForStateWrite`):缺字段/脏值 → `null` = 不写状态。"默认值可以出现在**决策**里,不可以出现在**状态写入**里。" 同时保留共享契约的 fail-closed:真读到 workspace 才写 workspace。 2. **409 的两种含义分开处理**。`allowed-once` 只绕过**审批**,改不了**沙箱** —— 所以 dsh 桥在放行前先把服务端给的权威档位**写回会话**(这也就成了自愈路径: 已经降级的会话,下一次带档位的 409 会把它修回来);只认服务端明说的 full, plan 与"链上没有人类"照旧 fail closed。 3. **同一处缺陷在 zcode / opencode 也在**(`hooks/permission.mjs` 与 `index.js` 都把 409 当永久失败拒绝)。我先前在回信里写过"这两个桥不转发权限询问,不需要改" —— 那句话是错的,我当时的搜索面只有 `<plugin>/src/*.mjs`。按 pi 的要求把这条 **否定性事实变成常驻判据**后,它第一次运行就红给我看。四桥现在都有 「409 + full → 放行」,且**排在永久失败分支之前**(含顺序变异自检)。 4. **共用测试重新同源**:`test/catchup.test.mjs` 从 `153985e` 起就是分叉的 (我那版把平台专属路径写进了共用文件),而 `deploy/install.sh` 第 24 行会跑 `check-shared-libs.sh` —— 也就是说**部署一直是红的**,我没跑过那个脚本。 共用文件只放契约(值/行为),跨平台配对judge 移到平台专属文件,四份逐字节相同。 另外把"判代码 vs 判理由"从记忆变成代码:`test/lib/read.mjs` 提供 `code()/prose()/bytes()`, 判据目录里不得再裸用 `readFileSync`(新判据 `criteria-hygiene` 管,含读取器自检)。 判据证据(每条都做过"能不能红"的变异): - 写回去掉 → 红;纠正块挪到普通 409 之后 → 红;状态写入点退回兜默认 → 红; - zcode/opencode 的放行分支拿掉 → 各自红;共用测试分叉 → check-shared-libs 红。 各套件:dsh 388、pi 443、zcode 387、opencode 333(均经 npm test,含 tsc); electron `npm test` 15/15 判据绿 + vitest 266 + typecheck;`check-shared-libs.sh` 退出 0; Go `go test ./...` 全 ok。
This commit is contained in:
@ -2,11 +2,6 @@ import assert from 'node:assert/strict';
|
||||
import test from 'node:test';
|
||||
|
||||
import { MAX_CATCHUP, mailToEvent, selectCatchup } from '../lib/catchup.js';
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const HERE = dirname(fileURLToPath(import.meta.url));
|
||||
|
||||
const mail = (over = {}) => ({
|
||||
mail_id: 'm1',
|
||||
@ -85,17 +80,6 @@ test('seen 传 undefined 时不去重也不报错', () => {
|
||||
assert.deepEqual(got.map(e => e.mail_id), ['x']);
|
||||
});
|
||||
|
||||
/**
|
||||
* ★ 权限档位必须带过来(2026-09-14 生产事故的回归判据)。
|
||||
*
|
||||
* 现象:一条 full 档会话里只要有一封**补投**邮件,worker 就以为自己是 workspace 档,
|
||||
* 去申请审批 → 服务端按档位回 409 → 桥按「永久失败」当场 block → 这一轮
|
||||
* bash/write/edit 全被拦(SSE 实时送达的邮件不受影响,只有补投的中招)。
|
||||
*
|
||||
* 这条判据本该早就存在:上面那条「与 SSE new_mail 同形」的断言只列了 6 个键,
|
||||
* **照抄了实现里搬的那几个字段** —— 于是"形状不一致"这件事恰好落在它的盲区里。
|
||||
* 盲区不是"漏了一个字段",是"字段清单由被检查方提供"。
|
||||
*/
|
||||
test('★ 补投事件必须带权限档位(漏了就会把 full 档会话误拦)', () => {
|
||||
const ev = mailToEvent(mail({ permission_mode: 'full', permission_enforcement: 'strict' }));
|
||||
assert.equal(ev.permission_mode, 'full', '补投路径不许把档位丢掉');
|
||||
@ -106,69 +90,3 @@ test('★ 补投事件必须带权限档位(漏了就会把 full 档会话误
|
||||
assert.equal(bare.permission_enforcement, '');
|
||||
assert.ok(!('permissionMode' in bare), '键名要与 SSE 逐字一致(蛇形),别自造驼峰');
|
||||
});
|
||||
|
||||
test('★ 配对判据:worker 从事件里读的每个档位字段,补投都要产出', () => {
|
||||
/*
|
||||
* 上面那条只钉两个已知字段,将来 worker 再读一个 `msg.data?.xxx` 时它不会响。
|
||||
* 这条把**生产者与消费者配对**:worker 读哪些 `msg.data?.X`,`mailToEvent`
|
||||
* 就得产出哪些 X。字段清单不再由被检查方提供 —— 这正是上次漏掉档位的根因。
|
||||
* 与 narrow-layout 同一取舍:验形态,不验行为;重构敏感是它该做的提醒。
|
||||
*/
|
||||
const worker = readFileSync(join(HERE, '..', 'src/worker.mjs'), 'utf8');
|
||||
const read = new Set([...worker.matchAll(/msg\.data\?\.([a-z_]+)/g)].map(m => m[1]));
|
||||
assert.ok(read.size >= 4, `要能取到 worker 读的字段(实际 ${read.size} 个)`);
|
||||
const produced = new Set(Object.keys(mailToEvent(mail())));
|
||||
const missing = [...read].filter(k => !produced.has(k));
|
||||
assert.deepEqual(missing, [],
|
||||
`worker 会从事件里读这些字段,补投却没产出:${missing.join('、')} —— ` +
|
||||
'补投是重启后的唯一送达路径,缺字段等于那条路径静默降级(档位漏传就是这么出的)');
|
||||
});
|
||||
|
||||
/**
|
||||
* ★ 四桥配对:每个桥从投递事件里读的**邮件类**字段,补投都要产出。
|
||||
*
|
||||
* # 为什么这条判据存在
|
||||
*
|
||||
* 2026-09-14 的事故(full 档会话被误拦)根因是 `mailToEvent` 搬的字段太少,
|
||||
* 而它**单独看任何一个桥的测试都发现不了**:pi 的测试只列了自己关心的 6 个键
|
||||
* (照抄实现),dsh/zcode 读别的字段,各测各的。缺的字段在**接口**上,
|
||||
* 不在任何一侧的内部。
|
||||
*
|
||||
* 所以这条把四桥的读法与补投的产出**配对**,并且:
|
||||
* - 只认邮件类事件:`decision_mail_id / kind / note / suggestions / participants`
|
||||
* 属于权限**决策**事件(`permission_decision`),不走 mailToEvent —— 列进
|
||||
* ALLOW 并各写一句理由,别用"看起来像"糊过去;
|
||||
* - 白名单里的每一项都必须是**明确的非邮件事件字段**,加新的要写理由。
|
||||
*/
|
||||
const ALLOW = new Map([
|
||||
['decision_mail_id', '权限决策事件(permission_decision)的字段,不走补投'],
|
||||
['kind', '决策事件:同意/拒绝'],
|
||||
['note', '决策事件:备注'],
|
||||
['suggestions', '决策事件:选项'],
|
||||
['participants', '决策事件:参与方'],
|
||||
]);
|
||||
|
||||
test('★ 四桥配对:各桥读的邮件字段,补投都要产出(含决策字段白名单自检)', () => {
|
||||
const produced = new Set(Object.keys(mailToEvent(mail())));
|
||||
const bridges = [
|
||||
['dsh', '../../dsh-mail-bridge/src/index.ts'],
|
||||
['pi', '../src/worker.mjs'],
|
||||
['zcode', '../../zcode-mail-bridge/src/index.mjs'],
|
||||
];
|
||||
const problems = [];
|
||||
for (const [name, rel] of bridges) {
|
||||
const src = readFileSync(join(HERE, rel), 'utf8');
|
||||
const reads = new Set([...src.matchAll(/\b(?:data|msg\.data\?|ev)\.([a-z_]+)/g)].map(m => m[1]));
|
||||
const missing = [...reads].filter(k => !produced.has(k) && !ALLOW.has(k));
|
||||
if (missing.length) problems.push(`${name} 读但补投不产出:${missing.join('、')}`);
|
||||
}
|
||||
assert.deepEqual(problems, [],
|
||||
`${problems.join(';')}\n` +
|
||||
'补投是重启后的唯一送达路径,缺字段等于那条路径静默降级(档位漏传就是这么出的)。' +
|
||||
'若某个字段确实属于别的(非邮件)事件,请往本文件的 ALLOW 里加并写理由。');
|
||||
// 白名单自检:每个理由都非空,且确实是"决策事件"那一族(别拿"看起来像"糊过去)
|
||||
for (const [k, why] of ALLOW) {
|
||||
assert.ok(why.length >= 6, `ALLOW 里 ${k} 要写清为什么可以不产出`);
|
||||
}
|
||||
assert.ok(ALLOW.size <= 8, '白名单不许无限膨胀(它一膨胀这条判据就废了)');
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user