@gloom-sh/terminal 0.19.1 → 0.19.3

package/src/cli/registry.ts

@@ -6,7 +6,7 @@ import type {
   GloomPlugin,
 } from "../types/plugin";
 import type { LoadedExternalPlugin } from "../plugins/loader";
-import { getPluginCatalog } from "../plugins/catalog";
+import { getBuiltinCliCommands } from "../plugins/catalog-cli";
 import { initCliServices, initConfigData, initMarketData } from "./context";
 import { closeAndFail, fail } from "./errors";
 import { DEFAULT_CLI_OPTIONS, type CliGlobalOptions } from "./options";
@@ -38,11 +38,14 @@ export interface CliCommandRegistry {
   config: AppConfig | null;
   plugins: GloomPlugin[];
   externalPlugins: LoadedExternalPlugin[];
+  /** Loads installed contributions when dispatch or application services need them. */
+  ensureExternalPlugins?: () => Promise<void>;
 }
 
 interface BuildCliCommandRegistryOptions {
   coreCommands: CliCommandDef[];
   externalPlugins?: LoadedExternalPlugin[];
+  loadExternalPlugins?: () => Promise<LoadedExternalPlugin[]>;
   config?: AppConfig | null;
 }
 
@@ -72,11 +75,11 @@ export function normalizeCliDispatchResult(result: void | CliDispatchResult): Cl
 export function buildCliCommandRegistry({
   coreCommands,
   externalPlugins = [],
+  loadExternalPlugins,
   config = null,
 }: BuildCliCommandRegistryOptions): CliCommandRegistry {
   const allCommands: RegisteredCliCommand[] = [];
   const allTokens = new Map<string, RegisteredCliCommand>();
-  const catalog = getPluginCatalog(externalPlugins);
   const disabledPlugins = new Set(config?.disabledPlugins ?? []);
 
   const registerCommand = (
@@ -110,8 +113,10 @@ export function buildCliCommandRegistry({
     registerCommand(command, "core", "core", true);
   }
 
-  const loadablePlugins: GloomPlugin[] = [];
-  for (const entry of catalog) {
+  for (const { pluginId, commands } of getBuiltinCliCommands()) {
+    for (const command of commands) registerCommand(command, pluginId, "plugin", true);
+  }
+  for (const entry of externalPlugins) {
     if (entry.error) {
       registryLog.warn(`Skipping external plugin "${entry.plugin.id}" for CLI registration.`, {
         path: entry.path,
@@ -119,9 +124,8 @@ export function buildCliCommandRegistry({
       });
       continue;
     }
-    loadablePlugins.push(entry.plugin);
     for (const command of entry.plugin.cliCommands ?? []) {
-      registerCommand(command, entry.plugin.id, "plugin", entry.source === "builtin");
+      registerCommand(command, entry.plugin.id, "plugin", false);
     }
   }
 
@@ -137,30 +141,54 @@ export function buildCliCommandRegistry({
     }
   }
 
-  return {
+  let plugins: GloomPlugin[] | undefined;
+  let loading: Promise<void> | undefined;
+  const registry: CliCommandRegistry = {
     commands,
     lookup,
     config,
-    plugins: loadablePlugins.filter((plugin) => !disabledPlugins.has(plugin.id)),
+    get plugins() {
+      const { getPluginCatalog } = require("../plugins/catalog") as typeof import("../plugins/catalog");
+      return plugins ??= getPluginCatalog(registry.externalPlugins)
+        .filter((entry) => !entry.error && !disabledPlugins.has(entry.plugin.id))
+        .map((entry) => entry.plugin);
+    },
     externalPlugins,
+    ...(loadExternalPlugins ? { ensureExternalPlugins: () => loading ??= (async () => {
+      const loaded = await loadExternalPlugins();
+      const expanded = buildCliCommandRegistry({ coreCommands, externalPlugins: loaded, config });
+      registry.commands = expanded.commands;
+      registry.lookup = expanded.lookup;
+      registry.externalPlugins = loaded;
+      // A command can retain ctx.plugins before opening market data (search does).
+      // Keep that reference current without materializing panes for command-only work.
+      if (plugins) plugins.splice(0, plugins.length, ...expanded.plugins);
+    })() } : {}),
   };
+  return registry;
 }
 
 export function createCliCommandContext(
   ownerId: string,
-  registryOrPlugins: Pick<CliCommandRegistry, "plugins" | "externalPlugins"> | GloomPlugin[],
+  registryOrPlugins: Pick<CliCommandRegistry, "plugins" | "externalPlugins" | "ensureExternalPlugins"> | GloomPlugin[],
   cliOptions: CliGlobalOptions = DEFAULT_CLI_OPTIONS,
   args: readonly string[] = [],
 ): CliCommandContext {
-  const registry = Array.isArray(registryOrPlugins)
+  const registry: Pick<CliCommandRegistry, "plugins" | "externalPlugins" | "ensureExternalPlugins"> = Array.isArray(registryOrPlugins)
     ? { plugins: registryOrPlugins, externalPlugins: [] }
     : registryOrPlugins;
   return {
     initConfigData,
-    initMarketData: () => initMarketData({ plugins: registry.plugins }),
-    initServices: () => initCliServices({ externalPlugins: registry.externalPlugins }),
+    initMarketData: async () => {
+      await registry.ensureExternalPlugins?.();
+      return initMarketData({ plugins: registry.plugins });
+    },
+    initServices: async () => {
+      await registry.ensureExternalPlugins?.();
+      return initCliServices({ externalPlugins: registry.externalPlugins });
+    },
     cliOptions,
-    plugins: registry.plugins,
+    get plugins() { return registry.plugins; },
     fail,
     closeAndFail,
     output: {

package/src/cli/result.ts

@@ -93,6 +93,8 @@ export interface CliResultRenderOptions<T = unknown, Row = Record<string, unknow
   heading?: string;
   /** Text-mode line printed under the rows, such as where a listing stops. Not printed with no rows: say it in `empty`. */
   footnote?: string;
+  /** Text-mode line under each table row, indented and muted, cut to the width: a story's summary under its headline. */
+  rowNote?: (row: Row) => string | null | undefined;
   /** Text-mode block printed under the rows and footnote, for figures about a row that are not columns. */
   details?: (data: T) => string;
   /**
@@ -446,6 +448,7 @@ function formatTextCell<Row extends Record<string, unknown>>(
 function renderTextTable<Row extends Record<string, unknown>>(
   rows: Row[],
   columns?: CliResultColumn<Row>[],
+  rowNote?: (row: Row) => string | null | undefined,
 ): string {
   const resolvedColumns = textColumns(rows, columns);
   const cells = rows.map((row) => resolvedColumns.map((column) => formatTextCell(column, row, "table")));
@@ -469,6 +472,7 @@ function renderTextTable<Row extends Record<string, unknown>>(
       stackRows: column.stackRows,
     })),
     cells.map((row) => shown.map(({ index }) => row[index]!)),
+    rowNote ? { below: rows.map((row) => { const note = rowNote(row); return note ? [note] : []; }), cutBelow: true } : {},
   );
 }
 
@@ -581,15 +585,16 @@ function serializeCliRows<T, Row extends Record<string, unknown>>(
   if (renderOptions.text) {
     return renderOptions.text(result.data);
   }
-  const summary = renderOptions.summary?.(result.data) ?? "";
-  const withHeading = (text: string) => renderOptions.heading ? `${renderOptions.heading}\n${text}` : text;
+  // The heading's lines, the summary and the notes are prose: each wraps to a narrow --width, as the source line does.
+  const summary = wrapToTerminal(renderOptions.summary?.(result.data) ?? "");
+  const withHeading = (text: string) => renderOptions.heading ? `${wrapToTerminal(renderOptions.heading)}\n${text}` : text;
   if (rows.length === 0) {
-    return withHeading(summary || cliStyles.muted(renderOptions.empty ?? "No results."));
+    return withHeading(summary || cliStyles.muted(wrapToTerminal(renderOptions.empty ?? "No results.")));
   }
   const table = renderTextRows(rows as Row[], result.data, renderOptions);
   const notes = [window.note, renderOptions.footnote].filter((note): note is string => !!note);
   const details = renderOptions.details?.(result.data) ?? "";
-  const body = [table, ...notes.map((note) => cliStyles.muted(note)), ...details ? ["", details] : []].join("\n");
+  const body = [table, ...notes.map((note) => cliStyles.muted(wrapToTerminal(note))), ...details ? ["", details] : []].join("\n");
   return withHeading(summary ? `${summary}\n\n${body}` : body);
 }
 
@@ -607,7 +612,7 @@ function renderTextRows<T, Row extends Record<string, unknown>>(
   }
   return layout === "record"
     ? renderTextRecords(rows as Row[], columns)
-    : renderTextTable(rows as Row[], columns);
+    : renderTextTable(rows as Row[], columns, renderOptions.rowNote);
 }
 
 /** Settles once the result `printCliResult` last wrote has left the process: a pipe can hold it back. */
@@ -640,8 +645,9 @@ export function printCliResult<T, Row extends Record<string, unknown> = Record<s
   // JSON carries warnings in its envelope. Text, CSV and NDJSON are only the
   // rows, so a warning goes to stderr, out of a file the rows are piped into.
   if (options.format !== "json" && !options.quiet) {
+    // Each wraps to a narrow --width, as a note does.
     for (const warning of result.warnings ?? []) {
-      console.error(`${cliStyles.warning("warning:")} ${hinted(warning)}`);
+      console.error(wrapToTerminal(`${cliStyles.warning("warning:")} ${hinted(warning)}`));
     }
   }
   // CSV says what its rows do not in closing `# note:` lines; NDJSON has no place for one among its rows,

package/src/cli/ticker-resolution.ts

@@ -139,7 +139,8 @@ export interface CliTickerOptions {
  */
 export class CoinListingError extends ListingArgError {
   constructor(message: string, details: string, readonly hint: string) {
-    super(message, `${details}\n${hint}`);
+    // A listing message that already ends in the coin note (`describeOtherListings`) keeps it once.
+    super(message, details.endsWith(hint) ? details : `${details}\n${hint}`);
     this.name = "CoinListingError";
   }
 }

package/src/cli/types.ts

@@ -21,6 +21,8 @@ export type MarketContext = ConfigContext & {
   seriesCapabilities?: CapabilityInvoker;
   /** The catalog series charted as an expression (`FRED:DFII10`), in a report run without the plugin runtime. */
   findCatalogSeries?: (expression: string) => import("../series/types").SeriesDefinition | undefined;
+  /** The catalog series a bare word is an alias of (`hashrate`), in a report run without the plugin runtime. */
+  findCatalogSeriesNamed?: (word: string) => import("../series/types").SeriesDefinition | undefined;
   /** `--refresh`: prefetched data bypasses the local cache. */
   refresh?: boolean;
   /** Filings behind the statements and a bank's figures, read from Gloom Cloud; absent where the data service is a stand-in. */

package/src/components/chart/composite/format.ts

@@ -49,6 +49,7 @@ function formatFullCurrencyValue(
   options: MarketFormatOptions = {},
 ): string | null {
   if (unit.trim() === INDEX_POINTS_UNIT) return formatMarketPrice(value, { ...options, assetCategory, priceBasis: "points" });
+  if (unit.trim() === "32nds") return formatMarketPrice(value, { ...options, assetCategory, priceBasis: "thirty-seconds" });
   const currency = unitCurrencyCode(unit);
   return currency ? formatMarketPriceWithCurrency(value, currency, { ...options, assetCategory }) : null;
 }
@@ -362,6 +363,8 @@ export function formatCompositeAxisValue(value: number, domain: CompositeAxisDom
   // Derived dimensions are included in the legend value. Axis labels stay
   // numeric so a narrow gutter cannot truncate USD/JPY into a false USD label.
   if (group.startsWith("derived-unit:")) return compact;
+  // Treasury prices keep their whole points and 32nds at every zoom level.
+  if (domain.unit.trim() === "32nds") return formatAxisPriceValue(value, domain);
   // Compact labels suit a wide view, but a zoomed one can hold several ticks
   // inside a single rounding step and print one repeated price down the gutter.
   // Where that happens the axis spends the digits needed to tell them apart,

package/src/components/chart-table/header.tsx

@@ -257,7 +257,7 @@ export function ChartTableHeader(props: ChartTableHeaderProps) {
   return (
     <Box flexDirection="column" flexShrink={0}>
       {query}
-      {layout.figureRows ? <StatGrid items={layout.figures} width={width} /> : null}
+      {layout.figureRows ? <StatGrid items={layout.figures} width={width} maxLines={layout.figureMaxLines} /> : null}
       {band}
     </Box>
   );

package/src/components/chart-table/layout.ts

@@ -31,6 +31,8 @@ const CHART_SHARE = 0.4;
 const SHORT_BODY_ROWS = 12;
 /** The figures never take more than this share of the body. */
 const FIGURE_SHARE = 0.25;
+/** The share of the body figures that wrap rather than cut a date may take, beyond FIGURE_SHARE. */
+const WRAPPED_FIGURE_SHARE = 1 / 3;
 
 /**
  * The rows a kit table spends outside its body: the header, plus a horizontal
@@ -70,15 +72,28 @@ export interface ChartTableLayoutInput {
 export interface ChartTableLayout {
   figures: StatItem[];
   figureRows: number;
+  /** The lines the figures may take, so a whole-row cell too narrow for one line wraps within them (StatGrid's `maxLines`). */
+  figureMaxLines: number;
   mode: ChartBandMode;
   chartRows: number;
 }
 
-/** Drops figures from the end until they fit the row budget. */
-function fitFigures(figures: readonly StatItem[], width: number, maxRows: number): StatItem[] {
+/** Rows `figures` take within `maxLines` (StatGrid's own count). */
+function figureRows(figures: readonly StatItem[], width: number, maxLines: number): number {
+  return statGridRows([...figures], width, undefined, { maxLines });
+}
+
+/**
+ * The figures that fit the row budget a line each, dropped from the end, and
+ * the lines they may take: a whole-row figure too narrow for one line wraps
+ * onto a second rather than cut a date, into rows up to WRAPPED_FIGURE_SHARE
+ * of the body, the leading ones first; the rest keep one line, cut. Wrapping
+ * never costs a figure that fits a line. A budget of one row wraps none.
+ */
+function fitFigures(figures: readonly StatItem[], width: number, maxRows: number, body: number): { figures: StatItem[]; maxLines: number } {
   const kept = [...figures];
-  while (kept.length > 0 && statGridRows(kept, width) > maxRows) kept.pop();
-  return kept;
+  while (kept.length > 0 && figureRows(kept, width, maxRows) > maxRows) kept.pop();
+  return { figures: kept, maxLines: maxRows > 1 ? Math.max(maxRows, Math.floor(body * WRAPPED_FIGURE_SHARE)) : maxRows };
 }
 
 /**
@@ -89,7 +104,9 @@ function fitFigures(figures: readonly StatItem[], width: number, maxRows: number
  *   fewer), so the rows the pane is about never vanish.
  * - The figures take at most a quarter of the body, one row when it is short
  *   or when a second row would cost the chart its place, and lose items from
- *   the end rather than wrap.
+ *   the end rather than spill; a whole-row figure wraps onto a second line
+ *   rather than cut its detail, in rows up to a third of the body, never
+ *   at the cost of a figure that fits a line.
  * - The chart takes 40% of what is left, or everything the table does not
  *   need when all its rows fit, so no blank band opens under a short table.
  * - Below a readable chart the band becomes a one-row strip, then nothing.
@@ -125,11 +142,11 @@ function layoutWithFigureRows(input: ChartTableLayoutInput, body: number, figure
 
   // A table with no room for a single row after the figures gets the body back.
   const figureBudget = Math.min(figureCap, Math.max(0, body - chrome - Math.min(tableRows, 1)));
-  const figures = figureBudget > 0 ? fitFigures(input.figures ?? [], width, figureBudget) : [];
-  const figureRows = figures.length ? statGridRows(figures, width) : 0;
+  const { figures, maxLines: figureMaxLines } = figureBudget > 0 ? fitFigures(input.figures ?? [], width, figureBudget, body) : { figures: [], maxLines: 0 };
+  const shownRows = figures.length ? figureRows(figures, width, figureMaxLines) : 0;
 
-  const rest = body - figureRows;
-  const none: ChartTableLayout = { figures, figureRows, mode: "none", chartRows: 0 };
+  const rest = body - shownRows;
+  const none: ChartTableLayout = { figures, figureRows: shownRows, figureMaxLines, mode: "none", chartRows: 0 };
   if (!input.chart || width < CHART_MIN_WIDTH) return none;
 
   const minRows = input.chart.minRows ?? CHART_MIN_ROWS;
@@ -137,7 +154,7 @@ function layoutWithFigureRows(input: ChartTableLayoutInput, body: number, figure
   const maxRows = input.chart.maxRows ?? Number.POSITIVE_INFINITY;
   const room = rest - tableMin;
   const spare = rest - tableFit;
-  const full = (rows: number): ChartTableLayout => ({ figures, figureRows, mode: "full", chartRows: Math.min(rows, maxRows) });
+  const full = (rows: number): ChartTableLayout => ({ figures, figureRows: shownRows, figureMaxLines, mode: "full", chartRows: Math.min(rows, maxRows) });
   if (room >= minRows) {
     // With every table row in view beside a readable chart, the chart takes
     // exactly the rest; otherwise its 40% share, never below what it draws in.
@@ -148,7 +165,7 @@ function layoutWithFigureRows(input: ChartTableLayoutInput, body: number, figure
   // instead of a strip over a blank band.
   if (spare >= compactRows) return full(spare);
   if (input.chart.strip !== false && room >= 1) {
-    return { figures, figureRows, mode: "strip", chartRows: 1 };
+    return { figures, figureRows: shownRows, figureMaxLines, mode: "strip", chartRows: 1 };
   }
   return none;
 }

package/src/components/command-bar/action-runtime.ts

@@ -32,6 +32,8 @@ interface UseCommandBarActionRuntimeOptions {
   dispatch: Dispatch<AppAction>;
   focusedPaneId: string | null;
   onCheckForUpdates?: () => void | Promise<void>;
+  /** Settings' Run Setup Again; absent where setup cannot run. */
+  onRunSetupAgain?: () => Promise<void>;
   persistConfig: (nextConfig: AppState["config"]) => void;
   pluginRegistry: PluginRegistry;
   pushRoute: (route: CommandBarRoute) => void;
@@ -57,6 +59,7 @@ export function useCommandBarActionRuntime({
   dispatch,
   focusedPaneId,
   onCheckForUpdates,
+  onRunSetupAgain,
   persistConfig,
   pluginRegistry,
   pushRoute,
@@ -222,6 +225,7 @@ export function useCommandBarActionRuntime({
     focusTicker,
     notify,
     onCheckForUpdates,
+    onRunSetupAgain,
     openBuiltInWorkflow,
     openInlineConfirm,
     openModeRoute,

package/src/components/command-bar/commands/direct/index.ts

@@ -29,6 +29,7 @@ import { parseWindowModeCommandArg } from "../../layout-items";
 import type { CommandBarRoute } from "../../workflow/types";
 import { recordFunctionOpen } from "../../../../telemetry/usage-counts";
 import { reportTelemetryConfig } from "../../../../telemetry/live-config";
+import { ATTENTION_OFF_MESSAGE } from "../../../../telemetry/attention-setting";
 import { NIGHTLY_CHANNEL_SUMMARY, withUpdateChannel } from "../../../../updater/channel";
 import { isPrereleaseVersion } from "../../../../utils/semver";
 import { VERSION } from "../../../../version";
@@ -53,6 +54,8 @@ export function runDirectCommandAction(options: {
   getState: () => AppState;
   notify: NotifyFn;
   onCheckForUpdates?: () => void | Promise<void>;
+  /** Settings' Run Setup Again; absent where setup cannot run. */
+  onRunSetupAgain?: () => Promise<void>;
   openBuiltInWorkflow: (actionId: string) => void;
   openInlineConfirm: OpenInlineConfirm;
   openModeRoute: (screen: "ticker-search" | "layout", initialQuery?: string) => void;
@@ -78,6 +81,7 @@ export function runDirectCommandAction(options: {
     getState,
     notify,
     onCheckForUpdates,
+    onRunSetupAgain,
     openBuiltInWorkflow,
     openInlineConfirm,
     openModeRoute,
@@ -329,47 +333,22 @@ export function runDirectCommandAction(options: {
       return;
     }
     case "toggle-crash-reports":
-    case "toggle-usage-counts": {
-      const key = command.id === "toggle-crash-reports" ? "crashReports" : "usage";
+    case "toggle-usage-counts":
+    case "toggle-attention-counts": {
+      const key = command.id === "toggle-crash-reports" ? "crashReports" : command.id === "toggle-usage-counts" ? "usage" : "attention";
+      // All three are on by default: only an explicit false is off.
       const enabled = state.config.telemetry?.[key] === false;
       const nextConfig = { ...state.config, telemetry: { ...state.config.telemetry, [key]: enabled } };
+      // Reported before React commits, so turning Attention Counts off drops unsent counts at once.
       reportTelemetryConfig(nextConfig.telemetry);
       dispatch({ type: "SET_CONFIG", config: nextConfig });
       persistConfig(nextConfig);
-      notify(`${t(command.label)}: ${t(enabled ? "on" : "off")}`, { type: "success" });
+      notify(key === "attention" && !enabled
+        ? t(ATTENTION_OFF_MESSAGE)
+        : `${t(command.label)}: ${t(enabled ? "on" : "off")}`, { type: "success" });
       closeAll({ revertThemePreview: false });
       return;
     }
-    case "toggle-attention-counts": {
-      const setEnabled = (enabled: boolean) => {
-        const current = getState().config;
-        const nextConfig = { ...current, telemetry: { ...current.telemetry, attention: enabled } };
-        // Clear unsent counts before React commits the settings update.
-        reportTelemetryConfig(nextConfig.telemetry);
-        dispatch({ type: "SET_CONFIG", config: nextConfig });
-        persistConfig(nextConfig);
-        notify(`${t(command.label)}: ${t(enabled ? "on" : "off")}`, { type: "success" });
-      };
-      if (state.config.telemetry?.attention === true) {
-        setEnabled(false);
-        closeAll({ revertThemePreview: false });
-      } else {
-        openInlineConfirm({
-          confirmId: "enable-attention-counts",
-          title: "Share Attention Counts?",
-          body: [
-            "While signed in with a verified account, share the tickers you open in DES, charts, quotes and options, and add to watchlists.",
-            "Gloom uses your account to limit contributions. Published counts are delayed and rounded, and require at least 20 contributors. Your holdings, watchlist names and searches are not included.",
-            "This is separate from Usage Counts and is off by default. Turn it off at any time to stop collection and discard unsent counts. Already published anonymous totals cannot be removed.",
-          ],
-          confirmLabel: "Share Counts",
-          cancelLabel: "Keep Off",
-          tone: "default",
-          onConfirm: async () => { setEnabled(true); },
-        });
-      }
-      return;
-    }
     case "font-size-increase":
     case "font-size-decrease": {
       const delta = command.id === "font-size-increase" ? 1 : -1;
@@ -391,6 +370,12 @@ export function runDirectCommandAction(options: {
       void onCheckForUpdates?.();
       closeAll({ revertThemePreview: false });
       return;
+    case "run-setup-again":
+      closeAll({ revertThemePreview: false });
+      void onRunSetupAgain?.().catch((error: unknown) => {
+        notify(error instanceof Error ? error.message : String(error), { type: "error" });
+      });
+      return;
     case "release-channel": {
       // The runtime checks again as soon as the channel changes.
       const setChannel = (channel: "stable" | "nightly") => {

package/src/components/command-bar/commands/direct/runtime.ts

@@ -39,6 +39,8 @@ interface UseCommandBarDirectCommandRuntimeOptions {
   focusTicker: (symbol: string, options?: PinTickerOptions) => void;
   notify: (body: string, options?: { type?: "info" | "success" | "error" }) => void;
   onCheckForUpdates?: () => void | Promise<void>;
+  /** Settings' Run Setup Again; absent where setup cannot run. */
+  onRunSetupAgain?: () => Promise<void>;
   openBuiltInWorkflow: (actionId: string) => void;
   openInlineConfirm: OpenInlineConfirm;
   openModeRoute: (
@@ -66,6 +68,7 @@ export function useCommandBarDirectCommandRuntime({
   focusTicker,
   notify,
   onCheckForUpdates,
+  onRunSetupAgain,
   openBuiltInWorkflow,
   openInlineConfirm,
   openModeRoute,
@@ -136,6 +139,7 @@ export function useCommandBarDirectCommandRuntime({
       getState,
       notify,
       onCheckForUpdates,
+      onRunSetupAgain,
       openBuiltInWorkflow,
       openInlineConfirm,
       openModeRoute,
@@ -159,6 +163,7 @@ export function useCommandBarDirectCommandRuntime({
     getState,
     notify,
     onCheckForUpdates,
+    onRunSetupAgain,
     openBuiltInWorkflow,
     openInlineConfirm,
     openModeRoute,

package/src/components/command-bar/commands/registry.ts

@@ -276,7 +276,7 @@ export const commands: Command[] = [
     id: "toggle-attention-counts",
     prefix: "",
     label: "Attention Counts",
-    description: "Opt in to sharing ticker research counts for Gloom Trending",
+    description: "Turn ticker research counts on or off (on by default)",
     category: "Config",
   },
 
@@ -309,6 +309,15 @@ export const commands: Command[] = [
     category: "Config",
   },
 
+  // Setup, from its first step on what the user has (components/onboarding/run-setup-again.ts)
+  {
+    id: "run-setup-again",
+    prefix: "",
+    label: "Run Setup Again",
+    description: "Rebuild Home and setup's desk tabs; your other layouts stay",
+    category: "Config",
+  },
+
   // Import/Export
   {
     id: "export-config",

package/src/components/command-bar/routes/root/command-items.ts

@@ -109,6 +109,9 @@ export function createRootCommandItemBuilder({
         if (state.updateProgress?.phase === "ready") return "Update ready, restart to apply";
         if (state.updateProgress?.phase === "error") return failedUpdateLabel(state.updateProgress);
         return command.label;
+      // Unlike its neighbours it started out off, so the row says what the default is now.
+      case "toggle-attention-counts":
+        return `${command.label} (on by default)`;
       default:
         return command.label;
     }
@@ -175,9 +178,9 @@ export function createRootCommandItemBuilder({
       case "toggle-usage-counts":
         return state.config.telemetry?.usage === false ? "Currently off" : "Currently on";
       case "toggle-attention-counts":
-        return state.config.telemetry?.attention === true
-          ? "Currently on: share ticker research counts"
-          : "Currently off: opt in to sharing ticker research counts";
+        return state.config.telemetry?.attention === false
+          ? "Currently off. Signed in, this turns it off on your other devices too"
+          : "Currently on: tickers you open go to Gloom, published only as hourly totals of 20+ people";
       case "release-channel":
         if (resolveUpdateChannel(state.config) === "nightly") return `Currently nightly: ${NIGHTLY_CHANNEL_SUMMARY}`;
         return isPrereleaseVersion(VERSION)
@@ -201,7 +204,7 @@ export function createRootCommandItemBuilder({
       case "toggle-usage-counts":
         return state.config.telemetry?.usage === false ? "off" : "on";
       case "toggle-attention-counts":
-        return state.config.telemetry?.attention === true ? "on" : "off";
+        return state.config.telemetry?.attention === false ? "off" : "on";
       case "release-channel":
         return resolveUpdateChannel(state.config);
       default:
@@ -223,6 +226,8 @@ export function createRootCommandItemBuilder({
         return "update";
       case "release-channel":
         return "nightly stable beta prerelease update updates channel";
+      case "run-setup-again":
+        return "settings onboarding wizard guide first run start over desks holdings";
       default:
         return "";
     }

package/src/components/command-bar/routes/root/runtime.ts

@@ -20,6 +20,21 @@ import { buildRootShortcutFeedback } from "./shortcut-feedback";
 import type { ShortcutIntent } from "./shortcuts";
 import { clampIndex } from "../../../../utils/math";
 
+/** Written the way a symbol is: up to five letters and a share class (AAPL, nvda, BRK.B). */
+const SYMBOL_SHAPED_QUERY = /^[A-Za-z]{1,5}(?:[.\-/][A-Za-z]{1,2})?$/;
+
+/**
+ * Text that asks for a symbol rather than a local row: symbol-shaped, and in
+ * capitals or in no row's name. `nvda` matches Exposure only through its
+ * example input; `upd` is in Check for Updates.
+ */
+function readsAsSymbol(text: string, rows: readonly ResultItem[]): boolean {
+  if (!SYMBOL_SHAPED_QUERY.test(text)) return false;
+  if (text === text.toUpperCase()) return true;
+  const wanted = text.toLowerCase();
+  return !rows.some((row) => isDefaultSelectable(row) && row.label.toLowerCase().includes(wanted));
+}
+
 interface UseCommandBarRootRuntimeOptions {
   activeCollectionId: string | null;
   activePortfolio?: AppState["config"]["portfolios"][number];
@@ -154,6 +169,13 @@ export function useCommandBarRootRuntime({
 } {
   const previousRootSelectionContextRef = useRef<{ query: string; mode: string } | null>(null);
   const previousRootResultIdsRef = useRef<string[]>([]);
+  /**
+   * The row the untouched highlight rests on once the query's answer is in,
+   * and the answer it was on. A later answer that reorders the rows (a
+   * fresher search over a cached one, a broker's) moves the highlight with
+   * its row, so Enter opens the row that was highlighted.
+   */
+  const pinnedRootRowRef = useRef<{ id: string; answer: string | null } | null>(null);
   const activeMatch = matchPrefix(rootQuery, availableCommands);
 
   const tickerSearchRouteQuery = currentRoute?.kind === "mode" && currentRoute.screen === "ticker-search"
@@ -310,6 +332,13 @@ export function useCommandBarRootRuntime({
     writeTickerSearchCache,
   });
   const rootSearching = tickerSearching || providerSearching;
+  // A symbol whose search has not answered: the rows on screen are what the
+  // letters match locally (a pane whose example names AAPL), not the symbol,
+  // so none of them is highlighted and Enter waits for the answer, as it would
+  // get had the symbol been typed slowly. Lower case found in a row's name
+  // (`upd`, `list`) is that row and runs at once.
+  const rootSymbolAnswerPending = !rootResultsCurrent && rootPlainTickerSearchArg !== null
+    && (rootTickerReading !== null || rootListingChoice !== null || readsAsSymbol(rootPlainTickerSearchArg, orderedRootResults));
 
   useLayoutEffect(() => {
     if (currentRoute) return;
@@ -326,6 +355,7 @@ export function useCommandBarRootRuntime({
     previousRootSelectionContextRef.current = { query: rootQuery, mode: rootModeKind };
     if (selectionContextChanged) {
       rootSelectionNavigatedRef.current = false;
+      pinnedRootRowRef.current = null;
     }
 
     setRootSelectedIdx((current) => {
@@ -338,15 +368,23 @@ export function useCommandBarRootRuntime({
         if (shiftedIdx >= 0) return shiftedIdx;
         return clampIndex(current, resultIds.length);
       }
-      // Untouched, the selection follows the best row on offer. When every row
-      // is an offer or a placeholder, none of them is the answer and none is
-      // selected: Enter must not take one of them for the ticker still being
-      // searched.
+      const pinnedIdx = pinnedRootRowRef.current ? resultIds.indexOf(pinnedRootRowRef.current.id) : -1;
+      if (pinnedIdx >= 0) return pinnedIdx;
+      // Untouched, the selection follows the best row on offer until the
+      // answer is in. When every row is an offer or a placeholder, none of
+      // them is the answer and none is selected: Enter must not take one of
+      // them for the ticker still being searched.
       const defaultIdx = orderedRootResults.findIndex(isDefaultSelectable);
-      if (defaultIdx < 0) return -1;
-      return clampIndex(Math.max(rootResultModel.initialIdx, defaultIdx), resultIds.length);
+      if (defaultIdx < 0 || rootSymbolAnswerPending) return -1;
+      const selected = clampIndex(Math.max(rootResultModel.initialIdx, defaultIdx), resultIds.length);
+      pinnedRootRowRef.current = rootResultsCurrent && resultIds[selected]
+        ? { id: resultIds[selected]!, answer: activeRootProviderResultsKey }
+        : null;
+      return selected;
     });
   }, [
+    activeRootProviderResultsKey,
+    rootResultsCurrent,
     activeMatch?.command.id,
     currentRoute,
     orderedRootResults,
@@ -354,13 +392,20 @@ export function useCommandBarRootRuntime({
     rootQuery,
     rootResultModel.initialIdx,
     rootSelectionNavigatedRef,
+    rootSymbolAnswerPending,
     setRootHoveredIdx,
     setRootSelectedIdx,
   ]);
 
   useEffect(() => {
     if (!activeRootProviderResultsKey) return;
+    // A later answer that only reorders the rows leaves the highlight on its row.
+    const pinned = pinnedRootRowRef.current;
+    if (pinned && pinned.answer !== activeRootProviderResultsKey
+      && orderedRootResults.some((item) => item.id === pinned.id)) return;
     setRootSelectedIdx(0);
+    const top = orderedRootResults[0];
+    pinnedRootRowRef.current = top ? { id: top.id, answer: activeRootProviderResultsKey } : null;
     setRootHoveredIdx(null);
     nativeListScrollRef.current?.scrollTo(0);
   }, [activeRootProviderResultsKey, nativeListScrollRef, setRootHoveredIdx, setRootSelectedIdx]);