@lmzhen/dsh-evolution-replay 0.3.82 → 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

@@ -96,10 +96,13 @@ var EvolutionReplayDriver = class EvolutionReplayDriver {
 	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". */
+	* 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.
 	*
@@ -195,11 +198,27 @@ var EvolutionReplayDriver = class EvolutionReplayDriver {
 	/**
 	* 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.
+	* 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) {
 		const result = comparePlans([...this.plans], clampReplayWeights(weights, this.weights));
 		if (!this.sourceCorrupt) return {
@@ -229,7 +248,7 @@ function apply(ctx, rawConfig = {}) {
 			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

@@ -45,8 +45,11 @@ export interface ReplayResult {
     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. */
+     * 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 {
@@ -82,10 +85,13 @@ export declare class EvolutionReplayDriver {
     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". */
+     * 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.
      *
@@ -132,9 +138,23 @@ export declare class EvolutionReplayDriver {
     /**
      * 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.
+     * 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.82",
+  "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.82",
-    "@lmzhen/dsh-evolution-core": "^0.3.82"
+    "@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.82",
-    "@lmzhen/dsh-evolution-core": "^0.3.82"
+    "@lmzhen/dsh-evolution-activity": "^0.3.83",
+    "@lmzhen/dsh-evolution-core": "^0.3.83"
   }
 }