@joekytc/dsh-swarm 0.2.0 → 0.3.0

package/lib/dispatcher/dispatcher.js

@@ -10,7 +10,7 @@ import { AgentRunner } from './agent-runner.js';
 import { Watchdog } from './watchdog.js';
 import { ChainAuditor } from './chain-auditor.js';
 import { mergeDAfterReview } from './merge-gate.js';
-import { buildSubagentTreeGuard } from '../roles/toolsets.js';
+import { buildSubagentTreeGuard, buildSwarmSessionGuard, buildStandaloneDtGuard, registerStandaloneReviewerTools } from '../roles/toolsets.js';
 import { syncKbLinks } from '../wiki/kb-linkage.js';
 /** 读取部署默认模型（settings 的 agent-default-model 优先，其次 dsh-agent-default-model），角色未单独配置时回退使用。 */
 export function resolveDefaultModel(ctx) {
@@ -41,7 +41,7 @@ function parentsDone(task, state) {
         return parent !== undefined && (parent.status === 'done' || parent.status === 'archived');
     });
 }
-/** B6：从状态文件恢复 lastSeq；无文件时回退到事件日志尾行（不重放旧事件重复唤醒 V）。 */
+/** 从状态文件恢复 lastSeq；无文件时回退到事件日志尾行（不重放旧事件重复唤醒 V）。 */
 function loadLastSeq(stateFile) {
     try {
         const raw = JSON.parse(readFileSync(stateFile, 'utf8'));
@@ -57,7 +57,7 @@ function saveLastSeq(stateFile, lastSeq) {
     }
     catch { /* 忽略写失败：事件日志仍是事实源 */ }
 }
-/** 修复轮 6：把 [dsh-swarm] 关键事件追加到 storageDir/dispatcher.log，便于无控制台时观测调度器状态。 */
+/** 把 [dsh-swarm] 关键事件追加到 storageDir/dispatcher.log，便于无控制台时观测调度器状态。 */
 function logToFile(file, msg) {
     try {
         writeFileSync(file, new Date().toISOString() + ' ' + msg + '\n', { flag: 'a' });
@@ -79,22 +79,22 @@ export function makeWakeImpl(wakeV, logFile, onSettled) {
         onSettled();
     };
 }
-/** 修复轮 6：单次异步操作加超时护栏——一个挂起的 V 编排会话不得卡死整个调度器 tick。 */
+/** 单次异步操作加超时护栏——一个挂起的 V 编排会话不得卡死整个调度器 tick。 */
 function withTimeout(p, ms, label) {
     return Promise.race([
         p,
         new Promise((_, reject) => setTimeout(() => reject(new Error('timeout: ' + label)), ms)),
     ]);
 }
-/** 防线①：链级进度看门狗阈值。tick=2000ms × 45 ticks = 90s 无进展即重唤醒（grill Q2 决议）。 */
+/** 防线①：链级进度看门狗阈值。tick=2000ms × 45 ticks = 90s 无进展即重唤醒。 */
 export const STALL_WATCHDOG_TICKS = 45;
-/** 防线①：链级重唤醒上限（grill Q3 决议：超限 [create-failed] + chain/blocked）。 */
+/** 防线①：链级重唤醒上限（超限 [create-failed] + chain/blocked）。 */
 export const STALL_WATCHDOG_REWAKE_LIMIT = 3;
-/** 调度器：事件唤醒 V（R20 逐阶段建卡）+ 每任务一次性角色 agent + 心跳看门狗。
- *  - B1：failed 且 attempts<maxRetries 的任务重派（claim→running，AgentRunner resume 同一会话）；
+/** 调度器：事件唤醒 V（逐阶段建卡）+ 每任务一次性角色 agent + 心跳看门狗。
+ *  - failed 且 attempts<maxRetries 的任务重派（claim→running，AgentRunner resume 同一会话）；
  *        attempts≥maxRetries 熔断 blocked(gave_up)。
- *  - B6：lastSeq 持久化，重启后仅唤醒 lastSeq 之后的事件。
- *  - R5：inFlight 互斥，防止慢 tick 与下一轮并发重复派发同一任务。 */
+ *  - lastSeq 持久化，重启后仅唤醒 lastSeq 之后的事件。
+ *  - inFlight 互斥，防止慢 tick 与下一轮并发重复派发同一任务。 */
 export class Dispatcher {
     kanban;
     runner;
@@ -103,10 +103,10 @@ export class Dispatcher {
     maxRetries;
     stateFile;
     logFile;
-    agents; // Fix round 1：宿主 agents 注册表（热重载豁免判据）
+    agents; // 宿主 agents 注册表（热重载豁免判据）
     stallProbe;
     lastSeq = null; // null=尚未加载（首轮 tick 从状态文件/事件日志尾行恢复）
-    orphanReconciled = false; // 启动 reconcile（G）一次性闸：仅首轮 tick 执行孤儿收敛
+    orphanReconciled = false; // 启动 reconcile 一次性闸：仅首轮 tick 执行孤儿收敛
     inFlight = false;
     stallState = new Map();
     timer = null;
@@ -124,14 +124,14 @@ export class Dispatcher {
     async ensureLastSeq(state) {
         if (this.lastSeq !== null)
             return;
-        // 修复轮 6：无状态文件（首次启动）时从 -1 起处理全部事件，避免跳过已存在的
-        // chain/created / spec-card/approved 等可唤醒事件导致 V 永不建卡（B6 回归）。
-        // 重放安全：VOrchestrator.wakeV 的 B6 幂等（已有匹配卡则跳过）保证不重复建卡。
+        // 无状态文件（首次启动）时从 -1 起处理全部事件，避免跳过已存在的
+        // chain/created / spec-card/approved 等可唤醒事件导致 V 永不建卡。
+        // 重放安全：VOrchestrator.wakeV 的幂等（已有匹配卡则跳过）保证不重复建卡。
         let loaded = loadLastSeq(this.stateFile) ?? -1;
         // 游标自愈：purge/renumber（整链硬删除物理重排 events.jsonl seq）或外部修复会把
         // 新事件 seq 压到旧游标之下，若不钳回，spec-card/approved 等可唤醒事件将被永久
         // 跳过 → V 永不建卡（2026-09-02 实测事故）。游标超前即视为状态文件失效，回退
-        // 全量重放；重复唤醒由 wakeV B6 幂等与 done 卡不可变兜底。
+        // 全量重放；重复唤醒由 wakeV 幂等与 done 卡不可变兜底。
         const maxSeq = state.events.length > 0 ? state.events[state.events.length - 1].seq : -1;
         if (loaded > maxSeq) {
             logToFile(this.logFile, '[tick] lastSeq=' + loaded + ' > maxSeq=' + maxSeq + ' (post-purge cursor skew) → rewind to -1 and replay');
@@ -142,12 +142,12 @@ export class Dispatcher {
     }
     async tick() {
         if (this.inFlight)
-            return; // R5：防重叠 tick 并发派发同一任务
+            return; // 防重叠 tick 并发派发同一任务
         this.inFlight = true;
         try {
             const state = await this.kanban.snapshot();
             await this.ensureLastSeq(state);
-            // 启动 reconcile（G）：仅首轮执行，位置在游标自愈之后、正常事件消费之前——
+            // 启动 reconcile：仅首轮执行，位置在游标自愈之后、正常事件消费之前——
             // 游标 rewind 可能全量重放旧事件，必须先把上次进程遗留的 running 孤儿卡收敛为 blocked，
             // 消除「进程重启 → whenIdle 协程死亡 → 卡 running 悬挂到看门狗 4h」的口子。
             if (!this.orphanReconciled) {
@@ -176,11 +176,11 @@ export class Dispatcher {
                     await this.runner.runTask(t.id);
                 }
                 else if (t.status === 'failed' && t.attempts < this.maxRetries) {
-                    // B1：failed 重派——AgentRunner 内 claim→running + resume 同一会话
+                    // failed 重派——AgentRunner 内 claim→running + resume 同一会话
                     await this.runner.runTask(t.id);
                 }
                 else if (t.status === 'failed') {
-                    // B1：attempts≥maxRetries 熔断 blocked(gave_up)，人工介入
+                    // attempts≥maxRetries 熔断 blocked(gave_up)，人工介入
                     await this.kanban.blockTask(t.id, 'gave_up: max retries', 'system');
                 }
             }
@@ -282,8 +282,8 @@ export class Dispatcher {
         this.stop();
         this.timer = setInterval(() => { void this.tick(); }, intervalMs);
     }
-    /** 整链硬删除联动（E）：purge 物理重排 events.jsonl seq，游标必须同步钳到当前 maxSeq。
-     *  否则删链后新建链的可唤醒事件（seq < 旧内存游标）被运行中实例永久跳过——A1 仅在启动时自愈，
+    /** 整链硬删除联动：purge 物理重排 events.jsonl seq，游标必须同步钳到当前 maxSeq。
+     *  否则删链后新建链的可唤醒事件（seq < 旧内存游标）被运行中实例永久跳过——启动时自愈，
      *  覆盖不了运行中删链场景（2026-09-02 残留审计结论）。 */
     async onPurge() {
         const state = await this.kanban.snapshot();
@@ -299,10 +299,10 @@ export class Dispatcher {
         }
     }
 }
-/** 调度层装配：事件唤醒 V（R20 逐阶段建卡）+ 每任务一次性角色 agent + 心跳看门狗。
+/** 调度层装配：事件唤醒 V（逐阶段建卡）+ 每任务一次性角色 agent + 心跳看门狗。
  *  仅在 agents 与 kanban 服务同时可用时由插件入口调用（不依赖可能已错过的 ready 事件）。
- *  Task 7：收 ConfigProvider——storageDir 取启动时快照；wiki/模型链经 getEffective() 调用时热读取。 */
-/** 启动 reconcile（F）：剔除事件流中已不存在的链的编排 entry（历史残留/外部 purge）。
+ *  收 ConfigProvider——storageDir 取启动时快照；wiki/模型链经 getEffective() 调用时热读取。 */
+/** 启动 reconcile：剔除事件流中已不存在的链的编排 entry（历史残留/外部 purge）。
  *  原地删除并返回被移除的 chainId 列表（调用方负责持久化与日志）。 */
 export function reconcileOrchestrations(orch, chains) {
     const removed = [...orch.keys()].filter((k) => !chains.has(k));
@@ -310,14 +310,14 @@ export function reconcileOrchestrations(orch, chains) {
         orch.delete(k);
     return removed;
 }
-/** 启动 reconcile（G）：进程重启会杀死 runner 的 whenIdle 协程，上次遗留的 running 卡无人收尾，
+/** 启动 reconcile：进程重启会杀死 runner 的 whenIdle 协程，上次遗留的 running 卡无人收尾，
  *  看门狗默认 4h（staleTimeoutSeconds=14400）才回收——重启后立即把 running 孤儿卡收敛为 blocked
  *  （system comment + blockTask），中断显形且可重派续跑（重派将 resume 同一会话，进度保留）。
  *  状态机注：TaskStatus 无独立 'claimed' 态——claimTask 发 task/claimed 事件后投影即为 running，
  *  扫描 running 即覆盖「claimed 未收尾」；todo/ready/triage 从未派发，done/blocked/failed/archived
- *  已有归属或终态（且 failed 的处置归 B1 重派/熔断管辖），均不动。
- *  Fix round 1（热重载兼容，双重判据）：收敛每张 running 卡前先查宿主 agents 注册表
- *  ctx.get('agents').get('kbn-<taskId>')（session id 构造同 AgentRunner.resumeOrReuse，Task 2 同款探明）。
+ *  已有归属或终态（且 failed 的处置归重派/熔断管辖），均不动。
+ *  热重载兼容，双重判据：收敛每张 running 卡前先查宿主 agents 注册表
+ *  ctx.get('agents').get('kbn-<taskId>')（session id 构造同 AgentRunner.resumeOrReuse）。
  *  两个世界的分野：
  *  - 进程重启：agents 注册表随宿主进程消亡，新进程内 kbn-<taskId> 必然查不到（undefined）
  *    → 会话已死 → 全部收敛，语义与修复前一致；
@@ -382,12 +382,12 @@ export function startDispatcher(ctx, configProvider) {
 }
 /** 调度器装配主体（startDispatcher 的容错包裹内执行，异常落盘不阻断插件加载）。
  *  config = 启动时快照，仅喂静态依赖（EventWaker/Watchdog/maxRetries）；
- *  wiki 与模型链读点走 configProvider.getEffective() 热生效（Task 7）。 */
+ *  wiki 与模型链读点走 configProvider.getEffective() 热生效。 */
 function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider, agents) {
     const config = configProvider.getEffective();
     const kanban = provider.service;
-    // D2 双模式：local 走 LocalWikiClient（互链读写落本地库），remote 用配置的 WikiVaultClient（Task 10 同款分支）。
-    // 消费方（AgentRunner/VOrchestrator）字段仍标 WikiVaultClient——local 为 LocalWikiClient（read/write/search 同面），Task 10 同款断言。
+    // 双模式：local 走 LocalWikiClient（互链读写落本地库），remote 用配置的 WikiVaultClient（同款分支）。
+    // 消费方（AgentRunner/VOrchestrator）字段仍标 WikiVaultClient——local 为 LocalWikiClient（read/write/search 同面），同款断言。
     const wiki = (configProvider.mode === 'local'
         ? new LocalWikiClient(ensureLocalKbRoot())
         : new WikiVaultClient(() => configProvider.getEffective().wikiVault));
@@ -408,7 +408,7 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
         catch { /* 忽略写失败 */ }
     };
     const vOrch = new VOrchestrator(ctx, kanban, agents, configProvider, orchestrations, wiki, defaultModel);
-    // D23：链完成验收核对（重）——Chain(completed) 时核对主会话是否越权写工作区产物；
+    // 链完成验收核对——Chain(completed) 时核对主会话是否越权写工作区产物；
     // 发现越权 → chain/audit-warning，阻塞最终汇报直至用户 GUI 确认（chain/audit-confirmed）。
     const auditor = new ChainAuditor({
         kanban,
@@ -416,7 +416,7 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
         listLiveAgents: () => (ctx.get('agents')?.list?.() ?? []),
     });
     kanban.setOnChainCompleted(async (chainId) => {
-        // 修复轮 7：传入本链发起工作区（Chain.workspaceDir），审计仅扫描该工作区内的会话，排除其他项目主会话
+        // 传入本链发起工作区（Chain.workspaceDir），审计仅扫描该工作区内的会话，排除其他项目主会话
         const chainState = await kanban.snapshot();
         const workspaceDir = chainState.chains.get(chainId)?.workspaceDir ?? null;
         const evidence = await auditor.check(chainId, workspaceDir);
@@ -424,7 +424,7 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
             console.warn('[dsh-swarm] chain audit warning: ' + chainId + ' evidence=' + evidence.length);
             await kanban.auditWarning(chainId, evidence, 'system');
         }
-        // 合入门控（architecture-review 建议1）：DT 通过后由 system 合入 TARGET_BRANCH；D 不再提前 merge/push。
+        // 合入门控：DT 通过后由 system 合入 TARGET_BRANCH；D 不再提前 merge/push。
         // 解析失败软跳过（[merge-skip]），合入失败记录 [merge-failed]，均不阻断收尾（坏代码未被合入 = 方向安全）。
         try {
             const r = await mergeDAfterReview(kanban, chainId, storageDir);
@@ -436,7 +436,7 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
             logToFile(logFile, '[merge-gate] error chain=' + chainId + ' ' + String(err));
         }
     });
-    // Q3&5：W2/W3(w:kb) 完成 → 机械互链登记（清单页 ↔ 计划页 ↔ 结果页）。
+    // W2/W3(w:kb) 完成 → 机械互链登记（清单页 ↔ 计划页 ↔ 结果页）。
     // syncKbLinks 内部对 wiki 读写全容错，失败不阻塞完成；钩子本身再包一层 try（防御未来改动抛错）。
     kanban.setOnTaskCompleted(async (taskId) => {
         try {
@@ -448,9 +448,9 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
         }
     });
     const waker = new EventWaker(ctx, config);
-    vOrch.onOrchChange = saveOrchs; // Fix D：stall re-wake 路径绕过 EventWaker，orch 变化自行落盘
+    vOrch.onOrchChange = saveOrchs; // stall re-wake 路径绕过 EventWaker，orch 变化自行落盘
     waker.setWakeImpl(makeWakeImpl(vOrch.wakeV.bind(vOrch), logFile, saveOrchs));
-    // 0.1.0 delegation（spec FR2）：全局子代理写护栏——普通插件 ctx 上注册的 guard 全局
+    // 0.1.0 delegation：全局子代理写护栏——普通插件 ctx 上注册的 guard 全局
     // 生效（dsh-tools：普通上下文守卫全局生效，agent.ctx 守卫仅对该 agent 生效）。
     // guard 内部仅对 kanban-dt 系会话收紧；DT 父会话自身仍由 agent-runner 的 agent.ctx
     // guard 双保险。dispose 时注销。
@@ -459,8 +459,24 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
     if (unguardSubagents) {
         ctx.on('dispose', unguardSubagents);
     }
+    // 蜂群模式硬闸：header.agentPreset==='swarm' 时只读+git 反选拦截；
+    // 内部对其余会话恒放行。dispose 时注销（与 subagent guard 同款）。
+    const unguardSwarm = toolsSvc?.guard?.(buildSwarmSessionGuard());
+    if (unguardSwarm) {
+        ctx.on('dispose', unguardSwarm);
+    }
+    // 独立评审硬闸：header.agentPreset==='kanban-dt' 且未经角色组合（session id 非 kbn-
+    // 前缀）时收紧（看板写工具拒、bash/run_code 仅只读 git+clone/fetch、wiki_write 仅
+    // reviews 命名空间）；wiki_write 对非评审会话全局收紧（链上组合会话放行）。dispose
+    // 时注销（与 subagent/swarm guard 同款）。
+    const unguardStandalone = toolsSvc?.guard?.(buildStandaloneDtGuard());
+    if (unguardStandalone) {
+        ctx.on('dispose', unguardStandalone);
+    }
+    // 独立评审工具全局注册：ocr_review + wiki 三原语（wiki_write 会话级收紧由上 guard 完成）。
+    registerStandaloneReviewerTools(ctx, configProvider);
     const runner = new AgentRunner(ctx, kanban, configProvider, wiki, defaultModel);
-    provider.runner = runner; // T32 fix：HTTP retry 复用同一执行器（failed→claim→spawn/resume）
+    provider.runner = runner; // HTTP retry 复用同一执行器（failed→claim→spawn/resume）
     const watchdog = new Watchdog(kanban, config.dispatcher);
     const dispatcher = new Dispatcher({
         kanban,
@@ -468,9 +484,9 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
         waker,
         watchdog,
         maxRetries: config.dispatcher.maxRetries,
-        stateFile: join(dirname(orchFile), 'dispatcher-state.json'), // 与事件日志同目录（B6）
+        stateFile: join(dirname(orchFile), 'dispatcher-state.json'), // 与事件日志同目录
         logFile,
-        agents, // Fix round 1：启动 reconcile 热重载豁免判据（宿主 agents 注册表）
+        agents, // 启动 reconcile 热重载豁免判据（宿主 agents 注册表）
         stallProbe: vOrch, // 防线①：链级停滞探针（orchestrationOf/isWakeInFlight/wake）
     });
     ctx.on('dispose', () => { dispatcher.stop(); watchdog.stop(); vOrch.dispose(); });
@@ -478,7 +494,7 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
     watchdog.start(config.dispatcher.heartbeatIntervalSeconds * 1000);
     logToFile(logFile, '[startDispatcher] dispatcher started (tick=2000ms)');
     void dispatcher.tick();
-    // 整链硬删除联动（E/F/G-min）：purge 物理重排事件 seq → 游标同步钳回（运行中实例不重启发跳过）；
+    // 整链硬删除联动：purge 物理重排事件 seq → 游标同步钳回（运行中实例不重启发跳过）；
     // V 编排 entry 同步剔除。kanban-http 的 delete 分支调用 provider.onChainDeleted。
     provider.onChainDeleted = async (chainId) => {
         await dispatcher.onPurge();
@@ -486,7 +502,7 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
         saveOrchs();
         logToFile(logFile, '[chain-deleted] cursor synced + orch entry removed chain=' + chainId);
     };
-    // 启动 reconcile（F）：历史残留/外部 purge 留下的死链编排 entry，按事件流存活链剔除
+    // 启动 reconcile：历史残留/外部 purge 留下的死链编排 entry，按事件流存活链剔除
     void (async () => {
         try {
             const snap = await kanban.snapshot();

package/lib/dispatcher/event-waker.d.ts

@@ -6,7 +6,7 @@ export declare class EventWaker {
     private inFlight;
     private wakeImpl;
     constructor(_ctx: unknown, _config: KanbanConfig);
-    /** 注入真实唤醒实现（T11.5：VOrchestrator.wakeV——创建/恢复 V 编排 agent 会话，按 R20 阶段序列建卡）。 */
+    /** 注入真实唤醒实现（VOrchestrator.wakeV——创建/恢复 V 编排 agent 会话，按阶段序列建卡）。 */
     setWakeImpl(impl: WakeImpl): void;
     onEvent(ev: KanbanEvent): Promise<void>;
 }

package/lib/dispatcher/event-waker.js

@@ -3,10 +3,10 @@ export class EventWaker {
     inFlight = new Set();
     wakeImpl = async () => { };
     constructor(_ctx, _config) { }
-    /** 注入真实唤醒实现（T11.5：VOrchestrator.wakeV——创建/恢复 V 编排 agent 会话，按 R20 阶段序列建卡）。 */
+    /** 注入真实唤醒实现（VOrchestrator.wakeV——创建/恢复 V 编排 agent 会话，按阶段序列建卡）。 */
     setWakeImpl(impl) { this.wakeImpl = impl; }
     async onEvent(ev) {
-        // v2：V 仅在规格卡批准后（spec-card/approved）或任务完成/阻塞（驱动阶段推进）时唤醒；
+        // V 仅在规格卡批准后（spec-card/approved）或任务完成/阻塞（驱动阶段推进）时唤醒；
         // chain/created 不再唤醒 V（V 不再处理旧 w1 预取阶段，等 /openspec: 建卡 + 批准后再行动）。
         const wakeable = (ev.kind === 'task/completed' || ev.kind === 'task/blocked' || ev.kind === 'spec-card/approved');
         if (!wakeable)

package/lib/dispatcher/git-credentials.d.ts

@@ -1,5 +1,5 @@
 /**
- * R20 D(execute) git 凭据注入（M4）：使 D 会话的 git ls-remote/push 可用。
+ * D(execute) git 凭据注入：使 D 会话的 git ls-remote/push 可用。
  *
  * 机制：D 会话的 bash 每次调用都是新 shell（无环境持久），故 env 变量不可跨调用。
  * 采用 repo-local http extraheader（AUTHORIZATION: basic），写入 <repo>/.git/config——
@@ -8,7 +8,7 @@
  * 鉴权按托管方区分：
  * - GitLab PAT（glpat- 前缀）→ basic base64("oauth2:<PAT>")（GitLab 规范，实测 ls-remote 通过）；
  * - 其余（GitHub 等）→ basic base64("x-access-token:<PAT>")。
- * D 会话为 danger-full-access（用户决策 Q4），HOME 可写，故 git 的 credential.helper
+ * D 会话为 danger-full-access（用户决策），HOME 可写，故 git 的 credential.helper
  * （store/osxkeychain 等）不再触发 "credential storage lock"，无需中和。
  *
  * PAT 来源（按优先级）：DSH 凭据服务 ctx.credentials（$DSH_HOME/.credentials.yaml 的

package/lib/dispatcher/git-credentials.js

@@ -1,7 +1,7 @@
 // src/dispatcher/git-credentials.ts
 import { execFileSync } from 'node:child_process';
 /**
- * R20 D(execute) git 凭据注入（M4）：使 D 会话的 git ls-remote/push 可用。
+ * D(execute) git 凭据注入：使 D 会话的 git ls-remote/push 可用。
  *
  * 机制：D 会话的 bash 每次调用都是新 shell（无环境持久），故 env 变量不可跨调用。
  * 采用 repo-local http extraheader（AUTHORIZATION: basic），写入 <repo>/.git/config——
@@ -10,7 +10,7 @@ import { execFileSync } from 'node:child_process';
  * 鉴权按托管方区分：
  * - GitLab PAT（glpat- 前缀）→ basic base64("oauth2:<PAT>")（GitLab 规范，实测 ls-remote 通过）；
  * - 其余（GitHub 等）→ basic base64("x-access-token:<PAT>")。
- * D 会话为 danger-full-access（用户决策 Q4），HOME 可写，故 git 的 credential.helper
+ * D 会话为 danger-full-access（用户决策），HOME 可写，故 git 的 credential.helper
  * （store/osxkeychain 等）不再触发 "credential storage lock"，无需中和。
  *
  * PAT 来源（按优先级）：DSH 凭据服务 ctx.credentials（$DSH_HOME/.credentials.yaml 的

package/lib/dispatcher/model-candidates.d.ts

@@ -2,7 +2,7 @@ import type { KanbanConfig } from '../config.js';
 import type { Role } from '../domain/types.js';
 import type { AgentModelOptions } from './dispatcher.js';
 /**
- * 模型候选链（交付质量链 Task 12）：角色创建时主模型 → fallbacks 依次静默切换。
+ * 模型候选链：角色创建时主模型 → fallbacks 依次静默切换。
  * primary = config.roles.models[role]；未配置回退 defaultModel。
  * reasoningEffort 未指定一律 'high'。
  *

package/lib/dispatcher/model-candidates.js

@@ -1,5 +1,5 @@
 /**
- * 模型候选链（交付质量链 Task 12）：角色创建时主模型 → fallbacks 依次静默切换。
+ * 模型候选链：角色创建时主模型 → fallbacks 依次静默切换。
  * primary = config.roles.models[role]；未配置回退 defaultModel。
  * reasoningEffort 未指定一律 'high'。
  *

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

@@ -1,5 +1,5 @@
 /**
- * 会话事件条目统一读取助手（修复轮 6，举一反三）：
+ * 会话事件条目统一读取助手：
  * 0.1.2（DSH-0.1.2-A4-03）起 Session.events getter 已移除——宿主新读取面是
  * `session.seq`（日志长度）+ `session.snapshotEvents(fromSeq?, toSeqExclusive?)`。
  * 事件条目形态（落盘与快照一致）为 { type, seq, time, data: { ... } }（append 时

package/lib/dispatcher/session-events.js

@@ -1,6 +1,6 @@
 // src/dispatcher/session-events.ts
 /**
- * 会话事件条目统一读取助手（修复轮 6，举一反三）：
+ * 会话事件条目统一读取助手：
  * 0.1.2（DSH-0.1.2-A4-03）起 Session.events getter 已移除——宿主新读取面是
  * `session.seq`（日志长度）+ `session.snapshotEvents(fromSeq?, toSeqExclusive?)`。
  * 事件条目形态（落盘与快照一致）为 { type, seq, time, data: { ... } }（append 时

package/lib/dispatcher/target-repo.d.ts

@@ -1,6 +1,6 @@
 import type { BoardState, Task } from '../domain/types.js';
 /**
- * R20 D(execute) 目标仓库路径解析（B2/B3 共用）：
+ * D(execute) 目标仓库路径解析：
  * 1. 任务 body 的 TARGET_REPO=<path> 标记（V 生成 D 任务体时写入，见 v-orchestrator D 阶段指令）；
  * 2. 规格卡 file-prefetch 附件 ref（需求澄清清单 manifest 的仓库路径）；
  * 3. 回退默认目录（kanban 存储 / 会话工作区）。
@@ -10,6 +10,6 @@ import type { BoardState, Task } from '../domain/types.js';
  * 存在性校验同时兜底沙箱根：workspace-write 以会话 cwd 为写边界，指向不存在的
  * 目录会导致所有写被拒，故不存在时回退而非保留。
  */
-/** 判断 child 是否位于 parent 目录内（含等于）。用于 D 目标仓库是否在会话工作空间内的判定（B 前置授权）。 */
+/** 判断 child 是否位于 parent 目录内（含等于）。用于 D 目标仓库是否在会话工作空间内的判定（前置授权）。 */
 export declare function isPathInside(child: string, parent: string): boolean;
 export declare function resolveTargetRepoDir(task: Task, state: BoardState, fallback: string, allowFallback?: boolean): string;

package/lib/dispatcher/target-repo.js

@@ -2,7 +2,7 @@
 import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 /**
- * R20 D(execute) 目标仓库路径解析（B2/B3 共用）：
+ * D(execute) 目标仓库路径解析：
  * 1. 任务 body 的 TARGET_REPO=<path> 标记（V 生成 D 任务体时写入，见 v-orchestrator D 阶段指令）；
  * 2. 规格卡 file-prefetch 附件 ref（需求澄清清单 manifest 的仓库路径）；
  * 3. 回退默认目录（kanban 存储 / 会话工作区）。
@@ -12,7 +12,7 @@ import { resolve } from 'node:path';
  * 存在性校验同时兜底沙箱根：workspace-write 以会话 cwd 为写边界，指向不存在的
  * 目录会导致所有写被拒，故不存在时回退而非保留。
  */
-/** 判断 child 是否位于 parent 目录内（含等于）。用于 D 目标仓库是否在会话工作空间内的判定（B 前置授权）。 */
+/** 判断 child 是否位于 parent 目录内（含等于）。用于 D 目标仓库是否在会话工作空间内的判定（前置授权）。 */
 export function isPathInside(child, parent) {
     const c = resolve(child);
     const p = resolve(parent);
@@ -37,6 +37,6 @@ export function resolveTargetRepoDir(task, state, fallback, allowFallback = true
             return abs;
     }
     // allowFallback=false（合入门控用）：不降级到回退目录——合入必须落在显式声明的目标仓库，
-    // 禁止 merge 到 kanban 存储/会话工作区等回退目录（M1，方向安全）。
+    // 禁止 merge 到 kanban 存储/会话工作区等回退目录（方向安全）。
     return allowFallback ? resolve(fallback) : '';
 }

package/lib/dispatcher/v-orchestrator.d.ts

@@ -18,11 +18,11 @@ export declare const R20_PHASE_EXPECT: Record<VPhase, {
     assignee: Role;
     mode: TaskMode;
 } | null>;
-/** M5：每阶段建卡的 body 生成指令（角色定位确定性模板，消除 V 自由发挥导致的角色漂移）。
+/** 每阶段建卡的 body 生成指令（角色定位确定性模板，消除 V 自由发挥导致的角色漂移）。
  *  P=计划者（绝不执行）、D=唯一执行者（TARGET_REPO 必须取自规格卡 file-prefetch 附件 ref，禁止回退/猜测）、
  *  W=KB 同步（绝不执行代码）。V 把对应模板写入 kanban_create 的 body。 */
 export declare const PHASE_INSTRUCTIONS: Partial<Record<VPhase, string>>;
-/** D9（W 角色知识库双模式）：按 kbMode 构建各阶段建卡 body 指令（phase 键控——W2/W3 同为
+/** W 角色知识库双模式：按 kbMode 构建各阶段建卡 body 指令（phase 键控——W2/W3 同为
  *  assignee='w'+mode='kb'，assignee+mode 签名无法区分两相文案；系统状态本就按 phase 键控）。
  *  remote → PHASE_INSTRUCTIONS 原文（护栏测试零改动前提）；local → 覆盖 w2/w3/d/dt 四相
  *  （skill 工具加载 llm-wiki + 本地库 fs 读写，禁 wiki_write/wiki_read），p/pt/summary 原样回落。
@@ -67,22 +67,22 @@ export declare class VOrchestrator {
         }>;
     }, configProvider: ConfigProvider, orchestrations: Map<string, ChainOrchestration>, wiki: WikiVaultClient, defaultModel?: AgentModelOptions);
     private currentPhase;
-    /** Fix D：stall 自动再唤醒上限（同一阶段连续零产出 → 自动重试 ≤3 次，间隔递增）后放弃并显形。 */
+    /** stall 自动再唤醒上限（同一阶段连续零产出 → 自动重试 ≤3 次，间隔递增）后放弃并显形。 */
     private static readonly STALL_REWAKE_LIMIT;
-    /** Fix D：stall 再唤醒基础延迟（按 stallCount 倍增：5s/10s/15s），给瞬时故障/采样波动恢复窗口。 */
+    /** stall 再唤醒基础延迟（按 stallCount 倍增：5s/10s/15s），给瞬时故障/采样波动恢复窗口。 */
     private static readonly STALL_REWAKE_DELAY_MS;
     private rewakeTimers;
     /** 同链 wakeV 并发防护：在途时后续唤醒合并为 pending，完成后补跑一次（事件不丢）。 */
     private waking;
     private pendingWake;
-    /** Fix D：orchestration 变更回调（dispatcher 注入 saveOrchs）——stall re-wake 路径绕过
+    /** orchestration 变更回调（dispatcher 注入 saveOrchs）——stall re-wake 路径绕过
      *  EventWaker，其 stallCount/phase 变化需自行落盘，防重启丢重试进度。 */
     onOrchChange?: () => void;
     wakeV(chainId: string): Promise<void>;
-    /** Fix D：stall 自动再唤醒（≤3 次）。同链 pending 幂等；建卡成功（stallCount=0）后到期的
+    /** stall 自动再唤醒（≤3 次）。同链 pending 幂等；建卡成功（stallCount=0）后到期的
      *  re-wake 自动作废（回调内按 stallCount 判空跳过）。 */
     private scheduleRewake;
-    /** Fix D：清理待触发的 re-wake 定时器（插件 dispose 时调用）。 */
+    /** 清理待触发的 re-wake 定时器（插件 dispose 时调用）。 */
     dispose(): void;
     /** 链级看门狗（Dispatcher，防线①）探针：编排 entry；无 entry 返回 null。 */
     orchestrationOf(chainId: string): ChainOrchestration | null;
@@ -101,7 +101,7 @@ export declare class VOrchestrator {
     private handleReviewCompletion;
     private advance;
     private getVAgent;
-    /** M2(Q5)+归组：链的 workspaceDir（发起 /plan: 的主 agent 工作空间）；缺失返回 null（调用方询问/报错，不落 kanban 存储）。 */
+    /** 归组：链的 workspaceDir（发起 /plan: 的主 agent 工作空间）；缺失返回 null（调用方询问/报错，不落 kanban 存储）。 */
     private chainWorkspace;
 }
 export {};