create-claude-workspace 1.1.151 → 2.0.0

package/dist/scripts/autonomous.mjs

@@ -1,492 +0,0 @@
-#!/usr/bin/env node
-// ─── Autonomous development loop ───
-// Headless runner for Claude Code orchestrator using Agent SDK.
-import { resolve } from 'node:path';
-import { existsSync, writeFileSync, unlinkSync, readFileSync, readdirSync } from 'node:fs';
-import { execSync } from 'node:child_process';
-import { DEFAULTS } from './lib/types.mjs';
-import { emptyCheckpoint, readCheckpoint, writeCheckpoint } from './lib/state.mjs';
-import { pollForNewWork } from './lib/idle-poll.mjs';
-import { TUI } from './lib/tui.mjs';
-import { query } from '@anthropic-ai/claude-agent-sdk';
-import { config as dotenvConfig } from '@dotenvx/dotenvx';
-// Disable SDK built-in agents (general-purpose, Explore, Plan, statusline-setup)
-process.env.CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS = '1';
-// ─── Args ───
-function parseArgs(argv) {
-    const opts = { ...DEFAULTS };
-    const numFlag = (flag, i) => {
-        const val = argv[i + 1];
-        if (!val || val.startsWith('--')) {
-            console.error(`${flag} requires a value`);
-            process.exit(1);
-        }
-        const n = parseInt(val, 10);
-        if (isNaN(n)) {
-            console.error(`${flag} must be a number`);
-            process.exit(1);
-        }
-        if (n < 0) {
-            console.error(`${flag} must be non-negative`);
-            process.exit(1);
-        }
-        return n;
-    };
-    const strFlag = (flag, i) => {
-        const val = argv[i + 1];
-        if (!val || val.startsWith('--')) {
-            console.error(`${flag} requires a value`);
-            process.exit(1);
-        }
-        return val;
-    };
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (arg === '--help' || arg === '-h') {
-            opts.help = true;
-            continue;
-        }
-        if (arg === '--skip-permissions') {
-            opts.skipPermissions = true;
-            continue;
-        }
-        if (arg === '--no-lock') {
-            opts.noLock = true;
-            continue;
-        }
-        if (arg === '--no-pull') {
-            opts.noPull = true;
-            continue;
-        }
-        if (arg === '--dry-run') {
-            opts.dryRun = true;
-            continue;
-        }
-        if (arg === '--resume') {
-            opts.resume = true;
-            continue;
-        }
-        if (arg === '--interactive' || arg === '-i') {
-            opts.interactive = true;
-            continue;
-        }
-        if (arg === '--max-iterations') {
-            opts.maxIterations = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--max-turns') {
-            opts.maxTurns = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--delay') {
-            opts.delay = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--cooldown') {
-            opts.cooldown = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--process-timeout') {
-            opts.processTimeout = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--activity-timeout') {
-            opts.activityTimeout = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--post-result-timeout') {
-            opts.postResultTimeout = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--project-dir') {
-            opts.projectDir = resolve(strFlag(arg, i));
-            i++;
-            continue;
-        }
-        if (arg === '--resume-session') {
-            opts.resumeSession = strFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--notify-command') {
-            opts.notifyCommand = strFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--log-file') {
-            opts.logFile = strFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--idle-poll') {
-            opts.idlePollInterval = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg === '--max-idle') {
-            opts.maxIdleTime = numFlag(arg, i);
-            i++;
-            continue;
-        }
-        if (arg.startsWith('--')) {
-            console.error(`Unknown option: ${arg}`);
-            process.exit(1);
-        }
-    }
-    return opts;
-}
-function printHelp() {
-    console.log(`
-Autonomous development loop for Claude Code.
-
-Usage: npx create-claude-workspace run [options]
-
-Options:
-  --max-iterations <n>         Max iterations (default: 50)
-  --max-turns <n>              Max turns per Claude invocation (default: 50)
-  --delay <ms>                 Pause between tasks (default: 5000)
-  --cooldown <ms>              Wait after error (default: 60000)
-  --process-timeout <ms>       Max wall-clock time per invocation (default: 14400000 = 4h)
-  --activity-timeout <ms>      Max silence before kill (default: 900000 = 15min)
-  --post-result-timeout <ms>   Max wait after result (default: 30000 = 30s)
-  --project-dir <path>         Project directory (default: cwd)
-  --skip-permissions           Bypass all permission checks
-  --resume                     Resume from checkpoint state
-  --resume-session <id>        Resume specific Claude session
-  --notify-command <cmd>       Shell command on critical events
-  --log-file <path>            Log file (default: .claude/autonomous.log)
-  --no-lock                    Disable lock file
-  --no-pull                    Skip auto git pull
-  --idle-poll <ms>             Poll interval when idle (default: 300000 = 5min)
-  --max-idle <ms>              Max idle time before exit, 0=unlimited (default: 0)
-  --interactive, -i            Interactive TUI with input prompt
-  --dry-run                    Validate prerequisites only
-  --help                       Show this message
-`);
-}
-// ─── Helpers ───
-function sleep(ms, ref) {
-    return new Promise(r => {
-        const t = setTimeout(r, ms);
-        const check = setInterval(() => { if (ref.value) {
-            clearTimeout(t);
-            clearInterval(check);
-            r();
-        } }, 500);
-    });
-}
-function formatDuration(ms) {
-    if (ms < 1000)
-        return `${ms}ms`;
-    if (ms < 60_000)
-        return `${(ms / 1000).toFixed(0)}s`;
-    return `${(ms / 60_000).toFixed(1)}min`;
-}
-function notify(cmd, type, message, iteration) {
-    if (!cmd)
-        return;
-    try {
-        execSync(cmd, { env: { ...process.env, RALPH_EVENT: type, RALPH_MESSAGE: message, RALPH_ITERATION: String(iteration) }, timeout: 10_000, stdio: 'pipe' });
-    }
-    catch { /* */ }
-}
-function checkAuth() {
-    if (process.env.ANTHROPIC_API_KEY)
-        return true;
-    try {
-        const home = process.env.HOME || process.env.USERPROFILE || '';
-        const creds = resolve(home, '.claude', '.credentials.json');
-        if (existsSync(creds)) {
-            const data = JSON.parse(readFileSync(creds, 'utf-8'));
-            if (data.claudeAiOauth?.accessToken)
-                return true;
-        }
-    }
-    catch { /* */ }
-    return false;
-}
-function acquireLock(dir, ui) {
-    const lockFile = resolve(dir, '.claude/autonomous.lock');
-    if (existsSync(lockFile)) {
-        ui.warn('Lock file exists. Another instance running?');
-        return false;
-    }
-    try {
-        writeFileSync(lockFile, String(process.pid));
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function releaseLock(dir) {
-    try {
-        unlinkSync(resolve(dir, '.claude/autonomous.lock'));
-    }
-    catch { /* */ }
-}
-function readMemory(dir) {
-    try {
-        return readFileSync(resolve(dir, 'MEMORY.md'), 'utf-8');
-    }
-    catch {
-        return '';
-    }
-}
-function isProjectComplete(memory) {
-    // Only trust the orchestrator's explicit completion marker in MEMORY.md.
-    // Do NOT guess from TODO.md — the orchestrator handles phase transitions,
-    // product-owner re-evaluations, and task additions internally.
-    return /^Current Phase:.*PROJECT COMPLETE/mi.test(memory)
-        || /^Project_Status:\s*complete/mi.test(memory);
-}
-function loadAgents(dir) {
-    const agentsDir = resolve(dir, '.claude', 'agents');
-    const agents = {};
-    if (!existsSync(agentsDir))
-        return agents;
-    for (const file of readdirSync(agentsDir)) {
-        if (!file.endsWith('.md'))
-            continue;
-        const name = file.replace('.md', '');
-        const content = readFileSync(resolve(agentsDir, file), 'utf-8');
-        // Parse YAML frontmatter
-        let description = name;
-        let model;
-        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
-        if (fmMatch) {
-            const fm = fmMatch[1];
-            const descMatch = fm.match(/description:\s*["']?(.*?)["']?\s*$/m);
-            if (descMatch)
-                description = descMatch[1];
-            const modelMatch = fm.match(/model:\s*(\S+)/m);
-            if (modelMatch)
-                model = modelMatch[1];
-        }
-        agents[name] = { description, prompt: content, model };
-    }
-    return agents;
-}
-function gitPull(dir) {
-    try {
-        execSync('git fetch --quiet && git pull --ff-only --quiet', { cwd: dir, timeout: 30_000, stdio: 'pipe' });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ─── Signal handling ───
-let stopping = false;
-const stoppingRef = { value: false };
-// ─── Main loop ───
-async function main() {
-    const opts = parseArgs(process.argv.slice(2));
-    if (opts.help) {
-        printHelp();
-        process.exit(0);
-    }
-    dotenvConfig({ path: resolve(opts.projectDir, '.env'), override: false, quiet: true });
-    const logPath = resolve(opts.projectDir, opts.logFile);
-    const tui = new TUI(logPath, opts.interactive);
-    tui.setTopAgent('orchestrator');
-    tui.banner();
-    tui.info(`Project: ${opts.projectDir}`);
-    tui.info(`Max iterations: ${opts.maxIterations} │ Max turns: ${opts.maxTurns}`);
-    // Auth check
-    if (!checkAuth()) {
-        tui.error('Not authenticated. Either:');
-        tui.error('  1. Set ANTHROPIC_API_KEY env var (API billing)');
-        tui.error('  2. Run `claude login` to authenticate with Claude Max plan');
-        tui.error('  For Docker: mount ~/.claude/.credentials.json into the container');
-        process.exit(1);
-    }
-    tui.success('Authentication verified');
-    // Lock
-    if (!opts.noLock && !acquireLock(opts.projectDir, tui)) {
-        process.exit(1);
-    }
-    // Git pull
-    if (!opts.noPull) {
-        if (gitPull(opts.projectDir))
-            tui.info('Git: pulled latest changes');
-        else
-            tui.warn('Git: pull failed or not a git repo');
-    }
-    if (opts.dryRun) {
-        tui.success('Dry run complete. All checks passed.');
-        if (!opts.noLock)
-            releaseLock(opts.projectDir);
-        process.exit(0);
-    }
-    // Checkpoint
-    let checkpoint;
-    const existing = readCheckpoint(opts.projectDir);
-    if (opts.resume && existing) {
-        checkpoint = existing;
-        tui.info(`Resuming from iteration ${checkpoint.iteration}`);
-    }
-    else {
-        checkpoint = emptyCheckpoint();
-    }
-    // Signals
-    const cleanup = () => {
-        stopping = true;
-        stoppingRef.value = true;
-        if (!opts.noLock)
-            releaseLock(opts.projectDir);
-        writeCheckpoint(opts.projectDir, checkpoint);
-        tui.warn('Interrupted. State saved.');
-        process.exit(0);
-    };
-    process.on('SIGINT', cleanup);
-    process.on('SIGTERM', cleanup);
-    // Hotkey handler (interactive mode)
-    tui.setHotkeyHandler((action) => {
-        if (action === 'pause')
-            tui.warn('Paused. Press Ctrl+Z to resume.');
-        if (action === 'resume')
-            tui.success('Resumed.');
-        if (action === 'stop') {
-            stopping = true;
-            stoppingRef.value = true;
-            tui.warn('Stopping after current iteration...');
-        }
-        if (action === 'quit')
-            cleanup();
-    });
-    // ─── Loop ───
-    for (let i = checkpoint.iteration + 1; i <= opts.maxIterations && !stopping; i++) {
-        // Check completion → idle polling
-        const memory = readMemory(opts.projectDir);
-        if (isProjectComplete(memory)) {
-            if (!checkpoint.completionVerified) {
-                checkpoint.completionVerified = true;
-                writeCheckpoint(opts.projectDir, checkpoint);
-            }
-            else {
-                tui.info('Project complete. Entering idle polling...');
-                let foundWork = false;
-                const idleStart = Date.now();
-                while (!stopping) {
-                    const poll = await pollForNewWork(opts.projectDir, { info: (m) => tui.info(m), warn: (m) => tui.warn(m), error: (m) => tui.error(m), debug: () => { } });
-                    if (poll.hasWork) {
-                        tui.success(`New work detected (${poll.source}). Resuming...`);
-                        checkpoint.completionVerified = false;
-                        writeCheckpoint(opts.projectDir, checkpoint);
-                        foundWork = true;
-                        break;
-                    }
-                    if (opts.maxIdleTime > 0 && Date.now() - idleStart >= opts.maxIdleTime) {
-                        tui.info('Max idle time reached. Exiting.');
-                        break;
-                    }
-                    await sleep(opts.idlePollInterval, stoppingRef);
-                }
-                if (!foundWork)
-                    break;
-                continue;
-            }
-        }
-        tui.setIteration(i, opts.maxIterations);
-        tui.resetAgentStack();
-        // Run Claude via Agent SDK
-        try {
-            const resumeOpts = {};
-            if (opts.resumeSession) {
-                resumeOpts.resume = opts.resumeSession;
-                opts.resumeSession = null;
-            }
-            else if (opts.resume && checkpoint.lastSessionId) {
-                resumeOpts.continue = true;
-                opts.resume = false;
-            }
-            // Agents + CLAUDE.md loaded by SDK from .claude/ via settingSources: ['project']
-            const queryOptions = {
-                // Use settingSources to load agents from .claude/agents/ + CLAUDE.md
-                settingSources: ['project'],
-                agent: 'orchestrator',
-                model: 'claude-opus-4-6',
-                maxTurns: opts.maxTurns,
-                cwd: opts.projectDir,
-            };
-            if (opts.skipPermissions) {
-                queryOptions.permissionMode = 'bypassPermissions';
-                queryOptions.allowDangerouslySkipPermissions = true;
-            }
-            if (resumeOpts.continue)
-                queryOptions.continue = true;
-            if (resumeOpts.resume)
-                queryOptions.resume = resumeOpts.resume;
-            const q = query({ prompt: 'Continue autonomous development. Pick the next task and execute the full workflow.', options: queryOptions });
-            // Wire up interactive input → SDK message queue
-            let sessionId = '';
-            if (opts.interactive) {
-                tui.setInputHandler((text) => {
-                    const msg = {
-                        type: 'user',
-                        message: { role: 'user', content: text },
-                        parent_tool_use_id: null,
-                        session_id: sessionId,
-                        priority: 'next',
-                    };
-                    async function* single() { yield msg; }
-                    q.streamInput(single()).catch(() => { });
-                });
-            }
-            for await (const message of q) {
-                tui.handleMessage(message);
-                if (message.type === 'system' && message.subtype === 'init') {
-                    sessionId = message.session_id || '';
-                }
-                if (message.type === 'result') {
-                    checkpoint.lastSessionId = message.session_id ?? null;
-                }
-            }
-            checkpoint.stats.iterations++;
-            tui.iterationEnd();
-        }
-        catch (err) {
-            tui.error(`${err.message}`);
-            tui.warn(`Cooling down ${formatDuration(opts.cooldown)}...`);
-            await sleep(opts.cooldown, stoppingRef);
-            if (stopping)
-                break;
-            i--;
-            continue;
-        }
-        checkpoint.iteration = i;
-        writeCheckpoint(opts.projectDir, checkpoint);
-        // Pause support
-        while (tui.isPaused() && !stopping) {
-            await sleep(1000, stoppingRef);
-        }
-        if (i < opts.maxIterations && !stopping) {
-            tui.info(`Next iteration in ${formatDuration(opts.delay)}...`);
-            await sleep(opts.delay, stoppingRef);
-        }
-    }
-    // End
-    if (!opts.noLock)
-        releaseLock(opts.projectDir);
-    writeCheckpoint(opts.projectDir, checkpoint);
-    tui.success(`Loop ended after ${checkpoint.stats.iterations} iterations.`);
-    tui.destroy();
-    notify(opts.notifyCommand, 'completed', 'Loop ended', checkpoint.iteration);
-}
-// ─── Export for CLI integration ───
-export { main as runAutonomousLoop, parseArgs, printHelp };
-const isDirectRun = process.argv[1]?.replace(/\\/g, '/').endsWith('autonomous.mjs');
-if (isDirectRun) {
-    main().catch(err => {
-        console.error('Fatal:', err);
-        process.exit(1);
-    });
-}

package/dist/scripts/autonomous.spec.js

@@ -1,46 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { parseArgs } from './autonomous.mjs';
-describe('parseArgs', () => {
-    it('returns defaults for empty args', () => {
-        const opts = parseArgs([]);
-        expect(opts.maxIterations).toBe(50);
-        expect(opts.maxTurns).toBe(50);
-        expect(opts.skipPermissions).toBe(false);
-        expect(opts.dryRun).toBe(false);
-        expect(opts.resume).toBe(false);
-    });
-    it('parses boolean flags', () => {
-        const opts = parseArgs(['--skip-permissions', '--dry-run', '--resume', '--no-lock', '--no-pull']);
-        expect(opts.skipPermissions).toBe(true);
-        expect(opts.dryRun).toBe(true);
-        expect(opts.resume).toBe(true);
-        expect(opts.noLock).toBe(true);
-        expect(opts.noPull).toBe(true);
-    });
-    it('parses numeric flags', () => {
-        const opts = parseArgs(['--max-iterations', '10', '--max-turns', '20', '--delay', '1000']);
-        expect(opts.maxIterations).toBe(10);
-        expect(opts.maxTurns).toBe(20);
-        expect(opts.delay).toBe(1000);
-    });
-    it('parses string flags', () => {
-        const opts = parseArgs(['--project-dir', '/tmp/proj', '--notify-command', 'echo hi', '--log-file', 'custom.log']);
-        expect(opts.projectDir).toContain('proj');
-        expect(opts.notifyCommand).toBe('echo hi');
-        expect(opts.logFile).toBe('custom.log');
-    });
-    it('sets help flag', () => {
-        expect(parseArgs(['--help']).help).toBe(true);
-        expect(parseArgs(['-h']).help).toBe(true);
-    });
-    it('parses idle poll flags', () => {
-        const opts = parseArgs(['--idle-poll', '60000', '--max-idle', '3600000']);
-        expect(opts.idlePollInterval).toBe(60000);
-        expect(opts.maxIdleTime).toBe(3600000);
-    });
-    it('uses defaults for idle poll flags when not provided', () => {
-        const opts = parseArgs([]);
-        expect(opts.idlePollInterval).toBe(5 * 60_000);
-        expect(opts.maxIdleTime).toBe(0);
-    });
-});