@s_s/harmonia 1.3.0 → 1.4.0

package/build/tools/artifact-tools.js

@@ -0,0 +1,465 @@
+/**
+ * MCP Tools: artifact_write / artifact_read / artifact_list
+ * Read and write project artifacts. Output paths are resolved per artifact
+ *
+ * artifact_write validates content against artifact schemas and checks review
+ * configuration. If validation fails, the write is rejected with specific
+ * error details. If review is required, the artifact is submitted for
+ * user approval.
+ *
+ * Sequential mode: When an artifact has `steps` defined in workflow.json,
+ * artifact_write requires a `step` parameter. Each step is validated
+ * independently, and the final step automatically writes the formal
+ * artifact and triggers the review flow.
+ *
+ * After writing, triggers engine event `artifact_written` to evaluate gates.
+ */
+import { z } from 'zod';
+import { writeArtifact, readArtifact, listArtifacts, writeStepArtifact } from '../core/artifacts.js';
+import { readState } from '../core/state.js';
+import { loadWorkflow } from '../core/plugin.js';
+import { getMergedOverrides, resolveArtifactReview } from '../core/overrides.js';
+import { submitForReview } from '../core/reviews.js';
+import { loadArtifactSchema, validateArtifact, formatValidationErrors } from '../core/schema.js';
+import { getArtifactStepState, getCompletedStepIds, recordStepCompletion, markFinalized } from '../core/steps.js';
+import { resolveActive, isError } from './utils.js';
+import { processWorkflowEvent, loadWorkflowForContext, formatNextAction } from './engine-helpers.js';
+import { getProject, resolveContextDir } from '../core/registry.js';
+/**
+ * Check if sequential mode is active for a given artifact definition.
+ * Sequential mode is active whenever the artifact has steps defined.
+ */
+function isSequentialActive(artifactDef) {
+    return !!artifactDef.steps?.length;
+}
+export function registerArtifactTools(server, workflowsDir) {
+    server.tool('artifact_write', 'Write or update a project artifact. For artifacts with sequential steps (PRD, tech-design, task-breakdown), you MUST specify the step parameter. Automatically checks review configuration — if review is required, the artifact is submitted for user approval.', {
+        project_name: z.string().describe('Project name'),
+        artifact_id: z
+            .string()
+            .describe('Artifact ID (e.g. prd, user-stories, fsd, prototype, tech-design, task-breakdown, etc.)'),
+        content: z
+            .string()
+            .describe('Artifact content (markdown, HTML, or JSON depending on artifact type and step)'),
+        step: z
+            .string()
+            .optional()
+            .describe('Sequential step ID (required for artifacts with steps). Use project_status to see available steps.'),
+    }, async ({ project_name, artifact_id, content, step }) => {
+        const ctx = await resolveActive(project_name);
+        if (isError(ctx))
+            return ctx;
+        // Load workflow to get artifact definition (format, review defaults)
+        const { wf, state } = await loadWorkflowForContext(workflowsDir, project_name, ctx);
+        const artifactDef = wf.artifactDefinitions[artifact_id];
+        const isHtml = artifactDef?.format === 'html';
+        // Guard: artifact_id must be defined in workflow
+        if (!artifactDef) {
+            const validIds = Object.keys(wf.artifactDefinitions)
+                .filter((id) => !wf.artifactDefinitions[id].unmanaged)
+                .join(', ');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Artifact "${artifact_id}" 未在工作流中定义。可用的 artifact 类型: ${validIds}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Guard: reject unmanaged artifact types (should be produced outside artifact_write)
+        if (artifactDef.unmanaged) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Artifact "${artifact_id}" 是非托管（unmanaged）产出类型，不应通过 artifact_write 写入。`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Guard: empty content
+        if (!content.trim()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Artifact 内容为空，请提供实际内容后重新提交。',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // ─── Sequential Mode ───
+        if (isSequentialActive(artifactDef)) {
+            return handleSequentialWrite(workflowsDir, state.workflow, project_name, ctx, artifact_id, content, step, artifactDef);
+        }
+        // ─── Normal Mode (no steps) ───
+        // Schema validation — reject write if content doesn't meet requirements
+        const schema = await loadArtifactSchema(workflowsDir, state.workflow, artifact_id);
+        if (schema) {
+            const result = validateArtifact(content, schema, isHtml);
+            if (!result.valid) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: formatValidationErrors(result.errors),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // Write the artifact with correct extension
+        const writeIoCtx = {
+            contextDir: ctx.dir,
+            projectDir: ctx.entry.dir,
+            contextLabel: ctx.activeContext,
+        };
+        const filePath = await writeArtifact(artifact_id, content, writeIoCtx, artifactDef);
+        // Trigger engine event: artifact_written
+        const engineResult = await processWorkflowEvent(workflowsDir, project_name, ctx, {
+            type: 'artifact_written',
+            artifactId: artifact_id,
+        });
+        // Check if review is required
+        const overrides = await getMergedOverrides(project_name);
+        const needsReview = resolveArtifactReview(artifact_id, artifactDef, overrides);
+        if (needsReview) {
+            await submitForReview(project_name, ctx.number, artifact_id, ctx.dir);
+            const artifactName = artifactDef.name ?? artifact_id;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `Artifact "${artifact_id}" (${artifactName}) written to ${filePath}`,
+                            ``,
+                            `** REVIEW REQUIRED **`,
+                            `This artifact requires user approval before the workflow can proceed.`,
+                            `Please present the artifact content to the user and ask for their confirmation.`,
+                            `After user approval, call artifact_approve with project_name="${project_name}" and artifact_id="${artifact_id}".`,
+                            `If the user requests changes, revise the artifact and call artifact_write again.`,
+                            formatNextAction(engineResult.nextAction),
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Artifact "${artifact_id}" written to ${filePath}` +
+                        formatNextAction(engineResult.nextAction),
+                },
+            ],
+        };
+    });
+    server.tool('artifact_read', 'Read a project artifact. By default reads from the active context. Use the optional `context` parameter (e.g. "iter-1", "patch-2") to read from a different context.', {
+        project_name: z.string().describe('Project name'),
+        artifact_id: z.string().describe('Artifact ID to read'),
+        context: z
+            .string()
+            .optional()
+            .describe('Context to read from (e.g. "iter-1", "patch-2"). Defaults to active context.'),
+    }, async ({ project_name, artifact_id, context }) => {
+        try {
+            let contextNumber;
+            let contextDir;
+            let contextLabel;
+            let projectDir;
+            if (context) {
+                // Cross-context read: resolve the specified context
+                const entry = await getProject(project_name);
+                if (!entry) {
+                    return {
+                        content: [{ type: 'text', text: `项目 "${project_name}" 未注册。` }],
+                        isError: true,
+                    };
+                }
+                const resolved = resolveContextDir(project_name, context);
+                if (!resolved) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `无法解析上下文 "${context}"。格式示例: iter-1, patch-2`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                contextNumber = resolved.number;
+                contextDir = resolved.dir;
+                contextLabel = context;
+                projectDir = entry.dir;
+            }
+            else {
+                // Default: active context
+                const ctx = await resolveActive(project_name);
+                if (isError(ctx))
+                    return ctx;
+                contextNumber = ctx.number;
+                contextDir = ctx.dir;
+                contextLabel = ctx.activeContext;
+                projectDir = ctx.entry.dir;
+            }
+            // Load workflow to get artifact definition for output path resolution
+            const state = await readState(project_name, contextNumber, contextDir);
+            const wf = await loadWorkflow(workflowsDir, state.workflow);
+            const artifactDef = wf.artifactDefinitions[artifact_id];
+            const ioCtx = { contextDir, projectDir, contextLabel };
+            const artifactContent = await readArtifact(artifact_id, ioCtx, artifactDef);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: artifactContent,
+                    },
+                ],
+            };
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Artifact "${artifact_id}" not found. Use artifact_list to see available artifacts.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool('artifact_list', 'List all project artifacts. By default lists from the active context. Use the optional `context` parameter (e.g. "iter-1", "patch-2") to list from a different context.', {
+        project_name: z.string().describe('Project name'),
+        context: z
+            .string()
+            .optional()
+            .describe('Context to list from (e.g. "iter-1", "patch-2"). Defaults to active context.'),
+    }, async ({ project_name, context }) => {
+        let contextNumber;
+        let contextDir;
+        let contextLabel;
+        let projectDir;
+        if (context) {
+            const entry = await getProject(project_name);
+            if (!entry) {
+                return {
+                    content: [{ type: 'text', text: `项目 "${project_name}" 未注册。` }],
+                    isError: true,
+                };
+            }
+            const resolved = resolveContextDir(project_name, context);
+            if (!resolved) {
+                return {
+                    content: [
+                        { type: 'text', text: `无法解析上下文 "${context}"。格式示例: iter-1, patch-2` },
+                    ],
+                    isError: true,
+                };
+            }
+            contextNumber = resolved.number;
+            contextDir = resolved.dir;
+            contextLabel = context;
+            projectDir = entry.dir;
+        }
+        else {
+            const ctx = await resolveActive(project_name);
+            if (isError(ctx))
+                return ctx;
+            contextNumber = ctx.number;
+            contextDir = ctx.dir;
+            contextLabel = ctx.activeContext;
+            projectDir = ctx.entry.dir;
+        }
+        // Load workflow for artifact definitions and output path resolution
+        const state = await readState(project_name, contextNumber, contextDir);
+        const wf = await loadWorkflow(workflowsDir, state.workflow);
+        const ioCtx = { contextDir, projectDir, contextLabel };
+        const artifacts = await listArtifacts(ioCtx, wf.artifactDefinitions);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: artifacts.length > 0
+                        ? `Artifacts (${contextLabel}):\n${artifacts.map((d) => `- ${d}`).join('\n')}`
+                        : `No artifacts found for ${contextLabel}.`,
+                },
+            ],
+        };
+    });
+}
+async function handleSequentialWrite(workflowsDir, workflowName, projectName, ctx, artifactId, content, step, artifactDef) {
+    const steps = artifactDef.steps;
+    const stepIds = steps.map((s) => s.id);
+    const stepNames = steps.map((s) => `${s.id} (${s.name})`).join(', ');
+    // Guard: step parameter is required in sequential mode
+    if (!step) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `Artifact "${artifactId}" 需要分步写入。`,
+                        `请指定 step 参数。可用的步骤: ${stepNames}`,
+                        ``,
+                        `步骤说明:`,
+                        ...steps.map((s, i) => `  ${i + 1}. ${s.id} — ${s.description}`),
+                    ].join('\n'),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Guard: step must be valid
+    const stepDef = steps.find((s) => s.id === step);
+    if (!stepDef) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `未知的步骤 "${step}"。可用的步骤: ${stepNames}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const stepIndex = stepIds.indexOf(step);
+    const stepState = await getArtifactStepState(projectName, ctx.number, artifactId, ctx.dir);
+    const completedIds = getCompletedStepIds(stepState);
+    // Guard: prerequisite steps must be completed (hard enforcement)
+    for (let i = 0; i < stepIndex; i++) {
+        if (!completedIds.has(stepIds[i])) {
+            const missingStep = steps[i];
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `无法写入步骤 "${step}"：前置步骤 "${missingStep.id}" (${missingStep.name}) 尚未完成。请先完成该步骤。`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Step schema validation
+    const isJson = stepDef.format === 'json';
+    const stepSchemaId = `${artifactId}.${step}`;
+    const stepSchema = await loadArtifactSchema(workflowsDir, workflowName, stepSchemaId);
+    if (stepSchema) {
+        const result = validateArtifact(content, stepSchema, false, isJson);
+        if (!result.valid) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatValidationErrors(result.errors),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Write the step artifact
+    const ioCtx = {
+        contextDir: ctx.dir,
+        projectDir: ctx.entry.dir,
+        contextLabel: ctx.activeContext,
+    };
+    const artifactPath = await writeStepArtifact(artifactId, step, content, stepDef.format, ioCtx, artifactDef);
+    // Record step completion (handles rollback if overwriting)
+    await recordStepCompletion(projectName, ctx.number, artifactId, step, artifactPath, stepIds, ctx.dir);
+    const isLastStep = stepIndex === steps.length - 1;
+    if (isLastStep) {
+        // Auto-merge: validate against final artifact schema, write formal artifact, trigger review
+        return handleFinalStep(workflowsDir, workflowName, projectName, ctx, artifactId, content, artifactDef, stepDef, ioCtx);
+    }
+    // Not the last step — return progress info
+    const nextStep = steps[stepIndex + 1];
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `步骤 "${step}" (${stepDef.name}) 完成，产物已写入 ${artifactPath}`,
+                    ``,
+                    `下一步: ${nextStep.id} — ${nextStep.description}`,
+                    `请调用 artifact_write(project_name="${projectName}", artifact_id="${artifactId}", step="${nextStep.id}", content=...)`,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+async function handleFinalStep(workflowsDir, workflowName, projectName, ctx, artifactId, content, artifactDef, stepDef, ioCtx) {
+    const isHtml = artifactDef.format === 'html';
+    // Validate against the final artifact schema (e.g. prd.json)
+    const finalSchema = await loadArtifactSchema(workflowsDir, workflowName, artifactId);
+    if (finalSchema) {
+        const isJson = artifactDef.format === 'json';
+        const result = validateArtifact(content, finalSchema, isHtml, isJson);
+        if (!result.valid) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            '最终 artifact 校验失败:',
+                            formatValidationErrors(result.errors),
+                            '',
+                            `请修正后重新提交步骤 "${stepDef.id}"。`,
+                        ].join('\n'),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Write the formal artifact
+    const filePath = await writeArtifact(artifactId, content, ioCtx, artifactDef);
+    // Mark as finalized
+    await markFinalized(projectName, ctx.number, artifactId, ctx.dir);
+    // Trigger engine event: artifact_written
+    const engineResult = await processWorkflowEvent(workflowsDir, projectName, ctx, {
+        type: 'artifact_written',
+        artifactId,
+    });
+    // Check if review is required
+    const overrides = await getMergedOverrides(projectName);
+    const needsReview = resolveArtifactReview(artifactId, artifactDef, overrides);
+    if (needsReview) {
+        await submitForReview(projectName, ctx.number, artifactId, ctx.dir);
+        const artifactName = artifactDef.name ?? artifactId;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `所有步骤完成！Artifact "${artifactId}" (${artifactName}) 已写入 ${filePath}`,
+                        ``,
+                        `** REVIEW REQUIRED **`,
+                        `This artifact requires user approval before the workflow can proceed.`,
+                        `Please present the artifact content to the user and ask for their confirmation.`,
+                        `After user approval, call artifact_approve with project_name="${projectName}" and artifact_id="${artifactId}".`,
+                        `If the user requests changes, revise the artifact and call artifact_write again with the appropriate step.`,
+                        formatNextAction(engineResult.nextAction),
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `所有步骤完成！Artifact "${artifactId}" 已写入 ${filePath}` +
+                    formatNextAction(engineResult.nextAction),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=artifact-tools.js.map

package/build/tools/artifact-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-tools.js","sourceRoot":"","sources":["../../src/tools/artifact-tools.ts"],"names":[],"mappings":"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"}

package/build/tools/{report-dispatch.d.ts → dispatch-report.d.ts}

@@ -1,14 +1,18 @@
 /**
  * MCP Tool: dispatch_report
  *
- * PM calls this tool to report dispatch status changes:
+ * Coordinator calls this tool to report dispatch status changes:
  * 1. After launching an agent: provide agent_session_id → creates/reuses session, marks dispatch running
  * 2. After agent finishes: provide status=completed/failed → updates dispatch, session goes idle/closed
  *
+ * Node-based architecture changes:
+ * - On completed: triggers `node_completed` engine event → computes nextAction
+ * - On failed: triggers `node_failed` engine event → engine checks onFailed → computes nextAction
+ * - Returns nextAction in response so coordinator knows what to do next
+ *
  * Guards:
  * - State machine: terminal states (completed/failed/cancelled) are irreversible
  * - Valid transitions: dispatched→running/cancelled, running→completed/failed/cancelled
- * - Completion check: warns if expectedOutputs docs are missing
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerReportDispatch(server: McpServer, builtinDir: string, customDir: string): void;
+export declare function registerReportDispatch(server: McpServer, workflowsDir: string): void;