@lmzhen/dsh-evolution-replay 0.3.81 → 0.3.82

package/lib/index.js

@@ -1,6 +1,6 @@
 import z from "@deepseek-ai/schemastery";
 import { clampedNumber, evolutionHome, evolutionIoAdapter } from "@lmzhen/dsh-evolution-core";
-import { loadActivity } from "@lmzhen/dsh-evolution-activity";
+import { loadActivityState } from "@lmzhen/dsh-evolution-activity";
 //#region lib/types/index.js
 /**
 * Replay/A-B evaluation for evolution plans.
@@ -94,6 +94,10 @@ var EvolutionReplayDriver = class EvolutionReplayDriver {
 	maxPlans;
 	/** V25-01 (v25): backfill-once latch — see {@link EvolutionReplayDriver.backfill}. */
 	backfilled = false;
+	/** FLOW6-6 (v43): the backfill source was unreadable (newer format or corrupt
+	* bytes) — carried into every comparison so an empty leaderboard is never
+	* presented as "nothing was recorded". */
+	sourceCorrupt = false;
 	/** V26-05 (v25): plan ids recorded live BEFORE the backfill settled. A
 	* plan-applied landing inside the one-shot `loadActivity` read window is
 	* recorded live AND persisted into the sidecar the backfill is reading —
@@ -188,8 +192,25 @@ var EvolutionReplayDriver = class EvolutionReplayDriver {
 	plansSnapshot() {
 		return [...this.plans];
 	}
+	/**
+	* FLOW6-6 (v43): mark the backfill source unreadable. Set by `apply()` when
+	* the activity sidecar carries bytes this build cannot read; the qualification
+	* then travels with every comparison.
+	*/
+	markSourceUnreadable() {
+		this.sourceCorrupt = true;
+	}
 	compare(weights = this.weights) {
-		return comparePlans([...this.plans], clampReplayWeights(weights, this.weights));
+		const result = comparePlans([...this.plans], clampReplayWeights(weights, this.weights));
+		if (!this.sourceCorrupt) return {
+			...result,
+			sourceCorrupt: false
+		};
+		return {
+			...result,
+			sourceCorrupt: true,
+			report: "The activity sidecar could not be read as the current format (corrupt bytes or a newer writer) — this leaderboard is NOT the recorded history, and an empty list does not mean nothing happened.\n" + result.report
+		};
 	}
 };
 const name = "evolution-replay";
@@ -204,8 +225,12 @@ function apply(ctx, rawConfig = {}) {
 	ctx.inject(["evolutionIo"], (ioCtx) => {
 		const ioRegistry = ioCtx.evolutionIo;
 		const io = evolutionIoAdapter(() => ioRegistry.provider());
-		loadActivity(evolutionHome(), io).then((items) => {
-			driver.backfill(items);
+		loadActivityState(evolutionHome(), io).then((loaded) => {
+			if (loaded.corrupt) {
+				ioCtx.logger.warn("evolution-replay: the activity sidecar could not be read as the current format (corrupt bytes or a newer writer) — the leaderboard backfilled from it is INCOMPLETE; the writer quarantines those bytes on its next append");
+				driver.markSourceUnreadable();
+			}
+			driver.backfill(loaded.records);
 		}).catch((error) => {
 			ioCtx.logger.warn(`evolution-replay: activity sidecar backfill skipped (${error instanceof Error ? error.message : String(error)})`);
 		});

package/lib/types/index.d.ts

@@ -44,6 +44,10 @@ export interface ReplayResult {
     margin: number | null;
     plans: ReplayPlan[];
     report: string;
+    /** FLOW6-6 (v43): the activity sidecar could not be read as the current
+     * format when this leaderboard was backfilled — `plans` is then NOT the
+     * recorded history, and the report says so. */
+    sourceCorrupt?: boolean | undefined;
 }
 export interface ReplayWeights {
     accepted: number;
@@ -76,6 +80,10 @@ export declare class EvolutionReplayDriver {
     private readonly maxPlans;
     /** V25-01 (v25): backfill-once latch — see {@link EvolutionReplayDriver.backfill}. */
     private backfilled;
+    /** FLOW6-6 (v43): the backfill source was unreadable (newer format or corrupt
+     * bytes) — carried into every comparison so an empty leaderboard is never
+     * presented as "nothing was recorded". */
+    private sourceCorrupt;
     /** V26-05 (v25): plan ids recorded live BEFORE the backfill settled. A
      * plan-applied landing inside the one-shot `loadActivity` read window is
      * recorded live AND persisted into the sidecar the backfill is reading —
@@ -121,6 +129,12 @@ export declare class EvolutionReplayDriver {
      * @internal Exported for this package's own tests only.
      */
     plansSnapshot(): ReplayPlan[];
+    /**
+     * FLOW6-6 (v43): mark the backfill source unreadable. Set by `apply()` when
+     * the activity sidecar carries bytes this build cannot read; the qualification
+     * then travels with every comparison.
+     */
+    markSourceUnreadable(): void;
     compare(weights?: ReplayWeights): ReplayResult;
 }
 export declare const name = "evolution-replay";

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.81",
+  "version": "0.3.82",
   "publishConfig": {
     "access": "public"
   },
@@ -27,14 +27,14 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-activity": "^0.3.81",
-    "@lmzhen/dsh-evolution-core": "^0.3.81"
+    "@lmzhen/dsh-evolution-activity": "^0.3.82",
+    "@lmzhen/dsh-evolution-core": "^0.3.82"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "devDependencies": {
-    "@lmzhen/dsh-evolution-activity": "^0.3.81",
-    "@lmzhen/dsh-evolution-core": "^0.3.81"
+    "@lmzhen/dsh-evolution-activity": "^0.3.82",
+    "@lmzhen/dsh-evolution-core": "^0.3.82"
   }
 }