gloomberb 0.19.0 → 0.19.2

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

@@ -36,10 +36,12 @@ import {
   FILTER_CYCLE,
   attachEconCalendarPersistence,
   actualColor,
+  awaitsConsensus,
   calendarDisplayRows,
   CALENDAR_TIME_ZONE_LABEL,
   dateKey,
   dayLabel,
+  econEventName,
   filteredEmptyTitle,
   formatStaleness,
   getCalendarCache,
@@ -50,6 +52,7 @@ import {
   eventCountry,
   matchesCountry,
   matchesImpact,
+  NO_CONSENSUS_NOTE,
   noScheduledReleasesMessage,
   parseCountryFilter,
   resetEconCalendarPersistence,
@@ -322,7 +325,7 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
     : formatCountdown(nextEvent.date.getTime() - now);
   // The countdown changes every tick, so it is footer status, not query bar
   // context; the footer ellipsizes a long event name.
-  const nextText = nextEvent && nextCountdown ? `next ${nextEvent.event} ${nextCountdown}` : null;
+  const nextText = nextEvent && nextCountdown ? `next ${econEventName(nextEvent)} ${nextCountdown}` : null;
   // The cached first paint is being replaced; its age only counts once a load has answered.
   const showStale = stale && (!loading || calendar.updatedAt !== null);
   // An empty list says it in its empty state instead.
@@ -330,6 +333,9 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
   // What the High filter, where the calendar opens, leaves out, and the key that lists it (Shift+F steps back to All).
   const hiddenCount = useMemo(() => lowerImpactHidden(events, impactFilter, countryFilter), [countryFilter, events, impactFilter]);
   const hiddenStatus = hiddenCount > 0 && !detailEvent ? `${hiddenCount} lower-impact hidden` : null;
+  // The dash under Forecast on the row in hand, while its consensus is not in yet.
+  const focusedEvent = detailEvent ?? filtered[selectedIdx];
+  const noConsensus = !!focusedEvent && awaitsConsensus(focusedEvent);
   const calendarStatus = useMemo<PaneFooterSegment[]>(() => [
     ...(hiddenStatus ? [{
       id: "hidden-impact",
@@ -341,8 +347,11 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
     ...(nextText && !detailEvent ? [{ id: "next", parts: [{ text: nextText, tone: "muted" as const }] }] : []),
     ...(listedAfterStatus ? [{ id: "listed-after", parts: [{ text: listedAfterStatus, tone: "warning" as const }] }] : []),
     ...(showStale ? [{ id: "stale", parts: [{ text: "STALE", tone: "warning" as const }] }] : []),
+    // Behind the warnings, so a narrow footer gives it up before them, and ahead of the update time, which goes first.
+    ...(noConsensus ? [{ id: "no-consensus", parts: [{ text: NO_CONSENSUS_NOTE, tone: "muted" as const }],
+      variants: [[{ text: "no consensus yet", tone: "muted" as const }]] }] : []),
     ...(staleness ? [{ id: "updated", parts: [{ text: staleness, tone: "muted" as const }] }] : []),
-  ], [detailEvent, hiddenStatus, listedAfterStatus, nextText, showStale, staleness]);
+  ], [detailEvent, hiddenStatus, listedAfterStatus, nextText, noConsensus, showStale, staleness]);
   // A report of the pane (`gloom fn ECO`) says it too.
   const listedThrough = listedEnd ? dateKey(listedEnd) : null;
   useRemoteUiNode(listedAfter && listedThrough ? {
@@ -433,7 +442,7 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
         return withCountryFlag({ text: country, color: colors.textMuted }, country, flagged);
       }
       case "event":
-        return { text: ev.event, color: colors.text };
+        return { text: econEventName(ev), color: colors.text };
       case "actual":
         return {
           text: ev.actual ?? "—",
@@ -480,7 +489,7 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
       focused={focused}
       detailOpen={!!detailEvent}
       onBack={() => setOpenKey(null)}
-      detailTitle={detailEvent?.event}
+      detailTitle={detailEvent ? econEventName(detailEvent) : undefined}
       detailContent={detailContent}
       rootWidth={width}
       rootHeight={Math.max(1, height - 1)}
@@ -576,7 +585,7 @@ export const economicCalendarModule: PluginModule = {
     description: "Upcoming economic events, releases, and indicators.",
     // "econ" stays a keyword so the old ECON prefix still finds this pane.
     keywords: ["econ", "economic", "calendar", "events", "macro", "releases", "fed", "cpi", "gdp", "rate decision", "ipca",
-      "brazil inflation", "pmi", "ism", "purchasing managers", "flash pmi"],
+      "brazil inflation", "pmi", "ism", "purchasing managers", "flash pmi", "jobs report", "nfp", "payrolls", "nonfarm"],
     // ECO MX,BR opens the calendar on those countries.
     shortcut: {
       prefix: "ECO",

package/src/plugins/builtin/econ/print-watch.ts

@@ -1,5 +1,6 @@
 import type { GloomPluginContext } from "../../../types/plugin";
 import {
+  econEventName,
   eventCountry,
   getCalendarCache,
   landedHighImpactPrints,
@@ -57,7 +58,8 @@ const DEFAULT_DEPS: PrintWatchDeps = {
 };
 
 function printBody(event: EconEvent): string {
-  return event.forecast ? `${event.event} ${event.actual} vs ${event.forecast}` : `${event.event} ${event.actual}`;
+  const name = econEventName(event);
+  return event.forecast ? `${name} ${event.actual} vs ${event.forecast}` : `${name} ${event.actual}`;
 }
 
 type PrintWatchContext = Pick<GloomPluginContext, "notify" | "showPane">;

package/src/plugins/builtin/econ-statistics/client.ts

@@ -101,6 +101,17 @@ function bundleFrom(unaligned: StatBuild[], errors: string[]): StatsBundle {
   };
 }
 
+/**
+ * The bundle's errors less the refresh failures of statistics the copy an
+ * earlier read saved answered for: those say when that copy is from instead.
+ */
+export function unansweredErrors(bundle: StatsBundle): string[] {
+  const answered = new Set(bundle.builds.flatMap(({ stat, cache }) => (
+    cache?.source === "stale-fallback" && cache.refreshError ? [`${stat.seriesId}: ${cache.refreshError}`] : []
+  )));
+  return bundle.errors.filter((error) => !answered.has(error));
+}
+
 /** Builds whatever the on-disk cache can already answer, for an instant first paint. */
 export function getCachedStatsBundle(stats: readonly StatDef[] = STATS): StatsBundle | null {
   const builds: StatBuild[] = [];

package/src/plugins/builtin/econ-statistics/headless.ts

@@ -3,6 +3,7 @@ import type {
   HeadlessPaneDefinition,
   HeadlessPaneEntry,
 } from "../../../types/plugin";
+import { servedFromSavedCopy } from "../../../data/saved-copies";
 import { fredSourceLabel } from "../../../sources/gloomberb-cloud/fred-series";
 import { formatBasisPoints, toBasisPoints } from "../../../utils/basis-points";
 import { formatNumber } from "../../../utils/format";
@@ -10,6 +11,7 @@ import type { StatDef } from "./defs";
 import {
   createStatSeriesLoader,
   loadStatsBundle,
+  unansweredErrors,
   type StatsBundle,
 } from "./client";
 import { historyStartNotice } from "../shared/history-span";
@@ -84,6 +86,11 @@ function detailEntries(view: StatViewModel, cutoffShown: boolean, text: boolean)
   ];
 }
 
+/** A statistic answered from the copy saved by an earlier read, its refresh having failed, says so in its row. */
+function savedCopyRow<T extends object>(view: StatViewModel, row: T): T {
+  return view.cacheSource === "stale-fallback" && view.fetchedAt != null ? servedFromSavedCopy(row, view.fetchedAt) : row;
+}
+
 /** The window the %ile column counts over, in words. */
 const PERCENTILE_WINDOW: Record<StatRangeId, string> = {
   "5Y": "the last 5 years",
@@ -163,7 +170,7 @@ export function projectStatsHeadlessBundle(
       textColumns: columns(true),
       // `as_of` is the release; a figure with none stated is as of its own day when it is observed daily or weekly, never its period's first day.
       rowAsOfKey: "exportAsOf",
-      rows: categoryViews.map((view) => ({
+      rows: categoryViews.map((view) => savedCopyRow(view, {
         id: view.stat.id,
         indicator: view.stat.shortLabel,
         latest: view.latest.value,
@@ -208,7 +215,8 @@ export function projectStatsHeadlessBundle(
         ...exportDating(selected),
       }] : []),
     ],
-    errors: bundle.errors,
+    // A statistic answered from its saved copy says so in the source line, not as an error.
+    errors: unansweredErrors(bundle),
     notes: [
       `%ile is the share of past readings at or below the latest one, over ${PERCENTILE_WINDOW[range]}.`
       + (range === "ALL" ? "" : " Full history: --range ALL."),

package/src/plugins/builtin/econ-statistics/pane.tsx

@@ -12,8 +12,9 @@ import type { PaneProps } from "../../../types/plugin";
 import { formatNumber } from "../../../utils/format";
 import { useAutoRefresh } from "../../../react/auto-refresh";
 import { usePaneStatusFooter } from "../../../components/layout/pane/status-footer";
+import { savedCopyFooterSegment } from "../../../components/layout/pane/footer";
 import { SeriesListDetail, useSeriesList } from "../shared/series-list-detail";
-import { getCachedStatsBundle, loadStatsBundle } from "./client";
+import { getCachedStatsBundle, loadStatsBundle, unansweredErrors } from "./client";
 import { categoryLabel, changeColor, type StatCategoryId } from "./defs";
 import { StatDetail } from "./detail";
 import { DEFAULT_STAT_ID } from "./stats";
@@ -145,7 +146,7 @@ export function EconStatisticsPane({ focused, width, height }: PaneProps) {
   const { selected, searchFocused } = list;
   const rows = useMemo(() => withCategoryHeaders(list.visible), [list.visible]);
 
-  const error = resource.error ?? bundle?.errors[0] ?? null;
+  const error = resource.error ?? (bundle ? unansweredErrors(bundle)[0] : null) ?? null;
   const footerInfo = useMemo<PaneFooterSegment[]>(() => {
     if (!selected) return [];
     // A Treasury yield names when in the day it was taken, as GC does, so it is not read against ^TNX's earlier close.
@@ -153,11 +154,14 @@ export function EconStatisticsPane({ focused, width, height }: PaneProps) {
     const info: PaneFooterSegment[] = [
       { id: "as-of", parts: [{ text: `reading for ${cutoff ? selected.reading : selected.readingReleased}${cutoff}`, tone: "muted" }] },
     ];
-    // The cached first paint is being replaced; its age only counts once that load fails.
+    // The cached first paint is being replaced; its age only counts once that load fails, and then it is the
+    // copy an earlier read saved, which says when that was.
     const seeding = resource.loading && resource.updatedAt === null && !selected.refreshError;
-    if (selected.observationStale || (selected.cacheStale && !seeding)) {
+    const savedAt = selected.cacheSource === "stale-fallback" ? selected.fetchedAt : null;
+    if (selected.observationStale || (selected.cacheStale && !seeding && savedAt == null)) {
       info.push({ id: "stale", parts: [{ text: "STALE", tone: "warning", bold: true }] });
     }
+    if (savedAt != null) info.push(savedCopyFooterSegment("saved-copy", savedAt));
     return info;
   }, [resource.loading, resource.updatedAt, selected]);
 

package/src/plugins/builtin/econ-statistics/stats.ts

@@ -144,6 +144,9 @@ export const STATS: readonly StatDef[] = [
     reference: { value: 0, label: "flat" },
     staleAfterMs: MONTHLY_EARLY,
     note: "Jobs added or lost last month, the single most watched release.",
+    // The jobs report as it is called: `ECST nfp` opens it.
+    aliases: ["nfp", "nonfarm", "nonfarm payrolls", "jobs report"],
+    keywords: ["jobs report", "nfp", "nonfarm"],
     limit: 900,
   }),
   stat({

package/src/plugins/builtin/executives/data.ts

@@ -3,7 +3,7 @@ import {
   type CloudProxyStatementListPayload,
   type CloudProxyStatementPayload,
 } from "../../../api-client";
-import { ApiRequestError, isPermanentClientError } from "../../../api-client/errors";
+import { ApiRequestError, isPermanentClientError, isTransientFailure } from "../../../api-client/errors";
 import type { IssuerListingParams } from "../../../api-client/paths";
 import type { PluginPersistence } from "../../../types/plugin";
 import { secListingKey } from "../../../utils/sec";
@@ -46,6 +46,8 @@ interface ProxyResult<T> {
   /** Null is an explicit 404, not a transient failure or access denial. */
   data: T | null;
   fetchedAt: number | null;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
 }
 type ActiveRequest<T> = { store: PluginPersistence | null; promise: Promise<ProxyResult<T>> };
@@ -105,11 +107,14 @@ function loadCached<T>(
       }
       throw error;
     }
+    // A saved copy answers only for a failure asking again may get past, not for a reply that fails validation.
+    if (!isTransientFailure(error)) throw error;
     const fallback = store?.getResource<T>(kind, key, { ...options, allowExpired: true });
     if (!fallback || tierOf(fallback.value) !== tier) throw error;
     return {
       data: fallback.value,
       fetchedAt: fallback.fetchedAt,
+      savedAt: fallback.fetchedAt,
       refreshError: (error instanceof Error ? error.message : String(error)).trim() || "Request failed",
     };
   }).finally(() => { if (active.get(activeKey) === request) active.delete(activeKey); });

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

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

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

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

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

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

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

@@ -1,4 +1,5 @@
 import { resolvePlanAccess } from "../../../api-client/plan-rules";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import { apiClient } from "../../../api-client";
 import type { GpuBoardPayload, GpuEventsPayload, GpuHistoryPayload, GpuHistoryQuery, GpuObservation } from "../../../api-client/gpu";
 import { createPluginCache } from "../../../data/plugin-cache";
@@ -94,7 +95,9 @@ export async function fetchGpuBoard(client: Pick<GpuApi, "getCloudGpuBoard"> = a
   try { payload = await client.getCloudGpuBoard(); }
   catch (error) { throw unavailableOnServer(error, GPU_NOT_AVAILABLE, [404, 503]); }
   const board = validateBoard(payload);
-  if (board.status === "unavailable" || !board.rows.length) throw new Error(GPU_NOT_AVAILABLE);
+  // The server's source did not answer this time: a saved copy answers, as it does a 5xx.
+  if (board.status === "unavailable") throw sourceDidNotAnswer(GPU_NOT_AVAILABLE);
+  if (!board.rows.length) throw new Error(GPU_NOT_AVAILABLE);
   return board;
 }
 

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

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

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

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { formatActionChords, hasKeybindingCaptureRequest, subscribeKeybindingCapture, useKeybindings } from "../../../app/keybindings";
-import { Notice, Section, SectionHeading, usePaneFooter, usePaneMenuItems, usePaneTabs, type PaneHint, type TableSection } from "../../../components";
+import { Notice, usePaneFooter, usePaneMenuItems, usePaneTabs, type PaneHint, type TableSection } from "../../../components";
 import { t, tf } from "../../../i18n";
 import { colors } from "../../../theme/colors";
 import type { PaneProps } from "../../../types/plugin";
@@ -18,6 +18,7 @@ import { FunctionsTable } from "./functions-table";
 import { KeybindingsEditor } from "./keybindings-editor";
 import { ShortcutTable, type ShortcutTableEntry } from "./shortcut-table";
 import { resolveCommandShortcuts, resolveWindowTemplates } from "./shortcut-model";
+import { badgeColumnWidth } from "./table-cells";
 
 const HELP_TABS = [
   { label: "Basics", value: "basics" },
@@ -47,6 +48,9 @@ const TRY_THESE = [
   { query: "EE TSLA", description: "What analysts expect from Tesla" },
 ] as const;
 
+/** The most of a table its key column takes, however many chips a row carries. */
+const KEY_COLUMN_MAX_SHARE = 0.4;
+
 function HelpPane({ focused, width, height }: PaneProps) {
   const registry = getSharedRegistry();
   const { openCommandBar, showPane, createPaneFromTemplate } = usePluginAppActions();
@@ -83,7 +87,7 @@ function HelpPane({ focused, width, height }: PaneProps) {
   // The UPGRADE line says how long the trial is; the length comes from /pricing.
   const [pricing, setPricing] = useState<CloudPricing | null>(null);
   useEffect(() => {
-    if (activeTabId !== "basics" || pricing) return;
+    if (activeTabId !== "reference" || pricing) return;
     let live = true;
     void apiClient.getCloudPricing()
       .then((next) => {
@@ -131,10 +135,11 @@ function HelpPane({ focused, width, height }: PaneProps) {
   // Each tab's actions. `l` moves between tabs, so layout actions take `a`.
   const tabHints = useMemo<PaneHint[]>(() => {
     if (activeTabId === "basics") {
-      return [
-        { id: "docs", key: "d", label: "ocs", title: "Open Docs", onPress: openDocs },
-        { id: "layout-actions", key: "a", label: " layout actions", title: "Layout Actions", onPress: openLayoutActions },
-      ];
+      return [{ id: "docs", key: "d", label: "ocs", title: "Open Docs", onPress: openDocs }];
+    }
+    // The layout rows are here, so their action is.
+    if (activeTabId === "reference") {
+      return [{ id: "layout-actions", key: "a", label: " layout actions", title: "Layout Actions", onPress: openLayoutActions }];
     }
     if (activeTabId === "functions") {
       return [{ id: "plugins", key: "p", label: "lugins", title: "Manage Plugins", onPress: openPluginManager }];
@@ -192,32 +197,31 @@ function HelpPane({ focused, width, height }: PaneProps) {
     ].filter((item) => hasCode(item.badges[0]!)),
   }], [hasCode]);
 
-  const commandBarSections = useMemo<Array<TableSection<ShortcutTableEntry>>>(() => [{
-    label: "Command Bar",
-    items: [
-      ...(commandBarBadges.length > 0
-        ? [entry("open", commandBarBadges, "Open command mode for actions, pane commands, and typed prefixes.")]
-        : []),
-      ...(tickerSearchBadges.length > 0
-        ? [entry("ticker-search", tickerSearchBadges, "Open ticker search directly.")]
-        : []),
-      entry("des", ["DES", "<ticker>"], "Open security details for a specific ticker."),
-      entry("help-card", ["HELP", "<function>"], "Open a function's help card: what it shows, its keys, how fresh its data is. HELP HELP reaches support."),
-      entry("docs", ["DOCS", "<function>"], "Read the docs and Academy lessons in the app. The ? on a pane opens its entry."),
-      entry("upgrade", ["UPGRADE"], tf("Go Pro for real-time data at gloom.sh/cloud, free for {days} days.", { days: trialDays })),
-      entry("mcp", ["MCP"], "Connect Claude Code, Codex, Cursor or any MCP client to Gloom's research tools."),
-      entry("move", ["Up/Down", "Ctrl+P/N"], "Move through command bar results."),
-      entry("page", ["PageUp/PageDown", "Ctrl+Home/End"], "Jump a page, or to the first or last result."),
-      entry("run", ["Enter", "Shift+Enter"], "Run the selected result or its secondary action."),
-      entry("accept-arg", ["Tab"], "Accept a suggested command argument when one is available."),
-      entry("close", ["Esc", ...tickerSearchBadges.filter((badge) => badge === "`" || badge.includes("+"))], "Close the command bar."),
-      entry("clear", ["Ctrl+U"], "Clear command text."),
-      entry("delete-word", ["Ctrl+W"], "Delete the previous word in command text."),
-      entry("back", ["Backspace"], "Go back from a nested command screen when the query is empty."),
-    ],
-  }], [commandBarBadges, tickerSearchBadges, trialDays]);
-
   const referenceSections = useMemo<Array<TableSection<ShortcutTableEntry>>>(() => [
+    {
+      label: "Command Bar",
+      items: [
+        ...(commandBarBadges.length > 0
+          ? [entry("cmd-open", commandBarBadges, "Open command mode for actions, pane commands, and typed prefixes.")]
+          : []),
+        ...(tickerSearchBadges.length > 0
+          ? [entry("cmd-ticker-search", tickerSearchBadges, "Open ticker search directly.")]
+          : []),
+        entry("cmd-des", ["DES", "<ticker>"], "Open security details for a specific ticker."),
+        entry("cmd-help-card", ["HELP", "<function>"], "Open a function's help card: what it shows, its keys, how fresh its data is. HELP HELP reaches support."),
+        entry("cmd-docs", ["DOCS", "<function>"], "Read the docs and Academy lessons in the app. The ? on a pane opens its entry."),
+        entry("cmd-upgrade", ["UPGRADE"], tf("Go Pro for real-time data at gloom.sh/cloud, free for {days} days.", { days: trialDays })),
+        entry("cmd-mcp", ["MCP"], "Connect Claude Code, Codex, Cursor or any MCP client to Gloom's research tools."),
+        entry("cmd-move", ["Up/Down", "Ctrl+P/N"], "Move through command bar results."),
+        entry("cmd-page", ["PageUp/PageDown", "Ctrl+Home/End"], "Jump a page, or to the first or last result."),
+        entry("cmd-run", ["Enter", "Shift+Enter"], "Run the selected result or its secondary action."),
+        entry("cmd-accept-arg", ["Tab"], "Accept a suggested command argument when one is available."),
+        entry("cmd-close", ["Esc", ...tickerSearchBadges.filter((badge) => badge === "`" || badge.includes("+"))], "Close the command bar."),
+        entry("cmd-clear", ["Ctrl+U"], "Clear command text."),
+        entry("cmd-delete-word", ["Ctrl+W"], "Delete the previous word in command text."),
+        entry("cmd-back", ["Backspace"], "Go back from a nested command screen when the query is empty."),
+      ],
+    },
     {
       label: "Navigation",
       items: [
@@ -235,7 +239,8 @@ function HelpPane({ focused, width, height }: PaneProps) {
         entry("search", ["/"], "Search in the focused pane."),
         entry("sidebar", ["<", ">"], "Narrow or widen the list beside the content, as in MAP and ASKG."),
         entry("warnings", ["!"], "Open the focused pane's data warnings."),
-        entry("notification", [...actionBadges("notification-action"), ...actionBadges("notification-dismiss")], "Run or dismiss the newest notification."),
+        entry("notification", actionBadges("notification-action"), "Run the newest notification."),
+        entry("notification-dismiss", actionBadges("notification-dismiss"), "Dismiss the newest notification."),
       ],
     },
     {
@@ -303,6 +308,14 @@ function HelpPane({ focused, width, height }: PaneProps) {
         entry("close-pane", ["Esc", "Esc"], "Close the focused pane when nothing is being dragged."),
       ],
     },
+    {
+      // Docked panes keep the saved layout and floating ones follow the pointer; the keyboard's way is Window Mode below.
+      label: "Layout",
+      items: [
+        entry("layout-drag", ["Drag"], "Floating panes can be dragged by the title bar and resized from the lower-right corner."),
+        { ...entry("layout-actions", ["LMA"], "Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets."), run: openLayoutActions },
+      ],
+    },
     {
       label: "Window Mode",
       items: [
@@ -320,7 +333,14 @@ function HelpPane({ focused, width, height }: PaneProps) {
         entry("commit", ["Enter", "Esc"], "Commit pending changes or exit window mode."),
       ],
     },
-  ], [askBadges, copyBadges, functionHelpBadges, pasteBadges, windowMoveBadges, windowResizeBadges]);
+  ], [askBadges, commandBarBadges, copyBadges, functionHelpBadges, openLayoutActions, pasteBadges, tickerSearchBadges, trialDays, windowMoveBadges, windowResizeBadges]);
+
+  // One key column for every key table in Help, wide enough for the longest group of chips, so the descriptions
+  // line up from table to table. A narrow pane caps it, and a row past the cap shows the chips that fit whole.
+  const keyColumnWidth = useMemo(() => badgeColumnWidth(
+    [...trySections, ...startSections, ...referenceSections].flatMap((section) => section.items.map((item) => item.badges)),
+    { min: 8, max: Math.max(8, Math.floor(width * KEY_COLUMN_MAX_SHARE)) },
+  ), [referenceSections, startSections, trySections, width]);
 
   const renderContent = () => {
     switch (activeTabId) {
@@ -339,38 +359,19 @@ function HelpPane({ focused, width, height }: PaneProps) {
           <>
             {trySections.length > 0 && (
               <Box marginBottom={1}>
-                <ShortcutTable sections={trySections} width={bodyWidth} keyLabel="TYPE" descriptionLabel="OPENS" />
+                <ShortcutTable sections={trySections} width={bodyWidth} keyWidth={keyColumnWidth} keyLabel="TYPE" descriptionLabel="OPENS" />
               </Box>
             )}
 
-            <Box flexDirection="column" gap={1}>
-              <SectionHeading title="How To Use Gloom" />
-              <Box flexDirection="column">
-                <Text fg={colors.textDim} wrapText>{t("Click anything to use it; the keys shown beside actions are shortcuts.")}</Text>
-                <Text fg={colors.textDim} wrapText>
-                  {commandBarBadges[0]
-                    ? tf("Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.", { key: commandBarBadges[0] })
-                    : t("Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.")}
-                </Text>
-              </Box>
-            </Box>
+            <Text fg={colors.textDim} wrapText>
+              {commandBarBadges[0]
+                ? tf("Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.", { key: commandBarBadges[0] })
+                : t("Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.")}
+            </Text>
 
             <Box marginTop={1}>
-              <ShortcutTable sections={startSections} width={bodyWidth} />
+              <ShortcutTable sections={startSections} width={bodyWidth} keyWidth={keyColumnWidth} />
             </Box>
-
-            <Box marginTop={1}>
-              <ShortcutTable sections={commandBarSections} width={bodyWidth} />
-            </Box>
-
-            <Section title="Layout Basics">
-              <Text fg={colors.text}>{t("Docked panes stay in the saved layout.")}</Text>
-              <Text fg={colors.text} wrapText>{t("Floating panes can be dragged by the title bar and resized from the lower-right corner.")}</Text>
-              {windowMoveBadges[0] && windowResizeBadges[0] && (
-                <Text fg={colors.text} wrapText>{tf("From the keyboard, {move} moves the focused window and {resize} resizes it.", { move: windowMoveBadges[0], resize: windowResizeBadges[0] })}</Text>
-              )}
-              <Text fg={colors.text} wrapText>{t("Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets.")}</Text>
-            </Section>
           </>
         );
     }
@@ -396,6 +397,7 @@ function HelpPane({ focused, width, height }: PaneProps) {
         <ShortcutTable
           sections={referenceSections}
           width={width}
+          keyWidth={keyColumnWidth}
           height={contentHeight}
           after={(
             <Box paddingX={1} flexShrink={0}>

package/src/plugins/builtin/help/shortcut-table.tsx

@@ -22,7 +22,7 @@ import {
 import { t } from "../../../i18n";
 import { useThemeColors } from "../../../theme/theme-context";
 import { Box, useUiCapabilities } from "../../../ui";
-import { badgeCell, badgeColumnWidth } from "./table-cells";
+import { badgeCell } from "./table-cells";
 
 export interface ShortcutTableEntry {
   id: string;
@@ -38,6 +38,7 @@ type ShortcutRow = SectionedRow<ShortcutTableEntry>;
 export function ShortcutTable({
   sections,
   width,
+  keyWidth,
   height: fillHeight,
   after,
   keyLabel = "KEY",
@@ -46,6 +47,8 @@ export function ShortcutTable({
   sections: ReadonlyArray<TableSection<ShortcutTableEntry>>;
   /** Content width available inside the tab body. */
   width: number;
+  /** The key column's width, one for every table in Help so their descriptions line up. */
+  keyWidth: number;
   /** Fill this many rows and scroll, instead of growing to fit every row. */
   height?: number;
   /** Sits under a full-height table inside the same frame. */
@@ -59,10 +62,6 @@ export function ShortcutTable({
     () => buildSectionedRows(sections, (entry) => entry.id),
     [sections],
   );
-  const keyWidth = useMemo(
-    () => badgeColumnWidth(rows.filter(isSectionedItemRow).map((row) => row.item.badges), { min: 8, max: 24 }),
-    [rows],
-  );
   const columns = useMemo<ShortcutColumn[]>(() => [
     { id: "key", label: keyLabel, width: keyWidth, align: "left" },
     { id: "description", label: descriptionLabel, width: 20, align: "left", flexGrow: 1 },
@@ -72,7 +71,7 @@ export function ShortcutTable({
     if (!isSectionedItemRow(row)) return EMPTY_TABLE_CELL;
     const run = row.item.run;
     const cell: DataTableCell = column.id === "key"
-      ? badgeCell(row.item.badges, column.width)
+      ? badgeCell(row.item.badges, column.width, { wholeOnly: true })
       : { text: t(row.item.description), color: colors.text };
     if (!run) return cell;
     return {