gloomberb 0.10.0 → 0.10.2

package/src/data/resource-store.ts

@@ -6,6 +6,11 @@ import { trySqliteBusyOperation, withSqliteBusyRetry } from "./sqlite/retry";
 
 const RESOURCE_CACHE_SOFT_ROW_LIMIT = 25_000;
 const RESOURCE_CACHE_SOFT_SIZE_LIMIT = 100 * 1024 * 1024;
+const RESOURCE_CACHE_MAINTENANCE_WRITE_INTERVAL = 250;
+const RESOURCE_CACHE_MAINTENANCE_BYTE_INTERVAL = Math.floor(
+  RESOURCE_CACHE_SOFT_SIZE_LIMIT / RESOURCE_CACHE_MAINTENANCE_WRITE_INTERVAL,
+);
+const RESOURCE_CACHE_MAINTENANCE_TIME_INTERVAL_MS = 5 * 60_000;
 const DEFAULT_RESOURCE_SCHEMA_VERSION = 1;
 const EMPTY_VARIANT_KEY = "";
 const EMPTY_SOURCE_KEY = "";
@@ -89,6 +94,10 @@ function sortRows(rows: ResourceCacheRow[]): ResourceCacheRow[] {
 }
 
 export class ResourceStore {
+  private writesSinceMaintenance = 0;
+  private bytesWrittenSinceMaintenance = 0;
+  private lastMaintenanceAt = 0;
+
   constructor(private readonly db: Database) {}
 
   private toCachedResource<T>(row: ResourceCacheRow): CachedResourceRecord<T> | null {
@@ -179,17 +188,38 @@ export class ResourceStore {
     const remainingSize = remaining?.total_size ?? 0;
     if (remainingCount <= RESOURCE_CACHE_SOFT_ROW_LIMIT && remainingSize <= RESOURCE_CACHE_SOFT_SIZE_LIMIT) return;
 
-    const rowsToDelete = withSqliteBusyRetry("select cached resources to prune", () => (
+    const pruneCandidates = withSqliteBusyRetry("select cached resources to prune", () => (
       this.db
-        .query<{ namespace: string; kind: string; entity_key: string; variant_key: string; source_key: string }, [number]>(
-          `SELECT namespace, kind, entity_key, variant_key, source_key
+        .query<{
+          namespace: string;
+          kind: string;
+          entity_key: string;
+          variant_key: string;
+          source_key: string;
+          size_bytes: number;
+        }, []>(
+          `SELECT namespace, kind, entity_key, variant_key, source_key, size_bytes
            FROM resource_cache
-           ORDER BY last_accessed_at ASC, fetched_at ASC
-           LIMIT ?`,
+           ORDER BY last_accessed_at ASC, fetched_at ASC`,
         )
-        .all(Math.max(Math.ceil((remainingCount - RESOURCE_CACHE_SOFT_ROW_LIMIT) + 250), 250))
+        .all()
     ));
 
+    let projectedCount = remainingCount;
+    let projectedSize = remainingSize;
+    const rowsToDelete = [] as typeof pruneCandidates;
+    for (const row of pruneCandidates) {
+      if (
+        projectedCount <= RESOURCE_CACHE_SOFT_ROW_LIMIT
+        && projectedSize <= RESOURCE_CACHE_SOFT_SIZE_LIMIT
+      ) {
+        break;
+      }
+      rowsToDelete.push(row);
+      projectedCount -= 1;
+      projectedSize -= row.size_bytes;
+    }
+
     if (rowsToDelete.length === 0) return;
     withSqliteBusyRetry("prune least recently used cached resources", () => {
       const remove = this.db.query(
@@ -205,6 +235,21 @@ export class ResourceStore {
     });
   }
 
+  private maintainCacheAfterWrite(now: number, sizeBytes: number): void {
+    this.writesSinceMaintenance += 1;
+    this.bytesWrittenSinceMaintenance += sizeBytes;
+    const maintenanceDue = this.lastMaintenanceAt === 0
+      || this.writesSinceMaintenance >= RESOURCE_CACHE_MAINTENANCE_WRITE_INTERVAL
+      || this.bytesWrittenSinceMaintenance >= RESOURCE_CACHE_MAINTENANCE_BYTE_INTERVAL
+      || now - this.lastMaintenanceAt >= RESOURCE_CACHE_MAINTENANCE_TIME_INTERVAL_MS;
+    if (!maintenanceDue) return;
+
+    this.pruneIfNeeded();
+    this.writesSinceMaintenance = 0;
+    this.bytesWrittenSinceMaintenance = 0;
+    this.lastMaintenanceAt = now;
+  }
+
   get<T>(key: ResourceCacheKey, options: GetResourceOptions = {}): CachedResourceRecord<T> | null {
     const row = withSqliteBusyRetry("load cached resource", () => (
       this.db
@@ -304,6 +349,10 @@ export class ResourceStore {
     const now = options.fetchedAt ?? Date.now();
     const payload = serializeJson(value);
     const provenance = options.provenance == null ? null : serializeJson(options.provenance);
+    const schemaVersion = options.schemaVersion ?? DEFAULT_RESOURCE_SCHEMA_VERSION;
+    const staleAt = now + options.cachePolicy.staleMs;
+    const expiresAt = now + options.cachePolicy.expireMs;
+    const sizeBytes = Buffer.byteLength(payload, "utf8");
     const rowKey = {
       namespace: key.namespace,
       kind: key.kind,
@@ -326,19 +375,31 @@ export class ResourceStore {
           rowKey.entityKey,
           rowKey.variantKey,
           rowKey.sourceKey,
-          options.schemaVersion ?? DEFAULT_RESOURCE_SCHEMA_VERSION,
+          schemaVersion,
           payload,
           provenance,
           now,
-          now + options.cachePolicy.staleMs,
-          now + options.cachePolicy.expireMs,
+          staleAt,
+          expiresAt,
           now,
-          Buffer.byteLength(payload, "utf8"),
+          sizeBytes,
         );
     });
 
-    this.pruneIfNeeded();
-    return this.get<T>(rowKey, { allowExpired: true, touch: false })!;
+    this.maintainCacheAfterWrite(Date.now(), sizeBytes);
+    return {
+      ...rowKey,
+      value: JSON.parse(payload) as T,
+      schemaVersion,
+      provenance: provenance == null ? null : JSON.parse(provenance) as JsonValue,
+      fetchedAt: now,
+      staleAt,
+      expiresAt,
+      lastAccessedAt: now,
+      sizeBytes,
+      stale: isStale(staleAt),
+      expired: isExpired(expiresAt),
+    };
   }
 
   delete(key: ResourceCacheKey): void {

package/src/data/sqlite/cache.test.ts

@@ -4,6 +4,7 @@ import { existsSync, rmSync } from "fs";
 import { join } from "path";
 import { tmpdir } from "os";
 import { AppPersistence } from "../app-persistence";
+import { ResourceStore } from "../resource-store";
 
 const tempPaths: string[] = [];
 
@@ -82,6 +83,109 @@ describe("AppPersistence", () => {
     }
   });
 
+  test("runs resource maintenance on the first write and at write, byte, or time intervals", () => {
+    const dbPath = createTempDbPath("resource-maintenance-frequency");
+    const persistence = new AppPersistence(dbPath);
+    const connection = persistence.database.connection;
+    let maintenanceScans = 0;
+    const observedConnection = new Proxy(connection, {
+      get(target, property) {
+        if (property === "query") {
+          return (sql: string) => {
+            if (sql.includes("SELECT COUNT(*) as count")) maintenanceScans += 1;
+            return target.query(sql);
+          };
+        }
+        const value = Reflect.get(target, property, target);
+        return typeof value === "function" ? value.bind(target) : value;
+      },
+    }) as Database;
+    const resources = new ResourceStore(observedConnection);
+    const realDateNow = Date.now;
+    let now = 1_000_000;
+    Date.now = () => now;
+    const write = (entityKey: string) => resources.set({
+      namespace: "test",
+      kind: "maintenance",
+      entityKey,
+    }, { entityKey }, {
+      cachePolicy: { staleMs: 60_000, expireMs: 120_000 },
+    });
+
+    try {
+      write("first");
+      expect(maintenanceScans).toBe(1);
+
+      for (let index = 0; index < 249; index++) write(`below-${index}`);
+      expect(maintenanceScans).toBe(1);
+
+      write("write-interval");
+      expect(maintenanceScans).toBe(2);
+
+      write("below-time-interval");
+      expect(maintenanceScans).toBe(2);
+
+      now += 5 * 60_000;
+      write("time-interval");
+      expect(maintenanceScans).toBe(3);
+
+      resources.set({
+        namespace: "test",
+        kind: "maintenance",
+        entityKey: "byte-interval",
+      }, "x".repeat(512 * 1024), {
+        cachePolicy: { staleMs: 60_000, expireMs: 120_000 },
+      });
+      expect(maintenanceScans).toBe(4);
+    } finally {
+      Date.now = realDateNow;
+      persistence.close();
+    }
+  });
+
+  test("prunes only enough least-recently-used resources to restore the byte budget", () => {
+    const dbPath = createTempDbPath("resource-byte-pruning");
+    const persistence = new AppPersistence(dbPath);
+    const now = Date.now();
+    const write = (entityKey: string, value: unknown, fetchedAt: number) => persistence.resources.set({
+      namespace: "test",
+      kind: "byte-pruning",
+      entityKey,
+    }, value, {
+      cachePolicy: { staleMs: 60_000, expireMs: 10 * 60_000 },
+      fetchedAt,
+    });
+
+    try {
+      write("oldest", { value: 1 }, now - 2);
+      write("newer", { value: 2 }, now - 1);
+      persistence.database.connection.query(
+        `UPDATE resource_cache
+         SET size_bytes = CASE entity_key
+           WHEN 'oldest' THEN ?
+           WHEN 'newer' THEN ?
+           ELSE size_bytes
+         END
+         WHERE namespace = 'test' AND kind = 'byte-pruning'`,
+      ).run(60 * 1024 * 1024, 50 * 1024 * 1024);
+
+      write("trigger", "x".repeat(512 * 1024), now);
+
+      const remaining = persistence.database.connection
+        .query<{ entity_key: string }, []>(
+          `SELECT entity_key
+           FROM resource_cache
+           WHERE namespace = 'test' AND kind = 'byte-pruning'
+           ORDER BY fetched_at ASC`,
+        )
+        .all()
+        .map((row) => row.entity_key);
+      expect(remaining).toEqual(["newer", "trigger"]);
+    } finally {
+      persistence.close();
+    }
+  });
+
   test("invalidates plugin state when schema versions differ", () => {
     const dbPath = createTempDbPath("plugin-version");
     const persistence = new AppPersistence(dbPath);
@@ -117,21 +221,6 @@ describe("AppPersistence", () => {
     persistence.close();
   });
 
-  test("returns stable references for unchanged plugin state snapshots", () => {
-    const dbPath = createTempDbPath("plugin-stable-snapshot");
-    const persistence = new AppPersistence(dbPath);
-    persistence.pluginState.set("prediction-markets", "resume:watchlist:v1", ["kalshi:ABC"], 1);
-
-    const first = persistence.pluginState.get<string[]>("prediction-markets", "resume:watchlist:v1", 1);
-    const second = persistence.pluginState.get<string[]>("prediction-markets", "resume:watchlist:v1", 1);
-
-    expect(first).not.toBeNull();
-    expect(second).not.toBeNull();
-    if (!first || !second) throw new Error("Expected persisted plugin state");
-    expect(second.value).toBe(first.value);
-    persistence.close();
-  });
-
   test("stores multiple plugin state records in one batch", () => {
     const dbPath = createTempDbPath("plugin-state-batch");
     const persistence = new AppPersistence(dbPath);

package/src/i18n/index.test.ts

@@ -4,6 +4,7 @@ import {
   applyLanguagePreference,
   getLanguage,
   setLanguage,
+  subscribeLanguage,
 } from ".";
 import { ja } from "./ja";
 import { ko } from "./ko";
@@ -23,6 +24,22 @@ function placeholders(value: string): string[] {
 }
 
 describe("language selection", () => {
+  test("notifies subscribers only when the resolved language changes", () => {
+    const previousLanguage = getLanguage();
+    let notifications = 0;
+    const unsubscribe = subscribeLanguage(() => {
+      notifications += 1;
+    });
+    try {
+      setLanguage(previousLanguage === "ja" ? "ko" : "ja");
+      setLanguage(getLanguage());
+      expect(notifications).toBe(1);
+    } finally {
+      unsubscribe();
+      setLanguage(previousLanguage);
+    }
+  });
+
   test("keeps a valid environment override ahead of runtime preferences", () => {
     const previousOverride = process.env.GLOOMBERB_LANG;
     const previousLanguage = getLanguage();

package/src/i18n/index.ts

@@ -77,13 +77,25 @@ function detectLanguage(): AppLanguage {
 }
 
 let currentLanguage: AppLanguage = detectLanguage();
+const languageListeners = new Set<() => void>();
+
+function updateLanguage(language: AppLanguage): void {
+  if (currentLanguage === language) return;
+  currentLanguage = language;
+  for (const listener of languageListeners) listener();
+}
 
 export function getLanguage(): AppLanguage {
   return currentLanguage;
 }
 
 export function setLanguage(language: AppLanguage): void {
-  currentLanguage = language;
+  updateLanguage(language);
+}
+
+export function subscribeLanguage(listener: () => void): () => void {
+  languageListeners.add(listener);
+  return () => languageListeners.delete(listener);
 }
 
 /**
@@ -94,13 +106,16 @@ export function setLanguage(language: AppLanguage): void {
 export function applyLanguageFromConfig(config: { language?: string } | null | undefined): void {
   const override = getEnvironmentLanguageOverride();
   if (override) {
-    currentLanguage = override;
+    updateLanguage(override);
     return;
   }
   const configured = config?.language;
-  if (!configured || configured === "auto") return;
+  if (!configured || configured === "auto") {
+    updateLanguage(detectLanguage());
+    return;
+  }
   const normalized = normalizeLanguageTag(configured);
-  if (normalized) currentLanguage = normalized;
+  if (normalized) updateLanguage(normalized);
 }
 
 /**
@@ -108,8 +123,10 @@ export function applyLanguageFromConfig(config: { language?: string } | null | u
  * command). "auto" re-runs environment detection.
  */
 export function applyLanguagePreference(preference: LanguagePreference): void {
-  currentLanguage = getEnvironmentLanguageOverride()
-    ?? (preference === "auto" ? detectLanguage() : preference);
+  updateLanguage(
+    getEnvironmentLanguageOverride()
+      ?? (preference === "auto" ? detectLanguage() : preference),
+  );
 }
 
 /**

package/src/i18n/ja.ts

@@ -637,8 +637,15 @@ export const ja: Record<string, string> = {
   "Advanced": "詳細設定",
   "Free": "無料",
   "Market data": "市場データ",
+  "US equities": "米国株",
+  "Options data": "オプションデータ",
   "Delayed": "遅延",
+  "15m delay": "15 分遅延",
   "Real-time": "リアルタイム",
+  "{count}-minute delayed options, upgrade for real-time":
+    "オプションは {count} 分遅延、リアルタイムにはアップグレード",
+  "real-time options": "リアルタイムオプション",
+  "options delayed fallback": "オプション遅延フォールバック",
   "News": "ニュース",
   "12h delay": "12 時間遅延",
   "Real-time wire": "リアルタイム速報",
@@ -827,6 +834,9 @@ export const ja: Record<string, string> = {
   // ── AI ──────────────────────────────────────────────────────
   "Select a ticker to ask AI.": "AI に質問する銘柄を選択してください。",
   "No AI CLI tools are ready:": "AI CLI ツールが準備されていません:",
+  "No AI providers are ready.": "利用可能な AI プロバイダーがありません。",
+  "No AI providers are ready. Connect an account in pane settings.": "利用可能な AI プロバイダーがありません。ペイン設定でアカウントを接続してください。",
+  "Open any AI pane's settings to connect an account.": "いずれかの AI ペインの設定を開いて、アカウントを接続してください。",
   "Ask questions about {ticker}. Financial data will be included as context.": "{ticker} について質問してください。財務データがコンテキストとして含まれます。",
   "You": "あなた",
   "thinking...": "考えています...",
@@ -844,6 +854,7 @@ export const ja: Record<string, string> = {
   "No supported AI CLI tools detected. Install one to run screeners.": "サポートされている AI CLI ツールが検出されません。スクリーナーを実行するには、1 つインストールしてください。",
   "Force Refreshing...": "強制更新中...",
   "Refreshing...": "更新中...",
+  "Refreshing…": "更新中…",
   "Stop": "停止",
   "Refresh": "更新",
   "Run Screener": "スクリーナーを実行",
@@ -860,6 +871,8 @@ export const ja: Record<string, string> = {
   "force refresh armed": "強制リフレッシュ準備完了",
   "provider": "プロバイダー",
   "new": "新規",
+  "cancel": "キャンセル",
+  "stop": "停止",
   "close tab": "タブを閉じる",
   "efresh": "更新",
   "force refresh": "強制リフレッシュ",

package/src/i18n/ko.ts

@@ -635,8 +635,15 @@ export const ko: Record<string, string> = {
   "Advanced": "고급",
   "Free": "무료",
   "Market data": "시장 데이터",
+  "US equities": "미국 주식",
+  "Options data": "옵션 데이터",
   "Delayed": "지연",
+  "15m delay": "15분 지연",
   "Real-time": "실시간",
+  "{count}-minute delayed options, upgrade for real-time":
+    "옵션 데이터 {count}분 지연, 실시간으로 업그레이드",
+  "real-time options": "실시간 옵션",
+  "options delayed fallback": "옵션 지연 대체 데이터",
   "News": "뉴스",
   "12h delay": "12시간 지연",
   "Real-time wire": "실시간 속보",
@@ -825,6 +832,9 @@ export const ko: Record<string, string> = {
   // ── AI ──────────────────────────────────────────────────────
   "Select a ticker to ask AI.": "AI에 질문할 종목을 선택하세요.",
   "No AI CLI tools are ready:": "사용 가능한 AI CLI 도구가 없습니다:",
+  "No AI providers are ready.": "사용 가능한 AI 제공업체가 없습니다.",
+  "No AI providers are ready. Connect an account in pane settings.": "사용 가능한 AI 제공업체가 없습니다. 패널 설정에서 계정을 연결하세요.",
+  "Open any AI pane's settings to connect an account.": "AI 패널 설정을 열어 계정을 연결하세요.",
   "Ask questions about {ticker}. Financial data will be included as context.": "{ticker}에 대해 질문하세요. 재무 데이터는 컨텍스트로 포함됩니다.",
   "You": "나",
   "thinking...": "생각 중...",
@@ -842,6 +852,7 @@ export const ko: Record<string, string> = {
   "No supported AI CLI tools detected. Install one to run screeners.": "지원되는 AI CLI 도구가 감지되지 않았습니다. 스크리너를 실행하려면 하나를 설치하세요.",
   "Force Refreshing...": "강제 새로고침 중...",
   "Refreshing...": "새로고침 중...",
+  "Refreshing…": "새로고침 중…",
   "Stop": "중지",
   "Refresh": "새로고침",
   "Run Screener": "스크리너 실행",
@@ -858,6 +869,8 @@ export const ko: Record<string, string> = {
   "force refresh armed": "강제 새로고침 준비됨",
   "provider": "제공업체",
   "new": "새로 만들기",
+  "cancel": "취소",
+  "stop": "중지",
   "close tab": "탭 닫기",
   "efresh": "새로고침",
   "force refresh": "강제 새로고침",

package/src/i18n/react.ts

@@ -0,0 +1,6 @@
+import { useSyncExternalStore } from "react";
+import { getLanguage, subscribeLanguage } from ".";
+
+export function useAppLanguage() {
+  return useSyncExternalStore(subscribeLanguage, getLanguage, getLanguage);
+}

package/src/i18n/zh-cn.ts

@@ -637,8 +637,15 @@ export const zhCN: Record<string, string> = {
   "Advanced": "高级",
   "Free": "免费版",
   "Market data": "行情数据",
+  "US equities": "美股",
+  "Options data": "期权数据",
   "Delayed": "延迟",
+  "15m delay": "延迟 15 分钟",
   "Real-time": "实时",
+  "{count}-minute delayed options, upgrade for real-time":
+    "期权行情延迟 {count} 分钟，升级以获取实时数据",
+  "real-time options": "实时期权",
+  "options delayed fallback": "期权延迟备用数据",
   "News": "新闻",
   "12h delay": "延迟 12 小时",
   "Real-time wire": "实时快讯",
@@ -827,6 +834,9 @@ export const zhCN: Record<string, string> = {
   // ── AI ──────────────────────────────────────────────────────
   "Select a ticker to ask AI.": "选择一个代码向 AI 提问。",
   "No AI CLI tools are ready:": "没有就绪的 AI 命令行工具：",
+  "No AI providers are ready.": "没有已就绪的 AI 服务商。",
+  "No AI providers are ready. Connect an account in pane settings.": "没有已就绪的 AI 服务商。请在面板设置中连接账户。",
+  "Open any AI pane's settings to connect an account.": "打开任意 AI 面板的设置以连接账户。",
   "Ask questions about {ticker}. Financial data will be included as context.": "可以询问关于 {ticker} 的问题，金融数据会作为上下文提供。",
   "You": "你",
   "thinking...": "思考中...",
@@ -844,6 +854,7 @@ export const zhCN: Record<string, string> = {
   "No supported AI CLI tools detected. Install one to run screeners.": "未检测到受支持的 AI 命令行工具。请安装一个后运行选股器。",
   "Force Refreshing...": "强制刷新中...",
   "Refreshing...": "刷新中...",
+  "Refreshing…": "刷新中…",
   "Stop": "停止",
   "Refresh": "刷新",
   "Run Screener": "运行选股器",
@@ -860,6 +871,8 @@ export const zhCN: Record<string, string> = {
   "force refresh armed": "强制刷新已准备",
   "provider": "提供商",
   "new": "新建",
+  "cancel": "取消",
+  "stop": "停止",
   "close tab": "关闭标签页",
   "efresh": "刷新",
   "force refresh": "强制刷新",

package/src/i18n/zh-tw.ts

@@ -637,8 +637,15 @@ export const zhTW: Record<string, string> = {
   "Advanced": "高階",
   "Free": "免費版",
   "Market data": "行情資料",
+  "US equities": "美股",
+  "Options data": "選擇權資料",
   "Delayed": "延遲",
+  "15m delay": "延遲 15 分鐘",
   "Real-time": "即時",
+  "{count}-minute delayed options, upgrade for real-time":
+    "選擇權行情延遲 {count} 分鐘，升級以取得即時資料",
+  "real-time options": "即時選擇權",
+  "options delayed fallback": "選擇權延遲備援資料",
   "News": "新聞",
   "12h delay": "延遲 12 小時",
   "Real-time wire": "即時快訊",
@@ -827,6 +834,9 @@ export const zhTW: Record<string, string> = {
   // ── AI ──────────────────────────────────────────────────────
   "Select a ticker to ask AI.": "選擇股票代號以詢問 AI。",
   "No AI CLI tools are ready:": "沒有就緒的 AI CLI 工具：",
+  "No AI providers are ready.": "沒有已就緒的 AI 供應商。",
+  "No AI providers are ready. Connect an account in pane settings.": "沒有已就緒的 AI 供應商。請在面板設定中連線帳戶。",
+  "Open any AI pane's settings to connect an account.": "開啟任一 AI 面板的設定以連線帳戶。",
   "Ask questions about {ticker}. Financial data will be included as context.": "可以詢問關於 {ticker} 的問題，金融資料會作為上下文提供。",
   "You": "你",
   "thinking...": "思考中...",
@@ -844,6 +854,7 @@ export const zhTW: Record<string, string> = {
   "No supported AI CLI tools detected. Install one to run screeners.": "未偵測到支援的 AI CLI 工具。請先安裝工具再執行選股器。",
   "Force Refreshing...": "強制重新整理中...",
   "Refreshing...": "重新整理中...",
+  "Refreshing…": "重新整理中…",
   "Stop": "停止",
   "Refresh": "重新整理",
   "Run Screener": "執行選股器",
@@ -860,6 +871,8 @@ export const zhTW: Record<string, string> = {
   "force refresh armed": "已準備強制重新整理",
   "provider": "供應商",
   "new": "新增",
+  "cancel": "取消",
+  "stop": "停止",
   "close tab": "關閉分頁",
   "efresh": "重新整理",
   "force refresh": "強制重新整理",

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

@@ -32,6 +32,7 @@ type RunSingleFlight = <T>(key: string, task: () => Promise<T>) => Promise<T>;
 
 interface AuxiliaryLoaderOptions<T> {
   dataProvider: DataProvider;
+  forceRefresh?: boolean;
   key: string;
   store: QueryStore<T>;
   ttlMs: number;
@@ -41,14 +42,16 @@ interface AuxiliaryLoaderOptions<T> {
 
 export function loadOptionsEntry(options: {
   dataProvider: DataProvider;
+  forceRefresh?: boolean;
   request: OptionsRequest;
   store: QueryStore<OptionsChain>;
   runSingleFlight: RunSingleFlight;
 }): Promise<QueryEntry<OptionsChain>> {
-  const { dataProvider, request, store, runSingleFlight } = options;
+  const { dataProvider, forceRefresh = false, request, store, runSingleFlight } = options;
   const key = buildOptionsKey(request);
   return loadAuxiliaryEntry({
     dataProvider,
+    forceRefresh,
     key,
     store,
     ttlMs: OPTIONS_CACHE_TTL_MS,
@@ -213,6 +216,7 @@ export function loadFxRateEntry(options: {
 
 function loadAuxiliaryEntry<T>({
   dataProvider,
+  forceRefresh = false,
   key,
   store,
   ttlMs,
@@ -220,10 +224,10 @@ function loadAuxiliaryEntry<T>({
   load,
 }: AuxiliaryLoaderOptions<T>): Promise<QueryEntry<T>> {
   const current = store.get(key);
-  if (hasFreshReadyEntry(current, ttlMs)) {
+  if (!forceRefresh && hasFreshReadyEntry(current, ttlMs)) {
     return Promise.resolve(current);
   }
-  return runSingleFlight(key, async () => {
+  return runSingleFlight(forceRefresh ? `${key}|refresh` : key, async () => {
     store.update(key, loadingEntry);
     const startedAt = Date.now();
     try {

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

@@ -1,4 +1,4 @@
-import { isIntradayResolution, TIME_RANGE_ORDER } from "../../components/chart/core/resolution";
+import { isIntradayResolution, TIME_RANGE_ORDER } from "../../time-series/resolution";
 import type { PricePoint } from "../../types/financials";
 import { isPriceHistoryStaleForCurrentWindow, normalizePriceHistory } from "../../utils/price-history";
 import type { ChartRequest, InstrumentRef } from "../request-types";

package/src/market-data/coordinator/index.test.ts

@@ -178,6 +178,32 @@ describe("MarketDataCoordinator", () => {
     expect(optionsCalls).toBe(1);
   });
 
+  it("force refreshes an options chain for periodic Greeks and IV updates", async () => {
+    let optionsCalls = 0;
+    const provider = createProvider({
+      getOptionsChain: async () => {
+        optionsCalls += 1;
+        return {
+          underlyingSymbol: "AAPL",
+          expirationDates: [1_800_000_000],
+          calls: [],
+          puts: [],
+        };
+      },
+    });
+    const coordinator = new MarketDataCoordinator(provider);
+    const request = {
+      instrument: { symbol: "AAPL", exchange: "NASDAQ" },
+      expirationDate: 1_800_000_000,
+    };
+
+    await coordinator.loadOptions(request);
+    await coordinator.loadOptions(request);
+    await coordinator.loadOptions(request, { forceRefresh: true });
+
+    expect(optionsCalls).toBe(2);
+  });
+
   it("uses cached chart data while a wider range request is loading", async () => {
     const oneYearHistory = [
       { date: new Date("2024-01-01"), close: 100 },

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

@@ -303,9 +303,13 @@ export class MarketDataCoordinator {
     });
   }
 
-  async loadOptions(request: OptionsRequest): Promise<QueryEntry<OptionsChain>> {
+  async loadOptions(
+    request: OptionsRequest,
+    options: { forceRefresh?: boolean } = {},
+  ): Promise<QueryEntry<OptionsChain>> {
     return loadOptionsEntry({
       dataProvider: this.dataProvider,
+      forceRefresh: options.forceRefresh,
       request,
       store: this.optionsStore,
       runSingleFlight: (key, task) => this.runSingleFlight(key, task),
@@ -364,11 +368,13 @@ export class MarketDataCoordinator {
   private applyStreamQuote(instrument: InstrumentRef, quote: Quote): void {
     const key = buildQuoteKey(instrument);
     const current = this.quoteStore.get(key);
-    const resolvedQuote = this.resolveIncomingQuote(instrument, quote);
+    const resolvedQuote = quote.stale === true ? quote : this.resolveIncomingQuote(instrument, quote);
     if (areStreamQuotesEquivalent(current.data ?? current.lastGoodData, resolvedQuote)) return;
-    const receivedAt = Date.now();
-    const attempts = [createAttempt(resolvedQuote.providerId ?? this.dataProvider.id, receivedAt, "success")];
-    this.quoteStore.set(key, readyQuoteEntry(current, { ...resolvedQuote, receivedAt }, resolvedQuote.providerId ?? this.dataProvider.id, attempts));
+    const startedAt = Date.now();
+    const receivedAt = resolvedQuote.stale === true ? resolvedQuote.receivedAt : startedAt;
+    const storedQuote = receivedAt == null ? resolvedQuote : { ...resolvedQuote, receivedAt };
+    const attempts = [createAttempt(resolvedQuote.providerId ?? this.dataProvider.id, startedAt, "success")];
+    this.quoteStore.set(key, readyQuoteEntry(current, storedQuote, resolvedQuote.providerId ?? this.dataProvider.id, attempts));
   }
 
   private resolveIncomingQuote(instrument: InstrumentRef, quote: Quote): Quote {