context-mode 1.0.93 → 1.0.95

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.93",
+  "version": "1.0.95",
   "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.93",
+  "version": "1.0.95",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.93",
+  "version": "1.0.95",
   "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/cli.d.ts

@@ -13,3 +13,5 @@
  */
 /** Normalize Windows backslash paths to forward slashes for Bash (MSYS2) compatibility. */
 export declare function toUnixPath(p: string): string;
+export declare function npmExecFile(args: string[], opts?: Record<string, unknown>): void;
+export declare function npmExec(command: string, opts?: Record<string, unknown>): void;

package/build/cli.js

@@ -120,6 +120,26 @@ else {
 export function toUnixPath(p) {
     return p.replace(/\\/g, "/");
 }
+/**
+ * Windows-safe npm execution. On Windows:
+ * - "npm" → "npm.cmd" (Node won't resolve via PATHEXT in execFile)
+ * - shell: true required (Node v20+ CVE-2024-27980 mitigation)
+ * See: https://github.com/mksglu/context-mode/issues/344
+ */
+const isWin = process.platform === "win32";
+export function npmExecFile(args, opts = {}) {
+    execFileSync(isWin ? "npm.cmd" : "npm", args, {
+        ...opts,
+        ...(isWin ? { shell: true } : {}),
+    });
+}
+export function npmExec(command, opts = {}) {
+    const { execSync: es } = require("node:child_process");
+    es(isWin ? command.replace(/^npm /, "npm.cmd ") : command, {
+        ...opts,
+        ...(isWin ? { shell: true } : {}),
+    });
+}
 function defaultPluginRoot() {
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = dirname(__filename);
@@ -400,7 +420,7 @@ async function insight(port) {
         if (!existsSync(join(cacheDir, "node_modules"))) {
             console.log("Installing dependencies (first run)...");
             try {
-                execSync("npm install --production=false", { cwd: cacheDir, stdio: "inherit", timeout: 300000 });
+                npmExec("npm install --production=false", { cwd: cacheDir, stdio: "inherit", timeout: 300000 });
             }
             catch {
                 // Clean up partial install so next run retries fresh
@@ -512,12 +532,12 @@ async function upgrade() {
         }
         // Step 2: Install dependencies + build
         s.start("Installing dependencies & building");
-        execFileSync("npm", ["install", "--no-audit", "--no-fund"], {
+        npmExecFile(["install", "--no-audit", "--no-fund"], {
             cwd: srcDir,
             stdio: "pipe",
             timeout: 120000,
         });
-        execFileSync("npm", ["run", "build"], {
+        npmExecFile(["run", "build"], {
             cwd: srcDir,
             stdio: "pipe",
             timeout: 60000,
@@ -558,7 +578,7 @@ async function upgrade() {
         p.log.info(color.dim("  Registry synced to " + pluginRoot));
         // Install production deps
         s.start("Installing production dependencies");
-        execFileSync("npm", ["install", "--production", "--no-audit", "--no-fund"], {
+        npmExecFile(["install", "--production", "--no-audit", "--no-fund"], {
             cwd: pluginRoot,
             stdio: "pipe",
             timeout: 60000,
@@ -568,7 +588,7 @@ async function upgrade() {
             // Rebuild native addons for current Node.js ABI (fixes #131)
             s.start("Rebuilding native addons");
             try {
-                execFileSync("npm", ["rebuild", "better-sqlite3"], {
+                npmExecFile(["rebuild", "better-sqlite3"], {
                     cwd: pluginRoot,
                     stdio: "pipe",
                     timeout: 60000,
@@ -587,7 +607,7 @@ async function upgrade() {
         // Update global npm
         s.start("Updating npm global package");
         try {
-            execFileSync("npm", ["install", "-g", pluginRoot, "--no-audit", "--no-fund"], {
+            npmExecFile(["install", "-g", pluginRoot, "--no-audit", "--no-fund"], {
                 stdio: "pipe",
                 timeout: 30000,
             });

package/build/server.js

@@ -1700,6 +1700,25 @@ server.registerTool("ctx_upgrade", {
     const pluginRoot = existsSync(resolve(__pkg_dir, "package.json")) ? __pkg_dir : dirname(__pkg_dir);
     const bundlePath = resolve(pluginRoot, "cli.bundle.mjs");
     const fallbackPath = resolve(pluginRoot, "build", "cli.js");
+    // Clean up insight-cache on upgrade so next ctx_insight does fresh build
+    try {
+        const sessDir = getSessionDir();
+        const insightCacheDir = join(dirname(sessDir), "insight-cache");
+        if (existsSync(insightCacheDir)) {
+            // Kill any running insight server first
+            try {
+                if (process.platform === "win32") {
+                    execSync('for /f "tokens=5" %a in (\'netstat -ano ^| findstr :4747\') do taskkill /F /PID %a', { stdio: "pipe" });
+                }
+                else {
+                    execSync("lsof -ti:4747 | xargs kill 2>/dev/null", { stdio: "pipe" });
+                }
+            }
+            catch { /* no process to kill */ }
+            rmSync(insightCacheDir, { recursive: true, force: true });
+        }
+    }
+    catch { /* best effort — don't block upgrade */ }
     let cmd;
     if (existsSync(bundlePath)) {
         cmd = `node "${bundlePath}" upgrade`;
@@ -1726,13 +1745,13 @@ server.registerTool("ctx_upgrade", {
             `console.log("- [x] Starting inline upgrade (no CLI found)");`,
             `execFileSync("git",["clone","--depth","1","${repoUrl}",T],{stdio:"inherit"});`,
             `console.log("- [x] Cloned latest source");`,
-            `execFileSync("npm",["install"],{cwd:T,stdio:"inherit"});`,
-            `execFileSync("npm",["run","build"],{cwd:T,stdio:"inherit"});`,
+            `execFileSync(process.platform==="win32"?"npm.cmd":"npm",["install"],{cwd:T,stdio:"inherit",shell:process.platform==="win32"});`,
+            `execFileSync(process.platform==="win32"?"npm.cmd":"npm",["run","build"],{cwd:T,stdio:"inherit",shell:process.platform==="win32"});`,
             `console.log("- [x] Built from source");`,
             ...copyDirs.map((d) => `if(existsSync(join(T,${JSON.stringify(d)})))cpSync(join(T,${JSON.stringify(d)}),join(P,${JSON.stringify(d)}),{recursive:true,force:true});`),
             ...copyFiles.map((f) => `if(existsSync(join(T,${JSON.stringify(f)})))cpSync(join(T,${JSON.stringify(f)}),join(P,${JSON.stringify(f)}),{force:true});`),
             `console.log("- [x] Copied build artifacts");`,
-            `execFileSync("npm",["install","--production"],{cwd:P,stdio:"inherit"});`,
+            `execFileSync(process.platform==="win32"?"npm.cmd":"npm",["install","--production"],{cwd:P,stdio:"inherit",shell:process.platform==="win32"});`,
             `console.log("- [x] Installed production dependencies");`,
             `console.log("## context-mode upgrade complete");`,
             `}catch(e){`,
@@ -1904,6 +1923,7 @@ server.registerTool("ctx_insight", {
     }
     try {
         const steps = [];
+        let sourceUpdated = false;
         // Ensure cache dir
         mkdirSync(cacheDir, { recursive: true });
         // Copy source files if needed (check by comparing server.mjs mtime)
@@ -1914,13 +1934,14 @@ server.registerTool("ctx_insight", {
             steps.push("Copying source files...");
             cpSync(insightSource, cacheDir, { recursive: true, force: true });
             steps.push("Source files copied.");
+            sourceUpdated = true;
         }
-        // Install deps if needed
+        // Install deps if needed (also reinstall when source updated and package.json may have changed)
         const hasNodeModules = existsSync(join(cacheDir, "node_modules"));
-        if (!hasNodeModules) {
+        if (!hasNodeModules || sourceUpdated) {
             steps.push("Installing dependencies (first run, ~30s)...");
             try {
-                execSync("npm install --production=false", {
+                execSync(process.platform === "win32" ? "npm.cmd install --production=false" : "npm install --production=false", {
                     cwd: cacheDir,
                     stdio: "pipe",
                     timeout: 300000,
@@ -1949,7 +1970,8 @@ server.registerTool("ctx_insight", {
             timeout: 60000,
         });
         steps.push("Build complete.");
-        // Pre-check: is port already in use? (prevents orphan zombie processes)
+        // Pre-check: is port already in use?
+        let portOccupied = false;
         try {
             const { request } = await import("node:http");
             await new Promise((resolve, reject) => {
@@ -1961,9 +1983,29 @@ server.registerTool("ctx_insight", {
                 req.on("timeout", () => { req.destroy(); reject(); });
                 req.end();
             });
-            // If we get here, port is already responding
+            portOccupied = true;
+        }
+        catch {
+            // Port is free, proceed with spawn
+        }
+        if (portOccupied && sourceUpdated) {
+            // Source was updated but stale server is running on port — kill it so fresh code runs
+            steps.push("Killing stale dashboard server (source updated)...");
+            try {
+                if (process.platform === "win32") {
+                    execSync(`for /f "tokens=5" %a in ('netstat -ano ^| findstr :${port}') do taskkill /F /PID %a`, { stdio: "pipe" });
+                }
+                else {
+                    execSync(`lsof -ti:${port} | xargs kill 2>/dev/null`, { stdio: "pipe" });
+                }
+                await new Promise(r => setTimeout(r, 500)); // Wait for port to free
+            }
+            catch { /* no process to kill — proceed anyway */ }
+            steps.push("Stale server killed.");
+        }
+        else if (portOccupied) {
+            // Source unchanged, server is running fine — just open browser
             steps.push("Dashboard already running.");
-            // Open browser anyway
             const url = `http://localhost:${port}`;
             const platform = process.platform;
             try {
@@ -1979,9 +2021,6 @@ server.registerTool("ctx_insight", {
                 content: [{ type: "text", text: `Dashboard already running at http://localhost:${port}` }],
             });
         }
-        catch {
-            // Port is free, proceed with spawn
-        }
         // Kill any previous insight child this MCP spawned (e.g. re-invocation).
         if (_insightChild && _insightChild.pid && !_insightChild.killed) {
             try {

package/build/session/analytics.d.ts

@@ -96,6 +96,16 @@ export interface FullReport {
         compact_count: number;
         resume_ready: boolean;
     };
+    /** Persistent project memory — all events across all sessions */
+    projectMemory: {
+        total_events: number;
+        session_count: number;
+        by_category: Array<{
+            category: string;
+            count: number;
+            label: string;
+        }>;
+    };
 }
 /** Human-readable labels for event categories. */
 export declare const categoryLabels: Record<string, string>;
@@ -155,8 +165,7 @@ export declare class AnalyticsEngine {
  * - Before/After comparison bar is the HERO — one glance = "wow"
  * - "tokens saved" is the number people share
  * - Per-tool breakdown shows what each tool SAVED, sorted by impact
- * - Session memory: one line, reframed as value
+ * - Project memory: category bars showing persistent data across sessions
  * - No: Pct column, category tables, tips, jargon
- * - Under 22 lines for heavy sessions, under 10 for fresh
  */
 export declare function formatReport(report: FullReport, version?: string, latestVersion?: string | null): string;

package/build/session/analytics.js

@@ -199,6 +199,16 @@ export class AnalyticsEngine {
                 : "",
             why: categoryHints[row.category] || "Survives context resets",
         }));
+        // ── Project-wide persistent memory (all sessions, no session_id filter) ──
+        const projectTotals = this.db.prepare("SELECT COUNT(*) as cnt, COUNT(DISTINCT session_id) as sessions FROM session_events").get();
+        const projectByCategory = this.db.prepare("SELECT category, COUNT(*) as cnt FROM session_events GROUP BY category ORDER BY cnt DESC").all();
+        const projectMemoryByCategory = projectByCategory
+            .filter((row) => row.cnt > 0)
+            .map((row) => ({
+            category: row.category,
+            count: row.cnt,
+            label: categoryLabels[row.category] || row.category,
+        }));
         return {
             savings: {
                 processed_kb: Math.round(totalProcessed / 1024 * 10) / 10,
@@ -223,6 +233,11 @@ export class AnalyticsEngine {
                 compact_count: compactCount,
                 resume_ready: resumeReady,
             },
+            projectMemory: {
+                total_events: projectTotals.cnt,
+                session_count: projectTotals.sessions,
+                by_category: projectMemoryByCategory,
+            },
         };
     }
 }
@@ -266,6 +281,24 @@ function dataBar(bytes, maxBytes, width = 40) {
     const filled = Math.max(1, Math.round((bytes / maxBytes) * width));
     return "█".repeat(Math.min(filled, width)) + "░".repeat(Math.max(0, width - filled));
 }
+/**
+ * Render project memory section with category bars.
+ * Shows persistent event data across all sessions.
+ */
+function renderProjectMemory(pm) {
+    if (pm.total_events === 0)
+        return [];
+    const out = [];
+    out.push("");
+    const sessionLabel = pm.session_count === 1 ? "1 session" : `${pm.session_count} sessions`;
+    out.push(`${fmtNum(pm.total_events)} events remembered across ${sessionLabel} \u2014 searchable after compact & restart`);
+    out.push("");
+    const maxCount = pm.by_category.length > 0 ? pm.by_category[0].count : 1;
+    for (const cat of pm.by_category) {
+        out.push(`  ${cat.label.padEnd(18)} ${String(cat.count).padStart(5)}   ${dataBar(cat.count, maxCount, 30)}`);
+    }
+    return out;
+}
 /**
  * Render a FullReport as a visual savings dashboard designed for screenshotting.
  *
@@ -273,9 +306,8 @@ function dataBar(bytes, maxBytes, width = 40) {
  * - Before/After comparison bar is the HERO — one glance = "wow"
  * - "tokens saved" is the number people share
  * - Per-tool breakdown shows what each tool SAVED, sorted by impact
- * - Session memory: one line, reframed as value
+ * - Project memory: category bars showing persistent data across sessions
  * - No: Pct column, category tables, tips, jargon
- * - Under 22 lines for heavy sessions, under 10 for fresh
  */
 export function formatReport(report, version, latestVersion) {
     const lines = [];
@@ -297,6 +329,8 @@ export function formatReport(report, version, latestVersion) {
         else {
             lines.push(`${kb(totalReturned)} entered context  |  0 tokens saved`);
         }
+        // Project memory
+        lines.push(...renderProjectMemory(report.projectMemory));
         // Footer
         lines.push("");
         const versionStr = version ? `v${version}` : "context-mode";
@@ -342,36 +376,8 @@ export function formatReport(report, version, latestVersion) {
             lines.push(`  ${name.padEnd(22)}  ${String(t.calls).padStart(4)} calls  ${kb(t.estimatedSaved).padStart(8)} saved`);
         }
     }
-    // ── Session memory — business-friendly ──
-    if (report.continuity.total_events > 0) {
-        lines.push("");
-        const cats = report.continuity.by_category;
-        // Pick the top 3-4 most impactful categories for a human-readable summary
-        const highlights = [];
-        const fileCount = cats.find(c => c.category === "file")?.count;
-        const gitCount = cats.find(c => c.category === "git")?.count;
-        const promptCount = cats.find(c => c.category === "prompt")?.count;
-        const errorCount = cats.find(c => c.category === "error")?.count;
-        const taskCount = cats.find(c => c.category === "task")?.count;
-        if (fileCount)
-            highlights.push(`${fileCount} files`);
-        if (gitCount)
-            highlights.push(`${gitCount} git ops`);
-        if (promptCount)
-            highlights.push(`${promptCount} prompts`);
-        if (errorCount)
-            highlights.push(`${errorCount} errors`);
-        if (taskCount)
-            highlights.push(`${taskCount} tasks`);
-        const summary = highlights.length > 0 ? `  ·  ${highlights.join(", ")}` : "";
-        if (report.continuity.compact_count > 0) {
-            lines.push(`${fmtNum(report.continuity.total_events)} events remembered across ${report.continuity.compact_count} compaction${report.continuity.compact_count !== 1 ? "s" : ""}${summary}`);
-            lines.push("Zero knowledge lost — picks up exactly where you left off.");
-        }
-        else {
-            lines.push(`${fmtNum(report.continuity.total_events)} events tracked${summary}`);
-        }
-    }
+    // ── Project memory — persistent across sessions ──
+    lines.push(...renderProjectMemory(report.projectMemory));
     // ── Footer ──
     lines.push("");
     const versionStr = version ? `v${version}` : "context-mode";