gloomberb 0.18.3 → 0.18.4

package/src/cli/commands/overview.ts

@@ -2,11 +2,11 @@ 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 { withCliServices, withMarketData } from "../context";
 import { formatCompact } from "../../utils/format";
 import { DATE_OPTION_EXAMPLES, DATE_OPTION_FORMATS, dateOptionError, readCalendarDate } from "../../utils/calendar-date";
 import {
-  fetchScreenerResult,
+  fetchPreferredMarketMovers,
   fetchTrending,
   MARKET_SUMMARY_SYMBOLS,
   type ScreenerCategory,
@@ -22,18 +22,24 @@ 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 { computedFredSeriesNote, seriesNotOnFred } from "../../sources/gloomberb-cloud/fred-series";
 import { EXTENDED_SESSION_LABELS, getQuoteSessionFields, type ExtendedSession } from "../../market-data/market/status";
 import {
   COUNTRY_CYCLE,
+  COUNTRY_FILTER_HINT,
+  countriesWithoutEvents,
   FILTER_CYCLE,
   loadCalendar,
+  eventCountry,
   matchesCountry,
   matchesImpact,
+  noScheduledReleasesMessage,
+  parseCountryFilter,
   shortCalendarEnd,
   type CountryFilter,
   type ImpactFilter,
 } from "../../plugins/builtin/econ/calendar-model";
+import { hasNoReleaseTime, hasNoStatedTime } from "../../plugins/builtin/econ/types";
 import { isoDate, rejectExtraArgs, requireArg, requireOneArg, takeFlag, takeOption } from "./command-utils";
 import { buildCorrelationSeries } from "../../plugins/builtin/correlation/matrix/model";
 import { alignDailyCloses, correlateDailyCloses } from "../../plugins/builtin/correlation/compute";
@@ -45,7 +51,7 @@ import { formatChangePercentCell, formatCompactCell } from "../helpers";
 import { WORLD_INDICES } from "../../plugins/builtin/world-indices/indices";
 import { getSectorCollection, SECTOR_COLLECTIONS } from "../../plugins/builtin/sectors/sector-data";
 import { DAILY_CLOSES } from "../../plugins/builtin/shared/report-freshness";
-import { localTimeSuffix, newestReportTime, oldestReportTime } from "../../utils/utc-time";
+import { canonicalTimeZone, localTimeSuffix, newestReportTime, oldestReportTime, timeZoneCity, zonedClock } from "../../utils/utc-time";
 import { quotesFreshness, rowsFreshness } from "../freshness";
 import { periodicityOf } from "../pane-functions/freshness";
 import { formatBasisPoints, toBasisPoints } from "../../utils/basis-points";
@@ -134,6 +140,8 @@ const MOVER_LISTS: Record<string, ScreenerCategory | "trending"> = {
 const MOVERS_USAGE = "movers [gainers|losers|active|trending] [--session regular|extended]";
 /** The most rows the movers list serves in one request. */
 const MOVER_REQUEST_CAP = 100;
+/** A one-shot list waits this long for its rows' average volumes and sizes, as `fn MOST` does. */
+const MOVER_METADATA_WAIT_MS = 10_000;
 
 function moverRankBasis(value: string | undefined, ctx: Parameters<CliCommandDef["execute"]>[1]): MoverRankBasis {
   if (value == null) return "regular";
@@ -210,12 +218,14 @@ async function runMoverCommand(rawArgs: string[], ctx: Parameters<CliCommandDef[
   // After the close a price list keeps only the rows moving its way on the basis
   // asked for, so it reads more candidates than it shows.
   const count = category === "most_actives" ? limit : Math.min(MOVER_REQUEST_CAP, Math.max(limit, MOVER_CANDIDATES));
-  const screener = await fetchScreenerResult(category, count, undefined, { forceRefresh: ctx.cliOptions.refresh, session: basis });
+  // With the saved session, as MOST reads it: a Pro account gets the real-time lists, anyone else the delayed ones.
+  const movers = await withMarketData(ctx, () =>
+    fetchPreferredMarketMovers(category, count, { forceRefresh: ctx.cliOptions.refresh, session: basis, metadataWaitMs: MOVER_METADATA_WAIT_MS }));
   // Last and Chg% are the regular session, as `ticker` reads it, and a
   // pre-market or after-hours print is its own column. The list is ranked by
   // the regular session's move (its close's after the close), or with
   // --session extended by the extended print's move from that close.
-  const { quotes, rankedBy } = rankMoverQuotes(category, screener.data.map(moverRegularSession), basis);
+  const { quotes, rankedBy } = rankMoverQuotes(category, movers.quotes.map(moverRegularSession), basis);
   const rows = quotes.slice(0, limit).map((quote) => {
     const { extended, ...row } = quote;
     return {
@@ -227,12 +237,12 @@ async function runMoverCommand(rawArgs: string[], ctx: Parameters<CliCommandDef[
     };
   });
   const fellBack = basis === "extended" && rankedBy === "regular";
-  // A screener snapshot, as the MOST report reads it: delayed, each row dated by its own last price.
+  // As the MOST report reads it: real-time for a Pro account, delayed otherwise, each row dated by its own last price.
   ctx.printResult({
     data: rows,
     metadata: { category, rankedBy },
     ...(fellBack ? { warnings: ["No pre-market or after-hours prints now, so the list is ranked by the regular-session move."] } : {}),
-    freshness: rowsFreshness(rows, { status: "delayed" }, { stale: screener.stale === true }),
+    freshness: rowsFreshness(rows, { status: movers.source === "cloud" ? "live" : "delayed" }, { stale: movers.stale }),
   }, {
     heading: `Ranked by ${MOVER_RANKING_LABELS[rankedBy]}`,
     columns: [
@@ -263,15 +273,30 @@ async function runQuoteBasket(symbols: string[], ctx: Parameters<CliCommandDef["
   });
 }
 
-/** The UTC date, or the UTC time with its zone named (and the reader's own beside it), of an event's timestamp. */
-function utcDateTimePart(value: unknown, part: "date" | "time"): string {
+/**
+ * The UTC date, or the UTC time with its zone named, of an event's timestamp;
+ * with `readerClock`, the reader's configured clock beside it.
+ */
+function utcDateTimePart(value: unknown, part: "date" | "time", readerClock = true): string {
   const date = new Date(String(value));
   if (Number.isNaN(date.getTime())) return "";
   const iso = date.toISOString();
-  return part === "date" ? iso.slice(0, 10) : `${iso.slice(11, 16)} UTC${localTimeSuffix(date.getTime())}`;
+  return part === "date" ? iso.slice(0, 10) : `${iso.slice(11, 16)} UTC${readerClock ? localTimeSuffix(date.getTime()) : ""}`;
 }
 
-const ECON_USAGE = "econ [--country <region>] [--impact <level>] [--from <date>]";
+const ECON_USAGE = "econ [--country <regions or countries>] [--impact <level>] [--from <date>] [--tz <zone>]";
+const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
+/** "Sat" for 2026-10-31. */
+const weekdayOf = (date: string) => WEEKDAYS[new Date(`${date}T00:00:00Z`).getUTCDay()]!;
+
+/** Mon to Sun, so a release on a weekend (China's PMI on a Saturday) reads as one. */
+const ECON_DAY_COLUMN = { key: "day", header: "Day", shrink: false };
+
+/** A publisher's clock for a row it times itself: `13:00 Mexico City` from 13:00 in America/Mexico_City. */
+function publisherClock(localTime: unknown, timeZone: unknown): string {
+  if (typeof localTime !== "string" || !localTime || typeof timeZone !== "string" || !timeZone) return "";
+  return `${localTime} ${timeZoneCity(timeZone)}`;
+}
 const DAY_MS = 86_400_000;
 
 /**
@@ -312,22 +337,24 @@ 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. */
+/** The pane's regions and ISO country codes, comma separated (`MX,BR,ZA`, `G7,MX`); 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.`);
+  const parsed = parseCountryFilter(value);
+  return "error" in parsed ? ctx.fail(parsed.error, COUNTRY_FILTER_HINT) : parsed.filter;
 }
 
-/** 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(", ")}.`;
+/** Blank times, each with why: a bank whose calendar gives the day and not the time. */
+function blankTimeNotes(rows: ReadonlyArray<{ event: string; country: string; timeNote: string | null }>): string[] {
+  const byNote = new Map<string, string[]>();
+  for (const row of rows) {
+    if (!row.timeNote) continue;
+    const named = `${row.event} (${row.country})`;
+    const events = byNote.get(row.timeNote) ?? [];
+    if (!events.includes(named)) events.push(named);
+    byNote.set(row.timeNote, events);
+  }
+  return [...byNote].map(([note, events]) => `No time for ${events.join(", ")}: ${note.charAt(0).toLowerCase()}${note.slice(1)}.`);
 }
 
 async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>[1]) {
@@ -335,6 +362,11 @@ async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>
   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);
+  const tzOption = takeOption(rawArgs, "--tz");
+  const viewerZone = tzOption == null ? null : canonicalTimeZone(tzOption);
+  if (tzOption != null && !viewerZone) {
+    ctx.fail(`Unknown time zone "${tzOption}".`, "Use an IANA zone name, such as America/New_York, Europe/London or Asia/Tokyo.");
+  }
   rejectArgs(rawArgs, ECON_USAGE, ctx, "Filter with --country and --impact.");
   await withCliServices(ctx, async () => {
     const todayStart = Math.floor(Date.now() / DAY_MS) * DAY_MS;
@@ -359,41 +391,76 @@ async function runEcon(args: string[], ctx: Parameters<CliCommandDef["execute"]>
     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))
+    // Countries asked for that nothing in the window is for: a quiet week there, not an unknown country.
+    const inWindow = events.filter((event) => event.date.getTime() >= fromTime);
+    const unscheduled = countriesWithoutEvents(country, inWindow);
+    const rows = inWindow
+      .filter((event) => matchesCountry(event, country) && matchesImpact(event, impact))
       .sort((left, right) => left.date.getTime() - right.date.getTime())
-      .map((event) => ({
-        date: isoDate(event.date),
-        time: event.time,
-        country: event.country,
-        impact: event.impact,
-        event: event.event,
-        actual: event.actual ?? "",
-        forecast: event.forecast ?? "",
-        prior: event.prior ?? "",
-      }));
+      .map((event) => {
+        // The viewer's clock (--tz) for a row with a time: its date and time there.
+        const clock = viewerZone && !hasNoReleaseTime(event) ? zonedClock(event.date.getTime(), viewerZone) : null;
+        return {
+          date: isoDate(event.date),
+          // The weekday on the viewer's clock (--tz), else the UTC day's; a row with no time is its day's.
+          day: weekdayOf(clock?.date ?? isoDate(event.date).slice(0, 10)),
+          time: hasNoStatedTime(event) ? "" : event.time,
+          ...(viewerZone ? { viewerDate: clock?.date ?? null, viewerTime: clock?.time ?? null } : {}),
+          country: eventCountry(event),
+          impact: event.impact,
+          event: event.event,
+          actual: event.actual ?? "",
+          forecast: event.forecast ?? "",
+          prior: event.prior ?? "",
+          // The publisher's own clock, for rows Gloom Cloud adds from a bank's or a statistics office's calendar.
+          localTime: event.localTime ?? null,
+          timeZone: event.timeZone ?? null,
+          timeNote: event.timeNote ?? null,
+          priorAsOf: event.priorAsOf ?? null,
+          // Who publishes the figure (Freddie Mac for the 30-year mortgage rate), the period it covers and its page.
+          publisher: event.source?.name ?? null,
+          referencePeriod: event.referencePeriod ?? null,
+          source: event.source?.name ?? null,
+          sourceUrl: event.source?.url ?? null,
+        };
+      });
+    // A filter of countries only, none of which has anything in the window, says so as its empty list.
+    const allUnscheduled = unscheduled.length > 0 && unscheduled.length === country.split(",").length;
+    const footnote = [listedBefore, listedAfter, ...(rows.length > 0 ? blankTimeNotes(rows) : []),
+      rows.length > 0 && unscheduled.length > 0 ? noScheduledReleasesMessage(unscheduled) : null]
+      .filter((note): note is string => !!note).join("\n");
     ctx.printResult({
       data: rows,
       ...(unread ? { warnings: [unread] } : {}),
-      metadata: { country, impact, from, listedThrough, storedFrom: past?.storedFrom ?? null },
+      metadata: { country, impact, from, listedThrough, storedFrom: past?.storedFrom ?? null, ...(viewerZone ? { timeZone: viewerZone } : {}) },
       // 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: unlistedCountryMessage(country, events) ?? econEmptyMessage(from, listedThrough, listedAfter != null),
+      empty: allUnscheduled ? noScheduledReleasesMessage(unscheduled) : 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.
         { key: "date", header: "Date", format: (value) => utcDateTimePart(value, "date") },
-        { key: "time", header: "Time", format: (value, row) => value === "All Day" ? "All day" : utcDateTimePart(row.date, "time") },
+        // The weekday sits before the clock it is on: the UTC time's, or with --tz the viewer's.
+        ...viewerZone ? [] : [ECON_DAY_COLUMN],
+        // With --tz the viewer's clock has its own column, so the UTC time does not repeat it.
+        { key: "time", header: "Time", format: (value, row) => value === "All Day" ? "All day" : value === ""
+          ? "" : utcDateTimePart(row.date, "time", !viewerZone) },
+        ...viewerZone ? [ECON_DAY_COLUMN] : [],
+        // Only --tz fills it: the viewer's clock, its weekday in Day before it.
+        { key: "viewerTime", header: viewerZone ? timeZoneCity(viewerZone) : "Viewer", shrink: false,
+          format: (value) => typeof value === "string" && viewerZone ? value : "" },
+        // Only rows a publisher times itself fill it, so the feeds' calendar prints as before.
+        { key: "localTime", header: "Local", optional: true, dropPriority: 1, format: (value, row) => publisherClock(value, row.timeZone) },
         { key: "country", header: "Country" },
         { key: "impact", header: "Impact" },
         { key: "event", header: "Event" },
         { key: "actual", header: "Actual" },
         { key: "forecast", header: "Forecast" },
         { key: "prior", header: "Prior" },
+        { key: "publisher", header: "Publisher", format: (value) => typeof value === "string" ? value : "" },
       ],
     });
   });
@@ -439,7 +506,7 @@ async function runFredList(filter: string, ctx: Parameters<CliCommandDef["execut
       { 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.",
+    empty: filter ? `No supported FRED series match "${filter}". Run gloom fred --list to see them all.` : "No FRED series are listed.",
   });
 }
 
@@ -453,7 +520,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   // 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}`);
+      ctx.fail("--list takes a filter, not --start, --sort or --change.", `Usage: gloom ${FRED_LIST_USAGE}`);
     }
     return runFredList(args.join(" ").trim(), ctx);
   }
@@ -468,7 +535,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   // 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`);
+    if (isUnsupportedSeries(error)) ctx.fail(`Unsupported FRED series ${seriesId}. List supported series with: gloom fred --list`);
     throw error;
   });
   // Every observation exports as `value`, a spread in basis points; its unit goes in the `currency_or_unit` column.
@@ -493,6 +560,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   const notes = [
     ...fredHistoryNotes({ startDate, startGiven: start != null, seriesStart: data.info?.observationStart }),
     laggingSeriesNote(seriesId),
+    computedFredSeriesNote(seriesId),
   ].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" })
@@ -508,6 +576,8 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
   // 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);
+  // When the newest figure was released: the report is as of then, `Sep 2026, released Tue 20 Oct`.
+  const releasedOn = ahead ? undefined : data.observations.find((observation) => observation.date === newestDate)?.releasedOn;
   ctx.printResult({
     data: rows,
     metadata: {
@@ -520,6 +590,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
       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 } : {}),
+      ...(releasedOn ? { releasedOn } : {}),
       ...(publisher ? { publisher } : {}),
       ...(publishedAt ? { publishedAt } : {}),
     }),
@@ -605,8 +676,8 @@ async function runCorrelation(rawArgs: string[], ctx: Parameters<CliCommandDef["
   const args = [...rawArgs];
   const exchange = takeOption(args, "--exchange");
   const usage = "correlation <symbol-a> <symbol-b>";
-  requireArg(args[0], `Usage: gloomberb ${usage}`, ctx);
-  requireArg(args[1], `Usage: gloomberb ${usage}`, ctx);
+  requireArg(args[0], `Usage: gloom ${usage}`, ctx);
+  requireArg(args[1], `Usage: gloom ${usage}`, ctx);
   rejectExtraArgs(args, 2, { usage, takes: "two symbols", advice: "Run it once per pair." }, ctx);
   await withCliServices(ctx, async (services) => {
     // --exchange is for a symbol that names no exchange of its own.
@@ -697,11 +768,13 @@ export const overviewCliCommands: CliCommandDef[] = [
       group: CLI_COMMAND_GROUPS.markets,
       usage: [ECON_USAGE],
       options: [
-        { flags: "--country <region>", description: "US, G7, EU, all (default), or one country by its two-letter code, such as TR" },
+        { flags: "--country <regions or countries>", description: "US, G7, EU, all (default), or countries by their two-letter codes, comma separated, such as MX or MX,BR,ZA" },
         { 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` },
+        { flags: "--tz <zone>", description: "Add a column with each release's time on that clock, an IANA zone such as America/New_York; with the weekday when it falls on another day than the UTC date" },
       ],
-      examples: ["econ", "econ --country US --impact high", "econ --country TR", "econ --from 2026-10-12 --country US", "econ --tail 20"],
+      examples: ["econ", "econ --country US --impact high", "econ --country MX,BR,ZA,IN,KR", "econ --from 2026-10-12 --country US",
+        "econ --country BR --tz America/New_York", "econ --tail 20"],
     },
     execute: runEcon,
   },
@@ -723,7 +796,7 @@ export const overviewCliCommands: CliCommandDef[] = [
       sections: [{
         title: "Series",
         lines: [
-          "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.",
+          "Gloom Cloud serves a curated set of FRED series and needs no sign-in for them. gloom fred (or fred --list) prints them by topic; any other ID fails with that pointer.",
         ],
       }],
       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"],

package/src/cli/commands/plugins.ts

@@ -54,8 +54,8 @@ const PLUGINS_DIR = getPluginsDir();
  * not removed for the user: an older Gloomberb sharing it may still load it.
  */
 function absorbedNotice(absorbed: AbsorbedPlugin, directory: string | null): string {
-  const built = `${absorbed.name} is built into Gloomberb now`;
-  return directory ? `${built}; remove this copy with "gloomberb remove ${directory}".` : `${built}.`;
+  const built = `${absorbed.name} is built into Gloom now`;
+  return directory ? `${built}; remove this copy with "gloom remove ${directory}".` : `${built}.`;
 }
 
 export async function updatePlugins(name?: string) {
@@ -71,7 +71,7 @@ export async function updatePlugins(name?: string) {
     const targetDir = join(PLUGINS_DIR, dir);
     const absorbed = findAbsorbedCheckout(targetDir);
     if (absorbed) {
-      console.log(cliStyles.muted(`Skipping ${dir} (${absorbed.name} is built into Gloomberb now)`));
+      console.log(cliStyles.muted(`Skipping ${dir} (${absorbed.name} is built into Gloom now)`));
       continue;
     }
     if (lstatSync(targetDir, { throwIfNoEntry: false })?.isSymbolicLink()) {
@@ -86,7 +86,7 @@ export async function updatePlugins(name?: string) {
     const listing = remote ? listings.get(remote.toLowerCase()) : undefined;
     const required = requiredGloomberb(listing?.minGloomberb);
     if (required) {
-      console.log(cliStyles.warning(`Skipping ${dir} (needs Gloomberb ${required}, this is ${VERSION})`));
+      console.log(cliStyles.warning(`Skipping ${dir} (needs Gloom ${required}, this is ${VERSION})`));
       continue;
     }
     try {
@@ -188,16 +188,16 @@ async function doctorPlugin(nameOrPath: string): Promise<PluginDoctorReport> {
   add("entry", "ok", basename(entryFile));
 
   const link = linkHostPackages(candidate);
-  if (link.error) add("host-link", "fail", `gloomberb runtime is not linked: ${link.error}`);
+  if (link.error) add("host-link", "fail", `Gloom runtime is not linked: ${link.error}`);
   else if (link.provider === "process") add("host-link", "ok", "served by the host process");
   else add("host-link", "ok", `linked ${link.linked.join(", ")}`);
 
   const incompatible = checkPluginCompatibility(candidate);
   const declaredMin = readPluginManifest(candidate).minGloomberb;
   // The loader skips this check for a linked checkout, so it only warns there.
-  if (incompatible) add("gloomberb", linked ? "warn" : "fail", incompatible.error);
-  else if (declaredMin) add("gloomberb", "ok", `${formatVersion(declaredMin)} or newer`);
-  else add("gloomberb", "warn", "Declares no minimum Gloomberb: set minGloom in gloom.json.");
+  if (incompatible) add("gloom", linked ? "warn" : "fail", incompatible.error);
+  else if (declaredMin) add("gloom", "ok", `${formatVersion(declaredMin)} or newer`);
+  else add("gloom", "warn", "Declares no minimum Gloom: set minGloom in gloom.json.");
 
   // Before the import: a removed export is exactly what makes it fail.
   const sources = pluginSourceFiles(candidate).map((file) => readFileSync(file, "utf-8"));
@@ -363,7 +363,7 @@ export async function listPlugins(ctx: CliCommandContext, options: { check?: boo
     columns,
     text: (rows) => {
       if (rows.length === 0) {
-        return cliStyles.muted("No plugins installed. Install one with gloomberb install <user/repo>.");
+        return cliStyles.muted("No plugins installed. Install one with gloom install <user/repo>.");
       }
       return [
         renderTable(

package/src/cli/commands/remote.ts

@@ -1,8 +1,9 @@
 import { getDataDir } from "../../data/config/store";
-import type { CliCommandContext, CliCommandDef } from "../../types/plugin";
+import type { CliCommandContext } from "../../types/plugin";
 import { sendRemoteControlRequest } from "../../remote/client";
 import type { RemoteAppKind, RemoteControlRequest, RemoteControlResponse } from "../../remote/types";
 import { CLI_COMMAND_GROUPS } from "../help";
+import type { BuiltinCliCommandDef } from "../command-options";
 
 interface RemoteArgs {
   args: string[];
@@ -11,9 +12,11 @@ interface RemoteArgs {
   intervalMs: number;
 }
 
-export const remoteCliCommand: CliCommandDef = {
+export const remoteCliCommand: BuiltinCliCommandDef = {
   name: "remote",
-  description: "Drive a running gloomberb app through its remote API",
+  description: "Drive a running Gloom app through its remote API",
+  // Resources, operations and JSON go to the app as typed.
+  keepsArgAsTyped: () => true,
   help: {
     group: CLI_COMMAND_GROUPS.app,
     usage: [
@@ -37,21 +40,21 @@ export const remoteCliCommand: CliCommandDef = {
     const parsed = parseRemoteArgs(rawArgs);
     const action = parsed.args[0];
     if (!action) {
-      ctx.fail("Usage: gloomberb remote <schema|help|get|call|patch|batch|watch>");
+      ctx.fail("Usage: gloom remote <schema|help|get|call|patch|batch|watch>");
       return;
     }
 
     // No data folder means this profile never opened the app, so none is running to drive.
     const dataDir = await getDataDir();
     if (!dataDir) {
-      ctx.fail("No running Gloomberb app found.", "Open the desktop app or run gloomberb, then try again.");
+      ctx.fail("No running Gloom app found.", "Open the desktop app or run gloom, then try again.");
       return;
     }
 
     if (action === "watch") {
       const resource = parsed.args[1];
       if (!resource) {
-        ctx.fail("Usage: gloomberb remote watch <resource>");
+        ctx.fail("Usage: gloom remote watch <resource>");
         return;
       }
       const limit = ctx.cliOptions.limit ?? Number.POSITIVE_INFINITY;
@@ -125,12 +128,12 @@ function buildRemoteRequest(action: string, parsed: RemoteArgs, dryRun: boolean)
       return { type: "help" };
     case "get": {
       const resource = parsed.args[1];
-      if (!resource) throw new Error("Usage: gloomberb remote get <resource>");
+      if (!resource) throw new Error("Usage: gloom remote get <resource>");
       return { type: "get", resource };
     }
     case "call": {
       const operation = parsed.args[1];
-      if (!operation) throw new Error("Usage: gloomberb remote call <operation> [json]");
+      if (!operation) throw new Error("Usage: gloom remote call <operation> [json]");
       return {
         type: "call",
         operation,
@@ -141,7 +144,7 @@ function buildRemoteRequest(action: string, parsed: RemoteArgs, dryRun: boolean)
     case "patch": {
       const resource = parsed.args[1];
       const patchRaw = parsed.args[2];
-      if (!resource || !patchRaw) throw new Error("Usage: gloomberb remote patch <resource> <json-patch>");
+      if (!resource || !patchRaw) throw new Error("Usage: gloom remote patch <resource> <json-patch>");
       const patch = parseJsonValue(patchRaw, []);
       if (!Array.isArray(patch)) throw new Error("Remote patch payload must be a JSON array.");
       return {
@@ -154,7 +157,7 @@ function buildRemoteRequest(action: string, parsed: RemoteArgs, dryRun: boolean)
     }
     case "batch": {
       const payload = parseJsonValue(parsed.args[1], null);
-      if (!payload) throw new Error("Usage: gloomberb remote batch <json>");
+      if (!payload) throw new Error("Usage: gloom remote batch <json>");
       if (Array.isArray(payload)) return { type: "batch", requests: payload as RemoteControlRequest[], dryRun };
       return withCliDryRun(payload as RemoteControlRequest, dryRun);
     }