/** * 档位 → ZCode `--mode` 映射的测试。 * * 这个映射是**授权系统存不存在**的开关:ZCode 的判定里 yolo 一律 allow, * 而 `--prompt` 的默认 mode 就是 yolo。映射写错不会报错,只会让全部授权询问 * 静默消失 —— 所以它是本项目里少数几个「错一个值等于功能整体失效」的地方。 */ import { test } from 'node:test'; import assert from 'node:assert/strict'; import { zcodeModeForTier, modeReachesPermissionHook, describeTier, ZCODE_MODES } from '../src/turn-mode.mjs'; test('★ workspace 映射到 plan(不是 build),full 映射到 yolo', () => { // build 在 headless 下等于「什么都不行」:MCP 工具的 needsApproval 硬编码为真, // 而 headless 没有审批客户端 → 连 read_inbox 都被拒(实测)。 // plan 是真的 fail-closed:危险的自带工具被平台拒,我们的非破坏性工具放行。 assert.equal(zcodeModeForTier('plan'), 'plan'); assert.equal(zcodeModeForTier('workspace'), 'plan'); assert.equal(zcodeModeForTier('full'), 'yolo'); }); test('★ 映射可被 AGENTMAIL_ZCODE_MODE_MAP 覆盖(平台修好后不必等发版)', () => { assert.equal(zcodeModeForTier('workspace', { AGENTMAIL_ZCODE_MODE_MAP: 'workspace:build' }), 'build'); assert.equal(zcodeModeForTier('workspace', { AGENTMAIL_ZCODE_MODE_MAP: 'workspace:yolo,full:plan' }), 'yolo'); // 非法值被忽略,不改变默认 assert.equal(zcodeModeForTier('workspace', { AGENTMAIL_ZCODE_MODE_MAP: 'workspace:nonsense' }), 'plan'); assert.equal(zcodeModeForTier('workspace', { AGENTMAIL_ZCODE_MODE_MAP: '' }), 'plan'); }); test('★ 只有 full 档会得到 yolo', () => { // 反向对照:如果任何其它档位(含拼错的、空的、未知的、大小写不对的) // 也能得到 yolo,那就意味着一个打字错误会关掉整个授权系统。 for (const tier of ['plan', 'workspace', '', undefined, 'worjspace', 'default', 'FULL', 'Full']) { assert.notEqual( zcodeModeForTier(tier), 'yolo', `档位 ${JSON.stringify(tier)} 不该得到 yolo(实际 ${zcodeModeForTier(tier)})` ); } }); test('★ 大写 FULL 不认,落在安全侧', () => { // 共用库的 normalizeMode 是严格匹配的(只认小写),实测 FULL → workspace。 // 这是**刻意保留**的好性质:认不出来时不会掉进「免授权」那一档, // 而是退回 default。这条断言把它钉住 —— 哪天有人「顺手」改成大小写不敏感, // 就会有一个打字错误变成全权授权的风险面。 assert.equal(zcodeModeForTier('FULL'), 'plan'); assert.equal(zcodeModeForTier('PLAN'), 'plan'); }); test('未知档位退回 plan(安全侧),不是 yolo', () => { assert.equal(zcodeModeForTier('nonsense'), 'plan'); assert.equal(zcodeModeForTier(undefined), 'plan'); }); test('产出的 mode 必须是 ZCode 认识的值', () => { for (const tier of ['plan', 'workspace', 'full', 'x', undefined]) { assert.ok(ZCODE_MODES.includes(zcodeModeForTier(tier)), tier); } }); test('★ 只有 full 档会得到 yolo(覆盖后仍成立)', () => { assert.equal(zcodeModeForTier('full', {}), 'yolo'); assert.equal(zcodeModeForTier('workspace', {}), 'plan'); assert.equal(zcodeModeForTier('plan', {}), 'plan'); }); test('只有 build / edit 会让危险操作走到授权钩子', () => { assert.equal(modeReachesPermissionHook('build'), true); assert.equal(modeReachesPermissionHook('edit'), true); // plan 由 ZCode 自己就拒了;yolo 直接放行 —— 两者都不产生询问 assert.equal(modeReachesPermissionHook('plan'), false); assert.equal(modeReachesPermissionHook('yolo'), false); }); test('★ 反向对照:plan 与 full 都不产生询问,但原因不同', () => { // 两条路都不产生 PermissionRequest,却在日志里必须能区分: // 一个是「只读,ZCode 拒了」,一个是「全权,刻意不问」。 const plan = describeTier('plan'); const full = describeTier('full'); assert.notEqual(plan, full); assert.match(plan, /只读/); assert.match(full, /全权/); // workspace 在本平台退到 plan,日志里必须说清**为什么**退 // (否则人只会看到「为什么它什么都不做」而无从判断) assert.match(describeTier('workspace'), /headless 做不到|只读/); // 显式覆盖回 build 时,说明恢复成「会走到授权钩子」 assert.match(describeTier('workspace', 'build'), /授权钩子/); });