@cleocode/adapters 2026.3.74 → 2026.3.76

package/dist/providers/claude-code/transport.js

@@ -1,18 +0,0 @@
-/**
- * Transport provider for the Claude Code adapter.
- *
- * Implements AdapterTransportProvider to supply Claude Code's
- * native inter-agent transport mechanism.
- *
- * @task T5240
- */
-export class ClaudeCodeTransportProvider {
-    transportName = 'claude-code';
-    createTransport() {
-        // Returns null — actual transport creation is handled by the signaldock factory
-        // which checks for this adapter's transport capability.
-        // Full wiring will be completed in Phase 5.
-        return null;
-    }
-}
-//# sourceMappingURL=transport.js.map

package/dist/providers/claude-code/transport.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/providers/claude-code/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,OAAO,2BAA2B;IAC7B,aAAa,GAAG,aAAa,CAAC;IAEvC,eAAe;QACb,gFAAgF;QAChF,wDAAwD;QACxD,4CAA4C;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/providers/codex/adapter.js

@@ -1,134 +0,0 @@
-/**
- * Codex CLI Adapter
- *
- * Main CLEOProviderAdapter implementation for OpenAI Codex CLI.
- * Provides hooks and install capabilities for CLEO integration.
- *
- * @task T162
- * @epic T134
- */
-import { exec } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { promisify } from 'node:util';
-import { CodexHookProvider } from './hooks.js';
-import { CodexInstallProvider } from './install.js';
-const execAsync = promisify(exec);
-/**
- * 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: Registers MCP server in ~/.codex/config.json and ensures AGENTS.md references
- *
- * @task T162
- * @epic T134
- */
-export class CodexAdapter {
-    id = 'codex';
-    name = 'Codex';
-    version = '1.0.0';
-    capabilities = {
-        supportsHooks: true,
-        supportedHookEvents: ['SessionStart', 'UserPromptSubmit', 'Stop'],
-        supportsSpawn: false,
-        supportsInstall: true,
-        supportsMcp: true,
-        supportsInstructionFiles: false,
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: false,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    hooks;
-    install;
-    projectDir = null;
-    initialized = false;
-    constructor() {
-        this.hooks = new CodexHookProvider();
-        this.install = new CodexInstallProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * @param projectDir - Root directory of the project
-     * @task T162
-     */
-    async initialize(projectDir) {
-        this.projectDir = projectDir;
-        this.initialized = true;
-    }
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     * @task T162
-     */
-    async dispose() {
-        if (this.hooks.isRegistered()) {
-            await this.hooks.unregisterNativeHooks();
-        }
-        this.initialized = false;
-        this.projectDir = null;
-    }
-    /**
-     * 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
-     */
-    async healthCheck() {
-        const details = {};
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        // Check Codex CLI availability
-        let cliAvailable = false;
-        try {
-            const { stdout } = await execAsync('which codex');
-            cliAvailable = stdout.trim().length > 0;
-            details.cliPath = stdout.trim();
-        }
-        catch {
-            details.cliAvailable = false;
-        }
-        // Check for Codex CLI config directory
-        const codexConfigDir = join(homedir(), '.codex');
-        const configExists = existsSync(codexConfigDir);
-        details.configDirExists = configExists;
-        // Healthy if CLI is available (primary requirement)
-        const healthy = cliAvailable;
-        details.cliAvailable = cliAvailable;
-        return {
-            healthy,
-            provider: this.id,
-            details,
-        };
-    }
-    /**
-     * Check whether the adapter has been initialized.
-     * @task T162
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get the project directory this adapter was initialized with.
-     * @task T162
-     */
-    getProjectDir() {
-        return this.projectDir;
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/dist/providers/codex/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/codex/adapter.ts"],"names":[],"mappings":"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"}

package/dist/providers/codex/hooks.js

@@ -1,155 +0,0 @@
-/**
- * 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 { readdir, readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-/**
- * Mapping from Codex CLI native event names to CAAMP canonical event names.
- */
-const CODEX_EVENT_MAP = {
-    SessionStart: 'SessionStart',
-    PromptSubmit: 'UserPromptSubmit',
-    ResponseComplete: 'Stop',
-};
-/**
- * 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.
- *
- * @task T162
- * @epic T134
- */
-export class CodexHookProvider {
-    registered = false;
-    /**
-     * 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) {
-        return CODEX_EVENT_MAP[providerEvent] ?? 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
-     */
-    async registerNativeHooks(_projectDir) {
-        this.registered = true;
-    }
-    /**
-     * 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
-     */
-    async unregisterNativeHooks() {
-        this.registered = false;
-    }
-    /**
-     * Check whether hooks have been registered via registerNativeHooks.
-     * @task T162
-     */
-    isRegistered() {
-        return this.registered;
-    }
-    /**
-     * Get the full event mapping for introspection/debugging.
-     * @task T162
-     */
-    getEventMap() {
-        return { ...CODEX_EVENT_MAP };
-    }
-    /**
-     * Extract a plain-text transcript from Codex CLI session data.
-     *
-     * Reads the most recent session file under ~/.codex/ and extracts
-     * turn text into 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
-     */
-    async getTranscript(_sessionId, _projectDir) {
-        try {
-            const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? '/root';
-            const codexDir = join(homeDir, '.codex');
-            let allFiles = [];
-            try {
-                const entries = await readdir(codexDir, { withFileTypes: true });
-                for (const entry of entries) {
-                    if (!entry.isFile())
-                        continue;
-                    const name = entry.name;
-                    if (name.endsWith('.json') || name.endsWith('.jsonl')) {
-                        allFiles.push(join(codexDir, name));
-                    }
-                }
-            }
-            catch {
-                return null;
-            }
-            if (allFiles.length === 0)
-                return null;
-            // Sort descending by filename (timestamps in filenames sort naturally)
-            allFiles = allFiles.sort((a, b) => b.localeCompare(a));
-            const mostRecent = allFiles[0];
-            if (!mostRecent)
-                return null;
-            const raw = await readFile(mostRecent, 'utf-8');
-            const turns = [];
-            // Support both JSONL (one JSON per line) and JSON array formats
-            const lines = raw.split('\n').filter((l) => l.trim());
-            for (const line of lines) {
-                try {
-                    const entry = JSON.parse(line);
-                    const role = entry.role;
-                    const content = entry.content;
-                    if (role === 'assistant' && typeof content === 'string') {
-                        turns.push(`assistant: ${content}`);
-                    }
-                    else if (role === 'user' && typeof content === 'string') {
-                        turns.push(`user: ${content}`);
-                    }
-                }
-                catch {
-                    // Skip malformed lines
-                }
-            }
-            return turns.length > 0 ? turns.join('\n') : null;
-        }
-        catch {
-            return null;
-        }
-    }
-}
-//# sourceMappingURL=hooks.js.map

package/dist/providers/codex/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/codex/hooks.ts"],"names":[],"mappings":"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"}

package/dist/providers/codex/index.js

@@ -1,24 +0,0 @@
-/**
- * Codex CLI provider adapter.
- *
- * 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.
- *
- * @task T162
- */
-export function createAdapter() {
-    return new CodexAdapter();
-}
-//# sourceMappingURL=index.js.map

package/dist/providers/codex/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","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,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/dist/providers/codex/install.js

@@ -1,183 +0,0 @@
-/**
- * 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
- * @epic T134
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
-/** MCP server registration key used in Codex CLI config. */
-const MCP_SERVER_KEY = 'cleo';
-/**
- * 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
- *
- * @task T162
- * @epic T134
- */
-export class CodexInstallProvider {
-    /**
-     * Install CLEO into a Codex CLI environment.
-     *
-     * @param options - Installation options including project directory and MCP server path
-     * @returns Result describing what was installed
-     * @task T162
-     */
-    async install(options) {
-        const { projectDir, mcpServerPath } = options;
-        const installedAt = new Date().toISOString();
-        let instructionFileUpdated = false;
-        let mcpRegistered = false;
-        const details = {};
-        // Step 1: Register MCP server in ~/.codex/config.json
-        if (mcpServerPath) {
-            mcpRegistered = this.registerMcpServer(mcpServerPath);
-            if (mcpRegistered) {
-                details.mcpConfigPath = join(homedir(), '.codex', 'config.json');
-            }
-        }
-        // Step 2: Ensure AGENTS.md has @-references
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFile = join(projectDir, 'AGENTS.md');
-        }
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            mcpRegistered,
-            details,
-        };
-    }
-    /**
-     * 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
-     */
-    async uninstall() {
-        const configPath = join(homedir(), '.codex', 'config.json');
-        if (existsSync(configPath)) {
-            try {
-                const raw = readFileSync(configPath, 'utf-8');
-                const config = JSON.parse(raw);
-                const mcpServers = config.mcpServers;
-                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-                    delete mcpServers[MCP_SERVER_KEY];
-                    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-                }
-            }
-            catch {
-                // Ignore errors during uninstall
-            }
-        }
-    }
-    /**
-     * 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.
-     * @task T162
-     */
-    async isInstalled() {
-        const configPath = join(homedir(), '.codex', 'config.json');
-        if (existsSync(configPath)) {
-            try {
-                const config = JSON.parse(readFileSync(configPath, 'utf-8'));
-                const mcpServers = config.mcpServers;
-                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        return false;
-    }
-    /**
-     * 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
-     */
-    async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-    }
-    /**
-     * 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
-     */
-    registerMcpServer(mcpServerPath) {
-        const codexDir = join(homedir(), '.codex');
-        const configPath = join(codexDir, 'config.json');
-        let config = {};
-        mkdirSync(codexDir, { recursive: true });
-        if (existsSync(configPath)) {
-            try {
-                config = JSON.parse(readFileSync(configPath, 'utf-8'));
-            }
-            catch {
-                // Start fresh on parse error
-            }
-        }
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
-        mcpServers[MCP_SERVER_KEY] = {
-            command: 'node',
-            args: [mcpServerPath],
-        };
-        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-        return true;
-    }
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @param projectDir - Project root directory
-     * @returns true if the file was created or modified
-     */
-    updateInstructionFile(projectDir) {
-        const agentsMdPath = join(projectDir, 'AGENTS.md');
-        let content = '';
-        let existed = false;
-        if (existsSync(agentsMdPath)) {
-            content = readFileSync(agentsMdPath, 'utf-8');
-            existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-        if (missingRefs.length === 0) {
-            return false;
-        }
-        const refsBlock = missingRefs.join('\n');
-        if (existed) {
-            const separator = content.endsWith('\n') ? '' : '\n';
-            content = content + separator + refsBlock + '\n';
-        }
-        else {
-            content = refsBlock + '\n';
-        }
-        writeFileSync(agentsMdPath, content, 'utf-8');
-        return true;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/providers/codex/install.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,+DAA+D;AAC/D,MAAM,sBAAsB,GAAG,CAAC,sCAAsC,EAAE,yBAAyB,CAAC,CAAC;AAEnG,4DAA4D;AAC5D,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;QAC9C,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,sBAAsB,GAAG,KAAK,CAAC;QACnC,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,sDAAsD;QACtD,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,sBAAsB,GAAG,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAChE,IAAI,sBAAsB,EAAE,CAAC;YAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,WAAW;YACX,sBAAsB;YACtB,aAAa;YACb,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;gBAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAiD,CAAC;gBAC5E,IAAI,UAAU,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;oBAC/C,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC;oBAClC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAiD,CAAC;gBAC5E,IAAI,UAAU,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;oBAC/C,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,2BAA2B,CAAC,UAAkB;QAClD,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACK,iBAAiB,CAAC,aAAqB;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACjD,IAAI,MAAM,GAA4B,EAAE,CAAC;QAEzC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAqC,CAAC;QAChE,UAAU,CAAC,cAAc,CAAC,GAAG;YAC3B,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,CAAC,aAAa,CAAC;SACtB,CAAC;QAEF,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,qBAAqB,CAAC,UAAkB;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACrD,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/providers/cursor/adapter.js

@@ -1,138 +0,0 @@
-/**
- * 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 { existsSync } from 'node:fs';
-import { join } from 'node:path';
-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 class CursorAdapter {
-    id = 'cursor';
-    name = 'Cursor';
-    version = '1.0.0';
-    capabilities = {
-        supportsHooks: true,
-        // 10/16 canonical events — derived from getProviderHookProfile('cursor') in CAAMP 1.9.1.
-        // PermissionRequest, PreModel, PostModel, PostCompact, Notification, ConfigChange are
-        // not supported by Cursor's hook system.
-        supportedHookEvents: [
-            'SessionStart',
-            'SessionEnd',
-            'PromptSubmit',
-            'ResponseComplete',
-            'PreToolUse',
-            'PostToolUse',
-            'PostToolUseFailure',
-            'SubagentStart',
-            'SubagentStop',
-            'PreCompact',
-        ],
-        supportsSpawn: false,
-        supportsInstall: true,
-        supportsMcp: true,
-        supportsInstructionFiles: true,
-        instructionFilePattern: '.cursor/rules/*.mdc',
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: true,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    hooks;
-    install;
-    projectDir = null;
-    initialized = false;
-    constructor() {
-        this.hooks = new CursorHookProvider();
-        this.install = new CursorInstallProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * @param projectDir - Root directory of the project
-     */
-    async initialize(projectDir) {
-        this.projectDir = projectDir;
-        this.initialized = true;
-    }
-    /**
-     * Dispose the adapter and clean up resources.
-     */
-    async dispose() {
-        if (this.hooks.isRegistered()) {
-            await this.hooks.unregisterNativeHooks();
-        }
-        this.initialized = false;
-        this.projectDir = null;
-    }
-    /**
-     * 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
-     */
-    async healthCheck() {
-        const details = {};
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        // Check for Cursor config directory in the project
-        let configExists = false;
-        if (this.projectDir) {
-            const cursorConfigDir = join(this.projectDir, '.cursor');
-            configExists = existsSync(cursorConfigDir);
-            details.configDirExists = configExists;
-        }
-        // Check for CURSOR_EDITOR env var
-        const editorEnvSet = process.env.CURSOR_EDITOR !== undefined;
-        details.editorEnvSet = editorEnvSet;
-        // Check for legacy .cursorrules file
-        if (this.projectDir) {
-            const legacyRulesExist = existsSync(join(this.projectDir, '.cursorrules'));
-            details.legacyRulesExist = legacyRulesExist;
-        }
-        // Healthy if we detect Cursor presence (config dir or env var)
-        const healthy = configExists || editorEnvSet;
-        details.detected = healthy;
-        return {
-            healthy,
-            provider: this.id,
-            details,
-        };
-    }
-    /**
-     * Check whether the adapter has been initialized.
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get the project directory this adapter was initialized with.
-     */
-    getProjectDir() {
-        return this.projectDir;
-    }
-}
-//# sourceMappingURL=adapter.js.map