context-mode 1.0.88 → 1.0.90

package/build/adapters/detect.js

@@ -15,11 +15,29 @@
  *   - Codex CLI:      CODEX_CI, CODEX_THREAD_ID | ~/.codex/
  *   - Cursor:         CURSOR_TRACE_ID (MCP), CURSOR_CLI (terminal) | ~/.cursor/
  *   - VS Code Copilot: VSCODE_PID, VSCODE_CWD | ~/.vscode/
+ *   - JetBrains Copilot: IDEA_INITIAL_DIRECTORY, IDEA_HOME, JETBRAINS_CLIENT_ID | ~/.config/JetBrains/
  */
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { homedir } from "node:os";
 import { CLIENT_NAME_TO_PLATFORM } from "./client-map.js";
+/**
+ * High-confidence env vars per platform, checked in priority order.
+ * Single source of truth — consumed by detectPlatform() below and by
+ * tests that need to clear platform-related env vars deterministically.
+ */
+export const PLATFORM_ENV_VARS = [
+    ["claude-code", ["CLAUDE_PROJECT_DIR", "CLAUDE_SESSION_ID"]],
+    ["gemini-cli", ["GEMINI_PROJECT_DIR", "GEMINI_CLI"]],
+    ["openclaw", ["OPENCLAW_HOME", "OPENCLAW_CLI"]],
+    ["kilo", ["KILO", "KILO_PID"]],
+    ["opencode", ["OPENCODE", "OPENCODE_PID"]],
+    ["codex", ["CODEX_CI", "CODEX_THREAD_ID"]],
+    ["cursor", ["CURSOR_TRACE_ID", "CURSOR_CLI"]],
+    ["vscode-copilot", ["VSCODE_PID", "VSCODE_CWD"]],
+    ["jetbrains-copilot", ["IDEA_INITIAL_DIRECTORY", "IDEA_HOME", "JETBRAINS_CLIENT_ID"]],
+    ["qwen-code", ["QWEN_PROJECT_DIR", "QWEN_SESSION_ID"]],
+];
 /**
  * Detect the current platform by checking env vars and config dirs.
  *
@@ -37,13 +55,21 @@ export function detectPlatform(clientInfo) {
                 reason: `MCP clientInfo.name="${clientInfo.name}"`,
             };
         }
+        // Qwen Code uses dynamic client names: qwen-cli-mcp-client-<serverName>
+        if (clientInfo.name.startsWith("qwen-cli-mcp-client")) {
+            return {
+                platform: "qwen-code",
+                confidence: "high",
+                reason: `MCP clientInfo.name="${clientInfo.name}" (qwen-cli pattern)`,
+            };
+        }
     }
     // ── Explicit platform override ────────────────────────
     const platformOverride = process.env.CONTEXT_MODE_PLATFORM;
     if (platformOverride) {
         const validPlatforms = [
             "claude-code", "gemini-cli", "kilo", "opencode", "codex",
-            "vscode-copilot", "cursor", "antigravity", "kiro", "pi", "zed",
+            "vscode-copilot", "jetbrains-copilot", "cursor", "antigravity", "kiro", "pi", "zed", "qwen-code",
         ];
         if (validPlatforms.includes(platformOverride)) {
             return {
@@ -54,61 +80,14 @@ export function detectPlatform(clientInfo) {
         }
     }
     // ── High confidence: environment variables ─────────────
-    if (process.env.CLAUDE_PROJECT_DIR || process.env.CLAUDE_SESSION_ID) {
-        return {
-            platform: "claude-code",
-            confidence: "high",
-            reason: "CLAUDE_PROJECT_DIR or CLAUDE_SESSION_ID env var set",
-        };
-    }
-    if (process.env.GEMINI_PROJECT_DIR || process.env.GEMINI_CLI) {
-        return {
-            platform: "gemini-cli",
-            confidence: "high",
-            reason: "GEMINI_PROJECT_DIR or GEMINI_CLI env var set",
-        };
-    }
-    if (process.env.OPENCLAW_HOME || process.env.OPENCLAW_CLI) {
-        return {
-            platform: "openclaw",
-            confidence: "high",
-            reason: "OPENCLAW_HOME or OPENCLAW_CLI env var set",
-        };
-    }
-    if (process.env.KILO || process.env.KILO_PID) {
-        return {
-            platform: "kilo",
-            confidence: "high",
-            reason: "KILO or KILO_PID env var set",
-        };
-    }
-    if (process.env.OPENCODE || process.env.OPENCODE_PID) {
-        return {
-            platform: "opencode",
-            confidence: "high",
-            reason: "OPENCODE or OPENCODE_PID env var set",
-        };
-    }
-    if (process.env.CODEX_CI || process.env.CODEX_THREAD_ID) {
-        return {
-            platform: "codex",
-            confidence: "high",
-            reason: "CODEX_CI or CODEX_THREAD_ID env var set",
-        };
-    }
-    if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_CLI) {
-        return {
-            platform: "cursor",
-            confidence: "high",
-            reason: "CURSOR_TRACE_ID or CURSOR_CLI env var set",
-        };
-    }
-    if (process.env.VSCODE_PID || process.env.VSCODE_CWD) {
-        return {
-            platform: "vscode-copilot",
-            confidence: "high",
-            reason: "VSCODE_PID or VSCODE_CWD env var set",
-        };
+    for (const [platform, vars] of PLATFORM_ENV_VARS) {
+        if (vars.some((v) => process.env[v])) {
+            return {
+                platform,
+                confidence: "high",
+                reason: `${vars.join(" or ")} env var set`,
+            };
+        }
     }
     // ── Medium confidence: config directory existence ──────
     const home = homedir();
@@ -154,6 +133,13 @@ export function detectPlatform(clientInfo) {
             reason: "~/.pi/ directory exists",
         };
     }
+    if (existsSync(resolve(home, ".qwen"))) {
+        return {
+            platform: "qwen-code",
+            confidence: "medium",
+            reason: "~/.qwen/ directory exists",
+        };
+    }
     if (existsSync(resolve(home, ".openclaw"))) {
         return {
             platform: "openclaw",
@@ -168,6 +154,13 @@ export function detectPlatform(clientInfo) {
             reason: "~/.config/kilo/ directory exists",
         };
     }
+    if (existsSync(resolve(home, ".config", "JetBrains"))) {
+        return {
+            platform: "jetbrains-copilot",
+            confidence: "medium",
+            reason: "~/.config/JetBrains/ directory exists",
+        };
+    }
     if (existsSync(resolve(home, ".config", "opencode"))) {
         return {
             platform: "opencode",
@@ -221,6 +214,10 @@ export async function getAdapter(platform) {
             const { VSCodeCopilotAdapter } = await import("./vscode-copilot/index.js");
             return new VSCodeCopilotAdapter();
         }
+        case "jetbrains-copilot": {
+            const { JetBrainsCopilotAdapter } = await import("./jetbrains-copilot/index.js");
+            return new JetBrainsCopilotAdapter();
+        }
         case "cursor": {
             const { CursorAdapter } = await import("./cursor/index.js");
             return new CursorAdapter();
@@ -237,6 +234,10 @@ export async function getAdapter(platform) {
             const { ZedAdapter } = await import("./zed/index.js");
             return new ZedAdapter();
         }
+        case "qwen-code": {
+            const { QwenCodeAdapter } = await import("./qwen-code/index.js");
+            return new QwenCodeAdapter();
+        }
         default: {
             // Unsupported platform — fall back to Claude Code adapter
             // (MCP server works everywhere, hooks may not)

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

@@ -18,8 +18,10 @@
  *   - Project dir env: GEMINI_PROJECT_DIR (also CLAUDE_PROJECT_DIR alias)
  *   - 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";
-export declare class GeminiCLIAdapter implements HookAdapter {
+export declare class GeminiCLIAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
     readonly name = "Gemini CLI";
     readonly paradigm: HookParadigm;
     readonly capabilities: PlatformCapabilities;
@@ -32,9 +34,6 @@ export declare class GeminiCLIAdapter 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;
@@ -42,7 +41,6 @@ export declare class GeminiCLIAdapter implements HookAdapter {
     checkPluginRegistration(): DiagnosticResult;
     getInstalledVersion(): string;
     configureAllHooks(pluginRoot: string): string[];
-    backupSettings(): string | null;
     setHookPermissions(pluginRoot: string): string[];
     updatePluginRegistry(pluginRoot: string, version: string): void;
     /** Get the project directory from environment variables. */

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

@@ -18,10 +18,10 @@
  *   - Project dir env: GEMINI_PROJECT_DIR (also CLAUDE_PROJECT_DIR alias)
  *   - Session dir: ~/.gemini/context-mode/sessions/
  */
-import { createHash } from "node:crypto";
-import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, chmodSync, constants, } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, accessSync, chmodSync, constants, } from "node:fs";
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
+import { BaseAdapter } from "../base.js";
 // ─────────────────────────────────────────────────────────
 // Hook constants (re-exported from hooks.ts)
 // ─────────────────────────────────────────────────────────
@@ -29,7 +29,10 @@ import { HOOK_TYPES as GEMINI_HOOK_NAMES, HOOK_SCRIPTS as GEMINI_HOOK_SCRIPTS, b
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
-export class GeminiCLIAdapter {
+export class GeminiCLIAdapter extends BaseAdapter {
+    constructor() {
+        super([".gemini"]);
+    }
     name = "Gemini CLI";
     paradigm = "json-stdio";
     capabilities = {
@@ -157,30 +160,11 @@ export class GeminiCLIAdapter {
     getSettingsPath() {
         return resolve(homedir(), ".gemini", "settings.json");
     }
-    getSessionDir() {
-        const dir = join(homedir(), ".gemini", "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 {
             [GEMINI_HOOK_NAMES.BEFORE_TOOL]: [
                 {
-                    matcher: "",
+                    matcher: "run_shell_command|read_file|read_many_files|grep_search|search_file_content|web_fetch|activate_skill|mcp__plugin_context-mode",
                     hooks: [
                         {
                             type: "command",
@@ -378,18 +362,6 @@ export class GeminiCLIAdapter {
         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 = [];
         const hooksDir = join(pluginRoot, "hooks", "gemini-cli");

package/build/adapters/jetbrains-copilot/config.d.ts

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

package/build/adapters/jetbrains-copilot/config.js

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

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

@@ -0,0 +1,51 @@
+/**
+ * adapters/jetbrains-copilot/hooks — JetBrains Copilot hook definitions and matchers.
+ *
+ * Defines the hook types, matchers, and registration format specific to
+ * JetBrains Copilot's hook system. This module is used by:
+ *   - CLI setup/upgrade commands (to configure hooks)
+ *   - Doctor command (to validate hook configuration)
+ *   - Hook config generation
+ *
+ * JetBrains Copilot hook system reference:
+ *   - Hooks are registered in .github/hooks/*.json
+ *   - Hook names: PreToolUse, PostToolUse, PreCompact, SessionStart (PascalCase)
+ *   - Additional hooks: Stop, SubagentStart, SubagentStop
+ *   - CRITICAL: matchers are parsed but IGNORED (all hooks fire on all tools)
+ *   - Input: JSON on stdin
+ *   - Output: JSON on stdout (or empty for passthrough)
+ *   - JetBrains Copilot shares the same hook paradigm as VS Code Copilot
+ */
+/** JetBrains Copilot hook types. */
+export declare const HOOK_TYPES: {
+    readonly PRE_TOOL_USE: "PreToolUse";
+    readonly POST_TOOL_USE: "PostToolUse";
+    readonly PRE_COMPACT: "PreCompact";
+    readonly SESSION_START: "SessionStart";
+    readonly STOP: "Stop";
+    readonly SUBAGENT_START: "SubagentStart";
+    readonly SUBAGENT_STOP: "SubagentStop";
+};
+export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
+/** Map of hook types to their script file names. */
+export declare const HOOK_SCRIPTS: Record<string, string>;
+/** Required hooks that must be configured for context-mode to function. */
+export declare const REQUIRED_HOOKS: HookType[];
+/** Optional hooks that enhance functionality but aren't critical. */
+export declare const OPTIONAL_HOOKS: HookType[];
+/**
+ * Check if a hook entry points to a context-mode hook script.
+ * Matches both legacy format (node .../pretooluse.mjs) and
+ * CLI dispatcher format (context-mode hook jetbrains-copilot pretooluse).
+ */
+export declare function isContextModeHook(entry: {
+    hooks?: Array<{
+        command?: string;
+    }>;
+}, hookType: HookType): boolean;
+/**
+ * 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.
+ */
+export declare function buildHookCommand(hookType: HookType, pluginRoot?: string): string;

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

@@ -0,0 +1,82 @@
+/**
+ * adapters/jetbrains-copilot/hooks — JetBrains Copilot hook definitions and matchers.
+ *
+ * Defines the hook types, matchers, and registration format specific to
+ * JetBrains Copilot's hook system. This module is used by:
+ *   - CLI setup/upgrade commands (to configure hooks)
+ *   - Doctor command (to validate hook configuration)
+ *   - Hook config generation
+ *
+ * JetBrains Copilot hook system reference:
+ *   - Hooks are registered in .github/hooks/*.json
+ *   - Hook names: PreToolUse, PostToolUse, PreCompact, SessionStart (PascalCase)
+ *   - Additional hooks: Stop, SubagentStart, SubagentStop
+ *   - CRITICAL: matchers are parsed but IGNORED (all hooks fire on all tools)
+ *   - Input: JSON on stdin
+ *   - Output: JSON on stdout (or empty for passthrough)
+ *   - JetBrains Copilot shares the same hook paradigm as VS Code Copilot
+ */
+// ─────────────────────────────────────────────────────────
+// Hook type constants
+// ─────────────────────────────────────────────────────────
+/** JetBrains Copilot hook types. */
+export const HOOK_TYPES = {
+    PRE_TOOL_USE: "PreToolUse",
+    POST_TOOL_USE: "PostToolUse",
+    PRE_COMPACT: "PreCompact",
+    SESSION_START: "SessionStart",
+    // Additional hooks (shared with VS Code Copilot)
+    STOP: "Stop",
+    SUBAGENT_START: "SubagentStart",
+    SUBAGENT_STOP: "SubagentStop",
+};
+// ─────────────────────────────────────────────────────────
+// Hook script file names
+// ─────────────────────────────────────────────────────────
+/** Map of hook types to their script file names. */
+export const HOOK_SCRIPTS = {
+    [HOOK_TYPES.PRE_TOOL_USE]: "pretooluse.mjs",
+    [HOOK_TYPES.POST_TOOL_USE]: "posttooluse.mjs",
+    [HOOK_TYPES.PRE_COMPACT]: "precompact.mjs",
+    [HOOK_TYPES.SESSION_START]: "sessionstart.mjs",
+};
+// ─────────────────────────────────────────────────────────
+// Hook validation
+// ─────────────────────────────────────────────────────────
+/** Required hooks that must be configured for context-mode to function. */
+export const REQUIRED_HOOKS = [
+    HOOK_TYPES.PRE_TOOL_USE,
+    HOOK_TYPES.SESSION_START,
+];
+/** Optional hooks that enhance functionality but aren't critical. */
+export const OPTIONAL_HOOKS = [
+    HOOK_TYPES.POST_TOOL_USE,
+    HOOK_TYPES.PRE_COMPACT,
+];
+/**
+ * Check if a hook entry points to a context-mode hook script.
+ * Matches both legacy format (node .../pretooluse.mjs) and
+ * CLI dispatcher format (context-mode hook jetbrains-copilot pretooluse).
+ */
+export function isContextModeHook(entry, hookType) {
+    const scriptName = HOOK_SCRIPTS[hookType];
+    if (!scriptName)
+        return false;
+    const cliCommand = buildHookCommand(hookType);
+    return (entry.hooks?.some((h) => h.command?.includes(scriptName) || h.command?.includes(cliCommand)) ?? false);
+}
+/**
+ * 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.
+ */
+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/jetbrains-copilot/${scriptName}"`;
+    }
+    return `context-mode hook jetbrains-copilot ${hookType.toLowerCase()}`;
+}

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

@@ -0,0 +1,24 @@
+/**
+ * adapters/jetbrains-copilot — JetBrains Copilot platform adapter.
+ *
+ * Extends CopilotBaseAdapter with JetBrains-specific logic:
+ *   - extractSessionId: JETBRAINS_CLIENT_ID / IDEA_HOME fallbacks
+ *   - getProjectDir: IDEA_INITIAL_DIRECTORY
+ *   - checkPluginRegistration: WARN (IDE Settings UI, not CLI-inspectable)
+ *   - getInstalledVersion: checks hook config existence
+ *   - validateHooks: JetBrains-specific warnings
+ */
+import { CopilotBaseAdapter } from "../copilot-base.js";
+import type { CopilotHookInput, CopilotHookModule } from "../copilot-base.js";
+import type { DiagnosticResult } from "../types.js";
+export declare class JetBrainsCopilotAdapter extends CopilotBaseAdapter {
+    constructor();
+    readonly name = "JetBrains Copilot";
+    protected readonly hookModule: CopilotHookModule;
+    protected readonly hookSubdir = "jetbrains-copilot";
+    protected extractSessionId(input: CopilotHookInput): string;
+    protected getProjectDir(): string;
+    validateHooks(pluginRoot: string): DiagnosticResult[];
+    checkPluginRegistration(): DiagnosticResult;
+    getInstalledVersion(): string;
+}

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

@@ -0,0 +1,119 @@
+/**
+ * adapters/jetbrains-copilot — JetBrains Copilot platform adapter.
+ *
+ * Extends CopilotBaseAdapter with JetBrains-specific logic:
+ *   - extractSessionId: JETBRAINS_CLIENT_ID / IDEA_HOME fallbacks
+ *   - getProjectDir: IDEA_INITIAL_DIRECTORY
+ *   - checkPluginRegistration: WARN (IDE Settings UI, not CLI-inspectable)
+ *   - getInstalledVersion: checks hook config existence
+ *   - validateHooks: JetBrains-specific warnings
+ */
+import { readFileSync, } from "node:fs";
+import { CopilotBaseAdapter } from "../copilot-base.js";
+// ─────────────────────────────────────────────────────────
+// Hook constants (re-exported from hooks.ts)
+// ─────────────────────────────────────────────────────────
+import { HOOK_TYPES as JETBRAINS_HOOK_NAMES, HOOK_SCRIPTS as JETBRAINS_HOOK_SCRIPTS, buildHookCommand as buildJetBrainsHookCommand, } from "./hooks.js";
+// ─────────────────────────────────────────────────────────
+// Adapter implementation
+// ─────────────────────────────────────────────────────────
+export class JetBrainsCopilotAdapter extends CopilotBaseAdapter {
+    constructor() {
+        super([".config", "JetBrains"]);
+    }
+    name = "JetBrains Copilot";
+    hookModule = {
+        HOOK_TYPES: JETBRAINS_HOOK_NAMES,
+        HOOK_SCRIPTS: JETBRAINS_HOOK_SCRIPTS,
+        buildHookCommand: buildJetBrainsHookCommand,
+    };
+    hookSubdir = "jetbrains-copilot";
+    // ── Platform-specific overrides ────────────────────────
+    extractSessionId(input) {
+        if (input.sessionId)
+            return input.sessionId;
+        if (process.env.JETBRAINS_CLIENT_ID) {
+            return `jetbrains-${process.env.JETBRAINS_CLIENT_ID}`;
+        }
+        if (process.env.IDEA_HOME)
+            return `idea-${process.pid}`;
+        return `pid-${process.ppid}`;
+    }
+    getProjectDir() {
+        return process.env.IDEA_INITIAL_DIRECTORY || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+    }
+    // ── Diagnostics (doctor) ─────────────────────────────────
+    validateHooks(pluginRoot) {
+        const results = [];
+        try {
+            const raw = readFileSync(this.getSettingsPath(), "utf-8");
+            const config = JSON.parse(raw);
+            const hooks = config.hooks;
+            if (hooks?.[JETBRAINS_HOOK_NAMES.PRE_TOOL_USE]) {
+                results.push({
+                    check: "PreToolUse hook",
+                    status: "pass",
+                    message: "PreToolUse hook configured in .github/hooks/context-mode.json",
+                });
+            }
+            else {
+                results.push({
+                    check: "PreToolUse hook",
+                    status: "fail",
+                    message: "PreToolUse not found in .github/hooks/context-mode.json",
+                    fix: "context-mode upgrade",
+                });
+            }
+            if (hooks?.[JETBRAINS_HOOK_NAMES.SESSION_START]) {
+                results.push({
+                    check: "SessionStart hook",
+                    status: "pass",
+                    message: "SessionStart hook configured in .github/hooks/context-mode.json",
+                });
+            }
+            else {
+                results.push({
+                    check: "SessionStart hook",
+                    status: "fail",
+                    message: "SessionStart not found in .github/hooks/context-mode.json",
+                    fix: "context-mode upgrade",
+                });
+            }
+        }
+        catch {
+            results.push({
+                check: "Hook configuration",
+                status: "fail",
+                message: "Could not read .github/hooks/context-mode.json",
+                fix: "context-mode upgrade",
+            });
+        }
+        results.push({
+            check: "Hook scripts",
+            status: "warn",
+            message: `JetBrains hook wrappers should resolve to ${pluginRoot}/hooks/jetbrains-copilot/*.mjs`,
+        });
+        return results;
+    }
+    checkPluginRegistration() {
+        // JetBrains Copilot stores MCP server registration via the IDE Settings UI
+        // (Settings > Tools > GitHub Copilot > MCP > Configure), not in a
+        // project-scoped file we can inspect.
+        return {
+            check: "MCP registration",
+            status: "warn",
+            message: "JetBrains stores MCP config via Settings UI — not CLI-inspectable",
+            fix: "Verify in IDE: Settings > Tools > GitHub Copilot > MCP > ensure a context-mode server entry exists",
+        };
+    }
+    getInstalledVersion() {
+        // JetBrains Copilot registers MCP servers via Settings UI (not
+        // CLI-inspectable). All we can check is whether hook config has been
+        // written to .github/hooks/context-mode.json by `context-mode upgrade`.
+        const settings = this.readSettings();
+        const hooks = settings?.hooks;
+        if (hooks && Object.keys(hooks).length > 0)
+            return "configured";
+        return "unknown";
+    }
+}

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

@@ -18,6 +18,20 @@ export declare const HOOK_TYPES: {
 };
 export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
 export declare const HOOK_SCRIPTS: Record<string, string>;
+/**
+ * Tools that context-mode's PreToolUse hook intercepts on Kiro.
+ *
+ * Kiro native tool names (from TOOL_ALIASES in routing.mjs):
+ *   execute_bash → Bash, fs_read → Read, fs_write → Write
+ *
+ * MCP tools surface as @context-mode/ctx_* in Kiro.
+ */
+export declare const PRE_TOOL_USE_MATCHERS: readonly ["execute_bash", "fs_read", "@context-mode/ctx_execute", "@context-mode/ctx_execute_file", "@context-mode/ctx_batch_execute"];
+/**
+ * Combined matcher pattern for Kiro hook config (pipe-separated).
+ * Used by generateHookConfig and configureAllHooks.
+ */
+export declare const PRE_TOOL_USE_MATCHER_PATTERN: string;
 export declare const REQUIRED_HOOKS: string[];
 export declare const OPTIONAL_HOOKS: string[];
 /**

package/build/adapters/kiro/hooks.js

@@ -20,6 +20,29 @@ export const HOOK_SCRIPTS = {
     [HOOK_TYPES.PRE_TOOL_USE]: "pretooluse.mjs",
     [HOOK_TYPES.POST_TOOL_USE]: "posttooluse.mjs",
 };
+// ─────────────────────────────────────────────────────────
+// PreToolUse matchers
+// ─────────────────────────────────────────────────────────
+/**
+ * Tools that context-mode's PreToolUse hook intercepts on Kiro.
+ *
+ * Kiro native tool names (from TOOL_ALIASES in routing.mjs):
+ *   execute_bash → Bash, fs_read → Read, fs_write → Write
+ *
+ * MCP tools surface as @context-mode/ctx_* in Kiro.
+ */
+export const PRE_TOOL_USE_MATCHERS = [
+    "execute_bash",
+    "fs_read",
+    "@context-mode/ctx_execute",
+    "@context-mode/ctx_execute_file",
+    "@context-mode/ctx_batch_execute",
+];
+/**
+ * Combined matcher pattern for Kiro hook config (pipe-separated).
+ * Used by generateHookConfig and configureAllHooks.
+ */
+export const PRE_TOOL_USE_MATCHER_PATTERN = PRE_TOOL_USE_MATCHERS.join("|");
 export const REQUIRED_HOOKS = [
     HOOK_TYPES.PRE_TOOL_USE,
 ];

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

@@ -17,8 +17,10 @@
  *   - clientInfo.name: https://github.com/kirodotdev/Kiro/issues/5205 ("Kiro CLI")
  *   - CLI hooks: https://kiro.dev/docs/cli/custom-agents/configuration-reference#hooks-field
  */
+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 KiroAdapter implements HookAdapter {
+export declare class KiroAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
     readonly name = "Kiro";
     readonly paradigm: HookParadigm;
     readonly capabilities: PlatformCapabilities;
@@ -31,9 +33,6 @@ export declare class KiroAdapter 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;
@@ -41,7 +40,6 @@ export declare class KiroAdapter 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;