gsd-pi 2.67.0-dev.509bd95 → 2.67.0-dev.5399650

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

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * @gsd-build/mcp-server CLI — stdio transport entry point.
+ *
+ * Connects the MCP server to stdin/stdout for use by Claude Code,
+ * Cursor, and other MCP-compatible clients.
+ */
+import { SessionManager } from './session-manager.js';
+import { createMcpServer } from './server.js';
+const MCP_PKG = '@modelcontextprotocol/sdk';
+async function main() {
+    const sessionManager = new SessionManager();
+    // Create the configured MCP server with all 12 tools (6 session + 6 read-only)
+    const { server } = await createMcpServer(sessionManager);
+    // Dynamic import for StdioServerTransport (same TS subpath workaround)
+    const { StdioServerTransport } = await import(`${MCP_PKG}/server/stdio.js`);
+    const transport = new StdioServerTransport();
+    // Cleanup handler — stop all sessions before exiting
+    let cleaningUp = false;
+    async function cleanup() {
+        if (cleaningUp)
+            return;
+        cleaningUp = true;
+        process.stderr.write('[gsd-mcp-server] Shutting down...\n');
+        try {
+            await sessionManager.cleanup();
+        }
+        catch {
+            // swallow cleanup errors
+        }
+        try {
+            await server.close();
+        }
+        catch {
+            // swallow close errors
+        }
+        process.exit(0);
+    }
+    process.on('SIGTERM', () => void cleanup());
+    process.on('SIGINT', () => void cleanup());
+    // Handle stdin end — MCP client disconnected
+    process.stdin.on('end', () => void cleanup());
+    // Connect and start serving
+    try {
+        await server.connect(transport);
+        process.stderr.write('[gsd-mcp-server] MCP server started on stdio\n');
+    }
+    catch (err) {
+        process.stderr.write(`[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\n`);
+        await sessionManager.cleanup();
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`[gsd-mcp-server] Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAE5C,+EAA+E;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;IAEzD,uEAAuE;IACvE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,kBAAkB,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,qDAAqD;IACrD,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,UAAU,OAAO;QACpB,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE3C,6CAA6C;IAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6CAA6C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAClG,CAAC;QACF,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n\n/**\n * @gsd-build/mcp-server CLI — stdio transport entry point.\n *\n * Connects the MCP server to stdin/stdout for use by Claude Code,\n * Cursor, and other MCP-compatible clients.\n */\n\nimport { SessionManager } from './session-manager.js';\nimport { createMcpServer } from './server.js';\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\n\nasync function main(): Promise<void> {\n  const sessionManager = new SessionManager();\n\n  // Create the configured MCP server with all 12 tools (6 session + 6 read-only)\n  const { server } = await createMcpServer(sessionManager);\n\n  // Dynamic import for StdioServerTransport (same TS subpath workaround)\n  const { StdioServerTransport } = await import(`${MCP_PKG}/server/stdio.js`);\n  const transport = new StdioServerTransport();\n\n  // Cleanup handler — stop all sessions before exiting\n  let cleaningUp = false;\n  async function cleanup(): Promise<void> {\n    if (cleaningUp) return;\n    cleaningUp = true;\n    process.stderr.write('[gsd-mcp-server] Shutting down...\\n');\n    try {\n      await sessionManager.cleanup();\n    } catch {\n      // swallow cleanup errors\n    }\n    try {\n      await server.close();\n    } catch {\n      // swallow close errors\n    }\n    process.exit(0);\n  }\n\n  process.on('SIGTERM', () => void cleanup());\n  process.on('SIGINT', () => void cleanup());\n\n  // Handle stdin end — MCP client disconnected\n  process.stdin.on('end', () => void cleanup());\n\n  // Connect and start serving\n  try {\n    await server.connect(transport);\n    process.stderr.write('[gsd-mcp-server] MCP server started on stdio\\n');\n  } catch (err) {\n    process.stderr.write(\n      `[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\\n`\n    );\n    await sessionManager.cleanup();\n    process.exit(1);\n  }\n}\n\nmain().catch((err) => {\n  process.stderr.write(\n    `[gsd-mcp-server] Fatal: ${err instanceof Error ? err.message : String(err)}\\n`\n  );\n  process.exit(1);\n});\n"]}

package/packages/mcp-server/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @gsd-build/mcp-server — MCP server for GSD orchestration and project state.
+ */
+export { SessionManager } from './session-manager.js';
+export { createMcpServer } from './server.js';
+export type { SessionStatus, ManagedSession, ExecuteOptions, PendingBlocker, CostAccumulator, } from './types.js';
+export { MAX_EVENTS, INIT_TIMEOUT_MS } from './types.js';
+export { readProgress } from './readers/state.js';
+export type { ProgressResult } from './readers/state.js';
+export { readRoadmap } from './readers/roadmap.js';
+export type { RoadmapResult, MilestoneInfo, SliceInfo, TaskInfo } from './readers/roadmap.js';
+export { readHistory } from './readers/metrics.js';
+export type { HistoryResult, MetricsUnit } from './readers/metrics.js';
+export { readCaptures } from './readers/captures.js';
+export type { CapturesResult, CaptureEntry } from './readers/captures.js';
+export { readKnowledge } from './readers/knowledge.js';
+export type { KnowledgeResult, KnowledgeEntry } from './readers/knowledge.js';
+export { runDoctorLite } from './readers/doctor-lite.js';
+export type { DoctorResult, DoctorIssue } from './readers/doctor-lite.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/mcp-server/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * @gsd-build/mcp-server — MCP server for GSD orchestration and project state.
+ */
+export { SessionManager } from './session-manager.js';
+export { createMcpServer } from './server.js';
+export { MAX_EVENTS, INIT_TIMEOUT_MS } from './types.js';
+// Read-only state readers (usable without a running session)
+export { readProgress } from './readers/state.js';
+export { readRoadmap } from './readers/roadmap.js';
+export { readHistory } from './readers/metrics.js';
+export { readCaptures } from './readers/captures.js';
+export { readKnowledge } from './readers/knowledge.js';
+export { runDoctorLite } from './readers/doctor-lite.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ9C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzD,6DAA6D;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["/**\n * @gsd-build/mcp-server — MCP server for GSD orchestration and project state.\n */\n\nexport { SessionManager } from './session-manager.js';\nexport { createMcpServer } from './server.js';\nexport type {\n  SessionStatus,\n  ManagedSession,\n  ExecuteOptions,\n  PendingBlocker,\n  CostAccumulator,\n} from './types.js';\nexport { MAX_EVENTS, INIT_TIMEOUT_MS } from './types.js';\n\n// Read-only state readers (usable without a running session)\nexport { readProgress } from './readers/state.js';\nexport type { ProgressResult } from './readers/state.js';\nexport { readRoadmap } from './readers/roadmap.js';\nexport type { RoadmapResult, MilestoneInfo, SliceInfo, TaskInfo } from './readers/roadmap.js';\nexport { readHistory } from './readers/metrics.js';\nexport type { HistoryResult, MetricsUnit } from './readers/metrics.js';\nexport { readCaptures } from './readers/captures.js';\nexport type { CapturesResult, CaptureEntry } from './readers/captures.js';\nexport { readKnowledge } from './readers/knowledge.js';\nexport type { KnowledgeResult, KnowledgeEntry } from './readers/knowledge.js';\nexport { runDoctorLite } from './readers/doctor-lite.js';\nexport type { DoctorResult, DoctorIssue } from './readers/doctor-lite.js';\n"]}

package/packages/mcp-server/dist/readers/captures.d.ts

@@ -0,0 +1,25 @@
+export type CaptureStatus = 'pending' | 'triaged' | 'resolved';
+export type CaptureClassification = 'quick-task' | 'inject' | 'defer' | 'replan' | 'note' | 'stop' | 'backtrack';
+export interface CaptureEntry {
+    id: string;
+    text: string;
+    timestamp: string;
+    status: CaptureStatus;
+    classification: CaptureClassification | null;
+    resolution: string | null;
+    rationale: string | null;
+    resolvedAt: string | null;
+    milestone: string | null;
+    executed: string | null;
+}
+export interface CapturesResult {
+    captures: CaptureEntry[];
+    counts: {
+        total: number;
+        pending: number;
+        resolved: number;
+        actionable: number;
+    };
+}
+export declare function readCaptures(projectDir: string, filter?: 'all' | 'pending' | 'actionable'): CapturesResult;
+//# sourceMappingURL=captures.d.ts.map

package/packages/mcp-server/dist/readers/captures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captures.d.ts","sourceRoot":"","sources":["../../src/readers/captures.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAC/D,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAiDD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,KAAK,GAAG,SAAS,GAAG,YAAoB,GAC/C,cAAc,CA+BhB"}

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

@@ -0,0 +1,67 @@
+// GSD MCP Server — captures reader
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { readFileSync, existsSync } from 'node:fs';
+import { resolveGsdRoot, resolveRootFile } from './paths.js';
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+function parseCapturesMarkdown(content) {
+    const entries = [];
+    // Split on H3 headers: ### CAP-xxxxxxxx
+    const sections = content.split(/(?=^### CAP-)/m);
+    for (const section of sections) {
+        const idMatch = section.match(/^### (CAP-[\da-f]+)/);
+        if (!idMatch)
+            continue;
+        const id = idMatch[1];
+        const field = (label) => {
+            const re = new RegExp(`\\*\\*${label}:\\*\\*\\s*(.+)`, 'i');
+            const m = section.match(re);
+            return m ? m[1].trim() : null;
+        };
+        const status = (field('Status') ?? 'pending').toLowerCase();
+        const classification = field('Classification');
+        entries.push({
+            id,
+            text: field('Text') ?? '',
+            timestamp: field('Captured') ?? '',
+            status,
+            classification,
+            resolution: field('Resolution'),
+            rationale: field('Rationale'),
+            resolvedAt: field('Resolved'),
+            milestone: field('Milestone'),
+            executed: field('Executed'),
+        });
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+const ACTIONABLE_CLASSIFICATIONS = new Set(['quick-task', 'inject', 'replan']);
+export function readCaptures(projectDir, filter = 'all') {
+    const gsd = resolveGsdRoot(projectDir);
+    const capturesPath = resolveRootFile(gsd, 'CAPTURES.md');
+    if (!existsSync(capturesPath)) {
+        return { captures: [], counts: { total: 0, pending: 0, resolved: 0, actionable: 0 } };
+    }
+    const content = readFileSync(capturesPath, 'utf-8');
+    let captures = parseCapturesMarkdown(content);
+    // Compute counts before filtering
+    const counts = {
+        total: captures.length,
+        pending: captures.filter((c) => c.status === 'pending').length,
+        resolved: captures.filter((c) => c.status === 'resolved').length,
+        actionable: captures.filter((c) => c.classification !== null && ACTIONABLE_CLASSIFICATIONS.has(c.classification)).length,
+    };
+    // Apply filter
+    if (filter === 'pending') {
+        captures = captures.filter((c) => c.status === 'pending');
+    }
+    else if (filter === 'actionable') {
+        captures = captures.filter((c) => c.classification !== null && ACTIONABLE_CLASSIFICATIONS.has(c.classification));
+    }
+    return { captures, counts };
+}
+//# sourceMappingURL=captures.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"captures.js","sourceRoot":"","sources":["../../src/readers/captures.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD MCP Server — captures reader\n// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>\n\nimport { readFileSync, existsSync } from 'node:fs';\nimport { resolveGsdRoot, resolveRootFile } from './paths.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type CaptureStatus = 'pending' | 'triaged' | 'resolved';\nexport type CaptureClassification =\n  | 'quick-task' | 'inject' | 'defer' | 'replan' | 'note' | 'stop' | 'backtrack';\n\nexport interface CaptureEntry {\n  id: string;\n  text: string;\n  timestamp: string;\n  status: CaptureStatus;\n  classification: CaptureClassification | null;\n  resolution: string | null;\n  rationale: string | null;\n  resolvedAt: string | null;\n  milestone: string | null;\n  executed: string | null;\n}\n\nexport interface CapturesResult {\n  captures: CaptureEntry[];\n  counts: {\n    total: number;\n    pending: number;\n    resolved: number;\n    actionable: number;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Parser\n// ---------------------------------------------------------------------------\n\nfunction parseCapturesMarkdown(content: string): CaptureEntry[] {\n  const entries: CaptureEntry[] = [];\n\n  // Split on H3 headers: ### CAP-xxxxxxxx\n  const sections = content.split(/(?=^### CAP-)/m);\n\n  for (const section of sections) {\n    const idMatch = section.match(/^### (CAP-[\\da-f]+)/);\n    if (!idMatch) continue;\n\n    const id = idMatch[1];\n    const field = (label: string): string | null => {\n      const re = new RegExp(`\\\\*\\\\*${label}:\\\\*\\\\*\\\\s*(.+)`, 'i');\n      const m = section.match(re);\n      return m ? m[1].trim() : null;\n    };\n\n    const status = (field('Status') ?? 'pending').toLowerCase() as CaptureStatus;\n    const classification = field('Classification') as CaptureClassification | null;\n\n    entries.push({\n      id,\n      text: field('Text') ?? '',\n      timestamp: field('Captured') ?? '',\n      status,\n      classification,\n      resolution: field('Resolution'),\n      rationale: field('Rationale'),\n      resolvedAt: field('Resolved'),\n      milestone: field('Milestone'),\n      executed: field('Executed'),\n    });\n  }\n\n  return entries;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\nconst ACTIONABLE_CLASSIFICATIONS = new Set<string>(['quick-task', 'inject', 'replan']);\n\nexport function readCaptures(\n  projectDir: string,\n  filter: 'all' | 'pending' | 'actionable' = 'all',\n): CapturesResult {\n  const gsd = resolveGsdRoot(projectDir);\n  const capturesPath = resolveRootFile(gsd, 'CAPTURES.md');\n\n  if (!existsSync(capturesPath)) {\n    return { captures: [], counts: { total: 0, pending: 0, resolved: 0, actionable: 0 } };\n  }\n\n  const content = readFileSync(capturesPath, 'utf-8');\n  let captures = parseCapturesMarkdown(content);\n\n  // Compute counts before filtering\n  const counts = {\n    total: captures.length,\n    pending: captures.filter((c) => c.status === 'pending').length,\n    resolved: captures.filter((c) => c.status === 'resolved').length,\n    actionable: captures.filter(\n      (c) => c.classification !== null && ACTIONABLE_CLASSIFICATIONS.has(c.classification),\n    ).length,\n  };\n\n  // Apply filter\n  if (filter === 'pending') {\n    captures = captures.filter((c) => c.status === 'pending');\n  } else if (filter === 'actionable') {\n    captures = captures.filter(\n      (c) => c.classification !== null && ACTIONABLE_CLASSIFICATIONS.has(c.classification),\n    );\n  }\n\n  return { captures, counts };\n}\n"]}

package/packages/mcp-server/dist/readers/doctor-lite.d.ts

@@ -0,0 +1,20 @@
+export type Severity = 'info' | 'warning' | 'error';
+export interface DoctorIssue {
+    severity: Severity;
+    code: string;
+    scope: 'project' | 'milestone' | 'slice' | 'task';
+    unitId: string;
+    message: string;
+    file?: string;
+}
+export interface DoctorResult {
+    ok: boolean;
+    issues: DoctorIssue[];
+    counts: {
+        error: number;
+        warning: number;
+        info: number;
+    };
+}
+export declare function runDoctorLite(projectDir: string, scope?: string): DoctorResult;
+//# sourceMappingURL=doctor-lite.d.ts.map

package/packages/mcp-server/dist/readers/doctor-lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-lite.d.ts","sourceRoot":"","sources":["../../src/readers/doctor-lite.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAoJD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CA0C9E"}

package/packages/mcp-server/dist/readers/doctor-lite.js

@@ -0,0 +1,173 @@
+// GSD MCP Server — lightweight structural health checks
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { existsSync } from 'node:fs';
+import { resolveGsdRoot, resolveRootFile, findMilestoneIds, resolveMilestoneFile, resolveMilestoneDir, findSliceIds, resolveSliceFile, findTaskFiles, } from './paths.js';
+// ---------------------------------------------------------------------------
+// Check implementations
+// ---------------------------------------------------------------------------
+function checkProjectLevel(gsdRoot, issues) {
+    // PROJECT.md should exist
+    const projectPath = resolveRootFile(gsdRoot, 'PROJECT.md');
+    if (!existsSync(projectPath)) {
+        issues.push({
+            severity: 'warning',
+            code: 'missing_project_md',
+            scope: 'project',
+            unitId: '',
+            message: 'PROJECT.md is missing — project lacks a description',
+            file: projectPath,
+        });
+    }
+    // STATE.md should exist if milestones exist
+    const milestones = findMilestoneIds(gsdRoot);
+    if (milestones.length > 0) {
+        const statePath = resolveRootFile(gsdRoot, 'STATE.md');
+        if (!existsSync(statePath)) {
+            issues.push({
+                severity: 'warning',
+                code: 'missing_state_md',
+                scope: 'project',
+                unitId: '',
+                message: 'STATE.md is missing — run /gsd status to regenerate',
+                file: statePath,
+            });
+        }
+    }
+}
+function checkMilestoneLevel(gsdRoot, mid, issues) {
+    const mDir = resolveMilestoneDir(gsdRoot, mid);
+    if (!mDir) {
+        issues.push({
+            severity: 'error',
+            code: 'missing_milestone_dir',
+            scope: 'milestone',
+            unitId: mid,
+            message: `Milestone directory for ${mid} not found`,
+        });
+        return;
+    }
+    // CONTEXT.md should exist
+    const ctxPath = resolveMilestoneFile(gsdRoot, mid, 'CONTEXT');
+    if (!ctxPath || !existsSync(ctxPath)) {
+        // Check for draft
+        const draftPath = resolveMilestoneFile(gsdRoot, mid, 'CONTEXT-DRAFT');
+        if (!draftPath || !existsSync(draftPath)) {
+            issues.push({
+                severity: 'warning',
+                code: 'missing_context',
+                scope: 'milestone',
+                unitId: mid,
+                message: `${mid} has no CONTEXT.md — milestone lacks defined scope`,
+            });
+        }
+    }
+    // ROADMAP.md should exist if slices exist
+    const sliceIds = findSliceIds(gsdRoot, mid);
+    if (sliceIds.length > 0) {
+        const roadmapPath = resolveMilestoneFile(gsdRoot, mid, 'ROADMAP');
+        if (!roadmapPath || !existsSync(roadmapPath)) {
+            issues.push({
+                severity: 'warning',
+                code: 'missing_roadmap',
+                scope: 'milestone',
+                unitId: mid,
+                message: `${mid} has ${sliceIds.length} slices but no ROADMAP.md`,
+            });
+        }
+    }
+    // Check if all slices done but no SUMMARY
+    if (sliceIds.length > 0) {
+        const allDone = sliceIds.every((sid) => {
+            const tasks = findTaskFiles(gsdRoot, mid, sid);
+            return tasks.length > 0 && tasks.every((t) => t.hasSummary);
+        });
+        const summaryPath = resolveMilestoneFile(gsdRoot, mid, 'SUMMARY');
+        if (allDone && (!summaryPath || !existsSync(summaryPath))) {
+            issues.push({
+                severity: 'error',
+                code: 'all_slices_done_missing_summary',
+                scope: 'milestone',
+                unitId: mid,
+                message: `${mid} has all slices completed but no SUMMARY.md`,
+            });
+        }
+    }
+}
+function checkSliceLevel(gsdRoot, mid, sid, issues) {
+    const unitId = `${mid}/${sid}`;
+    // PLAN.md should exist
+    const planPath = resolveSliceFile(gsdRoot, mid, sid, 'PLAN');
+    if (!planPath || !existsSync(planPath)) {
+        issues.push({
+            severity: 'error',
+            code: 'missing_slice_plan',
+            scope: 'slice',
+            unitId,
+            message: `${unitId} has no PLAN.md`,
+        });
+    }
+    // Tasks should have plans
+    const tasks = findTaskFiles(gsdRoot, mid, sid);
+    for (const task of tasks) {
+        const taskUnitId = `${unitId}/${task.id}`;
+        if (!task.hasPlan) {
+            issues.push({
+                severity: 'warning',
+                code: 'missing_task_plan',
+                scope: 'task',
+                unitId: taskUnitId,
+                message: `${taskUnitId} has a summary but no plan file`,
+            });
+        }
+    }
+    // Check for empty slice (directory exists but no tasks or plan)
+    if (tasks.length === 0 && (!planPath || !existsSync(planPath))) {
+        issues.push({
+            severity: 'warning',
+            code: 'empty_slice',
+            scope: 'slice',
+            unitId,
+            message: `${unitId} has no plan and no tasks — may be abandoned`,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function runDoctorLite(projectDir, scope) {
+    const gsdRoot = resolveGsdRoot(projectDir);
+    const issues = [];
+    if (!existsSync(gsdRoot)) {
+        return {
+            ok: true,
+            issues: [{
+                    severity: 'info',
+                    code: 'no_gsd_directory',
+                    scope: 'project',
+                    unitId: '',
+                    message: 'No .gsd/ directory found — project not initialized',
+                }],
+            counts: { error: 0, warning: 0, info: 1 },
+        };
+    }
+    // Project-level checks
+    checkProjectLevel(gsdRoot, issues);
+    // Milestone + slice checks
+    const milestoneIds = scope
+        ? findMilestoneIds(gsdRoot).filter((id) => id === scope)
+        : findMilestoneIds(gsdRoot);
+    for (const mid of milestoneIds) {
+        checkMilestoneLevel(gsdRoot, mid, issues);
+        const sliceIds = findSliceIds(gsdRoot, mid);
+        for (const sid of sliceIds) {
+            checkSliceLevel(gsdRoot, mid, sid, issues);
+        }
+    }
+    const counts = {
+        error: issues.filter((i) => i.severity === 'error').length,
+        warning: issues.filter((i) => i.severity === 'warning').length,
+        info: issues.filter((i) => i.severity === 'info').length,
+    };
+    return { ok: counts.error === 0, issues, counts };
+}
+//# sourceMappingURL=doctor-lite.js.map

package/packages/mcp-server/dist/readers/doctor-lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-lite.js","sourceRoot":"","sources":["../../src/readers/doctor-lite.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD MCP Server — lightweight structural health checks\n// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport {\n  resolveGsdRoot,\n  resolveRootFile,\n  findMilestoneIds,\n  resolveMilestoneFile,\n  resolveMilestoneDir,\n  findSliceIds,\n  resolveSliceFile,\n  findTaskFiles,\n} from './paths.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type Severity = 'info' | 'warning' | 'error';\n\nexport interface DoctorIssue {\n  severity: Severity;\n  code: string;\n  scope: 'project' | 'milestone' | 'slice' | 'task';\n  unitId: string;\n  message: string;\n  file?: string;\n}\n\nexport interface DoctorResult {\n  ok: boolean;\n  issues: DoctorIssue[];\n  counts: { error: number; warning: number; info: number };\n}\n\n// ---------------------------------------------------------------------------\n// Check implementations\n// ---------------------------------------------------------------------------\n\nfunction checkProjectLevel(gsdRoot: string, issues: DoctorIssue[]): void {\n  // PROJECT.md should exist\n  const projectPath = resolveRootFile(gsdRoot, 'PROJECT.md');\n  if (!existsSync(projectPath)) {\n    issues.push({\n      severity: 'warning',\n      code: 'missing_project_md',\n      scope: 'project',\n      unitId: '',\n      message: 'PROJECT.md is missing — project lacks a description',\n      file: projectPath,\n    });\n  }\n\n  // STATE.md should exist if milestones exist\n  const milestones = findMilestoneIds(gsdRoot);\n  if (milestones.length > 0) {\n    const statePath = resolveRootFile(gsdRoot, 'STATE.md');\n    if (!existsSync(statePath)) {\n      issues.push({\n        severity: 'warning',\n        code: 'missing_state_md',\n        scope: 'project',\n        unitId: '',\n        message: 'STATE.md is missing — run /gsd status to regenerate',\n        file: statePath,\n      });\n    }\n  }\n}\n\nfunction checkMilestoneLevel(gsdRoot: string, mid: string, issues: DoctorIssue[]): void {\n  const mDir = resolveMilestoneDir(gsdRoot, mid);\n  if (!mDir) {\n    issues.push({\n      severity: 'error',\n      code: 'missing_milestone_dir',\n      scope: 'milestone',\n      unitId: mid,\n      message: `Milestone directory for ${mid} not found`,\n    });\n    return;\n  }\n\n  // CONTEXT.md should exist\n  const ctxPath = resolveMilestoneFile(gsdRoot, mid, 'CONTEXT');\n  if (!ctxPath || !existsSync(ctxPath)) {\n    // Check for draft\n    const draftPath = resolveMilestoneFile(gsdRoot, mid, 'CONTEXT-DRAFT');\n    if (!draftPath || !existsSync(draftPath)) {\n      issues.push({\n        severity: 'warning',\n        code: 'missing_context',\n        scope: 'milestone',\n        unitId: mid,\n        message: `${mid} has no CONTEXT.md — milestone lacks defined scope`,\n      });\n    }\n  }\n\n  // ROADMAP.md should exist if slices exist\n  const sliceIds = findSliceIds(gsdRoot, mid);\n  if (sliceIds.length > 0) {\n    const roadmapPath = resolveMilestoneFile(gsdRoot, mid, 'ROADMAP');\n    if (!roadmapPath || !existsSync(roadmapPath)) {\n      issues.push({\n        severity: 'warning',\n        code: 'missing_roadmap',\n        scope: 'milestone',\n        unitId: mid,\n        message: `${mid} has ${sliceIds.length} slices but no ROADMAP.md`,\n      });\n    }\n  }\n\n  // Check if all slices done but no SUMMARY\n  if (sliceIds.length > 0) {\n    const allDone = sliceIds.every((sid) => {\n      const tasks = findTaskFiles(gsdRoot, mid, sid);\n      return tasks.length > 0 && tasks.every((t) => t.hasSummary);\n    });\n    const summaryPath = resolveMilestoneFile(gsdRoot, mid, 'SUMMARY');\n    if (allDone && (!summaryPath || !existsSync(summaryPath))) {\n      issues.push({\n        severity: 'error',\n        code: 'all_slices_done_missing_summary',\n        scope: 'milestone',\n        unitId: mid,\n        message: `${mid} has all slices completed but no SUMMARY.md`,\n      });\n    }\n  }\n}\n\nfunction checkSliceLevel(\n  gsdRoot: string, mid: string, sid: string, issues: DoctorIssue[],\n): void {\n  const unitId = `${mid}/${sid}`;\n\n  // PLAN.md should exist\n  const planPath = resolveSliceFile(gsdRoot, mid, sid, 'PLAN');\n  if (!planPath || !existsSync(planPath)) {\n    issues.push({\n      severity: 'error',\n      code: 'missing_slice_plan',\n      scope: 'slice',\n      unitId,\n      message: `${unitId} has no PLAN.md`,\n    });\n  }\n\n  // Tasks should have plans\n  const tasks = findTaskFiles(gsdRoot, mid, sid);\n  for (const task of tasks) {\n    const taskUnitId = `${unitId}/${task.id}`;\n    if (!task.hasPlan) {\n      issues.push({\n        severity: 'warning',\n        code: 'missing_task_plan',\n        scope: 'task',\n        unitId: taskUnitId,\n        message: `${taskUnitId} has a summary but no plan file`,\n      });\n    }\n  }\n\n  // Check for empty slice (directory exists but no tasks or plan)\n  if (tasks.length === 0 && (!planPath || !existsSync(planPath))) {\n    issues.push({\n      severity: 'warning',\n      code: 'empty_slice',\n      scope: 'slice',\n      unitId,\n      message: `${unitId} has no plan and no tasks — may be abandoned`,\n    });\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\nexport function runDoctorLite(projectDir: string, scope?: string): DoctorResult {\n  const gsdRoot = resolveGsdRoot(projectDir);\n  const issues: DoctorIssue[] = [];\n\n  if (!existsSync(gsdRoot)) {\n    return {\n      ok: true,\n      issues: [{\n        severity: 'info',\n        code: 'no_gsd_directory',\n        scope: 'project',\n        unitId: '',\n        message: 'No .gsd/ directory found — project not initialized',\n      }],\n      counts: { error: 0, warning: 0, info: 1 },\n    };\n  }\n\n  // Project-level checks\n  checkProjectLevel(gsdRoot, issues);\n\n  // Milestone + slice checks\n  const milestoneIds = scope\n    ? findMilestoneIds(gsdRoot).filter((id) => id === scope)\n    : findMilestoneIds(gsdRoot);\n\n  for (const mid of milestoneIds) {\n    checkMilestoneLevel(gsdRoot, mid, issues);\n\n    const sliceIds = findSliceIds(gsdRoot, mid);\n    for (const sid of sliceIds) {\n      checkSliceLevel(gsdRoot, mid, sid, issues);\n    }\n  }\n\n  const counts = {\n    error: issues.filter((i) => i.severity === 'error').length,\n    warning: issues.filter((i) => i.severity === 'warning').length,\n    info: issues.filter((i) => i.severity === 'info').length,\n  };\n\n  return { ok: counts.error === 0, issues, counts };\n}\n"]}

package/packages/mcp-server/dist/readers/index.d.ts

@@ -0,0 +1,14 @@
+export { resolveGsdRoot, resolveRootFile } from './paths.js';
+export { readProgress } from './state.js';
+export type { ProgressResult } from './state.js';
+export { readRoadmap } from './roadmap.js';
+export type { RoadmapResult, MilestoneInfo, SliceInfo, TaskInfo } from './roadmap.js';
+export { readHistory } from './metrics.js';
+export type { HistoryResult, MetricsUnit } from './metrics.js';
+export { readCaptures } from './captures.js';
+export type { CapturesResult, CaptureEntry } from './captures.js';
+export { readKnowledge } from './knowledge.js';
+export type { KnowledgeResult, KnowledgeEntry } from './knowledge.js';
+export { runDoctorLite } from './doctor-lite.js';
+export type { DoctorResult, DoctorIssue } from './doctor-lite.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/mcp-server/dist/readers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/readers/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,10 @@
+// GSD MCP Server — readers barrel export
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+export { resolveGsdRoot, resolveRootFile } from './paths.js';
+export { readProgress } from './state.js';
+export { readRoadmap } from './roadmap.js';
+export { readHistory } from './metrics.js';
+export { readCaptures } from './captures.js';
+export { readKnowledge } from './knowledge.js';
+export { runDoctorLite } from './doctor-lite.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/readers/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,4DAA4D;AAE5D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["// GSD MCP Server — readers barrel export\n// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>\n\nexport { resolveGsdRoot, resolveRootFile } from './paths.js';\nexport { readProgress } from './state.js';\nexport type { ProgressResult } from './state.js';\nexport { readRoadmap } from './roadmap.js';\nexport type { RoadmapResult, MilestoneInfo, SliceInfo, TaskInfo } from './roadmap.js';\nexport { readHistory } from './metrics.js';\nexport type { HistoryResult, MetricsUnit } from './metrics.js';\nexport { readCaptures } from './captures.js';\nexport type { CapturesResult, CaptureEntry } from './captures.js';\nexport { readKnowledge } from './knowledge.js';\nexport type { KnowledgeResult, KnowledgeEntry } from './knowledge.js';\nexport { runDoctorLite } from './doctor-lite.js';\nexport type { DoctorResult, DoctorIssue } from './doctor-lite.js';\n"]}

package/packages/mcp-server/dist/readers/knowledge.d.ts

@@ -0,0 +1,18 @@
+export type KnowledgeType = 'rule' | 'pattern' | 'lesson';
+export interface KnowledgeEntry {
+    id: string;
+    type: KnowledgeType;
+    scope: string;
+    content: string;
+    addedAt: string;
+}
+export interface KnowledgeResult {
+    entries: KnowledgeEntry[];
+    counts: {
+        rules: number;
+        patterns: number;
+        lessons: number;
+    };
+}
+export declare function readKnowledge(projectDir: string): KnowledgeResult;
+//# sourceMappingURL=knowledge.d.ts.map

package/packages/mcp-server/dist/readers/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/readers/knowledge.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAoED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAmBjE"}

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

@@ -0,0 +1,82 @@
+// GSD MCP Server — knowledge base reader
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { readFileSync, existsSync } from 'node:fs';
+import { resolveGsdRoot, resolveRootFile } from './paths.js';
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+function parseTableRows(section, type) {
+    const entries = [];
+    const lines = section.split('\n');
+    for (const line of lines) {
+        if (!line.includes('|'))
+            continue;
+        const cells = line.split('|').map((c) => c.trim()).filter(Boolean);
+        if (cells.length < 3)
+            continue;
+        // Skip header/separator
+        if (cells[0].startsWith('#') || cells[0].startsWith('-'))
+            continue;
+        const id = cells[0];
+        if (!/^[KPL]\d+$/i.test(id))
+            continue;
+        if (type === 'rule' && cells.length >= 5) {
+            entries.push({
+                id, type, scope: cells[1], content: cells[2], addedAt: cells[4] ?? '',
+            });
+        }
+        else if (type === 'pattern' && cells.length >= 4) {
+            entries.push({
+                id, type, scope: cells[2] ?? '', content: cells[1], addedAt: cells[3] ?? '',
+            });
+        }
+        else if (type === 'lesson' && cells.length >= 5) {
+            entries.push({
+                id, type, scope: cells[4] ?? '',
+                content: `${cells[1]} — Root cause: ${cells[2]} — Fix: ${cells[3]}`,
+                addedAt: '',
+            });
+        }
+    }
+    return entries;
+}
+function parseKnowledgeMarkdown(content) {
+    const entries = [];
+    // Find ## Rules section
+    const rulesMatch = content.match(/## Rules\s*\n([\s\S]*?)(?=\n## |$)/i);
+    if (rulesMatch) {
+        entries.push(...parseTableRows(rulesMatch[1], 'rule'));
+    }
+    // Find ## Patterns section
+    const patternsMatch = content.match(/## Patterns\s*\n([\s\S]*?)(?=\n## |$)/i);
+    if (patternsMatch) {
+        entries.push(...parseTableRows(patternsMatch[1], 'pattern'));
+    }
+    // Find ## Lessons Learned section
+    const lessonsMatch = content.match(/## Lessons Learned\s*\n([\s\S]*?)(?=\n## |$)/i);
+    if (lessonsMatch) {
+        entries.push(...parseTableRows(lessonsMatch[1], 'lesson'));
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function readKnowledge(projectDir) {
+    const gsd = resolveGsdRoot(projectDir);
+    const knowledgePath = resolveRootFile(gsd, 'KNOWLEDGE.md');
+    if (!existsSync(knowledgePath)) {
+        return { entries: [], counts: { rules: 0, patterns: 0, lessons: 0 } };
+    }
+    const content = readFileSync(knowledgePath, 'utf-8');
+    const entries = parseKnowledgeMarkdown(content);
+    return {
+        entries,
+        counts: {
+            rules: entries.filter((e) => e.type === 'rule').length,
+            patterns: entries.filter((e) => e.type === 'pattern').length,
+            lessons: entries.filter((e) => e.type === 'lesson').length,
+        },
+    };
+}
+//# sourceMappingURL=knowledge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/readers/knowledge.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD MCP Server — knowledge base reader\n// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>\n\nimport { readFileSync, existsSync } from 'node:fs';\nimport { resolveGsdRoot, resolveRootFile } from './paths.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type KnowledgeType = 'rule' | 'pattern' | 'lesson';\n\nexport interface KnowledgeEntry {\n  id: string;\n  type: KnowledgeType;\n  scope: string;\n  content: string;\n  addedAt: string;\n}\n\nexport interface KnowledgeResult {\n  entries: KnowledgeEntry[];\n  counts: { rules: number; patterns: number; lessons: number };\n}\n\n// ---------------------------------------------------------------------------\n// Parser\n// ---------------------------------------------------------------------------\n\nfunction parseTableRows(section: string, type: KnowledgeType): KnowledgeEntry[] {\n  const entries: KnowledgeEntry[] = [];\n  const lines = section.split('\\n');\n\n  for (const line of lines) {\n    if (!line.includes('|')) continue;\n    const cells = line.split('|').map((c) => c.trim()).filter(Boolean);\n    if (cells.length < 3) continue;\n    // Skip header/separator\n    if (cells[0].startsWith('#') || cells[0].startsWith('-')) continue;\n\n    const id = cells[0];\n    if (!/^[KPL]\\d+$/i.test(id)) continue;\n\n    if (type === 'rule' && cells.length >= 5) {\n      entries.push({\n        id, type, scope: cells[1], content: cells[2], addedAt: cells[4] ?? '',\n      });\n    } else if (type === 'pattern' && cells.length >= 4) {\n      entries.push({\n        id, type, scope: cells[2] ?? '', content: cells[1], addedAt: cells[3] ?? '',\n      });\n    } else if (type === 'lesson' && cells.length >= 5) {\n      entries.push({\n        id, type, scope: cells[4] ?? '',\n        content: `${cells[1]} — Root cause: ${cells[2]} — Fix: ${cells[3]}`,\n        addedAt: '',\n      });\n    }\n  }\n\n  return entries;\n}\n\nfunction parseKnowledgeMarkdown(content: string): KnowledgeEntry[] {\n  const entries: KnowledgeEntry[] = [];\n\n  // Find ## Rules section\n  const rulesMatch = content.match(/## Rules\\s*\\n([\\s\\S]*?)(?=\\n## |$)/i);\n  if (rulesMatch) {\n    entries.push(...parseTableRows(rulesMatch[1], 'rule'));\n  }\n\n  // Find ## Patterns section\n  const patternsMatch = content.match(/## Patterns\\s*\\n([\\s\\S]*?)(?=\\n## |$)/i);\n  if (patternsMatch) {\n    entries.push(...parseTableRows(patternsMatch[1], 'pattern'));\n  }\n\n  // Find ## Lessons Learned section\n  const lessonsMatch = content.match(/## Lessons Learned\\s*\\n([\\s\\S]*?)(?=\\n## |$)/i);\n  if (lessonsMatch) {\n    entries.push(...parseTableRows(lessonsMatch[1], 'lesson'));\n  }\n\n  return entries;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\nexport function readKnowledge(projectDir: string): KnowledgeResult {\n  const gsd = resolveGsdRoot(projectDir);\n  const knowledgePath = resolveRootFile(gsd, 'KNOWLEDGE.md');\n\n  if (!existsSync(knowledgePath)) {\n    return { entries: [], counts: { rules: 0, patterns: 0, lessons: 0 } };\n  }\n\n  const content = readFileSync(knowledgePath, 'utf-8');\n  const entries = parseKnowledgeMarkdown(content);\n\n  return {\n    entries,\n    counts: {\n      rules: entries.filter((e) => e.type === 'rule').length,\n      patterns: entries.filter((e) => e.type === 'pattern').length,\n      lessons: entries.filter((e) => e.type === 'lesson').length,\n    },\n  };\n}\n"]}