@girardmedia/bootspring 2.1.3 → 2.2.1

package/cli/build.js

@@ -1,1442 +0,0 @@
-/**
- * Bootspring Build Command
- *
- * Dedicated build management commands:
- * - status: Check build progress
- * - pause: Pause the build loop
- * - resume: Resume the build loop
- * - task: Show current task
- * - skip: Skip current task
- * - plan: View full plan
- * - reset: Reset build state
- *
- * @package bootspring
- * @command build
- */
-
-const path = require('path');
-const fs = require('fs');
-const config = require('../core/config');
-const utils = require('../core/utils');
-const buildState = require('../core/build-state');
-const { BuildOrchestrator } = require('../core/build-orchestrator');
-
-// Colors
-const c = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  green: '\x1b[32m',
-  blue: '\x1b[34m',
-  yellow: '\x1b[33m',
-  cyan: '\x1b[36m',
-  red: '\x1b[31m',
-  magenta: '\x1b[35m'
-};
-
-const PRESEED_DOC_FILES = [
-  'VISION.md',
-  'AUDIENCE.md',
-  'MARKET.md',
-  'COMPETITORS.md',
-  'BUSINESS_MODEL.md',
-  'PRD.md',
-  'TECHNICAL_SPEC.md',
-  'ROADMAP.md'
-];
-
-/**
- * Detect if the project root contains an existing codebase
- */
-function isExistingCodebase(projectRoot) {
-  const indicators = [
-    'package.json', 'Cargo.toml', 'go.mod', 'requirements.txt',
-    'pyproject.toml', 'Gemfile', 'pom.xml', 'build.gradle', 'composer.json', '.git'
-  ];
-  const srcDirs = ['src', 'lib', 'app', 'pages', 'components'];
-
-  for (const indicator of indicators) {
-    if (fs.existsSync(path.join(projectRoot, indicator))) return true;
-  }
-  for (const dir of srcDirs) {
-    const dirPath = path.join(projectRoot, dir);
-    if (fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory()) return true;
-  }
-  return false;
-}
-
-/**
- * Get the appropriate preseed command suggestion
- */
-function getPreseedSuggestion(projectRoot) {
-  return isExistingCodebase(projectRoot) ? 'bootspring preseed codebase' : 'bootspring preseed start';
-}
-
-function resolveBooleanFlag(value, defaultValue) {
-  if (typeof value === 'boolean') return value;
-  if (typeof value === 'string') {
-    const normalized = value.trim().toLowerCase();
-    if (['true', '1', 'yes', 'on'].includes(normalized)) return true;
-    if (['false', '0', 'no', 'off'].includes(normalized)) return false;
-  }
-  return defaultValue;
-}
-
-function countPreseedDocsInDir(dirPath) {
-  return PRESEED_DOC_FILES.filter(file => fs.existsSync(path.join(dirPath, file))).length;
-}
-
-function copyPlanningPreseedDocs(projectRoot, options = {}) {
-  const planningDir = path.join(projectRoot, 'planning');
-  const preseedDir = path.join(projectRoot, '.bootspring', 'preseed');
-
-  if (!fs.existsSync(planningDir)) return 0;
-
-  if (!fs.existsSync(preseedDir)) {
-    fs.mkdirSync(preseedDir, { recursive: true });
-  }
-
-  const overwrite = options.overwrite === true;
-  let copied = 0;
-
-  for (const file of PRESEED_DOC_FILES) {
-    const source = path.join(planningDir, file);
-    const target = path.join(preseedDir, file);
-    if (!fs.existsSync(source)) continue;
-    if (!overwrite && fs.existsSync(target)) continue;
-    fs.copyFileSync(source, target);
-    copied++;
-  }
-
-  return copied;
-}
-
-/**
- * Main run function - Interactive by default
- * @param {array} args - Command arguments
- */
-async function run(args) {
-  const parsedArgs = utils.parseArgs(args);
-  const subcommand = parsedArgs._[0];
-
-  const cfg = config.load();
-  const projectRoot = cfg._projectRoot;
-
-  // If no subcommand, run interactive mode
-  if (!subcommand) {
-    return interactiveBuild(projectRoot, parsedArgs);
-  }
-
-  // Advanced users can use subcommands directly
-  switch (subcommand) {
-    case 'status':
-      return showBuildStatus(projectRoot, parsedArgs);
-
-    case 'pause':
-      return pauseBuildLoop(projectRoot);
-
-    case 'stop':
-      return gracefulStop(projectRoot);
-
-    case 'resume':
-    case 'continue':
-      return resumeBuildLoop(projectRoot);
-
-    case 'task':
-      return showCurrentTask(projectRoot, parsedArgs);
-
-    case 'skip':
-      return skipCurrentTask(projectRoot, parsedArgs);
-
-    case 'plan':
-      return showPlan(projectRoot);
-
-    case 'reset':
-      return resetBuild(projectRoot, parsedArgs);
-
-    case 'next':
-      return buildNextTask(projectRoot, parsedArgs);
-
-    case 'done':
-    case 'complete':
-      return markTaskDone(projectRoot, parsedArgs);
-
-    case 'loop':
-    case 'all':
-      return buildLoop(projectRoot, parsedArgs);
-
-    case 'migrate-todo':
-    case 'migrate':
-      return migrateTodoFormat(projectRoot, parsedArgs);
-
-    case 'backfill':
-    case 'recover':
-    case 'hydrate':
-    case 'bootstrap':
-      return backfillBuildArtifacts(projectRoot, parsedArgs);
-
-    case 'help':
-    case '-h':
-    case '--help':
-      return showHelp();
-
-    default:
-      console.log(`${c.red}Unknown subcommand: ${subcommand}${c.reset}`);
-      showHelp();
-  }
-}
-
-/**
- * Interactive build mode - guides user through options
- */
-async function interactiveBuild(projectRoot, args = {}) {
-  const state = buildState.load(projectRoot);
-
-  console.log(`
-${c.cyan}${c.bold}Bootspring Build${c.reset}
-`);
-
-  // No build state - offer to initialize
-  if (!state) {
-    console.log(`${c.yellow}No build found.${c.reset}
-
-This will:
-  1. Extract tasks from your seed documents
-  2. Create a build plan in /planning
-  3. Guide you through building your MVP
-
-`);
-
-    const answer = await askQuestion('Initialize build from seed docs? [Y/n] ');
-
-    if (answer.toLowerCase() === 'n') {
-      console.log(`\n${c.dim}Run '${getPreseedSuggestion(projectRoot)}' first if you haven't set up seed docs.${c.reset}\n`);
-      return;
-    }
-
-    // Initialize build
-    const { BuildOrchestrator } = require('../core/build-orchestrator');
-    const orchestrator = new BuildOrchestrator(projectRoot);
-    const spinner = utils.createSpinner('Analyzing seed documents...').start();
-
-    const result = await orchestrator.initialize();
-
-    if (!result.success) {
-      spinner.fail(result.error);
-      return;
-    }
-
-    spinner.succeed(`Found ${result.taskCount} tasks to build`);
-    console.log('');
-
-    // Continue to show options
-    return interactiveBuild(projectRoot, args);
-  }
-
-  // Show current progress
-  const stats = buildState.getStats(projectRoot);
-  const nextTask = buildState.getNextTask(projectRoot);
-
-  // Progress bar
-  const barWidth = 30;
-  const filled = Math.round((stats.progress / 100) * barWidth);
-  const bar = '█'.repeat(filled) + '░'.repeat(barWidth - filled);
-  const progressColor = stats.progress === 100 ? c.green : stats.progress > 50 ? c.cyan : c.yellow;
-
-  console.log(`${c.bold}${state.projectName}${c.reset}
-
-  Progress: [${progressColor}${bar}${c.reset}] ${stats.progress}%
-  Tasks: ${c.green}${stats.completed}${c.reset} done, ${stats.pending} remaining
-  Phase: ${formatPhaseName(state.currentPhase)}
-`);
-
-  // All done!
-  if (!nextTask) {
-    if (stats.completed === stats.total) {
-      console.log(`${c.green}${c.bold}All tasks complete! Your MVP is ready.${c.reset}
-
-Next steps:
-  ${c.cyan}npm run dev${c.reset}     Start development server
-  ${c.cyan}npm run build${c.reset}   Build for production
-  ${c.cyan}bootspring deploy${c.reset}  Deploy to production
-`);
-    } else {
-      console.log(`${c.yellow}No pending tasks available.${c.reset}
-Some tasks may be blocked. Run ${c.cyan}bootspring build status${c.reset} for details.
-`);
-    }
-    return;
-  }
-
-  // Show next task
-  console.log(`${c.bold}Next Task:${c.reset}
-  ${nextTask.title}
-  ${c.dim}${nextTask.source || ''}${c.reset}
-`);
-
-  // Show options
-  console.log(`${c.bold}What would you like to do?${c.reset}
-
-  ${c.cyan}1${c.reset}  Start this task (shows prompt for Claude Code)
-  ${c.cyan}2${c.reset}  Loop all tasks (autonomous - runs Claude until complete)
-  ${c.cyan}3${c.reset}  View task details
-  ${c.cyan}4${c.reset}  Skip this task
-  ${c.cyan}5${c.reset}  View full plan
-  ${c.cyan}q${c.reset}  Quit
-`);
-
-  const choice = await askQuestion('Choose [1-5, q]: ');
-
-  switch (choice.trim()) {
-    case '1':
-    case '':
-      return buildNextTask(projectRoot, args);
-
-    case '2':
-      return buildLoop(projectRoot, args);
-
-    case '3':
-      showCurrentTask(projectRoot, { prompt: true });
-      console.log('');
-      return interactiveBuild(projectRoot, args);
-
-    case '4': {
-      const reason = await askQuestion('Skip reason (optional): ');
-      skipCurrentTask(projectRoot, { reason: reason || 'Skipped by user' });
-      return interactiveBuild(projectRoot, args);
-    }
-
-    case '5':
-      showPlan(projectRoot);
-      return interactiveBuild(projectRoot, args);
-
-    case 'q':
-    case 'Q':
-      console.log(`\n${c.dim}Run 'bootspring build' anytime to continue.${c.reset}\n`);
-      return;
-
-    default:
-      console.log(`${c.yellow}Invalid choice. Please try again.${c.reset}\n`);
-      return interactiveBuild(projectRoot, args);
-  }
-}
-
-/**
- * Build the next task - writes to CURRENT_TASK.md for Claude Code
- */
-async function buildNextTask(projectRoot, _args = {}) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found. Run 'bootspring build' to start.${c.reset}`);
-    return;
-  }
-
-  const nextTask = buildState.getNextTask(projectRoot);
-
-  if (!nextTask) {
-    console.log(`${c.green}All tasks complete!${c.reset}`);
-    return;
-  }
-
-  // Mark task as in progress
-  const startedTask = buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
-  if (!startedTask) {
-    console.log(`${c.red}Failed to update build state. Could not mark ${nextTask.id} as in progress.${c.reset}`);
-    return;
-  }
-
-  console.log(`
-${c.green}${c.bold}✓ Task ${nextTask.id} now in progress${c.reset}
-
-${c.bold}Task:${c.reset} ${nextTask.title}
-${c.bold}Phase:${c.reset} ${nextTask.phase || 'MVP'}
-${c.bold}Source:${c.reset} ${nextTask.source || 'PRD.md'}
-
-${c.cyan}${c.bold}Tell Claude Code:${c.reset}
-  "Read planning/TODO.md, find ${nextTask.id}, and implement it"
-
-${c.dim}When done, run: bootspring build done${c.reset}
-`);
-}
-
-
-/**
- * Generate a prompt for Claude Code to execute
- */
-function _generateTaskPrompt(task, _projectRoot) {
-  const lines = [];
-
-  lines.push(`**Objective:** ${task.title}`);
-  lines.push('');
-
-  if (task.description) {
-    lines.push('**Description:**');
-    lines.push(task.description);
-    lines.push('');
-  }
-
-  if (task.acceptanceCriteria && task.acceptanceCriteria.length > 0) {
-    lines.push('**Acceptance Criteria:**');
-    task.acceptanceCriteria.forEach(ac => {
-      lines.push(`- [ ] ${ac}`);
-    });
-    lines.push('');
-  }
-
-  if (task.sourceSection) {
-    lines.push(`**Source:** ${task.source} - ${task.sourceSection}`);
-    lines.push('');
-  }
-
-  lines.push('**Instructions:**');
-  lines.push('1. Implement the task as described above');
-  lines.push('2. Ensure all acceptance criteria are met');
-  lines.push('3. Test your implementation');
-  lines.push('4. When done, run: bootspring build done');
-
-  return lines.join('\n');
-}
-
-/**
- * Mark current task as done and auto-queue next
- */
-async function markTaskDone(projectRoot, _args = {}) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found.${c.reset}`);
-    return;
-  }
-
-  // Find in-progress task
-  const inProgressTask = state.implementationQueue.find(t => t.status === 'in_progress');
-
-  if (!inProgressTask) {
-    console.log(`${c.yellow}No task currently in progress.${c.reset}`);
-    return;
-  }
-
-  // Mark as complete
-  const completedTask = buildState.updateProgress(projectRoot, inProgressTask.id, 'completed');
-  if (!completedTask) {
-    console.log(`${c.red}Failed to update build state. Could not mark ${inProgressTask.id} as completed.${c.reset}`);
-    return;
-  }
-
-  console.log(`${c.green}✓${c.reset} Completed: ${c.bold}${inProgressTask.title}${c.reset}`);
-
-  // Check if loop mode is active - if so, commit and push
-  const loopState = loadLoopState(projectRoot);
-  if (loopState && loopState.active) {
-    await commitAndPush(projectRoot, inProgressTask, {
-      noCommit: loopState.noCommit,
-      noPush: loopState.noPush
-    });
-  }
-
-  // Get stats
-  const stats = buildState.getStats(projectRoot);
-  if (!stats) {
-    console.log(`${c.red}Failed to load build stats after updating task status.${c.reset}`);
-    return;
-  }
-  console.log(`${c.dim}Progress: ${stats.completed}/${stats.total} tasks (${Math.round(stats.completedPercent)}%)${c.reset}`);
-
-  // Auto-queue next task
-  const nextTask = buildState.getNextTask(projectRoot);
-
-  if (nextTask) {
-    // Mark as in progress
-    const queuedTask = buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
-    if (!queuedTask) {
-      console.log(`${c.red}Failed to update build state. Could not queue ${nextTask.id} as in progress.${c.reset}`);
-      return;
-    }
-
-    // Update loop state with new task
-    if (loopState && loopState.active) {
-      saveLoopState(projectRoot, {
-        ...loopState,
-        currentTaskId: nextTask.id,
-        lastTaskCompletedAt: new Date().toISOString()
-      });
-    }
-
-    console.log(`
-${c.cyan}${c.bold}▶ Next: ${nextTask.title}${c.reset} (${nextTask.id})
-
-${c.bold}Continue building:${c.reset} Read planning/TODO.md, implement ${nextTask.id}
-${c.dim}Then run: bootspring build done${c.reset}
-`);
-  } else {
-    // Clear loop state - build complete
-    if (loopState && loopState.active) {
-      saveLoopState(projectRoot, {
-        ...loopState,
-        active: false,
-        completedAt: new Date().toISOString()
-      });
-    }
-
-    console.log(`
-${c.green}${c.bold}🎉 MVP BUILD COMPLETE!${c.reset}
-
-All ${stats.total} tasks finished. Your MVP is ready.
-
-${c.bold}Next steps:${c.reset}
-  1. Review the generated code
-  2. Run tests: ${c.cyan}npm test${c.reset}
-  3. Deploy: ${c.cyan}bootspring deploy${c.reset}
-`);
-  }
-}
-
-/**
- * Build loop - autonomous task execution with commit/push after each task
- *
- * Usage:
- *   bootspring build loop              # Start/resume the loop
- *   bootspring build loop --no-push    # Commit but don't push
- *   bootspring build loop --no-commit  # No git operations
- */
-async function buildLoop(projectRoot, args = {}) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found. Run 'bootspring seed synthesize' first.${c.reset}`);
-    return;
-  }
-
-  const stats = buildState.getStats(projectRoot);
-  const noCommit = args['no-commit'] || args.noCommit;
-  const noPush = args['no-push'] || args.noPush || noCommit;
-
-  // Check for in-progress task (crash recovery)
-  const inProgress = state.implementationQueue.find(t => t.status === 'in_progress');
-
-  if (inProgress) {
-    console.log(`
-${c.yellow}${c.bold}⚠ Resuming from crash${c.reset}
-
-Found in-progress task: ${c.cyan}${inProgress.title}${c.reset} (${inProgress.id})
-
-${c.dim}This task was in progress when the loop stopped.
-Continue implementing it, then run 'bootspring build done'.${c.reset}
-`);
-  } else {
-    // Queue next task
-    const nextTask = buildState.getNextTask(projectRoot);
-    if (!nextTask) {
-      console.log(`${c.green}${c.bold}🎉 All tasks complete!${c.reset}`);
-      return;
-    }
-    const queuedTask = buildState.updateProgress(projectRoot, nextTask.id, 'in_progress');
-    if (!queuedTask) {
-      console.log(`${c.red}Failed to update build state. Could not queue ${nextTask.id} as in progress.${c.reset}`);
-      return;
-    }
-  }
-
-  const currentTask = state.implementationQueue.find(t => t.status === 'in_progress')
-    || buildState.getNextTask(projectRoot);
-
-  console.log(`
-${c.cyan}${c.bold}⚡ Bootspring Build Loop${c.reset}
-
-${c.bold}Current Task:${c.reset} ${currentTask?.title || 'None'} (${currentTask?.id || '-'})
-${c.bold}Progress:${c.reset} ${stats.completed}/${stats.total} tasks (${Math.round(stats.completedPercent)}%)
-${c.bold}Git Mode:${c.reset} ${noCommit ? 'Disabled' : noPush ? 'Commit only' : 'Commit + Push'}
-
-${c.bold}Workflow:${c.reset}
-  1. Read planning/TODO.md, find ${currentTask?.id || 'current task'}
-  2. Implement the task
-  3. Run: ${c.cyan}bootspring build done${c.reset}${!noCommit ? `
-     (Auto-commits: "feat(${currentTask?.id}): ${currentTask?.title?.slice(0, 40) || 'task'}...")${!noPush ? `
-     (Auto-pushes to origin)` : ''}` : ''}
-  4. Continue to next task...
-
-${c.dim}Press Ctrl+C to stop. Run 'bootspring build loop' to resume.${c.reset}
-`);
-
-  // Save loop state for crash recovery
-  saveLoopState(projectRoot, {
-    active: true,
-    startedAt: new Date().toISOString(),
-    noCommit,
-    noPush
-  });
-}
-
-/**
- * Save loop state for crash recovery
- */
-function saveLoopState(projectRoot, state) {
-  const loopFile = path.join(projectRoot, '.bootspring', 'loop-state.json');
-  const dir = path.dirname(loopFile);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  fs.writeFileSync(loopFile, JSON.stringify(state, null, 2));
-}
-
-/**
- * Load loop state
- */
-function loadLoopState(projectRoot) {
-  const loopFile = path.join(projectRoot, '.bootspring', 'loop-state.json');
-  if (fs.existsSync(loopFile)) {
-    try {
-      return JSON.parse(fs.readFileSync(loopFile, 'utf-8'));
-    } catch {
-      return null;
-    }
-  }
-  return null;
-}
-
-/**
- * Clear loop state (used when stopping or completing)
- */
-function _clearLoopState(projectRoot) {
-  const loopFile = path.join(projectRoot, '.bootspring', 'loop-state.json');
-  if (fs.existsSync(loopFile)) {
-    fs.unlinkSync(loopFile);
-  }
-}
-
-/**
- * Commit and push changes for a completed task
- */
-async function commitAndPush(projectRoot, task, options = {}) {
-  const { noCommit, noPush } = options;
-
-  if (noCommit) return { committed: false, pushed: false };
-
-  const { execSync } = require('child_process');
-
-  try {
-    // Check if there are changes to commit
-    const status = execSync('git status --porcelain', { cwd: projectRoot, encoding: 'utf-8' });
-    if (!status.trim()) {
-      console.log(`${c.dim}No changes to commit${c.reset}`);
-      return { committed: false, pushed: false };
-    }
-
-    // Stage all changes
-    execSync('git add -A', { cwd: projectRoot });
-
-    // Create commit message
-    const shortTitle = task.title.length > 50 ? task.title.slice(0, 47) + '...' : task.title;
-    const commitMsg = `feat(${task.id}): ${shortTitle}
-
-Task: ${task.title}
-Phase: ${task.phase || 'MVP'}
-Source: ${task.source || 'planning'}
-
-Acceptance Criteria:
-${(task.acceptanceCriteria || []).map(ac => `- [x] ${ac}`).join('\n')}
-
-Built with Bootspring autonomous loop.`;
-
-    // Commit
-    execSync(`git commit -m "${commitMsg.replace(/"/g, '\\"')}"`, { cwd: projectRoot });
-    console.log(`${c.green}✓${c.reset} Committed: ${c.bold}${task.id}${c.reset}`);
-
-    if (noPush) {
-      return { committed: true, pushed: false };
-    }
-
-    // Push
-    try {
-      execSync('git push', { cwd: projectRoot, stdio: 'pipe' });
-      console.log(`${c.green}✓${c.reset} Pushed to origin`);
-      return { committed: true, pushed: true };
-    } catch (pushError) {
-      console.log(`${c.yellow}⚠${c.reset} Push failed (commit saved locally): ${pushError.message}`);
-      return { committed: true, pushed: false };
-    }
-  } catch (error) {
-    console.log(`${c.yellow}⚠${c.reset} Git operation failed: ${error.message}`);
-    return { committed: false, pushed: false };
-  }
-}
-
-/**
- * Ask a question and get user input
- */
-function askQuestion(question) {
-  const readline = require('readline');
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  return new Promise(resolve => {
-    rl.question(question, answer => {
-      rl.close();
-      resolve(answer);
-    });
-  });
-}
-
-function loadLoopUsageSummary(projectRoot) {
-  const loopDir = path.join(projectRoot, '.bootspring', 'loop');
-  const metricsPath = path.join(loopDir, 'metrics.json');
-  const sessionPath = path.join(loopDir, 'session-state.json');
-
-  if (!fs.existsSync(metricsPath) && !fs.existsSync(sessionPath)) {
-    return null;
-  }
-
-  let metrics = {};
-  let sessionState = {};
-
-  try {
-    if (fs.existsSync(metricsPath)) {
-      metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf-8'));
-    }
-    if (fs.existsSync(sessionPath)) {
-      sessionState = JSON.parse(fs.readFileSync(sessionPath, 'utf-8'));
-    }
-  } catch {
-    return null;
-  }
-
-  const apiCalls = Number(metrics.totalApiCalls ?? sessionState.usage?.apiCalls ?? 0);
-  const promptTokens = Number(metrics.totalPromptTokens ?? sessionState.usage?.promptTokens ?? 0);
-  const completionTokens = Number(metrics.totalCompletionTokens ?? sessionState.usage?.completionTokens ?? 0);
-  const totalTokens = Number(metrics.totalTokens ?? sessionState.usage?.totalTokens ?? 0);
-  const estimatedCostUsd = Number(metrics.estimatedCostUsd ?? sessionState.usage?.estimatedCostUsd ?? 0);
-
-  return {
-    apiCalls: Number.isFinite(apiCalls) ? apiCalls : 0,
-    promptTokens: Number.isFinite(promptTokens) ? promptTokens : 0,
-    completionTokens: Number.isFinite(completionTokens) ? completionTokens : 0,
-    totalTokens: Number.isFinite(totalTokens) ? totalTokens : 0,
-    estimatedCostUsd: Number.isFinite(estimatedCostUsd) ? estimatedCostUsd : 0,
-    budgetConfig: sessionState.budgetConfig || null
-  };
-}
-
-function formatUsd(amount) {
-  return `$${(Number(amount) || 0).toFixed(4)}`;
-}
-
-/**
- * Show build status
- */
-function showBuildStatus(projectRoot, _args = {}) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`
-${c.cyan}${c.bold}Build Status${c.reset}
-
-${c.yellow}No build state found.${c.reset}
-Run ${c.cyan}bootspring seed build${c.reset} to initialize the build system.
-`);
-    return;
-  }
-
-  const stats = buildState.getStats(projectRoot);
-  const loopUsage = loadLoopUsageSummary(projectRoot);
-
-  // Status icon
-  const statusIcon = {
-    pending: `${c.dim}○${c.reset}`,
-    in_progress: `${c.green}●${c.reset}`,
-    paused: `${c.yellow}◐${c.reset}`,
-    completed: `${c.green}✓${c.reset}`,
-    failed: `${c.red}✗${c.reset}`
-  }[state.status] || '?';
-
-  // Progress bar
-  const barWidth = 40;
-  const filled = Math.round((stats.progress / 100) * barWidth);
-  const bar = '█'.repeat(filled) + '░'.repeat(barWidth - filled);
-  const progressColor = stats.progress === 100 ? c.green :
-    stats.progress > 50 ? c.cyan : c.yellow;
-
-  console.log(`
-${c.cyan}${c.bold}Build Status${c.reset}
-
-${c.bold}Project:${c.reset} ${state.projectName}
-${c.bold}Status:${c.reset} ${statusIcon} ${state.status}
-${c.bold}Phase:${c.reset} ${formatPhaseName(state.currentPhase)}
-
-${c.bold}Progress${c.reset}
-  [${progressColor}${bar}${c.reset}] ${stats.progress}%
-
-${c.bold}Tasks${c.reset}
-  Total:       ${stats.total}
-  Completed:   ${c.green}${stats.completed}${c.reset}
-  In Progress: ${c.cyan}${stats.inProgress}${c.reset}
-  Pending:     ${stats.pending}
-  Blocked:     ${c.red}${stats.blocked}${c.reset}
-  Skipped:     ${c.dim}${stats.skipped}${c.reset}
-
-${c.bold}MVP Progress${c.reset}
-  ${stats.mvpProgress}% complete ${stats.mvpComplete ? `${c.green}✓ MVP Complete${c.reset}` : ''}
-
-${c.bold}Loop Session${c.reset}
-  Iteration: ${stats.iteration}/${stats.maxIterations}
-  Session ID: ${c.dim}${state.loopSession?.sessionId || 'N/A'}${c.reset}
-`);
-
-  if (loopUsage) {
-    console.log(`${c.bold}Loop Usage${c.reset}
-  API calls: ${loopUsage.apiCalls}
-  Tokens: ${loopUsage.totalTokens} (${loopUsage.promptTokens} in / ${loopUsage.completionTokens} out)
-  Est. cost: ${formatUsd(loopUsage.estimatedCostUsd)}
-  Budget stop (USD): ${loopUsage.budgetConfig?.maxUsd ? formatUsd(loopUsage.budgetConfig.maxUsd) : 'off'}
-  Budget stop (tokens): ${loopUsage.budgetConfig?.maxTokens || 'off'}
-`);
-  }
-
-  // Show next actions
-  showNextActions(state, stats);
-}
-
-/**
- * Show suggested next actions
- */
-function showNextActions(state, _stats) {
-  console.log(`${c.bold}Next Actions:${c.reset}`);
-
-  if (state.status === 'paused') {
-    console.log(`  ${c.cyan}1.${c.reset} Resume building     → ${c.dim}bootspring build resume${c.reset}`);
-    console.log(`  ${c.cyan}2.${c.reset} View current task   → ${c.dim}bootspring build task${c.reset}`);
-    console.log(`  ${c.cyan}3.${c.reset} View full plan      → ${c.dim}bootspring build plan${c.reset}`);
-  } else if (state.status === 'completed') {
-    console.log(`  ${c.green}Build complete!${c.reset} All tasks have been finished.`);
-    console.log(`  ${c.cyan}1.${c.reset} View summary        → ${c.dim}bootspring build plan${c.reset}`);
-    console.log(`  ${c.cyan}2.${c.reset} Deploy              → ${c.dim}bootspring deploy${c.reset}`);
-  } else if (state.status === 'failed') {
-    console.log(`  ${c.red}Build failed.${c.reset} Review errors and resume.`);
-    console.log(`  ${c.cyan}1.${c.reset} View current task   → ${c.dim}bootspring build task${c.reset}`);
-    console.log(`  ${c.cyan}2.${c.reset} Skip blocked task   → ${c.dim}bootspring build skip${c.reset}`);
-    console.log(`  ${c.cyan}3.${c.reset} Reset build         → ${c.dim}bootspring build reset${c.reset}`);
-  } else if (state.status === 'in_progress') {
-    console.log(`  ${c.cyan}Build in progress...${c.reset}`);
-    console.log(`  ${c.cyan}1.${c.reset} Pause building      → ${c.dim}bootspring build pause${c.reset}`);
-    console.log(`  ${c.cyan}2.${c.reset} View current task   → ${c.dim}bootspring build task${c.reset}`);
-  } else {
-    console.log(`  ${c.cyan}1.${c.reset} Start building      → ${c.dim}bootspring seed build --loop${c.reset}`);
-    console.log(`  ${c.cyan}2.${c.reset} View current task   → ${c.dim}bootspring build task${c.reset}`);
-    console.log(`  ${c.cyan}3.${c.reset} View full plan      → ${c.dim}bootspring build plan${c.reset}`);
-  }
-
-  console.log('');
-}
-
-/**
- * Pause the build loop
- */
-function pauseBuildLoop(projectRoot) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found.${c.reset}`);
-    return;
-  }
-
-  if (state.status !== 'in_progress') {
-    console.log(`${c.yellow}Build is not running (status: ${state.status})${c.reset}`);
-    return;
-  }
-
-  buildState.pause(projectRoot);
-
-  // Update loop state to inactive
-  const loopState = loadLoopState(projectRoot);
-  if (loopState) {
-    saveLoopState(projectRoot, {
-      ...loopState,
-      active: false,
-      pausedAt: new Date().toISOString()
-    });
-  }
-
-  console.log(`
-${c.green}Build paused.${c.reset}
-
-Resume with: ${c.cyan}bootspring build resume${c.reset}
-`);
-}
-
-/**
- * Resume the build loop
- */
-function resumeBuildLoop(projectRoot) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found.${c.reset}`);
-    console.log(`Initialize with: ${c.cyan}bootspring seed build${c.reset}`);
-    return;
-  }
-
-  if (state.status === 'completed') {
-    console.log(`${c.green}Build is already complete!${c.reset}`);
-    return;
-  }
-
-  if (state.status !== 'paused' && state.status !== 'pending') {
-    console.log(`${c.yellow}Build status: ${state.status}${c.reset}`);
-    console.log('Cannot resume from this state.');
-    return;
-  }
-
-  buildState.resume(projectRoot);
-
-  // Restore loop state if it exists
-  const loopState = loadLoopState(projectRoot);
-  if (loopState) {
-    saveLoopState(projectRoot, {
-      ...loopState,
-      active: true,
-      resumedAt: new Date().toISOString()
-    });
-  }
-
-  console.log(`
-${c.green}Build resumed.${c.reset}
-
-Continue with: ${c.cyan}bootspring build next${c.reset}
-Or run loop: ${c.cyan}bootspring build loop${c.reset}
-`);
-}
-
-/**
- * Graceful stop - finish current task then pause
- */
-function gracefulStop(projectRoot) {
-  console.log(`
-${c.yellow}${c.bold}Graceful stop requested${c.reset}
-
-The loop will pause after the current task completes.
-This ensures no work is interrupted mid-task.
-
-${c.dim}Waiting for current task to finish...${c.reset}
-`);
-
-  const bootspringDir = path.join(projectRoot, '.bootspring');
-  if (!fs.existsSync(bootspringDir)) {
-    fs.mkdirSync(bootspringDir, { recursive: true });
-  }
-  const stopFile = path.join(bootspringDir, 'STOP_AFTER_TASK');
-  fs.writeFileSync(stopFile, new Date().toISOString());
-}
-
-/**
- * Show current task
- */
-function showCurrentTask(projectRoot, args = {}) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found.${c.reset}`);
-    return;
-  }
-
-  const nextTask = buildState.getNextTask(projectRoot);
-
-  if (!nextTask) {
-    const stats = buildState.getStats(projectRoot);
-
-    if (stats.completed === stats.total) {
-      console.log(`
-${c.green}${c.bold}All tasks complete!${c.reset}
-
-${stats.completed} tasks have been completed.
-`);
-    } else {
-      console.log(`
-${c.yellow}No pending tasks available.${c.reset}
-
-${c.bold}Summary:${c.reset}
-  Completed: ${stats.completed}
-  Blocked: ${stats.blocked}
-  Skipped: ${stats.skipped}
-`);
-    }
-    return;
-  }
-
-  console.log(`
-${c.cyan}${c.bold}Current Task${c.reset}
-
-${c.bold}ID:${c.reset} ${nextTask.id}
-${c.bold}Title:${c.reset} ${nextTask.title}
-${c.bold}Phase:${c.reset} ${formatPhaseName(nextTask.phase)}
-${c.bold}Complexity:${c.reset} ${nextTask.estimatedComplexity || 'medium'}
-${c.bold}Source:${c.reset} ${nextTask.source || 'Manual'} ${nextTask.sourceSection ? `(${nextTask.sourceSection})` : ''}
-${c.bold}Status:${c.reset} ${nextTask.status}
-`);
-
-  if (nextTask.description) {
-    console.log(`${c.bold}Description:${c.reset}
-${nextTask.description}
-`);
-  }
-
-  if (nextTask.acceptanceCriteria && nextTask.acceptanceCriteria.length > 0) {
-    console.log(`${c.bold}Acceptance Criteria:${c.reset}`);
-    nextTask.acceptanceCriteria.forEach((criteria, i) => {
-      console.log(`  ${c.dim}${i + 1}.${c.reset} ${criteria}`);
-    });
-    console.log('');
-  }
-
-  if (nextTask.dependencies && nextTask.dependencies.length > 0) {
-    console.log(`${c.bold}Dependencies:${c.reset} ${nextTask.dependencies.join(', ')}`);
-    console.log('');
-  }
-
-  // Show prompt generation option
-  if (args.prompt) {
-    const orchestrator = new BuildOrchestrator(projectRoot);
-    const prompt = orchestrator.generateTaskPrompt(nextTask);
-    console.log(`${c.bold}Generated Prompt:${c.reset}`);
-    console.log(c.dim + '─'.repeat(60) + c.reset);
-    console.log(prompt);
-    console.log(c.dim + '─'.repeat(60) + c.reset);
-  } else {
-    console.log(`${c.dim}Use --prompt to generate AI prompt for this task${c.reset}`);
-  }
-}
-
-/**
- * Skip current task
- */
-function skipCurrentTask(projectRoot, args = {}) {
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found.${c.reset}`);
-    return;
-  }
-
-  const nextTask = buildState.getNextTask(projectRoot);
-
-  if (!nextTask) {
-    console.log(`${c.yellow}No pending tasks to skip.${c.reset}`);
-    return;
-  }
-
-  const reason = args.reason || args._[1] || 'Manually skipped';
-
-  const skippedTask = buildState.updateProgress(projectRoot, nextTask.id, 'skipped', {
-    error: reason
-  });
-  if (!skippedTask) {
-    console.log(`${c.red}Failed to update build state. Could not skip ${nextTask.id}.${c.reset}`);
-    return;
-  }
-
-  console.log(`
-${c.yellow}Skipped task: ${nextTask.title}${c.reset}
-Reason: ${reason}
-
-Next task: ${buildState.getNextTask(projectRoot)?.title || 'None remaining'}
-`);
-}
-
-/**
- * Show full plan
- */
-function showPlan(projectRoot) {
-  const planPath = path.join(projectRoot, 'planning', 'MASTER_PLAN.md');
-
-  if (!fs.existsSync(planPath)) {
-    console.log(`${c.yellow}No plan found.${c.reset}`);
-    console.log(`Initialize with: ${c.cyan}bootspring seed build${c.reset}`);
-    return;
-  }
-
-  const content = fs.readFileSync(planPath, 'utf-8');
-
-  // Print with formatting
-  console.log(`
-${c.cyan}${c.bold}Master Plan${c.reset}
-${c.dim}${planPath}${c.reset}
-
-${content}
-`);
-}
-
-/**
- * Reset build state
- */
-function resetBuild(projectRoot, args = {}) {
-  const force = args.force || args.f;
-
-  const state = buildState.load(projectRoot);
-
-  if (!state) {
-    console.log(`${c.yellow}No build state found.${c.reset}`);
-    return;
-  }
-
-  if (!force && state.status === 'in_progress') {
-    console.log(`${c.yellow}Build is in progress. Use --force to reset.${c.reset}`);
-    return;
-  }
-
-  buildState.reset(projectRoot);
-
-  console.log(`
-${c.green}Build state reset.${c.reset}
-
-Re-initialize with: ${c.cyan}bootspring seed build${c.reset}
-`);
-}
-
-/**
- * Format phase name for display
- */
-function formatPhaseName(phase) {
-  if (!phase) return 'Unknown';
-
-  const names = {
-    foundation: 'Foundation',
-    mvp: 'MVP',
-    launch: 'Launch',
-    other: 'Other'
-  };
-
-  return names[phase] || phase.charAt(0).toUpperCase() + phase.slice(1);
-}
-
-/**
- * Backfill preseed docs and planning queue artifacts for existing projects.
- */
-async function backfillBuildArtifacts(projectRoot, args = {}) {
-  const force = resolveBooleanFlag(args.force, false) || resolveBooleanFlag(args.f, false);
-  const deep = resolveBooleanFlag(args.deep, !(resolveBooleanFlag(args.quick, false) || resolveBooleanFlag(args.q, false)));
-  const auto = resolveBooleanFlag(args.auto, !(resolveBooleanFlag(args.interactive, false) || resolveBooleanFlag(args.i, false)));
-  const withOnboard = resolveBooleanFlag(args['with-onboard'], !(resolveBooleanFlag(args['no-onboard'], false) || resolveBooleanFlag(args.noOnboard, false)));
-
-  const preseedDir = path.join(projectRoot, '.bootspring', 'preseed');
-  const planningDir = path.join(projectRoot, 'planning');
-  const seedPath = path.join(projectRoot, 'SEED.md');
-  const queuePath = path.join(planningDir, 'TASK_QUEUE.md');
-
-  console.log(`
-${c.cyan}${c.bold}Backfilling Build Artifacts${c.reset}
-`);
-
-  let preseedCount = countPreseedDocsInDir(preseedDir);
-  const needsPreseed = force || preseedCount < PRESEED_DOC_FILES.length;
-  let generatedFromCodebase = false;
-
-  if (needsPreseed) {
-    const copied = copyPlanningPreseedDocs(projectRoot, { overwrite: force });
-    if (copied > 0) {
-      console.log(`${c.green}✓${c.reset} Imported ${copied} preseed documents from planning/`);
-    }
-
-    preseedCount = countPreseedDocsInDir(preseedDir);
-
-    if (force || preseedCount < PRESEED_DOC_FILES.length) {
-      let preseedRunner = null;
-      try {
-        preseedRunner = require('./preseed-from-codebase');
-      } catch {
-        console.log(`${c.yellow}Preseed backfill is not available in the public thin client.${c.reset}`);
-        console.log(`${c.dim}Restore preseed artifacts manually or use a full Bootspring setup to regenerate them.${c.reset}`);
-        return;
-      }
-      const beforeCount = preseedCount;
-      await preseedRunner.run({
-        _: [],
-        deep,
-        d: deep,
-        auto,
-        a: auto,
-        'with-onboard': withOnboard,
-        onboard: withOnboard
-      });
-
-      preseedCount = countPreseedDocsInDir(preseedDir);
-      generatedFromCodebase = preseedCount > beforeCount;
-    }
-  } else {
-    console.log(`${c.dim}Preseed already available (${preseedCount}/${PRESEED_DOC_FILES.length}).${c.reset}`);
-  }
-
-  const shouldSynthesizeSeed = force || generatedFromCodebase || !fs.existsSync(seedPath);
-  if (shouldSynthesizeSeed) {
-    let seedRunner = null;
-    try {
-      seedRunner = require('./seed');
-    } catch {
-      console.log(`${c.yellow}Seed synthesis is not available in the public thin client.${c.reset}`);
-      console.log(`${c.dim}Add SEED.md manually or use a full Bootspring setup to synthesize it.${c.reset}`);
-      return;
-    }
-    const synthArgs = ['synthesize'];
-    if (fs.existsSync(seedPath)) synthArgs.push('--force');
-
-    try {
-      await seedRunner.run(synthArgs);
-    } catch (error) {
-      if (!fs.existsSync(seedPath)) {
-        console.log(`${c.red}Failed to synthesize SEED.md: ${error.message}${c.reset}`);
-        return;
-      }
-      console.log(`${c.yellow}⚠ Could not refresh SEED.md, continuing with existing file.${c.reset}`);
-    }
-  } else {
-    console.log(`${c.dim}SEED.md already exists; skipping synthesis.${c.reset}`);
-  }
-
-  let state = buildState.load(projectRoot);
-  if (state) {
-    const orchestrator = new BuildOrchestrator(projectRoot);
-    orchestrator.updatePlanningFiles();
-    console.log(`${c.green}✓${c.reset} Regenerated planning/TASK_QUEUE.md from current build state`);
-  } else {
-    const orchestrator = new BuildOrchestrator(projectRoot);
-    const spinner = utils.createSpinner('Initializing build from recovered docs...').start();
-    const result = await orchestrator.initialize();
-    if (!result.success) {
-      spinner.fail(result.error || 'Build initialization failed');
-      return;
-    }
-    spinner.succeed(`Initialized build with ${result.taskCount} tasks`);
-    state = buildState.load(projectRoot);
-  }
-
-  const hasSeed = fs.existsSync(seedPath);
-  const hasQueue = fs.existsSync(queuePath);
-  const finalPreseedCount = countPreseedDocsInDir(preseedDir);
-  const queueTasks = state?.implementationQueue?.length || 0;
-
-  console.log(`
-${c.green}${c.bold}Backfill complete${c.reset}
-
-${c.bold}Recovered artifacts:${c.reset}
-  Preseed docs: ${finalPreseedCount}/${PRESEED_DOC_FILES.length}
-  SEED.md: ${hasSeed ? `${c.green}yes${c.reset}` : `${c.red}no${c.reset}`}
-  TASK_QUEUE.md: ${hasQueue ? `${c.green}yes${c.reset}` : `${c.red}no${c.reset}`}
-  Build tasks in state: ${queueTasks}
-
-${c.bold}Next steps:${c.reset}
-  Run ${c.cyan}bootspring build status${c.reset} to verify progress
-  Run ${c.cyan}bootspring build next${c.reset} to continue implementation
-`);
-}
-
-/**
- * Extract non-task supplementary content from TASK_QUEUE.md.
- * Captures context notes, architecture diagrams, integration guidelines,
- * and any section that isn't the task table or per-task detail blocks.
- */
-function extractSupplementaryContent(queueContent) {
-  const lines = queueContent.split('\n');
-  const sections = [];
-  let currentSection = null;
-  let inTaskTable = false;
-  let inTaskDetail = false;
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-
-    // Detect task table (starts with | Position | or | # |)
-    if (/^\|\s*(Position|#)\s*\|/.test(line)) {
-      inTaskTable = true;
-      continue;
-    }
-    // Still in task table (rows starting with |)
-    if (inTaskTable && /^\|/.test(line)) {
-      continue;
-    }
-    if (inTaskTable && !/^\|/.test(line)) {
-      inTaskTable = false;
-    }
-
-    // Detect per-task detail blocks (### task-XXX: or ### bs-XXX:)
-    if (/^###\s+(task-\d+|bs-\d+)\s*:/.test(line)) {
-      inTaskDetail = true;
-      continue;
-    }
-    // End task detail at next ### or ## heading
-    if (inTaskDetail && /^#{2,3}\s+/.test(line) && !/^###\s+(task-\d+|bs-\d+)\s*:/.test(line)) {
-      inTaskDetail = false;
-    }
-    if (inTaskDetail) continue;
-
-    // Skip the header, queue status heading, and generated boilerplate
-    if (/^#\s+.*Implementation Queue/.test(line)) continue;
-    if (/^>\s*(Ordered task queue|Last Updated|Current Version)/.test(line)) continue;
-    if (/^## Queue Status/.test(line)) { inTaskTable = true; continue; }
-    if (/^## Task Details/.test(line)) { inTaskDetail = true; continue; }
-    if (/^\*Generated by/.test(line)) continue;
-    if (/^---$/.test(line.trim())) continue;
-
-    // Detect section headings for supplementary content
-    if (/^##\s+/.test(line) && !/^## (Queue Status|Task Details|Execution Guidelines)/.test(line)) {
-      if (currentSection) sections.push(currentSection);
-      currentSection = { heading: line, lines: [] };
-      continue;
-    }
-
-    // Execution Guidelines is useful — keep it
-    if (/^## Execution Guidelines/.test(line)) {
-      if (currentSection) sections.push(currentSection);
-      currentSection = { heading: line, lines: [] };
-      continue;
-    }
-
-    if (currentSection) {
-      currentSection.lines.push(line);
-    }
-  }
-
-  if (currentSection) sections.push(currentSection);
-
-  // Filter out empty sections and build output
-  const output = sections
-    .filter(s => s.lines.some(l => l.trim().length > 0))
-    .map(s => `${s.heading}\n\n${s.lines.join('\n').trim()}`)
-    .join('\n\n---\n\n');
-
-  return output.trim();
-}
-
-/**
- * Migrate from TASK_QUEUE.md to TODO.md as single source of truth.
- */
-async function migrateTodoFormat(projectRoot, args = {}) {
-  const planningDir = path.join(projectRoot, 'planning');
-  const queuePath = path.join(planningDir, 'TASK_QUEUE.md');
-  const todoPath = path.join(planningDir, 'TODO.md');
-  const keepQueue = Boolean(args['keep-queue'] || args.keepQueue);
-
-  console.log(`
-${c.cyan}${c.bold}Migrating to TODO.md as Single Source of Truth${c.reset}
-`);
-
-  // Step 1: Ensure we have build state with tasks
-  let state = buildState.load(projectRoot);
-
-  if (!state || !state.implementationQueue || state.implementationQueue.length === 0) {
-    if (fs.existsSync(queuePath)) {
-      console.log(`${c.dim}No build state — syncing tasks from TASK_QUEUE.md first...${c.reset}`);
-      try {
-        const taskExtractor = require('../core/task-extractor');
-        const result = taskExtractor.syncFromTaskQueue(projectRoot);
-        if (result.total > 0) {
-          console.log(`${c.green}✓${c.reset} Synced ${result.total} tasks from TASK_QUEUE.md`);
-          state = buildState.load(projectRoot);
-        }
-      } catch {
-        // Fall through
-      }
-    }
-
-    if (!state || !state.implementationQueue || state.implementationQueue.length === 0) {
-      console.log(`${c.red}No tasks found. Run 'bootspring seed build' first or ensure TASK_QUEUE.md exists.${c.reset}`);
-      return;
-    }
-  }
-
-  // Step 2: Extract non-task content from TASK_QUEUE.md (context notes, diagrams, guidelines)
-  let supplementaryContent = '';
-  if (fs.existsSync(queuePath)) {
-    const queueContent = fs.readFileSync(queuePath, 'utf-8');
-    supplementaryContent = extractSupplementaryContent(queueContent);
-  }
-
-  // Step 3: Generate enriched TODO.md with full task metadata
-  const planningTemplate = require('../generators/templates/build-planning.template');
-  let todo = planningTemplate.generateTodo(state.implementationQueue, {
-    projectName: state.projectName
-  });
-
-  // Append supplementary content if any was extracted
-  if (supplementaryContent) {
-    todo += `\n---\n\n## Reference (from TASK_QUEUE.md)\n\n${supplementaryContent}\n`;
-  }
-
-  fs.writeFileSync(todoPath, todo);
-
-  const stats = buildState.getStats(projectRoot);
-  console.log(`${c.green}✓${c.reset} Generated TODO.md with ${state.implementationQueue.length} tasks (${stats?.completed || 0} completed)`);
-  if (supplementaryContent) {
-    console.log(`${c.green}✓${c.reset} Preserved supplementary content (context notes, diagrams, guidelines)`);
-  }
-
-  // Step 4: Archive TASK_QUEUE.md unless --keep-queue
-  if (fs.existsSync(queuePath) && !keepQueue) {
-    const archivePath = path.join(planningDir, 'TASK_QUEUE.md.bak');
-    fs.renameSync(queuePath, archivePath);
-    console.log(`${c.green}✓${c.reset} Archived TASK_QUEUE.md → TASK_QUEUE.md.bak`);
-  } else if (fs.existsSync(queuePath) && keepQueue) {
-    console.log(`${c.dim}Kept TASK_QUEUE.md (--keep-queue)${c.reset}`);
-  }
-
-  console.log(`
-${c.green}${c.bold}Migration complete${c.reset}
-
-${c.bold}What changed:${c.reset}
-  - ${c.cyan}planning/TODO.md${c.reset} is now the single source of truth
-  - Task IDs, source, description, acceptance criteria, and status are all inline
-  - Non-task content (context notes, diagrams, guidelines) preserved in Reference section
-  - Build loop reads TODO.md instead of TASK_QUEUE.md
-${!keepQueue && fs.existsSync(path.join(planningDir, 'TASK_QUEUE.md.bak')) ? `  - Old TASK_QUEUE.md archived as TASK_QUEUE.md.bak
-` : ''}
-${c.bold}Next steps:${c.reset}
-  Run ${c.cyan}bootspring build status${c.reset} to verify
-  Run ${c.cyan}bootspring build next${c.reset} to continue building
-`);
-}
-
-/**
- * Show help
- */
-function showHelp() {
-  console.log(`
-${c.cyan}${c.bold}Bootspring Build${c.reset}
-${c.dim}Task-driven build system for Claude Code${c.reset}
-
-${c.bold}Quick Start:${c.reset}
-  ${c.cyan}bootspring build next${c.reset}  Get next task and start building
-
-${c.bold}Workflow:${c.reset}
-  1. Run ${c.cyan}bootspring build next${c.reset} to get the next task
-  2. Implement the task in your codebase
-  3. Run ${c.cyan}bootspring build done${c.reset} when complete
-  4. Repeat until MVP is complete
-
-${c.bold}Commands:${c.reset}
-  ${c.cyan}bootspring build${c.reset}           Start interactive build
-  ${c.cyan}bootspring build next${c.reset}      Get next task (start here!)
-  ${c.cyan}bootspring build done${c.reset}      Mark current task complete
-  ${c.cyan}bootspring build loop${c.reset}      Start autonomous loop (commit+push each task)
-  ${c.cyan}bootspring build skip${c.reset}      Skip current task
-  ${c.cyan}bootspring build stop${c.reset}      Graceful stop (finish current task, then pause)
-  ${c.cyan}bootspring build status${c.reset}    View detailed progress
-  ${c.cyan}bootspring build task${c.reset}      View current task details
-  ${c.cyan}bootspring build plan${c.reset}      View the full master plan
-  ${c.cyan}bootspring build migrate-todo${c.reset}  Migrate TASK_QUEUE.md → TODO.md (single source of truth)
-  ${c.cyan}bootspring build backfill${c.reset}  Recover preseed + SEED + TASK_QUEUE artifacts
-  ${c.cyan}bootspring build reset${c.reset}     Start over
-
-${c.bold}Loop Options:${c.reset}
-  ${c.cyan}bootspring build loop${c.reset}              Commit + push after each task
-  ${c.cyan}bootspring build loop --no-push${c.reset}    Commit only (no push)
-  ${c.cyan}bootspring build loop --no-commit${c.reset}  No git operations
-
-${c.bold}Other Options:${c.reset}
-  --prompt          Show AI prompt for current task
-  --force           Force reset even if in progress
-  --quick           With backfill: skip deep codebase analysis
-  --interactive     With backfill: allow follow-up prompts
-  --no-onboard      With backfill: skip onboard-assisted detection
-`);
-}
-
-module.exports = { run };