@cleocode/adapters 2026.3.66 → 2026.3.67

package/dist/providers/claude-code/task-sync.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/cursor/adapter.js

@@ -0,0 +1,124 @@
+/**
+ * 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: false,
+        supportedHookEvents: [],
+        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

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

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

package/dist/providers/cursor/hooks.js

@@ -0,0 +1,55 @@
+/**
+ * Cursor Hook Provider
+ *
+ * Cursor does not have a native hook/event system for external tools.
+ * This provider returns null for all event mappings and marks hooks
+ * as unsupported. It exists to satisfy the AdapterHookProvider contract
+ * so the adapter can be used uniformly by the AdapterManager.
+ *
+ * @task T5240
+ */
+/**
+ * Hook provider for Cursor (stub).
+ *
+ * Cursor lacks a hook-based lifecycle event system. All mapping
+ * operations return null. Registration is a no-op.
+ */
+export class CursorHookProvider {
+    registered = false;
+    /**
+     * Map a provider event name to a CAAMP hook event name.
+     *
+     * Always returns null since Cursor does not emit hook events.
+     *
+     * @param _providerEvent - Ignored; Cursor has no hook events
+     * @returns null (no mapping available)
+     */
+    mapProviderEvent(_providerEvent) {
+        return null;
+    }
+    /**
+     * Register native hooks for a project.
+     *
+     * No-op for Cursor since it has no hook system.
+     *
+     * @param _projectDir - Ignored
+     */
+    async registerNativeHooks(_projectDir) {
+        this.registered = true;
+    }
+    /**
+     * Unregister native hooks.
+     *
+     * No-op for Cursor since it has no hook system.
+     */
+    async unregisterNativeHooks() {
+        this.registered = false;
+    }
+    /**
+     * Check whether hooks have been registered.
+     */
+    isRegistered() {
+        return this.registered;
+    }
+}
+//# sourceMappingURL=hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/cursor/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACrB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,cAAsB;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/providers/cursor/index.js

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

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

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

package/dist/providers/cursor/install.js

@@ -0,0 +1,238 @@
+/**
+ * Cursor Install Provider
+ *
+ * Handles CLEO installation into Cursor environments:
+ * - Registers CLEO MCP server in .cursor/mcp.json
+ * - Ensures .cursorrules has CLEO @-references (legacy format)
+ * - Creates .cursor/rules/cleo.mdc with CLEO references (modern format)
+ *
+ * Cursor supports two instruction file formats:
+ * 1. Legacy: .cursorrules (flat file, project root)
+ * 2. Modern: .cursor/rules/*.mdc (MDC format, per-rule files)
+ *
+ * This provider writes to both for maximum compatibility.
+ *
+ * @task T5240
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Lines that should appear in instruction files to reference CLEO. */
+const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/** MCP server registration key used in Cursor config. */
+const MCP_SERVER_KEY = 'cleo';
+/**
+ * Install provider for Cursor.
+ *
+ * Manages CLEO's integration with Cursor by:
+ * 1. Registering the CLEO MCP server in .cursor/mcp.json
+ * 2. Creating/updating .cursorrules with @-references (legacy)
+ * 3. Creating .cursor/rules/cleo.mdc with @-references (modern)
+ */
+export class CursorInstallProvider {
+    installedProjectDir = null;
+    /**
+     * Install CLEO into a Cursor project.
+     *
+     * @param options - Installation options including project directory and MCP server path
+     * @returns Result describing what was installed
+     */
+    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 .cursor/mcp.json
+        if (mcpServerPath) {
+            mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
+            if (mcpRegistered) {
+                details.mcpConfigPath = join(projectDir, '.cursor', 'mcp.json');
+            }
+        }
+        // Step 2: Ensure instruction files have @-references
+        instructionFileUpdated = this.updateInstructionFiles(projectDir);
+        if (instructionFileUpdated) {
+            details.instructionFiles = this.getUpdatedFileList(projectDir);
+        }
+        this.installedProjectDir = projectDir;
+        return {
+            success: true,
+            installedAt,
+            instructionFileUpdated,
+            mcpRegistered,
+            details,
+        };
+    }
+    /**
+     * Uninstall CLEO from the current Cursor project.
+     *
+     * Removes the MCP server registration from .cursor/mcp.json.
+     * Does not remove instruction file references (they are harmless if CLEO is not present).
+     */
+    async uninstall() {
+        if (!this.installedProjectDir)
+            return;
+        const mcpPath = join(this.installedProjectDir, '.cursor', 'mcp.json');
+        if (existsSync(mcpPath)) {
+            try {
+                const raw = readFileSync(mcpPath, 'utf-8');
+                const config = JSON.parse(raw);
+                const mcpServers = config.mcpServers;
+                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
+                    delete mcpServers[MCP_SERVER_KEY];
+                    writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+                }
+            }
+            catch {
+                // Ignore errors during uninstall
+            }
+        }
+        this.installedProjectDir = null;
+    }
+    /**
+     * Check whether CLEO is installed in the current environment.
+     *
+     * Checks for MCP server registered in .cursor/mcp.json.
+     */
+    async isInstalled() {
+        const mcpPath = join(process.cwd(), '.cursor', 'mcp.json');
+        if (existsSync(mcpPath)) {
+            try {
+                const config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
+                const mcpServers = config.mcpServers;
+                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
+                    return true;
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        return false;
+    }
+    /**
+     * Ensure instruction files contain @-references to CLEO.
+     *
+     * Updates .cursorrules (legacy) and creates .cursor/rules/cleo.mdc (modern).
+     *
+     * @param projectDir - Project root directory
+     */
+    async ensureInstructionReferences(projectDir) {
+        this.updateInstructionFiles(projectDir);
+    }
+    /**
+     * Register the CLEO MCP server in .cursor/mcp.json.
+     *
+     * Cursor stores MCP server configuration in .cursor/mcp.json
+     * under the mcpServers key.
+     *
+     * @returns true if registration was performed or updated
+     */
+    registerMcpServer(projectDir, mcpServerPath) {
+        const cursorDir = join(projectDir, '.cursor');
+        const mcpPath = join(cursorDir, 'mcp.json');
+        let config = {};
+        mkdirSync(cursorDir, { recursive: true });
+        if (existsSync(mcpPath)) {
+            try {
+                config = JSON.parse(readFileSync(mcpPath, '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(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        return true;
+    }
+    /**
+     * 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
+     */
+    updateInstructionFiles(projectDir) {
+        let updated = false;
+        // Update legacy .cursorrules if it exists
+        if (this.updateLegacyRules(projectDir)) {
+            updated = true;
+        }
+        // Create/update modern .cursor/rules/cleo.mdc
+        if (this.updateModernRules(projectDir)) {
+            updated = true;
+        }
+        return updated;
+    }
+    /**
+     * 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
+     */
+    updateLegacyRules(projectDir) {
+        const rulesPath = join(projectDir, '.cursorrules');
+        if (!existsSync(rulesPath)) {
+            return false;
+        }
+        let content = readFileSync(rulesPath, 'utf-8');
+        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
+        if (missingRefs.length === 0) {
+            return false;
+        }
+        const separator = content.endsWith('\n') ? '' : '\n';
+        content = content + separator + missingRefs.join('\n') + '\n';
+        writeFileSync(rulesPath, content, 'utf-8');
+        return true;
+    }
+    /**
+     * 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
+     */
+    updateModernRules(projectDir) {
+        const rulesDir = join(projectDir, '.cursor', 'rules');
+        const mdcPath = join(rulesDir, 'cleo.mdc');
+        const expectedContent = [
+            '---',
+            'description: CLEO task management protocol references',
+            'globs: "**/*"',
+            'alwaysApply: true',
+            '---',
+            '',
+            ...INSTRUCTION_REFERENCES,
+            '',
+        ].join('\n');
+        if (existsSync(mdcPath)) {
+            const existing = readFileSync(mdcPath, 'utf-8');
+            if (existing === expectedContent) {
+                return false;
+            }
+        }
+        mkdirSync(rulesDir, { recursive: true });
+        writeFileSync(mdcPath, expectedContent, 'utf-8');
+        return true;
+    }
+    /**
+     * Get list of instruction files that were updated.
+     */
+    getUpdatedFileList(projectDir) {
+        const files = [];
+        if (existsSync(join(projectDir, '.cursorrules'))) {
+            files.push(join(projectDir, '.cursorrules'));
+        }
+        files.push(join(projectDir, '.cursor', 'rules', 'cleo.mdc'));
+        return files;
+    }
+}
+//# sourceMappingURL=install.js.map

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

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

package/dist/providers/cursor/spawn.js

@@ -0,0 +1,59 @@
+/**
+ * Cursor Spawn Provider
+ *
+ * Cursor is a GUI-based AI code editor and does not support
+ * CLI-based subagent spawning. This provider implements
+ * the AdapterSpawnProvider interface with appropriate rejections.
+ *
+ * @task T5240
+ */
+/**
+ * Spawn provider for Cursor.
+ *
+ * Cursor does not support subagent spawning via CLI. The adapter
+ * declares supportsSpawn: false in its capabilities. All methods
+ * either reject or return empty results.
+ */
+export class CursorSpawnProvider {
+    /**
+     * Check if Cursor supports spawning subagents.
+     *
+     * @returns false (Cursor does not support CLI spawning)
+     */
+    async canSpawn() {
+        return false;
+    }
+    /**
+     * Attempt to spawn a subagent via Cursor.
+     *
+     * Always throws because Cursor does not support subagent spawning.
+     * Callers should check canSpawn() before calling this method.
+     *
+     * @param _context - Unused; spawning is not supported
+     * @throws Error explaining that Cursor does not support subagent spawning
+     */
+    async spawn(_context) {
+        throw new Error('Cursor does not support subagent spawning. ' +
+            'Cursor is a GUI-based editor without CLI subagent capabilities. ' +
+            'Use a provider that supports spawning (e.g., Claude Code or OpenCode).');
+    }
+    /**
+     * List running Cursor subagent processes.
+     *
+     * @returns Empty array (no processes can be spawned)
+     */
+    async listRunning() {
+        return [];
+    }
+    /**
+     * Terminate a Cursor subagent process.
+     *
+     * No-op because Cursor cannot spawn processes.
+     *
+     * @param _instanceId - Unused; no processes to terminate
+     */
+    async terminate(_instanceId) {
+        // No-op: Cursor does not spawn processes.
+    }
+}
+//# sourceMappingURL=spawn.js.map

package/dist/providers/cursor/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/providers/cursor/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;OAIG;IACH,KAAK,CAAC,QAAQ;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CAAC,QAAsB;QAChC,MAAM,IAAI,KAAK,CACb,6CAA6C;YAC3C,kEAAkE;YAClE,wEAAwE,CAC3E,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,WAAmB;QACjC,0CAA0C;IAC5C,CAAC;CACF"}