context-mode 1.0.169 → 2.0.0-next.5

package/build/util/sibling-mcp.d.ts

@@ -1,79 +0,0 @@
-/**
- * sibling-mcp — discover & terminate previous-version MCP servers.
- *
- * Issue #559: `/ctx-upgrade` historically left the running MCP server
- * alive after copying new files in-place + updating npm global. The next
- * Claude Code launch spawned a fresh process from the new version, but
- * the old one kept its open stdio + DB handles. Across enough upgrades
- * users observed 5+ context-mode `start.mjs` processes pinned to RAM.
- *
- * This module provides two pure helpers:
- *
- *   1. `discoverSiblingMcpPids({ ownPid, ownPpid, platform, runCommand })`
- *      — enumerates node processes whose argv mentions the plugin
- *      `start.mjs` path under `~/.claude/plugins/{cache,marketplaces}/`.
- *      Excludes the caller's own pid + parent pid (Claude Code or the
- *      shell that spawned `/ctx-upgrade`). Cross-platform: POSIX uses
- *      `pgrep -f`, Windows uses PowerShell + Get-CimInstance.
- *
- *   2. `killSiblingMcpServers({ pids, ... })` — sends SIGTERM, polls
- *      liveness, escalates to SIGKILL after `timeoutMs` (default 1500
- *      ms) on stragglers. Returns a kill report so callers can surface
- *      a concise summary without leaking PIDs to user-facing logs.
- *
- * Both helpers accept dependency-injected `runCommand`, `isAlive`, and
- * `sendSignal` parameters so tests can exercise the full behavior tree
- * cross-platform without spawning real processes.
- */
-/** Inject `child_process.execFileSync` for tests. Must return stdout as utf-8. */
-export type RunCommand = (cmd: string, args: readonly string[]) => string;
-/** Inject `process.kill(pid, 0)` for tests. */
-export type IsAlive = (pid: number) => boolean;
-/** Inject `process.kill(pid, signal)` for tests. */
-export type SendSignal = (pid: number, signal: NodeJS.Signals) => void;
-export interface DiscoverOptions {
-    ownPid: number;
-    ownPpid: number;
-    /** `process.platform` injection. Defaults to live process.platform. */
-    platform?: NodeJS.Platform;
-    /** Test injection point — defaults to `child_process.execFileSync`. */
-    runCommand?: RunCommand;
-}
-export interface KillOptions {
-    pids: readonly number[];
-    /** Time to wait for SIGTERM to take effect before escalating. */
-    timeoutMs?: number;
-    /** Poll interval while waiting for SIGTERM. */
-    pollIntervalMs?: number;
-    isAlive?: IsAlive;
-    sendSignal?: SendSignal;
-}
-export interface KillReport {
-    /** PIDs that died after SIGTERM within `timeoutMs`. */
-    terminatedBySigterm: number;
-    /** PIDs that required SIGKILL escalation. */
-    terminatedBySigkill: number;
-    /** Sum of the two — used by the cli summary line. */
-    totalKilled: number;
-}
-/**
- * Enumerate node MCP-server processes spawned from this plugin's
- * start.mjs. Always returns an empty array on tool absence — never
- * throws — so an upgrade is never blocked by a missing pgrep/PowerShell.
- */
-export declare function discoverSiblingMcpPids(opts: DiscoverOptions): number[];
-/**
- * Send SIGTERM to each PID, then poll for liveness. PIDs still alive
- * after `timeoutMs` receive SIGKILL. Returns a per-signal report.
- *
- * Algorithm:
- *   1. Fire SIGTERM at every pid (swallow ESRCH — already dead).
- *   2. Poll every `pollIntervalMs` until either all pids are dead
- *      OR `timeoutMs` elapses.
- *   3. For survivors: SIGKILL (swallow ESRCH).
- *   4. Count via "died-while-we-watched": only PIDs that were observed
- *      alive at any point and then died are reported. PIDs that were
- *      already dead before SIGTERM (ESRCH on first send) are not
- *      counted — they were not ours to kill.
- */
-export declare function killSiblingMcpServers(opts: KillOptions): Promise<KillReport>;

package/build/util/sibling-mcp.js

@@ -1,181 +0,0 @@
-/**
- * sibling-mcp — discover & terminate previous-version MCP servers.
- *
- * Issue #559: `/ctx-upgrade` historically left the running MCP server
- * alive after copying new files in-place + updating npm global. The next
- * Claude Code launch spawned a fresh process from the new version, but
- * the old one kept its open stdio + DB handles. Across enough upgrades
- * users observed 5+ context-mode `start.mjs` processes pinned to RAM.
- *
- * This module provides two pure helpers:
- *
- *   1. `discoverSiblingMcpPids({ ownPid, ownPpid, platform, runCommand })`
- *      — enumerates node processes whose argv mentions the plugin
- *      `start.mjs` path under `~/.claude/plugins/{cache,marketplaces}/`.
- *      Excludes the caller's own pid + parent pid (Claude Code or the
- *      shell that spawned `/ctx-upgrade`). Cross-platform: POSIX uses
- *      `pgrep -f`, Windows uses PowerShell + Get-CimInstance.
- *
- *   2. `killSiblingMcpServers({ pids, ... })` — sends SIGTERM, polls
- *      liveness, escalates to SIGKILL after `timeoutMs` (default 1500
- *      ms) on stragglers. Returns a kill report so callers can surface
- *      a concise summary without leaking PIDs to user-facing logs.
- *
- * Both helpers accept dependency-injected `runCommand`, `isAlive`, and
- * `sendSignal` parameters so tests can exercise the full behavior tree
- * cross-platform without spawning real processes.
- */
-import { execFileSync } from "node:child_process";
-// Match BOTH `~/.claude/plugins/cache/context-mode/context-mode/<v>/start.mjs`
-// AND `~/.claude/plugins/marketplaces/context-mode/start.mjs` shapes.
-// Both can be alive concurrently — VERDICT R1 dump confirmed all four
-// PIDs simultaneously across three different versions on a real Mac.
-const POSIX_PGREP_PATTERN = "node.*plugins/(cache|marketplaces)/.*context-mode.*start\\.mjs";
-// Windows: PowerShell + Get-CimInstance (wmic deprecated since Win11 22H2).
-// Filter on CommandLine because Win32_Process.Name is just "node.exe".
-// Two backslashes inside `start\.mjs` are needed because the Like operator
-// uses regex-ish escaping at the JS layer.
-const WIN_PS_SCRIPT = "Get-CimInstance Win32_Process " +
-    "-Filter \"Name='node.exe'\" | " +
-    "Where-Object { $_.CommandLine -match 'plugins[\\\\/](cache|marketplaces)[\\\\/].*context-mode.*start\\.mjs' } | " +
-    "Select-Object -ExpandProperty ProcessId";
-const defaultRun = (cmd, args) => execFileSync(cmd, [...args], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] });
-const defaultIsAlive = (pid) => {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-const defaultSendSignal = (pid, sig) => {
-    // Throws ESRCH if the process is already dead — callers must swallow.
-    process.kill(pid, sig);
-};
-/**
- * Parse newline-separated PID output. Tolerates header rows
- * (`ProcessId`, `----------`), surrounding whitespace, and empty lines.
- * Returns deduplicated, validated integers only.
- */
-function parsePidList(stdout) {
-    const seen = new Set();
-    for (const raw of stdout.split(/\r?\n/)) {
-        const trimmed = raw.trim();
-        if (!trimmed)
-            continue;
-        if (!/^\d+$/.test(trimmed))
-            continue;
-        const n = Number.parseInt(trimmed, 10);
-        if (Number.isFinite(n) && n > 0)
-            seen.add(n);
-    }
-    return [...seen];
-}
-/**
- * Enumerate node MCP-server processes spawned from this plugin's
- * start.mjs. Always returns an empty array on tool absence — never
- * throws — so an upgrade is never blocked by a missing pgrep/PowerShell.
- */
-export function discoverSiblingMcpPids(opts) {
-    const platform = opts.platform ?? process.platform;
-    const run = opts.runCommand ?? defaultRun;
-    let stdout = "";
-    try {
-        if (platform === "win32") {
-            stdout = run("powershell", ["-NoProfile", "-Command", WIN_PS_SCRIPT]);
-        }
-        else {
-            // pgrep exits 1 when no matches; execFileSync throws on non-zero.
-            // Treat that as "no siblings" rather than an error.
-            stdout = run("pgrep", ["-f", POSIX_PGREP_PATTERN]);
-        }
-    }
-    catch {
-        return [];
-    }
-    return parsePidList(stdout).filter((pid) => pid !== opts.ownPid && pid !== opts.ownPpid);
-}
-/** Sleep helper — Promise-based for use inside the kill polling loop. */
-function delay(ms) {
-    return new Promise((resolve) => { setTimeout(resolve, ms); });
-}
-/**
- * Send SIGTERM to each PID, then poll for liveness. PIDs still alive
- * after `timeoutMs` receive SIGKILL. Returns a per-signal report.
- *
- * Algorithm:
- *   1. Fire SIGTERM at every pid (swallow ESRCH — already dead).
- *   2. Poll every `pollIntervalMs` until either all pids are dead
- *      OR `timeoutMs` elapses.
- *   3. For survivors: SIGKILL (swallow ESRCH).
- *   4. Count via "died-while-we-watched": only PIDs that were observed
- *      alive at any point and then died are reported. PIDs that were
- *      already dead before SIGTERM (ESRCH on first send) are not
- *      counted — they were not ours to kill.
- */
-export async function killSiblingMcpServers(opts) {
-    const timeoutMs = opts.timeoutMs ?? 1500;
-    const pollIntervalMs = opts.pollIntervalMs ?? 100;
-    const isAlive = opts.isAlive ?? defaultIsAlive;
-    const sendSignal = opts.sendSignal ?? defaultSendSignal;
-    const empty = { terminatedBySigterm: 0, terminatedBySigkill: 0, totalKilled: 0 };
-    if (opts.pids.length === 0)
-        return empty;
-    // Track which PIDs we observed alive — we only count those.
-    const observedAlive = new Set();
-    const pendingTerm = new Set();
-    // Phase 1 — SIGTERM fan-out.
-    for (const pid of opts.pids) {
-        if (isAlive(pid)) {
-            observedAlive.add(pid);
-            pendingTerm.add(pid);
-        }
-        try {
-            sendSignal(pid, "SIGTERM");
-        }
-        catch (err) {
-            const code = err?.code;
-            if (code !== "ESRCH") {
-                // Permission errors etc. — drop from pending; cannot kill.
-                pendingTerm.delete(pid);
-            }
-        }
-    }
-    // Phase 2 — poll until either all dead or timeout.
-    const deadline = Date.now() + timeoutMs;
-    let terminatedBySigterm = 0;
-    while (pendingTerm.size > 0 && Date.now() < deadline) {
-        await delay(pollIntervalMs);
-        for (const pid of [...pendingTerm]) {
-            if (!isAlive(pid)) {
-                pendingTerm.delete(pid);
-                terminatedBySigterm++;
-            }
-        }
-    }
-    // Phase 3 — SIGKILL survivors.
-    let terminatedBySigkill = 0;
-    for (const pid of pendingTerm) {
-        try {
-            sendSignal(pid, "SIGKILL");
-        }
-        catch (err) {
-            const code = err?.code;
-            if (code === "ESRCH") {
-                // Died between the last poll and SIGKILL — count as SIGTERM win.
-                terminatedBySigterm++;
-                continue;
-            }
-            // Other error: skip — best-effort.
-            continue;
-        }
-        if (observedAlive.has(pid))
-            terminatedBySigkill++;
-    }
-    return {
-        terminatedBySigterm,
-        terminatedBySigkill,
-        totalKilled: terminatedBySigterm + terminatedBySigkill,
-    };
-}