@lmzhen/dsh-evolution-curator 0.1.0-rc.42 → 0.1.0-rc.44

package/lib/index.js

@@ -3,12 +3,14 @@ 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, computeScopeView, 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, SkillLibrary, buildCuratorRunReport, computeLifecycleTransitions, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, loadSuppressedNames, loadUsage, parseCuratorNominations, relatedSkillNames, 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
 */
+/** Quality-warned skills may turn stale after this many idle days (package-private tunable, P2-8). */
+const DEFAULT_QUALITY_WARN_STALE_AFTER_DAYS = 7;
 /**
 * Block LLM-nominated consolidations that would touch a gate-protected name:
 * exclude / referenced / suppressed skills must never merge (neither as the
@@ -28,7 +30,7 @@ var EvolutionCurator = class extends Service {
 		archiveAfterDays: z.number().default(DEFAULT_ARCHIVE_AFTER_DAYS),
 		llmReview: z.boolean().default(false),
 		curatorProvider: z.string().default("deepseek-official"),
-		qualityWarnStaleAfterDays: z.number().default(7),
+		qualityWarnStaleAfterDays: z.number().default(DEFAULT_QUALITY_WARN_STALE_AFTER_DAYS),
 		minIdleHours: z.number().default(DEFAULT_MIN_IDLE_HOURS),
 		excludeSkillNames: z.array(z.string()).default([]),
 		manageUnmanaged: z.boolean().default(false),
@@ -68,7 +70,7 @@ var EvolutionCurator = class extends Service {
 		this.archiveAfterDays = config.archiveAfterDays ?? DEFAULT_ARCHIVE_AFTER_DAYS;
 		this.llmReview = config.llmReview ?? false;
 		this.curatorProvider = config.curatorProvider ?? "deepseek-official";
-		this.qualityWarnStaleAfterDays = config.qualityWarnStaleAfterDays ?? 7;
+		this.qualityWarnStaleAfterDays = config.qualityWarnStaleAfterDays ?? DEFAULT_QUALITY_WARN_STALE_AFTER_DAYS;
 		this.minIdleHours = config.minIdleHours ?? DEFAULT_MIN_IDLE_HOURS;
 		this.excludeSkillNames = new Set(config.excludeSkillNames ?? []);
 		this.manageUnmanaged = config.manageUnmanaged ?? false;
@@ -109,6 +111,33 @@ var EvolutionCurator = class extends Service {
 		this.bootCheck = void 0;
 	}
 	/**
+	* Pause or resume automatic curation (B-line G2, Hermes `set_paused`
+	* parity): the flag is persisted on the curator state record and the
+	* `run()` paused gate skips automatic passes while it holds. Manual runs
+	* (`ignoreGates`) are unaffected — pause is a soft stop for the scheduler,
+	* not a lock on the operator.
+	*
+	* Pausing on a state-less curator state seeds the record with `lastRunAt:
+	* now`, so a later resume re-enters through the interval gate and defers a
+	* full cycle instead of firing immediately (first-run defer interaction,
+	* kept deliberately: an unattended resume must not auto-run mid-boot).
+	*/
+	async setPaused(paused) {
+		const stateService = this.curatorStateService();
+		const persisted = await stateService?.loadCuratorState() ?? null;
+		await stateService?.saveCuratorState({
+			schemaVersion: 1,
+			lastRunAt: persisted?.lastRunAt ?? Date.now(),
+			runCount: persisted?.runCount ?? 0,
+			lastSummary: persisted?.lastSummary ?? (paused ? "paused" : "resumed"),
+			paused
+		});
+	}
+	/** Current persisted curator state (read-only view for /evolution curator status). */
+	async status() {
+		return await this.curatorStateService()?.loadCuratorState() ?? null;
+	}
+	/**
 	* One automatic schedule check: run a pass when the persisted curator state
 	* (falling back to the in-memory clock for state-less compositions) is at
 	* least one interval old. All gates — interval, idle, first-run defer,
@@ -254,7 +283,14 @@ var EvolutionCurator = class extends Service {
 		const runId = randomUUID();
 		const stateService = this.curatorStateService();
 		const lifecycle = this.lifecycle();
-		const persisted = await stateService?.loadCuratorState();
+		const persisted = await stateService?.loadCuratorState() ?? null;
+		if (!ignoreGates && persisted?.paused === true) return {
+			stale: [],
+			archived: [],
+			errors: [],
+			report: this.skippedReport(runId, startedAt),
+			skipped: "paused"
+		};
 		if (!ignoreGates && persisted && Date.now() - persisted.lastRunAt < lifecycle.intervalHours * 36e5) return {
 			stale: [],
 			archived: [],
@@ -291,6 +327,7 @@ var EvolutionCurator = class extends Service {
 		const snapshotPath = dryRun ? void 0 : await this.snapshotFull("pre-curator-run");
 		const suppressedNames = new Set(await loadSuppressedNames(root, this.io));
 		const { bundledNames, treeNames } = await this.seedBaseline(usage);
+		await this.scoreTree(usage, treeNames);
 		const result = computeLifecycleTransitions(usage, {
 			staleAfterDays: lifecycle.staleAfterDays,
 			archiveAfterDays: lifecycle.archiveAfterDays,
@@ -302,7 +339,6 @@ var EvolutionCurator = class extends Service {
 			suppressedNames,
 			referencedSkillNames: this.referencedSkillNames
 		});
-		await this.scoreTree(usage, treeNames);
 		const nominations = this.llmReview ? await this.recommend(result.markStale, { dryRun }) : {
 			prunings: [],
 			consolidations: []
@@ -421,14 +457,7 @@ var EvolutionCurator = class extends Service {
 		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);
-			}
+			for (const target of relatedSkillNames(content, name)) counts.set(target, (counts.get(target) ?? 0) + 1);
 		}
 		return counts;
 	}

package/lib/types/index.d.ts

@@ -94,6 +94,21 @@ export declare class EvolutionCurator extends Service {
     private lifecycle;
     start(): void;
     stop(): void;
+    /**
+     * Pause or resume automatic curation (B-line G2, Hermes `set_paused`
+     * parity): the flag is persisted on the curator state record and the
+     * `run()` paused gate skips automatic passes while it holds. Manual runs
+     * (`ignoreGates`) are unaffected — pause is a soft stop for the scheduler,
+     * not a lock on the operator.
+     *
+     * Pausing on a state-less curator state seeds the record with `lastRunAt:
+     * now`, so a later resume re-enters through the interval gate and defers a
+     * full cycle instead of firing immediately (first-run defer interaction,
+     * kept deliberately: an unattended resume must not auto-run mid-boot).
+     */
+    setPaused(paused: boolean): Promise<void>;
+    /** Current persisted curator state (read-only view for /evolution curator status). */
+    status(): Promise<CuratorStateRecordShape | null>;
     /**
      * One automatic schedule check: run a pass when the persisted curator state
      * (falling back to the in-memory clock for state-less compositions) is at

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