thincoder 0.12.60 → 0.12.61

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## [0.12.61] — 2026-09-11
+
+> 0.12.60 → 0.12.61（§4.3 连续号——发布时定号）
+
+### Added
+
+- **集成集 + 发布门三环（TEST-LIFECYCLE 批）**：`test/integration/`（7 场景 22 用例：普通模式工具流 / 工程模式全链 / 子代理生命周期 / 会话恢复 / TUI 基本盘 / commit 验证关口 / 配置与 provider 选路）+ `test/run-integration.mjs`；`npm run release:check` = lint → test:full → test:integration（prepublishOnly 接线）——发布唯一门禁。
+- **需求池机检 `scripts/check-ledger.mjs`**（FR18 收拢）：指针解析 / D3 组计数 / 六态 / 触发字段 / 老化报告 / 基线降报告；两仓台账收拢（活 30+9 · 归档档 40+11）。
+- **provider.headers 全通路铺开**（Gitee #IKDWH7）· **`~` 家目录展开**（HOME-EXPANSION）· **websearch provider key**（工具面）。
+- **DeepSeek V4.1-Flash 接入** + 模型清单 provider 化（去候选否决权）。
+- **工程模式链路**：角色重定义（FR9 三分 + 内容权）/ 公共层扩容（common.md 10 节·双端 18 档）/ 批次档段写入工具 / 可移植性 FR10–FR15（项目约定去硬编码：`conventions.mjs` + `project-context.mjs`）。
+- **逃生与可观测面**：子代理 abort 来源标注 · 评审池丢弃（报告不达提醒 + 不签发 token）· consult/escalate 完全异步化 · `read_history` 跨会话检索（R19）。
+
+### Changed
+
+- **测试生命周期 v3**：三层来源（单元=开发期脚手架 / 集成-业务 / 集成-生产）+ 退役常态 + 削段合档（11 档退役 ~880 行 · 3 并 · 防回潮静态锚 T75/T76 收归）。
+- **台账体系**：TODO 归档机制（活文件只留未决 + `TODO-archive.md`）+ 归属修订「记录 + 状态推进 + 物理落笔 = 主 agent」+ 六态机检。
+- **TUI**：选择面统一（picker/wizard/question）· 输入修复集 · 方向键（连续上溯/多行竖移）· Stop 钩子 · 跨段 turn 累计 · attention 状态。
+
+### Fixed
+
+- settings 工具 null 默认键类型校验 · ACP 通道修整（headless 裁剪 + relay 前缀剥离）· 评审注入路径硬编码（可移植性 A 家族）· advisor 上下文预算（CJK 加权）· 文档一致性检查扩面 + 宽度基线。
+
 ## [0.12.60] — 2026-09-08
 
 > 0.12.59 → 0.12.60（§4.5 连续号——发布时定号）
@@ -39,7 +62,7 @@
 
 ### Added
 
-- **settings 工具（SETTINGS-TOOL.md——2026-09-05 用户三项裁定）**：agent 配置调整通道——list/get/set（全量 config.json 任意键点分路径）；set = 写盘 + 热应用（运行中即生效）；敏感键（apiKey/token/secret/password 段）回显永遮罩；已知键类型校验（DEFAULTS 自动派生）；list/get 只读动作（planMode 放行）；set 审批门。测试 T-S1.1-11（CLI 11 + VS Code 6）。
+- **settings 工具（SETTINGS-TOOL.md——2026-09-05 用户三项裁定）**：agent 配置调整通道——list/get/set（全量 config.json 任意键点分路径）；set = 写盘 + 热应用（运行中即生效）；敏感键（apiKey/token/secret/password 段）回显永遮罩；已知键类型校验（DEFAULTS 自动派生）；list/get 只读动作（planMode 放行）；set 审批门。测试 T-S1.1-11（CLI 11 + VS Code 6）——**记账更正（2026-09-11）：原声称的测试未随批落地（欠账）；已于 2026-09-11 补齐：CLI 25 例 / VS Code 6 例（第 8 批）。**
 - **subagent-async 模块拆分（§20.9 Module Split Policy——2026-09-05 F-N1.5 两段式首批）**：CLI subagent-async.mjs 1020 → 405 行（subagent-scheduler.mjs 231——§20 调度组 + 文件域组 / subagent-actions.mjs 416——status/panel/escalate 动作执行器组）——纯迁移零行为变化（测试零改动 + 断言计数前后对拍一致）。
 - **P-SL2 停滞机械检测（AGENT-LOOP §21.1 扩展注 P-SL2——2026-09-05）**：混合边环形等待停滞 → check/status 守卫明确报错列阻塞链（cancel 破环引导）——防御性（自然流不可达——人工注入可构造）。测试 T-SL2 ①-⑤（scheduler 22 → 27 用例）。
 

package/README.md

@@ -121,7 +121,7 @@ Configuration comes exclusively from `~/.thincoder/config.json` — no environme
     },
   ],
   "activeProvider": "deepseek", // currently active provider name
-  "shell": null, // bash tool shell (win11: e.g. "C:\\Program Files\\Git\\bin\\bash.exe" or "pwsh"); null = system default — cmd on Windows (UTF-8 forced per command), /bin/sh elsewhere. TUI: /shell
+  "shell": null, // bash tool shell (win11: e.g. "C:\\Program Files\\Git\\bin\\bash.exe" or "pwsh"); null = system default — cmd on Windows (UTF-8 forced per command), /bin/sh elsewhere. TUI: /shell; a leading ~ in the path expands to the home directory
   "embedding": {
     // optional: without it, retrieval is pure FTS
     "baseURL": "https://api.siliconflow.cn/v1",
@@ -135,8 +135,9 @@ Configuration comes exclusively from `~/.thincoder/config.json` — no environme
     "compactThreshold": 100000, // context compaction threshold (approx. tokens)
   },
   "memory": {
-    "dbPath": "~/.thincoder/memory.db", // sqlite index path
-    "projectDir": ".thincoder/memory", // Project layer directory (relative to project root)
+    // Path fields (dbPath / projectDir / team.dir / shell) expand a leading ~ (~, ~/, ~\) to the home directory at load time
+    "dbPath": "~/.thincoder/memory.db", // sqlite index path (~ expands to the home directory)
+    "projectDir": ".thincoder/memory", // Project layer directory (relative to project root; ~ expands to an absolute path used as-is)
     "team": {
       // optional: Team layer disabled without it
       "name": "myteam",
@@ -156,7 +157,6 @@ Configuration comes exclusively from `~/.thincoder/config.json` — no environme
   "websearch": {
     // optional: Tavily structured search (stable JSON API, no HTML scraping).
     // Empty apiKey → silently falls back to Bing HTML extraction (zero-config).
-    "provider": "tavily",
     "apiKey": "tvly-...", // https://tavily.com — has a free monthly tier
   },
 }
@@ -196,8 +196,10 @@ src/
                     clipboard.mjs (paste/copy), ansi.mjs
   tui.mjs           re-export shim → src/tui/index.mjs
   tui-render.mjs    re-export shim → src/tui/render.mjs
-  prompts/          prompt texts — system.md (core), discipline.md (coding/testing rules),
-                    main.md (main-agent overlay), explore.md / coder.md / plan.md (subagent roles)
+  prompts/          prompt texts — slot-based (PROMPT-SYSTEM): persona-engineering / persona-normal /
+                    persona-{eng-coder,explore,coder,plan} + common + discipline-engineering / discipline-normal
+                    + special modules (consult-base / advisor-design / advisor-round{1,2,3});
+                    assembly = assemblePrompt (prompt-overlays.mjs): persona → common → discipline → [4] AGENTS+skills
 test/               node:test offline unit tests (npm test)
 scripts/            real-environment verification scripts (compaction, team sync)
 ```

package/bin/thincoder.mjs

@@ -14,7 +14,7 @@
  */
 
 import { readFileSync } from "node:fs"
-import { join } from "node:path"
+import { isAbsolute, join } from "node:path"
 import { runAgent } from "../src/agent.mjs"
 import { loadConfig, configPath } from "../src/config.mjs"
 import { cleanupTraces } from "../src/traces/trace-store.mjs"
@@ -26,8 +26,15 @@ import { summarize, askPermission } from "../src/cli/permission.mjs"
 import { distillCommand } from "../src/cli/distill-command.mjs"
 import { prepareCrashReporting, recentCrashHint, writeCrashRecord } from "../src/crash-reports.mjs"
 import { setTuiActive, restoreTerminalAfterCrash } from "../src/tui/tui-lifecycle.mjs"
+import { spawnTuiWrapped } from "../src/tui/wrapped-spawn.mjs"
 
 const [command, ...args] = process.argv.slice(2)
+// TUI-STDERR-CAPTURE（F-1）：TUI 启动（tui/无命令）默认包装——父 spawn 子 tee stderr 落盘（外部
+// 终止/native abort——第 4 类崩溃面——诊断默认捕获）。须在 prepareCrashReporting 前（父不预建/不设
+// report——子进程做——R25 保留）。env 门已设（包装内子进程）或包装失败 → 直行现逻辑（尽力面）。
+if ((command === undefined || command === "tui") && !process.env.THINCODER_TUI_WRAPPED) {
+  if (spawnTuiWrapped()) await new Promise(() => {}) // 包装成功 → 挂起（tee/收尾退出全在 wrapped-spawn——不达下方 switch）
+}
 const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version
 
 // R25（F-R25b）：crash-reports 预建 + process.report 启用——入口最前（一切重活前——缩编程
@@ -96,7 +103,7 @@ Usage:
   thincoder completion <sh>  Generate shell completion script (bash / zsh / fish)
   thincoder -v, --version   Print version
 
-Config: ~/.thincoder/config.json (providers[] + activeProvider; manage via /provider, /model in TUI)
+Config: ~/.thincoder/config.json — providers[] (one default model per channel) + defaultModel (new-session starting point); the available-model list is fetched from the provider at runtime (GET /models); manage via /config → 默认模型 and /model (session-level) in TUI
 `
 
 /** Unified message when no API key is configured */
@@ -131,10 +138,11 @@ switch (command) {
     if (crashNotice) console.error(crashNotice)
 
     const agent = await assembleAgent()
-    // SESSION.md §8 D-S4（F4）：headless 无 TUI —— 可读错误 + 退出码 1，不弹 UI、不崩溃
+    // SESSION.md §8 D-S4（F4）+ MODEL-MERGE-SESSION：headless 无 TUI —— 可读错误 + 退出码 1，
+    // 不弹 UI、不崩溃；文案改引 defaultModel（F-6 引导 A headless 面——/config → 默认模型）
     if (agent._providerInvalid) {
-      const prov = agent.activeProvider || "(未设置)"
-      console.error(`[error] 未配置有效 provider（activeProvider "${prov}"：${agent._providerInvalidReason}）。请运行 thincoder 进入 TUI 重新选择，或编辑 ${configPath}`)
+      const dm = agent.config?.defaultModel
+      console.error(`[error] 未配置有效模型（defaultModel "${dm ?? "(not set)"}"：${agent._providerInvalidReason}）。请运行 thincoder 进入 TUI 设置（/config → 默认模型；或 /model 选择后以会话槽生效），或编辑 ${configPath}`)
       exitSoon(1)
       break
     }
@@ -216,7 +224,7 @@ switch (command) {
       memory.embedder = createEmbedder(config.embedding)
     }
     if (config.memory.projectDir) {
-      memory.projectOrigin = join(process.cwd(), config.memory.projectDir)
+      memory.projectOrigin = isAbsolute(config.memory.projectDir) ? config.memory.projectDir : join(process.cwd(), config.memory.projectDir)
     }
     const code = await memoryCommand(memory, args)
     if (code) exitSoon(code)
@@ -261,7 +269,7 @@ switch (command) {
     const cwd = process.cwd()
     let total = { added: 0, removed: 0 }
     if (config.memory.projectDir) {
-      const s = await syncDir(memory, { layer: "project", dir: join(cwd, config.memory.projectDir) })
+      const s = await syncDir(memory, { layer: "project", dir: isAbsolute(config.memory.projectDir) ? config.memory.projectDir : join(cwd, config.memory.projectDir) })
       total.added += s.added
     }
     const team = teamConfig(config)
@@ -288,13 +296,13 @@ switch (command) {
     const { resumeSlot, applySession } = await import("../src/session.mjs")
     const { slot, data } = resumeSlot(process.cwd())
     if (data) {
-      const switched = applySession(agent, data)
-      if (switched && agent.config?.agent?.compactThresholdAuto) {
-        // 压缩阈值跟模型走（与 TUI 切换 provider 时的处理一致）；传 provider 对象——
-        // providers[].context 覆盖生效（PROVIDER.md §15 T-C2）
-        const { resolveCompactThreshold } = await import("../src/config.mjs")
-        agent.config.agent.compactThreshold = resolveCompactThreshold(null, agent.provider).value
-      }
+      // applySession 内部已按槽复合重算 compactThreshold（auto 时）——不再需要 switched 分支
+      applySession(agent, data)
+      // SESSION.md §11.2（2026-09-08——N6 评审 🔴 修复）：process restarted 句 = 进程级
+      // 信号——仅本启动 resume 路径设一次（真进程重启恢复盘上会话）；/session 切换与 ACP
+      // 加载走同一 applySession 收敛但不设（不误报进程重启）。prepareRun 发句即清——进程
+      // 内一次。resumed:yes 独立由 applySession 的恢复事件武装（data.history 非空）。
+      agent._processRestartPending = true
     }
     // D-3 钉槽：applySession 清 _slot 后立即钉回恢复槽——首保存必落恢复槽（消除
     // "load → 首回合保存"窗口内并发方翻 active 导致的静默迁移）；/new 经 resetSessionState
@@ -315,7 +323,7 @@ switch (command) {
     const { startTUI } = await import("../src/tui.mjs")
     try {
       await startTUI(agent, {
-        projectDir: config.memory.projectDir ? join(process.cwd(), config.memory.projectDir) : null,
+        projectDir: config.memory.projectDir ? (isAbsolute(config.memory.projectDir) ? config.memory.projectDir : join(process.cwd(), config.memory.projectDir)) : null,
         team: teamConfig(config),
         author: gitAuthor(),
         restored: data,
@@ -336,113 +344,10 @@ switch (command) {
       exitSoon(1)
       break
     }
-    if (shell === "bash") {
-      process.stdout.write(`_thincoder() {
-  local cur prev words cword
-  _init_completion 2>/dev/null || { COMPREPLY=(); return; }
-  cur="\${COMP_WORDS[COMP_CWORD]}"
-  prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  case "\${COMP_WORDS[1]}" in
-    chat)    COMPREPLY=( \\$(compgen -W "--auto" -- "\\$cur") ) ;;
-    memory)
-      case "\\$prev" in
-        memory) COMPREPLY=( \\$(compgen -W "list search put remove" -- "\\$cur") ) ;;
-        list)   COMPREPLY=( \\$(compgen -W "--type=rule --type=knowledge --type=decision --type=pattern" -- "\\$cur") ) ;;
-        put)    COMPREPLY=( \\$(compgen -W "--type= --title= --content= --tags=" -- "\\$cur") ) ;;
-      esac ;;
-    distill) COMPREPLY=( \\$(compgen -W "--yes --layer=" -- "\\$cur") ) ;;
-    completion) COMPREPLY=( \\$(compgen -W "bash zsh fish" -- "\\$cur") ) ;;
-    *)
-      COMPREPLY=( \\$(compgen -W "chat acp memory sync reindex distill upgrade completion session -v --version -h --help" -- "\\$cur") ) ;;
-  esac
-}
-complete -F _thincoder thincoder
-`)
-    } else if (shell === "zsh") {
-      process.stdout.write(`#compdef thincoder
-
-_thincoder() {
-  local context state state_descr line
-  typeset -A opt_args
-  _arguments -C \\
-    '1: :->cmd' \\
-    '*:: :->args'
-
-  case "\\$state" in
-    cmd)
-      _values 'command' \\
-        'chat[One-shot agent run with tools]' \\
-        'acp[Agent Client Protocol server for IDEs]' \\
-        'memory[Manage long-term memory]' \\
-        'sync[Sync team memory repo]' \\
-        'reindex[Rebuild local index from markdown]' \\
-        'distill[Extract knowledge from session transcript]' \\
-        'upgrade[Update to latest version from npm]' \\
-        'completion[Generate shell completion script]' \\
-        'session[Session dir GC: session gc --dry-run|--confirm]'
-      ;;
-    args)
-      case "\\$words[1]" in
-        chat)    _arguments '--auto[Auto-approve all tool calls]' ;;
-        memory)
-          case "\\$words[2]" in
-            list) _arguments '--type=[Filter by type]' ;;
-            put)  _arguments '--type=[Entry type]' '--title=[Title]' '--content=[Content]' '--tags=[Space-separated tags]' ;;
-          esac ;;
-        distill) _arguments '--yes[Skip confirmation]' '--layer=[Layer filter]' ;;
-        completion) _values 'shell' 'bash' 'zsh' 'fish' ;;
-      esac ;;
-  esac
-}
-_thincoder
-`)
-    } else if (shell === "fish") {
-      process.stdout.write(`# thincoder completions for fish shell
-complete -c thincoder -f
-
-# Subcommands
-complete -c thincoder -a chat     -d 'One-shot agent run with tools'
-complete -c thincoder -a memory   -d 'Manage long-term memory'
-complete -c thincoder -a sync     -d 'Sync team memory repo'
-complete -c thincoder -a reindex  -d 'Rebuild local index from markdown'
-complete -c thincoder -a distill  -d 'Extract knowledge from session'
-complete -c thincoder -a upgrade  -d 'Update to latest version'
-complete -c thincoder -a completion -d 'Shell completion'
-complete -c thincoder -a session -d 'Session dir GC (session gc --dry-run|--confirm)'
-complete -c thincoder -a acp -d 'Agent Client Protocol server for IDEs'
-
-# Flags
-complete -c thincoder -s v -l version -d 'Print version'
-complete -c thincoder -s h -l help    -d 'Print help'
-
-# chat flags
-complete -c thincoder -n '__fish_seen_subcommand_from chat' -l auto -d 'Auto-approve tool calls'
-
-# memory subcommands
-complete -c thincoder -n '__fish_seen_subcommand_from memory' -a list   -d 'List entries'
-complete -c thincoder -n '__fish_seen_subcommand_from memory' -a search -d 'Search memory'
-complete -c thincoder -n '__fish_seen_subcommand_from memory' -a put    -d 'Add entry'
-complete -c thincoder -n '__fish_seen_subcommand_from memory' -a remove -d 'Remove entry'
-
-# memory list flags
-complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from list' -l type -d 'Filter by type' -xa 'rule knowledge decision pattern'
-
-# memory put flags
-complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from put' -l type    -d 'Entry type'
-complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from put' -l title   -d 'Title'
-complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from put' -l content -d 'Content'
-complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from put' -l tags    -d 'Space-separated tags'
-
-# distill flags
-complete -c thincoder -n '__fish_seen_subcommand_from distill' -l yes   -d 'Skip confirmation'
-complete -c thincoder -n '__fish_seen_subcommand_from distill' -l layer -d 'Layer filter'
-
-# completion shells
-complete -c thincoder -n '__fish_seen_subcommand_from completion' -a bash -d 'Bash completions'
-complete -c thincoder -n '__fish_seen_subcommand_from completion' -a zsh  -d 'Zsh completions'
-complete -c thincoder -n '__fish_seen_subcommand_from completion' -a fish -d 'Fish completions'
-`)
-    }
+    // §11.2 交付行数债（2026-09-08——500 行硬限触碰执行）：直写段逐字迁出
+    // src/completions.mjs（脚本字节不变——printCompletion 发射）
+    const { printCompletion } = await import("../src/completions.mjs")
+    printCompletion(shell)
     break
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thincoder",
-  "version": "0.12.60",
+  "version": "0.12.61",
   "description": "Thin coding agent - zero dependencies, no build step, Node.js native. Sharp code, zero bloat.",
   "keywords": [
     "ai",
@@ -35,7 +35,8 @@
     "prepublishOnly": "npm run release:check",
     "lint": "node scripts/check-syntax.mjs",
     "release:check": "node scripts/release-check.mjs",
-    "test:full": "node test/run-full.mjs"
+    "test:full": "node test/run-full.mjs",
+    "test:integration": "node test/run-integration.mjs"
   },
   "author": "liwei <liwei@51marine.com> (上海新舶)",
   "license": "MIT"

package/src/abort-provenance.mjs

@@ -0,0 +1,116 @@
+/**
+ * abort-provenance.mjs — abort 来源标注词汇表（单一权威源——AGENT-LOOP.md §20.3 第 1/2 条）
+ *
+ * 子代理 / 评审 / 会诊死亡的可诊断性：产生点标注结构化来源（`err.abortInfo`）→
+ * controller 链 hop 逐跳保 reason（§20.3 第 4 条 #10）→ 结算 / 报告面用 `deathLine`
+ * 合成死亡行（原 message 前缀逐字保留 + 来源后缀）。
+ *
+ * 纯函数、零 import——任意层可引、无环（provider / proxy / agent / settle 族共用）。
+ * 词汇表：
+ * - trigger（5 值）：`user`（reason.interrupt）· `timeout`（TimeoutError / 定时器面）·
+ *   `cancel`（定向中止）· `stop`（整批 / 会话 / 回合级停）· `unknown`（残留 / 未标注——告警态）。
+ * - layer（3 值）：`provider` / `agent` / `settle`；未标注错误回落 `unrecorded`（合成器 token）。
+ */
+
+/** trigger 枚举权威（测试锁计数 5——AGENT-LOOP.md §20.3 第 1 条表）。 */
+export const TRIGGERS = ["user", "timeout", "cancel", "stop", "unknown"]
+
+/**
+ * trigger 判定（判据序 = §20.3 第 1 条表；signal.reason 四形态：
+ * ① `{interrupt:true(,message)}`（既有 user 面）② `TimeoutError`（原生——timeout 面）
+ * ③ `{abortTrigger:"cancel"|"stop"|"timeout"(,abortDetail)}`（新增——程序性中止）
+ * ④ 缺失 / 无已知键（→ unknown——诊断告警态，不得静默）。
+ */
+export function triggerOf(signal) {
+  const reason = signal?.reason
+  if (reason == null) return "unknown"
+  if (reason.interrupt === true) return "user"
+  if (reason.name === "TimeoutError" || reason.abortTrigger === "timeout") return "timeout"
+  if (reason.abortTrigger === "cancel") return "cancel"
+  if (reason.abortTrigger === "stop") return "stop"
+  return "unknown"
+}
+
+/**
+ * 产生点错误（abort 面）：AbortError + `reason` 透传 + `abortInfo` 标注。
+ * message 取既有通用文案（既有前缀断言零回归——死亡行前缀逐字保留）。
+ */
+export function abortError(signal, layer, detail) {
+  const e = new DOMException("The operation was aborted", "AbortError")
+  e.reason = signal?.reason
+  e.abortInfo = { trigger: triggerOf(signal), layer, detail }
+  return e
+}
+
+/**
+ * 产生点错误（定时器面）：自有 message + `abortInfo{trigger:"timeout"}`。
+ * name 保持 "Error"（既有分类谓词——`AbortError` 分支——零变化）。
+ */
+export function timeoutError(message, layer, detail) {
+  const e = new Error(message)
+  e.abortInfo = { trigger: "timeout", layer, detail }
+  return e
+}
+
+/**
+ * 外部错误补标（undici / fetch 拒否等）：缺 `abortInfo` 才补（不覆盖产生点标注）；
+ * 不改 `name` / `message`（消费面零回归）。
+ * 第 4 参 detail 为站点名（站点表逐站点传——自由短串）。
+ */
+export function annotateAbort(err, signal, layer, detail) {
+  if (err?.abortInfo) return err
+  try {
+    err.abortInfo = { trigger: triggerOf(signal), layer, detail: detail ?? "unrecorded" }
+  } catch { /* frozen error——保持未标注（合成器 unknown 告警兜底） */ }
+  return err
+}
+
+/** 死亡行长度上限（AGENT-LOOP.md §20.3 第 3 条——超长优先截 detail）。 */
+const MAX_LEN = 300
+/** unknown 形态 detail token（§20.3 第 3 条逐字）。 */
+const NO_REASON = "no reason on signal"
+/** 未标注回落 token（layer / detail 两面兜底）。 */
+const UNRECORDED = "unrecorded"
+
+/** 信号域 detail 回落（§20.3 第 1 条形态③——`abortDetail` 载站点名；错误未标注时仍可辨发起动作）。 */
+const detailOf = (signal) => (typeof signal?.reason?.abortDetail === "string" ? signal.reason.abortDetail : null)
+
+/** 求值链（§20.3 第 1 条：err.abortInfo → triggerOf(signal) → err.name 兜底）。 */
+function resolveAbort(err, signal) {
+  const info = err?.abortInfo
+  if (info?.trigger) return { trigger: info.trigger, layer: info.layer ?? UNRECORDED, detail: info.detail || null }
+  const fromSignal = triggerOf(signal)
+  if (fromSignal !== "unknown") return { trigger: fromSignal, layer: UNRECORDED, detail: detailOf(signal) }
+  if (err?.name === "TimeoutError") return { trigger: "timeout", layer: UNRECORDED, detail: detailOf(signal) }
+  // AbortError / 无名——告警态（unknown 显式，空后缀即违规）
+  return { trigger: "unknown", layer: UNRECORDED, detail: NO_REASON }
+}
+
+/** detail 裁剪：优先截 detail（budget = 上限内剩余字符）。 */
+function clipDetail(detail, budget) {
+  if (budget <= 0) return ""
+  return detail.length <= budget ? detail : detail.slice(0, Math.max(1, budget - 1)) + "…"
+}
+
+/**
+ * 死亡行合成器（§20.3 第 3 条——报告面单点）：
+ * `<原 message>[ ← cause: <cause.message>][ · abort(<trigger>@<layer>:<detail>)]`
+ * - 原 message 前缀逐字保留（既有前缀 / 包含断言零回归）；
+ * - 后缀出现条件 = `err.abortInfo` 存在 ∨ `signal?.aborted` ∨ `err.name ∈ {AbortError, TimeoutError}`；
+ * - cause 段（P1）独立于后缀（"fetch failed" 类网络死亡真因同判）；
+ * - 总长 ≤300 字符（超长先截 detail，仍超再截尾）。
+ */
+export function deathLine(err, signal) {
+  let line = err?.message ?? String(err ?? "")
+  if (err?.cause?.message) line += ` ← cause: ${err.cause.message}`
+  const abortish = Boolean(err?.abortInfo) || Boolean(signal?.aborted) ||
+    err?.name === "AbortError" || err?.name === "TimeoutError"
+  if (abortish) {
+    const { trigger, layer, detail } = resolveAbort(err, signal)
+    const head = `${line} · abort(${trigger}@${layer}:`
+    // unknown 形态逐字用告警 token（§20.3 第 3 条——站点 detail 不进告警行）；非串 detail 归一化
+    const text = trigger === "unknown" ? NO_REASON : (detail == null ? UNRECORDED : String(detail))
+    line = `${head}${clipDetail(text, MAX_LEN - head.length - 1)})`
+  }
+  return line.length > MAX_LEN ? line.slice(0, MAX_LEN - 1) + "…" : line
+}

package/src/acp/bridge.mjs

@@ -21,6 +21,8 @@
  */
 import { detectDanger, normalizeEOL, joinWithEol } from "../tools/shared.mjs"
 import { computeEditEntry, validateEditEntry, assertEditArgsExclusive, hasLineParams } from "../tools/edit-diff.mjs"
+// 第 27 批 §12.3①/③：relay 前缀文法单一权威（模块直连——不自持正则副本）。
+import { parseRelayPath } from "../agent/relay-prefix.mjs"
 
 /** ACP ToolKind inference (schema v1 enum) — best-effort, clients render by kind. */
 function inferToolKind(name) {
@@ -167,26 +169,38 @@ export function buildAcpCallbacks({ sessionId, notify, request, log = () => {} }
 
   const callbacks = {
     onToken: (text) => {
-      // Strip the subagent `[model]` metadata token (role#id/[model]<name>) — it's a
+      // 第 27 批 §12.3③ 行 1（R-A2.1）：relay 前缀（role#id/——任意嵌套深度）零进显示面——
+      // 先剥前缀取 payload，信号判定与正文发送都作用在 payload 上。
+      const path = parseRelayPath(text)
+      const payload = path ? path.rest : text
+      // Strip the subagent `[model]` metadata token ([model]<name>) — it's a
       // TUI/webview display signal, not conversation content, and must not reach ACP clients.
-      // §19.5 D-M8 (round2 #6): nested prefixes recurse — eng-coder#2/explore#1/[model]…
-      if (/^(?:[\w-]+#\d+\/)*\[model\]/.test(text)) return
-      // D7 (AGENT-LOOP.md §7.2 + §19.5 round2 #6 + D-M7b): strip ⟦ev⟧ event tokens (bare or
-      // any-depth prefixed variants — turn/approval/done/settled/stopped/async — async
-      // = §19.5 D-M7b zero-field spawn marker) — they
-      // carry RS control characters and are a TUI display signal; structured ACP
+      if (/^\[model\]/.test(payload)) return
+      // D7 (AGENT-LOOP.md §7.2 + §19.5 round2 #6 + D-M7b): strip ⟦ev⟧ event tokens (turn/
+      // approval/done/settled/stopped/async — async = §19.5 D-M7b zero-field spawn marker)
+      // — they carry RS control characters and are a TUI display signal; structured ACP
       // mapping (tool_call_update) is tracked separately in docs/TODO.md.
       // 有意为之：控制字符协议/转义序列剥离正则（ANSI/⟦ev⟧/SGR/history 双线分隔）
-      if (/^(?:[\w-]+#\d+\/)*⟦ev⟧(?:turn|approval|done|settled|stopped|async)\x1e/.test(text)) return
-      update("agent_message_chunk", { content: { type: "text", text } })
+      if (/^⟦ev⟧(?:turn|approval|done|settled|stopped|async)\x1e/.test(payload)) return
+      if (!payload) return // D6：剥后空载荷不发通知（防噪声空 chunk）
+      update("agent_message_chunk", { content: { type: "text", text: payload } })
+    },
+    onReasoning: (text) => {
+      // 第 27 批 §12.3③ 行 2：同 onToken 取 payload；空载荷不发（D6）。
+      const path = parseRelayPath(text)
+      const payload = path ? path.rest : text
+      if (!payload) return
+      update("agent_thought_chunk", { content: { type: "text", text: payload } })
     },
-    onReasoning: (text) => update("agent_thought_chunk", { content: { type: "text", text } }),
     onUsage: (usage) => update("usage_update", { usage }),
     onWait: ({ phase, seconds }) => log(`[rate-limit] ${phase} waiting ~${seconds}s`),
     onCompress: () => log("[context] auto-compacted"),
 
     onToolCall: (name, args, toolId) => {
       const id = toolCallId()
+      // 第 27 批 §12.3③ 行 3：显示面剥前缀（title / kind）；配对键 toolQueue 存原样 name（D3）。
+      const path = parseRelayPath(name)
+      const shown = path ? path.rest : name
       // D15.8（advisor 🔴#1 修复）：模型级 id 每轮重置（sse.mjs finalizeToolCalls 内
       // seq=0——call_0 call_1… 跨轮/跨消息可重复——设计自注「跨 turn 不保证唯一」）。
       // 因此 push 前若队列已有同名同 toolId 条目，它必是结果永不回调的陈旧孤儿
@@ -200,8 +214,8 @@ export function buildAcpCallbacks({ sessionId, notify, request, log = () => {} }
       toolQueue.push({ name, id, toolId: toolId ?? null })
       update("tool_call", {
         toolCallId: id,
-        title: name,
-        kind: inferToolKind(name),
+        title: shown,
+        kind: inferToolKind(shown),
         status: "in_progress",
         rawInput: args ?? {},
         content: [contentBlock(JSON.stringify(args ?? {}))],
@@ -222,15 +236,19 @@ export function buildAcpCallbacks({ sessionId, notify, request, log = () => {} }
      * client. Any transport failure → reject (safety-first, kimi parity).
      */
     onPermissionRequest: async (name, args) => {
+      // 第 27 批 §12.3③ 行 4：显示面（请求文本 + toolCall.title）剥前缀；
+      // 危险基名判定与 peekToolId 照旧（配对键 = 原样名——D3）。
+      const path = parseRelayPath(name)
+      const shown = path ? path.rest : name
       // 危险命令标注(只提示不拦截):kimi 同款模式,帮助编辑器端用户审批
-      const base = name.includes("/") ? name.split("/").pop() : name
+      const base = shown.includes("/") ? shown.split("/").pop() : shown
       const danger = base === "bash" ? detectDanger(args?.command ?? "") : undefined
-      const content = [contentBlock(`Requesting approval to run ${name}`)]
+      const content = [contentBlock(`Requesting approval to run ${shown}`)]
       if (danger) content.push(contentBlock(`⚠️ Dangerous: ${danger}`))
       content.push(contentBlock(JSON.stringify(args ?? {})))
       const toolCall = {
-        toolCallId: peekToolId(name) ?? toolCallId(), // D15.8：peek 不消费——result 仍要与自己的条目配对
-        title: name,
+        toolCallId: peekToolId(name) ?? toolCallId(), // D15.8：peek 不消费（原样名键）——result 仍要与自己的条目配对
+        title: shown,
         content,
       }
       try {
@@ -328,7 +346,10 @@ export function replayHistory({ sessionId, notify, history, log = () => {} }) {
         // later tool_call_updates by toolCallId; an orphan update would be ignored.
         pendingToolCalls = calls.map((tc, i) => {
           const id = `t${++toolSeq}`
-          const title = tc?.name ?? "tool"
+          // 第 27 批 §12.3③ 行 5（防御面——T18）：历史工具名带前缀 → 剥；无前缀 → 零变化。
+          const raw = tc?.name ?? "tool"
+          const path = parseRelayPath(raw)
+          const title = path ? path.rest : raw
           update("tool_call", {
             toolCallId: id,
             title,

package/src/acp.mjs

@@ -71,12 +71,17 @@ export function defaultIsConfigured() {
   }
 }
 
+/** 第 27 批 §12.3⑤（R-A1.1）：ACP 会话装配期剔除的工具。ACP 是 headless 通道——
+ *  question 工具需要交互 UI（`src/tools/question.mjs` 无 `ctx.onQuestion` 即 throw），
+ *  模型可见即会调用、调用必错 → 装配期剔除（schema 直接少一条）。 */
+export const ACP_EXCLUDED_TOOLS = ["question"]
+
 /** M1/M2 session factory: one agent per session, built from the process cwd (single-cwd model).
  *  `id` is the ACP session id — it is baked into the callbacks at construction time
  *  (buildAcpCallbacks closure), so it must be known BEFORE createAcpSession runs.
  *  `request` is the transport's reverse-RPC channel (permissions + fs routing). */
 export async function defaultCreateSession({ id, notify, request, log }) {
-  const agent = await assembleAgent()
+  const agent = await assembleAgent({ excludeTools: ACP_EXCLUDED_TOOLS })
   return createAcpSession({ id, agent, notify, request, log })
 }