@lmzhen/dsh-evolution-replay 0.3.83 → 0.4.0

package/README.md

@@ -1,26 +1,18 @@
 # @lmzhen/dsh-evolution-replay
 
-Replay/A-B evaluation primitives for evolution plans
+Replay/A-B evaluation primitives for evolution plans: it reads the activity sidecar back,
+compares plan outcomes and provides the `evolutionReplay` service behind `evolution
+replay`.
 
-## Model Experience
+## Model surface
 
-### Indirect model surface
-
-#### What the model sees
-
-`@lmzhen/dsh-evolution-replay` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
-
-#### Token effect
-
-Zero direct token effect from this package; consumers add any model-visible tokens.
-
-#### KV Cache effect
-
-Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
-
-## Known Limitations and Deferred Work
+- **Model-visible:** nothing of its own: no prompt section and no tool schema; `/evolution replay` is a human command; consumers own the model-visible effects.
+- **Prompt prefix / KV cache:** independent of request-prefix construction — it does not alter the assembled prompt or tool list; family rules: `packages/README.md` §"Model-visible prompt prefix and the KV cache".
+- **Mount it?** yes — the `evolution-replay` row, carried by the `evolution-host`, `evolution-all` and one-click `evolution-preset` bundles.
 
+## Known limitations
 
 - No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.
+- **The activity-sidecar verdict is per read (`sourceCorrupt`).** When `apply()` meets bytes this build cannot read as the current format, every `compare()` result carries `sourceCorrupt: true` and its report states the leaderboard is NOT the recorded history (an empty list does not mean nothing happened); a later successful read clears the qualification (a repaired sidecar plus an io reload (HMR / plugin restart)), while the corruption stays observable through the one warn `apply()` emits at mark time.
 
-**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).
+**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).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-replay",
   "description": "Replay/A-B evaluation primitives for evolution plans (community build)",
-  "version": "0.3.83",
+  "version": "0.4.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,14 +27,14 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-activity": "^0.3.83",
-    "@lmzhen/dsh-evolution-core": "^0.3.83"
+    "@lmzhen/dsh-evolution-activity": "^0.4.0",
+    "@lmzhen/dsh-evolution-core": "^0.4.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "devDependencies": {
-    "@lmzhen/dsh-evolution-activity": "^0.3.83",
-    "@lmzhen/dsh-evolution-core": "^0.3.83"
+    "@lmzhen/dsh-evolution-activity": "^0.4.0",
+    "@lmzhen/dsh-evolution-core": "^0.4.0"
   }
 }