context-mode 1.0.151 → 1.0.153

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

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

@@ -3,7 +3,11 @@
     "context-mode": {
       "command": "node",
       "args": ["./start.mjs"],
-      "cwd": "."
+      "cwd": ".",
+      "env": {
+        "CONTEXT_MODE_PLATFORM": "codex"
+      },
+      "default_tools_approval_mode": "approve"
     }
   }
 }

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.151",
+  "version": "1.0.153",
   "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,12 +3,27 @@
   "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.151",
+  "version": "1.0.153",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",
     "system_access": "full"
   },
+  "contracts": {
+    "tools": [
+      "ctx_execute",
+      "ctx_execute_file",
+      "ctx_index",
+      "ctx_search",
+      "ctx_fetch_and_index",
+      "ctx_batch_execute",
+      "ctx_stats",
+      "ctx_doctor",
+      "ctx_upgrade",
+      "ctx_purge",
+      "ctx_insight"
+    ]
+  },
   "configSchema": {
     "type": "object",
     "properties": {

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.151",
+  "version": "1.0.153",
   "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

@@ -39,7 +39,7 @@ Context Mode is an MCP server that solves all four sides of this problem:
 
 1. **Context Saving** — Sandbox tools keep raw data out of the context window. 315 KB becomes 5.4 KB. 98% reduction.
 2. **Session Continuity** — Every file edit, git operation, task, error, and user decision is tracked in SQLite. When the conversation compacts, context-mode doesn't dump this data back into context — it indexes events into FTS5 and retrieves only what's relevant via BM25 search. The model picks up exactly where you left off. If you don't `--continue`, previous session data is deleted immediately — a fresh session means a clean slate.
-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 15 platforms: stop treating the LLM as a data processor, treat it as a code generator.
+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 16 platforms: stop treating the LLM as a data processor, treat it as a code generator.
 
    ```js
    // Before: 47 × Read() = 700 KB.  After: 1 × ctx_execute() = 3.6 KB.
@@ -89,11 +89,13 @@ All checks should show `[x]`. The doctor validates runtimes, hooks, FTS5, and pl
 |---|---|
 | `/context-mode:ctx-stats` | Context savings — per-tool breakdown, tokens consumed, savings ratio. |
 | `/context-mode:ctx-doctor` | Diagnostics — runtimes, hooks, FTS5, plugin registration, versions. |
+| `/context-mode:ctx-index` | Index a local file or directory into the persistent FTS5 knowledge base. |
+| `/context-mode:ctx-search` | Search previously indexed content. |
 | `/context-mode:ctx-upgrade` | Pull latest, rebuild, migrate cache, fix hooks. |
 | `/context-mode:ctx-purge` | Permanently delete all indexed content from the knowledge base. |
 | `/context-mode:ctx-insight` | Personal analytics dashboard — 90 metrics, 37 insight patterns, 4 composite scores (productivity, quality, delegation, context health) across 23 event categories. Opens a local web UI. |
 
-> **Note:** Slash commands are a Claude Code plugin feature. On other platforms, type `ctx stats`, `ctx doctor`, `ctx upgrade`, or `ctx insight` in the chat — the model calls the MCP tool automatically. See [Utility Commands](#utility-commands).
+> **Note:** Slash commands are a Claude Code plugin feature. On other platforms, type `ctx stats`, `ctx doctor`, `ctx index`, `ctx search`, `ctx upgrade`, or `ctx insight` in the chat — the model calls the MCP tool automatically. See [Utility Commands](#utility-commands).
 
 **Status line (optional):** Claude Code's plugin manifest cannot declare a status line, so this is a one-time manual edit to `~/.claude/settings.json`:
 
@@ -586,6 +588,9 @@ The Codex plugin manifest provides MCP via `.codex-plugin/mcp.json`, skills via
 
    [mcp_servers.context-mode]
    command = "context-mode"
+
+   [mcp_servers.context-mode.env]
+   CONTEXT_MODE_PLATFORM = "codex"
    ```
 
 3. Create `$CODEX_HOME/hooks.json` (or `~/.codex/hooks.json` when `CODEX_HOME` is unset):
@@ -626,6 +631,83 @@ The Codex plugin manifest provides MCP via `.codex-plugin/mcp.json`, skills via
 
 </details>
 
+<details>
+<summary><strong>Kimi Code</strong> — MCP + hooks (TOML config, same JSON wire protocol as Codex)</summary>
+
+**Prerequisites:** Node.js >= 22.5 (or Bun), Kimi Code CLI installed.
+
+1. Install context-mode:
+
+   ```bash
+   npm install -g context-mode
+   ```
+
+2. Add context-mode as an MCP server. Add to `~/.kimi-code/mcp.json`:
+
+   ```json
+   {
+     "mcpServers": {
+       "context-mode": {
+         "command": "context-mode",
+         "args": []
+       }
+     }
+   }
+   ```
+
+3. Add hooks to `~/.kimi-code/config.toml`:
+
+   ```toml
+   [[hooks]]
+   event = "PreToolUse"
+   matcher = "Bash|Shell|Read|Edit|Write|WebFetch|Agent|ctx_execute|ctx_execute_file|ctx_batch_execute|ctx_fetch_and_index|ctx_search|ctx_index|mcp__"
+   command = "context-mode hook kimi pretooluse"
+   timeout = 30
+
+   [[hooks]]
+   event = "PostToolUse"
+   command = "context-mode hook kimi posttooluse"
+   timeout = 30
+
+   [[hooks]]
+   event = "SessionStart"
+   command = "context-mode hook kimi sessionstart"
+   timeout = 30
+
+   [[hooks]]
+   event = "PreCompact"
+   command = "context-mode hook kimi precompact"
+   timeout = 30
+
+   [[hooks]]
+   event = "UserPromptSubmit"
+   command = "context-mode hook kimi userpromptsubmit"
+   timeout = 30
+
+   [[hooks]]
+   event = "Stop"
+   command = "context-mode hook kimi stop"
+   timeout = 30
+   ```
+
+4. Restart Kimi Code CLI and verify MCP with `ctx stats`.
+
+   > **Note:** Kimi Code uses the same JSON stdin/stdout wire protocol as Codex, but accepts `additionalContext`, `updatedInput`, and `permissionDecision: "ask"` in PreToolUse responses (Codex rejects these). The kimi hook normalizes `ContentPart[]` prompt arrays to strings for downstream extractors.
+
+5. (Optional) Copy the routing instructions file for your project:
+
+   ```bash
+   cp "$(npm root -g)/context-mode/configs/codex/AGENTS.md" ./AGENTS.md
+   ```
+
+   Or for global use:
+
+   ```bash
+   CM_ROOT="$(npm root -g)/context-mode"; cp "$CM_ROOT/configs/codex/AGENTS.md" ~/.kimi-code/AGENTS.md
+   ```
+
+</details>
+
 <details>
 <summary><strong>Qwen Code</strong> — MCP + hooks (identical wire protocol to Claude Code)</summary>
 
@@ -1249,6 +1331,8 @@ See [`docs/platform-support.md`](docs/platform-support.md) for the full capabili
 ```
 ctx stats       → context savings, call counts, session report
 ctx doctor      → diagnose runtimes, hooks, FTS5, versions
+ctx index       → index a local file or directory for later search
+ctx search      → search previously indexed content
 ctx upgrade     → update from GitHub, rebuild, reconfigure hooks
 ctx purge       → permanently delete all indexed content from the knowledge base
 ctx insight     → personal analytics dashboard (opens local web UI)
@@ -1258,6 +1342,8 @@ ctx insight     → personal analytics dashboard (opens local web UI)
 
 ```bash
 context-mode doctor
+context-mode index . --source project:my-app
+context-mode search "authentication middleware" --source project:my-app
 context-mode upgrade
 context-mode insight          # opens analytics dashboard in browser
 bash scripts/ctx-debug.sh    # full diagnostic report for bug reports
@@ -1265,7 +1351,7 @@ bash scripts/ctx-debug.sh    # full diagnostic report for bug reports
 
 The debug script collects OS info, runtime versions, better-sqlite3 status, adapter detection, config files (redacted), hook validation, FTS5/SQLite test, executor test, process check, session databases, and environment variables into a single pasteable markdown report.
 
-Works on **all platforms**. On Claude Code, slash commands (`/ctx-stats`, `/ctx-doctor`, `/ctx-upgrade`, `/ctx-purge`, `/ctx-insight`) are also available.
+Works on **all platforms**. On Claude Code, slash commands (`/ctx-stats`, `/ctx-doctor`, `/ctx-index`, `/ctx-search`, `/ctx-upgrade`, `/ctx-purge`, `/ctx-insight`) are also available.
 
 ## Benchmarks
 

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

@@ -1,4 +1,4 @@
-import { buildNodeCommand, parseNodeCommand } from "../types.js";
+import { buildHookRuntimeCommand, parseNodeCommand } from "../types.js";
 /**
  * adapters/claude-code/hooks — Claude Code hook definitions and matchers.
  *
@@ -136,7 +136,7 @@ export function isContextModeHook(entry, hookType) {
 export function buildHookCommand(hookType, pluginRoot) {
     if (pluginRoot) {
         const scriptName = HOOK_SCRIPTS[hookType];
-        return buildNodeCommand(`${pluginRoot}/hooks/${scriptName}`);
+        return buildHookRuntimeCommand(`${pluginRoot}/hooks/${scriptName}`);
     }
     return `context-mode hook claude-code ${hookType.toLowerCase()}`;
 }

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

@@ -18,7 +18,7 @@ import { ClaudeCodeBaseAdapter } from "../claude-code-base.js";
 import { resolveContextModeDataRoot } from "../base.js";
 import { resolveClaudeConfigDir } from "../../util/claude-config.js";
 import { checkPluginCacheIntegritySync } from "../../util/plugin-cache-integrity.js";
-import { buildNodeCommand, } from "../types.js";
+import { buildHookRuntimeCommand, } from "../types.js";
 import { HOOK_TYPES, HOOK_SCRIPTS, REQUIRED_HOOKS, PRE_TOOL_USE_MATCHERS, PRE_TOOL_USE_MATCHER_PATTERN, isContextModeHook, isAnyContextModeHook, extractHookScriptPath, buildHookCommand, } from "./hooks.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
@@ -77,20 +77,21 @@ export class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter {
         return join(this.getConfigDir(), "settings.json");
     }
     generateHookConfig(pluginRoot) {
-        // Algo-D3: every command flows through `buildNodeCommand` (defined in
-        // src/adapters/types.ts), which:
-        //   - quotes both nodePath and scriptPath (#548 — Windows pluginRoots
-        //     with spaces no longer fall through extractHookScriptPath's
-        //     ambiguous-tail fallback),
+        // Algo-D3: every command flows through `buildHookRuntimeCommand`
+        // (defined in src/adapters/types.ts), which:
+        //   - quotes both runtime path and scriptPath (#548 — Windows
+        //     pluginRoots with spaces no longer fall through
+        //     extractHookScriptPath's ambiguous-tail fallback),
         //   - swaps backslashes for forward slashes (#372 MSYS path mangling),
-        //   - uses `process.execPath` instead of bare `node` (#369 PATH
-        //     resolution on Git Bash).
+        //   - resolves the JS runtime via `resolveHookRuntime`: Bun ≥1.0 when
+        //     available, else `process.execPath` (#369 PATH resolution on Git
+        //     Bash, #738 bun cold-start win).
         // Pre-D3 we hand-rolled `node "${pluginRoot}/hooks/X.mjs"` for all
         // five events; bare `node` made claude-code the lone outlier and
         // dropping the execPath swap re-opened the Windows class. Algo-D3.5
         // (CI invariant in tests/adapters/claude-code.test.ts) locks this in
         // for adapter #16.
-        const preToolUseCommand = buildNodeCommand(`${pluginRoot}/hooks/pretooluse.mjs`);
+        const preToolUseCommand = buildHookRuntimeCommand(`${pluginRoot}/hooks/pretooluse.mjs`);
         const preToolUseMatchers = [...PRE_TOOL_USE_MATCHERS];
         return {
             PreToolUse: preToolUseMatchers.map((matcher) => ({
@@ -103,7 +104,7 @@ export class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: buildNodeCommand(`${pluginRoot}/hooks/posttooluse.mjs`),
+                            command: buildHookRuntimeCommand(`${pluginRoot}/hooks/posttooluse.mjs`),
                         },
                     ],
                 },
@@ -114,7 +115,7 @@ export class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: buildNodeCommand(`${pluginRoot}/hooks/precompact.mjs`),
+                            command: buildHookRuntimeCommand(`${pluginRoot}/hooks/precompact.mjs`),
                         },
                     ],
                 },
@@ -125,7 +126,7 @@ export class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: buildNodeCommand(`${pluginRoot}/hooks/userpromptsubmit.mjs`),
+                            command: buildHookRuntimeCommand(`${pluginRoot}/hooks/userpromptsubmit.mjs`),
                         },
                     ],
                 },
@@ -136,7 +137,7 @@ export class ClaudeCodeAdapter extends ClaudeCodeBaseAdapter {
                     hooks: [
                         {
                             type: "command",
-                            command: buildNodeCommand(`${pluginRoot}/hooks/sessionstart.mjs`),
+                            command: buildHookRuntimeCommand(`${pluginRoot}/hooks/sessionstart.mjs`),
                         },
                     ],
                 },

package/build/adapters/client-map.js

@@ -31,4 +31,7 @@ export const CLIENT_NAME_TO_PLATFORM = {
     "zed": "zed",
     "qwen-code": "qwen-code",
     "qwen-cli-mcp-client": "qwen-code",
+    "kimi-code": "kimi",
+    "kimi": "kimi",
+    "Kimi Code": "kimi",
 };

package/build/adapters/detect.js

@@ -281,6 +281,7 @@ export function getSessionDirSegments(platform) {
         case "pi": return [".pi"];
         case "omp": return [".omp"];
         case "qwen-code": return [".qwen"];
+        case "kimi": return [".kimi-code"];
         case "kilo": return [".config", "kilo"];
         case "opencode": return [".config", "opencode"];
         case "zed": return [".config", "zed"];
@@ -319,7 +320,7 @@ export function detectPlatform(clientInfo) {
     if (platformOverride) {
         const validPlatforms = [
             "claude-code", "gemini-cli", "kilo", "opencode", "codex",
-            "vscode-copilot", "jetbrains-copilot", "cursor", "antigravity", "kiro", "pi", "omp", "zed", "qwen-code",
+            "vscode-copilot", "jetbrains-copilot", "cursor", "antigravity", "kiro", "pi", "omp", "zed", "qwen-code", "kimi",
         ];
         if (validPlatforms.includes(platformOverride)) {
             return {
@@ -416,6 +417,13 @@ export function detectPlatform(clientInfo) {
             reason: "~/.qwen/ directory exists",
         };
     }
+    if (existsSync(resolve(home, ".kimi-code"))) {
+        return {
+            platform: "kimi",
+            confidence: "medium",
+            reason: "~/.kimi-code/ directory exists",
+        };
+    }
     if (existsSync(resolve(home, ".openclaw"))) {
         return {
             platform: "openclaw",
@@ -533,6 +541,10 @@ export async function getAdapter(platform) {
             const { PiAdapter } = await import("./pi/index.js");
             return new PiAdapter();
         }
+        case "kimi": {
+            const { KimiAdapter } = await import("./kimi/index.js");
+            return new KimiAdapter();
+        }
         default: {
             // Unsupported platform — fall back to Claude Code adapter
             // (MCP server works everywhere, hooks may not)

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

@@ -63,5 +63,15 @@ export declare function isContextModeHook(entry: {
  * Build the hook command string for a given hook type.
  * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
  * Falls back to CLI dispatcher if pluginRoot is not provided.
+ *
+ * Issue #712: gemini-cli hook scripts live under `hooks/gemini-cli/<script>`
+ * on disk (verified via the published `files` field in package.json and
+ * HOOK_MAP in src/cli.ts which uses the same subdir for the CLI
+ * dispatcher form). The introducing commit (f5c9d02) carried claude-code's
+ * flat `hooks/<script>` shape over without accounting for the platform
+ * subdir, causing `ctx doctor` to FAIL every hook on every install
+ * (paths pointed at `<pluginRoot>/hooks/<script>` which never exist for
+ * gemini-cli). `setHookPermissions` in index.ts already uses the correct
+ * subdir, so this restores three-callsite parity.
  */
 export declare function buildHookCommand(hookType: HookType, pluginRoot?: string): string;

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

@@ -1,4 +1,4 @@
-import { buildNodeCommand } from "../types.js";
+import { buildHookRuntimeCommand } from "../types.js";
 /**
  * adapters/gemini-cli/hooks — Gemini CLI hook definitions and matchers.
  *
@@ -87,11 +87,21 @@ export function isContextModeHook(entry, hookType) {
  * Build the hook command string for a given hook type.
  * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
  * Falls back to CLI dispatcher if pluginRoot is not provided.
+ *
+ * Issue #712: gemini-cli hook scripts live under `hooks/gemini-cli/<script>`
+ * on disk (verified via the published `files` field in package.json and
+ * HOOK_MAP in src/cli.ts which uses the same subdir for the CLI
+ * dispatcher form). The introducing commit (f5c9d02) carried claude-code's
+ * flat `hooks/<script>` shape over without accounting for the platform
+ * subdir, causing `ctx doctor` to FAIL every hook on every install
+ * (paths pointed at `<pluginRoot>/hooks/<script>` which never exist for
+ * gemini-cli). `setHookPermissions` in index.ts already uses the correct
+ * subdir, so this restores three-callsite parity.
  */
 export function buildHookCommand(hookType, pluginRoot) {
     const scriptName = HOOK_SCRIPTS[hookType];
     if (pluginRoot && scriptName) {
-        return buildNodeCommand(`${pluginRoot}/hooks/${scriptName}`);
+        return buildHookRuntimeCommand(`${pluginRoot}/hooks/gemini-cli/${scriptName}`);
     }
     return `context-mode hook gemini-cli ${hookType.toLowerCase()}`;
 }

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

@@ -19,7 +19,7 @@
  *   - Session dir: ~/.gemini/context-mode/sessions/
  */
 import { BaseAdapter } from "../base.js";
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, HealthCheck, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class GeminiCLIAdapter extends BaseAdapter implements HookAdapter {
     constructor();
     readonly name = "Gemini CLI";
@@ -39,6 +39,26 @@ export declare class GeminiCLIAdapter extends BaseAdapter implements HookAdapter
     readSettings(): Record<string, unknown> | null;
     writeSettings(settings: Record<string, unknown>): void;
     validateHooks(pluginRoot: string): DiagnosticResult[];
+    /**
+     * Adapter-defined health checks (Algo-D1) — mirrors claude-code's override
+     * at src/adapters/claude-code/index.ts:275.
+     *
+     * Issue #712 motivation: gemini-cli's hook scripts ship under
+     * `<pluginRoot>/hooks/gemini-cli/<scriptName>` (see HOOK_MAP in
+     * src/cli.ts and `setHookPermissions` in this file). The legacy doctor
+     * path (`getHookScriptPaths` -> `extractHookScriptPath`) round-trips
+     * through `buildHookCommand` -> command-string parsing, so a missing
+     * platform subdir in the emit was invisible to the doctor until a user
+     * installed globally and observed FAIL lines. This override drops the
+     * round-trip: HOOK_SCRIPTS is the single source of truth and we probe
+     * `existsSync(join(pluginRoot, "hooks", "gemini-cli", scriptName))`
+     * directly, so a future regression in the command emit cannot make the
+     * doctor lie about hook health.
+     *
+     * Adding a new hook event in HOOK_SCRIPTS auto-extends doctor coverage
+     * here — no parallel hardcoded list to maintain.
+     */
+    getHealthChecks(pluginRoot: string): readonly HealthCheck[];
     checkPluginRegistration(): DiagnosticResult;
     getInstalledVersion(): string;
     configureAllHooks(pluginRoot: string): string[];

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

@@ -18,7 +18,7 @@
  *   - Project dir env: GEMINI_PROJECT_DIR (also CLAUDE_PROJECT_DIR alias)
  *   - Session dir: ~/.gemini/context-mode/sessions/
  */
-import { readFileSync, writeFileSync, mkdirSync, accessSync, chmodSync, constants, } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, accessSync, chmodSync, existsSync, constants, } from "node:fs";
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
 import { BaseAdapter } from "../base.js";
@@ -296,6 +296,42 @@ export class GeminiCLIAdapter extends BaseAdapter {
         }
         return results;
     }
+    /**
+     * Adapter-defined health checks (Algo-D1) — mirrors claude-code's override
+     * at src/adapters/claude-code/index.ts:275.
+     *
+     * Issue #712 motivation: gemini-cli's hook scripts ship under
+     * `<pluginRoot>/hooks/gemini-cli/<scriptName>` (see HOOK_MAP in
+     * src/cli.ts and `setHookPermissions` in this file). The legacy doctor
+     * path (`getHookScriptPaths` -> `extractHookScriptPath`) round-trips
+     * through `buildHookCommand` -> command-string parsing, so a missing
+     * platform subdir in the emit was invisible to the doctor until a user
+     * installed globally and observed FAIL lines. This override drops the
+     * round-trip: HOOK_SCRIPTS is the single source of truth and we probe
+     * `existsSync(join(pluginRoot, "hooks", "gemini-cli", scriptName))`
+     * directly, so a future regression in the command emit cannot make the
+     * doctor lie about hook health.
+     *
+     * Adding a new hook event in HOOK_SCRIPTS auto-extends doctor coverage
+     * here — no parallel hardcoded list to maintain.
+     */
+    getHealthChecks(pluginRoot) {
+        return Object.entries(GEMINI_HOOK_SCRIPTS).map(([hookType, scriptName]) => {
+            const absolutePath = join(pluginRoot, "hooks", "gemini-cli", scriptName);
+            return {
+                name: `Hook script: ${hookType} (${scriptName})`,
+                check: () => {
+                    if (existsSync(absolutePath)) {
+                        return { status: "OK", detail: absolutePath };
+                    }
+                    return {
+                        status: "FAIL",
+                        detail: `not found at ${absolutePath}`,
+                    };
+                },
+            };
+        });
+    }
     checkPluginRegistration() {
         const settings = this.readSettings();
         if (!settings) {

package/build/adapters/kimi/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * adapters/kimi/config — Thin re-exports from KimiAdapter.
+ *
+ * This module exists for backward compatibility. All logic lives in the
+ * adapter class (index.ts). New code should use getAdapter() from detect.ts.
+ */
+export { KimiAdapter } from "./index.js";
+export { HOOK_TYPES, ROUTING_INSTRUCTIONS_PATH } from "./hooks.js";

package/build/adapters/kimi/config.js

@@ -0,0 +1,8 @@
+/**
+ * adapters/kimi/config — Thin re-exports from KimiAdapter.
+ *
+ * This module exists for backward compatibility. All logic lives in the
+ * adapter class (index.ts). New code should use getAdapter() from detect.ts.
+ */
+export { KimiAdapter } from "./index.js";
+export { HOOK_TYPES, ROUTING_INSTRUCTIONS_PATH } from "./hooks.js";

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

@@ -0,0 +1,28 @@
+/**
+ * adapters/kimi/hooks — Kimi Code CLI hook definitions.
+ *
+ * Kimi Code CLI hooks run behind the `[[hooks]]` array-table surface in
+ * `~/.kimi-code/config.toml`. 7 hook events: PreToolUse, PostToolUse,
+ * PreCompact, SessionStart, SessionEnd, UserPromptSubmit, Stop.
+ * Same JSON stdin/stdout wire protocol as Codex CLI.
+ *
+ * Known limitations (verified against upstream source):
+ *   - PreToolUse: deny works; updatedInput / additionalContext / ask are
+ *     silently stripped by the host runner (refs/platforms/kimi-code/...
+ *     /session/hooks/runner.ts:36-39,162-178 and types.ts:28-37).
+ *   - PostToolUse: updatedMCPToolOutput is parsed but not acted upon.
+ */
+/** Kimi Code CLI hook types — mirrors Codex CLI's events + SessionEnd. */
+export declare const HOOK_TYPES: {
+    readonly PRE_TOOL_USE: "PreToolUse";
+    readonly POST_TOOL_USE: "PostToolUse";
+    readonly PRE_COMPACT: "PreCompact";
+    readonly SESSION_START: "SessionStart";
+    readonly SESSION_END: "SessionEnd";
+    readonly USER_PROMPT_SUBMIT: "UserPromptSubmit";
+    readonly STOP: "Stop";
+};
+/**
+ * Path to the routing instructions file for Kimi Code CLI.
+ */
+export declare const ROUTING_INSTRUCTIONS_PATH = "configs/kimi/AGENTS.md";

package/build/adapters/kimi/hooks.js

@@ -0,0 +1,34 @@
+/**
+ * adapters/kimi/hooks — Kimi Code CLI hook definitions.
+ *
+ * Kimi Code CLI hooks run behind the `[[hooks]]` array-table surface in
+ * `~/.kimi-code/config.toml`. 7 hook events: PreToolUse, PostToolUse,
+ * PreCompact, SessionStart, SessionEnd, UserPromptSubmit, Stop.
+ * Same JSON stdin/stdout wire protocol as Codex CLI.
+ *
+ * Known limitations (verified against upstream source):
+ *   - PreToolUse: deny works; updatedInput / additionalContext / ask are
+ *     silently stripped by the host runner (refs/platforms/kimi-code/...
+ *     /session/hooks/runner.ts:36-39,162-178 and types.ts:28-37).
+ *   - PostToolUse: updatedMCPToolOutput is parsed but not acted upon.
+ */
+// ─────────────────────────────────────────────────────────
+// Hook type constants
+// ─────────────────────────────────────────────────────────
+/** Kimi Code CLI hook types — mirrors Codex CLI's events + SessionEnd. */
+export const HOOK_TYPES = {
+    PRE_TOOL_USE: "PreToolUse",
+    POST_TOOL_USE: "PostToolUse",
+    PRE_COMPACT: "PreCompact",
+    SESSION_START: "SessionStart",
+    SESSION_END: "SessionEnd",
+    USER_PROMPT_SUBMIT: "UserPromptSubmit",
+    STOP: "Stop",
+};
+// ─────────────────────────────────────────────────────────
+// Routing instructions
+// ─────────────────────────────────────────────────────────
+/**
+ * Path to the routing instructions file for Kimi Code CLI.
+ */
+export const ROUTING_INSTRUCTIONS_PATH = "configs/kimi/AGENTS.md";