@lmzhen/dsh-evolution-feedback 0.1.0-rc.1

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-evolution-feedback
+
+Feedback-to-quality scoring for self-evolution
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-feedback` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
+
+#### Token effect
+
+Zero direct token effect from this package; consumers add any model-visible tokens.
+
+#### KV Cache effect
+
+Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
+
+## Known Limitations and Deferred Work
+
+
+- - Persists through the IO seam; quality propagation into skill usage requires the `skillUsage` service.

package/lib/index.js

@@ -0,0 +1,110 @@
+import z from "@deepseek-ai/schemastery";
+import { homedir } from "node:os";
+import { join } from "node:path";
+//#region lib/types/index.js
+/**
+* Feedback-to-quality scoring for self-evolution.
+*
+* Feedback is durable through `ctx.evolutionIo` (when mounted) and skill
+* feedback feeds `quality_score` / `quality_warn` on the usage record, so
+* curator decisions can consume it deterministically.
+* @module @lmzhen/dsh-evolution-feedback
+*/
+var EvolutionFeedback = class {
+	state = {
+		skills: {},
+		sessions: {}
+	};
+	chain = Promise.resolve();
+	path;
+	constructor(io, home = process.env.DSH_HOME ?? join(homedir(), ".dsh"), pathOverride) {
+		if (io) this.path = pathOverride ?? join(home, "evolution", "feedback.json");
+	}
+	mutate(task) {
+		const run = this.chain.then(task, task);
+		this.chain = run.then(() => void 0, () => void 0);
+		return run;
+	}
+	async restore(io) {
+		const path = this.path;
+		if (!path) return;
+		await this.mutate(async () => {
+			const raw = await io.readText(path);
+			if (raw === null) return;
+			try {
+				const parsed = JSON.parse(raw);
+				this.state = {
+					skills: { ...parsed.skills },
+					sessions: { ...parsed.sessions }
+				};
+			} catch {}
+		});
+	}
+	record(target, rating, note, kind = "session", io) {
+		const table = kind === "skill" ? this.state.skills : this.state.sessions;
+		const current = table[target] ?? {
+			positive: 0,
+			negative: 0
+		};
+		current[rating] += 1;
+		if (note !== void 0) current.lastNote = note;
+		table[target] = current;
+		if (io && this.path) this.flush(io);
+	}
+	score(target, kind = "session") {
+		const record = (kind === "skill" ? this.state.skills : this.state.sessions)[target];
+		if (!record) return 0;
+		const total = record.positive + record.negative;
+		if (total === 0) return 0;
+		return (record.positive - record.negative) / total;
+	}
+	snapshot() {
+		return {
+			skills: { ...this.state.skills },
+			sessions: { ...this.state.sessions }
+		};
+	}
+	async flush(io) {
+		const path = this.path;
+		if (!path || !io) return;
+		await this.mutate(async () => {
+			await io.writeText(path, JSON.stringify(this.state, null, 2));
+		});
+	}
+};
+const name = "evolution-feedback";
+const Config = z.object({
+	qualityWarnThreshold: z.number().default(-.25),
+	path: z.string().default("")
+});
+function apply(ctx, rawConfig = {}) {
+	const ioRegistry = ctx.get("evolutionIo");
+	const io = ioRegistry ? {
+		readText: (path) => ioRegistry.provider().readText(path),
+		writeText: (path, content) => ioRegistry.provider().writeText(path, content)
+	} : void 0;
+	const feedback = new EvolutionFeedback(io, process.env.DSH_HOME ?? join(homedir(), ".dsh"), rawConfig.path || void 0);
+	if (io) feedback.restore(io).catch((error) => {
+		ctx.logger.warn(error);
+	});
+	ctx.provide("evolutionFeedback", feedback);
+	const skillUsage = ctx.get("skillUsage");
+	if (skillUsage) {
+		const original = feedback.record.bind(feedback);
+		feedback.record = (target, rating, note, kind, recordIo) => {
+			original(target, rating, note, kind ?? "session", recordIo ?? io);
+			if (kind === "skill") {
+				const score = feedback.score(target, "skill");
+				const warn = score < (rawConfig.qualityWarnThreshold ?? -.25);
+				skillUsage.setQuality(target, score, warn).catch((error) => {
+					ctx.logger.warn(error);
+				});
+			}
+		};
+	}
+	ctx.effect(() => () => {
+		if (io) feedback.flush(io);
+	}, "evolution-feedback.flush");
+}
+//#endregion
+export { Config, EvolutionFeedback, EvolutionFeedback as default, apply, name };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-feedback";
+const name = "evolution-feedback-invariant";
+const inject = ["invariants"];
+const install = () => {};
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Feedback-to-quality scoring for self-evolution.
+ *
+ * Feedback is durable through `ctx.evolutionIo` (when mounted) and skill
+ * feedback feeds `quality_score` / `quality_warn` on the usage record, so
+ * curator decisions can consume it deterministically.
+ * @module @deepseek-ai/dsh-evolution-feedback
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        evolutionFeedback: EvolutionFeedback;
+    }
+}
+export interface FeedbackRecord {
+    positive: number;
+    negative: number;
+    lastNote?: string | undefined;
+}
+export interface FeedbackState {
+    skills: Record<string, FeedbackRecord>;
+    sessions: Record<string, FeedbackRecord>;
+}
+interface IoLike {
+    readText(path: string): Promise<string | null>;
+    writeText(path: string, content: string): Promise<void>;
+}
+export declare class EvolutionFeedback {
+    private state;
+    private chain;
+    private readonly path?;
+    constructor(io?: IoLike, home?: string, pathOverride?: string);
+    private mutate;
+    restore(io: IoLike): Promise<void>;
+    record(target: string, rating: 'positive' | 'negative', note?: string, kind?: 'skill' | 'session', io?: IoLike): void;
+    score(target: string, kind?: 'skill' | 'session'): number;
+    snapshot(): FeedbackState;
+    flush(io?: IoLike): Promise<void>;
+}
+export declare const name = "evolution-feedback";
+export interface Config {
+    /** Score below which curator receives quality_warn for a skill. */
+    qualityWarnThreshold?: number;
+    /** Explicit feedback file path; empty derives $DSH_HOME/evolution/feedback.json. */
+    path?: string;
+}
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, rawConfig?: Config): void;
+export default EvolutionFeedback;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "evolution-feedback-invariant";
+export declare const inject: string[];
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@lmzhen/dsh-evolution-feedback",
+  "description": "Feedback-to-quality scoring for self-evolution (community build)",
+  "version": "0.1.0-rc.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lmzhen/dsh-evolution.git",
+    "directory": "packages/dsh-evolution-feedback"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts",
+    "lib/types/invariant.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1",
+    "@lmzhen/dsh-skill-usage": "^0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-io-node": "^0.1.0-rc.1",
+    "@lmzhen/dsh-skill-usage": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution": "^0.1.0-rc.1"
+  }
+}