@lmzhen/dsh-evolution-curator 0.1.0-rc.38 → 0.1.0-rc.39

package/README.md

@@ -30,3 +30,8 @@ Independent of request-prefix construction. This package does not alter the asse
 - `restore(name)` (service) / `/evolution skill restore <name>` brings one archived skill back to the active root and resets its usage state.
 - `consolidate(target, sources)` (service) / `/evolution consolidate` merges source bodies into the target, archives the sources with an absorbed-into marker, and folds their usage records into `archived` state. Both operations snapshot the full state first (`pre-consolidate` / `pre-restore`).
 - `restoreSnapshot` (service) / `/evolution restore` rolls the FULL state back to the latest snapshot: active tree, usage/suppression sidecars, `.archive/` and the curator state carried in the snapshot (`curator-state.json`), so the interval gate does not immediately re-fire after a rollback. The restore itself is undoable — the pre-rollback safety snapshot preserves the current tree plus its state.
+
+## Automatic scheduling
+
+- `autoStart` (default true) arms an hourly interval check plus a deferred catch-up check `bootGraceSeconds` (default 10) after host boot. Both decide due-ness from the **persisted** `lastRunAt`, so a restart with an overdue schedule runs the first pass within the boot grace instead of waiting a full interval. `bootGraceSeconds: 0` disables the deferral (not recommended: the check may run against a half-mounted host). All scheduling gates — interval, idle, first-run deferral, and the reentrancy guard — remain inside `run()`.
+- `autoStart: false` disables both automatic checks; `/evolution curator run` (manual, gate-skipping) still works.

package/lib/index.js

@@ -35,6 +35,7 @@ var EvolutionCurator = class extends Service {
 		pruneBuiltins: z.boolean().default(false),
 		referencedSkillNames: z.array(z.string()).default([]),
 		autoStart: z.boolean().default(true),
+		bootGraceSeconds: z.number().default(10),
 		curatorReviewMaxTokens: z.number().default(2048)
 	});
 	skills;
@@ -51,9 +52,11 @@ var EvolutionCurator = class extends Service {
 	manageUnmanaged;
 	pruneBuiltins;
 	referencedSkillNames;
+	bootGraceSeconds;
 	curatorReviewMaxTokens;
 	lastRun = 0;
 	timer;
+	bootCheck;
 	running = false;
 	constructor(ctx, config = {}) {
 		super(ctx, "evolutionCurator");
@@ -71,6 +74,7 @@ var EvolutionCurator = class extends Service {
 		this.manageUnmanaged = config.manageUnmanaged ?? false;
 		this.pruneBuiltins = config.pruneBuiltins ?? false;
 		this.referencedSkillNames = new Set(config.referencedSkillNames ?? []);
+		this.bootGraceSeconds = config.bootGraceSeconds ?? 10;
 		this.curatorReviewMaxTokens = config.curatorReviewMaxTokens ?? 2048;
 		this.lastRun = Date.now();
 		this.ctx.effect(() => {
@@ -90,14 +94,30 @@ var EvolutionCurator = class extends Service {
 	}
 	start() {
 		if (!this.enabled || this.timer) return;
-		this.timer = setInterval(() => {
-			if (Date.now() - this.lastRun >= this.lifecycle().intervalHours * 36e5) this.run();
-		}, 3600 * 1e3);
+		this.bootCheck = setTimeout(() => {
+			this.bootCheck = void 0;
+			this.autoCheck();
+		}, this.bootGraceSeconds * 1e3);
+		this.bootCheck.unref();
+		this.timer = setInterval(() => void this.autoCheck(), 3600 * 1e3);
 		this.timer.unref();
 	}
 	stop() {
 		if (this.timer) clearInterval(this.timer);
 		this.timer = void 0;
+		if (this.bootCheck) clearTimeout(this.bootCheck);
+		this.bootCheck = void 0;
+	}
+	/**
+	* 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,
+	* reentrancy — stay inside `run()`, so this method only decides whether to
+	* wake it, and never duplicates gate logic.
+	*/
+	async autoCheck() {
+		const last = (await this.curatorStateService()?.loadCuratorState())?.lastRunAt ?? this.lastRun;
+		if (Date.now() - last >= this.lifecycle().intervalHours * 36e5) await this.run();
 	}
 	/**
 	* Optional Hermes-curator LLM pass. The model may only NOMINATE pruning and

package/lib/types/index.d.ts

@@ -33,6 +33,8 @@ export interface Config {
     referencedSkillNames?: string[];
     /** Start the interval timer on context ready (auto-curation). Default true. */
     autoStart?: boolean;
+    /** Seconds between host boot and the first automatic schedule check (restart catch-up). */
+    bootGraceSeconds?: number;
     /** Max tokens for the optional LLM nomination pass. */
     curatorReviewMaxTokens?: number;
 }
@@ -82,14 +84,24 @@ export declare class EvolutionCurator extends Service {
     private readonly manageUnmanaged;
     private readonly pruneBuiltins;
     private readonly referencedSkillNames;
+    private readonly bootGraceSeconds;
     private readonly curatorReviewMaxTokens;
     private lastRun;
     private timer;
+    private bootCheck;
     private running;
     constructor(ctx: Context, config?: Config);
     private lifecycle;
     start(): void;
     stop(): void;
+    /**
+     * 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,
+     * reentrancy — stay inside `run()`, so this method only decides whether to
+     * wake it, and never duplicates gate logic.
+     */
+    private autoCheck;
     /**
      * Optional Hermes-curator LLM pass. The model may only NOMINATE pruning and
      * consolidation; every move stays a control-plane operation and each

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