gloomberb 0.18.0 → 0.18.2

package/src/cli/commands/news-search.ts

@@ -2,6 +2,9 @@ import { apiClient } from "../../api-client";
 import type { NewsArticle } from "../../news/types";
 import { mapCloudNewsArticle } from "../../sources/gloomberb-cloud/news";
 import { cliStyles } from "../../utils/cli-output";
+import { logFailure } from "../../utils/log-failure";
+import { commodityNamedIn, commoditySearchName, isCommodityName } from "../../market-data/commodity-names";
+import type { FuturesContract } from "../../market-data/futures-board";
 
 /** What the service accepts of a search: two characters to two hundred, with a letter or a number in them. */
 const MIN_TEXT_LENGTH = 2;
@@ -60,8 +63,8 @@ export function newsSearchTextProblem(text: string): string | null {
 
 /**
  * The word a symbol lookup found no stories for, as text to search stories for.
- * Null under three characters, where the fuzzy match finds names that merely
- * contain it (ZN, Telomir-Zn) and the lookup's own answer is the better one.
+ * Null under three characters, where the word is mostly a piece of other
+ * names (ZN in Telomir-Zn) and the lookup's own answer is the better one.
  */
 export function newsFallbackText(symbol: string): string | null {
   const text = symbol.trim().replace(/^\$/, "");
@@ -69,15 +72,39 @@ export function newsFallbackText(symbol: string): string | null {
 }
 
 /**
- * The stories matching the text, newest first. The service answers best match
- * first and holds stories back from an account without real-time access, as
- * every other news request.
+ * The stories matching the text, in the service's order: stories with every
+ * word in the headline first, then the ones with some only in the summary,
+ * newest first within each. The service holds stories back from an account
+ * without real-time access, as every other news request.
  */
 export async function searchNewsStories(text: string, limit: number): Promise<NewsArticle[]> {
   const response = await apiClient.searchCloudNews(text, limit);
-  return response.items
-    .map((item) => mapCloudNewsArticle(item))
-    .sort((a, b) => b.publishedAt.getTime() - a.publishedAt.getTime());
+  return response.items.map((item) => mapCloudNewsArticle(item));
+}
+
+/** The futures news route a search offers when no story matches it: `gloomberb news KC=F` for "arabica". */
+export interface CommodityNewsRoute {
+  contract: FuturesContract;
+  command: string;
+}
+
+/**
+ * The future of the commodity a search names, offered when no story matched:
+ * `news KC=F` searches the stories of coffee, so it is offered only when
+ * those are not what just found nothing and they have a story to show.
+ */
+export async function commodityNewsRoute(text: string): Promise<CommodityNewsRoute | null> {
+  const contract = commodityNamedIn(text);
+  const name = contract ? commoditySearchName(contract) : null;
+  if (!contract || !name || isCommodityName(text, name)) return null;
+  const stories = await searchNewsStories(name, 1).catch(logFailure("cli.news-search", "Search a commodity's stories failed", []));
+  return stories.length > 0 ? { contract, command: `gloomberb news ${contract.symbol}` } : null;
+}
+
+/** What a search that matched no story says: never a near miss, and the commodity's futures news where it has some. */
+export function noStoriesMessage(text: string, route: CommodityNewsRoute | null): string {
+  const none = `No stories match "${text}".`;
+  return route ? `${none} For the ${route.contract.name} future, try: ${route.command}` : none;
 }
 
 /** The line above the stories: "Stories matching "european gas"", with why a word typed as a symbol is searched. */

package/src/cli/commands/overview.ts

@@ -22,6 +22,7 @@ import {
 } from "../../plugins/builtin/market-movers/model";
 import { MOVER_CANDIDATES } from "../../plugins/builtin/market-movers/client";
 import { fetchEconCalendarFrom } from "../../plugins/builtin/econ/calendar-source";
+import { seriesNotOnFred } from "../../sources/gloomberb-cloud/fred-series";
 import { EXTENDED_SESSION_LABELS, getQuoteSessionFields, type ExtendedSession } from "../../market-data/market/status";
 import {
   COUNTRY_CYCLE,
@@ -311,9 +312,27 @@ function parseFilter<T extends string>(value: string | undefined, values: readon
   return match;
 }
 
+/** One of the pane's regions, or any country by its two-letter code (TR, DE), upper-cased. */
+function parseCountry(value: string | undefined, ctx: Parameters<CliCommandDef["execute"]>[1]): CountryFilter {
+  if (value == null) return COUNTRY_CYCLE[0]!;
+  const text = value.trim();
+  const region = COUNTRY_CYCLE.find((candidate) => candidate.toLowerCase() === text.toLowerCase());
+  if (region) return region;
+  if (/^[a-z]{2}$/i.test(text)) return text.toUpperCase();
+  return ctx.fail(`Unknown country "${value}".`, `Use ${COUNTRY_CYCLE.join(", ")}, or a two-letter country code such as TR.`);
+}
+
+/** A country the calendar lists nothing for says which ones it does list, so a typo (UK for GB) is not read as a quiet week. */
+function unlistedCountryMessage(country: CountryFilter, events: ReadonlyArray<{ country: string }>): string | null {
+  if ((COUNTRY_CYCLE as readonly string[]).includes(country)) return null;
+  const listed = [...new Set(events.map((event) => event.country).filter((code) => /^[A-Z]{2}$/.test(code)))].sort();
+  if (listed.length === 0 || listed.includes(country)) return null;
+  return `The calendar lists no ${country} events; it lists ${listed.join(", ")}.`;
+}
+
 async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>[1]) {
   const rawArgs = [...args];
-  const country: CountryFilter = parseFilter(takeOption(rawArgs, "--country"), COUNTRY_CYCLE, "country", ctx);
+  const country = parseCountry(takeOption(rawArgs, "--country"), ctx);
   const impact: ImpactFilter = parseFilter(takeOption(rawArgs, "--impact"), FILTER_CYCLE, "impact", ctx);
   const fromOption = parseDateOption(takeOption(rawArgs, "--from"), "--from", ctx);
   rejectArgs(rawArgs, ECON_USAGE, ctx, "Filter with --country and --impact.");
@@ -363,7 +382,7 @@ async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>
     }, {
       dateKey: "date",
       defaultLimit: 50,
-      empty: econEmptyMessage(from, listedThrough, listedAfter != null),
+      empty: unlistedCountryMessage(country, events) ?? econEmptyMessage(from, listedThrough, listedAfter != null),
       ...(footnote ? { footnote } : {}),
       columns: [
         // Text shows both halves of the event timestamp in UTC, never the host's zone; exports keep the source values.
@@ -485,7 +504,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   const periodicity = periodicityOf(data.info?.frequency);
   const newestDate = rows.reduce<string | null>((newest, row) => (!newest || row.date > newest ? row.date : newest), null);
   // A newest value FRED does not list yet names its publisher, Treasury for a yield; FRED's own stay "FRED".
-  const ahead = fredProvenance(data.observations.filter((observation) => observation.date === newestDate));
+  const ahead = fredProvenance(data.observations.filter((observation) => observation.date === newestDate), seriesId);
   // FRED names the series' publisher when Gloom Cloud passes it on, and when it last updated the series.
   const publisher = ahead?.publisher ?? data.info?.source?.trim();
   const publishedAt = ahead ? ahead.publishedAt : fredPublicationTime(data.info, newestDate);
@@ -498,7 +517,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
       ...(latest ? { latestObservation: exportRow(latest) } : {}),
     },
     freshness: rowsFreshness(rows, {
-      source: ahead?.source ?? "FRED", status: "not-a-feed", basis: "published statistics", observedKey: "date", oldest: null,
+      source: ahead?.source ?? notOnFredSource(seriesId) ?? "FRED", status: "not-a-feed", basis: "published statistics", observedKey: "date", oldest: null,
       // A monthly or quarterly observation is dated the first of its period, not a day it was seen.
       ...(periodicity ? { periodicity } : {}),
       ...(publisher ? { publisher } : {}),
@@ -522,6 +541,12 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   });
 }
 
+/** Who a series FRED does not carry comes from, for a source line whose rows do not name it: `TurkStat via the CBRT`. */
+function notOnFredSource(seriesId: string): string | null {
+  const elsewhere = seriesNotOnFred(seriesId);
+  return elsewhere ? `${elsewhere.publisher} via ${elsewhere.via}` : null;
+}
+
 const YIELD_TENORS: Record<string, string> = { DGS3MO: "3M", DGS2: "2Y", DGS10: "10Y", DGS30: "30Y" };
 
 async function runYieldCurve(rawArgs: string[], ctx: Parameters<CliCommandDef["execute"]>[1]) {
@@ -672,11 +697,11 @@ export const overviewCliCommands: CliCommandDef[] = [
       group: CLI_COMMAND_GROUPS.markets,
       usage: [ECON_USAGE],
       options: [
-        { flags: "--country <region>", description: "US, G7, EU, or all (default all)" },
+        { flags: "--country <region>", description: "US, G7, EU, all (default), or one country by its two-letter code, such as TR" },
         { flags: "--impact <level>", description: "high, medium, low, or all (default all)" },
         { flags: "--from <date>", description: `First day listed, as ${DATE_OPTION_EXAMPLES} (default today, UTC); an earlier day lists past events from the stored calendar and says where it starts` },
       ],
-      examples: ["econ", "econ --country US --impact high", "econ --from 2026-10-12 --country US", "econ --tail 20"],
+      examples: ["econ", "econ --country US --impact high", "econ --country TR", "econ --from 2026-10-12 --country US", "econ --tail 20"],
     },
     execute: runEcon,
   },

package/src/cli/commands/system.ts

@@ -5,6 +5,7 @@ import { saveConfig } from "../../data/config/store";
 import { builtinPluginGroupMembers } from "../../plugins/ownership";
 import type { AppConfig, TelemetryConfig } from "../../types/config";
 import { canonicalTimeZone } from "../../utils/utc-time";
+import { readBaseCurrency } from "../../utils/base-currency";
 import { NIGHTLY_CHANNEL_SUMMARY, parseUpdateChannel, withUpdateChannel } from "../../updater/channel";
 import type { CliCommandDef } from "../../types/plugin";
 import { resolveCliDataDir, withCliServices, withConfigData } from "../context";
@@ -65,6 +66,32 @@ function parseTimezoneSetting(value: string): string | null {
   );
 }
 
+/**
+ * The code `config set baseCurrency` stores (`cad` is CAD); fails on a name
+ * or sign, naming the code it stands for, and on anything that is no code.
+ */
+function parseBaseCurrencySetting(value: string): string {
+  const reading = readBaseCurrency(value);
+  if ("code" in reading) return reading.code;
+  const [first] = reading.suggestions;
+  return fail(reading.error, first
+    ? `baseCurrency takes an ISO 4217 code: gloomberb config set baseCurrency ${first}`
+    : "baseCurrency takes an ISO 4217 code such as USD, EUR or CAD.");
+}
+
+/** A saved base currency that is no code (an older version stored names), with what to set instead; null for a code. */
+function baseCurrencyProblem(value: unknown): string | null {
+  const reading = readBaseCurrency(typeof value === "string" ? value : "");
+  if ("code" in reading) return null;
+  const [first] = reading.suggestions;
+  return `${reading.error} Set one: gloomberb config set baseCurrency ${first ?? "<code>"}`;
+}
+
+function describeBaseCurrency(value: unknown): string {
+  const problem = baseCurrencyProblem(value);
+  return problem ? `${String(value)} ${cliStyles.warning(`(${problem})`)}` : String(value);
+}
+
 function describeTimezone(value: unknown): string {
   return typeof value === "string" && value ? value : "not set, times print in UTC alone";
 }
@@ -189,6 +216,9 @@ export function createSystemCliCommands(): CliCommandDef[] {
           checks.push({ check: "database", status: "ok", detail: join(services.dataDir, ".gloomberb-cache.db") });
           checks.push({ check: "plugins", status: "ok", detail: String(services.services.pluginRegistry.allPlugins.size) });
           checks.push({ check: "capabilities", status: "ok", detail: String(services.services.pluginRegistry.capabilities.manifests().length) });
+          // Only a saved value no conversion can price is worth a line.
+          const baseCurrencyIssue = baseCurrencyProblem(services.config.baseCurrency);
+          if (baseCurrencyIssue) checks.push({ check: "baseCurrency", status: "warn", detail: baseCurrencyIssue });
           const theme = services.config.theme;
           checks.push({
             check: "theme",
@@ -311,6 +341,7 @@ export function createSystemCliCommands(): CliCommandDef[] {
               ...(key === KEYBINDINGS_CONFIG_KEY ? { format: summarizeKeybindings } : {}),
               ...(key === "theme" ? { format: (value: unknown) => describeThemeId(String(value)) } : {}),
               ...(key === TIMEZONE_CONFIG_KEY ? { format: describeTimezone } : {}),
+              ...(key === "baseCurrency" ? { format: describeBaseCurrency } : {}),
             })),
           });
           return;
@@ -329,7 +360,8 @@ export function createSystemCliCommands(): CliCommandDef[] {
           }
           ctx.printResult({ data: { key, value: safeConfig[key] } }, {
             text: (data) => key === KEYBINDINGS_CONFIG_KEY ? renderKeybindings(data.value)
-              : key === TIMEZONE_CONFIG_KEY ? describeTimezone(data.value) : describeConfigValue(data.value),
+              : key === TIMEZONE_CONFIG_KEY ? describeTimezone(data.value)
+                : key === "baseCurrency" ? describeBaseCurrency(data.value) : describeConfigValue(data.value),
           });
           return;
         }
@@ -367,6 +399,8 @@ export function createSystemCliCommands(): CliCommandDef[] {
           // A display name may come unquoted: config set theme White Phosphor.
           const parsedValue = key === "theme"
             ? requireThemeId(args.slice(2).join(" "))
+            : key === "baseCurrency"
+              ? parseBaseCurrencySetting(args.slice(2).join(" "))
             : key === TIMEZONE_CONFIG_KEY
               ? parseTimezoneSetting(value)
               : key === UPDATE_CHANNEL_CONFIG_KEY

package/src/cli/commands/ticker.ts

@@ -8,11 +8,12 @@ import { describeFundamentalMarketCap, marketCapShareBasisNote, selectMarketCapi
 import {
   formatCompact,
   formatCurrency,
+  formatCurrencyCode,
   formatNumber,
   formatPercent,
   formatPercentRaw,
 } from "../../utils/format";
-import { formatMarketCostWithCurrency, formatMarketPriceWithCurrency, formatMarketQuantity, formatMarketChangeWithCurrency, quoteFormatOptions, withCurrencyMinorDigits, type MarketFormatOptions } from "../../market-data/market/format";
+import { formatMarketCostWithCurrency, formatMarketPriceWithCurrency, formatMarketQuantity, quoteFormatOptions, withCurrencyMinorDigits, type MarketFormatOptions } from "../../market-data/market/format";
 import {
   cliStyles,
   cliTerminalWidth,
@@ -28,14 +29,16 @@ import {
   getExtendedSessionDisplay,
   getQuoteSessionFields,
   getRegularSessionDisplay,
+  quoteBookSessionLabel,
   quoteHeadlineTime,
   quoteMarketStateLabel,
 } from "../../market-data/market/status";
 import type { FuturesContractTermsPayload } from "../../api-client/futures-curve";
-import { futuresContractLines, futuresSettleText, isFuturesInstrument, loadFuturesContractTerms } from "../../market-data/futures-contract";
+import { changeBasisJson, quoteChangeBasis, quotePreviousCloseDate } from "../../market-data/market/change-basis";
+import { futuresContractLines, futuresSettleText, isFuturesInstrument, loadFuturesContractTerms, minorUnitPricePer } from "../../market-data/futures-contract";
+import { currencyCodeLabel } from "../../utils/currency-units";
 import type { AppConfig } from "../../types/config";
 import type { DeclaredDividendAction, FinancialStatement, Quote, TickerFinancials } from "../../types/financials";
-import { quoteTradingDay } from "../../market-data/quotes/day-range";
 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";
@@ -44,9 +47,10 @@ import type { SecFilingItem } from "../../types/data-provider";
 import type { NewsArticle } from "../../news/types";
 import type { TickerRecord } from "../../types/ticker";
 import type { CliCommandContext } from "../../types/plugin";
-import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, resolvePortfolioMarketValue, resolvePortfolioPositionPnl } from "../../portfolio/position-metrics";
+import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, lotCostFxRate, resolvePortfolioMarketValue, resolvePortfolioPositionPnl } from "../../portfolio/position-metrics";
 import { isFuturesTicker } from "../../portfolio/futures-positions";
-import { createBaseConverter } from "../base-converter";
+import { createBaseConverter, type BaseConversion } from "../base-converter";
+import { formatFxRate } from "../fx-pair";
 import { initMarketData, withMarketData } from "../context";
 import { fail } from "../errors";
 import type { MarketContext } from "../types";
@@ -58,6 +62,7 @@ import {
   formatSignedCurrency,
   formatTimestamp,
   formatWatchlistNames,
+  quoteChangeText,
 } from "../helpers";
 import { NotesFiles } from "../../plugins/builtin/notes/files";
 import { isKnownNonUsListing, secFilingItemCodes } from "../../utils/sec";
@@ -106,10 +111,6 @@ async function loadRecentSecFilings(
 // Prose such as a company description stays readable on wide terminals.
 const MAX_PROSE_WIDTH = 100;
 const METADATA_SEPARATOR = "  ·  ";
-const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
-const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
-/** The states the header reads as CLOSED: the venue is between sessions, so nobody is quoting. */
-const CLOSED_MARKET_STATES = new Set<string>(["CLOSED", "PREPRE", "POSTPOST"]);
 
 interface TickerCommandDependencies {
   /** `--exchange`: the listing, for a symbol that trades in several places. */
@@ -149,25 +150,22 @@ function appendMetricSection(lines: string[], title: string, metrics: Array<[str
 }
 
 /**
- * A closed market's bid and ask are the last quote of its session, not an open book (ITA's $202.00 against
- * $208.74 around a $206.65 close): say so, with the day the quote is from.
+ * Out of the regular session the bid and ask say whose book they are: the pre-market or after-hours book beside
+ * Last and the extended print, or a closed market's last quote with its day (ITA's $202.00 against $208.74
+ * around a $206.65 close is no open book).
  */
 function bidAskText(quote: Quote, options: MarketFormatOptions): string {
   const text = formatBidAsk(quote.bid, quote.ask, quote.bidSize, quote.askSize, quote.currency, options);
-  if (text === "—" || !quote.marketState || !CLOSED_MARKET_STATES.has(quote.marketState)) return text;
-  const day = quoteTradingDay(quote);
-  const date = day ? new Date(`${day}T00:00:00Z`) : null;
-  const label = date && Number.isFinite(date.getTime())
-    ? `, ${WEEKDAYS[date.getUTCDay()]} ${date.getUTCDate()} ${MONTHS[date.getUTCMonth()]}` : "";
-  return `${text}  ${cliStyles.muted(`(last quote${label})`)}`;
+  const label = text === "—" ? null : quoteBookSessionLabel(quote);
+  return label ? `${text}  ${cliStyles.muted(`(${label})`)}` : text;
 }
 
 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): Array<[string, string]> {
-  const money = (value: number | undefined, perShare = false) => formatReportedMoney(value, currency, perShare);
+function buildStatementMetrics(statement: FinancialStatement, currency?: string, codes = false): Array<[string, string]> {
+  const money = (value: number | undefined, perShare = false) => formatReportedMoney(value, currency, perShare, codes);
   return [
     ["Revenue", money(statement.totalRevenue)],
     ["Gross Profit", money(statement.grossProfit)],
@@ -303,8 +301,11 @@ function shouldFetchSecFilings(
 }
 
 async function appendTickerPositions(lines: string[], tickerFile: TickerRecord | null, quote: TickerFinancials["quote"],
-  config: AppConfig, toBase: (value: number, currency: string) => Promise<number>): Promise<void> {
+  config: AppConfig, toBase: ReportBaseConverter): Promise<void> {
   const quoteCurrency = quote?.currency?.trim() || tickerFile?.metadata.currency?.trim() || "";
+  const codes = writesCurrencyCodes(config);
+  const money = codes ? formatCurrencyCode : formatCurrency;
+  const converted = new Set<string>();
   if (tickerFile && tickerFile.metadata.positions.length > 0) {
     lines.push("");
     lines.push(renderSection("Positions"));
@@ -318,10 +319,15 @@ async function appendTickerPositions(lines: string[], tickerFile: TickerRecord |
       const positionCurrency = metrics.positionCurrency;
       const currentPrice = getPortfolioQuoteDisplay(metrics, quote)?.price ?? null;
       const currentPriceBase = currentPrice != null && quoteCurrency ? await toBase(currentPrice, quoteCurrency) : null;
-      const costBasisBase = positionCurrency ? await toBase(metrics.signedCost, positionCurrency) : Number.NaN;
       const positionRate = positionCurrency ? await toBase(1, positionCurrency) : Number.NaN;
+      if (positionCurrency) converted.add(positionCurrency.toUpperCase());
+      if (quoteCurrency && currentPrice != null) converted.add(quoteCurrency.toUpperCase());
       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; any other at today's.
+      const costBasisBase = !positionCurrency ? Number.NaN
+        : lotCostFxRate(position, positionCurrency, config.baseCurrency) !== null ? baseMetrics.signedCost
+        : await toBase(metrics.signedCost, positionCurrency);
       const marketValueBase = resolvePortfolioMarketValue(baseMetrics, currentPriceBase)?.net ?? Number.NaN;
       const selectedPnl = resolvePortfolioPositionPnl(baseMetrics, currentPriceBase);
       const pnl = selectedPnl.value;
@@ -331,26 +337,51 @@ async function appendTickerPositions(lines: string[], tickerFile: TickerRecord |
       const stats: CliStatEntry[] = [
         [
           "Position",
-          `${formatMarketQuantity(metrics.totalShares, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, quantityCurrency: positionCurrency })} ${metrics.priceBasis === "percent-of-par" ? "@" : `${tickerFile.metadata.assetCategory === "BOND" ? "units" : contracts ? "contracts" : "shares"} @`} ${positionCurrency ? formatMarketCostWithCurrency(position.avgCost, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis }) : "—"}`,
+          `${formatMarketQuantity(metrics.totalShares, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, quantityCurrency: positionCurrency })} ${metrics.priceBasis === "percent-of-par" ? "@" : `${tickerFile.metadata.assetCategory === "BOND" ? "units" : contracts ? "contracts" : "shares"} @`} ${positionCurrency ? formatMarketCostWithCurrency(position.avgCost, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, currencyCode: codes }) : "—"}`,
         ],
-        ["Cost Basis", formatCurrency(costBasisBase, config.baseCurrency)],
-        ["Market Value", formatCurrency(marketValueBase, config.baseCurrency)],
+        ["Cost Basis", money(costBasisBase, config.baseCurrency)],
+        ["Market Value", money(marketValueBase, config.baseCurrency)],
         [
           selectedPnl.basis === "broker-snapshot" ? "Broker P&L" : "P&L",
-          pnl === null ? "—" : colorBySign(formatSignedCurrency(pnl, config.baseCurrency), pnl),
+          pnl === null ? "—" : colorBySign(formatSignedCurrency(pnl, config.baseCurrency, codes), pnl),
         ],
       ];
       if (position.markPrice != null) {
-        stats.push(["Broker Mark", positionCurrency ? formatMarketPriceWithCurrency(position.markPrice, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis }) : "—"]);
+        stats.push(["Broker Mark", positionCurrency ? formatMarketPriceWithCurrency(position.markPrice, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, currencyCode: codes }) : "—"]);
       }
       lines.push(renderStats(stats));
       if (index < positions.length - 1) {
         lines.push("");
       }
     }
+    for (const note of conversionNotes(toBase, converted)) lines.push(cliStyles.muted(note));
   }
 }
 
+/** 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[] };
+
+/**
+ * A base currency other than USD reads every amount with its code (259.36
+ * USD, 878.15B CAD): $ alone is also the Canadian, Australian and other
+ * dollars. A USD base keeps the signs it always had.
+ */
+export function writesCurrencyCodes(config: Pick<AppConfig, "baseCurrency"> | undefined): boolean {
+  const base = config?.baseCurrency?.trim().toUpperCase();
+  return !!base && base !== "USD";
+}
+
+/**
+ * "CAD at USD/CAD 1.40623, as of 2026-10-21 04:46 UTC.": the rate and its
+ * date for each currency in `currencies` the report converted into the base
+ * currency, so a converted figure is never without what it was converted at.
+ */
+function conversionNotes(toBase: ReportBaseConverter, currencies: ReadonlySet<string>): string[] {
+  return (toBase.conversions?.() ?? [])
+    .filter((conversion) => currencies.has(conversion.currency) && conversion.currency !== conversion.baseCurrency)
+    .map(({ currency, baseCurrency, rate, asOf }) => `${baseCurrency} figures at ${currency}/${baseCurrency} ${formatFxRate(rate)}${asOf != null ? `, as of ${formatTimestamp(asOf)}` : ""}.`);
+}
+
 /** A source's enterprise value is in the units of the capitalization it reports beside it,
  * which without a declared unit is the listing's quote currency (as the overview labels it). */
 function enterpriseValueCurrency(
@@ -375,9 +406,9 @@ interface FundamentalsMetric {
 
 type MetricFigure = Omit<FundamentalsMetric, "label">;
 
-/** An amount in the currency the source reported it in; `ccy?` when it named none, as the text says. */
-function reportedMoney(value: number | undefined, currency: string | undefined, perShare = false): MetricFigure {
-  return { text: formatReportedMoney(value, currency, perShare), value, unit: currency?.trim() || "ccy?" };
+/** An amount in the currency the source reported it in; `ccy?` when it named none, as the text says. `codes`: per share too (6.54 USD). */
+function reportedMoney(value: number | undefined, currency: string | undefined, perShare = false, codes = false): MetricFigure {
+  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. */
@@ -567,6 +598,7 @@ function fundamentalsMetrics(
   enterpriseValue = reportedMoney(reportedEnterpriseValue(fundamentals), enterpriseValueCurrency(quote, fundamentals)),
   distributions: DividendDistributions | null = null,
   bond: FundBondFacts | null = null,
+  codes = false,
 ): FundamentalsMetric[] {
   const signed = (value: number) => colorBySign(formatPercent(value), value);
   const receipt = fundamentals?.sharesOutstanding != null && sharesOutstandingInReceipts(quote, fundamentals, profile?.description);
@@ -578,7 +610,7 @@ function fundamentalsMetrics(
     { label: "Forward P/E", ...multipleFigure(priceEarningsOnEarnings(fundamentals?.forwardPE, fundamentals?.forwardEps)) },
     { label: "PEG", ...multipleFigure(fundamentals?.pegRatio) },
     // The flows and EPS are one trailing-twelve-month block, the same twelve months for each line.
-    { label: "EPS (TTM)", ...reportedMoney(fundamentals?.eps, fundamentals?.epsCurrency?.trim() || reportingCurrency, true) },
+    { label: "EPS (TTM)", ...reportedMoney(fundamentals?.eps, fundamentals?.epsCurrency?.trim() || reportingCurrency, true, codes) },
     {
       label: dividendYieldLabel(fundamentals?.dividendYieldBasis, bond),
       ...forwardYieldFigure(fundamentals, distributions),
@@ -681,6 +713,8 @@ type FundamentalsReportData = TickerFinancials & {
   bank?: BankFiguresPayload | null;
   /** In place of `bank`, for a bank whose figures could not be read. */
   bankNote?: string | null;
+  /** A base currency other than USD: every amount reads with its code (`writesCurrencyCodes`). */
+  currencyCodes?: boolean;
 };
 
 /** "Latest quarter 2026-06-30, 10-Q filed 2026-08-06." and the newer quarter's results release, for the lines under a report's figures. */
@@ -720,7 +754,10 @@ function valuationPriceMetrics(financials: FundamentalsReportData): Fundamentals
   const quote = financials.quote;
   const session = getRegularSessionDisplay(quote);
   if (!quote || !session) return [];
-  const options = withCurrencyMinorDigits(quoteFormatOptions(quote, undefined, financials.quoteMetadata?.instrumentType), quote.currency);
+  const options = withCurrencyMinorDigits({
+    ...quoteFormatOptions(quote, undefined, financials.quoteMetadata?.instrumentType),
+    ...financials.currencyCodes ? { currencyCode: true } : {},
+  }, quote.currency);
   const price = (value: number) => formatMarketPriceWithCurrency(value, quote.currency, options);
   const extended = getExtendedSessionDisplay(quote);
   const extendedLabel = extended ? EXTENDED_SESSION_LABELS[extended.session] : "";
@@ -729,7 +766,8 @@ function valuationPriceMetrics(financials: FundamentalsReportData): Fundamentals
     session.changePercent != null && Number.isFinite(session.changePercent)
       ? {
         label: "Change",
-        text: colorBySign(`${formatMarketChangeWithCurrency(session.change, quote.currency, options, session.price)} (${formatPercentRaw(session.changePercent)})`, session.change),
+        // With what the move is measured from, as `ticker` and `quote` say it: "vs Fri 16 Oct close".
+        text: quoteChangeText(quote, session, options),
         value: session.changePercent,
         unit: "%",
       }
@@ -764,7 +802,7 @@ function fundamentalsReportMetrics(snapshot: FundamentalsReportData, view: "fund
     ? { text: `${formatCompact(capitalization.value)} ${capitalization.currency}`, value: capitalization.value, unit: capitalization.currency }
     : { text: "—" };
   const metrics = fundamentalsMetrics(quote, fundamentals, financials.profile, marketCap, computeTickerPriceReturns(financials), fundamentalsCurrency(financials),
-    undefined, snapshot.distributions ?? null, snapshot.bondFund ?? null);
+    undefined, snapshot.distributions ?? null, snapshot.bondFund ?? null, snapshot.currencyCodes === true);
   if (view === "fundamentals") {
     return [...metrics, ...floatAndShortInterestMetrics(quote, fundamentals, financials.profile)]
       .filter((metric) => metric.text !== "—");
@@ -924,7 +962,7 @@ export async function buildTickerReport({
   tickerFile: TickerRecord | null;
   financials: TickerFinancials;
   config: AppConfig;
-  toBase: (value: number, fromCurrency: string) => Promise<number>;
+  toBase: ReportBaseConverter;
   notes?: string;
   /** Why there is no quote, when a source said; "Quote unavailable." otherwise. */
   quoteNote?: string;
@@ -941,8 +979,10 @@ export async function buildTickerReport({
   const profile = financials.profile;
   const name = quote?.name || tickerFile?.metadata.name || symbol;
   const baseQuoteOptions = quoteFormatOptions(quote, tickerFile?.metadata.assetCategory, financials.quoteMetadata?.instrumentType);
+  const baseCurrency = config.baseCurrency.trim().toUpperCase();
+  const codes = writesCurrencyCodes(config);
   // Pad money prices to the currency's minor unit so a range reads £35.10 - £35.485, never past it (JPY has none).
-  const quoteOptions = withCurrencyMinorDigits(baseQuoteOptions, quote?.currency);
+  const quoteOptions = withCurrencyMinorDigits(codes ? { ...baseQuoteOptions, currencyCode: true } : baseQuoteOptions, quote?.currency);
   const lines: string[] = [];
 
   lines.push(`${cliStyles.accent(quote?.symbol ?? symbol)} ${cliStyles.bold(name)}`);
@@ -953,9 +993,10 @@ export async function buildTickerReport({
   const indexLevel = isIndexLevel(quote?.instrumentType?.trim() || financials.quoteMetadata?.instrumentType?.trim() || tickerFile?.metadata.assetCategory);
   const summaryParts = [
     listingVenueLabel(listingExchange, quote, financials, tickerFile) || undefined,
-    indexLevel ? INDEX_POINTS_LABEL : quoteCurrency ? `Currency ${quoteCurrency}` : undefined,
+    indexLevel ? INDEX_POINTS_LABEL : quoteCurrency ? `Currency ${currencyCodeLabel(quoteCurrency)}` : undefined,
     quoteMarketStateLabel(quote) ?? undefined,
-    quote?.dataSource ? `Source ${quote.dataSource.toUpperCase()}` : undefined,
+    // A listing that no longer trades has no delay to speak of: its quote is its last session's close.
+    quote?.dataSource && !quote.delisting ? `Source ${quote.dataSource.toUpperCase()}` : undefined,
   ].filter((part): part is string => !!part);
   if (summaryParts.length > 0) {
     lines.push(cliStyles.muted(summaryParts.join(METADATA_SEPARATOR)));
@@ -991,21 +1032,25 @@ 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 convertedMarketCap = capitalization ? await toBase(capitalization.value, capitalization.currency) : Number.NaN;
+  // 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>();
+  const inBase = async (value: number, currency: string): Promise<string> => {
+    if (currency.trim().toUpperCase() === baseCurrency) return "";
+    const converted = await toBase(value, currency);
+    if (!Number.isFinite(converted)) return "";
+    convertedCurrencies.add(currency.trim().toUpperCase());
+    return ` (${formatCompact(converted)} ${baseCurrency})`;
+  };
   const marketCapText = capitalization
-    ? Number.isFinite(convertedMarketCap)
-      ? `${formatCompact(convertedMarketCap)} ${config.baseCurrency}`
-      : `${formatCompact(capitalization.value)} ${capitalization.currency}`
+    ? `${formatCompact(capitalization.value)} ${capitalization.currency}${await inBase(capitalization.value, capitalization.currency)}`
     : "—";
   // Shown in the same currency as the market cap, so the two can be compared.
   const enterpriseValue = reportedEnterpriseValue(priced.fundamentals);
   const evCurrency = enterpriseValueCurrency(quote, fundamentals);
   // A minor unit such as GBp stays as reported: the converter would read it as the major currency.
-  const convertedEnterpriseValue = enterpriseValue != null && evCurrency && /^[A-Z]{3}$/.test(evCurrency)
-    ? await toBase(enterpriseValue, evCurrency) : Number.NaN;
-  const enterpriseValueText = Number.isFinite(convertedEnterpriseValue)
-    ? `${formatCompact(convertedEnterpriseValue)} ${config.baseCurrency}`
-    : formatReportedMoney(enterpriseValue, evCurrency);
+  const enterpriseValueText = `${formatReportedMoney(enterpriseValue, evCurrency)}${enterpriseValue != null && evCurrency && /^[A-Z]{3}$/.test(evCurrency)
+    ? await inBase(enterpriseValue, evCurrency) : ""}`;
 
   if (quote) {
     // As the Overview reads it: the regular session, then the extended-hours print against its close.
@@ -1020,13 +1065,16 @@ export async function buildTickerReport({
     const volume = reportedQuoteVolume(quote);
     // A futures price is its latest trade; the exchange settlement is its own row, dated by its session.
     appendMetricSection(lines, "Quote", [
-      ["Last", colorBySign(formatMarketPriceWithCurrency(session.price, quote.currency, quoteOptions), session.change)],
+      // 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)],
       ...futuresContract
         ? [["Settle", futuresSettleText(futuresContract, quote)] as [string, string]]
         : [],
-      ["Change", colorBySign(`${formatMarketChangeWithCurrency(session.change, quote.currency, quoteOptions, session.price)} (${formatPercentRaw(session.changePercent)})`, session.change)],
+      // 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)],
       ["Open", quote.open != null ? formatMarketPriceWithCurrency(quote.open, quote.currency, quoteOptions) : "—"],
-      ["Day Range", quote.low != null || quote.high != null
+      // 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
         ? formatPriceRange(quote.low, quote.high, quote.currency, quoteOptions)
         : "—"],
       ["52W Range", quote.low52w != null || quote.high52w != null
@@ -1047,10 +1095,11 @@ export async function buildTickerReport({
   }
 
   const metrics = fundamentalsMetrics(quote, priced.fundamentals, profile, { text: marketCapText }, priceReturns, fundamentalsCurrency(financials),
-    { text: enterpriseValueText }, distributions, bondFund);
+    { text: enterpriseValueText }, distributions, bondFund, codes);
   const beforeFundamentals = lines.length;
   appendMetricSection(lines, "Fundamentals", metricLines(metrics));
   for (const note of fundamentalsNotes(priced, metrics, quote?.currency)) lines.push(cliStyles.muted(note));
+  if (lines.length > beforeFundamentals) for (const note of conversionNotes(toBase, convertedCurrencies)) 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,
     quote?.tradingExchangeName || listingExchange || quote?.listingExchangeName || quote?.exchangeName || tickerFile?.metadata.exchange, financials, tickerFile);
@@ -1068,13 +1117,13 @@ export async function buildTickerReport({
   const latestAnnual = latestFinancialPeriod(financials.annualStatements, row => row.date);
   if (latestAnnual) {
     appendMetricSection(lines, `Latest Annual (${statementPeriodText(latestAnnual.date, statementFilings?.latestAnnual ?? null)})`,
-      buildStatementMetrics(latestAnnual, statementCurrency(latestAnnual)));
+      buildStatementMetrics(latestAnnual, statementCurrency(latestAnnual), codes));
   }
 
   const latestQuarter = latestFinancialPeriod(financials.quarterlyStatements, row => row.date);
   if (latestQuarter) {
     appendMetricSection(lines, `Latest Quarter (${statementPeriodText(latestQuarter.date, statementFilings?.latestQuarter ?? null)})`,
-      buildStatementMetrics(latestQuarter, statementCurrency(latestQuarter)));
+      buildStatementMetrics(latestQuarter, statementCurrency(latestQuarter), codes));
   }
   // 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)));
@@ -1158,6 +1207,10 @@ function buildTickerStructuredData({
       name: quote.name,
       // Last and Change as the text report reads them, then the extended print from that close.
       ...getQuoteSessionFields(quote),
+      // What Change is measured from ("vs Fri 16 Oct close"), and the quote's previous close with its exchange-local date.
+      changeBasis: changeBasisJson(quoteChangeBasis(quote, { terms: futuresContract })),
+      previousClose: quote.previousClose ?? null,
+      previousCloseDate: quotePreviousCloseDate(quote),
       priceBasis: quote.priceBasis ?? null,
       currency: quote.currency,
       marketCap: priced.quote?.marketCap ?? null,