claude-coder 1.7.0 → 1.8.0

package/package.json

@@ -1,47 +1,52 @@
-{
-  "name": "claude-coder",
-  "version": "1.7.0",
-  "description": "Claude Coder — Autonomous coding agent harness powered by Claude Code SDK. Scan, plan, code, validate, git-commit in a loop.",
-  "bin": {
-    "claude-coder": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "prompts/",
-    "templates/"
-  ],
-  "keywords": [
-    "claude-coder",
-    "claude",
-    "claude-code",
-    "ai",
-    "agent",
-    "autonomous",
-    "automation",
-    "coding",
-    "harness",
-    "loop",
-    "agent-harness",
-    "task-decomposition",
-    "code-generation"
-  ],
-  "author": "lk19940215",
-  "license": "MIT",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/lk19940215/claude-coder.git"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "peerDependencies": {
-    "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
-  },
-  "optionalDependencies": {
-    "playwright": "^1.58.2"
-  }
-}
+{
+  "name": "claude-coder",
+  "version": "1.8.0",
+  "description": "Claude Coder — Autonomous coding agent harness powered by Claude Code SDK. Scan, plan, code, validate, git-commit in a loop.",
+  "bin": {
+    "claude-coder": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/"
+  ],
+  "scripts": {
+    "test": "node test/complete.test.js && node test/integration.test.js && node test/flow.test.js"
+  },
+  "keywords": [
+    "claude-coder",
+    "claude",
+    "claude-code",
+    "ai",
+    "agent",
+    "autonomous",
+    "automation",
+    "coding",
+    "harness",
+    "loop",
+    "agent-harness",
+    "task-decomposition",
+    "code-generation"
+  ],
+  "author": "lk19940215",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lk19940215/claude-coder.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.58.2"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.71"
+  }
+}

package/src/commands/auth.js

@@ -0,0 +1,294 @@
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execSync } = require('child_process');
+const { loadConfig, log } = require('../common/config');
+const { assets } = require('../common/assets');
+const { appendGitignore } = require('../common/utils');
+
+function resolvePlaywright() {
+  const { createRequire } = require('module');
+  const pkg = 'playwright';
+
+  try {
+    return path.dirname(require.resolve(`${pkg}/package.json`));
+  } catch {}
+
+  try {
+    const r = createRequire(path.join(process.cwd(), 'noop.js'));
+    return path.dirname(r.resolve(`${pkg}/package.json`));
+  } catch {}
+
+  try {
+    const globalRoot = execSync('npm root -g', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    const pkgJsonPath = path.join(globalRoot, pkg, 'package.json');
+    if (fs.existsSync(pkgJsonPath)) return path.join(globalRoot, pkg);
+  } catch {}
+
+  return null;
+}
+
+function normalizeUrl(url) {
+  if (!url) return null;
+  return /^https?:\/\//.test(url) ? url : `http://${url}`;
+}
+
+function updateGitignore(entry) {
+  if (appendGitignore(assets.projectRoot, entry)) {
+    log('ok', `.gitignore 已添加: ${entry}`);
+  }
+}
+
+function updateMcpConfig(mcpPath, mode) {
+  let mcpConfig = {};
+  if (fs.existsSync(mcpPath)) {
+    try { mcpConfig = JSON.parse(fs.readFileSync(mcpPath, 'utf8')); } catch {}
+  }
+
+  if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
+
+  const args = ['@playwright/mcp@latest'];
+  const projectRoot = assets.projectRoot;
+
+  switch (mode) {
+    case 'persistent': {
+      const browserProfilePath = assets.path('browserProfile');
+      const relProfile = path.relative(projectRoot, browserProfilePath).split(path.sep).join('/');
+      args.push(`--user-data-dir=${relProfile}`);
+      break;
+    }
+    case 'isolated': {
+      const playwrightAuthPath = assets.path('playwrightAuth');
+      const relAuth = path.relative(projectRoot, playwrightAuthPath).split(path.sep).join('/');
+      args.push('--isolated', `--storage-state=${relAuth}`);
+      break;
+    }
+    case 'extension':
+      args.push('--extension');
+      break;
+  }
+
+  mcpConfig.mcpServers.playwright = { command: 'npx', args };
+  fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n', 'utf8');
+  log('ok', `.mcp.json 已配置 Playwright MCP (${mode} 模式)`);
+}
+
+function enableMcpPlaywrightEnv() {
+  const envPath = assets.path('env');
+  if (!envPath || !fs.existsSync(envPath)) return;
+
+  let content = fs.readFileSync(envPath, 'utf8');
+  if (/^MCP_PLAYWRIGHT=/m.test(content)) {
+    content = content.replace(/^MCP_PLAYWRIGHT=.*/m, 'MCP_PLAYWRIGHT=true');
+  } else {
+    const suffix = content.endsWith('\n') ? '' : '\n';
+    content += `${suffix}MCP_PLAYWRIGHT=true\n`;
+  }
+  fs.writeFileSync(envPath, content, 'utf8');
+  log('ok', '.claude-coder/.env 已设置 MCP_PLAYWRIGHT=true');
+}
+
+// ─────────────────────────────────────────────────────────────
+// 浏览器脚本（session cookie 自动持久化）
+// ─────────────────────────────────────────────────────────────
+
+function buildBrowserScript(playwrightDir, profileDir, url) {
+  const thirtyDays = Math.floor(Date.now() / 1000) + 86400 * 30;
+  return [
+    `const { chromium } = require(${JSON.stringify(playwrightDir)});`,
+    `(async () => {`,
+    `  const ctx = await chromium.launchPersistentContext(${JSON.stringify(profileDir)}, { headless: false });`,
+    `  const page = ctx.pages()[0] || await ctx.newPage();`,
+    `  try { await page.goto(${JSON.stringify(url)}); } catch {}`,
+    `  console.log('请在浏览器中完成操作后关闭窗口...');`,
+    `  const persistSessionCookies = async () => {`,
+    `    try {`,
+    `      const cookies = await ctx.cookies();`,
+    `      const session = cookies.filter(c => c.expires === -1);`,
+    `      if (session.length > 0) {`,
+    `        await ctx.addCookies(session.map(c => ({ ...c, expires: ${thirtyDays} })));`,
+    `        console.log('已将 ' + session.length + ' 个 session cookie 转为持久化');`,
+    `      }`,
+    `    } catch {}`,
+    `  };`,
+    `  ctx.on('page', p => p.on('close', () => persistSessionCookies()));`,
+    `  for (const p of ctx.pages()) p.on('close', () => persistSessionCookies());`,
+    `  await new Promise(r => {`,
+    `    ctx.on('close', r);`,
+    `    const t = setInterval(async () => {`,
+    `      try {`,
+    `        if (!ctx.pages().length) { clearInterval(t); await persistSessionCookies(); r(); }`,
+    `      } catch { clearInterval(t); r(); }`,
+    `    }, 2000);`,
+    `  });`,
+    `  try { await ctx.close(); } catch {}`,
+    `})().then(() => process.exit(0)).catch(() => process.exit(0));`,
+  ].join('\n');
+}
+
+function runBrowserScript(script, cwd) {
+  const tmpScript = path.join(os.tmpdir(), `pw-auth-${Date.now()}.js`);
+  fs.writeFileSync(tmpScript, script);
+  try {
+    execSync(`node "${tmpScript}"`, { stdio: 'inherit', cwd });
+    return true;
+  } catch {
+    return false;
+  } finally {
+    try { fs.unlinkSync(tmpScript); } catch {}
+  }
+}
+
+// ─────────────────────────────────────────────────────────────
+// auth 模式实现
+// ─────────────────────────────────────────────────────────────
+
+async function authPersistent(url) {
+  const playwrightDir = resolvePlaywright();
+  if (!playwrightDir) {
+    log('error', '未找到 playwright 模块');
+    log('info', '请安装: npm install -g playwright && npx playwright install chromium');
+    return;
+  }
+
+  const profileDir = assets.path('browserProfile');
+  if (!fs.existsSync(profileDir)) fs.mkdirSync(profileDir, { recursive: true });
+
+  const lockFile = path.join(profileDir, 'SingletonLock');
+  if (fs.existsSync(lockFile)) {
+    fs.unlinkSync(lockFile);
+    log('warn', '已清理残留的 SingletonLock（上次浏览器未正常关闭）');
+  }
+
+  console.log('操作步骤:');
+  console.log('  1. 浏览器将自动打开，请手动完成登录');
+  console.log('  2. 登录成功后关闭浏览器窗口');
+  console.log('  3. 登录状态将保存在持久化配置中（session cookie 自动转持久化）');
+  console.log('  4. MCP 后续会话自动复用此登录状态');
+  console.log('');
+
+  const script = buildBrowserScript(playwrightDir, profileDir, url);
+  const projectRoot = assets.projectRoot;
+
+  const ok = runBrowserScript(script, projectRoot);
+  if (!ok) {
+    const profileFiles = fs.readdirSync(profileDir);
+    if (profileFiles.length <= 2) {
+      log('error', 'Playwright 启动失败，且未检测到有效的浏览器配置');
+      log('info', '请确保已安装 Chromium: npx playwright install chromium');
+      return;
+    }
+    log('warn', '浏览器退出码非零，但已检测到有效配置，继续...');
+  }
+
+  const mcpPath = assets.path('mcpConfig');
+  log('ok', '登录状态已保存到持久化配置');
+  updateMcpConfig(mcpPath, 'persistent');
+  updateGitignore('.claude-coder/.runtime/browser-profile');
+  enableMcpPlaywrightEnv();
+
+  console.log('');
+  log('ok', '配置完成！');
+  const relProfile = path.relative(projectRoot, profileDir);
+  log('info', `MCP 使用 persistent 模式 (user-data-dir: ${relProfile})`);
+  log('info', '验证: 再次运行 claude-coder auth <URL>，浏览器应直接进入已登录状态');
+}
+
+async function authIsolated(url) {
+  const playwrightAuthPath = assets.path('playwrightAuth');
+  const projectRoot = assets.projectRoot;
+
+  console.log('操作步骤:');
+  console.log('  1. 浏览器将自动打开，请手动完成登录');
+  console.log('  2. 登录成功后关闭浏览器窗口');
+  console.log('  3. 登录状态（cookies + localStorage）将保存到 playwright-auth.json');
+  console.log('  4. MCP 每次会话自动从此文件加载初始状态');
+  console.log('');
+
+  try {
+    execSync(
+      `npx playwright codegen --save-storage="${playwrightAuthPath}" "${url}"`,
+      { stdio: 'inherit', cwd: projectRoot }
+    );
+  } catch (err) {
+    if (!fs.existsSync(playwrightAuthPath)) {
+      log('error', `Playwright 登录状态导出失败: ${err.message}`);
+      log('info', '请确保已安装: npx playwright install chromium');
+      return;
+    }
+  }
+
+  if (!fs.existsSync(playwrightAuthPath)) {
+    log('error', '未检测到导出的登录状态文件');
+    return;
+  }
+
+  const mcpPath = assets.path('mcpConfig');
+  log('ok', '登录状态已保存到 playwright-auth.json');
+  updateMcpConfig(mcpPath, 'isolated');
+  updateGitignore('.claude-coder/playwright-auth.json');
+  enableMcpPlaywrightEnv();
+
+  console.log('');
+  log('ok', '配置完成！');
+  log('info', 'MCP 使用 isolated 模式 (storage-state)');
+  log('info', 'cookies 和 localStorage 每次会话自动从 playwright-auth.json 加载');
+}
+
+function authExtension() {
+  console.log('Extension 模式说明:');
+  console.log('');
+  console.log('  此模式通过 Chrome 扩展连接到您正在运行的浏览器。');
+  console.log('  MCP 将直接使用浏览器中已有的登录态和扩展。');
+  console.log('');
+  console.log('  前置条件:');
+  console.log('  1. 安装 "Playwright MCP Bridge" Chrome/Edge 扩展');
+  console.log('     https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm');
+  console.log('  2. 确保浏览器已启动且扩展已启用');
+  console.log('  3. 无需额外认证操作，您的浏览器登录态将自动可用');
+  console.log('');
+
+  const mcpPath = assets.path('mcpConfig');
+  updateMcpConfig(mcpPath, 'extension');
+  enableMcpPlaywrightEnv();
+
+  console.log('');
+  log('ok', '配置完成！');
+  log('info', 'MCP 使用 extension 模式（连接真实浏览器）');
+  log('info', '确保 Chrome/Edge 已运行且 Playwright MCP Bridge 扩展已启用');
+}
+
+// ─────────────────────────────────────────────────────────────
+// 入口
+// ─────────────────────────────────────────────────────────────
+
+async function auth(url) {
+  assets.ensureDirs();
+  const config = loadConfig();
+  const mode = config.playwrightMode;
+  const targetUrl = normalizeUrl(url) || 'http://localhost:3000';
+
+  log('info', `Playwright 模式: ${mode}`);
+  log('info', `目标 URL: ${targetUrl}`);
+  console.log('');
+
+  switch (mode) {
+    case 'persistent':
+      await authPersistent(targetUrl);
+      break;
+    case 'isolated':
+      await authIsolated(targetUrl);
+      break;
+    case 'extension':
+      authExtension();
+      break;
+    default:
+      log('error', `未知的 Playwright 模式: ${mode}`);
+      log('info', '请运行 claude-coder setup 重新配置');
+      return;
+  }
+}
+
+module.exports = { auth, updateMcpConfig };

package/src/commands/setup-modules/helpers.js

@@ -0,0 +1,105 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { log, COLOR } = require('../../common/config');
+const { appendGitignore } = require('../../common/utils');
+const { assets } = require('../../common/assets');
+
+function createInterface() {
+  return readline.createInterface({ input: process.stdin, output: process.stdout });
+}
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+function askChoice(rl, prompt, min, max, defaultVal) {
+  return new Promise(async (resolve) => {
+    while (true) {
+      const raw = await ask(rl, prompt);
+      const val = raw.trim() || String(defaultVal ?? '');
+      const num = parseInt(val, 10);
+      if (num >= min && num <= max) return resolve(num);
+      console.log(`请输入 ${min}-${max}`);
+    }
+  });
+}
+
+async function askApiKey(rl, platform, apiUrl, existingKey) {
+  if (existingKey) {
+    console.log('回车保留当前 API Key，输入新 Key 更新，输入 q 返回上层菜单:');
+  } else {
+    console.log(`请输入 ${platform} 的 API Key:`);
+  }
+  if (apiUrl) {
+    console.log(`  ${COLOR.blue}获取入口: ${apiUrl}${COLOR.reset}`);
+    console.log('');
+  }
+  const key = await ask(rl, '  API Key: ');
+  const trimmed = key.trim();
+  if (trimmed.toLowerCase() === 'q') {
+    return null;
+  }
+  if (!trimmed) {
+    if (existingKey) return existingKey;
+    console.error('API Key 不能为空');
+    process.exit(1);
+  }
+  return trimmed;
+}
+
+function writeConfig(filePath, lines) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  if (fs.existsSync(filePath)) {
+    const ts = new Date().toISOString().replace(/[:\-T]/g, '').slice(0, 14);
+    const backup = `${filePath}.bak.${ts}`;
+    fs.copyFileSync(filePath, backup);
+    log('info', `已备份旧配置到: ${backup}`);
+  }
+
+  fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf8');
+}
+
+function ensureGitignore() {
+  const projectRoot = assets.projectRoot;
+  const patterns = ['.claude-coder/.env', '.claude-coder/.runtime/', '.claude-coder/test.env'];
+  let added = false;
+  for (const pattern of patterns) {
+    if (appendGitignore(projectRoot, pattern)) added = true;
+  }
+  if (added) {
+    log('info', '已更新 .gitignore');
+  }
+}
+
+function showCurrentConfig(existing) {
+  console.log('');
+  console.log(`${COLOR.blue}当前配置:${COLOR.reset}`);
+  console.log(`  提供商:     ${existing.MODEL_PROVIDER || '未配置'}`);
+  console.log(`  BASE_URL:   ${existing.ANTHROPIC_BASE_URL || '默认'}`);
+  console.log(`  模型:       ${existing.ANTHROPIC_MODEL || '默认'}`);
+  console.log(`  MCP:        ${existing.MCP_PLAYWRIGHT === 'true' ? `已启用 (${existing.MCP_PLAYWRIGHT_MODE || 'persistent'})` : '未启用'}`);
+  const compTimeout = existing.SESSION_COMPLETION_TIMEOUT || '300';
+  const turns = existing.SESSION_MAX_TURNS || '0';
+  console.log(`  停顿超时:   ${existing.SESSION_STALL_TIMEOUT || '600'} 秒`);
+  console.log(`  完成检测:   ${compTimeout} 秒`);
+  console.log(`  工具轮次:   ${turns === '0' ? '无限制' : turns}`);
+  const simplifyInterval = existing.SIMPLIFY_INTERVAL ?? '5';
+  const simplifyCommits = existing.SIMPLIFY_COMMITS ?? '5';
+  console.log(`  自动审查:   ${simplifyInterval === '0' ? '禁用' : `每 ${simplifyInterval} 个 session`}${simplifyInterval !== '0' ? `，审查 ${simplifyCommits} 个 commit` : ''}`);
+  console.log('');
+}
+
+module.exports = {
+  createInterface,
+  ask,
+  askChoice,
+  askApiKey,
+  writeConfig,
+  ensureGitignore,
+  showCurrentConfig,
+};

package/src/commands/setup-modules/index.js

@@ -0,0 +1,26 @@
+'use strict';
+
+// ── setup 子模块统一入口 ──
+
+const helpers = require('./helpers');
+const provider = require('./provider');
+const mcp = require('./mcp');
+const safety = require('./safety');
+const simplify = require('./simplify');
+
+module.exports = {
+  createInterface: helpers.createInterface,
+  ask: helpers.ask,
+  askChoice: helpers.askChoice,
+  askApiKey: helpers.askApiKey,
+  writeConfig: helpers.writeConfig,
+  ensureGitignore: helpers.ensureGitignore,
+  showCurrentConfig: helpers.showCurrentConfig,
+  selectProvider: provider.selectProvider,
+  updateApiKeyOnly: provider.updateApiKeyOnly,
+  configureMCP: mcp.configureMCP,
+  appendMcpConfig: mcp.appendMcpConfig,
+  updateMCPOnly: mcp.updateMCPOnly,
+  updateSafetyLimits: safety.updateSafetyLimits,
+  updateSimplifyConfig: simplify.updateSimplifyConfig,
+};

package/src/commands/setup-modules/mcp.js

@@ -0,0 +1,95 @@
+'use strict';
+
+const { ask, askChoice } = require('./helpers');
+const { log, COLOR, updateEnvVar } = require('../../common/config');
+const { assets } = require('../../common/assets');
+
+// ── MCP 配置 ──
+
+async function configureMCP(rl) {
+  console.log('');
+  console.log('是否启用 Playwright MCP（浏览器自动化测试）？');
+  console.log('');
+  console.log('  Playwright MCP 由微软官方维护 (github.com/microsoft/playwright-mcp)');
+  console.log('  提供 browser_click、browser_snapshot 等 25+ 浏览器自动化工具');
+  console.log('  适用于有 Web 前端的项目，Agent 可用它做端到端测试');
+  console.log('');
+  console.log('  1) 是 - 启用 Playwright MCP（项目有 Web 前端）');
+  console.log('  2) 否 - 跳过（纯后端 / CLI 项目）');
+  console.log('');
+
+  const mcpChoice = await askChoice(rl, '选择 [1-2]: ', 1, 2);
+
+  const mcpConfig = { enabled: false, mode: null };
+
+  if (mcpChoice === 1) {
+    mcpConfig.enabled = true;
+    console.log('');
+    console.log('请选择 Playwright MCP 浏览器模式:');
+    console.log('');
+    console.log('  1) persistent - 懒人模式（默认，推荐）');
+    console.log('     登录一次永久生效，适合 Google SSO、企业内网 API 拉取等日常开发');
+    console.log('');
+    console.log('  2) isolated - 开发模式');
+    console.log('     每次会话从快照加载，适合验证登录流程的自动化测试');
+    console.log('');
+    console.log('  3) extension - 连接真实浏览器（实验性）');
+    console.log('     通过 Chrome 扩展复用已有登录态和插件');
+    console.log('     需要安装 "Playwright MCP Bridge" 扩展');
+    console.log('');
+
+    const modeChoice = await askChoice(rl, '选择 [1-3，默认 1]: ', 1, 3, 1);
+    const modeMap = { 1: 'persistent', 2: 'isolated', 3: 'extension' };
+    mcpConfig.mode = modeMap[modeChoice];
+
+    console.log('');
+    if (mcpConfig.mode === 'extension') {
+      console.log(`  ${COLOR.yellow}⚠ 前置条件：安装 Playwright MCP Bridge 浏览器扩展${COLOR.reset}`);
+      console.log(`  ${COLOR.blue}  https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm${COLOR.reset}`);
+      console.log('');
+      console.log('  安装扩展后，运行 claude-coder auth 生成 .mcp.json 配置');
+    } else if (mcpConfig.mode === 'persistent') {
+      console.log('  使用 claude-coder auth <URL> 打开浏览器完成首次登录');
+      console.log('  登录状态将持久保存，后续 MCP 会话自动复用');
+      console.log('');
+      console.log('  请确保已安装 Playwright:');
+      console.log(`  ${COLOR.blue}npx playwright install chromium${COLOR.reset}`);
+    } else {
+      console.log('  使用 claude-coder auth <URL> 录制登录状态到 playwright-auth.json');
+      console.log('  MCP 每次会话从此文件加载初始 cookies/localStorage');
+    }
+  }
+
+  return mcpConfig;
+}
+
+// ── MCP 配置追加到 lines ──
+
+function appendMcpConfig(lines, mcpConfig) {
+  lines.push('', '# MCP 工具配置');
+  if (mcpConfig.enabled) {
+    lines.push('MCP_PLAYWRIGHT=true');
+    if (mcpConfig.mode) lines.push(`MCP_PLAYWRIGHT_MODE=${mcpConfig.mode}`);
+  } else {
+    lines.push('MCP_PLAYWRIGHT=false');
+  }
+}
+
+// ── 仅更新 MCP 配置 ──
+
+async function updateMCPOnly(rl) {
+  const mcpConfig = await configureMCP(rl);
+  updateEnvVar('MCP_PLAYWRIGHT', mcpConfig.enabled ? 'true' : 'false');
+  if (mcpConfig.enabled && mcpConfig.mode) {
+    updateEnvVar('MCP_PLAYWRIGHT_MODE', mcpConfig.mode);
+    const { updateMcpConfig } = require('../auth');
+    updateMcpConfig(assets.path('mcpConfig'), mcpConfig.mode);
+  }
+  log('ok', 'MCP 配置已更新');
+}
+
+module.exports = {
+  configureMCP,
+  appendMcpConfig,
+  updateMCPOnly,
+};