@jojonax/codex-copilot 1.0.2 → 1.1.0

package/bin/cli.js

@@ -1,31 +1,39 @@
 #!/usr/bin/env node
 
 /**
- * codex-copilot CLI - PRD → 自动开发 → PR → Review → 修复 → 合并
+ * codex-copilot CLI - PRD → Auto Dev → PR → Review → Fix → Merge
  * 
- * 用法:
- *   codex-copilot init          # 初始化项目（自动检测 PRD，生成任务）
- *   codex-copilot run           # 启动自动化开发循环
- *   codex-copilot status        # 查看当前进度
- *   codex-copilot reset         # 重置状态（重新开始）
+ * Usage:
+ *   codex-copilot init          # Initialize project (auto-detect PRD, generate tasks)
+ *   codex-copilot run           # Start automated development loop
+ *   codex-copilot status        # View current progress
+ *   codex-copilot reset         # Reset state (start over)
  */
 
-import { resolve } from 'path';
-import { existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
 
 import { init } from '../src/commands/init.js';
 import { run } from '../src/commands/run.js';
 import { status } from '../src/commands/status.js';
 import { reset } from '../src/commands/reset.js';
 import { log } from '../src/utils/logger.js';
+import { checkForUpdates } from '../src/utils/update-check.js';
 
 const command = process.argv[2];
 const projectDir = process.cwd();
 
+// Read version from package.json
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'));
+const version = pkg.version;
+
 // Banner
 console.log('');
 console.log('  ╔══════════════════════════════════════════╗');
-console.log('  ║     🤖  Codex-Copilot  v1.0              ║');
+console.log(`  ║     🤖  Codex-Copilot  v${version.padEnd(18)}║`);
 console.log('  ║     PRD-Driven Auto Development          ║');
 console.log('  ╚══════════════════════════════════════════╝');
 console.log('');
@@ -39,7 +47,7 @@ async function main() {
 
       case 'run':
         if (!existsSync(resolve(projectDir, '.codex-copilot/tasks.json'))) {
-          log.error('尚未初始化，请先运行: codex-copilot init');
+          log.error('Not initialized. Run: codex-copilot init');
           process.exit(1);
         }
         await run(projectDir);
@@ -47,7 +55,7 @@ async function main() {
 
       case 'status':
         if (!existsSync(resolve(projectDir, '.codex-copilot/tasks.json'))) {
-          log.error('尚未初始化，请先运行: codex-copilot init');
+          log.error('Not initialized. Run: codex-copilot init');
           process.exit(1);
         }
         await status(projectDir);
@@ -58,26 +66,29 @@ async function main() {
         break;
 
       default:
-        console.log('  用法: codex-copilot <command>');
+        console.log('  Usage: codex-copilot <command>');
         console.log('');
-        console.log('  命令:');
-        console.log('    init      初始化项目（自动检测 PRD，生成任务队列）');
-        console.log('    run       启动自动化开发循环');
-        console.log('    status    查看当前任务进度');
-        console.log('    reset     重置状态，重新开始');
+        console.log('  Commands:');
+        console.log('    init      Initialize project (auto-detect PRD, generate task queue)');
+        console.log('    run       Start automated development loop');
+        console.log('    status    View current task progress');
+        console.log('    reset     Reset state and start over');
         console.log('');
-        console.log('  工作流程:');
-        console.log('    1. cd 到你的项目目录');
-        console.log('    2. codex-copilot init    (自动检测 PRD 并拆解任务)');
-        console.log('    3. codex-copilot run     (开始自动开发循环)');
+        console.log('  Workflow:');
+        console.log('    1. cd into your project directory');
+        console.log('    2. codex-copilot init    (auto-detect PRD and decompose tasks)');
+        console.log('    3. codex-copilot run     (start automated dev loop)');
         console.log('');
         break;
     }
   } catch (err) {
-    log.error(`执行失败: ${err.message}`);
+    log.error(`Execution failed: ${err.message}`);
     if (process.env.DEBUG) console.error(err);
     process.exit(1);
   }
 }
 
+// Check for updates (non-blocking, cached 24h)
+checkForUpdates(version);
+
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jojonax/codex-copilot",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "PRD-driven automated development orchestrator for CodeX / Cursor",
   "bin": {
     "codex-copilot": "./bin/cli.js"

package/src/commands/init.js

@@ -1,50 +1,51 @@
 /**
- * codex-copilot init - 初始化项目
+ * codex-copilot init - Initialize project
  * 
- * 1. 自动检测 PRD 文档
- * 2. 让用户确认/选择 PRD
- * 3. 生成 CodeX 可执行的任务拆解 Prompt
- * 4. 创建 .codex-copilot/ 目录结构
+ * 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 { execSync } from 'child_process';
 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('📋 初始化 Codex-Copilot');
+  log.title('📋 Initializing Codex-Copilot');
   log.blank();
 
-  // ===== 前置检查 =====
-  log.step('检查环境...');
+  // ===== Pre-flight checks =====
+  log.step('Checking environment...');
 
-  // 检查是否在 git 仓库中
+  // Check if in a git repo
   try {
     git.currentBranch(projectDir);
-    log.info('Git 仓库 ✓');
+    log.info('Git repository ✓');
   } catch {
-    log.error('当前目录不是 Git 仓库，请先 git init');
+    log.error('Not a Git repository. Run: git init');
     closePrompt();
     process.exit(1);
   }
 
-  // 检查 gh CLI
+  // Check gh CLI
   if (!github.checkGhAuth()) {
-    log.error('GitHub CLI 未登录，请先运行: gh auth login');
+    log.error('GitHub CLI not authenticated. Run: gh auth login');
     closePrompt();
     process.exit(1);
   }
   log.info('GitHub CLI ✓');
 
-  // 检查 GitHub remote
+  // Check GitHub remote
   try {
     const repo = git.getRepoInfo(projectDir);
-    log.info(`GitHub 仓库: ${repo.owner}/${repo.repo} ✓`);
+    log.info(`GitHub repo: ${repo.owner}/${repo.repo} ✓`);
   } catch (err) {
     log.error(err.message);
     closePrompt();
@@ -53,58 +54,69 @@ export async function init(projectDir) {
 
   log.blank();
 
-  // ===== 检测 PRD =====
-  log.step('扫描 PRD 文档...');
+  // ===== Detect PRD =====
+  log.step('Scanning for PRD documents...');
   const candidates = detectPRD(projectDir);
 
   let prdPath;
 
   if (candidates.length === 0) {
-    log.warn('未自动检测到 PRD 文档');
-    const manualPath = await ask('请输入 PRD 文件路径（相对或绝对路径）:');
+    log.warn('No PRD document detected automatically');
+    const manualPath = await ask('Enter PRD file path (relative or absolute):');
     prdPath = resolve(projectDir, manualPath);
-    // 防止路径穿越：确保 PRD 路径在项目目录内或是绝对路径
+    // Prevent path traversal
     if (!prdPath.startsWith(resolve(projectDir)) && !manualPath.startsWith('/')) {
-      log.error('PRD 路径不在项目目录内');
+      log.error('PRD path is outside the project directory');
       closePrompt();
       process.exit(1);
     }
     if (!existsSync(prdPath)) {
-      log.error(`文件不存在: ${prdPath}`);
+      log.error(`File not found: ${prdPath}`);
       closePrompt();
       process.exit(1);
     }
   } else if (candidates.length === 1) {
     prdPath = candidates[0].path;
-    log.info(`找到 PRD: ${candidates[0].relativePath}`);
-    const ok = await confirm('使用该文件？');
+    log.info(`Found PRD: ${candidates[0].relativePath}`);
+    const ok = await confirm('Use this file?');
     if (!ok) {
-      const manualPath = await ask('请输入 PRD 文件路径:');
+      const manualPath = await ask('Enter PRD file path:');
       prdPath = resolve(projectDir, manualPath);
     }
   } else {
-    log.info(`找到 ${candidates.length} 个候选 PRD 文件:`);
-    const choice = await select('请选择要使用的 PRD:', candidates.map(c => ({
-      label: `${c.relativePath} (匹配度: ${c.score})`,
+    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(`使用 PRD: ${prdPath}`);
+  log.info(`Using PRD: ${prdPath}`);
   log.blank();
 
-  // ===== 读取 PRD =====
+  // ===== Read PRD =====
   const prdContent = readPRD(prdPath);
-  log.info(`PRD 大小: ${(prdContent.length / 1024).toFixed(1)} KB`);
+  log.info(`PRD size: ${(prdContent.length / 1024).toFixed(1)} KB`);
 
-  // ===== 创建 .codex-copilot 目录 =====
-  log.step('创建 .codex-copilot/ 目录...');
+  // ===== Select AI Provider =====
+  log.step('Select AI coding tool...');
+  log.blank();
+  const providerChoices = provider.buildProviderChoices();
+  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}`);
+  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,
@@ -114,37 +126,41 @@ export async function init(projectDir) {
   };
   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));
 
-  // 写入 CodeX 指令模板
-  const instructions = `# Codex-Copilot 开发指令
+  // Write CodeX instruction template
+  const instructions = `# Codex-Copilot Development Instructions
 
-## 角色
-你是一个高效的自动开发 Agent，负责按照任务描述完成功能开发。
+## Role
+You are an efficient automated development agent responsible for completing feature development according to task descriptions.
 
-## 规则
-1. **严格遵循项目技术栈**：使用项目已有的框架、工具和代码风格
-2. **自测优先**：开发完成前确保代码可以编译/运行
-3. **Git 规范**：提交信息格式 \`feat(task-N): 简要描述\` 或 \`fix(task-N): 简要描述\`
-4. **不要修改无关文件**：只修改当前任务需要的文件
-5. **完成后执行 git commit**：\`git add -A && git commit -m "..."\`
+## 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 "..."\`
 
-## 修复 Review 时的规则
-1. 逐条阅读 Review 意见
-2. 区分必须修复 vs 建议性意见
-3. 对于不认同的意见，在 commit message 中说明原因
-4. 修复后确保不引入新问题
+## 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);
 
-  // 添加 .gitignore 项
+  // Add .gitignore entries
   const gitignorePath = resolve(projectDir, '.gitignore');
   const gitignoreEntry = '\n# Codex-Copilot state\n.codex-copilot/state.json\n';
   if (existsSync(gitignorePath)) {
@@ -154,88 +170,80 @@ export async function init(projectDir) {
     }
   }
 
-  log.info('.codex-copilot/ 目录已创建');
+  log.info('.codex-copilot/ directory created');
   log.blank();
 
-  // ===== 生成任务拆解 Prompt =====
-  log.step('生成任务拆解 Prompt...');
+  // ===== 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(`任务拆解 Prompt 已保存到: .codex-copilot/parse-prd-prompt.md`);
+  log.info('Task decomposition prompt saved to: .codex-copilot/parse-prd-prompt.md');
   log.blank();
 
-  // ===== 提示用户下一步 =====
-  log.title('✅ 初始化完成！');
-  log.blank();
-  log.info('接下来请执行以下步骤：');
+  // ===== Guide user to next steps =====
+  log.title('✅ Initialization complete!');
   log.blank();
-  console.log('  ┌───────────────────────────────────────────────────┐');
-  console.log('  │  1. 打开 CodeX 桌面版                              │');
-  console.log('  │  2. 将以下文件内容粘贴给 CodeX 执行：               │');
-  console.log('  │     .codex-copilot/parse-prd-prompt.md             │');
-  console.log('  │  3. CodeX 会生成 .codex-copilot/tasks.json         │');
-  console.log('  │  4. 确认任务列表后运行:                             │');
-  console.log('  │     codex-copilot run                              │');
-  console.log('  └───────────────────────────────────────────────────┘');
+  log.info(`AI Provider: ${providerInfo.name}`);
   log.blank();
 
-  // 询问是否尝试自动拆解（如果 codex CLI 可用）
-  const hasCodexCLI = checkCodexCLI();
-  if (hasCodexCLI) {
-    log.info('检测到 CodeX CLI 可用！');
-    const autoparse = await confirm('是否自动调用 CodeX 拆解 PRD？');
+  if (providerInfo.type === 'cli') {
+    // CLI provider: offer auto-decompose
+    const autoparse = await confirm(`Auto-invoke ${providerInfo.name} to decompose PRD?`);
     if (autoparse) {
-      log.step('调用 CodeX CLI 拆解 PRD...');
-      try {
-        execSync(`codex -q --file .codex-copilot/parse-prd-prompt.md`, {
-          cwd: projectDir,
-          stdio: 'inherit',
-        });
-        log.info('CodeX 拆解完成！');
-      } catch {
-        log.warn('CodeX CLI 调用失败，请手动执行');
+      log.step(`Invoking ${providerInfo.name} to decompose PRD...`);
+      const ok = await provider.executePrompt(providerId, promptPath, projectDir);
+      if (ok) {
+        log.info('PRD decomposition complete!');
       }
+    } else {
+      showManualInstructions(providerInfo);
     }
+  } else {
+    // IDE provider: show manual instructions
+    showManualInstructions(providerInfo);
   }
 
   closePrompt();
 }
 
-function checkCodexCLI() {
-  try {
-    const cmd = process.platform === 'win32' ? 'where codex' : 'which codex';
-    execSync(cmd, { stdio: 'pipe' });
-    return true;
-  } catch {
-    return false;
-  }
+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 `请阅读以下 PRD 文档，将其拆解为独立的开发任务。
+  return `Read the following PRD document and break it down into independent development tasks.
 
-## 要求
-1. 每个任务在一个 PR 中可以完成（粒度适中，不要太大也不要太碎）
-2. 有明确的验收标准
-3. 按依赖关系排序（被依赖的任务排在前面）
-4. 第一个任务通常是"项目初始化 / 基础框架搭建"
+## 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"
 
-## 输出格式
-将结果输出到 \`.codex-copilot/tasks.json\`，格式如下：
+## Output Format
+Write the result to \`.codex-copilot/tasks.json\` in the following format:
 
 \`\`\`json
 {
-  "project": "项目名称",
+  "project": "Project Name",
   "total": 5,
   "tasks": [
     {
       "id": 1,
-      "title": "任务标题（简短）",
-      "description": "详细的任务描述，包含需要实现的具体功能和技术细节",
-      "acceptance": ["验收条件1", "验收条件2"],
+      "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": []
@@ -253,7 +261,7 @@ function buildParsePrompt(prdContent, copilotDir) {
 }
 \`\`\`
 
-## PRD 文档内容
+## PRD Document Content
 
 ${prdContent}
 `;

package/src/commands/reset.js

@@ -1,52 +1,60 @@
 /**
- * codex-copilot reset - 重置状态
+ * codex-copilot reset - Reset state
  */
 
 import { readFileSync, writeFileSync, existsSync, unlinkSync } from 'fs';
 import { resolve } from 'path';
 import { log } from '../utils/logger.js';
 import { confirm, closePrompt } from '../utils/prompt.js';
+import { createCheckpoint } from '../utils/checkpoint.js';
 
 export async function reset(projectDir) {
   const statePath = resolve(projectDir, '.codex-copilot/state.json');
   const tasksPath = resolve(projectDir, '.codex-copilot/tasks.json');
 
   if (!existsSync(statePath)) {
-    log.warn('项目未初始化，无需重置');
+    log.warn('Project not initialized, nothing to reset');
     closePrompt();
     return;
   }
 
-  log.title('🔄 重置 Codex-Copilot 状态');
+  log.title('🔄 Resetting Codex-Copilot state');
   log.blank();
 
-  const resetTasks = await confirm('是否同时重置任务状态 (所有任务标记为 pending)？', false);
+  const checkpoint = createCheckpoint(projectDir);
+  const state = checkpoint.load();
 
-  // 重置 state
-  const state = {
-    current_task: 0,
-    current_pr: null,
-    review_round: 0,
-    status: 'initialized',
-  };
-  writeFileSync(statePath, JSON.stringify(state, null, 2));
-  log.info('执行状态已重置');
+  // Show current checkpoint before reset
+  if (state.phase) {
+    log.info(`Current checkpoint: Task #${state.current_task} — ${state.phase} → ${state.phase_step}`);
+    log.blank();
+  }
+
+  const resetTasks = await confirm('Also reset all task statuses to pending?', false);
 
-  // 重置任务状态
+  // Reset state using checkpoint manager
+  checkpoint.reset();
+  log.info('Execution state reset');
+
+  // Reset task statuses
   if (resetTasks && existsSync(tasksPath)) {
     const tasks = JSON.parse(readFileSync(tasksPath, 'utf-8'));
     for (const task of tasks.tasks) {
       task.status = 'pending';
     }
     writeFileSync(tasksPath, JSON.stringify(tasks, null, 2));
-    log.info('任务状态已重置');
+    log.info('Task statuses reset');
   }
 
-  // 清理临时文件
+  // Clean up temp files
   const promptPath = resolve(projectDir, '.codex-copilot/_current_prompt.md');
   if (existsSync(promptPath)) unlinkSync(promptPath);
 
+  // Clean up temp state file if exists
+  const tempPath = resolve(projectDir, '.codex-copilot/state.json.tmp');
+  if (existsSync(tempPath)) unlinkSync(tempPath);
+
   log.blank();
-  log.info('✅ 重置完成，可以重新运行 codex-copilot run');
+  log.info('✅ Reset complete. You can now run: codex-copilot run');
   closePrompt();
 }