create-claude-workspace 1.1.151 → 2.0.0

package/dist/scripts/docker-run.mjs

@@ -1,462 +0,0 @@
-#!/usr/bin/env node
-// ─── Docker-based isolated runner for Claude Starter Kit ───
-// Single cross-platform script. Builds container, sets up auth, runs autonomous loop.
-import { spawnSync, spawn as spawnAsync } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
-import { join } from 'node:path';
-import { homedir, platform as osPlatform, tmpdir, totalmem } from 'node:os';
-// PROJECT_DIR = target project (set by index.ts via cwd), not the npm package
-const PROJECT_DIR = process.cwd();
-const DOCKER_DIR = join(PROJECT_DIR, '.claude', 'docker');
-const AUTH_COMPOSE = join(tmpdir(), 'claude-starter-kit-auth-compose.yml');
-const IS_WIN = osPlatform() === 'win32';
-const IS_MAC = osPlatform() === 'darwin';
-const SHELL = IS_WIN ? 'cmd.exe' : '/bin/sh';
-// ─── Colors ───
-const C = { r: '\x1b[31m', g: '\x1b[32m', y: '\x1b[33m', c: '\x1b[36m', n: '\x1b[0m' };
-const info = (m) => console.log(`${C.g}[INFO]${C.n} ${m}`);
-const warn = (m) => console.log(`${C.y}[WARN]${C.n} ${m}`);
-const error = (m) => console.log(`${C.r}[ERROR]${C.n} ${m}`);
-const step = (m) => console.log(`${C.c}[STEP]${C.n} ${m}`);
-// ─── Helpers ───
-function sleepSync(ms) {
-    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-function run(cmd, args = [], opts = {}) {
-    return spawnSync(cmd, args, {
-        shell: SHELL,
-        cwd: opts.cwd ?? PROJECT_DIR,
-        stdio: opts.capture ? 'pipe' : 'inherit',
-        timeout: opts.timeout,
-        env: { ...process.env, ...opts.env },
-    });
-}
-function ok(cmd, args = []) {
-    return run(cmd, args, { capture: true }).status === 0;
-}
-function hasCmd(cmd) {
-    const check = IS_WIN ? 'where' : 'which';
-    return spawnSync(check, [cmd], { shell: SHELL, stdio: 'pipe' }).status === 0;
-}
-function toDockerPath(p) {
-    return p.replace(/\\/g, '/');
-}
-function compose(args, opts = {}) {
-    const files = [];
-    if (existsSync(AUTH_COMPOSE))
-        files.push('-f', 'docker-compose.yml', '-f', AUTH_COMPOSE);
-    const result = spawnSync('docker', ['compose', ...files, ...args], {
-        cwd: DOCKER_DIR,
-        stdio: opts.capture ? 'pipe' : 'inherit',
-        env: { ...process.env },
-    });
-    if (!opts.capture && result.status !== 0 && result.status !== null) {
-        error(`docker compose ${args[0]} failed (exit code ${result.status})`);
-    }
-    return result;
-}
-function cleanup() {
-    try {
-        if (existsSync(AUTH_COMPOSE))
-            unlinkSync(AUTH_COMPOSE);
-    }
-    catch { /* ignore */ }
-}
-/** Run docker compose asynchronously — returns a promise that resolves on exit.
- *  Ctrl+C triggers `docker compose kill` to forcefully stop the container. */
-function composeAsync(args) {
-    const files = [];
-    if (existsSync(AUTH_COMPOSE))
-        files.push('-f', 'docker-compose.yml', '-f', AUTH_COMPOSE);
-    const child = spawnAsync('docker', ['compose', ...files, ...args], {
-        cwd: DOCKER_DIR,
-        stdio: 'inherit',
-        env: { ...process.env },
-    });
-    const kill = () => {
-        // Forcefully kill the container — belt AND suspenders
-        try {
-            child.kill();
-        }
-        catch { /* ignore */ }
-        try {
-            spawnSync('docker', ['compose', ...files, 'kill', 'claude'], {
-                cwd: DOCKER_DIR, stdio: 'ignore', timeout: 5_000,
-            });
-        }
-        catch { /* ignore */ }
-        try {
-            spawnSync('docker', ['compose', ...files, 'down', '--timeout', '0'], {
-                cwd: DOCKER_DIR, stdio: 'ignore', timeout: 5_000,
-            });
-        }
-        catch { /* ignore */ }
-        cleanup();
-        process.exit(130);
-    };
-    process.on('SIGINT', kill);
-    process.on('SIGTERM', kill);
-    return new Promise((resolve) => {
-        child.on('close', (code) => {
-            process.removeListener('SIGINT', kill);
-            process.removeListener('SIGTERM', kill);
-            resolve(code ?? 1);
-        });
-        child.on('error', () => resolve(1));
-    });
-}
-process.on('exit', cleanup);
-// These handlers are overridden by composeAsync when running — fallback for non-async paths
-process.on('SIGINT', () => { cleanup(); process.exit(130); });
-process.on('SIGTERM', () => { cleanup(); process.exit(143); });
-function parseArgs() {
-    const args = process.argv.slice(2);
-    const opts = {
-        shell: false, rebuild: false, login: false, help: false,
-        maxIterations: '', maxTurns: '', delay: '', cooldown: '', resumeSession: '',
-    };
-    const FLAG_TO_KEY = {
-        '--max-iterations': 'maxIterations',
-        '--max-turns': 'maxTurns',
-        '--delay': 'delay',
-        '--cooldown': 'cooldown',
-        '--resume-session': 'resumeSession',
-    };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === '--help' || arg === '-h') {
-            opts.help = true;
-            continue;
-        }
-        if (arg === '--shell') {
-            opts.shell = true;
-            continue;
-        }
-        if (arg === '--rebuild') {
-            opts.rebuild = true;
-            continue;
-        }
-        if (arg === '--login') {
-            opts.login = true;
-            continue;
-        }
-        const key = FLAG_TO_KEY[arg];
-        if (key) {
-            if (i + 1 >= args.length || args[i + 1].startsWith('--')) {
-                error(`${arg} requires a value`);
-                process.exit(1);
-            }
-            opts[key] = args[++i];
-            continue;
-        }
-        error(`Unknown option: ${arg}`);
-        process.exit(1);
-    }
-    return opts;
-}
-function printHelp() {
-    console.log(`
-Docker runner for Claude Starter Kit
-
-One command to start safe, isolated autonomous development.
---skip-permissions is added automatically (the container is the sandbox).
-
-Usage:
-  npx create-claude-workspace docker [options]
-
-Options:
-  --shell              Interactive shell instead of autonomous loop
-  --max-iterations <n> Max iterations (default: 50)
-  --max-turns <n>      Max turns per iteration (default: 50)
-  --delay <ms>         Pause between tasks (default: 5000)
-  --cooldown <ms>      Wait after rate limit (default: 60000)
-  --rebuild            Force rebuild Docker image
-  --login              Run 'claude auth login' on host before starting container
-  --resume-session <id>  Resume a previous Claude session by ID
-  --help, -h           Show this help
-
-Authentication:
-  The container uses your HOST machine's Claude auth automatically.
-  - Max plan: run 'claude auth login' on your host first (or use --login)
-  - API key:  set ANTHROPIC_API_KEY=sk-... before running
-
-npm Publishing (optional):
-  Set NPM_TOKEN=npm_XXXXX before running.
-  Optionally: NPM_REGISTRY=npm.pkg.github.com (default: registry.npmjs.org)
-
-Git Platform (optional — for push, MR/PR, issues):
-  GitHub:  set GH_TOKEN=ghp_XXXXX before running
-  GitLab:  set GITLAB_TOKEN=glpat-XXXXX before running
-
-Package Manager Configs (automatic):
-  ~/.npmrc and ~/.bunfig.toml are mounted into the container automatically.
-  Scoped registries (e.g., FontAwesome Pro) just work.
-
-Examples:
-  npx create-claude-workspace docker
-  npx create-claude-workspace docker --max-iterations 20
-  npx create-claude-workspace docker --shell
-  npx create-claude-workspace docker --login
-`);
-}
-// ─── Docker installation ───
-function installDocker() {
-    if (IS_WIN) {
-        if (hasCmd('winget')) {
-            info('Installing Docker Desktop via winget...');
-            run('winget', ['install', '-e', '--id', 'Docker.DockerDesktop',
-                '--accept-package-agreements', '--accept-source-agreements']);
-            warn('Docker Desktop installed. Restart terminal, start Docker Desktop, re-run.');
-            process.exit(0);
-        }
-        if (hasCmd('choco')) {
-            info('Installing Docker Desktop via Chocolatey...');
-            run('choco', ['install', 'docker-desktop', '-y']);
-            warn('Docker Desktop installed. Restart terminal, start Docker Desktop, re-run.');
-            process.exit(0);
-        }
-        error('Docker not found. Install Docker Desktop:');
-        error('  https://docs.docker.com/desktop/install/windows-install/');
-        process.exit(1);
-    }
-    else if (IS_MAC) {
-        if (hasCmd('brew')) {
-            info('Installing Docker Desktop via Homebrew...');
-            run('brew', ['install', '--cask', 'docker']);
-            info('Start Docker Desktop from Applications, then re-run.');
-            process.exit(0);
-        }
-        error('Install Docker Desktop: https://docs.docker.com/desktop/install/mac-install/');
-        process.exit(1);
-    }
-    else {
-        info('Installing Docker via get.docker.com...');
-        const result = run('sh', ['-c', 'curl -fsSL https://get.docker.com | sh']);
-        if (result.status !== 0) {
-            error('Docker installation failed. Install manually: https://docs.docker.com/engine/install/');
-            process.exit(1);
-        }
-        run('sudo', ['usermod', '-aG', 'docker', process.env.USER || ''], { capture: true });
-        warn('You may need "newgrp docker" or re-login for group changes.');
-        info('Docker installed.');
-    }
-}
-function startDaemon() {
-    warn('Docker daemon not running. Starting...');
-    if (IS_WIN) {
-        const exe = join(process.env.ProgramFiles || 'C:\\Program Files', 'Docker', 'Docker', 'Docker Desktop.exe');
-        if (existsSync(exe)) {
-            const child = spawnSync(exe, [], { stdio: 'ignore', windowsHide: true });
-            if (child.error)
-                warn(`Could not start Docker Desktop: ${child.error.message}`);
-        }
-    }
-    else if (IS_MAC) {
-        run('open', ['-a', 'Docker'], { capture: true });
-    }
-    else {
-        run('sudo', ['systemctl', 'start', 'docker'], { capture: true });
-    }
-    info('Waiting for Docker daemon (up to 120s)...');
-    for (let i = 0; i < 60; i++) {
-        sleepSync(2000);
-        if (ok('docker', ['info']))
-            return;
-        if (i % 5 === 4)
-            console.log(`  ... waiting (${(i + 1) * 2}s)`);
-    }
-    error('Docker daemon not running. Start it manually and re-run.');
-    process.exit(1);
-}
-// ─── WSL2 memory check (Windows only) ───
-function checkWslMemory() {
-    const wslConfig = join(homedir(), '.wslconfig');
-    const totalMemGB = Math.round(totalmem() / (1024 ** 3));
-    if (!existsSync(wslConfig)) {
-        // No .wslconfig = WSL2 defaults (50% of host RAM on newer versions, or 8 GB on older)
-        if (totalMemGB > 16) {
-            warn(`No ~/.wslconfig found. WSL2 defaults to ~50% of host RAM (~${Math.round(totalMemGB / 2)} GB).`);
-            warn(`With ${totalMemGB} GB total RAM, Docker containers may OOM during heavy builds.`);
-            warn(`Create %USERPROFILE%\\.wslconfig to allocate more:`);
-            console.log('');
-            console.log(`  [wsl2]`);
-            console.log(`  memory=${Math.max(totalMemGB - 4, Math.round(totalMemGB * 0.75))}GB`);
-            console.log(`  swap=8GB`);
-            console.log('');
-            warn('Then restart WSL: wsl --shutdown');
-            console.log('');
-        }
-        return;
-    }
-    // Parse .wslconfig for memory= line
-    try {
-        const content = readFileSync(wslConfig, 'utf8');
-        const memMatch = content.match(/^\s*memory\s*=\s*(\d+)\s*(GB|MB|G|M)?/mi);
-        if (memMatch) {
-            const value = parseInt(memMatch[1], 10);
-            const unit = (memMatch[2] || 'GB').toUpperCase();
-            const memGB = unit.startsWith('M') ? value / 1024 : value;
-            if (memGB < totalMemGB * 0.6) {
-                warn(`WSL2 memory limited to ${memGB} GB (host has ${totalMemGB} GB).`);
-                warn(`Increase memory in %USERPROFILE%\\.wslconfig for heavy builds:`);
-                console.log(`  memory=${Math.max(totalMemGB - 4, Math.round(totalMemGB * 0.75))}GB`);
-                console.log('');
-            }
-        }
-    }
-    catch { /* ignore read errors */ }
-}
-// ─── Main ───
-async function main() {
-    const opts = parseArgs();
-    if (opts.help) {
-        printHelp();
-        process.exit(0);
-    }
-    console.log(`\n${C.c}╔══════════════════════════════════════════╗${C.n}`);
-    console.log(`${C.c}║   Claude Starter Kit — Docker Runner     ║${C.n}`);
-    console.log(`${C.c}╚══════════════════════════════════════════╝${C.n}\n`);
-    // 1. Docker
-    step('1/4 Checking Docker...');
-    if (!hasCmd('docker'))
-        installDocker();
-    if (!ok('docker', ['info']))
-        startDaemon();
-    info('Docker is ready.');
-    // WSL2 memory check — warn if default limit may cause OOM crashes
-    if (IS_WIN) {
-        checkWslMemory();
-    }
-    // 2. Build
-    step('2/4 Building container image...');
-    // Always use --pull to pick up base image updates; --no-cache only on explicit --rebuild
-    const buildArgs = opts.rebuild ? ['build', '--no-cache', '--pull'] : ['build', '--pull', '-q'];
-    const buildResult = compose(buildArgs);
-    if (buildResult.status !== 0) {
-        error('Docker image build failed. Fix the errors above and re-run.');
-        process.exit(1);
-    }
-    info('Image built.');
-    // 3. Auth
-    step('3/4 Setting up authentication...');
-    if (process.env.ANTHROPIC_API_KEY) {
-        info('Using ANTHROPIC_API_KEY from environment.');
-    }
-    else {
-        if (opts.login) {
-            if (hasCmd('claude')) {
-                info("Running 'claude auth login' on host...");
-                run('claude', ['auth', 'login']);
-            }
-            else {
-                error('Claude CLI not found on host. Install it first:');
-                console.log('  npm i -g @anthropic-ai/claude-code');
-                console.log('  claude auth login');
-                console.log('');
-                console.log('Or use an API key:');
-                console.log('  ANTHROPIC_API_KEY=sk-... npx create-claude-workspace docker');
-                process.exit(1);
-            }
-        }
-        const home = homedir();
-        const credentialsJson = join(home, '.claude', '.credentials.json');
-        if (existsSync(credentialsJson)) {
-            info('Mounting host Claude auth credentials into container.');
-            // NOT :ro — Claude CLI needs to write refreshed OAuth tokens back to this file
-            const vols = [`      - ${toDockerPath(credentialsJson)}:/home/claude/.claude/.credentials.json`];
-            // Mount package manager configs from host home (scoped registries, auth tokens)
-            const hostNpmrc = join(home, '.npmrc');
-            const hostBunfig = join(home, '.bunfig.toml');
-            if (existsSync(hostNpmrc)) {
-                info('Mounting host ~/.npmrc into container.');
-                vols.push(`      - ${toDockerPath(hostNpmrc)}:/home/claude/.npmrc:ro`);
-            }
-            if (existsSync(hostBunfig)) {
-                info('Mounting host ~/.bunfig.toml into container.');
-                vols.push(`      - ${toDockerPath(hostBunfig)}:/home/claude/.bunfig.toml:ro`);
-            }
-            writeFileSync(AUTH_COMPOSE, `services:\n  claude:\n    volumes:\n${vols.join('\n')}\n`);
-        }
-        else {
-            error('No Claude authentication found. Options:');
-            console.log('');
-            console.log('  Option 1 — Claude Max plan (OAuth):');
-            console.log('    npm i -g @anthropic-ai/claude-code');
-            console.log('    claude auth login');
-            console.log('    Then re-run this script.');
-            console.log('');
-            console.log('  Option 2 — API key:');
-            console.log('    ANTHROPIC_API_KEY=sk-... npx create-claude-workspace docker');
-            console.log('');
-            console.log('  Option 3 — Use --login flag:');
-            console.log('    npx create-claude-workspace docker --login');
-            process.exit(1);
-        }
-    }
-    // 4. Interactive setup if project not initialized
-    const needsSetup = !existsSync(join(PROJECT_DIR, 'MEMORY.md'));
-    if (needsSetup && !opts.shell) {
-        step('4/5 Project not initialized — starting interactive setup...');
-        console.log('');
-        info('Answer the discovery questions to set up your project.');
-        info('This creates CLAUDE.md, PRODUCT.md, TODO.md, and MEMORY.md.');
-        info('After setup, the autonomous development loop starts automatically.');
-        console.log('');
-        const setupResult = compose(['run', '--rm', 'claude', '-c',
-            'claude --agent project-initializer --dangerously-skip-permissions "Initialize this project. First check if PLAN.md exists in the project root — if it does, use it as the primary source of information and only ask about details that are missing or unclear. If PLAN.md does not exist, start the full discovery conversation."']);
-        if (setupResult.status !== 0) {
-            warn('Setup exited with errors. Use --shell for manual setup.');
-            process.exit(1);
-        }
-        if (!existsSync(join(PROJECT_DIR, 'MEMORY.md'))) {
-            warn('Setup did not complete (MEMORY.md not found).');
-            warn('Run again or use --shell for manual setup.');
-            process.exit(1);
-        }
-        info('Setup complete. Starting autonomous development...');
-        console.log('');
-    }
-    // 5. Run
-    step(needsSetup ? '5/5 Starting Claude Code...' : '4/4 Starting Claude Code...');
-    if (opts.shell) {
-        console.log('');
-        info('Interactive shell. Examples:');
-        info('  claude                                              # interactive Claude');
-        info('  npx create-claude-workspace run                          # autonomous loop');
-        console.log('');
-        // Shell mode uses spawnSync (interactive TTY needed)
-        compose(['run', '--rm', 'claude']);
-    }
-    else {
-        const autoArgs = ['--skip-permissions'];
-        if (opts.maxIterations)
-            autoArgs.push('--max-iterations', opts.maxIterations);
-        if (opts.maxTurns)
-            autoArgs.push('--max-turns', opts.maxTurns);
-        if (opts.delay)
-            autoArgs.push('--delay', opts.delay);
-        if (opts.cooldown)
-            autoArgs.push('--cooldown', opts.cooldown);
-        if (opts.resumeSession)
-            autoArgs.push('--resume-session', opts.resumeSession);
-        // Shell-escape each arg to prevent injection from user-provided values
-        const escaped = autoArgs.map(a => /^[\w.=/-]+$/.test(a) ? a : `'${a.replace(/'/g, "'\\''")}'`);
-        console.log('');
-        info('Autonomous mode — isolated in Docker, --skip-permissions is safe.');
-        info('Press Ctrl+C to stop.');
-        console.log('');
-        // No -T flag — Docker allocates a TTY, which natively forwards Ctrl+C to the container.
-        // async spawn keeps the event loop alive so our SIGINT handler (docker compose kill) fires as backup.
-        const code = await composeAsync(['run', '--rm', 'claude', '-c', `exec npx -y create-claude-workspace run ${escaped.join(' ')}`]);
-        process.exit(code);
-    }
-}
-export { main as runDockerLoop, parseArgs, printHelp };
-// Run only when executed directly, not when imported
-const isDirectRun = process.argv[1]?.replace(/\\/g, '/').endsWith('docker-run.mjs');
-if (isDirectRun) {
-    main().catch(err => {
-        console.error('Fatal:', err);
-        process.exit(1);
-    });
-}

package/dist/scripts/integration.spec.js

@@ -1,108 +0,0 @@
-import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import { mkdirSync, rmSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
-import { resolve, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { query } from '@anthropic-ai/claude-agent-sdk';
-const TEST_DIR = resolve(dirname(fileURLToPath(import.meta.url)), '__integration_tmp__');
-beforeAll(() => {
-    mkdirSync(resolve(TEST_DIR, '.claude'), { recursive: true });
-    writeFileSync(resolve(TEST_DIR, 'hello.txt'), 'Hello from integration test!');
-    writeFileSync(resolve(TEST_DIR, 'package.json'), JSON.stringify({ name: 'test-project', version: '1.0.0' }));
-});
-afterAll(async () => {
-    // Wait briefly for Claude Code child processes to release file handles
-    await new Promise(r => setTimeout(r, 2000));
-    try {
-        rmSync(TEST_DIR, { recursive: true, force: true });
-    }
-    catch { /* Windows EPERM on locked files */ }
-});
-describe('Agent SDK integration', () => {
-    it('can read a file and respond', async () => {
-        let gotText = false;
-        let responseText = '';
-        for await (const message of query({
-            prompt: 'Read hello.txt and tell me what it says. Reply with just the file contents, nothing else.',
-            options: {
-                maxTurns: 5,
-                cwd: TEST_DIR,
-                allowedTools: ['Read'],
-                permissionMode: 'bypassPermissions',
-                allowDangerouslySkipPermissions: true,
-            },
-        })) {
-            if (message.type === 'assistant') {
-                const content = message.message?.content;
-                if (Array.isArray(content)) {
-                    for (const block of content) {
-                        if (block.type === 'text') {
-                            responseText += block.text;
-                            gotText = true;
-                        }
-                    }
-                }
-            }
-        }
-        expect(gotText).toBe(true);
-        expect(responseText).toContain('Hello from integration test');
-    }, 60_000);
-    it('can write a file', async () => {
-        const targetFile = resolve(TEST_DIR, 'created-by-agent.txt');
-        const absPath = targetFile.replace(/\\/g, '/');
-        for await (const _message of query({
-            prompt: `Write the text "Agent was here" to the file at this exact absolute path: ${absPath}`,
-            options: {
-                maxTurns: 5,
-                cwd: TEST_DIR,
-                allowedTools: ['Write'],
-                permissionMode: 'bypassPermissions',
-                allowDangerouslySkipPermissions: true,
-            },
-        })) {
-            // consume
-        }
-        expect(existsSync(targetFile)).toBe(true);
-        expect(readFileSync(targetFile, 'utf-8')).toContain('Agent was here');
-    }, 60_000);
-    it('can run a shell command', async () => {
-        let responseText = '';
-        for await (const message of query({
-            prompt: 'Run `cat package.json` and tell me the project name. Reply with just the name.',
-            options: {
-                maxTurns: 5,
-                cwd: TEST_DIR,
-                allowedTools: ['Bash'],
-                permissionMode: 'bypassPermissions',
-                allowDangerouslySkipPermissions: true,
-            },
-        })) {
-            if (message.type === 'assistant') {
-                const content = message.message?.content;
-                if (Array.isArray(content)) {
-                    for (const block of content) {
-                        if (block.type === 'text')
-                            responseText += block.text;
-                    }
-                }
-            }
-        }
-        expect(responseText).toContain('test-project');
-    }, 60_000);
-    it('respects maxTurns limit', async () => {
-        let messageCount = 0;
-        for await (const message of query({
-            prompt: 'List all files in the current directory, then read each one.',
-            options: {
-                maxTurns: 2,
-                cwd: TEST_DIR,
-                allowedTools: ['Read', 'Bash', 'Glob'],
-                permissionMode: 'bypassPermissions',
-                allowDangerouslySkipPermissions: true,
-            },
-        })) {
-            messageCount++;
-        }
-        // Should have completed (with or without finishing all files)
-        expect(messageCount).toBeGreaterThan(0);
-    }, 60_000);
-});