gloomberb 0.15.2 → 0.15.3

package/src/plugins/builtin/notes/index.tsx

@@ -1,6 +1,7 @@
 import { apiClient } from "../../../api-client";
 import type { GloomPlugin } from "../../../types/plugin";
 import { teamStore } from "../cloud/team/store";
+import { notesCliCommand } from "./cli";
 import { exportNotesToDirectory, exportSourceLabel } from "./export";
 import { NotesFiles } from "./files";
 import { migrateLocalNotes, notesMigratedAt } from "./migration";
@@ -16,6 +17,7 @@ export const notesPlugin: GloomPlugin = {
   version: "2.0.0",
   description: "Markdown notes on tickers and on their own, personal or shared with a team.",
   toggleable: true,
+  cliCommands: [notesCliCommand],
 
   setup(ctx) {
     const dataDir = ctx.getConfig().dataDir;
@@ -45,7 +47,7 @@ export const notesPlugin: GloomPlugin = {
           });
         }
       } catch (error) {
-        console.error("[notes] Local note import failed:", error);
+        ctx.log.error("Local note import failed", { error: error instanceof Error ? error.message : String(error) });
       } finally {
         migrating = false;
       }
@@ -63,7 +65,7 @@ export const notesPlugin: GloomPlugin = {
 
     ctx.on("ticker:removed", ({ symbol }) => {
       registry.personal().delete(symbol).catch((error) => {
-        console.error("[notes] Failed to delete ticker note:", error);
+        ctx.log.error("Failed to delete ticker note", { symbol, error: error instanceof Error ? error.message : String(error) });
         ctx.notify({ body: "Failed to delete note.", type: "error" });
       });
     });

package/src/plugins/builtin/notes/migration.ts

@@ -1,9 +1,11 @@
 import { ApiRequestError } from "../../../api-client/errors";
 import type { PluginPersistence } from "../../../types/plugin";
+import { debugLog } from "../../../utils/debug-log";
 import type { NotesFiles } from "./files";
 import type { CloudNotesStore } from "./store";
 
 const MIGRATED_AT_KEY = "notes:migratedAt";
+const notesLog = debugLog.createLogger("notes");
 
 export interface NotesMigrationResult {
   uploaded: number;
@@ -73,7 +75,7 @@ export async function migrateLocalNotes(
     await save(key, "", entry.title);
   }
   if (rejected.length > 0) {
-    console.warn(`[notes] ${rejected.length} local note(s) were not accepted by Gloom Cloud and stay local: ${rejected.join(", ")}`);
+    notesLog.warn(`${rejected.length} local note(s) were not accepted by Gloom Cloud and stay local`, { rejected });
   }
   persistence?.setState(MIGRATED_AT_KEY, new Date().toISOString());
   return { uploaded, skipped, rejected };

package/src/plugins/builtin/notes/quick-notes-pane.tsx

@@ -5,9 +5,10 @@ import { isPlainKey } from "../../../utils/keyboard";
 import type { PaneProps } from "../../../types/plugin";
 import { colors } from "../../../theme/colors";
 import { MarkdownEditor } from "../../../components/markdown-editor";
-import { ConfirmDialog, EmptyState, Tabs, TextField, usePaneFooter, usePaneHeaderTabs } from "../../../components";
-import { type PromptContext, useDialog } from "../../../ui/dialog";
+import { confirmDialog, EmptyState, TextField, usePaneFooter, usePaneTabs } from "../../../components";
+import { useDialog } from "../../../ui/dialog";
 import { usePluginAppActions, usePluginPaneState } from "../../runtime";
+import { debugLog } from "../../../utils/debug-log";
 import { MarkdownNotePreview } from "./markdown-note-preview";
 import {
   formatDeleteNoteTitle,
@@ -19,6 +20,8 @@ import { chooseNoteOwner, ownerColor, ownerLabel, resolveNoteConflict, useNoteTe
 import { NoteConflictError, type NoteOwner, noteOwnerKey, type NotesStoreRegistry } from "./store";
 import { useSyncedText } from "./text-state";
 
+const notesLog = debugLog.createLogger("notes");
+
 /** A tab in the pane: a quick note plus who owns it. */
 interface OwnedQuickNote extends QuickNoteEntry {
   owner: NoteOwner;
@@ -71,7 +74,7 @@ export function createQuickNotesPane(registry: NotesStoreRegistry) {
         const store = storeFor(owner);
         if (store.readOnly) continue;
         store.saveQuickNotesIndex(bucket?.entries ?? []).catch((error) => {
-          console.error("[notes] Failed to save notes index:", error);
+          notesLog.error("Failed to save notes index", { error: error instanceof Error ? error.message : String(error) });
           notify({ body: error instanceof Error ? error.message : "Failed to save notes index.", type: "error" });
         });
       }
@@ -123,7 +126,7 @@ export function createQuickNotesPane(registry: NotesStoreRegistry) {
           }
           return;
         }
-        console.error("[notes] Failed to save note:", error);
+        notesLog.error("Failed to save note", { error: error instanceof Error ? error.message : String(error) });
         notify({ body: error instanceof Error ? error.message : "Failed to save note.", type: "error" });
       });
 
@@ -261,7 +264,7 @@ export function createQuickNotesPane(registry: NotesStoreRegistry) {
       });
       const store = storeFor(owner);
       store.delete(store.quickNoteKey(id)).catch((error) => {
-        console.error("[notes] Failed to delete note:", error);
+        notesLog.error("Failed to delete note", { error: error instanceof Error ? error.message : String(error) });
         notify({ body: error instanceof Error ? error.message : "Failed to delete note.", type: "error" });
       });
       setEditing(false);
@@ -276,25 +279,18 @@ export function createQuickNotesPane(registry: NotesStoreRegistry) {
         : await store.load(store.quickNoteKey(id));
 
       if (text.trim().length > 0) {
-        const confirmed = await dialog.prompt<boolean>({
-          closeOnClickOutside: true,
-          content: (ctx: PromptContext<boolean>) => (
-            <ConfirmDialog
-              {...ctx}
-              title="Delete note?"
-              body={[
-                `Delete "${formatDeleteNoteTitle(tab?.title ?? "Note")}"?`,
-                "This note has content.",
-                "Deleting it cannot be undone.",
-              ]}
-              confirmLabel="Delete"
-              cancelLabel="Cancel"
-              width={44}
-              footer="Enter delete · Esc cancel"
-            />
-          ),
-        }).catch(() => false);
-        if (confirmed !== true) return;
+        const confirmed = await confirmDialog(dialog, {
+          title: "Delete note?",
+          body: [
+            `Delete "${formatDeleteNoteTitle(tab?.title ?? "Note")}"?`,
+            "This note has content.",
+            "Deleting it cannot be undone.",
+          ],
+          confirmLabel: "Delete",
+          width: 44,
+          footer: "Enter delete · Esc cancel",
+        });
+        if (!confirmed) return;
       }
 
       removeTab(id);
@@ -409,7 +405,7 @@ export function createQuickNotesPane(registry: NotesStoreRegistry) {
       setActiveTabId(id);
       setEditing(false);
     };
-    const tabsInHeader = usePaneHeaderTabs({
+    const { strip: tabStrip } = usePaneTabs({
       tabs: noteTabs,
       activeValue: activeTabId,
       onSelect: selectTab,
@@ -418,25 +414,13 @@ export function createQuickNotesPane(registry: NotesStoreRegistry) {
       onAdd: () => { void addTab(); },
       // New, Rename and Delete Note are footer hints, so already in the pane menu.
       paneMenu: false,
+      compact: true,
+      variant: "pill",
     });
 
     return (
       <Box flexDirection="column" flexGrow={1}>
-        {!tabsInHeader && (
-          <Box height={1}>
-            <Tabs
-              tabs={noteTabs}
-              activeValue={activeTabId}
-              onSelect={selectTab}
-              compact
-              variant="pill"
-              closeMode="active"
-              onAdd={() => { void addTab(); }}
-              paneMenu={false}
-              focused={focused && !editing && !renaming}
-            />
-          </Box>
-        )}
+        {tabStrip && <Box height={1}>{tabStrip}</Box>}
         {renaming && (
           <Box height={1} flexDirection="row" paddingLeft={1}>
             <Text fg={colors.textDim}>{"Rename: "}</Text>

package/src/plugins/builtin/notes/ticker-notes-tab.tsx

@@ -7,6 +7,7 @@ import { colors } from "../../../theme/colors";
 import { MarkdownEditor } from "../../../components/markdown-editor";
 import { EmptyState, usePaneFooter } from "../../../components";
 import { usePluginAppActions, usePluginPaneState } from "../../runtime";
+import { debugLog } from "../../../utils/debug-log";
 import { useDialog } from "../../../ui/dialog";
 import { MarkdownNotePreview } from "./markdown-note-preview";
 import {
@@ -20,6 +21,8 @@ import { NoteConflictError, type NoteOwner, type NotesStoreRegistry } from "./st
 import { useSyncedText } from "./text-state";
 import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
 
+const notesLog = debugLog.createLogger("notes");
+
 export function createNotesTab(registry: NotesStoreRegistry) {
   return function NotesTab({ focused, width, onCapture }: TickerResearchTabProps) {
     const { ticker } = usePaneTickerIdentity();
@@ -101,7 +104,7 @@ export function createNotesTab(registry: NotesStoreRegistry) {
           }
           return;
         }
-        console.error("[notes] Failed to save ticker note:", error);
+        notesLog.error("Failed to save ticker note", { symbol, error: error instanceof Error ? error.message : String(error) });
         notify({ body: error instanceof Error ? error.message : "Failed to save note.", type: "error" });
       });
     }, [applyNoteText, dialog, effectiveOwner, notesFiles, notify]);

package/src/plugins/builtin/options/analytics.ts

@@ -1,20 +1,18 @@
 import type { PriceHistoryIntegrity } from "../../../utils/price-history-integrity";
 import type { OptionContract, OptionsChain, PricePoint } from "../../../types/financials";
 import {
+  daysToExpiryFrom,
   extractImpliedForward,
   forwardFromCarry,
   optionMid,
   realizedVolatilityCadenceIssue,
   realizedVolatilityResult,
-} from "../shared/volatility";
-import {
-  DEFAULT_OPTION_CALC_DRAFT,
-  daysToExpiryFrom,
   solveImpliedVolatility,
   valueOption,
   type OptionSide,
   type OptionValuation,
-} from "../options-calculator/model";
+} from "../shared/volatility";
+import { DEFAULT_OPTION_CALC_DRAFT } from "../options-calculator/model";
 import { optionQuoteValuationTime } from "../vol-surface/model";
 
 const HISTORICAL_VOLATILITY_SESSIONS = 30;
@@ -96,7 +94,7 @@ export function solveChainVolatilities(
     const solve = (side: OptionSide, contract: OptionContract | undefined): number | null => {
       const mid = contract ? optionMid(contract) : null;
       if (mid == null) return null;
-      const solved = solveImpliedVolatility({ ...DEFAULT_OPTION_CALC_DRAFT, side, spot: forward, strike: contract!.strike,
+      const solved = solveImpliedVolatility({ side, spot: forward, strike: contract!.strike,
         daysToExpiry: years * 365, rate, dividendYield: rate }, mid).volatility;
       return solved != null && Number.isFinite(solved) && solved > 0 ? solved : null;
     };
@@ -201,11 +199,11 @@ export function calculateOptionGreeks(
     return undefined;
   }
   return valueOption({
-    ...DEFAULT_OPTION_CALC_DRAFT,
     side,
     spot,
     strike: contract.strike,
     daysToExpiry: daysToExpiryFrom(contract.expiration, volatilities.valuationTime),
+    rate: DEFAULT_OPTION_CALC_DRAFT.rate,
     volatility,
     dividendYield: Number.isFinite(dividendYield) ? dividendYield! : 0,
   });

package/src/plugins/builtin/options/calc-seed.ts

@@ -1,5 +1,6 @@
 import type { OptionContract } from "../../../types/financials";
-import { buildOptionCalcParams, type OptionSide } from "../options-calculator/model";
+import { buildOptionCalcParams } from "../options-calculator/model";
+import type { OptionSide } from "../shared/volatility";
 import type { OptionTableRow } from "./types";
 import { optionMarketReference } from "./market-reference";
 

package/src/plugins/builtin/options/enrichment-client.ts

@@ -5,6 +5,8 @@ import type { YieldPoint } from "../yield-curve/treasury-data";
 import { optionsEnrichmentNeighbour, optionsEnrichmentSelectionIssue, projectOptionsEnrichment,
   type OptionsEnrichmentCache, type OptionsEnrichmentProjection, type OptionsEnrichmentSelection,
   type OptionsEnrichmentSnapshot } from "./enrichment-model";
+import { abortable, abortError } from "../../../utils/async-deadline";
+import { errorMessage } from "../../../utils/errors";
 
 export interface OptionsEnrichmentRequest extends OptionsEnrichmentSelection {
   signal?: AbortSignal;
@@ -18,25 +20,14 @@ export interface OptionsEnrichmentRequest extends OptionsEnrichmentSelection {
   onProjection?: (projection: OptionsEnrichmentProjection) => void;
 }
 
-function message(error: unknown): string { return error instanceof Error ? error.message : String(error); }
-function abortError(): Error { return new DOMException("Options enrichment was cancelled", "AbortError"); }
-
-function abortable<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {
-  if (!signal) return promise;
-  return new Promise<T>((resolve, reject) => {
-    const abort = () => reject(abortError());
-    if (signal.aborted) { abort(); return; }
-    signal.addEventListener("abort", abort, { once: true });
-    promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
-  });
-}
+const CANCELLED = "Options enrichment was cancelled";
 
 /** OMON supplies its selected cached slice. Only the adjacent slice can need another chain request. */
 export async function loadOptionsEnrichment(
   request: OptionsEnrichmentRequest,
   dependencies: SurfaceLoaderDependencies = createSurfaceDependencies(),
 ): Promise<OptionsEnrichmentSnapshot> {
-  if (request.signal?.aborted) throw abortError();
+  if (request.signal?.aborted) throw abortError(CANCELLED);
   const now = dependencies.now?.() ?? Date.now();
   const neighbourExpiration = optionsEnrichmentNeighbour(request.catalogue, request.expiration, now);
   let curve: YieldPoint[] = request.curve ?? [];
@@ -61,19 +52,19 @@ export async function loadOptionsEnrichment(
   // The first snapshot already has the quoted straddle even while rates are pending.
   publish();
   const treasury = request.curve ? Promise.resolve() : Promise.resolve().then(() => {
-    if (request.signal?.aborted) throw abortError();
+    if (request.signal?.aborted) throw abortError(CANCELLED);
     return dependencies.loadYieldCurve();
   }).then((value) => { curve = value; })
-    .catch((error) => { treasuryError = message(error); }).finally(() => { curveLoading = false; publish(); });
+    .catch((error) => { treasuryError = errorMessage(error); }).finally(() => { curveLoading = false; publish(); });
   const adjacent = neighbourExpiration == null ? Promise.resolve() : Promise.resolve()
     .then(() => {
-      if (request.signal?.aborted) throw abortError();
+      if (request.signal?.aborted) throw abortError(CANCELLED);
       return dependencies.loadOptions({ instrument: request.instrument, expirationDate: neighbourExpiration },
         { forceRefresh: request.forceRefresh });
     })
     .then((entry) => { neighbourEntry = entry; })
-    .catch((error) => { neighbourError = message(error); }).finally(() => { neighbourLoading = false; publish(); });
-  await abortable(Promise.all([treasury, adjacent]), request.signal);
-  if (request.signal?.aborted) throw abortError();
+    .catch((error) => { neighbourError = errorMessage(error); }).finally(() => { neighbourLoading = false; publish(); });
+  await abortable(Promise.all([treasury, adjacent]), request.signal, CANCELLED);
+  if (request.signal?.aborted) throw abortError(CANCELLED);
   return snapshot();
 }

package/src/plugins/builtin/options/enrichment-model.ts

@@ -3,8 +3,7 @@ import type { QueryEntry } from "../../../market-data/result-types";
 import { buildOptionsKey, resolveEntryData } from "../../../market-data/selectors";
 import type { OptionsChain } from "../../../types/financials";
 import { normalizeSymbol, parsePublicTickerKey } from "../../../utils/exchanges";
-import { daysToExpiryFrom } from "../options-calculator/model";
-import { volatilityTermSlope, type ExpectedMove } from "../shared/volatility";
+import { daysToExpiryFrom, volatilityTermSlope, type ExpectedMove } from "../shared/volatility";
 import { buildSurfaceExpiry, evaluateSurfaceSmile, type SurfaceExpiry } from "../vol-surface/model";
 import type { YieldPoint } from "../yield-curve/treasury-data";
 

package/src/plugins/builtin/options/footer.ts

@@ -4,8 +4,8 @@ import { t, tf } from "../../../i18n";
 import type { OptionsChain } from "../../../types/financials";
 import { formatRelativeTime } from "../../../utils/datetime-format";
 import { useCloudAccessFooter } from "../shared/cloud-upgrade";
-import { usePaneStatusFooter } from "../shared/pane-footer";
-import { CLOUD_QUOTE_DELAY_MINUTES } from "../shared/plan-access";
+import { usePaneStatusFooter } from "../../../components/layout/pane/status-footer";
+import { CLOUD_QUOTE_DELAY_MINUTES } from "../../../api-client/plan-access";
 import type { OptionQuoteCoverage, OptionQuoteCoverageStatus } from "./live-quotes";
 import { formatOptionPrice, optionSpread, type OptionMarketReference } from "./market-reference";
 

package/src/plugins/builtin/options/index.tsx

@@ -20,7 +20,7 @@ function OptionsResearchTab({ width, height, focused }: TickerResearchTabProps)
 import {
   LIVE_STREAMING_QUICK_SETTING,
   withLiveStreamingSetting,
-} from "../shared/live-streaming";
+} from "../../../state/hooks/live-streaming";
 import { OPTION_FIELD_DEFS, resolveOptionFieldIds } from "./table";
 
 function optionsSettings(settings: Record<string, unknown>): PaneSettingsDef {

package/src/plugins/builtin/options/live-quotes.ts

@@ -3,6 +3,7 @@ import type { OptionContract, OptionsChain, Quote } from "../../../types/financi
 import { buildQuoteKey, resolveEntryData } from "../../../market-data/selectors";
 import type { QueryEntry } from "../../../market-data/result-types";
 import type { OptionTableRow } from "./types";
+import { isFiniteNumber } from "../../../utils/guards";
 
 export const OPTIONS_QUOTE_EXCHANGE = "OPTIONS";
 export const OPTIONS_CHAIN_REFRESH_INTERVAL_MS = 10 * 60_000;
@@ -36,10 +37,6 @@ export interface OptionsQuoteFreshness {
   subscriptionStartedAt: number;
 }
 
-function isFiniteNumber(value: number | undefined): value is number {
-  return typeof value === "number" && Number.isFinite(value);
-}
-
 export interface OptionQuoteTargetWindow {
   fallbackHeight: number;
   selectedIndex: number;

package/src/plugins/builtin/options/table.ts

@@ -10,7 +10,7 @@ import type {
   OptionFieldId,
   OptionTableRow,
 } from "./types";
-import type { OptionSide, OptionValuation } from "../options-calculator/model";
+import type { OptionSide, OptionValuation } from "../shared/volatility";
 
 type OptionColorRole = "call" | "put" | "price" | "activity" | "iv" | "strike";
 
@@ -23,12 +23,14 @@ type OptionFieldDef = {
 };
 
 const OPTION_TEXT_MIN_CONTRAST = 4.5;
-// How far the in-the-money band has to stand off the out-of-the-money one. The
-// two sit edge to edge across the strike column, so this is the step the eye
+// How far the in-the-money band stands off the out-of-the-money one. The two
+// sit edge to edge across the strike column, so this is the step the eye
 // actually reads, and holding it fixed is what makes the banding land the same
-// way on every palette. The ceiling keeps the band a tint of the background
-// rather than a wall of the side colour.
-const MONEYNESS_MIN_SEPARATION = 1.45;
+// way on every palette. Both sides share one neutral band: the call and put
+// columns already carry their colour in the text, and a green and a red slab
+// under it drowned the numbers. The step stays small enough that the selected
+// row still stands clear of the band it sits in.
+const MONEYNESS_MIN_SEPARATION = 1.25;
 const MONEYNESS_MAX_TINT = 0.42;
 
 export const OPTION_FIELD_DEFS: OptionFieldDef[] = [
@@ -46,7 +48,7 @@ export const OPTION_FIELD_DEFS: OptionFieldDef[] = [
   { id: "openInterest", label: "Open interest", header: "OI", width: 6, description: "Outstanding open contracts." },
 ];
 
-export const DEFAULT_OPTION_FIELD_IDS: OptionFieldId[] = ["bid", "ask", "spread", "last", "delta", "gamma"];
+export const DEFAULT_OPTION_FIELD_IDS: OptionFieldId[] = ["bid", "ask", "last", "iv", "delta", "volume", "openInterest"];
 
 const OPTION_FIELDS_BY_ID = new Map(OPTION_FIELD_DEFS.map((field) => [field.id, field]));
 
@@ -220,10 +222,9 @@ function optionMoneynessBackground(
   if (rowState.selected || !column.side) return undefined;
   const outOfTheMoney = blendHex(colors.bg, colors.neutral, 0.055);
   if (!inferColumnMoneyness(row, contract, column.side)) return outOfTheMoney;
-  const sideColor = column.side === "call" ? colors.positive : colors.negative;
   return blendForSeparation(
     colors.bg,
-    sideColor,
+    colors.neutral,
     outOfTheMoney,
     MONEYNESS_MIN_SEPARATION,
     MONEYNESS_MAX_TINT,
@@ -286,10 +287,8 @@ export function renderOptionCell(
   /** The contract the cursor row has picked: only its half and the strike take the highlight. */
   activeSide?: OptionSide | null,
 ): DataTableCell {
-  const rowState = cursorState.selected && column.side && activeSide && column.side !== activeSide
-    ? { selected: false }
-    : cursorState;
-  const selectedColor = rowState.selected ? colors.selectedText : undefined;
+  const otherHalf = cursorState.selected && !!column.side && !!activeSide && column.side !== activeSide;
+  const rowState = otherHalf ? { selected: false } : cursorState;
   const rowSurface = rowState.selected ? colors.selected : colors.bg;
 
   if (column.field === "strike") {
@@ -299,7 +298,7 @@ export function renderOptionCell(
     const surface = backgroundColor ?? rowSurface;
     return {
       text: formatStrikeLabel(row.strike),
-      color: selectedColor ?? optionRoleColor("strike", surface),
+      color: optionRoleColor("strike", surface),
       backgroundColor,
       attributes: rowState.selected || row.isPositionStrike ? TextAttributes.BOLD : TextAttributes.NONE,
     };
@@ -310,7 +309,8 @@ export function renderOptionCell(
   const surface = backgroundColor ?? rowSurface;
   return {
     text: formatOptionContractCell(row, contract, column),
-    color: selectedColor ?? (contract ? optionRoleColor(optionColumnRole(column), surface) : optionMutedColor(surface)),
+    color: contract ? optionRoleColor(optionColumnRole(column), surface) : optionMutedColor(surface),
+    keepColorWhenSelected: otherHalf,
     backgroundColor,
   };
 }

package/src/plugins/builtin/options/types.ts

@@ -1,6 +1,6 @@
 import type { DataTableColumn } from "../../../components";
 import type { OptionContract } from "../../../types/financials";
-import type { OptionSide, OptionValuation } from "../options-calculator/model";
+import type { OptionSide, OptionValuation } from "../shared/volatility";
 
 export type OptionFieldId =
   | "bid"

package/src/plugins/builtin/options/view.tsx

@@ -1,9 +1,10 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Box, Text, useUiCapabilities } from "../../../ui";
 import { usePaneSettingValue, usePaneTicker, useUpdatePaneSettings } from "../../../state/app/context";
-import { colors } from "../../../theme/colors";
+import { colors, priceColor } from "../../../theme/colors";
 import { isPlainKey } from "../../../utils/keyboard";
-import { formatCompact } from "../../../utils/format";
+import { formatCompact, formatPercentRaw } from "../../../utils/format";
+import { formatMarketPrice, formatSignedMarketPrice, liveQuoteFormatOptions } from "../../../market-data/market/format";
 import { formatExpDate, resolveOptionsTarget } from "../../../utils/options";
 import { canonicalTickerKey } from "../../../utils/exchanges";
 import { useChartQueries, useOptionsQuery, useResolvedEntryValue, useTickerFinancials } from "../../../market-data/hooks";
@@ -29,10 +30,7 @@ import { buildChartKey } from "../../../market-data/selectors";
 import type { ChartRequest } from "../../../market-data/request-types";
 import { quoteSubscriptionTargetFromTicker } from "../../../market-data/request-types";
 import { usePluginAppActions } from "../../runtime";
-import {
-  OPTIONS_CALCULATOR_TEMPLATE_ID,
-  type OptionSide,
-} from "../options-calculator/model";
+import { OPTIONS_CALCULATOR_TEMPLATE_ID } from "../options-calculator/model";
 import { buildChainCalcParams, resolveCalcSide } from "./calc-seed";
 import { useOptionsCatalogue } from "./expiry-catalogue";
 import { calculateOptionGreeks, calculateOptionsSummary, solveChainVolatilities, type OptionsSummary } from "./analytics";
@@ -58,13 +56,14 @@ import {
 } from "./live-quotes";
 import { useOptionsAccessFooter } from "./footer";
 import { AnalyticsAsOfDialog, analyticsAsOfRows } from "./analytics-as-of";
-import { useLiveStreamingSetting } from "../shared/live-streaming";
+import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
 import { signedPositionDirection } from "../portfolio-list/position-metrics";
 import { optionMarketReference } from "./market-reference";
 import { useOptionsEnrichment } from "./enrichment";
 import type { OptionsEnrichmentSnapshot } from "./enrichment-model";
-import { optionMid } from "../shared/volatility";
+import { optionMid, type OptionSide } from "../shared/volatility";
 import type { TickerRecord } from "../../../types/ticker";
+import type { TickerFinancials } from "../../../types/financials";
 import type { IvStats } from "../iv-history/client";
 import { useIvRank } from "../iv-history/rank";
 import { useOptionsSessionOpen, useThrottledValue } from "../shared/volatility/live-session";
@@ -86,8 +85,28 @@ function transientTicker(symbol: string, exchange: string, currency: string): Ti
   return { metadata: { ticker: symbol, exchange, currency, name: symbol, portfolios: [], watchlists: [], positions: [], custom: {}, tags: [] } };
 }
 
+/**
+ * The underlying's price and day change: the level every strike is read
+ * against. A stale quote stays on screen, muted, while the footer says why.
+ */
+function spotItem(underlying: TickerFinancials | null | undefined, assetCategory: string | undefined): StatItem {
+  const quote = underlying?.quote;
+  if (!quote || !Number.isFinite(quote.price)) return { id: "spot", label: "Spot", value: "--" };
+  const options = liveQuoteFormatOptions(quote, quote.currency, assetCategory, underlying?.quoteMetadata?.instrumentType);
+  const change = Number.isFinite(quote.change) ? quote.change : 0;
+  return {
+    id: "spot",
+    label: "Spot",
+    value: formatMarketPrice(quote.price, options),
+    detail: Number.isFinite(quote.change) && Number.isFinite(quote.changePercent)
+      ? `${formatSignedMarketPrice(quote.change, options)} ${formatPercentRaw(quote.changePercent)}` : undefined,
+    color: quote.stale ? colors.textDim : priceColor(change),
+  };
+}
+
 /** The chain's volatility, expected move and flow figures, in the order the stat band reads them. */
-function optionsSummaryItems({ summary, enrichment, currency, ivRank }: {
+function optionsSummaryItems({ spot, summary, enrichment, currency, ivRank }: {
+  spot: StatItem;
   summary: OptionsSummary | null;
   enrichment: OptionsEnrichmentSnapshot | null;
   currency: string;
@@ -106,6 +125,7 @@ function optionsSummaryItems({ summary, enrichment, currency, ivRank }: {
   // The selected expiry is the active choice in the bar above, so the slope names only the one it runs to.
   const slopeTo = enrichment?.neighbourExpiration == null ? undefined : `to ${formatExpDate(enrichment.neighbourExpiration)}`;
   return [
+    spot,
     { id: "atm-iv", label: "ATM IV", value: iv(summary?.atmImpliedVolatility) },
     { id: "hv30", label: "HV30", value: iv(summary?.historicalVolatility30d) },
     { id: "iv-hv", label: "IV/HV", value: formatRatio(summary?.impliedHistoricalRatio) },
@@ -637,6 +657,7 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   // The root insets the terminal body, so the band gets the width inside it.
   const statWidth = Math.max(1, width - (nativePaneChrome ? 0 : 2));
   const statItems = optionsSummaryItems({
+    spot: spotItem(underlying, isOpt ? undefined : ticker.metadata.assetCategory),
     summary, enrichment, currency: underlying?.quote?.currency ?? ticker.metadata.currency ?? "",
     ivRank: showIvRank ? { stats: ivRank } : null,
   });
@@ -699,6 +720,7 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
         onVisibleRangeChange={handleVisibleStrikeRangeChange}
         getItemKey={(row) => String(row.strike)}
         renderCell={renderCell}
+        selectedTextOverridesCellColor
         emptyStateTitle={error && !strikeChain ? "Selected expiration unavailable." : strikesLoading ? "Loading strikes..." : "No strikes available."}
         rootWidth={Math.max(1, width - 2 + inset * 2)}
         rootHeight={tableHeight}