@s_s/harmonia 1.0.0

package/build/tools/dispatch-role.js

@@ -0,0 +1,232 @@
+/**
+ * MCP Tool: dispatch_role
+ *
+ * Prepare all data needed to hand off a task to a team member role.
+ * Returns: role prompt (with overrides injected), frontmatter config,
+ * input documents, task brief, and dispatch tracking info.
+ *
+ * Automatically:
+ * - Creates a dispatch record for tracking
+ * - Searches for reusable idle sessions and provides guidance
+ *
+ * This tool does NOT launch agents — it only prepares the data.
+ * The host agent (PM) decides how to pass this to the team member.
+ */
+import { z } from 'zod';
+import { loadWorkflow } from '../core/workflow.js';
+import { readState } from '../core/state.js';
+import { readDoc } from '../core/docs.js';
+import { getMergedOverrides, resolveRoleConfig } from '../core/overrides.js';
+import { createDispatch, findIdleSession } from '../core/dispatch.js';
+/**
+ * Build override instructions to inject into the role prompt.
+ */
+function buildOverrideSection(roleId, overrides) {
+    const roleOverrides = overrides.roles?.[roleId]?.capabilities;
+    if (!roleOverrides || Object.keys(roleOverrides).length === 0) {
+        return '';
+    }
+    const lines = [
+        '',
+        '## Enhanced Capabilities',
+        '',
+        'The following capabilities have been configured to use external tools.',
+        'Use the specified tool instead of built-in behavior for these actions.',
+        '',
+    ];
+    for (const [capId, override] of Object.entries(roleOverrides)) {
+        const o = override;
+        const toolRef = o.type === 'mcp' && o.server
+            ? `\`${o.server}\` MCP server's \`${o.tool}\` tool`
+            : `\`${o.tool}\` skill tool`;
+        let instruction = `- **${capId}**: Use ${toolRef}`;
+        if (o.params && Object.keys(o.params).length > 0) {
+            const paramStr = Object.entries(o.params)
+                .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+                .join(', ');
+            instruction += ` with fixed parameters: ${paramStr}`;
+        }
+        if (o.notes) {
+            instruction += `. Note: ${o.notes}`;
+        }
+        lines.push(instruction);
+    }
+    return lines.join('\n');
+}
+/**
+ * Find the current phase definition from the workflow.
+ */
+function findCurrentPhase(phases, currentPhaseId) {
+    return phases.find((p) => p.id === currentPhaseId);
+}
+/**
+ * Resolve expected output doc IDs for a dispatch.
+ * Uses the current phase's outputs, filtering out external, scale-skipped, and optional docs.
+ */
+function resolveExpectedOutputs(currentPhase, workflowDef, scale) {
+    if (!currentPhase)
+        return [];
+    return currentPhase.outputs.filter((docId) => {
+        const docDef = workflowDef.docs[docId];
+        if (!docDef)
+            return false;
+        if (docDef.external)
+            return false;
+        const scaleVal = docDef.scale[scale];
+        if (scaleVal === 'skip' || scaleVal === 'optional')
+            return false;
+        return true;
+    });
+}
+export function registerDispatchRole(server, workflowsDir) {
+    server.tool('dispatch_role', "Prepare all data needed to dispatch a task to a team member. Returns the role's prompt (with capability overrides), configuration, input documents, task brief, and a dispatch tracking ID. Automatically searches for reusable sessions and provides guidance. Does NOT launch agents — you (PM) decide how to pass this to the team member. After launching, call report_dispatch to register the session.", {
+        project_name: z.string().describe('Project name'),
+        role: z.string().describe('Role ID to dispatch (e.g. architect, developer, tester)'),
+        task_brief: z
+            .string()
+            .describe('Task description for the team member — what they need to do, which tasks from the breakdown, specific instructions, etc.'),
+        input_doc_ids: z
+            .array(z.string())
+            .optional()
+            .describe("Document IDs to include as input for the team member. If not specified, automatically uses the current phase's input docs."),
+    }, async ({ project_name, role, task_brief, input_doc_ids }) => {
+        try {
+            // Load project state and workflow
+            const state = await readState(project_name);
+            const wf = await loadWorkflow(workflowsDir, state.workflow);
+            // Validate role exists
+            const roleDef = wf.roles[role];
+            if (!roleDef) {
+                const available = Object.keys(wf.roles).join(', ');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Role "${role}" not found. Available: ${available}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Get merged overrides
+            const overrides = await getMergedOverrides(project_name);
+            // Build the full prompt with overrides injected
+            const overrideSection = buildOverrideSection(role, overrides);
+            const fullPrompt = overrideSection ? `${roleDef.prompt}\n${overrideSection}` : roleDef.prompt;
+            // Determine input docs
+            const currentPhase = findCurrentPhase(wf.definition.phases, state.currentPhase);
+            const docIds = input_doc_ids ?? currentPhase?.inputs ?? [];
+            // Read input documents (skip external docs like "code" — not managed by write_doc)
+            const inputDocs = {};
+            const missingDocs = [];
+            for (const docId of docIds) {
+                const docDef = wf.definition.docs[docId];
+                if (docDef?.external)
+                    continue; // external outputs not stored as docs
+                try {
+                    inputDocs[docId] = await readDoc(project_name, docId);
+                }
+                catch {
+                    missingDocs.push(docId);
+                }
+            }
+            // Resolve agent/model overrides
+            const roleConfig = resolveRoleConfig(role, overrides);
+            // Resolve expected outputs for this dispatch
+            const expectedOutputs = resolveExpectedOutputs(currentPhase, wf.definition, state.scale);
+            // Check for reusable idle session
+            const idleSession = await findIdleSession(project_name, role);
+            // Create dispatch record
+            const dispatch = await createDispatch(project_name, role, task_brief, expectedOutputs, idleSession?.id);
+            // Build session guidance
+            const sessionGuidance = buildSessionGuidance(idleSession, roleDef.frontmatter.session, roleConfig.agent);
+            // Build human-readable summary for the agent
+            const agentLine = roleConfig.agent ? `\n- Agent: ${roleConfig.agent}` : '';
+            const modelDisplay = roleConfig.model ?? roleDef.frontmatter.model;
+            const summary = [
+                `# Dispatch: ${role}`,
+                ``,
+                `## Dispatch Tracking`,
+                `- Dispatch ID: \`${dispatch.id}\``,
+                `- Status: ${dispatch.status}`,
+                ``,
+                `## Session Guidance`,
+                sessionGuidance,
+                ``,
+                `## Task Brief`,
+                task_brief,
+                ``,
+                `## Configuration`,
+                `- Model: ${modelDisplay}`,
+                `- Session: ${roleDef.frontmatter.session}`,
+                `- Parallel: ${roleDef.frontmatter.parallel}${agentLine}`,
+                ``,
+                `## Project Context`,
+                `- Project: ${project_name}`,
+                `- Directory: ${state.projectDir}`,
+                `- Scale: ${state.scale}`,
+                `- Current phase: ${state.currentPhase}`,
+                ``,
+                `## Input Documents (${Object.keys(inputDocs).length}${missingDocs.length > 0 ? `, ${missingDocs.length} missing` : ''})`,
+            ];
+            for (const [docId, content] of Object.entries(inputDocs)) {
+                summary.push(``, `### ${docId}`, ``, content);
+            }
+            if (missingDocs.length > 0) {
+                summary.push(``, `### Missing Documents`, ...missingDocs.map((d) => `- ${d}`));
+            }
+            summary.push(``, `## Next Step`, `After launching the agent, call \`report_dispatch\` with dispatch_id="${dispatch.id}" and the agent's session ID.`, `When the agent finishes, call \`report_dispatch\` again with status="completed" (or "failed").`, ``, `## Role Prompt`, ``, fullPrompt);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: summary.join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Build session guidance text based on whether an idle session exists.
+ */
+function buildSessionGuidance(idleSession, sessionType, agentOverride) {
+    if (idleSession) {
+        const agentId = idleSession.agentSessionId
+            ? `Agent session ID: \`${idleSession.agentSessionId}\``
+            : 'Agent session ID: not recorded';
+        const label = idleSession.label ? ` (${idleSession.label})` : '';
+        return [
+            `**Reusable session found**: ${idleSession.id}${label}`,
+            `- ${agentId}`,
+            `- Agent type: ${idleSession.agentType ?? 'unknown'}`,
+            `- Last active: ${idleSession.lastActiveAt}`,
+            ``,
+            `**Action**: Resume this session instead of launching a new agent.`,
+            idleSession.agentSessionId
+                ? `Use \`--resume ${idleSession.agentSessionId}\` or \`--session ${idleSession.agentSessionId}\` to restore the conversation.`
+                : `Note: No agent session ID was recorded for this session. You may need to launch a new agent.`,
+        ].join('\n');
+    }
+    return [
+        `**No reusable session found** for this role.`,
+        `Session type: ${sessionType}`,
+        ``,
+        `**Action**: Launch a new agent for this role.`,
+        agentOverride ? `Configured agent type: ${agentOverride}` : '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+//# sourceMappingURL=dispatch-role.js.map

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

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

package/build/tools/doc-tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tools: write_doc / read_doc / list_docs
+ * Read and write project documents under <data_dir>/<project_name>/docs/
+ *
+ * write_doc checks review configuration and auto-submits for review if needed.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDocTools(server: McpServer, workflowsDir: string): void;

package/build/tools/doc-tools.js

@@ -0,0 +1,102 @@
+/**
+ * MCP Tools: write_doc / read_doc / list_docs
+ * Read and write project documents under <data_dir>/<project_name>/docs/
+ *
+ * write_doc checks review configuration and auto-submits for review if needed.
+ */
+import { z } from 'zod';
+import { writeDoc, readDoc, listDocs } from '../core/docs.js';
+import { readState } from '../core/state.js';
+import { loadWorkflow } from '../core/workflow.js';
+import { getMergedOverrides, resolveDocReview } from '../core/overrides.js';
+import { submitForReview } from '../core/reviews.js';
+export function registerDocTools(server, workflowsDir) {
+    server.tool('write_doc', 'Write or update a project document. Automatically checks review configuration — if review is required, the document is submitted for user approval and you MUST present it to the user for confirmation before proceeding.', {
+        project_name: z.string().describe('Project name'),
+        doc_id: z
+            .string()
+            .describe('Document ID (e.g. prd, user-stories, fsd, prototype, tech-design, task-breakdown, etc.)'),
+        content: z.string().describe('Document content (markdown or HTML depending on doc type)'),
+    }, async ({ project_name, doc_id, content }) => {
+        // Load workflow to get doc definition (format, review defaults)
+        const state = await readState(project_name);
+        const wf = await loadWorkflow(workflowsDir, state.workflow);
+        const docDef = wf.definition.docs[doc_id];
+        // Write the document with correct extension
+        const filePath = await writeDoc(project_name, doc_id, content, docDef);
+        // Check if review is required
+        const overrides = await getMergedOverrides(project_name);
+        const needsReview = docDef ? resolveDocReview(doc_id, docDef, overrides) : false;
+        if (needsReview) {
+            await submitForReview(project_name, doc_id);
+            const docName = docDef?.name ?? doc_id;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `Document "${doc_id}" (${docName}) written to ${filePath}`,
+                            ``,
+                            `** REVIEW REQUIRED **`,
+                            `This document requires user approval before the workflow can proceed.`,
+                            `Please present the document content to the user and ask for their confirmation.`,
+                            `After user approval, call approve_doc with project_name="${project_name}" and doc_id="${doc_id}".`,
+                            `If the user requests changes, revise the document and call write_doc again.`,
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Document "${doc_id}" written to ${filePath}`,
+                },
+            ],
+        };
+    });
+    server.tool('read_doc', 'Read a project document from the project docs directory.', {
+        project_name: z.string().describe('Project name'),
+        doc_id: z.string().describe('Document ID to read'),
+    }, async ({ project_name, doc_id }) => {
+        try {
+            const docContent = await readDoc(project_name, doc_id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: docContent,
+                    },
+                ],
+            };
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Document "${doc_id}" not found. Use list_docs to see available documents.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool('list_docs', 'List all project documents in the project docs directory.', {
+        project_name: z.string().describe('Project name'),
+    }, async ({ project_name }) => {
+        const docs = await listDocs(project_name);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: docs.length > 0
+                        ? `Documents:\n${docs.map((d) => `- ${d}`).join('\n')}`
+                        : 'No documents found. Initialize a project first with project_init.',
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=doc-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-tools.js","sourceRoot":"","sources":["../../src/tools/doc-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,YAAoB;IACpE,MAAM,CAAC,IAAI,CACP,WAAW,EACX,4NAA4N,EAC5N;QACI,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACjD,MAAM,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CAAC,yFAAyF,CAAC;QACxG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;KAC5F,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACxC,gEAAgE;QAChE,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1C,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAEvE,8BAA8B;QAC9B,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEjF,IAAI,WAAW,EAAE,CAAC;YACd,MAAM,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC;YACvC,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACF,aAAa,MAAM,MAAM,OAAO,gBAAgB,QAAQ,EAAE;4BAC1D,EAAE;4BACF,uBAAuB;4BACvB,uEAAuE;4BACvE,iFAAiF;4BACjF,4DAA4D,YAAY,iBAAiB,MAAM,IAAI;4BACnG,6EAA6E;yBAChF,CAAC,IAAI,CAAC,IAAI,CAAC;qBACf;iBACJ;aACJ,CAAC;QACN,CAAC;QAED,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,aAAa,MAAM,gBAAgB,QAAQ,EAAE;iBACtD;aACJ;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,IAAI,CACP,UAAU,EACV,0DAA0D,EAC1D;QACI,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;KACrD,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;QAC/B,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACvD,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAU;qBACnB;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,aAAa,MAAM,wDAAwD;qBACpF;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,IAAI,CACP,WAAW,EACX,2DAA2D,EAC3D;QACI,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;KACpD,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC1C,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAe;oBACrB,IAAI,EACA,IAAI,CAAC,MAAM,GAAG,CAAC;wBACX,CAAC,CAAC,eAAe,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBACvD,CAAC,CAAC,mEAAmE;iBAChF;aACJ;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * MCP Tool: get_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.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetProjectStatus(server: McpServer, workflowsDir: string): void;

package/build/tools/get-project-status.js

@@ -0,0 +1,230 @@
+/**
+ * MCP Tool: get_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.
+ */
+import { z } from 'zod';
+import { readState } from '../core/state.js';
+import { loadWorkflow } from '../core/workflow.js';
+import { listDocs } from '../core/docs.js';
+import { readReviews } from '../core/reviews.js';
+import { getMergedOverrides } from '../core/overrides.js';
+import { readDispatches, readSessions } from '../core/dispatch.js';
+/**
+ * Derive next-step suggestions based on current project state, including dispatch awareness.
+ */
+function deriveNextSteps(state, wf, existingDocs, pendingReviews, dispatches, sessions) {
+    const suggestions = [];
+    const currentPhaseDef = wf.definition.phases.find((p) => p.id === state.currentPhase);
+    if (!currentPhaseDef)
+        return ['Unknown phase — check project state.'];
+    // If there are pending reviews, those block progress
+    if (pendingReviews.length > 0) {
+        const docNames = pendingReviews.map((r) => r.docId).join(', ');
+        suggestions.push(`Review pending documents: ${docNames}. Present them to the user and call approve_doc after user feedback.`);
+    }
+    // Check dispatch states — find dispatches that need attention
+    const activeDispatches = dispatches.filter((d) => d.status === 'dispatched' || d.status === 'running');
+    const dispatchedNotRunning = dispatches.filter((d) => d.status === 'dispatched');
+    const runningDispatches = dispatches.filter((d) => d.status === 'running');
+    const failedDispatches = dispatches.filter((d) => d.status === 'failed');
+    if (dispatchedNotRunning.length > 0) {
+        for (const d of dispatchedNotRunning) {
+            suggestions.push(`Dispatch ${d.id} (${d.role}) is created but not yet launched. Launch the agent and call report_dispatch to register it.`);
+        }
+    }
+    if (runningDispatches.length > 0) {
+        for (const d of runningDispatches) {
+            const session = sessions.find((s) => s.id === d.sessionId);
+            const agentInfo = session?.agentSessionId ? ` (agent session: ${session.agentSessionId})` : '';
+            suggestions.push(`Dispatch ${d.id} (${d.role}) is running${agentInfo}. Check if the agent has finished, then call report_dispatch with status="completed" or "failed".`);
+        }
+    }
+    if (failedDispatches.length > 0) {
+        for (const d of failedDispatches) {
+            const reason = d.note ? ` Reason: ${d.note}` : '';
+            suggestions.push(`Dispatch ${d.id} (${d.role}) failed.${reason} Consider re-dispatching with dispatch_role.`);
+        }
+    }
+    // Check which phase outputs are still missing
+    // Skip external outputs (e.g. "code"), docs that are "skip", and "optional" docs at the current scale
+    const missingOutputs = currentPhaseDef.outputs.filter((o) => {
+        const docDef = wf.definition.docs[o];
+        if (docDef?.external)
+            return false;
+        const scaleVal = docDef?.scale[state.scale];
+        if (scaleVal === 'skip' || scaleVal === 'optional')
+            return false;
+        return !existingDocs.includes(o);
+    });
+    if (missingOutputs.length > 0) {
+        // Only suggest dispatching if there are no active dispatches already covering this
+        const alreadyDispatched = activeDispatches.length > 0;
+        const nonPmRoles = currentPhaseDef.roles.filter((r) => r !== 'pm');
+        if (nonPmRoles.length > 0 && !alreadyDispatched) {
+            suggestions.push(`Dispatch ${nonPmRoles.join(', ')} to produce: ${missingOutputs.join(', ')}. Use dispatch_role to prepare task data.`);
+        }
+        else if (nonPmRoles.length === 0) {
+            suggestions.push(`Produce remaining documents: ${missingOutputs.join(', ')}. Use write_doc for each.`);
+        }
+    }
+    else if (pendingReviews.length === 0 && activeDispatches.length === 0) {
+        // All outputs exist, no pending reviews, no active dispatches — can advance
+        suggestions.push(`All outputs for "${currentPhaseDef.name}" are complete. Advance with: update_phase(project_name, "${state.currentPhase}", "completed")`);
+    }
+    // Check for lost sessions
+    const lostSessions = sessions.filter((s) => s.status === 'lost');
+    if (lostSessions.length > 0) {
+        for (const s of lostSessions) {
+            suggestions.push(`Session ${s.id} (${s.role}) is marked as lost. The agent may have crashed. Consider re-dispatching this role.`);
+        }
+    }
+    // If no suggestions yet, provide a generic one
+    if (suggestions.length === 0) {
+        suggestions.push(`Continue working on the "${currentPhaseDef.name}" phase.`);
+    }
+    return suggestions;
+}
+/**
+ * Format a dispatch record for display.
+ */
+function formatDispatch(d, sessions) {
+    const statusIcon = d.status === 'completed'
+        ? '✓'
+        : d.status === 'running'
+            ? '→'
+            : d.status === 'failed'
+                ? '✗'
+                : d.status === 'cancelled'
+                    ? '—'
+                    : '○';
+    const session = sessions.find((s) => s.id === d.sessionId);
+    const sessionInfo = session?.agentSessionId ? ` session:${session.agentSessionId}` : '';
+    const note = d.note ? ` (${d.note})` : '';
+    const brief = d.taskBrief.length > 60 ? d.taskBrief.slice(0, 57) + '...' : d.taskBrief;
+    return `  ${statusIcon} ${d.id}  ${d.role.padEnd(12)} [${d.status}]  ${brief}${sessionInfo}${note}`;
+}
+/**
+ * Format a session record for display.
+ */
+function formatSession(s) {
+    const agentInfo = s.agentSessionId ? `agent:${s.agentSessionId}` : 'no agent ID';
+    const label = s.label ? ` (${s.label})` : '';
+    const agentType = s.agentType ? ` via ${s.agentType}` : '';
+    return `  ${s.id}  ${s.role.padEnd(12)} [${s.status}]  ${agentInfo}${agentType}${label}`;
+}
+export function registerGetProjectStatus(server, workflowsDir) {
+    server.tool('get_project_status', 'Get the current project status including phase progress, documents, pending reviews, dispatch records, active sessions, and next-step suggestions.', {
+        project_name: z.string().describe('Project name'),
+    }, async ({ project_name }) => {
+        try {
+            const state = await readState(project_name);
+            const wf = await loadWorkflow(workflowsDir, state.workflow);
+            const docs = await listDocs(project_name);
+            const reviews = await readReviews(project_name);
+            const overrides = await getMergedOverrides(project_name);
+            const dispatches = await readDispatches(project_name);
+            const sessions = await readSessions(project_name);
+            // Phase summary
+            const phasesSummary = state.phases
+                .map((p) => {
+                const def = wf.definition.phases.find((pd) => pd.id === p.id);
+                const marker = p.id === state.currentPhase ? ' <-- current' : '';
+                const name = def ? ` (${def.name})` : '';
+                return `  ${p.id}${name}: ${p.status}${p.blockedReason ? ` [blocked: ${p.blockedReason}]` : ''}${marker}`;
+            })
+                .join('\n');
+            const currentPhaseDef = wf.definition.phases.find((p) => p.id === state.currentPhase);
+            // Categorize documents
+            const pendingReviews = Object.values(reviews).filter((r) => r.status === 'pending');
+            // Build pending reviews section
+            const pendingSection = pendingReviews.length > 0
+                ? pendingReviews
+                    .map((r) => `- ${r.docId} (submitted: ${r.submittedAt.split('T')[0]})`)
+                    .join('\n')
+                : '(none)';
+            // Build documents section with status
+            const docsSection = docs.length > 0
+                ? docs
+                    .map((d) => {
+                    const review = reviews[d];
+                    if (!review)
+                        return `- ${d}`;
+                    return `- ${d} [${review.status}]`;
+                })
+                    .join('\n')
+                : '(none yet)';
+            // Build sessions section
+            const activeSessions = sessions.filter((s) => s.status !== 'closed');
+            const sessionsSection = activeSessions.length > 0 ? activeSessions.map((s) => formatSession(s)).join('\n') : '(none)';
+            // Build dispatches section
+            const dispatchesSection = dispatches.length > 0 ? dispatches.map((d) => formatDispatch(d, sessions)).join('\n') : '(none)';
+            // Derive next steps (now dispatch-aware)
+            const nextSteps = deriveNextSteps(state, wf, docs, pendingReviews, dispatches, sessions);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `# Project Status: ${state.projectName}`,
+                            ``,
+                            `Source directory: ${state.projectDir}`,
+                            `Workflow: ${state.workflow}`,
+                            `Scale: ${state.scale}`,
+                            `Created: ${state.createdAt}`,
+                            `Updated: ${state.updatedAt}`,
+                            ``,
+                            `## Phases`,
+                            phasesSummary,
+                            ``,
+                            `## Current Phase`,
+                            currentPhaseDef
+                                ? `${currentPhaseDef.name} (${currentPhaseDef.id}): ${currentPhaseDef.description}`
+                                : 'Unknown',
+                            currentPhaseDef?.roles ? `Roles: ${currentPhaseDef.roles.join(', ')}` : '',
+                            currentPhaseDef?.outputs
+                                ? `Expected outputs: ${currentPhaseDef.outputs
+                                    .filter((o) => {
+                                    const d = wf.definition.docs[o];
+                                    if (!d)
+                                        return true;
+                                    const sv = d.scale[state.scale];
+                                    return sv !== 'skip' && sv !== 'optional';
+                                })
+                                    .join(', ')}`
+                                : '',
+                            ``,
+                            `## Sessions`,
+                            sessionsSection,
+                            ``,
+                            `## Dispatches`,
+                            dispatchesSection,
+                            ``,
+                            `## Pending Reviews`,
+                            pendingSection,
+                            ``,
+                            `## Documents`,
+                            docsSection,
+                            ``,
+                            `## Next Steps`,
+                            nextSteps.map((s, i) => `${i + 1}. ${s}`).join('\n'),
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Project not initialized. Use project_init to get started.',
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-project-status.js.map

package/build/tools/get-project-status.js.map

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

package/build/tools/get-role-prompt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Tool: get_role_prompt
+ * Retrieve the prompt and configuration for a specific role,
+ * with capability overrides injected into the prompt.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetRolePrompt(server: McpServer, workflowsDir: string): void;