@lmzhen/dsh-evolution-curator 0.1.0-rc.26 → 0.1.0-rc.28

package/lib/index.js

@@ -3,12 +3,22 @@ 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_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, SKILL_NAME_RE, SkillLibrary, buildCuratorRunReport, computeLifecycleTransitions, computeQualityScores, emptyRecord, evolutionHome, evolutionIoAdapter, loadSuppressedNames, loadUsage, parseCuratorNominations, parseFrontmatter, saveSuppressedNames, saveUsage } from "@lmzhen/dsh-evolution-core";
+import { CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, SKILL_NAME_RE, SkillLibrary, buildCuratorRunReport, computeLifecycleTransitions, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, loadSuppressedNames, loadUsage, parseCuratorNominations, parseFrontmatter, saveSuppressedNames, saveUsage } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Deterministic skill lifecycle curator with interval gate and archive.
 * @module @lmzhen/dsh-evolution-curator
 */
+/**
+* Block LLM-nominated consolidations that would touch a gate-protected name:
+* exclude / referenced / suppressed skills must never merge (neither as the
+* source being archived nor as the umbrella being edited). Mirrors the control
+* plane's `consolidate()` guard; automatic nominations must pass the same gate.
+*/
+function gateConsolidations(consolidations, gates) {
+	const blocked = (name) => gates.exclude?.has(name) === true || gates.referenced?.has(name) === true || gates.suppressed?.has(name) === true;
+	return consolidations.filter((n) => !blocked(n.from) && !blocked(n.into));
+}
 var EvolutionCurator = class extends Service {
 	static inject = ["evolutionIo"];
 	static Config = z.object({
@@ -219,12 +229,20 @@ var EvolutionCurator = class extends Service {
 			prunings: [],
 			consolidations: []
 		};
-		const llmNominations = nominations.prunings;
+		const gatedNominations = {
+			...nominations,
+			consolidations: gateConsolidations(nominations.consolidations, {
+				exclude: this.excludeSkillNames,
+				referenced: this.referencedSkillNames,
+				suppressed: suppressedNames
+			})
+		};
+		const llmNominations = gatedNominations.prunings;
 		const archiveCandidates = [...new Set([...result.archive, ...llmNominations])];
 		const { archivedSkills, errors } = await this.applyMutations({
 			dryRun,
 			archiveCandidates,
-			nominations,
+			nominations: gatedNominations,
 			treeNames,
 			usage,
 			bundledNames,
@@ -240,7 +258,7 @@ var EvolutionCurator = class extends Service {
 			llmNominations,
 			archiveCandidates,
 			archived: archivedSkills,
-			failed: [...new Set([...archiveCandidates, ...nominations.consolidations.map((item) => item.from)])].filter((name) => errors.some((error) => error.startsWith(`${name}:`))).map((name) => {
+			failed: [...new Set([...archiveCandidates, ...gatedNominations.consolidations.map((item) => item.from)])].filter((name) => errors.some((error) => error.startsWith(`${name}:`))).map((name) => {
 				return {
 					name,
 					reason: errors.find((item) => item.startsWith(`${name}:`))?.slice(name.length + 2) ?? "unknown"
@@ -257,7 +275,7 @@ var EvolutionCurator = class extends Service {
 			this.ctx.logger.warn(error);
 		}
 		const llmHint = !this.llmReview && result.markStale.length > 0 ? " (llmReview: off - deterministic archive only; set llmReview: true for the LLM merge channel)" : "";
-		const summary = `${dryRun ? "dry-run" : "auto"}: stale:${result.markStale.length} archived:${archivedSkills.length} consolidated:${nominations.consolidations.length}${llmHint}`;
+		const summary = `${dryRun ? "dry-run" : "auto"}: stale:${result.markStale.length} archived:${archivedSkills.length} consolidated:${gatedNominations.consolidations.length}${llmHint}`;
 		await stateService?.saveCuratorState({
 			schemaVersion: 1,
 			lastRunAt: dryRun ? persisted?.lastRunAt ?? this.lastRun : this.lastRun,
@@ -270,7 +288,7 @@ var EvolutionCurator = class extends Service {
 			archived: archivedSkills.map((item) => item.name),
 			errors,
 			report,
-			...this.llmReview ? { nominations } : {}
+			...this.llmReview ? { nominations: gatedNominations } : {}
 		};
 	}
 	/**
@@ -286,6 +304,8 @@ var EvolutionCurator = class extends Service {
 			treeNames.add(summary.name);
 			if (!usage.has(summary.name)) usage.set(summary.name, emptyRecord());
 			if (await this.skills.isBundled(summary.name)) bundledNames.add(summary.name);
+			const record = usage.get(summary.name);
+			if (record) record.pinned = await this.skills.isPinned(summary.name);
 		}
 		return {
 			bundledNames,
@@ -433,6 +453,27 @@ var EvolutionCurator = class extends Service {
 		}
 	}
 	/**
+	* Read-only lifecycle scope classification: which skills are in scope,
+	* watched (stale/quality-warned), exempted, or protected. Uses the same
+	* candidate gate as `run()` (`computeScopeView` / `lifecycleCandidate`),
+	* so the view always predicts what a curator pass may touch.
+	*/
+	async scopeView() {
+		const root = this.skills.root;
+		const usage = await loadUsage(root, this.io);
+		const { bundledNames } = await this.seedBaseline(usage);
+		return computeScopeView(usage, {
+			staleAfterDays: this.lifecycle().staleAfterDays,
+			archiveAfterDays: this.lifecycle().archiveAfterDays,
+			excludeSkillNames: this.excludeSkillNames,
+			referencedSkillNames: this.referencedSkillNames,
+			suppressedNames: new Set(await loadSuppressedNames(root, this.io)),
+			manageUnmanaged: this.manageUnmanaged,
+			pruneBuiltins: this.pruneBuiltins,
+			bundledNames
+		});
+	}
+	/**
 	* Control-plane consolidation: merge source skill bodies into `target`,
 	* archive the sources with an absorbed-into marker, and fold their usage
 	* records into `archived` state. Snapshot-then-mutate, never a hard delete.
@@ -476,4 +517,4 @@ var EvolutionCurator = class extends Service {
 	}
 };
 //#endregion
-export { EvolutionCurator, EvolutionCurator as default };
+export { EvolutionCurator, EvolutionCurator as default, gateConsolidations };

package/lib/types/index.d.ts

@@ -5,7 +5,7 @@
 import { Context, Service } from '@deepseek-ai/cordis';
 import type Schema from '@deepseek-ai/schemastery';
 import { SkillLibrary } from '@deepseek-ai/dsh-evolution-core';
-import { type CuratorNominations, type CuratorRunReport, type SkillActionResult } from '@deepseek-ai/dsh-evolution-core';
+import { type CuratorConsolidation, type CuratorNominations, type CuratorRunReport, type ScopeView, type SkillActionResult } from '@deepseek-ai/dsh-evolution-core';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         evolutionCurator: EvolutionCurator;
@@ -54,6 +54,17 @@ export interface CuratorStateRecordShape {
     lastSummary: string;
     paused: boolean;
 }
+/**
+ * Block LLM-nominated consolidations that would touch a gate-protected name:
+ * exclude / referenced / suppressed skills must never merge (neither as the
+ * source being archived nor as the umbrella being edited). Mirrors the control
+ * plane's `consolidate()` guard; automatic nominations must pass the same gate.
+ */
+export declare function gateConsolidations(consolidations: CuratorConsolidation[], gates: {
+    exclude?: ReadonlySet<string>;
+    referenced?: ReadonlySet<string>;
+    suppressed?: ReadonlySet<string>;
+}): CuratorConsolidation[];
 export declare class EvolutionCurator extends Service {
     static inject: string[];
     static Config: Schema<Config>;
@@ -124,6 +135,13 @@ export declare class EvolutionCurator extends Service {
     private applyMutations;
     private recentSessionActive;
     latestReport(): Promise<CuratorRunReport | null>;
+    /**
+     * Read-only lifecycle scope classification: which skills are in scope,
+     * watched (stale/quality-warned), exempted, or protected. Uses the same
+     * candidate gate as `run()` (`computeScopeView` / `lifecycleCandidate`),
+     * so the view always predicts what a curator pass may touch.
+     */
+    scopeView(): Promise<ScopeView>;
     /**
      * Control-plane consolidation: merge source skill bodies into `target`,
      * archive the sources with an absorbed-into marker, and fold their usage

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.26",
+  "version": "0.1.0-rc.28",
   "publishConfig": {
     "access": "public"
   },
@@ -33,20 +33,20 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.26"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.28"
   },
   "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.26",
-    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.26"
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.28",
+    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.28"
   },
   "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.26",
-    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.26",
-    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.26"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.28",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.28",
+    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.28"
   }
 }