jinzd-ai-cli 0.3.4 → 0.3.6

package/dist/{chunk-HUQVG74X.js → chunk-OQK3WSFD.js}

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

package/dist/{chunk-6YBF647F.js → chunk-RS5ALOXF.js}

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

package/dist/{chunk-YYZEZ6BO.js → chunk-U7YCERTR.js}

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

package/dist/index.js

@@ -36,7 +36,7 @@ import {
   theme,
   truncateOutput,
   undoStack
-} from "./chunk-6YBF647F.js";
+} from "./chunk-RS5ALOXF.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -56,7 +56,7 @@ import {
   REPO_URL,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-HUQVG74X.js";
+} from "./chunk-OQK3WSFD.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -1907,7 +1907,7 @@ ${hint}` : "")
       description: "Run project tests and show structured report",
       usage: "/test [command|filter]",
       async execute(args, _ctx) {
-        const { executeTests } = await import("./run-tests-5F4IFT5H.js");
+        const { executeTests } = await import("./run-tests-PGGAA5PE.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -5517,7 +5517,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-AXKGLNOI.js");
+  const { startWebServer } = await import("./server-2MJUVLUU.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) => {
@@ -5638,7 +5638,106 @@ program.command("sessions").description("List recent conversation sessions").act
   }
   console.log();
 });
-program.command("hub [topic]").description("Start multi-agent hub (discuss / brainstorm with multiple AI roles)").option("--preset <name>", "Use a built-in role preset (default: tech-review)").option("--roles <file>", "Load roles from a JSON file").option("--provider <name>", "Override default AI provider").option("-m, --model <name>", "Override default model").option("--max-rounds <n>", "Max discussion rounds (default: 10)").option("--presets", "List available role presets").option("--context <files...>", "Inject external document(s) as context for all agents (e.g. README.md spec.md)").option("--distributed", "Start WebSocket server so remote aicli instances can join as agents").option("--port <n>", "WebSocket port for distributed mode (default: 9527)", "9527").action(async (topic, options) => {
+program.command("help").description("Show a comprehensive guide to all aicli features and commands").action(() => {
+  const B = "\x1B[1m";
+  const D = "\x1B[2m";
+  const C = "\x1B[36m";
+  const G = "\x1B[32m";
+  const Y = "\x1B[33m";
+  const M = "\x1B[35m";
+  const R = "\x1B[0m";
+  const lines = [
+    "",
+    `${B}  AI-CLI v${VERSION} \u2014 Cross-platform AI Programming Assistant${R}`,
+    `${D}  Supports OpenAI, Claude, Gemini, DeepSeek, Zhipu, Kimi, OpenRouter${R}`,
+    "",
+    `${B}${C}  \u25A0 LAUNCH MODES${R}`,
+    `    ${G}aicli${R}                          Interactive REPL (default)`,
+    `    ${G}aicli web${R}                      Browser-based Web UI`,
+    `    ${G}aicli -p "prompt"${R}              Headless single-shot (for scripts/CI)`,
+    `    ${G}aicli hub "topic"${R}              Multi-agent collaborative discussion`,
+    `    ${G}aicli join${R}                     Join a hub as a remote agent`,
+    "",
+    `${B}${C}  \u25A0 CLI SUBCOMMANDS${R}`,
+    `    ${G}aicli config${R}                   Setup wizard (API keys, preferences)`,
+    `    ${G}aicli providers${R}                List all providers and status`,
+    `    ${G}aicli sessions${R}                 List recent conversation sessions`,
+    `    ${G}aicli user <action>${R}            User management (list/create/delete)`,
+    "",
+    `${B}${C}  \u25A0 STARTUP OPTIONS${R}`,
+    `    ${Y}--provider <name>${R}              Set AI provider`,
+    `    ${Y}-m, --model <name>${R}             Set model`,
+    `    ${Y}--resume <id>${R}                  Resume a previous session`,
+    `    ${Y}--allowed-tools <list>${R}         Tool whitelist (comma-separated)`,
+    `    ${Y}--blocked-tools <list>${R}         Tool blacklist (comma-separated)`,
+    `    ${Y}--no-stream${R}                    Disable streaming output`,
+    "",
+    `${B}${C}  \u25A0 HEADLESS OPTIONS${R}`,
+    `    ${Y}-p, --prompt <text>${R}            Send prompt and exit`,
+    `    ${Y}--system <prompt>${R}              Override system prompt`,
+    `    ${Y}--json${R}                         Output as JSON`,
+    `    ${Y}--output-format <fmt>${R}          text | streaming-json (NDJSON)`,
+    `    ${D}echo "code" | aicli -p "explain"  \u2190 pipe stdin as context${R}`,
+    "",
+    `${B}${C}  \u25A0 WEB UI OPTIONS${R}`,
+    `    ${Y}aicli web --port 8080${R}          Custom port (default: 3000)`,
+    `    ${Y}aicli web --host 0.0.0.0${R}       LAN access (mobile/tablet)`,
+    "",
+    `${B}${C}  \u25A0 MULTI-AGENT HUB${R}`,
+    `    ${Y}--preset <name>${R}                Role preset (tech-review/brainstorm/code-review/debate)`,
+    `    ${Y}--roles <file>${R}                 Custom roles JSON file`,
+    `    ${Y}-c, --context <file>${R}           Inject context doc (repeatable: -c a.md -c b.md)`,
+    `    ${Y}--distributed${R}                  Distributed mode (WebSocket, multi-process)`,
+    `    ${Y}--max-rounds <n>${R}               Max discussion rounds (default: 10)`,
+    `    ${Y}aicli join --human${R}             Join as a human participant`,
+    `    ${Y}aicli hub --presets${R}            List available role presets`,
+    "",
+    `${B}${C}  \u25A0 REPL COMMANDS (inside aicli)${R}`,
+    `    ${M}/help${R}                          Full command list`,
+    `    ${M}/provider${R} ${M}/model${R}                Switch provider or model on the fly`,
+    `    ${M}/plan${R}                          Enter read-only planning mode`,
+    `    ${M}/think${R}                         Toggle Extended Thinking (deep reasoning)`,
+    `    ${M}/review${R}                        AI code review from git diff`,
+    `    ${M}/test${R}                          Run tests with structured report`,
+    `    ${M}/init${R}                          Generate AICLI.md for project context`,
+    `    ${M}/search${R}                        Search across all session histories`,
+    `    ${M}/compact${R}                       Compress conversation to save context`,
+    `    ${M}/checkpoint${R} ${M}/fork${R}               Save/restore/fork session state`,
+    `    ${M}/undo${R}                          Undo file operations`,
+    `    ${M}/yolo${R}                          Skip all tool confirmations`,
+    `    ${M}/mcp${R}                           Manage MCP server connections`,
+    `    ${M}/skill${R}                         Manage agent skills`,
+    `    ${M}/memory${R}                        View/edit persistent memory`,
+    `    ${M}/doctor${R}                        Health check (keys, config, MCP)`,
+    "",
+    `${B}${C}  \u25A0 AI TOOLS (Agentic Mode \u2014 AI uses these autonomously)${R}`,
+    `    ${D}bash  read_file  write_file  edit_file  list_dir  grep_files  glob_files${R}`,
+    `    ${D}web_fetch  google_search  run_interactive  run_tests  spawn_agent${R}`,
+    `    ${D}ask_user  write_todos  save_memory  save_last_response  + MCP tools${R}`,
+    "",
+    `${B}${C}  \u25A0 CONFIGURATION${R}`,
+    `    ${D}Config:     ~/.aicli/config.json${R}`,
+    `    ${D}Context:    ~/.aicli/AICLI.md  (global)  |  ./AICLI.md  (project)${R}`,
+    `    ${D}Memory:     ~/.aicli/memory.md${R}`,
+    `    ${D}Skills:     ~/.aicli/skills/*.md${R}`,
+    `    ${D}Commands:   ~/.aicli/commands/*.md${R}`,
+    `    ${D}Sessions:   ~/.aicli/history/*.json${R}`,
+    "",
+    `${B}${C}  \u25A0 QUICK EXAMPLES${R}`,
+    `    ${G}aicli${R}                                          ${D}# start REPL${R}`,
+    `    ${G}aicli --provider claude -m claude-sonnet-4-20250514${R}  ${D}# specific model${R}`,
+    `    ${G}aicli -p "explain this" < main.py${R}              ${D}# headless + file${R}`,
+    `    ${G}aicli web --host 0.0.0.0${R}                       ${D}# Web UI on LAN${R}`,
+    `    ${G}aicli hub --preset brainstorm "idea"${R}            ${D}# multi-agent brainstorm${R}`,
+    `    ${G}aicli hub -c spec.md -c api.md "build it"${R}       ${D}# hub + docs context${R}`,
+    "",
+    `${D}  Docs: https://github.com/jinzhengdong/ai-cli${R}`,
+    `${D}  Issues: https://github.com/jinzhengdong/ai-cli/issues${R}`,
+    ""
+  ];
+  console.log(lines.join("\n"));
+});
+program.command("hub [topic]").description("Start multi-agent hub (discuss / brainstorm with multiple AI roles)").option("--preset <name>", "Use a built-in role preset (default: tech-review)").option("--roles <file>", "Load roles from a JSON file").option("--provider <name>", "Override default AI provider").option("-m, --model <name>", "Override default model").option("--max-rounds <n>", "Max discussion rounds (default: 10)").option("--presets", "List available role presets").option("-c, --context <file>", "Inject context document (repeatable: -c a.md -c b.md)", (val, prev) => prev.concat(val), []).option("--distributed", "Start WebSocket server so remote aicli instances can join as agents").option("--port <n>", "WebSocket port for distributed mode (default: 9527)", "9527").action(async (topic, options) => {
   const config = new ConfigManager();
   const registry = new ProviderRegistry();
   await registry.initialize(
@@ -5659,7 +5758,7 @@ program.command("hub [topic]").description("Start multi-agent hub (discuss / bra
       model: options.model,
       maxRounds: options.maxRounds ? parseInt(options.maxRounds, 10) : void 0,
       listPresets: options.presets === true,
-      contextFiles: options.context,
+      contextFiles: options.context?.length ? options.context : void 0,
       distributed: options.distributed === true,
       port: options.port ? parseInt(options.port, 10) : void 0
     },

package/dist/{run-tests-F5ZKAP6K.js → run-tests-AYU7S4EG.js}

@@ -1,7 +1,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-YYZEZ6BO.js";
+} from "./chunk-U7YCERTR.js";
 export {
   executeTests,
   runTestsTool

package/dist/{run-tests-5F4IFT5H.js → run-tests-PGGAA5PE.js}

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

package/dist/{server-AXKGLNOI.js → server-2MJUVLUU.js}

@@ -27,7 +27,7 @@ import {
   spawnAgentContext,
   truncateOutput,
   undoStack
-} from "./chunk-6YBF647F.js";
+} from "./chunk-RS5ALOXF.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   CONTEXT_FILE_CANDIDATES,
@@ -39,7 +39,7 @@ import {
   PLAN_MODE_SYSTEM_ADDON,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-HUQVG74X.js";
+} from "./chunk-OQK3WSFD.js";
 import {
   AuthManager
 } from "./chunk-CPLT6CD3.js";
@@ -1438,7 +1438,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-5F4IFT5H.js");
+          const { executeTests } = await import("./run-tests-PGGAA5PE.js");
           const argStr = args.join(" ").trim();
           let testArgs = {};
           if (argStr) {

package/package.json

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