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

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_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, SkillLibrary, buildCuratorRunReport, computeLifecycleTransitions, computeQualityScores, emptyRecord, evolutionHome, evolutionIoAdapter, loadSuppressedNames, loadUsage, parseCuratorNominations, 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, 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.
@@ -150,7 +150,8 @@ var EvolutionCurator = class extends Service {
 			llmNominations: [],
 			archiveCandidates: [],
 			archived: [],
-			failed: []
+			failed: [],
+			llmReviewEnabled: this.llmReview
 		});
 	}
 	/**
@@ -180,6 +181,22 @@ var EvolutionCurator = class extends Service {
 			report: this.skippedReport(runId, startedAt),
 			skipped: "active-session"
 		};
+		if (!ignoreGates && persisted === null) {
+			await stateService?.saveCuratorState({
+				schemaVersion: 1,
+				lastRunAt: Date.now(),
+				runCount: 0,
+				lastSummary: "first-run-deferred",
+				paused: false
+			});
+			return {
+				stale: [],
+				archived: [],
+				errors: [],
+				report: this.skippedReport(runId, startedAt),
+				skipped: "first-run-deferred"
+			};
+		}
 		const root = this.skills.root;
 		const rawUsage = await loadUsage(root, this.io);
 		const usage = dryRun ? new Map([...rawUsage].map(([name, record]) => [name, { ...record }])) : rawUsage;
@@ -229,7 +246,8 @@ var EvolutionCurator = class extends Service {
 					reason: errors.find((item) => item.startsWith(`${name}:`))?.slice(name.length + 2) ?? "unknown"
 				};
 			}),
-			...snapshotPath === void 0 ? {} : { snapshotPath }
+			...snapshotPath === void 0 ? {} : { snapshotPath },
+			llmReviewEnabled: this.llmReview
 		});
 		const reportsRoot = join(evolutionHome(), "reports");
 		try {
@@ -238,7 +256,8 @@ var EvolutionCurator = class extends Service {
 			this.ctx.logger.warn(`evolution-curator: failed to persist report ${runId}`);
 			this.ctx.logger.warn(error);
 		}
-		const summary = `${dryRun ? "dry-run" : "auto"}: stale:${result.markStale.length} archived:${archivedSkills.length} consolidated:${nominations.consolidations.length}`;
+		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}`;
 		await stateService?.saveCuratorState({
 			schemaVersion: 1,
 			lastRunAt: dryRun ? persisted?.lastRunAt ?? this.lastRun : this.lastRun,
@@ -281,7 +300,8 @@ var EvolutionCurator = class extends Service {
 		for (const name of treeNames) supportDirs.set(name, await this.skills.countSupportDirs(name));
 		const quality = computeQualityScores({
 			usage,
-			supportDirs
+			supportDirs,
+			referenceCounts: await this.referenceCounts(treeNames)
 		});
 		for (const [name, score] of quality) {
 			const record = usage.get(name);
@@ -292,6 +312,28 @@ var EvolutionCurator = class extends Service {
 		}
 	}
 	/**
+	* In-degree over explicit `related_skills` frontmatter references (the DSH
+	* equivalent of the graph-in-degree references factor): a skill listing
+	* other skill names counts as one reference to each of them, so hub skills
+	* that are explicitly named by peers get a non-zero references factor.
+	*/
+	async referenceCounts(treeNames) {
+		const counts = /* @__PURE__ */ new Map();
+		for (const name of treeNames) {
+			const content = await this.skills.read(name);
+			if (!content) continue;
+			const parsed = parseFrontmatter(content);
+			if (!parsed) continue;
+			const raw = parsed.frontmatter["related_skills"];
+			if (typeof raw !== "string") continue;
+			for (const match of Array.from(raw.matchAll(/[a-z0-9][a-z0-9-]*/g))) {
+				const target = match[0];
+				if (target && SKILL_NAME_RE.test(target) && target !== name) counts.set(target, (counts.get(target) ?? 0) + 1);
+			}
+		}
+		return counts;
+	}
+	/**
 	* Execute lifecycle archives and consolidation nominations, then persist the
 	* suppression and usage sidecars best-effort. A dry-run short-circuits: no
 	* file moves and no state persistence — the caller still writes the report.

package/lib/types/index.d.ts

@@ -109,6 +109,13 @@ export declare class EvolutionCurator extends Service {
      * F13 six-factor quality scoring, persisted onto the usage records.
      */
     private scoreTree;
+    /**
+     * In-degree over explicit `related_skills` frontmatter references (the DSH
+     * equivalent of the graph-in-degree references factor): a skill listing
+     * other skill names counts as one reference to each of them, so hub skills
+     * that are explicitly named by peers get a non-zero references factor.
+     */
+    private referenceCounts;
     /**
      * Execute lifecycle archives and consolidation nominations, then persist the
      * suppression and usage sidecars best-effort. A dry-run short-circuits: no

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