jinzd-ai-cli 0.4.12 → 0.4.14

package/README.md

@@ -34,7 +34,7 @@
 - **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
+- **37 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
 
@@ -172,7 +172,7 @@ AI autonomously invokes these 16 tools during conversations:
 
 **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.
+Type `/help` in the REPL to see all 37 commands.
 
 ## CLI Parameters
 
@@ -356,7 +356,6 @@ npm run test:watch    # Watch mode
 
 ## Documentation
 
-- [Full Usage Guide](USAGE.md) — Comprehensive reference for all features
 - [Chinese README](README.zh-CN.md) — 中文说明文档
 
 ## License

package/README.zh-CN.md

@@ -26,7 +26,7 @@
 - **PWA 支持** — Web UI 可安装为桌面/移动应用，支持局域网访问
 - **三层级上下文** — 全局 / 项目 / 子目录上下文文件自动注入
 - **无头模式** — `aicli -p "提示词"` 用于 CI/CD 管道和脚本
-- **35+ REPL 命令** — 会话管理、检查点、代码审查、脚手架等
+- **37 个 REPL 命令** — 会话管理、检查点、代码审查、脚手架等
 - **GitHub Actions CI/CD** — Node 20/22 自动测试 + Release tag 自动发布 npm
 - **跨平台** — Windows、macOS、Linux
 
@@ -164,7 +164,7 @@ AI 在对话中可自主调用 16 个工具：
 
 **多行输入**：行末加 `\` 续行，或直接粘贴多行内容（自动检测合并）。
 
-完整命令参考见 [使用说明](USAGE.md)。
+在 REPL 中输入 `/help` 查看全部 37 个命令。
 
 ## CLI 参数
 
@@ -369,7 +369,6 @@ npm run test:watch    # 监听模式
 
 ## 文档
 
-- [完整使用说明](USAGE.md) — 所有功能的详细参考
 - [English README](README.md) — English documentation
 
 ## License

package/dist/{chunk-Z5IRVRGL.js → chunk-244SVJXW.js}

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

package/dist/{chunk-3HJSWTKO.js → chunk-QW2UGW6D.js}

@@ -6,13 +6,14 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.4.12";
+var VERSION = "0.4.14";
 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;
@@ -84,6 +85,9 @@ var AGENTIC_BEHAVIOR_GUIDELINE = `# Important Behavioral Guidelines
 - Only begin using write/execute tools when the user **explicitly requests** an action (e.g., "generate", "create", "modify", "run", "start", etc.).
 - Project context files (CLAUDE.md, AICLI.md) provide background information about the project. They are NOT instructions to start working. Only use them as reference when the user asks a project-related question or task.
 - If you are unsure about the user's intent, use the ask_user tool to confirm with the user, rather than assuming and executing on your own.`;
+var AUTHOR = "Jin Zhengdong";
+var AUTHOR_EMAIL = "zhengdong.jin@gmail.com";
+var DESCRIPTION = "Cross-platform REPL-style AI conversation tool with multi-provider and agentic tool calling support";
 
 // src/tools/builtin/run-tests.ts
 var IS_WINDOWS = platform() === "win32";
@@ -447,6 +451,7 @@ export {
   HISTORY_DIR_NAME,
   PLUGINS_DIR_NAME,
   SKILLS_DIR_NAME,
+  CUSTOM_COMMANDS_DIR_NAME,
   CONTEXT_FILE_CANDIDATES,
   MEMORY_FILE_NAME,
   MEMORY_MAX_CHARS,
@@ -463,6 +468,9 @@ export {
   SUBAGENT_MAX_ROUNDS_LIMIT,
   SUBAGENT_ALLOWED_TOOLS,
   AGENTIC_BEHAVIOR_GUIDELINE,
+  AUTHOR,
+  AUTHOR_EMAIL,
+  DESCRIPTION,
   executeTests,
   runTestsTool
 };

package/dist/{chunk-JPCRXQ2E.js → chunk-ROMSAKP6.js}

@@ -2,7 +2,7 @@
 import {
   EnvLoader,
   schemaToJsonSchema
-} from "./chunk-A3S7PUMM.js";
+} from "./chunk-WIWNSN7U.js";
 import {
   APP_NAME,
   CONFIG_DIR_NAME,
@@ -15,7 +15,7 @@ import {
   MCP_TOOL_PREFIX,
   PLUGINS_DIR_NAME,
   VERSION
-} from "./chunk-Z5IRVRGL.js";
+} from "./chunk-244SVJXW.js";
 
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -277,7 +277,8 @@ ${err}`
     if (rawValue === "true") value = true;
     else if (rawValue === "false") value = false;
     else if (rawValue !== "" && !isNaN(Number(rawValue))) value = Number(rawValue);
-    let current = this.config;
+    const draft = JSON.parse(JSON.stringify(this.config));
+    let current = draft;
     for (let i = 0; i < keys.length - 1; i++) {
       const key = keys[i];
       if (current[key] == null || typeof current[key] !== "object") {
@@ -286,6 +287,12 @@ ${err}`
       current = current[key];
     }
     current[keys[keys.length - 1]] = value;
+    const result = ConfigSchema.safeParse(draft);
+    if (!result.success) {
+      const firstErr = result.error.errors[0];
+      throw new ConfigError(`Invalid config value for "${path}": ${firstErr?.message ?? "validation failed"}`);
+    }
+    this.config = result.data;
     this.save();
   }
   /** 获取完整配置对象的格式化 JSON 字符串（用于 /config show 等展示） */
@@ -2535,6 +2542,7 @@ var McpClient = class {
   config;
   process = null;
   nextId = 1;
+  // M8: wraps at MAX_SAFE_INTEGER via getNextId()
   connected = false;
   serverInfo = null;
   /** stderr 收集（最多保留最后 2KB，用于错误报告） */
@@ -2667,6 +2675,7 @@ var McpClient = class {
         return reject(new Error(`MCP server [${this.serverId}] stdin not writable`));
       }
       const id = this.nextId++;
+      if (this.nextId > Number.MAX_SAFE_INTEGER - 1) this.nextId = 1;
       const request = {
         jsonrpc: "2.0",
         id,

package/dist/{chunk-A3S7PUMM.js → chunk-WIWNSN7U.js}

@@ -6,7 +6,7 @@ import {
   SUBAGENT_DEFAULT_MAX_ROUNDS,
   SUBAGENT_MAX_ROUNDS_LIMIT,
   runTestsTool
-} from "./chunk-Z5IRVRGL.js";
+} from "./chunk-244SVJXW.js";
 
 // src/tools/builtin/bash.ts
 import { execSync } from "child_process";
@@ -534,6 +534,13 @@ Suggestion: read existing text versions (.md / .txt) in the project, or install
     if (BINARY_EXTENSIONS.has(ext)) {
       return `[Binary file: ${filePath} (${ext})]
 This is a binary file and cannot be read as text. If there is a text version (.md / .txt) in the project, please read that instead.`;
+    }
+    try {
+      const fstat = statSync2(normalizedPath);
+      if (fstat.size > MAX_FILE_BYTES) {
+        return `[File too large: ${filePath} | ${(fstat.size / 1024 / 1024).toFixed(1)} MB exceeds ${MAX_FILE_BYTES / 1024 / 1024} MB limit]`;
+      }
+    } catch {
     }
     const buf = readFileSync2(normalizedPath);
     if (encoding === "base64") {
@@ -1003,6 +1010,10 @@ Supports regex. Automatically skips node_modules, dist, .git directories.`,
     const maxResults = Math.max(1, Number(args["max_results"] ?? 50));
     if (!pattern) throw new Error("pattern is required");
     if (!existsSync6(rootPath)) throw new Error(`Path not found: ${rootPath}`);
+    const MAX_PATTERN_LENGTH = 1e3;
+    if (pattern.length > MAX_PATTERN_LENGTH) {
+      throw new Error(`Pattern too long (${pattern.length} chars, max ${MAX_PATTERN_LENGTH}). Use a shorter pattern.`);
+    }
     let regex;
     try {
       regex = new RegExp(pattern, ignoreCase ? "gi" : "g");
@@ -1386,11 +1397,11 @@ ${stderr}`);
 // src/tools/builtin/web-fetch.ts
 import { promises as dnsPromises } from "dns";
 function htmlToText(html) {
+  let text = html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<noscript[\s\S]*?<\/noscript>/gi, "").replace(/<svg[\s\S]*?<\/svg>/gi, "");
   const HTML_REGEX_LIMIT = 2e5;
-  if (html.length > HTML_REGEX_LIMIT) {
-    html = html.slice(0, HTML_REGEX_LIMIT);
+  if (text.length > HTML_REGEX_LIMIT) {
+    text = text.slice(0, HTML_REGEX_LIMIT);
   }
-  let text = html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<noscript[\s\S]*?<\/noscript>/gi, "").replace(/<svg[\s\S]*?<\/svg>/gi, "");
   text = text.replace(/<h([1-6])[^>]*>([\s\S]*?)<\/h\1>/gi, (_m, lvl, content) => {
     const prefix = "#".repeat(Number(lvl));
     return `
@@ -1848,6 +1859,14 @@ var EnvLoader = class {
       if (val) return val;
     }
     const dynamicEnvVar = `AICLI_API_KEY_${providerId.toUpperCase().replace(/-/g, "_")}`;
+    if (fixedEnvVar && fixedEnvVar !== dynamicEnvVar) {
+      const fixedVal = process.env[fixedEnvVar];
+      const dynVal = process.env[dynamicEnvVar];
+      if (fixedVal && dynVal && fixedVal !== dynVal) {
+        process.stderr.write(`[warn] env var collision: ${fixedEnvVar} and ${dynamicEnvVar} have different values for provider "${providerId}". Using ${fixedEnvVar}.
+`);
+      }
+    }
     return process.env[dynamicEnvVar] || void 0;
   }
   static getDefaultProvider() {

package/dist/{hub-J5ZOVM4Q.js → hub-QZXQ6JYS.js}

@@ -381,7 +381,7 @@ ${content}`);
   }
 }
 async function runTaskMode(config, providers, configManager, topic) {
-  const { TaskOrchestrator } = await import("./task-orchestrator-A5X2GUSH.js");
+  const { TaskOrchestrator } = await import("./task-orchestrator-EGJZA6Y4.js");
   const orchestrator = new TaskOrchestrator(config, providers, configManager);
   let interrupted = false;
   const onSigint = () => {

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   saveDevState,
   sessionHasMeaningfulContent,
   setupProxy
-} from "./chunk-JPCRXQ2E.js";
+} from "./chunk-ROMSAKP6.js";
 import {
   ToolRegistry,
   askUserContext,
@@ -38,7 +38,7 @@ import {
   theme,
   truncateOutput,
   undoStack
-} from "./chunk-A3S7PUMM.js";
+} from "./chunk-WIWNSN7U.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -58,7 +58,7 @@ import {
   REPO_URL,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-Z5IRVRGL.js";
+} from "./chunk-244SVJXW.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -1914,7 +1914,7 @@ ${hint}` : "")
       description: "Run project tests and show structured report",
       usage: "/test [command|filter]",
       async execute(args, _ctx) {
-        const { executeTests } = await import("./run-tests-EUOAU3RZ.js");
+        const { executeTests } = await import("./run-tests-YU52BWHE.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -5528,7 +5528,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-PWWT4P52.js");
+  const { startWebServer } = await import("./server-KVHJCPUO.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) => {
@@ -5761,7 +5761,7 @@ program.command("hub [topic]").description("Start multi-agent hub (discuss / bra
     }),
     config.get("customProviders")
   );
-  const { startHub } = await import("./hub-J5ZOVM4Q.js");
+  const { startHub } = await import("./hub-QZXQ6JYS.js");
   await startHub(
     {
       topic: topic ?? "",

package/dist/{run-tests-4WPBBNWG.js → run-tests-QDMBYWZA.js}

@@ -1,7 +1,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-3HJSWTKO.js";
+} from "./chunk-QW2UGW6D.js";
 export {
   executeTests,
   runTestsTool

package/dist/{run-tests-EUOAU3RZ.js → run-tests-YU52BWHE.js}

@@ -2,7 +2,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-Z5IRVRGL.js";
+} from "./chunk-244SVJXW.js";
 export {
   executeTests,
   runTestsTool

package/dist/{server-PWWT4P52.js → server-KVHJCPUO.js}

@@ -18,7 +18,7 @@ import {
   renderDiff,
   runHook,
   setupProxy
-} from "./chunk-JPCRXQ2E.js";
+} from "./chunk-ROMSAKP6.js";
 import {
   AuthManager
 } from "./chunk-BYNY5JPB.js";
@@ -32,19 +32,24 @@ import {
   spawnAgentContext,
   truncateOutput,
   undoStack
-} from "./chunk-A3S7PUMM.js";
+} from "./chunk-WIWNSN7U.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
+  AUTHOR,
+  AUTHOR_EMAIL,
   CONTEXT_FILE_CANDIDATES,
+  CUSTOM_COMMANDS_DIR_NAME,
   DEFAULT_MAX_TOKENS,
+  DESCRIPTION,
   MCP_PROJECT_CONFIG_NAME,
   MEMORY_FILE_NAME,
   MEMORY_MAX_CHARS,
   PLAN_MODE_READONLY_TOOLS,
   PLAN_MODE_SYSTEM_ADDON,
+  PLUGINS_DIR_NAME,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-Z5IRVRGL.js";
+} from "./chunk-244SVJXW.js";
 
 // src/web/server.ts
 import express from "express";
@@ -57,7 +62,7 @@ import { networkInterfaces } from "os";
 // src/web/tool-executor-web.ts
 import { randomUUID } from "crypto";
 import { existsSync, readFileSync } from "fs";
-var ToolExecutorWeb = class {
+var ToolExecutorWeb = class _ToolExecutorWeb {
   constructor(registry, ws) {
     this.registry = registry;
     this.ws = ws;
@@ -71,6 +76,10 @@ var ToolExecutorWeb = class {
   pendingConfirms = /* @__PURE__ */ new Map();
   /** Pending batch confirm promises */
   pendingBatchConfirms = /* @__PURE__ */ new Map();
+  /** M7 fix: timers for confirm cleanup if client crashes */
+  pendingTimers = /* @__PURE__ */ new Map();
+  static CONFIRM_TIMEOUT_MS = 5 * 60 * 1e3;
+  // 5 minutes
   /** Publicly readable by SessionHandler to check if confirm is active */
   confirming = false;
   /** Session-level auto-approve toggle (/yolo command) */
@@ -86,10 +95,19 @@ var ToolExecutorWeb = class {
     if (opts.permissionRules) this.permissionRules = opts.permissionRules;
     if (opts.defaultPermission) this.defaultPermission = opts.defaultPermission;
   }
+  /** Clear M7 timeout timer for a requestId */
+  clearPendingTimer(requestId) {
+    const timer = this.pendingTimers.get(requestId);
+    if (timer) {
+      clearTimeout(timer);
+      this.pendingTimers.delete(requestId);
+    }
+  }
   /** Resolve a pending confirm from client response */
   resolveConfirm(requestId, approved) {
     const resolve3 = this.pendingConfirms.get(requestId);
     if (resolve3) {
+      this.clearPendingTimer(requestId);
       this.pendingConfirms.delete(requestId);
       this.confirming = false;
       resolve3(approved);
@@ -99,6 +117,7 @@ var ToolExecutorWeb = class {
   resolveBatchConfirm(requestId, decision) {
     const resolve3 = this.pendingBatchConfirms.get(requestId);
     if (resolve3) {
+      this.clearPendingTimer(requestId);
       this.pendingBatchConfirms.delete(requestId);
       this.confirming = false;
       if (decision === "all" || decision === "none") {
@@ -190,6 +209,11 @@ var ToolExecutorWeb = class {
     this.send(msg);
     return new Promise((resolve3) => {
       this.pendingConfirms.set(requestId, resolve3);
+      this.pendingTimers.set(requestId, setTimeout(() => {
+        if (this.pendingConfirms.has(requestId)) {
+          this.resolveConfirm(requestId, false);
+        }
+      }, _ToolExecutorWeb.CONFIRM_TIMEOUT_MS));
     });
   }
   /** WebSocket-based batch confirm */
@@ -210,6 +234,11 @@ var ToolExecutorWeb = class {
     this.send(msg);
     return new Promise((resolve3) => {
       this.pendingBatchConfirms.set(requestId, resolve3);
+      this.pendingTimers.set(requestId, setTimeout(() => {
+        if (this.pendingBatchConfirms.has(requestId)) {
+          this.resolveBatchConfirm(requestId, "none");
+        }
+      }, _ToolExecutorWeb.CONFIRM_TIMEOUT_MS));
     });
   }
   async execute(call) {
@@ -451,6 +480,8 @@ var SessionHandler = class _SessionHandler {
   pendingAskUser = /* @__PURE__ */ new Map();
   /** Active system prompt from context files */
   activeSystemPrompt;
+  /** Directories added via /add-dir */
+  addedDirs = /* @__PURE__ */ new Set();
   constructor(ws, shared) {
     this.ws = ws;
     this.config = shared.config;
@@ -1054,27 +1085,25 @@ Tokens: in=${this.sessionTokenUsage.inputTokens} out=${this.sessionTokenUsage.ou
           message: [
             "\u{1F4D6} Available Web UI commands:",
             "",
+            "  /help                \u2014 Show this help message",
+            "  /about               \u2014 Version & author info",
             "  /provider <id>       \u2014 Switch AI provider",
             "  /model <id>          \u2014 Switch model",
             "  /clear               \u2014 Clear conversation & start new session",
             "  /compact [hint]      \u2014 Compress conversation history",
             "  /think [on|off]      \u2014 Toggle extended thinking mode",
             "  /plan [enter|exit]   \u2014 Toggle read-only planning mode",
-            "  /session new         \u2014 Create a new session",
-            "  /session list        \u2014 List saved sessions",
-            "  /session load <id>   \u2014 Resume a saved session",
-            "  /session delete <id> \u2014 Delete a session",
+            "  /session new|list|load|delete <id> \u2014 Session management",
+            "  /system [prompt|clear] \u2014 Set/view/reset system prompt",
+            "  /context [reload]    \u2014 Show/reload context layers",
             "  /status              \u2014 Show session info & token usage",
             "  /cost                \u2014 Show cumulative token usage",
-            "  /tools               \u2014 Show tools, MCP servers & skills in sidebar",
-            "  /export [md|json]    \u2014 Export conversation as Markdown or JSON",
-            "  /skill               \u2014 List available skills",
-            "  /skill <name>        \u2014 Activate a skill",
-            "  /skill off           \u2014 Deactivate current skill",
-            "  /memory              \u2014 Show persistent memory contents",
-            "  /memory add <text>   \u2014 Add entry to persistent memory",
-            "  /memory clear        \u2014 Clear persistent memory",
-            "  /yolo [on|off]       \u2014 Toggle session auto-approve (skip confirmations)",
+            "  /config [show|get|set] \u2014 View/modify configuration",
+            "  /tools               \u2014 Show tools, MCP servers & skills",
+            "  /export [md|json]    \u2014 Export conversation",
+            "  /skill [name|off|list|reload] \u2014 Manage agent skills",
+            "  /memory [show|add|clear] \u2014 Persistent memory management",
+            "  /yolo [on|off]       \u2014 Toggle auto-approve (skip confirmations)",
             "  /search <keyword>    \u2014 Search across all session histories",
             "  /undo [list|<n>]     \u2014 Undo file operations",
             "  /diff [--stats]      \u2014 Show file modifications in this session",
@@ -1083,8 +1112,13 @@ Tokens: in=${this.sessionTokenUsage.inputTokens} out=${this.sessionTokenUsage.ou
             "  /review [--staged]   \u2014 AI code review from git diff",
             "  /test [command]      \u2014 Run project tests",
             "  /init [--force]      \u2014 Generate AICLI.md by scanning project",
+            "  /scaffold <desc>     \u2014 Generate project scaffolding with AI",
+            "  /add-dir [path|remove] \u2014 Add/remove directory from AI context",
+            "  /mcp [reconnect]     \u2014 Show/manage MCP servers",
+            "  /plugins             \u2014 Show loaded plugins",
+            "  /commands            \u2014 List custom commands",
             "  /doctor              \u2014 Health check (API keys, config, MCP)",
-            "  /help                \u2014 Show this help message",
+            "  /bug                 \u2014 Generate bug report template",
             "",
             "\u{1F4A1} Tips:",
             "  \u2022 Change provider/model with the dropdowns above",
@@ -1448,7 +1482,7 @@ ${undoResults.map((r) => `  \u2022 ${r}`).join("\n")}` });
       case "test": {
         this.send({ type: "info", message: "\u{1F9EA} Running tests..." });
         try {
-          const { executeTests } = await import("./run-tests-EUOAU3RZ.js");
+          const { executeTests } = await import("./run-tests-YU52BWHE.js");
           const argStr = args.join(" ").trim();
           let testArgs = {};
           if (argStr) {
@@ -1536,6 +1570,264 @@ Use /context reload to load it.` });
         this.send({ type: "info", message: lines.join("\n") });
         break;
       }
+      // ── /about ──────────────────────────────────────────────────────
+      case "about": {
+        const providerList = this.providers.listAll();
+        const toolCount = this.toolRegistry.getDefinitions().length;
+        const mcpTools = this.mcpManager?.getTotalToolCount() ?? 0;
+        const lines = [
+          `\u{1F916} **ai-cli** v${VERSION}`,
+          "",
+          `${DESCRIPTION}`,
+          `Author: ${AUTHOR} <${AUTHOR_EMAIL}>`,
+          "",
+          `**Providers:** ${providerList.length} (${providerList.map((p) => p.id).join(", ")})`,
+          `**Tools:** ${toolCount + mcpTools} (${toolCount} built-in${mcpTools > 0 ? ` + ${mcpTools} MCP` : ""})`,
+          `**REPL Commands:** 37`,
+          "",
+          `GitHub: https://github.com/jinzhengdong/ai-cli`
+        ];
+        this.send({ type: "info", message: lines.join("\n") });
+        break;
+      }
+      // ── /system ─────────────────────────────────────────────────────
+      case "system": {
+        const text = args.join(" ").trim();
+        if (!text) {
+          const current = this.activeSystemPrompt;
+          if (current) {
+            const preview = current.length > 500 ? current.slice(0, 500) + "..." : current;
+            this.send({ type: "info", message: `\u{1F4CB} Current system prompt (${current.length} chars):
+
+${preview}` });
+          } else {
+            this.send({ type: "info", message: "No custom system prompt set. Using default.\nUsage: /system <prompt>" });
+          }
+          break;
+        }
+        if (text === "clear" || text === "reset") {
+          this.activeSystemPrompt = this.loadContextFiles();
+          this.send({ type: "info", message: "\u2713 System prompt reset to default (context files)." });
+        } else {
+          this.activeSystemPrompt = text;
+          this.send({ type: "info", message: `\u2713 System prompt set (${text.length} chars).` });
+        }
+        break;
+      }
+      // ── /config ─────────────────────────────────────────────────────
+      case "config": {
+        const sub = args[0];
+        if (sub === "show" || !sub) {
+          this.send({ type: "info", message: `\u2699\uFE0F Configuration:
+\`\`\`json
+${this.config.toFormattedJSON()}
+\`\`\`` });
+        } else if (sub === "get" && args[1]) {
+          const val = this.config.getByPath(args[1]);
+          const display = typeof val === "object" ? JSON.stringify(val, null, 2) : String(val ?? "undefined");
+          this.send({ type: "info", message: `${args[1]} = ${display}` });
+        } else if (sub === "set" && args[1] && args[2] !== void 0) {
+          try {
+            this.config.setByPath(args[1], args.slice(2).join(" "));
+            this.send({ type: "info", message: `\u2713 ${args[1]} = ${args.slice(2).join(" ")}` });
+          } catch (err) {
+            this.send({ type: "error", message: `Config error: ${err.message}` });
+          }
+        } else {
+          this.send({ type: "info", message: "Usage: /config [show] | /config get <key> | /config set <key> <value>" });
+        }
+        break;
+      }
+      // ── /context ────────────────────────────────────────────────────
+      case "context": {
+        const sub = args[0];
+        if (sub === "reload") {
+          this.activeSystemPrompt = this.loadContextFiles();
+          this.send({ type: "info", message: this.activeSystemPrompt ? `\u2713 Context reloaded (${this.activeSystemPrompt.length} chars).` : "\u2713 No context files found." });
+          break;
+        }
+        const configDir = this.config.getConfigDir();
+        const cwd = process.cwd();
+        const gitRoot = getGitRoot(cwd);
+        const projectRoot = gitRoot ?? cwd;
+        const layers = ["\u{1F4DA} **Context Layers:**", ""];
+        const checkLayer = (label, dir) => {
+          for (const name2 of CONTEXT_FILE_CANDIDATES) {
+            const fullPath = join2(dir, name2);
+            if (existsSync3(fullPath)) {
+              try {
+                const size = statSync(fullPath).size;
+                layers.push(`  \u2713 ${label}: ${fullPath} (${size} bytes)`);
+                return;
+              } catch {
+              }
+            }
+          }
+          layers.push(`  \u2013  ${label}: (none)`);
+        };
+        checkLayer("Global", configDir);
+        checkLayer("Project", projectRoot);
+        if (resolve(cwd) !== resolve(projectRoot)) {
+          checkLayer("Subdir", cwd);
+        }
+        layers.push("");
+        layers.push(`Total prompt length: ${this.activeSystemPrompt?.length ?? 0} chars`);
+        layers.push("Use /context reload to refresh.");
+        this.send({ type: "info", message: layers.join("\n") });
+        break;
+      }
+      // ── /mcp ────────────────────────────────────────────────────────
+      case "mcp": {
+        if (!this.mcpManager) {
+          this.send({ type: "info", message: "MCP not configured. Add mcpServers to config.json." });
+          break;
+        }
+        const sub = args[0];
+        if (sub === "reconnect") {
+          const targetId = args[1];
+          this.send({ type: "info", message: "\u{1F504} Reconnecting MCP servers..." });
+          try {
+            await this.mcpManager.reconnectAll();
+            this.send({ type: "info", message: "\u2713 MCP reconnect complete." });
+          } catch (err) {
+            this.send({ type: "error", message: `Reconnect failed: ${err.message}` });
+          }
+          this.sendToolsList();
+          break;
+        }
+        const statuses = this.mcpManager.getStatus();
+        if (statuses.length === 0) {
+          this.send({ type: "info", message: "No MCP servers configured." });
+          break;
+        }
+        const lines = [`\u{1F50C} **MCP Servers (${statuses.length}):**`, ""];
+        for (const s of statuses) {
+          const state = s.connected ? `\u2713 connected \xB7 ${s.serverName} \xB7 ${s.toolCount} tools` : `\u2717 disconnected${s.error ? ` \xB7 ${s.error}` : ""}`;
+          lines.push(`  ${s.serverId}: ${state}`);
+        }
+        lines.push("");
+        lines.push("Use /mcp reconnect to reconnect.");
+        this.send({ type: "info", message: lines.join("\n") });
+        break;
+      }
+      // ── /scaffold ───────────────────────────────────────────────────
+      case "scaffold": {
+        const description = args.join(" ").trim();
+        if (!description) {
+          this.send({ type: "error", message: "Usage: /scaffold <project description>" });
+          break;
+        }
+        this.send({ type: "info", message: "\u{1F3D7}\uFE0F Generating project scaffold..." });
+        const scaffoldPrompt = `Please scaffold a project based on this description: ${description}
+
+Create the necessary files and directory structure. Use write_file and bash tools to set up the project.`;
+        await this.handleChat(scaffoldPrompt);
+        break;
+      }
+      // ── /add-dir ────────────────────────────────────────────────────
+      case "add-dir": {
+        const sub = args[0]?.trim();
+        if (!sub) {
+          this.send({ type: "info", message: this.addedDirs.size > 0 ? `\u{1F4C1} Added directories:
+${[...this.addedDirs].map((d) => `  \u2022 ${d}`).join("\n")}
+
+Use /add-dir remove to clear.` : "No directories added.\nUsage: /add-dir <path> | /add-dir remove" });
+          break;
+        }
+        if (sub === "remove" || sub === "clear") {
+          this.addedDirs.clear();
+          this.send({ type: "info", message: "\u2713 All added directories removed from context." });
+          break;
+        }
+        const dirPath = resolve(sub);
+        if (!existsSync3(dirPath)) {
+          this.send({ type: "error", message: `Directory not found: ${dirPath}` });
+          break;
+        }
+        if (!statSync(dirPath).isDirectory()) {
+          this.send({ type: "error", message: `Not a directory: ${dirPath}` });
+          break;
+        }
+        this.addedDirs.add(dirPath);
+        this.send({ type: "info", message: `\u2713 Added directory: ${dirPath}
+It will be included in AI context for subsequent messages.` });
+        break;
+      }
+      // ── /commands ───────────────────────────────────────────────────
+      case "commands": {
+        const configDir = this.config.getConfigDir();
+        const commandsDir = join2(configDir, CUSTOM_COMMANDS_DIR_NAME);
+        if (!existsSync3(commandsDir)) {
+          this.send({ type: "info", message: `No custom commands directory.
+Create: ${commandsDir}/ with .md files.` });
+          break;
+        }
+        try {
+          const files = readdirSync(commandsDir).filter((f) => f.endsWith(".md"));
+          if (files.length === 0) {
+            this.send({ type: "info", message: `No custom commands found in ${commandsDir}
+Add .md files to create commands.` });
+          } else {
+            const lines = [`\u{1F4CB} **Custom Commands (${files.length}):**`, `Dir: ${commandsDir}`, ""];
+            for (const f of files) {
+              const name2 = f.replace(/\.md$/, "");
+              lines.push(`  /${name2}`);
+            }
+            this.send({ type: "info", message: lines.join("\n") });
+          }
+        } catch {
+          this.send({ type: "info", message: `Cannot read: ${commandsDir}` });
+        }
+        break;
+      }
+      // ── /plugins ────────────────────────────────────────────────────
+      case "plugins": {
+        const configDir = this.config.getConfigDir();
+        const pluginsDir = join2(configDir, PLUGINS_DIR_NAME);
+        const pluginTools = this.toolRegistry.listPluginTools();
+        const lines = [`\u{1F50C} **Plugins:**`, `Dir: ${pluginsDir}`, ""];
+        if (pluginTools.length === 0) {
+          lines.push("No plugins loaded.");
+          lines.push("Add .js files to the plugins directory and set allowPlugins:true in config.");
+        } else {
+          for (const t of pluginTools) {
+            lines.push(`  \u2022 ${t.name} \u2014 ${t.description}`);
+          }
+        }
+        this.send({ type: "info", message: lines.join("\n") });
+        break;
+      }
+      // ── /bug ────────────────────────────────────────────────────────
+      case "bug": {
+        const session = this.sessions.current;
+        const lines = [
+          "\u{1F41B} **Bug Report Template**",
+          "",
+          "**Environment:**",
+          `  ai-cli version: ${VERSION}`,
+          `  Node.js: ${process.version}`,
+          `  OS: ${process.platform} ${process.arch}`,
+          `  Provider: ${this.currentProvider}`,
+          `  Model: ${this.currentModel}`,
+          `  Session: ${session?.id.slice(0, 8) ?? "none"} (${session?.messages.length ?? 0} messages)`,
+          "",
+          "**Description:**",
+          "(Describe the bug)",
+          "",
+          "**Steps to reproduce:**",
+          "1. ...",
+          "",
+          "**Expected behavior:**",
+          "...",
+          "",
+          "**Actual behavior:**",
+          "...",
+          "",
+          "Report at: https://github.com/jinzhengdong/ai-cli/issues"
+        ];
+        this.send({ type: "info", message: lines.join("\n") });
+        break;
+      }
       default:
         this.send({ type: "error", message: `Unknown command: /${name}. Type /help for available commands.` });
     }
@@ -1735,12 +2027,27 @@ Use /context reload to load it.` });
   buildSystemPrompt() {
     const skillContent = this.skillManager?.getActivePromptContent();
     const activeSkill = skillContent && this.skillManager?.getActive() ? { name: this.skillManager.getActive().meta.name, content: skillContent } : void 0;
-    return buildSystemPrompt({
+    let prompt = buildSystemPrompt({
       activeSystemPrompt: this.activeSystemPrompt,
       activeSkill,
       planMode: this.planMode,
       configDir: this.config.getConfigDir()
     });
+    if (this.addedDirs.size > 0) {
+      const MAX_DIR_CONTEXT = 4e4;
+      let dirContext = "\n\n--- Added Directory Context ---\n";
+      let totalLen = 0;
+      for (const dir of this.addedDirs) {
+        if (totalLen > MAX_DIR_CONTEXT) break;
+        dirContext += `
+[Directory: ${dir}]
+`;
+        dirContext += this.scanDirTree(dir, 2, 40) + "\n";
+        totalLen = dirContext.length;
+      }
+      prompt += dirContext;
+    }
+    return prompt;
   }
   getModelParams() {
     const allParams = this.config.get("modelParams");

package/dist/{task-orchestrator-A5X2GUSH.js → task-orchestrator-EGJZA6Y4.js}

@@ -4,14 +4,14 @@ import {
   getDangerLevel,
   googleSearchContext,
   truncateOutput
-} from "./chunk-A3S7PUMM.js";
+} from "./chunk-WIWNSN7U.js";
 import {
   SUBAGENT_ALLOWED_TOOLS
-} from "./chunk-Z5IRVRGL.js";
+} from "./chunk-244SVJXW.js";
 
 // src/hub/task-orchestrator.ts
 import { createInterface } from "readline";
-import { existsSync, readFileSync, writeFileSync, unlinkSync } from "fs";
+import { existsSync, readFileSync, writeFileSync, unlinkSync, renameSync } from "fs";
 import { join } from "path";
 import chalk from "chalk";
 
@@ -266,7 +266,9 @@ var TaskOrchestrator = class {
   }
   saveState(plan) {
     try {
-      writeFileSync(this.stateFilePath, JSON.stringify(plan, null, 2), "utf-8");
+      const tmpPath = this.stateFilePath + ".tmp";
+      writeFileSync(tmpPath, JSON.stringify(plan, null, 2), "utf-8");
+      renameSync(tmpPath, this.stateFilePath);
     } catch {
     }
   }
@@ -357,13 +359,29 @@ Example:
       if (!Array.isArray(parsed) || parsed.length === 0) {
         throw new Error("Empty task list");
       }
+      const validRoleIds = new Set(roles.map((r) => r.id));
+      for (let i = 0; i < parsed.length; i++) {
+        const t = parsed[i];
+        if (typeof t !== "object" || t === null) {
+          throw new Error(`Task #${i + 1}: not an object`);
+        }
+        if (typeof t.description !== "string" || !t.description.trim()) {
+          throw new Error(`Task #${i + 1}: missing or empty "description"`);
+        }
+        if (typeof t.assignee !== "string" || !t.assignee.trim()) {
+          throw new Error(`Task #${i + 1}: missing or empty "assignee"`);
+        }
+        if (t.dependencies != null && !Array.isArray(t.dependencies)) {
+          throw new Error(`Task #${i + 1}: "dependencies" must be an array`);
+        }
+      }
       const roleMap = new Map(roles.map((r) => [r.id, r.name]));
       const tasks = parsed.map((t, i) => ({
-        id: t.id ?? i + 1,
+        id: typeof t.id === "number" ? t.id : i + 1,
         description: t.description,
         assignee: t.assignee,
         assigneeName: roleMap.get(t.assignee) ?? t.assignee,
-        dependencies: t.dependencies ?? [],
+        dependencies: Array.isArray(t.dependencies) ? t.dependencies : [],
         status: "pending"
       }));
       return { goal, tasks };
@@ -428,7 +446,15 @@ Example:
       if (!nextTask) {
         const pending = plan.tasks.filter((t) => t.status === "pending");
         if (pending.length === 0) break;
-        console.log(chalk.red(`  \u2717 Cannot proceed: ${pending.length} task(s) have unmet dependencies.`));
+        const failedIds = new Set(plan.tasks.filter((t) => t.status === "failed").map((t) => t.id));
+        const hasCycle = pending.every(
+          (t) => t.dependencies.some((d) => !completedIds.has(d) && !failedIds.has(d) && pending.some((p) => p.id === d))
+        );
+        if (hasCycle) {
+          console.log(chalk.red(`  \u2717 Circular dependency detected among ${pending.length} task(s):`));
+        } else {
+          console.log(chalk.red(`  \u2717 Cannot proceed: ${pending.length} task(s) have unmet dependencies.`));
+        }
         for (const t of pending) {
           const unmet = t.dependencies.filter((d) => !completedIds.has(d));
           console.log(chalk.dim(`    Task #${t.id}: waiting on [${unmet.join(", ")}]`));

package/package.json

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