thincoder 0.12.63 → 0.12.65

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "thincoder",
-  "version": "0.12.63",
-  "description": "Thin coding agent - zero dependencies, no build step, Node.js native. Sharp code, zero bloat.",
+  "version": "0.12.65",
+  "description": "Thin coding agent - zero third-party dependencies, no build step, Node.js native. Sharp code, zero bloat.",
   "keywords": [
     "ai",
     "agent",
@@ -20,7 +20,7 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@thincoder/core": "^0.9.1"
+    "@thincoder/core": "^0.9.3"
   },
   "files": [
     "bin/",

package/src/acp/handlers-session.mjs

@@ -8,11 +8,22 @@
  * 受门 handler 首行求值，真 ⇒ 放行、假 ⇒ `-32000`。客户端可以不调 `authenticate`
  * （契约逐字「**May** return an `auth_required` error … **if** the agent requires
  * authentication」）。
+ *
+ * #168①（2026-09-22 · SESSION.md §6.15 / §6.16）：`session/close` 入释放面——关闭会话 ⇒
+ * 释放该会话认领（保留集 = 本进程其余在存会话的活绑定槽，同 cwd；落盘判据三条沿用）。
  */
 import { resolve } from "node:path"
-import { normalizeCwd, bindRecordStore, newSession, slotPath } from "@thincoder/core/session.mjs"
+import { loadManifest, normalizeCwd, bindRecordStore, newSession, saveManifest, slotPath } from "@thincoder/core/session.mjs"
+// 认领释放谓词单源（SESSION.md §6.2 / §6.16——与 VSC 端壳 `releaseClaimsAll` 同源档；
+// core `session.mjs` 未 re-export 该名——直引 manifest 档，先例 = `thincoder-vscode/src/extension/session-io.mjs`）。
+import { staleClaims } from "@thincoder/core/session-slots-manifest.mjs"
+import { PLAN_ENGINEERING_REFUSED } from "@thincoder/core/agent-tools/plan.mjs"
 import { ACP_ERRORS } from "./transport.mjs"
 
+/** ENG-PLAN-EXCLUSION（FR31 ② · E7「命令面逐面钉定」）：工程真值 = 核单源同键
+ *  `agent.config.agent.engineering`。 */
+const isEngineering = (agent) => agent?.config?.agent?.engineering === true
+
 /** Session-level config options exposed to clients — schema `SessionConfigOption.required = ["id","name"]`
  *  (响应侧用 `id`；请求侧 `SetSessionConfigOptionRequest` 用 `configId`——不对称属契约本身 · §11.3 G2-8). */
 export const CONFIG_OPTIONS = [
@@ -102,6 +113,22 @@ export function createSessionHandlers(ctx) {
     return { session: s }
   }
 
+  /** #168①（SESSION.md §6.15 / §6.16——2026-09-22 定裁 · 台账 #168①）：`session/close` ⇒
+   *  释放被关闭会话的槽认领。公式代入：释放 A ⟺ `slotSessions[A]` 为本进程 ∧ `A ∉ 保留集`；
+   *  **保留集 = 本进程其余在存会话的活绑定槽**（同 cwd——ACP 单 cwd 模型）。取值点（实施轮定位报告）：
+   *  会话记录容器 = `ctx.sessions`（`Map<id, session>`——`thincoder-cli/src/acp.mjs:98` 单容器）；
+   *  槽值 = `session.agent._slot`（认领写入同源 = `handlers-slots.mjs:96-100` / `:151-155` /
+   *  `handlers-session.mjs` 的 newSession 认领点）。落盘判据三条由核 `saveManifest` `opts.release`
+   *  自动继承（fresh 同次快照 / 值条件删除 / 内存认领表移除）——**零新增写盘路径**；本进程无残留认领
+   *  ⇒ 零写早退（判据单源 `staleClaims`——同核 `releaseClaimsAll` 早退形）。 */
+  const releaseClosedSessionSlot = () => {
+    const cwd = getCwd()
+    const m = loadManifest(cwd)
+    const keep = [...sessions.values()].map((s) => s.agent?._slot).filter((slot) => slot != null)
+    if (staleClaims(m, keep).length === 0) return
+    saveManifest(cwd, m, null, { release: keep })
+  }
+
   return {
     "session/new": async (params) => {
       const gate = requireConfigured()
@@ -194,7 +221,9 @@ export function createSessionHandlers(ctx) {
         // Abort any in-flight turn first — the client is gone, the agent must
         // stop consuming LLM tokens and emitting notifications.
         found.session.cancel()
+        // 先出容器再释放（保留集 = 其余在存会话——被关闭者不留在保留集内）。
         sessions.delete(String(params.sessionId))
+        releaseClosedSessionSlot() // #168①：释放该会话认领（保留集 = 同 cwd 其余在存会话槽）
         log(`session ${params.sessionId} closed by client`)
       }
       return {}
@@ -209,6 +238,13 @@ export function createSessionHandlers(ctx) {
       if (!configId || value === undefined) {
         return { error: { ...ACP_ERRORS.INVALID_PARAMS, message: "set_config_option requires configId and value" } }
       }
+      // ENG-PLAN-EXCLUSION（FR31 ② / 评审轮 1 发现 #4 出口钉定）：工程模式 ⇒ plan 面**前置判**
+      // ⇒ 携共用文案的 INVALID_PARAMS。`applyConfigOption` 布尔契约零改（`false` 仍 = unknown
+      // configId——工程拒绝不经该路径，下方 `:unknown configId` 误导文案对 mode=plan 不再可达）；
+      // `mode:"normal"` 照常接受（唯一合法态，幂等）。
+      if (configId === "mode" && value === "plan" && isEngineering(found.session.agent)) {
+        return { error: { ...ACP_ERRORS.INVALID_PARAMS, message: PLAN_ENGINEERING_REFUSED } }
+      }
       const applied = applyConfigOption(found.session.agent, configId, value)
       if (!applied) {
         return { error: { ...ACP_ERRORS.INVALID_PARAMS, message: `unknown configId: ${configId}` } }
@@ -229,6 +265,11 @@ export function createSessionHandlers(ctx) {
       if (params.mode !== "plan" && params.mode !== "normal") {
         return { error: { ...ACP_ERRORS.INVALID_PARAMS, message: "mode must be plan or normal" } }
       }
+      // ENG-PLAN-EXCLUSION（FR31 ② / 同 #4）：工程模式 + `mode:"plan"` ⇒ 前置判 ⇒ 携共用文案
+      // 的 INVALID_PARAMS（状态零变、零通知）；`normal` 照常（幂等）。
+      if (params.mode === "plan" && isEngineering(found.session.agent)) {
+        return { error: { ...ACP_ERRORS.INVALID_PARAMS, message: PLAN_ENGINEERING_REFUSED } }
+      }
       found.session.agent.planMode = params.mode === "plan"
       notifyRef.current("session/update", {
         sessionId: String(params.sessionId),

package/src/acp/handlers-slots.mjs

@@ -29,7 +29,7 @@ export function createSlotsHandlers(ctx) {
 
   /** #41 装载后一行重估（F3 准翻列 / F4）：`applySession` 已按槽订正 config ⇒ 工程模式会话
    *  就地判据（单源）+ 附着——缺档格 `writer:'main'` 建档；非工程模式零动作（零 manifest I/O）。
-   *  判据不通过 ⇒ 保持不附着（装载已发生——本行是「装载后订正」位，与入口门槛两分）+ 留痕。 */
+   *  判据不通过 ⇒ 保持不附着（装载已发生——本行是「装载后订正」位；启动侧恒不拒，拒面 = 「翻转可否进」）+ 留痕。 */
   const reattach = (ag) => {
     if (ag?.config?.agent?.engineering !== true) return
     const r = resolveEngineeringManifest(getCwd(), { writer: "main" })

package/src/cli/make-agent.mjs

@@ -8,7 +8,7 @@ import { discoverRules } from "@thincoder/core/rules.mjs"
 // （静态表 ∪ memory / code_search / doc_search / repo_outline / settings / peer_instances 六面 ∪ 门控 read_image）。
 // 传 `model` 必需：漏传 ⇒ `read_image` 对所有模型静默消失（门判据 = specForModel(model)?.multimodal）。
 import { assembleBuiltinTools } from "@thincoder/core/tools/index.mjs"
-import { resolveEngineeringManifest } from "@thincoder/core/manifest.mjs"
+import { resolveEngineeringManifest, projectView } from "@thincoder/core/manifest.mjs"
 
 /** 第 27 批 §12.3⑤（R-A1.1）：装配期工具剔除——按 `name` 过滤的纯函数（机验锚）。
  *  恒等语义：空列表 / 零命中 → 原数组原样返回（零意外剔除——T15）。
@@ -123,9 +123,9 @@ export async function assembleAgent({ excludeTools = [], slotData } = {}) {
   agent.activeModel = provider.model ?? null
   agent._mcpWarnings = mcpWarnings
   // M1 装配钩子（会话起点①——装配期）：判据 = 会话权威值（`slotData` 槽值优先 + config 回退）；
-  // 附着 agent.manifest 供下游 M2–M9 读面（普通会话 = null）。钩子后移的可观察后果（拒 / 建档
-  // 晚于 memory sync / MCP 连接 / 工具装配——功能等价，仍在进入正常循环之前）见
-  // docs/core/design/MANIFEST.md §2.2。
+  // 附着 agent.manifest 供下游 M2–M9 读面（普通会话 = null）；非 ok 态不抛（启动零拒绝）。
+  // 钩子后移的可观察后果（报明 / 建档晚于 memory sync / MCP 连接 / 工具装配——功能等价，仍在
+  // 进入正常循环之前）见 docs/core/design/MANIFEST.md §2.2。
   attachManifest(agent, { cwd, slotData })
   // SESSION.md §6.8 D-S1：assembleAgent 后唯一校验点（TUI/chat 两路径同源）——不抛错不退出，
   // 标记由调用侧消费（TUI 弹重选 / headless 报错）。空 provider 由 TUI 路径在 startTUI 前清空。
@@ -145,20 +145,20 @@ export async function assembleAgent({ excludeTools = [], slotData } = {}) {
  * 「恢复槽带 `engineering` 字段 ? 槽值 : `agent.config.agent.engineering`」（槽字段在场判据
  * 与 `applySession` 同款——`thincoder-core/session.mjs:314-317`）。普通会话 → **装配钩子
  * 零 manifest I/O**（不读 / 不拒 / 不建档）+ `agent.manifest = null`（清残留附着——复用
- * agent 跨模式防陈旧）；工程模式四态：合法档 → 附着；缺档 + 根可解析 → `initManifest`
- * 建档（拒进正常循环直到生成——E2 前置门槛）；缺档 + 根不可解析 → 抛「工程模式启动拒绝」
- * **不自动建档**；非法档 → fail-closed 抛出。
+ * agent 跨模式防陈旧）。
+ *
+ * 工程模式分支 = 核单源决策树 `resolveEngineeringManifest`（KD-M1-20）；**非 fatal**
+ * （KD-M1-25 / M1-29——**启动零拒绝**）：档合法 / 梯②④⑤ 缺档（轻动作就地建档，`writer:'main'`）
+ * ⇒ 附着；歧义（≥2 候选）/ 档非法 / 建档失败 ⇒ **不抛**——`agent.manifest = null` + 记
+ * `agent._projectView`（形状 = `projectView` 返回面 + `created` 建档标记——§2.2 钩子段）。
+ * 需要项目参数者各自报明（情境行 §2.6 / 动作侧各自报错——§2.9 C）。
  *
  * `slotData` = 恢复槽记录，由调用方经**参数注入**（`bin` TUI 分支既有 `resumeSlot` 调用
  * 前移——KD-M1-15：钩子内不调 `resumeSlot`（该函数非纯读：GC / 认领 / 端标写）；`chat` /
  * ACP 装配无会话 ⇒ 不传 ⇒ config 回退）。重估点不传（`applySession` 已按槽订正 config）。
- *
- * #41（薄包装——KD-M1-20 / AC-19）：工程模式分支的决策树 = 核单源
- * `resolveEngineeringManifest`（非抛错形态）；本函数只把它翻回「抛错」——四条出口
- * （附着 / 缺档建档 / 根不可解析抛 / 档非法抛）的**结果与文案逐字不变**（原句由决策树构造）。
- * @param {object} agent — createAgent 产物（读 agent.config；写 agent.manifest）
+ * @param {object} agent — createAgent 产物（读 agent.config；写 agent.manifest / agent._projectView）
  * @param {{cwd?: string, slotData?: object|null}} [opts]
- * @returns {object|null} 附着后的 manifest / 普通会话 null
+ * @returns {object|null} 附着后的 manifest / 非 ok 态与普通会话 null
  */
 export function attachManifest(agent, { cwd = process.cwd(), slotData } = {}) {
   const slotEng = slotData?.engineering
@@ -167,10 +167,11 @@ export function attachManifest(agent, { cwd = process.cwd(), slotData } = {}) {
     agent.manifest = null // 清残留附着（KD-M1-12）——普通会话不读 / 不拒 / 不建档
     return null
   }
-  // 缺档 + 根可解析 → 就地建档（writer 显式 'main'——写门 fail-closed 缺省拒，KD-M1-3）。
+  // 决策树（writer 显式 'main'——写门 fail-closed 缺省拒，KD-M1-3；漏传 ⇒ 缺档格退化
+  // `init-failed`）。任何非 ok 态都不抛（KD-M1-25）。
   const r = resolveEngineeringManifest(cwd, { writer: "main" })
-  if (!r.ok) throw new Error(r.message)
-  agent.manifest = r.manifest
+  agent._projectView = { ...projectView(cwd), created: r.ok && r.created === true }
+  agent.manifest = r.ok ? r.manifest : null
   return agent.manifest
 }
 

package/src/tui/agent-turn.mjs

@@ -21,6 +21,7 @@ import { buildToolCallbacks, sweepToolBlocks } from "./tool-events.mjs"
 import { freezeAllSubTasks } from "./subagent-blocks.mjs" // freezeReclaimDigestedBlocks 随 §17 段迁 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 { suspensionSession, poolLive } from "./suspension-drive.mjs"
 
 /** Exit-flush bound for the async end-of-run distillation (SEND-STALL-DISTILL §2.5):
@@ -191,11 +192,11 @@ async function runAgentTurnInner(ctx, text, opts) {
             // §2 统一规则自动 resume（无人值守授权）；手动档静默拒绝（部分消化留在
             // 历史，会话回挂起——结果不丢，只是不再烧轮次）。
             if (agent.autoApprove) {
-              pushLine("[auto-turn: continuing past turn cap…]", C.dim)
+              pushLine(t("digest.capAuto"), C.dim)
               state.controller = makeController()
               continue
             }
-            pushLine(`[auto-turn stopped at ${error.turn} turns — partial digest; finished reports stay in history]`, C.warn)
+            pushLine(t("digest.capStop", { turns: error.turn }), C.warn)
             if (opts?._logOutcome) opts._logOutcome.result = "stopped"
             break
           }
@@ -339,6 +340,8 @@ async function runAgentTurnInner(ctx, text, opts) {
   // 承诺）——逐条直发；斜杠命令直接执行（保序）；回合后的续发由递归层同循环续取。
   while (state.queue.length > 0 && !state.processing) {
     const head = state.queue.shift()
+    // F16（TUI.md §7.5）：消费回执——queued dim 行（消费事实的可见锚；对位 [continuing…]）
+    pushLine("[sending queued message]", C.tool)
     // 残项斜杠命令直接执行——保序、绝不合并
     if (head.text.startsWith("/")) {
       await handleSlash(head.text)

package/src/tui/cmd-advisor.mjs

@@ -27,7 +27,7 @@ export async function handleAdvisorCommand(ctx) {
   // Other advisor keys (model/thinking/effort/timeout) stay config-scoped — persist() only.
   const persistGuard = async () => {
     try {
-      const p = slotPath(agent.cwd, activeSlot(agent.cwd))
+      const p = slotPath(agent.cwd, agent._slot ?? activeSlot(agent.cwd))
       const data = JSON.parse(readFileSync(p, "utf8"))
       if (data && typeof data === "object" && Array.isArray(data.history)) {
         data.advisor = { ...(typeof data.advisor === "object" && data.advisor !== null ? data.advisor : {}), guard: cfg.guard === true }

package/src/tui/cmd-eng.mjs

@@ -12,6 +12,7 @@ import { purgeExpiredDesignTokens } from "@thincoder/core/token-ttl.mjs"
 import { resolveEngineeringManifest } from "@thincoder/core/manifest.mjs"
 
 import { ENG_OFF_REMINDER } from "@thincoder/core/agent.mjs"
+import { clearPlanMode } from "@thincoder/core/agent-tools/plan.mjs"
 
 /** Atomic slot write (same shape as session.mjs writeSessionFile — kept local to avoid a
  *  private-import; cmd-advisor's guard toggle shares this helper). */
@@ -48,6 +49,9 @@ export async function handleEngCommand(ctx) {
     agent.manifest = r.manifest
   }
   agent.config.agent.engineering = !agent.config.agent.engineering
+  // FR31 ③ / KD10（翻转点②·CLI `/eng`）：ON ⇒ 清 plan 残留（内存位 + 未注入的 plan 提示语）；
+  // OFF 方向不动（普通模式零改——FR31 边界）。提示行仅在真清到东西时出（不喧宾）。
+  const planReset = agent.config.agent.engineering ? clearPlanMode(agent) : false
   // §11.2 D-24b: per-review instances die with the mode (fresh convergence cycles
   // on the next toggle).
   agent._advisorRuns = new Map()
@@ -68,6 +72,9 @@ export async function handleEngCommand(ctx) {
   pushLine(`Engineering mode: ${agent.config.agent.engineering ? "ON" : "OFF"} (session)`, C.tool)
   if (agent.config.agent.engineering) {
     pushLine(`  → design-before-code enforced (design review + user approval before code)`, C.dim)
+    if (planReset) {
+      pushLine(`  → plan mode reset (engineering mode excludes plan mode)`, C.dim)
+    }
     if (clearedExpired > 0) {
       pushLine(`  → cleared ${clearedExpired} expired design token${clearedExpired === 1 ? "" : "s"}; valid tokens from prior reviews stay usable`, C.dim)
     }
@@ -80,14 +87,18 @@ export async function handleEngCommand(ctx) {
  * VS Code, per-session; config.json is just the initial default, no mirror write).
  * The in-memory agent.config.agent.engineering (already flipped) stays the live authority for
  * this process; saveSession also round-trips it on every turn-end write.
+ * 槽写也担 FR31 ③ 的槽位收正（T12）：ON 时 `data.planMode = false`——否则下次装载/恢复
+ * 把 plan-active 推回 UI（半状态复活面；验收判据 = 「内存 + 槽位」双清零）。OFF 方向零改。
  */
 async function persistEngineering(agent) {
-  const slot = activeSlot(agent.cwd)
+  // #167：绑定优先（先例 = cmd-session.mjs）——粘性槽优先于 activeSlot（后者有认领副作用）。
+  const slot = agent._slot ?? activeSlot(agent.cwd)
   try {
     const p = slotPath(agent.cwd, slot)
     const data = JSON.parse(readFileSync(p, "utf8"))
     if (data && typeof data === "object" && Array.isArray(data.history)) {
       data.engineering = agent.config.agent.engineering
+      if (agent.config.agent.engineering) data.planMode = false
       writeSessionFile(p, data)
     }
   } catch { /* slot missing/unreadable — in-memory flag already flipped; saveSession persists at turn end */ }

package/src/tui/cmd-mcp-form.mjs

@@ -1,4 +1,6 @@
 import { C } from "./ansi.mjs"
+// #58（hygiene-sweep 批）：headers/env 现值脱敏判据 = 核 settings 同源单点（不再各自为政）。
+import { isSensitiveKey } from "@thincoder/core/agent-tools/settings.mjs"
 
 /** MCP.md §5 v2（D-1）：edit/add 统一字段 picker 表单机制。
  *  fieldPicker 循环：picker 列字段行（label + 当前值打码）+ `✓ Save & test` 末行；
@@ -111,15 +113,19 @@ function formEntries(entry, transport, mode) {
   ]
 }
 
-/** 字段输入提示 `(current: …)`——token 打码（maskToken）、headers/env 列键值对、
+/** #58（hygiene-sweep 批）：headers/env 现值列示——敏感键名（谓词 = 核 settings 同源
+ *  `isSensitiveKey`）的值位一律 `••••`（人读面不再明文）；非敏感键名保可读（`k=v`）。 */
+function currentPairs(v) {
+  const pairs = Object.entries(v ?? {}).map(([k, val]) => (isSensitiveKey(k) ? `${k}=••••` : `${k}=${val}`))
+  return pairs.length ? pairs.join(", ") : "none"
+}
+
+/** 字段输入提示 `(current: …)`——token 打码（maskToken）、headers/env 列键值对（敏感值位遮）、
  *  args 空格串接；空值 → "none"。 */
 function currentText(entry, field) {
   const v = entry[field]
   if (field === "token") return v ? maskToken(v) : "none"
-  if (field === "headers" || field === "env") {
-    const pairs = Object.entries(v ?? {}).map(([k, val]) => `${k}=${val}`)
-    return pairs.length ? pairs.join(", ") : "none"
-  }
+  if (field === "headers" || field === "env") return currentPairs(v)
   if (field === "args") return (v ?? []).length ? v.join(" ") : "none"
   return String(v ?? "") || "none"
 }

package/src/tui/cmd-new.mjs

@@ -8,7 +8,7 @@ export async function handleNewCommand(ctx) {
 
   // F-MI7：newSession = async（探测束）——doNewSession 随之为 async，调用点 await
   const doNewSession = async () => {
-    const slot = await newSession(agent.cwd)
+    const slot = await newSession(agent.cwd, { releaseStale: true }) // F-CR1：/new 释放本进程残留认领（保留集 = {新槽}）；ACP 四点不传（F-CR3）
     // 2026-08-31 会诊 F3：resetSessionState 清全量会话态（_fullHistory/title/_sessionStart/
     // 多槽设计凭证（_engDesignTokens——单值镜像 _engDesignToken 已退役 D3）/压缩与验证计数
     // 等）——原实现只清 agent.history，新会话首次落盘把旧会话完整人类线 + 旧标题写进新

package/src/tui/cmd-plan.mjs

@@ -1,9 +1,18 @@
 /** /plan command: toggle plan mode (read-only explore → design → implement).
  *  ctx: { agent, pushLine, pushLabel } */
 import { ansi, C } from "./ansi.mjs"
+import { PLAN_ENGINEERING_REFUSED } from "@thincoder/core/agent-tools/plan.mjs"
 
 export async function handlePlanCommand(ctx) {
   const { agent, pushLine, pushLabel } = ctx
+  // ENG-PLAN-EXCLUSION（FR31 ② · 设计 `ENGINEERING-MODE-V2.md` §2.3 E7「命令面逐面钉定」）：
+  // 工程模式 ⇒ 拒绝——**前置判**：零翻转（不写 `planMode`）+ 提示行（共用文案常量逐字，
+  // 与 ACP 两面同源）；无成功标签（标签 = 成功回显——拒时零标签防假成功，同 `/eng` 先例）。
+  // 真值 = `agent.config.agent.engineering`（核单源同键）；普通模式四路径全带宽（FR31 边界）。
+  if (agent.config?.agent?.engineering === true) {
+    pushLine(PLAN_ENGINEERING_REFUSED, C.warn)
+    return
+  }
   agent.planMode = !agent.planMode
   pushLabel("❯ Plan", ansi.bold + C.tool)
   pushLine(`Plan mode: ${agent.planMode ? "ON" : "OFF"}`, C.tool)

package/src/tui/conversation-writer.mjs

@@ -0,0 +1,62 @@
+import { ansi, C } from "./ansi.mjs"
+import { capLine, accountLine, accountAll, syncLineBudget } from "./display-budget.mjs"
+import { shiftFreezeAnchors } from "./subagent-blocks.mjs"
+
+/** 对话写入面（2026-09-22 structure-debt §2.2 · #159）：pushLine（行额度单点）/ pushLabel
+ *  （消息标签 + 呼吸空行）/ ensureAssistantLabel（回合内单次 assistant 标签位）——三块自
+ *  index.mjs startTUI 逐字搬移（仅去包裹）。
+ *  `render` 由调用侧以惰性转发承接（renderLoop 于 startTUI 后段装配——TDZ 语义保持）。
+ *  @param {{ state: object, render: Function }} ctx
+ *  @returns {{ pushLine: Function, pushLabel: Function, ensureAssistantLabel: Function,
+ *              assistantLabeled: boolean }} */
+export function createConversationWriter({ state, render }) {
+  const pushLine = (text, color, kind) => {
+    // TUI-OOM-ROOTCAUSE（TUI.md §15.3.1/§15.3.3）：行额度单点——行文本过 capLine
+    // （LINE_MAX_CHARS——单行巨内容/无换行巨 chunk 的堵口）+ 总量账 + 预算对账。
+    const line = { text: capLine(text), color, _kind: kind }
+    state.lines.push(line)
+    accountLine(state, line)
+    if (state.lines.length > 5000) {
+      state.lines.splice(0, 1000)
+      state.lines.unshift({ text: `... [earlier messages trimmed — ${state.lines.length} lines remaining]`, color: C.dim })
+      // 2026-09-03 修复轮（冻结锚点）：头裁对在途 settled 锚点整体前移（锚点是绝对
+      // 流位置）——不校正则池空补发冻结（freezeSubTaskLines splice）落点漂移；校正量
+      // = 净位移（裁 1000 补 1 标记行 → −999，code review round1 #3）。
+      shiftFreezeAnchors(state, 1000)
+      accountAll(state) // 行对象集合已变（splice/unshift 直写）——直算重对账
+    }
+    syncLineBudget(state, { onTrim: (st, n) => shiftFreezeAnchors(st, n) })
+    render()
+  }
+
+  /** Message block label: blank line + label line. Breathing space between user/assistant messages */
+  const pushLabel = (text, color) => {
+    // 行额度同 pushLine（§15.3.1——恢复行/标签行同口径）
+    if (state.lines.length > 0) {
+      const blank = { text: "", color: C.dim }
+      state.lines.push(blank)
+      accountLine(state, blank)
+    }
+    const line = { text: capLine(text), color }
+    state.lines.push(line)
+    accountLine(state, line)
+    syncLineBudget(state, { onTrim: (st, n) => shiftFreezeAnchors(st, n) })
+    render()
+  }
+
+  // Only emit the assistant label once per turn (on first token or first tool call)
+  let assistantLabeled = false
+  const ensureAssistantLabel = () => {
+    if (!assistantLabeled) {
+      assistantLabeled = true
+      pushLabel(`❯ ThinCoder:`, ansi.bold + C.assistant)
+    }
+  }
+  return {
+    pushLine,
+    pushLabel,
+    ensureAssistantLabel,
+    get assistantLabeled() { return assistantLabeled },
+    set assistantLabeled(v) { assistantLabeled = v },
+  }
+}