@joekytc/dsh-swarm 0.3.6 → 0.3.7

package/lib/config.d.ts

@@ -80,5 +80,11 @@ export interface KanbanConfig {
             model: string;
         };
     };
+    /** wiki_write 会话级放行的 preset id 白名单（buildStandaloneDtGuard 非独立分支热读）。
+     *  默认：插件自有 'swarm'（蜂群 preset）/'kanban-w'（W preset）+ 宿主内置 'ptc'
+     *  （2026-09-16 实测：dsh web「蜂群模式」标签会话的 header.agentPreset 实际为宿主
+     *  PTC 模式 id）。宿主 preset 体系演化/部署自定义模式 id 时改配置即可，无需改代码。
+     *  写面仍由 wiki_write 工具内 assertAllowedWikiPagePath 五类命名空间白名单硬约束。 */
+    wikiWritePresets: string[];
 }
 export declare const Config: Schema<KanbanConfig>;

package/lib/config.js

@@ -71,4 +71,5 @@ export const Config = Schema.object({
             model: Schema.string().default(''),
         }),
     }).default({ mode: 'delegate', managed: { provider: '', model: '' } }),
+    wikiWritePresets: Schema.array(Schema.string()).default(['swarm', 'kanban-w', 'ptc']),
 });

package/lib/dispatcher/dispatcher.js

@@ -467,9 +467,13 @@ function startDispatcherInner(ctx, configProvider, storageDir, logFile, provider
     }
     // 独立评审硬闸：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());
+    // reviews 命名空间）；wiki_write 对非评审会话全局收紧（链上组合会话/swarm 主会话/
+    // W preset 会话放行）。dispose 时注销（与 subagent/swarm guard 同款）。
+    const unguardStandalone = toolsSvc?.guard?.(buildStandaloneDtGuard({
+        // wiki_write 放行白名单热读配置（applyOverride 后下次工具调用即生效）；
+        // config 缺字段回 [] fail-closed（默认值由 config.ts schema 保证存在）。
+        getWikiWritePresets: () => configProvider.getEffective().wikiWritePresets ?? [],
+    }));
     if (unguardStandalone) {
         ctx.on('dispose', unguardStandalone);
     }

package/lib/roles/toolsets.d.ts

@@ -96,10 +96,21 @@ export declare function buildSwarmSessionGuard(): (execution: {
  *     落盘是 git 自身行为，BASH_WRITE_RE 无此二动词天然放行，无需特判）；
  *  3. wiki_write（独立模式）→ 仅放行 projects/<repo>/reviews/<主题>-<日期>/ 命名空间；
  *  4. wiki_write（非独立会话）→ 链上组合会话（isRoleComposed）放行（自有 agent-scope
- *     guard 管，链命名空间写入绝不被本 guard 误拦）；其余（main/swarm/未知 GUI）拒绝
- *     ——评审工具全局注册后 wiki_write 收紧到评审会话；
+ *     guard 管，链命名空间写入绝不被本 guard 误拦）；swarm 主会话与 W preset 会话放行
+ *     （2026-09-16 放宽，写面由工具内路径白名单约束）；其余（main/未知 GUI）拒绝
+ *     ——评审工具全局注册后 wiki_write 收紧到评审/知识会话；
  *  5. 其余工具（read/glob/grep/ocr_review/wiki_read/wiki_search 等）→ 放行。 */
-export declare function buildStandaloneDtGuard(): (execution: {
+/** wiki_write 会话级放行 preset 默认白名单：与 config.ts wikiWritePresets 默认值同源，
+ *  仅供 guard deps 未接线（测试/裸调用）时兜底；生产经 dispatcher 注入热读配置。
+ *  'ptc'（2026-09-16 实测）：dsh web「蜂群模式」标签会话的 header.agentPreset 实际为
+ *  宿主内置 PTC 模式 id 'ptc'（presets/ptc，非插件 'swarm'）——UI 标签与 header id 不同源。 */
+export declare const DEFAULT_WIKI_WRITE_PRESETS: ReadonlyArray<string>;
+export interface StandaloneDtGuardDeps {
+    /** wiki_write 放行 preset 白名单热读（dispatcher 注入 () => getEffective().wikiWritePresets；
+     *  缺省回落 DEFAULT_WIKI_WRITE_PRESETS——测试与未接线场景保持默认行为）。 */
+    getWikiWritePresets?: () => ReadonlyArray<string>;
+}
+export declare function buildStandaloneDtGuard(deps?: StandaloneDtGuardDeps): (execution: {
     name?: string;
     arguments?: unknown;
     agent?: unknown;
@@ -107,7 +118,8 @@ export declare function buildStandaloneDtGuard(): (execution: {
 /** 独立评审工具全局注册：ocr_review + wiki 三原语（wiki_read/wiki_search/wiki_write）。
  *  独立评审不经 agent-runner 角色组合，角色工具面不存在，故在插件全局 ctx 注册；
  *  caller 固定 actor='dt'（can('wiki-write','dt')=true），wiki_write 的会话级收紧由
- *  buildStandaloneDtGuard 完成（链上组合会话放行，main/swarm/未知 GUI 拒绝）。
+ *  buildStandaloneDtGuard 完成（链上组合会话/swarm 主会话/W preset 会话放行，
+ *  main/未知 GUI 拒绝）。
  *  wiki 客户端按 kbMode 构造（与 registerMainSessionTools 同源：remote 优先 ctx.get('wiki')
  *  注入（测试 mock），生产热读取 getEffective().wikiVault；local 走 LocalWikiClient）。
  *  local 模式不注册 wiki_write：LocalWikiClient.abs 只接受 wiki/** 形态，而 wiki_write

package/lib/roles/toolsets.js

@@ -581,10 +581,16 @@ function dualVerbGitDenyReason(verb, rest, deny) {
  *     落盘是 git 自身行为，BASH_WRITE_RE 无此二动词天然放行，无需特判）；
  *  3. wiki_write（独立模式）→ 仅放行 projects/<repo>/reviews/<主题>-<日期>/ 命名空间；
  *  4. wiki_write（非独立会话）→ 链上组合会话（isRoleComposed）放行（自有 agent-scope
- *     guard 管，链命名空间写入绝不被本 guard 误拦）；其余（main/swarm/未知 GUI）拒绝
- *     ——评审工具全局注册后 wiki_write 收紧到评审会话；
+ *     guard 管，链命名空间写入绝不被本 guard 误拦）；swarm 主会话与 W preset 会话放行
+ *     （2026-09-16 放宽，写面由工具内路径白名单约束）；其余（main/未知 GUI）拒绝
+ *     ——评审工具全局注册后 wiki_write 收紧到评审/知识会话；
  *  5. 其余工具（read/glob/grep/ocr_review/wiki_read/wiki_search 等）→ 放行。 */
-export function buildStandaloneDtGuard() {
+/** wiki_write 会话级放行 preset 默认白名单：与 config.ts wikiWritePresets 默认值同源，
+ *  仅供 guard deps 未接线（测试/裸调用）时兜底；生产经 dispatcher 注入热读配置。
+ *  'ptc'（2026-09-16 实测）：dsh web「蜂群模式」标签会话的 header.agentPreset 实际为
+ *  宿主内置 PTC 模式 id 'ptc'（presets/ptc，非插件 'swarm'）——UI 标签与 header id 不同源。 */
+export const DEFAULT_WIKI_WRITE_PRESETS = ['swarm', 'kanban-w', 'ptc'];
+export function buildStandaloneDtGuard(deps = {}) {
     return (execution) => {
         const header = extractSessionHeader(execution?.agent);
         const name = String(execution?.name ?? '');
@@ -648,7 +654,17 @@ export function buildStandaloneDtGuard() {
         if (name === 'wiki_write') {
             if (isRoleComposed(execution?.agent) || isDtChainSubagent)
                 return undefined;
-            return 'wiki-write-restricted-to-reviewer-sessions: wiki_write 仅限交付评审官（DT）评审会话使用';
+            // 放宽（2026-09-16）：swarm 主会话与 W preset 会话可写 wiki——can('wiki-write') 本就含 w
+            // （permissions.ts），写面由 wiki_write 工具内 assertAllowedWikiPagePath 五类命名空间
+            // 白名单硬约束；local 模式 wiki_write 未全局注册，无工具面即无暴露面。
+            // 放行面配置化（硬规则 6）：白名单经 deps 热读 config.wikiWritePresets，宿主 preset
+            // 体系演化/部署自定义模式 id 时改配置即可；config 缺字段回 []（fail-closed，仅内置默认兜底测试）。
+            const preset = header?.agentPreset;
+            const allowed = deps.getWikiWritePresets?.() ?? DEFAULT_WIKI_WRITE_PRESETS;
+            if (preset !== undefined && allowed.includes(preset))
+                return undefined;
+            // 诊断尾巴：报错带实际 preset（或"无"），用户重试一次即可定位会话模式判定缺口
+            return 'wiki-write-restricted-to-reviewer-sessions: wiki_write 仅限 DT 评审会话 / W 角色 / swarm 主会话使用（当前会话 preset=' + (preset ?? '无') + '）';
         }
         return undefined;
     };
@@ -656,7 +672,8 @@ export function buildStandaloneDtGuard() {
 /** 独立评审工具全局注册：ocr_review + wiki 三原语（wiki_read/wiki_search/wiki_write）。
  *  独立评审不经 agent-runner 角色组合，角色工具面不存在，故在插件全局 ctx 注册；
  *  caller 固定 actor='dt'（can('wiki-write','dt')=true），wiki_write 的会话级收紧由
- *  buildStandaloneDtGuard 完成（链上组合会话放行，main/swarm/未知 GUI 拒绝）。
+ *  buildStandaloneDtGuard 完成（链上组合会话/swarm 主会话/W preset 会话放行，
+ *  main/未知 GUI 拒绝）。
  *  wiki 客户端按 kbMode 构造（与 registerMainSessionTools 同源：remote 优先 ctx.get('wiki')
  *  注入（测试 mock），生产热读取 getEffective().wikiVault；local 走 LocalWikiClient）。
  *  local 模式不注册 wiki_write：LocalWikiClient.abs 只接受 wiki/** 形态，而 wiki_write

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joekytc/dsh-swarm",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "A governed swarm of six specialist DSH agents (orchestrator, planner, knowledge-base bridge, developer and two reviewers) that turns a requirement into a strict phase pipeline with machine-verified delivery evidence, review-gated merges, a full audit-log event stream and a live kanban tab; design inspired by the Hermes Agent kanban",
   "license": "MIT",
   "author": "joekytc",