@lmzhen/dsh-evolution-core 0.6.1 → 0.8.0

package/lib/index.js

@@ -2965,6 +2965,53 @@ function allowRowCollisions(env = process.env) {
 	return env.DSH_EVOLUTION_ALLOW_ROW_COLLISIONS === ALLOW_ROW_COLLISIONS;
 }
 //#endregion
+//#region lib/types/errors.js
+/**
+* THE error-code table: E-301…E-316 with the exact text each one emits.
+*
+* The codes used to be spelled out at 33 call sites across two packages, so one
+* code's wording could drift between the branches that answer it and nothing could
+* see the drift. Keys name the SCENARIO rather than the code, because a code
+* legitimately carries more than one text (E-301 answers pending / approve / reject
+* with different guidance); the code still leads every string, so model- and
+* user-facing output is unchanged. Interpolations are written `%aN%` and filled by
+* `errorText` from the values the call site used to interpolate inline.
+* @module @lmzhen/dsh-evolution-core
+*/
+const EVOLUTION_ERRORS = Object.freeze({
+	"e-305-this-invocation-carries-no": "E-305: this invocation carries no agent — `%a1%` needs a session-backed call (run it from a session in the GUI or the CLI).",
+	"e-306-this-deployment-stages-foreground": "E-306: this deployment stages foreground writes, but `/evolution %a1%` is not replayable through the skill runner — there is nothing to stage. Run it from a session whose approval policy is 'never', or set `stageForeground: false` on the evolution-approval row, then repeat the command.",
+	"e-301-approval-service-not-mounted": "E-301: approval service not mounted — pending writes cannot be listed or replayed. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.",
+	"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-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.",
+	"e-308-unknown-parameter-group-group": "E-308: unknown parameter group \"%a1%\" — known groups: %a2%.",
+	"e-311-no-settings-service-is": "E-311: no settings service is mounted, so there is no user layer to write. Mount the settings row (packages/settings/settings-file) and retry; this command never edits cordis.yml — a deployment value belongs to the deployment. /evolution doctor lists the mounted services.",
+	"e-312-error-instanceof-Error-error": "E-312: %a1% — /evolution params lists the canonical ids.",
+	"e-313-unknown-parameter-id-evolution": "E-313: unknown parameter \"%a1%\" — /evolution params lists every registered id with its tier and user layer.",
+	"e-314-id-is-a-deployment": "E-314: \"%a1%\" is a deployment parameter (tier %a2%, owner %a3%) — it is written in cordis.yml on its plugin or policy row, not from a session. /evolution params shows who may write each row.",
+	"e-315-id-has-no-user": "E-315: \"%a1%\" has no user layer — owner %a2% publishes no settings namespace, so the value stays with the deployment.",
+	"e-307-the-settings-service-could-2": "E-307: the settings service could not report its sections (%a1%). /evolution policy set needs the current revision to write safely; run /evolution doctor to see which services are mounted.",
+	"e-316-namespace-namespace-is-not": "E-316: namespace \"%a1%\" is not registered — owner %a2% is not mounted in this composition, so its parameters cannot be written from here. /evolution params marks those rows 'unregistered'.",
+	"e-309-revision-conflict-you-sent": "E-309: revision conflict — you sent %a1%, the document stands at %a2%. Re-read with /evolution params --json and retry.",
+	"e-309-revision-conflict-message-Re": "E-309: revision conflict — %a1%. Re-read with /evolution params --json and retry.",
+	"e-310-the-settings-service-refused": "E-310: the settings service refused the write: %a1% — the owning plugin's rule stands (a cross-field pair, or a cap that may only be tightened). /evolution params shows the current value.",
+	"e-305-this-invocation-carries-no-2": "E-305: this invocation carries no agent — `%a1%` needs a session-backed call (run it from a session in the GUI or the CLI)."
+});
+/**
+* Render one table entry, substituting its interpolation slots.
+* @param id - the scenario key.
+* @param args - values for the entry's `%aN%` slots.
+* @returns the message text the call site used to spell out inline.
+*/
+function errorText(id, args = {}) {
+	return EVOLUTION_ERRORS[id].replace(/%a(\d+)%/g, (_match, n) => String(args["a" + n] ?? ""));
+}
+//#endregion
 //#region lib/types/learn-prompt.js
 /**
 * Open-ended `/evolution learn` prompt builder.
@@ -8923,7 +8970,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Activity units between skill-review injections."
+		summary: "Activity units between skill-review injections.",
+		label: "技能审查间隔",
+		hint: "每多少活动单位触发一次技能审查注入。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "reviewMemoryInterval",
@@ -8933,7 +8985,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Activity units between memory-review injections."
+		summary: "Activity units between memory-review injections.",
+		label: "记忆审查间隔",
+		hint: "每多少活动单位触发一次记忆审查注入。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "skillReviewTrigger",
@@ -8943,7 +9000,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Which channel may inject a skill review (cadence, completion, both)."
+		summary: "Which channel may inject a skill review (cadence, completion, both).",
+		label: "审查触发通道",
+		hint: "哪个通道可以注入技能审查：cadence＝按间隔、completion＝按完成、both＝两者。",
+		control: "select",
+		unit: "",
+		values: "cadence|completion|both"
 	},
 	{
 		id: "skillReviewCompletionMinToolCalls",
@@ -8953,7 +9015,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Tool calls a task needs before the completion channel injects."
+		summary: "Tool calls a task needs before the completion channel injects.",
+		label: "完成通道最少工具调用",
+		hint: "走完成通道时，任务至少经过多少次工具调用才注入。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "reviewEnabled",
@@ -8963,7 +9030,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Master switch for the review plugin."
+		summary: "Master switch for the review plugin.",
+		label: "启用审查插件",
+		hint: "审查插件的总开关。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "reviewMode",
@@ -8973,7 +9045,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Run the review in the parent session (inject) or on a subagent."
+		summary: "Run the review in the parent session (inject) or on a subagent.",
+		label: "审查运行方式",
+		hint: "inject＝在父会话内注入，subagent＝交给子代理运行。",
+		control: "select",
+		unit: "",
+		values: "subagent|inject"
 	},
 	{
 		id: "reviewWakeInject",
@@ -8983,7 +9060,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Deliver the deferred review as a waking follow-up message."
+		summary: "Deliver the deferred review as a waking follow-up message.",
+		label: "审查后续唤醒注入",
+		hint: "把延后的审查作为唤醒消息投递。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "reviewProvider",
@@ -9053,7 +9135,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Character cap on a SKILL.md body (tighten-only)."
+		summary: "Character cap on a SKILL.md body (tighten-only).",
+		label: "SKILL.md 正文字符上限",
+		hint: "SKILL.md 正文的字符上限（只许收紧）。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "maxSkillFileBytes",
@@ -9063,7 +9150,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Byte cap on one support file (tighten-only)."
+		summary: "Byte cap on one support file (tighten-only).",
+		label: "支持文件字节上限",
+		hint: "单个支持文件的字节上限（只许收紧）。",
+		control: "number",
+		unit: "字节",
+		values: ""
 	},
 	{
 		id: "maxSkillNameLength",
@@ -9073,7 +9165,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Character cap on a skill name (tighten-only)."
+		summary: "Character cap on a skill name (tighten-only).",
+		label: "技能名字符上限",
+		hint: "技能名的字符上限（只许收紧）。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "maxDescriptionLength",
@@ -9083,7 +9180,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Character cap on a skill description (tighten-only)."
+		summary: "Character cap on a skill description (tighten-only).",
+		label: "技能描述字符上限",
+		hint: "技能描述的字符上限（只许收紧）。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "descriptionStrict",
@@ -9093,7 +9195,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Refuse a description over the authoring bar instead of advising."
+		summary: "Refuse a description over the authoring bar instead of advising.",
+		label: "描述严格档",
+		hint: "描述超过写作门槛时拒绝写入，而不是只提示。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "strictCrossSource",
@@ -9103,7 +9210,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Refuse writes whose catalog entry resolves outside the family."
+		summary: "Refuse writes whose catalog entry resolves outside the family.",
+		label: "跨源严格档",
+		hint: "目录项解析到家族之外时拒绝写入。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "citationPolicy",
@@ -9113,7 +9225,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Refuse a move that would leave a dangling reference, or verify it."
+		summary: "Refuse a move that would leave a dangling reference, or verify it.",
+		label: "引用校验档",
+		hint: "移动或合并时对引用的处置：verify＝校验、refuse＝直接拒绝。",
+		control: "select",
+		unit: "",
+		values: "verify|refuse"
 	},
 	{
 		id: "referenceRewrite",
@@ -9143,7 +9260,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Warn about an oversize support file, or refuse the write."
+		summary: "Warn about an oversize support file, or refuse the write.",
+		label: "支持文件超限档",
+		hint: "支持文件超出字符上限时：report＝只报告、enforce＝拒写。",
+		control: "select",
+		unit: "",
+		values: "report|enforce"
 	},
 	{
 		id: "memoryChars",
@@ -9153,7 +9275,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Character budget the memory store enforces for MEMORY.md."
+		summary: "Character budget the memory store enforces for MEMORY.md.",
+		label: "MEMORY.md 字符预算",
+		hint: "memory 存储对 MEMORY.md 的字符上限。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "userChars",
@@ -9163,7 +9290,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Character budget the memory store enforces for USER.md."
+		summary: "Character budget the memory store enforces for USER.md.",
+		label: "USER.md 字符预算",
+		hint: "memory 存储对 USER.md 的字符上限。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "memoryEnabled",
@@ -9183,7 +9315,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-memory",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Characters of one memory entry shown in a tool result preview."
+		summary: "Characters of one memory entry shown in a tool result preview.",
+		label: "条目预览字符数",
+		hint: "单条记忆预览保留多少字符。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "addDatePrefix",
@@ -9193,7 +9330,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Prefix stored memory entries with their date heading."
+		summary: "Prefix stored memory entries with their date heading.",
+		label: "记忆条目加日期前缀",
+		hint: "写入记忆时为条目加上日期标题。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "maxConsolidationFailures",
@@ -9203,7 +9345,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Consolidation failures one turn tolerates before the tool gives up."
+		summary: "Consolidation failures one turn tolerates before the tool gives up.",
+		label: "合并失败容忍次数",
+		hint: "一轮内合并失败多少次后工具放弃。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "curatorIntervalHours",
@@ -9213,7 +9360,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Minimum hours between deterministic curation passes."
+		summary: "Minimum hours between deterministic curation passes.",
+		label: "策展间隔",
+		hint: "两次确定性策展之间至少间隔多少小时。",
+		control: "number",
+		unit: "小时",
+		values: ""
 	},
 	{
 		id: "staleAfterDays",
@@ -9223,7 +9375,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Inactive days before a skill counts as stale."
+		summary: "Inactive days before a skill counts as stale.",
+		label: "判为陈旧的天数",
+		hint: "技能多少天没被使用即算陈旧。",
+		control: "number",
+		unit: "天",
+		values: ""
 	},
 	{
 		id: "archiveAfterDays",
@@ -9233,7 +9390,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Inactive days before a stale skill is archived (must be >= staleAfterDays)."
+		summary: "Inactive days before a stale skill is archived (must be >= staleAfterDays).",
+		label: "归档天数",
+		hint: "陈旧技能再过多少天归档（须 ≥ 判为陈旧的天数）。",
+		control: "number",
+		unit: "天",
+		values: ""
 	},
 	{
 		id: "qualityWarnStaleAfterDays",
@@ -9243,7 +9405,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Age at which a low quality score starts warning."
+		summary: "Age at which a low quality score starts warning.",
+		label: "低质量告警天数",
+		hint: "质量分偏低时从多少天开始告警。",
+		control: "number",
+		unit: "天",
+		values: ""
 	},
 	{
 		id: "minIdleHours",
@@ -9253,7 +9420,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Idle hours required before an automatic curation pass runs."
+		summary: "Idle hours required before an automatic curation pass runs.",
+		label: "空闲门槛",
+		hint: "至少空闲多少小时才跑自动策展。",
+		control: "number",
+		unit: "小时",
+		values: ""
 	},
 	{
 		id: "minIdleFailOpen",
@@ -9263,7 +9435,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Let the idle gate open when the activity probe is unavailable."
+		summary: "Let the idle gate open when the activity probe is unavailable.",
+		label: "空闲探针失败时放行",
+		hint: "活动探针不可用时，是否让空闲门槛直接放行。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "llmReview",
@@ -9273,7 +9450,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Enable the LLM nomination pass on top of the deterministic lifecycle."
+		summary: "Enable the LLM nomination pass on top of the deterministic lifecycle.",
+		label: "启用 LLM 提名",
+		hint: "在确定性生命周期之上再跑一遍 LLM 提名。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "curatorReviewMaxTokens",
@@ -9283,7 +9465,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Token budget of the curator LLM review."
+		summary: "Token budget of the curator LLM review.",
+		label: "策展 LLM token 预算",
+		hint: "策展 LLM 审查可用的 token 预算。",
+		control: "number",
+		unit: "token",
+		values: ""
 	},
 	{
 		id: "curatorReviewTimeoutMs",
@@ -9293,7 +9480,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Wall-clock bound of the curator LLM review."
+		summary: "Wall-clock bound of the curator LLM review.",
+		label: "策展 LLM 超时",
+		hint: "策展 LLM 审查的墙钟上限。",
+		control: "number",
+		unit: "毫秒",
+		values: ""
 	},
 	{
 		id: "healthSoftBodyChars",
@@ -9303,7 +9495,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Body character line the health view judges against."
+		summary: "Body character line the health view judges against.",
+		label: "正文软带",
+		hint: "健康视图判定正文长度的软带。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "healthStampDensityPerKb",
@@ -9313,7 +9510,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Stamp density per KB that flags log-like content in a body."
+		summary: "Stamp density per KB that flags log-like content in a body.",
+		label: "标记密度阈值",
+		hint: "每 KB 出现多少个时间标记就算「像日志」。",
+		control: "number",
+		unit: "处/KB",
+		values: ""
 	},
 	{
 		id: "healthChurnMinPatches",
@@ -9323,7 +9525,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Patches without a read that flag a write-ghost skill."
+		summary: "Patches without a read that flag a write-ghost skill.",
+		label: "空写判定补丁数",
+		hint: "多少次改动都没有任何读取，即判为「写幽灵」。",
+		control: "number",
+		unit: "处",
+		values: ""
 	},
 	{
 		id: "evolution-curator.enabled",
@@ -9881,6 +10088,20 @@ const PARAM_NAMESPACES = Object.freeze({
 	"tool-skill-manage": "evolution-skills"
 });
 /**
+* The settings namespace one owner package registers. The registry's map is the only
+* place a namespace is spelled: a package without an entry has no user layer, so a
+* missing entry must fail loud here instead of letting a package fall back to a
+* private constant that the registry never sees.
+* @param owner - owner package directory name (the map's key).
+* @returns the namespace that owner registers.
+* @throws when the owner has no entry in {@link PARAM_NAMESPACES}.
+*/
+function paramNamespace(owner) {
+	const namespace = PARAM_NAMESPACES[owner];
+	if (namespace === void 0) throw new Error("no settings namespace registered for owner `" + owner + "` (add it to PARAM_NAMESPACES)");
+	return namespace;
+}
+/**
 * G3: expose one parameter section to the user layer.
 *
 * Precedence stays 'user > deployment > default': the caller keeps reading its
@@ -10079,4 +10300,4 @@ function sessionAudited(ctx, sessionId, sessionScoped) {
 	return false;
 }
 //#endregion
-export { ALIVE_LOCK_TAKEOVER_MS, AUTHORING_DESCRIPTION_BAR, AUTHORING_SPLIT_LINE_CHARS, 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, 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_REFERENCE_REWRITE_POLICY, DEFAULT_REVIEW_CONTEXT_MESSAGES, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_MESSAGE_CHARS, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_REVIEW_TIMEOUT_MS, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_MODEL, DEFAULT_SKILL_REVIEW_TRIGGER, 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, ENTRY_DELIMITER, EVENT_ARCHIVE_PREFIX, EVENT_LOG_RETAIN_ARCHIVES, EVENT_LOG_ROTATE_AT, EVENT_LOG_VERSION, EVOLUTION_WRITE_TOOLS, EvolutionGateSet, FAMILY_SESSION_TOOL_NAMES, FORBIDDEN_CONTROL_KEYS, HEALTH_STAMP_RE, HOOK_LINE_RE, INSTANCE_KEYS, KEEP_LINE_RE, LOCK_BODY_RE, LOCK_SUFFIX, LOCK_TEAR_TAKEOVER_MS, LOW_QUALITY_THRESHOLD, LostWriteLock, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MAX_DESCRIPTION_LENGTH, 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, NATIVE_CALL_EVENT, NATIVE_RESULT_EVENT, PARAM_ALIASES, PARAM_EXPOSURE, PARAM_NAMESPACES, PATTERN_OVERLAP, PLATFORM_ESTIMATE_CHARS_PER_TOKEN, POLICY_STAGE_DEFAULTS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, PTC_DISPATCH_EVENT, PTC_DISPATCH_START_EVENT, QUALITY_WEIGHTS, RESTRUCTURE_TARGET_RE, SKILLS_GUIDANCE, SKILLS_GUIDANCE_SECTION_ORDER, SKILL_ACTION_REQUIRED_FIELDS, SKILL_NAME_RE, SKILL_REVIEW_PLAN_PROMPT, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, THREAT_EXEMPTION_HINT, TOKEN_ASCII_WEIGHT, TOKEN_CJK_WEIGHT, ToolDispatchNormalizer, ToolDispatchPayloadError, UPSTREAM_LIMIT_CHARS_PER_TOKEN, advanceReview, allowRowCollisions, appendEvolutionEvent, applyCuratorLifecycleFields, applyCuratorMetaFields, applyReferenceRewrite, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, authoringFeedback, bodyCost, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampedNumber, clearReviewChannel, collectReadSkillNames, composePresetComposition, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, countDispatches, createGateSet, daysSinceIso, decideTakeover, describeReferenceRewrite, duplicateHeadings, emptyRecord, evaluateThreat, eventsFile, evolutionEventPayloadIssue, evolutionHome, evolutionIoAdapter, evolutionRoot, findDriftSignal, foldCuratorFields, foldToolDispatches, foldTurn, frontmatterBlock, frontmatterCatalogInvalid, getRecord, idleDays, installParamSection, instanceClaimKey, instanceClaimedWriteSites, instanceHolder, isAbsent, isCommittedWarning, isDeprecatedParamId, isFileShapedPath, isMissingPath, isPresent, isProcessAlive, isProgramToolName, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, latestActivityAt, lifecycleCandidate, listEventArchives, loadMutations, loadRowOverrides, loadSuppressedNames, loadUsage, makeSerialQueue, mapProbe, markAgentCreated, markReviewChannel, markerEntryName, memoryRoot, missingSupportPointers, mutateUsage, mutationsFile, narrowNameMatches, neutralizePromptVariables, newSkillLibrary, nodeEvolutionIo, normalizeFrontmatter, normalizeUsageRecord, observeEvent, overlongLines, paramSectionOverrides, parseCuratorNominations, parseEvolutionEvents, parseFrontmatter, parseLockBody, pendingSelfCleanup, persistedWriteSite, persistedWriteSites, planReferenceRewrite, planRehoming, policyStageLimits, probeAbsent, probeList, probeMtime, probePresent, probeReason, probeUnknown, readDispatchSignal, readEvolutionEvents, readEvolutionTimeline, readNumberParam, readParam, recordMutation, redactSecrets, relatedSkillNames, releaseInstance, renameWithRetry, renderCuratorReportMarkdown, resolveCitations, resolveExecOrigins, resolveOrigins, resolveParamId, resolveRootConfig, resolveSkillsRoot, retainEventArchives, retirementReport, reviewPrompt, saveSuppressedNames, saveUsage, scanBodyHooks, scanContentThreats, scanMemoryThreats, scanThreats, scopedProbeReport, sessionAudited, sessionSeesFamilyTools, skillReadNameOf, skillsRoot, supportFileReadOf, suppressedFile, sweepReviewChannelSessions, tokenLineFor, transactIo, transactTaskGuard, unhookedSupportPointers, updateSuppressedNames, usageFile, usageObserved, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, writeDurableTmp, yamlPlainScalarNeedsQuotes };
+export { ALIVE_LOCK_TAKEOVER_MS, AUTHORING_DESCRIPTION_BAR, AUTHORING_SPLIT_LINE_CHARS, 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, 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_REFERENCE_REWRITE_POLICY, DEFAULT_REVIEW_CONTEXT_MESSAGES, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_MESSAGE_CHARS, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_REVIEW_TIMEOUT_MS, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_MODEL, DEFAULT_SKILL_REVIEW_TRIGGER, 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, 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, HEALTH_STAMP_RE, HOOK_LINE_RE, INSTANCE_KEYS, KEEP_LINE_RE, LOCK_BODY_RE, LOCK_SUFFIX, LOCK_TEAR_TAKEOVER_MS, LOW_QUALITY_THRESHOLD, LostWriteLock, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MAX_DESCRIPTION_LENGTH, 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, NATIVE_CALL_EVENT, NATIVE_RESULT_EVENT, PARAM_ALIASES, PARAM_EXPOSURE, PARAM_NAMESPACES, PATTERN_OVERLAP, PLATFORM_ESTIMATE_CHARS_PER_TOKEN, POLICY_STAGE_DEFAULTS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, PTC_DISPATCH_EVENT, PTC_DISPATCH_START_EVENT, QUALITY_WEIGHTS, RESTRUCTURE_TARGET_RE, SKILLS_GUIDANCE, SKILLS_GUIDANCE_SECTION_ORDER, SKILL_ACTION_REQUIRED_FIELDS, SKILL_NAME_RE, SKILL_REVIEW_PLAN_PROMPT, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, THREAT_EXEMPTION_HINT, TOKEN_ASCII_WEIGHT, TOKEN_CJK_WEIGHT, ToolDispatchNormalizer, ToolDispatchPayloadError, UPSTREAM_LIMIT_CHARS_PER_TOKEN, advanceReview, allowRowCollisions, appendEvolutionEvent, applyCuratorLifecycleFields, applyCuratorMetaFields, applyReferenceRewrite, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, authoringFeedback, bodyCost, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampedNumber, clearReviewChannel, collectReadSkillNames, composePresetComposition, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, countDispatches, createGateSet, daysSinceIso, decideTakeover, describeReferenceRewrite, duplicateHeadings, emptyRecord, errorText, evaluateThreat, eventsFile, evolutionEventPayloadIssue, evolutionHome, evolutionIoAdapter, evolutionRoot, findDriftSignal, foldCuratorFields, foldToolDispatches, foldTurn, frontmatterBlock, frontmatterCatalogInvalid, getRecord, idleDays, installParamSection, instanceClaimKey, instanceClaimedWriteSites, instanceHolder, isAbsent, isCommittedWarning, isDeprecatedParamId, isFileShapedPath, isMissingPath, isPresent, isProcessAlive, isProgramToolName, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, latestActivityAt, lifecycleCandidate, listEventArchives, loadMutations, loadRowOverrides, loadSuppressedNames, loadUsage, makeSerialQueue, mapProbe, markAgentCreated, markReviewChannel, markerEntryName, memoryRoot, missingSupportPointers, mutateUsage, mutationsFile, narrowNameMatches, neutralizePromptVariables, newSkillLibrary, nodeEvolutionIo, normalizeFrontmatter, normalizeUsageRecord, observeEvent, overlongLines, paramNamespace, paramSectionOverrides, parseCuratorNominations, parseEvolutionEvents, parseFrontmatter, parseLockBody, pendingSelfCleanup, persistedWriteSite, persistedWriteSites, planReferenceRewrite, planRehoming, policyStageLimits, probeAbsent, probeList, probeMtime, probePresent, probeReason, probeUnknown, readDispatchSignal, readEvolutionEvents, readEvolutionTimeline, readNumberParam, readParam, recordMutation, redactSecrets, relatedSkillNames, releaseInstance, renameWithRetry, renderCuratorReportMarkdown, resolveCitations, resolveExecOrigins, resolveOrigins, resolveParamId, resolveRootConfig, resolveSkillsRoot, retainEventArchives, retirementReport, reviewPrompt, saveSuppressedNames, saveUsage, scanBodyHooks, scanContentThreats, scanMemoryThreats, scanThreats, scopedProbeReport, sessionAudited, sessionSeesFamilyTools, skillReadNameOf, skillsRoot, supportFileReadOf, suppressedFile, sweepReviewChannelSessions, tokenLineFor, transactIo, transactTaskGuard, unhookedSupportPointers, updateSuppressedNames, usageFile, usageObserved, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, writeDurableTmp, yamlPlainScalarNeedsQuotes };

package/lib/types/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * THE error-code table: E-301…E-316 with the exact text each one emits.
+ *
+ * The codes used to be spelled out at 33 call sites across two packages, so one
+ * code's wording could drift between the branches that answer it and nothing could
+ * see the drift. Keys name the SCENARIO rather than the code, because a code
+ * legitimately carries more than one text (E-301 answers pending / approve / reject
+ * with different guidance); the code still leads every string, so model- and
+ * user-facing output is unchanged. Interpolations are written `%aN%` and filled by
+ * `errorText` from the values the call site used to interpolate inline.
+ * @module @lmzhen/dsh-evolution-core
+ */
+export declare const EVOLUTION_ERRORS: Readonly<{
+    readonly 'e-305-this-invocation-carries-no': "E-305: this invocation carries no agent — `%a1%` needs a session-backed call (run it from a session in the GUI or the CLI).";
+    readonly 'e-306-this-deployment-stages-foreground': "E-306: this deployment stages foreground writes, but `/evolution %a1%` is not replayable through the skill runner — there is nothing to stage. Run it from a session whose approval policy is 'never', or set `stageForeground: false` on the evolution-approval row, then repeat the command.";
+    readonly 'e-301-approval-service-not-mounted': "E-301: approval service not mounted — pending writes cannot be listed or replayed. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.";
+    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-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.";
+    readonly 'e-308-unknown-parameter-group-group': "E-308: unknown parameter group \"%a1%\" — known groups: %a2%.";
+    readonly 'e-311-no-settings-service-is': "E-311: no settings service is mounted, so there is no user layer to write. Mount the settings row (packages/settings/settings-file) and retry; this command never edits cordis.yml — a deployment value belongs to the deployment. /evolution doctor lists the mounted services.";
+    readonly 'e-312-error-instanceof-Error-error': "E-312: %a1% — /evolution params lists the canonical ids.";
+    readonly 'e-313-unknown-parameter-id-evolution': "E-313: unknown parameter \"%a1%\" — /evolution params lists every registered id with its tier and user layer.";
+    readonly 'e-314-id-is-a-deployment': "E-314: \"%a1%\" is a deployment parameter (tier %a2%, owner %a3%) — it is written in cordis.yml on its plugin or policy row, not from a session. /evolution params shows who may write each row.";
+    readonly 'e-315-id-has-no-user': "E-315: \"%a1%\" has no user layer — owner %a2% publishes no settings namespace, so the value stays with the deployment.";
+    readonly 'e-307-the-settings-service-could-2': "E-307: the settings service could not report its sections (%a1%). /evolution policy set needs the current revision to write safely; run /evolution doctor to see which services are mounted.";
+    readonly 'e-316-namespace-namespace-is-not': "E-316: namespace \"%a1%\" is not registered — owner %a2% is not mounted in this composition, so its parameters cannot be written from here. /evolution params marks those rows 'unregistered'.";
+    readonly 'e-309-revision-conflict-you-sent': "E-309: revision conflict — you sent %a1%, the document stands at %a2%. Re-read with /evolution params --json and retry.";
+    readonly 'e-309-revision-conflict-message-Re': "E-309: revision conflict — %a1%. Re-read with /evolution params --json and retry.";
+    readonly 'e-310-the-settings-service-refused': "E-310: the settings service refused the write: %a1% — the owning plugin's rule stands (a cross-field pair, or a cap that may only be tightened). /evolution params shows the current value.";
+    readonly 'e-305-this-invocation-carries-no-2': "E-305: this invocation carries no agent — `%a1%` needs a session-backed call (run it from a session in the GUI or the CLI).";
+}>;
+/** One table key. */
+export type EvolutionErrorId = keyof typeof EVOLUTION_ERRORS;
+/**
+ * Render one table entry, substituting its interpolation slots.
+ * @param id - the scenario key.
+ * @param args - values for the entry's `%aN%` slots.
+ * @returns the message text the call site used to spell out inline.
+ */
+export declare function errorText(id: EvolutionErrorId, args?: Record<string, string | number>): string;
+//# sourceMappingURL=errors.d.ts.map

package/lib/types/index.d.ts

@@ -14,7 +14,7 @@
  *
  * - **Cross-cutting basics** — `state-store.ts` (env roots — the single
  *   source of DSH-home semantics), `serial.ts`, `numeric.ts`, `constants.ts`,
- *   `mutations.ts`, `events.ts`, `gates.ts`.
+ *   `mutations.ts`, `events.ts`, `gates.ts`, `errors.ts` (the error-code table).
  * - **Security primitives** — `threats.ts` (content threat scanner),
  *   `redact.ts` (credential masking at model boundaries). Consumers:
  *   evolution-policy/threat, both stores, review, maintenance.
@@ -33,6 +33,7 @@ export * from './evolution-events.ts';
 export * from './gates.ts';
 export * from './events.ts';
 export * from './env.ts';
+export * from './errors.ts';
 export * from './io.ts';
 export * from './learn-prompt.ts';
 export * from './memory-store.ts';

package/lib/types/params.d.ts

@@ -60,6 +60,15 @@ export type ParamAuthority = 'code' | 'cordis' | 'install';
  * `applies` is the SETTINGS-side timing: 'none' means the parameter is not
  * writable through the user layer (a cordis.yml change still follows the
  * deployment's patch-reload policy).
+ *
+ * UI METADATA (0.7.0): every E3 row carries the optional tail
+ * `label, hint, control, unit, values` — in that order, directly after
+ * `summary`, still one entry per line. E3 is the only tier the settings cards
+ * render, so the card's Chinese name, help text, control kind, unit suffix and
+ * value domain come from THIS registry and nowhere else; the browser half is
+ * generated from this text (`gen-param-client-view.mjs`). Non-E3 rows must NOT
+ * carry the tail (there is no UI surface for them), and `control: 'select'`
+ * requires a non-empty pipe-joined `values`.
  */
 export interface ParamExposure {
     id: string;
@@ -70,6 +79,16 @@ export interface ParamExposure {
     applies: 'live' | 'restart' | 'none';
     docAnchor: string;
     summary: string;
+    /** Card label (Chinese, short). Required on E3 rows. */
+    label?: string;
+    /** Card help text (Chinese, one sentence). Required on E3 rows. */
+    hint?: string;
+    /** Which control the card renders for this field. Required on E3 rows. */
+    control?: 'number' | 'switch' | 'select' | 'text';
+    /** 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'. */
+    values?: string;
 }
 /**
  * The parameter registry. G1/S1.1 seeds it with the review group (G-C); the
@@ -85,6 +104,16 @@ export declare const PARAM_EXPOSURE: readonly ParamExposure[];
  * tool-memory, each owning its own section. A package without an entry has no
  * user layer (its knobs stay deployment-only). */
 export declare const PARAM_NAMESPACES: Readonly<Record<string, string>>;
+/**
+ * The settings namespace one owner package registers. The registry's map is the only
+ * place a namespace is spelled: a package without an entry has no user layer, so a
+ * missing entry must fail loud here instead of letting a package fall back to a
+ * private constant that the registry never sees.
+ * @param owner - owner package directory name (the map's key).
+ * @returns the namespace that owner registers.
+ * @throws when the owner has no entry in {@link PARAM_NAMESPACES}.
+ */
+export declare function paramNamespace(owner: string): string;
 /** Structural view of one registered settings scope (platform Service Definition).
  * Declared locally so this module keeps its zero-import, zero-dependency shape. */
 interface SettingsScopeLike {

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