@lmzhen/dsh-evolution-learning-graph 0.1.0-rc.1

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-evolution-learning-graph
+
+Learning graph over skills and memory
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-learning-graph` 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
+
+
+- No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.

package/lib/index.js

@@ -0,0 +1,63 @@
+//#region lib/types/index.js
+/**
+* Learning graph over skills and memory.
+* @module @lmzhen/dsh-evolution-learning-graph
+*/
+/** Build a small deterministic graph from usage records and memory entries. */
+function buildLearningGraph(usage, memoryEntries) {
+	const nodes = [...usage.keys()].map((name) => ({
+		id: name,
+		kind: "skill",
+		label: name
+	}));
+	const edges = [];
+	const sorted = [...usage.keys()].sort();
+	for (let i = 1; i < sorted.length; i += 1) {
+		const from = sorted[i - 1];
+		const to = sorted[i];
+		if (from && to) edges.push({
+			from,
+			to,
+			type: "related"
+		});
+	}
+	memoryEntries.forEach((entry, index) => {
+		const id = `memory:${index}`;
+		nodes.push({
+			id,
+			kind: "memory",
+			label: entry.split("\n")[0]?.slice(0, 80) ?? id
+		});
+		const token = entry.toLowerCase();
+		for (const name of sorted) if (name && token.includes(name.toLowerCase())) edges.push({
+			from: id,
+			to: name,
+			type: "memory_skill"
+		});
+	});
+	return {
+		nodes,
+		edges
+	};
+}
+const name = "evolution-learning-graph";
+function apply(ctx) {
+	ctx.inject(["commands"], (commandCtx) => {
+		commandCtx.commands.register({
+			name: "evolution graph",
+			description: "Show the current learning graph",
+			recordInput: false,
+			handler: async () => {
+				const usage = ctx.get("skillUsage");
+				const memory = ctx.get("memory");
+				if (!usage || !memory) return { text: "skill-usage or memory service is not mounted." };
+				const graph = buildLearningGraph(await usage.report(), await memory.read("memory"));
+				const lines = graph.nodes.map((node) => (node.kind === "memory" ? "◆" : "●") + " " + node.label);
+				const edges = graph.edges.map((edge) => edge.from + " --" + edge.type + "--> " + edge.to);
+				return { text: lines.join("\n") + "\n\n" + edges.join("\n") };
+			}
+		});
+	});
+}
+//#endregion
+export { apply, buildLearningGraph, name };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-learning-graph";
+const name = "evolution-learning-graph-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,27 @@
+/**
+ * Learning graph over skills and memory.
+ * @module @deepseek-ai/dsh-evolution-learning-graph
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export interface GraphNode {
+    id: string;
+    kind: 'skill' | 'memory';
+    label: string;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    type: 'related' | 'memory_skill';
+}
+export interface LearningGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+/** Build a small deterministic graph from usage records and memory entries. */
+export declare function buildLearningGraph(usage: ReadonlyMap<string, {
+    use_count?: number;
+    pinned?: boolean;
+}>, memoryEntries: readonly string[]): LearningGraph;
+export declare const name = "evolution-learning-graph";
+export declare function apply(ctx: Context): void;
+//# 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-learning-graph-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,44 @@
+{
+  "name": "@lmzhen/dsh-evolution-learning-graph",
+  "description": "Learning graph over skills and memory (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-learning-graph"
+  },
+  "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"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6"
+  }
+}