@lmzhen/dsh-evolution-commands 0.2.1 → 0.3.0

package/lib/index.js

@@ -1,5 +1,6 @@
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { appendEvolutionEvent, buildLearnPrompt, eventsFile } from "@lmzhen/dsh-evolution-core";
+import { SkillLibrary, appendEvolutionEvent, buildLearnPrompt, eventsFile, parseFrontmatter, usageObserved } from "@lmzhen/dsh-evolution-core";
+import { buildMaintainFacts, runMaintain, snapshotFromLibrary } from "@lmzhen/dsh-evolution-maintenance";
 import { homedir } from "node:os";
 import { join } from "node:path";
 //#region lib/types/index.js
@@ -8,13 +9,40 @@ import { join } from "node:path";
 * @module @lmzhen/dsh-evolution-commands
 */
 const name = "evolution-commands";
-function apply(ctx) {
+async function buildEnrichment(ctx, library) {
+	const skillUsage = ctx.get("skillUsage");
+	const usageMap = skillUsage?.report ? await skillUsage.report() : void 0;
+	const usageObservedValue = usageMap ? usageObserved(usageMap) : void 0;
+	const descriptions = /* @__PURE__ */ new Map();
+	const supportFiles = /* @__PURE__ */ new Map();
+	const quality = /* @__PURE__ */ new Map();
+	for (const entry of await library.list()) {
+		const body = await library.read(entry.name);
+		if (body === null) continue;
+		const description = parseFrontmatter(body)?.frontmatter.description;
+		if (typeof description === "string" && description.trim().length > 0) descriptions.set(entry.name, description);
+		const files = await library.listSupportFiles(entry.name);
+		if (files.length > 0) supportFiles.set(entry.name, files);
+		const record = usageMap?.get(entry.name);
+		if (typeof record?.quality_score === "number") quality.set(entry.name, record.quality_score);
+	}
+	return {
+		descriptions,
+		supportFiles,
+		quality,
+		usageObservedValue
+	};
+}
+function apply(ctx, rawConfig = {}) {
+	const config = rawConfig;
+	let lastMaintainAt = 0;
+	let lastMaintainRunId = "";
 	ctx.inject(["commands"], (commandCtx) => {
 		commandCtx.commands.register({
 			name: "evolution",
 			description: "Self-evolution status and approval controls",
 			recordInput: false,
-			input: { hint: "pending | approve <id> | reject <id> | curator run|pause|resume|status|report|scope | restore | consolidate <target> <sources...> | skill restore <name> | skills health | learn [request] | replay" },
+			input: { hint: "pending | approve <id> | reject <id> | curator run|pause|resume|status|report|scope | restore | consolidate <target> <sources...> | skill restore <name> | skills health | learn [request] | maintain | restructure <name> \"<heading>\" <to_file> | replay" },
 			async handler(invocation) {
 				const input = invocation.rawInput?.trim() ?? "";
 				const ok = (text) => ({
@@ -115,14 +143,17 @@ function apply(ctx) {
 					return result.ok ? ok(result.message) : err(result.message);
 				}
 				if (input.startsWith("consolidate ")) {
-					const [target, ...sources] = input.slice(12).trim().split(/\s+/).filter(Boolean);
+					const planTail = /\s--plan\s+(\S+)\s*$/.exec(input) ?? null;
+					const planRunId = planTail?.[1] ?? void 0;
+					const [target, ...sources] = (planTail ? input.slice(0, planTail.index) : input).slice(12).trim().split(/\s+/).filter(Boolean);
 					if (!target || sources.length === 0) return err("Usage: /evolution consolidate <target> <source...>");
 					const curator = ctx.get("evolutionCurator");
 					const result = curator ? await curator.consolidate(target, sources) : {
 						ok: false,
 						message: "Curator service not mounted."
 					};
-					return result.ok ? ok(result.message) : err(result.message);
+					if (!result.ok) return err(result.message);
+					return ok(planRunId ? `${result.message}\n[audit] plan=${planRunId}` : result.message);
 				}
 				if (input.startsWith("skill restore ")) {
 					const name = input.slice(14).trim();
@@ -167,12 +198,77 @@ function apply(ctx) {
 					});
 					return ok("Learning request sent to this session. Follow it now.");
 				}
+				if (input === "maintain --facts") {
+					const ioRegistry = ctx.get("evolutionIo");
+					if (!ioRegistry) return err("Evolution IO registry not mounted — maintenance facts unavailable.");
+					const library = new SkillLibrary(config.skillsRoot, ioRegistry.provider());
+					const enrichment = await buildEnrichment(ctx, library);
+					const { facts } = buildMaintainFacts(await snapshotFromLibrary(library, {
+						descriptions: enrichment.descriptions,
+						supportFiles: enrichment.supportFiles,
+						quality: enrichment.quality
+					}), enrichment.usageObservedValue, void 0);
+					return ok(`Maintenance facts (0-token preview):\n${facts}`);
+				}
+				if (input === "maintain") {
+					const cooldownMs = config.maintainCooldownMs ?? 13e4;
+					const sinceLast = Date.now() - lastMaintainAt;
+					if (cooldownMs > 0 && sinceLast < cooldownMs) return ok(`Maintenance cooldown active (${Math.ceil((cooldownMs - sinceLast) / 1e3)}s) — latest scan ${lastMaintainRunId}; re-running now would spend another model call.`);
+					const ioRegistry = ctx.get("evolutionIo");
+					const subagents = ctx.get("subagents");
+					if (!ioRegistry) return err("Evolution IO registry not mounted — maintenance scan unavailable.");
+					if (!subagents) return err("Subagents service not mounted — maintenance scan unavailable.");
+					const library = new SkillLibrary(config.skillsRoot, ioRegistry.provider());
+					const enrichment = await buildEnrichment(ctx, library);
+					const outcome = await runMaintain({
+						library,
+						subagents,
+						parent: invocation.agent
+					}, {
+						descriptions: () => enrichment.descriptions,
+						supportFiles: () => enrichment.supportFiles,
+						quality: () => enrichment.quality,
+						usageObserved: () => enrichment.usageObservedValue
+					});
+					lastMaintainAt = Date.now();
+					lastMaintainRunId = outcome.runId ?? "";
+					if (!outcome.ok) return err(outcome.error ?? "Maintenance scan failed.");
+					appendEvolutionEvent(ioRegistry.provider(), eventsFile(process.env.DSH_HOME ?? join(homedir(), ".dsh")), {
+						type: "maintain",
+						source: "manual",
+						runId: outcome.runId,
+						verdict: outcome.verdict,
+						recommendations: outcome.text?.split("\n").filter((line) => line.startsWith("- [")).length ?? 0
+					}).catch((error) => {
+						ctx.logger.warn(`evolution-commands: failed to record maintain event: ${String(error)}`);
+					});
+					return ok(`Maintenance scan ${outcome.runId}:\n${outcome.text ?? ""}`);
+				}
+				if (input.startsWith("restructure ")) {
+					const planTail = /\s--plan\s+(\S+)\s*$/.exec(input) ?? null;
+					const planRunId = planTail?.[1] ?? void 0;
+					const rest = planTail ? input.slice(0, planTail.index) : input;
+					const match = /^restructure\s+(\S+)\s+"([^"]+)"\s+(\S+)$/.exec(rest);
+					if (!match) return err("Usage: /evolution restructure <name> \"<## heading>\" <to_file>");
+					const name = match[1] ?? "";
+					const heading = match[2] ?? "";
+					const toFile = match[3] ?? "";
+					if (!toFile.startsWith("references/")) return err("to_file must live under references/ (log/detail destination).");
+					const ioRegistry = ctx.get("evolutionIo");
+					if (!ioRegistry) return err("Evolution IO registry not mounted — restructure unavailable.");
+					const result = await new SkillLibrary(config.skillsRoot, ioRegistry.provider()).restructure(name, [{
+						heading,
+						toFile
+					}], "foreground");
+					if (!result.ok) return err(result.message);
+					return ok(planRunId ? `${result.message}\n[audit] plan=${planRunId}` : result.message);
+				}
 				if (input === "replay") {
 					const replay = ctx.get("evolutionReplay");
 					if (!replay) return err("Replay service not mounted.");
 					return ok(replay.compare().report);
 				}
-				return ok("Evolution: memory, skills, review, curator. Use /evolution pending | approve <id> | reject <id> | curator run | curator status | curator pause | curator resume | curator report | curator scope | restore | consolidate <target> <source...> | skill restore <name> | skills health | learn [request] | replay.");
+				return ok("Evolution: memory, skills, review, curator. Use /evolution pending | approve <id> | reject <id> | curator run | curator status | curator pause | curator resume | curator report | curator scope | restore | consolidate <target> <source...> | skill restore <name> | skills health | learn [request] | maintain | restructure <name> \"<heading>\" <to_file> | replay.");
 			}
 		});
 	});

package/lib/types/index.d.ts

@@ -4,5 +4,15 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 export declare const name = "evolution-commands";
-export declare function apply(ctx: Context): void;
+export interface Config {
+    /** Skill-tree root for maintain/restructure; empty uses skillsRoot().
+     * Align with tool-skill-manage/skill-usage/evolution-skill-catalog rows (A7). */
+    skillsRoot?: string | undefined;
+    /** Cooldown window for scan commands (ms) — misclick/rapid-trigger guard;
+     * secondary calls inside the window return the previous runId instead of
+     * spending another model call. Default 130s (>= maintain timeout 120s, so
+     * the window also covers in-flight runs); transient (per-process). */
+    maintainCooldownMs?: number | undefined;
+}
+export declare function apply(ctx: Context, rawConfig?: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-commands",
   "description": "Human commands for the evolution family (community build)",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -33,7 +33,8 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.2.1"
+    "@lmzhen/dsh-evolution-core": "^0.3.0",
+    "@lmzhen/dsh-evolution-maintenance": "^0.3.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",