@armadra/agent 0.5.0 → 0.6.0

package/dist/cli/bootstrap.js

@@ -19,13 +19,17 @@ import { loadHookConfigs } from "../hooks/config.js";
 import { HookDispatcher } from "../hooks/dispatcher.js";
 import { AgentEventBus, createHostApi } from "../host/api-impl.js";
 import { activateHost, disposeHost } from "../host/loader.js";
-import { HELP_TEXT, parseArgs, UsageError } from "./args.js";
+import { helpText, parseArgs, UsageError } from "./args.js";
 import { applyFromOption } from "./from-prompt.js";
 import { ExitCode } from "./exit-codes.js";
 import { applyProfile, applyToolFilters, decideMode, defaultSendUser, instructionSources, resolveModel, sessionRequestOf, sourceOf, step, thinkingOf, toStartupError, } from "./startup-steps.js";
 import { resolveSystemPromptArg } from "./system-prompt-arg.js";
+import { memoryEnvOverride, resolveMemory } from "./compose-memory.js";
+import { msg, resolveLocale, setLocale } from "../i18n/index.js";
 /** §11.1 第 3–14 步。 */
 export async function bootstrap(argsIn, deps, io) {
+    // 文案按调用时的语言取（第 9 步可能按 profile / 项目级 ui.language 补定语言）
+    const m = () => msg().cli.bootstrap;
     const warnings = [];
     const warn = (message) => {
         warnings.push(message);
@@ -43,13 +47,13 @@ export async function bootstrap(argsIn, deps, io) {
     const mode = decideMode(args, io);
     const interactive = mode === "interactive" || mode === "line";
     // 5. 目录
-    const paths = await step(ExitCode.Config, "目录", () => {
+    const paths = await step(ExitCode.Config, m().steps.dirs, () => {
         const resolved = resolvePaths({ env: io.env, cwd: io.cwd, sessionDirFlag: args.sessionDir });
         ensurePaths(resolved);
         return resolved;
     });
     // 6. 用户级 + profile.config
-    const base = await step(ExitCode.Config, "配置", () => {
+    const base = await step(ExitCode.Config, m().steps.config, () => {
         const user = loadConfigFile("config", userFile(paths, CONFIG_FILE));
         if (user !== undefined)
             warnings.push(...user.warnings);
@@ -63,27 +67,27 @@ export async function bootstrap(argsIn, deps, io) {
     let request = sessionRequestOf(args);
     if (request === "pick") {
         if (!interactive || deps.ui?.pickSession === undefined || deps.sessions.list === undefined) {
-            throw new UsageError("--resume 在非交互模式下需要会话 id");
+            throw new UsageError(m().resumeNeedsId);
         }
-        const items = await step(ExitCode.Session, "会话列表", () => deps.sessions.list?.({ sessionDir: paths.sessionDir, cwd: paths.cwd }) ?? []);
+        const items = await step(ExitCode.Session, m().steps.sessionList, () => deps.sessions.list?.({ sessionDir: paths.sessionDir, cwd: paths.cwd }) ?? []);
         const id = await deps.ui.pickSession(items);
         if (id === undefined)
-            throw new StartupError("session_not_found", "未选择会话", ExitCode.Session);
+            throw new StartupError("session_not_found", m().noSessionPicked, ExitCode.Session);
         request = { kind: "resume", id };
     }
     const sessionRequest = request;
-    const sessionManager = await step(ExitCode.Session, "会话", () => deps.sessions.open(sessionRequest, { sessionDir: paths.sessionDir, cwd: paths.cwd }));
+    const sessionManager = await step(ExitCode.Session, m().steps.session, () => deps.sessions.open(sessionRequest, { sessionDir: paths.sessionDir, cwd: paths.cwd }));
     let sessionCwd = sessionManager.cwd;
     if (!existsSync(sessionCwd)) {
         const replacement = interactive ? await deps.ui?.askCwd?.(sessionCwd) : undefined;
         if (replacement === undefined) {
-            throw new StartupError("session_corrupt", `会话的工作目录不存在：${sessionCwd}`, ExitCode.Session);
+            throw new StartupError("session_corrupt", m().sessionCwdMissing(sessionCwd), ExitCode.Session);
         }
         sessionCwd = resolve(replacement);
     }
     const runtimePaths = { ...paths, cwd: sessionCwd };
     // 8. 信任（以会话 cwd 为准）
-    const trust = await step(ExitCode.Config, "信任", () => decideTrust({
+    const trust = await step(ExitCode.Config, m().steps.trust, () => decideTrust({
         cwd: sessionCwd,
         configDir: paths.configDir,
         flag: args.trust,
@@ -92,7 +96,7 @@ export async function bootstrap(argsIn, deps, io) {
         prompt: deps.ui?.promptTrust,
     }));
     // 9. 项目级配置（只能收紧）+ 命令行
-    const merged = await step(ExitCode.Config, "项目配置", () => {
+    const merged = await step(ExitCode.Config, m().steps.projectConfig, () => {
         const project = loadConfigFile("config", projectFile(sessionCwd, CONFIG_FILE));
         if (project !== undefined)
             warnings.push(...project.warnings);
@@ -105,16 +109,21 @@ export async function bootstrap(argsIn, deps, io) {
             tuiMode: args.tuiMode,
             toolsPreset: args.toolsPreset,
             codemode: args.codemode,
+            memory: args.memory ?? memoryEnvOverride(io.env),
         });
     });
     warnings.push(...merged.warnings);
     const config = merged.config;
+    // [W6-C0] main.ts 只看了用户级；profile 的 language 与合并后的 ui.language 在这里补定（AMA_LANG / --lang 仍优先）
+    const language = profile?.language ?? config.ui?.language;
+    if (language === "zh" || language === "en")
+        setLocale(resolveLocale(io.env, { language }, args.lang));
     // 10. 资源发现
     const context = findContextFiles({ cwd: sessionCwd, configDir: paths.configDir });
     warnings.push(...context.warnings);
     const discovered = deps.resources === undefined
         ? { skills: [], prompts: [], warnings: [] }
-        : await step(ExitCode.Config, "Skill 发现", () => deps.resources?.discover({
+        : await step(ExitCode.Config, m().steps.skillDiscovery, () => deps.resources?.discover({
             cwd: sessionCwd,
             configDir: paths.configDir,
             trusted: trust.trusted,
@@ -139,7 +148,7 @@ export async function bootstrap(argsIn, deps, io) {
         instructions,
     };
     // 11. 供应商与模型
-    const providers = await step(ExitCode.Config, "供应商", () => deps.providers.create({
+    const providers = await step(ExitCode.Config, m().steps.providers, () => deps.providers.create({
         config,
         cwd: sessionCwd,
         authFile: args.authFile !== undefined
@@ -157,18 +166,25 @@ export async function bootstrap(argsIn, deps, io) {
             }
             : {}),
     }));
-    const { model, provider } = await step(ExitCode.NoModel, "模型", () => resolveModel(args, providers, sessionManager, config.defaultModel, deps, interactive, io.env));
+    const { model, provider } = await step(ExitCode.NoModel, m().steps.model, () => resolveModel(args, providers, sessionManager, config.defaultModel, deps, interactive, io.env));
     const thinkingLevel = thinkingOf(args, sessionManager, config.thinkingLevel);
     // 12. 工具注册表
-    const tools = await step(ExitCode.RuntimeError, "工具", () => deps.tools.create({
+    const tools = await step(ExitCode.RuntimeError, m().steps.tools, () => deps.tools.create({
         config,
         cwd: sessionCwd,
         mode,
         paths: { configDir: paths.configDir, dataDir: paths.dataDir },
+        memory: resolveMemory({
+            config,
+            cwd: sessionCwd,
+            dataDir: paths.dataDir,
+            trusted: trust.trusted,
+            embedded: profile,
+        }),
     }));
     for (const name of config.tools?.disabled ?? []) {
         if (tools.get(name) === undefined)
-            warn(`config tools.disabled：未知工具 ${name}，已忽略`);
+            warn(m().unknownDisabledTool(name));
         else
             tools.disable(name);
     }
@@ -176,7 +192,7 @@ export async function bootstrap(argsIn, deps, io) {
     let session;
     const events = new AgentEventBus((level, message, detail) => {
         if (level === "warn" || level === "error")
-            warn(`${message}${detail instanceof Error ? `：${detail.message}` : ""}`);
+            warn(m().eventWarning(message, detail instanceof Error ? detail.message : undefined));
     });
     const binding = createHostApi({
         mode,
@@ -191,7 +207,7 @@ export async function bootstrap(argsIn, deps, io) {
         bus: events,
         sendUser: (text, origin) => {
             if (session === undefined)
-                return Promise.reject(new AmaError("busy", "会话尚未就绪"));
+                return Promise.reject(new AmaError("busy", m().sessionNotReady));
             return (deps.sendUser ?? defaultSendUser)(session, text, origin);
         },
         stderr: io.stderr,
@@ -200,7 +216,7 @@ export async function bootstrap(argsIn, deps, io) {
     const hostSpec = args.host;
     let host;
     if (hostSpec !== undefined) {
-        host = await step(ExitCode.HostOrHook, "宿主适配器", () => activateHost({ module: hostSpec, binding, cwd: io.cwd }));
+        host = await step(ExitCode.HostOrHook, m().steps.host, () => activateHost({ module: hostSpec, binding, cwd: io.cwd }));
     }
     let shutdown;
     try {
@@ -209,7 +225,7 @@ export async function bootstrap(argsIn, deps, io) {
         const unattended = mode === "print";
         const builtinDeny = config.permission?.builtinDeny;
         const autoSafeCommands = config.permission?.autoSafeCommands;
-        const permission = await step(ExitCode.Config, "权限", () => deps.permissions.create({
+        const permission = await step(ExitCode.Config, m().steps.permission, () => deps.permissions.create({
             mode: config.permission?.mode ?? "default",
             rules: merged.ruleSpecs,
             unattended,
@@ -285,14 +301,14 @@ export async function bootstrap(argsIn, deps, io) {
             overrides.systemPrompt = systemPrompt;
         if (Object.keys(overrides).length > 0)
             assembly.overrides = overrides;
-        session = await step(ExitCode.RuntimeError, "会话组装", () => deps.session.create(assembly));
+        session = await step(ExitCode.RuntimeError, m().steps.assembly, () => deps.session.create(assembly));
         const active = session;
         let disposed;
         shutdown = (reason) => {
             disposed ??= (async () => {
                 await events.emit("session_shutdown", {});
                 await hooks.run("SessionEnd", { reason }).catch(() => undefined);
-                await disposeHost(host, (e) => warn(`宿主适配器 dispose 失败：${String(e)}`));
+                await disposeHost(host, (e) => warn(m().hostDisposeFailed(String(e))));
                 // 会话被替换过时 dispose 当前那个（旧会话由替换方负责）
                 await (session ?? active).dispose();
             })();
@@ -306,14 +322,18 @@ export async function bootstrap(argsIn, deps, io) {
         });
         const outcome = await hooks.run("SessionStart", { source });
         if (outcome.decision === "block") {
-            throw new StartupError("hook_failed", `SessionStart Hook 阻止启动：${outcome.reason ?? "（无原因）"}`, ExitCode.HostOrHook);
+            throw new StartupError("hook_failed", m().sessionStartBlocked(outcome.reason), ExitCode.HostOrHook);
         }
         sessionStartContext = outcome.additionalContext;
         const finalShutdown = shutdown;
         return {
             mode,
             paths: runtimePaths,
-            config,
+            // [W6-S] /config 换配置：getter 跟随 assembly.config（/new 组装会话读它）
+            get config() {
+                return assembly.config;
+            },
+            replaceConfig: (next) => void (assembly.config = next),
             trust,
             resources,
             providers,
@@ -340,7 +360,7 @@ export async function bootstrap(argsIn, deps, io) {
             await shutdown("exit").catch(() => undefined);
         else
             await disposeHost(host);
-        throw toStartupError(error, ExitCode.RuntimeError, "启动");
+        throw toStartupError(error, ExitCode.RuntimeError, m().steps.startup);
     }
 }
 /** 非交互模式接管 stdout：console.log / info / debug 改写到 stderr；返回还原函数。 */
@@ -362,14 +382,14 @@ export async function runCli(argv, deps, io) {
     try {
         const parsed = parseArgs(argv);
         if (parsed.kind !== "run")
-            throw new UsageError("子命令应由 main 分派");
+            throw new UsageError(msg().cli.bootstrap.subcommandNotDispatched);
         args = parsed.args;
     }
     catch (error) {
         return reportError(error, io);
     }
     if (args.help) {
-        io.stdout(HELP_TEXT);
+        io.stdout(helpText());
         return ExitCode.Ok;
     }
     // [W5-E] --mode acp：装配同 rpc（宿主看到的 mode 也是 rpc），分派到 ACP 服务端
@@ -377,7 +397,7 @@ export async function runCli(argv, deps, io) {
     if (acp)
         args = { ...args, mode: "rpc" };
     if (deps === undefined) {
-        io.stderr("ama: 运行时尚未装配（集成批次通过 registerRuntimeDeps 注入实现）\n");
+        io.stderr(msg().cli.bootstrap.runtimeNotAssembled);
         return ExitCode.RuntimeError;
     }
     let runtime;
@@ -392,7 +412,7 @@ export async function runCli(argv, deps, io) {
     try {
         if (runtime.mode !== "interactive")
             for (const w of runtime.warnings)
-                io.stderr(`ama: 警告：${w}\n`);
+                io.stderr(msg().cli.bootstrap.warning(w));
         // [W4-D] --from：旧会话的一条用户消息作提示（-p 时连图片，临时文件在 finally 删除）。
         const from = applyFromOption(args, runtime, io);
         cleanupFrom = from.cleanup;
@@ -401,7 +421,9 @@ export async function runCli(argv, deps, io) {
             ? (await import("../modes/acp/acp-mode.js")).runAcpMode
             : deps.modes[runtime.mode];
         if (runner === undefined)
-            throw new AmaError("not_implemented", `模式 ${runtime.mode} 尚未装配`, { exitCode: 1 });
+            throw new AmaError("not_implemented", msg().cli.bootstrap.modeNotAssembled(runtime.mode), {
+                exitCode: 1,
+            });
         try {
             return await runner(runtime, context);
         }
@@ -409,7 +431,7 @@ export async function runCli(argv, deps, io) {
             const line = deps.modes.line;
             if (runtime.mode !== "interactive" || !isTerminalInitError(error) || line === undefined)
                 throw error;
-            io.stderr(`ama: 警告：终端初始化失败，降级为行式界面（${error.message}）\n`);
+            io.stderr(msg().cli.bootstrap.terminalFallback(error.message));
             return await line(runtime, context);
         }
     }
@@ -424,7 +446,7 @@ export async function runCli(argv, deps, io) {
 }
 export function reportError(error, io, fallback = ExitCode.RuntimeError) {
     if (error instanceof UsageError) {
-        io.stderr(`ama: ${error.message}\n（ama --help 查看用法）\n`);
+        io.stderr(msg().cli.bootstrap.usageError(error.message));
         return ExitCode.Usage;
     }
     const message = error instanceof Error ? error.message : String(error);

package/dist/cli/choice-prompt.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CLI 子命令的方向键选择（零依赖）：TTY 下 raw mode 画一个编号选项列表，原地重画。
+ *
+ * - 按键：↑↓（与 Ctrl+P / Ctrl+N）移动、Enter 确认、数字直选、选项按键提示里的单个字母直选（`y` / `n`），
+ *   Esc / Ctrl+C / stdin 结束 = 取消；
+ * - 结束后把列表收成一行「? 问题 答案」，恢复 raw 状态与光标，暂停 stdin；进程意外退出时也恢复；
+ * - 颜色与字形按环境：`NO_COLOR` / 非 TTY 输出无色，`AMA_ASCII` / 区域设置决定 ASCII 字形（字形表见
+ *   docs/tui-design.md §2.2）；
+ * - 输入不是可开 raw 的 TTY（管道、CI）时 {@link confirmContinue} 回落为原来的文本 `[y/N]` 问答。
+ */
+export interface ChoiceInput {
+    isTTY?: boolean;
+    isRaw?: boolean;
+    setRawMode?(raw: boolean): unknown;
+    on(event: "data" | "end", listener: (chunk?: Buffer | string) => void): unknown;
+    off(event: "data" | "end", listener: (chunk?: Buffer | string) => void): unknown;
+    resume?(): unknown;
+    pause?(): unknown;
+}
+export interface ChoiceOption {
+    label: string;
+    /** 右侧按键提示（空格分隔）；其中的单个字母同时是直选键。 */
+    keys?: string;
+}
+export interface PromptChoiceOptions {
+    question: string;
+    options: readonly ChoiceOption[];
+    /** 缺省选中的下标。 */
+    selected?: number;
+    /** 缺省 `process.stdin`。 */
+    input?: ChoiceInput;
+    /** 缺省写 stderr。 */
+    write?(text: string): void;
+    env?: NodeJS.ProcessEnv;
+    /** 输出是否 TTY（决定颜色）；缺省看 stderr。 */
+    outputIsTTY?: boolean;
+}
+/** 能否用方向键选择：输入是 TTY 且能开 raw。 */
+export declare function canPromptChoice(input?: ChoiceInput): boolean;
+/** 一块输入切成单个按键（转义序列整体、其余逐字符）。 */
+export declare function splitKeys(data: string): string[];
+/** 方向键选择：返回选中的下标，取消返回 undefined。调用方先用 {@link canPromptChoice} 判断。 */
+export declare function promptChoice(options: PromptChoiceOptions): Promise<number | undefined>;
+export interface ConfirmOptions {
+    /** 缺省「继续？」。 */
+    question?: string;
+    input?: ChoiceInput & NodeJS.ReadableStream;
+    write?(text: string): void;
+    /** 文本回落时问句写到哪里，缺省 stderr。 */
+    output?: NodeJS.WritableStream;
+    env?: NodeJS.ProcessEnv;
+    outputIsTTY?: boolean;
+}
+/**
+ * 计费 / 写入前的确认：TTY 下方向键选择「继续 / 取消」（缺省取消，`y` / `n` 直选）；
+ * 否则回落为文本 `继续？[y/N]`（只有 y / yes 算同意）。
+ */
+export declare function confirmContinue(options?: ConfirmOptions): Promise<boolean>;

package/dist/cli/choice-prompt.js

@@ -0,0 +1,142 @@
+/**
+ * CLI 子命令的方向键选择（零依赖）：TTY 下 raw mode 画一个编号选项列表，原地重画。
+ *
+ * - 按键：↑↓（与 Ctrl+P / Ctrl+N）移动、Enter 确认、数字直选、选项按键提示里的单个字母直选（`y` / `n`），
+ *   Esc / Ctrl+C / stdin 结束 = 取消；
+ * - 结束后把列表收成一行「? 问题 答案」，恢复 raw 状态与光标，暂停 stdin；进程意外退出时也恢复；
+ * - 颜色与字形按环境：`NO_COLOR` / 非 TTY 输出无色，`AMA_ASCII` / 区域设置决定 ASCII 字形（字形表见
+ *   docs/tui-design.md §2.2）；
+ * - 输入不是可开 raw 的 TTY（管道、CI）时 {@link confirmContinue} 回落为原来的文本 `[y/N]` 问答。
+ */
+import { createInterface } from "node:readline/promises";
+import { createTheme, defaultKeybindings, detectCapabilities, padToWidth, resolveAscii, visibleWidth, } from "../tui.js";
+import { msg } from "../i18n/index.js";
+const HIDE_CURSOR = "\x1b[?25l";
+const SHOW_CURSOR = "\x1b[?25h";
+/** 能否用方向键选择：输入是 TTY 且能开 raw。 */
+export function canPromptChoice(input = process.stdin) {
+    return input.isTTY === true && typeof input.setRawMode === "function";
+}
+/** 一块输入切成单个按键（转义序列整体、其余逐字符）。 */
+export function splitKeys(data) {
+    return data.match(/\x1b\[[0-9;?]*[ -/]*[@-~]|\x1bO[A-Za-z]|\x1b(?![[O])|[\s\S]/gu) ?? [];
+}
+/** 方向键选择：返回选中的下标，取消返回 undefined。调用方先用 {@link canPromptChoice} 判断。 */
+export function promptChoice(options) {
+    const input = options.input ?? process.stdin;
+    const write = options.write ?? ((text) => void process.stderr.write(text));
+    const env = options.env ?? process.env;
+    const theme = createTheme("dark", {
+        caps: detectCapabilities(env, options.outputIsTTY ?? process.stderr.isTTY === true),
+        ascii: resolveAscii(undefined, env),
+    });
+    const g = theme.glyphs;
+    const items = options.options;
+    const n = items.length;
+    let selected = Math.max(0, Math.min(n - 1, options.selected ?? 0));
+    let drawn = 0;
+    const keyWidth = Math.max(0, ...items.map((o) => (o.keys ?? "").length));
+    const labelWidth = Math.max(...items.map((o) => visibleWidth(o.label)));
+    const question = `${theme.fg("accent", "?")} ${theme.bold(options.question)}`;
+    const frame = () => [
+        question,
+        ...items.map((item, i) => {
+            const on = i === selected;
+            const left = `${on ? g.prompt : " "} ${i + 1}. ${padToWidth(item.label, labelWidth)}`;
+            const keys = item.keys === undefined ? "" : `  ${theme.fg("dim", item.keys.padEnd(keyWidth))}`;
+            return (on ? theme.fg("accent", theme.bold(left)) : left) + keys;
+        }),
+        theme.fg("dim", msg().cli.choicePrompt.hint(`${g.arrowUp}${g.arrowDown}`, n)),
+    ];
+    const draw = (lines) => {
+        const up = drawn > 0 ? `\x1b[${drawn}A` : "";
+        write(`${up}\r\x1b[J${lines.join("\n")}\n`);
+        drawn = lines.length;
+    };
+    return new Promise((resolve) => {
+        const wasRaw = input.isRaw === true;
+        let done = false;
+        const restore = () => {
+            input.setRawMode?.(wasRaw);
+            write(SHOW_CURSOR);
+        };
+        const finish = (index) => {
+            if (done)
+                return;
+            done = true;
+            input.off("data", onData);
+            input.off("end", onEnd);
+            process.off("exit", restore);
+            const answer = index === undefined ? msg().cli.choicePrompt.cancelled : items[index].label;
+            draw([`${question} ${theme.fg("dim", answer)}`]);
+            restore();
+            input.pause?.();
+            resolve(index);
+        };
+        const onKey = (key) => {
+            const letter = /^[a-z]$/i.test(key) ? key.toLowerCase() : "";
+            const byLetter = letter === "" ? -1 : items.findIndex((o) => (o.keys ?? "").split(/\s+/).includes(letter));
+            if (byLetter !== -1)
+                return finish(byLetter);
+            if (defaultKeybindings.matches(key, "tui.select.cancel"))
+                return finish(undefined);
+            if (/^[1-9]$/.test(key) && Number(key) <= n)
+                return finish(Number(key) - 1);
+            if (key === "\r" || key === "\n")
+                return finish(selected);
+            if (defaultKeybindings.matches(key, "tui.select.up"))
+                selected = (selected + n - 1) % n;
+            else if (defaultKeybindings.matches(key, "tui.select.down"))
+                selected = (selected + 1) % n;
+            else
+                return;
+            draw(frame());
+        };
+        const onData = (chunk) => {
+            for (const key of splitKeys(String(chunk ?? ""))) {
+                if (done)
+                    return;
+                onKey(key);
+            }
+        };
+        const onEnd = () => finish(undefined);
+        process.once("exit", restore);
+        input.setRawMode?.(true);
+        write(HIDE_CURSOR);
+        draw(frame());
+        input.on("data", onData);
+        input.on("end", onEnd);
+        input.resume?.();
+    });
+}
+/**
+ * 计费 / 写入前的确认：TTY 下方向键选择「继续 / 取消」（缺省取消，`y` / `n` 直选）；
+ * 否则回落为文本 `继续？[y/N]`（只有 y / yes 算同意）。
+ */
+export async function confirmContinue(options = {}) {
+    const m = msg().cli.choicePrompt;
+    const question = options.question ?? m.continueQuestion;
+    const input = options.input ?? process.stdin;
+    if (canPromptChoice(input)) {
+        const index = await promptChoice({
+            question,
+            options: [
+                { label: m.continue, keys: "y" },
+                { label: m.cancel, keys: "n Esc" },
+            ],
+            selected: 1,
+            input,
+            ...(options.write !== undefined ? { write: options.write } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+            ...(options.outputIsTTY !== undefined ? { outputIsTTY: options.outputIsTTY } : {}),
+        });
+        return index === 0;
+    }
+    const rl = createInterface({ input, output: options.output ?? process.stderr });
+    try {
+        return /^y(es)?$/i.test((await rl.question(m.textQuestion(question))).trim());
+    }
+    finally {
+        rl.close();
+    }
+}

package/dist/cli/codemode-notice.js

@@ -11,6 +11,7 @@
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { resolveCodemodeMode } from "../tools/presets.js";
+import { msg } from "../i18n/index.js";
 export const NOTICES_FILE = "notices.json";
 const KEY = "codemodeNonStrictDefault";
 function readNotices(path) {
@@ -30,8 +31,7 @@ function readNotices(path) {
     return { version: 1 };
 }
 export function codemodeNoticeText(capability) {
-    return (`Node ${capability.nodeMajor} < 25 且没有可用的操作系统沙箱：codemode 沙箱的网络未隔离，codemode 缺省关闭；` +
-        "用 `--codemode on` 或 config 的 codemode.mode 开启（每个配置目录只提示一次）");
+    return msg().cli.codemodeNotice(capability.nodeMajor);
 }
 /** 需要提示时返回文案并记下（之后同一配置目录不再提示）；不需要时 undefined。 */
 export function takeCodemodeNotice(input) {

package/dist/cli/compose-agents.js

@@ -18,6 +18,7 @@ import { agentSources, discoverAgents } from "../agents/discover.js";
 import { NO_AGENT_PROBE_ENV, SessionExternalAgents, registerExternalAgents, } from "../agents/external.js";
 import { hostRunnersOf } from "../host/api-impl.js";
 import { bindTaskAgents } from "../tools/task.js";
+import { msg } from "../i18n/index.js";
 /** 同一装配材料只提示一次（`/new` 等会重新装配会话）。 */
 const warned = new WeakSet();
 export function loadAgentCatalog(deps) {
@@ -33,7 +34,7 @@ export function loadAgentCatalog(deps) {
         for (const warning of found.warnings)
             assembly.warn(warning);
         for (const dir of found.skippedUntrusted)
-            assembly.warn(`项目未信任，跳过子 Agent 定义目录 ${dir}（--trust 后生效）`);
+            assembly.warn(msg().cli.composeAgents.untrustedAgentDir(dir));
     }
     return new AgentCatalog(found.agents);
 }

package/dist/cli/compose-extensions.js

@@ -19,6 +19,7 @@
  * 配置从 `deps.assembly.config` 读（键与校验已在 config/schema-w5.ts，C0 统一加好）。
  */
 import { telemetryFactory } from "../agent/session-telemetry.js";
+import { traceWriterFactory } from "../agent/session-trace-writer.js";
 import { createImageBudgetExtension } from "../agent/session-images.js";
 import { createLimitsExtension } from "../agent/limits.js";
 import { createRemindersExtension, remindersSettings } from "../agent/reminders.js";
@@ -37,6 +38,7 @@ export function composeExtensions(deps) {
         ({ core }) => createImageBudgetExtension(core),
         // [W5-A]  createTelemetryExtension(...)
         telemetryFactory(deps.assembly.config.ui),
+        traceWriterFactory(), // [W6-C0] ama.trace（主会话与子会话都写）
         // [W5-E] 外部 Agent 记账 → SessionStats.external（只主会话）
         ({ core }) => core.depth > 0 ? undefined : createExternalStatsExtension(() => core.manager.branch()),
         createSubagentsFactory(deps), // [W5-G] 子 Agent 任务注册表

package/dist/cli/compose-memory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 记忆的组装（docs/wave6-plan.md §3、D8、D9、D11、D12）。[W6-M]
+ *
+ * - 开关：独立终端看合并后的 `memory.enabled`（用户级 / profile.config；项目级只能设 false；`--memory` /
+ *   `--no-memory`；`AMA_MEMORY=0|1` 经 bootstrap 并入命令行覆盖，命令行优先）。缺省关闭：不建运行期、不读盘、
+ *   不注册工具、不渲染节。
+ * - 嵌入宿主（有 profile；SDK `createAgentSession`）：只看 `profile.memory = { enabled, dir }`，作用域只有
+ *   `workspace`（= dir），不读用户级；合并配置里显式 `memory.enabled: false`（项目级、`--no-memory`、
+ *   `AMA_MEMORY=0`）仍可关掉。
+ * - 项目作用域要求项目已受信任，否则跳过（`/memory` 提示）。
+ * - 系统节：会话开始（新会话）渲染一次；resume / fork 沿用会话里已有的 `memory` 节；压缩结束后重渲染
+ *   （`compaction_end` 时 `updateSystem`，压缩本就是前缀重置点）；`/memory reload` 显式重渲染。
+ */
+import type { AgentSessionImpl } from "../agent/session.js";
+import type { AgentSession } from "../agent/types.js";
+import type { AmaConfig, ProfileMemoryOptions } from "../config/types.js";
+import { MemoryRuntime } from "../memory/runtime.js";
+import type { SessionManager } from "../session/manager.js";
+/** `AMA_MEMORY=0|1`（也认 true / false / on / off）；其它值或未设 → undefined。 */
+export declare function memoryEnvOverride(env: Readonly<Record<string, string | undefined>>): boolean | undefined;
+export interface MemorySetupInput {
+    config: Pick<AmaConfig, "memory">;
+    cwd: string;
+    dataDir: string;
+    trusted: boolean;
+    /** 嵌入宿主：profile 存在（或 SDK 会话）时给出（`memory` 可缺省 = 禁用）。 */
+    embedded?: {
+        memory?: ProfileMemoryOptions | undefined;
+    } | undefined;
+    today?(): string;
+}
+/** 按配置建运行期；关闭时返回 undefined（什么都不做）。 */
+export declare function resolveMemory(input: MemorySetupInput): MemoryRuntime | undefined;
+/** 会话的记忆运行期（未开启 → undefined）。 */
+export declare function memoryOf(session: AgentSession): MemoryRuntime | undefined;
+/**
+ * 新会话渲染当前索引；会话里已有 system 状态（resume / fork）时沿用其中的 `memory` 节（可能没有）。
+ * 未开启 → undefined。
+ */
+export declare function initialMemorySection(runtime: MemoryRuntime | undefined, manager: Pick<SessionManager, "branch">): string | undefined;
+/** 把 `memory` 节并进静态系统输入（未开启时原样返回同一对象，字节不变）。 */
+export declare function withMemorySection<T extends {
+    memory?: string;
+}>(system: T, runtime: MemoryRuntime | undefined, manager: Pick<SessionManager, "branch">): T;
+/** 会话建好后：登记运行期，压缩结束后重渲染 `memory` 节。 */
+export declare function attachMemory(session: AgentSessionImpl, runtime: MemoryRuntime | undefined): void;
+/**
+ * `/memory reload`：按磁盘重渲染 `memory` 节。返回 undefined = 会话未开启记忆；`changed` = 节有变化
+ * （下次请求产生一条 system 补丁，缓存前缀断一次）。
+ */
+export declare function reloadMemorySection(session: AgentSession): {
+    changed: boolean;
+} | undefined;