@mxalbert/context-mode 2.0.0

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

@@ -0,0 +1,483 @@
+/**
+ * adapters/gemini-cli — Gemini CLI platform adapter.
+ *
+ * Implements HookAdapter for Gemini CLI's JSON stdin/stdout hook paradigm.
+ *
+ * Gemini CLI hook specifics:
+ *   - I/O: JSON on stdin, JSON on stdout (same paradigm as Claude Code)
+ *   - Hook names: BeforeTool, AfterTool, PreCompress, SessionStart
+ *   - Arg modification: `hookSpecificOutput.tool_input` (merged with original)
+ *   - Blocking: `decision: "deny"` in response (NOT permissionDecision)
+ *   - Output modification: `decision: "deny"` + reason replaces output,
+ *     `hookSpecificOutput.additionalContext` appends
+ *   - PreCompress: advisory only (async, cannot block)
+ *   - No `decision: "ask"` support
+ *   - Hooks don't fire for subagents yet
+ *   - Config: ~/.gemini/settings.json (user), .gemini/settings.json (project)
+ *   - Session ID: session_id field
+ *   - Project dir env: GEMINI_PROJECT_DIR (also CLAUDE_PROJECT_DIR alias)
+ *   - Session dir: ~/.gemini/context-mode/sessions/
+ */
+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";
+// ─────────────────────────────────────────────────────────
+// Hook constants (re-exported from hooks.ts)
+// ─────────────────────────────────────────────────────────
+import { HOOK_TYPES as GEMINI_HOOK_NAMES, HOOK_SCRIPTS as GEMINI_HOOK_SCRIPTS, buildHookCommand as buildGeminiHookCommand, EXTERNAL_MCP_MATCHER_PATTERN, } from "./hooks.js";
+// ─────────────────────────────────────────────────────────
+// Adapter implementation
+// ─────────────────────────────────────────────────────────
+export class GeminiCLIAdapter extends BaseAdapter {
+    constructor() {
+        super([".gemini"]);
+    }
+    name = "Gemini CLI";
+    paradigm = "json-stdio";
+    capabilities = {
+        preToolUse: true,
+        postToolUse: true,
+        preCompact: true,
+        sessionStart: true,
+        canModifyArgs: true,
+        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: this.getProjectDir(input),
+            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: this.getProjectDir(input),
+            raw,
+        };
+    }
+    parsePreCompactInput(raw) {
+        const input = raw;
+        return {
+            sessionId: this.extractSessionId(input),
+            projectDir: this.getProjectDir(input),
+            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: this.getProjectDir(input),
+            raw,
+        };
+    }
+    // ── Response formatting ────────────────────────────────
+    formatPreToolUseResponse(response) {
+        if (response.decision === "deny") {
+            return {
+                decision: "deny",
+                reason: response.reason ?? "Blocked by context-mode hook",
+            };
+        }
+        if (response.decision === "modify" && response.updatedInput) {
+            return {
+                hookSpecificOutput: {
+                    tool_input: response.updatedInput,
+                },
+            };
+        }
+        if (response.decision === "context" && response.additionalContext) {
+            // Gemini CLI: inject additionalContext via hookSpecificOutput
+            return {
+                hookSpecificOutput: {
+                    additionalContext: response.additionalContext,
+                },
+            };
+        }
+        if (response.decision === "ask") {
+            // Gemini CLI: no native "ask" — deny to be safe
+            return {
+                decision: "deny",
+                reason: response.reason ?? "Action requires user confirmation (security policy)",
+            };
+        }
+        // "allow" — return undefined for passthrough
+        return undefined;
+    }
+    formatPostToolUseResponse(response) {
+        if (response.updatedOutput) {
+            // Gemini CLI: decision "deny" + reason replaces output
+            return {
+                decision: "deny",
+                reason: response.updatedOutput,
+            };
+        }
+        if (response.additionalContext) {
+            return {
+                hookSpecificOutput: {
+                    additionalContext: response.additionalContext,
+                },
+            };
+        }
+        return undefined;
+    }
+    formatPreCompactResponse(response) {
+        // PreCompress is advisory only (async), but we can still return context
+        return response.context ?? "";
+    }
+    formatSessionStartResponse(response) {
+        return response.context ?? "";
+    }
+    // ── Configuration ──────────────────────────────────────
+    getSettingsPath() {
+        return resolve(homedir(), ".gemini", "settings.json");
+    }
+    getInstructionFiles() {
+        return ["GEMINI.md"];
+    }
+    generateHookConfig(pluginRoot) {
+        return {
+            [GEMINI_HOOK_NAMES.BEFORE_AGENT]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.BEFORE_AGENT, pluginRoot),
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.BEFORE_TOOL]: [
+                {
+                    // Gemini native tools + context-mode own MCP (both canonical and Claude
+                    // shim prefixes) + external MCP catch-all (#529).
+                    matcher: `run_shell_command|read_file|read_many_files|grep_search|search_file_content|web_fetch|activate_skill|mcp__plugin_context-mode|mcp__context-mode|${EXTERNAL_MCP_MATCHER_PATTERN}`,
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.BEFORE_TOOL, pluginRoot),
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.AFTER_TOOL]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.AFTER_TOOL, pluginRoot),
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.AFTER_MODEL]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.AFTER_MODEL, pluginRoot),
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.PRE_COMPRESS]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.PRE_COMPRESS, pluginRoot),
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.SESSION_START]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.SESSION_START, pluginRoot),
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    readSettings() {
+        try {
+            const raw = readFileSync(this.getSettingsPath(), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    writeSettings(settings) {
+        const dir = resolve(homedir(), ".gemini");
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(this.getSettingsPath(), JSON.stringify(settings, null, 2) + "\n", "utf-8");
+    }
+    // ── Diagnostics (doctor) ─────────────────────────────────
+    validateHooks(pluginRoot) {
+        const results = [];
+        const settings = this.readSettings();
+        if (!settings) {
+            results.push({
+                check: "BeforeTool hook",
+                status: "fail",
+                message: "Could not read ~/.gemini/settings.json",
+                fix: "context-mode upgrade",
+            });
+            return results;
+        }
+        const hooks = settings.hooks;
+        // Check BeforeTool
+        const beforeTool = hooks?.[GEMINI_HOOK_NAMES.BEFORE_TOOL];
+        if (beforeTool && beforeTool.length > 0) {
+            const hasHook = beforeTool.some((entry) => entry.hooks?.some((h) => h.command?.includes("context-mode")));
+            results.push({
+                check: "BeforeTool hook",
+                status: hasHook ? "pass" : "fail",
+                message: hasHook
+                    ? "BeforeTool hook configured"
+                    : "BeforeTool exists but does not point to context-mode",
+                fix: hasHook ? undefined : "context-mode upgrade",
+            });
+        }
+        else {
+            results.push({
+                check: "BeforeTool hook",
+                status: "fail",
+                message: "No BeforeTool hooks found",
+                fix: "context-mode upgrade",
+            });
+        }
+        // Check SessionStart
+        const sessionStart = hooks?.[GEMINI_HOOK_NAMES.SESSION_START];
+        if (sessionStart && sessionStart.length > 0) {
+            const hasHook = sessionStart.some((entry) => entry.hooks?.some((h) => h.command?.includes("context-mode")));
+            results.push({
+                check: "SessionStart hook",
+                status: hasHook ? "pass" : "fail",
+                message: hasHook
+                    ? "SessionStart hook configured"
+                    : "SessionStart exists but does not point to context-mode",
+                fix: hasHook ? undefined : "context-mode upgrade",
+            });
+        }
+        else {
+            results.push({
+                check: "SessionStart hook",
+                status: "fail",
+                message: "No SessionStart hooks found",
+                fix: "context-mode upgrade",
+            });
+        }
+        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) {
+            return {
+                check: "Plugin registration",
+                status: "warn",
+                message: "Could not read ~/.gemini/settings.json",
+            };
+        }
+        // Check in extensions or settings for context-mode
+        const extensions = settings.extensions;
+        if (extensions) {
+            const hasPlugin = Array.isArray(extensions)
+                ? extensions.some((e) => typeof e === "string" && e.includes("context-mode"))
+                : Object.keys(extensions).some((k) => k.includes("context-mode"));
+            if (hasPlugin) {
+                return {
+                    check: "Plugin registration",
+                    status: "pass",
+                    message: "context-mode found in extensions",
+                };
+            }
+        }
+        return {
+            check: "Plugin registration",
+            status: "warn",
+            message: "context-mode not found in extensions (might be using standalone MCP mode)",
+        };
+    }
+    getInstalledVersion() {
+        // Check ~/.gemini/ extension cache for context-mode
+        try {
+            const cachePath = resolve(homedir(), ".gemini", "extensions", "context-mode", "package.json");
+            const pkg = JSON.parse(readFileSync(cachePath, "utf-8"));
+            if (typeof pkg.version === "string")
+                return pkg.version;
+        }
+        catch {
+            /* not found */
+        }
+        return "not installed";
+    }
+    // ── Upgrade ────────────────────────────────────────────
+    configureAllHooks(pluginRoot) {
+        const settings = this.readSettings() ?? {};
+        const hooks = (settings.hooks ?? {});
+        const changes = [];
+        const hookConfigs = [
+            { name: GEMINI_HOOK_NAMES.BEFORE_AGENT },
+            { name: GEMINI_HOOK_NAMES.BEFORE_TOOL },
+            { name: GEMINI_HOOK_NAMES.SESSION_START },
+        ];
+        for (const config of hookConfigs) {
+            const command = buildGeminiHookCommand(config.name, pluginRoot);
+            const entry = {
+                matcher: "",
+                hooks: [{ type: "command", command }],
+            };
+            const existing = hooks[config.name];
+            if (existing && Array.isArray(existing)) {
+                const idx = existing.findIndex((e) => {
+                    const entryHooks = e.hooks;
+                    return entryHooks?.some((h) => h.command?.includes("context-mode"));
+                });
+                if (idx >= 0) {
+                    existing[idx] = entry;
+                    changes.push(`Updated existing ${config.name} hook entry`);
+                }
+                else {
+                    existing.push(entry);
+                    changes.push(`Added ${config.name} hook entry`);
+                }
+                hooks[config.name] = existing;
+            }
+            else {
+                hooks[config.name] = [entry];
+                changes.push(`Created ${config.name} hooks section`);
+            }
+        }
+        settings.hooks = hooks;
+        this.writeSettings(settings);
+        return changes;
+    }
+    setHookPermissions(pluginRoot) {
+        const set = [];
+        const hooksDir = join(pluginRoot, "hooks", "gemini-cli");
+        for (const scriptName of Object.values(GEMINI_HOOK_SCRIPTS)) {
+            const scriptPath = resolve(hooksDir, scriptName);
+            try {
+                accessSync(scriptPath, constants.R_OK);
+                chmodSync(scriptPath, 0o755);
+                set.push(scriptPath);
+            }
+            catch {
+                /* skip missing scripts */
+            }
+        }
+        return set;
+    }
+    updatePluginRegistry(pluginRoot, version) {
+        // Gemini CLI doesn't have a formal plugin registry like Claude Code.
+        // Update the extension cache package.json if it exists.
+        try {
+            const pkgPath = resolve(homedir(), ".gemini", "extensions", "context-mode", "package.json");
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            pkg.version = version;
+            pkg.installPath = pluginRoot;
+            pkg.lastUpdated = new Date().toISOString();
+            writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+        }
+        catch {
+            /* best effort */
+        }
+    }
+    // ── Internal helpers ───────────────────────────────────
+    /**
+     * Resolve the project directory for a Gemini CLI hook input.
+     * Priority: input.cwd > GEMINI_PROJECT_DIR > CLAUDE_PROJECT_DIR > process.cwd().
+     * Mirrors the cursor / opencode pattern so downstream hooks always
+     * receive a defined projectDir even when the platform omits cwd
+     * from the wire payload (e.g. under worktrees).
+     */
+    getProjectDir(input) {
+        return (input.cwd
+            ?? process.env.GEMINI_PROJECT_DIR
+            ?? process.env.CLAUDE_PROJECT_DIR
+            ?? process.cwd());
+    }
+    /**
+     * Extract session ID from Gemini CLI hook input.
+     * Priority: session_id field > env fallback > ppid fallback.
+     */
+    extractSessionId(input) {
+        if (input.session_id)
+            return input.session_id;
+        return `pid-${process.ppid}`;
+    }
+}

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,59 @@
+/**
+ * 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.
+ *
+ * Always emits the CLI dispatcher form
+ * (`context-mode hook jetbrains-copilot <event>`) — the `pluginRoot`
+ * argument is accepted for API compatibility but intentionally ignored.
+ *
+ * Same Tier C contract as VS Code Copilot (Issue #613):
+ * `.github/hooks/context-mode.json` is workspace-committed (team-shared
+ * via git). Embedding `process.execPath` or absolute pluginRoot paths
+ * leaks PII and breaks cross-machine portability. See
+ * src/adapters/vscode-copilot/hooks.ts for the full archaeology.
+ */
+export declare function buildHookCommand(hookType: HookType, _pluginRoot?: string): string;

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

@@ -0,0 +1,87 @@
+/**
+ * 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.
+ *
+ * Always emits the CLI dispatcher form
+ * (`context-mode hook jetbrains-copilot <event>`) — the `pluginRoot`
+ * argument is accepted for API compatibility but intentionally ignored.
+ *
+ * Same Tier C contract as VS Code Copilot (Issue #613):
+ * `.github/hooks/context-mode.json` is workspace-committed (team-shared
+ * via git). Embedding `process.execPath` or absolute pluginRoot paths
+ * leaks PII and breaks cross-machine portability. See
+ * src/adapters/vscode-copilot/hooks.ts for the full archaeology.
+ */
+export function buildHookCommand(hookType, _pluginRoot) {
+    const scriptName = HOOK_SCRIPTS[hookType];
+    if (!scriptName) {
+        throw new Error(`No script defined for hook type: ${hookType}`);
+    }
+    return `context-mode hook jetbrains-copilot ${hookType.toLowerCase()}`;
+}

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

@@ -0,0 +1,31 @@
+/**
+ * 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;
+    /**
+     * JetBrains Copilot honors .github/copilot-instructions.md per project.
+     * Always returned absolute, resolved against the supplied `projectDir`,
+     * the JetBrains-specific project env vars, or `process.cwd()`.
+     */
+    getConfigDir(projectDir?: string): string;
+    getInstructionFiles(): string[];
+    validateHooks(pluginRoot: string): DiagnosticResult[];
+    checkPluginRegistration(): DiagnosticResult;
+    getInstalledVersion(): string;
+}