gloomberb 0.16.0 → 0.16.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",

package/src/api-client/data.ts

@@ -181,6 +181,18 @@ export class CloudDataApi {
     return this.request<T>(`/cloud/equity-screener/${path}`, init);
   }
 
+  getMemberFunds() {
+    return this.request<import("./members").MemberFundsPayload>("/cloud/members");
+  }
+
+  getFundMembers(fund: string) {
+    return this.request<import("./members").FundMembersPayload>(`/cloud/members/${encodeURIComponent(fund)}`);
+  }
+
+  getFundChanges(fund: string) {
+    return this.request<import("./members").FundChangesPayload>(`/cloud/members/${encodeURIComponent(fund)}/changes`);
+  }
+
   getCloudThemes() {
     return this.request<import("./themes").ThemesPayload>("/cloud/themes");
   }
@@ -220,8 +232,8 @@ export class CloudDataApi {
     return this.request<EarningsCalendarPayload>(`/cloud/earnings/calendar?${params}`, { signal: AbortSignal.timeout(30_000) });
   }
 
-  async getCloudEarningsHistory(symbol: string): Promise<EarningsHistoryPayload> {
-    const params = new URLSearchParams({ symbol, limit: "13" });
+  async getCloudEarningsHistory(symbol: string, limit = 13): Promise<EarningsHistoryPayload> {
+    const params = new URLSearchParams({ symbol, limit: String(limit) });
     return this.request<EarningsHistoryPayload>(`/cloud/earnings/history?${params}`, { signal: AbortSignal.timeout(30_000) });
   }
 
@@ -478,7 +490,10 @@ export class CloudDataApi {
   }
   async getCloudPerpsRankings(): Promise<PerpRankingsPayload> { return this.request("/cloud/perps/rankings"); }
   async getCloudPerpsCompare(baseAsset: string): Promise<PerpBoardPayload> { return this.request(`/cloud/perps/compare?${new URLSearchParams({ baseAsset })}`); }
-  async getCloudPerpsEquity(symbol: string): Promise<PerpBoardPayload> { return this.request(`/cloud/perps/equity/${encodeURIComponent(symbol)}`); }
+  async getCloudPerpsEquity(symbol: string, exchange?: string): Promise<PerpBoardPayload> {
+    const query = exchange === undefined ? "" : `?${new URLSearchParams({ identity: "listing", exchange })}`;
+    return this.request(`/cloud/perps/equity/${encodeURIComponent(symbol)}${query}`);
+  }
   async getCloudPerpsMarket(marketId: string): Promise<PerpMarketPayload> { return this.request(`/cloud/perps/market?${new URLSearchParams({ marketId })}`); }
 
   async analyzeCloudExposure(request: ExposureRequest): Promise<ExposurePayload> {

package/src/api-client/index.ts

@@ -742,6 +742,9 @@ class GloomApiClient {
   getCloudEstimateRevisions = this.data.getCloudEstimateRevisions.bind(this.data);
   getCloudMoneyMarkets = this.data.getCloudMoneyMarkets.bind(this.data);
   equityScreener = this.data.equityScreener.bind(this.data);
+  getMemberFunds = this.data.getMemberFunds.bind(this.data);
+  getFundMembers = this.data.getFundMembers.bind(this.data);
+  getFundChanges = this.data.getFundChanges.bind(this.data);
   getCloudThemes = this.data.getCloudThemes.bind(this.data);
   getCloudThemeMembers = this.data.getCloudThemeMembers.bind(this.data);
   impliedVolatility = this.data.impliedVolatility.bind(this.data);

package/src/api-client/members.ts

@@ -0,0 +1,26 @@
+interface MemberFund { ticker: string; name: string; aliases: string[]; changes: "sp500" | "announcements" | "none" }
+export interface FundMember {
+  id: string; symbol: string | null; name: string; sector: string | null;
+  weight: number | null; shares: number; holdingPrice: number; marketValue: number;
+  price: number | null; priceAsOf: string | null; changePercent: number | null; dailyAsOf: string | null;
+  return1WPercent: number | null; return1MPercent: number | null; returnYtdPercent: number | null;
+  contribution: number | null; stale: boolean;
+}
+export interface FundMembersPayload {
+  fund: MemberFund; asOf: string; fetchedAt: string; excludedDerivatives: number; stale: boolean;
+  quotesUnavailable: boolean; snapshotAsOf: string | null; fundDailyAsOf: string | null; quoteCap: number;
+  members: FundMember[];
+  aggregate: { sum: number | null; fundReturn: number | null; residual: number | null; tolerancePp: number;
+    withinTolerance: boolean | null; covered: number; total: number; coveredWeight: number; holdingsWeight: number; fresh1D: number };
+}
+export interface FundChange {
+  id: string; fund: string; effectiveDate: string | null; announcedAt: string | null;
+  added: string | null; removed: string | null; reason: string; headline: string | null; url: string;
+  kind: "history" | "announcement"; daysToGo: number | null;
+  estimates: { symbol: string; usd: number; advUsd: number; days: number; asOf: string; advAsOf: string | null }[];
+}
+export interface FundChangesPayload {
+  fund: MemberFund; changes: FundChange[]; asOf: string | null; stale: boolean; available: boolean;
+  estimateLabel: string; attribution: { text: string; url: string } | null;
+}
+export interface MemberFundsPayload { funds: (MemberFund & { asOf: string | null })[] }

package/src/api-client/perps.ts

@@ -71,6 +71,7 @@ interface PerpCandle {
 
 interface UnderlyingReference {
   symbol: string
+  listingExchange?: string
   price: number
   currency: string
   asOf: string
@@ -79,6 +80,7 @@ interface UnderlyingReference {
 }
 
 export interface PerpBoardRow extends PerpMarket {
+  equityMatch?: { listing: PerpEquityListing; underlying: PerpEquityListing; basis: "listing" | "issuer" }
   stale: boolean
   oiChange1h: number | null
   oiChange24h: number | null
@@ -105,9 +107,11 @@ type PerpHistoryPoint = {
 }
 
 export interface PerpBoardPayload {
+  listing?: PerpEquityListing | null;
   status: string; asOf: string | null; rows: PerpBoardRow[]; total: number; locked: number;
   access: "pro" | "preview"; sources?: unknown[];
 }
+export interface PerpEquityListing { symbol: string; exchange: string }
 export interface PerpHistoryPayload {
   status: string; marketId: string; rows: PerpHistoryPoint[]; funding: PerpFunding[]; candles: PerpCandle[];
   locked: boolean; access: "pro" | "preview"; asOf: string | null;

package/src/api-client/types.ts

@@ -295,7 +295,9 @@ export interface CloudSyncPushResponse {
   settings: SyncSettings;
 }
 
-export interface CloudQuotePayload extends Omit<Quote, "change" | "changePercent"> {
+export interface CloudQuotePayload extends Omit<Quote, "change" | "changePercent" | "priceBasis" | "priceObservation"> {
+  /** The service labels daily NAV here; the app separates observation kind from price units. */
+  priceBasis?: Quote["priceBasis"] | "nav";
   // JSON encodes the provider's unavailable numeric values as null.
   change?: number | null;
   changePercent?: number | null;
@@ -1375,6 +1377,10 @@ export interface CloudMarketScreenerItem {
   change: number;
   changePercent: number;
   volume: number;
+  /** Available average volume for this listing, independent of public ranking membership. */
+  avgVolume?: number;
+  /** Observation time of the optional retained metadata. */
+  metadataAsOf?: string;
   tradeCount?: number;
   currency: string;
   high52w?: number;

package/src/app/global-shortcuts.ts

@@ -8,7 +8,7 @@ import type { AppAction, AppState } from "../state/app/context";
 import type { TickerRecord } from "../types/ticker";
 import { findPaneInstance } from "../types/config";
 import type { ReleaseInfo } from "../updater";
-import { canSelfUpdate } from "../updater";
+import { canRestartToApply, canSelfUpdate } from "../updater";
 import { getVisiblePaneCycleOrder } from "../components/layout/pane/cycle-order";
 import { requestFunctionHelp, useFunctionHelpHost } from "../plugins/builtin/help/function-card";
 import { buildRegistryHelpIndex, helpFunctionForPane } from "../plugins/builtin/help/function-index";
@@ -34,9 +34,10 @@ import {
 const KEYBINDING_NOTICE_DURATION_MS = 15_000;
 
 /**
- * Whether the install-update key has something to do: a release this build
+ * Whether the install-update key has something to retry: a release this build
  * can install itself whose last attempt failed. A fresh one downloads on its
- * own, and a manual or managed one names its own command.
+ * own, and a manual or managed one names its own command. (A downloaded
+ * desktop update has its own use of the key: restarting into it.)
  */
 export function canRetryUpdate(
   state: Pick<AppState, "updateAvailable" | "updateProgress" | "updateCheckInProgress">,
@@ -91,6 +92,7 @@ export function useAppGlobalShortcuts({
   keybindings = getDefaultKeybindings(),
   pluginRegistry,
   refreshTicker,
+  restartToApplyUpdate,
   startUpdate,
   state,
 }: {
@@ -101,6 +103,8 @@ export function useAppGlobalShortcuts({
   keybindings?: ResolvedKeybindings;
   pluginRegistry: PluginRegistry;
   refreshTicker: (symbol: string, exchange?: string, tickerOverride?: TickerRecord | null, priority?: number) => void;
+  /** Applies a downloaded desktop update and relaunches. Runs only on the user's key press. */
+  restartToApplyUpdate: () => void;
   startUpdate: (release: ReleaseInfo) => void;
   state: AppState;
 }) {
@@ -249,9 +253,13 @@ export function useAppGlobalShortcuts({
         refreshTicker(ticker.metadata.ticker, ticker.metadata.exchange, ticker, 1);
       }
     } else if (action === "install-update") {
-      // A release that can install itself starts on its own, so the key is
-      // for the one that failed: it tries again.
-      if (canRetryUpdate(state)) {
+      // A release that can install itself downloads on its own, so the key is
+      // for the one that waits for a restart and for the one that failed.
+      if (!isDetachedWindow && canRestartToApply(state.updateProgress)) {
+        event.preventDefault();
+        event.stopPropagation();
+        restartToApplyUpdate();
+      } else if (canRetryUpdate(state)) {
         event.preventDefault();
         event.stopPropagation();
         startUpdate(state.updateAvailable!);

package/src/app/keybindings/actions.ts

@@ -129,7 +129,7 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
   {
     id: "install-update",
     category: "Global Keys",
-    description: "Install an available app update when one is shown.",
+    description: "Restart into a downloaded app update, or retry one that failed.",
     defaults: ["U"],
   },
   {

package/src/app/runtime/update.ts

@@ -1,8 +1,10 @@
-import { useCallback, useEffect, type Dispatch } from "react";
+import { useCallback, useEffect, useRef, type Dispatch } from "react";
 import type { PluginRegistry } from "../../plugins/registry";
 import { saveConfigImmediately } from "../../state/config-save-scheduler";
 import type { AppAction, AppState } from "../../state/app/context";
 import {
+  applyUpdate,
+  canRestartToApply,
   canSelfUpdate,
   checkForUpdateDetailed,
   performUpdate,
@@ -15,6 +17,11 @@ import { runAutomated } from "../../telemetry/usage-counts";
 
 const UPDATE_CHECK_INTERVAL_MS = 60 * 60_000; // hourly
 
+/** An update is being downloaded, applied, or is downloaded and waiting for a restart. */
+function updateInFlight(progress: AppState["updateProgress"]): boolean {
+  return progress?.phase === "downloading" || progress?.phase === "replacing" || progress?.phase === "ready";
+}
+
 export function useAppUpdateRuntime({
   enabled = true,
   dispatch,
@@ -36,7 +43,13 @@ export function useAppUpdateRuntime({
 }): {
   runUpdateCheck: (manual?: boolean) => Promise<void>;
   startUpdate: (release: ReleaseInfo) => void;
+  /** Installs the downloaded desktop update and relaunches. Does nothing unless one is ready. */
+  restartToApplyUpdate: () => void;
+  /** The command bar's Check for Updates: restarts into a downloaded update, otherwise checks. */
+  runUpdateCommand: () => void;
 } {
+  const restartingRef = useRef(false);
+
   const startUpdate = useCallback((release: ReleaseInfo) => {
     dispatch({ type: "SET_UPDATE_PROGRESS", progress: { phase: "downloading", percent: 0 } });
     void performUpdate(release, (progress) => {
@@ -44,7 +57,23 @@ export function useAppUpdateRuntime({
     });
   }, [dispatch]);
 
+  const restartToApplyUpdate = useCallback(() => {
+    if (!enabled || isDetachedWindow) return;
+    // The app relaunches here, so this must only ever follow the user's own
+    // request, and a second one while the first is working changes nothing.
+    if (restartingRef.current || !canRestartToApply(stateRef.current.updateProgress)) return;
+    restartingRef.current = true;
+    dispatch({ type: "SET_UPDATE_PROGRESS", progress: { phase: "replacing" } });
+    void applyUpdate((progress) => {
+      if (progress.phase === "error") restartingRef.current = false;
+      dispatch({ type: "SET_UPDATE_PROGRESS", progress });
+    });
+  }, [dispatch, enabled, isDetachedWindow, stateRef]);
+
   const runUpdateCheck = useCallback(async (manual = false) => {
+    // A staged update is the answer until it is applied: another check would
+    // swap the release under the "ready" state, and the host has nothing to add.
+    if (updateInFlight(stateRef.current.updateProgress)) return;
     if (manual) {
       dispatch({ type: "SET_UPDATE_CHECK_IN_PROGRESS", checking: true });
       dispatch({ type: "SET_UPDATE_NOTICE", notice: null });
@@ -88,7 +117,12 @@ export function useAppUpdateRuntime({
     }
 
     dispatch({ type: "SET_UPDATE_NOTICE", notice: `Update check failed: ${result.error}` });
-  }, [dispatch]);
+  }, [dispatch, stateRef]);
+
+  const runUpdateCommand = useCallback(() => {
+    if (canRestartToApply(stateRef.current.updateProgress)) restartToApplyUpdate();
+    else void runUpdateCheck(true);
+  }, [restartToApplyUpdate, runUpdateCheck, stateRef]);
 
   useEffect(() => {
     if (!enabled || isDetachedWindow) return;
@@ -121,7 +155,9 @@ export function useAppUpdateRuntime({
   }, [enabled, isDetachedWindow, startUpdate, updateAvailable, updateCheckInProgress, updateProgress]);
 
   return {
+    restartToApplyUpdate,
     runUpdateCheck,
+    runUpdateCommand,
     startUpdate,
   };
 }

package/src/app.tsx

@@ -268,7 +268,7 @@ function AppInner({
     tickerRepository,
   });
 
-  const { runUpdateCheck, startUpdate } = useAppUpdateRuntime({
+  const { restartToApplyUpdate, runUpdateCheck, runUpdateCommand, startUpdate } = useAppUpdateRuntime({
     enabled: updatesEnabled,
     dispatch,
     isDetachedWindow,
@@ -409,6 +409,7 @@ function AppInner({
     keybindings,
     pluginRegistry,
     refreshTicker,
+    restartToApplyUpdate,
     startUpdate,
     state,
   });
@@ -450,10 +451,13 @@ function AppInner({
         desktopWindowBridge={desktopWindowBridge}
       >
         <ThemedAppRoot>
-          <Header onOpenHelp={() => {
-            recordFunctionOpen({ shortcut: "HELP", externalPluginId: null });
-            pluginRegistry.showPane("help");
-          }} />
+          <Header
+            onOpenHelp={() => {
+              recordFunctionOpen({ shortcut: "HELP", externalPluginId: null });
+              pluginRegistry.showPane("help");
+            }}
+            onRestartForUpdate={updatesEnabled && !isDetachedWindow ? restartToApplyUpdate : undefined}
+          />
           <TransientLayoutProvider>
             <Shell
               pluginRegistry={pluginRegistry}
@@ -486,7 +490,7 @@ function AppInner({
               tickerRepository={tickerRepository}
               pluginRegistry={pluginRegistry}
               quitApp={() => rendererHost.requestExit()}
-              onCheckForUpdates={updatesEnabled ? () => runUpdateCheck(true) : undefined}
+              onCheckForUpdates={updatesEnabled ? runUpdateCommand : undefined}
               onNativeOccluderChange={setCommandBarNativeOccluder}
             />
           )}

package/src/cli/pane-functions/function-help.ts

@@ -660,6 +660,13 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     data: QUOTES,
     bloomberg: ["IMAP"],
   },
+  MEMB: {
+    summary: "ETF holdings with weights, shares, member returns, daily contributions and index changes. SPX and SPY use IVV holdings.",
+    usage: ["MEMB", "MEMB SPY", "MEMB IWM"],
+    keys: [TABS, OPEN],
+    data: same("Dated fund holdings and partial delayed member returns. Nasdaq-100 is not covered."),
+    bloomberg: ["MEMB", "MRR", "IMOV"],
+  },
   THEM: {
     summary: "Curated thematic baskets with equal-weight returns and breadth. Open a theme to see its members, leaders and laggards. The Themes tab of BI.",
     usage: ["THEM", "THEM nuclear"],
@@ -675,14 +682,14 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["RRG"],
   },
   HM: {
-    summary: "The largest US stocks and ETFs as a treemap sized by market cap or assets and colored by the day's move.",
+    summary: "The largest US stocks and ETFs as a treemap sized by the square root of market cap or assets, or by plain market cap in its settings, and colored by the day's move.",
     usage: ["HM"],
     keys: [OPEN],
     data: QUOTES,
     bloomberg: ["IMAP"],
   },
   FXC: {
-    summary: "A cross-rate matrix for the major currencies.",
+    summary: "A cross-rate matrix for the major currencies, or for any of 45 chosen in its settings.",
     usage: ["FXC"],
     keys: [],
     data: FX,

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

@@ -34,6 +34,8 @@ export async function executeCollectionCommandAction(options: {
   buildWorkflowDeps: () => WorkflowDeps;
   openModeRoute: (screen: "ticker-search", initialQuery?: string, payload?: Record<string, unknown>) => void;
   openAddToPortfolioWorkflow: (ticker: TickerRecord, preferredPortfolioId?: string | null) => void;
+  /** Join the named collection without the position form. */
+  directMembership?: boolean;
   pushRoute: (route: CommandBarRoute) => void;
   notify: (body: string, options?: { type?: "info" | "success" | "error" }) => void;
   closeAll: (options?: { revertThemePreview?: boolean }) => void;
@@ -73,7 +75,9 @@ export async function executeCollectionCommandAction(options: {
   };
   if (!selectSavedOwner(options.explicitTargetId ?? options.activeCollectionId)) return;
 
-  if (kind === "portfolio" && action === "add") {
+  // A venue picked from the add row joins that collection directly. The AP
+  // command still asks for the position.
+  if (kind === "portfolio" && action === "add" && !options.directMembership) {
     const manualPortfolios = stateForCommand.config.portfolios.filter(isManualPortfolio);
     if (manualPortfolios.length === 0) {
       options.notify("Create a manual portfolio first.", { type: "info" });

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

@@ -3,6 +3,7 @@ import type { TickerRecord } from "../../../../types/ticker";
 import { isManualPortfolio } from "../../../../plugins/builtin/portfolio-list/mutations";
 import type { Command } from "../../commands/registry";
 import type { ResultItem } from "../../list/model";
+import { canRestartToApply } from "../../../../updater";
 
 interface RootCommandItemBuilderOptions {
   activeCollectionId: string | null;
@@ -84,6 +85,9 @@ export function createRootCommandItemBuilder({
         return activeTickerSymbol ? `Remove ${activeTickerSymbol} from Portfolio` : command.label;
       case "set-portfolio-position":
         return activeTickerSymbol ? `Set Position for ${activeTickerSymbol}` : command.label;
+      // The row only shows its label, so a downloaded update is announced there.
+      case "check-for-updates":
+        return state.updateProgress?.phase === "ready" ? "Update ready, restart to apply" : command.label;
       default:
         return command.label;
     }
@@ -128,8 +132,9 @@ export function createRootCommandItemBuilder({
           return `Downloading v${state.updateAvailable?.version}: ${state.updateProgress.percent ?? 0}%`;
         }
         if (state.updateProgress?.phase === "replacing") return "Installing update";
+        if (state.updateProgress?.phase === "ready") return "Update ready, restart to apply";
         if (state.updateProgress?.phase === "done") {
-          return state.updateProgress.message ?? "Update installed - restart to apply";
+          return state.updateProgress.message ?? "Update ready, restart to apply";
         }
         if (state.updateProgress?.phase === "error") {
           return `Update failed: ${state.updateProgress.error}`;
@@ -178,6 +183,8 @@ export function createRootCommandItemBuilder({
     switch (command.id) {
       case "set-portfolio-position":
         return "edit position update position modify position manual position portfolio position";
+      case "check-for-updates":
+        return state.updateProgress?.phase === "ready" ? "check for updates restart relaunch" : "";
       default:
         return "";
     }
@@ -196,7 +203,7 @@ export function createRootCommandItemBuilder({
       searchText: smartSearchText(command),
       disabled:
         command.id === "check-for-updates" &&
-        (state.updateCheckInProgress || !!state.updateProgress),
+        (state.updateCheckInProgress || (!!state.updateProgress && !canRestartToApply(state.updateProgress))),
       action: () => runDirectCommand(command, arg),
     };
   };

package/src/components/command-bar/routes/root/plugin-install.ts

@@ -3,7 +3,7 @@ import type { PluginRegistry } from "../../../../plugins/registry";
 import { findAbsorbedPlugin } from "../../../../plugins/absorbed";
 import { isOfficialPluginRepo } from "../../../../plugins/auto-update";
 import { getCurrentPluginTarget, runsExternalPlugins } from "../../../../plugins/current-target";
-import { activateInstalledPlugin } from "../../../../plugins/builtin/plugin-marketplace/activation";
+import { activateInstall } from "../../../../plugins/builtin/plugin-marketplace/activation";
 import { loadRegistry, registryPluginUrl } from "../../../../plugins/builtin/plugin-marketplace/feed";
 import {
   installConsent,
@@ -217,7 +217,7 @@ function buildPluginInstallItem(
       onConfirm: async () => {
         const result = await manager.install(repo, pin);
         if (!result.ok) throw new Error(`Could not install ${plugin.name}: ${result.error}`);
-        const activated = await activateInstalledPlugin(result.directory, host, manager);
+        const activated = await activateInstall(result, host, manager);
         if (!activated.ok) throw new Error(`${plugin.name} installed but did not load: ${activated.error}`);
         if (activated.restart) {
           context.notify(`Restart to finish installing ${plugin.name}.`, "info");

package/src/components/command-bar/routes/root/provider-search.ts

@@ -8,6 +8,7 @@ import {
   mergePlainRootTickerResults,
   mergeTickerSearchResultItems,
   QUICK_LOOK_TICKER_SEARCH_OPTIONS,
+  venueDropdownResults,
 } from "../ticker-search/results";
 import { orderListResults, type ResultItem } from "../../list/model";
 import type { CommandBarCategoryPriorities, CommandBarSectionOrder } from "../../view-model";
@@ -27,6 +28,8 @@ export function useRootProviderSearch(options: {
     brokerInstanceId?: string | null,
   ) => TickerSearchCandidate[] | null;
   rootPlainTickerSearchArg: string | null;
+  /** Set when the query is `NET:` or `NET:N`. Empty string lists every venue. */
+  listingSuffix: string | null;
   rootResultItems: ResultItem[];
   rootTickerSearchArg: string | null;
   tickers: AppState["tickers"];
@@ -52,6 +55,7 @@ export function useRootProviderSearch(options: {
     portfolios,
     readTickerSearchCache,
     rootPlainTickerSearchArg,
+    listingSuffix,
     rootResultItems,
     rootTickerSearchArg,
     tickers,
@@ -181,6 +185,13 @@ export function useRootProviderSearch(options: {
   }, []);
 
   const rootResults = useMemo(() => {
+    if (listingSuffix != null) {
+      if (rootTickerSearchArg && rootProviderResultsQuery === rootTickerSearchArg && rootProviderResults) {
+        return venueDropdownResults(rootTickerSearchArg, rootProviderResults, listingSuffix);
+      }
+      // The venue list replaces commands. Nothing else shows while it loads.
+      return [];
+    }
     if (rootTickerSearchArg && rootProviderResultsQuery === rootTickerSearchArg && rootProviderResults) {
       if (rootPlainTickerSearchArg) {
         return mergePlainRootTickerResults(rootPlainTickerSearchArg, rootProviderResults, rootResultItems);
@@ -189,17 +200,20 @@ export function useRootProviderSearch(options: {
     }
     return rootResultItems;
   }, [
+    listingSuffix,
     rootPlainTickerSearchArg,
     rootProviderResults,
     rootProviderResultsQuery,
     rootResultItems,
     rootTickerSearchArg,
   ]);
-  const rootSectionOrder: CommandBarSectionOrder = rootPlainTickerSearchArg
-    ? "app-first"
-    : rootTickerSearchArg
-      ? "ranked"
-      : "default";
+  const rootSectionOrder: CommandBarSectionOrder = listingSuffix != null
+    ? "ranked"
+    : rootPlainTickerSearchArg
+      ? "app-first"
+      : rootTickerSearchArg
+        ? "ranked"
+        : "default";
   const orderedRootResults = useMemo(
     () => orderListResults(rootResults, { sectionOrder: rootSectionOrder, categoryPriorities }),
     [categoryPriorities, rootResults, rootSectionOrder],

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

@@ -4,7 +4,7 @@ import type { AppState } from "../../../../state/app/context";
 import type { DataProvider } from "../../../../types/data-provider";
 import type { CommandDef, PaneTemplateCreateOptions, PaneTemplateDef } from "../../../../types/plugin";
 import type { TickerRecord } from "../../../../types/ticker";
-import type { TickerSearchCandidate } from "../../../../tickers/search";
+import { listingChoiceQuery, symbolSearchQuery, type TickerSearchCandidate } from "../../../../tickers/search";
 import type { AssistRowHandlers } from "../../assist/model";
 import { matchPrefix, type Command } from "../../commands/registry";
 import type { ResultItem } from "../../list/model";
@@ -246,11 +246,19 @@ export function useCommandBarRootRuntime({
   // Free text that no prefix claims also goes to symbol search, so "nvidia"
   // finds NVDA without the backtick. Skipped when a local row already carries
   // that exact name, since an "Exact Match" symbol would otherwise outrank it.
+  // `NET:` is that symbol's venue dropdown. The search itself is the bare symbol.
+  const rootListingChoice = useMemo(() => {
+    if (currentRoute || activeMatch || rootShortcutIntent.kind !== "none") return null;
+    return listingChoiceQuery(rootQuery);
+  }, [activeMatch, currentRoute, rootQuery, rootShortcutIntent.kind]);
   const rootPlainTickerSearchArg = useMemo(() => {
     if (currentRoute || activeMatch || rootShortcutIntent.kind !== "none") return null;
+    // An explicit venue choice also searches one-letter symbols and names shared with local actions.
+    if (rootListingChoice) return rootListingChoice.symbol;
     const trimmed = rootQuery.trim();
-    if (trimmed.length < 2) return null;
-    const normalizedQuery = normalizeCommandTickerSearchText(trimmed);
+    const symbolQuery = symbolSearchQuery(trimmed);
+    if (symbolQuery.length < 2) return null;
+    const normalizedQuery = normalizeCommandTickerSearchText(symbolQuery);
     // The install row for "TV" is labelled TV, but it leads on purpose and
     // must not keep Grupo Televisa out of the list.
     const hasExactLocalRow = rootResultModel.items.some((item) => (
@@ -259,8 +267,8 @@ export function useCommandBarRootRuntime({
       && item.kind !== "search"
       && normalizeCommandTickerSearchText(item.label) === normalizedQuery
     ));
-    return hasExactLocalRow ? null : trimmed;
-  }, [activeMatch, currentRoute, pluginInstallItem, rootQuery, rootResultModel.items, rootShortcutIntent.kind]);
+    return hasExactLocalRow ? null : symbolQuery;
+  }, [activeMatch, currentRoute, pluginInstallItem, rootListingChoice, rootQuery, rootResultModel.items, rootShortcutIntent.kind]);
   const rootTickerSearchArg = rootSecurityDescriptionArg ?? rootPlainTickerSearchArg;
 
   const {
@@ -278,6 +286,7 @@ export function useCommandBarRootRuntime({
     portfolios: state.config.portfolios,
     readTickerSearchCache,
     rootPlainTickerSearchArg,
+    listingSuffix: rootPlainTickerSearchArg && rootListingChoice ? rootListingChoice.suffix : null,
     rootResultItems: rootResultModel.items,
     rootTickerSearchArg,
     tickers: state.tickers,

package/src/components/command-bar/routes/ticker-search/results.ts

@@ -10,7 +10,7 @@ import {
   parseAssetClassQuery,
 } from "../../../../tickers/search/asset-classes";
 import type { ResultItem } from "../../list/model";
-import { canonicalExchange, parsePublicTickerKey } from "../../../../utils/exchanges";
+import { canonicalExchange, parsePublicTickerKey, publicExchange } from "../../../../utils/exchanges";
 import { compactSearchText, getIssuerGroupKey, isExplicitMarketSymbol } from "../../../../tickers/search/ranking";
 
 export const QUICK_LOOK_TICKER_SEARCH_OPTIONS = { includeOptionContracts: false } as const;
@@ -43,10 +43,10 @@ function rawInstrumentType(candidate: Pick<TickerSearchCandidate, "result" | "ti
 }
 
 /**
- * Class tag for the badge column: the class code a query can end with (EQ,
- * CUR, OPT, FUT, IDX, ETF), else FUND or DERIV. An unclassified instrument
- * gets none: the row lifts its exchange code there instead when the code is
- * short enough.
+ * Class tag for the badge column. A query can end with the same code: EQ,
+ * CUR, CRYP, OPT, FUT, IDX, ETF, FUND. A fund or derivative whose type string
+ * did not classify still badges FUND or DERIV. Anything else gets none, and
+ * the row shows its exchange code there when the code is short enough.
  */
 export function formatInstrumentBadge(
   candidate: Pick<TickerSearchCandidate, "instrumentClass" | "result" | "ticker">
@@ -167,6 +167,32 @@ export function mergePlainRootTickerResults(
   ];
 }
 
+function venueMatchesSuffix(item: ResultItem, suffix: string): boolean {
+  if (!suffix) return true;
+  const displayed = (item.right ?? "").trim().toUpperCase();
+  const fromLabel = parsePublicTickerKey(item.label.trim().toUpperCase()).exchange ?? "";
+  const canonicalDisplayed = canonicalExchange(displayed);
+  const targets = [displayed, canonicalDisplayed, fromLabel, publicExchange(canonicalDisplayed || displayed)];
+  if (targets.some((value) => value.startsWith(suffix))) return true;
+  const aliased = canonicalExchange(suffix);
+  return aliased !== suffix && targets.some((value) => canonicalExchange(value) === aliased);
+}
+
+/**
+ * The colon query's dropdown: one row per exact venue, in ranked order. A
+ * typed exchange prefix keeps the rows it matches.
+ */
+export function venueDropdownResults(symbol: string, items: ResultItem[], suffix: string): ResultItem[] {
+  const rows: ResultItem[] = [];
+  for (const item of items) {
+    if (item.kind !== "ticker" && item.kind !== "search") continue;
+    if (!isExactTickerResultMatch(item, symbol)) continue;
+    if (!venueMatchesSuffix(item, suffix)) continue;
+    rows.push(item.category === "Exact Match" ? item : { ...item, category: "Exact Match" });
+  }
+  return rows;
+}
+
 /**
  * Up to the cap, in this order: the first exact row of each security, the
  * exact symbol's other exchanges, then looser hits. The rows keep their

package/src/components/command-bar/routes/ticker-search/route.ts

@@ -2,7 +2,7 @@ import { useCallback, useEffect, useRef, useState } from "react";
 import type { AppState } from "../../../../state/app/context";
 import type { DataProvider } from "../../../../types/data-provider";
 import type { TickerSearchCandidate } from "../../../../tickers/search";
-import { searchTickerCandidates } from "../../../../tickers/search";
+import { searchTickerCandidates, symbolSearchQuery } from "../../../../tickers/search";
 import {
   COMMAND_BAR_TICKER_SEARCH_LIMIT,
   mergeTickerSearchResultItems,
@@ -64,7 +64,7 @@ export function useTickerSearchRouteResults(options: {
       return;
     }
 
-    const searchQuery = routeQuery.trim();
+    const searchQuery = symbolSearchQuery(routeQuery);
     if (!searchQuery) {
       searchRequestIdRef.current += 1;
       setTickerSearchPending(false);