@lmzhen/dsh-evolution-feedback 0.3.80 → 0.3.82

package/lib/index.js

@@ -30,6 +30,17 @@ const CACHE_VERSION = 2;
 * live in the ACTIVE log (bounded by `EVENT_LOG_ROTATE_AT`), so the next fold
 * is complete. Package-private tunable, not a config surface. */
 const CACHE_SNAP_EVERY = 1024;
+/** C-events-dispatch-1 (v43 audit): the timeline read flags a DROPPED band — an
+* unreadable archive (EISDIR/EACCES) or a body this v1 reader cannot interpret
+* (damaged, or a future version). The boot cache stores the fold BASELINE
+* (`lastSeq`), and `foldWithDelta` only folds `seq > lastSeq`, so folding a
+* truncated read back into it would seal the dropped band against every later
+* boot — the loss becomes unrecoverable without deleting the cache by hand.
+* Both cache writers withhold the refresh when that flag is set (the cache is
+* disposable by contract, so the last COMPLETE fold simply stays) and say so
+* through this ONE message, deduped to a single warn per process (V5-32) because
+* `refold()` re-runs `restore()` before every quality push. */
+const TRUNCATED_TIMELINE_WARN = "evolution-feedback: the evolution event timeline is TRUNCATED - at least one segment (an unreadable archive, or a body this v1 reader cannot interpret, e.g. a future version) was dropped, so the folded counts are incomplete; the boot cache was NOT updated (a truncated lastSeq would seal the missing band against every later boot)";
 var EvolutionFeedback = class EvolutionFeedback {
 	state = {
 		skills: {},
@@ -74,6 +85,21 @@ var EvolutionFeedback = class EvolutionFeedback {
 	attachIo(io) {
 		this.io = io;
 	}
+	/** V5-32 posture applied to the read side (C-events-dispatch-1, v43): an
+	* event a repeated read keeps reporting must not warn on each read —
+	* `refold()` calls `restore()` before every quality push. Shares the bounded
+	* `warnedMessages` set (and its FIFO eviction) with the append-failure warn.
+	* @param message - the warn text; identical text warns once per process.
+	*/
+	warnOnce(message) {
+		if (this.warnedMessages.has(message)) return;
+		if (this.warnedMessages.size >= this.WARNED_CAP) {
+			const oldest = this.warnedMessages.values().next().value;
+			if (oldest !== void 0) this.warnedMessages.delete(oldest);
+		}
+		this.warnedMessages.add(message);
+		this.warn(message);
+	}
 	/** Durable-note map key (V4-41): a target shares one record per mode. */
 	noteKey(mode, target) {
 		return `${mode}\u0000${target}`;
@@ -99,7 +125,9 @@ var EvolutionFeedback = class EvolutionFeedback {
 			}
 			const initial = await readEvolutionTimeline(io, eventsPath, archiveNames);
 			const lateArchives = (await listEventArchives(io, eventsPath)).filter((name) => !archiveNames.includes(name));
-			const events = lateArchives.length === 0 ? initial.events : (await readEvolutionTimeline(io, eventsPath, [...archiveNames, ...lateArchives])).events;
+			const later = lateArchives.length === 0 ? null : await readEvolutionTimeline(io, eventsPath, [...archiveNames, ...lateArchives]);
+			const events = later?.events ?? initial.events;
+			const truncated = initial.malformed || later?.malformed === true;
 			const cache = parseCache(rawCache, this.warn);
 			const maxSeq = events.reduce((max, event) => Math.max(max, event.seq), 0);
 			const floor = events[0]?.seq ?? 0;
@@ -129,7 +157,8 @@ var EvolutionFeedback = class EvolutionFeedback {
 				if (oldest === void 0) break;
 				this.durableNote.delete(oldest);
 			}
-			if (maxSeq > 0 && (!cache || cache.lastSeq < maxSeq)) try {
+			if (truncated) this.warnOnce(TRUNCATED_TIMELINE_WARN);
+			else if (maxSeq > 0 && (!cache || cache.lastSeq < maxSeq)) try {
 				await io.writeText(path, JSON.stringify({
 					version: CACHE_VERSION,
 					lastSeq: maxSeq,
@@ -255,7 +284,11 @@ var EvolutionFeedback = class EvolutionFeedback {
 		const recordIo = this.io;
 		if (!path || !eventsPath || !recordIo) return;
 		try {
-			const { events } = await readEvolutionTimeline(recordIo, eventsPath);
+			const { events, malformed } = await readEvolutionTimeline(recordIo, eventsPath);
+			if (malformed) {
+				this.warnOnce(TRUNCATED_TIMELINE_WARN);
+				return;
+			}
 			const maxSeq = events.reduce((max, event) => Math.max(max, event.seq), 0);
 			if (maxSeq === 0) return;
 			let rawCache;

package/lib/types/index.d.ts

@@ -71,6 +71,13 @@ export declare class EvolutionFeedback {
     constructor(io?: IoLike, home?: string, pathOverride?: string, warn?: (message: string) => void);
     /** Bind the evolution IO backend after construction (S6.4 deferred binding). */
     attachIo(io: IoLike): void;
+    /** V5-32 posture applied to the read side (C-events-dispatch-1, v43): an
+     * event a repeated read keeps reporting must not warn on each read —
+     * `refold()` calls `restore()` before every quality push. Shares the bounded
+     * `warnedMessages` set (and its FIFO eviction) with the append-failure warn.
+     * @param message - the warn text; identical text warns once per process.
+     */
+    private warnOnce;
     /** Durable-note map key (V4-41): a target shares one record per mode. */
     private noteKey;
     private mutate;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-feedback",
   "description": "Feedback-to-quality scoring for self-evolution (community build)",
-  "version": "0.3.80",
+  "version": "0.3.82",
   "publishConfig": {
     "access": "public"
   },
@@ -27,16 +27,16 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.80"
+    "@lmzhen/dsh-evolution-core": "^0.3.82"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@lmzhen/dsh-evolution-io": "^0.3.80",
-    "@lmzhen/dsh-skill-usage": "^0.3.80"
+    "@lmzhen/dsh-evolution-io": "^0.3.82",
+    "@lmzhen/dsh-skill-usage": "^0.3.82"
   },
   "devDependencies": {
-    "@lmzhen/dsh-evolution-io": "^0.3.80",
-    "@lmzhen/dsh-evolution-io-node": "^0.3.80",
-    "@lmzhen/dsh-skill-usage": "^0.3.80"
+    "@lmzhen/dsh-evolution-io": "^0.3.82",
+    "@lmzhen/dsh-evolution-io-node": "^0.3.82",
+    "@lmzhen/dsh-skill-usage": "^0.3.82"
   }
 }