gloomberb 0.17.6 → 0.18.0

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

@@ -10,14 +10,47 @@ const MIN_FALLBACK_LENGTH = 3;
 
 /**
  * The text `news` was asked to search for rather than a symbol: several words,
- * quoted or not (`news "european gas"`, `news european gas`). A single word
- * is a symbol until nothing answers to it (`newsFallbackText`).
+ * quoted or not (`news "european gas"`, `news european gas`), or one word that
+ * still carries its quotes (`news '"gold"'`: a shell drops one pair, so the
+ * word keeps the inner pair). A bare word is a symbol until nothing answers
+ * to it (`newsFallbackText`).
  */
 export function newsSearchText(args: readonly string[]): string | null {
   const text = args.join(" ").trim().replace(/\s+/g, " ");
+  const quoted = args.length === 1 ? /^(["'“‘])(.+)(["'”’])$/u.exec(text) : null;
+  if (quoted) return quoted[2]!.trim();
   return args.length > 1 || /\s/.test(text) ? text : null;
 }
 
+/** How to type a word as text to search from a shell: `'"gold"'` keeps the quotes a shell would drop. */
+export const quotedSearchCommand = (word: string) => `gloomberb news '"${word}"'`;
+
+/**
+ * Whether a word typed for `news` may mean more than the listing it found:
+ * a plain word (letters only, three or more, typed with a lower-case letter,
+ * as a word is and a ticker rarely is) that is one of the words of the
+ * company's name ("gold" for Gold.com Inc., "gap" for The Gap). The stories
+ * then decide (`wordMeansMore`).
+ */
+export function commonWordCandidate(typed: string, companyName: string | null | undefined): boolean {
+  const word = typed.trim();
+  if (!/^[A-Za-z]{3,}$/.test(word) || !/[a-z]/.test(word) || !companyName) return false;
+  return companyName.toLowerCase().split(/[^a-z]+/).includes(word.toLowerCase());
+}
+
+/**
+ * Whether the stories that mention a word are mostly about something else
+ * than the ticker it resolved to: three or more stories, fewer than half of
+ * them filed under the ticker. "gold" is mostly the metal's market; "meta"
+ * is mostly Meta Platforms.
+ */
+export function wordMeansMore(stories: readonly NewsArticle[], symbol: string): boolean {
+  if (stories.length < 3) return false;
+  const ticker = symbol.toUpperCase();
+  const filed = stories.filter((story) => (story.tickers ?? []).some((entry) => entry.toUpperCase() === ticker)).length;
+  return filed * 2 < stories.length;
+}
+
 /** Why the service would refuse the text, or null when it can search it. */
 export function newsSearchTextProblem(text: string): string | null {
   if (text.length < MIN_TEXT_LENGTH || !/[\p{L}\p{N}]/u.test(text)) return "Search text needs at least two characters, with a letter or a number.";

package/src/cli/commands/options-chain.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../../utils/log-failure";
 import type { OptionContract, OptionsChain, Quote, TickerFinancials } from "../../types/financials";
 import type { DataProvider } from "../../types/data-provider";
 import type { CliListing } from "../listing-arg";
@@ -12,10 +13,10 @@ import {
   chainOpenInterestAsOf, loadListedOpenInterest, openInterestAsOfLabel, type OpenInterestAsOf, statedOpenInterestAsOf,
 } from "../../plugins/builtin/options/open-interest-as-of";
 import { DEFAULT_OPTION_CALC_DRAFT } from "../../plugins/builtin/options-calculator/model";
-import { expiryIsoDate, parseOptionExpiration } from "../../utils/option-expiry";
+import { expiryIsoDate, OPTION_EXPIRATION_PLACEHOLDER, parseOptionExpiration } from "../../utils/option-expiry";
 import { loadModelDividendYield } from "../../market-data/model-dividend-yield";
 
-export const OPTIONS_USAGE = "options <symbol> [--expiration <YYYY-MM-DD|unix>]";
+export const OPTIONS_USAGE = `options <symbol> [--expiration <${OPTION_EXPIRATION_PLACEHOLDER}>]`;
 
 export { parseOptionExpiration };
 
@@ -114,14 +115,15 @@ export function loadUnderlyingFinancials(
 ): Promise<TickerFinancials | null> {
   return Promise.resolve().then(() => dataProvider.getTickerFinancials(
     listing.request.symbol, listing.request.exchange, { cacheMode: refresh ? "refresh" : "default" },
-  )).catch(() => null);
+  )).catch(logFailure("cli.commands-options-chain", "Read option underlying financials failed", null));
 }
 
 /**
  * Spot and dividend yield for IV and delta, read from the underlying the way the
  * options pane does; missing ones stay missing. The dividend yield is any the
  * fundamentals state, stale or not, else, as OSA reads it
- * (`loadModelDividendYield`), 0 for a history with no dividend paid.
+ * (`loadModelDividendYield`), 0 for a history with no dividend paid, and 0
+ * for a dividend that stopped.
  * `financials` shares one read of them with a caller that needs more of them.
  */
 export async function loadOptionModelInputs(
@@ -135,7 +137,7 @@ export async function loadOptionModelInputs(
   const current = [await quote, financials?.quote]
     .find((candidate) => candidate && candidate.stale !== true && isFiniteNumber(candidate.price) && candidate.price > 0);
   const { symbol, exchange } = listing.request;
-  const dividend = await loadModelDividendYield(financials?.fundamentals?.dividendYield, symbol,
+  const dividend = await loadModelDividendYield(financials?.fundamentals, symbol,
     dataProvider.getCorporateActions ? () => dataProvider.getCorporateActions!(symbol, exchange) : null);
   return {
     ...(current ? { spot: current.price, quote: current } : {}),

package/src/cli/commands/options-leaps.ts

@@ -9,6 +9,7 @@ import { cliStyles, renderTable, type CliTableColumn } from "../../utils/cli-out
 import { errorMessage } from "../../utils/errors";
 import { numberErrorMessage, rangeErrorMessage } from "../../utils/decimal-comma";
 import { expiryIsoDate, OPTION_EXPIRATION_FORMAT, parseOptionExpiration } from "../../utils/option-expiry";
+import { dateOptionError, readCalendarDate } from "../../utils/calendar-date";
 import { isFundType } from "../../utils/sec";
 import { zonedDateKey } from "../../utils/zoned-date-time";
 import { daysToExpiryFrom, optionMid, type OptionSide } from "../../plugins/builtin/shared/volatility";
@@ -123,9 +124,7 @@ function parseWholeNumber(flag: string, value: string, unit: string, example: nu
 const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
 
 function parseExpiryDate(flag: string, value: string, example: string): string | { error: string } {
-  const text = value.trim();
-  if (ISO_DATE.test(text) && parseOptionExpiration(text) != null) return text;
-  return { error: `Invalid ${flag} "${value}". Use a date as YYYY-MM-DD, such as ${flag} ${example}.` };
+  return readCalendarDate(value) ?? { error: `Invalid ${flag} "${value}". ${dateOptionError(value, flag, { subject: "an expiry date", example })}` };
 }
 
 /** Whole calendar days to an expiry date's close, as the Days column counts them. */
@@ -496,6 +495,7 @@ function ivKey(listing: CliListing): string | null {
   try {
     return ivSymbol(listing.key);
   } catch {
+    // Intentional ignore: IV history supports US symbols only; unsupported listings have no IV key.
     return null;
   }
 }

package/src/cli/commands/overview.ts

@@ -1,8 +1,10 @@
+import { logFailure } from "../../utils/log-failure";
 import { apiClient } from "../../api-client";
 import { ApiRequestError } from "../../api-client/errors";
 import type { CliCommandDef } from "../../types/plugin";
 import { withCliServices } from "../context";
 import { formatCompact } from "../../utils/format";
+import { DATE_OPTION_EXAMPLES, DATE_OPTION_FORMATS, dateOptionError, readCalendarDate } from "../../utils/calendar-date";
 import {
   fetchScreenerResult,
   fetchTrending,
@@ -19,6 +21,7 @@ import {
   type MoverRankBasis,
 } from "../../plugins/builtin/market-movers/model";
 import { MOVER_CANDIDATES } from "../../plugins/builtin/market-movers/client";
+import { fetchEconCalendarFrom } from "../../plugins/builtin/econ/calendar-source";
 import { EXTENDED_SESSION_LABELS, getQuoteSessionFields, type ExtendedSession } from "../../market-data/market/status";
 import {
   COUNTRY_CYCLE,
@@ -49,6 +52,12 @@ import {
   basisPointsCell,
   DEFAULT_FRED_START,
   filterFredSeries,
+  fredChangeCell,
+  fredChangeFetchStart,
+  fredChangeHeader,
+  fredChangeMismatch,
+  fredChanges,
+  fredDecimals,
   fredEmptyAdvice,
   fredEmptyMessage,
   fredExportValue,
@@ -58,9 +67,11 @@ import {
   fredProvenance,
   fredPublicationTime,
   fredUnit,
+  fredValueCell,
   fredValueHeader,
   isSpreadSeries,
   laggingSeriesNote,
+  parseFredChange,
 } from "./fred-series";
 
 // Batch quotes often omit names for indices and ETFs; these baskets are fixed, so name them here.
@@ -108,8 +119,8 @@ const MOVER_COLUMNS = [
   { ...MARKET_CAP_CELL, format: formatCompactCell },
 ];
 const START_OPTION = {
-  flags: "--start <yyyy-mm-dd>",
-  description: `First observation date; yyyy or yyyy-mm start at the first of that year or month (default ${DEFAULT_FRED_START})`,
+  flags: "--start <date>",
+  description: `First observation date, as ${DATE_OPTION_EXAMPLES}; yyyy or yyyy-mm start at the first of that year or month (default ${DEFAULT_FRED_START})`,
 };
 
 const MOVER_LISTS: Record<string, ScreenerCategory | "trending"> = {
@@ -259,7 +270,7 @@ function utcDateTimePart(value: unknown, part: "date" | "time"): string {
   return part === "date" ? iso.slice(0, 10) : `${iso.slice(11, 16)} UTC${localTimeSuffix(date.getTime())}`;
 }
 
-const ECON_USAGE = "econ [--country <region>] [--impact <level>] [--from <yyyy-mm-dd>]";
+const ECON_USAGE = "econ [--country <region>] [--impact <level>] [--from <date>]";
 const DAY_MS = 86_400_000;
 
 /**
@@ -276,7 +287,7 @@ function econEmptyMessage(from: string | null, listedThrough: string | null, sto
 }
 
 /**
- * A `yyyy-mm-dd` option, checked here; null when it was not given. `expand`
+ * A date option, read as an ISO date; null when it was not given. `expand`
  * reads a shorthand as a full date first, and `form` is how the message names
  * what the option takes.
  */
@@ -284,14 +295,11 @@ function parseDateOption(
   value: string | undefined,
   flag: string,
   ctx: Parameters<CliCommandDef["execute"]>[1],
-  { expand = (text: string) => text, form = "yyyy-mm-dd" }: { expand?: (text: string) => string; form?: string } = {},
+  { expand = (text: string) => text, form = DATE_OPTION_FORMATS }: { expand?: (text: string) => string; form?: string } = {},
 ): string | null {
   if (value == null) return null;
-  const date = expand(value.trim());
-  const time = /^\d{4}-\d{2}-\d{2}$/.test(date) ? Date.parse(`${date}T00:00:00Z`) : Number.NaN;
-  if (!Number.isFinite(time) || new Date(time).toISOString().slice(0, 10) !== date) {
-    ctx.fail(`${flag} takes a date as ${form}, got "${value}".`);
-  }
+  const date = readCalendarDate(expand(value.trim()));
+  if (!date) ctx.fail(dateOptionError(value, flag, { formats: form }));
   return date;
 }
 
@@ -310,8 +318,13 @@ async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>
   const fromOption = parseDateOption(takeOption(rawArgs, "--from"), "--from", ctx);
   rejectArgs(rawArgs, ECON_USAGE, ctx, "Filter with --country and --impact.");
   await withCliServices(ctx, async () => {
-    const { data: events, fetchedAt, stale } = await loadCalendar(ctx.cliOptions.refresh);
     const todayStart = Math.floor(Date.now() / DAY_MS) * DAY_MS;
+    // An earlier day reads the stored calendar, which keeps past events after the week's listing drops them.
+    // A server without it, a server error or no network lists the current calendar (cached when offline) instead.
+    const stored = fromOption != null && fromOption < isoDate(new Date(todayStart)) ? await fetchEconCalendarFrom(fromOption) : null;
+    const past = stored?.events ? stored : null;
+    const unread = stored && !stored.events && stored.failure ? `The stored calendar could not be read (${stored.failure}); listing the current calendar` : null;
+    const { data: events, fetchedAt, stale } = past ? { data: past.events, fetchedAt: Date.now(), stale: false } : await loadCalendar(ctx.cliOptions.refresh);
     // The calendar lists from today (UTC). --from moves the first day; --tail
     // alone keeps the newest events of the whole calendar, the past week's too.
     const from = fromOption ?? (ctx.cliOptions.tail != null ? null : new Date(todayStart).toISOString().slice(0, 10));
@@ -320,6 +333,14 @@ async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>
     const listedThrough = lastEvent ? lastEvent.toISOString().slice(0, 10) : null;
     // A calendar that stops short of a week ahead says so under the table.
     const listedAfter = shortCalendarEnd(events, Math.max(todayStart, fromTime)) ? `No events listed after ${listedThrough}` : null;
+    // A day before anything the calendar holds says where its listing starts.
+    const firstEvent = events.reduce<Date | null>((first, event) => (!first || event.date < first ? event.date : first), null);
+    const listedFrom = firstEvent ? firstEvent.toISOString().slice(0, 10) : null;
+    const startsLater = fromOption != null && (past ? past.storedFrom == null || past.storedFrom > fromOption : listedFrom != null && listedFrom > fromOption);
+    const listedBefore = !startsLater ? null
+      : past?.storedFrom ? `The stored calendar starts ${past.storedFrom}; nothing earlier is listed`
+      : `No events are stored before ${listedFrom ?? isoDate(new Date(todayStart))}`;
+    const footnote = [listedBefore, listedAfter].filter((note): note is string => !!note).join("\n");
     const rows = events
       .filter((event) => event.date.getTime() >= fromTime && matchesCountry(event, country) && matchesImpact(event, impact))
       .sort((left, right) => left.date.getTime() - right.date.getTime())
@@ -335,14 +356,15 @@ async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>
       }));
     ctx.printResult({
       data: rows,
-      metadata: { country, impact, from, listedThrough },
+      ...(unread ? { warnings: [unread] } : {}),
+      metadata: { country, impact, from, listedThrough, storedFrom: past?.storedFrom ?? null },
       // The calendar as read, not its rows: those are scheduled, mostly ahead.
       freshness: rowsFreshness([], { status: "not-a-feed", basis: "calendar", asOf: fetchedAt }, { stale }),
     }, {
       dateKey: "date",
       defaultLimit: 50,
       empty: econEmptyMessage(from, listedThrough, listedAfter != null),
-      ...(listedAfter ? { footnote: listedAfter } : {}),
+      ...(footnote ? { footnote } : {}),
       columns: [
         // Text shows both halves of the event timestamp in UTC, never the host's zone; exports keep the source values.
         { key: "date", header: "Date", format: (value) => utcDateTimePart(value, "date") },
@@ -358,7 +380,7 @@ async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>
   });
 }
 
-const FRED_USAGE = "fred <series-id> [--start <yyyy-mm-dd>] [--sort desc|asc]";
+const FRED_USAGE = "fred <series-id> [--start <date>] [--sort desc|asc] [--change 1D|1W]";
 const FRED_LIST_USAGE = "fred --list [filter]";
 
 /** A year or a month stands for the first day of it. */
@@ -369,7 +391,7 @@ function startOfPeriod(text: string): string {
 
 /** `--start`, checked here: Gloom Cloud cannot read anything but yyyy-mm-dd, so yyyy and yyyy-mm are spelled out. */
 function parseStartDate(value: string | undefined, ctx: Parameters<CliCommandDef["execute"]>[1]): string {
-  return parseDateOption(value, "--start", ctx, { expand: startOfPeriod, form: "yyyy-mm-dd, yyyy-mm or yyyy" }) ?? DEFAULT_FRED_START;
+  return parseDateOption(value, "--start", ctx, { expand: startOfPeriod, form: `${DATE_OPTION_FORMATS.replace(" or ", ", ")}, YYYY-MM or YYYY` }) ?? DEFAULT_FRED_START;
 }
 
 /** Gloom Cloud serves a curated set of FRED series and answers 400 for any other id. */
@@ -407,29 +429,47 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   const list = takeFlag(args, "--list");
   const start = takeOption(args, "--start");
   const sort = takeOption(args, "--sort");
-  if (list) {
-    if (start != null || sort != null) ctx.fail("--list takes a filter, not --start or --sort.", `Usage: gloomberb ${FRED_LIST_USAGE}`);
+  const changeGiven = args.some((arg) => arg === "--change" || arg.startsWith("--change="));
+  const change = changeGiven ? takeOption(args, "--change") : undefined;
+  // Bare `fred` lists the series it can fetch, grouped by topic, as `fred --list` does.
+  if (list || rawArgs.length === 0) {
+    if (start != null || sort != null || changeGiven) {
+      ctx.fail("--list takes a filter, not --start, --sort or --change.", `Usage: gloomberb ${FRED_LIST_USAGE}`);
+    }
     return runFredList(args.join(" ").trim(), ctx);
   }
   const startDate = parseStartDate(start, ctx);
   const sortOrder = (sort ?? "desc").trim().toLowerCase();
   if (sortOrder !== "asc" && sortOrder !== "desc") ctx.fail(`Unknown sort order "${sort}".`, "Use desc (newest first) or asc.");
+  const horizon = changeGiven ? parseFredChange(change) : null;
+  if (changeGiven && !horizon) {
+    ctx.fail(change ? `Unknown change "${change}".` : "--change needs 1D or 1W.", "Use 1D (from the previous observation) or 1W (from a week before).");
+  }
   const seriesId = requireOneArg(args, FRED_USAGE, "series", ctx).toUpperCase();
-  const data = await apiClient.getCloudFredSeries(seriesId, { startDate, sortOrder }).catch((error: unknown) => {
+  // A change needs the observation it is measured from: the fetch reaches back before the first row shown.
+  const fetchStart = horizon ? fredChangeFetchStart(startDate) : startDate;
+  const data = await apiClient.getCloudFredSeries(seriesId, { startDate: fetchStart, sortOrder }).catch((error: unknown) => {
     if (isUnsupportedSeries(error)) ctx.fail(`Unsupported FRED series ${seriesId}. List supported series with: gloomberb fred --list`);
     throw error;
   });
   // Every observation exports as `value`, a spread in basis points; its unit goes in the `currency_or_unit` column.
   const unit = fredUnit(seriesId, data.info);
   const interval = fredInterval(data.info?.frequency);
+  const mismatch = horizon ? fredChangeMismatch(seriesId, interval, horizon) : null;
+  if (mismatch) ctx.fail(mismatch);
+  // Each row's change in the unit its value exports in, and the date it is from; a holiday's stays blank.
+  const changes = horizon ? fredChanges(seriesId, data.observations, horizon) : null;
   // 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,
     value: fredExportValue(seriesId, observation.value),
+    ...(changes ? { change: changes.get(observation.date)?.change ?? null, changeFrom: changes.get(observation.date)?.changeFrom ?? null } : {}),
     ...(observation.publisher?.trim() ? { publisher: observation.publisher.trim(), ...(observation.publishedAt ? { publishedAt: observation.publishedAt } : {}) } : {}),
   });
   // A --start before the series begins comes back padded with blank days: the rows start at its first observation.
-  const rows = fredObservationsFromStart(data.observations, data.info?.observationStart).map(exportRow);
+  const rows = fredObservationsFromStart(data.observations, data.info?.observationStart)
+    .filter((observation) => !horizon || observation.date >= startDate)
+    .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 }),
@@ -437,7 +477,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   ].filter((note): note is string => note != null);
   // Nothing on or after the start: name where the series ends, so an empty answer is not a dead end.
   const latest = rows.length > 0 ? null : await apiClient.getCloudFredSeries(seriesId, { limit: 1, sortOrder: "desc" })
-    .then((payload) => payload.observations[0] ?? null).catch(() => null);
+    .then((payload) => payload.observations[0] ?? null).catch(logFailure("cli.commands-overview", "Read latest economic series observation failed", null));
   // CSV and NDJSON are rows alone: an empty one would read as a series with no data, so it fails and says where the series ends.
   if (rows.length === 0 && (ctx.cliOptions.format === "csv" || ctx.cliOptions.format === "ndjson")) {
     ctx.fail(`No ${seriesId} observations on or after ${startDate}.`, fredEmptyAdvice(seriesId, latest));
@@ -453,6 +493,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
     data: rows,
     metadata: {
       info: data.info, seriesId, startDate, sortOrder, unit, interval,
+      ...(horizon ? { change: horizon } : {}),
       ...(notes.length ? { notes } : {}),
       ...(latest ? { latestObservation: exportRow(latest) } : {}),
     },
@@ -472,7 +513,11 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
       { key: "date", header: "Date" },
       isSpreadSeries(seriesId)
         ? { key: "value", header: "Value (bp)", align: "right", format: basisPointsCell }
-        : { key: "value", header: fredValueHeader(data.info), align: "right" },
+        : { key: "value", header: fredValueHeader(data.info), align: "right", format: fredValueCell(fredDecimals(rows.map((row) => row.value))) },
+      ...(horizon ? [{
+        key: "change", header: fredChangeHeader(seriesId, horizon, data.info), align: "right" as const,
+        format: fredChangeCell(isSpreadSeries(seriesId), fredDecimals(rows.map((row) => row.value))),
+      }] : []),
     ],
   });
 }
@@ -482,7 +527,7 @@ const YIELD_TENORS: Record<string, string> = { DGS3MO: "3M", DGS2: "2Y", DGS10:
 async function runYieldCurve(rawArgs: string[], ctx: Parameters<CliCommandDef["execute"]>[1]) {
   const args = [...rawArgs];
   const startDate = parseStartDate(takeOption(args, "--start"), ctx);
-  rejectArgs(args, "yield-curve [--start <yyyy-mm-dd>]", ctx);
+  rejectArgs(args, "yield-curve [--start <date>]", ctx);
   const series = Object.keys(YIELD_TENORS);
   const results = await Promise.all(series.map(async (seriesId) => {
     const data = await apiClient.getCloudFredSeries(seriesId, { startDate, sortOrder: "desc" });
@@ -629,9 +674,9 @@ export const overviewCliCommands: CliCommandDef[] = [
       options: [
         { flags: "--country <region>", description: "US, G7, EU, or all (default all)" },
         { flags: "--impact <level>", description: "high, medium, low, or all (default all)" },
-        { flags: "--from <yyyy-mm-dd>", description: "First day listed (default today, UTC); an earlier day reaches past events" },
+        { 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 --tail 20"],
+      examples: ["econ", "econ --country US --impact high", "econ --from 2026-10-12 --country US", "econ --tail 20"],
     },
     execute: runEcon,
   },
@@ -640,19 +685,23 @@ export const overviewCliCommands: CliCommandDef[] = [
     description: "Fetch a FRED economic series, or list the ones served",
     help: {
       group: CLI_COMMAND_GROUPS.markets,
-      usage: [FRED_USAGE, FRED_LIST_USAGE],
+      usage: [FRED_USAGE, "fred", FRED_LIST_USAGE],
       options: [
         START_OPTION,
         { flags: "--sort <order>", description: "desc for newest first (default) or asc" },
-        { flags: "--list", description: "List the series Gloom Cloud serves (ID, title, group); words after it filter the list" },
+        { flags: "--list", description: "List the series Gloom Cloud serves (ID, title, group), as fred alone does; words after it filter the list" },
+        {
+          flags: "--change <1D|1W>",
+          description: "Add each observation's change in the series' unit (bp for a spread, pp for a percent): 1D from the previous observation, 1W from the last one a week before; holidays stay blank",
+        },
       ],
       sections: [{
         title: "Series",
         lines: [
-          "Gloom Cloud serves a curated set of FRED series and needs no sign-in for them. gloomberb fred --list prints them; any other ID fails with that pointer.",
+          "Gloom Cloud serves a curated set of FRED series and needs no sign-in for them. gloomberb fred (or fred --list) prints them by topic; any other ID fails with that pointer.",
         ],
       }],
-      examples: ["fred CPIAUCSL", "fred DGS10 --tail 5", "fred UNRATE --start 2020-01-01 --csv", "fred --list", "fred --list fx"],
+      examples: ["fred CPIAUCSL", "fred DGS10 --tail 5", "fred DGS10 --change 1D --tail 5", "fred UNRATE --start 2020-01-01 --csv", "fred", "fred --list credit", "fred --list fx"],
     },
     execute: runFred,
   },
@@ -661,7 +710,7 @@ export const overviewCliCommands: CliCommandDef[] = [
     description: "Show the latest 3M, 2Y, 10Y, and 30Y Treasury yields",
     help: {
       group: CLI_COMMAND_GROUPS.markets,
-      usage: ["yield-curve [--start <yyyy-mm-dd>]"],
+      usage: ["yield-curve [--start <date>]"],
       options: [START_OPTION],
     },
     execute: runYieldCurve,

package/src/cli/commands/plugins.ts

@@ -322,6 +322,7 @@ async function readInstalledPlugins(options: { check?: boolean }): Promise<Insta
         version = pkg.version || "";
         description = pkg.description || "";
       } catch {
+        // Intentional ignore: The installed-plugin row reports the unreadable manifest.
         description = "Unreadable package.json";
       }
     }