@lmzhen/dsh-evolution-maintenance 0.3.17 → 0.3.18

package/lib/{enrichment-ePcRn3GX.js → enrichment-Di8Y4kev.js}

@@ -1,4 +1,4 @@
-import { HEALTH_STAMP_RE, computeDedupGroups, computePrefixClusters, duplicateHeadings, frontmatterYamlUnsafeValues, missingSupportPointers, narrowNameMatches, overlongLines, parseFrontmatter, usageObserved } from "@lmzhen/dsh-evolution-core";
+import { HEALTH_STAMP_RE, MIN_STAMP_BODY_CHARS, computeDedupGroups, computePrefixClusters, duplicateHeadings, frontmatterYamlUnsafeValues, missingSupportPointers, narrowNameMatches, overlongLines, parseFrontmatter, usageObserved } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/drift-scan.js
 /**
 * Skill-library snapshot assembly for drift scanning.
@@ -26,7 +26,8 @@ async function snapshotFromLibrary(library, options = {}) {
 			supportFiles: options.supportFiles?.get(entry.name),
 			quality: options.quality?.get(entry.name),
 			...options.protected?.get(entry.name) !== void 0 ? { protected: options.protected.get(entry.name) } : {},
-			...options.catalogInvalid?.get(entry.name) === true ? { catalogInvalid: true } : {}
+			...options.catalogInvalid?.get(entry.name) === true ? { catalogInvalid: true } : {},
+			...options.usageObserved !== void 0 ? { usageObserved: options.usageObserved } : {}
 		});
 	}
 	return snapshots;
@@ -76,13 +77,17 @@ function computeProbe(signal, target, snapshots) {
 	if (!PROBE_SIGNALS.includes(signal)) return result(signal, [`unknown-signal '${signal}' (allowed: ${PROBE_SIGNALS.join(", ")})`], target);
 	if (signal === "dedup_group") return result(signal, computeDedupGroups({ contents: new Map(snapshots.map((snapshot) => [snapshot.name, snapshot.body])) }).map((group) => group.join(" ~ ")));
 	if (signal === "prefix_cluster") return result(signal, computePrefixClusters(snapshots.map((snapshot) => snapshot.name)).map((cluster) => `${cluster.key}: ${cluster.members.join(", ")}`));
-	if (signal === "usage_observed") return result(signal, [`usage_observed=${snapshots.every((snapshot) => snapshot.usageObserved === true) ? "observed" : "unknown"}`]);
+	if (signal === "usage_observed") {
+		if (!(snapshots.length > 0 && snapshots.every((snapshot) => snapshot.usageObserved !== null && snapshot.usageObserved !== void 0))) return result(signal, ["usage_observed=unknown"]);
+		return result(signal, [`usage_observed=${snapshots.every((snapshot) => snapshot.usageObserved === true) ? "observed" : "unobserved"}`]);
+	}
 	if (!target) return result(signal, ["skill-level signal requires a target skill name"]);
 	const snapshot = findSnapshot(snapshots, target);
 	if (!snapshot) return result(signal, [`skill '${target}' not found in snapshot`], target);
 	const body = snapshot.body;
 	switch (signal) {
 		case "stamp_density": {
+			if (body.length < MIN_STAMP_BODY_CHARS) return result(signal, ["stamp_density=below-min-body", `body=${body.length} chars below MIN_STAMP_BODY_CHARS=${MIN_STAMP_BODY_CHARS}`], target);
 			const kb = Math.max(1, body.length / 1024);
 			const stamps = body.match(HEALTH_STAMP_RE) ?? [];
 			return result(signal, [`stamp_density=${(stamps.length / kb).toFixed(2)}/KB (${stamps.length} stamps / ${Math.round(kb)}KB)`, ...stamps.slice(0, 10).map((stamp) => `stamp: ${stamp}`)], target);

package/lib/index.js

@@ -1,5 +1,5 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-ePcRn3GX.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 { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-Di8Y4kev.js";
+import { AUTHORING_DESCRIPTION_BAR, DEFAULT_HEALTH_THRESHOLDS, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, LOW_QUALITY_THRESHOLD, 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
 /**
@@ -148,7 +148,9 @@ function validateAndNormalizeMaintainPlan(raw, report, validSignals) {
 			if (typeof item.impact !== "string" || !IMPACTS.has(item.impact)) errors.push(`${path}.impact: invalid`);
 			if (!isNonEmptyString(item.impact_reason)) errors.push(`${path}.impact_reason: required`);
 			if (typeof item.reversibility !== "string" || !REVERSIBILITIES.has(item.reversibility)) errors.push(`${path}.reversibility: invalid`);
-			if (!isNonEmptyString(item.undo_path)) if (item.reversibility === "none") item.undo_path = "n/a";
+			let normalizedUndoPath;
+			if (isNonEmptyString(item.undo_path)) normalizedUndoPath = item.undo_path;
+			else if (item.reversibility === "none") normalizedUndoPath = "n/a";
 			else {
 				const rev = typeof item.reversibility === "string" ? item.reversibility : "missing";
 				errors.push(`${path}.undo_path: required (reversibility=${rev})`);
@@ -169,7 +171,7 @@ function validateAndNormalizeMaintainPlan(raw, report, validSignals) {
 				impact: isNonEmptyString(item.impact) ? item.impact : "neutral",
 				impact_reason: str(item.impact_reason, ""),
 				reversibility: isNonEmptyString(item.reversibility) ? item.reversibility : "none",
-				undo_path: str(item.undo_path, ""),
+				undo_path: normalizedUndoPath ?? str(item.undo_path, ""),
 				confidence: typeof item.confidence === "number" ? item.confidence : 0,
 				needs_human: item.needs_human === true,
 				is_override: item.is_override === true,
@@ -253,7 +255,7 @@ function jointSignature(template, signalsVersion) {
 		nouns: DRIFT_SIGNAL_NOUNS,
 		thresholds: {
 			stampDensityPerKb: DEFAULT_HEALTH_THRESHOLDS.stampDensityPerKb,
-			minStampBodyChars: 2e3,
+			minStampBodyChars: MIN_STAMP_BODY_CHARS,
 			softBodyChars: DEFAULT_HEALTH_THRESHOLDS.softBodyChars,
 			descriptionChars: AUTHORING_DESCRIPTION_BAR,
 			qualityLow: LOW_QUALITY_THRESHOLD,
@@ -321,12 +323,14 @@ async function runMaintain(runtime, options = {}) {
 			ok: false,
 			error: "dsh-evolution prompt bundle integrity check failed; refusing to run maintain"
 		};
+		const usageObserved = options.usageObserved ? options.usageObserved() : void 0;
 		const snapshots = await snapshotFromLibrary(runtime.library, {
 			supportFiles: options.supportFiles ? options.supportFiles() : void 0,
 			descriptions: options.descriptions ? options.descriptions() : void 0,
 			quality: options.quality ? options.quality() : void 0,
 			protected: options.protected ? options.protected() : void 0,
-			catalogInvalid: options.catalogInvalid ? options.catalogInvalid() : void 0
+			catalogInvalid: options.catalogInvalid ? options.catalogInvalid() : void 0,
+			usageObserved
 		});
 		if (snapshots.length === 0) return {
 			ok: true,
@@ -334,7 +338,7 @@ async function runMaintain(runtime, options = {}) {
 			verdict: "no_issues",
 			text: "Maintenance scan: empty skill library. Nothing to do."
 		};
-		const { facts, report, signalsVersion, signature } = buildMaintainFacts(snapshots, options.usageObserved ? options.usageObserved() : void 0, options.redact);
+		const { facts, report, signalsVersion, signature } = buildMaintainFacts(snapshots, usageObserved, options.redact);
 		const template = renderMaintainTemplate(MAINTAIN_PROMPT, PROMPT_BUNDLE_ID, signalsVersion, signature);
 		const prompt = `${facts}
 
@@ -342,7 +346,7 @@ async function runMaintain(runtime, options = {}) {
 		const timeoutMs = options.timeoutMs ?? 6e5;
 		const signal = AbortSignal.timeout(timeoutMs);
 		abortSignal = signal;
-		const agentOptions = { model: options.model ?? "deepseek-v4-pro" };
+		const agentOptions = { model: options.model ?? runtime.evolutionPolicy?.get()?.curatorModel ?? "deepseek-v4-pro" };
 		if (options.provider) agentOptions.provider = options.provider;
 		const runResult = await (await runtime.subagents.start("spawn", {
 			label: "dsh-evolution-maintain",
@@ -359,6 +363,11 @@ async function runMaintain(runtime, options = {}) {
 			outputSchema: {
 				type: "object",
 				additionalProperties: false,
+				required: [
+					"verdict",
+					"plan",
+					"notes"
+				],
 				properties: {
 					verdict: { type: "string" },
 					plan: {
@@ -366,6 +375,22 @@ async function runMaintain(runtime, options = {}) {
 						items: {
 							type: "object",
 							additionalProperties: false,
+							required: [
+								"kind",
+								"names",
+								"rule",
+								"evidence",
+								"finding",
+								"recommendation",
+								"semantic_reasoning",
+								"impact",
+								"impact_reason",
+								"reversibility",
+								"undo_path",
+								"confidence",
+								"needs_human",
+								"is_override"
+							],
 							properties: {
 								kind: { type: "string" },
 								names: {
@@ -378,6 +403,7 @@ async function runMaintain(runtime, options = {}) {
 									items: {
 										type: "object",
 										additionalProperties: false,
+										required: ["signal", "value"],
 										properties: {
 											signal: { type: "string" },
 											value: { type: "string" }

package/lib/tools.js

@@ -1,4 +1,4 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-ePcRn3GX.js";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-Di8Y4kev.js";
 import { SkillLibrary, redactSecrets } from "@lmzhen/dsh-evolution-core";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region lib/types/tools.js
@@ -16,7 +16,7 @@ const name = "evolution-maintenance-tools";
 function apply(ctx, rawConfig = {}) {
 	const config = rawConfig;
 	ctx.inject(["tools"], (toolCtx) => {
-		toolCtx.tools.register(defineTool({
+		toolCtx.get("tools").register(defineTool({
 			name: "maintenance_probe",
 			description: "Read-only deep-dive into maintenance scan signals: library-level group/cluster membership or per-skill detail (line numbers, pointer gaps, narrow shapes, stamp samples). Machine-derived from the same calculators as the facts block — never introduces new evidence ids. Output is JSON detail.",
 			parameters: {
@@ -65,7 +65,8 @@ function apply(ctx, rawConfig = {}) {
 					supportFiles: enrichment.supportFiles,
 					quality: enrichment.quality,
 					protected: enrichment.protected,
-					catalogInvalid: enrichment.catalogInvalid
+					catalogInvalid: enrichment.catalogInvalid,
+					usageObserved: enrichment.usageObservedValue
 				}));
 				const redacted = redactSecrets(probe.detail.join("\n"));
 				return {

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

@@ -26,6 +26,11 @@ export interface SnapshotOptions {
     protected?: ReadonlyMap<string, string> | undefined;
     /** Skills whose frontmatter the strict-YAML catalog cannot load (0.3.11). */
     catalogInvalid?: ReadonlyMap<string, boolean> | undefined;
+    /** Usage observation window status (library-wide, applied to every snapshot
+     * — the same value the facts block injects). The probe reads it straight off
+     * the snapshot (E-36): without it the probe always answered 'unknown' while
+     * the facts block reported the enrichment value. */
+    usageObserved?: boolean | undefined;
 }
 /**
  * Assemble drift snapshots from a library reader and optional enrichment.

package/lib/types/orchestrate.d.ts

@@ -17,6 +17,15 @@ export interface MaintainRuntime {
     };
     /** Parent agent/session handle passed through to the subagent, when available. */
     parent?: unknown;
+    /** Evolution-policy reader for model routing (same source as the curator:
+     * `policy.get().curatorModel`). Optional — a missing service falls back to
+     * the default model (E-55). `get()` may RESOLVE to undefined (a soft probe
+     * can return nothing), hence the type carries it. */
+    evolutionPolicy?: {
+        get(): {
+            curatorModel?: string | undefined;
+        } | undefined;
+    } | undefined;
 }
 export interface MaintainOptions {
     timeoutMs?: number;

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.17",
+  "version": "0.3.18",
   "publishConfig": {
     "access": "public"
   },
@@ -34,7 +34,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@lmzhen/dsh-evolution-core": "^0.3.17"
+    "@lmzhen/dsh-evolution-core": "^0.3.18"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
@@ -42,7 +42,6 @@
     "@deepseek-ai/dsh-tools": "^0.1.1-rc.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2"
   }
 }