gloomberb 0.19.0 → 0.19.2

package/src/plugins/builtin/cot/model.ts

@@ -2,10 +2,14 @@ import type { CotClass, CotContractPayload, CotFamily, CotHistoryPoint, CotPosit
 import { staticSeries } from "../../../components/chart/static/series";
 import type { ResolvedSeries } from "../../../time-series/types";
 import type { PricePoint } from "../../../types/financials";
-import { formatPriceObservation } from "../../../market-data/market/format";
+import { formatMarketPriceWithCurrency, formatPriceObservation } from "../../../market-data/market/format";
+import { futuresPricePer } from "../../../market-data/futures-contract";
+import { unitCurrencyToken } from "../../../time-series/price-units";
 import { cleanFloat32Price } from "../../../cli/history-rows";
 import { cryptoPairCoin, isFuturesSymbol } from "../shared/crypto-pair";
-import { bestNameMatch, FUTURES_CONTRACTS, futuresBoardContract, futuresBoardContractForTicker, futuresContractByName, type FuturesContract } from "../../../market-data/futures-board";
+import {
+  bestNameMatch, FUTURES_CONTRACTS, futuresBoardContract, futuresBoardContractForTicker, futuresContractByCode, futuresContractByName, type FuturesContract,
+} from "../../../market-data/futures-board";
 
 export const COT_CLASSES: Record<CotFamily, Array<{ value: CotClass; label: string }>> = {
   legacy: [{ value: "noncommercial", label: "Noncommercial" }, { value: "commercial", label: "Commercial" }, { value: "nonreportable", label: "Nonreportable" }],
@@ -162,7 +166,35 @@ export function cotContractCode(value: unknown): string | null {
   if (alias) return alias;
   const market = typedMarket(value);
   if (market && "root" in market) return ROOTS[market.root]!.code;
-  return (market ? boardMarketCode(market.board) : null) ?? (market ? null : marketCode(input));
+  if (market) return boardMarketCode(market.board);
+  const proxy = proxyMarket(value);
+  const proxied = proxy ? futuresContractByCode(proxy.root) : null;
+  return (proxied ? boardMarketCode(proxied) : null) ?? marketCode(input);
+}
+/**
+ * Markets the CFTC does not report, opened as the one traders price and hedge
+ * them by: jet fuel (kerosene) as NY Harbor ULSD, heating oil (HO), which
+ * airlines' fuel hedges and analysts follow it with. Opened this way, the
+ * pane's title and the report say which market stands in.
+ */
+const PROXY_MARKETS: ReadonlyArray<{ names: readonly string[]; root: string; subject: string }> = [
+  { names: ["jet fuel", "jet fuels", "kerosene", "kerosine", "jet kerosene", "aviation fuel", "avtur"], root: "HO", subject: "jet fuel" },
+];
+function proxyMarket(value: string) {
+  const typed = value.trim().toLowerCase().replace(/[\s_-]+/g, " ");
+  return PROXY_MARKETS.find((proxy) => proxy.names.includes(typed)) ?? null;
+}
+/** What a typed name opens in place of a market the CFTC does not report ("jet fuel" opens HO), or null. */
+export function cotProxyFor(value: unknown): { subject: string; root: string } | null {
+  if (typeof value !== "string" || typedMarket(value) || rootAlias(value.trim().toUpperCase())) return null;
+  const proxy = proxyMarket(value);
+  return proxy ? { subject: proxy.subject, root: proxy.root } : null;
+}
+/** The line a report opened through a proxy says: "Jet fuel has no CFTC market: heating oil (NY Harbor ULSD, HO) is the usual proxy." */
+export function cotProxyNote(proxy: { subject: string; root: string }): string {
+  const subject = `${proxy.subject[0]!.toUpperCase()}${proxy.subject.slice(1)}`;
+  return `${subject} has no CFTC market: heating oil (NY Harbor ULSD, ${proxy.root}) is the usual proxy. Its price: gloom quote ${proxy.root}=F; `
+    + "US jet fuel stocks (EIA, weekly): gloom fn G CAP:doe:jet";
 }
 /** The markets the unknown-market hint names, by the code and the word a newcomer knows them by. */
 const SUGGESTED_MARKETS: ReadonlyArray<readonly [string, string]> = [
@@ -234,10 +266,27 @@ export function cotInteger(value: number | null, signed = false): string {
   return value == null ? "--" : `${signed && value > 0 ? "+" : ""}${value.toLocaleString("en-US", { maximumFractionDigits: 0 })}`;
 }
 
+/**
+ * The front price's unit as a quote of the future writes it after the price:
+ * `USD/gal` for heating oil ($4.6218/gal), `USD` for gold, from the
+ * contract's unit ("USD / gallon"). Null where the unit names no currency
+ * (index points, Treasury points) or is unknown: the price reads bare.
+ */
+export function cotFrontPriceUnit(code: string, contractUnit: string | null | undefined): string | null {
+  const currency = contractUnit ? unitCurrencyToken(contractUnit.split("/")[0] ?? "") : null;
+  if (!currency) return null;
+  const root = cotRoot(code) ?? undefined;
+  return `${currency}${futuresPricePer({ root, spec: { unit: contractUnit } } as Parameters<typeof futuresPricePer>[0], currency)}`;
+}
+
 /** Legend values stay exact: a compact 7.8K hides the futures price and -100K the net position. */
-export function cotLegendValue(value: number, series: Pick<ResolvedSeries, "id">): string {
+export function cotLegendValue(value: number, series: Pick<ResolvedSeries, "id"> & Partial<Pick<ResolvedSeries, "unit">>): string {
+  if (series.id !== "price") return cotInteger(value, true);
   // Drop the float32 tail of provider bars without rounding away a 1/128 Treasury tick.
-  return series.id === "price" ? formatPriceObservation(cleanFloat32Price(value)) : cotInteger(value, true);
+  const price = cleanFloat32Price(value);
+  // In its currency and per its quantity, as a quote of the future reads: $4.6218/gal.
+  const [currency, per] = [series.unit?.split("/")[0]?.trim(), series.unit?.includes("/") ? `/${series.unit.split("/")[1]}` : ""];
+  return currency ? `${formatMarketPriceWithCurrency(price, currency, { assetCategory: "FUT" })}${per}` : formatPriceObservation(price);
 }
 
 /**
@@ -263,7 +312,9 @@ export function cotNetPoints(history: readonly CotHistoryPoint[], traderClass: C
   }
   return points;
 }
-export function cotChartSeries(data: CotContractPayload, traderClass: CotClass, price: readonly PricePoint[], colors: { positive: string; warning: string }): ResolvedSeries[] {
+/** `priceUnit` is the front price's (cotFrontPriceUnit), which its legend value is written in. */
+export function cotChartSeries(data: CotContractPayload, traderClass: CotClass, price: readonly PricePoint[], colors: { positive: string; warning: string },
+  priceUnit: string | null = null): ResolvedSeries[] {
   const series: ResolvedSeries[] = [{
     ...staticSeries(cotNetPoints(data.history, traderClass), { id: "net", label: `${COT_CLASSES[data.reportFamily].find((row) => row.value === traderClass)?.label ?? traderClass} net`, color: colors.warning, calendarSpaced: true }),
     panelId: "net", unit: "contracts", unitGroup: "positions",
@@ -271,7 +322,7 @@ export function cotChartSeries(data: CotContractPayload, traderClass: CotClass,
   // Net positioning is the subject, so it leads the legend and the strip; the front price follows.
   if (price.length) series.push({
     ...staticSeries(price.map((row) => ({ date: row.date, observedAt: row.date, value: row.close })), { id: "price", label: "Front price", color: colors.positive, calendarSpaced: true }),
-    panelId: "price", unit: "", unitGroup: "price",
+    panelId: "price", unit: priceUnit ?? "", unitGroup: "price",
   });
   return series;
 }

package/src/plugins/builtin/cot/pane.tsx

@@ -12,7 +12,7 @@ import { Box } from "../../../ui";
 import { useAutoRefresh } from "../../../react/auto-refresh";
 import { compareSortValues, nextHeaderSort, type SortPreference } from "../../../utils/sort-values";
 import { useResearchCloudSession } from "../shared/research-cloud-session";
-import { cachedCotBoard, loadCotBoard, loadCotDetail } from "./client";
+import { cachedCotBoard, loadCotBoard, loadCotDetail, loadCotPriceUnit } from "./client";
 import { COT_CLASSES, COT_FAMILIES, COT_MAJOR_CODES, COT_POSITIONS, COT_SCOPES, cotChartSeries, cotClass, cotContractUnitText, cotFamily, cotInteger, cotLegendValue, cotMarketName, cotPositions, cotPositionsText, cotScope, type CotScope } from "./model";
 
 const BOARD_COLUMNS: DataTableColumn[] = [
@@ -159,10 +159,14 @@ function CotDetail({ width, height, focused, code, family, positions, traderClas
   const session = useResearchCloudSession();
   const loader = useCallback(() => loadCotDetail(code, family, undefined, positions), [code, family, positions, session.requestKey]);
   const resource = useAsyncResource(loader, { clearOnError: isAccessDenied });
+  // The front price's unit joins the legend once the contract terms answer, or
+  // the catalog's after a short wait: the chart draws without waiting for it.
+  const unitLoader = useCallback(() => loadCotPriceUnit(code), [code]);
+  const priceUnit = useAsyncResource(unitLoader).data ?? null;
   const data = resource.data;
   const payload = data?.payload;
   const current = payload?.positions.find((row) => row.id === traderClass);
-  const series = useMemo(() => data ? cotChartSeries(data.payload, traderClass, data.price, colors) : [], [data, traderClass, colors]);
+  const series = useMemo(() => data ? cotChartSeries(data.payload, traderClass, data.price, colors, priceUnit) : [], [data, traderClass, colors, priceUnit]);
   // The selected class row already carries the net and both ranks, and the
   // legend names the class it charts, so the detail opens on the chart. A rank
   // over a short history is a limitation, so it sits behind the warning.

package/src/plugins/builtin/cpi/client.ts

@@ -1,8 +1,8 @@
 import { apiClient } from "../../../api-client";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import type { CpiBoardPayload, CpiRow } from "../../../api-client/cpi";
-import { ApiRequestError } from "../../../api-client/errors";
 import { createPluginCache } from "../../../data/plugin-cache";
-import { cachedCloudResource, loadCloudResource } from "../shared/cloud-resource";
+import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 
 /** What the pane says while the server has no months to serve: before the backend ships, or before its first read. */
 export const CPI_NOT_AVAILABLE = "US consumer prices are not available yet.";
@@ -54,11 +54,12 @@ export async function fetchCpiBoard(client: Pick<typeof apiClient, "getCloudCpiB
   try {
     payload = await client.getCloudCpiBoard();
   } catch (error) {
-    if (error instanceof ApiRequestError && (error.status === 404 || error.status === 503)) throw new Error(CPI_NOT_AVAILABLE);
-    throw error;
+    throw unavailableOnServer(error, CPI_NOT_AVAILABLE, [404, 503]);
   }
   const board = validateCpiBoard(payload);
-  if (board.status === "unavailable" || !board.release.period || !board.rows.length) throw new Error(CPI_NOT_AVAILABLE);
+  // The server's source did not answer this time: a saved copy answers, as it does a 5xx.
+  if (board.status === "unavailable") throw sourceDidNotAnswer(CPI_NOT_AVAILABLE);
+  if (!board.release.period || !board.rows.length) throw new Error(CPI_NOT_AVAILABLE);
   return board;
 }
 

package/src/plugins/builtin/credit-boards/series.ts

@@ -1,6 +1,6 @@
 import type { CreditBoardPoint } from "../../../api-client/credit-boards";
 import type { SeriesDefinition, SeriesLoadResult } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadCdxBoard, loadSovrBoard } from "./client";
 
 /** The five on-the-run 5Y index contracts the CDX tab lists; IG and iTraxx quote spread, HY and EM price. */
@@ -27,14 +27,13 @@ function boardPoints(
   rows: ReadonlyArray<{ id: string; points: readonly CreditBoardPoint[] }>,
   id: string,
   label: string,
-  resource: { stale?: boolean; refreshError?: string | null },
+  resource: { stale?: boolean; refreshError?: string | null; savedAt?: number },
 ): SeriesLoadResult {
   const row = rows.find((entry) => entry.id === id);
   if (!row) throw new Error(`${label} is not on the board right now.`);
-  const warning = cachedSeriesWarning(resource);
   return {
     points: row.points.map((point) => ({ date: point.date, value: point.level })),
-    ...(warning ? { warning } : {}),
+    ...cachedSeriesNote(resource),
   };
 }
 

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

@@ -66,20 +66,28 @@ async function loadSeries(
   loader: CreditSeriesLoader,
 ) {
   const request = requestFor(definition.seriesId);
-  const result = await loadCachedFredSeries(
-    request,
-    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 },
-  );
+  let result: Awaited<ReturnType<typeof loadCachedFredSeries>>;
+  try {
+    result = await loadCachedFredSeries(
+      request,
+      async () => {
+        const data = trimHistory(await loader(definition.seriesId, {
+          limit: HISTORY_LIMIT,
+          sortOrder: "desc",
+        }));
+        // Reject incompatible source responses before they replace usable cache.
+        normalizeCreditSeries(definition, data);
+        return data;
+      },
+      { force },
+    );
+  } catch (error) {
+    // A refusal or a reply that fails validation is no saved copy's to answer: it is this row's
+    // error, beside the dated prior value already read, which stays as stale rather than vanish.
+    const kept = getCachedFredSeries(request, { allowExpired: true });
+    if (!kept) throw error;
+    return { row: normalizeCreditSeries(definition, kept.data, true), refreshError: error instanceof Error ? error.message : String(error) };
+  }
   return {
     row: normalizeCreditSeries(definition, result.data, result.stale),
     refreshError: result.refreshError,

package/src/plugins/builtin/credit-documents/headless.ts

@@ -31,10 +31,10 @@ export const creditHeadless: HeadlessPaneDefinition<"bundle"> = {
     const data = await fetchCreditDocuments(args.symbols[0]!, ctx.apiClient);
     const instrument = args.options.instrument ? await fetchCreditInstrument(data.symbol, String(args.options.instrument), ctx.apiClient) : null;
     const reason = instrument ? null : creditEmptyReason(data, args.symbols[0]!);
-    // Nothing on file says why once, instead of four empty sections.
+    // Nothing on file says why once, as the report's one reason, instead of four empty sections and a generic "not covered".
     if (reason) {
-      return { complete: false, errors: data.warnings, sections: [],
-        metadata: { symbol: data.symbol, issuer: data.issuer, asOf: data.asOf, access: data.access, lockedRows: data.lockedRows, status: data.status, reason, notices: [reason] } };
+      return { complete: false, errors: data.warnings, sections: [], empty: reason,
+        metadata: { symbol: data.symbol, issuer: data.issuer, asOf: data.asOf, access: data.access, lockedRows: data.lockedRows, status: data.status, reason } };
     }
     return { complete: data.status === "available" && data.lockedRows === 0, errors: [...data.warnings, ...(data.lockedRows ? ["Full credit documents and history require Gloom Pro"] : [])],
       sections: instrument ? instrumentSections(data, instrument) : [capitalSection(data), covenantSection(data), maturitySection(data), controlSection(data)],

package/src/plugins/builtin/crypto-board/client.ts

@@ -145,10 +145,10 @@ export async function fetchCryptoMarkets(
   try {
     return validateCryptoMarkets(await client.getCloudCryptoMarkets());
   } catch (error) {
-    if (error instanceof ApiRequestError && error.status === 503) {
-      throw new Error("Crypto prices are temporarily unavailable");
-    }
-    throw unavailableOnServer(error, "Crypto markets are not available yet.");
+    // Each keeps its status: a 503 passes with time and a saved copy answers it; a 404 does not.
+    throw error instanceof ApiRequestError && error.status === 503
+      ? unavailableOnServer(error, "Crypto prices are temporarily unavailable", [503])
+      : unavailableOnServer(error, "Crypto markets are not available yet.");
   }
 }
 
@@ -248,7 +248,7 @@ function validateStablecoinSupplyHistory(data: StablecoinSupplyHistoryPayload):
 }
 
 function supplyError(error: unknown, what: string): unknown {
-  if (error instanceof ApiRequestError && error.status === 503) return new Error(`${what} is temporarily unavailable`);
+  if (error instanceof ApiRequestError && error.status === 503) return unavailableOnServer(error, `${what} is temporarily unavailable`, [503]);
   return unavailableOnServer(error, `${what} is not available yet.`);
 }
 

package/src/plugins/builtin/crypto-board/series.ts

@@ -1,5 +1,5 @@
 import type { SeriesDefinition, SeriesPoint } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadDefiTvl, loadStablecoinSupply, loadStablecoinSupplyHistory } from "./client";
 
 const DAY_MS = 86_400_000;
@@ -29,7 +29,7 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
       const resource = await loadStablecoinSupply();
       const history = resource.payload.history;
       if (!history) throw new Error("Stablecoin supply is not available yet.");
-      return { points: dailyPoints(history.start, history.total), warning: cachedSeriesWarning(resource) };
+      return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
     },
   },
   {
@@ -45,7 +45,7 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
       const resource = await loadStablecoinSupplyHistory(stablecoinSymbol(ticker!));
       const history = resource.payload.history;
       if (!history) throw new Error(`${resource.payload.symbol} supply history is not available yet.`);
-      return { points: dailyPoints(history.start, history.values), warning: cachedSeriesWarning(resource) };
+      return { points: dailyPoints(history.start, history.values), ...cachedSeriesNote(resource) };
     },
   },
 ];
@@ -63,7 +63,7 @@ const DEFI_TVL_SERIES: SeriesDefinition = {
     const resource = await loadDefiTvl();
     const history = resource.payload.history;
     if (!history) throw new Error("DeFi TVL is not available yet.");
-    return { points: dailyPoints(history.start, history.total), warning: cachedSeriesWarning(resource) };
+    return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
   },
 };
 

package/src/plugins/builtin/debt-maturities/series.ts

@@ -1,6 +1,6 @@
 import type { DebtHistoryPoint } from "../../../api-client/debt-maturities";
 import type { SeriesDefinition } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadDebtMaturities } from "./client";
 
 type HistoryField = "totalPrincipal" | "next12MonthsShare" | "next3YearsShare";
@@ -36,10 +36,10 @@ export const DEBT_MATURITY_SERIES: readonly SeriesDefinition[] = FIELDS.map(({ i
     // An amount stays in the unit it is listed in: a filing in another currency is a gap, not a converted figure.
     const listed = (point: DebtHistoryPoint) => unit !== "USD" || point.currency === "USD";
     const other = resource.payload.history.find((point) => !listed(point))?.currency;
-    const warning = other ? `Filings reported in ${other} are left out.` : cachedSeriesWarning(resource);
     return {
       points: resource.payload.history.map((point) => ({ date: point.asOf, value: listed(point) ? point[field] : null })),
-      ...(warning ? { warning } : {}),
+      ...cachedSeriesNote(resource),
+      ...(other ? { warning: `Filings reported in ${other} are left out.` } : {}),
     };
   },
 }));

package/src/plugins/builtin/doe/client.ts

@@ -1,8 +1,8 @@
 import { apiClient } from "../../../api-client";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import type { DoeBoardPayload, DoeSeriesRow } from "../../../api-client/doe";
-import { ApiRequestError } from "../../../api-client/errors";
 import { createPluginCache } from "../../../data/plugin-cache";
-import { cachedCloudResource, loadCloudResource } from "../shared/cloud-resource";
+import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 
 /** What the pane says while the server has no EIA weeks to serve: before the backend ships, or before its first read. */
 export const DOE_NOT_AVAILABLE = "Oil and gas inventories are not available yet.";
@@ -65,11 +65,12 @@ export async function fetchDoeBoard(client: Pick<typeof apiClient, "getCloudDoeB
   try {
     payload = await client.getCloudDoeBoard();
   } catch (error) {
-    if (error instanceof ApiRequestError && (error.status === 404 || error.status === 503)) throw new Error(DOE_NOT_AVAILABLE);
-    throw error;
+    throw unavailableOnServer(error, DOE_NOT_AVAILABLE, [404, 503]);
   }
   const board = validateDoeBoard(payload);
-  if (board.status === "unavailable" || !board.series.some((row) => row.value != null)) throw new Error(DOE_NOT_AVAILABLE);
+  // The server's source did not answer this time: a saved copy answers, as it does a 5xx.
+  if (board.status === "unavailable") throw sourceDidNotAnswer(DOE_NOT_AVAILABLE);
+  if (!board.series.some((row) => row.value != null)) throw new Error(DOE_NOT_AVAILABLE);
   return board;
 }
 

package/src/plugins/builtin/doe/headless.ts

@@ -1,6 +1,6 @@
 import type { DoeSeriesRow, DoeTab } from "../../../api-client/doe";
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
-import { fetchDoeBoard } from "./client";
+import { loadDoeBoard } from "./client";
 import {
   DOE_TABS,
   DOE_UNIT_LABEL,
@@ -61,7 +61,8 @@ export function doeHeadless(defaultTab: DoeTab | "all"): HeadlessPaneDefinition<
         "Five-year ranges read earlier years on the same calendar day.", "A range holds fewer than five years where a series is younger."] },
     describe: "EIA weekly petroleum and natural gas storage",
     async load(args) {
-      const data = await fetchDoeBoard();
+      // Read afresh; a failed read answers from the board an earlier one saved, which the report says it is.
+      const data = (await loadDoeBoard(true)).payload;
       // Each tab is dated by its own EIA report (petroleum Wednesday, gas Thursday);
       // once the next one is a day overdue the tables have missed it. The basis
       // names what Vs 1Y and Vs 5Y avg are measured against.

package/src/plugins/builtin/doe/pane.tsx

@@ -13,8 +13,10 @@ import {
   usePaneTabs,
   type ChartTableChart,
   type DataTableColumn,
+  type PaneFooterSegment,
 } from "../../../components";
 import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
+import { savedCopyFooterSegment } from "../../../components/layout/pane/footer";
 import { useAsyncResource, useAutoRefresh, usePaneSettingValue, usePluginPaneState } from "../../../public/react";
 import { usePaneInstance } from "../../../state/app/context";
 import { useThemeColors } from "../../../theme/theme-context";
@@ -136,13 +138,21 @@ export function DoePane({ width, height, focused }: PaneProps) {
   const { strip, rows: tabRows } = usePaneTabs({ tabs: [...DOE_TABS], activeValue: tab, onSelect: setTab, focused, dense: true });
   useAutoRefresh(resource.updatedAt, resource.load);
   usePaneRefreshKey(() => void resource.reload(), { focused });
+  // A refresh that failed shows the board an earlier read saved, and says when that copy is from.
+  const savedAt = resource.data?.savedAt ?? null;
   usePaneNoticeFooter({ registrationId: "doe:notices", focused,
-    notices: [...(data?.gaps ?? []), ...(resource.data?.refreshError ? [resource.data.refreshError] : [])] });
+    notices: [...(data?.gaps ?? []), ...(resource.data?.refreshError && savedAt == null ? [resource.data.refreshError] : [])] });
   // What Vs 1Y and Vs 5Y are measured against on this tab: the EIA's published figures for gas storage.
   const basis = useMemo(() => data ? doeComparisonBasis(doeRows(data, tab)) : null, [data, tab]);
-  const info = useMemo(() => basis ? [{ id: "basis", parts: [{ text: basis, tone: "muted" as const }] }] : undefined, [basis]);
+  const info = useMemo(() => {
+    const segments: PaneFooterSegment[] = [
+      ...(basis ? [{ id: "basis", parts: [{ text: basis, tone: "muted" as const }] }] : []),
+      ...(savedAt != null ? [savedCopyFooterSegment("saved-copy", savedAt)] : []),
+    ];
+    return segments.length ? segments : undefined;
+  }, [basis, savedAt]);
   usePaneStatusFooter({ registrationId: "doe", loading: resource.loading, error: notAvailable ? null : resource.error,
-    stale: !!data && resource.data?.stale, info });
+    stale: !!data && !!resource.data?.stale && savedAt == null, info });
   return (
     <Box width={width} height={height} flexDirection="column">
       {strip}

package/src/plugins/builtin/doe/prices.ts

@@ -2,7 +2,7 @@ import { apiClient } from "../../../api-client";
 import type { DoePricesPayload } from "../../../api-client/doe";
 import { createPluginCache } from "../../../data/plugin-cache";
 import type { SeriesDefinition } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 
 /**
@@ -73,10 +73,9 @@ export const DOE_PRICE_SERIES: readonly SeriesDefinition[] = PRICE_SERIES.map((s
     const resource = await loadCloudResource(doePriceCache, "prices", () => fetchDoePrices(), { validate: validatePrices });
     const row = resource.payload.series.find((entry) => entry.id === series.id);
     if (!row?.points.length) throw new Error(`${series.name} is not available yet.`);
-    const warning = cachedSeriesWarning(resource);
     return {
       points: row.points.map(([date, value]) => ({ date, value })),
-      ...(warning ? { warning } : {}),
+      ...cachedSeriesNote(resource),
       // Cited as the EIA series it is, not as the route that served it.
       attribution: { source: `EIA series ${series.key}`, publisher: "EIA" },
     };

package/src/plugins/builtin/doe/series.ts

@@ -1,6 +1,6 @@
 import type { DoeSeriesRow, DoeUnit } from "../../../api-client/doe";
 import type { SeriesDefinition, SeriesPoint } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadDoeBoard } from "./client";
 import { DOE_SERIES_OPTIONS } from "./model";
 import { DOE_PRICE_SERIES } from "./prices";
@@ -50,14 +50,14 @@ const DOE_SERIES: readonly SeriesDefinition[] = DOE_SERIES_OPTIONS.map((option):
     unit: UNITS[unit].unit,
     frequency: "weekly",
     group: "Energy",
-    tags: gas ? ["natural gas", "storage", "inventories"] : ["oil", "petroleum", "inventories", "US"],
+    // Jet fuel is kerosene, the word a reader may search it by.
+    tags: gas ? ["natural gas", "storage", "inventories"] : ["oil", "petroleum", "inventories", "US", ...option.value === "jet" ? ["kerosene"] : []],
     publisher: "EIA",
     load: async () => {
       const resource = await loadDoeBoard();
       const row = resource.payload.series.find((entry) => entry.id === option.value);
       if (!row) throw new Error(`${option.label} is not in this week's report.`);
-      const warning = cachedSeriesWarning(resource);
-      return { points: doeRowPoints(row), ...(warning ? { warning } : {}) };
+      return { points: doeRowPoints(row), ...cachedSeriesNote(resource) };
     },
   };
 });

package/src/plugins/builtin/earnings-calls/calendar.tsx

@@ -19,6 +19,8 @@ import {
   type SectionedRow,
 } from "../../../components";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
+import { isPermanentClientError } from "../../../api-client/errors";
 import { TABLE_COLUMN_GAP, tableColumnWidth } from "../../../components/ui/table-layout";
 import { useAsyncResource } from "../../../react/async-resource";
 import { useAgeClock, useAutoRefresh } from "../../../react/auto-refresh";
@@ -162,6 +164,8 @@ export function UpcomingCallsView({ focused, width, height, view, renderCompany
   }, [range]);
   const resource = useAsyncResource(entitled ? loader : null, {
     keepPreviousData: true,
+    // A refusal asking again will not change takes the calendar off screen, for its wall or its error.
+    clearOnError: isPermanentClientError,
     initialData: () => cachedUpcomingCalls(range),
   });
   const data = resource.data;
@@ -204,12 +208,16 @@ export function UpcomingCallsView({ focused, width, height, view, renderCompany
   const proRequired = !signInRequired && !verificationRequired && (!access.hasProAccess || (!data && refused === 402));
 
   const hints = useMemo<PaneHint[]>(() => [{ id: "search", key: "/", label: "search", onPress: focusSearch }], [focusSearch]);
+  // A refresh that failed shows the calendar an earlier read saved, and says when that copy is from.
+  const savedAt = data?.savedAt ?? null;
+  const savedInfo = useMemo(() => savedCopyFooterInfo([savedAt]), [savedAt]);
   usePaneStatusFooter({
     registrationId: "earnings-calls:calendar",
     enabled: !detailOpen && entitled,
     loading: resource.loading && !!data,
-    error: data ? data.refreshError ?? resource.error : null,
-    stale: !!data && (data.stale || !!resource.error),
+    error: data ? (savedAt == null ? data.refreshError : null) ?? resource.error : null,
+    stale: !!data && savedAt == null && (data.stale || !!resource.error),
+    info: savedInfo,
     hints,
   });
   // A calendar cut at the server's limit says so, rather than end the week early.