@cleocode/adapters 2.0.0

package/src/providers/claude-code/adapter.js

@@ -0,0 +1,154 @@
+/**
+ * Claude Code Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Anthropic's Claude Code CLI.
+ * Provides spawn, hooks, and install capabilities for CLEO integration.
+ *
+ * @task T5240
+ */
+import { exec } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { promisify } from 'node:util';
+import { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
+import { ClaudeCodeHookProvider } from './hooks.js';
+import { ClaudeCodeInstallProvider } from './install.js';
+import { ClaudeCodePathProvider } from './paths.js';
+import { ClaudeCodeSpawnProvider } from './spawn.js';
+import { ClaudeCodeTaskSyncProvider } from './task-sync.js';
+import { ClaudeCodeTransportProvider } from './transport.js';
+const execAsync = promisify(exec);
+/**
+ * CLEO provider adapter for Anthropic Claude Code CLI.
+ *
+ * Bridges CLEO's adapter system with Claude Code's native capabilities:
+ * - Hooks: Maps Claude Code events (SessionStart, PostToolUse, etc.) to CAAMP events
+ * - Spawn: Launches subagent processes via the `claude` CLI
+ * - Install: Registers MCP server, instruction files, and brain observation plugin
+ */
+export class ClaudeCodeAdapter {
+    id = 'claude-code';
+    name = 'Claude Code';
+    version = '1.0.0';
+    capabilities = {
+        supportsHooks: true,
+        supportedHookEvents: [
+            'onSessionStart',
+            'onSessionEnd',
+            'onToolStart',
+            'onToolComplete',
+            'onError',
+        ],
+        supportsSpawn: true,
+        supportsInstall: true,
+        supportsMcp: true,
+        supportsInstructionFiles: true,
+        instructionFilePattern: 'CLAUDE.md',
+        supportsContextMonitor: true,
+        supportsStatusline: true,
+        supportsProviderPaths: true,
+        supportsTransport: true,
+        supportsTaskSync: true,
+    };
+    hooks;
+    spawn;
+    install;
+    paths;
+    contextMonitor;
+    transport;
+    taskSync;
+    projectDir = null;
+    initialized = false;
+    constructor() {
+        this.hooks = new ClaudeCodeHookProvider();
+        this.spawn = new ClaudeCodeSpawnProvider();
+        this.install = new ClaudeCodeInstallProvider();
+        this.paths = new ClaudeCodePathProvider();
+        this.contextMonitor = new ClaudeCodeContextMonitorProvider();
+        this.transport = new ClaudeCodeTransportProvider();
+        this.taskSync = new ClaudeCodeTaskSyncProvider();
+    }
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * Validates the environment by checking for the Claude CLI
+     * and Claude Code configuration directory.
+     *
+     * @param projectDir - Root directory of the project
+     */
+    async initialize(projectDir) {
+        this.projectDir = projectDir;
+        this.initialized = true;
+    }
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     */
+    async dispose() {
+        if (this.hooks.isRegistered()) {
+            await this.hooks.unregisterNativeHooks();
+        }
+        this.initialized = false;
+        this.projectDir = null;
+    }
+    /**
+     * Run a health check to verify Claude Code is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Claude CLI is available in PATH
+     * 3. ~/.claude/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     */
+    async healthCheck() {
+        const details = {};
+        if (!this.initialized) {
+            return {
+                healthy: false,
+                provider: this.id,
+                details: { error: 'Adapter not initialized' },
+            };
+        }
+        // Check Claude CLI availability
+        let cliAvailable = false;
+        try {
+            const { stdout } = await execAsync('which claude');
+            cliAvailable = stdout.trim().length > 0;
+            details.cliPath = stdout.trim();
+        }
+        catch {
+            details.cliAvailable = false;
+        }
+        // Check for Claude Code config directory
+        const claudeConfigDir = join(homedir(), '.claude');
+        const configExists = existsSync(claudeConfigDir);
+        details.configDirExists = configExists;
+        // Check for CLAUDE_CODE_ENTRYPOINT env var
+        const entrypointSet = process.env.CLAUDE_CODE_ENTRYPOINT !== undefined;
+        details.entrypointEnvSet = entrypointSet;
+        // Healthy if CLI is available (primary requirement)
+        const healthy = cliAvailable;
+        details.cliAvailable = cliAvailable;
+        return {
+            healthy,
+            provider: this.id,
+            details,
+        };
+    }
+    /**
+     * Check whether the adapter has been initialized.
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get the project directory this adapter was initialized with.
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/src/providers/claude-code/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["adapter.ts"],"names":[],"mappings":"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"}

package/src/providers/claude-code/adapter.ts

@@ -0,0 +1,175 @@
+/**
+ * Claude Code Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Anthropic's Claude Code CLI.
+ * Provides spawn, hooks, and install capabilities for CLEO integration.
+ *
+ * @task T5240
+ */
+
+import { exec } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { promisify } from 'node:util';
+import type {
+  AdapterCapabilities,
+  AdapterHealthStatus,
+  CLEOProviderAdapter,
+} from '@cleocode/contracts';
+import { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
+import { ClaudeCodeHookProvider } from './hooks.js';
+import { ClaudeCodeInstallProvider } from './install.js';
+import { ClaudeCodePathProvider } from './paths.js';
+import { ClaudeCodeSpawnProvider } from './spawn.js';
+import { ClaudeCodeTaskSyncProvider } from './task-sync.js';
+import { ClaudeCodeTransportProvider } from './transport.js';
+
+const execAsync = promisify(exec);
+
+/**
+ * CLEO provider adapter for Anthropic Claude Code CLI.
+ *
+ * Bridges CLEO's adapter system with Claude Code's native capabilities:
+ * - Hooks: Maps Claude Code events (SessionStart, PostToolUse, etc.) to CAAMP events
+ * - Spawn: Launches subagent processes via the `claude` CLI
+ * - Install: Registers MCP server, instruction files, and brain observation plugin
+ */
+export class ClaudeCodeAdapter implements CLEOProviderAdapter {
+  readonly id = 'claude-code';
+  readonly name = 'Claude Code';
+  readonly version = '1.0.0';
+
+  capabilities: AdapterCapabilities = {
+    supportsHooks: true,
+    supportedHookEvents: [
+      'onSessionStart',
+      'onSessionEnd',
+      'onToolStart',
+      'onToolComplete',
+      'onError',
+    ],
+    supportsSpawn: true,
+    supportsInstall: true,
+    supportsMcp: true,
+    supportsInstructionFiles: true,
+    instructionFilePattern: 'CLAUDE.md',
+    supportsContextMonitor: true,
+    supportsStatusline: true,
+    supportsProviderPaths: true,
+    supportsTransport: true,
+    supportsTaskSync: true,
+  };
+
+  hooks: ClaudeCodeHookProvider;
+  spawn: ClaudeCodeSpawnProvider;
+  install: ClaudeCodeInstallProvider;
+  paths: ClaudeCodePathProvider;
+  contextMonitor: ClaudeCodeContextMonitorProvider;
+  transport: ClaudeCodeTransportProvider;
+  taskSync: ClaudeCodeTaskSyncProvider;
+
+  private projectDir: string | null = null;
+  private initialized = false;
+
+  constructor() {
+    this.hooks = new ClaudeCodeHookProvider();
+    this.spawn = new ClaudeCodeSpawnProvider();
+    this.install = new ClaudeCodeInstallProvider();
+    this.paths = new ClaudeCodePathProvider();
+    this.contextMonitor = new ClaudeCodeContextMonitorProvider();
+    this.transport = new ClaudeCodeTransportProvider();
+    this.taskSync = new ClaudeCodeTaskSyncProvider();
+  }
+
+  /**
+   * Initialize the adapter for a given project directory.
+   *
+   * Validates the environment by checking for the Claude CLI
+   * and Claude Code configuration directory.
+   *
+   * @param projectDir - Root directory of the project
+   */
+  async initialize(projectDir: string): Promise<void> {
+    this.projectDir = projectDir;
+    this.initialized = true;
+  }
+
+  /**
+   * Dispose the adapter and clean up resources.
+   *
+   * Unregisters hooks and releases any tracked state.
+   */
+  async dispose(): Promise<void> {
+    if (this.hooks.isRegistered()) {
+      await this.hooks.unregisterNativeHooks();
+    }
+    this.initialized = false;
+    this.projectDir = null;
+  }
+
+  /**
+   * Run a health check to verify Claude Code is accessible.
+   *
+   * Checks:
+   * 1. Adapter has been initialized
+   * 2. Claude CLI is available in PATH
+   * 3. ~/.claude/ configuration directory exists
+   *
+   * @returns Health status with details about each check
+   */
+  async healthCheck(): Promise<AdapterHealthStatus> {
+    const details: Record<string, unknown> = {};
+
+    if (!this.initialized) {
+      return {
+        healthy: false,
+        provider: this.id,
+        details: { error: 'Adapter not initialized' },
+      };
+    }
+
+    // Check Claude CLI availability
+    let cliAvailable = false;
+    try {
+      const { stdout } = await execAsync('which claude');
+      cliAvailable = stdout.trim().length > 0;
+      details.cliPath = stdout.trim();
+    } catch {
+      details.cliAvailable = false;
+    }
+
+    // Check for Claude Code config directory
+    const claudeConfigDir = join(homedir(), '.claude');
+    const configExists = existsSync(claudeConfigDir);
+    details.configDirExists = configExists;
+
+    // Check for CLAUDE_CODE_ENTRYPOINT env var
+    const entrypointSet = process.env.CLAUDE_CODE_ENTRYPOINT !== undefined;
+    details.entrypointEnvSet = entrypointSet;
+
+    // Healthy if CLI is available (primary requirement)
+    const healthy = cliAvailable;
+    details.cliAvailable = cliAvailable;
+
+    return {
+      healthy,
+      provider: this.id,
+      details,
+    };
+  }
+
+  /**
+   * Check whether the adapter has been initialized.
+   */
+  isInitialized(): boolean {
+    return this.initialized;
+  }
+
+  /**
+   * Get the project directory this adapter was initialized with.
+   */
+  getProjectDir(): string | null {
+    return this.projectDir;
+  }
+}

package/src/providers/claude-code/context-monitor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude Code context monitor provider.
+ *
+ * Implements AdapterContextMonitorProvider for Claude Code's context window
+ * tracking and statusline integration.
+ *
+ * @task T5240
+ */
+import type { AdapterContextMonitorProvider } from '@cleocode/contracts';
+/**
+ * Context monitor provider for Claude Code.
+ *
+ * Processes context window JSON from Claude Code and writes state files
+ * for statusline display. Also provides statusline configuration
+ * and setup instructions specific to Claude Code's settings.json.
+ */
+export declare class ClaudeCodeContextMonitorProvider implements AdapterContextMonitorProvider {
+    private pathProvider;
+    processContextInput(input: unknown, cwd?: string): Promise<string>;
+    checkStatuslineIntegration(): 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
+    getStatuslineConfig(): Record<string, unknown>;
+    getSetupInstructions(): string;
+}
+//# sourceMappingURL=context-monitor.d.ts.map

package/src/providers/claude-code/context-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.d.ts","sourceRoot":"","sources":["context-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAkCzE;;;;;;GAMG;AACH,qBAAa,gCAAiC,YAAW,6BAA6B;IACpF,OAAO,CAAC,YAAY,CAAgC;IAE9C,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0DxE,0BAA0B,IAAI,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa;IAsChG,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS9C,oBAAoB,IAAI,MAAM;CAY/B"}

package/src/providers/claude-code/context-monitor.js

@@ -0,0 +1,148 @@
+/**
+ * Claude Code context monitor provider.
+ *
+ * Implements AdapterContextMonitorProvider for Claude Code's context window
+ * tracking and statusline integration.
+ *
+ * @task T5240
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { ClaudeCodePathProvider } from './paths.js';
+/** Thresholds for context window status levels. */
+const THRESHOLDS = {
+    WARNING: 50,
+    CAUTION: 70,
+    CRITICAL: 85,
+    EMERGENCY: 95,
+};
+function getContextStatusFromPercentage(percentage) {
+    if (percentage >= THRESHOLDS.EMERGENCY)
+        return 'emergency';
+    if (percentage >= THRESHOLDS.CRITICAL)
+        return 'critical';
+    if (percentage >= THRESHOLDS.CAUTION)
+        return 'caution';
+    if (percentage >= THRESHOLDS.WARNING)
+        return 'warning';
+    return 'ok';
+}
+/**
+ * Context monitor provider for Claude Code.
+ *
+ * Processes context window JSON from Claude Code and writes state files
+ * for statusline display. Also provides statusline configuration
+ * and setup instructions specific to Claude Code's settings.json.
+ */
+export class ClaudeCodeContextMonitorProvider {
+    pathProvider = new ClaudeCodePathProvider();
+    async processContextInput(input, cwd) {
+        const typed = input;
+        const contextSize = typed.context_window?.context_window_size ?? 200000;
+        const usage = typed.context_window?.current_usage;
+        if (!usage)
+            return '-- no data';
+        const inputTokens = usage.input_tokens ?? 0;
+        const outputTokens = usage.output_tokens ?? 0;
+        const cacheCreate = usage.cache_creation_input_tokens ?? 0;
+        const totalTokens = inputTokens + outputTokens + cacheCreate;
+        const percentage = Math.floor((totalTokens * 100) / contextSize);
+        const status = getContextStatusFromPercentage(percentage);
+        // Write state file if CLEO dir exists
+        const cleoDir = cwd ? join(cwd, '.cleo') : '.cleo';
+        if (existsSync(cleoDir)) {
+            const stateDir = join(cleoDir, 'context-states');
+            const statePath = join(stateDir, '.context-state.json');
+            const state = {
+                $schema: 'https://cleo-dev.com/schemas/v1/context-state.schema.json',
+                version: '1.0.0',
+                timestamp: new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),
+                staleAfterMs: 5000,
+                contextWindow: {
+                    maxTokens: contextSize,
+                    currentTokens: totalTokens,
+                    percentage,
+                    breakdown: {
+                        inputTokens,
+                        outputTokens,
+                        cacheCreationTokens: cacheCreate,
+                        cacheReadTokens: usage.cache_read_input_tokens ?? 0,
+                    },
+                },
+                thresholds: {
+                    warning: THRESHOLDS.WARNING,
+                    caution: THRESHOLDS.CAUTION,
+                    critical: THRESHOLDS.CRITICAL,
+                    emergency: THRESHOLDS.EMERGENCY,
+                },
+                status,
+                cleoSessionId: '',
+            };
+            try {
+                await mkdir(dirname(statePath), { recursive: true });
+                writeFileSync(statePath, JSON.stringify(state, null, 2));
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+        return `${percentage}% | ${totalTokens}/${contextSize}`;
+    }
+    checkStatuslineIntegration() {
+        const settingsPath = this.pathProvider.getSettingsPath();
+        if (!settingsPath || !existsSync(settingsPath))
+            return 'no_settings';
+        try {
+            const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            const statusLine = settings.statusLine;
+            if (!statusLine?.type)
+                return 'not_configured';
+            if (statusLine.type !== 'command')
+                return 'custom_no_cleo';
+            const cmd = statusLine.command ?? '';
+            if (cmd.includes('context-monitor.sh') ||
+                cmd.includes('cleo-statusline') ||
+                cmd.includes('.context-state.json') ||
+                cmd.includes('context-states')) {
+                return 'configured';
+            }
+            const scriptPath = cmd.startsWith('~') ? cmd.replace('~', homedir()) : cmd;
+            if (existsSync(scriptPath)) {
+                try {
+                    const content = readFileSync(scriptPath, 'utf-8');
+                    if (content.includes('context-state.json'))
+                        return 'configured';
+                }
+                catch {
+                    /* unreadable */
+                }
+            }
+            return 'custom_no_cleo';
+        }
+        catch {
+            return 'no_settings';
+        }
+    }
+    getStatuslineConfig() {
+        return {
+            statusLine: {
+                type: 'command',
+                command: join(homedir(), '.cleo', 'lib', 'session', 'context-monitor.sh'),
+            },
+        };
+    }
+    getSetupInstructions() {
+        const settingsPath = this.pathProvider.getSettingsPath() ?? '~/.claude/settings.json';
+        return [
+            'To enable context monitoring, add to your Claude Code settings:',
+            `File: ${settingsPath}`,
+            '',
+            JSON.stringify(this.getStatuslineConfig(), null, 2),
+            '',
+            'This enables real-time context window tracking in the CLI.',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=context-monitor.js.map

package/src/providers/claude-code/context-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.js","sourceRoot":"","sources":["context-monitor.ts"],"names":[],"mappings":"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"}