@lmzhen/dsh-evolution-feedback 0.3.67 → 0.3.69

package/lib/index.js

@@ -48,11 +48,16 @@ var EvolutionFeedback = class EvolutionFeedback {
 	durableNote = /* @__PURE__ */ new Map();
 	/** P2-32 (v11): process-level bound — every feedbacked session would
 	* otherwise keep one entry for the whole process lifetime (a name + note
-	* string per session); cap both maps and drop the oldest on overflow. */
+	* string per session); cap this map and drop the earliest-INSERTED entry on
+	* overflow (Map iteration order is insertion order, and re-setting an
+	* existing key does not refresh its position, so the eviction is FIFO rather
+	* than least-recently-used). `warnedMessages` carries the same bound through
+	* `WARNED_CAP` below. */
 	static NOTE_CAP = 512;
 	/** V5-32 (0.3.31): fire-and-forget append failures are warn-once per unique
 	* message — a persistent refusal (e.g. a future-version log) must not spam
-	* the log on every user feedback entry (family posture: process-level once). */
+	* the log on every user feedback entry (family posture: process-level once).
+	* Bounded like `durableNote`, with the same FIFO eviction. */
 	warnedMessages = /* @__PURE__ */ new Set();
 	WARNED_CAP = 512;
 	/** V5-29 (0.3.31): invoked after a FAILED append rolled back, so a caller
@@ -142,6 +147,18 @@ var EvolutionFeedback = class EvolutionFeedback {
 	* @param note - optional free-text note carried into the durable event.
 	* @param kind - `skill` (default `session`) selects the score table.
 	*/
+	/**
+	* v30 FB-01: refold the shared event log into the in-process aggregate.
+	* The aggregate only folds at mount, so a long-lived process computed the
+	* ABSOLUTE feedback pair from a stale aggregate and overwrote the decision
+	* relevant `feedback_warn` another process had recorded. The log is the
+	* truth — re-reading it before each quality push shrinks the staleness
+	* window to the refold-vs-append race (near-zero, serialized by mutate).
+	*/
+	async refold() {
+		if (!this.io) return;
+		await this.restore(this.io);
+	}
 	record(target, rating, note, kind = "session") {
 		const mode = kind === "skill" ? "skills" : "sessions";
 		const table = this.state[mode];
@@ -505,9 +522,11 @@ function apply(ctx, rawConfig = {}) {
 		const skillUsage = skillCtx.skillUsage;
 		const pushQuality = (target, kind) => {
 			if (kind !== "skill") return;
-			const score = feedback.score(target, "skill");
-			const warn = score < qualityWarnThreshold;
-			skillUsage.setFeedbackQuality(target, score, warn).catch((error) => {
+			feedback.refold().then(() => {
+				const score = feedback.score(target, "skill");
+				const warn = score < qualityWarnThreshold;
+				return skillUsage.setFeedbackQuality(target, score, warn);
+			}).catch((error) => {
 				skillCtx.logger.warn(error);
 			});
 		};

package/lib/types/index.d.ts

@@ -52,11 +52,16 @@ export declare class EvolutionFeedback {
     private readonly durableNote;
     /** P2-32 (v11): process-level bound — every feedbacked session would
      * otherwise keep one entry for the whole process lifetime (a name + note
-     * string per session); cap both maps and drop the oldest on overflow. */
+     * string per session); cap this map and drop the earliest-INSERTED entry on
+     * overflow (Map iteration order is insertion order, and re-setting an
+     * existing key does not refresh its position, so the eviction is FIFO rather
+     * than least-recently-used). `warnedMessages` carries the same bound through
+     * `WARNED_CAP` below. */
     private static readonly NOTE_CAP;
     /** V5-32 (0.3.31): fire-and-forget append failures are warn-once per unique
      * message — a persistent refusal (e.g. a future-version log) must not spam
-     * the log on every user feedback entry (family posture: process-level once). */
+     * the log on every user feedback entry (family posture: process-level once).
+     * Bounded like `durableNote`, with the same FIFO eviction. */
     private readonly warnedMessages;
     private readonly WARNED_CAP;
     /** V5-29 (0.3.31): invoked after a FAILED append rolled back, so a caller
@@ -82,6 +87,15 @@ export declare class EvolutionFeedback {
      * @param note - optional free-text note carried into the durable event.
      * @param kind - `skill` (default `session`) selects the score table.
      */
+    /**
+     * v30 FB-01: refold the shared event log into the in-process aggregate.
+     * The aggregate only folds at mount, so a long-lived process computed the
+     * ABSOLUTE feedback pair from a stale aggregate and overwrote the decision
+     * relevant `feedback_warn` another process had recorded. The log is the
+     * truth — re-reading it before each quality push shrinks the staleness
+     * window to the refold-vs-append race (near-zero, serialized by mutate).
+     */
+    refold(): Promise<void>;
     record(target: string, rating: 'positive' | 'negative', note?: string, kind?: 'skill' | 'session'): void;
     score(target: string, kind?: 'skill' | 'session'): number;
     snapshot(): FeedbackState;

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.67",
+  "version": "0.3.69",
   "publishConfig": {
     "access": "public"
   },
@@ -31,18 +31,18 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.67"
+    "@lmzhen/dsh-evolution-core": "^0.3.69"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@lmzhen/dsh-evolution-io": "^0.3.67",
-    "@lmzhen/dsh-skill-usage": "^0.3.67"
+    "@lmzhen/dsh-evolution-io": "^0.3.69",
+    "@lmzhen/dsh-skill-usage": "^0.3.69"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.3.67",
-    "@lmzhen/dsh-evolution-io-node": "^0.3.67",
-    "@lmzhen/dsh-skill-usage": "^0.3.67"
+    "@lmzhen/dsh-evolution-io": "^0.3.69",
+    "@lmzhen/dsh-evolution-io-node": "^0.3.69",
+    "@lmzhen/dsh-skill-usage": "^0.3.69"
   }
 }