@s_s/harmonia 1.2.0 → 1.4.0

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;

package/build/tools/dispatch-report.js

@@ -0,0 +1,261 @@
+/**
+ * MCP Tool: dispatch_report
+ *
+ * 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
+ */
+import { z } from 'zod';
+import { getDispatch, updateDispatch, createSession, updateSession, findSessionByAgentId, readSessions, isValidTransition, isTerminalStatus, } from '../core/dispatch.js';
+import { resolveActive, isError } from './utils.js';
+import { loadWorkflowForContext, processWorkflowEvent, formatNextAction, findTaskNode } from './engine-helpers.js';
+import { readArtifact, listArtifacts } from '../core/artifacts.js';
+import { findAncestorLoopId } from '../core/tree-utils.js';
+export function registerReportDispatch(server, workflowsDir) {
+    server.tool('dispatch_report', 'Report dispatch status after launching or completing a team member agent. Call with agent_session_id after launching to register the session. Call with status="completed" or "failed" when the agent finishes. Returns nextAction indicating what the coordinator should do next.', {
+        project_name: z.string().describe('Project name'),
+        dispatch_id: z.string().describe('Dispatch ID returned by role_dispatch'),
+        status: z
+            .enum(['running', 'completed', 'failed', 'cancelled'])
+            .optional()
+            .describe('New dispatch status. Omit when only registering agent_session_id (defaults to "running").'),
+        agent_session_id: z
+            .string()
+            .optional()
+            .describe('The actual session ID from the host agent (e.g. OpenCode session ID). Provide on first report after launching.'),
+        agent_type: z
+            .enum(['opencode', 'openclaw', 'claude-code', 'codex'])
+            .optional()
+            .describe('Agent type used for this dispatch'),
+        label: z.string().optional().describe('Optional label for the session (e.g. "dev-auth-module")'),
+        note: z.string().optional().describe('Optional note (e.g. failure reason)'),
+    }, async ({ project_name, dispatch_id, status, agent_session_id, agent_type, label, note }) => {
+        try {
+            const ctx = await resolveActive(project_name);
+            if (isError(ctx))
+                return ctx;
+            // Load the dispatch record
+            const dispatch = await getDispatch(project_name, ctx.number, dispatch_id, ctx.dir);
+            if (!dispatch) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Dispatch "${dispatch_id}" not found in project "${project_name}".`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const effectiveStatus = status ?? 'running';
+            const results = [];
+            // Guard: state machine — reject invalid transitions
+            if (!isValidTransition(dispatch.status, effectiveStatus)) {
+                const reason = isTerminalStatus(dispatch.status)
+                    ? `Dispatch "${dispatch_id}" is in terminal status "${dispatch.status}" — cannot transition to "${effectiveStatus}".`
+                    : `Dispatch "${dispatch_id}" current status "${dispatch.status}" does not allow transition to "${effectiveStatus}".`;
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: reason,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Handle session registration (when agent_session_id is provided)
+            let session = null;
+            if (agent_session_id) {
+                session = await resolveOrCreateSession(project_name, ctx.number, dispatch, agent_session_id, agent_type, label, ctx.dir);
+                results.push(`Session: ${session.id} (agent: ${agent_session_id}, status: ${session.status})`);
+            }
+            // Handle status transitions
+            let nextActionText = '';
+            if (effectiveStatus === 'completed' ||
+                effectiveStatus === 'failed' ||
+                effectiveStatus === 'cancelled') {
+                // Terminal states: update dispatch and transition session
+                await updateDispatch(project_name, ctx.number, dispatch_id, {
+                    status: effectiveStatus,
+                    ...(session ? { sessionId: session.id } : {}),
+                    ...(note ? { note } : {}),
+                }, ctx.dir);
+                // Transition session: completed → idle, failed/cancelled → lost
+                const sessionId = session?.id ?? dispatch.sessionId;
+                if (sessionId) {
+                    const newSessionStatus = effectiveStatus === 'completed' ? 'idle' : 'lost';
+                    await updateSession(project_name, ctx.number, sessionId, { status: newSessionStatus }, ctx.dir);
+                    results.push(`Session ${sessionId} → ${newSessionStatus}`);
+                }
+                results.push(`Dispatch ${dispatch_id} → ${effectiveStatus}`);
+                // Trigger engine events for completed/failed/cancelled
+                if (dispatch.nodeId) {
+                    if (effectiveStatus === 'completed') {
+                        const engineResult = await processWorkflowEvent(workflowsDir, project_name, ctx, {
+                            type: 'node_completed',
+                            nodeId: dispatch.nodeId,
+                        });
+                        nextActionText = formatNextAction(engineResult.nextAction);
+                        // Execute afterComplete hooks
+                        try {
+                            const { wf, state: currentState } = await loadWorkflowForContext(workflowsDir, project_name, ctx);
+                            const targetNode = findTaskNode(wf, dispatch.nodeId);
+                            if (targetNode?.afterComplete) {
+                                const hookInjections = [];
+                                if (targetNode.afterComplete.inject) {
+                                    hookInjections.push(...targetNode.afterComplete.inject);
+                                }
+                                if (targetNode.afterComplete.actions && wf.actions) {
+                                    const reportIoCtx = {
+                                        contextDir: ctx.dir,
+                                        projectDir: ctx.entry.dir,
+                                        contextLabel: ctx.activeContext,
+                                    };
+                                    const nodeState = currentState.nodes[dispatch.nodeId];
+                                    // Resolve loopIteration: find ancestor loop node and read its current iteration
+                                    let loopIteration;
+                                    const ancestorLoopId = findAncestorLoopId(wf.definition.root, dispatch.nodeId);
+                                    if (ancestorLoopId) {
+                                        const loopState = currentState.nodes[ancestorLoopId];
+                                        if (loopState) {
+                                            loopIteration = loopState.currentIteration;
+                                        }
+                                    }
+                                    const actionCtx = {
+                                        nodeId: dispatch.nodeId,
+                                        role: dispatch.role,
+                                        retryCount: nodeState?.retryCount ?? 0,
+                                        projectName: project_name,
+                                        pluginConfig: wf.config,
+                                        workflowState: currentState,
+                                        artifacts: {
+                                            read: (artifactId) => readArtifact(artifactId, reportIoCtx, wf.artifactDefinitions[artifactId]),
+                                            list: () => listArtifacts(reportIoCtx, wf.artifactDefinitions),
+                                        },
+                                        loopIteration,
+                                    };
+                                    for (const actionName of targetNode.afterComplete.actions) {
+                                        const handler = wf.actions[actionName];
+                                        if (handler) {
+                                            try {
+                                                const actionResult = await handler(actionCtx);
+                                                if (actionResult.inject) {
+                                                    hookInjections.push(...actionResult.inject);
+                                                }
+                                            }
+                                            catch (err) {
+                                                console.warn(`[harmonia] afterComplete action "${actionName}" failed:`, err);
+                                            }
+                                        }
+                                    }
+                                }
+                                if (hookInjections.length > 0) {
+                                    results.push('', '## After-Complete Hook Output', ...hookInjections);
+                                }
+                            }
+                        }
+                        catch (err) {
+                            console.warn('[harmonia] afterComplete hook processing failed:', err);
+                        }
+                    }
+                    else if (effectiveStatus === 'failed') {
+                        const engineResult = await processWorkflowEvent(workflowsDir, project_name, ctx, {
+                            type: 'node_failed',
+                            nodeId: dispatch.nodeId,
+                            error: note ?? 'Unknown failure',
+                        });
+                        nextActionText = formatNextAction(engineResult.nextAction);
+                    }
+                    else if (effectiveStatus === 'cancelled') {
+                        // Cancelled dispatches should also update node state via engine
+                        // so the node doesn't stay stuck in 'active' forever
+                        const engineResult = await processWorkflowEvent(workflowsDir, project_name, ctx, {
+                            type: 'node_failed',
+                            nodeId: dispatch.nodeId,
+                            error: note ?? 'Dispatch cancelled',
+                        });
+                        nextActionText = formatNextAction(engineResult.nextAction);
+                    }
+                }
+            }
+            else {
+                // Running: update dispatch status + associate session
+                await updateDispatch(project_name, ctx.number, dispatch_id, {
+                    status: 'running',
+                    ...(session ? { sessionId: session.id } : {}),
+                    ...(note ? { note } : {}),
+                }, ctx.dir);
+                // Mark session as active
+                const sessionId = session?.id ?? dispatch.sessionId;
+                if (sessionId) {
+                    await updateSession(project_name, ctx.number, sessionId, { status: 'active' }, ctx.dir);
+                }
+                results.push(`Dispatch ${dispatch_id} → running`);
+            }
+            // Build response
+            const nextStepHint = effectiveStatus === 'running'
+                ? `\nNext: When the agent finishes, call dispatch_report with dispatch_id="${dispatch_id}" and status="completed" (or "failed").`
+                : `\nNext: Call project_status to check overall progress and determine next steps.`;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `# Report Dispatch: ${dispatch_id}\n\n${results.join('\n')}${nextStepHint}${nextActionText}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Resolve an existing session by agent session ID, or create a new one.
+ */
+async function resolveOrCreateSession(projectName, iteration, dispatch, agentSessionId, agentType, label, contextDir) {
+    // If the dispatch already has a session, update it with the agent session ID
+    if (dispatch.sessionId) {
+        const sessions = await readSessions(projectName, iteration, contextDir);
+        const existing = sessions.find((s) => s.id === dispatch.sessionId);
+        if (existing) {
+            return await updateSession(projectName, iteration, existing.id, {
+                agentSessionId,
+                ...(agentType ? { agentType } : {}),
+                ...(label ? { label } : {}),
+                status: 'active',
+            }, contextDir);
+        }
+    }
+    // Check if a session with this agent session ID already exists for this role
+    const existingByAgent = await findSessionByAgentId(projectName, iteration, dispatch.role, agentSessionId, contextDir);
+    if (existingByAgent) {
+        return await updateSession(projectName, iteration, existingByAgent.id, {
+            status: 'active',
+            ...(agentType ? { agentType } : {}),
+            ...(label ? { label } : {}),
+        }, contextDir);
+    }
+    // Create a new session
+    const session = await createSession(projectName, iteration, dispatch.role, agentType, label, contextDir);
+    return await updateSession(projectName, iteration, session.id, { agentSessionId }, contextDir);
+}
+//# sourceMappingURL=dispatch-report.js.map

package/build/tools/dispatch-report.js.map

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

package/build/tools/engine-helpers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared engine helpers for tool handlers.
+ *
+ * Provides a workflow engine integration layer so that individual tools
+ * can trigger engine events (artifact_written, artifact_approved, etc.)
+ * and receive the computed nextAction.
+ */
+import type { WorkflowState, WorkflowEvent, NextAction, WorkflowPlugin, TaskNode } from '../core/types.js';
+import type { ResolvedContext } from './utils.js';
+/** Result of processing a workflow event through the engine */
+export interface EngineResult {
+    /** Updated workflow state (already persisted) */
+    state: WorkflowState;
+    /** What the coordinator should do next */
+    nextAction: NextAction;
+}
+/**
+ * Find a task node by ID in the workflow definition (including floating nodes).
+ */
+export declare function findTaskNode(wf: WorkflowPlugin, nodeId: string): TaskNode | undefined;
+/**
+ * Process a workflow event through the engine.
+ *
+ * 1. Loads current state + workflow plugin
+ * 2. Builds engine context (gate evaluation, role prompts)
+ * 3. Calls computeNextAction
+ * 4. Persists updated state
+ * 5. Returns the nextAction
+ */
+export declare function processWorkflowEvent(workflowsDir: string, projectName: string, ctx: ResolvedContext, event: WorkflowEvent): Promise<EngineResult>;
+/**
+ * Load the workflow plugin for a resolved context.
+ */
+export declare function loadWorkflowForContext(workflowsDir: string, projectName: string, ctx: ResolvedContext): Promise<{
+    wf: WorkflowPlugin;
+    state: WorkflowState;
+}>;
+/**
+ * Format a nextAction into a human-readable message for the tool response.
+ */
+export declare function formatNextAction(nextAction: NextAction): string;

package/build/tools/engine-helpers.js

@@ -0,0 +1,182 @@
+/**
+ * Shared engine helpers for tool handlers.
+ *
+ * Provides a workflow engine integration layer so that individual tools
+ * can trigger engine events (artifact_written, artifact_approved, etc.)
+ * and receive the computed nextAction.
+ */
+import { readState, persistState } from '../core/state.js';
+import { loadWorkflow } from '../core/plugin.js';
+import { listArtifacts, readArtifact } from '../core/artifacts.js';
+import { readReviews } from '../core/reviews.js';
+import { computeNextAction } from '../core/workflow-engine.js';
+import { collectTaskNodes } from '../core/tree-utils.js';
+/**
+ * Resolve a dot-separated field path on a JSON object.
+ * e.g. "result" on { result: "pass" } → "pass"
+ * e.g. "stats.total" on { stats: { total: 10 } } → 10
+ */
+function resolveFieldPath(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Build a GateContext from the current project state.
+ * This provides the artifact existence/approval/field checks
+ * that the engine needs for gate evaluation.
+ *
+ * For artifact_field conditions, pre-loads and caches all existing
+ * JSON artifact contents so field access can be synchronous.
+ */
+function buildGateContext(projectName, iteration, contextDir, existingArtifacts, reviews, artifactCache) {
+    return {
+        artifactExists: (artifactId) => existingArtifacts.has(artifactId),
+        artifactApproved: (artifactId) => reviews[artifactId]?.status === 'approved',
+        artifactField: (artifactId, field) => {
+            const content = artifactCache.get(artifactId);
+            if (content === undefined)
+                return undefined;
+            return resolveFieldPath(content, field);
+        },
+    };
+}
+/**
+ * Build the full EngineContext needed for engine operations.
+ * Pre-loads artifact content for field-based gate evaluation.
+ */
+async function buildEngineContext(projectName, iteration, contextDir, wf, ioCtx) {
+    // Load current artifacts and reviews for gate evaluation
+    const artifactList = await listArtifacts(ioCtx, wf.artifactDefinitions);
+    const existingArtifacts = new Set(artifactList);
+    const reviews = await readReviews(projectName, iteration, contextDir);
+    // Pre-load artifact content for field access (JSON artifacts only)
+    const artifactCache = new Map();
+    for (const artifactId of artifactList) {
+        const artifactDef = wf.artifactDefinitions[artifactId];
+        try {
+            const content = await readArtifact(artifactId, ioCtx, artifactDef);
+            // Try to parse as JSON; if it fails, store raw string
+            try {
+                artifactCache.set(artifactId, JSON.parse(content));
+            }
+            catch {
+                artifactCache.set(artifactId, content);
+            }
+        }
+        catch {
+            // Artifact listed but unreadable — skip
+        }
+    }
+    const gateCtx = buildGateContext(projectName, iteration, contextDir, existingArtifacts, reviews, artifactCache);
+    return {
+        gate: gateCtx,
+        getRolePrompt: (role, nodeId) => {
+            const roleDef = wf.roles[role];
+            return roleDef?.prompt ?? `Role "${role}" prompt not found`;
+        },
+    };
+}
+/**
+ * Find a task node by ID in the workflow definition (including floating nodes).
+ */
+export function findTaskNode(wf, nodeId) {
+    const allTasks = collectTaskNodes(wf.definition.root);
+    const found = allTasks.find((t) => t.id === nodeId);
+    if (found)
+        return found;
+    // Check floating nodes
+    return wf.definition.floatingNodes?.find((fn) => fn.id === nodeId);
+}
+/**
+ * Process a workflow event through the engine.
+ *
+ * 1. Loads current state + workflow plugin
+ * 2. Builds engine context (gate evaluation, role prompts)
+ * 3. Calls computeNextAction
+ * 4. Persists updated state
+ * 5. Returns the nextAction
+ */
+export async function processWorkflowEvent(workflowsDir, projectName, ctx, event) {
+    const state = await readState(projectName, ctx.number, ctx.dir);
+    const wf = await loadWorkflow(workflowsDir, state.workflow);
+    const ioCtx = {
+        contextDir: ctx.dir,
+        projectDir: ctx.entry.dir,
+        contextLabel: ctx.activeContext,
+    };
+    const engineCtx = await buildEngineContext(projectName, ctx.number, ctx.dir, wf, ioCtx);
+    const result = computeNextAction(wf.definition, state, event, engineCtx);
+    // Skip persisting state for read-only events (query_status doesn't modify state)
+    if (event.type !== 'query_status') {
+        await persistState(projectName, ctx.number, result.state, ctx.dir);
+    }
+    return {
+        state: result.state,
+        nextAction: result.nextAction,
+    };
+}
+/**
+ * Load the workflow plugin for a resolved context.
+ */
+export async function loadWorkflowForContext(workflowsDir, projectName, ctx) {
+    const state = await readState(projectName, ctx.number, ctx.dir);
+    const wf = await loadWorkflow(workflowsDir, state.workflow);
+    return { wf, state };
+}
+/**
+ * Format a nextAction into a human-readable message for the tool response.
+ */
+export function formatNextAction(nextAction) {
+    const lines = [];
+    switch (nextAction.type) {
+        case 'dispatch':
+            if (nextAction.parallelDispatch && nextAction.parallelDispatch.length > 1) {
+                lines.push(`\n[Next Action] Parallel dispatch: ${nextAction.parallelDispatch.length} tasks`);
+                for (const d of nextAction.parallelDispatch) {
+                    lines.push(`  - role "${d.role}" for node "${d.nodeId}"`);
+                }
+            }
+            else {
+                lines.push(`\n[Next Action] Dispatch role "${nextAction.role}" for node "${nextAction.nodeId}"`);
+            }
+            if (nextAction.instructions)
+                lines.push(nextAction.instructions);
+            break;
+        case 'write_artifact':
+            lines.push(`\n[Next Action] Write artifact`);
+            if (nextAction.instructions)
+                lines.push(nextAction.instructions);
+            break;
+        case 'approve_artifact':
+            lines.push(`\n[Next Action] Approve artifact`);
+            if (nextAction.instructions)
+                lines.push(nextAction.instructions);
+            break;
+        case 'wait':
+            lines.push(`\n[Next Action] ${nextAction.instructions}`);
+            break;
+        case 'completed':
+            lines.push(`\n[Next Action] Workflow completed!`);
+            break;
+        case 'failed':
+            lines.push(`\n[Workflow Failed] ${nextAction.instructions}`);
+            break;
+        case 'evaluate_gate':
+            lines.push(`\n[Next Action] Evaluate gate "${nextAction.nodeId}"`);
+            if (nextAction.instructions)
+                lines.push(nextAction.instructions);
+            break;
+        case 'none':
+            // No specific next action
+            break;
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=engine-helpers.js.map

package/build/tools/engine-helpers.js.map

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

package/build/tools/get-project-status.d.ts

@@ -1,10 +1,12 @@
 /**
  * MCP Tool: project_status
- * Read the current project status with rich context for PM decision-making.
- * Includes phase progress, documents, pending reviews, dispatch records,
- * active sessions, and intelligent next-step suggestions.
+ * Read the current project status with rich context for coordinator decision-making.
+ *
+ * Node-based architecture: displays workflow tree with node states instead of phases.
+ * Includes artifacts, pending reviews, dispatch records, active sessions,
+ * workflow engine nextAction, and intelligent next-step suggestions.
  *
  * When called without project_name, returns a summary list of all projects.
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerGetProjectStatus(server: McpServer, builtinDir: string, customDir: string): void;
+export declare function registerGetProjectStatus(server: McpServer, workflowsDir: string): void;