gsd-pi 2.79.0-dev.ece5fd8ba → 2.80.0-dev.b62439b9f

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":"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","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";

package/packages/contracts/src/rpc.test.ts

@@ -0,0 +1,72 @@
+// 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,
+	type McpPendingBlocker,
+} 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 as (typeof RPC_COMMAND_TYPES)[number])
+		),
+		[]
+	);
+});
+
+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 as (typeof RPC_EXTENSION_UI_METHODS)[number])
+		),
+		[]
+	);
+});
+
+test("mcp pending blocker preserves secure input payloads", () => {
+	const blocker: McpPendingBlocker = {
+		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");
+});