Track web/src/features/ume: anchor the ume/ ignore rule to the repo root.

The unanchored 'ume/' rule also matched web/src/features/ume/, so UmePage was
never committed and clean checkouts failed to build (App.tsx imports it).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

web/src/features/ume/components/UmeCliConnectPanel.tsx

@@ -0,0 +1,520 @@
+import { Button, Checkbox, Input, Label, TextField } from "@heroui/react";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  apiDelete,
+  apiPatch,
+  apiPost,
+  fetchCliMeta,
+  fetchCliProfiles,
+  fetchManagedNeMeta,
+  fetchUmeCliOverride,
+  fetchUmeNe,
+  postUmeConnectTest,
+} from "../../../services/api";
+import { HopProxyFields, emptyHopProxyFields, type HopProxyFieldsState } from "../../managed-ne/components/HopProxyFields";
+import { HelpHint } from "../../../components/HelpHint";
+import { FieldSelect } from "../../../components/ui/FieldSelect";
+import { queryKeys } from "../../../constants/queryKeys";
+import { useI18n } from "../../../i18n";
+import { useToast } from "../../../hooks/useToast";
+import type { CliConnectProfileItem, UmeCliOverrideItem, UmeNeItem } from "../../../types";
+import { defaultHopTemplate, isAutoHopTemplate, patchHopVendorChange } from "../../managed-ne/lib/hopProxy";
+import { formatSystemTime } from "../../../utils/time";
+
+function connectPillLevel(status: string): "up" | "down" | "unknown" | "warn" {
+  const s = String(status || "").toLowerCase();
+  if (s === "pass" || s === "ok") return "up";
+  if (s === "fail" || s === "error") return "down";
+  if (s === "testing") return "warn";
+  return "unknown";
+}
+
+function formatUmeNePickLabel(row: UmeNeItem): string {
+  const name = String(row.user_label || row.ne_name || row.host_name || "").trim();
+  const ip = String(row.ip_address || "").trim();
+  const id = String(row.ne_id || "").trim();
+  const head = [name, ip].filter(Boolean).join(" · ");
+  return head ? `${head} · ${id}` : id;
+}
+
+type ProfileForm = {
+  id: string;
+  name: string;
+  username: string;
+  password: string;
+  port: number;
+  protocol: string;
+  device_type_default: string;
+  vendor_default: string;
+  is_default: boolean;
+  hop_enabled: boolean;
+  hop: HopProxyFieldsState;
+};
+
+function applyHopTemplate(hop: HopProxyFieldsState, protocol: string, vrf: string, force = false): Partial<HopProxyFieldsState> {
+  if (!force && !isAutoHopTemplate(hop.hop_command_template, hop.hop_vendor, hop.hop_protocol, hop.hop_vrf)) {
+    return {};
+  }
+  return { hop_command_template: defaultHopTemplate(hop.hop_vendor, protocol, vrf) };
+}
+
+const emptyForm = (): ProfileForm => ({
+  id: "",
+  name: "default",
+  username: "",
+  password: "",
+  port: 22,
+  protocol: "ssh",
+  device_type_default: "zte_zxros",
+  vendor_default: "ZTE",
+  is_default: true,
+  hop_enabled: false,
+  hop: emptyHopProxyFields(),
+});
+
+function profileToForm(row: CliConnectProfileItem): ProfileForm {
+  return {
+    id: row.id,
+    name: row.name,
+    username: row.username,
+    password: "",
+    port: row.port,
+    protocol: row.protocol,
+    device_type_default: row.device_type_default,
+    vendor_default: row.vendor_default,
+    is_default: row.is_default,
+    hop_enabled: row.hop_enabled,
+    hop: {
+      hop_vendor: (row.hop_vendor || "bastion") as HopProxyFieldsState["hop_vendor"],
+      hop_host: row.hop_host ?? "",
+      hop_port: row.hop_port ?? 22,
+      hop_protocol: row.hop_protocol ?? "ssh",
+      hop_username: row.hop_username ?? "",
+      hop_password: "",
+      hop_command_template: row.hop_command_template ?? "",
+      hop_vrf: row.hop_vrf ?? "",
+      hop_target_auth_mode: (row.hop_target_auth_mode || "bastion_managed") as HopProxyFieldsState["hop_target_auth_mode"],
+      hop_enter_system_view: Boolean(row.hop_enter_system_view),
+    },
+  };
+}
+
+export function UmeCliConnectPanel({ enabled = true, embedded = false }: { enabled?: boolean; embedded?: boolean }) {
+  const { t } = useI18n();
+  const { showOk, showError } = useToast();
+  const queryClient = useQueryClient();
+  const [form, setForm] = useState<ProfileForm>(emptyForm);
+  const [sampleUmeNeId, setSampleUmeNeId] = useState("");
+  const [sampleFilter, setSampleFilter] = useState("");
+  const [sampleOpen, setSampleOpen] = useState(false);
+  const [debouncedFilter, setDebouncedFilter] = useState("");
+  const [testPending, setTestPending] = useState(false);
+  const sampleSuggestRef = useRef<HTMLDivElement | null>(null);
+
+  const testNeId = sampleUmeNeId.trim();
+
+  useEffect(() => {
+    const timer = window.setTimeout(() => setDebouncedFilter(sampleFilter.trim()), 220);
+    return () => window.clearTimeout(timer);
+  }, [sampleFilter]);
+
+  useEffect(() => {
+    setTestPending(false);
+  }, [testNeId]);
+
+  const metaQuery = useQuery({ queryKey: queryKeys.cliMeta, queryFn: fetchCliMeta, enabled });
+  const neMetaQuery = useQuery({ queryKey: queryKeys.managedNeMeta, queryFn: fetchManagedNeMeta, enabled });
+  const profilesQuery = useQuery({ queryKey: queryKeys.cliProfiles, queryFn: fetchCliProfiles, enabled });
+  const sampleNeQuery = useQuery({
+    queryKey: queryKeys.umeNE(debouncedFilter, 1, 5),
+    queryFn: () => fetchUmeNe({ keyword: debouncedFilter, page: 1, pageSize: 5 }),
+    enabled: enabled && sampleOpen,
+    staleTime: 5000,
+  });
+  const sampleHits = useMemo(
+    () => (sampleNeQuery.data?.items || []).slice(0, 5),
+    [sampleNeQuery.data],
+  );
+
+  useEffect(() => {
+    if (!sampleOpen) return;
+    const el = sampleSuggestRef.current;
+    if (!el) return;
+    const timer = window.setTimeout(() => {
+      const body = el.closest<HTMLElement>('[data-slot="modal-body"], .modal__body');
+      if (body) {
+        const elRect = el.getBoundingClientRect();
+        const bodyRect = body.getBoundingClientRect();
+        const overflow = elRect.bottom - bodyRect.bottom + 16;
+        if (overflow > 0) {
+          body.scrollBy({ top: overflow, behavior: "smooth" });
+          return;
+        }
+      }
+      el.scrollIntoView({ block: "nearest", behavior: "smooth" });
+    }, 50);
+    return () => window.clearTimeout(timer);
+  }, [sampleOpen, sampleHits.length, sampleNeQuery.isFetching]);
+  const overrideQuery = useQuery({
+    queryKey: queryKeys.umeCliOverride(testNeId),
+    queryFn: () => fetchUmeCliOverride(testNeId),
+    enabled: Boolean(testNeId),
+    refetchInterval: (q) => {
+      const status = String(q.state.data?.connect_status || "").toLowerCase();
+      return status === "testing" || testPending ? 2000 : false;
+    },
+  });
+  const overrideResult: UmeCliOverrideItem | null = overrideQuery.data ?? null;
+  const overrideStatus = String(overrideResult?.connect_status || "").toLowerCase();
+  const overrideTesting = overrideStatus === "testing" || (testPending && !overrideResult?.connect_tested_at);
+
+  useEffect(() => {
+    const items = profilesQuery.data?.items || [];
+    const current = items.find((x) => x.id === form.id);
+    const picked = current || items.find((x) => x.is_default) || items[0];
+    if (picked && (!form.id || !current)) {
+      setForm(profileToForm(picked));
+    }
+  }, [profilesQuery.data, form.id]);
+
+  const saveMutation = useMutation({
+    mutationFn: async () => {
+      if (form.hop_enabled) {
+        if (!form.hop.hop_host.trim()) throw new Error(t("managedNe.hop.hostRequired"));
+        if (!form.hop.hop_username.trim()) throw new Error(t("managedNe.hop.userRequired"));
+        if (!form.id && !form.hop.hop_password) throw new Error(t("managedNe.hop.passwordRequired"));
+      }
+      const body = {
+        name: form.name.trim(),
+        username: form.username.trim(),
+        password: form.password || undefined,
+        port: form.port,
+        protocol: form.protocol,
+        device_type_default: form.device_type_default,
+        vendor_default: form.vendor_default,
+        is_default: form.is_default,
+        hop_enabled: form.hop_enabled,
+        hop_vendor: form.hop.hop_vendor,
+        hop_host: form.hop.hop_host,
+        hop_port: form.hop.hop_port,
+        hop_protocol: form.hop.hop_protocol,
+        hop_username: form.hop.hop_username,
+        hop_password: form.hop_enabled ? form.hop.hop_password || undefined : undefined,
+        hop_command_template: form.hop.hop_command_template,
+        hop_vrf: form.hop.hop_vrf,
+        hop_target_auth_mode: form.hop.hop_target_auth_mode,
+        hop_enter_system_view: form.hop.hop_enter_system_view,
+      };
+      if (form.id) {
+        return apiPatch<CliConnectProfileItem>(`/v1/cli/profiles/${form.id}`, body);
+      }
+      return apiPost<CliConnectProfileItem>("/v1/cli/profiles", { ...body, password: form.password });
+    },
+    onSuccess: async (row) => {
+      setForm(profileToForm(row));
+      await queryClient.invalidateQueries({ queryKey: queryKeys.cliProfiles });
+      await queryClient.invalidateQueries({ queryKey: queryKeys.cliMeta });
+      showOk(t("ume.cli.saved"));
+    },
+    onError: (e: Error) => showError(e.message),
+  });
+
+  const connectTestMutation = useMutation({
+    mutationFn: async () => {
+      const id = sampleUmeNeId.trim();
+      if (!id) throw new Error(t("ume.cli.sampleNeRequired"));
+      return postUmeConnectTest([id]);
+    },
+    onSuccess: async () => {
+      const id = sampleUmeNeId.trim();
+      setTestPending(true);
+      showOk(t("ume.cli.connectTestSubmitted"));
+      if (id) {
+        await queryClient.invalidateQueries({ queryKey: queryKeys.umeCliOverride(id) });
+      }
+    },
+    onError: (e: Error) => {
+      setTestPending(false);
+      showError(e.message);
+    },
+  });
+
+  useEffect(() => {
+    if (!testPending) return;
+    if (!overrideResult) return;
+    if (overrideStatus === "testing") return;
+    setTestPending(false);
+    void queryClient.invalidateQueries({ queryKey: queryKeys.cliTargetsAll });
+  }, [testPending, overrideResult, overrideStatus, queryClient]);
+
+  const deviceTypes = neMetaQuery.data?.device_types ?? [];
+  const vendors = neMetaQuery.data?.vendors ?? [];
+  const cliReady = Boolean(metaQuery.data?.cli_profile_ready);
+
+  const body = (
+    <div className={embedded ? "cli-connect-panel" : undefined}>
+      {!embedded ? (
+        <div className="panel__toolbar">
+          <h2>{t("ume.cli.title")}</h2>
+          <HelpHint text={t("ume.cli.hint")} ariaLabel={t("common.help")} />
+        </div>
+      ) : null}
+      <p className="form-field-hint" style={{ marginBottom: 12 }}>
+        {cliReady ? t("ume.cli.statusReady") : t("ume.cli.statusNotReady")}
+      </p>
+      <div className="form-grid">
+        <TextField fullWidth value={form.name} onChange={(name) => setForm({ ...form, name })}>
+          <Label>{t("ume.cli.profileName")}</Label>
+          <Input />
+        </TextField>
+        <TextField
+          fullWidth
+          isRequired
+          value={form.username}
+          onChange={(username) => setForm({ ...form, username })}
+        >
+          <Label>{t("ume.cli.targetUsername")}</Label>
+          <Input placeholder="ca-oper" />
+        </TextField>
+        <TextField
+          fullWidth
+          type="password"
+          value={form.password}
+          onChange={(password) => setForm({ ...form, password })}
+        >
+          <Label>{t("ume.cli.targetPassword")}</Label>
+          <Input placeholder={form.id ? t("ume.cli.passwordKeep") : ""} />
+        </TextField>
+        <FieldSelect
+          label={t("managedNe.form.deviceType")}
+          value={form.device_type_default}
+          onChange={(e) => setForm({ ...form, device_type_default: e.target.value })}
+        >
+          {deviceTypes.map((dt) => (
+            <option key={dt} value={dt}>
+              {dt}
+            </option>
+          ))}
+        </FieldSelect>
+        <FieldSelect
+          label={t("managedNe.form.vendor")}
+          value={form.vendor_default}
+          onChange={(e) => setForm({ ...form, vendor_default: e.target.value })}
+        >
+          {vendors.map((v) => (
+            <option key={v} value={v}>
+              {v}
+            </option>
+          ))}
+        </FieldSelect>
+      </div>
+      <div className="form-fieldset" style={{ marginTop: 16 }}>
+        <div className="form-fieldset__title">{t("managedNe.hop.sectionTitle")}</div>
+        <Checkbox
+          isSelected={form.hop_enabled}
+          onChange={(hop_enabled) => {
+            setForm((prev) => ({
+              ...prev,
+              hop_enabled,
+              ...(hop_enabled
+                ? {
+                    hop: {
+                      ...prev.hop,
+                      ...patchHopVendorChange(prev.hop.hop_vendor, prev.hop),
+                      ...applyHopTemplate(prev.hop, prev.hop.hop_protocol, prev.hop.hop_vrf, true),
+                    },
+                  }
+                : {}),
+            }));
+          }}
+        >
+          <Checkbox.Control>
+            <Checkbox.Indicator />
+          </Checkbox.Control>
+          <Checkbox.Content>{t("managedNe.hop.enable")}</Checkbox.Content>
+        </Checkbox>
+        {form.hop_enabled ? (
+          <div className="hop-proxy-fields">
+            <HopProxyFields
+              value={form.hop}
+              onChange={(patch) => setForm((prev) => ({ ...prev, hop: { ...prev.hop, ...patch } }))}
+              hopPasswordRequired={!form.id}
+              hopPasswordOptional={Boolean(form.id)}
+            />
+          </div>
+        ) : null}
+      </div>
+      <div className="actions-row actions-row--inline" style={{ marginTop: 16 }}>
+        <Button
+          size="sm"
+          variant="primary"
+          isDisabled={saveMutation.isPending}
+          onPress={() => saveMutation.mutate()}
+        >
+          {saveMutation.isPending ? t("managedNe.form.saving") : t("managedNe.form.save")}
+        </Button>
+        <Button size="sm" variant="secondary" onPress={() => setForm(emptyForm())}>
+          {t("ume.cli.newProfile")}
+        </Button>
+        {form.id ? (
+          <Button
+            size="sm"
+            variant="danger"
+            onPress={() => {
+              void (async () => {
+                if (!window.confirm(t("ume.cli.deleteConfirm"))) return;
+                try {
+                  await apiDelete(`/v1/cli/profiles/${form.id}`);
+                  setForm(emptyForm());
+                  await queryClient.invalidateQueries({ queryKey: queryKeys.cliProfiles });
+                  showOk(t("ume.cli.deleted"));
+                } catch (e) {
+                  showError(e instanceof Error ? e.message : String(e));
+                }
+              })();
+            }}
+          >
+            {t("managedNe.delete")}
+          </Button>
+        ) : null}
+      </div>
+      <div className={embedded ? undefined : "panel"} style={{ marginTop: 20 }}>
+        <h3 className={embedded ? "card__section-title" : undefined}>{t("ume.cli.connectTestTitle")}</h3>
+        <div className="cli-connect-test">
+          <div className="cli-connect-test-row">
+            <div className="cli-connect-test-pick">
+              <Input
+                value={sampleFilter}
+                onChange={(e) => {
+                  setSampleFilter(e.target.value);
+                  setSampleUmeNeId("");
+                  setSampleOpen(true);
+                }}
+                onFocus={() => setSampleOpen(true)}
+                onBlur={() => {
+                  window.setTimeout(() => setSampleOpen(false), 160);
+                }}
+                onKeyDown={(e) => {
+                  if (e.key === "Escape") {
+                    setSampleOpen(false);
+                    (e.target as HTMLInputElement).blur();
+                  }
+                  if (e.key === "Enter" && sampleHits[0]) {
+                    e.preventDefault();
+                    const row = sampleHits[0];
+                    setSampleUmeNeId(row.ne_id);
+                    setSampleFilter(formatUmeNePickLabel(row));
+                    setSampleOpen(false);
+                  }
+                }}
+                placeholder={t("ume.cli.sampleNePh")}
+                aria-label={t("ume.cli.connectTestTitle")}
+                aria-autocomplete="list"
+                aria-expanded={sampleOpen}
+              />
+            </div>
+            <Button
+              size="sm"
+              variant="secondary"
+              isDisabled={connectTestMutation.isPending || !testNeId}
+              onPress={() => connectTestMutation.mutate()}
+            >
+              {connectTestMutation.isPending || overrideTesting
+                ? t("managedNe.connect.running")
+                : t("managedNe.connect.run")}
+            </Button>
+          </div>
+          {sampleOpen ? (
+            <div ref={sampleSuggestRef} className="cli-connect-test-suggest" role="listbox">
+              {sampleNeQuery.isLoading ? (
+                <div className="cli-connect-test-suggest__empty">{t("ume.cli.sampleNeLoading")}</div>
+              ) : sampleHits.length === 0 ? (
+                <div className="cli-connect-test-suggest__empty">{t("ume.cli.sampleNeEmpty")}</div>
+              ) : (
+                sampleHits.map((row) => {
+                  const title =
+                    String(row.user_label || row.ne_name || row.ne_id).trim() || row.ne_id;
+                  const meta = [row.ip_address, row.ne_type].filter(Boolean).join(" · ");
+                  return (
+                    <button
+                      key={row.ne_id}
+                      type="button"
+                      className={`cli-connect-test-suggest__item${
+                        row.ne_id === sampleUmeNeId ? " is-active" : ""
+                      }`}
+                      onMouseDown={(e) => e.preventDefault()}
+                      onClick={() => {
+                        setSampleUmeNeId(row.ne_id);
+                        setSampleFilter(formatUmeNePickLabel(row));
+                        setSampleOpen(false);
+                      }}
+                    >
+                      <span className="cli-connect-test-suggest__name">{title}</span>
+                      <span className="cli-connect-test-suggest__meta">
+                        {meta || row.ne_id}
+                      </span>
+                    </button>
+                  );
+                })
+              )}
+            </div>
+          ) : null}
+        </div>
+        {testNeId ? (
+          <div style={{ marginTop: 12 }}>
+            <div className="form-label">{t("ume.cli.connectTestResult")}</div>
+            {overrideQuery.isLoading && !overrideResult ? (
+              <p className="form-field-hint">{t("ume.cli.connectTestWaiting")}</p>
+            ) : overrideTesting ? (
+              <p className="form-field-hint">
+                <span className="inline-spinner" aria-hidden /> {t("ume.cli.connectTestRunning")}
+              </p>
+            ) : overrideResult ? (
+              <>
+                <p style={{ marginTop: 8 }}>
+                  <span className={`conn-pill conn-pill--${connectPillLevel(overrideResult.connect_status)}`}>
+                    {overrideResult.connect_status}
+                  </span>
+                  {overrideResult.connect_message ? (
+                    <span className="connect-detail-summary"> — {overrideResult.connect_message}</span>
+                  ) : null}
+                  {overrideResult.connect_tested_at ? (
+                    <span className="muted" style={{ marginLeft: 8 }}>
+                      {formatSystemTime(overrideResult.connect_tested_at, { assumeUtcNaive: true })}
+                    </span>
+                  ) : null}
+                </p>
+                <pre className="connect-log">
+                  {overrideResult.connect_detail?.trim() ||
+                    overrideResult.connect_message?.trim() ||
+                    t("managedNe.connectDetailEmpty")}
+                </pre>
+              </>
+            ) : testPending ? (
+              <p className="form-field-hint">{t("ume.cli.connectTestWaiting")}</p>
+            ) : (
+              <p className="form-field-hint">{t("managedNe.connectDetailEmpty")}</p>
+            )}
+          </div>
+        ) : null}
+      </div>
+      {(profilesQuery.data?.items || []).length > 1 ? (
+        <div style={{ marginTop: 16 }}>
+          <span className="form-label">{t("ume.cli.existingProfiles")}</span>
+          <div className="actions-row actions-row--inline">
+            {(profilesQuery.data?.items || []).map((p) => (
+              <Button key={p.id} size="sm" variant="ghost" onPress={() => setForm(profileToForm(p))}>
+                {p.name}
+                {p.is_default ? ` (${t("ume.cli.default")})` : ""}
+              </Button>
+            ))}
+          </div>
+        </div>
+      ) : null}
+    </div>
+  );
+
+  if (embedded) return body;
+  return <section className="panel">{body}</section>;
+}

web/src/features/ume/lib/runtimeMessages.ts

@@ -0,0 +1,74 @@
+/** Map backend runtime status codes (rt:* / ws:*) and legacy Chinese to i18n keys. */
+
+type TFunc = (key: string) => string;
+
+const LEGACY_ZH_RUNTIME_ERROR: Record<string, string> = {
+  "启动：正在同步当前告警（完成后连接 WSS）…": "ume.tasks.runtimeError.startup_alarm_sync_before_ws",
+  "启动 REST 全量同步未完成，定时 REST 与 WSS 均待命": "ume.tasks.runtimeError.startup_gate_waiting",
+  "WSS 实时接收中，已跳过 REST 同步": "ume.tasks.runtimeError.wss_active_skip_rest",
+  "正在拉取 UME 当前告警…": "ume.tasks.runtimeError.pulling_alarms_current",
+  "另一条当前告警 REST 同步进行中，已跳过": "ume.tasks.runtimeError.alarms_sync_in_progress_skip",
+  "正在拉取 UME 网元清单…": "ume.tasks.runtimeError.pulling_inventory",
+  "正在拉取 UME 拓扑（节点/链路）…": "ume.tasks.runtimeError.pulling_topology",
+  "未启用或未配置 UME_BASE_URL": "ume.tasks.runtimeError.ume_ws_disabled_no_base_url",
+  "已恢复：将跳过本轮周期等待并尽快同步": "ume.tasks.runtimeError.resumed_sync_soon",
+  "已恢复：将尽快重连 WSS": "ume.tasks.runtimeError.resumed_wss_reconnect",
+  已恢复: "ume.tasks.runtimeError.resumed",
+  初始化: "ume.tasks.wsState.init",
+  已连接: "ume.tasks.wsState.connected",
+  连接中: "ume.tasks.wsState.connecting",
+  已断开: "ume.tasks.wsState.disconnected",
+  无订阅: "ume.tasks.wsState.no_subscription",
+  "等待 token": "ume.tasks.wsState.waiting_token",
+  已暂停: "ume.tasks.wsState.paused",
+  连接异常: "ume.tasks.wsState.error",
+  重连等待: "ume.tasks.wsState.reconnecting",
+  UME订阅已丢失: "ume.tasks.wsState.subscription_lost",
+};
+
+function translatePrefixed(code: string, prefix: string, i18nSection: string, t: TFunc): string | null {
+  if (!code.startsWith(prefix)) return null;
+  const slug = code.slice(prefix.length);
+  if (!slug) return null;
+  const key = `${i18nSection}.${slug}`;
+  const tr = t(key);
+  return tr !== key ? tr : null;
+}
+
+export function runtimeLastError(raw: string | null | undefined, t: TFunc): string {
+  const s = String(raw ?? "").trim();
+  if (!s) return "";
+
+  const rt = translatePrefixed(s, "rt:", "ume.tasks.runtimeError", t);
+  if (rt) return rt;
+  const ws = translatePrefixed(s, "ws:", "ume.tasks.wsState", t);
+  if (ws) return ws;
+
+  if (s === "keepalive_failed") {
+    const tr = t("ume.tasks.runtimeError.keepalive_failed");
+    if (tr !== "ume.tasks.runtimeError.keepalive_failed") return tr;
+  }
+
+  const legacyKey = LEGACY_ZH_RUNTIME_ERROR[s];
+  if (legacyKey) {
+    const tr = t(legacyKey);
+    if (tr !== legacyKey) return tr;
+  }
+
+  return s;
+}
+
+export function wsConnectionLabel(
+  state: string | null | undefined,
+  label: string | null | undefined,
+  t: TFunc,
+): string {
+  const fromLabel = runtimeLastError(label, t);
+  if (fromLabel && fromLabel !== String(label ?? "").trim()) return fromLabel;
+  const st = String(state ?? "").trim();
+  if (st) {
+    const tr = runtimeLastError(`ws:${st}`, t);
+    if (tr) return tr;
+  }
+  return fromLabel || st || "";
+}