@armadra/agent 0.8.0 → 0.8.1

package/dist/drivers/acp/types.js

@@ -1,5 +1,5 @@
 /**
- * ACP（Agent Client Protocol）v1 的子集类型（docs/wave5-plan.md §5.1，D14）。[W5-E]
+ * ACP（Agent Client Protocol）v1 的子集类型（docs/history/wave5-plan.md §5.1，D14）。[W5-E]
  *
  * 手写、零依赖；只收 ama 作为客户端（驱动外部 Agent）与服务端（`ama --mode acp`）两侧用到的部分：
  * `initialize`、`authenticate`、`session/new|load|resume|list|close`、`session/prompt|cancel|set_mode|set_config_option`、

package/dist/drivers/agents.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的入口（W5-G 的 `task(agent=…)` 经它拿 runner，docs/wave5-plan.md §5.5、§7.6、D13、D17）。[W5-E]
+ * 外部 Agent 的入口（W5-G 的 `task(agent=…)` 经它拿 runner，docs/history/wave5-plan.md §5.5、§7.6、D13、D17）。[W5-E]
  *
  * - `resolve("claude" | "codex" | "acp:<program>" | 表里的 id)` → {@link ProcessRunner}（按驱动表候选链，
  *   每次 `start` 时按模式与安装情况选驱动）；同一 spec 复用同一个 runner。

package/dist/drivers/agents.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 的入口（W5-G 的 `task(agent=…)` 经它拿 runner，docs/wave5-plan.md §5.5、§7.6、D13、D17）。[W5-E]
+ * 外部 Agent 的入口（W5-G 的 `task(agent=…)` 经它拿 runner，docs/history/wave5-plan.md §5.5、§7.6、D13、D17）。[W5-E]
  *
  * - `resolve("claude" | "codex" | "acp:<program>" | 表里的 id)` → {@link ProcessRunner}（按驱动表候选链，
  *   每次 `start` 时按模式与安装情况选驱动）；同一 spec 复用同一个 runner。

package/dist/drivers/base.d.ts

@@ -1,5 +1,5 @@
 /**
- * 各驱动共用的依赖与看门狗（docs/wave5-plan.md §5.4）。[W5-E]
+ * 各驱动共用的依赖与看门狗（docs/history/wave5-plan.md §5.4）。[W5-E]
  */
 import type { PermissionMode } from "../permissions/types.js";
 import type { CatalogCandidate } from "./catalog.js";

package/dist/drivers/base.js

@@ -1,5 +1,5 @@
 /**
- * 各驱动共用的依赖与看门狗（docs/wave5-plan.md §5.4）。[W5-E]
+ * 各驱动共用的依赖与看门狗（docs/history/wave5-plan.md §5.4）。[W5-E]
  */
 import { candidateCapabilities } from "./catalog.js";
 import { versionSatisfies } from "./probe.js";

package/dist/drivers/catalog.d.ts

@@ -1,5 +1,5 @@
 /**
- * 内置驱动表（数据，docs/wave5-plan.md §5.1 catalog.ts，D14）。[W5-E]
+ * 内置驱动表（数据，docs/history/wave5-plan.md §5.1 catalog.ts，D14）。[W5-E]
  *
  * agentId → 候选链；按 D14 的优先级排：原生 ACP > 已装 ACP 适配器 > 原生结构化协议 > 一次性打印。
  * 探测时取第一个已安装的候选。`verified` 是实测过的版本区间：越界仍可用，但发一条 warn 提示

package/dist/drivers/catalog.js

@@ -1,5 +1,5 @@
 /**
- * 内置驱动表（数据，docs/wave5-plan.md §5.1 catalog.ts，D14）。[W5-E]
+ * 内置驱动表（数据，docs/history/wave5-plan.md §5.1 catalog.ts，D14）。[W5-E]
  *
  * agentId → 候选链；按 D14 的优先级排：原生 ACP > 已装 ACP 适配器 > 原生结构化协议 > 一次性打印。
  * 探测时取第一个已安装的候选。`verified` 是实测过的版本区间：越界仍可用，但发一条 warn 提示

package/dist/drivers/env.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 子进程环境清理（docs/wave5-plan.md §5.4，D16）。[W5-E]
+ * 外部 Agent 子进程环境清理（docs/history/wave5-plan.md §5.4，D16）。[W5-E]
  *
  * ama 分不清「用户 shell 本来就有」与「为 ama 设的」变量，所以缺省全剥、显式放回：
  * - 删：`BUILTIN_PROVIDERS[].envKeys`（各家 API key）、`*_BASE_URL`、`AMA_*`、`CODEX_API_KEY`、

package/dist/drivers/env.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 子进程环境清理（docs/wave5-plan.md §5.4，D16）。[W5-E]
+ * 外部 Agent 子进程环境清理（docs/history/wave5-plan.md §5.4，D16）。[W5-E]
  *
  * ama 分不清「用户 shell 本来就有」与「为 ama 设的」变量，所以缺省全剥、显式放回：
  * - 删：`BUILTIN_PROVIDERS[].envKeys`（各家 API key）、`*_BASE_URL`、`AMA_*`、`CODEX_API_KEY`、

package/dist/drivers/host-runners.d.ts

@@ -1,5 +1,5 @@
 /**
- * 宿主注入的 runner（`HostApi.runners.provide` 的底座，docs/wave5-plan.md §5.5，D17）。[W5-E → W5-EG]
+ * 宿主注入的 runner（`HostApi.runners.provide` 的底座，docs/history/wave5-plan.md §5.5，D17）。[W5-E → W5-EG]
  *
  * 一个宿主适配器一份（host/api-impl.ts 建，经 {@link ExternalAgents} 的 `hostRunners` 选项交给每个
  * 主会话）：宿主可以在 `create()` 里或之后任何时候 `provide`，同名替换；返回的函数注销。

package/dist/drivers/host-runners.js

@@ -1,5 +1,5 @@
 /**
- * 宿主注入的 runner（`HostApi.runners.provide` 的底座，docs/wave5-plan.md §5.5，D17）。[W5-E → W5-EG]
+ * 宿主注入的 runner（`HostApi.runners.provide` 的底座，docs/history/wave5-plan.md §5.5，D17）。[W5-E → W5-EG]
  *
  * 一个宿主适配器一份（host/api-impl.ts 建，经 {@link ExternalAgents} 的 `hostRunners` 选项交给每个
  * 主会话）：宿主可以在 `create()` 里或之后任何时候 `provide`，同名替换；返回的函数注销。

package/dist/drivers/jsonrpc.d.ts

@@ -1,5 +1,5 @@
 /**
- * JSON-RPC 2.0 over NDJSON 的对等端（docs/wave5-plan.md §5.1）。[W5-E]
+ * JSON-RPC 2.0 over NDJSON 的对等端（docs/history/wave5-plan.md §5.1）。[W5-E]
  *
  * ACP 客户端 / 服务端与 Codex app-server 驱动共用：
  * - 分帧复用 `modes/rpc/jsonl.ts`（只按 `\n` 切行、64 KiB 分片写、背压等 drain），写入串行；

package/dist/drivers/jsonrpc.js

@@ -1,5 +1,5 @@
 /**
- * JSON-RPC 2.0 over NDJSON 的对等端（docs/wave5-plan.md §5.1）。[W5-E]
+ * JSON-RPC 2.0 over NDJSON 的对等端（docs/history/wave5-plan.md §5.1）。[W5-E]
  *
  * ACP 客户端 / 服务端与 Codex app-server 驱动共用：
  * - 分帧复用 `modes/rpc/jsonl.ts`（只按 `\n` 切行、64 KiB 分片写、背压等 drain），写入串行；

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

@@ -1,5 +1,5 @@
 /**
- * Claude Code stream-json → DriverEvent 的映射表（docs/wave5-plan.md §5.1 normalize，R2 §3.2）。[W5-E]
+ * Claude Code stream-json → DriverEvent 的映射表（docs/history/wave5-plan.md §5.1 normalize，R2 §3.2）。[W5-E]
  *
  * 线上形状按 Claude Code 2.1.x 的 `--output-format stream-json`（Agent SDK 所用的同一协议；
  * 官方称其不是公开的 CLI 接口，R3），只读用到的字段，其余忽略。

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

@@ -1,5 +1,5 @@
 /**
- * Claude Code stream-json → DriverEvent 的映射表（docs/wave5-plan.md §5.1 normalize，R2 §3.2）。[W5-E]
+ * Claude Code stream-json → DriverEvent 的映射表（docs/history/wave5-plan.md §5.1 normalize，R2 §3.2）。[W5-E]
  *
  * 线上形状按 Claude Code 2.1.x 的 `--output-format stream-json`（Agent SDK 所用的同一协议；
  * 官方称其不是公开的 CLI 接口，R3），只读用到的字段，其余忽略。

package/dist/drivers/native/claude-stream.d.ts

@@ -1,5 +1,5 @@
 /**
- * Claude Code 原生驱动：stream-json 长驻进程（docs/wave5-plan.md §5.1，R2 §1.2）。[W5-E]
+ * Claude Code 原生驱动：stream-json 长驻进程（docs/history/wave5-plan.md §5.1，R2 §1.2）。[W5-E]
  *
  * `claude -p --input-format stream-json --output-format stream-json --verbose
  *  --include-partial-messages --permission-prompt-tool stdio --permission-mode <m> --session-id <uuid>`

package/dist/drivers/native/claude-stream.js

@@ -1,5 +1,5 @@
 /**
- * Claude Code 原生驱动：stream-json 长驻进程（docs/wave5-plan.md §5.1，R2 §1.2）。[W5-E]
+ * Claude Code 原生驱动：stream-json 长驻进程（docs/history/wave5-plan.md §5.1，R2 §1.2）。[W5-E]
  *
  * `claude -p --input-format stream-json --output-format stream-json --verbose
  *  --include-partial-messages --permission-prompt-tool stdio --permission-mode <m> --session-id <uuid>`

package/dist/drivers/native/codex-app-server.d.ts

@@ -1,5 +1,5 @@
 /**
- * Codex 原生驱动：`codex app-server`（stdio JSON-RPC，docs/wave5-plan.md §5.1，R2 §1.3）。[W5-E]
+ * Codex 原生驱动：`codex app-server`（stdio JSON-RPC，docs/history/wave5-plan.md §5.1，R2 §1.3）。[W5-E]
  *
  * - `initialize{clientInfo}` → `initialized` 通知 → `thread/start`（或 `thread/resume`，带
  *   `excludeTurns` 不回放）→ 每回合 `turn/start`，以对应 turn 的 `turn/completed` 结束；

package/dist/drivers/native/codex-app-server.js

@@ -1,5 +1,5 @@
 /**
- * Codex 原生驱动：`codex app-server`（stdio JSON-RPC，docs/wave5-plan.md §5.1，R2 §1.3）。[W5-E]
+ * Codex 原生驱动：`codex app-server`（stdio JSON-RPC，docs/history/wave5-plan.md §5.1，R2 §1.3）。[W5-E]
  *
  * - `initialize{clientInfo}` → `initialized` 通知 → `thread/start`（或 `thread/resume`，带
  *   `excludeTurns` 不回放）→ 每回合 `turn/start`，以对应 turn 的 `turn/completed` 结束；

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 期报错。
  * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。