gloomberb 0.18.2 → 0.18.4

package/src/cli/index.ts

@@ -20,11 +20,13 @@ import {
   type CliHelpEntry,
 } from "./help";
 import { parsePaneFunctionArgs, SHOT_SIZE_LIMITS } from "./pane-functions/options";
-import { checkCliCommandOptions } from "./command-options";
+import { checkCliCommandOptions, foldCommandArgs } from "./command-options";
+import { foldTypedText } from "../utils/typed-text";
 import { CLI_EXIT_CODES } from "./exit-codes";
 import { asUsageError, fail, inferCliErrorOptions, printCliError } from "./errors";
-import { cliStyles, setCliColorEnabledOverride, setCliWidthOverride } from "../utils/cli-output";
+import { cliStyles, setCliColorEnabledOverride, setCliPlainOverride, setCliWidthOverride } from "../utils/cli-output";
 import { setDisplayTimeZone } from "../utils/utc-time";
+import { collectSavedCopies } from "../data/saved-copies";
 import { search, searchCandidatesForCli, buildSearchReport } from "./commands/search";
 import { ticker } from "./commands/ticker";
 import { requireOneArg, takeFlag, takeOption } from "./commands/command-utils";
@@ -92,7 +94,7 @@ export function createCoreCliCommands(
     {
       name: "launch-ui",
       aliases: ["ui"],
-      description: "Open the terminal UI, like plain gloomberb",
+      description: "Open the terminal UI, like plain gloom",
       help: {
         group: CLI_COMMAND_GROUPS.app,
         usage: ["launch-ui"],
@@ -174,7 +176,7 @@ export function createCoreCliCommands(
         group: CLI_COMMAND_GROUPS.functions,
         usage: ["fn <function> [argument] [options]"],
         options: [
-          { flags: "--<option> <value>", description: "A function setting; gloomberb catalog <function> lists them" },
+          { flags: "--<option> <value>", description: "A function setting; gloom catalog <function> lists them" },
           { flags: "--require-bot-safe", description: "Fail unless the function has a verified, complete report" },
           { flags: "--explain", description: "Follow the report with what its terms mean (text and JSON; CSV keeps the rows)" },
           {
@@ -190,8 +192,16 @@ export function createCoreCliCommands(
           "fn WEI --csv --section europe > europe.csv",
           "fn 13F AAPL --view=ticker-holdings",
           "fn OVME --spot 100 --strike 100 --days 30 --volatility 25",
+          "fn HIVG SPY --event fomc --offset -6 --lookback ALL --csv",
           "fn AUCT --explain",
         ],
+        sections: [{
+          title: "Exit status",
+          lines: [
+            "0 when the report has data for what was asked, partial data with warnings about the rest included; 1 when it has none (an empty report, or rows with no value for a listing that has nothing) or the input is bad. --json ok is false exactly when the exit status is 1.",
+            "CSV headers are the same for every symbol: a reason a figure is missing goes to the status column, never into a number cell.",
+          ],
+        }],
       },
       execute: async (args, ctx) => {
         requirePaneFunctionTarget(args, "fn", ctx);
@@ -209,12 +219,12 @@ export function createCoreCliCommands(
           { flags: "--output <path>", description: "PNG to write; defaults to gloomberb-<function>-<argument>.png in this folder" },
           { flags: "--width <px>", description: `Layout width, ${SHOT_WIDTH.min} to ${SHOT_WIDTH.max} (default 1280). The PNG is drawn at twice the size: ${SHOT_WIDTH.min * 2} to ${SHOT_WIDTH.max * 2} px wide` },
           { flags: "--height <px>", description: `Layout height, ${SHOT_HEIGHT.min} to ${SHOT_HEIGHT.max} (default 720), so ${SHOT_HEIGHT.min * 2} to ${SHOT_HEIGHT.max * 2} px tall` },
-          { flags: "--theme <id>", description: "Render with another theme, such as amber or colorblind; gloomberb config themes lists them" },
+          { flags: "--theme <id>", description: "Render with another theme, such as amber or colorblind; gloom config themes lists them" },
           { flags: "--scale <n>", description: "Text scale from 0.5 to 4 (default 1)" },
           { flags: "--watermark <label>", description: "Label drawn in the pane title bar" },
           { flags: "--no-status", description: "Leave out the dated status line (as-of, delay, market hours) drawn in the pane footer" },
           { flags: "--strict", description: `Exit ${CLI_EXIT_CODES.unusableShot} when the pane is empty, shows an error, is still loading or is access-gated; the PNG and the Reason line are still written` },
-          { flags: "--<option> <value>", description: "A function setting; gloomberb catalog <function> lists them" },
+          { flags: "--<option> <value>", description: "A function setting; gloom catalog <function> lists them" },
           EXCHANGE_OPTION,
         ],
         examples: [
@@ -257,7 +267,7 @@ export function createCoreCliCommands(
       execute: async (args) => {
         const ref = args[0];
         if (!ref) {
-          fail("Usage: gloomberb install <user/repo>");
+          fail("Usage: gloom install <user/repo>");
         }
         console.error(cliStyles.warning("Runs with your full permissions. Read the source first."));
         await installListedPlugin(ref);
@@ -270,9 +280,9 @@ export function createCoreCliCommands(
         group: CLI_COMMAND_GROUPS.plugins,
         usage: ["update [name]"],
         sections: [{
-          title: "Updating Gloomberb itself",
+          title: "Updating Gloom itself",
           lines: [
-            "The app updates itself from stable releases. config set updates.channel nightly adds the nightly build of main; see gloomberb help config.",
+            "The app updates itself from stable releases. config set updates.channel nightly adds the nightly build of main; see gloom help config.",
           ],
         }],
         examples: ["update", "update gloom-tv"],
@@ -293,7 +303,7 @@ export function createCoreCliCommands(
       execute: async (args) => {
         const name = args[0];
         if (!name) {
-          fail("Usage: gloomberb remove <name>");
+          fail("Usage: gloom remove <name>");
         }
         await removePlugin(name);
       },
@@ -319,7 +329,7 @@ function requirePaneFunctionTarget(args: string[], commandName: string, ctx: Cli
     // Intentional ignore: The pane function runner reports invalid options with its error code.
     return;
   }
-  if (!target) ctx.fail(`Usage: gloomberb ${commandName} <function> [argument] [options]`);
+  if (!target) ctx.fail(`Usage: gloom ${commandName} <function> [argument] [options]`);
 }
 
 function printHelpText(text: string, ctx: CliCommandContext): void {
@@ -387,8 +397,8 @@ function failUnknownCommand(token: string, commands: CliCommandDef[], pointers:
   const exported = suggestion ? null : exportCommandPointer(token, pointers.args);
   const catalog = suggestion ? null : exported ?? catalogPointer(token, pointers.hits, pointers.args);
   const help = suggestion
-    ? `Did you mean ${suggestion}? Run gloomberb help to see every command.`
-    : catalog ? `${catalog}\nRun gloomberb help to see every command.` : "Run gloomberb help to see every command.";
+    ? `Did you mean ${suggestion}? Run gloom help to see every command.`
+    : catalog ? `${catalog}\nRun gloom help to see every command.` : "Run gloom help to see every command.";
   fail(`Unknown command "${token}".`, ticker ? `${ticker}\n${help}` : help);
 }
 
@@ -436,13 +446,15 @@ export async function dispatchCli(args: string[], options: DispatchCliOptions =
   }
   setCliColorEnabledOverride(parsed.options.color);
   setCliWidthOverride(parsed.options.width ?? null);
+  // The CLI entry sets plain output for a pipe or NO_COLOR (entry.ts); `--plain` and `--no-plain` decide it either way.
+  if (parsed.options.plain != null) setCliPlainOverride(parsed.options.plain);
   const command = parsed.args[0] ?? (parsed.help ? "help" : undefined);
   if (!command) {
     return { kind: "unhandled" };
   }
 
   const registry = await createRegistry(options);
-  const resolved = registry.lookup.get(normalizeCliCommandToken(command));
+  const resolved = registry.lookup.get(normalizeCliCommandToken(foldTypedText(command)));
   if (!resolved) {
     return { kind: "unhandled" };
   }
@@ -452,15 +464,17 @@ export async function dispatchCli(args: string[], options: DispatchCliOptions =
   const helpOnly = parsed.help && resolved.command.name !== "help";
   const target = helpOnly ? registry.lookup.get("help")! : resolved;
   // The words after a command that runs a function name the function whose help it is (`fn BT --help`).
+  // Full-width letters and digits (ＧＭＥ, １０) are read as the ASCII they stand for, once, here.
   const commandArgs = helpOnly
-    ? [resolved.command.name, ...FUNCTION_COMMANDS.has(resolved.command.name) ? parsed.args.slice(1) : []]
-    : parsed.args.slice(1);
+    ? [resolved.command.name, ...FUNCTION_COMMANDS.has(resolved.command.name) ? foldCommandArgs(resolved.command, parsed.args.slice(1)) : []]
+    : foldCommandArgs(resolved.command, parsed.args.slice(1), parsed.literalStart - 1);
   try {
     if (!helpOnly && resolved.builtin) checkCliCommandOptions(resolved.command, commandArgs, parsed.literalStart - 1);
-    const result = await target.command.execute(
+    // What it answers from a saved copy, its refresh having failed, its closing line says.
+    const result = await collectSavedCopies(() => Promise.resolve(target.command.execute(
       commandArgs,
       createCliCommandContext(target.ownerId, registry, parsed.options, commandArgs),
-    );
+    )));
     return normalizeCliDispatchResult(result);
   } catch (error) {
     // A coin typed without its quote currency (USDT) is named by its one symbol (USDT-USD) in the hint.

package/src/cli/issuer-membership.ts

@@ -0,0 +1,103 @@
+import type { AppConfig } from "../types/config";
+import type { DataProvider } from "../types/data-provider";
+import type { TickerRecord } from "../types/ticker";
+import { canonicalExchange, isUsListingExchange, parsePublicTickerKey } from "../utils/exchanges";
+import { logFailure } from "../utils/log-failure";
+import { savedListingName } from "./listing-arg";
+
+/** A list holding the company: its name, and the other saved listing it holds the company as (null for the listing asked about). */
+export interface ListMembership {
+  name: string;
+  /** RCI.B:TSX when the list holds Rogers as its Toronto line and the report is of RCI. */
+  via: string | null;
+}
+
+export interface CompanyMemberships {
+  portfolios: ListMembership[];
+  watchlists: ListMembership[];
+}
+
+/**
+ * A listing as Gloom Cloud writes an issuer's listings: the bare ticker on a
+ * US venue or none (RCI), SYMBOL:EXCHANGE elsewhere (RCI.B:TSX), with a
+ * share class's dash or slash as a dot (BRK-B is BRK.B).
+ */
+export function issuerListingKey(symbol: string, exchange?: string): string {
+  const parsed = parsePublicTickerKey(symbol);
+  const venue = parsed.exchange ?? canonicalExchange(exchange);
+  const code = parsed.symbol.toUpperCase().replace(/[-/]/g, ".");
+  return venue && !isUsListingExchange(venue) ? `${code}:${venue}` : code;
+}
+
+function names(config: AppConfig, ids: readonly string[], kind: "portfolios" | "watchlists"): Map<string, string> {
+  const collections: ReadonlyArray<{ id: string; name: string }> = config[kind];
+  return new Map(ids.flatMap((id) => {
+    const name = collections.find((collection) => collection.id === id)?.name;
+    return name ? [[id, name] as const] : [];
+  }));
+}
+
+/**
+ * The portfolios and watchlists that hold a company, whichever of its
+ * listings they saved: the listing's own lists, then those holding another
+ * of `issuerListings` (its keys as `issuerListingKey` writes them), each
+ * once and saying which listing it holds. A restricted list holding RCI.B:TSX
+ * holds Rogers, which also trades as RCI in New York. Without the company's
+ * listings, only the listing's own lists.
+ */
+export function companyMemberships(
+  config: AppConfig,
+  own: TickerRecord | null,
+  saved: readonly TickerRecord[],
+  issuerListings: readonly string[] | null,
+): CompanyMemberships {
+  const listings = new Set(issuerListings ?? []);
+  const ownKey = own ? savedListingName(own).key : null;
+  const others = listings.size === 0 ? [] : saved.filter((ticker) =>
+    savedListingName(ticker).key !== ownKey
+    && listings.has(issuerListingKey(ticker.metadata.ticker, ticker.metadata.exchange)));
+  const collect = (kind: "portfolios" | "watchlists"): ListMembership[] => {
+    const held = new Map<string, ListMembership>();
+    for (const [id, name] of names(config, own?.metadata[kind] ?? [], kind)) held.set(id, { name, via: null });
+    for (const ticker of others) {
+      for (const [id, name] of names(config, ticker.metadata[kind], kind)) {
+        if (!held.has(id)) held.set(id, { name, via: savedListingName(ticker).key });
+      }
+    }
+    return [...held.values()];
+  };
+  return { portfolios: collect("portfolios"), watchlists: collect("watchlists") };
+}
+
+/**
+ * `companyMemberships` for a listing, asking Gloom Cloud for the company's
+ * other listings only when another saved listing is in a list at all. A
+ * failed lookup leaves the listing's own lists.
+ */
+export async function loadCompanyMemberships({
+  config,
+  own,
+  symbol,
+  exchange,
+  loadTickers,
+  dataProvider,
+}: {
+  config: AppConfig;
+  own: TickerRecord | null;
+  /** The listing the report is of, and its venue (RCI, NYSE). */
+  symbol: string;
+  exchange: string;
+  loadTickers: () => Promise<TickerRecord[]>;
+  dataProvider: Pick<DataProvider, "getIssuerListings">;
+}): Promise<CompanyMemberships> {
+  const ownKey = own ? savedListingName(own).key : null;
+  const saved = await Promise.resolve().then(loadTickers)
+    .catch(logFailure("cli.issuer-membership", "Reading saved listings failed", [] as TickerRecord[]));
+  const listed = saved.filter((ticker) => savedListingName(ticker).key !== ownKey
+    && (ticker.metadata.portfolios.length > 0 || ticker.metadata.watchlists.length > 0));
+  const { getIssuerListings } = dataProvider;
+  if (listed.length === 0 || !getIssuerListings) return companyMemberships(config, own, [], null);
+  const issuer = await Promise.resolve().then(() => getIssuerListings.call(dataProvider, symbol, exchange))
+    .catch(logFailure("cli.issuer-membership", "Reading the company's listings failed", null));
+  return companyMemberships(config, own, listed, issuer?.listings.map((listing) => issuerListingKey(listing.symbol, listing.exchange)) ?? null);
+}

package/src/cli/known-gaps.ts

@@ -1,21 +1,48 @@
 import { listingSuffixExchange } from "../sources/listing-symbols";
+import { kindFromListingSyntax } from "../tickers/instrument-kind";
 import { parsePublicTickerKey } from "../utils/exchanges";
 import { listingAbroadVenue } from "../utils/sec";
 import { nimCommand } from "./bank-section";
 import { treasuryYieldLine, treasuryYieldTenor } from "./treasury-yields";
 
+/**
+ * What a listing is to a sub-minute ask: a US listing, which has a tape; one
+ * known to trade abroad, a future, or another class a symbol's own syntax names
+ * (an index, a currency pair, a coin), none of which has trades or quotes.
+ */
+type SubMinuteListing = "unknown" | "abroad" | "future" | "other";
+
+function subMinuteListing(symbol: string): SubMinuteListing {
+  if (listedAbroad(symbol)) return "abroad";
+  const kind = kindFromListingSyntax(symbol, parsePublicTickerKey(symbol).exchange);
+  return kind === "future" ? "future" : kind ? "other" : "unknown";
+}
+
 /**
  * Where data finer than a minute is: nowhere as bars. GIP draws 1-minute
  * bars; for a US listing TAS lists each trade (a window of the session with
  * `--from`/`--to`) and QR each quote. `history --interval`, GIP's
- * `--chartResolution 1s` and QR on a listing abroad all say this; a listing
- * known to trade abroad, which has no trades on the tape, is told only the bars.
+ * `--chart-resolution 1s` and QR on a listing abroad all say this. The tape
+ * covers US equities only, and TAS and QR answer anything else with an
+ * error or an empty table, so a listing without one is told only the bars
+ * that exist for it. A future's finest are G's 1-minute bars of its session
+ * (`fn G GC=F --range-preset 1D`) and `history`'s 5-minute bars of 1D, both
+ * checked on GC=F and SI=F on 2026-10-21. GIP is not named for one: its
+ * window is the UTC day, not the session, and it was reported with no points
+ * for a future.
  */
-export function subMinuteDataMessage(symbol = "<ticker>", listing: "abroad" | "unknown" = listedAbroad(symbol) ? "abroad" : "unknown"): string {
-  const bars = `No second or tick bars; 1-minute bars: fn GIP ${symbol}`;
-  return listing === "abroad"
-    ? `${bars}; trades exist for US listings only.`
-    : `${bars}; for a US listing, each trade: fn TAS ${symbol} (a window: --from 10:30 --to 10:35), each quote: fn QR ${symbol}.`;
+export function subMinuteDataMessage(symbol = "<ticker>", listing: SubMinuteListing = subMinuteListing(symbol)): string {
+  const none = "No second or tick bars";
+  switch (listing) {
+    case "abroad":
+      return `${none}; 1-minute bars: fn GIP ${symbol}; trades exist for US listings only.`;
+    case "future":
+      return `${none}; 1-minute bars: fn G ${symbol} --range-preset 1D (history ${symbol} --range 1D has 5-minute bars). Trades and quotes cover US equities only.`;
+    case "other":
+      return `${none}; 1-minute bars: fn GIP ${symbol}. Trades and quotes cover US equities only.`;
+    default:
+      return `${none}; 1-minute bars: fn GIP ${symbol}; for a US listing, each trade: fn TAS ${symbol} (a window: --from 10:30 --to 10:35), each quote: fn QR ${symbol}.`;
+  }
 }
 
 /**
@@ -42,8 +69,8 @@ export function isSubMinuteInterval(value: string): boolean {
  * (checked 2026-10-19).
  */
 export const MUNI_LINE = "Municipal bonds: no AAA muni curve (MMD and BVAL are licensed). Muni bond funds: MUB, VTEB, TFI (national), SUB (short-term), "
-  + "CMF, VTEC (California), NYF, MUNY (New York). SEC yield, distribution yield, yield to worst and duration: gloomberb fn DVD <fund> or "
-  + "gloomberb fundamentals <fund>; tax-equivalent yield and muni/Treasury ratio: add --tax-rate 40.8 (with --state-rate 13.3 --state CA for a "
+  + "CMF, VTEC (California), NYF, MUNY (New York). SEC yield, distribution yield, yield to worst and duration: gloom fn DVD <fund> or "
+  + "gloom fundamentals <fund>; tax-equivalent yield and muni/Treasury ratio: add --tax-rate 40.8 (with --state-rate 13.3 --state CA for a "
   + "single-state fund).";
 
 /**
@@ -51,7 +78,7 @@ export const MUNI_LINE = "Municipal bonds: no AAA muni curve (MMD and BVAL are l
  * or, while no source carries it, the nearest thing the app does have, with
  * the traded proxies either way. `search` and `catalog` answer a query that
  * names one with this line instead of pointing at each other. One entry per
- * subject; every proxy named is a listing `gloomberb quote` answers (checked
+ * subject; every proxy named is a listing `gloom quote` answers (checked
  * 2026-10-11: CO2:LSE is the physical EUA ETC, while a bare CO2 is a Brent
  * future; BDRY, SBLK, GNK and DSX on 2026-10-17), a function `fn` runs, or a
  * command that answers (`news "dry bulk"`).
@@ -102,11 +129,11 @@ const KNOWN_GAPS: ReadonlyArray<{ terms: readonly string[]; tickers?: readonly s
  */
 const BANK_FIGURES_TOPIC = {
   topic: "Bank deposits, uninsured share and CRE / capital",
-  availability: "in the Bank section of gloomberb fundamentals <ticker>",
+  availability: "in the Bank section of gloom fundamentals <ticker>",
   phrases: ["nim", "nims", "net interest margin", "net interest margins", "deposits", "deposit growth", "deposit flows",
     "deposit outflows", "deposit base", "uninsured", "cre", "commercial real estate"],
   closestLabel: "net interest margin",
-  closest: [["EQS", "NIM%, Pro: gloomberb fn EQS --metric kpiNimPercent"]],
+  closest: [["EQS", "NIM%, Pro: gloom fn EQS --metric kpiNimPercent"]],
 } as const;
 
 /**
@@ -114,7 +141,7 @@ const BANK_FIGURES_TOPIC = {
  * command or a function. One example, writing a file.
  */
 function exportLine(symbol = "LMT"): string {
-  return `Export: add --csv or --json to any command to print its result as CSV or JSON, e.g. gloomberb history ${symbol} --csv > ${
+  return `Export: add --csv or --json to any command to print its result as CSV or JSON, e.g. gloom history ${symbol} --csv > ${
     symbol.toLowerCase().replace(/[^a-z0-9]+/g, "-")}.csv`;
 }
 
@@ -126,13 +153,26 @@ const EXPORT_POINTER = {
   leads: true,
 } as const;
 
+/**
+ * Bloomberg's spreadsheet formulas (BDP, BDH, BDS), Excel and Sheets: the Google Sheets functions take the same
+ * tickers and fields. Listed before the export line, so "excel" alone is this one and "export to excel" that one.
+ */
+const SHEETS_POINTER = {
+  names: ["bdh", "bdp", "bds", "excel", "sheets", "gsheets", "google sheets"],
+  words: ["formula", "formulas", "function", "functions", "add", "in", "addin", "plugin", "bloomberg", "google", "for", "with",
+    "data", "how", "to", "use", "can", "i", "a", "an", "the", "my", "spreadsheet", "spreadsheets", "workbook", "workbooks"],
+  line: "Spreadsheets: =GLOOM and =GLOOMH in Google Sheets take the tickers and fields of Bloomberg's BDP and BDH (Pro): "
+    + "gloom.sh/docs/google-sheets. For Excel, add --csv to any command.",
+  leads: true,
+} as const;
+
 /** "bank", "bank figures": beside the functions a bank's name finds (CBR), where its figures are. */
 const BANK_FIGURES_POINTER = {
   names: ["bank", "banks", "banking"],
   words: ["figures", "figure", "data", "metrics", "holding", "company", "companies", "section", "kpi", "kpis", "ratios",
     "fundamentals", "stats", "statistics", "balance", "sheet"],
-  line: "Bank figures (deposits, uninsured share, CRE / capital, lead bank): gloomberb fundamentals <ticker>, Bank section. "
-    + "Net interest margin (Pro): gloomberb fn EQS --metric kpiNimPercent",
+  line: "Bank figures (deposits, uninsured share, CRE / capital, lead bank): gloom fundamentals <ticker>, Bank section. "
+    + "Net interest margin (Pro): gloom fn EQS --metric kpiNimPercent",
 };
 
 /**
@@ -170,6 +210,27 @@ const TOPIC_POINTERS: ReadonlyArray<{
     whole: ["borrow", "borrowing", "utilization", "utilisation", "locate", "locates", "htb", "lendable shares"],
     closest: [["SI", "FINRA short interest and days to cover"], ["SIW", "crowded shorts across your names"], ["SIV", "daily short volume"]],
   },
+  {
+    // FUT and CTM list COMEX metals (HG copper, ALI aluminium), never the London or Shanghai contracts: a query naming those
+    // venues is told so, not pointed at FUT. The IMF's monthly world prices stand in for LME's (`fred PCOPPUSDM`).
+    topic: "LME and Shanghai (SHFE) metals futures",
+    availability: "not covered (FUT and CTM list COMEX contracts only). Monthly world prices in USD/t: gloom fred PCOPPUSDM, gloom fred PALUMUSDM",
+    phrases: ["lme", "london metal exchange", "london metals exchange", "shfe", "shanghai futures exchange", "shanghai futures",
+      "shanghai copper", "shanghai aluminium", "shanghai aluminum", "shanghai zinc", "shanghai nickel", "shanghai tin", "shanghai lead",
+      "shanghai rebar", "shanghai steel", "shanghai metals"],
+    closestLabel: "COMEX curves",
+    closest: [["CTM", "gloom fn CTM HG for copper, gloom fn CTM ALI for aluminium"]],
+  },
+  {
+    // "exchange reserves" alone reads as crypto's; "foreign exchange reserves" is a central bank's, so only whole.
+    topic: "Crypto exchange reserves and exchange flows",
+    availability: "not covered (no source for coins held on exchanges)",
+    phrases: ["crypto exchange reserves", "bitcoin exchange reserves", "btc exchange reserves", "eth exchange reserves",
+      "ethereum exchange reserves", "exchange inflows", "exchange outflows", "exchange netflow", "exchange netflows", "exchange net flows",
+      "coins on exchanges", "bitcoin on exchanges", "btc on exchanges"],
+    whole: ["exchange reserves", "exchange reserve", "exchange balances", "exchange balance", "exchange flows"],
+    closest: [["CRYP", "DeFi TVL by protocol and chain: gloom fn CRYP --list defi; stablecoin supply: --list stablecoin"]],
+  },
 ];
 
 /** The words of a text, lower case: `DoD-budget` and `dod budget` read alike. */
@@ -208,26 +269,50 @@ export function topicPointer(query: string): { message: string; codes: string[]
  * and `catalog` print beside whatever else the query finds. A query asks for one when every word is a word of that
  * command and one of them names it: "light theme", "dark", "colour-blind", but not "ai theme" (THEM's basket) or
  * "dark pool"; "drip", "dividend income", but not "income statement" or "net income"; "tether", "depeg",
- * "usdc peg", but not "peg ratio".
+ * "usdc peg", but not "peg ratio". A command with `qualifiers` also needs one of them once the query says more than
+ * its name: "fx forward rate", but not "forward rate".
  */
-const COMMAND_POINTERS: ReadonlyArray<{ names: readonly string[]; words: readonly string[]; line: string; leads?: true }> = [
+const COMMAND_POINTERS: ReadonlyArray<{
+  names: readonly string[];
+  words: readonly string[];
+  qualifiers?: readonly string[];
+  line: string;
+  leads?: true;
+}> = [
   BANK_FIGURES_POINTER,
+  SHEETS_POINTER,
   EXPORT_POINTER,
   {
     names: ["theme", "themes", "light", "dark", "colorblind", "colourblind", "blind"],
     words: ["mode", "color", "colour", "colors", "colours", "high", "contrast", "change", "switch", "set", "setting", "settings"],
-    line: "Themes: gloomberb config themes",
+    line: "Themes: gloom config themes",
   },
   {
     names: ["drip", "drips", "reinvest", "reinvested", "reinvesting", "reinvestment", "income"],
     words: ["dividend", "dividends", "portfolio", "my", "annual", "yearly", "passive", "projection", "project", "projected",
       "plan", "planner", "calculator", "forecast", "yield", "growth"],
-    line: "Portfolio income, yield and DRIP projection: gloomberb portfolio show <name> --drip",
+    line: "Portfolio income, yield and DRIP projection: gloom portfolio show <name> --drip",
   },
   {
     names: ["tether", "usdt", "usdc", "depeg", "depegs", "depegged", "depegging", "peg", "pegs", "pegged", "stablecoin", "stablecoins"],
     words: ["stable", "coin", "coins", "off", "check", "monitor", "watch", "scare", "risk", "dollar", "usd", "status", "price", "prices", "low"],
-    line: "Stablecoins against their peg, off peg in bp, 24h low and high: gloomberb fn CRYP --list stablecoin",
+    line: "Stablecoins against their peg, off peg in bp, 24h low and high: gloom fn CRYP --list stablecoin",
+  },
+  {
+    // A currency forward, not a forward rate on a yield curve, forward guidance, a forward P/E or the forward
+    // inflation series: a query that says more than "forward" has to name FX.
+    names: ["forward", "forwards", "fwd", "fwds"],
+    words: ["rate", "rates", "implied", "hedge", "hedging", "cost", "costs", "premium", "interest", "1w", "2w", "30d", "1m", "3m",
+      "6m", "1y"],
+    qualifiers: ["fx", "currency", "currencies", "point", "points", "pips", "cip", "covered", "parity", "outright",
+      "usd", "mxn", "eur", "gbp", "usdmxn", "eurusd", "gbpusd", "eurmxn", "peso", "dollar", "euro", "sterling"],
+    line: "FX forwards implied by both currencies' short rates (covered interest parity), with forward points and the hedge cost: gloom fx USD/MXN --forward 30d",
+  },
+  {
+    names: ["defi", "tvl", "tvls", "total value locked", "on-chain", "onchain", "aave", "lido", "eigenlayer", "morpho"],
+    words: ["protocol", "protocols", "chain", "chains", "crypto", "data", "top", "by", "history",
+      "change", "ranking", "rankings", "dashboard", "lending", "staking"],
+    line: "DeFi TVL, top protocols and chains with 7D and 30D change: gloom fn CRYP --list defi (by chain: --by chain)",
   },
 ];
 
@@ -245,7 +330,7 @@ export function commandPointerLeads(query: string): boolean {
 }
 
 /**
- * The line for a command word typed as `gloomberb export LMT`: exporting is a flag every command takes, not a
+ * The line for a command word typed as `gloom export LMT`: exporting is a flag every command takes, not a
  * command, so the example runs on the symbol typed. Null for any other word.
  */
 export function exportCommandPointer(token: string, args: readonly string[]): string | null {
@@ -254,11 +339,19 @@ export function exportCommandPointer(token: string, args: readonly string[]): st
   return exportLine(symbol);
 }
 
+/** A name of several words ("on-chain") names the command when its words run together in the query. */
 function findCommandPointer(query: string): (typeof COMMAND_POINTERS)[number] | null {
   const asked = words(query);
   if (asked.length === 0) return null;
-  return COMMAND_POINTERS.find(({ names, words: other }) => asked.some((word) => names.includes(word))
-    && asked.every((word) => names.includes(word) || other.includes(word))) ?? null;
+  return COMMAND_POINTERS.find(({ names, words: other, qualifiers = [] }) => {
+    const named = new Set(names.flatMap((name) => {
+      const parts = words(name);
+      return containsWords(asked, parts) ? parts : [];
+    }));
+    return named.size > 0
+      && asked.every((word) => named.has(word) || other.includes(word) || qualifiers.includes(word))
+      && (qualifiers.length === 0 || asked.every((word) => named.has(word)) || asked.some((word) => qualifiers.includes(word)));
+  }) ?? null;
 }
 
 /**
@@ -272,8 +365,8 @@ export function bankFigurePointer(name: string, arg: string): { message: string;
   return {
     message: `${name} is not a function: a bank's figures are in the Bank section of fundamentals.`,
     details: [
-      `Deposits, uninsured share, CRE / capital and the lead bank: gloomberb fundamentals ${symbol || "<ticker>"}`,
-      `Net interest margin (Pro): ${symbol ? nimCommand(symbol) : "gloomberb fn EQS --metric kpiNimPercent"}`,
+      `Deposits, uninsured share, CRE / capital and the lead bank: gloom fundamentals ${symbol || "<ticker>"}`,
+      `Net interest margin (Pro): ${symbol ? nimCommand(symbol) : "gloom fn EQS --metric kpiNimPercent"}`,
     ].join("\n"),
   };
 }