thincoder 0.12.66 → 0.12.68

package/src/tui/tool-args.mjs

@@ -1,81 +1,20 @@
 /**
- * tool-args.mjs — 工具调用参数的可读展示（2026-08-30，对齐 vscode 端卡片头的参数可见性）。
+ * tool-args.mjs — 工具调用参数的可读展示（**转口档** —— B7 1a 收编：`describeToolArgs` 体迁核件
+ * 单源 `@thincoder/core/tool-args.mjs`，本档同名转口、消费面零改；`toolArgsLines`（恢复路径全量
+ * pretty JSON dim 行）留端）。
  *
- * vscode 端：tool-call 卡片头 = name + args（80 字符截断，悬停看全量）。
- * TUI 端此前：live 标题行 = 原始 JSON 前 80 字符（长路径截半、不可读）；
- * 恢复的历史会话 = `  [tool] name` 完全没有参数（display snapshot 废弃后
- * historyToLines 是恢复的唯一路径，参数可见性随之丢失——用户报告）。
+ * 消费面（零改）：`tool-events.mjs`（live 标题行）· `startup.mjs`（历史恢复）· `subagent-blocks.mjs`
+ * （子代理块头）。
  *
- * 单源 describeToolArgs()：按工具挑关键参数的可读单行摘要（标题行/状态栏共用）；
- * 未知工具回退紧凑 JSON。恢复路径另外输出全量 pretty JSON 作 dim 行
- * （走既有连续 dim 自动折叠——与工具结果的恢复惯例一致；TUI 无悬停，
- * 全量必须落行）。
+ * 已登记差额（B7 §2 修正轮 1 ⑨）：默认分支截断 = 核件简版切片（码元 `slice`）替代本端
+ * `render.mjs` `sliceByWidth`（宽度感知 ∕ 全角计宽）——全角字符续接点可异于旧端（160 ∕ 80
+ * 两档触发）；码元切可断代理对（展示面）；机制句单源 = 核件档头。
  */
-import { sliceByWidth } from "./render.mjs"
 import { capLines, ARGS_JSON_MAX_CHARS } from "./display-budget.mjs"
-
-/** 单行参数摘要：按工具挑关键字段（vscode 卡片头对齐），未知工具回退 JSON。 */
-export function describeToolArgs(name, args) {
-  if (!args || typeof args !== "object") return ""
-  const a = args
-  switch (name) {
-    case "bash": case "cmd-shell": {
-      const cmd = String(a.command ?? "").replace(/\s+/g, " ").trim()
-      return cmd ? cmd + (a.workdir ? `  (in ${a.workdir})` : "") : ""
-    }
-    case "read": case "write": case "edit": case "hashline_edit": {
-      const p = a.path ? String(a.path) : ""
-      const extras = [
-        a.offset ? `offset ${a.offset}` : "",
-        a.limit ? `limit ${a.limit}` : "",
-        name === "edit" && a.old_string ? `old: ${String(a.old_string).replace(/\s+/g, " ").trim().slice(0, 30)}` : "",
-      ].filter(Boolean).join(", ")
-      return p ? `"${p}"${extras ? " · " + extras : ""}` : extras
-    }
-    case "grep": case "glob": case "code_search": case "doc_search": case "search": {
-      const pat = a.pattern ?? a.query ?? ""
-      const p = a.path ? ` in "${a.path}"` : ""
-      return `/${String(pat)}/${p}`
-    }
-    case "ls": {
-      const p = a.path ? String(a.path) : "."
-      return a.filter ? `${p}  (filter: ${String(a.filter)})` : p
-    }
-    case "websearch": return String(a.query ?? "")
-    case "subagent": case "coder": case "explore": case "plan": case "eng-coder": case "eng-designer": {
-      const task = String(a.task ?? "").replace(/\s+/g, " ").trim()
-      if (task) return task.slice(0, 60) + (task.length > 60 ? "…" : "")
-      // action-only 调用（status/observe/send/cancel/escalate/consume-design…）无 task——action 兜底（2.4 批）
-      return a.action ? `(${String(a.action)})` : ""
-    }
-    case "advisor": return String(a.type ?? "review")
-    case "read_image": return String(a.path ?? "")
-    case "question": return String(a.question ?? "").replace(/\s+/g, " ").trim().slice(0, 60)
-    case "memory": {
-      // §6 action-routed summary (D-M5): one readable line per action
-      const action = String(a.action ?? "")
-      if (action === "put") return String(a.title ?? "")
-      if (action === "search") return String(a.query ?? "")
-      if (action === "list") return [a.layer && `layer ${a.layer}`, a.type && `type ${a.type}`, a.keyword && `kw ${a.keyword}`].filter(Boolean).join(" ")
-      if (action === "delete") return a.id ? `id ${a.id}${a.layer ? ` (layer ${a.layer})` : ""}` : `batch ${a.layer ?? ""} ${a.type ? `type ${a.type} ` : ""}${a.keyword ? `kw ${a.keyword}` : ""}`.trim()
-      if (action === "clear") return `clear ${a.layer ?? ""}`
-      return action || JSON.stringify(a)
-    }
-    case "lsp": return [a.subcommand, a.uri].filter(Boolean).map(String).join(" ")
-    case "repo_outline": return a.path ? String(a.path) : ""
-    case "checkpoint": return [a.checkpointAction ?? a.action, a.checkpointId, a.path].filter(Boolean).map(String).join(" ")
-    case "git": return [a.action, a.ref, a.name, a.message].filter(Boolean).map(String).join(" ").slice(0, 60)
-    default: {
-      // MCP 工具 / 未知工具：单行紧凑 JSON（vscode 卡片头同样给原始 JSON 截断）。
-      // 硬上限 160：超大 arguments（如 execute 的千字符 code）绝不进单行头。
-      const s = JSON.stringify(a)
-      return s.length > 160 ? sliceByWidth(s, 156) + "…" : s.length > 80 ? sliceByWidth(s, 78) + "…" : s
-    }
-  }
-}
+export { describeToolArgs } from "@thincoder/core/tool-args.mjs"
 
 /** 恢复路径用：全量参数 pretty JSON 的 dim 行（非空才输出）。
- *  与工具结果的恢复惯例一致——完整落行；**总量额度**（TUI-OOM-ROOTCAUSE §15.3.1
+ *  与工具结果的恢复惯例一致——完整落行；**总量额度**（TUI-OOM-ROOTCAUSE·TUI-SESSION-VIEW.md §5.1
  *  ARGS_JSON_MAX_CHARS——`write`/`apply_patch` 整文件内容进显示层的堵口）：超出尾截断
  *  + 标记，首行保真。 */
 export function toolArgsLines(args) {

package/src/tui/tool-display.mjs

@@ -7,7 +7,7 @@
  * 不禁内容变更（.set/.delete/.push），调用方行为与同模块时代一致。
  */
 
-// TUI-OOM-ROOTCAUSE（TUI.md §15.3.1）：显示层额度常量/工具行定位（display-budget 叶子）。
+// TUI-OOM-ROOTCAUSE（TUI-SESSION-VIEW.md §5.1）：显示层额度常量/工具行定位（display-budget 叶子）。
 import { capLines, TOOL_RESULT_MAX_CHARS } from "./display-budget.mjs"
 
 // Tool execution start timestamps (performance.now ms). Keyed by tool_call id
@@ -26,7 +26,7 @@ export const REMINDER_CAP = 3               // max pending reminders shown on tu
 export const REMINDER_PERSIST_TURNS = 5     // persist reminders every N turns
 
 export const _toolTicks = new Map()
-// §19 action registry: tool_call id → subagent action (non-spawn only — spawn is
+// AGENT-LOOP-SUBAGENT.md §6.7 action registry: tool_call id → subagent action (non-spawn only — spawn is
 // the default when no record exists). onToolCall sees the args, onToolResult only
 // the name; without the record every subagent result would route as a spawn.
 export const _subActions = new Map()
@@ -77,7 +77,7 @@ export function sweepToolBlocks(state) {
  *     the human needs only the text part (model gets images via the multimodal
  *     channel); 2) results beyond maxRows are truncated in the block (full
  *     text always lives in history for the model). Returns row array.
- *  TUI-OOM-ROOTCAUSE（§15.3.1 TOOL_RESULT_MAX_CHARS）：总量额度与 400 行双维
+ *  TUI-OOM-ROOTCAUSE（§5.1 TOOL_RESULT_MAX_CHARS）：总量额度与 400 行双维
  *  （单行任意大——无 `\n` 巨 chunk/JSON 尾行），尾截断 + 标记。 */
 export function slimToolResultForDisplay(result, maxRows = 400) {
   let displayResult = result
@@ -112,10 +112,10 @@ export function settleToolBlock(state, name, toolId, summary) {
   }
 }
 
-/** Async spawn detection (§15 D-A1): the subagent tool's async:true result is a
+/** Async spawn detection (AGENT-LOOP-SUBAGENT.md §6.7.3 D-A1): the subagent tool's async:true result is a
  *  status JSON ({id, role, status: running|queued}), NOT a report — the child
- *  keeps running, so its activity block must not be frozen at spawn time (it
- *  freezes via the ⟦ev⟧done event at settle — §15 D-A3). */
+ *  keeps running, so its activity block must not be frozen at spawn time（块保 live——settle 发
+ *  ⟦ev⟧settled；冻结落消费窗——#746 · ASYNC-POOL §6.8）。 */
 export function isAsyncSpawnResult(result) {
   try {
     const o = JSON.parse(result)
@@ -125,7 +125,7 @@ export function isAsyncSpawnResult(result) {
   }
 }
 
-/** §7.2.3 spawn 门拒错误探测（T-F5）：subagent spawn 的机械拒绝以 {status:"error"}
+/** docs/cli/design/TUI.md §6.8 spawn 门拒错误探测（T-F5）：subagent spawn 的机械拒绝以 {status:"error"}
  *  JSON 返回（例：manual auto-turn digest spawn 门——digest 语义 organize-only）——
  *  错误路径不得触发完成冻结（round1 #1——错误路径不冻结任何 running 块）。该形态只
  *  出现在无 subKey 的拒绝路径（成功路径恒带 dispatch 传的 ctx._subagentKey）。 */

package/src/tui/tool-events.mjs

@@ -3,7 +3,7 @@
  * 满足 500 行硬限）。只做「事件 → TUI 状态/对话行」的映射：
  *
  *  - onToken/onReasoning  : 子agent 前缀分流（routeSub*）→ 主流 streaming/reasoning
- *  - onToolCall           : 状态栏 + `❯ name args` 标题行 + 计时 + §19 action 记录
+ *  - onToolCall           : 状态栏 + `❯ name args` 标题行 + 计时 + AGENT-LOOP-SUBAGENT.md §6.7 action 记录
  *  - onToolResult         : 子agent 完成冻结（finishSubTaskKey 精确冻 + freezeDoneSubTasks——
  *                           F-2 后 finishSubTask 为 no-op 兼容保留）、
  *                           工具块结果入块、advisor 评审冻结框
@@ -11,8 +11,8 @@
  *  - 其余                 : usage 累计、等待提示、task 面板、回合末增量落盘
  *
  * flushStream 同时返回给调用方（回合循环 / onTurnEnd 共用）。纯回调装配，无终端副作用
- * （除经 deps 注入的 pushLine/render）。§19: subagent_check/escalate 工具退役后
- * （§19.8——check 动作已删），subagent 家族全部调用以工具名 "subagent" +
+ * （除经 deps 注入的 pushLine/render）。AGENT-LOOP-SUBAGENT.md §6.7: subagent_check/escalate 工具退役后
+ * （AGENT-LOOP-SUBAGENT.md §6.7.5——check 动作已删），subagent 家族全部调用以工具名 "subagent" +
  * action 到达——完成路由按 onToolCall 时记录的 action 分流（spawn 区块 / escalate
  * 区块 / status/observe/send 普通工具块——observe/send 不建子代理区块）。
  */
@@ -22,11 +22,11 @@ import { describeToolArgs, toolArgsLines } from "./tool-args.mjs"
 import { ADVISOR_THINKING_PLACEHOLDER, resolveAdvisorProvider } from "@thincoder/core/advisor/run.mjs"
 import {
   SUBAGENT_ROLES, routeSubToken, routeSubReasoning, routeSubToolCall,
-  routeSubToolOutput, finishSubTask, finishSubTaskKey, finishSubTasksByRole, freezeDoneSubTasks,
+  routeSubToolOutput, finishSubTask, finishSubTaskKey, freezeDoneSubTasks,
   ensureCompressPanel, markCompressFailed, markCompressDone, markCompressFallback,
   shiftFreezeAnchors,
 } from "./subagent-blocks.mjs"
-// 第 27 批 §12.3②：前缀正则换名 + import 源改文法模块（纯换名——语义零改）。
+// 第 27 批：前缀正则换名 + import 源改文法模块（纯换名——语义零改）。
 import { RELAY_PREFIX_RE } from "@thincoder/core/agent/relay-prefix.mjs"
 import { TURN_CAP_MARK, STOPPED_MARK } from "@thincoder/core/agent/spawn-child.mjs"
 // 批 1 CORE-DEFECT-FIXES B3：onWait 相位值域 + 文案单源（消费面禁各自枚举——PROVIDER.md §6.20）
@@ -40,14 +40,14 @@ import {
   findToolBlock, findToolLine, slimToolResultForDisplay, sweepToolBlocks,
 } from "./tool-display.mjs"
 export { sweepToolBlocks, slimToolResultForDisplay } from "./tool-display.mjs"
-// TUI-OOM-ROOTCAUSE（TUI.md §15.3.1/§15.3.3）：显示层额度（行/载体/输出环/评审/流式）。
+// TUI-OOM-ROOTCAUSE（TUI-SESSION-VIEW.md §5.1/§5.3）：显示层额度（行/载体/输出环/评审/流式）。
 import {
   capText, capLine, capLines, appendCapped, capAdvisorText, accountLine, syncLineBudget,
   LINE_TRUNC_MARKER, MIDDLE_TRUNC_MARKER, ADVISOR_CAP_OPTS, STREAM_CAP_OPTS,
   TOOL_OUTPUT_ENTRY_MAX_CHARS, TOOL_OUTPUT_TOTAL_MAX_CHARS, ADVISOR_TEXT_MAX_CHARS,
 } from "./display-budget.mjs"
 
-/** 输出环字符维总量（§15.3.1 TOOL_OUTPUT_TOTAL_MAX_CHARS——与 200 条目环同款丢最旧）。 */
+/** 输出环字符维总量（§5.1 TOOL_OUTPUT_TOTAL_MAX_CHARS——与 200 条目环同款丢最旧）。 */
 function trimOutputChars(block) {
   let total = 0
   for (const s of block.output) total += s.length
@@ -60,9 +60,9 @@ function trimOutputChars(block) {
  *          askPermission, askQuestion, saveSessionImpl } */
 export function buildToolCallbacks(deps) {
   const { agent, state, pushLine, render, scheduleRender, ensureAssistantLabel, askPermission, askBatchPermission, askQuestion, saveSessionImpl } = deps
-  // 行集总量对账便捷式（§15.3.3——冻结锚点平移交 subagent 族函数）
+  // 行集总量对账便捷式（§5.3——冻结锚点平移交 subagent 族函数）
   const budgetSync = () => syncLineBudget(state, { onTrim: (st, n) => shiftFreezeAnchors(st, n) })
-  /** Advisor 有序块累积 + 额度（§15.3.1 ADVISOR_TEXT_MAX_CHARS——头 32K/尾 96K/中段标记）。 */
+  /** Advisor 有序块累积 + 额度（§5.1 ADVISOR_TEXT_MAX_CHARS——头 32K/尾 96K/中段标记）。 */
   const pushAdvisorChunk = (raw, kind) => {
     const blocks = state._advisorBlocks ??= []
     const last = blocks.at(-1)
@@ -100,7 +100,8 @@ export function buildToolCallbacks(deps) {
       // block content, never the main stream (D1). Routing details in subagent-blocks.
       if (routeSubToken(state, t, scheduleRender)) return
       ensureAssistantLabel()
-      state.streaming = appendCapped(state.streaming, t, STREAM_CAP_OPTS) // §15.3.1 STREAM_MAX_CHARS
+      state.streaming = appendCapped(state.streaming, t, STREAM_CAP_OPTS) // §5.1 STREAM_MAX_CHARS
+      state.lastOutputAt = Date.now() // 停滞轻显形（TUI.md §7.7）：①流式——主文本增量
       scheduleRender()
     },
     onReasoning: (t) => {
@@ -108,14 +109,15 @@ export function buildToolCallbacks(deps) {
       // buffer as kind=think (F2: same treatment as the main reasoning stream).
       if (routeSubReasoning(state, t, scheduleRender)) return
       ensureAssistantLabel()
-      state.reasoning = appendCapped(state.reasoning, t, STREAM_CAP_OPTS) // §15.3.1 STREAM_MAX_CHARS
+      state.reasoning = appendCapped(state.reasoning, t, STREAM_CAP_OPTS) // §5.1 STREAM_MAX_CHARS
+      state.lastOutputAt = Date.now() // 停滞轻显形（TUI.md §7.7）：①流式——推理增量
       scheduleRender()
     },
     onToolCall: (name, args, toolId) => {
       // Subagent tool call: prefix role#id/toolName → open a fresh tool block and
       // set currentTool for the header summary line.
       if (routeSubToolCall(state, name, args, scheduleRender)) return
-      // §19: record the action of a merged subagent-family call (spawn is the
+      // AGENT-LOOP-SUBAGENT.md §6.7: record the action of a merged subagent-family call (spawn is the
       // default — only non-spawn actions need a record for result-time routing).
       if (name === "subagent" && args?.action && args.action !== "spawn") {
         if (toolId !== undefined && toolId !== null) _subActions.set(toolId, args.action)
@@ -127,6 +129,7 @@ export function buildToolCallbacks(deps) {
       flushStream()
       ensureAssistantLabel()
       state.currentTool = name
+      state.lastOutputAt = Date.now() // 停滞轻显形（TUI.md §7.7）：②工具面——调用（标题行 ∕ 状态栏）
       // Advisor's effective model (resolved once for the status line + inline title below).
       const advModel = name === "advisor" ? (() => { try { return resolveAdvisorProvider(agent).model } catch { return null } })() : null
       // Update status bar with current tool and key arguments for user visibility
@@ -170,16 +173,17 @@ export function buildToolCallbacks(deps) {
           done: false,
         },
       })
-      accountLine(state, state.lines[state.lines.length - 1]) // 载体入总量账（§15.3.4）
+      accountLine(state, state.lines[state.lines.length - 1]) // 载体入总量账（§5.4）
       budgetSync()
       tickStart(name, toolId)
     },
-    // §7.2.3（方案 e）：dispatch runOne 把工具 ctx 上的 _subagentKey（sync spawn/
+    // docs/cli/design/TUI.md §6.8（方案 e）：dispatch runOne 把工具 ctx 上的 _subagentKey（sync spawn/
     // escalate 成功路径设置——relayPrefix 去尾）作为第 4 参传来——undefined 兼容既有
     // 签名（普通工具/老回调/错误路径不带 key）。
     onToolResult: (name, result, toolId, subKey) => {
       state.currentTool = null
-      // §19 merged family: route per the action recorded at onToolCall (no record = default spawn).
+      state.lastOutputAt = Date.now() // 停滞轻显形（TUI.md §7.7）：②工具面——结果（含子代理 ∕ escalate ∕ advisor 面同刻）
+      // AGENT-LOOP-SUBAGENT.md §6.7 merged family: route per the action recorded at onToolCall (no record = default spawn).
       let subAction = null
       if (name === "subagent") {
         subAction = (toolId !== undefined && toolId !== null)
@@ -192,18 +196,18 @@ export function buildToolCallbacks(deps) {
       // Subagent complete: mark the earliest running child as done — the block
       // persists (✓ frozen elapsed header, expandable) as the ONLY carrier of the
       // child's activity; memory bounded by the N2 line cap.
-      // §19.5: cancel 动作排除在 isSubagent 外——ack/错误 JSON 走普通工具块；区块冻结由
+      // AGENT-LOOP-SUBAGENT.md §6.7.2: cancel 动作排除在 isSubagent 外——ack/错误 JSON 走普通工具块；区块冻结由
       // ⟦ev⟧stopped settle 事件承担（此处 finishSubTask 会误冻最早 running 区块）。
       if (isSubagent) {
         // The dispatch-level tool-block carrier for this call would otherwise
         // never be marked done (its result lands in the subagent block, not the
         // carrier) and the turn sweep would mislabel it "(interrupted)".
         settleToolBlock(state, name, toolId, "completed")
-        // Async spawn (§15 D-A1): the result is a status JSON, not a report — the
+        // Async spawn (AGENT-LOOP-SUBAGENT.md §6.7.3 D-A1): the result is a status JSON, not a report — the
         // child KEEPS running; skip the freeze (it would tombstone a live block and
-        // drop its relay stream). The block freezes on the ⟦ev⟧done settle event.
+        // drop its relay stream). 块保 live——settle 发 ⟦ev⟧settled；冻结落消费窗（#746 · ASYNC-POOL §6.8）。
         if (!isAsyncSpawnResult(result)) {
-          // §7.2.3 sync spawn 完成精确冻结：结果按 key 归属三支——
+          // §6.8 sync spawn 完成精确冻结：结果按 key 归属三支——
           // ① dispatch 同步成功路径带 subKey（ctx._subagentKey = relayPrefix 去尾）：
           //    finishSubTaskKey 按 key 精确冻——不再落 finishSubTask 的"最早 started"
           //    启发式（async eng-coder 先启动时 explore 完成会误冻其块——7.2.3.1/T-F2）；
@@ -232,12 +236,12 @@ export function buildToolCallbacks(deps) {
         // 飞刀 post-op report landed under the subagent tool name — freeze the
         // escalate#N activity block (no preview; legacy surface).
         settleToolBlock(state, name, toolId, "completed")
-        // §25 D-R17b (R17): async escalate ack ({id, role:"escalate", status:
+        // ESCALATE.md §5 D-R17b (R17): async escalate ack ({id, role:"escalate", status:
         // running|queued}) — the child KEEPS running — skip the freeze like the
-        // async spawn path (the block freezes on the ⟦ev⟧done/stopped settle
-        // event at flight end). Sync results (async:false) freeze below.
+        // async spawn path (settle ⇒ ⟦ev⟧settled 驻留；冻结落消费窗——#746 · ASYNC-POOL §6.8；
+        // cancel 径 ⟦ev⟧stopped 即冻——照旧). Sync results (async:false) freeze below.
         if (!isAsyncSpawnResult(result)) {
-          // §7.2.3（round1 #2）：escalate 成功返回带 subKey（escalate#N）→ 精确冻；
+          // §6.8（round1 #2）：escalate 成功返回带 subKey（escalate#N）→ 精确冻；
           // 失败/老回调无 subKey → 不冻结任何块（F-2 收窄——finishSubTask 恒 no-op，
           // 块由回合尾 freezeAllSubTasks 兜底清场）。
           // SYNC-CANCEL（R6）：同上——escalate 路径同款扩展（sync escalate 无 registry——
@@ -251,12 +255,12 @@ export function buildToolCallbacks(deps) {
           freezeDoneSubTasks(state)
         }
       } else if (name === "consult_stop") {
-        // R17（§25 D-R17a——check 已删）：consult_stop = 取消指定会诊会话。被 abort 的
-        // children 各自 settle（settleChild）时发 ⟦ev⟧done 冻结自己的卡——此处**不做按
-        // 角色整组清扫**（会诊会话可并发——按角色会误冻其他仍在运行的会话的卡，冻结即
-        // 截断其活动流——tool-events advisor 复评 🟡1 修正）；取消的即时可见性由 abort
-        // settle 事件承担（abort 解绕通常在同回合内完成——卡片在其 child settle 即冻结）。
-        // 仅结果本身落本工具调用自己的载体块（下方通用分支）。
+        // R17（CONSULTATION.md §6.2 D-R17a——check 已删）：consult_stop = 取消指定会诊会话。被取消会话的
+        // children 各自 settle（settleChild）时发 ⟦ev⟧stopped 即折自己的卡（cancel 径——消费永不来）；
+        // 未取消边 settled 的子块驻留待消化（消费窗三端收口——#748）——此处**不做按角色整组
+        // 清扫**（会诊会话可并发——按角色会误冻其他仍在运行的会话的卡，冻结即截断其活动流——
+        // tool-events advisor 复评 🟡1 修正）；取消的即时可见性由 abort settle 事件承担（abort
+        // 解绕通常在同回合内完成——卡片在其 child settle 即折）。仅结果本身落本工具调用自己的载体块（下方通用分支）。
       }
       if (!isSubagent && !isEscalate && name !== "advisor") {
         // Result lands INSIDE the block (restore parity — the restored carrier
@@ -269,7 +273,7 @@ export function buildToolCallbacks(deps) {
           // screen of garbage (user report 2026-08-30). The model gets the image
           // via the multimodal channel (agent.mjs), the human needs only the
           // text part: strip image parts from the displayed result.
-          block.result = slimToolResultForDisplay(result) // §15.3.1 RESULT 额度（行 400 + 字符 64K 双维）
+          block.result = slimToolResultForDisplay(result) // §5.1 RESULT 额度（行 400 + 字符 64K 双维）
           block.summary = formatToolSummary(name, result)
           block.done = true
           const started = tickTake(name, toolId)
@@ -290,7 +294,7 @@ export function buildToolCallbacks(deps) {
         // _advisorBlocks keep rendering the running view until cleared at turn end.
         const blocks = state._advisorBlocks ?? []
         if (blocks.length > 0) {
-          // 冻结文本额度（§15.3.1：头 32K + 尾 96K 保裁决尾部 + 中段标记——非静默截断，
+          // 冻结文本额度（§5.1：头 32K + 尾 96K 保裁决尾部 + 中段标记——非静默截断，
           // 代码评审 #3：capLines(...)[0] 会丢标记且截尾）
           const text = capAdvisorText(blocks
             .map((b) => b.text.replaceAll(ADVISOR_THINKING_PLACEHOLDER, ""))
@@ -326,6 +330,7 @@ export function buildToolCallbacks(deps) {
       }
       if (!part.text) return
       if (routeSubToolOutput(state, name, part, scheduleRender)) return
+      state.lastOutputAt = Date.now() // 停滞轻显形（TUI.md §7.7）：②工具面——输出流（含 advisor 输出）
       if (name === "advisor") {
         // Accumulate to buffer — formatTables + wrapText in render-conversation
         // handles markdown formatting, same as main agent response.
@@ -338,14 +343,14 @@ export function buildToolCallbacks(deps) {
         const isString = typeof chunk === "string"
         const raw = isString ? chunk : String(chunk?.text ?? "")
         const kind = isString ? "text" : (chunk?.kind ?? "text")
-        pushAdvisorChunk(raw, kind) // §15.3.1 累积额度（多块丢最旧）
+        pushAdvisorChunk(raw, kind) // §5.1 累积额度（多块丢最旧）
         scheduleRender()
         return
       }
       // Append into the CURRENT tool block's output buffer (the block is the
       // display; no _live scroll lines anymore). N2-style cap keeps memory
       // bounded: keep the LAST 200 output lines per call; 字符维双维
-      // （§15.3.1：单条目 ≤ TOOL_OUTPUT_ENTRY_MAX_CHARS、总量 ≤ TOOL_OUTPUT_TOTAL_MAX_CHARS 丢最旧）。
+      // （§5.1：单条目 ≤ TOOL_OUTPUT_ENTRY_MAX_CHARS、总量 ≤ TOOL_OUTPUT_TOTAL_MAX_CHARS 丢最旧）。
       const block = findToolBlock(state, name, toolId)
       if (block) {
         for (const line of part.text.split("\n")) {
@@ -362,10 +367,10 @@ export function buildToolCallbacks(deps) {
       scheduleRender()
     },
     // Manual-tier auto-turn digests (agent-turn.mjs suspension driver) pass null
-    // handlers — permission requests then deny WITHOUT a panel (§17 D-S7: no modal
+    // handlers — permission requests then deny WITHOUT a panel (AGENT-LOOP-ASYNC-POOL.md §6.8 D-S7: no modal
     // during unattended digestion) and question errors out instead of hanging.
     ...(askPermission ? { onPermissionRequest: (name, args) => askPermission(name, args) } : {}),
-    // Merged batch ask (§16 D-B1): one confirmation for N non-readonly tools in
+    // Merged batch ask (D-B1): one confirmation for N non-readonly tools in
     // the same response — "approve all / one by one / deny" (key-handler resolves
     // the verdict string; approveAll is batch-scope only, never the AUTO flag).
     ...(askBatchPermission ? { onBatchPermissionRequest: (req) => askBatchPermission(req) } : {}),

package/src/tui/tui-lifecycle.mjs

@@ -43,7 +43,7 @@ export function writeCleanupSequence(write = (s) => process.stdout.write(s)) {
 // T-R25a.2 注入 mock 走同一 setter）。
 let tuiActive = false
 
-/** 置/清 TUI 活动态（TUI 启动接管处与退出清理处调用；测试 env 门注入同走此 setter）。 */
+/** 置/清 TUI 活动态（TUI 启动接管处与退出清理处调用；测试钩（argv 门）注入同走此 setter）。 */
 export function setTuiActive(active) {
   tuiActive = active === true
 }
@@ -53,13 +53,22 @@ export function isTuiActive() {
   return tuiActive
 }
 
+// R25 崩溃恢复测试缝（T-R25a.2——argv 门注入）：bin 入口解析 `--test-cleanup-out=<路径>` 后经
+// setter 注入（启动时一次性读点——单半例外，复位面无消费者）；生产零调用 → null（恒 stdout）。
+let _cleanupOut = null
+
+/** 测试缝 setter（仅测试注入——生产零调用）。 */
+export function _setCleanupOutPathForTest(path) {
+  _cleanupOut = typeof path === "string" && path.length > 0 ? path : null
+}
+
 /** R25 崩溃恢复：仅 TUI 活动态执行 writeCleanupSequence（复用本模块清理序列——符号锚）。
- *  测试缝（T-R25a.2——env 门注入）：THINCODER_TEST_CLEANUP_OUT 指向文件时序列写入该文件
- *  （观察恢复被调 + stdout 管道零 ANSI）——生产不设该 env → 恒 stdout（零变化）。
+ *  测试缝（T-R25a.2——argv 门注入）：`_setCleanupOutPathForTest` 指到文件时序列写入该文件
+ *  （观察恢复被调 + stdout 管道零 ANSI）——生产不指 → 恒 stdout（零变化）。
  *  @returns {boolean} 是否执行了恢复（false = TUI 未启动——调用方无需处理） */
 export function restoreTerminalAfterCrash() {
   if (!tuiActive) return false
-  const seamOut = process.env.THINCODER_TEST_CLEANUP_OUT
+  const seamOut = _cleanupOut
   if (seamOut) {
     writeCleanupSequence((s) => appendFileSync(seamOut, s, "utf8"))
   } else {

package/src/tui/tui-state.mjs

@@ -37,9 +37,10 @@ export function createTuiState({ cols, rows, agent }) {
     reasoning: "", // thinking stream buffer (dimmed display)
     completion: null, // Tab completion state { candidates, index }
 
-    subTasks: {}, // sub-agent activity blocks (§7.2 D4): { "coder#1": { key, role, model, started, done, doneAt, blocks: [{kind,text}], currentTool, toolArgs, turn, maxTurns, approval, lastError, dropped, blockEpoch, awaitingDigest（§17 挂起中间态）, _freezeAt（冻结锚点）, stopped, children: []（SUBAGENT-TAIL：嵌套子代理**守护载体**——内容行并入本块 blocks——subagent-children.mjs） } } — rendered as collapsible in-conversation blocks; persists across turns (blocks are the child activity's ONLY carrier — child tool calls never enter the parent history); bounded by the N2 500-line per-child ring buffer（SUBAGENT-TAIL 单环：内层行同环计数、单载体最旧先行——TUI.md §6）
+    subTasks: {}, // sub-agent activity blocks (docs/cli/design/TUI.md §6.8 D4): { "coder#1": { key, role, model, started, done, doneAt, blocks: [{kind,text}], currentTool, toolArgs, turn, maxTurns, approval, lastError, dropped, blockEpoch, awaitingDigest（AGENT-LOOP-ASYNC-POOL.md §6.8 挂起中间态）, _freezeAt（冻结锚点）, stopped, children: []（SUBAGENT-TAIL：嵌套子代理**守护载体**——内容行并入本块 blocks——subagent-children.mjs） } } — rendered as collapsible in-conversation blocks; persists across turns (blocks are the child activity's ONLY carrier — child tool calls never enter the parent history); bounded by the N2 500-line per-child ring buffer（SUBAGENT-TAIL 单环：内层行同环计数、单载体最旧先行——TUI.md §6）
     currentTool: null, // currently executing tool name (shown in status bar)
     processingStarted: 0, // current turn start time (status bar timer)
+    lastOutputAt: 0, // 停滞轻显形（TUI.md §7.7 · stall-indicator 批）：最近一次可见输出时刻（静默起算——回合起刻为初始锚；0 = 未起算）
     status: "Ready",
     ledger: { marker: null, warn: false, scannedAt: 0 }, // LEDGER-SURFACE（§2.30.3.4）：L1 标记位——ledger-surface 写 / render-frame 读
     queue: [], // 交接残项单容器 [{ text }]（INPUT-LOCK：submit 不再排队——仅释放窗口兜底/挂起中止残余——回合尾队列循环续发，至多一条）
@@ -54,7 +55,7 @@ export function createTuiState({ cols, rows, agent }) {
     _historyLoaded: 0, // messages loaded from the TAIL of _fullHistory
     _historyTotal: 0, // total messages in the restored session
     _hasOlder: false, // more earlier messages remain unloaded
-    _linesChars: 0, // TUI-OOM-ROOTCAUSE（§15.3.2）：state.lines 全部行与载体文本总量（字符账——唯一新增状态位）
+    _linesChars: 0, // TUI-OOM-ROOTCAUSE（TUI-SESSION-VIEW.md §5.2）：state.lines 全部行与载体文本总量（字符账——唯一新增状态位）
     _agent: null, // TUI state → agent 回指挂载点：startTUI 装配时置 agent 引用——
     // ① SYNC-CANCEL ⏹ 门控读 state._agent._syncChildAborts（subagent-panel.mjs，2026-09-09）；
     // ② CLI-ACTIVITY-DEBLOAT F-3（2026-09-10）：agent._tuiState = state 反向挂载——

package/src/tui/turn-face.mjs

@@ -15,8 +15,8 @@ export function createTurnFace(ctx) {
   async function submit() {
     const text = state.input.join("").trim()
     if (!text) return
-    // INPUT-LOCK 防御（C'——2026-09-09 + F16 busy 单槽——2026-09-21）：门禁在 key-handler
-    // （busy Enter 非模态 = 单槽注入 / 模态·斜杠·空·槽满 = 吞 + 提示，文本保留——TUI-INPUT-BOX.md
+    // INPUT-LOCK 防御（C'——2026-09-09 + F16 busy 队列——2026-09-21 · queue-visible 2026-09-24）：门禁在 key-handler
+    // （busy Enter 非模态 = 队列受理（容量 8）/ 模态·斜杠·空·满队 = 吞 + 提示，文本保留——TUI-INPUT-BOX.md
     // §4.1）；submit 只在非 busy 期达此；防御直呼/上游改动：busy 期拒绝（不清输入框不吞内容）。
     if (state.processing) {
       pushLine(`[主会话处理中 —— 消息未发送（回合结束后请重按 Enter）]`, C.warn)
@@ -55,10 +55,13 @@ export function createTurnFace(ctx) {
   const turnCtx = {
     agent, state, pushLine, pushLabel, render, scheduleRender: render, ensureAssistantLabel,
     askPermission, askQuestion, askBatchPermission, handleSlash: null,
+    // AGENT-LOOP-ASYNC-POOL.md §6.30.5 载体②：空闲 idle deadline 闩（index.mjs 装配后回填——同 handleSlash 惰性回填法）
+    timerWatch: null,
     get assistantLabeled() { return conversation.assistantLabeled },
     set assistantLabeled(v) { conversation.assistantLabeled = v },
   }
-  const turn = (text) => runAgentTurn(turnCtx, text)
+  // opts 透传（timer 空闲唤醒轮 = `{ autoTurn: true, timerTurn: true }`——§6.30.3 开轮两处①）
+  const turn = (text, opts) => runAgentTurn(turnCtx, text, opts)
 
   return { submit, turn, turnCtx, askPermission, askQuestion, askBatchPermission, pasteClipboardImage }
 }

package/src/tui/wizard.mjs

@@ -16,7 +16,7 @@ import { probeChannelModels } from "./model-catalog.mjs"
  * Returns { startWizard, renderWizard, wizardChooseProvider, wizardSubmitText, cancelWizard, finishWizard }
  */
 export function createWizard(ctx) {
-  const { agent, state, pushLine, pushLabel, render, persistRaw } = ctx
+  const { agent, state, pushLine, pushLabel, render, persistRaw, onModalClose = null } = ctx
 
   /** Candidates for the menu step: existing providers (marked "no key" if missing), unadded presets, custom
    *  MODEL-SELECTION v2：渠道默认模型 = 单值 `model`（preset 自带；候选清单运行期拉取） */
@@ -166,6 +166,8 @@ export function createWizard(ctx) {
       : "Skipped initial setup. Use /model to add providers and configure API keys anytime."
     pushLine(hint, C.dim)
     render()
+    // #448①「关闭后补评估」：wizard 面退场（无 picker 同在场）⇒ 通知链尾（闩重武装）
+    if (state.picker == null) ctx.onModalClose?.()
   }
 
   /** Wizard complete: write provider (update if exists) with its single default model (`model`),
@@ -234,7 +236,10 @@ export function createWizard(ctx) {
       pushLine(`Vector search disabled (memory falls back to text-only search). Run /config embedkey <key> to enable.`, C.dim)
     }
     pushLine(`Select model (Esc to keep ${agent.activeModel})`, C.dim)
-    ctx.openModelPicker().catch((e) => pushLine(`[error] ${e.message}`, C.error))
+    // #448①「关闭后补评估」：收尾链落定（模型 picker 关闭 ∕ 零弹面两态）⇒ 通知链尾（闩重武装——幂等）。
+    ctx.openModelPicker()
+      .catch((e) => pushLine(`[error] ${e.message}`, C.error))
+      .then(() => { if (state.picker == null && state.wizard == null) ctx.onModalClose?.() })
   }
 
   return { startWizard, renderWizard, wizardChooseProvider, wizardSubmitText, cancelWizard, finishWizard, wizardProviderItems }

package/src/tui/wrapped-spawn.mjs

@@ -44,10 +44,10 @@ export function spawnTuiWrapped({ dir = crashReportsDir(), script = fileURLToPat
     try { writeImpl(RECOVERY_SEQUENCE) } catch { /* 尽力面：终端已关/管道已断——不阻断收尾 */ }
   }
   // F3③（CRASH-REPORTS）：近堆上限快照落点定向——--diagnostic-dir 为 Node 选项，须在脚本路径前；
-  // 无条件注入（gate 单点在 crash-reports.mjs——包装器不判 env）；未触发快照时零副作用。
-  const child = spawnImpl(process.execPath, [`--diagnostic-dir=${dir}`, script, ...process.argv.slice(2)], {
+  // 无条件注入（判定单点在 bin 入口读配置键 `diagnostics.heapSnapshot` 后经参数传入——包装器不判）；未触发快照时零副作用。
+  const child = spawnImpl(process.execPath, [`--diagnostic-dir=${dir}`, script, "--tui-wrapped", ...process.argv.slice(2)], {
     stdio: ["inherit", "inherit", "pipe"], // 子 stderr pipe → tee；stdin/stdout 继承（TTY 原样）
-    env: { ...process.env, THINCODER_TUI_WRAPPED: "1" }, // env 门——子内判定不包装——纯现逻辑（红线）
+    // argv 门（子内 bin 顶部自剥离 `--tui-wrapped`、判定不包装——纯现逻辑（红线））；env 直传
     windowsHide: false,
   })
   child.stderr.on("data", (chunk) => { try { process.stderr.write(chunk) } catch { /* 终端已关——日志仍落 */ } note(chunk) }) // ② tee 双写：终端实时 + 日志