@lmzhen/dsh-evolution-maintenance 0.3.7 → 0.3.9

package/lib/{probe-CrVeRJ6b.js → enrichment-DxCdaJaQ.js}

@@ -1,4 +1,35 @@
-import { HEALTH_STAMP_RE, computeDedupGroups, computePrefixClusters, duplicateHeadings, missingSupportPointers, narrowNameMatches, overlongLines } from "@lmzhen/dsh-evolution-core";
+import { HEALTH_STAMP_RE, computeDedupGroups, computePrefixClusters, duplicateHeadings, missingSupportPointers, narrowNameMatches, overlongLines, parseFrontmatter, usageObserved } from "@lmzhen/dsh-evolution-core";
+//#region lib/types/drift-scan.js
+/**
+* Skill-library snapshot assembly for drift scanning.
+*
+* `computeDriftSignals` (evolution-core) is a pure function over a plain
+* snapshot; this module converts a SkillLibrary-like reader into that
+* snapshot. Quality score and usage-window status are caller-provided —
+* when absent they stay `undefined`, which the signal layer reports as
+* `unknown` (never a fabricated verdict).
+*/
+/**
+* Assemble drift snapshots from a library reader and optional enrichment.
+* Missing enrichment stays `undefined` → signal layer reports `unknown`.
+*/
+async function snapshotFromLibrary(library, options = {}) {
+	const entries = await library.list();
+	const snapshots = [];
+	for (const entry of entries) {
+		const body = await library.read(entry.name);
+		if (body === void 0 || body === null) continue;
+		snapshots.push({
+			name: entry.name,
+			body,
+			description: options.descriptions?.get(entry.name),
+			supportFiles: options.supportFiles?.get(entry.name),
+			quality: options.quality?.get(entry.name)
+		});
+	}
+	return snapshots;
+}
+//#endregion
 //#region lib/types/probe.js
 /**
 * Probe detail computation (011 Phase 3).
@@ -68,4 +99,38 @@ function computeProbe(signal, target, snapshots) {
 	}
 }
 //#endregion
-export { computeProbe as n, PROBE_SIGNALS as t };
+//#region lib/types/enrichment.js
+/**
+* Enrichment maps shared by the full maintain scan and the `--facts` preview
+* (v12) AND the maintenance_probe tool (0.3.9): one construction = the probe
+* and the facts block can never disagree about descriptions, support files,
+* or quality (the 0.3.8 review found the probe answering "description=missing"
+* while the facts block measured real lengths — probe snapshots carried no
+* enrichment at all).
+*/
+async function buildEnrichment(ctx, library) {
+	const skillUsage = ctx.get("skillUsage");
+	const usageMap = skillUsage?.report ? await skillUsage.report() : void 0;
+	const usageObservedValue = usageMap ? usageObserved(usageMap) : void 0;
+	const descriptions = /* @__PURE__ */ new Map();
+	const supportFiles = /* @__PURE__ */ new Map();
+	const quality = /* @__PURE__ */ new Map();
+	for (const entry of await library.list()) {
+		const body = await library.read(entry.name);
+		if (body === null) continue;
+		const description = parseFrontmatter(body)?.frontmatter.description;
+		if (typeof description === "string" && description.trim().length > 0) descriptions.set(entry.name, description);
+		const files = await library.listSupportFiles(entry.name);
+		if (files.length > 0) supportFiles.set(entry.name, files);
+		const record = usageMap?.get(entry.name);
+		if (typeof record?.quality_score === "number") quality.set(entry.name, record.quality_score);
+	}
+	return {
+		descriptions,
+		supportFiles,
+		quality,
+		usageObservedValue
+	};
+}
+//#endregion
+export { snapshotFromLibrary as i, PROBE_SIGNALS as n, computeProbe as r, buildEnrichment as t };

package/lib/index.js

@@ -1,37 +1,6 @@
-import { n as computeProbe, t as PROBE_SIGNALS } from "./probe-CrVeRJ6b.js";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-DxCdaJaQ.js";
 import { AUTHORING_DESCRIPTION_BAR, DEFAULT_HEALTH_THRESHOLDS, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, LOW_QUALITY_THRESHOLD, MAINTAIN_PROMPT, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, computeDriftSignals, findDriftSignal, redactSecrets, verifyPromptBundle } from "@lmzhen/dsh-evolution-core";
 import { createHash, randomUUID } from "node:crypto";
-//#region lib/types/drift-scan.js
-/**
-* Skill-library snapshot assembly for drift scanning.
-*
-* `computeDriftSignals` (evolution-core) is a pure function over a plain
-* snapshot; this module converts a SkillLibrary-like reader into that
-* snapshot. Quality score and usage-window status are caller-provided —
-* when absent they stay `undefined`, which the signal layer reports as
-* `unknown` (never a fabricated verdict).
-*/
-/**
-* Assemble drift snapshots from a library reader and optional enrichment.
-* Missing enrichment stays `undefined` → signal layer reports `unknown`.
-*/
-async function snapshotFromLibrary(library, options = {}) {
-	const entries = await library.list();
-	const snapshots = [];
-	for (const entry of entries) {
-		const body = await library.read(entry.name);
-		if (body === void 0 || body === null) continue;
-		snapshots.push({
-			name: entry.name,
-			body,
-			description: options.descriptions?.get(entry.name),
-			supportFiles: options.supportFiles?.get(entry.name),
-			quality: options.quality?.get(entry.name)
-		});
-	}
-	return snapshots;
-}
-//#endregion
 //#region lib/types/render-facts.js
 /**
 * Mechanical-facts rendering for the maintenance subagent (011 §6).
@@ -363,7 +332,7 @@ async function runMaintain(runtime, options = {}) {
 		const timeoutMs = options.timeoutMs ?? 12e4;
 		const agentOptions = { model: options.model ?? "deepseek-v4-pro" };
 		if (options.provider) agentOptions.provider = options.provider;
-		const raw = (await (await runtime.subagents.start("spawn", {
+		const runResult = await (await runtime.subagents.start("spawn", {
 			label: "dsh-evolution-maintain",
 			prompt: [{
 				type: "text",
@@ -423,11 +392,18 @@ async function runMaintain(runtime, options = {}) {
 					}
 				}
 			}
-		})).result)?.structured;
-		if (raw === void 0) return {
-			ok: false,
-			error: "Maintain subagent returned no structured plan."
-		};
+		})).result;
+		const raw = runResult?.structured;
+		if (raw === void 0) {
+			if (runResult?.stopReason === "aborted") return {
+				ok: false,
+				error: "Maintenance scan was aborted (the run was cancelled before the subagent produced a plan) — retry when the session is idle; concurrent re-submission cancels the previous scan."
+			};
+			return {
+				ok: false,
+				error: "Maintain subagent returned no structured plan (the model did not emit the structured plan, or the run ended without one) — retry; if it repeats, raise --timeout or check the model output shape."
+			};
+		}
 		const validated = validateAndNormalizeMaintainPlan(raw, report, existingSignalIds(report));
 		if (!validated.ok) return {
 			ok: false,
@@ -446,9 +422,9 @@ async function runMaintain(runtime, options = {}) {
 		const message = error instanceof Error ? error.message : String(error);
 		return {
 			ok: false,
-			error: name === "AbortError" ? "Maintenance scan was aborted (subagent timeout or cancellation) before a plan was produced — retry, or raise the timeout (evolution-commands maintainTimeoutMs) on a slow/large library." : `Maintenance scan failed: ${message}`
+			error: name === "AbortError" || /abort/i.test(`${String(name)} ${message}`) ? "Maintenance scan was aborted (cancellation or timeout) before a plan was produced — retry, or raise the timeout (evolution-commands maintainTimeoutMs) on a slow/large library." : `Maintenance scan failed: ${message}`
 		};
 	}
 }
 //#endregion
-export { PROBE_SIGNALS, buildMaintainFacts, computeProbe, renderFacts, renderMaintainTemplate, runMaintain, snapshotFromLibrary, summarizeAssessment, validateAndNormalizeMaintainPlan };
+export { PROBE_SIGNALS, buildEnrichment, buildMaintainFacts, computeProbe, renderFacts, renderMaintainTemplate, runMaintain, snapshotFromLibrary, summarizeAssessment, validateAndNormalizeMaintainPlan };

package/lib/tools.js

@@ -1,4 +1,4 @@
-import { n as computeProbe, t as PROBE_SIGNALS } from "./probe-CrVeRJ6b.js";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-DxCdaJaQ.js";
 import { SkillLibrary, redactSecrets } from "@lmzhen/dsh-evolution-core";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region lib/types/tools.js
@@ -59,17 +59,12 @@ function apply(ctx, rawConfig = {}) {
 					...target ? { target } : {}
 				};
 				const library = new SkillLibrary(config.skillsRoot, ioRegistry.provider());
-				const entries = await library.list();
-				const snapshots = [];
-				for (const entry of entries) {
-					const body = await library.read(entry.name);
-					if (body === null) continue;
-					snapshots.push({
-						name: entry.name,
-						body
-					});
-				}
-				const probe = computeProbe(signal, target, snapshots);
+				const enrichment = await buildEnrichment(ctx, library);
+				const probe = computeProbe(signal, target, await snapshotFromLibrary(library, {
+					descriptions: enrichment.descriptions,
+					supportFiles: enrichment.supportFiles,
+					quality: enrichment.quality
+				}));
 				const redacted = redactSecrets(probe.detail.join("\n"));
 				return {
 					...probe,

package/lib/types/enrichment.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Enrichment maps shared by the full maintain scan and the `--facts` preview
+ * (v12) AND the maintenance_probe tool (0.3.9): one construction = the probe
+ * and the facts block can never disagree about descriptions, support files,
+ * or quality (the 0.3.8 review found the probe answering "description=missing"
+ * while the facts block measured real lengths — probe snapshots carried no
+ * enrichment at all).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type SkillLibrary } from '@deepseek-ai/dsh-evolution-core';
+export interface Enrichment {
+    descriptions: ReadonlyMap<string, string>;
+    supportFiles: ReadonlyMap<string, readonly string[]>;
+    quality: ReadonlyMap<string, number>;
+    usageObservedValue: boolean | undefined;
+}
+export declare function buildEnrichment(ctx: Context, library: SkillLibrary): Promise<Enrichment>;
+//# sourceMappingURL=enrichment.d.ts.map

package/lib/types/index.d.ts

@@ -14,4 +14,5 @@ export * from './render-facts.ts';
 export * from './validate-plan.ts';
 export * from './orchestrate.ts';
 export * from './probe.ts';
+export * from './enrichment.ts';
 //# sourceMappingURL=index.d.ts.map

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.7",
+  "version": "0.3.9",
   "publishConfig": {
     "access": "public"
   },
@@ -34,7 +34,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@lmzhen/dsh-evolution-core": "^0.3.7"
+    "@lmzhen/dsh-evolution-core": "^0.3.9"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",