线上事故(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。
93 lines
3.5 KiB
JavaScript
93 lines
3.5 KiB
JavaScript
import assert from 'node:assert/strict';
|
||
import test from 'node:test';
|
||
|
||
import { MAX_CATCHUP, mailToEvent, selectCatchup } from '../lib/catchup.js';
|
||
|
||
const mail = (over = {}) => ({
|
||
mail_id: 'm1',
|
||
session_id: 's1',
|
||
from_name: 'admin',
|
||
subject: '主题',
|
||
mail_type: 'normal',
|
||
to_workspace: '/tmp/ws',
|
||
...over,
|
||
});
|
||
|
||
test('mailToEvent 产出与 SSE new_mail 同形的对象', () => {
|
||
const ev = mailToEvent(mail());
|
||
// 投递侧读的就是这几个键,形状不一致会让补拉那条路径静默地少带信息
|
||
for (const k of ['mail_id', 'session_id', 'from_name', 'subject', 'mail_type', 'to_workspace']) {
|
||
assert.ok(k in ev, `缺少 ${k}`);
|
||
}
|
||
assert.equal(ev.role, 'to');
|
||
assert.equal(ev.catchup, true);
|
||
});
|
||
|
||
test('mailToEvent 对缺字段的行给出空串而非 undefined', () => {
|
||
const ev = mailToEvent({});
|
||
assert.equal(ev.mail_id, '');
|
||
assert.equal(ev.to_workspace, '');
|
||
assert.equal(ev.mail_type, 'normal');
|
||
});
|
||
|
||
test('已经通过 SSE 投过的不再补投', () => {
|
||
const mails = [mail({ mail_id: 'a' }), mail({ mail_id: 'b' })];
|
||
const got = selectCatchup(mails, new Set(['a']));
|
||
assert.deepEqual(got.map(e => e.mail_id), ['b']);
|
||
});
|
||
|
||
test('按时间正序补投(收件箱是倒序返回的)', () => {
|
||
// 收件箱:新的在前
|
||
const mails = [mail({ mail_id: 'new' }), mail({ mail_id: 'mid' }), mail({ mail_id: 'old' })];
|
||
const got = selectCatchup(mails, new Set());
|
||
assert.deepEqual(
|
||
got.map(e => e.mail_id),
|
||
['old', 'mid', 'new'],
|
||
'先来的邮件必须先处理,否则同一会话里的上下文顺序是乱的',
|
||
);
|
||
});
|
||
|
||
test('permission 类邮件不补投', () => {
|
||
const mails = [mail({ mail_id: 'p', mail_type: 'permission' }), mail({ mail_id: 'n' })];
|
||
const got = selectCatchup(mails, new Set());
|
||
assert.deepEqual(got.map(e => e.mail_id), ['n']);
|
||
});
|
||
|
||
test('超过上限的部分留在收件箱里', () => {
|
||
const mails = Array.from({ length: MAX_CATCHUP + 4 }, (_, i) => mail({ mail_id: 'm' + i }));
|
||
const got = selectCatchup(mails, new Set());
|
||
assert.equal(got.length, MAX_CATCHUP, '一次补拉不该把几十封邮件同时放出去');
|
||
});
|
||
|
||
test('上限可显式压到 0(用于禁用补拉)', () => {
|
||
const got = selectCatchup([mail()], new Set(), 0);
|
||
assert.deepEqual(got, []);
|
||
});
|
||
|
||
test('空输入与非数组不炸', () => {
|
||
assert.deepEqual(selectCatchup([], new Set()), []);
|
||
assert.deepEqual(selectCatchup(undefined, new Set()), []);
|
||
assert.deepEqual(selectCatchup(null, new Set()), []);
|
||
});
|
||
|
||
test('没有 mail_id 的行跳过', () => {
|
||
const got = selectCatchup([mail({ mail_id: '' }), mail({ mail_id: 'ok' })], new Set());
|
||
assert.deepEqual(got.map(e => e.mail_id), ['ok']);
|
||
});
|
||
|
||
test('seen 传 undefined 时不去重也不报错', () => {
|
||
const got = selectCatchup([mail({ mail_id: 'x' })], undefined);
|
||
assert.deepEqual(got.map(e => e.mail_id), ['x']);
|
||
});
|
||
|
||
test('★ 补投事件必须带权限档位(漏了就会把 full 档会话误拦)', () => {
|
||
const ev = mailToEvent(mail({ permission_mode: 'full', permission_enforcement: 'strict' }));
|
||
assert.equal(ev.permission_mode, 'full', '补投路径不许把档位丢掉');
|
||
assert.equal(ev.permission_enforcement, 'strict');
|
||
// 缺字段时给空串:**不猜档位**(猜宽了就是提权),由调用方 `|| 'workspace'` 兜底
|
||
const bare = mailToEvent(mail());
|
||
assert.equal(bare.permission_mode, '');
|
||
assert.equal(bare.permission_enforcement, '');
|
||
assert.ok(!('permissionMode' in bare), '键名要与 SSE 逐字一致(蛇形),别自造驼峰');
|
||
});
|