jinzd-ai-cli 0.1.23 → 0.1.26

package/CLAUDE.md

@@ -45,15 +45,21 @@ src/
 │   ├── dev-state.ts                # 开发状态交接（provider/model 切换时快照生成、save/load/clear）
 │   ├── setup-wizard.ts             # @inquirer/prompts 首次运行交互式设置
 │   └── commands/
-│       └── index.ts                # CommandRegistry + 19个命令（/help /about /provider /model /clear /compact /plan /session /system /context /status /search /undo /export /tools /plugins /mcp /config /exit）
+│       └── index.ts                # CommandRegistry + 26个命令（/help /about /provider /model /clear /compact /plan /session /system /context /status /search /undo /export /copy /cost /init /skill /tools /plugins /mcp /config /checkpoint /review /commands /exit）
+│   ├── custom-commands.ts          # CustomCommandManager（~/.aicli/commands/*.md 用户自定义命令）
+├── skills/
+│   ├── types.ts                    # Skill/SkillMeta 接口、parseSkillFile（YAML frontmatter 解析）
+│   └── manager.ts                  # SkillManager（加载/激活/停用技能，工具白名单过滤）
 ├── mcp/
 │   ├── types.ts                    # MCP 协议类型定义（JSON-RPC、工具 schema、服务器配置）
 │   ├── client.ts                   # McpClient（单个 MCP 服务器 STDIO 连接，JSON-RPC 通信）
 │   └── manager.ts                  # McpManager（多服务器管理，工具发现与注册，MCP→Tool 转换）
 └── tools/
-    ├── types.ts                    # ToolDefinition / ToolCall / ToolResult / DangerLevel / getDangerLevel
+    ├── types.ts                    # ToolDefinition / ToolCall / ToolResult / DangerLevel / getDangerLevel / isFileWriteTool
     ├── registry.ts                 # ToolRegistry（注册全部内置工具，共15个）
-    ├── executor.ts                 # ToolExecutor（确认逻辑 + printToolCall/printToolResult）
+    ├── hooks.ts                    # 工具执行钩子（runHook，shell 命令模板替换 + execSync）
+    ├── permissions.ts              # 基于规则的工具权限控制（checkPermission，首匹配规则）
+    ├── executor.ts                 # ToolExecutor（确认逻辑 + 批量文件写入预览 + batchConfirm + hooks + permissions）
     └── builtin/
         ├── bash.ts                 # bash 工具（Windows: PowerShell + Buffer→UTF-8；Unix: $SHELL）
         ├── read-file.ts            # read_file 工具
@@ -63,7 +69,8 @@ src/
         ├── ask-user.ts             # ask_user 工具（agentic 循环中向用户提问，等待文本回答）
         ├── write-todos.ts          # write_todos 工具（任务拆解与进度跟踪，终端实时渲染）
         ├── google-search.ts        # google_search 工具（Google Custom Search API 搜索网页）
-        └── spawn-agent.ts          # spawn_agent 工具（独立子代理 agentic 循环 + SubAgentExecutor）
+        ├── spawn-agent.ts          # spawn_agent 工具（独立子代理 agentic 循环 + SubAgentExecutor）
+        └── run-tests.ts            # run_tests 工具（自动检测项目类型、运行测试、JUnit XML 解析、结构化报告）
 ```
 
 ## 常用命令
@@ -207,6 +214,7 @@ AICLI_NO_STREAM          设为 1 禁用流式输出
 | `write_todos` | safe | AI 拆解复杂任务为子任务列表，终端实时渲染进度（pending/in_progress/completed） |
 | `google_search` | safe | Google Custom Search API 搜索网页，需配置 API Key + Search Engine ID (cx) |
 | `spawn_agent` | safe | 委派独立子代理执行特定任务（隔离对话 + agentic 循环，write 自动确认，destructive 阻止） |
+| `run_tests` | safe | 运行项目测试（自动检测 Maven/Gradle/npm/pytest/cargo/go），JUnit XML 解析，结构化报告 |
 | `mcp__*` | safe | MCP 服务器暴露的动态工具（命名格式：`mcp__<serverId>__<toolName>`） |
 
 ### 危险级别与确认机制
@@ -312,29 +320,216 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 - [x] **Plan Mode 规划模式**（2026-02-25）：`/plan` 进入只读规划（AI 只能用只读工具白名单），提示符显示 `[PLAN]` 黄色标记，`/plan execute` 切回正常模式，`/plan exit` 放弃计划。
 - [x] **Sub-agents 系统**（2026-02-27）：`spawn_agent` 工具在同进程中运行独立 agentic 循环。子代理拥有隔离对话、过滤后的工具集（SUBAGENT_ALLOWED_TOOLS）、自动确认 write 操作、阻止 destructive 操作。SubAgentExecutor 带前缀终端输出。
 
-### P1 — 重要差距
-- [ ] **Agent Skills 系统**：可复用的专业技能包（`.aicli/skills/`）
-- [ ] **`/init` 项目初始化**：扫描项目结构自动生成 `AICLI.md`
-- [ ] **`/copy` 剪贴板支持**：将最后回答复制到系统剪贴板
-- [ ] **多文件编辑预览**：diff preview + 批量 apply/reject
-- [ ] **Token 用量统计 `/cost`**：实时显示 input/output token 数，累计 session 用量
+### P1 — 重要差距（已全部完成 2026-02-28）
+- [x] **Agent Skills 系统**（2026-02-28）：`~/.aicli/skills/*.md` 可复用技能包，YAML frontmatter 声明 name/description/tools 白名单。`/skill list|<name>|off|reload` 命令。激活时注入 system prompt + 过滤工具集（Plan Mode 优先）。
+- [x] **`/init` 项目初始化**（2026-02-28）：扫描项目类型（Node/Rust/Python/Go/Java 等）+ 目录结构树，调用当前 AI 生成结构化 AICLI.md。已存在时需 `--force` 覆盖。
+- [x] **`/copy` 剪贴板支持**（2026-02-28）：跨平台复制最后 AI 回答到系统剪贴板（Windows: clip / macOS: pbcopy / Linux: xclip 或 xsel），无外部 npm 依赖。
+- [x] **多文件编辑预览**（2026-02-28）：`executeAll()` 重构为三组分流（safe→fileWrite→other）。文件写入 2+ 个时走 `executeBatchFileWrites()` 批量 diff 预览 + `batchConfirm()`（`[a]pprove all / [r]eject all / [1,3,5]` 选择性 approve）。
+- [x] **Token 用量统计 `/cost`**（2026-02-28）：显示 session 累计 input/output/total tokens + provider/model/消息数。`/cost reset` 重置计数器。
 
 ### P2 — 增强功能
-- [ ] **Hooks 系统**：pre/post tool execution hooks
-- [ ] **Permission Rules**：基于规则的工具权限控制
-- [ ] **Checkpointing**：会话检查点，可回退到任意历史点
-- [ ] **`/review` 代码审查**：集成 git diff，输出结构化审查意见
-- [ ] **Custom Commands**：用户自定义 REPL 命令（`~/.aicli/commands/`）
+- [x] **Hooks 系统**（2026-02-28）：pre/post tool execution shell 命令钩子（`config.hooks`），模板变量 `{tool}/{dangerLevel}/{args}/{status}`
+- [x] **Permission Rules**（2026-02-28）：基于规则的工具权限控制（`config.permissionRules`），auto-approve/deny/confirm，首匹配规则
+- [x] **Checkpointing**（2026-02-28）：`/checkpoint save/restore/list/delete`，检查点元数据随 session JSON 持久化
+- [x] **`/review` 代码审查**（2026-02-28）：读取 git diff + 上下文，AI 生成结构化审查意见（`--staged`/`--detailed`）
+- [x] **Custom Commands**（2026-02-28）：`~/.aicli/commands/*.md` 用户自定义命令，YAML frontmatter + `{{input}}/{{git-diff}}/{{git-context}}/{{file:path}}` 模板变量
 
 ## 已知待改进项
 
 ### 低优先级
 - [ ] **macOS/Linux 完整测试**：跨平台逻辑已处理（`$SHELL` fallback、UTF-8 env vars），但尚未在非 Windows 环境实际运行验证。
-- [ ] **Token 用量显示**：`ui.showTokenCount` 配置字段已有，但终端展示逻辑未完整实现。
+- [x] **Token 用量显示**：已通过 `/cost` 命令实现（v0.1.23），显示 session 累计 input/output/total tokens。
 - [ ] **GitHub 仓库迁移**：当前在 gitee，npm 包受众需要 GitHub 托管。
-- [ ] **web_fetch DNS 解析时 SSRF 防护**：当前只检查 URL hostname 字符串，若 hostname 是域名（非裸 IP）则未检查其解析后的 IP 是否为私有地址。需在发起请求后对实际连接 IP 做二次校验（复杂，低频风险）。
+- [x] **web_fetch DNS 解析时 SSRF 防护**（v0.1.25）：新增 `resolveAndCheck()` 函数，用 `dns.promises.lookup()` 预解析域名，检查结果 IP 是否为私有地址。初始 URL 和 redirect 目标均校验。
 - [ ] **`persistentCwd` 全局状态**：bash 工具的当前工作目录是模块级全局变量，多 session 并发时可能串扰。现阶段单 session REPL 无影响，GUI 多会话扩展时需重构为 per-session 状态。
 
+## 本轮开发完成记录（2026-03-01，v0.1.25 → v0.1.26）
+
+### 新增功能：Context 自动管理 + 测试报告 + 脚手架
+
+**功能 1：Context 自动管理**
+- `src/core/constants.ts`：新增 `CONTEXT_PRESSURE_THRESHOLD`(0.8) / `CONTEXT_WARNING_THRESHOLD`(0.6)
+- `src/config/schema.ts`：新增 `autoCompact: z.boolean().default(true)` 配置项
+- `src/repl/repl.ts`：新增 `estimateTokens()`（字符估算 token）、`estimateConversationTokens()`（system prompt + messages 总估算）、`getContextWindowSize()`、`checkContextPressure()`（超 80% 自动 compact）
+- 在 `handleChatSimple()` 和 `handleChatWithTools()` 末尾自动调用 `checkContextPressure()`
+- `/status` 命令新增 `Context%` 行：显示估算 token / context window（绿色 <60%，黄色 60-80%，红色 >80%）
+
+**功能 2：`run_tests` 工具 + `/test` 命令**
+- 新增 `src/tools/builtin/run-tests.ts`：
+  - 自动检测项目类型：Maven → `mvn test`、Gradle → `gradle test`、npm → `npm test`、pytest、cargo、go test
+  - JUnit XML 解析：扫描 `target/surefire-reports/*.xml`，提取 testsuite 属性 + 失败用例详情
+  - 通用文本解析：正则匹配 Maven/Jest/pytest/cargo/go 格式的测试结果摘要
+  - 彩色终端报告（直接 `console.log()`，绕过 executor 截断）
+  - 返回 Markdown 结构化报告给 AI
+  - 支持 `command`（自定义命令）和 `filter`（测试名过滤）参数
+- `src/tools/registry.ts`：注册 `runTestsTool`
+- `src/tools/types.ts`：`getDangerLevel()` 中 `run_tests` → `safe`
+- `src/core/constants.ts`：`SUBAGENT_ALLOWED_TOOLS` 新增 `run_tests`，新增 `TEST_TIMEOUT = 300_000`
+- `/test` REPL 命令：快捷方式调用 `executeTests()`
+
+**功能 3：`/scaffold` 脚手架命令**
+- `src/repl/commands/index.ts`：新增 `/scaffold <description>` 命令
+- 构建结构化 prompt → 通过 `ctx.sendAsChat()` 注入为用户消息 → AI 使用现有工具（bash/write_file/spawn_agent）自动创建项目骨架
+- `src/repl/repl.ts`：新增 `sendAsChat(message)` 方法——添加 user message + 触发 handleChatWithTools
+- CommandContext 新增 `estimateConversationTokens`、`getContextWindowSize`、`sendAsChat` 三个回调
+
+**版本与收尾**
+- `src/core/constants.ts`：VERSION `0.1.25` → `0.1.26`
+- `package.json`：version 同步
+- `src/repl/renderer.ts`：/about 工具计数 15→16，命令计数 26→28，新增 3 条特性（Context 管理、run_tests、/scaffold）
+
+---
+
+## 本轮开发完成记录（2026-02-28，v0.1.24 → v0.1.25）
+
+### 新增功能：Tab 自动补全 + 流式 Token 计数
+
+**功能 1：Tab 自动补全**
+- `src/repl/repl.ts`：`readline.createInterface` 注入 `completer` 回调
+- 新增 `completeInput(line)` 方法：根据输入上下文分发补全逻辑
+  - 命令名补全：`/pro<TAB>` → `/provider`（内置 + 自定义命令）
+  - 子命令参数：`/provider <TAB>` → provider 列表；`/model <TAB>` → 模型列表；`/checkpoint <TAB>` → save/restore/list/delete 等
+  - `@` 文件路径补全：`@src/re<TAB>` → `@src/repl/`（递进目录补全，跳过隐藏文件）
+- 新增 `completeFilePath(partial)` 辅助方法：`readdirSync` + `statSync` 扫描目录，目录追加 `/` 后缀
+
+**功能 2：流式 Token 计数（内联显示）**
+- `src/repl/renderer.ts`：`renderStream()` 签名扩展 `showTokens?` + `sessionTotal?`
+  - 流结束后在 `\n\n` 之前立即内联显示 token 计数
+  - 有精确 usage（OpenAI/Gemini）→ 显示完整 `📊 in X + out Y = Z tokens │ session total: N`
+  - 无精确 usage（Claude streaming）→ 基于字符数估算 `📊 ~X output tokens (estimated)`
+  - 返回值新增 `tokensShown: boolean` 标志，防止 REPL 重复调用 `renderUsage()`
+- `src/repl/repl.ts`：`handleChatSimple()` + tee 流式路径传入 `showTokens`/`sessionTotal`，条件跳过后续 `renderUsage()`
+
+**Bug 修复：DeepSeek contextWindow**
+- `src/providers/deepseek.ts`：`deepseek-chat`（V3）contextWindow 65536 → 131072（128K），与官方 API 文档一致。`deepseek-reasoner`（R1）保持 65536（64K）。
+
+**安全加固：web_fetch DNS SSRF 二次校验**
+- `src/tools/builtin/web-fetch.ts`：新增 `resolveAndCheck()` 函数，用 `dns.promises.lookup()` 预解析域名
+  - 域名解析到私有 IP（RFC1918/loopback/link-local）时阻断请求
+  - 初始 URL 和 redirect 目标均校验
+  - IP 字面量跳过 DNS 解析（已由 `isPrivateHost()` 覆盖）
+  - DNS 解析失败不拦截，让后续 fetch 自然报错
+
+**版本与收尾**
+- `src/core/constants.ts`：VERSION `0.1.24` → `0.1.25`
+- `package.json`：version 同步
+- `src/repl/renderer.ts`：/about 新增 2 条特性条目
+
+---
+
+## 本轮开发完成记录（2026-02-28，v0.1.22 → v0.1.23）
+
+### P1 全部 5 个功能实现
+
+**背景**：P0 全部完成后，进入 P1 重要差距功能开发。一次性实现全部 5 项。
+
+### 功能 1：`/copy` 剪贴板支持
+
+**实现**：`src/repl/commands/index.ts`
+- `copyToClipboard()` 辅助函数：跨平台调用原生命令（Windows: `clip` / macOS: `pbcopy` / Linux: `xclip -selection clipboard`，fallback `xsel --clipboard --input`）
+- 通过 `execSync` 管道写入，无外部 npm 依赖
+- `CommandContext` 新增 `getLastResponse: () => string`
+- `repl.ts` ctx 注入：`getLastResponse: () => lastResponseStore.content`
+
+### 功能 2：`/cost` Token 用量统计
+
+**实现**：`src/repl/commands/index.ts`
+- 显示 session 累计 input/output/total tokens + provider/model/消息数
+- `/cost reset` 重置计数器
+- 使用已有 `ctx.getSessionTokenUsage()` 和 `ctx.resetSessionTokenUsage()`
+
+### 功能 3：`/init` 项目初始化
+
+**实现**：`src/repl/commands/index.ts`
+- `SCAN_SKIP_DIRS` Set（node_modules、.git、dist 等 20+ 目录）
+- `ProjectInfo` 接口 + `scanDirTree()` 递归目录树（深度 4，每层 30 项）
+- `scanProject()` 检测项目类型（package.json/Cargo.toml/pyproject.toml/go.mod 等）
+- `buildInitPrompt()` 构造 AI 提示词，要求生成结构化 AICLI.md
+- `CommandContext` 新增 `chatOnce(prompt, options?)` 方法
+- `repl.ts` ctx 实现：调用 provider.chat() 非流式，temperature=0.3
+- 已存在 AICLI.md 时需 `/init --force` 覆盖
+
+### 功能 4：Agent Skills 系统
+
+**新文件**：
+- `src/skills/types.ts`：`SkillMeta`（name/description/tools?）、`Skill`（meta/content/filePath）接口；`parseSimpleYaml()`（regex key:value）、`parseYamlArray()`（`[a, b, c]` 格式）、`parseSkillFile()`（读取 .md → 提取 YAML frontmatter → 返回 Skill）
+- `src/skills/manager.ts`：`SkillManager` 类——`loadSkills()`（扫描 skillsDir，自动创建目录）、`activate(name)` / `deactivate()`、`getActivePromptContent()` / `getActiveToolFilter()`（返回工具名 Set）
+
+**集成**（`src/repl/repl.ts`）：
+- `private skillManager: SkillManager | null` 字段
+- `start()` 中初始化 SkillManager、加载技能、显示数量
+- `buildCurrentSystemPrompt()` 注入激活技能的 content（在项目上下文之后，plan mode 之前）
+- `handleChatWithTools()` 工具过滤：Plan Mode > Skill 白名单 > 全部工具
+- `refreshPrompt()` 显示 `[skill:name]` 洋红色标记
+
+**命令**（`/skill`）：
+- `/skill` 或 `/skill list`：列出所有技能
+- `/skill <name>`：激活指定技能
+- `/skill off`：停用当前技能
+- `/skill reload`：重新扫描技能目录
+
+**常量**：`src/core/constants.ts` 新增 `SKILLS_DIR_NAME = 'skills'`
+
+### 功能 5：多文件编辑预览（批量确认）
+
+**修改**：
+- `src/tools/types.ts`：新增 `isFileWriteTool(name)` 判断 write_file / edit_file
+- `src/tools/executor.ts`：`executeAll()` 重构为三组分流：
+  1. `safeCalls`（safe 级别）→ 先执行（保证 mkdir 等前置操作完成）
+  2. `fileWriteCalls`（isFileWriteTool && write）→ 单个走原有确认，2+ 个走批量
+  3. `otherCalls`（剩余 write/destructive）→ 逐个原有确认流程
+- 新增 `executeBatchFileWrites(calls)`：展示编号列表 + diff 预览 → `batchConfirm()`
+- 新增 `batchConfirm(count)`：`[a]pprove all / [r]eject all / [1,3,5] approve specific`
+  - 使用 `rl.once('line')` 读整行（与 `confirm()` 模式一致）
+  - 解析逗号分隔数字编号，返回 `'all' | 'none' | Set<number>`
+  - 支持 Ctrl+C 取消（复用 `cancelConfirmFn`）
+
+### 架构变更
+- `src/repl/commands/index.ts`：CommandContext 新增 `getLastResponse` / `chatOnce` / `refreshPrompt` / `getSkillManager`；新增 /copy /cost /init /skill 共 4 个命令；/help 更新
+- `src/repl/repl.ts`：SkillManager 集成 + 4 个新 ctx 方法
+- `src/repl/renderer.ts`：`/about` REPL 命令 19 → 23，新增 3 条特性（Agent Skills / /init / 多文件编辑预览）
+
+### 版本与发布
+- `src/core/constants.ts`：VERSION `0.1.22` → `0.1.23`
+- `package.json`：version `0.1.22` → `0.1.23`
+
+---
+
+## 本轮开发完成记录（2026-02-28，v0.1.23 → v0.1.24）
+
+### P2 全部 5 功能实现
+
+**功能 1：Hooks 系统（pre/post tool execution）**
+- 新增 `src/tools/hooks.ts`：`ToolHookConfig` 接口 + `runHook(template, vars)` 函数（模板变量替换 → execSync 5s 超时，失败 stderr 警告）
+- `src/config/schema.ts`：新增 `hooks` 可选字段（`preToolExecution`/`postToolExecution`）
+- `src/tools/executor.ts`：新增 `setConfig()` 方法；`execute()` 中 getDangerLevel 后调 pre hook，工具完成/失败后调 post hook
+
+**功能 2：Permission Rules（基于规则的工具权限）**
+- 新增 `src/tools/permissions.ts`：`PermissionRule` 接口 + `checkPermission()` 纯函数（首匹配规则，tool 支持 `*` 通配，when 条件含 dangerLevel/pathPattern）
+- `src/config/schema.ts`：新增 `permissionRules` 数组 + `defaultPermission`（默认 `confirm`）
+- `src/tools/executor.ts`：execute() 中 getDangerLevel 后调 checkPermission → deny 直接拒绝 / auto-approve 跳过 confirm / confirm 走原有流程
+
+**功能 3：Checkpointing（会话检查点）**
+- `src/session/session.ts`：新增 `CheckpointMeta` 接口（name/messageIndex/timestamp）、`checkpoints` 数组、4 个方法（createCheckpoint/restoreCheckpoint/listCheckpoints/deleteCheckpoint）、toJSON/fromJSON 更新
+- `src/repl/commands/index.ts`：新增 `/checkpoint` 命令（save/restore/list/delete 子命令）
+
+**功能 4：`/review` 代码审查**
+- `src/repl/commands/index.ts`：新增 `buildReviewPrompt()` 辅助函数（中文结构化审查 prompt）+ `/review` 命令（`--staged`/`--detailed`，diff 超 8000 字截断保头尾）
+
+**功能 5：Custom Commands（用户自定义命令）**
+- 新增 `src/repl/custom-commands.ts`：`CustomCommandManager` 类（loadCommands/listCommands/getCommand）+ `expandTemplate()` 模板变量展开（`{{input}}/{{file:path}}/{{git-diff}}/{{git-context}}`）
+- `src/core/constants.ts`：新增 `CUSTOM_COMMANDS_DIR_NAME = 'commands'`
+- `src/repl/repl.ts`：CustomCommandManager 集成（初始化 + handleCommand fallback + ctx 方法）
+- `src/repl/commands/index.ts`：新增 `/commands` 命令（list/reload）
+
+**版本与收尾**
+- `src/core/constants.ts`：VERSION `0.1.23` → `0.1.24`
+- `package.json`：version 同步
+- `src/repl/renderer.ts`：/about 命令计数 23 → 26，新增 5 条 P2 特性条目
+- 所有 P2 路线图条目标记为已完成
+
+---
+
 ## 本轮开发完成记录（2026-02-27，v0.1.21 → v0.1.22）
 
 ### 新增功能：Sub-Agent 子代理系统（`spawn_agent` 工具）

package/dist/chunk-BE5SYJ2G.js

@@ -0,0 +1,382 @@
+#!/usr/bin/env node
+
+// src/tools/builtin/run-tests.ts
+import { execSync } from "child_process";
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join } from "path";
+import { platform } from "os";
+import chalk from "chalk";
+
+// src/core/constants.ts
+var VERSION = "0.1.26";
+var APP_NAME = "ai-cli";
+var CONFIG_DIR_NAME = ".aicli";
+var CONFIG_FILE_NAME = "config.json";
+var HISTORY_DIR_NAME = "history";
+var PLUGINS_DIR_NAME = "plugins";
+var SKILLS_DIR_NAME = "skills";
+var CUSTOM_COMMANDS_DIR_NAME = "commands";
+var CONTEXT_FILE_CANDIDATES = ["AICLI.md", "CLAUDE.md"];
+var MEMORY_FILE_NAME = "memory.md";
+var MEMORY_MAX_CHARS = 1e4;
+var DEV_STATE_FILE_NAME = "dev-state.md";
+var DEFAULT_MAX_TOKENS = 8192;
+var MCP_TOOL_PREFIX = "mcp__";
+var MCP_CONNECT_TIMEOUT = 3e4;
+var MCP_CALL_TIMEOUT = 6e4;
+var MCP_PROTOCOL_VERSION = "2024-11-05";
+var PLAN_MODE_READONLY_TOOLS = /* @__PURE__ */ new Set([
+  "read_file",
+  "list_dir",
+  "grep_files",
+  "glob_files",
+  "web_fetch",
+  "google_search",
+  "ask_user",
+  // 允许：可向用户澄清需求
+  "write_todos"
+  // 允许：可输出任务列表作为实施计划
+]);
+var PLAN_MODE_SYSTEM_ADDON = `# \u{1F50D} Plan Mode \u2014 \u53EA\u8BFB\u89C4\u5212\u6A21\u5F0F
+
+\u4F60\u5F53\u524D\u5904\u4E8E\u53EA\u8BFB\u89C4\u5212\uFF08Plan\uFF09\u6A21\u5F0F\u3002
+
+**\u5141\u8BB8\u7684\u5DE5\u5177**\uFF1Aread_file \xB7 list_dir \xB7 grep_files \xB7 glob_files \xB7 web_fetch \xB7 google_search \xB7 ask_user \xB7 write_todos
+**\u7981\u7528\u7684\u5DE5\u5177**\uFF1Abash \xB7 write_file \xB7 edit_file \xB7 run_interactive \xB7 save_last_response \xB7 save_memory \u53CA\u6240\u6709 MCP \u5DE5\u5177
+
+**\u4F60\u7684\u4EFB\u52A1**\uFF1A
+1. \u4F7F\u7528\u53EA\u8BFB\u5DE5\u5177\u5168\u9762\u5206\u6790\u4EE3\u7801\u5E93\u3001\u6587\u4EF6\u7ED3\u6784\u548C\u73B0\u6709\u5B9E\u73B0
+2. \u4F7F\u7528 ask_user \u5411\u7528\u6237\u6F84\u6E05\u4E0D\u660E\u786E\u7684\u9700\u6C42
+3. \u5236\u5B9A\u8BE6\u7EC6\u7684\u5B9E\u65BD\u8BA1\u5212\uFF08\u53EF\u7528 write_todos \u5C55\u793A\u4EFB\u52A1\u5217\u8868\uFF09\uFF0C\u5305\u542B\uFF1A
+   - \u9700\u8981\u4FEE\u6539\u6216\u521B\u5EFA\u7684\u6587\u4EF6\u5217\u8868
+   - \u6BCF\u4E2A\u6587\u4EF6\u7684\u5177\u4F53\u6539\u52A8\u5185\u5BB9
+   - \u6267\u884C\u987A\u5E8F\u548C\u4F9D\u8D56\u5173\u7CFB
+   - \u6F5C\u5728\u98CE\u9669\u548C\u6CE8\u610F\u4E8B\u9879
+
+\u5B8C\u6210\u89C4\u5212\u540E\uFF0C\u8BF7\u660E\u786E\u544A\u77E5\u7528\u6237\uFF1A\u8F93\u5165 \`/plan execute\` \u5F00\u59CB\u6267\u884C\u8BA1\u5212\uFF0C\u6216 \`/plan exit\` \u653E\u5F03\u6B64\u8BA1\u5212\u3002`;
+var SUBAGENT_DEFAULT_MAX_ROUNDS = 10;
+var SUBAGENT_MAX_ROUNDS_LIMIT = 15;
+var SUBAGENT_ALLOWED_TOOLS = /* @__PURE__ */ new Set([
+  "bash",
+  "read_file",
+  "write_file",
+  "edit_file",
+  "list_dir",
+  "grep_files",
+  "glob_files",
+  "run_interactive",
+  "web_fetch",
+  "google_search",
+  "write_todos",
+  "run_tests"
+]);
+var CONTEXT_PRESSURE_THRESHOLD = 0.8;
+var TEST_TIMEOUT = 3e5;
+var AUTHOR = "\u664B\u6B63\u4E1C";
+var AUTHOR_EMAIL = "zhengdong.jin@gmail.com";
+var DESCRIPTION = "\u8DE8\u5E73\u53F0 REPL \u98CE\u683C AI \u5BF9\u8BDD\u5DE5\u5177\uFF0C\u652F\u6301\u591A Provider \u4E0E Agentic \u5DE5\u5177\u8C03\u7528";
+
+// src/tools/builtin/run-tests.ts
+var IS_WINDOWS = platform() === "win32";
+function detectProject(cwd) {
+  if (existsSync(join(cwd, "pom.xml"))) {
+    return { type: "java", framework: "Maven (JUnit)", command: IS_WINDOWS ? "mvn.cmd test" : "mvn test" };
+  }
+  if (existsSync(join(cwd, "build.gradle")) || existsSync(join(cwd, "build.gradle.kts"))) {
+    const wrapper = IS_WINDOWS ? "gradlew.bat" : "./gradlew";
+    const cmd = existsSync(join(cwd, IS_WINDOWS ? "gradlew.bat" : "gradlew")) ? `${wrapper} test` : "gradle test";
+    return { type: "java", framework: "Gradle (JUnit)", command: cmd };
+  }
+  if (existsSync(join(cwd, "package.json"))) {
+    try {
+      const pkg = JSON.parse(readFileSync(join(cwd, "package.json"), "utf-8"));
+      const testScript = pkg?.scripts?.test;
+      if (testScript && testScript !== 'echo "Error: no test specified" && exit 1') {
+        return { type: "node", framework: "npm", command: "npm test" };
+      }
+    } catch {
+    }
+  }
+  if (existsSync(join(cwd, "pyproject.toml")) || existsSync(join(cwd, "setup.py")) || existsSync(join(cwd, "pytest.ini"))) {
+    return { type: "python", framework: "pytest", command: "pytest -v" };
+  }
+  if (existsSync(join(cwd, "Cargo.toml"))) {
+    return { type: "rust", framework: "cargo", command: "cargo test" };
+  }
+  if (existsSync(join(cwd, "go.mod"))) {
+    return { type: "go", framework: "go test", command: "go test ./..." };
+  }
+  return null;
+}
+function parseJUnitXml(xmlContent) {
+  const summary = { tests: 0, passed: 0, failures: 0, errors: 0, skipped: 0, duration: 0, failedTests: [] };
+  const suiteMatch = xmlContent.match(/<testsuite[^>]*\btests="(\d+)"[^>]*/);
+  if (suiteMatch) {
+    summary.tests = parseInt(suiteMatch[1], 10);
+    const failMatch = xmlContent.match(/<testsuite[^>]*\bfailures="(\d+)"/);
+    const errMatch = xmlContent.match(/<testsuite[^>]*\berrors="(\d+)"/);
+    const skipMatch = xmlContent.match(/<testsuite[^>]*\bskipped="(\d+)"/);
+    const timeMatch = xmlContent.match(/<testsuite[^>]*\btime="([^"]*)"/);
+    summary.failures = failMatch ? parseInt(failMatch[1], 10) : 0;
+    summary.errors = errMatch ? parseInt(errMatch[1], 10) : 0;
+    summary.skipped = skipMatch ? parseInt(skipMatch[1], 10) : 0;
+    summary.duration = timeMatch ? parseFloat(timeMatch[1]) : 0;
+    summary.passed = summary.tests - summary.failures - summary.errors - summary.skipped;
+  }
+  const tcPattern = /<testcase[^>]*\bname="([^"]*)"[^>]*classname="([^"]*)"[^>]*>[\s\S]*?<(failure|error)[^>]*>([^<]*)/g;
+  let m;
+  while ((m = tcPattern.exec(xmlContent)) !== null) {
+    summary.failedTests.push({
+      name: `${m[2]}#${m[1]}`,
+      message: m[4].trim().slice(0, 200)
+    });
+  }
+  return summary;
+}
+function findJUnitReports(cwd) {
+  const dirs = [
+    join(cwd, "target", "surefire-reports"),
+    // Maven
+    join(cwd, "build", "test-results", "test"),
+    // Gradle
+    join(cwd, "build", "test-results")
+    // Gradle (older)
+  ];
+  const xmlFiles = [];
+  for (const dir of dirs) {
+    if (!existsSync(dir)) continue;
+    try {
+      const files = readdirSync(dir);
+      for (const f of files) {
+        if (f.endsWith(".xml")) xmlFiles.push(join(dir, f));
+      }
+    } catch {
+    }
+  }
+  return xmlFiles;
+}
+function parseGenericOutput(output) {
+  const mvn = output.match(/Tests run:\s*(\d+),\s*Failures:\s*(\d+),\s*Errors:\s*(\d+),\s*Skipped:\s*(\d+)/);
+  if (mvn) {
+    const [, tests, failures, errors, skipped] = mvn.map(Number);
+    return { tests, failures, errors, skipped, passed: tests - failures - errors - skipped };
+  }
+  const jest = output.match(/Tests:\s+(?:(\d+)\s+passed,?\s*)?(?:(\d+)\s+failed,?\s*)?(?:(\d+)\s+skipped,?\s*)?(\d+)\s+total/);
+  if (jest) {
+    const passed = parseInt(jest[1] ?? "0", 10);
+    const failures = parseInt(jest[2] ?? "0", 10);
+    const skipped = parseInt(jest[3] ?? "0", 10);
+    const tests = parseInt(jest[4], 10);
+    return { tests, passed, failures, skipped, errors: 0 };
+  }
+  const pytest = output.match(/(\d+)\s+passed(?:.*?(\d+)\s+failed)?(?:.*?(\d+)\s+error)?/);
+  if (pytest) {
+    const passed = parseInt(pytest[1], 10);
+    const failures = parseInt(pytest[2] ?? "0", 10);
+    const errors = parseInt(pytest[3] ?? "0", 10);
+    return { tests: passed + failures + errors, passed, failures, errors, skipped: 0 };
+  }
+  const cargo = output.match(/test result:.*?(\d+)\s+passed;\s*(\d+)\s+failed;\s*(\d+)\s+ignored/);
+  if (cargo) {
+    const passed = parseInt(cargo[1], 10);
+    const failures = parseInt(cargo[2], 10);
+    const skipped = parseInt(cargo[3], 10);
+    return { tests: passed + failures + skipped, passed, failures, skipped, errors: 0 };
+  }
+  const goPass = (output.match(/^ok\s/gm) ?? []).length;
+  const goFail = (output.match(/^FAIL\s/gm) ?? []).length;
+  if (goPass + goFail > 0) {
+    return { tests: goPass + goFail, passed: goPass, failures: goFail, errors: 0, skipped: 0 };
+  }
+  return null;
+}
+function formatReport(summary, framework, output, exitCode) {
+  const status = summary.failures + summary.errors > 0 ? "FAILED \u2717" : "PASSED \u2713";
+  const lines = [];
+  lines.push(`## Test Results \u2014 ${status}`);
+  lines.push(`**Total: ${summary.tests} | Passed: ${summary.passed} | Failed: ${summary.failures}${summary.errors > 0 ? ` | Errors: ${summary.errors}` : ""} | Skipped: ${summary.skipped}**`);
+  if (summary.duration > 0) {
+    lines.push(`Duration: ${summary.duration.toFixed(1)}s | Framework: ${framework}`);
+  } else {
+    lines.push(`Framework: ${framework}`);
+  }
+  if (summary.failedTests.length > 0) {
+    lines.push("");
+    lines.push("### Failed Tests");
+    for (const ft of summary.failedTests) {
+      lines.push(`- ${ft.name} \u2014 ${ft.message}`);
+    }
+  }
+  const outputLines = output.split("\n");
+  const tail = outputLines.length > 150 ? outputLines.slice(-150) : outputLines;
+  lines.push("");
+  lines.push(`### Output (last ${tail.length} lines)`);
+  lines.push("```");
+  lines.push(tail.join("\n"));
+  lines.push("```");
+  return lines.join("\n");
+}
+function renderColorReport(summary, framework) {
+  const isPass = summary.failures + summary.errors === 0;
+  const status = isPass ? chalk.green.bold("PASSED \u2713") : chalk.red.bold("FAILED \u2717");
+  console.log();
+  console.log(`  ${chalk.bold("Test Results")} \u2014 ${status}`);
+  console.log(
+    `  Total: ${chalk.bold(String(summary.tests))} | ${chalk.green(`Passed: ${summary.passed}`)} | ${chalk.red(`Failed: ${summary.failures}`)}` + (summary.errors > 0 ? ` | ${chalk.red(`Errors: ${summary.errors}`)}` : "") + ` | ${chalk.yellow(`Skipped: ${summary.skipped}`)}`
+  );
+  if (summary.duration > 0) {
+    console.log(`  Duration: ${summary.duration.toFixed(1)}s | Framework: ${framework}`);
+  }
+  if (summary.failedTests.length > 0) {
+    console.log(chalk.red("\n  Failed Tests:"));
+    for (const ft of summary.failedTests) {
+      console.log(chalk.red(`    - ${ft.name}`));
+      if (ft.message) console.log(chalk.dim(`      ${ft.message}`));
+    }
+  }
+  console.log();
+}
+async function executeTests(args) {
+  const cwd = process.cwd();
+  const customCmd = args["command"] ? String(args["command"]).trim() : "";
+  const filter = args["filter"] ? String(args["filter"]).trim() : "";
+  let command;
+  let framework;
+  if (customCmd) {
+    command = customCmd;
+    framework = "custom";
+  } else {
+    const detected = detectProject(cwd);
+    if (!detected) {
+      return "Error: Could not detect project type. No pom.xml, build.gradle, package.json, pyproject.toml, Cargo.toml, or go.mod found.\nPlease specify a test command using the `command` parameter.";
+    }
+    command = detected.command;
+    framework = detected.framework;
+    if (filter) {
+      if (detected.type === "java" && command.includes("mvn")) {
+        command += ` -Dtest="${filter}"`;
+      } else if (detected.type === "python") {
+        command += ` -k "${filter}"`;
+      } else if (detected.type === "rust") {
+        command += ` ${filter}`;
+      } else if (detected.type === "go") {
+        command = `go test ./... -run "${filter}"`;
+      } else if (detected.type === "node") {
+        command += ` -- --grep "${filter}"`;
+      }
+    }
+  }
+  let output;
+  let exitCode = 0;
+  try {
+    const buf = execSync(command, {
+      cwd,
+      timeout: TEST_TIMEOUT,
+      encoding: "buffer",
+      stdio: ["pipe", "pipe", "pipe"],
+      env: {
+        ...process.env,
+        ...IS_WINDOWS ? {} : { FORCE_COLOR: "0" }
+      }
+    });
+    output = buf.toString("utf-8");
+  } catch (err) {
+    const e = err;
+    exitCode = e.status ?? 1;
+    const stdout = e.stdout?.toString("utf-8") ?? "";
+    const stderr = e.stderr?.toString("utf-8") ?? "";
+    output = stdout + (stderr ? "\n" + stderr : "");
+  }
+  let summary = {
+    tests: 0,
+    passed: 0,
+    failures: 0,
+    errors: 0,
+    skipped: 0,
+    duration: 0,
+    failedTests: []
+  };
+  const xmlFiles = findJUnitReports(cwd);
+  if (xmlFiles.length > 0) {
+    for (const xmlFile of xmlFiles) {
+      try {
+        const xml = readFileSync(xmlFile, "utf-8");
+        const parsed = parseJUnitXml(xml);
+        summary.tests += parsed.tests;
+        summary.passed += parsed.passed;
+        summary.failures += parsed.failures;
+        summary.errors += parsed.errors;
+        summary.skipped += parsed.skipped;
+        summary.duration += parsed.duration;
+        summary.failedTests.push(...parsed.failedTests);
+      } catch {
+      }
+    }
+  } else {
+    const parsed = parseGenericOutput(output);
+    if (parsed) {
+      summary = { ...summary, ...parsed };
+    } else {
+      summary.tests = 1;
+      if (exitCode === 0) {
+        summary.passed = 1;
+      } else {
+        summary.failures = 1;
+      }
+    }
+  }
+  renderColorReport(summary, framework);
+  return formatReport(summary, framework, output, exitCode);
+}
+var runTestsTool = {
+  definition: {
+    name: "run_tests",
+    description: "Run project tests and return a structured report. Auto-detects project type (Maven/Gradle/npm/pytest/cargo/go). Returns test counts (passed/failed/skipped) and failed test details.",
+    parameters: {
+      command: {
+        type: "string",
+        description: "Optional: custom test command to run (overrides auto-detection)",
+        required: false
+      },
+      filter: {
+        type: "string",
+        description: 'Optional: test name filter/pattern (e.g., "ExamService" to run only matching tests)',
+        required: false
+      }
+    }
+  },
+  async execute(args) {
+    return executeTests(args);
+  }
+};
+
+export {
+  VERSION,
+  APP_NAME,
+  CONFIG_DIR_NAME,
+  CONFIG_FILE_NAME,
+  HISTORY_DIR_NAME,
+  PLUGINS_DIR_NAME,
+  SKILLS_DIR_NAME,
+  CUSTOM_COMMANDS_DIR_NAME,
+  CONTEXT_FILE_CANDIDATES,
+  MEMORY_FILE_NAME,
+  MEMORY_MAX_CHARS,
+  DEV_STATE_FILE_NAME,
+  DEFAULT_MAX_TOKENS,
+  MCP_TOOL_PREFIX,
+  MCP_CONNECT_TIMEOUT,
+  MCP_CALL_TIMEOUT,
+  MCP_PROTOCOL_VERSION,
+  PLAN_MODE_READONLY_TOOLS,
+  PLAN_MODE_SYSTEM_ADDON,
+  SUBAGENT_DEFAULT_MAX_ROUNDS,
+  SUBAGENT_MAX_ROUNDS_LIMIT,
+  SUBAGENT_ALLOWED_TOOLS,
+  CONTEXT_PRESSURE_THRESHOLD,
+  AUTHOR,
+  AUTHOR_EMAIL,
+  DESCRIPTION,
+  executeTests,
+  runTestsTool
+};