@twinsearth/dsh-master 0.0.0-stage → 3.2.9

package/src/kernel.ts

@@ -0,0 +1,190 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+// @ts-nocheck — host JS→TS 迁移阶段：运行时行为优先，类型注解逐步补齐（worker/ 仍严格检查）。
+
+/**
+ * Dsh-Master（房主）共享内核（v3.2.3）。
+ * 只放纯函数与常量；Node 侧工具用到的 crypto 是唯一内置模块依赖。
+ * 与瓮城 dsh-Fang 的协作只走 DSH 服务键，不 import fang 代码。
+ */
+
+import crypto from 'node:crypto'
+
+export const MASTER_VERSION = '3.2.9'
+export const FANG_CONTRACT_MIN = '3.1.14'
+
+export const SERVICE = Object.freeze({
+  master: 'dshMaster',
+  superagentRouter: 'dshMasterSuperagentRouter',
+  superagentWorker: 'dshMasterSuperagentWorker',
+  cost: 'dshMasterCost',
+  dual: 'dshMasterDual',
+})
+
+export const FANG_SERVICE = Object.freeze({
+  orchestrator: 'fang',
+  forker: 'fangForker',
+  decisionCenter: 'fangDecisionCenter',
+  sessionCatalog: 'fangSessionCatalog',
+  sessionBridge: 'fangSessionBridge',
+})
+
+export const ROW = Object.freeze({
+  core: 'master-core',
+  superagentRouter: 'master-superagent-router',
+  superagentWorker: 'master-superagent-worker',
+  superagentLoop: 'master-superagent-loop',
+  cost: 'master-cost-optimizer',
+  dual: 'master-dual-manager',
+})
+
+export const ROLE = Object.freeze({ mother: 'mother', essence: 'essence', fork: 'fork' })
+
+/**
+ * 角色矩阵（v3.2.3）：
+ *   * Router 常驻原身（essence）：只评估/建票/派发，不执行代码；母体不接纳。
+ *   * Worker 是研究原型，只在 fork：编译后的 Worker preset 行 master-superagent-loop 也只 fork。
+ *   * 成本优化 fork；双主管 mother/essence。
+ */
+export const ROLE_MATRIX = Object.freeze({
+  'master-core': Object.freeze(Object.values(ROLE)),
+  'master-superagent-router': Object.freeze([ROLE.essence]),
+  'master-superagent-worker': Object.freeze([ROLE.fork]),
+  'master-superagent-loop': Object.freeze([ROLE.fork]),
+  'master-cost-optimizer': Object.freeze([ROLE.fork]),
+  'master-dual-manager': Object.freeze([ROLE.mother, ROLE.essence]),
+})
+
+export const SUBPLUGIN_CATALOG = Object.freeze([
+  Object.freeze({
+    id: 'superagent-router', row: ROW.superagentRouter, name: '超级智能体 Router', nameEn: 'SuperAgent Router',
+    roles: ROLE_MATRIX[ROW.superagentRouter], roadmap: '3.2.1',
+    description: '常驻原身：Webhook → 评估 → Ticket/Mandate → 派发；不执行代码改动。',
+  }),
+  Object.freeze({
+    id: 'superagent-worker', row: ROW.superagentWorker, name: '超级智能体 Worker', nameEn: 'SuperAgent Worker',
+    roles: ROLE_MATRIX[ROW.superagentWorker], roadmap: '3.2.1',
+    description: '每个工单一个隔离分身：在 Mandate 作用域内执行；研究原型，仅 fork。',
+  }),
+  Object.freeze({
+    id: 'superagent-loop', row: ROW.superagentLoop, name: 'Worker Agent Loop', nameEn: 'SuperAgent Worker Loop',
+    roles: ROLE_MATRIX[ROW.superagentLoop], roadmap: '3.2.3',
+    description: '编译后的 Worker preset：有 Ticket 的 fork 自动跑多轮工具循环并流式回传。',
+  }),
+  Object.freeze({
+    id: 'cost-optimizer', row: ROW.cost, name: '成本优化', nameEn: 'HarnessMM',
+    roles: ROLE_MATRIX[ROW.cost], roadmap: '3.3.0',
+    description: 'HarnessMM observe 层；仅 fork，默认 observe。',
+  }),
+  Object.freeze({
+    id: 'dual-manager', row: ROW.dual, name: '双主管', nameEn: 'PM + PJM',
+    roles: ROLE_MATRIX[ROW.dual], roadmap: '3.4.0',
+    description: 'PM 产 PRD、PJM 调度分身；只允许 mother / essence。',
+  }),
+])
+
+/**
+ * 从环境变量探测当前角色。
+ * 瓮城注入：母体 DSH_FANG_ROLE=mother；元宝运行态 fork+DSH_FANG_ESSENCE=1；
+ * 普通分身 DSH_FANG_ROLE=fork + DSH_FANG_TASK_ID=task_/rt-。
+ */
+export function detectRole(env = process.env) {
+  const raw = String(env?.DSH_FANG_ROLE ?? '').trim().toLowerCase()
+  const taskId = String(env?.DSH_FANG_TASK_ID ?? '')
+  const essence = String(env?.DSH_FANG_ESSENCE ?? '') === '1' || taskId.startsWith('rt-')
+  if (raw === 'mother') return ROLE.mother
+  if (raw === 'fork') return essence ? ROLE.essence : ROLE.fork
+  return essence ? ROLE.essence : ROLE.mother
+}
+
+export function roleAllowed(rowId, role) {
+  const allowed = ROLE_MATRIX[rowId]
+  return Array.isArray(allowed) ? allowed.includes(role) : true
+}
+
+export function enabledOf(config) {
+  return !(config && typeof config === 'object' && config.enabled === false)
+}
+
+export function safeGet(ctx, name) {
+  try {
+    if (!ctx || typeof ctx !== 'object') return null
+    if (typeof ctx.get === 'function') return ctx.get(name) ?? null
+    return ctx[name] ?? null
+  } catch {
+    return null
+  }
+}
+
+export function jsonResponse(res, status, body) {
+  try {
+    if (res && typeof res.statusCode === 'number') res.statusCode = status
+    res?.setHeader?.('content-type', 'application/json; charset=utf-8')
+    res?.setHeader?.('cache-control', 'no-store')
+    res?.end?.(JSON.stringify(body))
+  } catch {
+    /* ignore */
+  }
+}
+
+/** 读取请求 JSON body（大小上限；非法/超限返回 {ok:false,code}）。 */
+export async function readJsonBody(req, limit = 512 * 1024) {
+  try {
+    const chunks = []
+    let total = 0
+    if (req && typeof req[Symbol.asyncIterator] === 'function') {
+      for await (const chunk of req) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk))
+        total += buffer.length
+        if (total > limit) return { ok: false, code: 'body-too-large' }
+        chunks.push(buffer)
+      }
+    } else if (req && typeof req.on === 'function') {
+      await new Promise((resolve, reject) => {
+        req.on('data', (chunk) => {
+          const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk))
+          total += buffer.length
+          if (total > limit) reject(new Error('body-too-large'))
+          else chunks.push(buffer)
+        })
+        req.on('end', resolve)
+        req.on('error', reject)
+      })
+    }
+    const raw = Buffer.concat(chunks).toString('utf8')
+    if (!raw) return { ok: true, body: {} }
+    return { ok: true, body: JSON.parse(raw) }
+  } catch (error) {
+    return { ok: false, code: String(error?.message ?? error) === 'body-too-large' ? 'body-too-large' : 'invalid-json' }
+  }
+}
+
+/** 常量时间比较两个 token（长度不同直接 false）。 */
+export function tokenEquals(received, expected) {
+  const a = Buffer.from(String(received ?? ''), 'utf8')
+  const b = Buffer.from(String(expected ?? ''), 'utf8')
+  if (a.length === 0 || a.length !== b.length) return false
+  return crypto.timingSafeEqual(a, b)
+}
+
+export function bearerOf(headers) {
+  const raw = headers && typeof headers === 'object'
+    ? (headers.authorization ?? headers.Authorization ?? '')
+    : ''
+  const match = /^Bearer\s+(\S+)$/i.exec(String(raw ?? '').trim())
+  return match ? match[1] : ''
+}
+
+export function masterError(code, message, detail) {
+  const out = { ok: false, code: String(code), error: String(message ?? code) }
+  if (detail !== undefined) out.detail = detail
+  return out
+}
+
+export function createIdFactory(prefix) {
+  let seq = 0
+  return () => {
+    seq += 1
+    return `${prefix}_${Date.now().toString(36)}_${seq.toString(36)}`
+  }
+}

package/src/plugins/cost-optimizer.ts

@@ -0,0 +1,155 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+// @ts-nocheck — host JS→TS 迁移阶段：运行时行为优先，类型注解逐步补齐（worker/ 仍严格检查）。
+
+/**
+ * 子插件 2：成本优化（HarnessMM 观察层）—— 为分身装“燃油表”。
+ *
+ * 3.2.0 先交付可观测/可估算的骨架，不做推理拦截：
+ *   * `observe` 模式只统计/估算，不改写任何模型调用；
+ *   * HarnessMM 的 EGD/GDR/CCS 真实接入在 3.3.0 里程碑（见 docs/ROADMAP.md）；
+ *   * 角色：只允许 fork（分身生产盘），母体/元主不加载。
+ */
+
+import {
+  ROW,
+  ROLE,
+  SERVICE,
+  detectRole,
+  enabledOf,
+  masterError,
+  roleAllowed,
+  safeGet,
+} from '../kernel.ts'
+
+export const name = 'dsh-master-cost-optimizer'
+export const inject = ['dshMaster']
+export const ROW_ID = ROW.cost
+
+/** HarnessMM 官方基准（3.2.0 文档引用；3.3.0 接入后应被实测值覆盖）。 */
+export const HARNESSMM_BENCHMARK = Object.freeze({
+  baselineTokens: 96280,
+  optimizedTokens: 11620,
+  savingsRatio: 0.8793,
+  successRate: { baseline: 0.7143, optimized: 0.8571 },
+})
+
+function finiteNonNegative(value) {
+  const n = Number(value)
+  return Number.isFinite(n) && n >= 0 ? n : null
+}
+
+/**
+ * @param {object} ctx
+ * @param {{enabled?:boolean, mode?:string, targetSavingsRatio?:number}} [config]
+ */
+export function apply(ctx, config = {}) {
+  if (!enabledOf(config)) return { skipped: true, reason: 'disabled-by-config' }
+  const role = detectRole()
+  if (!roleAllowed(ROW_ID, role)) {
+    try {
+      ctx?.logger?.info?.(`[dsh-master] cost-optimizer skipped: role=${role} not in ${ROLE.fork}`)
+    } catch { /* ignore */ }
+    return { skipped: true, reason: `role-not-allowed:${role}` }
+  }
+  const master = safeGet(ctx, SERVICE.master)
+  if (!master || typeof master.registerSubplugin !== 'function') {
+    return { skipped: true, reason: 'master-core-unavailable' }
+  }
+
+  const targetSavingsRatio = finiteNonNegative(config.targetSavingsRatio)
+  const policy = Object.freeze({
+    mode: 'observe', // 3.2.0 只允许 observe；replay 在 3.3.0 打开
+    requestedMode: String(config.mode ?? 'observe'),
+    targetSavingsRatio: targetSavingsRatio !== null && targetSavingsRatio <= 1 ? targetSavingsRatio : 0.8,
+  })
+  const metrics = {
+    tasks: 0,
+    baselineTokens: 0,
+    optimizedTokens: 0,
+    savedTokens: 0,
+    observedSuccess: 0,
+    observedTotal: 0,
+  }
+
+  const service = {
+    id: SERVICE.cost,
+    version: '3.2.5',
+    role,
+    mode: policy.mode,
+    /** 基于 HarnessMM 基准 + 目标比例做派生前预估。 */
+    estimate({ baselineTokens } = {}) {
+      const baseline = finiteNonNegative(baselineTokens)
+      if (baseline === null) return masterError('baseline-tokens-invalid', 'baselineTokens must be a non-negative number')
+      const projectedOptimized = Math.round(baseline * (1 - policy.targetSavingsRatio))
+      return {
+        ok: true,
+        mode: policy.mode,
+        baselineTokens: baseline,
+        targetSavingsRatio: policy.targetSavingsRatio,
+        projectedOptimizedTokens: projectedOptimized,
+        projectedSavingsTokens: baseline - projectedOptimized,
+        basis: {
+          source: 'HarnessMM benchmark',
+          baselineTokens: HARNESSMM_BENCHMARK.baselineTokens,
+          optimizedTokens: HARNESSMM_BENCHMARK.optimizedTokens,
+          savingsRatio: HARNESSMM_BENCHMARK.savingsRatio,
+        },
+      }
+    },
+    /** 归档后记录实测；3.3.0 起由 HarnessMM 的 EGD/GDR/CCS 自动上报。 */
+    record({ taskId, baselineTokens, optimizedTokens, success } = {}) {
+      const baseline = finiteNonNegative(baselineTokens)
+      const optimized = finiteNonNegative(optimizedTokens)
+      if (baseline === null) return masterError('baseline-tokens-invalid', 'baselineTokens must be a non-negative number')
+      if (optimized === null) return masterError('optimized-tokens-invalid', 'optimizedTokens must be a non-negative number')
+      if (optimized > baseline) return masterError('optimized-exceeds-baseline', 'optimizedTokens must not exceed baselineTokens')
+      metrics.tasks += 1
+      metrics.baselineTokens += baseline
+      metrics.optimizedTokens += optimized
+      metrics.savedTokens += baseline - optimized
+      if (typeof success === 'boolean') {
+        metrics.observedTotal += 1
+        if (success) metrics.observedSuccess += 1
+      }
+      return {
+        ok: true,
+        taskId: taskId === undefined ? null : String(taskId),
+        savedTokens: baseline - optimized,
+        summary: service.summary(),
+      }
+    },
+    summary() {
+      const ratio = metrics.baselineTokens > 0 ? metrics.savedTokens / metrics.baselineTokens : 0
+      const successRate = metrics.observedTotal > 0 ? metrics.observedSuccess / metrics.observedTotal : null
+      return { ...metrics, savingsRatio: ratio, successRate }
+    },
+    reset() {
+      Object.assign(metrics, { tasks: 0, baselineTokens: 0, optimizedTokens: 0, savedTokens: 0, observedSuccess: 0, observedTotal: 0 })
+      return { ok: true }
+    },
+    status() {
+      return {
+        ok: true,
+        id: 'cost-optimizer',
+        version: '3.2.5',
+        role,
+        mode: policy.mode,
+        requestedMode: policy.requestedMode,
+        targetSavingsRatio: policy.targetSavingsRatio,
+        benchmark: HARNESSMM_BENCHMARK,
+        summary: service.summary(),
+        note: '3.2.0 observe-only：不拦截/不改写模型调用；EGD/GDR/CCS 在 3.3.0 接入。',
+      }
+    },
+  }
+
+  try { ctx.effect(() => ctx.provide(SERVICE.cost, service)) } catch { /* fake ctx */ }
+  master.registerSubplugin({
+    id: 'cost-optimizer',
+    name: 'dsh-master-cost-optimizer',
+    capabilities: ['token-estimate', 'savings-record', 'cost-status'],
+    description: 'HarnessMM observe 层（仅 fork）',
+  })
+  return service
+}

package/src/plugins/dual-manager.ts

@@ -0,0 +1,252 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+// @ts-nocheck — host JS→TS 迁移阶段：运行时行为优先，类型注解逐步补齐（worker/ 仍严格检查）。
+
+/**
+ * 子插件 3：双主管（PM + PJM）。
+ *
+ * 定位：运行在母体/元主内的元 Agent；PM 把模糊需求变成结构化 PRD，PJM 把 PRD
+ * 拆成步骤并通过瓮城的 fangForker 调度分身执行。本子插件不直接运行生产任务：
+ *   * 没有 fangForker.spawn 时 dispatch fail-closed；
+ *   * 歧义澄清复用瓮城决策中心（fangDecisionCenter），不另造一套审批；
+ *   * 角色：只允许 mother / essence（分身里没有“管理层”）。
+ */
+
+import {
+  FANG_SERVICE,
+  ROW,
+  ROLE,
+  SERVICE,
+  createIdFactory,
+  detectRole,
+  enabledOf,
+  masterError,
+  roleAllowed,
+  safeGet,
+} from '../kernel.ts'
+
+export const name = 'dsh-master-dual-manager'
+export const inject = ['dshMaster']
+export const ROW_ID = ROW.dual
+
+const PRIORITIES = Object.freeze(['low', 'normal', 'high', 'critical'])
+const DEFAULT_STEP_KIND = 'development'
+
+function stringList(value) {
+  if (!Array.isArray(value)) return []
+  return value.map((item) => String(item ?? '').trim()).filter(Boolean)
+}
+
+function missing(name) {
+  return masterError(`${name}-required`, `${name} is required`)
+}
+
+/**
+ * @param {object} ctx
+ * @param {{enabled?:boolean}} [config]
+ */
+export function apply(ctx, config = {}) {
+  if (!enabledOf(config)) return { skipped: true, reason: 'disabled-by-config' }
+  const role = detectRole()
+  if (!roleAllowed(ROW_ID, role)) {
+    try {
+      ctx?.logger?.info?.(`[dsh-master] dual-manager skipped: role=${role} not in mother/essence`)
+    } catch { /* ignore */ }
+    return { skipped: true, reason: `role-not-allowed:${role}` }
+  }
+  const master = safeGet(ctx, SERVICE.master)
+  if (!master || typeof master.registerSubplugin !== 'function') {
+    return { skipped: true, reason: 'master-core-unavailable' }
+  }
+
+  const newPrdId = createIdFactory('prd')
+  const newPlanId = createIdFactory('plan')
+  const prds = new Map()
+  const plans = new Map()
+
+  const decisionCenter = () => safeGet(ctx, FANG_SERVICE.decisionCenter)
+  const forker = () => {
+    const service = safeGet(ctx, FANG_SERVICE.forker)
+    return service && typeof service.spawn === 'function' ? service : null
+  }
+
+  const pm = {
+    /** 需求 → 结构化 PRD（不调用模型；3.2.x 接入 PM agent 后由模型填充字段）。 */
+    createPrd(input = {}) {
+      const title = String(input.title ?? '').trim()
+      const goal = String(input.goal ?? '').trim()
+      if (!title) return missing('title')
+      if (!goal) return missing('goal')
+      const priority = PRIORITIES.includes(String(input.priority ?? 'normal')) ? String(input.priority ?? 'normal') : 'normal'
+      const prd = Object.freeze({
+        id: newPrdId(),
+        title,
+        goal,
+        priority,
+        constraints: Object.freeze(stringList(input.constraints)),
+        acceptance: Object.freeze(stringList(input.acceptance)),
+        requester: String(input.requester ?? 'user'),
+        status: 'draft',
+        createdAt: Date.now(),
+      })
+      prds.set(prd.id, prd)
+      return { ok: true, prd }
+    },
+    getPrd(id) {
+      const prd = prds.get(String(id ?? ''))
+      return prd ? { ok: true, prd } : masterError('prd-not-found', 'PRD not found', { id: String(id ?? '') })
+    },
+    listPrds() {
+      return { ok: true, items: [...prds.values()] }
+    },
+    /** 歧义澄清：复用瓮城决策中心，返回 ticket 或明确的 unavailable。 */
+    async askUser({ question, context = '', options = [], level = 'yellow' } = {}) {
+      const q = String(question ?? '').trim()
+      if (!q) return missing('question')
+      const center = decisionCenter()
+      if (!center || typeof center.create !== 'function') {
+        return masterError('fang-decision-center-unavailable', 'dsh-fang decision center is required to ask the user')
+      }
+      try {
+        const out = await center.create({
+          level: ['red', 'yellow', 'blue', 'green'].includes(String(level)) ? String(level) : 'yellow',
+          title: q,
+          context: String(context),
+          options: Array.isArray(options) ? options : [],
+          source: { role: 'pm', kind: 'prd-clarification' },
+        })
+        if (out && out.ok === false) return { ...masterError('decision-create-failed', 'decision center rejected the ticket', out) }
+        return { ok: true, ticket: out?.ticket ?? out }
+      } catch (error) {
+        return masterError('decision-create-threw', String(error?.message ?? error))
+      }
+    },
+  }
+
+  const pjm = {
+    /** PRD → 可调度步骤计划。 */
+    plan(prdId, { steps = [] } = {}) {
+      const prd = prds.get(String(prdId ?? ''))
+      if (!prd) return masterError('prd-not-found', 'PRD not found', { id: String(prdId ?? '') })
+      if (!Array.isArray(steps) || steps.length === 0) return missing('steps')
+      const normalized = []
+      for (const [index, step] of steps.entries()) {
+        const title = String(step?.title ?? '').trim()
+        const prompt = String(step?.prompt ?? '').trim()
+        if (!title) return missing(`steps[${index}].title`)
+        if (!prompt) return missing(`steps[${index}].prompt`)
+        normalized.push({
+          id: String(step?.id ?? `step-${index + 1}`),
+          title,
+          prompt,
+          kind: String(step?.kind ?? DEFAULT_STEP_KIND),
+          status: 'pending',
+          fork: null,
+        })
+      }
+      const plan = {
+        id: newPlanId(),
+        prdId: prd.id,
+        status: 'planned',
+        steps: normalized,
+        createdAt: Date.now(),
+      }
+      plans.set(plan.id, plan)
+      return { ok: true, plan }
+    },
+    getPlan(id) {
+      const plan = plans.get(String(id ?? ''))
+      return plan ? { ok: true, plan } : masterError('plan-not-found', 'Plan not found', { id: String(id ?? '') })
+    },
+    /** 调瓮城 fangForker.spawn 派生执行分身；无 forker 时 fail-closed。 */
+    async dispatch(planId, { stepId } = {}) {
+      const plan = plans.get(String(planId ?? ''))
+      if (!plan) return masterError('plan-not-found', 'Plan not found', { id: String(planId ?? '') })
+      const step = plan.steps.find((item) => item.id === String(stepId ?? ''))
+      if (!step) return masterError('step-not-found', 'Step not found', { id: String(stepId ?? '') })
+      if (step.fork) return masterError('step-already-dispatched', 'Step already dispatched', { stepId: step.id, fork: step.fork })
+      const fangForker = forker()
+      if (!fangForker) {
+        return masterError('fang-forker-unavailable', 'dsh-fang fangForker.spawn is required to dispatch a step')
+      }
+      // 先占位再 await，避免两个并发 dispatch 同时看到 step.fork=null 而重复派生。
+      step.status = 'dispatching'
+      step.fork = { pending: true }
+      try {
+        const spawnConfig = config.dispatch && typeof config.dispatch === 'object' ? config.dispatch : {}
+        const fork = await fangForker.spawn({
+          homeDir: String(spawnConfig.homeDir ?? '') || undefined,
+          cliPath: String(spawnConfig.cliPath ?? '') || undefined,
+          profile: String(spawnConfig.profile ?? 'default') || 'default',
+          taskTitle: `PJM ${plan.id}/${step.id} ${step.title}`,
+          env: {
+            DSH_PJM_PRD_ID: String(plan.prdId),
+            DSH_PJM_PLAN_ID: String(plan.id),
+            DSH_PJM_STEP_ID: String(step.id),
+            DSH_PJM_KIND: String(step.kind),
+            DSH_PJM_PROMPT: String(step.prompt),
+          },
+        })
+        if (fork && fork.ok === false) {
+          step.status = 'pending'; step.fork = null
+          return { ...masterError('fang-spawn-failed', 'fangForker.spawn returned an error', fork), step }
+        }
+        step.status = 'running'
+        step.fork = fork ?? null
+        plan.status = 'running'
+        return { ok: true, planId: plan.id, stepId: step.id, step, fork }
+      } catch (error) {
+        step.status = 'pending'; step.fork = null
+        return masterError('fang-spawn-threw', String(error?.message ?? error))
+      }
+    },
+    completeStep(planId, stepId, { status = 'done', summary = '' } = {}) {
+      const plan = plans.get(String(planId ?? ''))
+      if (!plan) return masterError('plan-not-found', 'Plan not found', { id: String(planId ?? '') })
+      const step = plan.steps.find((item) => item.id === String(stepId ?? ''))
+      if (!step) return masterError('step-not-found', 'Step not found', { id: String(stepId ?? '') })
+      const next = status === 'failed' ? 'failed' : 'done'
+      step.status = next
+      step.summary = String(summary)
+      const states = plan.steps.map((item) => item.status)
+      plan.status = states.every((state) => state === 'done')
+        ? 'done'
+        : (states.some((state) => state === 'running') ? 'running' : 'planned')
+      return { ok: true, plan }
+    },
+    listPlans() {
+      return { ok: true, items: [...plans.values()] }
+    },
+  }
+
+  const service = {
+    id: SERVICE.dual,
+    version: '3.2.5',
+    role,
+    pm,
+    pjm,
+    status() {
+      return {
+        ok: true,
+        id: 'dual-manager',
+        version: '3.2.5',
+        role,
+        pm: { prds: prds.size },
+        pjm: { plans: plans.size },
+        cooperation: {
+          decisionCenter: Boolean(decisionCenter()),
+          forker: Boolean(forker()),
+        },
+      }
+    },
+  }
+
+  try { ctx.effect(() => ctx.provide(SERVICE.dual, service)) } catch { /* fake ctx */ }
+  master.registerSubplugin({
+    id: 'dual-manager',
+    name: 'dsh-master-dual-manager',
+    capabilities: ['pm-prd', 'pm-ask-user', 'pjm-plan', 'pjm-dispatch'],
+    description: 'PM + PJM 双主管（仅 mother/essence）',
+  })
+  return service
+}