@cleocode/adapters 2026.4.13 → 2026.4.15

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

@@ -0,0 +1,83 @@
+/**
+ * Codex CLI Adapter
+ *
+ * Main CLEOProviderAdapter implementation for OpenAI Codex CLI.
+ * Provides hooks and install capabilities for CLEO integration.
+ *
+ * @task T162
+ * @epic T134
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { CodexHookProvider } from './hooks.js';
+import { CodexInstallProvider } from './install.js';
+/**
+ * CLEO provider adapter for OpenAI Codex CLI.
+ *
+ * Bridges CLEO's adapter system with Codex CLI's native capabilities:
+ * - Hooks: Maps Codex events (SessionStart, PromptSubmit, ResponseComplete) to CAAMP events
+ * - 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();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     * @task T162
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     * @task T162
+     */
+    dispose(): Promise<void>;
+    /**
+     * Run a health check to verify Codex CLI is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Codex CLI binary is available in PATH
+     * 3. ~/.codex/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     * @task T162
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     * @task T162
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     * @task T162
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;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,CAW/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

@@ -0,0 +1,91 @@
+/**
+ * Codex CLI Hook Provider
+ *
+ * Maps Codex CLI's native hook events to CAAMP canonical hook events.
+ * Codex CLI supports 3 canonical events through its hook system.
+ *
+ * Codex CLI event mapping:
+ * - SessionStart      -> SessionStart
+ * - PromptSubmit      -> UserPromptSubmit
+ * - ResponseComplete  -> Stop
+ *
+ * @task T162
+ * @epic T134
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Codex CLI.
+ *
+ * Codex CLI registers hooks via its configuration system at
+ * ~/.codex/. Hook handlers are 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.
+ *
+ * @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.
+     *
+     * @param providerEvent - Codex CLI event name (e.g. "SessionStart", "PromptSubmit")
+     * @returns CAAMP event name or null if unmapped
+     * @task T162
+     */
+    mapProviderEvent(providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * For Codex CLI, hooks are registered via the config system
+     * (~/.codex/), which is handled by the install provider.
+     * This method marks hooks as registered without performing
+     * filesystem operations.
+     *
+     * @param _projectDir - Project directory (unused; hooks are global)
+     * @task T162
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * For Codex CLI, this is a no-op since hooks are managed through
+     * the config system. Unregistration happens via the install
+     * provider's uninstall method.
+     * @task T162
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     * @task T162
+     */
+    isRegistered(): boolean;
+    /**
+     * Get the full event mapping for introspection/debugging.
+     * @task T162
+     */
+    getEventMap(): Readonly<Record<string, string>>;
+    /**
+     * Extract a plain-text transcript from Codex CLI session data.
+     *
+     * Reads the most recent JSON/JSONL session file under `~/.codex/`
+     * and returns its turns as a flat string for brain observation extraction.
+     *
+     * Returns null when no session data is found or on any read error.
+     *
+     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
+     * @param _projectDir - Project directory (unused; Codex CLI uses global paths)
+     * @task T162 @epic T134
+     */
+    getTranscript(_sessionId: string, _projectDir: string): Promise<string | null>;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,37 @@
+/**
+ * @packageDocumentation
+ *
+ * CLEO provider adapter for OpenAI Codex CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T162
+ * @epic T134
+ */
+import { CodexAdapter } from './adapter.js';
+export { CodexAdapter } from './adapter.js';
+export { CodexHookProvider } from './hooks.js';
+export { CodexInstallProvider } from './install.js';
+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;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAE5C"}

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

@@ -0,0 +1,65 @@
+/**
+ * Codex CLI Install Provider
+ *
+ * Handles CLEO installation into Codex CLI environments:
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T162
+ * @epic T134
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * Install provider for Codex CLI.
+ *
+ * Manages CLEO's integration with Codex CLI by:
+ * 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
+ */
+export declare class CodexInstallProvider implements AdapterInstallProvider {
+    /**
+     * Install CLEO into a Codex CLI environment.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     * @task T162
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * Uninstall CLEO from the Codex CLI environment.
+     *
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * @task T162
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the Codex CLI environment.
+     *
+     * Checks for CLEO references in AGENTS.md.
+     * @task T162
+     */
+    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
+     * @task T162
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @param projectDir - Project root directory
+     * @returns true if the file was created or modified
+     */
+    private updateInstructionFile;
+}
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"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;IAoB9D;;;;;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

@@ -0,0 +1,76 @@
+/**
+ * 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: 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();
+    /**
+     * 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;;;;;;;;;;;;;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,CA0B/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

@@ -0,0 +1,140 @@
+/**
+ * Cursor Hook Provider
+ *
+ * Maps Cursor's native hook events to CAAMP canonical hook events.
+ * Cursor supports 10 of 16 canonical events through its config-based hook system.
+ *
+ * Event translation uses CAAMP normalizer APIs:
+ * - `toCanonical(nativeName, 'cursor')` for runtime event name resolution
+ * - `getSupportedEvents('cursor')` to enumerate supported canonical events
+ * - `getProviderHookProfile('cursor')` for the full provider profile
+ *
+ * Cursor uses camelCase native event names (e.g. `sessionStart`, `preToolUse`).
+ * Hooks are configured via `.cursor/hooks.json`. Supported handler types:
+ * command, prompt.
+ *
+ * Unsupported events: PermissionRequest, PreModel, PostModel, PostCompact,
+ * Notification, ConfigChange.
+ *
+ * @task T165
+ * @epic T134
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Cursor.
+ *
+ * Cursor registers hooks via its config system at `.cursor/hooks.json`.
+ * Supported handler types: command, prompt.
+ *
+ * CAAMP 1.9.1 reveals Cursor supports 10 of 16 canonical events. Previously
+ * this provider was a no-op stub. It now provides full event mapping and CAAMP
+ * normalizer integration.
+ *
+ * Event mapping is based on `getProviderHookProfile('cursor')` from CAAMP 1.9.1.
+ * Async accessors (`getSupportedCanonicalEvents`, `getProviderProfile`) call
+ * CAAMP directly when available.
+ *
+ * Since hooks are registered through the config system (managed by the install
+ * 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.
+     *
+     * Looks up the native event name in the map derived from
+     * `getProviderHookProfile('cursor').mappings` (CAAMP 1.9.1). Cursor uses
+     * camelCase names (e.g. "preToolUse", "sessionStart").
+     *
+     * Returns null for unsupported events (PermissionRequest, PreModel,
+     * PostModel, PostCompact, Notification, ConfigChange).
+     *
+     * @param providerEvent - Cursor native event name (e.g. "preToolUse", "sessionStart")
+     * @returns CAAMP canonical event name, or null if unmapped
+     * @task T165
+     */
+    mapProviderEvent(providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * For Cursor, hooks are registered via the config system
+     * (`.cursor/hooks.json`), managed by the install provider.
+     * This method marks hooks as registered without performing filesystem operations.
+     *
+     * Iterating supported events is handled at install time using
+     * `getSupportedCanonicalEvents()` to enumerate all 10 supported hooks.
+     *
+     * @param _projectDir - Project directory (unused; Cursor config manages registration)
+     * @task T165
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * For Cursor, this is a no-op since hooks are managed through the config
+     * system. Unregistration happens via the install provider's uninstall method.
+     *
+     * @task T165
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered via `registerNativeHooks`.
+     */
+    isRegistered(): boolean;
+    /**
+     * Get the native→canonical event mapping for introspection and debugging.
+     *
+     * Returns the map derived from `getProviderHookProfile('cursor').mappings`
+     * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
+     * names via live CAAMP APIs.
+     *
+     * @returns Immutable record of native event name → canonical event name
+     */
+    getEventMap(): Readonly<Record<string, string>>;
+    /**
+     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
+     *
+     * Calls `getSupportedEvents('cursor')` from the CAAMP normalizer to get the
+     * authoritative list. Cursor supports 10 of 16 canonical events. Falls back
+     * to the values of the static event map when CAAMP is unavailable at runtime.
+     *
+     * @returns Array of CAAMP canonical event names supported by Cursor
+     * @task T165
+     */
+    getSupportedCanonicalEvents(): Promise<string[]>;
+    /**
+     * Retrieve the full provider hook profile from CAAMP.
+     *
+     * Calls `getProviderHookProfile('cursor')` from the CAAMP normalizer to
+     * get the complete profile: hook system type (`config`), config path
+     * (`.cursor/hooks.json`), handler types (command, prompt), and all event
+     * mappings. Returns null when CAAMP is unavailable at runtime.
+     *
+     * @returns Provider hook profile or null if CAAMP is unavailable
+     * @task T165
+     */
+    getProviderProfile(): Promise<unknown | null>;
+    /**
+     * Translate a CAAMP canonical event to its Cursor native name via CAAMP.
+     *
+     * Calls `toNative(canonical, 'cursor')` from the CAAMP normalizer.
+     * Returns null for unsupported events or when CAAMP is unavailable.
+     *
+     * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
+     * @returns Cursor native event name (e.g. "preToolUse") or null
+     * @task T165
+     */
+    toNativeEvent(canonical: string): Promise<string | null>;
+}
+//# 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;;;;;;;;;;;;;;;;;;;;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"}

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

@@ -0,0 +1,34 @@
+/**
+ * @packageDocumentation
+ *
+ * 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.
+ *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the cursor
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link CursorAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/cursor';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
+ */
+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;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAE7C"}

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

@@ -0,0 +1,87 @@
+/**
+ * Cursor Install Provider
+ *
+ * Handles CLEO installation into Cursor environments:
+ * - 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. Creating/updating .cursorrules with @-references (legacy)
+ * 2. Creating .cursor/rules/cleo.mdc with @-references (modern)
+ *
+ * @remarks
+ * Installation is idempotent and writes to both instruction file formats
+ * for maximum compatibility. The legacy `.cursorrules` file is only modified
+ * if it already exists (never created from scratch). The modern MDC file
+ * is always created or updated to ensure Cursor's rule engine picks it up.
+ */
+export declare class CursorInstallProvider implements AdapterInstallProvider {
+    /**
+     * Install CLEO into a Cursor project.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * Uninstall CLEO from the current Cursor project.
+     *
+     * 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 .cursor/rules/cleo.mdc or .cursorrules with CLEO references.
+     */
+    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>;
+    /**
+     * 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;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}