create-principles-disciple 1.85.0 → 1.87.0

package/console/dist/ui/pages/settings/SettingsPage.js

@@ -1,8 +1,11 @@
-import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useState, useEffect, useCallback } from "react";
 import { useTranslation } from "react-i18next";
 import { toast } from "sonner";
+import { useNotifications } from "../../components/notifications/useNotifications.js";
+import { cn } from "../../../lib/utils.js";
 import { PageShell } from "../../components/layout/page-shell.js";
+import { PageLoading } from "../../components/layout/page-loading.js";
 import { SectionTitle } from "../../components/layout/section-title.js";
 import { getToken, setToken, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchOutputLanguage, updateOutputLanguage, } from "../../api.js";
 // ── Runtime validators (H section / ERR-001/005/009/013) ─────────────────────
@@ -72,6 +75,7 @@ export function validateWorkspaceArray(raw) {
 }
 export function SettingsPage() {
     const { t } = useTranslation();
+    const { soundEnabled, setSoundEnabled } = useNotifications();
     const [loadingState, setLoadingState] = useState("loading");
     const [errorMessage, setErrorMessage] = useState(null);
     // Auth token state
@@ -189,14 +193,14 @@ export function SettingsPage() {
     }, [t]);
     // ── Loading state ────────────────────────────────────────────────────────
     if (loadingState === "loading") {
-        return (_jsx(PageShell, { children: _jsxs("div", { className: "text-ink-3 text-sm", role: "status", "aria-live": "polite", children: [t("common.loading"), "\u2026"] }) }));
+        return (_jsx(PageShell, { children: _jsx(PageLoading, { cardCount: 3, label: t("common.loading") }) }));
     }
     // ── Error state (ERR-002: degradation with reason) ───────────────────────
     if (loadingState === "error") {
         return (_jsxs(PageShell, { children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.settings.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.settings.title") }), _jsxs("div", { className: "mt-6 p-4 bg-panel border border-line rounded-[6px] text-ink-2 text-sm", children: [_jsx("p", { children: t("pages.settings.loadError") }), errorMessage && (_jsx("p", { className: "mt-2 text-ink-4 text-[13px] font-mono", children: errorMessage }))] })] }));
     }
     // ── Loaded state ─────────────────────────────────────────────────────────
-    return (_jsxs(PageShell, { children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.settings.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.settings.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.settings.subtitle") }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-auth", children: [_jsx(SectionTitle, { id: "section-auth", children: t("pages.settings.auth") }), _jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: [_jsx("label", { htmlFor: "bearer-token-input", className: "block text-sm font-medium text-ink mb-2", children: t("pages.settings.bearerToken") }), _jsx("input", { id: "bearer-token-input", type: "password", value: tokenInput, onChange: (e) => setTokenInput(e.target.value), placeholder: t("pages.settings.enterAccessToken"), className: "w-full border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov" }), _jsxs("div", { className: "flex items-center justify-between mt-3", children: [_jsx("button", { onClick: handleSaveToken, disabled: tokenInput.trim().length === 0, className: "border border-gov bg-gov text-paper rounded-[3px] px-[14px] py-[6px] text-[12.5px] font-medium hover:bg-gov-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("common.save") }), _jsx("span", { className: "text-ink-4 text-[12px]", children: t("pages.settings.tokenSessionOnly") })] })] })] }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-principle-language", children: [_jsx(SectionTitle, { id: "section-principle-language", children: t("pages.settings.principleLanguage") }), _jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: [_jsx("p", { className: "text-ink-3 text-[13px] leading-relaxed mb-3", children: t("pages.settings.principleLanguageDescription") }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsxs("label", { htmlFor: "output-language-select", className: "text-sm font-medium text-ink", children: [t("pages.settings.principleLanguage"), ":"] }), _jsxs("select", { id: "output-language-select", value: outputLanguage, onChange: (e) => handleOutputLanguageChange(e.target.value), className: "border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov", children: [_jsx("option", { value: "zh-CN", children: t("pages.settings.languageZhCN") }), _jsx("option", { value: "en", children: t("pages.settings.languageEn") })] })] })] })] }), _jsxs("section", { "aria-labelledby": "section-workspaces", children: [_jsx(SectionTitle, { id: "section-workspaces", children: t("pages.settings.workspace") }), workspaces.length > 0 ? (_jsx("div", { className: "space-y-[10px] mb-5", children: workspaces.map((ws) => (_jsx("article", { className: "bg-panel border border-line rounded-[6px] p-5", children: _jsxs("div", { className: "flex items-start justify-between gap-4", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "font-medium text-ink text-sm", children: ws.name }), _jsx("div", { className: "text-ink-3 text-[13px] mt-1 font-mono break-all", children: ws.path }), _jsxs("div", { className: "text-ink-4 text-[12px] mt-1", children: [t("pages.settings.lastSync"), ":", " ", ws.lastSync ?? "—"] })] }), _jsx("div", { className: "flex items-center gap-2 shrink-0", children: confirmRemove?.workspaceName === ws.name ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-ink-2 text-[12px]", children: t("pages.settings.confirmDeleteDescription", {
-                                                        name: ws.name,
-                                                    }) }), _jsx("button", { onClick: () => handleRemoveWorkspace(ws.name), className: "border border-gov bg-gov text-paper rounded-[3px] px-[14px] py-[6px] text-[12.5px] font-medium hover:bg-gov-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("common.confirm") }), _jsx("button", { onClick: () => setConfirmRemove(null), className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("common.cancel") })] })) : (_jsxs(_Fragment, { children: [_jsx("button", { onClick: () => handleSyncWorkspace(ws.name), className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.settings.syncWorkspace") }), _jsx("button", { onClick: () => setConfirmRemove({ workspaceName: ws.name }), className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.settings.removeWorkspace") })] })) })] }) }, ws.name))) })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3 mb-5", children: "\u2014" })), _jsx("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: _jsxs("div", { className: "flex items-end gap-3", children: [_jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("label", { htmlFor: "add-workspace-name", className: "block text-sm font-medium text-ink mb-2", children: t("pages.settings.name") }), _jsx("input", { id: "add-workspace-name", type: "text", value: addName, onChange: (e) => setAddName(e.target.value), placeholder: t("pages.settings.addNamePlaceholder"), className: "w-full border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov" })] }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("label", { htmlFor: "add-workspace-path", className: "block text-sm font-medium text-ink mb-2", children: t("pages.settings.path") }), _jsx("input", { id: "add-workspace-path", type: "text", value: addPath, onChange: (e) => setAddPath(e.target.value), placeholder: t("pages.settings.addPathPlaceholder"), className: "w-full border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov" })] }), _jsx("button", { onClick: handleAddWorkspace, disabled: addName.trim().length === 0 || addPath.trim().length === 0, className: "border border-gov bg-gov text-paper rounded-[3px] px-[14px] py-[6px] text-[12.5px] font-medium hover:bg-gov-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed shrink-0 focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.settings.addWorkspace") })] }) })] })] }));
+    return (_jsx(PageShell, { children: _jsxs("div", { className: "animate-[pdFadeIn_400ms_ease-out]", children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.settings.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.settings.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.settings.subtitle") }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-auth", children: [_jsx(SectionTitle, { id: "section-auth", children: t("pages.settings.auth") }), _jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: [_jsx("label", { htmlFor: "bearer-token-input", className: "block text-sm font-medium text-ink mb-2", children: t("pages.settings.bearerToken") }), _jsx("input", { id: "bearer-token-input", type: "password", value: tokenInput, onChange: (e) => setTokenInput(e.target.value), placeholder: t("pages.settings.enterAccessToken"), className: "w-full border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov" }), _jsxs("div", { className: "flex items-center justify-between mt-3", children: [_jsx("button", { onClick: handleSaveToken, disabled: tokenInput.trim().length === 0, className: "border border-gov bg-gov text-paper rounded-[3px] px-[14px] py-[6px] text-[12.5px] font-medium hover:bg-gov-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("common.save") }), _jsx("span", { className: "text-ink-4 text-[12px]", children: t("pages.settings.tokenSessionOnly") })] })] })] }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-principle-language", children: [_jsx(SectionTitle, { id: "section-principle-language", children: t("pages.settings.principleLanguage") }), _jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: [_jsx("p", { className: "text-ink-3 text-[13px] leading-relaxed mb-3", children: t("pages.settings.principleLanguageDescription") }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsxs("label", { htmlFor: "output-language-select", className: "text-sm font-medium text-ink", children: [t("pages.settings.principleLanguage"), ":"] }), _jsxs("select", { id: "output-language-select", value: outputLanguage, onChange: (e) => handleOutputLanguageChange(e.target.value), className: "border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov", children: [_jsx("option", { value: "zh-CN", children: t("pages.settings.languageZhCN") }), _jsx("option", { value: "en", children: t("pages.settings.languageEn") })] })] })] })] }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-sound-alerts", children: [_jsx(SectionTitle, { id: "section-sound-alerts", children: t("pages.settings.notifications") }), _jsx("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: _jsxs("div", { className: "flex items-center justify-between gap-4", children: [_jsxs("div", { children: [_jsx("label", { htmlFor: "sound-alerts-toggle", className: "block text-sm font-medium text-ink", children: t("pages.settings.soundAlerts") }), _jsx("p", { className: "text-ink-3 text-[13px] leading-relaxed mt-1", children: t("pages.settings.soundAlertsDescription") })] }), _jsx("button", { id: "sound-alerts-toggle", type: "button", role: "switch", "aria-checked": soundEnabled, onClick: () => setSoundEnabled(!soundEnabled), className: cn("relative inline-flex h-6 w-11 items-center rounded-full transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", soundEnabled ? "bg-gov" : "bg-line"), children: _jsx("span", { className: cn("inline-block h-4 w-4 transform rounded-full bg-paper transition-transform", soundEnabled ? "translate-x-6" : "translate-x-1") }) })] }) })] }), _jsxs("section", { "aria-labelledby": "section-workspaces", children: [_jsx(SectionTitle, { id: "section-workspaces", children: t("pages.settings.workspace") }), workspaces.length > 0 ? (_jsx("div", { className: "space-y-[10px] mb-5", children: workspaces.map((ws) => (_jsx("article", { className: "bg-panel border border-line rounded-[6px] p-5", children: _jsxs("div", { className: "flex items-start justify-between gap-4", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "font-medium text-ink text-sm", children: ws.name }), _jsx("div", { className: "text-ink-3 text-[13px] mt-1 font-mono break-all", children: ws.path }), _jsxs("div", { className: "text-ink-4 text-[12px] mt-1", children: [t("pages.settings.lastSync"), ":", " ", ws.lastSync ?? "—"] })] }), _jsx("div", { className: "flex items-center gap-2 shrink-0", children: confirmRemove?.workspaceName === ws.name ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-ink-2 text-[12px]", children: t("pages.settings.confirmDeleteDescription", {
+                                                            name: ws.name,
+                                                        }) }), _jsx("button", { onClick: () => handleRemoveWorkspace(ws.name), className: "border border-gov bg-gov text-paper rounded-[3px] px-[14px] py-[6px] text-[12.5px] font-medium hover:bg-gov-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("common.confirm") }), _jsx("button", { onClick: () => setConfirmRemove(null), className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("common.cancel") })] })) : (_jsxs(_Fragment, { children: [_jsx("button", { onClick: () => handleSyncWorkspace(ws.name), className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.settings.syncWorkspace") }), _jsx("button", { onClick: () => setConfirmRemove({ workspaceName: ws.name }), className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.settings.removeWorkspace") })] })) })] }) }, ws.name))) })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3 mb-5", children: "\u2014" })), _jsx("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: _jsxs("div", { className: "flex items-end gap-3", children: [_jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("label", { htmlFor: "add-workspace-name", className: "block text-sm font-medium text-ink mb-2", children: t("pages.settings.name") }), _jsx("input", { id: "add-workspace-name", type: "text", value: addName, onChange: (e) => setAddName(e.target.value), placeholder: t("pages.settings.addNamePlaceholder"), className: "w-full border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov" })] }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("label", { htmlFor: "add-workspace-path", className: "block text-sm font-medium text-ink mb-2", children: t("pages.settings.path") }), _jsx("input", { id: "add-workspace-path", type: "text", value: addPath, onChange: (e) => setAddPath(e.target.value), placeholder: t("pages.settings.addPathPlaceholder"), className: "w-full border border-line bg-surface rounded-[3px] px-3 py-2 text-sm text-ink focus:outline-none focus:border-gov focus:ring-1 focus:ring-gov" })] }), _jsx("button", { onClick: handleAddWorkspace, disabled: addName.trim().length === 0 || addPath.trim().length === 0, className: "border border-gov bg-gov text-paper rounded-[3px] px-[14px] py-[6px] text-[12.5px] font-medium hover:bg-gov-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed shrink-0 focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.settings.addWorkspace") })] }) })] })] }) }));
 }

package/console/dist/ui/pages/settings/UpdatePage.d.ts

@@ -1,5 +1 @@
-import type { UpdateStatusData, UpdateHistoryEntry, UpdateHistoryData } from "../../api.js";
-export declare function validateUpdateStatusData(raw: unknown): UpdateStatusData | null;
-export declare function validateUpdateHistoryEntry(raw: unknown): UpdateHistoryEntry | null;
-export declare function validateUpdateHistoryData(raw: unknown): UpdateHistoryData | null;
 export declare function UpdatePage(): import("react/jsx-runtime").JSX.Element;

package/console/dist/ui/pages/settings/UpdatePage.js

@@ -1,74 +1,23 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * UpdatePage — PD self-update status and history.
+ *
+ * Contract aligned with backend routes/update.ts:
+ * - GET /api/update/check → { hasUpdate, currentVersion, latestVersion, error? }
+ * - GET /api/update/history → [{ id, timestamp, fromVersion, toVersion, success }, ...]
+ *
+ * Privacy boundary: version strings and timestamps only — no session/path data.
+ */
 import { useState, useEffect, useCallback } from "react";
 import { useTranslation } from "react-i18next";
 import { toast } from "sonner";
 import { PageShell } from "../../components/layout/page-shell.js";
+import { PageLoading } from "../../components/layout/page-loading.js";
 import { SectionTitle } from "../../components/layout/section-title.js";
-import { fetchUpdateStatus, fetchUpdateHistory, } from "../../api.js";
-// ── Runtime validators (H section / ERR-001/005/009/013) ─────────────────────
-/** Type guard: is this a non-null object with own properties (not inherited)? */
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-export function validateUpdateStatusData(raw) {
-    if (!isRecord(raw))
-        return null;
-    if (!Object.hasOwn(raw, "currentVersion") ||
-        !Object.hasOwn(raw, "latestVersion") ||
-        !Object.hasOwn(raw, "updateAvailable") ||
-        !Object.hasOwn(raw, "lastChecked")) {
-        return null;
-    }
-    const currentVersion = raw.currentVersion;
-    const latestVersion = raw.latestVersion;
-    const updateAvailable = raw.updateAvailable;
-    const lastChecked = raw.lastChecked;
-    if (typeof currentVersion !== "string" ||
-        typeof latestVersion !== "string" ||
-        typeof updateAvailable !== "boolean" ||
-        typeof lastChecked !== "string") {
-        return null;
-    }
-    return { currentVersion, latestVersion, updateAvailable, lastChecked };
-}
-export function validateUpdateHistoryEntry(raw) {
-    if (!isRecord(raw))
-        return null;
-    if (!Object.hasOwn(raw, "version") ||
-        !Object.hasOwn(raw, "appliedAt") ||
-        !Object.hasOwn(raw, "notes")) {
-        return null;
-    }
-    const version = raw.version;
-    const appliedAt = raw.appliedAt;
-    const notes = raw.notes;
-    if (typeof version !== "string" ||
-        typeof appliedAt !== "string" ||
-        typeof notes !== "string") {
-        return null;
-    }
-    return { version, appliedAt, notes };
-}
-export function validateUpdateHistoryData(raw) {
-    if (!isRecord(raw))
-        return null;
-    if (!Object.hasOwn(raw, "updates")) {
-        return null;
-    }
-    const updates = raw.updates;
-    if (!Array.isArray(updates)) {
-        return null;
-    }
-    // Fail loud: any invalid entry rejects the entire payload (ERR-009)
-    const validatedEntries = [];
-    for (const entry of updates) {
-        const validated = validateUpdateHistoryEntry(entry);
-        if (validated === null)
-            return null;
-        validatedEntries.push(validated);
-    }
-    return { updates: validatedEntries };
-}
+import { fetchUpdateStatus, fetchUpdateHistory, applyUpdate, rollbackUpdate, } from "../../api.js";
+import { validateUpdateStatus, validateUpdateHistory } from "../../utils/validators.js";
+import { AlertDialog, AlertDialogContent, AlertDialogHeader, AlertDialogTitle, AlertDialogDescription, AlertDialogFooter, AlertDialogCancel, AlertDialogAction, } from "../../components/ui/alert-dialog.js";
+import { Loader2, RotateCcw, CheckCircle2, XCircle, ArrowRight } from "lucide-react";
 // ── Helper: format ISO date string to locale-aware display ────────────────────
 function formatDate(isoString, locale) {
     try {
@@ -95,6 +44,12 @@ export function UpdatePage() {
     const [checking, setChecking] = useState(false);
     const [errorMessage, setErrorMessage] = useState(null);
     const [historyErrorReason, setHistoryErrorReason] = useState(null);
+    const [updating, setUpdating] = useState(false);
+    const [updateResult, setUpdateResult] = useState(null);
+    const [showUpdateDialog, setShowUpdateDialog] = useState(false);
+    const [showRollbackDialog, setShowRollbackDialog] = useState(null);
+    const [rollingBack, setRollingBack] = useState(false);
+    const [rollbackResult, setRollbackResult] = useState(null);
     const locale = i18n.language === "zh-CN" ? "zh-CN" : "en-US";
     const loadData = useCallback(async () => {
         setLoadingState("loading");
@@ -110,7 +65,7 @@ export function UpdatePage() {
             setErrorMessage(statusResult.error);
             return;
         }
-        const validatedStatus = validateUpdateStatusData(statusResult.data);
+        const validatedStatus = validateUpdateStatus(statusResult.data);
         if (validatedStatus === null) {
             setLoadingState("error");
             setErrorMessage("Update status data has unexpected shape");
@@ -123,7 +78,7 @@ export function UpdatePage() {
             setHistoryErrorReason(historyResult.error ?? "Update history unavailable");
         }
         else {
-            const validatedHistory = validateUpdateHistoryData(historyResult.data);
+            const validatedHistory = validateUpdateHistory(historyResult.data);
             setHistoryData(validatedHistory);
             if (validatedHistory === null) {
                 setHistoryErrorReason("Update history data has unexpected shape");
@@ -142,7 +97,7 @@ export function UpdatePage() {
             setChecking(false);
             return;
         }
-        const validated = validateUpdateStatusData(result.data);
+        const validated = validateUpdateStatus(result.data);
         if (validated === null) {
             toast.error(t("pages.update.checkFailed"));
             setChecking(false);
@@ -151,18 +106,66 @@ export function UpdatePage() {
         setStatusData(validated);
         setChecking(false);
     }, [t]);
+    const handleApplyUpdate = useCallback(async () => {
+        setShowUpdateDialog(false);
+        setUpdating(true);
+        setUpdateResult(null);
+        const result = await applyUpdate();
+        setUpdating(false);
+        if (!result.success) {
+            setUpdateResult({ success: false, message: result.error ?? 'Unknown error' });
+            toast.error(t('pages.update.updateFailed', { message: result.error ?? 'Unknown error' }));
+            return;
+        }
+        const data = result.data;
+        if (data.success) {
+            setUpdateResult({
+                success: true,
+                message: data.message,
+                newVersion: data.newVersion,
+                updatedFiles: data.updatedFiles,
+                fromVersion: statusData?.currentVersion,
+            });
+            toast.success(t('pages.update.updateSuccess', { version: data.newVersion ?? 'latest' }));
+            await loadData();
+        }
+        else {
+            setUpdateResult({ success: false, message: data.message });
+            toast.error(t('pages.update.updateFailed', { message: data.message }));
+        }
+    }, [t, loadData]);
+    const handleRollback = useCallback(async (backupDir) => {
+        setShowRollbackDialog(null);
+        setRollingBack(true);
+        setRollbackResult(null);
+        const result = await rollbackUpdate(backupDir);
+        setRollingBack(false);
+        if (!result.success) {
+            setRollbackResult({ success: false, message: result.error ?? 'Unknown error' });
+            toast.error(t('pages.update.rollbackFailed', { message: result.error ?? 'Unknown error' }));
+            return;
+        }
+        if (result.data.success) {
+            setRollbackResult({ success: true, message: result.data.message });
+            toast.success(t('pages.update.rollbackSuccess'));
+            await loadData();
+        }
+        else {
+            setRollbackResult({ success: false, message: result.data.message });
+            toast.error(t('pages.update.rollbackFailed', { message: result.data.message }));
+        }
+    }, [t, loadData]);
     // ── Loading state ────────────────────────────────────────────────────────
     if (loadingState === "loading") {
-        return (_jsx(PageShell, { children: _jsxs("div", { className: "text-ink-3 text-sm", role: "status", "aria-live": "polite", children: [t("common.loading"), "\u2026"] }) }));
+        return (_jsx(PageShell, { children: _jsx(PageLoading, { cardCount: 2, label: t("common.loading") }) }));
     }
     // ── Error state (ERR-002: degradation with reason) ───────────────────────
     if (loadingState === "error") {
         return (_jsxs(PageShell, { children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.update.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.update.title") }), _jsxs("div", { className: "mt-6 p-4 bg-panel border border-line rounded-[6px] text-ink-2 text-sm", children: [_jsx("p", { children: t("pages.update.loadError") }), errorMessage && (_jsx("p", { className: "mt-2 text-ink-4 text-[13px] font-mono", children: errorMessage }))] })] }));
     }
     // ── Loaded state ─────────────────────────────────────────────────────────
-    const isUpToDate = statusData ? !statusData.updateAvailable : true;
-    const lastCheckedDisplay = statusData
-        ? (statusData.lastChecked ? formatDate(statusData.lastChecked, locale) : t("pages.update.neverChecked"))
-        : t("pages.update.neverChecked");
-    return (_jsxs(PageShell, { children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.update.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.update.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.update.subtitle") }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-update-status", children: [_jsx(SectionTitle, { id: "section-update-status", children: t("pages.update.currentVersion") }), _jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: [_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.currentVersion") }), _jsx("span", { className: "font-mono text-[13px] text-ink", children: statusData?.currentVersion ?? "—" })] }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.latestVersion") }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "font-mono text-[13px] text-ink", children: statusData?.latestVersion ?? "—" }), isUpToDate ? (_jsx("span", { className: "inline-flex items-center border border-green/35 text-green rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: t("pages.update.upToDate") })) : (_jsx("span", { className: "inline-flex items-center border border-amber/35 text-amber rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: t("pages.update.updateAvailable") }))] })] }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.lastChecked") }), _jsx("span", { className: "text-ink-3 text-[13px]", children: lastCheckedDisplay })] })] }), _jsx("div", { className: "mt-5 pt-4 border-t border-line", children: _jsx("button", { type: "button", onClick: handleCheckForUpdates, disabled: checking, className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: checking ? t("pages.update.checking") : t("pages.update.checkForUpdates") }) })] })] }), _jsxs("section", { "aria-labelledby": "section-update-history", children: [_jsx(SectionTitle, { id: "section-update-history", children: t("pages.update.history") }), historyErrorReason ? (_jsxs("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: [t("pages.update.loadError"), " (", historyErrorReason, ")"] })) : historyData && historyData.updates.length > 0 ? (_jsx("div", { className: "space-y-[10px]", children: historyData.updates.map((entry, index) => (_jsxs("article", { className: "bg-panel border border-line rounded-[6px] px-5 py-4", children: [_jsxs("div", { className: "flex items-center justify-between mb-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "inline-flex items-center border border-line rounded-[2px] px-[7px] py-1 font-mono text-[11px] text-ink-3 bg-surface/80 uppercase", children: t("pages.update.version") }), _jsx("span", { className: "font-mono text-[13px] text-ink", children: entry.version })] }), _jsx("span", { className: "text-ink-3 text-[13px]", children: formatDate(entry.appliedAt, locale) })] }), entry.notes && (_jsx("div", { className: "text-ink-2 text-[13px] leading-relaxed mt-1", children: entry.notes }))] }, `${entry.version}-${index}`))) })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: t("pages.update.noHistory") }))] })] }));
+    const isUpToDate = statusData ? !statusData.hasUpdate : true;
+    return (_jsxs(PageShell, { children: [_jsxs("div", { className: "animate-[pdFadeIn_400ms_ease-out]", children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.update.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.update.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.update.subtitle") }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-update-status", children: [_jsx(SectionTitle, { id: "section-update-status", children: t("pages.update.currentVersion") }), _jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: [_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.currentVersion") }), _jsx("span", { className: "font-mono text-[13px] text-ink", children: statusData?.currentVersion ?? "—" })] }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.latestVersion") }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "font-mono text-[13px] text-ink", children: statusData?.latestVersion ?? "—" }), isUpToDate ? (_jsx("span", { className: "inline-flex items-center border border-green/35 text-green rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: t("pages.update.upToDate") })) : (_jsx("span", { className: "inline-flex items-center border border-amber/35 text-amber rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: t("pages.update.updateAvailable") }))] })] })] }), statusData?.error && (_jsxs("div", { className: "mt-4 pt-3 border-t border-line text-[12px] text-ink-4 font-mono", children: [t("pages.update.checkError"), ": ", statusData.error] })), _jsxs("div", { className: "mt-5 pt-4 border-t border-line flex items-center gap-3", children: [_jsx("button", { type: "button", onClick: handleCheckForUpdates, disabled: checking || updating, className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: checking ? t("pages.update.checking") : t("pages.update.checkForUpdates") }), !isUpToDate && (_jsx("button", { type: "button", onClick: () => setShowUpdateDialog(true), disabled: updating || checking, className: "bg-gov text-white rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:bg-gov/90 transition-colors disabled:opacity-50 disabled:cursor-not-allowed focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: updating ? (_jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx(Loader2, { className: "h-3.5 w-3.5 animate-spin" }), t("pages.update.updating")] })) : (t("pages.update.applyUpdate")) }))] }), updateResult && (_jsx("div", { className: `mt-4 p-4 rounded-[6px] border animate-[pdFadeIn_400ms_ease-out] ${updateResult.success ? 'bg-green/5 border-green/20' : 'bg-red/5 border-red/20'}`, children: _jsxs("div", { className: "flex items-start gap-3", children: [updateResult.success ? (_jsx(CheckCircle2, { className: "h-6 w-6 text-green shrink-0 mt-0.5 animate-[pdFadeIn_600ms_ease-out]", style: { transform: 'scale(1)', animationFillMode: 'both' } })) : (_jsx(XCircle, { className: "h-6 w-6 text-red shrink-0 mt-0.5" })), _jsxs("div", { className: "flex-1 min-w-0", children: [updateResult.success && updateResult.fromVersion && updateResult.newVersion && (_jsxs("div", { className: "flex items-center gap-2 mb-1.5", children: [_jsx("span", { className: "font-mono text-[13px] text-ink-3 line-through", children: updateResult.fromVersion }), _jsx(ArrowRight, { className: "h-3.5 w-3.5 text-green" }), _jsx("span", { className: "font-mono text-[13px] text-green font-medium", children: updateResult.newVersion })] })), _jsx("p", { className: `text-[13px] ${updateResult.success ? 'text-green' : 'text-red'}`, children: updateResult.message }), updateResult.success && updateResult.updatedFiles && updateResult.updatedFiles.length > 0 && (_jsx("p", { className: "mt-1 text-[12px] text-ink-4 font-mono", children: t("pages.update.filesUpdated", { count: updateResult.updatedFiles.length }) })), updateResult.success && (_jsx("p", { className: "mt-2 text-[12px] font-mono text-ink-4", children: t("pages.update.restartHint") })), !updateResult.success && (_jsxs("div", { className: "mt-2 flex items-center gap-2", children: [/network|fetch|timeout|ECONNREFUSED|ENOTFOUND/i.test(updateResult.message) && (_jsx("p", { className: "text-[12px] text-ink-4 font-mono", children: t("pages.update.networkErrorHint") })), _jsx("button", { type: "button", onClick: handleApplyUpdate, disabled: updating, className: "text-[12px] text-red underline hover:text-red/80 disabled:opacity-50", children: t("pages.update.retry") })] }))] })] }) }))] })] }), _jsxs("section", { "aria-labelledby": "section-update-history", children: [_jsx(SectionTitle, { id: "section-update-history", children: t("pages.update.history") }), historyErrorReason ? (_jsxs("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: [t("pages.update.loadError"), " (", historyErrorReason, ")"] })) : historyData && historyData.updates.length > 0 ? (_jsx("div", { className: "space-y-[10px]", children: historyData.updates.map((entry) => (_jsx("article", { className: "bg-panel border border-line rounded-[6px] px-5 py-4", children: _jsxs("div", { className: "flex items-center justify-between", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "inline-flex items-center border border-line rounded-[2px] px-[7px] py-1 font-mono text-[11px] text-ink-3 bg-surface/80 uppercase", children: t("pages.update.version") }), _jsxs("span", { className: "font-mono text-[13px] text-ink", children: [entry.fromVersion, " \u2192 ", entry.toVersion] }), !entry.success && (_jsx("span", { className: "inline-flex items-center border border-red/35 text-red rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: t("pages.update.failed") }))] }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: formatDate(entry.timestamp, locale) }), entry.backupPath && (_jsxs("button", { type: "button", onClick: () => setShowRollbackDialog(entry.backupPath), disabled: rollingBack || updating, className: "flex items-center gap-1 border border-line bg-surface text-ink-3 rounded-[3px] px-[8px] py-[4px] text-[11px] hover:text-ink hover:border-line-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed", title: t("pages.update.rollback"), children: [_jsx(RotateCcw, { className: "h-3 w-3" }), t("pages.update.rollback")] }))] })] }) }, entry.id))) })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: t("pages.update.noHistory") }))] })] }), _jsx(AlertDialog, { open: showUpdateDialog, onOpenChange: setShowUpdateDialog, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: t("pages.update.confirmUpdateTitle") }), _jsx(AlertDialogDescription, { children: t("pages.update.confirmUpdateDesc", { version: statusData?.latestVersion ?? "latest" }) })] }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { children: t("common.cancel") }), _jsx(AlertDialogAction, { onClick: handleApplyUpdate, children: t("pages.update.applyUpdate") })] })] }) }), _jsx(AlertDialog, { open: showRollbackDialog !== null, onOpenChange: (open) => { if (!open)
+                    setShowRollbackDialog(null); }, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: t("pages.update.confirmRollbackTitle") }), _jsx(AlertDialogDescription, { children: t("pages.update.confirmRollbackDesc") })] }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { children: t("common.cancel") }), _jsx(AlertDialogAction, { onClick: () => { if (showRollbackDialog)
+                                        handleRollback(showRollbackDialog); }, children: t("pages.update.rollback") })] })] }) }), rollbackResult && (_jsxs("div", { className: `fixed bottom-4 right-4 max-w-md p-3 rounded-[4px] text-[13px] z-50 ${rollbackResult.success ? 'bg-green/10 border border-green/20 text-green' : 'bg-red/10 border border-red/20 text-red'}`, children: [_jsx("p", { children: rollbackResult.message }), rollbackResult.success && (_jsx("p", { className: "mt-1 text-[12px] font-mono opacity-80", children: t("pages.update.restartHintAfterRollback") }))] }))] }));
 }

package/console/dist/ui/utils/control-center-helpers.d.ts

@@ -18,6 +18,8 @@ export interface RedactedRuntimeProfileSummary {
     type: string;
     label: string;
     apiKeyEnv?: string;
+    provider?: string;
+    model?: string;
     readiness: ReadinessStatus;
 }
 export interface RedactedAgentSummary {

package/console/dist/ui/utils/enum-labels.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Enum Labels — Global enum-to-human-label mapping with i18n fallback.
+ *
+ * Wave 1 of console UX rebuild: eliminates raw enum values (e.g.
+ * "internalization-succeeded", "code_tool_hook", "gone") from the
+ * Owner-facing UI by providing a centralized label resolver with
+ * three-tier fallback: i18n → local map → raw value.
+ *
+ * Root cause being fixed: PainPage's `tFallback(t, 'pages.pain.state_${record.state}', ...)`
+ * generated keys with hyphens (e.g. `state_evidence-only`) that never matched the
+ * i18n keys with underscores (e.g. `state_evidence_only`), so the fallback to the
+ * raw enum value was always taken — exposing machine words like
+ * "internalization-succeeded" to the Owner.
+ *
+ * Design constraints:
+ * - Pure logic, no I/O (ERR-001/ERR-005: no `as` bypasses on untrusted data)
+ * - Category-keyed to avoid cross-enum collisions
+ * - i18n key convention: `common.enums.<category>.<snake_value>`
+ * - Local map keyed by the RAW value (with hyphens) for exact lookup
+ */
+type TFunc = (key: string) => string;
+export type EnumCategory = 'evidenceState' | 'sourceKind' | 'channel' | 'readiness' | 'featureCategory' | 'featureId' | 'confidence' | 'feedbackType' | 'admission';
+/**
+ * Resolve an enum value to a human-readable label.
+ *
+ * Resolution order:
+ * 1. i18n key `common.enums.<category>.<snake_value>` (if the t function
+ *    returns something other than the key itself)
+ * 2. Local fallback map `LOCAL_LABELS[category][rawValue]`
+ * 3. Raw value (last resort — guarantees a non-empty string)
+ *
+ * @param category - The enum category (e.g. 'evidenceState', 'channel')
+ * @param value - The raw enum value (e.g. 'internalization-succeeded')
+ * @param t - i18n translation function (from useTranslation). Optional;
+ *            if omitted, skips straight to the local map.
+ * @returns Human-readable label
+ *
+ * @example
+ * // In a React component:
+ * const { t } = useTranslation();
+ * const stateLabel = enumLabel('evidenceState', record.state, t);
+ * // → "内化完成" (for 'internalization-succeeded')
+ */
+export declare function enumLabel(category: EnumCategory, value: string, t?: TFunc): string;
+/**
+ * Check whether a local label exists for the given category + value.
+ * Useful for conditional rendering (e.g. only show a badge if we can label it).
+ */
+export declare function hasEnumLabel(category: EnumCategory, value: string): boolean;
+export {};

package/console/dist/ui/utils/enum-labels.js

@@ -0,0 +1,164 @@
+/**
+ * Enum Labels — Global enum-to-human-label mapping with i18n fallback.
+ *
+ * Wave 1 of console UX rebuild: eliminates raw enum values (e.g.
+ * "internalization-succeeded", "code_tool_hook", "gone") from the
+ * Owner-facing UI by providing a centralized label resolver with
+ * three-tier fallback: i18n → local map → raw value.
+ *
+ * Root cause being fixed: PainPage's `tFallback(t, 'pages.pain.state_${record.state}', ...)`
+ * generated keys with hyphens (e.g. `state_evidence-only`) that never matched the
+ * i18n keys with underscores (e.g. `state_evidence_only`), so the fallback to the
+ * raw enum value was always taken — exposing machine words like
+ * "internalization-succeeded" to the Owner.
+ *
+ * Design constraints:
+ * - Pure logic, no I/O (ERR-001/ERR-005: no `as` bypasses on untrusted data)
+ * - Category-keyed to avoid cross-enum collisions
+ * - i18n key convention: `common.enums.<category>.<snake_value>`
+ * - Local map keyed by the RAW value (with hyphens) for exact lookup
+ */
+// ── Local fallback maps ──────────────────────────────────────────────────────
+// Used when the i18n key `common.enums.<category>.<snake_value>` is missing.
+// Keys are the RAW enum values (with hyphens) for O(1) exact lookup.
+const LOCAL_LABELS = {
+    evidenceState: {
+        'evidence-only': '仅观察',
+        'recorded-only': '已记录信号',
+        'diagnosis-queued': '诊断排队中',
+        'diagnosis-running': '诊断运行中',
+        'diagnosis-succeeded': '诊断完成',
+        'diagnosis-failed': '诊断失败',
+        'diagnosis-retry-wait': '等待重试',
+        'candidate-generated': '已生成候选',
+        'internalization-missing': '内化缺失',
+        'internalization-pending': '内化待处理',
+        'internalization-running': '内化运行中',
+        'internalization-succeeded': '内化完成',
+        'internalization-failed': '内化失败',
+        'owner-reviewable': '待审查',
+        'malformed': '数据异常',
+        'degraded': '降级',
+    },
+    sourceKind: {
+        'manual': '手动触发',
+        'tool_call': '工具调用',
+        'rulehost': '规则守卫',
+        'empathy_inferred': '共情推断',
+        'review': '审查发现',
+        'unknown': '未知来源',
+    },
+    channel: {
+        'prompt': '提示词 / 可撤销',
+        'defer_archive': '延迟归档',
+        'code_tool_hook': 'Code Tool Hook',
+        'skill': '技能激活（已停用）',
+        'model_training': '模型训练（已停用）',
+    },
+    readiness: {
+        'ready': '就绪',
+        'needs_setup': '待配置',
+        'disabled': '已停用',
+        'not_ready': '未就绪',
+        'unknown': '未知',
+    },
+    featureCategory: {
+        'core': '核心启用',
+        'quiet': '默认关闭',
+        'gone': '已归档（不再激活）',
+        'legacy_retire': '待退役',
+    },
+    featureId: {
+        'prompt': '提示词注入',
+        'code_tool_hook': '代码工具钩子',
+        'defer_archive': '延迟归档',
+        'correction_observer': '纠正观察器',
+        'internalization_auto_consumer': '内化自动消费器',
+        'feedback_channel': '反馈通道',
+        'gfi': '全局摩擦指数',
+        'evolution_worker': '进化工作器',
+        'empathy_observer': '共情观察器',
+        'painEvidenceAdmission': '痛点证据准入',
+        'pain_evidence_admission': '痛点证据准入',
+        'diagnostician_async_cli': '诊断器异步 CLI',
+        'diagnostician_core_grounding': '诊断器核心锚定',
+        'internalization_core_grounding': '内化核心锚定',
+        'diagnostician_split_pipeline': '诊断器分流管线',
+        'l2_dreamer': 'L2 Dreamer 循环',
+    },
+    confidence: {
+        'high': '高',
+        'medium': '中',
+        'low': '低',
+    },
+    feedbackType: {
+        'bug': '缺陷',
+        'confusing': '体验困惑',
+        'privacy_concern': '隐私问题',
+        'feature_request': '功能请求',
+        'other': '其他',
+    },
+    admission: {
+        'store_signal': '已录入信号',
+        'evidence_only': '仅作证据',
+        'owner_confirmation_required': '待确认',
+    },
+};
+// ── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Convert a raw enum value to snake_case for i18n key lookup.
+ * e.g. "evidence-only" → "evidence_only"
+ *      "code_tool_hook" → "code_tool_hook" (already snake)
+ *      "internalization-succeeded" → "internalization_succeeded"
+ */
+function toSnakeCase(value) {
+    return value.replace(/-/g, '_').toLowerCase();
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Resolve an enum value to a human-readable label.
+ *
+ * Resolution order:
+ * 1. i18n key `common.enums.<category>.<snake_value>` (if the t function
+ *    returns something other than the key itself)
+ * 2. Local fallback map `LOCAL_LABELS[category][rawValue]`
+ * 3. Raw value (last resort — guarantees a non-empty string)
+ *
+ * @param category - The enum category (e.g. 'evidenceState', 'channel')
+ * @param value - The raw enum value (e.g. 'internalization-succeeded')
+ * @param t - i18n translation function (from useTranslation). Optional;
+ *            if omitted, skips straight to the local map.
+ * @returns Human-readable label
+ *
+ * @example
+ * // In a React component:
+ * const { t } = useTranslation();
+ * const stateLabel = enumLabel('evidenceState', record.state, t);
+ * // → "内化完成" (for 'internalization-succeeded')
+ */
+export function enumLabel(category, value, t) {
+    // 1. Try i18n first
+    if (t) {
+        const snakeValue = toSnakeCase(value);
+        const i18nKey = `common.enums.${category}.${snakeValue}`;
+        const result = t(i18nKey);
+        if (result !== i18nKey) {
+            return result;
+        }
+    }
+    // 2. Fall back to local map
+    const localMap = LOCAL_LABELS[category];
+    if (localMap && Object.hasOwn(localMap, value)) {
+        return localMap[value];
+    }
+    // 3. Last resort: raw value
+    return value;
+}
+/**
+ * Check whether a local label exists for the given category + value.
+ * Useful for conditional rendering (e.g. only show a badge if we can label it).
+ */
+export function hasEnumLabel(category, value) {
+    const localMap = LOCAL_LABELS[category];
+    return !!localMap && Object.hasOwn(localMap, value);
+}