@cleocode/adapters 2026.4.0 → 2026.4.2

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

@@ -20,21 +20,41 @@ import { ClaudeCodeTransportProvider } from './transport.js';
  * 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
+ * - Install: Manages instruction files and brain observation plugin registration
+ *
+ * @remarks
+ * This is the most feature-complete adapter in the CLEO system, supporting
+ * 14 of 16 CAAMP canonical events, subagent spawning via the `claude` CLI,
+ * context monitoring with statusline integration, task sync via TodoWrite,
+ * and inter-agent transport. It serves as the reference implementation for
+ * other provider adapters.
  */
 export declare class ClaudeCodeAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
     readonly id = "claude-code";
+    /** Human-readable provider name. */
     readonly name = "Claude Code";
+    /** Adapter version string. */
     readonly version = "1.0.0";
+    /** Declared capabilities for this provider. */
     capabilities: AdapterCapabilities;
+    /** Hook provider for CAAMP event mapping and registration. */
     hooks: ClaudeCodeHookProvider;
+    /** Spawn provider for launching subagent processes via `claude` CLI. */
     spawn: ClaudeCodeSpawnProvider;
+    /** Install provider for managing instruction files and plugin registration. */
     install: ClaudeCodeInstallProvider;
+    /** Path provider for resolving Claude Code directory locations. */
     paths: ClaudeCodePathProvider;
+    /** Context monitor for tracking context window usage and statusline output. */
     contextMonitor: ClaudeCodeContextMonitorProvider;
+    /** Transport provider for inter-agent communication. */
     transport: ClaudeCodeTransportProvider;
+    /** Task sync provider bridging Claude's TodoWrite format to CLEO tasks. */
     taskSync: ClaudeCodeTaskSyncProvider;
+    /** Project directory this adapter was initialized with, or null. */
     private projectDir;
+    /** Whether {@link initialize} has been called. */
     private initialized;
     constructor();
     /**

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

@@ -1 +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,CA8B/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"}
+{"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;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA8B/B;IAEF,8DAA8D;IAC9D,KAAK,EAAE,sBAAsB,CAAC;IAC9B,wEAAwE;IACxE,KAAK,EAAE,uBAAuB,CAAC;IAC/B,+EAA+E;IAC/E,OAAO,EAAE,yBAAyB,CAAC;IACnC,mEAAmE;IACnE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,EAAE,gCAAgC,CAAC;IACjD,wDAAwD;IACxD,SAAS,EAAE,2BAA2B,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,EAAE,0BAA0B,CAAC;IAErC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,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

@@ -13,12 +13,23 @@ import type { AdapterContextMonitorProvider } from '@cleocode/contracts';
  * 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.
+ *
+ * @remarks
+ * The provider writes a JSON state file to `.cleo/context-states/.context-state.json`
+ * which can be read by external statusline scripts (e.g. tmux, starship).
+ * Context thresholds at 50%, 70%, 85%, and 95% map to warning, caution,
+ * critical, and emergency status levels respectively.
  */
 export declare class ClaudeCodeContextMonitorProvider implements AdapterContextMonitorProvider {
+    /** Path provider for resolving Claude Code directory locations. */
     private pathProvider;
+    /** Process raw context window JSON and return a formatted summary string. */
     processContextInput(input: unknown, cwd?: string): Promise<string>;
+    /** Check the current statusline integration status in Claude Code settings. */
     checkStatuslineIntegration(): 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
+    /** Get the recommended statusline configuration object for Claude Code settings. */
     getStatuslineConfig(): Record<string, unknown>;
+    /** Get human-readable setup instructions for enabling context monitoring. */
     getSetupInstructions(): string;
 }
 //# sourceMappingURL=context-monitor.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;GAYG;AACH,qBAAa,gCAAiC,YAAW,6BAA6B;IACpF,mEAAmE;IACnE,OAAO,CAAC,YAAY,CAAgC;IAEpD,6EAA6E;IACvE,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0DxE,+EAA+E;IAC/E,0BAA0B,IAAI,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa;IAsChG,oFAAoF;IACpF,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS9C,6EAA6E;IAC7E,oBAAoB,IAAI,MAAM;CAY/B"}

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

@@ -30,10 +30,17 @@ import type { AdapterHookProvider } from '@cleocode/contracts';
  * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
  * state without performing filesystem operations.
  *
+ * @remarks
+ * Claude Code is the only provider that supports all 14 of its declared
+ * canonical events at runtime. The static event map is maintained as a
+ * synchronous fallback; async methods like {@link getSupportedCanonicalEvents}
+ * and {@link getProviderProfile} call CAAMP directly when available.
+ *
  * @task T164
  * @epic T134
  */
 export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
+    /** Whether hooks have been registered for the current session. */
     private registered;
     /**
      * Map a Claude Code native event name to a CAAMP canonical hook event name.

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8C/D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA2DrF"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8C/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA2DrF"}

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

@@ -1,5 +1,5 @@
 /**
- * Claude Code provider adapter.
+ * @packageDocumentation
  *
  * CLEO provider adapter for Anthropic Claude Code CLI.
  * Default export is the adapter class for dynamic loading by AdapterManager.
@@ -19,6 +19,21 @@ export default ClaudeCodeAdapter;
 /**
  * Factory function for creating adapter instances.
  * Used by AdapterManager's dynamic import fallback.
+ *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the claude-code
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link ClaudeCodeAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/claude-code';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
  */
 export declare function createAdapter(): ClaudeCodeAdapter;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAEjD"}

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

@@ -2,7 +2,6 @@
  * 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
  *
@@ -15,34 +14,33 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  * 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
+ * 1. Ensuring CLAUDE.md contains @-references to CLEO instruction files
+ * 2. Registering the brain observation plugin in ~/.claude/settings.json
+ *
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. The provider disables the legacy
+ * `claude-mem\@thedotmack` plugin if present and enables the unified
+ * `cleo\@cleocode` plugin instead.
  */
 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
+     * @param options - Installation options including project directory
      * @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).
+     * Checks for plugin enabled in ~/.claude/settings.json.
      */
     isInstalled(): Promise<boolean>;
     /**
@@ -53,12 +51,6 @@ export declare class ClaudeCodeInstallProvider implements AdapterInstallProvider
      * @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.
      *

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

@@ -1 +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"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA2B9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAiCvB"}

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

@@ -14,11 +14,19 @@ import type { AdapterPathProvider } from '@cleocode/contracts';
  * - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS)
  * - Agents: ~/.claude/agents
  * - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
+ *
+ * @remarks
+ * All paths respect environment variable overrides for CI and non-standard
+ * installations. When env vars are unset, the canonical default paths are used.
  */
 export declare class ClaudeCodePathProvider implements AdapterPathProvider {
+    /** Get the provider's root configuration directory. */
     getProviderDir(): string;
+    /** Get the path to the provider's settings file, or null if unavailable. */
     getSettingsPath(): string | null;
+    /** Get the directory where agents are installed, or null if unsupported. */
     getAgentInstallDir(): string | null;
+    /** Get the path to the provider's memory database, or null if unsupported. */
     getMemoryDbPath(): string | null;
 }
 //# sourceMappingURL=paths.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,uDAAuD;IACvD,cAAc,IAAI,MAAM;IAIxB,4EAA4E;IAC5E,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,4EAA4E;IAC5E,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC,8EAA8E;IAC9E,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC"}

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

@@ -18,6 +18,13 @@ import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/
  * 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.
+ *
+ * @remarks
+ * The provider uses `--allow-insecure --no-upgrade-check` flags to
+ * ensure the Claude CLI starts without interactive prompts. Prompts are
+ * written to temporary files under `/tmp/` and cleaned up after the
+ * child process exits. Processes are tracked by instance ID in an
+ * in-memory map and verified via `kill(pid, 0)` liveness checks.
  */
 export declare class ClaudeCodeSpawnProvider implements AdapterSpawnProvider {
     /** Map of instance IDs to tracked process info. */

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;GAcG;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

@@ -10,14 +10,58 @@ type StatuslineStatus = 'configured' | 'not_configured' | 'custom_no_cleo' | 'no
 /**
  * Check if statusline integration is configured.
  * Returns the current integration status.
+ *
+ * @remarks
+ * Reads Claude Code's settings.json and inspects the `statusLine` field
+ * to determine whether CLEO context monitoring is active.
+ *
+ * @returns One of: 'configured', 'not_configured', 'custom_no_cleo', 'no_settings'
+ *
+ * @example
+ * ```typescript
+ * import { checkStatuslineIntegration } from './statusline.js';
+ *
+ * const status = checkStatuslineIntegration();
+ * if (status === 'not_configured') {
+ *   console.log('Run cleo install to set up context monitoring');
+ * }
+ * ```
  */
 export declare function checkStatuslineIntegration(): StatuslineStatus;
 /**
  * Get the statusline setup command for Claude Code settings.
+ *
+ * @remarks
+ * Returns a JSON-serializable object that can be merged into
+ * Claude Code's settings.json to enable context monitoring.
+ *
+ * @param cleoHome - Absolute path to the CLEO home directory
+ * @returns Settings object containing the statusLine configuration
+ *
+ * @example
+ * ```typescript
+ * import { getStatuslineConfig } from './statusline.js';
+ *
+ * const config = getStatuslineConfig('/home/user/.cleo');
+ * ```
  */
 export declare function getStatuslineConfig(cleoHome: string): Record<string, unknown>;
 /**
  * Get human-readable setup instructions.
+ *
+ * @remarks
+ * Returns a multi-line string with file path, JSON config, and explanation
+ * suitable for display to the user.
+ *
+ * @param cleoHome - Absolute path to the CLEO home directory
+ * @returns Formatted setup instructions string
+ *
+ * @example
+ * ```typescript
+ * import { getSetupInstructions } from './statusline.js';
+ *
+ * console.log(getSetupInstructions('/home/user/.cleo'));
+ * ```
  */
 export declare function getSetupInstructions(cleoHome: string): string;
 export {};

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAwC7D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO7E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW7D"}

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

@@ -13,12 +13,20 @@ import type { ExternalTask, ExternalTaskProvider } from '@cleocode/contracts';
  * and status, and returns normalized ExternalTask[].
  *
  * Optional: accepts a custom file path for testing.
+ *
+ * @remarks
+ * TodoWrite items with `[T001]`-style prefixes are mapped to their CLEO
+ * task IDs. Items without a prefix receive a synthetic `tw-new-N` ID
+ * for reconciliation. The provider reads from
+ * `.cleo/sync/todowrite-state.json` by default.
  */
 export declare class ClaudeCodeTaskSyncProvider implements ExternalTaskProvider {
+    /** Optional override path for the TodoWrite state file (used in tests). */
     private readonly customFilePath?;
     constructor(options?: {
         filePath?: string;
     });
+    /** Retrieve external tasks from Claude's TodoWrite state file. */
     getExternalTasks(projectDir: string): Promise<ExternalTask[]>;
 }
 //# sourceMappingURL=task-sync.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA2B,YAAW,oBAAoB;IACrE,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;gBAE7B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAI3C,kEAAkE;IAC5D,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAgDpE"}

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

@@ -7,8 +7,19 @@
  * @task T5240
  */
 import type { AdapterTransportProvider } from '@cleocode/contracts';
+/**
+ * Transport provider for Claude Code inter-agent communication.
+ *
+ * @remarks
+ * Currently returns null from {@link createTransport} because actual transport
+ * creation is handled by the signaldock factory which checks for this adapter's
+ * transport capability flag. Full wiring will be completed in Phase 5 of the
+ * adapter system rollout.
+ */
 export declare class ClaudeCodeTransportProvider implements AdapterTransportProvider {
+    /** Provider-specific transport name used for capability negotiation. */
     readonly transportName = "claude-code";
+    /** Create a transport instance for inter-agent messaging. */
     createTransport(): unknown;
 }
 //# sourceMappingURL=transport.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,YAAW,wBAAwB;IAC1E,wEAAwE;IACxE,QAAQ,CAAC,aAAa,iBAAiB;IAEvC,6DAA6D;IAC7D,eAAe,IAAI,OAAO;CAM3B"}

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

@@ -15,19 +15,32 @@ import { CodexInstallProvider } from './install.js';
  *
  * Bridges CLEO's adapter system with Codex CLI's native capabilities:
  * - Hooks: Maps Codex events (SessionStart, PromptSubmit, ResponseComplete) to CAAMP events
- * - Install: Registers MCP server in ~/.codex/config.json and ensures AGENTS.md references
+ * - Install: Ensures AGENTS.md references for CLEO instruction files
+ *
+ * @remarks
+ * Codex CLI supports only 3 canonical events (SessionStart, PromptSubmit,
+ * ResponseComplete) and has no spawn or transport capabilities. Integration
+ * is primarily through instruction files (AGENTS.md).
  *
  * @task T162
  * @epic T134
  */
 export declare class CodexAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
     readonly id = "codex";
+    /** Human-readable provider name. */
     readonly name = "Codex";
+    /** Adapter version string. */
     readonly version = "1.0.0";
+    /** Declared capabilities for this provider. */
     capabilities: AdapterCapabilities;
+    /** Hook provider for CAAMP event mapping. */
     hooks: CodexHookProvider;
+    /** Install provider for managing instruction files. */
     install: CodexInstallProvider;
+    /** Project directory this adapter was initialized with, or null. */
     private projectDir;
+    /** Whether {@link initialize} has been called. */
     private initialized;
     constructor();
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIpD;;;;;;;;;GASG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,QAAQ,CAAC,EAAE,WAAW;IACtB,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAY/B;IAEF,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,oBAAoB,CAAC;IAE9B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIpD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,WAAW;IACtB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,WAAW;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CAY/B;IAEF,6CAA6C;IAC7C,KAAK,EAAE,iBAAiB,CAAC;IACzB,uDAAuD;IACvD,OAAO,EAAE,oBAAoB,CAAC;IAE9B,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

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

@@ -24,10 +24,16 @@ import type { AdapterHookProvider } from '@cleocode/contracts';
  * the install provider), registerNativeHooks and unregisterNativeHooks
  * track registration state without performing filesystem operations.
  *
+ * @remarks
+ * Codex CLI has a minimal hook surface with only 3 canonical events.
+ * Registration state is tracked in-memory because Codex CLI manages
+ * hooks through its own configuration system at `~/.codex/`.
+ *
  * @task T162
  * @epic T134
  */
 export declare class CodexHookProvider implements AdapterHookProvider {
+    /** Whether hooks have been registered for the current session. */
     private registered;
     /**
      * Map a Codex CLI native event name to a CAAMP hook event name.

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAY/D;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGrF"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAY/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGrF"}

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

@@ -1,5 +1,5 @@
 /**
- * Codex CLI provider adapter.
+ * @packageDocumentation
  *
  * CLEO provider adapter for OpenAI Codex CLI.
  * Default export is the adapter class for dynamic loading by AdapterManager.
@@ -16,6 +16,21 @@ export default CodexAdapter;
  * Factory function for creating adapter instances.
  * Used by AdapterManager's dynamic import fallback.
  *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the codex
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link CodexAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/codex';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
+ *
  * @task T162
  */
 export declare function createAdapter(): CodexAdapter;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAe,YAAY,CAAC;AAE5B;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAE5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAe,YAAY,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAE5C"}

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

@@ -2,7 +2,6 @@
  * Codex CLI Install Provider
  *
  * Handles CLEO installation into Codex CLI environments:
- * - Registers CLEO MCP server in ~/.codex/config.json
  * - Ensures AGENTS.md has CLEO @-references
  *
  * @task T162
@@ -13,8 +12,12 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  * Install provider for Codex CLI.
  *
  * Manages CLEO's integration with Codex CLI by:
- * 1. Registering the CLEO MCP server in ~/.codex/config.json
- * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. Only AGENTS.md is managed; Codex CLI
+ * does not have an MCP or plugin registration mechanism.
  *
  * @task T162
  * @epic T134
@@ -23,7 +26,7 @@ export declare class CodexInstallProvider implements AdapterInstallProvider {
     /**
      * Install CLEO into a Codex CLI environment.
      *
-     * @param options - Installation options including project directory and MCP server path
+     * @param options - Installation options including project directory
      * @returns Result describing what was installed
      * @task T162
      */
@@ -31,7 +34,6 @@ export declare class CodexInstallProvider implements AdapterInstallProvider {
     /**
      * Uninstall CLEO from the Codex CLI environment.
      *
-     * Removes the MCP server registration from ~/.codex/config.json.
      * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
      * @task T162
      */
@@ -39,8 +41,7 @@ export declare class CodexInstallProvider implements AdapterInstallProvider {
     /**
      * Check whether CLEO is installed in the Codex CLI environment.
      *
-     * Checks for MCP server registered in ~/.codex/config.json.
-     * Returns true if the CLEO MCP server entry is found.
+     * Checks for CLEO references in AGENTS.md.
      * @task T162
      */
     isInstalled(): Promise<boolean>;
@@ -53,16 +54,6 @@ export declare class CodexInstallProvider implements AdapterInstallProvider {
      * @task T162
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Register the CLEO MCP server in ~/.codex/config.json.
-     *
-     * Codex CLI stores its MCP server configuration in ~/.codex/config.json
-     * under the mcpServers key.
-     *
-     * @param mcpServerPath - Absolute path to the MCP server entry point
-     * @returns true if registration was performed or updated
-     */
-    private registerMcpServer;
     /**
      * Update AGENTS.md with CLEO @-references.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B9D;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAqB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}

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

@@ -15,18 +15,32 @@ 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
+ * - Install: Manages .cursorrules and .cursor/rules/cleo.mdc rule files
  * - Hooks: Stub provider (Cursor has no lifecycle event system)
  * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
+ *
+ * @remarks
+ * Cursor is a GUI-based editor, so many CLI-oriented capabilities
+ * (spawn, transport, task sync, context monitor) are unsupported.
+ * Integration is primarily through instruction rule files placed in
+ * `.cursor/rules/` (modern MDC format) and `.cursorrules` (legacy).
  */
 export declare class CursorAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
     readonly id = "cursor";
+    /** Human-readable provider name. */
     readonly name = "Cursor";
+    /** Adapter version string. */
     readonly version = "1.0.0";
+    /** Declared capabilities for this provider. */
     capabilities: AdapterCapabilities;
+    /** Hook provider for CAAMP event mapping. */
     hooks: CursorHookProvider;
+    /** Install provider for managing rule files. */
     install: CursorInstallProvider;
+    /** Project directory this adapter was initialized with, or null. */
     private projectDir;
+    /** Whether {@link initialize} has been called. */
     private initialized;
     constructor();
     /**

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

@@ -1 +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,CA2B/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"}
+{"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;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACvD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,YAAY;IACvB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,YAAY;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA2B/B;IAEF,6CAA6C;IAC7C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,gDAAgD;IAChD,OAAO,EAAE,qBAAqB,CAAC;IAE/B,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,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

@@ -38,10 +38,17 @@ import type { AdapterHookProvider } from '@cleocode/contracts';
  * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
  * state without performing filesystem operations.
  *
+ * @remarks
+ * This provider was originally a no-op stub. It now provides full event
+ * mapping for all 10 canonical events supported by Cursor, plus CAAMP
+ * normalizer integration via async accessors. Registration state is
+ * tracked in-memory because Cursor manages hooks through its own config.
+ *
  * @task T165
  * @epic T134
  */
 export declare class CursorHookProvider implements AdapterHookProvider {
+    /** Whether hooks have been registered for the current session. */
     private registered;
     /**
      * Map a Cursor native event name to a CAAMP canonical hook event name.

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAqC/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;OASG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;OASG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAU/D"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAqC/D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;OASG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;OASG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAU/D"}