@twinsearth/dsh-master 0.0.0-stage → 3.2.8

package/dist-host/plugins/dual-manager.js

@@ -0,0 +1,251 @@
+// 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, SERVICE, createIdFactory, detectRole, enabledOf, masterError, roleAllowed, safeGet, } from "../kernel.js";
+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;
+}