@cleocode/adapters 2026.5.4 → 2026.5.5

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

@@ -1,310 +0,0 @@
-/**
- * Claude Code Install Provider
- *
- * Handles CLEO installation into Claude Code environments:
- * - Ensures CLAUDE.md has CLEO @-references
- * - Manages plugin registration in ~/.claude/settings.json
- *
- * Migrated from src/core/install/claude-plugin.ts
- *
- * @task T5240
- */
-import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { installProviderHookTemplates, } from '../shared/hook-template-installer.js';
-import { getCleoTemplatesTildePath } from '../shared/paths.js';
-/**
- * Lines that should appear in CLAUDE.md to reference CLEO.
- * The CLEO-INJECTION.md path is resolved dynamically to support non-default
- * XDG / OS installation locations (T916).
- */
-const INSTRUCTION_REFERENCES = [
-    `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-    '@.cleo/memory-bridge.md',
-];
-/** Resolve the commands directory bundled with this adapter. */
-function getAdapterCommandsDir() {
-    // Works in both ESM (import.meta.url) and compiled output
-    const thisDir = dirname(fileURLToPath(import.meta.url));
-    return join(thisDir, 'commands');
-}
-/**
- * Install provider for Claude Code.
- *
- * Manages CLEO's integration with Claude Code by:
- * 1. Ensuring CLAUDE.md contains @-references to CLEO instruction files
- * 2. Installing adapter-provided commands to .claude/commands/
- * 3. Registering the brain observation plugin in ~/.claude/settings.json
- *
- * @remarks
- * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. The provider disables the legacy
- * `claude-mem\@thedotmack` plugin if present and enables the unified
- * `cleo\@cleocode` plugin instead.
- */
-export class ClaudeCodeInstallProvider {
-    /**
-     * Install CLEO into a Claude Code project.
-     *
-     * @param options - Installation options including project directory
-     * @returns Result describing what was installed
-     */
-    async install(options) {
-        const { projectDir } = options;
-        const installedAt = new Date().toISOString();
-        let instructionFileUpdated = false;
-        const details = {};
-        // Step 1: Ensure CLAUDE.md has @-references
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFile = join(projectDir, 'CLAUDE.md');
-        }
-        // Step 2: Install adapter-provided commands to .claude/commands/
-        const commandsInstalled = this.installCommands(projectDir);
-        if (commandsInstalled.length > 0) {
-            details.commands = commandsInstalled;
-        }
-        // Step 3: Register plugin in ~/.claude/settings.json
-        const pluginResult = this.registerPlugin();
-        if (pluginResult) {
-            details.plugin = pluginResult;
-        }
-        // Step 4 (T1013): Install PreCompact hook templates + wire the handler
-        // command into ~/.claude/settings.json's `PreCompact` event.
-        const hookResult = this.installHookTemplates();
-        if (hookResult) {
-            details.hookTemplates = hookResult;
-        }
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the current Claude Code project.
-     *
-     * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
-     */
-    async uninstall() { }
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for plugin enabled in ~/.claude/settings.json.
-     */
-    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
-            }
-        }
-        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);
-    }
-    /**
-     * 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;
-    }
-    /**
-     * Install Claude Code-specific commands to .claude/commands/ in the project.
-     *
-     * These commands extend CLEO's provider-neutral skills with Claude Code-specific
-     * operational patterns (Agent tool spawn templates, model assignment, context guardrails).
-     *
-     * @param projectDir - Project root directory
-     * @returns Array of installed command filenames
-     */
-    installCommands(projectDir) {
-        const adapterCommandsDir = getAdapterCommandsDir();
-        if (!existsSync(adapterCommandsDir)) {
-            return [];
-        }
-        const targetDir = join(projectDir, '.claude', 'commands');
-        mkdirSync(targetDir, { recursive: true });
-        const installed = [];
-        const files = readdirSync(adapterCommandsDir).filter((f) => f.endsWith('.md'));
-        for (const file of files) {
-            const src = join(adapterCommandsDir, file);
-            const dest = join(targetDir, file);
-            copyFileSync(src, dest);
-            installed.push(file);
-        }
-        return installed;
-    }
-    /**
-     * 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`;
-    }
-    /**
-     * Install the CLEO PreCompact hook templates for Claude Code (T1013).
-     *
-     * Writes two files to `~/.claude/hooks/`:
-     * 1. `cleo-precompact-core.sh` — universal CLEO safestop helper (shared
-     *    across all providers; sourced by the provider-specific shim).
-     * 2. `precompact-safestop.sh` — Claude-Code-flavoured wrapper that invokes
-     *    `cleo memory precompact-flush` and `cleo safestop`.
-     *
-     * Also registers a `PreCompact` entry in `~/.claude/settings.json` so Claude
-     * Code runs the hook when auto-compact fires (at 95% context).
-     *
-     * Idempotent: subsequent installs skip unchanged files and do not duplicate
-     * the settings.json hook entry.
-     *
-     * @returns Install summary (paths written + config change description), or
-     *   `null` when no change was required.
-     *
-     * @task T1013
-     */
-    installHookTemplates() {
-        const home = homedir();
-        const hooksDir = join(home, '.claude', 'hooks');
-        // 1. Copy the bash templates next to each other so `source $SCRIPT_DIR/...` works.
-        //    Template copy is best-effort so missing/locked filesystems (CI sandboxes,
-        //    mocked `node:fs` in unit tests) don't fail the whole install.
-        let templates;
-        try {
-            templates = installProviderHookTemplates({
-                provider: 'claude-code',
-                targetDir: hooksDir,
-            });
-        }
-        catch {
-            return null;
-        }
-        // 2. Wire the PreCompact event in ~/.claude/settings.json.
-        const settingsEntryAdded = this.registerPreCompactHook(join(hooksDir, 'precompact-safestop.sh'));
-        if (templates.installedFiles.length === 0 && !settingsEntryAdded) {
-            return null;
-        }
-        return { templates, settingsEntryAdded };
-    }
-    /**
-     * Register the PreCompact hook command in `~/.claude/settings.json`.
-     *
-     * The Claude Code native event name for the canonical `PreCompact` event is
-     * `PreCompact` (identity mapping — see `hook-mappings.json`). The entry is
-     * tagged with `# cleo-hook` so the uninstall flow can identify and remove
-     * our additions without touching user-authored hooks.
-     *
-     * @param shimPath - Absolute path to the installed `precompact-safestop.sh`.
-     * @returns `true` when a new hook entry was written, `false` when an
-     *   equivalent entry was already present.
-     *
-     * @task T1013
-     */
-    registerPreCompactHook(shimPath) {
-        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 on corrupt settings — safer than aborting install.
-            }
-        }
-        const hooks = settings.hooks ?? {};
-        const preCompactEntries = hooks.PreCompact ?? [];
-        const alreadyWired = preCompactEntries.some((entry) => typeof entry === 'object' &&
-            entry !== null &&
-            Array.isArray(entry.hooks) &&
-            entry.hooks.some((h) => typeof h.command === 'string' &&
-                h.command.includes('# cleo-hook') &&
-                h.command.includes('precompact-safestop.sh')));
-        if (alreadyWired) {
-            return false;
-        }
-        preCompactEntries.push({
-            matcher: '',
-            hooks: [
-                {
-                    type: 'command',
-                    command: `"${shimPath}" # cleo-hook`,
-                    timeout: 30,
-                },
-            ],
-        });
-        hooks.PreCompact = preCompactEntries;
-        settings.hooks = hooks;
-        mkdirSync(join(home, '.claude'), { recursive: true });
-        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
-        return true;
-    }
-}
-//# sourceMappingURL=install.js.map

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

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

@@ -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.js

@@ -1,198 +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 {
-            // Enrich prompt with CANT bundle, memory bridge, mental model, and NEXUS context (T555, T625).
-            // Best-effort: if CANT context is unavailable, the raw prompt is used.
-            let enrichedPrompt = context.prompt;
-            try {
-                const { buildCantEnrichedPrompt } = await import('../../cant-context.js');
-                enrichedPrompt = await buildCantEnrichedPrompt({
-                    projectDir: context.workingDirectory ?? process.cwd(),
-                    basePrompt: context.prompt,
-                    agentName: context.options?.agentName ?? undefined,
-                    // Inject NEXUS code intelligence context for the task scope (T625).
-                    // This injects callers/callees/impact data so the agent understands
-                    // blast radius before modifying any symbol.
-                    taskId: context.taskId ?? undefined,
-                });
-            }
-            catch {
-                // CANT enrichment unavailable — use raw prompt
-            }
-            tmpFile = `/tmp/claude-spawn-${instanceId}.txt`;
-            await writeFile(tmpFile, enrichedPrompt, 'utf-8');
-            // --print: non-interactive batch mode (process prompt, output response, exit)
-            // --dangerously-skip-permissions: allow all tool calls without human approval
-            // --output-format json: structured output for parsing
-            const args = [
-                '--print',
-                '--dangerously-skip-permissions',
-                '--output-format',
-                'json',
-                tmpFile,
-            ];
-            const spawnOpts = {
-                detached: true,
-                stdio: ['ignore', 'pipe', 'pipe'],
-            };
-            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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"}