@lmzhen/dsh-evolution-curator 0.4.1 → 0.6.0

package/README.md

@@ -26,6 +26,9 @@ Deterministic skill lifecycle and recovery
 
 - `autoStart` (default true) arms an HOURLY tick that only asks whether the due-ness interval (`intervalHours`, default 168 h) has elapsed — the tick is not the interval — plus a deferred catch-up check `bootGraceSeconds` (default 10) after host boot. Both decide due-ness from the **persisted** `lastRunAt`, so a restart with an overdue schedule runs the first pass within the boot grace instead of waiting a full interval. `bootGraceSeconds: 0` disables the deferral (not recommended: the check may run against a half-mounted host). All scheduling gates — interval, idle, first-run deferral, and the reentrancy guard — remain inside `run()`.
 - `autoStart: false` disables both automatic checks; `/evolution curator run` (manual, gate-skipping) still works.
+- Deprecated name (G0/S0.3): `intervalHours` is the legacy spelling of the policy
+  row's `curatorIntervalHours`, whose value the snapshot shadows. Reading it still
+  works; writing it is refused, and it is removed in 0.7.0.
 
 **Runtime invariant:** No companion is published. The platform auto-assembles nothing and the family mounts no `<pkg>/invariant` cordis row, so a companion here would never execute (v37 S2.1 / I-3).
 ## Notes and history

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_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, INSTANCE_KEYS, MAX_TIMER_DELAY_MS, SKILL_NAME_RE, buildCuratorRunReport, claimInstance, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, foldCuratorFields, isPresent, isUnknown, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, newSkillLibrary, parseCuratorNominations, parseFrontmatter, probeList, probeMtime, relatedSkillNames, releaseInstance, renderCuratorReportMarkdown, transactIo, updateSuppressedNames, usageObserved } from "@lmzhen/dsh-evolution-core";
+import { CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CURATOR_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MIN_IDLE_HOURS, DEFAULT_SKILL_LIMITS, DEFAULT_STALE_AFTER_DAYS, EvolutionGateSet, INSTANCE_KEYS, MAX_TIMER_DELAY_MS, PARAM_NAMESPACES, SKILL_NAME_RE, buildCuratorRunReport, claimInstance, clampedNumber, computeDedupGroups, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, emptyRecord, evolutionHome, evolutionIoAdapter, foldCuratorFields, installParamSection, isPresent, isUnknown, loadSuppressedNames, loadUsage, markerEntryName, mutateUsage, newSkillLibrary, parseCuratorNominations, parseFrontmatter, policyStageLimits, probeList, probeMtime, readNumberParam, relatedSkillNames, releaseInstance, renderCuratorReportMarkdown, transactIo, updateSuppressedNames, usageObserved } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Deterministic skill lifecycle curator with interval gate and archive.
@@ -17,6 +17,36 @@ const DEFAULT_QUALITY_WARN_STALE_AFTER_DAYS = 7;
 * 120s matches the review subagent default; the 32-bit ceiling is Node's
 * timer-delay limit (`AbortSignal.timeout` throws above it). */
 const DEFAULT_CURATOR_REVIEW_TIMEOUT_MS = 12e4;
+/** Namespace the curator group's user-writable knobs live in (core's PARAM_NAMESPACES). */
+const CURATOR_SETTINGS_NAMESPACE = "evolution-curator";
+/** Schema the platform validates the user layer against; defaults mirror the core
+* constants and the bounds mirror the row schema, so an empty document resolves to
+* today's behaviour and an out-of-range value is refused instead of clamped. */
+const CURATOR_SETTINGS_SCHEMA = z.object({
+	curatorIntervalHours: z.number().min(1).default(DEFAULT_CURATOR_INTERVAL_HOURS),
+	staleAfterDays: z.number().min(1).default(DEFAULT_STALE_AFTER_DAYS),
+	archiveAfterDays: z.number().min(1).default(DEFAULT_ARCHIVE_AFTER_DAYS),
+	qualityWarnStaleAfterDays: z.number().min(1).default(DEFAULT_QUALITY_WARN_STALE_AFTER_DAYS),
+	minIdleHours: z.number().min(0).default(DEFAULT_MIN_IDLE_HOURS),
+	minIdleFailOpen: z.boolean().default(true),
+	llmReview: z.boolean().default(false),
+	curatorReviewMaxTokens: z.number().min(1).default(DEFAULT_CURATOR_REVIEW_MAX_TOKENS),
+	curatorReviewTimeoutMs: z.number().min(1).max(MAX_TIMER_DELAY_MS).default(DEFAULT_CURATOR_REVIEW_TIMEOUT_MS),
+	healthSoftBodyChars: z.number().min(1).default(DEFAULT_HEALTH_THRESHOLDS.softBodyChars),
+	healthStampDensityPerKb: z.number().min(1).default(DEFAULT_HEALTH_THRESHOLDS.stampDensityPerKb),
+	healthChurnMinPatches: z.number().min(1).default(DEFAULT_HEALTH_THRESHOLDS.churnMinPatches)
+});
+/**
+* The cross-field rule the schema cannot express (A2-17): an archive threshold
+* below the stale threshold makes the engine reactivate stale records instead of
+* archiving them, so a resolved pair that violates it is refused at WRITE time.
+* The runtime keeps its clamp for the carriers this hook never sees (the policy
+* snapshot and the plugin row).
+* @param value - the resolved section the platform hands the owner.
+*/
+function validateCuratorSettings(value) {
+	if (value.archiveAfterDays < value.staleAfterDays) throw new Error(`archiveAfterDays (${value.archiveAfterDays}) must be >= staleAfterDays (${value.staleAfterDays})`);
+}
 /**
 * Block LLM-nominated consolidations that would touch a gate-protected name:
 * exclude / referenced / suppressed skills must never merge (neither as the
@@ -76,6 +106,10 @@ var EvolutionCurator = class extends Service {
 	healthSoftBodyChars;
 	healthStampDensityPerKb;
 	healthChurnMinPatches;
+	/** G3/S3.3: this row's resolved values — the base layer of the settings section. */
+	settingsBase;
+	/** The user layer for this row's namespace (absent provider = deployment values). */
+	overrides;
 	lastRun = 0;
 	timer;
 	/** B-8 (v18): set by the fiber disposer; a triggered autoCheck must not
@@ -110,7 +144,11 @@ var EvolutionCurator = class extends Service {
 		this.skills = newSkillLibrary({
 			config,
 			io: this.io,
-			ctx: this.ctx
+			ctx: this.ctx,
+			limits: {
+				...DEFAULT_SKILL_LIMITS,
+				...policyStageLimits(this.ctx.get("evolutionPolicy")?.get?.())
+			}
 		});
 		this.enabled = config.enabled ?? true;
 		this.instanceHome = evolutionHome();
@@ -126,7 +164,7 @@ var EvolutionCurator = class extends Service {
 			if (value !== void 0 && result !== value) clamped.push(name);
 			return result;
 		};
-		this.intervalHours = field("intervalHours", config.intervalHours, DEFAULT_CURATOR_INTERVAL_HOURS, 1);
+		this.intervalHours = field("intervalHours", readNumberParam(config, "curatorIntervalHours"), DEFAULT_CURATOR_INTERVAL_HOURS, 1);
 		this.staleAfterDays = field("staleAfterDays", config.staleAfterDays, DEFAULT_STALE_AFTER_DAYS, 1);
 		this.archiveAfterDays = field("archiveAfterDays", config.archiveAfterDays, DEFAULT_ARCHIVE_AFTER_DAYS, 1);
 		if (this.archiveAfterDays < this.staleAfterDays) {
@@ -149,6 +187,26 @@ var EvolutionCurator = class extends Service {
 		this.healthStampDensityPerKb = field("healthStampDensityPerKb", config.healthStampDensityPerKb, DEFAULT_HEALTH_THRESHOLDS.stampDensityPerKb, 1);
 		this.healthChurnMinPatches = field("healthChurnMinPatches", config.healthChurnMinPatches, DEFAULT_HEALTH_THRESHOLDS.churnMinPatches, 1);
 		if (clamped.length > 0) this.ctx.logger.warn(`evolution-curator: ${clamped.join(", ")} provided an invalid value; falling back to the default`);
+		this.settingsBase = {
+			curatorIntervalHours: this.intervalHours,
+			staleAfterDays: this.staleAfterDays,
+			archiveAfterDays: this.archiveAfterDays,
+			qualityWarnStaleAfterDays: this.qualityWarnStaleAfterDays,
+			minIdleHours: this.minIdleHours,
+			minIdleFailOpen: this.minIdleFailOpen,
+			llmReview: this.llmReview,
+			curatorReviewMaxTokens: this.curatorReviewMaxTokens,
+			curatorReviewTimeoutMs: this.curatorReviewTimeoutMs,
+			healthSoftBodyChars: this.healthSoftBodyChars,
+			healthStampDensityPerKb: this.healthStampDensityPerKb,
+			healthChurnMinPatches: this.healthChurnMinPatches
+		};
+		this.overrides = installParamSection(ctx, PARAM_NAMESPACES["evolution-curator"] ?? "evolution-curator", CURATOR_SETTINGS_SCHEMA, this.settingsBase, {
+			warn: (message) => {
+				this.ctx.logger.warn("dsh-evolution-curator: " + message);
+			},
+			validate: validateCuratorSettings
+		});
 		this.lastRun = Date.now();
 		this.ctx.effect(() => {
 			return () => {
@@ -159,17 +217,58 @@ var EvolutionCurator = class extends Service {
 		}, "evolution-curator.stop");
 		if (config.autoStart ?? true) this.start();
 	}
+	/** The policy-snapshot carrier for this group (unmounted service = no policy). */
+	policyFields() {
+		return this.ctx.get("evolutionPolicy")?.get() ?? {};
+	}
+	/**
+	* G3/S3.3: the ONE reader of the curator's behaviour knobs. Precedence is
+	* user > policy snapshot > this row, and {@link ParamOverrides.get} returns
+	* undefined for a key the user never set, so the deployment carriers keep
+	* winning exactly as before. Read at USE time: a committed settings change is
+	* live without a restart and without a watcher.
+	* @returns the resolved section, every numeric field sanitized.
+	*/
+	settings() {
+		const snapshot = this.policyFields();
+		const row = this.settingsBase;
+		const pick = (key) => {
+			const user = this.overrides.get(key);
+			if (user !== void 0) return user;
+			return snapshot[key] ?? row[key];
+		};
+		const number = (key, min, max) => {
+			const lower = row[key];
+			return clampedNumber(pick(key), lower, max === void 0 ? { min } : {
+				min,
+				max
+			});
+		};
+		return {
+			curatorIntervalHours: number("curatorIntervalHours", 1),
+			staleAfterDays: number("staleAfterDays", 1),
+			archiveAfterDays: number("archiveAfterDays", 1),
+			qualityWarnStaleAfterDays: number("qualityWarnStaleAfterDays", 1),
+			minIdleHours: number("minIdleHours", 0),
+			minIdleFailOpen: pick("minIdleFailOpen"),
+			llmReview: pick("llmReview"),
+			curatorReviewMaxTokens: number("curatorReviewMaxTokens", 1),
+			curatorReviewTimeoutMs: number("curatorReviewTimeoutMs", 1, MAX_TIMER_DELAY_MS),
+			healthSoftBodyChars: number("healthSoftBodyChars", 1),
+			healthStampDensityPerKb: number("healthStampDensityPerKb", 1),
+			healthChurnMinPatches: number("healthChurnMinPatches", 1)
+		};
+	}
 	lifecycle() {
-		const snapshot = this.ctx.get("evolutionPolicy")?.get();
-		const staleAfterDays = snapshot?.staleAfterDays ?? this.staleAfterDays;
-		let archiveAfterDays = snapshot?.archiveAfterDays ?? this.archiveAfterDays;
-		if (archiveAfterDays < staleAfterDays) {
-			this.ctx.logger.warn(`evolution-curator: policy archiveAfterDays (${archiveAfterDays}) < policy staleAfterDays (${staleAfterDays}); using the stale threshold as the archive threshold`);
-			archiveAfterDays = staleAfterDays;
+		const settings = this.settings();
+		let archiveAfterDays = settings.archiveAfterDays;
+		if (archiveAfterDays < settings.staleAfterDays) {
+			this.ctx.logger.warn(`evolution-curator: archiveAfterDays (${archiveAfterDays}) < staleAfterDays (${settings.staleAfterDays}); using the stale threshold as the archive threshold`);
+			archiveAfterDays = settings.staleAfterDays;
 		}
 		return {
-			intervalHours: snapshot?.curatorIntervalHours ?? this.intervalHours,
-			staleAfterDays,
+			intervalHours: settings.curatorIntervalHours,
+			staleAfterDays: settings.staleAfterDays,
 			archiveAfterDays
 		};
 	}
@@ -303,6 +402,7 @@ var EvolutionCurator = class extends Service {
 			"",
 			"Return a YAML summary with consolidations and prunings lists. Nominate only actions whose archival/merge is clearly safe."
 		].join("\n");
+		const settings = this.settings();
 		try {
 			const assembler = new BlockAssembler();
 			for await (const chunk of llm.stream({
@@ -320,8 +420,8 @@ var EvolutionCurator = class extends Service {
 						summary: "curator review"
 					}
 				})],
-				maxTokens: this.curatorReviewMaxTokens,
-				signal: AbortSignal.timeout(this.curatorReviewTimeoutMs)
+				maxTokens: settings.curatorReviewMaxTokens,
+				signal: AbortSignal.timeout(settings.curatorReviewTimeoutMs)
 			})) assembler.push(chunk);
 			const parsed = parseCuratorNominations(assembler.blocks().filter((block) => block.type === "text").map((block) => block.text).join("\n"));
 			return {
@@ -394,7 +494,7 @@ var EvolutionCurator = class extends Service {
 			archiveCandidates: [],
 			archived: [],
 			failed: [],
-			llmReviewEnabled: this.llmReview
+			llmReviewEnabled: this.settings().llmReview
 		});
 	}
 	/**
@@ -502,6 +602,7 @@ var EvolutionCurator = class extends Service {
 		const runId = randomUUID();
 		const stateService = this.curatorStateService();
 		const lifecycle = this.lifecycle();
+		const settings = this.settings();
 		const persisted = await stateService?.loadCuratorState() ?? null;
 		if (!ignoreGates && persisted?.paused === true) return {
 			stale: [],
@@ -517,7 +618,7 @@ var EvolutionCurator = class extends Service {
 			report: this.skippedReport(runId, startedAt),
 			skipped: "interval"
 		};
-		if (!ignoreGates && this.minIdleHours > 0 && this.recentSessionActive()) return {
+		if (!ignoreGates && settings.minIdleHours > 0 && this.recentSessionActive()) return {
 			stale: [],
 			archived: [],
 			errors: [],
@@ -580,7 +681,7 @@ var EvolutionCurator = class extends Service {
 		const result = computeLifecycleTransitions(usage, {
 			staleAfterDays: lifecycle.staleAfterDays,
 			archiveAfterDays: lifecycle.archiveAfterDays,
-			qualityWarnStaleAfterDays: this.qualityWarnStaleAfterDays,
+			qualityWarnStaleAfterDays: settings.qualityWarnStaleAfterDays,
 			excludeSkillNames: this.excludeSkillNames,
 			manageUnmanaged: this.manageUnmanaged,
 			pruneBuiltins: this.pruneBuiltins,
@@ -589,7 +690,7 @@ var EvolutionCurator = class extends Service {
 			referencedSkillNames: this.referencedSkillNames
 		}, /* @__PURE__ */ new Date(), gates, protectedNames);
 		const recommendPool = [...new Set([...result.markStale, ...dedupMembers])].filter((name) => SKILL_NAME_RE.test(name));
-		const nominations = this.llmReview ? await this.recommend(recommendPool, { dryRun }) : {
+		const nominations = settings.llmReview ? await this.recommend(recommendPool, { dryRun }) : {
 			prunings: [],
 			consolidations: [],
 			warnings: []
@@ -601,7 +702,7 @@ var EvolutionCurator = class extends Service {
 		};
 		const llmNominations = gatedNominations.prunings;
 		const archiveCandidates = [...new Set([...result.archive, ...llmNominations])];
-		if (!ignoreGates && this.minIdleHours > 0 && this.recentSessionActive()) {
+		if (!ignoreGates && settings.minIdleHours > 0 && this.recentSessionActive()) {
 			if (!dryRun) try {
 				await mutateUsage(root, this.io, (map) => {
 					for (const [name, record] of usage) if (!map.has(name)) map.set(name, { ...record });
@@ -618,7 +719,7 @@ var EvolutionCurator = class extends Service {
 			};
 		}
 		const snapshotPath = dryRun ? void 0 : await this.snapshotFull("pre-curator-run");
-		if (!ignoreGates && this.minIdleHours > 0 && this.recentSessionActive()) {
+		if (!ignoreGates && settings.minIdleHours > 0 && this.recentSessionActive()) {
 			if (!dryRun) try {
 				await mutateUsage(root, this.io, (map) => {
 					for (const [name, record] of usage) if (!map.has(name)) map.set(name, { ...record });
@@ -654,10 +755,13 @@ var EvolutionCurator = class extends Service {
 		});
 		const runAborted = errors.some((error) => error.startsWith("run aborted"));
 		if (!dryRun && !runAborted) this.lastRun = Date.now();
+		const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+		const wouldPrune = this.skills.archiveRetentionPolicy() === "report" ? await this.skills.expiredArchives() : void 0;
 		const report = buildCuratorRunReport({
 			runId,
 			startedAt,
-			finishedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			finishedAt,
+			...wouldPrune === void 0 ? {} : { wouldPrune },
 			staleCandidates: result.markStale,
 			llmNominations,
 			archiveCandidates,
@@ -679,7 +783,7 @@ var EvolutionCurator = class extends Service {
 			})(),
 			consolidated,
 			...snapshotPath === void 0 ? {} : { snapshotPath },
-			llmReviewEnabled: this.llmReview,
+			llmReviewEnabled: settings.llmReview,
 			...gatedNominations.warnings.length > 0 ? { nominationsWarnings: gatedNominations.warnings } : {}
 		});
 		const reportsRoot = join(evolutionHome(), "reports");
@@ -690,7 +794,7 @@ var EvolutionCurator = class extends Service {
 			this.ctx.logger.warn(`evolution-curator: failed to persist report ${runId}`);
 			this.ctx.logger.warn(error);
 		}
-		const llmHint = !this.llmReview && result.markStale.length > 0 ? " (llmReview: off - deterministic archive only; set llmReview: true for the LLM merge channel)" : "";
+		const llmHint = !settings.llmReview && result.markStale.length > 0 ? " (llmReview: off - deterministic archive only; set llmReview: true for the LLM merge channel)" : "";
 		const summary = `${dryRun ? "dry-run" : "auto"}: stale:${result.markStale.length} archived:${archivedSkills.length} consolidated:${consolidated.length}${llmHint}`;
 		try {
 			await stateService?.transactCuratorState((current) => {
@@ -711,7 +815,7 @@ var EvolutionCurator = class extends Service {
 			archived: archivedSkills.map((item) => item.name),
 			errors,
 			report,
-			...this.llmReview ? { nominations: gatedNominations } : {}
+			...settings.llmReview ? { nominations: gatedNominations } : {}
 		};
 	}
 	/**
@@ -943,15 +1047,16 @@ var EvolutionCurator = class extends Service {
 		};
 	}
 	recentSessionActive() {
+		const settings = this.settings();
 		const agents = this.ctx.get("agents");
-		if (!agents) return !this.minIdleFailOpen;
+		if (!agents) return !settings.minIdleFailOpen;
 		let latest = 0;
 		for (const agent of agents.list()) {
 			const events = agent.session.snapshotEvents();
 			const last = events.length === 0 ? 0 : events[events.length - 1]?.time ?? 0;
 			latest = Math.max(latest, last);
 		}
-		return latest > 0 && Date.now() - latest < this.minIdleHours * 36e5;
+		return latest > 0 && Date.now() - latest < settings.minIdleHours * 36e5;
 	}
 	/**
 	* Keep only the newest N curator run reports plus at most `errorKeep` error
@@ -1098,10 +1203,11 @@ var EvolutionCurator = class extends Service {
 	* layer.
 	*/
 	async healthView() {
+		const settings = this.settings();
 		const thresholds = {
-			softBodyChars: this.healthSoftBodyChars,
-			stampDensityPerKb: this.healthStampDensityPerKb,
-			churnMinPatches: this.healthChurnMinPatches
+			softBodyChars: settings.healthSoftBodyChars,
+			stampDensityPerKb: settings.healthStampDensityPerKb,
+			churnMinPatches: settings.healthChurnMinPatches
 		};
 		const usage = await loadUsage(this.skills.root, this.io);
 		const observed = usageObserved(usage);
@@ -1230,4 +1336,4 @@ function reportsSweepLockTarget() {
 	return join(evolutionHome(), "reports", ".retention");
 }
 //#endregion
-export { EvolutionCurator, EvolutionCurator as default, gateConsolidations };
+export { CURATOR_SETTINGS_NAMESPACE, CURATOR_SETTINGS_SCHEMA, EvolutionCurator, EvolutionCurator as default, gateConsolidations, validateCuratorSettings };

package/lib/types/index.d.ts

@@ -3,6 +3,7 @@
  * @module @lmzhen/dsh-evolution-curator
  */
 import { Context, Service } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
 import type Schema from '@deepseek-ai/schemastery';
 import { EvolutionGateSet, type SkillLibrary } from '@lmzhen/dsh-evolution-core';
 import { type CuratorConsolidation, type CuratorNominations, type CuratorRunReport, type ScopeView, type SkillActionResult, type SkillHealthVerdict } from '@lmzhen/dsh-evolution-core';
@@ -14,6 +15,10 @@ declare module '@deepseek-ai/cordis' {
 }
 export interface Config {
     enabled?: boolean;
+    /** The due-ness interval. The policy snapshot shadows it in every shipped
+     * composition — configure `curatorIntervalHours` there; that name is the
+     * canonical id. Deprecated alias (G0/S0.3): still readable, refused by
+     * writes; removed 0.7.0. */
     intervalHours?: number;
     staleAfterDays?: number;
     archiveAfterDays?: number;
@@ -56,6 +61,50 @@ export interface Config {
     /** Structure-health write-ghost floor: patches at/above with zero reads (A2). */
     healthChurnMinPatches?: number;
 }
+/** Namespace the curator group's user-writable knobs live in (core's PARAM_NAMESPACES). */
+export declare const CURATOR_SETTINGS_NAMESPACE = "evolution-curator";
+/** Curator behaviour a user may change (G3/S3.3). Field names are the CANONICAL
+ * parameter ids from the registry, so the settings document, the params output,
+ * the doctor report and the cards all spell one name. */
+export interface CuratorSettings {
+    /** Minimum hours between deterministic curation passes. */
+    curatorIntervalHours: number;
+    /** Inactive days before a skill counts as stale. */
+    staleAfterDays: number;
+    /** Inactive days before a stale skill is archived (>= staleAfterDays). */
+    archiveAfterDays: number;
+    /** Age at which a low quality score starts warning. */
+    qualityWarnStaleAfterDays: number;
+    /** Idle hours required before an automatic pass runs (0 disables the gate). */
+    minIdleHours: number;
+    /** Let the idle gate open when the activity probe is unavailable. */
+    minIdleFailOpen: boolean;
+    /** Enable the LLM nomination pass on top of the deterministic lifecycle. */
+    llmReview: boolean;
+    /** Token budget of the curator LLM review. */
+    curatorReviewMaxTokens: number;
+    /** Wall-clock bound of the curator LLM review. */
+    curatorReviewTimeoutMs: number;
+    /** Body character line the health view judges against. */
+    healthSoftBodyChars: number;
+    /** Stamp density per KB that flags log-like content in a body. */
+    healthStampDensityPerKb: number;
+    /** Patches without a read that flag a write-ghost skill. */
+    healthChurnMinPatches: number;
+}
+/** Schema the platform validates the user layer against; defaults mirror the core
+ * constants and the bounds mirror the row schema, so an empty document resolves to
+ * today's behaviour and an out-of-range value is refused instead of clamped. */
+export declare const CURATOR_SETTINGS_SCHEMA: z<CuratorSettings>;
+/**
+ * The cross-field rule the schema cannot express (A2-17): an archive threshold
+ * below the stale threshold makes the engine reactivate stale records instead of
+ * archiving them, so a resolved pair that violates it is refused at WRITE time.
+ * The runtime keeps its clamp for the carriers this hook never sees (the policy
+ * snapshot and the plugin row).
+ * @param value - the resolved section the platform hands the owner.
+ */
+export declare function validateCuratorSettings(value: CuratorSettings): void;
 /** Outcome of one curator run pass. */
 export interface CuratorRunOutcome {
     stale: string[];
@@ -113,6 +162,10 @@ export declare class EvolutionCurator extends Service {
     private readonly healthSoftBodyChars;
     private readonly healthStampDensityPerKb;
     private readonly healthChurnMinPatches;
+    /** G3/S3.3: this row's resolved values — the base layer of the settings section. */
+    private readonly settingsBase;
+    /** The user layer for this row's namespace (absent provider = deployment values). */
+    private readonly overrides;
     private lastRun;
     private timer;
     /** B-8 (v18): set by the fiber disposer; a triggered autoCheck must not
@@ -140,6 +193,17 @@ export declare class EvolutionCurator extends Service {
      * yielding instance's log line names a concrete holder. */
     private readonly instanceOwner;
     constructor(ctx: Context, config?: Config);
+    /** The policy-snapshot carrier for this group (unmounted service = no policy). */
+    private policyFields;
+    /**
+     * G3/S3.3: the ONE reader of the curator's behaviour knobs. Precedence is
+     * user > policy snapshot > this row, and {@link ParamOverrides.get} returns
+     * undefined for a key the user never set, so the deployment carriers keep
+     * winning exactly as before. Read at USE time: a committed settings change is
+     * live without a restart and without a watcher.
+     * @returns the resolved section, every numeric field sanitized.
+     */
+    private settings;
     private lifecycle;
     start(): void;
     stop(): void;

package/package.json

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