@lmzhen/dsh-evolution-core 0.24.0 → 0.25.0

package/lib/index.js

@@ -473,6 +473,13 @@ const DEFAULT_CURATOR_INTERVAL_HOURS = 168;
 const DEFAULT_MIN_IDLE_HOURS = 2;
 const DEFAULT_STALE_AFTER_DAYS = 30;
 const DEFAULT_ARCHIVE_AFTER_DAYS = 90;
+/**
+* Support-file count above which `references-sprawl` warns. **NOT CALIBRATED YET** — 60 is a
+* placeholder: the platform corpus is empty (no platform skills available here), so the admission
+* band cannot be checked. Until `gen-health-baseline` reports both corpora, the rule is
+* REPORT-ONLY: its count must not be shown as a number on any surface (plan G4 ③).
+*/
+const SUPPORT_SPRAWL_FILES = 60;
 const DEFAULT_MEMORY_CHAR_LIMIT = 2200;
 const DEFAULT_USER_CHAR_LIMIT = 1375;
 /** Consolidation-failure backoff cap, shared by MemoryStore and memory-files' Config default. */
@@ -1157,6 +1164,213 @@ function bodyCost(content) {
 	};
 }
 //#endregion
+//#region lib/types/skill-lint.js
+const msg = (parts) => parts.map((p) => typeof p === "string" ? p : String(p)).join("");
+/** One rule yields AT MOST one finding (contract §3). `body-oversize-2x` is the only rule whose
+* severity can escalate a verdict to needs-restructure. */
+const RULES = [
+	{
+		id: "unreadable-skill",
+		severity: "error",
+		run: (facts) => facts.readable && facts.dims.bodyChars !== null ? null : {
+			severity: "error",
+			rule: "unreadable-skill",
+			message: msg([facts.skillName, ": SKILL.md could not be read — no health claim is possible"]),
+			count: 1
+		}
+	},
+	{
+		id: "body-oversize-2x",
+		severity: "error",
+		run: (facts) => facts.overTwiceSoftLine ? {
+			severity: "error",
+			rule: "body-oversize-2x",
+			message: msg([
+				facts.skillName,
+				": body is at or past twice the soft line (",
+				facts.softLineChars,
+				" chars)"
+			]),
+			count: 1
+		} : null
+	},
+	{
+		id: "body-oversize",
+		severity: "warn",
+		run: (facts) => !facts.overTwiceSoftLine && facts.overSoftLine ? {
+			severity: "warn",
+			rule: "body-oversize",
+			message: msg([
+				facts.skillName,
+				": body is at or above the soft line (",
+				facts.softLineChars,
+				" chars)"
+			]),
+			count: 1
+		} : null
+	},
+	{
+		id: "stamp-density",
+		severity: "warn",
+		run: (facts) => {
+			const density = facts.dims.stampDensityPerKb;
+			const hits = facts.dims.stampHits;
+			if (density === null || hits === null || density < facts.stampLimitPerKb) return null;
+			return {
+				severity: "warn",
+				rule: "stamp-density",
+				message: msg([
+					facts.skillName,
+					": stamp density ",
+					density.toFixed(1),
+					"/KB (rc/sha/date lines — log-like content)"
+				]),
+				count: hits
+			};
+		}
+	},
+	{
+		id: "body-without-support",
+		severity: "warn",
+		run: (facts) => facts.dims.supportGroups === 0 && facts.dims.bodyChars !== null && facts.dims.bodyChars >= facts.softLineChars / 2 ? {
+			severity: "warn",
+			rule: "body-without-support",
+			message: msg([
+				facts.skillName,
+				": large body (",
+				facts.dims.bodyChars,
+				" chars) with NO support files"
+			]),
+			count: 1
+		} : null
+	},
+	{
+		id: "references-sprawl",
+		severity: "warn",
+		run: (facts) => {
+			const files = facts.dims.supportFiles;
+			if (files === null || files < 60) return null;
+			return {
+				severity: "warn",
+				rule: "references-sprawl",
+				message: msg([
+					facts.skillName,
+					": ",
+					files,
+					" support files"
+				]),
+				count: files
+			};
+		}
+	},
+	{
+		id: "write-ghost",
+		severity: "warn",
+		run: (facts) => {
+			const patches = facts.dims.churnPatches;
+			const reads = facts.dims.churnReads;
+			if (patches === null || reads === null || patches < facts.churnMinPatches || reads > 0) return null;
+			return {
+				severity: "warn",
+				rule: "write-ghost",
+				message: msg([
+					facts.skillName,
+					": ",
+					patches,
+					" patch(es), never read"
+				]),
+				count: patches
+			};
+		}
+	}
+];
+function lintSkill(facts) {
+	const out = [];
+	for (const rule of RULES) {
+		const hit = rule.run(facts);
+		if (hit !== null) out.push(hit);
+	}
+	return out;
+}
+/** What a write introduced, what got worse, what got fixed. A rule whose count grew (one site to
+* nine) counts as worsened — comparing by rule name alone reported nothing. */
+function diffFindings(before, after) {
+	const beforeByRule = new Map(before.map((f) => [f.rule, f]));
+	const afterByRule = new Map(after.map((f) => [f.rule, f]));
+	return {
+		introduced: after.filter((f) => !beforeByRule.has(f.rule)),
+		worsened: after.filter((f) => {
+			const old = beforeByRule.get(f.rule);
+			return old !== void 0 && f.count > old.count;
+		}),
+		resolved: before.filter((f) => !afterByRule.has(f.rule)).map((f) => f.rule)
+	};
+}
+/** Support files = markdown files under references/ (contract §4: unit frozen, underscore-prefixed
+* excluded). Paths are supplied by the caller — this module never touches the filesystem. */
+function countReferenceFiles(paths) {
+	return paths.filter((p) => {
+		const n = p.replace(/\\/g, "/");
+		if (!(n.includes("/references/") || n.startsWith("references/")) || !n.endsWith(".md")) return false;
+		return !n.slice(n.lastIndexOf("/") + 1).startsWith("_");
+	}).length;
+}
+//#endregion
+//#region lib/types/health-baseline.js
+const DEFAULT_ADMISSION = {
+	minUserHitRate: .05,
+	maxUserHitRate: .25
+};
+function buildHealthBaseline(skills) {
+	const values = {};
+	for (const rule of RULES) values[rule.id] = {
+		platformHits: 0,
+		userHits: 0,
+		userHitRate: 0
+	};
+	let user = 0;
+	let platform = 0;
+	for (const skill of skills) {
+		if (skill.corpus === "user") user += 1;
+		else platform += 1;
+		for (const finding of lintSkill(skill.facts)) {
+			const row = values[finding.rule];
+			if (row === void 0) continue;
+			if (skill.corpus === "user") row.userHits += 1;
+			else row.platformHits += 1;
+		}
+	}
+	for (const row of Object.values(values)) row.userHitRate = user === 0 ? 0 : row.userHits / user;
+	return {
+		unit: "chars",
+		scope: "references markdown file count",
+		corpora: {
+			user,
+			platform
+		},
+		values
+	};
+}
+/** The admission verdict for ONE rule id (contract §4): platform corpus must not trip it, and the
+* user-library hit rate must land inside the band. Every failure names the number it failed on. */
+function admissionVerdict(baseline, ruleId, thresholds = DEFAULT_ADMISSION) {
+	const row = baseline.values[ruleId];
+	const failures = [];
+	if (row === void 0) return {
+		admitted: false,
+		failures: ["rule " + ruleId + " has no baseline row"]
+	};
+	if (baseline.corpora.platform === 0) failures.push("no platform-corpus skills measured — a vacuous 0-hit count admits any rule");
+	else if (row.platformHits !== 0) failures.push("platform corpus trips " + ruleId + " " + String(row.platformHits) + " time(s) — a rule the shipped library violates is unsatisfiable");
+	if (baseline.corpora.user === 0) failures.push("no user-library skills measured — a rate over an empty corpus proves nothing");
+	else if (row.userHitRate < thresholds.minUserHitRate) failures.push(ruleId + " hits " + row.userHitRate.toFixed(3) + " of the user library, below " + String(thresholds.minUserHitRate) + " — too rare to be worth a rule");
+	else if (row.userHitRate > thresholds.maxUserHitRate) failures.push(ruleId + " hits " + row.userHitRate.toFixed(3) + " of the user library, above " + String(thresholds.maxUserHitRate) + " — furniture, no signal");
+	return {
+		admitted: failures.length === 0,
+		failures
+	};
+}
+//#endregion
 //#region lib/types/guards.js
 /**
 * The family's plain-object predicate, in ONE place (v46 G7.1 / audit A8).
@@ -6671,13 +6885,35 @@ const HEALTH_STAMP_RE = new RegExp(String.raw`\brc\.\d+\b|\b(?=[0-9a-f]{7,40}\b)
 * warned on a perfectly healthy body (audit 2026-08-31 X1).
 */
 const MIN_STAMP_BODY_CHARS = 2e3;
+/**
+* The findings for ONE body, computed by the engine that owns the judgement (G4).
+*
+* Deliberately a thin call into `assessStructureHealth`: a later consumer (the write receipt) needs
+* findings for a body it is about to store, and re-deriving the facts anywhere else would be a
+* SECOND judgement — the token-scale line, the /1024 stamp density and the soft/2 support threshold
+* all live in one place and must stay there.
+* @param skillName - the skill the body belongs to (used in messages).
+* @param content - the WHOLE SKILL.md text, frontmatter included (the engine's own convention).
+* @param supportGroups - non-empty support dirs; pass the real count, never a guess.
+* @param thresholds - the configured thresholds; defaults to the shipped ones.
+* @returns the findings, in rule order.
+*/
+function lintBody(skillName, content, supportGroups, thresholds = DEFAULT_HEALTH_THRESHOLDS) {
+	return assessStructureHealth({
+		skillName,
+		bodyChars: content.length,
+		bodyText: content,
+		supportGroups
+	}, thresholds).findings;
+}
 function assessStructureHealth(snapshot, thresholds = DEFAULT_HEALTH_THRESHOLDS) {
-	const reasons = [];
 	const dims = {
 		bodyChars: snapshot.bodyChars,
 		bodyTokens: Math.round(snapshot.bodyChars / UPSTREAM_LIMIT_CHARS_PER_TOKEN),
 		stampDensityPerKb: null,
+		stampHits: null,
 		supportGroups: snapshot.supportGroups,
+		supportFiles: snapshot.supportFiles ?? null,
 		churnPatches: null,
 		churnReads: null
 	};
@@ -6687,25 +6923,30 @@ function assessStructureHealth(snapshot, thresholds = DEFAULT_HEALTH_THRESHOLDS)
 	dims.bodyTokens = cost === null ? Math.round(snapshot.bodyChars / UPSTREAM_LIMIT_CHARS_PER_TOKEN) : cost.tokens;
 	const overLine = cost === null || lineTokens === null ? snapshot.bodyChars >= thresholds.softBodyChars : cost.tokens >= lineTokens;
 	const overTwice = cost === null || lineTokens === null ? snapshot.bodyChars >= thresholds.softBodyChars * 2 : cost.tokens >= lineTokens * 2;
-	const scale = cost === null || lineTokens === null ? `${snapshot.bodyChars} chars` : `${cost.tokens} tokens (${snapshot.bodyChars} chars)`;
-	const lineText = cost === null || lineTokens === null ? `${thresholds.softBodyChars} chars` : `${thresholds.softBodyChars} chars = ${lineTokens} tokens`;
-	if (overTwice) reasons.push(`body ${scale} is >= 2x the soft line (${lineText}) — consider splitting or offloading`);
-	else if (overLine) reasons.push(`body ${scale} at or above the soft line (${lineText})`);
 	if (snapshot.bodyText && snapshot.bodyChars >= 2e3) {
 		const kb = Math.max(1, snapshot.bodyChars / 1024);
-		dims.stampDensityPerKb = (snapshot.bodyText.match(HEALTH_STAMP_RE) ?? []).length / kb;
-		if (dims.stampDensityPerKb >= thresholds.stampDensityPerKb) reasons.push(`stamp density ${dims.stampDensityPerKb.toFixed(1)}/KB (rc/sha/date lines — log-like content in the body)`);
+		const stamps = (snapshot.bodyText.match(HEALTH_STAMP_RE) ?? []).length;
+		dims.stampDensityPerKb = stamps / kb;
+		dims.stampHits = stamps;
 	}
-	if (snapshot.supportGroups === 0 && snapshot.bodyChars >= thresholds.softBodyChars / 2) reasons.push(`large body (${snapshot.bodyChars} chars) with NO support files — session detail may belong in references/`);
 	if (snapshot.patchCount !== void 0 && snapshot.readCount !== void 0) {
 		dims.churnPatches = snapshot.patchCount;
 		dims.churnReads = snapshot.readCount;
-		if (snapshot.patchCount >= thresholds.churnMinPatches && snapshot.readCount === 0) reasons.push(`patched ${snapshot.patchCount} times but never read (write-ghost — content may be dead)`);
 	}
+	const findings = lintSkill({
+		skillName: snapshot.skillName,
+		dims,
+		softLineChars: thresholds.softBodyChars,
+		overSoftLine: overLine,
+		overTwiceSoftLine: overTwice,
+		stampLimitPerKb: thresholds.stampDensityPerKb,
+		churnMinPatches: thresholds.churnMinPatches,
+		readable: true
+	});
 	return {
-		verdict: overTwice ? "needs-restructure" : reasons.length > 0 ? "warn" : "healthy",
+		verdict: findings.some((f) => f.rule === "body-oversize-2x") ? "needs-restructure" : findings.length > 0 ? "warn" : "healthy",
 		dims,
-		reasons
+		findings
 	};
 }
 //#endregion
@@ -7980,6 +8221,50 @@ function readingStats(full, shown) {
 		truncated: shown.length < full.length
 	};
 }
+/**
+* The H2 sections of a body, in document order — the ONE scan (G3).
+*
+* Both the restructure candidate list and the store anchor validation call this function, so a
+* candidate can only name a heading that exists EXACTLY ONCE and has content: the two rejections a
+* hand-written anchor used to hit ("no such heading", "ambiguous anchor") stop being reachable.
+* H2 is the section boundary (a section spans to the next H2 or EOF), matching the store.
+* @param body - the markdown after the frontmatter block.
+* @returns one row per H2 heading, with `count` filled in a second pass.
+*/
+function h2Sections(body) {
+	const lines = body.split(String.fromCharCode(10));
+	const rows = [];
+	for (let i = 0; i < lines.length; i += 1) {
+		const match = /^#{2}\s+(.+?)\s*$/.exec(lines[i] ?? "");
+		if (match === null) continue;
+		const title = (match[1] ?? "").trim();
+		let end = lines.length;
+		for (let j = i + 1; j < lines.length; j += 1) if (/^#{2}\s/.test(lines[j] ?? "")) {
+			end = j;
+			break;
+		}
+		rows.push({
+			title,
+			start: i,
+			end,
+			count: 0
+		});
+	}
+	for (const row of rows) row.count = rows.filter((other) => other.title === row.title).length;
+	return rows;
+}
+/**
+* The sections a restructure proposal may name: heading unique, section non-empty. Derived from
+* `h2Sections`, i.e. from the SAME scan the store validates against.
+* @param body - the markdown after the frontmatter block.
+* @returns move-ready pairs in document order; empty when nothing qualifies.
+*/
+function restructureCandidates(body) {
+	return h2Sections(body).filter((section) => section.count === 1 && section.end > section.start + 1).map((section) => ({
+		heading: section.title,
+		toFile: "references/" + section.title.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fa5]+/g, "-").replace(/^-+|-+$/g, "") + ".md"
+	}));
+}
 //#endregion
 //#region lib/types/drift-signals.js
 /**
@@ -9213,19 +9498,16 @@ function supportRefs(content) {
 }
 function planRestructureSections(body, moves) {
 	const lines = body.split("\n");
+	const sections = h2Sections(body);
 	const spans = [];
 	for (const move of moves) {
 		const wanted = move.heading.trim();
-		const starts = [];
-		for (let i = 0; i < lines.length; i += 1) if ((/^#{2}\s+(.+?)\s*$/.exec(lines[i] ?? "")?.[1]?.trim() ?? "") === wanted) starts.push(i);
-		const [start] = starts;
-		if (start === void 0) return { error: `no "## ${wanted}" heading in the body` };
-		if (starts.length > 1) return { error: `heading "## ${wanted}" appears ${starts.length} times (ambiguous anchor)` };
-		let end = lines.length;
-		for (let i = start + 1; i < lines.length; i += 1) if (/^#{2}\s/.test(lines[i] ?? "")) {
-			end = i;
-			break;
-		}
+		const matching = sections.filter((section) => section.title === wanted);
+		if (matching.length === 0) return { error: `no "## ${wanted}" heading in the body` };
+		if (matching.length > 1) return { error: `heading "## ${wanted}" appears ${matching.length} times (ambiguous anchor)` };
+		const section = matching[0];
+		if (section === void 0) return { error: `no "## ${wanted}" heading in the body` };
+		const { start, end } = section;
 		if (end === start + 1) return { error: `heading "## ${wanted}" has an empty section` };
 		if (spans.some((span) => start === span.start)) return { error: `heading "## ${wanted}" is moved twice` };
 		spans.push({
@@ -9572,6 +9854,32 @@ var SkillLibrary = class {
 		return await this.io.exists(markerPath(dir, "pinned"));
 	}
 	/** Count non-empty support subdirectories (richness input for quality scoring). */
+	/** G4 ⑤-d: the dangling targets THIS write introduced, as a receipt note (empty when none).
+	*
+	* Uses the SAME resolver as the drift signal, so a receipt and a drift row can never disagree;
+	* an absent or unknown listing reports nothing rather than inventing a dead link.
+	*/
+	async danglingNoteFor(skillName, before, after) {
+		try {
+			const listing = await this.listSupportFiles(skillName);
+			if (!isPresent(listing)) return "";
+			const files = listing.value;
+			const owner = "SKILL.md";
+			const seen = new Set(resolveCitations({
+				content: before,
+				file: owner,
+				files
+			}).dangling.map((ref) => ref.target ?? ref.raw));
+			const introduced = resolveCitations({
+				content: after,
+				file: owner,
+				files
+			}).dangling.map((ref) => ref.target ?? ref.raw).filter((target) => !seen.has(target));
+			return introduced.length > 0 ? " [dangling: " + introduced.join(",") + "]" : "";
+		} catch {
+			return "";
+		}
+	}
 	async countSupportDirs(rawName) {
 		const name = rawName.trim();
 		if (this.badName(name) !== null) return 0;
@@ -9697,7 +10005,7 @@ var SkillLibrary = class {
 	* mutation ledger that points at it. The history failure is not silent — a deployment whose
 	* history stopped growing is a degradation worth seeing once (the ledger keeps hashes either
 	* way). */
-	async audit(skillName, action, before, after, summary, path) {
+	async audit(skillName, action, before, after, summary, path, origin) {
 		const at = (/* @__PURE__ */ new Date()).toISOString();
 		let versions = null;
 		try {
@@ -9717,6 +10025,18 @@ var SkillLibrary = class {
 				console.warn(`skill-store: content history not recorded for "${skillName}" (${error instanceof Error ? error.message : String(error)}); the mutation itself landed and the audit ledger keeps its hashes`);
 			}
 		}
+		let healthNote = "";
+		const danglingNote = before === null || after === null || before === after ? "" : await this.danglingNoteFor(skillName, before, after);
+		if (before !== null && after !== null && before !== after) try {
+			const groups = await this.countSupportDirs(skillName);
+			const delta = diffFindings(lintBody(skillName, before, groups), lintBody(skillName, after, groups));
+			const parts = [];
+			if (delta.introduced.length > 0) parts.push("+" + delta.introduced.map((f) => f.rule).join(","));
+			if (delta.worsened.length > 0) parts.push("^" + delta.worsened.map((f) => f.rule + " x" + String(f.count)).join(","));
+			if (parts.length > 0) healthNote = " [health: " + parts.join(" ") + "]";
+		} catch {
+			healthNote = "";
+		}
 		try {
 			await recordMutation(this.root, this.io, {
 				skillName,
@@ -9725,8 +10045,9 @@ var SkillLibrary = class {
 				...after === null ? {} : { afterHash: contentHash(after) },
 				...versions?.beforeVersion === void 0 ? {} : { beforeVersion: versions.beforeVersion },
 				...versions?.afterVersion === void 0 ? {} : { afterVersion: versions.afterVersion },
-				summary,
-				at
+				summary: summary + healthNote + danglingNote,
+				at,
+				...origin === void 0 ? {} : { origin }
 			});
 		} catch {}
 	}
@@ -10844,7 +11165,7 @@ var SkillLibrary = class {
 		const skillMdWrite = landing.find((entry) => entry.target.split(/[\\/]/).pop() === "SKILL.md");
 		const auditedBefore = skillMdWrite === void 0 ? md : skillMdWrite.previous;
 		const auditedAfter = skillMdWrite === void 0 ? md : skillMdWrite.content;
-		await this.audit(name, plan.auditAction, auditedBefore, auditedAfter, plan.auditSummary);
+		await this.audit(name, plan.auditAction, auditedBefore, auditedAfter, plan.auditSummary, void 0, plan.origin);
 		this.notifyMutation({
 			action: plan.eventAction,
 			name,
@@ -13438,4 +13759,4 @@ function foldUntrustedLines(text, limit) {
 	return limit > 0 ? marked.slice(0, limit) : marked;
 }
 //#endregion
-export { AGENT_PRESET_PACKAGE, AGENT_PRESET_ROOT_HINT, AUTHORING_DESCRIPTION_BAR, AUTHORING_SPLIT_LINE_CHARS, BASELINE_ACTION, CITATION_SUPPORT_DIRS, COMBINED_REVIEW_PLAN_PROMPT, COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CONTENT_SPLIT_HINT, COST_ASCII_TOKEN_HIGH, COST_ASCII_TOKEN_LOW, COST_CJK_TOKEN_HIGH, COST_CJK_TOKEN_LOW, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEDUP_MAX_PAIR_COMPARISONS, DEDUP_SIMILARITY_THRESHOLD, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_ARCHIVE_RETENTION_POLICY, DEFAULT_CITATION_POLICY, DEFAULT_CITATION_REF_BUDGET, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MEMORY_REVIEW_MODEL, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_PROBE_TIMEOUT_MS, DEFAULT_REFERENCE_REWRITE_POLICY, DEFAULT_REVIEW_CONTEXT_MESSAGES, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_MESSAGE_CHARS, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_REVIEW_TIMEOUT_MS, DEFAULT_RUN_RECORDS, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_MODEL, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_SKILL_VERSION_KEEP, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_SUPPORT_FILE_CHAR_POLICY, DEFAULT_SUPPORT_READ_TOOL_NAMES, DEFAULT_THREAT_MAX_SCAN_CHARS, DEFAULT_USER_CHAR_LIMIT, DISPATCH_EVENT_TYPES, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, DSH_AUTHORING_STANDARDS, EMPTY_PATCH_SEED, ENTRY_DELIMITER, EVENT_ARCHIVE_PREFIX, EVENT_LOG_RETAIN_ARCHIVES, EVENT_LOG_ROTATE_AT, EVENT_LOG_VERSION, EVOLUTION_ERRORS, EVOLUTION_WRITE_TOOLS, EvolutionGateSet, FAMILY_SESSION_TOOL_NAMES, FORBIDDEN_CONTROL_KEYS, FUZZY_MAX_PATTERN_CHARS, FUZZY_MAX_WORK, HEALTH_STAMP_RE, HISTORY_DIR, HISTORY_INDEX_VERSION, HOOK_LINE_RE, INSTANCE_KEYS, KEEP_LINE_RE, LONG_RUNS, LOW_QUALITY_THRESHOLD, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MAX_DESCRIPTION_LENGTH, MAX_REQUEST_BODY_BYTES, MAX_RESTRUCTURE_MOVES, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MAX_SUPPORT_READ_PATHS, MAX_TIMER_DELAY_MS, MEMORY_GUIDANCE_SECTION_ORDER, MEMORY_REVIEW_PROMPT, MIN_STAMP_BODY_CHARS, MUTATIONS_FILE_VERSION, MemoryStore, NAMESPACE_MIGRATIONS, NATIVE_CALL_EVENT, NATIVE_RESULT_EVENT, PARAM_ALIASES, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PARAM_NAMESPACES, PATTERN_OVERLAP, PLATFORM_CATALOG_DESCRIPTION_DEFAULT, PLATFORM_ESTIMATE_CHARS_PER_TOKEN, PLATFORM_SERVICE_PROBES, POLICY_STAGE_DEFAULTS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, PTC_DISPATCH_EVENT, PTC_DISPATCH_START_EVENT, QUALITY_WEIGHTS, READ_REQUIRED_ACTIONS, RESTRUCTURE_TARGET_RE, RETENTION_FEEDBACK_KEEP_RATIO, RETENTION_FEEDBACK_MIN_CHARS, RUNS_SCHEMA_VERSION, SKILLS_GUIDANCE, SKILLS_GUIDANCE_SECTION_ORDER, SKILL_ACTION_REQUIRED_FIELDS, SKILL_NAME_RE, SKILL_REVIEW_PLAN_PROMPT, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUMMARY_DUPLICATE_HINT_THRESHOLD, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, TEXT_DIFF_MAX_CHARS, TEXT_DIFF_MAX_LINES, THREAT_EXEMPTION_HINT, TOKEN_ASCII_WEIGHT, TOKEN_CJK_WEIGHT, ToolDispatchNormalizer, ToolDispatchPayloadError, UNTRUSTED_LINE_BREAK, UNTRUSTED_LINE_MARK, UPSTREAM_LIMIT_CHARS_PER_TOKEN, VERSION_SUMMARY_MAX_CHARS, absentHostServices, advanceReview, affinity, ageCopyKey, allowRowCollisions, anchorVerdict, appendEvolutionEvent, applyCuratorLifecycleFields, applyCuratorMetaFields, applyNamespaceMigration, applyReferenceRewrite, asRecord, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, atomicWriteFiles, authoringFeedback, basePresetPlugins, blobPath, bodyCost, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampOnce, clampedNumber, classifyNamespaceMigration, clearReviewChannel, collectReadSkillNames, composePresetComposition, composePresetEntry, composePresetInsert, composePresetRow, compositionRowIds, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, contentRetentionFeedback, countDispatches, createGateSet, daysSinceIso, declaredReportStamp, denseBlockSequence, describeReferenceRewrite, dispatchKeyOf, dispatchStepOf, displayBodyOf, duplicateHeadings, elapsedSince, emptyRecord, entryTarget, errorText, evaluateThreat, eventsFile, evidenceKindIndex, evolutionActivityProjection, evolutionEventPayloadIssue, evolutionEvidenceProjection, evolutionHome, evolutionIoAdapter, evolutionReadsProjection, evolutionRoot, evolutionSignalsProjection, filterUnreadSkillOps, findDriftSignal, foldCuratorFields, foldToolDispatches, foldTurnEvent, foldTurnEvents, foldUntrustedLines, frontmatterBlock, frontmatterCatalogInvalid, fuzzyPatch, getRecord, historyIndexFile, historyRoot, identity, idleDays, initialTurnFold, installEvolutionProjections, instanceClaimKey, instanceClaimedWriteSites, instanceHolder, isAbsent, isBookkeepingFrame, isCommittedWarning, isDeprecatedParamId, isFileShapedPath, isLoopbackRequest, isMissingPath, isPresent, isProcessAlive, isProgramToolName, isRecord, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, isUnreadWrite, latestActivityAt, latestVersionAt, lifecycleCandidate, listDirectories, listEventArchives, liveBool, liveEnum, liveNumber, liveString, loadMutations, loadRowOverrides, loadSuppressedNames, loadUsage, loadVersionContent, loadVersions, makeSerialQueue, mapProbe, markAgentCreated, markReviewChannel, markerEntryName, memoryRoot, mergePresetRow, missingSupportPointers, mutateUsage, mutationsFile, narrowNameMatches, nearDuplicateSummaries, neutralizePromptVariables, newRunRegistry, newSkillLibrary, nextHistoryIndex, nodeEvolutionIo, normalizeFrontmatter, normalizeUsageRecord, normalizeVersionSummary, observeEvent, orderVersions, overlongLines, paramNamespace, paramRowId, paramSettingsId, parseCuratorNominations, parseEvolutionEvents, parseFrontmatter, parseHistoryIndex, partitionVersions, payloadText, persistedWriteSite, persistedWriteSites, pickWithPolicy, planNamespaceMigration, planReferenceRewrite, planRehoming, policyStageLimits, presetPatchText, presetRowBlock, presetRowBody, presetRowId, probeAbsent, probeDesktopScope, probeList, probeMtime, probePresent, probeReason, probeText, probeUnknown, projectionText, readDispatchSignal, readEvolutionEvents, readEvolutionTimeline, readHistoryIndex, readJsonBody, readJsonObject, readNumberParam, readParam, readingStats, recordMutation, recordVersions, redactSecrets, relatedSkillNames, releaseInstance, removePresetRow, renameWithRetry, renderCuratorReportMarkdown, renderLongRunTable, reportTime, reportsSweepLockTarget, resolveBasePresetPatch, resolveCitations, resolveExecOrigins, resolveOrigins, resolveParamId, resolveRootConfig, resolveSkillsRoot, retainEventArchives, retirementReport, reviewPrompt, rowBlockSpan, rowSiblingEnd, runsFile, saveSuppressedNames, saveUsage, scanBodyHooks, scanContentThreats, scanMemoryThreats, scanThreats, scopedProbeReport, sessionAudited, sessionEvidenceIndex, sessionLastEventTime, sessionReadNames, sessionReadSkillNames, sessionSeesFamilyTools, sessionTurnSignals, skillReadNameOf, skillRowCells, skillStateKey, skillsRoot, supportFileReadOf, suppressedFile, sweepReports, sweepReviewChannelSessions, textDiffFacts, tokenLineFor, transactIo, transactTaskGuard, trimPatternBoundaries, trimTrailingBlankLines, unhookedSupportPointers, unwrapLive, updateSuppressedNames, usageFile, usageObserved, userSetKeys, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, versionActionKind, versionRowCells, versionSummaryPrompt, versionTarget, vocabulary, writeDurableTmp, writeJson, writePathSymbols, yamlPlainScalarNeedsQuotes };
+export { AGENT_PRESET_PACKAGE, AGENT_PRESET_ROOT_HINT, AUTHORING_DESCRIPTION_BAR, AUTHORING_SPLIT_LINE_CHARS, BASELINE_ACTION, CITATION_SUPPORT_DIRS, COMBINED_REVIEW_PLAN_PROMPT, COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CONTENT_SPLIT_HINT, COST_ASCII_TOKEN_HIGH, COST_ASCII_TOKEN_LOW, COST_CJK_TOKEN_HIGH, COST_CJK_TOKEN_LOW, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEDUP_MAX_PAIR_COMPARISONS, DEDUP_SIMILARITY_THRESHOLD, DEFAULT_ADMISSION, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_ARCHIVE_RETENTION_POLICY, DEFAULT_CITATION_POLICY, DEFAULT_CITATION_REF_BUDGET, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MEMORY_REVIEW_MODEL, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_PROBE_TIMEOUT_MS, DEFAULT_REFERENCE_REWRITE_POLICY, DEFAULT_REVIEW_CONTEXT_MESSAGES, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_MESSAGE_CHARS, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_REVIEW_TIMEOUT_MS, DEFAULT_RUN_RECORDS, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_MODEL, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_SKILL_VERSION_KEEP, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_SUPPORT_FILE_CHAR_POLICY, DEFAULT_SUPPORT_READ_TOOL_NAMES, DEFAULT_THREAT_MAX_SCAN_CHARS, DEFAULT_USER_CHAR_LIMIT, DISPATCH_EVENT_TYPES, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, DSH_AUTHORING_STANDARDS, EMPTY_PATCH_SEED, ENTRY_DELIMITER, EVENT_ARCHIVE_PREFIX, EVENT_LOG_RETAIN_ARCHIVES, EVENT_LOG_ROTATE_AT, EVENT_LOG_VERSION, EVOLUTION_ERRORS, EVOLUTION_WRITE_TOOLS, EvolutionGateSet, FAMILY_SESSION_TOOL_NAMES, FORBIDDEN_CONTROL_KEYS, FUZZY_MAX_PATTERN_CHARS, FUZZY_MAX_WORK, HEALTH_STAMP_RE, HISTORY_DIR, HISTORY_INDEX_VERSION, HOOK_LINE_RE, INSTANCE_KEYS, KEEP_LINE_RE, LONG_RUNS, LOW_QUALITY_THRESHOLD, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MAX_DESCRIPTION_LENGTH, MAX_REQUEST_BODY_BYTES, MAX_RESTRUCTURE_MOVES, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MAX_SUPPORT_READ_PATHS, MAX_TIMER_DELAY_MS, MEMORY_GUIDANCE_SECTION_ORDER, MEMORY_REVIEW_PROMPT, MIN_STAMP_BODY_CHARS, MUTATIONS_FILE_VERSION, MemoryStore, NAMESPACE_MIGRATIONS, NATIVE_CALL_EVENT, NATIVE_RESULT_EVENT, PARAM_ALIASES, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PARAM_NAMESPACES, PATTERN_OVERLAP, PLATFORM_CATALOG_DESCRIPTION_DEFAULT, PLATFORM_ESTIMATE_CHARS_PER_TOKEN, PLATFORM_SERVICE_PROBES, POLICY_STAGE_DEFAULTS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, PTC_DISPATCH_EVENT, PTC_DISPATCH_START_EVENT, QUALITY_WEIGHTS, READ_REQUIRED_ACTIONS, RESTRUCTURE_TARGET_RE, RETENTION_FEEDBACK_KEEP_RATIO, RETENTION_FEEDBACK_MIN_CHARS, RULES, RUNS_SCHEMA_VERSION, SKILLS_GUIDANCE, SKILLS_GUIDANCE_SECTION_ORDER, SKILL_ACTION_REQUIRED_FIELDS, SKILL_NAME_RE, SKILL_REVIEW_PLAN_PROMPT, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUMMARY_DUPLICATE_HINT_THRESHOLD, SUPPORT_DIRS, SUPPORT_SPRAWL_FILES, SUPPRESSED_FILE_VERSION, SkillLibrary, TEXT_DIFF_MAX_CHARS, TEXT_DIFF_MAX_LINES, THREAT_EXEMPTION_HINT, TOKEN_ASCII_WEIGHT, TOKEN_CJK_WEIGHT, ToolDispatchNormalizer, ToolDispatchPayloadError, UNTRUSTED_LINE_BREAK, UNTRUSTED_LINE_MARK, UPSTREAM_LIMIT_CHARS_PER_TOKEN, VERSION_SUMMARY_MAX_CHARS, absentHostServices, admissionVerdict, advanceReview, affinity, ageCopyKey, allowRowCollisions, anchorVerdict, appendEvolutionEvent, applyCuratorLifecycleFields, applyCuratorMetaFields, applyNamespaceMigration, applyReferenceRewrite, asRecord, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, atomicWriteFiles, authoringFeedback, basePresetPlugins, blobPath, bodyCost, buildCuratorRunReport, buildHealthBaseline, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampOnce, clampedNumber, classifyNamespaceMigration, clearReviewChannel, collectReadSkillNames, composePresetComposition, composePresetEntry, composePresetInsert, composePresetRow, compositionRowIds, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, contentRetentionFeedback, countDispatches, countReferenceFiles, createGateSet, daysSinceIso, declaredReportStamp, denseBlockSequence, describeReferenceRewrite, diffFindings, dispatchKeyOf, dispatchStepOf, displayBodyOf, duplicateHeadings, elapsedSince, emptyRecord, entryTarget, errorText, evaluateThreat, eventsFile, evidenceKindIndex, evolutionActivityProjection, evolutionEventPayloadIssue, evolutionEvidenceProjection, evolutionHome, evolutionIoAdapter, evolutionReadsProjection, evolutionRoot, evolutionSignalsProjection, filterUnreadSkillOps, findDriftSignal, foldCuratorFields, foldToolDispatches, foldTurnEvent, foldTurnEvents, foldUntrustedLines, frontmatterBlock, frontmatterCatalogInvalid, fuzzyPatch, getRecord, h2Sections, historyIndexFile, historyRoot, identity, idleDays, initialTurnFold, installEvolutionProjections, instanceClaimKey, instanceClaimedWriteSites, instanceHolder, isAbsent, isBookkeepingFrame, isCommittedWarning, isDeprecatedParamId, isFileShapedPath, isLoopbackRequest, isMissingPath, isPresent, isProcessAlive, isProgramToolName, isRecord, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, isUnreadWrite, latestActivityAt, latestVersionAt, lifecycleCandidate, lintBody, lintSkill, listDirectories, listEventArchives, liveBool, liveEnum, liveNumber, liveString, loadMutations, loadRowOverrides, loadSuppressedNames, loadUsage, loadVersionContent, loadVersions, makeSerialQueue, mapProbe, markAgentCreated, markReviewChannel, markerEntryName, memoryRoot, mergePresetRow, missingSupportPointers, mutateUsage, mutationsFile, narrowNameMatches, nearDuplicateSummaries, neutralizePromptVariables, newRunRegistry, newSkillLibrary, nextHistoryIndex, nodeEvolutionIo, normalizeFrontmatter, normalizeUsageRecord, normalizeVersionSummary, observeEvent, orderVersions, overlongLines, paramNamespace, paramRowId, paramSettingsId, parseCuratorNominations, parseEvolutionEvents, parseFrontmatter, parseHistoryIndex, partitionVersions, payloadText, persistedWriteSite, persistedWriteSites, pickWithPolicy, planNamespaceMigration, planReferenceRewrite, planRehoming, policyStageLimits, presetPatchText, presetRowBlock, presetRowBody, presetRowId, probeAbsent, probeDesktopScope, probeList, probeMtime, probePresent, probeReason, probeText, probeUnknown, projectionText, readDispatchSignal, readEvolutionEvents, readEvolutionTimeline, readHistoryIndex, readJsonBody, readJsonObject, readNumberParam, readParam, readingStats, recordMutation, recordVersions, redactSecrets, relatedSkillNames, releaseInstance, removePresetRow, renameWithRetry, renderCuratorReportMarkdown, renderLongRunTable, reportTime, reportsSweepLockTarget, resolveBasePresetPatch, resolveCitations, resolveExecOrigins, resolveOrigins, resolveParamId, resolveRootConfig, resolveSkillsRoot, restructureCandidates, retainEventArchives, retirementReport, reviewPrompt, rowBlockSpan, rowSiblingEnd, runsFile, saveSuppressedNames, saveUsage, scanBodyHooks, scanContentThreats, scanMemoryThreats, scanThreats, scopedProbeReport, sessionAudited, sessionEvidenceIndex, sessionLastEventTime, sessionReadNames, sessionReadSkillNames, sessionSeesFamilyTools, sessionTurnSignals, skillReadNameOf, skillRowCells, skillStateKey, skillsRoot, supportFileReadOf, suppressedFile, sweepReports, sweepReviewChannelSessions, textDiffFacts, tokenLineFor, transactIo, transactTaskGuard, trimPatternBoundaries, trimTrailingBlankLines, unhookedSupportPointers, unwrapLive, updateSuppressedNames, usageFile, usageObserved, userSetKeys, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, versionActionKind, versionRowCells, versionSummaryPrompt, versionTarget, vocabulary, writeDurableTmp, writeJson, writePathSymbols, yamlPlainScalarNeedsQuotes };

package/lib/types/constants.d.ts

@@ -95,6 +95,13 @@ export declare const DEFAULT_CURATOR_INTERVAL_HOURS = 168;
 export declare const DEFAULT_MIN_IDLE_HOURS = 2;
 export declare const DEFAULT_STALE_AFTER_DAYS = 30;
 export declare const DEFAULT_ARCHIVE_AFTER_DAYS = 90;
+/**
+ * Support-file count above which `references-sprawl` warns. **NOT CALIBRATED YET** — 60 is a
+ * placeholder: the platform corpus is empty (no platform skills available here), so the admission
+ * band cannot be checked. Until `gen-health-baseline` reports both corpora, the rule is
+ * REPORT-ONLY: its count must not be shown as a number on any surface (plan G4 ③).
+ */
+export declare const SUPPORT_SPRAWL_FILES = 60;
 export declare const DEFAULT_MEMORY_CHAR_LIMIT = 2200;
 export declare const DEFAULT_USER_CHAR_LIMIT = 1375;
 /** Consolidation-failure backoff cap, shared by MemoryStore and memory-files' Config default. */

package/lib/types/document-body.d.ts

@@ -20,4 +20,37 @@ export interface ReadingStats {
  * @returns the counts, so the panel can say what it is not showing.
  */
 export declare function readingStats(full: string, shown: string): ReadingStats;
+/**
+ * One H2 section of a body: its title, its line span and how many times that title occurs.
+ * @property count - occurrences of `title` in the SAME body; a candidate list may only offer 1.
+ */
+export interface H2Section {
+    title: string;
+    start: number;
+    end: number;
+    count: number;
+}
+/**
+ * The H2 sections of a body, in document order — the ONE scan (G3).
+ *
+ * Both the restructure candidate list and the store anchor validation call this function, so a
+ * candidate can only name a heading that exists EXACTLY ONCE and has content: the two rejections a
+ * hand-written anchor used to hit ("no such heading", "ambiguous anchor") stop being reachable.
+ * H2 is the section boundary (a section spans to the next H2 or EOF), matching the store.
+ * @param body - the markdown after the frontmatter block.
+ * @returns one row per H2 heading, with `count` filled in a second pass.
+ */
+export declare function h2Sections(body: string): H2Section[];
+/** One move the panel can hand to `restructure` without the store refusing it. */
+export interface RestructureCandidate {
+    heading: string;
+    toFile: string;
+}
+/**
+ * The sections a restructure proposal may name: heading unique, section non-empty. Derived from
+ * `h2Sections`, i.e. from the SAME scan the store validates against.
+ * @param body - the markdown after the frontmatter block.
+ * @returns move-ready pairs in document order; empty when nothing qualifies.
+ */
+export declare function restructureCandidates(body: string): RestructureCandidate[];
 //# sourceMappingURL=document-body.d.ts.map

package/lib/types/health-baseline.d.ts

@@ -0,0 +1,37 @@
+import { type LintFacts } from './skill-lint.ts';
+export type Corpus = 'user' | 'platform';
+export interface CorpusSkill {
+    name: string;
+    corpus: Corpus;
+    facts: LintFacts;
+}
+export interface RuleAdmission {
+    platformHits: number;
+    userHits: number;
+    userHitRate: number;
+}
+export interface HealthBaseline {
+    /** Frozen unit and scope: a rate is only comparable when both are named (contract §4). */
+    unit: 'chars';
+    scope: 'references markdown file count';
+    corpora: {
+        user: number;
+        platform: number;
+    };
+    values: Record<string, RuleAdmission>;
+}
+export interface AdmissionThresholds {
+    /** A user-library hit rate below this is too rare to be worth a rule. */
+    minUserHitRate: number;
+    /** …and above this it is furniture (every skill trips it, so it carries no signal). */
+    maxUserHitRate: number;
+}
+export declare const DEFAULT_ADMISSION: AdmissionThresholds;
+export declare function buildHealthBaseline(skills: readonly CorpusSkill[]): HealthBaseline;
+/** The admission verdict for ONE rule id (contract §4): platform corpus must not trip it, and the
+ * user-library hit rate must land inside the band. Every failure names the number it failed on. */
+export declare function admissionVerdict(baseline: HealthBaseline, ruleId: string, thresholds?: AdmissionThresholds): {
+    admitted: boolean;
+    failures: string[];
+};
+//# sourceMappingURL=health-baseline.d.ts.map

package/lib/types/index.d.ts

@@ -34,6 +34,8 @@
 export * from './citations.ts';
 export * from './reference-rewrite.ts';
 export * from './cost.ts';
+export * from './skill-lint.ts';
+export * from './health-baseline.ts';
 export * from './curator.ts';
 export * from './evolution-events.ts';
 export * from './fuzzy-match.ts';

package/lib/types/mutations.d.ts

@@ -17,6 +17,9 @@ export interface MutationRecord {
     afterVersion?: number;
     summary: string;
     at: string;
+    /** G5: who caused this mutation — a write face ('foreground', 'background_review', …) or a
+     * migration step. Optional: records written before the ledger carried it stay readable. */
+    origin?: string;
 }
 export declare const DEFAULT_MUTATION_CAP = 500;
 /** Version of the `.mutations.json` file shape; writers always emit the current one. */

package/lib/types/skill-health.d.ts

@@ -9,6 +9,7 @@
  * stay in the review/curator judgment layer. Never become a 7th factor of
  * `computeQualityScores` (different dimension, different consumers).
  */
+import { type LintFinding } from './skill-lint.ts';
 export interface SkillHealthThresholds {
     /** Soft body limit: a body of `softBodyChars` or MORE -> 'warn'; >= 2x ->
      * 'needs-restructure'. V6-34 (0.3.37): the doc comment used to claim
@@ -60,6 +61,8 @@ interface SkillHealthSnapshot {
     bodyText?: string | undefined;
     /** Number of non-empty support groups (references/ templates/ scripts/). */
     supportGroups: number;
+    /** Support FILES under references/ (contract §4), when the caller counted them; null = not measured. */
+    supportFiles?: number | undefined;
     /** Usage-side patch count, when the caller has it (A2 churn dimension). */
     patchCount?: number | undefined;
     /** Usage-side view count, when the caller has it (A2 churn dimension). */
@@ -70,7 +73,11 @@ interface SkillHealthDim {
     /** The same body on the token scale (limit basis) — the judged quantity. */
     bodyTokens: number;
     stampDensityPerKb: number | null;
+    /** Raw stamp hits — the number the stamp rule reports as `count`. */
+    stampHits: number | null;
     supportGroups: number;
+    /** Support FILES under references/; null = the caller could not count them (never 0-as-unknown). */
+    supportFiles: number | null;
     /** Usage churn facts; null when the caller supplied no counts. */
     churnPatches: number | null;
     churnReads: number | null;
@@ -78,8 +85,23 @@ interface SkillHealthDim {
 export interface SkillHealthAssessment {
     verdict: SkillHealthVerdict;
     dims: SkillHealthDim;
-    reasons: string[];
+    /** The same judgement as `reasons`, in diffable form: (rule id, severity, count). G1. */
+    findings: LintFinding[];
 }
+/**
+ * The findings for ONE body, computed by the engine that owns the judgement (G4).
+ *
+ * Deliberately a thin call into `assessStructureHealth`: a later consumer (the write receipt) needs
+ * findings for a body it is about to store, and re-deriving the facts anywhere else would be a
+ * SECOND judgement — the token-scale line, the /1024 stamp density and the soft/2 support threshold
+ * all live in one place and must stay there.
+ * @param skillName - the skill the body belongs to (used in messages).
+ * @param content - the WHOLE SKILL.md text, frontmatter included (the engine's own convention).
+ * @param supportGroups - non-empty support dirs; pass the real count, never a guess.
+ * @param thresholds - the configured thresholds; defaults to the shipped ones.
+ * @returns the findings, in rule order.
+ */
+export declare function lintBody(skillName: string, content: string, supportGroups: number, thresholds?: SkillHealthThresholds): LintFinding[];
 export declare function assessStructureHealth(snapshot: SkillHealthSnapshot, thresholds?: SkillHealthThresholds): SkillHealthAssessment;
 export {};
 //# sourceMappingURL=skill-health.d.ts.map

package/lib/types/skill-lint.d.ts

@@ -0,0 +1,59 @@
+export type LintSeverity = 'warn' | 'error';
+export interface LintFinding {
+    severity: LintSeverity;
+    /** Stable rule id; findings are diffed by (rule, count), never by message text. */
+    rule: string;
+    message: string;
+    /** How many times the rule bit — a name-only comparison hid one site becoming nine. */
+    count: number;
+}
+/** Size facts the deciding engine already measured. `null` means NOT MEASURED, never fine: a rule
+ * that needs a missing fact stays silent rather than inventing a pass or a failure. */
+export interface SkillDims {
+    bodyChars: number | null;
+    bodyTokens: number | null;
+    stampDensityPerKb: number | null;
+    /** Support GROUPS (non-empty references/templates/scripts/assets dirs) — the old dimension. */
+    supportGroups: number;
+    /** Support FILES under references/ (contract §4), or null when the caller cannot count them. */
+    supportFiles: number | null;
+    /** Raw stamp hits behind `stampDensityPerKb` — the COUNT this rule reports (never a fixed 1). */
+    stampHits: number | null;
+    churnPatches: number | null;
+    churnReads: number | null;
+}
+/** The judgement itself, computed by `skill-health.ts` on its own scales; this module never
+ * recomputes it from raw numbers (that is exactly how a second set of thresholds appears). */
+export interface LintFacts {
+    skillName: string;
+    dims: SkillDims;
+    softLineChars: number;
+    overSoftLine: boolean;
+    overTwiceSoftLine: boolean;
+    stampLimitPerKb: number;
+    /** The engine's own churn threshold — the rule must use the SAME number, not a literal. */
+    churnMinPatches: number;
+    /** True when the caller could read the body at all. */
+    readable: boolean;
+}
+interface LintRule {
+    readonly id: string;
+    readonly severity: LintSeverity;
+    run(facts: LintFacts): LintFinding | null;
+}
+/** One rule yields AT MOST one finding (contract §3). `body-oversize-2x` is the only rule whose
+ * severity can escalate a verdict to needs-restructure. */
+export declare const RULES: readonly LintRule[];
+export declare function lintSkill(facts: LintFacts): LintFinding[];
+/** What a write introduced, what got worse, what got fixed. A rule whose count grew (one site to
+ * nine) counts as worsened — comparing by rule name alone reported nothing. */
+export declare function diffFindings(before: readonly LintFinding[], after: readonly LintFinding[]): {
+    introduced: LintFinding[];
+    worsened: LintFinding[];
+    resolved: string[];
+};
+/** Support files = markdown files under references/ (contract §4: unit frozen, underscore-prefixed
+ * excluded). Paths are supplied by the caller — this module never touches the filesystem. */
+export declare function countReferenceFiles(paths: readonly string[]): number;
+export {};
+//# sourceMappingURL=skill-lint.d.ts.map

package/lib/types/skill-store.d.ts

@@ -385,6 +385,12 @@ export declare class SkillLibrary {
     /** Whether the skill carries the pinned marker (the marker is the factual source; usage.pinned mirrors it). */
     isPinned(rawName: string): Promise<boolean>;
     /** Count non-empty support subdirectories (richness input for quality scoring). */
+    /** G4 ⑤-d: the dangling targets THIS write introduced, as a receipt note (empty when none).
+     *
+     * Uses the SAME resolver as the drift signal, so a receipt and a drift row can never disagree;
+     * an absent or unknown listing reports nothing rather than inventing a dead link.
+     */
+    private danglingNoteFor;
     countSupportDirs(rawName: string): Promise<number>;
     /**
      * Support-file paths (`references/x.md`) under SUPPORT_DIRS for one skill,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-core",
   "description": "Shared stores, prompts, signals and lifecycle logic for the dsh-evolution plugin family (community build)",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "publishConfig": {
     "access": "public"
   },