claude-coder 1.9.0 → 1.9.2

package/src/core/simplify.js

@@ -1,74 +1,74 @@
-'use strict';
-
-const { log } = require('../common/config');
-const { assets } = require('../common/assets');
-const { Session } = require('./session');
-const { execSync } = require('child_process');
-
-const AUTO_COMMIT_MSG = 'style: auto simplify';
-
-function getSmartDiffRange(projectRoot, fallbackN) {
-  try {
-    const hash = execSync(
-      `git log --grep='${AUTO_COMMIT_MSG}' -1 --format='%H'`,
-      { cwd: projectRoot, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] },
-    ).trim();
-    if (hash) return { range: `${hash}..HEAD`, label: `自上次 auto simplify 以来` };
-  } catch { /* ignore */ }
-  return { range: `HEAD~${fallbackN}..HEAD`, label: `最近 ${fallbackN} 个 commit` };
-}
-
-function commitIfDirty(projectRoot) {
-  try {
-    execSync('git diff --quiet HEAD', { cwd: projectRoot, stdio: 'pipe' });
-  } catch {
-    execSync(`git add -A && git commit -m "${AUTO_COMMIT_MSG}"`, { cwd: projectRoot, stdio: 'pipe' });
-    log('ok', `代码优化已提交: ${AUTO_COMMIT_MSG}`);
-  }
-}
-
-async function executeSimplify(config, focus = null, opts = {}) {
-  const n = opts.n || 3;
-  const projectRoot = assets.projectRoot;
-
-  const { range, label } = getSmartDiffRange(projectRoot, n);
-
-  let diff = '';
-  try {
-    diff = execSync(`git diff ${range}`, { cwd: projectRoot, encoding: 'utf8', maxBuffer: 50 * 1024 * 1024 });
-  } catch (err) {
-    log('warn', `无法获取 diff (${label}): ${err.message}`);
-  }
-
-  if (!diff.trim()) {
-    log('info', `无变更需要审查 (${label})`);
-    return { success: true };
-  }
-
-  const focusLine = focus ? `\n审查聚焦方向：${focus}` : '';
-  const prompt = `/simplify\n\n审查范围：${label}${focusLine}\n\n${diff.slice(0, 50000)}`;
-  const dateStr = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 12);
-
-  const result = await Session.run('simplify', config, {
-    logFileName: `simplify_${dateStr}.log`,
-    label: 'simplify',
-
-    async execute(session) {
-      log('info', `正在审查代码变更 (${label})...`);
-
-      const queryOpts = session.buildQueryOptions(opts);
-      queryOpts.disallowedTools = ['askUserQuestion'];
-
-      await session.runQuery(prompt, queryOpts);
-      log('ok', '代码审查完成');
-
-      return {};
-    },
-  });
-
-  commitIfDirty(projectRoot);
-
-  return result;
-}
-
-module.exports = { executeSimplify };
+'use strict';
+
+const { log } = require('../common/config');
+const { assets } = require('../common/assets');
+const { Session } = require('./session');
+const { execSync } = require('child_process');
+
+const AUTO_COMMIT_MSG = 'style: auto simplify';
+
+function getSmartDiffRange(projectRoot, fallbackN) {
+  try {
+    const hash = execSync(
+      `git log --grep='${AUTO_COMMIT_MSG}' -1 --format='%H'`,
+      { cwd: projectRoot, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] },
+    ).trim();
+    if (hash) return { range: `${hash}..HEAD`, label: `自上次 auto simplify 以来` };
+  } catch { /* ignore */ }
+  return { range: `HEAD~${fallbackN}..HEAD`, label: `最近 ${fallbackN} 个 commit` };
+}
+
+function commitIfDirty(projectRoot) {
+  try {
+    execSync('git diff --quiet HEAD', { cwd: projectRoot, stdio: 'pipe' });
+  } catch {
+    execSync(`git add -A && git commit -m "${AUTO_COMMIT_MSG}"`, { cwd: projectRoot, stdio: 'pipe' });
+    log('ok', `代码优化已提交: ${AUTO_COMMIT_MSG}`);
+  }
+}
+
+async function executeSimplify(config, focus = null, opts = {}) {
+  const n = opts.n || 3;
+  const projectRoot = assets.projectRoot;
+
+  const { range, label } = getSmartDiffRange(projectRoot, n);
+
+  let diff = '';
+  try {
+    diff = execSync(`git diff ${range}`, { cwd: projectRoot, encoding: 'utf8', maxBuffer: 50 * 1024 * 1024 });
+  } catch (err) {
+    log('warn', `无法获取 diff (${label}): ${err.message}`);
+  }
+
+  if (!diff.trim()) {
+    log('info', `无变更需要审查 (${label})`);
+    return { success: true };
+  }
+
+  const focusLine = focus ? `\n审查聚焦方向：${focus}` : '';
+  const prompt = `/simplify\n\n审查范围：${label}${focusLine}\n\n${diff.slice(0, 50000)}`;
+  const dateStr = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 12);
+
+  const result = await Session.run('simplify', config, {
+    logFileName: `simplify_${dateStr}.log`,
+    label: 'simplify',
+
+    async execute(session) {
+      log('info', `正在审查代码变更 (${label})...`);
+
+      const queryOpts = session.buildQueryOptions(opts);
+      queryOpts.disallowedTools = ['askUserQuestion'];
+
+      await session.runQuery(prompt, queryOpts);
+      log('ok', '代码审查完成');
+
+      return {};
+    },
+  });
+
+  commitIfDirty(projectRoot);
+
+  return result;
+}
+
+module.exports = { executeSimplify };

package/src/core/state.js

@@ -1,105 +1,105 @@
-'use strict';
-
-const { assets } = require('../common/assets');
-const { getFeatures } = require('../common/tasks');
-const { TASK_STATUSES } = require('../common/constants');
-
-// ─── Harness State (harness_state.json) ───────────────────
-
-const DEFAULT_STATE = Object.freeze({
-  version: 1,
-  next_task_id: 1,
-  next_priority: 1,
-  session_count: 0,
-  last_simplify_session: 0,
-  current_task_id: null,
-});
-
-function loadState() {
-  return assets.readJson('harnessState', { ...DEFAULT_STATE });
-}
-
-function saveState(data) {
-  assets.writeJson('harnessState', data);
-}
-
-function extractIdNum(id) {
-  const m = String(id).match(/(\d+)$/);
-  return m ? parseInt(m[1], 10) : 0;
-}
-
-function syncAfterPlan() {
-  const state = loadState();
-  const tasks = assets.readJson('tasks', null);
-  if (!tasks || !tasks.features) return state;
-
-  const features = tasks.features;
-  state.next_task_id = features.reduce((max, f) => Math.max(max, extractIdNum(f.id)), 0) + 1;
-  state.next_priority = features.reduce((max, f) => Math.max(max, f.priority || 0), 0) + 1;
-  saveState(state);
-  return state;
-}
-
-// ─── Task Scheduling ──────────────────────────────────────
-
-function selectNextTask(taskData) {
-  const features = getFeatures(taskData);
-
-  const failed = features.filter(f => f.status === 'failed')
-    .sort((a, b) => (a.priority || 999) - (b.priority || 999));
-  if (failed.length > 0) return failed[0];
-
-  const pending = features.filter(f => f.status === 'pending')
-    .filter(f => {
-      const deps = f.depends_on || [];
-      return deps.every(depId => {
-        const dep = features.find(x => x.id === depId);
-        return dep && dep.status === 'done';
-      });
-    })
-    .sort((a, b) => (a.priority || 999) - (b.priority || 999));
-  if (pending.length > 0) return pending[0];
-
-  const inProgress = features.filter(f => f.status === 'in_progress')
-    .sort((a, b) => (a.priority || 999) - (b.priority || 999));
-  return inProgress[0] || null;
-}
-
-function isAllDone(taskData) {
-  const features = getFeatures(taskData);
-  return features.length > 0 && features.every(f => f.status === 'done');
-}
-
-// ─── Progress & Counters ──────────────────────────────────
-
-function appendProgress(entry) {
-  let progress = assets.readJson('progress', { sessions: [] });
-  if (!Array.isArray(progress.sessions)) progress.sessions = [];
-  progress.sessions.push(entry);
-  assets.writeJson('progress', progress);
-}
-
-function incrementSession() {
-  const state = loadState();
-  state.session_count++;
-  saveState(state);
-}
-
-function markSimplifyDone() {
-  const state = loadState();
-  state.last_simplify_session = state.session_count;
-  saveState(state);
-}
-
-module.exports = {
-  DEFAULT_STATE,
-  loadState,
-  saveState,
-  syncAfterPlan,
-  selectNextTask,
-  isAllDone,
-  appendProgress,
-  incrementSession,
-  markSimplifyDone,
-  TASK_STATUSES,
-};
+'use strict';
+
+const { assets } = require('../common/assets');
+const { getFeatures } = require('../common/tasks');
+const { TASK_STATUSES } = require('../common/constants');
+
+// ─── Harness State (harness_state.json) ───────────────────
+
+const DEFAULT_STATE = Object.freeze({
+  version: 1,
+  next_task_id: 1,
+  next_priority: 1,
+  session_count: 0,
+  last_simplify_session: 0,
+  current_task_id: null,
+});
+
+function loadState() {
+  return assets.readJson('harnessState', { ...DEFAULT_STATE });
+}
+
+function saveState(data) {
+  assets.writeJson('harnessState', data);
+}
+
+function extractIdNum(id) {
+  const m = String(id).match(/(\d+)$/);
+  return m ? parseInt(m[1], 10) : 0;
+}
+
+function syncAfterPlan() {
+  const state = loadState();
+  const tasks = assets.readJson('tasks', null);
+  if (!tasks || !tasks.features) return state;
+
+  const features = tasks.features;
+  state.next_task_id = features.reduce((max, f) => Math.max(max, extractIdNum(f.id)), 0) + 1;
+  state.next_priority = features.reduce((max, f) => Math.max(max, f.priority || 0), 0) + 1;
+  saveState(state);
+  return state;
+}
+
+// ─── Task Scheduling ──────────────────────────────────────
+
+function selectNextTask(taskData) {
+  const features = getFeatures(taskData);
+
+  const failed = features.filter(f => f.status === 'failed')
+    .sort((a, b) => (a.priority || 999) - (b.priority || 999));
+  if (failed.length > 0) return failed[0];
+
+  const pending = features.filter(f => f.status === 'pending')
+    .filter(f => {
+      const deps = f.depends_on || [];
+      return deps.every(depId => {
+        const dep = features.find(x => x.id === depId);
+        return dep && dep.status === 'done';
+      });
+    })
+    .sort((a, b) => (a.priority || 999) - (b.priority || 999));
+  if (pending.length > 0) return pending[0];
+
+  const inProgress = features.filter(f => f.status === 'in_progress')
+    .sort((a, b) => (a.priority || 999) - (b.priority || 999));
+  return inProgress[0] || null;
+}
+
+function isAllDone(taskData) {
+  const features = getFeatures(taskData);
+  return features.length > 0 && features.every(f => f.status === 'done');
+}
+
+// ─── Progress & Counters ──────────────────────────────────
+
+function appendProgress(entry) {
+  let progress = assets.readJson('progress', { sessions: [] });
+  if (!Array.isArray(progress.sessions)) progress.sessions = [];
+  progress.sessions.push(entry);
+  assets.writeJson('progress', progress);
+}
+
+function incrementSession() {
+  const state = loadState();
+  state.session_count++;
+  saveState(state);
+}
+
+function markSimplifyDone() {
+  const state = loadState();
+  state.last_simplify_session = state.session_count;
+  saveState(state);
+}
+
+module.exports = {
+  DEFAULT_STATE,
+  loadState,
+  saveState,
+  syncAfterPlan,
+  selectNextTask,
+  isAllDone,
+  appendProgress,
+  incrementSession,
+  markSimplifyDone,
+  TASK_STATUSES,
+};

package/src/index.js

@@ -1,76 +1,76 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { loadConfig, log } = require('./common/config');
-const { assets } = require('./common/assets');
-const { Session } = require('./core/session');
-
-/** @typedef {{ max?: number, pause?: number, dryRun?: boolean, readFile?: string, model?: string, n?: number, planOnly?: boolean, interactive?: boolean, reset?: boolean, deployTemplates?: boolean, projectRoot?: string, reqFile?: string }} MainOpts */
-
-function checkReady(command) {
-  if (['init', 'scan'].includes(command)) return;
-
-  if (!assets.exists('profile')) {
-    throw new Error('文件缺失: project_profile.json，请运行 claude-coder init 初始化项目');
-  }
-}
-
-/**
- * 应用入口：初始化资产、加载配置、分发命令
- * @param {string} command - 命令名称（init | scan | plan | run | go | simplify）
- * @param {string} input - 位置参数（需求文本等）
- * @param {MainOpts} [opts={}] - CLI 选项
- * @returns {Promise<Object|void>}
- */
-async function main(command, input, opts = {}) {
-  assets.init(opts.projectRoot || process.cwd());
-  assets.ensureDirs();
-  const config = loadConfig();
-
-  if (!opts.model) opts.model = config.defaultOpus || config.model;
-
-  if (opts.readFile) {
-    const reqPath = path.resolve(assets.projectRoot, opts.readFile);
-    if (!fs.existsSync(reqPath)) {
-      throw new Error(`文件不存在: ${reqPath}`);
-    }
-    opts.reqFile = reqPath;
-  }
-
-  checkReady(command);
-
-  const displayModel = opts.model || '(default)';
-  log('ok', `模型: ${config.provider || 'claude'} (${displayModel}), 命令: ${command}`);
-
-  switch (command) {
-    case 'init': {
-      const { executeInit } = require('./core/init');
-      return executeInit(config, opts);
-    }
-    case 'scan': {
-      const { executeScan } = require('./core/scan');
-      return executeScan(config, opts);
-    }
-    case 'simplify': {
-      const { executeSimplify } = require('./core/simplify');
-      return executeSimplify(config, input, opts);
-    }
-    case 'plan': {
-      const { executePlan } = require('./core/plan');
-      return executePlan(config, input, opts);
-    }
-    case 'run': {
-      const { executeRun } = require('./core/runner');
-      return executeRun(config, opts);
-    }
-    case 'go': {
-      const { executeGo } = require('./core/go');
-      return executeGo(config, input, opts);
-    }
-    default:
-      throw new Error(`未知命令: ${command}`);
-  }
-}
-
-module.exports = { main, Session };
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { loadConfig, log } = require('./common/config');
+const { assets } = require('./common/assets');
+const { Session } = require('./core/session');
+
+/** @typedef {{ max?: number, pause?: number, dryRun?: boolean, readFile?: string, model?: string, n?: number, planOnly?: boolean, interactive?: boolean, reset?: boolean, deployTemplates?: boolean, projectRoot?: string, reqFile?: string }} MainOpts */
+
+function checkReady(command) {
+  if (['init', 'scan'].includes(command)) return;
+
+  if (!assets.exists('profile')) {
+    throw new Error('文件缺失: project_profile.json，请运行 claude-coder init 初始化项目');
+  }
+}
+
+/**
+ * 应用入口：初始化资产、加载配置、分发命令
+ * @param {string} command - 命令名称（init | scan | plan | run | go | simplify）
+ * @param {string} input - 位置参数（需求文本等）
+ * @param {MainOpts} [opts={}] - CLI 选项
+ * @returns {Promise<Object|void>}
+ */
+async function main(command, input, opts = {}) {
+  assets.init(opts.projectRoot || process.cwd());
+  assets.ensureDirs();
+  const config = loadConfig();
+
+  if (!opts.model) opts.model = config.defaultOpus || config.model;
+
+  if (opts.readFile) {
+    const reqPath = path.resolve(assets.projectRoot, opts.readFile);
+    if (!fs.existsSync(reqPath)) {
+      throw new Error(`文件不存在: ${reqPath}`);
+    }
+    opts.reqFile = reqPath;
+  }
+
+  checkReady(command);
+
+  const displayModel = opts.model || '(default)';
+  log('ok', `模型: ${config.provider || 'claude'} (${displayModel}), 命令: ${command}`);
+
+  switch (command) {
+    case 'init': {
+      const { executeInit } = require('./core/init');
+      return executeInit(config, opts);
+    }
+    case 'scan': {
+      const { executeScan } = require('./core/scan');
+      return executeScan(config, opts);
+    }
+    case 'simplify': {
+      const { executeSimplify } = require('./core/simplify');
+      return executeSimplify(config, input, opts);
+    }
+    case 'plan': {
+      const { executePlan } = require('./core/plan');
+      return executePlan(config, input, opts);
+    }
+    case 'run': {
+      const { executeRun } = require('./core/runner');
+      return executeRun(config, opts);
+    }
+    case 'go': {
+      const { executeGo } = require('./core/go');
+      return executeGo(config, input, opts);
+    }
+    default:
+      throw new Error(`未知命令: ${command}`);
+  }
+}
+
+module.exports = { main, Session };

package/templates/bash-process.md

@@ -1,12 +1,12 @@
-【进程管理规则】
-- 停止服务前检查 project_profile.json 的 services 配置
-- 使用配置中的端口进行精确 kill
-- 单次模式：收尾时停止所有后台服务
-- 连续模式：保持服务运行供下个 session 使用
-
-【跨平台命令】
-- Windows: `netstat -ano | findstr :PORT` → `taskkill /F /T /PID <PID>`（/T 杀进程树，必须带）
-- Linux/Mac: `lsof -ti :PORT | xargs kill -9`
-- 跨平台备选: `npx kill-port PORT`
-- PowerShell: `Get-NetTCPConnection -LocalPort PORT -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }`
-- Python venv: uvicorn --reload 产生父子进程树，必须用 /T 或杀父进程
+【进程管理规则】
+- 停止服务前检查 project_profile.json 的 services 配置
+- 使用配置中的端口进行精确 kill
+- 单次模式：收尾时停止所有后台服务
+- 连续模式：保持服务运行供下个 session 使用
+
+【跨平台命令】
+- Windows: `netstat -ano | findstr :PORT` → `taskkill /F /T /PID <PID>`（/T 杀进程树，必须带）
+- Linux/Mac: `lsof -ti :PORT | xargs kill -9`
+- 跨平台备选: `npx kill-port PORT`
+- PowerShell: `Get-NetTCPConnection -LocalPort PORT -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }`
+- Python venv: uvicorn --reload 产生父子进程树，必须用 /T 或杀父进程

package/templates/codingSystem.md

@@ -1,65 +1,65 @@
-<!--
-  Coding Session System Prompt.
-  Prepended after coreProtocol.md by buildSystemPrompt('coding').
-  .claude/CLAUDE.md is auto-loaded by the SDK (settingSources: ['project']).
--->
-
-# 编码会话协议
-
-你是增量编码 Agent。任务上下文已由 harness 注入 prompt，无需手动查找。
-
-## 铁律
-
-1. tasks.json 只改 `status` 字段，不得删改任务描述
-2. 状态必须按状态机迁移，不得跳步
-3. 未通过端到端测试不得标记 `done`
-4. 发现 Bug 先修后建
-5. 文档按需更新：对外行为变化才改 README；新模块/API 才更新架构文档
-6. `.claude/CLAUDE.md` 只读
-7. 遇到疑问或不确定时，自行判断最佳方案并执行，不要尝试提问
-
-## 状态机
-
-- `pending` → `in_progress`（开始编码）
-- `in_progress` → `testing`（编码完成）
-- `testing` → `done`（测试通过）| `failed`（测试失败）
-- `failed` → `in_progress`（重试修复）
-
-## 文件权限
-
-- `tasks.json` — 功能任务列表，带状态跟踪，只能修改 status 字段
-- `test.env` — 测试凭证（API Key、测试账号等）可追加写入
-- `project_profile.json` — 项目元数据（技术栈、服务等）只读（需要详情时可读取）
-
-## 工作流程
-
-**Step 1 — 实现**
-1. 确认 prompt 中注入的任务，status → `in_progress`
-2. 先读相关文档，再读相关源文件，列改动清单，一次性完成编码
-3. 信息不完整时，读 `.claude-coder/tasks.json` 或 `project_profile.json` 补充
-
-**Step 2 — 验证**
-1. status → `testing`
-2. 按 category 选最轻量方式：backend 用 curl，frontend 用 Playwright MCP，infra 用语法检查
-3. 按任务 steps 最后一步验证。通过 → `done`；失败 → `failed`（notes 记原因）
-
-**Step 3 — 收尾（必须执行）**
-1. 根据 prompt 提示管理后台服务
-2. 写 session_result.json：notes 只写未解决问题
-3. `git add -A && git commit -m "feat(task-id): 描述"`
-
-## 工具规范
-
-- 搜索/读取：Glob/Grep/Read/LS 替代 bash find/grep/cat/ls
-- 编辑：同文件多处改用 MultiEdit，多文件合并一次批量调用
-- 探索：复杂搜索用 Task 启动子 Agent
-- 进程：停服务前 netstat/lsof 定位 PID 再 kill，重启前确认端口释放，失败最多重试 2 次后换方法
-
-## 禁止清单
-
-- 跳步（`pending` → `done`）、回退到 `pending`、未测试直接 `done`
-- 后端任务启动浏览器测试
-- 创建独立测试文件
-- 为测试重启开发服务器
-- 编码-测试反复跳转（先完成全部编码再统一测试）
-- bash find/grep/cat/ls（用对应工具替代）
+<!--
+  Coding Session System Prompt.
+  Prepended after coreProtocol.md by buildSystemPrompt('coding').
+  .claude/CLAUDE.md is auto-loaded by the SDK (settingSources: ['project']).
+-->
+
+# 编码会话协议
+
+你是增量编码 Agent。任务上下文已由 harness 注入 prompt，无需手动查找。
+
+## 铁律
+
+1. tasks.json 只改 `status` 字段，不得删改任务描述
+2. 状态必须按状态机迁移，不得跳步
+3. 未通过端到端测试不得标记 `done`
+4. 发现 Bug 先修后建
+5. 文档按需更新：对外行为变化才改 README；新模块/API 才更新架构文档
+6. `.claude/CLAUDE.md` 只读
+7. 遇到疑问或不确定时，自行判断最佳方案并执行，不要尝试提问
+
+## 状态机
+
+- `pending` → `in_progress`（开始编码）
+- `in_progress` → `testing`（编码完成）
+- `testing` → `done`（测试通过）| `failed`（测试失败）
+- `failed` → `in_progress`（重试修复）
+
+## 文件权限
+
+- `tasks.json` — 功能任务列表，带状态跟踪，只能修改 status 字段
+- `test.env` — 测试凭证（API Key、测试账号等）可追加写入
+- `project_profile.json` — 项目元数据（技术栈、服务等）只读（需要详情时可读取）
+
+## 工作流程
+
+**Step 1 — 实现**
+1. 确认 prompt 中注入的任务，status → `in_progress`
+2. 先读相关文档，再读相关源文件，列改动清单，一次性完成编码
+3. 信息不完整时，读 `.claude-coder/tasks.json` 或 `project_profile.json` 补充
+
+**Step 2 — 验证**
+1. status → `testing`
+2. 按 category 选最轻量方式：backend 用 curl，frontend 用 Playwright MCP，infra 用语法检查
+3. 按任务 steps 最后一步验证。通过 → `done`；失败 → `failed`（notes 记原因）
+
+**Step 3 — 收尾（必须执行）**
+1. 根据 prompt 提示管理后台服务
+2. 写 session_result.json：notes 只写未解决问题
+3. `git add -A && git commit -m "feat(task-id): 描述"`
+
+## 工具规范
+
+- 搜索/读取：Glob/Grep/Read/LS 替代 bash find/grep/cat/ls
+- 编辑：同文件多处改用 MultiEdit，多文件合并一次批量调用
+- 探索：复杂搜索用 Task 启动子 Agent
+- 进程：停服务前 netstat/lsof 定位 PID 再 kill，重启前确认端口释放，失败最多重试 2 次后换方法
+
+## 禁止清单
+
+- 跳步（`pending` → `done`）、回退到 `pending`、未测试直接 `done`
+- 后端任务启动浏览器测试
+- 创建独立测试文件
+- 为测试重启开发服务器
+- 编码-测试反复跳转（先完成全部编码再统一测试）
+- bash find/grep/cat/ls（用对应工具替代）