gloomberb 0.18.3 → 0.18.4

package/src/cli/commands/ticker.ts

@@ -1,10 +1,14 @@
 import { logFailure } from "../../utils/log-failure";
 import { formatShortDate, parseDisplayDate } from "../../utils/datetime-format";
 import { formatReportedMoney } from "../../utils/reported-money";
-import { convertedPriceEarningsNote, enterpriseValueLabel, enterpriseValueReconciliationNote, epsConversionNote, fundamentalsCurrency, reportedEnterpriseValue, ttmConversionNote } from "../../utils/fundamentals";
+import {
+  appTtmRate, computedEnterpriseValueNote, convertedPriceEarningsNote, enterpriseValueLabel, enterpriseValueReconciliationNote, epsConversionNote,
+  fundamentalsCurrency, reportedEnterpriseValue, ttmAtAppRate, ttmConversionNote,
+} from "../../utils/fundamentals";
 import { latestFinancialPeriod } from "../../utils/latest-financial-period";
-import { exportedFundamentals, formatPriceEarnings, priceEarningsOnEarnings } from "../../utils/price-earnings";
-import { describeFundamentalMarketCap, marketCapShareBasisNote, selectMarketCapitalization } from "../../utils/market-capitalization";
+import { burnsCash, cashRunway, SHORT_RUNWAY_HISTORY, formatRunwayMonths, offeringNote, offeringsAfter, runwayMethod, type CashRunway, type OfferingFiling, type RunwayEstimate } from "../../utils/cash-runway";
+import { exportedFundamentals, formatPriceEarnings, NOT_MEANINGFUL, priceEarningsOnEarnings } from "../../utils/price-earnings";
+import { describeFundamentalMarketCap, marketCapBasisNote, selectMarketCapitalization, viewMarketCapitalization } from "../../utils/market-capitalization";
 import {
   formatCompact,
   formatCurrency,
@@ -34,12 +38,14 @@ import {
   quoteMarketStateLabel,
 } from "../../market-data/market/status";
 import type { FuturesContractTermsPayload } from "../../api-client/futures-curve";
-import { changeBasisJson, quoteChangeBasis, quotePreviousCloseDate } from "../../market-data/market/change-basis";
-import { futuresContractLines, futuresSettleText, isFuturesInstrument, loadFuturesContractTerms, minorUnitPricePer } from "../../market-data/futures-contract";
+import { changeBasisJson, quoteChangeBasis, quotePreviousCloseDate, quoteSettleText } from "../../market-data/market/change-basis";
+import {
+  futuresContractLines, futuresPricePer, isFuturesInstrument, loadFuturesContractTerms, loadUsdPerMmbtu, usdPerMmbtuText, type UsdPerMmbtu,
+} from "../../market-data/futures-contract";
 import { currencyCodeLabel, heldCurrencyUnit } from "../../utils/currency-units";
 import { quotedFxPair } from "../../utils/currency-pair";
 import type { AppConfig } from "../../types/config";
-import type { DeclaredDividendAction, FinancialStatement, Quote, TickerFinancials } from "../../types/financials";
+import type { CompanyProfile, DeclaredDividendAction, FinancialStatement, Quote, TickerFinancials } from "../../types/financials";
 import { atRegularSessionPrice, regularSessionValuationPrice } from "../../market-data/quotes/regular-session-valuation";
 import { computeTickerPriceReturns } from "../../market-data/ticker-price-returns";
 import { instrumentTypeLabel, resolveTickerInstrumentKind } from "../../tickers/instrument-kind";
@@ -50,7 +56,7 @@ import type { TickerRecord } from "../../types/ticker";
 import type { CliCommandContext } from "../../types/plugin";
 import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, lotCostFxRate, resolvePortfolioMarketValue, resolvePortfolioPositionPnl } from "../../portfolio/position-metrics";
 import { isFuturesTicker } from "../../portfolio/futures-positions";
-import { createBaseConverter, type BaseConversion } from "../base-converter";
+import { createBaseConverter, type BaseConverter } from "../base-converter";
 import { formatFxRate } from "../fx-pair";
 import { initMarketData, withMarketData } from "../context";
 import { fail } from "../errors";
@@ -66,7 +72,7 @@ import {
   quoteChangeText,
 } from "../helpers";
 import { NotesFiles } from "../../plugins/builtin/notes/files";
-import { isKnownNonUsListing, secFilingItemCodes } from "../../utils/sec";
+import { isKnownNonUsListing, secFilingItemCodes, US_FUND_FACTS_ONLY } from "../../utils/sec";
 import { currentReportItemsLabel, hiddenFilingsNote, loadLatestFilings, type HiddenFilings } from "../../utils/sec-filings";
 import { canonicalExchange, exchangeLabel, isKnownExchangeCode, isUsListingExchange } from "../../utils/exchanges";
 import {
@@ -77,6 +83,7 @@ import { movedAwayChange } from "../../tickers/ticker-changes";
 import { companyMemberships, loadCompanyMemberships, type CompanyMemberships, type ListMembership } from "../issuer-membership";
 import { isNotATickerMessage } from "../not-a-ticker";
 import { sharesOutstandingInReceipts } from "../../utils/depositary-receipt";
+import { depositaryPairText, isReceiptSide, listingDepositaryPair } from "../../market-data/depositary-pair";
 import { cliFreshnessFooter } from "../result";
 import { providerMissReason } from "../../sources/provider-errors";
 import { exportEntriesTable, reportFooterLines, type CliReportTables } from "../report-tables";
@@ -86,12 +93,14 @@ import { distributionHistory, forwardDividendBasis, forwardDividendMayHaveLapsed
 import { declaredDividends } from "../../utils/declared-dividends";
 import { historyTrailingDividendYield, measuresTrailingYield } from "../../market-data/quotes/live-valuation";
 import { notTheCoinNote } from "./crypto-hints";
-import { loadStatementFilings, resultsReleaseText, statementPeriodText, type StatementFilingsReport } from "../statement-filings";
+import { loadOfferingFilings, loadStatementFilings, resultsReleaseText, statementPeriodText, type StatementFilingsReport } from "../statement-filings";
 import type { BankFiguresPayload } from "../../api-client/bank-figures";
 import { bankSection } from "../bank-section";
 import type { FundBondFacts } from "../../api-client/fund-facts";
 import { bondFigures, fetchFundBondFacts, NOT_SEC_YIELD } from "../../market-data/bond-funds";
 import { taxEquivalentLines, type TaxEquivalentAnalysis } from "../../market-data/tax-equivalent";
+import { isRoundTheClockCoin } from "../../utils/crypto-pair";
+import { coinNewsFallbackNotice } from "../../sources/gloomberb-cloud/news";
 
 const NEWS_ITEM_LIMIT = 5;
 const SEC_FILING_LIMIT = 5;
@@ -166,7 +175,16 @@ function wrapProse(text: string): string {
   return wrapText(text, Math.min(cliTerminalWidth() ?? MAX_PROSE_WIDTH, MAX_PROSE_WIDTH)).join("\n");
 }
 
-function buildStatementMetrics(statement: FinancialStatement, currency?: string, codes = false): Array<[string, string]> {
+/** The runway row: months at the latest quarter's burn and at the trailing year's, each with the period it is read over. */
+function cashRunwayText(runway: CashRunway): string {
+  const { quarter, trailing, periodEnd } = runway;
+  if (quarter?.kind === "no-burn" && trailing?.kind === "no-burn") return `no burn (quarter and TTM to ${periodEnd})`;
+  const part = (estimate: RunwayEstimate | null, period: string) => estimate
+    ? `${estimate.kind === "no-burn" ? "no burn" : formatRunwayMonths(estimate.months)} (${period} to ${periodEnd})` : null;
+  return [part(quarter, "quarter"), trailing ? part(trailing, "TTM") : `TTM ${runway.trailingGap === "short-history" ? SHORT_RUNWAY_HISTORY : "not reported"}`].filter((text): text is string => !!text).join(" \u00b7 ");
+}
+
+function buildStatementMetrics(statement: FinancialStatement, currency?: string, codes = false, runway?: CashRunway | null): Array<[string, string]> {
   const money = (value: number | undefined, perShare = false) => formatReportedMoney(value, currency, perShare, codes);
   return [
     ["Revenue", money(statement.totalRevenue)],
@@ -179,6 +197,9 @@ function buildStatementMetrics(statement: FinancialStatement, currency?: string,
     ["Operating Cash Flow", money(statement.operatingCashFlow)],
     ["Free Cash Flow", money(statement.freeCashFlow)],
     ["Cash", money(statement.cashAndCashEquivalents)],
+    ["Cash + ST Inv", money(statement.cashCashEquivalentsAndShortTermInvestments)],
+    // The latest quarter's only: months of cash at its burn and the trailing year's.
+    ...runway ? [["Cash Runway", cashRunwayText(runway)] as [string, string]] : [],
     ["Total Assets", money(statement.totalAssets)],
     ["Total Liabilities", money(statement.totalLiabilities)],
     ["Total Debt", money(statement.totalDebt)],
@@ -195,9 +216,15 @@ function buildStatementMetrics(statement: FinancialStatement, currency?: string,
  * A receipt's count is its ordinary shares expressed in receipts, as its
  * market cap is; the ordinary count follows when the service gives it.
  */
+/** `504.5M (as of 2026-09-03)`: a share count with the day it was counted, when that is known (a 10-K or 10-Q cover count). */
+function datedCount(count: number, asOf: string | undefined): string {
+  return asOf ? `${formatCompact(count)} (as of ${asOf})` : formatCompact(count);
+}
+
 function sharesOutstandingText(fundamentals: TickerFinancials["fundamentals"], inReceipts: boolean): string {
   const shares = fundamentals?.sharesOutstanding;
-  if (shares == null || !inReceipts) return formatCompact(shares);
+  if (shares == null) return formatCompact(shares);
+  if (!inReceipts) return datedCount(shares, fundamentals?.sharesOutstandingAsOf);
   const ordinary = fundamentals?.shareBasis === "depositary_receipt" ? fundamentals.underlyingOrdinaryShares : undefined;
   return ordinary != null && Number.isFinite(ordinary) && ordinary > 0
     ? `${formatCompact(shares)} (ADR equivalent = ${formatCompact(ordinary)} ordinary shares)`
@@ -213,6 +240,19 @@ function appendTextSection(lines: string[], title: string, content: string | und
   lines.push(verbatim ? text : wrapProse(text));
 }
 
+/** "Description from ChinaAMC (Hong Kong), Product Key Facts on HKEXnews: https://...": where a quoted description is from. */
+function descriptionSourceLine(profile: CompanyProfile | undefined): string | null {
+  const source = profile?.description?.trim() ? profile.descriptionSource : undefined;
+  return source?.publisher && source.url ? `Description from ${source.publisher}: ${source.url}` : null;
+}
+
+/** The description with where it is from under it, when it is quoted. */
+function appendDescription(lines: string[], profile: CompanyProfile | undefined) {
+  appendTextSection(lines, "Description", profile?.description);
+  const source = descriptionSourceLine(profile);
+  if (source) lines.push(cliStyles.muted(source));
+}
+
 function appendFeedSection(
   lines: string[],
   title: string,
@@ -322,8 +362,9 @@ async function appendTickerPositions(lines: string[], tickerFile: TickerRecord |
       const currentPrice = getPortfolioQuoteDisplay(metrics, quote)?.price ?? null;
       const currentPriceBase = currentPrice != null && quoteCurrency ? await toBase(currentPrice, quoteCurrency) : null;
       const positionRate = positionCurrency ? await toBase(1, positionCurrency) : Number.NaN;
-      if (positionCurrency) converted.add(positionCurrency.toUpperCase());
-      if (quoteCurrency && currentPrice != null) converted.add(quoteCurrency.toUpperCase());
+      // By the major currency the converter states its rate in: pence (GBp, GBX) at GBP's.
+      if (positionCurrency) converted.add(heldCurrencyUnit(positionCurrency).currency);
+      if (quoteCurrency && currentPrice != null) converted.add(heldCurrencyUnit(quoteCurrency).currency);
       const baseMetrics = getPortfolioPositionMetrics({ ...tickerFile, metadata: { ...tickerFile.metadata, positions: [position] } }, undefined, quoteCurrency,
         { currency: config.baseCurrency, convert: value => value * positionRate }, quote);
       // A cost bought at an entered rate into the base currency converts at it, as its P&L does, and says so; any other at today's.
@@ -363,7 +404,34 @@ async function appendTickerPositions(lines: string[], tickerFile: TickerRecord |
 }
 
 /** The ticker report's converter: what `createBaseConverter` makes, whose rates a report states; a plain function in tests. */
-type ReportBaseConverter = ((value: number, fromCurrency: string) => Promise<number>) & { conversions?(): BaseConversion[] };
+type ReportBaseConverter = ((value: number, fromCurrency: string) => Promise<number>) & Partial<Pick<BaseConverter, "conversions" | "usdRate">>;
+
+/**
+ * The financials with a converted TTM block at the rate the report converts everything else at, the one `fx`
+ * reports (ttmAtAppRate), for the text and the JSON alike; as served when the converter has no rate for it.
+ */
+export async function atReportTtmRate(financials: TickerFinancials, toBase: Partial<Pick<BaseConverter, "usdRate">>): Promise<TickerFinancials> {
+  const fundamentals = financials.fundamentals;
+  const from = fundamentals?.ttmConversion?.from?.trim();
+  const to = fundamentals?.financialCurrency?.trim();
+  if (!fundamentals || !from || !to || from === to || !toBase.usdRate) return financials;
+  const legs = new Map(await Promise.all([from, to].map(async (currency) =>
+    [heldCurrencyUnit(currency).currency, await toBase.usdRate!(currency)] as const)));
+  const shown = ttmAtAppRate(fundamentals, appTtmRate(fundamentals, (currency) => legs.get(currency)));
+  return shown === fundamentals ? financials : { ...financials, fundamentals: shown };
+}
+
+/**
+ * "TTM figures in ARS; the statements in USD.": a trailing block the source states in another currency than the
+ * statements shown below it, which no conversion explains (YPFD on BYMA: ARS figures beside USD statements).
+ */
+function ttmCurrencySplitNote(fundamentals: TickerFinancials["fundamentals"], statementCurrencies: ReadonlyArray<string | undefined>): string | undefined {
+  const ttm = fundamentals?.financialCurrency?.trim();
+  const shown = new Set(statementCurrencies.map((currency) => currency?.trim()).filter((currency): currency is string => !!currency));
+  if (!ttm || fundamentals?.ttmConversion || shown.size !== 1) return undefined;
+  const [statements] = shown;
+  return heldCurrencyUnit(statements).currency === heldCurrencyUnit(ttm).currency ? undefined : `TTM figures in ${ttm}; the statements in ${statements}.`;
+}
 
 /**
  * A base currency other than USD reads every amount with its code (259.36
@@ -387,11 +455,11 @@ interface ReportRateNotes {
   boughtAt: ReadonlySet<string>;
 }
 
-/** The currencies of the shown lots whose cost converts into the base currency at the rate they were bought at. */
+/** The currencies of the shown lots whose cost converts into the base currency at the rate they were bought at, pence as GBP. */
 function boughtRateCurrencies(tickerFile: TickerRecord | null, quoteCurrency: string, baseCurrency: string): Set<string> {
   return new Set((tickerFile?.metadata.positions ?? []).flatMap((position) => {
     const currency = (position.currency || quoteCurrency).trim();
-    return position.shares !== 0 && currency && lotCostFxRate(position, currency, baseCurrency) !== null ? [currency.toUpperCase()] : [];
+    return position.shares !== 0 && currency && lotCostFxRate(position, currency, baseCurrency) !== null ? [heldCurrencyUnit(currency).currency] : [];
   }));
 }
 
@@ -442,9 +510,13 @@ function reportedMoney(value: number | undefined, currency: string | undefined,
   return { text: formatReportedMoney(value, currency, perShare, codes), value, unit: currency?.trim() || "ccy?" };
 }
 
-/** The EV line: labelled "(provider)" when it is more than 5% from market cap + debt - cash, "unavailable" when withdrawn. */
+/**
+ * The EV line: labelled "(provider)" when it is more than 5% from market cap + debt - cash, "unavailable" when
+ * withdrawn, N/M at or below zero as a P/E over a loss is.
+ */
 function enterpriseValueFigure(figure: MetricFigure, fundamentals: TickerFinancials["fundamentals"]): MetricFigure {
   const label = enterpriseValueLabel(fundamentals);
+  if (label === "not-meaningful") return { ...multipleFigure(NOT_MEANINGFUL), unit: figure.unit };
   if (label === "unavailable") return { text: "unavailable", value: null, unit: figure.unit };
   return label === "provider" && figure.text !== "—" ? { ...figure, text: `${figure.text} (provider)` } : figure;
 }
@@ -664,6 +736,9 @@ function fundamentalsMetrics(
       value: fundamentals?.sharesOutstanding,
       ...(receipt ? { unit: "ADR equivalent" } : {}),
     },
+    ...(fundamentals?.sharesOutstanding != null && fundamentals.sharesOutstandingAsOf ? [{
+      label: "Shares Outstanding As Of", text: fundamentals.sharesOutstandingAsOf, value: fundamentals.sharesOutstandingAsOf, exportOnly: true,
+    }] : []),
   ];
 }
 
@@ -682,10 +757,12 @@ function floatAndShortInterestMetrics(
   const days = fundamentals?.shortRatio;
   const date = fundamentals?.shortInterestDate;
   const receipt = finite(float) && sharesOutstandingInReceipts(quote, fundamentals, profile?.description);
+  const floatAsOf = finite(float) && float > 0 ? fundamentals?.floatSharesAsOf : undefined;
   return [
     finite(float) && float > 0
-      ? { label: "Float", text: formatCompact(float), value: float, ...(receipt ? { unit: "ADR equivalent" } : {}) }
+      ? { label: "Float", text: datedCount(float, floatAsOf), value: float, ...(receipt ? { unit: "ADR equivalent" } : {}) }
       : { label: "Float", text: "—" },
+    ...floatAsOf ? [{ label: "Float As Of", text: floatAsOf, value: floatAsOf, exportOnly: true }] : [],
     finite(short)
       ? { label: "Short Interest", text: `${formatCompact(short)}${date ? ` (settled ${date})` : ""}`, value: short, unit: "shares" }
       : { label: "Short Interest", text: "—" },
@@ -702,7 +779,7 @@ function metricLines(metrics: readonly FundamentalsMetric[]): Array<[string, str
 const TRAILING_MONEY_METRICS = new Set(["EPS (TTM)", "Revenue (TTM)", "Net Income (TTM)", "Operating Cash Flow (TTM)", "Free Cash Flow (TTM)"]);
 
 /**
- * The notes under shown fundamentals: a market cap that does not rest on the share count shown, how a labelled or
+ * The notes under shown fundamentals: a market cap shown as the share count times the price and the provider's, how a labelled or
  * withdrawn EV compares with market cap + debt - cash, what a converted TTM block was converted from, an EPS in
  * another currency than the amounts beside it, and what a P/E on such an EPS divides. `priced` is the snapshot at
  * the regular session price (atRegularSessionPrice), the figures the lines show, so each note reads those.
@@ -714,21 +791,24 @@ function fundamentalsNotes(
 ): string[] {
   const fundamentals = priced.fundamentals;
   const shown = (label: string) => metrics.some((metric) => metric.label === label && metric.text !== "—");
-  const shareBasis = shown("Market Cap") && shown("Shares Outstanding")
-    ? marketCapShareBasisNote(selectMarketCapitalization(priced.quote, fundamentals), fundamentals?.sharesOutstanding,
-      regularSessionValuationPrice(priced.quote), priced.quote?.currency)
+  // The cap shown is the share count times the price where the provider's sits more than 2% from it; the note names the provider's.
+  const shareBasis = shown("Market Cap")
+    ? marketCapBasisNote(viewMarketCapitalization(priced.quote, fundamentals, regularSessionValuationPrice(priced.quote)))
     : undefined;
   const conversion = [...TRAILING_MONEY_METRICS].some(shown) ? ttmConversionNote(fundamentals) : undefined;
   const eps = shown("EPS (TTM)") ? epsConversionNote(fundamentals) : undefined;
   const priceEarnings = metrics.some((metric) => metric.label === "P/E (TTM)" && typeof metric.value === "number")
     ? convertedPriceEarningsNote(fundamentals, quoteCurrency)
     : undefined;
-  const enterpriseValue = shown("Enterprise Value") ? enterpriseValueReconciliationNote(fundamentals) : undefined;
+  // Why the EV is labelled, withdrawn or N/M; for an insurer's, what Gloom Cloud computed it from.
+  const enterpriseValue = shown("Enterprise Value")
+    ? enterpriseValueReconciliationNote(fundamentals) ?? computedEnterpriseValueNote(fundamentals)
+    : undefined;
   return [shareBasis, enterpriseValue, conversion, eps, priceEarnings].filter((note): note is string => !!note);
 }
 
 // The share count is the market cap's basis: the cap is the count times the price, or a note says why not.
-const VALUATION_METRICS = new Set(["Market Cap", "Shares Outstanding", "Enterprise Value", "P/E (TTM)", "Forward P/E", "PEG", "EPS (TTM)"]);
+const VALUATION_METRICS = new Set(["Market Cap", "Shares Outstanding", "Shares Outstanding As Of", "Enterprise Value", "P/E (TTM)", "Forward P/E", "PEG", "EPS (TTM)"]);
 
 type FundamentalsReportData = TickerFinancials & {
   symbol: string;
@@ -772,7 +852,7 @@ function fundFactsNote(
   if (resolveTickerInstrumentKind(tickerFile, financials) !== "fund") return null;
   return !exchange || isUsListingExchange(exchange)
     ? `Fund facts (fee, NAV, premium, net assets): fn ETF ${symbol}.`
-    : "Fund facts (fee, NAV, premium) cover US-listed funds only.";
+    : US_FUND_FACTS_ONLY;
 }
 
 /**
@@ -828,7 +908,7 @@ function fundamentalsReportMetrics(snapshot: FundamentalsReportData, view: "fund
   const financials = atRegularSessionPrice(snapshot);
   const quote = financials.quote;
   const fundamentals = financials.fundamentals;
-  const capitalization = selectMarketCapitalization(quote, fundamentals);
+  const capitalization = viewMarketCapitalization(quote, fundamentals, regularSessionValuationPrice(quote));
   const marketCap: MetricFigure = capitalization
     ? { text: `${formatCompact(capitalization.value)} ${capitalization.currency}`, value: capitalization.value, unit: capitalization.currency }
     : { text: "—" };
@@ -840,13 +920,14 @@ function fundamentalsReportMetrics(snapshot: FundamentalsReportData, view: "fund
   }
   const valued = metrics.filter(({ label, text }) => (VALUATION_METRICS.has(label) || isYieldMetric(label)) && text !== "—");
   // The share count follows the market cap it is the basis of.
-  const shares = valued.filter((metric) => metric.label === "Shares Outstanding");
-  const valuation = valued.flatMap((metric) => metric.label === "Shares Outstanding" ? [] : metric.label === "Market Cap" ? [metric, ...shares] : [metric]);
+  const isShares = (label: string) => label === "Shares Outstanding" || label === "Shares Outstanding As Of";
+  const shares = valued.filter((metric) => isShares(metric.label));
+  const valuation = valued.flatMap((metric) => isShares(metric.label) ? [] : metric.label === "Market Cap" ? [metric, ...shares] : [metric]);
   // A listing with no valuation (a fund) says so rather than printing its price alone.
   return valuation.length === 0 ? [] : [...valuationPriceMetrics(financials).filter((metric) => metric.text !== "—"), ...valuation];
 }
 
-/** Text for `gloomberb fundamentals` and `gloomberb valuation`: the ticker report's fundamentals without the rest. */
+/** Text for `gloom fundamentals` and `gloom valuation`: the ticker report's fundamentals without the rest. */
 export function renderFundamentalsReport(
   financials: FundamentalsReportData,
   view: "fundamentals" | "valuation",
@@ -882,7 +963,7 @@ export function renderFundamentalsReport(
     } else if (financials.bankNote) {
       lines.push("", renderSection("Bank"), cliStyles.muted(financials.bankNote));
     }
-    appendTextSection(lines, "Description", profile?.description);
+    appendDescription(lines, profile);
   }
   return lines.join("\n");
 }
@@ -929,6 +1010,10 @@ export function fundamentalsReportTables(
       { label: "Sector", value: profile?.sector },
       { label: "Industry", value: profile?.industry },
       { label: "Description", value: profile?.description?.trim() },
+      ...profile?.description?.trim() && profile.descriptionSource ? [
+        { label: "Description Source", value: profile.descriptionSource.publisher },
+        { label: "Description URL", value: profile.descriptionSource.url },
+      ] : [],
     ].filter((entry) => typeof entry.value === "string" && entry.value.trim().length > 0)));
   }
   return {
@@ -975,16 +1060,20 @@ export async function buildTickerReport({
   recentSecFilings = [],
   hiddenSecFilings = NOTHING_HIDDEN,
   futuresContract = null,
+  usdPerMmbtu = null,
   distributions = null,
   statementFilings = null,
   bondFund = null,
   memberships,
+  offerings = [],
 }: {
   symbol: string;
   /** The lists holding the company, by any of its listings (loadCompanyMemberships); the saved listing's own lists when absent. */
   memberships?: CompanyMemberships;
   /** The filings behind the latest statements, and a newer quarter's results release. */
   statementFilings?: StatementFilingsReport | null;
+  /** The company's latest offering prospectuses (424B5, 424B4); those after the latest balance sheet get a note. */
+  offerings?: readonly OfferingFiling[];
   /** A bond fund's SEC yield, yield to worst and duration (loadReportBondFacts). */
   bondFund?: FundBondFacts | null;
   /** The distributions a dividend yield is read with (loadDividendDistributions). */
@@ -993,6 +1082,8 @@ export async function buildTickerReport({
   listingExchange?: string;
   /** A futures symbol's contract terms and latest confirmed settlement. */
   futuresContract?: FuturesContractTermsPayload | null;
+  /** A per-MWh gas price (Dutch TTF) in dollars per MMBtu, at the day's rate. */
+  usdPerMmbtu?: UsdPerMmbtu | null;
   tickerFile: TickerRecord | null;
   financials: TickerFinancials;
   config: AppConfig;
@@ -1052,6 +1143,11 @@ export async function buildTickerReport({
   if (metadataParts.length > 0) {
     lines.push(cliStyles.muted(metadataParts.join(METADATA_SEPARATOR)));
   }
+  // A receipt and its home line each state the ratio, and where the two are compared.
+  const depositaryPair = listingDepositaryPair(financials);
+  if (depositaryPair) {
+    lines.push(cliStyles.muted(`ADR ratio ${depositaryPairText(depositaryPair, isReceiptSide(financials))}. Implied FX and premium: gloom fn ADR ${quote?.symbol ?? symbol}`));
+  }
 
   // A list that holds the company as another of its listings says which: "Watchlists R (as RCI.B:TSX)".
   const lists = memberships ?? companyMemberships(config, tickerFile, [], null);
@@ -1070,7 +1166,7 @@ export async function buildTickerReport({
 
   // Market cap and the multiples are measured at the regular session price the Quote section heads with.
   const priced = atRegularSessionPrice(financials);
-  const capitalization = selectMarketCapitalization(priced.quote, priced.fundamentals);
+  const capitalization = viewMarketCapitalization(priced.quote, priced.fundamentals, regularSessionValuationPrice(priced.quote));
   // Market cap and EV read in the currency they are reported in, as the revenue and income beside them do,
   // with the base currency's figure after them when it differs: 627.2B USD (878.15B CAD).
   const convertedCurrencies = new Set<string>();
@@ -1107,12 +1203,14 @@ export async function buildTickerReport({
     // A futures price is its latest trade; the exchange settlement is its own row, dated by its session.
     appendMetricSection(lines, "Quote", [
       // A price in cents says what it is per: 314.95¢/lb.
-      ["Last", colorBySign(`${formatMarketPriceWithCurrency(session.price, quote.currency, quoteOptions)}${minorUnitPricePer(futuresContract, quote.currency)}`, session.change)],
+      ["Last", colorBySign(`${formatMarketPriceWithCurrency(session.price, quote.currency, quoteOptions)}${futuresPricePer(futuresContract, quote.currency)}`, session.change)],
       ...futuresContract
-        ? [["Settle", futuresSettleText(futuresContract, quote)] as [string, string]]
+        ? [["Settle", quoteSettleText(quote, futuresContract)] as [string, string]]
         : [],
       // The move says what it is measured from: "vs Fri 16 Oct close", a future's "vs Fri 16 Oct settle".
       ["Change", quoteChangeText(quote, session, quoteOptions, futuresContract)],
+      // European gas beside Henry Hub: "≈ $30.832/MMBtu at EUR/USD 1.1650", a conversion that says so.
+      ...usdPerMmbtu ? [["In USD", usdPerMmbtuText(usdPerMmbtu)] as [string, string]] : [],
       ["Open", quote.open != null ? formatMarketPriceWithCurrency(quote.open, quote.currency, quoteOptions) : "—"],
       // A listing that no longer trades: its last session's range, never today's.
       [quote.delisting ? "Last Session" : "Day Range", quote.low != null || quote.high != null
@@ -1137,9 +1235,22 @@ export async function buildTickerReport({
 
   const metrics = fundamentalsMetrics(quote, priced.fundamentals, profile, { text: marketCapText }, priceReturns, fundamentalsCurrency(financials),
     { text: enterpriseValueText }, distributions, bondFund, codes);
+  const reportedCurrency = financials.financialCurrency?.trim();
+  const statements = [...financials.annualStatements, ...financials.quarterlyStatements];
+  const fallbackCurrency = reportedCurrency && statements.every((row) => !row.currency?.trim() || row.currency.trim() === reportedCurrency)
+    ? reportedCurrency : undefined;
+  const statementCurrency = (row: FinancialStatement) => row.currency?.trim() || fallbackCurrency;
+  const latestAnnual = latestFinancialPeriod(financials.annualStatements, row => row.date);
+  const latestQuarter = latestFinancialPeriod(financials.quarterlyStatements, row => row.date);
+
   const beforeFundamentals = lines.length;
   appendMetricSection(lines, "Fundamentals", metricLines(metrics));
   for (const note of fundamentalsNotes(priced, metrics, quote?.currency)) lines.push(cliStyles.muted(note));
+  // The trailing block beside statements in another currency, when no conversion says why.
+  const split = metrics.some((metric) => TRAILING_MONEY_METRICS.has(metric.label) && metric.text !== "—")
+    ? ttmCurrencySplitNote(priced.fundamentals, [latestAnnual, latestQuarter].flatMap((row) => row ? [statementCurrency(row)] : []))
+    : undefined;
+  if (split) lines.push(cliStyles.muted(split));
   if (lines.length > beforeFundamentals) for (const note of conversionNotes(toBase, convertedCurrencies, rates)) lines.push(cliStyles.muted(note));
   // Where a fund's facts would go: under its fundamentals, or in their place.
   const fund = fundFactsNote(quote?.symbol ?? symbol,
@@ -1150,26 +1261,24 @@ export async function buildTickerReport({
     lines.push(cliStyles.muted(`Market cap: ${describeFundamentalMarketCap(capitalization.provenance)}.`));
   }
 
-  const reportedCurrency = financials.financialCurrency?.trim();
-  const statements = [...financials.annualStatements, ...financials.quarterlyStatements];
-  const fallbackCurrency = reportedCurrency && statements.every((row) => !row.currency?.trim() || row.currency.trim() === reportedCurrency)
-    ? reportedCurrency : undefined;
-  const statementCurrency = (row: FinancialStatement) => row.currency?.trim() || fallbackCurrency;
-  const latestAnnual = latestFinancialPeriod(financials.annualStatements, row => row.date);
   if (latestAnnual) {
     appendMetricSection(lines, `Latest Annual (${statementPeriodText(latestAnnual.date, statementFilings?.latestAnnual ?? null)})`,
       buildStatementMetrics(latestAnnual, statementCurrency(latestAnnual), codes));
   }
 
-  const latestQuarter = latestFinancialPeriod(financials.quarterlyStatements, row => row.date);
   if (latestQuarter) {
+    const runway = cashRunway(financials);
     appendMetricSection(lines, `Latest Quarter (${statementPeriodText(latestQuarter.date, statementFilings?.latestQuarter ?? null)})`,
-      buildStatementMetrics(latestQuarter, statementCurrency(latestQuarter), codes));
+      buildStatementMetrics(latestQuarter, statementCurrency(latestQuarter), codes, runway));
+    // How the months are counted, and an offering since the balance sheet that the cash does not include yet.
+    if (burnsCash(runway)) lines.push(cliStyles.muted(runwayMethod(runway.includesShortTerm)));
+    const offering = runway ? offeringNote(offeringsAfter(offerings, runway.periodEnd), runway.periodEnd) : null;
+    if (offering) lines.push(cliStyles.muted(offering));
   }
   // The statements stop a quarter short of the results the company has released.
   if (statementFilings?.resultsRelease && (latestAnnual || latestQuarter)) lines.push(cliStyles.muted(resultsReleaseText(statementFilings.resultsRelease)));
 
-  appendTextSection(lines, "Description", profile?.description);
+  appendDescription(lines, profile);
 
   appendTextSection(lines, "Notes", notes, true);
 
@@ -1184,7 +1293,7 @@ export async function buildTickerReport({
     ],
     body: item.summary,
     link: item.url,
-  })));
+  })), recentNews[0]?.searchedFor ? coinNewsFallbackNotice(symbol, recentNews[0].searchedFor) : null);
 
   appendFeedSection(lines, "Recent SEC Filings", recentSecFilings.map((filing) => ({
     title: (() => {
@@ -1216,17 +1325,22 @@ function buildTickerStructuredData({
   recentSecFilings,
   hiddenSecFilings,
   futuresContract,
+  usdPerMmbtu = null,
   distributions,
   statementFilings,
   bondFund = null,
   memberships,
+  offerings = [],
 }: {
   symbol: string;
   listing: CliListing;
   memberships: CompanyMemberships;
   statementFilings: StatementFilingsReport | null;
+  offerings?: readonly OfferingFiling[];
   bondFund?: FundBondFacts | null;
   futuresContract: FuturesContractTermsPayload | null;
+  /** A per-MWh gas price in dollars per MMBtu, and the rate it was converted at. */
+  usdPerMmbtu?: UsdPerMmbtu | null;
   distributions: DividendDistributions | null;
   tickerFile: TickerRecord | null;
   financials: TickerFinancials;
@@ -1241,6 +1355,7 @@ function buildTickerStructuredData({
   const identity = listingIdentity(listing, quote);
   // Market cap and the multiples at the regular session price, as the text report gives them.
   const priced = atRegularSessionPrice(financials);
+  const runway = cashRunway(financials);
   return {
     symbol,
     listing: { symbol: identity.symbol, exchange: identity.exchange || null, name: identity.name },
@@ -1266,8 +1381,11 @@ function buildTickerStructuredData({
       lastUpdated: quote.lastUpdated ? new Date(quote.lastUpdated).toISOString() : "",
     } : null,
     quoteMetadata: financials.quoteMetadata,
+    // The receipt pair the listing is a side of, and which side.
+    ...depositaryPairJson(financials),
     // Only for futures: the contract the symbol prices, its terms and its latest confirmed settlement.
     ...futuresContract ? { futuresContract } : {},
+    ...usdPerMmbtu ? { usdPerMmbtu } : {},
     ticker: tickerFile ? {
       ticker: tickerFile.metadata.ticker,
       name: tickerFile.metadata.name ?? "",
@@ -1294,6 +1412,10 @@ function buildTickerStructuredData({
     latestQuarter: latestFinancialPeriod(financials.quarterlyStatements, row => row.date) ?? null,
     annualStatementCount: financials.annualStatements.length,
     quarterlyStatementCount: financials.quarterlyStatements.length,
+    // Months of cash at the latest quarter's balance sheet, at its operating burn and the trailing year's,
+    // and the offering prospectuses filed since that the cash does not include.
+    cashRunway: runway,
+    offeringsAfterBalanceSheet: runway ? offeringsAfter(offerings, runway.periodEnd) : [],
     // The form and filed date of the latest periods' filings, and a newer quarter's results released before its statements.
     statementFilings,
     notes,
@@ -1321,6 +1443,13 @@ function buildTickerStructuredData({
   };
 }
 
+function depositaryPairJson(financials: TickerFinancials) {
+  const pair = listingDepositaryPair(financials);
+  if (!pair) return {};
+  const receipt = isReceiptSide(financials);
+  return { depositaryPair: { ...pair, side: receipt ? "receipt" : "home", text: depositaryPairText(pair, receipt) } };
+}
+
 const QUOTE_UNAVAILABLE = "Quote unavailable.";
 
 /** Asks for the quote the report lacks once more, for the reason the data service gave when it had none. */
@@ -1422,6 +1551,8 @@ export async function ticker(symbol: string, dependencies: TickerCommandDependen
       loadTickers: () => store.loadAllTickers(),
       dataProvider,
     });
+    // An offering since the latest balance sheet, read only when the report has a runway to flag.
+    const offerings = loadOfferingFilings(statementSources, { symbol: requestSymbol, exchange }, cashRunway(resolvedFinancials) != null);
     const [notesResult, newsResult, secFilingsResult] = await Promise.allSettled([
       notesFiles.load(tickerFile?.metadata.ticker ?? normalized),
       dataProvider.getNews({
@@ -1432,6 +1563,10 @@ export async function ticker(symbol: string, dependencies: TickerCommandDependen
         exchange: exchange || quote?.exchangeName || "",
         tickerTier: "primary",
         limit: NEWS_ITEM_LIMIT,
+        // A coin pair with no story filed under it searches for the coin by this name.
+        ...(isRoundTheClockCoin(requestSymbol, exchange || quote?.exchangeName) && (quote?.name || tickerFile?.metadata.name)
+          ? { listingName: quote?.name || tickerFile?.metadata.name }
+          : {}),
       }),
       // Outside the US the lookup checks the SEC registrant against the listing's company,
       // and refuses another company's filings.
@@ -1442,6 +1577,9 @@ export async function ticker(symbol: string, dependencies: TickerCommandDependen
     ]);
 
     const futuresContract = await cliFuturesContract(quote?.symbol ?? requestSymbol, quote?.instrumentType, dependencies.futuresContract);
+    // A per-MWh gas price (TTF) adds its dollars per MMBtu at the day's rate, to read beside Henry Hub.
+    const usdPerMmbtu = await loadUsdPerMmbtu(getRegularSessionDisplay(quote)?.price, futuresContract, quote?.currency,
+      (currency) => dataProvider.getExchangeRate(currency));
     const notes = notesResult.status === "fulfilled" ? notesResult.value : "";
     const recentNews = newsResult.status === "fulfilled" ? newsResult.value : [];
     const { filings: recentSecFilings, hidden: hiddenSecFilings } = secFilingsResult.status === "fulfilled"
@@ -1456,8 +1594,11 @@ export async function ticker(symbol: string, dependencies: TickerCommandDependen
       : notTheCoinNote(listing.symbol, quote ?? (tickerFile ? { name: tickerFile.metadata.name, instrumentType: tickerFile.metadata.assetCategory } : null));
     const listingNote = [choiceNote, coinNote].filter((note): note is string => !!note).join("\n") || undefined;
     const memberships = await membershipsLoad;
+    // A converted TTM block at the rate the rest of the report converts at, the one `fx` reports.
+    const shownFinancials = await atReportTtmRate(resolvedFinancials, toBase);
     if (dependencies.printResult) {
-      const warnings = [choiceNote, coinNote, quoteNote].filter((note): note is string => !!note);
+      const newsNote = recentNews[0]?.searchedFor ? coinNewsFallbackNotice(requestSymbol, recentNews[0].searchedFor) : null;
+      const warnings = [choiceNote, coinNote, quoteNote, newsNote].filter((note): note is string => !!note);
       dependencies.printResult({
         freshness,
         warnings: warnings.length > 0 ? warnings : undefined,
@@ -1465,17 +1606,19 @@ export async function ticker(symbol: string, dependencies: TickerCommandDependen
           symbol: normalized,
           listing,
           tickerFile,
-          financials: resolvedFinancials,
+          financials: shownFinancials,
           config,
           notes,
           recentNews,
           recentSecFilings,
           hiddenSecFilings,
           futuresContract,
+          usdPerMmbtu,
           distributions: await distributions,
           statementFilings: await statementFilings,
           bondFund: await bondFund,
           memberships,
+          offerings: await offerings,
         }),
       });
       return;
@@ -1485,7 +1628,7 @@ export async function ticker(symbol: string, dependencies: TickerCommandDependen
         symbol: normalized,
         listingExchange: listing.exchange,
         tickerFile,
-        financials: resolvedFinancials,
+        financials: shownFinancials,
         config,
         toBase,
         notes,
@@ -1495,11 +1638,13 @@ export async function ticker(symbol: string, dependencies: TickerCommandDependen
         recentSecFilings,
         hiddenSecFilings,
         futuresContract,
+        usdPerMmbtu,
         distributions: await distributions,
         statementFilings: await statementFilings,
         bondFund: await bondFund,
         memberships,
+        offerings: await offerings,
     }));
-    if (freshness) console.log(`\n${cliFreshnessFooter(freshness)}`);
+    if (freshness) console.log(`\n${cliFreshnessFooter(freshness, quote ?? resolvedFinancials)}`);
   });
 }

package/src/cli/context.ts

@@ -10,7 +10,7 @@ import type { PluginCapability } from "../capabilities";
 import type { AppConfig } from "../types/config";
 import type { GloomPlugin } from "../types/plugin";
 import { getLoadablePlugins } from "../plugins/catalog";
-import { standaloneSeriesInvoker } from "../series/standalone";
+import { standaloneSeriesCatalog, standaloneSeriesInvoker } from "../series/standalone";
 import type { PluginRegistry } from "../plugins/registry";
 import type { LoadedExternalPlugin } from "../plugins/loader";
 import { apiClient } from "../api-client";
@@ -131,7 +131,8 @@ export async function initMarketData(options: CliContextOptions = {}): Promise<M
   dataProvider.setConfigAccessor(() => context.config);
   dataProvider.setBackgroundRevalidation(false);
   const seriesCapabilities = standaloneSeriesInvoker(plugins, context.dataDir, context.config.disabledPlugins);
-  return { ...context, dataProvider, seriesCapabilities, statementSources: cloudStatementReportSources };
+  const findCatalogSeries = standaloneSeriesCatalog(plugins, context.config.disabledPlugins);
+  return { ...context, dataProvider, seriesCapabilities, findCatalogSeries, statementSources: cloudStatementReportSources };
 }
 
 export async function initCliServices(options: CliServicesOptions = {}) {