@x1a0f3n9/dsh-session-persistence 0.1.5-rc.2 → 0.1.5-rc.4

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/session/session-persistence/README.md
-README.md: 0970543eb0fbb38e3efa34e1447ac7cd82805cee
-README.zh.md: 9939c2124ee14cc27c5beb0eb23c7550efbd749f
+README.md: 16111343b95b9598417d91ee1836783371e8c209
+README.zh.md: 16f631cff6e1979f733de2261fe5c1020a1933ff

package/README.md

@@ -80,7 +80,7 @@ The package is a seam, not a backend framework: it exports the abstract `Session
 
 ### The invariants every backend honors
 
-- **Contiguous `seq`.** Ordinary `append` never rewrites committed events; an explicit persistence `truncate` is the destructive exception that replaces the current generation's retained prefix. `append`'s first `seq` must equal the stored next-seq, and a gap rejects.
+- **Contiguous `seq`.** Ordinary `append` never rewrites committed events; an explicit persistence `truncate` is the destructive exception that replaces the current generation's retained prefix. `append`'s first `seq` must equal the stored next-seq, and a gap rejects. Destructive truncate drops routed live events at or past the retained length so a later flush cannot replay the discarded tail.
 - **A torn physical tail never reaches a reader.** It belongs to an append that never resolved; the write path truncates it durably before its first new append.
 - **Lossless JSON data.** Batches and headers pass the shared one-pass validate-and-snapshot boundary (`materializeAppendBatch`/`materializeCreateHeader`); non-serializable payloads reject at the call site.
 - **Durability.** `append` persists best-effort; `flush` — per handle or service-wide — is the barrier that promises storage and also materializes an empty session.

package/README.zh.md

@@ -80,7 +80,7 @@ await ctx.sessionPersistence.flush()                           // backend-wide d
 
 ### 每个后端必须遵守的不变量
 
-- **连续 `seq`。** 普通 `append` 绝不重写已提交事件；显式的 persistence `truncate` 是破坏性例外，它替换当前 generation 的保留前缀。`append` 的第一个 `seq` 必须等于已存储 next-seq，缺口会被拒绝。
+- **连续 `seq`。** 普通 `append` 绝不重写已提交事件；显式的 persistence `truncate` 是破坏性例外，它替换当前 generation 的保留前缀。`append` 的第一个 `seq` 必须等于已存储 next-seq，缺口会被拒绝。破坏性 truncate 会丢弃序号大于等于保留长度的已路由实时事件，避免后续 flush 重放被丢弃的尾部。
 - **撕裂的物理尾部绝不到达读取方。** 它属于一次从未完成的 append；写路径在第一次新 append 之前将其持久截断。
 - **无损 JSON 数据。** 批次与 header 经过共享的单遍校验并快照边界（`materializeAppendBatch`/`materializeCreateHeader`）；无法序列化的载荷在调用处被拒绝。
 - **持久性。** `append` 尽力而为地持久化；`flush`——逐句柄或服务级——是承诺存储并同时把空会话实体化的屏障。

package/lib/index.js

@@ -267,7 +267,9 @@ var SessionPersistence = class extends Service {
 	/**
 	* Permanently replace one session's durable event log with an earlier prefix.
 	* The caller must apply the matching in-memory truncation only after this
-	* promise resolves. Backends that do not support rewriting reject loudly.
+	* promise resolves. The backend must drop routed live events at or past
+	* `_length` so a later flush cannot replay the discarded tail. Backends that
+	* do not support rewriting reject loudly.
 	* @param _id - the live session whose durable log is being rewritten.
 	* @param _length - number of events to retain.
 	* @returns resolution after the retained prefix is durable.

package/lib/types/index.d.ts

@@ -183,7 +183,9 @@ export declare abstract class SessionPersistence extends Service {
     /**
      * Permanently replace one session's durable event log with an earlier prefix.
      * The caller must apply the matching in-memory truncation only after this
-     * promise resolves. Backends that do not support rewriting reject loudly.
+     * promise resolves. The backend must drop routed live events at or past
+     * `_length` so a later flush cannot replay the discarded tail. Backends that
+     * do not support rewriting reject loudly.
      * @param _id - the live session whose durable log is being rewritten.
      * @param _length - number of events to retain.
      * @returns resolution after the retained prefix is durable.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@x1a0f3n9/dsh-session-persistence",
   "description": "Abstract durable session persistence seam (ctx.sessionPersistence) for the DeepSeek Harness",
-  "version": "0.1.5-rc.2",
+  "version": "0.1.5-rc.4",
   "publishConfig": {
     "access": "public"
   },
@@ -28,18 +28,18 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@x1a0f3n9/dsh-brand": "^0.1.5-rc.2",
-    "@x1a0f3n9/dsh-session": "^0.1.5-rc.2",
-    "@x1a0f3n9/dsh-timeout": "^0.1.5-rc.2"
+    "@x1a0f3n9/dsh-brand": "^0.1.5-rc.4",
+    "@x1a0f3n9/dsh-session": "^0.1.5-rc.4",
+    "@x1a0f3n9/dsh-timeout": "^0.1.5-rc.4"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@x1a0f3n9/dsh-brand": "^0.1.5-rc.2",
-    "@x1a0f3n9/dsh-scope": "^0.1.5-rc.2",
-    "@x1a0f3n9/dsh-timeout": "^0.1.5-rc.2",
-    "@x1a0f3n9/dsh-session": "^0.1.5-rc.2"
+    "@x1a0f3n9/dsh-brand": "^0.1.5-rc.4",
+    "@x1a0f3n9/dsh-scope": "^0.1.5-rc.4",
+    "@x1a0f3n9/dsh-session": "^0.1.5-rc.4",
+    "@x1a0f3n9/dsh-timeout": "^0.1.5-rc.4"
   },
   "dependencies": {
-    "@x1a0f3n9/dsh-util-values": "^0.1.5-rc.2"
+    "@x1a0f3n9/dsh-util-values": "^0.1.5-rc.4"
   }
 }