gloomberb 0.18.4 → 0.19.0

package/src/plugins/builtin/chat/pane-links/commands.ts

@@ -0,0 +1,271 @@
+import { useSyncExternalStore } from "react";
+import { commands as coreCommands, getCommandPrefixes, type Command } from "../../../../components/command-bar/commands/registry";
+import { getPaneTemplateDisplayLabel, paneTemplateShortcutPrefixes } from "../../../../components/command-bar/pane-templates/items";
+import { getPaneShortcutArgKind } from "../../../../components/command-bar/routes/root/shortcuts";
+import type { CommandDef, PaneTemplateDef } from "../../../../types/plugin";
+
+/**
+ * What a function takes after its code in a message. Only an argument that
+ * names something to look at: free text is what some functions act on as they
+ * open (ASKG asks it, THESIS starts one), which one click on somebody else's
+ * message must never do, so those take none here.
+ */
+type ChatFunctionArg =
+  /** Nothing: the code alone. */
+  | "none"
+  /** One ticker: `DES AAPL`. */
+  | "ticker"
+  /** One or more tickers: `CMP AAPL MSFT`. */
+  | "tickers"
+  /** A function's code: `HELP OMON`. */
+  | "code"
+  /** One of the values the function names: `NI CRYPTO`. */
+  | "choice";
+
+/**
+ * A function a message can name in backticks (`NI CRYPTO`, `DES AAPL`,
+ * `CRYP`): a code the command bar runs, and what it opens.
+ */
+export interface ChatFunction {
+  /** The code to write for it, upper case. */
+  code: string;
+  /** Other codes that run the same function (T for DES). */
+  aliases: readonly string[];
+  /** What the function is called: the command bar's name for it. */
+  name: string;
+  arg: ChatFunctionArg;
+  /** For a choice, the values it takes. */
+  choices?: () => readonly string[];
+  /** Written as a chip when someone types it, but never suggested (`listed: false`). */
+  unlisted?: true;
+}
+
+/** A function named in a message, and the text the command bar runs for it. */
+export interface ChatCommand {
+  query: string;
+  fn: ChatFunction;
+}
+
+/**
+ * The commands a chip may run besides the functions that open panes: a
+ * company's description and the help window. Every other command changes
+ * settings or data (adds to a portfolio, switches the theme), which one click
+ * on somebody else's message must never do, so its code stays text.
+ */
+const OPENING_COMMAND_ARGS = new Map<string, ChatFunctionArg>([["security-description", "ticker"], ["help", "code"]]);
+
+export interface ChatFunctionSource {
+  paneTemplates: ReadonlyMap<string, PaneTemplateDef>;
+  commands: ReadonlyMap<string, CommandDef>;
+  /** Plugins switched off: the bar opens none of their functions, so they draw no chip. */
+  disabledPlugins?: readonly string[];
+  /** Whether a template's plugin (or its pane's) is one of those switched off. */
+  isTemplateOff?: (templateId: string) => boolean;
+}
+
+function upperCodes(codes: readonly string[]): string[] {
+  return codes.map((code) => code.trim().toUpperCase()).filter(Boolean);
+}
+
+function templateArg(template: PaneTemplateDef): Pick<ChatFunction, "arg" | "choices"> {
+  const kind = getPaneShortcutArgKind(template);
+  if (kind === "ticker") return { arg: "ticker" };
+  if (kind === "ticker-list") return { arg: "tickers" };
+  const options = template.shortcut?.argOptions;
+  if (kind === "text" && options) return { arg: "choice", choices: () => options().map((option) => option.value) };
+  return { arg: "none" };
+}
+
+/**
+ * The functions of the app's own panes and plugins, by every code that runs
+ * them, as the command bar matches its first word. A code the bar runs as a
+ * command that is not one of those above is left out, even where a pane
+ * shares it, since that command is what a click would run.
+ */
+export function chatFunctionsFrom(source: ChatFunctionSource, core: readonly Command[] = coreCommands): ReadonlyMap<string, ChatFunction> {
+  const byCode = new Map<string, ChatFunction>();
+  const taken = new Set<string>();
+  const add = (codes: readonly string[], fn: Omit<ChatFunction, "code" | "aliases"> | null) => {
+    const free = codes.filter((code) => !taken.has(code));
+    for (const code of codes) taken.add(code);
+    // A code of one letter only counts with its argument (`T AAPL`), so a
+    // function that takes none is written with a longer one (FH for N).
+    const usable = fn ? free.filter((code) => code.length > 1 || fn.arg !== "none") : [];
+    const [code, ...aliases] = usable;
+    if (!fn || !code) return;
+    const entry: ChatFunction = { ...fn, code, aliases };
+    for (const each of usable) byCode.set(each, entry);
+  };
+  for (const command of core) {
+    const arg = OPENING_COMMAND_ARGS.get(command.id);
+    add(upperCodes(getCommandPrefixes(command)), arg ? { name: command.label, arg } : null);
+  }
+  for (const command of source.commands.values()) {
+    const code = command.shortcut?.trim().toUpperCase();
+    if (code) taken.add(code);
+  }
+  for (const template of source.paneTemplates.values()) {
+    // A switched-off plugin's code opens nothing until it is turned on, and
+    // leaves the code to a function that does.
+    if (source.isTemplateOff?.(template.id)) continue;
+    add(upperCodes(paneTemplateShortcutPrefixes(template)), {
+      name: getPaneTemplateDisplayLabel(template),
+      ...templateArg(template),
+      ...(template.listed === false ? { unlisted: true as const } : {}),
+    });
+  }
+  return byCode;
+}
+
+/**
+ * Everything the functions are built from, in one string: a plugin swapped,
+ * a code moved to a command or a plugin switched off changes it, where the
+ * number of templates and commands may stay the same.
+ */
+function sourceSignature(source: ChatFunctionSource): string {
+  let signature = source.disabledPlugins?.join(",") ?? "";
+  for (const [id, template] of source.paneTemplates) {
+    const shortcut = template.shortcut;
+    if (!shortcut?.prefix) continue;
+    signature += `\n${id} ${shortcut.prefix} ${shortcut.aliases?.join(",") ?? ""} ${shortcut.argKind ?? shortcut.argPlaceholder ?? ""}${shortcut.argOptions ? " ?" : ""}`;
+  }
+  for (const command of source.commands.values()) {
+    if (command.shortcut) signature += `\n:${command.shortcut}`;
+  }
+  return signature;
+}
+
+const NO_FUNCTIONS: ReadonlyMap<string, ChatFunction> = new Map();
+const built = new WeakMap<object, { signature: string; functions: ReadonlyMap<string, ChatFunction> }>();
+
+/** The same, built again only when what they are built from changes. */
+export function cachedChatFunctions(source: ChatFunctionSource | null | undefined): ReadonlyMap<string, ChatFunction> {
+  if (!source) return NO_FUNCTIONS;
+  const signature = sourceSignature(source);
+  const cached = built.get(source.paneTemplates);
+  if (cached?.signature === signature) return cached.functions;
+  const functions = chatFunctionsFrom(source);
+  built.set(source.paneTemplates, { signature, functions });
+  return functions;
+}
+
+interface ChatCommandHost {
+  functions(): ReadonlyMap<string, ChatFunction>;
+  /** Runs the text in the command bar, as if typed there and entered. */
+  run(query: string): void;
+}
+
+let host: ChatCommandHost | null = null;
+const listeners = new Set<() => void>();
+/** The functions messages are drawn with, read again when the app's plugins or settings change. */
+let drawn: ReadonlyMap<string, ChatFunction> = NO_FUNCTIONS;
+
+/**
+ * Tells the messages already drawn that the functions may have changed (a
+ * plugin came in late, or was switched off); only those that did redraw.
+ */
+export function chatFunctionsChanged(): void {
+  const next = chatFunctions();
+  if (next === drawn) return;
+  drawn = next;
+  for (const listener of [...listeners]) listener();
+}
+
+/** The chat plugin hands over the app's functions and its command bar. */
+export function attachChatCommands(next: ChatCommandHost): () => void {
+  host = next;
+  chatFunctionsChanged();
+  return () => {
+    if (host !== next) return;
+    host = null;
+    chatFunctionsChanged();
+  };
+}
+
+function chatFunctions(): ReadonlyMap<string, ChatFunction> {
+  return host?.functions() ?? NO_FUNCTIONS;
+}
+
+function subscribeChatFunctions(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+const drawnFunctions = () => drawn;
+
+/**
+ * The functions, for a view that draws them: it redraws when they change.
+ * Every line of every message reads them, so they are not built again here;
+ * a click checks its function against the app as it is then.
+ */
+export function useChatFunctions(): ReadonlyMap<string, ChatFunction> {
+  return useSyncExternalStore(subscribeChatFunctions, drawnFunctions, drawnFunctions);
+}
+
+/**
+ * Runs a function a chip names, if it is still one: what the bar runs for
+ * the code may have changed since the message was drawn.
+ */
+export function runChatCommand(query: string): void {
+  const command = resolveChatCommand(query);
+  if (command) host?.run(command.query);
+}
+
+/** Past this a span in backticks is a sentence or code, not a function and its argument. */
+const MAX_COMMAND_LENGTH = 48;
+const MAX_TICKERS = 12;
+/** Marks that change how text reads without being seen: direction overrides, zero-width joiners, controls. */
+const INVISIBLE_RE = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u00ad\u061c\u200b-\u200f\u202a-\u202e\u2060-\u2069\ufeff]/g;
+/** A symbol as written: AAPL, BRK.B, BTC-USD, ES=F, SMSN:LSE, ^GSPC. With a letter, so `GP 100` is not one. */
+const TICKER_RE = /^\^?[A-Z0-9][A-Z0-9.:=/!-]{0,23}$/;
+const CODE_RE = /^[A-Z][A-Z0-9]{0,11}$/;
+
+const isTicker = (word: string) => TICKER_RE.test(word) && /[A-Z]/.test(word);
+
+function acceptsArg(fn: ChatFunction, arg: string): boolean {
+  switch (fn.arg) {
+    case "ticker":
+      return isTicker(arg);
+    case "tickers": {
+      const words = arg.split(/[\s,]+/).filter(Boolean);
+      return words.length > 0 && words.length <= MAX_TICKERS && words.every(isTicker);
+    }
+    case "code":
+      return CODE_RE.test(arg);
+    case "choice": {
+      const wanted = arg.toUpperCase();
+      try {
+        return fn.choices?.().some((value) => value.toUpperCase() === wanted) ?? false;
+      } catch {
+        return false;
+      }
+    }
+    default:
+      return false;
+  }
+}
+
+/**
+ * The function a span of inline code names, or null. The code is the first
+ * word, written in capitals as the app writes codes, so a key written as `n`
+ * or `esc` stays code; a code of one letter needs its argument (`T AAPL`), as
+ * `N` alone is more often the key than News. Words after the code are its
+ * argument, which must be what the function takes: a ticker in capitals
+ * (`CAT food` and `G is great` stay code), a list of them, a function's code
+ * for HELP, or one of the values the function names (`NI CRYPTO`). Marks that
+ * cannot be seen are dropped, so the chip shows all of the text it runs.
+ */
+export function resolveChatCommand(text: string, functions: ReadonlyMap<string, ChatFunction> = chatFunctions()): ChatCommand | null {
+  if (/[\n`]/.test(text)) return null;
+  const query = text.replace(INVISIBLE_RE, "").trim().replace(/\s+/g, " ");
+  if (!query || query.length > MAX_COMMAND_LENGTH) return null;
+  const space = query.indexOf(" ");
+  const code = space < 0 ? query : query.slice(0, space);
+  if (code !== code.toUpperCase()) return null;
+  const fn = functions.get(code);
+  if (!fn) return null;
+  if (space < 0) return code.length > 1 ? { query, fn } : null;
+  return acceptsArg(fn, query.slice(space + 1)) ? { query, fn } : null;
+}

package/src/plugins/builtin/chat/pane-links/model.ts

@@ -8,12 +8,21 @@ import { formatShortDate } from "../../../../utils/datetime-format";
  * a Gloom share link someone posted, or what a Gloom Wire post names in its
  * `paneLink` (never read out of the post's text).
  */
-export type ChatMessagePaneLink =
+type ChatMessageChipLink =
   | { kind: "share"; id: string; url: string }
   | { kind: "wire"; link: ChatPaneLink };
 
+/**
+ * What a chip opens: one of the above, or a function written in backticks in
+ * the text (`NI CRYPTO`), which draws its chip where it is written and runs
+ * in the command bar.
+ */
+export type ChatMessagePaneLink =
+  | ChatMessageChipLink
+  | { kind: "command"; query: string; name: string };
+
 export interface ChatMessagePaneLinks {
-  links: ChatMessagePaneLink[];
+  links: ChatMessageChipLink[];
   /**
    * The text to draw: the message's own, less the share links its chips stand
    * for and the publisher address an older news post still ends in.
@@ -79,7 +88,7 @@ function withoutLegacyArticleLink(content: string): string {
 
 function computePaneLinks(message: Pick<ChatMessage, "content" | "paneLink">): ChatMessagePaneLinks {
   const content = message.paneLink?.kind === "news-story" ? withoutLegacyArticleLink(message.content) : message.content;
-  const links: ChatMessagePaneLink[] = [];
+  const links: ChatMessageChipLink[] = [];
   const drop = new Set<number>();
   // Cheap guard: the tokenizer only runs on messages that could hold a share link.
   if (content.includes("gloom.sh")) {

package/src/plugins/builtin/chat/pane-links/open.ts

@@ -8,14 +8,21 @@ interface PaneLinkActions {
   createPaneFromTemplate(templateId: string, options?: PaneTemplateCreateOptions): void;
   notify(notification: AppNotificationRequest): unknown;
   openExternal(url: string): void;
+  /** Runs text in the command bar as if typed there and entered. */
+  runCommand(query: string): void;
 }
 
 /**
  * A share opens the way every share link does in this app; one it cannot open
  * here (offline, a snapshot) opens its web page instead. A Wire post opens its
- * story or calendar from the app's own pane templates.
+ * story or calendar from the app's own pane templates. A function written in
+ * a message runs in the command bar, so it opens where and as typing it would.
  */
 export function openChatPaneLink(link: ChatMessagePaneLink, actions: PaneLinkActions): void {
+  if (link.kind === "command") {
+    actions.runCommand(link.query);
+    return;
+  }
   if (link.kind === "share") {
     openShareLink(link.id, () => actions.openExternal(new URL(`/s/${link.id}`, PUBLIC_SHARE_ORIGIN).toString()));
     return;

package/src/plugins/builtin/chat/unread-inbox-pane.tsx

@@ -23,11 +23,13 @@ import {
 import { scheduleConfigSave } from "../../../state/config-save-scheduler";
 import { colors } from "../../../theme/colors";
 import type { PaneProps } from "../../../types/plugin";
+import { findPaneInstance } from "../../../types/config";
 import { Box, Text, TextAttributes, useUiCapabilities } from "../../../ui";
 import { formatFeedTime } from "../../../utils/datetime-format";
 import { displayWidth, truncateToDisplayWidth } from "../../../utils/format";
 import { usePluginAppActions, usePluginPaneState } from "../../runtime";
 import { requestPriceAlertFocus } from "../alerts/focus";
+import { LIVE_SCAN_TEMPLATE_ID } from "../shared/scanner-capture";
 import { SignInWall } from "../cloud/auth-actions";
 import { openTeamPane } from "../../../team/pane-request";
 import { teamStore } from "../../../team/store";
@@ -57,6 +59,7 @@ const NOTICE_LABELS: Record<MissedNoticeKind, string> = {
   catalyst: "Catalyst",
   econ: "Economic release",
   team: "Team",
+  scan: "Live scan",
 };
 
 function chatCell(
@@ -212,11 +215,17 @@ export function UnreadInboxPane({
       showPane("econ-calendar");
       return;
     }
+    if (ref.kind === "scan") {
+      // The scanner that alerted, when it is still in the layout; otherwise the one SCAN opens.
+      if (findPaneInstance(stateRef.current.config.layout, ref.id)) dispatch({ type: "FOCUS_PANE", paneId: ref.id });
+      else createPaneFromTemplate(LIVE_SCAN_TEMPLATE_ID);
+      return;
+    }
     const card = teamStore.getSnapshot().notifications.find((entry) => entry.id === ref.id) ?? null;
     const action = card ? teamStore.notificationAction(card) : null;
     if (action) action.onClick();
     else openTeamPane(createPaneFromTemplate, card ? { teamId: card.data.team.id } : {});
-  }, [createPaneFromTemplate, showPane]);
+  }, [createPaneFromTemplate, dispatch, showPane, stateRef]);
 
   const openRow = useCallback((row: UnreadListRow) => {
     if (row.kind === "chat") openChatItem(row.item);

package/src/plugins/builtin/clinical-trials/model.ts

@@ -267,12 +267,3 @@ export function trialLayout(width: number): TrialLayout {
   const statusAt = fixed.findIndex((column) => column.id === "status") + 1;
   return { compact, showVenue: wide, columns: [...fixed.slice(0, statusAt), title, ...fixed.slice(statusAt)] };
 }
-
-/**
- * A search typed as a ticker (`TRIAL VKTX`): one to five letters, with a
- * share class. The registry knows sponsors by name, so a symbol no study
- * mentions is looked up as its company.
- */
-export function looksLikeTicker(term: string): boolean {
-  return /^[A-Za-z]{1,5}(?:[.-][A-Za-z])?$/.test(term.trim());
-}

package/src/plugins/builtin/clinical-trials/pane.tsx

@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef } from "react";
 import {
   DataTableStackView,
   PaneLinkMenu,
@@ -41,7 +41,6 @@ import {
   SPONSOR_FILTER_OPTIONS,
   STATUS_FILTER_OPTIONS,
   keepsToneWhenSelected,
-  looksLikeTicker,
   normalizeTrialFilters,
   sponsorClassLabel,
   trialFiltersNarrow,
@@ -57,7 +56,7 @@ import {
   type TrialFilters,
 } from "./model";
 import { useSponsorTickers, type SponsorTicker } from "./sponsor-tickers";
-import { tickerSponsorName } from "./ticker-sponsor";
+import { looksLikeTicker, useTickerCompanySearch } from "../shared/ticker-company";
 import { CLINICAL_TRIALS_PANE_ID } from "./types";
 
 const SEARCH_DEBOUNCE_MS = 250;
@@ -187,7 +186,6 @@ export function TrialsPane({ width, height, focused }: PaneProps) {
   }, [client, filtersKey, term]);
   const studies = usePagedRows(loadPage, { getId: (trial) => trial.nctId, keepPreviousRows: true });
   const trials = studies.rows;
-  const error = studies.error?.message ?? null;
   const loadMore = useTableLoadMore(scrollRef, studies.hasMore && !openItemId, studies.loadMore);
   // Scrolling asks for the next page, so a page that does not fill a tall
   // pane asks for it once it is laid out.
@@ -230,28 +228,23 @@ export function TrialsPane({ width, height, focused }: PaneProps) {
     setOpenItemId(null);
   }, [filters, setOpenItemId, setSavedFilters, setSelectedId]);
 
-  const reload = useCallback(() => {
-    studies.reload();
-    sponsorTickers.retry();
-  }, [sponsorTickers, studies]);
   // `TRIAL VKTX`: no study names a symbol, so one that finds nothing is
   // searched as its company's name, quoted so the registry matches the whole
   // name as a sponsor files it, and the search box then shows it. Each term
   // is looked up once.
-  const [looked, setLooked] = useState<ReadonlySet<string>>(() => new Set());
-  const resolvingTicker = studies.status === "loaded" && trials.length === 0 && !studies.error
-    && looksLikeTicker(term) && !looked.has(term.toUpperCase());
-  useEffect(() => {
-    if (!resolvingTicker) return;
-    let live = true;
-    void tickerSponsorName(dataProvider, term).catch(() => null).then((name) => {
-      if (!live) return;
-      setLooked((current) => new Set([...current, term.toUpperCase()]));
-      if (name) updateQuery(`"${name}"`);
-    });
-    return () => { live = false; };
-  }, [dataProvider, resolvingTicker, term, updateQuery]);
-  const loading = (studies.loading && trials.length === 0) || resolvingTicker;
+  const companySearch = useTickerCompanySearch(dataProvider, term, {
+    eligible: studies.status === "loaded" && trials.length === 0 && !studies.error && looksLikeTicker(term),
+    key: term.toUpperCase(),
+    onCompany: (name) => updateQuery(`"${name}"`),
+  });
+  const retryCompanySearch = companySearch.retry;
+  const error = studies.error?.message ?? companySearch.error;
+  const reload = useCallback(() => {
+    retryCompanySearch();
+    studies.reload();
+    sponsorTickers.retry();
+  }, [retryCompanySearch, sponsorTickers, studies]);
+  const loading = (studies.loading && trials.length === 0) || companySearch.resolving;
   usePaneRefreshKey(reload, { focused, enabled: !searchFocused && !openItemId });
 
   const detailTicker = detailTrial ? tickerOf(detailTrial) : undefined;

package/src/plugins/builtin/clinical-trials/sponsor-tickers.ts

@@ -6,6 +6,7 @@ import {
   validateOrganizationTickers,
   type OrganizationTicker,
 } from "../../../api-client/organization-tickers";
+import { createTtlCache, type TtlCache } from "../../../data/ttl-cache";
 
 /**
  * A lead sponsor's ticker, only ever as Gloom Cloud resolved it. `none` is an
@@ -46,17 +47,19 @@ const sponsorKey = (name: string) => name.trim().replace(/\s+/g, " ").toLowerCas
  * never stored as having no ticker because the lookup did not happen.
  */
 export class SponsorTickerStore {
-  private readonly answers = new Map<string, { value: SponsorTicker; expiresAt: number }>();
+  private readonly answers: TtlCache<SponsorTicker>;
   private readonly failures = new Map<string, string>();
   private readonly inFlight = new Set<string>();
   private readonly listeners = new Set<() => void>();
 
-  constructor(private readonly lookup: Lookup, private readonly now: () => number = Date.now) {}
+  constructor(private readonly lookup: Lookup, now: () => number = Date.now) {
+    this.answers = createTtlCache<SponsorTicker>({ ttlMs: CACHE_TTL_MS, now });
+  }
 
   get(name: string): SponsorTicker {
     const key = sponsorKey(name);
-    const answer = this.answers.get(key);
-    if (answer && answer.expiresAt > this.now()) return answer.value;
+    const answer = this.answers.peek(key);
+    if (answer) return answer;
     const reason = this.failures.get(key);
     return reason ? { kind: "failed", reason } : { kind: "pending" };
   }
@@ -86,8 +89,7 @@ export class SponsorTickerStore {
       keys.forEach((key) => this.inFlight.add(key));
       try {
         const results = await this.lookup(batch, signal);
-        const expiresAt = this.now() + CACHE_TTL_MS;
-        results.forEach((result, index) => this.answers.set(keys[index]!, { value: sponsorTickerFrom(result), expiresAt }));
+        results.forEach((result, index) => this.answers.set(keys[index]!, sponsorTickerFrom(result)));
       } catch (error) {
         // An abandoned lookup (its pane closed) is neither an answer nor a failure.
         if (!signal?.aborted) {

package/src/plugins/builtin/cloud/askg/manifest.ts

@@ -142,6 +142,8 @@ function headlessCandidates(registry: PaneFunctionCatalog): ManifestCandidate[]
     const pane = registry.panes.get(template.paneId);
     if (!pane) continue;
     templatedPaneIds.add(pane.id);
+    // An unlisted function (`listed: false`) is no tool, and its pane none in its place.
+    if (template.listed === false) continue;
     const definition = definitionFor(template, pane);
     if (!definition) continue;
     const token = template.shortcut?.prefix ?? template.id;

package/src/plugins/builtin/cloud/plugin.tsx

@@ -35,7 +35,7 @@ function createCloudDataModule(): PluginModule {
     setup(ctx) {
       ctx.registerSyncTransport({
         id: "gloomberb-cloud",
-        isAvailable: () => apiClient.isVerified(),
+        isAvailable: () => apiClient.getVerifiedSessionIdentity() !== null,
         pullSnapshot: () => apiClient.getSyncSnapshot(),
         pushSnapshot: (snapshot, options) => apiClient.putSyncSnapshot(snapshot, options),
       });

package/src/plugins/builtin/company-attention/building.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../utils/log-failure";
 import { useCallback, useMemo, useRef, type ReactNode } from "react";
 import { isAccessDenied } from "../../../api-client/errors";
 import type { HiringBuildingFilter, HiringBuildingShift } from "../../../api-client/hiring";
@@ -60,7 +61,10 @@ export function HiringBuildingView({ symbol, width, height, focused, accessKey,
     try {
       const payload = snapshotSetting ? validateBuilding(snapshotSetting) : null;
       return payload && ("filter" in payload ? !symbol : payload.symbol.toUpperCase() === symbol?.toUpperCase()) ? payload : null;
-    } catch { return null; }
+    } catch (error) {
+      logFailure("company-attention.building", "Validate hiring building snapshot failed")(error);
+      return null;
+    }
   }, [snapshotSetting, symbol]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadBuilding(symbol, accessKey, filter, force), [snapshot, symbol, accessKey, filter]);
   const resource = useAsyncResource(loader, { initialData: () => cachedBuilding(symbol, accessKey, filter), clearOnError: isAccessDenied, keepPreviousData: true });

package/src/plugins/builtin/company-attention/client.ts

@@ -3,6 +3,7 @@ import type { AppAttentionFilter, AppAttentionPayload, AppRankPayload } from "..
 import type { HiringBoard, HiringBuildingBoard, HiringBuildingFilter, HiringBuildingShift, HiringCompanyBuilding, HiringCompanyMoves, HiringCompanySignals, HiringMixRow, HiringMove, HiringMovePosting, HiringMovesBoard, HiringMovesFilter, HiringMoveWeek, HiringPayload, HiringSignalGroup, HiringSignalsBoard, HiringSignalsFilter, HiringSummary, HiringWeekSignal } from "../../../api-client/hiring";
 import type { CloudJobsPostingDetail } from "../../../api-client/types";
 import { createPluginCache } from "../../../data/plugin-cache";
+import { createTtlCache } from "../../../data/ttl-cache";
 import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 import type { AppFocus, AttentionKind } from "./model";
 
@@ -19,7 +20,10 @@ const finite = (value: unknown) => typeof value === "number" && Number.isFinite(
 const positive = (value: unknown) => finite(value) && (value as number) >= 0;
 const fraction = (value: unknown) => positive(value) && (value as number) <= 1;
 const date = (value: unknown) => typeof value === "string" && Number.isFinite(Date.parse(value));
-const url = (value: unknown) => { try { return typeof value === "string" && ["https:", "http:"].includes(new URL(value).protocol); } catch { return false; } };
+const url = (value: unknown) => { try { return typeof value === "string" && ["https:", "http:"].includes(new URL(value).protocol); } catch {
+  // Intentional ignore: malformed URLs fail this web link field validator.
+  return false;
+} };
 function numericTree(value: unknown): boolean {
   if (typeof value === "number") return Number.isFinite(value);
   if (Array.isArray(value)) return value.every(numericTree);
@@ -165,21 +169,16 @@ export async function fetchAppRank(focus: AppFocus, days: number, offset = 0, si
 export const loadAppRank = (focus: AppFocus, access: string, days: number, force = false) => loadCloudResource(appRankCache, `${access}:${focus.store}:${focus.appId}:${focus.country}:${focus.chart}:${days}`, () => fetchAppRank(focus, days), { force });
 
 const POSTING_TTL_MS = 5 * 60_000;
-const postingCache = new Map<string, { at: number; posting: Promise<CloudJobsPostingDetail> }>();
+const postings = createTtlCache<CloudJobsPostingDetail>({ ttlMs: POSTING_TTL_MS });
 /**
  * The page HIRE's evidence row was read from: its title, place, date, pay,
  * hours and description. Kept a few minutes, so stepping back and forth
  * through the evidence does not read it again.
  */
 export function fetchPostingDetail(ticker: string, externalId: string, client: Pick<typeof apiClient, "getCloudJobsPosting"> = apiClient): Promise<CloudJobsPostingDetail> {
-  const key = `${ticker.toUpperCase()}:${externalId}`;
-  const cached = postingCache.get(key);
-  if (cached && Date.now() - cached.at < POSTING_TTL_MS) return cached.posting;
-  const posting = client.getCloudJobsPosting(ticker, { externalId }).then((detail) => {
+  return postings.load(`${ticker.toUpperCase()}:${externalId}`, async () => {
+    const detail = await client.getCloudJobsPosting(ticker, { externalId });
     if (!detail || typeof detail.title !== "string" || detail.externalId !== externalId) throw new Error("The server returned an unreadable posting.");
     return detail;
   });
-  postingCache.set(key, { at: Date.now(), posting });
-  posting.catch(() => postingCache.delete(key));
-  return posting;
 }

package/src/plugins/builtin/company-attention/evidence.ts

@@ -45,7 +45,10 @@ export function attentionScreenshotEvidence(kind: AttentionKind): PaneScreenshot
     read(value) {
       if (!isRecord(value) || value.kind !== kind || value.version !== 1 || value.complete !== true || !isRecord(value.payload)
         || !["table", "chart", "mix", "peers", "evidence", ...(kind === "hiring" ? ["moves", "expansion", "anomalies", "building"] : [])].includes(String(value.tab)) || !Array.isArray(value.rowIds) || !value.rowIds.every((id) => typeof id === "string") || value.plottedValueCount !== value.rowIds.length) return null;
-      try { if (!(kind === "apps" && Array.isArray(value.payload.rankHistory))) validateAttention(kind, value.payload as unknown as AttentionPayload); return value as unknown as AttentionEvidence; } catch { return null; }
+      try { if (!(kind === "apps" && Array.isArray(value.payload.rankHistory))) validateAttention(kind, value.payload as unknown as AttentionPayload); return value as unknown as AttentionEvidence; } catch {
+        // Intentional ignore: invalid captured observations are rejected as evidence by returning null.
+        return null;
+      }
     },
     mismatches(evidence, { resolved, payload }) {
       const settings = payload.config.layout.instances.find((entry) => entry.instanceId === payload.paneId)?.settings;

package/src/plugins/builtin/company-attention/moves.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../utils/log-failure";
 import { useCallback, useMemo, useRef, type ReactNode } from "react";
 import { isAccessDenied } from "../../../api-client/errors";
 import type { HiringMovesFilter } from "../../../api-client/hiring";
@@ -63,7 +64,10 @@ export function HiringMovesView({ symbol, width, height, focused, accessKey, com
     try {
       const payload = snapshotSetting ? validateMoves(snapshotSetting) : null;
       return payload && ("moves" in payload ? !symbol : payload.symbol.toUpperCase() === symbol?.toUpperCase()) ? payload : null;
-    } catch { return null; }
+    } catch (error) {
+      logFailure("company-attention.moves", "Validate hiring moves snapshot failed")(error);
+      return null;
+    }
   }, [snapshotSetting, symbol]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadMoves(symbol, accessKey, filter, force), [snapshot, symbol, accessKey, filter]);
   const resource = useAsyncResource(loader, { initialData: () => cachedMoves(symbol, accessKey, filter), clearOnError: isAccessDenied, keepPreviousData: true });

package/src/plugins/builtin/company-attention/pane.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../utils/log-failure";
 import { useCallback, useMemo, useRef } from "react";
 import { isAccessDenied } from "../../../api-client/errors";
 import { usePlanAccess } from "../../../api-client/plan-access";
@@ -57,7 +58,10 @@ function Evidence({ row, width, posting, source }: Size & { row: AttentionRow; p
 }
 /** A link's site, as a reader names it: "sec.gov". */
 function linkName(url: string): string {
-  try { return new URL(url).hostname.replace(/^www\./, ""); } catch { return "Source"; }
+  try { return new URL(url).hostname.replace(/^www\./, ""); } catch {
+    // Intentional ignore: a malformed link has no site to name, so it reads as Source.
+    return "Source";
+  }
 }
 
 export function HiringPane(props: Size) {
@@ -105,7 +109,10 @@ function AttentionView({ kind, symbol, width, height, focused, initialTab }: Siz
   const [mix, setMix] = usePluginPaneState<string>(`${kind}:mix`, kind === "hiring" ? "functions" : "countries");
   const filters = useMemo<AppAttentionFilter>(() => kind === "apps" ? { ...(country ? { country } : {}), ...(chart ? { chart: chart as AppChart } : {}), days: Number(days) || 90 } : {}, [kind, country, chart, days]);
   const [snapshotSetting] = usePaneSettingValue<AttentionPayload | null>("attentionSnapshot", null);
-  const snapshot = useMemo(() => { try { return snapshotSetting ? validateAttention(kind, snapshotSetting) : null; } catch { return null; } }, [kind, snapshotSetting]);
+  const snapshot = useMemo(() => { try { return snapshotSetting ? validateAttention(kind, snapshotSetting) : null; } catch (error) {
+    logFailure("company-attention.pane", "Validate attention snapshot failed")(error);
+    return null;
+  } }, [kind, snapshotSetting]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadAttention(kind, symbol, accessKey, filters, force), [kind, symbol, accessKey, filters, snapshot]);
   const resource = useAsyncResource(loader, { initialData: () => cachedAttention(kind, symbol, accessKey, filters), clearOnError: isAccessDenied });
   const data = resource.data?.payload;