@opengsd/gsd-pi 1.9.0 → 1.10.0-dev.a5e42e99

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

@@ -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

@@ -1 +1 @@
-{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,2BAA2B,EAA8B,MAAM,qBAAqB,CAAC;AAE9F,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAE5C,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAC5C,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AAC/C,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,oCAAoC,GAAG,EAAE,GAAG,IAAI,CAAC;AAsCvD,SAAS,uBAAuB,CAAC,gBAAwB;IACvD,OAAO,GAAG,EAAE;QACV,IAAI,OAAO,CAAC,IAAI,KAAK,gBAAgB;YAAE,OAAO,IAAI,CAAC;QACnD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iCAAiC;IAC9C,OAAO,MAAM,CAAC,GAAG,OAAO,kBAAkB,CAAiE,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkC,EAAE;IACxE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAS,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;IACzD,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,uBAAuB,CAAC;IACrF,MAAM,OAAO,GAAG,OAAO,CAAC,2BAA2B,IAAI,2BAA2B,CAAC;IACnF,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,IAAI,mBAAmB,CAAC;IAC5E,MAAM,YAAY,GAAG,OAAO,CAAC,4BAA4B,IAAI,4BAA4B,CAAC;IAC1F,MAAM,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,IAAI,qBAAqB,CAAC;IAClF,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;IAC1F,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,IAAI,CAC9C,KAAK,EAAE,OAA2B,EAAE,EAAE,CAAC,eAAe,CAAC,OAAyB,CAAC,CAClF,CAAC;IACF,MAAM,eAAe,GAAG,OAAO,CAAC,0BAA0B,IAAI,iCAAiC,CAAC;IAChG,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,IAAI,uBAAuB,CAAC;IAE/E,OAAO,EAAE,CAAC;IAEV,MAAM,UAAU,GAAG,GAAG,CAAC,yBAAyB,IAAI,GAAG,EAAE,CAAC;IAC1D,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,YAAwD,CAAC;IAC7D,IAAI,aAAyD,CAAC;IAC9D,IAAI,YAA+C,CAAC;IACpD,IAAI,cAA8C,CAAC;IACnD,IAAI,MAAiC,CAAC;IAEtC,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,IAAgC;QAC3E,IAAI,OAAkD,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5B,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAC5B,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;wBACxB,MAAM,CAAC,KAAK,CAAC,4CAA4C,KAAK,IAAI,CAAC,CAAC;wBACpE,OAAO,EAAE,CAAC;oBACZ,CAAC,EAAE,oBAAoB,CAAC,CAAC;oBACzB,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,CAAC,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;QACT,CAAC;gBAAS,CAAC;YACT,IAAI,OAAO;gBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,UAAU,WAAW;QACxB,IAAI,YAAY;YAAE,YAAY,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,YAAY,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,UAAU;YAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,cAAc,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;QACjF,MAAM,cAAc,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,IAAI,GAAG,CAAC;QAC7B,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACpD,MAAM,WAAW,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,CAAC;IAED,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,CAAC,UAAU,CAAC,CAAC;YACzB,IAAI,gBAAgB,CAAC,UAAU,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,CAAC;YACD,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,cAAc,GAAG,oBAAoB,EAAE,CAAC;QACxC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QAElD,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC;QACzD,YAAY,GAAG,2BAA2B,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEvE,YAAY,GAAG,aAAa,CAAC,GAAG,EAAE;YAChC,IAAI,YAAY,IAAI,GAAG,EAAE,GAAG,YAAY,CAAC,cAAc,EAAE,GAAG,qBAAqB,IAAI,UAAU,EAAE,EAAE,CAAC;gBAClG,MAAM,CAAC,KAAK,CACV,yDAAyD,qBAAqB,GAAG,IAAI,+CAA+C,CACrI,CAAC;gBACF,KAAK,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACjC,YAAY,CAAC,KAAK,EAAE,CAAC;QAErB,sEAAsE;QACtE,yEAAyE;QACzE,2EAA2E;QAC3E,4EAA4E;QAC5E,0EAA0E;QAC1E,0EAA0E;QAC1E,sEAAsE;QACtE,wEAAwE;QACxE,2BAA2B;QAC3B,aAAa,GAAG,aAAa,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,UAAU,EAAE;gBAAE,OAAO;YAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,IAAI,MAAM,IAAI,qBAAqB;gBAAE,OAAO;YAC5C,MAAM,CAAC,KAAK,CACV,+EAA+E,CAChF,CAAC;YACF,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,oCAAoC,CAAC,CAAC;QAEzC,uEAAuE;QACvE,4EAA4E;QAC5E,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,mBAAmB;QACnB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAE1D,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CACV,6CAA6C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAClG,CAAC;QACF,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC","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"]}
+{"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

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

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

@@ -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 };