@jojonax/codex-copilot 1.0.0

package/src/commands/run.js

@@ -0,0 +1,413 @@
+/**
+ * codex-copilot run - 主编排循环
+ * 
+ * 逐个任务执行: 开发 → PR → Review → 修复 → 合并 → 下一个
+ */
+
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import { log, progressBar } from '../utils/logger.js';
+import { git } from '../utils/git.js';
+import { github } from '../utils/github.js';
+import { ask, confirm, closePrompt } from '../utils/prompt.js';
+
+function readJSON(path) {
+  return JSON.parse(readFileSync(path, 'utf-8'));
+}
+
+function writeJSON(path, data) {
+  writeFileSync(path, JSON.stringify(data, null, 2));
+}
+
+export async function run(projectDir) {
+  const tasksPath = resolve(projectDir, '.codex-copilot/tasks.json');
+  const statePath = resolve(projectDir, '.codex-copilot/state.json');
+  const configPath = resolve(projectDir, '.codex-copilot/config.json');
+
+  const tasks = readJSON(tasksPath);
+  let state = readJSON(statePath);
+  const config = existsSync(configPath) ? readJSON(configPath) : {};
+
+  const baseBranch = config.base_branch || 'main';
+  const maxReviewRounds = config.max_review_rounds || 2;
+  const pollInterval = config.review_poll_interval || 60;
+  const waitTimeout = config.review_wait_timeout || 600;
+
+  log.title('🚀 开始自动化开发循环');
+  log.blank();
+  log.info(`项目: ${tasks.project}`);
+  log.info(`总任务数: ${tasks.total}`);
+  log.info(`已完成: ${state.current_task}`);
+  log.info(`基础分支: ${baseBranch}`);
+  log.blank();
+  progressBar(state.current_task, tasks.total, `${state.current_task}/${tasks.total} 任务完成`);
+  log.blank();
+
+  // 逐个任务执行
+  for (const task of tasks.tasks) {
+    if (task.id <= state.current_task) continue; // 跳过已完成的
+    if (task.status === 'completed' || task.status === 'skipped') continue;
+
+    log.blank();
+    log.title(`━━━ 任务 ${task.id}/${tasks.total}: ${task.title} ━━━`);
+    log.blank();
+
+    // 检查依赖是否已完成
+    if (task.depends_on && task.depends_on.length > 0) {
+      const unfinished = task.depends_on.filter(dep => {
+        const depTask = tasks.tasks.find(t => t.id === dep);
+        return depTask && depTask.status !== 'completed';
+      });
+      if (unfinished.length > 0) {
+        log.warn(`依赖任务未完成: ${unfinished.join(', ')}，跳过`);
+        continue;
+      }
+    }
+
+    // ===== 阶段 1: 开发 =====
+    await developPhase(projectDir, task, baseBranch);
+
+    // ===== 阶段 2: 创建 PR =====
+    const prInfo = await prPhase(projectDir, task, baseBranch);
+
+    // ===== 阶段 3: Review 循环 =====
+    await reviewLoop(projectDir, task, prInfo, {
+      maxRounds: maxReviewRounds,
+      pollInterval,
+      waitTimeout,
+    });
+
+    // ===== 阶段 4: 合并 =====
+    await mergePhase(projectDir, task, prInfo);
+
+    // 更新任务状态
+    task.status = 'completed';
+    state.current_task = task.id;
+    state.current_pr = null;
+    state.review_round = 0;
+    writeJSON(tasksPath, tasks);
+    writeJSON(statePath, state);
+
+    log.blank();
+    progressBar(task.id, tasks.total, `${task.id}/${tasks.total} 任务完成`);
+    log.info(`✅ 任务 #${task.id} 完成！`);
+  }
+
+  log.blank();
+  log.title('🎉 所有任务已完成！');
+  log.blank();
+  closePrompt();
+}
+
+// ──────────────────────────────────────────────
+// 阶段 1: 开发
+// ──────────────────────────────────────────────
+async function developPhase(projectDir, task, baseBranch) {
+  log.step('阶段 1/4: 开发');
+
+  // 切换到 feature 分支
+  git.checkoutBranch(projectDir, task.branch, baseBranch);
+  log.info(`已切换到分支: ${task.branch}`);
+
+  // 构建开发 Prompt
+  const devPrompt = buildDevPrompt(task);
+
+  // 检查是否有 CodeX CLI
+  let codexAvailable = false;
+  try {
+    const { execSync } = await import('child_process');
+    execSync('which codex', { stdio: 'pipe' });
+    codexAvailable = true;
+  } catch {}
+
+  if (codexAvailable) {
+    log.info('检测到 CodeX CLI，自动执行...');
+    const autoRun = await confirm('自动调用 CodeX 开发？');
+    if (autoRun) {
+      try {
+        const { execSync } = await import('child_process');
+        // 将 prompt 写入临时文件
+        const promptPath = resolve(projectDir, '.codex-copilot/_current_prompt.md');
+        const { writeFileSync } = await import('fs');
+        writeFileSync(promptPath, devPrompt);
+        execSync(`codex -q --file .codex-copilot/_current_prompt.md`, {
+          cwd: projectDir,
+          stdio: 'inherit',
+        });
+        log.info('CodeX 开发完成');
+        return;
+      } catch (err) {
+        log.warn(`CodeX CLI 调用失败: ${err.message}`);
+        log.warn('回退到手动模式');
+      }
+    }
+  }
+
+  // 手动模式：显示 Prompt，等待用户确认
+  log.blank();
+  console.log('  ┌─── 请将以下内容粘贴到 CodeX 桌面版中执行 ───┐');
+  log.blank();
+  console.log(devPrompt.split('\n').map(l => `  │ ${l}`).join('\n'));
+  log.blank();
+  console.log('  └──────────────────────────────────────────────┘');
+  log.blank();
+
+  // 同时将 Prompt 保存到文件，方便复制
+  const promptPath = resolve(projectDir, '.codex-copilot/_current_prompt.md');
+  const { writeFileSync: ws } = await import('fs');
+  ws(promptPath, devPrompt);
+  log.dim(`Prompt 已保存到 .codex-copilot/_current_prompt.md (可直接复制文件内容)`);
+  log.blank();
+
+  // 尝试复制到剪贴板
+  try {
+    const { execSync } = await import('child_process');
+    execSync(`echo '${devPrompt.replace(/'/g, "\\'")}' | pbcopy`, { stdio: 'pipe' });
+    log.info('📋 已复制到剪贴板！直接到 CodeX 中粘贴即可');
+  } catch {}
+
+  await ask('CodeX 开发完成后按 Enter 继续...');
+}
+
+// ──────────────────────────────────────────────
+// 阶段 2: 创建 PR
+// ──────────────────────────────────────────────
+async function prPhase(projectDir, task, baseBranch) {
+  log.step('阶段 2/4: 提交 PR');
+
+  // 确保变更已提交
+  if (!git.isClean(projectDir)) {
+    log.info('检测到未提交的变更，自动提交...');
+    git.commitAll(projectDir, `feat(task-${task.id}): ${task.title}`);
+  }
+
+  // 推送
+  git.pushBranch(projectDir, task.branch);
+  log.info('代码已推送');
+
+  // 创建 PR
+  const prBody = `## 任务 #${task.id}: ${task.title}\n\n${task.description}\n\n### 验收标准\n${task.acceptance.map(a => `- [ ] ${a}`).join('\n')}\n\n---\n*由 Codex-Copilot 自动创建*`;
+
+  try {
+    const prInfo = github.createPR(projectDir, {
+      title: `feat(task-${task.id}): ${task.title}`,
+      body: prBody,
+      base: baseBranch,
+      head: task.branch,
+    });
+    log.info(`PR 已创建: ${prInfo.url}`);
+    return prInfo;
+  } catch (err) {
+    // PR 可能已存在
+    log.warn(`创建 PR 异常: ${err.message}`);
+    const prNumber = await ask('请输入已存在的 PR 编号:');
+    return { number: parseInt(prNumber), url: '' };
+  }
+}
+
+// ──────────────────────────────────────────────
+// 阶段 3: Review 循环
+// ──────────────────────────────────────────────
+async function reviewLoop(projectDir, task, prInfo, { maxRounds, pollInterval, waitTimeout }) {
+  log.step('阶段 3/4: 等待 Review');
+
+  for (let round = 1; round <= maxRounds; round++) {
+    // 等待 Review
+    log.info(`等待 Review 意见... (超时: ${waitTimeout}s)`);
+    const gotReview = await waitForReview(projectDir, prInfo.number, pollInterval, waitTimeout);
+
+    if (!gotReview) {
+      log.warn('等待 Review 超时');
+      const action = await ask('输入 skip (跳过Review) 或 wait (继续等待):');
+      if (action === 'wait') {
+        round--;
+        continue;
+      }
+      break;
+    }
+
+    // 检查 Review 状态
+    const state = github.getLatestReviewState(projectDir, prInfo.number);
+    log.info(`Review 状态: ${state}`);
+
+    if (state === 'APPROVED') {
+      log.info('✅ Review 已通过！');
+      return;
+    }
+
+    // 收集 Review 反馈
+    const feedback = github.collectReviewFeedback(projectDir, prInfo.number);
+    if (!feedback) {
+      log.info('未发现具体修改意见，继续');
+      return;
+    }
+
+    log.blank();
+    log.warn(`收到 Review 意见 (第 ${round}/${maxRounds} 轮)`);
+
+    if (round >= maxRounds) {
+      log.warn(`已达最大修复轮次 (${maxRounds})`);
+      const choice = await ask('输入 merge (强制合并) / fix (再修一轮) / skip (跳过):');
+      if (choice === 'fix') {
+        maxRounds++;
+      } else if (choice === 'skip') {
+        return;
+      } else {
+        return; // merge
+      }
+    }
+
+    // 让 CodeX 修复
+    await fixPhase(projectDir, task, feedback, round);
+
+    // 推送修复
+    if (!git.isClean(projectDir)) {
+      git.commitAll(projectDir, `fix(task-${task.id}): address review comments (round ${round})`);
+    }
+    git.pushBranch(projectDir, task.branch);
+    log.info('修复已推送，等待新一轮 Review...');
+
+    // 稍等一下让 Review bot 反应
+    await sleep(10000);
+  }
+}
+
+async function waitForReview(projectDir, prNumber, pollInterval, timeout) {
+  let elapsed = 0;
+  const startReviewCount = github.getReviews(projectDir, prNumber).length;
+
+  while (elapsed < timeout) {
+    await sleep(pollInterval * 1000);
+    elapsed += pollInterval;
+
+    const currentReviews = github.getReviews(projectDir, prNumber);
+    const currentComments = github.getIssueComments(projectDir, prNumber);
+
+    // 检查是否有新的 Review 或 Bot 评论
+    const hasNewReview = currentReviews.length > startReviewCount;
+    const hasBotComment = currentComments.some(c =>
+      (c.user?.type === 'Bot' || c.user?.login?.includes('bot')) &&
+      new Date(c.created_at) > new Date(Date.now() - elapsed * 1000)
+    );
+
+    if (hasNewReview || hasBotComment) {
+      return true;
+    }
+
+    process.stdout.write('.');
+  }
+  console.log('');
+  return false;
+}
+
+// ──────────────────────────────────────────────
+// 修复阶段
+// ──────────────────────────────────────────────
+async function fixPhase(projectDir, task, feedback, round) {
+  log.step(`修复 Review 意见 (第 ${round} 轮)`);
+
+  const fixPrompt = `以下是 PR Review 的意见，请逐一修复：
+
+## Review 意见
+${feedback}
+
+## 要求
+1. 逐条修复上述问题
+2. 建议性意见可以不修复，但在 commit message 中说明原因
+3. 修复后确保不引入新问题
+4. 完成后执行: git add -A && git commit -m "fix(task-${task.id}): address review round ${round}"
+`;
+
+  // 保存到文件并提示用户
+  const promptPath = resolve(projectDir, '.codex-copilot/_current_prompt.md');
+  const { writeFileSync } = await import('fs');
+  writeFileSync(promptPath, fixPrompt);
+
+  // 尝试 CodeX CLI
+  let codexAvailable = false;
+  try {
+    const { execSync } = await import('child_process');
+    execSync('which codex', { stdio: 'pipe' });
+    codexAvailable = true;
+  } catch {}
+
+  if (codexAvailable) {
+    const autoFix = await confirm('自动调用 CodeX 修复？');
+    if (autoFix) {
+      try {
+        const { execSync } = await import('child_process');
+        execSync(`codex -q --file .codex-copilot/_current_prompt.md`, {
+          cwd: projectDir,
+          stdio: 'inherit',
+        });
+        log.info('CodeX 修复完成');
+        return;
+      } catch {
+        log.warn('CodeX CLI 调用失败，回退到手动模式');
+      }
+    }
+  }
+
+  // 手动模式
+  log.blank();
+  log.dim(`Review 修复 Prompt 已保存到 .codex-copilot/_current_prompt.md`);
+  log.dim('请将文件内容粘贴到 CodeX 执行');
+
+  try {
+    const { execSync } = await import('child_process');
+    execSync(`cat .codex-copilot/_current_prompt.md | pbcopy`, { cwd: projectDir, stdio: 'pipe' });
+    log.info('📋 已复制到剪贴板');
+  } catch {}
+
+  await ask('CodeX 修复完成后按 Enter 继续...');
+}
+
+// ──────────────────────────────────────────────
+// 阶段 4: 合并
+// ──────────────────────────────────────────────
+async function mergePhase(projectDir, task, prInfo) {
+  log.step('阶段 4/4: 合并 PR');
+
+  const doMerge = await confirm(`合并 PR #${prInfo.number}？`);
+  if (!doMerge) {
+    log.warn('用户跳过合并');
+    return;
+  }
+
+  try {
+    github.mergePR(projectDir, prInfo.number);
+    log.info(`PR #${prInfo.number} 已合并 ✅`);
+  } catch (err) {
+    log.error(`合并失败: ${err.message}`);
+    log.warn('请手动合并后按 Enter 继续');
+    await ask('继续...');
+  }
+
+  // 切回主分支
+  const configPath = resolve(projectDir, '.codex-copilot/config.json');
+  const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+  git.checkoutMain(projectDir, config.base_branch || 'main');
+}
+
+function buildDevPrompt(task) {
+  return `请完成以下开发任务：
+
+## 任务 #${task.id}: ${task.title}
+
+${task.description}
+
+## 验收标准
+${task.acceptance.map(a => `- ${a}`).join('\n')}
+
+## 要求
+1. 严格按照项目现有的代码规范和技术栈
+2. 完成后确保代码可以正常编译/运行
+3. 完成后执行:
+   git add -A
+   git commit -m "feat(task-${task.id}): ${task.title}"
+`;
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}

package/src/commands/status.js

@@ -0,0 +1,52 @@
+/**
+ * codex-copilot status - 显示当前进度
+ */
+
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+import { log, progressBar } from '../utils/logger.js';
+
+export async function status(projectDir) {
+  const tasksPath = resolve(projectDir, '.codex-copilot/tasks.json');
+  const statePath = resolve(projectDir, '.codex-copilot/state.json');
+
+  const tasks = JSON.parse(readFileSync(tasksPath, 'utf-8'));
+  const state = JSON.parse(readFileSync(statePath, 'utf-8'));
+
+  log.title(`📊 项目: ${tasks.project}`);
+  log.blank();
+
+  // 进度条
+  const completed = tasks.tasks.filter(t => t.status === 'completed').length;
+  const inProgress = tasks.tasks.filter(t => t.status === 'in_progress' || t.status === 'developed').length;
+  const pending = tasks.tasks.filter(t => t.status === 'pending').length;
+  const skipped = tasks.tasks.filter(t => t.status === 'skipped').length;
+
+  progressBar(completed, tasks.total, `${completed}/${tasks.total} 完成`);
+  log.blank();
+
+  // 统计
+  log.info(`✅ 已完成: ${completed}`);
+  if (inProgress > 0) log.info(`🔄 进行中: ${inProgress}`);
+  log.info(`⏳ 待开发: ${pending}`);
+  if (skipped > 0) log.warn(`⏭  已跳过: ${skipped}`);
+  log.blank();
+
+  // 当前状态
+  if (state.current_pr) {
+    log.info(`当前 PR: #${state.current_pr} (Review 第 ${state.review_round} 轮)`);
+  }
+  log.blank();
+
+  // 任务列表
+  log.title('任务列表:');
+  log.blank();
+  for (const task of tasks.tasks) {
+    const icon = task.status === 'completed' ? '✅' :
+                 task.status === 'in_progress' ? '🔄' :
+                 task.status === 'developed' ? '📦' :
+                 task.status === 'skipped' ? '⏭ ' : '⬜';
+    console.log(`  ${icon}  #${task.id} ${task.title}  [${task.branch}]`);
+  }
+  log.blank();
+}

package/src/utils/detect-prd.js

@@ -0,0 +1,137 @@
+/**
+ * PRD 自动检测模块
+ * 在项目目录中自动查找 PRD 文档
+ */
+
+import { readdirSync, readFileSync, statSync } from 'fs';
+import { resolve, basename, extname } from 'path';
+import { log } from './logger.js';
+
+// PRD 文件名匹配模式（优先级由高到低）
+const PRD_PATTERNS = [
+  /prd/i,
+  /product.?requirement/i,
+  /product.?design/i,
+  /需求文档/,
+  /产品需求/,
+  /requirement/i,
+  /spec/i,
+];
+
+// 搜索目录（按优先级）
+const SEARCH_DIRS = [
+  '.',           // 项目根目录
+  'docs',
+  'doc',
+  'PRD',
+  'prd',
+  '.docs',
+  'documentation',
+  '文档',
+];
+
+// 忽略目录
+const IGNORE_DIRS = new Set([
+  'node_modules', '.git', '.next', 'dist', 'build', 'vendor',
+  '.codex-copilot', '.vscode', '.idea', '__pycache__', 'coverage',
+]);
+
+/**
+ * 自动检测当前项目中的 PRD 文件
+ * @param {string} projectDir - 项目根目录
+ * @returns {Array<{path: string, score: number, name: string}>} 候选 PRD 文件列表（按匹配度排序）
+ */
+export function detectPRD(projectDir) {
+  const candidates = [];
+
+  for (const dir of SEARCH_DIRS) {
+    const searchPath = resolve(projectDir, dir);
+    try {
+      if (!statSync(searchPath).isDirectory()) continue;
+    } catch {
+      continue;
+    }
+
+    scanDir(searchPath, projectDir, candidates, 0);
+  }
+
+  // 按匹配度排序
+  candidates.sort((a, b) => b.score - a.score);
+
+  return candidates;
+}
+
+function scanDir(dir, projectDir, candidates, depth) {
+  if (depth > 3) return; // 最多搜索 3 层
+
+  let entries;
+  try {
+    entries = readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+
+  for (const entry of entries) {
+    const fullPath = resolve(dir, entry.name);
+
+    if (entry.isDirectory()) {
+      if (!IGNORE_DIRS.has(entry.name)) {
+        scanDir(fullPath, projectDir, candidates, depth + 1);
+      }
+      continue;
+    }
+
+    // 只搜索 markdown 文件
+    if (extname(entry.name).toLowerCase() !== '.md') continue;
+
+    // 计算匹配分数
+    const score = scorePRDMatch(entry.name, fullPath);
+    if (score > 0) {
+      candidates.push({
+        path: fullPath,
+        relativePath: fullPath.replace(projectDir + '/', ''),
+        name: entry.name,
+        score,
+      });
+    }
+  }
+}
+
+function scorePRDMatch(filename, fullPath) {
+  let score = 0;
+  const lower = filename.toLowerCase();
+
+  // 文件名匹配
+  for (let i = 0; i < PRD_PATTERNS.length; i++) {
+    if (PRD_PATTERNS[i].test(filename)) {
+      score += (PRD_PATTERNS.length - i) * 10; // 越靠前的模式分数越高
+    }
+  }
+
+  // 文件大小加分（PRD 通常内容较多）
+  try {
+    const stat = statSync(fullPath);
+    if (stat.size > 5000) score += 5;   // > 5KB
+    if (stat.size > 20000) score += 5;  // > 20KB
+  } catch {}
+
+  // 内容采样检测（读前 2000 字符）
+  if (score > 0) {
+    try {
+      const content = readFileSync(fullPath, 'utf-8').slice(0, 2000);
+      const keywords = ['功能', '需求', '用户', '模块', 'feature', 'requirement', 'user story', '技术栈', '架构'];
+      for (const kw of keywords) {
+        if (content.toLowerCase().includes(kw.toLowerCase())) score += 2;
+      }
+    } catch {}
+  }
+
+  return score;
+}
+
+/**
+ * 读取 PRD 文件内容
+ */
+export function readPRD(prdPath) {
+  return readFileSync(prdPath, 'utf-8');
+}

package/src/utils/git.js

@@ -0,0 +1,95 @@
+/**
+ * Git 操作工具模块
+ */
+
+import { execSync } from 'child_process';
+import { log } from './logger.js';
+
+function exec(cmd, cwd) {
+  return execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+}
+
+function execSafe(cmd, cwd) {
+  try {
+    return { ok: true, output: exec(cmd, cwd) };
+  } catch (err) {
+    return { ok: false, output: err.stderr || err.message };
+  }
+}
+
+/**
+ * 检查 git 仓库是否干净
+ */
+export function isClean(cwd) {
+  const result = exec('git status --porcelain', cwd);
+  return result.length === 0;
+}
+
+/**
+ * 获取当前分支名
+ */
+export function currentBranch(cwd) {
+  return exec('git branch --show-current', cwd);
+}
+
+/**
+ * 获取 remote 的 owner/repo
+ */
+export function getRepoInfo(cwd) {
+  const url = exec('git remote get-url origin', cwd);
+  // 支持 https://github.com/owner/repo.git 和 git@github.com:owner/repo.git
+  const match = url.match(/github\.com[:/](.+?)\/(.+?)(?:\.git)?$/);
+  if (!match) throw new Error(`无法解析 GitHub 仓库地址: ${url}`);
+  return { owner: match[1], repo: match[2] };
+}
+
+/**
+ * 切换到目标分支（如不存在则创建）
+ */
+export function checkoutBranch(cwd, branch, baseBranch = 'main') {
+  const current = currentBranch(cwd);
+  if (current === branch) return;
+
+  // 先切到 base 并拉取最新
+  execSafe(`git checkout ${baseBranch}`, cwd);
+  execSafe(`git pull origin ${baseBranch}`, cwd);
+
+  // 尝试切换，不存在则创建
+  const result = execSafe(`git checkout ${branch}`, cwd);
+  if (!result.ok) {
+    exec(`git checkout -b ${branch}`, cwd);
+  }
+}
+
+/**
+ * 提交所有变更
+ */
+export function commitAll(cwd, message) {
+  exec('git add -A', cwd);
+  const result = execSafe(`git diff --cached --quiet`, cwd);
+  if (result.ok) {
+    log.dim('没有变更需要提交');
+    return false;
+  }
+  exec(`git commit -m "${message}"`, cwd);
+  return true;
+}
+
+/**
+ * 推送分支
+ */
+export function pushBranch(cwd, branch) {
+  exec(`git push origin ${branch} --force-with-lease`, cwd);
+}
+
+/**
+ * 切回主分支
+ */
+export function checkoutMain(cwd, baseBranch = 'main') {
+  execSafe(`git checkout ${baseBranch}`, cwd);
+}
+
+export const git = {
+  isClean, currentBranch, getRepoInfo, checkoutBranch,
+  commitAll, pushBranch, checkoutMain, exec, execSafe,
+};