@armadra/agent 0.5.1 → 0.6.1

package/dist/cli/subcommands/config-set.js

@@ -0,0 +1,145 @@
+/**
+ * `ama config get | set | unset | list` (docs/wave6-plan.md §6.4, D24-D26). [W6-S]
+ *
+ * Thin layer over config/edit.ts (the `/config` panel uses the same core):
+ * - `get <key> [--json]`: effective value, source layer and apply tier;
+ * - `set <key> <value> [--project] [--json-value] [--yes]`: write one key to the user file (or the
+ *   project file, tighten only); lists and objects need `--json-value`; `permission.mode full-auto`
+ *   asks once on a TTY and needs `--yes` otherwise;
+ * - `unset <key> [--project]`;
+ * - `list [prefix] [--json] [--all]`: panel settings (or every settable key with `--all`).
+ * Unknown keys, invalid values and refused project writes exit 3 (`ExitCode.Config`). `get` / `list`
+ * never create the config directory. `--profile <file>` adds the host profile layer to the view.
+ */
+import { msg } from "../../i18n/index.js";
+import { assertSettable, formatSettingValue, getConfigValue, parseValue, readSnapshot, setConfigValue, } from "../../config/edit.js";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { initConfigDir } from "../../config/init.js";
+import { CONFIG_FILE, resolveConfigDir } from "../../config/paths.js";
+import { loadProfile } from "../../config/profile.js";
+import { settableKeys, settingSpec, settingsRegistry } from "../../config/settings-registry.js";
+import { confirmContinue } from "../choice-prompt.js";
+import { parseSubArgs, UsageError } from "../args.js";
+import { ExitCode } from "../exit-codes.js";
+export const CONFIG_EDIT_ACTIONS = ["get", "set", "unset", "list"];
+function layerInput(io, profilePath) {
+    const input = {
+        configDir: resolveConfigDir({ env: io.env }),
+        cwd: io.cwd,
+        env: io.env,
+    };
+    if (profilePath !== undefined) {
+        const profile = loadProfile(profilePath, io.cwd);
+        input.profile = { config: profile.config };
+        input.hasProfile = true;
+    }
+    return input;
+}
+function applyText(key) {
+    const spec = settingSpec(key);
+    const s = msg().settings;
+    if (spec === undefined)
+        return s.cli.applyNone;
+    return spec.prefix === true ? `${s.apply[spec.apply]} · ${s.prefixTag}` : s.apply[spec.apply];
+}
+function jsonRow(value) {
+    const spec = settingSpec(value.key);
+    return {
+        key: value.key,
+        value: value.value ?? null,
+        source: value.source,
+        ...(value.envName !== undefined ? { env: value.envName } : {}),
+        apply: spec?.apply ?? null,
+        prefix: spec?.prefix === true,
+        project: spec?.project ?? null,
+    };
+}
+function textRow(value) {
+    const source = value.envName !== undefined ? `env ${value.envName}` : value.source;
+    return msg().settings.cli.getLine(value.key, formatSettingValue(value.value), source, applyText(value.key));
+}
+function scopeLabel(scope) {
+    return msg().settings.scope[scope];
+}
+/**
+ * Receipt of a write. When a higher layer (env, project, cli, profile) still hides the key, the first line shows the
+ * value just written and its layer, and the second line names the overriding source and the effective value.
+ */
+function report(io, result, written) {
+    const s = msg().settings;
+    const effective = formatSettingValue(result.after.value);
+    const scope = scopeLabel(result.scope);
+    const by = result.after.envName ?? result.overriddenBy;
+    if (written === undefined)
+        io.stdout(`${s.unsetDone(result.key, effective, scope)}\n`);
+    else if (by === undefined)
+        io.stdout(`${s.setDone(result.key, effective, scope)}\n`);
+    else
+        io.stdout(`${s.writtenTo(result.key, formatSettingValue(written), scope)}\n`);
+    if (by === undefined)
+        return;
+    io.stdout(`${written === undefined ? s.stillOverridden(result.key, by) : s.overriddenNow(by, effective)}\n`);
+}
+/** Confirm persisting `permission.mode full-auto`: TTY asks, otherwise `--yes` is required. */
+async function confirmBypass(io, yes, deps) {
+    const s = msg().settings.cli;
+    if (yes)
+        return true;
+    if (!io.stdinIsTTY) {
+        io.stderr(`ama: ${s.needYes}\n`);
+        return false;
+    }
+    const ask = deps.confirm ?? ((question) => confirmContinue({ question, env: io.env }));
+    if (await ask(s.confirmBypass))
+        return true;
+    io.stderr(`${s.cancelled}\n`);
+    return false;
+}
+export async function runConfigEdit(action, argv, io, deps = {}) {
+    const { positionals, values, flags } = parseSubArgs(argv, ["profile"], ["json", "project", "json-value", "yes", "all"]);
+    const s = msg().settings;
+    if (flags.has("help")) {
+        io.stdout(s.cli.usage);
+        return ExitCode.Ok;
+    }
+    const input = layerInput(io, values.get("profile"));
+    const scope = flags.has("project") ? "project" : "user";
+    if (action === "list") {
+        const snapshot = readSnapshot(input);
+        const prefix = positionals[0] ?? "";
+        const keys = (flags.has("all") ? settableKeys() : settingsRegistry().map((spec) => spec.key)).filter((key) => key.startsWith(prefix));
+        const rows = keys.map((key) => getConfigValue(snapshot, key));
+        if (flags.has("json"))
+            io.stdout(`${JSON.stringify(rows.map(jsonRow), null, 2)}\n`);
+        else
+            io.stdout(`${[s.cli.listHeader, ...rows.map((r) => `  ${textRow(r)}`)].join("\n")}\n`);
+        return ExitCode.Ok;
+    }
+    const key = positionals[0];
+    if (key === undefined)
+        throw new UsageError(s.cli.missingKey);
+    if (action === "get") {
+        assertSettable(key);
+        const value = getConfigValue(readSnapshot(input), key);
+        io.stdout(flags.has("json") ? `${JSON.stringify(jsonRow(value), null, 2)}\n` : `${textRow(value)}\n`);
+        return ExitCode.Ok;
+    }
+    if (action === "unset") {
+        report(io, setConfigValue({ ...input, scope, key, value: undefined }), undefined);
+        return ExitCode.Ok;
+    }
+    const raw = positionals.slice(1).join(" ");
+    if (positionals.length < 2)
+        throw new UsageError(s.cli.missingValue);
+    const value = parseValue(key, raw, flags.has("json-value"));
+    if (key === "permission.mode" && value === "full-auto" && scope === "user") {
+        if (!(await confirmBypass(io, flags.has("yes"), deps)))
+            return ExitCode.Config;
+    }
+    // first write to a fresh config dir: lay out config.json + config.schema.json like `ama init`
+    if (scope === "user" && !existsSync(join(input.configDir, CONFIG_FILE)))
+        initConfigDir(input.configDir);
+    report(io, setConfigValue({ ...input, scope, key, value }), value);
+    return ExitCode.Ok;
+}

package/dist/cli/subcommands/config.d.ts

@@ -14,7 +14,8 @@
 import { type AmaConfig, type CodemodeMode } from "../../config/types.js";
 import type { Api, ProviderRegistryApi } from "../../ai/types.js";
 import type { CliIo, RuntimeDeps } from "../deps.js";
-export declare const CONFIG_USAGE = "\u7528\u6CD5\uFF1Aama config show [--json] [--profile <\u6587\u4EF6>] [--auth-file <\u6587\u4EF6>]\n                        [--tools-preset <\u540D>] [--codemode off|on|only]\n      ama config path    \u914D\u7F6E\u76EE\u5F55\u3001\u6570\u636E\u76EE\u5F55\u4E0E\u5404\u6587\u4EF6\u8DEF\u5F84\n      ama config edit    \u7528 $VISUAL / $EDITOR \u6253\u5F00 config.json\uFF08\u6CA1\u6709\u7F16\u8F91\u5668\u65F6\u6253\u5370\u8DEF\u5F84\uFF09\n";
+/** `ama config --help` 的前半（get / set 等编辑子命令的用法接在后面）。 */
+export declare const configUsage: () => string;
 type Layer = {
     name: "default" | "user" | "profile" | "project" | "cli";
     label: string;

package/dist/cli/subcommands/config.js

@@ -34,26 +34,30 @@ import { ExitCode } from "../exit-codes.js";
 import { buildRegistry, loadUserLevel } from "./context.js";
 import { osSandboxStatus } from "../../sandbox/detect.js";
 import { resolveBashSandbox } from "../../sandbox/bash.js";
-export const CONFIG_USAGE = `用法：ama config show [--json] [--profile <文件>] [--auth-file <文件>]
-                        [--tools-preset <名>] [--codemode off|on|only]
-      ama config path    配置目录、数据目录与各文件路径
-      ama config edit    用 $VISUAL / $EDITOR 打开 config.json（没有编辑器时打印路径）
-`;
+import { msg } from "../../i18n/index.js";
+import { padToWidth, visibleWidth } from "../../tui/ansi.js";
+import { CONFIG_EDIT_ACTIONS, runConfigEdit } from "./config-set.js";
+const isEditAction = (value) => CONFIG_EDIT_ACTIONS.includes(value);
+/** `ama config --help` 的前半（get / set 等编辑子命令的用法接在后面）。 */
+export const configUsage = () => msg().subcommands.configShow.usage;
 /** `ama config path`：目录与文件路径，标出是否存在。 */
 function showPaths(io) {
     const configDir = resolveConfigDir({ env: io.env });
     const dataDir = resolveDataDir({ env: io.env });
-    const mark = (path) => `${path}${existsSync(path) ? "" : "  （不存在）"}`;
+    const m = msg().subcommands.configShow;
+    const mark = (path) => `${path}${existsSync(path) ? "" : m.missing}`;
+    const width = Math.max(...[m.configDir, m.dataDir, m.projectLevel].map(visibleWidth)) + 2;
+    const label = (text) => padToWidth(text, width);
     const lines = [
-        `配置目录  ${mark(configDir)}`,
+        `${label(m.configDir)}${mark(configDir)}`,
         `  config.json         ${mark(join(configDir, CONFIG_FILE))}`,
         `  config.schema.json  ${mark(join(configDir, CONFIG_SCHEMA_FILE))}`,
         `  auth.json           ${mark(join(configDir, AUTH_FILE))}`,
         `  hooks.json          ${mark(join(configDir, HOOKS_FILE))}`,
-        `数据目录  ${mark(dataDir)}`,
+        `${label(m.dataDir)}${mark(dataDir)}`,
         `  sessions/           ${mark(join(dataDir, "sessions"))}`,
         `  models-dev.json     ${mark(modelsDevCachePath(dataDir))}`,
-        `项目级    ${mark(projectFile(io.cwd, CONFIG_FILE))}`,
+        `${label(m.projectLevel)}${mark(projectFile(io.cwd, CONFIG_FILE))}`,
     ];
     io.stdout(`${lines.join("\n")}\n`);
     return ExitCode.Ok;
@@ -66,13 +70,13 @@ function editConfig(io) {
         initConfigDir(configDir);
     const editor = (io.env["VISUAL"] ?? io.env["EDITOR"] ?? "").trim();
     if (editor === "") {
-        io.stdout(`${path}\n（没有设置 $VISUAL / $EDITOR，请用编辑器打开上面的文件）\n`);
+        io.stdout(msg().subcommands.configShow.noEditor(path));
         return ExitCode.Ok;
     }
     const quoted = process.platform === "win32" ? `"${path}"` : `'${path.replace(/'/g, `'\\''`)}'`;
     const result = spawnSync(`${editor} ${quoted}`, { stdio: "inherit", shell: true });
     if (result.error !== undefined || result.status !== 0) {
-        io.stderr(`ama: 编辑器退出异常（${editor}）；文件在 ${path}\n`);
+        io.stderr(msg().subcommands.configShow.editorFailed(editor, path));
         return ExitCode.RuntimeError;
     }
     return ExitCode.Ok;
@@ -111,19 +115,20 @@ function display(path, value) {
 export async function describeModel(config, registry) {
     if (config.defaultModel !== undefined)
         return { ref: config.defaultModel, reason: "config.defaultModel" };
+    const m = msg().subcommands.configShow;
     if (registry === undefined)
-        return { ref: undefined, reason: "注册表未装配" };
+        return { ref: undefined, reason: m.registryMissing };
     const picked = await pickDefaultModel(registry);
     if (picked === undefined)
         return { ref: undefined, reason: noModelGuidance(registry) };
     const ref = `${picked.provider.id}/${picked.model.id}`;
     if (picked.via === "local")
-        return { ref, reason: `零配置：本地 ${picked.provider.id} 可达；${picked.rule}` };
+        return { ref, reason: m.zeroConfigLocal(picked.provider.id, picked.rule) };
     const key = await registry.resolveApiKey(picked.provider.id);
     const origin = key.origin !== undefined ? ` ${key.origin}` : "";
     return {
         ref,
-        reason: `零配置：${picked.provider.id} 有 key（${key.source}${origin}）；${picked.rule}`,
+        reason: m.zeroConfigKey(picked.provider.id, `${key.source}${origin}`, picked.rule),
     };
 }
 /** config 里出现的供应商 + baseUrl 来自环境变量的内置供应商。 */
@@ -170,9 +175,10 @@ export function describeProviders(config, registry) {
 function providerLines(providers) {
     if (providers.length === 0)
         return [];
-    const lines = ["", "供应商："];
+    const m = msg().subcommands.configShow;
+    const lines = ["", m.providersHeading];
     for (const p of providers) {
-        const env = p.baseUrlEnv !== undefined ? `（baseUrl 来自环境变量 ${p.baseUrlEnv}）` : "";
+        const env = p.baseUrlEnv !== undefined ? m.baseUrlFromEnv(p.baseUrlEnv) : "";
         lines.push(`  ${p.id}  ${p.api}  ${p.baseUrl}${env}`);
         for (const c of p.channels ?? [])
             lines.push(`    @${c.name}  ${c.api}  ${c.baseUrl}`);
@@ -185,7 +191,8 @@ function providerLines(providers) {
     return lines;
 }
 function layersOf(level, project, effective, cli) {
-    const layers = [{ name: "default", label: "内置缺省", value: DISPLAY_DEFAULTS }];
+    const m = msg().subcommands.configShow;
+    const layers = [{ name: "default", label: m.layerDefault, value: DISPLAY_DEFAULTS }];
     const user = loadConfigFile("config", level.userConfigPath)?.value;
     if (user !== undefined)
         layers.push({ name: "user", label: level.userConfigPath, value: user });
@@ -209,7 +216,7 @@ function layersOf(level, project, effective, cli) {
         layers.push({ name: "project", label: ".ama/config.json", value: unflatten(accepted) });
     }
     if (cli !== undefined && Object.keys(cli).length > 0)
-        layers.push({ name: "cli", label: "命令行", value: cli });
+        layers.push({ name: "cli", label: m.layerCli, value: cli });
     return layers;
 }
 function unflatten(flat) {
@@ -243,14 +250,15 @@ export function sourcesOf(effective, layers) {
 export function describeCodemode(config, nodeVersion) {
     const capability = nodeVersion === undefined ? sandboxCapabilityFor(config) : detectSandboxCapability(nodeVersion);
     const resolved = resolveCodemodeMode(config, capability.strict);
+    const m = msg().subcommands.configShow;
     const sandbox = capability.nodeMajor >= 25
-        ? `Node ${capability.nodeMajor} 网络已隔离`
+        ? m.sandboxIsolated(capability.nodeMajor)
         : capability.strict
-            ? `Node ${capability.nodeMajor} 网络由操作系统沙箱 ${capability.os.kind} 隔离`
-            : `Node ${capability.nodeMajor} < 25 网络未隔离`;
+            ? m.sandboxOs(capability.nodeMajor, capability.os.kind)
+            : m.sandboxNone(capability.nodeMajor);
     const reason = resolved.source === "config"
-        ? `codemode.mode 显式设置（${sandbox}）`
-        : `跟随预设 ${resolved.preset}（${sandbox}）`;
+        ? m.codemodeExplicit(sandbox)
+        : m.codemodeFollowsPreset(resolved.preset, sandbox);
     const out = {
         mode: resolved.mode,
         source: resolved.source,
@@ -270,7 +278,7 @@ function presetAliasNotes(layers) {
     for (const layer of layers) {
         const preset = layer.value?.tools?.preset;
         if (preset !== undefined && Object.hasOwn(TOOLS_PRESET_ALIASES, preset))
-            notes.push(`${layer.name}（${layer.label}）的 tools.preset 写的是旧名 ${preset}，规范名 ${canonicalPreset(preset)}`);
+            notes.push(msg().subcommands.configShow.presetAlias(layer.name, layer.label, preset, canonicalPreset(preset)));
     }
     return notes;
 }
@@ -279,21 +287,26 @@ function choice(name, value, all) {
         return undefined;
     if (all.includes(value))
         return value;
-    throw new UsageError(`--${name} 的取值应为 ${all.join(" | ")}（收到 ${value}）`);
+    throw new UsageError(msg().subcommands.common.invalidChoice(`--${name}`, all, value));
 }
 export async function runConfig(argv, io, deps) {
+    // [W6-S] get / set / unset / list（config-set.ts）
+    const edit = argv.findIndex((a) => !a.startsWith("-"));
+    if (edit !== -1 && isEditAction(argv[edit]))
+        return runConfigEdit(argv[edit], [...argv.slice(0, edit), ...argv.slice(edit + 1)], io);
     const { positionals, values, flags } = parseSubArgs(argv, ["profile", "auth-file", "tools-preset", "codemode"], ["json"]);
     const action = positionals[0] ?? "show";
     if (flags.has("help")) {
-        io.stdout(CONFIG_USAGE);
+        io.stdout(`${configUsage()}${msg().settings.cli.usage}`);
         return ExitCode.Ok;
     }
     if (action === "path")
         return showPaths(io);
     if (action === "edit")
         return editConfig(io);
+    const m = msg().subcommands.configShow;
     if (action !== "show")
-        throw new UsageError(`未知的 config 子命令：${action}`);
+        throw new UsageError(m.unknownAction(action));
     const cli = {};
     const presetFlag = choice("tools-preset", values.get("tools-preset"), TOOLS_PRESET_INPUTS);
     if (presetFlag !== undefined)
@@ -338,7 +351,7 @@ export async function runConfig(argv, io, deps) {
         rows.push({
             path: "codemode.mode",
             value: codemode.mode,
-            source: `default（${codemode.reason}）`,
+            source: m.defaultSource(codemode.reason),
         });
     rows.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
     if (flags.has("json")) {
@@ -350,9 +363,9 @@ export async function runConfig(argv, io, deps) {
         io.stdout(`${JSON.stringify({ model, providers, tools: preset.builtin, preset: preset.preset, codemode, bashSandbox: { active: bashSandbox.active, detail: bashSandbox.detail }, entries, layers: layers.map((l) => ({ name: l.name, file: l.label })), notes, warnings }, null, 2)}\n`);
         return ExitCode.Ok;
     }
-    const lines = ["生效配置（来源：default 内置 ← user ← profile ← project 只能收紧 ← cli）"];
+    const lines = [m.heading];
     for (const layer of layers.slice(1))
-        lines.push(`  ${layer.name}：${layer.label}`);
+        lines.push(m.layerLine(layer.name, layer.label));
     lines.push("");
     const texts = rows.map((row) => [`${row.path} = ${display(row.path, row.value)}`, row.source]);
     const width = Math.min(60, Math.max(...texts.map(([text]) => (text ?? "").length)));
@@ -360,16 +373,17 @@ export async function runConfig(argv, io, deps) {
         lines.push(`  ${(text ?? "").padEnd(width)}  ${source}`);
     lines.push(...providerLines(providers));
     lines.push("");
-    lines.push(`模型：${model.ref ?? "（无）"}  ${model.reason}`);
-    lines.push(`工具：${preset.builtin.join(", ")}（预设 ${preset.preset}，codemode ${preset.codemode}）`);
-    lines.push(`codemode：${codemode.mode}  ${codemode.reason}`);
+    lines.push(m.model(model.ref, model.reason));
+    lines.push(m.tools(preset.builtin.join(", "), preset.preset, preset.codemode));
+    lines.push(m.codemode(codemode.mode, codemode.reason));
     if (codemode.unavailable !== undefined)
         lines.push(`  ${codemode.unavailable}`);
-    lines.push(`bash 沙箱：${bashSandbox.detail}`);
+    lines.push(m.bashSandbox(bashSandbox.detail));
     for (const note of notes)
-        lines.push(`提示：${note}`);
-    for (const warning of [...warnings, ...preset.warnings])
-        lines.push(`警告：${warning}`);
+        lines.push(m.note(note));
+    const presetWarnings = preset.warnings.map((w) => msg().session.codemode.presetWarning(w));
+    for (const warning of [...warnings, ...presetWarnings])
+        lines.push(m.warning(warning));
     io.stdout(`${lines.join("\n")}\n`);
     return ExitCode.Ok;
 }

package/dist/cli/subcommands/doctor.d.ts

@@ -7,5 +7,6 @@
  * [W3-B12] baseUrl 来自 `OPENAI_BASE_URL` / `ANTHROPIC_BASE_URL` 时在 key 行后标出变量与地址。
  */
 import type { CliIo, RuntimeDeps } from "../deps.js";
-export declare const DOCTOR_USAGE = "\u7528\u6CD5\uFF1Aama doctor [--profile <\u6587\u4EF6>] [--auth-file <\u6587\u4EF6>] [--trust | --no-trust]\n";
+/** 用法（随界面语言）。 */
+export declare function doctorUsage(): string;
 export declare function runDoctor(argv: readonly string[], io: CliIo, deps: RuntimeDeps | undefined): Promise<number>;