@lmzhen/dsh-evolution-state-json 0.32.5 → 0.33.0

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.
Files changed (2) hide show
  1. package/README.md +6 -12
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -1,19 +1,13 @@
1
1
  # @lmzhen/dsh-evolution-state-json
2
2
 
3
- > 内部组件,默认的本地状态存储。
3
+ Default JSON state provider over the family IO seam. It stores review, curator, and pending records without requiring the platform storage-domain service.
4
4
 
5
- ## 你会看到
5
+ `root` defaults to the evolution home. The principal files are `review-state.json`, `curator-state.json`, and `pending-state.json`; the pre-split `pending.json` is read-only legacy input that is retired after migration.
6
6
 
7
- 没有命令、面板或工具入口。
7
+ ## Retention and corruption behavior
8
8
 
9
- ## 什么时候会用到
9
+ Resolved pending records are capped at 200 in the live map. Older records move to `pending-state-archive.json`, whose own history rotates to a `.bak` sidecar after 5,000 records. Pending/executing work is not trimmed by the resolved cap. Review cadence state is capped at 500 sessions.
10
10
 
11
- 只在排障状态时。
11
+ Malformed state is not accepted as an empty store. The provider preserves the original bytes in a `.corrupt` copy when possible and fails loudly so a later save cannot silently overwrite recoverable state. Quarantine copies have a bounded rescue window handled by the Node IO backend.
12
12
 
13
- ## 默认 / 前提
14
-
15
- 默认启用。
16
-
17
- ## 边界
18
-
19
- 损坏文件会被隔离,不会静默覆盖。
13
+ Read-modify-write safety depends on the selected IO backend. The shipped Node backend serializes within one process only; see [evolution-io-node](../evolution-io-node/README.md) before sharing one home between processes.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@lmzhen/dsh-evolution-state-json",
3
3
  "description": "JSON-file evolution state provider over the IO seam (community build)",
4
- "version": "0.32.5",
4
+ "version": "0.33.0",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -27,17 +27,17 @@
27
27
  "license": "MIT",
28
28
  "dependencies": {
29
29
  "@deepseek-ai/schemastery": "^3.18.5",
30
- "@lmzhen/dsh-evolution-core": "^0.32.5"
30
+ "@lmzhen/dsh-evolution-core": "^0.33.0"
31
31
  },
32
32
  "peerDependencies": {
33
33
  "@deepseek-ai/cordis": "^4.0.5",
34
- "@lmzhen/dsh-evolution-io": "^0.32.5",
35
- "@lmzhen/dsh-evolution-state-storage": "^0.32.5"
34
+ "@lmzhen/dsh-evolution-io": "^0.33.0",
35
+ "@lmzhen/dsh-evolution-state-storage": "^0.33.0"
36
36
  },
37
37
  "devDependencies": {
38
- "@lmzhen/dsh-evolution-io": "^0.32.5",
39
- "@lmzhen/dsh-evolution-state-storage": "^0.32.5",
40
- "@lmzhen/dsh-evolution-io-node": "^0.32.5"
38
+ "@lmzhen/dsh-evolution-io": "^0.33.0",
39
+ "@lmzhen/dsh-evolution-state-storage": "^0.33.0",
40
+ "@lmzhen/dsh-evolution-io-node": "^0.33.0"
41
41
  },
42
42
  "engines": {
43
43
  "dsh": ">=0.2.1-rc.2 <0.2.2-0"