context-mode 1.0.6 → 1.0.7

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "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/build/adapters/claude-code/hooks.d.ts

@@ -49,7 +49,7 @@ export declare function isContextModeHook(entry: {
 }, hookType: HookType): boolean;
 /**
  * Build the hook command string for a given hook type.
- * Uses the CLI dispatcher: `context-mode hook claude-code <event>`
- * Requires global install: `npm install -g context-mode`
+ * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
+ * Falls back to CLI dispatcher if pluginRoot is not provided.
  */
-export declare function buildHookCommand(hookType: HookType): string;
+export declare function buildHookCommand(hookType: HookType, pluginRoot?: string): string;

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

@@ -83,9 +83,13 @@ export function isContextModeHook(entry, hookType) {
 }
 /**
  * Build the hook command string for a given hook type.
- * Uses the CLI dispatcher: `context-mode hook claude-code <event>`
- * Requires global install: `npm install -g context-mode`
+ * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
+ * Falls back to CLI dispatcher if pluginRoot is not provided.
  */
-export function buildHookCommand(hookType) {
+export function buildHookCommand(hookType, pluginRoot) {
+    if (pluginRoot) {
+        const scriptName = HOOK_SCRIPTS[hookType];
+        return `node "${pluginRoot}/hooks/${scriptName}"`;
+    }
     return `context-mode hook claude-code ${hookType.toLowerCase()}`;
 }

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

@@ -372,7 +372,7 @@ export class ClaudeCodeAdapter {
             HOOK_TYPES.SESSION_START,
         ];
         for (const hookType of hookTypes) {
-            const command = buildHookCommand(hookType);
+            const command = buildHookCommand(hookType, pluginRoot);
             if (hookType === HOOK_TYPES.PRE_TOOL_USE) {
                 const entry = {
                     matcher: PRE_TOOL_USE_MATCHER_PATTERN,

package/build/adapters/detect.d.ts

@@ -6,13 +6,12 @@
  *   2. Config directory existence (medium confidence)
  *   3. Fallback to Claude Code (low confidence — most common)
  *
- * Each platform sets identifiable env vars or creates config dirs:
- *   - Claude Code:  CLAUDE_PROJECT_DIR, ~/.claude/
- *   - Gemini CLI:   GEMINI_PROJECT_DIR, ~/.gemini/
- *   - OpenCode:     OPENCODE_PROJECT_DIR, .opencode/
- *   - Copilot CLI:  GITHUB_COPILOT_*, ~/.config/github-copilot/
- *   - VS Code:      VSCODE_*, ~/.vscode/
- *   - Cursor:       CURSOR_*, ~/.cursor/
+ * Verified env vars per platform (from source code audit):
+ *   - Claude Code:    CLAUDE_PROJECT_DIR, CLAUDE_SESSION_ID | ~/.claude/
+ *   - Gemini CLI:     GEMINI_PROJECT_DIR (hooks), GEMINI_CLI (MCP) | ~/.gemini/
+ *   - OpenCode:       OPENCODE, OPENCODE_PID | ~/.config/opencode/
+ *   - Codex CLI:      CODEX_CI, CODEX_THREAD_ID | ~/.codex/
+ *   - VS Code Copilot: VSCODE_PID, VSCODE_CWD | ~/.vscode/
  */
 import type { PlatformId, DetectionSignal, HookAdapter } from "./types.js";
 /**

package/build/adapters/detect.js

@@ -6,13 +6,12 @@
  *   2. Config directory existence (medium confidence)
  *   3. Fallback to Claude Code (low confidence — most common)
  *
- * Each platform sets identifiable env vars or creates config dirs:
- *   - Claude Code:  CLAUDE_PROJECT_DIR, ~/.claude/
- *   - Gemini CLI:   GEMINI_PROJECT_DIR, ~/.gemini/
- *   - OpenCode:     OPENCODE_PROJECT_DIR, .opencode/
- *   - Copilot CLI:  GITHUB_COPILOT_*, ~/.config/github-copilot/
- *   - VS Code:      VSCODE_*, ~/.vscode/
- *   - Cursor:       CURSOR_*, ~/.cursor/
+ * Verified env vars per platform (from source code audit):
+ *   - Claude Code:    CLAUDE_PROJECT_DIR, CLAUDE_SESSION_ID | ~/.claude/
+ *   - Gemini CLI:     GEMINI_PROJECT_DIR (hooks), GEMINI_CLI (MCP) | ~/.gemini/
+ *   - OpenCode:       OPENCODE, OPENCODE_PID | ~/.config/opencode/
+ *   - Codex CLI:      CODEX_CI, CODEX_THREAD_ID | ~/.codex/
+ *   - VS Code Copilot: VSCODE_PID, VSCODE_CWD | ~/.vscode/
  */
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
@@ -29,25 +28,25 @@ export function detectPlatform() {
             reason: "CLAUDE_PROJECT_DIR or CLAUDE_SESSION_ID env var set",
         };
     }
-    if (process.env.GEMINI_PROJECT_DIR || process.env.GEMINI_SESSION_ID) {
+    if (process.env.GEMINI_PROJECT_DIR || process.env.GEMINI_CLI) {
         return {
             platform: "gemini-cli",
             confidence: "high",
-            reason: "GEMINI_PROJECT_DIR or GEMINI_SESSION_ID env var set",
+            reason: "GEMINI_PROJECT_DIR or GEMINI_CLI env var set",
         };
     }
-    if (process.env.OPENCODE_PROJECT_DIR || process.env.OPENCODE_SESSION_ID) {
+    if (process.env.OPENCODE || process.env.OPENCODE_PID) {
         return {
             platform: "opencode",
             confidence: "high",
-            reason: "OPENCODE_PROJECT_DIR or OPENCODE_SESSION_ID env var set",
+            reason: "OPENCODE or OPENCODE_PID env var set",
         };
     }
-    if (process.env.GITHUB_COPILOT_AGENT || process.env.COPILOT_SESSION_ID) {
+    if (process.env.CODEX_CI || process.env.CODEX_THREAD_ID) {
         return {
-            platform: "copilot-cli",
+            platform: "codex",
             confidence: "high",
-            reason: "GITHUB_COPILOT_AGENT or COPILOT_SESSION_ID env var set",
+            reason: "CODEX_CI or CODEX_THREAD_ID env var set",
         };
     }
     if (process.env.VSCODE_PID || process.env.VSCODE_CWD) {
@@ -57,13 +56,6 @@ export function detectPlatform() {
             reason: "VSCODE_PID or VSCODE_CWD env var set",
         };
     }
-    if (process.env.CURSOR_SESSION_ID || process.env.CURSOR_TRACE_ID) {
-        return {
-            platform: "cursor",
-            confidence: "high",
-            reason: "CURSOR_SESSION_ID or CURSOR_TRACE_ID env var set",
-        };
-    }
     // ── Medium confidence: config directory existence ──────
     const home = homedir();
     if (existsSync(resolve(home, ".claude"))) {
@@ -80,11 +72,18 @@ export function detectPlatform() {
             reason: "~/.gemini/ directory exists",
         };
     }
-    if (existsSync(resolve(home, ".cursor"))) {
+    if (existsSync(resolve(home, ".codex"))) {
         return {
-            platform: "cursor",
+            platform: "codex",
+            confidence: "medium",
+            reason: "~/.codex/ directory exists",
+        };
+    }
+    if (existsSync(resolve(home, ".config", "opencode"))) {
+        return {
+            platform: "opencode",
             confidence: "medium",
-            reason: "~/.cursor/ directory exists",
+            reason: "~/.config/opencode/ directory exists",
         };
     }
     // ── Low confidence: fallback ───────────────────────────

package/build/adapters/gemini-cli/hooks.d.ts

@@ -40,7 +40,7 @@ export declare function isContextModeHook(entry: {
 }, hookType: HookType): boolean;
 /**
  * Build the hook command string for a given hook type.
- * Uses the CLI dispatcher: `context-mode hook gemini-cli <event>`
- * Requires global install: `npm install -g context-mode`
+ * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
+ * Falls back to CLI dispatcher if pluginRoot is not provided.
  */
-export declare function buildHookCommand(hookType: HookType): string;
+export declare function buildHookCommand(hookType: HookType, pluginRoot?: string): string;

package/build/adapters/gemini-cli/hooks.js

@@ -59,9 +59,13 @@ export function isContextModeHook(entry, hookType) {
 }
 /**
  * Build the hook command string for a given hook type.
- * Uses the CLI dispatcher: `context-mode hook gemini-cli <event>`
- * Requires global install: `npm install -g context-mode`
+ * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
+ * Falls back to CLI dispatcher if pluginRoot is not provided.
  */
-export function buildHookCommand(hookType) {
+export function buildHookCommand(hookType, pluginRoot) {
+    const scriptName = HOOK_SCRIPTS[hookType];
+    if (pluginRoot && scriptName) {
+        return `node "${pluginRoot}/hooks/${scriptName}"`;
+    }
     return `context-mode hook gemini-cli ${hookType.toLowerCase()}`;
 }

package/build/adapters/gemini-cli/index.d.ts

@@ -35,13 +35,13 @@ export declare class GeminiCLIAdapter implements HookAdapter {
     getSessionDir(): string;
     getSessionDBPath(projectDir: string): string;
     getSessionEventsPath(projectDir: string): string;
-    generateHookConfig(_pluginRoot: string): HookRegistration;
+    generateHookConfig(pluginRoot: string): HookRegistration;
     readSettings(): Record<string, unknown> | null;
     writeSettings(settings: Record<string, unknown>): void;
     validateHooks(pluginRoot: string): DiagnosticResult[];
     checkPluginRegistration(): DiagnosticResult;
     getInstalledVersion(): string;
-    configureAllHooks(_pluginRoot: string): string[];
+    configureAllHooks(pluginRoot: string): string[];
     backupSettings(): string | null;
     setHookPermissions(pluginRoot: string): string[];
     updatePluginRegistry(pluginRoot: string, version: string): void;

package/build/adapters/gemini-cli/index.js

@@ -25,7 +25,7 @@ import { homedir } from "node:os";
 // ─────────────────────────────────────────────────────────
 // Hook constants (re-exported from hooks.ts)
 // ─────────────────────────────────────────────────────────
-import { HOOK_TYPES as GEMINI_HOOK_NAMES, HOOK_SCRIPTS as GEMINI_HOOK_SCRIPTS, } from "./hooks.js";
+import { HOOK_TYPES as GEMINI_HOOK_NAMES, HOOK_SCRIPTS as GEMINI_HOOK_SCRIPTS, buildHookCommand as buildGeminiHookCommand, } from "./hooks.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
@@ -176,7 +176,7 @@ export class GeminiCLIAdapter {
             .slice(0, 16);
         return join(this.getSessionDir(), `${hash}-events.md`);
     }
-    generateHookConfig(_pluginRoot) {
+    generateHookConfig(pluginRoot) {
         return {
             [GEMINI_HOOK_NAMES.BEFORE_TOOL]: [
                 {
@@ -184,7 +184,7 @@ export class GeminiCLIAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.BEFORE_TOOL.toLowerCase()}`,
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.BEFORE_TOOL, pluginRoot),
                         },
                     ],
                 },
@@ -195,7 +195,7 @@ export class GeminiCLIAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.AFTER_TOOL.toLowerCase()}`,
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.AFTER_TOOL, pluginRoot),
                         },
                     ],
                 },
@@ -206,7 +206,7 @@ export class GeminiCLIAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.PRE_COMPRESS.toLowerCase()}`,
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.PRE_COMPRESS, pluginRoot),
                         },
                     ],
                 },
@@ -217,7 +217,7 @@ export class GeminiCLIAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.SESSION_START.toLowerCase()}`,
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.SESSION_START, pluginRoot),
                         },
                     ],
                 },
@@ -339,7 +339,7 @@ export class GeminiCLIAdapter {
         return "not installed";
     }
     // ── Upgrade ────────────────────────────────────────────
-    configureAllHooks(_pluginRoot) {
+    configureAllHooks(pluginRoot) {
         const settings = this.readSettings() ?? {};
         const hooks = (settings.hooks ?? {});
         const changes = [];
@@ -348,7 +348,7 @@ export class GeminiCLIAdapter {
             { name: GEMINI_HOOK_NAMES.SESSION_START },
         ];
         for (const config of hookConfigs) {
-            const command = `context-mode hook gemini-cli ${config.name.toLowerCase()}`;
+            const command = buildGeminiHookCommand(config.name, pluginRoot);
             const entry = {
                 matcher: "",
                 hooks: [{ type: "command", command }],

package/build/adapters/types.d.ts

@@ -206,7 +206,7 @@ export interface DiagnosticResult {
     fix?: string;
 }
 /** Supported platform identifiers. */
-export type PlatformId = "claude-code" | "gemini-cli" | "opencode" | "codex" | "copilot-cli" | "vscode-copilot" | "cursor" | "unknown";
+export type PlatformId = "claude-code" | "gemini-cli" | "opencode" | "codex" | "vscode-copilot" | "unknown";
 /** Detection signal used to identify which platform is running. */
 export interface DetectionSignal {
     /** Platform identifier. */

package/build/adapters/vscode-copilot/hooks.d.ts

@@ -45,7 +45,7 @@ export declare function isContextModeHook(entry: {
 }, hookType: HookType): boolean;
 /**
  * Build the hook command string for a given hook type.
- * Uses the CLI dispatcher: `context-mode hook vscode-copilot <event>`
- * Requires global install: `npm install -g context-mode`
+ * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
+ * Falls back to CLI dispatcher if pluginRoot is not provided.
  */
-export declare function buildHookCommand(hookType: HookType): string;
+export declare function buildHookCommand(hookType: HookType, pluginRoot?: string): string;

package/build/adapters/vscode-copilot/hooks.js

@@ -67,13 +67,16 @@ export function isContextModeHook(entry, hookType) {
 }
 /**
  * Build the hook command string for a given hook type.
- * Uses the CLI dispatcher: `context-mode hook vscode-copilot <event>`
- * Requires global install: `npm install -g context-mode`
+ * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
+ * Falls back to CLI dispatcher if pluginRoot is not provided.
  */
-export function buildHookCommand(hookType) {
+export function buildHookCommand(hookType, pluginRoot) {
     const scriptName = HOOK_SCRIPTS[hookType];
     if (!scriptName) {
         throw new Error(`No script defined for hook type: ${hookType}`);
     }
+    if (pluginRoot) {
+        return `node "${pluginRoot}/hooks/${scriptName}"`;
+    }
     return `context-mode hook vscode-copilot ${hookType.toLowerCase()}`;
 }

package/build/adapters/vscode-copilot/index.d.ts

@@ -38,13 +38,13 @@ export declare class VSCodeCopilotAdapter implements HookAdapter {
     getSessionDir(): string;
     getSessionDBPath(projectDir: string): string;
     getSessionEventsPath(projectDir: string): string;
-    generateHookConfig(_pluginRoot: string): HookRegistration;
+    generateHookConfig(pluginRoot: string): HookRegistration;
     readSettings(): Record<string, unknown> | null;
     writeSettings(settings: Record<string, unknown>): void;
     validateHooks(pluginRoot: string): DiagnosticResult[];
     checkPluginRegistration(): DiagnosticResult;
     getInstalledVersion(): string;
-    configureAllHooks(_pluginRoot: string): string[];
+    configureAllHooks(pluginRoot: string): string[];
     backupSettings(): string | null;
     setHookPermissions(pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;

package/build/adapters/vscode-copilot/index.js

@@ -28,7 +28,7 @@ import { homedir } from "node:os";
 // ─────────────────────────────────────────────────────────
 // Hook constants (re-exported from hooks.ts)
 // ─────────────────────────────────────────────────────────
-import { HOOK_TYPES as VSCODE_HOOK_NAMES, HOOK_SCRIPTS as VSCODE_HOOK_SCRIPTS, } from "./hooks.js";
+import { HOOK_TYPES as VSCODE_HOOK_NAMES, HOOK_SCRIPTS as VSCODE_HOOK_SCRIPTS, buildHookCommand as buildVSCodeHookCommand, } from "./hooks.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
@@ -193,7 +193,7 @@ export class VSCodeCopilotAdapter {
             .slice(0, 16);
         return join(this.getSessionDir(), `${hash}-events.md`);
     }
-    generateHookConfig(_pluginRoot) {
+    generateHookConfig(pluginRoot) {
         return {
             [VSCODE_HOOK_NAMES.PRE_TOOL_USE]: [
                 {
@@ -201,7 +201,7 @@ export class VSCodeCopilotAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook vscode-copilot ${VSCODE_HOOK_NAMES.PRE_TOOL_USE.toLowerCase()}`,
+                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.PRE_TOOL_USE, pluginRoot),
                         },
                     ],
                 },
@@ -212,7 +212,7 @@ export class VSCodeCopilotAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook vscode-copilot ${VSCODE_HOOK_NAMES.POST_TOOL_USE.toLowerCase()}`,
+                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.POST_TOOL_USE, pluginRoot),
                         },
                     ],
                 },
@@ -223,7 +223,7 @@ export class VSCodeCopilotAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook vscode-copilot ${VSCODE_HOOK_NAMES.PRE_COMPACT.toLowerCase()}`,
+                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.PRE_COMPACT, pluginRoot),
                         },
                     ],
                 },
@@ -234,7 +234,7 @@ export class VSCodeCopilotAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook vscode-copilot ${VSCODE_HOOK_NAMES.SESSION_START.toLowerCase()}`,
+                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.SESSION_START, pluginRoot),
                         },
                     ],
                 },
@@ -398,7 +398,7 @@ export class VSCodeCopilotAdapter {
         return "not installed";
     }
     // ── Upgrade ────────────────────────────────────────────
-    configureAllHooks(_pluginRoot) {
+    configureAllHooks(pluginRoot) {
         const changes = [];
         const hookConfig = { hooks: {} };
         const hooks = hookConfig.hooks;
@@ -418,7 +418,7 @@ export class VSCodeCopilotAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: `context-mode hook vscode-copilot ${hookType.toLowerCase()}`,
+                            command: buildVSCodeHookCommand(hookType, pluginRoot),
                         },
                     ],
                 },

package/build/cli.js

@@ -17,7 +17,7 @@ import { execSync } from "node:child_process";
 import { readFileSync, cpSync, accessSync, readdirSync, rmSync, closeSync, openSync, constants } from "node:fs";
 import { resolve, dirname, join } from "node:path";
 import { tmpdir, devNull } from "node:os";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { detectRuntimes, getRuntimeSummary, hasBunRuntime, getAvailableLanguages, } from "./runtime.js";
 // ── Adapter imports ──────────────────────────────────────
 import { detectPlatform, getAdapter } from "./adapters/detect.js";
@@ -62,7 +62,7 @@ async function hookDispatch(platform, event) {
         process.exit(1);
     }
     const pluginRoot = getPluginRoot();
-    await import(join(pluginRoot, scriptPath));
+    await import(pathToFileURL(join(pluginRoot, scriptPath)).href);
 }
 /* -------------------------------------------------------
  * Entry point

package/build/exit-classify.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Classify non-zero exit codes for ctx_execute / ctx_execute_file.
+ *
+ * Shell commands like `grep` exit 1 for "no matches" — not a real error.
+ * We treat exit code 1 as a soft failure when:
+ *   - language is "shell"
+ *   - exit code is exactly 1
+ *   - stdout has non-whitespace content
+ */
+export interface ExitClassification {
+    isError: boolean;
+    output: string;
+}
+export declare function classifyNonZeroExit(params: {
+    language: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}): ExitClassification;

package/build/exit-classify.js

@@ -0,0 +1,12 @@
+export function classifyNonZeroExit(params) {
+    const { language, exitCode, stdout, stderr } = params;
+    const isSoftFail = language === "shell" &&
+        exitCode === 1 &&
+        stdout.trim().length > 0;
+    return {
+        isError: !isSoftFail,
+        output: isSoftFail
+            ? stdout
+            : `Exit code: ${exitCode}\n\nstdout:\n${stdout}\n\nstderr:\n${stderr}`,
+    };
+}

package/build/server.js

@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { createRequire } from "node:module";
 import { createHash } from "node:crypto";
 import { existsSync, unlinkSync, readdirSync, readFileSync, rmSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir, tmpdir } from "node:os";
 import { z } from "zod";
@@ -12,7 +12,8 @@ import { PolyglotExecutor } from "./executor.js";
 import { ContentStore, cleanupStaleDBs } from "./store.js";
 import { readBashPolicies, evaluateCommandDenyOnly, extractShellCommands, readToolDenyPatterns, evaluateFilePath, } from "./security.js";
 import { detectRuntimes, getRuntimeSummary, getAvailableLanguages, hasBunRuntime, } from "./runtime.js";
-const VERSION = "1.0.6";
+import { classifyNonZeroExit } from "./exit-classify.js";
+const VERSION = "1.0.7";
 // Prevent silent server death from unhandled async errors
 process.on("unhandledRejection", (err) => {
     process.stderr.write(`[context-mode] unhandledRejection: ${err}\n`);
@@ -420,21 +421,23 @@ __cm_main().catch(e=>{console.error(e);process.exitCode=1});${background ? '\nse
             });
         }
         if (result.exitCode !== 0) {
-            const output = `Exit code: ${result.exitCode}\n\nstdout:\n${result.stdout}\n\nstderr:\n${result.stderr}`;
+            const { isError, output } = classifyNonZeroExit({
+                language, exitCode: result.exitCode, stdout: result.stdout, stderr: result.stderr,
+            });
             if (intent && intent.trim().length > 0 && Buffer.byteLength(output) > INTENT_SEARCH_THRESHOLD) {
                 trackIndexed(Buffer.byteLength(output));
                 return trackResponse("ctx_execute", {
                     content: [
-                        { type: "text", text: intentSearch(output, intent, `execute:${language}:error`) },
+                        { type: "text", text: intentSearch(output, intent, isError ? `execute:${language}:error` : `execute:${language}`) },
                     ],
-                    isError: true,
+                    isError,
                 });
             }
             return trackResponse("ctx_execute", {
                 content: [
                     { type: "text", text: output },
                 ],
-                isError: true,
+                isError,
             });
         }
         const stdout = result.stdout || "(no output)";
@@ -598,21 +601,23 @@ server.registerTool("ctx_execute_file", {
             });
         }
         if (result.exitCode !== 0) {
-            const output = `Error processing ${path} (exit ${result.exitCode}):\n${result.stderr || result.stdout}`;
+            const { isError, output } = classifyNonZeroExit({
+                language, exitCode: result.exitCode, stdout: result.stdout, stderr: result.stderr,
+            });
             if (intent && intent.trim().length > 0 && Buffer.byteLength(output) > INTENT_SEARCH_THRESHOLD) {
                 trackIndexed(Buffer.byteLength(output));
                 return trackResponse("ctx_execute_file", {
                     content: [
-                        { type: "text", text: intentSearch(output, intent, `file:${path}:error`) },
+                        { type: "text", text: intentSearch(output, intent, isError ? `file:${path}:error` : `file:${path}`) },
                     ],
-                    isError: true,
+                    isError,
                 });
             }
             return trackResponse("ctx_execute_file", {
                 content: [
                     { type: "text", text: output },
                 ],
-                isError: true,
+                isError,
             });
         }
         const stdout = result.stdout || "(no output)";
@@ -1455,6 +1460,20 @@ async function main() {
     process.on("SIGTERM", () => { shutdown(); process.exit(0); });
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    // Write routing instructions for hookless platforms (e.g. Codex CLI)
+    try {
+        const { detectPlatform, getAdapter } = await import("./adapters/detect.js");
+        const signal = detectPlatform();
+        const adapter = await getAdapter(signal.platform);
+        if (!adapter.capabilities.sessionStart) {
+            const pluginRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+            const projectDir = process.env.CLAUDE_PROJECT_DIR ?? process.env.CODEX_HOME ?? process.cwd();
+            const written = adapter.writeRoutingInstructions(projectDir, pluginRoot);
+            if (written)
+                console.error(`Wrote routing instructions: ${written}`);
+        }
+    }
+    catch { /* best effort — don't block server startup */ }
     console.error(`Context Mode MCP server v${VERSION} running on stdio`);
     console.error(`Detected runtimes:\n${getRuntimeSummary(runtimes)}`);
     if (!hasBunRuntime()) {

package/hooks/gemini-cli/aftertool.mjs

@@ -13,7 +13,7 @@ import { readStdin, getSessionId, getSessionDBPath, getProjectDir, GEMINI_OPTS }
 import { appendFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { homedir } from "node:os";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
 const PKG_SESSION = join(HOOK_DIR, "..", "..", "build", "session");
@@ -26,8 +26,8 @@ try {
 
   appendFileSync(DEBUG_LOG, `[${new Date().toISOString()}] CALL: ${input.tool_name}\n`);
 
-  const { extractEvents } = await import(join(PKG_SESSION, "extract.js"));
-  const { SessionDB } = await import(join(PKG_SESSION, "db.js"));
+  const { extractEvents } = await import(pathToFileURL(join(PKG_SESSION, "extract.js")).href);
+  const { SessionDB } = await import(pathToFileURL(join(PKG_SESSION, "db.js")).href);
 
   const dbPath = getSessionDBPath(OPTS);
   const db = new SessionDB({ dbPath });

package/hooks/gemini-cli/precompress.mjs

@@ -12,7 +12,7 @@ import { readStdin, getSessionId, getSessionDBPath, GEMINI_OPTS } from "../sessi
 import { appendFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { homedir } from "node:os";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
 const PKG_SESSION = join(HOOK_DIR, "..", "..", "build", "session");
@@ -23,8 +23,8 @@ try {
   const raw = await readStdin();
   const input = JSON.parse(raw);
 
-  const { buildResumeSnapshot } = await import(join(PKG_SESSION, "snapshot.js"));
-  const { SessionDB } = await import(join(PKG_SESSION, "db.js"));
+  const { buildResumeSnapshot } = await import(pathToFileURL(join(PKG_SESSION, "snapshot.js")).href);
+  const { SessionDB } = await import(pathToFileURL(join(PKG_SESSION, "db.js")).href);
 
   const dbPath = getSessionDBPath(OPTS);
   const db = new SessionDB({ dbPath });