@deepseek-ai/dsh-session-projection-cache 0.1.3-alpha.2 → 0.1.5-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.i18n.yaml CHANGED
@@ -2,5 +2,5 @@
2
2
  # side as of the last confirmed-consistent state. Both languages carry equal authority;
3
3
  # after editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/session/session-projection-cache/README.md
5
- README.md: ba90e838763787d28e5b6e278d868504fc672c5f
6
- README.zh.md: 8b3fe4148d408af75194212e4787a7cdb9030507
5
+ README.md: dcbe57af1f9c13f1f43572ff188dfdaaf9287160
6
+ README.zh.md: 367d893c56a23e0965eb1e10f42fb6705284af6b
package/README.md CHANGED
@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
9
9
 
10
10
  ## Summary
11
11
 
12
- `dsh-session-projection-cache` persists the state checkpoints of every registered projection unit (`ctx.sessionProjectionCache`) as one versioned document per session in the `session_projcache` storage domain's `per-record` layout. The shipped JSON backend stores each record at `<root>/session_projcache/sessions/<id>.json`, and the cache never reads the session-persistence layer. A stored row is a fold shortcut, never an authority: it may be stale its `seq` says exactly how stale but never wrong. Three mandatory checkpoints (session creation, `turn/end`, and session disposal) plus configurable count and interval throttles keep the cache fresh. Choose it when list views need synchronous cached values or cold projection folds should skip an already-checkpointed prefix.
12
+ This package keeps durable per-session projection checkpoints so history lists, statistics, and goal snapshots can read cached values without loading each session log. Cold projection folds can resume after the checkpointed prefix, reducing restart work. The session log remains authoritative: a crash can leave a checkpoint stale, but never ahead of committed events, and incompatible records are ignored or backed up. Choose it for restarted sessions with frequent projection reads; skip it when projections are live-only or extra storage writes and unbounded checkpoint retention outweigh the saved work.
13
13
 
14
14
  ## Table of Contents
15
15
 
package/README.zh.md CHANGED
@@ -9,7 +9,7 @@ kind: "package-reference"
9
9
 
10
10
  ## 概述
11
11
 
12
- `dsh-session-projection-cache` 将每个已注册投影单元的状态检查点(`ctx.sessionProjectionCache`)存为 `session_projcache` 存储域 `per-record` 布局下的逐会话版本化文档。随附 JSON 后端将每条记录存于 `<root>/session_projcache/sessions/<id>.json`,缓存绝不读取会话持久化层。存储行是折叠捷径,绝不是权威:它可能陈旧——`seq` 精确说明陈旧到哪——但绝不会错。三个必写点(会话创建、`turn/end` 与会话释放)加上可配置的条数与间隔节流让缓存保持新鲜。当列表视图需要同步缓存值,或冷投影折叠应跳过已检查点化的前缀时,选择本包。
12
+ 本包保存持久的逐会话投影检查点,让历史列表、统计信息与 goal 快照无需加载每个会话日志即可读取缓存值。冷投影折叠可从已检查点化的前缀之后继续,从而减少重启后的工作量。会话日志始终是权威:崩溃可能使检查点陈旧,但不会使其领先于已提交事件;不兼容记录会被忽略或备份。当重启的会话需要频繁读取投影时选择本包;当投影只服务实时会话,或额外存储写入与无限增长的检查点保留成本超过节省的工作量时跳过本包。
13
13
 
14
14
  ## 目录
15
15
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-session-projection-cache",
3
3
  "description": "Persisted projection cache (ctx.sessionProjectionCache): durable per-session checkpoint records on the session_projcache storage domain (per-record layout), throttled write-behind, and the cached listing read",
4
- "version": "0.1.3-alpha.2",
4
+ "version": "0.1.5-alpha.1",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -28,21 +28,21 @@
28
28
  "license": "MIT",
29
29
  "dependencies": {
30
30
  "zod": "^4.4.3",
31
- "@deepseek-ai/dsh-util-values": "^0.1.3-alpha.2",
31
+ "@deepseek-ai/dsh-util-values": "^0.1.5-alpha.1",
32
32
  "@deepseek-ai/schemastery": "^3.18.2"
33
33
  },
34
34
  "peerDependencies": {
35
+ "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
35
36
  "@deepseek-ai/cordis": "^4.0.2",
36
- "@deepseek-ai/dsh-session-projection": "^0.1.3-alpha.2",
37
- "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
38
- "@deepseek-ai/dsh-storage-domain": "^0.1.3-alpha.2"
37
+ "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
38
+ "@deepseek-ai/dsh-storage-domain": "^0.1.5-alpha.1"
39
39
  },
40
40
  "devDependencies": {
41
41
  "@deepseek-ai/cordis": "^4.0.2",
42
- "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
43
- "@deepseek-ai/dsh-session-projection": "^0.1.3-alpha.2",
44
- "@deepseek-ai/dsh-storage": "^0.1.3-alpha.2",
45
- "@deepseek-ai/dsh-storage-domain": "^0.1.3-alpha.2",
46
- "@deepseek-ai/dsh-storage-json": "^0.1.3-alpha.2"
42
+ "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
43
+ "@deepseek-ai/dsh-storage": "^0.1.5-alpha.1",
44
+ "@deepseek-ai/dsh-storage-domain": "^0.1.5-alpha.1",
45
+ "@deepseek-ai/dsh-storage-json": "^0.1.5-alpha.1",
46
+ "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1"
47
47
  }
48
48
  }