@lmzhen/dsh-evolution-activity 0.3.17 → 0.3.19

package/README.md

@@ -1,6 +1,10 @@
 # @deepseek-ai/dsh-evolution-activity
 
-Session projection for self-evolution activity
+Durable activity store for self-evolution plan outcomes
+
+## What it does
+
+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
 
@@ -18,8 +22,11 @@ Zero direct token effect from this package; consumers add any model-visible toke
 
 Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
 
+## Configuration
+
+- `maxItems`: bound on the retained activity sidecar (default `DEFAULT_MAX_ITEMS = 200`). A non-finite value falls back to the default (0.3.19, S6.4 guard).
+
 ## Known Limitations and Deferred Work
 
 
-- The projection registers BOTH contract generations — `stateSchema` + `wire.viewSchema` (DSH 0.1.1+ session-projection contract) and legacy `schema` + `view` (0.1.0-rc.6 era) — because each registry ignores the fields it does not know. When the legacy fields are removed, drop the old half of the dual registration.
-- On 0.1.1+ hosts the cold-read path (`restore`) calls `stateSchema.parse` on checkpointed rows; a registration missing `stateSchema` would throw on the first cold read, so the new half is load-bearing, not cosmetic.
+- The sidecar is single-process safe only; two processes sharing `$DSH_HOME` can interleave append-merge cycles (same posture as `feedback.json` — a cross-process lock is deferred until a multi-process deployment exists).

package/lib/index.js

@@ -21,6 +21,9 @@ import { join } from "node:path";
 */
 /** Version of the `activity.json` shape; writers always emit the current one. */
 const ACTIVITY_FILE_VERSION = 2;
+/** Default bound on the retained sidecar (S6.4: also the fallback for a
+* non-finite `maxItems`). */
+const DEFAULT_MAX_ITEMS = 200;
 function activityFile(root) {
 	return join(root, "activity.json");
 }
@@ -37,7 +40,7 @@ function applyActivityEvent(items, event, maxItems, at = Date.now()) {
 		estimatedInputChars: event.estimatedInputChars,
 		at
 	};
-	const cap = Math.max(1, maxItems);
+	const cap = Number.isFinite(maxItems) ? Math.max(1, maxItems) : 200;
 	return [...items, record].slice(-cap);
 }
 /** Parse a raw sidecar into records; malformed content reads as empty (best-effort telemetry). */
@@ -62,28 +65,28 @@ async function saveActivity(root, items, io) {
 const name = "evolution-activity";
 const Config = z.object({ maxItems: z.number().default(200) });
 function apply(ctx, rawConfig = {}) {
-	const maxItems = rawConfig.maxItems ?? 200;
-	const ioRegistry = ctx.get("evolutionIo");
-	if (!ioRegistry) {
-		ctx.logger.warn("evolution-activity: no evolution IO provider mounted; plan outcomes will not be persisted");
-		return;
-	}
-	const io = evolutionIoAdapter(() => ioRegistry.provider());
-	const root = evolutionHome();
-	let chain = Promise.resolve();
-	ctx.on("evolution/plan-applied", (event) => {
-		const run = chain.then(() => transactIo(io, activityFile(root), (current) => {
-			const items = applyActivityEvent(parseActivityContent(current), event, maxItems);
-			return Promise.resolve(JSON.stringify({
-				version: 2,
-				items
-			}, null, 2));
-		}));
-		chain = run.then(() => void 0, () => void 0);
-		run.catch((error) => {
-			ctx.logger.warn(error instanceof Error ? error : String(error));
+	const configuredMaxItems = rawConfig.maxItems ?? 200;
+	const maxItems = Number.isFinite(configuredMaxItems) ? configuredMaxItems : 200;
+	if (!Number.isFinite(configuredMaxItems)) ctx.logger.warn(`evolution-activity: maxItems is not a finite number; falling back to the default 200`);
+	ctx.inject(["evolutionIo"], (ioCtx) => {
+		const ioRegistry = ioCtx.evolutionIo;
+		const io = evolutionIoAdapter(() => ioRegistry.provider());
+		const root = evolutionHome();
+		let chain = Promise.resolve();
+		ioCtx.on("evolution/plan-applied", (event) => {
+			const run = chain.then(() => transactIo(io, activityFile(root), (current) => {
+				const items = applyActivityEvent(parseActivityContent(current), event, maxItems);
+				return Promise.resolve(JSON.stringify({
+					version: 2,
+					items
+				}, null, 2));
+			}));
+			chain = run.then(() => void 0, () => void 0);
+			run.catch((error) => {
+				ioCtx.logger.warn(error instanceof Error ? error : String(error));
+			});
 		});
 	});
 }
 //#endregion
-export { ACTIVITY_FILE_VERSION, Config, activityFile, apply, applyActivityEvent, loadActivity, name, parseActivityContent, saveActivity };
+export { ACTIVITY_FILE_VERSION, Config, DEFAULT_MAX_ITEMS, activityFile, apply, applyActivityEvent, loadActivity, name, parseActivityContent, saveActivity };

package/lib/types/index.d.ts

@@ -32,6 +32,9 @@ export interface EvolutionActivityRecord {
 }
 /** Version of the `activity.json` shape; writers always emit the current one. */
 export declare const ACTIVITY_FILE_VERSION = 2;
+/** Default bound on the retained sidecar (S6.4: also the fallback for a
+ * non-finite `maxItems`). */
+export declare const DEFAULT_MAX_ITEMS = 200;
 export declare function activityFile(root: string): string;
 /** Fold one plan-applied payload into a bounded record list (pure). */
 export declare function applyActivityEvent(items: EvolutionActivityRecord[], event: EvolutionPlanAppliedEvent, maxItems: number, at?: number): EvolutionActivityRecord[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-activity",
   "description": "Session projection for self-evolution activity (community build)",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "publishConfig": {
     "access": "public"
   },
@@ -33,7 +33,7 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.17"
+    "@lmzhen/dsh-evolution-core": "^0.3.19"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -42,8 +42,8 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.3.17",
-    "@lmzhen/dsh-evolution-io": "^0.3.17",
-    "@lmzhen/dsh-evolution-io-node": "^0.3.17"
+    "@lmzhen/dsh-evolution-core": "^0.3.19",
+    "@lmzhen/dsh-evolution-io": "^0.3.19",
+    "@lmzhen/dsh-evolution-io-node": "^0.3.19"
   }
 }