@cleocode/adapters 2026.3.42 → 2026.3.43

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @cleocode/adapters
+ *
+ * Unified provider adapter package for CLEO.
+ * Exports all provider adapters and a registry for manifest discovery.
+ */
+export { ClaudeCodeAdapter, ClaudeCodeContextMonitorProvider, ClaudeCodeHookProvider, ClaudeCodeInstallProvider, ClaudeCodePathProvider, ClaudeCodeSpawnProvider, ClaudeCodeTransportProvider, checkStatuslineIntegration, createAdapter as createClaudeCodeAdapter, getSetupInstructions, getStatuslineConfig, } from './providers/claude-code/index.js';
+export { CursorAdapter, CursorHookProvider, CursorInstallProvider, createAdapter as createCursorAdapter, } from './providers/cursor/index.js';
+export { createAdapter as createOpenCodeAdapter, OpenCodeAdapter, OpenCodeHookProvider, OpenCodeInstallProvider, OpenCodeSpawnProvider, } from './providers/opencode/index.js';
+export type { AdapterManifest } from './registry.js';
+export { discoverProviders, getProviderManifests } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,aAAa,IAAI,uBAAuB,EACxC,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,IAAI,mBAAmB,GACrC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,IAAI,qBAAqB,EACtC,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

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"}

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

@@ -0,0 +1,94 @@
+/**
+ * Cursor Install Provider
+ *
+ * Handles CLEO installation into Cursor environments:
+ * - Registers CLEO MCP server in .cursor/mcp.json
+ * - Ensures .cursorrules has CLEO @-references (legacy format)
+ * - Creates .cursor/rules/cleo.mdc with CLEO references (modern format)
+ *
+ * Cursor supports two instruction file formats:
+ * 1. Legacy: .cursorrules (flat file, project root)
+ * 2. Modern: .cursor/rules/*.mdc (MDC format, per-rule files)
+ *
+ * This provider writes to both for maximum compatibility.
+ *
+ * @task T5240
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * Install provider for Cursor.
+ *
+ * Manages CLEO's integration with Cursor by:
+ * 1. Registering the CLEO MCP server in .cursor/mcp.json
+ * 2. Creating/updating .cursorrules with @-references (legacy)
+ * 3. Creating .cursor/rules/cleo.mdc with @-references (modern)
+ */
+export declare class CursorInstallProvider implements AdapterInstallProvider {
+    private installedProjectDir;
+    /**
+     * Install CLEO into a Cursor 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 Cursor project.
+     *
+     * Removes the MCP server registration from .cursor/mcp.json.
+     * Does not remove instruction file references (they are harmless if CLEO is not present).
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the current environment.
+     *
+     * Checks for MCP server registered in .cursor/mcp.json.
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Ensure instruction files contain @-references to CLEO.
+     *
+     * Updates .cursorrules (legacy) and creates .cursor/rules/cleo.mdc (modern).
+     *
+     * @param projectDir - Project root directory
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+    /**
+     * Register the CLEO MCP server in .cursor/mcp.json.
+     *
+     * Cursor stores MCP server configuration in .cursor/mcp.json
+     * under the mcpServers key.
+     *
+     * @returns true if registration was performed or updated
+     */
+    private registerMcpServer;
+    /**
+     * Update instruction files with CLEO @-references.
+     *
+     * Handles both legacy (.cursorrules) and modern (.cursor/rules/cleo.mdc) formats.
+     *
+     * @returns true if any file was created or modified
+     */
+    private updateInstructionFiles;
+    /**
+     * Update legacy .cursorrules file with @-references.
+     * Only modifies the file if it already exists (does not create it).
+     *
+     * @returns true if the file was modified
+     */
+    private updateLegacyRules;
+    /**
+     * Create or update .cursor/rules/cleo.mdc with CLEO references.
+     *
+     * MDC (Markdown Component) format is Cursor's modern rule file format.
+     * Each .mdc file in .cursor/rules/ is loaded as a rule set.
+     *
+     * @returns true if the file was created or modified
+     */
+    private updateModernRules;
+    /**
+     * Get list of instruction files that were updated.
+     */
+    private getUpdatedFileList;
+}
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

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

@@ -0,0 +1,50 @@
+/**
+ * Cursor Spawn Provider
+ *
+ * Cursor is a GUI-based AI code editor and does not support
+ * CLI-based subagent spawning. This provider implements
+ * the AdapterSpawnProvider interface with appropriate rejections.
+ *
+ * @task T5240
+ */
+import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
+/**
+ * Spawn provider for Cursor.
+ *
+ * Cursor does not support subagent spawning via CLI. The adapter
+ * declares supportsSpawn: false in its capabilities. All methods
+ * either reject or return empty results.
+ */
+export declare class CursorSpawnProvider implements AdapterSpawnProvider {
+    /**
+     * Check if Cursor supports spawning subagents.
+     *
+     * @returns false (Cursor does not support CLI spawning)
+     */
+    canSpawn(): Promise<boolean>;
+    /**
+     * Attempt to spawn a subagent via Cursor.
+     *
+     * Always throws because Cursor does not support subagent spawning.
+     * Callers should check canSpawn() before calling this method.
+     *
+     * @param _context - Unused; spawning is not supported
+     * @throws Error explaining that Cursor does not support subagent spawning
+     */
+    spawn(_context: SpawnContext): Promise<SpawnResult>;
+    /**
+     * List running Cursor subagent processes.
+     *
+     * @returns Empty array (no processes can be spawned)
+     */
+    listRunning(): Promise<SpawnResult[]>;
+    /**
+     * Terminate a Cursor subagent process.
+     *
+     * No-op because Cursor cannot spawn processes.
+     *
+     * @param _instanceId - Unused; no processes to terminate
+     */
+    terminate(_instanceId: string): Promise<void>;
+}
+//# sourceMappingURL=spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE3F;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;;;;;;;OAQG;IACG,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAQzD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI3C;;;;;;OAMG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

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

@@ -0,0 +1,67 @@
+/**
+ * OpenCode Adapter
+ *
+ * Main CLEOProviderAdapter implementation for OpenCode AI coding assistant.
+ * Provides spawn, hooks, and install capabilities for CLEO integration.
+ *
+ * @task T5240
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { OpenCodeHookProvider } from './hooks.js';
+import { OpenCodeInstallProvider } from './install.js';
+import { OpenCodeSpawnProvider } from './spawn.js';
+/**
+ * CLEO provider adapter for OpenCode AI coding assistant.
+ *
+ * Bridges CLEO's adapter system with OpenCode's native capabilities:
+ * - Hooks: Maps OpenCode events (session.start, tool.complete, etc.) to CAAMP events
+ * - Spawn: Launches subagent processes via the `opencode` CLI
+ * - Install: Registers MCP server in .opencode/config.json and ensures AGENTS.md references
+ */
+export declare class OpenCodeAdapter implements CLEOProviderAdapter {
+    readonly id = "opencode";
+    readonly name = "OpenCode";
+    readonly version = "1.0.0";
+    capabilities: AdapterCapabilities;
+    hooks: OpenCodeHookProvider;
+    spawn: OpenCodeSpawnProvider;
+    install: OpenCodeInstallProvider;
+    private projectDir;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * Validates the environment by checking for the OpenCode CLI
+     * and OpenCode 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 OpenCode is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. OpenCode CLI is available in PATH
+     * 3. .opencode/ configuration directory exists in the project
+     *
+     * @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/opencode/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAInD;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,mBAAmB;IACzD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAoB/B;IAEF,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,uBAAuB,CAAC;IAEjC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAQ5B;;;;;;;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;IA2CjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

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

@@ -0,0 +1,66 @@
+/**
+ * OpenCode Hook Provider
+ *
+ * Maps OpenCode's native hook events to CAAMP hook events.
+ * OpenCode supports 6 of 8 CAAMP events through its agent/hook system.
+ *
+ * OpenCode event mapping:
+ * - session.start     -> onSessionStart
+ * - session.end       -> onSessionEnd
+ * - tool.start        -> onToolStart
+ * - tool.complete     -> onToolComplete
+ * - error             -> onError
+ * - prompt.submit     -> onPromptSubmit
+ *
+ * @task T5240
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for OpenCode.
+ *
+ * OpenCode registers hooks via its configuration system at
+ * .opencode/config.json. Hook handlers are defined as shell commands
+ * or script paths that execute when the corresponding event fires.
+ *
+ * Since hooks are registered through the config system (managed by
+ * the install provider), registerNativeHooks and unregisterNativeHooks
+ * track registration state without performing filesystem operations.
+ */
+export declare class OpenCodeHookProvider implements AdapterHookProvider {
+    private registered;
+    /**
+     * Map an OpenCode native event name to a CAAMP hook event name.
+     *
+     * @param providerEvent - OpenCode event name (e.g. "session.start", "tool.complete")
+     * @returns CAAMP event name or null if unmapped
+     */
+    mapProviderEvent(providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * For OpenCode, hooks are registered via the config system
+     * (.opencode/config.json), which is handled by the install provider.
+     * This method marks hooks as registered without performing
+     * filesystem operations.
+     *
+     * @param _projectDir - Project directory (unused; config manages registration)
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * For OpenCode, this is a no-op since hooks are managed through
+     * the config 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/opencode/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAiB/D;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,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/opencode/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenCode provider adapter.
+ *
+ * CLEO provider adapter for OpenCode AI coding assistant.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+import { OpenCodeAdapter } from './adapter.js';
+export { OpenCodeAdapter } from './adapter.js';
+export { OpenCodeHookProvider } from './hooks.js';
+export { OpenCodeInstallProvider } from './install.js';
+export { OpenCodeSpawnProvider } from './spawn.js';
+export default OpenCodeAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export declare function createAdapter(): OpenCodeAdapter;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAe,eAAe,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}

package/dist/providers/opencode/install.d.ts

@@ -0,0 +1,65 @@
+/**
+ * OpenCode Install Provider
+ *
+ * Handles CLEO installation into OpenCode environments:
+ * - Registers CLEO MCP server in .opencode/config.json
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T5240
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * Install provider for OpenCode.
+ *
+ * Manages CLEO's integration with OpenCode by:
+ * 1. Registering the CLEO MCP server in .opencode/config.json
+ * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ */
+export declare class OpenCodeInstallProvider implements AdapterInstallProvider {
+    private installedProjectDir;
+    /**
+     * Install CLEO into an OpenCode 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 OpenCode project.
+     *
+     * Removes the MCP server registration from .opencode/config.json.
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the current environment.
+     *
+     * Checks for MCP server registered in .opencode/config.json.
+     * Returns true if the CLEO MCP server entry is found.
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     *
+     * Creates AGENTS.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 .opencode/config.json.
+     *
+     * OpenCode stores its MCP server configuration in .opencode/config.json
+     * under the mcpServers key.
+     *
+     * @returns true if registration was performed or updated
+     */
+    private registerMcpServer;
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @returns true if the file was created or modified
+     */
+    private updateInstructionFile;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/providers/opencode/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CA8B9B"}

package/dist/providers/opencode/spawn.d.ts

@@ -0,0 +1,72 @@
+/**
+ * OpenCode Spawn Provider
+ *
+ * Implements AdapterSpawnProvider for OpenCode CLI.
+ * Migrated from src/core/spawn/adapters/opencode-adapter.ts
+ *
+ * Uses `opencode run --agent ... --format json` to spawn subagent
+ * processes. Processes run detached and are tracked by PID for
+ * listing and termination.
+ *
+ * @task T5240
+ */
+import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
+/**
+ * Build the markdown content for an OpenCode agent definition file.
+ *
+ * OpenCode agents are defined as markdown files with YAML frontmatter
+ * in the .opencode/agent/ directory.
+ *
+ * @param description - Agent description for frontmatter
+ * @param instructions - Markdown instructions body
+ * @returns Complete agent definition markdown
+ */
+export declare function buildOpenCodeAgentMarkdown(description: string, instructions: string): string;
+/**
+ * Spawn provider for OpenCode.
+ *
+ * Spawns detached OpenCode CLI processes for subagent execution.
+ * Each spawn ensures a CLEO subagent definition exists, then runs
+ * `opencode run --format json --agent <name> --title <title> <prompt>`
+ * as a detached, unref'd child process.
+ */
+export declare class OpenCodeSpawnProvider implements AdapterSpawnProvider {
+    /** Map of instance IDs to tracked process info. */
+    private processMap;
+    /**
+     * Check if the OpenCode CLI is available in PATH.
+     *
+     * @returns true if `opencode` is found via `which`
+     */
+    canSpawn(): Promise<boolean>;
+    /**
+     * Spawn a subagent via OpenCode CLI.
+     *
+     * Ensures the CLEO subagent definition exists in the project's
+     * .opencode/agent/ directory, then spawns a detached OpenCode
+     * 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 OpenCode 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/opencode/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiB3F;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY5F;AA0CD;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAiExD;;;;;;;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/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Adapter registry — discovers and provides access to provider manifests.
+ *
+ * Scans the providers/ directory for manifest.json files and returns
+ * the discovered adapter manifests for use by AdapterManager.
+ *
+ * @task T5240
+ */
+/** Minimal manifest shape for provider discovery. */
+export interface AdapterManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    provider: string;
+    entryPoint: string;
+    capabilities: Record<string, unknown>;
+    detectionPatterns: Array<{
+        type: string;
+        pattern: string;
+        description: string;
+    }>;
+}
+/**
+ * Get the manifests for all bundled provider adapters.
+ *
+ * @returns Array of adapter manifests
+ */
+export declare function getProviderManifests(): AdapterManifest[];
+/**
+ * Discover all available provider adapters.
+ *
+ * Returns a map of provider ID to adapter factory function.
+ */
+export declare function discoverProviders(): Promise<Map<string, () => Promise<unknown>>>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAKD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAexD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAmBtF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.3.42",
+  "version": "2026.3.43",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     }
   },
   "dependencies": {
-    "@cleocode/contracts": "2026.3.42"
+    "@cleocode/contracts": "2026.3.43"
   },
   "license": "MIT",
   "engines": {