@armadra/agent 0.8.0 → 0.8.1

package/dist/memory/tool.js

@@ -1,5 +1,5 @@
 /**
- * `memory` 工具（docs/wave6-plan.md §3.3、D10）。[W6-M] 模型侧模块：不得 import src/i18n。
+ * `memory` 工具（docs/history/wave6-plan.md §3.3、D10）。[W6-M] 模型侧模块：不得 import src/i18n。
  *
  * 自定义工具（不声明供应商原生的 memory 工具类型），四个命令：`view / create / str_replace / delete`，路径限定
  * 在 `/memories/<scope>/`。权限类 `memory`：view 按读放行，写命令按 execute 判定（permissions/memory-class.ts）。

package/dist/modes/acp/acp-auth-gate.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的认证门（docs/acp-plan.md §2.2、D3、D4）。[ACP-A]
+ * `ama --mode acp` 的认证门（docs/history/acp-plan.md §2.2、D3、D4）。[ACP-A]
  *
  * bootstrap 因没有可用模型（退出码 4）失败时不退出，改为在同一条 stdio 上应答 ACP：
  * - `initialize` → 正常握手；客户端声明 `clientCapabilities.auth.terminal` 时给两条 terminal 型

package/dist/modes/acp/acp-auth-gate.js

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的认证门（docs/acp-plan.md §2.2、D3、D4）。[ACP-A]
+ * `ama --mode acp` 的认证门（docs/history/acp-plan.md §2.2、D3、D4）。[ACP-A]
  *
  * bootstrap 因没有可用模型（退出码 4）失败时不退出，改为在同一条 stdio 上应答 ACP：
  * - `initialize` → 正常握手；客户端声明 `clientCapabilities.auth.terminal` 时给两条 terminal 型

package/dist/modes/acp/acp-config.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的会话配置项与命令表（docs/acp-plan.md §1.6、D8、D9）。[ACP-C0 建壳，ACP-D 实现]
+ * `ama --mode acp` 的会话配置项与命令表（docs/history/acp-plan.md §1.6、D8、D9）。[ACP-C0 建壳，ACP-D 实现]
  *
  * - `buildConfigOptions`：`mode`（select，category `mode`，值是 ama 的权限模式，与 `modes` 同一状态）、
  *   `model`（select，category `model`，按供应商分组，值 `provider/model-id`）与 `thinking`（select，

package/dist/modes/acp/acp-config.js

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的会话配置项与命令表（docs/acp-plan.md §1.6、D8、D9）。[ACP-C0 建壳，ACP-D 实现]
+ * `ama --mode acp` 的会话配置项与命令表（docs/history/acp-plan.md §1.6、D8、D9）。[ACP-C0 建壳，ACP-D 实现]
  *
  * - `buildConfigOptions`：`mode`（select，category `mode`，值是 ama 的权限模式，与 `modes` 同一状态）、
  *   `model`（select，category `model`，按供应商分组，值 `provider/model-id`）与 `thinking`（select，

package/dist/modes/acp/acp-connection.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的连接：JSON-RPC 对等端 + `initialize` 协商结果（docs/acp-plan.md §1.6）。[ACP-C0]
+ * `ama --mode acp` 的连接：JSON-RPC 对等端 + `initialize` 协商结果（docs/history/acp-plan.md §1.6）。[ACP-C0]
  *
  * 认证门（无模型时的握手，acp-auth-gate.ts）与服务端（acp-server.ts）共用同一条连接：门控在
  * bootstrap 成功后把它交给 `AcpServer`，客户端不必重新 `initialize`。对等端开着协议级取消

package/dist/modes/acp/acp-connection.js

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的连接：JSON-RPC 对等端 + `initialize` 协商结果（docs/acp-plan.md §1.6）。[ACP-C0]
+ * `ama --mode acp` 的连接：JSON-RPC 对等端 + `initialize` 协商结果（docs/history/acp-plan.md §1.6）。[ACP-C0]
  *
  * 认证门（无模型时的握手，acp-auth-gate.ts）与服务端（acp-server.ts）共用同一条连接：门控在
  * bootstrap 成功后把它交给 `AcpServer`，客户端不必重新 `initialize`。对等端开着协议级取消

package/dist/modes/acp/acp-events.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp`：ama 的会话事件 → ACP `session/update`（docs/wave5-plan.md §5.6、docs/acp-plan.md §2.3）。
+ * `ama --mode acp`：ama 的会话事件 → ACP `session/update`（docs/history/wave5-plan.md §5.6、docs/history/acp-plan.md §2.3）。
  *
  * | ama                                       | ACP                                                              |
  * | ----------------------------------------- | ---------------------------------------------------------------- |

package/dist/modes/acp/acp-events.js

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp`：ama 的会话事件 → ACP `session/update`（docs/wave5-plan.md §5.6、docs/acp-plan.md §2.3）。
+ * `ama --mode acp`：ama 的会话事件 → ACP `session/update`（docs/history/wave5-plan.md §5.6、docs/history/acp-plan.md §2.3）。
  *
  * | ama                                       | ACP                                                              |
  * | ----------------------------------------- | ---------------------------------------------------------------- |

package/dist/modes/acp/acp-mode.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的进程入口（docs/wave5-plan.md §5.6）。[W5-E]
+ * `ama --mode acp` 的进程入口（docs/history/wave5-plan.md §5.6）。[W5-E]
  *
  * - stdin / stdout 是 ACP（JSON-RPC 2.0 over NDJSON），不发 hello（ACP 由客户端 `initialize` 起头）；
  *   诊断与宿主通知写 stderr。

package/dist/modes/acp/acp-mode.js

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的进程入口（docs/wave5-plan.md §5.6）。[W5-E]
+ * `ama --mode acp` 的进程入口（docs/history/wave5-plan.md §5.6）。[W5-E]
  *
  * - stdin / stdout 是 ACP（JSON-RPC 2.0 over NDJSON），不发 hello（ACP 由客户端 `initialize` 起头）；
  *   诊断与宿主通知写 stderr。

package/dist/modes/acp/acp-server.d.ts

@@ -1,6 +1,6 @@
 /**
- * `ama --mode acp`：把 ama 的会话暴露为 ACP Agent（docs/wave5-plan.md §5.6，D14；多会话见
- * docs/acp-plan.md D1、D2、D11、D12、§2.1）。[W5-E，ACP-B]
+ * `ama --mode acp`：把 ama 的会话暴露为 ACP Agent（docs/history/wave5-plan.md §5.6，D14；多会话见
+ * docs/history/acp-plan.md D1、D2、D11、D12、§2.1）。[W5-E，ACP-B]
  *
  * 与 `--mode rpc` 同一引擎（Runtime + 组装根）。多会话：
  * - 每个 ACP sessionId 一个常驻会话（会话池，acp-sessions.ts），各有自己的事件映射器与权限模式；

package/dist/modes/acp/acp-server.js

@@ -1,6 +1,6 @@
 /**
- * `ama --mode acp`：把 ama 的会话暴露为 ACP Agent（docs/wave5-plan.md §5.6，D14；多会话见
- * docs/acp-plan.md D1、D2、D11、D12、§2.1）。[W5-E，ACP-B]
+ * `ama --mode acp`：把 ama 的会话暴露为 ACP Agent（docs/history/wave5-plan.md §5.6，D14；多会话见
+ * docs/history/acp-plan.md D1、D2、D11、D12、§2.1）。[W5-E，ACP-B]
  *
  * 与 `--mode rpc` 同一引擎（Runtime + 组装根）。多会话：
  * - 每个 ACP sessionId 一个常驻会话（会话池，acp-sessions.ts），各有自己的事件映射器与权限模式；

package/dist/modes/acp/acp-sessions.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的多会话：会话池条目、FIFO 提示队列、`session/list` 的分页与标题（docs/acp-plan.md
+ * `ama --mode acp` 的多会话：会话池条目、FIFO 提示队列、`session/list` 的分页与标题（docs/history/acp-plan.md
  * D1、D2、D11、§2.1）。[ACP-B]
  *
  * - 每个 ACP sessionId 一个常驻会话（{@link PooledSession}），各有自己的事件映射器与权限模式；
@@ -81,7 +81,7 @@ export declare function decodeCursor(cursor: unknown): {
 /** 一页会话（`cursor` 缺省从头）。 */
 export declare function pageSessions(items: readonly SessionListItem[], cursor: unknown, pageSize?: number): AcpListSessionsResult;
 /**
- * 跑一个出队的提示（docs/memory-plan.md D4、§2.2，Issue #139）。[M-A]
+ * 跑一个出队的提示（docs/history/memory-plan.md D4、§2.2，Issue #139）。[M-A]
  *
  * 后台子 Agent 的完成通知以 `followUp` 在会话空闲时开回合，不经 {@link PromptQueue}；那一回合在跑时
  * 直接 `prompt` 会报 busy。这里先等它结束；与通知器竞速输了（等到空闲后它抢先开了回合）再等一轮。

package/dist/modes/acp/acp-sessions.js

@@ -1,5 +1,5 @@
 /**
- * `ama --mode acp` 的多会话：会话池条目、FIFO 提示队列、`session/list` 的分页与标题（docs/acp-plan.md
+ * `ama --mode acp` 的多会话：会话池条目、FIFO 提示队列、`session/list` 的分页与标题（docs/history/acp-plan.md
  * D1、D2、D11、§2.1）。[ACP-B]
  *
  * - 每个 ACP sessionId 一个常驻会话（{@link PooledSession}），各有自己的事件映射器与权限模式；
@@ -158,7 +158,7 @@ export function pageSessions(items, cursor, pageSize = LIST_PAGE_SIZE) {
         : { sessions };
 }
 /**
- * 跑一个出队的提示（docs/memory-plan.md D4、§2.2，Issue #139）。[M-A]
+ * 跑一个出队的提示（docs/history/memory-plan.md D4、§2.2，Issue #139）。[M-A]
  *
  * 后台子 Agent 的完成通知以 `followUp` 在会话空闲时开回合，不经 {@link PromptQueue}；那一回合在跑时
  * 直接 `prompt` 会报 busy。这里先等它结束；与通知器竞速输了（等到空闲后它抢先开了回合）再等一轮。

package/dist/modes/acp/acp-tool-text.d.ts

@@ -1,6 +1,6 @@
 /**
  * `ama --mode acp` 工具调用的展示字段：title / kind / locations、结果文本（前 4 KB）与 diff 内容。
- * [ACP-C] 从 acp-events.ts 拆出（docs/acp-plan.md §2.3、D5、D6）。
+ * [ACP-C] 从 acp-events.ts 拆出（docs/history/acp-plan.md §2.3、D5、D6）。
  *
  * - codemode 内层调用（带 parentToolCallId）的 title 加前缀 `acp.tools.codemodePrefix`；
  * - `tool_execution_end` 的 `content` = `[diff?, text]`：diff 来自 `ToolResult.fileChange`（edit / write

package/dist/modes/acp/acp-tool-text.js

@@ -1,6 +1,6 @@
 /**
  * `ama --mode acp` 工具调用的展示字段：title / kind / locations、结果文本（前 4 KB）与 diff 内容。
- * [ACP-C] 从 acp-events.ts 拆出（docs/acp-plan.md §2.3、D5、D6）。
+ * [ACP-C] 从 acp-events.ts 拆出（docs/history/acp-plan.md §2.3、D5、D6）。
  *
  * - codemode 内层调用（带 parentToolCallId）的 title 加前缀 `acp.tools.codemodePrefix`；
  * - `tool_execution_end` 的 `content` = `[diff?, text]`：diff 来自 `ToolResult.fileChange`（edit / write

package/dist/modes/commands-core.js

@@ -30,7 +30,7 @@ export { describeSession } from "./session-report.js";
 /** [W6-C0] 各功能批次实现的第六波命令（没有处理器时回「尚未提供」）。 */
 export const W6_COMMANDS = ["config", "trace", "memory"];
 /**
- * 说明与需要翻译的参数占位按界面语言取（getter，不在 import 时定死，docs/i18n.md）；
+ * 说明与需要翻译的参数占位按界面语言取（getter，不在 import 时定死，docs/guides/i18n.md）；
  * `args` 是字符串时原样（不含要翻译的词），是 `{ key }` 时取目录里的占位。
  */
 function command(name, key, args) {

package/dist/modes/image-input.d.ts

@@ -1,5 +1,5 @@
 /**
- * 用户侧的图片输入（docs/providers.md「图像输入」）：`ama -p --image`、交互 / 行式界面里的 `@图片路径`
+ * 用户侧的图片输入（docs/guides/providers.md「图像输入」）：`ama -p --image`、交互 / 行式界面里的 `@图片路径`
  * 与粘贴 / 拖入的图片文件路径。
  *
  * - `--image` 与 `@路径` 是显式附件：文件不存在、不是图片、超过上限，或当前模型 `input` 不含 image

package/dist/modes/image-input.js

@@ -1,5 +1,5 @@
 /**
- * 用户侧的图片输入（docs/providers.md「图像输入」）：`ama -p --image`、交互 / 行式界面里的 `@图片路径`
+ * 用户侧的图片输入（docs/guides/providers.md「图像输入」）：`ama -p --image`、交互 / 行式界面里的 `@图片路径`
  * 与粘贴 / 拖入的图片文件路径。
  *
  * - `--image` 与 `@路径` 是显式附件：文件不存在、不是图片、超过上限，或当前模型 `input` 不含 image

package/dist/modes/interactive/agent-bar.d.ts

@@ -1,5 +1,5 @@
 /**
- * Agent 栏（docs/wave6-plan.md §1.1–§1.2、D1、D4）。[W6-A]
+ * Agent 栏（docs/history/wave6-plan.md §1.1–§1.2、D1、D4）。[W6-A]
  *
  * 装配在提示行之下、状态行之上。每个任务一行，最多 3 行，多出的给一行「另 N 个」：
  *

package/dist/modes/interactive/agent-bar.js

@@ -1,5 +1,5 @@
 /**
- * Agent 栏（docs/wave6-plan.md §1.1–§1.2、D1、D4）。[W6-A]
+ * Agent 栏（docs/history/wave6-plan.md §1.1–§1.2、D1、D4）。[W6-A]
  *
  * 装配在提示行之下、状态行之上。每个任务一行，最多 3 行，多出的给一行「另 N 个」：
  *

package/dist/modes/interactive/agent-transcript.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 视图的正文（docs/wave6-plan.md §1.2、D2）。[W6-A]
+ * 子 Agent 视图的正文（docs/history/wave6-plan.md §1.2、D2）。[W6-A]
  *
  * - `AmaTranscript`：ama 子会话的全量消息，复用消息区的 `MessageView` / `ToolTracker` 渲染；先按条目重放
  *   （句柄在内存时读 `entries()`，被 LRU 释放或 resume 后只读加载子会话文件），运行中再跟随子会话事件。

package/dist/modes/interactive/agent-transcript.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 视图的正文（docs/wave6-plan.md §1.2、D2）。[W6-A]
+ * 子 Agent 视图的正文（docs/history/wave6-plan.md §1.2、D2）。[W6-A]
  *
  * - `AmaTranscript`：ama 子会话的全量消息，复用消息区的 `MessageView` / `ToolTracker` 渲染；先按条目重放
  *   （句柄在内存时读 `entries()`，被 LRU 释放或 resume 后只读加载子会话文件），运行中再跟随子会话事件。

package/dist/modes/interactive/agent-view.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 视图（docs/wave6-plan.md §1.1–§1.2、D2、D3）。[W6-A]
+ * 子 Agent 视图（docs/history/wave6-plan.md §1.1–§1.2、D2、D3）。[W6-A]
  *
  * 主屏约束下的「全屏」：底部覆盖层，高度 = 终端行数 − 1（不切备用屏；撤掉覆盖层后消息区与回滚历史不变）。
  *

package/dist/modes/interactive/agent-view.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 视图（docs/wave6-plan.md §1.1–§1.2、D2、D3）。[W6-A]
+ * 子 Agent 视图（docs/history/wave6-plan.md §1.1–§1.2、D2、D3）。[W6-A]
  *
  * 主屏约束下的「全屏」：底部覆盖层，高度 = 终端行数 − 1（不切备用屏；撤掉覆盖层后消息区与回滚历史不变）。
  *

package/dist/modes/interactive/approval-dock.d.ts

@@ -1,5 +1,5 @@
 /**
- * 后台任务的审批停靠（docs/agents-concurrency-plan.md §2.7、D6）。[W7-C]
+ * 后台任务的审批停靠（docs/history/agents-concurrency-plan.md §2.7、D6）。[W7-C]
  *
  * 套在审批对话框 broker 外面：请求带 `context.taskId` 且该任务在后台运行（含转后台）时，主会话忙、输入框有
  * 草稿或已有覆盖层就不弹框，先「停靠」——Agent 栏该任务行显示「等待审批」（agent-ui.ts 按

package/dist/modes/interactive/approval-dock.js

@@ -1,5 +1,5 @@
 /**
- * 后台任务的审批停靠（docs/agents-concurrency-plan.md §2.7、D6）。[W7-C]
+ * 后台任务的审批停靠（docs/history/agents-concurrency-plan.md §2.7、D6）。[W7-C]
  *
  * 套在审批对话框 broker 外面：请求带 `context.taskId` 且该任务在后台运行（含转后台）时，主会话忙、输入框有
  * 草稿或已有覆盖层就不弹框，先「停靠」——Agent 栏该任务行显示「等待审批」（agent-ui.ts 按

package/dist/modes/interactive/config-panel.d.ts

@@ -1,5 +1,5 @@
 /**
- * `/config` settings panel component (docs/wave6-plan.md §6.3, D24-D26). [W6-S]
+ * `/config` settings panel component (docs/history/wave6-plan.md §6.3, D24-D26). [W6-S]
  *
  * Bottom overlay with the card bar: title + write target (`Tab` switches user / project), a search line,
  * the grouped `SettingsList`, a rule, the selected key's description (key-docs, dim, wrapped), one notice

package/dist/modes/interactive/config-panel.js

@@ -1,5 +1,5 @@
 /**
- * `/config` settings panel component (docs/wave6-plan.md §6.3, D24-D26). [W6-S]
+ * `/config` settings panel component (docs/history/wave6-plan.md §6.3, D24-D26). [W6-S]
  *
  * Bottom overlay with the card bar: title + write target (`Tab` switches user / project), a search line,
  * the grouped `SettingsList`, a rule, the selected key's description (key-docs, dim, wrapped), one notice

package/dist/modes/interactive/config-ui.d.ts

@@ -1,5 +1,5 @@
 /**
- * `/config` controller (docs/wave6-plan.md §6.3, D24-D26). [W6-S]
+ * `/config` controller (docs/history/wave6-plan.md §6.3, D24-D26). [W6-S]
  *
  * - `open("")` shows the panel (config-panel.ts); `open("key=value")` / `open("key value")` sets one key
  *   in the user config without the panel (same path as `ama config set`).

package/dist/modes/interactive/config-ui.js

@@ -1,5 +1,5 @@
 /**
- * `/config` controller (docs/wave6-plan.md §6.3, D24-D26). [W6-S]
+ * `/config` controller (docs/history/wave6-plan.md §6.3, D24-D26). [W6-S]
  *
  * - `open("")` shows the panel (config-panel.ts); `open("key=value")` / `open("key value")` sets one key
  *   in the user config without the panel (same path as `ama config set`).

package/dist/modes/interactive/memory-panel.d.ts

@@ -1,5 +1,5 @@
 /**
- * `/memory`（docs/wave6-plan.md §3.5）。[W6-M]
+ * `/memory`（docs/history/wave6-plan.md §3.5）。[W6-M]
  *
  * | 输入                         | 交互界面                                   | 行式界面                       |
  * | ---------------------------- | ------------------------------------------ | ------------------------------ |

package/dist/modes/interactive/memory-panel.js

@@ -1,5 +1,5 @@
 /**
- * `/memory`（docs/wave6-plan.md §3.5）。[W6-M]
+ * `/memory`（docs/history/wave6-plan.md §3.5）。[W6-M]
  *
  * | 输入                         | 交互界面                                   | 行式界面                       |
  * | ---------------------------- | ------------------------------------------ | ------------------------------ |

package/dist/modes/interactive/plan-command.d.ts

@@ -2,7 +2,7 @@
  * `/plan` 的语义（line 模式与交互模式共用，经 commands-core）。[W5-U]
  *
  * - `/plan`：当前计划与状态（版本、状态、文件、步骤、待办进度、所处模式）；
- * - `/plan approve [模式|fresh]`：批准待审批的计划（没有计划块时把上一条回复当作计划，docs/wave5-plan.md
+ * - `/plan approve [模式|fresh]`：批准待审批的计划（没有计划块时把上一条回复当作计划，docs/history/wave5-plan.md
  *   §6.3）；模式缺省回到进入 plan 前的模式，`fresh` 在新会话里执行（新建会话 → `adopt(plan)` → 发计划
  *   全文）；
  * - `/plan reject`：放弃待审批的计划（留在 Plan 模式）；

package/dist/modes/interactive/plan-command.js

@@ -2,7 +2,7 @@
  * `/plan` 的语义（line 模式与交互模式共用，经 commands-core）。[W5-U]
  *
  * - `/plan`：当前计划与状态（版本、状态、文件、步骤、待办进度、所处模式）；
- * - `/plan approve [模式|fresh]`：批准待审批的计划（没有计划块时把上一条回复当作计划，docs/wave5-plan.md
+ * - `/plan approve [模式|fresh]`：批准待审批的计划（没有计划块时把上一条回复当作计划，docs/history/wave5-plan.md
  *   §6.3）；模式缺省回到进入 plan 前的模式，`fresh` 在新会话里执行（新建会话 → `adopt(plan)` → 发计划
  *   全文）；
  * - `/plan reject`：放弃待审批的计划（留在 Plan 模式）；

package/dist/modes/interactive/plan-dialog.d.ts

@@ -1,5 +1,5 @@
 /**
- * 计划审批对话框（docs/wave5-plan.md §6.1、§6.3）：底部覆盖层，与权限审批框同一手法。[W5-U]
+ * 计划审批对话框（docs/history/wave5-plan.md §6.1、§6.3）：底部覆盖层，与权限审批框同一手法。[W5-U]
  *
  * ```
  * ╭─ 计划待审批 ──────────────────────────────────────────────╮

package/dist/modes/interactive/plan-dialog.js

@@ -1,5 +1,5 @@
 /**
- * 计划审批对话框（docs/wave5-plan.md §6.1、§6.3）：底部覆盖层，与权限审批框同一手法。[W5-U]
+ * 计划审批对话框（docs/history/wave5-plan.md §6.1、§6.3）：底部覆盖层，与权限审批框同一手法。[W5-U]
  *
  * ```
  * ╭─ 计划待审批 ──────────────────────────────────────────────╮

package/dist/modes/interactive/plan-flow.d.ts

@@ -1,5 +1,5 @@
 /**
- * 交互界面的计划审批编排（docs/wave5-plan.md §6.1）：把会话的计划审批交给对话框。[W5-U]
+ * 交互界面的计划审批编排（docs/history/wave5-plan.md §6.1）：把会话的计划审批交给对话框。[W5-U]
  *
  * - `attach(session)`：`planController(session).setAttendance("callback", …)`——计划提出后（会话空闲时）
  *   打开审批框；同时关掉 W5-F 的文本回复审批与 `ama.plan_notice` 提示行（两者只在 `text` 时生效）。

package/dist/modes/interactive/plan-flow.js

@@ -1,5 +1,5 @@
 /**
- * 交互界面的计划审批编排（docs/wave5-plan.md §6.1）：把会话的计划审批交给对话框。[W5-U]
+ * 交互界面的计划审批编排（docs/history/wave5-plan.md §6.1）：把会话的计划审批交给对话框。[W5-U]
  *
  * - `attach(session)`：`planController(session).setAttendance("callback", …)`——计划提出后（会话空闲时）
  *   打开审批框；同时关掉 W5-F 的文本回复审批与 `ama.plan_notice` 提示行（两者只在 `text` 时生效）。

package/dist/modes/interactive/subagent-view.d.ts

@@ -1,5 +1,5 @@
 /**
- * 消息区的子 Agent 折叠视图（docs/wave5-plan.md §7.5）。[W5-U]
+ * 消息区的子 Agent 折叠视图（docs/history/wave5-plan.md §7.5）。[W5-U]
  *
  * 消费 `subagent_start / update / end`，按 taskId 记下类型、状态、轮数、最近 3 个工具与用量；task 工具行
  * （tool-view.ts）据 `parentToolCallId` 取来显示一行：

package/dist/modes/interactive/subagent-view.js

@@ -1,5 +1,5 @@
 /**
- * 消息区的子 Agent 折叠视图（docs/wave5-plan.md §7.5）。[W5-U]
+ * 消息区的子 Agent 折叠视图（docs/history/wave5-plan.md §7.5）。[W5-U]
  *
  * 消费 `subagent_start / update / end`，按 taskId 记下类型、状态、轮数、最近 3 个工具与用量；task 工具行
  * （tool-view.ts）据 `parentToolCallId` 取来显示一行：

package/dist/modes/interactive/task-background.d.ts

@@ -1,5 +1,5 @@
 /**
- * 前台子 Agent 任务转后台与栏内停止的界面接线（docs/agents-concurrency-plan.md §2.4、§2.8）。[W7-C]
+ * 前台子 Agent 任务转后台与栏内停止的界面接线（docs/history/agents-concurrency-plan.md §2.4、§2.8）。[W7-C]
  *
  * - `Ctrl+B`（`app.tasks.background`）：有阻塞中的前台任务（`registry.blocking()`，含 `task_ctl wait`）时
  *   全部转后台（`session.backgroundTask(undefined, "user")`），不看输入框；没有时落回编辑器。

package/dist/modes/interactive/task-background.js

@@ -1,5 +1,5 @@
 /**
- * 前台子 Agent 任务转后台与栏内停止的界面接线（docs/agents-concurrency-plan.md §2.4、§2.8）。[W7-C]
+ * 前台子 Agent 任务转后台与栏内停止的界面接线（docs/history/agents-concurrency-plan.md §2.4、§2.8）。[W7-C]
  *
  * - `Ctrl+B`（`app.tasks.background`）：有阻塞中的前台任务（`registry.blocking()`，含 `task_ctl wait`）时
  *   全部转后台（`session.backgroundTask(undefined, "user")`），不看输入框；没有时落回编辑器。

package/dist/modes/interactive/trace-view.d.ts

@@ -1,5 +1,5 @@
 /**
- * `/trace` 覆盖层（docs/wave6-plan.md §2.4）。[W6-T1]
+ * `/trace` 覆盖层（docs/history/wave6-plan.md §2.4）。[W6-T1]
  *
  * - `/trace`（当前会话）、`/trace t2`（以任务 t2 为根：ama 子会话的子轨迹，或外部 Agent 骨架）。
  * - 主屏约束下的覆盖层：`anchor: "bottom"`、高度 `rows − 1`（同 rewind 面板）；退出撤掉覆盖层，消息区不变。

package/dist/modes/interactive/trace-view.js

@@ -1,5 +1,5 @@
 /**
- * `/trace` 覆盖层（docs/wave6-plan.md §2.4）。[W6-T1]
+ * `/trace` 覆盖层（docs/history/wave6-plan.md §2.4）。[W6-T1]
  *
  * - `/trace`（当前会话）、`/trace t2`（以任务 t2 为根：ama 子会话的子轨迹，或外部 Agent 骨架）。
  * - 主屏约束下的覆盖层：`anchor: "bottom"`、高度 `rows − 1`（同 rewind 面板）；退出撤掉覆盖层，消息区不变。

package/dist/modes/print/json-event.d.ts

@@ -4,7 +4,7 @@
  * - `message_update` 变成纯增量：去掉累计消息与 `partial`，附最新 `usage`；`done / error`
  *   保留最终 `message`。`tool_execution_end` 去掉 `result.fileChange`（[ACP-C0] 改前 / 改后全文只给
  *   ACP 映射用，不上 RPC / stream-json 线）。其余 `SessionEvent` 原样。
- * - [M-G] `compact`（RPC 客户端声明 `compact_events`，docs/memory-plan.md D9）：`compactEvent()` 去掉
+ * - [M-G] `compact`（RPC 客户端声明 `compact_events`，docs/history/memory-plan.md D9）：`compactEvent()` 去掉
  *   重复的大正文——`turn_end.toolResults[]` 每项只留 `{ toolCallId, toolName, isError, timestamp,
  *   contentOmitted }`；`message_start` 与 `entry_appended`（`message` 条目）里的 toolResult / 带图片的 user
  *   消息 `content` 换成 `""` 并加 `contentOmitted: true`。`message_end` 与 `tool_execution_end` 保持全量。

package/dist/modes/print/json-event.js

@@ -4,7 +4,7 @@
  * - `message_update` 变成纯增量：去掉累计消息与 `partial`，附最新 `usage`；`done / error`
  *   保留最终 `message`。`tool_execution_end` 去掉 `result.fileChange`（[ACP-C0] 改前 / 改后全文只给
  *   ACP 映射用，不上 RPC / stream-json 线）。其余 `SessionEvent` 原样。
- * - [M-G] `compact`（RPC 客户端声明 `compact_events`，docs/memory-plan.md D9）：`compactEvent()` 去掉
+ * - [M-G] `compact`（RPC 客户端声明 `compact_events`，docs/history/memory-plan.md D9）：`compactEvent()` 去掉
  *   重复的大正文——`turn_end.toolResults[]` 每项只留 `{ toolCallId, toolName, isError, timestamp,
  *   contentOmitted }`；`message_start` 与 `entry_appended`（`message` 条目）里的 toolResult / 带图片的 user
  *   消息 `content` 换成 `""` 并加 `contentOmitted: true`。`message_end` 与 `tool_execution_end` 保持全量。
@@ -34,7 +34,7 @@ export function compactEvent(event) {
                 return event;
             return {
                 ...event,
-                // 线上形状（docs/rpc.md）不是完整的 ToolResultMessage：正文与 details 都不带
+                // 线上形状（docs/reference/rpc.md）不是完整的 ToolResultMessage：正文与 details 都不带
                 toolResults: event.toolResults.map(({ toolCallId, toolName, isError, timestamp }) => ({
                     toolCallId,
                     toolName,

package/dist/modes/print/print-mode.d.ts

@@ -46,7 +46,7 @@ export declare function stdinWaitMs(env: Readonly<Record<string, string | undefi
 export declare function readPromptStdin(io: CliIo, prompt: string | undefined, mode: "auto" | "explicit" | "off", hintMs?: number): Promise<string>;
 export declare function runPrintMode(runtime: Runtime, context: ModeContext): Promise<number>;
 /**
- * [W7-B2] 主回合结束后等后台任务与它们的通知回合（docs/agents-concurrency-plan.md §2.6、§6 Q5）。
+ * [W7-B2] 主回合结束后等后台任务与它们的通知回合（docs/history/agents-concurrency-plan.md §2.6、§6 Q5）。
  * `settled()`（subagent-background.ts）等到没有运行中任务且通知投递链（含通知回合）结束；`stopped`：SIGINT /
  * SIGTERM、stdout 关闭或预算到限时 resolve，立即停止等待。没有子 Agent 注册表时直接返回。
  */

package/dist/modes/print/print-mode.js

@@ -270,7 +270,7 @@ export async function runPrintMode(runtime, context) {
     return ExitCode.Ok;
 }
 /**
- * [W7-B2] 主回合结束后等后台任务与它们的通知回合（docs/agents-concurrency-plan.md §2.6、§6 Q5）。
+ * [W7-B2] 主回合结束后等后台任务与它们的通知回合（docs/history/agents-concurrency-plan.md §2.6、§6 Q5）。
  * `settled()`（subagent-background.ts）等到没有运行中任务且通知投递链（含通知回合）结束；`stopped`：SIGINT /
  * SIGTERM、stdout 关闭或预算到限时 resolve，立即停止等待。没有子 Agent 注册表时直接返回。
  */

package/dist/modes/print/search-hint.d.ts

@@ -1,5 +1,5 @@
 /**
- * [S-A] `-p` 下 bash 搜索命令被拒时的一行提示（docs/search-plan.md §4.2）。
+ * [S-A] `-p` 下 bash 搜索命令被拒时的一行提示（docs/design/search-plan.md §4.2）。
  *
  * `minimal` / `coordinator` 预设没有 grep / glob，模型常改用 `bash grep` / `rg` / `find`，在无人值守下被拒后
  * 只能猜文件名（§1.3 E3）。这里只在「被拒的 bash 命令形如搜索」且活动集缺 grep 或 glob 时提示怎么加回来；

package/dist/modes/print/search-hint.js

@@ -1,5 +1,5 @@
 /**
- * [S-A] `-p` 下 bash 搜索命令被拒时的一行提示（docs/search-plan.md §4.2）。
+ * [S-A] `-p` 下 bash 搜索命令被拒时的一行提示（docs/design/search-plan.md §4.2）。
  *
  * `minimal` / `coordinator` 预设没有 grep / glob，模型常改用 `bash grep` / `rg` / `find`，在无人值守下被拒后
  * 只能猜文件名（§1.3 E3）。这里只在「被拒的 bash 命令形如搜索」且活动集缺 grep 或 glob 时提示怎么加回来；

package/dist/modes/rpc/commands.js

@@ -310,7 +310,7 @@ export const handlers = {
     },
     get_commands: async (_p, ctx) => ({ commands: commands(ctx.runtime) }),
     get_skills: async (_p, ctx) => ({ skills: ctx.runtime.resources.skills }),
-    // [W5-F] 计划 / 任务命令（docs/wave5-plan.md §6.5、§7.5）
+    // [W5-F] 计划 / 任务命令（docs/history/wave5-plan.md §6.5、§7.5）
     plan_response: async (p, ctx) => {
         const result = await plans(ctx).respond(p);
         if (result.freshPrompt !== undefined) {
@@ -325,7 +325,7 @@ export const handlers = {
     get_todos: async (_p, ctx) => ({ items: currentTodos(impl(ctx.session()).manager.branch()) }),
     get_tasks: async (_p, ctx) => ({ tasks: [...(ctx.tasks?.()?.list() ?? [])] }),
     get_agents: async (_p, ctx) => ({ agents: [...(ctx.agents?.() ?? [])] }),
-    // [W6-T2] 轨迹（docs/wave6-plan.md §2.6；分页 / 增量 / 脱敏见 trace/query.ts）
+    // [W6-T2] 轨迹（docs/history/wave6-plan.md §2.6；分页 / 增量 / 脱敏见 trace/query.ts）
     get_trace: async (p, ctx) => sessionTrace(ctx.session(), p ?? {}),
     // [W7-B2] 前台任务转后台：工具调用立即返回、任务继续，完成后照常通知
     background_task: async (p, ctx) => {

package/dist/permissions/auto-safe.d.ts

@@ -1,5 +1,5 @@
 /**
- * auto 模式下 bash 的规则层与静态判定（§7.4，docs/permissions.md）。
+ * auto 模式下 bash 的规则层与静态判定（§7.4，docs/guides/permissions.md）。
  *
  * 规则层（命中即询问，不调模型）——外层与每层嵌套命令（`sh -c`、`eval`、`xargs`、`find -exec`，
  * 见 dangerous.ts）的每一段都查：

package/dist/permissions/auto-safe.js

@@ -1,5 +1,5 @@
 /**
- * auto 模式下 bash 的规则层与静态判定（§7.4，docs/permissions.md）。
+ * auto 模式下 bash 的规则层与静态判定（§7.4，docs/guides/permissions.md）。
  *
  * 规则层（命中即询问，不调模型）——外层与每层嵌套命令（`sh -c`、`eval`、`xargs`、`find -exec`，
  * 见 dangerous.ts）的每一段都查：

package/dist/permissions/bypass.d.ts

@@ -1,5 +1,5 @@
 /**
- * 进入 Bypass permissions（`full-auto`）前的确认（docs/permissions.md「进入 Bypass」）。
+ * 进入 Bypass permissions（`full-auto`）前的确认（docs/guides/permissions.md「进入 Bypass」）。
  *
  * - 交互界面里的切换（Tab / Shift+Tab 循环、`/permission` 选择器、`/permission full-auto` 命令）
  *   进入 Bypass 前问一次；本次运行内确认过之后不再问；启动时已是 Bypass（命令行

package/dist/permissions/bypass.js

@@ -1,5 +1,5 @@
 /**
- * 进入 Bypass permissions（`full-auto`）前的确认（docs/permissions.md「进入 Bypass」）。
+ * 进入 Bypass permissions（`full-auto`）前的确认（docs/guides/permissions.md「进入 Bypass」）。
  *
  * - 交互界面里的切换（Tab / Shift+Tab 循环、`/permission` 选择器、`/permission full-auto` 命令）
  *   进入 Bypass 前问一次；本次运行内确认过之后不再问；启动时已是 Bypass（命令行

package/dist/permissions/classifier.d.ts

@@ -1,5 +1,5 @@
 /**
- * auto 模式的模型分类器（§7.4 第 3 层，docs/permissions.md「模型分类器」）。
+ * auto 模式的模型分类器（§7.4 第 3 层，docs/guides/permissions.md「模型分类器」）。
  *
  * 只处理规则层与静态判定都没决定的调用（管线 verdict 带 `classify: true`）。这里只管提示、解析、
  * 超时与缓存；真正发请求的 `complete` 由会话注入（agent/session-classifier.ts：独立请求、不进转录、

package/dist/permissions/classifier.js

@@ -1,5 +1,5 @@
 /**
- * auto 模式的模型分类器（§7.4 第 3 层，docs/permissions.md「模型分类器」）。
+ * auto 模式的模型分类器（§7.4 第 3 层，docs/guides/permissions.md「模型分类器」）。
  *
  * 只处理规则层与静态判定都没决定的调用（管线 verdict 带 `classify: true`）。这里只管提示、解析、
  * 超时与缓存；真正发请求的 `complete` 由会话注入（agent/session-classifier.ts：独立请求、不进转录、

package/dist/permissions/memory-class.d.ts

@@ -1,5 +1,5 @@
 /**
- * 权限类 `memory`（docs/wave6-plan.md §3.3、D10）。[W6-C0] 管线判定；`memory` 工具本身由 W6-M 实现。
+ * 权限类 `memory`（docs/history/wave6-plan.md §3.3、D10）。[W6-C0] 管线判定；`memory` 工具本身由 W6-M 实现。
  *
  * 管线按命令把它折成已有的类再走通常的真值表：
  * - `view` → `read`：所有模式放行；

package/dist/permissions/memory-class.js

@@ -1,5 +1,5 @@
 /**
- * 权限类 `memory`（docs/wave6-plan.md §3.3、D10）。[W6-C0] 管线判定；`memory` 工具本身由 W6-M 实现。
+ * 权限类 `memory`（docs/history/wave6-plan.md §3.3、D10）。[W6-C0] 管线判定；`memory` 工具本身由 W6-M 实现。
  *
  * 管线按命令把它折成已有的类再走通常的真值表：
  * - `view` → `read`：所有模式放行；

package/dist/permissions/pipeline.d.ts

@@ -25,7 +25,7 @@
  * 命中；带 path 的工具记文件所在目录，之后该目录下的路径命中；其它工具只记工具名。
  * 记忆只作用于第 ③ 步模式产生的 ask（auto 里只作用于规则层之后）。
  *
- * [S2] bash 沙箱（docs/permissions.md「判定顺序」）：default / auto-edit 下，bash 调用若将在 OS 沙箱内
+ * [S2] bash 沙箱（docs/guides/permissions.md「判定顺序」）：default / auto-edit 下，bash 调用若将在 OS 沙箱内
  * 运行且沙箱拒绝网络、没请求 `sandbox: false`、命令文本不碰机密路径、嵌套不超深，第 ③ 步的 ask 变
  * allow（`sandboxed: true`）；①② 与 Hook ask 照旧优先。auto 下沙箱不直接放行，只作为分类器输入；
  * 请求 `sandbox: false` 越出沙箱时规则层询问（allow 规则 / Hook allow / 会话记忆仍可放行）。
@@ -47,7 +47,7 @@ export declare const PLAN_MODE_MESSAGE = "Plan mode is active: write/execute too
 /** [W5-F] plan 下 `todo set / update` 的拒绝说明（计划与清单分开，避免跳过审批）。 */
 export declare const PLAN_TODO_MESSAGE = "Plan mode is active: the todo list is created from the approved plan. Write the steps in a <proposed_plan> block instead.";
 /**
- * [W5-F] plan 模式第 ③ 步（输入可见，docs/wave5-plan.md §6.2）：
+ * [W5-F] plan 模式第 ③ 步（输入可见，docs/history/wave5-plan.md §6.2）：
  * read 放行（`todo` 只放行 get）；bash 按 `plan.bash`（readonly：只读子集放行其余拒绝；ask：其余询问；
  * deny：全拒）；task 放行（子会话共用同一管线，同样处在 plan）；其余 write / execute 拒绝。
  * 返回 undefined = 交给通常的模式真值表。