@lmzhen/dsh-evolution-curator 0.3.74 → 0.3.77

package/README.md

@@ -39,3 +39,5 @@ Independent of request-prefix construction. This package does not alter the asse
 
 - `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.
+
+**Runtime invariant:** No companion is published. The platform auto-assembles nothing and the family mounts no `<pkg>/invariant` cordis row, so a companion here would never execute (v37 S2.1 / I-3).

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_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, MAX_TIMER_DELAY_MS, SKILL_NAME_RE, SkillLibrary, buildCuratorRunReport, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, foldCuratorFields, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, parseCuratorNominations, parseFrontmatter, relatedSkillNames, renderCuratorReportMarkdown, resolveSkillsRoot, updateSuppressedNames, usageObserved } from "@lmzhen/dsh-evolution-core";
+import { CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, MAX_TIMER_DELAY_MS, SKILL_NAME_RE, buildCuratorRunReport, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, foldCuratorFields, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, newSkillLibrary, parseCuratorNominations, parseFrontmatter, relatedSkillNames, renderCuratorReportMarkdown, updateSuppressedNames, usageObserved } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Deterministic skill lifecycle curator with interval gate and archive.
@@ -95,8 +95,10 @@ var EvolutionCurator = class extends Service {
 	constructor(ctx, config = {}) {
 		super(ctx, "evolutionCurator");
 		this.io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
-		this.skills = new SkillLibrary(resolveSkillsRoot({ root: config.root }), this.io, void 0, (event) => {
-			this.ctx.emit("evolution/skill-mutated", event);
+		this.skills = newSkillLibrary({
+			config,
+			io: this.io,
+			ctx: this.ctx
 		});
 		this.enabled = config.enabled ?? true;
 		const clamped = [];
@@ -524,7 +526,7 @@ var EvolutionCurator = class extends Service {
 			suppressedNames,
 			referencedSkillNames: this.referencedSkillNames
 		}, /* @__PURE__ */ new Date(), gates, protectedNames);
-		const recommendPool = [...new Set([...result.markStale, ...dedupMembers])];
+		const recommendPool = [...new Set([...result.markStale, ...dedupMembers])].filter((name) => SKILL_NAME_RE.test(name));
 		const nominations = this.llmReview ? await this.recommend(recommendPool, { dryRun }) : {
 			prunings: [],
 			consolidations: [],
@@ -742,6 +744,7 @@ var EvolutionCurator = class extends Service {
 				consolidated: []
 			};
 		}
+		const alreadyArchived = /* @__PURE__ */ new Set();
 		for (const name of archiveCandidates) {
 			if (!treeNames.has(name)) {
 				const record = usage.get(name);
@@ -751,6 +754,10 @@ var EvolutionCurator = class extends Service {
 					stateOwned.add(name);
 					this.ctx.logger.warn(`evolution-curator: skill "${name}" left the tree without an archive move - its usage record was folded to archived; if the directory is still on disk, repair or remove it manually (it will not re-enter the lifecycle while the record is archived)`);
 				}
+				if (!SKILL_NAME_RE.test(name)) {
+					this.ctx.logger.warn(`evolution-curator: usage sidecar key "${name}" is not a valid skill name - skipped (no archive/marker probe, no suppression write)`);
+					continue;
+				}
 				let wasBundled = false;
 				try {
 					wasBundled = await this.io.exists(join(this.skills.root, ".archive", name, markerEntryName("bundled")));
@@ -802,6 +809,7 @@ var EvolutionCurator = class extends Service {
 					path: archived.path ?? "",
 					reason: "Lifecycle: reached archive threshold"
 				});
+				alreadyArchived.add(name);
 				if (bundledNames.has(name)) {
 					suppressedNames.add(name);
 					suppressedAdded.add(name);
@@ -809,7 +817,6 @@ var EvolutionCurator = class extends Service {
 				}
 			}
 		}
-		const alreadyArchived = new Set(archiveCandidates);
 		let consolidationDisposed = false;
 		if (this.isDisposed()) {
 			consolidationDisposed = true;
@@ -840,7 +847,8 @@ var EvolutionCurator = class extends Service {
 			alreadyArchived.add(nomination.from);
 			executedConsolidations.push({
 				from: nomination.from,
-				into: nomination.into
+				into: nomination.into,
+				...nomination.mode === void 0 ? {} : { mode: nomination.mode }
 			});
 			archivedSkills.push({
 				name: nomination.from,
@@ -905,6 +913,7 @@ var EvolutionCurator = class extends Service {
 		}
 		const real = [];
 		const errors = [];
+		let unorderableWarned = false;
 		for (const name of entries.filter((entry) => entry.startsWith("curator-") && entry.endsWith(".json"))) try {
 			const raw = await this.io.readText(join(reportsRoot, name));
 			if (raw === null) continue;
@@ -914,10 +923,15 @@ var EvolutionCurator = class extends Service {
 				const mtime = await this.io.mtime?.(join(reportsRoot, name)) ?? null;
 				if (mtime !== null) startedAt = mtime;
 			}
+			if (!Number.isFinite(startedAt) && typeof parsed.at === "string") startedAt = Date.parse(parsed.at);
 			if (Number.isFinite(startedAt)) (name.startsWith("curator-error-") ? errors : real).push({
 				name,
 				startedAt
 			});
+			else if (!unorderableWarned) {
+				unorderableWarned = true;
+				this.ctx.logger.warn(`evolution-curator: report "${name}" carries no usable timestamp and this backend has no mtime probe - it is kept outside the retention window`);
+			}
 		} catch {}
 		real.sort((a, b) => b.startedAt - a.startedAt);
 		errors.sort((a, b) => b.startedAt - a.startedAt);
@@ -938,10 +952,26 @@ var EvolutionCurator = class extends Service {
 	}
 	async latestReport() {
 		const reportsRoot = join(evolutionHome(), "reports");
-		const names = (await this.io.list(reportsRoot)).filter((name) => name.startsWith("curator-") && name.endsWith(".json") && !name.startsWith("curator-error-"));
+		let names;
+		try {
+			names = (await this.io.list(reportsRoot)).filter((name) => name.startsWith("curator-") && name.endsWith(".json") && !name.startsWith("curator-error-"));
+		} catch (error) {
+			this.ctx.logger.warn(`evolution-curator: latestReport could not list the reports directory (${error instanceof Error ? error.message : String(error)}) - answering "no report"`);
+			return null;
+		}
 		let latest = null;
+		let probeWarned = false;
 		for (const name of names) {
-			const mtime = await this.io.mtime?.(join(reportsRoot, name)) ?? null;
+			let mtime;
+			try {
+				mtime = await this.io.mtime?.(join(reportsRoot, name)) ?? null;
+			} catch (error) {
+				if (!probeWarned) {
+					probeWarned = true;
+					this.ctx.logger.warn(`evolution-curator: latestReport could not read a report mtime (${error instanceof Error ? error.message : String(error)}) - the affected report(s) are not eligible as the latest`);
+				}
+				continue;
+			}
 			if (mtime === null) continue;
 			if (latest === null || mtime > latest.mtime) latest = {
 				name,

package/lib/types/index.d.ts

@@ -4,7 +4,7 @@
  */
 import { Context, Service } from '@deepseek-ai/cordis';
 import type Schema from '@deepseek-ai/schemastery';
-import { EvolutionGateSet, SkillLibrary } from '@lmzhen/dsh-evolution-core';
+import { EvolutionGateSet, type SkillLibrary } from '@lmzhen/dsh-evolution-core';
 import { type CuratorConsolidation, type CuratorNominations, type CuratorRunReport, type ScopeView, type SkillActionResult, type SkillHealthVerdict } from '@lmzhen/dsh-evolution-core';
 import type { CuratorStateRecord } from '@lmzhen/dsh-evolution-state';
 declare module '@deepseek-ai/cordis' {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-curator",
   "description": "Deterministic skill lifecycle and recovery (community build)",
-  "version": "0.3.74",
+  "version": "0.3.77",
   "publishConfig": {
     "access": "public"
   },
@@ -18,10 +18,6 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -31,22 +27,20 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.74"
+    "@lmzhen/dsh-evolution-core": "^0.3.77"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.3.74",
-    "@lmzhen/dsh-evolution-state": "^0.3.74"
+    "@lmzhen/dsh-evolution-io": "^0.3.77",
+    "@lmzhen/dsh-evolution-state": "^0.3.77"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.3.74",
-    "@lmzhen/dsh-evolution-io": "^0.3.74",
-    "@lmzhen/dsh-evolution-state": "^0.3.74"
+    "@lmzhen/dsh-evolution-core": "^0.3.77",
+    "@lmzhen/dsh-evolution-io": "^0.3.77",
+    "@lmzhen/dsh-evolution-state": "^0.3.77"
   }
 }

package/lib/invariant.js

@@ -1,8 +0,0 @@
-//#region lib/types/invariant.js
-const PACKAGE_NAME = "@lmzhen/dsh-evolution-curator";
-const name = "evolution-curator-invariant";
-const inject = ["invariants"];
-const install = () => {};
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,5 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "evolution-curator-invariant";
-export declare const inject: string[];
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map