gloomberb 0.16.2 → 0.16.4

package/src/plugins/builtin/macro-day/release-table.ts

@@ -0,0 +1,40 @@
+// Generated by scripts/update-macro-releases.ts from the publishers' archives
+// (bun run macro-releases:update). Dates are New York calendar days.
+export const MACRO_RELEASE_TABLE: {
+  checkedAt: string;
+  coveredThrough: string;
+  days: Record<"cpi" | "jobs" | "fomc", Record<number, readonly string[]>>;
+} = {
+  checkedAt: "2026-10-10",
+  /** The last day the lists are complete for: later sessions are left out, release day or not. */
+  coveredThrough: "2026-10-09",
+  days: {
+    // BLS Consumer Price Index, 8:30 ET.
+    cpi: {
+      2021: ["01-13", "02-10", "03-10", "04-13", "05-12", "06-10", "07-13", "08-11", "09-14", "10-13", "11-10", "12-10"],
+      2022: ["01-12", "02-10", "03-10", "04-12", "05-11", "06-10", "07-13", "08-10", "09-13", "10-13", "11-10", "12-13"],
+      2023: ["01-12", "02-14", "03-14", "04-12", "05-10", "06-13", "07-12", "08-10", "09-13", "10-12", "11-14", "12-12"],
+      2024: ["01-11", "02-13", "03-12", "04-10", "05-15", "06-12", "07-11", "08-14", "09-11", "10-10", "11-13", "12-11"],
+      2025: ["01-15", "02-12", "03-12", "04-10", "05-13", "06-11", "07-15", "08-12", "09-11", "10-24", "12-18"],
+      2026: ["01-13", "02-13", "03-11", "04-10", "05-12", "06-10", "07-14", "08-12", "09-11"],
+    },
+    // BLS Employment Situation (nonfarm payrolls), 8:30 ET.
+    jobs: {
+      2021: ["01-08", "02-05", "03-05", "04-02", "05-07", "06-04", "07-02", "08-06", "09-03", "10-08", "11-05", "12-03"],
+      2022: ["01-07", "02-04", "03-04", "04-01", "05-06", "06-03", "07-08", "08-05", "09-02", "10-07", "11-04", "12-02"],
+      2023: ["01-06", "02-03", "03-10", "04-07", "05-05", "06-02", "07-07", "08-04", "09-01", "10-06", "11-03", "12-08"],
+      2024: ["01-05", "02-02", "03-08", "04-05", "05-03", "06-07", "07-05", "08-02", "09-06", "10-04", "11-01", "12-06"],
+      2025: ["01-10", "02-07", "03-07", "04-04", "05-02", "06-06", "07-03", "08-01", "09-05", "11-20", "12-16"],
+      2026: ["01-09", "02-11", "03-06", "04-03", "05-08", "06-05", "07-02", "08-07", "09-04", "10-02"],
+    },
+    // FOMC statement days (the meeting's last day), 14:00 ET. The August 2025 notation vote is not a meeting.
+    fomc: {
+      2021: ["01-27", "03-17", "04-28", "06-16", "07-28", "09-22", "11-03", "12-15"],
+      2022: ["01-26", "03-16", "05-04", "06-15", "07-27", "09-21", "11-02", "12-14"],
+      2023: ["02-01", "03-22", "05-03", "06-14", "07-26", "09-20", "11-01", "12-13"],
+      2024: ["01-31", "03-20", "05-01", "06-12", "07-31", "09-18", "11-07", "12-18"],
+      2025: ["01-29", "03-19", "05-07", "06-18", "07-30", "09-17", "10-29", "12-10"],
+      2026: ["01-28", "03-18", "04-29", "06-17", "07-29", "09-16"],
+    },
+  },
+};

package/src/plugins/builtin/macro-day/releases.ts

@@ -1,58 +1,76 @@
 // Published US release days, not a rule engine: the dates each release came
 // out, read from the publishers' own archives. A release cancelled or moved (the
-// 2025 shutdown) is as published. Dates are New York calendar days.
+// 2025 shutdown) is as published, and a scheduled date is not a release day
+// until it is out. Dates are New York calendar days.
+import { zonedDateKey } from "../../../utils/zoned-date-time";
+import { MACRO_RELEASE_TABLE } from "./release-table";
+
 export type MacroEventKind = "cpi" | "jobs" | "fomc";
 
 export const MACRO_EVENT_KINDS: readonly MacroEventKind[] = ["cpi", "jobs", "fomc"];
 
 export const MACRO_EVENT_LABELS: Record<MacroEventKind, string> = { cpi: "CPI", jobs: "Jobs", fomc: "FOMC" };
 
-const RELEASES: Record<MacroEventKind, Record<number, readonly string[]>> = {
-  // BLS Consumer Price Index, 8:30 ET.
-  cpi: {
-    2021: ["01-13", "02-10", "03-10", "04-13", "05-12", "06-10", "07-13", "08-11", "09-14", "10-13", "11-10", "12-10"],
-    2022: ["01-12", "02-10", "03-10", "04-12", "05-11", "06-10", "07-13", "08-10", "09-13", "10-13", "11-10", "12-13"],
-    2023: ["01-12", "02-14", "03-14", "04-12", "05-10", "06-13", "07-12", "08-10", "09-13", "10-12", "11-14", "12-12"],
-    2024: ["01-11", "02-13", "03-12", "04-10", "05-15", "06-12", "07-11", "08-14", "09-11", "10-10", "11-13", "12-11"],
-    2025: ["01-15", "02-12", "03-12", "04-10", "05-13", "06-11", "07-15", "08-12", "09-11", "10-24", "12-18"],
-    2026: ["01-13", "02-13", "03-11", "04-10", "05-12", "06-10", "07-14", "08-12", "09-11"],
-  },
-  // BLS Employment Situation (nonfarm payrolls), 8:30 ET.
-  jobs: {
-    2021: ["01-08", "02-05", "03-05", "04-02", "05-07", "06-04", "07-02", "08-06", "09-03", "10-08", "11-05", "12-03"],
-    2022: ["01-07", "02-04", "03-04", "04-01", "05-06", "06-03", "07-08", "08-05", "09-02", "10-07", "11-04", "12-02"],
-    2023: ["01-06", "02-03", "03-10", "04-07", "05-05", "06-02", "07-07", "08-04", "09-01", "10-06", "11-03", "12-08"],
-    2024: ["01-05", "02-02", "03-08", "04-05", "05-03", "06-07", "07-05", "08-02", "09-06", "10-04", "11-01", "12-06"],
-    2025: ["01-10", "02-07", "03-07", "04-04", "05-02", "06-06", "07-03", "08-01", "09-05", "11-20", "12-16"],
-    2026: ["01-09", "02-11", "03-06", "04-03", "05-08", "06-05", "07-02", "08-07", "09-04"],
-  },
-  // FOMC statement days (the meeting's last day), 14:00 ET. The August 2025 notation vote is not a meeting.
-  fomc: {
-    2021: ["01-27", "03-17", "04-28", "06-16", "07-28", "09-22", "11-03", "12-15"],
-    2022: ["01-26", "03-16", "05-04", "06-15", "07-27", "09-21", "11-02", "12-14"],
-    2023: ["02-01", "03-22", "05-03", "06-14", "07-26", "09-20", "11-01", "12-13"],
-    2024: ["01-31", "03-20", "05-01", "06-12", "07-31", "09-18", "11-07", "12-18"],
-    2025: ["01-29", "03-19", "05-07", "06-18", "07-30", "09-17", "10-29", "12-10"],
-    2026: ["01-28", "03-18", "04-29", "06-17", "07-29", "09-16"],
-  },
+/** BLS news release archives for CPI and the Employment Situation, and the Federal Reserve's meeting calendar. */
+export const MACRO_RELEASE_SOURCES: Record<MacroEventKind, string> = {
+  cpi: "https://www.bls.gov/bls/news-release/cpi.htm",
+  jobs: "https://www.bls.gov/bls/news-release/empsit.htm",
+  fomc: "https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm",
 };
 
-export const MACRO_RELEASE_BASIS = {
-  checkedAt: "2026-10-04",
-  /** The last day the lists are complete for: later sessions are left out, release day or not. */
-  coveredThrough: "2026-10-01",
-  sources: [
-    "https://www.bls.gov/bls/news-release/cpi.htm",
-    "https://www.bls.gov/bls/news-release/empsit.htm",
-    "https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm",
-  ],
-} as const;
+/** A list more than this many days behind today says so: a release day may be missing from its end. */
+export const MACRO_RELEASES_STALE_DAYS = 14;
 
 export interface MacroRelease { kind: MacroEventKind; date: string }
 
-/** Every published release day, oldest first. */
-export function macroReleases(): MacroRelease[] {
-  return MACRO_EVENT_KINDS.flatMap((kind) => Object.entries(RELEASES[kind]).flatMap(([year, days]) =>
-    days.map((day) => ({ kind, date: `${year}-${day}` }))))
-    .sort((left, right) => left.date.localeCompare(right.date) || left.kind.localeCompare(right.kind));
+export interface MacroReleaseList {
+  /** Oldest first. */
+  releases: MacroRelease[];
+  /** The last day the list is complete for: later sessions are left out, release day or not. */
+  coveredThrough: string;
+}
+
+const DAY_MS = 86_400_000;
+const isDate = (value: unknown): value is string => typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value)
+  && new Date(`${value}T00:00:00Z`).toISOString().startsWith(value);
+const byDate = (left: MacroRelease, right: MacroRelease) => left.date.localeCompare(right.date) || left.kind.localeCompare(right.kind);
+
+/** The list the app ships with: the floor whenever the server's list is missing or older. */
+export function bundledMacroReleases(): MacroReleaseList {
+  const releases = MACRO_EVENT_KINDS.flatMap((kind) => Object.entries(MACRO_RELEASE_TABLE.days[kind]).flatMap(([year, days]) =>
+    days.map((day) => ({ kind, date: `${year}-${day}` }))));
+  return { releases: releases.sort(byDate), coveredThrough: MACRO_RELEASE_TABLE.coveredThrough };
+}
+
+/**
+ * The served list extends the floor past its end; the floor keeps its own
+ * days up to there. A served list that breaks the contract, or ends no later
+ * than the floor, adds nothing.
+ */
+export function mergeMacroReleases(floor: MacroReleaseList, served: unknown): MacroReleaseList {
+  const payload = served as { coveredThrough?: unknown; releases?: Partial<Record<MacroEventKind, unknown>> } | null;
+  const coveredThrough = payload?.coveredThrough;
+  if (!isDate(coveredThrough) || coveredThrough <= floor.coveredThrough) return floor;
+  const later: MacroRelease[] = [];
+  for (const kind of MACRO_EVENT_KINDS) {
+    const dates = payload?.releases?.[kind];
+    if (!Array.isArray(dates) || !dates.every(isDate)) return floor;
+    for (const date of new Set(dates)) {
+      if (date > floor.coveredThrough && date <= coveredThrough) later.push({ kind, date });
+    }
+  }
+  return { releases: [...floor.releases, ...later].sort(byDate), coveredThrough };
+}
+
+/** Whole days from the list's last covered day to today in New York. */
+export function macroReleasesBehind(coveredThrough: string, now = Date.now()): number {
+  const today = zonedDateKey(now, "America/New_York");
+  return Math.round((Date.parse(`${today}T00:00:00Z`) - Date.parse(`${coveredThrough}T00:00:00Z`)) / DAY_MS);
+}
+
+/** The pane footer and the report notes say so once the list is old enough to miss a release day. */
+export function staleMacroReleasesNotice(list: MacroReleaseList, now = Date.now()): string | null {
+  return macroReleasesBehind(list.coveredThrough, now) > MACRO_RELEASES_STALE_DAYS
+    ? `Release days are listed through ${list.coveredThrough}; later sessions are left out.`
+    : null;
 }

package/src/plugins/builtin/market-heatmap/data.ts

@@ -1,6 +1,6 @@
 import { apiClient } from "../../../api-client";
 import type { MarketHeatmapResult, MarketHeatmapUniverseId } from "../../../api-client/market-discovery";
-export type { MarketHeatmapResult, MarketHeatmapUniverseId } from "../../../api-client/market-discovery";
+export type { MarketHeatmapUniverseId } from "../../../api-client/market-discovery";
 
 export const MARKET_HEATMAP_UNIVERSES = [
   { id: "us-equity", label: "US Stocks" },
@@ -10,12 +10,30 @@ export const MARKET_HEATMAP_UNIVERSES = [
 export const MARKET_HEATMAP_REQUEST_COUNT: Record<MarketHeatmapUniverseId, number> = { "us-equity": 500, "us-etf": 160 };
 export interface MarketHeatmapFetchOptions { count?: number; forceRefresh?: boolean; cache?: boolean; }
 export interface MarketHeatmapSources { client?: Pick<typeof apiClient, "getMarketHeatmap">; }
+
+/** A board as this client holds it: the server's snapshot, and what the request behind it was. */
+export interface MarketHeatmapBoard extends MarketHeatmapResult {
+  /**
+   * When the response arrived and passed validation. `fetchedAt` is when the
+   * server put the snapshot together, which a check a minute later can
+   * return unchanged. A board served from the cache keeps the time of the
+   * response it came from.
+   */
+  checkedAt: number;
+  /**
+   * How many of the largest listings the board covers: the count asked for,
+   * or fewer when the server serves fewer. A company listed twice is one
+   * listing of them but one tile, so `assets` can be shorter.
+   */
+  topCount: number;
+}
+
 const DEFAULT_COUNT = 80;
 /** The most names one board asks for; a server that serves fewer answers with its own maximum. */
 const MAX_MARKET_HEATMAP_COUNT = 500;
 const CACHE_TTL_MS = 60_000;
-const activeFetches = new Map<string, Promise<MarketHeatmapResult>>();
-const memoryCache = new Map<string, { expiresAt: number; result: MarketHeatmapResult }>();
+const activeFetches = new Map<string, Promise<MarketHeatmapBoard>>();
+const memoryCache = new Map<string, { expiresAt: number; result: MarketHeatmapBoard }>();
 
 /**
  * One tile per symbol. A company listed on two exchanges (KHC on NASDAQ and
@@ -37,7 +55,7 @@ export function dedupeHeatmapAssets<T extends { symbol: string; size: number | n
   return result;
 }
 
-async function loadMarketHeatmap(universe: MarketHeatmapUniverseId, count: number, sources?: MarketHeatmapSources): Promise<MarketHeatmapResult> {
+async function loadMarketHeatmap(universe: MarketHeatmapUniverseId, count: number, sources?: MarketHeatmapSources): Promise<MarketHeatmapBoard> {
   const response = await (sources?.client ?? apiClient).getMarketHeatmap(universe, count);
   if (!response.data || !Array.isArray(response.data.assets) || response.data.universe !== universe
     || (response.status !== "success" && response.status !== "partial")) throw new Error("Market heatmap unavailable");
@@ -45,6 +63,8 @@ async function loadMarketHeatmap(universe: MarketHeatmapUniverseId, count: numbe
     ...response.data,
     stale: response.stale === true || response.data.stale === true,
     assets: dedupeHeatmapAssets(response.data.assets).slice(0, count),
+    checkedAt: Date.now(),
+    topCount: Math.min(count, response.data.assets.length),
   };
 }
 
@@ -52,7 +72,7 @@ export async function fetchMarketHeatmap(
   universe: MarketHeatmapUniverseId,
   options?: MarketHeatmapFetchOptions,
   sources?: MarketHeatmapSources,
-): Promise<MarketHeatmapResult> {
+): Promise<MarketHeatmapBoard> {
   const count = Math.max(1, Math.min(MAX_MARKET_HEATMAP_COUNT, Math.round(options?.count ?? DEFAULT_COUNT)));
   const cacheKey = `${universe}:${count}`;
   const useCache = options?.cache !== false && !sources?.client;

package/src/plugins/builtin/market-heatmap/evidence.ts

@@ -0,0 +1,90 @@
+/**
+ * What `gloomberb shot HM` certifies: the tab the heat map drew, how many tiles
+ * and sectors are plotted, and whether its snapshot had loaded. The heat map has
+ * no table rows or labeled values, so this is how a capture counts as data.
+ */
+import type { PaneScreenshotEvidenceHook } from "../../../cli/pane-functions/screenshot-evidence";
+import { useRemoteUiNode } from "../../../remote/semantic-tree";
+import { isRecord } from "../../../utils/guards";
+import { heatmapMove } from "./model";
+import { heatmapTabId, type HeatmapBoardAsset, type HeatmapTabId } from "./portfolio";
+
+interface MarketHeatmapEvidence {
+  kind: "market-heatmap";
+  version: 1;
+  complete: boolean;
+  plottedValueCount: number;
+  tab: HeatmapTabId;
+  tiles: number;
+  sectors: number;
+  /** Tiles colored by a move, not left grey for want of one. */
+  moved: number;
+}
+
+interface HeatmapEvidenceInput {
+  tab: HeatmapTabId;
+  tiles: readonly { item: { id: string; data: Pick<HeatmapBoardAsset, "sector"> } }[];
+  /** The assets the tiles are colored by. */
+  assets: readonly HeatmapBoardAsset[];
+  /** Whether the tiles are grouped into sectors, rather than laid out flat. */
+  grouped: boolean;
+  /** A snapshot is on its way. */
+  loading: boolean;
+  /** The tiles are a retained board: its refresh failed, or the server served a stale snapshot. */
+  retained: boolean;
+}
+
+export function marketHeatmapEvidence({ tab, tiles, assets, grouped, loading, retained }: HeatmapEvidenceInput): MarketHeatmapEvidence {
+  const drawn = new Set(tiles.map((tile) => tile.item.id));
+  const sectors = grouped
+    ? new Set(tiles.flatMap((tile) => (tile.item.data.sector ? [tile.item.data.sector] : []))).size
+    : 0;
+  const moved = assets.filter((asset) => drawn.has(asset.symbol) && heatmapMove(asset) != null).length;
+  return {
+    kind: "market-heatmap",
+    version: 1,
+    complete: !loading && !retained && moved > 0,
+    plottedValueCount: tiles.length,
+    tab,
+    tiles: tiles.length,
+    sectors,
+    moved,
+  };
+}
+
+export function useMarketHeatmapEvidence(input: HeatmapEvidenceInput) {
+  useRemoteUiNode({
+    role: "chart-data",
+    label: "Rendered market heatmap",
+    // The capture waits for a board that is still loading.
+    getMetadata: () => ({ ...marketHeatmapEvidence(input), ready: !input.loading }),
+  });
+}
+
+const isCount = (value: unknown): value is number => Number.isSafeInteger(value) && (value as number) >= 0;
+
+export const marketHeatmapScreenshotEvidence: PaneScreenshotEvidenceHook<MarketHeatmapEvidence> = {
+  paneId: "market-heatmap",
+  kind: "market-heatmap",
+  label: "market heatmap",
+  read(value) {
+    if (!isRecord(value) || value.kind !== "market-heatmap" || value.version !== 1 || typeof value.complete !== "boolean"
+      || !isCount(value.plottedValueCount) || value.tiles !== value.plottedValueCount
+      || value.tab !== heatmapTabId(typeof value.tab === "string" ? value.tab : null)
+      || !isCount(value.sectors) || value.sectors > value.tiles
+      || !isCount(value.moved) || value.moved > value.tiles
+      || (value.complete && value.moved === 0)) return null;
+    return value as unknown as MarketHeatmapEvidence;
+  },
+  mismatches(evidence, { resolved, payload }) {
+    const settings = payload.config.layout.instances.find((entry) => entry.instanceId === payload.paneId)?.settings;
+    const asked = settings?.universe ?? resolved.options.universe;
+    return evidence.tab === heatmapTabId(typeof asked === "string" ? asked : null) ? [] : ["Heat map tab differs from the request"];
+  },
+  unavailable(evidence) {
+    return evidence?.complete ? [] : ["market heatmap"];
+  },
+  symbols() {
+    return [];
+  },
+};