@lmzhen/dsh-evolution-curator 0.1.0-rc.25 → 0.1.0-rc.27

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, 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.
@@ -181,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;
@@ -270,6 +286,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,
@@ -284,7 +302,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);
@@ -295,6 +314,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.
@@ -394,6 +435,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.

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 CuratorNominations, type CuratorRunReport, type ScopeView, type SkillActionResult } from '@deepseek-ai/dsh-evolution-core';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         evolutionCurator: EvolutionCurator;
@@ -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
@@ -117,6 +124,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.25",
+  "version": "0.1.0-rc.27",
   "publishConfig": {
     "access": "public"
   },
@@ -33,20 +33,20 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.25"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.27"
   },
   "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.25",
-    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.25"
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.27",
+    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.27"
   },
   "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.25",
-    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.25",
-    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.25"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.27",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.27",
+    "@lmzhen/dsh-evolution-state": "^0.1.0-rc.27"
   }
 }