@cleocode/adapters 2.0.0

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

@@ -0,0 +1,60 @@
+/**
+ * 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.
+ */
+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/src/providers/claude-code/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAW3F;;;;;;;GAOG;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;IAmExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}

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

@@ -0,0 +1,160 @@
+/**
+ * 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';
+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) {
+            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(),
+            };
+        }
+    }
+    /**
+     * 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/src/providers/claude-code/spawn.js.map

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

package/src/providers/claude-code/spawn.ts

@@ -0,0 +1,178 @@
+/**
+ * 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 type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
+
+const execAsync = promisify(exec);
+
+/** Internal tracking entry for a spawned process. */
+interface TrackedProcess {
+  pid: number;
+  taskId: string;
+  startTime: string;
+}
+
+/**
+ * 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 implements AdapterSpawnProvider {
+  /** Map of instance IDs to tracked process info. */
+  private processMap = new Map<string, TrackedProcess>();
+
+  /**
+   * Check if the Claude CLI is available in PATH.
+   *
+   * @returns true if `claude` is found via `which`
+   */
+  async canSpawn(): Promise<boolean> {
+    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: SpawnContext): Promise<SpawnResult> {
+    const instanceId = `claude-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+    const startTime = new Date().toISOString();
+    let tmpFile: string | undefined;
+
+    try {
+      tmpFile = `/tmp/claude-spawn-${instanceId}.txt`;
+      await writeFile(tmpFile, context.prompt, 'utf-8');
+
+      const args = ['--allow-insecure', '--no-upgrade-check', tmpFile];
+      const spawnOpts: Parameters<typeof nodeSpawn>[2] = {
+        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) {
+      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(),
+      };
+    }
+  }
+
+  /**
+   * 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(): Promise<SpawnResult[]> {
+    const running: SpawnResult[] = [];
+
+    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: string): Promise<void> {
+    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);
+  }
+}

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

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+export declare function checkStatuslineIntegration(): StatuslineStatus;
+/**
+ * Get the statusline setup command for Claude Code settings.
+ */
+export declare function getStatuslineConfig(cleoHome: string): Record<string, unknown>;
+/**
+ * Get human-readable setup instructions.
+ */
+export declare function getSetupInstructions(cleoHome: string): string;
+export {};
+//# sourceMappingURL=statusline.d.ts.map

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

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

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

@@ -0,0 +1,85 @@
+/**
+ * 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/src/providers/claude-code/statusline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline.js","sourceRoot":"","sources":["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,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EACxD,eAAe,CAChB,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/src/providers/claude-code/statusline.ts

@@ -0,0 +1,99 @@
+/**
+ * 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';
+
+type StatuslineStatus = 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
+
+/**
+ * Get the path to Claude Code's settings.json.
+ * Respects CLAUDE_SETTINGS env var, defaults to ~/.claude/settings.json.
+ */
+function getClaudeSettingsPath(): string {
+  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(): StatuslineStatus {
+  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: string): Record<string, unknown> {
+  return {
+    statusLine: {
+      type: 'command',
+      command: join(cleoHome, 'lib', 'session', 'context-monitor.sh'),
+    },
+  };
+}
+
+/**
+ * Get human-readable setup instructions.
+ */
+export function getSetupInstructions(cleoHome: string): string {
+  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');
+}

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

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ *
+ * @task T5800
+ */
+import type { AdapterTaskSyncProvider, ExternalTask } 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.
+ */
+export declare class ClaudeCodeTaskSyncProvider implements AdapterTaskSyncProvider {
+    private readonly customFilePath?;
+    constructor(options?: {
+        filePath?: string;
+    });
+    getExternalTasks(projectDir: string): Promise<ExternalTask[]>;
+    cleanup(projectDir: string): Promise<void>;
+}
+//# sourceMappingURL=task-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-sync.d.ts","sourceRoot":"","sources":["task-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,uBAAuB,EACvB,YAAY,EAEb,MAAM,qBAAqB,CAAC;AAkE7B;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,uBAAuB;IACxE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;gBAE7B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAIrC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmD7D,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQjD"}