gloomberb 0.18.0 → 0.18.2

package/src/docs/snapshot.json

@@ -1,7 +1,7 @@
 {
  "format": 1,
  "site": "https://gloom.sh",
- "updatedAt": "2026-10-16",
+ "updatedAt": "2026-10-17",
  "categories": [
   {
    "id": "research",
@@ -159,7 +159,7 @@
    "code": "DDIS",
    "name": "Debt maturities",
    "description": "Principal due by year",
-   "detail": "Principal due in the next 12 months, in each of years two to five, and after, from the latest annual filing, with the near-term share ranked against 10 years. History tracks principal and interest expense.",
+   "detail": "Principal due in the next 12 months, in each of years two to five, and after, from the latest annual filing, with the near-term share ranked against 10 years. A newer 10-Q adds its current and non-current debt. History tracks principal and interest expense.",
    "category": "research",
    "arg": "ORCL",
    "shot": "https://gloom.sh/screenshots/fn/DDIS.png",
@@ -480,7 +480,7 @@
    "code": "EXEC",
    "name": "Executives",
    "description": "Officers and pay from the proxy",
-   "detail": "Named executive officers and their compensation, read from the proxy statement and checked against the filing.",
+   "detail": "Named executive officers and their compensation, read from the proxy statement and checked against the filing. Free shows each executive's total pay; Pro adds the breakdown and earlier years.",
    "category": "research",
    "arg": "NVDA",
    "access": "pro",
@@ -695,7 +695,7 @@
    "code": "MOST",
    "name": "Market movers",
    "description": "Gainers, losers, pre-market, gaps",
-   "detail": "Today's top gainers, losers, most active and trending tickers with price, change, volume against average and market cap. Pro adds pre-market and after-hours movers and the gaps at the open.",
+   "detail": "Today's top gainers, losers, most active and trending tickers with price, change, volume against average and market cap, and the pre-market and after-hours movers. Pro adds the gaps at the open.",
    "category": "markets",
    "shot": "https://gloom.sh/screenshots/fn/MOST.png",
    "lesson": "/academy/macro-markets-and-news/markets/movers-highs-halts"
@@ -759,7 +759,7 @@
    "code": "CRYP",
    "name": "Crypto board",
    "description": "Top coins by market cap",
-   "detail": "The top 100 coins by market cap, stablecoins on their own tab, with returns from a day to a year, a 30-day sparkline, volume, and market cap. Prices stream live on every plan where the market allows.",
+   "detail": "The top 100 coins by market cap, with returns from a day to a year, a 30-day sparkline, volume, and market cap. Stablecoins have their own tab: total supply over time stacked by coin, and each coin's supply, 7- and 30-day supply growth and share of the total. Prices stream live on every plan where the market allows.",
    "category": "markets",
    "shot": "https://gloom.sh/screenshots/fn/CRYP.png",
    "lesson": "/academy/crypto-and-prediction-markets/crypto-from-zero"
@@ -777,8 +777,8 @@
   {
    "code": "FUT",
    "name": "Futures board",
-   "description": "Most active futures",
-   "detail": "Each root's most active contract across equity index, rates, energy, metals, agriculture, and FX with last price, unit and session change, grouped by sector, naming the nearer month while it still trades.",
+   "description": "Front-month futures",
+   "detail": "Each root's front contract until its stated roll date across equity index, rates, energy, metals, agriculture, and FX with last price, unit and session change, grouped by sector, naming the day's most active month by volume when it is another one.",
    "category": "markets",
    "shot": "https://gloom.sh/screenshots/fn/FUT.png",
    "lesson": "/academy/futures-commodities-energy/futures-from-zero"
@@ -1186,7 +1186,7 @@
    "code": "CDS",
    "name": "Single-name CDS",
    "description": "Corporate 5Y CDS and trades",
-   "detail": "Single-name corporate CDS. CDS alone lists the issuers traded in the last 5 days with trade count, last trade and 5Y spread, to rank them by; with a ticker or issuer, its 5Y spread (level, date, 1M change, range) and its trades.",
+   "detail": "Single-name corporate CDS. CDS alone lists the issuers traded in the last 5 days with trade count, last trade, 5Y spread and its 1W and 1M moves through the roll while the level is current (points upfront past 2,000 bp), ranked with --sort spread, 1w or 1m; with a ticker or issuer, its 5Y spread (level, date, 1W and 1M change, range), its trades and its daily 5Y levels (--csv --section daily exports them).",
    "category": "macro",
    "arg": "F",
    "shot": "https://gloom.sh/screenshots/fn/CDS.png",
@@ -1229,8 +1229,8 @@
   {
    "code": "TRACE",
    "name": "Corporate bond tape",
-   "description": "Latest corporate and agency sales",
-   "detail": "Latest corporate and agency bond sales: issuer, coupon, price, yield, and grade. TRACE alone lists the tape; TRACE with an issuer filters to that name. It opens the Bonds section of Fixed Income.",
+   "description": "Corporate and agency sales by issuer or CUSIP",
+   "detail": "Latest corporate and agency bond sales: issuer, CUSIP, coupon, maturity, price, yield, and grade. TRACE alone lists the tape; TRACE with an issuer name, a bond symbol root, a stock ticker, or a CUSIP finds that issuer's outstanding bonds. It opens the Bonds section of Fixed Income.",
    "category": "macro",
    "arg": "issuer"
   },
@@ -1299,8 +1299,8 @@
   {
    "code": "INS",
    "name": "Insider transactions",
-   "description": "Form 4 activity and insider buying",
-   "detail": "Insider buys, sells, awards, and gifts from Form 4 filings with insider name, size, and price. Alone it ranks the companies whose insiders are buying in the market, with why: clusters, repeat buys, size against their usual. US equities only.",
+   "description": "Form 4 activity, insider buying and selling",
+   "detail": "Insider buys, sells, awards, and gifts from Form 4 filings with insider name, size, and price. Alone it ranks the companies whose insiders are buying, or selling, in the market, with why: clusters, repeat trades, size against their usual, the stake added or sold. Filters by role, size, cluster, new or exited positions and market cap. US equities only.",
    "category": "ownership",
    "arg": "NVDA",
    "shot": "https://gloom.sh/screenshots/fn/INS.png",
@@ -1401,9 +1401,9 @@
   },
   {
    "code": "ALRT",
-   "name": "Price alerts",
-   "description": "Price triggers",
-   "detail": "Your price alerts with current price, distance to target, and trigger state.",
+   "name": "Alerts",
+   "description": "Price, earnings, filing, news and flow alerts",
+   "detail": "Price alerts with current price, distance to target, and trigger state, plus alerts on earnings, CPI and FOMC dates, filings and 13F, news keywords, analyst changes, 52-week highs and lows, unusual volume, short interest, insider and congress trades, catalysts, IV spikes, options flow, and perps.",
    "category": "workspace",
    "shot": "https://gloom.sh/screenshots/fn/ALRT.png",
    "lesson": "/academy/terminal-and-workspace/your-workspace/alerts"
@@ -2407,9 +2407,14 @@
     "drift",
     "rebalance",
     "weights",
-    "glossary"
+    "glossary",
+    "dividend income",
+    "yield",
+    "DRIP",
+    "reinvest",
+    "DVD"
    ],
-   "updatedAt": "2026-10-12",
+   "updatedAt": "2026-10-17",
    "blocks": [
     {
      "type": "heading",
@@ -2493,6 +2498,31 @@
       }
      ]
     },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Dividend income"
+    },
+    {
+     "type": "paragraph",
+     "text": "`gloomberb portfolio show Core` also lists what each share or fund pays a year: its trailing twelve months of dividends per share times the shares you hold, in the portfolio's currency, and that as a yield on the holding's value. The TOTAL row gives the portfolio's income and its yield on the whole portfolio, cash included. A holding whose dividends could not be read shows `—`, and so does the total, never $0."
+    },
+    {
+     "type": "paragraph",
+     "text": "To see what reinvesting them adds, ask for a DRIP projection:"
+    },
+    {
+     "type": "code",
+     "code": "gloomberb portfolio show Core --drip --years 3 --withholding 15"
+    },
+    {
+     "type": "paragraph",
+     "text": "Each year the shares you hold pay today's dividend, the withholding comes off, and the rest buys shares at today's price. The table gives each holding's shares now and after the last year, and the income each year, net of withholding. `--years` takes 1 to 5."
+    },
+    {
+     "type": "paragraph",
+     "text": "To compare payers before you buy, rank them by yield with payout and growth: `gloomberb fn DVD KO PEP JNJ`."
+    },
     {
      "type": "details",
      "summary": "Fine print",
@@ -2501,6 +2531,7 @@
        "type": "list",
        "items": [
         "Targets need not add up to 100%; the report says what is unallocated.",
+        "Income uses trailing dividends, not announced ones. DRIP holds dividends, prices and exchange rates where they are today and reinvests once a year; it is an illustration, not a forecast.",
         "Trades use the current price and leave out fees, taxes and lot sizes.",
         "A broker portfolio uses the cash its account reports.",
         "In the PF pane the columns read `WEIGHT`, `TGT WT`, `DRIFT` and `TRADE`."
@@ -2510,7 +2541,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Related: [PF](/docs/functions#pf), [CLI](/docs/cli-functions#portfolios-and-notes)."
+     "text": "Related: [PF](/docs/functions#pf), [CLI](/docs/cli-functions#portfolios-and-notes). Methodology: [dividend income and DRIP](https://github.com/gloom-sh/gloomberb/blob/main/docs/research-data.md#portfolio-income-and-drip)."
     }
    ]
   },
@@ -5273,6 +5304,10 @@
        "`financials`, `fundamentals`, `valuation`, `events`, `analyst` `<symbol>`",
        "Revenue and EPS, profile, multiples, dividends and splits, ratings and targets"
       ],
+      [
+       "`fn DVD <symbols>`",
+       "Dividend yield and history; several symbols rank in one table by yield, with payout, growth, last ex-date and pay date"
+      ],
       [
        "`holders`, `insider`, `13f`, `filings` `<symbol>`",
        "Holders, insiders, institutions and funds, SEC filings"
@@ -5335,7 +5370,7 @@
      "rows": [
       [
        "`portfolio list|show|create|delete <name>`",
-       "Manual portfolios; `show` lists value, weight, target, drift and the trade to rebalance, and `show --explain` adds what those terms mean"
+       "Manual portfolios; `show` lists value, weight, a year of dividend income and its yield, target, drift and the trade to rebalance; `show --explain` adds what those terms mean, and `show --drip [--years 1-5] [--withholding <pct>]` projects reinvested dividends"
       ],
       [
        "`portfolio add|remove <portfolio> <symbols...> [--file <csv|txt>]`",
@@ -5453,7 +5488,7 @@
     },
     {
      "type": "paragraph",
-     "text": "`gloomberb catalog <function>` lists a function's options. `shot` also takes `--tab <id>`."
+     "text": "`gloomberb catalog <function>` lists a function's options. `shot` also takes `--tab <id>`. `shot` draws a function's options as its pane does: `gloomberb shot 13F 0001067983 --compare SPY` opens the fund's overlap with SPY. An option only the text report reads, such as `--limit`, fails `shot` with exit 1 and names the `fn` command that reads it, instead of saving the pane without it."
     },
     {
      "type": "paragraph",
@@ -7546,7 +7581,7 @@
   {
    "url": "/academy/futures-commodities-energy/futures-from-zero",
    "title": "Futures from zero (FUT)",
-   "summary": "A futures contract is a standard, exchange-traded promise to buy or sell a set quantity on a set month at a price agreed today, settled with daily margin, and FUT shows the most active months across markets.",
+   "summary": "A futures contract is a standard, exchange-traded promise to buy or sell a set quantity on a set month at a price agreed today, settled with daily margin, and FUT shows each market's front month.",
    "chapter": "Futures, commodities and energy",
    "minutes": 5
   },
@@ -7646,7 +7681,7 @@
    "title": "Credit default swaps (CDS, CDX, SOVR)",
    "summary": "A credit default swap is insurance on a borrower's default, and CDS, CDX and SOVR show reported trades on companies, the main indices and 5-year country spreads.",
    "chapter": "Rates, bonds and credit",
-   "minutes": 4
+   "minutes": 5
   },
   {
    "url": "/academy/rates-bonds-credit/credit/debt-and-covenants",

package/src/i18n/es.ts

@@ -380,8 +380,7 @@ export const es: Record<string, string> = {
   "Insider transactions for a ticker; alone, the companies whose insiders are buying or selling.": "Operaciones de insiders de un ticker; sin ticker, las empresas cuyos insiders están comprando o vendiendo.",
   "Recent SEC filings for US equities": "Presentaciones recientes ante la SEC de acciones de EE. UU.",
   "Recent SEC filings for the selected ticker.": "Presentaciones recientes ante la SEC del ticker seleccionado.",
-  "Price trigger alerts with desktop notifications": "Alertas de precio con notificaciones de escritorio",
-  "Price trigger alerts with notifications": "Alertas de precio con notificaciones",
+  "Price, earnings, filing, news and flow alerts": "Alertas de precio, resultados, presentaciones, noticias y flujo de opciones",
   "Create a price alert from a symbol, condition, and target price": "Crear una alerta de precio con símbolo, condición y precio objetivo",
   "Public market heatmap for the largest US stocks and ETFs.": "Mapa de calor de las mayores acciones y ETF de EE. UU.",
   "Top gainers, losers, most active, and trending tickers": "Mayores alzas, bajas, más activos y tickers en tendencia",
@@ -665,7 +664,7 @@ export const es: Record<string, string> = {
   "Real-time": "Tiempo real",
   "real-time options": "opciones en tiempo real",
   "mixed real-time and delayed options": "opciones mixtas en tiempo real y diferidas",
-  "options delayed fallback": "respaldo diferido de opciones",
+  "Delayed options quotes, real-time stream unavailable": "Cotizaciones de opciones diferidas, flujo en tiempo real no disponible",
   "crossed quote": "cotización cruzada",
   "one-sided quote": "cotización unilateral",
   "no bid/ask": "sin compra/venta",
@@ -1626,4 +1625,11 @@ export const es: Record<string, string> = {
   "It is kept once it has been read with a connection.": "Se guarda al leerla una vez con conexión.",
   "Academy: {title}": "Academia: {title}",
   "{minutes} min": "{minutes} min",
+  "Delisted {date}": "Excluida de bolsa el {date}",
+  "Last traded {date}": "Última negociación el {date}",
+  "Account data": "Datos de la cuenta",
+  "Sync with Gloom Cloud": "Sincronizar con Gloom Cloud",
+  "Keep on this device": "Mantener en este dispositivo",
+  "Daily roundups, the weekly brief, position alerts, the mobile app and Ask Gloom will go without this account.": "Los resúmenes diarios, el informe semanal, las alertas de posiciones, la app móvil y Ask Gloom no incluirán esta cuenta.",
+  "Account data stays on this device, out of Gloom Cloud": "Los datos de la cuenta se quedan en este dispositivo, fuera de Gloom Cloud",
 };

package/src/i18n/ja.ts

@@ -381,8 +381,7 @@ export const ja: Record<string, string> = {
   "Insider transactions for a ticker; alone, the companies whose insiders are buying or selling.": "銘柄のインサイダー取引。銘柄を指定しないと、インサイダーが買っている、または売っている企業の一覧。",
   "Recent SEC filings for US equities": "米国株の最新 SEC 開示",
   "Recent SEC filings for the selected ticker.": "選択した銘柄の最新 SEC 開示。",
-  "Price trigger alerts with desktop notifications": "デスクトップ通知による価格トリガーアラート",
-  "Price trigger alerts with notifications": "通知付きの価格トリガーアラート",
+  "Price, earnings, filing, news and flow alerts": "価格、決算、開示、ニュース、オプションフローのアラート",
   "Create a price alert from a symbol, condition, and target price": "銘柄コード、条件、目標価格から価格アラートを作成",
   "Public market heatmap for the largest US stocks and ETFs.": "米国大型株と ETF の市場ヒートマップ。",
   "Top gainers, losers, most active, and trending tickers": "値上がり、値下がり、出来高、注目銘柄",
@@ -679,7 +678,7 @@ export const ja: Record<string, string> = {
   "Go Pro for real-time data at gloom.sh/cloud, free for 7 days.": "gloom.sh/cloud で Pro にアップグレードするとリアルタイムデータを 7 日間無料で利用できます。",
   "real-time options": "リアルタイムオプション",
   "mixed real-time and delayed options": "リアルタイムと遅延の混在オプション",
-  "options delayed fallback": "オプション遅延フォールバック",
+  "Delayed options quotes, real-time stream unavailable": "オプション気配値は遅延中、リアルタイム配信は利用できません",
   "crossed quote": "クロス気配",
   "one-sided quote": "片側気配",
   "no bid/ask": "気配なし",
@@ -1622,4 +1621,11 @@ export const ja: Record<string, string> = {
   "It is kept once it has been read with a connection.": "一度オンラインで読むと保存されます。",
   "Academy: {title}": "アカデミー: {title}",
   "{minutes} min": "{minutes} 分",
+  "Delisted {date}": "上場廃止 {date}",
+  "Last traded {date}": "最終取引 {date}",
+  "Account data": "口座データ",
+  "Sync with Gloom Cloud": "Gloom Cloud と同期",
+  "Keep on this device": "このデバイスに保存",
+  "Daily roundups, the weekly brief, position alerts, the mobile app and Ask Gloom will go without this account.": "デイリーまとめ、週次ブリーフ、ポジションアラート、モバイルアプリ、Ask Gloom にはこの口座が含まれなくなります。",
+  "Account data stays on this device, out of Gloom Cloud": "口座データはこのデバイスに保存され、Gloom Cloud には送られません",
 };

package/src/i18n/ko.ts

@@ -379,8 +379,7 @@ export const ko: Record<string, string> = {
   "Insider transactions for a ticker; alone, the companies whose insiders are buying or selling.": "종목의 내부자 거래. 종목 없이 열면 내부자가 매수 또는 매도 중인 기업 목록.",
   "Recent SEC filings for US equities": "미국 주식의 최신 SEC 공시",
   "Recent SEC filings for the selected ticker.": "선택 종목의 최신 SEC 공시.",
-  "Price trigger alerts with desktop notifications": "데스크톱 알림이 있는 목표가 알림",
-  "Price trigger alerts with notifications": "알림이 있는 목표가 알림",
+  "Price, earnings, filing, news and flow alerts": "가격, 실적, 공시, 뉴스, 옵션 플로우 알림",
   "Create a price alert from a symbol, condition, and target price": "종목코드, 조건 및 목표가로 가격 알림 생성",
   "Public market heatmap for the largest US stocks and ETFs.": "미국 대형주 및 ETF 시장 히트맵.",
   "Top gainers, losers, most active, and trending tickers": "상승률·하락률·거래량 상위 및 인기 종목",
@@ -677,7 +676,7 @@ export const ko: Record<string, string> = {
   "Go Pro for real-time data at gloom.sh/cloud, free for 7 days.": "gloom.sh/cloud에서 Pro로 업그레이드하면 실시간 데이터를 7일간 무료로 사용할 수 있습니다.",
   "real-time options": "실시간 옵션",
   "mixed real-time and delayed options": "실시간 및 지연 옵션 혼합",
-  "options delayed fallback": "옵션 지연 대체 데이터",
+  "Delayed options quotes, real-time stream unavailable": "옵션 시세 지연, 실시간 스트림 사용 불가",
   "crossed quote": "교차 호가",
   "one-sided quote": "일방 호가",
   "no bid/ask": "호가 없음",
@@ -1620,4 +1619,11 @@ export const ko: Record<string, string> = {
   "It is kept once it has been read with a connection.": "연결된 상태에서 한 번 읽으면 저장됩니다.",
   "Academy: {title}": "아카데미: {title}",
   "{minutes} min": "{minutes}분",
+  "Delisted {date}": "상장폐지 {date}",
+  "Last traded {date}": "최종 거래 {date}",
+  "Account data": "계좌 데이터",
+  "Sync with Gloom Cloud": "Gloom Cloud와 동기화",
+  "Keep on this device": "이 기기에 보관",
+  "Daily roundups, the weekly brief, position alerts, the mobile app and Ask Gloom will go without this account.": "일일 요약, 주간 브리핑, 포지션 알림, 모바일 앱, Ask Gloom에 이 계좌가 포함되지 않습니다.",
+  "Account data stays on this device, out of Gloom Cloud": "계좌 데이터는 Gloom Cloud에 올라가지 않고 이 기기에 남습니다",
 };

package/src/i18n/zh-cn.ts

@@ -328,7 +328,7 @@ export const zhCN: Record<string, string> = {
   "Insider Trading": "内部人交易",
   "SEC": "SEC 文件",
   "Notes": "笔记",
-  "Alerts": "价格提醒",
+  "Alerts": "提醒",
   "Market Heatmap": "市场热力图",
   "Market Movers": "市场异动",
   "Sector Performance": "板块表现",
@@ -381,8 +381,7 @@ export const zhCN: Record<string, string> = {
   "Insider transactions for a ticker; alone, the companies whose insiders are buying or selling.": "某只股票的内部人交易；不指定股票时，列出内部人正在买入或卖出的公司。",
   "Recent SEC filings for US equities": "美股最新 SEC 申报文件",
   "Recent SEC filings for the selected ticker.": "所选股票的最新 SEC 申报文件。",
-  "Price trigger alerts with desktop notifications": "带桌面通知的价格触发提醒",
-  "Price trigger alerts with notifications": "带通知的价格触发提醒",
+  "Price, earnings, filing, news and flow alerts": "价格、财报、申报文件、新闻和期权资金流提醒",
   "Create a price alert from a symbol, condition, and target price": "用代码、条件和目标价创建价格提醒",
   "Public market heatmap for the largest US stocks and ETFs.": "美股大盘股与 ETF 的市场热力图。",
   "Top gainers, losers, most active, and trending tickers": "涨幅榜、跌幅榜、成交活跃与热门股票",
@@ -679,7 +678,7 @@ export const zhCN: Record<string, string> = {
   "Go Pro for real-time data at gloom.sh/cloud, free for 7 days.": "在 gloom.sh/cloud 升级 Pro 获取实时数据，免费试用 7 天。",
   "real-time options": "实时期权",
   "mixed real-time and delayed options": "实时与延迟期权混合",
-  "options delayed fallback": "期权延迟备用数据",
+  "Delayed options quotes, real-time stream unavailable": "期权报价延迟，实时数据流不可用",
   "crossed quote": "交叉报价",
   "one-sided quote": "单边报价",
   "no bid/ask": "无买卖报价",
@@ -1622,4 +1621,11 @@ export const zhCN: Record<string, string> = {
   "It is kept once it has been read with a connection.": "联网阅读过一次后即会保存。",
   "Academy: {title}": "学院：{title}",
   "{minutes} min": "{minutes} 分钟",
+  "Delisted {date}": "已退市 {date}",
+  "Last traded {date}": "最后交易 {date}",
+  "Account data": "账户数据",
+  "Sync with Gloom Cloud": "与 Gloom Cloud 同步",
+  "Keep on this device": "保留在此设备上",
+  "Daily roundups, the weekly brief, position alerts, the mobile app and Ask Gloom will go without this account.": "每日汇总、每周简报、持仓提醒、移动应用和 Ask Gloom 将不再包含此账户。",
+  "Account data stays on this device, out of Gloom Cloud": "账户数据保留在此设备上，不上传到 Gloom Cloud",
 };

package/src/i18n/zh-tw.ts

@@ -328,7 +328,7 @@ export const zhTW: Record<string, string> = {
   "Insider Trading": "內部人士交易",
   "SEC": "SEC 申報",
   "Notes": "筆記",
-  "Alerts": "價格提醒",
+  "Alerts": "提醒",
   "Market Heatmap": "市場熱力圖",
   "Market Movers": "市場異動",
   "Sector Performance": "類股表現",
@@ -381,8 +381,7 @@ export const zhTW: Record<string, string> = {
   "Insider transactions for a ticker; alone, the companies whose insiders are buying or selling.": "某檔股票的內部人士交易；不指定股票時，列出內部人士正在買進或賣出的公司。",
   "Recent SEC filings for US equities": "美股最新 SEC 申報檔案",
   "Recent SEC filings for the selected ticker.": "所選股票的最新 SEC 申報檔案。",
-  "Price trigger alerts with desktop notifications": "透過桌面通知的價格觸發提醒",
-  "Price trigger alerts with notifications": "透過通知的價格觸發提醒",
+  "Price, earnings, filing, news and flow alerts": "價格、財報、申報文件、新聞與選擇權資金流提醒",
   "Create a price alert from a symbol, condition, and target price": "用代號、條件和目標價建立價格提醒",
   "Public market heatmap for the largest US stocks and ETFs.": "美股大盤股與 ETF 的市場熱力圖。",
   "Top gainers, losers, most active, and trending tickers": "漲幅榜、跌幅榜、成交活躍與熱門股票",
@@ -679,7 +678,7 @@ export const zhTW: Record<string, string> = {
   "Go Pro for real-time data at gloom.sh/cloud, free for 7 days.": "在 gloom.sh/cloud 升級 Pro 取得即時資料，免費試用 7 天。",
   "real-time options": "即時選擇權",
   "mixed real-time and delayed options": "即時與延遲選擇權混合",
-  "options delayed fallback": "選擇權延遲備援資料",
+  "Delayed options quotes, real-time stream unavailable": "選擇權報價延遲，即時資料流無法使用",
   "crossed quote": "交叉報價",
   "one-sided quote": "單邊報價",
   "no bid/ask": "無買賣報價",
@@ -1622,4 +1621,11 @@ export const zhTW: Record<string, string> = {
   "It is kept once it has been read with a connection.": "連線閱讀過一次後就會儲存。",
   "Academy: {title}": "學院：{title}",
   "{minutes} min": "{minutes} 分鐘",
+  "Delisted {date}": "已下市 {date}",
+  "Last traded {date}": "最後交易 {date}",
+  "Account data": "帳戶資料",
+  "Sync with Gloom Cloud": "與 Gloom Cloud 同步",
+  "Keep on this device": "保留在此裝置上",
+  "Daily roundups, the weekly brief, position alerts, the mobile app and Ask Gloom will go without this account.": "每日摘要、每週簡報、持倉提醒、行動應用程式和 Ask Gloom 將不再包含此帳戶。",
+  "Account data stays on this device, out of Gloom Cloud": "帳戶資料保留在此裝置上，不上傳至 Gloom Cloud",
 };

package/src/market-data/commodity-names.ts

@@ -0,0 +1,80 @@
+import { futuresContractByCode, type FuturesContract } from "./futures-board";
+
+/**
+ * The names a reader types for the commodities on the futures board, by the
+ * board code they trade under. A news search that names one ("arabica",
+ * "sugar prices") offers the future's own news route (news KC=F), and a
+ * future's news searches the stories of its commodity by the first name
+ * listed for its code (KC=F reads "coffee"): news is filed under companies,
+ * and the service matches the same names to the stories filed under each
+ * future. Longer names win where one holds another ("soybean oil", "oil"),
+ * and a name in any of its forms counts (hogs, soybeans), as the service
+ * reads it. A null code is an oil no future trades: "palm oil" is not crude.
+ */
+const COMMODITY_NAMES: ReadonlyArray<readonly [name: string, code: string | null]> = [
+  ["coffee", "KC"], ["arabica", "KC"],
+  ["sugar", "SB"], ["cocoa", "CC"], ["cotton", "CT"], ["orange juice", "OJ"], ["lumber", "LBR"],
+  ["wheat", "ZW"], ["wheat", "KE"], ["corn", "ZC"],
+  ["soybean", "ZS"], ["soy", "ZS"], ["soybean meal", "ZM"], ["soybean oil", "ZL"], ["soy oil", "ZL"],
+  // Cattle finds the ranchers' and packers' stories "live cattle" misses; a bare "hog" finds Harley-Davidson (HOG).
+  ["cattle", "LE"], ["live cattle", "LE"], ["lean hog", "HE"], ["hog", "HE"],
+  ["gold", "GC"], ["silver", "SI"], ["copper", "HG"], ["platinum", "PL"], ["palladium", "PA"],
+  ["aluminum", "ALI"], ["aluminium", "ALI"],
+  ["oil", "CL"], ["crude oil", "CL"], ["crude", "CL"], ["wti", "CL"], ["oil", "QM"], ["oil", "MCL"],
+  ["brent", "BZ"], ["heating oil", "HO"], ["gasoline", "RB"],
+  ["natural gas", "NG"], ["natgas", "NG"], ["natural gas", "QG"], ["natural gas", "MNG"], ["natural gas", "HH"],
+  ...["palm", "olive", "cooking", "vegetable", "corn", "edible", "sunflower", "canola", "rapeseed", "coconut", "peanut", "sesame",
+    "avocado", "cottonseed", "linseed", "flaxseed", "fish", "castor", "essential", "hemp", "cbd", "motor", "engine",
+    "lubricating", "baby", "snake"].map((kind) => [`${kind} oil`, null] as const),
+];
+
+/** Words that end in s without being plurals, as the service keeps them whole. */
+const NOT_PLURAL = new Set(["news", "series", "species"]);
+
+/**
+ * A word and its simple singular or plural, as the service's search reads a
+ * word: hogs and hog, soybeans and soybean, gases and gas.
+ */
+function wordForms(word: string): string[] {
+  if (!/^\p{L}+$/u.test(word) || NOT_PLURAL.has(word)) return [word];
+  if (word.length > 3 && word.endsWith("s") && !/(ss|us|is)$/.test(word)) {
+    const singulars = [word.slice(0, -1)];
+    if (word.length > 4 && word.endsWith("ies")) singulars.push(`${word.slice(0, -3)}y`);
+    else if (/(s|x|z|ch|sh)es$/.test(word)) singulars.push(word.slice(0, -2));
+    return [word, ...singulars];
+  }
+  if (word.length < 3) return [word];
+  const plural = /[^aeiou]y$/.test(word) ? `${word.slice(0, -1)}ies` : /(s|x|z|ch|sh)$/.test(word) ? `${word}es` : `${word}s`;
+  return [word, plural];
+}
+
+const PHRASES = COMMODITY_NAMES.map(([name, code]) => ({ words: name.split(" "), code }))
+  .sort((a, b) => b.words.length - a.words.length);
+
+/** The words of a text as the service reads them: lower case, split on anything but letters and digits. */
+const words = (text: string) => text.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+
+/** Whether the typed words are the name's, each in any of its forms. */
+const sameWords = (typed: readonly string[], name: readonly string[]) => typed.length === name.length
+  && name.every((word, index) => wordForms(typed[index]!).includes(word));
+
+/** The first commodity a text names, as its future on the board: "arabica" and "sugar prices" name KC and SB; "palm oil" names none. */
+export function commodityNamedIn(text: string): FuturesContract | null {
+  const typed = words(text);
+  for (let index = 0; index < typed.length;) {
+    const phrase = PHRASES.find((entry) => sameWords(typed.slice(index, index + entry.words.length), entry.words));
+    if (phrase?.code) return futuresContractByCode(phrase.code);
+    index += phrase?.words.length ?? 1;
+  }
+  return null;
+}
+
+/** Whether the text is only a commodity's name, in any of its forms: "soybeans" searches what "soybean" does. */
+export function isCommodityName(text: string, name: string): boolean {
+  return sameWords(words(text), words(name));
+}
+
+/** The name a future's stories are searched by: coffee for KC=F, wheat for ZW=F and KE=F. Null for a future with no commodity name (indices, rates, currencies, TTF). */
+export function commoditySearchName(contract: Pick<FuturesContract, "code">): string | null {
+  return COMMODITY_NAMES.find(([, code]) => code === contract.code)?.[0] ?? null;
+}

package/src/market-data/coordinator/auxiliary.ts

@@ -66,11 +66,13 @@ export function loadOptionsEntry(options: {
         const attempt = createAttempt(dataProvider.id, startedAt, "unsupported", "UNSUPPORTED_RANGE", "Options are not available");
         return store.update(key, (current) => errorEntry(current, attempt));
       }
+      // This path has no handle on the provider's cache, so a refresh it asks for must reach the source, and a
+      // stored chain past its stale time (kept for two days) is refetched rather than shown as current.
       const data = await dataProvider.getOptionsChain(
         request.instrument.symbol,
         request.instrument.exchange ?? "",
         request.expirationDate,
-        toMarketDataContext(request.instrument),
+        { ...toMarketDataContext(request.instrument), cacheMode: forceRefresh ? "refresh" : "current" },
       );
       const attempts = [createAttempt(dataProvider.id, startedAt, data.expirationDates.length > 0 ? "success" : "empty", data.expirationDates.length === 0 ? "NO_DATA" : undefined)];
       return store.update(key, (current) => ({

package/src/market-data/coordinator/chart.ts

@@ -61,8 +61,10 @@ export function normalizeFreshChartData(
     : request.granularity === "detail" ? request.barSize : undefined;
   const session = parseHistorySession(history?.session, { symbol: target.symbol, exchange: target.exchange ?? "",
     interval: interval ?? undefined }) ?? undefined;
+  // A listing that no longer trades ends on its last session for good.
   if (
-    isIntradayChartRequest(request, history)
+    !history?.delisting
+    && isIntradayChartRequest(request, history)
     && isPriceHistoryStaleForCurrentWindow(normalized, Date.now(), { symbol: target.symbol, exchange: target.exchange,
       intervalMs: interval ? priceHistoryIntervalMs(interval) : undefined, session, fetchedAt: fetchedAt ?? undefined })
   ) {

package/src/market-data/futures-board.ts

@@ -45,6 +45,8 @@ export interface FuturesContract {
    * index, and RS1, MES, MYM, M2K, MCL, MNG and HH are listed abroad.
    */
   bareCode?: true;
+  /** Everyday names the board's own does not hold: oil is WTI crude, not heating or soybean oil. */
+  aliases?: readonly string[];
 }
 
 /** 0.005 -> 3, 0.25 -> 2, 1 -> 0. Written for ticks, not general numbers. */
@@ -100,7 +102,7 @@ export const FUTURES_CONTRACTS: FuturesContract[] = [
   { symbol: "ZB=F", code: "ZB", name: "30-Year T-Bond", sector: "rates", venue: "CBT", bareCode: true },
   { symbol: "UB=F", code: "UB", name: "Ultra T-Bond", sector: "rates", venue: "CBT", bareCode: true },
 
-  { symbol: "CL=F", code: "CL", name: "WTI Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01 },
+  { symbol: "CL=F", code: "CL", name: "WTI Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01, aliases: ["oil"] },
   { symbol: "BZ=F", code: "BZ", name: "Brent Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01 },
   { symbol: "NG=F", code: "NG", name: "Natural Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001 },
   // Quoted in euros per MWh.
@@ -197,6 +199,41 @@ export function futuresBoardContract(value: unknown): FuturesContract | null {
   return BY_SYMBOL.get(typed(value)) ?? futuresContractByCode(value);
 }
 
+const nameWords = (text: string) => text.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+
+/**
+ * The item a typed name means: every word of it starts a word of the item's
+ * name ("orange juice", "sugar" for Sugar #11, "soybean" for Soybeans). Among
+ * those that match, the name with the fewest other words wins, then the
+ * list's order: "crude" is WTI before Brent and the micro, "yen" the Japanese
+ * yen before the Nikkei quoted in yen. A name of fewer than three letters
+ * matches nothing, so a slip of a code does not land on a random row.
+ */
+export function bestNameMatch<T>(items: readonly T[], names: (item: T) => readonly string[], value: unknown): T | null {
+  const wanted = typeof value === "string" ? nameWords(value) : [];
+  if (wanted.join("").length < 3) return null;
+  let best: T | null = null;
+  let fewest = Number.POSITIVE_INFINITY;
+  for (const item of items) {
+    for (const name of names(item)) {
+      const have = nameWords(name);
+      if (have.length >= fewest || !wanted.every((word) => have.some((part) => part.startsWith(word)))) continue;
+      best = item;
+      fewest = have.length;
+    }
+  }
+  return best;
+}
+
+/**
+ * The board row a commodity's name stands for, as a reader types it into a
+ * futures function: cocoa, coffee, sugar, cotton, orange juice, gold, copper,
+ * crude, natural gas. Codes and symbols are `futuresBoardContract`'s.
+ */
+export function futuresContractByName(value: unknown): FuturesContract | null {
+  return bestNameMatch(FUTURES_CONTRACTS, (contract) => [contract.name, ...contract.aliases ?? []], value);
+}
+
 /**
  * The future a bare symbol typed for a security stands for: a code no listed
  * security answers to (TTF is TTF=F). Null for every other symbol, and for a