context-mode 1.0.97 → 1.0.98

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.97"
+    "version": "1.0.98"
   },
   "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.97",
+      "version": "1.0.98",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.97",
+  "version": "1.0.98",
   "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/.openclaw-plugin/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "Context Mode",
   "kind": "tool",
   "description": "OpenClaw 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.97",
+  "version": "1.0.98",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.97",
+  "version": "1.0.98",
   "description": "OpenClaw plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
   "author": {
     "name": "Mert Koseoğlu",

package/build/server.js

@@ -2154,8 +2154,11 @@ async function main() {
     if (cleaned > 0) {
         console.error(`Cleaned up ${cleaned} stale DB file(s) from previous sessions`);
     }
-    // MCP readiness sentinel path (#230)
-    const mcpSentinel = join(tmpdir(), `context-mode-mcp-ready-${process.ppid}`);
+    // MCP readiness sentinel path (#230, #347)
+    // Uses process.pid (not ppid) — hooks use directory-scan to find any live sentinel.
+    // Hardcoded /tmp on Unix to avoid TMPDIR mismatch (#347).
+    const mcpSentinelDir = process.platform === "win32" ? tmpdir() : "/tmp";
+    const mcpSentinel = join(mcpSentinelDir, `context-mode-mcp-ready-${process.pid}`);
     // Clean up own DB + backgrounded processes + preload script on shutdown
     const shutdown = () => {
         executor.cleanupBackgrounded();

package/cli.bundle.mjs

@@ -396,7 +396,7 @@ async function main() {
   emit('text', text);
 }
 main();
-`}function Uk(){return{prepare:()=>({run:()=>{},get:(...t)=>({cnt:0,compact_count:0,minutes:null,rate:0,avg:0,outcome:"exploratory"}),all:()=>[]})}}async function aM(){let t=Ah();t>0&&console.error(`Cleaned up ${t} stale DB file(s) from previous sessions`);let e=_e(Vh(),`context-mode-mcp-ready-${process.ppid}`),r=()=>{yi.cleanupBackgrounded(),fr&&fr.close();try{Tr(Wh)}catch{}try{Tr(e)}catch{}if(Pr&&Pr.pid&&!Pr.killed)try{Pr.kill("SIGTERM")}catch{}},n=async()=>{r(),process.exit(0)};process.on("exit",r),process.on("SIGINT",()=>{n()}),process.on("SIGTERM",()=>{n()}),Rk({onShutdown:()=>n()});let o=new Dc;await Ke.connect(o);try{Hk(e,String(process.pid))}catch{}try{let{detectPlatform:s,getAdapter:i}=await Promise.resolve().then(()=>(nl(),O_)),a=Ke.server.getClientVersion(),c=s(a??void 0);Yc=await i(c.platform),a&&console.error(`MCP client: ${a.name} v${a.version} \u2192 ${c.platform}`)}catch{}Bj().then(s=>{s!=="unknown"&&(nn=s)}),console.error(`Context Mode MCP server v${tn} running on stdio`),console.error(`Detected runtimes:
+`}function Uk(){return{prepare:()=>({run:()=>{},get:(...t)=>({cnt:0,compact_count:0,minutes:null,rate:0,avg:0,outcome:"exploratory"}),all:()=>[]})}}async function aM(){let t=Ah();t>0&&console.error(`Cleaned up ${t} stale DB file(s) from previous sessions`);let e=process.platform==="win32"?Vh():"/tmp",r=_e(e,`context-mode-mcp-ready-${process.pid}`),n=()=>{yi.cleanupBackgrounded(),fr&&fr.close();try{Tr(Wh)}catch{}try{Tr(r)}catch{}if(Pr&&Pr.pid&&!Pr.killed)try{Pr.kill("SIGTERM")}catch{}},o=async()=>{n(),process.exit(0)};process.on("exit",n),process.on("SIGINT",()=>{o()}),process.on("SIGTERM",()=>{o()}),Rk({onShutdown:()=>o()});let s=new Dc;await Ke.connect(s);try{Hk(r,String(process.pid))}catch{}try{let{detectPlatform:i,getAdapter:a}=await Promise.resolve().then(()=>(nl(),O_)),c=Ke.server.getClientVersion(),u=i(c??void 0);Yc=await a(u.platform),c&&console.error(`MCP client: ${c.name} v${c.version} \u2192 ${u.platform}`)}catch{}Bj().then(i=>{i!=="unknown"&&(nn=i)}),console.error(`Context Mode MCP server v${tn} running on stdio`),console.error(`Detected runtimes:
 ${Oi(ru)}`),Jn()||(console.error(`
 Performance tip: Install Bun for 3-5x faster JS/TS execution`),console.error("  curl -fsSL https://bun.sh/install | bash"))}var bt,tn,ru,Kc,Ke,yi,Wh,fr,Yc,Pr,je,nn,Gc,Mk,Hj,qj,Dk,Xj,Qj,eM,tM,Qc,eu,Vn,Uh,rM,Lk,Fk,Zh,Hh,Kk=v(()=>{"use strict";XS();rk();$h();Ph();xk();Tk();Ii();Pk();Ok();Ck();gi();zk();wo();bt=Qt(Lj(import.meta.url)),tn=(()=>{for(let t of["../package.json","./package.json"]){let e=vt(bt,t);if(Ie(e))try{return JSON.parse(Bh(e,"utf8")).version}catch{}}return"unknown"})();process.on("unhandledRejection",t=>{process.stderr.write(`[context-mode] unhandledRejection: ${t}
 `)});process.on("uncaughtException",t=>{process.stderr.write(`[context-mode] uncaughtException: ${t?.message??t}

package/hooks/core/mcp-ready.mjs

@@ -1,30 +1,73 @@
 /**
  * MCP readiness sentinel — checks if MCP server has started.
- * Server writes sentinel (containing its PID) after connect(),
- * hooks check before denying tools that redirect to MCP alternatives.
  *
- * Sentinel path: ${tmpdir()}/context-mode-mcp-ready-${process.ppid}
- * Both hooks and MCP server share the same ppid (Claude Code process).
+ * Server writes sentinel (containing its PID) after connect().
+ * Hooks scan for any live sentinel to detect MCP readiness.
+ *
+ * Fix for #347: Claude Code spawns hooks via `bash -c "node ..."` on Linux/WSL2.
+ * The intermediate shell makes process.ppid point to a transient bash PID, not
+ * Claude Code. Directory-scan + PID liveness probe works regardless of spawn topology.
+ *
+ * Sentinel path: <tmpRoot>/context-mode-mcp-ready-<MCP_PID>
+ * Scan: glob all context-mode-mcp-ready-* files, probe each PID.
  */
-import { readFileSync } from "node:fs";
+import { readFileSync, readdirSync, unlinkSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { resolve } from "node:path";
+import { join } from "node:path";
+
+const SENTINEL_PREFIX = "context-mode-mcp-ready-";
+
+/** Resolve the temp root — hardcoded /tmp on Unix to avoid TMPDIR mismatch. */
+export function sentinelDir() {
+  return process.platform === "win32" ? tmpdir() : "/tmp";
+}
+
+/**
+ * Build sentinel path for a given PID.
+ * Used by server.ts to write its own sentinel.
+ */
+export function sentinelPathForPid(pid) {
+  return join(sentinelDir(), `${SENTINEL_PREFIX}${pid}`);
+}
 
-/** Compute the sentinel file path, scoped to session via parent PID. */
+/**
+ * @deprecated Use sentinelPathForPid(process.pid) from server.ts.
+ * Kept for backward compat during migration — tests that still
+ * write sentinels with process.ppid will work for one release cycle.
+ */
 export function sentinelPath() {
-  return resolve(tmpdir(), `context-mode-mcp-ready-${process.ppid}`);
+  return join(sentinelDir(), `${SENTINEL_PREFIX}${process.ppid}`);
 }
 
 /**
- * Check if MCP server is alive by reading sentinel PID and probing it.
- * Handles stale sentinels from crashed servers (SIGKILL, OOM) — if the
- * PID in the sentinel is dead, returns false so hooks allow fallback.
+ * Check if any MCP server is alive by scanning sentinel files.
+ *
+ * Scans sentinelDir() for context-mode-mcp-ready-* files, reads the PID
+ * from each, and probes with kill(pid, 0). Cleans up stale sentinels
+ * from crashed servers.
+ *
+ * Handles:
+ * - PPID mismatch (WSL2 shell wrappers) — no ppid dependency
+ * - Stale sentinels (SIGKILL, OOM) — PID liveness check
+ * - TMPDIR mismatch — hardcoded /tmp on Unix
  */
 export function isMCPReady() {
   try {
-    const pid = parseInt(readFileSync(sentinelPath(), "utf8"), 10);
-    process.kill(pid, 0); // throws if process doesn't exist
-    return true;
+    const dir = sentinelDir();
+    const files = readdirSync(dir).filter(f => f.startsWith(SENTINEL_PREFIX));
+    for (const f of files) {
+      const fullPath = join(dir, f);
+      try {
+        const pid = parseInt(readFileSync(fullPath, "utf8"), 10);
+        if (isNaN(pid)) continue;
+        process.kill(pid, 0); // throws if process doesn't exist
+        return true;
+      } catch {
+        // Dead PID or unreadable — clean up stale sentinel
+        try { unlinkSync(fullPath); } catch {}
+      }
+    }
+    return false;
   } catch {
     return false;
   }

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "Context Mode",
   "kind": "tool",
   "description": "OpenClaw 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.97",
+  "version": "1.0.98",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.97",
+  "version": "1.0.98",
   "type": "module",
   "description": "MCP plugin that saves 98% of your context window. Works with Claude Code, Gemini CLI, VS Code Copilot, OpenCode, and Codex CLI. Sandboxed code execution, FTS5 knowledge base, and intent-driven search.",
   "author": "Mert Koseoğlu",

package/server.bundle.mjs

@@ -568,6 +568,6 @@ To fix:
 `)+`
 
 Open: ${p}
-PID: ${m.pid} \xB7 Stop: ${process.platform==="win32"?`taskkill /PID ${m.pid} /F`:`kill ${m.pid}`}`}]})}catch(i){let a=i instanceof Error?i.message:String(i);return D("ctx_insight",{content:[{type:"text",text:`Insight setup failed: ${a}`}]})}});async function DN(){let t=Cp();t>0&&console.error(`Cleaned up ${t} stale DB file(s) from previous sessions`);let e=le($f(),`context-mode-mcp-ready-${process.ppid}`),r=()=>{Is.cleanupBackgrounded(),Xt&&Xt.close();try{ur(Pf)}catch{}try{ur(e)}catch{}if(lr&&lr.pid&&!lr.killed)try{lr.kill("SIGTERM")}catch{}},n=async()=>{r(),process.exit(0)};process.on("exit",r),process.on("SIGINT",()=>{n()}),process.on("SIGTERM",()=>{n()}),Gx({onShutdown:()=>n()});let o=new ya;await De.connect(o);try{hS(e,String(process.pid))}catch{}try{let{detectPlatform:s,getAdapter:i}=await Promise.resolve().then(()=>(aS(),iS)),a=De.server.getClientVersion(),c=s(a??void 0);Ma=await i(c.platform),a&&console.error(`MCP client: ${a.name} v${a.version} \u2192 ${c.platform}`)}catch{}vN().then(s=>{s!=="unknown"&&(Ar=s)}),console.error(`Context Mode MCP server v${Nr} running on stdio`),console.error(`Detected runtimes:
+PID: ${m.pid} \xB7 Stop: ${process.platform==="win32"?`taskkill /PID ${m.pid} /F`:`kill ${m.pid}`}`}]})}catch(i){let a=i instanceof Error?i.message:String(i);return D("ctx_insight",{content:[{type:"text",text:`Insight setup failed: ${a}`}]})}});async function DN(){let t=Cp();t>0&&console.error(`Cleaned up ${t} stale DB file(s) from previous sessions`);let e=process.platform==="win32"?$f():"/tmp",r=le(e,`context-mode-mcp-ready-${process.pid}`),n=()=>{Is.cleanupBackgrounded(),Xt&&Xt.close();try{ur(Pf)}catch{}try{ur(r)}catch{}if(lr&&lr.pid&&!lr.killed)try{lr.kill("SIGTERM")}catch{}},o=async()=>{n(),process.exit(0)};process.on("exit",n),process.on("SIGINT",()=>{o()}),process.on("SIGTERM",()=>{o()}),Gx({onShutdown:()=>o()});let s=new ya;await De.connect(s);try{hS(r,String(process.pid))}catch{}try{let{detectPlatform:i,getAdapter:a}=await Promise.resolve().then(()=>(aS(),iS)),c=De.server.getClientVersion(),u=i(c??void 0);Ma=await a(u.platform),c&&console.error(`MCP client: ${c.name} v${c.version} \u2192 ${u.platform}`)}catch{}vN().then(i=>{i!=="unknown"&&(Ar=i)}),console.error(`Context Mode MCP server v${Nr} running on stdio`),console.error(`Detected runtimes:
 ${Tx(Ha)}`),Sa()||(console.error(`
 Performance tip: Install Bun for 3-5x faster JS/TS execution`),console.error("  curl -fsSL https://bun.sh/install | bash"))}DN().catch(t=>{console.error("Fatal:",t),process.exit(1)});export{_S as extractSnippet,IN as formatBatchQueryResults,CN as positionsFromHighlight};