@lmzhen/dsh-evolution-maintenance 0.3.10 → 0.3.11

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

@@ -1,4 +1,4 @@
-import { HEALTH_STAMP_RE, computeDedupGroups, computePrefixClusters, duplicateHeadings, missingSupportPointers, narrowNameMatches, overlongLines, parseFrontmatter, usageObserved } from "@lmzhen/dsh-evolution-core";
+import { HEALTH_STAMP_RE, 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.
@@ -24,7 +24,9 @@ async function snapshotFromLibrary(library, options = {}) {
 			body,
 			description: options.descriptions?.get(entry.name),
 			supportFiles: options.supportFiles?.get(entry.name),
-			quality: options.quality?.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 } : {}
 		});
 	}
 	return snapshots;
@@ -90,7 +92,12 @@ function computeProbe(signal, target, snapshots) {
 		case "overlong_line": return result(signal, overlongLines(body).map((line) => `line ${line.lineNo}: ${line.chars} chars`), target);
 		case "pointer_missing": return result(signal, missingSupportPointers(body, snapshot.supportFiles ?? []).map((path) => `no body reference: ${path}`), target);
 		case "narrow_name": return result(signal, narrowNameMatches(snapshot.name).map((shape) => `narrow shape: ${shape}`), target);
-		case "description_chars": return result(signal, [`description=${snapshot.description === void 0 ? "missing" : `${snapshot.description.length} chars`}`], target);
+		case "description_chars": {
+			const desc = snapshot.description;
+			if (desc === void 0) return result(signal, ["description=missing"], target);
+			const text = desc.length > 160 ? `${desc.slice(0, 160)}…(truncated: ${desc.length} total)` : desc;
+			return result(signal, [`description=${desc.length} chars`, `desc-text: ${text}`], target);
+		}
 		case "quality_low": {
 			const quality = snapshot.quality;
 			return result(signal, [quality === null || quality === void 0 ? "quality=unknown" : `quality=${quality.toFixed(2)}`], target);
@@ -115,10 +122,15 @@ async function buildEnrichment(ctx, library) {
 	const descriptions = /* @__PURE__ */ new Map();
 	const supportFiles = /* @__PURE__ */ new Map();
 	const quality = /* @__PURE__ */ new Map();
+	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);
 		const body = await library.read(entry.name);
 		if (body === null) continue;
-		const description = parseFrontmatter(body)?.frontmatter.description;
+		const parsed = parseFrontmatter(body);
+		if (frontmatterYamlUnsafeValues(body).length > 0) catalogInvalid.set(entry.name, true);
+		const description = parsed?.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);
@@ -129,7 +141,9 @@ async function buildEnrichment(ctx, library) {
 		descriptions,
 		supportFiles,
 		quality,
-		usageObservedValue
+		usageObservedValue,
+		protected: protectedMap,
+		catalogInvalid
 	};
 }
 //#endregion

package/lib/index.js

@@ -1,4 +1,4 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-DxCdaJaQ.js";
+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 { createHash, randomUUID } from "node:crypto";
 //#region lib/types/render-facts.js
@@ -18,7 +18,8 @@ function renderFacts(report, options) {
 	lines.push(`<<<MECHANICAL_FACTS v=${options.signalsVersion} sig=${options.signature}>>>`);
 	for (const signal of report.library) lines.push(...renderSignal(signal, redact));
 	for (const skill of report.skills) {
-		lines.push(`# skill=${skill.name}`);
+		const meta = [`protected=${skill.protected ?? "none"}`, `catalog=${skill.catalogInvalid === true ? "yaml-invalid" : "visible"}`];
+		lines.push(`# skill=${skill.name} (${meta.join(" ")})`);
 		for (const signal of skill.signals) lines.push(...renderSignal(signal, redact));
 	}
 	lines.push("<<<END FACTS>>>");
@@ -316,7 +317,9 @@ async function runMaintain(runtime, options = {}) {
 		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
+			quality: options.quality ? options.quality() : void 0,
+			protected: options.protected ? options.protected() : void 0,
+			catalogInvalid: options.catalogInvalid ? options.catalogInvalid() : void 0
 		});
 		if (snapshots.length === 0) return {
 			ok: true,

package/lib/tools.js

@@ -1,4 +1,4 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-DxCdaJaQ.js";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-ePcRn3GX.js";
 import { SkillLibrary, redactSecrets } from "@lmzhen/dsh-evolution-core";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region lib/types/tools.js
@@ -63,7 +63,9 @@ function apply(ctx, rawConfig = {}) {
 				const probe = computeProbe(signal, target, await snapshotFromLibrary(library, {
 					descriptions: enrichment.descriptions,
 					supportFiles: enrichment.supportFiles,
-					quality: enrichment.quality
+					quality: enrichment.quality,
+					protected: enrichment.protected,
+					catalogInvalid: enrichment.catalogInvalid
 				}));
 				const redacted = redactSecrets(probe.detail.join("\n"));
 				return {

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

@@ -22,6 +22,10 @@ export interface SnapshotOptions {
     descriptions?: ReadonlyMap<string, string> | undefined;
     /** Quality score per skill name, when the caller computed it. */
     quality?: ReadonlyMap<string, number> | undefined;
+    /** Protection marker per skill name (0.3.11). */
+    protected?: ReadonlyMap<string, string> | undefined;
+    /** Skills whose frontmatter the strict-YAML catalog cannot load (0.3.11). */
+    catalogInvalid?: ReadonlyMap<string, boolean> | undefined;
 }
 /**
  * Assemble drift snapshots from a library reader and optional enrichment.

package/lib/types/enrichment.d.ts

@@ -13,6 +13,10 @@ export interface Enrichment {
     supportFiles: ReadonlyMap<string, readonly string[]>;
     quality: ReadonlyMap<string, number>;
     usageObservedValue: boolean | undefined;
+    /** Protection marker per skill (list().protectedBy — single source). */
+    protected: ReadonlyMap<string, string>;
+    /** Skills whose frontmatter the strict-YAML platform catalog cannot load. */
+    catalogInvalid: ReadonlyMap<string, boolean>;
 }
 export declare function buildEnrichment(ctx: Context, library: SkillLibrary): Promise<Enrichment>;
 //# sourceMappingURL=enrichment.d.ts.map

package/lib/types/orchestrate.d.ts

@@ -28,6 +28,8 @@ export interface MaintainOptions {
     supportFiles?: () => ReadonlyMap<string, readonly string[]>;
     descriptions?: () => ReadonlyMap<string, string>;
     quality?: () => ReadonlyMap<string, number>;
+    protected?: () => ReadonlyMap<string, string>;
+    catalogInvalid?: () => ReadonlyMap<string, boolean>;
     usageObserved?: () => boolean | undefined;
 }
 export interface MaintainOutcome {

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