dsh-retrace 0.4.19 → 0.4.20

package/lib/adapter/dsh.js

@@ -12,6 +12,10 @@
 import { readdirSync, accessSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
+// 官方 foldSurface:重放得与写入端完全一致的 surface nodes(replace 插 marker、
+// 遮蔽移除节点 → nodes 非 seq 单调;span 计算必须用它,否则 start/end indexOf
+// 会 not found/倒置 → S4/S8 拒 → 撤回死锁,ISSUE-20260907113201)。peerDep 提供。
+import { foldSurface } from '@deepseek-ai/dsh-session'
 
 /** 找 DSH 会话文件路径(遍历 ~/.dsh/sessions 各工作区)。 */
 export function sessionFilePath(sessionId) {
@@ -49,12 +53,22 @@ async function readEventsFromFile(filePath) {
 
 /**
  * 从全量事件计算遮蔽范围(业务逻辑,基于通用事件,与 DSH 无关)。
+ *
+ * 2026-09-07 修复(ISSUE-20260907113201-3f9e4f12):nodes 不再从 events 顺序收集
+ * (seq 递增的虚拟 nodes),改为**官方 foldSurface 重放得真实 surface nodes**——
+ * 官方 replace 会把 marker(新 seq)插入遮蔽范围开头、移除被遮蔽节点 → nodes 非
+ * seq 单调。旧算法按 seq 递增假设算 span,写入时官方 nodes 里 indexOf(start/end)
+ * 可能 not found(目标已被遮蔽)或倒置(startIdx>endIdx,marker 插入) → S4/S8 拒 →
+ * 撤回死锁(evidence 快照实测:target 710693 span[710693..711448] → index 442>441)。
+ * 新算法 nodes = 官方 foldSurface 结果 → span 的 start/end 与写入端完全一致,
+ * not found/倒置不可能;target 已被遮蔽(不在 nodes)= 返回 null(target-shadowed)。
+ *
  * @param {Array} events - 全量事件(通用格式)。
  * @param {number|string} target - seq 或 messageId。
- * @param {'round'|'tail'} [mode] - round=遮蔽目标轮;tail=遮蔽目标之后(编辑 fromScratch)。
+ * @param {'round'|'tail'} [mode] - round=遮蔽目标轮;tail=遮蔽目标位置之后全部(recall/fromScratch)。
  */
 export function computeSpan(events, target, mode = 'round') {
-  if (!Array.isArray(events)) return null
+  if (!Array.isArray(events) || events.length === 0) return null
   let seq = typeof target === 'number' ? target : -1
   if (seq === -1) {
     for (let i = events.length - 1; i >= 0; i--) {
@@ -64,18 +78,27 @@ export function computeSpan(events, target, mode = 'round') {
     }
   }
   if (seq === -1 || !events[seq]) return null
-  // surface 节点 = user/assistant/tool 消息(近似 surface 节点,与官方 foldSurface 一致)
-  const nodes = []
-  for (const ev of events) {
-    if (ev && (ev.type === 'user/message' || ev.type === 'assistant/message' || ev.type === 'tool/result')) nodes.push(ev.seq)
+  // 官方 foldSurface 重放 = 与写入端一致的当前 surface(含 marker 插入效应、排除被遮蔽节点)
+  let nodes
+  try {
+    const folded = foldSurface(events)
+    nodes = folded?.nodes
+  } catch {
+    return null
   }
+  if (!Array.isArray(nodes) || nodes.length === 0) return null
+  const index = nodes.indexOf(seq)
+  if (index === -1) return null // 目标已被遮蔽/不在 surface → 调用方报 target-shadowed
   if (mode === 'tail') {
-    const shadowedSeqs = nodes.filter((s) => s >= seq)
+    // tail:从目标所在轮首遮蔽到 surface 尾(撤回 = 移除整轮 input+output + 其后全部,
+    // R2 语义;目标若是轮内 assistant/tool 则回退到轮首 user,防孤立输入)。
+    let startPos = index
+    for (let i = index; i >= 0; i--) { if (isRoundBoundary(events[nodes[i]])) { startPos = i; break } }
+    const shadowedSeqs = nodes.slice(startPos)
     if (shadowedSeqs.length === 0) return null
     return { start: shadowedSeqs[0], end: shadowedSeqs[shadowedSeqs.length - 1], shadowedSeqs }
   }
-  const index = nodes.indexOf(seq)
-  if (index === -1) return null
+  // round:目标轮(在官方 nodes 位置序上找轮边界;marker 是 assistant/message 非轮边界)
   let startIdx = index
   for (let i = index; i >= 0; i--) { if (isRoundBoundary(events[nodes[i]])) { startIdx = i; break } }
   let endIdx = nodes.length - 1

package/lib/dynamic-host.js

@@ -206,8 +206,17 @@ return {
           if (span.length === 0) return null
           return { start: span[0], end: span[span.length - 1], shadowedSeqs: span }
         }
-        // tail 模式:遮蔽 startSeq 之后所有 surface 节点(不依赖稀疏 events)
-        const shadowedSeqs = nodes.filter((s) => s >= startSeq)
+        // tail 模式:从目标所在轮首遮蔽到 surface 尾(撤回 = 移除整轮 input+output + 其后
+        // 全部;目标若是轮内 assistant/tool 则回退到轮首 user,防孤立输入)。位置连续段——
+        // marker 插入使 nodes 非 seq 单调,filter(s>=startSeq) 会漏/错;host 视图尽力,
+        // 主路径 = index.js 注入 spanFromFile 官方 foldSurface nodes,ISSUE-20260907113201。
+        const index = nodes.indexOf(startSeq)
+        if (index === -1) return null // 已被遮蔽/不在 surface → target-shadowed
+        let startPos = index
+        for (let i = index; i >= 0; i--) {
+          if (isRoundBoundary(events[nodes[i]])) { startPos = i; break }
+        }
+        const shadowedSeqs = nodes.slice(startPos)
         if (shadowedSeqs.length === 0) return null
         return {
           start: shadowedSeqs[0],
@@ -321,7 +330,10 @@ return {
         await ensureIdle(agents.get(sessionId))
         const seq = findMessageSeq(session, messageId)
         if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
-        const span = args?.span ?? roundSpanFrom(session, seq)
+        // 2026-09-07:撤回语义 = 遮蔽目标轮及之后全部(编辑=从此处分叉,bfb965e4/3f9e4f12
+        // issue)——fallback 用 tail;主路径由 index.js 注入 spanFromFile(官方 foldSurface nodes)。
+        // 大范围遮蔽由快照点守卫引导分支(太旧消息的正确出口)。
+        const span = args?.span ?? shadowSpanFrom(session, seq, { mode: 'tail' })
         if (!span) throw editorError('target-shadowed', 'This message is no longer part of the active conversation.')
         const markerEvent = await writeMarker(session, span, 'recall', seq, messageTextOf(session, seq))
         await flushSafely(session)

package/lib/host-core.js

@@ -196,8 +196,17 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
       if (span.length === 0) return null
       return { start: span[0], end: span[span.length - 1], shadowedSeqs: span }
     }
-    // tail 模式:遮蔽 startSeq 之后所有 surface 节点(不依赖稀疏 events)
-    const shadowedSeqs = nodes.filter((s) => s >= startSeq)
+    // tail 模式:从目标所在轮首遮蔽到 surface 尾(撤回 = 移除整轮 input+output + 其后
+    // 全部;目标若是轮内 assistant/tool 则回退到轮首 user,防孤立输入)。位置连续段——
+    // marker 插入使 nodes 非 seq 单调,filter(s>=startSeq) 会漏/错;host 视图尽力,
+    // 主路径 = index.js 注入 spanFromFile 官方 foldSurface nodes,ISSUE-20260907113201。
+    const index = nodes.indexOf(startSeq)
+    if (index === -1) return null // 已被遮蔽/不在 surface → target-shadowed
+    let startPos = index
+    for (let i = index; i >= 0; i--) {
+      if (isRoundBoundary(events[nodes[i]])) { startPos = i; break }
+    }
+    const shadowedSeqs = nodes.slice(startPos)
     if (shadowedSeqs.length === 0) return null
     return {
       start: shadowedSeqs[0],
@@ -311,7 +320,10 @@ export function createEditorApi(ctx, sessions, agents, log = () => {}, hooks = {
     await ensureIdle(agents.get(sessionId))
     const seq = findMessageSeq(session, messageId)
     if (seq === -1) throw editorError('message-not-found', 'Message not found in this session.')
-    const span = args?.span ?? roundSpanFrom(session, seq)
+    // 2026-09-07:撤回语义 = 遮蔽目标轮及之后全部(编辑=从此处分叉,bfb965e4/3f9e4f12
+    // issue)——fallback 用 tail;主路径由 index.js 注入 spanFromFile(官方 foldSurface nodes)。
+    // 大范围遮蔽由快照点守卫引导分支(太旧消息的正确出口)。
+    const span = args?.span ?? shadowSpanFrom(session, seq, { mode: 'tail' })
     if (!span) throw editorError('target-shadowed', 'This message is no longer part of the active conversation.')
     const markerEvent = await writeMarker(session, span, 'recall', seq, messageTextOf(session, seq))
     await flushSafely(session)

package/lib/http.js

@@ -254,11 +254,13 @@ export function createRetraceHttpHandler(ctx, { sessions, agents, seam, rollback
       }
       // 情形② step 号:writer 的 readMaxStep 已在 index.js 装配时注入(文件全量算)。
       // 2026-09-01:编辑操作前从文件算遮蔽(绕开 host 稀疏 session.events,用户方案)
+      // 2026-09-09:recall mode 改 tail(遮蔽目标轮及之后全部)——与 index.js harness 入口
+      // 同语义(独立审查 ❌-1:HTTP 入口此前漏改仍 round,两入口分叉违反"编辑走哪个入口都生效")
       if ((op === 'recall' || op === 'editAndResend' || op === 'regenerate') && !args?.span) {
         try {
           const target = typeof args?.seq === 'number' ? args.seq : args?.messageId
           if (target !== undefined && target !== null) {
-            const mode = op === 'editAndResend' && args?.fromScratch ? 'tail' : 'round'
+            const mode = op === 'recall' || (op === 'editAndResend' && args?.fromScratch) ? 'tail' : 'round'
             const span = await dshAdapter.spanFromFile(sessionId, target, mode)
             if (span) args = { ...args, span }
           }

package/lib/index.js

@@ -239,26 +239,43 @@ export function apply(ctx) {
         return { ok: false, error: { code: 'internal', message: String(error) } }
       }
     }
-    /** 启动批量 pin:DSH 会话渐进驻留,延迟+有限重试直到有驻留会话(避免启动空跑)。 */
-    function bootPin(retries = 0) {
-      if (retries >= 8) return
+    /**
+     * 启动批量 pin:DSH 会话渐进驻留,定期重试直到覆盖(幂等可重复,alreadyTagged 跳过)。
+     * 0.4.19 缺陷(用户实测前发现):`bootPin(99)` 被 `retries>=8` 挡住 → 30s 重跑永不执行;
+     * 启动 24s 窗口内会话未驻留 → 永久放弃 → 短码永不显示(全天 0 条 bootPin 日志)。
+     * 修法:每次(成功或失败)都安排下一次,共 MAX_ATTEMPTS 次(30s×20 ≈ 启动后 10 分钟
+     * 窗口,覆盖渐进驻留);错误打日志不静默。
+     */
+    function bootPin(attempts = 0) {
+      const MAX_ATTEMPTS = 20
+      const schedule = () => {
+        if (attempts < MAX_ATTEMPTS) setTimeout(() => bootPin(attempts + 1), 30000)
+      }
       const sessionStore = ctx.sessions
       const hasSessions = sessionStore && (
         (typeof sessionStore.list === 'function' && sessionStore.list().length > 0) ||
         (typeof sessionStore.values === 'function' && sessionStore.values().length > 0)
       )
       if (!hasSessions) {
-        setTimeout(() => bootPin(retries + 1), 3000)
+        schedule()
         return
       }
-      pinAllResident().then((result) => {
-        log(`retrace: bootPin → ${result?.value?.total ?? 0} 个驻留会话标题已处理`)
-      }).catch(() => {})
-      setTimeout(() => bootPin(99), 30000) // 30s 后再跑一次,覆盖之后驻留的会话
+      pinAllResident()
+        .then((result) => {
+          log(`retrace: bootPin(${attempts}) → ${result?.value?.total ?? 0} 个驻留会话标题已处理`)
+          schedule()
+        })
+        .catch((error) => {
+          log(`retrace: bootPin error: ${String(error).slice(0, 160)}`)
+          schedule()
+        })
     }
     bootPin(0)
     const disposers = [
-      harness.handle('retrace.recall', withFileSpan('recall', () => 'round')),
+      // 2026-09-07:recall 语义 = 遮蔽目标轮及之后全部(编辑=从此处分叉,bfb965e4/
+      // 3f9e4f12 issue 要求)——不再只遮蔽目标轮(缺陷①断层);tail 在官方 foldSurface
+      // nodes 上按位置切(ISSUE-20260907113201 修复),大范围遮蔽由快照点守卫引导分支。
+      harness.handle('retrace.recall', withFileSpan('recall', () => 'tail')),
       harness.handle('retrace.editAndResend', withFileSpan('editAndResend', (a) => (a?.fromScratch ? 'tail' : 'round'))),
       harness.handle('retrace.regenerate', withFileSpan('regenerate', () => 'round')),
       // 会话短码（2026-08-31）：session id → 确定性 10 位短码，人机交互识别用。

package/package.json

@@ -1,17 +1,10 @@
 {
   "name": "dsh-retrace",
   "description": "Retrace · 回溯 — Recall, edit-and-resend, regenerate, and conversation/artifact versioning (timeline, rollback, fork map) for DeepSeek Harness — Web and Desktop",
-  "version": "0.4.19",
-  "packageManager": "pnpm@11.7.0",
+  "version": "0.4.20",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
-  "scripts": {
-    "build": "node scripts/generate-dynamic.mjs && node scripts/build-client.mjs",
-    "check": "node scripts/check-syntax.mjs && node scripts/check-dynamic.mjs",
-    "test": "vitest run",
-    "prepublishOnly": "pnpm check && pnpm build && pnpm test"
-  },
   "exports": {
     ".": {
       "default": "./lib/index.js"
@@ -102,5 +95,10 @@
   },
   "bin": {
     "retrace": "bin/retrace.mjs"
+  },
+  "scripts": {
+    "build": "node scripts/generate-dynamic.mjs && node scripts/build-client.mjs",
+    "check": "node scripts/check-syntax.mjs && node scripts/check-dynamic.mjs",
+    "test": "vitest run"
   }
-}
+}