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

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

@@ -0,0 +1,32 @@
+export interface MetricsUnit {
+    type: string;
+    id: string;
+    model: string;
+    startedAt: number;
+    finishedAt: number;
+    tokens: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        total: number;
+    };
+    cost: number;
+    toolCalls: number;
+    apiRequests: number;
+}
+export interface HistoryResult {
+    entries: MetricsUnit[];
+    totals: {
+        cost: number;
+        tokens: {
+            input: number;
+            output: number;
+            total: number;
+        };
+        units: number;
+        durationMs: number;
+    };
+}
+export declare function readHistory(projectDir: string, limit?: number): HistoryResult;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/readers/metrics.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAqCD,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CA4C7E"}

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

@@ -0,0 +1,74 @@
+// GSD MCP Server — metrics/history reader
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { readFileSync, existsSync } from 'node:fs';
+import { resolveGsdRoot, resolveRootFile } from './paths.js';
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+function parseMetricsJson(content) {
+    try {
+        const data = JSON.parse(content);
+        if (!data.units || !Array.isArray(data.units))
+            return [];
+        return data.units.map((u) => ({
+            type: String(u.type ?? 'unknown'),
+            id: String(u.id ?? ''),
+            model: String(u.model ?? 'unknown'),
+            startedAt: Number(u.startedAt ?? 0),
+            finishedAt: Number(u.finishedAt ?? 0),
+            tokens: {
+                input: Number(u.tokens?.input ?? 0),
+                output: Number(u.tokens?.output ?? 0),
+                cacheRead: Number(u.tokens?.cacheRead ?? 0),
+                cacheWrite: Number(u.tokens?.cacheWrite ?? 0),
+                total: Number(u.tokens?.total ?? 0),
+            },
+            cost: Number(u.cost ?? 0),
+            toolCalls: Number(u.toolCalls ?? 0),
+            apiRequests: Number(u.apiRequests ?? 0),
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function readHistory(projectDir, limit) {
+    const gsd = resolveGsdRoot(projectDir);
+    // metrics.json (primary)
+    const metricsPath = resolveRootFile(gsd, 'metrics.json');
+    let units = [];
+    if (existsSync(metricsPath)) {
+        const content = readFileSync(metricsPath, 'utf-8');
+        units = parseMetricsJson(content);
+    }
+    // Sort by startedAt descending (most recent first)
+    units.sort((a, b) => b.startedAt - a.startedAt);
+    // Apply limit
+    if (limit && limit > 0) {
+        units = units.slice(0, limit);
+    }
+    // Compute totals from ALL units (not just limited set)
+    const allUnits = existsSync(metricsPath)
+        ? parseMetricsJson(readFileSync(metricsPath, 'utf-8'))
+        : [];
+    const totals = {
+        cost: 0,
+        tokens: { input: 0, output: 0, total: 0 },
+        units: allUnits.length,
+        durationMs: 0,
+    };
+    for (const u of allUnits) {
+        totals.cost += u.cost;
+        totals.tokens.input += u.tokens.input;
+        totals.tokens.output += u.tokens.output;
+        totals.tokens.total += u.tokens.total;
+        totals.durationMs += (u.finishedAt - u.startedAt);
+    }
+    // Round cost to 4 decimal places
+    totals.cost = Math.round(totals.cost * 10000) / 10000;
+    return { entries: units, totals };
+}
+//# sourceMappingURL=metrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/readers/metrics.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD MCP Server — metrics/history 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 interface MetricsUnit {\n  type: string;\n  id: string;\n  model: string;\n  startedAt: number;\n  finishedAt: number;\n  tokens: {\n    input: number;\n    output: number;\n    cacheRead: number;\n    cacheWrite: number;\n    total: number;\n  };\n  cost: number;\n  toolCalls: number;\n  apiRequests: number;\n}\n\nexport interface HistoryResult {\n  entries: MetricsUnit[];\n  totals: {\n    cost: number;\n    tokens: { input: number; output: number; total: number };\n    units: number;\n    durationMs: number;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Parser\n// ---------------------------------------------------------------------------\n\nfunction parseMetricsJson(content: string): MetricsUnit[] {\n  try {\n    const data = JSON.parse(content);\n    if (!data.units || !Array.isArray(data.units)) return [];\n\n    return data.units.map((u: Record<string, unknown>) => ({\n      type: String(u.type ?? 'unknown'),\n      id: String(u.id ?? ''),\n      model: String(u.model ?? 'unknown'),\n      startedAt: Number(u.startedAt ?? 0),\n      finishedAt: Number(u.finishedAt ?? 0),\n      tokens: {\n        input: Number((u.tokens as Record<string, unknown>)?.input ?? 0),\n        output: Number((u.tokens as Record<string, unknown>)?.output ?? 0),\n        cacheRead: Number((u.tokens as Record<string, unknown>)?.cacheRead ?? 0),\n        cacheWrite: Number((u.tokens as Record<string, unknown>)?.cacheWrite ?? 0),\n        total: Number((u.tokens as Record<string, unknown>)?.total ?? 0),\n      },\n      cost: Number(u.cost ?? 0),\n      toolCalls: Number(u.toolCalls ?? 0),\n      apiRequests: Number(u.apiRequests ?? 0),\n    }));\n  } catch {\n    return [];\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\nexport function readHistory(projectDir: string, limit?: number): HistoryResult {\n  const gsd = resolveGsdRoot(projectDir);\n\n  // metrics.json (primary)\n  const metricsPath = resolveRootFile(gsd, 'metrics.json');\n  let units: MetricsUnit[] = [];\n\n  if (existsSync(metricsPath)) {\n    const content = readFileSync(metricsPath, 'utf-8');\n    units = parseMetricsJson(content);\n  }\n\n  // Sort by startedAt descending (most recent first)\n  units.sort((a, b) => b.startedAt - a.startedAt);\n\n  // Apply limit\n  if (limit && limit > 0) {\n    units = units.slice(0, limit);\n  }\n\n  // Compute totals from ALL units (not just limited set)\n  const allUnits = existsSync(metricsPath)\n    ? parseMetricsJson(readFileSync(metricsPath, 'utf-8'))\n    : [];\n\n  const totals = {\n    cost: 0,\n    tokens: { input: 0, output: 0, total: 0 },\n    units: allUnits.length,\n    durationMs: 0,\n  };\n\n  for (const u of allUnits) {\n    totals.cost += u.cost;\n    totals.tokens.input += u.tokens.input;\n    totals.tokens.output += u.tokens.output;\n    totals.tokens.total += u.tokens.total;\n    totals.durationMs += (u.finishedAt - u.startedAt);\n  }\n\n  // Round cost to 4 decimal places\n  totals.cost = Math.round(totals.cost * 10000) / 10000;\n\n  return { entries: units, totals };\n}\n"]}

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

@@ -0,0 +1,42 @@
+/**
+ * Resolve the .gsd/ root directory for a project.
+ *
+ * Probes in order:
+ *   1. projectDir/.gsd (fast path)
+ *   2. git repo root/.gsd
+ *   3. Walk up from projectDir
+ *   4. Fallback: projectDir/.gsd (even if missing — for init)
+ */
+export declare function resolveGsdRoot(projectDir: string): string;
+/** Resolve path to a .gsd/ root file (STATE.md, KNOWLEDGE.md, etc.) */
+export declare function resolveRootFile(gsdRoot: string, name: string): string;
+/** Resolve path to milestones directory */
+export declare function milestonesDir(gsdRoot: string): string;
+/**
+ * Find all milestone directory IDs (M001, M002, etc.).
+ * Handles both bare (M001/) and descriptor (M001-FLIGHT-SIM/) naming.
+ */
+export declare function findMilestoneIds(gsdRoot: string): string[];
+/**
+ * Resolve the actual directory name for a milestone ID.
+ * M001 might live in M001/ or M001-SOME-DESCRIPTOR/.
+ */
+export declare function resolveMilestoneDir(gsdRoot: string, milestoneId: string): string | null;
+/**
+ * Resolve a milestone-level file (M001-ROADMAP.md, M001-CONTEXT.md, etc.).
+ * Handles various naming conventions.
+ */
+export declare function resolveMilestoneFile(gsdRoot: string, milestoneId: string, suffix: string): string | null;
+/** Find all slice IDs within a milestone (S01, S02, etc.) */
+export declare function findSliceIds(gsdRoot: string, milestoneId: string): string[];
+/** Resolve the actual directory for a slice */
+export declare function resolveSliceDir(gsdRoot: string, milestoneId: string, sliceId: string): string | null;
+/** Resolve a slice-level file (S01-PLAN.md, etc.) */
+export declare function resolveSliceFile(gsdRoot: string, milestoneId: string, sliceId: string, suffix: string): string | null;
+/** Find all task files in a slice's tasks/ directory */
+export declare function findTaskFiles(gsdRoot: string, milestoneId: string, sliceId: string): Array<{
+    id: string;
+    hasPlan: boolean;
+    hasSummary: boolean;
+}>;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/readers/paths.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAoCzD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBvF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBxG;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB3E;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBpG;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GACpE,MAAM,GAAG,IAAI,CAef;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GACpD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAuB9D"}

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

@@ -0,0 +1,199 @@
+// GSD MCP Server — .gsd/ directory resolution
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { existsSync, statSync, readdirSync } from 'node:fs';
+import { join, resolve, dirname, basename } from 'node:path';
+import { execFileSync } from 'node:child_process';
+/**
+ * Resolve the .gsd/ root directory for a project.
+ *
+ * Probes in order:
+ *   1. projectDir/.gsd (fast path)
+ *   2. git repo root/.gsd
+ *   3. Walk up from projectDir
+ *   4. Fallback: projectDir/.gsd (even if missing — for init)
+ */
+export function resolveGsdRoot(projectDir) {
+    const resolved = resolve(projectDir);
+    // Fast path: .gsd/ in the given directory
+    const direct = join(resolved, '.gsd');
+    if (existsSync(direct) && statSync(direct).isDirectory()) {
+        return direct;
+    }
+    // Try git repo root
+    try {
+        const gitRoot = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+            cwd: resolved,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const gitGsd = join(gitRoot, '.gsd');
+        if (existsSync(gitGsd) && statSync(gitGsd).isDirectory()) {
+            return gitGsd;
+        }
+    }
+    catch {
+        // Not a git repo or git not available
+    }
+    // Walk up from projectDir
+    let dir = resolved;
+    while (dir !== dirname(dir)) {
+        const candidate = join(dir, '.gsd');
+        if (existsSync(candidate) && statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+        dir = dirname(dir);
+    }
+    // Fallback
+    return direct;
+}
+/** Resolve path to a .gsd/ root file (STATE.md, KNOWLEDGE.md, etc.) */
+export function resolveRootFile(gsdRoot, name) {
+    return join(gsdRoot, name);
+}
+/** Resolve path to milestones directory */
+export function milestonesDir(gsdRoot) {
+    return join(gsdRoot, 'milestones');
+}
+/**
+ * Find all milestone directory IDs (M001, M002, etc.).
+ * Handles both bare (M001/) and descriptor (M001-FLIGHT-SIM/) naming.
+ */
+export function findMilestoneIds(gsdRoot) {
+    const dir = milestonesDir(gsdRoot);
+    if (!existsSync(dir))
+        return [];
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const ids = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const match = entry.name.match(/^(M\d+)/);
+        if (match)
+            ids.push(match[1]);
+    }
+    return ids.sort();
+}
+/**
+ * Resolve the actual directory name for a milestone ID.
+ * M001 might live in M001/ or M001-SOME-DESCRIPTOR/.
+ */
+export function resolveMilestoneDir(gsdRoot, milestoneId) {
+    const dir = milestonesDir(gsdRoot);
+    if (!existsSync(dir))
+        return null;
+    // Fast path: exact match
+    const exact = join(dir, milestoneId);
+    if (existsSync(exact) && statSync(exact).isDirectory())
+        return exact;
+    // Prefix match
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && entry.name.startsWith(milestoneId)) {
+            return join(dir, entry.name);
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a milestone-level file (M001-ROADMAP.md, M001-CONTEXT.md, etc.).
+ * Handles various naming conventions.
+ */
+export function resolveMilestoneFile(gsdRoot, milestoneId, suffix) {
+    const mDir = resolveMilestoneDir(gsdRoot, milestoneId);
+    if (!mDir)
+        return null;
+    const dirName = basename(mDir);
+    // Try: M001-ROADMAP.md, then DIRNAME-ROADMAP.md
+    const candidates = [
+        join(mDir, `${milestoneId}-${suffix}.md`),
+        join(mDir, `${dirName}-${suffix}.md`),
+        join(mDir, `${suffix}.md`),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+/** Find all slice IDs within a milestone (S01, S02, etc.) */
+export function findSliceIds(gsdRoot, milestoneId) {
+    const mDir = resolveMilestoneDir(gsdRoot, milestoneId);
+    if (!mDir)
+        return [];
+    const slicesDir = join(mDir, 'slices');
+    if (!existsSync(slicesDir))
+        return [];
+    const entries = readdirSync(slicesDir, { withFileTypes: true });
+    const ids = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const match = entry.name.match(/^(S\d+)/);
+        if (match)
+            ids.push(match[1]);
+    }
+    return ids.sort();
+}
+/** Resolve the actual directory for a slice */
+export function resolveSliceDir(gsdRoot, milestoneId, sliceId) {
+    const mDir = resolveMilestoneDir(gsdRoot, milestoneId);
+    if (!mDir)
+        return null;
+    const slicesDir = join(mDir, 'slices');
+    if (!existsSync(slicesDir))
+        return null;
+    const exact = join(slicesDir, sliceId);
+    if (existsSync(exact) && statSync(exact).isDirectory())
+        return exact;
+    const entries = readdirSync(slicesDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && entry.name.startsWith(sliceId)) {
+            return join(slicesDir, entry.name);
+        }
+    }
+    return null;
+}
+/** Resolve a slice-level file (S01-PLAN.md, etc.) */
+export function resolveSliceFile(gsdRoot, milestoneId, sliceId, suffix) {
+    const sDir = resolveSliceDir(gsdRoot, milestoneId, sliceId);
+    if (!sDir)
+        return null;
+    const dirName = basename(sDir);
+    const candidates = [
+        join(sDir, `${sliceId}-${suffix}.md`),
+        join(sDir, `${dirName}-${suffix}.md`),
+        join(sDir, `${suffix}.md`),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+/** Find all task files in a slice's tasks/ directory */
+export function findTaskFiles(gsdRoot, milestoneId, sliceId) {
+    const sDir = resolveSliceDir(gsdRoot, milestoneId, sliceId);
+    if (!sDir)
+        return [];
+    const tasksDir = join(sDir, 'tasks');
+    if (!existsSync(tasksDir))
+        return [];
+    const files = readdirSync(tasksDir);
+    const taskMap = new Map();
+    for (const f of files) {
+        const match = f.match(/^(T\d+).*-(PLAN|SUMMARY)\.md$/i);
+        if (!match)
+            continue;
+        const [, id, type] = match;
+        const existing = taskMap.get(id) ?? { hasPlan: false, hasSummary: false };
+        if (type.toUpperCase() === 'PLAN')
+            existing.hasPlan = true;
+        if (type.toUpperCase() === 'SUMMARY')
+            existing.hasSummary = true;
+        taskMap.set(id, existing);
+    }
+    return Array.from(taskMap.entries())
+        .map(([id, info]) => ({ id, ...info }))
+        .sort((a, b) => a.id.localeCompare(b.id));
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/readers/paths.ts"],"names":[],"mappings":"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","sourcesContent":["// GSD MCP Server — .gsd/ directory resolution\n// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>\n\nimport { existsSync, statSync, readdirSync } from 'node:fs';\nimport { join, resolve, dirname, basename } from 'node:path';\nimport { execFileSync } from 'node:child_process';\n\n/**\n * Resolve the .gsd/ root directory for a project.\n *\n * Probes in order:\n *   1. projectDir/.gsd (fast path)\n *   2. git repo root/.gsd\n *   3. Walk up from projectDir\n *   4. Fallback: projectDir/.gsd (even if missing — for init)\n */\nexport function resolveGsdRoot(projectDir: string): string {\n  const resolved = resolve(projectDir);\n\n  // Fast path: .gsd/ in the given directory\n  const direct = join(resolved, '.gsd');\n  if (existsSync(direct) && statSync(direct).isDirectory()) {\n    return direct;\n  }\n\n  // Try git repo root\n  try {\n    const gitRoot = execFileSync('git', ['rev-parse', '--show-toplevel'], {\n      cwd: resolved,\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    }).trim();\n    const gitGsd = join(gitRoot, '.gsd');\n    if (existsSync(gitGsd) && statSync(gitGsd).isDirectory()) {\n      return gitGsd;\n    }\n  } catch {\n    // Not a git repo or git not available\n  }\n\n  // Walk up from projectDir\n  let dir = resolved;\n  while (dir !== dirname(dir)) {\n    const candidate = join(dir, '.gsd');\n    if (existsSync(candidate) && statSync(candidate).isDirectory()) {\n      return candidate;\n    }\n    dir = dirname(dir);\n  }\n\n  // Fallback\n  return direct;\n}\n\n/** Resolve path to a .gsd/ root file (STATE.md, KNOWLEDGE.md, etc.) */\nexport function resolveRootFile(gsdRoot: string, name: string): string {\n  return join(gsdRoot, name);\n}\n\n/** Resolve path to milestones directory */\nexport function milestonesDir(gsdRoot: string): string {\n  return join(gsdRoot, 'milestones');\n}\n\n/**\n * Find all milestone directory IDs (M001, M002, etc.).\n * Handles both bare (M001/) and descriptor (M001-FLIGHT-SIM/) naming.\n */\nexport function findMilestoneIds(gsdRoot: string): string[] {\n  const dir = milestonesDir(gsdRoot);\n  if (!existsSync(dir)) return [];\n\n  const entries = readdirSync(dir, { withFileTypes: true });\n  const ids: string[] = [];\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n    const match = entry.name.match(/^(M\\d+)/);\n    if (match) ids.push(match[1]);\n  }\n\n  return ids.sort();\n}\n\n/**\n * Resolve the actual directory name for a milestone ID.\n * M001 might live in M001/ or M001-SOME-DESCRIPTOR/.\n */\nexport function resolveMilestoneDir(gsdRoot: string, milestoneId: string): string | null {\n  const dir = milestonesDir(gsdRoot);\n  if (!existsSync(dir)) return null;\n\n  // Fast path: exact match\n  const exact = join(dir, milestoneId);\n  if (existsSync(exact) && statSync(exact).isDirectory()) return exact;\n\n  // Prefix match\n  const entries = readdirSync(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (entry.isDirectory() && entry.name.startsWith(milestoneId)) {\n      return join(dir, entry.name);\n    }\n  }\n\n  return null;\n}\n\n/**\n * Resolve a milestone-level file (M001-ROADMAP.md, M001-CONTEXT.md, etc.).\n * Handles various naming conventions.\n */\nexport function resolveMilestoneFile(gsdRoot: string, milestoneId: string, suffix: string): string | null {\n  const mDir = resolveMilestoneDir(gsdRoot, milestoneId);\n  if (!mDir) return null;\n\n  const dirName = basename(mDir);\n\n  // Try: M001-ROADMAP.md, then DIRNAME-ROADMAP.md\n  const candidates = [\n    join(mDir, `${milestoneId}-${suffix}.md`),\n    join(mDir, `${dirName}-${suffix}.md`),\n    join(mDir, `${suffix}.md`),\n  ];\n\n  for (const c of candidates) {\n    if (existsSync(c)) return c;\n  }\n  return null;\n}\n\n/** Find all slice IDs within a milestone (S01, S02, etc.) */\nexport function findSliceIds(gsdRoot: string, milestoneId: string): string[] {\n  const mDir = resolveMilestoneDir(gsdRoot, milestoneId);\n  if (!mDir) return [];\n\n  const slicesDir = join(mDir, 'slices');\n  if (!existsSync(slicesDir)) return [];\n\n  const entries = readdirSync(slicesDir, { withFileTypes: true });\n  const ids: string[] = [];\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n    const match = entry.name.match(/^(S\\d+)/);\n    if (match) ids.push(match[1]);\n  }\n\n  return ids.sort();\n}\n\n/** Resolve the actual directory for a slice */\nexport function resolveSliceDir(gsdRoot: string, milestoneId: string, sliceId: string): string | null {\n  const mDir = resolveMilestoneDir(gsdRoot, milestoneId);\n  if (!mDir) return null;\n\n  const slicesDir = join(mDir, 'slices');\n  if (!existsSync(slicesDir)) return null;\n\n  const exact = join(slicesDir, sliceId);\n  if (existsSync(exact) && statSync(exact).isDirectory()) return exact;\n\n  const entries = readdirSync(slicesDir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (entry.isDirectory() && entry.name.startsWith(sliceId)) {\n      return join(slicesDir, entry.name);\n    }\n  }\n  return null;\n}\n\n/** Resolve a slice-level file (S01-PLAN.md, etc.) */\nexport function resolveSliceFile(\n  gsdRoot: string, milestoneId: string, sliceId: string, suffix: string,\n): string | null {\n  const sDir = resolveSliceDir(gsdRoot, milestoneId, sliceId);\n  if (!sDir) return null;\n\n  const dirName = basename(sDir);\n  const candidates = [\n    join(sDir, `${sliceId}-${suffix}.md`),\n    join(sDir, `${dirName}-${suffix}.md`),\n    join(sDir, `${suffix}.md`),\n  ];\n\n  for (const c of candidates) {\n    if (existsSync(c)) return c;\n  }\n  return null;\n}\n\n/** Find all task files in a slice's tasks/ directory */\nexport function findTaskFiles(\n  gsdRoot: string, milestoneId: string, sliceId: string,\n): Array<{ id: string; hasPlan: boolean; hasSummary: boolean }> {\n  const sDir = resolveSliceDir(gsdRoot, milestoneId, sliceId);\n  if (!sDir) return [];\n\n  const tasksDir = join(sDir, 'tasks');\n  if (!existsSync(tasksDir)) return [];\n\n  const files = readdirSync(tasksDir);\n  const taskMap = new Map<string, { hasPlan: boolean; hasSummary: boolean }>();\n\n  for (const f of files) {\n    const match = f.match(/^(T\\d+).*-(PLAN|SUMMARY)\\.md$/i);\n    if (!match) continue;\n    const [, id, type] = match;\n    const existing = taskMap.get(id) ?? { hasPlan: false, hasSummary: false };\n    if (type.toUpperCase() === 'PLAN') existing.hasPlan = true;\n    if (type.toUpperCase() === 'SUMMARY') existing.hasSummary = true;\n    taskMap.set(id, existing);\n  }\n\n  return Array.from(taskMap.entries())\n    .map(([id, info]) => ({ id, ...info }))\n    .sort((a, b) => a.id.localeCompare(b.id));\n}\n"]}

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

@@ -0,0 +1,26 @@
+export interface TaskInfo {
+    id: string;
+    title: string;
+    status: 'done' | 'pending';
+}
+export interface SliceInfo {
+    id: string;
+    title: string;
+    status: 'done' | 'active' | 'pending';
+    risk: string;
+    depends: string[];
+    demo: string;
+    tasks: TaskInfo[];
+}
+export interface MilestoneInfo {
+    id: string;
+    title: string;
+    status: 'done' | 'active' | 'pending' | 'parked';
+    vision: string;
+    slices: SliceInfo[];
+}
+export interface RoadmapResult {
+    milestones: MilestoneInfo[];
+}
+export declare function readRoadmap(projectDir: string, filterMilestoneId?: string): RoadmapResult;
+//# sourceMappingURL=roadmap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../src/readers/roadmap.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AA4ID,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,aAAa,CA+EzF"}

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

@@ -0,0 +1,194 @@
+// GSD MCP Server — roadmap structure reader
+// Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
+import { readFileSync, existsSync } from 'node:fs';
+import { resolveGsdRoot, findMilestoneIds, resolveMilestoneFile, findSliceIds, resolveSliceFile, findTaskFiles, } from './paths.js';
+// ---------------------------------------------------------------------------
+// ROADMAP.md table parser
+// ---------------------------------------------------------------------------
+function parseRoadmapTable(content) {
+    const results = [];
+    // Try table format first: | S01 | Title | risk | depends | done-icon | demo |
+    const tableSection = content.match(/## (?:Slice[s]?|Slice Overview|Slice Table)\s*\n([\s\S]*?)(?=\n##|\n$|$)/i);
+    if (tableSection) {
+        const lines = tableSection[1].split('\n');
+        for (const line of lines) {
+            if (!line.includes('|'))
+                continue;
+            const cells = line.split('|').map((c) => c.trim()).filter(Boolean);
+            if (cells.length < 4)
+                continue;
+            if (cells[0] === 'ID' || cells[0].startsWith('--'))
+                continue;
+            const id = cells[0].match(/S\d+/)?.[0];
+            if (!id)
+                continue;
+            const done = cells.some((c) => c === '\u2611' || c === '\u2705' || c.toLowerCase() === 'done');
+            const depends = (cells[3] ?? '').replace(/\u2014/g, '').split(',').map((d) => d.trim()).filter(Boolean);
+            results.push({
+                id,
+                title: cells[1] ?? '',
+                risk: cells[2] ?? 'medium',
+                depends,
+                done,
+                demo: cells[5] ?? '',
+            });
+        }
+        if (results.length > 0)
+            return results;
+    }
+    // Try checkbox format: - [x] **S01: Title** `risk:high` `depends:[S01]`
+    const checkboxRe = /^-\s+\[([ xX])\]\s+\*\*(S\d+):\s*(.+?)\*\*(?:.*?`risk:(\w+)`)?(?:.*?`depends:\[([^\]]*)\]`)?/gm;
+    let match;
+    while ((match = checkboxRe.exec(content)) !== null) {
+        const [, checked, id, title, risk, deps] = match;
+        results.push({
+            id,
+            title: title.trim(),
+            risk: risk ?? 'medium',
+            depends: deps ? deps.split(',').map((d) => d.trim()).filter(Boolean) : [],
+            done: checked !== ' ',
+            demo: '',
+        });
+    }
+    if (results.length > 0)
+        return results;
+    // Try prose headers: ## S01: Title
+    const headerRe = /^##\s+(S\d+):\s*(.+)/gm;
+    while ((match = headerRe.exec(content)) !== null) {
+        results.push({
+            id: match[1],
+            title: match[2].trim(),
+            risk: 'medium',
+            depends: [],
+            done: false,
+            demo: '',
+        });
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// PLAN.md task parser
+// ---------------------------------------------------------------------------
+function parseSlicePlanTasks(content) {
+    const results = [];
+    // Checkbox format: - [x] **T01: Title** — description
+    const taskRe = /^-\s+\[([ xX])\]\s+\*\*(T\d+):\s*(.+?)\*\*/gm;
+    let match;
+    while ((match = taskRe.exec(content)) !== null) {
+        results.push({
+            id: match[2],
+            title: match[3].trim(),
+            done: match[1] !== ' ',
+        });
+    }
+    if (results.length > 0)
+        return results;
+    // H3 format: ### T01: Title
+    const h3Re = /^###\s+(T\d+):\s*(.+)/gm;
+    while ((match = h3Re.exec(content)) !== null) {
+        results.push({
+            id: match[1],
+            title: match[2].trim(),
+            done: false,
+        });
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Milestone title from CONTEXT.md or ROADMAP.md H1
+// ---------------------------------------------------------------------------
+function readMilestoneTitle(gsdRoot, mid) {
+    const ctxPath = resolveMilestoneFile(gsdRoot, mid, 'CONTEXT');
+    if (ctxPath && existsSync(ctxPath)) {
+        const content = readFileSync(ctxPath, 'utf-8');
+        const h1 = content.match(/^#\s+(?:M\d+:?\s*)?(.+)/m);
+        if (h1)
+            return h1[1].trim();
+    }
+    const roadmapPath = resolveMilestoneFile(gsdRoot, mid, 'ROADMAP');
+    if (roadmapPath && existsSync(roadmapPath)) {
+        const content = readFileSync(roadmapPath, 'utf-8');
+        const h1 = content.match(/^#\s+(?:M\d+:?\s*)?(.+)/m);
+        if (h1)
+            return h1[1].trim();
+    }
+    return mid;
+}
+function readVision(gsdRoot, mid) {
+    const roadmapPath = resolveMilestoneFile(gsdRoot, mid, 'ROADMAP');
+    if (!roadmapPath || !existsSync(roadmapPath))
+        return '';
+    const content = readFileSync(roadmapPath, 'utf-8');
+    const section = content.match(/## Vision\s*\n([\s\S]*?)(?=\n##|\n$|$)/i);
+    return section ? section[1].trim() : '';
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function readRoadmap(projectDir, filterMilestoneId) {
+    const gsd = resolveGsdRoot(projectDir);
+    let milestoneIds = findMilestoneIds(gsd);
+    if (filterMilestoneId) {
+        milestoneIds = milestoneIds.filter((id) => id === filterMilestoneId);
+    }
+    const milestones = [];
+    for (const mid of milestoneIds) {
+        const title = readMilestoneTitle(gsd, mid);
+        const vision = readVision(gsd, mid);
+        const summaryPath = resolveMilestoneFile(gsd, mid, 'SUMMARY');
+        const hasSummary = summaryPath !== null && existsSync(summaryPath);
+        const roadmapPath = resolveMilestoneFile(gsd, mid, 'ROADMAP');
+        let roadmapSlices = [];
+        if (roadmapPath && existsSync(roadmapPath)) {
+            roadmapSlices = parseRoadmapTable(readFileSync(roadmapPath, 'utf-8'));
+        }
+        const fsSliceIds = findSliceIds(gsd, mid);
+        const sliceIdSet = new Set([
+            ...roadmapSlices.map((s) => s.id),
+            ...fsSliceIds,
+        ]);
+        const slices = [];
+        for (const sid of Array.from(sliceIdSet).sort()) {
+            const roadmapEntry = roadmapSlices.find((s) => s.id === sid);
+            const taskFiles = findTaskFiles(gsd, mid, sid);
+            const planPath = resolveSliceFile(gsd, mid, sid, 'PLAN');
+            let planTasks = [];
+            if (planPath && existsSync(planPath)) {
+                planTasks = parseSlicePlanTasks(readFileSync(planPath, 'utf-8'));
+            }
+            const tasks = [];
+            const seenIds = new Set();
+            for (const pt of planTasks) {
+                const fsTask = taskFiles.find((t) => t.id === pt.id);
+                const done = fsTask?.hasSummary ?? pt.done;
+                tasks.push({ id: pt.id, title: pt.title, status: done ? 'done' : 'pending' });
+                seenIds.add(pt.id);
+            }
+            for (const ft of taskFiles) {
+                if (seenIds.has(ft.id))
+                    continue;
+                tasks.push({ id: ft.id, title: ft.id, status: ft.hasSummary ? 'done' : 'pending' });
+            }
+            const allDone = tasks.length > 0 && tasks.every((t) => t.status === 'done');
+            const anyDone = tasks.some((t) => t.status === 'done');
+            const sliceStatus = allDone ? 'done' : anyDone ? 'active' : 'pending';
+            slices.push({
+                id: sid,
+                title: roadmapEntry?.title ?? sid,
+                status: sliceStatus,
+                risk: roadmapEntry?.risk ?? 'medium',
+                depends: roadmapEntry?.depends ?? [],
+                demo: roadmapEntry?.demo ?? '',
+                tasks,
+            });
+        }
+        const allSlicesDone = slices.length > 0 && slices.every((s) => s.status === 'done');
+        const anySliceActive = slices.some((s) => s.status === 'active' || s.status === 'done');
+        const milestoneStatus = hasSummary
+            ? 'done'
+            : allSlicesDone ? 'done' : anySliceActive ? 'active' : 'pending';
+        milestones.push({ id: mid, title, status: milestoneStatus, vision, slices });
+    }
+    return { milestones };
+}
+//# sourceMappingURL=roadmap.js.map