@cleocode/adapters 2026.4.9 → 2026.4.11

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

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Transport provider for the Claude Code adapter.
+ *
+ * Implements AdapterTransportProvider to supply Claude Code's
+ * native inter-agent transport mechanism.
+ *
+ * @task T5240
+ */
+/**
+ * Transport provider for Claude Code inter-agent communication.
+ *
+ * @remarks
+ * Currently returns null from {@link createTransport} because actual transport
+ * creation is handled by the signaldock factory which checks for this adapter's
+ * transport capability flag. Full wiring will be completed in Phase 5 of the
+ * adapter system rollout.
+ */
+export class ClaudeCodeTransportProvider {
+    /** Provider-specific transport name used for capability negotiation. */
+    transportName = 'claude-code';
+    /** Create a transport instance for inter-agent messaging. */
+    createTransport() {
+        // Returns null — actual transport creation is handled by the signaldock factory
+        // which checks for this adapter's transport capability.
+        // Full wiring will be completed in Phase 5.
+        return null;
+    }
+}
+//# sourceMappingURL=transport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/providers/claude-code/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IACtC,wEAAwE;IAC/D,aAAa,GAAG,aAAa,CAAC;IAEvC,6DAA6D;IAC7D,eAAe;QACb,gFAAgF;QAChF,wDAAwD;QACxD,4CAA4C;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/providers/codex/adapter.js

@@ -0,0 +1,147 @@
+/**
+ * Codex CLI Adapter
+ *
+ * Main CLEOProviderAdapter implementation for OpenAI Codex CLI.
+ * Provides hooks and install capabilities for CLEO integration.
+ *
+ * @task T162
+ * @epic T134
+ */
+import { exec } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { CodexHookProvider } from './hooks.js';
+import { CodexInstallProvider } from './install.js';
+const execAsync = promisify(exec);
+/**
+ * CLEO provider adapter for OpenAI Codex CLI.
+ *
+ * Bridges CLEO's adapter system with Codex CLI's native capabilities:
+ * - Hooks: Maps Codex events (SessionStart, PromptSubmit, ResponseComplete) to CAAMP events
+ * - Install: Ensures AGENTS.md references for CLEO instruction files
+ *
+ * @remarks
+ * Codex CLI supports only 3 canonical events (SessionStart, PromptSubmit,
+ * ResponseComplete) and has no spawn or transport capabilities. Integration
+ * is primarily through instruction files (AGENTS.md).
+ *
+ * @task T162
+ * @epic T134
+ */
+export class CodexAdapter {
+    /** Unique provider identifier. */
+    id = 'codex';
+    /** Human-readable provider name. */
+    name = 'Codex';
+    /** Adapter version string. */
+    version = '1.0.0';
+    /** Declared capabilities for this provider. */
+    capabilities = {
+        supportsHooks: true,
+        supportedHookEvents: ['SessionStart', 'UserPromptSubmit', 'Stop'],
+        supportsSpawn: false,
+        supportsInstall: true,
+        supportsMcp: false,
+        supportsInstructionFiles: false,
+        supportsContextMonitor: false,
+        supportsStatusline: false,
+        supportsProviderPaths: false,
+        supportsTransport: false,
+        supportsTaskSync: false,
+    };
+    /** Hook provider for CAAMP event mapping. */
+    hooks;
+    /** Install provider for managing instruction files. */
+    install;
+    /** Project directory this adapter was initialized with, or null. */
+    projectDir = null;
+    /** Whether {@link initialize} has been called. */
+    initialized = false;
+    constructor() {
+        this.hooks = new CodexHookProvider();
+        this.install = new CodexInstallProvider();
+    }
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     * @task T162
+     */
+    async initialize(projectDir) {
+        this.projectDir = projectDir;
+        this.initialized = true;
+    }
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     * @task T162
+     */
+    async dispose() {
+        if (this.hooks.isRegistered()) {
+            await this.hooks.unregisterNativeHooks();
+        }
+        this.initialized = false;
+        this.projectDir = null;
+    }
+    /**
+     * Run a health check to verify Codex CLI is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Codex CLI binary is available in PATH
+     * 3. ~/.codex/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     * @task T162
+     */
+    async healthCheck() {
+        const details = {};
+        if (!this.initialized) {
+            return {
+                healthy: false,
+                provider: this.id,
+                details: { error: 'Adapter not initialized' },
+            };
+        }
+        // Check Codex CLI availability
+        let cliAvailable = false;
+        try {
+            const { stdout } = await execAsync('which codex');
+            cliAvailable = stdout.trim().length > 0;
+            details.cliPath = stdout.trim();
+        }
+        catch {
+            details.cliAvailable = false;
+        }
+        // Check for Codex CLI config directory
+        const codexConfigDir = join(homedir(), '.codex');
+        const configExists = existsSync(codexConfigDir);
+        details.configDirExists = configExists;
+        // Healthy if CLI is available (primary requirement)
+        const healthy = cliAvailable;
+        details.cliAvailable = cliAvailable;
+        return {
+            healthy,
+            provider: this.id,
+            details,
+        };
+    }
+    /**
+     * Check whether the adapter has been initialized.
+     * @task T162
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get the project directory this adapter was initialized with.
+     * @task T162
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+}
+//# sourceMappingURL=adapter.js.map

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

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

package/dist/providers/codex/hooks.js

@@ -0,0 +1,113 @@
+/**
+ * Codex CLI Hook Provider
+ *
+ * Maps Codex CLI's native hook events to CAAMP canonical hook events.
+ * Codex CLI supports 3 canonical events through its hook system.
+ *
+ * Codex CLI event mapping:
+ * - SessionStart      -> SessionStart
+ * - PromptSubmit      -> UserPromptSubmit
+ * - ResponseComplete  -> Stop
+ *
+ * @task T162
+ * @epic T134
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { readLatestTranscript } from '../shared/transcript-reader.js';
+/**
+ * Mapping from Codex CLI native event names to CAAMP canonical event names.
+ */
+const CODEX_EVENT_MAP = {
+    SessionStart: 'SessionStart',
+    PromptSubmit: 'UserPromptSubmit',
+    ResponseComplete: 'Stop',
+};
+/**
+ * Hook provider for Codex CLI.
+ *
+ * Codex CLI registers hooks via its configuration system at
+ * ~/.codex/. Hook handlers are shell commands or script paths that
+ * execute when the corresponding event fires.
+ *
+ * Since hooks are registered through the config system (managed by
+ * the install provider), registerNativeHooks and unregisterNativeHooks
+ * track registration state without performing filesystem operations.
+ *
+ * @remarks
+ * Codex CLI has a minimal hook surface with only 3 canonical events.
+ * Registration state is tracked in-memory because Codex CLI manages
+ * hooks through its own configuration system at `~/.codex/`.
+ *
+ * @task T162
+ * @epic T134
+ */
+export class CodexHookProvider {
+    /** Whether hooks have been registered for the current session. */
+    registered = false;
+    /**
+     * Map a Codex CLI native event name to a CAAMP hook event name.
+     *
+     * @param providerEvent - Codex CLI event name (e.g. "SessionStart", "PromptSubmit")
+     * @returns CAAMP event name or null if unmapped
+     * @task T162
+     */
+    mapProviderEvent(providerEvent) {
+        return CODEX_EVENT_MAP[providerEvent] ?? null;
+    }
+    /**
+     * Register native hooks for a project.
+     *
+     * For Codex CLI, hooks are registered via the config system
+     * (~/.codex/), which is handled by the install provider.
+     * This method marks hooks as registered without performing
+     * filesystem operations.
+     *
+     * @param _projectDir - Project directory (unused; hooks are global)
+     * @task T162
+     */
+    async registerNativeHooks(_projectDir) {
+        this.registered = true;
+    }
+    /**
+     * Unregister native hooks.
+     *
+     * For Codex CLI, this is a no-op since hooks are managed through
+     * the config system. Unregistration happens via the install
+     * provider's uninstall method.
+     * @task T162
+     */
+    async unregisterNativeHooks() {
+        this.registered = false;
+    }
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     * @task T162
+     */
+    isRegistered() {
+        return this.registered;
+    }
+    /**
+     * Get the full event mapping for introspection/debugging.
+     * @task T162
+     */
+    getEventMap() {
+        return { ...CODEX_EVENT_MAP };
+    }
+    /**
+     * Extract a plain-text transcript from Codex CLI session data.
+     *
+     * Reads the most recent JSON/JSONL session file under `~/.codex/`
+     * and returns its turns as a flat string for brain observation extraction.
+     *
+     * Returns null when no session data is found or on any read error.
+     *
+     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
+     * @param _projectDir - Project directory (unused; Codex CLI uses global paths)
+     * @task T162 @epic T134
+     */
+    async getTranscript(_sessionId, _projectDir) {
+        return readLatestTranscript(join(homedir(), '.codex'));
+    }
+}
+//# sourceMappingURL=hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/codex/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;GAEG;AACH,MAAM,eAAe,GAA2B;IAC9C,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,kBAAkB;IAChC,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,iBAAiB;IAC5B,kEAAkE;IAC1D,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,eAAe,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED;;;;;;;;;;OAUG;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;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB,EAAE,WAAmB;QACzD,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/providers/codex/index.js

@@ -0,0 +1,39 @@
+/**
+ * @packageDocumentation
+ *
+ * CLEO provider adapter for OpenAI Codex CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T162
+ * @epic T134
+ */
+import { CodexAdapter } from './adapter.js';
+export { CodexAdapter } from './adapter.js';
+export { CodexHookProvider } from './hooks.js';
+export { CodexInstallProvider } from './install.js';
+export default CodexAdapter;
+/**
+ * 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 codex
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link CodexAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/codex';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
+ *
+ * @task T162
+ */
+export function createAdapter() {
+    return new CodexAdapter();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAe,YAAY,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/dist/providers/codex/install.js

@@ -0,0 +1,125 @@
+/**
+ * Codex CLI Install Provider
+ *
+ * Handles CLEO installation into Codex CLI environments:
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T162
+ * @epic T134
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Lines that should appear in AGENTS.md to reference CLEO. */
+const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Install provider for Codex CLI.
+ *
+ * Manages CLEO's integration with Codex CLI by:
+ * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. Only AGENTS.md is managed; Codex CLI
+ * does not have an MCP or plugin registration mechanism.
+ *
+ * @task T162
+ * @epic T134
+ */
+export class CodexInstallProvider {
+    /**
+     * Install CLEO into a Codex CLI environment.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     * @task T162
+     */
+    async install(options) {
+        const { projectDir } = options;
+        const installedAt = new Date().toISOString();
+        let instructionFileUpdated = false;
+        const details = {};
+        // Step 1: Ensure AGENTS.md has @-references
+        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        if (instructionFileUpdated) {
+            details.instructionFile = join(projectDir, 'AGENTS.md');
+        }
+        return {
+            success: true,
+            installedAt,
+            instructionFileUpdated,
+            mcpRegistered: false,
+            details,
+        };
+    }
+    /**
+     * Uninstall CLEO from the Codex CLI environment.
+     *
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * @task T162
+     */
+    async uninstall() {
+        // No-op: no MCP registration to remove
+    }
+    /**
+     * Check whether CLEO is installed in the Codex CLI environment.
+     *
+     * Checks for CLEO references in AGENTS.md.
+     * @task T162
+     */
+    async isInstalled() {
+        const agentsMdPath = join(process.cwd(), 'AGENTS.md');
+        if (existsSync(agentsMdPath)) {
+            try {
+                const content = readFileSync(agentsMdPath, 'utf-8');
+                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
+                    return true;
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        return false;
+    }
+    /**
+     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     *
+     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     * @task T162
+     */
+    async ensureInstructionReferences(projectDir) {
+        this.updateInstructionFile(projectDir);
+    }
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @param projectDir - Project root directory
+     * @returns true if the file was created or modified
+     */
+    updateInstructionFile(projectDir) {
+        const agentsMdPath = join(projectDir, 'AGENTS.md');
+        let content = '';
+        let existed = false;
+        if (existsSync(agentsMdPath)) {
+            content = readFileSync(agentsMdPath, '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) {
+            const separator = content.endsWith('\n') ? '' : '\n';
+            content = content + separator + refsBlock + '\n';
+        }
+        else {
+            content = refsBlock + '\n';
+        }
+        writeFileSync(agentsMdPath, content, 'utf-8');
+        return true;
+    }
+}
+//# sourceMappingURL=install.js.map

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

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