context-mode 1.0.79 → 1.0.81

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

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

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.79",
+  "version": "1.0.81",
   "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.js

@@ -93,6 +93,9 @@ else if (args[0] === "upgrade") {
 else if (args[0] === "hook") {
     hookDispatch(args[1], args[2]);
 }
+else if (args[0] === "insight") {
+    insight(args[1] ? Number(args[1]) : 4747);
+}
 else {
     // Default: start MCP server
     import("./server.js");
@@ -353,6 +356,60 @@ async function doctor() {
         : color.yellow("Some checks need attention — see above for details"));
     return 0;
 }
+/* -------------------------------------------------------
+ * Insight — analytics dashboard
+ * ------------------------------------------------------- */
+async function insight(port) {
+    const { execSync, spawn } = await import("node:child_process");
+    const { statSync, mkdirSync, cpSync } = await import("node:fs");
+    const insightSource = resolve(__dirname, "insight");
+    // Adapter-agnostic cache: use ~/.claude/context-mode/insight-cache as default
+    // (matches server.ts pattern but CLI doesn't have adapter detection)
+    const cacheDir = join(homedir(), ".claude", "context-mode", "insight-cache");
+    if (!existsSync(join(insightSource, "server.mjs"))) {
+        console.error("Error: Insight source not found. Try upgrading context-mode.");
+        process.exit(1);
+    }
+    mkdirSync(cacheDir, { recursive: true });
+    // Copy source if newer
+    const srcMtime = statSync(join(insightSource, "server.mjs")).mtimeMs;
+    const cacheMtime = existsSync(join(cacheDir, "server.mjs"))
+        ? statSync(join(cacheDir, "server.mjs")).mtimeMs : 0;
+    if (srcMtime > cacheMtime) {
+        console.log("Copying Insight source...");
+        cpSync(insightSource, cacheDir, { recursive: true, force: true });
+    }
+    // Install deps
+    if (!existsSync(join(cacheDir, "node_modules"))) {
+        console.log("Installing dependencies (first run)...");
+        execSync("npm install --production=false", { cwd: cacheDir, stdio: "inherit", timeout: 120000 });
+    }
+    // Build
+    console.log("Building dashboard...");
+    execSync("npx vite build", { cwd: cacheDir, stdio: "pipe", timeout: 30000 });
+    // Start server
+    const url = `http://localhost:${port}`;
+    console.log(`\n  context-mode Insight\n  ${url}\n`);
+    const child = spawn("node", [join(cacheDir, "server.mjs")], {
+        cwd: cacheDir,
+        env: { ...process.env, PORT: String(port) },
+        stdio: "inherit",
+    });
+    // Open browser
+    const platform = process.platform;
+    try {
+        if (platform === "darwin")
+            execSync(`open "${url}"`, { stdio: "pipe" });
+        else if (platform === "win32")
+            execSync(`start "" "${url}"`, { stdio: "pipe" });
+        else
+            execSync(`xdg-open "${url}" 2>/dev/null || sensible-browser "${url}" 2>/dev/null`, { stdio: "pipe" });
+    }
+    catch { /* best effort */ }
+    // Keep alive until Ctrl+C
+    process.on("SIGINT", () => { child.kill(); process.exit(0); });
+    process.on("SIGTERM", () => { child.kill(); process.exit(0); });
+}
 /* -------------------------------------------------------
  * Upgrade — adapter-aware hook configuration
  * ------------------------------------------------------- */

package/build/server.js

@@ -3,7 +3,8 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createRequire } from "node:module";
 import { createHash } from "node:crypto";
-import { existsSync, unlinkSync, readdirSync, readFileSync, writeFileSync, rmSync, mkdirSync } from "node:fs";
+import { existsSync, unlinkSync, readdirSync, readFileSync, writeFileSync, rmSync, mkdirSync, cpSync, statSync } from "node:fs";
+import { execSync } from "node:child_process";
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir, tmpdir } from "node:os";
@@ -1853,6 +1854,98 @@ server.registerTool("ctx_purge", {
             }],
     });
 });
+// ── ctx-insight: analytics dashboard ──────────────────────────────────────────
+server.registerTool("ctx_insight", {
+    title: "Open Insight Dashboard",
+    description: "Opens the context-mode Insight dashboard in the browser. " +
+        "Shows personal analytics: session activity, tool usage, error rate, " +
+        "parallel work patterns, project focus, and actionable insights. " +
+        "First run installs dependencies (~30s). Subsequent runs open instantly.",
+    inputSchema: z.object({
+        port: z.number().optional().describe("Port to serve on (default: 4747)"),
+    }),
+}, async ({ port: userPort }) => {
+    const port = userPort || 4747;
+    const insightSource = resolve(__pkg_dir, "insight");
+    // Use adapter-aware path: derive from sessions dir (works across all 12 adapters)
+    const sessDir = getSessionDir();
+    const cacheDir = join(dirname(sessDir), "insight-cache");
+    // Verify source exists
+    if (!existsSync(join(insightSource, "server.mjs"))) {
+        return trackResponse("ctx_insight", {
+            content: [{ type: "text", text: "Error: Insight source not found in plugin. Try upgrading context-mode." }],
+        });
+    }
+    try {
+        const steps = [];
+        // Ensure cache dir
+        mkdirSync(cacheDir, { recursive: true });
+        // Copy source files if needed (check by comparing server.mjs mtime)
+        const srcMtime = statSync(join(insightSource, "server.mjs")).mtimeMs;
+        const cacheMtime = existsSync(join(cacheDir, "server.mjs"))
+            ? statSync(join(cacheDir, "server.mjs")).mtimeMs : 0;
+        if (srcMtime > cacheMtime) {
+            steps.push("Copying source files...");
+            cpSync(insightSource, cacheDir, { recursive: true, force: true });
+            steps.push("Source files copied.");
+        }
+        // Install deps if needed
+        const hasNodeModules = existsSync(join(cacheDir, "node_modules"));
+        if (!hasNodeModules) {
+            steps.push("Installing dependencies (first run, ~30s)...");
+            execSync("npm install --production=false", {
+                cwd: cacheDir,
+                stdio: "pipe",
+                timeout: 120000,
+            });
+            steps.push("Dependencies installed.");
+        }
+        // Build
+        steps.push("Building dashboard...");
+        execSync("npx vite build", {
+            cwd: cacheDir,
+            stdio: "pipe",
+            timeout: 30000,
+        });
+        steps.push("Build complete.");
+        // Start server in background
+        const { spawn } = await import("node:child_process");
+        const child = spawn("node", [join(cacheDir, "server.mjs")], {
+            cwd: cacheDir,
+            env: { ...process.env, PORT: String(port) },
+            detached: true,
+            stdio: "ignore",
+        });
+        child.unref();
+        // Wait for server to be ready
+        await new Promise(r => setTimeout(r, 1500));
+        // Open browser (cross-platform)
+        const url = `http://localhost:${port}`;
+        const platform = process.platform;
+        try {
+            if (platform === "darwin")
+                execSync(`open "${url}"`, { stdio: "pipe" });
+            else if (platform === "win32")
+                execSync(`start "" "${url}"`, { stdio: "pipe" });
+            else
+                execSync(`xdg-open "${url}" 2>/dev/null || sensible-browser "${url}" 2>/dev/null`, { stdio: "pipe" });
+        }
+        catch { /* browser open is best-effort */ }
+        steps.push(`Dashboard running at ${url}`);
+        return trackResponse("ctx_insight", {
+            content: [{
+                    type: "text",
+                    text: steps.map(s => `- ${s}`).join("\n") + `\n\nOpen: ${url}\nPID: ${child.pid} · Stop: kill ${child.pid}`,
+                }],
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return trackResponse("ctx_insight", {
+            content: [{ type: "text", text: `Insight setup failed: ${msg}` }],
+        });
+    }
+});
 // ─────────────────────────────────────────────────────────
 // Server startup
 // ─────────────────────────────────────────────────────────

package/build/store.js

@@ -41,7 +41,12 @@ function sanitizeQuery(query, mode = "AND") {
         !["AND", "OR", "NOT", "NEAR"].includes(w.toUpperCase()));
     if (words.length === 0)
         return '""';
-    return words.map((w) => `"${w}"`).join(mode === "OR" ? " OR " : " ");
+    // Filter stopwords to improve BM25 ranking — common terms like "update",
+    // "test", "fix" appear everywhere and dilute relevance scoring.
+    // Fall back to unfiltered words if ALL terms are stopwords.
+    const meaningful = words.filter((w) => !STOPWORDS.has(w.toLowerCase()));
+    const final = meaningful.length > 0 ? meaningful : words;
+    return final.map((w) => `"${w}"`).join(mode === "OR" ? " OR " : " ");
 }
 function sanitizeTrigramQuery(query, mode = "AND") {
     const cleaned = query.replace(/["'(){}[\]*:^~]/g, "").trim();
@@ -50,7 +55,9 @@ function sanitizeTrigramQuery(query, mode = "AND") {
     const words = cleaned.split(/\s+/).filter((w) => w.length >= 3);
     if (words.length === 0)
         return "";
-    return words.map((w) => `"${w}"`).join(mode === "OR" ? " OR " : " ");
+    const meaningful = words.filter((w) => !STOPWORDS.has(w.toLowerCase()));
+    const final = meaningful.length > 0 ? meaningful : words;
+    return final.map((w) => `"${w}"`).join(mode === "OR" ? " OR " : " ");
 }
 function levenshtein(a, b) {
     if (a.length === 0)
@@ -264,6 +271,10 @@ export class ContentStore {
     #stmtChunkContent;
     #stmtStats;
     #stmtSourceMeta;
+    // Cleanup path
+    #stmtCleanupChunks;
+    #stmtCleanupChunksTrigram;
+    #stmtCleanupSources;
     // FTS5 optimization: track inserts and optimize periodically to defragment
     // the index. FTS5 b-trees fragment over many insert/delete cycles, degrading
     // search performance. SQLite's built-in 'optimize' merges b-tree segments.
@@ -547,6 +558,10 @@ export class ContentStore {
         (SELECT COUNT(*) FROM chunks) AS chunks,
         (SELECT COUNT(*) FROM chunks WHERE content_type = 'code') AS codeChunks
     `);
+        // Cleanup path — cached to avoid recompiling SQL on each periodic call
+        this.#stmtCleanupChunks = this.#db.prepare("DELETE FROM chunks WHERE source_id IN (SELECT id FROM sources WHERE datetime(indexed_at) < datetime('now', '-' || ? || ' days'))");
+        this.#stmtCleanupChunksTrigram = this.#db.prepare("DELETE FROM chunks_trigram WHERE source_id IN (SELECT id FROM sources WHERE datetime(indexed_at) < datetime('now', '-' || ? || ' days'))");
+        this.#stmtCleanupSources = this.#db.prepare("DELETE FROM sources WHERE datetime(indexed_at) < datetime('now', '-' || ? || ' days')");
     }
     // ── Index ──
     index(options) {
@@ -768,10 +783,14 @@ export class ContentStore {
     }
     // ── Proximity Reranking ──
     #applyProximityReranking(results, query) {
-        const terms = query
+        const allTerms = query
             .toLowerCase()
             .split(/\s+/)
             .filter((w) => w.length >= 2);
+        // Exclude stopwords from proximity/title scoring — they match everywhere
+        // and inflate boosts for irrelevant chunks. Keep all terms as fallback.
+        const filtered = allTerms.filter((w) => !STOPWORDS.has(w));
+        const terms = filtered.length > 0 ? filtered : allTerms;
         return results
             .map((r) => {
             // Title-match boost: query terms found in the chunk title get a boost.
@@ -806,11 +825,13 @@ export class ContentStore {
             return reranked.map((r) => ({ ...r, matchLayer: "rrf" }));
         }
         // Step 2: Fuzzy correction → RRF re-run
+        // Skip stopwords — they'll be filtered by sanitizeQuery anyway, and each
+        // fuzzyCorrect call hits the vocab DB + runs levenshtein comparisons.
         const words = query
             .toLowerCase()
             .trim()
             .split(/\s+/)
-            .filter((w) => w.length >= 3);
+            .filter((w) => w.length >= 3 && !STOPWORDS.has(w));
         const original = words.join(" ");
         const correctedWords = words.map((w) => this.fuzzyCorrect(w) ?? w);
         const correctedQuery = correctedWords.join(" ");
@@ -898,13 +919,10 @@ export class ContentStore {
      * Returns count of deleted sources.
      */
     cleanupStaleSources(maxAgeDays) {
-        const deleteChunks = this.#db.prepare("DELETE FROM chunks WHERE source_id IN (SELECT id FROM sources WHERE datetime(indexed_at) < datetime('now', '-' || ? || ' days'))");
-        const deleteChunksTrigram = this.#db.prepare("DELETE FROM chunks_trigram WHERE source_id IN (SELECT id FROM sources WHERE datetime(indexed_at) < datetime('now', '-' || ? || ' days'))");
-        const deleteSources = this.#db.prepare("DELETE FROM sources WHERE datetime(indexed_at) < datetime('now', '-' || ? || ' days')");
         const cleanup = this.#db.transaction((days) => {
-            deleteChunks.run(days);
-            deleteChunksTrigram.run(days);
-            return deleteSources.run(days);
+            this.#stmtCleanupChunks.run(days);
+            this.#stmtCleanupChunksTrigram.run(days);
+            return this.#stmtCleanupSources.run(days);
         });
         const info = cleanup(maxAgeDays);
         return info.changes;