gsd-pi 2.67.0-dev.a5b1d8f → 2.67.0-dev.fe39184

package/packages/mcp-server/dist/server.js

@@ -0,0 +1,319 @@
+/**
+ * MCP Server — registers GSD orchestration, project-state, and workflow tools.
+ *
+ * Session tools (6): gsd_execute, gsd_status, gsd_result, gsd_cancel, gsd_query, gsd_resolve_blocker
+ * Read-only tools (6): gsd_progress, gsd_roadmap, gsd_history, gsd_doctor, gsd_captures, gsd_knowledge
+ * Workflow tools (17): planning, replanning, completion, validation, reassessment, gate result, and milestone status tools
+ *
+ * Uses dynamic imports for @modelcontextprotocol/sdk because TS Node16
+ * cannot resolve the SDK's subpath exports statically (same pattern as
+ * src/mcp-server.ts in the main package).
+ */
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { z } from 'zod';
+import { readProgress } from './readers/state.js';
+import { readRoadmap } from './readers/roadmap.js';
+import { readHistory } from './readers/metrics.js';
+import { readCaptures } from './readers/captures.js';
+import { readKnowledge } from './readers/knowledge.js';
+import { runDoctorLite } from './readers/doctor-lite.js';
+import { registerWorkflowTools } from './workflow-tools.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MCP_PKG = '@modelcontextprotocol/sdk';
+const SERVER_NAME = 'gsd';
+const SERVER_VERSION = '2.53.0';
+// ---------------------------------------------------------------------------
+// Tool result helpers
+// ---------------------------------------------------------------------------
+/** Wrap a JSON-serializable value as MCP tool content. */
+function jsonContent(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+/** Return an MCP error response. */
+function errorContent(message) {
+    return { isError: true, content: [{ type: 'text', text: message }] };
+}
+// ---------------------------------------------------------------------------
+// gsd_query filesystem reader
+// ---------------------------------------------------------------------------
+async function readProjectState(projectDir, _query) {
+    const gsdDir = join(resolve(projectDir), '.gsd');
+    const result = { projectDir: resolve(projectDir) };
+    // STATE.md — current execution state
+    try {
+        result.state = await readFile(join(gsdDir, 'STATE.md'), 'utf-8');
+    }
+    catch {
+        result.state = null;
+    }
+    // PROJECT.md — project description
+    try {
+        result.project = await readFile(join(gsdDir, 'PROJECT.md'), 'utf-8');
+    }
+    catch {
+        result.project = null;
+    }
+    // REQUIREMENTS.md — requirement contract
+    try {
+        result.requirements = await readFile(join(gsdDir, 'REQUIREMENTS.md'), 'utf-8');
+    }
+    catch {
+        result.requirements = null;
+    }
+    // List milestones with basic metadata
+    const milestonesDir = join(gsdDir, 'milestones');
+    try {
+        const entries = await readdir(milestonesDir, { withFileTypes: true });
+        const milestones = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const mDir = join(milestonesDir, entry.name);
+            const hasRoadmap = await fileExists(join(mDir, `${entry.name}-ROADMAP.md`));
+            const hasSummary = await fileExists(join(mDir, `${entry.name}-SUMMARY.md`));
+            milestones.push({ id: entry.name, hasRoadmap, hasSummary });
+        }
+        result.milestones = milestones;
+    }
+    catch {
+        result.milestones = [];
+    }
+    return result;
+}
+async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// createMcpServer
+// ---------------------------------------------------------------------------
+/**
+ * Create and configure an MCP server with session, read-only, and workflow tools.
+ *
+ * Returns the McpServer instance — call `connect(transport)` to start serving.
+ * Uses dynamic imports for the MCP SDK to avoid TS subpath resolution issues.
+ */
+export async function createMcpServer(sessionManager) {
+    // Dynamic import — same workaround as src/mcp-server.ts
+    const mcpMod = await import(`${MCP_PKG}/server/mcp.js`);
+    const McpServer = mcpMod.McpServer;
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    // -----------------------------------------------------------------------
+    // gsd_execute — start a new GSD auto-mode session
+    // -----------------------------------------------------------------------
+    server.tool('gsd_execute', 'Start a GSD auto-mode session for a project directory. Returns a sessionId for tracking.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+        command: z.string().optional().describe('Command to send (default: "/gsd auto")'),
+        model: z.string().optional().describe('Model ID override'),
+        bare: z.boolean().optional().describe('Run in bare mode (skip user config)'),
+    }, async (args) => {
+        const { projectDir, command, model, bare } = args;
+        try {
+            const sessionId = await sessionManager.startSession(projectDir, { command, model, bare });
+            return jsonContent({ sessionId, status: 'started' });
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_status — poll session status
+    // -----------------------------------------------------------------------
+    server.tool('gsd_status', 'Get the current status of a GSD session including progress, recent events, and pending blockers.', {
+        sessionId: z.string().describe('Session ID returned from gsd_execute'),
+    }, async (args) => {
+        const { sessionId } = args;
+        try {
+            const session = sessionManager.getSession(sessionId);
+            if (!session)
+                return errorContent(`Session not found: ${sessionId}`);
+            const durationMs = Date.now() - session.startTime;
+            const toolCallCount = session.events.filter((e) => e.type === 'tool_use' ||
+                e.type === 'tool_execution_start').length;
+            return jsonContent({
+                status: session.status,
+                progress: {
+                    eventCount: session.events.length,
+                    toolCalls: toolCallCount,
+                },
+                recentEvents: session.events.slice(-10),
+                pendingBlocker: session.pendingBlocker
+                    ? {
+                        id: session.pendingBlocker.id,
+                        method: session.pendingBlocker.method,
+                        message: session.pendingBlocker.message,
+                    }
+                    : null,
+                cost: session.cost,
+                durationMs,
+            });
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_result — get accumulated session result
+    // -----------------------------------------------------------------------
+    server.tool('gsd_result', 'Get the result of a GSD session. Returns partial results if the session is still running.', {
+        sessionId: z.string().describe('Session ID returned from gsd_execute'),
+    }, async (args) => {
+        const { sessionId } = args;
+        try {
+            const result = sessionManager.getResult(sessionId);
+            return jsonContent(result);
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_cancel — cancel a running session
+    // -----------------------------------------------------------------------
+    server.tool('gsd_cancel', 'Cancel a running GSD session. Aborts the current operation and stops the process.', {
+        sessionId: z.string().describe('Session ID returned from gsd_execute'),
+    }, async (args) => {
+        const { sessionId } = args;
+        try {
+            await sessionManager.cancelSession(sessionId);
+            return jsonContent({ cancelled: true });
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_query — read project state from filesystem (no session needed)
+    // -----------------------------------------------------------------------
+    server.tool('gsd_query', 'Query GSD project state from the filesystem. Returns STATE.md, PROJECT.md, requirements, and milestone listing. Does not require an active session.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+        query: z.string().describe('What to query (e.g. "status", "milestones", "requirements")'),
+    }, async (args) => {
+        const { projectDir, query } = args;
+        try {
+            const state = await readProjectState(projectDir, query);
+            return jsonContent(state);
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_resolve_blocker — resolve a pending blocker
+    // -----------------------------------------------------------------------
+    server.tool('gsd_resolve_blocker', 'Resolve a pending blocker in a GSD session by sending a response to the UI request.', {
+        sessionId: z.string().describe('Session ID returned from gsd_execute'),
+        response: z.string().describe('Response to send for the pending blocker'),
+    }, async (args) => {
+        const { sessionId, response } = args;
+        try {
+            await sessionManager.resolveBlocker(sessionId, response);
+            return jsonContent({ resolved: true });
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // =======================================================================
+    // READ-ONLY TOOLS — no session required, pure filesystem reads
+    // =======================================================================
+    // -----------------------------------------------------------------------
+    // gsd_progress — structured project progress metrics
+    // -----------------------------------------------------------------------
+    server.tool('gsd_progress', 'Get structured project progress: active milestone/slice/task, phase, completion counts, blockers, and next action. No session required — reads directly from .gsd/ on disk.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+    }, async (args) => {
+        const { projectDir } = args;
+        try {
+            return jsonContent(readProgress(projectDir));
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_roadmap — milestone/slice/task structure with status
+    // -----------------------------------------------------------------------
+    server.tool('gsd_roadmap', 'Get the full project roadmap structure: milestones with their slices, tasks, status, risk, and dependencies. Optionally filter to a single milestone. No session required.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+        milestoneId: z.string().optional().describe('Filter to a specific milestone (e.g. "M001")'),
+    }, async (args) => {
+        const { projectDir, milestoneId } = args;
+        try {
+            return jsonContent(readRoadmap(projectDir, milestoneId));
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_history — execution history with cost/token metrics
+    // -----------------------------------------------------------------------
+    server.tool('gsd_history', 'Get execution history with cost, token usage, model, and duration per unit. Returns totals across all units. No session required.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+        limit: z.number().optional().describe('Max entries to return (most recent first). Default: all.'),
+    }, async (args) => {
+        const { projectDir, limit } = args;
+        try {
+            return jsonContent(readHistory(projectDir, limit));
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_doctor — lightweight structural health check
+    // -----------------------------------------------------------------------
+    server.tool('gsd_doctor', 'Run a lightweight structural health check on the .gsd/ directory. Checks for missing files, status inconsistencies, and orphaned state. No session required.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+        scope: z.string().optional().describe('Limit checks to a specific milestone (e.g. "M001")'),
+    }, async (args) => {
+        const { projectDir, scope } = args;
+        try {
+            return jsonContent(runDoctorLite(projectDir, scope));
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_captures — pending captures and ideas
+    // -----------------------------------------------------------------------
+    server.tool('gsd_captures', 'Get captured ideas and thoughts from CAPTURES.md with triage status. Filter by pending, actionable, or all. No session required.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+        filter: z.enum(['all', 'pending', 'actionable']).optional().describe('Filter captures (default: "all")'),
+    }, async (args) => {
+        const { projectDir, filter } = args;
+        try {
+            return jsonContent(readCaptures(projectDir, filter ?? 'all'));
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // -----------------------------------------------------------------------
+    // gsd_knowledge — project knowledge base
+    // -----------------------------------------------------------------------
+    server.tool('gsd_knowledge', 'Get the project knowledge base: rules, patterns, and lessons learned accumulated during development. No session required.', {
+        projectDir: z.string().describe('Absolute path to the project directory'),
+    }, async (args) => {
+        const { projectDir } = args;
+        try {
+            return jsonContent(readKnowledge(projectDir));
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
+    registerWorkflowTools(server);
+    return { server };
+}
+//# sourceMappingURL=server.js.map

package/packages/mcp-server/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAC5C,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,0DAA0D;AAC1D,SAAS,WAAW,CAAC,IAAa;IAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACvF,CAAC;AAED,oCAAoC;AACpC,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,KAAK,UAAU,gBAAgB,CAAC,UAAkB,EAAE,MAAc;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAA4B,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;IAE5E,qCAAqC;IACrC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,mCAAmC;IACnC,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,sCAAsC;IACtC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,UAAU,GAAoE,EAAE,CAAC;QACvF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;YAC5E,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;YAC5E,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAYD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,cAA8B;IAGlE,wDAAwD;IACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,gBAAgB,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAEnC,MAAM,MAAM,GAAsB,IAAI,SAAS,CAC7C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,0EAA0E;IAC1E,kDAAkD;IAClD,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,0FAA0F,EAC1F;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1D,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAC7E,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAE5C,CAAC;QACF,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1F,OAAO,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,mCAAmC;IACnC,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,kGAAkG,EAClG;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACvE,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAA6B,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO;gBAAE,OAAO,YAAY,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;YAErE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;YAClD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CAAE,CAA6B,CAAC,IAAI,KAAK,UAAU;gBACjD,CAA6B,CAAC,IAAI,KAAK,sBAAsB,CACtE,CAAC,MAAM,CAAC;YAET,OAAO,WAAW,CAAC;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE;oBACR,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;oBACjC,SAAS,EAAE,aAAa;iBACzB;gBACD,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACvC,cAAc,EAAE,OAAO,CAAC,cAAc;oBACpC,CAAC,CAAC;wBACE,EAAE,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE;wBAC7B,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,MAAM;wBACrC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,OAAO;qBACxC;oBACH,CAAC,CAAC,IAAI;gBACR,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,UAAU;aACX,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,8CAA8C;IAC9C,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,2FAA2F,EAC3F;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACvE,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAA6B,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACnD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,wCAAwC;IACxC,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,mFAAmF,EACnF;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACvE,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAA6B,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAC9C,OAAO,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,qEAAqE;IACrE,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,WAAW,EACX,qJAAqJ,EACrJ;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;KAC1F,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAA6C,CAAC;QAC5E,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,kDAAkD;IAClD,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,qFAAqF,EACrF;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KAC1E,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAA+C,CAAC;QAChF,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACzD,OAAO,WAAW,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,+DAA+D;IAC/D,0EAA0E;IAE1E,0EAA0E;IAC1E,qDAAqD;IACrD,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,6KAA6K,EAC7K;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KAC1E,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,GAAG,IAA8B,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,2DAA2D;IAC3D,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,4KAA4K,EAC5K;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KAC5F,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,IAAoD,CAAC;QACzF,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,0DAA0D;IAC1D,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,mIAAmI,EACnI;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;KAClG,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAA8C,CAAC;QAC7E,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,mDAAmD;IACnD,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,8JAA8J,EAC9J;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;KAC5F,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAA8C,CAAC;QAC7E,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,4CAA4C;IAC5C,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,kIAAkI,EAClI;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KACzG,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAyE,CAAC;QACzG,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0EAA0E;IAC1E,yCAAyC;IACzC,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACT,eAAe,EACf,2HAA2H,EAC3H;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KAC1E,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,EAAE,UAAU,EAAE,GAAG,IAA8B,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9B,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC","sourcesContent":["/**\n * MCP Server — registers GSD orchestration, project-state, and workflow tools.\n *\n * Session tools (6): gsd_execute, gsd_status, gsd_result, gsd_cancel, gsd_query, gsd_resolve_blocker\n * Read-only tools (6): gsd_progress, gsd_roadmap, gsd_history, gsd_doctor, gsd_captures, gsd_knowledge\n * Workflow tools (17): planning, replanning, completion, validation, reassessment, gate result, and milestone status tools\n *\n * Uses dynamic imports for @modelcontextprotocol/sdk because TS Node16\n * cannot resolve the SDK's subpath exports statically (same pattern as\n * src/mcp-server.ts in the main package).\n */\n\nimport { readFile, readdir, stat } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport { z } from 'zod';\nimport type { SessionManager } from './session-manager.js';\nimport { readProgress } from './readers/state.js';\nimport { readRoadmap } from './readers/roadmap.js';\nimport { readHistory } from './readers/metrics.js';\nimport { readCaptures } from './readers/captures.js';\nimport { readKnowledge } from './readers/knowledge.js';\nimport { runDoctorLite } from './readers/doctor-lite.js';\nimport { registerWorkflowTools } from './workflow-tools.js';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\nconst SERVER_NAME = 'gsd';\nconst SERVER_VERSION = '2.53.0';\n\n// ---------------------------------------------------------------------------\n// Tool result helpers\n// ---------------------------------------------------------------------------\n\n/** Wrap a JSON-serializable value as MCP tool content. */\nfunction jsonContent(data: unknown): { content: Array<{ type: 'text'; text: string }> } {\n  return { content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }] };\n}\n\n/** Return an MCP error response. */\nfunction errorContent(message: string): { isError: true; content: Array<{ type: 'text'; text: string }> } {\n  return { isError: true, content: [{ type: 'text' as const, text: message }] };\n}\n\n// ---------------------------------------------------------------------------\n// gsd_query filesystem reader\n// ---------------------------------------------------------------------------\n\nasync function readProjectState(projectDir: string, _query: string): Promise<Record<string, unknown>> {\n  const gsdDir = join(resolve(projectDir), '.gsd');\n  const result: Record<string, unknown> = { projectDir: resolve(projectDir) };\n\n  // STATE.md — current execution state\n  try {\n    result.state = await readFile(join(gsdDir, 'STATE.md'), 'utf-8');\n  } catch {\n    result.state = null;\n  }\n\n  // PROJECT.md — project description\n  try {\n    result.project = await readFile(join(gsdDir, 'PROJECT.md'), 'utf-8');\n  } catch {\n    result.project = null;\n  }\n\n  // REQUIREMENTS.md — requirement contract\n  try {\n    result.requirements = await readFile(join(gsdDir, 'REQUIREMENTS.md'), 'utf-8');\n  } catch {\n    result.requirements = null;\n  }\n\n  // List milestones with basic metadata\n  const milestonesDir = join(gsdDir, 'milestones');\n  try {\n    const entries = await readdir(milestonesDir, { withFileTypes: true });\n    const milestones: Array<{ id: string; hasRoadmap: boolean; hasSummary: boolean }> = [];\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      const mDir = join(milestonesDir, entry.name);\n      const hasRoadmap = await fileExists(join(mDir, `${entry.name}-ROADMAP.md`));\n      const hasSummary = await fileExists(join(mDir, `${entry.name}-SUMMARY.md`));\n      milestones.push({ id: entry.name, hasRoadmap, hasSummary });\n    }\n    result.milestones = milestones;\n  } catch {\n    result.milestones = [];\n  }\n\n  return result;\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// MCP Server type — minimal interface for the dynamically-imported McpServer\n// ---------------------------------------------------------------------------\n\ninterface McpServerInstance {\n  tool(name: string, description: string, params: Record<string, unknown>, handler: (args: Record<string, unknown>) => Promise<unknown>): unknown;\n  connect(transport: unknown): Promise<void>;\n  close(): Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// createMcpServer\n// ---------------------------------------------------------------------------\n\n/**\n * Create and configure an MCP server with session, read-only, and workflow tools.\n *\n * Returns the McpServer instance — call `connect(transport)` to start serving.\n * Uses dynamic imports for the MCP SDK to avoid TS subpath resolution issues.\n */\nexport async function createMcpServer(sessionManager: SessionManager): Promise<{\n  server: McpServerInstance;\n}> {\n  // Dynamic import — same workaround as src/mcp-server.ts\n  const mcpMod = await import(`${MCP_PKG}/server/mcp.js`);\n  const McpServer = mcpMod.McpServer;\n\n  const server: McpServerInstance = new McpServer(\n    { name: SERVER_NAME, version: SERVER_VERSION },\n    { capabilities: { tools: {} } },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_execute — start a new GSD auto-mode session\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_execute',\n    'Start a GSD auto-mode session for a project directory. Returns a sessionId for tracking.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      command: z.string().optional().describe('Command to send (default: \"/gsd auto\")'),\n      model: z.string().optional().describe('Model ID override'),\n      bare: z.boolean().optional().describe('Run in bare mode (skip user config)'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, command, model, bare } = args as {\n        projectDir: string; command?: string; model?: string; bare?: boolean;\n      };\n      try {\n        const sessionId = await sessionManager.startSession(projectDir, { command, model, bare });\n        return jsonContent({ sessionId, status: 'started' });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_status — poll session status\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_status',\n    'Get the current status of a GSD session including progress, recent events, and pending blockers.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        const session = sessionManager.getSession(sessionId);\n        if (!session) return errorContent(`Session not found: ${sessionId}`);\n\n        const durationMs = Date.now() - session.startTime;\n        const toolCallCount = session.events.filter(\n          (e) => (e as Record<string, unknown>).type === 'tool_use' ||\n                 (e as Record<string, unknown>).type === 'tool_execution_start'\n        ).length;\n\n        return jsonContent({\n          status: session.status,\n          progress: {\n            eventCount: session.events.length,\n            toolCalls: toolCallCount,\n          },\n          recentEvents: session.events.slice(-10),\n          pendingBlocker: session.pendingBlocker\n            ? {\n                id: session.pendingBlocker.id,\n                method: session.pendingBlocker.method,\n                message: session.pendingBlocker.message,\n              }\n            : null,\n          cost: session.cost,\n          durationMs,\n        });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_result — get accumulated session result\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_result',\n    'Get the result of a GSD session. Returns partial results if the session is still running.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        const result = sessionManager.getResult(sessionId);\n        return jsonContent(result);\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_cancel — cancel a running session\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_cancel',\n    'Cancel a running GSD session. Aborts the current operation and stops the process.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        await sessionManager.cancelSession(sessionId);\n        return jsonContent({ cancelled: true });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_query — read project state from filesystem (no session needed)\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_query',\n    'Query GSD project state from the filesystem. Returns STATE.md, PROJECT.md, requirements, and milestone listing. Does not require an active session.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      query: z.string().describe('What to query (e.g. \"status\", \"milestones\", \"requirements\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, query } = args as { projectDir: string; query: string };\n      try {\n        const state = await readProjectState(projectDir, query);\n        return jsonContent(state);\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_resolve_blocker — resolve a pending blocker\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_resolve_blocker',\n    'Resolve a pending blocker in a GSD session by sending a response to the UI request.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n      response: z.string().describe('Response to send for the pending blocker'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId, response } = args as { sessionId: string; response: string };\n      try {\n        await sessionManager.resolveBlocker(sessionId, response);\n        return jsonContent({ resolved: true });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // =======================================================================\n  // READ-ONLY TOOLS — no session required, pure filesystem reads\n  // =======================================================================\n\n  // -----------------------------------------------------------------------\n  // gsd_progress — structured project progress metrics\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_progress',\n    'Get structured project progress: active milestone/slice/task, phase, completion counts, blockers, and next action. No session required — reads directly from .gsd/ on disk.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir } = args as { projectDir: string };\n      try {\n        return jsonContent(readProgress(projectDir));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_roadmap — milestone/slice/task structure with status\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_roadmap',\n    'Get the full project roadmap structure: milestones with their slices, tasks, status, risk, and dependencies. Optionally filter to a single milestone. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      milestoneId: z.string().optional().describe('Filter to a specific milestone (e.g. \"M001\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, milestoneId } = args as { projectDir: string; milestoneId?: string };\n      try {\n        return jsonContent(readRoadmap(projectDir, milestoneId));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_history — execution history with cost/token metrics\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_history',\n    'Get execution history with cost, token usage, model, and duration per unit. Returns totals across all units. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      limit: z.number().optional().describe('Max entries to return (most recent first). Default: all.'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, limit } = args as { projectDir: string; limit?: number };\n      try {\n        return jsonContent(readHistory(projectDir, limit));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_doctor — lightweight structural health check\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_doctor',\n    'Run a lightweight structural health check on the .gsd/ directory. Checks for missing files, status inconsistencies, and orphaned state. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      scope: z.string().optional().describe('Limit checks to a specific milestone (e.g. \"M001\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, scope } = args as { projectDir: string; scope?: string };\n      try {\n        return jsonContent(runDoctorLite(projectDir, scope));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_captures — pending captures and ideas\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_captures',\n    'Get captured ideas and thoughts from CAPTURES.md with triage status. Filter by pending, actionable, or all. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      filter: z.enum(['all', 'pending', 'actionable']).optional().describe('Filter captures (default: \"all\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, filter } = args as { projectDir: string; filter?: 'all' | 'pending' | 'actionable' };\n      try {\n        return jsonContent(readCaptures(projectDir, filter ?? 'all'));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_knowledge — project knowledge base\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_knowledge',\n    'Get the project knowledge base: rules, patterns, and lessons learned accumulated during development. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir } = args as { projectDir: string };\n      try {\n        return jsonContent(readKnowledge(projectDir));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  registerWorkflowTools(server);\n\n  return { server };\n}\n"]}

package/packages/mcp-server/dist/session-manager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SessionManager — manages RpcClient lifecycle for background GSD execution.
+ *
+ * One active session per projectDir. Tracks events in a ring buffer,
+ * detects blockers, tracks terminal state, and accumulates cost using
+ * the cumulative-max pattern (K004).
+ */
+import type { ManagedSession, ExecuteOptions } from './types.js';
+export declare class SessionManager {
+    /** Sessions keyed by projectDir for duplicate-start prevention */
+    private sessions;
+    /**
+     * Start a new GSD auto-mode session for the given project directory.
+     *
+     * Rejects if a session already exists for this projectDir.
+     * Creates an RpcClient, starts the process, performs the v2 init handshake,
+     * wires event tracking, and sends '/gsd auto' to begin execution.
+     */
+    startSession(projectDir: string, options?: ExecuteOptions): Promise<string>;
+    /**
+     * Look up a session by sessionId.
+     * Linear scan is fine — we expect <10 concurrent sessions.
+     */
+    getSession(sessionId: string): ManagedSession | undefined;
+    /**
+     * Look up a session by project directory (direct map lookup).
+     */
+    getSessionByDir(projectDir: string): ManagedSession | undefined;
+    /**
+     * Resolve a pending blocker by sending a UI response.
+     */
+    resolveBlocker(sessionId: string, response: string): Promise<void>;
+    /**
+     * Cancel a running session — abort current operation then stop the process.
+     */
+    cancelSession(sessionId: string): Promise<void>;
+    /**
+     * Build a HeadlessJsonResult-shaped object from accumulated session state.
+     */
+    getResult(sessionId: string): Record<string, unknown>;
+    /**
+     * Stop all active sessions and clean up resources.
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Resolve the GSD CLI path.
+     *
+     * 1. GSD_CLI_PATH env var (highest priority)
+     * 2. `which gsd` → resolve to the actual dist/cli.js
+     */
+    static resolveCLIPath(): string;
+    private handleEvent;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/packages/mcp-server/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAIf,MAAM,YAAY,CAAC;AAmCpB,qBAAa,cAAc;IACzB,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAqC;IAErD;;;;;;OAMG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+ErF;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAOzD;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/D;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrD;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoBrD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAyB/B,OAAO,CAAC,WAAW;CAsCpB"}