@armadra/agent 0.8.0 → 0.8.1

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

@@ -1,5 +1,5 @@
 /**
- * `ama config get | set | unset | list` (docs/wave6-plan.md §6.4, D24-D26). [W6-S]
+ * `ama config get | set | unset | list` (docs/history/wave6-plan.md §6.4, D24-D26). [W6-S]
  *
  * Thin layer over config/edit.ts (the `/config` panel uses the same core):
  * - `get <key> [--json]`: effective value, source layer and apply tier;

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

@@ -1,5 +1,5 @@
 /**
- * `ama config get | set | unset | list` (docs/wave6-plan.md §6.4, D24-D26). [W6-S]
+ * `ama config get | set | unset | list` (docs/history/wave6-plan.md §6.4, D24-D26). [W6-S]
  *
  * Thin layer over config/edit.ts (the `/config` panel uses the same core):
  * - `get <key> [--json]`: effective value, source layer and apply tier;

package/dist/cli/subcommands/doctor.js

@@ -231,7 +231,7 @@ function proxySection(report, io) {
     for (const line of describeProxy(inspectProxy(io.env)))
         report.item(line);
 }
-/** 检查点备份占用（docs/rewind-plan.md §1.4）。 */
+/** 检查点备份占用（docs/history/rewind-plan.md §1.4）。 */
 async function fileHistoryLine(report, dataDir) {
     try {
         const usage = await blobUsage(dataDir);

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

@@ -1,5 +1,5 @@
 /**
- * `ama init [--force]`（docs/providers.md「配置目录」）：建配置目录与缺省文件，逐个报告状态。
+ * `ama init [--force]`（docs/guides/providers.md「配置目录」）：建配置目录与缺省文件，逐个报告状态。
  */
 import type { CliIo } from "../deps.js";
 export declare function initUsage(): string;

package/dist/cli/subcommands/init.js

@@ -1,5 +1,5 @@
 /**
- * `ama init [--force]`（docs/providers.md「配置目录」）：建配置目录与缺省文件，逐个报告状态。
+ * `ama init [--force]`（docs/guides/providers.md「配置目录」）：建配置目录与缺省文件，逐个报告状态。
  */
 import { describeInit, initConfigDir, initNextSteps } from "../../config/init.js";
 import { resolveConfigDir } from "../../config/paths.js";

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

@@ -1,5 +1,5 @@
 /**
- * `ama memory list|show|edit|rm|path|enable|disable`（docs/wave6-plan.md §3.5）。[W6-M]
+ * `ama memory list|show|edit|rm|path|enable|disable`（docs/history/wave6-plan.md §3.5）。[W6-M]
  *
  * - 作用域按用户级配置（`memory.scopes`，缺省 user + project）；项目作用域以 cwd 定位，需项目已受信任
  *   （trust.json 记录），否则跳过并提示。`memory.enabled` 为 false 时照样能看、能改（条目保留但不使用）。

package/dist/cli/subcommands/memory.js

@@ -1,5 +1,5 @@
 /**
- * `ama memory list|show|edit|rm|path|enable|disable`（docs/wave6-plan.md §3.5）。[W6-M]
+ * `ama memory list|show|edit|rm|path|enable|disable`（docs/history/wave6-plan.md §3.5）。[W6-M]
  *
  * - 作用域按用户级配置（`memory.scopes`，缺省 user + project）；项目作用域以 cwd 定位，需项目已受信任
  *   （trust.json 记录），否则跳过并提示。`memory.enabled` 为 false 时照样能看、能改（条目保留但不使用）。

package/dist/cli/subcommands/models.js

@@ -87,7 +87,7 @@ async function check(io, registry, ref) {
 }
 /**
  * `ama models refresh [--provider <id>[,<id>…]]`：显式联网拉 models.dev，按内置快照的清单裁剪，
- * 写用户级覆盖 `<dataDir>/models-dev.json`（docs/providers.md「模型元数据」）。启动与其它命令不联网。
+ * 写用户级覆盖 `<dataDir>/models-dev.json`（docs/guides/providers.md「模型元数据」）。启动与其它命令不联网。
  */
 const REFRESH_ACTION = {
     usage: "ama models refresh [--provider <id>[,<id>…]]",

package/dist/cli/subcommands/providers-list.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama providers list|channels|remove`（docs/providers.md「一键接入」）：供应商 → 渠道 → 模型数与 key 来源
+ * `ama providers list|channels|remove`（docs/guides/providers.md「一键接入」）：供应商 → 渠道 → 模型数与 key 来源
  * （从不显示 key）；remove 删配置条目（先备份）与 auth.json 里该供应商及其渠道的 key。
  */
 import { type Ctx } from "./providers.js";

package/dist/cli/subcommands/providers-list.js

@@ -1,5 +1,5 @@
 /**
- * `ama providers list|channels|remove`（docs/providers.md「一键接入」）：供应商 → 渠道 → 模型数与 key 来源
+ * `ama providers list|channels|remove`（docs/guides/providers.md「一键接入」）：供应商 → 渠道 → 模型数与 key 来源
  * （从不显示 key）；remove 删配置条目（先备份）与 auth.json 里该供应商及其渠道的 key。
  */
 import { apiShortName } from "../../ai/providers/channels.js";

package/dist/cli/subcommands/providers-plan.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama providers add|refresh` 的纯计算部分（docs/providers.md「一键接入」）：候选渠道、模型列表的
+ * `ama providers add|refresh` 的纯计算部分（docs/guides/providers.md「一键接入」）：候选渠道、模型列表的
  * 协议提示、探测结果 → 模型渠道、渠道收敛、追加式合并进配置、表格。
  *
  * 不读写文件、不联网（`fetchModelList` 除外，它只是一次 GET）；命令流程在 providers.ts。

package/dist/cli/subcommands/providers-plan.js

@@ -1,5 +1,5 @@
 /**
- * `ama providers add|refresh` 的纯计算部分（docs/providers.md「一键接入」）：候选渠道、模型列表的
+ * `ama providers add|refresh` 的纯计算部分（docs/guides/providers.md「一键接入」）：候选渠道、模型列表的
  * 协议提示、探测结果 → 模型渠道、渠道收敛、追加式合并进配置、表格。
  *
  * 不读写文件、不联网（`fetchModelList` 除外，它只是一次 GET）；命令流程在 providers.ts。

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

@@ -1,5 +1,5 @@
 /**
- * `ama providers add|list|channels|remove|refresh`（docs/providers.md「一键接入」「渠道」）。
+ * `ama providers add|list|channels|remove|refresh`（docs/guides/providers.md「一键接入」「渠道」）。
  *
  * - add：只给 baseUrl 与 key，列出中转的模型（`GET /models`）、用 models.dev 补元数据、可选逐渠道
  *   探测，把渠道与模型追加进用户级 config.json（先备份）；key 从 stdin 读（不回显）存 auth.json，

package/dist/cli/subcommands/providers.js

@@ -1,5 +1,5 @@
 /**
- * `ama providers add|list|channels|remove|refresh`（docs/providers.md「一键接入」「渠道」）。
+ * `ama providers add|list|channels|remove|refresh`（docs/guides/providers.md「一键接入」「渠道」）。
  *
  * - add：只给 baseUrl 与 key，列出中转的模型（`GET /models`）、用 models.dev 补元数据、可选逐渠道
  *   探测，把渠道与模型追加进用户级 config.json（先备份）；key 从 stdin 读（不回显）存 auth.json，

package/dist/cli/subcommands/sessions-export.d.ts

@@ -3,7 +3,7 @@
  *
  * - `--format md|json|jsonl`（缺省 md）；`--branch leaf|all`（缺省 leaf = 当前分支）；
  * - `--output <文件>`：写文件（0600，已存在则覆盖），否则写 stdout；
- * - 导出内容先脱敏（session/redact.ts），格式说明见 docs/sessions.md「导出」。
+ * - 导出内容先脱敏（session/redact.ts），格式说明见 docs/guides/sessions.md「导出」。
  */
 import type { CliIo } from "../deps.js";
 export declare function sessionsExportUsage(): string;

package/dist/cli/subcommands/sessions-export.js

@@ -3,7 +3,7 @@
  *
  * - `--format md|json|jsonl`（缺省 md）；`--branch leaf|all`（缺省 leaf = 当前分支）；
  * - `--output <文件>`：写文件（0600，已存在则覆盖），否则写 stdout；
- * - 导出内容先脱敏（session/redact.ts），格式说明见 docs/sessions.md「导出」。
+ * - 导出内容先脱敏（session/redact.ts），格式说明见 docs/guides/sessions.md「导出」。
  */
 import { writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";

package/dist/cli/subcommands/sessions-trace.d.ts

@@ -1,5 +1,5 @@
 /**
- * `ama sessions trace <id|文件>`：会话轨迹导出（docs/wave6-plan.md §2.5、D7）。[W6-T2]
+ * `ama sessions trace <id|文件>`：会话轨迹导出（docs/history/wave6-plan.md §2.5、D7）。[W6-T2]
  *
  * - 缺省 / `--html [文件]` / `--format html`：自包含 HTML（`trace/html.ts`）；`--json` / `--format json`：与 RPC
  *   `get_trace` 同形的 JSON（全部回合、已加载子会话、`previews` 只含本会话节点；`--no-content` 时没有）。

package/dist/cli/subcommands/sessions-trace.js

@@ -1,5 +1,5 @@
 /**
- * `ama sessions trace <id|文件>`：会话轨迹导出（docs/wave6-plan.md §2.5、D7）。[W6-T2]
+ * `ama sessions trace <id|文件>`：会话轨迹导出（docs/history/wave6-plan.md §2.5、D7）。[W6-T2]
  *
  * - 缺省 / `--html [文件]` / `--format html`：自包含 HTML（`trace/html.ts`）；`--json` / `--format json`：与 RPC
  *   `get_trace` 同形的 JSON（全部回合、已加载子会话、`previews` 只含本会话节点；`--no-content` 时没有）。

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

@@ -6,7 +6,7 @@
  * - show <id>：头信息 + 条目类型统计 + 首条提示 + 用户消息编号（`--from <id>#<编号>` 复用）。
  * - search / export / trace：见 sessions-search.ts、sessions-export.ts、sessions-trace.ts（只读扫描，不经会话存储）。
  * - prune [--older-than <天>] [--dry-run]：缺省 30 天，移到 trash（不删除）；之后清理检查点备份
- *   （未被任何会话引用且超过 1 天的 blob，docs/rewind-plan.md §1.4）与超过 7 天的剪贴板图片
+ *   （未被任何会话引用且超过 1 天的 blob，docs/history/rewind-plan.md §1.4）与超过 7 天的剪贴板图片
  *   （`<数据目录>/clipboard/`，W5-I），`--dry-run` 时只报告。
  */
 import type { CliIo, RuntimeDeps } from "../deps.js";

package/dist/cli/subcommands/sessions.js

@@ -6,7 +6,7 @@
  * - show <id>：头信息 + 条目类型统计 + 首条提示 + 用户消息编号（`--from <id>#<编号>` 复用）。
  * - search / export / trace：见 sessions-search.ts、sessions-export.ts、sessions-trace.ts（只读扫描，不经会话存储）。
  * - prune [--older-than <天>] [--dry-run]：缺省 30 天，移到 trash（不删除）；之后清理检查点备份
- *   （未被任何会话引用且超过 1 天的 blob，docs/rewind-plan.md §1.4）与超过 7 天的剪贴板图片
+ *   （未被任何会话引用且超过 1 天的 blob，docs/history/rewind-plan.md §1.4）与超过 7 天的剪贴板图片
  *   （`<数据目录>/clipboard/`，W5-I），`--dry-run` 时只报告。
  */
 import { join, resolve } from "node:path";

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

@@ -5,7 +5,7 @@
  * - 时间：`--since` / `--until` 接受 `7d`（含今天的最近 7 天）、`today`、`YYYY-MM-DD`（本地日期，含当天）。
  * - 分组：`--by day|week|month|provider|channel|model|project`。
  * - 缓存：`<数据目录>/stats-index.json`，按文件 mtime / size 失效；`--no-cache` 不读也不写。
- * - 口径见 session/stats-aggregate.ts 与 docs/sessions.md「统计」。
+ * - 口径见 session/stats-aggregate.ts 与 docs/guides/sessions.md「统计」。
  */
 import { type StatsReport } from "../../session/stats-aggregate.js";
 import type { CliIo } from "../deps.js";

package/dist/cli/subcommands/stats.js

@@ -5,7 +5,7 @@
  * - 时间：`--since` / `--until` 接受 `7d`（含今天的最近 7 天）、`today`、`YYYY-MM-DD`（本地日期，含当天）。
  * - 分组：`--by day|week|month|provider|channel|model|project`。
  * - 缓存：`<数据目录>/stats-index.json`，按文件 mtime / size 失效；`--no-cache` 不读也不写。
- * - 口径见 session/stats-aggregate.ts 与 docs/sessions.md「统计」。
+ * - 口径见 session/stats-aggregate.ts 与 docs/guides/sessions.md「统计」。
  */
 import { join, resolve } from "node:path";
 import { expandHome, resolveDataDir } from "../../config/paths.js";

package/dist/codemode/capability.d.ts

@@ -1,5 +1,5 @@
 /**
- * 沙箱能力探测（设计 §5.5 沙箱第 4 条；docs/sandbox.md「探测与降级」）。[B10][S2]
+ * 沙箱能力探测（设计 §5.5 沙箱第 4 条；docs/guides/sandbox.md「探测与降级」）。[B10][S2]
  *
  * Node 的权限模型（`--permission`）在 Node ≥ 25 同时拒绝网络；Node 22 / 24 只管文件、子进程、
  * worker 与 addon，不管网络——脚本若逃出 `vm` 就能联网。子进程另外经操作系统沙箱（macOS

package/dist/codemode/capability.js

@@ -1,5 +1,5 @@
 /**
- * 沙箱能力探测（设计 §5.5 沙箱第 4 条；docs/sandbox.md「探测与降级」）。[B10][S2]
+ * 沙箱能力探测（设计 §5.5 沙箱第 4 条；docs/guides/sandbox.md「探测与降级」）。[B10][S2]
  *
  * Node 的权限模型（`--permission`）在 Node ≥ 25 同时拒绝网络；Node 22 / 24 只管文件、子进程、
  * worker 与 addon，不管网络——脚本若逃出 `vm` 就能联网。子进程另外经操作系统沙箱（macOS

package/dist/codemode/host-side.d.ts

@@ -3,7 +3,7 @@
  *
  * - 命令行：`<node> --max-old-space-size=<MB> --permission --allow-fs-read=<入口>
  *   --disallow-code-generation-from-strings <入口> --ama-codemode-sandbox`；堆上限取 `codemode.maxHeapMb`
- *   （缺省 256，0 不加），超出时子进程 OOM 退出，映射为脚本错误（docs/memory-plan.md D10）；Node 22.0–22.12 用 `--experimental-permission`。不授予文件写、
+ *   （缺省 256，0 不加），超出时子进程 OOM 退出，映射为脚本错误（docs/history/memory-plan.md D10）；Node 22.0–22.12 用 `--experimental-permission`。不授予文件写、
  *   子进程、worker、addon、inspector 权限；以空环境启动（拿不到密钥与会话路径）；嵌入 Electron
  *   时设 `ELECTRON_RUN_AS_NODE=1` 运行同一可执行文件。
  * - 入口：bundle 里是 ama.cjs 同目录的 `ama-sandbox.cjs`（构建脚本定义 `__AMA_SANDBOX_ENTRY__`）；
@@ -13,7 +13,7 @@
  *   （完整门禁）；名字是 `codemode` 直接拒绝。脚本结束时 abort 仍在跑的调用。
  * - 超时：父进程计时，到点杀子进程树（POSIX 进程组 / Windows taskkill）；外层 abort：先发
  *   `abort`，宽限后杀树。
- * - OS 沙箱（docs/sandbox.md）：有可用的 sandbox-exec / bwrap / unshare 时，整条命令行经它启动，拒绝
+ * - OS 沙箱（docs/guides/sandbox.md）：有可用的 sandbox-exec / bwrap / unshare 时，整条命令行经它启动，拒绝
  *   网络与一切写入（`CODEMODE_OS_POLICY`；子进程本来就没有写权限）。Node 22 / 24 的 strict 依赖这一层
  *   （`requireOsSandbox`），包装不了就报错，不裸跑；Node ≥ 25 是叠加的纵深防御。
  */

package/dist/codemode/host-side.js

@@ -3,7 +3,7 @@
  *
  * - 命令行：`<node> --max-old-space-size=<MB> --permission --allow-fs-read=<入口>
  *   --disallow-code-generation-from-strings <入口> --ama-codemode-sandbox`；堆上限取 `codemode.maxHeapMb`
- *   （缺省 256，0 不加），超出时子进程 OOM 退出，映射为脚本错误（docs/memory-plan.md D10）；Node 22.0–22.12 用 `--experimental-permission`。不授予文件写、
+ *   （缺省 256，0 不加），超出时子进程 OOM 退出，映射为脚本错误（docs/history/memory-plan.md D10）；Node 22.0–22.12 用 `--experimental-permission`。不授予文件写、
  *   子进程、worker、addon、inspector 权限；以空环境启动（拿不到密钥与会话路径）；嵌入 Electron
  *   时设 `ELECTRON_RUN_AS_NODE=1` 运行同一可执行文件。
  * - 入口：bundle 里是 ama.cjs 同目录的 `ama-sandbox.cjs`（构建脚本定义 `__AMA_SANDBOX_ENTRY__`）；
@@ -13,7 +13,7 @@
  *   （完整门禁）；名字是 `codemode` 直接拒绝。脚本结束时 abort 仍在跑的调用。
  * - 超时：父进程计时，到点杀子进程树（POSIX 进程组 / Windows taskkill）；外层 abort：先发
  *   `abort`，宽限后杀树。
- * - OS 沙箱（docs/sandbox.md）：有可用的 sandbox-exec / bwrap / unshare 时，整条命令行经它启动，拒绝
+ * - OS 沙箱（docs/guides/sandbox.md）：有可用的 sandbox-exec / bwrap / unshare 时，整条命令行经它启动，拒绝
  *   网络与一切写入（`CODEMODE_OS_POLICY`；子进程本来就没有写权限）。Node 22 / 24 的 strict 依赖这一层
  *   （`requireOsSandbox`），包装不了就报错，不裸跑；Node ≥ 25 是叠加的纵深防御。
  */

package/dist/compaction/image-budget.d.ts

@@ -1,5 +1,5 @@
 /**
- * 单请求图片总量预算（docs/wave5-plan.md §4、D11）。[W5-I] 纯函数，无模型调用。
+ * 单请求图片总量预算（docs/history/wave5-plan.md §4、D11）。[W5-I] 纯函数，无模型调用。
  *
  * base64 图片在历史里每轮重发，几张截图就可能撞上 Anthropic 32 MB / Gemini 20 MB 的请求上限。
  * `planImageBudget` 给出要降级的消息：调用方把每条写成 `context_edit{reason:"image_budget"}`，

package/dist/compaction/image-budget.js

@@ -1,5 +1,5 @@
 /**
- * 单请求图片总量预算（docs/wave5-plan.md §4、D11）。[W5-I] 纯函数，无模型调用。
+ * 单请求图片总量预算（docs/history/wave5-plan.md §4、D11）。[W5-I] 纯函数，无模型调用。
  *
  * base64 图片在历史里每轮重发，几张截图就可能撞上 Anthropic 32 MB / Gemini 20 MB 的请求上限。
  * `planImageBudget` 给出要降级的消息：调用方把每条写成 `context_edit{reason:"image_budget"}`，

package/dist/config/edit.d.ts

@@ -1,5 +1,5 @@
 /**
- * Settings edit core (docs/wave6-plan.md §6.2, D24-D26). [W6-S]
+ * Settings edit core (docs/history/wave6-plan.md §6.2, D24-D26). [W6-S]
  *
  * Shared by the `/config` panel, `/config key=value` and `ama config get | set | unset | list`:
  * - `readSnapshot()` reads the user and project files fresh and merges them with the profile / command

package/dist/config/edit.js

@@ -1,5 +1,5 @@
 /**
- * Settings edit core (docs/wave6-plan.md §6.2, D24-D26). [W6-S]
+ * Settings edit core (docs/history/wave6-plan.md §6.2, D24-D26). [W6-S]
  *
  * Shared by the `/config` panel, `/config key=value` and `ama config get | set | unset | list`:
  * - `readSnapshot()` reads the user and project files fresh and merges them with the profile / command

package/dist/config/init.d.ts

@@ -1,5 +1,5 @@
 /**
- * 配置目录初始化（docs/providers.md「配置目录」）：`ama init` 与 CLI 首次运行的自动初始化。
+ * 配置目录初始化（docs/guides/providers.md「配置目录」）：`ama init` 与 CLI 首次运行的自动初始化。
  *
  * - 目录 0700；`config.json` 只在不存在时写最小内容（`--force` 时先备份再重写）：只有 `$schema`、
  *   `version` 与空 `providers`，不写死任何缺省值——缺省值以后调整（例如 codemode 跟随预设）对老用户

package/dist/config/init.js

@@ -1,5 +1,5 @@
 /**
- * 配置目录初始化（docs/providers.md「配置目录」）：`ama init` 与 CLI 首次运行的自动初始化。
+ * 配置目录初始化（docs/guides/providers.md「配置目录」）：`ama init` 与 CLI 首次运行的自动初始化。
  *
  * - 目录 0700；`config.json` 只在不存在时写最小内容（`--force` 时先备份再重写）：只有 `$schema`、
  *   `version` 与空 `providers`，不写死任何缺省值——缺省值以后调整（例如 codemode 跟随预设）对老用户

package/dist/config/json-schema.d.ts

@@ -1,6 +1,6 @@
 /**
  * config.json 的 JSON Schema（draft-07 子集），写到配置目录的 `config.schema.json` 给编辑器补全与校验
- * （docs/providers.md「配置目录」）。规则与 schema.ts 的 `validateConfig` 一一对应：未知字段在那里是
+ * （docs/guides/providers.md「配置目录」）。规则与 schema.ts 的 `validateConfig` 一一对应：未知字段在那里是
  * warning、这里是 `additionalProperties: false`；渠道引用（模型 `channels` 指向已定义的渠道）这类跨字段
  * 规则 JSON Schema 表达不了，只在 `validateConfig` 里查。一致性由 json-schema.test.ts 的正反例守住。
  * 顶层与各段的键（供应商内部除外）的 description / default 来自 key-docs.ts（`annotate`）；说明跟随界面
@@ -8,7 +8,7 @@
  */
 type Schema = Record<string, unknown>;
 export declare const CONFIG_SCHEMA_FILE = "config.schema.json";
-export declare const CONFIG_SCHEMA_ID = "https://github.com/Owlbay/armadra-agent/config.schema.json";
+export declare const CONFIG_SCHEMA_ID = "https://github.com/AMA-Link/armadra-agent/config.schema.json";
 /** 生成 config.json 的 JSON Schema。 */
 export declare function buildConfigJsonSchema(): Schema;
 /** 写进文件的文本（2 空格缩进 + 换行结尾）。 */

package/dist/config/json-schema.js

@@ -1,6 +1,6 @@
 /**
  * config.json 的 JSON Schema（draft-07 子集），写到配置目录的 `config.schema.json` 给编辑器补全与校验
- * （docs/providers.md「配置目录」）。规则与 schema.ts 的 `validateConfig` 一一对应：未知字段在那里是
+ * （docs/guides/providers.md「配置目录」）。规则与 schema.ts 的 `validateConfig` 一一对应：未知字段在那里是
  * warning、这里是 `additionalProperties: false`；渠道引用（模型 `channels` 指向已定义的渠道）这类跨字段
  * 规则 JSON Schema 表达不了，只在 `validateConfig` 里查。一致性由 json-schema.test.ts 的正反例守住。
  * 顶层与各段的键（供应商内部除外）的 description / default 来自 key-docs.ts（`annotate`）；说明跟随界面
@@ -15,7 +15,7 @@ import { CACHE_RETENTIONS, CHANNEL_NAME_PATTERN, CHECKPOINT_MODES, SANDBOX_ENABL
 import { AGENT_ID_PATTERN } from "./schema-w5.js";
 import { AGENTS_RESERVED_KEYS, SUBAGENT_BACKGROUND_MODES } from "./types-w5.js";
 export const CONFIG_SCHEMA_FILE = "config.schema.json";
-export const CONFIG_SCHEMA_ID = "https://github.com/Owlbay/armadra-agent/config.schema.json";
+export const CONFIG_SCHEMA_ID = "https://github.com/AMA-Link/armadra-agent/config.schema.json";
 const KNOWN_APIS = [
     "openai-completions",
     "openai-responses",

package/dist/config/schema-w5.d.ts

@@ -1,5 +1,5 @@
 /**
- * 第五波配置键的校验（docs/wave5-plan.md §9；schema.ts 已近 600 行，新键放这里）。[W5-C0]
+ * 第五波配置键的校验（docs/history/wave5-plan.md §9；schema.ts 已近 600 行，新键放这里）。[W5-C0]
  *
  * 规则与 json-schema.ts 一一对应（json-schema.test.ts 的正反例守住）：类型 / 取值错误是 error，
  * 未知字段是 warning。只校验形状；行为由各批次实现。

package/dist/config/schema-w5.js

@@ -1,5 +1,5 @@
 /**
- * 第五波配置键的校验（docs/wave5-plan.md §9；schema.ts 已近 600 行，新键放这里）。[W5-C0]
+ * 第五波配置键的校验（docs/history/wave5-plan.md §9；schema.ts 已近 600 行，新键放这里）。[W5-C0]
  *
  * 规则与 json-schema.ts 一一对应（json-schema.test.ts 的正反例守住）：类型 / 取值错误是 error，
  * 未知字段是 warning。只校验形状；行为由各批次实现。

package/dist/config/schema-w6.d.ts

@@ -1,5 +1,5 @@
 /**
- * 第六波配置键的校验（docs/wave6-plan.md §7；规则与 json-schema.ts 一一对应，json-schema.test.ts 守住）。[W6-C0]
+ * 第六波配置键的校验（docs/history/wave6-plan.md §7；规则与 json-schema.ts 一一对应，json-schema.test.ts 守住）。[W6-C0]
  *
  * 类型 / 取值错误是 error，未知字段是 warning。只校验形状；行为由各批次实现。
  */

package/dist/config/schema-w6.js

@@ -1,5 +1,5 @@
 /**
- * 第六波配置键的校验（docs/wave6-plan.md §7；规则与 json-schema.ts 一一对应，json-schema.test.ts 守住）。[W6-C0]
+ * 第六波配置键的校验（docs/history/wave6-plan.md §7；规则与 json-schema.ts 一一对应，json-schema.test.ts 守住）。[W6-C0]
  *
  * 类型 / 取值错误是 error，未知字段是 warning。只校验形状；行为由各批次实现。
  */

package/dist/config/settings-registry.d.ts

@@ -1,5 +1,5 @@
 /**
- * Settings registry (docs/wave6-plan.md §6.1, D24-D26). [W6-S]
+ * Settings registry (docs/history/wave6-plan.md §6.1, D24-D26). [W6-S]
  *
  * One row per key that the `/config` panel and `ama config set` treat as a scalar setting: group, apply
  * tier (now / next session / restart), whether it changes the cache prefix, project-level writability

package/dist/config/settings-registry.js

@@ -1,5 +1,5 @@
 /**
- * Settings registry (docs/wave6-plan.md §6.1, D24-D26). [W6-S]
+ * Settings registry (docs/history/wave6-plan.md §6.1, D24-D26). [W6-S]
  *
  * One row per key that the `/config` panel and `ama config set` treat as a scalar setting: group, apply
  * tier (now / next session / restart), whether it changes the cache prefix, project-level writability

package/dist/config/types-w5.d.ts

@@ -1,5 +1,5 @@
 /**
- * 第五波配置键的形状（docs/wave5-plan.md §9）。[W5-C0] 契约文件：C0 只定形状、校验（schema-w5.ts）、
+ * 第五波配置键的形状（docs/history/wave5-plan.md §9）。[W5-C0] 契约文件：C0 只定形状、校验（schema-w5.ts）、
  * 说明与缺省（key-docs.ts）、JSON Schema；行为由各批次实现，未实现前这些键被接受但不起作用。
  *
  * 层级：项目级只接受 `plan.bash`（只能更严）、`reminders`、`ui.statusLine`（随 `ui` 段）；其余只认
@@ -59,7 +59,7 @@ export interface AgentsConfig {
 }
 /** 取 `agents.<id>`（保留键返回 undefined）。 */
 export declare function agentEntry(agents: AgentsConfig | undefined, agentId: string): AgentEntryConfig | undefined;
-/** [W7-B2] 子 Agent 缺省前台还是后台（docs/agents-concurrency-plan.md §2.6）。 */
+/** [W7-B2] 子 Agent 缺省前台还是后台（docs/history/agents-concurrency-plan.md §2.6）。 */
 export declare const SUBAGENT_BACKGROUND_MODES: readonly ["auto", "always", "never"];
 export type SubagentBackgroundMode = (typeof SUBAGENT_BACKGROUND_MODES)[number];
 /** [W5-G] ama 自己的子会话。 */

package/dist/config/types-w5.js

@@ -1,5 +1,5 @@
 /**
- * 第五波配置键的形状（docs/wave5-plan.md §9）。[W5-C0] 契约文件：C0 只定形状、校验（schema-w5.ts）、
+ * 第五波配置键的形状（docs/history/wave5-plan.md §9）。[W5-C0] 契约文件：C0 只定形状、校验（schema-w5.ts）、
  * 说明与缺省（key-docs.ts）、JSON Schema；行为由各批次实现，未实现前这些键被接受但不起作用。
  *
  * 层级：项目级只接受 `plan.bash`（只能更严）、`reminders`、`ui.statusLine`（随 `ui` 段）；其余只认
@@ -18,7 +18,7 @@ export function agentEntry(agents, agentId) {
     const entry = agents[agentId];
     return typeof entry === "object" && !Array.isArray(entry) ? entry : undefined;
 }
-/** [W7-B2] 子 Agent 缺省前台还是后台（docs/agents-concurrency-plan.md §2.6）。 */
+/** [W7-B2] 子 Agent 缺省前台还是后台（docs/history/agents-concurrency-plan.md §2.6）。 */
 export const SUBAGENT_BACKGROUND_MODES = ["auto", "always", "never"];
 /** `models.enabled` 的一项：`provider/model[@channel]` 或 `provider/*`。 */
 export const MODELS_ENABLED_REF = /^[^/\s]+\/\S+$/;

package/dist/config/types-w6.d.ts

@@ -1,11 +1,11 @@
 /**
- * 第六波配置键的形状（docs/wave6-plan.md §7、§1.3、§3.1、§4.3、§4.4、§5.2）。[W6-C0] 契约文件：C0 只定形状、
+ * 第六波配置键的形状（docs/history/wave6-plan.md §7、§1.3、§3.1、§4.3、§4.4、§5.2）。[W6-C0] 契约文件：C0 只定形状、
  * 校验（schema-w6.ts）、说明与缺省（key-docs.ts）、JSON Schema；行为由各批次实现，未实现前这些键被接受但不起作用。
  *
  * 层级（merge.ts）：项目级可设 `ui.language`、`ui.agentBar`，`memory` 只接受 `enabled: false`；`ui.replyLanguage`、
  * `memory` 其余键、`auth` 只认用户级 / profile（项目级忽略并 warning）。
  */
-/** `ui.language`：auto 按 `LC_ALL` / `LC_MESSAGES` / `LANG` 判断，判断不出用 en（docs/i18n.md）。 */
+/** `ui.language`：auto 按 `LC_ALL` / `LC_MESSAGES` / `LANG` 判断，判断不出用 en（docs/guides/i18n.md）。 */
 export type LanguageSetting = "auto" | "zh" | "en";
 export declare const LANGUAGE_SETTINGS: readonly LanguageSetting[];
 /** [W6-A] Agent 栏：auto 有任务时显示；off 不显示（嵌入宿主缺省 off）。 */
@@ -27,7 +27,7 @@ export interface UiConfigW6 {
 export type MemoryScopeName = "user" | "project";
 export declare const MEMORY_SCOPES: readonly MemoryScopeName[];
 export declare const MEMORY_SUBAGENT_MODES: readonly ["off", "read"];
-/** [W6-M] `memory` 段（docs/wave6-plan.md §3.1）。缺省关闭；关闭时系统提示、工具表、请求体逐字节不变。 */
+/** [W6-M] `memory` 段（docs/history/wave6-plan.md §3.1）。缺省关闭；关闭时系统提示、工具表、请求体逐字节不变。 */
 export interface MemoryConfig {
     /** 总开关，缺省 false；项目级只能设为 false；`--memory` / `--no-memory`、`AMA_MEMORY=0|1` 覆盖。 */
     enabled?: boolean;
@@ -42,7 +42,7 @@ export interface MemoryConfig {
     /** 子会话：read（缺省，写命令执行层拒绝）/ off（view 也拒绝）。 */
     subagents?: (typeof MEMORY_SUBAGENT_MODES)[number];
 }
-/** [W6-O] ChatGPT 登录的两条路径（docs/wave6-plan.md §4.1、D13）。 */
+/** [W6-O] ChatGPT 登录的两条路径（docs/history/wave6-plan.md §4.1、D13）。 */
 export type ChatGptFlavor = "siwc" | "codex";
 export declare const CHATGPT_FLAVORS: readonly ChatGptFlavor[];
 /** [W6-O] `auth.chatgpt`：不含密钥；只认用户级 / profile。 */
@@ -85,7 +85,7 @@ export interface ApiKeyAuthEntry {
     baseUrl?: string;
 }
 /**
- * [W6-O] auth.json 里的 OAuth 条目（docs/wave6-plan.md §4.3、D15）。token 与 id_token 原文绝不进日志、错误、
+ * [W6-O] auth.json 里的 OAuth 条目（docs/history/wave6-plan.md §4.3、D15）。token 与 id_token 原文绝不进日志、错误、
  * 事件、会话；`describeAuthFile` 只给 `{ kind: "oauth", flavor, plan, expiresIn, needsLogin }`。
  */
 export interface OAuthAuthEntry {

package/dist/config/types-w6.js

@@ -1,5 +1,5 @@
 /**
- * 第六波配置键的形状（docs/wave6-plan.md §7、§1.3、§3.1、§4.3、§4.4、§5.2）。[W6-C0] 契约文件：C0 只定形状、
+ * 第六波配置键的形状（docs/history/wave6-plan.md §7、§1.3、§3.1、§4.3、§4.4、§5.2）。[W6-C0] 契约文件：C0 只定形状、
  * 校验（schema-w6.ts）、说明与缺省（key-docs.ts）、JSON Schema；行为由各批次实现，未实现前这些键被接受但不起作用。
  *
  * 层级（merge.ts）：项目级可设 `ui.language`、`ui.agentBar`，`memory` 只接受 `enabled: false`；`ui.replyLanguage`、

package/dist/config/types.d.ts

@@ -7,7 +7,7 @@
  * hooks.json 的形状是 `HookConfig`（hooks/types.ts）。
  * （W3-C0）第三波：`cache` 段（§1.12，只认用户级 / profile）；`ModelConfig` / `ModelOverride`
  * 允许模型级 `api`（§2.3，同一中转的模型走不同协议），由 W3-B12 在注册表里生效。
- * （W5-C0）第五波配置键（docs/wave5-plan.md §9）：新段的形状在 types-w5.ts（`AmaConfigW5` 并入
+ * （W5-C0）第五波配置键（docs/history/wave5-plan.md §9）：新段的形状在 types-w5.ts（`AmaConfigW5` 并入
  * `AmaConfig`），已有段加 `ui.statusLine`、`compaction.prune / pruneExclude`、profile `agentDirs`。
  */
 import type { WarmingMode } from "../ai/cache/types.js";
@@ -27,13 +27,13 @@ export declare const CONFIG_FILE_VERSION: 1;
  */
 export type ModelConfig = Partial<Omit<Model, "id" | "provider" | "channel" | "channels">> & {
     id: string;
-    /** 挂载的渠道名，第一个是首选；缺省 `defaultChannel`（docs/providers.md「渠道」）。 */
+    /** 挂载的渠道名，第一个是首选；缺省 `defaultChannel`（docs/guides/providers.md「渠道」）。 */
     channels?: string[];
     /** models.dev 条目 `provider/model`（显式匹配）；false 关闭 models.dev 补全。 */
     modelsDev?: string | false;
     /**
      * [ME-C0] 从内置目录继承模型固有属性：缺省按 id 别名自动匹配；`"provider/id"` 显式指定；false 关闭
-     * （docs/model-efficiency-plan.md D10，实现归 ME-D）。
+     * （docs/history/model-efficiency-plan.md D10，实现归 ME-D）。
      */
     catalog?: string | false;
 };
@@ -63,7 +63,7 @@ export interface ProviderConfig {
     headers?: Record<string, string>;
     compat?: ProviderCompat;
     requiresApiKey?: boolean;
-    /** 多渠道（docs/providers.md「渠道」）；不写时 `api` + `baseUrl` 是隐式的 `default` 渠道。 */
+    /** 多渠道（docs/guides/providers.md「渠道」）；不写时 `api` + `baseUrl` 是隐式的 `default` 渠道。 */
     channels?: Record<string, ChannelConfig>;
     /** 缺省 `channels` 的第一个键。 */
     defaultChannel?: string;
@@ -206,7 +206,7 @@ export declare const MIN_CONTEXT_BUDGET = 32768;
 export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 180000;
 export declare const CHECKPOINT_MODES: readonly CheckpointMode[];
 /**
- * 检查点（docs/rewind-plan.md §5）。环境变量 `AMA_CHECKPOINTS` 覆盖 `mode`；项目级只接受
+ * 检查点（docs/history/rewind-plan.md §5）。环境变量 `AMA_CHECKPOINTS` 覆盖 `mode`；项目级只接受
  * `mode: "off"` 与调小 `maxFileBytes`（只能收紧）。
  */
 export interface CheckpointsConfig {
@@ -222,7 +222,7 @@ export declare const SANDBOX_ENABLED_MODES: readonly ("auto" | "off")[];
 /** [S2] `sandbox.network` 的取值。 */
 export declare const SANDBOX_NETWORK_MODES: readonly ("deny" | "allow")[];
 /**
- * 操作系统级沙箱（docs/sandbox.md）。只认用户级 / profile；项目级只接受收紧的 `network: "deny"`，其余忽略
+ * 操作系统级沙箱（docs/guides/sandbox.md）。只认用户级 / profile；项目级只接受收紧的 `network: "deny"`，其余忽略
  * 并 warning。环境变量 `AMA_SANDBOX=off` 覆盖 `enabled`。
  */
 export interface SandboxConfig {

package/dist/config/types.js

@@ -7,7 +7,7 @@
  * hooks.json 的形状是 `HookConfig`（hooks/types.ts）。
  * （W3-C0）第三波：`cache` 段（§1.12，只认用户级 / profile）；`ModelConfig` / `ModelOverride`
  * 允许模型级 `api`（§2.3，同一中转的模型走不同协议），由 W3-B12 在注册表里生效。
- * （W5-C0）第五波配置键（docs/wave5-plan.md §9）：新段的形状在 types-w5.ts（`AmaConfigW5` 并入
+ * （W5-C0）第五波配置键（docs/history/wave5-plan.md §9）：新段的形状在 types-w5.ts（`AmaConfigW5` 并入
  * `AmaConfig`），已有段加 `ui.statusLine`、`compaction.prune / pruneExclude`、profile `agentDirs`。
  */
 export { AGENT_BAR_MODES, CHATGPT_FLAVORS, LANGUAGE_SETTINGS, MEMORY_SCOPES, MEMORY_SUBAGENT_MODES, apiKeyEntry, isOAuthEntry, } from "./types-w6.js";

package/dist/drivers/acp/client.d.ts

@@ -1,5 +1,5 @@
 /**
- * ACP 客户端（docs/wave5-plan.md §5.1，D14）。[W5-E]
+ * ACP 客户端（docs/history/wave5-plan.md §5.1，D14）。[W5-E]
  *
  * JSON-RPC over NDJSON（{@link JsonRpcPeer}），手写零依赖；`@armadra/agent/acp` 导出供 Armadra 复用。
  *

package/dist/drivers/acp/client.js

@@ -1,5 +1,5 @@
 /**
- * ACP 客户端（docs/wave5-plan.md §5.1，D14）。[W5-E]
+ * ACP 客户端（docs/history/wave5-plan.md §5.1，D14）。[W5-E]
  *
  * JSON-RPC over NDJSON（{@link JsonRpcPeer}），手写零依赖；`@armadra/agent/acp` 导出供 Armadra 复用。
  *

package/dist/drivers/acp/driver.d.ts

@@ -1,5 +1,5 @@
 /**
- * AcpDriver：经 ACP 驱动外部 Agent（docs/wave5-plan.md §5.1–§5.2，D14）。[W5-E]
+ * AcpDriver：经 ACP 驱动外部 Agent（docs/history/wave5-plan.md §5.1–§5.2，D14）。[W5-E]
  *
  * open：起进程 → `initialize` → 续聊优先 `session/resume`（不回放），其次 `session/load`
  * （回放的历史通知在 open 期间丢弃），都不支持则新开并发 notice「已新开」→ 按 ama 模式

package/dist/drivers/acp/driver.js

@@ -1,5 +1,5 @@
 /**
- * AcpDriver：经 ACP 驱动外部 Agent（docs/wave5-plan.md §5.1–§5.2，D14）。[W5-E]
+ * AcpDriver：经 ACP 驱动外部 Agent（docs/history/wave5-plan.md §5.1–§5.2，D14）。[W5-E]
  *
  * open：起进程 → `initialize` → 续聊优先 `session/resume`（不回放），其次 `session/load`
  * （回放的历史通知在 open 期间丢弃），都不支持则新开并发 notice「已新开」→ 按 ama 模式

package/dist/drivers/acp/testing/fake-agent.d.ts

@@ -1,5 +1,5 @@
 /**
- * 黄金记录用的假 ACP Agent（docs/wave5-plan.md §5.1、§5.7）。[W5-E]
+ * 黄金记录用的假 ACP Agent（docs/history/wave5-plan.md §5.1、§5.7）。[W5-E]
  *
  * 零依赖、不联网、不碰文件系统；行为由提示文本里的标记决定，供 ama 自己的测试与 Armadra 复用
  * （`@armadra/agent/acp` 导出 {@link runFakeAcpAgent} 与可执行入口路径）：

package/dist/drivers/acp/testing/fake-agent.js

@@ -1,5 +1,5 @@
 /**
- * 黄金记录用的假 ACP Agent（docs/wave5-plan.md §5.1、§5.7）。[W5-E]
+ * 黄金记录用的假 ACP Agent（docs/history/wave5-plan.md §5.1、§5.7）。[W5-E]
  *
  * 零依赖、不联网、不碰文件系统；行为由提示文本里的标记决定，供 ama 自己的测试与 Armadra 复用
  * （`@armadra/agent/acp` 导出 {@link runFakeAcpAgent} 与可执行入口路径）：

package/dist/drivers/acp/types.d.ts

@@ -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`、