@lmzhen/dsh-evolution-core 0.1.0-rc.47 → 0.1.0-rc.49

package/lib/index.js

@@ -386,6 +386,39 @@ function buildCuratorRunReport(input) {
 		...input.llmReviewEnabled === void 0 ? {} : { llmReviewEnabled: input.llmReviewEnabled }
 	};
 }
+/**
+* Render a curator run report as a compact human-readable markdown digest
+* (G6): run metadata first, then the notable sections (archived / failed /
+* stale candidates / LLM nominations).
+*/
+function renderCuratorReportMarkdown(report) {
+	const lines = [
+		`# Curator run ${report.runId}`,
+		"",
+		`- **Started** ${report.startedAt}`,
+		`- **Finished** ${report.finishedAt}`,
+		`- **Stale candidates**: ${report.staleCandidates.length}`,
+		`- **LLM nominations**: ${report.llmNominations.length}`,
+		`- **Archived**: ${report.archived.length}`,
+		`- **Failed**: ${report.failed.length}`,
+		...report.snapshotPath === void 0 ? [] : [`- **Snapshot**: ${report.snapshotPath}`],
+		...report.llmReviewEnabled === void 0 ? [] : [`- **llmReview**: ${report.llmReviewEnabled}`]
+	];
+	const section = (title, items) => items.length === 0 ? [] : [
+		"",
+		`## ${title}`,
+		"",
+		...items.map((item) => `- ${item}`)
+	];
+	return [
+		...lines,
+		...section("Archived", report.archived.map((item) => `${item.name} (${item.reason})`)),
+		...section("Failed", report.failed.map((item) => `${item.name}: ${item.reason}`)),
+		...section("Stale candidates", report.staleCandidates),
+		...section("LLM nominations", report.llmNominations),
+		""
+	].join("\n");
+}
 const NOMINATION_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
 /**
 * Parse the curator LLM's YAML nomination block (consolidations + prunings).
@@ -1897,10 +1930,18 @@ var SkillLibrary = class {
 	root;
 	limits;
 	io;
-	constructor(root = skillsRoot(), io = nodeEvolutionIo(), limits = DEFAULT_SKILL_LIMITS) {
+	onMutation;
+	constructor(root = skillsRoot(), io = nodeEvolutionIo(), limits = DEFAULT_SKILL_LIMITS, onMutation) {
 		this.root = root;
 		this.io = io;
 		this.limits = limits;
+		this.onMutation = onMutation;
+	}
+	/** Notify the mutation observer after a successful write; observers must never fail the mutation. */
+	notifyMutation(event) {
+		try {
+			this.onMutation?.(event);
+		} catch {}
 	}
 	async list() {
 		const summaries = [];
@@ -1909,14 +1950,18 @@ var SkillLibrary = class {
 			const md = await this.io.readText(join(dir, "SKILL.md"));
 			if (!md) continue;
 			const parsed = parseFrontmatter(md);
-			const protectedBy = await this.deleteProtection(name);
-			const managed = await this.io.exists(markerPath(dir, "hermes-managed"));
+			let entries = [];
+			try {
+				entries = await this.io.list(dir);
+			} catch {}
+			const has = (marker) => entries.includes(marker);
+			const protectedBy = has("bundled") ? "bundled" : has("hub-installed") ? "hub-installed" : has("pinned") ? "pinned" : null;
 			summaries.push({
 				name,
 				description: parsed?.frontmatter.description ?? "",
 				path: dir,
 				protectedBy,
-				managed,
+				managed: has("hermes-managed"),
 				archived: false
 			});
 		}
@@ -2087,6 +2132,11 @@ var SkillLibrary = class {
 		await this.io.writeText(join(dir, "SKILL.md"), content.trimEnd() + "\n");
 		if (origin !== "foreground") await this.io.writeText(markerPath(dir, "hermes-managed"), "");
 		await this.audit(normalized, "create", null, content, "created");
+		this.notifyMutation({
+			action: "create",
+			name: normalized,
+			filePath: dir
+		});
 		return {
 			ok: true,
 			message: `Skill "${normalized}" created.`,
@@ -2123,6 +2173,11 @@ var SkillLibrary = class {
 		};
 		await this.io.writeText(join(dir, "SKILL.md"), content.trimEnd() + "\n");
 		await this.audit(name, "update", md, content, "updated");
+		this.notifyMutation({
+			action: "update",
+			name,
+			filePath: dir
+		});
 		return {
 			ok: true,
 			message: `Skill "${name}" updated.`,
@@ -2190,6 +2245,11 @@ var SkillLibrary = class {
 		};
 		await this.io.writeText(target, patched.trimEnd() + "\n");
 		await this.audit(name, "patch", md, patched, `patched ${patchLabel}`);
+		this.notifyMutation({
+			action: "patch",
+			name,
+			filePath: dir
+		});
 		return {
 			ok: true,
 			message: `Skill "${name}" patched (${patchLabel}).`,
@@ -2235,6 +2295,11 @@ var SkillLibrary = class {
 		const reason = options.reason ?? (options.absorbedInto ? `Consolidated into ${options.absorbedInto}` : "Archived by self-evolution curator");
 		await this.io.writeText(join(dest, ".archive-reason"), `${(/* @__PURE__ */ new Date()).toISOString()}: ${reason}\n`);
 		await this.audit(name, "archive", md, null, reason);
+		this.notifyMutation({
+			action: "archive",
+			name,
+			archivedPath: dest
+		});
 		return {
 			ok: true,
 			message: `Skill "${name}" archived to .archive.`,
@@ -2314,6 +2379,11 @@ var SkillLibrary = class {
 				message: `Consolidation failed and was rolled back: ${error instanceof Error ? error.message : String(error)}`
 			};
 		}
+		this.notifyMutation({
+			action: "consolidate",
+			name: targetName,
+			filePath: targetDir
+		});
 		return {
 			ok: true,
 			message: `Consolidated ${normalizedSources.join(", ")} into "${targetName}".`,
@@ -2359,6 +2429,11 @@ var SkillLibrary = class {
 			await this.io.remove(source);
 		}
 		if (await this.io.exists(join(dest, ".archive-reason"))) await this.io.remove(join(dest, ".archive-reason"));
+		this.notifyMutation({
+			action: "restore",
+			name,
+			filePath: dest
+		});
 		return {
 			ok: true,
 			message: `Skill "${name}" restored from .archive.`,
@@ -2400,6 +2475,11 @@ var SkillLibrary = class {
 		const existing = await this.io.readText(target).catch(() => null);
 		await this.io.writeText(target, content);
 		await this.audit(name, "write_file", existing, content, `wrote ${filePath}`);
+		this.notifyMutation({
+			action: "write_file",
+			name,
+			filePath: target
+		});
 		return {
 			ok: true,
 			message: `Support file "${filePath}" written to "${name}".`,
@@ -2436,6 +2516,11 @@ var SkillLibrary = class {
 		const before = await this.io.readText(target).catch(() => null);
 		await this.io.remove(target);
 		await this.audit(name, "remove_file", before, null, `removed ${filePath}`);
+		this.notifyMutation({
+			action: "remove_file",
+			name,
+			filePath: target
+		});
 		return {
 			ok: true,
 			message: `Support file "${filePath}" removed from "${name}".`,
@@ -2454,7 +2539,9 @@ var SkillLibrary = class {
 		let dest = join(backupRoot, `skills-${stamp}`);
 		while (await this.io.exists(dest)) dest = join(backupRoot, `skills-${stamp}-${Math.random().toString(36).slice(2, 8)}`);
 		const names = await listNames(this.root, this.io);
-		for (const name of names) await this.io.copy(this.dirOf(name), join(dest, name));
+		await Promise.all(names.map(async (name) => {
+			await this.io.copy(this.dirOf(name), join(dest, name));
+		}));
 		const sidecars = [];
 		for (const sidecar of [usageFile(this.root), suppressedFile(this.root)]) if (await this.io.exists(sidecar)) {
 			const name = basename(sidecar);
@@ -2467,12 +2554,11 @@ var SkillLibrary = class {
 			await this.io.copy(archiveRoot, join(dest, ".archive"));
 			hasArchive = true;
 		}
-		const extraNames = [];
-		for (const extra of extras) {
-			if (!SNAPSHOT_EXTRA_NAME_RE.test(extra.name)) continue;
+		const validExtras = extras.filter((extra) => SNAPSHOT_EXTRA_NAME_RE.test(extra.name));
+		const extraNames = validExtras.map((extra) => extra.name);
+		await Promise.all(validExtras.map(async (extra) => {
 			await this.io.writeText(join(dest, "extras", extra.name), extra.content);
-			extraNames.push(extra.name);
-		}
+		}));
 		await this.io.writeText(join(dest, "manifest.json"), JSON.stringify({
 			reason,
 			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -2578,6 +2664,10 @@ var SkillLibrary = class {
 			} else if (manifest.hasArchive === false) await this.io.remove(archiveRoot);
 		}
 		const snapshotExtras = await this.readSnapshotExtras(latest.path);
+		this.notifyMutation({
+			action: "restore",
+			name: "snapshot"
+		});
 		return {
 			ok: true,
 			message: `Restored skill tree from ${latest.path}`,
@@ -2652,4 +2742,4 @@ var JsonState = class JsonState {
 	}
 };
 //#endregion
-export { COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_USER_CHAR_LIMIT, DSH_AUTHORING_STANDARDS, ENTRY_DELIMITER, EvolutionGateSet, JsonState, LOW_QUALITY_THRESHOLD, MAX_DESCRIPTION_LENGTH, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MEMORY_REVIEW_PROMPT, MUTATIONS_FILE_VERSION, MemoryStore, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, QUALITY_WEIGHTS, SKILL_NAME_RE, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, advanceReview, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpUse, bumpView, computeDedupGroups, computeLifecycleTransitions, computeQualityScores, computeScopeView, contentHash, createGateSet, emptyRecord, evaluateThreat, evolutionHome, evolutionIoAdapter, foldTurn, getRecord, latestActivityAt, lifecycleCandidate, loadMutations, loadSuppressedNames, loadUsage, markAgentCreated, memoryRoot, mutationsFile, nodeEvolutionIo, normalizeUsageRecord, observeEvent, parseCuratorNominations, parseFrontmatter, recordMutation, relatedSkillNames, resolveOrigins, reviewPrompt, saveSuppressedNames, saveUsage, scanContentThreats, scanMemoryThreats, scanThreats, skillsRoot, suppressedFile, usageFile, validateFrontmatter, verifyPromptBundle };
+export { COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_USER_CHAR_LIMIT, DSH_AUTHORING_STANDARDS, ENTRY_DELIMITER, EvolutionGateSet, JsonState, LOW_QUALITY_THRESHOLD, MAX_DESCRIPTION_LENGTH, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MEMORY_REVIEW_PROMPT, MUTATIONS_FILE_VERSION, MemoryStore, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, QUALITY_WEIGHTS, SKILL_NAME_RE, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, advanceReview, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpUse, bumpView, computeDedupGroups, computeLifecycleTransitions, computeQualityScores, computeScopeView, contentHash, createGateSet, emptyRecord, evaluateThreat, evolutionHome, evolutionIoAdapter, foldTurn, getRecord, latestActivityAt, lifecycleCandidate, loadMutations, loadSuppressedNames, loadUsage, markAgentCreated, memoryRoot, mutationsFile, nodeEvolutionIo, normalizeUsageRecord, observeEvent, parseCuratorNominations, parseFrontmatter, recordMutation, relatedSkillNames, renderCuratorReportMarkdown, resolveOrigins, reviewPrompt, saveSuppressedNames, saveUsage, scanContentThreats, scanMemoryThreats, scanThreats, skillsRoot, suppressedFile, usageFile, validateFrontmatter, verifyPromptBundle };

package/lib/types/curator.d.ts

@@ -75,6 +75,12 @@ export interface CuratorReportInput {
     llmReviewEnabled?: boolean;
 }
 export declare function buildCuratorRunReport(input: CuratorReportInput): CuratorRunReport;
+/**
+ * Render a curator run report as a compact human-readable markdown digest
+ * (G6): run metadata first, then the notable sections (archived / failed /
+ * stale candidates / LLM nominations).
+ */
+export declare function renderCuratorReportMarkdown(report: CuratorRunReport): string;
 /** One LLM-nominated consolidation: `from` merges into the umbrella `into`. */
 export interface CuratorConsolidation {
     from: string;

package/lib/types/skill-store.d.ts

@@ -8,6 +8,7 @@
  */
 import { type EvolutionIoLike } from './io.ts';
 import { type MutationRecord } from './mutations.ts';
+import type { EvolutionSkillMutatedEvent } from './events.ts';
 export interface SkillLimits {
     maxNameLength: number;
     maxDescriptionLength: number;
@@ -97,7 +98,10 @@ export declare class SkillLibrary {
     readonly root: string;
     readonly limits: SkillLimits;
     private readonly io;
-    constructor(root?: string, io?: EvolutionIoLike, limits?: SkillLimits);
+    private readonly onMutation;
+    constructor(root?: string, io?: EvolutionIoLike, limits?: SkillLimits, onMutation?: (event: EvolutionSkillMutatedEvent) => void);
+    /** Notify the mutation observer after a successful write; observers must never fail the mutation. */
+    private notifyMutation;
     list(): Promise<SkillSummary[]>;
     read(rawName: string): Promise<string | null>;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-core",
   "description": "Shared stores, prompts, signals and lifecycle logic for the dsh-evolution plugin family (community build)",
-  "version": "0.1.0-rc.47",
+  "version": "0.1.0-rc.49",
   "publishConfig": {
     "access": "public"
   },