claude-coder 1.8.2 → 1.8.4

package/src/core/session.js

@@ -1,57 +1,57 @@
-'use strict';
-
-const { loadSDK } = require('../common/sdk');
-const { writeSessionSeparator } = require('../common/logging');
-const { SessionContext } = require('./context');
-
-/**
- * 通用 Session 执行器
- * @param {string} type - session 类型
- * @param {object} config - 配置
- * @param {object} [config.externalCtx] - 外部传入的 SessionContext（共享日志和 indicator）
- */
-async function runSession(type, config) {
-  const sdk = await loadSDK();
-  const ctx = config.externalCtx || new SessionContext(type, config.opts);
-
-  if (!config.externalCtx) {
-    ctx.initLogging(config.logFileName, config.logStream);
-    writeSessionSeparator(ctx.logStream, config.sessionNum || 0, config.label);
-  }
-
-  const stallTimeoutMin = ctx.initHooks(type);
-  ctx.startIndicator(config.sessionNum || 0, stallTimeoutMin);
-
-  try {
-    const result = await config.execute(sdk, ctx);
-    if (config.onSuccess) {
-      await config.onSuccess(result, ctx);
-    }
-    // 只有非外部 ctx 才执行 finish
-    if (!config.externalCtx) {
-      ctx.finish();
-    }
-    return {
-      exitCode: ctx.isStalled() ? 2 : 0,
-      logFile: ctx.logFile,
-      stalled: ctx.isStalled(),
-      ...result,
-    };
-  } catch (err) {
-    if (config.onError) {
-      try { config.onError(err, ctx); } catch { /* ignore callback errors */ }
-    }
-    if (!config.externalCtx) {
-      ctx.errorFinish(err);
-    }
-    return {
-      exitCode: 1,
-      error: err.message,
-      logFile: ctx.logFile,
-    };
-  }
-}
-
-module.exports = {
-  runSession,
+'use strict';
+
+const { loadSDK } = require('../common/sdk');
+const { writeSessionSeparator } = require('../common/logging');
+const { SessionContext } = require('./context');
+
+/**
+ * 通用 Session 执行器
+ * @param {string} type - session 类型
+ * @param {object} config - 配置
+ * @param {object} [config.externalCtx] - 外部传入的 SessionContext（共享日志和 indicator）
+ */
+async function runSession(type, config) {
+  const sdk = await loadSDK();
+  const ctx = config.externalCtx || new SessionContext(type, config.opts);
+
+  if (!config.externalCtx) {
+    ctx.initLogging(config.logFileName, config.logStream);
+    writeSessionSeparator(ctx.logStream, config.sessionNum || 0, config.label);
+  }
+
+  const stallTimeoutMin = ctx.initHooks(type);
+  ctx.startIndicator(config.sessionNum || 0, stallTimeoutMin);
+
+  try {
+    const result = await config.execute(sdk, ctx);
+    if (config.onSuccess) {
+      await config.onSuccess(result, ctx);
+    }
+    // 只有非外部 ctx 才执行 finish
+    if (!config.externalCtx) {
+      ctx.finish();
+    }
+    return {
+      exitCode: ctx.isStalled() ? 2 : 0,
+      logFile: ctx.logFile,
+      stalled: ctx.isStalled(),
+      ...result,
+    };
+  } catch (err) {
+    if (config.onError) {
+      try { config.onError(err, ctx); } catch { /* ignore callback errors */ }
+    }
+    if (!config.externalCtx) {
+      ctx.errorFinish(err);
+    }
+    return {
+      exitCode: 1,
+      error: err.message,
+      logFile: ctx.logFile,
+    };
+  }
+}
+
+module.exports = {
+  runSession,
 };

package/src/core/simplify.js

@@ -1,52 +1,53 @@
-'use strict';
-
-const { runSession } = require('./session');
-const { buildQueryOptions } = require('./query');
-const { log } = require('../common/config');
-const { assets } = require('../common/assets');
-const { execSync } = require('child_process');
-
-async function _runSimplifySession(n = 3, focus = null, opts = {}) {
-  const projectRoot = assets.projectRoot;
-  let diff = '';
-  try {
-    diff = execSync(`git diff HEAD~${n}..HEAD`, { cwd: projectRoot, encoding: 'utf8', maxBuffer: 50 * 1024 * 1024 });
-  } catch (err) {
-    log('warn', `无法获取最近 ${n} 个 commit 的 diff: ${err.message}`);
-  }
-
-  const focusLine = focus ? `\n审查聚焦方向：${focus}` : '';
-  const prompt = `/simplify\n\n审查范围：最近 ${n} 个 commit${focusLine}\n\n${diff.slice(0, 50000)}`;
-  const dateStr = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 12);
-
-  return runSession('simplify', {
-    opts,
-    sessionNum: 0,
-    logFileName: `simplify_${dateStr}.log`,
-    label: 'simplify',
-
-    async execute(sdk, ctx) {
-      log('info', `正在审查最近 ${n} 个 commit 的代码变更...`);
-
-      const queryOpts = buildQueryOptions(ctx.config, opts);
-      queryOpts.hooks = ctx.hooks;
-      queryOpts.abortController = ctx.abortController;
-
-      await ctx.runQuery(sdk, prompt, queryOpts);
-      log('ok', '代码审查完成');
-
-      return {};
-    },
-  });
-}
-
-async function simplify(focus = null, opts = {}) {
-  assets.ensureDirs();
-  const n = opts.n || 3;
-  return _runSimplifySession(n, focus, opts);
-}
-
-module.exports = {
-  simplify,
-  _runSimplifySession,
-};
+'use strict';
+
+const { runSession } = require('./session');
+const { buildQueryOptions } = require('./query');
+const { log } = require('../common/config');
+const { assets } = require('../common/assets');
+const { execSync } = require('child_process');
+
+async function _runSimplifySession(n = 3, focus = null, opts = {}) {
+  const projectRoot = assets.projectRoot;
+  let diff = '';
+  try {
+    diff = execSync(`git diff HEAD~${n}..HEAD`, { cwd: projectRoot, encoding: 'utf8', maxBuffer: 50 * 1024 * 1024 });
+  } catch (err) {
+    log('warn', `无法获取最近 ${n} 个 commit 的 diff: ${err.message}`);
+  }
+
+  const focusLine = focus ? `\n审查聚焦方向：${focus}` : '';
+  const prompt = `/simplify\n\n审查范围：最近 ${n} 个 commit${focusLine}\n\n${diff.slice(0, 50000)}`;
+  const dateStr = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 12);
+
+  return runSession('simplify', {
+    opts,
+    sessionNum: 0,
+    logFileName: `simplify_${dateStr}.log`,
+    label: 'simplify',
+
+    async execute(sdk, ctx) {
+      log('info', `正在审查最近 ${n} 个 commit 的代码变更...`);
+
+      const queryOpts = buildQueryOptions(ctx.config, opts);
+      queryOpts.hooks = ctx.hooks;
+      queryOpts.abortController = ctx.abortController;
+      queryOpts.disallowedTools = ['askUserQuestion'];
+
+      await ctx.runQuery(sdk, prompt, queryOpts);
+      log('ok', '代码审查完成');
+
+      return {};
+    },
+  });
+}
+
+async function simplify(focus = null, opts = {}) {
+  assets.ensureDirs();
+  const n = opts.n || 3;
+  return _runSimplifySession(n, focus, opts);
+}
+
+module.exports = {
+  simplify,
+  _runSimplifySession,
+};

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. `git add -A && git commit -m "feat(task-id): 描述"`
-3. 写 session_result.json：notes 只写未解决问题
-
-## 工具规范
-
-- 搜索/读取：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. `git add -A && git commit -m "feat(task-id): 描述"`
+3. 写 session_result.json：notes 只写未解决问题
+
+## 工具规范
+
+- 搜索/读取：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（用对应工具替代）

package/templates/codingUser.md

@@ -1,17 +1,17 @@
-Session {{sessionNum}}。任务已分配，按 3 步流程执行。
-
-## 任务
-{{taskContext}}
-
-## 上下文
-{{memoryHint}}
-{{envHint}}
-{{docsHint}}
-{{testEnvHint}}
-{{mcpHint}}
-{{playwrightAuthHint}}
-{{retryContext}}
-
-## 收尾
-{{serviceHint}}
-完成后写入 session_result.json（notes 只写未解决问题）。
+Session {{sessionNum}}。任务已分配，按 3 步流程执行。
+
+## 任务
+{{taskContext}}
+
+## 上下文
+{{memoryHint}}
+{{envHint}}
+{{docsHint}}
+{{testEnvHint}}
+{{mcpHint}}
+{{playwrightAuthHint}}
+{{retryContext}}
+
+## 收尾
+{{serviceHint}}
+完成后写入 session_result.json（notes 只写未解决问题）。

package/templates/coreProtocol.md

@@ -1,29 +1,29 @@
-# 核心协议（所有会话共享）
-
-## 铁律（不可违反）
-
-1. **每次结束前必须 git commit**：确保文件不丢失
-2. **每次结束前必须写 session_result.json**：这是 harness 校验你工作成果的唯一依据
-3. **不得修改 requirements.md**：这是用户的需求输入，只能读取和遵循
-4. **project_profile.json 基于事实**：所有字段必须来自实际文件扫描，禁止猜测或编造
-
-## session_result.json 格式
-
-```json
-{
-  "session_result": "success | failed",
-  "status_before": "pending | failed | N/A",
-  "status_after": "done | failed | in_progress | testing | N/A",
-  "notes": "未解决的阻塞问题或关键技术决策（无则留空，不要复述已完成的工作）"
-}
-```
-
-## 关键文件（全局）
-
-| 文件 | 用途 | 权限 |
-|---|---|---|
-| `.claude/CLAUDE.md` | 项目指令（SDK 自动加载） | 只读 |
-| `requirements.md` | 用户需求文档 | **只读** |
-| `.claude-coder/project_profile.json` | 项目元数据（技术栈、服务等） | 只读（scan 时可创建） |
-| `.claude-coder/session_result.json` | 本次会话结构化输出 | 覆盖写入 |
-| `.claude-coder/progress.json` | 跨会话记忆日志（harness 维护） | 只读 |
+# 核心协议（所有会话共享）
+
+## 铁律（不可违反）
+
+1. **每次结束前必须 git commit**：确保文件不丢失
+2. **每次结束前必须写 session_result.json**：这是 harness 校验你工作成果的唯一依据
+3. **不得修改 requirements.md**：这是用户的需求输入，只能读取和遵循
+4. **project_profile.json 基于事实**：所有字段必须来自实际文件扫描，禁止猜测或编造
+
+## session_result.json 格式
+
+```json
+{
+  "session_result": "success | failed",
+  "status_before": "pending | failed | N/A",
+  "status_after": "done | failed | in_progress | testing | N/A",
+  "notes": "未解决的阻塞问题或关键技术决策（无则留空，不要复述已完成的工作）"
+}
+```
+
+## 关键文件（全局）
+
+| 文件 | 用途 | 权限 |
+|---|---|---|
+| `.claude/CLAUDE.md` | 项目指令（SDK 自动加载） | 只读 |
+| `requirements.md` | 用户需求文档 | **只读** |
+| `.claude-coder/project_profile.json` | 项目元数据（技术栈、服务等） | 只读（scan 时可创建） |
+| `.claude-coder/session_result.json` | 本次会话结构化输出 | 覆盖写入 |
+| `.claude-coder/progress.json` | 跨会话记忆日志（harness 维护） | 只读 |