@cleocode/adapters 2026.4.11 → 2026.4.13

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

@@ -1,41 +0,0 @@
-/**
- * Claude Code path provider.
- *
- * Implements AdapterPathProvider with Claude Code-specific directory locations.
- *
- * @task T5240
- */
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-/**
- * Path provider for Anthropic Claude Code CLI.
- *
- * Resolves Claude Code's standard directory layout:
- * - Config dir: ~/.claude (or CLAUDE_HOME)
- * - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS)
- * - Agents: ~/.claude/agents
- * - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
- *
- * @remarks
- * All paths respect environment variable overrides for CI and non-standard
- * installations. When env vars are unset, the canonical default paths are used.
- */
-export class ClaudeCodePathProvider {
-    /** Get the provider's root configuration directory. */
-    getProviderDir() {
-        return process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude');
-    }
-    /** Get the path to the provider's settings file, or null if unavailable. */
-    getSettingsPath() {
-        return process.env['CLAUDE_SETTINGS'] ?? join(this.getProviderDir(), 'settings.json');
-    }
-    /** Get the directory where agents are installed, or null if unsupported. */
-    getAgentInstallDir() {
-        return join(this.getProviderDir(), 'agents');
-    }
-    /** Get the path to the provider's memory database, or null if unsupported. */
-    getMemoryDbPath() {
-        return process.env['CLAUDE_MEM_DB'] ?? join(homedir(), '.claude-mem', 'claude-mem.db');
-    }
-}
-//# sourceMappingURL=paths.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/providers/claude-code/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAsB;IACjC,uDAAuD;IACvD,cAAc;QACZ,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,4EAA4E;IAC5E,eAAe;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC;IACxF,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,8EAA8E;IAC9E,eAAe;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IACzF,CAAC;CACF"}

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

@@ -1,67 +0,0 @@
-/**
- * Claude Code Spawn Provider
- *
- * Implements AdapterSpawnProvider for Claude Code CLI.
- * Migrated from src/core/spawn/adapters/claude-code-adapter.ts
- *
- * Uses the native `claude` CLI to spawn subagent processes with prompts
- * written to temporary files. Processes run detached and are tracked
- * by PID for listing and termination.
- *
- * @task T5240
- */
-import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
-/**
- * Spawn provider for Claude Code.
- *
- * Spawns detached Claude CLI processes for subagent execution.
- * Each spawn writes its prompt to a temporary file, then runs
- * `claude --allow-insecure --no-upgrade-check <tmpFile>` as a
- * detached, unref'd child process.
- *
- * @remarks
- * The provider uses `--allow-insecure --no-upgrade-check` flags to
- * ensure the Claude CLI starts without interactive prompts. Prompts are
- * written to temporary files under `/tmp/` and cleaned up after the
- * child process exits. Processes are tracked by instance ID in an
- * in-memory map and verified via `kill(pid, 0)` liveness checks.
- */
-export declare class ClaudeCodeSpawnProvider implements AdapterSpawnProvider {
-    /** Map of instance IDs to tracked process info. */
-    private processMap;
-    /**
-     * Check if the Claude CLI is available in PATH.
-     *
-     * @returns true if `claude` is found via `which`
-     */
-    canSpawn(): Promise<boolean>;
-    /**
-     * Spawn a subagent via Claude CLI.
-     *
-     * Writes the prompt to a temporary file and spawns a detached Claude
-     * process. The process runs independently of the parent.
-     *
-     * @param context - Spawn context with taskId, prompt, and options
-     * @returns Spawn result with instance ID and status
-     */
-    spawn(context: SpawnContext): Promise<SpawnResult>;
-    /**
-     * List currently running Claude subagent processes.
-     *
-     * Checks each tracked process via kill(pid, 0) to verify it is still alive.
-     * Dead processes are automatically cleaned from the tracking map.
-     *
-     * @returns Array of spawn results for running processes
-     */
-    listRunning(): Promise<SpawnResult[]>;
-    /**
-     * Terminate a running spawn by instance ID.
-     *
-     * Sends SIGTERM to the tracked process. If the process is not found
-     * or has already exited, this is a no-op.
-     *
-     * @param instanceId - ID of the spawn instance to terminate
-     */
-    terminate(instanceId: string): Promise<void>;
-}
-//# sourceMappingURL=spawn.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAY3F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAuExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}

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

@@ -1,171 +0,0 @@
-/**
- * Claude Code Spawn Provider
- *
- * Implements AdapterSpawnProvider for Claude Code CLI.
- * Migrated from src/core/spawn/adapters/claude-code-adapter.ts
- *
- * Uses the native `claude` CLI to spawn subagent processes with prompts
- * written to temporary files. Processes run detached and are tracked
- * by PID for listing and termination.
- *
- * @task T5240
- */
-import { exec, spawn as nodeSpawn } from 'node:child_process';
-import { unlink, writeFile } from 'node:fs/promises';
-import { promisify } from 'node:util';
-import { getErrorMessage } from '@cleocode/contracts';
-const execAsync = promisify(exec);
-/**
- * Spawn provider for Claude Code.
- *
- * Spawns detached Claude CLI processes for subagent execution.
- * Each spawn writes its prompt to a temporary file, then runs
- * `claude --allow-insecure --no-upgrade-check <tmpFile>` as a
- * detached, unref'd child process.
- *
- * @remarks
- * The provider uses `--allow-insecure --no-upgrade-check` flags to
- * ensure the Claude CLI starts without interactive prompts. Prompts are
- * written to temporary files under `/tmp/` and cleaned up after the
- * child process exits. Processes are tracked by instance ID in an
- * in-memory map and verified via `kill(pid, 0)` liveness checks.
- */
-export class ClaudeCodeSpawnProvider {
-    /** Map of instance IDs to tracked process info. */
-    processMap = new Map();
-    /**
-     * Check if the Claude CLI is available in PATH.
-     *
-     * @returns true if `claude` is found via `which`
-     */
-    async canSpawn() {
-        try {
-            await execAsync('which claude');
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Spawn a subagent via Claude CLI.
-     *
-     * Writes the prompt to a temporary file and spawns a detached Claude
-     * process. The process runs independently of the parent.
-     *
-     * @param context - Spawn context with taskId, prompt, and options
-     * @returns Spawn result with instance ID and status
-     */
-    async spawn(context) {
-        const instanceId = `claude-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-        const startTime = new Date().toISOString();
-        let tmpFile;
-        try {
-            tmpFile = `/tmp/claude-spawn-${instanceId}.txt`;
-            await writeFile(tmpFile, context.prompt, 'utf-8');
-            const args = ['--allow-insecure', '--no-upgrade-check', tmpFile];
-            const spawnOpts = {
-                detached: true,
-                stdio: 'ignore',
-            };
-            if (context.workingDirectory) {
-                spawnOpts.cwd = context.workingDirectory;
-            }
-            const child = nodeSpawn('claude', args, spawnOpts);
-            child.unref();
-            if (child.pid) {
-                this.processMap.set(instanceId, {
-                    pid: child.pid,
-                    taskId: context.taskId,
-                    startTime,
-                });
-            }
-            const capturedTmpFile = tmpFile;
-            child.on('exit', async () => {
-                this.processMap.delete(instanceId);
-                try {
-                    await unlink(capturedTmpFile);
-                }
-                catch {
-                    // Ignore cleanup errors
-                }
-            });
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'claude-code',
-                status: 'running',
-                startTime,
-            };
-        }
-        catch (error) {
-            // Log spawn failure for debugging
-            console.error(`[ClaudeCodeSpawnProvider] Failed to spawn: ${getErrorMessage(error)}`);
-            if (tmpFile) {
-                try {
-                    await unlink(tmpFile);
-                }
-                catch {
-                    // Ignore cleanup errors
-                }
-            }
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'claude-code',
-                status: 'failed',
-                startTime,
-                endTime: new Date().toISOString(),
-                error: getErrorMessage(error),
-            };
-        }
-    }
-    /**
-     * List currently running Claude subagent processes.
-     *
-     * Checks each tracked process via kill(pid, 0) to verify it is still alive.
-     * Dead processes are automatically cleaned from the tracking map.
-     *
-     * @returns Array of spawn results for running processes
-     */
-    async listRunning() {
-        const running = [];
-        for (const [instanceId, tracked] of this.processMap.entries()) {
-            try {
-                process.kill(tracked.pid, 0);
-                running.push({
-                    instanceId,
-                    taskId: tracked.taskId,
-                    providerId: 'claude-code',
-                    status: 'running',
-                    startTime: tracked.startTime,
-                });
-            }
-            catch {
-                this.processMap.delete(instanceId);
-            }
-        }
-        return running;
-    }
-    /**
-     * Terminate a running spawn by instance ID.
-     *
-     * Sends SIGTERM to the tracked process. If the process is not found
-     * or has already exited, this is a no-op.
-     *
-     * @param instanceId - ID of the spawn instance to terminate
-     */
-    async terminate(instanceId) {
-        const tracked = this.processMap.get(instanceId);
-        if (!tracked)
-            return;
-        try {
-            process.kill(tracked.pid, 'SIGTERM');
-        }
-        catch {
-            // Process may have already exited
-        }
-        this.processMap.delete(instanceId);
-    }
-}
-//# sourceMappingURL=spawn.js.map

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/statusline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,KAAK,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAa3F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAwC7D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO7E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW7D"}

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

@@ -1,130 +0,0 @@
-/**
- * Statusline integration for the Claude Code adapter.
- *
- * Implements the statusline portion of AdapterContextMonitorProvider.
- * Checks and configures Claude Code status line for context monitoring.
- *
- * @task T5240
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-/**
- * Get the path to Claude Code's settings.json.
- * Respects CLAUDE_SETTINGS env var, defaults to ~/.claude/settings.json.
- */
-function getClaudeSettingsPath() {
-    return (process.env['CLAUDE_SETTINGS'] ??
-        join(process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude'), 'settings.json'));
-}
-/**
- * Check if statusline integration is configured.
- * Returns the current integration status.
- *
- * @remarks
- * Reads Claude Code's settings.json and inspects the `statusLine` field
- * to determine whether CLEO context monitoring is active.
- *
- * @returns One of: 'configured', 'not_configured', 'custom_no_cleo', 'no_settings'
- *
- * @example
- * ```typescript
- * import { checkStatuslineIntegration } from './statusline.js';
- *
- * const status = checkStatuslineIntegration();
- * if (status === 'not_configured') {
- *   console.log('Run cleo install to set up context monitoring');
- * }
- * ```
- */
-export function checkStatuslineIntegration() {
-    const settingsPath = getClaudeSettingsPath();
-    if (!existsSync(settingsPath))
-        return 'no_settings';
-    try {
-        const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-        const statusLine = settings.statusLine;
-        if (!statusLine?.type)
-            return 'not_configured';
-        if (statusLine.type !== 'command')
-            return 'custom_no_cleo';
-        const cmd = statusLine.command ?? '';
-        // Check if it's a CLEO statusline integration
-        if (cmd.includes('context-monitor.sh') ||
-            cmd.includes('cleo-statusline') ||
-            cmd.includes('.context-state.json') ||
-            cmd.includes('context-states')) {
-            return 'configured';
-        }
-        // Check if the script writes to CLEO state file
-        const scriptPath = cmd.startsWith('~') ? cmd.replace('~', homedir()) : cmd;
-        if (existsSync(scriptPath)) {
-            try {
-                const content = readFileSync(scriptPath, 'utf-8');
-                if (content.includes('context-state.json'))
-                    return 'configured';
-            }
-            catch {
-                /* unreadable */
-            }
-        }
-        return 'custom_no_cleo';
-    }
-    catch {
-        return 'no_settings';
-    }
-}
-/**
- * Get the statusline setup command for Claude Code settings.
- *
- * @remarks
- * Returns a JSON-serializable object that can be merged into
- * Claude Code's settings.json to enable context monitoring.
- *
- * @param cleoHome - Absolute path to the CLEO home directory
- * @returns Settings object containing the statusLine configuration
- *
- * @example
- * ```typescript
- * import { getStatuslineConfig } from './statusline.js';
- *
- * const config = getStatuslineConfig('/home/user/.cleo');
- * ```
- */
-export function getStatuslineConfig(cleoHome) {
-    return {
-        statusLine: {
-            type: 'command',
-            command: join(cleoHome, 'lib', 'session', 'context-monitor.sh'),
-        },
-    };
-}
-/**
- * Get human-readable setup instructions.
- *
- * @remarks
- * Returns a multi-line string with file path, JSON config, and explanation
- * suitable for display to the user.
- *
- * @param cleoHome - Absolute path to the CLEO home directory
- * @returns Formatted setup instructions string
- *
- * @example
- * ```typescript
- * import { getSetupInstructions } from './statusline.js';
- *
- * console.log(getSetupInstructions('/home/user/.cleo'));
- * ```
- */
-export function getSetupInstructions(cleoHome) {
-    const settingsPath = getClaudeSettingsPath();
-    return [
-        'To enable context monitoring, add to your Claude Code settings:',
-        `File: ${settingsPath}`,
-        '',
-        JSON.stringify(getStatuslineConfig(cleoHome), null, 2),
-        '',
-        'This enables real-time context window tracking in the CLI.',
-    ].join('\n');
-}
-//# sourceMappingURL=statusline.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"statusline.js","sourceRoot":"","sources":["../../../src/providers/claude-code/statusline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,eAAe,CAAC,CAChF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,aAAa,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QAEvC,IAAI,CAAC,UAAU,EAAE,IAAI;YAAE,OAAO,gBAAgB,CAAC;QAC/C,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,gBAAgB,CAAC;QAE3D,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;QAErC,8CAA8C;QAC9C,IACE,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAClC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC/B,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACnC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAC9B,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAE3E,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAClD,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;oBAAE,OAAO,YAAY,CAAC;YAClE,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,CAAC;SAChE;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,OAAO;QACL,iEAAiE;QACjE,SAAS,YAAY,EAAE;QACvB,EAAE;QACF,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE;QACF,4DAA4D;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

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

@@ -1,32 +0,0 @@
-/**
- * Claude Code TaskSyncProvider — bridges Claude's TodoWrite format
- * to the provider-agnostic reconciliation system.
- *
- * All Claude Code / TodoWrite-specific parsing lives here.
- * The core reconciliation engine never sees TodoWrite formats.
- */
-import type { ExternalTask, ExternalTaskProvider } from '@cleocode/contracts';
-/**
- * Claude Code TaskSyncProvider.
- *
- * Reads Claude's TodoWrite JSON state, parses [T001]-prefixed task IDs
- * and status, and returns normalized ExternalTask[].
- *
- * Optional: accepts a custom file path for testing.
- *
- * @remarks
- * TodoWrite items with `[T001]`-style prefixes are mapped to their CLEO
- * task IDs. Items without a prefix receive a synthetic `tw-new-N` ID
- * for reconciliation. The provider reads from
- * `.cleo/sync/todowrite-state.json` by default.
- */
-export declare class ClaudeCodeTaskSyncProvider implements ExternalTaskProvider {
-    /** Optional override path for the TodoWrite state file (used in tests). */
-    private readonly customFilePath?;
-    constructor(options?: {
-        filePath?: string;
-    });
-    /** Retrieve external tasks from Claude's TodoWrite state file. */
-    getExternalTasks(projectDir: string): Promise<ExternalTask[]>;
-}
-//# sourceMappingURL=task-sync.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"task-sync.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/task-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAsB,MAAM,qBAAqB,CAAC;AAkElG;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA2B,YAAW,oBAAoB;IACrE,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;gBAE7B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAI3C,kEAAkE;IAC5D,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAgDpE"}

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

@@ -1,119 +0,0 @@
-/**
- * Claude Code TaskSyncProvider — bridges Claude's TodoWrite format
- * to the provider-agnostic reconciliation system.
- *
- * All Claude Code / TodoWrite-specific parsing lives here.
- * The core reconciliation engine never sees TodoWrite formats.
- */
-import { readFile, stat } from 'node:fs/promises';
-import { join } from 'node:path';
-// ---------------------------------------------------------------------------
-// Parsing helpers
-// ---------------------------------------------------------------------------
-/**
- * Parse a CLEO task ID from TodoWrite content prefix: "[T001] ..." -> "T001".
- */
-function parseTaskId(content) {
-    const match = content.match(/^\[T(\d+)\]/);
-    return match ? `T${match[1]}` : null;
-}
-/**
- * Strip ID and status prefixes from content to extract the clean title.
- */
-function stripPrefixes(content) {
-    return content
-        .replace(/^\[T\d+\]\s*/, '')
-        .replace(/^\[!\]\s*/, '')
-        .replace(/^\[BLOCKED\]\s*/, '');
-}
-/**
- * Map TodoWrite status to normalized ExternalTaskStatus.
- */
-function mapStatus(twStatus) {
-    switch (twStatus) {
-        case 'completed':
-            return 'completed';
-        case 'in_progress':
-            return 'active';
-        case 'pending':
-            return 'pending';
-        default:
-            return 'pending';
-    }
-}
-/**
- * Resolve the TodoWrite state file path.
- * Claude Code writes its TodoWrite state to a known location.
- */
-function getTodoWriteFilePath(projectDir) {
-    return join(projectDir, '.cleo', 'sync', 'todowrite-state.json');
-}
-// ---------------------------------------------------------------------------
-// Provider implementation
-// ---------------------------------------------------------------------------
-/**
- * Claude Code TaskSyncProvider.
- *
- * Reads Claude's TodoWrite JSON state, parses [T001]-prefixed task IDs
- * and status, and returns normalized ExternalTask[].
- *
- * Optional: accepts a custom file path for testing.
- *
- * @remarks
- * TodoWrite items with `[T001]`-style prefixes are mapped to their CLEO
- * task IDs. Items without a prefix receive a synthetic `tw-new-N` ID
- * for reconciliation. The provider reads from
- * `.cleo/sync/todowrite-state.json` by default.
- */
-export class ClaudeCodeTaskSyncProvider {
-    /** Optional override path for the TodoWrite state file (used in tests). */
-    customFilePath;
-    constructor(options) {
-        this.customFilePath = options?.filePath;
-    }
-    /** Retrieve external tasks from Claude's TodoWrite state file. */
-    async getExternalTasks(projectDir) {
-        const filePath = this.customFilePath ?? getTodoWriteFilePath(projectDir);
-        // Check file exists
-        try {
-            await stat(filePath);
-        }
-        catch {
-            // No TodoWrite state — return empty (no tasks to sync)
-            return [];
-        }
-        // Parse the TodoWrite JSON
-        const raw = await readFile(filePath, 'utf-8');
-        let state;
-        try {
-            state = JSON.parse(raw);
-        }
-        catch {
-            return []; // Malformed JSON — treat as empty
-        }
-        if (!state.todos || !Array.isArray(state.todos)) {
-            return [];
-        }
-        const tasks = [];
-        let syntheticIndex = 0;
-        for (const item of state.todos) {
-            const cleoTaskId = parseTaskId(item.content);
-            const title = cleoTaskId ? stripPrefixes(item.content).trim() : item.content.trim();
-            if (!title)
-                continue;
-            tasks.push({
-                externalId: cleoTaskId ?? `tw-new-${syntheticIndex++}`,
-                title,
-                status: mapStatus(item.status),
-                providerMeta: {
-                    source: 'todowrite',
-                    cleoTaskId,
-                    activeForm: item.activeForm,
-                    rawContent: item.content,
-                },
-            });
-        }
-        return tasks;
-    }
-}
-//# sourceMappingURL=task-sync.js.map

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

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