@lmzhen/dsh-evolution-curator 0.23.0 → 0.25.0

package/lib/index.js

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 import z from "@deepseek-ai/schemastery";
 import { preferProvider } from "@lmzhen/dsh-evolution-io";
-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_REVIEW_TIMEOUT_MS, DEFAULT_SKILL_LIMITS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, INSTANCE_KEYS, MAX_TIMER_DELAY_MS, PROMPT_BUNDLE, SKILL_NAME_RE, buildCuratorRunReport, claimInstance, clampOnce, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, emptyRecord, entryTarget, evolutionHome, evolutionIoAdapter, foldCuratorFields, isPresent, isUnknown, liveBool, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, newSkillLibrary, paramRowId, parseCuratorNominations, parseFrontmatter, pickWithPolicy, policyStageLimits, probeList, probeText, readNumberParam, relatedSkillNames, releaseInstance, renderCuratorReportMarkdown, reportTime, reportsSweepLockTarget, sessionLastEventTime, sweepReports, transactIo, unwrapLive, updateSuppressedNames, usageObserved, userSetKeys, verifyPromptBundle } 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_REVIEW_TIMEOUT_MS, DEFAULT_SKILL_LIMITS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, INSTANCE_KEYS, MAX_TIMER_DELAY_MS, PROMPT_BUNDLE, SKILL_NAME_RE, buildCuratorRunReport, claimInstance, clampOnce, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, emptyRecord, entryTarget, evolutionHome, evolutionIoAdapter, foldCuratorFields, isPresent, isUnknown, lintSkill, liveBool, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, newSkillLibrary, paramRowId, parseCuratorNominations, parseFrontmatter, pickWithPolicy, policyStageLimits, probeList, probeText, readNumberParam, relatedSkillNames, releaseInstance, renderCuratorReportMarkdown, reportTime, reportsSweepLockTarget, sessionLastEventTime, sweepReports, transactIo, unwrapLive, updateSuppressedNames, usageObserved, userSetKeys, verifyPromptBundle } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Deterministic skill lifecycle curator with interval gate and archive.
@@ -33,6 +33,24 @@ function gateConsolidations(consolidations, gates) {
 	const gateSet = gates instanceof EvolutionGateSet ? gates : new EvolutionGateSet(gates);
 	return consolidations.filter((n) => !gateSet.isBlocked(n.from) && !gateSet.isBlocked(n.into));
 }
+/**
+* G5 (in-use protection): which skills are POINTED AT by others, and by whom.
+*
+* Pure: derived from the bodies already in hand, using `relatedSkillNames` — the single reader of
+* that frontmatter field — so this map can never disagree with the catalog or the audit. The value
+* is a Set of SOURCES, not a boolean, because a refusal has to be able to name the referrers.
+* @param contents - skill name to its whole SKILL.md text.
+* @returns target name to the set of skills naming it; targets nobody names are absent.
+*/
+function referencedSkillNames(contents) {
+	const referencedBy = /* @__PURE__ */ new Map();
+	for (const [owner, text] of contents) for (const target of relatedSkillNames(text, owner)) {
+		const sources = referencedBy.get(target) ?? /* @__PURE__ */ new Set();
+		sources.add(owner);
+		referencedBy.set(target, sources);
+	}
+	return referencedBy;
+}
 var EvolutionCurator = class extends Service {
 	static inject = ["evolutionIo"];
 	static Config = z.object({
@@ -609,7 +627,7 @@ var EvolutionCurator = class extends Service {
 	instanceHeldRefusal(operation) {
 		return {
 			ok: false,
-			message: `instance-held: this curator row yielded the per-home claim to another curator row of this process — ${operation} is refused alongside run() so the holder row stays the only control-plane writer (run it on the holder row)`
+			message: `instance-held：本 curator 行已把每 home 的占用权让给本进程的另一 curator 行。为保证持有行是唯一的控制面写入方，${operation} 与 run() 一并被拒绝（请在持有它的那一行上运行）。`
 		};
 	}
 	async runCore(options = {}) {
@@ -691,8 +709,9 @@ var EvolutionCurator = class extends Service {
 			const text = await this.skills.read(name);
 			if (text) contents.set(name, text);
 		}
+		const referencedBy = referencedSkillNames(contents);
 		const protectedNames = await this.protectedNameMap();
-		const dedupMembers = [...new Set(computeDedupGroups({ contents }).groups.filter((group) => group.length >= 2).flat())].filter((name) => !protectedNames.has(name));
+		const dedupMembers = [...new Set(computeDedupGroups({ contents }).groups.filter((group) => group.length >= 2).flat())].filter((name) => !protectedNames.has(name) && !referencedBy.has(name));
 		await this.scoreTree(usage, treeNames, contents);
 		const result = computeLifecycleTransitions(usage, {
 			staleAfterDays: lifecycle.staleAfterDays,
@@ -968,7 +987,7 @@ var EvolutionCurator = class extends Service {
 				continue;
 			}
 			const archived = await this.skills.archive(name, {
-				reason: "Lifecycle: reached archive threshold",
+				reason: "生命周期：已达归档阈值",
 				allowBundled: this.pruneBuiltins
 			});
 			if (!archived.ok) {
@@ -990,7 +1009,7 @@ var EvolutionCurator = class extends Service {
 				archivedSkills.push({
 					name,
 					path: archived.path ?? "",
-					reason: "Lifecycle: reached archive threshold"
+					reason: "生命周期：已达归档阈值"
 				});
 				alreadyArchived.add(name);
 				if (bundledNames.has(name)) {
@@ -1035,7 +1054,7 @@ var EvolutionCurator = class extends Service {
 			});
 			archivedSkills.push({
 				name: nomination.from,
-				reason: `Consolidated into ${nomination.into} (exact archive path: the evolution/skill-mutated event, archivedPath)`
+				reason: `已合并进 ${nomination.into}（精确归档路径见 evolution/skill-mutated 事件里的 archivedPath）`
 			});
 		}
 		if (suppressedChanged) try {
@@ -1219,10 +1238,47 @@ var EvolutionCurator = class extends Service {
 				patchCount: record.patch_count,
 				readCount: record.view_count
 			} : void 0);
-			if (assessment && assessment.verdict !== "healthy") rows.push({
+			if (assessment !== null) {
+				rows.push({
+					name: summary.name,
+					verdict: assessment.verdict,
+					dims: assessment.dims,
+					findings: assessment.findings
+				});
+				continue;
+			}
+			const findings = lintSkill({
+				skillName: summary.name,
+				dims: {
+					bodyChars: null,
+					bodyTokens: null,
+					stampDensityPerKb: null,
+					stampHits: null,
+					supportGroups: 0,
+					supportFiles: null,
+					churnPatches: null,
+					churnReads: null
+				},
+				softLineChars: thresholds.softBodyChars,
+				overSoftLine: false,
+				overTwiceSoftLine: false,
+				stampLimitPerKb: thresholds.stampDensityPerKb,
+				churnMinPatches: thresholds.churnMinPatches,
+				readable: false
+			});
+			rows.push({
 				name: summary.name,
-				verdict: assessment.verdict,
-				reasons: assessment.reasons
+				verdict: "warn",
+				dims: {
+					bodyChars: null,
+					bodyTokens: null,
+					stampDensityPerKb: null,
+					supportGroups: 0,
+					supportFiles: null,
+					churnPatches: null,
+					churnReads: null
+				},
+				findings
 			});
 		}
 		return rows;
@@ -1262,7 +1318,7 @@ var EvolutionCurator = class extends Service {
 		const blocked = [...new Set([target, ...sources])].filter((name) => gates.isBlocked(name));
 		if (blocked.length > 0) return {
 			ok: false,
-			message: `Skill(s) protected from consolidation (excluded / referenced / suppressed / protected builtin): ${blocked.join(", ")}`
+			message: `以下技能受保护、无法合并（被排除／被引用／被抑制／受保护的内置）：${blocked.join(", ")}`
 		};
 		await this.snapshotFull("pre-consolidate");
 		const result = await this.skills.consolidate(target, sources);
@@ -1360,46 +1416,46 @@ var EvolutionCurator = class extends Service {
 		const versions = await this.skills.listVersions(name);
 		if (versions.length === 0) return {
 			ok: false,
-			message: `No content versions are recorded for "${name}" yet — nothing to undo.`
+			message: `技能「${name}」还没有记录内容版本 —— 没有可撤销的。`
 		};
 		const live = await this.skills.read(name);
 		if (live === null) return {
 			ok: false,
-			message: `"${name}" is not in the active tree — undo restores CONTENT of a live skill; use '/evolution skill restore ${name}' for an archived one.`
+			message: `「${name}」不在活动目录树里 —— 撤销恢复的是存活技能的正文；若它已归档，请用 '/evolution skill restore ${name}'。`
 		};
 		const liveHash = contentHash(live);
 		const target = v ?? this.previousVersionOf(versions, liveHash);
 		if (target === void 0) return {
 			ok: false,
-			message: `"${name}" is already at its recorded content — no earlier version to undo to.`
+			message: `「${name}」已处于其记录的内容 —— 没有更早的版本可撤销。`
 		};
 		if (!versions.some((candidate) => candidate.v === target)) {
 			const listed = versions.map((candidate) => `v${candidate.v}`).join(", ");
 			return {
 				ok: false,
-				message: `Version v${target} of "${name}" is not in the recorded history (recorded: ${listed === "" ? "none" : listed}).`
+				message: `技能「${name}」的版本 v${target} 不在已记录的历史里（已记录：${listed === "" ? "无" : listed}）。`
 			};
 		}
 		const entry = versions.find((candidate) => candidate.v === target);
 		if (entry !== void 0 && entryTarget(entry, versions) === "support") return {
 			ok: false,
-			message: `Version v${target} of "${name}" ${entry.path === void 0 ? `was written by '${entry.action}' and` : `was written by '${entry.action}' to '${entry.path}' and`} holds a SUPPORT FILE's bytes, not this skill's SKILL.md — undo restores the body only. The recorded bytes stay in the history store; copy the blob back over that file to restore them.`
+			message: `技能「${name}」的版本 v${target} ${entry.path === void 0 ? `由 ${entry.action} 写入，并且` : `由 ${entry.action} 写入到 ${entry.path}，并且`} 存的是支撑文件的字节，而不是该技能的 SKILL.md —— 撤销只会恢复正文。 已记录的字节仍留在历史存储里；要恢复它们，请把该 blob 复制回那个文件。`
 		};
 		const content = await this.skills.readVersion(name, target);
 		if (content === null) return {
 			ok: false,
-			message: `Version v${target} of "${name}" is listed in the index but its stored content could not be read — refusing rather than writing a guess.`
+			message: `技能「${name}」的版本 v${target} 虽在索引里，但它的存储内容读不出来 —— 拒绝瞎猜、不做写入。`
 		};
 		const anchor = { sha256: liveHash };
 		const result = await this.skills.update(name, content, "foreground", anchor);
 		if (!result.ok) return result;
 		if (result.noop === true) return {
 			ok: true,
-			message: `"${name}" already holds the content of v${target} — nothing was written and no new version was recorded.`
+			message: `「${name}」已持有 v${target} 的内容 —— 未写入任何内容，也没有记录新版本。`
 		};
 		return {
 			ok: true,
-			message: `${result.message} (undone to v${target} — content only: markers, usage counts and curation state are unchanged, and this undo is itself a new version.)`
+			message: `${result.message} （已撤销到 v${target} —— 仅内容：标记、使用计数与策展状态不变，且这次撤销本身就是一个新版本。）`
 		};
 	}
 	/** The content the live bytes replaced: the CHAIN first, the recorded order as the fallback.
@@ -1426,4 +1482,4 @@ var EvolutionCurator = class extends Service {
 	}
 };
 //#endregion
-export { EvolutionCurator, EvolutionCurator as default, gateConsolidations, validateCuratorSettings };
+export { EvolutionCurator, EvolutionCurator as default, gateConsolidations, referencedSkillNames, validateCuratorSettings };

package/lib/types/index.d.ts

@@ -148,6 +148,16 @@ export declare function gateConsolidations(consolidations: CuratorConsolidation[
     referenced?: ReadonlySet<string>;
     suppressed?: ReadonlySet<string>;
 }): CuratorConsolidation[];
+/**
+ * G5 (in-use protection): which skills are POINTED AT by others, and by whom.
+ *
+ * Pure: derived from the bodies already in hand, using `relatedSkillNames` — the single reader of
+ * that frontmatter field — so this map can never disagree with the catalog or the audit. The value
+ * is a Set of SOURCES, not a boolean, because a refusal has to be able to name the referrers.
+ * @param contents - skill name to its whole SKILL.md text.
+ * @returns target name to the set of skills naming it; targets nobody names are absent.
+ */
+export declare function referencedSkillNames(contents: ReadonlyMap<string, string>): Map<string, Set<string>>;
 export declare class EvolutionCurator extends Service {
     static inject: string[];
     static Config: z<Schemastery.ObjectS<NoInfer<{
@@ -495,7 +505,21 @@ export declare class EvolutionCurator extends Service {
     healthView(): Promise<Array<{
         name: string;
         verdict: SkillHealthVerdict;
-        reasons: string[];
+        dims: {
+            bodyChars: number | null;
+            bodyTokens: number | null;
+            stampDensityPerKb: number | null;
+            supportGroups: number;
+            supportFiles: number | null;
+            churnPatches: number | null;
+            churnReads: number | null;
+        };
+        findings: Array<{
+            severity: 'warn' | 'error';
+            rule: string;
+            message: string;
+            count: number;
+        }>;
     }>>;
     /** Whether the library has ANY observed read evidence (C observation-window gate for churn signals). */
     usageObserved(): Promise<boolean>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-curator",
   "description": "Deterministic skill lifecycle and recovery (community build)",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,20 +27,20 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.4",
-    "@lmzhen/dsh-evolution-core": "^0.23.0"
+    "@lmzhen/dsh-evolution-core": "^0.25.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-llm": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-session": "^0.2.0-rc.1",
-    "@lmzhen/dsh-evolution-io": "^0.23.0",
-    "@lmzhen/dsh-evolution-state": "^0.23.0"
+    "@lmzhen/dsh-evolution-io": "^0.25.0",
+    "@lmzhen/dsh-evolution-state": "^0.25.0"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-llm": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-session": "^0.2.0-rc.1",
-    "@lmzhen/dsh-evolution-core": "^0.23.0",
-    "@lmzhen/dsh-evolution-io": "^0.23.0",
-    "@lmzhen/dsh-evolution-state": "^0.23.0"
+    "@lmzhen/dsh-evolution-core": "^0.25.0",
+    "@lmzhen/dsh-evolution-io": "^0.25.0",
+    "@lmzhen/dsh-evolution-state": "^0.25.0"
   }
 }