@ifrankwang/openspec-agents 0.150.0 → 0.150.2

package/.dsh-plugin/opx-tools.mjs

@@ -9033,7 +9033,11 @@ function withAgentArg(parameters) {
 
 // src/adapters/deepseek-harness/plugin.ts
 var Config = z.object({
-  unattended: z.boolean().default(true)
+  unattended: z.boolean().default(true),
+  subagents: z.array(z.object({
+    toolName: z.string(),
+    agentPreset: z.string()
+  })).default([])
 });
 var name = "openspec-opx-tools";
 var inject = ["tools"];
@@ -9051,6 +9055,50 @@ function apply(ctx, config = {}) {
       }
     }));
   }
+  mountSubagentTools(ctx, config.subagents ?? []);
+}
+var SUBAGENT_TOOL_PACKAGE = "@deepseek-ai/dsh-tool-subagent";
+var PRESET_READY_TIMEOUT_MS = 3000;
+var PRESET_READY_POLL_MS = 50;
+async function waitForPreset(registry, presetId, timeoutMs = PRESET_READY_TIMEOUT_MS) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      await registry.readDocument(presetId);
+      return true;
+    } catch {
+      await new Promise((resolve) => setTimeout(resolve, PRESET_READY_POLL_MS));
+    }
+  }
+  return false;
+}
+function mountSubagentTools(ctx, specs) {
+  if (specs.length === 0 || typeof ctx.inject !== "function")
+    return;
+  ctx.inject(["agentPresets"], async (injected) => {
+    let subagentTool;
+    try {
+      subagentTool = await import(SUBAGENT_TOOL_PACKAGE);
+    } catch (error) {
+      injected.logger?.warn?.(`openspec: 无法加载 ${SUBAGENT_TOOL_PACKAGE}，子代理委派工具未挂载：${String(error)}`);
+      return;
+    }
+    for (const spec of specs) {
+      if (!await waitForPreset(injected.agentPresets, spec.agentPreset)) {
+        injected.logger?.warn?.(`openspec: agent preset "${spec.agentPreset}" 未在 ${PRESET_READY_TIMEOUT_MS}ms 内注册，跳过子代理工具 ${spec.toolName}`);
+        continue;
+      }
+      try {
+        await injected.plugin(subagentTool, {
+          provider: "spawn",
+          toolName: spec.toolName,
+          agentPreset: spec.agentPreset
+        });
+      } catch (error) {
+        injected.logger?.warn?.(`openspec: 子代理工具 ${spec.toolName} 挂载失败：${String(error)}`);
+      }
+    }
+  });
 }
 export {
   Config,

package/.mcp-server/cli.mjs

@@ -30629,7 +30629,7 @@ async function ensureDefaultUnattended(args, ctx) {
     }
   } catch {}
 }
-var PKG_VERSION = "0.150.0";
+var PKG_VERSION = "0.150.2";
 function buildMcpServer(worktree, opts = {}) {
   const mcp = new McpServer({ name: "openspec-agents", version: PKG_VERSION });
   for (const [name, spec] of Object.entries(TOOL_SPECS)) {

package/assets/skills/orchestrator/SKILL.md

@@ -45,7 +45,6 @@ capabilities: ["orchestrator"]
 - 每次子代理返回后，调用状态查询工具获取权威「下一步」指令并严格遵循；推进被拦时按工具给出的阻塞原因与修复建议处理，不自行推断其他动作。DSH 形态下「返回」指收到子代理完成通知，不是分派工具的即时返回（见「分派范式」的 DSH 异步委派）
 - 分派/推进决策一律以工具返回为准：工具已给出明确分派指令时直接分派，不得先读状态文件交叉验证；仅门禁拒绝或工具给出修复建议时才读取状态文件核对
 - 分派子代理前先查询状态确认当前阶段/层，确保不跳阶段或错层分派；工具视图呈现 worktree 未就绪时不得分派
-- 不过度沟通：任务组内部不停下来向用户汇报，持续执行直到阻塞或完成
 - 断点续传：子代理因步骤限制中断后重新分派即可继续，无需保存已完成子任务列表
 - 工具列出多个子代理时并排分派（单条消息中同时发送），不串行等待
 - 分派前校验分派 prompt：按「禁止事项」中禁止转述的动态内容清单逐项检查，校验通过后再分派

package/dsh/cordis.patch.yml

@@ -12,6 +12,11 @@
       name: '@ifrankwang/openspec-agents/.dsh-plugin/opx-tools.mjs'
       config:
         unattended: true
+        subagents:
+          - toolName: openspec_developer
+            agentPreset: openspec-developer
+          - toolName: openspec_reviewer
+            agentPreset: openspec-reviewer
     - id: openspec-skills
       name: '@deepseek-ai/dsh-skill-filesystem'
       config:
@@ -105,12 +110,6 @@
                   thresholdChars: 8192
                   headChars: 4096
                   tailChars: 1024
-    - id: openspec-subagent-developer
-      name: '@deepseek-ai/dsh-tool-subagent'
-      config:
-        provider: spawn
-        toolName: openspec_developer
-        agentPreset: openspec-developer
     - id: openspec-preset-reviewer
       name: '@deepseek-ai/dsh-agent-preset'
       config:
@@ -375,10 +374,4 @@
                   thresholdChars: 8192
                   headChars: 4096
                   tailChars: 1024
-    - id: openspec-subagent-reviewer
-      name: '@deepseek-ai/dsh-tool-subagent'
-      config:
-        provider: spawn
-        toolName: openspec_reviewer
-        agentPreset: openspec-reviewer
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifrankwang/openspec-agents",
-  "version": "0.150.0",
+  "version": "0.150.2",
   "description": "OpenSpec companion plugin for AI coding agents (Claude Code, Codex, ZCode, DeepSeek Harness, OpenCode): a stricter proposal standard plus multi-agent implementation and review, gated to production-grade standards",
   "author": "ifrankwang",
   "license": "MIT",

package/src/adapters/deepseek-harness/index.ts

@@ -68,7 +68,14 @@ export const DSH_NATIVE_TOOLS_ROW_ID = "openspec-opx-tools"
  */
 export const DSH_SKILLS_DIR_SEGMENTS = ["assets", "skills"] as const
 
-/** 原生工具插件与 skill 根的基础 patch；子代理工具行由 buildDshPatchContent 动态追加。 */
+/**
+ * 原生工具插件与 skill 根的基础 patch。
+ *
+ * 子代理委派工具**不写成静态 patch 行**：DSH 加载器对同一层的条目并行激活，静态工具行会在
+ * preset 声明行注册完成之前校验 `agentPreset`，报 `Unknown agent preset`。改为把
+ * toolName ↔ preset id 清单放进插件配置，由插件在 preset 就绪后动态挂载委派工具
+ * （见 plugin.ts 的 mountSubagentTools），顺序由代码保证。
+ */
 const DSH_BASE_PATCH_YAML = `# DeepSeek Harness (DSH) bundle patch: expose OpenSpec orchestration tools and skills.
 # The patch is applied as a bundle layer under dsh.profile.bundles.
 # baseUrl 指向 profile 根目录；bundle 安装后位于 profile 的 node_modules 下，
@@ -205,15 +212,25 @@ function dshSubagentPresetPlugins(editAllowed: boolean): Record<string, unknown>
   ]
 }
 
+/** 子代理委派规格：工具名 + 引用的 preset id（写入插件配置，供动态挂载使用）。 */
+export interface DshSubagentSpec {
+  toolName: string
+  agentPreset: string
+}
+
+/** 解析一个子代理的 preset 声明与委派规格。 */
+interface DshSubagentDefinition {
+  spec: DshSubagentSpec
+  presetEntry: DshSubagentEntry
+}
+
 /**
- * 从 assets/agents/*.md 收集 DSH 子代理：每个物理子代理生成一个 Agent Preset 声明行
- * 与一个 `@deepseek-ai/dsh-tool-subagent` 工具行（后者以 `agentPreset` 引用前者）。
- *
- * preset 行必须排在工具行之前：工具行在加载时校验 `agentPreset` 是否已声明。
+ * 从 assets/agents/*.md 收集 DSH 子代理：每个物理子代理生成一个 Agent Preset 声明行，
+ * 以及一份「工具名 + preset id」规格（交给插件动态挂载委派工具）。
  */
-function collectDshSubagentEntries(): DshSubagentEntry[] {
+function collectDshSubagents(): DshSubagentDefinition[] {
   const agentsRoot = resolve("assets", "agents")
-  const entries: DshSubagentEntry[] = []
+  const definitions: DshSubagentDefinition[] = []
   for (const file of readdirSync(agentsRoot)) {
     if (!file.endsWith(".md")) continue
     if (EXCLUDED_AGENTS.has(file)) continue
@@ -224,8 +241,9 @@ function collectDshSubagentEntries(): DshSubagentEntry[] {
     const persona = [DSH_SUBAGENT_TOOL_ACCESS_PREAMBLE, description, body.trim()].filter(Boolean).join("\n\n")
     const suffix = dshAgentSuffix(name)
     const presetId = `openspec-${suffix.replace(/_/g, "-")}`
-    entries.push(
-      {
+    definitions.push({
+      spec: { toolName: `openspec_${suffix}`, agentPreset: presetId },
+      presetEntry: {
         id: `openspec-preset-${suffix}`,
         name: "@deepseek-ai/dsh-agent-preset",
         config: {
@@ -238,30 +256,37 @@ function collectDshSubagentEntries(): DshSubagentEntry[] {
           ],
         },
       },
-      {
-        id: `openspec-subagent-${suffix}`,
-        name: "@deepseek-ai/dsh-tool-subagent",
-        config: {
-          provider: "spawn",
-          toolName: `openspec_${suffix}`,
-          agentPreset: presetId,
-        },
-      },
-    )
+    })
   }
-  return entries
+  return definitions
+}
+
+/** 把子代理规格投影为插件配置里的 `subagents` 块（缩进对齐 openspec-opx-tools 行的 config）。 */
+function subagentsConfigYaml(specs: DshSubagentSpec[]): string {
+  if (specs.length === 0) return "        subagents: []"
+  const dumped = yaml.dump(specs, { lineWidth: -1 }).trimEnd().split("\n")
+  return ["        subagents:", ...dumped.map((line) => `          ${line}`)].join("\n")
+}
+
+/** 基础 patch：原生工具插件行带上子代理委派规格，供插件在 preset 就绪后动态挂载。 */
+function buildBasePatchYaml(specs: DshSubagentSpec[]): string {
+  return DSH_BASE_PATCH_YAML.replace(
+    "        unattended: true",
+    `        unattended: true\n${subagentsConfigYaml(specs)}`,
+  )
 }
 
-/** 生成完整的 DSH cordis patch 内容：基础原生工具插件行 + skill 根 + 每个子代理的 preset 与 subagent 工具。 */
+/** 生成完整的 DSH cordis patch 内容：基础原生工具插件行 + skill 根 + 每个子代理的 preset 声明。 */
 export function buildDshPatchContent(): string {
-  const subagents = collectDshSubagentEntries()
-  if (subagents.length === 0) return DSH_BASE_PATCH_YAML
-  const subagentsYaml = yaml
-    .dump(subagents, { schema: DSH_YAML_SCHEMA, lineWidth: -1 })
+  const definitions = collectDshSubagents()
+  const base = buildBasePatchYaml(definitions.map((definition) => definition.spec))
+  if (definitions.length === 0) return base
+  const presetsYaml = yaml
+    .dump(definitions.map((definition) => definition.presetEntry), { schema: DSH_YAML_SCHEMA, lineWidth: -1 })
     .split("\n")
     .map((line) => (line ? `    ${line}` : line))
     .join("\n")
-  return `${DSH_BASE_PATCH_YAML.trimEnd()}\n${subagentsYaml}\n`
+  return `${base.trimEnd()}\n${presetsYaml}\n`
 }
 
 export type DeepSeekHarnessPluginBuildResult = PluginPackageResult

package/src/adapters/deepseek-harness/plugin.ts

@@ -25,6 +25,19 @@ import { buildNativeToolDefinitions, type DshToolExec } from "./native-tools.ts"
 const Config = z.object({
   /** 默认无人值守：会话已初始化且未显式设置时自动开启。默认 true，与 MCP 侧 --unattended 同口径。 */
   unattended: z.boolean().default(true),
+  /**
+   * 子代理委派规格（工具名 + 引用的 preset id），由构建期写入 patch。
+   * 委派工具不写成静态 patch 行：DSH 加载器并行激活同层条目，静态工具行会在 preset 注册前
+   * 校验 `agentPreset` 报 Unknown agent preset；改由插件在 preset 就绪后动态挂载。
+   */
+  subagents: z
+    .array(
+      z.object({
+        toolName: z.string(),
+        agentPreset: z.string(),
+      }),
+    )
+    .default([]),
 })
 
 /** cordis 插件名。 */
@@ -39,7 +52,10 @@ const inject = ["tools"]
  * worktree 每次调用从 `exec.agent.session.header.cwd` 取会话项目目录（该字段缺失即报错，不静默回落进程 cwd）；
  * `exec.signal` 在每次调用入口检查取消；调用者身份由 `_agent` 入参声明（缺省=编排主代理视角）。
  */
-function apply(ctx: any, config: { unattended?: boolean } = {}): void {
+function apply(
+  ctx: any,
+  config: { unattended?: boolean; subagents?: Array<{ toolName: string; agentPreset: string }> } = {},
+): void {
   const unattended = config.unattended !== false
   // 进程 cwd 仅用于「无 agent 上下文的非 agent 调用」兜底；agent 调用缺会话目录时工具直接报错。
   const processCwd = process.cwd()
@@ -56,6 +72,70 @@ function apply(ctx: any, config: { unattended?: boolean } = {}): void {
       }),
     )
   }
+  mountSubagentTools(ctx, config.subagents ?? [])
+}
+
+/** 子代理委派工具所属的官方包（保持 external，由 DSH 安装目录在运行时解析）。 */
+const SUBAGENT_TOOL_PACKAGE = "@deepseek-ai/dsh-tool-subagent"
+
+/** 等待 preset 声明注册完成的上限：注册在启动阶段完成，正常在毫秒级。 */
+const PRESET_READY_TIMEOUT_MS = 3000
+const PRESET_READY_POLL_MS = 50
+
+/**
+ * 轮询等待 preset 声明注册完成。
+ *
+ * `agentPresets.readDocument(id)` 直接读内存声明表：返回成功即表示 preset 行已激活，
+ * 此时再挂载委派工具，工具行的加载期校验必然通过。
+ */
+async function waitForPreset(registry: any, presetId: string, timeoutMs = PRESET_READY_TIMEOUT_MS): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    try {
+      await registry.readDocument(presetId)
+      return true
+    } catch {
+      await new Promise((resolve) => setTimeout(resolve, PRESET_READY_POLL_MS))
+    }
+  }
+  return false
+}
+
+/**
+ * 在 preset 就绪后动态挂载子代理委派工具。
+ *
+ * 与静态 patch 行的差异只有挂载时机：本函数先等 `agentPresets` 服务可用、再逐个确认 preset
+ * 已注册，最后才挂 `@deepseek-ai/dsh-tool-subagent` 实例——消除「工具行先于 preset 行激活」
+ * 的加载竞态（DSH 对同层条目并行激活，desktop 多插件下稳定触发）。
+ */
+function mountSubagentTools(ctx: any, specs: Array<{ toolName: string; agentPreset: string }>): void {
+  if (specs.length === 0 || typeof ctx.inject !== "function") return
+  ctx.inject(["agentPresets"], async (injected: any) => {
+    let subagentTool: any
+    try {
+      subagentTool = await import(SUBAGENT_TOOL_PACKAGE)
+    } catch (error) {
+      injected.logger?.warn?.(`openspec: 无法加载 ${SUBAGENT_TOOL_PACKAGE}，子代理委派工具未挂载：${String(error)}`)
+      return
+    }
+    for (const spec of specs) {
+      if (!(await waitForPreset(injected.agentPresets, spec.agentPreset))) {
+        injected.logger?.warn?.(
+          `openspec: agent preset "${spec.agentPreset}" 未在 ${PRESET_READY_TIMEOUT_MS}ms 内注册，跳过子代理工具 ${spec.toolName}`,
+        )
+        continue
+      }
+      try {
+        await injected.plugin(subagentTool, {
+          provider: "spawn",
+          toolName: spec.toolName,
+          agentPreset: spec.agentPreset,
+        })
+      } catch (error) {
+        injected.logger?.warn?.(`openspec: 子代理工具 ${spec.toolName} 挂载失败：${String(error)}`)
+      }
+    }
+  })
 }
 
 export { Config, apply, inject, name }

package/src/types/dsh-runtime.d.ts

@@ -154,9 +154,27 @@ declare module "@deepseek-ai/dsh-tools" {
 }
 
 declare module "@deepseek-ai/cordis" {
-  /** 本项目插件只用到 ctx.tools；其余 cordis 服务不消费。 */
+  /** 本项目插件用到的 cordis 能力：工具注册表、依赖注入与子插件挂载；其余服务不消费。 */
   export interface Context {
     tools: import("@deepseek-ai/dsh-tools").ToolRegistry
+    /**
+     * 依赖就绪后执行回调。本插件用它等 `agentPresets` 服务可用，再动态挂载子代理委派工具
+     * （DSH 对同层 patch 条目并行激活，静态工具行会先于 preset 声明校验而失败）。
+     */
+    inject(deps: readonly string[], callback: (ctx: Context) => unknown): unknown
+    /** 挂载子插件。本插件用它挂载官方 `@deepseek-ai/dsh-tool-subagent` 实例。 */
+    plugin(plugin: unknown, config?: unknown): unknown
     [key: string]: any
   }
+}
+
+declare module "@deepseek-ai/dsh-tool-subagent" {
+  /**
+   * 官方子代理委派工具插件（cordis 插件形态：命名导出 name/inject/Config/apply）。
+   * 本插件在 preset 就绪后动态挂载它，故只需声明挂载所需的公开形状。
+   */
+  export const name: string
+  export const inject: readonly string[]
+  export const Config: unknown
+  export function apply(ctx: unknown, config?: unknown): void
 }