@lmzhen/dsh-evolution-curator 0.1.0 → 0.2.0-rc.2

package/lib/index.js

@@ -3,7 +3,7 @@ import { randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 import z from "@deepseek-ai/schemastery";
-import { CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, SkillLibrary, buildCuratorRunReport, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, foldCuratorFields, loadSuppressedNames, loadUsage, mutateUsage, parseCuratorNominations, relatedSkillNames, renderCuratorReportMarkdown, updateSuppressedNames } from "@lmzhen/dsh-evolution-core";
+import { CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, SkillLibrary, buildCuratorRunReport, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, foldCuratorFields, loadSuppressedNames, loadUsage, mutateUsage, parseCuratorNominations, relatedSkillNames, renderCuratorReportMarkdown, updateSuppressedNames, usageObserved } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Deterministic skill lifecycle curator with interval gate and archive.
@@ -38,7 +38,10 @@ var EvolutionCurator = class extends Service {
 		referencedSkillNames: z.array(z.string()).default([]),
 		autoStart: z.boolean().default(true),
 		bootGraceSeconds: z.number().default(10),
-		curatorReviewMaxTokens: z.number().default(2048)
+		curatorReviewMaxTokens: z.number().default(2048),
+		healthSoftBodyChars: z.number().default(DEFAULT_HEALTH_THRESHOLDS.softBodyChars),
+		healthStampDensityPerKb: z.number().default(DEFAULT_HEALTH_THRESHOLDS.stampDensityPerKb),
+		healthChurnMinPatches: z.number().default(DEFAULT_HEALTH_THRESHOLDS.churnMinPatches)
 	});
 	skills;
 	io;
@@ -56,6 +59,9 @@ var EvolutionCurator = class extends Service {
 	referencedSkillNames;
 	bootGraceSeconds;
 	curatorReviewMaxTokens;
+	healthSoftBodyChars;
+	healthStampDensityPerKb;
+	healthChurnMinPatches;
 	lastRun = 0;
 	timer;
 	bootCheck;
@@ -80,6 +86,9 @@ var EvolutionCurator = class extends Service {
 		this.referencedSkillNames = new Set(config.referencedSkillNames ?? []);
 		this.bootGraceSeconds = config.bootGraceSeconds ?? 10;
 		this.curatorReviewMaxTokens = config.curatorReviewMaxTokens ?? 2048;
+		this.healthSoftBodyChars = config.healthSoftBodyChars ?? DEFAULT_HEALTH_THRESHOLDS.softBodyChars;
+		this.healthStampDensityPerKb = config.healthStampDensityPerKb ?? DEFAULT_HEALTH_THRESHOLDS.stampDensityPerKb;
+		this.healthChurnMinPatches = config.healthChurnMinPatches ?? DEFAULT_HEALTH_THRESHOLDS.churnMinPatches;
 		this.lastRun = Date.now();
 		this.ctx.effect(() => {
 			return () => {
@@ -545,7 +554,7 @@ var EvolutionCurator = class extends Service {
 				errors.push(`${nomination.from}: consolidation nomination outside the candidate pool — refused (advisory text has no executability authority)`);
 				continue;
 			}
-			const consolidated = await this.skills.consolidate(nomination.into, [nomination.from], "background_review");
+			const consolidated = await this.skills.consolidate(nomination.into, [nomination.from], "background_review", { ...nomination.mode === void 0 ? {} : { mode: nomination.mode } });
 			if (!consolidated.ok) {
 				errors.push(`${nomination.from}: ${consolidated.message}`);
 				continue;
@@ -691,6 +700,39 @@ var EvolutionCurator = class extends Service {
 			bundledNames
 		}, await this.protectedNameMap(), gates);
 	}
+	/**
+	* Structure-health view (rc.73 A1, 008 design): degraded skills only,
+	* derived on demand — never persisted. Signals for review/curate proposals;
+	* the deterministic assessment stays here, refinement stays in the judgment
+	* layer.
+	*/
+	async healthView() {
+		const thresholds = {
+			softBodyChars: this.healthSoftBodyChars,
+			stampDensityPerKb: this.healthStampDensityPerKb,
+			churnMinPatches: this.healthChurnMinPatches
+		};
+		const usage = await loadUsage(this.skills.root, this.io);
+		const observed = usageObserved(usage);
+		const rows = [];
+		for (const summary of await this.skills.list()) {
+			const record = usage.get(summary.name);
+			const assessment = await this.skills.assessHealth(summary.name, thresholds, observed && record ? {
+				patchCount: record.patch_count,
+				readCount: record.view_count
+			} : void 0);
+			if (assessment && assessment.verdict !== "healthy") rows.push({
+				name: summary.name,
+				verdict: assessment.verdict,
+				reasons: assessment.reasons
+			});
+		}
+		return rows;
+	}
+	/** Whether the library has ANY observed read evidence (C observation-window gate for churn signals). */
+	async usageObserved() {
+		return usageObserved(await loadUsage(this.skills.root, this.io));
+	}
 	/** marker info (pinned/bundled/hub-installed) per skill, from the library list. */
 	async protectedNameMap() {
 		const map = /* @__PURE__ */ new Map();

package/lib/types/index.d.ts

@@ -5,7 +5,7 @@
 import { Context, Service } from '@deepseek-ai/cordis';
 import type Schema from '@deepseek-ai/schemastery';
 import { EvolutionGateSet, SkillLibrary } from '@deepseek-ai/dsh-evolution-core';
-import { type CuratorConsolidation, type CuratorNominations, type CuratorRunReport, type ScopeView, type SkillActionResult } from '@deepseek-ai/dsh-evolution-core';
+import { type CuratorConsolidation, type CuratorNominations, type CuratorRunReport, type ScopeView, type SkillActionResult, type SkillHealthVerdict } from '@deepseek-ai/dsh-evolution-core';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         evolutionCurator: EvolutionCurator;
@@ -37,6 +37,12 @@ export interface Config {
     bootGraceSeconds?: number;
     /** Max tokens for the optional LLM nomination pass. */
     curatorReviewMaxTokens?: number;
+    /** Structure-health soft body limit (chars) — see DEFAULT_HEALTH_THRESHOLDS (rc.73 A1). */
+    healthSoftBodyChars?: number;
+    /** Structure-health stamp-density ceiling per KB — see DEFAULT_HEALTH_THRESHOLDS. */
+    healthStampDensityPerKb?: number;
+    /** Structure-health write-ghost floor: patches at/above with zero reads (A2). */
+    healthChurnMinPatches?: number;
 }
 /** Outcome of one curator run pass. */
 export interface CuratorRunOutcome {
@@ -86,6 +92,9 @@ export declare class EvolutionCurator extends Service {
     private readonly referencedSkillNames;
     private readonly bootGraceSeconds;
     private readonly curatorReviewMaxTokens;
+    private readonly healthSoftBodyChars;
+    private readonly healthStampDensityPerKb;
+    private readonly healthChurnMinPatches;
     private lastRun;
     private timer;
     private bootCheck;
@@ -201,6 +210,19 @@ export declare class EvolutionCurator extends Service {
      * so the view always predicts what a curator pass may touch.
      */
     scopeView(): Promise<ScopeView>;
+    /**
+     * Structure-health view (rc.73 A1, 008 design): degraded skills only,
+     * derived on demand — never persisted. Signals for review/curate proposals;
+     * the deterministic assessment stays here, refinement stays in the judgment
+     * layer.
+     */
+    healthView(): Promise<Array<{
+        name: string;
+        verdict: SkillHealthVerdict;
+        reasons: string[];
+    }>>;
+    /** Whether the library has ANY observed read evidence (C observation-window gate for churn signals). */
+    usageObserved(): Promise<boolean>;
     /** marker info (pinned/bundled/hub-installed) per skill, from the library list. */
     private protectedNameMap;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-curator",
   "description": "Deterministic skill lifecycle and recovery (community build)",
-  "version": "0.1.0",
+  "version": "0.2.0-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -33,20 +33,20 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.1.0"
+    "@lmzhen/dsh-evolution-core": "^0.2.0-rc.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.1.0",
-    "@lmzhen/dsh-evolution-state": "^0.1.0"
+    "@lmzhen/dsh-evolution-io": "^0.2.0-rc.2",
+    "@lmzhen/dsh-evolution-state": "^0.2.0-rc.2"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.1.0",
-    "@lmzhen/dsh-evolution-io": "^0.1.0",
-    "@lmzhen/dsh-evolution-state": "^0.1.0"
+    "@lmzhen/dsh-evolution-core": "^0.2.0-rc.2",
+    "@lmzhen/dsh-evolution-io": "^0.2.0-rc.2",
+    "@lmzhen/dsh-evolution-state": "^0.2.0-rc.2"
   }
 }