@armadra/agent 0.8.0 → 0.8.1

package/dist/bundle/ama.cjs

@@ -41,7 +41,7 @@ var AMA_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    AMA_VERSION = true ? "0.8.0" : readPackageVersion();
+    AMA_VERSION = true ? "0.8.1" : readPackageVersion();
   }
 });
 
@@ -3712,8 +3712,8 @@ var init_config_keys = __esm({
       version: "Config file format version; always 1",
       defaultModel: "Default model provider/model or provider/model@channel; when unset it is picked automatically (ama config show shows which one and why)",
       thinkingLevel: "Thinking level",
-      providers: "Custom providers and overrides of built-in providers (docs/providers.md)",
-      permission: "Permissions (docs/permissions.md)",
+      providers: "Custom providers and overrides of built-in providers (docs/guides/providers.md)",
+      permission: "Permissions (docs/guides/permissions.md)",
       "permission.mode": "Permission mode; project level can only make it stricter",
       "permission.allow": "Allow rules, e.g. bash(npm test); cannot be added at project level",
       "permission.deny": "Deny rules, e.g. write(**/.env); accumulated across levels",
@@ -3740,7 +3740,7 @@ var init_config_keys = __esm({
       "tools.maxToolResultChars": "Character limit for one tool result in the context; beyond it head and tail are kept",
       "tools.bashTimeoutMs": "Default bash timeout (ms; overridable per call, max 600000)",
       "tools.disabled": "Disabled tool names; accumulated across levels",
-      codemode: "codemode: the model writes scripts that call tools in batches (docs/codemode.md)",
+      codemode: "codemode: the model writes scripts that call tools in batches (docs/guides/codemode.md)",
       "codemode.mode": "off | on | only; when unset it follows the preset: default → on (Node ≥ 25; Node 22 / 24 → off), codemode-only → only, minimal / coordinator → off; project level only accepts off",
       "codemode.inlineBudget": "Budget (estimated tokens) for inlining tool declarations in the description in only mode; beyond it only names are listed",
       "codemode.requireStrict": "true: disable codemode when the runtime Node does not isolate the network (Node 22 / 24)",
@@ -3764,7 +3764,7 @@ var init_config_keys = __esm({
       "ui.language": "Interface language: auto decides from LC_ALL / LC_MESSAGES / LANG (zh* is Chinese, anything else English), zh, en; AMA_LANG and --lang override; affects the interface only, text sent to the model is always English",
       "ui.replyLanguage": "Reply language for the model (e.g. Chinese): one English rule is appended to the end of the rules section at session start; zero-byte change when unset; user level only (effective from wave 6)",
       "ui.agentBar": "Agent bar (sub-agent list above the status line): auto shows it while tasks exist, off hides it; press ↓ on an empty input to enter it",
-      memory: "Cross-session memory (docs/memory.md): off by default, requests are byte-identical while off; project level can only set enabled: false (effective from wave 6 W6-M)",
+      memory: "Cross-session memory (docs/guides/memory.md): off by default, requests are byte-identical while off; project level can only set enabled: false (effective from wave 6 W6-M)",
       "memory.enabled": "Master switch; --memory / --no-memory and AMA_MEMORY=0|1 override",
       "memory.scopes": "Enabled scopes: user (data directory, across projects), project (keyed by a hash of the repository path)",
       "memory.indexMaxBytes": "Per-scope limit for the index in the system prompt (bytes); truncated by update time beyond it",
@@ -3790,11 +3790,11 @@ var init_config_keys = __esm({
       "cache.minSavingsUsd": "Minimum expected savings (USD) for warming",
       "cache.missNotices": "Show cache misses and remaining context in the message area",
       "cache.warmSubagents": "Also warm sub-sessions (task)",
-      checkpoints: 'Checkpoints: file backups used to roll back code (docs/sessions.md "Checkpoints and file backups")',
+      checkpoints: 'Checkpoints: file backups used to roll back code (docs/guides/sessions.md "Checkpoints and file backups")',
       "checkpoints.mode": "tools: track files changed by edit / write; shadow-git: also snapshot the whole working directory with a shadow git so direct changes (bash etc.) can be rolled back too (needs git; large directories fall back to tools); off: disabled; AMA_CHECKPOINTS overrides; project level only accepts off",
       "checkpoints.maxFileBytes": "Backup limit for a single file (bytes); larger files are not backed up and rollback reports them as unrecoverable; project level can only lower it",
       "checkpoints.keep": "Number of recent checkpoints available for rollback; older ones are no longer listed; user level / profile only",
-      sandbox: 'OS-level sandbox (docs/sandbox.md); user level / profile only, project level only accepts network: "deny"',
+      sandbox: 'OS-level sandbox (docs/guides/sandbox.md); user level / profile only, project level only accepts network: "deny"',
       "sandbox.enabled": "auto: use macOS sandbox-exec / Linux bwrap or unshare when available (codemode child processes are denied network and writes; this isolates codemode's network on Node 22 / 24); off: not used; AMA_SANDBOX=off overrides",
       "sandbox.bash": "auto: run bash through sandbox-exec / bwrap (unshare does not count), writes limited to the workspace, temp dir, output dir and sandbox.writable, and sandboxed commands need no approval in default mode; off: not used; user level / profile only",
       "sandbox.network": "Network inside the bash sandbox: deny blocks it (required for approval-free sandboxed commands); allow permits network but writes stay limited and approval works as usual; project level can only set deny",
@@ -3841,8 +3841,8 @@ var init_config_keys = __esm({
       version: "配置文件格式版本，固定为 1",
       defaultModel: "缺省模型 provider/model 或 provider/model@channel；不写时零配置自动选择（ama config show 显示选了谁、为什么）",
       thinkingLevel: "思考强度",
-      providers: "自定义供应商与对内置供应商的覆盖（docs/providers.md）",
-      permission: "权限（docs/permissions.md）",
+      providers: "自定义供应商与对内置供应商的覆盖（docs/guides/providers.md）",
+      permission: "权限（docs/guides/permissions.md）",
       "permission.mode": "权限模式；项目级只能更严",
       "permission.allow": "放行规则，如 bash(npm test)；项目级不能加",
       "permission.deny": "拒绝规则，如 write(**/.env)；各层累加",
@@ -3869,7 +3869,7 @@ var init_config_keys = __esm({
       "tools.maxToolResultChars": "单条工具结果进上下文的字符上限，超出保留首尾",
       "tools.bashTimeoutMs": "bash 缺省超时（毫秒，单次调用可覆盖，最大 600000）",
       "tools.disabled": "禁用的工具名；各层累加",
-      codemode: "codemode：模型写脚本批量调用工具（docs/codemode.md）",
+      codemode: "codemode：模型写脚本批量调用工具（docs/guides/codemode.md）",
       "codemode.mode": "off | on | only；不写时跟随预设：default → on（Node ≥ 25；Node 22 / 24 → off）、codemode-only → only、minimal / coordinator → off；项目级只接受 off",
       "codemode.inlineBudget": "only 模式在描述里内联工具声明的预算（估算 token），超出只列名字",
       "codemode.requireStrict": "true：运行时 Node 不隔离网络（Node 22 / 24）时直接禁用 codemode",
@@ -3893,7 +3893,7 @@ var init_config_keys = __esm({
       "ui.language": "界面语言：auto 按 LC_ALL / LC_MESSAGES / LANG 判断（zh* 为中文，其余英文），zh，en；AMA_LANG、--lang 覆盖；只影响界面，发给模型的文本固定英文",
       "ui.replyLanguage": "模型回复语言（如 Chinese）：会话开始在 rules 节末尾追加一句英文规则；不设时零字节变化；只认用户级（第六波起生效）",
       "ui.agentBar": "Agent 栏（状态行上方的子 Agent 列表）：auto 有任务时显示，off 不显示；空输入时按 ↓ 进入",
-      memory: "跨会话记忆（docs/memory.md）：缺省关闭，关闭时请求逐字节不变；项目级只能设 enabled: false（第六波 W6-M 起生效）",
+      memory: "跨会话记忆（docs/guides/memory.md）：缺省关闭，关闭时请求逐字节不变；项目级只能设 enabled: false（第六波 W6-M 起生效）",
       "memory.enabled": "总开关；--memory / --no-memory、AMA_MEMORY=0|1 覆盖",
       "memory.scopes": "启用的作用域：user（数据目录，跨项目）、project（按仓库路径哈希）",
       "memory.indexMaxBytes": "每作用域索引进系统提示的上限（字节），超出按更新时间截断",
@@ -3919,11 +3919,11 @@ var init_config_keys = __esm({
       "cache.minSavingsUsd": "保温的最低期望节省（美元）",
       "cache.missNotices": "在消息区提示缓存未命中与上下文余量",
       "cache.warmSubagents": "子会话（task）也保温",
-      checkpoints: "检查点：回滚代码用的文件备份（docs/sessions.md「检查点与文件备份」）",
+      checkpoints: "检查点：回滚代码用的文件备份（docs/guides/sessions.md「检查点与文件备份」）",
       "checkpoints.mode": "tools：跟踪 edit / write 改过的文件；shadow-git：另用影子 git 快照整个工作目录，bash 等直接改动也能回滚（需要 git，大目录自动降级为 tools）；off：关闭；AMA_CHECKPOINTS 覆盖；项目级只接受 off",
       "checkpoints.maxFileBytes": "单个文件的备份上限（字节），超出不备份、回滚时报告无法恢复；项目级只能调小",
       "checkpoints.keep": "可回滚的最近检查点数，更早的不再列为回滚点；只认用户级 / profile",
-      sandbox: '操作系统级沙箱（docs/sandbox.md）；只认用户级 / profile，项目级只接受 network: "deny"',
+      sandbox: '操作系统级沙箱（docs/guides/sandbox.md）；只认用户级 / profile，项目级只接受 network: "deny"',
       "sandbox.enabled": "auto：探测到可用的 macOS sandbox-exec / Linux bwrap、unshare 就用（codemode 子进程拒绝网络与写入；Node 22 / 24 上 codemode 因此网络隔离）；off：不用；AMA_SANDBOX=off 覆盖",
       "sandbox.bash": "auto：bash 经 sandbox-exec / bwrap 运行（unshare 不算），写入只限工作区、临时目录、输出目录与 sandbox.writable，default 模式下沙箱内命令免审批；off：不用；只认用户级 / profile",
       "sandbox.network": "bash 沙箱里的网络：deny 拒绝（沙箱内免审批的前提）；allow 允许联网但写入仍受限、照常审批；项目级只能设 deny",
@@ -4085,7 +4085,7 @@ var init_config = __esm({
       /** config.schema.json 里供应商内部字段的说明（顶层与各段的键用 `keys`）。 */
       jsonSchema: {
         api: "Protocol",
-        compat: 'Protocol compatibility switches (docs/providers.md "compat")',
+        compat: 'Protocol compatibility switches (docs/guides/providers.md "compat")',
         modelId: "Model id (the name sent upstream)",
         modelBaseUrl: "Overrides the channel / provider address",
         contextWindow: "Context tokens; filled from models.dev by default, not guessed when there is no match",
@@ -4201,7 +4201,7 @@ var init_config = __esm({
       },
       jsonSchema: {
         api: "协议",
-        compat: "协议兼容开关（docs/providers.md「compat」）",
+        compat: "协议兼容开关（docs/guides/providers.md「compat」）",
         modelId: "模型 id（发给上游的名字）",
         modelBaseUrl: "覆盖渠道 / 供应商的地址",
         contextWindow: "上下文 token；缺省从 models.dev 补，匹配不到不猜",
@@ -7135,7 +7135,7 @@ var init_builtin = __esm({
         baseUrl: "https://openrouter.ai/api/v1",
         envKeys: ["OPENROUTER_API_KEY", "AMA_API_KEY_OPENROUTER"],
         headers: {
-          "HTTP-Referer": "https://github.com/Owlbay/armadra-agent",
+          "HTTP-Referer": "https://github.com/AMA-Link/armadra-agent",
           "X-Title": "ama"
         },
         requiresApiKey: true
@@ -7235,7 +7235,7 @@ var init_builtin = __esm({
         requiresApiKey: true
       },
       {
-        // [W6-O] ChatGPT 订阅（docs/wave6-plan.md §4、D14）：`ama auth login chatgpt` 写 auth.json 的 OAuth 条目；
+        // [W6-O] ChatGPT 订阅（docs/history/wave6-plan.md §4、D14）：`ama auth login chatgpt` 写 auth.json 的 OAuth 条目；
         // 缺省渠道在组装时按条目的 flavor 定（compose-providers.ts）。模型表为空：`chatgpt/<slug>` 任意接受，
         // `ama models discover chatgpt` 列出账户可用的 slug。缓存只有 prompt_cache_key（无 24h / 30m 显式缓存）。
         id: "chatgpt",
@@ -22673,7 +22673,7 @@ var init_system_prompt = __esm({
       "rules",
       "project_context",
       "skills",
-      // [W6-C0] 记忆索引（W6-M，docs/wave6-plan.md §3.4）；未开启时为 undefined，字节不变
+      // [W6-C0] 记忆索引（W6-M，docs/history/wave6-plan.md §3.4）；未开启时为 undefined，字节不变
       "memory",
       "hooks",
       "cwd",
@@ -29416,7 +29416,7 @@ var init_session2 = __esm({
           return Promise.reject(new AmaError("busy", "cannot compact while running"));
         return this.startCycle((signal) => this.compaction.compactManual(instructions, signal, cutAt));
       }
-      // [RW-B] 回滚（docs/rewind-plan.md §3；编排与校验在 session-rewind.ts）
+      // [RW-B] 回滚（docs/history/rewind-plan.md §3；编排与校验在 session-rewind.ts）
       rewindPoints = () => this.rewinder.points();
       rewind = (request) => this.rewinder.rewind(request);
       summarizeFrom = (entryId, instructions) => this.rewinder.summarizeFrom(entryId, instructions);
@@ -45194,7 +45194,7 @@ var init_json_schema = __esm({
     init_schema_w5();
     init_types_w5();
     CONFIG_SCHEMA_FILE = "config.schema.json";
-    CONFIG_SCHEMA_ID = "https://github.com/Owlbay/armadra-agent/config.schema.json";
+    CONFIG_SCHEMA_ID = "https://github.com/AMA-Link/armadra-agent/config.schema.json";
     KNOWN_APIS = [
       "openai-completions",
       "openai-responses",
@@ -52296,7 +52296,7 @@ var init_builtin3 = __esm({
     BUILTIN_SKILLS_DIR = "builtin";
     AMA_DOCS_BODY = `# ama quick reference
 
-ama is the coding agent running this session. Docs: https://github.com/Owlbay/armadra-agent (README.md, docs/).
+ama is the coding agent running this session. Docs: https://github.com/AMA-Link/armadra-agent (README.md, docs/).
 
 ## Files
 - User config dir \`~/.config/ama/\` (\`AMA_CONFIG_DIR\`; Windows \`%APPDATA%\\ama\`): \`config.json\`, \`auth.json\` (keys, 0600), \`hooks.json\`, \`keybindings.json\`, \`trust.json\`, \`AGENTS.md\`, \`skills/\`, \`prompts/\`.
@@ -53622,7 +53622,7 @@ function compactEvent(event) {
       if (event.toolResults.length === 0) return event;
       return {
         ...event,
-        // 线上形状（docs/rpc.md）不是完整的 ToolResultMessage：正文与 details 都不带
+        // 线上形状（docs/reference/rpc.md）不是完整的 ToolResultMessage：正文与 details 都不带
         toolResults: event.toolResults.map(
           ({ toolCallId: toolCallId2, toolName, isError, timestamp }) => ({
             toolCallId: toolCallId2,
@@ -55808,7 +55808,7 @@ var init_commands = __esm({
       },
       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 !== void 0) {
@@ -55823,7 +55823,7 @@ var init_commands = __esm({
       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/checkpoints/blobs.d.ts

@@ -1,5 +1,5 @@
 /**
- * 检查点备份存储（docs/rewind-plan.md §1.1）。[RW-A]
+ * 检查点备份存储（docs/history/rewind-plan.md §1.1）。[RW-A]
  *
  * - 位置 `<dataDir>/file-history/blobs/<sha256 前 2 位>/<sha256>`，内容为文件原字节；
  *   先写 `<name>.tmp-<pid>-<序号>` 再 rename，已存在即跳过（内容寻址，同内容只存一份）。

package/dist/checkpoints/blobs.js

@@ -1,5 +1,5 @@
 /**
- * 检查点备份存储（docs/rewind-plan.md §1.1）。[RW-A]
+ * 检查点备份存储（docs/history/rewind-plan.md §1.1）。[RW-A]
  *
  * - 位置 `<dataDir>/file-history/blobs/<sha256 前 2 位>/<sha256>`，内容为文件原字节；
  *   先写 `<name>.tmp-<pid>-<序号>` 再 rename，已存在即跳过（内容寻址，同内容只存一份）。

package/dist/checkpoints/gc.d.ts

@@ -1,5 +1,5 @@
 /**
- * 备份清理（docs/rewind-plan.md §1.4）。[RW-A]
+ * 备份清理（docs/history/rewind-plan.md §1.4）。[RW-A]
  *
  * - 标记：递归扫描会话根目录下全部 `*.jsonl`（含 `.trash/`，trash 里的会话还能找回），凡含
  *   `ama.checkpoint` 的行，取其中所有 64 位十六进制串作为引用。不解析 JSON：损坏或未来格式的行也只会

package/dist/checkpoints/gc.js

@@ -1,5 +1,5 @@
 /**
- * 备份清理（docs/rewind-plan.md §1.4）。[RW-A]
+ * 备份清理（docs/history/rewind-plan.md §1.4）。[RW-A]
  *
  * - 标记：递归扫描会话根目录下全部 `*.jsonl`（含 `.trash/`，trash 里的会话还能找回），凡含
  *   `ama.checkpoint` 的行，取其中所有 64 位十六进制串作为引用。不解析 JSON：损坏或未来格式的行也只会

package/dist/checkpoints/git-head.d.ts

@@ -1,5 +1,5 @@
 /**
- * 读 git HEAD（docs/rewind-plan.md §1.2、D6）。[RW-A]
+ * 读 git HEAD（docs/history/rewind-plan.md §1.2、D6）。[RW-A]
  *
  * 不起 git 进程：从 cwd 向上找 `.git`（目录，或 worktree / 子模块的 `gitdir: <路径>` 文件），读 `HEAD`；
  * 符号引用先查 gitdir 再查 `commondir`（worktree 的分支引用在主仓库），最后查 `packed-refs`。

package/dist/checkpoints/git-head.js

@@ -1,5 +1,5 @@
 /**
- * 读 git HEAD（docs/rewind-plan.md §1.2、D6）。[RW-A]
+ * 读 git HEAD（docs/history/rewind-plan.md §1.2、D6）。[RW-A]
  *
  * 不起 git 进程：从 cwd 向上找 `.git`（目录，或 worktree / 子模块的 `gitdir: <路径>` 文件），读 `HEAD`；
  * 符号引用先查 gitdir 再查 `commondir`（worktree 的分支引用在主仓库），最后查 `packed-refs`。

package/dist/checkpoints/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * 检查点（docs/rewind-plan.md）的对外入口。[RW-A]
+ * 检查点（docs/history/rewind-plan.md）的对外入口。[RW-A]
  *
  * 会话接线（RW-B）用 `createCheckpointBackendFactory` + `resolveCheckpointSettings`；
  * 其余导出给 CLI（GC、占用）与测试。

package/dist/checkpoints/index.js

@@ -1,5 +1,5 @@
 /**
- * 检查点（docs/rewind-plan.md）的对外入口。[RW-A]
+ * 检查点（docs/history/rewind-plan.md）的对外入口。[RW-A]
  *
  * 会话接线（RW-B）用 `createCheckpointBackendFactory` + `resolveCheckpointSettings`；
  * 其余导出给 CLI（GC、占用）与测试。

package/dist/checkpoints/replay.d.ts

@@ -1,5 +1,5 @@
 /**
- * 从会话条目重建检查点（docs/rewind-plan.md §1.2）。[RW-A]
+ * 从会话条目重建检查点（docs/history/rewind-plan.md §1.2）。[RW-A]
  *
  * - 按文件顺序重放全部条目（不限活动分支）里的 `ama.checkpoint` 与 `ama.checkpoint-track`；
  *   track 并入对应 userEntryId 的检查点（检查点里已有该文件时不覆盖）。

package/dist/checkpoints/replay.js

@@ -1,5 +1,5 @@
 /**
- * 从会话条目重建检查点（docs/rewind-plan.md §1.2）。[RW-A]
+ * 从会话条目重建检查点（docs/history/rewind-plan.md §1.2）。[RW-A]
  *
  * - 按文件顺序重放全部条目（不限活动分支）里的 `ama.checkpoint` 与 `ama.checkpoint-track`；
  *   track 并入对应 userEntryId 的检查点（检查点里已有该文件时不覆盖）。

package/dist/checkpoints/restore.d.ts

@@ -1,5 +1,5 @@
 /**
- * 恢复代码（docs/rewind-plan.md §3.2）。[RW-A]
+ * 恢复代码（docs/history/rewind-plan.md §3.2）。[RW-A]
  *
  * 对每个已跟踪文件，取目标检查点里的记录，没有则取该文件最早的记录：
  * 1. 记录 `skipped` → 报告 too_large / not_regular；

package/dist/checkpoints/restore.js

@@ -1,5 +1,5 @@
 /**
- * 恢复代码（docs/rewind-plan.md §3.2）。[RW-A]
+ * 恢复代码（docs/history/rewind-plan.md §3.2）。[RW-A]
  *
  * 对每个已跟踪文件，取目标检查点里的记录，没有则取该文件最早的记录：
  * 1. 记录 `skipped` → 报告 too_large / not_regular；

package/dist/checkpoints/settings.d.ts

@@ -1,5 +1,5 @@
 /**
- * 检查点配置解析（docs/rewind-plan.md §5）。[RW-A]
+ * 检查点配置解析（docs/history/rewind-plan.md §5）。[RW-A]
  *
  * `AMA_CHECKPOINTS`（tools | shadow-git | off）> config `checkpoints.mode` > 缺省 tools；
  * 无效的环境变量值 warn 后忽略。`maxFileBytes` / `keep` 取配置，缺省 5 MiB / 100。

package/dist/checkpoints/settings.js

@@ -1,5 +1,5 @@
 /**
- * 检查点配置解析（docs/rewind-plan.md §5）。[RW-A]
+ * 检查点配置解析（docs/history/rewind-plan.md §5）。[RW-A]
  *
  * `AMA_CHECKPOINTS`（tools | shadow-git | off）> config `checkpoints.mode` > 缺省 tools；
  * 无效的环境变量值 warn 后忽略。`maxFileBytes` / `keep` 取配置，缺省 5 MiB / 100。

package/dist/checkpoints/shadow-git.d.ts

@@ -1,5 +1,5 @@
 /**
- * 影子 git 仓库（docs/rewind-plan.md §6）。[RW-D]
+ * 影子 git 仓库（docs/history/rewind-plan.md §6）。[RW-D]
  *
  * - 位置 `<dataDir>/file-history/shadow/<sha256(cwd) 前 16>/`，用 `--git-dir` 指向它、`--work-tree` 指向 cwd；
  *   不碰用户仓库的对象、索引与引用。git 以子进程调用（零运行时依赖）。

package/dist/checkpoints/shadow-git.js

@@ -1,5 +1,5 @@
 /**
- * 影子 git 仓库（docs/rewind-plan.md §6）。[RW-D]
+ * 影子 git 仓库（docs/history/rewind-plan.md §6）。[RW-D]
  *
  * - 位置 `<dataDir>/file-history/shadow/<sha256(cwd) 前 16>/`，用 `--git-dir` 指向它、`--work-tree` 指向 cwd；
  *   不碰用户仓库的对象、索引与引用。git 以子进程调用（零运行时依赖）。

package/dist/checkpoints/shadow-restore.d.ts

@@ -1,5 +1,5 @@
 /**
- * 按影子提交恢复代码（docs/rewind-plan.md §6）。[RW-D]
+ * 按影子提交恢复代码（docs/history/rewind-plan.md §6）。[RW-D]
  *
  * 1. 把当前工作区写成树，与目标提交做 `diff-tree`：只处理有差异的文件，被忽略的文件不在两边的树里，不会被碰。
  *    目标里有、当前树里没有但磁盘上还在的文件（现在被忽略了）跳过。

package/dist/checkpoints/shadow-restore.js

@@ -1,5 +1,5 @@
 /**
- * 按影子提交恢复代码（docs/rewind-plan.md §6）。[RW-D]
+ * 按影子提交恢复代码（docs/history/rewind-plan.md §6）。[RW-D]
  *
  * 1. 把当前工作区写成树，与目标提交做 `diff-tree`：只处理有差异的文件，被忽略的文件不在两边的树里，不会被碰。
  *    目标里有、当前树里没有但磁盘上还在的文件（现在被忽略了）跳过。

package/dist/checkpoints/tracker.d.ts

@@ -1,5 +1,5 @@
 /**
- * 检查点运行时状态（docs/rewind-plan.md §1.3、§2）。[RW-A]
+ * 检查点运行时状态（docs/history/rewind-plan.md §1.3、§2）。[RW-A]
  *
  * - `beforeWrite`：文件在任何检查点里都没出现过 → 备份当前内容、追加 `ama.checkpoint-track`、
  *   加入已跟踪；出现过则什么都不做。失败只 warn，不抛（检查点是辅助，不能让编辑失败）。

package/dist/checkpoints/tracker.js

@@ -1,5 +1,5 @@
 /**
- * 检查点运行时状态（docs/rewind-plan.md §1.3、§2）。[RW-A]
+ * 检查点运行时状态（docs/history/rewind-plan.md §1.3、§2）。[RW-A]
  *
  * - `beforeWrite`：文件在任何检查点里都没出现过 → 备份当前内容、追加 `ama.checkpoint-track`、
  *   加入已跟踪；出现过则什么都不做。失败只 warn，不抛（检查点是辅助，不能让编辑失败）。

package/dist/checkpoints/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * 检查点与回滚契约（docs/rewind-plan.md §1、§3）。契约文件，实现归 RW-A（`src/checkpoints/**`）
+ * 检查点与回滚契约（docs/history/rewind-plan.md §1、§3）。契约文件，实现归 RW-A（`src/checkpoints/**`）
  * 与 RW-B（`src/agent/session-rewind.ts`）。
  *
  * - 会话条目两类，均为 `custom`（不进上下文）：`ama.checkpoint`（新回合的用户消息之后）与

package/dist/checkpoints/types.js

@@ -1,5 +1,5 @@
 /**
- * 检查点与回滚契约（docs/rewind-plan.md §1、§3）。契约文件，实现归 RW-A（`src/checkpoints/**`）
+ * 检查点与回滚契约（docs/history/rewind-plan.md §1、§3）。契约文件，实现归 RW-A（`src/checkpoints/**`）
  * 与 RW-B（`src/agent/session-rewind.ts`）。
  *
  * - 会话条目两类，均为 `custom`（不进上下文）：`ama.checkpoint`（新回合的用户消息之后）与

package/dist/cli/args.d.ts

@@ -82,7 +82,7 @@ export interface ParsedArgs {
     prompt?: string;
     /** 原始位置参数。 */
     positionals: string[];
-    /** [W6-C0] `--lang zh|en`：界面语言（`AMA_LANG` 优先，docs/i18n.md）。 */
+    /** [W6-C0] `--lang zh|en`：界面语言（`AMA_LANG` 优先，docs/guides/i18n.md）。 */
     lang?: Locale;
     /** [W6-C0] `--memory` → true、`--no-memory` → false：覆盖 `memory.enabled`（W6-M）。 */
     memory?: boolean;
@@ -102,7 +102,7 @@ export declare class UsageError extends AmaError {
 export { helpText } from "./help-text.js";
 export declare function emptyArgs(): ParsedArgs;
 /**
- * ACP terminal 型认证方法的入口（docs/acp.md「无模型时」）：客户端把方法的 `args` **追加**到配置好的
+ * ACP terminal 型认证方法的入口（docs/reference/acp.md「无模型时」）：客户端把方法的 `args` **追加**到配置好的
  * Agent 启动命令后面（规范原文 append），实际得到 `ama --mode acp … --acp-terminal-auth <id>`。
  * 见到这个标志就不再按启动参数解析，转成对应的 `auth` 子命令；同一条命令里的 `--auth-file`、`--lang` 一并带上。
  */

package/dist/cli/args.js

@@ -312,7 +312,7 @@ function validate(args) {
     }
 }
 /**
- * ACP terminal 型认证方法的入口（docs/acp.md「无模型时」）：客户端把方法的 `args` **追加**到配置好的
+ * ACP terminal 型认证方法的入口（docs/reference/acp.md「无模型时」）：客户端把方法的 `args` **追加**到配置好的
  * Agent 启动命令后面（规范原文 append），实际得到 `ama --mode acp … --acp-terminal-auth <id>`。
  * 见到这个标志就不再按启动参数解析，转成对应的 `auth` 子命令；同一条命令里的 `--auth-file`、`--lang` 一并带上。
  */

package/dist/cli/bootstrap.js

@@ -416,7 +416,7 @@ export async function runCli(argv, deps, io) {
     }
     catch (error) {
         try {
-            // [ACP-A] --mode acp 没有可用模型：认证门照常握手，会话方法重试 bootstrap（docs/acp-plan.md §2.2）
+            // [ACP-A] --mode acp 没有可用模型：认证门照常握手，会话方法重试 bootstrap（docs/history/acp-plan.md §2.2）
             if (acp && error instanceof StartupError && error.exitCode === ExitCode.NoModel)
                 return await (await import("../modes/acp/acp-auth-gate.js")).runAcpAuthGate(args, deps, io, error);
             return reportError(error, io);

package/dist/cli/choice-prompt.d.ts

@@ -5,7 +5,7 @@
  *   Esc / Ctrl+C / stdin 结束 = 取消；
  * - 结束后把列表收成一行「? 问题 答案」，恢复 raw 状态与光标，暂停 stdin；进程意外退出时也恢复；
  * - 颜色与字形按环境：`NO_COLOR` / 非 TTY 输出无色，`AMA_ASCII` / 区域设置决定 ASCII 字形（字形表见
- *   docs/tui-design.md §2.2）；
+ *   docs/design/tui-design.md §2.2）；
  * - 输入不是可开 raw 的 TTY（管道、CI）时 {@link confirmContinue} 回落为原来的文本 `[y/N]` 问答。
  */
 export interface ChoiceInput {

package/dist/cli/choice-prompt.js

@@ -5,7 +5,7 @@
  *   Esc / Ctrl+C / stdin 结束 = 取消；
  * - 结束后把列表收成一行「? 问题 答案」，恢复 raw 状态与光标，暂停 stdin；进程意外退出时也恢复；
  * - 颜色与字形按环境：`NO_COLOR` / 非 TTY 输出无色，`AMA_ASCII` / 区域设置决定 ASCII 字形（字形表见
- *   docs/tui-design.md §2.2）；
+ *   docs/design/tui-design.md §2.2）；
  * - 输入不是可开 raw 的 TTY（管道、CI）时 {@link confirmContinue} 回落为原来的文本 `[y/N]` 问答。
  */
 import { createInterface } from "node:readline/promises";

package/dist/cli/codemode-notice.d.ts

@@ -1,6 +1,6 @@
 /**
  * codemode 缺省关闭的一次性提示（设计 §5.5「默认开放」）：`default` 预设跟随预设时只在沙箱 strict
- * （Node ≥ 25，或有可用的操作系统沙箱，docs/sandbox.md）开 codemode；否则缺省关闭，启动时提示一次
+ * （Node ≥ 25，或有可用的操作系统沙箱，docs/guides/sandbox.md）开 codemode；否则缺省关闭，启动时提示一次
  * 怎么显式开启。
  *
  * - 只在「跟随预设」且预设是 `default`、运行时不是 strict 时提示；显式写了 `codemode.mode`（含 off）

package/dist/cli/codemode-notice.js

@@ -1,6 +1,6 @@
 /**
  * codemode 缺省关闭的一次性提示（设计 §5.5「默认开放」）：`default` 预设跟随预设时只在沙箱 strict
- * （Node ≥ 25，或有可用的操作系统沙箱，docs/sandbox.md）开 codemode；否则缺省关闭，启动时提示一次
+ * （Node ≥ 25，或有可用的操作系统沙箱，docs/guides/sandbox.md）开 codemode；否则缺省关闭，启动时提示一次
  * 怎么显式开启。
  *
  * - 只在「跟随预设」且预设是 `default`、运行时不是 strict 时提示；显式写了 `codemode.mode`（含 off）

package/dist/cli/compose-agents.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 的组装（docs/wave5-plan.md §7.1、§7.4，D22–D24）。[W5-G]
+ * 子 Agent 的组装（docs/history/wave5-plan.md §7.1、§7.4，D22–D24）。[W5-G]
  *
  * 由 compose-extensions.ts 的一行接入：每次装配会话时发现定义文件（`--agent-dir` / profile
  * `agentDirs` → config `agents.dirs` → 用户级 → 项目级（需信任）），建类型目录并绑到 task 工具

package/dist/cli/compose-agents.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 的组装（docs/wave5-plan.md §7.1、§7.4，D22–D24）。[W5-G]
+ * 子 Agent 的组装（docs/history/wave5-plan.md §7.1、§7.4，D22–D24）。[W5-G]
  *
  * 由 compose-extensions.ts 的一行接入：每次装配会话时发现定义文件（`--agent-dir` / profile
  * `agentDirs` → config `agents.dirs` → 用户级 → 项目级（需信任）），建类型目录并绑到 task 工具

package/dist/cli/compose-extensions.d.ts

@@ -1,5 +1,5 @@
 /**
- * 会话扩展的组装表（docs/wave5-plan.md §10.1，D30）。[W5-C0]
+ * 会话扩展的组装表（docs/history/wave5-plan.md §10.1，D30）。[W5-C0]
  *
  * 唯一允许多个批次各加一行的文件：每个批次在 `composeExtensions` 的数组里追加**一行**自己的工厂，
  * 实现放在各自文件（`src/agent/session-<名>.ts` 等）。表顺序即调用顺序：

package/dist/cli/compose-extensions.js

@@ -1,5 +1,5 @@
 /**
- * 会话扩展的组装表（docs/wave5-plan.md §10.1，D30）。[W5-C0]
+ * 会话扩展的组装表（docs/history/wave5-plan.md §10.1，D30）。[W5-C0]
  *
  * 唯一允许多个批次各加一行的文件：每个批次在 `composeExtensions` 的数组里追加**一行**自己的工厂，
  * 实现放在各自文件（`src/agent/session-<名>.ts` 等）。表顺序即调用顺序：

package/dist/cli/compose-memory.d.ts

@@ -1,5 +1,5 @@
 /**
- * 记忆的组装（docs/wave6-plan.md §3、D8、D9、D11、D12）。[W6-M]
+ * 记忆的组装（docs/history/wave6-plan.md §3、D8、D9、D11、D12）。[W6-M]
  *
  * - 开关：独立终端看合并后的 `memory.enabled`（用户级 / profile.config；项目级只能设 false；`--memory` /
  *   `--no-memory`；`AMA_MEMORY=0|1` 经 bootstrap 并入命令行覆盖，命令行优先）。缺省关闭：不建运行期、不读盘、

package/dist/cli/compose-memory.js

@@ -1,5 +1,5 @@
 /**
- * 记忆的组装（docs/wave6-plan.md §3、D8、D9、D11、D12）。[W6-M]
+ * 记忆的组装（docs/history/wave6-plan.md §3、D8、D9、D11、D12）。[W6-M]
  *
  * - 开关：独立终端看合并后的 `memory.enabled`（用户级 / profile.config；项目级只能设 false；`--memory` /
  *   `--no-memory`；`AMA_MEMORY=0|1` 经 bootstrap 并入命令行覆盖，命令行优先）。缺省关闭：不建运行期、不读盘、

package/dist/cli/compose-providers.d.ts

@@ -9,7 +9,7 @@
  * - SDK 追加的供应商（`ProviderData[]`）折成 `config.providers` 条目，走同一条合并路径。
  * - 零配置（设计 §10.0）：没有 `defaultModel`、也没有任何需要 key 的供应商配了 key 时，探测本地
  *   ollama / lmstudio（短超时），把枚举到的模型加进注册表，供 `pickDefaultModel` 选用。
- * - [W6-O] ChatGPT 登录（docs/wave6-plan.md D14）：`chatgpt` 的缺省渠道按 auth.json 条目的 flavor 定（用户写了
+ * - [W6-O] ChatGPT 登录（docs/history/wave6-plan.md D14）：`chatgpt` 的缺省渠道按 auth.json 条目的 flavor 定（用户写了
  *   `defaultChannel` 时不动）；`AMA_CHATGPT_BASE_URL` 改该渠道地址；`auth.chatgpt.originator` 改 codex 渠道的
  *   `originator` 头；OAuth 刷新拿到 `auth.chatgpt` 配置与同一份 env。
  * - 发现缓存（`<dataDir>/models/discovered/<provider>.json`）并入模型表为空的供应商（discovered-cache.ts）；

package/dist/cli/compose-providers.js

@@ -9,7 +9,7 @@
  * - SDK 追加的供应商（`ProviderData[]`）折成 `config.providers` 条目，走同一条合并路径。
  * - 零配置（设计 §10.0）：没有 `defaultModel`、也没有任何需要 key 的供应商配了 key 时，探测本地
  *   ollama / lmstudio（短超时），把枚举到的模型加进注册表，供 `pickDefaultModel` 选用。
- * - [W6-O] ChatGPT 登录（docs/wave6-plan.md D14）：`chatgpt` 的缺省渠道按 auth.json 条目的 flavor 定（用户写了
+ * - [W6-O] ChatGPT 登录（docs/history/wave6-plan.md D14）：`chatgpt` 的缺省渠道按 auth.json 条目的 flavor 定（用户写了
  *   `defaultChannel` 时不动）；`AMA_CHATGPT_BASE_URL` 改该渠道地址；`auth.chatgpt.originator` 改 codex 渠道的
  *   `originator` 头；OAuth 刷新拿到 `auth.chatgpt` 配置与同一份 env。
  * - 发现缓存（`<dataDir>/models/discovered/<provider>.json`）并入模型表为空的供应商（discovered-cache.ts）；

package/dist/cli/compose-request.d.ts

@@ -1,5 +1,5 @@
 /**
- * 模型请求的流中空闲超时（docs/model-efficiency-plan.md D18）。[ME-C]
+ * 模型请求的流中空闲超时（docs/history/model-efficiency-plan.md D18）。[ME-C]
  *
  * 等响应头仍由 `request.idleTimeoutMs` / `AMA_IDLE_TIMEOUT_MS`（compose-session.ts `idleTimeoutFrom`）
  * 决定；流开始后两块数据之间的上限读 `AMA_STREAM_IDLE_TIMEOUT_MS` > config

package/dist/cli/compose-request.js

@@ -1,5 +1,5 @@
 /**
- * 模型请求的流中空闲超时（docs/model-efficiency-plan.md D18）。[ME-C]
+ * 模型请求的流中空闲超时（docs/history/model-efficiency-plan.md D18）。[ME-C]
  *
  * 等响应头仍由 `request.idleTimeoutMs` / `AMA_IDLE_TIMEOUT_MS`（compose-session.ts `idleTimeoutFrom`）
  * 决定；流开始后两块数据之间的上限读 `AMA_STREAM_IDLE_TIMEOUT_MS` > config

package/dist/cli/from-prompt.d.ts

@@ -1,5 +1,5 @@
 /**
- * `--from <会话 id>[#编号]`：用旧会话里的一条用户消息作为新提示（docs/sessions.md「复用」）。[W4-D]
+ * `--from <会话 id>[#编号]`：用旧会话里的一条用户消息作为新提示（docs/guides/sessions.md「复用」）。[W4-D]
  *
  * - 文本：那条消息的文本；命令行另有位置参数时接在后面（空一行）；
  * - 图片：`-p` 时把图片块写进临时目录、追加到 `--image`（沿用 print 模式的图片校验：模型不收图片 →

package/dist/cli/from-prompt.js

@@ -1,5 +1,5 @@
 /**
- * `--from <会话 id>[#编号]`：用旧会话里的一条用户消息作为新提示（docs/sessions.md「复用」）。[W4-D]
+ * `--from <会话 id>[#编号]`：用旧会话里的一条用户消息作为新提示（docs/guides/sessions.md「复用」）。[W4-D]
  *
  * - 文本：那条消息的文本；命令行另有位置参数时接在后面（空一行）；
  * - 图片：`-p` 时把图片块写进临时目录、追加到 `--image`（沿用 print 模式的图片校验：模型不收图片 →

package/dist/cli/main.d.ts

@@ -15,7 +15,7 @@
  * - 签名 `main(argv): Promise<number>` 与「直接执行才自动运行」判定保持不变：
  *   src/bundle.ts 显式调用 `main()`。
  * - [W6-C0] 界面语言在解析参数后、任何输出前定一次：`AMA_LANG` > `--lang` > 用户级 `ui.language` >
- *   `LC_ALL` / `LC_MESSAGES` / `LANG`（docs/i18n.md）；profile / 项目级的 `ui.language` 由 bootstrap 合并后补定。
+ *   `LC_ALL` / `LC_MESSAGES` / `LANG`（docs/guides/i18n.md）；profile / 项目级的 `ui.language` 由 bootstrap 合并后补定。
  */
 import type { CliIo, RuntimeDeps, StdinKind } from "./deps.js";
 import { type LanguageSetting } from "../i18n/index.js";

package/dist/cli/main.js

@@ -15,7 +15,7 @@
  * - 签名 `main(argv): Promise<number>` 与「直接执行才自动运行」判定保持不变：
  *   src/bundle.ts 显式调用 `main()`。
  * - [W6-C0] 界面语言在解析参数后、任何输出前定一次：`AMA_LANG` > `--lang` > 用户级 `ui.language` >
- *   `LC_ALL` / `LC_MESSAGES` / `LANG`（docs/i18n.md）；profile / 项目级的 `ui.language` 由 bootstrap 合并后补定。
+ *   `LC_ALL` / `LC_MESSAGES` / `LANG`（docs/guides/i18n.md）；profile / 项目级的 `ui.language` 由 bootstrap 合并后补定。
  */
 import { fstatSync, readFileSync, realpathSync } from "node:fs";
 import { join } from "node:path";

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

@@ -1,6 +1,6 @@
 /**
  * `ama auth set|list|remove <provider>`（设计 §3.5、§16.2 B5 验收）。[B5]
- * `ama auth login|logout|status chatgpt`（docs/wave6-plan.md §4.2）。[W6-O] 实现在 auth/chatgpt/cli.ts。
+ * `ama auth login|logout|status chatgpt`（docs/history/wave6-plan.md §4.2）。[W6-O] 实现在 auth/chatgpt/cli.ts。
  *
  * - set：key 从 stdin 读取（TTY 下不回显），不经命令行参数，避免进 shell 历史；写 auth.json 0600。
  *   [ACP-A] 不给 provider 且 stdin 是 TTY 时先用方向键选内置的需 key 供应商（ACP 终端登录方法

package/dist/cli/subcommands/auth.js

@@ -1,6 +1,6 @@
 /**
  * `ama auth set|list|remove <provider>`（设计 §3.5、§16.2 B5 验收）。[B5]
- * `ama auth login|logout|status chatgpt`（docs/wave6-plan.md §4.2）。[W6-O] 实现在 auth/chatgpt/cli.ts。
+ * `ama auth login|logout|status chatgpt`（docs/history/wave6-plan.md §4.2）。[W6-O] 实现在 auth/chatgpt/cli.ts。
  *
  * - set：key 从 stdin 读取（TTY 下不回显），不经命令行参数，避免进 shell 历史；写 auth.json 0600。
  *   [ACP-A] 不给 provider 且 stdin 是 TTY 时先用方向键选内置的需 key 供应商（ACP 终端登录方法