@cleocode/adapters 2.0.0

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

@@ -0,0 +1,175 @@
+/**
+ * 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 type { AdapterContextMonitorProvider } from '@cleocode/contracts';
+import { ClaudeCodePathProvider } from './paths.js';
+
+/** Context window input from Claude Code. */
+interface ContextWindowInput {
+  context_window: {
+    context_window_size?: number;
+    current_usage?: {
+      input_tokens?: number;
+      output_tokens?: number;
+      cache_creation_input_tokens?: number;
+      cache_read_input_tokens?: number;
+    };
+  };
+}
+
+/** Thresholds for context window status levels. */
+const THRESHOLDS = {
+  WARNING: 50,
+  CAUTION: 70,
+  CRITICAL: 85,
+  EMERGENCY: 95,
+} as const;
+
+type ContextStatus = 'ok' | 'warning' | 'caution' | 'critical' | 'emergency';
+
+function getContextStatusFromPercentage(percentage: number): ContextStatus {
+  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 implements AdapterContextMonitorProvider {
+  private pathProvider = new ClaudeCodePathProvider();
+
+  async processContextInput(input: unknown, cwd?: string): Promise<string> {
+    const typed = input as ContextWindowInput;
+    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(): 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings' {
+    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(): Record<string, unknown> {
+    return {
+      statusLine: {
+        type: 'command',
+        command: join(homedir(), '.cleo', 'lib', 'session', 'context-monitor.sh'),
+      },
+    };
+  }
+
+  getSetupInstructions(): string {
+    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');
+  }
+}

package/src/providers/claude-code/hooks.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Claude Code Hook Provider
+ *
+ * Maps Claude Code's native hook events to CAAMP hook events.
+ * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
+ * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
+ *
+ * @task T5240
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Claude Code.
+ *
+ * Claude Code registers hooks via a plugin directory
+ * with a hooks.json descriptor. The actual hook scripts are shell scripts
+ * that invoke CLEO's brain observation system.
+ *
+ * Since hooks are registered through the plugin system (installed via
+ * the install provider), registerNativeHooks and unregisterNativeHooks
+ * are effectively no-ops here — the plugin installer handles registration.
+ */
+export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
+    private registered;
+    /**
+     * Map a Claude Code native event name to a CAAMP hook event name.
+     *
+     * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
+     * @returns CAAMP event name or null if unmapped
+     */
+    mapProviderEvent(providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * For Claude Code, hooks are registered via the plugin system
+     * (hooks.json descriptor), which is handled by the
+     * install provider. This method is a no-op since registration
+     * is managed through the plugin install lifecycle.
+     *
+     * @param _projectDir - Project directory (unused; hooks are global)
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * For Claude Code, this is a no-op since hooks are managed through
+     * the plugin system. Unregistration happens via the install provider's
+     * uninstall method.
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     */
+    isRegistered(): boolean;
+    /**
+     * Get the full event mapping for introspection/debugging.
+     */
+    getEventMap(): Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/src/providers/claude-code/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAY/D;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;OASG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;OAMG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAGhD"}

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

@@ -0,0 +1,77 @@
+/**
+ * Claude Code Hook Provider
+ *
+ * Maps Claude Code's native hook events to CAAMP hook events.
+ * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
+ * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
+ *
+ * @task T5240
+ */
+/**
+ * Mapping from Claude Code native event names to CAAMP event names.
+ */
+const CLAUDE_CODE_EVENT_MAP = {
+    SessionStart: 'onSessionStart',
+    PostToolUse: 'onToolComplete',
+    UserPromptSubmit: 'onPromptSubmit',
+    Stop: 'onSessionEnd',
+};
+/**
+ * Hook provider for Claude Code.
+ *
+ * Claude Code registers hooks via a plugin directory
+ * with a hooks.json descriptor. The actual hook scripts are shell scripts
+ * that invoke CLEO's brain observation system.
+ *
+ * Since hooks are registered through the plugin system (installed via
+ * the install provider), registerNativeHooks and unregisterNativeHooks
+ * are effectively no-ops here — the plugin installer handles registration.
+ */
+export class ClaudeCodeHookProvider {
+    registered = false;
+    /**
+     * Map a Claude Code native event name to a CAAMP hook event name.
+     *
+     * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
+     * @returns CAAMP event name or null if unmapped
+     */
+    mapProviderEvent(providerEvent) {
+        return CLAUDE_CODE_EVENT_MAP[providerEvent] ?? null;
+    }
+    /**
+     * Register native hooks for a project.
+     *
+     * For Claude Code, hooks are registered via the plugin system
+     * (hooks.json descriptor), which is handled by the
+     * install provider. This method is a no-op since registration
+     * is managed through the plugin install lifecycle.
+     *
+     * @param _projectDir - Project directory (unused; hooks are global)
+     */
+    async registerNativeHooks(_projectDir) {
+        this.registered = true;
+    }
+    /**
+     * Unregister native hooks.
+     *
+     * For Claude Code, this is a no-op since hooks are managed through
+     * the plugin system. Unregistration happens via the install provider's
+     * uninstall method.
+     */
+    async unregisterNativeHooks() {
+        this.registered = false;
+    }
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     */
+    isRegistered() {
+        return this.registered;
+    }
+    /**
+     * Get the full event mapping for introspection/debugging.
+     */
+    getEventMap() {
+        return { ...CLAUDE_CODE_EVENT_MAP };
+    }
+}
+//# sourceMappingURL=hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,qBAAqB,GAA2B;IACpD,YAAY,EAAE,gBAAgB;IAC9B,WAAW,EAAE,gBAAgB;IAC7B,gBAAgB,EAAE,gBAAgB;IAClC,IAAI,EAAE,cAAc;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,sBAAsB;IACzB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,qBAAqB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACtD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACtC,CAAC;CACF"}

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

@@ -0,0 +1,85 @@
+/**
+ * Claude Code Hook Provider
+ *
+ * Maps Claude Code's native hook events to CAAMP hook events.
+ * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
+ * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
+ *
+ * @task T5240
+ */
+
+import type { AdapterHookProvider } from '@cleocode/contracts';
+
+/**
+ * Mapping from Claude Code native event names to CAAMP event names.
+ */
+const CLAUDE_CODE_EVENT_MAP: Record<string, string> = {
+  SessionStart: 'onSessionStart',
+  PostToolUse: 'onToolComplete',
+  UserPromptSubmit: 'onPromptSubmit',
+  Stop: 'onSessionEnd',
+};
+
+/**
+ * Hook provider for Claude Code.
+ *
+ * Claude Code registers hooks via a plugin directory
+ * with a hooks.json descriptor. The actual hook scripts are shell scripts
+ * that invoke CLEO's brain observation system.
+ *
+ * Since hooks are registered through the plugin system (installed via
+ * the install provider), registerNativeHooks and unregisterNativeHooks
+ * are effectively no-ops here — the plugin installer handles registration.
+ */
+export class ClaudeCodeHookProvider implements AdapterHookProvider {
+  private registered = false;
+
+  /**
+   * Map a Claude Code native event name to a CAAMP hook event name.
+   *
+   * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
+   * @returns CAAMP event name or null if unmapped
+   */
+  mapProviderEvent(providerEvent: string): string | null {
+    return CLAUDE_CODE_EVENT_MAP[providerEvent] ?? null;
+  }
+
+  /**
+   * Register native hooks for a project.
+   *
+   * For Claude Code, hooks are registered via the plugin system
+   * (hooks.json descriptor), which is handled by the
+   * install provider. This method is a no-op since registration
+   * is managed through the plugin install lifecycle.
+   *
+   * @param _projectDir - Project directory (unused; hooks are global)
+   */
+  async registerNativeHooks(_projectDir: string): Promise<void> {
+    this.registered = true;
+  }
+
+  /**
+   * Unregister native hooks.
+   *
+   * For Claude Code, this is a no-op since hooks are managed through
+   * the plugin system. Unregistration happens via the install provider's
+   * uninstall method.
+   */
+  async unregisterNativeHooks(): Promise<void> {
+    this.registered = false;
+  }
+
+  /**
+   * Check whether hooks have been registered via registerNativeHooks.
+   */
+  isRegistered(): boolean {
+    return this.registered;
+  }
+
+  /**
+   * Get the full event mapping for introspection/debugging.
+   */
+  getEventMap(): Readonly<Record<string, string>> {
+    return { ...CLAUDE_CODE_EVENT_MAP };
+  }
+}

package/src/providers/claude-code/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude Code provider adapter.
+ *
+ * CLEO provider adapter for Anthropic Claude Code CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+import { ClaudeCodeAdapter } from './adapter.js';
+export { ClaudeCodeAdapter } from './adapter.js';
+export { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
+export { ClaudeCodeHookProvider } from './hooks.js';
+export { ClaudeCodeInstallProvider } from './install.js';
+export { ClaudeCodePathProvider } from './paths.js';
+export { ClaudeCodeSpawnProvider } from './spawn.js';
+export { ClaudeCodeTransportProvider } from './transport.js';
+export { checkStatuslineIntegration, getStatuslineConfig, getSetupInstructions, } from './statusline.js';
+export default ClaudeCodeAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export declare function createAdapter(): ClaudeCodeAdapter;
+//# sourceMappingURL=index.d.ts.map

package/src/providers/claude-code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,eAAe,iBAAiB,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAEjD"}

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

@@ -0,0 +1,26 @@
+/**
+ * Claude Code provider adapter.
+ *
+ * CLEO provider adapter for Anthropic Claude Code CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+import { ClaudeCodeAdapter } from './adapter.js';
+export { ClaudeCodeAdapter } from './adapter.js';
+export { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
+export { ClaudeCodeHookProvider } from './hooks.js';
+export { ClaudeCodeInstallProvider } from './install.js';
+export { ClaudeCodePathProvider } from './paths.js';
+export { ClaudeCodeSpawnProvider } from './spawn.js';
+export { ClaudeCodeTransportProvider } from './transport.js';
+export { checkStatuslineIntegration, getStatuslineConfig, getSetupInstructions, } from './statusline.js';
+export default ClaudeCodeAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export function createAdapter() {
+    return new ClaudeCodeAdapter();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,eAAe,iBAAiB,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * Claude Code provider adapter.
+ *
+ * CLEO provider adapter for Anthropic Claude Code CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+
+import { ClaudeCodeAdapter } from './adapter.js';
+
+export { ClaudeCodeAdapter } from './adapter.js';
+export { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
+export { ClaudeCodeHookProvider } from './hooks.js';
+export { ClaudeCodeInstallProvider } from './install.js';
+export { ClaudeCodePathProvider } from './paths.js';
+export { ClaudeCodeSpawnProvider } from './spawn.js';
+export { ClaudeCodeTransportProvider } from './transport.js';
+export {
+  checkStatuslineIntegration,
+  getStatuslineConfig,
+  getSetupInstructions,
+} from './statusline.js';
+
+export default ClaudeCodeAdapter;
+
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export function createAdapter(): ClaudeCodeAdapter {
+  return new ClaudeCodeAdapter();
+}

package/src/providers/claude-code/install.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Claude Code Install Provider
+ *
+ * Handles CLEO installation into Claude Code environments:
+ * - Registers CLEO MCP server in .mcp.json
+ * - Ensures CLAUDE.md has CLEO @-references
+ * - Manages plugin registration in ~/.claude/settings.json
+ *
+ * Migrated from src/core/install/claude-plugin.ts
+ *
+ * @task T5240
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * Install provider for Claude Code.
+ *
+ * Manages CLEO's integration with Claude Code by:
+ * 1. Registering the CLEO MCP server in the project's .mcp.json
+ * 2. Ensuring CLAUDE.md contains @-references to CLEO instruction files
+ * 3. Registering the brain observation plugin in ~/.claude/settings.json
+ */
+export declare class ClaudeCodeInstallProvider implements AdapterInstallProvider {
+    private installedProjectDir;
+    /**
+     * Install CLEO into a Claude Code project.
+     *
+     * @param options - Installation options including project directory and MCP server path
+     * @returns Result describing what was installed
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * Uninstall CLEO from the current Claude Code project.
+     *
+     * Removes the MCP server registration from .mcp.json.
+     * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the current environment.
+     *
+     * Checks for:
+     * 1. MCP server registered in .mcp.json
+     * 2. Plugin enabled in ~/.claude/settings.json
+     *
+     * Returns true if either condition is met (partial install counts).
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Ensure CLAUDE.md contains @-references to CLEO instruction files.
+     *
+     * Creates CLAUDE.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+    /**
+     * Register the CLEO MCP server in .mcp.json.
+     *
+     * @returns true if registration was performed or updated
+     */
+    private registerMcpServer;
+    /**
+     * Update CLAUDE.md with CLEO @-references.
+     *
+     * @returns true if the file was created or modified
+     */
+    private updateInstructionFile;
+    /**
+     * Register the CLEO brain plugin in ~/.claude/settings.json.
+     *
+     * @returns Description of what was registered, or null if no change needed
+     */
+    private registerPlugin;
+}
+//# sourceMappingURL=install.d.ts.map

package/src/providers/claude-code/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWjG;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAsC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;;;;;;OAQG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgCrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAiCvB"}