@joekytc/dsh-swarm 0.3.7 → 0.3.9

package/lib/config.d.ts

@@ -58,6 +58,15 @@ export interface KanbanConfig {
         /** 命令黑名单子串（命中即拒执行）。纵深防御：派生命令由系统从 tdd 生成，正常不触黑名单。 */
         forbidden: string[];
     };
+    /** 评审证据三级核验（PR2）：L1 缺证标记 → L2 纸面核对（零执行）→ L3 重放（真执行 AI 命令，默认关——
+     *  开启即视为接受"非沙箱"风险；仅放行已知工具前缀，词边界匹配，npm run 仅固定脚本名）。 */
+    evidenceReplay: {
+        enabled: boolean;
+        /** 重放单条命令超时（ms），到点 SIGKILL。 */
+        timeoutMs: number;
+        /** 已知工具前缀白名单（词边界匹配命令开头；npm run 仅固定脚本名）。未命中 → 不执行转人工。 */
+        allowPrefixes: string[];
+    };
     /** IM 主动投递（企微，2026-09-07 评审决议）：W3 收尾/链阻塞时经 dsh-im 投群。
      *  enabled=false（默认）功能关闭；botId/targetId 留空=运行时自动发现（唯一 wecom bot + 唯一已保存群目标）。
      *  多机器人接入时：botId 留空 → 按会话 preset 匹配机器人（探针读 dsh-im 侧 agentPreset）；
@@ -81,9 +90,11 @@ export interface KanbanConfig {
         };
     };
     /** wiki_write 会话级放行的 preset id 白名单（buildStandaloneDtGuard 非独立分支热读）。
-     *  默认：插件自有 'swarm'（蜂群 preset）/'kanban-w'（W preset）+ 宿主内置 'ptc'
-     *  （2026-09-16 实测：dsh web「蜂群模式」标签会话的 header.agentPreset 实际为宿主
-     *  PTC 模式 id）。宿主 preset 体系演化/部署自定义模式 id 时改配置即可，无需改代码。
+     *  默认：插件自有 'swarm'（蜂群 preset）/'kanban-w'（W preset）+ 宿主内置 'ptc'。
+     *  历史：'ptc' 原是为「dsh web「蜂群模式」标签会话的 header.agentPreset 实为宿主 PTC id」
+     *  打的补丁；2026-09-17 起 preset 判定统一走 session-preset.ts（引擎真相优先），此处
+     *  'ptc' 语义变为「显式放行普通 PTC 模式会话」（写面仍由 wiki_write 路径白名单硬约束）。
+     *  宿主 preset 体系演化/部署自定义模式 id 时改配置即可，无需改代码。
      *  写面仍由 wiki_write 工具内 assertAllowedWikiPagePath 五类命名空间白名单硬约束。 */
     wikiWritePresets: string[];
 }

package/lib/config.js

@@ -57,6 +57,16 @@ export const Config = Schema.object({
         timeoutMs: Schema.number().min(1000).default(600000),
         forbidden: Schema.array(Schema.string()).default(['rm -rf /', 'git push']),
     }).default({ enabled: true, timeoutMs: 600000, forbidden: ['rm -rf /', 'git push'] }),
+    evidenceReplay: Schema.object({
+        enabled: Schema.boolean().default(false),
+        timeoutMs: Schema.number().min(1000).default(600000),
+        allowPrefixes: Schema.array(Schema.string()).default([
+            'npx --no-install vitest', 'npm test', 'npm run build', 'npm run typecheck', 'tsc', 'eslint',
+        ]),
+    }).default({
+        enabled: false, timeoutMs: 600000,
+        allowPrefixes: ['npx --no-install vitest', 'npm test', 'npm run build', 'npm run typecheck', 'tsc', 'eslint'],
+    }),
     imDelivery: Schema.object({
         enabled: Schema.boolean().default(false),
         botId: Schema.string().default(''),

package/lib/dispatcher/agent-runner.js

@@ -5,11 +5,13 @@ import { probeOcr } from '../services/ocr-cli.js';
 import { installRoleTools, buildReadOnlyWriteGuard, buildDTWriteGuard, buildPlanWriteGuard, buildKbWriteGuard, registerDtTaskChain, unregisterDtTaskChain } from '../roles/toolsets.js';
 import { ensureLocalKbRoot } from '../wiki/local-kb.js';
 import { installCleanFsTools } from '../roles/clean-fs-tools.js';
+import { mountOrRecompose } from '../roles/preset-installer.js';
 import { buildModelCandidates, isModelUnavailableError } from './model-candidates.js';
 import { toolName } from './session-events.js';
 import { attachSessionToWorkspace, resolveOrCreateWorkspace } from './workspace-attach.js';
 import { isPathInside, resolveTargetRepoDir } from './target-repo.js';
 import { injectGitCredentials, resolveGitPatFromCtx } from './git-credentials.js';
+import { slimParentMetadata } from './context-dedup.js';
 /** 目标仓库在会话工作空间外、已 claim+block 等待用户授权且尚未建会话的任务集合（key=taskId）。
  *  人工放行后再次调度会重新询问；已授权后从集合移除。仅进程内记忆，重启后从事件日志恢复（block 事件仍在）。 */
 const permissionBlockedTasks = new Set();
@@ -113,7 +115,7 @@ ${task.body}`);
             parts.push('## Parent task results');
             for (const h of parents) {
                 parts.push(`- summary: ${h.summary}`);
-                parts.push(`- metadata: ${JSON.stringify(h.metadata)}`);
+                parts.push(`- metadata: ${JSON.stringify(slimParentMetadata((h.metadata ?? {})))}`);
             }
         }
         // 0.1.0 delegation：D(execute) 目标模式条件注入——spec 卡/父交接命中
@@ -181,12 +183,7 @@ ${task.body}`);
                 const unresolved = issues.filter((i) => i.resolved !== true);
                 parts.push(`- 上一轮评审 ${issues.length} 条 issue：未修复 ${unresolved.length} 条、已修复 ${issues.length - unresolved.length} 条。`);
                 parts.push('- 完整修复清单（含定位、问题原文与建议改法）见任务体「本轮修复清单」节：逐条处理未修复项，只做定点修复，禁止无关联全文重写与任务编号重排。');
-                if (unresolved.length > 0) {
-                    parts.push('- 未修复项速览:');
-                    for (const i of unresolved) {
-                        parts.push(`  - [${i.severity}]${i.legacy ? '[遗留]' : '[新问题]'} ${i.title}${i.location ? `（${i.location}）` : ''}`);
-                    }
-                }
+                // PR1 注入去重：未修复项明细不在此重复（完整清单已在 body「本轮修复清单」节，P0-3 单一信息源）
             }
             else {
                 parts.push('- 事件流未找到 review/failed 记录；请先核对任务体「本轮修复清单」节，再完成返工。');
@@ -275,7 +272,10 @@ ${task.body}`);
                     if (presets) {
                         const presetId = 'kanban-' + task.assignee;
                         try {
-                            await presets.mount(agentCtx, presetId);
+                            // mountOrRecompose（2026-09-21）：blocked/unblock 多轮唤醒 resume 同一 session 时，
+                            // 二次 mount 会撞宿主 dsh-scope 一次性绑定（already bound to a parent）——收敛为
+                            // 已绑走 recompose 官方重链；其余挂载错误仍降级放行（角色工具面照常注册）。
+                            await mountOrRecompose(presets, agentCtx, presetId);
                             console.error('[dsh-swarm][debug] preset mounted ' + presetId + ' role=' + task.assignee + ' task=' + taskId);
                         }
                         catch (err) {

package/lib/dispatcher/chain-auditor.d.ts

@@ -19,7 +19,12 @@ import type { AuditEvidence, Task } from '../domain/types.js';
  *    角色 agent 只写各自任务工作区（workspaces/<chainId>/<taskId>/），
  *    链工作区根下非任务 id 的条目 = 无主产物（疑似主 agent 越权写）→ 证据。
  */
-export interface ChainAuditorDeps {
+export interface ChainAuditorPresetDeps {
+    /** 会话 preset 读取（生产由 dispatcher 注入 session-preset.ts 的统一实现；缺省回落 header
+     *  ——创建事实，仅供测试/未接线场景保留既有行为）。 */
+    readPreset?(agent: unknown): string;
+}
+export interface ChainAuditorDeps extends ChainAuditorPresetDeps {
     kanban: KanbanService;
     workspacesRoot: string;
     /** 活 agent 注册表快照（dispatcher 注入 ctx.agents.list 的适配）；测试可伪造。 */
@@ -38,6 +43,7 @@ export declare class ChainAuditor {
     private readonly kanban;
     private readonly workspacesRoot;
     private readonly listLiveAgents;
+    private readonly readPreset;
     constructor(deps: ChainAuditorDeps);
     /** 执行核对，返回越权证据（空=通过，不阻塞汇报）。
      *  @param workspaceDir 本链发起工作区（Chain.workspaceDir）；提供时仅扫描工作区内的会话。 */

package/lib/dispatcher/chain-auditor.js

@@ -3,6 +3,7 @@ import { readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { eventType, toolArgs, toolName } from './session-events.js';
 import { isPathInside } from './target-repo.js';
+import { headerPresetOf } from './session-preset.js';
 /** 直接写工具（无条件视为写能力；只读工具如 read/glob/grep 不算）。 */
 const DIRECT_WRITE_TOOLS = new Set(['write', 'edit', 'rm', 'mv', 'cp', 'mkdir', 'mkfile']);
 /** run_code：写能力载体，需结合派发子调用判定。 */
@@ -138,10 +139,12 @@ export class ChainAuditor {
     kanban;
     workspacesRoot;
     listLiveAgents;
+    readPreset;
     constructor(deps) {
         this.kanban = deps.kanban;
         this.workspacesRoot = deps.workspacesRoot;
         this.listLiveAgents = deps.listLiveAgents ?? (() => []);
+        this.readPreset = deps.readPreset ?? headerPresetOf;
     }
     /** 执行核对，返回越权证据（空=通过，不阻塞汇报）。
      *  @param workspaceDir 本链发起工作区（Chain.workspaceDir）；提供时仅扫描工作区内的会话。 */
@@ -151,11 +154,11 @@ export class ChainAuditor {
         for (const agent of this.listLiveAgents()) {
             if (String(agent.id ?? '').startsWith('kbn-'))
                 continue; // 角色会话（P/W/D/V）跳过
-            // 0.1.0 delegation 豁免：header.agentPreset 以 kanban- 开头 → 角色会话
-            // 的子代理（childSessionMeta 记录所 join 的 preset id），产物归属 git 证据链，
+            // 0.1.0 delegation 豁免：preset 以 kanban- 开头 → 角色会话的子代理，产物归属 git 证据链，
             // 不按"主会话越权"判定；源2（无主产物核对）仍兜底其误写链工作区根。
-            const joinedPreset = agent.session?.header?.agentPreset;
-            if (typeof joinedPreset === 'string' && joinedPreset.startsWith('kanban-'))
+            // preset 经 readPreset 统一读面（子代理继承父组合，引擎真相同样成立）。
+            const joinedPreset = this.readPreset(agent);
+            if (joinedPreset.startsWith('kanban-'))
                 continue;
             // 作用域收窄——仅扫本链发起工作区内的会话；会话无 cwd（测试伪造）时保守保留扫描
             if (workspaceDir && agent.session?.header?.cwd && !isPathInside(agent.session.header.cwd, workspaceDir)) {

package/lib/dispatcher/context-dedup.d.ts

@@ -0,0 +1 @@
+export declare function slimParentMetadata(metadata: Record<string, unknown>): Record<string, unknown>;

package/lib/dispatcher/context-dedup.js

@@ -0,0 +1,24 @@
+// src/dispatcher/context-dedup.ts
+/** buildContext 父链 metadata 注入瘦身（PR1 注入去重，纯函数）：
+ * 1) review_evidence 整键剥离——issues 已由返工卡 body「本轮修复清单」单一信息源承载（P0-3）；
+ * 2) 超长数组截断 20 条 + 计数尾注（changed_files 等）；超长字符串截断 2000 字符。
+ * 防御性通用规则，不感知业务键语义；原 metadata 不修改。 */
+const MAX_ARRAY = 20;
+const MAX_STRING = 2000;
+export function slimParentMetadata(metadata) {
+    const out = {};
+    for (const [k, v] of Object.entries(metadata)) {
+        if (k === 'review_evidence')
+            continue;
+        if (Array.isArray(v)) {
+            out[k] = v.length > MAX_ARRAY ? [...v.slice(0, MAX_ARRAY), `…(+${v.length - MAX_ARRAY} more)`] : v;
+        }
+        else if (typeof v === 'string' && v.length > MAX_STRING) {
+            out[k] = v.slice(0, MAX_STRING) + '…(truncated)';
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}

package/lib/dispatcher/dispatcher.d.ts

@@ -85,6 +85,14 @@ export declare class Dispatcher {
 /** 启动 reconcile：剔除事件流中已不存在的链的编排 entry（历史残留/外部 purge）。
  *  原地删除并返回被移除的 chainId 列表（调用方负责持久化与日志）。 */
 export declare function reconcileOrchestrations<T>(orch: Map<string, T>, chains: Set<string>): string[];
+/** 启动补扫候选：快照中全部 executing 状态链（2026-09-21 重启吞编排轮事故）。
+ *  EventWaker 纯事件驱动，历史 wakeable 事件（如 PT completed）被重启游标越过即永不重放；
+ *  启动时按链状态补唤醒，与 EventWaker 的实时驱动互补。 */
+export declare function collectExecutingChains(snap: {
+    chains: Map<string, {
+        status: string;
+    }>;
+}): string[];
 /** 启动 reconcile：进程重启会杀死 runner 的 whenIdle 协程，上次遗留的 running 卡无人收尾，
  *  看门狗默认 4h（staleTimeoutSeconds=14400）才回收——重启后立即把 running 孤儿卡收敛为 blocked
  *  （system comment + blockTask），中断显形且可重派续跑（重派将 resume 同一会话，进度保留）。

package/lib/dispatcher/dispatcher.js

@@ -9,6 +9,7 @@ import { VOrchestrator } from './v-orchestrator.js';
 import { AgentRunner } from './agent-runner.js';
 import { Watchdog } from './watchdog.js';
 import { ChainAuditor } from './chain-auditor.js';
+import { sessionPresetOf } from './session-preset.js';
 import { mergeDAfterReview } from './merge-gate.js';
 import { buildSubagentTreeGuard, buildSwarmSessionGuard, buildStandaloneDtGuard, registerStandaloneReviewerTools } from '../roles/toolsets.js';
 import { syncKbLinks } from '../wiki/kb-linkage.js';
@@ -310,6 +311,17 @@ export function reconcileOrchestrations(orch, chains) {
         orch.delete(k);
     return removed;
 }
+/** 启动补扫候选：快照中全部 executing 状态链（2026-09-21 重启吞编排轮事故）。
+ *  EventWaker 纯事件驱动，历史 wakeable 事件（如 PT completed）被重启游标越过即永不重放；
+ *  启动时按链状态补唤醒，与 EventWaker 的实时驱动互补。 */
+export function collectExecutingChains(snap) {
+    const out = [];
+    for (const [chainId, chain] of snap.chains) {
+        if (chain.status === 'executing')
+            out.push(chainId);
+    }
+    return out;
+}
 /** 启动 reconcile：进程重启会杀死 runner 的 whenIdle 协程，上次遗留的 running 卡无人收尾，
  *  看门狗默认 4h（staleTimeoutSeconds=14400）才回收——重启后立即把 running 孤儿卡收敛为 blocked
  *  （system comment + blockTask），中断显形且可重派续跑（重派将 resume 同一会话，进度保留）。
@@ -414,6 +426,9 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
         kanban,
         workspacesRoot: join(storageDir, 'workspaces'),
         listLiveAgents: () => (ctx.get('agents')?.list?.() ?? []),
+        // preset 判定统一走 session-preset.ts（引擎真相优先）：只读 header 会把
+        // 「蜂群模式」标签会话（header=宿主默认 ptc）误判成主会话越权。
+        readPreset: (agent) => sessionPresetOf(ctx, agent),
     });
     kanban.setOnChainCompleted(async (chainId) => {
         // 传入本链发起工作区（Chain.workspaceDir），审计仅扫描该工作区内的会话，排除其他项目主会话
@@ -455,17 +470,20 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
     // guard 内部仅对 kanban-dt 系会话收紧；DT 父会话自身仍由 agent-runner 的 agent.ctx
     // guard 双保险。dispose 时注销。
     const toolsSvc = ctx.get('tools');
-    const unguardSubagents = toolsSvc?.guard?.(buildSubagentTreeGuard());
+    // 三个 preset 判定 guard 共用统一读面（session-preset.ts）：引擎真相优先，避免
+    // 「蜂群模式」标签会话（header=宿主默认 ptc）绕过只读/评审硬闸。
+    const readPreset = (agent) => sessionPresetOf(ctx, agent);
+    const unguardSubagents = toolsSvc?.guard?.(buildSubagentTreeGuard({ readPreset }));
     if (unguardSubagents) {
         ctx.on('dispose', unguardSubagents);
     }
-    // 蜂群模式硬闸：header.agentPreset==='swarm' 时只读+git 反选拦截；
+    // 蜂群模式硬闸：会话 preset==='swarm'（统一读面，非 header）时只读+git 反选拦截；
     // 内部对其余会话恒放行。dispose 时注销（与 subagent guard 同款）。
-    const unguardSwarm = toolsSvc?.guard?.(buildSwarmSessionGuard());
+    const unguardSwarm = toolsSvc?.guard?.(buildSwarmSessionGuard({ readPreset }));
     if (unguardSwarm) {
         ctx.on('dispose', unguardSwarm);
     }
-    // 独立评审硬闸：header.agentPreset==='kanban-dt' 且未经角色组合（session id 非 kbn-
+    // 独立评审硬闸：会话 preset==='kanban-dt'（统一读面）且未经角色组合（session id 非 kbn-
     // 前缀）时收紧（看板写工具拒、bash/run_code 仅只读 git+clone/fetch、wiki_write 仅
     // reviews 命名空间）；wiki_write 对非评审会话全局收紧（链上组合会话/swarm 主会话/
     // W preset 会话放行）。dispose 时注销（与 subagent/swarm guard 同款）。
@@ -473,6 +491,7 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
         // wiki_write 放行白名单热读配置（applyOverride 后下次工具调用即生效）；
         // config 缺字段回 [] fail-closed（默认值由 config.ts schema 保证存在）。
         getWikiWritePresets: () => configProvider.getEffective().wikiWritePresets ?? [],
+        readPreset,
     }));
     if (unguardStandalone) {
         ctx.on('dispose', unguardStandalone);
@@ -515,6 +534,16 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
                 saveOrchs();
                 logToFile(logFile, '[orch-reconcile] removed dead entries: ' + removed.join(','));
             }
+            // 启动补扫（2026-09-21）：EventWaker 纯事件驱动——实例重启后游标已越过「已完成但未推进」
+            // 的 wakeable 事件（如 PT completed）时编排轮被吞（历史事件不重放），executing 链静默停滞
+            // （销服一体 V3.0 链实测：PT done 后 W2 永不建卡）。启动时对全部 executing 链补一次 wakeV
+            // （幂等：wakeV 按 orchestration/链快照决策 + 在途合并；无可推进阶段时无害空转）。
+            for (const chainId of collectExecutingChains(snap)) {
+                logToFile(logFile, '[startup-rewake] executing chain=' + chainId);
+                void vOrch.wakeV(chainId).catch((err) => {
+                    logToFile(logFile, '[startup-rewake] failed chain=' + chainId + ' ' + String(err));
+                });
+            }
         }
         catch (err) {
             logToFile(logFile, '[orch-reconcile] failed: ' + String(err));

package/lib/dispatcher/session-preset.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 会话 preset 读取 —— 全插件单一实现（守卫、交付投递、审计共用，禁止各写一份）。
+ *
+ * 四级官方链，逐级回退（鸭子类型，不引入 dsh-session / dsh-agent 依赖）：
+ *   ① `ctx.agentPresets.composedPreset(agent.ctx)` —— **引擎真相**：该 live agent 实际挂载的组合。
+ *      官方语义："Read from the live scope chain rather than from the session, so it answers for an
+ *      agent whose session has not recorded a preset yet"；子代理继承父组合，同样有答案。
+ *   ② `ctx.sessionProjections.stateOf(session,'agentPreset')` —— 会话日志口径（持久、可冷读，
+ *      镜像客户端所见）；`agent-presets` 在插件 apply 期一次注册该 key（源码 register 调用），
+ *      故 key 恒在，仅当会话对象缺失或投影服务未装时为空。
+ *   ③ `session.header.agentPreset` —— **创建事实**（官方 deep-frozen）。
+ *   ④ `agentPresets.defaultId` → 空串（调用方按「未知模式」处理，绝不能当默认模式猜）。
+ *
+ * 为什么不能只读 header（2026-09-17 实测 + 官方语义）：preset 只在会话**空白期（首轮之前）**可改，
+ * 改后 header 保持创建时的值不再回头，而 ①② 前进。dsh web 的「蜂群模式」标签会话即此形态——
+ * header 落宿主默认 'ptc'、实际运行 'swarm'。只读 header 会让所有按 preset 分流的判定整体错位
+ * （实测造成：多机器人投递误判未命中、蜂群只读硬闸被绕过）。
+ */
+/** preset 读取用的 agent 最小面（结构鸭子类型）。 */
+export interface PresetAgentLike {
+    ctx?: unknown;
+    session?: {
+        header?: {
+            agentPreset?: unknown;
+        };
+    };
+}
+/** preset 读取用的 ctx 最小面（只需 get）。 */
+export interface PresetCtxLike {
+    get?(name: string): unknown;
+}
+/** 创建事实（header.agentPreset）：仅用于「会话创建时是什么」这类语义，或作为末级回退。
+ *  需要「现在跑什么模式」一律用 {@link sessionPresetOf}。 */
+export declare function headerPresetOf(agent: unknown): string;
+/** 当前会话/agent 的 preset id（引擎真相 → 会话投影 → 创建 header → 默认 id → 空串）。 */
+export declare function sessionPresetOf(ctx: PresetCtxLike | null | undefined, agent: unknown): string;

package/lib/dispatcher/session-preset.js

@@ -0,0 +1,67 @@
+// src/dispatcher/session-preset.ts
+/**
+ * 会话 preset 读取 —— 全插件单一实现（守卫、交付投递、审计共用，禁止各写一份）。
+ *
+ * 四级官方链，逐级回退（鸭子类型，不引入 dsh-session / dsh-agent 依赖）：
+ *   ① `ctx.agentPresets.composedPreset(agent.ctx)` —— **引擎真相**：该 live agent 实际挂载的组合。
+ *      官方语义："Read from the live scope chain rather than from the session, so it answers for an
+ *      agent whose session has not recorded a preset yet"；子代理继承父组合，同样有答案。
+ *   ② `ctx.sessionProjections.stateOf(session,'agentPreset')` —— 会话日志口径（持久、可冷读，
+ *      镜像客户端所见）；`agent-presets` 在插件 apply 期一次注册该 key（源码 register 调用），
+ *      故 key 恒在，仅当会话对象缺失或投影服务未装时为空。
+ *   ③ `session.header.agentPreset` —— **创建事实**（官方 deep-frozen）。
+ *   ④ `agentPresets.defaultId` → 空串（调用方按「未知模式」处理，绝不能当默认模式猜）。
+ *
+ * 为什么不能只读 header（2026-09-17 实测 + 官方语义）：preset 只在会话**空白期（首轮之前）**可改，
+ * 改后 header 保持创建时的值不再回头，而 ①② 前进。dsh web 的「蜂群模式」标签会话即此形态——
+ * header 落宿主默认 'ptc'、实际运行 'swarm'。只读 header 会让所有按 preset 分流的判定整体错位
+ * （实测造成：多机器人投递误判未命中、蜂群只读硬闸被绕过）。
+ */
+function asPresetId(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/** 创建事实（header.agentPreset）：仅用于「会话创建时是什么」这类语义，或作为末级回退。
+ *  需要「现在跑什么模式」一律用 {@link sessionPresetOf}。 */
+export function headerPresetOf(agent) {
+    const a = agent;
+    return asPresetId(a?.session?.header?.agentPreset);
+}
+/** 当前会话/agent 的 preset id（引擎真相 → 会话投影 → 创建 header → 默认 id → 空串）。 */
+export function sessionPresetOf(ctx, agent) {
+    const get = typeof ctx?.get === 'function' ? ctx.get.bind(ctx) : undefined;
+    const presets = get?.('agentPresets');
+    const a = agent;
+    // ① 引擎真相：读取失败（作用域链异常）不阻断调用方，降级到会话口径。
+    if (a?.ctx !== undefined && typeof presets?.composedPreset === 'function') {
+        let composed;
+        try {
+            composed = presets.composedPreset(a.ctx);
+        }
+        catch {
+            composed = undefined;
+        }
+        const id = asPresetId(composed);
+        if (id)
+            return id;
+    }
+    // ② 会话日志口径。
+    const projections = get?.('sessionProjections');
+    if (a?.session !== undefined && typeof projections?.stateOf === 'function') {
+        let projected;
+        try {
+            projected = projections.stateOf(a.session, 'agentPreset');
+        }
+        catch {
+            projected = undefined;
+        }
+        const id = asPresetId(projected);
+        if (id)
+            return id;
+    }
+    // ③ 创建事实。
+    const fromHeader = headerPresetOf(a);
+    if (fromHeader)
+        return fromHeader;
+    // ④ 默认 id（读不到 → 空串 = 未知模式）。
+    return asPresetId(presets?.defaultId);
+}

package/lib/dispatcher/v-orchestrator.js

@@ -1,4 +1,5 @@
 import { installRoleTools } from '../roles/toolsets.js';
+import { mountOrRecompose } from '../roles/preset-installer.js';
 import { resolveTaskParents } from '../domain/task-parents.js';
 import { missingParentDelivery } from '../domain/delivery-contract.js';
 import { buildRepoSlug } from '../domain/memory.js';
@@ -636,9 +637,11 @@ export class VOrchestrator {
                 // 无 persona 基座不得裸奔。抛错 → create/resume 失败 → getVAgent 抛 → 主推进路径并入
                 // 异常收场（stall 计数，超限 [create-failed] + blockChain）；候选循环对非 model
                 // 错误立即失败（isModelUnavailableError=false → throw），不会被候选切换吞掉。
+                // mountOrRecompose（2026-09-21）：V 会话跨进程重启 resume / 重入 setup 时二次 mount
+                // 会撞宿主 dsh-scope 一次性绑定——already-bound 收敛为 recompose 官方重链，其余照抛。
                 const vSessionId = orch.sessionId ?? 'kbn-v-' + orch.chainId;
                 try {
-                    await presets.mount(agentCtx, V_SESSION_PRESET_ID);
+                    await mountOrRecompose(presets, agentCtx, V_SESSION_PRESET_ID);
                 }
                 catch (err) {
                     throw new Error(V_SESSION_PRESET_ID + ' preset mount failed for ' + vSessionId + ': ' + String(err));

package/lib/domain/delivery-contract.d.ts

@@ -1,6 +1,7 @@
 import type { BoardState, Handoff, Role, TaskMode } from './types.js';
 export declare function requiredDeliveryKeys(assignee: Role, mode: TaskMode): string[];
-/** v2：pt_decision 结构校验（needed 布尔必填；needed=true 时 reason 必填）。返回缺失键列表。 */
+/** v2：pt_decision 结构校验（needed 布尔必填；needed=true 时 reason 必填）。返回缺失键列表。
+ *  2026-09-21：metadata 非对象（双重编码字符串）时报类型真因，不产生误导性 'pt_decision' 缺键文案。 */
 export declare function missingPtDecisionKeys(handoff: Handoff | undefined): string[];
 /** 缺失的交付键（存在但为空的字符串/非字符串均视为缺失；pt_decision 走结构校验透传细粒度键）。
  *  可选 kbUrlBase：提供时对 w:kb 的 kb_url 做 host 前缀硬校验（防 LLM 手写错域名）、对 page_path 做

package/lib/domain/delivery-contract.js

@@ -17,9 +17,14 @@ const REQUIRED_DELIVERY = {
 export function requiredDeliveryKeys(assignee, mode) {
     return REQUIRED_DELIVERY[`${assignee}:${mode}`] ?? [];
 }
-/** v2：pt_decision 结构校验（needed 布尔必填；needed=true 时 reason 必填）。返回缺失键列表。 */
+/** v2：pt_decision 结构校验（needed 布尔必填；needed=true 时 reason 必填）。返回缺失键列表。
+ *  2026-09-21：metadata 非对象（双重编码字符串）时报类型真因，不产生误导性 'pt_decision' 缺键文案。 */
 export function missingPtDecisionKeys(handoff) {
-    const d = (handoff?.metadata ?? {})['pt_decision'];
+    const rawMeta = handoff?.metadata ?? {};
+    if (typeof rawMeta !== 'object' || rawMeta === null) {
+        return [`pt_decision (metadata must be an object, got ${Array.isArray(rawMeta) ? 'array' : typeof rawMeta})`];
+    }
+    const d = rawMeta['pt_decision'];
     if (typeof d !== 'object' || d === null)
         return ['pt_decision'];
     const o = d;
@@ -39,7 +44,11 @@ export function missingDeliveryKeys(assignee, mode, handoff, kbUrlBase) {
         return [];
     if (!handoff)
         return keys.slice();
-    const m = handoff.metadata ?? {};
+    // 2026-09-21：metadata 非对象（模型双重编码字符串穿透 {type:'json'} 宽参数）时，m[k] 对字符串
+    // 索引静默 undefined → 误导性 "delivery required" 缺键报错。此处报类型真因（纵深防线）。
+    const rawMeta = handoff.metadata ?? {};
+    const metaOk = typeof rawMeta === 'object' && rawMeta !== null && !Array.isArray(rawMeta);
+    const m = metaOk ? rawMeta : null;
     // 推导修正：kbUrlBase === undefined 才是宽松；'' 是 local strict
     const hasBase = kbUrlBase !== undefined;
     const base = hasBase ? kbUrlBase.replace(/\/$/, '') : null;
@@ -50,6 +59,10 @@ export function missingDeliveryKeys(assignee, mode, handoff, kbUrlBase) {
             missing.push(...missingPtDecisionKeys(handoff));
             continue;
         }
+        if (!metaOk) {
+            missing.push(`${k} (metadata must be an object, got ${Array.isArray(rawMeta) ? 'array' : typeof rawMeta})`);
+            continue;
+        }
         const v = m[k];
         if (strict && k === 'kb_url' && base === '') {
             // local 模式：kb_url 必须显式空串（非缺失键）

package/lib/domain/evidence-check.d.ts

@@ -0,0 +1,17 @@
+/** 评审证据核验纯函数（PR2 三级递进的判定层，零 IO）。
+ * 四态：matches/differs/could-not-replay/not-provided（澄清表 #6，2026-09-17 精化：
+ * "严重缺证才重放"不可执行——缺证即无命令可重放，落 could-not-replay + 转人工）。
+ * schema 单点封装：owner 调整 evidence 形态只改 parseIssueEvidence。 */
+export type EvidenceState = 'matches' | 'differs' | 'could-not-replay' | 'not-provided';
+export interface IssueEvidence {
+    file: string;
+    command: string;
+    exit: number;
+}
+/** issue.evidence 结构校验（issue #2 原样 schema：{file, command, exit}）。非法 → null（按 not-provided 处理）。 */
+export declare function parseIssueEvidence(raw: unknown): IssueEvidence | null;
+/** 纸面核对（零执行）：存档文件首行 `[exit code: N]` vs 声明 exit（行尾锚定，防 `[exit code: 0]任意文本` 绕过）。
+ * unreadable（文件缺失/首行非规范格式）宁纵勿枉 → 转人工，不判 matches。 */
+export declare function paperCheck(content: string | null, claimedExit: number): 'matches' | 'mismatch' | 'unreadable';
+/** 命令准入：词边界前缀匹配（非子串）；`npm run` 仅放行白名单内固定脚本名；rest 禁 shell 元字符。 */
+export declare function isAllowedCommand(command: string, prefixes: string[]): boolean;

package/lib/domain/evidence-check.js

@@ -0,0 +1,44 @@
+// src/domain/evidence-check.ts
+/** 评审证据核验纯函数（PR2 三级递进的判定层，零 IO）。
+ * 四态：matches/differs/could-not-replay/not-provided（澄清表 #6，2026-09-17 精化：
+ * "严重缺证才重放"不可执行——缺证即无命令可重放，落 could-not-replay + 转人工）。
+ * schema 单点封装：owner 调整 evidence 形态只改 parseIssueEvidence。 */
+/** issue.evidence 结构校验（issue #2 原样 schema：{file, command, exit}）。非法 → null（按 not-provided 处理）。 */
+export function parseIssueEvidence(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const r = raw;
+    if (typeof r['file'] !== 'string' || !r['file'].trim())
+        return null;
+    if (typeof r['command'] !== 'string' || !r['command'].trim())
+        return null;
+    if (typeof r['exit'] !== 'number' || !Number.isFinite(r['exit']))
+        return null;
+    return { file: r['file'], command: r['command'], exit: r['exit'] };
+}
+/** 纸面核对（零执行）：存档文件首行 `[exit code: N]` vs 声明 exit（行尾锚定，防 `[exit code: 0]任意文本` 绕过）。
+ * unreadable（文件缺失/首行非规范格式）宁纵勿枉 → 转人工，不判 matches。 */
+export function paperCheck(content, claimedExit) {
+    if (content === null)
+        return 'unreadable';
+    const first = content.trimStart().split('\n')[0]?.trim() ?? '';
+    const m = /^\[exit code:\s*(-?\d+)\]$/.exec(first);
+    if (!m)
+        return 'unreadable';
+    return Number(m[1]) === claimedExit ? 'matches' : 'mismatch';
+}
+/** shell 元字符：rest 中出现任一即拒绝——整串命令会交给 `bash -c` 执行（gate-runner），
+ * 前缀白名单只保证"以安全工具开头"，元字符可拼接任意后续命令（`npm test && rm -rf`）。 */
+const SHELL_META = /[;|&`$()<>\n'"\\]/;
+/** 命令准入：词边界前缀匹配（非子串）；`npm run` 仅放行白名单内固定脚本名；rest 禁 shell 元字符。 */
+export function isAllowedCommand(command, prefixes) {
+    const trimmed = command.trim();
+    return prefixes.some((p) => {
+        if (!trimmed.startsWith(p))
+            return false;
+        const rest = trimmed.slice(p.length);
+        if (SHELL_META.test(rest))
+            return false; // 元字符 = 命令链/替换/重定向，一律拒绝
+        return rest === '' || rest.startsWith(' ') || rest.startsWith('\t'); // 词边界：拒绝 'npm testify'
+    });
+}

package/lib/domain/gate-policy.d.ts

@@ -3,16 +3,38 @@ export interface GateCommand {
     cwd: string;
     source: 'tdd';
 }
-export interface GatePlan {
+export type GateOutcome = {
+    kind: 'run';
     commands: GateCommand[];
-    skipped: false;
-}
-export interface GateSkip {
-    commands: [];
-    skipped: true;
+} | {
+    kind: 'bounce';
     reason: string;
-}
-export declare function isGatePlan(x: GatePlan | GateSkip): x is GatePlan;
+} | {
+    kind: 'alarm-skip';
+    reason: string;
+} | {
+    kind: 'silent-skip';
+    reason: string;
+};
+export type SkippedVerdict = {
+    action: 'allow-alarm';
+    reason: string;
+} | {
+    action: 'bounce';
+    reason: string;
+} | {
+    action: 'proceed';
+};
+/** ④ tdd.skipped 声明互证：diff 实况三分支（改声明 / tdd 先行 / 放行留痕）。
+ * 返回类型排除 proceed（proceed 仅为 test_files 对称核验的"放行"语义）。 */
+export declare function classifySkippedDeclaration(diffFiles: string[] | null): Exclude<SkippedVerdict, {
+    action: 'proceed';
+}>;
+/** 对称核验：声明 tdd.test_files 但 diff 零测试变更（拿旧测试交差）→ bounce。 */
+export declare function classifyTestFilesDeclaration(diffFiles: string[] | null): SkippedVerdict;
+/** 从 D 卡 body 解析 diff base（body 模板声明 `TARGET_BRANCH=<目标分支名>`，v-orchestrator d:76）。
+ * 与 test_files 同款防线：拒 git 旗标注入（`--output=/x` 可写任意路径文件）与路径逃逸。 */
+export declare function resolveDiffBase(body: string): string | null;
 export declare function branchMatches(current: string | null, declared: unknown): boolean;
 export declare function deriveGatePlan(input: {
     assignee: string;
@@ -23,4 +45,6 @@ export declare function deriveGatePlan(input: {
     config: {
         enabled: boolean;
     };
-}): GatePlan | GateSkip;
+    /** 装配层 git diff --name-only base...HEAD 结果；undefined/null=不可得（保守）。 */
+    diffFiles?: string[] | null;
+}): GateOutcome;