@lmzhen/dsh-evolution-skill-catalog 0.1.0-rc.1

package/README.md

@@ -0,0 +1,26 @@
+# @deepseek-ai/dsh-evolution-skill-catalog
+
+Native ctx.skills provider for the evolution-managed skill tree
+
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-skill-catalog` 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
+
+
+- - Read-only native `ctx.skills` catalog. Skill mutations still happen through `tool-skill-manage`.
+

package/lib/index.js

@@ -0,0 +1,92 @@
+import z from "@deepseek-ai/schemastery";
+import { SkillLibrary, evolutionIoAdapter } from "@lmzhen/dsh-evolution-core";
+import { join } from "node:path";
+//#region lib/types/index.js
+/**
+* Native `ctx.skills` provider for the evolution-managed skill tree.
+*
+* `tool-skill-manage` writes skills through `ctx.evolutionIo`; this provider
+* publishes the same tree into DSH's skill registry and invalidates its
+* catalog synchronously on `evolution/skill-mutated`, removing the
+* filesystem-watcher latency/window from the write → visible loop.
+* @module @lmzhen/dsh-evolution-skill-catalog
+*/
+const name = "evolution-skill-catalog";
+const inject = ["skills", "evolutionIo"];
+const Config = z.object({
+	root: z.string().default(""),
+	modelInvocable: z.boolean().default(true),
+	userInvocable: z.boolean().default(true),
+	includeSkillNames: z.array(z.string()).default([]),
+	excludeSkillNames: z.array(z.string()).default([])
+});
+/** Below filesystem's user rank so the evolution-owned tree wins duplicates. */
+const EVOLUTION_SKILL_RANK = 390;
+function apply(ctx, rawConfig = {}) {
+	const invocation = {
+		modelInvocable: rawConfig.modelInvocable ?? true,
+		userInvocable: rawConfig.userInvocable ?? true
+	};
+	const io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
+	const library = new SkillLibrary(rawConfig.root || void 0, io);
+	const included = new Set(rawConfig.includeSkillNames ?? []);
+	const excluded = new Set(rawConfig.excludeSkillNames ?? []);
+	const visible = (name) => (included.size === 0 || included.has(name)) && !excluded.has(name);
+	let control;
+	const provider = {
+		name: "dsh-evolution",
+		async list(_options) {
+			return (await library.list()).filter((summary) => visible(summary.name)).map((summary) => ({
+				name: summary.name,
+				description: summary.description,
+				invocation,
+				source: "user-dsh",
+				provider: "dsh-evolution",
+				rank: 390,
+				locator: { name: summary.name },
+				path: join(summary.path, "SKILL.md"),
+				resourceBase: {
+					kind: "directory",
+					path: summary.path
+				}
+			}));
+		},
+		async get(candidate) {
+			const name = candidate.name;
+			if (!visible(name)) return void 0;
+			const content = await library.read(name);
+			if (content === null) return void 0;
+			const summary = (await library.list()).find((item) => item.name === name);
+			if (!summary) return void 0;
+			return {
+				name,
+				description: summary.description,
+				invocation,
+				source: "user-dsh",
+				provider: "dsh-evolution",
+				resourceBase: {
+					kind: "directory",
+					path: summary.path
+				},
+				content,
+				path: join(summary.path, "SKILL.md")
+			};
+		}
+	};
+	ctx.effect(() => {
+		const unregister = ctx.skills.registerProvider((providerControl) => {
+			control = providerControl;
+			return provider;
+		});
+		const disposeEvent = ctx.on("evolution/skill-mutated", () => {
+			control?.invalidate();
+		});
+		return () => {
+			disposeEvent();
+			unregister();
+			control = void 0;
+		};
+	}, "evolution-skill-catalog.provider");
+}
+//#endregion
+export { Config, EVOLUTION_SKILL_RANK, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-skill-catalog";
+const name = "evolution-skill-catalog-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,29 @@
+/**
+ * Native `ctx.skills` provider for the evolution-managed skill tree.
+ *
+ * `tool-skill-manage` writes skills through `ctx.evolutionIo`; this provider
+ * publishes the same tree into DSH's skill registry and invalidates its
+ * catalog synchronously on `evolution/skill-mutated`, removing the
+ * filesystem-watcher latency/window from the write → visible loop.
+ * @module @deepseek-ai/dsh-evolution-skill-catalog
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "evolution-skill-catalog";
+export declare const inject: string[];
+export interface Config {
+    root?: string;
+    /** Whether catalog skills are advertised/loadable by the model. */
+    modelInvocable?: boolean;
+    /** Whether catalog skills are advertised/loadable from user surfaces. */
+    userInvocable?: boolean;
+    /** Restrict the published catalog to these skill names (empty = all). */
+    includeSkillNames?: string[];
+    /** Hide these skill names from the published catalog. */
+    excludeSkillNames?: string[];
+}
+export declare const Config: z<Config>;
+/** Below filesystem's user rank so the evolution-owned tree wins duplicates. */
+export declare const EVOLUTION_SKILL_RANK = 390;
+export declare function apply(ctx: Context, rawConfig?: Config): 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-skill-catalog-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-skill-catalog",
+  "description": "Native ctx.skills provider for the evolution-managed skill tree (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-skill-catalog"
+  },
+  "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",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1"
+  }
+}