@jojonax/codex-copilot 1.0.2 → 1.1.0

package/src/commands/status.js

@@ -1,59 +1,76 @@
 /**
- * codex-copilot status - 显示当前进度
+ * codex-copilot status - Show current progress
  */
 
-import { readFileSync } from 'fs';
+import { readFileSync, existsSync } from 'fs';
 import { resolve } from 'path';
 import { log, progressBar } from '../utils/logger.js';
+import { createCheckpoint } from '../utils/checkpoint.js';
 
 export async function status(projectDir) {
   const tasksPath = resolve(projectDir, '.codex-copilot/tasks.json');
-  const statePath = resolve(projectDir, '.codex-copilot/state.json');
+  const checkpoint = createCheckpoint(projectDir);
 
   let tasks, state;
   try {
     tasks = JSON.parse(readFileSync(tasksPath, 'utf-8'));
-    state = JSON.parse(readFileSync(statePath, 'utf-8'));
+    state = checkpoint.load();
   } catch (err) {
-    log.error(`读取文件失败: ${err.message}`);
-    log.warn('文件可能已损坏，请运行 codex-copilot reset');
+    log.error(`Failed to read files: ${err.message}`);
+    log.warn('Files may be corrupted. Run: codex-copilot reset');
     return;
   }
 
-  log.title(`📊 项目: ${tasks.project}`);
+  log.title(`📊 Project: ${tasks.project}`);
   log.blank();
 
-  // 进度条
+  // Progress bar
   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} 完成`);
+  progressBar(completed, tasks.total, `${completed}/${tasks.total} done`);
   log.blank();
 
-  // 统计
-  log.info(`✅ 已完成: ${completed}`);
-  if (inProgress > 0) log.info(`🔄 进行中: ${inProgress}`);
-  log.info(`⏳ 待开发: ${pending}`);
-  if (skipped > 0) log.warn(`⏭  已跳过: ${skipped}`);
+  // Stats
+  log.info(`✅ Completed: ${completed}`);
+  if (inProgress > 0) log.info(`🔄 In progress: ${inProgress}`);
+  log.info(`⏳ Pending: ${pending}`);
+  if (skipped > 0) log.warn(`⏭  Skipped: ${skipped}`);
   log.blank();
 
-  // 当前状态
-  if (state.current_pr) {
-    log.info(`当前 PR: #${state.current_pr} (Review 第 ${state.review_round} 轮)`);
+  // Current checkpoint state
+  if (state.phase) {
+    const phaseLabels = {
+      develop: '🔨 Develop',
+      pr: '📦 PR',
+      review: '👀 Review',
+      merge: '🔀 Merge',
+    };
+    const phaseLabel = phaseLabels[state.phase] || state.phase;
+    log.info(`📍 Checkpoint: Task #${state.current_task} — ${phaseLabel} → ${state.phase_step}`);
+    if (state.branch) log.dim(`   Branch: ${state.branch}`);
+    if (state.current_pr) log.dim(`   PR: #${state.current_pr}`);
+    if (state.review_round > 0) log.dim(`   Review round: ${state.review_round}`);
+    if (state.last_updated) log.dim(`   Last saved: ${state.last_updated}`);
+  } else if (state.current_task > 0) {
+    log.info(`Last completed task: #${state.current_task}`);
   }
   log.blank();
 
-  // 任务列表
-  log.title('任务列表:');
+  // Task list
+  log.title('Task list:');
   log.blank();
   for (const task of tasks.tasks) {
+    const isCurrentTask = state.current_task === task.id && state.phase;
     const icon = task.status === 'completed' ? '✅' :
+                 isCurrentTask ? '🔄' :
                  task.status === 'in_progress' ? '🔄' :
                  task.status === 'developed' ? '📦' :
                  task.status === 'skipped' ? '⏭ ' : '⬜';
-    console.log(`  ${icon}  #${task.id} ${task.title}  [${task.branch}]`);
+    const suffix = isCurrentTask ? `  ← ${state.phase}:${state.phase_step}` : '';
+    console.log(`  ${icon}  #${task.id} ${task.title}  [${task.branch}]${suffix}`);
   }
   log.blank();
 }

package/src/utils/automator.js

@@ -0,0 +1,279 @@
+/**
+ * Desktop IDE Automator — platform-aware process detection + auto-paste
+ * 
+ * Supports macOS (AppleScript/osascript) and Windows (PowerShell/SendKeys).
+ * Each IDE has its own keystroke recipe.
+ * Falls back gracefully if automation fails.
+ */
+
+import { execSync } from 'child_process';
+import { log } from './logger.js';
+
+const IS_MAC = process.platform === 'darwin';
+const IS_WIN = process.platform === 'win32';
+
+// ──────────────────────────────────────────────
+// Per-IDE Automation Recipes
+// ──────────────────────────────────────────────
+
+/**
+ * Each recipe defines:
+ *   processName: { mac, win } — binary/process name to detect
+ *   appName:     { mac, win } — display name for activation
+ *   preKeys:     keystroke sequence BEFORE paste (e.g., open Composer in Cursor)
+ *   preDelay:    ms to wait after preKeys
+ *   postKeys:    keystroke sequence AFTER paste (usually Enter to send)
+ *   pasteDelay:  ms to wait between paste and postKeys
+ */
+const IDE_RECIPES = {
+  'codex-desktop': {
+    processName: { mac: 'Codex', win: 'Codex' },
+    appName: { mac: 'Codex', win: 'Codex' },
+    // Codex Desktop: input is focused on activate → paste → Enter
+    preKeys: null,
+    preDelay: 0,
+    postKeys: 'return',
+    pasteDelay: 300,
+  },
+
+  'cursor': {
+    processName: { mac: 'Cursor', win: 'Cursor' },
+    appName: { mac: 'Cursor', win: 'Cursor' },
+    // Cursor: Cmd/Ctrl+I opens Composer, then paste, then Enter
+    preKeys: IS_MAC
+      ? 'keystroke "i" using {command down}'
+      : '^i',
+    preDelay: 800,
+    postKeys: 'return',
+    pasteDelay: 300,
+  },
+
+  'antigravity': {
+    processName: { mac: 'Antigravity', win: 'Antigravity' },
+    appName: { mac: 'Antigravity', win: 'Antigravity' },
+    // Antigravity: chat input auto-focused → paste → Enter
+    preKeys: null,
+    preDelay: 0,
+    postKeys: 'return',
+    pasteDelay: 300,
+  },
+};
+
+// ──────────────────────────────────────────────
+// Process Detection
+// ──────────────────────────────────────────────
+
+/**
+ * Check if a process is running
+ * @param {string} processName - Name of the process
+ * @returns {boolean}
+ */
+export function isProcessRunning(processName) {
+  try {
+    if (IS_MAC) {
+      const result = execSync(
+        `pgrep -x "${processName}" || pgrep -fi "${processName}"`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      ).trim();
+      return result.length > 0;
+    } else if (IS_WIN) {
+      const result = execSync(
+        `tasklist /FI "IMAGENAME eq ${processName}.exe" /NH`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      ).trim();
+      return !result.includes('No tasks');
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+// ──────────────────────────────────────────────
+// macOS Automation (AppleScript)
+// ──────────────────────────────────────────────
+
+function buildAppleScript(recipe) {
+  const appName = recipe.appName.mac;
+  const lines = [];
+
+  // Activate the application
+  lines.push(`tell application "${appName}" to activate`);
+  lines.push('delay 0.5');
+
+  // System Events block for keystrokes
+  lines.push('tell application "System Events"');
+
+  // Pre-keys (e.g., Cmd+I for Cursor Composer)
+  if (recipe.preKeys) {
+    lines.push(`  ${recipe.preKeys}`);
+    lines.push(`  delay ${recipe.preDelay / 1000}`);
+  }
+
+  // Paste: Cmd+V
+  lines.push('  keystroke "v" using {command down}');
+  lines.push(`  delay ${recipe.pasteDelay / 1000}`);
+
+  // Post-keys: usually Enter to send
+  if (recipe.postKeys === 'return') {
+    lines.push('  keystroke return');
+  }
+
+  lines.push('end tell');
+
+  return lines.join('\n');
+}
+
+function runAppleScript(script) {
+  try {
+    execSync(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 10000,
+    });
+    return true;
+  } catch (err) {
+    log.warn(`AppleScript failed: ${err.message}`);
+    if (err.message.includes('not allowed assistive access')) {
+      log.error('⚠ Accessibility permission required:');
+      log.error('  System Settings → Privacy & Security → Accessibility');
+      log.error('  Add your terminal app (Terminal / iTerm2 / Warp)');
+    }
+    return false;
+  }
+}
+
+// ──────────────────────────────────────────────
+// Windows Automation (PowerShell)
+// ──────────────────────────────────────────────
+
+function buildPowerShell(recipe) {
+  const appName = recipe.appName.win;
+  const lines = [];
+
+  lines.push('Add-Type -AssemblyName System.Windows.Forms');
+  lines.push('Add-Type -AssemblyName Microsoft.VisualBasic');
+
+  // Activate window
+  lines.push(`[Microsoft.VisualBasic.Interaction]::AppActivate("${appName}")`);
+  lines.push('Start-Sleep -Milliseconds 500');
+
+  // Pre-keys
+  if (recipe.preKeys) {
+    lines.push(`[System.Windows.Forms.SendKeys]::SendWait("${recipe.preKeys}")`);
+    lines.push(`Start-Sleep -Milliseconds ${recipe.preDelay}`);
+  }
+
+  // Paste: Ctrl+V
+  lines.push('[System.Windows.Forms.SendKeys]::SendWait("^v")');
+  lines.push(`Start-Sleep -Milliseconds ${recipe.pasteDelay}`);
+
+  // Post-keys: Enter
+  if (recipe.postKeys === 'return') {
+    lines.push('[System.Windows.Forms.SendKeys]::SendWait("{ENTER}")');
+  }
+
+  return lines.join('; ');
+}
+
+function runPowerShell(script) {
+  try {
+    execSync(`powershell -NoProfile -Command "${script.replace(/"/g, '\\"')}"`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 10000,
+    });
+    return true;
+  } catch (err) {
+    log.warn(`PowerShell automation failed: ${err.message}`);
+    return false;
+  }
+}
+
+// ──────────────────────────────────────────────
+// Public API
+// ──────────────────────────────────────────────
+
+/**
+ * Check if a specific IDE has a known automation recipe
+ */
+export function hasRecipe(providerId) {
+  return providerId in IDE_RECIPES;
+}
+
+/**
+ * Check if the IDE is currently running
+ */
+export function isIDERunning(providerId) {
+  const recipe = IDE_RECIPES[providerId];
+  if (!recipe) return false;
+
+  const processName = IS_MAC ? recipe.processName.mac : recipe.processName.win;
+  return isProcessRunning(processName);
+}
+
+/**
+ * Attempt to auto-paste prompt into the IDE and trigger send
+ * 
+ * Flow: copy to clipboard → activate window → pre-keys → paste → post-keys
+ * 
+ * @param {string} providerId - IDE provider ID
+ * @param {string} text - Prompt text to paste
+ * @returns {boolean} true if automation succeeded
+ */
+export function activateAndPaste(providerId, text) {
+  const recipe = IDE_RECIPES[providerId];
+  if (!recipe) {
+    log.warn(`No automation recipe for '${providerId}'`);
+    return false;
+  }
+
+  // Step 1: Check process is running
+  const processName = IS_MAC ? recipe.processName.mac : recipe.processName.win;
+  if (!isProcessRunning(processName)) {
+    log.warn(`${recipe.appName[IS_MAC ? 'mac' : 'win']} is not running`);
+    return false;
+  }
+
+  // Step 2: Copy to clipboard (handled by caller, but ensure it's done)
+  copyToSystemClipboard(text);
+
+  // Step 3: Run platform-specific automation
+  log.info(`Auto-pasting into ${recipe.appName[IS_MAC ? 'mac' : 'win']}...`);
+
+  if (IS_MAC) {
+    const script = buildAppleScript(recipe);
+    return runAppleScript(script);
+  } else if (IS_WIN) {
+    const script = buildPowerShell(recipe);
+    return runPowerShell(script);
+  } else {
+    log.warn('Desktop automation not supported on this platform');
+    return false;
+  }
+}
+
+/**
+ * Copy text to system clipboard (cross-platform)
+ */
+function copyToSystemClipboard(text) {
+  try {
+    if (IS_MAC) {
+      execSync('pbcopy', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+    } else if (IS_WIN) {
+      execSync('clip', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+    } else {
+      try {
+        execSync('xclip -selection clipboard', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+      } catch {
+        execSync('xsel --clipboard --input', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+      }
+    }
+  } catch {
+    // Clipboard failure is non-fatal — user can copy file manually
+  }
+}
+
+export const automator = {
+  isProcessRunning, hasRecipe, isIDERunning, activateAndPaste,
+};

package/src/utils/checkpoint.js

@@ -0,0 +1,129 @@
+/**
+ * Checkpoint state manager - Fine-grained state persistence
+ * 
+ * Provides atomic save/load for checkpoint state, enabling
+ * resume from any sub-step within a task after interruption.
+ */
+
+import { readFileSync, writeFileSync, renameSync, existsSync } from 'fs';
+import { resolve } from 'path';
+
+/**
+ * Create a checkpoint manager for a project
+ * @param {string} projectDir - Project root directory
+ */
+export function createCheckpoint(projectDir) {
+  const statePath = resolve(projectDir, '.codex-copilot/state.json');
+  const tempPath = resolve(projectDir, '.codex-copilot/state.json.tmp');
+
+  /**
+   * Load current state from disk
+   */
+  function load() {
+    try {
+      return JSON.parse(readFileSync(statePath, 'utf-8'));
+    } catch {
+      return getDefaultState();
+    }
+  }
+
+  /**
+   * Save state atomically (write to temp file, then rename)
+   * @param {object} update - Partial state to merge
+   */
+  function save(update) {
+    const current = load();
+    const merged = {
+      ...current,
+      ...update,
+      last_updated: new Date().toISOString(),
+    };
+    // Atomic write: temp file + rename prevents corruption on crash
+    writeFileSync(tempPath, JSON.stringify(merged, null, 2));
+    renameSync(tempPath, statePath);
+    return merged;
+  }
+
+  /**
+   * Mark a specific phase & step as reached
+   */
+  function saveStep(taskId, phase, phaseStep, extra = {}) {
+    return save({
+      current_task: taskId,
+      phase,
+      phase_step: phaseStep,
+      ...extra,
+    });
+  }
+
+  /**
+   * Mark current task as fully completed, clear phase info
+   */
+  function completeTask(taskId) {
+    return save({
+      current_task: taskId,
+      phase: null,
+      phase_step: null,
+      current_pr: null,
+      review_round: 0,
+      branch: null,
+    });
+  }
+
+  /**
+   * Check if a specific phase+step has been reached for a task
+   * Returns true if the saved state is at or past the given step
+   */
+  function isStepDone(taskId, phase, phaseStep) {
+    const state = load();
+    if (state.current_task !== taskId) return false;
+    if (!state.phase) return false;
+
+    const phaseOrder = ['develop', 'pr', 'review', 'merge'];
+    const savedPhaseIdx = phaseOrder.indexOf(state.phase);
+    const targetPhaseIdx = phaseOrder.indexOf(phase);
+
+    // If saved phase is ahead, this step is done
+    if (savedPhaseIdx > targetPhaseIdx) return true;
+    // If saved phase is behind, this step is not done
+    if (savedPhaseIdx < targetPhaseIdx) return false;
+
+    // Same phase: compare steps within phase
+    const stepOrders = {
+      develop: ['branch_created', 'prompt_ready', 'codex_complete'],
+      pr: ['committed', 'pushed', 'pr_created'],
+      review: ['waiting_review', 'feedback_received', 'fix_applied'],
+      merge: ['merged'],
+    };
+
+    const steps = stepOrders[phase] || [];
+    const savedStepIdx = steps.indexOf(state.phase_step);
+    const targetStepIdx = steps.indexOf(phaseStep);
+
+    return savedStepIdx >= targetStepIdx;
+  }
+
+  /**
+   * Full reset to initial state
+   */
+  function reset() {
+    const state = getDefaultState();
+    writeFileSync(statePath, JSON.stringify(state, null, 2));
+    return state;
+  }
+
+  return { load, save, saveStep, completeTask, isStepDone, reset };
+}
+
+function getDefaultState() {
+  return {
+    current_task: 0,
+    phase: null,
+    phase_step: null,
+    current_pr: null,
+    review_round: 0,
+    branch: null,
+    status: 'initialized',
+    last_updated: new Date().toISOString(),
+  };
+}

package/src/utils/detect-prd.js

@@ -1,13 +1,13 @@
 /**
- * PRD 自动检测模块
- * 在项目目录中自动查找 PRD 文档
+ * PRD auto-detection module
+ * Automatically finds PRD documents in the project directory
  */
 
 import { readdirSync, readFileSync, statSync } from 'fs';
 import { resolve, extname, relative } from 'path';
 import { log } from './logger.js';
 
-// PRD 文件名匹配模式（优先级由高到低）
+// PRD filename patterns (ordered by priority, highest first)
 const PRD_PATTERNS = [
   /prd/i,
   /product.?requirement/i,
@@ -18,9 +18,9 @@ const PRD_PATTERNS = [
   /spec/i,
 ];
 
-// 搜索目录（按优先级）
+// Directories to search (ordered by priority)
 const SEARCH_DIRS = [
-  '.',           // 项目根目录
+  '.',           // Project root
   'docs',
   'doc',
   'PRD',
@@ -30,16 +30,16 @@ const SEARCH_DIRS = [
   '文档',
 ];
 
-// 忽略目录
+// Directories to ignore
 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 文件列表（按匹配度排序）
+ * Auto-detect PRD files in the project
+ * @param {string} projectDir - Project root directory
+ * @returns {Array<{path: string, score: number, name: string}>} Candidate PRD files sorted by match score
  */
 export function detectPRD(projectDir) {
   const candidates = [];
@@ -55,14 +55,14 @@ export function detectPRD(projectDir) {
     scanDir(searchPath, projectDir, candidates, 0);
   }
 
-  // 按匹配度排序
+  // Sort by match score (descending)
   candidates.sort((a, b) => b.score - a.score);
 
   return candidates;
 }
 
 function scanDir(dir, projectDir, candidates, depth) {
-  if (depth > 3) return; // 最多搜索 3 层
+  if (depth > 3) return; // Max 3 levels deep
 
   let entries;
   try {
@@ -81,10 +81,10 @@ function scanDir(dir, projectDir, candidates, depth) {
       continue;
     }
 
-    // 只搜索 markdown 文件
+    // Only scan markdown files
     if (extname(entry.name).toLowerCase() !== '.md') continue;
 
-    // 计算匹配分数
+    // Calculate match score
     const score = scorePRDMatch(entry.name, fullPath);
     if (score > 0) {
       candidates.push({
@@ -101,21 +101,21 @@ function scorePRDMatch(filename, fullPath) {
   let score = 0;
   const lower = filename.toLowerCase();
 
-  // 文件名匹配
+  // Filename pattern matching
   for (let i = 0; i < PRD_PATTERNS.length; i++) {
     if (PRD_PATTERNS[i].test(filename)) {
-      score += (PRD_PATTERNS.length - i) * 10; // 越靠前的模式分数越高
+      score += (PRD_PATTERNS.length - i) * 10; // Higher priority patterns get higher scores
     }
   }
 
-  // 文件大小加分（PRD 通常内容较多）
+  // File size bonus (PRDs are typically longer)
   try {
     const stat = statSync(fullPath);
     if (stat.size > 5000) score += 5;   // > 5KB
     if (stat.size > 20000) score += 5;  // > 20KB
   } catch {}
 
-  // 内容采样检测（读前 2000 字符）
+  // Content sampling (read first 2000 chars)
   if (score > 0) {
     try {
       const content = readFileSync(fullPath, 'utf-8').slice(0, 2000);
@@ -130,7 +130,7 @@ function scorePRDMatch(filename, fullPath) {
 }
 
 /**
- * 读取 PRD 文件内容
+ * Read PRD file content
  */
 export function readPRD(prdPath) {
   return readFileSync(prdPath, 'utf-8');