@gloom-sh/terminal 0.18.5 → 0.19.1

package/src/data/ttl-cache.ts

@@ -0,0 +1,165 @@
+/**
+ * A keyed in-memory cache that serves a loaded value for a while and shares a
+ * load that is still out. It is what a plugin reaches for instead of keeping
+ * its own `Map<key, { at, value }>` with a TTL constant and `Date.now() - at`
+ * checks, each copy with its own rule for a concurrent call, a forced reload
+ * and a failed load.
+ *
+ * It holds nothing across a restart, and `load` never answers with an expired
+ * value. A pane whose data must outlive a restart, or fall back to the saved
+ * copy when a refresh fails, wants `createPluginCache` (src/data/plugin-cache.ts).
+ *
+ * The rules, for every key:
+ * - A fresh value is served as it is; a load that is still out is shared, so
+ *   two callers never start two requests for one key. A load is shared for
+ *   no longer than `ttlMs` (a number), so one that hangs cannot hold the key.
+ * - `force` skips a fresh value and starts a load, except that it joins one
+ *   that is already out when that load began after the value it would
+ *   replace: panes that refresh together make one request, not one each.
+ * - The last good value stays until a load brings a newer one. A forced
+ *   load that fails, or brings a value `keep` refuses, leaves it in place,
+ *   and `peek(key, { stale: true })` reads it past its TTL while a reload is
+ *   out, for a view that keeps drawing the last copy.
+ * - A load that rejects reaches every caller waiting on it. By default
+ *   nothing is kept, so the next call asks again; `rejectionMs` keeps the
+ *   rejection that long, for a load a poll would otherwise repeat each tick.
+ * - A load runs as soon as `load` is called, not on a later tick.
+ */
+export interface TtlCacheOptions<V> {
+  /** How long a loaded value is served, from when it arrives; a function sets it per value. */
+  ttlMs: number | ((value: V) => number);
+  /**
+   * Whether a loaded value is kept. One that is not still answers the callers
+   * waiting on it, and the next call loads again. Default: every value.
+   */
+  keep?: (value: V) => boolean;
+  /** How long a rejected load is kept and served again. Default 0: it is dropped. */
+  rejectionMs?: number;
+  /** The oldest keys go first past this many. Default: unbounded. */
+  maxEntries?: number;
+  /** The clock, for tests. */
+  now?: () => number;
+}
+
+export interface TtlCache<V> {
+  /** The key's fresh value or the load already out for it; otherwise starts `load`. */
+  load(key: string, load: () => V | PromiseLike<V>, options?: { force?: boolean }): Promise<V>;
+  /**
+   * The key's fresh value, `undefined` when it has none. `stale` also reads
+   * the last good value past its TTL, for a view that keeps drawing it until
+   * the next load lands.
+   */
+  peek(key: string, options?: { stale?: boolean }): V | undefined;
+  /** Whether the key's last load was rejected and `rejectionMs` still keeps that rejection. */
+  failed(key: string): boolean;
+  /** Keeps a value that arrived by another road, for the TTL. */
+  set(key: string, value: V): void;
+  /**
+   * Forgets the key. With `only`, a promise `load` returned, forgets just the
+   * load or kept rejection it stands for, and only while it is still the
+   * key's: a caller that gives up on a load cannot drop a newer one.
+   */
+  delete(key: string, only?: Promise<V>): void;
+  clear(): void;
+}
+
+interface Slot<V> {
+  /** The last good value: fresh until `expiresAt`, readable as stale after. */
+  held?: { value: V; arrivedAt: number; expiresAt: number };
+  /** The load that is out. */
+  loading?: { promise: Promise<V>; startedAt: number };
+  /** A rejected load kept for `rejectionMs`. */
+  failed?: { promise: Promise<V>; expiresAt: number };
+}
+
+export function createTtlCache<V>(options: TtlCacheOptions<V>): TtlCache<V> {
+  const { keep = () => true, rejectionMs = 0, maxEntries = Infinity, now: clock = () => Date.now() } = options;
+  const ttlFor = (value: V) => typeof options.ttlMs === "function" ? options.ttlMs(value) : options.ttlMs;
+  const shareMs = typeof options.ttlMs === "number" ? options.ttlMs : Infinity;
+  const slots = new Map<string, Slot<V>>();
+
+  const store = (key: string, slot: Slot<V>) => {
+    slots.delete(key);
+    slots.set(key, slot);
+    while (slots.size > maxEntries) slots.delete(slots.keys().next().value!);
+  };
+  /** A slot with nothing in it is not kept. */
+  const tidy = (key: string, slot: Slot<V>) => {
+    if (!slot.held && !slot.loading && !slot.failed && slots.get(key) === slot) slots.delete(key);
+  };
+  const hold = (slot: Slot<V>, value: V) => {
+    const arrivedAt = clock();
+    slot.held = { value, arrivedAt, expiresAt: arrivedAt + ttlFor(value) };
+    slot.failed = undefined;
+  };
+
+  return {
+    load(key, load, { force = false } = {}) {
+      const at = clock();
+      const slot = slots.get(key) ?? {};
+      const { held, loading, failed } = slot;
+      if (!force) {
+        if (held && held.expiresAt > at) return Promise.resolve(held.value);
+        if (failed && failed.expiresAt > at) return failed.promise;
+      }
+      if (loading && at - loading.startedAt < shareMs && (!force || !held || loading.startedAt >= held.arrivedAt)) return loading.promise;
+
+      const run: NonNullable<Slot<V>["loading"]> = { promise: undefined as unknown as Promise<V>, startedAt: at };
+      const current = () => slots.get(key)?.loading === run;
+      run.promise = new Promise<V>((resolve) => resolve(load())).then((value) => {
+        if (current()) {
+          slot.loading = undefined;
+          try {
+            // A `keep` or TTL function that throws rejects for the callers, like the load.
+            if (keep(value)) hold(slot, value);
+          } finally {
+            tidy(key, slot);
+          }
+        }
+        return value;
+      }, (error: unknown) => {
+        if (current()) {
+          slot.loading = undefined;
+          const fresh = slot.held && slot.held.expiresAt > clock();
+          if (rejectionMs > 0 && !fresh) slot.failed = { promise: run.promise, expiresAt: clock() + rejectionMs };
+          tidy(key, slot);
+        }
+        throw error;
+      });
+      // A caller that drops the promise must not raise an unhandled rejection.
+      run.promise.then(undefined, () => { /* Intentional ignore: every caller holds this promise and sees the rejection. */ });
+      slot.loading = run;
+      slot.failed = undefined;
+      store(key, slot);
+      return run.promise;
+    },
+    peek(key, { stale = false } = {}) {
+      const held = slots.get(key)?.held;
+      return held && (stale || held.expiresAt > clock()) ? held.value : undefined;
+    },
+    failed(key) {
+      const failed = slots.get(key)?.failed;
+      return !!failed && failed.expiresAt > clock();
+    },
+    set(key, value) {
+      if (!keep(value)) return;
+      const slot = slots.get(key) ?? {};
+      hold(slot, value);
+      store(key, slot);
+    },
+    delete(key, only) {
+      const slot = slots.get(key);
+      if (!slot) return;
+      if (!only) {
+        slots.delete(key);
+        return;
+      }
+      if (slot.loading?.promise === only) slot.loading = undefined;
+      if (slot.failed?.promise === only) slot.failed = undefined;
+      tidy(key, slot);
+    },
+    clear() {
+      slots.clear();
+    },
+  };
+}

package/src/docs/snapshot.json

@@ -1,7 +1,7 @@
 {
  "format": 1,
  "site": "https://gloom.sh",
- "updatedAt": "2026-10-25",
+ "updatedAt": "2026-10-28",
  "categories": [
   {
    "id": "research",
@@ -37,16 +37,6 @@
   }
  ],
  "functions": [
-  {
-   "code": "ATTN",
-   "name": "Research attention",
-   "description": "What Gloom users are researching",
-   "detail": "Which tickers opted-in Gloom users are researching, by hour, day and week, with sector and country totals and abnormal attention. Delayed at least an hour. Pro shows the full board; Free shows three rows per section.",
-   "category": "research",
-   "arg": "NVDA",
-   "access": "pro",
-   "lesson": "/academy/compare-screen-follow-money/filings-and-attention/attention"
-  },
   {
    "code": "DES",
    "name": "Security overview",
@@ -295,9 +285,9 @@
   },
   {
    "code": "CSP",
-   "name": "Cash-secured put screen",
-   "description": "Put-selling yield across a list",
-   "detail": "For each ticker, the put nearest a delta (0.30) on the expiry about 30 days out, ranked by annualised yield on cash at the bid, with distance out of the money, delta, IV rank, the bid/ask spread (wide ones flagged, never dropped), and whether earnings fall before expiry. Enter opens the put in OSA.",
+   "name": "Options strategy screen",
+   "description": "Puts, covered calls, spreads, condors, straddles and calendars across a list",
+   "detail": "One tab per strategy: cash-secured put, covered call, vertical, iron condor, straddle, strangle and calendar. For each ticker it picks the legs by delta and expiry, then shows credit or debit, max gain and loss, break-evens, probability of profit, IV rank, wide spreads and earnings before expiry. Income trades rank by yearly return, debit trades by reward to risk.",
    "category": "research",
    "arg": "JPM, GS, KO"
   },
@@ -1043,8 +1033,9 @@
    "code": "FLOW",
    "name": "Options flow",
    "description": "Unusual options activity",
-   "detail": "Sweeps, blocks, and large premium prints as they hit the tape, with ticker, strike, expiry, and premium.",
+   "detail": "Sweeps, blocks, and large premium prints, plus the session's net premium tide.",
    "category": "markets",
+   "arg": "NVDA",
    "access": "pro",
    "lesson": "/academy/options-and-volatility/positioning-and-flow/options-flow"
   },
@@ -1693,6 +1684,13 @@
    "category": "app",
    "lesson": "/academy/terminal-and-workspace/how-the-terminal-works/help-cards"
   },
+  {
+   "code": "ROADMAP",
+   "name": "Roadmap",
+   "description": "What is coming next",
+   "detail": "What is being built, what is planned and what shipped, with each item's votes. Pro members vote on what is building or planned, once per item, and can take the vote back.",
+   "category": "app"
+  },
   {
    "code": "HELP",
    "name": "Help",
@@ -1808,7 +1806,7 @@
     },
     {
      "type": "code",
-     "code": "bun install -g gloomberb"
+     "code": "bun install -g @gloom-sh/terminal"
     },
     {
      "type": "heading",
@@ -1862,14 +1860,22 @@
       ],
       [
        "Bun",
-       "`bun install -g gloomberb@latest`"
+       "`bun install -g @gloom-sh/terminal@latest`"
       ]
      ]
     },
+    {
+     "type": "paragraph",
+     "text": "An existing `gloomberb` install keeps updating as it is."
+    },
     {
      "type": "paragraph",
      "text": "Installed before 0.18.4, when the command was `gloomberb`? Updating adds `gloom` beside it and `gloomberb` keeps working, with nothing to reinstall."
     },
+    {
+     "type": "paragraph",
+     "text": "Had `Gloomberb.app`? Its next update renames it to `Gloom.app`; settings and data stay."
+    },
     {
      "type": "heading",
      "level": 3,
@@ -2930,7 +2936,7 @@
     "troubleshooting",
     "diagnostics"
    ],
-   "updatedAt": "2026-10-07",
+   "updatedAt": "2026-10-25",
    "blocks": [
     {
      "type": "heading",
@@ -2980,7 +2986,7 @@
     {
      "type": "list",
      "items": [
-      "`Bad CPU type in executable` on macOS: an Intel Mac running the Apple Silicon app. Delete `/Applications/Gloomberb.app` and rerun `curl -fsSL gloom.sh/install | bash` for the Intel terminal build.",
+      "`Bad CPU type in executable` on macOS: an Intel Mac running the Apple Silicon app. Delete `/Applications/Gloom.app` (`Gloomberb.app` before the app was renamed) and rerun `curl -fsSL gloom.sh/install | bash` for the Intel terminal build.",
       "`gloom doctor` shows runtime errors.",
       "Update with the same method you installed with. See [Install and update](/docs/getting-started)."
      ]
@@ -3306,7 +3312,7 @@
     },
     {
      "type": "paragraph",
-     "text": "When signed in, searches you finish in the command bar are saved to improve search, shown to no one, and deleted with your account. [Research attention](/docs/attention) is a separate opt-in, off by default."
+     "text": "When signed in, searches you finish in the command bar are saved to improve search, shown to no one, and deleted with your account. Attention Counts, the research attention contribution, is a separate opt-in, off by default."
     },
     {
      "type": "paragraph",
@@ -4048,115 +4054,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloom fn JOBS NVDA`. MCP `company.hiring`, `market.hiring_movers`, `hiring.momentum`, `apps.attention`, `apps.rank_history`. Related: [Research attention](/docs/attention)."
-    }
-   ]
-  },
-  {
-   "slug": "attention",
-   "title": "Research attention",
-   "lead": "ATTN shows which tickers other Gloom users are researching, and which are getting unusual attention",
-   "category": "Understand the data",
-   "tags": [
-    "ATTN",
-    "attention",
-    "research",
-    "privacy"
-   ],
-   "updatedAt": "2026-10-07",
-   "blocks": [
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Open it"
-    },
-    {
-     "type": "table",
-     "headers": [
-      "Command",
-      "Opens"
-     ],
-     "rows": [
-      [
-       "`ATTN`",
-       "The board"
-      ],
-      [
-       "`ATTN NVDA`",
-       "One ticker"
-      ],
-      [
-       "`ATTN 6758:JPX`",
-       "An international listing"
-      ]
-     ]
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "What you see"
-    },
-    {
-     "type": "table",
-     "headers": [
-      "Tab",
-      "Shows"
-     ],
-     "rows": [
-      [
-       "Ranking",
-       "Tickers by research hours, with share, price move and relative volume"
-      ],
-      [
-       "Abnormal",
-       "Tickers well above their own usual level"
-      ],
-      [
-       "Sectors, Countries",
-       "Totals by sector and country"
-      ],
-      [
-       "History",
-       "Hourly research hours for one ticker"
-      ],
-      [
-       "Evidence",
-       "The window and rules behind each figure"
-      ]
-     ]
-    },
-    {
-     "type": "paragraph",
-     "text": "Switch the window between Now, Today and Week. Enter opens a ticker, `e` shows evidence."
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Free and Pro"
-    },
-    {
-     "type": "paragraph",
-     "text": "Pro shows the full board and 29 days of hourly history. Free shows three rows per section and the latest point. Data lags by at least an hour."
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Keep in mind"
-    },
-    {
-     "type": "list",
-     "items": [
-      "Counts come only from users who opted in, so they are a sample, not the market. A ticker appears only when enough people looked at it, and hidden hours are unavailable, not zero."
-     ]
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Your choice"
-    },
-    {
-     "type": "paragraph",
-     "text": "Contributing is a separate opt-in setting, off by default. Toggle **Attention Counts** in Settings or with `gloom config set telemetry.attention true`. See the [Privacy Policy](/privacy). MCP `market.attention`."
+     "text": "CLI `gloom fn JOBS NVDA`. MCP `company.hiring`, `market.hiring_movers`, `hiring.momentum`, `apps.attention`, `apps.rank_history`."
     }
    ]
   },
@@ -4385,7 +4283,7 @@
     "perpetuals",
     "history"
    ],
-   "updatedAt": "2026-10-09",
+   "updatedAt": "2026-10-26",
    "blocks": [
     {
      "type": "heading",
@@ -4425,6 +4323,18 @@
       "Shows"
      ],
      "rows": [
+      [
+       "Compare",
+       "One asset's contracts across the venues: mark, funding, premium and when each was observed"
+      ],
+      [
+       "Liquidations",
+       "One asset's liquidated longs and shorts across the venues: 24-hour and 7-day totals, the hourly series and the largest prints"
+      ],
+      [
+       "Depth",
+       "One asset's resting bids and asks within 0.5%, 1% and 2% of mid on each venue, from each venue's order book every hour"
+      ],
       [
        "History",
        "Funding, open interest and mark premium, with price candles and settled funding where available"
@@ -4448,6 +4358,37 @@
      "type": "paragraph",
      "text": "Pro shows the stored history. Free shows a limited preview of the latest values. History starts when Gloom first collected a market."
     },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Liquidations"
+    },
+    {
+     "type": "paragraph",
+     "text": "Each venue's public liquidation stream, kept event by event with the time it arrived. A long liquidated is a forced sell, a short a forced buy, valued at the price the venue reports: the average fill on Binance and Hyperliquid, the bankruptcy price on Bybit and OKX. What the streams leave out:"
+    },
+    {
+     "type": "list",
+     "items": [
+      "Binance and OKX send at most one liquidation per contract each second, so a burst on one contract is undercounted.",
+      "Bybit sends every liquidation.",
+      "Hyperliquid publishes only the positions its liquidity vault takes over (backstop liquidations). Liquidations closed on the order book are not published venue-wide and are missing.",
+      "Venues publish no liquidation history, so time the collector was not connected is missing, not zero, and history starts at first collection."
+     ]
+    },
+    {
+     "type": "paragraph",
+     "text": "Free shows each contract's 24-hour and 7-day totals and the three largest prints; Pro adds the hourly series and the twenty largest prints."
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Order book depth"
+    },
+    {
+     "type": "paragraph",
+     "text": "The quote notional resting within 0.5%, 1% and 2% of mid, read once an hour from each venue's public order book for its 50 largest markets by open interest. Binance and Bybit return the nearest 1,000 price levels a side and OKX 5,000; on the deepest markets the book ends inside a band, which then shows at least (≥) what it holds. Hyperliquid returns 20 levels a side, so wider bands are read from its grouped book and a band's edge falls within one price group. A book not read for 2.5 hours (it left its venue's 50 largest, or the venue is failing) is marked stale and left out of the band totals; after a week it is no longer listed. Free shows the latest reading; Pro the hourly history."
+    },
     {
      "type": "heading",
      "level": 2,
@@ -4465,7 +4406,7 @@
     {
      "type": "list",
      "items": [
-      "Stored readings cover Hyperliquid, Binance, Bybit and OKX.",
+      "Stored readings cover Hyperliquid, Binance, Bybit and OKX. Compare shows each venue's leading contract free; Pro lists every contract.",
       "Positive funding means longs pay shorts. Open interest in contracts and in USD differ, because a price rise adds USD open interest without new contracts.",
       "A stock perpetual's premium is blank while the stock market is closed. The live board and trading are in the Hyperliquid plugin."
      ]
@@ -4736,7 +4677,7 @@
     "call wall",
     "put wall"
    ],
-   "updatedAt": "2026-10-23",
+   "updatedAt": "2026-10-28",
    "blocks": [
     {
      "type": "heading",
@@ -4855,7 +4796,7 @@
       {
        "type": "list",
        "items": [
-        "Gamma per contract is Black-Scholes gamma with the forward at spot, times the 100-share multiplier. Time runs to 16:00 New York on the expiry date, at least one hour.",
+        "Gamma per contract is Black-Scholes gamma with the forward at spot, times the 100-share multiplier. Time runs to 16:00 New York on the expiry date, at least one hour, from now, or outside the session from the spot's time: before the open, a same-day expiry has the hours from the pre-market print to the close, with the volatility the last session's quotes imply. A cash index (SPX, XSP) outside its session is spot at that session's close.",
         "Each strike's volatility comes from its expiry's out-of-the-money quotes, linear between quoted strikes and flat beyond. An expiry without usable quotes is left out and named.",
         "GEX at a strike is gamma × 100 × spot × 1% of spot × open interest.",
         "The flip reprices net GEX from 15% below to 15% above spot in 0.25% steps, each strike keeping its volatility, and takes the sign change nearest spot.",
@@ -4953,7 +4894,7 @@
     },
     {
      "type": "paragraph",
-     "text": "`gloom fn GEX SPY --csv` opens with a summary: spot and quote times, the open interest session, the unit, net GEX, the dealer range, the flip and both walls. Puts export negative, so call and put GEX add up to net. `--json` has the same under `metadata.gamma`."
+     "text": "`gloom fn GEX SPY --csv` opens with a summary: spot, when gamma is evaluated and when its quotes were taken (`Gamma at ..., vols from ...`), the open interest session, the unit, net GEX, the dealer range, the flip and both walls. Puts export negative, so call and put GEX add up to net. `--json` has the same under `metadata.gamma`."
     },
     {
      "type": "heading",
@@ -5539,7 +5480,7 @@
     "functions",
     "screenshots"
    ],
-   "updatedAt": "2026-10-12",
+   "updatedAt": "2026-10-27",
    "blocks": [
     {
      "type": "paragraph",
@@ -5711,8 +5652,8 @@
        "Ticker and quick notes"
       ],
       [
-       "`alerts list`, `alerts add <symbol> <above|below|crosses> <price>`, `alerts delete|rearm <id>`",
-       "Price alerts"
+       "`alerts list`, `alerts add ...`, `alerts delete|rearm <id>`",
+       "Price, valuation, daily technical and event alerts, every kind the `ALRT` pane offers; the forms are below"
       ]
      ]
     },
@@ -5720,6 +5661,22 @@
      "type": "paragraph",
      "text": "[Portfolios and rebalancing](/docs/portfolio) walks through targets and the drift table. `CASH` in `portfolio target` is the cash line; `portfolio add` and `position set` refuse a bare `CASH` (the stock is `CASH:NASDAQ`). `portfolio` and `watchlist` write immediately and ignore `--dry-run`. Sign-in, account management and chat are app-only."
     },
+    {
+     "type": "paragraph",
+     "text": "The alerts commands, as `gloom help alerts` lists them:"
+    },
+    {
+     "type": "code",
+     "code": "gloom alerts list\ngloom alerts add <symbol> <above|below|crosses> <price>\ngloom alerts add <symbol> <pe|ps|rsi(14)> <above|below> <level>\ngloom alerts add <symbol> ma(50) crosses <above|below> ma(200)\ngloom alerts add <symbol> closes <above|below> ma(200)\ngloom alerts add <symbol>/<benchmark> <above|below|crosses> <ratio>\ngloom alerts add <symbol> rrg <leading|weakening|lagging|improving> [--benchmark <symbol>]\ngloom alerts add <symbol> earnings [--days <n> | results]\ngloom alerts add <calendar event> [--country <code>] [--days <n>]\ngloom alerts add [symbol] news <keyword>\ngloom alerts add [symbol] flow [premium] [calls|puts] [sweeps|blocks]\ngloom alerts add <symbol> <iv|rr> <above|below> <level>\ngloom alerts add <OCC contract> iv spike <points>\ngloom alerts add <symbol> 52-week <high|low>\ngloom alerts add <symbol> unusual volume [<multiple>x]\ngloom alerts add <symbol> filing [8-K|10-K|10-Q|S-1|13D|13D/A|13G|13G/A|6-K|20-F]\ngloom alerts add <symbol> insider [buy|sell]\ngloom alerts add <symbol> short interest [increase|decrease] [<percent>%]\ngloom alerts add <symbol> analyst [upgrade|downgrade]\ngloom alerts add <symbol> hiring [accelerating|slowing]\ngloom alerts add perps <market> <funding|oi|premium|closed-premium> <above|below> <percent>\ngloom alerts add catalyst [type <type> | agency <agency> | country <code>]\ngloom alerts add <symbol> catalyst\ngloom alerts add congress [member name]\ngloom alerts add 13f <fund CIK>\ngloom alerts delete <id>\ngloom alerts rearm <id>"
+    },
+    {
+     "type": "paragraph",
+     "text": "Words none of these forms read are refused with the list of kinds. Adding a rule that already exists names the existing alert's ID and adds nothing, and `rearm` on an alert that has not gone off says it is already active. An RSI or moving-average alert is always saved: it reads the same daily closes `history` shows as final and says when it is first checked."
+    },
+    {
+     "type": "paragraph",
+     "text": "`alerts list` shows each alert's listing with its currency, its last reading with when it is from (or `not checked yet`) and when it was created, in ISO 8601 UTC. `alerts list --csv` keeps its columns in order (`id,kind,target,trigger,eventDate,status,lastCheckedPrice,triggeredAt`) and adds `createdAt,listing,currency,lastReading,lastReadingAt` after them. Creating, re-arming and deleting an alert go in the app's alert log beside the alerts that fired (`gloom fn ALRT --tab history`)."
+    },
     {
      "type": "heading",
      "level": 2,
@@ -6928,6 +6885,10 @@
      "type": "paragraph",
      "text": "The [financial news API](/news) page shows the live wire and has the Get API key button."
     },
+    {
+     "type": "paragraph",
+     "text": "Comparing news APIs? See [the best financial news APIs](/alternatives/financial-news-apis), or Gloom side by side with [NewsAPI.org](/alternatives/newsapi-org) and [newsfilter.io](/alternatives/newsfilter-io)."
+    },
     {
      "type": "paragraph",
      "text": "See also: [Gloom Datasets](/docs/datasets), a separate paid API for alternative signals, filings, macro, news and market data, with its own `gds_` keys."
@@ -7206,7 +7167,7 @@
     {
      "type": "list",
      "items": [
-      "**Alternative data:** GPU rental prices, supply chain, hiring postings and momentum, social mentions, app attention, power and grid, perpetuals, catalysts and litigation, research attention, congressional trades, operating exposure.",
+      "**Alternative data:** GPU rental prices, supply chain, hiring postings and momentum, social mentions, app attention, power and grid, perpetuals, catalysts and litigation, congressional trades, operating exposure.",
       "**Filings and company text:** KPIs and guidance, executive pay, risk factors, 8-K events, transcripts, credit documents, debt maturities, revenue breakdown, SEC filings, insiders and 13F, document search.",
       "**News:** Real-time stories, sources and topics.",
       "**Macro and positioning:** CPI, EIA inventories, COT, yield curves and macro series, central bank rates, short volume and interest, CDS, government awards.",
@@ -7732,7 +7693,7 @@
    "title": "Screening the market (EQS)",
    "summary": "EQS keeps only the stocks in its stored universe that meet all your rules (valuation, growth, margins, liquidity, ownership and more) and ranks the matches.",
    "chapter": "Compare, screen and follow the money",
-   "minutes": 4
+   "minutes": 5
   },
   {
    "url": "/academy/compare-screen-follow-money/who-owns-it/holders-and-13f",
@@ -7785,10 +7746,10 @@
   },
   {
    "url": "/academy/compare-screen-follow-money/filings-and-attention/attention",
-   "title": "Attention: research and social buzz (ATTN, BUZZ)",
-   "summary": "ATTN ranks the tickers Gloom users are researching against each ticker's usual level, and BUZZ counts the day's posts on X naming a ticker, with the top posts and their stance.",
+   "title": "Social buzz (BUZZ)",
+   "summary": "BUZZ counts the day's posts on X naming a ticker against its usual level, with the top posts and their stance.",
    "chapter": "Compare, screen and follow the money",
-   "minutes": 4
+   "minutes": 3
   },
   {
    "url": "/academy/options-and-volatility/options-from-zero/what-is-an-option",

package/src/i18n/es.ts

@@ -506,10 +506,8 @@ export const es: Record<string, string> = {
   "Pin Ticker": "Fijar ticker",
 
   // ── Help pane ────────────────────────────────────────────────
-  "How To Use Gloom": "Cómo usar Gloom",
   "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "¿No sabes el código? Haz clic en la barra de búsqueda de arriba, o pulsa {key}, y escribe lo que quieres con tus palabras, como \"top news\". La pestaña Funciones las lista todas.",
   "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"top news\". The Functions tab lists everything.": "¿No sabes el código? Haz clic en la barra de búsqueda de arriba y escribe lo que quieres con tus palabras, como \"top news\". La pestaña Funciones las lista todas.",
-  "Click anything to use it; the keys shown beside actions are shortcuts.": "Haz clic en cualquier cosa para usarla; las teclas junto a las acciones son atajos.",
   "Open Help": "Abrir la ayuda",
   "Command Prefixes": "Prefijos de comandos",
   "Window Templates": "Plantillas de ventana",
@@ -519,7 +517,6 @@ export const es: Record<string, string> = {
   "Scrolling": "Desplazamiento",
   "Open Debug Log": "Abrir registro de depuración",
   "GitHub Issues": "GitHub Issues",
-  "Docked panes stay in the saved layout.": "Los paneles anclados permanecen en el diseño guardado.",
   "Floating panes can be dragged by the title bar and resized from the lower-right corner.": "Los paneles flotantes se arrastran por la barra de título y se redimensionan desde la esquina inferior derecha.",
   "Use Layout Actions for split, move, duplicate, close all floating panes, undo, redo, and layout presets.": "Usa Acciones de diseño para dividir, mover, duplicar, cerrar paneles flotantes, deshacer, rehacer y diseños predefinidos.",
   "Move through focused table and list rows.": "Moverse por las filas de tablas y listas activas.",
@@ -564,7 +561,6 @@ export const es: Record<string, string> = {
   "Go back from a nested command screen when the query is empty.": "Volver de una pantalla de comando anidada cuando la consulta está vacía.",
   "Reorder ordered multi-select choices.": "Reordenar opciones de selección múltiple ordenadas.",
   "Submit multiline command forms.": "Enviar formularios de comando multilínea.",
-  "Layout Basics": "Fundamentos del diseño",
 
   // ── Onboarding ───────────────────────────────────────────────
   "The open terminal for modern finance.": "La terminal abierta para las finanzas modernas.",
@@ -1115,6 +1111,19 @@ export const es: Record<string, string> = {
   "{symbol}'s figures are not collected yet; the next read stores them.": "Aún no se han recopilado las cifras de {symbol}; la próxima lectura las guardará.",
   "{symbol} files with the SEC as a trust or pool, not as an open-end fund, and its sponsor's site is not one Gloom reads.": "{symbol} está registrado ante la SEC como fideicomiso o pool, no como fondo abierto, y Gloom no lee el sitio de su patrocinador.",
   "No figures for {symbol}: its sponsor's site is not one Gloom reads, and the SEC's prospectus and N-PORT data sets list none for it yet.": "No hay cifras para {symbol}: Gloom no lee el sitio de su patrocinador y los conjuntos de datos de folletos y N-PORT de la SEC aún no incluyen ninguna.",
+  "est. {range}": "est. {range}",
+  "Shares outstanding": "Acciones en circulación",
+  "1M flows": "Flujos 1M",
+  "Structure": "Estructura",
+  "Closed-end fund": "Fondo cerrado",
+  "BDC": "BDC",
+  "est.": "est.",
+  "{count} shares": "{count} acciones",
+  "No figures for {symbol}: it files with the SEC as a closed-end fund or BDC, but neither the filings Gloom reads nor its sponsor's site state any for it yet.": "No hay cifras para {symbol}: está registrado ante la SEC como fondo cerrado o BDC, pero ni las presentaciones que lee Gloom ni el sitio de su patrocinador indican ninguna todavía.",
+  "No NAV for {symbol}: {publisher} publishes figures for it, but no NAV.": "No hay valor liquidativo para {symbol}: {publisher} publica cifras del fondo, pero no su valor liquidativo.",
+  "No NAV for {symbol}: its SEC filings state net assets but no NAV per share, and its sponsor's NAV is not one Gloom reads.": "No hay valor liquidativo para {symbol}: sus presentaciones ante la SEC indican el patrimonio neto pero no el valor liquidativo por acción, y Gloom no lee el de su patrocinador.",
+  "No NAV for {symbol}: its sponsor's site is not one Gloom reads, and a trust files no NAV with the SEC's fund data sets.": "No hay valor liquidativo para {symbol}: Gloom no lee el sitio de su patrocinador, y un fideicomiso no presenta valor liquidativo en los conjuntos de datos de fondos de la SEC.",
+  "No NAV for {symbol}: its sponsor's site is not one Gloom reads, and the SEC's prospectus and N-PORT data sets state no NAV.": "No hay valor liquidativo para {symbol}: Gloom no lee el sitio de su patrocinador, y los conjuntos de datos de folletos y N-PORT de la SEC no indican ninguno.",
   "No figures for {symbol}: it lists as a fund, but the SEC's lists do not name it yet and its sponsor's site is not one Gloom reads.": "No hay cifras para {symbol}: cotiza como fondo, pero las listas de la SEC aún no lo incluyen y Gloom no lee el sitio de su patrocinador.",
   "No fund facts for {symbol}: it is not on the SEC's lists of US-listed funds.": "No hay datos del fondo para {symbol}: no figura en las listas de fondos cotizados en EE. UU. de la SEC.",
   "No fund facts for {symbol} yet.": "Aún no hay datos del fondo para {symbol}.",
@@ -1478,8 +1487,11 @@ export const es: Record<string, string> = {
   "Answers cite filings, calls and news.": "Las respuestas citan informes, llamadas y noticias.",
   "{ticker} is open. {shortcut}, then AP, adds more.": "{ticker} está abierto. {shortcut} y luego AP añade más.",
   "Later: {shortcut}, then AP.": "Más tarde: {shortcut} y luego AP.",
-  "Enter: next field, then add.": "Enter: siguiente campo, luego añade.",
-  "Enter to add a ticker.": "Enter para añadir un ticker.",
+  "Enter: next field, then add": "Enter: siguiente campo, luego añade",
+  "Add one ticker to continue": "Añade un ticker para continuar",
+  "Add one ticker to continue.": "Añade un ticker para continuar.",
+  "Esc, then Enter: continue": "Esc y luego Enter: continuar",
+  "Enter to add a ticker": "Enter para añadir un ticker",
   "  already added": "  ya añadido",
   "Credentials stay on this device.": "Las credenciales se quedan en este dispositivo.",
   "Ask Gloom": "Ask Gloom",
@@ -1656,6 +1668,8 @@ export const es: Record<string, string> = {
   "Guides": "Guías",
   "Academy": "Academia",
   "offline, saved copy": "sin conexión, copia guardada",
+  "company data from {listing}": "datos de la empresa de {listing}",
+  "from {listing}": "de {listing}",
   "Open in Browser": "Abrir en el navegador",
   "No docs match \"{query}\".": "Nada en la documentación coincide con \"{query}\".",
   "No docs for {name} yet.": "Aún no hay documentación para {name}.",