context-mode 1.0.89 → 1.0.91

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

@@ -1,35 +1,24 @@
 /**
  * adapters/claude-code — Claude Code platform adapter.
  *
- * Implements HookAdapter for Claude Code's JSON stdin/stdout hook paradigm.
+ * Extends ClaudeCodeBaseAdapter (shared wire-protocol parse/format methods)
+ * with Claude Code-specific configuration, diagnostics, and upgrade logic.
  *
  * Claude Code hook specifics:
- *   - I/O: JSON on stdin, JSON on stdout
- *   - Arg modification: `updatedInput` field in response
- *   - Blocking: `permissionDecision: "deny"` in response
- *   - PostToolUse output: `updatedMCPToolOutput` field
- *   - PreCompact: stdout on exit 0
  *   - Session ID: transcript_path UUID > session_id > CLAUDE_SESSION_ID > ppid
  *   - Config: ~/.claude/settings.json
  *   - Session dir: ~/.claude/context-mode/sessions/
+ *   - Plugin registry: ~/.claude/plugins/installed_plugins.json
  */
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
-export declare class ClaudeCodeAdapter implements HookAdapter {
+import { ClaudeCodeBaseAdapter, type ClaudeCodeWireInput } from "../claude-code-base.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, HookRegistration } from "../types.js";
+export declare class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter implements HookAdapter {
+    constructor();
     readonly name = "Claude Code";
     readonly paradigm: HookParadigm;
+    protected readonly projectDirEnvVar = "CLAUDE_PROJECT_DIR";
     readonly capabilities: PlatformCapabilities;
-    parsePreToolUseInput(raw: unknown): PreToolUseEvent;
-    parsePostToolUseInput(raw: unknown): PostToolUseEvent;
-    parsePreCompactInput(raw: unknown): PreCompactEvent;
-    parseSessionStartInput(raw: unknown): SessionStartEvent;
-    formatPreToolUseResponse(response: PreToolUseResponse): unknown;
-    formatPostToolUseResponse(response: PostToolUseResponse): unknown;
-    formatPreCompactResponse(response: PreCompactResponse): unknown;
-    formatSessionStartResponse(response: SessionStartResponse): unknown;
     getSettingsPath(): string;
-    getSessionDir(): string;
-    getSessionDBPath(projectDir: string): string;
-    getSessionEventsPath(projectDir: string): string;
     generateHookConfig(pluginRoot: string): HookRegistration;
     readSettings(): Record<string, unknown> | null;
     writeSettings(settings: Record<string, unknown>): void;
@@ -41,12 +30,7 @@ export declare class ClaudeCodeAdapter implements HookAdapter {
     checkPluginRegistration(): DiagnosticResult;
     getInstalledVersion(): string;
     configureAllHooks(pluginRoot: string): string[];
-    backupSettings(): string | null;
     setHookPermissions(pluginRoot: string): string[];
     updatePluginRegistry(pluginRoot: string, version: string): void;
-    /**
-     * Extract session ID from Claude Code hook input.
-     * Priority: transcript_path UUID > session_id field > CLAUDE_SESSION_ID env > ppid fallback.
-     */
-    private extractSessionId;
+    protected extractSessionId(input: ClaudeCodeWireInput): string;
 }

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

@@ -1,29 +1,30 @@
 /**
  * adapters/claude-code — Claude Code platform adapter.
  *
- * Implements HookAdapter for Claude Code's JSON stdin/stdout hook paradigm.
+ * Extends ClaudeCodeBaseAdapter (shared wire-protocol parse/format methods)
+ * with Claude Code-specific configuration, diagnostics, and upgrade logic.
  *
  * Claude Code hook specifics:
- *   - I/O: JSON on stdin, JSON on stdout
- *   - Arg modification: `updatedInput` field in response
- *   - Blocking: `permissionDecision: "deny"` in response
- *   - PostToolUse output: `updatedMCPToolOutput` field
- *   - PreCompact: stdout on exit 0
  *   - Session ID: transcript_path UUID > session_id > CLAUDE_SESSION_ID > ppid
  *   - Config: ~/.claude/settings.json
  *   - Session dir: ~/.claude/context-mode/sessions/
+ *   - Plugin registry: ~/.claude/plugins/installed_plugins.json
  */
-import { createHash } from "node:crypto";
-import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, existsSync, readdirSync, chmodSync, constants, } from "node:fs";
+import { readFileSync, writeFileSync, existsSync, readdirSync, chmodSync, accessSync, constants, } from "node:fs";
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
+import { ClaudeCodeBaseAdapter } from "../claude-code-base.js";
 import { HOOK_TYPES, HOOK_SCRIPTS, REQUIRED_HOOKS, PRE_TOOL_USE_MATCHER_PATTERN, isContextModeHook, isAnyContextModeHook, extractHookScriptPath, buildHookCommand, } from "./hooks.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
-export class ClaudeCodeAdapter {
+export class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter {
+    constructor() {
+        super([".claude"]);
+    }
     name = "Claude Code";
     paradigm = "json-stdio";
+    projectDirEnvVar = "CLAUDE_PROJECT_DIR";
     capabilities = {
         preToolUse: true,
         postToolUse: true,
@@ -33,124 +34,10 @@ export class ClaudeCodeAdapter {
         canModifyOutput: true,
         canInjectSessionContext: true,
     };
-    // ── Input parsing ──────────────────────────────────────
-    parsePreToolUseInput(raw) {
-        const input = raw;
-        return {
-            toolName: input.tool_name ?? "",
-            toolInput: input.tool_input ?? {},
-            sessionId: this.extractSessionId(input),
-            projectDir: process.env.CLAUDE_PROJECT_DIR,
-            raw,
-        };
-    }
-    parsePostToolUseInput(raw) {
-        const input = raw;
-        return {
-            toolName: input.tool_name ?? "",
-            toolInput: input.tool_input ?? {},
-            toolOutput: input.tool_output,
-            isError: input.is_error,
-            sessionId: this.extractSessionId(input),
-            projectDir: process.env.CLAUDE_PROJECT_DIR,
-            raw,
-        };
-    }
-    parsePreCompactInput(raw) {
-        const input = raw;
-        return {
-            sessionId: this.extractSessionId(input),
-            projectDir: process.env.CLAUDE_PROJECT_DIR,
-            raw,
-        };
-    }
-    parseSessionStartInput(raw) {
-        const input = raw;
-        const rawSource = input.source ?? "startup";
-        let source;
-        switch (rawSource) {
-            case "compact":
-                source = "compact";
-                break;
-            case "resume":
-                source = "resume";
-                break;
-            case "clear":
-                source = "clear";
-                break;
-            default:
-                source = "startup";
-        }
-        return {
-            sessionId: this.extractSessionId(input),
-            source,
-            projectDir: process.env.CLAUDE_PROJECT_DIR,
-            raw,
-        };
-    }
-    // ── Response formatting ────────────────────────────────
-    formatPreToolUseResponse(response) {
-        if (response.decision === "deny") {
-            return {
-                permissionDecision: "deny",
-                reason: response.reason ?? "Blocked by context-mode hook",
-            };
-        }
-        if (response.decision === "modify" && response.updatedInput) {
-            return { updatedInput: response.updatedInput };
-        }
-        if (response.decision === "context" && response.additionalContext) {
-            // Claude Code: inject additionalContext into model context
-            return { additionalContext: response.additionalContext };
-        }
-        if (response.decision === "ask") {
-            // Claude Code: native "ask" — prompt user for permission
-            return { permissionDecision: "ask" };
-        }
-        // "allow" — return null/undefined for passthrough
-        return undefined;
-    }
-    formatPostToolUseResponse(response) {
-        const result = {};
-        if (response.additionalContext) {
-            result.additionalContext = response.additionalContext;
-        }
-        if (response.updatedOutput) {
-            result.updatedMCPToolOutput = response.updatedOutput;
-        }
-        return Object.keys(result).length > 0 ? result : undefined;
-    }
-    formatPreCompactResponse(response) {
-        // Claude Code: stdout content on exit 0 is injected as context
-        return response.context ?? "";
-    }
-    formatSessionStartResponse(response) {
-        // Claude Code: stdout content is injected as additional context
-        return response.context ?? "";
-    }
     // ── Configuration ──────────────────────────────────────
     getSettingsPath() {
         return resolve(homedir(), ".claude", "settings.json");
     }
-    getSessionDir() {
-        const dir = join(homedir(), ".claude", "context-mode", "sessions");
-        mkdirSync(dir, { recursive: true });
-        return dir;
-    }
-    getSessionDBPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}.db`);
-    }
-    getSessionEventsPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}-events.md`);
-    }
     generateHookConfig(pluginRoot) {
         const preToolUseCommand = `node ${pluginRoot}/hooks/pretooluse.mjs`;
         const preToolUseMatchers = [
@@ -500,18 +387,6 @@ export class ClaudeCodeAdapter {
         this.writeSettings(settings);
         return changes;
     }
-    backupSettings() {
-        const settingsPath = this.getSettingsPath();
-        try {
-            accessSync(settingsPath, constants.R_OK);
-            const backupPath = settingsPath + ".bak";
-            copyFileSync(settingsPath, backupPath);
-            return backupPath;
-        }
-        catch {
-            return null;
-        }
-    }
     setHookPermissions(pluginRoot) {
         const set = [];
         for (const [, scriptName] of Object.entries(HOOK_SCRIPTS)) {
@@ -546,11 +421,8 @@ export class ClaudeCodeAdapter {
             /* best effort */
         }
     }
-    // ── Internal helpers ───────────────────────────────────
-    /**
-     * Extract session ID from Claude Code hook input.
-     * Priority: transcript_path UUID > session_id field > CLAUDE_SESSION_ID env > ppid fallback.
-     */
+    // ── Session ID extraction ───────────────────────────────
+    // Claude Code priority: transcript_path UUID > session_id > CLAUDE_SESSION_ID > ppid
     extractSessionId(input) {
         if (input.transcript_path) {
             const match = input.transcript_path.match(/([a-f0-9-]{36})\.jsonl$/);

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

@@ -0,0 +1,49 @@
+/**
+ * adapters/claude-code-base — Shared base for Claude Code wire-protocol adapters.
+ *
+ * Claude Code and Qwen Code use the identical JSON stdin/stdout hook protocol:
+ *   - Input fields: tool_name, tool_input, tool_output, is_error, session_id,
+ *     transcript_path, source
+ *   - Blocking: `permissionDecision: "deny"` in response
+ *   - Arg modification: `updatedInput` field in response
+ *   - Output modification: `updatedMCPToolOutput` field in response
+ *   - Context injection: `additionalContext` at response root (not wrapped)
+ *   - PreCompact/SessionStart: stdout on exit 0
+ *
+ * This base class implements the 8 shared parse/format methods.
+ * Subclasses provide platform-specific config (env vars, settings path,
+ * session ID priority, hook config, diagnostics, upgrade).
+ */
+import { BaseAdapter } from "./base.js";
+import type { PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse } from "./types.js";
+export interface ClaudeCodeWireInput {
+    tool_name?: string;
+    tool_input?: Record<string, unknown>;
+    tool_output?: string;
+    is_error?: boolean;
+    session_id?: string;
+    transcript_path?: string;
+    source?: string;
+}
+export declare abstract class ClaudeCodeBaseAdapter extends BaseAdapter {
+    /**
+     * Environment variable name for the project directory.
+     * Claude Code: "CLAUDE_PROJECT_DIR", Qwen Code: "QWEN_PROJECT_DIR"
+     */
+    protected abstract readonly projectDirEnvVar: string;
+    parsePreToolUseInput(raw: unknown): PreToolUseEvent;
+    parsePostToolUseInput(raw: unknown): PostToolUseEvent;
+    parsePreCompactInput(raw: unknown): PreCompactEvent;
+    parseSessionStartInput(raw: unknown): SessionStartEvent;
+    formatPreToolUseResponse(response: PreToolUseResponse): unknown;
+    formatPostToolUseResponse(response: PostToolUseResponse): unknown;
+    formatPreCompactResponse(response: PreCompactResponse): unknown;
+    formatSessionStartResponse(response: SessionStartResponse): unknown;
+    /**
+     * Extract session ID from wire input. Default priority (Claude Code):
+     *   transcript_path UUID > session_id > env var > ppid fallback
+     *
+     * Override in subclasses for different priority (e.g., Qwen: session_id first).
+     */
+    protected abstract extractSessionId(input: ClaudeCodeWireInput): string;
+}

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

@@ -0,0 +1,113 @@
+/**
+ * adapters/claude-code-base — Shared base for Claude Code wire-protocol adapters.
+ *
+ * Claude Code and Qwen Code use the identical JSON stdin/stdout hook protocol:
+ *   - Input fields: tool_name, tool_input, tool_output, is_error, session_id,
+ *     transcript_path, source
+ *   - Blocking: `permissionDecision: "deny"` in response
+ *   - Arg modification: `updatedInput` field in response
+ *   - Output modification: `updatedMCPToolOutput` field in response
+ *   - Context injection: `additionalContext` at response root (not wrapped)
+ *   - PreCompact/SessionStart: stdout on exit 0
+ *
+ * This base class implements the 8 shared parse/format methods.
+ * Subclasses provide platform-specific config (env vars, settings path,
+ * session ID priority, hook config, diagnostics, upgrade).
+ */
+import { BaseAdapter } from "./base.js";
+// ─────────────────────────────────────────────────────────
+// Base adapter for Claude Code wire protocol
+// ─────────────────────────────────────────────────────────
+export class ClaudeCodeBaseAdapter extends BaseAdapter {
+    // ── Input parsing (shared wire format) ─────────────────
+    parsePreToolUseInput(raw) {
+        const input = raw;
+        return {
+            toolName: input.tool_name ?? "",
+            toolInput: input.tool_input ?? {},
+            sessionId: this.extractSessionId(input),
+            projectDir: process.env[this.projectDirEnvVar],
+            raw,
+        };
+    }
+    parsePostToolUseInput(raw) {
+        const input = raw;
+        return {
+            toolName: input.tool_name ?? "",
+            toolInput: input.tool_input ?? {},
+            toolOutput: input.tool_output,
+            isError: input.is_error,
+            sessionId: this.extractSessionId(input),
+            projectDir: process.env[this.projectDirEnvVar],
+            raw,
+        };
+    }
+    parsePreCompactInput(raw) {
+        const input = raw;
+        return {
+            sessionId: this.extractSessionId(input),
+            projectDir: process.env[this.projectDirEnvVar],
+            raw,
+        };
+    }
+    parseSessionStartInput(raw) {
+        const input = raw;
+        const rawSource = input.source ?? "startup";
+        let source;
+        switch (rawSource) {
+            case "compact":
+                source = "compact";
+                break;
+            case "resume":
+                source = "resume";
+                break;
+            case "clear":
+                source = "clear";
+                break;
+            default:
+                source = "startup";
+        }
+        return {
+            sessionId: this.extractSessionId(input),
+            source,
+            projectDir: process.env[this.projectDirEnvVar],
+            raw,
+        };
+    }
+    // ── Response formatting (shared wire format) ───────────
+    formatPreToolUseResponse(response) {
+        if (response.decision === "deny") {
+            return {
+                permissionDecision: "deny",
+                reason: response.reason ?? "Blocked by context-mode hook",
+            };
+        }
+        if (response.decision === "modify" && response.updatedInput) {
+            return { updatedInput: response.updatedInput };
+        }
+        if (response.decision === "context" && response.additionalContext) {
+            return { additionalContext: response.additionalContext };
+        }
+        if (response.decision === "ask") {
+            return { permissionDecision: "ask" };
+        }
+        // "allow" — return undefined for passthrough
+        return undefined;
+    }
+    formatPostToolUseResponse(response) {
+        const result = {};
+        if (response.additionalContext) {
+            result.additionalContext = response.additionalContext;
+        }
+        if (response.updatedOutput) {
+            result.updatedMCPToolOutput = response.updatedOutput;
+        }
+        return Object.keys(result).length > 0 ? result : undefined;
+    }
+    formatPreCompactResponse(response) {
+        return response.context ?? "";
+    }
+    formatSessionStartResponse(response) {
+        return response.context ?? "";
+    }
+}

package/build/adapters/client-map.js

@@ -12,6 +12,9 @@ export const CLIENT_NAME_TO_PLATFORM = {
     "antigravity-client": "antigravity",
     "cursor-vscode": "cursor",
     "Visual-Studio-Code": "vscode-copilot",
+    "JetBrains Client": "jetbrains-copilot",
+    "IntelliJ IDEA": "jetbrains-copilot",
+    "PyCharm": "jetbrains-copilot",
     "Codex": "codex",
     "codex-mcp-client": "codex",
     "Kilo Code": "kilo",
@@ -20,4 +23,6 @@ export const CLIENT_NAME_TO_PLATFORM = {
     "Pi Coding Agent": "pi",
     "Zed": "zed",
     "zed": "zed",
+    "qwen-code": "qwen-code",
+    "qwen-cli-mcp-client": "qwen-code",
 };

package/build/adapters/codex/hooks.d.ts

@@ -1,21 +1,28 @@
 /**
- * adapters/codex/hooks — Codex CLI hook definitions (stub).
+ * adapters/codex/hooks — Codex CLI hook definitions.
  *
- * Codex CLI does NOT support hooks (PRs #2904, #9796 were closed without merge).
- * Only MCP integration is available. This module exports empty/stub constants
- * for interface consistency with other adapters.
+ * Codex CLI hooks are stable (codex_hooks Stage::Stable, default_enabled: true).
+ * 5 hook events: PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop.
+ * Same JSON stdin/stdout wire protocol as Claude Code.
  *
- * Config: ~/.codex/config.toml (TOML format, not JSON)
- * MCP: full support via [mcp_servers] in config.toml
- */
-/**
- * Codex CLI hook types — empty object.
- * Codex CLI has no hook support; only MCP integration is available.
+ * Config: ~/.codex/hooks.json (JSON format, same schema as Claude Code)
+ * MCP: full support via [mcp_servers] in ~/.codex/config.toml
+ *
+ * Known limitations:
+ *   - PreToolUse: deny works, updatedInput not yet supported (openai/codex#18491)
+ *   - PostToolUse: updatedMCPToolOutput parsed but logged as unsupported
+ *   - PostToolUse does not fire on failing Bash calls (upstream bug)
  */
-export declare const HOOK_TYPES: {};
+/** Codex CLI hook types — mirrors Claude Code's 5-event model. */
+export declare const HOOK_TYPES: {
+    readonly PRE_TOOL_USE: "PreToolUse";
+    readonly POST_TOOL_USE: "PostToolUse";
+    readonly SESSION_START: "SessionStart";
+    readonly USER_PROMPT_SUBMIT: "UserPromptSubmit";
+    readonly STOP: "Stop";
+};
 /**
- * Path to the routing instructions file appended to the system prompt
- * when Codex CLI initializes the MCP server. This is the only integration
- * point since hooks are not supported.
+ * Path to the routing instructions file for Codex CLI.
+ * Used as fallback routing awareness alongside hook-based enforcement.
  */
 export declare const ROUTING_INSTRUCTIONS_PATH = "configs/codex/AGENTS.md";

package/build/adapters/codex/hooks.js

@@ -1,27 +1,34 @@
 /**
- * adapters/codex/hooks — Codex CLI hook definitions (stub).
+ * adapters/codex/hooks — Codex CLI hook definitions.
  *
- * Codex CLI does NOT support hooks (PRs #2904, #9796 were closed without merge).
- * Only MCP integration is available. This module exports empty/stub constants
- * for interface consistency with other adapters.
+ * Codex CLI hooks are stable (codex_hooks Stage::Stable, default_enabled: true).
+ * 5 hook events: PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop.
+ * Same JSON stdin/stdout wire protocol as Claude Code.
  *
- * Config: ~/.codex/config.toml (TOML format, not JSON)
- * MCP: full support via [mcp_servers] in config.toml
+ * Config: ~/.codex/hooks.json (JSON format, same schema as Claude Code)
+ * MCP: full support via [mcp_servers] in ~/.codex/config.toml
+ *
+ * Known limitations:
+ *   - PreToolUse: deny works, updatedInput not yet supported (openai/codex#18491)
+ *   - PostToolUse: updatedMCPToolOutput parsed but logged as unsupported
+ *   - PostToolUse does not fire on failing Bash calls (upstream bug)
  */
 // ─────────────────────────────────────────────────────────
-// Hook type constants (empty — no hook support)
+// Hook type constants
 // ─────────────────────────────────────────────────────────
-/**
- * Codex CLI hook types — empty object.
- * Codex CLI has no hook support; only MCP integration is available.
- */
-export const HOOK_TYPES = {};
+/** Codex CLI hook types — mirrors Claude Code's 5-event model. */
+export const HOOK_TYPES = {
+    PRE_TOOL_USE: "PreToolUse",
+    POST_TOOL_USE: "PostToolUse",
+    SESSION_START: "SessionStart",
+    USER_PROMPT_SUBMIT: "UserPromptSubmit",
+    STOP: "Stop",
+};
 // ─────────────────────────────────────────────────────────
 // Routing instructions
 // ─────────────────────────────────────────────────────────
 /**
- * Path to the routing instructions file appended to the system prompt
- * when Codex CLI initializes the MCP server. This is the only integration
- * point since hooks are not supported.
+ * Path to the routing instructions file for Codex CLI.
+ * Used as fallback routing awareness alongside hook-based enforcement.
  */
 export const ROUTING_INSTRUCTIONS_PATH = "configs/codex/AGENTS.md";

package/build/adapters/codex/index.d.ts

@@ -9,14 +9,14 @@
  *   - Config: ~/.codex/hooks.json + ~/.codex/config.toml (TOML for MCP/features)
  *   - Session dir: ~/.codex/context-mode/sessions/
  *
- * IMPORTANT: Hook dispatch is NOT yet active in Codex CLI (v0.118.0).
- * codex_hooks feature flag is Stage::UnderDevelopment — hooks are implemented
- * in codex-rs/hooks/ but not wired into the tool execution pipeline.
- * Our adapter is ready; it will work once Codex enables dispatch.
- * Track: https://github.com/openai/codex/issues/16685
+ * Hook dispatch is stable in Codex CLI. PreToolUse deny decisions work,
+ * while input rewriting remains blocked on upstream updatedInput support.
+ * Track: https://github.com/openai/codex/issues/18491
  */
+import { BaseAdapter } from "../base.js";
 import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
-export declare class CodexAdapter implements HookAdapter {
+export declare class CodexAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
     readonly name = "Codex CLI";
     readonly paradigm: HookParadigm;
     readonly capabilities: PlatformCapabilities;
@@ -29,9 +29,6 @@ export declare class CodexAdapter implements HookAdapter {
     formatPreCompactResponse(response: PreCompactResponse): unknown;
     formatSessionStartResponse(response: SessionStartResponse): unknown;
     getSettingsPath(): string;
-    getSessionDir(): string;
-    getSessionDBPath(projectDir: string): string;
-    getSessionEventsPath(projectDir: string): string;
     generateHookConfig(pluginRoot: string): HookRegistration;
     readSettings(): Record<string, unknown> | null;
     writeSettings(_settings: Record<string, unknown>): void;
@@ -39,7 +36,6 @@ export declare class CodexAdapter implements HookAdapter {
     checkPluginRegistration(): DiagnosticResult;
     getInstalledVersion(): string;
     configureAllHooks(_pluginRoot: string): string[];
-    backupSettings(): string | null;
     setHookPermissions(_pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
     getRoutingInstructions(): string;

package/build/adapters/codex/index.js

@@ -9,21 +9,22 @@
  *   - Config: ~/.codex/hooks.json + ~/.codex/config.toml (TOML for MCP/features)
  *   - Session dir: ~/.codex/context-mode/sessions/
  *
- * IMPORTANT: Hook dispatch is NOT yet active in Codex CLI (v0.118.0).
- * codex_hooks feature flag is Stage::UnderDevelopment — hooks are implemented
- * in codex-rs/hooks/ but not wired into the tool execution pipeline.
- * Our adapter is ready; it will work once Codex enables dispatch.
- * Track: https://github.com/openai/codex/issues/16685
+ * Hook dispatch is stable in Codex CLI. PreToolUse deny decisions work,
+ * while input rewriting remains blocked on upstream updatedInput support.
+ * Track: https://github.com/openai/codex/issues/18491
  */
-import { createHash } from "node:crypto";
-import { readFileSync, mkdirSync, copyFileSync, accessSync, constants, } from "node:fs";
-import { resolve, join, dirname } from "node:path";
+import { readFileSync, } from "node:fs";
+import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
+import { BaseAdapter } from "../base.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
-export class CodexAdapter {
+export class CodexAdapter extends BaseAdapter {
+    constructor() {
+        super([".codex"]);
+    }
     name = "Codex CLI";
     paradigm = "json-stdio";
     capabilities = {
@@ -146,30 +147,11 @@ export class CodexAdapter {
     getSettingsPath() {
         return resolve(homedir(), ".codex", "config.toml");
     }
-    getSessionDir() {
-        const dir = join(homedir(), ".codex", "context-mode", "sessions");
-        mkdirSync(dir, { recursive: true });
-        return dir;
-    }
-    getSessionDBPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}.db`);
-    }
-    getSessionEventsPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}-events.md`);
-    }
     generateHookConfig(pluginRoot) {
         return {
             PreToolUse: [
                 {
-                    matcher: "",
+                    matcher: "local_shell|shell|shell_command|exec_command|container.exec|Bash|Shell|grep_files|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",
                     hooks: [
                         {
                             type: "command",
@@ -225,8 +207,8 @@ export class CodexAdapter {
         return [
             {
                 check: "Hook support",
-                status: "warn",
-                message: "Codex CLI hooks are implemented but dispatch is not yet active (Stage::UnderDevelopment, v0.118.0). Enable flag: [features] codex_hooks = true in ~/.codex/config.toml. Track: openai/codex#16685",
+                status: "pass",
+                message: "Codex CLI hooks are stable. Configure ~/.codex/hooks.json for PreToolUse, PostToolUse, and SessionStart.",
             },
         ];
     }
@@ -275,18 +257,6 @@ export class CodexAdapter {
         // Codex CLI hook configuration is done via hooks.json, not config.toml
         return [];
     }
-    backupSettings() {
-        const settingsPath = this.getSettingsPath();
-        try {
-            accessSync(settingsPath, constants.R_OK);
-            const backupPath = settingsPath + ".bak";
-            copyFileSync(settingsPath, backupPath);
-            return backupPath;
-        }
-        catch {
-            return null;
-        }
-    }
     setHookPermissions(_pluginRoot) {
         // Hook permissions are set during plugin install
         return [];