context-mode 1.0.89 → 1.0.91

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;

package/build/adapters/kiro/index.js

@@ -17,16 +17,19 @@
  *   - 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 { createHash } from "node:crypto";
-import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, constants, } from "node:fs";
-import { resolve, join, dirname } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, } from "node:fs";
+import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
-import { HOOK_TYPES as KIRO_HOOK_TYPES, buildHookCommand as buildKiroHookCommand, isContextModeHook as isKiroContextModeHook, } from "./hooks.js";
+import { BaseAdapter } from "../base.js";
+import { HOOK_TYPES as KIRO_HOOK_TYPES, PRE_TOOL_USE_MATCHER_PATTERN as KIRO_PRE_TOOL_USE_MATCHER_PATTERN, buildHookCommand as buildKiroHookCommand, isContextModeHook as isKiroContextModeHook, } from "./hooks.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
-export class KiroAdapter {
+export class KiroAdapter extends BaseAdapter {
+    constructor() {
+        super([".kiro"]);
+    }
     name = "Kiro";
     paradigm = "json-stdio";
     capabilities = {
@@ -95,31 +98,12 @@ export class KiroAdapter {
     getSettingsPath() {
         return resolve(homedir(), ".kiro", "settings", "mcp.json");
     }
-    getSessionDir() {
-        const dir = join(homedir(), ".kiro", "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) {
         // Kiro CLI hook config format: { preToolUse: [{ matcher, command }] }
         // Note: This generates the entries for agent config files
         return {
             [KIRO_HOOK_TYPES.PRE_TOOL_USE]: [{
-                    matcher: "*",
+                    matcher: KIRO_PRE_TOOL_USE_MATCHER_PATTERN,
                     hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.PRE_TOOL_USE, pluginRoot) }],
                 }],
             [KIRO_HOOK_TYPES.POST_TOOL_USE]: [{
@@ -241,7 +225,7 @@ export class KiroAdapter {
             const preToolUseEntries = (hooks[KIRO_HOOK_TYPES.PRE_TOOL_USE] ?? []);
             if (!preToolUseEntries.some(e => isKiroContextModeHook(e, KIRO_HOOK_TYPES.PRE_TOOL_USE))) {
                 preToolUseEntries.push({
-                    matcher: "*",
+                    matcher: KIRO_PRE_TOOL_USE_MATCHER_PATTERN,
                     command: buildKiroHookCommand(KIRO_HOOK_TYPES.PRE_TOOL_USE, pluginRoot),
                 });
                 hooks[KIRO_HOOK_TYPES.PRE_TOOL_USE] = preToolUseEntries;
@@ -265,18 +249,6 @@ export class KiroAdapter {
         }
         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) {
         return [];
     }

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

@@ -15,8 +15,10 @@
  *   - Config: openclaw.json plugins.entries, ~/.openclaw/extensions/
  *   - Session dir: ~/.openclaw/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 OpenClawAdapter implements HookAdapter {
+export declare class OpenClawAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
     readonly name = "OpenClaw";
     readonly paradigm: HookParadigm;
     readonly capabilities: PlatformCapabilities;
@@ -29,9 +31,6 @@ export declare class OpenClawAdapter 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;

package/build/adapters/openclaw/index.js

@@ -15,10 +15,10 @@
  *   - Config: openclaw.json plugins.entries, ~/.openclaw/extensions/
  *   - Session dir: ~/.openclaw/context-mode/sessions/
  */
-import { createHash } from "node:crypto";
-import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, constants, } from "node:fs";
+import { readFileSync, writeFileSync, copyFileSync, accessSync, 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)
 // ─────────────────────────────────────────────────────────
@@ -26,7 +26,10 @@ import { HOOK_EVENTS as OPENCLAW_HOOK_EVENTS } from "./hooks.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
-export class OpenClawAdapter {
+export class OpenClawAdapter extends BaseAdapter {
+    constructor() {
+        super([".openclaw"]);
+    }
     name = "OpenClaw";
     paradigm = "ts-plugin";
     capabilities = {
@@ -140,25 +143,6 @@ export class OpenClawAdapter {
         // OpenClaw uses openclaw.json in the project root or ~/.openclaw/openclaw.json
         return resolve("openclaw.json");
     }
-    getSessionDir() {
-        const dir = join(homedir(), ".openclaw", "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) {
         // OpenClaw uses TS plugin paradigm — hooks are registered via
         // api.registerHook() in the plugin entry point, not via config files.

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

@@ -15,9 +15,10 @@
  *   - Config: opencode.json plugin array, .opencode/plugins/*.ts
  *   - Session dir: ~/.config/opencode/context-mode/sessions/
  */
+import { BaseAdapter } from "../base.js";
 import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, PlatformId } from "../types.js";
 export type AdapterPlatformType = Extract<PlatformId, "opencode" | "kilo">;
-export declare class OpenCodeAdapter implements HookAdapter {
+export declare class OpenCodeAdapter extends BaseAdapter implements HookAdapter {
     get name(): string;
     readonly paradigm: HookParadigm;
     private settingsPath?;
@@ -35,8 +36,6 @@ export declare class OpenCodeAdapter implements HookAdapter {
     getSettingsPath(): string;
     private paths;
     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;