@samahlstrom/forge-cli 0.1.7 → 0.1.8

package/dist/commands/run.d.ts

@@ -0,0 +1,9 @@
+interface RunOptions {
+    dryRun?: boolean;
+    phase?: string;
+    concurrency?: string;
+    budget?: string;
+    review?: boolean;
+}
+export declare function run(specId: string, options: RunOptions): Promise<void>;
+export {};

package/dist/commands/run.js

@@ -0,0 +1,221 @@
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { join } from 'node:path';
+import { exists } from '../utils/fs.js';
+import { bdReady, bdClose, bdUpdate, bdList } from '../utils/bd.js';
+import { execaCommand } from 'execa';
+export async function run(specId, options) {
+    const cwd = process.cwd();
+    const concurrency = parseInt(options.concurrency ?? '1', 10);
+    const budget = options.budget ? parseFloat(options.budget) : undefined;
+    const reviewEnabled = options.review !== false;
+    p.intro(chalk.bold('forge run') + chalk.dim(` — ${specId}`));
+    // Verify spec exists
+    const specDir = join(cwd, '.forge', 'specs', specId);
+    if (!(await exists(join(specDir, 'spec.yaml')))) {
+        p.cancel(`No spec.yaml found. Run /ingest ${specId} first.`);
+        process.exit(1);
+    }
+    // Verify beads exist
+    let allTasks;
+    try {
+        allTasks = await bdList({ labels: [`spec:${specId}`], type: 'task' }, cwd);
+    }
+    catch {
+        p.cancel('Could not query beads. Is bd initialized? Run: forge seed ' + specId);
+        process.exit(1);
+    }
+    if (allTasks.length === 0) {
+        p.cancel(`No task beads found for ${specId}. Run: forge seed ${specId}`);
+        process.exit(1);
+    }
+    const openTasks = allTasks.filter(t => t.status === 'open' || t.status === 'in_progress');
+    p.log.info(`${chalk.cyan(String(openTasks.length))} tasks remaining out of ${allTasks.length} total`);
+    if (options.dryRun) {
+        await showDryRun(specId, cwd);
+        p.outro(chalk.dim('Dry run complete — no tasks executed.'));
+        return;
+    }
+    // Warn about permissions
+    p.log.warn(chalk.yellow('Auto-pilot mode uses --dangerously-skip-permissions for unattended execution.'));
+    const confirm = await p.confirm({
+        message: 'Continue?',
+        initialValue: true,
+    });
+    if (p.isCancel(confirm) || !confirm) {
+        p.cancel('Run cancelled.');
+        process.exit(0);
+    }
+    // Main orchestration loop
+    let completed = 0;
+    let failed = 0;
+    let currentPhase = '';
+    const startTime = Date.now();
+    while (true) {
+        // Get ready tasks
+        const labelFilters = [`spec:${specId}`];
+        if (options.phase)
+            labelFilters.push(`phase:${options.phase}`);
+        let readyTasks;
+        try {
+            readyTasks = await bdReady(labelFilters, cwd);
+        }
+        catch {
+            readyTasks = [];
+        }
+        if (readyTasks.length === 0) {
+            // Check if there are still open tasks (blocked)
+            const remaining = await bdList({ labels: [`spec:${specId}`], type: 'task', status: 'open' }, cwd);
+            if (remaining.length === 0)
+                break; // All done
+            // Try closing eligible epics to unblock next phase
+            try {
+                await execaCommand('bd epic close-eligible', { shell: true, cwd, timeout: 10000 });
+            }
+            catch { /* ignore */ }
+            // Re-check ready tasks after epic closing
+            try {
+                readyTasks = await bdReady(labelFilters, cwd);
+            }
+            catch {
+                readyTasks = [];
+            }
+            if (readyTasks.length === 0) {
+                // Phase boundary or deadlock
+                if (reviewEnabled) {
+                    const elapsed = formatElapsed(Date.now() - startTime);
+                    p.log.info(`\n${chalk.bold('Phase checkpoint')} — ${completed} completed, ${failed} failed, ${remaining.length} remaining (${elapsed})`);
+                    const cont = await p.confirm({
+                        message: `${remaining.length} tasks blocked. Continue waiting for unblock?`,
+                        initialValue: false,
+                    });
+                    if (p.isCancel(cont) || !cont)
+                        break;
+                }
+                else {
+                    break; // No review mode, just stop
+                }
+            }
+        }
+        if (readyTasks.length === 0)
+            continue;
+        // Detect phase transition
+        const taskPhase = readyTasks[0].labels?.find(l => l.startsWith('phase:')) ?? '';
+        if (taskPhase !== currentPhase) {
+            if (currentPhase && reviewEnabled) {
+                p.log.success(`\n${chalk.bold('Phase complete:')} ${currentPhase}`);
+                const cont = await p.confirm({
+                    message: `Start ${taskPhase}?`,
+                    initialValue: true,
+                });
+                if (p.isCancel(cont) || !cont)
+                    break;
+            }
+            currentPhase = taskPhase;
+            p.log.step(chalk.bold(`\nStarting ${currentPhase}`));
+        }
+        // Pick tasks up to concurrency limit
+        const batch = readyTasks.slice(0, concurrency);
+        // Execute batch
+        const results = await Promise.allSettled(batch.map(task => executeTask(task, specId, cwd, budget)));
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            const task = batch[i];
+            if (result.status === 'fulfilled' && result.value) {
+                completed++;
+                p.log.success(`${chalk.green('✓')} ${task.title}`);
+                try {
+                    await bdClose(task.id, cwd);
+                }
+                catch (err) {
+                    p.log.warn(`Failed to close ${task.id}: ${err}`);
+                }
+            }
+            else {
+                failed++;
+                const reason = result.status === 'rejected' ? result.reason : 'Task returned failure';
+                p.log.error(`${chalk.red('✗')} ${task.title}: ${reason}`);
+                try {
+                    await bdUpdate(task.id, { status: 'open' }, cwd);
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    // Final summary
+    const elapsed = formatElapsed(Date.now() - startTime);
+    const summaryLines = [
+        `Completed:  ${chalk.green(String(completed))}`,
+        `Failed:     ${failed > 0 ? chalk.red(String(failed)) : chalk.dim('0')}`,
+        `Elapsed:    ${chalk.cyan(elapsed)}`,
+    ];
+    p.note(summaryLines.join('\n'), 'Run complete');
+    p.outro(chalk.green('Done.'));
+}
+async function executeTask(task, specId, cwd, budget) {
+    const tier = task.labels?.find(l => l.startsWith('tier:'))?.replace('tier:', '') ?? 'T2';
+    const agent = task.labels?.find(l => l.startsWith('agent:'))?.replace('agent:', '') ?? '';
+    const filesLikely = task.metadata?.files_likely;
+    const specTaskId = task.metadata?.spec_task_id;
+    const filesStr = filesLikely?.length ? ` Target files: ${filesLikely.join(', ')}.` : '';
+    const prompt = `/deliver "${task.title} — ${task.description ?? ''}.${filesStr} Risk: ${tier}. Agent: ${agent}. Spec ref: ${specTaskId ?? task.id}"`;
+    const args = ['claude', '-p', '--dangerously-skip-permissions', '--output-format', 'json'];
+    if (budget)
+        args.push('--max-budget-usd', String(budget));
+    try {
+        // Write prompt to temp file to avoid shell escaping issues
+        const tmpFile = join('/tmp', `forge-run-${task.id}-${Date.now()}.txt`);
+        const { writeFile, unlink } = await import('node:fs/promises');
+        await writeFile(tmpFile, prompt);
+        try {
+            const result = await execaCommand(`cat "${tmpFile}" | ${args.join(' ')}`, { shell: true, cwd, timeout: 600000 });
+            // Parse result
+            let success = true;
+            try {
+                const parsed = JSON.parse(result.stdout);
+                if (parsed.is_error)
+                    success = false;
+            }
+            catch {
+                // Non-JSON output, assume success if exit code was 0
+            }
+            return success;
+        }
+        finally {
+            try {
+                const { unlink: ul } = await import('node:fs/promises');
+                await ul(tmpFile);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    catch (err) {
+        throw new Error(`claude -p failed: ${String(err)}`);
+    }
+}
+async function showDryRun(specId, cwd) {
+    const ready = await bdReady([`spec:${specId}`], cwd);
+    if (ready.length === 0) {
+        p.log.info('No ready tasks found.');
+        return;
+    }
+    p.log.step(`${ready.length} tasks ready to execute:`);
+    for (const task of ready) {
+        const tier = task.labels?.find(l => l.startsWith('tier:'))?.replace('tier:', '') ?? '?';
+        const phase = task.labels?.find(l => l.startsWith('phase:'))?.replace('phase:', '') ?? '?';
+        p.log.message(`  ${chalk.dim(`P${phase}`)} ${chalk.cyan(tier)} ${task.title}`);
+    }
+}
+function formatElapsed(ms) {
+    const secs = Math.floor(ms / 1000);
+    if (secs < 60)
+        return `${secs}s`;
+    const mins = Math.floor(secs / 60);
+    const remSecs = secs % 60;
+    if (mins < 60)
+        return `${mins}m ${remSecs}s`;
+    const hrs = Math.floor(mins / 60);
+    const remMins = mins % 60;
+    return `${hrs}h ${remMins}m`;
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/seed.d.ts

@@ -0,0 +1,5 @@
+interface SeedOptions {
+    force?: boolean;
+}
+export declare function seed(specId: string, options: SeedOptions): Promise<void>;
+export {};

package/dist/commands/seed.js

@@ -0,0 +1,57 @@
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { join } from 'node:path';
+import { exists } from '../utils/fs.js';
+import { seedBeads } from '../utils/seed-beads.js';
+import { bdCount } from '../utils/bd.js';
+export async function seed(specId, options) {
+    const cwd = process.cwd();
+    p.intro(chalk.bold('forge seed') + chalk.dim(` — ${specId}`));
+    const specDir = join(cwd, '.forge', 'specs', specId);
+    // Verify spec.yaml exists
+    const specYamlPath = join(specDir, 'spec.yaml');
+    if (!(await exists(specYamlPath))) {
+        p.cancel(`No spec.yaml found at ${specYamlPath}. Run /ingest ${specId} first.`);
+        process.exit(1);
+    }
+    // Check if beads already exist for this spec
+    try {
+        const existingCount = await bdCount({ labels: [`spec:${specId}`] }, cwd);
+        if (existingCount > 0 && !options.force) {
+            const overwrite = await p.confirm({
+                message: `${existingCount} beads already exist for ${specId}. Re-create?`,
+                initialValue: false,
+            });
+            if (p.isCancel(overwrite) || !overwrite) {
+                p.cancel('Seed cancelled.');
+                process.exit(0);
+            }
+        }
+    }
+    catch {
+        // bd not initialized or count failed — proceed
+    }
+    const spinner = p.spinner();
+    spinner.start('Creating beads from spec.yaml...');
+    try {
+        const result = await seedBeads(specDir, specId, cwd);
+        spinner.stop('Beads created');
+        const lines = [
+            `Phases:  ${chalk.cyan(String(result.phases))} epics`,
+            `Epics:   ${chalk.cyan(String(result.epics))} epics`,
+            `Tasks:   ${chalk.cyan(String(result.tasks))} tasks`,
+            `Deps:    ${chalk.cyan(String(result.links))} blocking links`,
+        ];
+        p.note(lines.join('\n'), 'Beads seeded');
+        p.log.step('Next:');
+        p.log.message(`  Run ${chalk.cyan(`forge run ${specId}`)} to start auto-pilot execution`);
+        p.log.message(`  Or ${chalk.cyan('bd ready')} to see what tasks are available`);
+    }
+    catch (err) {
+        spinner.stop('Seeding failed');
+        p.log.error(String(err));
+        process.exit(1);
+    }
+    p.outro(chalk.green('Ready to execute.'));
+}
+//# sourceMappingURL=seed.js.map

package/dist/commands/seed.js.map

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

package/dist/index.js

@@ -6,6 +6,8 @@ import { remove } from './commands/remove.js';
 import { upgrade } from './commands/upgrade.js';
 import { status } from './commands/status.js';
 import { doctor } from './commands/doctor.js';
+import { seed } from './commands/seed.js';
+import { run } from './commands/run.js';
 const program = new Command();
 program
     .name('forge')
@@ -47,5 +49,19 @@ program
     .command('doctor')
     .description('Diagnose harness health: check files, scripts, deps, and config')
     .action(doctor);
+program
+    .command('seed <spec-id>')
+    .description('Create beads (bd tasks) from an approved spec.yaml decomposition')
+    .option('--force', 'Re-create beads even if they already exist')
+    .action(seed);
+program
+    .command('run <spec-id>')
+    .description('Auto-pilot: orchestrate task execution from a seeded spec')
+    .option('--dry-run', 'Show execution plan without running')
+    .option('--phase <number>', 'Only execute tasks in a specific phase')
+    .option('--concurrency <number>', 'Max parallel tasks', '1')
+    .option('--budget <usd>', 'Max USD spend per task via claude -p')
+    .option('--no-review', 'Skip review gates between phases')
+    .action(run);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACL,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,2CAA2C,CAAC;KACxD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,mBAAmB,EAAE,0CAA0C,CAAC;KACvE,MAAM,CAAC,SAAS,EAAE,kCAAkC,CAAC;KACrD,MAAM,CAAC,OAAO,EAAE,uCAAuC,CAAC;KACxD,MAAM,CAAC,eAAe,EAAE,2DAA2D,CAAC;KACpF,MAAM,CAAC,IAAI,CAAC,CAAC;AAEf,OAAO;KACL,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0EAA0E,CAAC;KACvF,QAAQ,CAAC,YAAY,EAAE,8CAA8C,CAAC;KACtE,MAAM,CAAC,sBAAsB,EAAE,oCAAoC,EAAE,IAAI,CAAC;KAC1E,MAAM,CAAC,oBAAoB,EAAE,qCAAqC,CAAC;KACnE,MAAM,CAAC,MAAM,CAAC,CAAC;AAEjB,OAAO;KACL,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,qEAAqE,CAAC;KAClF,MAAM,CAAC,GAAG,CAAC,CAAC;AAEd,OAAO;KACL,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,2BAA2B,CAAC;KACxC,MAAM,CAAC,MAAM,CAAC,CAAC;AAEjB,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,wDAAwD,CAAC;KACrE,MAAM,CAAC,SAAS,EAAE,uCAAuC,CAAC;KAC1D,MAAM,CAAC,OAAO,CAAC,CAAC;AAElB,OAAO;KACL,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2DAA2D,CAAC;KACxE,MAAM,CAAC,MAAM,CAAC,CAAC;AAEjB,OAAO;KACL,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,MAAM,CAAC,CAAC;AAEjB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/bd.d.ts

@@ -0,0 +1,37 @@
+export interface BdIssue {
+    id: string;
+    title: string;
+    description: string;
+    status: string;
+    labels: string[];
+    priority: number;
+    parent?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface BdCreateOpts {
+    title: string;
+    description?: string;
+    type?: string;
+    labels?: string[];
+    parent?: string;
+    metadata?: Record<string, unknown>;
+    deps?: string[];
+}
+export declare function bdCreate(opts: BdCreateOpts, cwd?: string): Promise<string>;
+export declare function bdLink(from: string, to: string, type?: string, cwd?: string): Promise<void>;
+export declare function bdReady(labels?: string[], cwd?: string): Promise<BdIssue[]>;
+export declare function bdClose(id: string, cwd?: string): Promise<void>;
+export declare function bdUpdate(id: string, opts: {
+    assignee?: string;
+    labels?: string[];
+    status?: string;
+}, cwd?: string): Promise<void>;
+export declare function bdList(filters: {
+    labels?: string[];
+    type?: string;
+    status?: string;
+}, cwd?: string): Promise<BdIssue[]>;
+export declare function bdShow(id: string, cwd?: string): Promise<BdIssue>;
+export declare function bdCount(filters: {
+    labels?: string[];
+}, cwd?: string): Promise<number>;

package/dist/utils/bd.js

@@ -0,0 +1,81 @@
+import { execaCommand } from 'execa';
+export async function bdCreate(opts, cwd) {
+    const args = ['bd', 'create', JSON.stringify(opts.title)];
+    if (opts.description)
+        args.push('-d', JSON.stringify(opts.description));
+    if (opts.type)
+        args.push('-t', opts.type);
+    if (opts.labels?.length)
+        args.push('-l', opts.labels.join(','));
+    if (opts.parent)
+        args.push('--parent', opts.parent);
+    if (opts.metadata)
+        args.push('--metadata', JSON.stringify(JSON.stringify(opts.metadata)));
+    if (opts.deps?.length)
+        args.push('--deps', opts.deps.join(','));
+    args.push('--json');
+    const result = await execaCommand(args.join(' '), { shell: true, cwd, timeout: 15000 });
+    const parsed = JSON.parse(result.stdout);
+    return parsed.id ?? parsed.ID ?? parsed.issue_id ?? result.stdout.trim();
+}
+export async function bdLink(from, to, type = 'blocks', cwd) {
+    await execaCommand(`bd link ${from} ${to} --type ${type}`, { shell: true, cwd, timeout: 10000 });
+}
+export async function bdReady(labels, cwd) {
+    const args = ['bd', 'ready', '--json', '-n', '100'];
+    if (labels?.length)
+        args.push('-l', labels.join(','));
+    const result = await execaCommand(args.join(' '), { shell: true, cwd, timeout: 10000 });
+    if (!result.stdout.trim())
+        return [];
+    try {
+        const parsed = JSON.parse(result.stdout);
+        return Array.isArray(parsed) ? parsed : [parsed];
+    }
+    catch {
+        return [];
+    }
+}
+export async function bdClose(id, cwd) {
+    await execaCommand(`bd close ${id}`, { shell: true, cwd, timeout: 10000 });
+}
+export async function bdUpdate(id, opts, cwd) {
+    const args = ['bd', 'update', id];
+    if (opts.assignee)
+        args.push('-a', opts.assignee);
+    if (opts.status)
+        args.push('-s', opts.status);
+    args.push('--json');
+    await execaCommand(args.join(' '), { shell: true, cwd, timeout: 10000 });
+}
+export async function bdList(filters, cwd) {
+    const args = ['bd', 'list', '--json'];
+    if (filters.labels?.length)
+        args.push('-l', filters.labels.join(','));
+    if (filters.type)
+        args.push('-t', filters.type);
+    if (filters.status)
+        args.push('-s', filters.status);
+    const result = await execaCommand(args.join(' '), { shell: true, cwd, timeout: 10000 });
+    if (!result.stdout.trim())
+        return [];
+    try {
+        const parsed = JSON.parse(result.stdout);
+        return Array.isArray(parsed) ? parsed : [parsed];
+    }
+    catch {
+        return [];
+    }
+}
+export async function bdShow(id, cwd) {
+    const result = await execaCommand(`bd show ${id} --json`, { shell: true, cwd, timeout: 10000 });
+    return JSON.parse(result.stdout);
+}
+export async function bdCount(filters, cwd) {
+    const args = ['bd', 'count'];
+    if (filters.labels?.length)
+        args.push('-l', filters.labels.join(','));
+    const result = await execaCommand(args.join(' '), { shell: true, cwd, timeout: 10000 });
+    return parseInt(result.stdout.trim(), 10) || 0;
+}
+//# sourceMappingURL=bd.js.map

package/dist/utils/bd.js.map

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

package/dist/utils/seed-beads.d.ts

@@ -0,0 +1,8 @@
+export interface SeedResult {
+    phases: number;
+    epics: number;
+    tasks: number;
+    links: number;
+    taskMap: Record<string, string>;
+}
+export declare function seedBeads(specDir: string, specId: string, cwd?: string): Promise<SeedResult>;

package/dist/utils/seed-beads.js

@@ -0,0 +1,93 @@
+import { join } from 'node:path';
+import { readText } from './fs.js';
+import { bdCreate, bdLink } from './bd.js';
+export async function seedBeads(specDir, specId, cwd) {
+    const { parse } = await import('yaml');
+    const specContent = await readText(join(specDir, 'spec.yaml'));
+    const spec = parse(specContent);
+    const taskMap = {}; // spec task id -> bd id
+    const epicMap = {}; // spec epic id -> bd id
+    const phaseEpicIds = []; // bd ids for phase-level epics
+    let linkCount = 0;
+    const effectiveCwd = cwd ?? process.cwd();
+    // Create phase epics and their child epics + tasks
+    for (let pi = 0; pi < spec.execution_plan.phases.length; pi++) {
+        const phase = spec.execution_plan.phases[pi];
+        const phaseNum = pi + 1;
+        // Create phase-level epic
+        const phaseBeadId = await bdCreate({
+            title: `Phase ${phaseNum}: ${phase.name}`,
+            type: 'epic',
+            labels: [`spec:${specId}`, `phase:${phaseNum}`],
+            metadata: { spec_phase_id: phase.id, rationale: phase.rationale },
+        }, effectiveCwd);
+        phaseEpicIds.push(phaseBeadId);
+        // Phase ordering: phase N+1 is blocked by phase N
+        if (pi > 0) {
+            await bdLink(phaseBeadId, phaseEpicIds[pi - 1], 'blocks', effectiveCwd);
+            linkCount++;
+        }
+        // Create epics within this phase
+        for (const epicId of phase.epics) {
+            const epic = spec.epics.find(e => e.id === epicId);
+            if (!epic)
+                continue;
+            const epicBeadId = await bdCreate({
+                title: epic.title,
+                type: 'epic',
+                parent: phaseBeadId,
+                labels: [`spec:${specId}`, `phase:${phaseNum}`, `domain:${epic.domain}`],
+            }, effectiveCwd);
+            epicMap[epic.id] = epicBeadId;
+            // Create tasks for each feature in this epic
+            for (const feature of epic.features) {
+                for (const task of feature.tasks) {
+                    const taskBeadId = await bdCreate({
+                        title: task.title,
+                        description: task.description,
+                        parent: epicBeadId,
+                        labels: [
+                            `spec:${specId}`,
+                            `phase:${phaseNum}`,
+                            `tier:${task.risk_tier}`,
+                            `agent:${task.agent}`,
+                            `feature:${feature.id}`,
+                        ],
+                        metadata: {
+                            spec_task_id: task.id,
+                            files_likely: task.files_likely,
+                        },
+                    }, effectiveCwd);
+                    taskMap[task.id] = taskBeadId;
+                }
+            }
+        }
+    }
+    // Wire up task-level dependencies
+    for (const epic of spec.epics) {
+        for (const feature of epic.features) {
+            for (const task of feature.tasks) {
+                if (!task.dependencies?.length)
+                    continue;
+                const thisBeadId = taskMap[task.id];
+                if (!thisBeadId)
+                    continue;
+                for (const depId of task.dependencies) {
+                    const depBeadId = taskMap[depId];
+                    if (!depBeadId)
+                        continue;
+                    await bdLink(thisBeadId, depBeadId, 'blocks', effectiveCwd);
+                    linkCount++;
+                }
+            }
+        }
+    }
+    return {
+        phases: spec.execution_plan.phases.length,
+        epics: Object.keys(epicMap).length,
+        tasks: Object.keys(taskMap).length,
+        links: linkCount,
+        taskMap,
+    };
+}
+//# sourceMappingURL=seed-beads.js.map

package/dist/utils/seed-beads.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@samahlstrom/forge-cli",
-	"version": "0.1.7",
+	"version": "0.1.8",
 	"description": "Agent harness scaffolding for Claude Code — orchestration, decomposition, specialist agents, verification, and delivery.",
 	"type": "module",
 	"bin": {

package/templates/core/skill-ingest.md.hbs

@@ -201,36 +201,45 @@ After approval, for each skill identified in pass-4:
 
 Use the `/skill-creator` skill's patterns for writing good skill files.
 
-### Step 7: Execution Handoff
+### Step 7: Seed Beads
 
-After skills are generated, present the execution plan:
+After skills are generated, create beads for all tasks in the plan:
+
+1. Run: `forge seed <spec-id>`
+2. This creates bd issues for every phase, epic, and task in spec.yaml
+3. Dependencies are wired so `bd ready` returns only unblocked tasks
+4. Report the counts to the user
+
+### Step 8: Execution Handoff
+
+After beads are seeded, present the execution plan:
 
 ```
 Ready to execute. How would you like to proceed?
 
-  1. Phase-by-phase (recommended) — execute one phase at a time with review gates
-  2. Full auto — execute all phases sequentially
-  3. Manual — I'll run /deliver for individual tasks myself
+  1. Auto-pilot (recommended) — run `forge run <spec-id>` to execute all tasks automatically
+  2. Phase-by-phase — run `forge run <spec-id> --phase 1` one phase at a time
+  3. Manual — I'll run /deliver for individual tasks myself, using `bd ready` to pick the next one
 ```
 
-**Phase-by-phase mode** (recommended):
-- For each phase, iterate through its epics and tasks in dependency order
-- For each task, construct a `/deliver` call with the task's description from spec.yaml
-- After each phase completes, update spec.yaml status and ask user to review before next phase
-- Parallelizable phases: tasks without inter-dependencies can be delivered concurrently via subagents
+**Auto-pilot mode** (recommended):
+- User exits Claude Code and runs `forge run <spec-id>` in the terminal
+- The orchestrator picks ready tasks via `bd ready`, invokes `claude -p` with `/deliver` for each
+- Pauses between phases for review (use `--no-review` to skip)
+- Each task runs in an isolated `claude -p` session to avoid context overflow
 
-**Constructing deliver calls from spec.yaml tasks**:
-```
-/deliver "<task.title> — <task.description>. Target files: <task.files_likely>. Risk: <task.risk_tier>. Spec ref: <task.id>"
-```
+**Manual mode**:
+- User runs `bd ready -l "spec:<spec-id>"` to see available tasks
+- Picks a task and runs `/deliver` with its description
+- Closes the bead with `bd close <id>` when done
 
 ### Resuming
 
 If the session is interrupted, the user can run `/ingest <spec-id>` again. Check `spec.yaml` status:
 - `pending-analysis`: start from pass 1
 - `draft`: show the review gate
-- `approved`: resume skill generation or execution
-- `in-progress`: find the last completed phase and resume from the next one
+- `approved`: resume skill generation, seeding, or execution
+- `in-progress`: run `forge run <spec-id>` to resume — it picks up where it left off via `bd ready`
 
 ## Output Protocol