@lmzhen/dsh-evolution-activity 0.3.82 → 0.4.0

package/README.md

@@ -1,34 +1,28 @@
-# @deepseek-ai/dsh-evolution-activity
+# @lmzhen/dsh-evolution-activity
 
-Durable activity store for self-evolution plan outcomes
+Durable activity store for self-evolution plan outcomes: it subscribes to the `evolution/plan-applied`
+process event (payload v2, with sessionId) and append-merges every outcome into
+`$DSH_HOME/evolution/activity.json` through the evolution IO seam — load → fold → save under an
+in-process queue, so records survive host restarts and are readable without a session. A
+session log carrying `evolution/*` types is refused wholesale at resume, so plan-outcome
+durability lives here; a storage-domain table is deferred until a consumer needs domain routing.
 
-## What it does
+## Model surface
 
-Subscribes to the process event `evolution/plan-applied` (payload v2, with sessionId) and persists every plan outcome to `$DSH_HOME/evolution/activity.json` through the evolution IO seam — the same best-effort sidecar posture as `feedback.json` and the curator reports. The sidecar is append-merge (load → fold → save under an in-process queue), so records survive host restarts and are readable without a session. The retired session projection is gone: a session log carrying `evolution/*` types is refused wholesale at resume, so plan-outcome durability lives here instead. A storage-domain table is deferred until a consumer needs domain routing.
-
-## Model Experience
-
-### Indirect model surface
-
-#### What the model sees
-
-`@deepseek-ai/dsh-evolution-activity` 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.
+- **Model-visible:** nothing of its own: the rows and commands that read the sidecar own the injection; it backs `/evolution replay` (`evolution-replay`).
+- **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-activity` row, in `evolution-host`/`evolution-all`/one-click `evolution-preset`.
 
 ## Configuration
 
-- `maxItems`: bound on the retained activity sidecar (default `DEFAULT_MAX_ITEMS = 200`). A non-finite value (NaN/±Infinity) falls back to the default (0.3.19, S6.4 guard), while a non-positive value (0 or negative) fails loud at the schema — `z.number().min(1)` — because `slice(-0)` would keep everything and disable the retention window (G3.1, 0.3.23).
-
-## Known Limitations and Deferred Work
+- `maxItems` (default `DEFAULT_MAX_ITEMS = 200`): bound on the retained sidecar; a non-finite value falls back to the default, a non-positive value fails loud at the schema.
 
+## Known limitations
 
-- Each event lands through `transactIo` (like `feedback.json`), so append cycles are cross-process atomic at the single-write granularity; the read-modify-write of one event is serialized in-process and atomic on disk. A multi-record batch is still one event at a time — no batch transaction exists.
+- Each event lands through `transactIo` (like `feedback.json`), so append cycles are cross-process atomic at the single-write granularity; the read-modify-write of one event is serialized in-process and atomic on disk. A multi-record batch is still one event at a time: no batch transaction exists.
 
 **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
+
+- A non-finite value (NaN/±Infinity) falls back to the default (0.3.19, S6.4 guard), while a non-positive value (0 or negative) fails loud at the schema (`z.number().min(1)`) because `slice(-0)` would keep everything and disable the retention window (G3.1, 0.3.23).

package/lib/index.js

@@ -83,13 +83,14 @@ async function loadActivityState(root, io) {
 	};
 }
 /**
-* H-06: the read barrier over the sidecar. V24-13 (v24): `loadActivity` now
-* HAS a production consumer — `evolution-replay` backfills its `/evolution
-* replay` leaderboard from this store at mount (the two packages'
-* "persistence is the activity store's job" contract is actually wired
-* through this call). The single-writer rule is unchanged: `apply()`'s
-* transact listener remains the only WRITE path. Consumers that must not read
-* an unreadable sidecar as "no history" use {@link loadActivityState}.
+* H-06: the read barrier over the sidecar — records only, no corruption
+* verdict. @internal Test-only: no production caller (verified by grep
+* 2026-09-16); replay consumes {@link loadActivityState} — the V24-13 claim
+* that `loadActivity` "HAS a production consumer — evolution-replay" was
+* inaccurate (PLAN S5.2). Kept exported so the published surface does not
+* break. The single-writer rule is unchanged: `apply()`'s transact listener
+* remains the only WRITE path. Consumers that must not read an unreadable
+* sidecar as "no history" use {@link loadActivityState}.
 */
 async function loadActivity(root, io) {
 	return (await loadActivityState(root, io)).records;

package/lib/types/index.d.ts

@@ -52,14 +52,6 @@ export declare function applyActivityEvent(items: EvolutionActivityRecord[], eve
  * `parseActivityContent` is the matching single reader. */
 export declare function serializeActivity(items: EvolutionActivityRecord[]): string;
 export declare function parseActivityContent(raw: string | null): EvolutionActivityRecord[];
-/**
- * H-06: the read barrier over the sidecar. V24-13 (v24): `loadActivity` now
- * HAS a production consumer — `evolution-replay` backfills its `/evolution
- * replay` leaderboard from this store at mount (the two packages'
- * "persistence is the activity store's job" contract is actually wired
- * through this call). The single-writer rule is unchanged: `apply()`'s
- * transact listener remains the only WRITE path.
- */
 /**
  * FLOW6-6 (v43, the read side of H-3): the sidecar's records PLUS whether the
  * bytes could be read as THIS format. `parseActivityContent` answers `[]` for
@@ -83,13 +75,14 @@ export interface ActivityLoad {
  */
 export declare function loadActivityState(root: string, io: EvolutionIoLike): Promise<ActivityLoad>;
 /**
- * H-06: the read barrier over the sidecar. V24-13 (v24): `loadActivity` now
- * HAS a production consumer — `evolution-replay` backfills its `/evolution
- * replay` leaderboard from this store at mount (the two packages'
- * "persistence is the activity store's job" contract is actually wired
- * through this call). The single-writer rule is unchanged: `apply()`'s
- * transact listener remains the only WRITE path. Consumers that must not read
- * an unreadable sidecar as "no history" use {@link loadActivityState}.
+ * H-06: the read barrier over the sidecar — records only, no corruption
+ * verdict. @internal Test-only: no production caller (verified by grep
+ * 2026-09-16); replay consumes {@link loadActivityState} — the V24-13 claim
+ * that `loadActivity` "HAS a production consumer — evolution-replay" was
+ * inaccurate (PLAN S5.2). Kept exported so the published surface does not
+ * break. The single-writer rule is unchanged: `apply()`'s transact listener
+ * remains the only WRITE path. Consumers that must not read an unreadable
+ * sidecar as "no history" use {@link loadActivityState}.
  */
 export declare function loadActivity(root: string, io: EvolutionIoLike): Promise<EvolutionActivityRecord[]>;
 /** True when bytes exist but are not a readable activity envelope: unparsable

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-activity",
   "description": "Durable activity store for self-evolution plan outcomes (community build)",
-  "version": "0.3.82",
+  "version": "0.4.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,15 +27,15 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.82"
+    "@lmzhen/dsh-evolution-core": "^0.4.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.82",
-    "@lmzhen/dsh-evolution-io": "^0.3.82",
-    "@lmzhen/dsh-evolution-io-node": "^0.3.82"
+    "@lmzhen/dsh-evolution-core": "^0.4.0",
+    "@lmzhen/dsh-evolution-io": "^0.4.0",
+    "@lmzhen/dsh-evolution-io-node": "^0.4.0"
   }
 }