context-mode 0.7.0 → 0.7.2

package/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
       "name": "context-mode",
       "source": "./",
       "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution in 10 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-      "version": "0.7.0",
+      "version": "0.7.2",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

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

package/README.md

@@ -15,21 +15,25 @@ https://github.com/user-attachments/assets/07013dbf-07c0-4ef1-974a-33ea1207637b
 ## Install
 
 ```bash
-claude mcp add context-mode -- npx -y context-mode
+/plugin marketplace add mksglu/claude-context-mode
+/plugin install context-mode@claude-context-mode
 ```
 
-Restart Claude Code. Done.
+Restart Claude Code. Done. This installs the MCP server + a PreToolUse hook that automatically routes tool outputs through the sandbox + slash commands for diagnostics and upgrades.
+
+| Command | What it does |
+|---|---|
+| `/context-mode:stats` | Show context savings for the current session — per-tool breakdown, tokens consumed, savings ratio. |
+| `/context-mode:doctor` | Run diagnostics — checks runtimes, hooks, FTS5, plugin registration, npm and marketplace versions. |
+| `/context-mode:upgrade` | Pull latest from GitHub, rebuild, migrate cache, fix hooks. |
 
 <details>
-<summary><strong>Plugin install</strong> (includes auto-routing skill + subagent hook)</summary>
+<summary><strong>MCP-only install</strong> (no hooks or slash commands)</summary>
 
 ```bash
-/plugin marketplace add mksglu/claude-context-mode
-/plugin install context-mode@claude-context-mode
+claude mcp add context-mode -- npx -y context-mode
 ```
 
-Installs the MCP server + a skill that automatically routes large outputs through Context Mode + a PreToolUse hook that injects context-mode routing into subagent prompts. No prompting needed.
-
 </details>
 
 <details>
@@ -59,7 +63,6 @@ Code Mode showed that tool definitions can be compressed by 99.9%. Context Mode
 | `index` | Chunk markdown into FTS5 with BM25 ranking. | 60 KB → 40 B |
 | `search` | Query indexed content with multiple queries in one call. | On-demand retrieval |
 | `fetch_and_index` | Fetch URL, convert to markdown, index. | 60 KB → 40 B |
-| `stats` | Session token tracking with per-tool breakdown. | — |
 
 ## How the Sandbox Works
 
@@ -181,16 +184,6 @@ Fetch the React useEffect docs, index them, and find the cleanup pattern
 with code examples. Then run /context-mode:stats.
 ```
 
-## Slash Commands
-
-Available when installed as a plugin:
-
-| Command | What it does |
-|---|---|
-| `/context-mode:stats` | Show context savings for the current session — per-tool breakdown, tokens consumed, savings ratio. |
-| `/context-mode:doctor` | Run diagnostics — checks runtimes, hooks, FTS5, plugin registration, npm and marketplace versions. |
-| `/context-mode:upgrade` | Pull latest from GitHub, rebuild, reinstall plugin, update npm global, fix hooks. |
-
 ## Requirements
 
 - **Node.js 18+**

package/build/cli.js

@@ -301,7 +301,7 @@ async function doctor() {
 async function upgrade() {
     console.clear();
     p.intro(color.bgCyan(color.black(" context-mode upgrade ")));
-    const pluginRoot = getPluginRoot();
+    let pluginRoot = getPluginRoot();
     const settingsPath = getSettingsPath();
     const changes = [];
     const s = p.spinner();
@@ -358,6 +358,23 @@ async function upgrade() {
             timeout: 60000,
         });
         s.stop("Dependencies ready");
+        // Step 2.5: Migrate versioned cache directory if version changed
+        const cacheMatch = pluginRoot.match(/^(.*\/plugins\/cache\/[^/]+\/[^/]+\/)(\d+\.\d+\.\d+[^/]*)$/);
+        if (cacheMatch && newVersion !== cacheMatch[2] && newVersion !== "unknown") {
+            const oldDirVersion = cacheMatch[2];
+            const newCacheDir = cacheMatch[1] + newVersion;
+            s.start(`Migrating cache: ${oldDirVersion} → ${newVersion}`);
+            try {
+                execSync(`rm -rf "${newCacheDir}"`, { stdio: "pipe" });
+                execSync(`mv "${pluginRoot}" "${newCacheDir}"`, { stdio: "pipe" });
+                pluginRoot = newCacheDir;
+                s.stop(color.green(`Cache directory: ${newVersion}`));
+                changes.push(`Migrated cache: ${oldDirVersion} → ${newVersion}`);
+            }
+            catch {
+                s.stop(color.yellow("Cache migration skipped — using existing directory"));
+            }
+        }
         // Update global npm package from same GitHub source
         s.start("Updating npm global package");
         try {
@@ -406,7 +423,7 @@ async function upgrade() {
     }
     // Step 4: Fix hooks
     p.log.step("Configuring PreToolUse hooks...");
-    const hookScriptPath = getHookScriptPath();
+    const hookScriptPath = resolve(pluginRoot, "hooks", "pretooluse.sh");
     const settings = readSettings() ?? {};
     const desiredHookEntry = {
         matcher: "Bash|Read|Grep|Glob|WebFetch|WebSearch|Task",

package/build/server.js

@@ -3,9 +3,9 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { PolyglotExecutor } from "./executor.js";
-import { ContentStore } from "./store.js";
+import { ContentStore, cleanupStaleDBs } from "./store.js";
 import { detectRuntimes, getRuntimeSummary, getAvailableLanguages, hasBunRuntime, } from "./runtime.js";
-const VERSION = "0.5.26";
+const VERSION = "0.7.2";
 const runtimes = detectRuntimes();
 const available = getAvailableLanguages(runtimes);
 const server = new McpServer({
@@ -975,6 +975,19 @@ server.registerTool("stats", {
 // Server startup
 // ─────────────────────────────────────────────────────────
 async function main() {
+    // Clean up stale DB files from previous sessions
+    const cleaned = cleanupStaleDBs();
+    if (cleaned > 0) {
+        console.error(`Cleaned up ${cleaned} stale DB file(s) from previous sessions`);
+    }
+    // Clean up own DB on shutdown
+    const shutdown = () => {
+        if (_store)
+            _store.cleanup();
+    };
+    process.on("exit", shutdown);
+    process.on("SIGINT", () => { shutdown(); process.exit(0); });
+    process.on("SIGTERM", () => { shutdown(); process.exit(0); });
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error(`Context Mode MCP server v${VERSION} running on stdio`);

package/build/store.d.ts

@@ -26,9 +26,15 @@ export interface StoreStats {
     chunks: number;
     codeChunks: number;
 }
+/**
+ * Remove stale DB files from previous sessions whose processes no longer exist.
+ */
+export declare function cleanupStaleDBs(): number;
 export declare class ContentStore {
     #private;
     constructor(dbPath?: string);
+    /** Delete this session's DB files. Call on process exit. */
+    cleanup(): void;
     index(options: {
         content?: string;
         path?: string;

package/build/store.js

@@ -8,7 +8,7 @@
  * you need EXACT text later — not summaries.
  */
 import { createRequire } from "node:module";
-import { readFileSync } from "node:fs";
+import { readFileSync, readdirSync, unlinkSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 // Lazy-load better-sqlite3 — only when ContentStore is first used.
@@ -90,16 +90,64 @@ function maxEditDistance(wordLength) {
 // ─────────────────────────────────────────────────────────
 // ContentStore
 // ─────────────────────────────────────────────────────────
+/**
+ * Remove stale DB files from previous sessions whose processes no longer exist.
+ */
+export function cleanupStaleDBs() {
+    const dir = tmpdir();
+    let cleaned = 0;
+    try {
+        const files = readdirSync(dir);
+        for (const file of files) {
+            const match = file.match(/^context-mode-(\d+)\.db$/);
+            if (!match)
+                continue;
+            const pid = parseInt(match[1], 10);
+            if (pid === process.pid)
+                continue;
+            try {
+                process.kill(pid, 0);
+            }
+            catch {
+                const base = join(dir, file);
+                for (const suffix of ["", "-wal", "-shm"]) {
+                    try {
+                        unlinkSync(base + suffix);
+                    }
+                    catch { /* ignore */ }
+                }
+                cleaned++;
+            }
+        }
+    }
+    catch { /* ignore readdir errors */ }
+    return cleaned;
+}
 export class ContentStore {
     #db;
+    #dbPath;
     constructor(dbPath) {
         const Database = loadDatabase();
-        const path = dbPath ?? join(tmpdir(), `context-mode-${process.pid}.db`);
-        this.#db = new Database(path, { timeout: 5000 });
+        this.#dbPath =
+            dbPath ?? join(tmpdir(), `context-mode-${process.pid}.db`);
+        this.#db = new Database(this.#dbPath, { timeout: 5000 });
         this.#db.pragma("journal_mode = WAL");
         this.#db.pragma("synchronous = NORMAL");
         this.#initSchema();
     }
+    /** Delete this session's DB files. Call on process exit. */
+    cleanup() {
+        try {
+            this.#db.close();
+        }
+        catch { /* ignore */ }
+        for (const suffix of ["", "-wal", "-shm"]) {
+            try {
+                unlinkSync(this.#dbPath + suffix);
+            }
+            catch { /* ignore */ }
+        }
+    }
     // ── Schema ──
     #initSchema() {
         this.#db.exec(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "description": "Claude Code MCP plugin that saves 98% of your context window. Sandboxed code execution, FTS5 knowledge base, and intent-driven search.",
   "author": "Mert Koseoğlu",