gsd-pi 2.80.0 → 2.81.0-dev.3cddbbba2

package/packages/contracts/dist/rpc.js

@@ -0,0 +1,53 @@
+// Project/App: GSD-2
+// File Purpose: Canonical RPC protocol contracts shared across runtime, SDK, MCP, and app surfaces.
+export const RPC_CONTRACT_VERSION = 1;
+export const RPC_THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
+export const RPC_COMMAND_TYPES = [
+    "prompt",
+    "steer",
+    "follow_up",
+    "abort",
+    "new_session",
+    "get_state",
+    "set_model",
+    "cycle_model",
+    "get_available_models",
+    "set_thinking_level",
+    "cycle_thinking_level",
+    "set_steering_mode",
+    "set_follow_up_mode",
+    "compact",
+    "set_auto_compaction",
+    "set_auto_retry",
+    "abort_retry",
+    "bash",
+    "abort_bash",
+    "get_session_stats",
+    "export_html",
+    "switch_session",
+    "fork",
+    "get_fork_messages",
+    "get_last_assistant_text",
+    "set_session_name",
+    "get_messages",
+    "get_commands",
+    "terminal_input",
+    "terminal_resize",
+    "terminal_redraw",
+    "init",
+    "shutdown",
+    "subscribe",
+];
+export const RPC_V2_EVENT_TYPES = ["execution_complete", "cost_update"];
+export const RPC_EXTENSION_UI_METHODS = [
+    "select",
+    "confirm",
+    "input",
+    "editor",
+    "notify",
+    "setStatus",
+    "setWidget",
+    "setTitle",
+    "set_editor_text",
+];
+//# sourceMappingURL=rpc.js.map

package/packages/contracts/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,oGAAoG;AAEpG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEjG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,QAAQ;IACR,OAAO;IACP,WAAW;IACX,OAAO;IACP,aAAa;IACb,WAAW;IACX,WAAW;IACX,aAAa;IACb,sBAAsB;IACtB,oBAAoB;IACpB,sBAAsB;IACtB,mBAAmB;IACnB,oBAAoB;IACpB,SAAS;IACT,qBAAqB;IACrB,gBAAgB;IAChB,aAAa;IACb,MAAM;IACN,YAAY;IACZ,mBAAmB;IACnB,aAAa;IACb,gBAAgB;IAChB,MAAM;IACN,mBAAmB;IACnB,yBAAyB;IACzB,kBAAkB;IAClB,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,MAAM;IACN,UAAU;IACV,WAAW;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,oBAAoB,EAAE,aAAa,CAAU,CAAC;AAEjF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACvC,QAAQ;IACR,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,WAAW;IACX,UAAU;IACV,iBAAiB;CACR,CAAC","sourcesContent":["// Project/App: GSD-2\n// File Purpose: Canonical RPC protocol contracts shared across runtime, SDK, MCP, and app surfaces.\n\nexport const RPC_CONTRACT_VERSION = 1 as const;\n\nexport const RPC_THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"] as const;\n\nexport const RPC_COMMAND_TYPES = [\n\t\"prompt\",\n\t\"steer\",\n\t\"follow_up\",\n\t\"abort\",\n\t\"new_session\",\n\t\"get_state\",\n\t\"set_model\",\n\t\"cycle_model\",\n\t\"get_available_models\",\n\t\"set_thinking_level\",\n\t\"cycle_thinking_level\",\n\t\"set_steering_mode\",\n\t\"set_follow_up_mode\",\n\t\"compact\",\n\t\"set_auto_compaction\",\n\t\"set_auto_retry\",\n\t\"abort_retry\",\n\t\"bash\",\n\t\"abort_bash\",\n\t\"get_session_stats\",\n\t\"export_html\",\n\t\"switch_session\",\n\t\"fork\",\n\t\"get_fork_messages\",\n\t\"get_last_assistant_text\",\n\t\"set_session_name\",\n\t\"get_messages\",\n\t\"get_commands\",\n\t\"terminal_input\",\n\t\"terminal_resize\",\n\t\"terminal_redraw\",\n\t\"init\",\n\t\"shutdown\",\n\t\"subscribe\",\n] as const;\n\nexport const RPC_V2_EVENT_TYPES = [\"execution_complete\", \"cost_update\"] as const;\n\nexport const RPC_EXTENSION_UI_METHODS = [\n\t\"select\",\n\t\"confirm\",\n\t\"input\",\n\t\"editor\",\n\t\"notify\",\n\t\"setStatus\",\n\t\"setWidget\",\n\t\"setTitle\",\n\t\"set_editor_text\",\n] as const;\n\nexport type ThinkingLevel = (typeof RPC_THINKING_LEVELS)[number];\n\nexport interface ImageContent {\n\ttype: \"image\";\n\tdata: string;\n\tmimeType: string;\n}\n\nexport interface ModelInfo {\n\tprovider: string;\n\tid: string;\n\tcontextWindow?: number;\n\treasoning?: boolean;\n}\n\nexport interface SessionStats {\n\tsessionFile: string | undefined;\n\tsessionId: string;\n\tuserMessages: number;\n\tassistantMessages: number;\n\ttoolCalls: number;\n\ttoolResults: number;\n\ttotalMessages: number;\n\ttokens: {\n\t\tinput: number;\n\t\toutput: number;\n\t\tcacheRead: number;\n\t\tcacheWrite: number;\n\t\ttotal: number;\n\t};\n\tcost: number;\n}\n\nexport interface BashResult {\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n}\n\nexport interface CompactionResult<T = unknown> {\n\tsummary: string;\n\tfirstKeptEntryId: string;\n\ttokensBefore: number;\n\tdetails?: T;\n}\n\nexport type RpcProtocolVersion = 1 | 2;\n\nexport type RpcCommand =\n\t| { id?: string; type: \"prompt\"; message: string; images?: ImageContent[]; streamingBehavior?: \"steer\" | \"followUp\" }\n\t| { id?: string; type: \"steer\"; message: string; images?: ImageContent[] }\n\t| { id?: string; type: \"follow_up\"; message: string; images?: ImageContent[] }\n\t| { id?: string; type: \"abort\" }\n\t| { id?: string; type: \"new_session\"; parentSession?: string }\n\t| { id?: string; type: \"get_state\" }\n\t| { id?: string; type: \"set_model\"; provider: string; modelId: string }\n\t| { id?: string; type: \"cycle_model\" }\n\t| { id?: string; type: \"get_available_models\" }\n\t| { id?: string; type: \"set_thinking_level\"; level: ThinkingLevel }\n\t| { id?: string; type: \"cycle_thinking_level\" }\n\t| { id?: string; type: \"set_steering_mode\"; mode: \"all\" | \"one-at-a-time\" }\n\t| { id?: string; type: \"set_follow_up_mode\"; mode: \"all\" | \"one-at-a-time\" }\n\t| { id?: string; type: \"compact\"; customInstructions?: string }\n\t| { id?: string; type: \"set_auto_compaction\"; enabled: boolean }\n\t| { id?: string; type: \"set_auto_retry\"; enabled: boolean }\n\t| { id?: string; type: \"abort_retry\" }\n\t| { id?: string; type: \"bash\"; command: string }\n\t| { id?: string; type: \"abort_bash\" }\n\t| { id?: string; type: \"get_session_stats\" }\n\t| { id?: string; type: \"export_html\"; outputPath?: string }\n\t| { id?: string; type: \"switch_session\"; sessionPath: string }\n\t| { id?: string; type: \"fork\"; entryId: string }\n\t| { id?: string; type: \"get_fork_messages\" }\n\t| { id?: string; type: \"get_last_assistant_text\" }\n\t| { id?: string; type: \"set_session_name\"; name: string }\n\t| { id?: string; type: \"get_messages\" }\n\t| { id?: string; type: \"get_commands\" }\n\t| { id?: string; type: \"terminal_input\"; data: string }\n\t| { id?: string; type: \"terminal_resize\"; cols: number; rows: number }\n\t| { id?: string; type: \"terminal_redraw\" }\n\t| { id?: string; type: \"init\"; protocolVersion: 2; clientId?: string }\n\t| { id?: string; type: \"shutdown\"; graceful?: boolean }\n\t| { id?: string; type: \"subscribe\"; events: string[] };\n\nexport interface RpcSlashCommand {\n\tname: string;\n\tdescription?: string;\n\tsource: \"extension\" | \"prompt\" | \"skill\";\n\tlocation?: \"user\" | \"project\" | \"path\";\n\tpath?: string;\n}\n\nexport interface RpcSessionState {\n\tmodel?: ModelInfo;\n\tthinkingLevel: ThinkingLevel;\n\tisStreaming: boolean;\n\tisCompacting: boolean;\n\tsteeringMode: \"all\" | \"one-at-a-time\";\n\tfollowUpMode: \"all\" | \"one-at-a-time\";\n\tsessionFile?: string;\n\tsessionId: string;\n\tsessionName?: string;\n\tautoCompactionEnabled: boolean;\n\tautoRetryEnabled: boolean;\n\tretryInProgress: boolean;\n\tretryAttempt: number;\n\tmessageCount: number;\n\tpendingMessageCount: number;\n\textensionsReady: boolean;\n}\n\nexport type RpcResponse =\n\t| { id?: string; type: \"response\"; command: \"prompt\"; success: true; runId?: string }\n\t| { id?: string; type: \"response\"; command: \"steer\"; success: true; runId?: string }\n\t| { id?: string; type: \"response\"; command: \"follow_up\"; success: true; runId?: string }\n\t| { id?: string; type: \"response\"; command: \"abort\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"new_session\"; success: true; data: { cancelled: boolean } }\n\t| { id?: string; type: \"response\"; command: \"get_state\"; success: true; data: RpcSessionState }\n\t| { id?: string; type: \"response\"; command: \"set_model\"; success: true; data: ModelInfo }\n\t| {\n\t\t\tid?: string;\n\t\t\ttype: \"response\";\n\t\t\tcommand: \"cycle_model\";\n\t\t\tsuccess: true;\n\t\t\tdata: { model: ModelInfo; thinkingLevel: ThinkingLevel; isScoped: boolean } | null;\n\t  }\n\t| { id?: string; type: \"response\"; command: \"get_available_models\"; success: true; data: { models: ModelInfo[] } }\n\t| { id?: string; type: \"response\"; command: \"set_thinking_level\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"cycle_thinking_level\"; success: true; data: { level: ThinkingLevel } | null }\n\t| { id?: string; type: \"response\"; command: \"set_steering_mode\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"set_follow_up_mode\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"compact\"; success: true; data: CompactionResult }\n\t| { id?: string; type: \"response\"; command: \"set_auto_compaction\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"set_auto_retry\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"abort_retry\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"bash\"; success: true; data: BashResult }\n\t| { id?: string; type: \"response\"; command: \"abort_bash\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"get_session_stats\"; success: true; data: SessionStats }\n\t| { id?: string; type: \"response\"; command: \"export_html\"; success: true; data: { path: string } }\n\t| { id?: string; type: \"response\"; command: \"switch_session\"; success: true; data: { cancelled: boolean } }\n\t| { id?: string; type: \"response\"; command: \"fork\"; success: true; data: { text: string; cancelled: boolean } }\n\t| { id?: string; type: \"response\"; command: \"get_fork_messages\"; success: true; data: { messages: Array<{ entryId: string; text: string }> } }\n\t| { id?: string; type: \"response\"; command: \"get_last_assistant_text\"; success: true; data: { text: string | null } }\n\t| { id?: string; type: \"response\"; command: \"set_session_name\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"get_messages\"; success: true; data: { messages: unknown[] } }\n\t| { id?: string; type: \"response\"; command: \"get_commands\"; success: true; data: { commands: RpcSlashCommand[] } }\n\t| { id?: string; type: \"response\"; command: \"terminal_input\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"terminal_resize\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"terminal_redraw\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"init\"; success: true; data: RpcInitResult }\n\t| { id?: string; type: \"response\"; command: \"shutdown\"; success: true }\n\t| { id?: string; type: \"response\"; command: \"subscribe\"; success: true }\n\t| { id?: string; type: \"response\"; command: string; success: false; error: string };\n\nexport interface RpcInitResult {\n\tprotocolVersion: 2;\n\tsessionId: string;\n\tcapabilities: {\n\t\tevents: string[];\n\t\tcommands: string[];\n\t};\n}\n\nexport interface RpcExecutionCompleteEvent {\n\ttype: \"execution_complete\";\n\trunId: string;\n\tstatus: \"completed\" | \"error\" | \"cancelled\";\n\treason?: string;\n\tstats: SessionStats;\n}\n\nexport interface RpcCostUpdateEvent {\n\ttype: \"cost_update\";\n\trunId: string;\n\tturnCost: number;\n\tcumulativeCost: number;\n\ttokens: {\n\t\tinput: number;\n\t\toutput: number;\n\t\tcacheRead: number;\n\t\tcacheWrite: number;\n\t};\n}\n\nexport type RpcV2Event = RpcExecutionCompleteEvent | RpcCostUpdateEvent;\n\n/** Agent event — a loosely typed record from the RPC event stream. */\nexport interface SdkAgentEvent {\n\ttype: string;\n\t[key: string]: unknown;\n}\n\nexport type RpcExtensionUIRequest =\n\t| { type: \"extension_ui_request\"; id: string; method: \"select\"; title: string; options: string[]; timeout?: number; allowMultiple?: boolean }\n\t| { type: \"extension_ui_request\"; id: string; method: \"confirm\"; title: string; message: string; timeout?: number }\n\t| { type: \"extension_ui_request\"; id: string; method: \"input\"; title: string; placeholder?: string; timeout?: number; secure?: boolean }\n\t| { type: \"extension_ui_request\"; id: string; method: \"editor\"; title: string; prefill?: string }\n\t| { type: \"extension_ui_request\"; id: string; method: \"notify\"; message: string; notifyType?: \"info\" | \"warning\" | \"error\" }\n\t| { type: \"extension_ui_request\"; id: string; method: \"setStatus\"; statusKey: string; statusText: string | undefined }\n\t| {\n\t\t\ttype: \"extension_ui_request\";\n\t\t\tid: string;\n\t\t\tmethod: \"setWidget\";\n\t\t\twidgetKey: string;\n\t\t\twidgetLines: string[] | undefined;\n\t\t\twidgetPlacement?: \"aboveEditor\" | \"belowEditor\";\n\t  }\n\t| { type: \"extension_ui_request\"; id: string; method: \"setTitle\"; title: string }\n\t| { type: \"extension_ui_request\"; id: string; method: \"set_editor_text\"; text: string };\n\nexport type RpcExtensionUIResponse =\n\t| { type: \"extension_ui_response\"; id: string; value: string }\n\t| { type: \"extension_ui_response\"; id: string; values: string[] }\n\t| { type: \"extension_ui_response\"; id: string; confirmed: boolean }\n\t| { type: \"extension_ui_response\"; id: string; cancelled: true };\n\nexport type McpBlockerMethod = Extract<RpcExtensionUIRequest, { type: \"extension_ui_request\" }>[\"method\"];\n\nexport interface McpPendingBlocker {\n\tid: string;\n\tmethod: McpBlockerMethod;\n\tmessage: string;\n\tevent: RpcExtensionUIRequest;\n}\n\nexport type RpcCommandType = RpcCommand[\"type\"];\n"]}

package/packages/contracts/dist/rpc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rpc.test.d.ts.map

package/packages/contracts/dist/rpc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.test.d.ts","sourceRoot":"","sources":["../src/rpc.test.ts"],"names":[],"mappings":""}

package/packages/contracts/dist/rpc.test.js

@@ -0,0 +1,47 @@
+// Project/App: GSD-2
+// File Purpose: Tests for canonical RPC contract constants exported by the contracts package.
+import assert from "node:assert/strict";
+import test from "node:test";
+import { RPC_COMMAND_TYPES, RPC_CONTRACT_VERSION, RPC_EXTENSION_UI_METHODS, RPC_THINKING_LEVELS, RPC_V2_EVENT_TYPES, } from "./rpc.js";
+import { WORKFLOW_TOOL_CONTRACTS, WORKFLOW_TOOL_NAMES } from "./workflow.js";
+test("rpc contract version is stable and public", () => {
+    assert.equal(RPC_CONTRACT_VERSION, 1);
+});
+test("rpc command constants cover the public v2 handshake and core commands", () => {
+    assert.deepEqual(["init", "prompt", "get_state", "bash", "get_session_stats", "shutdown"].filter((command) => !RPC_COMMAND_TYPES.includes(command)), []);
+});
+test("rpc constants include provider-agnostic thinking and event values", () => {
+    assert.deepEqual([...RPC_THINKING_LEVELS], ["off", "minimal", "low", "medium", "high", "xhigh"]);
+    assert.deepEqual([...RPC_V2_EVENT_TYPES], ["execution_complete", "cost_update"]);
+});
+test("extension UI methods include interactive and display update requests", () => {
+    assert.deepEqual(["select", "confirm", "input", "editor", "notify", "setStatus", "setWidget", "setTitle", "set_editor_text"].filter((method) => !RPC_EXTENSION_UI_METHODS.includes(method)), []);
+});
+test("mcp pending blocker preserves secure input payloads", () => {
+    const blocker = {
+        id: "blocker-1",
+        method: "input",
+        message: "API key",
+        event: {
+            type: "extension_ui_request",
+            id: "blocker-1",
+            method: "input",
+            title: "API key",
+            secure: true,
+        },
+    };
+    assert.equal(blocker.method, "input");
+    assert.equal(blocker.event.method, "input");
+    assert.equal(blocker.event.secure, true);
+});
+test("workflow tool contracts expose canonical names and aliases", () => {
+    assert.ok(WORKFLOW_TOOL_NAMES.includes("gsd_task_complete"));
+    assert.ok(WORKFLOW_TOOL_NAMES.includes("gsd_complete_task"));
+    assert.ok(WORKFLOW_TOOL_NAMES.includes("gsd_plan_milestone"));
+    const taskComplete = WORKFLOW_TOOL_CONTRACTS.find((tool) => tool.canonicalName === "gsd_task_complete");
+    assert.ok(taskComplete);
+    assert.deepEqual([...taskComplete.aliases], ["gsd_complete_task"]);
+    assert.equal(taskComplete.writePolicy, "write");
+    assert.equal(taskComplete.schemaId, "workflow.task.complete");
+});
+//# sourceMappingURL=rpc.test.js.map

package/packages/contracts/dist/rpc.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.test.js","sourceRoot":"","sources":["../src/rpc.test.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: GSD-2\n// File Purpose: Tests for canonical RPC contract constants exported by the contracts package.\n\nimport assert from \"node:assert/strict\";\nimport test from \"node:test\";\nimport {\n\tRPC_COMMAND_TYPES,\n\tRPC_CONTRACT_VERSION,\n\tRPC_EXTENSION_UI_METHODS,\n\tRPC_THINKING_LEVELS,\n\tRPC_V2_EVENT_TYPES,\n\ttype McpPendingBlocker,\n} from \"./rpc.js\";\nimport { WORKFLOW_TOOL_CONTRACTS, WORKFLOW_TOOL_NAMES } from \"./workflow.js\";\n\ntest(\"rpc contract version is stable and public\", () => {\n\tassert.equal(RPC_CONTRACT_VERSION, 1);\n});\n\ntest(\"rpc command constants cover the public v2 handshake and core commands\", () => {\n\tassert.deepEqual(\n\t\t[\"init\", \"prompt\", \"get_state\", \"bash\", \"get_session_stats\", \"shutdown\"].filter(\n\t\t\t(command) => !RPC_COMMAND_TYPES.includes(command as (typeof RPC_COMMAND_TYPES)[number])\n\t\t),\n\t\t[]\n\t);\n});\n\ntest(\"rpc constants include provider-agnostic thinking and event values\", () => {\n\tassert.deepEqual([...RPC_THINKING_LEVELS], [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"]);\n\tassert.deepEqual([...RPC_V2_EVENT_TYPES], [\"execution_complete\", \"cost_update\"]);\n});\n\ntest(\"extension UI methods include interactive and display update requests\", () => {\n\tassert.deepEqual(\n\t\t[\"select\", \"confirm\", \"input\", \"editor\", \"notify\", \"setStatus\", \"setWidget\", \"setTitle\", \"set_editor_text\"].filter(\n\t\t\t(method) => !RPC_EXTENSION_UI_METHODS.includes(method as (typeof RPC_EXTENSION_UI_METHODS)[number])\n\t\t),\n\t\t[]\n\t);\n});\n\ntest(\"mcp pending blocker preserves secure input payloads\", () => {\n\tconst blocker: McpPendingBlocker = {\n\t\tid: \"blocker-1\",\n\t\tmethod: \"input\",\n\t\tmessage: \"API key\",\n\t\tevent: {\n\t\t\ttype: \"extension_ui_request\",\n\t\t\tid: \"blocker-1\",\n\t\t\tmethod: \"input\",\n\t\t\ttitle: \"API key\",\n\t\t\tsecure: true,\n\t\t},\n\t};\n\n\tassert.equal(blocker.method, \"input\");\n\tassert.equal(blocker.event.method, \"input\");\n\tassert.equal(blocker.event.secure, true);\n});\n\ntest(\"workflow tool contracts expose canonical names and aliases\", () => {\n\tassert.ok(WORKFLOW_TOOL_NAMES.includes(\"gsd_task_complete\"));\n\tassert.ok(WORKFLOW_TOOL_NAMES.includes(\"gsd_complete_task\"));\n\tassert.ok(WORKFLOW_TOOL_NAMES.includes(\"gsd_plan_milestone\"));\n\n\tconst taskComplete = WORKFLOW_TOOL_CONTRACTS.find((tool) => tool.canonicalName === \"gsd_task_complete\");\n\tassert.ok(taskComplete);\n\tassert.deepEqual([...taskComplete.aliases], [\"gsd_complete_task\"]);\n\tassert.equal(taskComplete.writePolicy, \"write\");\n\tassert.equal(taskComplete.schemaId, \"workflow.task.complete\");\n});\n"]}

package/packages/contracts/dist/workflow.d.ts

@@ -0,0 +1,180 @@
+export type WorkflowToolWritePolicy = "read" | "write";
+export interface WorkflowToolContractMetadata {
+    canonicalName: string;
+    aliases: readonly string[];
+    schemaId: string;
+    executorId: string;
+    writePolicy: WorkflowToolWritePolicy;
+    auditEvent: string;
+}
+export declare const WORKFLOW_TOOL_CONTRACTS: readonly [{
+    readonly canonicalName: "gsd_decision_save";
+    readonly aliases: readonly ["gsd_save_decision"];
+    readonly schemaId: "workflow.decision.save";
+    readonly executorId: "executeDecisionSave";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.decision.save";
+}, {
+    readonly canonicalName: "gsd_requirement_update";
+    readonly aliases: readonly ["gsd_update_requirement"];
+    readonly schemaId: "workflow.requirement.update";
+    readonly executorId: "executeRequirementUpdate";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.requirement.update";
+}, {
+    readonly canonicalName: "gsd_requirement_save";
+    readonly aliases: readonly ["gsd_save_requirement"];
+    readonly schemaId: "workflow.requirement.save";
+    readonly executorId: "executeRequirementSave";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.requirement.save";
+}, {
+    readonly canonicalName: "gsd_milestone_generate_id";
+    readonly aliases: readonly ["gsd_generate_milestone_id"];
+    readonly schemaId: "workflow.milestone.generate_id";
+    readonly executorId: "executeMilestoneGenerateId";
+    readonly writePolicy: "read";
+    readonly auditEvent: "workflow.milestone.generate_id";
+}, {
+    readonly canonicalName: "gsd_plan_milestone";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.milestone.plan";
+    readonly executorId: "executePlanMilestone";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.milestone.plan";
+}, {
+    readonly canonicalName: "gsd_plan_slice";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.slice.plan";
+    readonly executorId: "executePlanSlice";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.slice.plan";
+}, {
+    readonly canonicalName: "gsd_plan_task";
+    readonly aliases: readonly ["gsd_task_plan"];
+    readonly schemaId: "workflow.task.plan";
+    readonly executorId: "executePlanTask";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.task.plan";
+}, {
+    readonly canonicalName: "gsd_replan_slice";
+    readonly aliases: readonly ["gsd_slice_replan"];
+    readonly schemaId: "workflow.slice.replan";
+    readonly executorId: "executeReplanSlice";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.slice.replan";
+}, {
+    readonly canonicalName: "gsd_slice_complete";
+    readonly aliases: readonly ["gsd_complete_slice"];
+    readonly schemaId: "workflow.slice.complete";
+    readonly executorId: "executeSliceComplete";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.slice.complete";
+}, {
+    readonly canonicalName: "gsd_skip_slice";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.slice.skip";
+    readonly executorId: "executeSkipSlice";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.slice.skip";
+}, {
+    readonly canonicalName: "gsd_complete_milestone";
+    readonly aliases: readonly ["gsd_milestone_complete"];
+    readonly schemaId: "workflow.milestone.complete";
+    readonly executorId: "executeCompleteMilestone";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.milestone.complete";
+}, {
+    readonly canonicalName: "gsd_validate_milestone";
+    readonly aliases: readonly ["gsd_milestone_validate"];
+    readonly schemaId: "workflow.milestone.validate";
+    readonly executorId: "executeValidateMilestone";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.milestone.validate";
+}, {
+    readonly canonicalName: "gsd_reassess_roadmap";
+    readonly aliases: readonly ["gsd_roadmap_reassess"];
+    readonly schemaId: "workflow.roadmap.reassess";
+    readonly executorId: "executeReassessRoadmap";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.roadmap.reassess";
+}, {
+    readonly canonicalName: "gsd_save_gate_result";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.gate.save_result";
+    readonly executorId: "executeSaveGateResult";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.gate.save_result";
+}, {
+    readonly canonicalName: "gsd_summary_save";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.summary.save";
+    readonly executorId: "executeSummarySave";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.summary.save";
+}, {
+    readonly canonicalName: "gsd_task_complete";
+    readonly aliases: readonly ["gsd_complete_task"];
+    readonly schemaId: "workflow.task.complete";
+    readonly executorId: "executeTaskComplete";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.task.complete";
+}, {
+    readonly canonicalName: "gsd_milestone_status";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.milestone.status";
+    readonly executorId: "executeMilestoneStatus";
+    readonly writePolicy: "read";
+    readonly auditEvent: "workflow.milestone.status";
+}, {
+    readonly canonicalName: "gsd_journal_query";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.journal.query";
+    readonly executorId: "executeJournalQuery";
+    readonly writePolicy: "read";
+    readonly auditEvent: "workflow.journal.query";
+}, {
+    readonly canonicalName: "gsd_exec";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.exec.run";
+    readonly executorId: "executeGsdExec";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.exec.run";
+}, {
+    readonly canonicalName: "gsd_exec_search";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.exec.search";
+    readonly executorId: "executeGsdExecSearch";
+    readonly writePolicy: "read";
+    readonly auditEvent: "workflow.exec.search";
+}, {
+    readonly canonicalName: "gsd_resume";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.resume";
+    readonly executorId: "executeGsdResume";
+    readonly writePolicy: "read";
+    readonly auditEvent: "workflow.resume";
+}, {
+    readonly canonicalName: "gsd_capture_thought";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.memory.capture_thought";
+    readonly executorId: "executeCaptureThought";
+    readonly writePolicy: "write";
+    readonly auditEvent: "workflow.memory.capture_thought";
+}, {
+    readonly canonicalName: "gsd_memory_query";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.memory.query";
+    readonly executorId: "executeMemoryQuery";
+    readonly writePolicy: "read";
+    readonly auditEvent: "workflow.memory.query";
+}, {
+    readonly canonicalName: "gsd_memory_graph";
+    readonly aliases: readonly [];
+    readonly schemaId: "workflow.memory.graph";
+    readonly executorId: "executeMemoryGraph";
+    readonly writePolicy: "read";
+    readonly auditEvent: "workflow.memory.graph";
+}];
+export declare const WORKFLOW_TOOL_NAMES: readonly string[];
+//# sourceMappingURL=workflow.d.ts.map

package/packages/contracts/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,4BAA4B;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,uBAAuB,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiMwB,CAAC;AAE7D,eAAO,MAAM,mBAAmB,EAG1B,SAAS,MAAM,EAAE,CAAC"}

package/packages/contracts/dist/workflow.js

@@ -0,0 +1,201 @@
+// Project/App: GSD-2
+// File Purpose: Canonical workflow MCP tool metadata shared across package boundaries.
+export const WORKFLOW_TOOL_CONTRACTS = [
+    {
+        canonicalName: "gsd_decision_save",
+        aliases: ["gsd_save_decision"],
+        schemaId: "workflow.decision.save",
+        executorId: "executeDecisionSave",
+        writePolicy: "write",
+        auditEvent: "workflow.decision.save",
+    },
+    {
+        canonicalName: "gsd_requirement_update",
+        aliases: ["gsd_update_requirement"],
+        schemaId: "workflow.requirement.update",
+        executorId: "executeRequirementUpdate",
+        writePolicy: "write",
+        auditEvent: "workflow.requirement.update",
+    },
+    {
+        canonicalName: "gsd_requirement_save",
+        aliases: ["gsd_save_requirement"],
+        schemaId: "workflow.requirement.save",
+        executorId: "executeRequirementSave",
+        writePolicy: "write",
+        auditEvent: "workflow.requirement.save",
+    },
+    {
+        canonicalName: "gsd_milestone_generate_id",
+        aliases: ["gsd_generate_milestone_id"],
+        schemaId: "workflow.milestone.generate_id",
+        executorId: "executeMilestoneGenerateId",
+        writePolicy: "read",
+        auditEvent: "workflow.milestone.generate_id",
+    },
+    {
+        canonicalName: "gsd_plan_milestone",
+        aliases: [],
+        schemaId: "workflow.milestone.plan",
+        executorId: "executePlanMilestone",
+        writePolicy: "write",
+        auditEvent: "workflow.milestone.plan",
+    },
+    {
+        canonicalName: "gsd_plan_slice",
+        aliases: [],
+        schemaId: "workflow.slice.plan",
+        executorId: "executePlanSlice",
+        writePolicy: "write",
+        auditEvent: "workflow.slice.plan",
+    },
+    {
+        canonicalName: "gsd_plan_task",
+        aliases: ["gsd_task_plan"],
+        schemaId: "workflow.task.plan",
+        executorId: "executePlanTask",
+        writePolicy: "write",
+        auditEvent: "workflow.task.plan",
+    },
+    {
+        canonicalName: "gsd_replan_slice",
+        aliases: ["gsd_slice_replan"],
+        schemaId: "workflow.slice.replan",
+        executorId: "executeReplanSlice",
+        writePolicy: "write",
+        auditEvent: "workflow.slice.replan",
+    },
+    {
+        canonicalName: "gsd_slice_complete",
+        aliases: ["gsd_complete_slice"],
+        schemaId: "workflow.slice.complete",
+        executorId: "executeSliceComplete",
+        writePolicy: "write",
+        auditEvent: "workflow.slice.complete",
+    },
+    {
+        canonicalName: "gsd_skip_slice",
+        aliases: [],
+        schemaId: "workflow.slice.skip",
+        executorId: "executeSkipSlice",
+        writePolicy: "write",
+        auditEvent: "workflow.slice.skip",
+    },
+    {
+        canonicalName: "gsd_complete_milestone",
+        aliases: ["gsd_milestone_complete"],
+        schemaId: "workflow.milestone.complete",
+        executorId: "executeCompleteMilestone",
+        writePolicy: "write",
+        auditEvent: "workflow.milestone.complete",
+    },
+    {
+        canonicalName: "gsd_validate_milestone",
+        aliases: ["gsd_milestone_validate"],
+        schemaId: "workflow.milestone.validate",
+        executorId: "executeValidateMilestone",
+        writePolicy: "write",
+        auditEvent: "workflow.milestone.validate",
+    },
+    {
+        canonicalName: "gsd_reassess_roadmap",
+        aliases: ["gsd_roadmap_reassess"],
+        schemaId: "workflow.roadmap.reassess",
+        executorId: "executeReassessRoadmap",
+        writePolicy: "write",
+        auditEvent: "workflow.roadmap.reassess",
+    },
+    {
+        canonicalName: "gsd_save_gate_result",
+        aliases: [],
+        schemaId: "workflow.gate.save_result",
+        executorId: "executeSaveGateResult",
+        writePolicy: "write",
+        auditEvent: "workflow.gate.save_result",
+    },
+    {
+        canonicalName: "gsd_summary_save",
+        aliases: [],
+        schemaId: "workflow.summary.save",
+        executorId: "executeSummarySave",
+        writePolicy: "write",
+        auditEvent: "workflow.summary.save",
+    },
+    {
+        canonicalName: "gsd_task_complete",
+        aliases: ["gsd_complete_task"],
+        schemaId: "workflow.task.complete",
+        executorId: "executeTaskComplete",
+        writePolicy: "write",
+        auditEvent: "workflow.task.complete",
+    },
+    {
+        canonicalName: "gsd_milestone_status",
+        aliases: [],
+        schemaId: "workflow.milestone.status",
+        executorId: "executeMilestoneStatus",
+        writePolicy: "read",
+        auditEvent: "workflow.milestone.status",
+    },
+    {
+        canonicalName: "gsd_journal_query",
+        aliases: [],
+        schemaId: "workflow.journal.query",
+        executorId: "executeJournalQuery",
+        writePolicy: "read",
+        auditEvent: "workflow.journal.query",
+    },
+    {
+        canonicalName: "gsd_exec",
+        aliases: [],
+        schemaId: "workflow.exec.run",
+        executorId: "executeGsdExec",
+        writePolicy: "write",
+        auditEvent: "workflow.exec.run",
+    },
+    {
+        canonicalName: "gsd_exec_search",
+        aliases: [],
+        schemaId: "workflow.exec.search",
+        executorId: "executeGsdExecSearch",
+        writePolicy: "read",
+        auditEvent: "workflow.exec.search",
+    },
+    {
+        canonicalName: "gsd_resume",
+        aliases: [],
+        schemaId: "workflow.resume",
+        executorId: "executeGsdResume",
+        writePolicy: "read",
+        auditEvent: "workflow.resume",
+    },
+    {
+        canonicalName: "gsd_capture_thought",
+        aliases: [],
+        schemaId: "workflow.memory.capture_thought",
+        executorId: "executeCaptureThought",
+        writePolicy: "write",
+        auditEvent: "workflow.memory.capture_thought",
+    },
+    {
+        canonicalName: "gsd_memory_query",
+        aliases: [],
+        schemaId: "workflow.memory.query",
+        executorId: "executeMemoryQuery",
+        writePolicy: "read",
+        auditEvent: "workflow.memory.query",
+    },
+    {
+        canonicalName: "gsd_memory_graph",
+        aliases: [],
+        schemaId: "workflow.memory.graph",
+        executorId: "executeMemoryGraph",
+        writePolicy: "read",
+        auditEvent: "workflow.memory.graph",
+    },
+];
+export const WORKFLOW_TOOL_NAMES = WORKFLOW_TOOL_CONTRACTS.flatMap((tool) => [
+    tool.canonicalName,
+    ...tool.aliases,
+]);
+//# sourceMappingURL=workflow.js.map

package/packages/contracts/dist/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,uFAAuF;AAavF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC;QACC,aAAa,EAAE,mBAAmB;QAClC,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,QAAQ,EAAE,wBAAwB;QAClC,UAAU,EAAE,qBAAqB;QACjC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,wBAAwB;KACpC;IACD;QACC,aAAa,EAAE,wBAAwB;QACvC,OAAO,EAAE,CAAC,wBAAwB,CAAC;QACnC,QAAQ,EAAE,6BAA6B;QACvC,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,6BAA6B;KACzC;IACD;QACC,aAAa,EAAE,sBAAsB;QACrC,OAAO,EAAE,CAAC,sBAAsB,CAAC;QACjC,QAAQ,EAAE,2BAA2B;QACrC,UAAU,EAAE,wBAAwB;QACpC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,2BAA2B;KACvC;IACD;QACC,aAAa,EAAE,2BAA2B;QAC1C,OAAO,EAAE,CAAC,2BAA2B,CAAC;QACtC,QAAQ,EAAE,gCAAgC;QAC1C,UAAU,EAAE,4BAA4B;QACxC,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,gCAAgC;KAC5C;IACD;QACC,aAAa,EAAE,oBAAoB;QACnC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,yBAAyB;QACnC,UAAU,EAAE,sBAAsB;QAClC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,yBAAyB;KACrC;IACD;QACC,aAAa,EAAE,gBAAgB;QAC/B,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,qBAAqB;QAC/B,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,qBAAqB;KACjC;IACD;QACC,aAAa,EAAE,eAAe;QAC9B,OAAO,EAAE,CAAC,eAAe,CAAC;QAC1B,QAAQ,EAAE,oBAAoB;QAC9B,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,oBAAoB;KAChC;IACD;QACC,aAAa,EAAE,kBAAkB;QACjC,OAAO,EAAE,CAAC,kBAAkB,CAAC;QAC7B,QAAQ,EAAE,uBAAuB;QACjC,UAAU,EAAE,oBAAoB;QAChC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,uBAAuB;KACnC;IACD;QACC,aAAa,EAAE,oBAAoB;QACnC,OAAO,EAAE,CAAC,oBAAoB,CAAC;QAC/B,QAAQ,EAAE,yBAAyB;QACnC,UAAU,EAAE,sBAAsB;QAClC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,yBAAyB;KACrC;IACD;QACC,aAAa,EAAE,gBAAgB;QAC/B,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,qBAAqB;QAC/B,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,qBAAqB;KACjC;IACD;QACC,aAAa,EAAE,wBAAwB;QACvC,OAAO,EAAE,CAAC,wBAAwB,CAAC;QACnC,QAAQ,EAAE,6BAA6B;QACvC,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,6BAA6B;KACzC;IACD;QACC,aAAa,EAAE,wBAAwB;QACvC,OAAO,EAAE,CAAC,wBAAwB,CAAC;QACnC,QAAQ,EAAE,6BAA6B;QACvC,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,6BAA6B;KACzC;IACD;QACC,aAAa,EAAE,sBAAsB;QACrC,OAAO,EAAE,CAAC,sBAAsB,CAAC;QACjC,QAAQ,EAAE,2BAA2B;QACrC,UAAU,EAAE,wBAAwB;QACpC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,2BAA2B;KACvC;IACD;QACC,aAAa,EAAE,sBAAsB;QACrC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,2BAA2B;QACrC,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,2BAA2B;KACvC;IACD;QACC,aAAa,EAAE,kBAAkB;QACjC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,uBAAuB;QACjC,UAAU,EAAE,oBAAoB;QAChC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,uBAAuB;KACnC;IACD;QACC,aAAa,EAAE,mBAAmB;QAClC,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,QAAQ,EAAE,wBAAwB;QAClC,UAAU,EAAE,qBAAqB;QACjC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,wBAAwB;KACpC;IACD;QACC,aAAa,EAAE,sBAAsB;QACrC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,2BAA2B;QACrC,UAAU,EAAE,wBAAwB;QACpC,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,2BAA2B;KACvC;IACD;QACC,aAAa,EAAE,mBAAmB;QAClC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,wBAAwB;QAClC,UAAU,EAAE,qBAAqB;QACjC,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,wBAAwB;KACpC;IACD;QACC,aAAa,EAAE,UAAU;QACzB,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,mBAAmB;QAC7B,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,mBAAmB;KAC/B;IACD;QACC,aAAa,EAAE,iBAAiB;QAChC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,sBAAsB;QAChC,UAAU,EAAE,sBAAsB;QAClC,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,sBAAsB;KAClC;IACD;QACC,aAAa,EAAE,YAAY;QAC3B,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,iBAAiB;QAC3B,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,iBAAiB;KAC7B;IACD;QACC,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,iCAAiC;QAC3C,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,iCAAiC;KAC7C;IACD;QACC,aAAa,EAAE,kBAAkB;QACjC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,uBAAuB;QACjC,UAAU,EAAE,oBAAoB;QAChC,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,uBAAuB;KACnC;IACD;QACC,aAAa,EAAE,kBAAkB;QACjC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,uBAAuB;QACjC,UAAU,EAAE,oBAAoB;QAChC,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,uBAAuB;KACnC;CAC0D,CAAC;AAE7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5E,IAAI,CAAC,aAAa;IAClB,GAAG,IAAI,CAAC,OAAO;CACf,CAAsB,CAAC","sourcesContent":["// Project/App: GSD-2\n// File Purpose: Canonical workflow MCP tool metadata shared across package boundaries.\n\nexport type WorkflowToolWritePolicy = \"read\" | \"write\";\n\nexport interface WorkflowToolContractMetadata {\n\tcanonicalName: string;\n\taliases: readonly string[];\n\tschemaId: string;\n\texecutorId: string;\n\twritePolicy: WorkflowToolWritePolicy;\n\tauditEvent: string;\n}\n\nexport const WORKFLOW_TOOL_CONTRACTS = [\n\t{\n\t\tcanonicalName: \"gsd_decision_save\",\n\t\taliases: [\"gsd_save_decision\"],\n\t\tschemaId: \"workflow.decision.save\",\n\t\texecutorId: \"executeDecisionSave\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.decision.save\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_requirement_update\",\n\t\taliases: [\"gsd_update_requirement\"],\n\t\tschemaId: \"workflow.requirement.update\",\n\t\texecutorId: \"executeRequirementUpdate\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.requirement.update\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_requirement_save\",\n\t\taliases: [\"gsd_save_requirement\"],\n\t\tschemaId: \"workflow.requirement.save\",\n\t\texecutorId: \"executeRequirementSave\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.requirement.save\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_milestone_generate_id\",\n\t\taliases: [\"gsd_generate_milestone_id\"],\n\t\tschemaId: \"workflow.milestone.generate_id\",\n\t\texecutorId: \"executeMilestoneGenerateId\",\n\t\twritePolicy: \"read\",\n\t\tauditEvent: \"workflow.milestone.generate_id\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_plan_milestone\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.milestone.plan\",\n\t\texecutorId: \"executePlanMilestone\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.milestone.plan\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_plan_slice\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.slice.plan\",\n\t\texecutorId: \"executePlanSlice\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.slice.plan\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_plan_task\",\n\t\taliases: [\"gsd_task_plan\"],\n\t\tschemaId: \"workflow.task.plan\",\n\t\texecutorId: \"executePlanTask\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.task.plan\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_replan_slice\",\n\t\taliases: [\"gsd_slice_replan\"],\n\t\tschemaId: \"workflow.slice.replan\",\n\t\texecutorId: \"executeReplanSlice\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.slice.replan\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_slice_complete\",\n\t\taliases: [\"gsd_complete_slice\"],\n\t\tschemaId: \"workflow.slice.complete\",\n\t\texecutorId: \"executeSliceComplete\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.slice.complete\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_skip_slice\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.slice.skip\",\n\t\texecutorId: \"executeSkipSlice\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.slice.skip\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_complete_milestone\",\n\t\taliases: [\"gsd_milestone_complete\"],\n\t\tschemaId: \"workflow.milestone.complete\",\n\t\texecutorId: \"executeCompleteMilestone\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.milestone.complete\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_validate_milestone\",\n\t\taliases: [\"gsd_milestone_validate\"],\n\t\tschemaId: \"workflow.milestone.validate\",\n\t\texecutorId: \"executeValidateMilestone\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.milestone.validate\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_reassess_roadmap\",\n\t\taliases: [\"gsd_roadmap_reassess\"],\n\t\tschemaId: \"workflow.roadmap.reassess\",\n\t\texecutorId: \"executeReassessRoadmap\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.roadmap.reassess\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_save_gate_result\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.gate.save_result\",\n\t\texecutorId: \"executeSaveGateResult\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.gate.save_result\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_summary_save\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.summary.save\",\n\t\texecutorId: \"executeSummarySave\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.summary.save\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_task_complete\",\n\t\taliases: [\"gsd_complete_task\"],\n\t\tschemaId: \"workflow.task.complete\",\n\t\texecutorId: \"executeTaskComplete\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.task.complete\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_milestone_status\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.milestone.status\",\n\t\texecutorId: \"executeMilestoneStatus\",\n\t\twritePolicy: \"read\",\n\t\tauditEvent: \"workflow.milestone.status\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_journal_query\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.journal.query\",\n\t\texecutorId: \"executeJournalQuery\",\n\t\twritePolicy: \"read\",\n\t\tauditEvent: \"workflow.journal.query\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_exec\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.exec.run\",\n\t\texecutorId: \"executeGsdExec\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.exec.run\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_exec_search\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.exec.search\",\n\t\texecutorId: \"executeGsdExecSearch\",\n\t\twritePolicy: \"read\",\n\t\tauditEvent: \"workflow.exec.search\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_resume\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.resume\",\n\t\texecutorId: \"executeGsdResume\",\n\t\twritePolicy: \"read\",\n\t\tauditEvent: \"workflow.resume\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_capture_thought\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.memory.capture_thought\",\n\t\texecutorId: \"executeCaptureThought\",\n\t\twritePolicy: \"write\",\n\t\tauditEvent: \"workflow.memory.capture_thought\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_memory_query\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.memory.query\",\n\t\texecutorId: \"executeMemoryQuery\",\n\t\twritePolicy: \"read\",\n\t\tauditEvent: \"workflow.memory.query\",\n\t},\n\t{\n\t\tcanonicalName: \"gsd_memory_graph\",\n\t\taliases: [],\n\t\tschemaId: \"workflow.memory.graph\",\n\t\texecutorId: \"executeMemoryGraph\",\n\t\twritePolicy: \"read\",\n\t\tauditEvent: \"workflow.memory.graph\",\n\t},\n] as const satisfies readonly WorkflowToolContractMetadata[];\n\nexport const WORKFLOW_TOOL_NAMES = WORKFLOW_TOOL_CONTRACTS.flatMap((tool) => [\n\ttool.canonicalName,\n\t...tool.aliases,\n]) as readonly string[];\n"]}

package/packages/contracts/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@gsd-build/contracts",
+  "version": "2.80.0",
+  "description": "Shared public contracts for GSD workspace boundaries",
+  "license": "MIT",
+  "gsd": {
+    "linkable": true,
+    "scope": "@gsd-build",
+    "name": "contracts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gsd-build/gsd-2.git",
+    "directory": "packages/contracts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json --incremental false",
+    "test": "node --test dist/rpc.test.js"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}

package/packages/contracts/src/index.ts

@@ -0,0 +1,5 @@
+// Project/App: GSD-2
+// File Purpose: Public entry point for shared workspace boundary contracts.
+
+export * from "./rpc.js";
+export * from "./workflow.js";