gloomberb 0.18.2 → 0.18.4

package/src/plugins/builtin/buildout/pane/index.tsx

@@ -17,6 +17,7 @@ import type { PaneProps } from "../../../../types/plugin";
 import { useOptionalDialog, type PromptContext } from "../../../../ui/dialog";
 import { isPlainKey } from "../../../../utils/keyboard";
 import { logFailure } from "../../../../utils/log-failure";
+import { useRowNotes } from "../../../../components/ui/row-notes";
 import { nextHeaderSort, type SortPreference } from "../../../../utils/sort-values";
 import { usePaneStateValue } from "../../../../state/app/context";
 import { useInlineTickerQuoteFact, useInlineTickers } from "../../../../state/hooks/inline-tickers";
@@ -63,6 +64,15 @@ import { useBuildoutDataRuntime } from "../data-runtime";
 
 const BUILDOUT_UPGRADE_URL = "https://thebuildout.ai/pricing";
 
+/** A star a row's company or site did not take: said by its star cell, in full at the top of its detail. */
+const favoriteNoteKey = (row: BuildoutRow) => favoriteKey(row) ?? rowKey(row);
+
+function favoriteFailureText(row: BuildoutRow, starring: boolean, error: unknown): string {
+  // The service may answer with a page of its own; its first line says enough.
+  const reason = error instanceof Error ? error.message.trim().split("\n")[0]!.slice(0, 240) : "";
+  return `Could not ${starring ? "star" : "unstar"} ${rowTitle(row)}${reason ? `: ${reason}` : "."}`;
+}
+
 
 const NO_TICKER_TEXTS: string[] = [];
 
@@ -86,6 +96,7 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
   const dialog = useOptionalDialog();
   const tableScrollRef = useRef<ScrollBoxRenderable | null>(null);
   const favoriteBusyKeysRef = useRef<Set<string>>(new Set());
+  const clearFavoriteNotesRef = useRef<() => void>(() => {});
   const [activeTab, setActiveTab] = usePaneStateValue<BuildoutTabId>("activeTab", "companies");
   const [selectedList, setSelectedList] = useState<BuildoutList | null>(null);
   const [selectedIndex, setSelectedIndex] = useState(0);
@@ -94,14 +105,13 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
   const [upgradeBusy, setUpgradeBusy] = useState(false);
   const [upgradeMessage, setUpgradeMessage] = useState<string | null>(null);
   const [favoriteBusyKey, setFavoriteBusyKey] = useState<string | null>(null);
-  const [favoriteMessage, setFavoriteMessage] = useState<string | null>(null);
 
   const handleBeforeLoad = useCallback(() => {
     favoriteBusyKeysRef.current.clear();
     setDetailRow(null);
     setSelectedList(null);
     setUpgradeMessage(null);
-    setFavoriteMessage(null);
+    clearFavoriteNotesRef.current();
     setFavoriteBusyKey(null);
   }, []);
   const {
@@ -136,7 +146,6 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
   useEffect(() => {
     setSelectedIndex(0);
     setDetailRow(null);
-    setFavoriteMessage(null);
     const nextColumn: BuildoutColumnId | null = activeTab === "companies"
       ? selectedList ? "marketCap" : null
       : activeTab === "sites" ? "capture" : "time";
@@ -147,6 +156,10 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
     () => sortRows(activeRows(state, activeTab, selectedList), sort.columnId, sort.direction),
     [activeTab, selectedList, sort, state],
   );
+  // Until the next star on that row, or a reload.
+  const favoriteNotes = useRowNotes<BuildoutRow, string>(rows, { key: favoriteNoteKey });
+  const { setNote: setFavoriteNote, noteFor: favoriteNoteFor } = favoriteNotes;
+  clearFavoriteNotesRef.current = favoriteNotes.clearNotes;
   const columns = useMemo(() => columnsForTab(activeTab, selectedList, canFavorite), [activeTab, canFavorite, selectedList]);
   const selectedRow = rows[selectedIndex] ?? rows[0] ?? null;
   // The table's cells carry their own badges; this catalog only serves the open
@@ -226,7 +239,6 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
     setSelectedIndex(0);
     setDetailRow(null);
     setUpgradeMessage(null);
-    setFavoriteMessage(null);
     setSort({ columnId: "marketCap", direction: "desc" });
     resetCompanies();
   }, [resetCompanies]);
@@ -236,7 +248,6 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
     setSelectedIndex(0);
     setDetailRow(null);
     setUpgradeMessage(null);
-    setFavoriteMessage(null);
     setSort({ columnId: null, direction: "asc" });
   }, []);
 
@@ -265,20 +276,21 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
     const next = !previous;
     favoriteBusyKeysRef.current.add(key);
     setFavoriteBusyKey(key);
-    setFavoriteMessage(null);
+    setFavoriteNote(key, null);
     updateFavorite(key, next);
 
     try {
       const response = await buildoutApi<{ starred?: boolean }>(path, favoriteToken, { method: "POST" });
       updateFavorite(key, typeof response.starred === "boolean" ? response.starred : next);
-    } catch {
+    } catch (error) {
+      // The star goes back, and the row says it did not take.
       updateFavorite(key, previous);
-      setFavoriteMessage("favorite failed");
+      setFavoriteNote(key, favoriteFailureText(row, next, error));
     } finally {
       favoriteBusyKeysRef.current.delete(key);
       setFavoriteBusyKey((current) => current === key ? null : current);
     }
-  }, [favoriteToken, updateFavorite]);
+  }, [favoriteToken, setFavoriteNote, updateFavorite]);
 
   const toggleFavoriteRow = useCallback((row: BuildoutRow | null) => {
     if (!canFavorite || !row || !favoriteKey(row)) return false;
@@ -314,14 +326,13 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
 
   usePaneFooter("buildout", () => ({
     info: updateBuildoutFooterInfo(state, activeTab, selectedList, {
-      favoriteMessage,
       upgradeMessage,
       partialList,
       onUpgrade: startUpgrade,
       quoteFreshness: detailQuoteFreshness,
     }),
     hints: footerHints,
-  }), [activeTab, detailQuoteFreshness, favoriteMessage, footerHints, partialList, selectedList, startUpgrade, state, upgradeMessage]);
+  }), [activeTab, detailQuoteFreshness, footerHints, partialList, selectedList, startUpgrade, state, upgradeMessage]);
 
   const activePage = state.status === "ready" ? activeBuildoutPage(state, activeTab, selectedList) : null;
   const loadMoreActiveRows = useTableLoadMore(
@@ -367,8 +378,9 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
     rowState: { selected: boolean },
   ) => renderBuildoutCell(row, column, rowState, {
     favoriteBusyKey,
+    favoriteFailed: favoriteNoteFor(row) !== null,
     toggleFavorite,
-  }), [favoriteBusyKey, toggleFavorite]);
+  }), [favoriteBusyKey, favoriteNoteFor, toggleFavorite]);
 
   const { strip: tabStrip, rows: tabRows } = usePaneTabs({
     tabs,
@@ -379,12 +391,15 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
     variant: "bare",
   });
 
-  if (state.status === "loading") {
-    return <PaneStatusBody loading subject={BUILDOUT_NAME} width={width} height={height} />;
-  }
-
-  if (state.status === "error") {
-    return <PaneStatusBody error={state.message} subject={BUILDOUT_NAME} width={width} height={height} retry={{ onRetry: refresh }} />;
+  // The strip stays over the first load and a failed one, as over every tab's own.
+  if (state.status === "loading" || state.status === "error") {
+    return (
+      <Box flexDirection="column" width={width} height={height} overflow="hidden">
+        {tabStrip && <Box height={1}>{tabStrip}</Box>}
+        {state.status === "loading" ? <PaneStatusBody loading subject={BUILDOUT_NAME} />
+          : <PaneStatusBody error={state.message} subject={BUILDOUT_NAME} retry={{ onRetry: refresh }} />}
+      </Box>
+    );
   }
 
   const listOpen = activeTab === "companies" && !!selectedList;
@@ -398,6 +413,7 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
       detailContent={(
         <BuildoutDetail
           row={detailRow}
+          note={detailRow ? favoriteNoteFor(detailRow) : null}
           width={width}
           height={height}
           catalog={tickerCatalog}

package/src/plugins/builtin/buildout/pane/status.tsx

@@ -26,7 +26,6 @@ export function updateBuildoutFooterInfo(
   activeTab: BuildoutTabId,
   selectedList: BuildoutList | null,
   messages: {
-    favoriteMessage: string | null;
     upgradeMessage: string | null;
     partialList: boolean;
     onUpgrade: () => void;
@@ -66,9 +65,6 @@ export function updateBuildoutFooterInfo(
   if (page?.error) {
     info.push({ id: "page-error", parts: [{ text: page.error, tone: "negative" }] });
   }
-  if (messages.favoriteMessage) {
-    info.push({ id: "favorite-error", parts: [{ text: messages.favoriteMessage, tone: "negative" }] });
-  }
   if (messages.upgradeMessage) {
     info.push({ id: "upgrade-error", parts: [{ text: messages.upgradeMessage, tone: "negative" }] });
   }

package/src/plugins/builtin/builtin-plugin-meta.ts

@@ -107,7 +107,7 @@ export const cryptoPluginMeta = {
   stateId: "market-overview",
   name: "Crypto & Perps",
   version: "1.0.0",
-  description: "Top crypto assets by market cap, and perpetual funding, open interest and premiums.",
+  description: "Top crypto assets by market cap, daily spot bitcoin and ether ETF flows, and perpetual funding, open interest and premiums.",
   toggleable: true,
 };
 

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

@@ -23,6 +23,6 @@ export function validateCatalystDetail(payload: CatalystDetail, id?: string): Ca
 export const fetchCatalysts = async (query: CatalystFilters, client: Pick<typeof apiClient, "getCloudCatalysts"> = apiClient, signal?: AbortSignal) => validateCatalysts(await client.getCloudCatalysts(query, signal));
 export const fetchCatalystDetail = async (id: string, client: Pick<typeof apiClient, "getCloudCatalystEvent"> = apiClient, signal?: AbortSignal, query: { offset?: number; limit?: number } = {}) => validateCatalystDetail(await client.getCloudCatalystEvent(id, signal, query), id);
 export const loadCatalysts = (query: CatalystFilters, accessKey: string, force = false, signal?: AbortSignal) =>
-  loadCloudResource(catalystCache, `${accessKey}:${JSON.stringify(query)}`, () => fetchCatalysts(query, apiClient, signal), { force, validate: validateCatalysts });
+  loadCloudResource(catalystCache, `${accessKey}:${JSON.stringify(query)}`, () => fetchCatalysts(query, apiClient, signal), { force, validate: validateCatalysts, signal });
 export const loadCatalystDetail = (id: string, accessKey: string, force = false, offset = 0, signal?: AbortSignal) =>
-  loadCloudResource(catalystDetailCache, `${accessKey}:${id}:${offset}`, () => fetchCatalystDetail(id, apiClient, signal, { offset, limit: 100 }), { force, validate: (payload) => validateCatalystDetail(payload, id) });
+  loadCloudResource(catalystDetailCache, `${accessKey}:${id}:${offset}`, () => fetchCatalystDetail(id, apiClient, signal, { offset, limit: 100 }), { force, validate: (payload) => validateCatalystDetail(payload, id), signal });

package/src/plugins/builtin/catalysts/detail.tsx

@@ -6,7 +6,7 @@ import { usePluginPaneState } from "../../../public/react";
 import { useThemeColors } from "../../../theme/theme-context";
 import { Box, ScrollBox, Text, useRendererHost, useUiCapabilities, type ScrollBoxRenderable } from "../../../ui";
 import { UpgradeLabel } from "../shared/locked-rows";
-import { catalystAgency, catalystChangeText, catalystDate, catalystDateBasis, catalystFacts, catalystLabel } from "./model";
+import { CATALYST_DATE_WITHHELD, catalystAgency, catalystChangeText, catalystDate, catalystDateBasis, catalystDateWithheld, catalystFacts, catalystLabel } from "./model";
 import { humanLabel } from "../shared/research-cells";
 import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
 import { loadCatalystDetail } from "./client";
@@ -23,7 +23,8 @@ function Evidence({ event, width, height }: { event: CatalystEvent; width: numbe
     <KeyValueRow label="Status" value={humanLabel(event.status)} detail={`Revision ${event.revision}`} labelWidth={18} />
     <KeyValueRow label="Announced" value={catalystDate(event, "announced")} labelWidth={18} />
     {event.effectiveDate ? <KeyValueRow label={catalystDateBasis(event, "effective")} value={catalystDate(event, "effective")} labelWidth={18} /> : null}
-    {event.deadlineDate ? <KeyValueRow label={catalystDateBasis(event, "deadline")} value={catalystDate(event, "deadline")} labelWidth={18} /> : null}
+    {event.deadlineDate ? <KeyValueRow label={catalystDateBasis(event, "deadline")} value={catalystDate(event, "deadline")} labelWidth={18} />
+      : catalystDateWithheld(event) ? <KeyValueRow label={catalystLabel("deadline")} value={CATALYST_DATE_WITHHELD} labelWidth={18} /> : null}
     <KeyValueRow label="Observed (UTC)" value={catalystDate(event, "observed")} labelWidth={18} />
     <KeyValueRow label="Confidence" value={`${Math.round(event.confidence * 100)}%`} labelWidth={18} />
     {facts.map((fact) => <KeyValueRow key={fact.label} label={fact.label} value={fact.value} labelWidth={18} />)}

package/src/plugins/builtin/catalysts/index.tsx

@@ -23,7 +23,7 @@ export const catalystsModule: PluginModule = {
       instruments: ["equity", "fund"], tableExport: true, headless: litigationHeadless },
   ],
   paneTemplates: [
-    { id: "catalysts-pane", paneId: "catalysts", label: "Catalysts", description: "Pro regulatory, clinical, legal and trade-policy calendar with source evidence and revision history.", keywords: ["catalysts", "calendar", "FDA", "clinical", "regulatory", "deadlines", "antitrust", "sanctions"],
+    { id: "catalysts-pane", paneId: "catalysts", label: "Catalysts", description: "Pro regulatory, clinical, legal and trade-policy calendar with source evidence and revision history.", keywords: ["catalysts", "calendar", "FDA", "clinical", "regulatory", "deadlines", "antitrust", "sanctions", "PDUFA", "FDA decision", "approval", "approvals"],
       shortcut: { prefix: "CATL", argKind: "ticker", argPlaceholder: "ticker", argOptional: true, openWithoutArg: true }, headless: catalystsHeadless,
       createInstance: (_context, options) => { const symbol = (options?.symbol ?? options?.arg ?? "").trim().toUpperCase(); const event = options?.values?.event; const open = event && /^[a-zA-Z0-9:_-]{1,160}$/.test(event) ? event : undefined; return { title: symbol ? `CATL ${symbol}` : "Catalysts", placement: "floating", ...(symbol ? { binding: { kind: "fixed" as const, symbol } } : {}), settings: { symbol, ...(open ? { open } : {}) } }; } },
     { ...createTickerSurfacePaneTemplate({ id: "litigation-pane", paneId: "litigation", label: "Litigation", description: "Pro company litigation, enforcement and antitrust dockets with dated source evidence.", keywords: ["litigation", "legal", "docket", "court", "enforcement", "antitrust"], shortcut: "LITI" }), headless: litigationHeadless },

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

@@ -1,5 +1,5 @@
 import type { CatalystEvent, CatalystFilters, CatalystResponse, CatalystType } from "../../../api-client/catalysts";
-import type { DataTableColumn } from "../../../components";
+import type { DataTableColumn, TableSection } from "../../../components";
 import { publicTickerKey } from "../../../utils/exchanges";
 import { humanLabel, type StateTone } from "../shared/research-cells";
 
@@ -13,8 +13,17 @@ export const catalystSymbol = (event: CatalystEvent): string | null => {
   return party?.ticker ? publicTickerKey(party.ticker, party.exchange ?? undefined) : null;
 };
 export const catalystTickers = (event: CatalystEvent) => [...new Set(event.parties.filter((p) => p.ticker).map((p) => publicTickerKey(p.ticker!, p.exchange ?? undefined)))].join(", ");
+/**
+ * A source named the event but withheld its date (a company's PDUFA target
+ * without the day). The filing's date is when it was said, so the row has no
+ * date of its own; only the announcement and observation dates stand.
+ */
+export const catalystDateWithheld = (event: Pick<CatalystEvent, "metadata">, field: CatalystFilters["dateField"] = "any") =>
+  event.metadata?.dateWithheld === true && field !== "announced" && field !== "observed";
+export const CATALYST_DATE_WITHHELD = "Date not disclosed";
 export const catalystDate = (event: CatalystEvent, field: CatalystFilters["dateField"] = "any"): string => {
   if (field === "observed") return event.observedAt.slice(0, 16).replace("T", " ");
+  if (catalystDateWithheld(event, field)) return "--";
   const key = field === "announced" || field === "effective" || field === "deadline" ? field
     : event.deadlineDate ? "deadline" : event.effectiveDate ? "effective" : "announced";
   const value = event[`${key}Date`];
@@ -35,15 +44,22 @@ function fitColumns(columns: FitColumn[], width: number): DataTableColumn[] {
   let kept = columns;
   const drop = (id: string) => { if (tableNeed(kept) > width) kept = kept.filter((column) => column.id !== id); };
   for (const id of ["country", "agency", "type"]) drop(id);
+  // A long date basis gives up only the cells the table lacks before every column shrinks.
+  const over = tableNeed(kept) - width;
+  if (over > 0) kept = kept.map((column) => column.id === "basis" ? { ...column, width: Math.max(column.min ?? column.width, column.width - over) } : column);
   if (tableNeed(kept) > width) kept = kept.map((column) => ({ ...column, width: column.min ?? column.width }));
   for (const id of ["basis", "parties"]) drop(id);
   return kept.map(({ min: _min, ...column }) => column);
 }
 
-export function catalystColumns(width: number, changes: boolean, litigation: boolean): DataTableColumn[] {
+/** The date basis column as wide as its longest label on screen ("Primary completion (actual)"), never narrower than its heading. */
+export const catalystBasisWidth = (events: readonly CatalystEvent[], field: CatalystFilters["dateField"]) =>
+  Math.min(27, events.reduce((widest, event) => Math.max(widest, catalystDateBasis(event, field).length), 10));
+
+export function catalystColumns(width: number, changes: boolean, litigation: boolean, basisWidth = 10): DataTableColumn[] {
   return fitColumns([
     { id: "date", label: changes ? "Observed (UTC)" : "Date", width: changes ? 16 : 10, align: "left" },
-    ...(!changes ? [{ id: "basis", label: "Date basis", width: 10, align: "left" as const }] : []),
+    ...(!changes ? [{ id: "basis", label: "Date basis", width: basisWidth, min: 10, align: "left" as const }] : []),
     ...(!litigation ? [{ id: "ticker", label: "Ticker", width: width < 110 ? 12 : 14, min: 10, align: "left" as const }] : []),
     // The entity the event is about, which the title alone buries.
     { id: "parties", label: "Parties", width: Math.max(16, Math.min(28, Math.round(width * 0.16))), min: 14, align: "left" },
@@ -151,9 +167,30 @@ export function catalystChangeText(change: CatalystEvent["changes"][number]): st
   return `${field}: ${changeValue(change.before)} → ${changeValue(change.after)}`;
 }
 const MONTHS = ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+/**
+ * Rows under their section headings in the order the server sends them:
+ * upcoming dates first, then past ones. A heading starts wherever the label
+ * changes, so a month today falls in heads its upcoming days and again its
+ * past days, after the later months, never pulling a past day ahead of them.
+ */
+export function catalystSections(rows: readonly CatalystEvent[], field: CatalystFilters["dateField"], changes: boolean): TableSection<CatalystEvent>[] {
+  const sections: TableSection<CatalystEvent>[] = [];
+  const seen = new Map<string, number>();
+  for (const event of rows) {
+    const label = catalystSection(event, field, changes);
+    const last = sections.at(-1);
+    if (last?.label === label) { last.items.push(event); continue; }
+    const repeat = seen.get(label) ?? 0;
+    seen.set(label, repeat + 1);
+    sections.push({ label, key: repeat ? `${label}:${repeat}` : label, items: [event] });
+  }
+  return sections;
+}
+
 /** The calendar groups by the month of the date it shows; the change feed by the day a change was observed. */
 export function catalystSection(event: CatalystEvent, field: CatalystFilters["dateField"], changes: boolean): string {
   if (changes) return event.observedAt.slice(0, 10);
+  if (catalystDateWithheld(event, field)) return CATALYST_DATE_WITHHELD;
   const date = catalystDate(event, field);
   if (date === "--") return "Undated";
   return /^\d{4}-\d{2}/.test(date) ? `${MONTHS[Number(date.slice(5, 7)) - 1]} ${date.slice(0, 4)}` : date;
@@ -206,10 +243,18 @@ export function catalystEmptyTitle(data: Pick<CatalystResponse, "coverage"> | nu
   return `No cases linked to ${query.symbol}.${courts.length ? ` ${courts.join(" and ")} are not collected yet, so only agency and regulator actions show.` : ""}`;
 }
 
+/** "Primary completion (est.)" or "(actual)", as the registry types the date; never a bare "Completion". */
+function primaryCompletionLabel(event: Pick<CatalystEvent, "metadata">): string {
+  const completion = event.metadata?.primaryCompletion;
+  const type = completion && typeof completion === "object" && "type" in completion ? String(completion.type).toUpperCase() : "";
+  return type === "ESTIMATED" ? "Primary completion (est.)" : type === "ACTUAL" ? "Primary completion (actual)" : "Primary completion";
+}
+
 export function catalystDateBasis(event: CatalystEvent, field: CatalystFilters["dateField"] = "any"): string {
+  if (catalystDateWithheld(event, field)) return CATALYST_DATE_WITHHELD;
   const basis = field === "any" || !field ? event.deadlineDate ? "deadline" : event.effectiveDate ? "effective" : event.announcedDate ? "announced" : "undated" : field;
   const meaning = String(event.metadata?.[`${basis}Meaning`] ?? event.metadata?.[`${basis}DateMeaning`] ?? "");
-  if (/primary completion/i.test(meaning)) return "Completion";
+  if (/primary completion/i.test(meaning)) return primaryCompletionLabel(event);
   if (/comment/i.test(meaning)) return "Comments";
   if (/meeting/i.test(meaning)) return "Meeting";
   return catalystLabel(basis);

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

@@ -12,6 +12,7 @@ import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { PaneProps } from "../../../types/plugin";
 import { Box, Text, useUiCapabilities, type ScrollBoxRenderable } from "../../../ui";
+import { withCountryFlag } from "../../../components/ui/country-flag";
 import { SignInWall } from "../cloud/auth-actions";
 import { CLOUD_PLAN_KEY, useCloudUpgradeAction } from "../shared/cloud-upgrade";
 import { useOpenDescription } from "../shared/open-description";
@@ -20,7 +21,7 @@ import { listingCell, toneColor } from "../shared/research-cells";
 import { isCloudSessionRequired, useResearchCloudSession } from "../shared/research-cloud-session";
 import { loadCatalystDetail, loadCatalysts, validateCatalysts } from "./client";
 import { CatalystEventDetail } from "./detail";
-import { catalystAgency, catalystCell, catalystColumns, catalystEmptyTitle, catalystLabel, catalystQuery, catalystSection, catalystStatusTone, catalystSymbol, catalystTab, catalystTypeTone, CATALYST_TABS } from "./model";
+import { catalystAgency, catalystBasisWidth, catalystCell, catalystColumns, catalystEmptyTitle, catalystLabel, catalystQuery, catalystSections, catalystStatusTone, catalystSymbol, catalystTab, catalystTypeTone, CATALYST_TABS } from "./model";
 
 type Row = SectionedRow<CatalystEvent> | { kind: "locked"; key: string };
 const rowKey = (row: Row) => row.key;
@@ -81,12 +82,7 @@ export function CatalystView({ width, height, focused, symbol, litigation = fals
   const lockedRows = Math.min(3, data?.access?.lockedRows ?? 0);
   // Grouped by month on the calendar and by day in the change feed, in the order the server sends them.
   const items = useMemo<Row[]>(() => {
-    const groups = new Map<string, CatalystEvent[]>();
-    for (const event of rows) {
-      const label = catalystSection(event, query.dateField, tab === "changes");
-      groups.set(label, [...(groups.get(label) ?? []), event]);
-    }
-    return [...buildSectionedRows([...groups].map(([label, events]) => ({ label, items: events })), (event) => event.id),
+    return [...buildSectionedRows(catalystSections(rows, query.dateField, tab === "changes"), (event) => event.id),
       ...Array.from({ length: lockedRows }, (_, index): Row => ({ kind: "locked", key: `locked:${index}` }))];
   }, [rows, query.dateField, tab, lockedRows]);
   const listedOpen = rows.find((event) => event.id === openId) ?? null;
@@ -124,7 +120,7 @@ export function CatalystView({ width, height, focused, symbol, litigation = fals
     ...(tab === "calendar" ? [{ id: "upcoming", kind: "toggle" as const, label: "Upcoming", value: filters.upcoming === true, onChange: (value: boolean) => changeFilter("upcoming", value) },
       { id: "date", label: "Date", value: String(filters.dateField ?? "any"), options: [{ value: "any", label: "Any date" }, { value: "announced", label: "Announced" }, { value: "effective", label: "Effective" }, { value: "deadline", label: "Deadlines" }], onChange: (value: string) => changeFilter("dateField", value) }] : []),
   ]} />;
-  const columns = catalystColumns(width, tab === "changes", litigation);
+  const columns = catalystColumns(width, tab === "changes", litigation, catalystBasisWidth(rows, query.dateField));
   const renderCell = (row: Row, column: (typeof columns)[number], _index: number, state: { selected: boolean }): DataTableCell => {
     if (row.kind === "locked") {
       if (!desktop && column.id === "title" && row.key === "locked:0") return { text: "Upgrade for every catalyst and its history", content: <UpgradeLabel text="Upgrade for every catalyst and its history" onPress={openUpgrade} role="catalysts-upgrade" />, onMouseDown: openUpgrade };
@@ -141,16 +137,19 @@ export function CatalystView({ width, height, focused, symbol, litigation = fals
     }
     if (column.id === "parties") return { text, color: text === "--" ? colors.textMuted : colors.textBright };
     if (column.id === "type") return { text, color: toneColor(catalystTypeTone(event.type), colors) };
+    // The column has room for the flag beside a code.
+    if (column.id === "country") return withCountryFlag({ text, color: colors.textDim }, text, desktop);
     if (column.id === "status") return { text, color: tab === "changes" ? colors.text : toneColor(catalystStatusTone(event.status), colors) };
     return { text, color: column.id === "title" || column.id === "date" ? colors.text : colors.textDim };
   };
   if (isCloudSessionRequired(error?.message)) return <SignInWall placement="catalysts-signin" action="view catalysts" needsVerification={session.needsVerification} />;
   return <Box width={width} height={height} flexDirection="column">
     {strip}
-    <PaneStatusBody loading={!openId && !data && resource.loading} error={!openId && (!data || denied) ? error?.message : null} subject={litigation ? "company litigation" : "catalysts"}>
-      <PageStackView focused={focused} detailOpen={!!openId} onBack={() => setOpenId("")} detailTitle={open?.title ?? "Catalyst"}
+    <PageStackView focused={focused} detailOpen={!!openId} onBack={() => setOpenId("")} detailTitle={open?.title ?? "Catalyst"}
         detailContent={open ? <CatalystEventDetail key={open.id} event={open} accessKey={accessKey} snapshot={detailSnapshots[open.id]} width={width} height={Math.max(3, height - 1)} focused={focused} initialTab={detailTab} openUpgrade={openUpgrade} /> : <PaneStatusBody loading={externalOpen.loading} error={externalOpen.error} subject="catalyst event"><EmptyState title="Event unavailable." /></PaneStatusBody>}
         rootContent={<DataTableView<Row> rootWidth={width} rootHeight={Math.max(3, height - tabRows)} rootBefore={queryBar} focused={focused && !openId && !searchActive && !dateFieldActive}
+          // A tab or filter change loads under the query bar, which stays.
+          status={{ loading: !data && resource.loading, error: !data || denied ? error?.message : null, subject: litigation ? "company litigation" : "catalysts" }}
           items={items} sortColumnId={null} sortDirection="asc" columns={columns} getItemKey={rowKey}
           isNavigable={isSelectable} renderSectionHeader={(row) => row.kind === "locked" ? null : renderSectionedRowHeader(row)}
           selection={{ kind: "id", selectedId: selected?.id ?? null, getId: rowKey, onChange: (id) => { if (!id.startsWith("locked:")) setSelectedId(id); } }}
@@ -160,6 +159,5 @@ export function CatalystView({ width, height, focused, symbol, litigation = fals
           emptyStateTitle={catalystEmptyTitle(data, query, tab === "changes")}
           bodyAfter={lockedRows && desktop ? <LockedOverlay rows={lockedRows} text="Upgrade for every catalyst and its history" onPress={openUpgrade} role="catalysts-upgrade" /> : undefined} />}
       />
-    </PaneStatusBody>
   </Box>;
 }

package/src/plugins/builtin/central-bank-rates/client.ts

@@ -49,6 +49,11 @@ export function validateCentralBankRates(payload: CentralBankRatesPayload): Cent
     if (row.nextMeeting && row.nextMeeting.kind !== undefined && row.nextMeeting.kind !== "decision" && row.nextMeeting.kind !== "fixing") delete row.nextMeeting.kind;
     if (row.nextMeetingStatus !== undefined && !["scheduled", "not-published", "not-verified", "no-policy-rate"].includes(row.nextMeetingStatus)) delete row.nextMeetingStatus;
     if (row.seriesNotes !== undefined && !strings(row.seriesNotes)) delete row.seriesNotes;
+    // A decision date is a citation: one that is not a real day on or before the change it is for, from an https page, is left out.
+    const decision = row.lastDecision;
+    if (decision !== undefined && decision !== null && (typeof decision !== "object" || decision.date == null || !dateOrNull(decision.date)
+      || row.lastChangeDate == null || decision.date > row.lastChangeDate || decision.sourceUrl == null || !urlOrNull(decision.sourceUrl)
+      || !Number.isFinite(Date.parse(decision.verifiedAt)) || decision.kind !== undefined && decision.kind !== "decision" && decision.kind !== "fixing")) delete row.lastDecision;
   }
   return payload;
 }

package/src/plugins/builtin/central-bank-rates/headless.ts

@@ -1,10 +1,17 @@
 import type { HeadlessPaneColumn, HeadlessPaneDefinition } from "../../../types/plugin";
+import { CENTRAL_BANKS, centralBankNames } from "../../../utils/central-banks";
 import { fetchCentralBankRates } from "./client";
-import { hasNoPolicyRate, policyExportRow, policyNextMeetingText, policyNotices } from "./model";
+import {
+  hasNoPolicyRate, policyExportRow, policyLastDecisionText, policyNextMeetingText, policyNotices, policyRate, policyUnlistedNote,
+} from "./model";
 
-/** The citation block every export row carries, headed as a journalist's spreadsheet names it. */
+/**
+ * The citation block every export row carries, headed as a journalist's
+ * spreadsheet names it. `source` and `as_of` are the row's own, so the
+ * export's fixed columns of the same names are not added again.
+ */
 const CITATION_FIELDS = [
-  "central_bank", "source", "series_id", "source_url", "as_of",
+  "central_bank", "source", "series_id", "source_url", "as_of", "last_decision",
   "next_meeting", "next_meeting_kind", "next_meeting_source_url", "next_meeting_verified_at", "citation",
 ];
 
@@ -16,8 +23,22 @@ const BOARD_COLUMNS: HeadlessPaneColumn[] = [
   { key: "asOf", header: "As of", shrink: false }, { key: "status", header: "Status", stackPriority: 2 }, { key: "instrument", header: "Instrument", stackPriority: 3 },
 ];
 
+const percentCell = (value: unknown) => policyRate(typeof value === "number" ? value : null);
+
+/**
+ * The board's columns as CSV and NDJSON write them: the rate as a number (a
+ * target range's midpoint, which the board ranks and charts) with the range's
+ * bounds beside it, where the text draws "3.75-4.00%".
+ */
+const EXPORT_BOARD_COLUMNS: HeadlessPaneColumn[] = BOARD_COLUMNS.flatMap((column): HeadlessPaneColumn[] => column.key !== "valueText" ? [column] : [
+  { key: "value", header: "Rate", align: "right", format: percentCell },
+  { key: "rangeLower", header: "Range lower", align: "right", format: percentCell },
+  { key: "rangeUpper", header: "Range upper", align: "right", format: percentCell },
+]);
+
 export const centralBankRatesHeadless: HeadlessPaneDefinition<"bundle"> = {
-  discovery: { aliases: ["CBR", "CBRT"], dataRequirements: ["Gloom Cloud central-bank-rates endpoint"],
+  // A bank's name or short form typed as a function (`fn ECB`, `fn BOJ`) points here, unless a function owns the word (FOMC is WIRP).
+  discovery: { aliases: ["CBR", "CBRT"], suggestFor: CENTRAL_BANKS.flatMap(centralBankNames), dataRequirements: ["Gloom Cloud central-bank-rates endpoint"],
     limitations: ["Published policy observations with individual dates.", "Policy instruments differ.",
       "Next meetings come from each bank's published calendar; SAMA publishes none, and China's date is the monthly LPR fixing."] },
   shape: "bundle",
@@ -33,19 +54,24 @@ export const centralBankRatesHeadless: HeadlessPaneDefinition<"bundle"> = {
     // A row says "stale" in its status, not in a `stale` flag: hand the report its rows' staleness so its status line and a capture count them.
     const observations = data.rows.filter((row) => row.status !== "unavailable")
       .map((row) => ({ asOf: row.asOf, stale: row.status === "stale" }));
-    const exported = data.rows.map(policyExportRow);
+    // Members with no policy rate stay off the board, as the pane keeps them, so every output counts the same rows; a note says why.
+    const listed = data.rows.filter((row) => !hasNoPolicyRate(row));
+    const exported = listed.map(policyExportRow);
     // A caveat on most rows ("Change date is the first observed new level...") is said once for the report.
     const shared = [...new Set(exported.flatMap((row) => row.notes))]
       .filter((note) => exported.filter((row) => row.notes.includes(note)).length > 1);
     const rows = exported.map((row) => ({ ...row, notes: row.notes.filter((note) => !shared.includes(note)) }));
-    return { complete, freshness: { observations }, ...(shared.length ? { notes: shared } : {}), sections: [{ title: "Policy rates",
-      columns: [...BOARD_COLUMNS, ...CITATION_FIELDS.map((key): HeadlessPaneColumn => ({ key, header: key, literalHeader: true }))],
+    const notes = [...shared, ...data.rows.filter(hasNoPolicyRate).map(policyUnlistedNote)];
+    return { complete, freshness: { observations }, ...(notes.length ? { notes } : {}), sections: [{ title: "Policy rates",
+      columns: [...EXPORT_BOARD_COLUMNS, ...CITATION_FIELDS.map((key): HeadlessPaneColumn => ({ key, header: key, literalHeader: true })),
+        { key: "notes", header: "notes", literalHeader: true, format: (value) => Array.isArray(value) ? value.join(" ") : "" }],
       rows,
-      // The text keeps the board's table; each row's bank, next meeting and citation go under it.
+      // The text keeps the board's table; each row's bank, last and next decision, citation and own caveats go under it.
       textColumns: [...BOARD_COLUMNS, { key: "detail", header: "Detail", underRow: true }],
       textRows: rows.map((row, index) => {
-        const source = data.rows[index]!;
-        return { ...row, detail: `${row.central_bank ?? "No central bank"} · ${policyNextMeetingText(source)}\n${row.citation}` };
+        const source = listed[index]!;
+        const detail = [`${row.central_bank ?? "No central bank"} · ${policyLastDecisionText(source)}${policyNextMeetingText(source)}`, row.citation];
+        return { ...row, detail: [...detail, ...(row.notes.length ? [row.notes.join(" ")] : [])].join("\n") };
       }),
     }], errors, unavailableSymbols: data.rows.filter((row) => row.status === "unavailable" && !hasNoPolicyRate(row)).map((row) => row.id),
     // A year of daily history per row is most of the payload, so JSON carries it only on request.

package/src/plugins/builtin/central-bank-rates/model.ts

@@ -20,7 +20,9 @@ export function policyHistory(row: CentralBankRow) {
 }
 export interface PolicyBoardRow extends MarketBoardRow { observation: CentralBankRow }
 export function policyBoardRow(row: CentralBankRow): PolicyBoardRow {
-  return { id: row.id, label: row.label, labelDetail: row.instrument, value: row.value, valueText: policyLevel(row),
+  // One country's bank leads with its flag; the euro area's with the EU's.
+  const country = row.countryCodes.length === 1 ? row.countryCodes[0]! : row.label;
+  return { id: row.id, label: row.label, labelDetail: row.instrument, country, value: row.value, valueText: policyLevel(row),
     change: row.changeBps, changeText: policyChange(row), changeAsOf: row.lastChangeDate,
     percentile: row.percentile.value, asOf: row.asOf, status: row.status, observation: row,
     history: policyHistory(row).flatMap((point) => point.value == null ? [] : [{ date: new Date(point.date), close: point.value }]) };
@@ -97,27 +99,50 @@ export function policyNextMeetingText(row: CentralBankRow): string {
 }
 
 /**
- * What an export says about one row, history aside: the board's figures and
- * a citation block, `central_bank` to `citation`, named as CSV heads them.
- * Notes keep the caveats on the latest rate; the BIS series definition goes
- * with the history (`--history`).
+ * `last decision 2026-09-18 · ` (or `last LPR fixing`) before the next
+ * meeting on a row's detail line; nothing when the server gives no date.
+ */
+export function policyLastDecisionText(row: CentralBankRow): string {
+  const decision = row.lastDecision;
+  if (!decision) return "";
+  return `last ${decision.kind === "fixing" ? "LPR fixing" : "decision"} ${decision.date} · `;
+}
+
+/**
+ * What an export says about one row, history aside: the board's figures, a
+ * target range's bounds as numbers (`rangeLower`, `rangeUpper`; the rate is
+ * its midpoint) and a citation block, `central_bank` to `citation`, named as
+ * CSV heads them. `last_decision` is the bank's latest kept decision on or
+ * before the observed change. Notes keep the caveats on the latest rate; the
+ * BIS series definition goes with the history (`--history`).
  */
 export function policyExportRow(row: CentralBankRow) {
   const board = policyBoardRow({ ...row, history: [] });
   const meeting = policyNextMeeting(row);
   return {
     id: row.id, label: row.label, instrument: row.instrument, central_bank: row.centralBank,
-    value: row.value, unit: row.unit, range: row.range, valueText: board.valueText,
-    changeBps: row.changeBps, changeText: board.changeText, lastChangeDate: row.lastChangeDate,
+    value: row.value, unit: row.unit, range: row.range, rangeLower: row.range?.lower ?? null, rangeUpper: row.range?.upper ?? null,
+    valueText: board.valueText, changeBps: row.changeBps, changeText: board.changeText, lastChangeDate: row.lastChangeDate,
     previousValue: row.previousValue, percentileValue: row.percentile.value,
     asOf: row.asOf, lagDays: row.lagDays, status: row.status, unavailableReason: row.unavailableReason,
     source: policySource(row), series_id: row.sourceSeriesIds.join(", ") || null, source_url: policySeriesUrls(row).join(" ") || null,
-    as_of: row.asOf, next_meeting: meeting.text, next_meeting_kind: meeting.kind,
+    as_of: row.asOf, last_decision: row.lastDecision?.date ?? null, next_meeting: meeting.text, next_meeting_kind: meeting.kind,
     next_meeting_source_url: meeting.sourceUrl, next_meeting_verified_at: meeting.verifiedAt,
     citation: policyCitation(row), notes: row.notes.filter((note) => !row.seriesNotes?.includes(note)),
   };
 }
 
+/**
+ * Why a member with no policy rate is left off the board and its exports:
+ * `Argentina is not listed: no adopted policy rate (BIS series D.AR, https://...).`
+ */
+export function policyUnlistedNote(row: CentralBankRow): string {
+  const source = policySource(row);
+  const urls = policySeriesUrls(row);
+  const series = source && row.sourceSeriesIds.length > 0 ? `${source} series ${row.sourceSeriesIds.join(" and ")}${urls.length ? `, ${urls.join(" ")}` : ""}` : null;
+  return `${row.label} is not listed: ${row.instrument.toLowerCase()}${series ? ` (${series})` : ""}.`;
+}
+
 /** Who a chart of the row's series cites: `FRED series ECBDFR`, published by the European Central Bank. */
 export function policySeriesAttribution(row: CentralBankRow): { source: string; publisher?: string } | null {
   const source = policySource(row);

package/src/plugins/builtin/changelog/index.tsx

@@ -286,6 +286,7 @@ export const changelogModule: PluginModule = {
       name: "Changelog",
       icon: "L",
       component: ChangelogPane,
+      reportFreshness: { status: "not-a-feed", basis: "release notes" },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 100, height: 32 },

package/src/plugins/builtin/chart-composer/catalog-inventory.ts

@@ -59,6 +59,7 @@ const GROUP_ORDER = [
   "Inflation",
   "FX",
   "Energy",
+  "Commodities",
   "Volatility",
   "Sentiment",
   "Positioning",

package/src/plugins/builtin/chart-composer/chart-spec-edit.ts

@@ -416,6 +416,7 @@ export function panelsForSeries(series: readonly ChartSeriesSpec[], studies: rea
     ...(id === "rsi" || id === "macd" || id === "atr" ? { label: id.toUpperCase(), height: 0.28 } : {}),
     ...(id === "formula" ? { label: "Formula", height: 0.3 } : {}),
     ...(id === "correlation" ? { label: "Correlation", height: 0.3 } : {}),
+    ...(id === "decay" ? { label: "Decay", height: 0.3 } : {}),
     ...(id === "realized-vol" ? { label: "Realized Volatility", height: 0.3 } : {}),
     ...(/^panel-\d+$/.test(id) ? { label: `Panel ${id.slice("panel-".length)}`, height: 0.35 } : {}),
   }));
@@ -495,7 +496,7 @@ export function reconcilePanels(
 ): ChartPanelSpec[] {
   const defaults = panelsForSeries(series, studies);
   const requiredIds = new Set(defaults.map((panel) => panel.id));
-  const managedStudyPanelIds = new Set(["volume", "rsi", "macd", "atr", "formula", "correlation", "realized-vol"]);
+  const managedStudyPanelIds = new Set(["volume", "rsi", "macd", "atr", "formula", "correlation", "realized-vol", "decay"]);
   const retained = existing.filter((panel) => (
     requiredIds.has(panel.id) || !managedStudyPanelIds.has(panel.id)
   ));