dsh-log-contract 0.3.0 → 0.3.2

package/lib/checks.js

@@ -432,8 +432,8 @@ export function wireViolations(events) {
     } else if (op && isReplaceOp(op)) {
       const s = nodes.indexOf(op.start);
       const e = nodes.indexOf(op.end);
-      if (s !== -1 && e !== -1 && s <= e) nodes.splice(s, e - s + 1);
-      nodes.push(event.seq);
+      if (s !== -1 && e !== -1 && s <= e) nodes.splice(s, e - s + 1, event.seq);
+      else nodes.push(event.seq);
     }
   }
   // 展开 wire 流

package/lib/index.js

@@ -4,7 +4,7 @@
  * 日志契约守护（DSH session log contract guard）。
  * 公开 API：离线体检 + 写前校验 + 修复 + 契约目录。
  */
-export { loadSessionLog } from './log-reader.js';
+export { loadSessionLog, tailSeq } from './log-reader.js';
 export { validateSessionLog } from './validate.js';
 export { createPreWriter, preWriterFromLog } from './prewrite.js';
 export { repairSession, strictScanText, removeMarkersText, dropFailedTurnsText, trimLastMessagesText, compactLastMessagesText, rebuildZstdText } from './repair.js';

package/lib/log-reader.js

@@ -92,6 +92,49 @@ export function decompressZstd(buf) {
   return Buffer.concat(parts);
 }
 
+/**
+ * 读取文件尾部最后一条事件的 seq（看门狗 R1 用，只解最后一帧，O(帧数) 内）。
+ *
+ * 语义：zstd 多帧文件取最后一个**完整**帧解压（撕裂尾帧跳过——可能正在写入），
+ * 从帧内末尾向前找第一条合法 JSON 行，用 `decodeStorageRecord` 展开取末事件 seq
+ * （chunk 行展开后末成员即该 run 的最新 seq）。明文文件直接扫末尾。
+ *
+ * @param {string} path 日志文件路径
+ * @returns {number|null} 尾部 seq；读取失败/无可解析行返回 null（调用方降级不检查）。
+ */
+export function tailSeq(path) {
+  let buf;
+  try {
+    buf = fs.readFileSync(path);
+  } catch {
+    return null;
+  }
+  const isZstd = buf.length >= 4 && buf.readUInt32LE(0) === ZSTD_MAGIC;
+  let plain;
+  if (isZstd) {
+    const { frames } = scanZstdFrames(buf);
+    if (frames.length === 0) return null;
+    const [s, e] = frames[frames.length - 1];
+    try {
+      plain = zstdDecompressSync(buf.subarray(s, e));
+    } catch {
+      return null;
+    }
+  } else {
+    plain = buf;
+  }
+  const lines = plain.toString('utf8').split('\n');
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line = lines[i];
+    if (line.trim().length === 0) continue; // 帧边界产物（空行）跳过
+    try {
+      const decoded = decodeStorageRecord(JSON.parse(line));
+      if (decoded.length > 0) return decoded[decoded.length - 1].seq;
+    } catch { /* 损坏行/不可解析：继续向前找 */ }
+  }
+  return null;
+}
+
 /**
  * 读取并解码一个会话日志文件（.jsonl / .jsonl.zstd / 任意带 zstd 魔数的文件）。
  *

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "dsh-log-contract",
   "description": "日志契约守护 — DSH session log contract guard: offline health check (CLI) + pre-write validation for DeepSeek Harness session logs",
-  "version": "0.3.0",
-  "packageManager": "pnpm@11.7.0",
+  "version": "0.3.2",
   "type": "module",
   "main": "lib/index.js",
   "bin": {
@@ -27,11 +26,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "check": "node scripts/check-syntax.mjs",
-    "test": "vitest run",
-    "prepublishOnly": "pnpm check && pnpm test"
-  },
   "keywords": [
     "dsh",
     "deepseek-harness",
@@ -64,5 +58,9 @@
     "@deepseek-ai/dsh-session": "0.1.0-rc.7",
     "esbuild": "0.28.2",
     "vitest": "4.1.11"
+  },
+  "scripts": {
+    "check": "node scripts/check-syntax.mjs",
+    "test": "vitest run"
   }
-}
+}