@mxalbert/context-mode 2.0.0 → 2.0.2

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "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/.codex-plugin/plugin.json

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

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxalbert/context-mode",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "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

@@ -483,13 +483,7 @@ Full configs: [`configs/cursor/hooks.json`](configs/cursor/hooks.json) | [`confi
 
    The `plugin` entry registers all 11 `ctx_*` tools natively and enables hooks — OpenCode calls context-mode's TypeScript plugin in-process, so there is no redundant stdio MCP child per session.
 
-2. *(Optional)* Copy the routing rules file:
-
-   ```bash
-   cp node_modules/context-mode/configs/opencode/AGENTS.md AGENTS.md
-   ```
-
-   The plugin already injects its routing guidance (which tools to use, which commands are blocked and why) into the system prompt on every model dispatch — on both opencode v1 and v2. The copy is only useful if you want the same guidance also visible as native project rules (`AGENTS.md`) for sessions without the plugin. Your own `AGENTS.md`/`CLAUDE.md`/`CONTEXT.md` rules are captured automatically for session continuity — no copy needed.
+2. **No AGENTS.md copy needed.** The plugin injects the FULL routing mandate — Think in Code, BLOCKED/REDIRECTED commands, tool selection, memory tables (the complete [`configs/opencode/AGENTS.md`](configs/opencode/AGENTS.md) content, verbatim) — into the system prompt on every model dispatch. An existing copy stays harmless: OpenCode loads a project `AGENTS.md` natively as active project rules, and the plugin auto-skips its own injection when the project file's content matches the shipped template (normalized full-content comparison — an edited copy keeps getting re-injected, deliberately, so your edits don't get shadowed by the stale shipped version).
 
 3. Restart OpenCode.
 
@@ -497,7 +491,7 @@ Full configs: [`configs/cursor/hooks.json`](configs/cursor/hooks.json) | [`confi
 
 **Upgrade note:** If an existing config has BOTH `plugin: ["context-mode"]` AND `mcp.context-mode`, OpenCode will register zero `ctx_*` tools — the plugin path correctly suppresses MCP duplicates, but the legacy MCP entry confuses the loader. Run `context-mode upgrade` to remove the legacy `mcp.context-mode` entry; your other MCP servers are preserved. v1.0.140+ emits a stderr diagnostic with the same guidance when this happens.
 
-**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`. The optional [`AGENTS.md`](configs/opencode/AGENTS.md) file provides routing instructions for model awareness. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts. The `experimental.chat.system.transform` hook injects the routing block and prior-session snapshots at session start, enabling session continuity across restarts. The `chat.message` hook captures user prompts and decisions (UserPromptSubmit equivalent).
+**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`, and the plugin injects the full routing guidance (condensed block + complete AGENTS.md mandate) into the system prompt on every model dispatch — no copied AGENTS.md is required. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts. The `experimental.chat.system.transform` hook injects the routing block and prior-session snapshots at session start, enabling session continuity across restarts. The `chat.message` hook captures user prompts and decisions (UserPromptSubmit equivalent).
 
 > **Note:** OpenCode lacks a real SessionStart hook ([#14808](https://github.com/sst/opencode/issues/14808), [#5409](https://github.com/sst/opencode/issues/5409)). The plugin uses `experimental.chat.system.transform` as a surrogate — it injects both the routing block and resume snapshots into the system prompt. User-prompt capture uses `chat.message` instead of the missing UserPromptSubmit hook. AGENTS.md/CLAUDE.md/CONTEXT.md rules are captured automatically on first hook fire per project.
 
@@ -523,11 +517,7 @@ Full configs: [`configs/opencode/opencode.json`](configs/opencode/opencode.json)
 
    The `plugin` entry registers all 11 `ctx_*` tools natively and enables hooks — KiloCode calls context-mode's TypeScript plugin in-process, so there is no redundant stdio MCP child per session.
 
-2. *(Optional)* Copy the routing rules file. KiloCode shares the OpenCode plugin architecture; the plugin already injects its routing guidance into the system prompt on every model dispatch, so the copy is only useful if you want the guidance also visible as native project rules:
-
-   ```bash
-   cp node_modules/context-mode/configs/opencode/AGENTS.md AGENTS.md
-   ```
+2. **No AGENTS.md copy needed.** KiloCode shares the OpenCode plugin architecture — the plugin injects the FULL routing mandate ([`configs/opencode/AGENTS.md`](configs/opencode/AGENTS.md), verbatim) into the system prompt on every model dispatch. An existing copy is harmless (the host loads it natively as project rules) and identical copies are auto-skipped by the plugin's dedupe guard, so the mandate is never injected twice.
 
 3. Restart KiloCode.
 
@@ -535,7 +525,7 @@ Full configs: [`configs/opencode/opencode.json`](configs/opencode/opencode.json)
 
 **Upgrade note:** If an existing config has BOTH `plugin: ["context-mode"]` AND `mcp.context-mode`, KiloCode will register zero `ctx_*` tools — the plugin path correctly suppresses MCP duplicates, but the legacy MCP entry confuses the loader. Run `context-mode upgrade` to remove the legacy `mcp.context-mode` entry; your other MCP servers are preserved. v1.0.140+ emits a stderr diagnostic with the same guidance when this happens.
 
-**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`. The optional [`AGENTS.md`](configs/opencode/AGENTS.md) file provides routing instructions for model awareness. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts. The `experimental.chat.system.transform` hook injects the routing block and prior-session snapshots at session start, enabling session continuity across restarts. The `chat.message` hook captures user prompts and decisions (UserPromptSubmit equivalent).
+**Routing:** Hooks enforce routing programmatically via `tool.execute.before` and `tool.execute.after`, and the plugin injects the full routing guidance (condensed block + complete AGENTS.md mandate) into the system prompt on every model dispatch — no copied AGENTS.md is required. The `experimental.session.compacting` hook builds resume snapshots when the conversation compacts. The `experimental.chat.system.transform` hook injects the routing block and prior-session snapshots at session start, enabling session continuity across restarts. The `chat.message` hook captures user prompts and decisions (UserPromptSubmit equivalent).
 
 > **Note:** KiloCode shares the same plugin architecture as OpenCode, using the OpenCodeAdapter with platform-specific configuration paths (`kilo.json` instead of `opencode.json`, `~/.config/kilo/` instead of `~/.config/opencode/`). Like OpenCode, it lacks a real SessionStart hook — the plugin uses `experimental.chat.system.transform` as a surrogate. User-prompt capture uses `chat.message` instead of the missing UserPromptSubmit hook. AGENTS.md/CLAUDE.md/CONTEXT.md rules are captured automatically on first hook fire per project.
 

package/build/adapters/opencode/plugin.d.ts

@@ -182,6 +182,8 @@ interface ChatMessageHookOutput {
     message: unknown;
     parts: ChatMessagePart[];
 }
+/** Test-only: point the template loader at a specific path (tests pass a nonexistent path to simulate a missing template). */
+export declare function __setAgentsTemplatePathForTests(path: string | undefined): void;
 declare const ROUTING_MARKERS: string[];
 declare function systemHasRoutingInstructions(system: string[]): boolean;
 /** Test-only: clear process-global activation + log-dedupe state. */

package/build/adapters/opencode/plugin.js

@@ -75,6 +75,93 @@ function isSyntheticMessage(text) {
     const trimmed = text.trim();
     return SYNTHETIC_MESSAGE_PREFIXES.some((p) => trimmed.startsWith(p));
 }
+// ── Full AGENTS.md mandate injection (user decision: opencode must not
+//    require the copied AGENTS.md — the injected guidance carries the FULL
+//    mandate, not just the condensed block) ─────────────────
+/** Test-only override for the template path (null/undefined → default). */
+let agentsTemplatePathOverride;
+/** Test-only: point the template loader at a specific path (tests pass a nonexistent path to simulate a missing template). */
+export function __setAgentsTemplatePathForTests(path) {
+    agentsTemplatePathOverride = path;
+}
+function agentsTemplatePathFor(buildDir) {
+    if (agentsTemplatePathOverride !== undefined)
+        return agentsTemplatePathOverride;
+    // Same buildDir-relative pattern as the routing .mjs islands: the plugin
+    // runs from build/adapters/opencode (or src/adapters/opencode under tsx),
+    // so ../../.. is the package root where configs/ lives.
+    return resolve(buildDir, "..", "..", "..", "configs", "opencode", "AGENTS.md");
+}
+/**
+ * Normalize a markdown document for content comparison: strip \r, trim each
+ * line, drop empty lines, re-join with "\n". Absorbs CRLF line endings,
+ * trailing whitespace, and blank-line differences — content-equal documents
+ * normalize identically; ANY edited line does not.
+ */
+function normalizeMarkdownForCompare(content) {
+    return content
+        .replace(/\r/g, "")
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .join("\n");
+}
+/**
+ * Compose the injected guidance: the condensed routing block FIRST
+ * (<context_window_protection> + quorum markers), then the FULL AGENTS.md
+ * mandate (Think in Code, BLOCKED/REDIRECTED, tool selection, memory
+ * tables, ctx commands) appended VERBATIM — the template uses the SAME
+ * tool naming (`context-mode_ctx_*`) as the runtime redirect guidance, so
+ * no rewrite is needed, and it does NOT contain the condensed block's XML
+ * tag, so there is no tag collision.
+ *
+ * Best-effort: a missing/unreadable template degrades to the condensed
+ * block alone (nothing logged — same degrade-honestly pattern; the
+ * condensed block alone must keep working).
+ *
+ * Dedupe guard (evaluated ONCE at setup) — NORMALIZED FULL-CONTENT
+ * EQUALITY: the template is skipped ONLY when the project-root AGENTS.md is
+ * content-equal to the template after normalization (CRLF/trailing-
+ * whitespace/blank-line differences absorbed). Rationale: the v1 host then
+ * loads the identical mandate natively, so appending it again would
+ * double-inject and waste context. ANY edited copy re-appends the full
+ * template DELIBERATELY — even when the copy still carries the old
+ * signature line — because an edited copy is no longer guaranteed to match
+ * what the plugin injects, and the injected guidance is the authoritative
+ * mandate. Unreadable project files fall through and append (harmless
+ * duplicate worst-case; never break setup over a diagnostics read).
+ */
+function composeRoutingGuidance(condensedBlock, templatePath, projectDir) {
+    let agentsMdContent = "";
+    try {
+        if (existsSync(templatePath)) {
+            const content = readFileSync(templatePath, "utf-8");
+            if (content.trim())
+                agentsMdContent = content;
+        }
+    }
+    catch {
+        agentsMdContent = ""; // unreadable template — condensed block alone
+    }
+    if (!agentsMdContent)
+        return condensedBlock;
+    try {
+        const projectAgentsPath = join(projectDir, "AGENTS.md");
+        if (existsSync(projectAgentsPath)) {
+            const projectAgents = readFileSync(projectAgentsPath, "utf-8");
+            if (normalizeMarkdownForCompare(projectAgents) === normalizeMarkdownForCompare(agentsMdContent)) {
+                // Content-equal copy → the v1 host loads the identical mandate
+                // natively — skip the template. Edited copies re-append above.
+                return condensedBlock;
+            }
+        }
+    }
+    catch {
+        // Unreadable project file — fall through and append (harmless duplicate
+        // worst-case; never break setup over a diagnostics read).
+    }
+    return `${condensedBlock}\n\n${agentsMdContent}`;
+}
 // ── Helpers ───────────────────────────────────────────────
 // Quorum markers — must NOT be substrings of each other (#487).
 // Each token uniquely identifies the routing block / context-mode rules
@@ -368,12 +455,16 @@ async function createPluginRuntime(ctx, projectDirOverride, adapterOptions) {
     // sessionID, so we cache it. createToolNamer accepts both "opencode" and
     // "kilo" per hooks/core/tool-naming.mjs:25-26.
     const toolNamer = toolNamingMod.createToolNamer(platform);
-    const routingBlock = routingBlockMod.createRoutingBlock(toolNamer);
+    const condensedRoutingBlock = routingBlockMod.createRoutingBlock(toolNamer);
     // Initialize per-process state. We do NOT fabricate a sessionId here —
     // OpenCode/Kilo provide the real `input.sessionID` on every hook, and a
     // process-global UUID would (a) never match prior-session resume rows and
     // (b) collide across multi-session reuse (Mickey / PR #376 root cause).
     const projectDir = projectDirOverride ?? ctx?.directory ?? process.cwd();
+    // Compose the FULL injected guidance (condensed block first + the complete
+    // AGENTS.md mandate verbatim, subject to the project-root dedupe guard) —
+    // evaluated ONCE per process; needs the resolved project dir.
+    const routingBlock = composeRoutingGuidance(condensedRoutingBlock, agentsTemplatePathFor(buildDir), projectDir);
     // C2 narrowing: resolve DB path through the canonical helper directly.
     // BaseAdapter no longer exposes getSessionDBPath; the adapter only owns
     // the sessions DIR (per-platform), the helper owns the per-project FILE

package/build/db-base.d.ts

@@ -185,6 +185,22 @@ export declare function renameCorruptDB(dbPath: string): void;
  * error) go to stderr via console.error under this prefix.
  */
 export declare const DB_LOG_PREFIX = "[context-mode:db]";
+/**
+ * Extract the SQLite error code (e.g. "SQLITE_IOERR") from an arbitrary
+ * thrown value, or "" when absent. better-sqlite3 and node:sqlite set
+ * `code` on SqliteError; bun:sqlite encodes it in the message instead.
+ *
+ * Exported so store.ts can append the same `[<code>]` context to the
+ * tool-visible `[context-mode:store] …` error messages without
+ * duplicating the throw-shape handling.
+ */
+export declare function extractErrorCode(err: unknown): string;
+/**
+ * Normalize the human-readable message of an arbitrary thrown value.
+ * Exported alongside extractErrorCode for store.ts's tool-error
+ * enrichment (non-Error shapes included).
+ */
+export declare function errorMessage(err: unknown): string;
 /**
  * Log a swallowed DB failure to stderr with the stable
  * `[context-mode:db]` prefix: operation name, error code, error message,

package/build/db-base.js

@@ -490,6 +490,15 @@ export function withRetry(fn, delays = [100, 500, 2000]) {
                 throw err;
             }
             lastError = err instanceof Error ? err : new Error(errorSignature(err));
+            if (!(err instanceof Error)) {
+                // Preserve the SQLite code (e.g. SQLITE_IOERR) on the normalized
+                // Error — non-Error throw shapes ({ code } objects, strings) would
+                // otherwise lose it, leaving callers unable to classify the failure
+                // after retries are exhausted.
+                const code = extractErrorCode(err);
+                if (code)
+                    lastError.code = code;
+            }
             if (attempt < delays.length) {
                 const delay = delays[attempt];
                 const start = Date.now();
@@ -497,8 +506,16 @@ export function withRetry(fn, delays = [100, 500, 2000]) {
             }
         }
     }
-    throw new Error(`SQLITE_BUSY/SQLITE_IOERR: transient SQLite error after ${delays.length} retries. ` +
+    const exhausted = new Error(`SQLITE_BUSY/SQLITE_IOERR: transient SQLite error after ${delays.length} retries. ` +
         `Original error: ${lastError?.message}`);
+    // Carry the last error's SQLite code on the wrapper (message alone is
+    // ambiguous — it names both SQLITE_BUSY and SQLITE_IOERR). store.ts's
+    // `[context-mode:store]` enrichment appends this as ` (<code>)` so the
+    // tool-visible error is never a bare "disk I/O error".
+    const exhaustedCode = lastError ? extractErrorCode(lastError) : "";
+    if (exhaustedCode)
+        exhausted.code = exhaustedCode;
+    throw exhausted;
 }
 // ─────────────────────────────────────────────────────────
 // Corrupt DB recovery (#244)
@@ -545,8 +562,12 @@ const _recentDbErrors = new Map();
  * Extract the SQLite error code (e.g. "SQLITE_IOERR") from an arbitrary
  * thrown value, or "" when absent. better-sqlite3 and node:sqlite set
  * `code` on SqliteError; bun:sqlite encodes it in the message instead.
+ *
+ * Exported so store.ts can append the same `[<code>]` context to the
+ * tool-visible `[context-mode:store] …` error messages without
+ * duplicating the throw-shape handling.
  */
-function extractErrorCode(err) {
+export function extractErrorCode(err) {
     if (err instanceof Error) {
         const code = err.code;
         return typeof code === "string" ? code : "";
@@ -557,7 +578,12 @@ function extractErrorCode(err) {
     }
     return "";
 }
-function errorMessage(err) {
+/**
+ * Normalize the human-readable message of an arbitrary thrown value.
+ * Exported alongside extractErrorCode for store.ts's tool-error
+ * enrichment (non-Error shapes included).
+ */
+export function errorMessage(err) {
     if (err instanceof Error)
         return err.message;
     if (typeof err === "string")