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

package/README.md

@@ -1,28 +1,13 @@
 # @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.
+Default JSON state provider over the family IO seam. It stores review, curator, and pending records without requiring the platform storage-domain service.
 
-## Model surface
+`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.
 
-- **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).
+## Retention and corruption behavior
 
-## Configuration
+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.
 
-- `root`: the directory the state files live in; `''` means the evolution home.
+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.
 
-## 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.
+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

@@ -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.6",
   "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.6"
   },
   "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.6",
+    "@lmzhen/dsh-evolution-state-storage": "^0.32.6"
   },
   "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.6",
+    "@lmzhen/dsh-evolution-state-storage": "^0.32.6",
+    "@lmzhen/dsh-evolution-io-node": "^0.32.6"
   },
   "engines": {
     "dsh": ">=0.2.1-rc.2 <0.2.2-0"