npm - @opengsd/gsd-pi - Versions diffs - 1.8.1 → 1.9.0-dev.97ef11e3 - Mend

@opengsd/gsd-pi 1.8.1 → 1.9.0-dev.97ef11e3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (613) hide show

package/packages/gsd-cloud/dist/runtime-process.test.js ADDED Viewed

@@ -0,0 +1,97 @@
+// Project/App: Open GSD
+// File Purpose: Regression coverage for detached cloud runtime process timing and shutdown.
+import { spawn } from "node:child_process";
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS } from "./cloud-runtime.js";
+import { BACKGROUND_RUNTIME_READY_TIMEOUT_MS, backgroundRuntimeStatus, startBackgroundRuntime, stopBackgroundRuntime, } from "./runtime-process.js";
+test("background startup allows the cloud runtime's full initial reconnect window", () => {
+    assert.ok(BACKGROUND_RUNTIME_READY_TIMEOUT_MS > CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS);
+});
+test("stop waits for the detached runtime to exit before removing its state", { timeout: 5_000 }, async () => {
+    const root = mkdtempSync(join(tmpdir(), "gsd-cloud-stop-"));
+    const configPath = join(root, "daemon.yaml");
+    const statePath = join(root, "cloud-runtime.json");
+    const child = spawn(process.execPath, [
+        "-e",
+        "process.on('SIGTERM',()=>setTimeout(()=>process.exit(0),200));process.send?.('ready');setInterval(()=>{},1000)",
+    ], { stdio: ["ignore", "ignore", "ignore", "ipc"] });
+    try {
+        await new Promise((resolve, reject) => {
+            child.once("error", reject);
+            child.once("message", () => resolve());
+        });
+        assert.ok(child.pid);
+        writeFileSync(statePath, `${JSON.stringify({ pid: child.pid, projects: [root] })}\n`);
+        const startedAt = Date.now();
+        assert.equal(await stopBackgroundRuntime(configPath), true);
+        assert.ok(Date.now() - startedAt >= 150);
+        assert.equal(existsSync(statePath), false);
+    }
+    finally {
+        child.kill("SIGKILL");
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test("concurrent starts serialize and leave only the newest runtime running", { timeout: 15_000 }, async () => {
+    const root = mkdtempSync(join(tmpdir(), "gsd-cloud-concurrent-start-"));
+    const configPath = join(root, "daemon.yaml");
+    const binaryPath = writeReadyRuntime(root);
+    try {
+        const [first, second] = await Promise.all([
+            startBackgroundRuntime({ binaryPath, configPath, projectDirs: [root] }),
+            startBackgroundRuntime({ binaryPath, configPath, projectDirs: [root] }),
+        ]);
+        assert.notEqual(first.pid, second.pid);
+        assert.ok(first.pid);
+        assert.equal(processIsRunning(first.pid), false);
+        assert.equal(backgroundRuntimeStatus(configPath).pid, second.pid);
+    }
+    finally {
+        await stopBackgroundRuntime(configPath).catch(() => undefined);
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test("verbose background starts forward the flag to the runtime child", { timeout: 10_000 }, async () => {
+    const root = mkdtempSync(join(tmpdir(), "gsd-cloud-verbose-start-"));
+    const configPath = join(root, "daemon.yaml");
+    const binaryPath = writeReadyRuntime(root);
+    try {
+        await startBackgroundRuntime({
+            binaryPath,
+            configPath,
+            projectDirs: [root],
+            verbose: true,
+        });
+        const args = JSON.parse(readFileSync(join(root, "runtime-args.json"), "utf8"));
+        assert.ok(args.includes("--verbose"));
+    }
+    finally {
+        await stopBackgroundRuntime(configPath).catch(() => undefined);
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+function writeReadyRuntime(root) {
+    const binaryPath = join(root, "runtime.mjs");
+    writeFileSync(binaryPath, [
+        'import { writeFileSync } from "node:fs";',
+        `writeFileSync(${JSON.stringify(join(root, "runtime-args.json"))}, JSON.stringify(process.argv.slice(2)));`,
+        'process.on("SIGTERM", () => process.exit(0));',
+        'process.send?.({ type: "ready" });',
+        'setInterval(() => undefined, 1_000);',
+    ].join("\n"));
+    return binaryPath;
+}
+function processIsRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=runtime-process.test.js.map

package/packages/gsd-cloud/dist/runtime-process.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"runtime-process.test.js","sourceRoot":"","sources":["../src/runtime-process.test.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Regression coverage for detached cloud runtime process timing and shutdown.\nimport { spawn } from \"node:child_process\";\nimport { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { test } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS } from \"./cloud-runtime.js\";\nimport {\n BACKGROUND_RUNTIME_READY_TIMEOUT_MS,\n backgroundRuntimeStatus,\n startBackgroundRuntime,\n stopBackgroundRuntime,\n} from \"./runtime-process.js\";\n\ntest(\"background startup allows the cloud runtime's full initial reconnect window\", () => {\n assert.ok(BACKGROUND_RUNTIME_READY_TIMEOUT_MS > CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS);\n});\n\ntest(\"stop waits for the detached runtime to exit before removing its state\", { timeout: 5_000 }, async () => {\n const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-stop-\"));\n const configPath = join(root, \"daemon.yaml\");\n const statePath = join(root, \"cloud-runtime.json\");\n const child = spawn(process.execPath, [\n \"-e\",\n \"process.on('SIGTERM',()=>setTimeout(()=>process.exit(0),200));process.send?.('ready');setInterval(()=>{},1000)\",\n ], { stdio: [\"ignore\", \"ignore\", \"ignore\", \"ipc\"] });\n\n try {\n await new Promise<void>((resolve, reject) => {\n child.once(\"error\", reject);\n child.once(\"message\", () => resolve());\n });\n assert.ok(child.pid);\n writeFileSync(statePath, `${JSON.stringify({ pid: child.pid, projects: [root] })}\\n`);\n\n const startedAt = Date.now();\n assert.equal(await stopBackgroundRuntime(configPath), true);\n\n assert.ok(Date.now() - startedAt >= 150);\n assert.equal(existsSync(statePath), false);\n } finally {\n child.kill(\"SIGKILL\");\n rmSync(root, { recursive: true, force: true });\n }\n});\n\ntest(\"concurrent starts serialize and leave only the newest runtime running\", { timeout: 15_000 }, async () => {\n const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-concurrent-start-\"));\n const configPath = join(root, \"daemon.yaml\");\n const binaryPath = writeReadyRuntime(root);\n\n try {\n const [first, second] = await Promise.all([\n startBackgroundRuntime({ binaryPath, configPath, projectDirs: [root] }),\n startBackgroundRuntime({ binaryPath, configPath, projectDirs: [root] }),\n ]);\n\n assert.notEqual(first.pid, second.pid);\n assert.ok(first.pid);\n assert.equal(processIsRunning(first.pid), false);\n assert.equal(backgroundRuntimeStatus(configPath).pid, second.pid);\n } finally {\n await stopBackgroundRuntime(configPath).catch(() => undefined);\n rmSync(root, { recursive: true, force: true });\n }\n});\n\ntest(\"verbose background starts forward the flag to the runtime child\", { timeout: 10_000 }, async () => {\n const root = mkdtempSync(join(tmpdir(), \"gsd-cloud-verbose-start-\"));\n const configPath = join(root, \"daemon.yaml\");\n const binaryPath = writeReadyRuntime(root);\n\n try {\n await startBackgroundRuntime({\n binaryPath,\n configPath,\n projectDirs: [root],\n verbose: true,\n });\n\n const args = JSON.parse(readFileSync(join(root, \"runtime-args.json\"), \"utf8\")) as string[];\n assert.ok(args.includes(\"--verbose\"));\n } finally {\n await stopBackgroundRuntime(configPath).catch(() => undefined);\n rmSync(root, { recursive: true, force: true });\n }\n});\n\nfunction writeReadyRuntime(root: string): string {\n const binaryPath = join(root, \"runtime.mjs\");\n writeFileSync(binaryPath, [\n 'import { writeFileSync } from \"node:fs\";',\n `writeFileSync(${JSON.stringify(join(root, \"runtime-args.json\"))}, JSON.stringify(process.argv.slice(2)));`,\n 'process.on(\"SIGTERM\", () => process.exit(0));',\n 'process.send?.({ type: \"ready\" });',\n 'setInterval(() => undefined, 1_000);',\n ].join(\"\\n\"));\n return binaryPath;\n}\n\nfunction processIsRunning(pid: number): boolean {\n try {\n process.kill(pid, 0);\n return true;\n } catch {\n return false;\n }\n}\n"]}

package/packages/gsd-cloud/dist/types.d.ts ADDED Viewed

@@ -0,0 +1,51 @@
+/**
+ * Log severity levels, ordered from most to least verbose.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * A single structured log entry written as JSON-lines.
+ */
+export interface LogEntry {
+    /** ISO-8601 timestamp */
+    ts: string;
+    level: LogLevel;
+    msg: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Top-level daemon configuration, loaded from YAML.
+ *
+ * Only the `cloud` and `log` blocks are load-bearing for the standalone agent.
+ * The `discord` and `projects` blocks are preserved so an existing
+ * `~/.gsd/daemon.yaml` written by the full daemon parses without loss, but the
+ * standalone agent does not act on them (it uses its own project source).
+ */
+export interface DaemonConfig {
+    cloud?: {
+        gateway_url: string;
+        device_token?: string;
+        runtime_id?: string;
+        runtime_name?: string;
+        enabled?: boolean;
+    };
+    discord?: {
+        token: string;
+        guild_id: string;
+        owner_id: string;
+        dm_on_blocker?: boolean;
+        control_channel_id?: string;
+        orchestrator?: {
+            model?: string;
+            max_tokens?: number;
+        };
+    };
+    projects: {
+        scan_roots: string[];
+    };
+    log: {
+        file: string;
+        level: LogLevel;
+        max_size_mb: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/gsd-cloud/dist/types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,YAAY,CAAC,EAAE;YACb,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,QAAQ,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH"}

package/packages/gsd-cloud/dist/types.js ADDED Viewed

@@ -0,0 +1,9 @@
+// Project/App: Open GSD
+// File Purpose: Trimmed, self-contained config/log types for the standalone cloud agent.
+//
+// This is a deliberately minimal copy of the daemon's types.ts. It defines ONLY
+// what the extracted cloud path needs (config parsing, logging) and imports NO
+// `@opengsd/rpc-client` or `@opengsd/contracts` — that is what makes this package
+// installable without the internal `@gsd/*` scope.
+export {};
+//# sourceMappingURL=types.js.map

package/packages/gsd-cloud/dist/types.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,yFAAyF;AACzF,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,kFAAkF;AAClF,mDAAmD","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Trimmed, self-contained config/log types for the standalone cloud agent.\n//\n// This is a deliberately minimal copy of the daemon's types.ts. It defines ONLY\n// what the extracted cloud path needs (config parsing, logging) and imports NO\n// `@opengsd/rpc-client` or `@opengsd/contracts` — that is what makes this package\n// installable without the internal `@gsd/*` scope.\n\n/**\n * Log severity levels, ordered from most to least verbose.\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * A single structured log entry written as JSON-lines.\n */\nexport interface LogEntry {\n /** ISO-8601 timestamp */\n ts: string;\n level: LogLevel;\n msg: string;\n data?: Record<string, unknown>;\n}\n\n/**\n * Top-level daemon configuration, loaded from YAML.\n *\n * Only the `cloud` and `log` blocks are load-bearing for the standalone agent.\n * The `discord` and `projects` blocks are preserved so an existing\n * `~/.gsd/daemon.yaml` written by the full daemon parses without loss, but the\n * standalone agent does not act on them (it uses its own project source).\n */\nexport interface DaemonConfig {\n cloud?: {\n gateway_url: string;\n device_token?: string;\n runtime_id?: string;\n runtime_name?: string;\n enabled?: boolean;\n };\n discord?: {\n token: string;\n guild_id: string;\n owner_id: string;\n dm_on_blocker?: boolean;\n control_channel_id?: string;\n orchestrator?: {\n model?: string;\n max_tokens?: number;\n };\n };\n projects: {\n scan_roots: string[];\n };\n log: {\n file: string;\n level: LogLevel;\n max_size_mb: number;\n };\n}\n"]}

package/packages/gsd-cloud/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@opengsd/gsd-cloud",
-  "version": "1.8.1",
+  "version": "1.9.0-dev.97ef11e3",
   "description": "Standalone CLI agent that connects a local GSD runtime to GSD Cloud (cloud.opengsd.net)",
   "license": "MIT",
   "repository": {
@@ -16,8 +16,8 @@
     "gsd-cloud": "./bin/gsd-cloud.js"
   },
   "scripts": {
-    "build": "node ../../scripts/clean-package-dist.cjs && tsc",
-    "test": "pnpm run build && node --test dist/inject-gateway.test.js dist/cloud-gateway-lookup.test.js dist/cloud-runtime.test.js dist/executors/mcp-stdio-client.test.js dist/executors/gsd-pi-executor.test.js"
+    "build": "node ../../scripts/clean-package-dist.cjs && tsc -p tsconfig.json --incremental false",
+    "test": "pnpm run build && node --test dist/inject-gateway.test.js dist/cloud-gateway-lookup.test.js dist/cloud-config.test.js dist/device-flow.test.js dist/cloud-runtime.test.js dist/runtime-process.test.js dist/background-cli.test.js dist/executors/mcp-stdio-client.test.js dist/executors/gsd-pi-executor.test.js"
   },
   "dependencies": {
     "ws": "^8.21.0",

package/packages/mcp-server/README.md CHANGED Viewed

@@ -87,6 +87,8 @@ The workflow MCP surface includes:
 - `gsd_plan_slice`
 - `gsd_plan_task`
 - `gsd_replan_slice`
+- `gsd_replan_task`
+- `gsd_rework_brief_save`
 - `gsd_slice_complete`
 - `gsd_skip_slice`
 - `gsd_complete_milestone`
@@ -108,14 +110,22 @@ The workflow MCP surface includes:
 - `gsd_memory_query`
 - `gsd_memory_graph`
-**Aliases (kept for backwards compatibility — prefer the canonical name above):** `gsd_save_decision`, `gsd_update_requirement`, `gsd_save_requirement`, `gsd_save_summary`, `gsd_generate_milestone_id`, `gsd_milestone_plan`, `gsd_slice_plan`, `gsd_task_plan`, `gsd_slice_replan`, `gsd_complete_task`, `gsd_complete_slice`, `gsd_milestone_validate`, `gsd_milestone_complete`, `gsd_roadmap_reassess`, `gsd_reopen_task`, `gsd_reopen_slice`, `gsd_reopen_milestone`.
+By default, the packaged MCP server advertises only the canonical workflow tool names above. Legacy aliases are compatibility names and are not included in `tools/list` unless `GSD_MCP_ADVERTISE_ALIASES=1` is set. Prefer moving clients and prompts to canonical names before enabling aliases, because aliases duplicate schemas in the model-facing tool surface.
 These tools use the same GSD workflow handlers as the native in-process tool path wherever a shared handler exists.
-`gsd_decision_save` and its `gsd_save_decision` alias persist new decisions to the ADR-013 memory store, not to the legacy `decisions` table. The assigned `D###` ID is recorded in `memories.structured_fields.sourceDecisionId`, and `.gsd/DECISIONS.md` is refreshed as a projection from memory-backed decisions. The legacy table may still be read by compatibility and inspection paths during the cutover window, but it is no longer a write target.
+**Opt-in aliases (kept for backwards compatibility — prefer the canonical name above):** `gsd_save_decision`, `gsd_update_requirement`, `gsd_save_requirement`, `gsd_save_summary`, `gsd_generate_milestone_id`, `gsd_milestone_plan`, `gsd_slice_plan`, `gsd_task_plan`, `gsd_slice_replan`, `gsd_complete_task`, `gsd_complete_slice`, `gsd_milestone_validate`, `gsd_milestone_complete`, `gsd_roadmap_reassess`, `gsd_reopen_task`, `gsd_reopen_slice`, `gsd_reopen_milestone`.
+`gsd_decision_save` persists new decisions to the ADR-013 memory store, not to the legacy `decisions` table. If alias advertising is enabled, `gsd_save_decision` delegates to the same behavior. The assigned `D###` ID is recorded in `memories.structured_fields.sourceDecisionId`, and `.gsd/DECISIONS.md` is refreshed as a projection from memory-backed decisions. The legacy table may still be read by compatibility and inspection paths during the cutover window, but it is no longer a write target.
 `gsd_summary_save` computes artifact paths from the supplied IDs. `milestone_id` is required for milestone-, slice-, and task-scoped artifact types (`SUMMARY`, `RESEARCH`, `CONTEXT`, `ASSESSMENT`, `CONTEXT-DRAFT`) and should be omitted only for root-level `PROJECT`, `PROJECT-DRAFT`, `REQUIREMENTS`, and `REQUIREMENTS-DRAFT` artifacts. The `content` field has a schema `maxLength` of 50,000 characters per save; callers that produce larger artifacts should save incrementally by writing a substantive draft, then re-save the enriched artifact as more detail is available. For final `REQUIREMENTS` saves, the tool renders content from active database requirement rows; callers must create those rows with `gsd_requirement_save` first.
+`gsd_replan_task` updates one existing pending task's planning contract after rework without replacing sibling tasks. `projectDir` is optional; when omitted, the server uses its current project or worktree root. Required parameters are `milestoneId`, `sliceId`, `taskId`, `title`, `description`, `estimate`, `files`, `verify`, `inputs`, and `expectedOutput`; `reworkBriefRef` is optional and records the brief that triggered the update. The tool rejects missing tasks and closed/completed tasks; reopen a completed task first with `gsd_task_reopen`.
+`gsd_rework_brief_save` persists structured rework findings for a task. `projectDir` is optional; required parameters are `milestoneId`, `sliceId`, `taskId`, and a non-empty `findings` array. Each finding requires `findingId`, `severity` (`blocking` or `advisory`), `description`, `requiredFix`, and `verificationCommands`; optional fields are `status`, `evidence`, and `decisionRef`.
+Blocking findings saved by `gsd_rework_brief_save` gate `gsd_task_complete`. To complete the task, the `gsd_task_complete` call must include a `reworkResolution` entry for each pending blocking `findingId` with `status: "resolved"` and non-empty `evidence`. Deferred findings must use `status: "deferred-with-override"` with non-empty `evidence` and a `decisionRef`.
 ### Interactive tools
 The packaged server exposes `ask_user_questions` through MCP form elicitation. This keeps the existing GSD answer payload shape while allowing Claude Code CLI and other elicitation-capable clients to surface structured user choices.
@@ -263,6 +273,9 @@ Resolve a pending blocker in a session by sending a response to the blocked UI r
 | `GSD_WORKFLOW_EXECUTORS_MODULE` | Optional absolute path or `file:` URL for the shared GSD workflow executor module used by workflow mutation tools. |
 | `GSD_WORKFLOW_WRITE_GATE_MODULE` | Optional absolute path or `file:` URL for the shared write-gate module used by workflow mutation tools. |
 | `GSD_WORKFLOW_PROJECT_ROOT` | Canonical project root for workflow tools and the per-project MCP PID registry key. Defaults to the server's current working directory. |
+| `GSD_MCP_ADVERTISE_ALIASES` | Set to literal `1` to include legacy workflow aliases in the packaged MCP server's `tools/list`. Unset by default, so the server advertises canonical tool names only. |
+| `GSD_MCP_HIDE_ALIASES` | Legacy force-hide switch. Set to literal `1` to keep packaged MCP aliases hidden even when `GSD_MCP_ADVERTISE_ALIASES=1`. |
+| `GSD_ADVERTISE_TOOL_ALIASES` | Set to literal `1` to register legacy workflow aliases on the native in-process GSD tool surface. This does not affect the packaged MCP server; use `GSD_MCP_ADVERTISE_ALIASES` for `gsd-mcp-server`. |
 | `GSD_HOME` | Global GSD directory. Also controls where `mcp-instances.json` is stored. |
 The server also hydrates supported model-provider and tool credentials from `~/.gsd/agent/auth.json` on startup. Keys saved through `/gsd config` or `/gsd keys` become available to the MCP server process automatically, and any explicitly-set environment variable still wins.

package/packages/mcp-server/dist/cli-runner.d.ts CHANGED Viewed

@@ -34,6 +34,9 @@ export interface RunMcpServerCliOptions {
     clearInterval?: typeof clearInterval;
     isOrphaned?: () => boolean;
     cleanupStepTimeoutMs?: number;
+    stdinIdleTimeoutMs?: number;
+    stdinIdleCheckIntervalMs?: number;
+    orphanParentLossCheckIntervalMs?: number;
 }
 export declare function runMcpServerCli(options?: RunMcpServerCliOptions): Promise<void>;
 export {};

package/packages/mcp-server/dist/cli-runner.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;~~AAiCtD~~,UAAU,kBAAkB;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,UAAU,yBAAyB;IACjC,KAAI,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACnD;~~AAED~~,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/B,2BAA2B,CAAC,EAAE,MAAM,IAAI,CAAC;IACzC,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAC7D,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,oBAAoB,CAAC,EAAE,MAAM,kBAAkB,CAAC;IAChD,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,kBAAkB,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC7F,0BAA0B,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,oBAAoB,EAAE,yBAAyB,CAAA;KAAE,CAAC,CAAC;IAChG,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC3D,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;~~CAC/~~B;~~AAkBD~~,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,~~CA4IzF~~"}
1	+ {"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA0EtD,UAAU,kBAAkB;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,UAAU,yBAAyB;IACjC,KAAI,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACnD;AAMD,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/B,2BAA2B,CAAC,EAAE,MAAM,IAAI,CAAC;IACzC,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAC7D,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,oBAAoB,CAAC,EAAE,MAAM,kBAAkB,CAAC;IAChD,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,kBAAkB,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC7F,0BAA0B,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,oBAAoB,EAAE,yBAAyB,CAAA;KAAE,CAAC,CAAC;IAChG,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC3D,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,+BAA+B,CAAC,EAAE,MAAM,CAAC;CAC1C;AA4ED,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAsJzF"}

package/packages/mcp-server/dist/cli-runner.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { Worker } from 'node:worker_threads';
 import { SessionManager } from './session-manager.js';
 import { createMcpServer } from './server.js';
 import { loadStoredCredentialEnvKeys } from './tool-credentials.js';
@@ -10,17 +11,56 @@ const STDIN_IDLE_TIMEOUT_MS = 5 * 60 * 1000;
 const STDIN_IDLE_CHECK_INTERVAL_MS = 60 * 1000;
 const CLEANUP_STEP_TIMEOUT_MS = 2 * 1000;
 /**
- * Cadence for the ref-held parent-liveness monitor.
+ * Cadence for the worker-thread parent-liveness monitor.
  *
- * Separate from the `.unref()`'d idle watchdog: a process already pegged at
- * ~100% CPU starves its event loop, so the watchdog timer may never fire and a
- * spinning orphan lingers until the next spawn sweeps it. This monitor is
- * ref-held (NOT `.unref()`'d) so the libuv loop keeps scheduling it under load,
- * and it exits the process itself the moment the parent is gone — independent
- * of the external PID-registry sweep that only runs on the next launch. See
- * #783.
+ * Separate from the main-thread idle watchdog: a process pegged at ~100% CPU
+ * can starve the JS event loop, preventing timers and signal handlers from
+ * dispatching. The worker has its own event loop and hard-kills this process
+ * when the parent is gone and stdin has been idle long enough. See #1384.
  */
 const ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS = 10 * 1000;
+const ORPHAN_MONITOR_WORKER_SOURCE = `
+import { writeSync } from 'node:fs';
+import { parentPort, workerData } from 'node:worker_threads';
+const lastActivityMs = new BigInt64Array(workerData.lastActivityMsBuffer);
+let stopped = false;
+function parentGone() {
+  if (process.ppid !== workerData.initialParentPid) return true;
+  try {
+    process.kill(workerData.initialParentPid, 0);
+    return false;
+  } catch (err) {
+    return err && err.code === 'ESRCH';
+  }
+}
+function check() {
+  if (stopped) return;
+  const last = Number(Atomics.load(lastActivityMs, 0));
+  if (Date.now() - last <= workerData.idleTimeoutMs) return;
+  if (!parentGone()) return;
+  try {
+    writeSync(2, '[gsd-mcp-server] Parent process is gone and stdin is idle; hard-killing orphaned server\\n');
+  } catch {}
+  try {
+    process.kill(workerData.targetPid, 'SIGKILL');
+  } catch {
+    process.exit(0);
+  }
+}
+const timer = setInterval(check, workerData.checkIntervalMs);
+parentPort?.on('message', (message) => {
+  if (message && message.type === 'stop') {
+    stopped = true;
+    clearInterval(timer);
+    process.exit(0);
+  }
+});
+check();
+`;
 function createDefaultIsOrphaned(initialParentPid) {
     return () => {
         if (process.ppid !== initialParentPid)
@@ -34,6 +74,43 @@ function createDefaultIsOrphaned(initialParentPid) {
         }
     };
 }
+function startWorkerOrphanMonitor(options) {
+    const worker = new Worker(ORPHAN_MONITOR_WORKER_SOURCE, {
+        eval: true,
+        workerData: {
+            initialParentPid: options.initialParentPid,
+            targetPid: options.targetPid,
+            lastActivityMsBuffer: options.lastActivityMsBuffer,
+            idleTimeoutMs: options.idleTimeoutMs,
+            checkIntervalMs: options.checkIntervalMs,
+        },
+    });
+    worker.unref();
+    worker.on('error', (err) => {
+        options.stderr.write(`[gsd-mcp-server] Orphan monitor failed: ${err instanceof Error ? err.message : String(err)}\n`);
+    });
+    return {
+        stop() {
+            worker.postMessage({ type: 'stop' });
+            void worker.terminate();
+        },
+    };
+}
+function startMainThreadOrphanMonitor(options) {
+    const interval = options.startInterval(() => {
+        if (!options.isOrphaned())
+            return;
+        if (options.idleMs() <= options.idleTimeoutMs)
+            return;
+        options.stderr.write(`[gsd-mcp-server] Parent process is gone; shutting down to avoid orphan spin\n`);
+        options.cleanup();
+    }, options.checkIntervalMs);
+    return {
+        stop() {
+            options.stopInterval(interval);
+        },
+    };
+}
 async function importDefaultStdioServerTransport() {
     return import(`${MCP_PKG}/server/stdio.js`);
 }
@@ -48,8 +125,12 @@ export async function runMcpServerCli(options = {}) {
     const now = options.now ?? (() => Date.now());
     const startInterval = options.setInterval ?? setInterval;
     const stopInterval = options.clearInterval ?? clearInterval;
-    const isOrphaned = options.isOrphaned ?? createDefaultIsOrphaned(process.ppid);
+    const initialParentPid = process.ppid;
+    const isOrphaned = options.isOrphaned ?? createDefaultIsOrphaned(initialParentPid);
     const cleanupStepTimeoutMs = options.cleanupStepTimeoutMs ?? CLEANUP_STEP_TIMEOUT_MS;
+    const stdinIdleTimeoutMs = options.stdinIdleTimeoutMs ?? STDIN_IDLE_TIMEOUT_MS;
+    const stdinIdleCheckIntervalMs = options.stdinIdleCheckIntervalMs ?? STDIN_IDLE_CHECK_INTERVAL_MS;
+    const orphanParentLossCheckIntervalMs = options.orphanParentLossCheckIntervalMs ?? ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS;
     const loadEnv = options.loadStoredCredentialEnvKeys ?? loadStoredCredentialEnvKeys;
     const registerInstance = options.registerMcpInstance ?? registerMcpInstance;
     const sweepOrphans = options.sweepProjectOrphanMcpServers ?? sweepProjectOrphanMcpServers;
@@ -65,6 +146,7 @@ export async function runMcpServerCli(options = {}) {
     let cleaningUp = false;
     let idleWatchdog;
     let orphanMonitor;
+    const lastActivityMs = new BigInt64Array(new SharedArrayBuffer(8));
     let trackedStdin;
     let sessionManager;
     let server;
@@ -92,8 +174,7 @@ export async function runMcpServerCli(options = {}) {
     async function stopRuntime() {
         if (idleWatchdog)
             stopInterval(idleWatchdog);
-        if (orphanMonitor)
-            stopInterval(orphanMonitor);
+        orphanMonitor?.stop();
         trackedStdin?.close();
         if (registered)
             unregisterInstance(projectDir);
@@ -124,33 +205,38 @@ export async function runMcpServerCli(options = {}) {
         sessionManager = createSessionManager();
         ({ server } = await createServer(sessionManager));
         const { StdioServerTransport } = await importTransport();
-        trackedStdin = createActivityTrackingInput(stdin, now);
+        trackedStdin = createActivityTrackingInput(stdin, () => {
+            const current = now();
+            Atomics.store(lastActivityMs, 0, BigInt(Math.trunc(current)));
+            return current;
+        });
         const transport = new StdioServerTransport(trackedStdin.input, stdout);
         idleWatchdog = startInterval(() => {
-            if (trackedStdin && now() - trackedStdin.lastActivityAt() > STDIN_IDLE_TIMEOUT_MS && isOrphaned()) {
-                stderr.write(`[gsd-mcp-server] Idle stdin watchdog: no activity for ${STDIN_IDLE_TIMEOUT_MS / 1000}s and parent process is gone, shutting down\n`);
+            if (trackedStdin && now() - trackedStdin.lastActivityAt() > stdinIdleTimeoutMs && isOrphaned()) {
+                stderr.write(`[gsd-mcp-server] Idle stdin watchdog: no activity for ${stdinIdleTimeoutMs / 1000}s and parent process is gone, shutting down\n`);
                 void cleanup();
             }
-        }, STDIN_IDLE_CHECK_INTERVAL_MS);
+        }, stdinIdleCheckIntervalMs);
         idleWatchdog.unref();
-        // Ref-held parent-liveness monitor (#783). The idle watchdog above is
-        // `.unref()`'d, so a process pegged at ~100% CPU (e.g. a repeating throw
-        // against a dead stdio pipe) starves its event loop and the watchdog never
-        // fires — the orphan spins until the next launch sweeps it. This monitor is
-        // NOT unref'd: the loop keeps scheduling it under load, so parent loss is
-        // detected in seconds regardless of CPU state. It still requires the same
-        // idle gate as the watchdog so an active session whose parent briefly
-        // appears gone is not killed (#783 "stays alive when parent is gone but
-        // stdin is still active").
-        orphanMonitor = startInterval(() => {
-            if (!isOrphaned())
-                return;
-            const idleMs = trackedStdin ? now() - trackedStdin.lastActivityAt() : 0;
-            if (idleMs <= STDIN_IDLE_TIMEOUT_MS)
-                return;
-            stderr.write(`[gsd-mcp-server] Parent process is gone; shutting down to avoid orphan spin\n`);
-            void cleanup();
-        }, ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS);
+        orphanMonitor = options.isOrphaned === undefined
+            ? startWorkerOrphanMonitor({
+                initialParentPid,
+                targetPid: process.pid,
+                lastActivityMsBuffer: lastActivityMs.buffer,
+                idleTimeoutMs: stdinIdleTimeoutMs,
+                checkIntervalMs: orphanParentLossCheckIntervalMs,
+                stderr,
+            })
+            : startMainThreadOrphanMonitor({
+                startInterval,
+                stopInterval,
+                isOrphaned,
+                idleMs: () => trackedStdin ? now() - trackedStdin.lastActivityAt() : 0,
+                idleTimeoutMs: stdinIdleTimeoutMs,
+                checkIntervalMs: orphanParentLossCheckIntervalMs,
+                stderr,
+                cleanup: () => void cleanup(),
+            });
         // Fail closed (ADR-036): warm the executor / write-gate bridges BEFORE
         // connecting the transport. If a bridge is broken we must not advertise the
         // workflow tool surface — a rejection here propagates to the catch below so

package/packages/mcp-server/dist/cli-runner.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Readable, Writable } from 'node:stream';\n\nimport { SessionManager } from './session-manager.js';\nimport { createMcpServer } from './server.js';\nimport { loadStoredCredentialEnvKeys } from './tool-credentials.js';\nimport { warmWorkflowToolBridges } from './workflow-tools.js';\nimport { isMcpProbeSession } from './probe-mode.js';\nimport {\n registerMcpInstance,\n sweepProjectOrphanMcpServers,\n unregisterMcpInstance,\n} from './pid-registry.js';\nimport { createActivityTrackingInput, type ActivityTrackingInput } from './stdio-watchdog.js';\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\n\nconst STDIN_IDLE_TIMEOUT_MS = 5 * 60 * 1000;\nconst STDIN_IDLE_CHECK_INTERVAL_MS = 60 * 1000;\nconst CLEANUP_STEP_TIMEOUT_MS = 2 * 1000;\n\n/*\n Cadence for the ref-held parent-liveness monitor.\n \n Separate from the `.unref()`'d idle watchdog: a process already pegged at\n * ~100% CPU starves its event loop, so the watchdog timer may never fire and a\n * spinning orphan lingers until the next spawn sweeps it. This monitor is\n * ref-held (NOT `.unref()`'d) so the libuv loop keeps scheduling it under load,\n * and it exits the process itself the moment the parent is gone — independent\n * of the external PID-registry sweep that only runs on the next launch. See\n * #783.\n /\nconst ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS = 10 1000;\n\ninterface SessionManagerLike {\n cleanup(): Promise<void>;\n}\n\ninterface McpServerLike {\n connect(transport: unknown): Promise<void>;\n close(): Promise<void>;\n}\n\ninterface StdioTransportConstructor {\n new(input?: Readable, output?: Writable): unknown;\n}\n\nexport interface RunMcpServerCliOptions {\n cwd?: () => string;\n env?: NodeJS.ProcessEnv;\n exit?: (code: number) => never;\n loadStoredCredentialEnvKeys?: () => void;\n registerMcpInstance?: (projectDir: string) => boolean \| void;\n sweepProjectOrphanMcpServers?: (projectDir: string) => void;\n unregisterMcpInstance?: (projectDir: string) => void;\n createSessionManager?: () => SessionManagerLike;\n createMcpServer?: (sessionManager: SessionManagerLike) => Promise<{ server: McpServerLike }>;\n importStdioServerTransport?: () => Promise<{ StdioServerTransport: StdioTransportConstructor }>;\n warmWorkflowToolBridges?: () => Promise<unknown> \| unknown;\n stdin?: Readable;\n stdout?: Writable;\n stderr?: Writable;\n onSignal?: (signal: NodeJS.Signals, listener: () => void) => void;\n now?: () => number;\n setInterval?: typeof setInterval;\n clearInterval?: typeof clearInterval;\n isOrphaned?: () => boolean;\n cleanupStepTimeoutMs?: number;\n}\n\nfunction createDefaultIsOrphaned(initialParentPid: number): () => boolean {\n return () => {\n if (process.ppid !== initialParentPid) return true;\n try {\n process.kill(initialParentPid, 0);\n return false;\n } catch (err) {\n return (err as NodeJS.ErrnoException).code === 'ESRCH';\n }\n };\n}\n\nasync function importDefaultStdioServerTransport(): Promise<{ StdioServerTransport: StdioTransportConstructor }> {\n return import(`${MCP_PKG}/server/stdio.js`) as Promise<{ StdioServerTransport: StdioTransportConstructor }>;\n}\n\nexport async function runMcpServerCli(options: RunMcpServerCliOptions = {}): Promise<void> {\n const cwd = options.cwd ?? (() => process.cwd());\n const env = options.env ?? process.env;\n const exit = options.exit ?? ((code: number): never => process.exit(code));\n const stdin = options.stdin ?? process.stdin;\n const stdout = options.stdout ?? process.stdout;\n const stderr = options.stderr ?? process.stderr;\n const onSignal = options.onSignal ?? ((signal, listener) => process.on(signal, listener));\n const now = options.now ?? (() => Date.now());\n const startInterval = options.setInterval ?? setInterval;\n const stopInterval = options.clearInterval ?? clearInterval;\n const isOrphaned = options.isOrphaned ?? createDefaultIsOrphaned(process.ppid);\n const cleanupStepTimeoutMs = options.cleanupStepTimeoutMs ?? CLEANUP_STEP_TIMEOUT_MS;\n const loadEnv = options.loadStoredCredentialEnvKeys ?? loadStoredCredentialEnvKeys;\n const registerInstance = options.registerMcpInstance ?? registerMcpInstance;\n const sweepOrphans = options.sweepProjectOrphanMcpServers ?? sweepProjectOrphanMcpServers;\n const unregisterInstance = options.unregisterMcpInstance ?? unregisterMcpInstance;\n const createSessionManager = options.createSessionManager ?? (() => new SessionManager());\n const createServer = options.createMcpServer ?? (\n async (manager: SessionManagerLike) => createMcpServer(manager as SessionManager)\n );\n const importTransport = options.importStdioServerTransport ?? importDefaultStdioServerTransport;\n const warmBridges = options.warmWorkflowToolBridges ?? warmWorkflowToolBridges;\n\n loadEnv();\n\n const projectDir = env.GSD_WORKFLOW_PROJECT_ROOT \|\| cwd();\n const probeSession = isMcpProbeSession(env);\n let registered = false;\n let cleaningUp = false;\n let idleWatchdog: ReturnType<typeof setInterval> \| undefined;\n let orphanMonitor: ReturnType<typeof setInterval> \| undefined;\n let trackedStdin: ActivityTrackingInput \| undefined;\n let sessionManager: SessionManagerLike \| undefined;\n let server: McpServerLike \| undefined;\n\n async function runCleanupStep(label: string, step: () => Promise<void> \| void): Promise<void> {\n let timeout: ReturnType<typeof setTimeout> \| undefined;\n try {\n await Promise.race([\n Promise.resolve().then(step),\n new Promise<void>((resolve) => {\n timeout = setTimeout(() => {\n stderr.write(`[gsd-mcp-server] Cleanup step timed out: ${label}\\n`);\n resolve();\n }, cleanupStepTimeoutMs);\n timeout.unref();\n }),\n ]);\n } catch {\n } finally {\n if (timeout) clearTimeout(timeout);\n }\n }\n\n async function stopRuntime(): Promise<void> {\n if (idleWatchdog) stopInterval(idleWatchdog);\n if (orphanMonitor) stopInterval(orphanMonitor);\n trackedStdin?.close();\n if (registered) unregisterInstance(projectDir);\n await runCleanupStep('session manager cleanup', () => sessionManager?.cleanup());\n await runCleanupStep('server close', () => server?.close());\n }\n\n async function cleanup(code = 0): Promise<void> {\n if (cleaningUp) return;\n cleaningUp = true;\n stderr.write('[gsd-mcp-server] Shutting down...\\n');\n await stopRuntime();\n exit(code);\n }\n\n onSignal('SIGTERM', () => void cleanup());\n onSignal('SIGINT', () => void cleanup());\n stdin.once('end', () => void cleanup());\n stdin.once('close', () => void cleanup());\n stdin.once('error', () => void cleanup(1));\n\n try {\n if (!probeSession) {\n sweepOrphans(projectDir);\n if (registerInstance(projectDir) === false) {\n throw new Error('refusing to start: existing MCP server PID could not be verified');\n }\n registered = true;\n }\n\n sessionManager = createSessionManager();\n ({ server } = await createServer(sessionManager));\n\n const { StdioServerTransport } = await importTransport();\n trackedStdin = createActivityTrackingInput(stdin, now);\n const transport = new StdioServerTransport(trackedStdin.input, stdout);\n\n idleWatchdog = startInterval(() => {\n if (trackedStdin && now() - trackedStdin.lastActivityAt() > STDIN_IDLE_TIMEOUT_MS && isOrphaned()) {\n stderr.write(\n `[gsd-mcp-server] Idle stdin watchdog: no activity for ${STDIN_IDLE_TIMEOUT_MS / 1000}s and parent process is gone, shutting down\\n`,\n );\n void cleanup();\n }\n }, STDIN_IDLE_CHECK_INTERVAL_MS);\n idleWatchdog.unref();\n\n // Ref-held parent-liveness monitor (#783). The idle watchdog above is\n // `.unref()`'d, so a process pegged at ~100% CPU (e.g. a repeating throw\n // against a dead stdio pipe) starves its event loop and the watchdog never\n // fires — the orphan spins until the next launch sweeps it. This monitor is\n // NOT unref'd: the loop keeps scheduling it under load, so parent loss is\n // detected in seconds regardless of CPU state. It still requires the same\n // idle gate as the watchdog so an active session whose parent briefly\n // appears gone is not killed (#783 \"stays alive when parent is gone but\n // stdin is still active\").\n orphanMonitor = startInterval(() => {\n if (!isOrphaned()) return;\n const idleMs = trackedStdin ? now() - trackedStdin.lastActivityAt() : 0;\n if (idleMs <= STDIN_IDLE_TIMEOUT_MS) return;\n stderr.write(\n `[gsd-mcp-server] Parent process is gone; shutting down to avoid orphan spin\\n`,\n );\n void cleanup();\n }, ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS);\n\n // Fail closed (ADR-036): warm the executor / write-gate bridges BEFORE\n // connecting the transport. If a bridge is broken we must not advertise the\n // workflow tool surface — a rejection here propagates to the catch below so\n // startup aborts and the client never sees tools that would error on first\n // call. A healthy warm-up pre-pays the bridge import so the first real tool\n // call stays fast.\n await warmBridges();\n stderr.write('[gsd-mcp-server] workflow bridges ready\\n');\n\n await server.connect(transport);\n stderr.write('[gsd-mcp-server] MCP server started on stdio\\n');\n } catch (err) {\n stderr.write(\n `[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\\n`,\n );\n await cleanup(1);\n }\n}\n"]}
1	+ {"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Readable, Writable } from 'node:stream';\nimport { Worker } from 'node:worker_threads';\n\nimport { SessionManager } from './session-manager.js';\nimport { createMcpServer } from './server.js';\nimport { loadStoredCredentialEnvKeys } from './tool-credentials.js';\nimport { warmWorkflowToolBridges } from './workflow-tools.js';\nimport { isMcpProbeSession } from './probe-mode.js';\nimport {\n registerMcpInstance,\n sweepProjectOrphanMcpServers,\n unregisterMcpInstance,\n} from './pid-registry.js';\nimport { createActivityTrackingInput, type ActivityTrackingInput } from './stdio-watchdog.js';\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\n\nconst STDIN_IDLE_TIMEOUT_MS = 5 * 60 * 1000;\nconst STDIN_IDLE_CHECK_INTERVAL_MS = 60 * 1000;\nconst CLEANUP_STEP_TIMEOUT_MS = 2 * 1000;\n\n/*\n Cadence for the worker-thread parent-liveness monitor.\n \n Separate from the main-thread idle watchdog: a process pegged at ~100% CPU\n * can starve the JS event loop, preventing timers and signal handlers from\n * dispatching. The worker has its own event loop and hard-kills this process\n * when the parent is gone and stdin has been idle long enough. See #1384.\n /\nconst ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS = 10 1000;\n\nconst ORPHAN_MONITOR_WORKER_SOURCE = `\nimport { writeSync } from 'node:fs';\nimport { parentPort, workerData } from 'node:worker_threads';\n\nconst lastActivityMs = new BigInt64Array(workerData.lastActivityMsBuffer);\nlet stopped = false;\n\nfunction parentGone() {\n if (process.ppid !== workerData.initialParentPid) return true;\n try {\n process.kill(workerData.initialParentPid, 0);\n return false;\n } catch (err) {\n return err && err.code === 'ESRCH';\n }\n}\n\nfunction check() {\n if (stopped) return;\n const last = Number(Atomics.load(lastActivityMs, 0));\n if (Date.now() - last <= workerData.idleTimeoutMs) return;\n if (!parentGone()) return;\n try {\n writeSync(2, '[gsd-mcp-server] Parent process is gone and stdin is idle; hard-killing orphaned server\\\\n');\n } catch {}\n try {\n process.kill(workerData.targetPid, 'SIGKILL');\n } catch {\n process.exit(0);\n }\n}\n\nconst timer = setInterval(check, workerData.checkIntervalMs);\nparentPort?.on('message', (message) => {\n if (message && message.type === 'stop') {\n stopped = true;\n clearInterval(timer);\n process.exit(0);\n }\n});\ncheck();\n`;\n\ninterface SessionManagerLike {\n cleanup(): Promise<void>;\n}\n\ninterface McpServerLike {\n connect(transport: unknown): Promise<void>;\n close(): Promise<void>;\n}\n\ninterface StdioTransportConstructor {\n new(input?: Readable, output?: Writable): unknown;\n}\n\ninterface OrphanMonitorHandle {\n stop(): void;\n}\n\nexport interface RunMcpServerCliOptions {\n cwd?: () => string;\n env?: NodeJS.ProcessEnv;\n exit?: (code: number) => never;\n loadStoredCredentialEnvKeys?: () => void;\n registerMcpInstance?: (projectDir: string) => boolean \| void;\n sweepProjectOrphanMcpServers?: (projectDir: string) => void;\n unregisterMcpInstance?: (projectDir: string) => void;\n createSessionManager?: () => SessionManagerLike;\n createMcpServer?: (sessionManager: SessionManagerLike) => Promise<{ server: McpServerLike }>;\n importStdioServerTransport?: () => Promise<{ StdioServerTransport: StdioTransportConstructor }>;\n warmWorkflowToolBridges?: () => Promise<unknown> \| unknown;\n stdin?: Readable;\n stdout?: Writable;\n stderr?: Writable;\n onSignal?: (signal: NodeJS.Signals, listener: () => void) => void;\n now?: () => number;\n setInterval?: typeof setInterval;\n clearInterval?: typeof clearInterval;\n isOrphaned?: () => boolean;\n cleanupStepTimeoutMs?: number;\n stdinIdleTimeoutMs?: number;\n stdinIdleCheckIntervalMs?: number;\n orphanParentLossCheckIntervalMs?: number;\n}\n\nfunction createDefaultIsOrphaned(initialParentPid: number): () => boolean {\n return () => {\n if (process.ppid !== initialParentPid) return true;\n try {\n process.kill(initialParentPid, 0);\n return false;\n } catch (err) {\n return (err as NodeJS.ErrnoException).code === 'ESRCH';\n }\n };\n}\n\nfunction startWorkerOrphanMonitor(options: {\n initialParentPid: number;\n targetPid: number;\n lastActivityMsBuffer: SharedArrayBuffer;\n idleTimeoutMs: number;\n checkIntervalMs: number;\n stderr: Writable;\n}): OrphanMonitorHandle {\n const worker = new Worker(ORPHAN_MONITOR_WORKER_SOURCE, {\n eval: true,\n workerData: {\n initialParentPid: options.initialParentPid,\n targetPid: options.targetPid,\n lastActivityMsBuffer: options.lastActivityMsBuffer,\n idleTimeoutMs: options.idleTimeoutMs,\n checkIntervalMs: options.checkIntervalMs,\n },\n });\n worker.unref();\n worker.on('error', (err) => {\n options.stderr.write(\n `[gsd-mcp-server] Orphan monitor failed: ${err instanceof Error ? err.message : String(err)}\\n`,\n );\n });\n return {\n stop() {\n worker.postMessage({ type: 'stop' });\n void worker.terminate();\n },\n };\n}\n\nfunction startMainThreadOrphanMonitor(options: {\n startInterval: typeof setInterval;\n stopInterval: typeof clearInterval;\n isOrphaned: () => boolean;\n idleMs: () => number;\n idleTimeoutMs: number;\n checkIntervalMs: number;\n stderr: Writable;\n cleanup: () => void;\n}): OrphanMonitorHandle {\n const interval = options.startInterval(() => {\n if (!options.isOrphaned()) return;\n if (options.idleMs() <= options.idleTimeoutMs) return;\n options.stderr.write(\n `[gsd-mcp-server] Parent process is gone; shutting down to avoid orphan spin\\n`,\n );\n options.cleanup();\n }, options.checkIntervalMs);\n\n return {\n stop() {\n options.stopInterval(interval);\n },\n };\n}\n\nasync function importDefaultStdioServerTransport(): Promise<{ StdioServerTransport: StdioTransportConstructor }> {\n return import(`${MCP_PKG}/server/stdio.js`) as Promise<{ StdioServerTransport: StdioTransportConstructor }>;\n}\n\nexport async function runMcpServerCli(options: RunMcpServerCliOptions = {}): Promise<void> {\n const cwd = options.cwd ?? (() => process.cwd());\n const env = options.env ?? process.env;\n const exit = options.exit ?? ((code: number): never => process.exit(code));\n const stdin = options.stdin ?? process.stdin;\n const stdout = options.stdout ?? process.stdout;\n const stderr = options.stderr ?? process.stderr;\n const onSignal = options.onSignal ?? ((signal, listener) => process.on(signal, listener));\n const now = options.now ?? (() => Date.now());\n const startInterval = options.setInterval ?? setInterval;\n const stopInterval = options.clearInterval ?? clearInterval;\n const initialParentPid = process.ppid;\n const isOrphaned = options.isOrphaned ?? createDefaultIsOrphaned(initialParentPid);\n const cleanupStepTimeoutMs = options.cleanupStepTimeoutMs ?? CLEANUP_STEP_TIMEOUT_MS;\n const stdinIdleTimeoutMs = options.stdinIdleTimeoutMs ?? STDIN_IDLE_TIMEOUT_MS;\n const stdinIdleCheckIntervalMs = options.stdinIdleCheckIntervalMs ?? STDIN_IDLE_CHECK_INTERVAL_MS;\n const orphanParentLossCheckIntervalMs = options.orphanParentLossCheckIntervalMs ?? ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS;\n const loadEnv = options.loadStoredCredentialEnvKeys ?? loadStoredCredentialEnvKeys;\n const registerInstance = options.registerMcpInstance ?? registerMcpInstance;\n const sweepOrphans = options.sweepProjectOrphanMcpServers ?? sweepProjectOrphanMcpServers;\n const unregisterInstance = options.unregisterMcpInstance ?? unregisterMcpInstance;\n const createSessionManager = options.createSessionManager ?? (() => new SessionManager());\n const createServer = options.createMcpServer ?? (\n async (manager: SessionManagerLike) => createMcpServer(manager as SessionManager)\n );\n const importTransport = options.importStdioServerTransport ?? importDefaultStdioServerTransport;\n const warmBridges = options.warmWorkflowToolBridges ?? warmWorkflowToolBridges;\n\n loadEnv();\n\n const projectDir = env.GSD_WORKFLOW_PROJECT_ROOT \|\| cwd();\n const probeSession = isMcpProbeSession(env);\n let registered = false;\n let cleaningUp = false;\n let idleWatchdog: ReturnType<typeof setInterval> \| undefined;\n let orphanMonitor: OrphanMonitorHandle \| undefined;\n const lastActivityMs = new BigInt64Array(new SharedArrayBuffer(8));\n let trackedStdin: ActivityTrackingInput \| undefined;\n let sessionManager: SessionManagerLike \| undefined;\n let server: McpServerLike \| undefined;\n\n async function runCleanupStep(label: string, step: () => Promise<void> \| void): Promise<void> {\n let timeout: ReturnType<typeof setTimeout> \| undefined;\n try {\n await Promise.race([\n Promise.resolve().then(step),\n new Promise<void>((resolve) => {\n timeout = setTimeout(() => {\n stderr.write(`[gsd-mcp-server] Cleanup step timed out: ${label}\\n`);\n resolve();\n }, cleanupStepTimeoutMs);\n timeout.unref();\n }),\n ]);\n } catch {\n } finally {\n if (timeout) clearTimeout(timeout);\n }\n }\n\n async function stopRuntime(): Promise<void> {\n if (idleWatchdog) stopInterval(idleWatchdog);\n orphanMonitor?.stop();\n trackedStdin?.close();\n if (registered) unregisterInstance(projectDir);\n await runCleanupStep('session manager cleanup', () => sessionManager?.cleanup());\n await runCleanupStep('server close', () => server?.close());\n }\n\n async function cleanup(code = 0): Promise<void> {\n if (cleaningUp) return;\n cleaningUp = true;\n stderr.write('[gsd-mcp-server] Shutting down...\\n');\n await stopRuntime();\n exit(code);\n }\n\n onSignal('SIGTERM', () => void cleanup());\n onSignal('SIGINT', () => void cleanup());\n stdin.once('end', () => void cleanup());\n stdin.once('close', () => void cleanup());\n stdin.once('error', () => void cleanup(1));\n\n try {\n if (!probeSession) {\n sweepOrphans(projectDir);\n if (registerInstance(projectDir) === false) {\n throw new Error('refusing to start: existing MCP server PID could not be verified');\n }\n registered = true;\n }\n\n sessionManager = createSessionManager();\n ({ server } = await createServer(sessionManager));\n\n const { StdioServerTransport } = await importTransport();\n trackedStdin = createActivityTrackingInput(stdin, () => {\n const current = now();\n Atomics.store(lastActivityMs, 0, BigInt(Math.trunc(current)));\n return current;\n });\n const transport = new StdioServerTransport(trackedStdin.input, stdout);\n\n idleWatchdog = startInterval(() => {\n if (trackedStdin && now() - trackedStdin.lastActivityAt() > stdinIdleTimeoutMs && isOrphaned()) {\n stderr.write(\n `[gsd-mcp-server] Idle stdin watchdog: no activity for ${stdinIdleTimeoutMs / 1000}s and parent process is gone, shutting down\\n`,\n );\n void cleanup();\n }\n }, stdinIdleCheckIntervalMs);\n idleWatchdog.unref();\n\n orphanMonitor = options.isOrphaned === undefined\n ? startWorkerOrphanMonitor({\n initialParentPid,\n targetPid: process.pid,\n lastActivityMsBuffer: lastActivityMs.buffer as SharedArrayBuffer,\n idleTimeoutMs: stdinIdleTimeoutMs,\n checkIntervalMs: orphanParentLossCheckIntervalMs,\n stderr,\n })\n : startMainThreadOrphanMonitor({\n startInterval,\n stopInterval,\n isOrphaned,\n idleMs: () => trackedStdin ? now() - trackedStdin.lastActivityAt() : 0,\n idleTimeoutMs: stdinIdleTimeoutMs,\n checkIntervalMs: orphanParentLossCheckIntervalMs,\n stderr,\n cleanup: () => void cleanup(),\n });\n\n // Fail closed (ADR-036): warm the executor / write-gate bridges BEFORE\n // connecting the transport. If a bridge is broken we must not advertise the\n // workflow tool surface — a rejection here propagates to the catch below so\n // startup aborts and the client never sees tools that would error on first\n // call. A healthy warm-up pre-pays the bridge import so the first real tool\n // call stays fast.\n await warmBridges();\n stderr.write('[gsd-mcp-server] workflow bridges ready\\n');\n\n await server.connect(transport);\n stderr.write('[gsd-mcp-server] MCP server started on stdio\\n');\n } catch (err) {\n stderr.write(\n `[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\\n`,\n );\n await cleanup(1);\n }\n}\n"]}

package/packages/mcp-server/dist/server.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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~~CA2dD~~"}
1	+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/packages/mcp-server/dist/server.js CHANGED Viewed

@@ -1146,12 +1146,12 @@ export async function createMcpServer(sessionManager) {
             return errorContent(err instanceof Error ? err.message : String(err));
         }
     });
-    // Advertise backwards-compatibility aliases by default so external clients
-    // (especially Claude Code CLI) can call every gsd_* tool name the native LLM
-    // path recognizes. Set GSD_MCP_HIDE_ALIASES=1 to trim duplicate schemas when
-    // a client is known to use only canonical names.
+    // Canonical-only model-facing surface: the 17 alias tools would add ~6.8K
+    // tokens/turn of duplicate schemas. Set GSD_MCP_ADVERTISE_ALIASES=1 to
+    // restore alias advertising for clients that still call legacy names.
+    // GSD_MCP_HIDE_ALIASES=1 (legacy var) is honored as a no-op force-hide.
     registerWorkflowTools(server, {
-        advertiseAliases: process.env.GSD_MCP_HIDE_ALIASES !== '1',
+        advertiseAliases: process.env.GSD_MCP_ADVERTISE_ALIASES === '1' && process.env.GSD_MCP_HIDE_ALIASES !== '1',
     });
     installMoonshotCompatibleToolSchemas(server);
     return { server };