@cleocode/adapters 2026.3.42 → 2026.3.44

package/dist/providers/claude-code/adapter.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Claude Code Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Anthropic's Claude Code CLI.
+ * Provides spawn, hooks, and install capabilities for CLEO integration.
+ *
+ * @task T5240
+ */
+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';
+/**
+ * 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 declare class ClaudeCodeAdapter implements CLEOProviderAdapter {
+    readonly id = "claude-code";
+    readonly name = "Claude Code";
+    readonly version = "1.0.0";
+    capabilities: AdapterCapabilities;
+    hooks: ClaudeCodeHookProvider;
+    spawn: ClaudeCodeSpawnProvider;
+    install: ClaudeCodeInstallProvider;
+    paths: ClaudeCodePathProvider;
+    contextMonitor: ClaudeCodeContextMonitorProvider;
+    transport: ClaudeCodeTransportProvider;
+    taskSync: ClaudeCodeTaskSyncProvider;
+    private projectDir;
+    private initialized;
+    constructor();
+    /**
+     * 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
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     */
+    dispose(): Promise<void>;
+    /**
+     * 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
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/claude-code/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,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,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAmB/B;IAEF,KAAK,EAAE,sBAAsB,CAAC;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,OAAO,EAAE,yBAAyB,CAAC;IACnC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,cAAc,EAAE,gCAAgC,CAAC;IACjD,SAAS,EAAE,2BAA2B,CAAC;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IAErC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/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/dist/providers/claude-code/context-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/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/dist/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/dist/providers/claude-code/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/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/dist/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 { checkStatuslineIntegration, getSetupInstructions, getStatuslineConfig, } from './statusline.js';
+export { ClaudeCodeTransportProvider } from './transport.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/dist/providers/claude-code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/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,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D,eAAe,iBAAiB,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAEjD"}

package/dist/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/dist/providers/claude-code/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;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"}

package/dist/providers/claude-code/paths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude Code path provider.
+ *
+ * Implements AdapterPathProvider with Claude Code-specific directory locations.
+ *
+ * @task T5240
+ */
+import type { AdapterPathProvider } from '@cleocode/contracts';
+/**
+ * Path provider for Anthropic Claude Code CLI.
+ *
+ * Resolves Claude Code's standard directory layout:
+ * - Config dir: ~/.claude (or CLAUDE_HOME)
+ * - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS)
+ * - Agents: ~/.claude/agents
+ * - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
+ */
+export declare class ClaudeCodePathProvider implements AdapterPathProvider {
+    getProviderDir(): string;
+    getSettingsPath(): string | null;
+    getAgentInstallDir(): string | null;
+    getMemoryDbPath(): string | null;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/providers/claude-code/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC"}

package/dist/providers/claude-code/spawn.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Claude Code Spawn Provider
+ *
+ * Implements AdapterSpawnProvider for Claude Code CLI.
+ * Migrated from src/core/spawn/adapters/claude-code-adapter.ts
+ *
+ * Uses the native `claude` CLI to spawn subagent processes with prompts
+ * written to temporary files. Processes run detached and are tracked
+ * by PID for listing and termination.
+ *
+ * @task T5240
+ */
+import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
+/**
+ * Spawn provider for Claude Code.
+ *
+ * Spawns detached Claude CLI processes for subagent execution.
+ * Each spawn writes its prompt to a temporary file, then runs
+ * `claude --allow-insecure --no-upgrade-check <tmpFile>` as a
+ * detached, unref'd child process.
+ */
+export declare class ClaudeCodeSpawnProvider implements AdapterSpawnProvider {
+    /** Map of instance IDs to tracked process info. */
+    private processMap;
+    /**
+     * Check if the Claude CLI is available in PATH.
+     *
+     * @returns true if `claude` is found via `which`
+     */
+    canSpawn(): Promise<boolean>;
+    /**
+     * Spawn a subagent via Claude CLI.
+     *
+     * Writes the prompt to a temporary file and spawns a detached Claude
+     * process. The process runs independently of the parent.
+     *
+     * @param context - Spawn context with taskId, prompt, and options
+     * @returns Spawn result with instance ID and status
+     */
+    spawn(context: SpawnContext): Promise<SpawnResult>;
+    /**
+     * List currently running Claude subagent processes.
+     *
+     * Checks each tracked process via kill(pid, 0) to verify it is still alive.
+     * Dead processes are automatically cleaned from the tracking map.
+     *
+     * @returns Array of spawn results for running processes
+     */
+    listRunning(): Promise<SpawnResult[]>;
+    /**
+     * Terminate a running spawn by instance ID.
+     *
+     * Sends SIGTERM to the tracked process. If the process is not found
+     * or has already exited, this is a no-op.
+     *
+     * @param instanceId - ID of the spawn instance to terminate
+     */
+    terminate(instanceId: string): Promise<void>;
+}
+//# sourceMappingURL=spawn.d.ts.map

package/dist/providers/claude-code/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAY3F;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAuExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}

package/dist/providers/claude-code/statusline.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Statusline integration for the Claude Code adapter.
+ *
+ * Implements the statusline portion of AdapterContextMonitorProvider.
+ * Checks and configures Claude Code status line for context monitoring.
+ *
+ * @task T5240
+ */
+type StatuslineStatus = 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
+/**
+ * Check if statusline integration is configured.
+ * Returns the current integration status.
+ */
+export declare function checkStatuslineIntegration(): StatuslineStatus;
+/**
+ * Get the statusline setup command for Claude Code settings.
+ */
+export declare function getStatuslineConfig(cleoHome: string): Record<string, unknown>;
+/**
+ * Get human-readable setup instructions.
+ */
+export declare function getSetupInstructions(cleoHome: string): string;
+export {};
+//# sourceMappingURL=statusline.d.ts.map

package/dist/providers/claude-code/statusline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/statusline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,KAAK,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAa3F;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAwC7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW7D"}

package/dist/providers/claude-code/task-sync.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude Code TaskSyncProvider — bridges Claude's TodoWrite format
+ * to the provider-agnostic reconciliation system.
+ *
+ * All Claude Code / TodoWrite-specific parsing lives here.
+ * The core reconciliation engine never sees TodoWrite formats.
+ */
+import type { ExternalTask, ExternalTaskProvider } from '@cleocode/contracts';
+/**
+ * Claude Code TaskSyncProvider.
+ *
+ * Reads Claude's TodoWrite JSON state, parses [T001]-prefixed task IDs
+ * and status, and returns normalized ExternalTask[].
+ *
+ * Optional: accepts a custom file path for testing.
+ */
+export declare class ClaudeCodeTaskSyncProvider implements ExternalTaskProvider {
+    private readonly customFilePath?;
+    constructor(options?: {
+        filePath?: string;
+    });
+    getExternalTasks(projectDir: string): Promise<ExternalTask[]>;
+}
+//# sourceMappingURL=task-sync.d.ts.map

package/dist/providers/claude-code/task-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-sync.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/task-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAsB,MAAM,qBAAqB,CAAC;AAkElG;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,oBAAoB;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;gBAE7B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAIrC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAgDpE"}

package/dist/providers/claude-code/transport.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Transport provider for the Claude Code adapter.
+ *
+ * Implements AdapterTransportProvider to supply Claude Code's
+ * native inter-agent transport mechanism.
+ *
+ * @task T5240
+ */
+import type { AdapterTransportProvider } from '@cleocode/contracts';
+export declare class ClaudeCodeTransportProvider implements AdapterTransportProvider {
+    readonly transportName = "claude-code";
+    createTransport(): unknown;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/providers/claude-code/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,qBAAa,2BAA4B,YAAW,wBAAwB;IAC1E,QAAQ,CAAC,aAAa,iBAAiB;IAEvC,eAAe,IAAI,OAAO;CAM3B"}

package/dist/providers/cursor/adapter.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Cursor Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Cursor AI code editor.
+ * Provides install capabilities for CLEO integration. Hooks and spawn
+ * are not supported since Cursor lacks CLI-based lifecycle events
+ * and subagent spawning.
+ *
+ * @task T5240
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { CursorHookProvider } from './hooks.js';
+import { CursorInstallProvider } from './install.js';
+/**
+ * CLEO provider adapter for Cursor AI code editor.
+ *
+ * Bridges CLEO's adapter system with Cursor's capabilities:
+ * - Install: Registers MCP server in .cursor/mcp.json and manages rule files
+ * - Hooks: Stub provider (Cursor has no lifecycle event system)
+ * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
+ */
+export declare class CursorAdapter implements CLEOProviderAdapter {
+    readonly id = "cursor";
+    readonly name = "Cursor";
+    readonly version = "1.0.0";
+    capabilities: AdapterCapabilities;
+    hooks: CursorHookProvider;
+    install: CursorInstallProvider;
+    private projectDir;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Run a health check to verify Cursor is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. .cursor/ configuration directory exists in the project
+     * 3. CURSOR_EDITOR env var is set
+     *
+     * @returns Health status with details about each check
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/cursor/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACvD,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAa/B;IAEF,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC;IAE/B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;OAIG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAwCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/cursor/hooks.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cursor Hook Provider
+ *
+ * Cursor does not have a native hook/event system for external tools.
+ * This provider returns null for all event mappings and marks hooks
+ * as unsupported. It exists to satisfy the AdapterHookProvider contract
+ * so the adapter can be used uniformly by the AdapterManager.
+ *
+ * @task T5240
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Cursor (stub).
+ *
+ * Cursor lacks a hook-based lifecycle event system. All mapping
+ * operations return null. Registration is a no-op.
+ */
+export declare class CursorHookProvider implements AdapterHookProvider {
+    private registered;
+    /**
+     * Map a provider event name to a CAAMP hook event name.
+     *
+     * Always returns null since Cursor does not emit hook events.
+     *
+     * @param _providerEvent - Ignored; Cursor has no hook events
+     * @returns null (no mapping available)
+     */
+    mapProviderEvent(_providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * No-op for Cursor since it has no hook system.
+     *
+     * @param _projectDir - Ignored
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * No-op for Cursor since it has no hook system.
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered.
+     */
+    isRegistered(): boolean;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/providers/cursor/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIvD;;;;;;OAMG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB"}

package/dist/providers/cursor/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cursor provider adapter.
+ *
+ * CLEO provider adapter for Cursor AI code editor.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+import { CursorAdapter } from './adapter.js';
+export { CursorAdapter } from './adapter.js';
+export { CursorHookProvider } from './hooks.js';
+export { CursorInstallProvider } from './install.js';
+export default CursorAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export declare function createAdapter(): CursorAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/cursor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAe,aAAa,CAAC;AAE7B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAE7C"}