@armadra/agent 0.8.0 → 0.9.0

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 = 交给通常的模式真值表。

package/dist/permissions/pipeline.js

@@ -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 / 会话记忆仍可放行）。
@@ -72,7 +72,7 @@ export const PLAN_MODE_MESSAGE = "Plan mode is active: write/execute tools are d
 /** [W5-F] plan 下 `todo set / update` 的拒绝说明（计划与清单分开，避免跳过审批）。 */
 export 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 = 交给通常的模式真值表。

package/dist/permissions/protected.d.ts

@@ -1,5 +1,5 @@
 /**
- * auto 模式规则层的受保护路径（§7.4，docs/permissions.md「规则层」）。
+ * auto 模式规则层的受保护路径（§7.4，docs/guides/permissions.md「规则层」）。
  *
  * - **机密路径**（读写都询问）：`.env` / `.env.*`（`.example` / `.sample` / `.template` / `.dist` 除外）、
  *   `*.env`、`.ssh/`、`.gnupg/`、`.aws/`、`.kube/config`、`.docker/config.json`、`.config/gcloud/`、

package/dist/permissions/protected.js

@@ -1,5 +1,5 @@
 /**
- * auto 模式规则层的受保护路径（§7.4，docs/permissions.md「规则层」）。
+ * auto 模式规则层的受保护路径（§7.4，docs/guides/permissions.md「规则层」）。
  *
  * - **机密路径**（读写都询问）：`.env` / `.env.*`（`.example` / `.sample` / `.template` / `.dist` 除外）、
  *   `*.env`、`.ssh/`、`.gnupg/`、`.aws/`、`.kube/config`、`.docker/config.json`、`.config/gcloud/`、

package/dist/permissions/readonly-bash.d.ts

@@ -1,5 +1,5 @@
 /**
- * plan 模式与 allowlist 放行的只读 bash 子集 `READONLY_BASH`（docs/wave5-plan.md §6.2、D21）。[W5-F]
+ * plan 模式与 allowlist 放行的只读 bash 子集 `READONLY_BASH`（docs/history/wave5-plan.md §6.2、D21）。[W5-F]
  *
  * 判定 = auto 的静态判定（`analyzeBashForAuto`：分词、嵌套展开、规则层的网络 / 删除 / 写入目标 /
  * 机密路径、命令替换、变量展开、点文件通配）**全部通过**，再加四条更窄的限制：

package/dist/permissions/readonly-bash.js

@@ -1,5 +1,5 @@
 /**
- * plan 模式与 allowlist 放行的只读 bash 子集 `READONLY_BASH`（docs/wave5-plan.md §6.2、D21）。[W5-F]
+ * plan 模式与 allowlist 放行的只读 bash 子集 `READONLY_BASH`（docs/history/wave5-plan.md §6.2、D21）。[W5-F]
  *
  * 判定 = auto 的静态判定（`analyzeBashForAuto`：分词、嵌套展开、规则层的网络 / 删除 / 写入目标 /
  * 机密路径、命令替换、变量展开、点文件通配）**全部通过**，再加四条更窄的限制：

package/dist/permissions/types.d.ts

@@ -75,7 +75,7 @@ export interface ApprovalRequestContext {
     /** [W5-C0] 子 Agent 任务 id（对话框标注 `[task:<agent>]`）。 */
     taskId?: string;
     /**
-     * [W5-C0] 来自外部 Agent 的权限请求（docs/wave5-plan.md §5.3）：只走 broker 链（宿主 → UI →
+     * [W5-C0] 来自外部 Agent 的权限请求（docs/history/wave5-plan.md §5.3）：只走 broker 链（宿主 → UI →
      * 无人值守拒绝），auto 分类器与模型都不参与；RPC `permission_request` 原样带出。
      */
     origin?: ExternalPermissionOrigin;
@@ -171,7 +171,7 @@ export interface PermissionVerdict {
      */
     classify?: boolean;
     /**
-     * [S2] 这次 bash 调用将经 OS 沙箱运行（docs/sandbox.md「第二阶段」）。default / auto-edit 下因此免审批时
+     * [S2] 这次 bash 调用将经 OS 沙箱运行（docs/guides/sandbox.md「第二阶段」）。default / auto-edit 下因此免审批时
      * 为真；auto 下随 `classify` 一起交给分类器作为输入。
      */
     sandboxed?: boolean;

package/dist/plan/done-markers.d.ts

@@ -1,5 +1,5 @@
 /**
- * [W5-Z] `[DONE:<步骤>]` 文本交接（docs/plan.md「交接」，D20 / R6 的回退）：活动工具集里没有 `todo` 时，
+ * [W5-Z] `[DONE:<步骤>]` 文本交接（docs/guides/plan.md「交接」，D20 / R6 的回退）：活动工具集里没有 `todo` 时，
  * 批准计划的交接消息请模型每完成一步在回复里单独一行写 `[DONE:S1]`；ama 在回合结束时读这些标记，
  * 把计划生成的待办（`planStep`）标为 done、下一个未完成项转 in_progress，照常落 `ama.todo` 与发
  * `todo_updated`，界面与 RPC 的进度显示不依赖 todo 工具。

package/dist/plan/done-markers.js

@@ -1,5 +1,5 @@
 /**
- * [W5-Z] `[DONE:<步骤>]` 文本交接（docs/plan.md「交接」，D20 / R6 的回退）：活动工具集里没有 `todo` 时，
+ * [W5-Z] `[DONE:<步骤>]` 文本交接（docs/guides/plan.md「交接」，D20 / R6 的回退）：活动工具集里没有 `todo` 时，
  * 批准计划的交接消息请模型每完成一步在回复里单独一行写 `[DONE:S1]`；ama 在回合结束时读这些标记，
  * 把计划生成的待办（`planStep`）标为 done、下一个未完成项转 in_progress，照常落 `ama.todo` 与发
  * `todo_updated`，界面与 RPC 的进度显示不依赖 todo 工具。

package/dist/plan/extract.d.ts

@@ -1,5 +1,5 @@
 /**
- * `<proposed_plan>` 块的提取与步骤解析（docs/wave5-plan.md §6.3、D19）。[W5-F] 纯函数。
+ * `<proposed_plan>` 块的提取与步骤解析（docs/history/wave5-plan.md §6.3、D19）。[W5-F] 纯函数。
  *
  * - 只认开、闭标签**各占一行**（允许行首尾空白）、且不在代码围栏（``` / ~~~）内的块；
  *   不闭合的块忽略；多个完整块取最后一个。

package/dist/plan/extract.js

@@ -1,5 +1,5 @@
 /**
- * `<proposed_plan>` 块的提取与步骤解析（docs/wave5-plan.md §6.3、D19）。[W5-F] 纯函数。
+ * `<proposed_plan>` 块的提取与步骤解析（docs/history/wave5-plan.md §6.3、D19）。[W5-F] 纯函数。
  *
  * - 只认开、闭标签**各占一行**（允许行首尾空白）、且不在代码围栏（``` / ~~~）内的块；
  *   不闭合的块忽略；多个完整块取最后一个。

package/dist/plan/prompts.d.ts

@@ -1,5 +1,5 @@
 /**
- * plan 模式注入给模型的文本（docs/wave5-plan.md §6.2、D18）。[W5-F]
+ * plan 模式注入给模型的文本（docs/history/wave5-plan.md §6.2、D18）。[W5-F]
  *
  * 全部以 `custom_message`（`display:false`）追加在尾部，投影成 user 消息，不碰 system 节与工具表
  * （design §9.1）。文本是给模型看的，用英文；界面文案不在这里。

package/dist/plan/prompts.js

@@ -1,5 +1,5 @@
 /**
- * plan 模式注入给模型的文本（docs/wave5-plan.md §6.2、D18）。[W5-F]
+ * plan 模式注入给模型的文本（docs/history/wave5-plan.md §6.2、D18）。[W5-F]
  *
  * 全部以 `custom_message`（`display:false`）追加在尾部，投影成 user 消息，不碰 system 节与工具表
  * （design §9.1）。文本是给模型看的，用英文；界面文案不在这里。

package/dist/plan/store.d.ts

@@ -1,5 +1,5 @@
 /**
- * 计划的持久化：会话条目的读取与计划文件导出（docs/wave5-plan.md §6.3）。[W5-F]
+ * 计划的持久化：会话条目的读取与计划文件导出（docs/history/wave5-plan.md §6.3）。[W5-F]
  *
  * - 权威数据在会话 JSONL：`custom{ama.plan}`（只追加：状态变化再记一条，同 id 取分支上最后一条）、
  *   `custom{ama.plan_state}`（进入 / 退出 plan）。

package/dist/plan/store.js

@@ -1,5 +1,5 @@
 /**
- * 计划的持久化：会话条目的读取与计划文件导出（docs/wave5-plan.md §6.3）。[W5-F]
+ * 计划的持久化：会话条目的读取与计划文件导出（docs/history/wave5-plan.md §6.3）。[W5-F]
  *
  * - 权威数据在会话 JSONL：`custom{ama.plan}`（只追加：状态变化再记一条，同 id 取分支上最后一条）、
  *   `custom{ama.plan_state}`（进入 / 退出 plan）。

package/dist/rpc.d.ts

@@ -12,14 +12,14 @@
  * - 线上事件 = 进程内 `SessionEvent`，但 `message_update` 换成纯增量（去掉 partial / 累计消息，
  *   附最新 usage）；stream-json 输出同一形状。
  * - 类型定义直接放在本文件（B6 实现 import 它），避免子路径入口依赖实现文件。
- * - [W5-C0] 第五波（docs/wave5-plan.md §6.5、§7.5）：命令 `plan_response / get_plan / get_todos /
+ * - [W5-C0] 第五波（docs/history/wave5-plan.md §6.5、§7.5）：命令 `plan_response / get_plan / get_todos /
  *   get_tasks / get_agents`（返回形状见 `RpcW5Results`），客户端能力 `plans`（声明后计划审批交客户端）；
  *   新事件由 `SessionEvent` 派生自动包含。命令实现归 W5-F（C0 时返回 `not_implemented`），
  *   `RPC_PROTOCOL_VERSION` 不变。
- * - [W6-C0] 第六波（docs/wave6-plan.md §2.6、§4.4）：命令 `get_trace`（参数 `RpcGetTraceParams`、返回
+ * - [W6-C0] 第六波（docs/history/wave6-plan.md §2.6、§4.4）：命令 `get_trace`（参数 `RpcGetTraceParams`、返回
  *   `RpcW6Results`，W6-T2 实现，之前回 `not_implemented`）；事件 `quota_update`；`permission_request.context`
  *   可带 `toolCallId`；`keySource` 可为 `oauth`。`RPC_PROTOCOL_VERSION` 不变。
- * - [W7-B2] 后台子 Agent（docs/agents-concurrency-plan.md §2.5）：命令 `background_task { taskId? }` →
+ * - [W7-B2] 后台子 Agent（docs/history/agents-concurrency-plan.md §2.5）：命令 `background_task { taskId? }` →
  *   `RpcW7Results`（无 taskId = 全部前台运行中任务；对已结束 / 已在后台的任务回空表）；事件
  *   `subagent_background` 由 `SessionEvent` 派生。`RPC_PROTOCOL_VERSION` 不变。
  */

package/dist/rpc.js

@@ -12,14 +12,14 @@
  * - 线上事件 = 进程内 `SessionEvent`，但 `message_update` 换成纯增量（去掉 partial / 累计消息，
  *   附最新 usage）；stream-json 输出同一形状。
  * - 类型定义直接放在本文件（B6 实现 import 它），避免子路径入口依赖实现文件。
- * - [W5-C0] 第五波（docs/wave5-plan.md §6.5、§7.5）：命令 `plan_response / get_plan / get_todos /
+ * - [W5-C0] 第五波（docs/history/wave5-plan.md §6.5、§7.5）：命令 `plan_response / get_plan / get_todos /
  *   get_tasks / get_agents`（返回形状见 `RpcW5Results`），客户端能力 `plans`（声明后计划审批交客户端）；
  *   新事件由 `SessionEvent` 派生自动包含。命令实现归 W5-F（C0 时返回 `not_implemented`），
  *   `RPC_PROTOCOL_VERSION` 不变。
- * - [W6-C0] 第六波（docs/wave6-plan.md §2.6、§4.4）：命令 `get_trace`（参数 `RpcGetTraceParams`、返回
+ * - [W6-C0] 第六波（docs/history/wave6-plan.md §2.6、§4.4）：命令 `get_trace`（参数 `RpcGetTraceParams`、返回
  *   `RpcW6Results`，W6-T2 实现，之前回 `not_implemented`）；事件 `quota_update`；`permission_request.context`
  *   可带 `toolCallId`；`keySource` 可为 `oauth`。`RPC_PROTOCOL_VERSION` 不变。
- * - [W7-B2] 后台子 Agent（docs/agents-concurrency-plan.md §2.5）：命令 `background_task { taskId? }` →
+ * - [W7-B2] 后台子 Agent（docs/history/agents-concurrency-plan.md §2.5）：命令 `background_task { taskId? }` →
  *   `RpcW7Results`（无 taskId = 全部前台运行中任务；对已结束 / 已在后台的任务回空表）；事件
  *   `subagent_background` 由 `SessionEvent` 派生。`RPC_PROTOCOL_VERSION` 不变。
  */

package/dist/sandbox/bash.d.ts

@@ -1,5 +1,5 @@
 /**
- * bash 的 OS 沙箱（docs/sandbox.md「第二阶段」）：配置 → 会话内固定的沙箱设定，以及每次调用的策略。
+ * bash 的 OS 沙箱（docs/guides/sandbox.md「第二阶段」）：配置 → 会话内固定的沙箱设定，以及每次调用的策略。
  *
  * - 生效条件：`sandbox.bash: auto` 且探测到能限制写入的沙箱（sandbox-exec / bwrap；`unshare` 只隔离网络，
  *   不算）。不生效时 bash 原样运行、权限照旧；

package/dist/sandbox/bash.js

@@ -1,5 +1,5 @@
 /**
- * bash 的 OS 沙箱（docs/sandbox.md「第二阶段」）：配置 → 会话内固定的沙箱设定，以及每次调用的策略。
+ * bash 的 OS 沙箱（docs/guides/sandbox.md「第二阶段」）：配置 → 会话内固定的沙箱设定，以及每次调用的策略。
  *
  * - 生效条件：`sandbox.bash: auto` 且探测到能限制写入的沙箱（sandbox-exec / bwrap；`unshare` 只隔离网络，
  *   不算）。不生效时 bash 原样运行、权限照旧；

package/dist/sandbox/detect.d.ts

@@ -1,5 +1,5 @@
 /**
- * 操作系统沙箱能力探测（docs/sandbox.md「探测与降级」）。
+ * 操作系统沙箱能力探测（docs/guides/sandbox.md「探测与降级」）。
  *
  * - 「存在」不等于「可用」（嵌套在别的沙箱里、容器里没有用户命名空间）：用目标配置跑一次最小探针，退出码 0
  *   才算可用；

package/dist/sandbox/detect.js

@@ -1,5 +1,5 @@
 /**
- * 操作系统沙箱能力探测（docs/sandbox.md「探测与降级」）。
+ * 操作系统沙箱能力探测（docs/guides/sandbox.md「探测与降级」）。
  *
  * - 「存在」不等于「可用」（嵌套在别的沙箱里、容器里没有用户命名空间）：用目标配置跑一次最小探针，退出码 0
  *   才算可用；

package/dist/sandbox/index.d.ts

@@ -1,4 +1,4 @@
-/** 操作系统级沙箱（docs/sandbox.md）：探测、参数生成与命令包装。 */
+/** 操作系统级沙箱（docs/guides/sandbox.md）：探测、参数生成与命令包装。 */
 export { NO_OS_SANDBOX, configureOsSandbox, osSandboxStatus, probeOsSandbox, resetOsSandboxForTests, resolveSandboxEnabled, type OsSandboxStatus, type ProbeDeps, type SandboxEnabled, } from "./detect.js";
 export { buildBwrapArgs, buildSbplProfile, buildUnshareArgs, type OsSandboxKind, type OsSandboxPolicy, } from "./profile.js";
 export { resolveExtras, resolveWritable, wrapCommand, type WrappedCommand } from "./wrap.js";

package/dist/sandbox/index.js

@@ -1,4 +1,4 @@
-/** 操作系统级沙箱（docs/sandbox.md）：探测、参数生成与命令包装。 */
+/** 操作系统级沙箱（docs/guides/sandbox.md）：探测、参数生成与命令包装。 */
 export { NO_OS_SANDBOX, configureOsSandbox, osSandboxStatus, probeOsSandbox, resetOsSandboxForTests, resolveSandboxEnabled, } from "./detect.js";
 export { buildBwrapArgs, buildSbplProfile, buildUnshareArgs, } from "./profile.js";
 export { resolveExtras, resolveWritable, wrapCommand } from "./wrap.js";

package/dist/sandbox/profile.d.ts

@@ -1,5 +1,5 @@
 /**
- * 操作系统沙箱的参数生成（docs/sandbox.md「各平台实现」）：纯函数，不探测、不读文件系统。
+ * 操作系统沙箱的参数生成（docs/guides/sandbox.md「各平台实现」）：纯函数，不探测、不读文件系统。
  *
  * - `buildSbplProfile`：macOS `sandbox-exec -p` 的 SBPL 配置；
  * - `buildBwrapArgs`：Linux bubblewrap 的参数（到 `--` 为止）；