@lmzhen/dsh-evolution-settings-ui 0.26.15 → 0.27.0

package/lib/client.js

@@ -5,73 +5,138 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let react = require("react");
-		//#region src/client/approval-routes.ts
+		//#region src/client/routes.generated.ts
 		/**
-		* The approval paths this browser half calls.
-		*
-		* A browser half cannot import the host package's table at runtime (the family's client bundles treat
-		* every `@deepseek-ai/*` specifier as external), so the literals are declared here and a spec compares
-		* them against `APPROVAL_ROUTES` in `evolution-approval` — a rename on one side would otherwise surface
-		* as a 404 in the GUI instead of in CI.
-		* @module @lmzhen/dsh-evolution-settings-ui/client/approval-routes
+		* Every family host path, generated from evolution-core's HOST_ROUTES (the ONE declaration).
+		* A browser half cannot import the host package at runtime (client bundles keep @deepseek-ai/*
+		* external), so the table is mirrored here mechanically; a rename in core regenerates all three
+		* client copies, and the generator's --check makes a stale copy red.
 		*/
-		/** One path per call the pending card makes. */
-		const APPROVAL_CLIENT_ROUTES = {
-			pending: "/api/dsh-evolution/approval/pending",
-			approve: "/api/dsh-evolution/approval/approve",
-			reject: "/api/dsh-evolution/approval/reject",
-			preview: "/api/dsh-evolution/approval/preview"
+		const ROUTES = {
+			approval: {
+				pending: "/api/dsh-evolution/approval/pending",
+				preview: "/api/dsh-evolution/approval/preview",
+				approve: "/api/dsh-evolution/approval/approve",
+				reject: "/api/dsh-evolution/approval/reject"
+			},
+			"skill-history": {
+				skills: "/api/dsh-evolution/skill-history/skills",
+				versions: "/api/dsh-evolution/skill-history/versions",
+				diff: "/api/dsh-evolution/skill-history/versions/diff",
+				body: "/api/dsh-evolution/skill-history/versions/body",
+				undo: "/api/dsh-evolution/skill-history/undo",
+				health: "/api/dsh-evolution/skill-history/health"
+			},
+			"skill-health": { rows: "/api/dsh-evolution/skill-health/rows" },
+			diagnostics: { view: "/api/dsh-evolution/diagnostics" }
 		};
 		//#endregion
-		//#region src/client/api.ts
+		//#region src/client/route-client.generated.ts
+		/** Classify a non-2xx status: 401/403/404 keep their own kind, everything else is a server answer. */
+		function classify(status) {
+			if (status === 401) return {
+				kind: "unauthenticated",
+				status: 401
+			};
+			if (status === 403) return {
+				kind: "forbidden",
+				status: 403
+			};
+			if (status === 404) return {
+				kind: "unmounted",
+				status: 404
+			};
+			return {
+				kind: "server",
+				status
+			};
+		}
 		/**
-		* The approval routes this bundle calls, and the ONE place a request is made.
-		*
-		* Structural types on purpose: the browser half cannot import the host package at runtime, so the row
-		* shape is declared by what the route hands over. Every answer — including a refusal — is parsed the
-		* same way, because a refusal is a business answer the card shows as a sentence, not a transport error.
-		* @module @lmzhen/dsh-evolution-settings-ui/client/api
+		* One request, no retries and no body parsing for the platform's admission answers.
+		* @param doFetch - the fetch in use (the browser's, or a spec's stub).
+		* @param path - the exact route path from the generated ROUTES table.
+		* @param init - standard RequestInit.
+		* @returns the data, or the classified failure (network/parse failures read as 'server').
 		*/
-		/** Read one JSON answer, mapping every failure onto the same refusal shape. */
-		async function read(doFetch, path, init) {
+		async function requestJson(doFetch, path, init) {
+			let response;
 			try {
-				const response = await doFetch(path, init);
-				if (!response.ok) return {
+				response = await doFetch(path, init);
+			} catch (error) {
+				return {
 					ok: false,
-					message: "HTTP " + String(response.status)
-				};
-				const body = await response.json();
-				if (body.ok === true) return {
-					ok: true,
-					data: body.data
+					failure: {
+						kind: "server",
+						status: 0,
+						detail: error instanceof Error ? error.message : String(error)
+					}
 				};
+			}
+			if (!response.ok) return {
+				ok: false,
+				failure: classify(response.status)
+			};
+			let body;
+			try {
+				body = await response.json();
+			} catch {
 				return {
 					ok: false,
-					message: typeof body.message === "string" && body.message !== "" ? body.message : "宿主拒绝了该请求"
+					failure: {
+						kind: "server",
+						status: response.status
+					}
 				};
-			} catch (error) {
-				return {
+			}
+			if (typeof body === "object" && body !== null) {
+				const record = body;
+				if (record.ok === true) return {
+					ok: true,
+					data: record.data
+				};
+				if (record.ok === false && typeof record.message === "string" && record.message !== "") return {
 					ok: false,
-					message: error instanceof Error ? error.message : String(error)
+					failure: {
+						kind: "refused",
+						code: typeof record.code === "string" && record.code !== "" ? record.code : "refused",
+						message: record.message
+					}
 				};
 			}
+			return {
+				ok: false,
+				failure: {
+					kind: "server",
+					status: response.status
+				}
+			};
 		}
+		//#endregion
+		//#region src/client/api.ts
+		/**
+		* The approval routes this bundle calls, and the ONE place a request is made.
+		*
+		* Structural types on purpose: the browser half cannot import the host package at runtime, so the row
+		* shape is declared by what the route hands over. Every answer — including a refusal — is parsed the
+		* same way, because a refusal is a business answer the card shows as a sentence, not a transport error.
+		* @module @lmzhen/dsh-evolution-settings-ui/client/api
+		*/
 		/**
 		* Build the approval face over one fetch implementation.
 		* @param doFetch - the fetch to use (the platform's global in the browser, a fake in a spec).
 		* @returns the three calls the pending card makes.
 		*/
 		function createApprovalApi(doFetch) {
-			const post = (path, id) => read(doFetch, path, {
+			const post = async (path, id) => await requestJson(doFetch, path, {
 				method: "POST",
 				headers: { "content-type": "application/json" },
 				body: JSON.stringify({ id })
 			});
 			return {
-				pending: async (status) => await read(doFetch, status === void 0 ? APPROVAL_CLIENT_ROUTES.pending : APPROVAL_CLIENT_ROUTES.pending + "?status=" + status),
-				approve: async (id) => await post(APPROVAL_CLIENT_ROUTES.approve, id),
-				reject: async (id) => await post(APPROVAL_CLIENT_ROUTES.reject, id),
-				preview: async (id) => await read(doFetch, APPROVAL_CLIENT_ROUTES.preview + "?id=" + encodeURIComponent(id))
+				pending: async (status) => await requestJson(doFetch, status === void 0 ? ROUTES.approval.pending : ROUTES.approval.pending + "?status=" + status),
+				approve: async (id) => await post(ROUTES.approval.approve, id),
+				reject: async (id) => await post(ROUTES.approval.reject, id),
+				preview: async (id) => await requestJson(doFetch, ROUTES.approval.preview + "?id=" + encodeURIComponent(id))
 			};
 		}
 		//#endregion
@@ -607,6 +672,35 @@ window.__ModuleLoader__.load({
 			}
 		];
 		//#endregion
+		//#region src/client/states.generated.ts
+		/** A neutral/ warn/ fail block; a fail block is role=alert so assistive tech announces it. */
+		function Block(props) {
+			const tone = props.tone ?? "neutral";
+			return (0, react.createElement)("div", {
+				"data-tone": tone,
+				...tone === "fail" ? { role: "alert" } : {}
+			}, props.title === void 0 ? null : (0, react.createElement)("div", { "data-tone-title": tone }, props.title), props.children);
+		}
+		/** One classified failure as a reader-facing sentence. */
+		function failureText(failure, t) {
+			switch (failure.kind) {
+				case "unauthenticated": return t("failureUnauthorized");
+				case "forbidden": return t("failureForbidden");
+				case "unmounted": return t("failureUnmounted");
+				case "server": return failure.status === 0 ? t("failureServer") : t("failureServer") + " (HTTP " + String(failure.status) + ")";
+				case "refused": return failure.message;
+			}
+		}
+		/** The failed-state block: sentence + (when the surface exists but is unreachable) the command fallback. */
+		function FailureBlock(props) {
+			const hint = props.fallback === void 0 ? null : (0, react.createElement)("div", { "data-tone-hint": "true" }, props.t("fallbackHint", { command: props.fallback.command }));
+			return Block({
+				tone: "fail",
+				title: failureText(props.failure, props.t),
+				children: hint
+			});
+		}
+		//#endregion
 		//#region src/client/pending-state.ts
 		/** The state a card mounts in: still loading, nothing in flight, nothing said yet. */
 		const INITIAL_PENDING_STATE = {
@@ -662,13 +756,13 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
-		/** The list could not be read: the reason stays on screen next to a retry control. */
-		function failed(state, message) {
+		/** The list could not be read: the classified failure stays on screen next to a retry control. */
+		function failed(state, failure) {
 			return {
 				...state,
 				view: {
 					kind: "failed",
-					message
+					failure
 				}
 			};
 		}
@@ -741,6 +835,7 @@ window.__ModuleLoader__.load({
 		*/
 		function PendingCard(props) {
 			const { t, api } = props;
+			const translate = (key, values) => t(key, values);
 			const confirmMode = props.confirmMode?.() ?? "auto";
 			const [armed, setArmed] = (0, react.useState)(null);
 			const [state, setState] = (0, react.useState)(INITIAL_PENDING_STATE);
@@ -760,15 +855,19 @@ window.__ModuleLoader__.load({
 			* answers are ordered the way the CLI orders them (waiting first); either one failing fails the
 			* read, because a half-list would read as a complete window.
 			*/
+			const readTicket = (0, react.useRef)(0);
 			const load = async () => {
 				apply(loading);
+				const ticket = readTicket.current + 1;
+				readTicket.current = ticket;
 				const [waiting, running] = await Promise.all([api.pending(), api.pending("executing")]);
+				if (readTicket.current !== ticket) return;
 				if (!waiting.ok) {
-					apply((current) => failed(current, waiting.message));
+					apply((current) => failed(current, waiting.failure));
 					return;
 				}
 				if (!running.ok) {
-					apply((current) => failed(current, running.message));
+					apply((current) => failed(current, running.failure));
 					return;
 				}
 				apply((current) => loaded(current, [...waiting.data, ...running.data]));
@@ -788,7 +887,7 @@ window.__ModuleLoader__.load({
 				(async () => {
 					const answer = action === "approve" ? await api.approve(id) : await api.reject(id);
 					if (!answer.ok) {
-						apply((current) => noticed(endAction(current, id), answer.message));
+						apply((current) => noticed(endAction(current, id), failureText(answer.failure, translate)));
 						return;
 					}
 					apply((current) => noticed(endAction(current, id), null));
@@ -811,7 +910,7 @@ window.__ModuleLoader__.load({
 					reason: answer.data.reason
 				} : {
 					kind: "failed",
-					message: answer.message
+					failure: answer.failure
 				};
 				apply((current) => previewArrived(current, id, view));
 			};
@@ -832,7 +931,7 @@ window.__ModuleLoader__.load({
 				if (view.kind === "failed") return (0, react.createElement)("p", {
 					className: "evolution-param-error",
 					role: "status"
-				}, view.message);
+				}, failureText(view.failure, translate));
 				if (view.kind === "unavailable") return (0, react.createElement)("p", {
 					className: "evolution-param-error",
 					role: "status"
@@ -852,18 +951,18 @@ window.__ModuleLoader__.load({
 					}, t("approvalDiffCut"))] : []
 				];
 				const lines = [];
-				for (const hunk of view.answer.hunks) {
+				for (const [hunkIndex, hunk] of view.answer.hunks.entries()) {
 					for (const [index, line] of hunk.oldText.split("\n").entries()) {
 						if (hunk.oldText === "" && line === "") continue;
 						lines.push((0, react.createElement)("div", {
-							key: "old-" + String(index),
+							key: "old-" + String(hunkIndex) + "-" + String(index),
 							className: "evolution-param-line-del"
 						}, "- " + line));
 					}
 					for (const [index, line] of hunk.newText.split("\n").entries()) {
 						if (hunk.newText === "" && line === "") continue;
 						lines.push((0, react.createElement)("div", {
-							key: "new-" + String(index),
+							key: "new-" + String(hunkIndex) + "-" + String(index),
 							className: "evolution-param-line-add"
 						}, "+ " + line));
 					}
@@ -933,10 +1032,11 @@ window.__ModuleLoader__.load({
 					className: "evolution-param-note",
 					role: "status"
 				}, t("approvalEmpty"));
-				if (state.view.kind === "failed") return (0, react.createElement)("div", { className: "evolution-param-actions" }, (0, react.createElement)("p", {
-					className: "evolution-param-error",
-					role: "status"
-				}, t("approvalFailed") + ": " + state.view.message), (0, react.createElement)("button", {
+				if (state.view.kind === "failed") return (0, react.createElement)("div", { className: "evolution-param-actions" }, FailureBlock({
+					failure: state.view.failure,
+					t: translate,
+					fallback: props.fallback
+				}), (0, react.createElement)("button", {
 					className: "evolution-param-button",
 					type: "button",
 					onClick: () => {
@@ -967,6 +1067,120 @@ window.__ModuleLoader__.load({
 			}, t("approvalRefresh"))), body()) : null);
 		}
 		//#endregion
+		//#region src/client/DiagnosticsCard.ts
+		/**
+		* The diagnostics card (W7 S7): the browser face of the SAME DiagnosticsView the CLI and the
+		* `/api/dsh-evolution/diagnostics` route answer.
+		*
+		* Read-only by construction: it fetches once on mount and only refetches on an explicit Refresh; a
+		* failed read renders the shared FailureBlock with the command-face fallback. Facts and runtime rows
+		* are rendered in the view's own order — the client owns no key list and no status vocabulary.
+		* @module @lmzhen/dsh-evolution-settings-ui/client/DiagnosticsCard
+		*/
+		/** Which word one status gets (the frozen W1 status set). */
+		const STATUS_KEYS = Object.freeze({
+			ok: "diagStatusOk",
+			warn: "diagStatusWarn",
+			fail: "diagStatusFail",
+			unknown: "diagStatusUnknown"
+		});
+		/**
+		* Render the card.
+		* @param props - the copy seat, the host call and the command fallback.
+		* @returns the card.
+		*/
+		function DiagnosticsCard(props) {
+			const { t, api } = props;
+			const translate = (key, values) => t(key, values);
+			const [state, setState] = (0, react.useState)({ phase: "loading" });
+			const ticket = (0, react.useRef)(0);
+			const read = (keepView) => {
+				const current = ticket.current + 1;
+				ticket.current = current;
+				if (!keepView) setState({ phase: "loading" });
+				api.view().then((answer) => {
+					if (ticket.current !== current) return;
+					setState(answer.ok ? {
+						phase: "ready",
+						view: answer.data
+					} : {
+						phase: "failed",
+						failure: answer.failure
+					});
+				});
+			};
+			(0, react.useEffect)(() => {
+				read(false);
+			}, []);
+			const refresh = () => {
+				read(true);
+			};
+			const header = (0, react.createElement)("div", { className: "evolution-param-card-head" }, (0, react.createElement)("span", { className: "evolution-param-card-title" }, t("diagTitle")), (0, react.createElement)("button", {
+				type: "button",
+				className: "evolution-param-button",
+				onClick: refresh,
+				"data-action": "diag-refresh"
+			}, state.phase === "loading" ? t("diagRefreshing") : t("diagRefresh")));
+			const body = () => {
+				if (state.phase === "loading") return (0, react.createElement)("p", { className: "evolution-param-loading" }, t("stateLoading"));
+				if (state.phase === "failed") return FailureBlock({
+					failure: state.failure,
+					t: translate,
+					fallback: props.fallback
+				});
+				const view = state.view;
+				const factRows = view.facts.map((fact) => (0, react.createElement)("div", {
+					key: "fact-" + fact.key,
+					className: "evo-diag-row",
+					"data-kind": "fact"
+				}, (0, react.createElement)("span", { className: "evo-diag-key" }, fact.label), (0, react.createElement)("span", { className: "evo-diag-value" }, fact.value), (0, react.createElement)("span", { className: "evo-diag-home" }, t("diagHomeCite", { home: fact.home }))));
+				const runtimeRows = view.runtime.map((row) => (0, react.createElement)("div", {
+					key: "runtime-" + row.key,
+					className: "evo-diag-row",
+					"data-kind": "runtime",
+					"data-status": row.status
+				}, (0, react.createElement)("span", { className: "evo-diag-key" }, row.label), (0, react.createElement)("span", { className: "evo-diag-status" }, t(STATUS_KEYS[row.status])), row.detail === void 0 ? null : (0, react.createElement)("span", { className: "evo-diag-detail" }, row.detail), row.remedy === void 0 ? null : (0, react.createElement)("span", { className: "evo-diag-remedy" }, t("diagRemedy") + row.remedy)));
+				return (0, react.createElement)("div", { className: "evo-diag-body" }, (0, react.createElement)("p", { className: "evolution-params-subtitle" }, t("diagSubtitle")), (0, react.createElement)("p", { className: "evo-diag-meta" }, t("diagSchema", { n: view.schemaVersion }) + " · " + t("diagGeneratedAt", { at: view.generatedAt })), (0, react.createElement)("h3", { className: "evo-diag-section" }, t("diagFactsTitle")), ...factRows, (0, react.createElement)("h3", { className: "evo-diag-section" }, t("diagRuntimeTitle")), ...runtimeRows);
+			};
+			return (0, react.createElement)("div", {
+				className: "evolution-param-card",
+				"data-card": "diagnostics"
+			}, header, body());
+		}
+		//#endregion
+		//#region src/client/diagnostics-state.ts
+		/**
+		* The diagnostics card's data face (W7 S7): ONE request to `HOST_ROUTES.diagnostics.view` through the
+		* GENERATED route client, and the four-state answer the card renders.
+		*
+		* The Host route is the SAME `buildDoctorView` the CLI prints (W6/W8), so this client owns no facts
+		* and no computation — it only renders.
+		* @module @lmzhen/dsh-evolution-settings-ui/client/diagnostics-state
+		*/
+		/**
+		* Build the diagnostics face over one fetch implementation.
+		* @param doFetch - the browser fetch, or a spec stub.
+		*/
+		function createDiagnosticsApi(doFetch = fetch) {
+			return { view: async () => await requestJson(doFetch, ROUTES.diagnostics.view, { headers: { accept: "application/json" } }) };
+		}
+		//#endregion
+		//#region src/client/fallbacks.generated.ts
+		/**
+		* The command-face fallback for every Host surface, generated from evolution-commands'
+		* COMMAND_FALLBACKS (the ONE home). When the platform's connection carrier is absent (E-325) the
+		* panels render this hint instead of a bare HTTP failure — same use case, command face.
+		*/
+		const FALLBACKS = {
+			approval: { command: "/evolution pending … /evolution approve <id> … /evolution reject <id> … /evolution release <id>" },
+			"skill-history": { command: "/evolution restore <name> [v]（查看：/evolution skills history <name>）" },
+			"skill-health": { command: "/evolution skills refresh（健康行：/evolution doctor）" },
+			diagnostics: {
+				command: "/evolution doctor",
+				platformCli: "dsh --json /evolution doctor"
+			}
+		};
+		//#endregion
 		//#region src/client/messages.ts
 		/**
 		* Copy for the evolution settings section and its parameter cards.
@@ -998,14 +1212,13 @@ window.__ModuleLoader__.load({
 			discard: "放弃修改",
 			saving: "保存中…",
 			resetting: "恢复中…",
-			destHost: "保存去向：本机配置",
+			writeTargetHost: "保存去向：宿主配置（对所有会话生效）",
 			invalidNumber: "需要一个数字",
 			invalidSelect: "不在允许的取值里",
 			invalidAtLeast: "不能小于同组的 {n}",
 			approvalConfirmNamed: "即将批准：{n}",
 			approvalConfirmYes: "确认批准",
 			approvalConfirmNo: "取消",
-			destMemory: "保存去向：仅本次会话",
 			resetTo: "复位为 {value}",
 			refused: "这个值没有被接受（界面上保持原样）。想看原因：在对话里让它说明。",
 			resetRefused: "恢复默认值没有生效（这一行还是你的值）。想看原因：在对话里让它说明。",
@@ -1041,7 +1254,27 @@ window.__ModuleLoader__.load({
 			approvalPreviewNone: "看不了预览：",
 			approvalDiffAdded: "{n} 行新增",
 			approvalDiffRemoved: "{n} 行删除",
-			approvalDiffCut: "改动区域已截断"
+			approvalDiffCut: "改动区域已截断",
+			diagTitle: "诊断",
+			diagSubtitle: "安装形态、平台线与运行面的当前读数；只读，不改任何东西。",
+			diagFactsTitle: "事实",
+			diagRuntimeTitle: "运行时",
+			diagSchema: "视图 schema v{n}",
+			diagGeneratedAt: "生成于 {at}",
+			diagRefresh: "刷新",
+			diagRefreshing: "刷新中…",
+			diagStatusOk: "正常",
+			diagStatusWarn: "注意",
+			diagStatusFail: "异常",
+			diagStatusUnknown: "未知",
+			diagRemedy: "下一步：",
+			diagHomeCite: "出处：{home}",
+			stateLoading: "正在读取…",
+			failureUnauthorized: "需要登录：重新打开这个页面完成登录后再试。",
+			failureForbidden: "平台拒绝了这个请求（身份不是 owner）。",
+			failureUnmounted: "该功能没有挂载。",
+			failureServer: "读取失败，可以手动重试。",
+			fallbackHint: "可以改用命令：{command}"
 		};
 		/** English copy, key for key with {@link zh}. */
 		const en = {
@@ -1061,14 +1294,13 @@ window.__ModuleLoader__.load({
 			discard: "Discard",
 			saving: "Saving…",
 			resetting: "Resetting…",
-			destHost: "Saved to: this machine",
+			writeTargetHost: "Saved to: host configuration (applies to every session)",
 			invalidNumber: "Needs a number",
 			invalidSelect: "Not one of the allowed values",
 			invalidAtLeast: "must not be below {n}",
 			approvalConfirmNamed: "About to approve: {n}",
 			approvalConfirmYes: "Approve",
 			approvalConfirmNo: "Cancel",
-			destMemory: "Saved to: this session only",
 			resetTo: "Restores {value}",
 			refused: "The value was not accepted (the page keeps what you see). For the reason, ask in the conversation.",
 			resetRefused: "The reset did not take (this row still holds your value). For the reason, ask in the conversation.",
@@ -1104,7 +1336,27 @@ window.__ModuleLoader__.load({
 			approvalPreviewNone: "no preview: ",
 			approvalDiffAdded: "{n} lines added",
 			approvalDiffRemoved: "{n} lines removed",
-			approvalDiffCut: "the changed region is truncated"
+			approvalDiffCut: "the changed region is truncated",
+			diagTitle: "Diagnostics",
+			diagSubtitle: "Current readings for the install form, platform line and runtime surfaces; read-only.",
+			diagFactsTitle: "Facts",
+			diagRuntimeTitle: "Runtime",
+			diagSchema: "view schema v{n}",
+			diagGeneratedAt: "generated at {at}",
+			diagRefresh: "Refresh",
+			diagRefreshing: "refreshing…",
+			diagStatusOk: "ok",
+			diagStatusWarn: "warn",
+			diagStatusFail: "fail",
+			diagStatusUnknown: "unknown",
+			diagRemedy: "Next: ",
+			diagHomeCite: "source: {home}",
+			stateLoading: "reading…",
+			failureUnauthorized: "Sign-in is required: reopen this page and sign in, then retry.",
+			failureForbidden: "The platform refused this request (not the owner principal).",
+			failureUnmounted: "This feature is not mounted.",
+			failureServer: "The read failed; you can retry manually.",
+			fallbackHint: "Command fallback: {command}"
 		};
 		/**
 		* Card titles per settings namespace. A namespace without an entry falls back to
@@ -1123,7 +1375,7 @@ window.__ModuleLoader__.load({
 		/**
 		* Resolve one message without the locale seat (tests and the fallback path).
 		* @param key - the message key.
-		* @param language - which dictionary to read; defaults to Chinese.
+		* @param language - which dictionary to read; defaults to English (the platform FALLBACK_LOCALE).
 		* @returns the copy this bundle carries.
 		*/
 		function message(key, language = "en") {
@@ -1171,6 +1423,23 @@ window.__ModuleLoader__.load({
 		* typed from the registry (\`control\`), so booleans are switches, enums are
 		* selects and numbers are numeric inputs with the unit shown beside the label.
 		*/
+		/**
+		* The NAMESPACE-RELATIVE key of one registry field.
+		*
+		* The E3 registry writes family ids in canonical form (`evolution-approval.pendingTtlMs`),
+		* while the platform settings seat speaks a namespace's own field keys (`pendingTtlMs`) —
+		* its snapshot user layer, its base and its op paths are all relative to the namespace. Sending
+		* the canonical id as an op path makes the Host refuse the write
+		* ("Config field evolution-approval.pendingTtlMs is not volatile", measured 2026-10-19), so the
+		* card translates once, here, and every read/write goes through it.
+		* @param namespace - the settings namespace (Loader row id) the card writes.
+		* @param field - one generated field.
+		* @returns the field's key inside that namespace.
+		*/
+		function fieldKeyOf(namespace, field) {
+			const prefix = namespace + ".";
+			return field.id.startsWith(prefix) ? field.id.slice(prefix.length) : field.id;
+		}
 		/** One cell's text: absent reads as an empty control, containers as JSON. */
 		function format(value) {
 			if (value === void 0) return "";
@@ -1319,35 +1588,6 @@ window.__ModuleLoader__.load({
 			const [error, setError] = (0, react.useState)("");
 			const [pending, setPending] = (0, react.useState)(null);
 			const [clearing, setClearing] = (0, react.useState)(null);
-			if (snapshot.status === "loading") return (0, react.createElement)("p", {
-				className: "evolution-param-note",
-				role: "status"
-			}, t("loading"));
-			if (snapshot.status === "unavailable") return (0, react.createElement)("p", {
-				className: "evolution-param-note",
-				role: "status"
-			}, t(snapshot.reason === "seat-missing" ? "seatMissing" : snapshot.reason === "projection-failed" ? "projectionFailed" : "unavailable"));
-			const user = isRecord(snapshot.user) ? snapshot.user : {};
-			const value = isRecord(snapshot.value) ? snapshot.value : {};
-			const disabled = !snapshot.writable;
-			const locked = disabled || busy || clearing !== null;
-			const titleKey = NAMESPACE_TITLES[namespace];
-			const title = titleKey === void 0 ? namespace : t(titleKey);
-			const changed = fields.filter((field) => Object.hasOwn(user, field.id)).length;
-			const textOf = (field) => draft[field.id] ?? format(value[field.id]);
-			const dirty = fields.filter((field) => draft[field.id] !== void 0 && draft[field.id] !== format(value[field.id]));
-			const peerTextOf = (field) => {
-				if (field.atLeast === "") return void 0;
-				const related = fields.find((candidate) => candidate.id === field.atLeast);
-				return related === void 0 ? void 0 : textOf(related);
-			};
-			const blocked = fields.some((field) => invalidReason(field, textOf(field), peerTextOf(field)) !== null);
-			const change = (id, next) => {
-				setDraft({
-					...draft,
-					[id]: next
-				});
-			};
 			/**
 			* Settle a staged write against the Host's answer.
 			*
@@ -1376,6 +1616,36 @@ window.__ModuleLoader__.load({
 				snapshot.user,
 				t
 			]);
+			if (snapshot.status === "loading") return (0, react.createElement)("p", {
+				className: "evolution-param-note",
+				role: "status"
+			}, t("loading"));
+			if (snapshot.status === "unavailable") return (0, react.createElement)("p", {
+				className: "evolution-param-note",
+				role: "status"
+			}, t(snapshot.reason === "seat-missing" ? "seatMissing" : snapshot.reason === "projection-failed" ? "projectionFailed" : "unavailable"));
+			const user = isRecord(snapshot.user) ? snapshot.user : {};
+			const value = isRecord(snapshot.value) ? snapshot.value : {};
+			const disabled = !snapshot.writable;
+			const locked = disabled || busy || clearing !== null;
+			const titleKey = NAMESPACE_TITLES[namespace];
+			const title = titleKey === void 0 ? namespace : t(titleKey);
+			const keyOf = (field) => fieldKeyOf(namespace, field);
+			const changed = fields.filter((field) => Object.hasOwn(user, keyOf(field))).length;
+			const textOf = (field) => draft[field.id] ?? format(value[keyOf(field)]);
+			const dirty = fields.filter((field) => draft[field.id] !== void 0 && draft[field.id] !== format(value[keyOf(field)]));
+			const peerTextOf = (field) => {
+				if (field.atLeast === "") return void 0;
+				const related = fields.find((candidate) => candidate.id === field.atLeast);
+				return related === void 0 ? void 0 : textOf(related);
+			};
+			const blocked = fields.some((field) => invalidReason(field, textOf(field), peerTextOf(field)) !== null);
+			const change = (id, next) => {
+				setDraft({
+					...draft,
+					[id]: next
+				});
+			};
 			/**
 			* Restore one field's deployment default (T5-05/A60).
 			*
@@ -1390,7 +1660,7 @@ window.__ModuleLoader__.load({
 				(async () => {
 					let accepted;
 					try {
-						accepted = await clear(field);
+						accepted = await clear(fieldKeyOf(namespace, { id: field }));
 					} catch (caught) {
 						setClearing(null);
 						setError(caught instanceof Error && caught.message !== "" ? caught.message : t("resetRefused"));
@@ -1410,7 +1680,7 @@ window.__ModuleLoader__.load({
 						setPending({
 							accepted: await mutateOnce(dirty.map((field) => ({
 								op: "set",
-								path: [field.id],
+								path: [keyOf(field)],
 								value: parseFor(field.control, textOf(field))
 							}))),
 							resets: false
@@ -1428,7 +1698,7 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					setOpen(!open);
 				}
-			}, (0, react.createElement)("span", { className: "evolution-param-card-title" }, title), changed === 0 ? null : (0, react.createElement)("span", { className: "evolution-param-count" }, t("changed", { n: changed })), (0, react.createElement)("span", { className: "evolution-param-dest" }, snapshot.mode === "memory" ? t("destMemory") : t("destHost")), (0, react.createElement)("span", { className: "evolution-param-chevron" }, open ? "▲" : "▼")), open ? (0, react.createElement)("div", { className: "evolution-param-body" }, disabled ? (0, react.createElement)("p", {
+			}, (0, react.createElement)("span", { className: "evolution-param-card-title" }, title), changed === 0 ? null : (0, react.createElement)("span", { className: "evolution-param-count" }, t("changed", { n: changed })), (0, react.createElement)("span", { className: "evolution-param-dest" }, t("writeTargetHost")), (0, react.createElement)("span", { className: "evolution-param-chevron" }, open ? "▲" : "▼")), open ? (0, react.createElement)("div", { className: "evolution-param-body" }, disabled ? (0, react.createElement)("p", {
 				className: "evolution-param-note",
 				role: "status"
 			}, t("readonly")) : null, fields.length === 0 ? (0, react.createElement)("p", {
@@ -1441,10 +1711,10 @@ window.__ModuleLoader__.load({
 				key: field.id,
 				field,
 				text: textOf(field),
-				overridden: Object.hasOwn(user, field.id),
+				overridden: Object.hasOwn(user, keyOf(field)),
 				disabled: locked,
 				clearing: clearing === field.id,
-				resetTo: resetToOf(snapshot.base?.[field.id]),
+				resetTo: resetToOf(snapshot.base?.[keyOf(field)]),
 				invalid: invalidReason(field, textOf(field), peerTextOf(field)),
 				t,
 				onChange: change,
@@ -1494,7 +1764,6 @@ window.__ModuleLoader__.load({
 			user: void 0,
 			writable: false,
 			base: void 0,
-			mode: "host",
 			reason: "seat-missing"
 		});
 		/** What a card shows when the seat served the row but projecting it failed. A frozen constant
@@ -1506,7 +1775,6 @@ window.__ModuleLoader__.load({
 			user: void 0,
 			writable: false,
 			base: void 0,
-			mode: "host",
 			reason: "projection-failed"
 		});
 		/**
@@ -1521,7 +1789,6 @@ window.__ModuleLoader__.load({
 				user: snapshot.user,
 				writable: snapshot.writable,
 				base: isRecord(snapshot.base) ? snapshot.base : void 0,
-				mode: snapshot.mode,
 				...snapshot.status === "unavailable" ? { reason: "not-served" } : {}
 			};
 		}
@@ -1629,14 +1896,12 @@ window.__ModuleLoader__.load({
 				mutateOnce: async (ops) => {
 					const seat = form();
 					if (seat === void 0) return false;
-					await seat.mutate(ops);
-					return true;
+					return await seat.mutate(ops);
 				},
 				clear: async (field) => {
 					const seat = form();
 					if (seat === void 0) return false;
-					await seat.unset(field);
-					return true;
+					return await seat.unset(field);
 				}
 			};
 		}
@@ -1685,9 +1950,9 @@ window.__ModuleLoader__.load({
 		* @param fields - the row's fields.
 		* @returns how many of them the user overrode.
 		*/
-		function overridden(user, fields) {
+		function overridden(user, fields, namespace) {
 			const layer = isRecord(user) ? user : {};
-			return fields.filter((field) => Object.hasOwn(layer, field.id)).length;
+			return fields.filter((field) => Object.hasOwn(layer, fieldKeyOf(namespace, field))).length;
 		}
 		/**
 		* Render one row's configuration entry.
@@ -1700,7 +1965,7 @@ window.__ModuleLoader__.load({
 				className: "evolution-param-note",
 				role: "status"
 			}, t("seatMissing"));
-			const changed = overridden(form.state.user, fields);
+			const changed = overridden(form.state.user, fields, namespace);
 			if (view === "summary") return changed === 0 ? null : (0, react.createElement)("span", null, t("changed", { n: changed }));
 			return ParamCardView({
 				namespace,
@@ -1742,6 +2007,8 @@ window.__ModuleLoader__.load({
 		* the section — one definition in the module both sides already share is what keeps that pair acyclic.
 		*/
 		const PENDING_CARD_KEY = "approval-pending";
+		/** The diagnostics card's slot key: read-only, no settings namespace (its data comes from HOST_ROUTES.diagnostics). */
+		const DIAGNOSTICS_CARD_KEY = "diagnostics";
 		//#endregion
 		//#region src/client/SettingsSection.ts
 		/**
@@ -1763,7 +2030,10 @@ window.__ModuleLoader__.load({
 			return (0, react.createElement)("div", { className: "evolution-params" }, (0, react.createElement)("h2", { className: "evolution-params-title" }, face.t("title")), (0, react.createElement)("p", { className: "evolution-params-subtitle" }, face.t("subtitle")), (0, react.createElement)("p", { className: "evolution-params-about" }, "0.24.0 · Web settings cards for the evolution family's parameter namespaces"), (0, react.createElement)("div", {
 				key: PENDING_CARD_KEY,
 				className: "evolution-params-group"
-			}, face.renderSlot(CARD_SLOT, {}, { entryKey: PENDING_CARD_KEY })), ...CLIENT_PARAM_SECTIONS.map((section_) => (0, react.createElement)("div", {
+			}, face.renderSlot(CARD_SLOT, {}, { entryKey: PENDING_CARD_KEY })), (0, react.createElement)("div", {
+				key: DIAGNOSTICS_CARD_KEY,
+				className: "evolution-params-group"
+			}, face.renderSlot(CARD_SLOT, {}, { entryKey: DIAGNOSTICS_CARD_KEY })), ...CLIENT_PARAM_SECTIONS.map((section_) => (0, react.createElement)("div", {
 				key: section_.namespace,
 				className: "evolution-params-group"
 			}, face.renderSlot(CARD_SLOT, {}, { entryKey: section_.namespace }))));
@@ -1853,17 +2123,26 @@ window.__ModuleLoader__.load({
 		].join("\n");
 		/**
 		* Inject the stylesheet once per document.
+		*
+		* S5-08: it RETURNS the disposer. The tag check alone answered only half the question - "is it
+		* there" - and left "who takes it away" to nobody, so a hot reload (unmount, remount) found the old
+		* tag, skipped the injection, and kept serving the PREVIOUS bundle CSS. skill-history hands its
+		* disposer back to the fiber; this is the same shape for the same concern.
 		* @param host - the document to inject into; defaults to the global one.
+		* @returns the disposal; a no-op when there is no document or the tag was already present.
 		*/
 		function injectStyles(host) {
 			const doc = host ?? globalThis.document;
-			if (doc === void 0) return;
-			if (doc.querySelector("style[data-plugin-css=\"@lmzhen/dsh-evolution-settings-ui/settings.css\"]") !== null) return;
+			if (doc === void 0) return () => {};
+			if (doc.querySelector("style[data-plugin-css=\"@lmzhen/dsh-evolution-settings-ui/settings.css\"]") !== null) return () => {};
 			const tag = doc.createElement("style");
 			tag.dataset.plugin = "@lmzhen/dsh-evolution-settings-ui";
 			tag.dataset.pluginCss = CSS_TAG_ID;
 			tag.textContent = CSS;
 			doc.head.appendChild(tag);
+			return () => {
+				tag.remove();
+			};
 		}
 		//#endregion
 		//#region src/client/index.ts
@@ -1884,7 +2163,7 @@ window.__ModuleLoader__.load({
 		* @param ctx - client cordis context.
 		*/
 		function apply(ctx) {
-			injectStyles();
+			ctx.effect(() => injectStyles(), "evolution-settings-ui: styles");
 			const seam = ctx;
 			let registered = false;
 			ctx.effect(() => {
@@ -1959,9 +2238,20 @@ window.__ModuleLoader__.load({
 					inject: () => ({
 						t,
 						api,
-						confirmMode
+						confirmMode,
+						fallback: FALLBACKS.approval
 					})
 				}, PendingCard);
+				const diagApi = createDiagnosticsApi((input, init) => fetch(input, init));
+				yield seam.slots.register({
+					name: CARD_SLOT,
+					key: DIAGNOSTICS_CARD_KEY,
+					inject: () => ({
+						t,
+						api: diagApi,
+						fallback: FALLBACKS.diagnostics
+					})
+				}, DiagnosticsCard);
 			});
 			seam.slots.inject(ROW_CONFIG_SLOT, function* () {
 				for (const seat of CLIENT_ROW_SEATS) for (const rowId of seat.rows) {

package/lib/types/client/DiagnosticsCard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The diagnostics card (W7 S7): the browser face of the SAME DiagnosticsView the CLI and the
+ * `/api/dsh-evolution/diagnostics` route answer.
+ *
+ * Read-only by construction: it fetches once on mount and only refetches on an explicit Refresh; a
+ * failed read renders the shared FailureBlock with the command-face fallback. Facts and runtime rows
+ * are rendered in the view's own order — the client owns no key list and no status vocabulary.
+ * @module @lmzhen/dsh-evolution-settings-ui/client/DiagnosticsCard
+ */
+import { type ReactNode } from 'react';
+import type { DiagnosticsApi } from './diagnostics-state.ts';
+import type { FallbackHint } from './contracts.generated.ts';
+import type { MessageKey } from './messages.ts';
+/** Injected face: the copy seat, the one host call, and this surface's command fallback. */
+export interface DiagnosticsCardFace {
+    t: (key: MessageKey, values?: Readonly<Record<string, string | number>>) => string;
+    api: DiagnosticsApi;
+    fallback?: FallbackHint | undefined;
+}
+/**
+ * Render the card.
+ * @param props - the copy seat, the host call and the command fallback.
+ * @returns the card.
+ */
+export declare function DiagnosticsCard(props: DiagnosticsCardFace): ReactNode;
+//# sourceMappingURL=DiagnosticsCard.d.ts.map

package/lib/types/client/ParamCard.d.ts

@@ -48,6 +48,20 @@ export type ParamCardProps = Omit<ParamCardFace, 'hooks'> & {
 };
 /** The op list a save hands to the seat — the seam's own shape, never a second vocabulary. */
 export type SettingsParamOp = SettingsPathOpLike;
+/**
+ * The NAMESPACE-RELATIVE key of one registry field.
+ *
+ * The E3 registry writes family ids in canonical form (`evolution-approval.pendingTtlMs`),
+ * while the platform settings seat speaks a namespace's own field keys (`pendingTtlMs`) —
+ * its snapshot user layer, its base and its op paths are all relative to the namespace. Sending
+ * the canonical id as an op path makes the Host refuse the write
+ * ("Config field evolution-approval.pendingTtlMs is not volatile", measured 2026-10-19), so the
+ * card translates once, here, and every read/write goes through it.
+ * @param namespace - the settings namespace (Loader row id) the card writes.
+ * @param field - one generated field.
+ * @returns the field's key inside that namespace.
+ */
+export declare function fieldKeyOf(namespace: string, field: ClientParamField): string;
 /**
  * U-4: whether one field's CURRENT text is a value the Host can take. The controls constrain their own
  * domains (a number input sanitizes, a select only offers listed values), so the reachable case is a

package/lib/types/client/PendingCard.d.ts

@@ -13,6 +13,7 @@
  * @module @lmzhen/dsh-evolution-settings-ui/client/PendingCard
  */
 import { type ReactNode } from 'react';
+import type { FallbackHint } from './contracts.generated.ts';
 import type { ApprovalApi } from './api.ts';
 import type { MessageKey } from './messages.ts';
 /** Injected face: the copy seat and the host calls. No hook compartment — this card keeps its own state. */
@@ -24,6 +25,8 @@ export interface PendingCardFace {
      * captured once would pin the gate for the life of the fiber. Absent ⇒ the shipped default `auto`.
      */
     confirmMode?: () => 'auto' | 'ask' | 'timeout';
+    /** G5/W7 S4: the command-face fallback rendered with an unreachable/unauthenticated failure. */
+    fallback?: FallbackHint | undefined;
 }
 /**
  * U-6: the registry's gate word, read out of a section's user layer. ONE definition, exported so the

package/lib/types/client/api.d.ts

@@ -1,3 +1,4 @@
+import { type RouteAnswer } from './route-client.generated.ts';
 /** One staged write, as the pending route hands it over (never the staged args). */
 export interface PendingRow {
     readonly id: string;
@@ -33,14 +34,8 @@ export type PreviewAnswer = {
     readonly available: false;
     readonly reason: string;
 };
-/** What one call answered: the data, or the reason it could not be carried out. */
-export type ApprovalAnswer<T> = {
-    readonly ok: true;
-    readonly data: T;
-} | {
-    readonly ok: false;
-    readonly message: string;
-};
+/** What one call answered: the generated four-state RouteAnswer (no local failure vocabulary). */
+export type ApprovalAnswer<T> = RouteAnswer<T>;
 /**
  * Which window the pending route is asked for. The host route has always taken `?status=` (the CLI
  * asks for both); this half asked for neither, so a record stuck in `executing` — an approve that

package/lib/types/client/contracts.generated.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Literal mirror of the frozen Host diagnostics contract (W1 §2.8 / core diagnostics.ts). The browser
+ * build keeps every @deepseek-ai/* specifier external, so the client CANNOT import the host type — the
+ * shape is mirrored mechanically here instead. The key unions are rendered from core diagnostics.ts by
+ * the generator, so a key change regenerates all three copies (a stale copy fails --check).
+ */
+export type DiagnosticsSchemaVersion = 2;
+export type DiagnosticsFactKey = 'platform-line' | 'family-version' | 'install-form' | 'preset-ids' | 'readonly-contract' | 'upgrade-order' | 'fallback-map';
+export type DiagnosticsRuntimeKey = 'subagent-channel' | 'restricted-preset' | 'host-surface' | 'session-fold' | 'platform-services' | 'runs' | 'platform-pairing' | 'install-form-detected';
+export type DiagnosticStatus = 'ok' | 'warn' | 'fail' | 'unknown';
+export interface DocFactRow {
+    readonly key: DiagnosticsFactKey;
+    readonly label: string;
+    readonly value: string;
+    readonly home: string;
+}
+export interface DiagnosticRow {
+    readonly key: DiagnosticsRuntimeKey;
+    readonly label: string;
+    readonly status: DiagnosticStatus;
+    readonly detail?: string;
+    readonly remedy?: string;
+}
+export interface DiagnosticsView {
+    readonly schemaVersion: DiagnosticsSchemaVersion;
+    readonly generatedAt: string;
+    readonly facts: readonly DocFactRow[];
+    readonly runtime: readonly DiagnosticRow[];
+}
+/** The installation form the doctor reports (W8 install-form-detected row). */
+export type InstallFormId = 'M1' | 'M2' | 'M3' | 'M4';
+/** One surface's command-face path(s) — the client `fallbacks.generated.ts` table's row type. */
+export interface FallbackHint {
+    readonly command: string;
+    readonly platformCli?: string;
+}
+//# sourceMappingURL=contracts.generated.d.ts.map

package/lib/types/client/diagnostics-state.d.ts

@@ -0,0 +1,28 @@
+import { type RouteAnswer } from './route-client.generated.ts';
+import type { DiagnosticsView } from './contracts.generated.ts';
+/** What the card renders: the view, or the classified failure that kept it from arriving. */
+export type DiagnosticsState = {
+    readonly phase: 'loading';
+} | {
+    readonly phase: 'ready';
+    readonly view: DiagnosticsView;
+} | {
+    readonly phase: 'failed';
+    readonly failure: import('./route-client.generated.ts').RouteFailure;
+};
+/** The one call the card makes. */
+export interface DiagnosticsApi {
+    view(): Promise<RouteAnswer<DiagnosticsView>>;
+}
+/**
+ * Build the diagnostics face over one fetch implementation.
+ * @param doFetch - the browser fetch, or a spec stub.
+ */
+export declare function createDiagnosticsApi(doFetch?: typeof fetch): DiagnosticsApi;
+/**
+ * Read the view once and map it onto the card's four states (loading is the caller's initial value).
+ * @param doFetch - the fetch to use.
+ * @returns ready with the view, or failed with the classified failure.
+ */
+export declare function loadDiagnostics(doFetch?: typeof fetch): Promise<DiagnosticsState>;
+//# sourceMappingURL=diagnostics-state.d.ts.map

package/lib/types/client/fallbacks.generated.d.ts

@@ -0,0 +1,8 @@
+import type { FallbackHint } from './contracts.generated.ts';
+/**
+ * The command-face fallback for every Host surface, generated from evolution-commands'
+ * COMMAND_FALLBACKS (the ONE home). When the platform's connection carrier is absent (E-325) the
+ * panels render this hint instead of a bare HTTP failure — same use case, command face.
+ */
+export declare const FALLBACKS: Readonly<Record<'approval' | 'skill-history' | 'skill-health' | 'diagnostics', FallbackHint>>;
+//# sourceMappingURL=fallbacks.generated.d.ts.map

package/lib/types/client/messages.d.ts

@@ -28,14 +28,13 @@ export declare const zh: {
     readonly discard: "放弃修改";
     readonly saving: "保存中…";
     readonly resetting: "恢复中…";
-    readonly destHost: "保存去向：本机配置";
+    readonly writeTargetHost: "保存去向：宿主配置（对所有会话生效）";
     readonly invalidNumber: "需要一个数字";
     readonly invalidSelect: "不在允许的取值里";
     readonly invalidAtLeast: "不能小于同组的 {n}";
     readonly approvalConfirmNamed: "即将批准：{n}";
     readonly approvalConfirmYes: "确认批准";
     readonly approvalConfirmNo: "取消";
-    readonly destMemory: "保存去向：仅本次会话";
     readonly resetTo: "复位为 {value}";
     readonly refused: "这个值没有被接受（界面上保持原样）。想看原因：在对话里让它说明。";
     readonly resetRefused: "恢复默认值没有生效（这一行还是你的值）。想看原因：在对话里让它说明。";
@@ -72,6 +71,26 @@ export declare const zh: {
     readonly approvalDiffAdded: "{n} 行新增";
     readonly approvalDiffRemoved: "{n} 行删除";
     readonly approvalDiffCut: "改动区域已截断";
+    readonly diagTitle: "诊断";
+    readonly diagSubtitle: "安装形态、平台线与运行面的当前读数；只读，不改任何东西。";
+    readonly diagFactsTitle: "事实";
+    readonly diagRuntimeTitle: "运行时";
+    readonly diagSchema: "视图 schema v{n}";
+    readonly diagGeneratedAt: "生成于 {at}";
+    readonly diagRefresh: "刷新";
+    readonly diagRefreshing: "刷新中…";
+    readonly diagStatusOk: "正常";
+    readonly diagStatusWarn: "注意";
+    readonly diagStatusFail: "异常";
+    readonly diagStatusUnknown: "未知";
+    readonly diagRemedy: "下一步：";
+    readonly diagHomeCite: "出处：{home}";
+    readonly stateLoading: "正在读取…";
+    readonly failureUnauthorized: "需要登录：重新打开这个页面完成登录后再试。";
+    readonly failureForbidden: "平台拒绝了这个请求（身份不是 owner）。";
+    readonly failureUnmounted: "该功能没有挂载。";
+    readonly failureServer: "读取失败，可以手动重试。";
+    readonly fallbackHint: "可以改用命令：{command}";
 };
 /** English copy, key for key with {@link zh}. */
 export declare const en: Record<keyof typeof zh, string>;
@@ -86,7 +105,7 @@ export type MessageKey = keyof typeof zh;
 /**
  * Resolve one message without the locale seat (tests and the fallback path).
  * @param key - the message key.
- * @param language - which dictionary to read; defaults to Chinese.
+ * @param language - which dictionary to read; defaults to English (the platform FALLBACK_LOCALE).
  * @returns the copy this bundle carries.
  */
 export declare function message(key: MessageKey, language?: 'zh' | 'en'): string;

package/lib/types/client/pending-state.d.ts

@@ -8,6 +8,7 @@
  * @module @lmzhen/dsh-evolution-settings-ui/client/pending-state
  */
 import type { PendingRow, PreviewAnswer } from './api.ts';
+import type { RouteFailure } from './route-client.generated.ts';
 /** What one row's preview is showing while it is open. */
 export type PreviewView = {
     readonly kind: 'loading';
@@ -21,7 +22,7 @@ export type PreviewView = {
     readonly reason: string;
 } | {
     readonly kind: 'failed';
-    readonly message: string;
+    readonly failure: RouteFailure;
 };
 /** What the card is showing right now. */
 export type PendingView = {
@@ -33,7 +34,7 @@ export type PendingView = {
     readonly kind: 'empty';
 } | {
     readonly kind: 'failed';
-    readonly message: string;
+    readonly failure: RouteFailure;
 };
 /** The whole card state: the view, the ids with an action in flight, and the last refusal line. */
 export interface PendingState {
@@ -62,8 +63,8 @@ export declare function loading(state: PendingState): PendingState;
  * being shown the same line a slow answer shows.
  */
 export declare function loaded(state: PendingState, rows: readonly PendingRow[]): PendingState;
-/** The list could not be read: the reason stays on screen next to a retry control. */
-export declare function failed(state: PendingState, message: string): PendingState;
+/** The list could not be read: the classified failure stays on screen next to a retry control. */
+export declare function failed(state: PendingState, failure: RouteFailure): PendingState;
 /** Mark one record as having an action in flight (its buttons are disabled until it ends). */
 export declare function beginAction(state: PendingState, id: string): PendingState;
 /** The action ended, whatever it answered. */

package/lib/types/client/route-client.generated.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The four-state transport classifier every family client shares (W7 §2). The platform owns
+ * admission (401/403/404 are its answers, not ours), so the client reads the STATUS only for those
+ * three and never tries to interpret a platform body. Everything the family route itself answers
+ * keeps its business envelope: 2xx + {ok:true,data} or 2xx + {ok:false,code,message}.
+ */
+export type RouteFailure = {
+    readonly kind: 'unauthenticated';
+    readonly status: 401;
+} | {
+    readonly kind: 'forbidden';
+    readonly status: 403;
+} | {
+    readonly kind: 'unmounted';
+    readonly status: 404;
+} | {
+    readonly kind: 'server';
+    readonly status: number;
+    readonly detail?: string;
+} | {
+    readonly kind: 'refused';
+    readonly code: string;
+    readonly message: string;
+};
+/** One route answer: the data, or the classified failure. */
+export type RouteAnswer<T> = {
+    readonly ok: true;
+    readonly data: T;
+} | {
+    readonly ok: false;
+    readonly failure: RouteFailure;
+};
+/** Classify a non-2xx status: 401/403/404 keep their own kind, everything else is a server answer. */
+export declare function classify(status: number): RouteFailure;
+/**
+ * One request, no retries and no body parsing for the platform's admission answers.
+ * @param doFetch - the fetch in use (the browser's, or a spec's stub).
+ * @param path - the exact route path from the generated ROUTES table.
+ * @param init - standard RequestInit.
+ * @returns the data, or the classified failure (network/parse failures read as 'server').
+ */
+export declare function requestJson<T>(doFetch: typeof fetch, path: string, init?: RequestInit): Promise<RouteAnswer<T>>;
+/** The one-sentence rendering legacy callers attach to a classified failure. */
+export declare function failureMessage(failure: RouteFailure): string;
+//# sourceMappingURL=route-client.generated.d.ts.map

package/lib/types/client/routes.generated.d.ts

@@ -0,0 +1,31 @@
+/** One host data-plane surface the browser half can call. */
+export type SurfaceId = 'approval' | 'skill-history' | 'skill-health' | 'diagnostics';
+/**
+ * Every family host path, generated from evolution-core's HOST_ROUTES (the ONE declaration).
+ * A browser half cannot import the host package at runtime (client bundles keep @deepseek-ai/*
+ * external), so the table is mirrored here mechanically; a rename in core regenerates all three
+ * client copies, and the generator's --check makes a stale copy red.
+ */
+export declare const ROUTES: {
+    readonly approval: {
+        readonly pending: "/api/dsh-evolution/approval/pending";
+        readonly preview: "/api/dsh-evolution/approval/preview";
+        readonly approve: "/api/dsh-evolution/approval/approve";
+        readonly reject: "/api/dsh-evolution/approval/reject";
+    };
+    readonly 'skill-history': {
+        readonly skills: "/api/dsh-evolution/skill-history/skills";
+        readonly versions: "/api/dsh-evolution/skill-history/versions";
+        readonly diff: "/api/dsh-evolution/skill-history/versions/diff";
+        readonly body: "/api/dsh-evolution/skill-history/versions/body";
+        readonly undo: "/api/dsh-evolution/skill-history/undo";
+        readonly health: "/api/dsh-evolution/skill-history/health";
+    };
+    readonly 'skill-health': {
+        readonly rows: "/api/dsh-evolution/skill-health/rows";
+    };
+    readonly diagnostics: {
+        readonly view: "/api/dsh-evolution/diagnostics";
+    };
+};
+//# sourceMappingURL=routes.generated.d.ts.map

package/lib/types/client/seam.d.ts

@@ -35,6 +35,8 @@ export declare function rowConfigKey(bundle: string, rowId: string): string;
  * the section — one definition in the module both sides already share is what keeps that pair acyclic.
  */
 export declare const PENDING_CARD_KEY = "approval-pending";
+/** The diagnostics card's slot key: read-only, no settings namespace (its data comes from HOST_ROUTES.diagnostics). */
+export declare const DIAGNOSTICS_CARD_KEY = "diagnostics";
 /** Snapshot of one settings row, as the client seat reports it. */
 export interface ParamSectionSnapshot {
     status: 'loading' | 'ready' | 'unavailable';
@@ -44,8 +46,6 @@ export interface ParamSectionSnapshot {
     writable: boolean;
     /** U-5: the composition layer a cleared field reverts to (platform `base`, previously dropped). */
     base: Record<string, unknown> | undefined;
-    /** U-5: where a save lands — `memory` means this session only (platform `mode`, previously dropped). */
-    mode: 'host' | 'memory';
     /**
      * Why an `unavailable` snapshot is unavailable: this bundle found no settings seat at
      * all, or the seat is there and serves no such row. The two read differently to the
@@ -84,7 +84,6 @@ export interface ConfigFormSnapshotLike<T = Record<string, unknown>> {
     user: unknown;
     revision: number | undefined;
     writable: boolean;
-    mode: 'host' | 'memory';
 }
 /** One row's client write face (0.2.x `configForms`). */
 export interface ConfigFormLike<T = Record<string, unknown>> {

package/lib/types/client/states.generated.d.ts

@@ -0,0 +1,43 @@
+import { type ReactNode } from 'react';
+import type { RouteAnswer, RouteFailure } from './route-client.generated.ts';
+import type { FallbackHint } from './contracts.generated.ts';
+/**
+ * The four-state base of every family card (W7 §2). Load states are read from the generated
+ * route-client's answer — a card owns no HTTP vocabulary and no second state machine.
+ */
+export type LoadState<T> = {
+    readonly phase: 'loading';
+} | {
+    readonly phase: 'ready';
+    readonly data: T;
+} | {
+    readonly phase: 'empty';
+} | {
+    readonly phase: 'failed';
+    readonly failure: RouteFailure;
+};
+/** Map one classified answer onto the card's four states. */
+export declare function loadStateOf<T>(answer: RouteAnswer<T>, isEmpty: (data: T) => boolean): LoadState<T>;
+/** The locale lookup every block calls (the platform's own `t`). */
+export interface Translate {
+    (key: string, values?: Readonly<Record<string, string | number>>): string;
+}
+export type BlockTone = 'neutral' | 'warn' | 'fail';
+export interface BlockProps {
+    readonly tone?: BlockTone;
+    readonly title?: string;
+    readonly children?: ReactNode;
+}
+/** A neutral/ warn/ fail block; a fail block is role=alert so assistive tech announces it. */
+export declare function Block(props: BlockProps): ReactNode;
+export interface FailureBlockProps {
+    readonly failure: RouteFailure;
+    readonly t: Translate;
+    /** The command-face fallback for this surface (rendered on unmounted/failed answers). */
+    readonly fallback?: FallbackHint | undefined;
+}
+/** One classified failure as a reader-facing sentence. */
+export declare function failureText(failure: RouteFailure, t: Translate): string;
+/** The failed-state block: sentence + (when the surface exists but is unreachable) the command fallback. */
+export declare function FailureBlock(props: FailureBlockProps): ReactNode;
+//# sourceMappingURL=states.generated.d.ts.map

package/lib/types/client/styles.d.ts

@@ -5,9 +5,13 @@ export declare const CSS: string;
 /** The slice of the DOM the injection touches (this package typechecks without DOM lib). */
 interface StyleHost {
     querySelector(selector: string): unknown;
+    /** The element shape the injection uses. `remove()` is on the real DOM element and is what the
+     * S5-08 disposer calls, so the host shape names it too - otherwise the package cannot typecheck
+     * without the DOM lib while still using the disposal the browser offers. */
     createElement(tag: string): {
         dataset: Record<string, string>;
         textContent: string;
+        remove(): void;
     };
     head: {
         appendChild(node: unknown): void;
@@ -15,8 +19,14 @@ interface StyleHost {
 }
 /**
  * Inject the stylesheet once per document.
+ *
+ * S5-08: it RETURNS the disposer. The tag check alone answered only half the question - "is it
+ * there" - and left "who takes it away" to nobody, so a hot reload (unmount, remount) found the old
+ * tag, skipped the injection, and kept serving the PREVIOUS bundle CSS. skill-history hands its
+ * disposer back to the fiber; this is the same shape for the same concern.
  * @param host - the document to inject into; defaults to the global one.
+ * @returns the disposal; a no-op when there is no document or the tag was already present.
  */
-export declare function injectStyles(host?: StyleHost): void;
+export declare function injectStyles(host?: StyleHost): () => void;
 export {};
 //# sourceMappingURL=styles.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-settings-ui",
   "description": "Web settings cards for the evolution family's parameter namespaces (community build)",
-  "version": "0.26.15",
+  "version": "0.27.0",
   "publishConfig": {
     "access": "public"
   },
@@ -39,7 +39,10 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/cordis": "^4.0.5",
     "react": "^18.2.0"
+  },
+  "engines": {
+    "dsh": ">=0.2.1-rc.1 <0.2.2-0"
   }
 }

package/lib/types/client/approval-routes.d.ts

@@ -1,17 +0,0 @@
-/**
- * The approval paths this browser half calls.
- *
- * A browser half cannot import the host package's table at runtime (the family's client bundles treat
- * every `@deepseek-ai/*` specifier as external), so the literals are declared here and a spec compares
- * them against `APPROVAL_ROUTES` in `evolution-approval` — a rename on one side would otherwise surface
- * as a 404 in the GUI instead of in CI.
- * @module @lmzhen/dsh-evolution-settings-ui/client/approval-routes
- */
-/** One path per call the pending card makes. */
-export declare const APPROVAL_CLIENT_ROUTES: {
-    readonly pending: "/api/dsh-evolution/approval/pending";
-    readonly approve: "/api/dsh-evolution/approval/approve";
-    readonly reject: "/api/dsh-evolution/approval/reject";
-    readonly preview: "/api/dsh-evolution/approval/preview";
-};
-//# sourceMappingURL=approval-routes.d.ts.map