@lmzhen/dsh-evolution-curator 0.1.0-rc.12 → 0.1.0-rc.14

package/lib/index.js

@@ -3,7 +3,7 @@ import { randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 import z from "@deepseek-ai/schemastery";
-import { CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_STALE_AFTER_DAYS, SkillLibrary, buildCuratorRunReport, computeLifecycleTransitions, evolutionHome, evolutionIoAdapter, loadUsage, saveUsage } from "@lmzhen/dsh-evolution-core";
+import { CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, SkillLibrary, buildCuratorRunReport, computeLifecycleTransitions, emptyRecord, evolutionHome, evolutionIoAdapter, loadSuppressedNames, loadUsage, saveSuppressedNames, saveUsage } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Deterministic skill lifecycle curator with interval gate and archive.
@@ -19,9 +19,10 @@ var EvolutionCurator = class extends Service {
 		llmReview: z.boolean().default(false),
 		curatorProvider: z.string().default("deepseek-official"),
 		qualityWarnStaleAfterDays: z.number().default(7),
-		minIdleHours: z.number().default(0),
+		minIdleHours: z.number().default(DEFAULT_MIN_IDLE_HOURS),
 		excludeSkillNames: z.array(z.string()).default([]),
 		manageUnmanaged: z.boolean().default(false),
+		pruneBuiltins: z.boolean().default(false),
 		curatorReviewMaxTokens: z.number().default(2048)
 	});
 	skills;
@@ -36,6 +37,7 @@ var EvolutionCurator = class extends Service {
 	minIdleHours;
 	excludeSkillNames;
 	manageUnmanaged;
+	pruneBuiltins;
 	curatorReviewMaxTokens;
 	lastRun = 0;
 	timer;
@@ -50,9 +52,10 @@ var EvolutionCurator = class extends Service {
 		this.llmReview = config.llmReview ?? false;
 		this.curatorProvider = config.curatorProvider ?? "deepseek-official";
 		this.qualityWarnStaleAfterDays = config.qualityWarnStaleAfterDays ?? 7;
-		this.minIdleHours = config.minIdleHours ?? 0;
+		this.minIdleHours = config.minIdleHours ?? DEFAULT_MIN_IDLE_HOURS;
 		this.excludeSkillNames = new Set(config.excludeSkillNames ?? []);
 		this.manageUnmanaged = config.manageUnmanaged ?? false;
+		this.pruneBuiltins = config.pruneBuiltins ?? false;
 		this.curatorReviewMaxTokens = config.curatorReviewMaxTokens ?? 2048;
 		this.lastRun = Date.now();
 		this.ctx.effect(() => {
@@ -140,20 +143,24 @@ var EvolutionCurator = class extends Service {
 			failed: []
 		});
 	}
-	async run() {
+	/**
+	* Run one curator pass. `ignoreGates` skips the interval and idle gates so an
+	* explicit `/evolution curator run` always executes (manual-run semantics).
+	*/
+	async run(options = {}) {
 		const startedAt = (/* @__PURE__ */ new Date()).toISOString();
 		const runId = randomUUID();
 		const stateService = this.ctx.get("evolutionState");
 		const lifecycle = this.lifecycle();
 		const persisted = await stateService?.loadCuratorState();
-		if (persisted && Date.now() - persisted.lastRunAt < lifecycle.intervalHours * 36e5) return {
+		if (!options.ignoreGates && persisted && Date.now() - persisted.lastRunAt < lifecycle.intervalHours * 36e5) return {
 			stale: [],
 			archived: [],
 			errors: [],
 			report: this.skippedReport(runId, startedAt),
 			skipped: "interval"
 		};
-		if (this.minIdleHours > 0 && this.recentSessionActive()) return {
+		if (!options.ignoreGates && this.minIdleHours > 0 && this.recentSessionActive()) return {
 			stale: [],
 			archived: [],
 			errors: [],
@@ -163,28 +170,48 @@ var EvolutionCurator = class extends Service {
 		const root = this.skills.root;
 		const snapshotPath = await this.skills.snapshotAll("pre-curator-run");
 		const usage = await loadUsage(root, this.io);
+		const suppressedNames = new Set(await loadSuppressedNames(root, this.io));
+		const bundledNames = await this.seedBaseline(usage);
 		const result = computeLifecycleTransitions(usage, {
 			staleAfterDays: lifecycle.staleAfterDays,
 			archiveAfterDays: lifecycle.archiveAfterDays,
 			qualityWarnStaleAfterDays: this.qualityWarnStaleAfterDays,
 			excludeSkillNames: this.excludeSkillNames,
-			manageUnmanaged: this.manageUnmanaged
+			manageUnmanaged: this.manageUnmanaged,
+			pruneBuiltins: this.pruneBuiltins,
+			bundledNames,
+			suppressedNames
 		});
 		const errors = [];
 		const archivedSkills = [];
 		const llmNominations = this.llmReview ? await this.recommend(result.markStale) : [];
 		const archiveCandidates = [...new Set([...result.archive, ...llmNominations])];
+		let suppressedChanged = false;
 		for (const name of archiveCandidates) {
-			const archived = await this.skills.archive(name, "Lifecycle: reached archive threshold");
+			const archived = await this.skills.archive(name, {
+				reason: "Lifecycle: reached archive threshold",
+				allowBundled: this.pruneBuiltins
+			});
 			if (!archived.ok) {
 				const record = usage.get(name);
 				if (record) record.state = "active";
 				errors.push(`${name}: ${archived.message}`);
-			} else archivedSkills.push({
-				name,
-				path: archived.path ?? "",
-				reason: "Lifecycle: reached archive threshold"
-			});
+			} else {
+				archivedSkills.push({
+					name,
+					path: archived.path ?? "",
+					reason: "Lifecycle: reached archive threshold"
+				});
+				if (bundledNames.has(name)) {
+					suppressedNames.add(name);
+					suppressedChanged = true;
+				}
+			}
+		}
+		if (suppressedChanged) try {
+			await saveSuppressedNames(root, suppressedNames, this.io);
+		} catch {
+			this.ctx.logger.warn("evolution-curator: failed to persist suppressed names; archived built-ins may re-enter the lifecycle");
 		}
 		await saveUsage(root, usage, this.io);
 		this.lastRun = Date.now();
@@ -224,6 +251,19 @@ var EvolutionCurator = class extends Service {
 			report
 		};
 	}
+	/**
+	* Seed baseline records for tree skills the sidecar has not seen yet, so
+	* their inactivity clock starts now (first-sight defer) and bundled skills
+	* become known candidates only when prune-builtins opts them in.
+	*/
+	async seedBaseline(usage) {
+		const bundledNames = /* @__PURE__ */ new Set();
+		for (const summary of await this.skills.list()) {
+			if (!usage.has(summary.name)) usage.set(summary.name, emptyRecord());
+			if (await this.skills.isBundled(summary.name)) bundledNames.add(summary.name);
+		}
+		return bundledNames;
+	}
 	recentSessionActive() {
 		const agents = this.ctx.get("agents");
 		if (!agents) return false;
@@ -281,6 +321,12 @@ var EvolutionCurator = class extends Service {
 		const record = usage.get(name);
 		if (record) record.state = "active";
 		await saveUsage(this.skills.root, usage, this.io);
+		const suppressed = new Set(await loadSuppressedNames(this.skills.root, this.io));
+		if (suppressed.delete(name)) try {
+			await saveSuppressedNames(this.skills.root, suppressed, this.io);
+		} catch {
+			this.ctx.logger.warn(`evolution-curator: failed to persist suppressed names after restoring ${name}`);
+		}
 		return result;
 	}
 };

package/lib/types/index.d.ts

@@ -27,9 +27,19 @@ export interface Config {
     excludeSkillNames?: string[];
     /** Include usage records whose created_by is not 'agent' in lifecycle decisions. */
     manageUnmanaged?: boolean;
+    /** Archive long-unused bundled skills too (with suppression against re-seeds). */
+    pruneBuiltins?: boolean;
     /** Max tokens for the optional LLM nomination pass. */
     curatorReviewMaxTokens?: number;
 }
+/** Outcome of one curator run pass. */
+export interface CuratorRunOutcome {
+    stale: string[];
+    archived: string[];
+    errors: string[];
+    report: CuratorRunReport;
+    skipped?: string;
+}
 export declare class EvolutionCurator extends Service {
     static inject: string[];
     static Config: Schema<Config>;
@@ -45,6 +55,7 @@ export declare class EvolutionCurator extends Service {
     private readonly minIdleHours;
     private readonly excludeSkillNames;
     private readonly manageUnmanaged;
+    private readonly pruneBuiltins;
     private readonly curatorReviewMaxTokens;
     private lastRun;
     private timer;
@@ -60,13 +71,19 @@ export declare class EvolutionCurator extends Service {
      */
     recommend(candidates: string[]): Promise<string[]>;
     private skippedReport;
-    run(): Promise<{
-        stale: string[];
-        archived: string[];
-        errors: string[];
-        report: CuratorRunReport;
-        skipped?: string;
-    }>;
+    /**
+     * Run one curator pass. `ignoreGates` skips the interval and idle gates so an
+     * explicit `/evolution curator run` always executes (manual-run semantics).
+     */
+    run(options?: {
+        ignoreGates?: boolean;
+    }): Promise<CuratorRunOutcome>;
+    /**
+     * Seed baseline records for tree skills the sidecar has not seen yet, so
+     * their inactivity clock starts now (first-sight defer) and bundled skills
+     * become known candidates only when prune-builtins opts them in.
+     */
+    private seedBaseline;
     private recentSessionActive;
     latestReport(): Promise<CuratorRunReport | null>;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-curator",
   "description": "Deterministic skill lifecycle and recovery (community build)",
-  "version": "0.1.0-rc.12",
+  "version": "0.1.0-rc.14",
   "publishConfig": {
     "access": "public"
   },
@@ -33,20 +33,20 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.12"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.14"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.12",
-    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.12"
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.14",
+    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.14"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.12",
-    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.12",
-    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.12"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.14",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.14",
+    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.14"
   }
 }