@lmzhen/dsh-evolution-curator 0.1.0-rc.41 → 0.1.0-rc.43

package/lib/index.js

@@ -109,6 +109,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 +281,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 +325,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 +337,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: []

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