@cleocode/adapters 2026.3.66 → 2026.3.68

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

@@ -0,0 +1,234 @@
+/**
+ * Claude Code Install Provider
+ *
+ * Handles CLEO installation into Claude Code environments:
+ * - Registers CLEO MCP server in .mcp.json
+ * - Ensures CLAUDE.md has CLEO @-references
+ * - Manages plugin registration in ~/.claude/settings.json
+ *
+ * Migrated from src/core/install/claude-plugin.ts
+ *
+ * @task T5240
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Lines that should appear in CLAUDE.md to reference CLEO. */
+const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/** MCP server registration key used in .mcp.json. */
+const MCP_SERVER_KEY = 'cleo';
+/**
+ * Install provider for Claude Code.
+ *
+ * Manages CLEO's integration with Claude Code by:
+ * 1. Registering the CLEO MCP server in the project's .mcp.json
+ * 2. Ensuring CLAUDE.md contains @-references to CLEO instruction files
+ * 3. Registering the brain observation plugin in ~/.claude/settings.json
+ */
+export class ClaudeCodeInstallProvider {
+    installedProjectDir = null;
+    /**
+     * Install CLEO into a Claude Code 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 .mcp.json
+        if (mcpServerPath) {
+            mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
+            if (mcpRegistered) {
+                details.mcpConfigPath = join(projectDir, '.mcp.json');
+            }
+        }
+        // Step 2: Ensure CLAUDE.md has @-references
+        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        if (instructionFileUpdated) {
+            details.instructionFile = join(projectDir, 'CLAUDE.md');
+        }
+        // Step 3: Register plugin in ~/.claude/settings.json
+        const pluginResult = this.registerPlugin();
+        if (pluginResult) {
+            details.plugin = pluginResult;
+        }
+        this.installedProjectDir = projectDir;
+        return {
+            success: true,
+            installedAt,
+            instructionFileUpdated,
+            mcpRegistered,
+            details,
+        };
+    }
+    /**
+     * Uninstall CLEO from the current Claude Code project.
+     *
+     * Removes the MCP server registration from .mcp.json.
+     * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
+     */
+    async uninstall() {
+        if (!this.installedProjectDir)
+            return;
+        const mcpPath = join(this.installedProjectDir, '.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:
+     * 1. MCP server registered in .mcp.json
+     * 2. Plugin enabled in ~/.claude/settings.json
+     *
+     * Returns true if either condition is met (partial install counts).
+     */
+    async isInstalled() {
+        // Check ~/.claude/settings.json for plugin registration
+        const settingsPath = join(homedir(), '.claude', 'settings.json');
+        if (existsSync(settingsPath)) {
+            try {
+                const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+                const plugins = settings.enabledPlugins;
+                if (plugins && plugins['cleo@cleocode'] === true) {
+                    return true;
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        // Check current directory for .mcp.json with cleo server
+        const mcpPath = join(process.cwd(), '.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 CLAUDE.md contains @-references to CLEO instruction files.
+     *
+     * Creates CLAUDE.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     */
+    async ensureInstructionReferences(projectDir) {
+        this.updateInstructionFile(projectDir);
+    }
+    /**
+     * Register the CLEO MCP server in .mcp.json.
+     *
+     * @returns true if registration was performed or updated
+     */
+    registerMcpServer(projectDir, mcpServerPath) {
+        const mcpPath = join(projectDir, '.mcp.json');
+        let config = {};
+        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 CLAUDE.md with CLEO @-references.
+     *
+     * @returns true if the file was created or modified
+     */
+    updateInstructionFile(projectDir) {
+        const claudeMdPath = join(projectDir, 'CLAUDE.md');
+        let content = '';
+        let existed = false;
+        if (existsSync(claudeMdPath)) {
+            content = readFileSync(claudeMdPath, '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) {
+            // Append missing references
+            const separator = content.endsWith('\n') ? '' : '\n';
+            content = content + separator + refsBlock + '\n';
+        }
+        else {
+            // Create new CLAUDE.md with references
+            content = refsBlock + '\n';
+        }
+        writeFileSync(claudeMdPath, content, 'utf-8');
+        return true;
+    }
+    /**
+     * Register the CLEO brain plugin in ~/.claude/settings.json.
+     *
+     * @returns Description of what was registered, or null if no change needed
+     */
+    registerPlugin() {
+        const home = homedir();
+        const settingsPath = join(home, '.claude', 'settings.json');
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            }
+            catch {
+                // Start fresh
+            }
+        }
+        const enabledPlugins = settings.enabledPlugins ?? {};
+        const pluginKey = 'cleo@cleocode';
+        if (enabledPlugins[pluginKey] === true) {
+            return null;
+        }
+        // Disable old claude-mem if present
+        if (enabledPlugins['claude-mem@thedotmack'] === true) {
+            enabledPlugins['claude-mem@thedotmack'] = false;
+        }
+        enabledPlugins[pluginKey] = true;
+        settings.enabledPlugins = enabledPlugins;
+        mkdirSync(join(home, '.claude'), { recursive: true });
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+        return `Enabled ${pluginKey} in ~/.claude/settings.json`;
+    }
+}
+//# sourceMappingURL=install.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * 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)
+ */
+export class ClaudeCodePathProvider {
+    getProviderDir() {
+        return process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude');
+    }
+    getSettingsPath() {
+        return process.env['CLAUDE_SETTINGS'] ?? join(this.getProviderDir(), 'settings.json');
+    }
+    getAgentInstallDir() {
+        return join(this.getProviderDir(), 'agents');
+    }
+    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

@@ -0,0 +1 @@
+{"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;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACjC,cAAc;QACZ,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,eAAe;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC;IACxF,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,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.js

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

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

@@ -0,0 +1,86 @@
+/**
+ * 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.
+ */
+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.
+ */
+export function getStatuslineConfig(cleoHome) {
+    return {
+        statusLine: {
+            type: 'command',
+            command: join(cleoHome, 'lib', 'session', 'context-monitor.sh'),
+        },
+    };
+}
+/**
+ * Get human-readable setup instructions.
+ */
+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

@@ -0,0 +1 @@
+{"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;;;GAGG;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;;GAEG;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;;GAEG;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.js

@@ -0,0 +1,111 @@
+/**
+ * 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.
+ */
+export class ClaudeCodeTaskSyncProvider {
+    customFilePath;
+    constructor(options) {
+        this.customFilePath = options?.filePath;
+    }
+    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