dsh-recall-plugin 2.3.0 → 2.3.2

package/lib/routes-core.js

@@ -1,180 +1,129 @@
-/**
- * dsh-recall-plugin — 核心路由域（R2 从 index.js 拆出）
- *
- * init / snapshot-info / preview / execute / status / lineage-record 六个核心
- * 端点。依赖经 deps 注入（rt/snaps/state/cfg/enqueue/agentBusy/rescueRollback
- * 等），无模块级可变状态（HMR 假设）。preview/execute 内部跑 git add -A，
- * 经 enqueue 排进与快照/gc 同一条串行队列，避免 index.lock 竞态。
- */
-
-import { ENV_HINTS } from './diagnostics.js'
-import { parseTreeId } from './snapshots.js'
-
-export function createRoutesCore(deps) {
-  // ctx 不解构（A4）：本域所有服务访问都已由 rt/snaps 封装，直接摸 ctx 会
-  // 绕过工厂分层——留空位只会诱导未来代码破坏依赖注入约定
-  const { rt, snaps, state, cfg, supported, enqueue, agentBusy, rescueRollback, E } = deps
-
+import { ENV_HINTS } from "./diagnostics.js";
+import { parseTreeId } from "./snapshots.js";
+function createRoutesCore(deps) {
+  const { rt, snaps, state, cfg, supported, enqueue, agentBusy, rescueRollback, E } = deps;
   return {
-    'init': async (args) => {
+    "init": async (args) => {
       if (!supported) {
-        return { ok: false, root: null, notice: { unsupported: true } }
+        return { ok: false, root: null, notice: { unsupported: true } };
       }
-      const sessionId = args && args.sessionId ? String(args.sessionId) : null
-      const root = await rt.resolveRoot(sessionId)
-      let notice = null
+      const sessionId = args && args.sessionId ? String(args.sessionId) : null;
+      const root = await rt.resolveRoot(sessionId);
+      let notice = null;
       if (root) {
-        let store = await rt.resolveStore(root)
-        store = await rt.tryUpgradeToHome(root)
-        await rt.ensureGit(root, store)
-        await snaps.loadIndex(root, sessionId)
-        await snaps.rebuildOrphans(root, sessionId)
-        rt.cleanupLegacy(root)
-        // 降级状态随 init 下发，Client 弹一次性提示（每次页面加载各弹一次）：
-        // gitMissing=未检测到 git CLI（撤回按钮不出现）；homeFallback=home
-        // 不可写，快照降级存进项目内 .dsh-recall-snapshots。
+        let store = await rt.resolveStore(root);
+        store = await rt.tryUpgradeToHome(root);
+        await rt.ensureGit(root, store);
+        await snaps.loadIndex(root, sessionId);
+        await snaps.rebuildOrphans(root, sessionId);
+        rt.cleanupLegacy(root);
         notice = {
-          gitMissing: state.gitExe === '',
+          gitMissing: state.gitExe === "",
           homeFallback: store ? !store.home : false
-        }
+        };
       }
-      // 顺带下发客户端行为开关（fillDraft 等）：Client 无须为读配置单开请求，
-      // init 是每会话必经的预热通道
-      return { ok: Boolean(root), root: root || null, notice, config: { refillDraft: cfg.refillDraft, archiveOriginal: cfg.archiveOriginal } }
+      return { ok: Boolean(root), root: root || null, notice, config: { refillDraft: cfg.refillDraft, archiveOriginal: cfg.archiveOriginal } };
     },
-
-    'snapshot-info': async (args) => {
-      const id = args && args.messageId ? String(args.messageId) : ''
-      const snap = state.snapshots.get(id)
-      // 失败/跳过/熔断反馈（issue #7 失败可见性）：客户端轮询到 failed 即
-      // 终止轮询并 toast，不再空等 20 次；has 时附带 skipped 让用户知道
-      // fail-open 跳过了哪些路径
-      const feedback = await snaps.feedbackFor(args && args.sessionId, id)
-      return { has: Boolean(snap), time: snap ? snap.time : null, id, ...feedback }
+    "snapshot-info": async (args) => {
+      const id = args && args.messageId ? String(args.messageId) : "";
+      const snap = state.snapshots.get(id);
+      const feedback = await snaps.feedbackFor(args ? args.sessionId : null, id);
+      return { has: Boolean(snap), time: snap ? snap.time : null, id, ...feedback };
     },
-
-    'preview': async (args) => {
-      const id = args && args.messageId ? String(args.messageId) : ''
-      const sessionId = args && args.sessionId ? String(args.sessionId) : null
-      // P0-1：目标工作区 agent 运行中直接拒绝预览（避免用户确认时文件被
-      // agent 改动，预览清单与实际回退内容脱节）。同会话优先命中（最常见
-      // 场景），快照存在时叠加跨会话同工作区检查。
-      const snap = state.snapshots.get(id)
-      if (agentBusy(sessionId, snap ? snap.root : null)) return { ok: false, code: E.RECALL_AGENT_BUSY, message: 'Agent 正在运行中，请先停止后再撤回' }
-      const result = await enqueue(() => snaps.diffFor(id))
-      if (result === null) return { ok: false, code: E.RECALL_NO_SNAPSHOT, message: '该消息没有可用的项目快照' }
-      const snap2 = state.snapshots.get(id)
-      const cutSeq = await snaps.resolveCutSeq(sessionId, id)
-      // PF-1：treeId 是 preview 时 add -A 后的 index 树指纹，Client 确认时
-      // 透传回 execute——Host 与安全快照指纹比对即可判定「预览后文件是否
-      // 变化」，省掉 execute 侧整条重复 diff。旧版 Client 不认识该字段，
-      // 无值时 execute 退回 previewTotal 校验（向后兼容）。
-      return { ok: true, changes: result.changes, total: result.total, truncated: result.truncated, treeId: result.treeId || null, time: snap2 ? snap2.time : null, root: snap2 ? snap2.root : null, cutSeq }
+    "preview": async (args) => {
+      const id = args && args.messageId ? String(args.messageId) : "";
+      const sessionId = args && args.sessionId ? String(args.sessionId) : null;
+      const snap = state.snapshots.get(id);
+      if (agentBusy(sessionId, snap ? snap.root : null)) return { ok: false, code: E.RECALL_AGENT_BUSY, message: "Agent \u6B63\u5728\u8FD0\u884C\u4E2D\uFF0C\u8BF7\u5148\u505C\u6B62\u540E\u518D\u64A4\u56DE" };
+      const result = await enqueue(() => snaps.diffFor(id));
+      if (result === null) return { ok: false, code: E.RECALL_NO_SNAPSHOT, message: "\u8BE5\u6D88\u606F\u6CA1\u6709\u53EF\u7528\u7684\u9879\u76EE\u5FEB\u7167" };
+      const snap2 = state.snapshots.get(id);
+      const cutSeq = await snaps.resolveCutSeq(sessionId, id);
+      return { ok: true, changes: result.changes, total: result.total, truncated: result.truncated, treeId: result.treeId || null, time: snap2 ? snap2.time : null, root: snap2 ? snap2.root : null, cutSeq };
     },
-
-    'execute': async (args) => {
-      const id = args && args.messageId ? String(args.messageId) : ''
-      const sessionId = args && args.sessionId ? String(args.sessionId) : null
+    "execute": async (args) => {
+      const id = args && args.messageId ? String(args.messageId) : "";
+      const sessionId = args && args.sessionId ? String(args.sessionId) : null;
       const result = await enqueue(async () => {
-        const snap = state.snapshots.get(id)
-        if (!snap) return { ok: false, code: E.RECALL_NO_SNAPSHOT, message: '该消息没有可用的项目快照' }
-        const store = state.stores.get(snap.root)
-        if (!store) return { ok: false, code: E.RECALL_NO_STORE, message: '快照存储不可用' }
-        // P0-1：队列内第一步——执行前再查一次 agent 状态。检查放在互斥
-        // 队列内，检查后紧接执行，中间不可能插进别的操作，窗口为零。
-        if (agentBusy(sessionId, snap.root)) return { ok: false, code: E.RECALL_AGENT_BUSY, message: 'Agent 正在运行中，请先停止后再撤回' }
-        // P0-3 / PF-1：preview→execute 失效校验，两代并存——
-        // - 新版 Client 透传 previewTreeId（preview 时 add -A 后的 index 树
-        //   指纹）：与下方安全快照输出的指纹比对，内容级一致判定，且免掉
-        //   一整条重复 diff 进程（一次撤回 4 条重进程 → 3 条）。
-        // - 旧版 Client 只带 previewTotal：退回条目总数校验（多付一次 diff，
-        //   同数不同文件的边缘情形由安全快照兜底）。
-        // - 都不带（直调 API）：不校验，与 P0-3 同款可选语义。
-        const previewTreeId = args && typeof args.previewTreeId === 'string' && args.previewTreeId ? args.previewTreeId : null
-        if (!previewTreeId && args && typeof args.previewTotal === 'number') {
-          const fresh = await snaps.diffFor(id)
+        const snap = state.snapshots.get(id);
+        if (!snap) return { ok: false, code: E.RECALL_NO_SNAPSHOT, message: "\u8BE5\u6D88\u606F\u6CA1\u6709\u53EF\u7528\u7684\u9879\u76EE\u5FEB\u7167" };
+        const store = state.stores.get(snap.root);
+        if (!store) return { ok: false, code: E.RECALL_NO_STORE, message: "\u5FEB\u7167\u5B58\u50A8\u4E0D\u53EF\u7528" };
+        if (agentBusy(sessionId, snap.root)) return { ok: false, code: E.RECALL_AGENT_BUSY, message: "Agent \u6B63\u5728\u8FD0\u884C\u4E2D\uFF0C\u8BF7\u5148\u505C\u6B62\u540E\u518D\u64A4\u56DE" };
+        const previewTreeId = args && typeof args.previewTreeId === "string" && args.previewTreeId ? args.previewTreeId : null;
+        if (!previewTreeId && args && typeof args.previewTotal === "number") {
+          const fresh = await snaps.diffFor(id);
           if (!fresh || fresh.total !== args.previewTotal) {
-            return { ok: false, code: E.RECALL_STALE, message: '预览后项目文件发生了变化，请重新预览确认' }
+            return { ok: false, code: E.RECALL_STALE, message: "\u9884\u89C8\u540E\u9879\u76EE\u6587\u4EF6\u53D1\u751F\u4E86\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u9884\u89C8\u786E\u8BA4" };
           }
         }
-        // 回退前自动打安全快照：回退覆盖工作区且不回写 index（旧的
-        // 「当前状态」从此无任何快照可找回），用消息 ID 打 tag 会与该消息
-        // 的既有快照碰撞，故用独立前缀的时间戳 tag——不进 index.json
-        // （列表不展示），但孤儿重建/手动 git tag 仍能找到它，误回退后
-        // 用户可让插件从该 tag 恢复，堵住唯一的不可逆操作缺口。
-        // 失败时 safetyOk 置 false：后续回退若也失败将无救援点（H1），
-        // 行为退化为现状（fail-loud），不更差。
-        // PF-1：安全快照输出的树指纹就是「执行时刻的工作区状态」——与
-        // previewTreeId 不一致 → STALE（此时安全快照已打下，isSafetySnapshotId
-        // 让它不进索引，反而是额外的救援点）。安全快照失败时无指纹可比对，
-        // 跳过指纹校验继续回退（不阻断主流程的既有语义）。
-        const safetyId = 'pre-rollback-' + Date.now()
-        let safetyOk = false
-        let safetyTreeId = null
+        const safetyId = "pre-rollback-" + Date.now();
+        let safetyOk = false;
+        let safetyTreeId = null;
         try {
-          const out = await rt.runShell(rt.scripts.snapshotScript(snap.root, store, state.gitExe, safetyId, cfg.baseExcludes), { timeoutMs: 600000, stdoutMaxBytes: 65536 })
-          safetyOk = true
-          safetyTreeId = parseTreeId(out)
+          const out = await rt.runShell(rt.scripts.snapshotScript(snap.root, store, state.gitExe || "", safetyId, cfg.baseExcludes), { timeoutMs: 6e5, stdoutMaxBytes: 65536 });
+          safetyOk = true;
+          safetyTreeId = parseTreeId(out);
         } catch (error) {
-          // 安全快照失败不阻断回退本身：用户已确认覆盖，记录后照原计划执行
-          rt.recordError('recall safety snapshot failed: ' + String(error))
+          rt.recordError("recall safety snapshot failed: " + String(error));
         }
         if (previewTreeId && safetyTreeId && safetyTreeId !== previewTreeId) {
-          return { ok: false, code: E.RECALL_STALE, message: '预览后项目文件发生了变化，请重新预览确认' }
+          return { ok: false, code: E.RECALL_STALE, message: "\u9884\u89C8\u540E\u9879\u76EE\u6587\u4EF6\u53D1\u751F\u4E86\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u9884\u89C8\u786E\u8BA4" };
         }
-        const rolled = await snaps.rollbackFor(id)
-        if (rolled.ok) return rolled
-        // 回退失败（rollbackFor 返回 partial，工作区可能半回退）：用安全快照
-        // 救援（H1）。rescueRollback 是 snapshots.js 模块级纯逻辑，副作用经
-        // deps 注入，三分支（无救援点/救援成功/救援失败）单测直接钉。
+        const rolled = await snaps.rollbackFor(id);
+        if (rolled.ok) return rolled;
         return rescueRollback(
-          { runShell: rt.runShell, scripts: rt.scripts, gitExe: state.gitExe, recordError: rt.recordError },
+          { runShell: rt.runShell, scripts: rt.scripts, gitExe: state.gitExe || "", recordError: rt.recordError },
           { root: snap.root, store, safetyId, safetyOk, rollbackError: rolled.error }
-        )
-      })
-      if (!result.ok) return result
-      // 文件回退后再解析切点：切点只依赖会话日志，与快照是否删除无关（命中缓存，瞬时）
-      const cutSeq = await snaps.resolveCutSeq(sessionId, id)
-      return { ok: true, count: result.count, cutSeq }
+        );
+      });
+      if (!result.ok) return result;
+      const cutSeq = await snaps.resolveCutSeq(sessionId, id);
+      return { ok: true, count: result.count, cutSeq };
     },
-
     // 设置页排障：最近错误（Host 侧 console.error 的页面可见副本）。
     // M1-D3/D5：条目自带 count/kind（recordError 富集）——count 在服务端
     // 拼成「（×N）」展示文本，设置页按 message 渲染即显示重复计数，零
     // Client 改动；hint 是分类后的可行动提示（API 自描述，本次无客户端
     // 消费，设置页未来展示零成本）。storeBase（M2-D3）暴露快照存储根，
     // 供设置页未来展示「快照存在哪里」，失败为 null。
-    'status': async (args) => {
-      const storeBase = await rt.resolveHomeContainer()
-      if (args && args.op === 'clear') {
-        state.errors.length = 0
-        return { ok: true, errors: [], storeBase }
+    "status": async (args) => {
+      const storeBase = await rt.resolveHomeContainer();
+      if (args && args.op === "clear") {
+        state.errors.length = 0;
+        return { ok: true, errors: [], storeBase };
       }
       const errors = state.errors.slice(-20).reverse().map((e) => ({
         ...e,
-        message: e.message + (e.count > 1 ? '（×' + e.count + '）' : ''),
-        hint: ENV_HINTS[e.kind] || null
-      }))
-      return { ok: true, errors, storeBase }
+        message: e.message + (e.count > 1 ? "\uFF08\xD7" + e.count + "\uFF09" : ""),
+        hint: e.kind ? ENV_HINTS[e.kind] : null
+      }));
+      return { ok: true, errors, storeBase };
     },
-
     // F1：client fork 成功后上报撤回链（childId ↔ parentId），Host 持久化到
     // lineage.json 供快照管理树聚族展示「版本家族」。root 优先按 fork 源
     // parentId 解析（fork 时它仍是 live 会话；归档只隐藏列表、对象在内存），
     // 失败回退 childId。
-    'lineage-record': async (args) => {
-      const childId = args && args.childId ? String(args.childId) : ''
-      const parentId = args && args.parentId ? String(args.parentId) : ''
-      if (!childId || !parentId) return { ok: false, code: E.RECALL_BAD_TYPE, message: '缺少会话 ID' }
-      const root = (await rt.resolveRoot(parentId)) || (await rt.resolveRoot(childId))
-      if (!root) return { ok: false, code: E.RECALL_NO_ROOT, message: '无法解析工作区' }
-      let store = state.stores.get(root)
+    "lineage-record": async (args) => {
+      const childId = args && args.childId ? String(args.childId) : "";
+      const parentId = args && args.parentId ? String(args.parentId) : "";
+      if (!childId || !parentId) return { ok: false, code: E.RECALL_BAD_TYPE, message: "\u7F3A\u5C11\u4F1A\u8BDD ID" };
+      const root = await rt.resolveRoot(parentId) || await rt.resolveRoot(childId);
+      if (!root) return { ok: false, code: E.RECALL_NO_ROOT, message: "\u65E0\u6CD5\u89E3\u6790\u5DE5\u4F5C\u533A" };
+      let store = state.stores.get(root) || null;
       if (!store) {
-        try { store = await rt.resolveStore(root) } catch (error) { store = null }
+        try {
+          store = await rt.resolveStore(root);
+        } catch (error) {
+          store = null;
+        }
       }
-      if (!store) return { ok: false, code: E.RECALL_NO_STORE, message: '快照存储不可用' }
-      await snaps.recordLineage(root, childId, parentId)
-      return { ok: true }
+      if (!store) return { ok: false, code: E.RECALL_NO_STORE, message: "\u5FEB\u7167\u5B58\u50A8\u4E0D\u53EF\u7528" };
+      await snaps.recordLineage(root, childId, parentId);
+      return { ok: true };
     }
-  }
+  };
 }
+export {
+  createRoutesCore
+};