@lmzhen/dsh-evolution-curator 0.32.5 → 0.33.0

package/README.md

@@ -1,23 +1,17 @@
 # @lmzhen/dsh-evolution-curator
 
-> 自动整理技能库：标 stale、归档、合并近重复。
+Skill lifecycle service for stale detection, archiving, optional LLM nomination, snapshots, history, restore, and unit undo.
 
-## 你会看到
+Use `/evolution curator status`, `report`, or `run` for inspection and manual operation. Archive/restore/history/undo commands operate on the corresponding stored records; deleting a skill through curation means archiving, not hard deletion.
 
-`/evolution curator status/report/run`；归档/恢复/历史/撤销。
+## Defaults and scheduling
 
-## 什么时候会用到
+The plugin and `autoStart` default to enabled. An hourly timer checks due-ness; `curatorIntervalHours` defaults to 168 hours. Pause/resume overrides the startup schedule until that persisted override is cleared.
 
-技能变多、长期不用、出现重复时。
+`staleAfterDays` defaults to 30 and `archiveAfterDays` to 90, with archive required to be at least the stale threshold. The optional `llmReview` pass defaults off. Idle activity gates, protected/referenced names, unmanaged/builtin scope, health thresholds, and model limits are listed in [PARAMETERS.md](../PARAMETERS.md).
 
-## 默认 / 前提
+`root` must point at the same skill tree used by the catalog and write tools. `intervalHours` remains a readable deprecated alias of `curatorIntervalHours`; writes to the old name are refused (G0/S0.3).
 
-默认定期跑；可暂停。
+## Failure boundary
 
-## 边界
-
-先快照，删除是归档；不会硬删。
-
-## 维护者参考：参数别名（G0/S0.3）
-
-`intervalHours` → `curatorIntervalHours`。旧名仍可读，写入会拒绝。
+A mutating pass takes snapshots and supports explicit restore/undo. That is not a promise that every failed run automatically rolls back the whole tree; inspect the run report and use the explicit recovery operation when needed. Notifications may be incomplete, so an archived skill can disappear from the catalog without a conversation notice.

package/lib/index.js

@@ -1,5 +1,5 @@
+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, EXTRACT_PROMPT_HASH, EvolutionGateSet, INSTANCE_KEYS, MAX_TIMER_DELAY_MS, PROMPT_BUNDLE, SKILL_NAME_RE, acquireTreeWriteLock, authorityFrom, blobPath, buildCuratorRunReport, claimInstance, clampOnce, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, emptyRecord, entryTarget, eventsFile, evolutionHome, evolutionIoAdapter, executeUnitUndo, foldCuratorFields, historyIndexFile, isPresent, isUnknown, lintSkill, liveBool, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, newSkillLibrary, paramRowId, parseCuratorNominations, parseFrontmatter, parseHistoryIndex, pickWithPolicy, planUnitUndoAcross, policyStageLimits, probeList, probeText, readEvolutionEvents, readNumberParam, registerOwnerSettings, relatedSkillNames, releaseInstance, renderCuratorReportMarkdown, reportTime, reportsSweepLockTarget, resolveUnitMembers, sessionLastEventTime, staleRouteStubs, sweepReports, transactIo, unitMembersAreComplete, unwrapLive, updateSuppressedNames, usageObserved, userSetKeys, verifyPromptBundle, withTreeWrite, writeProposalReport } from "@lmzhen/dsh-evolution-core";
 import { Service } from "@deepseek-ai/cordis";
-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, EXTRACT_PROMPT_HASH, EvolutionGateSet, INSTANCE_KEYS, MAX_TIMER_DELAY_MS, PROMPT_BUNDLE, SKILL_NAME_RE, acquireTreeWriteLock, authorityFrom, blobPath, buildCuratorRunReport, claimInstance, clampOnce, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, emptyRecord, entryTarget, eventsFile, evolutionHome, evolutionIoAdapter, executeUnitUndo, foldCuratorFields, historyIndexFile, isPresent, isUnknown, lintSkill, liveBool, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, newSkillLibrary, paramRowId, parseCuratorNominations, parseFrontmatter, parseHistoryIndex, pickWithPolicy, planUnitUndoAcross, policyStageLimits, probeList, probeText, readEvolutionEvents, readNumberParam, relatedSkillNames, releaseInstance, renderCuratorReportMarkdown, reportTime, reportsSweepLockTarget, resolveUnitMembers, sessionLastEventTime, staleRouteStubs, sweepReports, transactIo, unitMembersAreComplete, unwrapLive, updateSuppressedNames, usageObserved, userSetKeys, verifyPromptBundle, withTreeWrite, writeProposalReport } from "@lmzhen/dsh-evolution-core";
 import { randomUUID } from "node:crypto";
 import { dirname, join } from "node:path";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
@@ -88,7 +88,7 @@ function referencedSkillNames(contents) {
 	}
 	return referencedBy;
 }
-var EvolutionCurator = class extends Service {
+var EvolutionCurator = class EvolutionCurator extends Service {
 	static inject = ["evolutionIo"];
 	static Config = z.object({
 		root: z.string().default(""),
@@ -172,6 +172,7 @@ var EvolutionCurator = class extends Service {
 	instanceOwner = `evolution-curator[${process.pid}:${randomUUID().slice(0, 8)}]`;
 	constructor(ctx, config = {}) {
 		super(ctx, "evolutionCurator");
+		registerOwnerSettings(this.ctx, "evolution-curator", EvolutionCurator.Config);
 		ctx.inject(["settings"], (injected) => {
 			const settings = injected.settings;
 			if (typeof settings?.configure !== "function") return;
@@ -1350,7 +1351,16 @@ var EvolutionCurator = class extends Service {
 		const usage = await loadUsage(this.skills.root, this.io);
 		const observed = usageObserved(usage);
 		const rows = [];
-		for (const summary of await this.skills.model.list()) {
+		let summaries;
+		try {
+			summaries = await this.skills.model.list();
+		} catch {
+			summaries = (await this.skills.treeNames()).map((name) => ({
+				name,
+				protectedBy: null
+			}));
+		}
+		for (const summary of summaries) {
 			const record = usage.get(summary.name);
 			const assessment = await this.skills.assessHealth(summary.name, thresholds, observed && record ? {
 				patchCount: record.patch_count,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-curator",
   "description": "Deterministic skill lifecycle and recovery (community build)",
-  "version": "0.32.5",
+  "version": "0.33.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,21 +27,21 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-core": "^0.32.5"
+    "@lmzhen/dsh-evolution-core": "^0.33.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-session": "^0.2.1-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.32.5",
-    "@lmzhen/dsh-evolution-state": "^0.32.5"
+    "@lmzhen/dsh-evolution-io": "^0.33.0",
+    "@lmzhen/dsh-evolution-state": "^0.33.0"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-session": "^0.2.1-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.32.5",
-    "@lmzhen/dsh-evolution-io": "^0.32.5",
-    "@lmzhen/dsh-evolution-state": "^0.32.5"
+    "@lmzhen/dsh-evolution-core": "^0.33.0",
+    "@lmzhen/dsh-evolution-io": "^0.33.0",
+    "@lmzhen/dsh-evolution-state": "^0.33.0"
   },
   "engines": {
     "dsh": ">=0.2.1-rc.2 <0.2.2-0"