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

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-evolution-commands
+
+Human commands for the evolution family
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-commands` 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,65 @@
+//#region lib/types/index.js
+/**
+* Human commands for the evolution family: /evolution status|pending.
+* @module @lmzhen/dsh-evolution-commands
+*/
+const name = "evolution-commands";
+function apply(ctx) {
+	ctx.inject(["commands"], (commandCtx) => {
+		commandCtx.commands.register({
+			name: "evolution",
+			description: "Self-evolution status and approval controls",
+			recordInput: false,
+			async handler(invocation) {
+				const input = invocation.rawInput?.trim() ?? "";
+				const approval = ctx.get("evolutionApproval");
+				if (input === "pending") {
+					const pending = approval ? await approval.list("pending") : [];
+					return { text: pending.length === 0 ? "No pending evolution writes." : pending.map((p) => `${p.id}  ${p.kind}  ${p.summary}`).join("\n") };
+				}
+				if (input.startsWith("approve ")) {
+					const id = input.slice(8).trim();
+					return { text: (approval ? await approval.approve(id) : {
+						ok: false,
+						message: "approval service not mounted"
+					}).message };
+				}
+				if (input.startsWith("reject ")) {
+					const id = input.slice(7).trim();
+					return { text: (approval ? await approval.reject(id) : {
+						ok: false,
+						message: "approval service not mounted"
+					}).message };
+				}
+				if (input === "curator run") {
+					const curator = ctx.get("evolutionCurator");
+					if (!curator) return { text: "Curator service not mounted." };
+					const result = await curator.run();
+					return { text: `Curator run complete: ${result.stale.length} stale, ${result.archived.length} archived, ${result.errors.length} failed.\nrunId=${result.report.runId}${result.report.snapshotPath ? `\nsnapshot=${result.report.snapshotPath}` : ""}` };
+				}
+				if (input === "curator report") {
+					const curator = ctx.get("evolutionCurator");
+					if (!curator) return { text: "Curator service not mounted." };
+					const report = await curator.latestReport();
+					if (!report) return { text: "No curator report available." };
+					return { text: [
+						`runId=${report.runId}`,
+						`startedAt=${report.startedAt}`,
+						`archived=${report.archived.map((item) => item.name).join(", ") || "(none)"}`,
+						`failed=${report.failed.map((item) => `${item.name}: ${item.reason}`).join(", ") || "(none)"}`
+					].join("\n") };
+				}
+				if (input.startsWith("restore ")) {
+					const curator = ctx.get("evolutionCurator");
+					return { text: (curator ? await curator.skills.restoreLatestSnapshot() : {
+						ok: false,
+						message: "Curator service not mounted."
+					}).message };
+				}
+				return { text: "Evolution: memory, skills, review, curator. Use /evolution pending | curator run | curator report | restore." };
+			}
+		});
+	});
+}
+//#endregion
+export { apply, name };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-commands";
+const name = "evolution-commands-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,8 @@
+/**
+ * Human commands for the evolution family: /evolution status|pending.
+ * @module @deepseek-ai/dsh-evolution-commands
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "evolution-commands";
+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-commands-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-commands",
+  "description": "Human commands for the evolution family (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-commands"
+  },
+  "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"
+  }
+}