@lmzhen/dsh-evolution-maintenance 0.3.62 → 0.3.64

package/lib/{enrichment-B7tEHkM5.js → enrichment-CYpvRfH_.js}

@@ -17,7 +17,13 @@ async function snapshotFromLibrary(library, options = {}) {
 	const entries = await library.list();
 	const snapshots = [];
 	for (const entry of entries) {
-		const body = await library.read(entry.name);
+		let body;
+		try {
+			body = await library.read(entry.name);
+		} catch (error) {
+			options.onReadError?.(entry.name, error);
+			continue;
+		}
 		if (body === void 0 || body === null) continue;
 		snapshots.push({
 			name: entry.name,
@@ -130,7 +136,8 @@ async function buildEnrichment(ctx, library) {
 	const protectedMap = /* @__PURE__ */ new Map();
 	const catalogInvalid = /* @__PURE__ */ new Map();
 	for (const entry of await library.list()) {
-		if (entry.protectedBy) protectedMap.set(entry.name, entry.protectedBy);
+		if (entry.protectionUnknown) protectedMap.set(entry.name, "unknown");
+		else if (entry.protectedBy) protectedMap.set(entry.name, entry.protectedBy);
 		const body = await library.read(entry.name);
 		if (body === void 0 || body === null) continue;
 		const parsed = parseFrontmatter(body);

package/lib/index.js

@@ -1,4 +1,4 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-B7tEHkM5.js";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-CYpvRfH_.js";
 import { AUTHORING_DESCRIPTION_BAR, DEFAULT_HEALTH_THRESHOLDS, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, LOW_QUALITY_THRESHOLD, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MIN_STAMP_BODY_CHARS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, computeDriftSignals, findDriftSignal, redactSecrets, verifyPromptBundle } from "@lmzhen/dsh-evolution-core";
 import { createHash, randomUUID } from "node:crypto";
 //#region lib/types/render-facts.js
@@ -27,14 +27,15 @@ function renderFacts(report, options) {
 }
 function renderSignal(signal, redact) {
 	const prefix = signal.verdict === "unknown" ? "[UNKNOWN]" : "[FACT]";
-	const value = redact(signal.value);
+	const sanitize = (text) => redact(text).replaceAll("<<<END FACTS>>>", "<<<END FACTS (escaped)>>>").replaceAll("\n", " ").replaceAll("\r", " ");
+	const value = sanitize(signal.value);
 	const parts = [
 		`${prefix} signal=${signal.id}`,
 		`value=${value}`,
 		`verdict=${signal.verdict}`
 	];
 	if (signal.threshold !== void 0) parts.push(`threshold=${signal.threshold}`);
-	if (signal.detail !== void 0) parts.push(`detail=${redact(signal.detail)}`);
+	if (signal.detail !== void 0) parts.push(`detail=${sanitize(signal.detail)}`);
 	return [parts.join(" ")];
 }
 //#endregion
@@ -384,7 +385,10 @@ async function runMaintain(runtime, options = {}) {
 			quality: options.quality ? options.quality() : void 0,
 			protected: options.protected ? options.protected() : void 0,
 			catalogInvalid: options.catalogInvalid ? options.catalogInvalid() : void 0,
-			usageObserved
+			usageObserved,
+			onReadError: (name, error) => {
+				runtime.logger?.warn(`evolution-maintenance: skipping unreadable skill "${name}": ${error instanceof Error ? error.message : String(error)}`);
+			}
 		});
 		if (snapshots.length === 0) return {
 			ok: true,
@@ -407,7 +411,7 @@ ${MAINTAIN_OUTPUT_INSTRUCTION}`;
 			recommendationCount: 0,
 			error: `maintain: --timeout must be a positive integer in ms, at most 4294967295; got ${String(timeoutMs)}`
 		};
-		const signal = AbortSignal.timeout(timeoutMs);
+		const signal = options.signal !== void 0 ? AbortSignal.any([AbortSignal.timeout(timeoutMs), options.signal]) : AbortSignal.timeout(timeoutMs);
 		abortSignal = signal;
 		const agentOptions = { model: options.model ?? runtime.evolutionPolicy?.get()?.curatorModel ?? "deepseek-v4-pro" };
 		if (options.provider) agentOptions.provider = options.provider;

package/lib/tools.js

@@ -1,5 +1,5 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-B7tEHkM5.js";
-import { SkillLibrary, redactSecrets, resolveSkillsRoot } from "@lmzhen/dsh-evolution-core";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-CYpvRfH_.js";
+import { SkillLibrary, redactSecrets, resolveRootConfig, resolveSkillsRoot } from "@lmzhen/dsh-evolution-core";
 import z from "@deepseek-ai/schemastery";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region lib/types/tools.js
@@ -14,9 +14,13 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 * @module @lmzhen/dsh-evolution-maintenance-tools
 */
 const name = "evolution-maintenance-tools";
-const Config = z.object({ skillsRoot: z.string().default("") });
+const Config = z.object({
+	root: z.string().default(""),
+	skillsRoot: z.string().default("")
+});
 function apply(ctx, rawConfig = {}) {
-	const config = rawConfig;
+	const rootConfig = resolveRootConfig(rawConfig);
+	if (rootConfig.usedDeprecatedAlias) ctx.logger.warn("evolution-maintenance-tools: config \"skillsRoot\" is deprecated (E-7); use \"root\" — the alias is honoured until 0.3.65");
 	ctx.inject(["tools"], (toolCtx) => {
 		const tools = toolCtx.get("tools");
 		toolCtx.effect(() => tools.register(defineTool({
@@ -61,7 +65,7 @@ function apply(ctx, rawConfig = {}) {
 					detail: ["evolution-io registry not mounted"],
 					...target ? { target } : {}
 				};
-				const library = new SkillLibrary(resolveSkillsRoot({ root: config.skillsRoot }), ioRegistry.provider());
+				const library = new SkillLibrary(resolveSkillsRoot({ root: rootConfig.root }), ioRegistry.provider());
 				const enrichment = await buildEnrichment(ctx, library);
 				const probe = computeProbe(signal, target, await snapshotFromLibrary(library, {
 					descriptions: enrichment.descriptions,

package/lib/types/drift-scan.d.ts

@@ -16,6 +16,9 @@ export interface SkillLibraryLike {
     read(name: string): Promise<string | null | undefined>;
 }
 export interface SnapshotOptions {
+    /** E-9 (v18): called when one skill's body cannot be read; the scan skips
+     * that skill instead of aborting the whole run. */
+    onReadError?: ((name: string, error: unknown) => void) | undefined;
     /** Support-file relative paths per skill name, when the caller has them. */
     supportFiles?: ReadonlyMap<string, readonly string[]> | undefined;
     /** Parsed frontmatter description per skill name, when available. */

package/lib/types/orchestrate.d.ts

@@ -44,6 +44,8 @@ export interface MaintainRuntime {
 }
 export interface MaintainOptions {
     timeoutMs?: number;
+    /** E-6 (v18): external cancel signal (session/UI); combined with timeoutMs. */
+    signal?: AbortSignal | undefined;
     maxDepth?: number;
     model?: string;
     provider?: string;

package/lib/types/tools.d.ts

@@ -12,13 +12,18 @@ import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 export declare const name = "evolution-maintenance-tools";
 export interface Config {
-    /** Skill-tree root for probe reads; empty uses skillsRoot(). Align with
-     * tool-skill-manage/skill-usage/evolution-skill-catalog/commands rows (A7). */
+    /** Skill-tree root for probe reads; empty uses the default tree. E-7 (v18):
+     * canonical key — the same `root` every other family row reads. */
+    root?: string | undefined;
+    /** Deprecated alias of `root` (E-7, v18); honoured only while `root` is
+     * empty, with a warning; removed after 0.3.65. */
     skillsRoot?: string | undefined;
 }
 export declare const Config: z<Schemastery.ObjectS<{
+    root: z<string, string>;
     skillsRoot: z<string, string>;
 }>, Schemastery.ObjectT<{
+    root: z<string, string>;
     skillsRoot: z<string, string>;
 }>>;
 export declare function apply(ctx: Context, rawConfig?: Config): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-maintenance",
   "description": "Deterministic maintenance-scan surface: skill-library snapshot assembly, drift signals and mechanical-facts rendering (design 011) (community build)",
-  "version": "0.3.62",
+  "version": "0.3.64",
   "publishConfig": {
     "access": "public"
   },
@@ -35,7 +35,7 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.62"
+    "@lmzhen/dsh-evolution-core": "^0.3.64"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",