@gloom-sh/terminal 0.19.0 → 0.19.2

package/src/plugins/builtin/earnings-calls/data.ts

@@ -5,12 +5,14 @@ import {
   type CloudEarningsCallPayload,
   type CloudEarningsTranscriptPayload,
 } from "../../../api-client";
-import { ApiRequestError } from "../../../api-client/errors";
+import { ApiRequestError, isTransientFailure } from "../../../api-client/errors";
 import { listingAbroad, type IssuerListingParams, type ListingAbroad } from "../../../api-client/paths";
+import { servedFromSavedCopy } from "../../../data/saved-copies";
 import { areDifferentCompanies } from "../../../sources/sec-registrant";
 import type { HeadlessPaneApiClient, PluginPersistence } from "../../../types/plugin";
 import { shortDate } from "../earnings/format";
 import { callCountdown, callDay, callTimeKnown, isUpcomingCall } from "./upcoming";
+import { type CompanyFrom, readCompanyFrom } from "../../../types/company-from";
 
 type EarningsCallsApiClient = Pick<
   HeadlessPaneApiClient,
@@ -43,6 +45,8 @@ export interface EarningsCallsResult {
   calls: CloudEarningsCallPayload[];
   fetchedAt: number;
   stale: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
   /** HTTP status when the request failed, used to pick the right gate. */
   errorStatus?: number;
@@ -50,6 +54,8 @@ export interface EarningsCallsResult {
   pending?: boolean;
   /** The symbol is not one the SEC knows, so there is nothing to look for. */
   unknownTicker?: boolean;
+  /** The company's home line the calls are read from, when not the listing asked. */
+  companyFrom?: CompanyFrom | null;
   /** Maximum rows requested from the server, which supplies no total/hasMore. */
   sourceLimit?: number;
   /** The response filled its request; additional calls may exist. */
@@ -118,6 +124,8 @@ export interface UpcomingCallsResult {
   stale: boolean;
   /** The server answered its limit's worth: calls later on these days may be missing. */
   truncated?: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
   errorStatus?: number;
 }
@@ -130,7 +138,7 @@ export interface UpcomingDays {
 let persistence: PluginPersistence | null = null;
 const activeUpcomingFetches = new Map<string, Promise<UpcomingCallsResult>>();
 const activeListFetches = new Map<string, Promise<EarningsCallsResult>>();
-const activeTranscriptFetches = new Map<string, Promise<CloudEarningsTranscriptPayload>>();
+const activeTranscriptFetches = new Map<string, Promise<EarningsTranscriptResult>>();
 
 export function attachEarningsCallsPersistence(value: PluginPersistence): void {
   persistence = value;
@@ -216,8 +224,15 @@ export async function loadEarningsCallsWithClient(
       ...(offset > 0 ? { offset } : {}),
     })
     .then((payload) => {
-      const calls = listingCalls(payload.calls ?? [], abroad);
-      const value = { calls, pending: payload.pending === true, unknownTicker: payload.unknownTicker === true };
+      // Calls the service read from the company's home line are the company's, whatever the line's own name.
+      const companyFrom = readCompanyFrom(payload.companyFrom);
+      const calls = companyFrom ? payload.calls ?? [] : listingCalls(payload.calls ?? [], abroad);
+      const value = {
+        calls,
+        pending: payload.pending === true,
+        unknownTicker: payload.unknownTicker === true,
+        ...(companyFrom ? { companyFrom } : {}),
+      };
       // A list with calls still being produced changes by the minute, so it
       // is not worth keeping; a list of finished transcripts is.
       const settled = !value.pending && calls.every((call) => call.hasTranscript);
@@ -242,22 +257,24 @@ export async function loadEarningsCallsWithClient(
     .catch((error: unknown) => {
       const refreshError = error instanceof Error ? error.message : String(error);
       const errorStatus = statusOf(error);
-      // An auth failure must surface its gate rather than silently showing
-      // a cached list the user is no longer entitled to refresh.
+      // A refusal (signed out, no Pro, a route the server stopped serving) or a reply that fails
+      // validation is said rather than covered by a cached list.
       const expired = store?.getResource<CloudEarningsCallListPayload>(LIST_KIND, key, {
         sourceKey: CACHE_SOURCE,
         schemaVersion: LIST_CACHE_SCHEMA_VERSION,
         allowExpired: true,
       });
-      if (expired && errorStatus !== 401 && errorStatus !== 402 && errorStatus !== 403) {
-        return {
+      if (expired && isTransientFailure(error)) {
+        // A command that shows it ends with when the copy was saved, not with the failure.
+        return servedFromSavedCopy({
           ...expired.value,
           ...sourceScope(expired.value.calls),
           fetchedAt: expired.fetchedAt,
           stale: true,
+          savedAt: expired.fetchedAt,
           refreshError,
           errorStatus,
-        };
+        }, expired.fetchedAt);
       }
       throw error;
     })
@@ -355,12 +372,13 @@ export async function loadUpcomingCallsWithClient(
       const errorStatus = statusOf(error);
       // Losing Pro access re-gates the calendar, as it does the list.
       const expired = read(true);
-      if (expired && errorStatus !== 401 && errorStatus !== 402 && errorStatus !== 403) {
-        return {
+      if (expired && isTransientFailure(error)) {
+        return servedFromSavedCopy({
           ...upcomingFromCache(expired.value, expired.fetchedAt, true),
+          savedAt: expired.fetchedAt,
           refreshError: error instanceof Error ? error.message : String(error),
           errorStatus,
-        };
+        }, expired.fetchedAt);
       }
       throw error;
     })
@@ -397,11 +415,14 @@ export function isPendingTranscript(
   return record.status === "pending" || !Array.isArray(record.turns);
 }
 
+/** A transcript, and when it was saved when its refresh failed and the saved copy answered. */
+export type EarningsTranscriptResult = CloudEarningsTranscriptPayload & { savedAt?: number };
+
 export async function loadTranscriptWithClient(
   client: EarningsCallsApiClient,
   callId: string,
   options?: { force?: boolean },
-): Promise<CloudEarningsTranscriptPayload> {
+): Promise<EarningsTranscriptResult> {
   const force = options?.force ?? false;
   const store = persistence;
 
@@ -432,7 +453,6 @@ export async function loadTranscriptWithClient(
       return transcript;
     })
     .catch((error: unknown) => {
-      const status = statusOf(error);
       const expired = store?.getResource<CloudEarningsTranscriptPayload>(
         TRANSCRIPT_KIND,
         callId,
@@ -443,8 +463,8 @@ export async function loadTranscriptWithClient(
         },
       );
       // Losing Pro access must re-gate the transcript, not serve it from cache.
-      if (expired && status !== 401 && status !== 402 && status !== 403) {
-        return expired.value;
+      if (expired && isTransientFailure(error)) {
+        return servedFromSavedCopy({ ...expired.value, savedAt: expired.fetchedAt }, expired.fetchedAt);
       }
       throw error;
     })
@@ -461,7 +481,7 @@ export async function loadTranscriptWithClient(
 export function loadTranscript(
   callId: string,
   options?: { force?: boolean },
-): Promise<CloudEarningsTranscriptPayload> {
+): Promise<EarningsTranscriptResult> {
   return loadTranscriptWithClient(apiClient, callId, options);
 }
 

package/src/plugins/builtin/earnings-calls/headless.ts

@@ -46,6 +46,10 @@ import {
   type TranscriptSection,
 } from "./model";
 import { REPORT_FILTER, REPORT_PAGE, REPORT_ROWS } from "../shared/headless-options";
+import { companyDataNotes } from "../../../types/company-from";
+import { savedCopyMark, unansweredRefreshError } from "../../../data/saved-copies";
+
+const optionalErrors = (error: string | null) => error ? [error] : undefined;
 
 const CALL_COLUMNS = [
   { key: "ticker", header: "Ticker" },
@@ -170,9 +174,12 @@ function projectEarningsCallsHeadless(
     columns: CALL_COLUMNS,
     rows,
     ...(next ? { textRows: rows.filter((row) => row.id !== next.id) } : {}),
-    errors: result.refreshError ? [result.refreshError] : undefined,
+    errors: optionalErrors(unansweredRefreshError(result)),
     ...(sourceLimitReached || result.pending ? { complete: false } : {}),
+    ...(result.companyFrom ? { notes: companyDataNotes(result.companyFrom) } : {}),
     metadata: {
+      // A list served from a saved copy ends with when it was saved, instead of its refresh failure.
+      ...savedCopyMark(result),
       ...(next ? { notices: [nextCallNotice(next, now)], nextCall: { id: next.id, callAt: next.callAt, timeKnown: callTimeKnown(next), in: callCountdown(next, now) } } : {}),
       fetchedAt: result.fetchedAt,
       stale: result.stale,
@@ -211,9 +218,11 @@ function transcriptResult(
   return {
     columns: TRANSCRIPT_COLUMNS,
     rows,
-    errors: calls.refreshError ? [calls.refreshError] : undefined,
+    errors: optionalErrors(unansweredRefreshError(calls)),
     ...(calls.stale || calls.pending ? { complete: false } : {}),
+    ...(calls.companyFrom ? { notes: companyDataNotes(calls.companyFrom) } : {}),
     metadata: {
+      ...savedCopyMark(calls),
       stale: calls.stale,
       callListFetchedAt: calls.fetchedAt,
       callListPending: calls.pending ?? false,
@@ -283,10 +292,11 @@ function projectCalendar(
     columns: CALENDAR_COLUMNS,
     textColumns: sameClock ? CALENDAR_TEXT_COLUMNS.filter((column) => column.key !== "local") : CALENDAR_TEXT_COLUMNS,
     rows,
-    errors: result.refreshError ? [result.refreshError] : undefined,
+    errors: optionalErrors(unansweredRefreshError(result)),
     ...(result.stale || result.truncated ? { complete: false } : {}),
     empty: "No calls on the calendar these days.",
     metadata: {
+      ...savedCopyMark(result),
       view: "upcoming",
       fetchedAt: result.fetchedAt,
       stale: result.stale,

package/src/plugins/builtin/earnings-calls/pane.tsx

@@ -1,8 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import type {
-  CloudEarningsCallPayload,
-  CloudEarningsTranscriptPayload,
-} from "../../../api-client";
+import type { CloudEarningsCallPayload } from "../../../api-client";
 import { recordResearchActivity } from "../../../api-client/research-activity";
 import {
   DataTableStackView,
@@ -19,6 +16,7 @@ import {
   type QueryBarView,
   type StatItem,
 } from "../../../components";
+import { useCompanyDataFooter } from "../../../components/layout/pane/status-footer";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
 import { AudioPlayer, useCanPlayAudio } from "../../../components/ui";
 import { useShortcut } from "../../../react/input";
@@ -48,7 +46,11 @@ import {
   loadEarningsCalls,
   loadTranscript,
   statusOf,
+  type EarningsTranscriptResult,
 } from "./data";
+import { isPermanentClientError } from "../../../api-client/errors";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
+import { STALE_SEGMENT } from "../../../components/layout/pane/status-footer";
 import { callPeriod, callTitle, eventLabelOf, formatCallDate, formatDuration, formatSentiment } from "./format";
 import { findCallForQuarter, findInLines, MIN_FIND_LENGTH, turnParagraphs } from "./model";
 import { READER_TABS, TranscriptView, type ReaderTab, type TranscriptPlayback } from "./transcript-view";
@@ -147,6 +149,8 @@ interface TickerLookup {
   calls: CloudEarningsCallPayload[];
   fetchedAt?: number;
   stale?: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
   refreshRequest?: number;
 }
@@ -277,6 +281,10 @@ function CallsListView({
   const [listStatus, setListStatus] = useState<"idle" | "loading" | "loaded" | "error">(initialShelf ? "loaded" : "idle");
   const [listError, setListError] = useState<{ message: string; status?: number } | null>(null);
   const [stale, setStale] = useState(initialShelf?.stale === true);
+  // The company's home line the shelf is read from, for a receipt or a foreign line.
+  const [companyFrom, setCompanyFrom] = useState(initialShelf?.companyFrom ?? null);
+  // The list's refresh failed and a copy saved at this time (ms) answered instead.
+  const [listSavedAt, setListSavedAt] = useState<number | null>(null);
   const [listFetchedAt, setListFetchedAt] = useState(initialShelf?.fetchedAt ?? 0);
   const listRequestVersion = useRef(0);
   const [listCompletedRequest, setListCompletedRequest] = useState(0);
@@ -289,7 +297,7 @@ function CallsListView({
 
   const [selectedId, setSelectedId] = usePluginPaneState<string | null>(`${stateKey}selectedId`, null);
   const [detailOpen, setDetailOpen] = usePluginPaneState<boolean>(`${stateKey}detailOpen`, false);
-  const [transcript, setTranscript] = useState<CloudEarningsTranscriptPayload | null>(null);
+  const [transcript, setTranscript] = useState<EarningsTranscriptResult | null>(null);
   useEffect(() => {
     if (focused && transcript && detailOpen) recordResearchActivity("pro_feature_used", "transcripts");
   }, [focused, transcript, detailOpen]);
@@ -340,10 +348,13 @@ function CallsListView({
           setNextOffset(result.calls.length);
           setHasMore(result.sourceLimitReached === true);
           setStale(result.stale);
+          setCompanyFrom(result.companyFrom ?? null);
+          setListSavedAt(result.savedAt ?? null);
           setListFetchedAt(result.fetchedAt);
           setListPending(result.pending === true && result.calls.length === 0);
+          // A saved copy says when it was saved, in the footer, rather than why the refresh failed.
           setListError(
-            result.refreshError ? { message: result.refreshError, status: result.errorStatus } : null,
+            result.refreshError && result.savedAt == null ? { message: result.refreshError, status: result.errorStatus } : null,
           );
           setListStatus("loaded");
           setListCompletedRequest(request);
@@ -353,6 +364,7 @@ function CallsListView({
           setListPending(false);
           setHasMore(false);
           setNextOffset(0);
+          setListSavedAt(null);
           setListError({
             message: error instanceof Error ? error.message : String(error),
             status: statusOf(error),
@@ -410,6 +422,8 @@ function CallsListView({
     setListStatus(held ? "loaded" : "idle");
     setListPending(held?.pending === true && held.calls.length === 0);
     setStale(held?.stale === true);
+    setCompanyFrom(held?.companyFrom ?? null);
+    setListSavedAt(null);
     setListFetchedAt(held?.fetchedAt ?? 0);
     setListError(null);
     setLookup(null);
@@ -477,19 +491,22 @@ function CallsListView({
             calls: result.calls,
             fetchedAt: result.fetchedAt,
             stale: result.stale,
-            refreshError: result.refreshError,
+            savedAt: result.savedAt,
+            refreshError: result.savedAt == null ? result.refreshError : undefined,
             refreshRequest,
           });
         })
         .catch((error: unknown) => {
           if (cancelled) return;
-          const retainRows = ![401, 402, 403].includes(statusOf(error) ?? 0);
+          // A refusal asking again will not change clears the rows; a passing failure keeps them.
+          const retainRows = !isPermanentClientError(error);
           setLookup((current) => ({
             ticker: lookupTicker,
             status: "error",
             calls: retainRows && current?.ticker === lookupTicker ? current.calls : [],
             fetchedAt: retainRows && current?.ticker === lookupTicker ? current.fetchedAt : undefined,
             stale: retainRows && current?.ticker === lookupTicker && current.calls.length > 0,
+            savedAt: retainRows && current?.ticker === lookupTicker ? current.savedAt : undefined,
             refreshError: error instanceof Error ? error.message : String(error),
             refreshRequest,
           }));
@@ -817,6 +834,8 @@ function CallsListView({
     [focusSearch, scrollTranscriptBy, openSource, playerShown, playback.toggle, playback.seekBy],
   );
 
+  // A receipt's or foreign line's calls are its company's, read from the home line.
+  useCompanyDataFooter(companyFrom, !readerOpen);
   usePaneFooter(
     footerId,
     () => {
@@ -857,15 +876,14 @@ function CallsListView({
         }
       }
       const visibleLookup = lookup && (lookup.ticker === lookupTicker || (detailOpen && selected?.ticker === lookup.ticker)) ? lookup : null;
-      if (visibleLookup?.stale) {
-        info.push({ id: "lookup-stale", parts: [{ text: `${visibleLookup.ticker} stale cache`, tone: "warning" }] });
-      }
       if (visibleLookup?.refreshError && lookupState !== "error") {
         info.push({ id: "lookup-error", parts: [{ text: `${visibleLookup.ticker}: ${visibleLookup.refreshError}`, tone: "warning" }] });
       }
-      if (stale) {
-        info.push({ id: "stale", parts: [{ text: "stale cache", tone: "warning" }] });
-      }
+      // What a failed refresh left on screen: a saved copy says when it was saved; a list
+      // held from an earlier session, still refreshing, is only stale.
+      const savedCopy = savedCopyFooterInfo([listSavedAt, visibleLookup?.savedAt, readerOpen ? selectedTranscript?.savedAt : null]);
+      info.push(...savedCopy);
+      if (stale && listSavedAt == null) info.push(STALE_SEGMENT);
       if (listError) {
         info.push({ id: "error", parts: [{ text: listError.message, tone: "warning" }] });
       }
@@ -904,6 +922,8 @@ function CallsListView({
       lookupTicker,
       lookup,
       stale,
+      listSavedAt,
+      selectedTranscript,
       listError,
       proRequired,
       transcriptProRequired,

package/src/plugins/builtin/econ/calendar-model.ts

@@ -1,7 +1,7 @@
 import { createPluginCache } from "../../../data/plugin-cache";
 import type { DataTableColumn } from "../../../components";
 import { colors } from "../../../theme/colors";
-import { displayWidth } from "../../../utils/format";
+import { displayWidth, MISSING_VALUE } from "../../../utils/format";
 import { fetchEconCalendar } from "./calendar-source";
 import { parseEconFigure } from "./figures";
 import { isAllDayEvent, type EconEvent, type EconImpact } from "./types";
@@ -235,6 +235,51 @@ export function eventCountry(event: Pick<EconEvent, "country" | "event">): strin
   return euroAreaMember(event) ?? event.country;
 }
 
+/** What the feeds call the Fed's rate decision. */
+const FED_RATE_DECISION_NAMES = new Set(["federal funds rate", "fed interest rate decision"]);
+/** A figure that is a range (3.75-4.00%) rather than one level. */
+const RANGE_FIGURE = /\d\s*[-\u2013]\s*\d/;
+const FED_FUNDS_UPPER_BOUND = "Federal Funds Rate (upper bound)";
+
+/**
+ * A row's name as the calendar shows it. The Fed's decision is figured as one
+ * level, the top of the target range (4.00% for 3.75-4.00%), so it is named
+ * for that bound rather than read as the range or the effective rate; a row
+ * whose figures are the range keeps the feed's name. Whatever matches rows by
+ * name (alerts, the FRED history) reads the feed's own, `event.event`.
+ */
+export function econEventName(event: Pick<EconEvent, "country" | "event" | "actual" | "forecast" | "prior">): string {
+  if ((event.country !== "US" && event.country !== "USD") || !FED_RATE_DECISION_NAMES.has(event.event.trim().toLowerCase())) return event.event;
+  return [event.actual, event.forecast, event.prior].some((figure) => !!figure && RANGE_FIGURE.test(figure)) ? event.event : FED_FUNDS_UPPER_BOUND;
+}
+
+/** Letters and digits only, lower case: "Non-Farm" and "nonfarm" read alike. */
+const compactName = (text: string) => text.toLowerCase().replace(/[^a-z0-9]+/g, "");
+
+/**
+ * Whether a row's name carries every word of `query`, case, spaces and
+ * punctuation aside: `nonfarm` finds Non Farm Payrolls and Non-Farm
+ * Employment Change, `fed funds` the Federal Funds Rate. The name shown and the
+ * feed's own are both read.
+ */
+export function matchesEventSearch(event: Pick<EconEvent, "country" | "event" | "actual" | "forecast" | "prior">, query: string): boolean {
+  const words = query.split(/\s+/).map(compactName).filter(Boolean);
+  if (words.length === 0) return true;
+  const names = [event.event, econEventName(event)].map(compactName);
+  return names.some((name) => words.every((word) => name.includes(word)));
+}
+
+/**
+ * A release still to come that has a prior and no forecast: the consensus is
+ * not in yet, which the calendar draws as a dash.
+ */
+export function awaitsConsensus(event: Pick<EconEvent, "actual" | "forecast" | "prior">): boolean {
+  return !event.actual?.trim() && !event.forecast?.trim() && !!event.prior?.trim();
+}
+
+/** What a dash under Forecast means on a row still to come. */
+export const NO_CONSENSUS_NOTE = `${MISSING_VALUE} forecast = no consensus yet`;
+
 /** A national euro-area release matches EU (and G7, as EU) and its own member's code. */
 export function matchesCountry(event: Pick<EconEvent, "country" | "event">, filter: CountryFilter): boolean {
   const member = euroAreaMember(event);
@@ -376,6 +421,8 @@ export function subscribeCalendar(listener: () => void): () => void {
 }
 
 export interface EconCalendarLoadResult extends EconCalendarCacheEntry {
+  /** `stale-fallback`: the copy an earlier read saved, answering because its refresh failed. */
+  source?: "cache" | "network" | "stale-fallback";
   refreshError?: string;
 }
 

package/src/plugins/builtin/econ/calendar-source.ts

@@ -1,5 +1,6 @@
 import { apiClient, type CloudEconEventPayload } from "../../../api-client";
 import { ApiRequestError, isPermanentClientError } from "../../../api-client/errors";
+import { withPercentUnits } from "./figures";
 import type { EconEvent } from "./types";
 
 function toEconEvent(event: CloudEconEventPayload): EconEvent {
@@ -9,9 +10,10 @@ function toEconEvent(event: CloudEconEventPayload): EconEvent {
   };
 }
 
+/** The calendar, a percent indicator's figures in percent on every row (`withPercentUnits`). */
 export async function fetchEconCalendar(): Promise<EconEvent[]> {
   const events = await apiClient.getCloudEconomicCalendar();
-  return events.map(toEconEvent);
+  return withPercentUnits(events.map(toEconEvent));
 }
 
 /** The stored calendar from a day, or why it was not read so the caller reads the current calendar instead. */
@@ -40,7 +42,7 @@ export async function fetchEconCalendarFrom(from: string): Promise<EconCalendarF
     if (!payload || !Array.isArray(payload.events) || !(payload.storedFrom === null || /^\d{4}-\d{2}-\d{2}$/.test(String(payload.storedFrom)))) {
       return { events: null, failure: "the server returned an unreadable calendar" };
     }
-    return { events: payload.events.map(toEconEvent), storedFrom: payload.storedFrom };
+    return { events: withPercentUnits(payload.events.map(toEconEvent)), storedFrom: payload.storedFrom };
   } catch (error) {
     if (error instanceof ApiRequestError && error.status === 404) return { events: null, failure: null };
     if (isPermanentClientError(error)) throw error;

package/src/plugins/builtin/econ/detail-view.tsx

@@ -18,6 +18,8 @@ import {
   type StatItem,
 } from "../../../components";
 import { spanDigits } from "../../../components/chart-table";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
+import { isPermanentClientError } from "../../../api-client/errors";
 import { getTableWidth, hasMeaningfulTableHorizontalOverflow } from "../../../components/ui/table-layout";
 import type { CompositeAxisDomain } from "../../../components/chart/composite/types";
 import {
@@ -31,7 +33,7 @@ import { Box, Text } from "../../../ui";
 import { displayWidth, truncateToDisplayWidth } from "../../../utils/format";
 import { useOpenTickerChoice } from "../shared/ticker-choice";
 import { resolveFredMapping, projectFredHistory, fredHistoryUnits } from "./fred-series-map";
-import { actualColor, CALENDAR_TIME_ZONE_LABEL, timeLabel } from "./calendar-model";
+import { actualColor, CALENDAR_TIME_ZONE_LABEL, econEventName, timeLabel } from "./calendar-model";
 import { hasNoStatedTime, isAllDayEvent, type EconEvent } from "./types";
 
 interface EconDetailViewProps {
@@ -123,6 +125,8 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
   const [freshnessWarning, setFreshnessWarning] = useState<string | null>(null);
+  // The history's refresh failed and the copy saved at this time (ms) answered instead.
+  const [savedAt, setSavedAt] = useState<number | null>(null);
   const [data, setData] = useState<FredSeriesData | null>(null);
   // Null follows the latest period.
   const [selectedDate, setSelectedDate] = useState<string | null>(null);
@@ -146,6 +150,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
       setLoading(false);
       setError(null);
       setFreshnessWarning(null);
+      setSavedAt(null);
       return;
     }
 
@@ -156,6 +161,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
         setLoading(false);
         setError(null);
         setFreshnessWarning(null);
+        setSavedAt(null);
         return;
       }
     } else {
@@ -165,6 +171,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
     setLoading(true);
     setError(null);
     setFreshnessWarning(null);
+    setSavedAt(null);
 
     loadCachedFredSeries(
       request,
@@ -174,12 +181,18 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
       }),
     )
       .then((entry) => {
+        // A refusal or a reply that fails validation is thrown by the load, never covered by a saved copy.
+        const saved = entry.source === "stale-fallback";
         setData(entry.data);
-        setFreshnessWarning(entry.stale
-          ? `Cached ${new Date(entry.fetchedAt).toISOString().slice(0, 10)} · refresh failed`
+        // A copy a failed refresh left says when it was saved, in the footer as every pane does;
+        // a series its source has not updated since is a note.
+        setSavedAt(saved ? entry.fetchedAt : null);
+        setFreshnessWarning(entry.stale && !saved
+          ? `Source not updated since ${new Date(entry.fetchedAt).toISOString().slice(0, 10)}.`
           : null);
       })
       .catch((err) => {
+        if (isPermanentClientError(err)) setData(null);
         setError(err instanceof Error ? err.message : String(err));
       })
       .finally(() => {
@@ -199,6 +212,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
   // which asks which one when there are several.
   const openTickerChoice = useOpenTickerChoice();
   const relatedTickers = useMemo(() => mapping?.relatedTickers ?? [], [mapping]);
+  usePaneFooter("econ-detail:saved", () => ({ info: savedCopyFooterInfo([savedAt]) }), [savedAt]);
   usePaneFooter("econ-detail:related", () => relatedTickers.length > 0 ? {
     hints: [{
       id: "related",
@@ -238,7 +252,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
   const rows = useMemo<HistoryRow[]>(() => projected
     .map((obs, index) => ({ date: obs.date, value: obs.value, change: index > 0 ? obs.value - projected[index - 1]!.value : null }))
     .reverse(), [projected]);
-  const label = event.event;
+  const label = econEventName(event);
   const series = useMemo(() => [staticSeries(
     projected.map((obs) => scalarPoint(new Date(`${obs.date}T00:00:00Z`), obs.value)),
     { id: "fred-history", label, color: colors.positive, calendarSpaced: true },

package/src/plugins/builtin/econ/figures.ts

@@ -70,3 +70,51 @@ export function econRowFigures(row: { actual?: string | null; forecast?: string
     scale: first?.scale ?? null,
   };
 }
+
+/** A figure printed as a bare number, with no unit and no scale letter: `0.6`, `-3`, `1,5`. */
+const BARE_NUMBER = /^[+-]?(?:\d+(?:[.,]\d+)?|\.\d+)$/;
+
+/**
+ * Release names that are a percent whatever one row's figures say: a change
+ * month on month, quarter on quarter or year on year, and the rates published
+ * in percent. "Consumer Inflation Expectations" is a balance, not a rate, and
+ * is not one of them.
+ */
+const PERCENT_NAME = /\b(?:mom|qoq|yoy)\b|(?:^|\s)[mqy]\/[mqy](?=\s|$)|\b(?:inflation|unemployment|jobless|interest|growth|mortgage|funds|participation|savings) rate\b/i;
+
+type EconRowText = { country: string; event: string; indicatorId?: string | null; actual: string | null; forecast: string | null; prior: string | null };
+
+const FIGURE_KEYS = ["actual", "forecast", "prior"] as const;
+
+/** Every release of one indicator: its id, else its country and name. */
+const indicatorKey = (event: Pick<EconRowText, "country" | "event" | "indicatorId">) => event.indicatorId || `${event.country}|${event.event}`;
+
+/**
+ * The calendar with every figure of a percent indicator in percent. The feeds
+ * drop the sign on some rows: US Inflation Rate MoM's prior came as `0.6`, and
+ * the 30-year mortgage rate's as `7.32` beside its actual `7.41%`. An
+ * indicator is in percent when any of its figures is, or its name says so
+ * (`PERCENT_NAME`), and none of its figures is in another unit or scale; its
+ * bare figures then carry `%`. Anything else is left as the feed wrote it.
+ */
+export function withPercentUnits<T extends EconRowText>(events: readonly T[]): T[] {
+  const indicators = new Map<string, { percent: boolean; other: boolean }>();
+  for (const event of events) {
+    const key = indicatorKey(event);
+    const seen = indicators.get(key) ?? { percent: false, other: false };
+    if (PERCENT_NAME.test(event.event)) seen.percent = true;
+    for (const field of FIGURE_KEYS) {
+      const figure = parseEconFigure(event[field]);
+      if (!figure) continue;
+      if (figure.unit === "%") seen.percent = true;
+      else if (figure.unit || figure.scale !== 1) seen.other = true;
+    }
+    indicators.set(key, seen);
+  }
+  return events.map((event) => {
+    const seen = indicators.get(indicatorKey(event))!;
+    if (!seen.percent || seen.other) return event;
+    const bare = FIGURE_KEYS.filter((field) => BARE_NUMBER.test(event[field]?.trim() ?? ""));
+    return bare.length ? { ...event, ...Object.fromEntries(bare.map((field) => [field, `${event[field]!.trim()}%`])) } : event;
+  });
+}