context-mode 0.9.21 → 1.0.0

package/build/adapters/claude-code/config.d.ts

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

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

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

package/build/adapters/claude-code/hooks.d.ts

@@ -0,0 +1,53 @@
+/**
+ * adapters/claude-code/hooks — Claude Code hook definitions and matchers.
+ *
+ * Defines the hook types, matchers, and registration format specific to
+ * Claude Code's hook system. This module is used by:
+ *   - CLI setup/upgrade commands (to configure hooks in settings.json)
+ *   - Doctor command (to validate hook configuration)
+ *   - hooks.json generation
+ *
+ * Claude Code hook system reference:
+ *   - Hooks are registered in ~/.claude/settings.json under "hooks" key
+ *   - Each hook type maps to an array of { matcher, hooks } entries
+ *   - matcher: tool name pattern (empty = match all tools)
+ *   - hooks: array of { type: "command", command: "..." }
+ *   - Input: JSON on stdin
+ *   - Output: JSON on stdout (or empty for passthrough)
+ */
+/** Claude Code 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 USER_PROMPT_SUBMIT: "UserPromptSubmit";
+};
+export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
+/** Tools that context-mode's PreToolUse hook intercepts. */
+export declare const PRE_TOOL_USE_MATCHERS: readonly ["Bash", "WebFetch", "Read", "Grep", "Agent", "Task", "mcp__plugin_context-mode_context-mode__ctx_execute", "mcp__plugin_context-mode_context-mode__ctx_execute_file", "mcp__plugin_context-mode_context-mode__ctx_batch_execute"];
+/**
+ * Combined matcher pattern for settings.json (pipe-separated).
+ * Used by the upgrade command when writing a single consolidated entry.
+ */
+export declare const PRE_TOOL_USE_MATCHER_PATTERN: string;
+/** Map of hook types to their script file names. */
+export declare const HOOK_SCRIPTS: Record<HookType, 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.
+ */
+export declare function isContextModeHook(entry: {
+    hooks?: Array<{
+        command?: string;
+    }>;
+}, hookType: HookType): boolean;
+/**
+ * Build the hook command string for a given hook type.
+ * Uses the CLI dispatcher: `context-mode hook claude-code <event>`
+ * Requires global install: `npm install -g context-mode`
+ */
+export declare function buildHookCommand(hookType: HookType): string;

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

@@ -0,0 +1,88 @@
+/**
+ * adapters/claude-code/hooks — Claude Code hook definitions and matchers.
+ *
+ * Defines the hook types, matchers, and registration format specific to
+ * Claude Code's hook system. This module is used by:
+ *   - CLI setup/upgrade commands (to configure hooks in settings.json)
+ *   - Doctor command (to validate hook configuration)
+ *   - hooks.json generation
+ *
+ * Claude Code hook system reference:
+ *   - Hooks are registered in ~/.claude/settings.json under "hooks" key
+ *   - Each hook type maps to an array of { matcher, hooks } entries
+ *   - matcher: tool name pattern (empty = match all tools)
+ *   - hooks: array of { type: "command", command: "..." }
+ *   - Input: JSON on stdin
+ *   - Output: JSON on stdout (or empty for passthrough)
+ */
+// ─────────────────────────────────────────────────────────
+// Hook type constants
+// ─────────────────────────────────────────────────────────
+/** Claude Code hook types. */
+export const HOOK_TYPES = {
+    PRE_TOOL_USE: "PreToolUse",
+    POST_TOOL_USE: "PostToolUse",
+    PRE_COMPACT: "PreCompact",
+    SESSION_START: "SessionStart",
+    USER_PROMPT_SUBMIT: "UserPromptSubmit",
+};
+// ─────────────────────────────────────────────────────────
+// PreToolUse matchers
+// ─────────────────────────────────────────────────────────
+/** Tools that context-mode's PreToolUse hook intercepts. */
+export const PRE_TOOL_USE_MATCHERS = [
+    "Bash",
+    "WebFetch",
+    "Read",
+    "Grep",
+    "Agent",
+    "Task",
+    "mcp__plugin_context-mode_context-mode__ctx_execute",
+    "mcp__plugin_context-mode_context-mode__ctx_execute_file",
+    "mcp__plugin_context-mode_context-mode__ctx_batch_execute",
+];
+/**
+ * Combined matcher pattern for settings.json (pipe-separated).
+ * Used by the upgrade command when writing a single consolidated entry.
+ */
+export const PRE_TOOL_USE_MATCHER_PATTERN = PRE_TOOL_USE_MATCHERS.join("|");
+// ─────────────────────────────────────────────────────────
+// Hook script file names
+// ─────────────────────────────────────────────────────────
+/** Map of hook types to their script file names. */
+export const HOOK_SCRIPTS = {
+    PreToolUse: "pretooluse.mjs",
+    PostToolUse: "posttooluse.mjs",
+    PreCompact: "precompact.mjs",
+    SessionStart: "sessionstart.mjs",
+    UserPromptSubmit: "userpromptsubmit.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,
+    HOOK_TYPES.USER_PROMPT_SUBMIT,
+];
+/**
+ * Check if a hook entry points to a context-mode hook script.
+ */
+export function isContextModeHook(entry, hookType) {
+    const scriptName = HOOK_SCRIPTS[hookType];
+    return (entry.hooks?.some((h) => h.command?.includes(scriptName)) ?? false);
+}
+/**
+ * Build the hook command string for a given hook type.
+ * Uses the CLI dispatcher: `context-mode hook claude-code <event>`
+ * Requires global install: `npm install -g context-mode`
+ */
+export function buildHookCommand(hookType) {
+    return `context-mode hook claude-code ${hookType.toLowerCase()}`;
+}

package/build/adapters/claude-code/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * adapters/claude-code — Claude Code platform adapter.
+ *
+ * Implements HookAdapter for Claude Code's JSON stdin/stdout hook paradigm.
+ *
+ * Claude Code hook specifics:
+ *   - I/O: JSON on stdin, JSON on stdout
+ *   - Arg modification: `updatedInput` field in response
+ *   - Blocking: `permissionDecision: "deny"` in response
+ *   - PostToolUse output: `updatedMCPToolOutput` field
+ *   - PreCompact: stdout on exit 0
+ *   - Session ID: transcript_path UUID > session_id > CLAUDE_SESSION_ID > ppid
+ *   - Config: ~/.claude/settings.json
+ *   - Session dir: ~/.claude/context-mode/sessions/
+ */
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+export declare class ClaudeCodeAdapter implements HookAdapter {
+    readonly name = "Claude Code";
+    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;
+    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;
+    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;
+    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
+    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
+    /**
+     * Extract session ID from Claude Code hook input.
+     * Priority: transcript_path UUID > session_id field > CLAUDE_SESSION_ID env > ppid fallback.
+     */
+    private extractSessionId;
+}