thincoder 0.12.67 → 0.12.68

package/src/completions.mjs

@@ -2,6 +2,10 @@
  * completions.mjs — `thincoder completion <shell>` shell 补全脚本发射（bash/zsh/fish）。
  * bin/thincoder.mjs case "completion" 直写段拆分（2026-09-08——500 行硬限触碰执行：
  * 段逐字迁出，脚本字节与既有输出一致）。
+ * 发射契约（CLI-ENTRY.md §3 —— #704 收正 2026-09-30）：**源档形 ≡ 发射字节形**——bash 直写形零反斜杠
+ * `\$(...)` 非命令替换 ⇒ `bash -n` 语法错；zsh 分派行同排直写（双引号内 `\$` = 字面 `$` ⇒ 分派永不匹配）；
+ * 余反斜杠仅续行 `\\`（行尾接续，发射 `\`）——保留。
+ * 例外（JS 插值险位）：须发射字面 `${…}` 的段在源档保留 `\${` 转义。
  */
 export function printCompletion(shell) {
     if (shell === "bash") {
@@ -11,17 +15,23 @@ export function printCompletion(shell) {
   cur="\${COMP_WORDS[COMP_CWORD]}"
   prev="\${COMP_WORDS[COMP_CWORD-1]}"
   case "\${COMP_WORDS[1]}" in
-    chat)    COMPREPLY=( \\$(compgen -W "--auto" -- "\\$cur") ) ;;
+    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") ) ;;
+      case "$prev" in
+        memory) COMPREPLY=( $(compgen -W "list search put remove sweep" -- "$cur") ) ;;
+        list)   COMPREPLY=( $(compgen -W "--type=rule --type=knowledge --type=decision --type=pattern" -- "$cur") ) ;;
+        put)    COMPREPLY=( $(compgen -W "--type= --title= --content= --tags=" -- "$cur") ) ;;
+        sweep)  COMPREPLY=( $(compgen -W "--origin= --dry-run --confirm" -- "$cur") ) ;;
       esac ;;
-    distill) COMPREPLY=( \\$(compgen -W "--yes --layer=" -- "\\$cur") ) ;;
-    completion) COMPREPLY=( \\$(compgen -W "bash zsh fish" -- "\\$cur") ) ;;
+    ledger) case "$prev" in
+        ledger)  COMPREPLY=( $(compgen -W "migrate audit" -- "$cur") ) ;;
+        migrate) COMPREPLY=( $(compgen -W "--dry-run --confirm --from" -- "$cur") ) ;;
+        audit)   COMPREPLY=( $(compgen -W "--root" -- "$cur") ) ;;
+      esac ;;
+    distill) COMPREPLY=( $(compgen -W "--yes --layer=" -- "$cur") ) ;;
+    completion) COMPREPLY=( $(compgen -W "bash zsh fish" -- "$cur") ) ;;
     *)
-      COMPREPLY=( \\$(compgen -W "tui chat acp memory sync reindex distill upgrade completion session -v --version -h --help" -- "\\$cur") ) ;;
+      COMPREPLY=( $(compgen -W "tui chat acp memory sync reindex distill upgrade completion session ledger -v --version -h --help" -- "$cur") ) ;;
   esac
 }
 complete -F _thincoder thincoder
@@ -36,7 +46,7 @@ _thincoder() {
     '1: :->cmd' \\
     '*:: :->args'
 
-  case "\\$state" in
+  case "$state" in
     cmd)
       _values 'command' \\
         'tui[Launch the interactive TUI]' \\
@@ -48,16 +58,21 @@ _thincoder() {
         '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]'
+        'session[Session dir GC: session gc --dry-run|--confirm]' \\
+        'ledger[Ledger variants: migrate / audit]'
       ;;
     args)
-      case "\\$words[1]" in
+      case "$words[1]" in
         chat)    _arguments '--auto[Auto-approve all tool calls]' ;;
         memory)
-          case "\\$words[2]" in
+          case "$words[2]" in
             list) _arguments '--type=[Filter by type]' ;;
             put)  _arguments '--type=[Entry type]' '--title=[Title]' '--content=[Content]' '--tags=[Space-separated tags]' ;;
+            sweep) _arguments '--origin=[Origin path]' '--dry-run[Report only]' '--confirm[Apply writes]' ;;
           esac ;;
+        ledger) case "$words[2]" in
+            migrate) _arguments '--dry-run[Report only]' '--confirm[Apply migration]' '--from:Source key:' ;;
+            audit)   _arguments '--root:Scan root dir:' ;; esac ;;
         distill) _arguments '--yes[Skip confirmation]' '--layer=[Layer filter]' ;;
         completion) _values 'shell' 'bash' 'zsh' 'fish' ;;
       esac ;;
@@ -79,6 +94,7 @@ 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 ledger -d 'Ledger variants: migrate / audit'
 complete -c thincoder -a acp -d 'Agent Client Protocol server for IDEs'
 
 # Flags
@@ -93,6 +109,7 @@ complete -c thincoder -n '__fish_seen_subcommand_from memory' -a list   -d 'List
 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'
+complete -c thincoder -n '__fish_seen_subcommand_from memory' -a sweep  -d 'Sweep dead origins'
 
 # 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'
@@ -103,6 +120,11 @@ complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_su
 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'
 
+# memory sweep flags
+complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from sweep' -l origin -d 'Origin path'
+complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from sweep' -l dry-run -d 'Report only'
+complete -c thincoder -n '__fish_seen_subcommand_from memory; and __fish_seen_subcommand_from sweep' -l confirm -d 'Apply writes'
+
 # 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'
@@ -111,6 +133,8 @@ complete -c thincoder -n '__fish_seen_subcommand_from distill' -l layer -d 'Laye
 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'
+complete -c thincoder -n '__fish_seen_subcommand_from ledger' -a 'migrate audit' -d 'Ledger variants: migrate / audit'
+complete -c thincoder -n '__fish_seen_subcommand_from ledger' -l dry-run -l confirm -l from -l root -d 'Ledger flags'
 `)
     }
 }

package/src/crash-reports.mjs

@@ -1,5 +1,5 @@
 /**
- * crash-reports.mjs — 崩溃捕获与取证（docs/design/CRASH-REPORTS.md——F1/F2 为 R25 与
+ * crash-reports.mjs — 崩溃捕获与取证（docs/cli/design/CRASH-REPORTS.md——F1/F2 为 R25 与
  * TUI-STDERR-CAPTURE 存量迁移；F3 近堆上限堆快照 = TUI-OOM-FORENSICS 批新增）。
  *
  * 能力（与设计逐项对应）：
@@ -8,7 +8,8 @@
  *   自动写 report.*.json。实现批实测（2026-09-07）：目录缺失时 Node 对 fatal 静默不写
  *   报告——预建是必要动作而非"零成本保险"。
  *   F3①：同点武装近堆上限堆快照（v8.setHeapSnapshotNearHeapLimit——对象级证据，回答
- *   "谁在持内存"；全路径单源，默认开、THINCODER_HEAP_SNAPSHOT 可关——F3②）。
+ *   "谁在持内存"；全路径单源，默认关、配置键 `diagnostics.heapSnapshot` 取 `true` 才武装
+ *   （fail-closed；bin 入口读键后经 `heapSnapshot` 参数显式传入——F3②）。
  * - writeCrashRecord()（F-R25a）：JS 异常钩子同步落盘 crash-{ts}-{pid}.json（ts = epoch ms
  *   UTC + pid——跨进程同 ms 防覆盖——复审 #3）——权限 0600（config.json 先例）。
  * - recentCrashHint()（F-R25c）：启动扫描 24h 窗内记录（两类文件模式定死——评审 #8：
@@ -23,15 +24,12 @@
  * 纪律：全部同步 API（崩溃路径无异步）；调用方按执行序列各步独立 try/catch（复审 #2——
  * 写失败/恢复失败不阻断后续步——exit 非 0 恒达）。
  */
-import { chmodSync, existsSync, mkdirSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs"
+import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs"
 import { join } from "node:path"
 // F3① 命名空间 import：API 缺失（旧 Node）降级为调用期异常并被武装 try 吞掉——不做 import 期硬失败
 import * as v8 from "node:v8"
 import { configDir } from "@thincoder/core/config.mjs"
 
-/** F3② 关值集合（trim + 大小写不敏感）；其余取值（未设 / 空串 / 未知串）默认开——fail-open 向取证。 */
-const HEAP_SNAPSHOT_OFF_VALUES = new Set(["0", "false", "off", "no"])
-
 /** crash-reports 运行时目录（~/.thincoder/crash-reports——非仓内——写时自清理）。 */
 export function crashReportsDir() {
   return join(configDir, "crash-reports")
@@ -43,8 +41,14 @@ export function crashReportsDir() {
  *  Heap.*.heapsnapshot（CRASH-REPORTS F3③——快照 GB 级、TUI 落点须自动兜底）——但
  *  recentCrashHint 两类均不计（N3）：tui-stderr 每次 TUI 启动都生成（正常退出也留档）、
  *  快照非「异常终止」证据类——计入即正常会话误报。 */
+/** 记录类判定单源（`isCrashRecordName` 与 `recordFacts` 共用——防两处正则漂移）：自写 / Node fatal / 其余。 */
+function recordClassOf(name) {
+  if (/^crash-.+\.json$/.test(name)) return "self"
+  if (/^report\..+\.json$/.test(name)) return "native"
+  return null
+}
 function isCrashRecordName(name) {
-  return /^crash-.+\.json$/.test(name) || /^report\..+\.json$/.test(name)
+  return recordClassOf(name) !== null
 }
 function isPurgeRecordName(name) {
   return isCrashRecordName(name) || /^tui-stderr-.+\.log$/.test(name) || /^Heap\..+\.heapsnapshot$/.test(name)
@@ -63,21 +67,16 @@ function purgeOldCrashReports(dir) {
   }
 }
 
-/** F3② 武装判定（单点——包装器不判 env，防两处判定漂移）：关值集合命中 → 不武装；其余 → 武装。 */
-function heapSnapshotEnabled(env) {
-  return !HEAP_SNAPSHOT_OFF_VALUES.has(String(env?.THINCODER_HEAP_SNAPSHOT ?? "").trim().toLowerCase())
-}
-
 /**
  * F-R25b：入口最前调用（一切重活前——缩编程期窗口）——预建目录 + process.report 启用。
  * 任何失败不阻断启动（尽力面——record 路径自带降级）。返回目录路径。
- * F3①：同点武装近堆上限堆快照（默认开——全路径单源；环境开关见 heapSnapshotEnabled）。
- * @param {object} [opts] 注入缝（默认参数保 bin 入口调用点零改）
+ * F3①：同点武装近堆上限堆快照（默认关——fail-closed，显式 `true` 才武装；全路径单源；开关 = bin 入口读配置键后经 `heapSnapshot` 传入）。
+ * @param {object} [opts] 注入缝（默认参数 = 生产常态）
  * @param {string} [opts.dir] 目录注入（测试用——同时服务 mkdir / report / purge / 返回）
- * @param {object} [opts.env] env 注入（测试用）——仅服务 F3② 判定
+ * @param {boolean} [opts.heapSnapshot] 快照武装开关（bin 入口经配置键判定后显式传入；配置默认关、显式 `true` 才武装——fail-closed；形参缺省 = 内部约定，生产调用点恒显式传值）
  * @param {(n: number) => void} [opts.armHeapSnapshot] 武装实现注入（测试用）——默认真实 node:v8 API
  */
-export function prepareCrashReporting({ dir = crashReportsDir(), env = process.env, armHeapSnapshot = v8.setHeapSnapshotNearHeapLimit } = {}) {
+export function prepareCrashReporting({ dir = crashReportsDir(), heapSnapshot = true, armHeapSnapshot = v8.setHeapSnapshotNearHeapLimit } = {}) {
   try {
     mkdirSync(dir, { recursive: true })
     // 代码内启用：shebang 入口无法携带启动参数（env 单参数限制 + execArgv 仅子进程——评审 #1）
@@ -85,7 +84,7 @@ export function prepareCrashReporting({ dir = crashReportsDir(), env = process.e
     process.report.reportOnFatalError = true
   } catch { /* mkdir/启用失败不阻断启动——尽力面 */ }
   // F3① 武装（独立 try——失败不阻断启动、不影响上方 F1 既有步骤；尽力面静默）
-  if (heapSnapshotEnabled(env)) {
+  if (heapSnapshot) {
     try { armHeapSnapshot(1) } catch { /* 武装失败不阻断——N1 */ }
   }
   purgeOldCrashReports(dir) // F-R25b 入口 mkdir 搭车清理（复审 #4——纯 fatal 序列也触发）
@@ -124,10 +123,33 @@ export function writeCrashRecord({ type, error }) {
   }
 }
 
+/**
+ * 提示行事实段（台账 #212 · 用户裁 B）：从选中记录读回 `uptime` / `cwd` 两段——段序固定 =
+ * uptime 段（` · 运行 <u>s`，一位小数）在前 / cwd 段（` · cwd <c>`）在后。
+ * 字段源按记录类分：自写记录（`crash-*.json`）取顶部 `uptime` / `cwd`；Node fatal 报告
+ * （`report.*.json`）取 `header.cwd`——Node 报告无 uptime 字段（2026-09-25 实测），该段略去。
+ * 退化（尽力面 · N1）：读档 / 解析失败、记录类不明、字段缺 / 型不符（`uptime` 非有限非负数 ·
+ * `cwd` 非非空字符串）⇒ 对应段略去；两段皆缺 ⇒ 空串（基础形）。不抛、不阻断启动。
+ */
+function recordFacts(file, name) {
+  const cls = recordClassOf(name)
+  if (cls === null) return "" // 记录类不明 ⇒ 零事实
+  let rec
+  try { rec = JSON.parse(readFileSync(file, "utf8")) } catch { return "" }
+  if (rec === null || typeof rec !== "object") return ""
+  let facts = ""
+  if (cls === "self" && typeof rec.uptime === "number" && Number.isFinite(rec.uptime) && rec.uptime >= 0) {
+    facts += ` · 运行 ${rec.uptime.toFixed(1)}s`
+  }
+  const cwd = cls === "native" ? rec.header?.cwd : rec.cwd
+  if (typeof cwd === "string" && cwd !== "") facts += ` · cwd ${cwd}`
+  return facts
+}
+
 /**
  * F-R25c：启动扫描——crash-reports 24h 窗内是否有记录（两类模式——mtime 判定）。
  * @param {object} [opts] 可选 { dir }——目录注入（测试用）；默认 crashReportsDir()
- * @returns {string|null} 提示文本（含最新记录完整路径）；无匹配 → null（负例——不提示）
+ * @returns {string|null} 提示文本（含最新记录完整路径 + 事实段——#212）；无匹配 → null（负例——不提示）
  */
 export function recentCrashHint({ dir = crashReportsDir() } = {}) {
   purgeOldCrashReports(dir) // F-R25c 启动扫描搭车清理（复审 #4）
@@ -141,10 +163,10 @@ export function recentCrashHint({ dir = crashReportsDir() } = {}) {
     try {
       const st = statSync(join(dir, name))
       if (st.mtimeMs >= cutoff && (!best || st.mtimeMs > best.mtimeMs)) {
-        best = { path: join(dir, name), mtimeMs: st.mtimeMs }
+        best = { path: join(dir, name), name, mtimeMs: st.mtimeMs }
       }
     } catch { /* 单文件 stat 失败跳过 */ }
   }
   if (!best) return null
-  return `上次运行异常终止（记录：${best.path}）`
+  return `上次运行异常终止（记录：${best.path}${recordFacts(best.path, best.name)}）`
 }

package/src/distill.mjs

@@ -40,7 +40,7 @@ If the session is long, prioritize conclusions that appeared last and are still
 Session log:
 `
 
-/** §18.6 D-TR6（2026-09-04 fix round1）：distill 调用点无 agent 作用域——traces 开关
+/** TRACES.md §6.1 D-TR6（2026-09-04 fix round1）：distill 调用点无 agent 作用域——traces 开关
  *  缺省回退磁盘配置（loadConfig——与 agent.config 同源：traces.enabled 缺省 on）；
  *  配置不可读时按缺省 on（注：CLI 启动早已 loadConfig——此处仅是兜底防御）。 */
 function tracesEnabledFromConfig() {
@@ -54,14 +54,14 @@ function tracesEnabledFromConfig() {
 /**
  * Extract candidates from a session transcript. transcript: plain-text session record.
  * Returns [{ type, title, content, tags, layer }], or [] on parse failure.
- * opts.traces（可选）：§18.6 D-TR6 开关显式透传（测试隔离/未来调用方）——缺省回退
+ * opts.traces（可选）：TRACES.md §6.1 D-TR6 开关显式透传（测试隔离/未来调用方）——缺省回退
  * 磁盘配置（tracesEnabledFromConfig）——关 = chat() 出口不落盘。
  */
 export async function extractCandidates(provider, transcript, opts = {}) {
   const traces = opts.traces ?? tracesEnabledFromConfig()
   const res = await chat(provider, {
     messages: [{ role: "user", content: DISTILL_PROMPT + transcript }],
-    // §18.6 D-TR4/D-TR6（fix round1）：distill 调用经 chat() 唯一采集点——补轨迹
+    // TRACES.md §6.1 D-TR4/D-TR6（fix round1）：distill 调用经 chat() 唯一采集点——补轨迹
     // 元数据 + traces 开关透传（关=不落盘必须全覆盖——不再静默越过开关）
     logCtx: { stage: "distill", kind: "distill", traces },
   })

package/src/heap-watch.mjs

@@ -9,8 +9,8 @@
  * 无绝对 MB 常量）；双档边缘触发（每档一次/进程——不重复刷屏）；零常态开销
  * （60s 一次 memoryUsage()，无输出——D-HW5）。
  *
- * 开关单点：`THINCODER_HEAP_WATCH`——关值集合 {`0`,`false`,`off`,`no`}（trim + 大小写
- * 不敏感）→ 不启动；未设/空串/其他值 → 启动（默认开——与 F3② 同约定）。
+ * 开关：配置键 `diagnostics.heapWatch`（默认开——判定形 `!== false`，与 F3 快照面默认相反〔快照默认关〕）——bin 入口读键后经
+ * `enabled` 参数显式传入；关 ⇒ 不注册定时器（返回惰性句柄）。
  *
  * 注入缝（N5 可测）：`sample` / `heapLimit` / `timer`——测试以假实现 + `checkNow()`
  * 直驱（零等待）；失败面全吞（采样抛错不阻断——样本失败静默跳过本次）。
@@ -18,15 +18,6 @@
 import { getHeapStatistics } from "node:v8"
 import { logEvent } from "@thincoder/core/log.mjs"
 
-/** 关值集合（单点判定——§3.2 同约定复用）。 */
-export const HEAP_WATCH_OFF = new Set(["0", "false", "off", "no"])
-
-/** 开关判定（单点——grep 面：仅本模块读 env.THINCODER_HEAP_WATCH）。 */
-export function heapWatchEnabled(env = process.env) {
-  const v = String(env.THINCODER_HEAP_WATCH ?? "").trim().toLowerCase()
-  return !HEAP_WATCH_OFF.has(v)
-}
-
 // 订阅表（TUI 行接线——§8.3 订阅制；模块级：武装在 bin、订阅在 startTUI）
 const _subscribers = new Set()
 
@@ -45,14 +36,14 @@ export function heapWarnLine(used, limit, ratio) {
 
 /**
  * 启动看门狗（返回 `{ stop(), checkNow() }`——checkNow 直驱一次采样并返回本轮新发预警行）。
- * 关值（§8.3）→ 不注册定时器（返回惰性句柄）。
+ * 开关关（`enabled: false`）→ 不注册定时器（返回惰性句柄）。
  */
 export function startHeapWatch({
   intervalMs = 60_000,
   ratios = [0.7, 0.85],
   sample = process.memoryUsage,
   heapLimit = () => getHeapStatistics().heap_size_limit,
-  env = process.env,
+  enabled = true,
   timer = setInterval,
 } = {}) {
   const warned = new Set()
@@ -76,7 +67,7 @@ export function startHeapWatch({
     } catch { /* 失败面全吞（N5——采样/上限抛错不阻断、状态保持） */ }
     return out
   }
-  if (!heapWatchEnabled(env)) return { stop() {}, checkNow }
+  if (!enabled) return { stop() {}, checkNow }
   const handle = timer(checkNow, intervalMs)
   try { handle?.unref?.() } catch { /* unref 失败不阻断（一次性命令自然退出） */ }
   return {

package/src/tui/agent-turn.mjs

@@ -14,15 +14,19 @@
  * 递归回本文件（函数级静态环——模块求值期无顶层调用，环安全——session-slots ↔
  * session.mjs 同款先例）。
  */
-import { runAgent, ContinueError } from "@thincoder/core/agent.mjs"
+import { runAgent } from "@thincoder/core/agent.mjs"
 import { saveSession } from "@thincoder/core/session.mjs"
+import { continueDecision } from "@thincoder/core/agent/continue-decision.mjs" // #677 · I10 续跑判定单源（#127 ④ 双写退役）
 import { ansi, C } from "./ansi.mjs"
 import { buildToolCallbacks, sweepToolBlocks } from "./tool-events.mjs"
 import { freezeAllSubTasks } from "./subagent-blocks.mjs" // freezeReclaimDigestedBlocks 随 AGENT-LOOP-ASYNC-POOL.md §6.8 段迁 suspension-drive.mjs
 import { ensureSessionTitle } from "@thincoder/core/generate-title.mjs"
 import { logEvent, errText } from "@thincoder/core/log.mjs"
-import { t } from "@thincoder/core/i18n.mjs"
+import { pushRecord } from "@thincoder/core/context.mjs"
 import { suspensionSession, poolLive } from "./suspension-drive.mjs"
+// #726 写点②：cap 行 ∥ cap 记录同点双动作（文案/形 = lifecycle-records 单一实现）
+import { digestCapRecord, digestTraceLines, recordCarrier } from "./lifecycle-records.mjs"
+import { timerWakeArmed } from "./timer-watch.mjs" // §6.30.3 门三件③：在途 timer ∧ 开关开 ⇒ 唤醒会武装
 import { planQueuedInput } from "./queued-merge.mjs"
 import { pickupQueuedAtStepBoundary } from "./queued-pickup.mjs"
 
@@ -31,20 +35,21 @@ import { pickupQueuedAtStepBoundary } from "./queued-pickup.mjs"
  *  never let shutdown hang on the background summary call. */
 const DISTILL_FLUSH_TIMEOUT_MS = 5000
 
-/** Provider 失败面 URL 脱敏（X8——判据与 VSC `panel-turn-loop.mjs:153` 同式；两端各自持有
- *  字面 = 双写登记——单源化须动 VSC/核写域，出本批射程，见批档 §2.3）。 */
+/** Provider 失败面 URL 脱敏（X8——判据与 VSC `panel-turn-loop.mjs` 的 `e.message` 首行脱敏处同式；两端各自持有
+ *  字面 = 双写登记——单源化须动 VSC/核写域，出本批射程）。 */
 const PROVIDER_URL_RE = /https?:\/\/[^\s,)"]+/g
 
 /**
  * 第 33 批（TUI §14.3(d)——纯函数，供测试直驱）：回合链尾「需要用户」谓词——agent 已停
  * 且无自动续跑 ⇒ 置 attention 位。排除项语义（F13）：`skipSession`（digest / 会话内回合
  *  ——由外层链尾统一置位）· 挂起两态 / 池 live / 队列非空（自动续跑中——不由用户接手）·
- *  processing（回合在跑）。
+ *  processing（回合在跑）· **在途 timer ∧ 唤醒会武装**（`docs/cli/design/TUI.md` §7.1 awaiting
+ *  行除外 / §7.2 置位谓词——自动续跑在途 ⇒ 不计 awaiting；机判 = T-TW13；timer-wake 批 2026-09-27）。
  *  @returns {boolean}
  */
 export function userNeededAtTurnEnd(state, agent, skipSession) {
   return !skipSession && !state.suspended && !state._suspPending && !poolLive(agent)
-    && state.queue.length === 0 && !state.processing
+    && state.queue.length === 0 && !state.processing && !timerWakeArmed(agent)
 }
 
 /**
@@ -75,9 +80,32 @@ export async function runAgentTurn(ctx, text, opts = {}) {
   }
 }
 
-/** runAgentTurn 本体（LOGGING 包装之外——见上方包装器）。 */
+/** #448② 重武装守卫（KD-6「异常径重武装——会话停 ∕ 显式撤销除外」）：**粘滞位 `_timerRearmRevoked`**
+ *  = 主线（两实落点：Ctrl+C 全停 `{abortTrigger:"stop"}` 中止分支 ∕ 挂起会话中止（`_suspAborted`）复位前捕获；
+ *  链头复位 ⇒ 下一链正常重入）。余两腿为**防御面**（仅在正文异常早退、控制器尚未置空时可达）：
+ *  `_suspAborted` 未及复位 ∥ 本链控制器 stop 语义在场 ∥ 会话 abort 句柄已中止。 */
+function timerRearmBlocked(state, agent) {
+  return state?._timerRearmRevoked === true
+    || state?._suspAborted === true
+    || state?.controller?.signal?.reason?.abortTrigger === "stop"
+    || agent?._sessionAbort?.signal?.aborted === true
+}
+
+/** runAgentTurn 本体（LOGGING 包装之外——见上方包装器）：**链尾收口层**——正文（`runAgentTurnBody`）
+ *  之后收「链尾闩重同步」（§6.30.5 载体②武装点——履行原正文内同点调用；#448②：入 `finally` ⇒
+ *  异常 ∕ 中止逃逸的回合同样重武装；守卫 = `timerRearmBlocked`）。attention 仍在正文链尾原位
+ *  （谓词读 `_pendingTimers`、不读闩状态 ⇒ 与 sync 无相对序依赖）。 */
 async function runAgentTurnInner(ctx, text, opts) {
-  const { autoTurn = false, skipSession = false, upstreamTurn = false } = opts ?? {} // upstreamTurn：上行 ask 唤醒轮旗标（§6.27.12.5 D/I——透传核 runAgent，仅供域文本选择）
+  try {
+    await runAgentTurnBody(ctx, text, opts)
+  } finally {
+    if (!timerRearmBlocked(ctx?.state, ctx?.agent)) ctx?.timerWatch?.sync()
+  }
+}
+
+/** runAgentTurn 正文（原 `runAgentTurnInner` 逐字——唯一改动 = 链尾 `sync()` 上收收口层 `finally`）。 */
+async function runAgentTurnBody(ctx, text, opts) {
+  const { autoTurn = false, skipSession = false, upstreamTurn = false, timerTurn = false } = opts ?? {} // upstreamTurn / timerTurn：系统轮旗标（§6.27.12.5 D/I · §6.30.3 D-TW4）——透传核 `runAgent`，仅供域文本选择
   const { agent, state, pushLine, pushLabel, render, scheduleRender, ensureAssistantLabel, askPermission, askBatchPermission, askQuestion, handleSlash } = ctx
   // 可注入覆盖（测试用）；默认走真实实现
   const runAgentImpl = ctx.runAgent ?? runAgent
@@ -107,17 +135,20 @@ async function runAgentTurnInner(ctx, text, opts) {
   state.streaming = ""
   state.reasoning = ""
   state._advisorBlocks = []
-  // NOTE (§7.2 D4): state.subTasks is intentionally NOT reset here — subagent
+  // NOTE (docs/cli/design/TUI.md §6.8 D4): state.subTasks is intentionally NOT reset here — subagent
   // activity blocks persist across turns (the user can still expand a finished
   // child's block from a previous turn). Child tool calls never enter the parent
   // history, so the blocks are the only trace of child activity; memory is
   // bounded by the N2 per-child 500-line ring buffer.
   state.currentTool = null
   state.processingStarted = Date.now()
+  // 停滞轻显形（docs/cli/design/TUI.md §7.7 · stall-indicator 批 2026-09-29）：静默起算初始锚 =
+  // 回合起刻（此后三类可见输出重置——流式 ∕ 工具面 ∕ 子代理面，见 tool-events ∕ subagent-blocks）。
+  state.lastOutputAt = Date.now()
   // AGENT-LOOP-ASYNC-POOL.md §6.8 偏差修复 #3（会话 abort 全覆盖）：回合链 controller 登记。链头 = 非挂起会话内
   // 且非释放窗口期（suspended/_suspPending 均 false）开启的回合——登记表清零；队列
   // 递归回合（_suspPending 置位期）与会话内回合（suspended=true）继续累积。链条内每次
-  // 重建（Ctrl+I 续跑 / ContinueError 续跑 / AUTO 续跑）都登记——挂起会话的 abort 集合
+  // 重建（Ctrl+I 中断续跑 ∕ 撞帽续跑——核 `continueDecision` 两续跑格）都登记——挂起会话的 abort 集合
   // （_sessionAbortAll）必须在会话建立时覆盖进入会话以来的全部 controller：只 abort
   // 最后一个会让旧 controller 下 spawn 的 async children 逃逸中止（偏差 #3）。
   // 链头同时清掉上一链条残留的会话句柄（上一链 pool 先 live 后耗尽、未进入会话即结束
@@ -127,6 +158,9 @@ async function runAgentTurnInner(ctx, text, opts) {
     state._turnControllers = []
     agent._sessionAbort = null
     agent._sessionAbortAll = null
+    // 链头复位「重武装撤销」粘滞位（#448② KD-6——上一链的显式停止只约束到下一链头；新链
+    // 正常重入 ⇒ 链尾照常重武装）。会话内回合不在此列（suspended）——链条内标志始终有效。
+    state._timerRearmRevoked = false
   }
   state._turnControllers ??= []
   const makeController = () => {
@@ -137,7 +171,7 @@ async function runAgentTurnInner(ctx, text, opts) {
   state.controller = makeController()
   state.interruptPrompt = null
   // Refresh status bar every second during processing; also refresh when any
-  // subagent block is still running so its header elapsed ticks (§7.2 D4 —
+  // subagent block is still running so its header elapsed ticks (docs/cli/design/TUI.md §6.8 D4 —
   // no new timer, the existing ticker carries it). Blocks stay visible after
   // the turn ends, but frozen headers don't need 1s refreshes.
   const subRunning = () => Object.values(state.subTasks ?? {}).some((s) => !s.done)
@@ -156,55 +190,53 @@ async function runAgentTurnInner(ctx, text, opts) {
   try {
     for (let resume = false; ; resume = true) {
       try {
-        await runAgentImpl(agent, text, callbacks, { signal: state.controller.signal, resume, autoTurn, upstreamTurn, suspDriven: true, consumeQueuedInput })
+        await runAgentImpl(agent, text, callbacks, { signal: state.controller.signal, resume, autoTurn, upstreamTurn, timerTurn, suspDriven: true, consumeQueuedInput })
         flushStream()
         break // Normal completion, exit loop
       } catch (error) {
         flushStream()
-        if (error.name === "AbortError" || state.controller?.signal.aborted) {
-          const reason = state.controller?.signal?.reason
-          // AGENT-LOOP-ASYNC-POOL.md §6.8 D-C1（round1 #1 区分机制——2026-09-03）：interrupt 两种语义——
-          //  有 message（Ctrl+I 注入——key-modes handleInterruptMode）= 重建 controller
-          //  续跑（既有语义——agent loop 已把消息注入 history，中止的 signal 不能重试）；
-          //  无 message（Ctrl+C 首按停回合——key-handler abort({ interrupt: true })
-          //  不带 message——非挂起 processing 态 / 挂起态 digest·会话内回合）
-          //  = 停回合不续跑——池保留由 agent.mjs 回合收尾的 !interrupt 清池条件排除
-          //  实现（D-C2——agent.mjs 零改动）。
-          if (reason?.interrupt && reason?.message) {
-            state.controller = makeController()
-            resume = true
-            continue
-          }
+        // 续跑判定 = 核单源（#677 · I10——continueDecision；本端零第二分支——#127 ④ 双写退役）。
+        // reason = 回合 controller 的 `signal.reason`（中止面语义原源——D-C1 两义同式）。
+        const reason = state.controller?.signal?.reason
+        const decision = continueDecision(error, { autoTurn, autoApprove: agent.autoApprove, reason })
+        if (decision === "resume") {
+          // AGENT-LOOP-ASYNC-POOL.md §6.8 D-C1（round1 #1 区分机制——2026-09-03）：interrupt 有 message
+          // （Ctrl+I 注入——key-modes handleInterruptMode）⇒ 重建 controller 续跑（agent loop 已把消息注入
+          // history，中止的 signal 不能重试）。
+          state.controller = makeController()
+          resume = true
+          continue
+        }
+        if (decision === "stop") {
           if (reason?.interrupt) {
-            // 无 message interrupt 的注入副作用回滚：agent.mjs 中断三段（chat catch /
-            // response.interrupted / 工具执行中断）无条件把 "[User interrupt: <msg>]"
-            // 落 history，对 message 存在性无守卫——无 message 时成为 "[User interrupt:
-            // undefined]" 垃圾上下文（消息注入语义只属于 Ctrl+I 续跑——停回合无注入
-            // 消息）。D-C2 agent.mjs 零改动约束下在回合层回滚尾部垃圾（确定性：中断
-            // 注入恒为最后一条——break 前 history 不再追加）。partial 部分输出不回滚
-            // ——interrupt 家族语义（§2 Ctrl+I 同款"提交部分输出"）——advisor round1
-            // 🟡 裁定：回滚需区分工具/子代理路径的既有完整消息（history 层不可靠）。
+            // 无 message interrupt 的注入副作用回滚（Ctrl+C 首按停回合——key-handler abort({ interrupt: true })
+            // 不带 message；agent.mjs 中断三段无条件把 "[User interrupt: <msg>]" 落 history，对 message
+            // 存在性无守卫 ⇒ 无 message 时成为 "[User interrupt: undefined]" 垃圾上下文）。D-C2 agent.mjs
+            // 零改动约束下在回合层回滚尾部垃圾（确定性：中断注入恒为最后一条——break 前 history 不再追加）。
+            // partial 部分输出不回滚——interrupt 家族语义（§2 Ctrl+I 同款"提交部分输出"）；advisor round1 🟡
+            // 裁定：回滚需区分工具/子代理路径的既有完整消息（history 层不可靠）。
             const h = agent.history
             while (h?.length > 0 && String(h.at(-1)?.content ?? "") === "[User interrupt: undefined]") h.pop()
           }
           pushLine("[stopped]", C.warn)
+          // #448② KD-6「显式撤销」：Ctrl+C 全停（`{ abortTrigger: "stop" }`——key-handler 二按语义）
+          // ⇒ 落粘滞位：链尾闩不重武装（链头复位后新链恢复——见 `timerRearmBlocked`）。
+          if (reason?.abortTrigger === "stop") state._timerRearmRevoked = true
           if (opts?._logOutcome) opts._logOutcome.result = "stopped"
           break
         }
-        if (error instanceof ContinueError) {
-          if (autoTurn) {
-            // AGENT-LOOP-ASYNC-POOL.md §6.8 digest turn-cap 规则（D-S9 ContinueError 行）：无面板——AUTO 档按
-            // §2 统一规则自动 resume（无人值守授权）；手动档静默拒绝（部分消化留在
-            // 历史，会话回挂起——结果不丢，只是不再烧轮次）。
-            if (agent.autoApprove) {
-              pushLine(t("digest.capAuto"), C.dim)
-              state.controller = makeController()
-              continue
-            }
-            pushLine(t("digest.capStop", { turns: error.turn }), C.warn)
-            if (opts?._logOutcome) opts._logOutcome.result = "stopped"
-            break
-          }
+        if (decision === "cap-stop") {
+          // TURN-CAP-CONTINUE.md §1 #7 / D-TC15（2026-09-26）：digest 无人值守档**不再自续**
+          // （原 AUTO 自动 resume 支退役——静默续期 = F8 禁止；无人可答 ⇒ 撞帽即收口）。
+          // 部分消化留在历史，会话回挂起——结果不丢，只是不再烧轮次。
+          // #726 写点2：cap 可见行 ∥ cap 记录同点双动作（文案 = lifecycle-records 单一实现）。
+          const capRec = digestCapRecord(error.turn)
+          for (const l of digestTraceLines(capRec)) pushLine(l.text, l.color)
+          pushRecord(recordCarrier(state, agent), capRec)
+          if (opts?._logOutcome) opts._logOutcome.result = "stopped"
+          break
+        }
+        if (decision === "ask") {
           pushLabel(`❯ Continue`, ansi.bold + C.warn)
           pushLine(`Ran ${error.turn} turns (limit ${error.turn}). Continue?`, C.warn)
           // Pause to ask: reuse permission mechanism
@@ -228,6 +260,7 @@ async function runAgentTurnInner(ctx, text, opts) {
           state.controller = makeController()
           continue
         }
+        // decision === "error"：其余异常 —— provider 失败面（X8 原语义）——
         // X8（2026-09-20 端差·显示面消差批）：provider 失败面 = 友好首行（判据同 VSC
         // panel-turn-loop.mjs:152-153：原文首行 + URL 脱敏）+ 诊断两行（Provider/Model）+ Retry
         // 询问（复用 permission 机制——同意 ⇒ 重建 controller + resume 重入，与 ContinueError
@@ -263,9 +296,9 @@ async function runAgentTurnInner(ctx, text, opts) {
     state.processing = false
     state._advisorBlocks = []
     // AGENT-LOOP-ASYNC-POOL.md §6.8 D-S1/D-S8：回合正常结束且后台池仍 live → 挂起会话：子agent 区块保持 live
-    // （不冻结——各 settle 事件自行处理），本次回合 controller 交会话层作 abort 句柄
+    // （不冻结——冻结落消费窗：起跑窗 ∥ reclaim ∥ 退出兜底），本次回合 controller 交会话层作 abort 句柄
     // （挂起期 Ctrl+C 中止全部后台子代理）；池空 / 中断 / 错误 → 现状 freezeAllSubTasks
-    // （中断态块标 interrupted；正常态块已在 settle 时各自冻结）。
+    // （中断态块标 interrupted；正常态块已在消费窗各自冻结）。
     const willSuspend = poolLive(agent)
     // AGENT-LOOP-ASYNC-POOL.md §6.8：挂起会话内回合（digest/会话内用户回合——skipSession 且 suspended）的
     // 收尾**不冻结驻留块**——已消化（pinned 且条目已注入）块由 suspensionSession 在
@@ -371,12 +404,17 @@ async function runAgentTurnInner(ctx, text, opts) {
     // 首行复位成死代码）——子代理结果退化到"下个回合尾才注入"、状态行/自动消化/区块
     // 驻留全消失；释放窗口守卫同步失效（Enter 并发开第二个 runAgentTurn——双驱动器
     // 竞态复现）。
+    if (state._suspAborted) state._timerRearmRevoked = true // #448② KD-6「会话停」：链尾闩不重武装（粘滞位——复位前捕获）
     state._suspAborted = false
   }
 
+  // §6.30.5 载体②武装点（回合链尾「无人自动接手」判据**邻位**）：已上收收口层 `finally`
+  // （#448② 异常径重武装 —— 见 `runAgentTurnInner`；本处零注册 ∕ 零动作）。
+
   // 第 33 批（TUI §14.3(d)）：顶层链尾（队列续发循环与挂起会话退出**之后**）——无人自动
   // 接手 ⇒ 置 attention 位（渲染层实时派生 blocked/awaiting；用户任意输入清位）。D-AT6：
   // 不放在回合末 finally——那之后还有队列续发 / 挂起会话（digest 自动消费），不是「需要用户」。
+  // timer-wake 批：谓词内新增「在途 timer ∧ 唤醒会武装」除外（§7.1 awaiting 行限定）。
   if (userNeededAtTurnEnd(state, agent, skipSession)) {
     state.attentionAwaiting = true
     render()