gloomberb 0.13.2 → 0.14.0

package/src/plugins/builtin/correlation/relationship/pane.tsx

@@ -1,17 +1,17 @@
 import { useCallback, useEffect, useMemo, useState } from "react";
-import { Box, Text } from "../../../../ui";
-import { Button, usePaneFooter } from "../../../../components";
-import { useShortcut, type KeyEventLike } from "../../../../react/input";
-import { StaticMultiLineChartSurface, StaticScatterChartSurface } from "../../../../components/chart/static";
+import { PaneStatusBody, usePaneFooter, usePaneNoticeFooter } from "../../../../components";
 import { resolveChartPalette } from "../../../../components/chart/core/palette";
-import type { PaneProps, PaneTemplateDef } from "../../../../types/plugin";
+import { StaticMultiLineChartSurface, StaticScatterChartSurface } from "../../../../components/chart/static";
+import { useShortcut, type KeyEventLike } from "../../../../react/input";
 import { usePaneInstance } from "../../../../state/app/context";
 import { colors } from "../../../../theme/colors";
-import { formatNumber } from "../../../../utils/format";
 import { formatTickerListInput } from "../../../../tickers/list";
+import type { PaneProps, PaneTemplateDef } from "../../../../types/plugin";
+import { Box, Text } from "../../../../ui";
+import { formatNumber } from "../../../../utils/format";
 import { usePluginPaneState } from "../../../runtime";
 import { formatDateTime, useBoundTicker } from "../../shared/ticker-request";
-import { RelationshipMetricsTable, RelationshipToggle } from "./controls";
+import { RelationshipMetricsTable } from "./controls";
 import { useRelationshipHistories } from "./history";
 import {
   DEFAULT_RELATIONSHIP_CORRELATION_WINDOW,
@@ -37,16 +37,15 @@ import {
 } from "./view-model";
 
 export {
-  buildRelationshipAnalysis,
-  buildRelationshipGraphSettingsDef,
-  RELATIONSHIP_GRAPH_PANE_ID,
+  RELATIONSHIP_GRAPH_PANE_ID, buildRelationshipAnalysis,
+  buildRelationshipGraphSettingsDef
 } from "./model";
 
-type RelationshipGraphShortcut = "range" | "window" | "correlation" | "regression";
+type RelationshipGraphShortcut = "range" | "window" | "correlation" | "regression" | "refresh";
 
 /**
  * Keys are the first letter of their hint label: [t]ime range, [p]eriod, [c]orr,
- * [f]it line. `r` stays reserved for the app-wide refresh.
+ * [f]it line. `r` refreshes this pair's history.
  */
 export function resolveRelationshipGraphShortcut(
   event: Pick<KeyEventLike, "name" | "key" | "ctrl" | "shift" | "alt" | "meta" | "super">,
@@ -54,6 +53,8 @@ export function resolveRelationshipGraphShortcut(
   if (event.ctrl || event.shift || event.alt || event.meta || event.super) return null;
 
   switch ((event.name ?? event.key ?? "").toLowerCase()) {
+    case "r":
+      return "refresh";
     case "t":
       return "range";
     case "p":
@@ -79,7 +80,7 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
   const [showCorrelation, setShowCorrelation] = usePluginPaneState<boolean>("showCorrelation", true);
   const [showRegression, setShowRegression] = usePluginPaneState<boolean>("showRegression", true);
   const [cursorDateMs, setCursorDateMs] = useState<number | null>(null);
-  const { data, loading, error } = useRelationshipHistories(pair, range, exchange);
+  const { data, loading, error, reload, updatedAt } = useRelationshipHistories(pair, range, exchange);
   const left = data?.[0] ?? null;
   const right = data?.[1] ?? null;
   const analysis = useMemo(() => (
@@ -98,7 +99,7 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
   const chartWidth = Math.max(20, width - 2);
   // Panels are allocated in priority order out of the rows that actually exist, so
   // a short pane drops the lowest-priority chart instead of clipping every axis.
-  const headerRows = 2;
+  const headerRows = 1;
   const availableChartRows = Math.max(0, height - headerRows);
   const railWidth = chartWidth >= 68 ? Math.min(34, Math.floor(chartWidth * 0.3)) : 0;
   const statsBelowRows = railWidth === 0 ? 1 : 0;
@@ -195,6 +196,11 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
   useShortcut((event) => {
     if (!focused) return;
     switch (resolveRelationshipGraphShortcut(event)) {
+      case "refresh":
+        event.preventDefault();
+        event.stopPropagation();
+        void reload();
+        return;
       case "range":
         event.preventDefault();
         event.stopPropagation();
@@ -218,43 +224,52 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
     }
   });
 
-  usePaneFooter("relationship-graph", () => ({
-    info: [
-      { id: "summary", parts: [{ text: footerSummary, tone: "muted" as const }] },
-      ...(loading ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }] : []),
-      ...(error ? [{ id: "error", parts: [{ text: error, tone: "warning" as const }] }] : []),
+  usePaneNoticeFooter({
+    registrationId: "relationship-warnings", focused,
+    notices: [
+      ...(error ? [`${error}${data && updatedAt ? ` Retained history retrieved ${new Date(updatedAt).toISOString()}.` : ""}`] : []),
+      ...(analysis?.unavailableReason ? [analysis.unavailableReason] : []),
+      ...(analysis?.correlationUnavailableReason ? [analysis.correlationUnavailableReason] : []),
     ],
+  });
+
+  usePaneFooter("relationship-graph", () => ({
+    info: loading
+        ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }]
+        : [{ id: "summary", parts: [{ text: footerSummary, tone: "muted" as const }] }],
     hints: [
-      { id: "range", key: "t", label: "ime range", onPress: cycleRange },
-      { id: "window", key: "p", label: "eriod", onPress: cycleWindow },
-      { id: "correlation", key: "c", label: "orr", onPress: toggleCorrelation },
-      { id: "regression", key: "f", label: "it line", onPress: toggleRegression },
+      { id: "range", key: "t", label: width < 80 ? range : `ime ${range}`, onPress: cycleRange },
+      { id: "window", key: "p", label: width < 80 ? `${correlationWindow}obs` : `eriod ${correlationWindow} obs`, onPress: cycleWindow },
+      { id: "correlation", key: "c", label: width < 60 ? `orr${showCorrelation ? "+" : "−"}` : `orr ${showCorrelation ? "on" : "off"}`, onPress: toggleCorrelation },
+      { id: "regression", key: "f", label: width < 60 ? `it${showRegression ? "+" : "−"}` : `it ${showRegression ? "on" : "off"}`, onPress: toggleRegression },
+      { id: "refresh", key: "r", label: "efresh", onPress: () => { void reload(); } },
     ],
   }), [
     cycleRange,
     cycleWindow,
+    analysis,
+    correlationWindow,
     error,
     footerSummary,
     loading,
+    range,
+    showCorrelation,
+    showRegression,
+    width,
     toggleCorrelation,
     toggleRegression,
+    reload,
   ]);
 
   if (!pair) {
     return (
-      <Box padding={1}>
-        <Text fg={colors.textDim}>No relationship tickers configured.</Text>
-      </Box>
+      <PaneStatusBody empty emptyTitle="No relationship tickers configured." />
     );
   }
 
   if (!analysis || analysis.aligned.length < 2) {
     return (
-      <Box padding={1} flexDirection="column" gap={1}>
-        <Text fg={error ? colors.warning : colors.textDim}>
-          {loading ? "Loading relationship history..." : error ?? "No overlapping price history."}
-        </Text>
-      </Box>
+      <PaneStatusBody loading={loading} error={loading ? null : analysis?.unavailableReason ?? error} subject="relationship history" empty emptyTitle="No overlapping price history." />
     );
   }
 
@@ -266,12 +281,6 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
       overflow="hidden"
       paddingX={1}
     >
-      <Box height={1} flexDirection="row" gap={2}>
-        <RelationshipToggle checked={showCorrelation} label="Correlation" onPress={toggleCorrelation} />
-        <RelationshipToggle checked={showRegression} label="Fit line" onPress={toggleRegression} />
-        <Button label={`Range ${range}`} variant="ghost" onPress={cycleRange} />
-        <Button label={`Window ${correlationWindow}d`} variant="ghost" onPress={cycleWindow} />
-      </Box>
       <Box height={1} flexDirection="row" gap={2}>
         {priceSeries.map((series) => (
           <Box key={series.id} flexDirection="row" gap={1}>
@@ -314,7 +323,7 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
           cursorDate={cursorDate}
           showTimeAxis
           timeAxisColor={colors.textDim}
-          yAxisLabel={`Rolling corr (${correlationWindow}d)`}
+          yAxisLabel={`Rolling corr (${correlationWindow} obs)`}
           yAxisColor={colors.textDim}
           formatYAxisValue={(value) => formatNumber(value, 2)}
           onCursorDateChange={selectCursorDate}

package/src/plugins/builtin/credit-conditions/client.test.ts

@@ -45,6 +45,48 @@ describe("loadCreditConditions", () => {
     })).rejects.toThrow("offline");
   });
 
+  test("rejects another index before storing it under the requested FRED series", async () => {
+    const persistence = new MemoryPluginPersistence();
+    attachFredSeriesPersistence(persistence);
+    const aaa = CREDIT_SERIES[1].seriesId;
+    const result = await loadCreditConditions(false, async (seriesId) =>
+      payload(seriesId === aaa ? CREDIT_SERIES[5].seriesId : seriesId));
+    expect(result.rows.some((row) => row.seriesId === aaa)).toBe(false);
+    expect(result.errors).toEqual([`${aaa}: unexpected FRED metadata`]);
+    expect(persistence.getResource("fred-series", `${aaa}:limit=45:sort=desc`,
+      { sourceKey: "gloomberb-cloud", schemaVersion: 2 })).toBeNull();
+  });
+
+  test("invalid metadata refresh retains the dated prior row and cache until valid recovery", async () => {
+    const persistence = new MemoryPluginPersistence();
+    attachFredSeriesPersistence(persistence);
+    const aaa = CREDIT_SERIES[1].seriesId;
+    const readCached = () => persistence.getResource<ReturnType<typeof payload>>(
+      "fred-series", `${aaa}:limit=45:sort=desc`, { sourceKey: "gloomberb-cloud", schemaVersion: 2 });
+    await loadCreditConditions(false, async (seriesId) => payload(seriesId));
+    const before = readCached();
+    for (const change of ["units", "identity"] as const) {
+      const failed = await loadCreditConditions(true, async (seriesId) => {
+        const data = payload(seriesId);
+        if (seriesId === aaa) {
+          if (change === "units") data.info.units = "Index";
+          else data.info.id = CREDIT_SERIES[5].seriesId;
+        }
+        return data;
+      });
+      expect(failed.rows.find((row) => row.seriesId === aaa))
+        .toMatchObject({ oasBp: 82, date: "2026-07-03", stale: true });
+      expect(failed.errors.join(" ")).toContain("unexpected FRED metadata");
+      expect(readCached()).toEqual(before);
+    }
+    const recovered = await loadCreditConditions(true, async (seriesId) => ({
+      ...payload(seriesId), observations: [{ date: "2026-07-06", value: 0 }],
+    }));
+    expect(recovered.rows.find((row) => row.seriesId === aaa))
+      .toMatchObject({ oasBp: 0, date: "2026-07-06", stale: false });
+    expect(recovered.errors).toEqual([]);
+  });
+
   test("reuses bounded persisted history across midnight", async () => {
     const persistence = new MemoryPluginPersistence();
     attachFredSeriesPersistence(persistence);
@@ -60,7 +102,7 @@ describe("loadCreditConditions", () => {
       expect(persistence.getResource<{ observations: unknown[] }>(
         "fred-series",
         `${CREDIT_SERIES[0].seriesId}:limit=45:sort=desc`,
-        { sourceKey: "gloomberb-cloud", schemaVersion: 1 },
+        { sourceKey: "gloomberb-cloud", schemaVersion: 2 },
       )?.value.observations).toHaveLength(45);
 
       resetFredSeriesPersistence();

package/src/plugins/builtin/credit-conditions/client.ts

@@ -32,6 +32,11 @@ function trimHistory(data: CloudFredSeriesPayload): CloudFredSeriesPayload {
   return { ...data, observations: data.observations.slice(0, HISTORY_LIMIT) };
 }
 
+function seriesError(seriesId: CreditSeriesId, error: unknown): string {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.startsWith(`${seriesId}:`) ? message : `${seriesId}: ${message}`;
+}
+
 export function getCachedCreditConditions(): CreditConditionsLoadResult | null {
   const rows: CreditConditionRow[] = [];
   const errors: string[] = [];
@@ -59,10 +64,16 @@ async function loadSeries(
   const request = requestFor(definition.seriesId);
   const result = await loadCachedFredSeries(
     request,
-    async () => trimHistory(await loader(definition.seriesId, {
-      limit: HISTORY_LIMIT,
-      sortOrder: "desc",
-    })),
+    async () => {
+      const data = trimHistory(await loader(definition.seriesId, {
+        limit: HISTORY_LIMIT,
+        sortOrder: "desc",
+      }));
+      // Reject incompatible source responses before they replace usable cache.
+      // The shared cache can then retain the dated prior value as stale fallback.
+      normalizeCreditSeries(definition, data);
+      return data;
+    },
     { force },
   );
   return {
@@ -83,11 +94,11 @@ export async function loadCreditConditions(
   settled.forEach((result, index) => {
     if (result.status === "rejected") {
       const seriesId = CREDIT_SERIES[index]!.seriesId;
-      errors.push(`${seriesId}: ${result.reason instanceof Error ? result.reason.message : String(result.reason)}`);
+      errors.push(seriesError(seriesId, result.reason));
       return;
     }
     rows.push(result.value.row);
-    if (result.value.refreshError) errors.push(`${result.value.row.seriesId}: ${result.value.refreshError}`);
+    if (result.value.refreshError) errors.push(seriesError(result.value.row.seriesId, result.value.refreshError));
   });
   if (rows.length === 0) throw new Error(summarizeSeriesErrors(errors));
   return { rows, stale: rows.some((row) => row.stale), errors };

package/src/plugins/builtin/credit-conditions/index.test.tsx

@@ -1,12 +1,13 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
+import { afterEach, beforeEach, expect, spyOn, test } from "bun:test";
 import { act } from "react";
-import { PaneFooterProvider } from "../../../components/layout/pane/footer";
+import { apiClient } from "../../../api-client";
+import { PaneFooterBar, PaneFooterProvider } from "../../../components/layout/pane/footer";
 import {
   attachFredSeriesPersistence,
   resetFredSeriesPersistence,
   type FredSeriesCacheEntry,
 } from "../../../data/fred-series";
-import { testRender } from "../../../renderers/opentui/test-utils";
+import { createTestControls, testRender } from "../../../renderers/opentui/test-utils";
 import { MemoryPluginPersistence } from "../../../test-support/plugin-persistence";
 import {
   AppContext,
@@ -14,10 +15,13 @@ import {
   PaneInstanceProvider,
 } from "../../../state/app/context";
 import { createDefaultConfig } from "../../../types/config";
+import { Box } from "../../../ui";
 import { CREDIT_SERIES } from "./model";
 import { CreditConditionsPane } from "./index";
 
 let setup: Awaited<ReturnType<typeof testRender>> | undefined;
+let persistence: MemoryPluginPersistence;
+let requestSpy: ReturnType<typeof spyOn> | undefined;
 
 function entry(seriesId: string, index: number): FredSeriesCacheEntry {
   return {
@@ -58,13 +62,13 @@ async function settle() {
 
 beforeEach(() => {
   resetFredSeriesPersistence();
-  const persistence = new MemoryPluginPersistence();
+  persistence = new MemoryPluginPersistence();
   for (const [index, { seriesId }] of CREDIT_SERIES.entries()) {
     persistence.seedResource(
       "fred-series",
       `${seriesId}:limit=45:sort=desc`,
       entry(seriesId, index).data,
-      { sourceKey: "gloomberb-cloud", schemaVersion: 1 },
+      { sourceKey: "gloomberb-cloud", schemaVersion: 2 },
     );
   }
   attachFredSeriesPersistence(persistence);
@@ -76,42 +80,59 @@ afterEach(async () => {
     setup = undefined;
   }
   resetFredSeriesPersistence();
+  requestSpy?.mockRestore();
+  requestSpy = undefined;
 });
 
-describe("CreditConditionsPane", () => {
-  test("selects credit rows with keyboard and mouse", async () => {
-    const state = createInitialState(createDefaultConfig("/tmp/gloomberb-credit-test"));
-    setup = await testRender(
-      <AppContext value={{ state, dispatch: () => {} }}>
-        <PaneInstanceProvider paneId="credit:test">
-          <PaneFooterProvider>
-            {() => <CreditConditionsPane paneId="credit:test" paneType="credit-conditions" focused width={72} height={18} />}
-          </PaneFooterProvider>
-        </PaneInstanceProvider>
-      </AppContext>,
-      { width: 72, height: 18 },
-    );
-    await settle();
+test.each([80, 120])("mixed cached observation dates stay attached to credit values at %i columns", async (width) => {
+  const old = entry("BAMLC0A4CBBB", 4).data;
+  old.observations = old.observations.slice(0, 1);
+  persistence.seedResource("fred-series", "BAMLC0A4CBBB:limit=45:sort=desc", old,
+    { sourceKey: "gloomberb-cloud", schemaVersion: 2 });
+  requestSpy = spyOn(apiClient, "getCloudFredSeries").mockImplementation(async (seriesId) => {
+    const index = CREDIT_SERIES.findIndex((definition) => definition.seriesId === seriesId);
+    if (index < 0) throw new Error("Unknown fixture series");
+    return entry(seriesId, index).data;
+  });
+  const state = createInitialState(createDefaultConfig("/tmp/gloomberb-credit-test"));
+  setup = await testRender(
+    <AppContext value={{ state, dispatch: () => {} }}>
+      <PaneInstanceProvider paneId="credit:test">
+        <PaneFooterProvider>
+          {(footer) => <Box width={width} height={18} flexDirection="column">
+            <Box width={width} height={17}>
+              <CreditConditionsPane paneId="credit:test" paneType="credit-conditions" focused width={width} height={17} />
+            </Box>
+            <PaneFooterBar footer={footer} focused width={width} />
+          </Box>}
+        </PaneFooterProvider>
+      </PaneInstanceProvider>
+    </AppContext>,
+    { width, height: 18 },
+  );
+  await settle();
 
-    expect(setup.captureCharFrame()).toContain(`${CREDIT_SERIES[0].seriesId} Option-Adjusted Spread`);
+  const mixed = setup.captureCharFrame();
+  expect(mixed).toContain("mixed dates");
+  expect(mixed).not.toContain("as of 2026-08-18");
+  expect(mixed).toContain("AS OF");
+  expect(mixed.split("\n").find((line) => line.includes("BBB"))).toContain("2026-08-17");
+  expect(mixed.split("\n").find((line) => line.includes("AAA"))).toContain("2026-08-18");
+  expect(requestSpy).not.toHaveBeenCalled();
 
-    await act(async () => {
-      setup!.mockInput.pressArrow("up");
-      setup!.mockInput.pressEnter();
-      await setup!.renderOnce();
-    });
-    await settle();
-    const keyboardTitle = `${CREDIT_SERIES[5].seriesId} Option-Adjusted Spread`;
-    expect(setup.captureCharFrame()).toContain(keyboardTitle);
+  const controls = createTestControls(() => setup!);
+  await controls.clickFrameText("AS OF");
+  await settle();
+  await controls.clickFrameText("AS OF");
+  await settle();
+  const sorted = setup.captureCharFrame();
+  expect(sorted.indexOf("BBB")).toBeLessThan(sorted.indexOf("AAA"));
 
-    let mouseSelected = false;
-    for (let row = 3; row < 9 && !mouseSelected; row += 1) {
-      await act(async () => {
-        await setup!.mockMouse.click(2, row);
-        await setup!.renderOnce();
-      });
-      mouseSelected = !setup.captureCharFrame().includes(keyboardTitle);
-    }
-    expect(mouseSelected).toBe(true);
-  });
+  await act(async () => { setup!.mockInput.pressKey("r"); });
+  await settle();
+  const common = setup.captureCharFrame();
+  expect(requestSpy).toHaveBeenCalledTimes(CREDIT_SERIES.length);
+  expect(common).toContain("as of 2026-08-18");
+  expect(common).not.toContain("mixed dates");
+  expect(common).not.toContain("AS OF");
 });

package/src/plugins/builtin/credit-conditions/index.tsx

@@ -1,20 +1,18 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { Box, Text, TextAttributes } from "../../../ui";
-import { useShortcut } from "../../../react/input";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import {
-  Button,
   DataTableView,
-  EmptyState,
-  Spinner,
-  usePaneFooter,
+  EmptyState, PaneStatusBody, usePaneFooter,
   type DataTableCell,
   type DataTableColumn,
-  type PaneFooterSegment,
+  type PaneFooterSegment
 } from "../../../components";
-import { useAutoRefresh } from "../shared/auto-refresh";
-import type { PaneProps } from "../../../types/plugin";
+import { useAsyncResource } from "../../../react/async-resource";
+import { useShortcut } from "../../../react/input";
 import { colors } from "../../../theme/colors";
+import type { PaneProps } from "../../../types/plugin";
+import { Box, TextAttributes } from "../../../ui";
 import type { PluginModule } from "../plugin-module";
+import { useAutoRefresh } from "../shared/auto-refresh";
 import { getCachedCreditConditions, loadCreditConditions } from "./client";
 import { creditConditionsHeadless } from "./headless";
 import {
@@ -25,7 +23,9 @@ import {
 
 export { creditConditionsHeadless } from "./headless";
 
-type SortId = "label" | "oas" | "change";
+const EMPTY_ROWS: CreditConditionRow[] = [];
+
+type SortId = "label" | "oas" | "change" | "date";
 interface Column extends DataTableColumn { id: SortId }
 
 const COLUMNS: readonly Column[] = [
@@ -44,6 +44,7 @@ function sortRows(rows: CreditConditionRow[], id: SortId, descending: boolean):
   return [...rows].sort((left, right) => {
     let comparison = 0;
     if (id === "label") comparison = left.label.localeCompare(right.label);
+    else if (id === "date") comparison = left.date.localeCompare(right.date);
     else if (id === "oas") comparison = left.oasBp - right.oasBp;
     else comparison = (left.dailyChangeBp ?? -Infinity) - (right.dailyChangeBp ?? -Infinity);
     return descending ? -comparison : comparison;
@@ -59,6 +60,7 @@ function renderCell(
   const selected = state.selected ? colors.selectedText : undefined;
   if (column.id === "label") return { text: row.label, color: selected ?? colors.text, attributes: TextAttributes.BOLD };
   if (column.id === "oas") return { text: formatBp(row.oasBp), color: selected ?? colors.textBright };
+  if (column.id === "date") return { text: row.date, color: selected ?? colors.textDim };
   return {
     text: formatBp(row.dailyChangeBp, true),
     color: selected ?? (row.dailyChangeBp == null
@@ -72,48 +74,30 @@ function renderCell(
 }
 
 export function CreditConditionsPane({ paneId, focused, width, height }: PaneProps) {
-  const [initial] = useState(getCachedCreditConditions);
-  const [rows, setRows] = useState(initial?.rows ?? []);
-  const [selectedId, setSelectedId] = useState<CreditSeriesId | null>(initial?.rows[0]?.seriesId ?? null);
+  const resource = useAsyncResource(loadCreditConditions, { initialData: getCachedCreditConditions });
+  const { loading, load: refresh, reload } = resource;
+  const stale = resource.data?.stale ?? false;
+  const error = resource.error ?? resource.data?.errors[0] ?? null;
+  const lastUpdated = stale ? null : resource.updatedAt;
+  const rows = resource.data?.rows ?? EMPTY_ROWS;
+  const mixedDates = new Set(rows.map((row) => row.date)).size > 1;
+  const [selectedId, setSelectedId] = useState<CreditSeriesId | null>(rows[0]?.seriesId ?? null);
   const [sort, setSort] = useState<{ id: SortId; descending: boolean }>({ id: "label", descending: false });
-  const [loading, setLoading] = useState(!initial);
-  const [stale, setStale] = useState(initial?.stale ?? false);
-  const [error, setError] = useState<string | null>(initial?.errors[0] ?? null);
-  const [lastUpdated, setLastUpdated] = useState<number | null>(null);
-  const generation = useRef(0);
-
-  const load = useCallback(async (force = false) => {
-    const current = ++generation.current;
-    setLoading(true);
-    setError(null);
-    try {
-      const result = await loadCreditConditions(force);
-      if (generation.current !== current) return;
-      setRows(result.rows);
-      setSelectedId((id) => id && result.rows.some((row) => row.seriesId === id) ? id : result.rows[0]?.seriesId ?? null);
-      setStale(result.stale);
-      if (!result.stale) setLastUpdated(Date.now());
-      setError(result.errors[0] ?? null);
-    } catch (loadError) {
-      if (generation.current !== current) return;
-      setError(loadError instanceof Error ? loadError.message : String(loadError));
-    } finally {
-      if (generation.current === current) setLoading(false);
-    }
-  }, []);
-  useEffect(() => { void load(false); }, [load]);
-  const reload = useCallback(() => { void load(true); }, [load]);
-  const refresh = useCallback(() => { void load(false); }, [load]);
+  useEffect(() => {
+    setSelectedId((id) => id && rows.some((row) => row.seriesId === id) ? id : rows[0]?.seriesId ?? null);
+  }, [rows]);
   // The shared FRED cache decides whether a tick actually hits the network, so
   // the pane can follow the global cadence without refetching daily data.
   useAutoRefresh(lastUpdated, refresh);
 
   const sorted = useMemo(() => sortRows(rows, sort.id, sort.descending), [rows, sort]);
-  const selectedRow = rows.find((row) => row.seriesId === selectedId) ?? rows[0] ?? null;
   const columns = useMemo<Column[]>(() => {
-    const labelWidth = Math.max(12, width - 23);
-    return COLUMNS.map((column) => column.id === "label" ? { ...column, width: labelWidth } : { ...column });
-  }, [width]);
+    const labelWidth = Math.max(12, width - 23 - (mixedDates ? 11 : 0));
+    return [
+      ...COLUMNS.map((column) => column.id === "label" ? { ...column, width: labelWidth } : { ...column }),
+      ...(mixedDates ? [{ id: "date" as const, label: "AS OF", width: 10, align: "right" as const }] : []),
+    ];
+  }, [mixedDates, width]);
   const renderRowCell = useCallback((
     row: CreditConditionRow,
     column: Column,
@@ -130,45 +114,36 @@ export function CreditConditionsPane({ paneId, focused, width, height }: PanePro
     event.stopPropagation?.();
   });
   const partial = rows.length > 0 && rows.length < CREDIT_SERIES.length;
-  const asOf = rows.reduce<string | null>((latest, row) => !latest || row.date > latest ? row.date : latest, null);
+  const asOf = mixedDates ? null : rows[0]?.date;
   const footerInfo = useMemo<PaneFooterSegment[]>(() => [
     ...(asOf ? [{ id: "as-of", parts: [{ text: `as of ${asOf}`, tone: "muted" as const }] }] : []),
+    ...(mixedDates ? [{ id: "mixed-dates", parts: [{ text: "mixed dates", tone: "warning" as const }] }] : []),
     ...(rows.length > 0 ? [{ id: "delayed", parts: [{ text: "delayed", tone: "muted" as const }] }] : []),
     ...(partial ? [{ id: "partial", parts: [{ text: `PARTIAL ${rows.length}/${CREDIT_SERIES.length}`, tone: "warning" as const, bold: true }] }] : []),
     ...(stale ? [{ id: "stale", parts: [{ text: "STALE", tone: "warning" as const }] }] : []),
     ...(loading ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }] : []),
     ...(error ? [{ id: "error", parts: [{ text: error, tone: "warning" as const }] }] : []),
-  ], [asOf, error, loading, partial, rows.length, stale]);
+  ], [asOf, mixedDates, error, loading, partial, rows.length, stale]);
   usePaneFooter(paneId, () => ({ info: footerInfo }), [footerInfo, paneId]);
 
   if (rows.length === 0 && loading) {
     return (
-      <Box width={width} height={height} justifyContent="center" alignItems="center">
-        <Spinner label="Loading credit spreads..." />
-      </Box>
+      <PaneStatusBody loading align="center" width={width} height={height} loadingLabel="Loading credit spreads..." />
     );
   }
   if (rows.length === 0) {
     return (
       <Box width={width} height={height} padding={1} flexDirection="column" gap={1}>
-        <EmptyState title="Credit spreads unavailable." message={error ?? undefined} />
+        <EmptyState status={error ? "error" : "empty"} title="Credit spreads unavailable." message={error ?? undefined} />
       </Box>
     );
   }
 
-  const metadata = (
-    <Box height={2} flexDirection="column" paddingX={1}>
-      <Text fg={colors.textMuted}>FRED · option-adjusted spread · daily close</Text>
-      <Text fg={colors.textDim}>{selectedRow?.title ?? ""}</Text>
-    </Box>
-  );
-
   return (
     <DataTableView<CreditConditionRow, Column>
       focused={focused}
       rootWidth={width}
       rootHeight={height}
-      rootBefore={metadata}
       selection={{
         kind: "id",
         selectedId,

package/src/plugins/builtin/credit-conditions/model.test.ts

@@ -39,5 +39,6 @@ describe("normalizeCreditSeries", () => {
   test("rejects metadata that would make spread normalization misleading", () => {
     expect(() => normalizeCreditSeries(CREDIT_SERIES[0], payload({ units: "Index" }))).toThrow("unexpected FRED metadata");
     expect(() => normalizeCreditSeries(CREDIT_SERIES[0], payload({ title: "Corporate Effective Yield" }))).toThrow("unexpected FRED metadata");
+    expect(() => normalizeCreditSeries(CREDIT_SERIES[0], payload({ id: "BAMLH0A0HYM2" }))).toThrow("unexpected FRED metadata");
   });
 });

package/src/plugins/builtin/credit-conditions/model.ts

@@ -34,6 +34,7 @@ export function normalizeCreditSeries(
 ): CreditConditionRow {
   const info = payload.info;
   if (!info
+    || info.id?.trim().toUpperCase() !== definition.seriesId
     || info.units.toLowerCase() !== "percent"
     || !info.frequency.toLowerCase().startsWith("daily")
     || !info.title.toLowerCase().includes("option-adjusted spread")) {