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

package/README.md

@@ -1,28 +1,19 @@
 # @lmzhen/dsh-evolution-state-json
 
-JSON-file evolution state provider over the IO seam: review, curator and pending records are JSON
-files under the state root, so the medium behind `ctx.evolutionIo` can change without a format
-change.
+> 内部组件，默认的本地状态存储。
 
-## Model surface
+## 你会看到
 
-- **Model-visible:** nothing of its own: the rows that read this state own the injection.
-- **Prompt prefix / KV cache:** unchanged by this package: family-level rules single-sourced in `packages/README.md` §"Model-visible prompt prefix and the KV cache".
-- **Mount it?** yes — the `evolution-state-json` row, in `evolution-host`/`evolution-all`/one-click `evolution-preset` (it is the medium they pin).
+没有命令、面板或工具入口。
 
-## Configuration
+## 什么时候会用到
 
-- `root`: the directory the state files live in; `''` means the evolution home.
+只在排障状态时。
 
-## Known limitations
+## 默认 / 前提
 
-- Both tables are capped (200 pending, 500 sessions), and past the pending cap the DOMAIN provider deletes instead of archiving: this provider keeps an audit sidecar. The `updatedAt` stamp is stripped on read, so the consumer-facing record shape is unchanged.
-- All shipped JSON media are **single-process**: the IO backend has no cross-process lock. A second process sharing `DSH_HOME` is not coordinated; route multi-process deployments to a platform-provided cross-process backend before relying on this provider.
+默认启用。
 
-**Runtime invariant:** No companion is published. The platform auto-assembles nothing and the family mounts no `<pkg>/invariant` cordis row, so a companion here would never execute (v37 S2.1 / I-3).
+## 边界
 
-## Notes and history
-
-- P2-4 (v15): the live pending map is BOUNDED — resolved (approved/rejected) records are kept to the most recent `PENDING_RESOLVED_CAP` (200, seam constant in `evolution-state-storage`); the oldest by `resolvedAt` rotate into the `pending-state-archive.json` sidecar (with `.bak` rotation), which is JSON-provider-specific.
-- V25-11 (v25): the review-state table is likewise BOUNDED: `REVIEW_STATE_SESSION_CAP` (500, seam constant) rows keyed by session; on every save the least-recently-active sessions (provider-stamped `updatedAt`, stored on disk only) are pruned.
-- The JSON provider serializes writers inside one process only (the internal transact wrapper is not public API, audit v10 S-03). It does **not** claim cross-process safety; the shipped IO backend declares single-process.
+损坏文件会被隔离，不会静默覆盖。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-state-json",
   "description": "JSON-file evolution state provider over the IO seam (community build)",
-  "version": "0.32.4",
+  "version": "0.32.5",
   "publishConfig": {
     "access": "public"
   },
@@ -27,17 +27,17 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-core": "^0.32.4"
+    "@lmzhen/dsh-evolution-core": "^0.32.5"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
-    "@lmzhen/dsh-evolution-io": "^0.32.4",
-    "@lmzhen/dsh-evolution-state-storage": "^0.32.4"
+    "@lmzhen/dsh-evolution-io": "^0.32.5",
+    "@lmzhen/dsh-evolution-state-storage": "^0.32.5"
   },
   "devDependencies": {
-    "@lmzhen/dsh-evolution-io": "^0.32.4",
-    "@lmzhen/dsh-evolution-state-storage": "^0.32.4",
-    "@lmzhen/dsh-evolution-io-node": "^0.32.4"
+    "@lmzhen/dsh-evolution-io": "^0.32.5",
+    "@lmzhen/dsh-evolution-state-storage": "^0.32.5",
+    "@lmzhen/dsh-evolution-io-node": "^0.32.5"
   },
   "engines": {
     "dsh": ">=0.2.1-rc.2 <0.2.2-0"