@cleocode/adapters 2026.4.11 → 2026.4.13

package/dist/providers/cursor/hooks.js

@@ -1,208 +0,0 @@
-/**
- * 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
- */
-/** CAAMP provider identifier for Cursor. */
-const PROVIDER_ID = 'cursor';
-/**
- * Fallback map from Cursor native event names to CAAMP canonical names.
- *
- * Derived from `getProviderHookProfile('cursor').mappings` in CAAMP 1.9.1.
- * Covers all 10 supported events. PermissionRequest, PreModel, PostModel,
- * PostCompact, Notification, and ConfigChange are not supported by Cursor.
- *
- * Cursor uses camelCase names while CAAMP canonical names are PascalCase.
- */
-const CURSOR_EVENT_MAP = {
-    // CAAMP: toNative('SessionStart',       'cursor') = 'sessionStart'
-    sessionStart: 'SessionStart',
-    // CAAMP: toNative('SessionEnd',         'cursor') = 'sessionEnd'
-    sessionEnd: 'SessionEnd',
-    // CAAMP: toNative('PromptSubmit',       'cursor') = 'beforeSubmitPrompt'
-    beforeSubmitPrompt: 'PromptSubmit',
-    // CAAMP: toNative('ResponseComplete',   'cursor') = 'stop'
-    stop: 'ResponseComplete',
-    // CAAMP: toNative('PreToolUse',         'cursor') = 'preToolUse'
-    preToolUse: 'PreToolUse',
-    // CAAMP: toNative('PostToolUse',        'cursor') = 'postToolUse'
-    postToolUse: 'PostToolUse',
-    // CAAMP: toNative('PostToolUseFailure', 'cursor') = 'postToolUseFailure'
-    postToolUseFailure: 'PostToolUseFailure',
-    // CAAMP: toNative('SubagentStart',      'cursor') = 'subagentStart'
-    subagentStart: 'SubagentStart',
-    // CAAMP: toNative('SubagentStop',       'cursor') = 'subagentStop'
-    subagentStop: 'SubagentStop',
-    // CAAMP: toNative('PreCompact',         'cursor') = 'preCompact'
-    preCompact: 'PreCompact',
-};
-/**
- * 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 class CursorHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    registered = false;
-    /**
-     * 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) {
-        return CURSOR_EVENT_MAP[providerEvent] ?? 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
-     */
-    async registerNativeHooks(_projectDir) {
-        this.registered = true;
-    }
-    /**
-     * 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
-     */
-    async unregisterNativeHooks() {
-        this.registered = false;
-    }
-    /**
-     * Check whether hooks have been registered via `registerNativeHooks`.
-     */
-    isRegistered() {
-        return this.registered;
-    }
-    /**
-     * 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() {
-        return { ...CURSOR_EVENT_MAP };
-    }
-    /**
-     * 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
-     */
-    async getSupportedCanonicalEvents() {
-        try {
-            const { getSupportedEvents } = await import('@cleocode/caamp');
-            return getSupportedEvents(PROVIDER_ID);
-        }
-        catch {
-            return [...new Set(Object.values(CURSOR_EVENT_MAP))];
-        }
-    }
-    /**
-     * 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
-     */
-    async getProviderProfile() {
-        try {
-            const { getProviderHookProfile } = await import('@cleocode/caamp');
-            return getProviderHookProfile(PROVIDER_ID) ?? null;
-        }
-        catch {
-            return 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
-     */
-    async toNativeEvent(canonical) {
-        try {
-            const { toNative } = await import('@cleocode/caamp');
-            return toNative(canonical, PROVIDER_ID);
-        }
-        catch {
-            // Invert the static map as fallback
-            const entry = Object.entries(CURSOR_EVENT_MAP).find(([, v]) => v === canonical);
-            return entry?.[0] ?? null;
-        }
-    }
-}
-//# sourceMappingURL=hooks.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/cursor/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,4CAA4C;AAC5C,MAAM,WAAW,GAAG,QAAiB,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,gBAAgB,GAA2B;IAC/C,mEAAmE;IACnE,YAAY,EAAE,cAAc;IAC5B,iEAAiE;IACjE,UAAU,EAAE,YAAY;IACxB,yEAAyE;IACzE,kBAAkB,EAAE,cAAc;IAClC,2DAA2D;IAC3D,IAAI,EAAE,kBAAkB;IACxB,iEAAiE;IACjE,UAAU,EAAE,YAAY;IACxB,kEAAkE;IAClE,WAAW,EAAE,aAAa;IAC1B,yEAAyE;IACzE,kBAAkB,EAAE,oBAAoB;IACxC,oEAAoE;IACpE,aAAa,EAAE,eAAe;IAC9B,mEAAmE;IACnE,YAAY,EAAE,cAAc;IAC5B,iEAAiE;IACjE,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,kBAAkB;IAC7B,kEAAkE;IAC1D,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,gBAAgB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;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;IAED;;;;;;;;OAQG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,2BAA2B;QAC/B,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC/D,OAAO,kBAAkB,CAAC,WAAW,CAAa,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACnE,OAAO,sBAAsB,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACrD,OAAO,QAAQ,CAAC,SAA2C,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;YACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;YAChF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

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

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

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

@@ -1,36 +0,0 @@
-/**
- * @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 function createAdapter() {
-    return new CursorAdapter();
-}
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}

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

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

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

package/dist/providers/cursor/install.js

@@ -1,181 +0,0 @@
-/**
- * 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 { 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'];
-/**
- * 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 class CursorInstallProvider {
-    /**
-     * Install CLEO into a Cursor project.
-     *
-     * @param options - Installation options including project directory
-     * @returns Result describing what was installed
-     */
-    async install(options) {
-        const { projectDir } = options;
-        const installedAt = new Date().toISOString();
-        let instructionFileUpdated = false;
-        const details = {};
-        // Step 1: Ensure instruction files have @-references
-        instructionFileUpdated = this.updateInstructionFiles(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFiles = this.getUpdatedFileList(projectDir);
-        }
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            mcpRegistered: false,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the current Cursor project.
-     *
-     * Does not remove instruction file references (they are harmless if CLEO is not present).
-     */
-    async uninstall() { }
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for .cursor/rules/cleo.mdc or .cursorrules with CLEO references.
-     */
-    async isInstalled() {
-        const mdcPath = join(process.cwd(), '.cursor', 'rules', 'cleo.mdc');
-        if (existsSync(mdcPath)) {
-            return true;
-        }
-        const rulesPath = join(process.cwd(), '.cursorrules');
-        if (existsSync(rulesPath)) {
-            try {
-                const content = readFileSync(rulesPath, 'utf-8');
-                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-                    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);
-    }
-    /**
-     * 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

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

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

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

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

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