thincoder 0.12.61 → 0.12.63

package/src/model-specs.mjs

@@ -1,179 +0,0 @@
-/**
- * model-specs.mjs — known model capability table + spec lookup (2026-08-31 extract).
- *
- * Split from config.mjs (which had grown to 358 lines, past the 300 advisory
- * line — TODO #1). config.mjs re-exports specForModel so the 23 existing
- * importers stay untouched. PROVIDER_PRESETS stays in config.mjs (only 23
- * lines; extracting it would churn wizard/pickers/setup-wizard for no gain).
- */
-
-/**
- * Known model capability spec table (prefix match, longer first).
- * Used for compaction threshold derivation, continuation protocol selection, and capability-aware optimization.
- *
- * context:           context window (tokens)
- * maxOutput:         max output tokens (defaults to context)
- * thinking:          whether thinking/reasoning mode is supported
- * partialMode:       Kimi/Qwen Partial Mode truncation continuation (assistant message with partial:true)
- * prefixMode:        DeepSeek Prefix Completion truncation continuation (uses /beta endpoint, with prefix:true)
- * multimodal:        whether multimodal (image/vision input supported)
- * cacheMode:         context caching mode: "auto"=automatic / "prompt"=needs explicit / "none"=unsupported
- * thinkApi:          thinking API type: "type"=thinking.type field / "effort"=reasoning_effort field
- * thinkEnabledValue: when thinkApi is "type", the value used to enable thinking (default "enabled"; MiniMax uses "adaptive")
- * reasoningEcho:     reasoning_content cross-turn echo strategy: "required"=must echo (error if missing) / "optional"=echo optional (default: don't echo)
- * reasoningEffortEnum: valid reasoning_effort enum values (if undeclared, no validation — passed through as-is)
- * tempRange:         valid temperature range [min, max] (if undeclared, no clamping)
- */
-const MODEL_SPECS = [
-  // DeepSeek V4.1 series (2026-09-11). `deepseek-flash` = DeepSeek-V4.1-Flash (in service):
-  // 1M ctx / 384K out, thinking on by default (effort low/high/max), Chat Prefix Completion
-  // beta, automatic disk cache, vision. The two legacy names below are RETIRED — the server
-  // still accepts them and serves them from V4.1-Flash today (no switch window), so their
-  // rows carry the V4.1-Flash parameters (v4-flash gains multimodal).
-  ["deepseek-flash",    { context: 1_000_000, maxOutput: 384_000, thinking: true,  prefixMode: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "required", reasoningEffortEnum: ["low", "high", "max"], tempRange: [0, 2], multimodal: true }],
-  // deepseek-v4-pro (V4-Pro-0813): fields unchanged — vision capability NOT verified, so no
-  // multimodal (conservative). From 2026-09-14 12:00 Beijing all requests route to V4.1-Flash.
-  ["deepseek-v4-pro",   { context: 1_000_000, maxOutput: 384_000, thinking: true,  prefixMode: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "required", reasoningEffortEnum: ["low", "high", "max"], tempRange: [0, 2] }],
-  // deepseek-v4-flash: RETIRED name — still accepted, served by V4.1-Flash today → aligned row
-  ["deepseek-v4-flash", { context: 1_000_000, maxOutput: 384_000, thinking: true,  prefixMode: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "required", reasoningEffortEnum: ["low", "high", "max"], tempRange: [0, 2], multimodal: true }],
-  // deepseek-v4-flash-vision-exp: retired experimental vision name — still accepted (V4.1-Flash)
-  ["deepseek-v4-flash-vision-exp", { context: 1_000_000, maxOutput: 384_000, thinking: true,  prefixMode: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "required", reasoningEffortEnum: ["low", "high", "max"], tempRange: [0, 2], multimodal: true }],
-  // Kimi series
-  ["kimi-k3",           { context: 1_000_000, maxOutput: 131_072, thinking: true,  partialMode: true, multimodal: true, cacheMode: "auto",  thinkApi: "effort", reasoningEcho: "required", reasoningEffortEnum: ["low", "high", "max"] }],
-  // Qwen router prefixes model IDs with provider namespace: kimi/kimi-k3 → kimi-k3 (IK7K4V)
-  ["kimi/kimi-k3",      { context: 1_000_000, maxOutput: 131_072, thinking: true,  partialMode: true, multimodal: true, cacheMode: "auto",  thinkApi: "effort", reasoningEcho: "required", reasoningEffortEnum: ["low", "high", "max"] }],
-  // Kimi For Coding endpoint uses the short model ID "k3" (same specs as kimi-k3) — IK5VGJ
-  ["k3",                { context: 1_000_000, maxOutput: 131_072, thinking: true,  partialMode: true, multimodal: true, cacheMode: "auto",  thinkApi: "effort", reasoningEcho: "required", reasoningEffortEnum: ["low", "high", "max"] }],
-  // GLM series
-  // GLM-5.3: thinking always-on (no "disabled"); effort converges to low/high/max — NOT the
-  //          7-level glm-5.2 enum (verified vs docs.bigmodel.cn GLM-5.3 page, 2026-08)
-  ["glm-5.3",           { context: 1_000_000, maxOutput: 128_000, thinking: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "optional", reasoningEffortEnum: ["low", "high", "max"], tempRange: [0, 1], noUsageStream: true }],
-  ["glm-5.3-flash",     { context: 1_000_000, maxOutput: 128_000, thinking: true, multimodal: true, cacheMode: "auto", thinkApi: "type", reasoningEcho: "optional", reasoningEffortEnum: ["low", "high", "max"], tempRange: [0, 1], noUsageStream: true }],
-  ["glm-5.2",           { context: 1_000_000, maxOutput: 128_000, thinking: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "optional", reasoningEffortEnum: ["max", "xhigh", "high", "medium", "low", "minimal", "none"], tempRange: [0, 1], noUsageStream: true }],
-  ["glm-5",             { context: 1_000_000, maxOutput: 128_000, thinking: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "optional", reasoningEffortEnum: ["max", "xhigh", "high", "medium", "low", "minimal", "none"], tempRange: [0, 1], noUsageStream: true }],
-  ["glm-4",             { context: 128_000,   maxOutput: 32_000,  thinking: true,  cacheMode: "auto", thinkApi: "type", reasoningEcho: "optional", tempRange: [0, 1], noUsageStream: true }],
-  // GPT series
-  ["gpt-5.6-sol",       { context: 1_050_000, maxOutput: 128_000, thinking: false, multimodal: true, cacheMode: "prompt" }],
-  ["gpt-5.6",           { context: 1_050_000, maxOutput: 128_000, thinking: false, multimodal: true, cacheMode: "prompt" }],
-  ["gpt-4.1",           { context: 1_000_000, maxOutput: 128_000, thinking: false, cacheMode: "prompt" }],
-  ["gpt-4o",            { context: 128_000,   maxOutput: 16_000,  thinking: false, multimodal: true, cacheMode: "prompt" }],
-  // Qwen series
-  ["qwen3.8-max-preview", { context: 1_000_000, maxOutput: 131_072, thinking: true, partialMode: true, multimodal: true, cacheMode: "none", thinkApi: "effort", reasoningEffortEnum: ["xhigh", "medium", "low"], tempRange: [0, 2] }],
-  // qwen3.7-max rejects image parts outright (DashScope 400 "Unexpected item type in content") — text-only
-  ["qwen3.7-max",       { context: 1_000_000, maxOutput: 131_072, thinking: true, partialMode: true, cacheMode: "none", thinkApi: "effort", reasoningEffortEnum: ["xhigh", "high"], tempRange: [0, 2] }],
-  ["qwen3.8-max",       { context: 1_000_000, maxOutput: 131_072, thinking: true, partialMode: true, multimodal: true, cacheMode: "none", thinkApi: "effort", reasoningEffortEnum: ["xhigh", "medium", "low"], tempRange: [0, 2] }],
-  ["qwen-max",          { context: 1_000_000, maxOutput: 131_072, thinking: false, partialMode: true, multimodal: true, cacheMode: "none", thinkApi: "effort", tempRange: [0, 2] }],
-  ["qwen-plus",         { context: 1_000_000, maxOutput: 131_072,  thinking: false, partialMode: true, multimodal: true, cacheMode: "none", thinkApi: "effort", tempRange: [0, 2] }],
-  ["qwen",              { context: 1_000_000, maxOutput: 131_072, thinking: false, partialMode: true, multimodal: true, cacheMode: "none", thinkApi: "effort", tempRange: [0, 2] }],
-  // MiniMax series
-  ["MiniMax-M3",        { context: 1_000_000, maxOutput: 128_000, thinking: true,  multimodal: true, cacheMode: "auto", thinkApi: "type", thinkEnabledValue: "adaptive", tempRange: [0, 2], noUsageStream: true }],
-  // MiMo series (Xiaomi — OpenAI-compatible https://api.xiaomimimo.com/v1;
-  // deep thinking via thinking.type, default ON; multi-turn tool calls MUST echo
-  // reasoning_content back exactly like DeepSeek V4, else 400 on follow-ups)
-  ["mimo-v2.5-pro",     { context: 1_000_000, maxOutput: 128_000, thinking: true,  thinkApi: "type", reasoningEcho: "required", tempRange: [0, 1.5] }],
-  ["mimo-v2.5",         { context: 1_000_000, maxOutput: 128_000, thinking: true,  multimodal: true, thinkApi: "type", reasoningEcho: "required", tempRange: [0, 1.5] }],
-  ["minimax-m3",        { context: 1_000_000, maxOutput: 128_000, thinking: true,  multimodal: true, cacheMode: "auto", thinkApi: "type", thinkEnabledValue: "adaptive", tempRange: [0, 2], noUsageStream: true }],
-  ["minimax-m1",        { context: 256_000,   maxOutput: 128_000, thinking: false, cacheMode: "auto", noUsageStream: true }],
-  // Grok series (xAI — OpenAI-compatible)
-  // grok-4.x: 500K context per xAI Grok 4.6 spec (corrected 2026-08; earlier entries said 1M)
-  ["grok-4.6",          { context: 500_000,   maxOutput: 64_000,  thinking: false, multimodal: true, tempRange: [0, 2] }],
-  ["grok-4.5",          { context: 500_000,   maxOutput: 64_000,  thinking: false, multimodal: true, tempRange: [0, 2] }],
-  ["grok-4",            { context: 500_000,   maxOutput: 64_000,  thinking: false, multimodal: true, tempRange: [0, 2] }],
-  ["grok-4-mini",       { context: 128_000,   maxOutput: 16_000,  thinking: false, tempRange: [0, 2] }],
-  // Mistral series (OpenAI-compatible)
-  ["mistral-large",     { context: 128_000,   maxOutput: 32_000,  thinking: false, multimodal: true, tempRange: [0, 2] }],
-  ["codestral",         { context: 256_000,   maxOutput: 32_000,  thinking: false, tempRange: [0, 2] }],
-  // Claude series (Anthropic)
-  ["claude-opus-5",     { context: 1_000_000, maxOutput: 128_000, thinking: false, multimodal: true, cacheMode: "none", format: "anthropic" }],
-  ["claude-sonnet-5",   { context: 1_000_000, maxOutput: 128_000, thinking: false, multimodal: true, cacheMode: "none", format: "anthropic" }],
-  ["claude-opus-4",     { context: 200_000,   maxOutput: 32_000,  thinking: false, multimodal: true, cacheMode: "none", format: "anthropic" }],
-  ["claude-sonnet-4",   { context: 200_000,   maxOutput: 32_000,  thinking: false, multimodal: true, cacheMode: "none", format: "anthropic" }],
-  ["claude-3.5-haiku",  { context: 200_000,   maxOutput: 8_192,   thinking: false, cacheMode: "none", format: "anthropic" }],
-  // Gemini series (Google)
-  ["gemini-3-pro",      { context: 1_000_000, maxOutput: 64_000,  thinking: false, multimodal: true, cacheMode: "none", format: "google", noUsageStream: true }],
-  ["gemini-2.5-pro",    { context: 2_000_000, maxOutput: 64_000,  thinking: false, multimodal: true, cacheMode: "none", format: "google", noUsageStream: true }],
-  ["gemini-2.5-flash",  { context: 1_000_000, maxOutput: 64_000,  thinking: false, multimodal: true, cacheMode: "none", format: "google", noUsageStream: true }],
-]
-const DEFAULT_SPEC = { context: 128_000, maxOutput: 32_000, cacheMode: "none" }
-
-/** Look up spec by model name prefix (case-insensitive), conservative default for unknown models.
- *
- * Vendor-namespace prefix stripping (2026-09-04)：第三方 token 市场（roapi/new-api/one-api/
- * aiproxy 聚合网关）惯例在模型名前加厂商前缀（zhipu/glm-5.3、openai/gpt-4o）。完整名未命中
- * 且含 "/" 时，剥掉第一个 "/" 前的 namespace 再按前缀匹配一次——ZHIPU/GLM-5.3 → glm-5.3 命中
- * 真实规格，不再降级 128K 默认。kimi/kimi-k3 的显式 alias 行保留为文档锚（发送路径
- * provider.core isRouter 依赖含 "/" 判定），通用机制已覆盖同类。 */
-const warnedModels = new Set() // warn once per model name — spec lookup runs on every request (hot path)
-// Pre-sorted once at module scope — spec lookup runs on every request (agent, provider core,
-// context, auto-think, TUI rendering); re-sorting per call was wasteful.
-const SORTED_SPECS = [...MODEL_SPECS].sort((a, b) => b[0].length - a[0].length)
-
-/** Single table lookup shared by specForModel / specMatch — prefix match (case-insensitive)
- *  with vendor-namespace stripping. Returns null on a miss (DEFAULT_SPEC is the caller-side
- *  fallback and is deliberately NOT returned here — `matched` needs the miss itself). */
-function lookupSpec(model) {
-  const m = (model ?? "").toLowerCase()
-  for (const [prefix, spec] of SORTED_SPECS) {
-    if (m.startsWith(prefix.toLowerCase())) return spec
-  }
-  // Vendor-namespace strip: vendor/model — retry the prefix match on the bare model part.
-  const slash = m.indexOf("/")
-  if (slash > 0) {
-    const bare = m.slice(slash + 1)
-    for (const [prefix, spec] of SORTED_SPECS) {
-      if (bare.startsWith(prefix.toLowerCase())) return spec
-    }
-  }
-  return null
-}
-
-/** Unknown model: warn ONCE (not per request) so a typo'd ID or a missing alias surfaces
- *  instead of silently degrading to the 128K default (IK5VGJ). The dedupe set is shared by
- *  specForModel / specMatch (PROVIDER.md §16 M5). */
-function warnUnknownModel(model) {
-  const m = (model ?? "").toLowerCase()
-  if (m && !warnedModels.has(m)) {
-    warnedModels.add(m)
-    console.warn(`[config] model "${model}" not found in MODEL_SPECS — using default spec (128K context, 32K output). Check the model ID or add an alias.`)
-  }
-}
-
-export function specForModel(model) {
-  const hit = lookupSpec(model)
-  if (hit) return hit
-  warnUnknownModel(model)
-  return DEFAULT_SPEC
-}
-
-/** specMatch(model) → { spec, matched }（PROVIDER.md §16 M5——切换回显的来源判定）。
- *  `matched:false` = DEFAULT_SPEC 兜底（未知模型）；与 specForModel 共享同一查表实现（单次），
- *  specForModel 的返回形状与共享对象契约零改（热路径零变）。 */
-export function specMatch(model) {
-  const hit = lookupSpec(model)
-  if (hit) return { spec: hit, matched: true }
-  warnUnknownModel(model)
-  return { spec: DEFAULT_SPEC, matched: false }
-}
-
-/**
- * providerSpec(provider) — spec with a provider-level context override (PROVIDER.md §15, 2026-09-02).
- *
- * providers[].context is configured in K units (128 = 128K = 131072 tokens) and overrides the
- * MODEL_SPECS value for THIS provider only — the same model can have different real context
- * windows on different endpoints (official vs local deployment). The ×1024 conversion happens
- * HERE and nowhere else.
- *
- * Returns a COPY ({ ...spec, context }) — the shared spec object from the SORTED_SPECS lookup
- * must never be mutated, or the override would leak across providers (T-C1).
- *
- * Validation is defensive (pure function): absent/invalid context falls back to the plain spec
- * (config.mjs loadConfig already warns + strips invalid values; this guard covers direct callers
- * and keeps the function total). specForModel stays a pure table lookup — callers without a
- * provider keep using it.
- */
-export function providerSpec(provider) {
-  const spec = specForModel(provider?.model ?? "")
-  const k = Number(provider?.context) // Number() 接受数字字符串（"128"）——两端语义统一（code review #1）
-  if (Number.isInteger(k) && k > 0) return { ...spec, context: k * 1024 }
-  return spec
-}

package/src/peer-domains.mjs

@@ -1,265 +0,0 @@
-/**
- * peer-domains.mjs — R10 多实例协作 L3 文件写域登记 + 冲突检测（MULTI-INSTANCE-COLLAB
- * §2a.5——评审修正 #8：独立文件，防 300 行超限）。
- *
- * 登记存储（D-L3a）：~/.thincoder/peers/{sessionId}.json——每实例单文件、单写者（本
- * 进程——end marker 同型模式）；内容 {sessionId, pid, end, cwd, domains[绝对路径],
- * updatedAt}。写点 = 回合级：写工具钩子累积"本回合实际写过的文件"（D-L3b 同一钩子——
- * 检测+记录一次完成）→ 回合结束 flush 整写一次（finalizeAgentTurn）；本回合无写入则
- * 不写（文件按自身 updatedAt 自然过期——hot 5 分钟窗口语义不被空回合提前清掉）。
- *
- * 冲突检测（D-L3b）：结构化写工具（PEER_WRITE_TOOLS）执行前查 conflicts——命中他实例
- * hot 域 → 工具结果附软提示（决策⑥ A：不阻止）。缓存（评审修正 #2）：聚合结果按 peers
- * 目录 mtime 惰性缓存——目录未变零扫描；单次写工具调用新增开销上限 = 目录 stat 一次
- * （N3 度量）。崩溃残留：聚合时惰性清理（死 pid 文件删除——batchAlive 一次批量）；
- * 损坏文件按缺失降级（end marker NF2 同型——不删不炸，属主下次 flush 覆盖）。
- */
-
-import { statSync, readdirSync, readFileSync, unlinkSync } from "node:fs"
-import { join, resolve, sep } from "node:path"
-import { configDir } from "./config.mjs"
-import { normalizeCwd, getSessionId, END, writeSessionFile } from "./session-slots.mjs"
-import { batchAlive } from "./peer-instances.mjs"
-import { FILE_MUTATORS } from "./agent/helpers.mjs"
-
-/** hot 窗口：登记（回合足迹 flush）后 5 分钟内视为 hot（决策⑤ A——"刚写过"语义） */
-export const HOT_WINDOW_MS = 5 * 60 * 1000
-
-/** L3 覆盖的结构化写工具（D-L3b 清单）——既有 FILE_MUTATORS（write/edit/insert_after/
- *  hashline_edit/apply_patch/delete）∪ file_ops。insert_after/hashline_edit 亦为结构化
- *  写工具（同一文件写入面），file_ops 在 FILE_MUTATORS 之外故显式并入。 */
-export const PEER_WRITE_TOOLS = new Set([...FILE_MUTATORS, "file_ops"])
-
-export function peersDir() {
-  return join(configDir, "peers")
-}
-
-export function peerFilePath(sessionId) {
-  return join(peersDir(), `${sessionId}.json`)
-}
-
-// 模块级测试注入缝（default null = 生产实现；测试注入 + finally 恢复）
-let _testAliveFn = null
-
-/** 注入聚合判活实现（批量判活计数/去真实 exec——T-L3b 死清理用例可用真死 pid 亦可注入）。 */
-export function _setPeerDomainsTestImpl({ aliveFn = undefined } = {}) {
-  const prev = _testAliveFn
-  _testAliveFn = aliveFn ?? null
-  peersDirCache = null // 注入即环境变更——目录缓存失效（测试间不串）
-  return prev
-}
-
-export function _resetPeerDomainsTestImpl() {
-  _testAliveFn = null
-  peersDirCache = null
-}
-
-// peers 目录 mtime 惰性缓存（评审修正 #2）——单全局项（peers 目录全局唯一）
-let peersDirCache = null // { mtimeMs, peers: [...] }
-
-function statDirMtimeMs(dir) {
-  try {
-    return statSync(dir).mtimeMs
-  } catch {
-    return null // 目录缺失
-  }
-}
-
-/** 目标路径解析（工具 touchedPaths 优先——apply_patch/edit-batch 多文件；file_ops 无
- *  touchedPaths——source/dest 双算；其余 path 单参兜底）。相对路径按 cwd 解析为绝对
- *  路径（resolve：绝对入参原样保留）。解析失败/畸形入参跳过（零目标 = 无检测无登记）。 */
-export function peerWriteTargets(tool, args, cwd) {
-  const raw = tool?.touchedPaths
-    ? tool.touchedPaths(args ?? {})
-    : tool?.name === "file_ops"
-      ? [args?.source, args?.dest]
-      : [args?.path]
-  const out = []
-  for (const p of raw) {
-    if (typeof p !== "string" || p.length === 0) continue
-    try {
-      out.push(resolve(cwd, p))
-    } catch {
-      /* 畸形路径跳过——检测/登记尽力而为 */
-    }
-  }
-  return out
-}
-
-/** 路径重叠：a 与 b 相等或互为目录包含（file_ops 目录级操作/delete 整目录语义——
- *  区分大小写按平台（Windows 文件系统不区分）；分隔符归一（resolve 产物为原生分隔符，
- *  入参可能混用 / 与 \）。 */
-export function pathsOverlap(a, b) {
-  const norm = (p) => {
-    const n = process.platform === "win32" ? p.toLowerCase() : p
-    return (process.platform === "win32" ? n.replace(/\//g, "\\") : n.replace(/\\/g, "/")).replace(/[\\/]+$/, "")
-  }
-  const pa = norm(a)
-  const pb = norm(b)
-  if (pa === pb) return true
-  const sepN = process.platform === "win32" ? "\\" : "/"
-  const prefix = (p, q) => p === q || p.startsWith(q + sepN)
-  return prefix(pa, pb) || prefix(pb, pa)
-}
-
-/** 扫描 peers 目录：解析每文件 + 一次批量判活全部 pid + 死登记惰性清理（unlink——
- *  崩溃残留）；损坏文件按缺失降级（不删——属主下次 flush 覆盖）。返回活登记
- *  [{ sessionId, pid, end, cwd, domains, updatedAt }]。目录缺失/不可读 → []。 */
-function scanPeersDir() {
-  let files = []
-  try {
-    files = readdirSync(peersDir(), { withFileTypes: true })
-      .filter((e) => e.isFile() && e.name.endsWith(".json"))
-      .map((e) => join(peersDir(), e.name))
-  } catch {
-    return [] // 目录缺失（从未 flush）→ 无登记
-  }
-  const parsed = []
-  for (const file of files) {
-    try {
-      const rec = JSON.parse(readFileSync(file, "utf8"))
-      if (rec && typeof rec === "object" && typeof rec.sessionId === "string" && rec.sessionId.length > 0
-        && Number.isInteger(Number(rec.pid)) && Number(rec.pid) > 0
-        && typeof rec.cwd === "string" && Array.isArray(rec.domains)) {
-        parsed.push({ file, rec })
-      }
-      // 结构非法 = 损坏 → 按缺失降级（不删——NF2 同型）
-    } catch {
-      /* 解析失败同损坏 */
-    }
-  }
-  if (parsed.length === 0) return []
-  const aliveFn = _testAliveFn ?? batchAlive
-  const alive = aliveFn([...new Set(parsed.map((p) => Number(p.rec.pid)))])
-  // 判活探测失败（batchAlive → null）≠ 死：不得据此执行死清理（unlink 是破坏性副作用）
-  // ——返回 null 信号：调用方不缓存空聚合（下轮调用重试探测）
-  if (!(alive instanceof Set)) return null
-  const live = []
-  for (const { file, rec } of parsed) {
-    if (!alive.has(Number(rec.pid))) {
-      try {
-        // 死登记惰性清理（崩溃残留——聚合时一次批量判活顺带删除）
-        unlinkSync(file)
-      } catch { /* unlink 失败不影响聚合（下次再试） */ }
-      continue
-    }
-    live.push({
-      sessionId: rec.sessionId,
-      pid: Number(rec.pid),
-      end: typeof rec.end === "string" ? rec.end : undefined,
-      cwd: rec.cwd,
-      domains: rec.domains.filter((d) => typeof d === "string"),
-      updatedAt: Number(rec.updatedAt) || 0,
-    })
-  }
-  return live
-}
-
-/** peers 目录 mtime 惰性缓存聚合（评审修正 #2——目录未变不重扫）。返回当前目录下全部
- *  活登记（含他 cwd 实例——死清理跨 cwd 一次批量；cwd 过滤在 peerDomains）。 */
-function cachedScan() {
-  const dir = peersDir()
-  const mtime = statDirMtimeMs(dir)
-  if (mtime == null) {
-    peersDirCache = null
-    return []
-  }
-  if (peersDirCache && peersDirCache.mtimeMs === mtime) return peersDirCache.peers
-  const peers = scanPeersDir()
-  if (peers === null) {
-    peersDirCache = null // 探测失败——不缓存空聚合（下轮调用重试探测——失败 ≠ 无登记）
-    return []
-  }
-  // 死清理删文件会改目录 mtime——以清理后的 mtime 缓存（下次 stat 命中即不重扫）
-  peersDirCache = { mtimeMs: statDirMtimeMs(dir) ?? mtime, peers }
-  return peers
-}
-
-/**
- * 聚合（D-L3a）：本 cwd（normalizeCwd 同构比较）的其他活实例登记（self 排除——
- *  sessionId === getSessionId()）。返回 [{ sessionId, pid, end, cwd, domains, updatedAt }]。
- * 纯只读；缓存命中 = 目录 stat 一次（N3）。
- */
-export function peerDomains(cwd) {
-  const normCwd = normalizeCwd(cwd)
-  const myId = getSessionId()
-  return cachedScan().filter((p) => p.sessionId !== myId && normalizeCwd(p.cwd) === normCwd)
-}
-
-/**
- * 冲突检测（D-L3b——写前查询）：targets（绝对路径）命中他实例 hot 域（updatedAt 在
- * HOT_WINDOW_MS 内且域含 target/互为包含）→ 返回 [{ target, by: [{end, pid, sessionId}] }]。
- * 无冲突/无目标 → []。纯只读、不抛（内部全降级——失败按零冲突）。
- */
-export function conflicts(cwd, targets, { now = Date.now() } = {}) {
-  if (!Array.isArray(targets) || targets.length === 0) return []
-  let peers = []
-  try {
-    peers = peerDomains(cwd)
-  } catch {
-    return []
-  }
-  const hot = peers.filter((p) => p.domains.length > 0 && now - p.updatedAt <= HOT_WINDOW_MS)
-  if (hot.length === 0) return []
-  const hits = []
-  for (const target of targets) {
-    const by = hot.filter((p) => p.domains.some((d) => pathsOverlap(target, d)))
-    if (by.length > 0) hits.push({ target, by: by.map((p) => ({ end: p.end, pid: p.pid, sessionId: p.sessionId })) })
-  }
-  return hits
-}
-
-/** dispatch 写工具钩子预检：命中他实例 hot 域 → 软提示文案（null = 无冲突/无目标/
- *  降级——调用方零附加）。一次目录 stat（缓存命中零扫描——N3 度量）。 */
-export function peerCollabNote(cwd, tool, args) {
-  try {
-    const targets = peerWriteTargets(tool, args, cwd)
-    if (targets.length === 0) return null
-    const hits = conflicts(cwd, targets)
-    if (hits.length === 0) return null
-    return hits.map((h) => {
-      const who = h.by.map((p) => (p.end ? `${p.end} pid=${p.pid}` : `pid=${p.pid}`)).join(", ")
-      return `[peer-collab] ${h.target} — another live instance (${who}) registered writing it within the last 5 minutes; concurrent edits may overwrite each other. Write not blocked — coordinate before proceeding.`
-    }).join("\n")
-  } catch {
-    return null // 感知失败绝不打扰工具执行
-  }
-}
-
-/** 记录本回合写足迹（D-L3a 累积——D-L3b 同一钩子执行后调用；仅成功写计入"实际写过"）。
- *  agent._peerWritten: Set<绝对路径>（回合级——finalizeAgentTurn flush 时整写并清空）。 */
-export function recordPeerWrites(agent, tool, args) {
-  try {
-    const targets = peerWriteTargets(tool, args, agent.cwd)
-    if (targets.length === 0) return
-    agent._peerWritten ??= new Set()
-    for (const t of targets) agent._peerWritten.add(t)
-  } catch {
-    /* 记录失败不影响工具结果 */
-  }
-}
-
-/**
- * 回合末登记 flush（D-L3a——finalizeAgentTurn 调用）：本回合足迹整写一次本实例文件
- * （单写者；.tmp+rename 原子——writeSessionFile）。本回合无写入 → 不写（文件按自身
- * updatedAt 自然过期——hot 窗口不被空回合提前清掉；低频 N3）。写失败容忍（NF2——end
- * marker 同型）；成功 flush 后清空回合集合。不抛（调用方回合收尾零风险）。
- */
-export function flushPeerDomains(agent) {
-  try {
-    const set = agent._peerWritten
-    if (!set || set.size === 0) return
-    const sessionId = getSessionId()
-    writeSessionFile(peerFilePath(sessionId), {
-      sessionId,
-      pid: process.pid,
-      end: END,
-      cwd: normalizeCwd(agent.cwd),
-      domains: [...set],
-      updatedAt: Date.now(),
-    })
-    set.clear()
-  } catch {
-    /* NF2：失败容忍——下次 flush 重写 */
-  }
-}