@lmzhen/dsh-evolution-core 0.19.3 → 0.21.0

package/lib/index.js

@@ -3271,7 +3271,7 @@ const EVOLUTION_ERRORS = Object.freeze({
 	"e-301-approval-service-not-mounted-2": "E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.",
 	"e-304-the-mounted-approval-service": "E-304: the mounted approval service predates the release capability — reject the record instead.",
 	"e-302-curator-service-not-mounted": "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.",
-	"e-305-the-invocation-agent-exposes": "E-305: the invocation agent exposes neither `followup` nor `inject` — this learn request has no delivery channel.",
+	"e-305-the-invocation-agent-exposes": "E-305: the invocation agent exposes neither `followup` nor `inject` — %a1% has no delivery channel.",
 	"e-306-this-deployment-stages-foreground-2": "E-306: this deployment stages foreground writes, but this invocation carries no agent session — `/evolution restructure` would stage a record with no session attribution. Run it from a session in the GUI or the CLI, or set `stageForeground: false` on the evolution-approval row, then repeat the command.",
 	"e-303-replay-service-not-mounted": "E-303: replay service not mounted. Next: mount the evolution-replay row (evolution-host/evolution-all) and run /evolution doctor.",
 	"e-307-the-settings-service-could": "E-307: the settings service could not report its sections (%a1%). /evolution params needs the user layer to tell an override from a deployment value; run /evolution doctor to see which services are mounted.",
@@ -11860,7 +11860,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每累计多少次工具调用检查一次技能：一轮按该轮工具调用数累加（一轮没有工具调用也算 1 次），本轮本身用到技能则只算 1 次。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewMemoryInterval",
@@ -11875,7 +11876,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每累计多少次工具调用检查一次记忆：一轮按该轮工具调用数累加（一轮没有工具调用也算 1 次），本轮本身用到记忆则只算 1 次。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "skillReviewTrigger",
@@ -11891,7 +11893,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "cadence|completion|both",
-		valueLabels: "按间隔|按任务完成|两者"
+		valueLabels: "按间隔|按任务完成|两者",
+		card: "evolution-review"
 	},
 	{
 		id: "skillReviewCompletionMinToolCalls",
@@ -11906,7 +11909,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "选「按任务完成」时，任务至少用了几次工具才检查。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewEnabled",
@@ -11921,7 +11925,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "关闭后不再自动回顾会话。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewMode",
@@ -11937,7 +11942,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "subagent|inject",
-		valueLabels: "交给子代理|在当前会话里"
+		valueLabels: "交给子代理|在当前会话里",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewWakeInject",
@@ -11952,7 +11958,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "会话空闲时，把延后的检查结果作为一条提醒发给你。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-review"
 	},
 	{
 		id: "reviewProvider",
@@ -11962,7 +11969,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 +11980,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 +11991,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 +12002,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 +12013,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 +12024,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 +12040,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能 Markdown 正文最多多少字符（只能调小）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "maxSkillFileBytes",
@@ -12042,7 +12056,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能附带文件单个最大多少字节（只能调小）。",
 		control: "number",
 		unit: "字节",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "maxSkillNameLength",
@@ -12057,7 +12072,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能名最多多少字符（只能调小）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "maxDescriptionLength",
@@ -12072,7 +12088,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能描述最多多少字符（只能调小）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "descriptionStrict",
@@ -12087,7 +12104,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "描述不符合要求时直接拒绝写入（默认只提醒）。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "strictCrossSource",
@@ -12102,7 +12120,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能引用了本插件之外的文件时拒绝写入。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "citationPolicy",
@@ -12118,7 +12137,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "verify|refuse",
-		valueLabels: "先检查|直接拒绝"
+		valueLabels: "先检查|直接拒绝",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "referenceRewrite",
@@ -12128,7 +12148,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 +12159,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 +12170,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 +12187,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "report|enforce",
-		valueLabels: "只提醒|拒绝写入"
+		valueLabels: "只提醒|拒绝写入",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "skillWriteConfirm",
@@ -12180,7 +12204,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		control: "select",
 		unit: "",
 		values: "auto|ask|timeout",
-		valueLabels: "不弹窗直接写入|一直等待回答|超时自动取消"
+		valueLabels: "不弹窗直接写入|一直等待回答|超时自动取消",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "skillWriteConfirmTimeoutSeconds",
@@ -12195,7 +12220,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "选「超时自动取消」时，等多少秒没人回答就取消这次写入。",
 		control: "number",
 		unit: "秒",
-		values: ""
+		values: "",
+		card: "tool-skill-manage"
 	},
 	{
 		id: "memoryChars",
@@ -12210,7 +12236,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "长期记忆文件（MEMORY.md）最多多少字符。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "userChars",
@@ -12225,7 +12252,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "用户画像文件（USER.md）最多多少字符。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "memoryEnabled",
@@ -12235,7 +12263,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 +12279,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "列表里每条记忆最多显示多少字符。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "tool-memory"
 	},
 	{
 		id: "addDatePrefix",
@@ -12265,7 +12295,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "写入时在条目开头加上日期。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "maxConsolidationFailures",
@@ -12280,7 +12311,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "合并记忆连续失败多少次后停止。",
 		control: "number",
 		unit: "次",
-		values: ""
+		values: "",
+		card: "memory-files"
 	},
 	{
 		id: "curatorIntervalHours",
@@ -12295,7 +12327,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "两次自动整理之间至少间隔多少小时。",
 		control: "number",
 		unit: "小时",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "staleAfterDays",
@@ -12310,7 +12343,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能连续多少天没被用到就算过时。",
 		control: "number",
 		unit: "天",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "archiveAfterDays",
@@ -12325,22 +12359,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 +12386,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "你至少多少小时没用，才运行自动整理。",
 		control: "number",
 		unit: "小时",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "minIdleFailOpen",
@@ -12370,7 +12402,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "无法判断你是否空闲时，仍然运行自动整理。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "llmReview",
@@ -12385,7 +12418,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "在固定规则之外，再用模型挑一遍候选项。",
 		control: "switch",
 		unit: "",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "curatorReviewMaxTokens",
@@ -12400,7 +12434,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每次用模型挑选时最多消耗多少 token。",
 		control: "number",
 		unit: "token",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "curatorReviewTimeoutMs",
@@ -12415,7 +12450,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "一次模型挑选最长允许运行多久。",
 		control: "number",
 		unit: "毫秒",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "healthSoftBodyChars",
@@ -12430,7 +12466,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "技能正文超过多少字符算偏长（只用于健康提示）。",
 		control: "number",
 		unit: "字符",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "healthStampDensityPerKb",
@@ -12445,7 +12482,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "每 KB 出现多少个时间标记，就判为「像日志」。",
 		control: "number",
 		unit: "处/KB",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "healthChurnMinPatches",
@@ -12460,7 +12498,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "连续多少次改动都没有被读取，就判为「只写不读」。",
 		control: "number",
 		unit: "处",
-		values: ""
+		values: "",
+		card: "evolution-curator"
 	},
 	{
 		id: "evolution-curator.enabled",
@@ -12470,7 +12509,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 +12520,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 +12531,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 +12542,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 +12553,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 +12564,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 +12575,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 +12586,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 +12597,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 +12608,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 +12619,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 +12630,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 +12641,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 +12652,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 +12663,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 +12674,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 +12685,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 +12696,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 +12707,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 +12718,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 +12729,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 +12740,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 +12751,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 +12762,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 +12773,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 +12784,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 +12795,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 +12806,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 +12817,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 +12828,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 +12839,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 +12850,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 +12861,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 +12872,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 +12883,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 +12894,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 +12905,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 +12916,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 +12927,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 +12938,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 +12949,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 +12960,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 +12971,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 +12982,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 +12998,8 @@ const PARAM_EXPOSURE = Object.freeze([
 		hint: "一条待批写入最多等多久：超时就按「拒绝」关掉（不会执行，写效果不会落地）；0 = 永不过期（默认）。",
 		control: "number",
 		unit: "毫秒",
-		values: ""
+		values: "",
+		card: "evolution-approval"
 	},
 	{
 		id: "qualityWarnThreshold",
@@ -12925,7 +13009,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 +13020,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 +13031,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,7 +13042,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: "E3",
+		authority: "cordis",
+		owner: "evolution-commands",
+		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.",
+		label: "扫描完成后自动交接",
+		hint: "维护扫描成功结束后，自动把报告交给模型（等同 maintain handoff）；默认关闭，每次成功扫描会多花一次模型调用。",
+		control: "switch",
+		unit: "",
+		values: "",
+		card: "evolution-commands"
 	},
 	{
 		id: "evolution-commands.maintainTimeoutMs",
@@ -12965,7 +13069,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",
@@ -12975,7 +13080,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",
@@ -12985,7 +13091,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",
@@ -12995,7 +13102,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",
@@ -13005,7 +13113,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",
@@ -13015,7 +13124,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",
@@ -13025,7 +13135,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).
@@ -13040,7 +13151,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

package/lib/types/errors.d.ts

@@ -18,7 +18,7 @@ export declare const EVOLUTION_ERRORS: Readonly<{
     readonly 'e-301-approval-service-not-mounted-2': "E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.";
     readonly 'e-304-the-mounted-approval-service': "E-304: the mounted approval service predates the release capability — reject the record instead.";
     readonly 'e-302-curator-service-not-mounted': "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.";
-    readonly 'e-305-the-invocation-agent-exposes': "E-305: the invocation agent exposes neither `followup` nor `inject` — this learn request has no delivery channel.";
+    readonly 'e-305-the-invocation-agent-exposes': "E-305: the invocation agent exposes neither `followup` nor `inject` — %a1% has no delivery channel.";
     readonly 'e-306-this-deployment-stages-foreground-2': "E-306: this deployment stages foreground writes, but this invocation carries no agent session — `/evolution restructure` would stage a record with no session attribution. Run it from a session in the GUI or the CLI, or set `stageForeground: false` on the evolution-approval row, then repeat the command.";
     readonly 'e-303-replay-service-not-mounted': "E-303: replay service not mounted. Next: mount the evolution-replay row (evolution-host/evolution-all) and run /evolution doctor.";
     readonly 'e-307-the-settings-service-could': "E-307: the settings service could not report its sections (%a1%). /evolution params needs the user layer to tell an override from a deployment value; run /evolution doctor to see which services are mounted.";

package/lib/types/params.d.ts

@@ -42,7 +42,12 @@ export declare function canonicalWriteId(id: string): string;
  * @returns the canonical value when present, else the alias value, else undefined.
  */
 export declare function readParam(carrier: object | undefined, id: string): unknown;
-/** Exposure group (design §7.2): the unit a developer changes together. */
+/** Exposure group (design §7.2): the unit a developer changes together.
+ *
+ * A DOC-SECTION axis, not the exposure decision: the group says which family of knobs a value
+ * belongs to, the tier says who may change it. `internal` here is a group id with no rows today;
+ * the `why: 'internal'` a non-E3 row carries is a different value on the other axis (the reason it
+ * has no settings card) — the shared spelling is a coincidence, not a routing rule. */
 export type ParamGroup = 'library' | 'write-caps' | 'review' | 'memory' | 'curator' | 'deployment' | 'internal';
 /**
  * Chinese display name per group, one entry per line (the scripts read this block
@@ -80,6 +85,12 @@ export type ParamAuthority = 'code' | 'cordis' | 'install';
  * those values for display, one label per value, in the same order. The stored
  * value is never translated: only what the control shows.
  */
+/** Why a parameter has NO settings card (the `why` half of the exposure key, 0.21.0 / G2).
+ * `internal` = timeouts, retries, cooldowns, weights, caps and windows; `deployment` = mount
+ * switches and library-scope policy; `security` = safety surfaces (never user-writable);
+ * `identity` = providers/models/registered names; `path` = per-row directories; `install` = what
+ * the installer freezes. Exactly one of `card`/`why` rides every row, and the tier decides which. */
+export type ParamWhy = 'deployment' | 'security' | 'identity' | 'path' | 'install' | 'internal';
 export interface ParamExposure {
     id: string;
     group: ParamGroup;
@@ -95,6 +106,12 @@ export interface ParamExposure {
     hint?: string;
     /** Which control the card renders for this field. Required on E3 rows. */
     control?: 'number' | 'switch' | 'select' | 'text';
+    /** The settings card this row appears on — its OWN row id (the platform keys a card by the Loader
+     * entry id, and a card may only render its own row's Config). Required on E3 rows. */
+    card?: string;
+    /** The registered reason this row has NO card. Required on every non-E3 row; mutually exclusive
+     * with `card`. This is what makes "an E3 row that no card renders" unspellable. */
+    why?: ParamWhy;
     /** Unit suffix shown next to a number (empty when it carries none). */
     unit?: string;
     /** Pipe-joined allowed values; non-empty exactly when control is 'select'. */

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.19.3",
+  "version": "0.21.0",
   "publishConfig": {
     "access": "public"
   },