gloomberb 0.19.1 → 0.19.2

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

@@ -8,12 +8,12 @@ import {
   DataTableView,
   EmptyState, FigureList, PaneStatusBody, Prose, QueryBar, READING_WIDTH, SectionHeading,
   usePaneFooter,
-  usePaneNoticeFooter,
   type DataTableCell,
   type DataTableColumn,
   type PaneFooterSegment,
   type PaneHint,
 } from "../../../components";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
 import { useAsyncResource } from "../../../react/async-resource";
 import { usePaneStateValue } from "../../../state/app/context";
 import { colors, getChartIndicatorColor } from "../../../theme/colors";
@@ -45,13 +45,6 @@ import {
 
 export const EXECUTIVES_PANE_ID = "executives";
 
-function retainedDataNotice(subject: string, error: string, fetchedAt: number | null): string {
-  const retrieved = new Date(fetchedAt ?? Number.NaN);
-  const age = Number.isFinite(retrieved.getTime())
-    ? `retrieved ${retrieved.toISOString()}` : "with unavailable retrieval time";
-  return `${subject} refresh failed: ${error}. Retained data ${age}.`;
-}
-
 const PAY_PARTS: Array<{ key: keyof CloudExecutiveRowPayload; label: string }> =
   [
     { key: "salary", label: "Salary" },
@@ -301,18 +294,10 @@ function ExecutiveResearch({ ticker, listing, tier, focused, width, nested, guar
   // The free preview: each executive's total pay; the breakdown and earlier years are Pro.
   const preview = statement?.access === "preview" || list.data?.data?.access === "preview";
   const loading = list.loading || detail.loading;
-  const listError = list.error ?? list.data?.refreshError;
-  const statementError = detail.error ?? detail.data?.refreshError;
-  usePaneNoticeFooter({
-    registrationId: `${EXECUTIVES_PANE_ID}:data-notices`,
-    notices: [
-      list.data?.data && listError
-        ? retainedDataNotice("Proxy list", listError, list.data.fetchedAt) : null,
-      detail.data?.data && statementError
-        ? retainedDataNotice(`${year} proxy`, statementError, detail.data.fetchedAt) : null,
-    ].filter((notice): notice is string => notice !== null),
-    focused,
-  });
+  // A copy saved earlier answering a failed refresh says when it was saved, in the footer every pane uses;
+  // a failed refresh with only what is on screen says why. Without anything shown, the body says it.
+  const listError = list.data?.data ? list.error ?? (list.data.savedAt == null ? list.data.refreshError : null) ?? null : null;
+  const statementError = detail.data?.data ? detail.error ?? (detail.data.savedAt == null ? detail.data.refreshError : null) ?? null : null;
   const refresh = useCallback(() => {
     void list.reload();
     if (year !== null) void detail.reload();
@@ -338,6 +323,9 @@ function ExecutiveResearch({ ticker, listing, tier, focused, width, nested, guar
     const info: PaneFooterSegment[] = [];
     if (loading)
       info.push({ id: "loading", parts: [{ text: "loading", tone: "muted" }] });
+    if (listError) info.push({ id: "list-error", parts: [{ text: `Proxy list: ${listError}`, tone: "warning" }] });
+    if (statementError) info.push({ id: "statement-error", parts: [{ text: `${year} proxy: ${statementError}`, tone: "warning" }] });
+    info.push(...savedCopyFooterInfo([list.data?.data ? list.data.savedAt : null, statement ? detail.data?.savedAt : null]));
     if (statement) {
       info.push({
         id: "filed",
@@ -351,7 +339,7 @@ function ExecutiveResearch({ ticker, listing, tier, focused, width, nested, guar
     if (yearHint) hints.push(yearHint);
     if (preview) hints.push({ id: "upgrade", key: CLOUD_PLAN_KEY, label: "upgrade", title: "Upgrade to Pro", onPress: openUpgrade });
     return { info, hints };
-  }, [loading, statement, openFiling, yearHint, preview, openUpgrade]);
+  }, [loading, listError, statementError, year, list.data, detail.data, statement, openFiling, yearHint, preview, openUpgrade]);
 
   const figures = useMemo(
     () => (statement ? figuresOf(statement) : []),

package/src/plugins/builtin/fear-greed/cache.ts

@@ -35,6 +35,10 @@ export type FearGreedCacheEntry = {
 export interface FearGreedLoadResult extends FearGreedCacheEntry {
   /** Set when the network failed and cached data was served instead. */
   refreshError?: string;
+  /** `stale-fallback` when a saved copy answered a failed refresh. */
+  source?: "cache" | "network" | "stale-fallback";
+  /** The failure a `stale-fallback` copy answered. */
+  error?: unknown;
 }
 
 const cache = createPluginCache<FearGreedData, PersistedFearGreedData>({

package/src/plugins/builtin/fear-greed/series.ts

@@ -1,5 +1,6 @@
 import type { SeriesDefinition, SeriesLoadResult, SeriesPoint } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { savedCopyForTransientFailure } from "../../../data/plugin-cache";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadFearGreed } from "./cache";
 import type { FearGreedData } from "./data";
 
@@ -30,9 +31,10 @@ function series(id: string, name: string, unit: string, read: Reading, tags: rea
     tags: ["fear and greed", ...tags],
     refreshMs: REFRESH_MS,
     load: async (): Promise<SeriesLoadResult> => {
-      const result = await loadFearGreed();
-      const warning = cachedSeriesWarning(result);
-      return { points: read(result.data), ...(warning ? { warning } : {}) };
+      // A saved copy answers only a failure asking again may get past; a refusal is the chart's error.
+      const result = savedCopyForTransientFailure(await loadFearGreed());
+      return { points: read(result.data),
+        ...cachedSeriesNote({ ...result, ...(result.source === "stale-fallback" ? { savedAt: result.fetchedAt } : {}) }) };
     },
   };
 }

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

@@ -1,4 +1,5 @@
 import { resolvePlanAccess } from "../../../api-client/plan-rules";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import { apiClient } from "../../../api-client";
 import type { GpuBoardPayload, GpuEventsPayload, GpuHistoryPayload, GpuHistoryQuery, GpuObservation } from "../../../api-client/gpu";
 import { createPluginCache } from "../../../data/plugin-cache";
@@ -94,7 +95,9 @@ export async function fetchGpuBoard(client: Pick<GpuApi, "getCloudGpuBoard"> = a
   try { payload = await client.getCloudGpuBoard(); }
   catch (error) { throw unavailableOnServer(error, GPU_NOT_AVAILABLE, [404, 503]); }
   const board = validateBoard(payload);
-  if (board.status === "unavailable" || !board.rows.length) throw new Error(GPU_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(GPU_NOT_AVAILABLE);
+  if (!board.rows.length) throw new Error(GPU_NOT_AVAILABLE);
   return board;
 }
 

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

@@ -1,5 +1,5 @@
 import type { SeriesDefinition } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadGpuBoard, loadGpuHistory } from "./client";
 import { GPU_MODELS, gpuListIndex } from "./model";
 
@@ -27,12 +27,11 @@ export const GPU_SERIES: readonly SeriesDefinition[] = GPU_MODELS.map((model): S
     if (!index) throw new Error(`No ${model} list index is listed yet.`);
     const history = await loadGpuHistory(index.id);
     if (history.payload.access?.locked) throw new Error(GPU_PRO_ONLY);
-    const warning = cachedSeriesWarning(history);
     return {
       points: history.payload.points
         .filter((point) => `${point.source}:${point.skuKey}` === index.id)
         .map((point) => ({ date: point.observedAt, value: point.pricePerGpuHr })),
-      ...(warning ? { warning } : {}),
+      ...cachedSeriesNote(history),
     };
   },
 }));

package/src/plugins/builtin/holders/beneficial-view.tsx

@@ -11,6 +11,7 @@ import {
 } from "../../../components";
 import { useCompanyDataFooter } from "../../../components/layout/pane/status-footer";
 import { handleRefreshKey, loadingErrorFooterInfo } from "../../../components/data-table/table-pane";
+import { STALE_SEGMENT } from "../../../components/layout/pane/status-footer";
 import type { IssuerListingParams } from "../../../api-client/paths";
 import { useAsyncResource } from "../../../react/async-resource";
 import { useAutoRefresh } from "../../../react/auto-refresh";
@@ -43,8 +44,6 @@ import {
 import type { Holder13FMatch } from "./thirteenf-match";
 import type { HolderRow } from "./types";
 
-const STALE_SEGMENT = { id: "stale", parts: [{ text: "stale", tone: "warning" as const }] };
-
 /**
  * A table line: a filer's row, or the line beneath it giving the same shares
  * against today's count when the report's base is no longer today's.

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

@@ -1,4 +1,5 @@
 import { apiClient } from "../../../api-client";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import type { JodiBoardPayload } from "../../../api-client/commodity-balances";
 import { unavailableOnServer } from "../shared/cloud-resource";
 import type { BalanceCommodity, Board } from "./model";
@@ -32,7 +33,9 @@ function readBoard(payload: JodiBoardPayload): Balances {
     || (payload.gas != null && !validBoard(payload.gas, "gas"))) {
     throw new Error("The server returned an invalid oil and gas balance board");
   }
-  if (payload.status === "unavailable" || payload.oil == null) throw new Error(JODI_NOT_AVAILABLE);
+  // The server's source did not answer this time, which may pass; a board with no oil has none yet.
+  if (payload.status === "unavailable") throw sourceDidNotAnswer(JODI_NOT_AVAILABLE);
+  if (payload.oil == null) throw new Error(JODI_NOT_AVAILABLE);
   if (!validBoard(payload.oil, "oil")) throw new Error("The server returned an invalid oil and gas balance board");
   return { oil: payload.oil, gas: payload.gas ?? null, stale: payload.stale === true, gaps: payload.gaps };
 }

package/src/plugins/builtin/market-movers/client.ts

@@ -119,6 +119,7 @@ export async function loadMarketMoverTab(
       ...hydrated,
       source: "gloom",
       stale: trending.stale || !!hydrated.unavailableSymbols?.length,
+      ...(trending.savedAt != null ? { savedAt: trending.savedAt } : {}),
     };
   }
   const category = CATEGORY_MAP[tab];

package/src/plugins/builtin/market-movers/index.tsx

@@ -2,6 +2,8 @@ import { Box, useUiCapabilities } from "../../../ui";
 import { nextHeaderSort } from "../../../utils/sort-values";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { DataTableView, EmptyState, QueryBar, usePaneFooter, usePaneTabs, type DataTableKeyEvent } from "../../../components";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
+import { STALE_SEGMENT } from "../../../components/layout/pane/status-footer";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
 import type { PaneProps } from "../../../types/plugin";
 import type { PluginModule } from "../plugin-module";
@@ -167,6 +169,8 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
   const [selectedSymbol, setSelectedSymbol] = useState<string | null>(null);
   const [sortPreference, setSortPreference] = useState<MarketMoverSortPreference>(DEFAULT_SORT_PREFERENCE);
   const [moversStale, setMoversStale] = useState(false);
+  // The list's refresh failed and a copy saved at this time (ms) answered instead.
+  const [moversSavedAt, setMoversSavedAt] = useState<number | null>(null);
   const [lastSuccess, setLastSuccess] = useState<{ key: string; at: number } | null>(null);
 
   const fetchGenRef = useRef(0);
@@ -241,11 +245,13 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
         if (!options?.background) setSelectedSymbol(null);
       }
       setMoversStale(result.stale);
+      setMoversSavedAt(result.savedAt ?? null);
       setLoadError(quoteError);
       if (!quoteError && !result.stale) setLastSuccess({ key: `${tab}:${minFloat ?? ""}`, at: Date.now() });
     } catch {
       if (fetchGenRef.current !== gen) return;
       setMoversStale(true);
+      setMoversSavedAt(null);
       setLoadError("Market movers temporarily unavailable");
     }
     finally {
@@ -288,14 +294,13 @@ function ScreenerMoversBody({ activeTab, focused, width, summaryQuotes, liveStre
         id: "feed",
         parts: [{ text: feedStatus, tone: feedStatus === "live" ? "value" as const : "muted" as const }],
       }] : []),
-      ...(moversStale && loadedKey === listKey ? [{
-        id: "stale",
-        parts: [{ text: "stale", tone: "muted" as const }],
-      }] : []),
+      // A saved copy answering a failed refresh says when it was saved; other stale rows say only that.
+      ...(loadedKey === listKey ? savedCopyFooterInfo([moversSavedAt]) : []),
+      ...(moversStale && moversSavedAt == null && loadedKey === listKey ? [STALE_SEGMENT] : []),
       // The FLOAT column shows while a minimum is set; a float the source does not date says so once.
       ...partialFloatFooter(columns.some((column) => column.id === "floatShares"), rows),
     ],
-  }), [columns, feedStatus, listKey, loadedKey, loadError, loading, moversStale, rows, summaryQuotes]);
+  }), [columns, feedStatus, listKey, loadedKey, loadError, loading, moversStale, moversSavedAt, rows, summaryQuotes]);
 
   return (
     <DataTableView<MarketMoverRow, MarketMoverColumn>

package/src/plugins/builtin/market-movers/screener.ts

@@ -5,6 +5,7 @@ import { logFailure } from "../../../utils/log-failure";
 import { savedCopyMark, servedFromSavedCopy } from "../../../data/saved-copies";
 import type { PluginPersistence } from "../../../types/plugin";
 import { apiClient } from "../../../api-client";
+import { isTransientFailure, sourceDidNotAnswer } from "../../../api-client/errors";
 import type {
   CloudMarketResponse,
   CloudMarketScreenerCategory,
@@ -96,6 +97,8 @@ function writeCache<T>(key: string, data: T): void {
 export interface CachedResult<T> {
   data: T;
   stale: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
 }
 
 async function loadCached<T>(
@@ -119,11 +122,13 @@ async function loadCached<T>(
       return result;
     })
     .catch((error) => {
-      // Serving the expired copy is right; hiding that it is expired is not. A command that shows it
-      // ends with when the copy was saved.
-      if (fallback) {
-        failedFetches.add(key);
-        return servedFromSavedCopy({ data: fallback.data, stale: true }, fallback.fetchedAt);
+      // The next read asks again rather than read the saved copy as current.
+      if (fallback) failedFetches.add(key);
+      // Serving the expired copy is right for a failure asking again may get past; hiding that it is
+      // expired is not. A command that shows it ends with when the copy was saved. A refusal or a
+      // reply that fails validation is the error, saved copy or not.
+      if (fallback && isTransientFailure(error)) {
+        return servedFromSavedCopy({ data: fallback.data, stale: true, savedAt: fallback.fetchedAt }, fallback.fetchedAt);
       }
       throw error;
     })
@@ -146,6 +151,8 @@ export interface MarketMoversResult {
   quotes: ScreenerQuote[];
   source: MarketMoversDataSource;
   stale: boolean;
+  /** Its refresh failed and the list saved at this time (ms) answered instead. */
+  savedAt?: number;
 }
 
 export interface PreferredMarketMoverSources {
@@ -268,6 +275,8 @@ export async function fetchScreenerResult(
   const session = category === "most_actives" ? undefined : options?.session;
   const load = async () => {
     const response = await api.getMarketMovers(category, count, options?.forceRefresh, session);
+    // The service's own source did not answer this time: a saved list answers, as it does a 5xx.
+    if (!response.data && response.status === "retryable_error") throw sourceDidNotAnswer("Market movers temporarily unavailable");
     if (!response.data) throw new Error("Invalid market movers response");
     return { data: parseScreenerResponse(response.data), stale: response.stale === true || response.data.stale === true };
   };
@@ -392,7 +401,13 @@ export async function fetchPreferredMarketMovers(
   const eligibility = sources.isCloudEligible();
   if (!(typeof eligibility === "boolean" ? eligibility : await eligibility)) {
     const result = await sources.fetchMarket(category, count, options);
-    return { ...savedCopyMark(result), quotes: rankScreenerQuotes(category, result.data), source: "gloom", stale: result.stale };
+    return {
+      ...savedCopyMark(result),
+      quotes: rankScreenerQuotes(category, result.data),
+      source: "gloom",
+      stale: result.stale,
+      ...(result.savedAt != null ? { savedAt: result.savedAt } : {}),
+    };
   }
 
   const marketMetadata = sources.fetchMarket(
@@ -432,6 +447,7 @@ export async function fetchPreferredMarketMovers(
     quotes: rankScreenerQuotes(category, fallback.data),
     source: "gloom",
     stale: fallback.stale,
+    ...(fallback.savedAt != null ? { savedAt: fallback.savedAt } : {}),
   };
 }
 
@@ -448,6 +464,7 @@ export async function fetchTrendingResult(
   const load = async () => {
     const response = await (api.getMarketTrending ?? apiClient.getMarketTrending)(count);
     if (response.status === "empty") return { data: [], stale: response.stale === true };
+    if (!response.data && response.status === "retryable_error") throw sourceDidNotAnswer("Market trends temporarily unavailable");
     if (!response.data) throw new Error("Market trends unavailable");
     return { data: parseTrendingResponse(response.data), stale: response.stale === true };
   };

package/src/plugins/builtin/market-movers/session-body.tsx

@@ -6,6 +6,7 @@ import type {
 } from "../../../api-client/market-movers";
 import { usePlanAccess } from "../../../api-client/plan-access";
 import { DataTableView, EmptyState, QueryBar, usePaneFooter, type DataTableKeyEvent } from "../../../components";
+import { STALE_SEGMENT } from "../../../components/layout/pane/status-footer";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
 import {
   buildScreenerQuoteTargets,
@@ -201,7 +202,7 @@ function SessionMoversTable({ view, session, focused, width, summaryQuotes, live
         id: "feed",
         parts: [{ text: feedStatus, tone: feedStatus === "live" ? "value" as const : "muted" as const }],
       }] : []),
-      ...(payload?.stale ? [{ id: "stale", parts: [{ text: "stale", tone: "muted" as const }] }] : []),
+      ...(payload?.stale ? [STALE_SEGMENT] : []),
       // A float the source does not date says so once, while the FLOAT column shows.
       ...partialFloatFooter(columns.some((column) => column.id === "floatShares"), rows),
     ],

package/src/plugins/builtin/money-markets/series.ts

@@ -1,6 +1,6 @@
 import type { MoneyMarketObservation } from "../../../api-client/money-markets";
 import type { SeriesDefinition } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadMoneyMarkets } from "./client";
 
 function observations(history: readonly MoneyMarketObservation[]) {
@@ -21,8 +21,7 @@ export const MONEY_MARKET_SERIES: readonly SeriesDefinition[] = [
     tags: ["liquidity", "Fed balance sheet", "TGA", "RRP", "money markets"],
     load: async () => {
       const resource = await loadMoneyMarkets();
-      const warning = cachedSeriesWarning(resource);
-      return { points: observations(resource.payload.netLiquidity.history), ...(warning ? { warning } : {}) };
+      return { points: observations(resource.payload.netLiquidity.history), ...cachedSeriesNote(resource) };
     },
   },
   {
@@ -34,8 +33,7 @@ export const MONEY_MARKET_SERIES: readonly SeriesDefinition[] = [
     tags: ["bills", "curve", "money markets"],
     load: async () => {
       const resource = await loadMoneyMarkets();
-      const warning = cachedSeriesWarning(resource);
-      return { points: observations(resource.payload.billsCurve.slope.history), ...(warning ? { warning } : {}) };
+      return { points: observations(resource.payload.billsCurve.slope.history), ...cachedSeriesNote(resource) };
     },
   },
 ];

package/src/plugins/builtin/power/gas-client.ts

@@ -1,4 +1,5 @@
 import { apiClient } from "../../../api-client";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import type { GasStorageBoard, GasStorageHistory, GasStorageRow, GasStorageSeasonal } from "../../../api-client/europe-energy";
 import { createPluginCache } from "../../../data/plugin-cache";
 import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
@@ -77,7 +78,7 @@ export async function fetchGasStorage(client: Pick<GasApi, "getCloudEuropeGas">
   } catch (error) {
     throw unavailableOnServer(error, GAS_STORAGE_NOT_AVAILABLE, [404, 503]);
   }
-  if (board.status === "unavailable") throw new Error(GAS_STORAGE_NOT_AVAILABLE);
+  if (board.status === "unavailable") throw sourceDidNotAnswer(GAS_STORAGE_NOT_AVAILABLE);
   return board;
 }
 

package/src/plugins/builtin/power/prices-client.ts

@@ -1,4 +1,5 @@
 import { apiClient } from "../../../api-client";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import type { CarbonBoard, CarbonHistory, EuropePowerBoard, EuropePowerHistory, PowerPriceRow } from "../../../api-client/europe-energy";
 import { createPluginCache } from "../../../data/plugin-cache";
 import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
@@ -87,7 +88,7 @@ export async function fetchPowerPrices(client: Pick<PricesApi, "getCloudEuropePo
   } catch (error) {
     throw unavailableOnServer(error, POWER_PRICES_NOT_AVAILABLE, [404, 503]);
   }
-  if (board.status === "unavailable") throw new Error(POWER_PRICES_NOT_AVAILABLE);
+  if (board.status === "unavailable") throw sourceDidNotAnswer(POWER_PRICES_NOT_AVAILABLE);
   return board;
 }
 
@@ -110,7 +111,7 @@ export async function fetchCarbonPrice(client: Pick<PricesApi, "getCloudEuropeCa
   } catch (error) {
     throw unavailableOnServer(error, CARBON_PRICE_NOT_AVAILABLE, [404, 503]);
   }
-  if (board.status === "unavailable") throw new Error(CARBON_PRICE_NOT_AVAILABLE);
+  if (board.status === "unavailable") throw sourceDidNotAnswer(CARBON_PRICE_NOT_AVAILABLE);
   return board;
 }
 

package/src/plugins/builtin/risk-factors/data.ts

@@ -3,7 +3,7 @@ import {
   type CloudRiskReportListPayload,
   type CloudRiskReportPayload,
 } from "../../../api-client";
-import { ApiRequestError, isPermanentClientError } from "../../../api-client/errors";
+import { ApiRequestError, isPermanentClientError, isTransientFailure } from "../../../api-client/errors";
 import { listingAbroad, type IssuerListingParams } from "../../../api-client/paths";
 import { servedFromSavedCopy } from "../../../data/saved-copies";
 import type { HeadlessPaneApiClient, PluginPersistence } from "../../../types/plugin";
@@ -21,6 +21,8 @@ type RiskApiClient = Pick<HeadlessPaneApiClient, "getRiskReports" | "getRiskRepo
 interface RiskFreshness {
   fetchedAt: number;
   stale: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
   errorStatus?: number;
 }
@@ -72,9 +74,10 @@ function loadCached<T extends object>(
     // A failed forced refresh must be retried when this pane is reopened, even
     // when the previously cached value has not reached its ordinary TTL yet.
     if (current()) failedRefreshes.set(failedKey, store);
-    // A missing or denied resource must not be replaced by previously cached content.
-    if (isPermanentClientError(error)) {
-      if (current()) store?.deleteResource(kind, key, { sourceKey: CACHE_SOURCE });
+    // A saved copy answers only for a failure asking again may get past: a refusal or a reply that
+    // fails validation is the error, and a missing or denied resource also drops its copy.
+    if (!isTransientFailure(error)) {
+      if (isPermanentClientError(error) && current()) store?.deleteResource(kind, key, { sourceKey: CACHE_SOURCE });
       throw error;
     }
     const fallback = store?.getResource<T>(kind, key, { ...options, allowExpired: true });
@@ -84,6 +87,7 @@ function loadCached<T extends object>(
       ...fallback.value,
       fetchedAt: fallback.fetchedAt,
       stale: true,
+      savedAt: fallback.fetchedAt,
       refreshError: (error instanceof Error ? error.message : String(error)).trim() || "Request failed",
       errorStatus: error instanceof ApiRequestError ? error.status : undefined,
     }, fallback.fetchedAt);

package/src/plugins/builtin/risk-factors/index.tsx

@@ -21,7 +21,8 @@ const description =
  * filing list, which needs no account: `filings` lists them with a link to
  * each, where Item 1A is the risk factors as written, without RISK's grouping
  * or its changes since the year before. A foreign issuer files a 20-F instead
- * (ASML), whose Item 3.D holds them.
+ * (ASML), whose Item 3.D holds them. A company that files neither (IAG on
+ * LSE) has nothing in RISK either, and the note says so.
  */
 function riskFactorsLockNote(lock: PaneLock): Promise<string> {
   return proLockNote(lock, {
@@ -35,6 +36,7 @@ function riskFactorsLockNote(lock: PaneLock): Promise<string> {
       text: (ticker, company) => `gloom filings ${ticker} --form 20-F lists ${company}'s annual reports, each with its filing date and a link to the filing, whose Item 3.D holds the risk factors as written.`,
       answers: (symbol, context) => filesForm(symbol, "20-F", context),
     }],
+    noneFor: (ticker) => `${ticker}'s company files no 10-K or 20-F with the SEC, so RISK has no risk factors for it.`,
   });
 }
 

package/src/plugins/builtin/risk-factors/pane.tsx

@@ -8,6 +8,7 @@ import {
   type PaneFooterSegment,
   type PaneHint,
 } from "../../../components";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
 import { useAsyncResource } from "../../../react/async-resource";
 import { colors } from "../../../theme/colors";
 import {
@@ -119,8 +120,9 @@ function RiskFactorsReader({
   const reportLoader = useCallback((force: boolean) => guard(loadRiskReport(ticker!, year!, { force, listing })), [guard, listing, ticker, year]);
   const detail = useAsyncResource(ticker && year !== null ? reportLoader : null, { clearOnError: isPermanentClientError });
   const report = detail.data;
-  const listError = list.error ?? list.data?.refreshError ?? null;
-  const reportError = detail.error ?? report?.refreshError ?? null;
+  // A copy saved earlier answering a failed refresh says when it was saved, in the footer every pane uses, not as an error.
+  const listError = list.error ?? (list.data?.savedAt == null ? list.data?.refreshError : null) ?? null;
+  const reportError = detail.error ?? (report?.savedAt == null ? report?.refreshError : null) ?? null;
   const refresh = useCallback(() => {
     void list.reload();
     if (year !== null) void detail.reload();
@@ -151,12 +153,7 @@ function RiskFactorsReader({
       info.push({ id: "loading", parts: [{ text: "loading", tone: "muted" }] });
     if (listError) info.push({ id: "list-error", parts: [{ text: `Report list: ${listError}`, tone: "warning" }] });
     if (reportError) info.push({ id: "report-error", parts: [{ text: `${year} report: ${reportError}`, tone: "warning" }] });
-    if ((listError || list.data?.stale) && list.data) {
-      info.push({ id: "list-stale", parts: [{ text: `List cached ${new Date(list.data.fetchedAt).toISOString()}`, tone: "muted" }] });
-    }
-    if ((reportError || report?.stale) && report) {
-      info.push({ id: "report-stale", parts: [{ text: `Report cached ${new Date(report.fetchedAt).toISOString()}`, tone: "muted" }] });
-    }
+    info.push(...savedCopyFooterInfo([list.data?.savedAt, report?.savedAt]));
     const hints: PaneHint[] = report?.docUrl
       ? [{ id: "open", key: "o", label: "pen filing", onPress: openFiling }]
       : [];

package/src/plugins/builtin/scanner/lock-note.ts

@@ -1,12 +1,34 @@
 import type { PaneLock } from "../../../types/plugin";
-import { proLockNote } from "../shared/pro-lock-note";
+import { isOptionsUnavailableError } from "../../../market-data/options-alternatives";
+import { resolveHeadlessInstrument } from "../shared/headless-market-data";
+import { proLockNote, type FreeRoute } from "../shared/pro-lock-note";
+
+/**
+ * The listing's option chain, which needs no account, where options are
+ * served for it: LHA:XETRA has none, and `options LHA:XETRA` says so.
+ */
+const OPTIONS_ROUTE: FreeRoute = {
+  text: (ticker, company) => `gloom options ${ticker} lists ${company}'s option chain, each contract with its volume and open interest.`,
+  answers: async (symbol, context) => {
+    const { symbol: ticker, exchange } = await resolveHeadlessInstrument(context, symbol);
+    if (!context.marketData.getOptionsChain) return false;
+    try {
+      const chain = await context.marketData.getOptionsChain(ticker, exchange ?? "");
+      return chain.expirationDates.length + chain.calls.length + chain.puts.length > 0;
+    } catch (error) {
+      if (isOptionsUnavailableError(error)) return false;
+      throw error;
+    }
+  },
+};
 
 /**
  * FLOW is Pro whole: the one scanner with no delayed tier to fall back to.
  * The options chain needs no account and lists each contract's day volume and
  * open interest, the raw counts behind a sweep or a block, without the prints.
  * FLOW takes a ticker only to narrow the market to one name, so the note
- * repeats it only when the reader gave one.
+ * repeats it only when the reader gave one, and only when the listing has
+ * options served: FLOW's prints are of the same US options.
  */
 export function flowLockNote(lock: PaneLock): Promise<string> {
   return proLockNote(lock, {
@@ -14,6 +36,7 @@ export function flowLockNote(lock: PaneLock): Promise<string> {
     argument: "optional",
     does: "it streams real-time sweeps, blocks and large premium prints across US options exchanges",
     shows: "it",
-    free: [{ text: (ticker, company) => `gloom options ${ticker} lists ${company}'s option chain, each contract with its volume and open interest.` }],
+    free: [OPTIONS_ROUTE],
+    noneFor: (ticker) => `Options are not available for ${ticker}, so FLOW has no prints of it.`,
   });
 }

package/src/plugins/builtin/shared/cloud-resource.ts

@@ -1,6 +1,6 @@
 import { logFailure } from "../../../utils/log-failure";
-import { ApiRequestError, isPermanentClientError } from "../../../api-client/errors";
-import type { PluginCacheResult } from "../../../data/plugin-cache";
+import { ApiRequestError } from "../../../api-client/errors";
+import { savedCopyForTransientFailure, type PluginCacheResult } from "../../../data/plugin-cache";
 
 interface CloudCache<T> {
   get(key: string, options?: { allowExpired?: boolean }): PluginCacheResult<T> | null;
@@ -38,9 +38,11 @@ const isAbort = (error: unknown) => !!error && typeof error === "object" && (err
 
 /**
  * Loads through the cache, falling back to the cached copy when a refresh
- * fails. A refusal asking again will not change still throws: a refused
- * session, so the pane shows its sign-in wall instead of data the account can
- * no longer see, and any other permanent client error (an unknown series).
+ * fails for a reason asking again may get past (`isTransientFailure`). A
+ * refusal still throws: a refused session, so the pane shows its sign-in wall
+ * instead of data the account can no longer see, any other permanent client
+ * error (an unknown series, a route not served), and a reply that fails
+ * validation.
  *
  * Callers of one key share the request in flight, which runs on the first
  * caller's `signal`. When that caller goes away (a tab left while it loads,
@@ -60,8 +62,7 @@ export async function loadCloudResource<T>(
     throw error;
   });
   if (!result || cancelledByOther(result.error)) result = await cache.load(key, fetch, { force });
-  const saved = result.source === "stale-fallback";
-  if (saved && isPermanentClientError(result.error)) throw result.error;
+  const saved = savedCopyForTransientFailure(result).source === "stale-fallback";
   // A copy served because its refresh failed is one by where it came from, whatever the failure said (or did not).
   return {
     payload: validate(result.data), stale: result.stale, refreshError: result.refreshError ?? null,
@@ -72,7 +73,11 @@ export async function loadCloudResource<T>(
 /**
  * Turns a route the server does not serve yet (404, or the given statuses)
  * into a message that says what is unavailable; other errors pass through.
+ * The status stays, so a 404 is still a refusal no saved copy answers for and
+ * a 503 still a failure one may.
  */
 export function unavailableOnServer(error: unknown, message: string, statuses: readonly number[] = [404]): unknown {
-  return error instanceof ApiRequestError && statuses.includes(error.status ?? 0) ? new Error(message) : error;
+  return error instanceof ApiRequestError && statuses.includes(error.status ?? 0)
+    ? new ApiRequestError(message, error.status, error.retryAfterMs, error.code, error.details)
+    : error;
 }

package/src/plugins/builtin/shared/fred-points.ts

@@ -1,11 +1,15 @@
 import { apiClient } from "../../../api-client";
 import { loadCachedFredSeries } from "../../../sources/gloomberb-cloud/fred-series";
 
-/** A FRED series from `start` on, oldest first, through the shared FRED cache. */
+/**
+ * A FRED series from `start` on, oldest first, through the shared FRED cache;
+ * `savedAt` when a failed refresh left the copy saved then answering.
+ */
 export async function loadFredPoints(seriesId: string, start?: Date): Promise<{
   points: Array<{ date: string; value: number | null }>;
   stale: boolean;
   refreshError?: string;
+  savedAt?: number;
 }> {
   const startDate = start ? start.toISOString().slice(0, 10) : "1900-01-01";
   const result = await loadCachedFredSeries(
@@ -16,5 +20,6 @@ export async function loadFredPoints(seriesId: string, start?: Date): Promise<{
     points: (result.data.observations ?? []).map((row) => ({ date: row.date, value: row.value })),
     stale: result.stale,
     ...(result.refreshError ? { refreshError: result.refreshError } : {}),
+    ...(result.source === "stale-fallback" ? { savedAt: result.fetchedAt } : {}),
   };
 }