@armadra/agent 0.8.0 → 0.9.0

package/dist/drivers/native/codex-normalize.d.ts

@@ -1,5 +1,5 @@
 /**
- * Codex app-server（0.160.x，`[experimental]`）↔ ama 的映射（docs/wave5-plan.md §5.1 normalize，
+ * Codex app-server（0.160.x，`[experimental]`）↔ ama 的映射（docs/history/wave5-plan.md §5.1 normalize，
  * R2 §1.3）。[W5-E]
  *
  * 只依赖 `test/fixtures/drivers/codex-schema/shapes.json` 锁住的方法与字段（12 个方法 + 5 类审批

package/dist/drivers/native/codex-normalize.js

@@ -1,5 +1,5 @@
 /**
- * Codex app-server（0.160.x，`[experimental]`）↔ ama 的映射（docs/wave5-plan.md §5.1 normalize，
+ * Codex app-server（0.160.x，`[experimental]`）↔ ama 的映射（docs/history/wave5-plan.md §5.1 normalize，
  * R2 §1.3）。[W5-E]
  *
  * 只依赖 `test/fixtures/drivers/codex-schema/shapes.json` 锁住的方法与字段（12 个方法 + 5 类审批

package/dist/drivers/native/oneshot.d.ts

@@ -1,5 +1,5 @@
 /**
- * 一次性打印模式兜底（docs/wave5-plan.md §5.1 oneshot.ts）。[W5-E]
+ * 一次性打印模式兜底（docs/history/wave5-plan.md §5.1 oneshot.ts）。[W5-E]
  *
  * `claude -p --output-format json`、`codex exec --json`、`gemini -p --output-format stream-json`：
  * **不能审批**（能力 `permissions: "none"`），所以只在只读任务下用——open 时模式不是

package/dist/drivers/native/oneshot.js

@@ -1,5 +1,5 @@
 /**
- * 一次性打印模式兜底（docs/wave5-plan.md §5.1 oneshot.ts）。[W5-E]
+ * 一次性打印模式兜底（docs/history/wave5-plan.md §5.1 oneshot.ts）。[W5-E]
  *
  * `claude -p --output-format json`、`codex exec --json`、`gemini -p --output-format stream-json`：
  * **不能审批**（能力 `permissions: "none"`），所以只在只读任务下用——open 时模式不是

package/dist/drivers/permissions.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的权限：交人、不代答（docs/wave5-plan.md §5.3，D15）。[W5-E]
+ * 外部 Agent 的权限：交人、不代答（docs/history/wave5-plan.md §5.3，D15）。[W5-E]
  *
  * 1. 子 Agent 自己的策略先判，它决定要问人的才到 ama；到了以后只走审批通道（宿主 → UI →
  *    无人值守拒绝），auto 分类器与模型都不参与——`approve` 由调用方接到会话的

package/dist/drivers/permissions.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的权限：交人、不代答（docs/wave5-plan.md §5.3，D15）。[W5-E]
+ * 外部 Agent 的权限：交人、不代答（docs/history/wave5-plan.md §5.3，D15）。[W5-E]
  *
  * 1. 子 Agent 自己的策略先判，它决定要问人的才到 ama；到了以后只走审批通道（宿主 → UI →
  *    无人值守拒绝），auto 分类器与模型都不参与——`approve` 由调用方接到会话的

package/dist/drivers/pids.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 进程登记与孤儿清理（docs/wave5-plan.md §5.4 孤儿进程）。[W5-E]
+ * 外部 Agent 进程登记与孤儿清理（docs/history/wave5-plan.md §5.4 孤儿进程）。[W5-E]
  *
  * `<dataDir>/drivers/pids.json` 记 `{ pid, program, owner }`（owner = 起它的 ama 进程）。
  * 正常退出时 `process-tree.ts` 已同步杀掉仍存活的组；这里处理 ama 被 SIGKILL / 崩溃留下的孤儿：

package/dist/drivers/pids.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 进程登记与孤儿清理（docs/wave5-plan.md §5.4 孤儿进程）。[W5-E]
+ * 外部 Agent 进程登记与孤儿清理（docs/history/wave5-plan.md §5.4 孤儿进程）。[W5-E]
  *
  * `<dataDir>/drivers/pids.json` 记 `{ pid, program, owner }`（owner = 起它的 ama 进程）。
  * 正常退出时 `process-tree.ts` 已同步杀掉仍存活的组；这里处理 ama 被 SIGKILL / 崩溃留下的孤儿：

package/dist/drivers/pool.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 并发池（docs/wave5-plan.md §5.4 并发）。[W5-E]
+ * 外部 Agent 并发池（docs/history/wave5-plan.md §5.4 并发）。[W5-E]
  *
  * 总并发 `agents.maxConcurrent`（缺省 3）+ 每个 Agent 的上限 `agents.<id>.maxConcurrent`
  * （claude 缺省 2：订阅有速率限制）；超出排队（先来先得），排队可被 abort。与 ama 自己的

package/dist/drivers/pool.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 并发池（docs/wave5-plan.md §5.4 并发）。[W5-E]
+ * 外部 Agent 并发池（docs/history/wave5-plan.md §5.4 并发）。[W5-E]
  *
  * 总并发 `agents.maxConcurrent`（缺省 3）+ 每个 Agent 的上限 `agents.<id>.maxConcurrent`
  * （claude 缺省 2：订阅有速率限制）；超出排队（先来先得），排队可被 abort。与 ama 自己的

package/dist/drivers/probe.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的探测（docs/wave5-plan.md §5.1 probe.ts）。[W5-E]
+ * 外部 Agent 的探测（docs/history/wave5-plan.md §5.1 probe.ts）。[W5-E]
  *
  * - PATH 查找不起 shell：逐个目录拼程序名（Windows 加 PATHEXT 后缀）；绝对 / 相对路径直接认。
  * - 版本：`<program> --version` 取第一个 `x.y.z`，5 s 超时，不联网、不计费。

package/dist/drivers/probe.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的探测（docs/wave5-plan.md §5.1 probe.ts）。[W5-E]
+ * 外部 Agent 的探测（docs/history/wave5-plan.md §5.1 probe.ts）。[W5-E]
  *
  * - PATH 查找不起 shell：逐个目录拼程序名（Windows 加 PATHEXT 后缀）；绝对 / 相对路径直接认。
  * - 版本：`<program> --version` 取第一个 `x.y.z`，5 s 超时，不联网、不计费。

package/dist/drivers/process.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 子进程（docs/wave5-plan.md §5.4 看门狗 / 孤儿进程）。[W5-E]
+ * 外部 Agent 子进程（docs/history/wave5-plan.md §5.4 看门狗 / 孤儿进程）。[W5-E]
  *
  * - POSIX 以 `detached` 自成进程组，结束时 `killProcessTree`（SIGTERM → 宽限 → SIGKILL）；
  *   登记到 `tools/process-tree.ts`，ama 退出时同步清掉仍存活的组。

package/dist/drivers/process.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 子进程（docs/wave5-plan.md §5.4 看门狗 / 孤儿进程）。[W5-E]
+ * 外部 Agent 子进程（docs/history/wave5-plan.md §5.4 看门狗 / 孤儿进程）。[W5-E]
  *
  * - POSIX 以 `detached` 自成进程组，结束时 `killProcessTree`（SIGTERM → 宽限 → SIGKILL）；
  *   登记到 `tools/process-tree.ts`，ama 退出时同步清掉仍存活的组。

package/dist/drivers/runner.d.ts

@@ -1,5 +1,5 @@
 /**
- * ProcessRunner：把 AgentDriver 适配成 SubagentRunner（docs/wave5-plan.md §7.6、§5.3–§5.4）。[W5-E]
+ * ProcessRunner：把 AgentDriver 适配成 SubagentRunner（docs/history/wave5-plan.md §7.6、§5.3–§5.4）。[W5-E]
  *
  * 外部 CLI Agent 由此与 ama 子 Agent 共用 `task(agent=…)` 入口（D13）。`start()`：
  * 1. 只在已信任目录里起（§5.4 信任；`claude -p` 会跳过目录信任对话框并执行项目 hooks）；

package/dist/drivers/runner.js

@@ -1,5 +1,5 @@
 /**
- * ProcessRunner：把 AgentDriver 适配成 SubagentRunner（docs/wave5-plan.md §7.6、§5.3–§5.4）。[W5-E]
+ * ProcessRunner：把 AgentDriver 适配成 SubagentRunner（docs/history/wave5-plan.md §7.6、§5.3–§5.4）。[W5-E]
  *
  * 外部 CLI Agent 由此与 ama 子 Agent 共用 `task(agent=…)` 入口（D13）。`start()`：
  * 1. 只在已信任目录里起（§5.4 信任；`claude -p` 会跳过目录信任对话框并执行项目 hooks）；

package/dist/drivers/store.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的会话引用与记账（docs/wave5-plan.md §5.4 记账 / 敏感数据，session-format 登记）。[W5-E]
+ * 外部 Agent 的会话引用与记账（docs/history/wave5-plan.md §5.4 记账 / 敏感数据，session-format 登记）。[W5-E]
  *
  * - `custom{ama.agent-session}`：`{ agent, runner, sessionId, cwd?, taskId? }`——外部 CLI 自己的
  *   会话 id，续聊（`taskId` / resume）用；不含原始事件与转录。

package/dist/drivers/store.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的会话引用与记账（docs/wave5-plan.md §5.4 记账 / 敏感数据，session-format 登记）。[W5-E]
+ * 外部 Agent 的会话引用与记账（docs/history/wave5-plan.md §5.4 记账 / 敏感数据，session-format 登记）。[W5-E]
  *
  * - `custom{ama.agent-session}`：`{ agent, runner, sessionId, cwd?, taskId? }`——外部 CLI 自己的
  *   会话 id，续聊（`taskId` / resume）用；不含原始事件与转录。

package/dist/drivers/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 驱动契约（docs/wave5-plan.md §5.1–§5.3，D14）。[W5-C0] 契约文件，实现归 W5-E。
+ * 外部 Agent 驱动契约（docs/history/wave5-plan.md §5.1–§5.3，D14）。[W5-C0] 契约文件，实现归 W5-E。
  *
  * 内部词汇 = ACP v1 子集：各家原生协议（Claude stream-json、Codex app-server、一次性打印模式）
  * 都映射成 `DriverEvent`；权限请求以 `DriverPermissionRequest` 交给 ama 的 broker 链——**只交给人，

package/dist/drivers/types.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 驱动契约（docs/wave5-plan.md §5.1–§5.3，D14）。[W5-C0] 契约文件，实现归 W5-E。
+ * 外部 Agent 驱动契约（docs/history/wave5-plan.md §5.1–§5.3，D14）。[W5-C0] 契约文件，实现归 W5-E。
  *
  * 内部词汇 = ACP v1 子集：各家原生协议（Claude stream-json、Codex app-server、一次性打印模式）
  * 都映射成 `DriverEvent`；权限请求以 `DriverPermissionRequest` 交给 ama 的 broker 链——**只交给人，

package/dist/git/info.d.ts

@@ -1,5 +1,5 @@
 /**
- * 状态行的 git 信息（docs/wave5-plan.md §1.3）。[W5-A]
+ * 状态行的 git 信息（docs/history/wave5-plan.md §1.3）。[W5-A]
  *
  * - 分支与短提交零依赖读 `.git/HEAD`（`checkpoints/git-head.ts`，worktree / 子模块的 gitdir 文件、
  *   packed-refs 都认）；detached 时没有分支只显示短提交；还没有提交的分支只显示分支名。

package/dist/git/info.js

@@ -1,5 +1,5 @@
 /**
- * 状态行的 git 信息（docs/wave5-plan.md §1.3）。[W5-A]
+ * 状态行的 git 信息（docs/history/wave5-plan.md §1.3）。[W5-A]
  *
  * - 分支与短提交零依赖读 `.git/HEAD`（`checkpoints/git-head.ts`，worktree / 子模块的 gitdir 文件、
  *   packed-refs 都认）；detached 时没有分支只显示短提交；还没有提交的分支只显示分支名。

package/dist/host/api-impl.d.ts

@@ -6,7 +6,7 @@
  * 事件总线 `AgentEventBus` 由 bootstrap 创建并交给 AgentSession 发事件；处理器只观察，
  * 抛错记日志；`emit` 等待全部处理器（`session_shutdown` 需要被 await）。
  *
- * [W5-EG] `runners.provide`（docs/wave5-plan.md §5.5，D17）：宿主注入的 runner 进本适配器的
+ * [W5-EG] `runners.provide`（docs/history/wave5-plan.md §5.5，D17）：宿主注入的 runner 进本适配器的
  * {@link HostRunnerRegistry}（跨会话共享），每个主会话的外部 Agent 入口（agents/external.ts）经
  * {@link hostRunnersOf} 取到它；有宿主时 ama 不自 spawn 外部 CLI，只认这里注入的。
  */

package/dist/host/api-impl.js

@@ -6,7 +6,7 @@
  * 事件总线 `AgentEventBus` 由 bootstrap 创建并交给 AgentSession 发事件；处理器只观察，
  * 抛错记日志；`emit` 等待全部处理器（`session_shutdown` 需要被 await）。
  *
- * [W5-EG] `runners.provide`（docs/wave5-plan.md §5.5，D17）：宿主注入的 runner 进本适配器的
+ * [W5-EG] `runners.provide`（docs/history/wave5-plan.md §5.5，D17）：宿主注入的 runner 进本适配器的
  * {@link HostRunnerRegistry}（跨会话共享），每个主会话的外部 Agent 入口（agents/external.ts）经
  * {@link hostRunnersOf} 取到它；有宿主时 ama 不自 spawn 外部 CLI，只认这里注入的。
  */

package/dist/host/types.d.ts

@@ -116,7 +116,7 @@ export interface AgentEvents {
     /** [W5-C0] 计划提出 / 审批结果。 */
     plan_proposed: Omit<PlanProposedEvent, "type">;
     plan_resolved: Omit<PlanResolvedEvent, "type">;
-    /** [W6-O] ChatGPT 订阅配额更新（docs/wave6-plan.md §4.5）。 */
+    /** [W6-O] ChatGPT 订阅配额更新（docs/history/wave6-plan.md §4.5）。 */
     quota_update: Omit<QuotaUpdateEvent, "type">;
 }
 /** [W5-C0] 宿主注入的 runner：`id` 即 `task(agent=<id>)` 的名字，`description` 进 task 工具描述。 */
@@ -176,7 +176,7 @@ export interface HostApi {
         onWarmingDecision(handler: WarmingDecisionHandler): () => void;
     };
     /**
-     * [W5-C0] 宿主注入的子 Agent runner（画布节点等，docs/wave5-plan.md §5.5）：注入后同名的内置
+     * [W5-C0] 宿主注入的子 Agent runner（画布节点等，docs/history/wave5-plan.md §5.5）：注入后同名的内置
      * 外部 runner 被替换；返回值用于注销。可选面：旧版本运行时没有它（实现归 W5-E / W5-G）。
      */
     readonly runners?: {

package/dist/i18n/catalog.d.ts

@@ -1,10 +1,10 @@
 /**
- * 全部领域的汇总（docs/wave6-plan.md §5.1、D23）。[W6-C0] 一次登记全部领域，之后无人再改本文件：
+ * 全部领域的汇总（docs/history/wave6-plan.md §5.1、D23）。[W6-C0] 一次登记全部领域，之后无人再改本文件：
  * 各批次只改自己的 `messages/<领域>.ts`。
  *
  * 领域 → 所有者：cli / subcommands（I1）；interactive / approval / plan / rewind / panels / permissions（I2）；
  * report / print / drivers / session / errors（I3）；config（I4）；agents（A）；trace（T1 / T2）；
- * memory（M）；auth（O）；settings（S）；acp（ACP-C0 新增，docs/acp-plan.md D15）。
+ * memory（M）；auth（O）；settings（S）；acp（ACP-C0 新增，docs/history/acp-plan.md D15）。
  */
 import type { Messages } from "./types.js";
 import * as rewind from "./messages/rewind.js";

package/dist/i18n/catalog.js

@@ -1,10 +1,10 @@
 /**
- * 全部领域的汇总（docs/wave6-plan.md §5.1、D23）。[W6-C0] 一次登记全部领域，之后无人再改本文件：
+ * 全部领域的汇总（docs/history/wave6-plan.md §5.1、D23）。[W6-C0] 一次登记全部领域，之后无人再改本文件：
  * 各批次只改自己的 `messages/<领域>.ts`。
  *
  * 领域 → 所有者：cli / subcommands（I1）；interactive / approval / plan / rewind / panels / permissions（I2）；
  * report / print / drivers / session / errors（I3）；config（I4）；agents（A）；trace（T1 / T2）；
- * memory（M）；auth（O）；settings（S）；acp（ACP-C0 新增，docs/acp-plan.md D15）。
+ * memory（M）；auth（O）；settings（S）；acp（ACP-C0 新增，docs/history/acp-plan.md D15）。
  */
 import * as cli from "./messages/cli.js";
 import * as subcommands from "./messages/subcommands.js";

package/dist/i18n/format.d.ts

@@ -1,5 +1,5 @@
 /**
- * 与语言无关的格式化小工具（docs/wave6-plan.md §5.1；R8 §2.4）。[W6-C0]
+ * 与语言无关的格式化小工具（docs/history/wave6-plan.md §5.1；R8 §2.4）。[W6-C0]
  *
  * - `plural`：只有英文需要复数；中文文案直接写「N 个文件」，不调它。
  * - `formatDuration`：紧凑时长，两种语言共用（`45s`、`2m 10s`、`1h24m`）；长句里的「7 分钟」走消息目录。

package/dist/i18n/format.js

@@ -1,5 +1,5 @@
 /**
- * 与语言无关的格式化小工具（docs/wave6-plan.md §5.1；R8 §2.4）。[W6-C0]
+ * 与语言无关的格式化小工具（docs/history/wave6-plan.md §5.1；R8 §2.4）。[W6-C0]
  *
  * - `plural`：只有英文需要复数；中文文案直接写「N 个文件」，不调它。
  * - `formatDuration`：紧凑时长，两种语言共用（`45s`、`2m 10s`、`1h24m`）；长句里的「7 分钟」走消息目录。

package/dist/i18n/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * 界面语言（docs/wave6-plan.md §5.1、§5.2、D18；docs/i18n.md）。[W6-C0]
+ * 界面语言（docs/history/wave6-plan.md §5.1、§5.2、D18；docs/guides/i18n.md）。[W6-C0]
  *
  * - 语言优先级：`AMA_LANG` > `--lang` > `ui.language`（`auto` 视为未设）> `LC_ALL` / `LC_MESSAGES` /
  *   `LANG` 第一个非空值；`/^zh/i` → zh，其余（含 `C` / `POSIX` / 空 / 判断不出）→ en。

package/dist/i18n/index.js

@@ -1,5 +1,5 @@
 /**
- * 界面语言（docs/wave6-plan.md §5.1、§5.2、D18；docs/i18n.md）。[W6-C0]
+ * 界面语言（docs/history/wave6-plan.md §5.1、§5.2、D18；docs/guides/i18n.md）。[W6-C0]
  *
  * - 语言优先级：`AMA_LANG` > `--lang` > `ui.language`（`auto` 视为未设）> `LC_ALL` / `LC_MESSAGES` /
  *   `LANG` 第一个非空值；`/^zh/i` → zh，其余（含 `C` / `POSIX` / 空 / 判断不出）→ en。

package/dist/i18n/messages/acp.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：acp（键名规范见 docs/i18n.md）。[ACP-C0 从 print.acp 迁入，docs/acp-plan.md D15]
+ * 消息目录：acp（键名规范见 docs/guides/i18n.md）。[ACP-C0 从 print.acp 迁入，docs/history/acp-plan.md D15]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/acp.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：acp（键名规范见 docs/i18n.md）。[ACP-C0 从 print.acp 迁入，docs/acp-plan.md D15]
+ * 消息目录：acp（键名规范见 docs/guides/i18n.md）。[ACP-C0 从 print.acp 迁入，docs/history/acp-plan.md D15]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/agents.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：agents（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-A]
+ * 消息目录：agents（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-A]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/agents.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：agents（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-A]
+ * 消息目录：agents（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-A]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/approval.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：approval（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ * 消息目录：approval（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-I2]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/approval.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：approval（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ * 消息目录：approval（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-I2]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/auth.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：auth（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-O]
+ * 消息目录：auth（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-O]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/auth.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：auth（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-O]
+ * 消息目录：auth（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-O]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/cli.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：cli（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I1 迁入 `src/cli/**` 的界面文案]
+ * 消息目录：cli（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，W6-I1 迁入 `src/cli/**` 的界面文案]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/cli.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：cli（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I1 迁入 `src/cli/**` 的界面文案]
+ * 消息目录：cli（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，W6-I1 迁入 `src/cli/**` 的界面文案]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/config-keys.js

@@ -60,8 +60,8 @@ const keysEn = {
     version: "Config file format version; always 1",
     defaultModel: "Default model provider/model or provider/model@channel; when unset it is picked automatically (ama config show shows which one and why)",
     thinkingLevel: "Thinking level",
-    providers: "Custom providers and overrides of built-in providers (docs/providers.md)",
-    permission: "Permissions (docs/permissions.md)",
+    providers: "Custom providers and overrides of built-in providers (docs/guides/providers.md)",
+    permission: "Permissions (docs/guides/permissions.md)",
     "permission.mode": "Permission mode; project level can only make it stricter",
     "permission.allow": "Allow rules, e.g. bash(npm test); cannot be added at project level",
     "permission.deny": "Deny rules, e.g. write(**/.env); accumulated across levels",
@@ -88,7 +88,7 @@ const keysEn = {
     "tools.maxToolResultChars": "Character limit for one tool result in the context; beyond it head and tail are kept",
     "tools.bashTimeoutMs": "Default bash timeout (ms; overridable per call, max 600000)",
     "tools.disabled": "Disabled tool names; accumulated across levels",
-    codemode: "codemode: the model writes scripts that call tools in batches (docs/codemode.md)",
+    codemode: "codemode: the model writes scripts that call tools in batches (docs/guides/codemode.md)",
     "codemode.mode": "off | on | only; when unset it follows the preset: default → on (Node ≥ 25; Node 22 / 24 → off), codemode-only → only, minimal / coordinator → off; project level only accepts off",
     "codemode.inlineBudget": "Budget (estimated tokens) for inlining tool declarations in the description in only mode; beyond it only names are listed",
     "codemode.requireStrict": "true: disable codemode when the runtime Node does not isolate the network (Node 22 / 24)",
@@ -112,7 +112,7 @@ const keysEn = {
     "ui.language": "Interface language: auto decides from LC_ALL / LC_MESSAGES / LANG (zh* is Chinese, anything else English), zh, en; AMA_LANG and --lang override; affects the interface only, text sent to the model is always English",
     "ui.replyLanguage": "Reply language for the model (e.g. Chinese): one English rule is appended to the end of the rules section at session start; zero-byte change when unset; user level only (effective from wave 6)",
     "ui.agentBar": "Agent bar (sub-agent list above the status line): auto shows it while tasks exist, off hides it; press ↓ on an empty input to enter it",
-    memory: "Cross-session memory (docs/memory.md): off by default, requests are byte-identical while off; project level can only set enabled: false (effective from wave 6 W6-M)",
+    memory: "Cross-session memory (docs/guides/memory.md): off by default, requests are byte-identical while off; project level can only set enabled: false (effective from wave 6 W6-M)",
     "memory.enabled": "Master switch; --memory / --no-memory and AMA_MEMORY=0|1 override",
     "memory.scopes": "Enabled scopes: user (data directory, across projects), project (keyed by a hash of the repository path)",
     "memory.indexMaxBytes": "Per-scope limit for the index in the system prompt (bytes); truncated by update time beyond it",
@@ -138,11 +138,11 @@ const keysEn = {
     "cache.minSavingsUsd": "Minimum expected savings (USD) for warming",
     "cache.missNotices": "Show cache misses and remaining context in the message area",
     "cache.warmSubagents": "Also warm sub-sessions (task)",
-    checkpoints: 'Checkpoints: file backups used to roll back code (docs/sessions.md "Checkpoints and file backups")',
+    checkpoints: 'Checkpoints: file backups used to roll back code (docs/guides/sessions.md "Checkpoints and file backups")',
     "checkpoints.mode": "tools: track files changed by edit / write; shadow-git: also snapshot the whole working directory with a shadow git so direct changes (bash etc.) can be rolled back too (needs git; large directories fall back to tools); off: disabled; AMA_CHECKPOINTS overrides; project level only accepts off",
     "checkpoints.maxFileBytes": "Backup limit for a single file (bytes); larger files are not backed up and rollback reports them as unrecoverable; project level can only lower it",
     "checkpoints.keep": "Number of recent checkpoints available for rollback; older ones are no longer listed; user level / profile only",
-    sandbox: 'OS-level sandbox (docs/sandbox.md); user level / profile only, project level only accepts network: "deny"',
+    sandbox: 'OS-level sandbox (docs/guides/sandbox.md); user level / profile only, project level only accepts network: "deny"',
     "sandbox.enabled": "auto: use macOS sandbox-exec / Linux bwrap or unshare when available (codemode child processes are denied network and writes; this isolates codemode's network on Node 22 / 24); off: not used; AMA_SANDBOX=off overrides",
     "sandbox.bash": "auto: run bash through sandbox-exec / bwrap (unshare does not count), writes limited to the workspace, temp dir, output dir and sandbox.writable, and sandboxed commands need no approval in default mode; off: not used; user level / profile only",
     "sandbox.network": "Network inside the bash sandbox: deny blocks it (required for approval-free sandboxed commands); allow permits network but writes stay limited and approval works as usual; project level can only set deny",
@@ -189,8 +189,8 @@ const keysZh = {
     version: "配置文件格式版本，固定为 1",
     defaultModel: "缺省模型 provider/model 或 provider/model@channel；不写时零配置自动选择（ama config show 显示选了谁、为什么）",
     thinkingLevel: "思考强度",
-    providers: "自定义供应商与对内置供应商的覆盖（docs/providers.md）",
-    permission: "权限（docs/permissions.md）",
+    providers: "自定义供应商与对内置供应商的覆盖（docs/guides/providers.md）",
+    permission: "权限（docs/guides/permissions.md）",
     "permission.mode": "权限模式；项目级只能更严",
     "permission.allow": "放行规则，如 bash(npm test)；项目级不能加",
     "permission.deny": "拒绝规则，如 write(**/.env)；各层累加",
@@ -217,7 +217,7 @@ const keysZh = {
     "tools.maxToolResultChars": "单条工具结果进上下文的字符上限，超出保留首尾",
     "tools.bashTimeoutMs": "bash 缺省超时（毫秒，单次调用可覆盖，最大 600000）",
     "tools.disabled": "禁用的工具名；各层累加",
-    codemode: "codemode：模型写脚本批量调用工具（docs/codemode.md）",
+    codemode: "codemode：模型写脚本批量调用工具（docs/guides/codemode.md）",
     "codemode.mode": "off | on | only；不写时跟随预设：default → on（Node ≥ 25；Node 22 / 24 → off）、codemode-only → only、minimal / coordinator → off；项目级只接受 off",
     "codemode.inlineBudget": "only 模式在描述里内联工具声明的预算（估算 token），超出只列名字",
     "codemode.requireStrict": "true：运行时 Node 不隔离网络（Node 22 / 24）时直接禁用 codemode",
@@ -241,7 +241,7 @@ const keysZh = {
     "ui.language": "界面语言：auto 按 LC_ALL / LC_MESSAGES / LANG 判断（zh* 为中文，其余英文），zh，en；AMA_LANG、--lang 覆盖；只影响界面，发给模型的文本固定英文",
     "ui.replyLanguage": "模型回复语言（如 Chinese）：会话开始在 rules 节末尾追加一句英文规则；不设时零字节变化；只认用户级（第六波起生效）",
     "ui.agentBar": "Agent 栏（状态行上方的子 Agent 列表）：auto 有任务时显示，off 不显示；空输入时按 ↓ 进入",
-    memory: "跨会话记忆（docs/memory.md）：缺省关闭，关闭时请求逐字节不变；项目级只能设 enabled: false（第六波 W6-M 起生效）",
+    memory: "跨会话记忆（docs/guides/memory.md）：缺省关闭，关闭时请求逐字节不变；项目级只能设 enabled: false（第六波 W6-M 起生效）",
     "memory.enabled": "总开关；--memory / --no-memory、AMA_MEMORY=0|1 覆盖",
     "memory.scopes": "启用的作用域：user（数据目录，跨项目）、project（按仓库路径哈希）",
     "memory.indexMaxBytes": "每作用域索引进系统提示的上限（字节），超出按更新时间截断",
@@ -267,11 +267,11 @@ const keysZh = {
     "cache.minSavingsUsd": "保温的最低期望节省（美元）",
     "cache.missNotices": "在消息区提示缓存未命中与上下文余量",
     "cache.warmSubagents": "子会话（task）也保温",
-    checkpoints: "检查点：回滚代码用的文件备份（docs/sessions.md「检查点与文件备份」）",
+    checkpoints: "检查点：回滚代码用的文件备份（docs/guides/sessions.md「检查点与文件备份」）",
     "checkpoints.mode": "tools：跟踪 edit / write 改过的文件；shadow-git：另用影子 git 快照整个工作目录，bash 等直接改动也能回滚（需要 git，大目录自动降级为 tools）；off：关闭；AMA_CHECKPOINTS 覆盖；项目级只接受 off",
     "checkpoints.maxFileBytes": "单个文件的备份上限（字节），超出不备份、回滚时报告无法恢复；项目级只能调小",
     "checkpoints.keep": "可回滚的最近检查点数，更早的不再列为回滚点；只认用户级 / profile",
-    sandbox: '操作系统级沙箱（docs/sandbox.md）；只认用户级 / profile，项目级只接受 network: "deny"',
+    sandbox: '操作系统级沙箱（docs/guides/sandbox.md）；只认用户级 / profile，项目级只接受 network: "deny"',
     "sandbox.enabled": "auto：探测到可用的 macOS sandbox-exec / Linux bwrap、unshare 就用（codemode 子进程拒绝网络与写入；Node 22 / 24 上 codemode 因此网络隔离）；off：不用；AMA_SANDBOX=off 覆盖",
     "sandbox.bash": "auto：bash 经 sandbox-exec / bwrap 运行（unshare 不算），写入只限工作区、临时目录、输出目录与 sandbox.writable，default 模式下沙箱内命令免审批；off：不用；只认用户级 / profile",
     "sandbox.network": "bash 沙箱里的网络：deny 拒绝（沙箱内免审批的前提）；allow 允许联网但写入仍受限、照常审批；项目级只能设 deny",

package/dist/i18n/messages/config.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：config（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I4 迁入]
+ * 消息目录：config（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，W6-I4 迁入]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/config.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：config（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I4 迁入]
+ * 消息目录：config（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，W6-I4 迁入]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
@@ -110,7 +110,7 @@ export const en = {
     /** config.schema.json 里供应商内部字段的说明（顶层与各段的键用 `keys`）。 */
     jsonSchema: {
         api: "Protocol",
-        compat: 'Protocol compatibility switches (docs/providers.md "compat")',
+        compat: 'Protocol compatibility switches (docs/guides/providers.md "compat")',
         modelId: "Model id (the name sent upstream)",
         modelBaseUrl: "Overrides the channel / provider address",
         contextWindow: "Context tokens; filled from models.dev by default, not guessed when there is no match",
@@ -224,7 +224,7 @@ export const zh = {
     },
     jsonSchema: {
         api: "协议",
-        compat: "协议兼容开关（docs/providers.md「compat」）",
+        compat: "协议兼容开关（docs/guides/providers.md「compat」）",
         modelId: "模型 id（发给上游的名字）",
         modelBaseUrl: "覆盖渠道 / 供应商的地址",
         contextWindow: "上下文 token；缺省从 models.dev 补，匹配不到不猜",

package/dist/i18n/messages/drivers.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：drivers（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/{drivers,agents,hooks,host}/**`]
+ * 消息目录：drivers（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/{drivers,agents,hooks,host}/**`]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/drivers.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：drivers（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/{drivers,agents,hooks,host}/**`]
+ * 消息目录：drivers（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/{drivers,agents,hooks,host}/**`]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/errors.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：errors（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I3]
+ * 消息目录：errors（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-I3]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/errors.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：errors（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I3]
+ * 消息目录：errors（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-I3]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/interactive-line.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive 的行式界面部分（键名规范见 docs/i18n.md）。[W6-I2]
+ * 消息目录：interactive 的行式界面部分（键名规范见 docs/guides/i18n.md）。[W6-I2]
  *
  * 单文件 600 行上限，`interactive.ts` 拆出：`modes/interactive/line/**`（行式审批问句、事件行、选择列表、
  * 启动行与中断提示）。经 `msg().interactive.line` 取用。en 是形状源；zh 用 `satisfies Messages<typeof en>`。

package/dist/i18n/messages/interactive-line.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive 的行式界面部分（键名规范见 docs/i18n.md）。[W6-I2]
+ * 消息目录：interactive 的行式界面部分（键名规范见 docs/guides/i18n.md）。[W6-I2]
  *
  * 单文件 600 行上限，`interactive.ts` 拆出：`modes/interactive/line/**`（行式审批问句、事件行、选择列表、
  * 启动行与中断提示）。经 `msg().interactive.line` 取用。en 是形状源；zh 用 `satisfies Messages<typeof en>`。

package/dist/i18n/messages/interactive-startup.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive 的启动部分（键名规范见 docs/i18n.md）。[W6-I2]
+ * 消息目录：interactive 的启动部分（键名规范见 docs/guides/i18n.md）。[W6-I2]
  *
  * 单文件 600 行上限，`interactive.ts` 拆出：启动头（`startup-header.ts`）与启动期交互（`startup-ui.ts`：
  * 信任、恢复会话、选模型、工作目录）。经 `msg().interactive.startup` 取用。

package/dist/i18n/messages/interactive-startup.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive 的启动部分（键名规范见 docs/i18n.md）。[W6-I2]
+ * 消息目录：interactive 的启动部分（键名规范见 docs/guides/i18n.md）。[W6-I2]
  *
  * 单文件 600 行上限，`interactive.ts` 拆出：启动头（`startup-header.ts`）与启动期交互（`startup-ui.ts`：
  * 信任、恢复会话、选模型、工作目录）。经 `msg().interactive.startup` 取用。

package/dist/i18n/messages/interactive-view.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive 的消息区部分（键名规范见 docs/i18n.md）。[W6-I2]
+ * 消息目录：interactive 的消息区部分（键名规范见 docs/guides/i18n.md）。[W6-I2]
  *
  * 单文件 600 行上限，`interactive.ts` 拆出：消息区（`message-view.ts`）、运行指示（`run-indicator.ts`）、
  * 工具摘要与工具块（`tool-summary.ts`、`tool-view.ts`）。经 `msg().interactive.view` 取用。

package/dist/i18n/messages/interactive-view.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive 的消息区部分（键名规范见 docs/i18n.md）。[W6-I2]
+ * 消息目录：interactive 的消息区部分（键名规范见 docs/guides/i18n.md）。[W6-I2]
  *
  * 单文件 600 行上限，`interactive.ts` 拆出：消息区（`message-view.ts`）、运行指示（`run-indicator.ts`）、
  * 工具摘要与工具块（`tool-summary.ts`、`tool-view.ts`）。经 `msg().interactive.view` 取用。

package/dist/i18n/messages/interactive.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ * 消息目录：interactive（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-I2]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。

package/dist/i18n/messages/interactive.js

@@ -1,5 +1,5 @@
 /**
- * 消息目录：interactive（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ * 消息目录：interactive（键名规范见 docs/guides/i18n.md）。[W6-C0 建空壳，归 W6-I2]
  *
  * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。