@gloom-sh/terminal 0.19.1 → 0.19.3

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

@@ -1,4 +1,5 @@
 import { classifyInstrumentType, isCryptoVenuePerpetual } from "../../tickers/instrument-kind";
+import type { PriceBasis } from "../../types/instrument";
 
 /**
  * The unit an index level is in, as a chart's axis and series name it. A
@@ -28,11 +29,12 @@ export function quotePriceCurrency(quote: { currency?: string | null; instrument
 }
 
 /**
- * What a price chart of the instrument reads in: points for an index level,
- * otherwise its currency, so an axis never puts a dollar sign on ^VIX.
+ * What a price chart reads in: the quote's price basis, points for an index
+ * level, otherwise its currency.
  */
-export function priceSeriesUnit(currency: string, instrumentType: string | null | undefined): string {
-  return isIndexLevel(instrumentType) ? INDEX_POINTS_UNIT : currency;
+export function priceSeriesUnit(currency: string, instrumentType: string | null | undefined, priceBasis?: PriceBasis): string {
+  if (priceBasis === "thirty-seconds") return "32nds";
+  return priceBasis === "points" || isIndexLevel(instrumentType) ? INDEX_POINTS_UNIT : currency;
 }
 
 /**

package/src/market-data/published-apac-sessions.ts

@@ -21,6 +21,9 @@
 // EGX closes on Egypt's public holidays, often moved to the Thursday of their
 // week (Armed Forces Day, Tuesday 6 Oct 2026, to Thursday 8 Oct, by the
 // exchange's statement of 5 Oct). Its week is Sunday to Thursday.
+// JSE closes on South Africa's public holidays, a Sunday one moving to the Monday (Women's Day, 9 Aug 2026):
+//   JSE Market Notice 380/25, JSE Markets Calendar 2026 (clientportal.jse.co.za), and the
+//   local government election day, Wed 4 Nov 2026, declared a public holiday on 15 Sep 2026 (gov.za).
 const KRX_CLOSURES: Record<number, readonly string[]> = {
   2026: [
     "01-01", "02-16", "02-17", "02-18", "03-02", "05-01", "05-05", "05-25", "06-03",
@@ -79,6 +82,9 @@ export const PUBLISHED_APAC_CLOSURES: Readonly<Record<string, Record<number, rea
     2026: ["01-01", "01-26", "04-03", "04-06", "06-08", "12-25", "12-28"],
     2027: ["01-01", "01-26", "03-26", "03-29", "06-14", "12-27", "12-28"],
   },
+  JSE: {
+    2026: ["01-01", "04-03", "04-06", "04-27", "05-01", "06-16", "08-10", "09-24", "11-04", "12-16", "12-25"],
+  },
   EGX: {
     2026: [
       "01-01", "01-07", "01-29", "03-19", "03-22", "03-23", "04-12", "04-13", "05-07",

package/src/market-data/realized-volatility.ts

@@ -3,6 +3,7 @@ import { barsPerYear } from "./bars-per-year";
 import {
   mergePriceHistoryIntegrity,
   pricePointIntegrity,
+  pricePointWicks,
   type PriceHistoryIntegrity,
 } from "../utils/price-history-integrity";
 
@@ -115,8 +116,9 @@ function observations(points: readonly PricePoint[]): Observation[] | null {
     time,
     close: positiveLog(point.close),
     open: positiveLog(point.open),
-    high: positiveLog(point.high),
-    low: positiveLog(point.low),
+    // A wick too far from the bar's body to have traded is missing, not a range.
+    high: positiveLog(pricePointWicks(point).high),
+    low: positiveLog(pricePointWicks(point).low),
     integrity: pricePointIntegrity(point),
   }));
 }

package/src/news/aggregator.ts

@@ -17,6 +17,7 @@ import {
   normalizeNewsFeed,
   normalizeNewsQuery,
 } from "./news-model";
+import { storyIdMatches } from "./story-id";
 
 export { buildNewsQueryKey } from "./news-model";
 
@@ -343,16 +344,17 @@ export class NewsService {
     const sources = this.enabledSources({ feed: "latest" })
       .filter((source) => !!source.provider.fetchNewsStory);
 
+    // A short id (`6067684e`, as `news` prints it) names the story whose id starts with it.
     const requestedRevisions = new Map<NewsQueryEntry, string>();
     for (const entry of this.queries.values()) {
-      const article = entry.state.articles.find((article) => article.id === storyId);
+      const article = entry.state.articles.find((article) => storyIdMatches(article.id, storyId));
       if (article) requestedRevisions.set(entry, newsArticleRevision(article));
     }
     let failed = false;
     let olderDetail: NewsArticle | null = null;
     const commitDetail = (article: NewsArticle) => {
       this.mergeStoryDetail(article, requestedRevisions);
-      return this.articles.find((current) => current.id === storyId) ?? article;
+      return this.articles.find((current) => current.id === article.id) ?? article;
     };
     for (const source of sources) {
       try {
@@ -362,8 +364,9 @@ export class NewsService {
           () => source.provider.fetchNewsStory?.(storyId) ?? Promise.resolve(null),
         );
         if (!article) continue;
-        if (article.id !== storyId) throw new Error("Story detail identity mismatch.");
-        const current = this.articles.find((current) => current.id === storyId);
+        // The source answers a short id with the full id of the story it starts.
+        if (!storyIdMatches(article.id, storyId)) throw new Error("Story detail identity mismatch.");
+        const current = this.articles.find((current) => current.id === article.id);
         if (current && article.publishedAt < current.publishedAt) {
           if (!olderDetail || article.publishedAt > olderDetail.publishedAt) olderDetail = article;
           continue;

package/src/news/news-model.ts

@@ -245,3 +245,14 @@ export function filterNewsArticlesForQuery(items: NewsArticle[], query: NewsQuer
   // Page size is a fetch hint. Accumulated load-more results keep MAX_ARTICLES.
   return filtered.slice(0, MAX_ARTICLES);
 }
+
+/**
+ * A story's summary as one line under its row in a text list (`news`,
+ * `fn CN`): its whitespace and line breaks run together, null when it has
+ * none or only repeats the headline.
+ */
+export function newsSummaryLine(article: Pick<NewsArticle, "title" | "summary">): string | null {
+  const summary = article.summary?.replace(/\s+/g, " ").trim();
+  if (!summary || summary.toLowerCase() === article.title.trim().toLowerCase()) return null;
+  return summary;
+}

package/src/news/story-id.ts

@@ -0,0 +1,22 @@
+/**
+ * A Gloom Cloud story's short id: the first eight characters of its id
+ * (`6067684e` for `6067684e-2e13-41c5-a7cf-5052b3cefc07`), which `news`
+ * prints on each row and the story pane opens (`fn news-story-pane 6067684e`).
+ * Gloom Cloud opens the one story whose id starts with it.
+ */
+const SHORT_STORY_ID_LENGTH = 8;
+
+const STORY_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const SHORT_ID = /^[0-9a-f]{8}$/i;
+
+/** The id a row prints: a Gloom Cloud story's short id, any other source's id as it is. */
+export function shortStoryId(id: string): string {
+  return STORY_UUID.test(id) ? id.slice(0, SHORT_STORY_ID_LENGTH).toLowerCase() : id;
+}
+
+/** Whether `id` is the story `wanted` names, by its full id or its short one, in any case. */
+export function storyIdMatches(id: string, wanted: string): boolean {
+  const typed = wanted.trim().toLowerCase();
+  const own = id.toLowerCase();
+  return own === typed || (SHORT_ID.test(typed) && STORY_UUID.test(own) && own.startsWith(typed));
+}

package/src/news/ticker-symbols.ts

@@ -1,7 +1,23 @@
+import { isPredictionMarketExchange, isUsListingExchange, parsePublicTickerKey } from "../utils/exchanges";
+
+/** US over-the-counter venues: OTC Markets' tiers (OTC, OTCM, OTCQX...), the Pink market (PINX) and the Expert Market (EXPM). */
+const OTC_VENUE = /^(?:OTC|PINX|PINK|PNK|EXPM)/;
+
+/**
+ * A story's tag for a listing: the bare symbol on a US venue (or over the
+ * counter) and for a coin, the symbol and its venue elsewhere. PIK on the JSE
+ * is Pick n Pay, and bare PIK opens Kidpik on NASDAQ.
+ */
 function newsDisplayTickerSymbol(value: string | null | undefined): string | null {
   const normalized = value?.trim().toUpperCase();
   if (!normalized) return null;
-  return normalized.split(":")[0] || null;
+  const listing = parsePublicTickerKey(normalized);
+  const venue = listing.exchange ?? "";
+  if (!listing.symbol) return null;
+  if (isPredictionMarketExchange(venue)) return normalized;
+  return !venue || isUsListingExchange(venue) || OTC_VENUE.test(venue) || venue === "CRYPTO"
+    ? listing.symbol
+    : `${listing.symbol}:${venue}`;
 }
 
 export function collectNewsDisplayTickers(

package/src/notifications/app-notifier.ts

@@ -16,14 +16,17 @@ function getRuntimePlatform(): NodeJS.Platform {
 export interface DesktopNotificationCommand {
   command: string;
   args: string[];
+  /** Added to the environment of the process, for text a command line must not carry. */
+  env?: Record<string, string>;
+}
+
+interface DesktopNotificationRunOptions {
+  env?: Record<string, string>;
+  onError?: (error: NodeJS.ErrnoException) => void;
 }
 
 export interface DesktopNotificationRunner {
-  run(
-    command: string,
-    args: string[],
-    handlers?: { onError?: (error: NodeJS.ErrnoException) => void },
-  ): void;
+  run(command: string, args: string[], options?: DesktopNotificationRunOptions): void;
 }
 
 export interface DesktopNotificationSink {
@@ -46,8 +49,14 @@ function escapeAppleScriptString(value: string): string {
     .replace(/"/g, "\\\"")}"`;
 }
 
-function escapePowerShellString(value: string): string {
-  return `'${value.replace(/'/g, "''")}'`;
+const WINDOWS_NOTIFICATION_TITLE_ENV = "GLOOM_NOTIFICATION_TITLE";
+const WINDOWS_NOTIFICATION_TEXT_ENV = "GLOOM_NOTIFICATION_TEXT";
+/** The most of a title or a body handed to Windows; a balloon shows far less, and an environment value has a hard limit. */
+const WINDOWS_NOTIFICATION_TEXT_LIMIT = 4_000;
+
+/** NUL ends an environment value early, and spawning with one in it fails. */
+function windowsEnvText(value: string): string {
+  return value.replaceAll("\0", "").slice(0, WINDOWS_NOTIFICATION_TEXT_LIMIT);
 }
 
 function mapLinuxUrgency(type: AppNotificationType | undefined): "low" | "normal" | "critical" {
@@ -105,6 +114,8 @@ export function buildDesktopNotificationCommand(
         DEFAULT_NOTIFICATION_TITLE,
         "--urgency",
         mapLinuxUrgency(notification.type),
+        // Text that starts with `-` is the title or the body, not an option.
+        "--",
         title,
         ...(linuxBody ? [linuxBody] : []),
       ],
@@ -112,14 +123,16 @@ export function buildDesktopNotificationCommand(
   }
 
   if (platform === "win32") {
-    const balloonBody = buildWindowsBody(notification);
+    // The script is the same for every notification. The title and the text
+    // reach it in the environment of the process, where PowerShell reads them
+    // as plain strings and never as code, whatever characters they hold.
     const script = [
       "Add-Type -AssemblyName System.Windows.Forms;",
       "Add-Type -AssemblyName System.Drawing;",
       "$notify = New-Object System.Windows.Forms.NotifyIcon;",
       `$notify.Icon = [System.Drawing.SystemIcons]::${mapWindowsIcon(notification.type)};`,
-      `$notify.BalloonTipTitle = ${escapePowerShellString(title)};`,
-      `$notify.BalloonTipText = ${escapePowerShellString(balloonBody)};`,
+      `$notify.BalloonTipTitle = $env:${WINDOWS_NOTIFICATION_TITLE_ENV};`,
+      `$notify.BalloonTipText = $env:${WINDOWS_NOTIFICATION_TEXT_ENV};`,
       "$notify.Visible = $true;",
       "$notify.ShowBalloonTip(5000);",
       "Start-Sleep -Seconds 6;",
@@ -128,6 +141,10 @@ export function buildDesktopNotificationCommand(
     return {
       command: "powershell.exe",
       args: ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", script],
+      env: {
+        [WINDOWS_NOTIFICATION_TITLE_ENV]: windowsEnvText(title),
+        [WINDOWS_NOTIFICATION_TEXT_ENV]: windowsEnvText(buildWindowsBody(notification)),
+      },
     };
   }
 
@@ -137,19 +154,22 @@ export function buildDesktopNotificationCommand(
 function defaultDesktopNotificationRunner(
   command: string,
   args: string[],
-  handlers?: { onError?: (error: NodeJS.ErrnoException) => void },
+  options?: DesktopNotificationRunOptions,
 ): void {
   if (typeof Bun !== "undefined" && typeof Bun.spawn === "function") {
     try {
-      const child = Bun.spawn([command, ...args], { stdio: ["ignore", "ignore", "ignore"] });
+      const child = Bun.spawn([command, ...args], {
+        stdio: ["ignore", "ignore", "ignore"],
+        ...(options?.env ? { env: { ...process.env, ...options.env } } : {}),
+      });
       child.unref();
     } catch (error) {
-      handlers?.onError?.(error as NodeJS.ErrnoException);
+      options?.onError?.(error as NodeJS.ErrnoException);
     }
     return;
   }
 
-  handlers?.onError?.(Object.assign(new Error("Desktop notifications require a native process host."), {
+  options?.onError?.(Object.assign(new Error("Desktop notifications require a native process host."), {
     code: "ENOSYS",
   }) as NodeJS.ErrnoException);
 }
@@ -203,6 +223,7 @@ export function createDesktopNotifier(
       if (desktopCommand && disabledCommand !== desktopCommand.command) {
         let requestFailed = false;
         runner.run(desktopCommand.command, desktopCommand.args, {
+          env: desktopCommand.env,
           onError: (error) => {
             requestFailed = true;
             if (error.code === "ENOENT") {

package/src/plugins/auto-update-node.ts

@@ -37,24 +37,28 @@ function readJson(path: string): Record<string, unknown> | null {
 }
 
 async function readCheckouts(): Promise<PluginCheckout[]> {
-  const { installedPluginDirectories, readPluginRemote } = await installer();
+  const { installedPluginDirectories, readPluginRemoteAsync } = await installer();
   const pluginsDir = getPluginsDir();
-  return installedPluginDirectories().map((directory) => {
+  const checkouts: PluginCheckout[] = [];
+  // One git at a time: starting a process holds the thread for a moment, and
+  // starting them all at once adds those moments up into one pause.
+  for (const directory of installedPluginDirectories()) {
     const dir = join(pluginsDir, directory);
     const pkg = readJson(join(dir, "package.json"));
     const dependencies = pkg?.dependencies;
-    return {
+    checkouts.push({
       directory,
       id: readPluginManifest(dir).id,
-      repo: existsSync(join(dir, ".git")) ? readPluginRemote(dir) : null,
+      repo: existsSync(join(dir, ".git")) ? await readPluginRemoteAsync(dir) : null,
       commit: readPluginCommit(dir),
       version: typeof pkg?.version === "string" ? pkg.version : null,
       linked: lstatSync(dir, { throwIfNoEntry: false })?.isSymbolicLink() === true,
       needsGloomberb: checkPluginCompatibility(dir)?.needsGloomberb ?? null,
       peers: installedPeerPlugins(dir, pluginsDir).map((peer) => peer.directory),
       hasDependencies: !!dependencies && typeof dependencies === "object" && Object.keys(dependencies).length > 0,
-    };
-  });
+    });
+  }
+  return checkouts;
 }
 
 function createNodeAutoUpdateDeps(manager: PluginManager): PluginAutoUpdateDeps {

package/src/plugins/builtin/account-management/form-components.tsx

@@ -157,7 +157,7 @@ export function PublicAnalyticsGroup({
 
 /**
  * The desks chat shows beside your name, once What I Trade is on: pre-filled
- * from your answer to "What do you trade?", coarse words only.
+ * from your answer to "What do you trade most?", coarse words only.
  */
 export function DeskChoiceRow({
   desks,

package/src/plugins/builtin/account-management/index.tsx

@@ -1,5 +1,4 @@
 import type { PluginModule } from "../plugin-module";
-import { AccountManagementPane } from "./pane";
 
 export const accountManagementModule: PluginModule = {
   panes: [{
@@ -7,8 +6,8 @@ export const accountManagementModule: PluginModule = {
     name: "ACM",
     icon: "A",
     personalData: "account",
-    component: AccountManagementPane,
-    reportFreshness: { status: "not-a-feed", basis: "account data" },
+    get component(): typeof import("./pane").AccountManagementPane { const { AccountManagementPane } = require("./pane"); return AccountManagementPane; },
+    reportFreshness: { status: "not-a-feed", basis: "account data", local: true },
     defaultPosition: "right",
     defaultMode: "floating",
     defaultFloatingSize: { width: 72, height: 36 },

package/src/plugins/builtin/account-management/model.ts

@@ -44,7 +44,7 @@ export interface AccountDraft {
   showLocalTime: boolean;
   /** Chat shows what you trade: off until you turn it on. */
   showDesks: boolean;
-  /** The desks to show, pre-filled from your answer to "What do you trade?". */
+  /** The desks to show, pre-filled from your answer to "What do you trade most?". */
   desks: string[];
   weeklyRoundupEnabled: boolean;
   positionAlertsEnabled: boolean;

package/src/plugins/builtin/alerts/cli-forms.ts

@@ -33,6 +33,7 @@ export const ALERT_ADD_FORMS: readonly AlertAddForm[] = [
   { name: "short interest", usage: "<symbol> short interest [increase|decrease] [<percent>%]" },
   { name: "analyst change", usage: "<symbol> analyst [upgrade|downgrade]" },
   { name: "hiring move", usage: "<symbol> hiring [accelerating|slowing]" },
+  { name: "IPO", usage: "ipo <company or keyword>" },
   { name: "perpetual market", usage: "perps <market> <funding|oi|premium|closed-premium> <above|below> <percent>" },
   { name: "catalyst", usage: "catalyst [type <type> | agency <agency> | country <code>]" },
   { name: "catalyst", usage: "<symbol> catalyst" },
@@ -173,6 +174,17 @@ function perpsRule(words: readonly string[]): RuleAddRequest {
   return { kind: "rule", event: "perps_threshold", symbol: null, listing: "any", values: { marketId, metric, direction, threshold } };
 }
 
+/**
+ * `ipo Stripe`, `ipo "Space Exploration"`: a company or keyword on the IPO calendar, followed until its deal
+ * is on the calendar, dated, priced and trading. Kept as typed, 2 to 80 characters, as the form takes it.
+ */
+function ipoRule(words: readonly string[]): RuleAddRequest {
+  const keyword = words.join(" ").trim().replace(/\s+/g, " ");
+  if (!keyword) throw new Error("Name the company or a keyword: gloom alerts add ipo Stripe.");
+  if (keyword.length < 2 || keyword.length > 80) throw new Error(`An IPO alert follows a company or keyword of 2 to 80 characters, not "${keyword}": gloom alerts add ipo Stripe.`);
+  return { kind: "rule", event: "ipo", symbol: null, listing: "any", values: { keyword } };
+}
+
 /** `catalyst`, `catalyst type clinical`, `catalyst agency FDA`, `catalyst country US`: the catalysts followed with no company. */
 function catalystRule(words: readonly string[]): RuleAddRequest {
   if (words.length === 0) return { kind: "rule", event: "catalyst-watched", symbol: null, listing: "any", values: {} };
@@ -192,7 +204,7 @@ function catalystRule(words: readonly string[]): RuleAddRequest {
  * The forms of `alerts add` for the rest of what Add Event Alert offers:
  * 52-week range, unusual volume, filings, insider trades, short interest,
  * analyst changes and hiring on a symbol, perpetual markets, catalysts,
- * Congress trades and 13F filings. Null for any other words; throws, naming
+ * IPOs, Congress trades and 13F filings. Null for any other words; throws, naming
  * the form, when one of them is mistyped. A symbol that spells a form word
  * (`PERPS above 10`) is still a price alert.
  */
@@ -202,6 +214,8 @@ export function parseRuleAddArgs(args: readonly string[]): RuleAddRequest | null
   if (!CONDITION_WORDS.has(word(rest[0]))) {
     if (lead === "perps" || lead === "perp") return perpsRule(rest);
     if (lead === "catalyst" || lead === "catalysts") return catalystRule(rest);
+    // The IPO ETF keeps its other alerts written with its venue (IPO:NYSEARCA 52-week high).
+    if (lead === "ipo") return ipoRule(rest);
     if (lead === "congress") {
       const member = rest.join(" ").trim();
       return { kind: "rule", event: member ? "congress-member" : "congress-watched", symbol: null, listing: "any", values: member ? { value: member } : {} };

package/src/plugins/builtin/alerts/events-pane.tsx

@@ -17,6 +17,7 @@ import { usePluginAppActions, usePluginConfigState, usePluginState } from "../..
 import {
   CALENDAR_ALERTS_KEY,
   EVENT_ALERTS_KEY,
+  IPO_ALERTS_KEY,
   IV_LEVEL_ALERTS_KEY,
   eventAlertStoreKey,
   eventAlertTarget,
@@ -54,12 +55,13 @@ const columnsFor = (width: number, lastCheck: boolean, needsSignIn: boolean): Da
 export function EventAlertsPane({ focused, width, height }: PaneProps) {
   const [catalystStatus] = usePluginConfigState<string>(CATALYST_POLL_STATUS, "Catalyst alerts check every five minutes while the app is open");
   const [json, setJson] = usePluginConfigState<string>(EVENT_ALERTS_KEY, "[]");
-  // IV levels and calendar events are kept in their own lists, which released versions never read.
+  // IV levels, calendar events and IPOs are kept in their own lists, which released versions never read.
   const [ivJson, setIvJson] = usePluginConfigState<string>(IV_LEVEL_ALERTS_KEY, "[]");
   const [calendarJson, setCalendarJson] = usePluginConfigState<string>(CALENDAR_ALERTS_KEY, "[]");
+  const [ipoJson, setIpoJson] = usePluginConfigState<string>(IPO_ALERTS_KEY, "[]");
   const { rules, error } = useMemo(
-    () => readEventAlertStores((key) => key === IV_LEVEL_ALERTS_KEY ? ivJson : key === CALENDAR_ALERTS_KEY ? calendarJson : json),
-    [json, ivJson, calendarJson],
+    () => readEventAlertStores((key) => key === IV_LEVEL_ALERTS_KEY ? ivJson : key === CALENDAR_ALERTS_KEY ? calendarJson : key === IPO_ALERTS_KEY ? ipoJson : json),
+    [json, ivJson, calendarJson, ipoJson],
   );
   // Their readings stay on this device.
   const [savedChecks] = usePluginState<unknown>(IV_LEVEL_CHECKS_KEY, {});
@@ -70,9 +72,9 @@ export function EventAlertsPane({ focused, width, height }: PaneProps) {
   const updateRules = useCallback(
     (rule: EventAlertRule, update: (rules: EventAlertRule[]) => EventAlertRule[]) => {
       const key = eventAlertStoreKey(rule);
-      (key === IV_LEVEL_ALERTS_KEY ? setIvJson : key === CALENDAR_ALERTS_KEY ? setCalendarJson : setJson)((current) => updateEventAlerts(current, update));
+      (key === IV_LEVEL_ALERTS_KEY ? setIvJson : key === CALENDAR_ALERTS_KEY ? setCalendarJson : key === IPO_ALERTS_KEY ? setIpoJson : setJson)((current) => updateEventAlerts(current, update));
     },
-    [setJson, setIvJson, setCalendarJson],
+    [setJson, setIvJson, setCalendarJson, setIpoJson],
   );
   const [selected, setSelected] = useState(0);
   const [sort, setSort] = useState<{ columnId: string; direction: SortDirection }>({ columnId: "created", direction: "desc" });

package/src/plugins/builtin/alerts/events.ts

@@ -16,14 +16,22 @@ export const IV_LEVEL_ALERTS_KEY = "ivLevelAlerts";
  * every version reads.
  */
 export const CALENDAR_ALERTS_KEY = "calendarAlerts";
+/**
+ * IPO rules, kept apart for the same reason. Gloom Cloud checks them, so it
+ * reads this list beside `eventAlerts`.
+ */
+export const IPO_ALERTS_KEY = "ipoAlerts";
 export const MAX_EVENT_ALERTS = 40;
 
 /** The config key a rule is kept under. */
 export const eventAlertStoreKey = (rule: Pick<EventAlertRule, "kind">) =>
-  rule.kind === "iv_level" ? IV_LEVEL_ALERTS_KEY : rule.kind === "calendar_event" ? CALENDAR_ALERTS_KEY : EVENT_ALERTS_KEY;
+  rule.kind === "iv_level" ? IV_LEVEL_ALERTS_KEY
+    : rule.kind === "calendar_event" ? CALENDAR_ALERTS_KEY
+      : rule.kind === "ipo" ? IPO_ALERTS_KEY
+        : EVENT_ALERTS_KEY;
 
 /** Every config key event alerts are kept under. */
-export const EVENT_ALERT_STORE_KEYS = [EVENT_ALERTS_KEY, IV_LEVEL_ALERTS_KEY, CALENDAR_ALERTS_KEY] as const;
+export const EVENT_ALERT_STORE_KEYS = [EVENT_ALERTS_KEY, IV_LEVEL_ALERTS_KEY, CALENDAR_ALERTS_KEY, IPO_ALERTS_KEY] as const;
 type EventAlertStoreKey = (typeof EVENT_ALERT_STORE_KEYS)[number];
 
 export interface EventAlertRule {

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

@@ -38,9 +38,8 @@ import {
   parseAlertCommandValues,
   parseAlertShortcutValues,
 } from "./command";
-import { POLL_INTERVAL_MS, POLL_SECONDS_KEY } from "./constants";
+import { ALERTS_PLUGIN_ID, POLL_INTERVAL_MS, POLL_SECONDS_KEY } from "./constants";
 import { alertHistoryLockNote, alertsHeadless } from "./headless";
-import { AlertsPane } from "./pane";
 import { alertsCliCommand } from "./cli";
 import {
   createQuoteErrorMessage,
@@ -81,7 +80,7 @@ function slashSpellsListing(symbol: string): boolean {
 }
 
 export const alertsPlugin: GloomPlugin = {
-  id: "alerts",
+  id: ALERTS_PLUGIN_ID,
   name: "Alerts",
   version: "1.0.0",
   description: "Price, valuation, daily technical and event alerts",
@@ -278,11 +277,12 @@ export const alertsPlugin: GloomPlugin = {
     ctx.registerCommand({
       id: "set-event-alert",
       label: "Add Event Alert",
-      description: "Create an alert before earnings, CPI or FOMC, when earnings results are out, or for filings, news, IV levels, hiring and market moves",
+      description: "Create an alert before earnings, CPI or FOMC, when earnings results are out, or for filings, news, IPOs, IV levels, hiring and market moves",
       keywords: [
         "alert", "event", "congress", "13f", "fund", "member", "follow", "earnings", "cpi", "fomc", "days before",
         "filing", "filings", "sec", "8-k", "news", "keyword", "analyst", "52-week", "unusual volume", "volume",
         "short interest", "insider", "catalyst", "implied volatility", "iv spike", "iv level", "risk reversal", "skew", "options flow", "perps", "funding", "hiring", "jobs",
+        "ipo", "going public", "listing",
       ],
       category: "data",
       wizardLayout: "form",
@@ -463,7 +463,7 @@ export const alertsPlugin: GloomPlugin = {
       reportLockNote: alertHistoryLockNote,
       name: "Alerts",
       icon: "A",
-      component: AlertsPane,
+      get component(): typeof import("./pane").AlertsPane { const { AlertsPane } = require("./pane"); return AlertsPane; },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 82, height: 20 },

package/src/plugins/builtin/alerts/research-builder.ts

@@ -6,7 +6,7 @@ import type { EventAlertRule } from "./events";
 export const MACRO_EVENT_NAMES: Record<MacroAlertEvent, string> = { cpi: "CPI release", fomc: "FOMC decision" };
 /** CPI and FOMC and any other calendar release are one kind of alert to the reader, whichever list keeps the rule. */
 export const RESEARCH_LABELS: Record<ResearchAlertKind, string> = {
-  perps_threshold: "Perpetual threshold", earnings_date: "Earnings date", macro_event: "Macro event", calendar_event: "Macro event", filing_type: "SEC filing", news_keyword: "News keyword", analyst_change: "Analyst change", fifty_two_week: "52-week range", unusual_volume: "Unusual volume", short_interest_change: "Short interest", insider_trade: "Insider trade", iv_spike: "IV spike", iv_level: "IV level", options_flow: "Options flow", hiring_move: "Hiring move",
+  perps_threshold: "Perpetual threshold", earnings_date: "Earnings date", macro_event: "Macro event", calendar_event: "Macro event", ipo: "IPO", filing_type: "SEC filing", news_keyword: "News keyword", analyst_change: "Analyst change", fifty_two_week: "52-week range", unusual_volume: "Unusual volume", short_interest_change: "Short interest", insider_trade: "Insider trade", iv_spike: "IV spike", iv_level: "IV level", options_flow: "Options flow", hiring_move: "Hiring move",
 };
 /** What an IV level rule follows, as the form, a list and a notification name it. */
 export const IV_LEVEL_NAMES: Record<IvLevelMetric, string> = { atm: "30d ATM IV", rr: "30d 25D RR" };
@@ -46,6 +46,8 @@ export const researchWizardFields: Field[] = RESEARCH_FORM_KINDS.flatMap(kind =>
     : kind === "macro_event" ? [{key:"event", label:"Release", type:"select", defaultValue:"cpi", options:MACRO_ALERT_EVENTS.map((value) => ({value, label:MACRO_EVENT_NAMES[value]}))}]
     // HIRE covers listings worldwide; a non-US one is written with its venue.
     : kind === "hiring_move" ? [{key:"symbol", label:"Symbol", type:"text", placeholder:"RIVN or ADYEN:AMS", required:true}]
+    // A deal on the IPO calendar has no listing to name yet: it is followed by its name.
+    : kind === "ipo" ? [{key:"keyword", label:"Company or keyword", type:"text", placeholder:"Stripe", required:true}]
     : [{key:"symbol",label:kind === "news_keyword" ? "Symbol (optional)" : kind === "options_flow" ? "Symbol (blank: portfolio and watchlists)" : "Symbol",type:"text",placeholder:"AAPL", required:kind !== "news_keyword" && kind !== "options_flow"},
       {key:"exchange",label:"US exchange",type:"select",defaultValue:"US",options:choices(["US","NASDAQ","NYSE","ARCA","AMEX","BATS","OTC"])}];
   if (kind === "earnings_date") {
@@ -92,6 +94,7 @@ export function createResearchAlert(kind: string, values: Record<string,string>,
   if (!value) throw new Error(kind === "options_flow"
     ? "Check the symbol and US exchange. The minimum premium is $50,000."
     : kind === "hiring_move" ? "Check the symbol. Write a non-US listing with its exchange, as ADYEN:AMS."
+    : kind === "ipo" ? "Name a company or keyword of 2 to 80 characters, such as Stripe."
     : kind === "iv_level"
       ? "Check the symbol and US exchange. An ATM IV level is 1 to 500 (%), a risk reversal -50 to 50 (vol pts)."
       : kind === "iv_spike"
@@ -142,6 +145,7 @@ export function researchAlertDescription(rule: EventAlertRule): string {
     case "news_keyword": return `${symbol} · ${config.keyword}`;
     case "analyst_change": case "insider_trade": return `${symbol} · ${config.direction}`;
     case "hiring_move": return `${symbol} · ${config.direction === "either" ? "accelerating or slowing" : config.direction}`;
+    case "ipo": return config.keyword ?? "";
     case "fifty_two_week": return `${symbol} · 52w ${config.direction}`;
     case "unusual_volume": return `${symbol} · ≥${config.threshold}× 20d`;
     case "short_interest_change": return `${symbol} · ${config.direction} ≥${config.threshold}%`;

package/src/plugins/builtin/alerts/research-rules.ts

@@ -15,6 +15,7 @@ const RESEARCH_ALERT_KINDS = [
   "options_flow",
   "perps_threshold",
   "hiring_move",
+  "ipo",
 ] as const
 export type ResearchAlertKind = (typeof RESEARCH_ALERT_KINDS)[number]
 export interface ResearchAlertConfig {
@@ -162,6 +163,8 @@ export function normalizeResearchRule(
           : ""
       if (!/^[A-Z0-9][A-Z0-9.:-]{0,31}$/.test(symbol)) return null
       result.symbol = symbol
+    } else if (kind === "ipo") {
+      // A company or keyword looked for on the IPO calendar: no listing yet, so no symbol.
     } else if (
       (kind !== "news_keyword" && kind !== "options_flow") ||
       input.symbol
@@ -253,6 +256,21 @@ export function normalizeResearchRule(
         result.keyword = keyword
         break
       }
+      case "ipo": {
+        // Kept as typed, for the lists; Gloom Cloud matches it in any case.
+        const keyword =
+          typeof input.keyword === "string"
+            ? input.keyword.trim().replace(/\s+/g, " ")
+            : ""
+        if (
+          keyword.length < 2 ||
+          keyword.length > 80 ||
+          /[\u0000-\u001f]/.test(keyword)
+        )
+          return null
+        result.keyword = keyword
+        break
+      }
       case "analyst_change":
         direction(["any", "upgrade", "downgrade"], "any")
         break

package/src/plugins/builtin/alerts/targets.ts

@@ -36,7 +36,8 @@ const pane = (templateId: string, options?: PaneTemplateCreateOptions): AlertTar
  * The one map from what an alert follows to what it opens, for every rule kind and every delivered alert:
  * a perpetual opens PERP on its market; a dated event the pane its date comes from (ERN, CPI, WIRP, ECO); catalyst,
  * Congress and 13F rules their calendar or list, on the company or fund they name; an IV level the symbol's
- * OVDV, whose fits it reads; a hiring move HIRE on the company; any other rule on a security
+ * OVDV, whose fits it reads; a hiring move HIRE on the company; an IPO the IPO calendar searched for its
+ * company or keyword; any other rule on a security
  * that listing's DES. A rule on no security opens the pane it watches (SRCH for a news keyword, FLOW for flow
  * on the user's lists, FIRST for breaking news). Null when there is nothing to open.
  */
@@ -58,6 +59,8 @@ export function alertTarget(subject: AlertSubject): AlertTarget | null {
     case "breaking_news": if (!symbol) return pane("news-breaking-pane"); break;
     // A hiring move opens HIRE on the company, where its Moves tab says why.
     case "hiring_move": return symbol ? pane("hiring-pane", { symbol }) : null;
+    // An IPO opens the calendar searched for what the rule follows, its deal there whether it trades yet or not.
+    case "ipo": return pane("ipo-calendar-pane", subject.keyword ? { arg: subject.keyword } : undefined);
   }
   return symbol ? { kind: "description", symbol, ...(subject.exchange ? { exchange: subject.exchange } : {}) } : null;
 }

package/src/plugins/builtin/attention/headless.ts

@@ -6,7 +6,7 @@ export const attentionHeadless: HeadlessPaneDefinition<"bundle"> = {
   options: [{ key: "tab", type: "enum", values: ATTENTION_TABS.map(({ value }) => ({ value })), defaultValue: "ranking", description: "Rankings, abnormal attention, groups, history or evidence." },
     { key: "window", type: "enum", values: WINDOWS.map(({ value }) => ({ value })), defaultValue: "now", description: "Latest completed publication hour, UTC day or trailing week." }],
   discovery: { aliases: ["ATTN"], dataRequirements: ["Privacy-qualified published research counts"],
-    limitations: ["Pro dataset with three-row preview and latest history point.", "Suppressed hours are absent, never zero.", "Activity is opt-in and is not representative of all investors."] },
+    limitations: ["Pro dataset with three-row preview and latest history point.", "Suppressed hours are absent, never zero.", "Counts come from signed-in Gloom users and are not representative of all investors."] },
   describe: "Gloom research attention (Pro)",
   async load(args, ctx) {
     const argument = Array.isArray(args.argument) ? args.argument.join(" ") : args.argument;

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

@@ -2,14 +2,12 @@ import type { PluginModule } from "../plugin-module";
 import { attentionCache } from "./client";
 import { attentionWindow } from "./model";
 import { attentionHeadless } from "./headless";
-import { TrendingPane } from "./trending";
-import { AttentionPane } from "./pane";
 import { ATTENTION_SERIES } from "./series";
 import { ATTENTION_LISTED } from "./listing";
 export const attentionModule: PluginModule = {
-  panes: [{ id: "attention", name: "Research Attention", icon: "A", component: AttentionPane, defaultPosition: "right", defaultMode: "floating",
+  panes: [{ id: "attention", name: "Research Attention", icon: "A", get component(): typeof import("./pane").AttentionPane { const { AttentionPane } = require("./pane"); return AttentionPane; }, defaultPosition: "right", defaultMode: "floating",
     defaultFloatingSize: { width: 126, height: 32 }, tableExport: true, headless: attentionHeadless },
-    { id: "attention-trending", reportFreshness: { status: "not-a-feed", basis: "hourly publication" }, name: "Gloom Trending", icon: "A", component: TrendingPane, defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 58, height: 12 } }],
+    { id: "attention-trending", reportFreshness: { status: "not-a-feed", basis: "hourly publication" }, name: "Gloom Trending", icon: "A", get component(): typeof import("./trending").TrendingPane { const { TrendingPane } = require("./trending"); return TrendingPane; }, defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 58, height: 12 } }],
   paneTemplates: [{ id: "attention-pane", paneId: "attention", label: "Research Attention", listed: ATTENTION_LISTED,
     description: "Pro research attention: rankings, abnormal activity, sectors, countries and privacy-qualified hourly history.",
     keywords: ["attention", "trending", "research", "activity"], shortcut: { prefix: "ATTN", argKind: "text", argPlaceholder: "TICKER", argOptional: true },