@lmzhen/dsh-evolution-replay 0.3.81 → 0.3.83

package/README.md

@@ -1,4 +1,4 @@
-# @deepseek-ai/dsh-evolution-replay
+# @lmzhen/dsh-evolution-replay
 
 Replay/A-B evaluation primitives for evolution plans
 
@@ -8,7 +8,7 @@ Replay/A-B evaluation primitives for evolution plans
 
 #### What the model sees
 
-`@deepseek-ai/dsh-evolution-replay` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
+`@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
 

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,8 +94,15 @@ 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". PLAN S5.1 (2026-09-16): this holds the
+	* most recent READ's verdict, not the first one — {@link EvolutionReplayDriver.markSourceReadable}
+	* clears it on a later clean read, so the qualification reflects the present
+	* instead of latching for the driver lifetime. */
+	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
+	* plan-applied landing inside the one-shot `loadActivityState` read window is
 	* recorded live AND persisted into the sidecar the backfill is reading —
 	* `backfill()` drops those ids so the event is not counted twice.
 	*
@@ -188,8 +195,41 @@ 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 — until a later read says otherwise
+	* (see {@link EvolutionReplayDriver.markSourceReadable}).
+	*/
+	markSourceUnreadable() {
+		this.sourceCorrupt = true;
+	}
+	/**
+	* PLAN S5.1 (2026-09-16, audit P2-18): the counterpart clear — `apply()` calls
+	* this on every successful read whose bytes ARE the current format
+	* (`loadActivityState` answered `corrupt: false`), so the
+	* {@link ReplayResult.sourceCorrupt} qualification follows the CURRENT read
+	* state. Before this the flag latched for the driver lifetime: a repaired
+	* sidecar plus an io reload (HMR / plugin restart) backfilled the full
+	* history while `compare()` kept asserting "NOT the recorded history" — a
+	* permanent report claim contrary to fact. The corruption verdict is
+	* per-read; the past corruption itself stays observable through the warn
+	* `apply()` emits at mark time.
+	*/
+	markSourceReadable() {
+		this.sourceCorrupt = false;
+	}
 	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 +244,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();
+			} else driver.markSourceReadable();
+			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,13 @@ export interface ReplayResult {
     margin: number | null;
     plans: ReplayPlan[];
     report: string;
+    /** FLOW6-6 (v43): the activity sidecar could not be read as the current
+     * format at the most recent backfill read — `plans` is then NOT the
+     * recorded history, and the report says so. PLAN S5.1 (2026-09-16): the
+     * flag tracks the CURRENT read state, so a later clean read (the sidecar
+     * was repaired and an io reload re-read it) clears the qualification —
+     * it never outlives the condition it describes. */
+    sourceCorrupt?: boolean | undefined;
 }
 export interface ReplayWeights {
     accepted: number;
@@ -76,8 +83,15 @@ 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". PLAN S5.1 (2026-09-16): this holds the
+     * most recent READ's verdict, not the first one — {@link EvolutionReplayDriver.markSourceReadable}
+     * clears it on a later clean read, so the qualification reflects the present
+     * instead of latching for the driver lifetime. */
+    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
+     * plan-applied landing inside the one-shot `loadActivityState` read window is
      * recorded live AND persisted into the sidecar the backfill is reading —
      * `backfill()` drops those ids so the event is not counted twice.
      *
@@ -121,6 +135,26 @@ 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 — until a later read says otherwise
+     * (see {@link EvolutionReplayDriver.markSourceReadable}).
+     */
+    markSourceUnreadable(): void;
+    /**
+     * PLAN S5.1 (2026-09-16, audit P2-18): the counterpart clear — `apply()` calls
+     * this on every successful read whose bytes ARE the current format
+     * (`loadActivityState` answered `corrupt: false`), so the
+     * {@link ReplayResult.sourceCorrupt} qualification follows the CURRENT read
+     * state. Before this the flag latched for the driver lifetime: a repaired
+     * sidecar plus an io reload (HMR / plugin restart) backfilled the full
+     * history while `compare()` kept asserting "NOT the recorded history" — a
+     * permanent report claim contrary to fact. The corruption verdict is
+     * per-read; the past corruption itself stays observable through the warn
+     * `apply()` emits at mark time.
+     */
+    markSourceReadable(): 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.83",
   "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.83",
+    "@lmzhen/dsh-evolution-core": "^0.3.83"
   },
   "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.83",
+    "@lmzhen/dsh-evolution-core": "^0.3.83"
   }
 }