@lmzhen/dsh-evolution-feedback 0.3.63 → 0.3.64

package/lib/index.js

@@ -130,6 +130,18 @@ var EvolutionFeedback = class EvolutionFeedback {
 			} catch {}
 		});
 	}
+	/** External-producer contract (审计 B-4, v18): nothing inside the family
+	* calls `record` — the upstream `/feedback` command only appends a
+	* `feedback/record` session event carrying free text, which cannot be mapped
+	* to a (target, rating) pair without inventing semantics. A host that wants
+	* feedback-driven curation wires its own command/event to this method; the
+	* curator's union read (`feedback_warn`) then shortens the stale window.
+	* `feedback.spec.ts` pins that channel end to end.
+	* @param target - skill name or session id the rating belongs to.
+	* @param rating - `positive` or `negative`; other values are refused.
+	* @param note - optional free-text note carried into the durable event.
+	* @param kind - `skill` (default `session`) selects the score table.
+	*/
 	record(target, rating, note, kind = "session") {
 		const mode = kind === "skill" ? "skills" : "sessions";
 		const table = this.state[mode];
@@ -372,6 +384,10 @@ function foldWithDelta(cache, events, warn = () => {}) {
 }
 function applyFeedbackEvent(state, event, warn = () => {}) {
 	if (event.type !== "feedback") return;
+	if (event.kind !== "skill" && event.kind !== "session") {
+		warn(`evolution-feedback: skipping feedback event with invalid kind: ${String(event.kind)}`);
+		return;
+	}
 	if (event.rating !== "positive" && event.rating !== "negative") {
 		warn(`evolution-feedback: skipping feedback event with invalid rating: ${String(event.rating)}`);
 		return;

package/lib/types/index.d.ts

@@ -70,6 +70,18 @@ export declare class EvolutionFeedback {
     private noteKey;
     private mutate;
     restore(io: IoLike): Promise<void>;
+    /** External-producer contract (审计 B-4, v18): nothing inside the family
+     * calls `record` — the upstream `/feedback` command only appends a
+     * `feedback/record` session event carrying free text, which cannot be mapped
+     * to a (target, rating) pair without inventing semantics. A host that wants
+     * feedback-driven curation wires its own command/event to this method; the
+     * curator's union read (`feedback_warn`) then shortens the stale window.
+     * `feedback.spec.ts` pins that channel end to end.
+     * @param target - skill name or session id the rating belongs to.
+     * @param rating - `positive` or `negative`; other values are refused.
+     * @param note - optional free-text note carried into the durable event.
+     * @param kind - `skill` (default `session`) selects the score table.
+     */
     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.63",
+  "version": "0.3.64",
   "publishConfig": {
     "access": "public"
   },
@@ -31,18 +31,18 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.63"
+    "@lmzhen/dsh-evolution-core": "^0.3.64"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@lmzhen/dsh-evolution-io": "^0.3.63",
-    "@lmzhen/dsh-skill-usage": "^0.3.63"
+    "@lmzhen/dsh-evolution-io": "^0.3.64",
+    "@lmzhen/dsh-skill-usage": "^0.3.64"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.3.63",
-    "@lmzhen/dsh-evolution-io-node": "^0.3.63",
-    "@lmzhen/dsh-skill-usage": "^0.3.63"
+    "@lmzhen/dsh-evolution-io": "^0.3.64",
+    "@lmzhen/dsh-evolution-io-node": "^0.3.64",
+    "@lmzhen/dsh-skill-usage": "^0.3.64"
   }
 }