@gloom-sh/terminal 0.19.1 → 0.19.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gloom-sh/terminal",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",
@@ -91,6 +91,7 @@
     "check:pane-layout": "bun run scripts/pane-chrome/layout-sweep.ts",
     "check:ui-tokens": "bun run scripts/pane-chrome/ui-tokens.ts",
     "ui:benchmark": "bun run scripts/pane-chrome/ui-benchmark.ts",
+    "ui:badge-ink": "bun run scripts/pane-chrome/badge-ink.ts",
     "audit:ui": "bun run scripts/pane-chrome/ui-audit.ts",
     "check:call-player": "bun run scripts/pane-chrome/call-player.ts",
     "check:chart-axis-zoom": "bun run scripts/pane-chrome/chart-axis-zoom.ts",

package/src/api-client/errors.ts

@@ -1,3 +1,5 @@
+import { isNetworkFailure } from "../utils/network-failure";
+
 const HARD_SESSION_INVALID_PATTERNS = [
   /\b(user|account)\b.*\b(not found|deleted|removed|disabled|deactivated|suspended)\b/i,
   /\b(user|account)\b.*\bdoes(?:\s+not|n't)\s+exist\b/i,
@@ -61,6 +63,42 @@ export function isRetryableApiError(error: unknown): boolean {
   return error.code === "retryable_error" || status === 408 || status === 429 || (status !== undefined && status >= 500);
 }
 
+/**
+ * A 200 reply saying its data is unavailable this time (a board's `unavailable`
+ * status, a market answer's `retryable_error`): the server's own source did
+ * not answer. Like a 5xx it may pass, so a saved copy answers it with its note.
+ * A permanent reason (a route not served yet, an unsupported symbol or series,
+ * sign-in or entitlement) comes as its status, or as a plain error, and stays
+ * the error.
+ */
+export function sourceDidNotAnswer(message: string): ApiRequestError {
+  return new ApiRequestError(message, undefined, undefined, "retryable_error");
+}
+
+/** Codes of a connection that dropped or stalled after it opened: Node's and the system's, then Bun's. */
+const INTERRUPTED_CODES = new Set(["ECONNRESET", "ECONNABORTED", "EPIPE", "ETIMEDOUT", "ConnectionClosed"]);
+
+/**
+ * A failure asking again later may get past, which a copy saved earlier may
+ * answer for: no connection, a connection that dropped, a timeout, or a server
+ * that was rate limited or overloaded (408, 429, 5xx). Anything else the
+ * server answered (another 4xx) and an answer that failed validation are
+ * refusals to show as errors, saved copy or not. A bare throw with nothing to
+ * classify is not taken for a refusal.
+ */
+export function isTransientFailure(error: unknown): boolean {
+  if (!error || typeof error !== "object") return typeof error !== "string" || isNetworkFailure(error);
+  if (isNetworkFailure(error) || isRetryableApiError(error)) return true;
+  for (let current: unknown = error, depth = 0; current && typeof current === "object" && depth < 4; depth += 1) {
+    if (current instanceof ApiRequestError) return false;
+    const { name, code } = current as { name?: unknown; code?: unknown };
+    if (name === "AbortError" || name === "TimeoutError") return true;
+    if (typeof code === "string" && INTERRUPTED_CODES.has(code)) return true;
+    current = (current as { cause?: unknown }).cause;
+  }
+  return false;
+}
+
 /** Reads `Retry-After` as milliseconds, accepting seconds or an HTTP date. */
 export function parseRetryAfterMs(
   header: string | null,

package/src/app/runtime/startup.ts

@@ -32,7 +32,7 @@ import {
   type UsageFunction,
 } from "../../telemetry/usage-counts";
 import { debugLog } from "../../utils/debug-log";
-import { startMainThreadStallMonitor } from "../../utils/main-thread-stall";
+import { markStartupComplete, startMainThreadStallMonitor } from "../../utils/main-thread-stall";
 import { measurePerfAsync } from "../../utils/perf-marks";
 
 const appLog = debugLog.createLogger("app");
@@ -161,6 +161,8 @@ export function useAppStartupRuntime({
       } catch (err) {
         logFailure("app.runtime.startup", "Workspace startup hydration failed")(err);
       }
+      // The workspace has its data (or gave up on it): stalls from here on are not startup ones.
+      markStartupComplete();
     })();
   }, [
     autoImportBrokerPositions,

package/src/capabilities/chart-series.ts

@@ -203,7 +203,7 @@ function resolvedOutput(value: unknown): ResolvedSeries {
   const input = object(value, "resolve output");
   onlyKeys(input, "resolve output", [
     "id", "label", "color", "unit", "unitGroup", "nativeFrequency", "timestampMode", "dataShape", "style", "transform",
-    "axis", "panelId", "interpolation", "timeBasis", "latestChangePercent", "points", "warning", "hidden", "attribution",
+    "axis", "panelId", "interpolation", "timeBasis", "latestChangePercent", "points", "warning", "savedAt", "hidden", "attribution",
     "priceOf",
   ]);
   if (!Array.isArray(input.points)) fail("resolve output points", "expected an array.");
@@ -247,6 +247,7 @@ function resolvedOutput(value: unknown): ResolvedSeries {
       : {}),
     points: input.points.map(point),
     ...(warning !== undefined ? { warning } : {}),
+    ...(input.savedAt !== undefined ? { savedAt: finiteNumber(input.savedAt, "resolve output saved copy time") as number } : {}),
     ...(attribution ? { attribution: {
       source: boundedString(attribution.source, "resolve output source", 160),
       ...(publisher !== undefined ? { publisher } : {}),

package/src/cli/commands/market.ts

@@ -40,7 +40,7 @@ import {
   quoteChangeText,
 } from "../helpers";
 import { cliArrow, cliStyles, colorBySign, renderSection, renderStats } from "../../utils/cli-output";
-import { filledPeriodsNote, stalePeriodNote, statementHistoryNotes } from "../../utils/financial-statements";
+import { filledPeriodsNote, hasOlderStatements, stalePeriodNote, statementHistoryNotes } from "../../utils/financial-statements";
 import { formatPerShareNumber } from "../../utils/reported-money";
 import { isCurrencyPairListing } from "../../utils/fx-market-hours";
 import {
@@ -131,6 +131,7 @@ import {
   historyCoverageWarning,
   historyFacts,
   historyFlagNote,
+  historyWickNote,
   historyGapNote,
   historyJumpNote,
   historyUnbrokenFrom,
@@ -1464,7 +1465,7 @@ async function loadListingHistory(
     ...window ? [...windowHistoryNotes(window, data), coverage ?? []]
       : range === "YTD" ? ytdHistoryNotes(data) : [...historyNotes(range, interval, data[0]?.date, Date.now(), coverage != null), coverage ?? []],
     // The status line says how far a bar still forming runs; the note is for the bars it does not name.
-    gaps ?? [], historyJumpNote(data) ?? [], historyFlagNote(data) ?? [], historyMissingVolumeNote(data) ?? [],
+    gaps ?? [], historyJumpNote(data) ?? [], historyFlagNote(data) ?? [], historyWickNote(data) ?? [], historyMissingVolumeNote(data) ?? [],
     historyVenueVolumeNote(data) ?? [],
     historyBarStatusNote(forming ? served : data, { tradingDay: venueTradingDay(venue, Date.now()) }) ?? [],
   ].flat();
@@ -1881,7 +1882,11 @@ async function runFinancials(rawArgs: string[], ctx: Parameters<CliCommandDef["e
     // Years filled from the listing's exchange, for the revenue and net income columns.
     const filled = filledPeriodsNote(financials.annualStatements.filter((statement) => rows.some((row) => row.date === statement.date)),
       new Set(["totalRevenue", "netIncome"]));
-    const historyNotes = [...stale ? [stale] : [], ...filled ? [filled] : [], ...statementHistoryNotes("annual", rows.map((row) => row.date), listing.key)];
+    // GF is pointed to only when the listing's extended history goes further back than these years.
+    const dates = rows.map((row) => row.date);
+    const older = await hasOlderStatements(() => market.dataProvider.getTickerFinancials(listing.request.symbol, listing.request.exchange,
+      { statementHistory: "extended" }), "annual", dates);
+    const historyNotes = [...stale ? [stale] : [], ...filled ? [filled] : [], ...statementHistoryNotes("annual", dates, listing.key, older)];
     // NDJSON keeps the raw statement rows it always wrote; CSV gets the table and its closing lines.
     const tables = tabular
       ? selectTables({
@@ -3280,7 +3285,7 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
         title: "Bars",
         lines: [
           `Each range comes in one bar size: ${historyIntervalsByRange()}. The line under the heading, and the --json metadata, give the currency, the bar size actually served, the first and last bar and the bar count. A warning says when the bars are coarser, or start later, than the range asked for, and for a coin, which trades every day, names each day it has no bar for.`,
-          "A bar whose prices contradict each other (high below the open or close, or low above them) is left blank and flagged, such as high<open, with the count in a warning. --json rows carry currency, unit, interval and flag.",
+          "A bar whose prices contradict each other (high below the open or close, or low above them) is left blank and flagged, such as high<open, with the count in a warning. A low under half the open and close, or a high over twice them, is left blank alone and flagged low<close/2 or high>2*open. --json rows carry currency, unit, interval and flag.",
           "A break in the series flags the bar after it, which keeps its prices: gap after more than three months with no bar (weeks for weekly, daily and intraday bars), jump when the close is over 100 times the one before or under a hundredth of it. A warning names each break, and the heading says the date the series runs unbroken from.",
           "The heading's last line is the max drawdown of the bars shown: the largest fall from a close to a later close, with the peak and the trough, their dates, and the date a close got back to the peak, if one did (maxDrawdown in --json).",
         ],

package/src/cli/commands/overview.ts

@@ -1,6 +1,6 @@
 import { logFailure } from "../../utils/log-failure";
 import { apiClient } from "../../api-client";
-import { ApiRequestError, isPermanentClientError } from "../../api-client/errors";
+import { ApiRequestError } from "../../api-client/errors";
 import type { CliCommandDef } from "../../types/plugin";
 import { withCliServices, withConfigData, withMarketData } from "../context";
 import { CLI_ERROR_CODE, failWithFields } from "../errors";
@@ -646,16 +646,15 @@ function withSavedFredSeries<T>(ctx: Parameters<CliCommandDef["execute"]>[1], ru
 
 /**
  * A FRED series from Gloom Cloud, or the copy an earlier read saved when it
- * cannot be refreshed (marked as such). A refusal asking again will not change
- * (a series Gloom Cloud no longer serves, access denied) is said, not covered.
+ * cannot be refreshed (marked as such). A refusal (a series Gloom Cloud no
+ * longer serves, access denied) is said, not covered: `loadCachedFredSeries`
+ * throws it.
  */
 async function loadFredSeries(
   seriesId: string,
   params: { startDate?: string; limit?: number; sortOrder: "asc" | "desc" },
 ): Promise<CloudFredSeriesPayload> {
-  const result = await loadCachedFredSeries({ seriesId, ...params }, () => apiClient.getCloudFredSeries(seriesId, params));
-  if (result.source === "stale-fallback" && isPermanentClientError(result.error)) throw result.error;
-  return result.data;
+  return (await loadCachedFredSeries({ seriesId, ...params }, () => apiClient.getCloudFredSeries(seriesId, params))).data;
 }
 
 async function runFredList(filter: string, ctx: Parameters<CliCommandDef["execute"]>[1]) {

package/src/cli/commands/search.ts

@@ -16,6 +16,7 @@ import {
   candidateExchange,
   LISTING_SEARCH_LIMIT,
   listingDistance,
+  primaryCompanyLine,
   searchTickerCandidates,
   type TickerSearchCandidate,
 } from "../../tickers/search";
@@ -34,8 +35,7 @@ import { readBrokerIndexCode } from "../listing-arg";
 import { knownGapMessage, commandPointer } from "../known-gaps";
 import { instrumentTypeLabel } from "../../tickers/instrument-kind";
 import { canonicalExchange, isUsListingExchange } from "../../utils/exchanges";
-import { companyNameExtraWords, groupByCompany, sameCompany } from "../../tickers/company-name";
-import { namedByService } from "../../tickers/company-name-listing";
+import { companyLines, companyNameExtraWords, groupByCompany, namedByService, sameCompany } from "../../tickers/company-name";
 import { findCatalogSeries, renderSeriesMatches, type SeriesMatch } from "../series-search";
 import { centralBankAskedAbout, centralBankCiting, type CentralBank } from "../../utils/central-banks";
 import { createPaneCatalog } from "../pane-functions/discovery";
@@ -283,17 +283,17 @@ function withHomeListingPrimary(query: string, candidates: TickerSearchCandidate
     || primary.symbol.toUpperCase() === query.toUpperCase()) return candidates;
   const company = resolveSearchName(primary);
   const marked = !!primary.result && namedByService(query, primary.result);
-  const lines = candidates.filter((candidate) => candidate.kind === "search" && candidate.category !== "Funds & Derivatives"
-    && (candidate.instrumentClass === "equity" || candidate.instrumentClass === "other") && sameCompany(resolveSearchName(candidate), company)
-    && (!marked || companyNameExtraWords(resolveSearchName(candidate), company) != null));
-  const score = (candidate: TickerSearchCandidate) => candidate.result?.popularity ?? candidate.popularity ?? null;
-  const [home] = [...lines].sort((a, b) => listingDistance(a) - listingDistance(b) || (score(b) ?? -1) - (score(a) ?? -1) || candidates.indexOf(a) - candidates.indexOf(b));
-  if (!home || home === primary) return candidates;
-  const closer = listingDistance(home) < listingDistance(primary);
-  const [homeScore, primaryScore] = [score(home), score(primary)];
-  const moreSearched = !marked && listingDistance(home) === listingDistance(primary) && homeScore != null
-    && (primaryScore == null || homeScore >= primaryScore * 2);
-  if (!closer && !moreSearched) return candidates;
+  // Never a line of another business its name is in (`companyLines`): Siemens Energy AG is not Siemens AG's.
+  const lines = companyLines(primary, candidates.filter((candidate) => candidate === primary || (candidate.kind === "search"
+    && candidate.category !== "Funds & Derivatives" && (candidate.instrumentClass === "equity" || candidate.instrumentClass === "other"))),
+  (candidate) => ({
+    name: resolveSearchName(candidate), exchange: candidateExchange(candidate),
+    receipt: listingDistance(candidate) === 2, home: candidate.result?.homeListing === true,
+  })).filter((candidate) => candidate === primary || !marked || companyNameExtraWords(resolveSearchName(candidate), company) != null);
+  const home = primaryCompanyLine(primary, lines, (candidate) => ({
+    distance: listingDistance(candidate), score: candidate.result?.popularity ?? candidate.popularity ?? null,
+  }), { named: marked });
+  if (home === primary) return candidates;
   const rest = candidates.filter((candidate) => candidate !== home);
   const at = rest.indexOf(primary);
   return [...rest.slice(0, at), { ...home, category: "Primary Listing" as const }, { ...primary, category: "Other Listings" as const }, ...rest.slice(at + 1)];

package/src/cli/context.ts

@@ -141,6 +141,7 @@ export async function initCliServices(options: CliServicesOptions = {}) {
     config,
     plugins: getLoadablePlugins(options.externalPlugins ?? []),
     externalPlugins: options.externalPlugins ?? [],
+    interactive: false,
   });
   services.providerRouter.setConfigAccessor(() => config);
   services.providerRouter.setBackgroundRevalidation(false);

package/src/cli/glossary.ts

@@ -404,7 +404,8 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
   },
   {
     term: "Net debt", aliases: ["net debt/ebitda", "net debt to ebitda", "net leverage"], functions: ["FA"], shown: ["Net Debt"],
-    definition: "Total debt less cash and short-term investments. Negative means more cash than debt. "
+    definition: "Total debt less cash and short-term investments, with the balance sheet's lease liabilities under IFRS (\"incl. leases\"); "
+      + "a company reporting under US GAAP (a 10-K, or a 20-F such as Alibaba's) keeps its operating leases out (\"excl. op. leases\"). Negative means more cash than debt. "
       + "Net debt / EBITDA is how many years of EBITDA would repay it; FA divides by a year of EBITDA, the trailing four quarters in a quarterly column.",
   },
   {

package/src/cli/history-rows.ts

@@ -14,7 +14,9 @@ import { isRoundTheClockCoin } from "../utils/crypto-pair";
 import { currencyPairCode } from "../utils/currency-pair";
 import { currencyUnitLabel, resolveCurrencyUnit } from "../utils/currency-units";
 import { getPricePointTimestamp } from "../utils/price-history";
-import { latestTradeIndex, missingVolumeNotice, pricePointIntegrityFlags, pricePointValues } from "../utils/price-history-integrity";
+import {
+  isWickFlag, latestTradeIndex, missingVolumeNotice, pricePointIntegrityFlags, pricePointValues, pricePointWickFlags,
+} from "../utils/price-history-integrity";
 import { formatUtcTime } from "../utils/utc-time";
 import { historyCoverageNotice } from "../sources/history-coverage";
 import { barLastSession, barPeriodToDate, type BarPeriodToDate } from "../market-data/market/bar-period";
@@ -253,10 +255,17 @@ function flagCodes(row: Pick<HistoryRow, "flag">): string[] {
   return row.flag ? row.flag.split(",") : [];
 }
 
+/** The codes of a bar left blank for prices that contradict each other: not a break before it, nor a withheld wick. */
+function blankingCodes(row: Pick<HistoryRow, "flag">): string[] {
+  return flagCodes(row).filter((code) => !BREAK_FLAGS.has(code) && !isWickFlag(code));
+}
+
 /**
  * Intraday bars keep their UTC time; daily and longer bars are trading dates.
  * A bar whose prices contradict each other is blanked exactly as HP blanks it,
- * and says why in `flag`. A bar after a gap or a jump in the series keeps its
+ * and says why in `flag`. A low or high too far from the open and close to
+ * have traded is left blank, the rest of the bar kept, flagged `low<close/2`
+ * or `high>2*open`. A bar after a gap or a jump in the series keeps its
  * prices and is flagged `gap` or `jump`.
  */
 export function historyRows(
@@ -277,7 +286,7 @@ export function historyRows(
     const time = times[index]!;
     const iso = Number.isFinite(time) ? new Date(time).toISOString() : "";
     const values = pricePointValues(point);
-    const flags = pricePointIntegrityFlags(point);
+    const flags = [...pricePointIntegrityFlags(point), ...pricePointWickFlags(point)];
     const price = (value: number | null) => value == null ? null : cleanBarPrice(value, priceDivisor);
     return {
       date: intraday ? iso.replace(".000Z", "Z") : iso.slice(0, 10),
@@ -448,7 +457,7 @@ export function historyMissingVolumeNote(
   if (!historyReportsVolume(rows)) return null;
   const latestTrade = latestTradeIndex(rows.map((row) => Date.parse(row.date)));
   const missing = rows.filter((row, index) => row.volume == null && row.venueVolume == null && !row.partial && !row.filled
-    && !flagCodes(row).some((code) => !BREAK_FLAGS.has(code)) && index !== latestTrade).length;
+    && blankingCodes(row).length === 0 && index !== latestTrade).length;
   return missingVolumeNotice(missing, rows.length) ?? null;
 }
 
@@ -833,10 +842,9 @@ export function historyGapNote(
  * keep their prices and are not counted.
  */
 export function historyFlagNote(rows: readonly Pick<HistoryRow, "flag">[]): string | null {
-  const contradictions = (row: Pick<HistoryRow, "flag">) => flagCodes(row).filter((code) => !BREAK_FLAGS.has(code));
-  const flagged = rows.filter((row) => contradictions(row).length > 0);
+  const flagged = rows.filter((row) => blankingCodes(row).length > 0);
   if (flagged.length === 0) return null;
-  const codes = new Set(flagged.flatMap(contradictions));
+  const codes = new Set(flagged.flatMap(blankingCodes));
   const kinds = [
     codes.has("high<open") || codes.has("high<close") ? "high below open or close" : "",
     codes.has("low>open") || codes.has("low>close") ? "low above open or close" : "",
@@ -845,3 +853,23 @@ export function historyFlagNote(rows: readonly Pick<HistoryRow, "flag">[]): stri
   const count = `${flagged.length} of ${rows.length} ${flagged.length === 1 && rows.length === 1 ? "bar" : "bars"}`;
   return `${count} ${flagged.length === 1 ? "has" : "have"} ${kinds.join(", or ")} in the source data; their prices are left blank`;
 }
+
+/**
+ * "The low of 2021-11-29 is under half its open and close, too far to have
+ * traded; left blank and out of ranges", or null when no bar has such a wick
+ * (pricePointWickFlags). Three or more bars are counted.
+ */
+export function historyWickNote(rows: readonly Pick<HistoryRow, "date" | "flag">[]): string | null {
+  const flagged = rows.filter((row) => flagCodes(row).some(isWickFlag));
+  if (flagged.length === 0) return null;
+  const sides = new Set(flagged.flatMap((row) => flagCodes(row).filter(isWickFlag).map((code) => code.slice(0, code.indexOf(code.startsWith("low") ? "<" : ">")))));
+  const reason = "too far to have traded; left blank and out of ranges";
+  const only = flagged[0]!;
+  if (flagged.length === 1 && sides.size === 1) {
+    return sides.has("low") ? `The low of ${only.date} is under half its open and close, ${reason}`
+      : `The high of ${only.date} is over twice its open and close, ${reason}`;
+  }
+  const kinds = [sides.has("low") ? "a low under half" : "", sides.has("high") ? "a high over twice" : ""].filter(Boolean).join(" or ");
+  const dates = flagged.length <= LISTED_GAPS ? ` (${listItems(flagged.map((row) => row.date))})` : "";
+  return `${flagged.length} of ${rows.length} bars have ${kinds} their open and close${dates}, ${reason}`;
+}

package/src/cli/known-gaps.ts

@@ -222,6 +222,17 @@ const TOPIC_POINTERS: ReadonlyArray<{
     closestLabel: "COMEX curves",
     closest: [["CTM", "gloom fn CTM HG for copper, gloom fn CTM ALI for aluminium"]],
   },
+  {
+    // No source serves a jet fuel (kerosene) price. Heating oil, NY Harbor ULSD, is what airlines hedge it with and
+    // analysts read it by; the EIA's weekly US stocks are a catalog series (checked 2026-10-29: quote HO=F,
+    // fn COT HO and fn G CAP:doe:jet all answer).
+    topic: "Jet fuel (kerosene)",
+    availability: "no price series; heating oil (NY Harbor ULSD) is the usual proxy, its price: gloom quote HO=F. "
+      + "US jet fuel stocks (EIA, weekly): gloom fn G CAP:doe:jet",
+    phrases: ["jet fuel", "jet fuels", "kerosene", "kerosine", "jet kerosene", "aviation fuel", "aviation fuels", "avtur"],
+    closestLabel: "positioning",
+    closest: [["COT", "heating oil, the usual jet fuel proxy: gloom fn COT HO"]],
+  },
   {
     // "exchange reserves" alone reads as crypto's; "foreign exchange reserves" is a central bank's, so only whole.
     topic: "Crypto exchange reserves and exchange flows",

package/src/cli/listing-arg.ts

@@ -15,7 +15,7 @@ import {
   type ListingVenue,
 } from "../tickers/listing-venues";
 import { findUsListingOfCompany, type UsListing } from "../tickers/us-listing";
-import { findListingOfCompanyName, isCompanyNameInput, readTerminalCodeArg, type CompanyNameListing } from "../tickers/company-name-listing";
+import { findListingOfCompanyName, isCompanyNameInput, marksAnotherListing, readTerminalCodeArg, type CompanyNameListing } from "../tickers/company-name-listing";
 import { movedAwayChange, startTickerChangeLookup, type MovedTickerChange } from "../tickers/ticker-changes";
 import { lineMayHaveMoved, loadListingFate, MovedSymbolError, type ListingFate } from "../tickers/listing-fate";
 import { quotedListingName } from "../tickers/listing-name";
@@ -1338,6 +1338,22 @@ export async function oneWordCompanyName(typed: string, deps: Pick<ListingDeps,
   return found ? companyListingArg(typed, found) : null;
 }
 
+/**
+ * A word the service marks as a company's name (`searchAliases`), read as
+ * that company's listing as `oneWordCompanyName` reads a word, for a bare
+ * symbol no source quotes, before it is read on the symbol's listings abroad:
+ * "siemens" is SIE on XETRA (Siemens AG), not SIEMENS on NSE (Siemens Ltd.).
+ * Null when the service marks no listing with the word, or marks the word's
+ * own symbol, and when search names no company or is too busy to say.
+ */
+export async function serviceNamedCompany(typed: string, deps: Pick<ListingDeps, "dataProvider">): Promise<ListingArg | null> {
+  // Most symbols are no company's name: one search says so before any listing is weighed or quoted.
+  if (!ONE_WORD_NAME.test(typed.trim()) || !await marksAnotherListing(deps.dataProvider, typed)) return null;
+  const found = await findOneWordCompany(typed, deps);
+  if (!found?.named || found.symbol.toUpperCase() === typed.trim().toUpperCase()) return null;
+  return companyListingArg(typed, found);
+}
+
 /** The company `oneWordCompanyName` reads a word as, before it is read as a listing. */
 async function findOneWordCompany(typed: string, deps: Pick<ListingDeps, "dataProvider">): Promise<CompanyNameListing | null> {
   const word = typed.trim();

package/src/cli/quote-answer.ts

@@ -21,6 +21,8 @@ import {
   notTradedMessage,
   oneWordCompanyName,
   quoteBareListing,
+  serviceNamedCompany,
+  type ListingArg,
   requireCliListing,
   resolveCliListing,
   tradingBoardNote,
@@ -64,7 +66,9 @@ export interface QuoteAnswer {
 /**
  * One symbol's row of `quote` and `compare`. A listing on an exchange its symbol
  * is not listed on says so. A bare symbol the data service read on its home
- * listing abroad names that venue (SXR8 -> XETRA). One no source quotes is
+ * listing abroad names that venue (SXR8 -> XETRA). One no source quotes that
+ * the service marks as another listing's company name is that company
+ * (`serviceNamedCompany`: "siemens" is SIE:XETRA); else it is
  * quoted on its listings (`quoteBareListing`), else names them, or asks for an
  * exchange when several companies list it (2222); a bare index root (VIX) also
  * names its index (^VIX), and a futures board code a security keeps (GC) its
@@ -98,6 +102,10 @@ export async function answerQuote(
   const notTraded = await notTradedMessage(listing, market);
   if (notTraded) return { result, listing, failure: { message: notTraded, oneLine: notTraded }, notes: [] };
   if (!isNoProviderError(result.error)) return { result, listing, notes: [] };
+  // A word the service marks as a company's name is that company, before the symbol is read on its listings abroad.
+  const named = !listing.exchange && listing.typed ? await serviceNamedCompany(listing.typed, market) : null;
+  const meant = named ? await answerNamedListing(named, market, request, refresh, datesChangeBasis) : null;
+  if (meant) return meant;
   const other = await quoteBareListing(listing, market, request, { refresh, datesChangeBasis });
   if (other?.kind === "quoted") {
     return {
@@ -155,17 +163,32 @@ async function answerCompanyName(
   const named = await oneWordCompanyName(listing.typed, market);
   // A real ticker a source failed to quote is not a company's name, even when the company carries the word.
   if (!named || (unsettled && named.symbol.toUpperCase() === listing.symbol.toUpperCase())) return null;
-  // A listing on a venue the app cannot read is no answer: the word keeps its own "Not a ticker".
+  const answer = await answerNamedListing(named, market, request, refresh, datesChangeBasis);
+  if (answer) return answer;
+  if (!unsettled) return null;
+  const sentence = await notATickerWords(listing.typed, market);
+  return { result: { ...result, error: new Error(sentence) }, listing, notes: [] };
+}
+
+/**
+ * The row of the listing a company's name was read as (`named`), saying so;
+ * null when the app cannot read its venue or it has no quote.
+ */
+async function answerNamedListing(
+  named: ListingArg,
+  market: MarketContext,
+  request: ListingDataRequest,
+  refresh: boolean,
+  datesChangeBasis: boolean,
+): Promise<QuoteAnswer | null> {
+  // A listing on a venue the app cannot read is no answer: the word keeps its own.
   const resolved = await resolveCliListing(named.key, null, market).catch((error: unknown) => {
     if (error instanceof ListingArgError) return null;
     throw error;
   });
   const found = resolved ? { ...resolved, readAs: named.readAs, ...named.meant ? { meant: named.meant } : {}, ...named.readFromName ? { readFromName: named.readFromName } : {} } : null;
   const [quoted] = found ? await market.dataProvider.getQuotesBatch([found.request], { forceRefresh: refresh, revalidate: true, datesChangeBasis }) : [];
-  if (found && quoted?.quote) return answerQuote(quoted, found, market, request, refresh, null, { datesChangeBasis });
-  if (!unsettled) return null;
-  const sentence = await notATickerWords(listing.typed, market);
-  return { result: { ...result, error: new Error(sentence) }, listing, notes: [] };
+  return found && quoted?.quote ? answerQuote(quoted, found, market, request, refresh, null, { datesChangeBasis }) : null;
 }
 
 /** A listing a command found a quote for, with what `quote` says beside it. */

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

@@ -154,6 +154,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"
@@ -326,6 +333,7 @@ export function useCommandBarRootRuntime({
     previousRootSelectionContextRef.current = { query: rootQuery, mode: rootModeKind };
     if (selectionContextChanged) {
       rootSelectionNavigatedRef.current = false;
+      pinnedRootRowRef.current = null;
     }
 
     setRootSelectedIdx((current) => {
@@ -338,15 +346,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);
+      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,
@@ -360,7 +376,13 @@ export function useCommandBarRootRuntime({
 
   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]);

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

@@ -2,8 +2,8 @@ import { useCallback, useEffect, useRef, type MutableRefObject } from "react";
 import type { AppState } from "../../state/app/context";
 import type { TickerRecord } from "../../types/ticker";
 import { t } from "../../i18n";
-import { findExactTickerSearchMatch, listingChoiceQuery } from "../../tickers/search";
-import { isKnownExchangeCode, parsePublicTickerKey } from "../../utils/exchanges";
+import { listingChoiceQuery } from "../../tickers/search";
+import { isKnownExchangeCode } from "../../utils/exchanges";
 import type { PluginRegistry } from "../../plugins/registry";
 import type { Command } from "./commands/registry";
 import type {
@@ -294,37 +294,21 @@ export function useCommandBarSelectionRuntime({
   const activateListSelection = useCallback((options?: { secondary?: boolean; item?: ResultItem }) => {
     const listState = visibleListStateRef.current;
     if (!listState) return;
-    // Enter submits the typed command until a row is deliberately chosen.
-    // Search ranks suggestions by relevance; its first namesake must not
-    // replace the listing the shared ticker resolver would open.
+    // Enter opens exactly the highlighted row. The typed command runs as typed
+    // only while no listing for it is highlighted: before its search answers
+    // (`DES HFC` then opens the listing `quote HFC` reads), or while the rows
+    // on screen are an earlier query's.
     const queryChanged = rootQueryRef.current !== rootQuery;
     const tickerArgument = rootShortcutIntent.kind !== "none" && rootShortcutIntent.argKind === "ticker"
       ? rootShortcutIntent.argText : null;
     const listingQuery = listingChoiceQuery(tickerArgument ?? rootQueryRef.current);
     const choosingVenue = listingQuery && !isKnownExchangeCode(listingQuery.suffix);
-    const submitTyped = !options?.item && !currentRoute
+    const highlighted = listState.results[listState.selectedIdx];
+    const listingHighlighted = !queryChanged && (highlighted?.kind === "ticker" || highlighted?.kind === "search");
+    const submitTyped = !options?.item && !currentRoute && !listingHighlighted
       && (queryChanged || (!rootSelectionNavigatedRef.current && !choosingVenue));
-    let typed = submitTyped && (queryChanged || tickerArgument !== null)
+    const typed = submitTyped && (queryChanged || tickerArgument !== null)
       ? resolveImmediateRootSelection(rootQueryRef.current) : null;
-    const first = listState.results[listState.selectedIdx];
-    if (typed && !queryChanged && rootShortcutIntent.kind !== "none" && rootShortcutIntent.argKind === "ticker"
-      && first && (first.kind === "ticker" || first.kind === "search")) {
-      const argument = rootShortcutIntent.argText;
-      // Company names and partial symbols still accept the suggested match.
-      // An exact symbol or named venue goes through listing resolution.
-      if (!parsePublicTickerKey(argument).exchange && !findExactTickerSearchMatch(
-        listState.results.filter((item) => item.kind === "ticker" || item.kind === "search"), argument,
-      )) typed = null;
-    }
-    // A plain symbol follows the same path once it is the default ticker row.
-    // Commands and company-name searches keep their own default actions.
-    const plainSymbol = submitTyped && !typed && first && (first.kind === "ticker" || first.kind === "search")
-      && findExactTickerSearchMatch([first], rootQueryRef.current);
-    if (plainSymbol && first) {
-      const symbol = rootQueryRef.current;
-      typed = { ...first, action: () => runSecurityDescriptionShortcut(symbol),
-        secondaryAction: () => runSecurityDescriptionShortcut(symbol, { forceNewPane: true }) };
-    }
     const selected = options?.item ?? typed ?? listState.results[listState.selectedIdx];
     if (!selected) {
       if (searchPending && !currentRoute && !options?.item && !rootSelectionNavigatedRef.current) {
@@ -399,8 +383,8 @@ export function useCommandBarSelectionRuntime({
       item: selected,
       query,
       rank: selected === typed ? 0 : Math.max(0, listState.results.indexOf(selected)),
-      // A plain symbol stays a ticker choice; a submitted command is the shortcut itself.
-      isShortcut: () => !plainSymbol && (selected === typed || resolveImmediateRootSelection(query)?.id === selected.id),
+      // A listing row stays a ticker choice; a submitted command is the shortcut itself.
+      isShortcut: () => !listingHighlighted && (selected === typed || resolveImmediateRootSelection(query)?.id === selected.id),
     }, run);
   }, [
     closeAll,
@@ -416,7 +400,6 @@ export function useCommandBarSelectionRuntime({
     rootSelectionNavigatedRef,
     rootShortcutIntent,
     runRootRow,
-    runSecurityDescriptionShortcut,
     searchPending,
     stateConfigLayout,
     stateRef,

package/src/components/layout/detached-pane-shell.tsx

@@ -170,9 +170,9 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
     fireAndForget(desktopWindowBridge.closeDetachedPane?.(desktopWindowBridge.paneId), "desktop.closeDetachedPane");
   }, [desktopWindowBridge, locked, pluginRegistry]);
 
-  const startWindowDrag = useCallback(() => {
+  const startWindowDrag = useCallback((press?: { detail?: number }) => {
     focusPane();
-    if (nativeWindowChrome) void rendererHost.startWindowDrag?.();
+    if (nativeWindowChrome) void rendererHost.startWindowDrag?.(press);
   }, [focusPane, nativeWindowChrome, rendererHost]);
 
   const sharePane = useCallback(() => {

package/src/components/layout/header.tsx

@@ -870,9 +870,9 @@ export function Header({
   // bar itself wears the prompt's fill and reads as a single strip.
   const headerBg = nativePaneChrome ? colors.header : headerSurface(colors);
 
-  const startWindowDrag = useCallback(() => {
+  const startWindowDrag = useCallback((press?: { detail?: number }) => {
     if (!titleBarOverlay || !nativeWindowChrome) return;
-    void rendererHost.startWindowDrag?.();
+    void rendererHost.startWindowDrag?.(press);
   }, [nativeWindowChrome, rendererHost, titleBarOverlay]);
 
   const openCommandBar = useCallback((event?: HeaderActionEvent) => {