@ai-zen/cli 0.9.0 → 1.0.0-alpha.10

package/dist/hook.js

@@ -1,8 +1,13 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { promises as fs } from "node:fs";
-const MARKER_START = "# === aiz hook (开始) ===";
-const MARKER_END = "# === aiz hook (结束) ===";
+/** 当前标记（ai hook 时代） */
+const MARKER_START = "# === ai hook (开始) ===";
+const MARKER_END = "# === ai hook (结束) ===";
+/** 历史标记（aiz hook 时代，用于平滑迁移） */
+const LEGACY_BLOCKS = [
+    { start: "# === aiz hook (开始) ===", end: "# === aiz hook (结束) ===" },
+];
 function detectShell() {
     const shell = process.env.SHELL || "";
     const home = homedir();
@@ -15,25 +20,35 @@ function detectShell() {
     return null;
 }
 function hookCode(hookFn) {
-    return [
-        "",
-        MARKER_START,
-        `${hookFn}() {`,
-        '  aiz "$@"',
-        "}",
-        MARKER_END,
-        "",
-    ].join("\n");
+    return ["", MARKER_START, `${hookFn}() {`, '  ai "$@"', "}", MARKER_END, ""].join("\n");
 }
-async function isInstalled(rcFile) {
-    try {
-        await fs.access(rcFile);
-    }
-    catch {
-        return false;
+/**
+ * 移除文件中所有 hook 代码块（含历史 aiz 标记），返回清理后的内容；
+ * `removed` 表示是否确有块被移除。
+ */
+function stripHookBlocks(content) {
+    const blocks = [{ start: MARKER_START, end: MARKER_END }, ...LEGACY_BLOCKS];
+    const lines = content.split("\n");
+    const kept = [];
+    let skipping = false;
+    let removed = false;
+    let matchedAny = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!skipping && blocks.some((b) => b.start === trimmed)) {
+            skipping = true;
+            removed = true;
+            matchedAny = true;
+            continue;
+        }
+        if (skipping && blocks.some((b) => b.end === trimmed)) {
+            skipping = false;
+            continue;
+        }
+        if (!skipping)
+            kept.push(line);
     }
-    const content = await fs.readFile(rcFile, "utf-8");
-    return content.includes(MARKER_START);
+    return { content: kept.join("\n"), removed: matchedAny };
 }
 export async function installHook() {
     const shell = detectShell();
@@ -41,12 +56,24 @@ export async function installHook() {
         console.error("❌ 不支持的 shell（仅支持 bash / zsh）");
         process.exit(1);
     }
-    if (await isInstalled(shell.rcFile)) {
-        console.log("ℹ️  aiz hook 已安装，无需重复操作");
+    let current = "";
+    try {
+        current = await fs.readFile(shell.rcFile, "utf-8");
+    }
+    catch {
+        // 文件不存在：视为空内容
+    }
+    if (current.includes(MARKER_START)) {
+        console.log("ℹ️  ai hook 已安装，无需重复操作");
         return;
     }
-    await fs.appendFile(shell.rcFile, hookCode(shell.hookFn), "utf-8");
-    console.log(`✅ aiz hook 已安装到 ${shell.rcFile}`);
+    // 迁移：先移除历史 aiz 块，再写入新块
+    const { content: cleaned, removed } = stripHookBlocks(current);
+    const base = cleaned.replace(/\n+$/, "");
+    await fs.writeFile(shell.rcFile, base + "\n" + hookCode(shell.hookFn), "utf-8");
+    console.log(`✅ ai hook 已安装到 ${shell.rcFile}`);
+    if (removed)
+        console.log("   （已自动升级旧版 aiz hook）");
     console.log(`   重启终端或执行 source ${shell.rcFile} 即可生效`);
     console.log(`   之后输入不存在的命令会自动转发给 AI 处理`);
 }
@@ -56,35 +83,20 @@ export async function uninstallHook() {
         console.error("❌ 不支持的 shell（仅支持 bash / zsh）");
         process.exit(1);
     }
+    let content;
     try {
-        await fs.access(shell.rcFile);
+        content = await fs.readFile(shell.rcFile, "utf-8");
     }
     catch {
-        console.log("ℹ️  aiz hook 未安装（文件不存在）");
+        console.log("ℹ️  ai hook 未安装（文件不存在）");
         return;
     }
-    const content = await fs.readFile(shell.rcFile, "utf-8");
-    if (!content.includes(MARKER_START)) {
-        console.log("ℹ️  aiz hook 未安装");
+    const { content: cleaned, removed } = stripHookBlocks(content);
+    if (!removed) {
+        console.log("ℹ️  ai hook 未安装");
         return;
     }
-    const lines = content.split("\n");
-    const newLines = [];
-    let skipping = false;
-    for (const line of lines) {
-        if (line.trim() === MARKER_START) {
-            skipping = true;
-            continue;
-        }
-        if (line.trim() === MARKER_END) {
-            skipping = false;
-            continue;
-        }
-        if (!skipping) {
-            newLines.push(line);
-        }
-    }
-    await fs.writeFile(shell.rcFile, newLines.join("\n"), "utf-8");
-    console.log(`✅ aiz hook 已从 ${shell.rcFile} 卸载`);
+    await fs.writeFile(shell.rcFile, cleaned, "utf-8");
+    console.log(`✅ ai hook 已从 ${shell.rcFile} 卸载`);
 }
 //# sourceMappingURL=hook.js.map

package/dist/hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,47 +1,94 @@
 #!/usr/bin/env node
-import chalk from "chalk";
-import { showMainMenu } from "./menus/index.js";
-import { startNewConversation } from "./menus/start-conversation.js";
 import { installHook, uninstallHook } from "./hook.js";
+import { resolveInvocation } from "./mode.js";
+import { runStdio } from "./stdio-runner.js";
+import { CLI_VERSION } from "./version.js";
+// ⚠️ 必须在加载 React/Ink 之前把 NODE_ENV 定为 production。
+//
+// 背景（OOM 根因）：Node 官方分发版没有内置“production” React，react/react-reconciler
+// 的入口用 `process.env.NODE_ENV !== "production"` 决定引用哪个构建。若此变量为空，
+// 就会加载 *development* 版 reconciler —— 它每次渲染都会调用 `performance.measure()`
+// （User Timing API），而 Node 的 performance 条目缓冲**无界且从不逐出**。长时间流式
+// TUI 会话下条目数持续增长，约 55 分钟即把堆顶到 heap_size_limit（本机 ~1GB）触发 OOM。
+//
+// ESM 的静态 `import` 会被提升到模块体之前执行，若此处仍静态 `import "./tui/index.js"`，
+// 则 React 会在本行之前就被求值成 DEV 版。因此对 TUI 入口改用动态 import（见下方 tui 分支）。
+// 用 `||=` 而非 `??=`：空的 NODE_ENV 同样会被 React 视为非 production，需一并纠正。
+process.env.NODE_ENV ||= "production";
 /**
- * CLI 入口
+ * CLI 入口 —— 双模式路由
  *
- * aiz              → 进入交互式主菜单
- * aiz <消息内容>    → 直接进入对话
- * aiz hook install  → 安装 shell 兜底钩子
- * aiz hook uninstall → 卸载 shell 兜底钩子
+ *   ai                      → TUI（仅当无参数且 stdin/stdout 均为 TTY）
+ *   ai <提示词>              → 纯 stdio：结果写 stdout，日志写 stderr
+ *   cat 文件 | ai "总结"      → 纯 stdio：stdin 为内容
+ *   ai hook install         → 安装 shell 兜底钩子
+ *   ai hook uninstall       → 卸载 shell 兜底钩子
+ *   ai --help / --version   → 帮助 / 版本
+ *
+ * 模式判定与参数解析集中在 ./mode.ts（纯函数，单测覆盖），本文件只做分发。
  */
+const HELP_TEXT = `ai — AI-Zen CLI v${CLI_VERSION}
+
+用法:
+  ai                      进入交互式界面（TUI，需 stdin/stdout 为 TTY）
+  ai <提示词>              以纯 stdio 模式提问，结果写入 stdout
+  cat 文件 | ai "总结要点"  通过管道传入内容，参数作为指令
+  ai hook install         安装 shell 兜底钩子（命令不存在时转发给 AI）
+  ai hook uninstall       卸载 shell 兜底钩子
+
+选项:
+  --save                  保存本次对话到存档（默认不落盘）
+  -h, --help              显示本帮助
+  -v, --version           显示版本号
+
+说明:
+  stdio 模式无任何交互，结果走 stdout、日志走 stderr，成功退出码 0。
+`;
 async function main() {
-    const args = process.argv.slice(2);
-    if (args.length === 0) {
-        // 无参数：进入交互式主菜单（循环）
-        while (true) {
-            await showMainMenu();
-        }
-        return;
-    }
-    // 处理 hook 命令
-    if (args[0] === "hook") {
-        const action = args[1];
-        if (action === "install") {
-            installHook();
-        }
-        else if (action === "uninstall") {
-            uninstallHook();
-        }
-        else {
-            console.error("❌ 用法: aiz hook install|uninstall");
-            process.exit(1);
+    const tty = {
+        stdinIsTTY: Boolean(process.stdin.isTTY),
+        stdoutIsTTY: Boolean(process.stdout.isTTY),
+    };
+    const invocation = resolveInvocation(process.argv.slice(2), tty);
+    switch (invocation.kind) {
+        case "help":
+            process.stdout.write(HELP_TEXT);
+            return;
+        case "version":
+            process.stdout.write(`${CLI_VERSION}\n`);
+            return;
+        case "hook":
+            if (invocation.action === "install")
+                await installHook();
+            else if (invocation.action === "uninstall")
+                await uninstallHook();
+            else {
+                process.stderr.write("用法: ai hook install|uninstall\n");
+                process.exitCode = 1;
+            }
+            return;
+        case "stdio":
+            process.exitCode = await runStdio({
+                instruction: invocation.instruction,
+                save: invocation.save,
+            });
+            return;
+        case "tui": {
+            // 无参数且均为 TTY：进入全屏交互界面（Ink）。
+            // 流式统一走 Ink —— 由 `RENDER_OPTIONS.incrementalRendering`（只重绘变化的行）
+            // 压低输出量，SSH / 弱网下实测稳定。
+            //
+            // 动态 import：确保 React/Ink 的求值发生在上方 `process.env.NODE_ENV ||= "production"`
+            // 之后，从而加载 production 版 reconciler（避免 DEV 版 performance.measure 缓冲撑爆堆）。
+            const { runTui } = await import("./tui/index.js");
+            await runTui();
+            return;
         }
-        return;
     }
-    // 有参数且不是 hook 命令：直接进入对话（参数作为初始消息）
-    const message = args.join(" ");
-    console.log(chalk.blue.bold(`\n🤖 快速开始: "${message}"\n`));
-    await startNewConversation(message);
 }
 main().catch((error) => {
-    console.error(chalk.red(`\n❌ 意外错误: ${error.message}\n`));
-    process.exit(1);
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`\n❌ 意外错误: ${message}\n`);
+    process.exitCode = 1;
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;;;;GAOG;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,mBAAmB;QACnB,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;QACD,OAAO;IACT,CAAC;IAED,aAAa;IACb,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,WAAW,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,aAAa,EAAE,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACT,CAAC;IAED,kCAAkC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,OAAO,KAAK,CAAC,CAAC,CAAC;IAC1D,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,iDAAiD;AACjD,EAAE;AACF,qEAAqE;AACrE,gEAAgE;AAChE,uEAAuE;AACvE,+DAA+D;AAC/D,8DAA8D;AAC9D,EAAE;AACF,kEAAkE;AAClE,+DAA+D;AAC/D,gEAAgE;AAChE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AAEtC;;;;;;;;;;;GAWG;AAEH,MAAM,SAAS,GAAG,oBAAoB,WAAW;;;;;;;;;;;;;;;;CAgBhD,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG;QACV,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACxC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;KAC3C,CAAC;IACF,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEjE,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO;QAET,KAAK,SAAS;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,CAAC,CAAC;YACzC,OAAO;QAET,KAAK,MAAM;YACT,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;gBAAE,MAAM,WAAW,EAAE,CAAC;iBACpD,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW;gBAAE,MAAM,aAAa,EAAE,CAAC;iBAC7D,CAAC;gBACJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvB,CAAC;YACD,OAAO;QAET,KAAK,OAAO;YACV,OAAO,CAAC,QAAQ,GAAG,MAAM,QAAQ,CAAC;gBAChC,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,IAAI,EAAE,UAAU,CAAC,IAAI;aACtB,CAAC,CAAC;YACH,OAAO;QAET,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,4BAA4B;YAC5B,gEAAgE;YAChE,uBAAuB;YACvB,EAAE;YACF,0EAA0E;YAC1E,uEAAuE;YACvE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClD,MAAM,MAAM,EAAE,CAAC;YACf,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,OAAO,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/mode.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 运行模式判定与启动参数解析 —— 双模式改造的决策核心
+ *
+ * 最终形态为两种**互不混合**的运行模式（见 TODO §0）：
+ *
+ * | 模式        | 触发条件                                   | 面向对象               |
+ * |-------------|--------------------------------------------|------------------------|
+ * | 纯 stdio    | 带位置参数，或 stdin/stdout 非 TTY          | 脚本、管道、shell 钩子 |
+ * | TUI         | 无参数且 stdin/stdout 均为 TTY              | 人类用户               |
+ *
+ * 本模块为纯函数与纯数据，不触碰 stdin/stdout、不 import chalk 等 UI 依赖，
+ * 便于单测（模式判定与路由是改造中风险最高的逻辑，必须被测覆盖）。
+ */
+/** 运行模式 */
+export type RunMode = "stdio" | "tui";
+/** 终端能力快照（由入口注入，便于测试） */
+export interface TtyState {
+    stdinIsTTY: boolean;
+    stdoutIsTTY: boolean;
+}
+/**
+ * 一次启动要执行的动作（路由结果）。
+ *
+ * 子命令（hook/help/version）与运行模式正交：命中子命令时短路模式判定，
+ * 不进入 stdio/TUI 任一路径。
+ */
+export type Invocation = {
+    kind: "hook";
+    action: "install" | "uninstall" | "usage";
+} | {
+    kind: "help";
+} | {
+    kind: "version";
+} | {
+    kind: "stdio";
+    instruction: string;
+    save: boolean;
+} | {
+    kind: "tui";
+};
+/**
+ * 模式判定（纯函数）。
+ *
+ * - 有位置参数 → stdio（脚本/管道优先，绝不进 TUI）
+ * - 无参数但 stdin 或 stdout 非 TTY → stdio（管道、重定向、CI）
+ * - 无参数且 stdin/stdout 均为 TTY → TUI
+ */
+export declare function decideMode(tty: TtyState, hasArgs: boolean): RunMode;
+/**
+ * 解析 argv 并路由为 `Invocation`。
+ *
+ * 选项在遇到 `--` 之后一律视为位置参数（便于传入以 `-` 开头的提示词）。
+ * 未知的 `-x` 选项不报错，按位置参数处理，避免误伤以 `-` 开头的正常提问。
+ */
+export declare function resolveInvocation(argv: string[], tty: TtyState): Invocation;
+//# sourceMappingURL=mode.d.ts.map

package/dist/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,WAAW;AACX,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtC,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAKpB;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,GAAG,UAAU,CA8C3E"}

package/dist/mode.js

@@ -0,0 +1,83 @@
+/**
+ * 运行模式判定与启动参数解析 —— 双模式改造的决策核心
+ *
+ * 最终形态为两种**互不混合**的运行模式（见 TODO §0）：
+ *
+ * | 模式        | 触发条件                                   | 面向对象               |
+ * |-------------|--------------------------------------------|------------------------|
+ * | 纯 stdio    | 带位置参数，或 stdin/stdout 非 TTY          | 脚本、管道、shell 钩子 |
+ * | TUI         | 无参数且 stdin/stdout 均为 TTY              | 人类用户               |
+ *
+ * 本模块为纯函数与纯数据，不触碰 stdin/stdout、不 import chalk 等 UI 依赖，
+ * 便于单测（模式判定与路由是改造中风险最高的逻辑，必须被测覆盖）。
+ */
+/** shell 兜底钩子的子动作 */
+const HOOK_ACTIONS = new Set(["install", "uninstall"]);
+/**
+ * 模式判定（纯函数）。
+ *
+ * - 有位置参数 → stdio（脚本/管道优先，绝不进 TUI）
+ * - 无参数但 stdin 或 stdout 非 TTY → stdio（管道、重定向、CI）
+ * - 无参数且 stdin/stdout 均为 TTY → TUI
+ */
+export function decideMode(tty, hasArgs) {
+    if (hasArgs)
+        return "stdio";
+    if (!tty.stdinIsTTY || !tty.stdoutIsTTY)
+        return "stdio";
+    return "tui";
+}
+/**
+ * 解析 argv 并路由为 `Invocation`。
+ *
+ * 选项在遇到 `--` 之后一律视为位置参数（便于传入以 `-` 开头的提示词）。
+ * 未知的 `-x` 选项不报错，按位置参数处理，避免误伤以 `-` 开头的正常提问。
+ */
+export function resolveInvocation(argv, tty) {
+    const positional = [];
+    let save = false;
+    let wantHelp = false;
+    let wantVersion = false;
+    let passthrough = false;
+    for (const arg of argv) {
+        if (passthrough) {
+            positional.push(arg);
+            continue;
+        }
+        if (arg === "--") {
+            passthrough = true;
+            continue;
+        }
+        if (arg === "--save") {
+            save = true;
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            wantHelp = true;
+            continue;
+        }
+        if (arg === "--version" || arg === "-v") {
+            wantVersion = true;
+            continue;
+        }
+        positional.push(arg);
+    }
+    // 子命令短路（与运行模式无关的管理动作）
+    if (positional[0] === "hook") {
+        const action = positional[1];
+        return {
+            kind: "hook",
+            action: action && HOOK_ACTIONS.has(action) ? action : "usage",
+        };
+    }
+    if (wantHelp)
+        return { kind: "help" };
+    if (wantVersion)
+        return { kind: "version" };
+    const instruction = positional.join(" ").trim();
+    const mode = decideMode(tty, positional.length > 0);
+    if (mode === "tui")
+        return { kind: "tui" };
+    return { kind: "stdio", instruction, save };
+}
+//# sourceMappingURL=mode.js.map

package/dist/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwBH,qBAAqB;AACrB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,GAAa,EAAE,OAAgB;IACxD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc,EAAE,GAAa;IAC7D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,IAAI,GAAG,IAAI,CAAC;YACZ,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACxC,WAAW,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,sBAAsB;IACtB,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,MAAM,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAkC,CAAC,CAAC,CAAC,OAAO;SAC3F,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtC,IAAI,WAAW;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE5C,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/dist/session-pointer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CLI 会话指针 — 按「工作目录（cwd）」记录各自的「上一轮会话 id」。
+ *
+ * 取代原草稿机制：不再维护单独的单文件草稿（`drafts/_current.json`），
+ * 而是让每个会话直接落盘为 `conversations/<id>.json`，再用本指针记住
+ * 「每个目录最近活动的会话 id」，供下次在该目录启动时自动续接。
+ *
+ * 存储位置：`$AI_ZEN_DIR/cli/last-session.json`，结构为 cwd → 续接记录的 map：
+ *
+ *   {
+ *     "version": 1,
+ *     "sessions": {
+ *       "/abs/path/to/proj-a": { "id": "对话_...", "updatedAt": "..." },
+ *       "/abs/path/to/proj-b": { "id": "对话_...", "updatedAt": "..." }
+ *     }
+ *   }
+ *
+ * 以 `process.cwd()` 的**精确字符串**为键：不同目录各记各的，互不干扰。
+ * 旧版单指针文件（顶层 `{ id, updatedAt }`）无法归属到具体目录，一律视为
+ * 「无记录」——宁可丢一次续接，也不把别的目录的历史错认到当前目录。
+ */
+/** 单个工作目录的续接记录 */
+export interface SessionPointer {
+    /** 上一轮（最近活动）会话 id */
+    id: string;
+    /** 最后活动时间（ISO 字符串） */
+    updatedAt: string;
+}
+/** 读取指定工作目录的「上一轮会话 id」；无记录时返回 null */
+export declare function readLastSession(cwd: string): Promise<SessionPointer | null>;
+/** 更新指定工作目录的「上一轮会话 id」（保留其它目录的记录，原子写） */
+export declare function writeLastSession(cwd: string, id: string): Promise<void>;
+/** 清除指定工作目录的指针（会话被删除等场景使用） */
+export declare function clearLastSession(cwd: string): Promise<void>;
+//# sourceMappingURL=session-pointer.d.ts.map

package/dist/session-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pointer.d.ts","sourceRoot":"","sources":["../src/session-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AA2CD,sCAAsC;AACtC,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAGjF;AAED,yCAAyC;AACzC,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED,8BAA8B;AAC9B,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjE"}

package/dist/session-pointer.js

@@ -0,0 +1,81 @@
+/**
+ * CLI 会话指针 — 按「工作目录（cwd）」记录各自的「上一轮会话 id」。
+ *
+ * 取代原草稿机制：不再维护单独的单文件草稿（`drafts/_current.json`），
+ * 而是让每个会话直接落盘为 `conversations/<id>.json`，再用本指针记住
+ * 「每个目录最近活动的会话 id」，供下次在该目录启动时自动续接。
+ *
+ * 存储位置：`$AI_ZEN_DIR/cli/last-session.json`，结构为 cwd → 续接记录的 map：
+ *
+ *   {
+ *     "version": 1,
+ *     "sessions": {
+ *       "/abs/path/to/proj-a": { "id": "对话_...", "updatedAt": "..." },
+ *       "/abs/path/to/proj-b": { "id": "对话_...", "updatedAt": "..." }
+ *     }
+ *   }
+ *
+ * 以 `process.cwd()` 的**精确字符串**为键：不同目录各记各的，互不干扰。
+ * 旧版单指针文件（顶层 `{ id, updatedAt }`）无法归属到具体目录，一律视为
+ * 「无记录」——宁可丢一次续接，也不把别的目录的历史错认到当前目录。
+ */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+import { CLI_DIR } from "./config.js";
+const POINTER_FILE = join(CLI_DIR, "last-session.json");
+const FILE_VERSION = 1;
+/** 读取整份指针文件；不存在 / 损坏 / 旧版格式时返回空结构 */
+async function readPointerFile() {
+    const empty = { version: FILE_VERSION, sessions: {} };
+    let parsed;
+    try {
+        parsed = JSON.parse(await fs.readFile(POINTER_FILE, "utf-8"));
+    }
+    catch {
+        return empty;
+    }
+    // 仅接受新版 map 结构；旧版单指针（顶层 id）或其它形状一律视为空。
+    if (!parsed || typeof parsed !== "object" || typeof parsed.sessions !== "object" || parsed.sessions === null) {
+        return empty;
+    }
+    const sessions = {};
+    for (const [cwd, entry] of Object.entries(parsed.sessions)) {
+        const e = entry;
+        if (e && typeof e === "object" && typeof e.id === "string" && e.id) {
+            sessions[cwd] = { id: e.id, updatedAt: typeof e.updatedAt === "string" ? e.updatedAt : "" };
+        }
+    }
+    return { version: FILE_VERSION, sessions };
+}
+/** 原子写入整份指针文件（必要时创建目录，tmp + rename 避免半截文件） */
+async function writePointerFile(file) {
+    try {
+        await fs.access(CLI_DIR);
+    }
+    catch {
+        await fs.mkdir(CLI_DIR, { recursive: true });
+    }
+    const tmp = `${POINTER_FILE}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(file, null, 2), "utf-8");
+    await fs.rename(tmp, POINTER_FILE);
+}
+/** 读取指定工作目录的「上一轮会话 id」；无记录时返回 null */
+export async function readLastSession(cwd) {
+    const file = await readPointerFile();
+    return file.sessions[cwd] ?? null;
+}
+/** 更新指定工作目录的「上一轮会话 id」（保留其它目录的记录，原子写） */
+export async function writeLastSession(cwd, id) {
+    const file = await readPointerFile();
+    file.sessions[cwd] = { id, updatedAt: new Date().toISOString() };
+    await writePointerFile(file);
+}
+/** 清除指定工作目录的指针（会话被删除等场景使用） */
+export async function clearLastSession(cwd) {
+    const file = await readPointerFile();
+    if (!(cwd in file.sessions))
+        return;
+    delete file.sessions[cwd];
+    await writePointerFile(file);
+}
+//# sourceMappingURL=session-pointer.js.map

package/dist/session-pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pointer.js","sourceRoot":"","sources":["../src/session-pointer.ts"],"names":[],"mappings":"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"}

package/dist/stdio-runner.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 纯 stdio 模式运行器
+ *
+ * 约定（见 TODO §1）：
+ *   - 不进入交互循环、不显示横幅、不等待任何按键；
+ *   - 仅把**最终 assistant 文本**写入 stdout（零 ANSI、零 emoji 前缀、零 spinner）；
+ *   - 日志 / 进度 / SDK 输出一律走 stderr；
+ *   - 成功退出码 0，失败非 0。
+ *
+ * 该模式不落盘（不写草稿 / 对话存档），仅当显式 `--save` 时保存对话存档。
+ */
+import { AgentNS } from "@ai-zen/agents-core";
+export interface StdioRunOptions {
+    /** 位置参数拼接而成的指令（可空，此时全部内容来自 stdin） */
+    instruction: string;
+    /** 是否保存对话存档（默认 false，不落盘） */
+    save: boolean;
+}
+/**
+ * 读取全部 stdin 文本。
+ * stdin 为 TTY（无管道）或读取失败时返回空串。
+ */
+export declare function readStdin(): Promise<string>;
+/**
+ * 合并「指令 + stdin 内容」（见 TODO §5 开放问题 2：参数为指令、stdin 为内容）。
+ * - 两者都有：`指令\n\n内容`
+ * - 仅其一：取该者
+ */
+export declare function mergePrompt(instruction: string, stdin: string): string;
+/** 从内容块中提取纯文本；非文本块（图片/文件）以占位文本表示 */
+export declare function extractText(content: AgentNS.MessageContent | undefined): string;
+/** 运行一次纯 stdio 对话，返回进程退出码 */
+export declare function runStdio(options: StdioRunOptions): Promise<number>;
+//# sourceMappingURL=stdio-runner.d.ts.map

package/dist/stdio-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-runner.d.ts","sourceRoot":"","sources":["../src/stdio-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAa9C,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;CACf;AAOD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAWjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,GAAG,SAAS,GAAG,MAAM,CAY/E;AAoCD,6BAA6B;AAC7B,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuExE"}