@opengsd/gsd-pi 1.2.0-dev.fb12b103 → 1.2.0-dev.fbdca60b

package/packages/mcp-server/dist/moonshot-tool-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonshot-tool-schema.js","sourceRoot":"","sources":["../src/moonshot-tool-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,wBAAwB,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAW,CAAC;AAoB7E;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAAC,SAAuC;IAC3F,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QACjE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC;aAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,WAA0D,CAAC,CAAC;YACxG,MAAM,cAAc,GAAG,QAAQ;gBAC9B,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;oBAC7B,YAAY,EAAE,IAAI;oBAClB,YAAY,EAAE,OAAO;iBACrB,CAAC;gBACH,CAAC,CAAC,wBAAwB,CAAC;YAE5B,MAAM,cAAc,GAA4B;gBAC/C,IAAI;gBACJ,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE,yBAAyB,CAAC,cAAc,CAAC;gBACtD,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;aACjB,CAAC;YAEF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,YAA2D,CAAC,CAAC;gBAC1G,IAAI,SAAS,EAAE,CAAC;oBACf,cAAc,CAAC,YAAY,GAAG,yBAAyB,CACtD,kBAAkB,CAAC,SAAS,EAAE;wBAC7B,YAAY,EAAE,IAAI;wBAClB,YAAY,EAAE,QAAQ;qBACtB,CAAC,CACF,CAAC;gBACH,CAAC;YACF,CAAC;YAED,OAAO,cAAc,CAAC;QACvB,CAAC,CAAC;KACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Moonshot-compatible MCP tool list schemas for Kimi Code and Moonshot API hosts.\n *\n * The MCP SDK converts Zod shapes to JSON Schema with anyOf for unions/nullable\n * fields. Moonshot rejects those patterns on tools.function.parameters.\n */\n\nimport { ListToolsRequestSchema } from \"@modelcontextprotocol/sdk/types.js\";\nimport { normalizeObjectSchema } from \"@modelcontextprotocol/sdk/server/zod-compat.js\";\nimport { toJsonSchemaCompat } from \"@modelcontextprotocol/sdk/server/zod-json-schema-compat.js\";\nimport { sanitizeSchemaForMoonshot } from \"@gsd/pi-ai\";\n\nconst EMPTY_OBJECT_JSON_SCHEMA = { type: \"object\", properties: {} } as const;\n\ntype RegisteredTool = {\n\tenabled: boolean;\n\ttitle?: string;\n\tdescription?: string;\n\tinputSchema?: unknown;\n\toutputSchema?: unknown;\n\tannotations?: unknown;\n\texecution?: unknown;\n\t_meta?: unknown;\n};\n\ntype McpServerWithRegisteredTools = {\n\tserver: {\n\t\tsetRequestHandler: (schema: unknown, handler: () => unknown) => void;\n\t};\n\t_registeredTools: Record<string, RegisteredTool>;\n};\n\n/**\n * Replace the MCP SDK ListTools handler so every advertised inputSchema is\n * flattened for Moonshot/Kimi grammar. Call after all tools are registered.\n */\nexport function installMoonshotCompatibleToolSchemas(mcpServer: McpServerWithRegisteredTools): void {\n\tmcpServer.server.setRequestHandler(ListToolsRequestSchema, () => ({\n\t\ttools: Object.entries(mcpServer._registeredTools)\n\t\t\t.filter(([, tool]) => tool.enabled)\n\t\t\t.map(([name, tool]) => {\n\t\t\t\tconst inputObj = normalizeObjectSchema(tool.inputSchema as Parameters<typeof normalizeObjectSchema>[0]);\n\t\t\t\tconst rawInputSchema = inputObj\n\t\t\t\t\t? toJsonSchemaCompat(inputObj, {\n\t\t\t\t\t\t\tstrictUnions: true,\n\t\t\t\t\t\t\tpipeStrategy: \"input\",\n\t\t\t\t\t\t})\n\t\t\t\t\t: EMPTY_OBJECT_JSON_SCHEMA;\n\n\t\t\t\tconst toolDefinition: Record<string, unknown> = {\n\t\t\t\t\tname,\n\t\t\t\t\ttitle: tool.title,\n\t\t\t\t\tdescription: tool.description,\n\t\t\t\t\tinputSchema: sanitizeSchemaForMoonshot(rawInputSchema),\n\t\t\t\t\tannotations: tool.annotations,\n\t\t\t\t\texecution: tool.execution,\n\t\t\t\t\t_meta: tool._meta,\n\t\t\t\t};\n\n\t\t\t\tif (tool.outputSchema) {\n\t\t\t\t\tconst outputObj = normalizeObjectSchema(tool.outputSchema as Parameters<typeof normalizeObjectSchema>[0]);\n\t\t\t\t\tif (outputObj) {\n\t\t\t\t\t\ttoolDefinition.outputSchema = sanitizeSchemaForMoonshot(\n\t\t\t\t\t\t\ttoJsonSchemaCompat(outputObj, {\n\t\t\t\t\t\t\t\tstrictUnions: true,\n\t\t\t\t\t\t\t\tpipeStrategy: \"output\",\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn toolDefinition;\n\t\t\t}),\n\t}));\n}\n"]}

package/packages/mcp-server/dist/pid-registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MCP server PID registry — tracks running instances per project so new
+ * launches can kill stale ones. Mirrors web-mode's web-instances.json pattern.
+ */
+export interface McpInstanceEntry {
+    pid: number;
+    projectDir: string;
+    startedAt: string;
+}
+export type McpInstanceRegistry = Record<string, McpInstanceEntry>;
+export interface RegisterMcpInstanceOptions {
+    kill?: (pid: number, signal?: NodeJS.Signals | 0) => void;
+    getProcessCommand?: (pid: number) => string | null;
+    getProcessCwd?: (pid: number) => string | null;
+    getProcessStartTime?: (pid: number) => number | null;
+    waitForExit?: () => void;
+}
+export interface McpProcessSnapshot {
+    pid: number;
+    ppid: number;
+    command: string;
+}
+export interface SweepProjectOrphanMcpServersOptions {
+    kill?: (pid: number, signal?: NodeJS.Signals | 0) => void;
+    getProcessCwd?: (pid: number) => string | null;
+    listProcesses?: () => McpProcessSnapshot[];
+    isOrphaned?: (proc: McpProcessSnapshot) => boolean;
+    waitForExit?: () => void;
+}
+export interface SweepProjectOrphanMcpServersResult {
+    matched: number[];
+    terminated: number[];
+    forceKilled: number[];
+    skipped: number[];
+}
+export declare function readMcpRegistry(registryPath?: string): McpInstanceRegistry;
+export declare function sweepProjectOrphanMcpServers(projectDir: string, options?: SweepProjectOrphanMcpServersOptions): SweepProjectOrphanMcpServersResult;
+/**
+ * Kill any existing MCP server for this project, then register our PID.
+ */
+export declare function registerMcpInstance(projectDir: string, registryPath?: string, options?: RegisterMcpInstanceOptions): boolean;
+/**
+ * Remove our PID from the registry on shutdown.
+ */
+export declare function unregisterMcpInstance(projectDir: string, registryPath?: string): void;
+//# sourceMappingURL=pid-registry.d.ts.map

package/packages/mcp-server/dist/pid-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-registry.d.ts","sourceRoot":"","sources":["../src/pid-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEnE,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,IAAI,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACnD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC/C,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,IAAI,CAAC;IAC1D,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,kBAAkB,EAAE,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD,wBAAgB,eAAe,CAAC,YAAY,SAAgB,GAAG,mBAAmB,CAwCjF;AAwRD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mCAAwC,GAChD,kCAAkC,CAgDpC;AAkED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,YAAY,SAAgB,EAC5B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAgCT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,SAAgB,GAAG,IAAI,CAa5F"}

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

@@ -0,0 +1,459 @@
+/**
+ * MCP server PID registry — tracks running instances per project so new
+ * launches can kill stale ones. Mirrors web-mode's web-instances.json pattern.
+ */
+import { execFileSync } from 'node:child_process';
+import { readFileSync, writeFileSync, mkdirSync, renameSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+const REGISTRY_PATH = join(process.env.GSD_HOME || join(homedir(), '.gsd'), 'mcp-instances.json');
+// A live PID is only treated as "our" stale server if its OS start time is no
+// later than the moment we recorded the registry entry (plus a small skew for
+// clock granularity / start-vs-register delay). A PID that started materially
+// later has been recycled by a different process and must not be signalled.
+const STALE_PID_START_SKEW_MS = 60_000;
+export function readMcpRegistry(registryPath = REGISTRY_PATH) {
+    let raw;
+    try {
+        raw = readFileSync(registryPath, 'utf8');
+    }
+    catch (err) {
+        // A missing file is the normal first-run case — start with an empty
+        // registry silently. Any other read error is worth surfacing.
+        if (err.code !== 'ENOENT') {
+            process.stderr.write(`[gsd-mcp-server] failed to read MCP registry ${registryPath}: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        throw new Error('registry is not a JSON object');
+    }
+    catch (err) {
+        // The file exists but is unparseable. Returning {} here means the next
+        // registerMcpInstance would overwrite the file and silently drop every
+        // other project's entry. The corrupt bytes can't be recovered, but we
+        // preserve them for forensics and warn loudly instead of dropping them
+        // without a trace.
+        const backup = `${registryPath}.corrupt-${Date.now()}`;
+        try {
+            renameSync(registryPath, backup);
+            process.stderr.write(`[gsd-mcp-server] MCP registry ${registryPath} was corrupt (${err instanceof Error ? err.message : String(err)}); preserved as ${backup}\n`);
+        }
+        catch {
+            process.stderr.write(`[gsd-mcp-server] MCP registry ${registryPath} was corrupt (${err instanceof Error ? err.message : String(err)}) and could not be preserved\n`);
+        }
+        return {};
+    }
+}
+function writeMcpRegistry(registry, registryPath = REGISTRY_PATH) {
+    mkdirSync(dirname(registryPath), { recursive: true });
+    writeFileSync(registryPath, JSON.stringify(registry, null, 2), 'utf8');
+}
+function defaultGetProcessCommand(pid) {
+    try {
+        if (process.platform === 'win32') {
+            // `ps` does not exist on Windows; query the process command line via CIM
+            // so stale same-project cleanup is not silently disabled there.
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CommandLine`,
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            return out || null;
+        }
+        const command = execFileSync('ps', ['-p', String(pid), '-o', 'command='], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        }).trim();
+        return command || null;
+    }
+    catch {
+        return null;
+    }
+}
+function defaultGetProcessStartTime(pid) {
+    try {
+        if (process.platform === 'win32') {
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `$p = Get-CimInstance Win32_Process -Filter "ProcessId=${pid}"; if ($p) { [int64](($p.CreationDate.ToUniversalTime() - [datetime]'1970-01-01T00:00:00Z').TotalMilliseconds) }`,
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            const ms = Number(out);
+            return Number.isFinite(ms) && ms > 0 ? ms : null;
+        }
+        // `lstart` is supported by both Linux (procps) and macOS (BSD) ps. Force
+        // the C locale so the timestamp is parseable regardless of the user's LANG.
+        const lstart = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        }).trim();
+        if (!lstart)
+            return null;
+        const ms = new Date(lstart).getTime();
+        return Number.isFinite(ms) ? ms : null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeProcessCwd(value) {
+    return value.startsWith('\\\\?\\') ? value.slice(4) : value;
+}
+function defaultGetProcessCwd(pid) {
+    if (process.platform === 'win32') {
+        try {
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `$pid=${pid};$t=@'
+using System;using System.Runtime.InteropServices;using System.Text;
+public static class GsdProcCwd{
+ [DllImport("kernel32.dll")] public static extern IntPtr OpenProcess(int a,bool b,int p);
+ [DllImport("kernel32.dll")] public static extern bool CloseHandle(IntPtr h);
+ [DllImport("kernel32.dll")] public static extern bool ReadProcessMemory(IntPtr h,IntPtr a,byte[] b,int l,out int r);
+ [DllImport("ntdll.dll")] public static extern int NtQueryInformationProcess(IntPtr h,int c,byte[] i,int l,out int o);
+ public static string G(int pid){
+  IntPtr h=OpenProcess(0x1010,false,pid);if(h==IntPtr.Zero)return null;
+  try{bool x=IntPtr.Size==8;int n=IntPtr.Size*6;byte[] pbi=new byte[n];int o;
+  if(NtQueryInformationProcess(h,0,pbi,n,out o)!=0)return null;
+  IntPtr peb=x?(IntPtr)BitConverter.ToInt64(pbi,IntPtr.Size):(IntPtr)BitConverter.ToInt32(pbi,4);
+  byte[] ptr=new byte[IntPtr.Size];int rd;
+  if(!ReadProcessMemory(h,IntPtr.Add(peb,x?0x20:0x10),ptr,ptr.Length,out rd))return null;
+  IntPtr pp=x?(IntPtr)BitConverter.ToInt64(ptr,0):(IntPtr)BitConverter.ToInt32(ptr,0);
+  byte[] us=new byte[16];
+  if(!ReadProcessMemory(h,IntPtr.Add(pp,x?0x38:0x24),us,us.Length,out rd))return null;
+  int len=BitConverter.ToUInt16(us,0);if(len<=0||len>32766)return null;
+  IntPtr buf=x?(IntPtr)BitConverter.ToInt64(us,8):(IntPtr)BitConverter.ToInt32(us,4);
+  byte[] ch=new byte[len];
+  if(!ReadProcessMemory(h,buf,ch,ch.Length,out rd))return null;
+  return Encoding.Unicode.GetString(ch,0,len);}finally{CloseHandle(h);}}
+}
+'@;Add-Type -TypeDefinition $t -ErrorAction Stop;[GsdProcCwd]::G($pid)`,
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            if (!out)
+                return null;
+            return normalizeProcessCwd(out);
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        const out = execFileSync('lsof', ['-a', '-p', String(pid), '-d', 'cwd', '-Fn'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        });
+        const cwd = out.split('\n').find((line) => line.startsWith('n'))?.slice(1).trim();
+        if (cwd)
+            return cwd;
+    }
+    catch {
+    }
+    try {
+        const out = execFileSync('pwdx', [String(pid)], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        }).trim();
+        const match = /^\d+:\s+(.+)$/.exec(out);
+        return match?.[1]?.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function isSafePid(pid) {
+    return typeof pid === 'number' && Number.isSafeInteger(pid) && pid > 1;
+}
+function isMcpServerCommand(command) {
+    if (!command)
+        return false;
+    const normalized = command.replace(/\\/g, '/');
+    return (command.includes('gsd-mcp-server') ||
+        command.includes('@opengsd/mcp-server') ||
+        normalized.includes('/packages/mcp-server/'));
+}
+function defaultListProcesses() {
+    if (process.platform === 'win32') {
+        try {
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                'Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,CommandLine | ConvertTo-Json -Compress',
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            if (!out)
+                return [];
+            const parsed = JSON.parse(out);
+            const rows = Array.isArray(parsed) ? parsed : [parsed];
+            return rows.flatMap((row) => {
+                if (!row || typeof row !== 'object')
+                    return [];
+                const record = row;
+                const pid = Number(record.ProcessId);
+                const ppid = Number(record.ParentProcessId);
+                const command = typeof record.CommandLine === 'string' ? record.CommandLine : '';
+                if (!Number.isSafeInteger(pid) || !Number.isSafeInteger(ppid))
+                    return [];
+                return [{ pid, ppid, command }];
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    try {
+        const out = execFileSync('ps', ['-axo', 'pid=,ppid=,command='], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        });
+        return out.split('\n').flatMap((line) => {
+            const match = /^\s*(\d+)\s+(\d+)\s+(.+)$/.exec(line);
+            if (!match)
+                return [];
+            return [{
+                    pid: Number(match[1]),
+                    ppid: Number(match[2]),
+                    command: match[3],
+                }];
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function defaultWaitForExit() {
+    const shared = new Int32Array(new SharedArrayBuffer(4));
+    Atomics.wait(shared, 0, 0, 250);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function normalizeCommandPath(value) {
+    return value.replace(/\\/g, '/');
+}
+function resolveComparableProjectPath(projectDir) {
+    if (/^[A-Za-z]:[\\/]/.test(projectDir) ||
+        projectDir.startsWith('\\\\') ||
+        projectDir.startsWith('/')) {
+        // Already an absolute path (Windows drive-letter, UNC, or POSIX). Do NOT
+        // call path.resolve(), which would prepend the current drive letter on
+        // Windows and turn a POSIX path like /workspace/project into
+        // C:/workspace/project, breaking command-path matching when the process
+        // command still contains the raw POSIX prefix.
+        return normalizeCommandPath(projectDir);
+    }
+    return normalizeCommandPath(resolve(projectDir));
+}
+function projectRegistryKeys(projectDir) {
+    return [...new Set([
+            resolveComparableProjectPath(projectDir),
+            resolve(projectDir),
+            projectDir,
+        ])];
+}
+function commandContainsProjectPath(command, projectDir) {
+    const normalizedProject = resolveComparableProjectPath(projectDir);
+    const normalizedCommand = normalizeCommandPath(command);
+    const pattern = new RegExp(`(^|[\\s"'])${escapeRegExp(normalizedProject)}(?=$|[/\\s"'])`);
+    return pattern.test(normalizedCommand);
+}
+function isSameProjectMcpProcess(command, cwd, projectDir) {
+    if (!isMcpServerCommand(command))
+        return false;
+    if (cwd && resolveComparableProjectPath(normalizeProcessCwd(cwd)) === resolveComparableProjectPath(projectDir))
+        return true;
+    return commandContainsProjectPath(command, projectDir);
+}
+function isPidAlive(pid, sendSignal) {
+    try {
+        sendSignal(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !(error instanceof Error &&
+            'code' in error &&
+            error.code === 'ESRCH');
+    }
+}
+function isOrphanedMcpProcess(proc, sendSignal) {
+    if (process.platform === 'win32') {
+        // Windows does not reparent orphans to PID 1; the PPID usually still
+        // points at the dead parent, so treat a missing parent as orphaned.
+        if (!isSafePid(proc.ppid))
+            return false;
+        return !isPidAlive(proc.ppid, sendSignal);
+    }
+    return proc.ppid === 1;
+}
+export function sweepProjectOrphanMcpServers(projectDir, options = {}) {
+    const sendSignal = options.kill ?? ((targetPid, signal) => process.kill(targetPid, signal));
+    const getProcessCwd = options.getProcessCwd ?? defaultGetProcessCwd;
+    const listProcesses = options.listProcesses ?? defaultListProcesses;
+    const isOrphaned = options.isOrphaned ?? ((proc) => isOrphanedMcpProcess(proc, sendSignal));
+    const waitForExit = options.waitForExit ?? defaultWaitForExit;
+    const result = {
+        matched: [],
+        terminated: [],
+        forceKilled: [],
+        skipped: [],
+    };
+    for (const proc of listProcesses()) {
+        if (!isSafePid(proc.pid) || proc.pid === process.pid)
+            continue;
+        if (!isOrphaned(proc))
+            continue;
+        if (!isMcpServerCommand(proc.command))
+            continue;
+        const cwd = commandContainsProjectPath(proc.command, projectDir) ? null : getProcessCwd(proc.pid);
+        if (!isSameProjectMcpProcess(proc.command, cwd, projectDir))
+            continue;
+        result.matched.push(proc.pid);
+        if (!isPidAlive(proc.pid, sendSignal)) {
+            result.skipped.push(proc.pid);
+            continue;
+        }
+        try {
+            sendSignal(proc.pid, 'SIGTERM');
+            result.terminated.push(proc.pid);
+        }
+        catch {
+            result.skipped.push(proc.pid);
+        }
+    }
+    if (result.terminated.length > 0)
+        waitForExit();
+    for (const pid of result.terminated) {
+        if (!isPidAlive(pid, sendSignal))
+            continue;
+        try {
+            sendSignal(pid, 'SIGKILL');
+            result.forceKilled.push(pid);
+        }
+        catch {
+            result.skipped.push(pid);
+        }
+    }
+    return result;
+}
+function killPid(pid, projectDir, startedAt, options = {}) {
+    if (!isSafePid(pid))
+        return 'invalid';
+    const sendSignal = options.kill ?? ((targetPid, signal) => process.kill(targetPid, signal));
+    const getProcessCommand = options.getProcessCommand ?? defaultGetProcessCommand;
+    const getProcessCwd = options.getProcessCwd ?? defaultGetProcessCwd;
+    const getProcessStartTime = options.getProcessStartTime ?? defaultGetProcessStartTime;
+    const waitForExit = options.waitForExit ?? defaultWaitForExit;
+    try {
+        sendSignal(pid, 0);
+    }
+    catch (error) {
+        const isAlreadyDead = error instanceof Error && 'code' in error && error.code === 'ESRCH';
+        if (isAlreadyDead)
+            return 'already-dead';
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+    const command = getProcessCommand(pid);
+    if (!command || !isMcpServerCommand(command))
+        return 'unverified';
+    const cwd = getProcessCwd(pid);
+    const recordedMs = startedAt ? Date.parse(startedAt) : NaN;
+    const actualStartMs = getProcessStartTime(pid);
+    // Guard against PID reuse: a recycled PID can belong to a *different* live
+    // MCP server (even for another project). If we can determine when the live
+    // process actually started and it began materially after we recorded this
+    // entry, the original server is gone and this PID is not ours — refuse to
+    // signal it.
+    if (Number.isFinite(recordedMs) &&
+        actualStartMs !== null &&
+        actualStartMs > recordedMs + STALE_PID_START_SKEW_MS) {
+        return 'unverified';
+    }
+    // Confirm the live MCP server is the one we registered for this project via
+    // the process cwd or an embedded project path. Start time alone is not enough
+    // to authorize a signal when cwd is unavailable — another project's global
+    // install can share the same command line and a coincidentally aligned start.
+    const sameProject = isSameProjectMcpProcess(command, cwd, projectDir);
+    if (!sameProject)
+        return 'unverified';
+    try {
+        sendSignal(pid, 'SIGTERM');
+        waitForExit();
+        if (!isPidAlive(pid, sendSignal))
+            return 'killed';
+        sendSignal(pid, 'SIGKILL');
+        return 'force-killed';
+    }
+    catch (error) {
+        const isAlreadyDead = error instanceof Error && 'code' in error && error.code === 'ESRCH';
+        if (isAlreadyDead)
+            return 'already-dead';
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Kill any existing MCP server for this project, then register our PID.
+ */
+export function registerMcpInstance(projectDir, registryPath = REGISTRY_PATH, options = {}) {
+    const registry = readMcpRegistry(registryPath);
+    const keys = projectRegistryKeys(projectDir);
+    const key = keys[0];
+    const existingKey = keys.find((candidate) => candidate in registry);
+    const existing = existingKey ? registry[existingKey] : undefined;
+    if (existing && existing.pid !== process.pid) {
+        const result = killPid(existing.pid, key, existing.startedAt, options);
+        const label = result === 'killed'
+            ? `killed stale pid=${existing.pid}`
+            : result === 'force-killed'
+                ? `force-killed stale pid=${existing.pid}`
+                : result === 'already-dead'
+                    ? `stale pid=${existing.pid} already dead`
+                    : result === 'invalid'
+                        ? `ignored invalid stale pid=${String(existing.pid)}`
+                        : result === 'unverified'
+                            ? `ignored unverified stale pid=${existing.pid}`
+                            : `failed to kill pid=${existing.pid}: ${result.error}`;
+        process.stderr.write(`[gsd-mcp-server] ${label} for ${key}\n`);
+        if (result === 'unverified')
+            return false;
+    }
+    if (existingKey && existingKey !== key)
+        delete registry[existingKey];
+    registry[key] = {
+        pid: process.pid,
+        projectDir: key,
+        startedAt: new Date().toISOString(),
+    };
+    writeMcpRegistry(registry, registryPath);
+    return true;
+}
+/**
+ * Remove our PID from the registry on shutdown.
+ */
+export function unregisterMcpInstance(projectDir, registryPath = REGISTRY_PATH) {
+    const keys = projectRegistryKeys(projectDir);
+    const registry = readMcpRegistry(registryPath);
+    let changed = false;
+    for (const key of keys) {
+        if (registry[key]?.pid === process.pid) {
+            delete registry[key];
+            changed = true;
+        }
+    }
+    if (changed) {
+        writeMcpRegistry(registry, registryPath);
+    }
+}
+//# sourceMappingURL=pid-registry.js.map

package/packages/mcp-server/dist/pid-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-registry.js","sourceRoot":"","sources":["../src/pid-registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP server PID registry — tracks running instances per project so new\n * launches can kill stale ones. Mirrors web-mode's web-instances.json pattern.\n */\n\nimport { execFileSync } from 'node:child_process';\nimport { readFileSync, writeFileSync, mkdirSync, renameSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { dirname, join, resolve } from 'node:path';\n\nexport interface McpInstanceEntry {\n  pid: number;\n  projectDir: string;\n  startedAt: string;\n}\n\nexport type McpInstanceRegistry = Record<string, McpInstanceEntry>;\n\nexport interface RegisterMcpInstanceOptions {\n  kill?: (pid: number, signal?: NodeJS.Signals | 0) => void;\n  getProcessCommand?: (pid: number) => string | null;\n  getProcessCwd?: (pid: number) => string | null;\n  getProcessStartTime?: (pid: number) => number | null;\n  waitForExit?: () => void;\n}\n\nexport interface McpProcessSnapshot {\n  pid: number;\n  ppid: number;\n  command: string;\n}\n\nexport interface SweepProjectOrphanMcpServersOptions {\n  kill?: (pid: number, signal?: NodeJS.Signals | 0) => void;\n  getProcessCwd?: (pid: number) => string | null;\n  listProcesses?: () => McpProcessSnapshot[];\n  isOrphaned?: (proc: McpProcessSnapshot) => boolean;\n  waitForExit?: () => void;\n}\n\nexport interface SweepProjectOrphanMcpServersResult {\n  matched: number[];\n  terminated: number[];\n  forceKilled: number[];\n  skipped: number[];\n}\n\nconst REGISTRY_PATH = join(\n  process.env.GSD_HOME || join(homedir(), '.gsd'),\n  'mcp-instances.json',\n);\n\n// A live PID is only treated as \"our\" stale server if its OS start time is no\n// later than the moment we recorded the registry entry (plus a small skew for\n// clock granularity / start-vs-register delay). A PID that started materially\n// later has been recycled by a different process and must not be signalled.\nconst STALE_PID_START_SKEW_MS = 60_000;\n\nexport function readMcpRegistry(registryPath = REGISTRY_PATH): McpInstanceRegistry {\n  let raw: string;\n  try {\n    raw = readFileSync(registryPath, 'utf8');\n  } catch (err) {\n    // A missing file is the normal first-run case — start with an empty\n    // registry silently. Any other read error is worth surfacing.\n    if ((err as NodeJS.ErrnoException).code !== 'ENOENT') {\n      process.stderr.write(\n        `[gsd-mcp-server] failed to read MCP registry ${registryPath}: ${err instanceof Error ? err.message : String(err)}\\n`,\n      );\n    }\n    return {};\n  }\n\n  try {\n    const parsed = JSON.parse(raw) as unknown;\n    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      return parsed as McpInstanceRegistry;\n    }\n    throw new Error('registry is not a JSON object');\n  } catch (err) {\n    // The file exists but is unparseable. Returning {} here means the next\n    // registerMcpInstance would overwrite the file and silently drop every\n    // other project's entry. The corrupt bytes can't be recovered, but we\n    // preserve them for forensics and warn loudly instead of dropping them\n    // without a trace.\n    const backup = `${registryPath}.corrupt-${Date.now()}`;\n    try {\n      renameSync(registryPath, backup);\n      process.stderr.write(\n        `[gsd-mcp-server] MCP registry ${registryPath} was corrupt (${err instanceof Error ? err.message : String(err)}); preserved as ${backup}\\n`,\n      );\n    } catch {\n      process.stderr.write(\n        `[gsd-mcp-server] MCP registry ${registryPath} was corrupt (${err instanceof Error ? err.message : String(err)}) and could not be preserved\\n`,\n      );\n    }\n    return {};\n  }\n}\n\nfunction writeMcpRegistry(registry: McpInstanceRegistry, registryPath = REGISTRY_PATH): void {\n  mkdirSync(dirname(registryPath), { recursive: true });\n  writeFileSync(registryPath, JSON.stringify(registry, null, 2), 'utf8');\n}\n\nfunction defaultGetProcessCommand(pid: number): string | null {\n  try {\n    if (process.platform === 'win32') {\n      // `ps` does not exist on Windows; query the process command line via CIM\n      // so stale same-project cleanup is not silently disabled there.\n      const out = execFileSync(\n        'powershell.exe',\n        [\n          '-NoProfile',\n          '-NonInteractive',\n          '-Command',\n          `(Get-CimInstance Win32_Process -Filter \"ProcessId=${pid}\").CommandLine`,\n        ],\n        { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] },\n      ).trim();\n      return out || null;\n    }\n    const command = execFileSync('ps', ['-p', String(pid), '-o', 'command='], {\n      encoding: 'utf8',\n      stdio: ['ignore', 'pipe', 'ignore'],\n      env: { ...process.env, LC_ALL: 'C' },\n    }).trim();\n    return command || null;\n  } catch {\n    return null;\n  }\n}\n\nfunction defaultGetProcessStartTime(pid: number): number | null {\n  try {\n    if (process.platform === 'win32') {\n      const out = execFileSync(\n        'powershell.exe',\n        [\n          '-NoProfile',\n          '-NonInteractive',\n          '-Command',\n          `$p = Get-CimInstance Win32_Process -Filter \"ProcessId=${pid}\"; if ($p) { [int64](($p.CreationDate.ToUniversalTime() - [datetime]'1970-01-01T00:00:00Z').TotalMilliseconds) }`,\n        ],\n        { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] },\n      ).trim();\n      const ms = Number(out);\n      return Number.isFinite(ms) && ms > 0 ? ms : null;\n    }\n    // `lstart` is supported by both Linux (procps) and macOS (BSD) ps. Force\n    // the C locale so the timestamp is parseable regardless of the user's LANG.\n    const lstart = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {\n      encoding: 'utf8',\n      stdio: ['ignore', 'pipe', 'ignore'],\n      env: { ...process.env, LC_ALL: 'C' },\n    }).trim();\n    if (!lstart) return null;\n    const ms = new Date(lstart).getTime();\n    return Number.isFinite(ms) ? ms : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction normalizeProcessCwd(value: string): string {\n  return value.startsWith('\\\\\\\\?\\\\') ? value.slice(4) : value;\n}\n\nfunction defaultGetProcessCwd(pid: number): string | null {\n  if (process.platform === 'win32') {\n    try {\n      const out = execFileSync(\n        'powershell.exe',\n        [\n          '-NoProfile',\n          '-NonInteractive',\n          '-Command',\n          `$pid=${pid};$t=@'\nusing System;using System.Runtime.InteropServices;using System.Text;\npublic static class GsdProcCwd{\n [DllImport(\"kernel32.dll\")] public static extern IntPtr OpenProcess(int a,bool b,int p);\n [DllImport(\"kernel32.dll\")] public static extern bool CloseHandle(IntPtr h);\n [DllImport(\"kernel32.dll\")] public static extern bool ReadProcessMemory(IntPtr h,IntPtr a,byte[] b,int l,out int r);\n [DllImport(\"ntdll.dll\")] public static extern int NtQueryInformationProcess(IntPtr h,int c,byte[] i,int l,out int o);\n public static string G(int pid){\n  IntPtr h=OpenProcess(0x1010,false,pid);if(h==IntPtr.Zero)return null;\n  try{bool x=IntPtr.Size==8;int n=IntPtr.Size*6;byte[] pbi=new byte[n];int o;\n  if(NtQueryInformationProcess(h,0,pbi,n,out o)!=0)return null;\n  IntPtr peb=x?(IntPtr)BitConverter.ToInt64(pbi,IntPtr.Size):(IntPtr)BitConverter.ToInt32(pbi,4);\n  byte[] ptr=new byte[IntPtr.Size];int rd;\n  if(!ReadProcessMemory(h,IntPtr.Add(peb,x?0x20:0x10),ptr,ptr.Length,out rd))return null;\n  IntPtr pp=x?(IntPtr)BitConverter.ToInt64(ptr,0):(IntPtr)BitConverter.ToInt32(ptr,0);\n  byte[] us=new byte[16];\n  if(!ReadProcessMemory(h,IntPtr.Add(pp,x?0x38:0x24),us,us.Length,out rd))return null;\n  int len=BitConverter.ToUInt16(us,0);if(len<=0||len>32766)return null;\n  IntPtr buf=x?(IntPtr)BitConverter.ToInt64(us,8):(IntPtr)BitConverter.ToInt32(us,4);\n  byte[] ch=new byte[len];\n  if(!ReadProcessMemory(h,buf,ch,ch.Length,out rd))return null;\n  return Encoding.Unicode.GetString(ch,0,len);}finally{CloseHandle(h);}}\n}\n'@;Add-Type -TypeDefinition $t -ErrorAction Stop;[GsdProcCwd]::G($pid)`,\n        ],\n        { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] },\n      ).trim();\n      if (!out) return null;\n      return normalizeProcessCwd(out);\n    } catch {\n      return null;\n    }\n  }\n\n  try {\n    const out = execFileSync('lsof', ['-a', '-p', String(pid), '-d', 'cwd', '-Fn'], {\n      encoding: 'utf8',\n      stdio: ['ignore', 'pipe', 'ignore'],\n      env: { ...process.env, LC_ALL: 'C' },\n    });\n    const cwd = out.split('\\n').find((line) => line.startsWith('n'))?.slice(1).trim();\n    if (cwd) return cwd;\n  } catch {\n  }\n\n  try {\n    const out = execFileSync('pwdx', [String(pid)], {\n      encoding: 'utf8',\n      stdio: ['ignore', 'pipe', 'ignore'],\n      env: { ...process.env, LC_ALL: 'C' },\n    }).trim();\n    const match = /^\\d+:\\s+(.+)$/.exec(out);\n    return match?.[1]?.trim() || null;\n  } catch {\n    return null;\n  }\n}\n\nfunction isSafePid(pid: unknown): pid is number {\n  return typeof pid === 'number' && Number.isSafeInteger(pid) && pid > 1;\n}\n\nfunction isMcpServerCommand(command: string | null): boolean {\n  if (!command) return false;\n  const normalized = command.replace(/\\\\/g, '/');\n  return (\n    command.includes('gsd-mcp-server') ||\n    command.includes('@opengsd/mcp-server') ||\n    normalized.includes('/packages/mcp-server/')\n  );\n}\n\nfunction defaultListProcesses(): McpProcessSnapshot[] {\n  if (process.platform === 'win32') {\n    try {\n      const out = execFileSync(\n        'powershell.exe',\n        [\n          '-NoProfile',\n          '-NonInteractive',\n          '-Command',\n          'Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,CommandLine | ConvertTo-Json -Compress',\n        ],\n        { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] },\n      ).trim();\n      if (!out) return [];\n      const parsed = JSON.parse(out) as unknown;\n      const rows = Array.isArray(parsed) ? parsed : [parsed];\n      return rows.flatMap((row) => {\n        if (!row || typeof row !== 'object') return [];\n        const record = row as Record<string, unknown>;\n        const pid = Number(record.ProcessId);\n        const ppid = Number(record.ParentProcessId);\n        const command = typeof record.CommandLine === 'string' ? record.CommandLine : '';\n        if (!Number.isSafeInteger(pid) || !Number.isSafeInteger(ppid)) return [];\n        return [{ pid, ppid, command }];\n      });\n    } catch {\n      return [];\n    }\n  }\n\n  try {\n    const out = execFileSync('ps', ['-axo', 'pid=,ppid=,command='], {\n      encoding: 'utf8',\n      stdio: ['ignore', 'pipe', 'ignore'],\n      env: { ...process.env, LC_ALL: 'C' },\n    });\n    return out.split('\\n').flatMap((line) => {\n      const match = /^\\s*(\\d+)\\s+(\\d+)\\s+(.+)$/.exec(line);\n      if (!match) return [];\n      return [{\n        pid: Number(match[1]),\n        ppid: Number(match[2]),\n        command: match[3],\n      }];\n    });\n  } catch {\n    return [];\n  }\n}\n\nfunction defaultWaitForExit(): void {\n  const shared = new Int32Array(new SharedArrayBuffer(4));\n  Atomics.wait(shared, 0, 0, 250);\n}\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\nfunction normalizeCommandPath(value: string): string {\n  return value.replace(/\\\\/g, '/');\n}\n\nfunction resolveComparableProjectPath(projectDir: string): string {\n  if (\n    /^[A-Za-z]:[\\\\/]/.test(projectDir) ||\n    projectDir.startsWith('\\\\\\\\') ||\n    projectDir.startsWith('/')\n  ) {\n    // Already an absolute path (Windows drive-letter, UNC, or POSIX). Do NOT\n    // call path.resolve(), which would prepend the current drive letter on\n    // Windows and turn a POSIX path like /workspace/project into\n    // C:/workspace/project, breaking command-path matching when the process\n    // command still contains the raw POSIX prefix.\n    return normalizeCommandPath(projectDir);\n  }\n  return normalizeCommandPath(resolve(projectDir));\n}\n\nfunction projectRegistryKeys(projectDir: string): string[] {\n  return [...new Set([\n    resolveComparableProjectPath(projectDir),\n    resolve(projectDir),\n    projectDir,\n  ])];\n}\n\nfunction commandContainsProjectPath(command: string, projectDir: string): boolean {\n  const normalizedProject = resolveComparableProjectPath(projectDir);\n  const normalizedCommand = normalizeCommandPath(command);\n  const pattern = new RegExp(`(^|[\\\\s\"'])${escapeRegExp(normalizedProject)}(?=$|[/\\\\s\"'])`);\n  return pattern.test(normalizedCommand);\n}\n\nfunction isSameProjectMcpProcess(command: string, cwd: string | null, projectDir: string): boolean {\n  if (!isMcpServerCommand(command)) return false;\n  if (cwd && resolveComparableProjectPath(normalizeProcessCwd(cwd)) === resolveComparableProjectPath(projectDir)) return true;\n  return commandContainsProjectPath(command, projectDir);\n}\n\nfunction isPidAlive(\n  pid: number,\n  sendSignal: (pid: number, signal?: NodeJS.Signals | 0) => void,\n): boolean {\n  try {\n    sendSignal(pid, 0);\n    return true;\n  } catch (error) {\n    return !(\n      error instanceof Error &&\n      'code' in error &&\n      (error as NodeJS.ErrnoException).code === 'ESRCH'\n    );\n  }\n}\n\nfunction isOrphanedMcpProcess(\n  proc: McpProcessSnapshot,\n  sendSignal: (pid: number, signal?: NodeJS.Signals | 0) => void,\n): boolean {\n  if (process.platform === 'win32') {\n    // Windows does not reparent orphans to PID 1; the PPID usually still\n    // points at the dead parent, so treat a missing parent as orphaned.\n    if (!isSafePid(proc.ppid)) return false;\n    return !isPidAlive(proc.ppid, sendSignal);\n  }\n  return proc.ppid === 1;\n}\n\nexport function sweepProjectOrphanMcpServers(\n  projectDir: string,\n  options: SweepProjectOrphanMcpServersOptions = {},\n): SweepProjectOrphanMcpServersResult {\n  const sendSignal = options.kill ?? ((targetPid, signal) => process.kill(targetPid, signal));\n  const getProcessCwd = options.getProcessCwd ?? defaultGetProcessCwd;\n  const listProcesses = options.listProcesses ?? defaultListProcesses;\n  const isOrphaned = options.isOrphaned ?? ((proc: McpProcessSnapshot) => isOrphanedMcpProcess(proc, sendSignal));\n  const waitForExit = options.waitForExit ?? defaultWaitForExit;\n\n  const result: SweepProjectOrphanMcpServersResult = {\n    matched: [],\n    terminated: [],\n    forceKilled: [],\n    skipped: [],\n  };\n\n  for (const proc of listProcesses()) {\n    if (!isSafePid(proc.pid) || proc.pid === process.pid) continue;\n    if (!isOrphaned(proc)) continue;\n    if (!isMcpServerCommand(proc.command)) continue;\n    const cwd = commandContainsProjectPath(proc.command, projectDir) ? null : getProcessCwd(proc.pid);\n    if (!isSameProjectMcpProcess(proc.command, cwd, projectDir)) continue;\n    result.matched.push(proc.pid);\n\n    if (!isPidAlive(proc.pid, sendSignal)) {\n      result.skipped.push(proc.pid);\n      continue;\n    }\n\n    try {\n      sendSignal(proc.pid, 'SIGTERM');\n      result.terminated.push(proc.pid);\n    } catch {\n      result.skipped.push(proc.pid);\n    }\n  }\n\n  if (result.terminated.length > 0) waitForExit();\n\n  for (const pid of result.terminated) {\n    if (!isPidAlive(pid, sendSignal)) continue;\n    try {\n      sendSignal(pid, 'SIGKILL');\n      result.forceKilled.push(pid);\n    } catch {\n      result.skipped.push(pid);\n    }\n  }\n\n  return result;\n}\n\nfunction killPid(\n  pid: unknown,\n  projectDir: string,\n  startedAt: string | undefined,\n  options: RegisterMcpInstanceOptions = {},\n): 'killed' | 'force-killed' | 'already-dead' | 'invalid' | 'unverified' | { error: string } {\n  if (!isSafePid(pid)) return 'invalid';\n\n  const sendSignal = options.kill ?? ((targetPid, signal) => process.kill(targetPid, signal));\n  const getProcessCommand = options.getProcessCommand ?? defaultGetProcessCommand;\n  const getProcessCwd = options.getProcessCwd ?? defaultGetProcessCwd;\n  const getProcessStartTime = options.getProcessStartTime ?? defaultGetProcessStartTime;\n  const waitForExit = options.waitForExit ?? defaultWaitForExit;\n\n  try {\n    sendSignal(pid, 0);\n  } catch (error) {\n    const isAlreadyDead =\n      error instanceof Error && 'code' in error && (error as NodeJS.ErrnoException).code === 'ESRCH';\n    if (isAlreadyDead) return 'already-dead';\n    return { error: error instanceof Error ? error.message : String(error) };\n  }\n\n  const command = getProcessCommand(pid);\n  if (!command || !isMcpServerCommand(command)) return 'unverified';\n\n  const cwd = getProcessCwd(pid);\n  const recordedMs = startedAt ? Date.parse(startedAt) : NaN;\n  const actualStartMs = getProcessStartTime(pid);\n\n  // Guard against PID reuse: a recycled PID can belong to a *different* live\n  // MCP server (even for another project). If we can determine when the live\n  // process actually started and it began materially after we recorded this\n  // entry, the original server is gone and this PID is not ours — refuse to\n  // signal it.\n  if (\n    Number.isFinite(recordedMs) &&\n    actualStartMs !== null &&\n    actualStartMs > recordedMs + STALE_PID_START_SKEW_MS\n  ) {\n    return 'unverified';\n  }\n\n  // Confirm the live MCP server is the one we registered for this project via\n  // the process cwd or an embedded project path. Start time alone is not enough\n  // to authorize a signal when cwd is unavailable — another project's global\n  // install can share the same command line and a coincidentally aligned start.\n  const sameProject = isSameProjectMcpProcess(command, cwd, projectDir);\n  if (!sameProject) return 'unverified';\n\n  try {\n    sendSignal(pid, 'SIGTERM');\n    waitForExit();\n    if (!isPidAlive(pid, sendSignal)) return 'killed';\n    sendSignal(pid, 'SIGKILL');\n    return 'force-killed';\n  } catch (error) {\n    const isAlreadyDead =\n      error instanceof Error && 'code' in error && (error as NodeJS.ErrnoException).code === 'ESRCH';\n    if (isAlreadyDead) return 'already-dead';\n    return { error: error instanceof Error ? error.message : String(error) };\n  }\n}\n\n/**\n * Kill any existing MCP server for this project, then register our PID.\n */\nexport function registerMcpInstance(\n  projectDir: string,\n  registryPath = REGISTRY_PATH,\n  options: RegisterMcpInstanceOptions = {},\n): boolean {\n  const registry = readMcpRegistry(registryPath);\n  const keys = projectRegistryKeys(projectDir);\n  const key = keys[0];\n  const existingKey = keys.find((candidate) => candidate in registry);\n\n  const existing = existingKey ? registry[existingKey] : undefined;\n  if (existing && existing.pid !== process.pid) {\n    const result = killPid(existing.pid, key, existing.startedAt, options);\n    const label = result === 'killed'\n      ? `killed stale pid=${existing.pid}`\n      : result === 'force-killed'\n        ? `force-killed stale pid=${existing.pid}`\n      : result === 'already-dead'\n        ? `stale pid=${existing.pid} already dead`\n        : result === 'invalid'\n          ? `ignored invalid stale pid=${String(existing.pid)}`\n          : result === 'unverified'\n            ? `ignored unverified stale pid=${existing.pid}`\n            : `failed to kill pid=${existing.pid}: ${result.error}`;\n    process.stderr.write(`[gsd-mcp-server] ${label} for ${key}\\n`);\n    if (result === 'unverified') return false;\n  }\n  if (existingKey && existingKey !== key) delete registry[existingKey];\n\n  registry[key] = {\n    pid: process.pid,\n    projectDir: key,\n    startedAt: new Date().toISOString(),\n  };\n  writeMcpRegistry(registry, registryPath);\n  return true;\n}\n\n/**\n * Remove our PID from the registry on shutdown.\n */\nexport function unregisterMcpInstance(projectDir: string, registryPath = REGISTRY_PATH): void {\n  const keys = projectRegistryKeys(projectDir);\n  const registry = readMcpRegistry(registryPath);\n  let changed = false;\n  for (const key of keys) {\n    if (registry[key]?.pid === process.pid) {\n      delete registry[key];\n      changed = true;\n    }\n  }\n  if (changed) {\n    writeMcpRegistry(registry, registryPath);\n  }\n}\n"]}

package/packages/mcp-server/dist/probe-mode.d.ts

@@ -0,0 +1,4 @@
+/** When set, stdio MCP is a short-lived tools/list probe — skip PID registry side effects. */
+export declare const GSD_MCP_PROBE_ENV = "GSD_MCP_PROBE";
+export declare function isMcpProbeSession(env?: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=probe-mode.d.ts.map

package/packages/mcp-server/dist/probe-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-mode.d.ts","sourceRoot":"","sources":["../src/probe-mode.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAK/E"}

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

@@ -0,0 +1,10 @@
+/** When set, stdio MCP is a short-lived tools/list probe — skip PID registry side effects. */
+export const GSD_MCP_PROBE_ENV = 'GSD_MCP_PROBE';
+export function isMcpProbeSession(env = process.env) {
+    const value = env[GSD_MCP_PROBE_ENV];
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes';
+}
+//# sourceMappingURL=probe-mode.js.map

package/packages/mcp-server/dist/probe-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-mode.js","sourceRoot":"","sources":["../src/probe-mode.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,MAAM,KAAK,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,CAAC;AAC7E,CAAC","sourcesContent":["/** When set, stdio MCP is a short-lived tools/list probe — skip PID registry side effects. */\nexport const GSD_MCP_PROBE_ENV = 'GSD_MCP_PROBE';\n\nexport function isMcpProbeSession(env: NodeJS.ProcessEnv = process.env): boolean {\n  const value = env[GSD_MCP_PROBE_ENV];\n  if (!value) return false;\n  const normalized = value.trim().toLowerCase();\n  return normalized === '1' || normalized === 'true' || normalized === 'yes';\n}\n"]}