@gloom-sh/terminal 0.19.1 → 0.19.3

package/src/plugins/builtin/futures/use-front-returns.ts

@@ -4,6 +4,9 @@ import type { DataProvider } from "../../../types/data-provider";
 import { isNoSourceAnswer } from "../../../sources/provider-errors";
 import type { PricePoint } from "../../../types/financials";
 import { logFailure } from "../../../utils/log-failure";
+import { coalescedBump } from "./coalesced-bump";
+import { readsInBatches } from "../../../market-data/batched-reads";
+import { boardReadGate } from "./board-reads";
 import type { BoardQuoteMap } from "../shared/use-quote-board";
 import type { FuturesContract } from "../../../market-data/futures-board";
 import {
@@ -33,8 +36,6 @@ const HISTORY_TTL_MS = 30 * 60_000;
  * once a minute, not once a tick.
  */
 const HISTORY_RETRY_MS = 60_000;
-/** Forty-odd contracts open at once; a few requests at a time keep the board's quotes first. */
-const HISTORY_CONCURRENCY = 4;
 
 /**
  * Null when the source has no history for the contract (delisted, unknown),
@@ -43,16 +44,17 @@ const HISTORY_CONCURRENCY = 4;
  */
 const historyCache = createTtlCache<readonly PricePoint[] | null>({ ttlMs: HISTORY_TTL_MS, rejectionMs: HISTORY_RETRY_MS });
 
-function readHistory(provider: DataProvider, symbol: string): Promise<readonly PricePoint[] | null> {
-  return provider.getPriceHistory(symbol, "", "1Y").then((points) => points.length > 0 ? points : null, (error: unknown) => {
+/** `batch`: asked with every other row's, from a source that batches them (`DataProvider.batchesReads`). */
+function readHistory(provider: DataProvider, symbol: string, batch: boolean): Promise<readonly PricePoint[] | null> {
+  return provider.getPriceHistory(symbol, "", "1Y", batch ? { batch } : undefined).then((points) => points.length > 0 ? points : null, (error: unknown) => {
     if (isNoSourceAnswer(error)) return null;
     throw error;
   });
 }
 
 /** Whether the contract has an answer; false when the read failed. */
-function loadHistory(provider: DataProvider, symbol: string): Promise<boolean> {
-  return historyCache.load(symbol, () => readHistory(provider, symbol))
+function loadHistory(provider: DataProvider, symbol: string, batch: boolean): Promise<boolean> {
+  return historyCache.load(symbol, () => readHistory(provider, symbol, batch))
     .then(() => true, logFailure("futures", "Read a futures contract's history failed", false));
 }
 
@@ -89,18 +91,22 @@ export function useFrontContractReturns(
     let cancelled = false;
     let failed = false;
     let retryTimer: ReturnType<typeof setTimeout> | undefined;
-    const worker = async () => {
-      for (let symbol = queue.shift(); symbol; symbol = queue.shift()) {
-        if (!await loadHistory(provider, symbol)) failed = true;
-        if (!cancelled) setVersion((current) => current + 1);
-      }
-    };
-    void Promise.all(Array.from({ length: Math.min(HISTORY_CONCURRENCY, queue.length) }, worker)).then(() => {
+    const landed = coalescedBump(() => {
+      if (!cancelled) setVersion((current) => current + 1);
+    });
+    // Twelve reads at a time, shared with the rows' terms (`boardRead`), or all at once from a source that
+    // batches them (`DataProvider.batchesReads`); a board that moved on skips its turn.
+    void readsInBatches(provider, "getPriceHistory").then((batch) => Promise.all(queue.map((symbol) => boardReadGate(batch)(async () => {
+      if (cancelled) return;
+      if (!await loadHistory(provider, symbol, batch)) failed = true;
+      landed.bump();
+    })))).then(() => {
+      landed.flush();
       if (failed && !cancelled) retryTimer = setTimeout(() => setRetry((current) => current + 1), HISTORY_RETRY_MS);
     });
     return () => {
       cancelled = true;
-      queue.length = 0;
+      landed.cancel();
       clearTimeout(retryTimer);
     };
   }, [candidates, enabled, provider, today, retry]);

package/src/plugins/builtin/futures-curve/headless.ts

@@ -7,6 +7,7 @@ import { newestReportTime, oldestReportTime } from "../../../utils/utc-time";
 import { fetchFuturesCurve, loadCurveSpot, loadCurveSpotBars, loadFuturesCurveAsOf } from "./client";
 import { basisSpotSymbol, BASIS_CONVENTION, blankBasisNote, catalogueCurveUnit, curveAsOfDate, curveBasisPercent, curveBasisRows, curveChangeText, curveContractCode, curvePrice, curveRoundedPrice, curveSpotSource, curveSpreadLabel, curveTimestamp, curveNoTradeSince, curveUnitLabel, noTradeChangeNote, normalizeCurveRoot, shortDatedBasisNote, thinSpreadNotice, unpairedContractCount, unsupportedCurveRootMessage, type ContractBasis } from "./model";
 import { COMMODITIES_VIEW_STATE } from "../commodities-energy/view-state";
+import { knownGapMessage } from "../../../cli/known-gaps";
 
 /** The root a report shows when none is given. */
 const DEFAULT_ROOT = "ES";
@@ -120,7 +121,11 @@ export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
   async load(args, ctx) {
     const input = args.argument || DEFAULT_ROOT;
     const root = normalizeCurveRoot(input);
-    if (!root) throw new Error(unsupportedCurveRootMessage(input));
+    if (!root) {
+      // A subject no source carries (`fn CTM BDI`, the Baltic Dry Index) is said with its proxies, as search says it.
+      const gap = typeof input === "string" ? knownGapMessage(input) : null;
+      throw Object.assign(new Error(unsupportedCurveRootMessage(input)), gap ? { details: gap } : {});
+    }
     const date = curveAsOfDate(args.options.date, new Date(), "--date");
     // The archive keeps no spot history, so a past curve has no basis.
     const spotSymbol = date ? null : basisSpotSymbol(root);

package/src/plugins/builtin/futures-curve/index.tsx

@@ -2,10 +2,9 @@ import type { PluginModule } from "../plugin-module";
 import { futuresCurveCache } from "./client";
 import { futuresCurveHeadless } from "./headless";
 import { BASIS_FORMULA, CURVE_HORIZONS, CURVE_ROOTS, curveRootForTicker, curveTitle, DEFAULT_CURVE_HORIZON, normalizeCurveRoot } from "./model";
-import { FuturesCurvePane } from "./pane";
 
 export const futuresCurveModule: PluginModule = {
-  panes: [{ id: "futures-curve", name: "Futures Curve", icon: "F", component: FuturesCurvePane,
+  panes: [{ id: "futures-curve", name: "Futures Curve", icon: "F", get component(): typeof import("./pane").FuturesCurvePane { const { FuturesCurvePane } = require("./pane"); return FuturesCurvePane; },
     defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 98, height: 30 },
     tableExport: true, headless: futuresCurveHeadless,
     settings: (context) => ({ title: "Futures Curve Settings",

package/src/plugins/builtin/fx-matrix/index.tsx

@@ -9,7 +9,7 @@ import {
   type PaneFooterSegment,
 } from "../../../components";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
-import { savedCopyFooterSegment } from "../../../components/layout/pane/footer";
+import { ageFooterSegment, savedCopyFooterSegment } from "../../../components/layout/pane/footer";
 import { CountryFlag } from "../../../components/ui/country-flag";
 import { getSharedMarketDataCoordinator } from "../../../market-data/coordinator";
 import { useFxRatesMap } from "../../../market-data/hooks";
@@ -244,7 +244,7 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
     if (status.loading > 0) info.push({ id: "loading", parts: [{ text: "loading", tone: "muted" }] });
     if (statusText) info.push({ id: "rates", parts: [{ text: statusText, tone: status.stale || status.unknownTime || status.unavailable ? "warning" : "muted" }] });
     if (savedAt != null) info.push(savedCopyFooterSegment("updated", savedAt));
-    else if (updatedAgo) info.push({ id: "updated", parts: [{ text: `fetched ${updatedAgo}`, tone: "muted" }] });
+    else if (updatedAgo) info.push(ageFooterSegment(updatedAgo, { verb: "fetched" }));
     return { info };
   }, [savedAt, status.loading, statusText, updatedAgo]);
 

package/src/plugins/builtin/gpu/board.tsx

@@ -1,5 +1,5 @@
 import { useCallback, useMemo } from "react";
-import type { GpuBoardRow } from "../../../api-client/gpu";
+import type { GpuBoardRow, GpuSettle } from "../../../api-client/gpu";
 import {
   Badge, buildSectionedRows, ChartTableHeader, DataTableView, EMPTY_TABLE_CELL, isSectionedItemRow, QueryBar,
   renderSectionedRowHeader, type DataTableCell, type DataTableColumn, type SectionedRow,
@@ -12,11 +12,11 @@ import { Box, Text, TextAttributes, useUiCapabilities } from "../../../ui";
 import { loadGpuHistory } from "./client";
 import { GpuPriceLadder } from "./ladder";
 import {
-  gpuAvailability, gpuBoardSections, gpuChange, gpuChangeColor, gpuChangesLocked, gpuChangeWindows, gpuHeadline, gpuPrice, gpuPriceLadder, gpuShortSource, gpuSparklineSeries, gpuTime, gpuVariant,
-  type GpuChangeKey,
+  GPU_SETTLE_SECTION, gpuAvailability, gpuBoardSections, gpuChange, gpuChangeColor, gpuChangesLocked, gpuChangeWindows, gpuHeadline, gpuPrice, gpuPriceLadder,
+  gpuSettleRows, gpuShortSource, gpuSparklineSeries, gpuTime, gpuVariant, isGpuSettleRow, type GpuBoardItem, type GpuChangeKey,
 } from "./model";
 
-type BoardRow = SectionedRow<GpuBoardRow>;
+type BoardRow = SectionedRow<GpuBoardItem>;
 const rowKey = (row: BoardRow) => row.key;
 const EMPTY_HISTORY = new Map<string, PricePoint[]>();
 const CHANGE_LABELS: Record<GpuChangeKey, string> = { change1d: "1D", change7d: "7D", change30d: "30D" };
@@ -79,21 +79,29 @@ function boardColumns(width: number, options: { windows: GpuChangeKey[]; trend:
   ];
 }
 
-export function GpuBoard({ rows, models, asOf, model, setModel, selectedId, select, emptyTitle, width, height, focused, pending = false }: {
-  rows: GpuBoardRow[]; models: readonly string[]; asOf: string | null; model: string; setModel: (value: string) => void; selectedId: string; select: (row: GpuBoardRow, open?: boolean) => void;
+export function GpuBoard({ rows, settles, models, asOf, model, setModel, selectedId, select, emptyTitle, width, height, focused, pending = false }: {
+  rows: GpuBoardRow[]; settles?: readonly GpuSettle[]; models: readonly string[]; asOf: string | null; model: string; setModel: (value: string) => void; selectedId: string;
+  /** Opening a settle row selects it: its history is the GPU pages', not the History tab's. */
+  select: (row: GpuBoardItem, open?: boolean) => void;
   emptyTitle: string; width: number; height: number; focused: boolean;
   /** The picked GPU's free preview is still loading. */
   pending?: boolean;
 }) {
   const colors = useThemeColors();
   const sections = useMemo(() => gpuBoardSections(rows, model), [rows, model]);
-  const items = useMemo(() => buildSectionedRows(sections.map((section) => ({ label: section.label, items: section.rows })), (row) => row.id), [sections]);
+  // A GPU nobody quotes has no board to lead.
+  const settleRows = useMemo(() => sections.length ? gpuSettleRows(settles, model) : [], [sections, settles, model]);
+  const items = useMemo(() => buildSectionedRows<GpuBoardItem>([
+    ...(settleRows.length ? [{ label: GPU_SETTLE_SECTION, items: settleRows }] : []),
+    ...sections.map((section) => ({ label: section.label, items: section.rows })),
+  ], (row) => row.id), [settleRows, sections]);
   const visible = useMemo(() => sections.flatMap((section) => section.rows), [sections]);
-  const windows = useMemo(() => gpuChangeWindows(visible), [visible]);
+  const windows = useMemo(() => gpuChangeWindows([...visible, ...settleRows.map((row) => row.settle)]), [visible, settleRows]);
   const history = useHeadlineHistory(rows, model);
   const trend = [...history.values()].some((points) => points.length >= MIN_TREND_POINTS);
   const ladder = useMemo(() => model ? gpuPriceLadder(rows, model) : [], [rows, model]);
-  const selected = visible.find((row) => row.id === selectedId) ?? visible[0] ?? null;
+  const selectedSettle = settleRows.find((row) => row.id === selectedId) ?? null;
+  const selected = selectedSettle ? null : visible.find((row) => row.id === selectedId) ?? visible[0] ?? null;
   const medium = width >= 100;
   const asOfDay = asOf?.slice(0, 10) ?? null;
   const columns = boardColumns(width, { windows, trend, range: visible.some((row) => row.stats), availability: visible.some((row) => row.availability) });
@@ -102,9 +110,10 @@ export function GpuBoard({ rows, models, asOf, model, setModel, selectedId, sele
 
   const renderCell = (item: BoardRow, column: DataTableColumn, _index: number, state: { selected: boolean }): DataTableCell => {
     if (!isSectionedItemRow(item)) return EMPTY_TABLE_CELL;
+    const ink = state.selected ? colors.selectedText : undefined;
+    if (isGpuSettleRow(item.item)) return settleCell(item.item.settle, column, ink);
     const row = item.item;
     const headline = gpuHeadline(row);
-    const ink = state.selected ? colors.selectedText : undefined;
     switch (column.id) {
       case "source": {
         const name = gpuShortSource(row);
@@ -153,6 +162,36 @@ export function GpuBoard({ rows, models, asOf, model, setModel, selectedId, sele
     }
   };
 
+  /**
+   * A settle draws as the board's lead rows do (bold name and price), on the
+   * same columns: its moves are against earlier settles, and its time is the
+   * settle time.
+   */
+  const settleCell = (settle: GpuSettle, column: DataTableColumn, ink: string | undefined): DataTableCell => {
+    const settled = settle.status === "settled" && settle.pricePerGpuHr != null;
+    switch (column.id) {
+      case "source": {
+        const name = `Gloom ${settle.gpuModel}`;
+        const note = settle.kind === "correction" ? "corrected" : settled ? "settled" : "no settle";
+        return { text: `${name} ${note}`, content: <Box flexDirection="row" height={1} overflow="hidden">
+          <Text fg={ink ?? colors.textBright} attributes={TextAttributes.BOLD}>{name}</Text>
+          <Text fg={ink ?? colors.textDim}>{` ${note}`}</Text>
+        </Box> };
+      }
+      case "variant": return { text: gpuVariant(settle).join(" "), content: <GpuVariantChips row={settle} width={column.width} selected={!!ink} /> };
+      case "price": return settled ? { text: gpuPrice(settle.pricePerGpuHr), value: settle.pricePerGpuHr, color: colors.textBright, attributes: TextAttributes.BOLD }
+        : { text: "-", value: null, color: colors.textMuted };
+      case "unavailableChange": return { text: "-", value: null, color: colors.textMuted };
+      case "change1d": case "change7d": case "change30d": {
+        const value = settle[column.id];
+        return value == null ? { text: "-", value: null, color: colors.textMuted } : { text: gpuChange(value), value, color: gpuChangeColor(value, colors) };
+      }
+      case "asof": return { text: asOfDay && settle.settleAt.startsWith(asOfDay) ? settle.settleAt.slice(11, 16) : gpuTime(settle.settleAt, true),
+        value: settle.settleAt, color: colors.textDim };
+      default: return EMPTY_TABLE_CELL;
+    }
+  };
+
   const query = <GpuModelQuery models={models} model={model} setModel={setModel} width={width} />;
   return <DataTableView<BoardRow> columns={columns} items={items} rootWidth={width} rootHeight={height} focused={focused}
     status={pending && !items.length ? { loading: true, subject: "GPU rental prices" } : undefined}
@@ -161,9 +200,9 @@ export function GpuBoard({ rows, models, asOf, model, setModel, selectedId, sele
         render: (size) => <GpuPriceLadder rows={ladder} width={size.width} height={size.height}
           selected={selected && selected.gpuModel === model && selected.providerClass !== "aggregate" ? { basis: selected.basis, price: selected.pricePerGpuHr } : null} /> }} />
       : query}
-    selection={{ kind: "id", selectedId: selected?.id ?? null, getId: rowKey,
+    selection={{ kind: "id", selectedId: selectedSettle?.id ?? selected?.id ?? null, getId: rowKey,
       onChange: (_id, row) => { if (row && isSectionedItemRow(row)) select(row.item); } }}
     isNavigable={isSectionedItemRow} renderSectionHeader={renderSectionedRowHeader}
-    getItemKey={rowKey} onActivate={(row) => { if (isSectionedItemRow(row)) select(row.item, true); }} sortColumnId={null} sortDirection="asc"
+    getItemKey={rowKey} onActivate={(row) => { if (isSectionedItemRow(row)) select(row.item, !isGpuSettleRow(row.item)); }} sortColumnId={null} sortDirection="asc"
     selectedTextOverridesCellColor renderCell={renderCell} emptyStateTitle={emptyTitle} />;
 }

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

@@ -1,6 +1,7 @@
 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 type { GpuBoardPayload, GpuEventsPayload, GpuHistoryPayload, GpuHistoryQuery, GpuObservation, GpuSettle } from "../../../api-client/gpu";
 import { createPluginCache } from "../../../data/plugin-cache";
 import type { DataProvider } from "../../../types/data-provider";
 import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
@@ -58,6 +59,17 @@ function validObservation(row: unknown): row is GpuObservation {
       && (stats.constituentPrices === undefined || record(stats.constituentPrices) && Object.values(stats.constituentPrices).every((value) => finite(value) && value > 0)));
 }
 
+function validSettle(row: unknown): row is GpuSettle {
+  if (!record(row)) return false;
+  const settled = row.status === "settled";
+  return [row.id, row.gpuModel, row.formFactor, row.label].every((value) => typeof value === "string" && value.length > 0)
+    && typeof row.date === "string" && /^\d{4}-\d{2}-\d{2}$/.test(row.date) && instant(row.settleAt) && instant(row.publishedAt)
+    && (row.memoryGb === null || finite(row.memoryGb) && row.memoryGb > 0)
+    && (settled ? finite(row.pricePerGpuHr) && row.pricePerGpuHr > 0 : row.status === "no-settle" && row.pricePerGpuHr === null)
+    && row.currency === "USD" && ["settle", "correction"].includes(row.kind) && nullableText(row.corrects)
+    && [row.change1d, row.change7d, row.change30d].every(nullableNumber);
+}
+
 function validateBoard(payload: GpuBoardPayload): GpuBoardPayload {
   if (!record(payload) || !validAccess(payload.access) || !instant(payload.generatedAt) || !nullableInstant(payload.asOf) || typeof payload.stale !== "boolean"
     || !["available", "partial", "unavailable"].includes(payload.status) || !strings(payload.gaps)
@@ -65,7 +77,9 @@ function validateBoard(payload: GpuBoardPayload): GpuBoardPayload {
       && typeof row.id === "string" && row.id === `${row.source}:${row.skuKey}` && typeof row.label === "string" && typeof row.sourceLabel === "string"
       && [row.change1d, row.change7d, row.change30d].every(nullableNumber) && typeof row.stale === "boolean" && nullableText(row.lastError))
     || new Set(payload.rows.map((row) => row.id)).size !== payload.rows.length) throw new Error("The server returned invalid GPU rental prices.");
-  return payload;
+  // The settles ride along with the board: one that does not read right is left out, never the board with it.
+  return payload.settles === undefined ? payload
+    : { ...payload, settles: Array.isArray(payload.settles) ? payload.settles.filter(validSettle) : [] };
 }
 
 function validateHistory(payload: GpuHistoryPayload): GpuHistoryPayload {
@@ -94,7 +108,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/equities.tsx

@@ -14,7 +14,8 @@ import { Box, TextAttributes, useUiCapabilities } from "../../../ui";
 import { ClippedText } from "../../../components/ui/display";
 import { publicTickerKey } from "../../../utils/exchanges";
 import { displayWidth } from "../../../utils/format";
-import { quoteBoardFooterInfo, quoteBoardStatus, renderQuoteBoardCell, useQuoteBoard } from "../shared/use-quote-board";
+import { boardQuotes, quoteBoardFooterInfo, quoteBoardStatus, renderQuoteBoardCell, useQuoteBoard } from "../shared/use-quote-board";
+import { useQuoteDelayFooter } from "../shared/cloud-upgrade";
 import { GpuModelQuery } from "./board";
 import { loadGpuEquityHistory } from "./client";
 import { GPU_EQUITIES, GPU_EQUITY_GROUPS, gpuChange, gpuChangeColor, gpuChangesLocked, gpuEquityGap, gpuEquityRows, gpuPrice, gpuShortSource, gpuVariant, type GpuEquityRow } from "./model";
@@ -62,8 +63,10 @@ export function GpuEquities({ board, models, locked, model, setModel, reloadBoar
     items: rows.filter((row) => (group.roles as readonly string[]).includes(row.role)) })), (row) => row.symbol), [rows]);
   const historyMap = useMemo(() => new Map(history.data?.map((entry) => [entry.symbol, entry]) ?? []), [history.data]);
   const ends = [...new Set(history.data?.flatMap((entry) => entry.asOf ? [entry.asOf] : []) ?? [])].sort();
+  const quoteDelay = useQuoteDelayFooter(boardQuotes(quotes), "gpu-equities-delay");
   usePaneFooter("gpu:equity-status", () => ({ info: [...quoteBoardFooterInfo(quoteBoardStatus(quotes)),
-    ...(ends.length === 1 ? [{ id: "five-asof", parts: [{ text: `5D closes through ${ends[0]}`, tone: "muted" as const }] }] : [])] }), [quotes, ends.join(",")]);
+    ...(ends.length === 1 ? [{ id: "five-asof", parts: [{ text: `5D closes through ${ends[0]}`, tone: "muted" as const }] }] : []),
+    ...(quoteDelay ? [quoteDelay] : [])] }), [quotes, quoteDelay, ends.join(",")]);
   usePaneNoticeFooter({ registrationId: "gpu:equity-notices", focused,
     notices: [...(history.error ? [history.error] : []), ...(history.data?.flatMap((entry) => entry.error ? [entry.error] : []) ?? [])] });
   const dataRef = useRef({ quotes, historyMap });

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

@@ -4,7 +4,7 @@ import { formatUtcTime, parseReportTime } from "../../../utils/utc-time";
 import { fetchGpuBoard, fetchGpuEvents, fetchGpuHistory, fetchGpuModelPreviews, gpuPreviewModels, loadGpuEquityHistory } from "./client";
 import {
   GPU_TABS, gpuBasisLabel, gpuChange, gpuChangesLocked, gpuEquityGap, gpuEquityModels, gpuEquityRows, gpuEventDate, gpuFamilies, gpuFamily,
-  gpuLabel, gpuNoMatch, gpuPrice, gpuProvenanceLabel, gpuRows, gpuSource, gpuTab,
+  gpuLabel, gpuNoMatch, gpuPrice, gpuProvenanceLabel, gpuRows, gpuSettleRows, gpuSource, gpuTab, GPU_SETTLE_SECTION,
 } from "./model";
 import { quoteFreshnessFields } from "../shared/report-freshness";
 import { countOf, freePreviewNote } from "../shared/free-preview";
@@ -33,6 +33,13 @@ const columns = [
   { key: "observedAt", header: "As of", format: minute },
 ];
 
+const settleColumns = [
+  { key: "gpu", header: "GPU" }, { key: "status", header: "Settle" },
+  { key: "price", header: "$/GPU-hr", align: "right" as const, format: price },
+  { key: "change1d", header: "1D", align: "right" as const, format: percent }, { key: "change7d", header: "7D", align: "right" as const, format: percent },
+  { key: "change30d", header: "30D", align: "right" as const, format: percent }, { key: "settleAt", header: "Settled", format: minute },
+];
+
 export const gpuHeadless: HeadlessPaneDefinition<"bundle"> = {
   // Observed rental prices; the Equities tab's quotes keep their market line.
   shape: "bundle", freshness: { dataset: true }, argument: { kind: "free-text", optional: true, placeholder: "GPU", description: "GPU model, such as H100, h-100 or B200." },
@@ -41,6 +48,7 @@ export const gpuHeadless: HeadlessPaneDefinition<"bundle"> = {
     limitations: ["List prices, provider-declared spot and asks are distinct bases.",
       "Hyperscaler and Neocloud rows are list indexes: the median of the providers' list prices linked over time, so a provider joining or leaving causes no jump; sample.rawMedian is the raw median of today's providers and can differ slightly.",
       "1D/7D/30D need sufficient observation history; unavailable changes remain null.",
+      "The Gloom daily settle is Gloom's official price per GPU and form factor, set at 20:00 UTC and never revised; a day with too few prices has no settle.",
       "Free preview: three board rows, or the latest rows of the GPU asked for; Pro unlocks every provider, the moves and the history."] },
   describe: "GPU rental prices in USD per GPU-hour",
   async load(args, ctx) {
@@ -113,7 +121,11 @@ export const gpuHeadless: HeadlessPaneDefinition<"bundle"> = {
     }
     const boardRows = gpuRows(rows, model).map((row) => ({ ...observationRow(row), change1d: row.change1d, change7d: row.change7d,
       change30d: row.change30d, stale: row.stale, sample: row.stats ?? null, ...(gpuChangesLocked(row) ? { changesLocked: true } : {}) }));
-    return { sections: [{ title: "GPU rental prices", columns, rows: boardRows, empty: `No ${model ? `${model} ` : ""}rental prices have been observed yet.` }],
+    const settles = gpuSettleRows(board.settles, model).map(({ settle }) => ({ gpu: gpuLabel(settle), status: settle.status === "settled" ? "settled" : "no settle",
+      price: settle.pricePerGpuHr, change1d: settle.change1d, change7d: settle.change7d, change30d: settle.change30d, settleAt: settle.settleAt,
+      date: settle.date, ...(settle.kind === "correction" ? { corrected: true } : {}) }));
+    return { sections: [...(settles.length ? [{ title: GPU_SETTLE_SECTION, columns: settleColumns, rows: settles }] : []),
+      { title: "GPU rental prices", columns, rows: boardRows, empty: `No ${model ? `${model} ` : ""}rental prices have been observed yet.` }],
       freshness, complete: !board.access?.locked, metadata, errors: [...locks, ...board.gaps] };
   },
 };

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

@@ -2,11 +2,10 @@ import type { PluginModule } from "../plugin-module";
 import { gpuBoardCache, gpuEventsCache, gpuHistoryCache } from "./client";
 import { gpuHeadless } from "./headless";
 import { GPU_MODELS, gpuArgument } from "./model";
-import { GpuPane } from "./pane";
 import { GPU_SERIES } from "./series";
 
 export const gpuModule: PluginModule = {
-  panes: [{ id: "gpu", name: "GPU Rental Prices", icon: "G", component: GpuPane, defaultPosition: "right", defaultMode: "floating",
+  panes: [{ id: "gpu", name: "GPU Rental Prices", icon: "G", get component(): typeof import("./pane").GpuPane { const { GpuPane } = require("./pane"); return GpuPane; }, defaultPosition: "right", defaultMode: "floating",
     defaultFloatingSize: { width: 120, height: 34 }, tableExport: true, headless: gpuHeadless }],
   paneTemplates: [{ id: "gpu-pane", paneId: "gpu", label: "GPU Rental Prices",
     description: "Pro GPU rental list prices, provider-declared spot and marketplace asks, with sourced price history and related equities. Free preview available.",

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

@@ -1,4 +1,4 @@
-import type { GpuBasis, GpuBoardRow, GpuEvent, GpuObservation } from "../../../api-client/gpu";
+import type { GpuBasis, GpuBoardRow, GpuEvent, GpuObservation, GpuSettle } from "../../../api-client/gpu";
 import { staticSeries } from "../../../components/chart/static/series";
 import { SERIES_COLORS } from "../../../theme/series-colors";
 import type { ResolvedSeries } from "../../../time-series/types";
@@ -175,9 +175,27 @@ export function gpuBoardSections(rows: readonly GpuBoardRow[], model = ""): GpuB
   return sections;
 }
 
+/** Gloom's daily settle as a board row: it leads the board, above every quote. */
+export interface GpuSettleRow { kind: "settle"; id: string; settle: GpuSettle }
+export type GpuBoardItem = GpuBoardRow | GpuSettleRow;
+export const isGpuSettleRow = (row: GpuBoardItem): row is GpuSettleRow => (row as Partial<GpuSettleRow>).kind === "settle";
+export const GPU_SETTLE_SECTION = "Gloom daily settle";
+
+/**
+ * The settle rows of the board: every form factor of the picked GPU, settled
+ * or not, so a day with too few prices says so; across all GPUs only the ones
+ * settled. GPUs in board order, SXM first.
+ */
+export function gpuSettleRows(settles: readonly GpuSettle[] | undefined, model = ""): GpuSettleRow[] {
+  return (settles ?? []).filter((settle) => model ? settle.gpuModel === model : settle.status === "settled")
+    .sort((a, b) => gpuModelOrder(a.gpuModel, b.gpuModel) || Number(b.formFactor === "SXM") - Number(a.formFactor === "SXM")
+      || a.formFactor.localeCompare(b.formFactor))
+    .map((settle) => ({ kind: "settle", id: `settle:${settle.gpuModel}:${settle.formFactor}`, settle }));
+}
+
 export type GpuChangeKey = "change1d" | "change7d" | "change30d";
 /** Change windows with at least one figure; missing windows remain unavailable. */
-export const gpuChangeWindows = (rows: readonly GpuBoardRow[]): GpuChangeKey[] =>
+export const gpuChangeWindows = (rows: readonly Pick<GpuBoardRow, GpuChangeKey>[]): GpuChangeKey[] =>
   (["change1d", "change7d", "change30d"] as const).filter((key) => rows.some((row) => row[key] != null));
 
 /**

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

@@ -71,7 +71,7 @@ function GpuView({ width, height, focused }: PaneProps) {
     {strip}
     <PaneStatusBody loading={resource.loading && !data} error={!data && !notAvailable ? resource.error : null}
       empty={notAvailable} emptyTitle={GPU_NOT_AVAILABLE} subject="GPU rental prices">
-      {data ? tab === "board" ? <GpuBoard rows={rows} models={models} asOf={data.asOf} model={activeModel} setModel={setModel} selectedId={selectedId} emptyTitle={emptyTitle}
+      {data ? tab === "board" ? <GpuBoard rows={rows} settles={data.settles} models={models} asOf={data.asOf} model={activeModel} setModel={setModel} selectedId={selectedId} emptyTitle={emptyTitle}
         select={(row, open) => { setSelectedId(row.id); if (open) setTab("history"); }} {...body} />
         : tab === "history" ? <GpuHistory rows={rows} models={models} model={unknownModel ? "" : activeModel} setModel={setModel} selectedId={selectedId} onSelect={setSelectedId} reloadBoard={reloadBoard} {...body} />
           : tab === "changes" ? <GpuChanges models={models} model={unknownModel ? "" : activeModel} setModel={setModel} reloadBoard={reloadBoard} {...body} />

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/help/index.tsx

@@ -425,7 +425,7 @@ export const helpModule: PluginModule = {
       name: "Help",
       icon: "?",
       component: HelpPane,
-      reportFreshness: { status: "not-a-feed", basis: "documentation" },
+      reportFreshness: { status: "not-a-feed", basis: "documentation", local: true },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 88, height: 32 },

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/holders/index-holders.ts

@@ -7,7 +7,7 @@ import { nonUsHolderCaveat } from "./report-header";
 /**
  * A US listing's 13F holders from the SEC 13F holder index, the list `fn 13F`
  * pages through: every filer that reported the security for the latest
- * quarter, largest first, 25 to a page. HDS shows them in the units of the
+ * quarter, largest first. HDS shows them in the units of the
  * source's own short list (each position at the latest price, the stake as a
  * share of the class that list divides by), and keeps that short list for a
  * listing abroad and whenever the index cannot be read.
@@ -96,26 +96,35 @@ export function indexedHolderPage(holdings: TickerHoldings): IndexedHolderList {
   };
 }
 
-/** Rows the service gives a page, as `fn 13F` asks for them. */
-const INDEX_PAGE_ROWS = 25;
 /**
- * Pages one list reads at most: twice what the most rows take, for pages
- * whose options and exits leave fewer holders, and never without end.
+ * Rows the pane asks a page for. The service reads a stored quarter's holders
+ * by key and gives up to 200 a page; one that builds the page from the funds'
+ * filings (an older one, or a quarter not stored yet) gives 25, and the next
+ * page starts where it stopped.
  */
-const INDEX_PAGES_MAX = Math.ceil(HOLDER_ROWS_MAX / INDEX_PAGE_ROWS) * 2;
+const INDEX_PAGE_ROWS = 100;
+/** Rows the service gives a page at most, as one that builds it from the funds' filings does. */
+const INDEX_PAGE_ROWS_MIN = 25;
+/**
+ * Pages one list reads at most: twice what the most rows take at the
+ * smallest page, for pages whose options and exits leave fewer holders, and
+ * never without end.
+ */
+const INDEX_PAGES_MAX = Math.ceil(HOLDER_ROWS_MAX / INDEX_PAGE_ROWS_MIN) * 2;
 
 /** The client the pages come through; headless reports pass their own. */
 export type IndexedHolderClient = Pick<typeof apiClient, "getCloudSec13F">;
 
-/** One page of 25, as `fn 13F` asks for it, so the two share the service's copy. */
+/** One page of the holders from `offset`, `rows` asked (the service may give fewer). */
 export async function loadIndexedHolderPage(
   ticker: string,
   offset: number,
   signal?: AbortSignal,
   client: IndexedHolderClient = apiClient,
+  rows = INDEX_PAGE_ROWS,
 ): Promise<IndexedHolderList> {
   signal?.throwIfAborted();
-  const holdings = await client.getCloudSec13F("ticker-holdings", { tickers: ticker, offset, limit: INDEX_PAGE_ROWS }, { signal }) as TickerHoldings;
+  const holdings = await client.getCloudSec13F("ticker-holdings", { tickers: ticker, offset, limit: rows }, { signal }) as TickerHoldings;
   signal?.throwIfAborted();
   if (!Array.isArray(holdings?.rows) || typeof holdings.period !== "string") throw new Error(`13F holders of ${ticker} are unreadable`);
   const page = indexedHolderPage(holdings);
@@ -132,8 +141,9 @@ function appendIndexedHolders(current: IndexedHolderList, page: IndexedHolderLis
 
 /**
  * The largest `limit` holders, paging as far as that takes, never more than
- * `INDEX_PAGES_MAX` pages. A later page that fails keeps the holders already
- * loaded, marked partial; only a first page that fails leaves the source's list.
+ * `INDEX_PAGES_MAX` pages: one request for a stored quarter. A later page
+ * that fails keeps the holders already loaded, marked partial; only a first
+ * page that fails leaves the source's list.
  */
 export async function loadIndexedHolders(
   ticker: string,
@@ -141,12 +151,14 @@ export async function loadIndexedHolders(
   signal?: AbortSignal,
   client: IndexedHolderClient = apiClient,
 ): Promise<IndexedHolderList> {
-  let list = await loadIndexedHolderPage(ticker, 0, signal, client);
+  // Asked for in full: exits and options can leave a page with fewer holders than rows.
+  const rows = Math.min(HOLDER_ROWS_MAX, Math.max(limit, 1));
+  let list = await loadIndexedHolderPage(ticker, 0, signal, client, rows);
   for (let pages = 1; list.hasMore && list.rows.length < limit && pages < INDEX_PAGES_MAX; pages += 1) {
     const offset = list.nextOffset;
     let page: IndexedHolderList;
     try {
-      page = await loadIndexedHolderPage(ticker, offset, signal, client);
+      page = await loadIndexedHolderPage(ticker, offset, signal, client, rows);
     } catch (error) {
       if (signal?.aborted) throw error;
       logFailure("holders.index", "Read a later page of the 13F holder index failed", null)(error);

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

@@ -2,7 +2,6 @@ import type { PluginModule } from "../plugin-module";
 import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import { beneficialOwnersCache } from "./beneficial-client";
 import { holdersHeadless } from "./headless";
-import { HoldersView } from "./pane";
 
 export const holdersModule: PluginModule = {
   setup(ctx) {
@@ -11,7 +10,7 @@ export const holdersModule: PluginModule = {
       id: "holders",
       name: "Holders",
       order: 42,
-      component: HoldersView,
+      get component(): typeof import("./pane").HoldersView { const { HoldersView } = require("./pane"); return HoldersView; },
       instruments: ["equity"],
     });
   },
@@ -24,7 +23,7 @@ export const holdersModule: PluginModule = {
       id: "holders",
       name: "Holders",
       icon: "H",
-      component: HoldersView,
+      get component(): typeof import("./pane").HoldersView { const { HoldersView } = require("./pane"); return HoldersView; },
       defaultPosition: "right",
       tickerFollower: true,
       defaultMode: "floating",

package/src/plugins/builtin/ipo-calendar/index.tsx

@@ -3,7 +3,6 @@ import { commandRequestParams } from "../shared/command-tab";
 import { ipoCalendarCache } from "./client";
 import { ipoCalendarHeadless } from "./headless";
 import { IPO_CALENDAR_PANE_ID } from "./model";
-import { IpoCalendarPane } from "./pane";
 
 /**
  * `IPO japan` opens the calendar on that search, and so does a later `IPO europe`: one pane, the open one
@@ -44,7 +43,7 @@ export const ipoCalendarPlugin: GloomPlugin = {
       id: IPO_CALENDAR_PANE_ID,
       name: "IPO Calendar",
       icon: "I",
-      component: IpoCalendarPane,
+      get component(): typeof import("./pane").IpoCalendarPane { const { IpoCalendarPane } = require("./pane"); return IpoCalendarPane; },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 110, height: 28 },

package/src/plugins/builtin/iv-history/index.tsx

@@ -3,14 +3,13 @@ import type { PluginModule } from "../plugin-module";
 import { IV_SERIES } from "./series";
 import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import { ivHistoryHeadless, ivScreenHeadless } from "./headless";
-import { IvHistoryPane } from "./pane";
 import { IvScreenPane, VCA_SCOPE_OPTIONS } from "./screen-pane";
 
 
 export const ivHistoryModule: PluginModule = {
   series: IV_SERIES,
   panes: [{
-    id: "iv-history", name: "Implied Volatility History", icon: "V", component: IvHistoryPane,
+    id: "iv-history", name: "Implied Volatility History", icon: "V", get component(): typeof import("./pane").IvHistoryPane { const { IvHistoryPane } = require("./pane"); return IvHistoryPane; },
     defaultPosition: "right", tickerFollower: true, defaultMode: "floating", defaultFloatingSize: { width: 118, height: 36 },
     tableExport: true,
     settings: { title: "Implied Volatility History", fields: [