gloomberb 0.18.4 → 0.19.0

package/src/plugins/builtin/portfolio-list/pane/futures-front.ts

@@ -0,0 +1,40 @@
+import { useEffect, useMemo } from "react";
+import { getSharedMarketDataCoordinator } from "../../../../market-data/coordinator";
+import { formatMarketPrice, quoteFormatOptions, withCurrencyMinorDigits } from "../../../../market-data/market/format";
+import { buildQuoteKey, instrumentFromQuoteTarget, resolveEntryData } from "../../../../market-data/selectors";
+import type { PortfolioFuturesTerms } from "../../../../portfolio/futures-positions";
+import { useLiveQuoteEntries } from "../../../../state/hooks/quote-streaming";
+import type { QuoteSubscriptionTarget } from "../../../../types/data-provider";
+import { logFailure } from "../../../../utils/log-failure";
+
+/** Front references share one snapshot and stream per contract, independent of each row's own price. */
+export function useFuturesFrontNotes(
+  terms: ReadonlyMap<string, PortfolioFuturesTerms>,
+  { enabled, liveStreaming }: { enabled: boolean; liveStreaming: boolean },
+): ReadonlyMap<string, string> {
+  const symbolsKey = useMemo(() => enabled
+    ? [...new Set([...terms.values()].flatMap((value) => value.front?.contractSymbol ?? []))].sort().join("\u001f") : "", [enabled, terms]);
+  const targets = useMemo<QuoteSubscriptionTarget[]>(() => symbolsKey ? symbolsKey.split("\u001f").map((symbol) => ({
+    symbol, exchange: "", route: "provider", surface: "watchlist", visible: true,
+  })) : [], [symbolsKey]);
+  const instruments = useMemo(() => targets.map(instrumentFromQuoteTarget), [targets]);
+  const coordinator = getSharedMarketDataCoordinator();
+  const { entries } = useLiveQuoteEntries(targets, { liveStreaming });
+  useEffect(() => {
+    // Polling primes its own batch immediately; a stream needs one snapshot while connecting.
+    if (!liveStreaming || !coordinator || !instruments.length) return;
+    void coordinator.loadQuotesBatch(instruments).catch(logFailure("portfolio-futures", "Read front contract quotes failed"));
+  }, [coordinator, instruments, liveStreaming]);
+  return useMemo(() => {
+    const notes = new Map<string, string>();
+    if (!enabled) return notes;
+    for (const [symbol, value] of terms) {
+      if (!value.front) continue;
+      const quote = resolveEntryData(entries.get(buildQuoteKey({ symbol: value.front.contractSymbol, exchange: "" })));
+      if (!quote || !Number.isFinite(quote.price)) continue;
+      const options = withCurrencyMinorDigits(quoteFormatOptions(quote, "FUTURE"), quote.currency);
+      notes.set(symbol, `front ${value.front.contract} ${formatMarketPrice(quote.price, options)}`);
+    }
+    return notes;
+  }, [enabled, entries, terms]);
+}

package/src/plugins/builtin/portfolio-list/pane/index.tsx

@@ -104,6 +104,7 @@ import { hasUnknownOptionMultiplier } from "../../../../portfolio/position-metri
 import { withFuturesContractSizes } from "../../../../portfolio/futures-positions";
 import { withPurchaseDateCostFx } from "../../../../portfolio/cost-fx";
 import { usePortfolioFuturesTerms } from "./futures-terms";
+import { useFuturesFrontNotes } from "./futures-front";
 import { usePurchaseDateCostFx } from "./purchase-date-fx";
 import {
   allocationWeightBase,
@@ -185,7 +186,8 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
     [config.baseCurrency, currentPortfolio],
   );
   // A future counts contracts of the size its terms give, and at the close is valued at its settlement.
-  const futuresTerms = usePortfolioFuturesTerms(collectionTickers, { enabled: isPortfolioTab, settlement: valuationBasis === "regular-close" });
+  const futuresTerms = usePortfolioFuturesTerms(collectionTickers, { enabled: true, settlement: isPortfolioTab && valuationBasis === "regular-close" });
+  const futuresFrontNotes = useFuturesFrontNotes(futuresTerms.terms, { enabled: appActive && viewMode === "table", liveStreaming });
   // A dated lot in another currency costs what its purchase date's FX close says in that currency, as portfolio show values it.
   const purchaseDateFx = usePurchaseDateCostFx(collectionTickers, { enabled: isPortfolioTab, portfolioId: activeCollectionId, into: totalsCurrency });
   const tickers = useMemo(
@@ -796,6 +798,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
           onCursorChange={handleCursorChange}
           financialsMap={financialsMap}
           columnContext={columnContext}
+          futuresFrontNotes={futuresFrontNotes}
           flashSymbols={flashSymbols}
           sinceLastSeen={sinceLastSeen}
           onRootKeyDown={handleTableKeyDown}

package/src/plugins/builtin/portfolio-list/pane/streaming.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../../utils/log-failure";
 import { useEffect, useMemo, useRef } from "react";
 import { getSharedMarketDataCoordinator } from "../../../../market-data/coordinator";
 import { instrumentFromTicker, quoteSubscriptionTargetFromTicker } from "../../../../market-data/request-types";
@@ -251,8 +252,9 @@ export function usePortfolioPaneStreaming({
               ? sharedCoordinator.loadSnapshotsBatch(normalSnapshotEntries.map((entry) => entry.instrument))
               : Promise.resolve(),
           ]);
-        } catch {
+        } catch (error) {
           // Best-effort warmup for visible rows only.
+          logFailure("portfolio-list.pane.streaming", "Warm visible portfolio rows failed")(error);
         } finally {
           for (const entry of [...quoteEntries, ...forcedSnapshotEntries, ...normalSnapshotEntries]) {
             warmupInFlightRef.current.delete(entry.key);
@@ -304,8 +306,9 @@ export function usePortfolioPaneStreaming({
 
       try {
         await sharedCoordinator.loadQuotesBatch(quoteEntries.map((entry) => entry.instrument), { forceRefresh: true });
-      } catch {
+      } catch (error) {
         // Best-effort watchdog for visible rows only.
+        logFailure("portfolio-list.pane.streaming", "Refresh visible portfolio quotes failed")(error);
       } finally {
         for (const entry of quoteEntries) {
           warmupInFlightRef.current.delete(entry.key);

package/src/plugins/builtin/portfolio-list/pane/supplemental.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../../utils/log-failure";
 import { useEffect, useMemo, useRef, useState, type Dispatch, type SetStateAction } from "react";
 import type { ColumnConfig } from "../../../../types/config";
 import type { AnalystResearchData, CorporateActionsData, TickerFinancials } from "../../../../types/financials";
@@ -171,7 +172,7 @@ function useAnalystSupplemental(
       }
     })).then((entries) => {
       if (mountedRef.current) setState((current) => setAnalystValues(current, entries));
-    }).catch(() => {});
+    }).catch(logFailure("portfolio-list.pane.supplemental", "Apply analyst research failed"));
   }, [enabled, mountedRef, provider, setState, state.analystResearch, targetsKey]);
 }
 
@@ -211,7 +212,7 @@ function useCorporateSupplemental(
       }
     })).then((entries) => {
       if (mountedRef.current) setState((current) => setCorporateValues(current, entries));
-    }).catch(() => {});
+    }).catch(logFailure("portfolio-list.pane.supplemental", "Apply corporate actions failed"));
   }, [enabled, mountedRef, provider, setState, state.corporateActions, targetsKey]);
 }
 

package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../../utils/log-failure";
 import { getSharedRegistry } from "../../../registry";
 import {
   AmbiguousContractError,
@@ -178,7 +179,8 @@ export async function resolveQuickAddValidation({
           exchangeFromResolved(resolved),
           quoteContextFromResolved(resolved),
         );
-      } catch {
+      } catch (error) {
+        logFailure("portfolio-list.quick-add.resolution", "Read quick-add quote failed")(error);
         quote = null;
       }
     }

package/src/plugins/builtin/portfolio-list/summary/index.tsx

@@ -1,8 +1,9 @@
 import { Box, Text } from "../../../../ui";
 import { TextAttributes } from "../../../../ui";
-import { colors, priceColor } from "../../../../theme/colors";
+import { colors, priceColor, shownPriceColor } from "../../../../theme/colors";
 import type { AppState } from "../../../../state/app/context";
-import type { PaneFooterSegment } from "../../../../components/layout/pane/footer/model";
+import { savedCopyFooterSegment, type PaneFooterSegment } from "../../../../components/layout/pane/footer/model";
+import { oldestSavedCopyAt } from "../../../../data/saved-copies";
 import type { BrokerConnectionStatus } from "../../../../types/broker";
 import type { TickerFinancials } from "../../../../types/financials";
 import type { Portfolio, TickerRecord } from "../../../../types/ticker";
@@ -266,7 +267,7 @@ export function buildPortfolioSummarySegments({
     return totals.watchlistCount > 0
       ? [createSummarySegment("avg-day", [
         { text: "Avg Day", tone: "label" },
-        { text: formatPercentRaw(totals.avgWatchlistChange), tone: "value", color: priceColor(totals.avgWatchlistChange), bold: true },
+        { text: formatPercentRaw(totals.avgWatchlistChange), tone: "value", color: shownPriceColor(totals.avgWatchlistChange, 2), bold: true },
         ...dayBasisPart(totals),
       ])]
       : [];
@@ -341,7 +342,7 @@ export function buildPortfolioSummarySegments({
   candidates.push(createSummarySegment("day", [
     { text: "Day", tone: "label" },
     { text: money(accountMetrics.dailyPnl, true), tone: "value", color: priceColor(accountMetrics.dailyPnl), bold: true },
-    { text: `(${formatPercentRaw(accountMetrics.dailyPnlPct)})`, tone: "muted", color: priceColor(accountMetrics.dailyPnlPct) },
+    { text: `(${formatPercentRaw(accountMetrics.dailyPnlPct)})`, tone: "muted", color: shownPriceColor(accountMetrics.dailyPnlPct, 2) },
     // The broker's own day is from its account's close, not the quotes': it names none.
     ...(accountMetrics.brokerDay || !Number.isFinite(accountMetrics.dailyPnl) ? [] : dayBasisPart(totals)),
   ]));
@@ -351,7 +352,7 @@ export function buildPortfolioSummarySegments({
       : !Number.isFinite(account?.unrealizedPnl)
         && totals.unrealizedPnlBasis === "mixed" ? "Mixed P&L" : "P&L", tone: "label" },
     { text: money(accountMetrics.unrealizedPnl, true), tone: "value", color: priceColor(accountMetrics.unrealizedPnl), bold: true },
-    { text: `(${formatPercentRaw(accountMetrics.unrealizedPnlPct)})`, tone: "muted", color: priceColor(accountMetrics.unrealizedPnlPct) },
+    { text: `(${formatPercentRaw(accountMetrics.unrealizedPnlPct)})`, tone: "muted", color: shownPriceColor(accountMetrics.unrealizedPnlPct, 2) },
   ]));
 
   // A book with shorts splits its gross into the two sides, after the headline numbers.
@@ -446,11 +447,13 @@ export function buildPortfolioFooterSegments({
     : [];
   // Cached account numbers stay on screen when a live refresh fails, so the failure sits beside their date.
   if (accountState) return [...source, ...accountStatus];
+  const quotes = sortedTickers.map((ticker) => financialsMap.get(ticker.metadata.ticker)?.quote);
+  // Offline, the quotes listed are copies saved when they last refreshed: the footer says when, in place of the quote time.
+  const savedAt = refreshingSize > 0 ? null : oldestSavedCopyAt(quotes);
+  if (savedAt != null) return [...accountStatus, savedCopyFooterSegment("refresh", savedAt)];
   if (isPortfolioTab ? !totals.hasPositions && !accountStatusText : totals.watchlistCount === 0) return [];
 
-  const lastRefreshTimestamp = getMostRecentQuoteUpdate(
-    sortedTickers.map((ticker) => financialsMap.get(ticker.metadata.ticker)?.quote),
-  );
+  const lastRefreshTimestamp = getMostRecentQuoteUpdate(quotes);
   const refreshText = refreshingSize > 0
     ? "Refreshing..."
     : lastRefreshTimestamp != null

package/src/plugins/builtin/portfolio-list/table.tsx

@@ -111,6 +111,7 @@ export function PortfolioTickerTable({
   onCursorChange,
   financialsMap,
   columnContext,
+  futuresFrontNotes,
   flashSymbols,
   sinceLastSeen,
   onRootKeyDown,
@@ -134,6 +135,7 @@ export function PortfolioTickerTable({
   onCursorChange?: (ticker: TickerRecord, index: number) => void;
   financialsMap: Map<string, TickerFinancials>;
   columnContext: ColumnContext;
+  futuresFrontNotes?: ReadonlyMap<string, string>;
   flashSymbols: Map<string, QuoteFlashDirection>;
   /** For a few seconds after coming back to the pane, LAST is tinted by each row's move since the user left. */
   sinceLastSeen?: SinceLastSeenRecap | null;
@@ -155,21 +157,26 @@ export function PortfolioTickerTable({
   openPerpetualRef.current = onOpenPerpetual;
   const sparklineVisible = columns.some((column) => column.id === PRICE_SPARKLINE_COLUMN_ID);
   const tableFinancialsMap = useLiveSparklineFinancials(financialsMap, sortedTickers, sparklineVisible);
+  const noteColumnId = columns.some((column) => column.id === "name") ? "name" : "ticker";
+  const hasFrontReference = useMemo(() => sortedTickers.some((ticker) => columnContext.futuresTerms?.get(ticker.metadata.ticker)?.front),
+    [columnContext.futuresTerms, sortedTickers]);
   const resolveCell = useCallback(
     (column: ColumnConfig, ticker: TickerRecord, financials: TickerFinancials | undefined) => {
       const key = `${ticker.metadata.ticker}:${column.id}`;
       const version = buildCellVersion(column, ticker, financials, columnContext);
-      const cell = cellCacheRef.current.get(key, version, () => {
+      const cached = cellCacheRef.current.get(key, version, () => {
         const cell = getColumnValue(column, ticker, financials, columnContext);
         const marketId = PERPETUAL_COLUMN_IDS.has(column.id) ? columnContext.perpetuals?.get(ticker.metadata.ticker)?.marketId : undefined;
         return marketId ? { ...cell, onPress: () => openPerpetualRef.current?.(marketId) } : cell;
       });
+      const note = column.id === noteColumnId ? futuresFrontNotes?.get(ticker.metadata.ticker) : undefined;
+      const cell = note ? { ...cached, note } : cached;
       // LAST keeps its price: a move since the user last looked only tints the cell.
       if (column.id !== "price" || !sinceLastSeen) return cell;
       const move = sinceLastSeen.moves.get(ticker.metadata.ticker);
       return move == null ? cell : { ...cell, backgroundColor: sinceLastSeenTint(move, sinceLastSeen.fading) };
     },
-    [columnContext, sinceLastSeen],
+    [columnContext, futuresFrontNotes, noteColumnId, sinceLastSeen],
   );
   const pnlColumn = columns.find((column) => column.id === "pnl" || column.id === "pnl_pct");
   // Reads the same cached P&L cells the rows show; only changed rows recompute.
@@ -202,7 +209,8 @@ export function PortfolioTickerTable({
     : pnlLabel !== "P&L" && (column.id === "pnl" || column.id === "pnl_pct") ? {
     ...column,
     label: column.id === "pnl_pct" ? pnlLabel.replace("P&L", "%") : pnlLabel,
-  } : column), [columns, grossWeights, hasNonShareQuantity, pnlLabel, sharesWidth, tickerWidth]);
+  } : column).map((column) => hasFrontReference && column.id === noteColumnId ? { ...column, flexGrow: 1 } : column),
+  [columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, pnlLabel, sharesWidth, tickerWidth]);
   // The table offers "Sort by…" while it has a sort column. A watchlist starts
   // unsorted and a third header click turns sorting off, so the unsorted state
   // needs its own entry until TickerListTableView takes `sortable`.

package/src/plugins/builtin/primary-dealers/client.ts

@@ -1,3 +1,4 @@
+import { createTtlCache } from "../../../data/ttl-cache";
 import { httpFetch } from "../../../utils/http-transport";
 import { isoDateOrNull, numericOrNull, recordOrNull, textOrNull } from "../../../utils/guards";
 import {
@@ -84,20 +85,14 @@ async function readJson(url: string): Promise<unknown> {
 }
 
 /** The series break changes about every two years; one read serves the session. */
-let seriesBreakRead: Promise<string> | null = null;
+const seriesBreaks = createTtlCache<string>({ ttlMs: Infinity });
 
 function currentSeriesBreak(force: boolean): Promise<string> {
-  if (!seriesBreakRead || force) {
-    const read = readJson(`${API}/list/seriesbreaks.json`).then((payload) => {
-      const seriesBreak = newestSeriesBreak(parseSeriesBreaks(payload));
-      if (!seriesBreak) throw new Error("No series break was listed.");
-      return seriesBreak;
-    });
-    seriesBreakRead = read;
-    // A failed read is not kept, so the next one asks again.
-    read.catch(() => { if (seriesBreakRead === read) seriesBreakRead = null; });
-  }
-  return seriesBreakRead;
+  return seriesBreaks.load("current", async () => {
+    const seriesBreak = newestSeriesBreak(parseSeriesBreaks(await readJson(`${API}/list/seriesbreaks.json`)));
+    if (!seriesBreak) throw new Error("No series break was listed.");
+    return seriesBreak;
+  }, { force });
 }
 
 /**
@@ -117,31 +112,11 @@ export async function fetchPrimaryDealers(): Promise<DealerBoard> {
   };
 }
 
-interface SeriesRead {
-  at: number;
-  read: Promise<SeriesPoint[]>;
-  points: SeriesPoint[] | null;
-}
-
-const seriesReads = new Map<string, SeriesRead>();
+const seriesReads = createTtlCache<SeriesPoint[]>({ ttlMs: HISTORY_TTL_MS });
 
 function seriesRead(seriesBreak: string, key: string, force: boolean): Promise<SeriesPoint[]> {
-  const id = `${seriesBreak}:${key}`;
-  const known = seriesReads.get(id);
-  if (known && !force && Date.now() - known.at < HISTORY_TTL_MS) return known.read;
   const url = `${API}/get/${encodeURIComponent(seriesBreak)}/timeseries/${encodeURIComponent(key)}.json`;
-  const entry: SeriesRead = {
-    at: Date.now(),
-    points: null,
-    read: readJson(url).then((payload) => {
-      entry.points = parseSeriesPoints(payload);
-      return entry.points;
-    }),
-  };
-  seriesReads.set(id, entry);
-  // A failed read is not kept, so the next one asks again.
-  entry.read.catch(() => { if (seriesReads.get(id) === entry) seriesReads.delete(id); });
-  return entry.read;
+  return seriesReads.load(`${seriesBreak}:${key}`, async () => parseSeriesPoints(await readJson(url)), { force });
 }
 
 /** A row's history, one read per series behind it, each kept for the session. */
@@ -158,9 +133,9 @@ export async function loadDealerHistory(
 function heldSeries(seriesBreak: string, row: Pick<DealerRow, "keys">): SeriesPoint[][] | null {
   const series: SeriesPoint[][] = [];
   for (const key of row.keys) {
-    const known = seriesReads.get(`${seriesBreak}:${key}`);
-    if (!known?.points || Date.now() - known.at >= HISTORY_TTL_MS) return null;
-    series.push(known.points);
+    const points = seriesReads.peek(`${seriesBreak}:${key}`);
+    if (!points) return null;
+    series.push(points);
   }
   return series;
 }
@@ -178,6 +153,6 @@ export function cachedDealerHistory(seriesBreak: string, row: Pick<DealerRow, "i
 
 /** Forgets what was read, for a test or a refresh that must see the release again. */
 export function resetPrimaryDealersCache(): void {
-  seriesBreakRead = null;
+  seriesBreaks.clear();
   seriesReads.clear();
 }

package/src/plugins/builtin/rate-path/pane.tsx

@@ -4,7 +4,7 @@ import { curveStrip, curveSurfaceMinRows } from "../../../components/chart/curve
 import { isAccessDenied } from "../../../api-client/errors";
 import type { RateContract, RateMeeting } from "../../../api-client/rates";
 import { useAsyncResource, usePluginPaneState } from "../../../public/react";
-import { blendHex, colors, priceColor } from "../../../theme/colors";
+import { blendHex, colors, shownPriceColor } from "../../../theme/colors";
 import type { PaneProps } from "../../../types/plugin";
 import { Box } from "../../../ui";
 import { nextHeaderSort, type SortDirection } from "../../../utils/sort-values";
@@ -54,7 +54,7 @@ function timestamp(value: string | null): string { return value?.replace("T", "
 function percentile(value: number | null): string { return value == null ? "--" : value.toFixed(0); }
 /** Hikes up, cuts down, by the sign the text shows, so a move that rounds to zero stays neutral. */
 function signColor(value: number | null, digits: number): string {
-  return value == null || !Number.isFinite(value) ? colors.textDim : priceColor(Number(value.toFixed(digits)));
+  return value == null || !Number.isFinite(value) ? colors.textDim : shownPriceColor(value, digits);
 }
 function bpText(value: number | null): string { return value == null ? "--" : rateChangeText(value / 100); }
 /** Days to a meeting, counted in UTC dates like the schedule. */

package/src/plugins/builtin/realized-vol/index.tsx

@@ -21,13 +21,13 @@ export const realizedVolModule: PluginModule = {
     { ...createTickerSurfacePaneTemplate({
       id: "realized-vol-graph-pane", paneId: "realized-vol", label: "Realized Volatility Graph",
       description: "Rolling realized volatility, price and a dated current ATM IV reference.",
-      keywords: ["hvg", "realized", "historical", "volatility", "gv"], shortcut: "HVG", publicShare: true,
+      keywords: ["hvg", "realized", "historical", "volatility", "vol", "gv"], shortcut: "HVG", publicShare: true,
       viewKey: "graph", settings: () => ({ initialView: "graph" }),
     }), headless: realizedVolHeadless("graph") },
     { ...createTickerSurfacePaneTemplate({
       id: "realized-vol-table-pane", paneId: "realized-vol", label: "Realized Volatility Cone",
       description: "Current realized volatility against its historical range and percentile.",
-      keywords: ["hvt", "volatility", "cone", "percentile"], shortcut: "HVT", publicShare: true,
+      keywords: ["hvt", "volatility", "vol", "cone", "percentile"], shortcut: "HVT", publicShare: true,
       viewKey: "cone", settings: () => ({ initialView: "cone" }),
     }), headless: realizedVolHeadless("cone") },
   ],

package/src/plugins/builtin/realized-vol/pane.tsx

@@ -109,7 +109,7 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
   const refreshedCurrent = refreshedIv?.owner === ivLoader && refreshedIv.at > (loadedIv.updatedAt ?? 0) ? refreshedIv.data : null;
   const iv = { ...loadedIv, data: refreshedCurrent ?? loadedIv.data };
   ivDataRef.current = iv.data;
-  useLiveSessionRefresh(refreshIv, ATM_IV_REFRESH_MS, showIv && spotAvailable && !!iv.data?.reference && !loadedIv.loading,
+  const ivRefresh = useLiveSessionRefresh(refreshIv, ATM_IV_REFRESH_MS, showIv && spotAvailable && !!iv.data?.reference && !loadedIv.loading,
     loadedIv.updatedAt);
   const model = useMemo(() => history.data ? projectRealizedVolatility(history.data.history, {
     symbol: history.data.symbol, estimator, windows, lookbackYears: Number(lookback) === 2 ? 2 : 1,
@@ -117,7 +117,7 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
   const chartInput = useMemo(() => model ? { history: model.history, rolling: model.series, windows: model.windows,
     priceUnit: priceSeriesUnit(quote?.currency ?? "", quote?.instrumentType), iv: showIv ? iv.data?.reference ?? null : null } : null,
   [model, quote?.currency, quote?.instrumentType, showIv, iv.data]);
-  const notices = [identityError, history.error, history.data?.error, iv.error, iv.data?.error,
+  const notices = [identityError, history.error, history.data?.error, iv.error, ivRefresh.error, iv.data?.error,
     ...(model?.warnings ?? []), ...(showIv ? iv.data?.warnings ?? [] : []),
     ...(showIv && symbol && !spotAvailable ? ["Current ATM IV unavailable: underlying quote is missing or stale"] : []),
   ].filter((value): value is string => !!value);
@@ -161,7 +161,7 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
     stale: history.data?.stale ?? false, source: history.data?.source ?? null,
     asOf: model?.asOf?.toISOString() ?? null,
     errors: [...new Set([history.error, history.data?.error, ...(model?.warnings ?? []),
-      ...(showIv ? [iv.error, iv.data?.error, !iv.data?.reference ? "Current ATM IV unavailable" : null] : []),
+      ...(showIv ? [iv.error, ivRefresh.error, iv.data?.error, !iv.data?.reference ? "Current ATM IV unavailable" : null] : []),
     ].filter((value): value is string => !!value))],
     currentIv: showIv && iv.data?.reference ? { value: iv.data.reference.value * 100,
       date: iv.data.reference.date.toISOString(), label: iv.data.reference.label,

package/src/plugins/builtin/relative-rotation/client.ts

@@ -7,6 +7,7 @@ import type {
 } from "../../../api-client/types";
 import { createPluginCache } from "../../../data/plugin-cache";
 import { isAccessDenied } from "../../../api-client/errors";
+import { quoteTradingExchange } from "../../../market-data/quotes/metadata";
 import { cachedCloudResource, loadCloudResource } from "../shared/cloud-resource";
 import {
   buildRotation,
@@ -75,6 +76,10 @@ export function validateRotationHistory(
     throw new Error("Invalid daily history.");
   return response.data;
 }
+/** The venue a quote is for, as `quote` names it; empty when it names none. */
+function listingVenue(quote: CloudQuotePayload | undefined): string {
+  return quote ? quoteTradingExchange(quote) : "";
+}
 export async function fetchRotation(
   benchmark: RotationInstrument,
   instruments: RotationInstrument[],
@@ -106,6 +111,16 @@ export async function fetchRotation(
     if (isAccessDenied(error)) throw error;
     quoteError = "Listing currencies unavailable.";
   }
+  // A benchmark typed without its exchange (ACWI) is the listing its quote is for (ACWI:NASDAQ), as `quote`
+  // reads it: that venue's calendar picks the weekly closes.
+  const venue = benchmark.exchange
+    ? ""
+    : listingVenue(quotes.get(rotationId(benchmark)));
+  const reference = venue ? { ...benchmark, exchange: venue } : benchmark;
+  const requested = unique.map((row) => ({
+    id: rotationId(row),
+    instrument: rotationId(row) === rotationId(benchmark) ? reference : row,
+  }));
   const start = new Date(now);
   start.setUTCFullYear(start.getUTCFullYear() - 3);
   start.setUTCDate(1);
@@ -115,10 +130,9 @@ export async function fetchRotation(
   let next = 0;
   // Bound Cloud history requests; shared server caches batch upstream demand.
   await Promise.all(
-    Array.from({ length: Math.min(4, unique.length) }, async () => {
-      while (next < unique.length) {
-        const instrument = unique[next++]!,
-          id = rotationId(instrument),
+    Array.from({ length: Math.min(4, requested.length) }, async () => {
+      while (next < requested.length) {
+        const { id, instrument } = requested[next++]!,
           currency = quotes.get(id)?.currency ?? null;
         try {
           const response = await client.getCloudHistory(

package/src/plugins/builtin/relative-rotation/headless.ts

@@ -1,6 +1,6 @@
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { fetchRotation } from "./client";
-import { rotationInstruments, sectorRotationInstruments } from "./model";
+import { DEFAULT_ROTATION_BENCHMARK, rotationInstruments, sectorRotationInstruments } from "./model";
 
 /** Same rounding as the pane: ratios to 2 decimals, percentiles whole. */
 const fixed = (value: unknown, digits: number) =>
@@ -21,7 +21,7 @@ export const rotationHeadless: HeadlessPaneDefinition<"bundle"> = {
       key: "benchmark",
       type: "string",
       description: "Benchmark listing.",
-      defaultValue: "SPY:NYSEARCA",
+      defaultValue: DEFAULT_ROTATION_BENCHMARK,
     },
     {
       key: "trail",
@@ -44,7 +44,7 @@ export const rotationHeadless: HeadlessPaneDefinition<"bundle"> = {
   },
   async load(args, ctx) {
     const references = rotationInstruments(
-      String(args.options.benchmark ?? "SPY:NYSEARCA"),
+      String(args.options.benchmark ?? DEFAULT_ROTATION_BENCHMARK),
     );
     if (references.length !== 1) throw new Error("Choose one benchmark.");
     const instruments = args.symbols.length

package/src/plugins/builtin/relative-rotation/index.tsx

@@ -3,6 +3,7 @@ import type { PluginModule } from "../plugin-module";
 import { rotationCache } from "./client";
 import { rotationHeadless } from "./headless";
 import { RelativeRotationPane } from "./pane";
+import { DEFAULT_ROTATION_BENCHMARK } from "./model";
 
 export const relativeRotationModule: PluginModule = {
   panes: [
@@ -41,7 +42,7 @@ export const relativeRotationModule: PluginModule = {
             key: "benchmark",
             label: "Benchmark",
             type: "text",
-            placeholder: "SPY:NYSEARCA",
+            placeholder: DEFAULT_ROTATION_BENCHMARK,
           },
           {
             key: "trail",

package/src/plugins/builtin/relative-rotation/model.ts

@@ -2,6 +2,7 @@ import { publishedWeekClose } from "../analytics/sharpe-cadence";
 import { historyStatistics } from "../../../components/chart/curve/model";
 import type { CloudPricePointPayload } from "../../../api-client/types";
 import { getSectorCollection } from "../sectors/sector-data";
+import { rotationQuadrant, rotationSeries, type RotationQuadrantName } from "../alerts/metric-model";
 import {
   canonicalExchange,
   normalizeSymbol,
@@ -11,6 +12,8 @@ import {
 const DAY = 86_400_000;
 const WEEK = 7 * DAY;
 export const ROTATION_LIMIT = 24;
+/** RRG's benchmark when none is chosen; RRG alerts default to it too. */
+export const DEFAULT_ROTATION_BENCHMARK = "SPY:NYSEARCA";
 export interface RotationInstrument {
   symbol: string;
   exchange: string;
@@ -46,8 +49,7 @@ export interface RotationRow {
   asOf: string | null;
   strength: number | null;
   momentum: number | null;
-  quadrant:
-    "Leading" | "Weakening" | "Lagging" | "Improving" | "Neutral" | null;
+  quadrant: RotationQuadrantName | null;
   strengthRank: RotationRank;
   momentumRank: RotationRank;
   relativeReturn13w: number | null;
@@ -149,21 +151,8 @@ function rotationRank(
     lastDate: stats.endDate,
   };
 }
-export function rotationQuadrant(
-  strength: number | null,
-  momentum: number | null,
-): RotationRow["quadrant"] {
-  if (strength == null || momentum == null) return null;
-  if (Math.abs(strength - 100) < 1e-9 || Math.abs(momentum - 100) < 1e-9)
-    return "Neutral";
-  return strength > 100
-    ? momentum > 100
-      ? "Leading"
-      : "Weakening"
-    : momentum > 100
-      ? "Improving"
-      : "Lagging";
-}
+/** The weekly strength, momentum and quadrant math is the RRG alert's, shared with Gloom Cloud's delivery. */
+export { rotationQuadrant };
 export function buildRotation(
   benchmark: RotationHistory,
   instruments: RotationHistory[],
@@ -219,10 +208,12 @@ export function buildRotation(
   const benchmarkUsable = !!benchmark.currency && !!asOf;
   const rows = instruments.map((source): RotationRow => {
     const closes = rotationCloses(source.points, through);
+    // A benchmark with no usable weeks says so once in `gaps`; its rows are not to blame for it.
     const gaps = [
       source.error,
       source.stale ? "History is stale." : null,
-      source.currency !== benchmark.currency || !source.currency
+      benchmarkUsable &&
+      (source.currency !== benchmark.currency || !source.currency)
         ? "Price currency does not match the benchmark."
         : null,
     ].filter((x): x is string => !!x);
@@ -240,34 +231,16 @@ export function buildRotation(
         ? ratio
         : null;
     });
-    const strengths = ratios.map((ratio, index) => {
-      const window = ratios.slice(Math.max(0, index - 12), index + 1);
-      if (
-        ratio == null ||
-        window.length !== 13 ||
-        window.some((value) => value == null)
-      )
-        return null;
-      const mean =
-        (window as number[]).reduce((sum, value) => sum + value, 0) / 13;
-      return (100 * ratio) / mean;
-    });
+    const series = rotationSeries(ratios);
     const history = weeks.map((week, index): RotationPoint => {
-      const strength = strengths[index] ?? null,
-        previous = index >= 4 ? (strengths[index - 4] ?? null) : null;
-      const contiguous =
-        index >= 4 &&
-        strengths.slice(index - 4, index + 1).every((value) => value != null);
+      const { strength, momentum } = series[index]!;
       const priorRatio = index >= 13 ? (ratios[index - 13] ?? null) : null,
         ratio = ratios[index] ?? null;
       return {
         date: weekly.get(week)?.date ?? week,
         week,
         strength,
-        momentum:
-          strength != null && previous != null && contiguous
-            ? (100 * strength) / previous
-            : null,
+        momentum,
         relativeReturn13w:
           ratio != null &&
           priorRatio != null &&
@@ -284,7 +257,10 @@ export function buildRotation(
       Number.isFinite(latest.strength) &&
       latest.momentum != null &&
       Number.isFinite(latest.momentum);
-    if (!latest || latest.strength == null || latest.momentum == null)
+    if (
+      benchmarkUsable &&
+      (!latest || latest.strength == null || latest.momentum == null)
+    )
       gaps.push(
         "At least 17 contiguous matched weekly closes are required; a missing week breaks the trail.",
       );

package/src/plugins/builtin/relative-rotation/pane.tsx

@@ -36,6 +36,7 @@ import {
 import { useResearchCloudSession } from "../shared/research-cloud-session";
 import { cachedRotation, loadRotation } from "./client";
 import {
+  DEFAULT_ROTATION_BENCHMARK,
   ROTATION_LIMIT,
   rotationId,
   rotationTrailWeeks,
@@ -140,13 +141,13 @@ function RotationDetail({
 export function RelativeRotationPane(props: PaneProps) {
   const [scope] = usePaneSettingValue("scope", "sectors");
   const [symbols] = usePaneSettingValue("symbols", "");
-  const [benchmarkText] = usePaneSettingValue("benchmark", "SPY:NYSEARCA");
+  const [benchmarkText] = usePaneSettingValue("benchmark", DEFAULT_ROTATION_BENCHMARK);
   const [trailText] = usePaneSettingValue("trail", "6");
   const { collectionId } = usePaneCollection();
   const tickers = useTickers();
   const context = useMemo(() => {
     try {
-      const references = rotationInstruments(benchmarkText || "SPY:NYSEARCA");
+      const references = rotationInstruments(benchmarkText || DEFAULT_ROTATION_BENCHMARK);
       if (references.length !== 1)
         throw new Error("Choose one benchmark in pane settings.");
       const instruments =