@gloom-sh/terminal 0.18.5 → 0.19.0

package/src/plugins/builtin/chart-composer/pane.tsx

@@ -55,7 +55,9 @@ import {
 import { colors } from "../../../theme/colors";
 import { isUsListingExchange, parsePublicTickerKey, publicTickerKey } from "../../../utils/exchanges";
 import { getTimeSeriesField, isMarketFieldId } from "../../../time-series/field-catalog";
-import { isDatasetChart } from "../../../time-series/spec";
+import { isDatasetChart, isOhlcSeriesStyle } from "../../../time-series/spec";
+import { useThemeColors } from "../../../theme/theme-context";
+import { priceComparisonSeriesIds } from "../../../time-series/price-comparison";
 import { seriesMessageName, studyMessageName } from "../../../time-series/series-name";
 import { CHART_COMPOSER_PANE_ID } from "../../../types/config";
 import { useRemoteUiNode } from "../../../remote/semantic-tree";
@@ -117,6 +119,8 @@ import {
   CHART_BAR_SIZE_PRESETS,
   CHART_RANGES as RANGES,
   CHART_RESOLUTIONS,
+  CHART_CANDLE_COLOURS_SETTING_KEY,
+  chartCandleColours,
   chartStudyOptionsFor,
   chartStudyPeriodTitle,
   chartStudySettingLabel,
@@ -342,6 +346,14 @@ function ChartComposerSurface({
   // plausible time is dropped without pinning. This handle only sets the
   // pin; the chart it opens on is what shows and keeps it.
   const [pinnedMoment, setPinnedMoment] = usePaneSettingValue<unknown>(CHART_PINNED_MOMENT_SETTING_KEY, null);
+  const [candleColoursSetting] = usePaneSettingValue<unknown>(CHART_CANDLE_COLOURS_SETTING_KEY, null);
+  const gainColour = useThemeColors().positive;
+  // Rising candles in the gain colour; falling ones already take the loss colour.
+  const candleColour = useCallback((list: ResolvedSeries[]) => (
+    chartCandleColours(candleColoursSetting) === "change"
+      ? list.map((entry) => isOhlcSeriesStyle(entry.style) ? { ...entry, color: gainColour } : entry)
+      : list
+  ), [candleColoursSetting, gainColour]);
   const momentLink = useTabCursorLink(paneId ? `${paneId}:moment` : null, { viewer: false });
   useEffect(() => {
     if (pinnedMoment == null || !momentLink?.pin) return;
@@ -475,9 +487,9 @@ function ChartComposerSurface({
     });
     const resolvedIds = new Set(resolved.map((entry) => entry.id));
     const missing = spec.series.filter((entry) => !resolvedIds.has(entry.id));
-    if (missing.length === 0) return resolved;
+    if (missing.length === 0) return candleColour(resolved);
     const bySpecOrder = new Map(spec.series.map((entry, index) => [entry.id, index] as const));
-    return [
+    return candleColour([
       ...resolved,
       ...missing.map((entry): ResolvedSeries => ({
         id: entry.id,
@@ -495,15 +507,15 @@ function ChartComposerSurface({
         hidden: true,
         points: [],
       })),
-    ].sort((a, b) => (bySpecOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER) - (bySpecOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER));
-  }, [listings.names, nameSeries, resolution.legendSeries, spec.series]);
+    ].sort((a, b) => (bySpecOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER) - (bySpecOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER)));
+  }, [candleColour, listings.names, nameSeries, resolution.legendSeries, spec.series]);
   const plottedSeries = useMemo(
-    () => projectVisibleChartSeries(
+    () => candleColour(projectVisibleChartSeries(
       spec,
       resolution.bufferedSeries ?? resolution.series,
       resolution.legendSeries,
-    ),
-    [resolution.bufferedSeries, resolution.legendSeries, resolution.series, spec],
+    )),
+    [candleColour, resolution.bufferedSeries, resolution.legendSeries, resolution.series, spec],
   );
   const { notify } = usePluginAppActions();
   const { runtime } = usePluginRenderContext();
@@ -1190,6 +1202,22 @@ function ChartComposerSurface({
     }]
     : [];
 
+  // Returns of two or more prices compare as price returns; the toggle reinvests their cash distributions.
+  const totalReturnOn = spec.viewport.totalReturn === true;
+  const totalReturnFilters = totalReturnOn || priceComparisonSeriesIds(spec) !== null
+    ? [{
+      id: "total-return",
+      kind: "toggle" as const,
+      label: "Total return",
+      short: "Total ret",
+      value: totalReturnOn,
+      onChange: (value: boolean) => {
+        const { totalReturn: _previous, ...viewport } = specRef.current.viewport;
+        updateSpec({ ...specRef.current, viewport: value ? { ...viewport, totalReturn: true } : viewport });
+      },
+    }]
+    : [];
+
   // A company that reports no quarterly figures says so, and where its annual ones are.
   const unreported = resolution.legendSeries?.find((entry) => entry.unreportedPeriod && entry.points.length === 0);
   const emptyMessage = spec.series.length === 0
@@ -1216,6 +1244,7 @@ function ChartComposerSurface({
             onChange: (value: string) => setRange(value as TimeRange) },
           ...genericFilters,
           ...extendedHoursFilters,
+          ...totalReturnFilters,
         ]}
         view={resolutionOptions.length > 1 ? {
           value: spec.viewport.resolution,

package/src/plugins/builtin/chart-composer/settings.ts

@@ -129,6 +129,20 @@ export const CHART_SETTING_KEYS = {
   realizedVolEstimator: "chartRealizedVolEstimator",
 } as const;
 
+/**
+ * Whether rising candles take their series' colour or the theme's gain colour.
+ * Kept beside the spec in the pane's settings, so a build without it opens the
+ * chart unchanged; it is not one of CHART_SETTING_KEYS, which a spec edit
+ * clears as derived from the spec.
+ */
+export const CHART_CANDLE_COLOURS_SETTING_KEY = "chartCandleColours";
+
+export type ChartCandleColours = "series" | "change";
+
+export function chartCandleColours(value: unknown): ChartCandleColours {
+  return value === "change" ? "change" : "series";
+}
+
 function fallbackSpec(symbol: string | null | undefined): ChartSpec {
   return symbol ? buildPriceChartPreset(symbol) : buildEmptyChartPreset();
 }
@@ -417,6 +431,7 @@ export function buildChartComposerPaneSettingsDef(
       [CHART_SETTING_KEYS.range]: spec.viewport.range,
       [CHART_SETTING_KEYS.resolution]: spec.viewport.resolution,
       [CHART_SETTING_KEYS.mode]: inlineStyleTarget?.style ?? "",
+      [CHART_CANDLE_COLOURS_SETTING_KEY]: chartCandleColours(settings[CHART_CANDLE_COLOURS_SETTING_KEY]),
       ...(realizedVol ? {
         [CHART_SETTING_KEYS.realizedVolWindow]: String(realizedVol.parameters.window ?? 30),
         [CHART_SETTING_KEYS.realizedVolEstimator]: realizedVol.parameters.estimator ?? "close-to-close",
@@ -494,6 +509,18 @@ export function buildChartComposerPaneSettingsDef(
           options: modes.map((mode) => ({ value: mode, label: mode.toUpperCase() })),
         }]
         : []),
+      ...(spec.series.some((series) => isOhlcSeriesStyle(series.style))
+        ? [{
+          key: CHART_CANDLE_COLOURS_SETTING_KEY,
+          label: "Candle Colours",
+          description: "Draw rising candles in their series' colour, or in the theme's gain colour against its loss colour.",
+          type: "select" as const,
+          options: [
+            { value: "series", label: "Series colour" },
+            { value: "change", label: "Gains & losses" },
+          ],
+        }]
+        : []),
     ],
     applyValue: applyChartComposerPaneSetting,
   };

package/src/plugins/builtin/chat/content/command-suggestions.ts

@@ -55,6 +55,7 @@ export function filterCommandSuggestions(
   const byCode: ChatFunction[] = [];
   const byName: ChatFunction[] = [];
   for (const fn of new Set(functions.values())) {
+    if (fn.unlisted) continue;
     if (fn.code.startsWith(upper) || fn.aliases.includes(upper)) byCode.push(fn);
     else if (fn.name.toLowerCase().split(/[\s/&()-]+/).some((word) => word.startsWith(lower))) byName.push(fn);
   }

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

@@ -36,6 +36,8 @@ export interface ChatFunction {
   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. */
@@ -106,7 +108,11 @@ export function chatFunctionsFrom(source: ChatFunctionSource, core: readonly Com
     // 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) });
+    add(upperCodes(paneTemplateShortcutPrefixes(template)), {
+      name: getPaneTemplateDisplayLabel(template),
+      ...templateArg(template),
+      ...(template.listed === false ? { unlisted: true as const } : {}),
+    });
   }
   return byCode;
 }

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/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;

package/src/plugins/builtin/company-attention/signals.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 { HiringSignalGroup, HiringSignalsFilter, HiringWeekSignal } from "../../../api-client/hiring";
@@ -60,7 +61,10 @@ export function HiringSignalsView({ group, symbol, width, height, focused, acces
     try {
       const payload = snapshotSetting ? validateSignals(snapshotSetting) : null;
       return payload && ("group" in payload ? !symbol && payload.group === group : payload.symbol.toUpperCase() === symbol?.toUpperCase()) ? payload : null;
-    } catch { return null; }
+    } catch (error) {
+      logFailure("company-attention.signals", "Validate hiring signals snapshot failed")(error);
+      return null;
+    }
   }, [snapshotSetting, symbol, group]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadSignals(group, symbol, accessKey, filter, force), [snapshot, group, symbol, accessKey, filter]);
   const resource = useAsyncResource(loader, { initialData: () => cachedSignals(group, symbol, accessKey, filter), clearOnError: isAccessDenied, keepPreviousData: true });

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

@@ -8,8 +8,9 @@ import { buildCorrelationMatrix, buildCorrelationSeries, buildGeoCorrelationSeri
 import { geoSeriesToken, loadGeoCorrelationHistory } from "./geo";
 import { buildRelationshipAnalysis, DEFAULT_RELATIONSHIP_SECOND_SYMBOL } from "./relationship/model";
 import { paneSchemas } from "./headless-schema";
-import { CORRELATION_RETURN_BASIS, GEO_CORRELATION_CHANGE_BASIS, loadCorrelationHistory } from "./history";
+import { CORRELATION_RETURN_BASIS, GEO_CORRELATION_CHANGE_BASIS, loadCorrelationHistory, unfinishedBarFreshness } from "./history";
 import type { HeadlessPaneContext } from "../../../types/headless";
+import type { PricePoint } from "../../../types/financials";
 import { newestReportTime } from "../../../utils/utc-time";
 import { DAILY_CLOSES } from "../shared/report-freshness";
 
@@ -34,9 +35,13 @@ async function loadListedHistory(ctx: HeadlessPaneContext, key: string, range: T
 }
 
 /** A ticker's daily closes, or a map series' daily values read straight from the Cloud client. */
-async function loadCorrelationInput(ctx: HeadlessPaneContext, key: string, range: TimeRange): Promise<CorrelationSeries> {
+async function loadCorrelationInput(ctx: HeadlessPaneContext, key: string, range: TimeRange, onBars?: (bars: PricePoint[]) => void): Promise<CorrelationSeries> {
   const geo = geoSeriesToken(key);
-  if (!geo) return buildCorrelationSeries(key, await loadHistory(ctx, key, range));
+  if (!geo) {
+    const bars = await loadHistory(ctx, key, range);
+    onBars?.(bars);
+    return buildCorrelationSeries(key, bars);
+  }
   const request = <T,>(path: string, init?: RequestInit) => ctx.apiClient.geo<T>(path, { ...init, signal: init?.signal ?? ctx.signal });
   return buildGeoCorrelationSeries(key, await loadGeoCorrelationHistory(request, geo, range, ctx.signal));
 }
@@ -53,7 +58,8 @@ export const correlationHeadless: HeadlessPaneDefinition<"rows"> = {
   ],
   async load({ symbols, options }, ctx) {
     const range = (options.rangePreset ?? "1Y") as TimeRange;
-    const loaded = await loadHeadlessSymbols(symbols, ctx, (symbol) => loadCorrelationInput(ctx, symbol, range));
+    const bars = new Map<string, PricePoint[]>();
+    const loaded = await loadHeadlessSymbols(symbols, ctx, (symbol) => loadCorrelationInput(ctx, symbol, range, (points) => bars.set(symbol, points)));
     const bySymbol = new Map(loaded.entries.map(({ symbol, data }) => [symbol, data]));
     const matrix = buildCorrelationMatrix(symbols, bySymbol);
     const rows = symbols.flatMap((left, index) => symbols.slice(index + 1).map((right) => {
@@ -68,8 +74,9 @@ export const correlationHeadless: HeadlessPaneDefinition<"rows"> = {
         ? "Inconsistent OHLC history"
         : row.sampleSize < 5 ? "Insufficient shared return observations" : "Zero return variance",
     }));
+    const asOf = newestReportTime(symbols.map((symbol) => bySymbol.get(symbol)?.prices.at(-1)?.dateKey));
     return {
-      freshness: { asOf: newestReportTime(symbols.map((symbol) => bySymbol.get(symbol)?.prices.at(-1)?.dateKey)) },
+      freshness: { asOf, ...unfinishedBarFreshness([...bars.values()], asOf?.slice(0, 10)) },
       rows, unavailableSymbols,
       errors: [
         ...loaded.errors,
@@ -132,6 +139,7 @@ export const relationshipHeadless: HeadlessPaneDefinition<"series"> = {
         })),
         { key: "returnCount", label: "Shared returns", value: analysis.stats?.sampleSize ?? analysis.returns.length },
       ],
+      freshness: unfinishedBarFreshness([...histories.values()], analysis.aligned.at(-1)?.dateKey) ?? {},
       unavailableSymbols: [...new Set(unavailableSymbols)],
       errors: [...loaded.errors, ...(analysis.unavailableReason ? [analysis.unavailableReason] : []),
         ...(analysis.correlationUnavailableReason ? [analysis.correlationUnavailableReason] : [])],

package/src/plugins/builtin/correlation/history.ts

@@ -2,6 +2,9 @@ import type { AssetDataProvider, MarketDataRequestContext } from "../../../types
 import type { TimeRange } from "../../../time-series/range";
 import type { ManualChartResolution } from "../../../time-series/resolution";
 import { clipPriceHistoryToRange } from "../../../time-series/history-window";
+import { DAY_SO_FAR_TEXT } from "../../../time-series/session-bar";
+import type { PricePoint } from "../../../types/financials";
+import type { HeadlessPaneFreshness } from "../../../types/headless";
 
 /** Risk views need daily closes even when a chart preset defaults to intraday or weekly bars. */
 export const CORRELATION_HISTORY_RESOLUTION: ManualChartResolution = "1d";
@@ -16,6 +19,25 @@ export async function loadCorrelationHistory(
   return clipPriceHistoryToRange(points, range);
 }
 
+/**
+ * What an analysis of daily closes says when its newest day is a bar the source
+ * has not finished: a coin's UTC day or a future's session under way
+ * (`partial`), or a future's last trade before its settlement (`unsettled`).
+ * That day is no close, so the line calls the bars daily bars and says so, as
+ * `history` does, instead of dating a close by it. Nothing when `day` (the
+ * newest date the analysis uses) is a finished bar in every history.
+ */
+export function unfinishedBarFreshness(
+  histories: ReadonlyArray<ReadonlyArray<Pick<PricePoint, "date" | "partial" | "unsettled">> | undefined>,
+  day: string | null | undefined,
+): Pick<HeadlessPaneFreshness, "basis" | "note"> | null {
+  if (!day) return null;
+  const bars = histories.flatMap((history) => history?.filter((point) => new Date(point.date).toISOString().slice(0, 10) === day) ?? []);
+  if (bars.some((bar) => bar.partial)) return { basis: "daily bars", note: `the newest bar is ${DAY_SO_FAR_TEXT}` };
+  if (bars.some((bar) => bar.unsettled)) return { basis: "daily bars", note: "the newest bar is not yet settled" };
+  return null;
+}
+
 export const CORRELATION_RETURN_BASIS = "Local-price close-to-close returns between shared UTC dates; cash distributions and FX conversion are excluded, and exchange closing times may differ.";
 
 export const GEO_CORRELATION_CHANGE_BASIS = "Map series (GEO:) use the change in daily value between the same shared UTC dates, because counts such as transits can be zero.";