@s_s/harmonia 1.2.0 → 1.4.0

package/build/tools/report-dispatch.js

@@ -1,194 +0,0 @@
-/**
- * MCP Tool: dispatch_report
- *
- * 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
- *
- * 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 { z } from 'zod';
-import { getDispatch, updateDispatch, createSession, updateSession, findSessionByAgentId, readSessions, isValidTransition, isTerminalStatus, } from '../core/dispatch.js';
-import { listDocs } from '../core/docs.js';
-import { readState } from '../core/state.js';
-import { loadWorkflow } from '../core/workflow.js';
-import { getProject } from '../core/registry.js';
-export function registerReportDispatch(server, builtinDir, customDir) {
-    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.', {
-        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 {
-            // Resolve current iteration
-            const entry = await getProject(project_name);
-            if (!entry || entry.currentIteration === 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `项目 "${project_name}" 未找到或尚未开始迭代。请先调用 iteration_start。`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const iteration = entry.currentIteration;
-            // Load the dispatch record
-            const dispatch = await getDispatch(project_name, iteration, 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 = [];
-            // Guard: state machine — reject invalid transitions
-            if (!isValidTransition(dispatch.status, effectiveStatus)) {
-                const reason = isTerminalStatus(dispatch.status)
-                    ? `dispatch "${dispatch_id}" 已处于终态 "${dispatch.status}"，无法转换到 "${effectiveStatus}"`
-                    : `dispatch "${dispatch_id}" 当前状态 "${dispatch.status}" 不允许转换到 "${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, iteration, 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, iteration, 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, iteration, 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, iteration, 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, iteration, sessionId, { status: 'active' });
-                }
-                results.push(`Dispatch ${dispatch_id} → running`);
-            }
-            // Completion check: warn if expectedOutputs are missing
-            if (effectiveStatus === 'completed' && dispatch.expectedOutputs.length > 0) {
-                const existingDocs = await listDocs(project_name, iteration);
-                const state = await readState(project_name, iteration);
-                const wf = await loadWorkflow(builtinDir, customDir, state.workflow);
-                const missingOutputs = dispatch.expectedOutputs.filter((docId) => {
-                    const docDef = wf.definition.docs[docId];
-                    if (docDef?.external)
-                        return false; // external docs not tracked
-                    return !existingDocs.includes(docId);
-                });
-                if (missingOutputs.length > 0) {
-                    results.push(`\n⚠ 预期产出文档缺失: ${missingOutputs.join(', ')}`);
-                    results.push('请确认角色是否已通过 doc_write 提交了所有产出。');
-                }
-            }
-            // 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}`,
-                    },
-                ],
-            };
-        }
-        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) {
-    // If the dispatch already has a session, update it with the agent session ID
-    if (dispatch.sessionId) {
-        const sessions = await readSessions(projectName, iteration);
-        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',
-            });
-        }
-    }
-    // Check if a session with this agent session ID already exists for this role
-    const existingByAgent = await findSessionByAgentId(projectName, iteration, dispatch.role, agentSessionId);
-    if (existingByAgent) {
-        return await updateSession(projectName, iteration, existingByAgent.id, {
-            status: 'active',
-            ...(agentType ? { agentType } : {}),
-            ...(label ? { label } : {}),
-        });
-    }
-    // Create a new session
-    const session = await createSession(projectName, iteration, dispatch.role, agentType, label);
-    return await updateSession(projectName, iteration, session.id, { agentSessionId });
-}
-//# sourceMappingURL=report-dispatch.js.map

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

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

package/build/tools/set-scale.d.ts

@@ -1,6 +0,0 @@
-/**
- * MCP Tool: project_set_scale
- * Set the project scale after PRD approval. Scale is immutable once set.
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerSetScale(server: McpServer, builtinDir: string, customDir: string): void;

package/build/tools/set-scale.js

@@ -1,107 +0,0 @@
-/**
- * MCP Tool: project_set_scale
- * Set the project scale after PRD approval. Scale is immutable once set.
- */
-import { z } from 'zod';
-import { readState, setScale } from '../core/state.js';
-import { loadWorkflow } from '../core/workflow.js';
-import { readReviews } from '../core/reviews.js';
-import { getProject } from '../core/registry.js';
-export function registerSetScale(server, builtinDir, customDir) {
-    server.tool('project_set_scale', 'Set the project scale after PRD approval. Scale determines which documents are required (full/lite/skip) and enables sequential mode for medium/large projects. Scale is immutable once set — if requirements change significantly, redo the PRD.', {
-        project_name: z.string().describe('项目名称'),
-        scale: z.enum(['small', 'medium', 'large']).describe('项目规模 (small/medium/large)'),
-    }, async ({ project_name, scale }) => {
-        try {
-            // Resolve current iteration
-            const entry = await getProject(project_name);
-            if (!entry || entry.currentIteration === 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `项目 "${project_name}" 未找到或尚未开始迭代。请先调用 iteration_start。`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const iteration = entry.currentIteration;
-            // Check project exists
-            const state = await readState(project_name, iteration);
-            // Guard: scale already set
-            if (state.scale !== null) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Scale 已设定为 "${state.scale}"，不可更改。如需调整规模，请重新评估 PRD。`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            // Guard: PRD must be approved
-            const reviews = await readReviews(project_name, iteration);
-            const prdReview = reviews['prd'];
-            if (!prdReview || prdReview.status !== 'approved') {
-                const prdStatus = prdReview ? prdReview.status : '未提交';
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `无法设定 scale：PRD 尚未审批通过（当前状态: ${prdStatus}）。请先完成 PRD 编写和审批，再设定项目规模。`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            // Set scale
-            const updated = await setScale(project_name, iteration, scale);
-            // Build doc list based on scale
-            const wf = await loadWorkflow(builtinDir, customDir, state.workflow);
-            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_name}" 规模已设定为 "${scale}"。`,
-                            ``,
-                            `必需文档:`,
-                            requiredDocs || '(无)',
-                            optionalDocs ? `\n可选文档:\n${optionalDocs}` : '',
-                            ``,
-                            `当前阶段: ${updated.currentPhase}`,
-                            scale !== 'small'
-                                ? `\n注意: ${scale} 规模项目的 PRD、tech-design、task-breakdown 等文档将启用分步写入模式。`
-                                : '',
-                        ].join('\n'),
-                    },
-                ],
-            };
-        }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-}
-//# sourceMappingURL=set-scale.js.map

package/build/tools/set-scale.js.map

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

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

@@ -1,8 +0,0 @@
-/**
- * MCP Tool: project_setup
- *
- * 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

@@ -1,116 +0,0 @@
-/**
- * MCP Tool: project_setup
- *
- * 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 { getGlobalDir } from '../core/registry.js';
-import { detectHostAgent, injectPrompt } from '../setup/inject.js';
-import { installHooks } from '../hooks/install.js';
-export function registerSetupProject(server) {
-    server.tool('project_setup', "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', 'openclaw'])
-            .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,
-            });
-            // Install agent hooks (boundary guard + proactive reminders)
-            let hookStatus = '';
-            try {
-                const hookResult = await installHooks(detectedType, {
-                    dataDir: getGlobalDir(),
-                    projectName: state.projectName,
-                    projectDir: state.projectDir,
-                });
-                if (hookResult.success) {
-                    hookStatus = `Installed (${hookResult.filesWritten.length} files)`;
-                    if (hookResult.warnings.length > 0) {
-                        hookStatus += ` — warnings: ${hookResult.warnings.join('; ')}`;
-                    }
-                }
-                else {
-                    hookStatus = `Failed: ${hookResult.error ?? 'unknown error'}`;
-                }
-            }
-            catch (hookErr) {
-                hookStatus = `Error: ${hookErr instanceof Error ? hookErr.message : String(hookErr)}`;
-            }
-            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`,
-                            ``,
-                            `## Agent Hooks`,
-                            `- Status: ${hookStatus}`,
-                            `- Boundary guard: prevents PM from directly modifying code or running dev commands`,
-                            `- Proactive reminders: dispatch timeout, idle phase, pending reviews`,
-                            ``,
-                            `## Next Steps`,
-                            `The host agent will now follow the PM workflow automatically.`,
-                            `Start by calling \`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 project_setup.`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-}
-//# sourceMappingURL=setup-project.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,12 +0,0 @@
-/**
- * MCP Tool: phase_update
- * Advance or update the status of a project phase.
- *
- * Guards (when completing a phase with force!=true):
- * - Prior phases must all be completed
- * - Required doc outputs must exist
- * - Docs requiring review must be approved
- * - No active (dispatched/running) dispatches in the phase
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerUpdatePhase(server: McpServer, builtinDir: string, customDir: string): void;

package/build/tools/update-phase.js

@@ -1,159 +0,0 @@
-/**
- * MCP Tool: phase_update
- * Advance or update the status of a project phase.
- *
- * Guards (when completing a phase with force!=true):
- * - Prior phases must all be completed
- * - Required doc outputs must exist
- * - Docs requiring review must be approved
- * - No active (dispatched/running) dispatches in the phase
- */
-import { z } from 'zod';
-import { readState, updatePhaseStatus } from '../core/state.js';
-import { loadWorkflow } from '../core/workflow.js';
-import { listDocs } from '../core/docs.js';
-import { readReviews } from '../core/reviews.js';
-import { readDispatches } from '../core/dispatch.js';
-import { getMergedOverrides, resolveDocReview } from '../core/overrides.js';
-import { getProject } from '../core/registry.js';
-export function registerUpdatePhase(server, builtinDir, customDir) {
-    server.tool('phase_update', 'Update the status of a project phase. When a phase is completed, the next phase is automatically started. Completing a phase checks that all required doc outputs exist.', {
-        project_name: z.string().describe('Project name'),
-        phase_id: z.string().describe('Phase ID to update (e.g. clarify, design, develop, test, deliver)'),
-        status: z.enum(['pending', 'in_progress', 'completed', 'blocked']).describe('New status for the phase'),
-        blocked_reason: z.string().optional().describe("Reason for blocking (required when status is 'blocked')"),
-        force: z.boolean().optional().describe('Force completion even if outputs are missing (default: false)'),
-    }, async ({ project_name, phase_id, status, blocked_reason, force }) => {
-        try {
-            // Resolve current iteration
-            const entry = await getProject(project_name);
-            if (!entry || entry.currentIteration === 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `项目 "${project_name}" 未找到或尚未开始迭代。请先调用 iteration_start。`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const iteration = entry.currentIteration;
-            // ── Completion guards ──
-            if (status === 'completed' && !force) {
-                const currentState = await readState(project_name, iteration);
-                const wf = await loadWorkflow(builtinDir, customDir, currentState.workflow);
-                const existingDocs = await listDocs(project_name, iteration);
-                const phaseDef = wf.definition.phases.find((p) => p.id === phase_id);
-                const phaseIndex = wf.definition.phases.findIndex((p) => p.id === phase_id);
-                const guardErrors = [];
-                // Guard 0: Scale must be set before completing any phase
-                if (currentState.scale === null) {
-                    guardErrors.push('Scale 尚未设定。请先调用 project_set_scale 设定项目规模。');
-                }
-                // Guard 1: Prior phases must all be completed
-                if (phaseIndex > 0) {
-                    const priorPhases = wf.definition.phases.slice(0, phaseIndex);
-                    const incompletePriors = priorPhases.filter((pp) => {
-                        const ps = currentState.phases.find((s) => s.id === pp.id);
-                        return !ps || ps.status !== 'completed';
-                    });
-                    if (incompletePriors.length > 0) {
-                        guardErrors.push(`前序阶段未完成: ${incompletePriors.map((p) => p.id).join(', ')}`);
-                    }
-                }
-                // Guard 2 & 3 require scale to be set
-                if (currentState.scale !== null && phaseDef) {
-                    const scale = currentState.scale;
-                    // Guard 2: Required doc outputs must exist
-                    const missingDocOutputs = phaseDef.outputs.filter((o) => {
-                        const docDef = wf.definition.docs[o];
-                        if (!docDef)
-                            return false;
-                        if (docDef.external)
-                            return false;
-                        const scaleVal = docDef.scale[scale];
-                        if (scaleVal === 'skip' || scaleVal === 'optional')
-                            return false;
-                        return !existingDocs.includes(o);
-                    });
-                    if (missingDocOutputs.length > 0) {
-                        guardErrors.push(`缺少必需文档产出: ${missingDocOutputs.join(', ')}`);
-                    }
-                    // Guard 3: Docs requiring review must be approved
-                    const overrides = await getMergedOverrides(project_name);
-                    const reviews = await readReviews(project_name, iteration);
-                    const unapprovedDocs = phaseDef.outputs.filter((o) => {
-                        const docDef = wf.definition.docs[o];
-                        if (!docDef)
-                            return false;
-                        if (docDef.external)
-                            return false;
-                        const scaleVal = docDef.scale[scale];
-                        if (scaleVal === 'skip' || scaleVal === 'optional')
-                            return false;
-                        const needsReview = resolveDocReview(o, docDef, overrides);
-                        if (!needsReview)
-                            return false;
-                        const reviewState = reviews[o];
-                        return !reviewState || reviewState.status !== 'approved';
-                    });
-                    if (unapprovedDocs.length > 0) {
-                        guardErrors.push(`文档待审核或未通过: ${unapprovedDocs.join(', ')}`);
-                    }
-                }
-                // Guard 4: No active dispatches
-                const dispatches = await readDispatches(project_name, iteration);
-                const activeDispatches = dispatches.filter((d) => d.status === 'dispatched' || d.status === 'running');
-                if (activeDispatches.length > 0) {
-                    const activeList = activeDispatches.map((d) => `${d.id} (${d.role}, ${d.status})`).join(', ');
-                    guardErrors.push(`存在进行中的 dispatch: ${activeList}`);
-                }
-                if (guardErrors.length > 0) {
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: [
-                                    `无法完成阶段 "${phase_id}"：`,
-                                    '',
-                                    ...guardErrors.map((e) => `- ${e}`),
-                                    '',
-                                    '请先解决以上问题，或使用 force=true 强制完成。',
-                                ].join('\n'),
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-            }
-            const state = await updatePhaseStatus(project_name, iteration, phase_id, status, blocked_reason);
-            const phasesSummary = state.phases
-                .map((p) => {
-                const marker = p.id === state.currentPhase ? ' <-- current' : '';
-                return `  ${p.id}: ${p.status}${p.blockedReason ? ` (${p.blockedReason})` : ''}${marker}`;
-            })
-                .join('\n');
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Phase "${phase_id}" updated to "${status}".\n\nProject phases:\n${phasesSummary}`,
-                    },
-                ],
-            };
-        }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-}
-//# sourceMappingURL=update-phase.js.map

package/build/tools/update-phase.js.map

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