context-mode 1.0.54 → 1.0.57

package/hooks/ensure-deps.mjs

@@ -8,13 +8,22 @@
  * hook that needs native modules. Fast path: existsSync check (~0.1ms).
  * Slow path: npm install (first run only, ~5-30s).
  *
+ * Also handles ABI compatibility (#148, #203): when the current Node.js
+ * version differs from the one better-sqlite3 was compiled against,
+ * automatically swaps in a cached binary or rebuilds. This protects
+ * both the MCP server AND hooks from ABI mismatch crashes when users
+ * have multiple Node versions via mise/volta/fnm/nvm.
+ *
+ * @see https://github.com/mksglu/context-mode/issues/148
  * @see https://github.com/mksglu/context-mode/issues/172
+ * @see https://github.com/mksglu/context-mode/issues/203
  */
 
-import { existsSync } from "node:fs";
+import { existsSync, copyFileSync } from "node:fs";
 import { execSync } from "node:child_process";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const root = resolve(__dirname, "..");
@@ -23,7 +32,9 @@ const NATIVE_DEPS = ["better-sqlite3"];
 
 export function ensureDeps() {
   for (const pkg of NATIVE_DEPS) {
-    if (!existsSync(resolve(root, "node_modules", pkg))) {
+    const pkgDir = resolve(root, "node_modules", pkg);
+    if (!existsSync(pkgDir)) {
+      // Package not installed at all
       try {
         execSync(`npm install ${pkg} --no-package-lock --no-save --silent`, {
           cwd: root,
@@ -31,9 +42,76 @@ export function ensureDeps() {
           timeout: 120000,
         });
       } catch { /* best effort — hook degrades gracefully without DB */ }
+    } else if (
+      !existsSync(resolve(pkgDir, "build", "Release")) &&
+      !existsSync(resolve(pkgDir, "prebuilds"))
+    ) {
+      // Package installed but native binary missing (e.g., npm ignore-scripts=true)
+      try {
+        execSync(`npm rebuild ${pkg} --ignore-scripts=false`, {
+          cwd: root,
+          stdio: "pipe",
+          timeout: 120000,
+        });
+      } catch { /* best effort — hook degrades gracefully without DB */ }
+    }
+  }
+}
+
+/**
+ * ABI-aware native binary caching for better-sqlite3 (#148, #203).
+ *
+ * Users with mise/asdf/volta/fnm may run sessions with different Node
+ * versions. Each ABI needs its own compiled binary — cache them
+ * side-by-side so switching Node versions doesn't require a rebuild
+ * every time.
+ *
+ * Flow:
+ *   1. Check if ABI-specific cache exists → swap in
+ *   2. Probe-load better-sqlite3 → if OK, cache current binary
+ *   3. If ABI mismatch → npm rebuild, then cache the new binary
+ */
+export function ensureNativeCompat(pluginRoot) {
+  try {
+    const abi = process.versions.modules;
+    const nativeDir = resolve(pluginRoot, "node_modules", "better-sqlite3", "build", "Release");
+    const binaryPath = resolve(nativeDir, "better_sqlite3.node");
+    const abiCachePath = resolve(nativeDir, `better_sqlite3.abi${abi}.node`);
+
+    if (!existsSync(nativeDir)) return;
+
+    // Fast path: cached binary for this ABI already exists
+    if (existsSync(abiCachePath)) {
+      copyFileSync(abiCachePath, binaryPath);
+      return;
+    }
+
+    if (!existsSync(binaryPath)) return;
+
+    // Probe: try loading better-sqlite3 with current Node
+    try {
+      const req = createRequire(resolve(pluginRoot, "package.json"));
+      req("better-sqlite3");
+      // Load succeeded — cache the working binary for this ABI
+      copyFileSync(binaryPath, abiCachePath);
+    } catch (probeErr) {
+      if (probeErr?.message?.includes("NODE_MODULE_VERSION")) {
+        // ABI mismatch — rebuild for current Node version
+        execSync("npm rebuild better-sqlite3", {
+          cwd: pluginRoot,
+          stdio: "pipe",
+          timeout: 60000,
+        });
+        if (existsSync(binaryPath)) {
+          copyFileSync(binaryPath, abiCachePath);
+        }
+      }
     }
+  } catch {
+    /* best effort — caller will report the error on first DB access */
   }
 }
 
 // Auto-run on import (like suppress-stderr.mjs)
 ensureDeps();
+ensureNativeCompat(root);

package/hooks/routing-block.mjs

@@ -35,12 +35,21 @@ export function createRoutingBlock(t) {
     - DO NOT use Read for analysis (use execute_file). Read IS correct for files you intend to Edit.
     - DO NOT use WebFetch (use ${t("ctx_fetch_and_index")} instead).
     - Bash is ONLY for git/mkdir/rm/mv/navigation.
+    - DO NOT use ${t("ctx_execute")} or ${t("ctx_execute_file")} to create, modify, or overwrite files.
+      ctx_execute is for data analysis, log processing, and computation only.
   </forbidden_actions>
 
+  <file_writing_policy>
+    ALWAYS use the native Write tool to create files and Edit tool to modify files.
+    NEVER use ${t("ctx_execute")}, ${t("ctx_execute_file")}, or Bash to write file content.
+    This applies to all file types: code, configs, plans, specs, YAML, JSON, markdown.
+  </file_writing_policy>
+
   <output_constraints>
     <word_limit>Keep your final response under 500 words.</word_limit>
     <artifact_policy>
-      Write artifacts (code, configs, PRDs) to FILES. NEVER return them as inline text.
+      Write artifacts (code, configs, PRDs) to FILES using the native Write tool. NEVER return them as inline text.
+      Use Edit tool for modifications to existing files.
       Return only: file path + 1-line description.
     </artifact_policy>
     <response_format>
@@ -61,6 +70,8 @@ export function createRoutingBlock(t) {
 
     When the user says "ctx upgrade", "ctx-upgrade", "/ctx-upgrade", or asks to update context-mode:
     → Call the upgrade MCP tool, execute the returned shell command, display results as a checklist.
+
+    After /clear: call ${t("ctx_stats")}(reset: true) to reset session stats and search index.
   </ctx_commands>
 </context_window_protection>`;
 }

package/hooks/session-helpers.mjs

@@ -170,3 +170,16 @@ export function getCleanupFlagPath(opts = CLAUDE_OPTS) {
   mkdirSync(dir, { recursive: true });
   return join(dir, `${hash}${getWorktreeSuffix()}.cleanup`);
 }
+
+/**
+ * Return the per-project clear-stats flag path.
+ * Written by SessionStart hook on /clear, read by MCP server to reset stats.
+ * Path: ~/<configDir>/context-mode/sessions/<SHA256(projectDir)[:16]>.clear-stats
+ */
+export function getClearStatsFlagPath(opts = CLAUDE_OPTS) {
+  const projectDir = getProjectDir(opts);
+  const hash = createHash("sha256").update(projectDir).digest("hex").slice(0, 16);
+  const dir = join(homedir(), opts.configDir, "context-mode", "sessions");
+  mkdirSync(dir, { recursive: true });
+  return join(dir, `${hash}${getWorktreeSuffix()}.clear-stats`);
+}

package/hooks/session-snapshot.bundle.mjs

@@ -1,14 +1,14 @@
-function p(t,e){return t.length<=e?t:t.slice(0,Math.max(0,e-3))+"..."}function a(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}var G=2048,J=10;function q(t){if(t.length===0)return"";let e=new Map;for(let u of t){let l=u.data,i=e.get(l);i||(i={ops:new Map,last:""},e.set(l,i));let r;u.type==="file_write"?r="write":u.type==="file_read"?r="read":u.type==="file_edit"?r="edit":r=u.type,i.ops.set(r,(i.ops.get(r)??0)+1),i.last=r}let s=Array.from(e.entries()).slice(-J),c=["  <active_files>"];for(let[u,{ops:l,last:i}]of s){let r=Array.from(l.entries()).map(([f,d])=>`${f}:${d}`).join(",");c.push(`    <file path="${a(u)}" ops="${a(r)}" last="${a(i)}" />`)}return c.push("  </active_files>"),c.join(`
-`)}function z(t){if(t.length===0)return"";let e=[],n={};for(let i of t)try{let r=JSON.parse(i.data);typeof r.subject=="string"?e.push(r.subject):typeof r.taskId=="string"&&typeof r.status=="string"&&(n[r.taskId]=r.status)}catch{}if(e.length===0)return"";let s=new Set(["completed","deleted","failed"]),c=Object.keys(n).sort((i,r)=>Number(i)-Number(r)),u=[];for(let i=0;i<e.length;i++){let r=c[i],f=r?n[r]??"pending":"pending";s.has(f)||u.push(e[i])}if(u.length===0)return"";let l=["  <task_state>"];for(let i of u)l.push(`    - ${a(p(i,100))}`);return l.push("  </task_state>"),l.join(`
-`)}function K(t){if(t.length===0)return"";let e=new Set,n=["  <rules>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),s.type==="rule_content"?n.push(`    <rule_content>${a(p(s.data,400))}</rule_content>`):n.push(`    - ${a(p(s.data,200))}`))}return n.push("  </rules>"),n.join(`
-`)}function U(t){if(t.length===0)return"";let e=new Set,n=["  <decisions>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),n.push(`    - ${a(p(s.data,200))}`))}return n.push("  </decisions>"),n.join(`
-`)}function V(t,e,n){let s=[];if(!t&&e.length===0&&!n)return"";s.push("  <environment>"),t&&s.push(`    <cwd>${a(t.data)}</cwd>`),n&&s.push(`    <git op="${a(n.data)}" />`);for(let c of e)s.push(`    <env>${a(p(c.data,150))}</env>`);return s.push("  </environment>"),s.join(`
-`)}function Y(t){if(t.length===0)return"";let e=["  <errors_encountered>"];for(let n of t)e.push(`    - ${a(p(n.data,150))}`);return e.push("  </errors_encountered>"),e.join(`
-`)}function H(t){return`  <intent mode="${a(t.data)}">${a(p(t.data,100))}</intent>`}function N(t){if(t.length===0)return"";let e=["  <subagents>"];for(let n of t){let s=n.type==="subagent_completed"?"completed":n.type==="subagent_launched"?"launched":"unknown";e.push(`    <agent status="${s}">${a(p(n.data,200))}</agent>`)}return e.push("  </subagents>"),e.join(`
+function l(t,e){return t.length<=e?t:t.slice(0,Math.max(0,e-3))+"..."}function a(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}var G=2048,J=10;function q(t){if(t.length===0)return"";let e=new Map;for(let u of t){let p=u.data,i=e.get(p);i||(i={ops:new Map,last:""},e.set(p,i));let r;u.type==="file_write"?r="write":u.type==="file_read"?r="read":u.type==="file_edit"?r="edit":r=u.type,i.ops.set(r,(i.ops.get(r)??0)+1),i.last=r}let s=Array.from(e.entries()).slice(-J),c=["  <active_files>"];for(let[u,{ops:p,last:i}]of s){let r=Array.from(p.entries()).map(([f,g])=>`${f}:${g}`).join(",");c.push(`    <file path="${a(u)}" ops="${a(r)}" last="${a(i)}" />`)}return c.push("  </active_files>"),c.join(`
+`)}function z(t){if(t.length===0)return"";let e=[],n={};for(let i of t)try{let r=JSON.parse(i.data);typeof r.subject=="string"?e.push(r.subject):typeof r.taskId=="string"&&typeof r.status=="string"&&(n[r.taskId]=r.status)}catch{}if(e.length===0)return"";let s=new Set(["completed","deleted","failed"]),c=Object.keys(n).sort((i,r)=>Number(i)-Number(r)),u=[];for(let i=0;i<e.length;i++){let r=c[i],f=r?n[r]??"pending":"pending";s.has(f)||u.push(e[i])}if(u.length===0)return"";let p=["  <task_state>"];for(let i of u)p.push(`    - ${a(l(i,100))}`);return p.push("  </task_state>"),p.join(`
+`)}function U(t){if(t.length===0)return"";let e=new Set,n=["  <rules>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),s.type==="rule_content"?n.push(`    <rule_content>${a(l(s.data,400))}</rule_content>`):n.push(`    - ${a(l(s.data,200))}`))}return n.push("  </rules>"),n.join(`
+`)}function V(t){if(t.length===0)return"";let e=new Set,n=["  <decisions>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),n.push(`    - ${a(l(s.data,200))}`))}return n.push("  </decisions>"),n.join(`
+`)}function Y(t,e,n){let s=[];if(!t&&e.length===0&&!n)return"";s.push("  <environment>"),t&&s.push(`    <cwd>${a(t.data)}</cwd>`),n&&s.push(`    <git op="${a(n.data)}" />`);for(let c of e)s.push(`    <env>${a(l(c.data,150))}</env>`);return s.push("  </environment>"),s.join(`
+`)}function H(t){if(t.length===0)return"";let e=["  <errors_encountered>"];for(let n of t)e.push(`    - ${a(l(n.data,150))}`);return e.push("  </errors_encountered>"),e.join(`
+`)}function K(t){return`  <intent mode="${a(t.data)}">${a(l(t.data,100))}</intent>`}function P(t){if(t.length===0)return"";let e=["  <subagents>"];for(let n of t){let s=n.type==="subagent_completed"?"completed":n.type==="subagent_launched"?"launched":"unknown";e.push(`    <agent status="${s}">${a(l(n.data,200))}</agent>`)}return e.push("  </subagents>"),e.join(`
 `)}function Q(t){if(t.length===0)return"";let e=new Map;for(let s of t){let c=s.data.split(":")[0].trim();e.set(c,(e.get(c)??0)+1)}let n=["  <mcp_tools>"];for(let[s,c]of e)n.push(`    <tool name="${a(s)}" calls="${c}" />`);return n.push("  </mcp_tools>"),n.join(`
-`)}function et(t,e){let n=e?.maxBytes??G,s=e?.compactCount??1,c=new Date().toISOString(),u=[],l=[],i=[],r=[],f=[],d=[],_=[],h=[],k=[],b=[],B=[],S=[];for(let o of t)switch(o.category){case"file":u.push(o);break;case"task":l.push(o);break;case"rule":i.push(o);break;case"decision":r.push(o);break;case"cwd":f.push(o);break;case"error":d.push(o);break;case"env":_.push(o);break;case"git":h.push(o);break;case"subagent":k.push(o);break;case"intent":b.push(o);break;case"mcp":B.push(o);break;case"plan":S.push(o);break}let m=[],w=q(u);w&&m.push(w);let x=z(l);x&&m.push(x);let L=K(i);L&&m.push(L);let g=[],j=U(r);j&&g.push(j);let P=f.length>0?f[f.length-1]:void 0,R=h.length>0?h[h.length-1]:void 0,M=V(P,_,R);M&&g.push(M);let I=Y(d);I&&g.push(I);let D=k.filter(o=>o.type==="subagent_completed"),T=N(D);T&&g.push(T),S.length>0&&S[S.length-1].type==="plan_enter"&&g.push('  <plan_mode status="active" />');let v=[];if(b.length>0){let o=b[b.length-1];v.push(H(o))}let O=Q(B);O&&v.push(O);let X=k.filter(o=>o.type==="subagent_launched"),A=N(X);A&&v.push(A);let E=`<session_resume compact_count="${s}" events_captured="${t.length}" generated_at="${c}">`,$="</session_resume>",C=[m,g,v];for(let o=C.length;o>=0;o--){let F=C.slice(0,o).flat().join(`
-`),y;if(F?y=`${E}
-${F}
-${$}`:y=`${E}
-${$}`,Buffer.byteLength(y)<=n)return y}return`${E}
-${$}`}export{et as buildResumeSnapshot,q as renderActiveFiles,U as renderDecisions,V as renderEnvironment,Y as renderErrors,H as renderIntent,Q as renderMcpTools,K as renderRules,N as renderSubagents,z as renderTaskState};
+`)}function et(t,e){let n=e?.maxBytes??G,s=e?.compactCount??1,c=new Date().toISOString(),u=[],p=[],i=[],r=[],f=[],g=[],$=[],h=[],E=[],S=[],w=[],m=[];for(let o of t)switch(o.category){case"file":u.push(o);break;case"task":p.push(o);break;case"rule":i.push(o);break;case"decision":r.push(o);break;case"cwd":f.push(o);break;case"error":g.push(o);break;case"env":$.push(o);break;case"git":h.push(o);break;case"subagent":E.push(o);break;case"intent":S.push(o);break;case"mcp":w.push(o);break;case"plan":m.push(o);break}let b=[],x=q(u);x&&b.push(x);let B=z(p);B&&b.push(B);let j=U(i);j&&b.push(j);let d=[],I=V(r);I&&d.push(I);let R=f.length>0?f[f.length-1]:void 0,F=h.length>0?h[h.length-1]:void 0,L=Y(R,$,F);L&&d.push(L);let M=H(g);M&&d.push(M);let D=E.filter(o=>o.type==="subagent_completed"),O=P(D);O&&d.push(O),m.length>0&&m[m.length-1].type==="plan_enter"&&d.push('  <plan_mode status="active" />');let v=[];if(S.length>0){let o=S[S.length-1];v.push(K(o))}let T=Q(w);T&&v.push(T);let X=E.filter(o=>o.type==="subagent_launched"),A=P(X);A&&v.push(A);let _=`<session_resume compact_count="${s}" events_captured="${t.length}" generated_at="${c}">`,k="</session_resume>",C=[b,d,v];for(let o=C.length;o>=0;o--){let N=C.slice(0,o).flat().join(`
+`),y;if(N?y=`${_}
+${N}
+${k}`:y=`${_}
+${k}`,Buffer.byteLength(y)<=n)return y}return`${_}
+${k}`}export{et as buildResumeSnapshot,q as renderActiveFiles,V as renderDecisions,Y as renderEnvironment,H as renderErrors,K as renderIntent,Q as renderMcpTools,U as renderRules,P as renderSubagents,z as renderTaskState};

package/hooks/sessionstart.mjs

@@ -19,7 +19,7 @@ import { createRoutingBlock } from "./routing-block.mjs";
 import { createToolNamer } from "./core/tool-naming.mjs";
 
 const ROUTING_BLOCK = createRoutingBlock(createToolNamer("claude-code"));
-import { readStdin, getSessionId, getSessionDBPath, getSessionEventsPath, getCleanupFlagPath } from "./session-helpers.mjs";
+import { readStdin, getSessionId, getSessionDBPath, getSessionEventsPath, getCleanupFlagPath, getClearStatsFlagPath } from "./session-helpers.mjs";
 import { writeSessionEventsFile, buildSessionDirective, getSessionEvents, getLatestSessionEvents } from "./session-directive.mjs";
 import { createSessionLoaders } from "./session-loaders.mjs";
 import { join, dirname } from "node:path";
@@ -145,7 +145,10 @@ try {
       }
     } catch { /* best effort — never block session start */ }
   }
-  // "clear" — no action needed
+  // "clear" — signal MCP server to reset session stats
+  if (source === "clear") {
+    try { writeFileSync(getClearStatsFlagPath(), String(Date.now())); } catch { /* best effort */ }
+  }
 } catch (err) {
   // Session continuity is best-effort — never block session start
   try {

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.54",
+  "version": "1.0.57",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.54",
+  "version": "1.0.57",
   "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",