@jojonax/codex-copilot 1.0.2 → 1.1.0

package/src/utils/provider.js

@@ -0,0 +1,332 @@
+/**
+ * AI Provider Registry — supports multiple AI coding tools
+ * 
+ * Each provider has its own invocation pattern:
+ *   - Codex CLI:    piped stdin → codex exec --full-auto
+ *   - Claude Code:  -p flag + --allowedTools for safe auto-execution
+ *   - Cursor Agent: cursor-agent CLI with -p headless mode
+ *   - Gemini CLI:   gemini -p for non-interactive prompt
+ *   - Codex Desktop / Cursor IDE / Antigravity IDE: clipboard + manual
+ */
+
+import { execSync } from 'child_process';
+import { readFileSync } from 'fs';
+import { log } from './logger.js';
+import { ask } from './prompt.js';
+import { automator } from './automator.js';
+
+// ──────────────────────────────────────────────
+// Provider Registry — each provider is unique
+// ──────────────────────────────────────────────
+
+const PROVIDERS = {
+  // ─── CLI Providers (auto-execute) ───
+
+  'codex-cli': {
+    name: 'Codex CLI',
+    type: 'cli',
+    detect: 'codex',
+    // Codex uses piped stdin: cat file | codex exec --full-auto -
+    buildCommand: (promptPath, cwd) =>
+      `cat ${shellEscape(promptPath)} | codex exec --full-auto -`,
+    description: 'OpenAI Codex CLI — pipes prompt via stdin',
+  },
+
+  'claude-code': {
+    name: 'Claude Code',
+    type: 'cli',
+    detect: 'claude',
+    // Claude Code uses -p (print/non-interactive) + --allowedTools for permissions
+    // Reads the file content and passes as argument (not piped)
+    buildCommand: (promptPath, cwd) => {
+      const escaped = shellEscape(promptPath);
+      // Use subshell to read file content into -p argument
+      return `claude -p "$(cat ${escaped})" --allowedTools "Bash(git*),Read,Write,Edit"`;
+    },
+    description: 'Anthropic Claude Code CLI — -p mode with tool permissions',
+  },
+
+  'cursor-agent': {
+    name: 'Cursor Agent',
+    type: 'cli',
+    detect: 'cursor-agent',
+    // Cursor Agent uses -p flag for headless/non-interactive mode
+    buildCommand: (promptPath, cwd) => {
+      const escaped = shellEscape(promptPath);
+      return `cursor-agent -p "$(cat ${escaped})"`;
+    },
+    description: 'Cursor Agent CLI — headless -p mode',
+  },
+
+  'gemini-cli': {
+    name: 'Gemini CLI',
+    type: 'cli',
+    detect: 'gemini',
+    // Gemini CLI uses -p for non-interactive prompt execution
+    buildCommand: (promptPath, cwd) => {
+      const escaped = shellEscape(promptPath);
+      return `gemini -p "$(cat ${escaped})"`;
+    },
+    description: 'Google Gemini CLI — non-interactive -p mode',
+  },
+
+  // ─── IDE Providers (clipboard + manual) ───
+
+  'codex-desktop': {
+    name: 'Codex Desktop',
+    type: 'ide',
+    instructions: 'Open Codex Desktop → paste the prompt → execute',
+    displayPrompt: true, // Show the prompt content in terminal box
+  },
+
+  'cursor': {
+    name: 'Cursor IDE',
+    type: 'ide',
+    instructions: 'Open Cursor → Ctrl/Cmd+I (Composer) → paste the prompt → run as Agent',
+    displayPrompt: false, // Too long to display, just copy to clipboard
+  },
+
+  'antigravity': {
+    name: 'Antigravity (Gemini)',
+    type: 'ide',
+    instructions: 'Open Antigravity → paste the prompt into chat → execute',
+    displayPrompt: false,
+  },
+};
+
+/**
+ * Get a provider by ID
+ */
+export function getProvider(id) {
+  return PROVIDERS[id] || null;
+}
+
+/**
+ * Get all provider IDs
+ */
+export function getAllProviderIds() {
+  return Object.keys(PROVIDERS);
+}
+
+/**
+ * Detect which CLI providers are installed on the system
+ * @returns {string[]} list of available provider IDs
+ */
+export function detectAvailable() {
+  const available = [];
+  for (const [id, prov] of Object.entries(PROVIDERS)) {
+    if (prov.type === 'cli' && prov.detect) {
+      try {
+        const cmd = process.platform === 'win32'
+          ? `where ${prov.detect}`
+          : `which ${prov.detect}`;
+        execSync(cmd, { stdio: 'pipe' });
+        available.push(id);
+      } catch {
+        // Not installed
+      }
+    }
+  }
+  return available;
+}
+
+/**
+ * Build the selection menu for init
+ * Groups CLIs first (with detection status), then IDEs
+ * @returns {{ label: string, value: string }[]}
+ */
+export function buildProviderChoices() {
+  const detected = detectAvailable();
+  const choices = [];
+
+  // CLI providers first with detection indicator
+  for (const [id, prov] of Object.entries(PROVIDERS)) {
+    if (prov.type === 'cli') {
+      const installed = detected.includes(id);
+      const tag = installed ? ' ✓ detected' : '';
+      choices.push({
+        label: `${prov.name}${tag} — ${prov.description}`,
+        value: id,
+        available: installed,
+      });
+    }
+  }
+
+  // IDE providers — show auto-paste capability if recipe exists
+  for (const [id, prov] of Object.entries(PROVIDERS)) {
+    if (prov.type === 'ide') {
+      const hasAutoPaste = automator.hasRecipe(id);
+      const tag = hasAutoPaste ? 'auto-paste' : 'clipboard + manual';
+      choices.push({
+        label: `${prov.name} — ${tag}`,
+        value: id,
+        available: true,
+      });
+    }
+  }
+
+  return choices;
+}
+
+/**
+ * Execute a prompt using the configured provider
+ * 
+ * CLI providers: auto-execute via their specific command
+ * IDE providers: copy to clipboard + display instructions + wait
+ * 
+ * @param {string} providerId - Provider ID from config
+ * @param {string} promptPath - Absolute path to prompt file
+ * @param {string} cwd - Working directory
+ * @returns {Promise<boolean>} true if execution succeeded
+ */
+export async function executePrompt(providerId, promptPath, cwd) {
+  const prov = PROVIDERS[providerId];
+
+  if (!prov) {
+    log.warn(`Unknown provider '${providerId}', falling back to clipboard mode`);
+    return await clipboardFallback(promptPath);
+  }
+
+  if (prov.type === 'cli') {
+    return await executeCLI(prov, providerId, promptPath, cwd);
+  } else {
+    return await executeIDE(prov, providerId, promptPath);
+  }
+}
+
+/**
+ * Execute via CLI provider — each tool has its own command pattern
+ */
+async function executeCLI(prov, providerId, promptPath, cwd) {
+  // Verify the CLI is still available
+  if (prov.detect) {
+    try {
+      const cmd = process.platform === 'win32'
+        ? `where ${prov.detect}`
+        : `which ${prov.detect}`;
+      execSync(cmd, { stdio: 'pipe' });
+    } catch {
+      log.warn(`${prov.name} not found in PATH, falling back to clipboard mode`);
+      return await clipboardFallback(promptPath);
+    }
+  }
+
+  const command = prov.buildCommand(promptPath, cwd);
+  log.info(`Executing via ${prov.name}...`);
+  log.dim(`  → ${command.substring(0, 80)}${command.length > 80 ? '...' : ''}`);
+
+  try {
+    execSync(command, { cwd, stdio: 'inherit', timeout: 0 });
+    log.info(`${prov.name} execution complete`);
+    return true;
+  } catch (err) {
+    log.warn(`${prov.name} execution failed: ${err.message}`);
+
+    // For quota exhaustion / auth errors, give a clear message
+    if (err.message.includes('rate_limit') || err.message.includes('quota') ||
+        err.message.includes('429') || err.message.includes('insufficient')) {
+      log.error('⚠ Possible quota exhaustion — checkpoint saved, you can resume later');
+    }
+
+    log.warn('Falling back to clipboard mode');
+    return await clipboardFallback(promptPath);
+  }
+}
+
+/**
+ * Execute via IDE provider
+ * 
+ * Priority: auto-paste (if IDE running) → manual clipboard fallback
+ */
+async function executeIDE(prov, providerId, promptPath) {
+  const prompt = readFileSync(promptPath, 'utf-8');
+
+  // ── Try auto-paste first ──
+  if (automator.hasRecipe(providerId)) {
+    if (automator.isIDERunning(providerId)) {
+      log.info(`${prov.name} detected — attempting auto-paste...`);
+      const ok = automator.activateAndPaste(providerId, prompt);
+      if (ok) {
+        log.info(`✅ Prompt auto-pasted into ${prov.name}`);
+        log.blank();
+        await ask(`Press Enter after ${prov.name} development is complete...`);
+        return true;
+      }
+      log.warn('Auto-paste failed, falling back to manual mode');
+    } else {
+      log.warn(`${prov.name} is not running — using clipboard mode`);
+    }
+  }
+
+  // ── Manual fallback ──
+  log.blank();
+  log.info(`📋 ${prov.instructions}`);
+  log.dim(`   Prompt file: ${promptPath}`);
+  log.blank();
+
+  // Some providers benefit from seeing the prompt in terminal
+  if (prov.displayPrompt) {
+    const lines = prompt.split('\n');
+    const maxLines = 30;
+    const show = lines.slice(0, maxLines);
+    console.log('  ┌─── Prompt Preview ─────────────────────────────────────┐');
+    for (const line of show) {
+      console.log(`  │ ${line}`);
+    }
+    if (lines.length > maxLines) {
+      console.log(`  │ ... (${lines.length - maxLines} more lines — see full file)`);
+    }
+    console.log('  └────────────────────────────────────────────────────────┘');
+    log.blank();
+  }
+
+  copyToClipboard(prompt);
+
+  await ask(`Press Enter after ${prov.name} development is complete...`);
+  return true;
+}
+
+/**
+ * Fallback: copy to clipboard and wait for any provider
+ */
+async function clipboardFallback(promptPath) {
+  const prompt = readFileSync(promptPath, 'utf-8');
+
+  log.blank();
+  log.info('📋 Paste the prompt into your AI coding tool and execute');
+  log.dim(`   Prompt file: ${promptPath}`);
+  log.blank();
+
+  copyToClipboard(prompt);
+
+  await ask('Press Enter after development is complete...');
+  return true;
+}
+
+function copyToClipboard(text) {
+  try {
+    if (process.platform === 'darwin') {
+      execSync('pbcopy', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+    } else if (process.platform === 'linux') {
+      // Try xclip first, then xsel
+      try {
+        execSync('xclip -selection clipboard', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+      } catch {
+        execSync('xsel --clipboard --input', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+      }
+    }
+    // Windows: skip — no good CLI clipboard tool
+    log.info('📋 Copied to clipboard');
+  } catch {
+    log.dim('(Could not copy to clipboard — copy the file manually)');
+  }
+}
+
+function shellEscape(str) {
+  return `'${str.replace(/'/g, "'\\''")}'`;
+}
+
+export const provider = {
+  getProvider, getAllProviderIds, detectAvailable,
+  buildProviderChoices, executePrompt,
+};

package/src/utils/update-check.js

@@ -0,0 +1,103 @@
+/**
+ * Version update checker
+ * 
+ * - Checks npm registry for latest version on startup
+ * - 24h cache to avoid frequent network requests
+ * - Prints update prompt if a newer version is available
+ */
+
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { resolve } from 'path';
+import { homedir } from 'os';
+import { log } from './logger.js';
+
+const PACKAGE_NAME = '@jojonax/codex-copilot';
+const CACHE_FILE = resolve(homedir(), '.codex-copilot-update-cache.json');
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
+
+/**
+ * Read cached version info
+ */
+function readCache() {
+  try {
+    const data = JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+    if (Date.now() - data.timestamp < CACHE_TTL) {
+      return data.latestVersion;
+    }
+  } catch {
+    // Cache miss or corrupt — ignore
+  }
+  return null;
+}
+
+/**
+ * Write version info to cache
+ */
+function writeCache(latestVersion) {
+  try {
+    writeFileSync(CACHE_FILE, JSON.stringify({
+      latestVersion,
+      timestamp: Date.now(),
+    }));
+  } catch {
+    // Permission error — ignore silently
+  }
+}
+
+/**
+ * Fetch latest version from npm registry
+ */
+function fetchLatestVersion() {
+  try {
+    const output = execSync(`npm view ${PACKAGE_NAME} version`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000, // 5s timeout
+    }).trim();
+    return output || null;
+  } catch {
+    // Network error, npm not available — ignore
+    return null;
+  }
+}
+
+/**
+ * Compare semantic version strings
+ * @returns {boolean} true if latest > current
+ */
+function isNewer(current, latest) {
+  if (!current || !latest) return false;
+  const c = current.split('.').map(Number);
+  const l = latest.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] || 0) > (c[i] || 0)) return true;
+    if ((l[i] || 0) < (c[i] || 0)) return false;
+  }
+  return false;
+}
+
+/**
+ * Check for updates and print notification
+ * @param {string} currentVersion - Current installed version
+ */
+export function checkForUpdates(currentVersion) {
+  // 1. Check cache first
+  let latest = readCache();
+
+  // 2. Cache miss → fetch from npm
+  if (!latest) {
+    latest = fetchLatestVersion();
+    if (latest) {
+      writeCache(latest);
+    }
+  }
+
+  // 3. Compare and notify
+  if (latest && isNewer(currentVersion, latest)) {
+    log.blank();
+    log.warn(`Update available: v${currentVersion} → v${latest}`);
+    log.dim(`  Run the following command to update:`);
+    log.dim(`  npm install -g ${PACKAGE_NAME}@${latest}`);
+  }
+}