gsd-pi 2.79.0 → 2.80.0-dev.c5f2443b3

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAsB,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMjH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAMrG,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;IAEtB,wDAAwD;IACxD,MAAM,EAAE,SAAS,CAAC;IAElB,0DAA0D;IAC1D,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,sDAAsD;IACtD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAEtC,sDAAsD;IACtD,IAAI,EAAE,eAAe,CAAC;IAEtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAMD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IAEX,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,wCAAwC;IACxC,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAMD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAMD,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,uDAAuD;AACvD,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,gDAAgD;AAChD,eAAO,MAAM,eAAe,QAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,iBAAiB,IAAI,cAAc,EAEnC,aAAa,EACd,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAMrG,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;IAEtB,wDAAwD;IACxD,MAAM,EAAE,SAAS,CAAC;IAElB,0DAA0D;IAC1D,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,sDAAsD;IACtD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAEtC,sDAAsD;IACtD,IAAI,EAAE,eAAe,CAAC;IAEtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,YAAY,EAAE,cAAc,EAAE,CAAC;AAM/B,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAMD,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,uDAAuD;AACvD,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,gDAAgD;AAChD,eAAO,MAAM,eAAe,QAAS,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgGH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC","sourcesContent":["/**\n * MCP Server types — session lifecycle and orchestration.\n */\n\nimport type { RpcClient, SdkAgentEvent, RpcCostUpdateEvent, RpcExtensionUIRequest } from '@gsd-build/rpc-client';\n\n// ---------------------------------------------------------------------------\n// Session Status\n// ---------------------------------------------------------------------------\n\nexport type SessionStatus = 'starting' | 'running' | 'blocked' | 'completed' | 'error' | 'cancelled';\n\n// ---------------------------------------------------------------------------\n// Managed Session\n// ---------------------------------------------------------------------------\n\nexport interface ManagedSession {\n  /** Unique session ID returned from RpcClient.init() */\n  sessionId: string;\n\n  /** Absolute path to the project directory */\n  projectDir: string;\n\n  /** Current lifecycle status */\n  status: SessionStatus;\n\n  /** The RpcClient instance managing the agent process */\n  client: RpcClient;\n\n  /** Ring buffer of recent events (capped at MAX_EVENTS) */\n  events: SdkAgentEvent[];\n\n  /** Pending blocker requiring user response, if any */\n  pendingBlocker: PendingBlocker | null;\n\n  /** Cumulative cost tracking (max pattern per K004) */\n  cost: CostAccumulator;\n\n  /** Session start timestamp */\n  startTime: number;\n\n  /** Error message if status is 'error' */\n  error?: string;\n\n  /** Cleanup function to unsubscribe from events */\n  unsubscribe?: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Pending Blocker\n// ---------------------------------------------------------------------------\n\nexport interface PendingBlocker {\n  /** The extension_ui_request id */\n  id: string;\n\n  /** The request method (e.g. 'select', 'confirm', 'input') */\n  method: string;\n\n  /** Human-readable message or title */\n  message: string;\n\n  /** Full event payload for inspection */\n  event: RpcExtensionUIRequest;\n}\n\n// ---------------------------------------------------------------------------\n// Cost Accumulator (K004 — cumulative-max)\n// ---------------------------------------------------------------------------\n\nexport interface CostAccumulator {\n  totalCost: number;\n  tokens: {\n    input: number;\n    output: number;\n    cacheRead: number;\n    cacheWrite: number;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Execute Options\n// ---------------------------------------------------------------------------\n\nexport interface ExecuteOptions {\n  /** Command to send after '/gsd auto' (default: none) */\n  command?: string;\n\n  /** Model ID override */\n  model?: string;\n\n  /** Run in bare mode (skip user config) */\n  bare?: boolean;\n\n  /** Path to CLI binary (overrides GSD_CLI_PATH and which resolution) */\n  cliPath?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Maximum number of events kept in the ring buffer */\nexport const MAX_EVENTS = 50;\n\n/** Timeout for RpcClient initialization (ms) */\nexport const INIT_TIMEOUT_MS = 30_000;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqFH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC","sourcesContent":["/**\n * MCP Server types — session lifecycle and orchestration.\n */\n\nimport type { RpcClient } from '@gsd-build/rpc-client';\nimport type {\n  McpPendingBlocker as PendingBlocker,\n  RpcCostUpdateEvent,\n  SdkAgentEvent,\n} from '@gsd-build/contracts';\n\n// ---------------------------------------------------------------------------\n// Session Status\n// ---------------------------------------------------------------------------\n\nexport type SessionStatus = 'starting' | 'running' | 'blocked' | 'completed' | 'error' | 'cancelled';\n\n// ---------------------------------------------------------------------------\n// Managed Session\n// ---------------------------------------------------------------------------\n\nexport interface ManagedSession {\n  /** Unique session ID returned from RpcClient.init() */\n  sessionId: string;\n\n  /** Absolute path to the project directory */\n  projectDir: string;\n\n  /** Current lifecycle status */\n  status: SessionStatus;\n\n  /** The RpcClient instance managing the agent process */\n  client: RpcClient;\n\n  /** Ring buffer of recent events (capped at MAX_EVENTS) */\n  events: SdkAgentEvent[];\n\n  /** Pending blocker requiring user response, if any */\n  pendingBlocker: PendingBlocker | null;\n\n  /** Cumulative cost tracking (max pattern per K004) */\n  cost: CostAccumulator;\n\n  /** Session start timestamp */\n  startTime: number;\n\n  /** Error message if status is 'error' */\n  error?: string;\n\n  /** Cleanup function to unsubscribe from events */\n  unsubscribe?: () => void;\n}\n\nexport type { PendingBlocker };\n\n// ---------------------------------------------------------------------------\n// Cost Accumulator (K004 — cumulative-max)\n// ---------------------------------------------------------------------------\n\nexport interface CostAccumulator {\n  totalCost: number;\n  tokens: {\n    input: number;\n    output: number;\n    cacheRead: number;\n    cacheWrite: number;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Execute Options\n// ---------------------------------------------------------------------------\n\nexport interface ExecuteOptions {\n  /** Command to send after '/gsd auto' (default: none) */\n  command?: string;\n\n  /** Model ID override */\n  model?: string;\n\n  /** Run in bare mode (skip user config) */\n  bare?: boolean;\n\n  /** Path to CLI binary (overrides GSD_CLI_PATH and which resolution) */\n  cliPath?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Maximum number of events kept in the ring buffer */\nexport const MAX_EVENTS = 50;\n\n/** Timeout for RpcClient initialization (ms) */\nexport const INIT_TIMEOUT_MS = 30_000;\n"]}

package/packages/mcp-server/dist/workflow-tools.d.ts

@@ -13,7 +13,7 @@ export declare function _buildImportCandidates(relativePath: string): string[];
 interface McpToolServer {
     tool(name: string, description: string, params: Record<string, unknown>, handler: (args: Record<string, unknown>) => Promise<unknown>): unknown;
 }
-export declare const WORKFLOW_TOOL_NAMES: readonly ["gsd_decision_save", "gsd_save_decision", "gsd_requirement_update", "gsd_update_requirement", "gsd_requirement_save", "gsd_save_requirement", "gsd_milestone_generate_id", "gsd_generate_milestone_id", "gsd_plan_milestone", "gsd_plan_slice", "gsd_plan_task", "gsd_task_plan", "gsd_replan_slice", "gsd_slice_replan", "gsd_slice_complete", "gsd_complete_slice", "gsd_skip_slice", "gsd_complete_milestone", "gsd_milestone_complete", "gsd_validate_milestone", "gsd_milestone_validate", "gsd_reassess_roadmap", "gsd_roadmap_reassess", "gsd_save_gate_result", "gsd_summary_save", "gsd_task_complete", "gsd_complete_task", "gsd_milestone_status", "gsd_journal_query", "gsd_capture_thought", "gsd_memory_query", "gsd_memory_graph"];
+export declare const WORKFLOW_TOOL_NAMES: readonly string[];
 export declare function registerWorkflowTools(realServer: McpToolServer): void;
 export {};
 //# sourceMappingURL=workflow-tools.d.ts.map

package/packages/mcp-server/dist/workflow-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-tools.d.ts","sourceRoot":"","sources":["../src/workflow-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6RxB,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CA+BnG;AA8FD,wBAAgB,yBAAyB,CAAC,CAAC,SAAS;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACzE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,CAAC,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAE5B;AAkID,4CAA4C;AAC5C,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAKrE;AAgGD,UAAU,aAAa;IACrB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3D,OAAO,CAAC;CACZ;AAED,eAAO,MAAM,mBAAmB,6tBAoCtB,CAAC;AAuvBX,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAqiBrE"}
+{"version":3,"file":"workflow-tools.d.ts","sourceRoot":"","sources":["../src/workflow-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8RxB,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CA+BnG;AA8FD,wBAAgB,yBAAyB,CAAC,CAAC,SAAS;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACzE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,CAAC,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAE5B;AAkID,4CAA4C;AAC5C,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAKrE;AAgGD,UAAU,aAAa;IACrB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3D,OAAO,CAAC;CACZ;AAED,eAAO,MAAM,mBAAmB,mBAA+B,CAAC;AA+wBhE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CA2lBrE"}

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

@@ -6,6 +6,7 @@ import { homedir } from "node:os";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { z } from "zod";
+import { WORKFLOW_TOOL_NAMES as CONTRACT_WORKFLOW_TOOL_NAMES } from "@gsd-build/contracts";
 import { logAliasUsage } from "./alias-telemetry.js";
 let workflowToolExecutorsPromise = null;
 let workflowExecutionQueue = Promise.resolve();
@@ -350,43 +351,7 @@ async function getWorkflowWriteGateModule() {
     }
     return workflowWriteGatePromise;
 }
-export const WORKFLOW_TOOL_NAMES = [
-    "gsd_decision_save",
-    "gsd_save_decision",
-    "gsd_requirement_update",
-    "gsd_update_requirement",
-    "gsd_requirement_save",
-    "gsd_save_requirement",
-    "gsd_milestone_generate_id",
-    "gsd_generate_milestone_id",
-    "gsd_plan_milestone",
-    "gsd_plan_slice",
-    "gsd_plan_task",
-    "gsd_task_plan",
-    "gsd_replan_slice",
-    "gsd_slice_replan",
-    "gsd_slice_complete",
-    "gsd_complete_slice",
-    "gsd_skip_slice",
-    "gsd_complete_milestone",
-    "gsd_milestone_complete",
-    "gsd_validate_milestone",
-    "gsd_milestone_validate",
-    "gsd_reassess_roadmap",
-    "gsd_roadmap_reassess",
-    "gsd_save_gate_result",
-    "gsd_summary_save",
-    "gsd_task_complete",
-    "gsd_complete_task",
-    "gsd_milestone_status",
-    "gsd_journal_query",
-    // ADR-013 step 3: memory-store tools exposed to external MCP clients.
-    // gsd_memory_graph is namespaced to avoid collision with the existing
-    // gsd_graph tool (project knowledge graph from .gsd/ artifacts).
-    "gsd_capture_thought",
-    "gsd_memory_query",
-    "gsd_memory_graph",
-];
+export const WORKFLOW_TOOL_NAMES = CONTRACT_WORKFLOW_TOOL_NAMES;
 const DEFAULT_WORKFLOW_OP_TIMEOUT_MS = 5 * 60 * 1000;
 function getWorkflowOpTimeoutMs(env = process.env) {
     const raw = env.GSD_MCP_WORKFLOW_TIMEOUT_MS?.trim();
@@ -1006,6 +971,27 @@ const journalQueryParams = {
     limit: z.number().optional().describe("Maximum entries to return"),
 };
 const journalQuerySchema = z.object(journalQueryParams);
+const execRuntimeSchema = z.enum(["bash", "node", "python"]);
+const execParams = {
+    projectDir: projectDirParam,
+    runtime: execRuntimeSchema.describe("Interpreter: bash (-c), node (-e), or python3 (-c)."),
+    script: nonEmptyString("script").describe("Script body. Keep output small; full stdout/stderr are persisted under .gsd/exec."),
+    purpose: z.string().optional().describe("Short label recorded in meta.json for later review."),
+    timeout_ms: z.number().int().min(1_000).max(600_000).optional().describe("Per-invocation timeout in milliseconds."),
+};
+const execSchema = z.object(execParams);
+const execSearchParams = {
+    projectDir: projectDirParam,
+    query: z.string().optional().describe("Substring matched against id and purpose, case-insensitive."),
+    runtime: execRuntimeSchema.optional().describe("Restrict to one runtime."),
+    failing_only: z.boolean().optional().describe("Only non-zero exit codes and timeouts."),
+    limit: z.number().int().min(1).max(200).optional().describe("Max results (default 20, cap 200)."),
+};
+const execSearchSchema = z.object(execSearchParams);
+const resumeParams = {
+    projectDir: projectDirParam,
+};
+const resumeSchema = z.object(resumeParams);
 /**
  * Wrap a real McpToolServer so every handler we register catches thrown
  * errors and returns a structured `{isError: true, content: [...]}` MCP
@@ -1272,6 +1258,35 @@ export function registerWorkflowTools(realServer) {
         }
         return { content: [{ type: "text", text: JSON.stringify(entries, null, 2) }] };
     });
+    server.tool("gsd_exec", "Run a short bash/node/python script in the project directory. Full stdout/stderr persist under .gsd/exec; only a digest returns to MCP.", execParams, async (args) => {
+        const { projectDir, ...params } = parseWorkflowArgs(execSchema, args);
+        await enforceWorkflowWriteGate("gsd_exec", projectDir);
+        const [{ executeGsdExec }, { loadEffectiveGSDPreferences }] = await Promise.all([
+            importLocalModule("../../../src/resources/extensions/gsd/tools/exec-tool.js"),
+            importLocalModule("../../../src/resources/extensions/gsd/preferences.js"),
+        ]);
+        let prefs = null;
+        try {
+            prefs = loadEffectiveGSDPreferences(projectDir);
+        }
+        catch {
+            prefs = null;
+        }
+        return adaptExecutorResult(await runSerializedWorkflowOperation(() => executeGsdExec(params, {
+            baseDir: projectDir,
+            preferences: (prefs?.preferences ?? null),
+        })));
+    });
+    server.tool("gsd_exec_search", "Search prior gsd_exec runs from .gsd/exec/*.meta.json without re-running them.", execSearchParams, async (args) => {
+        const { projectDir, ...params } = parseWorkflowArgs(execSearchSchema, args);
+        const { executeExecSearch } = await importLocalModule("../../../src/resources/extensions/gsd/tools/exec-search-tool.js");
+        return adaptExecutorResult(executeExecSearch(params, { baseDir: projectDir }));
+    });
+    server.tool("gsd_resume", "Read .gsd/last-snapshot.md so agents can re-orient after compaction or session resume.", resumeParams, async (args) => {
+        const { projectDir, ...params } = parseWorkflowArgs(resumeSchema, args);
+        const { executeResume } = await importLocalModule("../../../src/resources/extensions/gsd/tools/resume-tool.js");
+        return adaptExecutorResult(executeResume(params, { baseDir: projectDir }));
+    });
     // ─── ADR-013 step 3 — memory-store tools for external MCP clients ────────
     //
     // The same three tools the LLM sees in-process as `capture_thought`,