@mxalbert/context-mode 2.0.0

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

@@ -0,0 +1,131 @@
+/**
+ * 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 { resolve } from "node:path";
+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();
+    }
+    /**
+     * 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) {
+        return resolve(projectDir ?? this.getProjectDir(), ".github");
+    }
+    getInstructionFiles() {
+        return ["copilot-instructions.md"];
+    }
+    // ── 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/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";

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

@@ -0,0 +1,66 @@
+/**
+ * adapters/kimi — Kimi Code CLI platform adapter.
+ *
+ * Implements HookAdapter for Kimi Code CLI's JSON stdin/stdout paradigm.
+ *
+ * Kimi Code CLI hook specifics:
+ *   - 7 hook events: PreToolUse, PostToolUse, PreCompact, SessionStart,
+ *     SessionEnd, UserPromptSubmit, Stop
+ *   - Same wire protocol as Codex CLI (JSON stdin → stdout)
+ *   - Config: $KIMI_CODE_HOME or ~/.kimi-code (config.toml + mcp.json)
+ *   - Hooks are inline `[[hooks]]` array tables in config.toml
+ *   - Session dir: $KIMI_CODE_HOME/context-mode/sessions/
+ *
+ * PreToolUse is deny-only — ask / modify / additionalContext are silently
+ * dropped by the host runner (verified upstream at runner.ts:36-39,162-178).
+ */
+import { BaseAdapter } from "../base.js";
+import { type HookAdapter, type HookParadigm, type PlatformCapabilities, type DiagnosticResult, type PreToolUseEvent, type PostToolUseEvent, type PreCompactEvent, type SessionStartEvent, type PreToolUseResponse, type PostToolUseResponse, type PreCompactResponse, type SessionStartResponse, type HookRegistration } from "../types.js";
+type KimiVersionRunner = (file: string, args: string[], options: {
+    encoding: BufferEncoding;
+    stdio: ["ignore", "pipe", "ignore"];
+    timeout: number;
+}) => string | Buffer;
+export declare function probeKimiCliVersion(runCommand?: KimiVersionRunner): string | null;
+export declare class KimiAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
+    readonly name = "Kimi Code CLI";
+    readonly paradigm: HookParadigm;
+    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;
+    getConfigDir(_projectDir?: string): string;
+    getSettingsPath(): string;
+    getMcpPath(): string;
+    getSessionDir(): string;
+    getInstructionFiles(): string[];
+    getMemoryDir(projectDir?: string): string;
+    generateHookConfig(_pluginRoot: string): HookRegistration;
+    readSettings(): Record<string, unknown> | null;
+    writeSettings(_settings: Record<string, unknown>): void;
+    validateHooks(_pluginRoot: string): DiagnosticResult[];
+    checkPluginRegistration(): DiagnosticResult;
+    getInstalledVersion(): string;
+    configureAllHooks(_pluginRoot: string): string[];
+    backupSettings(): string | null;
+    setHookPermissions(_pluginRoot: string): string[];
+    updatePluginRegistry(_pluginRoot: string, _version: string): void;
+    getRoutingInstructions(): string;
+    private getProjectDir;
+    private extractSessionId;
+    private backupFile;
+    private isExpectedHookEntry;
+    private entryContainsManagedCommand;
+    /**
+     * Rebuild config.toml by removing old managed hooks and appending new ones.
+     * Preserves everything outside [[hooks]] blocks and all non-managed hooks.
+     */
+    private rebuildToml;
+}
+export {};