maxsimcli 3.10.3 → 3.12.0

package/dist/mcp/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Tool Registration — Orchestrates all tool registrations
+ *
+ * This is the single entry point for registering MCP tools on the server.
+ * Later plans will add registerTodoTools, registerStateTools, etc.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register all MCP tools on the given server instance.
+ */
+export declare function registerAllTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAIxD"}

package/dist/mcp/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * MCP Tool Registration — Orchestrates all tool registrations
+ *
+ * This is the single entry point for registering MCP tools on the server.
+ * Later plans will add registerTodoTools, registerStateTools, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAllTools = registerAllTools;
+const phase_tools_js_1 = require("./phase-tools.js");
+const todo_tools_js_1 = require("./todo-tools.js");
+const state_tools_js_1 = require("./state-tools.js");
+/**
+ * Register all MCP tools on the given server instance.
+ */
+function registerAllTools(server) {
+    (0, phase_tools_js_1.registerPhaseTools)(server);
+    (0, todo_tools_js_1.registerTodoTools)(server);
+    (0, state_tools_js_1.registerStateTools)(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAUH,4CAIC;AAXD,qDAAsD;AACtD,mDAAoD;AACpD,qDAAsD;AAEtD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAiB;IAChD,IAAA,mCAAkB,EAAC,MAAM,CAAC,CAAC;IAC3B,IAAA,iCAAiB,EAAC,MAAM,CAAC,CAAC;IAC1B,IAAA,mCAAkB,EAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/mcp/phase-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Phase CRUD MCP Tools — Phase operations exposed as MCP tools
+ *
+ * CRITICAL: Never import output() or error() from core — they call process.exit().
+ * CRITICAL: Never write to stdout — it is reserved for MCP JSON-RPC protocol.
+ * CRITICAL: Never call process.exit() — the server must stay alive after every tool call.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register all phase CRUD tools on the MCP server.
+ */
+export declare function registerPhaseTools(server: McpServer): void;
+//# sourceMappingURL=phase-tools.d.ts.map

package/dist/mcp/phase-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/phase-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2M1D"}

package/dist/mcp/phase-tools.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Phase CRUD MCP Tools — Phase operations exposed as MCP tools
+ *
+ * CRITICAL: Never import output() or error() from core — they call process.exit().
+ * CRITICAL: Never write to stdout — it is reserved for MCP JSON-RPC protocol.
+ * CRITICAL: Never call process.exit() — the server must stay alive after every tool call.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPhaseTools = registerPhaseTools;
+const node_fs_1 = __importDefault(require("node:fs"));
+const zod_1 = require("zod");
+const core_js_1 = require("../core/core.js");
+const phase_js_1 = require("../core/phase.js");
+const utils_js_1 = require("./utils.js");
+/**
+ * Register all phase CRUD tools on the MCP server.
+ */
+function registerPhaseTools(server) {
+    // ── mcp_find_phase ──────────────────────────────────────────────────────────
+    server.tool('mcp_find_phase', 'Find a phase directory by number or name. Returns phase details including plans, summaries, and status.', {
+        phase: zod_1.z.string().describe('Phase number or name (e.g. "01", "1", "01A", "1.1")'),
+    }, async ({ phase }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const result = (0, core_js_1.findPhaseInternal)(cwd, phase);
+            if (!result) {
+                return (0, utils_js_1.mcpError)(`Phase ${phase} not found`, 'Phase not found');
+            }
+            return (0, utils_js_1.mcpSuccess)({
+                found: result.found,
+                directory: result.directory,
+                phase_number: result.phase_number,
+                phase_name: result.phase_name,
+                phase_slug: result.phase_slug,
+                plans: result.plans,
+                summaries: result.summaries,
+                incomplete_plans: result.incomplete_plans,
+                has_research: result.has_research,
+                has_context: result.has_context,
+                has_verification: result.has_verification,
+                archived: result.archived ?? null,
+            }, `Found phase ${result.phase_number}: ${result.phase_name ?? 'unnamed'}`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_list_phases ─────────────────────────────────────────────────────────
+    server.tool('mcp_list_phases', 'List all phase directories, sorted correctly. Optionally include archived phases from milestones.', {
+        include_archived: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Include archived phases from completed milestones'),
+    }, async ({ include_archived }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const phasesDir = (0, core_js_1.phasesPath)(cwd);
+            if (!node_fs_1.default.existsSync(phasesDir)) {
+                return (0, utils_js_1.mcpSuccess)({ directories: [], count: 0 }, 'No phases directory found');
+            }
+            let dirs = (0, core_js_1.listSubDirs)(phasesDir);
+            if (include_archived) {
+                const archived = (0, core_js_1.getArchivedPhaseDirs)(cwd);
+                for (const a of archived) {
+                    dirs.push(`${a.name} [${a.milestone}]`);
+                }
+            }
+            dirs.sort((a, b) => (0, core_js_1.comparePhaseNum)(a, b));
+            return (0, utils_js_1.mcpSuccess)({ directories: dirs, count: dirs.length }, `Found ${dirs.length} phase(s)`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_create_phase ────────────────────────────────────────────────────────
+    server.tool('mcp_create_phase', 'Create a new phase. Adds the next sequential phase directory and appends to ROADMAP.md.', {
+        name: zod_1.z.string().describe('Phase description/name (e.g. "Authentication System")'),
+    }, async ({ name }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            if (!name || !name.trim()) {
+                return (0, utils_js_1.mcpError)('Phase name must not be empty', 'Validation failed');
+            }
+            const result = (0, phase_js_1.phaseAddCore)(cwd, name, { includeStubs: true });
+            return (0, utils_js_1.mcpSuccess)({
+                phase_number: result.phase_number,
+                padded: result.padded,
+                name: result.description,
+                slug: result.slug,
+                directory: result.directory,
+            }, `Created Phase ${result.phase_number}: ${result.description}`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_insert_phase ────────────────────────────────────────────────────────
+    server.tool('mcp_insert_phase', 'Insert a decimal phase after a specified phase (e.g. 01.1 after 01). Creates directory and updates ROADMAP.md.', {
+        name: zod_1.z.string().describe('Phase description/name'),
+        after: zod_1.z.string().describe('Phase number to insert after (e.g. "01", "1")'),
+    }, async ({ name, after }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            if (!name || !name.trim()) {
+                return (0, utils_js_1.mcpError)('Phase name must not be empty', 'Validation failed');
+            }
+            const result = (0, phase_js_1.phaseInsertCore)(cwd, after, name, { includeStubs: true });
+            return (0, utils_js_1.mcpSuccess)({
+                phase_number: result.phase_number,
+                after_phase: result.after_phase,
+                name: result.description,
+                slug: result.slug,
+                directory: result.directory,
+            }, `Inserted Phase ${result.phase_number}: ${result.description} after Phase ${result.after_phase}`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_complete_phase ──────────────────────────────────────────────────────
+    server.tool('mcp_complete_phase', 'Mark a phase as complete. Updates ROADMAP.md checkbox, progress table, plan count, STATE.md, and REQUIREMENTS.md.', {
+        phase: zod_1.z.string().describe('Phase number to complete (e.g. "01", "1", "1.1")'),
+    }, async ({ phase }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const result = (0, phase_js_1.phaseCompleteCore)(cwd, phase);
+            return (0, utils_js_1.mcpSuccess)({
+                completed_phase: result.completed_phase,
+                phase_name: result.phase_name,
+                plans_executed: result.plans_executed,
+                next_phase: result.next_phase,
+                next_phase_name: result.next_phase_name,
+                is_last_phase: result.is_last_phase,
+                date: result.date,
+                roadmap_updated: result.roadmap_updated,
+                state_updated: result.state_updated,
+            }, `Phase ${phase} marked as complete${result.next_phase ? `, next: Phase ${result.next_phase}` : ''}`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+}
+//# sourceMappingURL=phase-tools.js.map

package/dist/mcp/phase-tools.js.map

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

package/dist/mcp/state-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * State Management MCP Tools — STATE.md operations exposed as MCP tools
+ *
+ * CRITICAL: Never import output() or error() from core — they call process.exit().
+ * CRITICAL: Never write to stdout — it is reserved for MCP JSON-RPC protocol.
+ * CRITICAL: Never call process.exit() — the server must stay alive after every tool call.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register all state management tools on the MCP server.
+ */
+export declare function registerStateTools(server: McpServer): void;
+//# sourceMappingURL=state-tools.d.ts.map

package/dist/mcp/state-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/state-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuQ1D"}

package/dist/mcp/state-tools.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * State Management MCP Tools — STATE.md operations exposed as MCP tools
+ *
+ * CRITICAL: Never import output() or error() from core — they call process.exit().
+ * CRITICAL: Never write to stdout — it is reserved for MCP JSON-RPC protocol.
+ * CRITICAL: Never call process.exit() — the server must stay alive after every tool call.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStateTools = registerStateTools;
+const node_fs_1 = __importDefault(require("node:fs"));
+const zod_1 = require("zod");
+const escape_string_regexp_1 = __importDefault(require("escape-string-regexp"));
+const core_js_1 = require("../core/core.js");
+const state_js_1 = require("../core/state.js");
+const utils_js_1 = require("./utils.js");
+/**
+ * Register all state management tools on the MCP server.
+ */
+function registerStateTools(server) {
+    // ── mcp_get_state ───────────────────────────────────────────────────────────
+    server.tool('mcp_get_state', 'Read STATE.md content — full file, a specific **field:** value, or a ## section.', {
+        field: zod_1.z
+            .string()
+            .optional()
+            .describe('Specific field or section name, or omit for full STATE.md'),
+    }, async ({ field }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const stPath = (0, core_js_1.statePath)(cwd);
+            if (!node_fs_1.default.existsSync(stPath)) {
+                return (0, utils_js_1.mcpError)('STATE.md not found', 'STATE.md missing');
+            }
+            const content = node_fs_1.default.readFileSync(stPath, 'utf-8');
+            if (!field) {
+                return (0, utils_js_1.mcpSuccess)({ content }, 'Full STATE.md retrieved');
+            }
+            // Try **field:** value pattern first
+            const fieldValue = (0, state_js_1.stateExtractField)(content, field);
+            if (fieldValue) {
+                return (0, utils_js_1.mcpSuccess)({ content: fieldValue, field }, `State field retrieved: ${field}`);
+            }
+            // Try ## Section pattern
+            const fieldEscaped = (0, escape_string_regexp_1.default)(field);
+            const sectionPattern = new RegExp(`##\\s*${fieldEscaped}\\s*\n([\\s\\S]*?)(?=\\n##|$)`, 'i');
+            const sectionMatch = content.match(sectionPattern);
+            if (sectionMatch) {
+                return (0, utils_js_1.mcpSuccess)({ content: sectionMatch[1].trim(), field }, `State section retrieved: ${field}`);
+            }
+            return (0, utils_js_1.mcpError)(`Section or field "${field}" not found in STATE.md`, 'Field not found');
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_update_state ────────────────────────────────────────────────────────
+    server.tool('mcp_update_state', 'Update a **field:** value in STATE.md (e.g., "Status", "Current focus").', {
+        field: zod_1.z.string().describe('Field name (e.g., "Status", "Current focus")'),
+        value: zod_1.z.string().describe('New value for the field'),
+    }, async ({ field, value }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const stPath = (0, core_js_1.statePath)(cwd);
+            if (!node_fs_1.default.existsSync(stPath)) {
+                return (0, utils_js_1.mcpError)('STATE.md not found', 'STATE.md missing');
+            }
+            const content = node_fs_1.default.readFileSync(stPath, 'utf-8');
+            const updated = (0, state_js_1.stateReplaceField)(content, field, value);
+            if (!updated) {
+                return (0, utils_js_1.mcpError)(`Field "${field}" not found in STATE.md`, 'Field not found');
+            }
+            node_fs_1.default.writeFileSync(stPath, updated, 'utf-8');
+            return (0, utils_js_1.mcpSuccess)({ updated: true, field, value }, `State updated: ${field}`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_add_decision ────────────────────────────────────────────────────────
+    server.tool('mcp_add_decision', 'Record a decision in the Decisions section of STATE.md.', {
+        summary: zod_1.z.string().describe('Decision summary'),
+        rationale: zod_1.z.string().optional().describe('Optional rationale'),
+        phase: zod_1.z.string().optional().describe('Associated phase number'),
+    }, async ({ summary, rationale, phase }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const stPath = (0, core_js_1.statePath)(cwd);
+            if (!node_fs_1.default.existsSync(stPath)) {
+                return (0, utils_js_1.mcpError)('STATE.md not found', 'STATE.md missing');
+            }
+            const content = node_fs_1.default.readFileSync(stPath, 'utf-8');
+            const entry = `- [Phase ${phase || '?'}]: ${summary}${rationale ? ` -- ${rationale}` : ''}`;
+            const sectionPattern = /(###?\s*(?:Decisions|Decisions Made|Accumulated.*Decisions)\s*\n)([\s\S]*?)(?=\n###?|\n##[^#]|$)/i;
+            const updated = (0, state_js_1.appendToStateSection)(content, sectionPattern, entry, [/None yet\.?\s*\n?/gi, /No decisions yet\.?\s*\n?/gi]);
+            if (!updated) {
+                return (0, utils_js_1.mcpError)('Decisions section not found in STATE.md', 'Section not found');
+            }
+            node_fs_1.default.writeFileSync(stPath, updated, 'utf-8');
+            return (0, utils_js_1.mcpSuccess)({ added: true, decision: entry }, 'Decision recorded');
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_add_blocker ─────────────────────────────────────────────────────────
+    server.tool('mcp_add_blocker', 'Add a blocker entry to the Blockers section of STATE.md.', {
+        text: zod_1.z.string().describe('Blocker description'),
+    }, async ({ text }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const stPath = (0, core_js_1.statePath)(cwd);
+            if (!node_fs_1.default.existsSync(stPath)) {
+                return (0, utils_js_1.mcpError)('STATE.md not found', 'STATE.md missing');
+            }
+            const content = node_fs_1.default.readFileSync(stPath, 'utf-8');
+            const entry = `- ${text}`;
+            const sectionPattern = /(###?\s*(?:Blockers|Blockers\/Concerns|Concerns)\s*\n)([\s\S]*?)(?=\n###?|\n##[^#]|$)/i;
+            const updated = (0, state_js_1.appendToStateSection)(content, sectionPattern, entry, [/None\.?\s*\n?/gi, /None yet\.?\s*\n?/gi]);
+            if (!updated) {
+                return (0, utils_js_1.mcpError)('Blockers section not found in STATE.md', 'Section not found');
+            }
+            node_fs_1.default.writeFileSync(stPath, updated, 'utf-8');
+            return (0, utils_js_1.mcpSuccess)({ added: true, blocker: text }, 'Blocker added');
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_resolve_blocker ─────────────────────────────────────────────────────
+    server.tool('mcp_resolve_blocker', 'Remove a blocker from STATE.md by matching text (case-insensitive partial match).', {
+        text: zod_1.z
+            .string()
+            .describe('Text to match against blocker entries (case-insensitive partial match)'),
+    }, async ({ text }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const stPath = (0, core_js_1.statePath)(cwd);
+            if (!node_fs_1.default.existsSync(stPath)) {
+                return (0, utils_js_1.mcpError)('STATE.md not found', 'STATE.md missing');
+            }
+            let content = node_fs_1.default.readFileSync(stPath, 'utf-8');
+            const sectionPattern = /(###?\s*(?:Blockers|Blockers\/Concerns|Concerns)\s*\n)([\s\S]*?)(?=\n###?|\n##[^#]|$)/i;
+            const match = content.match(sectionPattern);
+            if (!match) {
+                return (0, utils_js_1.mcpError)('Blockers section not found in STATE.md', 'Section not found');
+            }
+            const sectionBody = match[2];
+            const lines = sectionBody.split('\n');
+            const filtered = lines.filter((line) => {
+                if (!line.startsWith('- '))
+                    return true;
+                return !line.toLowerCase().includes(text.toLowerCase());
+            });
+            let newBody = filtered.join('\n');
+            if (!newBody.trim() || !newBody.includes('- ')) {
+                newBody = 'None\n';
+            }
+            content = content.replace(sectionPattern, (_match, header) => `${header}${newBody}`);
+            node_fs_1.default.writeFileSync(stPath, content, 'utf-8');
+            return (0, utils_js_1.mcpSuccess)({ resolved: true, blocker: text }, 'Blocker resolved');
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+}
+//# sourceMappingURL=state-tools.js.map

package/dist/mcp/state-tools.js.map

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

package/dist/mcp/todo-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Todo CRUD MCP Tools — Todo operations exposed as MCP tools
+ *
+ * CRITICAL: Never import output() or error() from core — they call process.exit().
+ * CRITICAL: Never write to stdout — it is reserved for MCP JSON-RPC protocol.
+ * CRITICAL: Never call process.exit() — the server must stay alive after every tool call.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register all todo CRUD tools on the MCP server.
+ */
+export declare function registerTodoTools(server: McpServer): void;
+//# sourceMappingURL=todo-tools.d.ts.map

package/dist/mcp/todo-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/todo-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyKzD"}

package/dist/mcp/todo-tools.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Todo CRUD MCP Tools — Todo operations exposed as MCP tools
+ *
+ * CRITICAL: Never import output() or error() from core — they call process.exit().
+ * CRITICAL: Never write to stdout — it is reserved for MCP JSON-RPC protocol.
+ * CRITICAL: Never call process.exit() — the server must stay alive after every tool call.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTodoTools = registerTodoTools;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const zod_1 = require("zod");
+const core_js_1 = require("../core/core.js");
+const commands_js_1 = require("../core/commands.js");
+const utils_js_1 = require("./utils.js");
+/**
+ * Register all todo CRUD tools on the MCP server.
+ */
+function registerTodoTools(server) {
+    // ── mcp_add_todo ────────────────────────────────────────────────────────────
+    server.tool('mcp_add_todo', 'Create a new todo item in .planning/todos/pending/ with frontmatter metadata.', {
+        title: zod_1.z.string().describe('Title of the todo item'),
+        description: zod_1.z.string().optional().describe('Optional description body'),
+        area: zod_1.z.string().optional().default('general').describe('Area/category (default: general)'),
+        phase: zod_1.z.string().optional().describe('Associated phase number'),
+    }, async ({ title, description, area, phase }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const pendingDir = (0, core_js_1.planningPath)(cwd, 'todos', 'pending');
+            node_fs_1.default.mkdirSync(pendingDir, { recursive: true });
+            const today = (0, core_js_1.todayISO)();
+            const slug = (0, core_js_1.generateSlugInternal)(title) || 'untitled';
+            const timestamp = Date.now();
+            const filename = `${timestamp}-${slug}.md`;
+            const filePath = node_path_1.default.join(pendingDir, filename);
+            const content = `---\ncreated: ${today}\ntitle: ${title}\narea: ${area || 'general'}\nphase: ${phase || 'unassigned'}\n---\n${description || ''}\n`;
+            node_fs_1.default.writeFileSync(filePath, content, 'utf-8');
+            return (0, utils_js_1.mcpSuccess)({
+                file: filename,
+                path: `.planning/todos/pending/${filename}`,
+                title,
+                area: area || 'general',
+            }, `Todo created: ${title}`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_complete_todo ───────────────────────────────────────────────────────
+    server.tool('mcp_complete_todo', 'Mark a pending todo as completed by moving it from pending/ to completed/ with a completion timestamp.', {
+        todo_id: zod_1.z.string().describe('Filename of the todo (e.g., 1234567890-my-task.md)'),
+    }, async ({ todo_id }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const pendingDir = (0, core_js_1.planningPath)(cwd, 'todos', 'pending');
+            const completedDir = (0, core_js_1.planningPath)(cwd, 'todos', 'completed');
+            const sourcePath = node_path_1.default.join(pendingDir, todo_id);
+            if (!node_fs_1.default.existsSync(sourcePath)) {
+                return (0, utils_js_1.mcpError)(`Todo not found in pending: ${todo_id}`, 'Todo not found');
+            }
+            node_fs_1.default.mkdirSync(completedDir, { recursive: true });
+            let content = node_fs_1.default.readFileSync(sourcePath, 'utf-8');
+            const today = (0, core_js_1.todayISO)();
+            content = `completed: ${today}\n` + content;
+            node_fs_1.default.writeFileSync(node_path_1.default.join(completedDir, todo_id), content, 'utf-8');
+            node_fs_1.default.unlinkSync(sourcePath);
+            return (0, utils_js_1.mcpSuccess)({ completed: true, file: todo_id, date: today }, `Todo completed: ${todo_id}`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+    // ── mcp_list_todos ──────────────────────────────────────────────────────────
+    server.tool('mcp_list_todos', 'List todo items, optionally filtered by area and status (pending, completed, or all).', {
+        area: zod_1.z.string().optional().describe('Filter by area/category'),
+        status: zod_1.z
+            .enum(['pending', 'completed', 'all'])
+            .optional()
+            .default('pending')
+            .describe('Which todos to list (default: pending)'),
+    }, async ({ area, status }) => {
+        try {
+            const cwd = (0, utils_js_1.detectProjectRoot)();
+            if (!cwd) {
+                return (0, utils_js_1.mcpError)('No .planning/ directory found', 'Project not detected');
+            }
+            const todosBase = (0, core_js_1.planningPath)(cwd, 'todos');
+            const dirs = [];
+            if (status === 'pending' || status === 'all') {
+                dirs.push(node_path_1.default.join(todosBase, 'pending'));
+            }
+            if (status === 'completed' || status === 'all') {
+                dirs.push(node_path_1.default.join(todosBase, 'completed'));
+            }
+            const todos = [];
+            for (const dir of dirs) {
+                const dirStatus = dir.endsWith('pending') ? 'pending' : 'completed';
+                let files = [];
+                try {
+                    files = node_fs_1.default.readdirSync(dir).filter((f) => f.endsWith('.md'));
+                }
+                catch {
+                    // Directory may not exist
+                    continue;
+                }
+                for (const file of files) {
+                    try {
+                        const content = node_fs_1.default.readFileSync(node_path_1.default.join(dir, file), 'utf-8');
+                        const fm = (0, commands_js_1.parseTodoFrontmatter)(content);
+                        if (area && fm.area !== area)
+                            continue;
+                        todos.push({
+                            file,
+                            created: fm.created,
+                            title: fm.title,
+                            area: fm.area,
+                            status: dirStatus,
+                            path: `.planning/todos/${dirStatus}/${file}`,
+                        });
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+            return (0, utils_js_1.mcpSuccess)({ count: todos.length, todos }, `${todos.length} todos found`);
+        }
+        catch (e) {
+            return (0, utils_js_1.mcpError)(e.message, 'Operation failed');
+        }
+    });
+}
+//# sourceMappingURL=todo-tools.js.map

package/dist/mcp/todo-tools.js.map

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