context-mode 1.0.18 → 1.0.20

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.18"
+    "version": "1.0.20"
   },
   "plugins": [
     {
       "name": "context-mode",
       "source": "./",
       "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-      "version": "1.0.18",
+      "version": "1.0.20",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "MCP server that saves 98% of your context window with session continuity. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and automatic state restore across compactions.",
   "author": {
     "name": "Mert Koseoğlu",

package/build/db-base.js

@@ -65,6 +65,11 @@ export function deleteDBFiles(dbPath) {
  * always call this in a finally/cleanup path without try/catch.
  */
 export function closeDB(db) {
+    try {
+        // Checkpoint WAL before close to prevent contention on restart (#103)
+        db.pragma("wal_checkpoint(TRUNCATE)");
+    }
+    catch { /* WAL may not be active */ }
     try {
         db.close();
     }

package/build/executor.js

@@ -5,7 +5,7 @@ import { tmpdir } from "node:os";
 import { detectRuntimes, buildCommand, } from "./runtime.js";
 import { smartTruncate } from "./truncate.js";
 const isWin = process.platform === "win32";
-/** Kill process tree — on Windows, proc.kill() only kills the shell, not children. */
+/** Kill process tree — on Windows uses taskkill /T; on Unix kills the process group. */
 function killTree(proc) {
     if (isWin && proc.pid) {
         try {
@@ -13,8 +13,12 @@ function killTree(proc) {
         }
         catch { /* already dead */ }
     }
-    else {
-        proc.kill("SIGKILL");
+    else if (proc.pid) {
+        try {
+            // Kill entire process group (negative PID) to prevent orphaned children
+            process.kill(-proc.pid, "SIGKILL");
+        }
+        catch { /* already dead */ }
     }
 }
 export class PolyglotExecutor {
@@ -37,7 +41,8 @@ export class PolyglotExecutor {
     cleanupBackgrounded() {
         for (const pid of this.#backgroundedPids) {
             try {
-                process.kill(pid, "SIGTERM");
+                // Kill process group on Unix to catch all children
+                process.kill(isWin ? pid : -pid, "SIGTERM");
             }
             catch { /* already dead */ }
         }
@@ -165,6 +170,8 @@ export class PolyglotExecutor {
                 stdio: ["ignore", "pipe", "pipe"],
                 env: this.#buildSafeEnv(cwd),
                 shell: needsShell,
+                // On Unix, create a new process group so killTree can kill all children
+                detached: !isWin,
             });
             let timedOut = false;
             let resolved = false;

package/build/lifecycle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * lifecycle — Process lifecycle guard for MCP server.
+ *
+ * Detects parent process death, stdin close, and OS signals to prevent
+ * orphaned MCP server processes consuming 100% CPU (issue #103).
+ *
+ * Cross-platform: macOS, Linux, Windows.
+ */
+export interface LifecycleGuardOptions {
+    /** Interval in ms to check parent liveness. Default: 30_000 */
+    checkIntervalMs?: number;
+    /** Called when parent death or stdin close is detected. */
+    onShutdown: () => void;
+    /** Injectable parent-alive check (for testing). Default: ppid-based check. */
+    isParentAlive?: () => boolean;
+}
+/**
+ * Start the lifecycle guard. Returns a cleanup function.
+ * Skipped automatically when stdin is a TTY (e.g. OpenCode ts-plugin).
+ */
+export declare function startLifecycleGuard(opts: LifecycleGuardOptions): () => void;

package/build/lifecycle.js

@@ -0,0 +1,68 @@
+/**
+ * lifecycle — Process lifecycle guard for MCP server.
+ *
+ * Detects parent process death, stdin close, and OS signals to prevent
+ * orphaned MCP server processes consuming 100% CPU (issue #103).
+ *
+ * Cross-platform: macOS, Linux, Windows.
+ */
+/**
+ * Default parent liveness check.
+ * Compares current ppid against the original — if it changed (reparented to
+ * init/launchd/systemd), parent is dead. This is more reliable than
+ * kill(ppid, 0) which succeeds for PID 1 on all platforms.
+ *
+ * On Windows, ppid becomes 0 when parent exits.
+ */
+const originalPpid = process.ppid;
+function defaultIsParentAlive() {
+    const ppid = process.ppid;
+    if (ppid !== originalPpid)
+        return false;
+    if (ppid === 0 || ppid === 1)
+        return false;
+    return true;
+}
+/**
+ * Start the lifecycle guard. Returns a cleanup function.
+ * Skipped automatically when stdin is a TTY (e.g. OpenCode ts-plugin).
+ */
+export function startLifecycleGuard(opts) {
+    const interval = opts.checkIntervalMs ?? 30_000;
+    const check = opts.isParentAlive ?? defaultIsParentAlive;
+    let stopped = false;
+    const shutdown = () => {
+        if (stopped)
+            return;
+        stopped = true;
+        opts.onShutdown();
+    };
+    // P0: Periodic parent liveness check
+    const timer = setInterval(() => {
+        if (!check())
+            shutdown();
+    }, interval);
+    timer.unref();
+    // P0: Stdin close — parent pipe broken
+    // Must resume stdin to receive close/end events (Node starts paused)
+    const onStdinClose = () => shutdown();
+    process.stdin.resume();
+    process.stdin.on("end", onStdinClose);
+    process.stdin.on("close", onStdinClose);
+    process.stdin.on("error", onStdinClose);
+    // P0: OS signals — terminal close, kill, ctrl+c
+    const signals = ["SIGTERM", "SIGINT"];
+    if (process.platform !== "win32")
+        signals.push("SIGHUP");
+    for (const sig of signals)
+        process.on(sig, shutdown);
+    return () => {
+        stopped = true;
+        clearInterval(timer);
+        process.stdin.removeListener("end", onStdinClose);
+        process.stdin.removeListener("close", onStdinClose);
+        process.stdin.removeListener("error", onStdinClose);
+        for (const sig of signals)
+            process.removeListener(sig, shutdown);
+    };
+}

package/build/server.js

@@ -13,7 +13,8 @@ import { ContentStore, cleanupStaleDBs } from "./store.js";
 import { readBashPolicies, evaluateCommandDenyOnly, extractShellCommands, readToolDenyPatterns, evaluateFilePath, } from "./security.js";
 import { detectRuntimes, getRuntimeSummary, getAvailableLanguages, hasBunRuntime, } from "./runtime.js";
 import { classifyNonZeroExit } from "./exit-classify.js";
-const VERSION = "1.0.18";
+import { startLifecycleGuard } from "./lifecycle.js";
+const VERSION = "1.0.20";
 // Prevent silent server death from unhandled async errors
 process.on("unhandledRejection", (err) => {
     process.stderr.write(`[context-mode] unhandledRejection: ${err}\n`);
@@ -1462,6 +1463,8 @@ async function main() {
     process.on("exit", shutdown);
     process.on("SIGINT", () => { gracefulShutdown(); });
     process.on("SIGTERM", () => { gracefulShutdown(); });
+    // Lifecycle guard: detect parent death + stdin close to prevent orphaned processes (#103)
+    startLifecycleGuard({ onShutdown: () => gracefulShutdown() });
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Write routing instructions for hookless platforms (e.g. Codex CLI)

package/build/session/db.js

@@ -7,8 +7,6 @@
  */
 import { SQLiteBase, defaultDBPath } from "../db-base.js";
 import { createHash } from "node:crypto";
-import { execSync } from "node:child_process";
-import { cloudPostEvent } from "../sync/cloud-post.js";
 // ─────────────────────────────────────────────────────────
 // Constants
 // ─────────────────────────────────────────────────────────
@@ -190,25 +188,6 @@ export class SessionDB extends SQLiteBase {
             this.stmt(S.updateMetaLastEvent).run(sessionId);
         });
         transaction();
-        // Fire-and-forget: POST event directly to cloud (works in short-lived hook processes)
-        try {
-            const projectDir = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
-            let gitRemote;
-            try {
-                gitRemote = execSync("git remote get-url origin", { cwd: projectDir, timeout: 2000 })
-                    .toString().trim() || undefined;
-            }
-            catch { /* no git remote available */ }
-            cloudPostEvent({
-                type: event.type,
-                category: event.category,
-                priority: event.priority,
-                data: event.data,
-                source_hook: sourceHook,
-                created_at: new Date().toISOString(),
-            }, projectDir, sessionId, gitRemote);
-        }
-        catch { /* cloud sync must never break local event storage */ }
     }
     /**
      * Retrieve events for a session with optional filtering.