@lmzhen/dsh-evolution-core 0.20.0 → 0.22.0

package/lib/index.js

@@ -3485,35 +3485,6 @@ function clampedNumber(value, fallback, opts) {
 	if (max !== void 0 && value > max) return fallback;
 	return value;
 }
-/**
-* Clamp one numeric knob and warn ONCE per key.
-*
-* S2.9 (T3-10): `evolution-review` and `evolution-curator` each carried their own copy of this
-* helper — their own once-per-key set and their own message — so the two settings readers of ONE
-* policy row could drift apart. The logic lives here; each caller passes its own sink (and its own
-* package prefix). A live field is read at every use, so the warning cannot be per-read.
-*
-* @param warned - the keys this caller already warned about.
-* @param warn - the warning sink (each package prefixes its own name).
-* @param name - the config key, for the warning.
-* @param value - the value as supplied, or its volatile reference.
-* @param fallback - the package default a corrected value falls back to.
-* @param min - the smallest value the engine can act on.
-* @param max - the largest value the carrier can hold, when bounded.
-* @returns the value the engine may use.
-*/
-function clampOnce(warned, warn, name, value, fallback, min, max) {
-	const current = typeof value === "object" ? value.get() : value;
-	const result = clampedNumber(current, fallback, max === void 0 ? { min } : {
-		min,
-		max
-	});
-	if (current !== void 0 && result !== current && !warned.has(name)) {
-		warned.add(name);
-		warn(`${name} provided an invalid value; falling back to the default`);
-	}
-	return result;
-}
 //#endregion
 //#region lib/types/threats.js
 /**
@@ -6697,10 +6668,24 @@ const SERIALIZATIONS = [
 ];
 /** Parse + validate the table. A malformed table throws at import: a table the
 * gate cannot read must never degrade into "no declared write sites". */
-function parseSites(raw) {
-	if (!Array.isArray(raw)) throw new Error("evolution-core: persisted-write-inventory.json must be an array of sites");
+function parseTable(raw) {
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error("evolution-core: persisted-write-inventory.json must be an object with { symbols, sites }");
+	const table = raw;
+	if (table.symbols === null || typeof table.symbols !== "object" || Array.isArray(table.symbols)) throw new Error("evolution-core: persisted-write-inventory.json needs a symbols legend (the roots every path is written against)");
+	for (const [symbol, entry] of Object.entries(table.symbols)) {
+		const problems = [];
+		if (!symbol.startsWith("<") || !symbol.endsWith(">")) problems.push("symbol name (must be <name>)");
+		if (entry === null || typeof entry !== "object") problems.push("entry");
+		else {
+			const symbolEntry = entry;
+			if (typeof symbolEntry.resolver !== "string" || symbolEntry.resolver === "") problems.push("resolver");
+			if (symbolEntry.segments !== void 0 && (!Array.isArray(symbolEntry.segments) || symbolEntry.segments.some((segment) => typeof segment !== "string"))) problems.push("segments");
+		}
+		if (problems.length > 0) throw new Error(`evolution-core: persisted-write-inventory.json symbol ${symbol} is malformed (missing/invalid: ${problems.join(", ")})`);
+	}
+	if (!Array.isArray(table.sites)) throw new Error("evolution-core: persisted-write-inventory.json needs a sites array");
 	const sites = [];
-	for (const [index, entry] of raw.entries()) {
+	for (const [index, entry] of table.sites.entries()) {
 		const site = entry;
 		const problems = [];
 		if (typeof site.id !== "string" || site.id === "") problems.push("id");
@@ -6723,7 +6708,10 @@ function parseSites(raw) {
 		});
 	}
 	if (new Set(sites.map((site) => site.id)).size !== sites.length) throw new Error("evolution-core: persisted-write-inventory.json declares duplicate site ids");
-	return sites;
+	return {
+		symbols: table.symbols,
+		sites
+	};
 }
 /** Instance keys held by writer services — the single source shared by the
 * claim site and the inventory row that declares it (rule N20 checks the row's
@@ -6732,6 +6720,7 @@ const INSTANCE_KEYS = {
 /** The per-home curator: report writing + the retention sweep. */
 curator: "evolution-curator" };
 let cachedSites;
+let cachedSymbols;
 /**
 * The declared persisted write sites, in file order.
 *
@@ -6755,8 +6744,17 @@ function persistedWriteSites() {
 		const cause = error instanceof Error ? error.message : String(error);
 		throw new Error(`evolution-core: persisted-write-inventory.json is unreadable (${cause}) — the package asset is missing or was not shipped; the write-inventory rules cannot be evaluated without it`);
 	}
-	cachedSites = parseSites(JSON.parse(raw));
-	return cachedSites;
+	const table = parseTable(JSON.parse(raw));
+	cachedSites = table.sites;
+	cachedSymbols = table.symbols;
+	return table.sites;
+}
+/** The inventory's symbol legend — the roots every declared path is written against, with the
+* segments the gate checks against the resolver's source.
+* @internal no production caller — the gates read the JSON asset directly. */
+function writePathSymbols() {
+	persistedWriteSites();
+	return cachedSymbols ?? {};
 }
 /** Sites serialized by the per-home instance claim, with their instance keys.
 * @internal S2.4 (PLAN 2026-09-16): no production caller — the arch guard
@@ -11860,7 +11858,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每累计多少次工具调用检查一次技能：一轮按该轮工具调用数累加（一轮没有工具调用也算 1 次），本轮本身用到技能则只算 1 次。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewMemoryInterval",
@@ -11875,7 +11874,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每累计多少次工具调用检查一次记忆：一轮按该轮工具调用数累加（一轮没有工具调用也算 1 次），本轮本身用到记忆则只算 1 次。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "skillReviewTrigger",
@@ -11891,7 +11891,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "cadence|completion|both",
-		valueLabels: "按间隔|按任务完成|两者"
+		valueLabels: "按间隔|按任务完成|两者",
+		card: "evolution-review"
 	},
 	{
 		id: "skillReviewCompletionMinToolCalls",
@@ -11906,7 +11907,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "选「按任务完成」时，任务至少用了几次工具才检查。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewEnabled",
@@ -11921,7 +11923,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "关闭后不再自动回顾会话。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewMode",
@@ -11937,7 +11940,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "subagent|inject",
-		valueLabels: "交给子代理|在当前会话里"
+		valueLabels: "交给子代理|在当前会话里",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewWakeInject",
@@ -11952,7 +11956,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "会话空闲时，把延后的检查结果作为一条提醒发给你。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewProvider",
@@ -11962,7 +11967,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "LLM provider for review subagents (deployment identity)."
+		summary: "LLM provider for review subagents (deployment identity).",
+		why: "identity"
 	},
 	{
 		id: "reviewTimeoutMs",
@@ -11972,7 +11978,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Bound on one review subagent run and its write leg."
+		summary: "Bound on one review subagent run and its write leg.",
+		why: "internal"
 	},
 	{
 		id: "reviewContextMessages",
@@ -11982,7 +11989,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Messages of context handed to a review subagent."
+		summary: "Messages of context handed to a review subagent.",
+		why: "internal"
 	},
 	{
 		id: "reviewMessageChars",
@@ -11992,7 +12000,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Per-message character budget of the review context."
+		summary: "Per-message character budget of the review context.",
+		why: "internal"
 	},
 	{
 		id: "reviewMaxDepth",
@@ -12002,7 +12011,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Absolute delegation-depth cap of the review subagent."
+		summary: "Absolute delegation-depth cap of the review subagent.",
+		why: "internal"
 	},
 	{
 		id: "reviewToolAllow",
@@ -12012,7 +12022,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Tools the review subagent may use (safety surface)."
+		summary: "Tools the review subagent may use (safety surface).",
+		why: "security"
 	},
 	{
 		id: "skillContentChars",
@@ -12027,7 +12038,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能 Markdown 正文最多多少字符（只能调小）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "maxSkillFileBytes",
@@ -12042,7 +12054,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能附带文件单个最大多少字节（只能调小）。",
 		control: "number",
 		unit: "字节",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "maxSkillNameLength",
@@ -12057,7 +12070,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能名最多多少字符（只能调小）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "maxDescriptionLength",
@@ -12072,7 +12086,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能描述最多多少字符（只能调小）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "descriptionStrict",
@@ -12087,7 +12102,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "描述不符合要求时直接拒绝写入（默认只提醒）。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "strictCrossSource",
@@ -12102,7 +12118,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能引用了本插件之外的文件时拒绝写入。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "citationPolicy",
@@ -12118,7 +12135,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "verify|refuse",
-		valueLabels: "先检查|直接拒绝"
+		valueLabels: "先检查|直接拒绝",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "referenceRewrite",
@@ -12128,7 +12146,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Re-home support files and rewrite references during a merge (plan or apply)."
+		summary: "Re-home support files and rewrite references during a merge (plan or apply).",
+		why: "internal"
 	},
 	{
 		id: "archiveRetention",
@@ -12138,7 +12157,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Report expired archives, or prune them."
+		summary: "Report expired archives, or prune them.",
+		why: "internal"
 	},
 	{
 		id: "skillVersionKeep",
@@ -12148,7 +12168,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Content versions retained per skill; older ones leave the index. Their stored blobs stay on disk — no automatic sweep exists yet, so a long-lived library grows by the distinct bodies it has written."
+		summary: "Content versions retained per skill; older ones leave the index. Their stored blobs stay on disk — no automatic sweep exists yet, so a long-lived library grows by the distinct bodies it has written.",
+		why: "internal"
 	},
 	{
 		id: "supportFileCharPolicy",
@@ -12164,7 +12185,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "report|enforce",
-		valueLabels: "只提醒|拒绝写入"
+		valueLabels: "只提醒|拒绝写入",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "skillWriteConfirm",
@@ -12180,7 +12202,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "auto|ask|timeout",
-		valueLabels: "不弹窗直接写入|一直等待回答|超时自动取消"
+		valueLabels: "不弹窗直接写入|一直等待回答|超时自动取消",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "skillWriteConfirmTimeoutSeconds",
@@ -12195,7 +12218,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "选「超时自动取消」时，等多少秒没人回答就取消这次写入。",
 		control: "number",
 		unit: "秒",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "memoryChars",
@@ -12210,7 +12234,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "长期记忆文件（MEMORY.md）最多多少字符。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "userChars",
@@ -12225,7 +12250,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "用户画像文件（USER.md）最多多少字符。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "memoryEnabled",
@@ -12235,7 +12261,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-memory",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Register the memory tool and its prompt section at all (deployment switch)."
+		summary: "Register the memory tool and its prompt section at all (deployment switch).",
+		why: "deployment"
 	},
 	{
 		id: "entryPreviewChars",
@@ -12250,7 +12277,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "列表里每条记忆最多显示多少字符。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-memory"
 	},
 	{
 		id: "addDatePrefix",
@@ -12265,7 +12293,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "写入时在条目开头加上日期。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "maxConsolidationFailures",
@@ -12280,7 +12309,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "合并记忆连续失败多少次后停止。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "curatorIntervalHours",
@@ -12295,7 +12325,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "两次自动整理之间至少间隔多少小时。",
 		control: "number",
 		unit: "小时",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "staleAfterDays",
@@ -12310,7 +12341,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能连续多少天没被用到就算过时。",
 		control: "number",
 		unit: "天",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "archiveAfterDays",
@@ -12325,22 +12357,19 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "过时技能再过多少天移入归档（不能小于上一项）。",
 		control: "number",
 		unit: "天",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "qualityWarnStaleAfterDays",
 		group: "curator",
-		tier: "E3",
+		tier: "E2",
 		authority: "cordis",
 		owner: "evolution-curator",
-		applies: "live",
+		applies: "none",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Age at which a low quality score starts warning.",
-		label: "质量偏低提醒",
-		hint: "质量评分偏低时，从多少天开始提醒。",
-		control: "number",
-		unit: "天",
-		values: ""
+		summary: "Age at which a low quality score starts warning (the pair of evolution-feedback.qualityWarnThreshold; both live on the deployment face so one bar is not half user-set).",
+		why: "internal"
 	},
 	{
 		id: "minIdleHours",
@@ -12355,7 +12384,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "你至少多少小时没用，才运行自动整理。",
 		control: "number",
 		unit: "小时",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "minIdleFailOpen",
@@ -12370,7 +12400,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "无法判断你是否空闲时，仍然运行自动整理。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "llmReview",
@@ -12385,7 +12416,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "在固定规则之外，再用模型挑一遍候选项。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "curatorReviewMaxTokens",
@@ -12400,7 +12432,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每次用模型挑选时最多消耗多少 token。",
 		control: "number",
 		unit: "token",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "curatorReviewTimeoutMs",
@@ -12415,7 +12448,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "一次模型挑选最长允许运行多久。",
 		control: "number",
 		unit: "毫秒",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "healthSoftBodyChars",
@@ -12430,7 +12464,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能正文超过多少字符算偏长（只用于健康提示）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "healthStampDensityPerKb",
@@ -12445,7 +12480,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每 KB 出现多少个时间标记，就判为「像日志」。",
 		control: "number",
 		unit: "处/KB",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "healthChurnMinPatches",
@@ -12460,7 +12496,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "连续多少次改动都没有被读取，就判为「只写不读」。",
 		control: "number",
 		unit: "处",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "evolution-curator.enabled",
@@ -12470,7 +12507,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Mount the curator plugin at all."
+		summary: "Mount the curator plugin at all.",
+		why: "deployment"
 	},
 	{
 		id: "autoStart",
@@ -12480,7 +12518,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Arm the hourly due-ness tick with the plugin."
+		summary: "Arm the hourly due-ness tick with the plugin — the STARTUP default only; at runtime /evolution curator pause or resume overrides it (the override is persisted in curation state and wins until cleared). Off keeps curation manual.",
+		why: "deployment"
 	},
 	{
 		id: "bootGraceSeconds",
@@ -12490,7 +12529,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Grace period before the first automatic pass after a restart."
+		summary: "Grace period before the first automatic pass after a restart.",
+		why: "internal"
 	},
 	{
 		id: "curatorProvider",
@@ -12500,7 +12540,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "LLM provider for curator reviews (deployment identity)."
+		summary: "LLM provider for curator reviews (deployment identity).",
+		why: "identity"
 	},
 	{
 		id: "curatorModel",
@@ -12510,7 +12551,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Model for curator reviews (deployment identity)."
+		summary: "Model for curator reviews (deployment identity).",
+		why: "identity"
 	},
 	{
 		id: "protectedSkillNames",
@@ -12520,7 +12562,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Skills the lifecycle never archives or rewrites."
+		summary: "Skills the lifecycle never archives or rewrites.",
+		why: "deployment"
 	},
 	{
 		id: "manageUnmanaged",
@@ -12530,7 +12573,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Let curation touch skills with no family metadata."
+		summary: "Let curation touch skills with no family metadata.",
+		why: "deployment"
 	},
 	{
 		id: "pruneBuiltins",
@@ -12540,7 +12584,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Let curation nominate bundled skills for pruning."
+		summary: "Let curation nominate bundled skills for pruning.",
+		why: "deployment"
 	},
 	{
 		id: "referencedSkillNames",
@@ -12550,7 +12595,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Names treated as referenced by external docs (never retired)."
+		summary: "Names treated as referenced by external docs (never retired).",
+		why: "deployment"
 	},
 	{
 		id: "includeSkillNames",
@@ -12560,7 +12606,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-skill-catalog",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Allow-list of skills the catalog exposes."
+		summary: "Allow-list of skills the catalog exposes.",
+		why: "deployment"
 	},
 	{
 		id: "skill-catalog.excludeSkillNames",
@@ -12570,7 +12617,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-skill-catalog",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Deny-list of skills the catalog hides (row-local name; see the collision note)."
+		summary: "Deny-list of skills the catalog hides (row-local name; see the collision note).",
+		why: "deployment"
 	},
 	{
 		id: "modelInvocable",
@@ -12580,7 +12628,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-skill-catalog",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Default for whether the model may invoke a catalog skill."
+		summary: "Default for whether the model may invoke a catalog skill.",
+		why: "deployment"
 	},
 	{
 		id: "userInvocable",
@@ -12590,7 +12639,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-skill-catalog",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Default for whether the user may invoke a catalog skill."
+		summary: "Default for whether the user may invoke a catalog skill.",
+		why: "deployment"
 	},
 	{
 		id: "maxItems",
@@ -12600,7 +12650,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-activity",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Entries kept in the activity sidecar window."
+		summary: "Entries kept in the activity sidecar window.",
+		why: "internal"
 	},
 	{
 		id: "sessionScoped",
@@ -12610,7 +12661,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Act only on sessions carrying the family model tools."
+		summary: "Act only on sessions carrying the family model tools.",
+		why: "deployment"
 	},
 	{
 		id: "skill-usage.sessionScoped",
@@ -12620,7 +12672,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "skill-usage",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#library",
-		summary: "Keep the usage sidecar scoped per session (row-local name)."
+		summary: "Keep the usage sidecar scoped per session (row-local name).",
+		why: "deployment"
 	},
 	{
 		id: "evolution-review.root",
@@ -12630,7 +12683,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Skill-tree root for review-created skills (empty = shared default)."
+		summary: "Skill-tree root for review-created skills (empty = shared default).",
+		why: "path"
 	},
 	{
 		id: "evolution-review.skillsRoot",
@@ -12640,7 +12694,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Retired alias of root; a value here fails the load (V27 G2.4)."
+		summary: "Retired alias of root; a value here fails the load (V27 G2.4).",
+		why: "path"
 	},
 	{
 		id: "evolution-curator.root",
@@ -12650,7 +12705,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Skill-tree root for curator scope, snapshot and archive."
+		summary: "Skill-tree root for curator scope, snapshot and archive.",
+		why: "path"
 	},
 	{
 		id: "evolution-commands.root",
@@ -12660,7 +12716,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-commands",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Skill-tree root the command surface writes through."
+		summary: "Skill-tree root the command surface writes through.",
+		why: "path"
 	},
 	{
 		id: "evolution-commands.skillsRoot",
@@ -12670,7 +12727,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-commands",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Retired alias of the commands root; a value here fails the load."
+		summary: "Retired alias of the commands root; a value here fails the load.",
+		why: "path"
 	},
 	{
 		id: "evolution-maintenance.root",
@@ -12680,7 +12738,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-maintenance",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Skill-tree root the maintenance probe scans."
+		summary: "Skill-tree root the maintenance probe scans.",
+		why: "path"
 	},
 	{
 		id: "evolution-maintenance.skillsRoot",
@@ -12690,7 +12749,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-maintenance",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Accepted skill-root spelling for the maintenance row."
+		summary: "Accepted skill-root spelling for the maintenance row.",
+		why: "path"
 	},
 	{
 		id: "evolution-skill-catalog.root",
@@ -12700,7 +12760,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-skill-catalog",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Skill-tree root the catalog lists."
+		summary: "Skill-tree root the catalog lists.",
+		why: "path"
 	},
 	{
 		id: "evolution-learning-graph.root",
@@ -12710,7 +12771,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-learning-graph",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Skill-tree root the learning graph reads."
+		summary: "Skill-tree root the learning graph reads.",
+		why: "path"
 	},
 	{
 		id: "skill-usage.root",
@@ -12720,7 +12782,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "skill-usage",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Skill-tree root the usage store observes."
+		summary: "Skill-tree root the usage store observes.",
+		why: "path"
 	},
 	{
 		id: "skill-usage.eventsHome",
@@ -12730,7 +12793,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "skill-usage",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Directory holding the family event log the usage store reads."
+		summary: "Directory holding the family event log the usage store reads.",
+		why: "path"
 	},
 	{
 		id: "evolution-state-json.root",
@@ -12740,7 +12804,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-state-json",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Directory holding the JSON state store."
+		summary: "Directory holding the JSON state store.",
+		why: "path"
 	},
 	{
 		id: "memory-files.root",
@@ -12750,7 +12815,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Directory holding MEMORY.md and USER.md (empty = $DSH_HOME/memories)."
+		summary: "Directory holding MEMORY.md and USER.md (empty = $DSH_HOME/memories).",
+		why: "path"
 	},
 	{
 		id: "evolution-feedback.path",
@@ -12760,7 +12826,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-feedback",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Event log the feedback scorer reads (empty = family events file)."
+		summary: "Event log the feedback scorer reads (empty = family events file).",
+		why: "path"
 	},
 	{
 		id: "evolution-state.provider",
@@ -12770,7 +12837,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-state",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Registered state-store provider name."
+		summary: "Registered state-store provider name.",
+		why: "identity"
 	},
 	{
 		id: "memory.provider",
@@ -12780,7 +12848,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Registered memory provider name."
+		summary: "Registered memory provider name.",
+		why: "identity"
 	},
 	{
 		id: "memory-files.providerName",
@@ -12790,7 +12859,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Name this package registers as the memory provider."
+		summary: "Name this package registers as the memory provider.",
+		why: "identity"
 	},
 	{
 		id: "memoryReviewModel",
@@ -12800,7 +12870,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Model for the memory review channel (deployment identity)."
+		summary: "Model for the memory review channel (deployment identity).",
+		why: "identity"
 	},
 	{
 		id: "skillReviewModel",
@@ -12810,7 +12881,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Model for the skill review channel (deployment identity)."
+		summary: "Model for the skill review channel (deployment identity).",
+		why: "identity"
 	},
 	{
 		id: "maxOpsPerPlan",
@@ -12820,7 +12892,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-plan-validator",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Operation cap one staged plan may carry."
+		summary: "Operation cap one staged plan may carry.",
+		why: "internal"
 	},
 	{
 		id: "substantiveMinToolCalls",
@@ -12830,7 +12903,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Tool calls that make a turn count as substantive."
+		summary: "Tool calls that make a turn count as substantive.",
+		why: "internal"
 	},
 	{
 		id: "substantiveMinUserChars",
@@ -12840,7 +12914,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "User characters that make a turn count as substantive."
+		summary: "User characters that make a turn count as substantive.",
+		why: "internal"
 	},
 	{
 		id: "substantiveMinAgentChars",
@@ -12850,7 +12925,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Assistant characters that make a turn count as substantive."
+		summary: "Assistant characters that make a turn count as substantive.",
+		why: "internal"
 	},
 	{
 		id: "threatExemptLabels",
@@ -12860,7 +12936,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-threat",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Threat labels the deployment declares benign (safety surface, never user-writable)."
+		summary: "Threat labels the deployment declares benign (safety surface, never user-writable).",
+		why: "security"
 	},
 	{
 		id: "evolution-threat.enabled",
@@ -12870,7 +12947,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-threat",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Mount the write-time threat guard at all."
+		summary: "Mount the write-time threat guard at all.",
+		why: "security"
 	},
 	{
 		id: "evolution-threat.maxScanChars",
@@ -12880,7 +12958,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-threat",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Scan window size of the threat guard."
+		summary: "Scan window size of the threat guard.",
+		why: "security"
 	},
 	{
 		id: "evolution-approval.enabled",
@@ -12890,7 +12969,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-approval",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Require approval before a staged write executes."
+		summary: "Require approval before a staged write executes.",
+		why: "security"
 	},
 	{
 		id: "evolution-approval.stageForeground",
@@ -12900,7 +12980,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-approval",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Stage foreground agent writes for approval too."
+		summary: "Stage foreground agent writes for approval too.",
+		why: "security"
 	},
 	{
 		id: "evolution-approval.pendingTtlMs",
@@ -12915,7 +12996,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "一条待批写入最多等多久：超时就按「拒绝」关掉（不会执行，写效果不会落地）；0 = 永不过期（默认）。",
 		control: "number",
 		unit: "毫秒",
-		values: ""
+		values: "",
+		card: "evolution-approval"
 	},
 	{
 		id: "qualityWarnThreshold",
@@ -12925,7 +13007,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-feedback",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Feedback score below which a skill carries a warning."
+		summary: "Feedback score below which a skill carries a warning.",
+		why: "internal"
 	},
 	{
 		id: "replay.maxPlans",
@@ -12935,7 +13018,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-replay",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Plans compared in one replay report."
+		summary: "Plans compared in one replay report.",
+		why: "internal"
 	},
 	{
 		id: "replay.weights",
@@ -12945,7 +13029,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-replay",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Scoring weights of the replay comparison."
+		summary: "Scoring weights of the replay comparison.",
+		why: "internal"
 	},
 	{
 		id: "evolution-commands.maintainCooldownMs",
@@ -12955,17 +13040,24 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-commands",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Cooldown between maintenance runs from the command surface."
+		summary: "Cooldown between maintenance runs from the command surface.",
+		why: "internal"
 	},
 	{
 		id: "evolution-commands.maintainHandoffOnSettle",
 		group: "deployment",
-		tier: "E2",
+		tier: "E3",
 		authority: "cordis",
 		owner: "evolution-commands",
-		applies: "none",
+		applies: "live",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Hand the maintenance report to the model automatically once a scan settles successfully (the same injection as maintain handoff); off by default — enabling it costs one extra model call per successful run."
+		summary: "Hand the maintenance report to the model automatically once a scan settles successfully (the same injection as maintain handoff); off by default — enabling it costs one extra model call per successful run.",
+		label: "扫描完成后自动交接",
+		hint: "维护扫描成功结束后，自动把报告交给模型（等同 maintain handoff）；默认关闭，每次成功扫描会多花一次模型调用。",
+		control: "switch",
+		unit: "",
+		values: "",
+		card: "evolution-commands"
 	},
 	{
 		id: "evolution-commands.maintainTimeoutMs",
@@ -12975,7 +13067,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-commands",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Timeout of one maintenance run started from the command surface."
+		summary: "Timeout of one maintenance run started from the command surface.",
+		why: "internal"
 	},
 	{
 		id: "evolution-maintenance.probeTimeoutMs",
@@ -12985,7 +13078,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-maintenance",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Model-facing budget of one maintenance_probe call — a hang guard, not a latency budget."
+		summary: "Model-facing budget of one maintenance_probe call — a hang guard, not a latency budget.",
+		why: "internal"
 	},
 	{
 		id: "skill-usage.supportReadToolNames",
@@ -12995,7 +13089,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "skill-usage",
 		applies: "none",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Tool names whose file reads are attributed to support files."
+		summary: "Tool names whose file reads are attributed to support files.",
+		why: "internal"
 	},
 	{
 		id: "install.mode",
@@ -13005,7 +13100,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "scripts",
 		applies: "restart",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Install target plane (values host / agent / layered / oneclick; the `layered` form uses the generated preset, the others mount the bundle at profile root)."
+		summary: "Install target plane (values host / agent / layered / oneclick; the `layered` form uses the generated preset, the others mount the bundle at profile root).",
+		why: "install"
 	},
 	{
 		id: "install.basePreset",
@@ -13015,7 +13111,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "scripts",
 		applies: "restart",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Agent-preset base the layered install composes from (--base)."
+		summary: "Agent-preset base the layered install composes from (--base).",
+		why: "install"
 	},
 	{
 		id: "install.home",
@@ -13025,7 +13122,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "scripts",
 		applies: "restart",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Harness home the installer writes into (--home)."
+		summary: "Harness home the installer writes into (--home).",
+		why: "install"
 	},
 	{
 		id: "install.presetRowOverrides",
@@ -13035,7 +13133,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "scripts",
 		applies: "restart",
 		docAnchor: "PARAMETERS.md#deployment",
-		summary: "Preset row overrides the installer injects (row-overrides.json)."
+		summary: "Preset row overrides the installer injects (row-overrides.json).",
+		why: "install"
 	}
 ]);
 /** The settings namespace each OWNER PACKAGE registers (design §7.2).
@@ -13050,7 +13149,9 @@ const PARAM_NAMESPACES = Object.freeze({
 	"memory-files": "evolution-memory",
 	"tool-memory": "evolution-tool-memory",
 	"evolution-curator": "evolution-curator",
-	"tool-skill-manage": "evolution-skills"
+	"tool-skill-manage": "evolution-skills",
+	"evolution-approval": "evolution-approval",
+	"evolution-commands": "evolution-commands"
 });
 /**
 * The rows whose settings namespace CHANGED with the platform-line move (G3): the
@@ -13340,6 +13441,114 @@ async function applyNamespaceMigration(plan, deps) {
 	};
 }
 //#endregion
+//#region lib/types/live.js
+/**
+* The family's ONE live-config reader.
+*
+* A config field reaches a plugin in two shapes: the platform's schema parser turns a
+* `.volatile()` declaration into a live reference (`{ get() }`, routed through cosmokit's
+* `createVolatile`), while a hand-built or pre-parse config carries the plain value. Reading a
+* live reference as if it were a value is SILENT (a boolean compare is simply never true, a
+* number folds as NaN) — so the two shapes are unwrapped in exactly one place here, and every
+* reader below goes through it.
+*
+* This module owns no policy: clamping semantics stay in `clampedNumber` (numeric.ts), and the
+* once-per-key warning text/rhythm is the one `clampOnce` has always had (it moved here so the
+* read happens in one place; callers import it from the package barrel, so the move is invisible).
+*
+* @module @lmzhen/dsh-evolution-core
+*/
+/**
+* Unwrap a live reference; return a plain value unchanged. The ONLY place that decides the shape.
+*
+* The discriminant is `typeof get === 'function'` rather than a bare `typeof value === 'object'`: a
+* config field may legitimately carry an object (a policy record), and calling `.get()` on that
+* used to throw where a plain read was meant.
+*
+* @param value - the field as supplied: live reference, plain value, or absent.
+* @returns the plain value, or `undefined` when the reference/field is absent.
+*/
+function unwrapLive(value) {
+	const raw = value;
+	if (typeof raw !== "object" || raw === null) return raw === void 0 ? void 0 : raw;
+	const candidate = raw;
+	return typeof candidate.get === "function" ? candidate.get.call(raw) : raw;
+}
+/**
+* Read a numeric knob (live or plain) and clamp it, warning ONCE per key.
+*
+* @param value - the field as supplied: live reference, plain value, or absent.
+* @param fallback - the package default an invalid value falls back to.
+* @param opts - bounds plus the optional warning triple.
+* @returns the value the engine may use.
+*/
+function liveNumber(value, fallback, opts = {}) {
+	const current = unwrapLive(value);
+	const { min, max } = opts;
+	const result = clampedNumber(current, fallback, min === void 0 ? max === void 0 ? void 0 : { max } : max === void 0 ? { min } : {
+		min,
+		max
+	});
+	const name = opts.name;
+	if (current !== void 0 && result !== current && name !== void 0 && opts.warn !== void 0) {
+		const warned = opts.warned ?? /* @__PURE__ */ new Set();
+		if (!warned.has(name)) {
+			warned.add(name);
+			opts.warn(`${name} provided an invalid value; falling back to the default`);
+		}
+	}
+	return result;
+}
+/**
+* Clamp one numeric knob and warn ONCE per key — the pre-0.22 signature, kept as a thin adapter so
+* existing callers migrate one at a time instead of in one commit.
+*
+* @param warned - the keys this caller already warned about.
+* @param warn - the warning sink (each package prefixes its own name).
+* @param name - the config key, for the warning.
+* @param value - the value as supplied, or its live reference.
+* @param fallback - the package default a corrected value falls back to.
+* @param min - the smallest value the engine can act on.
+* @param max - the largest value the carrier can hold, when bounded.
+* @returns the value the engine may use.
+*/
+function clampOnce(warned, warn, name, value, fallback, min, max) {
+	return liveNumber(value, fallback, {
+		min,
+		...max === void 0 ? {} : { max },
+		warned,
+		warn,
+		name
+	});
+}
+/**
+* Read a boolean flag (live or plain). Absent ⇒ `fallback` (default `false`).
+*
+* The boolean counterpart of {@link liveNumber}: `value === true` is never true for a live
+* reference, which is the silent failure this reader exists to prevent.
+*/
+function liveBool(value, fallback = false) {
+	return unwrapLive(value) ?? fallback;
+}
+/**
+* Read a string (live or plain). Blank/whitespace counts as unset — the same rule `evolutionRoot` uses
+* for `DSH_HOME`.
+*/
+function liveString(value, fallback) {
+	const current = unwrapLive(value)?.trim();
+	return current === void 0 || current.length === 0 ? fallback : current;
+}
+/**
+* Read an enumerated string (live or plain); a value outside `allowed` falls back.
+*
+* Used for the mode-like knobs (review mode, trigger, citation policy, write-confirm mode) where a
+* bare `?? default` would accept a typo the schema never saw.
+*/
+function liveEnum(value, allowed, fallback) {
+	const current = unwrapLive(value);
+	return current !== void 0 && allowed.includes(current) ? current : fallback;
+}
+//#endregion
 //#region lib/types/opt-in.js
 /**
 * Tool names only a session that mounted the family's MODEL rows can see.
@@ -13480,4 +13689,4 @@ function foldUntrustedLines(text, limit) {
 	return limit > 0 ? marked.slice(0, limit) : marked;
 }
 //#endregion
-export { AGENT_PRESET_PACKAGE, AGENT_PRESET_ROOT_HINT, ALIVE_LOCK_TAKEOVER_MS, 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, DEAD_LOCK_TAKEOVER_MS, 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_LOCK_TAKEOVER_MS, 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, LOCK_BODY_RE, LOCK_SUFFIX, LOCK_TEAR_TAKEOVER_MS, LONG_RUNS, LOW_QUALITY_THRESHOLD, LostWriteLock, 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, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, authoringFeedback, basePresetPlugins, blobPath, bodyCost, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampOnce, clampedNumber, classifyNamespaceMigration, clearReviewChannel, collectReadSkillNames, composePresetComposition, composePresetEntry, composePresetInsert, composePresetRow, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, contentRetentionFeedback, countDispatches, createGateSet, daysSinceIso, decideTakeover, declaredReportStamp, 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, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, isUnreadWrite, latestActivityAt, latestVersionAt, lifecycleCandidate, listEventArchives, 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, parseLockBody, partitionVersions, payloadText, pendingSelfCleanup, persistedWriteSite, persistedWriteSites, pickWithPolicy, planNamespaceMigration, planReferenceRewrite, planRehoming, policyStageLimits, presetPatchText, presetRowBlock, presetRowBody, presetRowId, probeAbsent, 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, 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, unhookedSupportPointers, updateSuppressedNames, usageFile, usageObserved, userSetKeys, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, versionActionKind, versionRowCells, versionSummaryPrompt, versionTarget, vocabulary, writeDurableTmp, writeJson, yamlPlainScalarNeedsQuotes };
+export { AGENT_PRESET_PACKAGE, AGENT_PRESET_ROOT_HINT, ALIVE_LOCK_TAKEOVER_MS, 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, DEAD_LOCK_TAKEOVER_MS, 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_LOCK_TAKEOVER_MS, 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, LOCK_BODY_RE, LOCK_SUFFIX, LOCK_TEAR_TAKEOVER_MS, LONG_RUNS, LOW_QUALITY_THRESHOLD, LostWriteLock, 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, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, authoringFeedback, basePresetPlugins, blobPath, bodyCost, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampOnce, clampedNumber, classifyNamespaceMigration, clearReviewChannel, collectReadSkillNames, composePresetComposition, composePresetEntry, composePresetInsert, composePresetRow, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, contentRetentionFeedback, countDispatches, createGateSet, daysSinceIso, decideTakeover, declaredReportStamp, 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, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, isUnreadWrite, latestActivityAt, latestVersionAt, lifecycleCandidate, 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, parseLockBody, partitionVersions, payloadText, pendingSelfCleanup, persistedWriteSite, persistedWriteSites, pickWithPolicy, planNamespaceMigration, planReferenceRewrite, planRehoming, policyStageLimits, presetPatchText, presetRowBlock, presetRowBody, presetRowId, probeAbsent, 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, 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, unhookedSupportPointers, unwrapLive, updateSuppressedNames, usageFile, usageObserved, userSetKeys, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, versionActionKind, versionRowCells, versionSummaryPrompt, versionTarget, vocabulary, writeDurableTmp, writeJson, writePathSymbols, yamlPlainScalarNeedsQuotes };