JianFeeeee
d5cfcbdc9c
线上事故（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。
33 lines
1.2 KiB
TypeScript
33 lines
1.2 KiB
TypeScript
export const MODE_PLAN: 'plan';
|
||
export const MODE_WORKSPACE: 'workspace';
|
||
export const MODE_FULL: 'full';
|
||
export const MODES: string[];
|
||
export const DEFAULT_MODE: string;
|
||
|
||
export const ENFORCE_NATIVE: 'native';
|
||
export const ENFORCE_PARTIAL: 'partial';
|
||
export const ENFORCE_ADVISORY: 'advisory';
|
||
|
||
export function normalizeMode(mode: unknown): string;
|
||
export function normalizeEnforcement(e: unknown): string;
|
||
export function modeAtMost(a: string, b: string): string;
|
||
/**
|
||
* **状态写入点**专用：拿不到值返回 `null`（= 不要写），绝不兜默认档。
|
||
* 用它而不是 `normalizeMode` —— 默认值可以出现在决策里，不可以出现在状态写入里。
|
||
*/
|
||
export function modeForStateWrite(mode: unknown): string | null;
|
||
export function modeNeedsHuman(mode: string): boolean;
|
||
|
||
export function dshSandboxMode(mode: string): 'read-only' | 'workspace-write' | 'danger-full-access';
|
||
export function dshApprovalPolicy(mode: string): 'ask' | 'never';
|
||
|
||
export function piGuardedTools(mode: string): string[];
|
||
export function piBlocksOutright(mode: string): boolean;
|
||
|
||
export interface ModeBriefingCtx {
|
||
mode: string;
|
||
enforcement: string;
|
||
workspace?: string;
|
||
}
|
||
export function modeBriefing(ctx: ModeBriefingCtx): string;
|