@lmzhen/dsh-evolution-curator 0.22.0 → 0.24.0

package/lib/index.js

@@ -3,7 +3,8 @@ 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_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 { 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";
 //#region lib/types/index.js
 /**
 * Deterministic skill lifecycle curator with interval gate and archive.
@@ -11,12 +12,6 @@ import { CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEF
 */
 /** Quality-warned skills may turn stale after this many idle days (package-private tunable, P2-8). */
 const DEFAULT_QUALITY_WARN_STALE_AFTER_DAYS = 7;
-/** B-10 (v18): the optional LLM nomination pass gets its own timeout so a
-* hung/unresponsive provider cannot hold the control-plane mutex forever
-* (`run()` never returns; `restore()`/`consolidate()` queue behind it).
-* 120s matches the review subagent default; the 32-bit ceiling is Node's
-* timer-delay limit (`AbortSignal.timeout` throws above it). */
-const DEFAULT_CURATOR_REVIEW_TIMEOUT_MS = 12e4;
 /**
 * The cross-field rule the schema cannot express (A2-17): an archive threshold
 * below the stale threshold makes the engine reactivate stale records instead of
@@ -59,7 +54,7 @@ var EvolutionCurator = class extends Service {
 		autoStart: z.boolean().default(true),
 		bootGraceSeconds: z.number().min(0).default(DEFAULT_CURATOR_BOOT_GRACE_SECONDS),
 		curatorReviewMaxTokens: z.number().min(1).default(DEFAULT_CURATOR_REVIEW_MAX_TOKENS).volatile(),
-		curatorReviewTimeoutMs: z.number().min(1).max(MAX_TIMER_DELAY_MS).default(DEFAULT_CURATOR_REVIEW_TIMEOUT_MS).volatile(),
+		curatorReviewTimeoutMs: z.number().min(1).max(MAX_TIMER_DELAY_MS).default(DEFAULT_REVIEW_TIMEOUT_MS).volatile(),
 		healthSoftBodyChars: z.number().min(1).default(DEFAULT_HEALTH_THRESHOLDS.softBodyChars).volatile(),
 		healthStampDensityPerKb: z.number().min(1).default(DEFAULT_HEALTH_THRESHOLDS.stampDensityPerKb).volatile(),
 		healthChurnMinPatches: z.number().min(1).default(DEFAULT_HEALTH_THRESHOLDS.churnMinPatches).volatile()
@@ -121,7 +116,7 @@ var EvolutionCurator = class extends Service {
 			if (typeof disposer === "function") ctx.effect(() => disposer, "evolution-curator: settings presentation");
 		});
 		if (!verifyPromptBundle(PROMPT_BUNDLE)) throw new Error("dsh-evolution prompt bundle integrity check failed; refusing to run the curator");
-		this.io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
+		this.io = evolutionIoAdapter(() => preferProvider(ctx.evolutionIo, ["fs"]));
 		this.skills = newSkillLibrary({
 			config,
 			io: this.io,
@@ -230,7 +225,7 @@ var EvolutionCurator = class extends Service {
 			minIdleFailOpen: this.rowBoolean("minIdleFailOpen", true),
 			llmReview: this.rowBoolean("llmReview", false),
 			curatorReviewMaxTokens: number("curatorReviewMaxTokens", DEFAULT_CURATOR_REVIEW_MAX_TOKENS, 1),
-			curatorReviewTimeoutMs: number("curatorReviewTimeoutMs", DEFAULT_CURATOR_REVIEW_TIMEOUT_MS, 1, MAX_TIMER_DELAY_MS),
+			curatorReviewTimeoutMs: number("curatorReviewTimeoutMs", DEFAULT_REVIEW_TIMEOUT_MS, 1, MAX_TIMER_DELAY_MS),
 			healthSoftBodyChars: number("healthSoftBodyChars", DEFAULT_HEALTH_THRESHOLDS.softBodyChars, 1),
 			healthStampDensityPerKb: number("healthStampDensityPerKb", DEFAULT_HEALTH_THRESHOLDS.stampDensityPerKb, 1),
 			healthChurnMinPatches: number("healthChurnMinPatches", DEFAULT_HEALTH_THRESHOLDS.churnMinPatches, 1)
@@ -614,7 +609,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 = {}) {
@@ -973,7 +968,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) {
@@ -995,7 +990,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)) {
@@ -1040,7 +1035,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 {
@@ -1267,7 +1262,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);
@@ -1365,46 +1360,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.

package/lib/types/index.d.ts

@@ -17,6 +17,11 @@ 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 { SkillVersion } from '@lmzhen/dsh-evolution-core';
 import type { CuratorStateRecord } from '@lmzhen/dsh-evolution-state';
+/** B-10 (v18): the optional LLM nomination pass gets its own timeout so a
+ * hung/unresponsive provider cannot hold the control-plane mutex forever
+ * (`run()` never returns; `restore()`/`consolidate()` queue behind it).
+ * 120s matches the review subagent default; the 32-bit ceiling is Node's
+ * timer-delay limit (`AbortSignal.timeout` throws above it). */
 declare module '@deepseek-ai/cordis' {
     interface Context {
         evolutionCurator: EvolutionCurator;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-curator",
   "description": "Deterministic skill lifecycle and recovery (community build)",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,20 +27,20 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.4",
-    "@lmzhen/dsh-evolution-core": "^0.22.0"
+    "@lmzhen/dsh-evolution-core": "^0.24.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.22.0",
-    "@lmzhen/dsh-evolution-state": "^0.22.0"
+    "@lmzhen/dsh-evolution-io": "^0.24.0",
+    "@lmzhen/dsh-evolution-state": "^0.24.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.22.0",
-    "@lmzhen/dsh-evolution-io": "^0.22.0",
-    "@lmzhen/dsh-evolution-state": "^0.22.0"
+    "@lmzhen/dsh-evolution-core": "^0.24.0",
+    "@lmzhen/dsh-evolution-io": "^0.24.0",
+    "@lmzhen/dsh-evolution-state": "^0.24.0"
   }
 }