jinzd-ai-cli 0.2.10 → 0.2.12

package/README.md

@@ -9,6 +9,7 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 [![Tests](https://img.shields.io/badge/tests-138%20passing-brightgreen)]()
 [![GitHub Release](https://img.shields.io/github/v/release/jinzhengdong/ai-cli)](https://github.com/jinzhengdong/ai-cli/releases)
+[![CI](https://github.com/jinzhengdong/ai-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/jinzhengdong/ai-cli/actions/workflows/ci.yml)
 
 **ai-cli** is a powerful AI assistant that connects to 7 providers and executes tasks autonomously through agentic tool calling. Use it as a terminal REPL, a browser-based Web UI, or a standalone Electron desktop app.
 
@@ -26,13 +27,15 @@
 - **Streaming Tool Use** — Real-time streaming of AI reasoning and tool calls as they happen
 - **Sub-Agents** — Delegate complex subtasks to isolated child agents with independent tool loops
 - **Extended Thinking** — Claude deep reasoning mode with `/think` toggle
-- **Plan Mode** — Read-only planning phase (`/plan`) where AI analyzes before executing
+- **Plan Mode** — Read-only planning phase (`/plan`) where AI analyzes before executing, with loop detection
+- **Auto-Pause** — Automatically pauses every 10 rounds for user review and redirection
 - **MCP Protocol** — Connect external MCP servers for dynamic tool discovery
 - **Multi-User Auth** — Web UI supports multiple users with password authentication
 - **PWA Support** — Install Web UI as a desktop/mobile app, accessible over LAN
 - **Hierarchical Context** — 3-layer context files (global / project / subdirectory) auto-injected
 - **Headless Mode** — `ai-cli -p "prompt"` for CI/CD pipelines and scripting
 - **35+ REPL Commands** — Session management, checkpointing, code review, scaffolding, and more
+- **GitHub Actions CI/CD** — Automated testing on Node 20/22 + npm publish on release tags
 - **Cross-Platform** — Windows, macOS, Linux
 
 ## Installation
@@ -125,7 +128,7 @@ AI autonomously invokes these 16 tools during conversations:
 | `bash` | varies | Execute shell commands (PowerShell on Windows, $SHELL on Unix) |
 | `read_file` | safe | Read file contents (10 MB limit, image support) |
 | `write_file` | write | Create/overwrite files (diff preview + confirmation) |
-| `edit_file` | write | Precise string replacement with fuzzy matching hints |
+| `edit_file` | write | Precise string replacement with fuzzy matching hints + `replaceAll` mode |
 | `list_dir` | safe | List directory contents |
 | `grep_files` | safe | Regex search across files |
 | `glob_files` | safe | Match files by glob pattern |
@@ -167,6 +170,8 @@ AI autonomously invokes these 16 tools during conversations:
 | `/config` | Open configuration wizard |
 | `/help` | Show all available commands |
 
+**Multi-line input**: Use `\` at end of line for continuation, or paste multi-line content directly (auto-detected and merged).
+
 See the [full command reference](USAGE.md) for all 35+ commands.
 
 ## CLI Parameters

package/README.zh-CN.md

@@ -9,6 +9,7 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 [![Tests](https://img.shields.io/badge/tests-138%20passing-brightgreen)]()
 [![GitHub Release](https://img.shields.io/github/v/release/jinzhengdong/ai-cli)](https://github.com/jinzhengdong/ai-cli/releases)
+[![CI](https://github.com/jinzhengdong/ai-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/jinzhengdong/ai-cli/actions/workflows/ci.yml)
 
 ## 特性亮点
 
@@ -18,13 +19,15 @@
 - **流式工具调用** — 实时流式展示 AI 推理过程和工具调用
 - **子代理系统** — 将复杂子任务委派给独立子代理执行
 - **深度推理** — Claude Extended Thinking，`/think` 一键切换
-- **规划模式** — `/plan` 进入只读规划，AI 先分析后执行
+- **规划模式** — `/plan` 进入只读规划，AI 先分析后执行，内置死循环检测
+- **自动暂停** — 每 10 轮自动暂停，用户可审查进度或重定向 AI
 - **MCP 协议** — 接入外部 MCP 服务器，动态发现工具
 - **多用户认证** — Web UI 支持多用户密码登录
 - **PWA 支持** — Web UI 可安装为桌面/移动应用，支持局域网访问
 - **三层级上下文** — 全局 / 项目 / 子目录上下文文件自动注入
 - **无头模式** — `aicli -p "提示词"` 用于 CI/CD 管道和脚本
 - **35+ REPL 命令** — 会话管理、检查点、代码审查、脚手架等
+- **GitHub Actions CI/CD** — Node 20/22 自动测试 + Release tag 自动发布 npm
 - **跨平台** — Windows、macOS、Linux
 
 ## 安装
@@ -117,7 +120,7 @@ AI 在对话中可自主调用 16 个工具：
 | `bash` | 动态判断 | 执行 shell 命令（Windows: PowerShell，Unix: $SHELL） |
 | `read_file` | 安全 | 读取文件内容（10 MB 限制，支持图片） |
 | `write_file` | 写入 | 创建/覆盖文件（diff 预览 + 确认） |
-| `edit_file` | 写入 | 精确字符串替换，模糊匹配提示 |
+| `edit_file` | 写入 | 精确字符串替换，模糊匹配提示 + `replaceAll` 全局替换模式 |
 | `list_dir` | 安全 | 列出目录内容 |
 | `grep_files` | 安全 | 正则搜索文件内容 |
 | `glob_files` | 安全 | 按 glob 模式匹配文件 |
@@ -159,6 +162,8 @@ AI 在对话中可自主调用 16 个工具：
 | `/config` | 打开配置向导 |
 | `/help` | 显示所有命令 |
 
+**多行输入**：行末加 `\` 续行，或直接粘贴多行内容（自动检测合并）。
+
 完整命令参考见 [使用说明](USAGE.md)。
 
 ## CLI 参数

package/dist/{chunk-OOLIOMNF.js → chunk-GGAA3JRD.js}

@@ -8,7 +8,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.2.10";
+var VERSION = "0.2.12";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";

package/dist/{chunk-MBIHQ34V.js → chunk-IGZDXYIX.js}

@@ -16,7 +16,7 @@ import {
   SUBAGENT_MAX_ROUNDS_LIMIT,
   VERSION,
   runTestsTool
-} from "./chunk-OOLIOMNF.js";
+} from "./chunk-GGAA3JRD.js";
 
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";

package/dist/index.js

@@ -35,7 +35,7 @@ import {
   theme,
   truncateOutput,
   undoStack
-} from "./chunk-MBIHQ34V.js";
+} from "./chunk-IGZDXYIX.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -55,7 +55,7 @@ import {
   REPO_URL,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-OOLIOMNF.js";
+} from "./chunk-GGAA3JRD.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -1904,7 +1904,7 @@ ${hint}` : "")
       description: "Run project tests and show structured report",
       usage: "/test [command|filter]",
       async execute(args, _ctx) {
-        const { executeTests } = await import("./run-tests-RAXI3LMY.js");
+        const { executeTests } = await import("./run-tests-R2BHDFGB.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -3785,7 +3785,15 @@ ${projectContext}`);
     const envInfo = `OS: ${osName}
 ${shellInfo}
 Working directory: ${process.cwd()}`;
-    const parts = [dateTimeInfo + "\n" + envInfo, AGENTIC_BEHAVIOR_GUIDELINE];
+    const budgetInfo = `
+
+# Tool Round Budget
+You have a maximum of ${MAX_TOOL_ROUNDS} tool call rounds per conversation turn. Plan your work accordingly:
+- Use efficient approaches: batch edits (replaceAll), read multiple files in one round, avoid re-reading files you already read.
+- On Windows, use PowerShell cmdlets (Invoke-RestMethod, Get-ChildItem) instead of Unix commands (curl, grep, find).
+- If starting a long-running server process via bash, use background execution \u2014 do not block the tool round.
+- Prioritize the most critical tasks first in case you run out of rounds.`;
+    const parts = [dateTimeInfo + "\n" + envInfo, AGENTIC_BEHAVIOR_GUIDELINE + budgetInfo];
     const memory = this.loadMemoryContent();
     if (memory) {
       parts.push(`# Persistent Memory
@@ -4821,6 +4829,7 @@ You have a maximum of ${MAX_TOOL_ROUNDS} tool call rounds for this task. Plan ef
     let consecutiveFreeRounds = 0;
     let lastToolCallSignature = "";
     let repeatedToolCallCount = 0;
+    const roundToolHistory = [];
     this.setupInterjectionListener();
     process.stdout.write(theme.dim("  (Type a message + Enter to redirect AI at any time)\n"));
     try {
@@ -4841,12 +4850,24 @@ You have a maximum of ${MAX_TOOL_ROUNDS} tool call rounds for this task. Plan ef
           extraMessages.push({ role: "user", content: cmd });
         }
         const roundsLeft = MAX_TOOL_ROUNDS - round;
-        if (roundsLeft === 5) {
+        if (roundsLeft === 10) {
+          extraMessages.push({
+            role: "user",
+            content: `\u{1F4CA} Budget note: ${roundsLeft} tool rounds remaining out of ${MAX_TOOL_ROUNDS}. Plan your remaining work efficiently \u2014 use batch operations (e.g., replaceAll) when possible.`
+          });
+        } else if (roundsLeft === 5) {
           extraMessages.push({
             role: "user",
-            content: `\u26A0\uFE0F Budget warning: Only ${roundsLeft} tool rounds remaining. Prioritize completing the most critical task. If you cannot finish everything, summarize what's done and what remains.`
+            content: `\u26A0\uFE0F Budget warning: Only ${roundsLeft} tool rounds remaining. Prioritize completing the most critical task. Use efficient approaches (batch edits, fewer reads). If you cannot finish everything, summarize what's done and what remains.`
           });
           process.stdout.write(theme.warning(`  \u26A0\uFE0F Low budget: ${roundsLeft} rounds remaining
+`));
+        } else if (roundsLeft === 3) {
+          extraMessages.push({
+            role: "user",
+            content: `\u{1F6A8} Critical budget: Only ${roundsLeft} rounds left! Wrap up NOW \u2014 complete the current operation and give a final summary. Do NOT start new tasks.`
+          });
+          process.stdout.write(theme.error(`  \u{1F6A8} Critical: ${roundsLeft} rounds remaining
 `));
         }
         if (this._userInterjection) {
@@ -5031,6 +5052,10 @@ You have a maximum of ${MAX_TOOL_ROUNDS} tool call rounds for this task. Plan ef
           process.stdin.removeListener("data", this._interjectionHandler);
         }
         const toolResults = await this.toolExecutor.executeAll(result.toolCalls);
+        roundToolHistory.push({
+          round: round + 1,
+          tools: result.toolCalls.map((tc) => tc.name)
+        });
         if (this._interjectionHandler) {
           process.stdin.on("data", this._interjectionHandler);
           process.stdin.resume();
@@ -5083,6 +5108,18 @@ You have a maximum of ${MAX_TOOL_ROUNDS} tool call rounds for this task. Plan ef
           process.stdout.write("\n");
           process.stdout.write(theme.warning(`\u23F8  Auto-pause: ${effectiveRound}/${MAX_TOOL_ROUNDS} rounds used, ${remaining} remaining
 `));
+          const recentHistory = roundToolHistory.slice(-AUTO_PAUSE_INTERVAL);
+          if (recentHistory.length > 0) {
+            const toolCounts = /* @__PURE__ */ new Map();
+            for (const rh of recentHistory) {
+              for (const t of rh.tools) {
+                toolCounts.set(t, (toolCounts.get(t) || 0) + 1);
+              }
+            }
+            const summary = [...toolCounts.entries()].sort((a, b) => b[1] - a[1]).map(([name, count]) => count > 1 ? `${name}\xD7${count}` : name).join(", ");
+            process.stdout.write(theme.dim(`  Tools used: ${summary}
+`));
+          }
           process.stdout.write(theme.dim("  Press ") + theme.info("y") + theme.dim(" to continue, or ") + theme.info("type a message") + theme.dim(" to redirect AI:\n"));
           process.stdout.write(theme.dim("  (Press ") + theme.info("n") + theme.dim(" or ") + theme.info("Esc") + theme.dim(" to stop)\n"));
           this.teardownInterjectionListener();
@@ -5437,7 +5474,7 @@ program.command("web").description("Start Web UI server with browser-based chat
     console.error("Error: Invalid port number. Must be between 1 and 65535.");
     process.exit(1);
   }
-  const { startWebServer } = await import("./server-HYAIDK7B.js");
+  const { startWebServer } = await import("./server-Z3UV3EZB.js");
   await startWebServer({ port, host: options.host });
 });
 program.command("user [action] [username]").description("Manage Web UI users (list | create <name> | delete <name> | reset-password <name> | migrate <name>)").action(async (action, username) => {

package/dist/{run-tests-RAXI3LMY.js → run-tests-R2BHDFGB.js}

@@ -2,7 +2,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-OOLIOMNF.js";
+} from "./chunk-GGAA3JRD.js";
 export {
   executeTests,
   runTestsTool

package/dist/{server-HYAIDK7B.js → server-Z3UV3EZB.js}

@@ -23,7 +23,7 @@ import {
   setupProxy,
   spawnAgentContext,
   truncateOutput
-} from "./chunk-MBIHQ34V.js";
+} from "./chunk-IGZDXYIX.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   CONTEXT_FILE_CANDIDATES,
@@ -35,7 +35,7 @@ import {
   PLAN_MODE_SYSTEM_ADDON,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-OOLIOMNF.js";
+} from "./chunk-GGAA3JRD.js";
 import {
   AuthManager
 } from "./chunk-CPLT6CD3.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jinzd-ai-cli",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Cross-platform REPL-style AI CLI with multi-provider support",
   "type": "module",
   "main": "./dist/index.js",