@jojonax/codex-copilot 1.5.5 → 1.6.0

package/src/commands/init.js

@@ -1,298 +1,298 @@
-/**
- * codex-copilot init - Initialize project
- * 
- * 1. Auto-detect PRD document
- * 2. Let user confirm/select PRD
- * 3. Select AI provider (Codex, Claude Code, Cursor, etc.)
- * 4. Generate task decomposition prompt
- * 5. Create .codex-copilot/ directory structure
- */
-
-import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'fs';
-import { resolve } from 'path';
-import { detectPRD, readPRD } from '../utils/detect-prd.js';
-import { log } from '../utils/logger.js';
-import { ask, confirm, select, closePrompt } from '../utils/prompt.js';
-import { git } from '../utils/git.js';
-import { github } from '../utils/github.js';
-import { provider } from '../utils/provider.js';
-
-export async function init(projectDir) {
-  log.title('📋 Initializing Codex-Copilot');
-  log.blank();
-
-  // ===== Pre-flight checks =====
-  log.step('Checking environment...');
-
-  // Check if in a git repo
-  try {
-    git.currentBranch(projectDir);
-    log.info('Git repository ✓');
-  } catch {
-    log.error('Not a Git repository. Run: git init');
-    closePrompt();
-    process.exit(1);
-  }
-
-  // Check gh CLI
-  if (!github.checkGhAuth()) {
-    log.error('GitHub CLI not authenticated. Run: gh auth login');
-    closePrompt();
-    process.exit(1);
-  }
-  log.info('GitHub CLI ✓');
-
-  // Check GitHub remote
-  try {
-    const repo = git.getRepoInfo(projectDir);
-    log.info(`GitHub repo: ${repo.owner}/${repo.repo} ✓`);
-  } catch (err) {
-    log.error(err.message);
-    closePrompt();
-    process.exit(1);
-  }
-
-  log.blank();
-
-  // ===== Detect PRD =====
-  log.step('Scanning for PRD documents...');
-  const candidates = detectPRD(projectDir);
-
-  let prdPath;
-
-  if (candidates.length === 0) {
-    log.warn('No PRD document detected automatically');
-    const manualPath = await ask('Enter PRD file path (relative or absolute):');
-    prdPath = resolve(projectDir, manualPath);
-    // Prevent path traversal
-    if (!prdPath.startsWith(resolve(projectDir)) && !manualPath.startsWith('/')) {
-      log.error('PRD path is outside the project directory');
-      closePrompt();
-      process.exit(1);
-    }
-    if (!existsSync(prdPath)) {
-      log.error(`File not found: ${prdPath}`);
-      closePrompt();
-      process.exit(1);
-    }
-  } else if (candidates.length === 1) {
-    prdPath = candidates[0].path;
-    log.info(`Found PRD: ${candidates[0].relativePath}`);
-    const ok = await confirm('Use this file?');
-    if (!ok) {
-      const manualPath = await ask('Enter PRD file path:');
-      prdPath = resolve(projectDir, manualPath);
-    }
-  } else {
-    log.info(`Found ${candidates.length} candidate PRD files:`);
-    const choice = await select('Select the PRD to use:', candidates.map(c => ({
-      label: `${c.relativePath} (score: ${c.score})`,
-      value: c.path,
-    })));
-    prdPath = choice.value;
-  }
-
-  log.info(`Using PRD: ${prdPath}`);
-  log.blank();
-
-  // ===== Read PRD =====
-  const prdContent = readPRD(prdPath);
-  log.info(`PRD size: ${(prdContent.length / 1024).toFixed(1)} KB`);
-
-  // ===== Select AI Provider =====
-  log.step('Select AI coding tool...');
-
-  // Check versions of installed CLI tools (non-blocking)
-  log.info('Checking tool versions...');
-  let versionCache = {};
-  try {
-    versionCache = provider.checkAllVersions();
-    const updatable = Object.entries(versionCache).filter(([, v]) => v.updateAvailable);
-    if (updatable.length > 0) {
-      for (const [id, v] of updatable) {
-        log.warn(`${provider.getProvider(id).name}: v${v.current} → v${v.latest} update available`);
-      }
-    } else if (Object.keys(versionCache).length > 0) {
-      log.info('All detected tools are up to date ✓');
-    }
-  } catch {
-    // Version check failed — continue normally
-  }
-
-  log.blank();
-  const providerChoices = provider.buildProviderChoices(versionCache);
-  const selectedProvider = await select('Which AI tool will you use?', providerChoices);
-  const providerId = selectedProvider.value;
-  const providerInfo = provider.getProvider(providerId);
-  log.info(`Selected: ${providerInfo.name}`);
-
-  // Offer update if newer version available
-  const vi = versionCache[providerId];
-  if (vi && vi.updateAvailable) {
-    log.blank();
-    log.warn(`${providerInfo.name} v${vi.current} → v${vi.latest} available`);
-    const doUpdate = await confirm(`Update ${providerInfo.name} now?`);
-    if (doUpdate) {
-      provider.updateProvider(providerId);
-    }
-  }
-
-  log.blank();
-
-  // ===== Create .codex-copilot directory =====
-  log.step('Creating .codex-copilot/ directory...');
-  const copilotDir = resolve(projectDir, '.codex-copilot');
-  mkdirSync(copilotDir, { recursive: true });
-
-  // Write config file
-  const config = {
-    provider: providerId,
-    prd_path: prdPath,
-    base_branch: git.currentBranch(projectDir) || 'main',
-    max_review_rounds: 2,
-    review_poll_interval: 60,
-    review_wait_timeout: 600,
-    created_at: new Date().toISOString(),
-  };
-  writeFileSync(resolve(copilotDir, 'config.json'), JSON.stringify(config, null, 2));
-
-  // Write initial state (matches checkpoint.js schema)
-  const state = {
-    current_task: 0,
-    phase: null,
-    phase_step: null,
-    current_pr: null,
-    review_round: 0,
-    branch: null,
-    status: 'initialized',
-    last_updated: new Date().toISOString(),
-  };
-  writeFileSync(resolve(copilotDir, 'state.json'), JSON.stringify(state, null, 2));
-
-  // Write CodeX instruction template
-  const instructions = `# Codex-Copilot Development Instructions
-
-## Role
-You are an efficient automated development agent responsible for completing feature development according to task descriptions.
-
-## Rules
-1. **Follow the project tech stack**: Use the existing frameworks, tools, and code style
-2. **Test first**: Ensure code compiles/runs before finishing
-3. **Git conventions**: Commit message format \`feat(task-N): brief description\` or \`fix(task-N): brief description\`
-4. **Don't modify unrelated files**: Only change files required by the current task
-5. **Commit when done**: \`git add -A && git commit -m "..."\`
-
-## Rules for fixing reviews
-1. Read each review comment carefully
-2. Distinguish between must-fix vs. suggestions
-3. If you disagree with a comment, explain why in the commit message
-4. Ensure fixes don't introduce new issues
-`;
-  writeFileSync(resolve(copilotDir, 'codex-instructions.md'), instructions);
-
-  // Add .gitignore entries
-  const gitignorePath = resolve(projectDir, '.gitignore');
-  const gitignoreEntry = '\n# Codex-Copilot state\n.codex-copilot/state.json\n';
-  if (existsSync(gitignorePath)) {
-    const content = readFileSync(gitignorePath, 'utf-8');
-    if (!content.includes('.codex-copilot/state.json')) {
-      writeFileSync(gitignorePath, content + gitignoreEntry);
-    }
-  }
-
-  log.info('.codex-copilot/ directory created');
-  log.blank();
-
-  // ===== Generate task decomposition prompt =====
-  log.step('Generating task decomposition prompt...');
-
-  const parsePrompt = buildParsePrompt(prdContent, copilotDir);
-  const promptPath = resolve(copilotDir, 'parse-prd-prompt.md');
-  writeFileSync(promptPath, parsePrompt);
-
-  log.info('Task decomposition prompt saved to: .codex-copilot/parse-prd-prompt.md');
-  log.blank();
-
-  // ===== Guide user to next steps =====
-  log.title('✅ Initialization complete!');
-  log.blank();
-  log.info(`AI Provider: ${providerInfo.name}`);
-  log.blank();
-
-  if (providerInfo.type === 'cli') {
-    // CLI provider: offer auto-decompose
-    const autoparse = await confirm(`Auto-invoke ${providerInfo.name} to decompose PRD?`);
-    if (autoparse) {
-      log.step(`Invoking ${providerInfo.name} to decompose PRD...`);
-      const result = await provider.executePrompt(providerId, promptPath, projectDir);
-      if (result.ok) {
-        log.info('PRD decomposition complete!');
-      }
-    } else {
-      showManualInstructions(providerInfo);
-    }
-  } else {
-    // IDE provider: show manual instructions
-    showManualInstructions(providerInfo);
-  }
-
-  closePrompt();
-}
-
-function showManualInstructions(providerInfo) {
-  log.info('Next steps:');
-  log.blank();
-  console.log('  ┌───────────────────────────────────────────────────┐');
-  console.log(`  │  1. Open ${providerInfo.name.padEnd(40)}│`);
-  console.log('  │  2. Paste the file content:                       │');
-  console.log('  │     .codex-copilot/parse-prd-prompt.md             │');
-  console.log('  │  3. AI will generate .codex-copilot/tasks.json    │');
-  console.log('  │  4. Then run: codex-copilot run                   │');
-  console.log('  └───────────────────────────────────────────────────┘');
-  log.blank();
-}
-
-function buildParsePrompt(prdContent, copilotDir) {
-  return `Read the following PRD document and break it down into independent development tasks.
-
-## Requirements
-1. Each task should be completable in a single PR (moderate granularity — not too large, not too small)
-2. Each task must have clear acceptance criteria
-3. Tasks should be ordered by dependency (dependent tasks first)
-4. The first task is usually "Project initialization / base framework setup"
-
-## Output Format
-Write the result to \`.codex-copilot/tasks.json\` in the following format:
-
-\`\`\`json
-{
-  "project": "Project Name",
-  "total": 5,
-  "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/001-task-slug",
-      "status": "pending",
-      "depends_on": []
-    },
-    {
-      "id": 2,
-      "title": "...",
-      "description": "...",
-      "acceptance": ["..."],
-      "branch": "feature/002-task-slug",
-      "status": "pending",
-      "depends_on": [1]
-    }
-  ]
-}
-\`\`\`
-
-## PRD Document Content
-
-${prdContent}
-`;
-}
+/**
+ * codex-copilot init - Initialize project
+ * 
+ * 1. Auto-detect PRD document
+ * 2. Let user confirm/select PRD
+ * 3. Select AI provider (Codex, Claude Code, Cursor, etc.)
+ * 4. Generate task decomposition prompt
+ * 5. Create .codex-copilot/ directory structure
+ */
+
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import { detectPRD, readPRD } from '../utils/detect-prd.js';
+import { log } from '../utils/logger.js';
+import { ask, confirm, select, closePrompt } from '../utils/prompt.js';
+import { git } from '../utils/git.js';
+import { github } from '../utils/github.js';
+import { provider } from '../utils/provider.js';
+
+export async function init(projectDir) {
+  log.title('📋 Initializing Codex-Copilot');
+  log.blank();
+
+  // ===== Pre-flight checks =====
+  log.step('Checking environment...');
+
+  // Check if in a git repo
+  try {
+    git.currentBranch(projectDir);
+    log.info('Git repository ✓');
+  } catch {
+    log.error('Not a Git repository. Run: git init');
+    closePrompt();
+    process.exit(1);
+  }
+
+  // Check gh CLI
+  if (!github.checkGhAuth()) {
+    log.error('GitHub CLI not authenticated. Run: gh auth login');
+    closePrompt();
+    process.exit(1);
+  }
+  log.info('GitHub CLI ✓');
+
+  // Check GitHub remote
+  try {
+    const repo = git.getRepoInfo(projectDir);
+    log.info(`GitHub repo: ${repo.owner}/${repo.repo} ✓`);
+  } catch (err) {
+    log.error(err.message);
+    closePrompt();
+    process.exit(1);
+  }
+
+  log.blank();
+
+  // ===== Detect PRD =====
+  log.step('Scanning for PRD documents...');
+  const candidates = detectPRD(projectDir);
+
+  let prdPath;
+
+  if (candidates.length === 0) {
+    log.warn('No PRD document detected automatically');
+    const manualPath = await ask('Enter PRD file path (relative or absolute):');
+    prdPath = resolve(projectDir, manualPath);
+    // Prevent path traversal
+    if (!prdPath.startsWith(resolve(projectDir)) && !manualPath.startsWith('/')) {
+      log.error('PRD path is outside the project directory');
+      closePrompt();
+      process.exit(1);
+    }
+    if (!existsSync(prdPath)) {
+      log.error(`File not found: ${prdPath}`);
+      closePrompt();
+      process.exit(1);
+    }
+  } else if (candidates.length === 1) {
+    prdPath = candidates[0].path;
+    log.info(`Found PRD: ${candidates[0].relativePath}`);
+    const ok = await confirm('Use this file?');
+    if (!ok) {
+      const manualPath = await ask('Enter PRD file path:');
+      prdPath = resolve(projectDir, manualPath);
+    }
+  } else {
+    log.info(`Found ${candidates.length} candidate PRD files:`);
+    const choice = await select('Select the PRD to use:', candidates.map(c => ({
+      label: `${c.relativePath} (score: ${c.score})`,
+      value: c.path,
+    })));
+    prdPath = choice.value;
+  }
+
+  log.info(`Using PRD: ${prdPath}`);
+  log.blank();
+
+  // ===== Read PRD =====
+  const prdContent = readPRD(prdPath);
+  log.info(`PRD size: ${(prdContent.length / 1024).toFixed(1)} KB`);
+
+  // ===== Select AI Provider =====
+  log.step('Select AI coding tool...');
+
+  // Check versions of installed CLI tools (non-blocking)
+  log.info('Checking tool versions...');
+  let versionCache = {};
+  try {
+    versionCache = provider.checkAllVersions();
+    const updatable = Object.entries(versionCache).filter(([, v]) => v.updateAvailable);
+    if (updatable.length > 0) {
+      for (const [id, v] of updatable) {
+        log.warn(`${provider.getProvider(id).name}: v${v.current} → v${v.latest} update available`);
+      }
+    } else if (Object.keys(versionCache).length > 0) {
+      log.info('All detected tools are up to date ✓');
+    }
+  } catch {
+    // Version check failed — continue normally
+  }
+
+  log.blank();
+  const providerChoices = provider.buildProviderChoices(versionCache);
+  const selectedProvider = await select('Which AI tool will you use?', providerChoices);
+  const providerId = selectedProvider.value;
+  const providerInfo = provider.getProvider(providerId);
+  log.info(`Selected: ${providerInfo.name}`);
+
+  // Offer update if newer version available
+  const vi = versionCache[providerId];
+  if (vi && vi.updateAvailable) {
+    log.blank();
+    log.warn(`${providerInfo.name} v${vi.current} → v${vi.latest} available`);
+    const doUpdate = await confirm(`Update ${providerInfo.name} now?`);
+    if (doUpdate) {
+      provider.updateProvider(providerId);
+    }
+  }
+
+  log.blank();
+
+  // ===== Create .codex-copilot directory =====
+  log.step('Creating .codex-copilot/ directory...');
+  const copilotDir = resolve(projectDir, '.codex-copilot');
+  mkdirSync(copilotDir, { recursive: true });
+
+  // Write config file
+  const config = {
+    provider: providerId,
+    prd_path: prdPath,
+    base_branch: git.currentBranch(projectDir) || 'main',
+    max_review_rounds: 2,
+    review_poll_interval: 60,
+    review_wait_timeout: 600,
+    created_at: new Date().toISOString(),
+  };
+  writeFileSync(resolve(copilotDir, 'config.json'), JSON.stringify(config, null, 2));
+
+  // Write initial state (matches checkpoint.js schema)
+  const state = {
+    current_task: 0,
+    phase: null,
+    phase_step: null,
+    current_pr: null,
+    review_round: 0,
+    branch: null,
+    status: 'initialized',
+    last_updated: new Date().toISOString(),
+  };
+  writeFileSync(resolve(copilotDir, 'state.json'), JSON.stringify(state, null, 2));
+
+  // Write CodeX instruction template
+  const instructions = `# Codex-Copilot Development Instructions
+
+## Role
+You are an efficient automated development agent responsible for completing feature development according to task descriptions.
+
+## Rules
+1. **Follow the project tech stack**: Use the existing frameworks, tools, and code style
+2. **Test first**: Ensure code compiles/runs before finishing
+3. **Git conventions**: Commit message format \`feat(task-N): brief description\` or \`fix(task-N): brief description\`
+4. **Don't modify unrelated files**: Only change files required by the current task
+5. **Commit when done**: \`git add -A && git commit -m "..."\`
+
+## Rules for fixing reviews
+1. Read each review comment carefully
+2. Distinguish between must-fix vs. suggestions
+3. If you disagree with a comment, explain why in the commit message
+4. Ensure fixes don't introduce new issues
+`;
+  writeFileSync(resolve(copilotDir, 'codex-instructions.md'), instructions);
+
+  // Add .gitignore entries
+  const gitignorePath = resolve(projectDir, '.gitignore');
+  const gitignoreEntry = '\n# Codex-Copilot state\n.codex-copilot/state.json\n';
+  if (existsSync(gitignorePath)) {
+    const content = readFileSync(gitignorePath, 'utf-8');
+    if (!content.includes('.codex-copilot/state.json')) {
+      writeFileSync(gitignorePath, content + gitignoreEntry);
+    }
+  }
+
+  log.info('.codex-copilot/ directory created');
+  log.blank();
+
+  // ===== Generate task decomposition prompt =====
+  log.step('Generating task decomposition prompt...');
+
+  const parsePrompt = buildParsePrompt(prdContent, copilotDir);
+  const promptPath = resolve(copilotDir, 'parse-prd-prompt.md');
+  writeFileSync(promptPath, parsePrompt);
+
+  log.info('Task decomposition prompt saved to: .codex-copilot/parse-prd-prompt.md');
+  log.blank();
+
+  // ===== Guide user to next steps =====
+  log.title('✅ Initialization complete!');
+  log.blank();
+  log.info(`AI Provider: ${providerInfo.name}`);
+  log.blank();
+
+  if (providerInfo.type === 'cli') {
+    // CLI provider: offer auto-decompose
+    const autoparse = await confirm(`Auto-invoke ${providerInfo.name} to decompose PRD?`);
+    if (autoparse) {
+      log.step(`Invoking ${providerInfo.name} to decompose PRD...`);
+      const result = await provider.executePrompt(providerId, promptPath, projectDir);
+      if (result.ok) {
+        log.info('PRD decomposition complete!');
+      }
+    } else {
+      showManualInstructions(providerInfo);
+    }
+  } else {
+    // IDE provider: show manual instructions
+    showManualInstructions(providerInfo);
+  }
+
+  closePrompt();
+}
+
+function showManualInstructions(providerInfo) {
+  log.info('Next steps:');
+  log.blank();
+  console.log('  ┌───────────────────────────────────────────────────┐');
+  console.log(`  │  1. Open ${providerInfo.name.padEnd(40)}│`);
+  console.log('  │  2. Paste the file content:                       │');
+  console.log('  │     .codex-copilot/parse-prd-prompt.md             │');
+  console.log('  │  3. AI will generate .codex-copilot/tasks.json    │');
+  console.log('  │  4. Then run: codex-copilot run                   │');
+  console.log('  └───────────────────────────────────────────────────┘');
+  log.blank();
+}
+
+function buildParsePrompt(prdContent, copilotDir) {
+  return `Read the following PRD document and break it down into independent development tasks.
+
+## Requirements
+1. Each task should be completable in a single PR (moderate granularity — not too large, not too small)
+2. Each task must have clear acceptance criteria
+3. Tasks should be ordered by dependency (dependent tasks first)
+4. The first task is usually "Project initialization / base framework setup"
+
+## Output Format
+Write the result to \`.codex-copilot/tasks.json\` in the following format:
+
+\`\`\`json
+{
+  "project": "Project Name",
+  "total": 5,
+  "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/001-task-slug",
+      "status": "pending",
+      "depends_on": []
+    },
+    {
+      "id": 2,
+      "title": "...",
+      "description": "...",
+      "acceptance": ["..."],
+      "branch": "feature/002-task-slug",
+      "status": "pending",
+      "depends_on": [1]
+    }
+  ]
+}
+\`\`\`
+
+## PRD Document Content
+
+${prdContent}
+`;
+}