context-mode 1.0.75 → 1.0.76

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.75",
+  "version": "1.0.76",
   "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/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "context-mode": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/start.mjs"]
+      "args": ["./start.mjs"]
     }
   }
 }

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

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.75",
+  "version": "1.0.76",
   "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/README.md

@@ -4,6 +4,30 @@
 
 [![users](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fgh%2Fmksglu%2Fcontext-mode%40main%2Fstats.json&query=%24.message&label=users&color=brightgreen)](https://www.npmjs.com/package/context-mode) [![npm](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fgh%2Fmksglu%2Fcontext-mode%40main%2Fstats.json&query=%24.npm&label=npm&color=blue)](https://www.npmjs.com/package/context-mode) [![marketplace](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fgh%2Fmksglu%2Fcontext-mode%40main%2Fstats.json&query=%24.marketplace&label=marketplace&color=blue)](https://github.com/mksglu/context-mode) [![GitHub stars](https://img.shields.io/github/stars/mksglu/context-mode?style=flat&color=yellow)](https://github.com/mksglu/context-mode/stargazers) [![GitHub forks](https://img.shields.io/github/forks/mksglu/context-mode?style=flat&color=blue)](https://github.com/mksglu/context-mode/network/members) [![Last commit](https://img.shields.io/github/last-commit/mksglu/context-mode?color=green)](https://github.com/mksglu/context-mode/commits) [![License: ELv2](https://img.shields.io/badge/License-ELv2-blue.svg)](LICENSE)
 [![Discord](https://img.shields.io/discord/1478479412700909750?label=Discord&logo=discord&color=5865f2)](https://discord.gg/DCN9jUgN5v)
+[![Hacker News #1](https://img.shields.io/badge/Hacker%20News-%231%20%E2%80%A2%20570%2B%20points-ff6600?logo=ycombinator&logoColor=white)](https://news.ycombinator.com/item?id=47193064)
+
+<p align="center">
+<sub>Used across teams at</sub>
+<br><br>
+<a href="#"><img src="https://img.shields.io/badge/Microsoft-141414?style=flat" alt="Microsoft" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Google-141414?style=flat&logo=google&logoColor=white" alt="Google" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Meta-141414?style=flat&logo=meta&logoColor=white" alt="Meta" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Amazon-141414?style=flat" alt="Amazon" /></a>
+<a href="#"><img src="https://img.shields.io/badge/IBM-141414?style=flat" alt="IBM" /></a>
+<a href="#"><img src="https://img.shields.io/badge/NVIDIA-141414?style=flat&logo=nvidia&logoColor=white" alt="NVIDIA" /></a>
+<a href="#"><img src="https://img.shields.io/badge/ByteDance-141414?style=flat&logo=bytedance&logoColor=white" alt="ByteDance" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Stripe-141414?style=flat&logo=stripe&logoColor=white" alt="Stripe" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Datadog-141414?style=flat&logo=datadog&logoColor=white" alt="Datadog" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Salesforce-141414?style=flat" alt="Salesforce" /></a>
+<a href="#"><img src="https://img.shields.io/badge/GitHub-141414?style=flat&logo=github&logoColor=white" alt="GitHub" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Red%20Hat-141414?style=flat&logo=redhat&logoColor=white" alt="Red Hat" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Supabase-141414?style=flat&logo=supabase&logoColor=white" alt="Supabase" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Canva-141414?style=flat" alt="Canva" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Notion-141414?style=flat&logo=notion&logoColor=white" alt="Notion" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Hasura-141414?style=flat&logo=hasura&logoColor=white" alt="Hasura" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Framer-141414?style=flat&logo=framer&logoColor=white" alt="Framer" /></a>
+<a href="#"><img src="https://img.shields.io/badge/Cursor-141414?style=flat&logo=cursor&logoColor=white" alt="Cursor" /></a>
+</p>
 
 ## The Problem
 
@@ -16,8 +40,11 @@ Context Mode is an MCP server that solves all three sides of this problem:
 3. **Think in Code** — The LLM should program the analysis, not compute it. Instead of reading 50 files into context to count functions, the agent writes a script that does the counting and `console.log()`s only the result. One script replaces ten tool calls and saves 100x context. This is a mandatory paradigm across all 12 platforms: stop treating the LLM as a data processor, treat it as a code generator.
 
 <a href="https://www.youtube.com/watch?v=QUHrntlfPo4">
-  <img src="https://img.youtube.com/vi/QUHrntlfPo4/maxresdefault.jpg" alt="context-mode demo" width="100%">
+  <picture>
+    <img src="https://img.youtube.com/vi/QUHrntlfPo4/maxresdefault.jpg" alt="Watch context-mode demo on YouTube" width="100%">
+  </picture>
 </a>
+<p align="center"><a href="https://www.youtube.com/watch?v=QUHrntlfPo4"><img src="https://img.shields.io/badge/%E2%96%B6%EF%B8%8F_Watch_Demo-YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white" alt="Watch on YouTube"></a></p>
 
 ## Install
 
@@ -257,6 +284,8 @@ Full hook config including PreCompact: [`configs/vscode-copilot/hooks.json`](con
 
 **Routing:** Hooks enforce routing programmatically via `preToolUse`/`postToolUse`/`stop`. The `.cursor/rules/context-mode.mdc` file provides routing instructions at session start since Cursor's `sessionStart` hook is currently rejected by their validator ([forum report](https://forum.cursor.com/t/unknown-hook-type-sessionstart/149566)). Project `.cursor/hooks.json` overrides `~/.cursor/hooks.json`.
 
+**Known limitation:** Cursor accepts `additional_context` in hook responses but does not surface it to the model ([forum #155689](https://forum.cursor.com/t/native-posttooluse-hooks-accept-and-log-additional-context-successfully-but-the-injected-context-is-not-surfaced-to-the-model/155689)). Routing relies on the `.mdc` rules file instead of hook context injection.
+
 Full configs: [`configs/cursor/hooks.json`](configs/cursor/hooks.json) | [`configs/cursor/mcp.json`](configs/cursor/mcp.json) | [`configs/cursor/context-mode.mdc`](configs/cursor/context-mode.mdc)
 
 </details>
@@ -645,6 +674,8 @@ Full configs: [`configs/kiro/mcp.json`](configs/kiro/mcp.json) | [`configs/kiro/
 
 Context Mode uses [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) on Node.js, which ships prebuilt native binaries for most platforms. On glibc >= 2.31 systems (Ubuntu 20.04+, Debian 11+, Fedora 34+, macOS, Windows), `npm install` works without any build tools.
 
+**Linux + Node.js >= 22.13:** Context Mode automatically uses the built-in `node:sqlite` module instead of `better-sqlite3`. This eliminates the native addon entirely, avoiding [sporadic SIGSEGV crashes](https://github.com/nodejs/node/issues/62515) caused by V8's `madvise(MADV_DONTNEED)` corrupting the addon's `.got.plt` section on Linux. No configuration needed — detection is automatic. Falls back to `better-sqlite3` on older Node.js versions.
+
 **Bun users:** No native compilation needed. Context Mode automatically detects Bun and uses the built-in `bun:sqlite` module via a compatibility adapter. `better-sqlite3` and all its build dependencies are skipped entirely.
 
 On older glibc systems (CentOS 7/8, RHEL 8, Debian 10), prebuilt binaries don't load and better-sqlite3 **automatically falls back to compiling from source** via `prebuild-install || node-gyp rebuild --release`. This requires a C++20 compiler (GCC 10+), Make, and Python with setuptools.
@@ -703,7 +734,7 @@ When output exceeds 5 KB and an `intent` is provided, Context Mode switches to i
 
 ## How the Knowledge Base Works
 
-The `ctx_index` tool chunks markdown content by headings while keeping code blocks intact, then stores them in a **SQLite FTS5** (Full-Text Search 5) virtual table. Search uses **BM25 ranking** — a probabilistic relevance algorithm that scores documents based on term frequency, inverse document frequency, and document length normalization. **Porter stemming** is applied at index time so "running", "runs", and "ran" match the same stem. Titles and headings are weighted **5x** in BM25 scoring for precise navigational queries.
+The `ctx_index` tool chunks markdown content by headings while keeping code blocks intact, then stores them in a **SQLite FTS5** (Full-Text Search 5) virtual table. The SQLite backend is selected automatically at runtime: `bun:sqlite` on Bun, `node:sqlite` on Linux + Node.js >= 22.13, and `better-sqlite3` everywhere else. Search uses **BM25 ranking** — a probabilistic relevance algorithm that scores documents based on term frequency, inverse document frequency, and document length normalization. **Porter stemming** is applied at index time so "running", "runs", and "ran" match the same stem. Titles and headings are weighted **5x** in BM25 scoring for precise navigational queries.
 
 When you call `ctx_search`, it returns relevant content snippets focused around matching query terms — not full documents, not approximations, the actual indexed content with smart extraction around what you're looking for. `ctx_fetch_and_index` extends this to URLs: fetch, convert HTML to markdown, chunk, index. The raw page never enters context. Use the `contentType` parameter to filter results by type (e.g. `code` or `prose`).
 

package/build/adapters/claude-code/hooks.d.ts

@@ -25,12 +25,22 @@ export declare const HOOK_TYPES: {
 };
 export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
 /** Tools that context-mode's PreToolUse hook intercepts. */
-export declare const PRE_TOOL_USE_MATCHERS: readonly ["Bash", "WebFetch", "Read", "Grep", "Agent", "Task", "mcp__plugin_context-mode_context-mode__ctx_execute", "mcp__plugin_context-mode_context-mode__ctx_execute_file", "mcp__plugin_context-mode_context-mode__ctx_batch_execute"];
+export declare const PRE_TOOL_USE_MATCHERS: readonly ["Bash", "WebFetch", "Read", "Grep", "Agent", "mcp__plugin_context-mode_context-mode__ctx_execute", "mcp__plugin_context-mode_context-mode__ctx_execute_file", "mcp__plugin_context-mode_context-mode__ctx_batch_execute"];
 /**
  * Combined matcher pattern for settings.json (pipe-separated).
  * Used by the upgrade command when writing a single consolidated entry.
  */
 export declare const PRE_TOOL_USE_MATCHER_PATTERN: string;
+/**
+ * Tools that context-mode's PostToolUse hook should fire on.
+ * Only tools that extractEvents() actually handles — all others
+ * produce zero events and cause false "hook error" display.
+ */
+export declare const POST_TOOL_USE_MATCHERS: readonly ["Bash", "Read", "Write", "Edit", "NotebookEdit", "Glob", "Grep", "TodoWrite", "TaskCreate", "TaskUpdate", "EnterPlanMode", "ExitPlanMode", "Skill", "Agent", "AskUserQuestion", "EnterWorktree", "mcp__"];
+/**
+ * Combined matcher pattern for PostToolUse in hooks.json / settings.json.
+ */
+export declare const POST_TOOL_USE_MATCHER_PATTERN: string;
 /** Map of hook types to their script file names. */
 export declare const HOOK_SCRIPTS: Record<HookType, string>;
 /** Required hooks that must be configured for context-mode to function. */

package/build/adapters/claude-code/hooks.js

@@ -36,7 +36,6 @@ export const PRE_TOOL_USE_MATCHERS = [
     "Read",
     "Grep",
     "Agent",
-    "Task",
     "mcp__plugin_context-mode_context-mode__ctx_execute",
     "mcp__plugin_context-mode_context-mode__ctx_execute_file",
     "mcp__plugin_context-mode_context-mode__ctx_batch_execute",
@@ -47,6 +46,37 @@ export const PRE_TOOL_USE_MATCHERS = [
  */
 export const PRE_TOOL_USE_MATCHER_PATTERN = PRE_TOOL_USE_MATCHERS.join("|");
 // ─────────────────────────────────────────────────────────
+// PostToolUse matchers (#229)
+// ─────────────────────────────────────────────────────────
+/**
+ * Tools that context-mode's PostToolUse hook should fire on.
+ * Only tools that extractEvents() actually handles — all others
+ * produce zero events and cause false "hook error" display.
+ */
+export const POST_TOOL_USE_MATCHERS = [
+    "Bash",
+    "Read",
+    "Write",
+    "Edit",
+    "NotebookEdit",
+    "Glob",
+    "Grep",
+    "TodoWrite",
+    "TaskCreate",
+    "TaskUpdate",
+    "EnterPlanMode",
+    "ExitPlanMode",
+    "Skill",
+    "Agent",
+    "AskUserQuestion",
+    "EnterWorktree",
+    "mcp__",
+];
+/**
+ * Combined matcher pattern for PostToolUse in hooks.json / settings.json.
+ */
+export const POST_TOOL_USE_MATCHER_PATTERN = POST_TOOL_USE_MATCHERS.join("|");
+// ─────────────────────────────────────────────────────────
 // Hook script file names
 // ─────────────────────────────────────────────────────────
 /** Map of hook types to their script file names. */

package/build/db-base.d.ts

@@ -34,10 +34,25 @@ export declare class BunSQLiteAdapter {
     transaction(fn: (...args: any[]) => any): any;
     close(): void;
 }
+/**
+ * Wraps node:sqlite's DatabaseSync to provide better-sqlite3-compatible API.
+ * Bridges: .pragma(), .transaction(). Everything else is passthrough.
+ * Eliminates native addon SIGSEGV on Linux (nodejs/node#62515).
+ */
+export declare class NodeSQLiteAdapter {
+    #private;
+    constructor(rawDb: any);
+    pragma(source: string): any;
+    exec(sql: string): any;
+    prepare(sql: string): any;
+    transaction(fn: (...args: any[]) => any): any;
+    close(): void;
+}
 /**
  * Lazy-load the SQLite driver for the current runtime.
  * Bun → bun:sqlite via BunSQLiteAdapter (issue #45).
- * Node → better-sqlite3 (native addon).
+ * Linux Node → node:sqlite via NodeSQLiteAdapter (issue #228).
+ * Other Node → better-sqlite3 (native addon).
  */
 export declare function loadDatabase(): typeof DatabaseConstructor;
 /**
@@ -51,6 +66,12 @@ export declare function loadDatabase(): typeof DatabaseConstructor;
  * transaction.
  */
 export declare function applyWALPragmas(db: DatabaseInstance): void;
+/**
+ * Remove orphaned WAL/SHM files when the main DB file doesn't exist.
+ * On Windows, stale -wal/-shm files from crashed processes cause
+ * "file is not a database" errors when creating a fresh DB.
+ */
+export declare function cleanOrphanedWALFiles(dbPath: string): void;
 /**
  * Delete all three SQLite files for a given db path (main, WAL, SHM).
  * Silently ignores individual deletion errors so a partial cleanup
@@ -76,6 +97,16 @@ export declare function defaultDBPath(prefix?: string): string;
  * Pass custom delays for testing (e.g., [0, 0, 0] to skip waits).
  */
 export declare function withRetry<T>(fn: () => T, delays?: number[]): T;
+/**
+ * Detect SQLite corruption errors that warrant a rename-and-recreate.
+ * Matches SQLITE_CORRUPT, SQLITE_NOTADB, and their human-readable equivalents.
+ */
+export declare function isSQLiteCorruptionError(msg: string): boolean;
+/**
+ * Rename a corrupt DB and its WAL/SHM files so a fresh DB can be created.
+ * Best-effort — individual rename failures are silently ignored.
+ */
+export declare function renameCorruptDB(dbPath: string): void;
 export declare abstract class SQLiteBase {
     #private;
     constructor(dbPath: string);

package/build/db-base.js

@@ -6,7 +6,7 @@
  * ContentStore and SessionDB build on top of these primitives.
  */
 import { createRequire } from "node:module";
-import { unlinkSync } from "node:fs";
+import { existsSync, unlinkSync, renameSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 // ─────────────────────────────────────────────────────────
@@ -84,13 +84,82 @@ export class BunSQLiteAdapter {
     }
 }
 // ─────────────────────────────────────────────────────────
+// node:sqlite adapter (#228)
+// ─────────────────────────────────────────────────────────
+/**
+ * Wraps node:sqlite's DatabaseSync to provide better-sqlite3-compatible API.
+ * Bridges: .pragma(), .transaction(). Everything else is passthrough.
+ * Eliminates native addon SIGSEGV on Linux (nodejs/node#62515).
+ */
+export class NodeSQLiteAdapter {
+    #raw; // DatabaseSync instance
+    constructor(rawDb) {
+        this.#raw = rawDb;
+    }
+    pragma(source) {
+        // "journal_mode = WAL" → PRAGMA journal_mode = WAL
+        // "table_xinfo(session_events)" → PRAGMA table_xinfo(session_events)
+        // "wal_checkpoint(TRUNCATE)" → PRAGMA wal_checkpoint(TRUNCATE)
+        const stmt = this.#raw.prepare(`PRAGMA ${source}`);
+        const rows = stmt.all();
+        if (!rows || rows.length === 0)
+            return undefined;
+        if (rows.length > 1)
+            return rows;
+        const values = Object.values(rows[0]);
+        return values.length === 1 ? values[0] : rows[0];
+    }
+    exec(sql) {
+        // node:sqlite's exec() supports multi-statement natively
+        this.#raw.exec(sql);
+        return this;
+    }
+    prepare(sql) {
+        const stmt = this.#raw.prepare(sql);
+        return {
+            run: (...args) => stmt.run(...args),
+            get: (...args) => stmt.get(...args),
+            all: (...args) => stmt.all(...args),
+            iterate: (...args) => {
+                // node:sqlite uses Symbol.iterator on StatementSync, not .iterate()
+                // Check if iterate exists, otherwise use Symbol.iterator
+                if (typeof stmt.iterate === 'function') {
+                    return stmt.iterate(...args);
+                }
+                // Fallback: use all() to create an iterator
+                const rows = stmt.all(...args);
+                return rows[Symbol.iterator]();
+            },
+        };
+    }
+    transaction(fn) {
+        // node:sqlite has no transaction() method — manual BEGIN/COMMIT/ROLLBACK
+        return (...args) => {
+            this.#raw.exec("BEGIN");
+            try {
+                const result = fn(...args);
+                this.#raw.exec("COMMIT");
+                return result;
+            }
+            catch (err) {
+                this.#raw.exec("ROLLBACK");
+                throw err;
+            }
+        };
+    }
+    close() {
+        this.#raw.close();
+    }
+}
+// ─────────────────────────────────────────────────────────
 // Lazy loader
 // ─────────────────────────────────────────────────────────
 let _Database = null;
 /**
  * Lazy-load the SQLite driver for the current runtime.
  * Bun → bun:sqlite via BunSQLiteAdapter (issue #45).
- * Node → better-sqlite3 (native addon).
+ * Linux Node → node:sqlite via NodeSQLiteAdapter (issue #228).
+ * Other Node → better-sqlite3 (native addon).
  */
 export function loadDatabase() {
     if (!_Database) {
@@ -104,11 +173,34 @@ export function loadDatabase() {
                     readonly: opts?.readonly,
                     create: true,
                 });
-                return new BunSQLiteAdapter(raw);
+                const adapter = new BunSQLiteAdapter(raw);
+                // Propagate busy_timeout — better-sqlite3 does this via constructor
+                // option but bun:sqlite does not, so we set it via pragma (#243)
+                if (opts?.timeout) {
+                    adapter.pragma(`busy_timeout = ${opts.timeout}`);
+                }
+                return adapter;
             };
         }
+        else if (process.platform === "linux") {
+            // Linux — try node:sqlite to avoid native addon SIGSEGV (nodejs/node#62515).
+            // node:sqlite is built into Node >= 22.5, no flag needed since 22.13.
+            try {
+                const { DatabaseSync } = require(["node", "sqlite"].join(":"));
+                _Database = function NodeDatabaseFactory(path, opts) {
+                    const raw = new DatabaseSync(path, {
+                        readOnly: opts?.readonly ?? false,
+                    });
+                    return new NodeSQLiteAdapter(raw);
+                };
+            }
+            catch {
+                // node:sqlite not available — fall through to better-sqlite3
+                _Database = require("better-sqlite3");
+            }
+        }
         else {
-            // Node.js — use better-sqlite3.
+            // Non-Linux Node.js — use better-sqlite3.
             _Database = require("better-sqlite3");
         }
     }
@@ -134,6 +226,21 @@ export function applyWALPragmas(db) {
 // ─────────────────────────────────────────────────────────
 // DB file helpers
 // ─────────────────────────────────────────────────────────
+/**
+ * Remove orphaned WAL/SHM files when the main DB file doesn't exist.
+ * On Windows, stale -wal/-shm files from crashed processes cause
+ * "file is not a database" errors when creating a fresh DB.
+ */
+export function cleanOrphanedWALFiles(dbPath) {
+    if (!existsSync(dbPath)) {
+        for (const suffix of ["-wal", "-shm"]) {
+            try {
+                unlinkSync(dbPath + suffix);
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
 /**
  * Delete all three SQLite files for a given db path (main, WAL, SHM).
  * Silently ignores individual deletion errors so a partial cleanup
@@ -210,6 +317,32 @@ export function withRetry(fn, delays = [100, 500, 2000]) {
         `Original error: ${lastError?.message}`);
 }
 // ─────────────────────────────────────────────────────────
+// Corrupt DB recovery (#244)
+// ─────────────────────────────────────────────────────────
+/**
+ * Detect SQLite corruption errors that warrant a rename-and-recreate.
+ * Matches SQLITE_CORRUPT, SQLITE_NOTADB, and their human-readable equivalents.
+ */
+export function isSQLiteCorruptionError(msg) {
+    return (msg.includes("SQLITE_CORRUPT") ||
+        msg.includes("SQLITE_NOTADB") ||
+        msg.includes("database disk image is malformed") ||
+        msg.includes("file is not a database"));
+}
+/**
+ * Rename a corrupt DB and its WAL/SHM files so a fresh DB can be created.
+ * Best-effort — individual rename failures are silently ignored.
+ */
+export function renameCorruptDB(dbPath) {
+    const ts = Date.now();
+    for (const suffix of ["", "-wal", "-shm"]) {
+        try {
+            renameSync(dbPath + suffix, `${dbPath}${suffix}.corrupt-${ts}`);
+        }
+        catch { /* file may not exist */ }
+    }
+}
+// ─────────────────────────────────────────────────────────
 // Base class
 // ─────────────────────────────────────────────────────────
 /**
@@ -236,10 +369,7 @@ const _liveDBs = (() => {
         g[_kLiveDBs] = new Set();
         process.on("exit", () => {
             for (const db of g[_kLiveDBs]) {
-                try {
-                    db.close();
-                }
-                catch { /* already closed */ }
+                closeDB(db);
             }
             g[_kLiveDBs].clear();
         });
@@ -252,9 +382,31 @@ export class SQLiteBase {
     constructor(dbPath) {
         const Database = loadDatabase();
         this.#dbPath = dbPath;
-        this.#db = new Database(dbPath, { timeout: 30000 });
+        cleanOrphanedWALFiles(dbPath);
+        let db;
+        try {
+            db = new Database(dbPath, { timeout: 30000 });
+            applyWALPragmas(db);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (isSQLiteCorruptionError(msg)) {
+                renameCorruptDB(dbPath);
+                cleanOrphanedWALFiles(dbPath);
+                try {
+                    db = new Database(dbPath, { timeout: 30000 });
+                    applyWALPragmas(db);
+                }
+                catch (retryErr) {
+                    throw new Error(`Failed to create fresh DB after renaming corrupt file: ${retryErr instanceof Error ? retryErr.message : String(retryErr)}`);
+                }
+            }
+            else {
+                throw err;
+            }
+        }
+        this.#db = db;
         _liveDBs.add(this.#db);
-        applyWALPragmas(this.#db);
         this.initSchema();
         this.prepareStatements();
     }

package/build/lifecycle.d.ts

@@ -1,15 +1,18 @@
 /**
  * lifecycle — Process lifecycle guard for MCP server.
  *
- * Detects parent process death, stdin close, and OS signals to prevent
+ * Detects parent process death (ppid polling) and OS signals to prevent
  * orphaned MCP server processes consuming 100% CPU (issue #103).
  *
+ * Stdin close is NOT used as a shutdown signal — the MCP stdio transport
+ * owns stdin and transient pipe events cause spurious -32000 errors (#236).
+ *
  * Cross-platform: macOS, Linux, Windows.
  */
 export interface LifecycleGuardOptions {
     /** Interval in ms to check parent liveness. Default: 30_000 */
     checkIntervalMs?: number;
-    /** Called when parent death or stdin close is detected. */
+    /** Called when parent death or OS signal is detected. */
     onShutdown: () => void;
     /** Injectable parent-alive check (for testing). Default: ppid-based check. */
     isParentAlive?: () => boolean;

package/build/lifecycle.js

@@ -1,9 +1,12 @@
 /**
  * lifecycle — Process lifecycle guard for MCP server.
  *
- * Detects parent process death, stdin close, and OS signals to prevent
+ * Detects parent process death (ppid polling) and OS signals to prevent
  * orphaned MCP server processes consuming 100% CPU (issue #103).
  *
+ * Stdin close is NOT used as a shutdown signal — the MCP stdio transport
+ * owns stdin and transient pipe events cause spurious -32000 errors (#236).
+ *
  * Cross-platform: macOS, Linux, Windows.
  */
 /**
@@ -43,13 +46,6 @@ export function startLifecycleGuard(opts) {
             shutdown();
     }, interval);
     timer.unref();
-    // P0: Stdin close — parent pipe broken
-    // Must resume stdin to receive close/end events (Node starts paused)
-    const onStdinClose = () => shutdown();
-    process.stdin.resume();
-    process.stdin.on("end", onStdinClose);
-    process.stdin.on("close", onStdinClose);
-    process.stdin.on("error", onStdinClose);
     // P0: OS signals — terminal close, kill, ctrl+c
     const signals = ["SIGTERM", "SIGINT"];
     if (process.platform !== "win32")
@@ -59,9 +55,6 @@ export function startLifecycleGuard(opts) {
     return () => {
         stopped = true;
         clearInterval(timer);
-        process.stdin.removeListener("end", onStdinClose);
-        process.stdin.removeListener("close", onStdinClose);
-        process.stdin.removeListener("error", onStdinClose);
         for (const sig of signals)
             process.removeListener(sig, shutdown);
     };