gloomberb 0.16.5 → 0.16.6

package/src/cli/commands/market.ts

@@ -69,6 +69,7 @@ import {
   type CliReportTables,
 } from "../report-tables";
 import {
+  historyBarStatusNote,
   historyFacts,
   historyFlagNote,
   historyGapNote,
@@ -78,6 +79,8 @@ import {
   historyPriceDecimals,
   historyRows,
   historyUnit,
+  historyVolume,
+  historyVolumeText,
 } from "../history-rows";
 import { CRYPTO_BOARD_HINT, quoteNotes } from "./crypto-hints";
 import { bareFuturesCode } from "../../market-data/futures-board";
@@ -97,6 +100,7 @@ import {
 } from "../../plugins/builtin/shared/report-freshness";
 import {
   bareListingNote,
+  tradingBoardNote,
   EXCHANGE_OPTION,
   futuresTryLine,
   isNoProviderError,
@@ -110,10 +114,13 @@ import {
   type ListingVenue,
   loadForListing,
   loadListingQuote,
+  listingFateLoader,
+  listingFateNotes,
   noLongerTradingNote,
   notTradedMessage,
   quoteBareListing,
   requireCliListing,
+  tradingListing,
   type CliListing,
   type ListingDataRequest,
   type ListingIdentity,
@@ -124,9 +131,12 @@ import { formatBasisPoints, toBasisPoints } from "../../utils/basis-points";
 import { providerMissReason } from "../../sources/provider-errors";
 import { isNotATickerMessage } from "../not-a-ticker";
 import { splitSymbolArgs } from "../symbol-args";
+import { cliPerpetualContract, perpetualContractStats, type PerpetualContractPayload } from "../perpetual-contract";
+import { subMinuteDataMessage } from "../known-gaps";
 import { secRegistrantMismatchMessage, SecRegistrantMismatchError, areDifferentCompanies } from "../../sources/sec-registrant";
 import { isCryptoPairSymbol } from "../../utils/crypto-pair";
 import { isUsListingExchange } from "../../utils/exchanges";
+import { describeTickerChange, startTickerChangeLookup, tickerChangeLine, type TickerChange } from "../../tickers/ticker-changes";
 import { noSecReportsNotice, nonUsSecListingVenue } from "../../utils/sec";
 import type { MarketContext } from "../types";
 import { windowRows } from "../row-window";
@@ -151,6 +161,7 @@ import {
   unvaluedHoldersNote,
 } from "../../plugins/builtin/holders/report-rows";
 import { fetchBeneficialOwners } from "../../plugins/builtin/holders/beneficial-client";
+import { centralBankEventsMessage } from "../central-bank-events";
 import { classSharesToday } from "../../plugins/builtin/holders/client";
 import { filingFormMatches, SEC_FILING_FETCH_LIMIT } from "../../plugins/builtin/sec/forms";
 import { loadParsedInsiderFilings } from "../../plugins/builtin/insider/client";
@@ -178,6 +189,10 @@ type QuoteCliRecord = Omit<QuoteBatchResult, "error"> & {
   listing?: { name: string | null };
   /** A futures row's contract, terms and latest confirmed settlement, as `ticker` reads them. */
   futuresContract?: FuturesContractTermsPayload;
+  /** A perpetual row's market, funding per eight hours and open interest. */
+  perpetualContract?: PerpetualContractPayload;
+  /** The symbol changed: its issuer moved to another symbol, or its holder had another before. */
+  tickerChange?: TickerChange;
 };
 type FinancialsCliData = TickerFinancials & {
   symbol: string;
@@ -524,19 +539,36 @@ async function runQuote(rawArgs: string[], ctx: Parameters<CliCommandDef["execut
     // Each costs a search, so a long list (a portfolio check, not a lookup) names none.
     const venues = new Map(listings.length > MAX_CHOICE_LOOKUPS ? []
       : listings.map((listing) => [listing, loadBareVenues(listing, market)] as const));
+    // So is whether a symbol changed (FB is now META), for the same lists.
+    const changes = new Map(listings.length > MAX_CHOICE_LOOKUPS ? []
+      : listings.map((listing) => [listing, startTickerChangeLookup(market.dataProvider, listing.symbol, listing.exchange)] as const));
     const results = await market.dataProvider.getQuotesBatch(targets, { forceRefresh: ctx.cliOptions.refresh });
     const listingOf = (result: QuoteBatchResult, index: number) => listings[targets.indexOf(result.target)] ?? listings[index]!;
+    const asked = results.map(listingOf);
     const request = { command: commandName, noun: "quote" };
     const answers = await Promise.all(results.map((result, index) => {
-      const listing = listingOf(result, index);
+      const listing = asked[index]!;
       return answerQuote(result, listing, market, request, ctx.cliOptions.refresh, venues.get(listing) ?? null);
     }));
+    const now = Date.now();
+    const tickerChanges = await Promise.all(answers.map(async ({ result }, index) => {
+      const listing = asked[index]!;
+      // A bare symbol read on a listing abroad (SXR8 -> XETRA) is not the US symbol the changes are of.
+      if (result.quote && bareListingNote(listing, result.quote)) return null;
+      return describeTickerChange(listing.symbol, await changes.get(listing)?.settle() ?? null, tradingListing(result.quote, now));
+    }));
     const failed = answers[0]?.failure;
-    if (listings.length === 1 && failed) ctx.fail(failed.message, failed.details);
+    if (listings.length === 1 && failed) {
+      ctx.fail(failed.message, [tickerChangeLine(tickerChanges[0]), failed.details].filter(Boolean).join("\n") || undefined);
+    }
     // A futures quote adds its dated settlement and contract terms, as `ticker` prints them; `compare` stays a table.
     const contracts = await Promise.all(answers.map(({ result }) => commandName === "quote" && result.quote
       ? cliFuturesContract(result.quote.symbol || result.target.symbol, result.quote.instrumentType)
       : null));
+    // A perpetual adds its funding per eight hours and open interest, the figures PERP lists beside its mark.
+    const perpetualContracts = await Promise.all(answers.map(({ result }) => commandName === "quote" && result.quote
+      ? cliPerpetualContract(result.quote)
+      : null));
     // Each row names its listing by key (SAN:EPA) and company, so the table needs no line above it.
     const data = answers.map(({ result, listing, failure }, index) => ({
       target: result.target,
@@ -545,11 +577,15 @@ async function runQuote(rawArgs: string[], ctx: Parameters<CliCommandDef["execut
       ...getQuoteSessionFields(result.quote),
       quote: result.quote,
       ...contracts[index] ? { futuresContract: contracts[index] } : {},
+      ...perpetualContracts[index] ? { perpetualContract: perpetualContracts[index] } : {},
       error: failure?.oneLine ?? errorMessage(result.error),
       ...yieldIndexFields(result),
+      ...tickerChanges[index] ? { tickerChange: tickerChanges[index] } : {},
     }));
-    const now = Date.now();
     const notes = [
+      // FB now lists another security; the company that was FB trades as META. A symbol a
+      // company renamed into (META) is what was typed: its change is in the row, not here.
+      ...tickerChanges.flatMap((change) => tickerChangeLine(change) ?? []),
       // Which listing a bare symbol was read as, and the index a bare root is not, are in no row.
       ...answers.flatMap((answer) => answer.notes),
       // A row that stopped trading long ago reads as a quote that is merely stale.
@@ -581,6 +617,10 @@ async function runQuote(rawArgs: string[], ctx: Parameters<CliCommandDef["execut
  */
 function quoteFuturesContractText(data: QuoteCliRecord[]): string {
   return data.flatMap((row) => {
+    if (row.perpetualContract) {
+      const stats = perpetualContractStats(row.perpetualContract);
+      return [data.length > 1 ? `${renderSection(`${row.target.symbol} Contract`)}\n${renderStats(stats)}` : `${renderSection("Contract")}\n${renderStats(stats)}`];
+    }
     const terms = row.futuresContract;
     if (!terms || !row.quote) return [];
     const settle: [string, string] = ["Settle", futuresSettleText(terms, row.quote)];
@@ -636,7 +676,9 @@ async function answerQuote(
     // "CAR = Avis Budget Group, NASDAQ (also XETRA, ASX)" names the venue too, so it replaces "SXR8 -> XETRA".
     const choice = venues ? await listingChoiceNotes(listing, market, result.quote, venues) : listingReadNotes(listing);
     const venue = choice.length > 0 ? null : bareListingNote(listing, result.quote);
-    return { result, listing, notes: [...choice, venue ?? [], also(result.quote)].flat() };
+    // A row saved as 247540:KRX is quoted from KOSDAQ, the board it trades on.
+    const board = tradingBoardNote(listing, result.quote);
+    return { result, listing, notes: [...choice, venue ?? [], board ?? [], also(result.quote)].flat() };
   }
   const notTraded = await notTradedMessage(listing, market);
   if (notTraded) return { result, listing, failure: { message: notTraded, oneLine: notTraded }, notes: [] };
@@ -675,6 +717,20 @@ const HISTORY_USAGE = "history <symbol> [--range <range>]";
 const HISTORY_ALL_RANGE = `ALL gives the full history the source has, up to ${historyAllRangeYears()} years`;
 /** Options people reach for to ask for dates, which history answers with a range. */
 const DATE_WINDOW_OPTIONS = new Set(["--from", "--to", "--start", "--end", "--since", "--until", "--date", "--start-date", "--end-date"]);
+/** Options people reach for to pick a bar size, which history derives from the range. */
+const BAR_SIZE_OPTIONS = new Set(["--interval", "--resolution", "--bar", "--bars", "--bar-size", "--granularity", "--timeframe", "--frequency", "--freq", "--tick", "--ticks"]);
+
+/** The symbol `history` was given: the first word that is not an option or the value after one. */
+function historySymbolArg(args: readonly string[]): string | undefined {
+  return args.find((arg, index) => !arg.startsWith("-")
+    && !(index > 0 && args[index - 1]!.startsWith("--") && !args[index - 1]!.includes("=")));
+}
+
+function historyOptionHint(flag: string, args: readonly string[]): string | null {
+  if (DATE_WINDOW_OPTIONS.has(flag)) return `history takes a --range instead of dates: ${TIME_RANGES.join(", ")}. ${HISTORY_ALL_RANGE}.`;
+  if (BAR_SIZE_OPTIONS.has(flag)) return `history serves each --range in one bar size. ${subMinuteDataMessage(historySymbolArg(args))}`;
+  return null;
+}
 
 async function runHistory(rawArgs: string[], ctx: Parameters<CliCommandDef["execute"]>[1]) {
   const args = [...rawArgs];
@@ -689,18 +745,25 @@ async function runHistory(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     const load = () => market.dataProvider.getPriceHistoryWithMetadata
       ? market.dataProvider.getPriceHistoryWithMetadata(symbol, exchange, range, context)
       : market.dataProvider.getPriceHistory(symbol, exchange, range, context).then((points) => ({ points, resolution: null }));
+    const quoted = loadListingQuote(market.dataProvider, listing);
+    const fate = listingFateLoader(listing, market, quoted);
     const [{ points, resolution }, quote] = await Promise.all([
       loadForListing(listing, market, ctx, load, (loaded) => loaded.points.length === 0, {
-        command: range === "1Y" ? "history" : `history --range ${range}`, noun: "history",
+        command: range === "1Y" ? "history" : `history --range ${range}`, noun: "history", fate,
       })
         .catch((error) => failHistory(error, listing.key, ctx)),
-      loadListingQuote(market.dataProvider, listing),
+      quoted,
     ]);
     const identity = listingIdentity(listing, quote);
     // Without a quote currency, the listing metadata research reads (as `ticker` does) may still state it.
     const listed = quote?.currency ? quote : await market.dataProvider.getQuoteMetadata?.(symbol, exchange).catch(() => null);
     const unit = historyUnit(listing.key, listed ?? quote);
-    const data = historyRows(points, resolution, unit.currency);
+    const traded = {
+      listing: listing.key, exchange: quote?.listingExchangeName || exchange || undefined, instrumentType: quote?.instrumentType,
+    };
+    // A coin's volume is traded value in its quote currency: said in every row and on the status line.
+    const volume = historyVolume(unit, traded);
+    const data = historyRows(points, resolution, unit.currency, unit.unit, volume);
     const interval = data[0]?.interval ?? null;
     const decimals = historyPriceDecimals(data, listing.saved?.metadata.assetCategory);
     const price = (value: unknown) => typeof value === "number" ? value.toFixed(decimals) : "";
@@ -713,13 +776,14 @@ async function runHistory(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
       oldest: null,
       // Bars stop arriving on the listing's own trading days, not New York's.
       cadenceExchange: quote?.listingExchangeName || exchange || undefined,
+      ...(volume ? { note: historyVolumeText(volume, interval) } : {}),
     });
-    const gaps = historyGapNote(data, {
-      listing: listing.key, exchange: quote?.listingExchangeName || exchange || undefined, instrumentType: quote?.instrumentType,
-    });
+    const gaps = historyGapNote(data, traded);
     const notes = [
+      // FB's bars are the fund listed there now; META's from 2021 are from when it was FB.
+      ...listingFateNotes(await fate(), { served: data.length > 0, firstDate: data[0]?.date }),
       ...await listingChoiceNotes(listing, market, quote, venues),
-      ...historyNotes(range, interval, data[0]?.date), gaps ?? [], historyFlagNote(data) ?? [],
+      ...historyNotes(range, interval, data[0]?.date), gaps ?? [], historyFlagNote(data) ?? [], historyBarStatusNote(data) ?? [],
     ].flat();
     const priceColumns: CliResultColumn[] = [
       intraday
@@ -735,6 +799,16 @@ async function runHistory(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     const flagColumn: CliResultColumn = {
       key: "flag", header: "Flag", format: (value) => typeof value === "string" ? cliStyles.warning(value) : "",
     };
+    // Text also marks a bar still forming or rebuilt from hourly bars there; exports keep them as their own fields.
+    const flagTextColumn: CliResultColumn = {
+      ...flagColumn,
+      format: (value, row) => [
+        typeof value === "string" ? cliStyles.warning(value) : "",
+        row.partial ? cliStyles.muted("partial") : "",
+        row.filled ? cliStyles.muted("filled") : "",
+      ].filter(Boolean).join(" "),
+    };
+    const marked = data.some((row) => row.partial || row.filled);
     ctx.printResult({
       data,
       metadata: {
@@ -749,19 +823,23 @@ async function runHistory(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
         lastDate: data.at(-1)?.date ?? null,
         bars: data.length,
         asOf: freshness?.asOf ?? null,
+        ...(volume ? { volumeUnit: volume.unit, volumePeriod: interval === "1d" ? "UTC day" : interval } : {}),
       },
       ...(notes.length > 0 ? { warnings: notes } : {}),
       freshness,
     }, {
       heading: `${listingHeading(identity)}\n${cliStyles.muted(historyFacts(unit, data).join("  ·  "))}`,
       dateKey: "date",
-      textColumns: [...priceColumns, flagColumn],
-      // Every exported row says its currency and bar size, so it survives head and concatenation.
+      textColumns: [...priceColumns, flagTextColumn],
+      // Every exported row says its currency, what a price is in and its bar size, so it survives head and concatenation.
       columns: [
         ...priceColumns,
         { key: "currency", header: "Currency" },
+        { key: "unit", header: "Unit" },
         { key: "interval", header: "Interval" },
         flagColumn,
+        ...marked ? [{ key: "partial", header: "Partial" }, { key: "filled", header: "Filled" }] : [],
+        ...volume ? [{ key: "volumeUnit", header: "Volume unit" }, { key: "volumeNote", header: "Volume note" }] : [],
       ],
     });
   });
@@ -1295,6 +1373,9 @@ async function runAnalyst(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
 async function runEvents(rawArgs: string[], ctx: Parameters<CliCommandDef["execute"]>[1]) {
   const args = [...rawArgs];
   const exchangeOption = takeOption(args, "--exchange");
+  // A central bank's name means the bank, not a listing that shares it; a venue still reaches the listing.
+  const bank = exchangeOption ? null : centralBankEventsMessage(args.join(" "));
+  if (bank) ctx.fail(bank);
   const raw = requireOneArg(args, "events <symbol>", "symbol", ctx);
   await withMarketData(ctx, async (market) => {
     const listing = await requireCliListing(raw, exchangeOption, market, ctx);
@@ -1364,6 +1445,7 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     const refresh = ctx.cliOptions.refresh;
     const venues = loadBareVenues(listing, market);
     const quotePromise = loadListingQuote(market.dataProvider, listing);
+    const fate = listingFateLoader(listing, market, quotePromise);
     const inputsPromise = loadOptionModelInputs(market.dataProvider, listing, quotePromise, refresh);
     const { result, chain: loaded } = await loadForListing(listing, market, ctx, async () => {
       const cached = await market.dataProvider.getCachedQuery?.("getOptionsChain", [symbol, exchange, expirationDate, undefined])
@@ -1374,7 +1456,7 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
           cacheMode: refresh ? "refresh" : "default",
         }),
       };
-    }, undefined, { command: "options", noun: "options chain" }).catch((error: unknown) => {
+    }, undefined, { command: "options", noun: "options chain", fate }).catch((error: unknown) => {
       if (!isOptionsUnavailableError(error)) throw error;
       // A future or commodity with no chain of its own: name the listed fund whose options stand in.
       const alternative = listedOptionsAlternative(listing.key);
@@ -1403,7 +1485,10 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     const modelWarning = inputs.spot == null && (chain.calls.length > 0 || chain.puts.length > 0)
       ? `IV and delta need a current ${listing.key} quote; those columns are blank`
       : null;
+    const listed = chain.expirationDates.length > 0 || chain.calls.length > 0 || chain.puts.length > 0;
     const warnings = [
+      // FB's chain is the fund listed there now; a listing that stopped trading has none.
+      ...listingFateNotes(await fate(), { served: listed }),
       ...await listingChoiceNotes(listing, market, quote, venues),
       ...[refreshWarning ?? sessionWarning, modelWarning].filter((warning): warning is string => warning != null),
     ];
@@ -1575,7 +1660,7 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
       group: CLI_COMMAND_GROUPS.research,
       usage: ["quote <symbol...>"],
       options: [EXCHANGE_OPTION],
-      examples: ["quote AAPL MSFT NVDA", "quote SAN:EPA BHP:ASX", "quote BTC-USD EURUSD=X", "quote AAPL --json"],
+      examples: ["quote AAPL MSFT NVDA", "quote SAN:EPA BHP:ASX", "quote BTC-USD EURUSD=X", "quote binance:BZUSDT", "quote AAPL --json"],
     },
     execute: (args, ctx) => runQuote(args, ctx, "quote"),
   },
@@ -1609,9 +1694,7 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
       }],
       examples: ["history AAPL", "history BHP:ASX --range 5Y", "history ZAR=X --range ALL", "history ZAR=X --tail 5", "history AAPL --range 5Y --csv > aapl.csv"],
     },
-    unknownOptionHint: (flag) => DATE_WINDOW_OPTIONS.has(flag)
-      ? `history takes a --range instead of dates: ${TIME_RANGES.join(", ")}. ${HISTORY_ALL_RANGE}.`
-      : null,
+    unknownOptionHint: historyOptionHint,
     execute: runHistory,
   },
   {

package/src/cli/commands/overview.ts

@@ -38,12 +38,17 @@ import { quotesFreshness, rowsFreshness } from "../freshness";
 import { periodicityOf } from "../pane-functions/freshness";
 import { formatBasisPoints, toBasisPoints } from "../../utils/basis-points";
 import {
+  basisPointsCell,
   DEFAULT_FRED_START,
   fredEmptyMessage,
+  fredExportValue,
   fredHistoryNotes,
+  fredProvenance,
+  fredPublicationTime,
+  fredValueHeader,
+  fredValueKey,
   isSpreadSeries,
   laggingSeriesNote,
-  spreadBasisPointsCell,
 } from "./fred-series";
 
 // Batch quotes often omit names for indices and ETFs; these baskets are fixed, so name them here.
@@ -351,8 +356,9 @@ async function runFredList(filter: string, ctx: Parameters<CliCommandDef["execut
   ctx.printResult({ data: rows, metadata: { filter: filter || null, total: catalog.series.length } }, {
     columns: [
       { key: "id", header: "ID", shrink: false },
-      { key: "title", header: "Title" },
-      { key: "group", header: "Group" },
+      // A title too narrow to tell series apart goes on a line under its ID.
+      { key: "title", header: "Title", minWidth: 30, stackPriority: 1 },
+      { key: "group", header: "Group", shrink: false },
     ],
     empty: filter ? `No supported FRED series match "${filter}". Run gloomberb fred --list to see them all.` : "No FRED series are listed.",
   });
@@ -375,7 +381,15 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
     if (isUnsupportedSeries(error)) ctx.fail(`Unsupported FRED series ${seriesId}. List supported series with: gloomberb fred --list`);
     throw error;
   });
-  const rows = data.observations;
+  // Each observation exports under its unit (`value_bp`, `value_pct`), a spread in basis points.
+  const valueKey = fredValueKey(seriesId, data.info?.units);
+  // A value FRED does not list yet carries its publisher and when it published, in every export.
+  const exportRow = (observation: { date: string; value: number | null; publisher?: string; publishedAt?: string }) => ({
+    date: observation.date,
+    [valueKey]: fredExportValue(seriesId, observation.value),
+    ...(observation.publisher?.trim() ? { publisher: observation.publisher.trim(), ...(observation.publishedAt ? { publishedAt: observation.publishedAt } : {}) } : {}),
+  });
+  const rows = data.observations.map(exportRow);
   // The default start hides older history and a start before the series begins is moved up silently: say where it really starts.
   const notes = [
     ...fredHistoryNotes({ startDate, startGiven: start != null, seriesStart: data.info?.observationStart }),
@@ -385,17 +399,25 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   const latest = rows.length > 0 ? null : await apiClient.getCloudFredSeries(seriesId, { limit: 1, sortOrder: "desc" })
     .then((payload) => payload.observations[0] ?? null).catch(() => null);
   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));
+  // 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);
   ctx.printResult({
     data: rows,
     metadata: {
       info: data.info, seriesId, startDate, sortOrder,
       ...(notes.length ? { notes } : {}),
-      ...(latest ? { latestObservation: latest } : {}),
+      ...(latest ? { latestObservation: exportRow(latest) } : {}),
     },
     freshness: rowsFreshness(rows, {
-      source: "FRED", status: "not-a-feed", basis: "published statistics", observedKey: "date", oldest: null,
+      source: ahead?.source ?? "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 } : {}),
+      ...(publishedAt ? { publishedAt } : {}),
     }),
   }, {
     dateKey: "date",
@@ -404,9 +426,8 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
     textColumns: [
       { key: "date", header: "Date" },
       isSpreadSeries(seriesId)
-        // A spread is read in basis points; JSON and CSV keep FRED's percentage points.
-        ? { key: "value", header: "Value (bp)", align: "right", format: spreadBasisPointsCell }
-        : { key: "value", header: data.info?.units ? `Value (${data.info.units})` : "Value", align: "right" },
+        ? { key: valueKey, header: "Value (bp)", align: "right", format: basisPointsCell }
+        : { key: valueKey, header: fredValueHeader(data.info), align: "right" },
     ],
   });
 }
@@ -424,22 +445,34 @@ async function runYieldCurve(rawArgs: string[], ctx: Parameters<CliCommandDef["e
     return {
       seriesId,
       date: latest?.date ?? "",
-      value: latest?.value ?? null,
+      // Yields in percent, named so in every export, as `fred` names a percent series.
+      value_pct: latest?.value ?? null,
       title: data.info?.title ?? "",
       // The move since the previous observation FRED has, not calendar yesterday: a Monday reads against Friday.
       previousDate: previous?.date ?? null,
-      previousValue: previous?.value ?? null,
+      previousValue_pct: previous?.value ?? null,
       changeBasisPoints: latest?.value != null && previous?.value != null ? toBasisPoints(latest.value - previous.value, 1) : null,
+      latest,
+      publishedAt: latest?.publisher ? null : fredPublicationTime(data.info, latest?.date),
     };
   }));
+  // Tenors whose latest yield FRED does not list yet name the Treasury and when it published them.
+  const ahead = fredProvenance(results.flatMap((row) => row.latest ? [row.latest] : []));
+  // The curve shown was published with its last tenor: the newest of their FRED updates, when each has one.
+  const published = results.map((row) => row.publishedAt);
+  const publishedAt = ahead ? ahead.publishedAt : published.every((time) => time != null) ? published.sort().at(-1) : null;
   ctx.printResult({
-    data: results,
+    data: results.map(({ publishedAt: _publishedAt, latest: _latest, ...row }) => row),
     metadata: { startDate },
-    freshness: rowsFreshness(results, { source: "FRED", status: "not-a-feed", basis: "daily Treasury yields", observedKey: "date" }),
+    freshness: rowsFreshness(results, {
+      source: ahead?.source ?? "FRED", status: "not-a-feed", basis: "daily Treasury yields", observedKey: "date",
+      ...(ahead?.publisher ? { publisher: ahead.publisher } : {}),
+      ...(publishedAt ? { publishedAt } : {}),
+    }),
   }, {
     textColumns: [
       { key: "tenor", header: "Tenor", value: (row) => YIELD_TENORS[String(row.seriesId)] ?? row.seriesId },
-      { key: "value", header: "Yield %", align: "right", format: (value) => typeof value === "number" ? value.toFixed(2) : "-" },
+      { key: "value_pct", header: "Yield %", align: "right", format: (value) => typeof value === "number" ? value.toFixed(2) : "-" },
       {
         key: "changeBasisPoints",
         header: "1D bp",