@gloom-sh/terminal 0.18.5 → 0.19.0

package/src/api-client/types.ts

@@ -518,10 +518,16 @@ export interface CloudEconEventPayload {
   source?: { name: string; url?: string };
   /**
    * The indicator this release is of, the same from one release to the next
-   * (US CPI m/m on every month's row), where `id` names the one row. Absent
-   * until Gloom Cloud names indicators; exports leave the column empty.
+   * (`us-unemployment-rate` on every month's row), where `id` names the one
+   * row. Absent from a server that names none; exports leave the column empty.
    */
   indicatorId?: string | null;
+  /**
+   * Where the forecast (the consensus) was read from, `week-feed` or
+   * `release-calendar`, and when that feed was read. Absent on a row with no
+   * forecast and on one kept before the read was recorded.
+   */
+  consensus?: { source: string; readAt: string } | null;
 }
 
 /** One currency's short-term rate, as GET /cloud/econ/short-rates serves it. */
@@ -891,6 +897,13 @@ export interface CloudEarningsCallPayload {
    * New York day). Absent from a server that predates it.
    */
   callTimeKnown?: boolean;
+  /**
+   * "other" for an event that is not an earnings call (a deal call, a
+   * conference, an investor day), named by eventLabel and with no fiscal
+   * period; null when unclear. Older servers omit both.
+   */
+  eventKind?: "earnings" | "other" | null;
+  eventLabel?: string | null;
 }
 
 interface CloudJobsSeriesPoint {
@@ -1255,6 +1268,13 @@ export interface CloudEarningsTranscriptPayload {
   companyName: string | null;
   fiscalYear: number | null;
   fiscalQuarter: number | null;
+  /**
+   * "other" for an event that is not an earnings call (a deal call, a
+   * conference, an investor day), named by eventLabel and with no fiscal
+   * period; null when unclear. Older servers omit both.
+   */
+  eventKind?: "earnings" | "other" | null;
+  eventLabel?: string | null;
   callAt: string | null;
   timing: string | null;
   webcastUrl: string | null;
@@ -1536,6 +1556,8 @@ export interface CloudNewsPayload {
 export interface CloudNewsListResponse {
   items: CloudNewsPayload[];
   nextCursor: string | null;
+  /** Which news the service answered with, when it says: the live wire, or the one held back for a free account. */
+  access?: "realtime" | "delayed";
 }
 
 interface CloudTweetUserPayload {
@@ -1739,6 +1761,14 @@ export interface CloudMarketScreenerItem extends CloudMoverSessionFields {
   exchange: string;
   lastUpdated: number;
   dataSource: "live";
+  /** The listing's float as the equity screener serves it; absent where it serves none. */
+  floatShares?: number;
+  /** Set with a float the source states no measurement date for: `partial`. */
+  floatSharesState?: "partial";
+  /** Why the float is partial, as the server says it. */
+  floatSharesReason?: string;
+  /** When the statistics the float is read from were retrieved (ISO). */
+  floatSharesRetrievedAt?: string;
 }
 
 export interface CloudMarketScreenerPayload {
@@ -1933,6 +1963,44 @@ export interface ScannerFlowHistoryPage {
   hasMore: boolean;
 }
 
+/**
+ * Premium of a slice of the session's recorded prints by where it traded: at
+ * or above the ask (bought) or at or below the bid (sold). Mid and unknown
+ * prints count as neither.
+ */
+interface ScannerFlowSidePremium {
+  callAsk: number;
+  callBid: number;
+  putAsk: number;
+  putBid: number;
+}
+
+/** The session's prints in one time bucket, which starts at `at`. */
+export interface ScannerFlowSessionBucket extends ScannerFlowSidePremium {
+  at: number;
+}
+
+/** What one name printed at one expiry and strike during the session. */
+export interface ScannerFlowSessionStrike extends ScannerFlowSidePremium {
+  expiry: string;
+  strike: number;
+  /** Every call print's premium, mid and unknown included. */
+  callPremium: number;
+  putPremium: number;
+  prints: number;
+}
+
+/** The latest session's recorded prints under the FLOW pane's filters, summed. */
+export interface ScannerFlowSession {
+  /** The New York date of the session; null before any print was recorded. */
+  session: string | null;
+  bucketMs: number;
+  /** Buckets with a matching print, oldest first. */
+  buckets: ScannerFlowSessionBucket[];
+  /** Only when one name was asked for: most premium first. */
+  strikes: ScannerFlowSessionStrike[] | null;
+}
+
 export type ScannerPayload = ScannerHiloPayload | ScannerFlowPayload;
 
 /** What a scanner subscriber receives: data, or the entitlement refusal. */

package/src/app/pane-runtime/plugin-bindings.ts

@@ -513,13 +513,17 @@ export function bindAppPanePluginRegistry({
       removeExternalPlugin(pluginId, directory);
     },
     contributions: (pluginId) => {
+      // An unlisted function (`listed: false`) and a pane only it opens are left out, as of every list.
+      const registered = pluginRegistry.getPluginPaneTemplateIds(pluginId)
+        .map((id) => ({ id, template: pluginRegistry.paneTemplates.get(id) }));
+      const listedPaneIds = new Set(registered.flatMap(({ template }) => template && template.listed !== false ? [template.paneId] : []));
+      const unlistedPaneIds = new Set(registered.flatMap(({ template }) => template?.listed === false && !listedPaneIds.has(template.paneId) ? [template.paneId] : []));
       const panes = pluginRegistry.getPluginPaneIds(pluginId)
+        .filter((id) => !unlistedPaneIds.has(id))
         .map((id) => ({ id, name: pluginRegistry.panes.get(id)?.name ?? id }));
-      const templates = pluginRegistry.getPluginPaneTemplateIds(pluginId)
-        .map((id) => {
-          const template = pluginRegistry.paneTemplates.get(id);
-          return { id, label: template?.label ?? id, ...(template?.shortcut?.prefix ? { prefix: template.shortcut.prefix } : {}) };
-        });
+      const templates = registered
+        .filter(({ template }) => template?.listed !== false)
+        .map(({ id, template }) => ({ id, label: template?.label ?? id, ...(template?.shortcut?.prefix ? { prefix: template.shortcut.prefix } : {}) }));
       const commands = [...pluginRegistry.commands.entries()]
         .filter(([id]) => pluginRegistry.getCommandPluginId(id) === pluginId && !id.endsWith(":setup"))
         .map(([id, command]) => ({ id, label: command.label, ...(command.shortcut ? { shortcut: command.shortcut } : {}) }));

package/src/app/runtime/broker-import.ts

@@ -28,7 +28,6 @@ export interface AppBrokerImportRuntime {
 interface BrokerImportOptions {
   refreshImportedTickers?: boolean;
   config?: AppConfig;
-  persistResolvedBrokerConfig?: boolean;
   signal?: AbortSignal;
   onCommitStart?: () => void;
   onCommitEnd?: () => void;
@@ -122,7 +121,6 @@ export function useBrokerImportRuntime({
         tickerRepository,
         existingTickers: tickerMap ?? new Map(stateRef.current.tickers),
         resources: pluginRegistry.persistence.resources,
-        persistResolvedBrokerConfig: options?.persistResolvedBrokerConfig,
         signal: options?.signal,
         deferPersistence: true,
       });

package/src/app/runtime/plugin-bindings.ts

@@ -10,6 +10,8 @@ import type { MarketDataCoordinator } from "../../market-data/coordinator";
 import { instrumentFromTicker } from "../../market-data/request-types";
 import type { PluginRegistry } from "../../plugins/registry";
 import { saveConfigImmediately } from "../../state/config-save-scheduler";
+import { persistTickerCleanup } from "../../state/ticker-cleanup";
+import { hasPendingTickerWrites } from "../../data/ticker-writes";
 import { settleWithin } from "../../utils/async-deadline";
 import type { AppAction, AppState } from "../../state/app/context";
 import type { AppConfig, BrokerInstanceConfig } from "../../types/config";
@@ -215,66 +217,81 @@ export function bindPluginRegistryRuntimeAccess({
         else removedPortfolioIds.add(portfolio.id);
       }
 
-      const nextPortfolios = stateRef.current.config.portfolios.flatMap((portfolio) => {
-        if (removedPortfolioIds.has(portfolio.id)) return [];
-        const heirId = heirs.get(portfolio.id);
-        return [heirId ? { ...portfolio, brokerInstanceId: heirId } : portfolio];
+      const removeProfile = (config: AppConfig): AppConfig => ({
+        ...config,
+        brokerInstances: config.brokerInstances.filter((entry) => entry.id !== instanceId),
+        portfolios: config.portfolios.flatMap((portfolio) => {
+          if (removedPortfolioIds.has(portfolio.id)) return [];
+          const heirId = heirs.get(portfolio.id);
+          return [heirId ? { ...portfolio, brokerInstanceId: heirId } : portfolio];
+        }),
       });
-      const nextTickers = new Map(stateRef.current.tickers);
-      const nextBrokerInstances = stateRef.current.config.brokerInstances.filter((entry) => entry.id !== instanceId);
-      // What older removals and pulls from other devices left behind goes as well.
-      const known = knownBrokerHoldings({ portfolios: nextPortfolios, brokerInstances: nextBrokerInstances });
 
-      for (const ticker of stateRef.current.tickers.values()) {
-        // A position here without a profile came from another device's sync of this one.
-        const nextPositions = ticker.metadata.positions.filter((position) => position.brokerInstanceId !== instanceId
-          && !(removedPortfolioIds.has(position.portfolio) && !position.brokerInstanceId));
-        const heldPortfolioIds = new Set(nextPositions.map((position) => position.portfolio));
-        const nextPortfolioRefs = ticker.metadata.portfolios.filter((portfolioId) =>
-          !removedPortfolioIds.has(portfolioId) && (!heirs.has(portfolioId) || heldPortfolioIds.has(portfolioId)));
-        const nextBrokerContracts = (ticker.metadata.broker_contracts ?? []).filter((contract) => contract.brokerInstanceId !== instanceId);
-
-        const removedTicker: TickerRecord = {
-          ...ticker,
-          metadata: {
-            ...ticker.metadata,
-            positions: nextPositions,
-            portfolios: nextPortfolioRefs,
-            broker_contracts: nextBrokerContracts,
-          },
-        };
-        const nextTicker = clearLeftoverBrokerHoldings(removedTicker, known) ?? removedTicker;
-
-        const shouldDeleteTicker =
-          nextTicker.metadata.positions.length === 0
-          && nextTicker.metadata.portfolios.length === 0
-          && nextTicker.metadata.watchlists.length === 0
-          && (nextTicker.metadata.broker_contracts ?? []).length === 0
-          && nextTicker.metadata.tags.length === 0
-          && Object.keys(nextTicker.metadata.custom).length === 0;
+      const cleanTickers = () => persistTickerCleanup({
+        tickerRepository,
+        getTickers: () => stateRef.current.tickers,
+        transform: (ticker) => {
+          // A position without a profile came from another device's sync of this one.
+          const nextPositions = ticker.metadata.positions.filter((position) => position.brokerInstanceId !== instanceId
+            && !(removedPortfolioIds.has(position.portfolio) && !position.brokerInstanceId));
+          const heldPortfolioIds = new Set(nextPositions.map((position) => position.portfolio));
+          const nextPortfolioRefs = ticker.metadata.portfolios.filter((portfolioId) =>
+            !removedPortfolioIds.has(portfolioId) && (!heirs.has(portfolioId) || heldPortfolioIds.has(portfolioId)));
+          const nextBrokerContracts = (ticker.metadata.broker_contracts ?? []).filter((contract) => contract.brokerInstanceId !== instanceId);
+          const changed = nextPositions.length !== ticker.metadata.positions.length
+            || nextPortfolioRefs.length !== ticker.metadata.portfolios.length
+            || nextBrokerContracts.length !== (ticker.metadata.broker_contracts ?? []).length;
+          const removedTicker: TickerRecord = changed ? {
+            ...ticker,
+            metadata: {
+              ...ticker.metadata,
+              positions: nextPositions,
+              portfolios: nextPortfolioRefs,
+              broker_contracts: nextBrokerContracts,
+            },
+          } : ticker;
+          // Also clear holdings left behind by older removals or pulls.
+          const known = knownBrokerHoldings(removeProfile(stateRef.current.config));
+          const nextTicker = clearLeftoverBrokerHoldings(removedTicker, known) ?? removedTicker;
+          if (nextTicker === ticker) return ticker;
+          const empty = nextTicker.metadata.positions.length === 0
+            && nextTicker.metadata.portfolios.length === 0
+            && nextTicker.metadata.watchlists.length === 0
+            && (nextTicker.metadata.broker_contracts ?? []).length === 0
+            && nextTicker.metadata.tags.length === 0
+            && Object.keys(nextTicker.metadata.custom).length === 0;
+          return empty ? null : nextTicker;
+        },
+        publish: (symbol, ticker) => {
+          if (ticker) dispatch({ type: "UPDATE_TICKER", ticker });
+          else {
+            dispatch({ type: "REMOVE_TICKER", symbol });
+            pluginRegistry.events.emit("ticker:removed", { symbol });
+          }
+        },
+      });
 
-        if (shouldDeleteTicker) {
-          nextTickers.delete(ticker.metadata.ticker);
-          await tickerRepository.deleteTicker(ticker.metadata.ticker);
-          dispatch({ type: "REMOVE_TICKER", symbol: ticker.metadata.ticker });
-          pluginRegistry.events.emit("ticker:removed", { symbol: ticker.metadata.ticker });
-        } else {
-          await tickerRepository.saveTicker(nextTicker);
-          nextTickers.set(nextTicker.metadata.ticker, nextTicker);
-          dispatch({ type: "UPDATE_TICKER", ticker: nextTicker });
-        }
+      // Keep the profile available for retry until cleanup and config both
+      // succeed. Rebase after callbacks and edits, including during config saves.
+      let savedRemoval = false;
+      for (;;) {
+        const cleaned = await cleanTickers().catch(async (error: unknown) => {
+          // A config acknowledgement can precede a late row write. If that
+          // cleanup fails, keep its removal intent durable for a restart too.
+          if (savedRemoval) await saveConfigImmediately(stateRef.current.config);
+          throw error;
+        });
+        if (hasPendingTickerWrites(tickerRepository) || stateRef.current.tickers !== cleaned) continue;
+        const source = stateRef.current.config;
+        const nextConfig = removeProfile(source);
+        await saveConfigImmediately(nextConfig);
+        savedRemoval = true;
+        if (stateRef.current.config !== source || stateRef.current.tickers !== cleaned
+          || hasPendingTickerWrites(tickerRepository)) continue;
+        dispatch({ type: "SET_CONFIG", config: nextConfig });
+        pluginRegistry.events.emit("config:changed", { config: nextConfig });
+        break;
       }
-
-      const nextConfig = {
-        ...stateRef.current.config,
-        brokerInstances: nextBrokerInstances,
-        portfolios: nextPortfolios,
-      };
-
-      dispatch({ type: "SET_CONFIG", config: nextConfig });
-      dispatch({ type: "SET_TICKERS", tickers: nextTickers });
-      await saveConfigImmediately(nextConfig);
-      pluginRegistry.events.emit("config:changed", { config: nextConfig });
       // The profile that kept a portfolio fills in what the removed one held there.
       for (const heirId of new Set(heirs.values())) {
         void importBrokerPositions(heirId).catch(logFailure("app.runtime.plugin-bindings", "Replacement broker positions import failed"));

package/src/architecture/pane-tabs-allowlist.json

@@ -53,6 +53,9 @@
   "src/plugins/builtin/research-search/pane.tsx": {
     "signInRequired || verificationRequired": "Signed out or unverified, every mode is the same sign-in wall."
   },
+  "src/plugins/builtin/scanner/flow-pane.tsx": {
+    "!feed.denied": "Signed out or without Pro, every tab is the same sign-in or plan wall."
+  },
   "src/plugins/builtin/shared/filing-year-reader.tsx": {
     "years.length > 1": "The tabs are the filings on record, known once their list answers; a single filing has no other year to pick."
   },

package/src/architecture/ttl-caches-allowlist.json

@@ -0,0 +1,19 @@
+{
+  "src/plugins/builtin/alerts/metric-model.ts": {
+    "deadline: now < cached.retryAt": "A byte-identical copy of Gloom Cloud's delivery model (metric-parity-fixture.json pins its hash), so it cannot import the helper. Its failed-read backoff is the rejectionMs rule; move it when both copies move together.",
+    "map: new Map<string, { day: string; retryAt: number; result: Promise<MetricReading>; }>()": "A byte-identical copy of Gloom Cloud's delivery model (metric-parity-fixture.json pins its hash), so it cannot import the helper. Its failed-read backoff is the rejectionMs rule; move it when both copies move together."
+  },
+  "src/plugins/builtin/cloud-tweets/table.tsx": {
+    "age: Date.now() - cached.fetchedAt < TWEET_CACHE_TTL_MS": "Feed results kept across tab switches and shown stale while a refetch runs; the entry's fetchedAt also drives the pane's auto-refresh and moves with every appended page, so the stamp is state the view reads.",
+    "map: new Map<string, { data: CloudTweetSearchResponse; fetchedAt: number; hasMore: boolean; }>()": "Feed results kept across tab switches and shown stale while a refetch runs; the entry's fetchedAt also drives the pane's auto-refresh and moves with every appended page, so the stamp is state the view reads."
+  },
+  "src/plugins/builtin/correlation/index.tsx": {
+    "map: new Map<string, { values: DailyClose[]; fetchedAt: number; }>()": "Not a TTL cache: the last good series per range, kept so a failed refresh still draws it. Nothing expires, and fetchedAt is shown with the data."
+  },
+  "src/plugins/builtin/portfolio-list/since-last-seen.ts": {
+    "map: new Map<string, Departure>()": "Not loaded data: what a pane showed when it went out of sight, read once on return against the reader's own away threshold, then used up."
+  },
+  "src/plugins/builtin/sec/command-bar-search.ts": {
+    "map: new Map<string, FocusRequest>()": "Not loaded data: a filing to focus handed from the command bar to the SEC pane, taken on first read and dropped after a few seconds unread."
+  }
+}

package/src/brokers/sync-broker-instance.ts

@@ -32,7 +32,6 @@ export interface SyncBrokerInstanceArgs {
   tickerRepository: AppTickerRepositoryPort;
   existingTickers?: Map<string, TickerRecord>;
   resources?: AppResourceStorePort;
-  persistResolvedBrokerConfig?: boolean;
   signal?: AbortSignal;
   deferPersistence?: boolean;
 }
@@ -69,7 +68,6 @@ export interface SyncBrokerInstancesArgs {
   tickerRepository: AppTickerRepositoryPort;
   existingTickers: Map<string, TickerRecord>;
   resources?: AppResourceStorePort;
-  persistResolvedBrokerConfig?: boolean;
   /** Leave each result's ticker writes to `onResult`, which calls `result.commit()`. */
   deferPersistence?: boolean;
   onResult?: (result: SyncBrokerInstanceResult, instance: BrokerInstanceConfig, previousConfig: AppConfig) => void | Promise<void>;
@@ -168,9 +166,8 @@ async function maybePersistResolvedBrokerConfig(
   config: AppConfig,
   instance: BrokerInstanceConfig,
   broker: BrokerAdapter,
-  persistResolvedBrokerConfig: boolean,
 ): Promise<AppConfig> {
-  if (!persistResolvedBrokerConfig || !broker.getPersistedConfigUpdate) {
+  if (!broker.getPersistedConfigUpdate) {
     return config;
   }
 
@@ -203,7 +200,6 @@ export async function syncBrokerInstance({
   tickerRepository,
   existingTickers,
   resources,
-  persistResolvedBrokerConfig = false,
   signal,
   deferPersistence = false,
 }: SyncBrokerInstanceArgs): Promise<SyncBrokerInstanceResult> {
@@ -336,7 +332,7 @@ export async function syncBrokerInstance({
     : []);
 
   nextConfig = removeStaleBrokerPortfolios(nextConfig, instance.id, currentPortfolioIds);
-  nextConfig = await maybePersistResolvedBrokerConfig(nextConfig, instance, broker, persistResolvedBrokerConfig);
+  nextConfig = await maybePersistResolvedBrokerConfig(nextConfig, instance, broker);
   throwIfBrokerImportCancelled(signal);
   nextConfig = markBrokerInstanceSynced(nextConfig, instance.id, syncedAt);
   const syncedConfig = nextConfig;
@@ -436,7 +432,6 @@ export async function syncBrokerInstances({
   tickerRepository,
   existingTickers,
   resources,
-  persistResolvedBrokerConfig = false,
   deferPersistence = false,
   onResult,
 }: SyncBrokerInstancesArgs): Promise<SyncBrokerInstancesResult> {
@@ -457,7 +452,6 @@ export async function syncBrokerInstances({
         tickerRepository,
         existingTickers: nextTickers,
         resources,
-        persistResolvedBrokerConfig,
         deferPersistence,
       });
 

package/src/capabilities/chart-series.ts

@@ -28,7 +28,7 @@ const SERIES_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._~%:/-]{0,239}$/;
 const chartSeriesLog = debugLog.createLogger("chart-series");
 const ranges = new Set<string>(TIME_RANGES);
 const periods = new Set(["auto", "daily", "weekly", "monthly", "quarterly", "annual", "ttm"]);
-const styles = new Set(["line", "area", "step", "columns", "points", "candles", "ohlc", "hlc"]);
+const styles = new Set(["line", "area", "step", "columns", "points", "candles", "hollow", "heikin-ashi", "ohlc", "hlc"]);
 const transforms = new Set(["raw", "percent", "index100", "yoy", "qoq", "log"]);
 const shapes = new Set(["scalar", "ohlcv", "event", "band"]);
 const axes = new Set(["left", "right"]);

package/src/cli/commands/crypto-hints.ts

@@ -1,7 +1,7 @@
 import { isCryptoInstrumentType } from "../../tickers/search/ranking";
 import { isCryptoVenuePerpetual } from "../../tickers/instrument-kind";
 import type { Quote } from "../../types/financials";
-import { isCryptoPairSymbol, MAJOR_COIN_NAMES } from "../../utils/crypto-pair";
+import { isCryptoPairSymbol, TOP_COIN_NAMES } from "../../utils/crypto-pair";
 import { isNotATickerMessage } from "../not-a-ticker";
 import { groupByCompany } from "../../tickers/company-name";
 import { DATA_SERVICE_UNREACHABLE_MESSAGE } from "../../utils/network-failure";
@@ -10,27 +10,49 @@ import type { TickerRecord } from "../../types/ticker";
 /** Where a crypto pair that will not load can still be read. `fn CRYP` takes no argument. */
 export const CRYPTO_BOARD_HINT = "Crypto prices may be briefly unavailable; the CRYP function (gloom fn CRYP) shows the crypto board.";
 
-// How the note names the coin, and what a listing's name has to say before the note applies.
-const MAJOR_COINS = MAJOR_COIN_NAMES;
+// How the note names the coin, and which tickers it speaks for.
+const MAJOR_COINS = TOP_COIN_NAMES;
+
+/** What a coin note reads of a listing: its quote's, or what a saved listing keeps. */
+interface CoinListing {
+  name?: string | null;
+  instrumentType?: string | null;
+  /** The feed says the price is old. */
+  stale?: boolean;
+  /** The exchange removed the listing, or its last trade is all that is known. */
+  delisting?: unknown;
+}
 
 /**
- * A bare coin ticker usually resolves to a listed fund, not the coin. The note applies only when
- * the listing is not crypto and its own name says the coin (a "Bitcoin" trust), so a company that
- * happens to share the letters (Interlink Electronics on LINK) is left alone. Every command that
- * reads a bare symbol as a listing says it: quote, ticker, and the portfolio and watchlist adds.
+ * A bare coin ticker usually resolves to a listing that is not the coin. The note applies to a
+ * top coin's symbol whenever the listing is not a crypto product, and says how sure it is:
+ *
+ * - "SOL is Emeren Group ..., not solana. For solana use SOL-USD." when the listing cannot be
+ *   what was meant: its name says the coin (a "Bitcoin" trust), or it is stale or delisted
+ *   (SOL's Emeren Group last traded months ago).
+ * - "LINK is Interlink Electronics, Inc. Also a coin: LINK-USD." for a live company that
+ *   happens to share the letters, which may well be the one meant.
+ *
+ * Every command that reads a bare symbol as a listing says it: quote, ticker, history, options,
+ * news, charts, alerts, and the portfolio and watchlist adds.
  */
-export function notTheCoinNote(symbol: string, quote: Pick<Quote, "name" | "instrumentType"> | null | undefined): string | null {
+export function notTheCoinNote(symbol: string, listing: CoinListing | null | undefined): string | null {
   const coin = MAJOR_COINS.get(symbol);
-  const type = quote?.instrumentType?.trim();
-  const name = quote?.name?.trim();
+  const type = listing?.instrumentType?.trim();
+  const name = listing?.name?.trim();
   if (!coin || !name || !type || isCryptoInstrumentType(type)) return null;
-  if (!new RegExp(`\\b${coin}\\b`, "i").test(name)) return null;
-  return `${symbol} is ${name}, not ${coin}. For ${coin} use ${symbol}-USD.`;
+  const cannotBeIt = listing?.stale === true || !!listing?.delisting || new RegExp(`\\b${coin}\\b`, "i").test(name);
+  return cannotBeIt
+    ? `${symbol} is ${name}, not ${coin}. For ${coin} use ${symbol}-USD.`
+    : `${symbol} is ${name}${/[.!?]$/.test(name) ? "" : "."} Also a coin: ${symbol}-USD.`;
 }
 
-/** `notTheCoinNote` for a saved listing, by the name and asset category it was saved with. */
-export function savedListingCoinNote(symbol: string, ticker: Pick<TickerRecord, "metadata">): string | null {
-  return notTheCoinNote(symbol, { name: ticker.metadata.name, instrumentType: ticker.metadata.assetCategory });
+/**
+ * `notTheCoinNote` for a saved listing, by the name and asset category it was saved with.
+ * `ended` says the listing stopped trading, which the saved record does not keep.
+ */
+export function savedListingCoinNote(symbol: string, ticker: Pick<TickerRecord, "metadata">, { ended = false }: { ended?: boolean } = {}): string | null {
+  return notTheCoinNote(symbol, { name: ticker.metadata.name, instrumentType: ticker.metadata.assetCategory, stale: ended });
 }
 
 /**
@@ -70,10 +92,10 @@ function failureReason(message: string, symbol: string): string {
 
 /**
  * Text-mode notes under a quote table: one line per distinct failure reason (with the crypto board
- * pointer when a failed symbol is a crypto pair, unless nothing could be reached), then a line for each bare coin ticker that
- * resolved to something else. `--exchange` names the listing on purpose, so it gets no coin note.
+ * pointer when a failed symbol is a crypto pair, unless nothing could be reached), then the perpetual futures line.
+ * A bare coin ticker read as another listing is said with the listing (`listingChoiceNotes`).
  */
-export function quoteNotes(results: QuoteNoteResult[], options: { exchange?: string } = {}): string[] {
+export function quoteNotes(results: QuoteNoteResult[]): string[] {
   const failures = new Map<string, string[]>();
   for (const result of results) {
     if (!result.error || result.quote) continue;
@@ -87,12 +109,6 @@ export function quoteNotes(results: QuoteNoteResult[], options: { exchange?: str
       ? reason
       : `${symbols.join(", ")}: ${reason}${symbols.some(isCryptoPairSymbol) && reason !== DATA_SERVICE_UNREACHABLE_MESSAGE ? `${/[.!?]$/.test(reason) ? "" : "."} ${CRYPTO_BOARD_HINT}` : ""}`
   ));
-  if (!options.exchange) {
-    for (const result of results) {
-      const note = notTheCoinNote(result.target.symbol, result.quote);
-      if (note) notes.push(note);
-    }
-  }
   const perpetuals = results
     .filter((result) => result.quote && isCryptoVenuePerpetual(result.quote.instrumentType, result.quote.name))
     .map((result) => result.target.symbol);