thincoder 0.12.60 → 0.12.61

package/src/tui/render-frame.mjs

@@ -72,13 +72,6 @@ export function renderPermission(permPreviewLines) {
   return [`${ansi.bold}${C.warn}❯ Permission Request${ansi.reset}`, ...permPreviewLines.map((w) => `${C.warn}${w}${ansi.reset}`)]
 }
 
-/** Queue preview (1 line when queue has items during processing). */
-export function renderQueue(state, W) {
-  if (state.queue.length === 0 || !state.processing) return ""
-  const preview = sliceByWidth(state.queue[0].text, W - 20)
-  return `${C.dim}❯ Queue: ${state.queue.length} pending${state.queue.length > 1 ? ` (next: ${preview}…)` : ` (next: ${preview})`} — Ctrl+D delete │ Ctrl+I inject${ansi.reset}`
-}
-
 /** Picker/wizard overlay panel. Returns empty when no overlay. */
 export function renderPicker(state, cols, panel, overlay) {
   if (!panel || !overlay) return []
@@ -139,8 +132,8 @@ export function renderInputBox(state, W, boxLines, cols, inputLayout, inputOffse
         ? " ↑↓ select │ Enter confirm │ Esc: cancel "
         : " Enter submit │ Esc: cancel │ Ctrl+U clear │ Ctrl+V paste ")
     }
-    if (title === " Inject Message ") parts.push(" Enter send, Esc cancel ")
-    if (title !== " Question ") {
+    if (title === " Inject Message ") parts.push(" Enter send, Esc cancel │ ←→↑↓ Home/End move │ Ctrl+V paste ")
+    if (title === " Input " || title === " Processing... ") {
       parts.push(" Shift+Enter / Ctrl+J newline ")
       parts.push(" Ctrl+V paste ")
       parts.push(" Ctrl+I inject ")
@@ -160,8 +153,8 @@ export function renderInputBox(state, W, boxLines, cols, inputLayout, inputOffse
   const curLine = (!hasOverlay && inputLayout) ? inputLayout.cursorLine - (inputOffset ?? 0) : -1
   const curCol = (!hasOverlay && inputLayout) ? inputLayout.cursorCol : -1
 
-  // Interrupt prompt 空文本占位符：灰色提示用户该做什么
-  const isInterruptEmpty = state.interruptPrompt && !state.interruptPrompt.text
+  // Interrupt prompt 空文本占位符：灰色提示用户该做什么（第 31 批：chars 数组判空——§8）
+  const isInterruptEmpty = state.interruptPrompt && state.interruptPrompt.chars.length === 0
   const interruptPlaceholder = "Type message to inject (Enter send, Esc cancel)"
 
   for (let li = 0; li < boxLines.length; li++) {
@@ -212,6 +205,15 @@ export function renderInputBox(state, W, boxLines, cols, inputLayout, inputOffse
   return out
 }
 
+/** 第 33 批（TUI §14.3(a)——纯函数派生，无副作用）：blocked = 审批/提问卡挂起（实时派生，
+ *  提示消解即消失）；awaiting = 回合结束等待输入（链尾置位——processing / 挂起两态期间不派生）。
+ *  @returns {"blocked"|"awaiting"|null} */
+export function attentionKind(state) {
+  if (state.permission || state.question) return "blocked"
+  if (state.attentionAwaiting && !state.processing && !state.suspended && !state._suspPending) return "awaiting"
+  return null
+}
+
 /** Status bar (always 1 line). */
 export function renderStatus(state, agent, cols, slashCommands) {
   const statusLine = buildStatusLine(state, agent, { cols, slashCommands })
@@ -220,8 +222,20 @@ export function renderStatus(state, agent, cols, slashCommands) {
   const advisorBanner = agent.config?.advisor?.guard === true ? `${C.advisor} ADVISOR${ansi.reset}${ansi.dim}│` : ""
   const engBanner = agent.config?.agent?.engineering ? `${C.advisor} ENG${ansi.reset}${ansi.dim}│` : ""
   const bannerPrefix = (agent.planMode ? " PLAN│ " : "") + (agent.autoApprove ? " AUTO│ " : "") + (agent.config?.advisor?.guard === true ? " ADVISOR│ " : "") + (agent.config?.agent?.engineering ? " ENG│ " : "")
-  const statusMax = cols - 1 - (bannerPrefix ? stringWidth(bannerPrefix) : 0)
-  return `${ansi.dim}${planBanner}${autoBanner}${advisorBanner}${engBanner}${sliceByWidth(statusLine, Math.max(10, statusMax))}${ansi.reset}`
+  // 第 33 批（TUI §14.3(b)/(c)）：attention 态 = chip 行首 + 整行注意力色对包裹（blocked >
+  // awaiting；blocked 内 permission > question——与按键分发优先级同序）；平态零注入。
+  const kind = attentionKind(state)
+  const chip = kind === "blocked" ? (state.permission ? "⚠ 等待你的审批" : "⚠ 等待你的回答")
+    : kind === "awaiting" ? "⚠ 等待你的输入" : ""
+  const attentionPad = chip ? `${chip} │ ` : ""
+  // 宽度预算（N9④）：chip 占位计入——整行仍 ≤ cols − 1（既有口径）。
+  const statusMax = cols - 1 - (bannerPrefix ? stringWidth(bannerPrefix) : 0) - (attentionPad ? stringWidth(attentionPad) : 0)
+  const inner = `${ansi.dim}${planBanner}${autoBanner}${advisorBanner}${engBanner}${sliceByWidth(statusLine, Math.max(10, statusMax))}`
+  // 负向锁（§14.3）：attention 为 null ⇒ 半态路径逐字节等价（不经包裹 / 零字节注入）。
+  if (!chip) return `${inner}${ansi.reset}`
+  // 底色存活（§14.3）：既有内容含内部 ansi.reset（banner / ctx 警示段）——每次内部复位后
+  // 重施加注意力色对，再整体包裹（内容零省略）。
+  return `${C.attention}${(chip + " │ " + inner).replaceAll(ansi.reset, ansi.reset + C.attention)}${ansi.reset}`
 }
 
 // ====================================================================
@@ -266,7 +280,7 @@ export function renderRows(state, agent, opts) {
   if (panels.todo) put(panels.todo.y, renderTodo(visibleTasks, cols))
   if (panels.picker) put(panels.picker.y, renderPicker(state, cols, panels.picker, overlay))
   if (panels.permission) put(panels.permission.y, renderPermission(permPreviewLines))
-  if (panels.queue) put(panels.queue.y, [renderQueue(state, W)])
+  // 排队面板提示已撤（INPUT-LOCK-ASYNC F-7——2026-09-09——busy 提交吞——无排队展示）
   // question 自由文本态：box 内容是 layoutAnswer 行——光标布局/滚动随 box 内容走
   // （questionLayout/questionOffset）；主输入 inputLayout 此时无意义（被 question 行替换）。
   const qFree = Boolean(state.question && state.question.options.length === 0)
@@ -376,6 +390,8 @@ function buildStatusLine(state, agent, { cols, slashCommands }) {
   const ctxTokensHint = state.ctxCache.tokens > 0 ? ` ${fmtK(state.ctxCache.tokens)}` : ""
   const ctxHint = ctxPct > 0
     ? ctxPct >= 80 ? ` │ ${ansi.reset}${C.warn}context ${ctxPct}%${ctxTokensHint}${ansi.reset}${ansi.dim}` : ` │ context ${ctxPct}%${ctxTokensHint}` : ""
-  const queueHint = state.queue.length > 0 ? ` │ queue: ${state.queue.length}` : ""
-  return ` ${statusText}${taskHint}${turnHint}${tokenHint}${ctxHint}${queueHint}${scrollHint} │ Enter: send${state.processing ? " (queue)" : ""} │ /: commands │ wheel/PgUp/PgDn: scroll │ Ctrl+I: inject │ Ctrl+C: exit (×2)`
+  // INPUT-LOCK-ASYNC（C'——F-3）：busy（processing 含 digest）状态栏提示——取代旧
+  // 排队提示（F-7 已删）——“主会话处理中——Enter 提交禁用”
+  const enterHint = state.processing ? `主会话处理中 — Enter 提交禁用（字符可输入，回合结束请重按 Enter）` : "Enter: send"
+  return ` ${statusText}${taskHint}${turnHint}${tokenHint}${ctxHint}${scrollHint} │ ${enterHint} │ /: commands │ wheel/PgUp/PgDn: scroll │ Ctrl+I: inject │ Ctrl+C: exit (×2)`
 }

package/src/tui/render-loop.mjs

@@ -16,6 +16,7 @@
 import { countConvLines, renderRows } from "./render-frame.mjs"
 import { estimateTokens } from "../context.mjs"
 import { ansi, C } from "./ansi.mjs"
+import { isTuiActive } from "./tui-lifecycle.mjs" // F-2 渲染抑制守卫（RESIZE-MOUSE-LEAK-FIX）
 
 const MIN_RENDER_INTERVAL_MS = 16
 
@@ -55,6 +56,7 @@ export function createRenderLoop(state, agent, ctx, pushLine, write = (s) => pro
   }
 
   function doRender() {
+    if (!isTuiActive()) return // F-2 渲染抑制（RESIZE-MOUSE-LEAK-FIX）：cleanup 已清活动态——退出期不再把 TUI 帧重绘到已恢复的主屏
     try {
       // Single source (Windows ConPTY instability, 2026-08-30). CACHE ONLY —
       // no per-frame refresh: during heavy streaming output ConPTY reports a

package/src/tui/render-segments.mjs

@@ -10,7 +10,6 @@ import { formatTables, sanitizeDisplay, sliceByWidth, wrapText } from "./render.
 import {
   foldTailLines, isExpanded, renderBlockTimeline, renderExpandedBlock, renderFoldedHead, renderMathAndMarkdown,
 } from "./fold-block.mjs"
-import { renderSubChildSections, subChildFoldKey } from "./subagent-panel.mjs"
 import { SUBAGENT_ROLES } from "./subagent-blocks.mjs"
 
 const _toolSegCache = new WeakMap()
@@ -71,7 +70,8 @@ export function toolSeg(state, l, i, cols, maxRows) {
 /** 冻结子agent 活动块渲染（§7.2 D4）：state.lines 载体 {_frozenSubTask: sub}（subagent-blocks.mjs
  *  freezeSubTaskLines 推入）。折叠 = 身份头 + tail 3；展开 = 共享组件（60% 屏幕封顶 + 底部可达
  *  折叠控制）。折叠键 `sub-${key}`——与运行中面板区块同键，折叠态跨冻结边界无缝延续。
- *  §27 R23：子块段（renderSubChildSections）随冻结载体渲染（冻结含子块——T-R23d.1）。 */
+ *  SUBAGENT-TAIL：内层内容已并入 sub.blocks（数据层——取代小节；docs/design/TUI.md §6）
+ *  ——本段只渲染单流（无子块段/无子块头）。 */
 function frozenSubTaskLines(state, sub, cols, maxRows) {
   const foldKey = `sub-${sub.key}`
   const elapsed = Math.floor(((sub.doneAt ?? Date.now()) - sub.started) / 1000)
@@ -106,33 +106,19 @@ function frozenSubTaskLines(state, sub, cols, maxRows) {
       out.push({ text: `│ ${sliceByWidth(line, cols - 4)}`, color: C.dim, _skipDimFold: true })
     }
   }
-  // §27 R23：子块段随冻结载体（折叠/展开两态都渲染——子块自身折叠键独立控制）。
-  out.push(...renderSubChildSections(state, sub, cols, maxRows))
   return out
 }
 
-/** 冻结子agent 段入口（2026-08-31 段缓存：冻结后内容不变——签名含 sub.key + blocks 计数 +
- *  子块树签名（R23——children 折叠态/滚动/行数参与——toggle 子块/翻窗必须失效）；注：
- *  foldKey 由位置键升级为 sub.key（loadOlder unshift 后不重绑——sub 自身携带 key）。 */
+/** 冻结子agent 段入口（2026-08-31 段缓存：冻结后内容不变——签名含 sub.key + blocks 计数；
+ *  注：foldKey 由位置键升级为 sub.key（loadOlder unshift 后不重绑——sub 自身携带 key）。
+ *  SUBAGENT-TAIL：子块树签名退役（子块无内容行、无独立折叠键——渲染零读 children）。 */
 export function frozenSubSeg(state, l, i, cols, maxRows) {
   const fKey = `sub-${l._frozenSubTask.key}`
-  // §27 R23：子块树渲染输入签名（key/done/stopped/blocks 数/折叠态/窗口偏移——递归）
   const sub = l._frozenSubTask
-  let childSig = ""
-  const walk = (carrier, path) => {
-    for (const c of carrier.children ?? []) {
-      const innerPath = path ? `${path}/${c.key}` : c.key
-      const fk = subChildFoldKey(sub.key, innerPath)
-      childSig += `${innerPath}:${c.done ? 1 : 0}:${c.stopped ? 1 : 0}:${c.blocks?.length ?? 0}:${state.expandedBlocks?.has(fk) ? 1 : 0}:${state._foldScroll?.get(fk) ?? 0};`
-      walk(c, innerPath)
-    }
-  }
-  walk(sub, "")
   const fSig = [
     cols, maxRows ?? 0, sub.key, sub.blocks?.length ?? 0,
     sub.done ? 1 : 0, state.foldEnabled === false ? 0 : 1,
     state.expandedBlocks?.has(fKey) ? 1 : 0, state._foldScroll?.get(fKey) ?? 0,
-    childSig,
   ].join("|")
   const hit = _frozenSubCache.get(l)
   if (hit && hit.textRef === sub && hit.sig === fSig) return hit.rows

package/src/tui/render.mjs

@@ -161,14 +161,19 @@ export function layoutInput(chars, cursor, width) {
   const PROMPT = "\u25b8 "  // first-line prefix (display width 2)
   const CONT = "  "         // continuation prefix (width 2) — keeps left edge aligned
   const lines = []
+  const starts = []         // lineStarts so far（第 31 批 additive）：每个可视行的行首下标
+  let lineStart = 0         // 当前行的行首下标（chars 索引空间）
   let cursorLine = 0
   let cursorCol = 0
   let cur = ""
   let col = 0
   let firstLine = true
   const avail = () => width - 2 // every line reserves 2 cols for its prefix
-  const flush = () => {
+  // next = 下一行的行首下标（折行 = 当前字符 i；行尾 \n 之后 = i + 1）
+  const flush = (next) => {
     lines.push((firstLine ? PROMPT : CONT) + cur)
+    starts.push(lineStart)
+    lineStart = next
     firstLine = false
     cur = ""
     col = 0
@@ -177,7 +182,7 @@ export function layoutInput(chars, cursor, width) {
     const ch = chars[i]
     if (ch !== undefined && ch !== "\n") {
       const w = charWidth(ch.codePointAt(0))
-      if (col + w > avail()) flush()
+      if (col + w > avail()) flush(i)
       if (i === cursor) {
         cursorLine = lines.length
         cursorCol = 2 + col
@@ -189,12 +194,39 @@ export function layoutInput(chars, cursor, width) {
         cursorLine = lines.length
         cursorCol = 2 + col
       }
-      if (ch === "\n") flush()
+      if (ch === "\n") flush(i + 1)
     }
   }
   const endsWithNewline = chars.length > 0 && chars[chars.length - 1] === "\n"
-  if (cur || lines.length === 0 || endsWithNewline) flush()
-  return { lines, cursorLine, cursorCol }
+  if (cur || lines.length === 0 || endsWithNewline) flush(chars.length)
+  // lineStarts[k] = 第 k 行行首；行 k 区间 = [lineStarts[k], lineStarts[k+1])（含行尾 \n）；
+  // 末项哨兵 = chars.length（上界、不指向行）——竖移定位用（TUI-INPUT-BOX.md §1 不变量 5）。
+  return { lines, cursorLine, cursorCol, lineStarts: [...starts, chars.length] }
+}
+
+/** 竖直移动定位（第 31 批——TUI-INPUT-BOX.md §3 规则 2 / §9.3 #2）：纯函数，
+ *  `(chars, cursor, width, dir) → number | null`（null = 该方向无邻行）。
+ *  目标行显示列 = 当前光标显示列（列保持——`layoutInput` 同源行列；行前缀 2 列等宽故整体
+ *  相减）；目标行更短则钳制到行尾（行尾含 \n → 落在 \n 前）。逐键现算——不记忆列（D-31.2）。
+ *  不读不写任何 state。 */
+export function moveCursorVertical(chars, cursor, width, dir) {
+  const { cursorLine, cursorCol, lineStarts } = layoutInput(chars, cursor, width)
+  const lineCount = lineStarts.length - 1
+  const targetLine = dir === "up" ? cursorLine - 1 : cursorLine + 1
+  if (targetLine < 0 || targetLine >= lineCount) return null
+  const targetCol = Math.max(0, cursorCol - 2) // 2 列行前缀（`▸ ` / 续行空格）——各行等宽
+  const start = lineStarts[targetLine]
+  let end = lineStarts[targetLine + 1]
+  if (end > start && chars[end - 1] === "\n") end -= 1 // 行尾 \n 不占显示列
+  let col = 0
+  let idx = start
+  while (idx < end) {
+    const w = charWidth(chars[idx].codePointAt(0))
+    if (col + w > targetCol) break // 宽字符列中不落点——落在该字符起点
+    col += w
+    idx += 1
+  }
+  return idx
 }
 
 /**

package/src/tui/slash-commands.mjs

@@ -42,7 +42,7 @@ export const SLASH_COMMANDS = [
   { name: "/eng", group: "Agent", desc: "toggle engineering mode — strict methodology enforcement" },
   { name: "/advisor", group: "Agent", desc: "advisor settings (model, thinking, review gate)" },
   { name: "/model", group: "Agent", desc: "select model & manage providers" },
-  { name: "/submodel", group: "Agent", desc: "subagent model per type (explore/plan/coder/eng-coder)" },
+  { name: "/submodel", group: "Agent", desc: "subagent model per type (explore/plan/coder/eng-coder/eng-designer)" },
   { name: "/shell", group: "System", desc: "bash tool shell (git-bash/pwsh path; win11 cmd encoding fix)" },
   { name: "/goal", group: "Agent", desc: "set/view/cancel long-term goal" },
   { name: "/think", group: "Agent", desc: "thinking mode & reasoning effort" },
@@ -144,7 +144,7 @@ export function createSlashCommands(ctx) {
     const match = (cands) => cands.filter((c) => c.startsWith(last)).map((c) => `${head} ${c}`)
     if (cmd === "/model" && argIndex === 0) return match(agent.providers.map((p) => p.name))
     if (cmd === "/submodel") {
-      if (argIndex === 0) return match(["explore", "plan", "coder", "eng-coder", "reset"])
+      if (argIndex === 0) return match(["explore", "plan", "coder", "eng-coder", "eng-designer", "reset"])
       if (parts[1] && !["reset"].includes(parts[1]) && argIndex === 1) return match(agent.providers.map((p) => p.name))
     }
     if (cmd === "/think") {

package/src/tui/subagent-blocks.mjs

@@ -4,27 +4,34 @@
  * undefined = sync）, started, done, doneAt, blocks:
  * [{kind,text}], currentTool, toolArgs, turn, maxTurns, approval, lastError,
  * dropped, blockEpoch, awaitingDigest（§17）, _freezeAt（冻结锚点）, stopped（§19.5）,
- * children: []（R23——嵌套子代理子块载体——见 subagent-children.mjs）}。
- * 职责：前缀路由（parseRelayPath——**R23：嵌套段不再子标渲染——建子块载体归属**）、
- * 事件 token 解析（**R23：内层 ⟦ev⟧done/stopped 生成侧补发射（D-R23c1）路由到子块
- * 定格；§27.1 F2：done 后完全定格——迟到 chunk 丢弃**）、kind 合并、N2 树级环形上限（R23 NFR——子块计入外层配额）、N1 渲染节流、
- * 完成冻结（freezeSubTaskLines 家族——锚点 splice）。
+ * children: []（SUBAGENT-TAIL：嵌套子代理**守护载体**——内容并入本块 blocks——见
+ * subagent-children.mjs）}。
+ * 职责：前缀路由（parseRelayPath——**SUBAGENT-TAIL（D-ST1）：嵌套段内容行并入外层
+ * blocks——append 目标上移，子块载体只余守护元数据**）、
+ * 事件 token 解析（**内层 ⟦ev⟧done/stopped 生成侧补发射（D-R23c1）路由到子块
+ * 定格；F2：done 后完全定格——迟到 chunk 丢弃**）、kind 合并、N2 单环 500 显示行上限
+ * （SUBAGENT-TAIL D-ST4——内层行同环计数、单载体最旧先行）、N1 渲染节流、
+ * 完成冻结（freezeSubTaskLines 家族——锚点 splice）。显示契约 = docs/design/TUI.md §6。
  */
 
 import { C } from "./ansi.mjs"
+// 第 27 批 §12.3①/②：relay 前缀文法单一权威 = src/agent/relay-prefix.mjs——本文件
+// 不再自持前缀正则/解析副本（防第二套平行正则再漂移）。
+import { parseRelayPath } from "../agent/relay-prefix.mjs"
 import { describeToolArgs } from "./tool-args.mjs"
 import {
-  SUB_BLOCK_LINE_LIMIT, appendSubBlock, appendSubChild, ensureSubChild, descendSubChild,
+  appendSubBlock, descendSubChild,
   closeSubChild,
 } from "./subagent-children.mjs"
 export { SUB_BLOCK_LINE_LIMIT, appendSubBlock } from "./subagent-children.mjs"
-// 2026-09-05 module-split：finish/freeze 族 + §19.6 面板镜像迁 subagent-freeze.mjs——
+// 2026-09-05 module-split：finish/freeze 族 + §19.6 面板现算迁 subagent-freeze.mjs——
 // routeSub*/compression panel 内部用本地 import；re-export 保外部 import 面（index.mjs 等）
-import { freezeSubTaskLines, syncPanelSnapshot, finishSubTaskKey, finishSubTask, freezeDoneSubTasks, finishSubTasksByRole, freezeAllSubTasks, freezeReclaimDigestedBlocks, shiftFreezeAnchors } from "./subagent-freeze.mjs"
-export { syncPanelSnapshot, finishSubTask, finishSubTaskKey, freezeSubTaskLines, shiftFreezeAnchors, freezeDoneSubTasks, finishSubTasksByRole, freezeAllSubTasks, freezeReclaimDigestedBlocks } from "./subagent-freeze.mjs"
+// CLI-ACTIVITY-DEBLOAT F-3（2026-09-10）：面板手工镜像退役——re-export 面换现算导出
+// computePanelBlocks（读时现算），本文件全部刷镜调用点删除（单账本——变更点不再手动同步）。
+import { freezeSubTaskLines, finishSubTaskKey, finishSubTask, freezeDoneSubTasks, finishSubTasksByRole, freezeAllSubTasks, freezeReclaimDigestedBlocks, shiftFreezeAnchors } from "./subagent-freeze.mjs"
+export { computePanelBlocks, finishSubTask, finishSubTaskKey, freezeSubTaskLines, shiftFreezeAnchors, freezeDoneSubTasks, finishSubTasksByRole, freezeAllSubTasks, freezeReclaimDigestedBlocks } from "./subagent-freeze.mjs"
 
-/** `role#id/` prefix router — hyphen included since the eng-coder fix (2026-08-21). */
-export const SUB_PREFIX_RE = /^([\w-]+)#(\d+)\//
+// 前缀文法/解析已迁 src/agent/relay-prefix.mjs（第 27 批 §12.3②）——本文件不自持副本。
 /** ⟦ev⟧ token parser：`⟦ev⟧<name>\x1e<n>\x1e<max>\x1e<phase>\x1e<detail>`。phase done
  *  = async 完成即冻结（settle 时发）；settled = 挂起期完成——冻结延迟至 digest 消化
  *  完成（§17.5.5 freezeReclaimDigestedBlocks 逐条回收——不等池空）或池空退出兜底补发；
@@ -38,32 +45,14 @@ export const SUB_PREFIX_RE = /^([\w-]+)#(\d+)\//
  *  （块尚未创建）缓冲 `state._pendingAsyncKeys`——ensureSubTaskKey 块创建时应用（兜底）。 */
 export const SUB_EVENT_RE = /^⟦ev⟧(turn|approval|done|settled|stopped|queued)\x1e([^\x1e]*)\x1e([^\x1e]*)\x1e([^\x1e]*)\x1e?([\s\S]*)$/
 
-/** §19.5 D-M8 嵌套 relay 前缀通用解析（循环解析任意深度——R23 保持为路由源）：
- *  `eng-coder#2/explore#1/read` → { head（块路由）, inner[], label（inner 链——R23：
- *  子块折叠键/外层 currentTool 全路径用）, rest }。
- *  单层 = inner[]/label ""——与既有单段匹配语义零改；无前缀 → null。 */
-export function parseRelayPath(text) {
-  const segments = []
-  let rest = String(text)
-  for (;;) {
-    const m = rest.match(SUB_PREFIX_RE)
-    if (!m) break
-    segments.push(`${m[1]}#${m[2]}`)
-    rest = rest.slice(m[0].length)
-  }
-  if (segments.length === 0) return null
-  return {
-    head: segments[0],
-    inner: segments.slice(1),
-    label: segments.slice(1).join("/"),
-    rest,
-  }
-}
+// parseRelayPath 自 src/agent/relay-prefix.mjs import（第 27 批 §12.3①——文法单一权威，
+// 语义与迁移前逐字一致；“嵌套解析任意深度/无前缀 → null”见该模块）。
 
 /** N1: render-layer throttle for child tool-output appends (generation relays verbatim). */
 export const SUB_RELAY_THROTTLE_MS = 250
-/** Roles a subagent tool child can take (finishSubTask matches the block's role). */
-export const SUBAGENT_ROLES = ["sub", "explore", "plan", "coder", "eng-coder"]
+/** Roles a subagent tool child can take（⏹ 门控/渲染角色判据；F-2 后角色匹配完成面 =
+ *  finishSubTasksByRole——finishSubTask 已收窄 no-op）。 */
+export const SUBAGENT_ROLES = ["sub", "explore", "plan", "coder", "eng-coder", "eng-designer"]
 
 let _subRenderLast = 0
 let _subRenderTimer = null
@@ -99,13 +88,12 @@ export function ensureSubTaskKey(state, key, role) {
       blocks: [], currentTool: null, toolArgs: null, turn: 0, maxTurns: 0, approval: null,
       lastError: null, dropped: 0,
       stopped: false, // §19.5: ⟦ev⟧stopped 冻结标记（标题 "stopped"）
-      children: [], // R23: 嵌套子代理子块载体（subagent-children.mjs——D-R23a）
+      children: [], // SUBAGENT-TAIL: 嵌套子代理守护载体（内容并入本块——subagent-children.mjs）
     }
     // §19.5 D-M7b ①（处置 #4 兜底——2026-09-03）：缺失 key 的 ⟦ev⟧async 事件已缓冲
     // pending 标志（routeSubToken——async 先于块创建到达：排队条目补位启动的时序窗口）
     // ——块创建（此处）即应用——sub.async 区块创建即知（⏹ 门控/头标判定源保真）。
     if (state._pendingAsyncKeys?.delete(key)) state.subTasks[key].async = true
-    syncPanelSnapshot(state) // §19.6 D-P1: 块创建 → running 入镜
   }
   return state.subTasks[key]
 }
@@ -114,9 +102,10 @@ export function ensureSubTask(state, subMatch) {
   return ensureSubTaskKey(state, `${subMatch[1]}#${subMatch[2]}`, subMatch[1])
 }
 
-/** Append（kind 合并追加）+ N2 树级环形上限；fresh=true 强制新块（每工具调用）。
- *  R23（2026-09-07）：appendSubBlock/trimSubBlocks 实现迁 subagent-children.mjs（树级
- *  配额——子块计入外层 500 行环）——本文件 import + re-export 保 import 面（压缩面板等）。 */
+/** Append（kind 合并追加）+ N2 单环 500 显示行上限；fresh=true 强制新块（每工具调用）。
+ *  R23（2026-09-07）：appendSubBlock/trimSubBlocks 实现迁 subagent-children.mjs——
+ *  SUBAGENT-TAIL（D-ST4）后为单载体最旧先行（内层并入行同环计数）；本文件 import +
+ *  re-export 保 import 面（压缩面板等）。 */
 /** 事件 token → 区块头部（turn/approval 更新 turn n/max + 等待态）。事件永不进
  *  blocks/主流——仅头部。@returns {boolean} 良构事件（已消费） */
 export function applySubEvent(sub, payload) {
@@ -136,10 +125,12 @@ export function applySubEvent(sub, payload) {
 
 // ─── Prefix routing（agent-turn callbacks 委派）：true = 带前缀已消费；false = 主路径
 
-/** onToken 分支：子文本 / [model] 元数据 / ⟦ev⟧ 事件。§27 R23（supersede §19.5 D-M8
- *  子标方案）：head 段路由块——inner 段**建子块载体归属内容**（D-R23a——subagent-children.mjs）；
- *  内层 [model] 记子块模型；内层 ⟦ev⟧ 除 done/stopped（生成侧补发射——D-R23c1——路由
- *  子块定格）外剥除不路由（防 explore 进度污染外层块头——round1 #4）。 */
+/** onToken 分支：子文本 / [model] 元数据 / ⟦ev⟧ 事件。SUBAGENT-TAIL（D-ST1——supersede
+ *  R23 子块段方案，显示契约 docs/design/TUI.md §6）：head 段路由块——inner 段**内容行
+ *  并入外层块 blocks**（append 目标上移），子块载体只余守护元数据（done 守卫——F2
+ *  迟到丢弃；currentTool——fresh 判别）；内层 [model] 记子块模型；内层 ⟦ev⟧ 除
+ *  done/stopped（生成侧补发射——D-R23c1——路由子块定格）外剥除不路由（防 explore
+ *  进度污染外层块头——round1 #4）。 */
 export function routeSubToken(state, t, scheduleRender) {
   const path = parseRelayPath(t)
   if (!path) return false
@@ -163,7 +154,6 @@ export function routeSubToken(state, t, scheduleRender) {
       if (live.queued) {
         delete live.queued
         live.started = Date.now()
-        syncPanelSnapshot(state) // §19.6 D-P1: queued → running 状态变更刷镜
       }
     }
     else {
@@ -182,7 +172,6 @@ export function routeSubToken(state, t, scheduleRender) {
     const live = state.subTasks?.[path.head]
     if (live && !live.done && live.async !== true) {
       delete state.subTasks[path.head]
-      syncPanelSnapshot(state) // §19.6 D-P1: 移除后刷镜（块出面板）
     }
     scheduleRender()
     return true
@@ -195,16 +184,17 @@ export function routeSubToken(state, t, scheduleRender) {
   // queued（§20 D-SD3b）= 排队 spawn 等待块（spawn 返回即建/状态变迁刷新——覆盖式
   // 更新 sub.queued——块不可展开（无活动流）；启动后 async 事件清标转 running）。
   if (payload.startsWith("⟦ev⟧")) {
-    // R23（supersede D-M8"内层事件剥除不路由"——评审 #1 🅰）：done/stopped 完成信号 =
-    // 生成侧补发射（D-R23c1——sync 同步收尾段带完整嵌套前缀）→ 路由到子块定格
-    // （D-R23c2——closeSubChild——不冻结外层、不落 preview）；缺失子块（迟到事件/
+    // 内层完成信号（沿革：D-M8 子标 → R23 子块段 → SUBAGENT-TAIL 并入——显示契约
+    // docs/design/TUI.md §6）：done/stopped = 生成侧补发射（D-R23c1——sync 同步收尾段带
+    // 完整嵌套前缀）→ 路由到子块定格（closeSubChild——不冻结外层、不落 preview）；
+    // 缺失子块（迟到事件/
     // 从未开块）→ 不建幻影（no-op）。其余内层事件（turn/approval/queued/settled/
     // async/cancelled）剥除不路由（防 explore 进度污染外层块头——round1 #4）。
     if (nested) {
       const innerEv = payload.match(SUB_EVENT_RE)
       if (innerEv && (innerEv[1] === "done" || innerEv[1] === "stopped")) {
         const leaf = descendSubChild(sub, path.inner, { create: false })
-        // §27.1 F2: done 子块完全定格——迟到 done/stopped 丢弃（重复 done 不重放
+        // F2 保全：done 子块完全定格——迟到 done/stopped 丢弃（重复 done 不重放
         // 定格；stopped 不打回 done 定格块）
         if (leaf && !leaf.done) closeSubChild(sub, leaf, innerEv[1] === "stopped", path.label)
         scheduleRender()
@@ -224,7 +214,6 @@ export function routeSubToken(state, t, scheduleRender) {
       sub.currentTool = null
       sub.approval = null
       sub.blockEpoch = (sub.blockEpoch ?? 0) + 1
-      syncPanelSnapshot(state) // §19.6 D-P1: waiting 块建/刷新刷镜
       scheduleRender()
       return true
     }
@@ -239,7 +228,6 @@ export function routeSubToken(state, t, scheduleRender) {
       sub.currentTool = null
       sub.approval = null
       sub.blockEpoch = (sub.blockEpoch ?? 0) + 1
-      syncPanelSnapshot(state) // §19.6 D-P1: settled → awaitingDigest 状态变更刷镜
       scheduleRender()
       return true
     }
@@ -251,7 +239,6 @@ export function routeSubToken(state, t, scheduleRender) {
       sub.blockEpoch = (sub.blockEpoch ?? 0) + 1
       freezeSubTaskLines(state, sub)
       delete state.subTasks[sub.key]
-      syncPanelSnapshot(state) // §19.6 D-P1: 冻结删除后刷镜
       scheduleRender()
       return true
     }
@@ -264,7 +251,6 @@ export function routeSubToken(state, t, scheduleRender) {
       sub.blockEpoch = (sub.blockEpoch ?? 0) + 1
       freezeSubTaskLines(state, sub)
       delete state.subTasks[sub.key]
-      syncPanelSnapshot(state) // §19.6 D-P1: 冻结删除后刷镜
       scheduleRender()
       return true
     }
@@ -276,11 +262,12 @@ export function routeSubToken(state, t, scheduleRender) {
   // parent's) — shown in the block header, NOT appended to its content stream.
   // Only treat as metadata when the model isn't set yet (it's always the FIRST token);
   // a child content token that happens to start with "[model]" must not be swallowed.
-  // R23：内层 [model] 记到子块（D-R23a 子块状态字段——不再剥除丢弃）；单层规则不变。
+  // SUBAGENT-TAIL：内层 [model] 记到守护载体（类目 B 字面量——不渲染、无正读者；
+  // docs/design/TUI.md §6）；单层规则不变。
   if (payload.startsWith("[model]") && (nested || sub.model === undefined)) {
     if (nested) {
       const leaf = descendSubChild(sub, path.inner)
-      // §27.1 F2: done 子块完全定格——迟到 [model] 不写定格块头
+      // F2: done 子块完全定格——迟到 [model] 不写定格块头
       if (!leaf.done && leaf.model === undefined) {
         leaf.model = payload.slice(7)
         scheduleRender()
@@ -291,82 +278,76 @@ export function routeSubToken(state, t, scheduleRender) {
     }
     return true
   }
-  // Child LLM text → text block (N2 cap inside appendSubBlock). R23：内层文本归属子块
-  // （D-R23b——子块行——不再混外层 blocks/子标）。§27.1 F2：done 子块完全定格——
-  // 迟到 chunk 丢弃（与 appendSubChild 数据层守卫同义——此处免无谓 render）。
-  if (nested) {
-    const leaf = descendSubChild(sub, path.inner)
-    if (leaf.done) return true
-    appendSubChild(sub, leaf, "text", payload)
-  } else appendSubBlock(sub, "text", payload)
+  // Child LLM text → text block (N2 cap inside appendSubBlock). SUBAGENT-TAIL（D-ST1）：
+  // 内层文本**并入外层 blocks**（append 目标上移——子块不再承载内容行，取代小节）。
+  // F2：done 子块完全定格——迟到 chunk 丢弃（leaf.done 守卫——免无谓 render）。
+  const leaf = nested ? descendSubChild(sub, path.inner) : null
+  if (leaf?.done) return true
+  appendSubBlock(sub, "text", payload)
   scheduleRender()
   return true
 }
 
 /** Child reasoning token → think block (F2: same treatment as main reasoning).
- *  §27 R23 nested think：归属内层子块（supersede D-M8 子标渲染——D-R23a/b）。 */
+ *  SUBAGENT-TAIL：内层 think 并入外层 blocks（append 目标上移——显示契约 TUI.md §6）。 */
 export function routeSubReasoning(state, t, scheduleRender) {
   const path = parseRelayPath(t)
   if (!path) return false
   const sub = ensureSubTaskKey(state, path.head, path.head.slice(0, path.head.lastIndexOf("#")))
   if (!sub) return true // frozen tombstone — drop late token
   const nested = path.inner.length > 0
-  if (nested) {
-    const leaf = descendSubChild(sub, path.inner)
-    if (leaf.done) return true // §27.1 F2: done 子块完全定格——迟到 think 丢弃
-    appendSubChild(sub, leaf, "think", path.rest)
-  } else appendSubBlock(sub, "think", path.rest)
+  const leaf = nested ? descendSubChild(sub, path.inner) : null
+  if (leaf?.done) return true // F2: done 子块完全定格——迟到 think 丢弃
+  appendSubBlock(sub, "think", path.rest)
   scheduleRender()
   return true
 }
 
-/** Child tool call → fresh tool block + header currentTool。§27 R23 嵌套（supersede
- *  D-M8 子标工具行）：工具行归属内层子块（子块内 `❯ tool`）；currentTool 外层存全路径
- *  （`explore#1/read`——评审 #8：外层块头状态区现状保持不缩改）+ 子块存工具名（子块内
- *  输出归属判别）。 */
+/** Child tool call → fresh tool block + header currentTool。SUBAGENT-TAIL（D-ST1）：内层
+ *  工具行并入外层 blocks（同款 `❯ tool` 行——取代小节）；currentTool 外层存全路径
+ *  （`explore#1/read`——评审 #8：外层块头状态区现状保持不缩改）+ 子块存工具名（守护
+ *  元数据——fresh 判别源，routeSubToolOutput 读）。 */
 export function routeSubToolCall(state, name, args, scheduleRender) {
   const path = parseRelayPath(name)
   if (!path) return false
   const sub = ensureSubTaskKey(state, path.head, path.head.slice(0, path.head.lastIndexOf("#")))
   if (!sub) return true // frozen tombstone — drop late token
   const nested = path.inner.length > 0
-  // §27.1 F2: done 子块完全定格——迟到 tool call 丢弃（不复活外层 currentTool/子块状态）
+  // F2: done 子块完全定格——迟到 tool call 丢弃（不复活外层 currentTool/子块状态）
   const leaf = nested ? descendSubChild(sub, path.inner) : null
   if (leaf?.done) return true
   sub.currentTool = nested ? `${path.label}/${path.rest}` : path.rest
   sub.toolArgs = args
   sub.approval = null
   const argsDesc = describeToolArgs(path.rest, args)
-  if (nested) {
+  if (leaf) {
     leaf.currentTool = path.rest
     leaf.toolArgs = args
     leaf.approval = null
-    appendSubChild(sub, leaf, "tool", `❯ ${path.rest}${argsDesc ? " " + argsDesc : ""}\n`, { fresh: true })
-  } else {
-    appendSubBlock(sub, "tool", `❯ ${path.rest}${argsDesc ? " " + argsDesc : ""}\n`, { fresh: true })
   }
+  appendSubBlock(sub, "tool", `❯ ${path.rest}${argsDesc ? " " + argsDesc : ""}\n`, { fresh: true })
   scheduleRender()
   return true
 }
 
 /** Child tool output（D1 前缀 name relay）→ 追加当前 tool block。RAW 拼接（2026-09-03
  *  修复轮——relay chunk 是任意字节边界碎片，逐 chunk 补 \n 会把词拦腰断行 + 烧 N2
- *  配额；emit 端自带换行结构无损还原）。§27 R23 嵌套：输出归属内层子块（T-R23a.2——
- *  输出全在子块——外层流无混入）；fresh 判别在子块层（子块 currentTool=工具名）——
- *  内外/同层同名工具互不串块。 */
+ *  配额；emit 端自带换行结构无损还原）。SUBAGENT-TAIL（D-ST1）：内层输出并入外层
+ *  blocks（append 目标上移）；fresh 判别照旧在子块层（守护元数据 leaf.currentTool=
+ *  工具名）——内外/同层同名工具互不串块。 */
 export function routeSubToolOutput(state, name, part, scheduleRender) {
   const path = parseRelayPath(name)
   if (!path) return false
   const sub = ensureSubTaskKey(state, path.head, path.head.slice(0, path.head.lastIndexOf("#")))
   if (!sub) return true // frozen tombstone — drop late token
-  if (path.inner.length > 0) {
-    const leaf = descendSubChild(sub, path.inner)
-    if (leaf.done) return true // §27.1 F2: done 子块完全定格——迟到输出丢弃（不复活 currentTool）
-    const leafTool = path.rest
-    appendSubChild(sub, leaf, "tool", part.text, { fresh: leaf.currentTool !== leafTool })
-    if (leaf.currentTool !== leafTool) leaf.currentTool = leafTool
+  const nested = path.inner.length > 0
+  const leaf = nested ? descendSubChild(sub, path.inner) : null
+  if (leaf?.done) return true // F2: done 子块完全定格——迟到输出丢弃（不复活 currentTool）
+  const toolName = path.rest
+  if (leaf) {
+    appendSubBlock(sub, "tool", part.text, { fresh: leaf.currentTool !== toolName })
+    if (leaf.currentTool !== toolName) leaf.currentTool = toolName
   } else {
-    const toolName = path.rest
     appendSubBlock(sub, "tool", part.text, { fresh: sub.currentTool !== toolName })
     if (sub.currentTool !== toolName) sub.currentTool = toolName
   }
@@ -410,7 +391,6 @@ export function ensureCompressPanel(state, info = {}) {
   const messages = Number.isInteger(info.messages) && info.messages >= 0 ? info.messages : "?"
   appendSubBlock(panel, "status", "Compressing context…\n", { fresh: true })
   appendSubBlock(panel, "meta", `summarizing ${messages} messages\n`, { fresh: true })
-  syncPanelSnapshot(state) // §19.6 D-P1: 压缩面板建/重置刷镜
   return panel
 }
 
@@ -427,7 +407,6 @@ export function markCompressFailed(state, error) {
 function freezeCompressPanel(state, panel) {
   freezeSubTaskLines(state, panel)
   delete state.subTasks[panel.key]
-  syncPanelSnapshot(state) // §19.6 D-P1: 压缩面板冻结删除后刷镜
 }
 
 /** 完成态（onCompress）："Compressed: N tokens freed → summary (Xs)"——冻结可折叠。 */