@s_s/harmonia 1.0.0

package/build/tools/get-role-prompt.js

@@ -0,0 +1,95 @@
+/**
+ * MCP Tool: get_role_prompt
+ * Retrieve the prompt and configuration for a specific role,
+ * with capability overrides injected into the prompt.
+ */
+import { z } from 'zod';
+import { loadWorkflow } from '../core/workflow.js';
+import { getMergedOverrides } from '../core/overrides.js';
+/**
+ * Generate override prompt instructions for a role based on configured overrides.
+ */
+function buildOverridePromptSection(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.',
+        'When performing these actions, use the specified tool instead of built-in behavior.',
+        '',
+    ];
+    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');
+}
+export function registerGetRolePrompt(server, workflowsDir) {
+    server.tool('get_role_prompt', "Get the system prompt and configuration for a specific role in the workflow. Includes any capability overrides configured at global or project level. Use this to understand what a role does or to set up an agent with the role's prompt.", {
+        workflow: z.string().default('dev').describe('Workflow name (default: dev)'),
+        role: z.string().describe('Role ID (e.g. pm, architect, developer, tester)'),
+        project_name: z
+            .string()
+            .optional()
+            .describe('Project name — if provided, includes project-specific capability overrides in the prompt'),
+    }, async ({ workflow: workflowName, role, project_name }) => {
+        const wf = await loadWorkflow(workflowsDir, workflowName);
+        const roleDef = wf.roles[role];
+        if (!roleDef) {
+            const available = Object.keys(wf.roles).join(', ');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Role "${role}" not found in workflow "${workflowName}". Available roles: ${available}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Build override section if project_name is provided
+        let overrideSection = '';
+        if (project_name) {
+            const overrides = await getMergedOverrides(project_name);
+            overrideSection = buildOverridePromptSection(role, overrides);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `# Role: ${roleDef.id}`,
+                        ``,
+                        `## Configuration`,
+                        `- Model level: ${roleDef.frontmatter.model}`,
+                        `- Session: ${roleDef.frontmatter.session}`,
+                        `- Parallel: ${roleDef.frontmatter.parallel}`,
+                        ``,
+                        `## Prompt`,
+                        ``,
+                        roleDef.prompt,
+                        overrideSection,
+                    ].join('\n'),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-role-prompt.js.map

package/build/tools/get-role-prompt.js.map

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

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

@@ -0,0 +1,6 @@
+/**
+ * MCP Tools: set_override / get_overrides
+ * Manage capability overrides and review settings.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerOverrideTools(server: McpServer): void;

package/build/tools/override-tools.js

@@ -0,0 +1,129 @@
+/**
+ * MCP Tools: set_override / get_overrides
+ * Manage capability overrides and review settings.
+ */
+import { z } from 'zod';
+import { setCapabilityOverride, setReviewOverride, getMergedOverrides, readGlobalOverrides, readProjectOverrides, } from '../core/overrides.js';
+export function registerOverrideTools(server) {
+    server.tool('set_capability_override', 'Configure a role capability to use an external skill or MCP tool instead of the built-in behavior. Settings are saved to the override config file.', {
+        scope: z.enum(['global', 'project']).describe('Override scope: global (all projects) or project-specific'),
+        project_name: z.string().optional().describe("Project name (required when scope is 'project')"),
+        role_id: z.string().describe('Role ID (e.g. pm, architect, developer, tester)'),
+        capability_id: z.string().describe('Capability ID (e.g. write-prd, write-tech-design)'),
+        type: z.enum(['skill', 'mcp']).describe('Tool source type'),
+        tool: z.string().describe('Tool name'),
+        server_name: z.string().optional().describe("MCP server name (required when type is 'mcp')"),
+        params: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Static parameters to always pass when calling the tool'),
+        notes: z.string().optional().describe('Additional notes for prompt generation (rarely needed)'),
+    }, async ({ scope, project_name, role_id, capability_id, type, tool, server_name, params, notes }) => {
+        if (scope === 'project' && !project_name) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: "Error: project_name is required when scope is 'project'.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const override = { type, tool };
+        if (server_name)
+            override.server = server_name;
+        if (params)
+            override.params = params;
+        if (notes)
+            override.notes = notes;
+        await setCapabilityOverride(scope, project_name ?? null, role_id, capability_id, override);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Override set: ${role_id}.${capability_id} → ${type === 'mcp' ? `${server_name}/${tool}` : tool} (${scope})`,
+                },
+            ],
+        };
+    });
+    server.tool('set_review_override', 'Enable or disable review requirement for a specific document type.', {
+        scope: z.enum(['global', 'project']).describe('Override scope: global or project-specific'),
+        project_name: z.string().optional().describe("Project name (required when scope is 'project')"),
+        doc_id: z.string().describe('Document ID (e.g. prd, prototype)'),
+        enabled: z.boolean().describe('true = require review, false = skip review'),
+    }, async ({ scope, project_name, doc_id, enabled }) => {
+        if (scope === 'project' && !project_name) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: "Error: project_name is required when scope is 'project'.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        await setReviewOverride(scope, project_name ?? null, doc_id, enabled);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Review override set: ${doc_id} → ${enabled ? 'required' : 'skipped'} (${scope})`,
+                },
+            ],
+        };
+    });
+    server.tool('get_overrides', 'Get the current override configuration. Shows the merged result (project + global) or a specific scope.', {
+        project_name: z
+            .string()
+            .optional()
+            .describe('Project name — if provided, shows merged config for this project'),
+        scope: z
+            .enum(['merged', 'global', 'project'])
+            .default('merged')
+            .describe('Which config to show: merged (default), global only, or project only'),
+    }, async ({ project_name, scope }) => {
+        let config;
+        let label;
+        if (scope === 'global') {
+            config = await readGlobalOverrides();
+            label = 'Global overrides';
+        }
+        else if (scope === 'project') {
+            if (!project_name) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: "Error: project_name is required when scope is 'project'.",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            config = await readProjectOverrides(project_name);
+            label = `Project overrides for "${project_name}"`;
+        }
+        else {
+            if (!project_name) {
+                config = await readGlobalOverrides();
+                label = 'Global overrides (no project specified)';
+            }
+            else {
+                config = await getMergedOverrides(project_name);
+                label = `Merged overrides for "${project_name}"`;
+            }
+        }
+        const isEmpty = !config.review && (!config.roles || Object.keys(config.roles).length === 0);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: isEmpty ? `${label}: (none configured)` : `${label}:\n${JSON.stringify(config, null, 2)}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=override-tools.js.map

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

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

package/build/tools/project-init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Tool: project_init
+ * Initialize a new Harmonia project with global registry and data directory.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectInit(server: McpServer, workflowsDir: string): void;

package/build/tools/project-init.js

@@ -0,0 +1,71 @@
+/**
+ * MCP Tool: project_init
+ * Initialize a new Harmonia project with global registry and data directory.
+ */
+import { z } from 'zod';
+import { loadWorkflow } from '../core/workflow.js';
+import { initProjectState, readState } from '../core/state.js';
+import { registerProject, getProject } from '../core/registry.js';
+export function registerProjectInit(server, workflowsDir) {
+    server.tool('project_init', "Initialize a new Harmonia project. Registers the project in the global data directory, creates data directories for documents/state, and creates the project source directory if it doesn't exist.", {
+        project_name: z.string().describe('Unique project name (used as directory name in the data directory)'),
+        project_dir: z
+            .string()
+            .describe("Absolute path to the project source directory (will be created if it doesn't exist)"),
+        workflow: z.string().default('dev').describe('Workflow name to use (default: dev)'),
+        scale: z.enum(['small', 'medium', 'large']).default('small').describe('Project scale (small/medium/large)'),
+    }, async ({ project_name, project_dir, workflow: workflowName, scale }) => {
+        // Check if already initialized
+        const existing = await getProject(project_name);
+        if (existing) {
+            const state = await readState(project_name);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Project "${project_name}" already exists.\n\nSource directory: ${existing.dir}\n\nCurrent state:\n${JSON.stringify(state, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        // Load workflow definition
+        const wf = await loadWorkflow(workflowsDir, workflowName);
+        // Register project (creates global data dirs + project source dir)
+        await registerProject(project_name, project_dir, workflowName);
+        // Initialize project state
+        const state = await initProjectState(project_name, project_dir, wf, scale);
+        // Build doc list based on scale
+        const requiredDocs = Object.entries(wf.definition.docs)
+            .filter(([, doc]) => {
+            const s = doc.scale[scale];
+            return s === 'full' || s === 'lite';
+        })
+            .map(([id, doc]) => `- ${doc.name} (${id})`)
+            .join('\n');
+        const optionalDocs = Object.entries(wf.definition.docs)
+            .filter(([, doc]) => doc.scale[scale] === 'optional')
+            .map(([id, doc]) => `- ${doc.name} (${id})`)
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `Project "${project_name}" initialized successfully.`,
+                        ``,
+                        `Source directory: ${project_dir}`,
+                        `Workflow: ${wf.definition.name} (${wf.definition.description})`,
+                        `Scale: ${scale}`,
+                        `Current phase: ${state.currentPhase}`,
+                        `Available roles: ${Object.keys(wf.roles).join(', ')}`,
+                        ``,
+                        `Required documents:`,
+                        requiredDocs || '(none)',
+                        optionalDocs ? `\nOptional documents:\n${optionalDocs}` : '',
+                    ].join('\n'),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=project-init.js.map

package/build/tools/project-init.js.map

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

package/build/tools/report-dispatch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Tool: report_dispatch
+ *
+ * PM 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
+ *
+ * This is the single tool PM needs for all dispatch lifecycle management.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerReportDispatch(server: McpServer): void;

package/build/tools/report-dispatch.js

@@ -0,0 +1,142 @@
+/**
+ * MCP Tool: report_dispatch
+ *
+ * PM 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
+ *
+ * This is the single tool PM needs for all dispatch lifecycle management.
+ */
+import { z } from 'zod';
+import { getDispatch, updateDispatch, createSession, updateSession, findSessionByAgentId, readSessions, } from '../core/dispatch.js';
+export function registerReportDispatch(server) {
+    server.tool('report_dispatch', '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.', {
+        project_name: z.string().describe('Project name'),
+        dispatch_id: z.string().describe('Dispatch ID returned by dispatch_role'),
+        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 {
+            // Load the dispatch record
+            const dispatch = await getDispatch(project_name, dispatch_id);
+            if (!dispatch) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Dispatch "${dispatch_id}" not found in project "${project_name}".`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const effectiveStatus = status ?? 'running';
+            const results = [];
+            // Handle session registration (when agent_session_id is provided)
+            let session = null;
+            if (agent_session_id) {
+                session = await resolveOrCreateSession(project_name, dispatch, agent_session_id, agent_type, label);
+                results.push(`Session: ${session.id} (agent: ${agent_session_id}, status: ${session.status})`);
+            }
+            // Handle status transitions
+            if (effectiveStatus === 'completed' ||
+                effectiveStatus === 'failed' ||
+                effectiveStatus === 'cancelled') {
+                // Terminal states: update dispatch and transition session
+                await updateDispatch(project_name, dispatch_id, {
+                    status: effectiveStatus,
+                    ...(session ? { sessionId: session.id } : {}),
+                    ...(note ? { note } : {}),
+                });
+                // Transition session: completed → idle, failed → lost
+                const sessionId = session?.id ?? dispatch.sessionId;
+                if (sessionId) {
+                    const newSessionStatus = effectiveStatus === 'completed' ? 'idle' : 'lost';
+                    await updateSession(project_name, sessionId, { status: newSessionStatus });
+                    results.push(`Session ${sessionId} → ${newSessionStatus}`);
+                }
+                results.push(`Dispatch ${dispatch_id} → ${effectiveStatus}`);
+            }
+            else {
+                // Running: update dispatch status + associate session
+                await updateDispatch(project_name, dispatch_id, {
+                    status: 'running',
+                    ...(session ? { sessionId: session.id } : {}),
+                    ...(note ? { note } : {}),
+                });
+                // Mark session as active
+                const sessionId = session?.id ?? dispatch.sessionId;
+                if (sessionId) {
+                    await updateSession(project_name, sessionId, { status: 'active' });
+                }
+                results.push(`Dispatch ${dispatch_id} → running`);
+            }
+            // Build response
+            const nextStepHint = effectiveStatus === 'running'
+                ? `\nNext: When the agent finishes, call report_dispatch with dispatch_id="${dispatch_id}" and status="completed" (or "failed").`
+                : `\nNext: Call get_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}`,
+                    },
+                ],
+            };
+        }
+        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, dispatch, agentSessionId, agentType, label) {
+    // If the dispatch already has a session, update it with the agent session ID
+    if (dispatch.sessionId) {
+        const sessions = await readSessions(projectName);
+        const existing = sessions.find((s) => s.id === dispatch.sessionId);
+        if (existing) {
+            return await updateSession(projectName, existing.id, {
+                agentSessionId,
+                ...(agentType ? { agentType } : {}),
+                ...(label ? { label } : {}),
+                status: 'active',
+            });
+        }
+    }
+    // Check if a session with this agent session ID already exists for this role
+    const existingByAgent = await findSessionByAgentId(projectName, dispatch.role, agentSessionId);
+    if (existingByAgent) {
+        return await updateSession(projectName, existingByAgent.id, {
+            status: 'active',
+            ...(agentType ? { agentType } : {}),
+            ...(label ? { label } : {}),
+        });
+    }
+    // Create a new session
+    const session = await createSession(projectName, dispatch.role, agentType, label);
+    return await updateSession(projectName, session.id, { agentSessionId });
+}
+//# sourceMappingURL=report-dispatch.js.map

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

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

package/build/tools/setup-project.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tool: setup_project
+ *
+ * Inject Harmonia PM guidance into the host agent's config file (e.g. AGENTS.md).
+ * This makes the host agent aware of Harmonia tools and the PM workflow.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSetupProject(server: McpServer): void;

package/build/tools/setup-project.js

@@ -0,0 +1,88 @@
+/**
+ * MCP Tool: setup_project
+ *
+ * Inject Harmonia PM guidance into the host agent's config file (e.g. AGENTS.md).
+ * This makes the host agent aware of Harmonia tools and the PM workflow.
+ */
+import { z } from 'zod';
+import { readState } from '../core/state.js';
+import { detectHostAgent, injectPrompt } from '../setup/inject.js';
+export function registerSetupProject(server) {
+    server.tool('setup_project', "Inject Harmonia PM guidance into the host agent's config file (AGENTS.md / CLAUDE.md). Makes the host agent aware of all Harmonia tools and the PM workflow. Requires project_init to be called first. Idempotent — safe to call multiple times.", {
+        project_name: z.string().describe('Project name (must be initialized)'),
+        agent_type: z
+            .enum(['opencode', 'claude-code', 'codex'])
+            .optional()
+            .describe('Host agent type. If not specified, auto-detects based on project directory contents.'),
+    }, async ({ project_name, agent_type }) => {
+        try {
+            // Ensure project is initialized
+            const state = await readState(project_name);
+            // Detect or use specified agent type
+            const detectedType = agent_type ?? (await detectHostAgent(state.projectDir));
+            // Inject the prompt
+            const result = await injectPrompt(state.projectDir, detectedType, {
+                projectName: state.projectName,
+                projectDir: state.projectDir,
+                workflow: state.workflow,
+                scale: state.scale,
+            });
+            const action = result.created ? 'Created' : result.replaced ? 'Updated' : 'Appended to';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `# Setup Complete`,
+                            ``,
+                            `${action} **${result.filePath}** with Harmonia PM guidance.`,
+                            ``,
+                            `## Configuration`,
+                            `- Agent type: ${detectedType}`,
+                            `- Project: ${state.projectName}`,
+                            `- Workflow: ${state.workflow}`,
+                            `- Scale: ${state.scale}`,
+                            ``,
+                            `## What was injected`,
+                            `- Project Manager role definition and responsibilities`,
+                            `- Full tool reference (${15} Harmonia tools)`,
+                            `- Phase-by-phase workflow guide`,
+                            `- Document review flow`,
+                            `- Team member dispatch guide`,
+                            `- Important rules for PM behavior`,
+                            ``,
+                            `## Next Steps`,
+                            `The host agent will now follow the PM workflow automatically.`,
+                            `Start by calling \`get_project_status\` to see where the project stands.`,
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // Check if it's a "project not found" error
+            if (message.includes('ENOENT') || message.includes('not found')) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Project "${project_name}" not initialized. Call project_init first, then setup_project.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=setup-project.js.map

package/build/tools/setup-project.js.map

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

package/build/tools/update-phase.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Tool: update_phase
+ * Advance or update the status of a project phase.
+ * When completing a phase, checks that all doc-type outputs exist (output guard).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerUpdatePhase(server: McpServer, workflowsDir: string): void;