gloomberb 0.18.1 → 0.18.3

package/src/plugins/builtin/iv-history/headless.ts

@@ -2,10 +2,19 @@ import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { resolveHeadlessInstrument } from "../shared/headless-market-data";
 import { createRealizedVolatilityDependencies, loadRealizedVolatilityHistory } from "../realized-vol/client";
 import { createHvDependencies, loadIvHistory, loadIvScreen, loadScreenVolatilities } from "./client";
-import { formatPoints, formatRank, formatSpot, formatStat, formatVol, readingLabel, sharedDates, skewHeader, VCA_DEFINITIONS, verdictLabel } from "./format";
+import { formatPoints, formatRank, formatSpot, formatStat, formatVol, IMPLIED_VOL_WORDS, readingLabel, sharedDates, skewHeader, VCA_DEFINITIONS, verdictLabel } from "./format";
 import { HV_WINDOWS, type HvWindow, type IvLookback, type IvStatRow, projectIvHistory, projectRichCheap, type RichCheapRow, richCheapDates, screenCoverage, VCA_LIMIT, VCA_PRESETS } from "./model";
 import { vcaUniverse } from "./universe";
-import { listingFateNotes, loadListingFate, MovedSymbolError } from "../../../tickers/listing-fate";
+import { offsetText, releaseOffsetRows } from "./events";
+import { loadMacroReleases } from "../macro-day/client";
+import { MACRO_EVENT_KINDS, MACRO_EVENT_LABELS, MACRO_RELEASE_SOURCES, staleMacroReleasesNotice, type MacroEventKind, type MacroRelease,
+  type MacroReleaseList } from "../macro-day/releases";
+import { lookupScheduledDates } from "../alerts/scheduled";
+import { fetchCpiBoard } from "../cpi/client";
+import { fetchRatePath } from "../rate-path/client";
+import type { HeadlessPaneContext } from "../../../types/headless";
+import { zonedDateKey } from "../../../utils/zoned-date-time";
+import { listingFateNotes, listingFateReport, loadListingFate, MovedSymbolError } from "../../../tickers/listing-fate";
 import { startTickerChangeLookup } from "../../../tickers/ticker-changes";
 
 const METHODOLOGY = "docs/research-data.md#implied-volatility-history";
@@ -17,23 +26,33 @@ export const ivHistoryHeadless: HeadlessPaneDefinition<"bundle"> = {
   usListingsOnly: "Implied volatility history",
   freshness: { status: "not-a-feed", basis: "daily implied volatility", cadence: "daily", observedKey: "date", oldest: null },
   describe: (args) => `HIVG ${args.symbols[0] ?? ""}`,
-  discovery: { aliases: ["HIVG"], screenshotReadiness: "live-dom", dataRequirements: ["Cloud stored implied volatility", "Daily price history"],
+  discovery: { aliases: ["HIVG"], suggestFor: IMPLIED_VOL_WORDS, screenshotReadiness: "live-dom", dataRequirements: ["Cloud stored implied volatility", "Daily price history"],
     limitations: ["History starts February 2024 (daily option trade closes).", "Rank and percentile use trade-close readings only.",
       "IV1Y needs long-dated trades: it can start later, has gaps, and ranks from 60 prior sessions.",
       "skew25d (put-call) and rr25d (call-put) come from the daily quote captures and are blank before the first one."] },
   options: [
     { key: "lookback", type: "enum", values: [{ value: "1Y" }, { value: "2Y" }, { value: "ALL" }], defaultValue: "1Y", description: "Visible history" },
     { key: "hvWindow", type: "enum", values: HV_WINDOWS.map((window) => ({ value: String(window) })), defaultValue: "20", description: "Realized volatility window in sessions" },
+    { key: "event", type: "enum", aliases: ["release"], values: MACRO_EVENT_KINDS.map((value) => ({ value, ...value === "jobs" ? { aliases: ["nfp", "payrolls"] } : {} })),
+      description: "One row per release of this kind whose session at --offset has closed (the next scheduled FOMC or CPI included), in place of the daily history",
+      example: "--event fomc --offset -6", shot: { reportOnly: "lists the readings around past release days" } },
+    { key: "offset", type: "integer", minimum: -60, maximum: 60, defaultValue: 0,
+      description: "Sessions from each release with --event: 0 is the first session on or after the release day, -6 the sixth session before that",
+      example: "--event cpi --offset -1", shot: { reportOnly: "picks the session read around each release" } },
   ],
   async load(args, ctx) {
+    const event = typeof args.options.event === "string" && args.options.event ? args.options.event as MacroEventKind : null;
+    const offset = Number(args.options.offset) || 0;
+    if (!event && offset !== 0) throw new Error("--offset counts sessions from a release day: add --event fomc, cpi or jobs.");
     const instrument = await resolveHeadlessInstrument(ctx, args.symbols[0]!);
     // What became of the symbol, as `quote` reads it, looked up beside the figures: FB's are the fund listed
     // there now, TWTR stopped trading, and HFC, which became DINO, has none of its own.
     const changes = startTickerChangeLookup(ctx.marketData, instrument.symbol, instrument.exchange);
     const quote = ctx.marketData.getQuote(instrument.symbol, instrument.exchange ?? "").catch(() => null);
-    const [payload, prices] = await Promise.all([
+    const [payload, prices, releases] = await Promise.all([
       loadIvHistory(instrument.symbol, { signal: ctx.signal }, ctx.apiClient),
       loadRealizedVolatilityHistory({ instrument, signal: ctx.signal }, createRealizedVolatilityDependencies(ctx.marketData)),
+      event ? eventReleases(event, ctx) : null,
     ]);
     const fate = await loadListingFate(instrument, ctx.marketData, { quote, changes });
     if (fate.moved) throw new MovedSymbolError(fate.moved);
@@ -57,11 +76,47 @@ export const ivHistoryHeadless: HeadlessPaneDefinition<"bundle"> = {
     const skewColumns = [{ key: "skew25d", header: skewHeader("skew25d", "put-call"), format: points },
       { key: "rr25d", header: skewHeader("rr25d", "call-put"), format: points }];
     const served = model.iv30.length > 0 || prices.history.length > 0;
-    const fateNotes = listingFateNotes(fate, { served });
     // With nothing served, the fate is why: no "not a ticker" or missing-history errors beside it.
-    const errors = !served && fateNotes.length > 0 ? []
-      : [prices.error, ...model.warnings].filter((value): value is string => !!value);
+    const { notes: fateNotes, errors } = listingFateReport(fate, { served },
+      [prices.error, ...model.warnings].filter((value): value is string => !!value));
     const notes = [...fateNotes, ...[model.oneYearNote, model.skewNote].filter((note): note is string => !!note)];
+    if (event && releases) {
+      const lookback = String(args.options.lookback) as IvLookback;
+      const label = MACRO_EVENT_LABELS[event];
+      const offsets = releaseOffsetRows(model, releases.list.releases, event, offset, {
+        lookback, readThrough: payload.coverage?.backfilledThrough ?? null });
+      const plural = (count: number, one: string, many: string) => count === 1 ? one : many;
+      const eventNotes = [
+        offsets.beforeLookback > 0
+          ? `${offsets.beforeLookback} earlier ${label} ${plural(offsets.beforeLookback, "release is", "releases are")} outside the ${lookback} lookback; --lookback ALL adds ${plural(offsets.beforeLookback, "it", "them")}.` : null,
+        // Said once the lookback says nothing: the history's own start is then where the rows stop.
+        offsets.beforeHistory > 0 && offsets.beforeLookback === 0
+          ? `${offsets.beforeHistory} earlier ${label} ${plural(offsets.beforeHistory, "release predates", "releases predate")} the IV history, which starts ${offsets.historyStart}.` : null,
+        offsets.pending.length > 0
+          ? `Left out ${label} ${offsets.pending.join(", ")}: no closing reading yet for ${plural(offsets.pending.length, "its session", "their sessions")} at --offset ${offset}.` : null,
+        releases.upcomingNote,
+        staleMacroReleasesNotice(releases.list),
+      ].filter((note): note is string => !!note);
+      const eventColumns = [{ key: "releaseDate", header: "Release date" }, { key: "session", header: "Session" },
+        ...historyColumns.slice(1), ...skewColumns];
+      return {
+        sections: [{
+          title: `${label} releases, ${offsetText(offset)}`,
+          // The export names the release and the offset on every row, so files of several offsets or releases join.
+          columns: [{ key: "release", header: "Release" }, eventColumns[0]!, { key: "offset", header: "Offset (sessions)" }, ...eventColumns.slice(1)],
+          rows: offsets.rows.map(({ date, ...row }) => ({ ...row, session: date, release: label })),
+          textColumns: offsets.rows.some((row) => row.skew25d != null) ? eventColumns : eventColumns.slice(0, -skewColumns.length),
+        }],
+        complete: payload.status === "ready" && errors.length === 0,
+        unavailableSymbols: offsets.rows.some((row) => row.iv30 != null) ? [] : [instrument.symbol], errors,
+        ...(notes.length + eventNotes.length > 0 ? { notes: [...notes, ...eventNotes] } : {}),
+        // Dated by the history read, not by the newest release's session: an old release is no stale reading.
+        ...(model.asOf ? { freshness: { asOf: model.asOf } } : {}),
+        metadata: { status: payload.status, coverage: payload.coverage, event, offset, releasesThrough: releases.list.coveredThrough,
+          nextRelease: releases.upcoming,
+          releaseSource: MACRO_RELEASE_SOURCES[event], unit: "decimal annualized volatility", methodology: METHODOLOGY },
+      };
+    }
     return {
       sections: [
         { title: "Statistics", columns: [
@@ -153,3 +208,32 @@ export const ivScreenHeadless: HeadlessPaneDefinition<"bundle"> = {
     };
   },
 };
+
+/**
+ * The releases of `event` HIVG reads around: the days MDAY studies (the list
+ * the app ships with, extended by Gloom Cloud's), and the next one scheduled,
+ * from the CPI board's release calendar or the FOMC meetings WIRP prices, as
+ * scheduled alerts read them. Payrolls have no schedule to read.
+ */
+async function eventReleases(event: MacroEventKind, ctx: HeadlessPaneContext): Promise<{
+  list: MacroReleaseList; upcoming: string | null; upcomingNote: string | null;
+}> {
+  const label = MACRO_EVENT_LABELS[event];
+  const [published, next] = await Promise.all([
+    loadMacroReleases({}, () => ctx.apiClient.getCloudMacroReleaseDays()),
+    event === "jobs" ? null : lookupScheduledDates([{ kind: "macro", event }], {
+      earnings: async () => [],
+      cpi: () => fetchCpiBoard(ctx.apiClient),
+      fomc: async () => (await fetchRatePath(ctx.apiClient)).meetings,
+    }, zonedDateKey(Date.now(), "America/New_York")).then((dates) => dates.get(`macro:${event}`) ?? { date: null }),
+  ]);
+  const upcoming = next && "date" in next ? next.date : null;
+  const listed = upcoming != null && published.releases.some((release) => release.kind === event && release.date === upcoming);
+  const releases: MacroRelease[] = upcoming && !listed ? [...published.releases, { kind: event, date: upcoming }] : published.releases;
+  return {
+    list: { ...published, releases },
+    upcoming,
+    upcomingNote: next == null ? `The next ${label} release is not scheduled here, so it has no row yet.`
+      : "error" in next ? `The next ${label} date could not be loaded (${next.error}), so it has no row.` : null,
+  };
+}

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

@@ -183,11 +183,11 @@ export const jobsHeadless: HeadlessPaneDefinition<"bundle"> = {
     const symbol = args.symbols[0];
     if (symbol) {
       const state = await fetchJobs(symbol, { force: true, client: ctx.apiClient as JobsCloudClient });
-      if (state.kind === "denied") throw explainRefusal(new ApiRequestError(state.message, state.status), jobsLockNote, { symbol });
+      if (state.kind === "denied") throw await explainRefusal(new ApiRequestError(state.message, state.status), jobsLockNote, { symbol, context: ctx });
       return companyBundle(symbol, state, limit);
     }
     const payload = await fetchJobsMovers(ctx.apiClient as JobsCloudClient)
-      .catch((error: unknown) => { throw explainRefusal(error, jobsLockNote, { symbol: null }); });
+      .catch(async (error: unknown) => { throw await explainRefusal(error, jobsLockNote, { symbol: null }); });
     const rows = buildMoverRows(payload.movers).slice(0, Math.max(limit, 15)).map((row) => ({
       ticker: row.ticker,
       company: row.company,

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

@@ -1,16 +1,27 @@
 import type { PaneLock } from "../../../types/plugin";
-import { proLockNote } from "../shared/pro-lock-note";
+import type { HiringPayload } from "../../../api-client/hiring";
+import { fetchAttention } from "../company-attention/client";
+import { proLockNote, type FreeRoute } from "../shared/pro-lock-note";
+
+/** HIRE's preview, for a company whose careers system it reads: Coffee Holding (JVA) is mapped but uncovered. */
+const HIRE_ROUTE: FreeRoute = {
+  text: (ticker, company) => `gloomberb fn HIRE ${ticker} previews ${company}'s hiring with its latest roles, without the full history.`,
+  answers: async (symbol, context) => {
+    const data = await fetchAttention("hiring", symbol, { limit: 1 }, context.apiClient, context.signal) as HiringPayload;
+    return data.evidence.length + data.series.length + data.functions.length > 0;
+  },
+};
 
 /**
  * JOBS is Pro whole. HIRE reads the same careers systems and needs no
  * account: a company's latest roles, without the full history.
  */
-export function jobsLockNote(lock: PaneLock): string {
+export function jobsLockNote(lock: PaneLock): Promise<string> {
   return proLockNote(lock, {
     token: "JOBS",
     argument: "optional",
     does: "it reads each company's careers system into open roles, hiring pace and the mix by function and country",
     shows: "it",
-    free: (ticker, company) => `gloomberb fn HIRE ${ticker} previews ${company}'s hiring with its latest roles, without the full history.`,
+    free: [HIRE_ROUTE],
   });
 }

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

@@ -39,7 +39,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
   const balances = resource.data;
   const gas = balances?.gas ?? null;
   const [storedTab, setTab] = usePluginPaneState<string>("commodity", "oil");
-  const tab: BalanceCommodity = gas && storedTab === "gas" ? "gas" : "oil";
+  const tab: BalanceCommodity = storedTab === "gas" ? "gas" : "oil";
   const board = tab === "gas" ? gas : balances?.oil ?? null;
   const rows = board?.rows ?? EMPTY_ROWS;
   const [selectedId, setSelectedId] = usePluginPaneState<string | null>("selected", null);
@@ -54,7 +54,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
   const selectTab = useCallback((value: string) => {
     setTab(value === "gas" ? "gas" : "oil");
   }, [setTab]);
-  const { strip: tabs, rows: tabRows } = usePaneTabs(gas ? {
+  const { strip: tabs, rows: tabRows } = usePaneTabs({
     tabs: TABS,
     activeValue: tab,
     onSelect: selectTab,
@@ -62,7 +62,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
     compact: true,
     variant: "underline",
     queryBarWidth: width,
-  } : null);
+  });
   const info = useMemo(
     () => (resource.error || !board ? [] : [{ id: "month", parts: [{ text: formatBalanceMonth(board.month) }] }]),
     [board, resource.error],
@@ -139,7 +139,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
         onRootKeyDown={onRootKeyDown}
         renderCell={renderCell}
         selectedTextOverridesCellColor
-        emptyStateTitle="No balances for this month."
+        emptyStateTitle={board ? "No balances for this month." : tab === "gas" ? "Gas balances unavailable." : "Oil balances unavailable."}
       />
     </Box>
   );

package/src/plugins/builtin/market-halts/model.ts

@@ -180,14 +180,33 @@ const DAY_MS = 86_400_000;
 /** Unresolved halts move out of the recent views at 30 elapsed days. */
 const LONG_TERM_MS = 30 * DAY_MS;
 
-export function formatHaltAge(record: HaltRecord, now: number): string {
+/** How long a halt has kept trading stopped: to the trade resumption, or to now while it lasts. Quotes resuming do not end it. */
+function haltDurationMs(record: HaltRecord, now: number): number {
   const end = record.tradeResumeAt == null ? now : Math.min(now, record.tradeResumeAt);
-  const elapsed = Math.max(0, end - record.haltedAt);
+  return Math.max(0, end - record.haltedAt);
+}
+
+/** How long since the halt began, whether or not trading has resumed. */
+function haltAgeMs(record: HaltRecord, now: number): number {
+  return Math.max(0, now - record.haltedAt);
+}
+
+function formatElapsed(elapsed: number): string {
   if (elapsed >= DAY_MS) return `${Math.floor(elapsed / DAY_MS)}d`;
   if (elapsed >= 3_600_000) return `${Math.floor(elapsed / 3_600_000)}h`;
   return `${Math.floor(elapsed / 60_000)}m`;
 }
 
+/** HALTED FOR: RAIL halted 16:40 and resumed 17:15 was halted for 35m, read at any later time. */
+export function formatHaltDuration(record: HaltRecord, now: number): string {
+  return formatElapsed(haltDurationMs(record, now));
+}
+
+/** AGE: RAIL's 16:40 halt is 1h old at 17:45, though it lasted 35m. */
+export function formatHaltAge(record: HaltRecord, now: number): string {
+  return formatElapsed(haltAgeMs(record, now));
+}
+
 export const HALT_FILTERS: ReadonlyArray<{ label: string; value: HaltFilter }> = [
   { label: "All", value: "all" },
   { label: "Active", value: "active" },
@@ -221,6 +240,7 @@ export type HaltColumnId =
   | "halted"
   | "quote"
   | "trade"
+  | "duration"
   | "status";
 
 export type HaltColumn = DataTableColumn & { id: HaltColumnId };
@@ -235,6 +255,7 @@ export const HALT_SORT_COLUMN_IDS: readonly HaltColumnId[] = [
   "halted",
   "quote",
   "trade",
+  "duration",
   "status",
 ];
 
@@ -262,16 +283,18 @@ const HALT_COLUMNS: readonly HaltColumn[] = [
   { id: "halted", label: "HALT ET", width: 9, align: "left" },
   { id: "quote", label: "QUOTE ET", width: 11, align: "left" },
   { id: "trade", label: "TRADE ET", width: 11, align: "left" },
+  { id: "duration", label: "HALTED FOR", width: 12, align: "right" },
   { id: "status", label: "STATUS", width: 8, align: "left" },
 ];
 
 /**
  * What a narrow pane gives up first, so STATUS never scrolls out of view. MKT
  * is only the venue, STATUS already reads QUOTE once quoting resumes, and
- * REASON spells out CODE. Trade resumption and halt time give way only in
- * the narrowest panes; symbol, reason, halt date, age and status always stay.
+ * REASON spells out CODE. Trade resumption, halt time and then the age, which
+ * the date and halt time also give, go only in the narrowest panes; symbol,
+ * reason, halt date, how long it was halted for and status always stay.
  */
-const NARROW_DROP_ORDER: readonly HaltColumnId[] = ["market", "quote", "code", "company", "trade", "halted"];
+const NARROW_DROP_ORDER: readonly HaltColumnId[] = ["market", "quote", "code", "company", "trade", "halted", "age"];
 
 export function buildHaltColumns(width: number): HaltColumn[] {
   const columns = fitChartTableColumns(HALT_COLUMNS, width, NARROW_DROP_ORDER);
@@ -304,7 +327,9 @@ function haltSortValue(columnId: HaltColumnId, record: HaltRecord, now: number):
     case "halted":
       return record.haltedAt;
     case "age":
-      return Math.max(0, Math.min(now, record.tradeResumeAt ?? now) - record.haltedAt);
+      return haltAgeMs(record, now);
+    case "duration":
+      return haltDurationMs(record, now);
     case "quote":
       return record.quoteResumeAt;
     case "trade":

package/src/plugins/builtin/market-halts/pane.tsx

@@ -29,6 +29,7 @@ import {
   formatEtResumption,
   formatEtTime,
   formatHaltAge,
+  formatHaltDuration,
   haltStatusColor,
   haltStatusLabel,
   nextHaltFilter,
@@ -179,6 +180,8 @@ export function MarketHaltsPane({ focused, width, height }: PaneProps) {
           text: formatEtResumption(row.tradeResumeAt, row.haltedAt),
           color: selectedColor ?? colors.textDim,
         };
+      case "duration":
+        return { text: formatHaltDuration(row, now), color: selectedColor ?? colors.textMuted };
       case "status": {
         const rowStatus = resolveHaltStatus(row, now);
         return {

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

@@ -5,6 +5,7 @@ import type {
   CloudSessionMoversSide,
 } from "../../../api-client/market-movers";
 import type { DataProvider } from "../../../types/data-provider";
+import { logFailure } from "../../../utils/log-failure";
 import {
   CATEGORY_MAP,
   moverRegularSession,
@@ -63,7 +64,7 @@ async function hydrateTrending(
   if (provider.getQuotesBatch) {
     const results = await provider.getQuotesBatch(
       symbols.map((symbol) => ({ symbol, exchange: "" })),
-    ).catch(() => []);
+    ).catch(logFailure("market-movers", "Trending quote batch failed", []));
     for (const result of results) {
       if (result.quote) bySymbol.set(result.target.symbol, screenerQuoteFromQuote(result.target.symbol, result.quote));
     }
@@ -72,8 +73,8 @@ async function hydrateTrending(
       try {
         const quote = await provider.getQuote(symbol, "");
         bySymbol.set(symbol, screenerQuoteFromQuote(symbol, quote));
-      } catch {
-        // Missing quotes are omitted from a ranked list.
+      } catch (error) {
+        logFailure("market-movers", "Trending quote failed")(error);
       }
     }));
   }

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

@@ -1,6 +1,7 @@
 import type { ScreenerQuote } from "../../../api-client/market-discovery";
 export type { ScreenerQuote } from "../../../api-client/market-discovery";
 import { resolveCurrencyUnit } from "../../../utils/currency-units";
+import { logFailure } from "../../../utils/log-failure";
 import type { PluginPersistence } from "../../../types/plugin";
 import { apiClient } from "../../../api-client";
 import type {
@@ -324,7 +325,7 @@ async function bestEffortMarketMetadata(
   let timeout: ReturnType<typeof setTimeout> | undefined;
   try {
     return await Promise.race([
-      request.then((result) => result.data).catch(() => []),
+      request.then((result) => result.data).catch(logFailure("market-movers", "Market metadata failed", [])),
       new Promise<ScreenerQuote[]>((resolve) => {
         timeout = setTimeout(() => resolve([]), waitMs);
       }),
@@ -392,8 +393,8 @@ export async function fetchPreferredMarketMovers(
         stale: response.stale === true || response.data.stale === true,
       };
     }
-  } catch {
-    // The public backend snapshot remains available when live rankings fail.
+  } catch (error) {
+    logFailure("market-movers", "Live rankings failed")(error);
   }
 
   const fallback = await marketMetadata;

package/src/plugins/builtin/market-valuation/pane.tsx

@@ -1,5 +1,6 @@
 import { useMemo } from "react";
 import {
+  DELAYED_SEGMENT,
   PaneStatusBody, type DataTableCell,
   type DataTableColumn,
   type PaneFooterSegment
@@ -140,7 +141,7 @@ export function MarketValuationPane({ focused, width, height }: PaneProps) {
     if (!selectedView) return [];
     const info: PaneFooterSegment[] = [
       { id: "as-of", parts: [{ text: `as of ${selectedView.asOf}`, tone: "muted" }] },
-      ...(width >= 80 ? [{ id: "delayed", parts: [{ text: "delayed", tone: "muted" as const }] }] : []),
+      ...(width >= 80 ? [DELAYED_SEGMENT] : []),
     ];
     if (selectedView.observationStale) {
       info.push({ id: "stale", parts: [{ text: "STALE", tone: "warning", bold: true }] });

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

@@ -1,6 +1,6 @@
 import { useCallback, useMemo, useRef, useState } from "react";
 import type { FundChange, FundMember } from "../../../api-client/members";
-import { DataTableStackView, DataTableView, DetailScrollBody, EmptyState, KeyValueRow, PaneFooterScope, PaneStatusBody, Prose, QueryBar, StatGrid,
+import { delayedFooterSegment, DataTableStackView, DataTableView, DetailScrollBody, EmptyState, KeyValueRow, PaneFooterScope, PaneStatusBody, Prose, QueryBar, StatGrid,
   isSectionedItemRow, renderSectionedRowHeader, useExternalLinkFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, useQueryBarSearch,
   type DataTableCell, type DataTableColumn, type PaneFooterSegment, type SectionedRow } from "../../../components";
 import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
@@ -49,8 +49,13 @@ function Holdings({ fund, tab, width, height, focused, active }: ViewProps & { t
     return [
       { id: "coverage", parts: [{ text: coverageText(data.aggregate, width < 60), tone: partial ? "warning" : "muted" }] },
       // A capture's status line says the quotes' date and delay too; it does not say returns are unavailable.
-      { id: "quote-date", title: `${date ?? "Quote date unavailable"} · 15m delayed · holdings ${data.asOf}`, quoteStatus: !data.quotesUnavailable,
-        parts: [{ text: data.quotesUnavailable ? "returns unavailable" : width < 60 && dates.length === 1 ? `${date!.slice(5)} delayed` : `${date ? `${date} · ` : ""}15m delayed`, tone: "muted" }] },
+      ...(data.quotesUnavailable
+        ? [{ id: "quote-date", title: `${date ?? "Quote date unavailable"} · 15m delayed · holdings ${data.asOf}`, parts: [{ text: "returns unavailable", tone: "muted" as const }] }]
+        : [
+          delayedFooterSegment({ id: "quote-delay", detail: "15m delayed", delay: "15m", quoteStatus: true }),
+          ...(date ? [{ id: "quote-date", title: `${date} · 15m delayed · holdings ${data.asOf}`, quoteStatus: true,
+            parts: [{ text: width < 60 && dates.length === 1 ? date.slice(5) : date, tone: "muted" as const }] }] : []),
+        ]),
       ...(width >= 60 ? [{ id: "holdings-date", asOf: true, parts: [{ text: `holdings ${data.asOf}`, tone: "muted" as const }] }] : []),
     ];
   }, [data, width]);

package/src/plugins/builtin/news/wire/feed-config.ts

@@ -9,11 +9,13 @@ const USER_FEEDS_KEY = "feeds";
 const DISABLED_DEFAULT_FEED_IDS_KEY = "disabledDefaultFeedIds";
 
 const DEFAULT_FEED_IDS = new Set(DEFAULT_FEEDS.map((feed) => feed.id));
+const UNREADABLE_SETTINGS = "News feed settings could not be read. Saved settings were kept.";
 
 export interface NewsFeedSettings {
   userFeeds: RssFeedConfig[];
   disabledDefaultFeedIds: string[];
   needsMigration: boolean;
+  error?: string;
 }
 
 export interface UserNewsFeedInput {
@@ -25,15 +27,15 @@ export interface UserNewsFeedInput {
   enabled?: boolean;
 }
 
-function parseJsonArray(value: unknown): unknown[] {
+function parseJsonArray(value: unknown): unknown[] | null {
   if (Array.isArray(value)) return value;
-  if (typeof value !== "string" || !value.trim()) return [];
+  if (typeof value !== "string") return [];
   try {
     const parsed = JSON.parse(value);
     return Array.isArray(parsed) ? parsed : [];
   } catch (error) {
     logFailure("news.feed-config", "Read stored news feed settings failed")(error);
-    return [];
+    return null;
   }
 }
 
@@ -134,14 +136,20 @@ function sameIdList(raw: unknown, normalized: string[]): boolean {
 }
 
 export function loadNewsFeedSettings(configState: PluginConfigState): NewsFeedSettings {
-  const rawUserFeeds = configState.get<unknown>(USER_FEEDS_KEY);
+  return parseNewsFeedSettings(configState.get(USER_FEEDS_KEY), configState.get(DISABLED_DEFAULT_FEED_IDS_KEY));
+}
+
+export function parseNewsFeedSettings(rawUserFeeds: unknown, rawDisabledIds: unknown): NewsFeedSettings {
   const userFeedValues = parseJsonArray(rawUserFeeds);
-  const userFeeds = userFeedValues
+  const userFeeds = (userFeedValues ?? [])
     .map(normalizeUserFeed)
     .filter((feed): feed is RssFeedConfig => !!feed);
 
-  const rawDisabledIds = configState.get<unknown>(DISABLED_DEFAULT_FEED_IDS_KEY);
-  const disabledDefaultFeedIds = normalizeDisabledDefaultFeedIds(parseJsonArray(rawDisabledIds));
+  const disabledIdValues = parseJsonArray(rawDisabledIds);
+  const disabledDefaultFeedIds = normalizeDisabledDefaultFeedIds(disabledIdValues ?? []);
+  if (userFeedValues === null || disabledIdValues === null) {
+    return { userFeeds, disabledDefaultFeedIds, needsMigration: false, error: UNREADABLE_SETTINGS };
+  }
 
   const needsMigration = (rawUserFeeds !== null && !sameUserFeeds(rawUserFeeds, userFeeds))
     || (rawDisabledIds !== null && !sameIdList(rawDisabledIds, disabledDefaultFeedIds));
@@ -149,15 +157,24 @@ export function loadNewsFeedSettings(configState: PluginConfigState): NewsFeedSe
   return { userFeeds, disabledDefaultFeedIds, needsMigration };
 }
 
+function requireReadableSettings(configState: PluginConfigState): NewsFeedSettings {
+  const settings = loadNewsFeedSettings(configState);
+  if (settings.error) throw new Error(settings.error);
+  return settings;
+}
+
 export async function saveNewsFeedSettings(
   configState: PluginConfigState,
   settings: Pick<NewsFeedSettings, "userFeeds" | "disabledDefaultFeedIds">,
 ): Promise<void> {
+  requireReadableSettings(configState);
   await configState.set(USER_FEEDS_KEY, settings.userFeeds);
+  requireReadableSettings(configState);
   await configState.set(DISABLED_DEFAULT_FEED_IDS_KEY, settings.disabledDefaultFeedIds);
 }
 
-export function getEnabledNewsFeeds(settings: Pick<NewsFeedSettings, "userFeeds" | "disabledDefaultFeedIds">): RssFeedConfig[] {
+export function getEnabledNewsFeeds(settings: Pick<NewsFeedSettings, "userFeeds" | "disabledDefaultFeedIds" | "error">): RssFeedConfig[] {
+  if (settings.error) return [];
   const disabled = new Set(settings.disabledDefaultFeedIds);
   return [
     ...DEFAULT_FEEDS.filter((feed) => feed.enabled && !disabled.has(feed.id)),
@@ -169,7 +186,7 @@ export async function addUserNewsFeed(
   configState: PluginConfigState,
   input: UserNewsFeedInput,
 ): Promise<RssFeedConfig> {
-  const settings = loadNewsFeedSettings(configState);
+  const settings = requireReadableSettings(configState);
   const feed = createUserFeed(input);
   const nextUserFeeds = [
     ...settings.userFeeds.filter((entry) => entry.id !== feed.id),
@@ -187,7 +204,7 @@ export async function updateUserNewsFeed(
   feedId: string,
   patch: Partial<UserNewsFeedInput>,
 ): Promise<RssFeedConfig | null> {
-  const settings = loadNewsFeedSettings(configState);
+  const settings = requireReadableSettings(configState);
   const existing = settings.userFeeds.find((feed) => feed.id === feedId);
   if (!existing) return null;
   const nextFeed = createUserFeed({
@@ -206,7 +223,7 @@ export async function removeUserNewsFeed(
   configState: PluginConfigState,
   feedId: string,
 ): Promise<boolean> {
-  const settings = loadNewsFeedSettings(configState);
+  const settings = requireReadableSettings(configState);
   const nextUserFeeds = settings.userFeeds.filter((feed) => feed.id !== feedId);
   if (nextUserFeeds.length === settings.userFeeds.length) return false;
   await saveNewsFeedSettings(configState, {
@@ -222,7 +239,7 @@ export async function setDefaultNewsFeedEnabled(
   enabled: boolean,
 ): Promise<boolean> {
   if (!DEFAULT_FEED_IDS.has(feedId)) return false;
-  const settings = loadNewsFeedSettings(configState);
+  const settings = requireReadableSettings(configState);
   const disabled = new Set(settings.disabledDefaultFeedIds);
   if (enabled) disabled.delete(feedId);
   else disabled.add(feedId);

package/src/plugins/builtin/news/wire/index.tsx

@@ -26,6 +26,7 @@ import { createRssNewsCapability } from "./rss/source";
 import { rssCliCommand } from "./rss/cli";
 import { newsFeedHeadless } from "../headless";
 import type { PaneDef } from "../../../../types/plugin";
+import { logFailure } from "../../../../utils/log-failure";
 
 const TopPane = createNewsPresetPane({
   paneKey: "top:curated",
@@ -195,11 +196,15 @@ export const newsWireModule: PluginModule = {
   setup(ctx) {
     const initialSettings = loadNewsFeedSettings(ctx.configState);
     if (initialSettings.needsMigration) {
-      void saveNewsFeedSettings(ctx.configState, initialSettings);
+      void saveNewsFeedSettings(ctx.configState, initialSettings)
+        .catch(logFailure("news.feed-config", "Migrate news feed settings failed"));
     }
 
     const source = createRssNewsCapability(
-      () => getEnabledNewsFeeds(loadNewsFeedSettings(ctx.configState)),
+      () => {
+        const settings = loadNewsFeedSettings(ctx.configState);
+        return { feeds: getEnabledNewsFeeds(settings), error: settings.error };
+      },
       { persistence: ctx.persistence },
     );
     ctx.registerCapability(source);

package/src/plugins/builtin/news/wire/news/preset-pane.tsx

@@ -1,9 +1,9 @@
-import { useCallback } from "react";
+import { useCallback, useMemo } from "react";
 import { Box } from "../../../../../ui";
 import type { NewsArticle, NewsQuery } from "../../../../../news/types";
 import { useLoadNewsStory, useNewsArticles, useNewsTableLoadMore } from "../../../../../news/hooks";
 import type { PaneProps } from "../../../../../types/plugin";
-import { useDebouncedPluginPaneState, usePluginPaneState } from "../../../../runtime";
+import { useDebouncedPluginPaneState, usePluginConfigState, usePluginPaneState } from "../../../../runtime";
 import { PaneStatusBody, QueryBar, type QueryBarSearch } from "../../../../../components";
 import { NewsDetailView, useNewsArticleDetail } from "./detail-view";
 import {
@@ -18,6 +18,7 @@ import { newsListEmptyCopy } from "../filter-articles";
 import { NEWS_LIST_SEARCH_PLACEHOLDER, useNewsListSearch, useNewsListSearchHint } from "./list-search";
 import { newsMutesApplyToFeed, useNewsMuteFilter } from "../mutes";
 import { usePopOutNewsArticle } from "./pop-out";
+import { parseNewsFeedSettings } from "../feed-config";
 
 interface NewsArticleStackOptions {
   /** Prefix of every key the pane persists, and of its footer registration. */
@@ -146,6 +147,13 @@ export function NewsPresetPane({
   emptyStateTitle,
   emptyStateHint,
 }: PaneProps & NewsPresetPaneConfig) {
+  const [storedFeeds] = usePluginConfigState<unknown>("feeds", null);
+  const [storedDisabledIds] = usePluginConfigState<unknown>("disabledDefaultFeedIds", null);
+  // The first query can finish before RSS registers, and desktop queries may
+  // use Cloud alone. A settings failure must remain visible in either case.
+  const settingsError = useMemo(() => query.feed === "latest"
+    ? parseNewsFeedSettings(storedFeeds, storedDisabledIds).error
+    : undefined, [query.feed, storedFeeds, storedDisabledIds]);
   const newsState = useNewsArticles(query);
   const persisted = usePersistedNewsArticles(`${paneKey}:articles`, newsState.articles);
   const articles = useNewsMuteFilter(persisted, newsMutesApplyToFeed(query.feed));
@@ -154,7 +162,7 @@ export function NewsPresetPane({
   // body rather than a definitive empty wire.
   const loading = newsState.phase === "loading"
     || (newsState.phase === "refreshing" && persisted.length === 0);
-  const error = newsState.error;
+  const error = settingsError ?? newsState.error;
   const { search, searchQuery, ...stack } = useNewsArticleStack({
     paneKey,
     articles,

package/src/plugins/builtin/news/wire/rss/cli.ts

@@ -26,8 +26,9 @@ export const rssCliCommand: CliCommandDef = {
       authority: 50,
       enabled: true,
     }]);
-    const articles = await capability.provider.fetchNews({ feed: "latest", limit: ctx.cliOptions.limit ?? 20 });
-    ctx.printResult({ data: articles.map((article) => ({
+    const page = await capability.provider.fetchNewsPage!({ feed: "latest", limit: ctx.cliOptions.limit ?? 20 });
+    if (page.error) ctx.fail(page.error);
+    ctx.printResult({ data: page.articles.map((article) => ({
       title: article.title,
       source: article.source,
       publishedAt: article.publishedAt.toISOString(),