@jojonax/codex-copilot 1.5.5 → 1.6.0

package/src/commands/evolve.js

@@ -1,316 +1,316 @@
-/**
- * codex-copilot evolve - Multi-round PRD iteration
- *
- * Flow: Archive current round → Gap analysis → Plan next round → Reset → Run
- *
- * Each round is tracked in .codex-copilot/rounds.json with summaries of
- * what was built, enabling intelligent gap analysis against the full PRD.
- */
-
-import { readFileSync, writeFileSync, existsSync, copyFileSync } from 'fs';
-import { resolve } from 'path';
-import { log } from '../utils/logger.js';
-import { provider } from '../utils/provider.js';
-import { readPRD } from '../utils/detect-prd.js';
-import { closePrompt } from '../utils/prompt.js';
-import { readJSON, writeJSON } from '../utils/json.js';
-import { run } from './run.js';
-
-
-
-/**
- * Load or initialize rounds.json
- */
-function loadRounds(copilotDir) {
-  const roundsPath = resolve(copilotDir, 'rounds.json');
-  if (existsSync(roundsPath)) {
-    return readJSON(roundsPath);
-  }
-  return { current_round: 0, rounds: [] };
-}
-
-function saveRounds(copilotDir, rounds) {
-  writeJSON(resolve(copilotDir, 'rounds.json'), rounds);
-}
-
-/**
- * Archive the current round: count results, save summary
- */
-function archiveCurrentRound(copilotDir, tasks, roundNumber) {
-  const completed = tasks.tasks.filter(t => t.status === 'completed');
-  const blocked = tasks.tasks.filter(t => t.status === 'blocked');
-  const skipped = tasks.tasks.filter(t => t.status === 'skipped');
-
-  // Build a text summary of what was completed
-  const completedSummary = completed.map(t =>
-    `- Task #${t.id}: ${t.title}`
-  ).join('\n');
-
-  const blockedSummary = blocked.length > 0
-    ? '\n\nBlocked tasks:\n' + blocked.map(t => `- Task #${t.id}: ${t.title}`).join('\n')
-    : '';
-
-  const summary = `Round ${roundNumber} completed ${completed.length}/${tasks.total} tasks.\n\nCompleted:\n${completedSummary}${blockedSummary}`;
-
-  const roundEntry = {
-    round: roundNumber,
-    started_at: tasks.tasks[0]?.started_at || new Date().toISOString(),
-    completed_at: new Date().toISOString(),
-    tasks_total: tasks.total,
-    tasks_completed: completed.length,
-    tasks_blocked: blocked.length,
-    tasks_skipped: skipped.length,
-    summary,
-    // Store completed task titles + descriptions for gap analysis
-    completed_features: completed.map(t => ({
-      title: t.title,
-      description: t.description,
-      acceptance: t.acceptance,
-    })),
-  };
-
-  // Archive tasks.json → tasks_round_N.json
-  const archivePath = resolve(copilotDir, `tasks_round_${roundNumber}.json`);
-  copyFileSync(resolve(copilotDir, 'tasks.json'), archivePath);
-  log.dim(`  Archived to tasks_round_${roundNumber}.json`);
-
-  return roundEntry;
-}
-
-/**
- * Build the gap analysis + next-round planning prompt
- */
-function buildEvolvePrompt(prdContent, rounds, copilotDir) {
-  // Collect all completed features across all rounds
-  const allCompleted = [];
-  for (const r of rounds.rounds) {
-    if (r.completed_features) {
-      for (const f of r.completed_features) {
-        allCompleted.push(f);
-      }
-    }
-  }
-
-  const completedSection = allCompleted.length > 0
-    ? allCompleted.map((f, i) => `${i + 1}. **${f.title}**\n   ${f.description?.substring(0, 200) || ''}`).join('\n\n')
-    : 'No features completed yet.';
-
-  const roundHistorySection = rounds.rounds.map(r =>
-    `### Round ${r.round}\n- Completed: ${r.tasks_completed}/${r.tasks_total} tasks\n- Summary: ${r.summary?.substring(0, 300) || 'N/A'}`
-  ).join('\n\n');
-
-  const nextRound = rounds.current_round + 1;
-
-  return `You are a senior software architect planning the next development iteration.
-
-## Context
-
-This is Round ${nextRound} of an iterative PRD implementation.
-
-### Full PRD Document
-
-${prdContent}
-
-### Development History
-
-${roundHistorySection}
-
-### Features Already Completed (across all rounds)
-
-${completedSection}
-
-## Your Task
-
-1. **Gap Analysis**: Compare the PRD requirements against the completed features. Identify ALL remaining features, improvements, and details that have NOT been implemented yet.
-
-2. **Priority Planning**: From the gaps identified, select the most important batch for Round ${nextRound}. Consider:
-   - Dependencies (build foundations before features)
-   - User value (core features before polish)
-   - Technical feasibility (group related changes)
-   - Moderate batch size (8-15 tasks per round)
-
-3. **Generate tasks.json**: Output the next round's task plan.
-
-## Output Format
-
-Write the result to \`.codex-copilot/tasks.json\` in the following format:
-
-\`\`\`json
-{
-  "project": "Project Name",
-  "round": ${nextRound},
-  "total": N,
-  "tasks": [
-    {
-      "id": 1,
-      "title": "Task title (brief)",
-      "description": "Detailed task description with specific features and technical details",
-      "acceptance": ["Acceptance criteria 1", "Acceptance criteria 2"],
-      "branch": "feature/${String(nextRound).padStart(2, '0')}01-task-slug",
-      "status": "pending",
-      "depends_on": []
-    }
-  ]
-}
-\`\`\`
-
-## Important Rules
-1. Do NOT re-implement features that are already completed
-2. Branch names should be prefixed with the round number: feature/${String(nextRound).padStart(2, '0')}XX-slug
-3. Each task must be specific and actionable (not vague like "improve performance")
-4. Include detailed descriptions that reference the PRD's specific requirements
-5. If the PRD has been fully implemented, output an empty tasks array with a comment
-`;
-}
-
-export async function evolve(projectDir) {
-  log.title('🔄 Multi-Round PRD Evolution');
-  log.blank();
-
-  const copilotDir = resolve(projectDir, '.codex-copilot');
-  const tasksPath = resolve(copilotDir, 'tasks.json');
-  const configPath = resolve(copilotDir, 'config.json');
-
-  // Validate project state
-  if (!existsSync(copilotDir) || !existsSync(configPath)) {
-    log.error('Project not initialized. Run: codex-copilot init');
-    closePrompt();
-    process.exit(1);
-  }
-
-  const config = readJSON(configPath);
-  const providerId = config.provider || 'codex-cli';
-  const rounds = loadRounds(copilotDir);
-
-  // ===== Step 1: Archive current round =====
-  if (existsSync(tasksPath)) {
-    const tasks = readJSON(tasksPath);
-    const hasCompletedTasks = tasks.tasks?.some(t => t.status === 'completed');
-    const roundNumber = tasks.round || rounds.current_round || 1;
-
-    // Check if this round was already archived (prevent duplicate archiving)
-    const archiveExists = existsSync(resolve(copilotDir, `tasks_round_${roundNumber}.json`));
-    const alreadyInHistory = rounds.rounds.some(r => r.round === roundNumber);
-
-    if (hasCompletedTasks && !archiveExists && !alreadyInHistory) {
-      log.step(`Step 1: Archiving Round ${roundNumber}...`);
-
-      const roundEntry = archiveCurrentRound(copilotDir, tasks, roundNumber);
-      rounds.rounds.push(roundEntry);
-      rounds.current_round = roundNumber;
-      saveRounds(copilotDir, rounds);
-
-      const pct = Math.round((roundEntry.tasks_completed / roundEntry.tasks_total) * 100);
-      log.info(`  Round ${roundNumber}: ${roundEntry.tasks_completed}/${roundEntry.tasks_total} tasks (${pct}%)`);
-      log.blank();
-    } else if (hasCompletedTasks && (archiveExists || alreadyInHistory)) {
-      log.dim(`  Round ${roundNumber} already archived — skipping`);
-      // Ensure rounds.current_round is up to date
-      if (rounds.current_round < roundNumber) {
-        rounds.current_round = roundNumber;
-        saveRounds(copilotDir, rounds);
-      }
-      log.blank();
-    } else if (rounds.current_round === 0) {
-      log.warn('No completed tasks found. Starting from Round 1.');
-      rounds.current_round = 0;
-      saveRounds(copilotDir, rounds);
-      log.blank();
-    }
-  }
-
-  // ===== Step 2 + 3: Gap analysis & next-round planning =====
-  const nextRound = rounds.current_round + 1;
-  log.step(`Step 2: Planning Round ${nextRound} (Gap Analysis + Task Planning)...`);
-  log.blank();
-
-  // Read PRD
-  let prdContent;
-  try {
-    prdContent = readPRD(config.prd_path);
-  } catch {
-    log.error(`Cannot read PRD: ${config.prd_path}`);
-    closePrompt();
-    process.exit(1);
-  }
-
-  // Build the evolve prompt
-  const evolvePrompt = buildEvolvePrompt(prdContent, rounds, copilotDir);
-  const promptPath = resolve(copilotDir, 'evolve-prompt.md');
-  writeFileSync(promptPath, evolvePrompt);
-  log.info(`  Evolve prompt saved: .codex-copilot/evolve-prompt.md`);
-  log.blank();
-
-  // Execute via AI provider
-  log.step(`Invoking AI to analyze gaps and plan Round ${nextRound}...`);
-  const result = await provider.executePrompt(providerId, promptPath, projectDir);
-
-  if (!result.ok) {
-    log.error('AI invocation failed. You can manually edit the prompt and retry.');
-    closePrompt();
-    process.exit(1);
-  }
-
-  // ===== Step 4: Validate new tasks.json =====
-  if (!existsSync(tasksPath)) {
-    log.error('AI did not generate tasks.json. Check the evolve prompt output.');
-    closePrompt();
-    process.exit(1);
-  }
-
-  let newTasks;
-  try {
-    newTasks = readJSON(tasksPath);
-  } catch {
-    log.error('Generated tasks.json is invalid JSON.');
-    closePrompt();
-    process.exit(1);
-  }
-
-  if (!newTasks.tasks || newTasks.tasks.length === 0) {
-    log.blank();
-    log.title('🎉 PRD fully implemented!');
-    log.info('All features from the PRD have been built across all rounds.');
-    log.info(`Total rounds: ${rounds.current_round}`);
-
-    // Show round history
-    for (const r of rounds.rounds) {
-      log.dim(`  Round ${r.round}: ${r.tasks_completed}/${r.tasks_total} tasks`);
-    }
-
-    closePrompt();
-    return;
-  }
-
-  // Update round tracking
-  rounds.current_round = nextRound;
-  saveRounds(copilotDir, rounds);
-
-  // Reset checkpoint for fresh round
-  const statePath = resolve(copilotDir, 'state.json');
-  writeJSON(statePath, {
-    current_task: 0,
-    phase: null,
-    phase_step: null,
-    current_pr: null,
-    review_round: 0,
-    branch: null,
-    status: 'initialized',
-    last_updated: new Date().toISOString(),
-  });
-
-  log.blank();
-  log.title(`✅ Round ${nextRound} planned — ${newTasks.tasks.length} tasks`);
-  log.blank();
-
-  for (const t of newTasks.tasks) {
-    log.dim(`  ${t.id}. ${t.title}`);
-  }
-  log.blank();
-
-  // ===== Step 5: Auto-start run =====
-  log.step(`Starting Round ${nextRound} execution...`);
-  log.blank();
-
-  await run(projectDir);
-}
+/**
+ * codex-copilot evolve - Multi-round PRD iteration
+ *
+ * Flow: Archive current round → Gap analysis → Plan next round → Reset → Run
+ *
+ * Each round is tracked in .codex-copilot/rounds.json with summaries of
+ * what was built, enabling intelligent gap analysis against the full PRD.
+ */
+
+import { readFileSync, writeFileSync, existsSync, copyFileSync } from 'fs';
+import { resolve } from 'path';
+import { log } from '../utils/logger.js';
+import { provider } from '../utils/provider.js';
+import { readPRD } from '../utils/detect-prd.js';
+import { closePrompt } from '../utils/prompt.js';
+import { readJSON, writeJSON } from '../utils/json.js';
+import { run } from './run.js';
+
+
+
+/**
+ * Load or initialize rounds.json
+ */
+function loadRounds(copilotDir) {
+  const roundsPath = resolve(copilotDir, 'rounds.json');
+  if (existsSync(roundsPath)) {
+    return readJSON(roundsPath);
+  }
+  return { current_round: 0, rounds: [] };
+}
+
+function saveRounds(copilotDir, rounds) {
+  writeJSON(resolve(copilotDir, 'rounds.json'), rounds);
+}
+
+/**
+ * Archive the current round: count results, save summary
+ */
+function archiveCurrentRound(copilotDir, tasks, roundNumber) {
+  const completed = tasks.tasks.filter(t => t.status === 'completed');
+  const blocked = tasks.tasks.filter(t => t.status === 'blocked');
+  const skipped = tasks.tasks.filter(t => t.status === 'skipped');
+
+  // Build a text summary of what was completed
+  const completedSummary = completed.map(t =>
+    `- Task #${t.id}: ${t.title}`
+  ).join('\n');
+
+  const blockedSummary = blocked.length > 0
+    ? '\n\nBlocked tasks:\n' + blocked.map(t => `- Task #${t.id}: ${t.title}`).join('\n')
+    : '';
+
+  const summary = `Round ${roundNumber} completed ${completed.length}/${tasks.total} tasks.\n\nCompleted:\n${completedSummary}${blockedSummary}`;
+
+  const roundEntry = {
+    round: roundNumber,
+    started_at: tasks.tasks[0]?.started_at || new Date().toISOString(),
+    completed_at: new Date().toISOString(),
+    tasks_total: tasks.total,
+    tasks_completed: completed.length,
+    tasks_blocked: blocked.length,
+    tasks_skipped: skipped.length,
+    summary,
+    // Store completed task titles + descriptions for gap analysis
+    completed_features: completed.map(t => ({
+      title: t.title,
+      description: t.description,
+      acceptance: t.acceptance,
+    })),
+  };
+
+  // Archive tasks.json → tasks_round_N.json
+  const archivePath = resolve(copilotDir, `tasks_round_${roundNumber}.json`);
+  copyFileSync(resolve(copilotDir, 'tasks.json'), archivePath);
+  log.dim(`  Archived to tasks_round_${roundNumber}.json`);
+
+  return roundEntry;
+}
+
+/**
+ * Build the gap analysis + next-round planning prompt
+ */
+function buildEvolvePrompt(prdContent, rounds, copilotDir) {
+  // Collect all completed features across all rounds
+  const allCompleted = [];
+  for (const r of rounds.rounds) {
+    if (r.completed_features) {
+      for (const f of r.completed_features) {
+        allCompleted.push(f);
+      }
+    }
+  }
+
+  const completedSection = allCompleted.length > 0
+    ? allCompleted.map((f, i) => `${i + 1}. **${f.title}**\n   ${f.description?.substring(0, 200) || ''}`).join('\n\n')
+    : 'No features completed yet.';
+
+  const roundHistorySection = rounds.rounds.map(r =>
+    `### Round ${r.round}\n- Completed: ${r.tasks_completed}/${r.tasks_total} tasks\n- Summary: ${r.summary?.substring(0, 300) || 'N/A'}`
+  ).join('\n\n');
+
+  const nextRound = rounds.current_round + 1;
+
+  return `You are a senior software architect planning the next development iteration.
+
+## Context
+
+This is Round ${nextRound} of an iterative PRD implementation.
+
+### Full PRD Document
+
+${prdContent}
+
+### Development History
+
+${roundHistorySection}
+
+### Features Already Completed (across all rounds)
+
+${completedSection}
+
+## Your Task
+
+1. **Gap Analysis**: Compare the PRD requirements against the completed features. Identify ALL remaining features, improvements, and details that have NOT been implemented yet.
+
+2. **Priority Planning**: From the gaps identified, select the most important batch for Round ${nextRound}. Consider:
+   - Dependencies (build foundations before features)
+   - User value (core features before polish)
+   - Technical feasibility (group related changes)
+   - Moderate batch size (8-15 tasks per round)
+
+3. **Generate tasks.json**: Output the next round's task plan.
+
+## Output Format
+
+Write the result to \`.codex-copilot/tasks.json\` in the following format:
+
+\`\`\`json
+{
+  "project": "Project Name",
+  "round": ${nextRound},
+  "total": N,
+  "tasks": [
+    {
+      "id": 1,
+      "title": "Task title (brief)",
+      "description": "Detailed task description with specific features and technical details",
+      "acceptance": ["Acceptance criteria 1", "Acceptance criteria 2"],
+      "branch": "feature/${String(nextRound).padStart(2, '0')}01-task-slug",
+      "status": "pending",
+      "depends_on": []
+    }
+  ]
+}
+\`\`\`
+
+## Important Rules
+1. Do NOT re-implement features that are already completed
+2. Branch names should be prefixed with the round number: feature/${String(nextRound).padStart(2, '0')}XX-slug
+3. Each task must be specific and actionable (not vague like "improve performance")
+4. Include detailed descriptions that reference the PRD's specific requirements
+5. If the PRD has been fully implemented, output an empty tasks array with a comment
+`;
+}
+
+export async function evolve(projectDir) {
+  log.title('🔄 Multi-Round PRD Evolution');
+  log.blank();
+
+  const copilotDir = resolve(projectDir, '.codex-copilot');
+  const tasksPath = resolve(copilotDir, 'tasks.json');
+  const configPath = resolve(copilotDir, 'config.json');
+
+  // Validate project state
+  if (!existsSync(copilotDir) || !existsSync(configPath)) {
+    log.error('Project not initialized. Run: codex-copilot init');
+    closePrompt();
+    process.exit(1);
+  }
+
+  const config = readJSON(configPath);
+  const providerId = config.provider || 'codex-cli';
+  const rounds = loadRounds(copilotDir);
+
+  // ===== Step 1: Archive current round =====
+  if (existsSync(tasksPath)) {
+    const tasks = readJSON(tasksPath);
+    const hasCompletedTasks = tasks.tasks?.some(t => t.status === 'completed');
+    const roundNumber = tasks.round || rounds.current_round || 1;
+
+    // Check if this round was already archived (prevent duplicate archiving)
+    const archiveExists = existsSync(resolve(copilotDir, `tasks_round_${roundNumber}.json`));
+    const alreadyInHistory = rounds.rounds.some(r => r.round === roundNumber);
+
+    if (hasCompletedTasks && !archiveExists && !alreadyInHistory) {
+      log.step(`Step 1: Archiving Round ${roundNumber}...`);
+
+      const roundEntry = archiveCurrentRound(copilotDir, tasks, roundNumber);
+      rounds.rounds.push(roundEntry);
+      rounds.current_round = roundNumber;
+      saveRounds(copilotDir, rounds);
+
+      const pct = Math.round((roundEntry.tasks_completed / roundEntry.tasks_total) * 100);
+      log.info(`  Round ${roundNumber}: ${roundEntry.tasks_completed}/${roundEntry.tasks_total} tasks (${pct}%)`);
+      log.blank();
+    } else if (hasCompletedTasks && (archiveExists || alreadyInHistory)) {
+      log.dim(`  Round ${roundNumber} already archived — skipping`);
+      // Ensure rounds.current_round is up to date
+      if (rounds.current_round < roundNumber) {
+        rounds.current_round = roundNumber;
+        saveRounds(copilotDir, rounds);
+      }
+      log.blank();
+    } else if (rounds.current_round === 0) {
+      log.warn('No completed tasks found. Starting from Round 1.');
+      rounds.current_round = 0;
+      saveRounds(copilotDir, rounds);
+      log.blank();
+    }
+  }
+
+  // ===== Step 2 + 3: Gap analysis & next-round planning =====
+  const nextRound = rounds.current_round + 1;
+  log.step(`Step 2: Planning Round ${nextRound} (Gap Analysis + Task Planning)...`);
+  log.blank();
+
+  // Read PRD
+  let prdContent;
+  try {
+    prdContent = readPRD(config.prd_path);
+  } catch {
+    log.error(`Cannot read PRD: ${config.prd_path}`);
+    closePrompt();
+    process.exit(1);
+  }
+
+  // Build the evolve prompt
+  const evolvePrompt = buildEvolvePrompt(prdContent, rounds, copilotDir);
+  const promptPath = resolve(copilotDir, 'evolve-prompt.md');
+  writeFileSync(promptPath, evolvePrompt);
+  log.info(`  Evolve prompt saved: .codex-copilot/evolve-prompt.md`);
+  log.blank();
+
+  // Execute via AI provider
+  log.step(`Invoking AI to analyze gaps and plan Round ${nextRound}...`);
+  const result = await provider.executePrompt(providerId, promptPath, projectDir);
+
+  if (!result.ok) {
+    log.error('AI invocation failed. You can manually edit the prompt and retry.');
+    closePrompt();
+    process.exit(1);
+  }
+
+  // ===== Step 4: Validate new tasks.json =====
+  if (!existsSync(tasksPath)) {
+    log.error('AI did not generate tasks.json. Check the evolve prompt output.');
+    closePrompt();
+    process.exit(1);
+  }
+
+  let newTasks;
+  try {
+    newTasks = readJSON(tasksPath);
+  } catch {
+    log.error('Generated tasks.json is invalid JSON.');
+    closePrompt();
+    process.exit(1);
+  }
+
+  if (!newTasks.tasks || newTasks.tasks.length === 0) {
+    log.blank();
+    log.title('🎉 PRD fully implemented!');
+    log.info('All features from the PRD have been built across all rounds.');
+    log.info(`Total rounds: ${rounds.current_round}`);
+
+    // Show round history
+    for (const r of rounds.rounds) {
+      log.dim(`  Round ${r.round}: ${r.tasks_completed}/${r.tasks_total} tasks`);
+    }
+
+    closePrompt();
+    return;
+  }
+
+  // Update round tracking
+  rounds.current_round = nextRound;
+  saveRounds(copilotDir, rounds);
+
+  // Reset checkpoint for fresh round
+  const statePath = resolve(copilotDir, 'state.json');
+  writeJSON(statePath, {
+    current_task: 0,
+    phase: null,
+    phase_step: null,
+    current_pr: null,
+    review_round: 0,
+    branch: null,
+    status: 'initialized',
+    last_updated: new Date().toISOString(),
+  });
+
+  log.blank();
+  log.title(`✅ Round ${nextRound} planned — ${newTasks.tasks.length} tasks`);
+  log.blank();
+
+  for (const t of newTasks.tasks) {
+    log.dim(`  ${t.id}. ${t.title}`);
+  }
+  log.blank();
+
+  // ===== Step 5: Auto-start run =====
+  log.step(`Starting Round ${nextRound} execution...`);
+  log.blank();
+
+  await run(projectDir);
+}