@gloom-sh/terminal 0.19.2 → 0.19.3

package/src/plugins/builtin/equity-screener/ideas.ts

@@ -23,7 +23,10 @@ const idea = (
   definition: { version: 1, currency: "USD", criteria: [...criteria, TRADED], sort },
 });
 
-/** Technical ideas, read at the last completed session. */
+/**
+ * Technical ideas, read at the last completed session, then fundamental ones, read on `FA`'s bases (the trailing four
+ * quarters, or the latest fiscal year when those quarters are that year) and `EE`'s consensus.
+ */
 export const SCREEN_IDEAS: ScreenIdea[] = [
   idea("oversold-uptrend", "Oversold in an uptrend", [
     { field: "rsi14", op: "lte", value: 30 },
@@ -43,6 +46,32 @@ export const SCREEN_IDEAS: ScreenIdea[] = [
     { field: "macdBullishCrossDays", op: "lte", value: 3 },
     { field: "priceVsSma200Percent", op: "gt", value: 0 },
   ], { field: "macdBullishCrossDays", direction: "asc" }),
+  // A free cash flow yield of 6% or more, about twice the S&P 500's; EV / EBITDA of 10x or less, under the index's
+  // long-run 12x or so; net debt within 3x EBITDA, about where investment grade ends, so a cheap price is not a
+  // stretched balance sheet. Highest yield first.
+  idea("value", "Value", [
+    { field: "fcfYieldPercent", op: "gte", value: 6 },
+    { field: "evToEbitda", op: "lte", value: 10 },
+    { field: "netDebtToEbitda", op: "lte", value: 3 },
+  ], { field: "fcfYieldPercent", direction: "desc" }),
+  // A return on invested capital of 15% or more, above any company's cost of capital; net debt within 2x EBITDA;
+  // revenue compounding at 5% a year or more over five years; free cash flow above zero. Highest return first.
+  idea("quality", "Quality", [
+    { field: "roicPercent", op: "gte", value: 15 },
+    { field: "netDebtToEbitda", op: "lte", value: 2 },
+    { field: "revenueCagr5YPercent", op: "gte", value: 5 },
+    { field: "fcfYieldPercent", op: "gt", value: 0 },
+  ], { field: "roicPercent", direction: "desc" }),
+  // Growth at a reasonable price: consensus EPS growth of 10% to 25% for the fiscal year in progress (Peter Lynch's
+  // range; faster rarely lasts) on a three-year record of 10% a year or more; a forward P/E of 20x or less, so the
+  // price stays within twice the growth; ROIC of 10% or more, so the growth is earned, not a recovery from a loss.
+  // Fastest growth first.
+  idea("garp", "GARP", [
+    { field: "forwardEpsGrowthPercent", op: "between", value: [10, 25] },
+    { field: "epsCagr3YPercent", op: "gte", value: 10 },
+    { field: "forwardPE", op: "lte", value: 20 },
+    { field: "roicPercent", op: "gte", value: 10 },
+  ], { field: "forwardEpsGrowthPercent", direction: "desc" }),
 ];
 
 export const screenIdea = (id: string | undefined): ScreenIdea | undefined =>

package/src/plugins/builtin/equity-screener/index.tsx

@@ -1,6 +1,5 @@
 import type { PluginModule } from "../plugin-module";
 import { equityScreenerHeadless } from "./headless";
-import { EquityScreenerPane } from "./pane";
 
 export const equityScreenerModule: PluginModule = {
   panes: [
@@ -8,7 +7,7 @@ export const equityScreenerModule: PluginModule = {
       id: "equity-screener",
       name: "Equity Screener",
       icon: "S",
-      component: EquityScreenerPane,
+      get component(): typeof import("./pane").EquityScreenerPane { const { EquityScreenerPane } = require("./pane"); return EquityScreenerPane; },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 108, height: 30 },

package/src/plugins/builtin/equity-screener/model.ts

@@ -6,6 +6,7 @@ import {
   NUMERIC_FIELDS,
   OPTION_VOLATILITY_FIELDS,
   OWNERSHIP_FIELDS,
+  QUALITY_FIELDS,
   RESEARCH_FIELDS,
   KPI_FIELDS,
   SOCIAL_FIELDS,
@@ -126,6 +127,16 @@ export const SHORT_LABELS: Record<NumericField, string> = {
   floatShares: "FLOAT",
   shortPercentOfFloat: "SI % FLOAT",
   institutionalOwnershipPercent: "INST OWN%",
+  roicPercent: "ROIC%",
+  fcfYieldPercent: "FCF YLD%",
+  netDebtToEbitda: "ND/EBITDA",
+  debtToEquity: "D/E",
+  revenueCagr3YPercent: "REV CAGR 3Y%",
+  revenueCagr5YPercent: "REV CAGR 5Y%",
+  epsCagr3YPercent: "EPS CAGR 3Y%",
+  epsCagr5YPercent: "EPS CAGR 5Y%",
+  forwardRevenueGrowthPercent: "FWD REV GR%",
+  forwardEpsGrowthPercent: "FWD EPS GR%",
   hiringOpenRoles: "OPEN ROLES",
   hiringNetAddsWeek: "NET ROLES/WK",
   hiringRemotePercent: "REMOTE%",
@@ -138,7 +149,8 @@ export const SHORT_LABELS: Record<NumericField, string> = {
 const COMPACT = new Set<NumericField>(["kpiArr", "kpiRpo", "kpiCrpo", "kpiSubscribers", "kpiDau", "kpiMau", "kpiGmv", "kpiStores", "kpiBacklog", "marketCap", "volume", "averageVolume20d", "shortInterestShares", "sharesOutstanding", "floatShares"]);
 /** Daily counts: whole numbers below a thousand, compact above. */
 const DAILY_COUNTS = new Set<NumericField>(["xPostsPerDay", "wikiViewsPerDay"]);
-const RATIOS = new Set<NumericField>(["kpiBookToBill", "xPostsVsMedian", "wikiViewsVsMedian", "priceToBook", "evToEbitda", "ivToHv"]);
+const RATIOS = new Set<NumericField>(["kpiBookToBill", "xPostsVsMedian", "wikiViewsVsMedian", "priceToBook", "evToEbitda", "ivToHv",
+  "netDebtToEbitda", "debtToEquity"]);
 const RETURNS: NumericField[] = ["return1WPercent", "return1MPercent", "return3MPercent", "returnYtdPercent", "return1YPercent"];
 const SIGNED = new Set<NumericField>(["hiringNetAddsWeek", "hiringZScore", "appRankVelocity7d", "appRatingDrift7d", "appRatingCountGrowth7d",
   "guideRevenueChangePercent", "guideEpsChangePercent", "kpiSameStoreSalesPercent",
@@ -147,6 +159,8 @@ const SIGNED = new Set<NumericField>(["hiringNetAddsWeek", "hiringZScore", "appR
   ...RETURNS, "fromHigh52WPercent", "epsRevision30dPercent", "analystUpsidePercent",
   "priceVsSma20Percent", "priceVsSma50Percent", "priceVsSma200Percent",
   "iv30Change1d", "iv30Change5d",
+  "revenueCagr3YPercent", "revenueCagr5YPercent", "epsCagr3YPercent", "epsCagr5YPercent",
+  "forwardRevenueGrowthPercent", "forwardEpsGrowthPercent",
 ]);
 /** Moves whose sign is the news: they take the sign colour. */
 export const SIGN_COLORED = new Set<NumericField>(["changePercent", ...RETURNS, "epsRevision30dPercent", "analystUpsidePercent",
@@ -369,6 +383,16 @@ export const screenLabel = (field: string) =>
     floatShares: "Float",
     shortPercentOfFloat: "Short interest % of float",
     institutionalOwnershipPercent: "Institutional ownership % (13F)",
+    roicPercent: "ROIC %",
+    fcfYieldPercent: "FCF yield %",
+    netDebtToEbitda: "Net debt / EBITDA",
+    debtToEquity: "Debt / equity",
+    revenueCagr3YPercent: "Revenue CAGR 3Y %",
+    revenueCagr5YPercent: "Revenue CAGR 5Y %",
+    epsCagr3YPercent: "EPS CAGR 3Y %",
+    epsCagr5YPercent: "EPS CAGR 5Y %",
+    forwardRevenueGrowthPercent: "Forward revenue growth %",
+    forwardEpsGrowthPercent: "Forward EPS growth %",
     hiringOpenRoles: "Hiring open roles",
     hiringNetAddsWeek: "Net open roles per week",
     hiringRemotePercent: "Remote roles %",
@@ -682,9 +706,9 @@ export function validateScreenPayload(value: unknown): ScreenPayload {
       throw new Error("Invalid screener listing identity.");
     ids.add(screenRowId(row));
     for (const field of NUMERIC_FIELDS) {
-      // A server from before social, research, volatility, dividend, technical, option volatility or ownership fields
-      // omits them; they read as unavailable. A Pro field it left out was held back from this caller.
-      if (!row.metrics[field] && ([...SOCIAL_FIELDS, ...RESEARCH_FIELDS, ...VOLATILITY_FIELDS, ...TECHNICAL_FIELDS, ...OPTION_VOLATILITY_FIELDS, ...OWNERSHIP_FIELDS, ...ATTENTION_FIELDS, ...HIRING_APP_FIELDS, ...KPI_FIELDS, ...DIVIDEND_FIELDS] as readonly string[]).includes(field))
+      // A server from before social, research, volatility, dividend, technical, option volatility, ownership or quality
+      // fields omits them; they read as unavailable. A Pro field it left out was held back from this caller.
+      if (!row.metrics[field] && ([...SOCIAL_FIELDS, ...RESEARCH_FIELDS, ...VOLATILITY_FIELDS, ...TECHNICAL_FIELDS, ...OPTION_VOLATILITY_FIELDS, ...OWNERSHIP_FIELDS, ...QUALITY_FIELDS, ...ATTENTION_FIELDS, ...HIRING_APP_FIELDS, ...KPI_FIELDS, ...DIVIDEND_FIELDS] as readonly string[]).includes(field))
         row.metrics[field] = PRO_FIELDS.has(field) ? withheldMetric() : unavailableMetric();
       const metric = row.metrics[field];
       if (

package/src/plugins/builtin/equity-screener/pane.tsx

@@ -52,6 +52,7 @@ import { useResearchCloudSession } from "../shared/research-cloud-session";
 import { INITIAL_STREAM_RANGE, streamWindowRows } from "../shared/use-quote-board";
 import { useSampledValue } from "../../../state/hooks/live-ticker-financials";
 import { usePlanAccess } from "../../../api-client/plan-access";
+import { useQuoteDelayFooter } from "../shared/cloud-upgrade";
 import { SignInWall } from "../cloud/auth-actions";
 import { CriterionEditor } from "./criterion-editor";
 import { SCREEN_IDEAS, screenIdea } from "./ideas";
@@ -584,6 +585,8 @@ function EquityScreenView({
                 disabled: !selected,
               },
             ];
+  // Signed out or free, the quotes streamed over the snapshot's rows are delayed ones.
+  const quoteDelay = useQuoteDelayFooter(Array.from(liveEntries.values(), (entry) => entry.data ?? entry.lastGoodData), "screener-delay");
   usePaneFooter(
     "equity-screener",
     () => check ? null : ({
@@ -632,10 +635,12 @@ function EquityScreenView({
               },
             ]
           : []),
+        ...(quoteDelay ? [quoteDelay] : []),
       ],
       hints,
     }),
     [
+      quoteDelay,
       results.loading,
       results.loadingMore,
       data,

package/src/plugins/builtin/equity-screener/screen-check.ts

@@ -75,12 +75,34 @@ export function screenCheckSummary(data: ScreenCheckPayload): string {
   return data.matches === null ? "Not covered" : data.matches ? "Passes all criteria" : "Does not match";
 }
 
+/** The thresholds a criterion compares a value with: one, or a range's two ends. */
+function thresholds(criterion: ScreenCriterion): number[] {
+  if (!("value" in criterion)) return [];
+  const value = criterion.value as unknown;
+  return (Array.isArray(value) ? value : [value]).filter((entry): entry is number => typeof entry === "number");
+}
+
+/**
+ * A stored value as DVD writes its figures: two decimals (6.93%, 26.42 x), a
+ * whole number without them. A value that would round onto a threshold it is
+ * not (25.0001 against <= 25) keeps the decimals that tell it apart, so its
+ * Fail never reads as 25.00 failing <= 25.
+ */
+function checkValueText(value: number, unit: string, criterion: ScreenCriterion): string {
+  const limits = thresholds(criterion);
+  const whole = Number.isInteger(value) && unit !== "%";
+  let digits = whole ? 0 : 2;
+  while (digits < 15 && limits.some((limit) => limit !== value && Number(value.toFixed(digits)) === limit)) digits += 1;
+  const text = value.toLocaleString("en-US", { minimumFractionDigits: whole ? 0 : 2, maximumFractionDigits: digits });
+  return unit === "%" ? `${text}%` : `${text}${unit ? ` ${unit}` : ""}`;
+}
+
 export function checkRows(data: ScreenCheckPayload) {
   return data.criteria.map((entry, index) => ({
     id: String(index),
     criterion: checkCriterionText(entry.criterion),
     value: entry.state === "not-covered" ? "Not covered" : entry.value === null ? "Missing" : typeof entry.value === "number"
-      ? `${number(entry.value)}${entry.unit ? ` ${entry.unit}` : ""}` : entry.value,
+      ? checkValueText(entry.value, entry.unit, entry.criterion) : entry.value,
     result: entry.passes === null ? "Not evaluated" : entry.passes ? "Pass" : "Fail",
     asOf: entry.asOf?.slice(0, 10) ?? (entry.observedAt ? `${entry.observedAt.slice(0, 10)} (collected)` : "--"),
     state: entry.state,

package/src/plugins/builtin/estimate-revisions/index.tsx

@@ -3,7 +3,6 @@ import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import { estimateRevisionsCache } from "./client";
 import { estimateRevisionsHeadless } from "./headless";
 import { estimateRevisionsLockNote } from "./lock-note";
-import { EstimateRevisionsPane } from "./pane";
 export const estimateRevisionsModule: PluginModule = {
   panes: [
     {
@@ -12,7 +11,7 @@ export const estimateRevisionsModule: PluginModule = {
       reportRequirements: ["Free Gloom sign-in"],
       name: "Estimate Revisions",
       icon: "E",
-      component: EstimateRevisionsPane,
+      get component(): typeof import("./pane").EstimateRevisionsPane { const { EstimateRevisionsPane } = require("./pane"); return EstimateRevisionsPane; },
       defaultPosition: "right",
       tickerFollower: true,
       instruments: ["equity"],

package/src/plugins/builtin/exposure/holdings.ts

@@ -1,5 +1,6 @@
 import type { ExposureHolding } from "../../../api-client/exposure";
 import type { DataProvider } from "../../../types/data-provider";
+import type { Quote } from "../../../types/financials";
 import type { Portfolio, TickerRecord } from "../../../types/ticker";
 import { publicTickerKey } from "../../../utils/exchanges";
 import { resolveCurrencyUnit } from "../../../utils/currency-units";
@@ -7,8 +8,25 @@ import { convertCurrency } from "../../../utils/format";
 import { logFailure } from "../../../utils/log-failure";
 import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, resolvePortfolioMarketValue } from "../../../portfolio/position-metrics";
 
+/**
+ * Every position's quote: one batch where the provider has one, else one
+ * request per position, all at once. A position without a quote is null.
+ */
+async function positionQuotes(positions: TickerRecord[], market: Pick<DataProvider, "getQuote" | "getQuotesBatch">): Promise<Array<Quote | null>> {
+  const failed = logFailure("exposure.holdings", "Load portfolio holding quote failed", null);
+  if (market.getQuotesBatch) {
+    const targets = positions.map((ticker) => ({ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange, surface: "portfolio" as const }));
+    const results = await market.getQuotesBatch(targets).catch((error: unknown) => {
+      failed(error);
+      return [];
+    });
+    return positions.map((_, index) => results[index]?.quote ?? null);
+  }
+  return Promise.all(positions.map((ticker) => market.getQuote(ticker.metadata.ticker, ticker.metadata.exchange).catch(failed)));
+}
+
 /** Explicit NAV preserves cash, shorts and leverage; net holdings are never used as NAV. */
-export async function portfolioHoldings(portfolio: Portfolio, tickers: TickerRecord[], nav: number, market: Pick<DataProvider, "getQuote" | "getExchangeRate">): Promise<ExposureHolding[]> {
+export async function portfolioHoldings(portfolio: Portfolio, tickers: TickerRecord[], nav: number, market: Pick<DataProvider, "getQuote" | "getQuotesBatch" | "getExchangeRate">): Promise<ExposureHolding[]> {
   if (!Number.isFinite(nav) || nav <= 0) throw new Error(`Enter positive NAV in ${portfolio.currency} for ${portfolio.name}.`);
   const positions = tickers.filter(t => t.metadata.positions.some(p => p.portfolio === portfolio.id && p.shares !== 0));
   if (!positions.length) throw new Error("The selected portfolio has no positions.");
@@ -21,25 +39,29 @@ export async function portfolioHoldings(portfolio: Portfolio, tickers: TickerRec
     t.metadata.positions.filter(p => p.portfolio === portfolio.id).forEach(p => { if (p.currency) currencies.add(p.currency); });
   }
   const rates = new Map<string, number>([["USD", 1]]);
-  const majorRates = new Map<string, number>([["USD", 1]]);
+  // One request per major currency, however many of its units (GBP, GBp) ask at once.
+  const majorRates = new Map<string, Promise<number>>([["USD", Promise.resolve(1)]]);
   const ensureRate = async (rawCurrency: string) => {
     const unit = resolveCurrencyUnit(rawCurrency);
     if (!unit.currency) throw new Error("Portfolio currency is missing.");
-    let rate = majorRates.get(unit.currency);
-    if (rate === undefined) {
-      rate = await market.getExchangeRate(unit.currency);
-      if (!Number.isFinite(rate) || rate <= 0) throw new Error(`FX unavailable for ${unit.currency}; weights were not estimated.`);
-      majorRates.set(unit.currency, rate);
+    const major = unit.currency;
+    let pending = majorRates.get(major);
+    if (!pending) {
+      pending = market.getExchangeRate(major).then((rate) => {
+        if (!Number.isFinite(rate) || rate <= 0) throw new Error(`FX unavailable for ${major}; weights were not estimated.`);
+        return rate;
+      });
+      majorRates.set(major, pending);
     }
-    rates.set(rawCurrency, rate / unit.divisor);
+    rates.set(rawCurrency, (await pending) / unit.divisor);
   };
-  for (const currency of currencies) await ensureRate(currency);
+  const [quotes] = await Promise.all([positionQuotes(positions, market), Promise.all([...currencies].map(ensureRate))]);
+  // A quote in a currency the positions did not name.
+  await Promise.all([...new Set(quotes.flatMap((quote) => quote?.currency && !rates.has(quote.currency) ? [quote.currency] : []))].map(ensureRate));
   const holdings: ExposureHolding[] = [];
-  for (const ticker of positions) {
-    const quote = await market.getQuote(ticker.metadata.ticker, ticker.metadata.exchange)
-      .catch(logFailure("exposure.holdings", "Load portfolio holding quote failed", null));
+  for (const [index, ticker] of positions.entries()) {
+    const quote = quotes[index] ?? null;
     const currency = quote?.currency || ticker.metadata.currency;
-    if (!rates.has(currency)) await ensureRate(currency);
     const metrics = getPortfolioPositionMetrics(ticker, portfolio.id, currency, {
       currency: portfolio.currency, convert: (value, from) => convertCurrency(value, from, portfolio.currency, rates),
     }, quote);

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

@@ -2,7 +2,6 @@ import type { PaneTemplateContext, ShortcutArgError } from "../../../types/plugi
 import { findNamedCollection, unknownCollectionArgError } from "../../../portfolio/collection-name";
 import type { PluginModule } from "../plugin-module";
 import { exposureHeadless } from "./headless";
-import { ExposurePane } from "./pane";
 
 const SOURCE = /^(PORT|WATCH):(.+)$/i;
 
@@ -29,7 +28,7 @@ function unknownSourceArg(arg: string, context: PaneTemplateContext): ShortcutAr
 }
 
 export const exposureModule: PluginModule = {
-  panes: [{ id: "exposure", name: "Exposure", icon: "E", component: ExposurePane, defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 138, height: 31 }, tableExport: true, headless: exposureHeadless,
+  panes: [{ id: "exposure", name: "Exposure", icon: "E", get component(): typeof import("./pane").ExposurePane { const { ExposurePane } = require("./pane"); return ExposurePane; }, defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 138, height: 31 }, tableExport: true, headless: exposureHeadless,
     personalData: "holdings",
     portableShare: { private: { params: true, settings: true, state: true } } }],
   paneTemplates: [{ id: "exposure-pane", paneId: "exposure", label: "Exposure", description: "Pro scenario exposures across holdings, geographic revenue and supply chains, with source evidence and portfolio concentrations.",

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

@@ -0,0 +1,44 @@
+import { CLI_COMMAND_GROUPS } from "../../../cli/help";
+import { rowsFreshness } from "../../../cli/freshness";
+import { humanizeCliKey } from "../../../cli/result";
+import type { CliCommandDef } from "../../../types/plugin";
+import { loadFearGreed } from "./cache";
+
+const SCORE_KEYS = new Set(["score", "previousClose", "previousWeek", "previousMonth", "previousYear"]);
+/** A score to a tenth of a point (17.9); a missing one leaves its cell empty, as before. */
+const scoreTenths = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? value.toFixed(1) : "";
+
+// Without the pane cache attached, this fetches a fresh reading for the command.
+export const fearGreedCliCommand: CliCommandDef = {
+  name: "fear-greed",
+  description: "Fetch CNN Fear & Greed gauge data",
+  help: { group: CLI_COMMAND_GROUPS.markets },
+  async execute(_args, ctx) {
+    const { data, stale } = await loadFearGreed(ctx.cliOptions.refresh);
+    const rows = [{
+      score: data.overall.score,
+      rating: data.overall.rating,
+      updatedAt: data.overall.updatedAt?.toISOString() ?? "",
+      previousClose: data.overall.previousClose,
+      previousWeek: data.overall.previousWeek,
+      previousMonth: data.overall.previousMonth,
+      previousYear: data.overall.previousYear,
+    }];
+    ctx.printResult({
+      data: rows,
+      // Exports cite CNN's reading as `fn FNG` does; the text stays the row alone.
+      exportFreshness: rowsFreshness(rows, { source: "CNN", status: stale ? "stale" : "not-a-feed", basis: "published index" }),
+      metadata: {
+        indicators: data.indicators.map((indicator) => ({
+          id: indicator.definition.id,
+          score: indicator.score,
+          rating: indicator.rating,
+        })),
+      },
+    }, {
+      // Scores read to a tenth of a point on the text table; exports keep every digit.
+      textColumns: Object.keys(rows[0]!).map((key) => ({ key, header: humanizeCliKey(key),
+        ...(SCORE_KEYS.has(key) ? { align: "right" as const, format: scoreTenths } : {}) })),
+    });
+  },
+};

package/src/plugins/builtin/fear-greed/index.tsx

@@ -1,26 +1,15 @@
-import { CLI_COMMAND_GROUPS } from "../../../cli/help";
-import { rowsFreshness } from "../../../cli/freshness";
-import { humanizeCliKey } from "../../../cli/result";
+import { fearGreedPluginMeta } from "../builtin-plugin-meta";
+import { fearGreedCliCommand } from "./cli";
 import type { GloomPlugin } from "../../../types/plugin";
 import {
   attachFearGreedPersistence,
-  loadFearGreed,
   resetFearGreedPersistence,
 } from "./cache";
-import { FearGreedPane } from "./pane";
 import { fearGreedHeadless } from "./headless";
 import { FEAR_GREED_SERIES } from "./series";
 
-const SCORE_KEYS = new Set(["score", "previousClose", "previousWeek", "previousMonth", "previousYear"]);
-/** A score to a tenth of a point (17.9); a missing one leaves its cell empty, as before. */
-const scoreTenths = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? value.toFixed(1) : "";
-
 export const fearGreedPlugin: GloomPlugin = {
-  id: "fear-greed",
-  name: "Fear & Greed",
-  version: "1.0.0",
-  description: "CNN Fear & Greed index with the seven indicator charts",
-  toggleable: true,
+  ...fearGreedPluginMeta,
 
   // One JSON endpoint over HTTPS, so every renderer. CNN sends no CORS
   // headers and wants a Referer, which is why the host is declared: the web
@@ -44,7 +33,7 @@ export const fearGreedPlugin: GloomPlugin = {
       id: "fear-greed",
       name: "Fear & Greed",
       icon: "G",
-      component: FearGreedPane,
+      get component(): typeof import("./pane").FearGreedPane { const { FearGreedPane } = require("./pane"); return FearGreedPane; },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 110, height: 36 },
@@ -63,42 +52,5 @@ export const fearGreedPlugin: GloomPlugin = {
     },
   ],
 
-  // `gloom fear-greed`, as before the plugin moved out of the host. Runs
-  // without the pane cache attached when invoked from the CLI, so it always
-  // fetches, which is what a CLI call wants anyway.
-  cliCommands: [
-    {
-      name: "fear-greed",
-      description: "Fetch CNN Fear & Greed gauge data",
-      help: { group: CLI_COMMAND_GROUPS.markets },
-      async execute(_args, ctx) {
-        const { data, stale } = await loadFearGreed(ctx.cliOptions.refresh);
-        const rows = [{
-          score: data.overall.score,
-          rating: data.overall.rating,
-          updatedAt: data.overall.updatedAt?.toISOString() ?? "",
-          previousClose: data.overall.previousClose,
-          previousWeek: data.overall.previousWeek,
-          previousMonth: data.overall.previousMonth,
-          previousYear: data.overall.previousYear,
-        }];
-        ctx.printResult({
-          data: rows,
-          // Exports cite CNN's reading as `fn FNG` does; the text stays the row alone.
-          exportFreshness: rowsFreshness(rows, { source: "CNN", status: stale ? "stale" : "not-a-feed", basis: "published index" }),
-          metadata: {
-            indicators: data.indicators.map((indicator) => ({
-              id: indicator.definition.id,
-              score: indicator.score,
-              rating: indicator.rating,
-            })),
-          },
-        }, {
-          // Scores read to a tenth of a point on the text table; exports keep every digit.
-          textColumns: Object.keys(rows[0]!).map((key) => ({ key, header: humanizeCliKey(key),
-            ...(SCORE_KEYS.has(key) ? { align: "right" as const, format: scoreTenths } : {}) })),
-        });
-      },
-    },
-  ],
+  cliCommands: [fearGreedCliCommand],
 };

package/src/plugins/builtin/fear-greed/pane.tsx

@@ -8,6 +8,7 @@ import {
   usePaneStatusFooter,
   type StatItem,
 } from "../../../components";
+import { ageFooterSegment } from "../../../components/layout/pane/footer";
 import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
 import { useAsyncResource } from "../../../react/async-resource";
 import type { PaneProps } from "../../../types/plugin";
@@ -61,7 +62,7 @@ export function FearGreedPane({ paneId, focused, width, height }: PaneProps) {
       ],
     }] : []),
     ...(stale ? [{ id: "stale", parts: [{ text: "stale", tone: "warning" as const }] }] : []),
-    ...(updatedAgo ? [{ id: "age", parts: [{ text: `updated ${updatedAgo}`, tone: "value" as const }] }] : []),
+    ...(updatedAgo ? [ageFooterSegment(updatedAgo, { id: "age", verb: "updated", tone: "value" })] : []),
   ], [data, stale, updatedAgo]);
   usePaneStatusFooter({ registrationId: paneId, loading, error, info: footerInfo });
 

package/src/plugins/builtin/fixed-income/index.tsx

@@ -1,14 +1,13 @@
 import type { PluginModule } from "../plugin-module";
 import { treasuryAuctionsSettings } from "../treasury-auctions";
 import { FIXED_INCOME_PANE_ID } from "./model";
-import { FixedIncomePane } from "./pane";
 
 export const fixedIncomeModule: PluginModule = {
   panes: [{
     id: FIXED_INCOME_PANE_ID,
     name: "Fixed Income",
     icon: "B",
-    component: FixedIncomePane,
+    get component(): typeof import("./pane").FixedIncomePane { const { FixedIncomePane } = require("./pane"); return FixedIncomePane; },
     defaultPosition: "right",
     defaultMode: "floating",
     defaultFloatingSize: { width: 116, height: 32 },

package/src/plugins/builtin/futures/board-reads.ts

@@ -0,0 +1,25 @@
+import { createConcurrencyLimiter } from "../../../utils/concurrency";
+
+/**
+ * The board's contract histories (use-front-returns) and contract terms
+ * (use-board-terms) share one limit of twelve reads at a time, across both and
+ * every board open: seventy-odd rows load in about a second without the two
+ * crowding out each other or the quotes.
+ */
+const BOARD_READ_LIMIT = 12;
+
+export const boardRead = createConcurrencyLimiter(BOARD_READ_LIMIT);
+
+/**
+ * Reads that reach a source sending reads asked together as batch requests
+ * skip that limit: asked all at once, the API client sends a board's rows
+ * sixteen a request. This bound only keeps a runaway caller in check.
+ */
+const BOARD_BATCHED_READ_LIMIT = 200;
+
+const boardBatchedRead = createConcurrencyLimiter(BOARD_BATCHED_READ_LIMIT);
+
+/** The gate for the board's reads: twelve at a time, unless they go out in batch requests. */
+export function boardReadGate(batched: boolean): typeof boardRead {
+  return batched ? boardBatchedRead : boardRead;
+}

package/src/plugins/builtin/futures/coalesced-bump.ts

@@ -0,0 +1,44 @@
+/** How long reads landing one after another are gathered into one redraw. */
+const LANDING_GATHER_MS = 100;
+
+/**
+ * A redraw for reads that land one by one (a board's seventy contract
+ * histories): the first landing redraws at once, and those in the next
+ * `LANDING_GATHER_MS` are drawn together when it ends, so the board redraws a
+ * few times rather than once per read. `flush` draws what is waiting at once
+ * (the last read landed) and `cancel` drops it (the board moved on).
+ */
+export function coalescedBump(redraw: () => void, gatherMs = LANDING_GATHER_MS) {
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  let waiting = false;
+  const gather = () => {
+    timer = setTimeout(() => {
+      timer = undefined;
+      if (!waiting) return;
+      waiting = false;
+      redraw();
+      gather();
+    }, gatherMs);
+  };
+  const cancel = () => {
+    clearTimeout(timer);
+    timer = undefined;
+    waiting = false;
+  };
+  return {
+    bump() {
+      if (timer !== undefined) {
+        waiting = true;
+        return;
+      }
+      redraw();
+      gather();
+    },
+    flush() {
+      const draw = waiting;
+      cancel();
+      if (draw) redraw();
+    },
+    cancel,
+  };
+}

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

@@ -25,9 +25,11 @@ import type { PluginModule } from "../plugin-module";
 import { FUTURES_SERIES } from "./series";
 import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
 import { quoteObservation } from "../shared/report-freshness";
+import { useQuoteDelayFooter } from "../shared/cloud-upgrade";
 import {
   boardErrorMessage,
   boardHeadlineQuote,
+  boardQuotes,
   quoteBoardFooterInfo,
   quoteBoardStatus,
   useQuoteBoard,
@@ -46,6 +48,7 @@ import {
   DEFAULT_FUTURES_SORT,
   effectiveCollapsedSectors,
   FUTURES_RETURN_COLUMNS,
+  futuresNoMatchFailure,
   futuresRowId,
   type FuturesColumnId,
   type FuturesSortPreference,
@@ -255,15 +258,26 @@ export function FuturesPane({ focused, width, height }: PaneProps) {
     },
   } : null);
 
+  // `fn FUT natgas` with no contract to list fails with what to type instead, not the board's empty labels.
+  const noMatch = !!dataProvider && !!searchQuery.trim() && !rows.some((row) => row.type === "row");
+  useRemoteUiNode(noMatch ? {
+    role: "report-failure",
+    label: "No matching contracts",
+    getMetadata: () => futuresNoMatchFailure(searchQuery),
+  } : null);
+
   const status = quoteBoardStatus(listedQuotes);
   const errorMessage = boardErrorMessage(listedQuotes);
   // Every load came back empty: a board of dashes reads as broken, so the
   // body says so once and offers a retry. One quote is enough to keep rows.
   const noQuotes = !!dataProvider && listedQuotes.size > 0 && status.unavailable === listedQuotes.size;
+  // Signed out or free, the contracts' quotes are delayed ones.
+  const quoteDelay = useQuoteDelayFooter(boardQuotes(listedQuotes), "futures-delay");
   usePaneFooter(FUTURES_PANE_ID, () => {
     if (noQuotes) return { info: [], hints: [] };
     const info: PaneFooterSegment[] = quoteBoardFooterInfo(status);
     if (errorMessage) info.push({ id: "reason", parts: [{ text: errorMessage, tone: "warning" }] });
+    if (quoteDelay) info.push(quoteDelay);
     return {
       info,
       hints: [{ id: "search", key: "/", label: "search", onPress: focusSearch }],
@@ -272,6 +286,7 @@ export function FuturesPane({ focused, width, height }: PaneProps) {
     errorMessage,
     focusSearch,
     noQuotes,
+    quoteDelay,
     status.latestTs,
     status.loading,
     status.savedAt,

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

@@ -149,9 +149,23 @@ function matchesFuturesSearch(contract: FuturesContract, query: string, quote?:
     || contract.name.toLowerCase().includes(normalized)
     || futuresContractName(contract, quote).toLowerCase().includes(normalized)
     || contract.symbol.toLowerCase().includes(normalized)
+    // Everyday names the board's own does not hold: natgas is Natural Gas.
+    || (contract.aliases ?? []).some((alias) => alias.includes(normalized))
   );
 }
 
+/**
+ * Why `fn FUT urea` lists nothing, for a search no contract matches: what
+ * to type instead, never the board's own buttons ("Clear search.").
+ */
+export function futuresNoMatchFailure(query: string): { message: string; details: string } {
+  return {
+    message: `No futures contract matches "${query.trim()}".`,
+    details: "Try a code such as NG, CL or GC, or a name such as natural gas or gold: gloom fn FUT NG."
+      + " Other boards: gloom fn FUT --tab inventories, positioning or crops.",
+  };
+}
+
 export const FUTURES_RETURN_COLUMNS: Readonly<Partial<Record<FuturesColumnId, FuturesReturnHorizon>>> = {
   return1w: "1W",
   return1m: "1M",