gloomberb 0.15.0 → 0.15.2

package/src/plugins/builtin/realized-vol/model.ts

@@ -3,7 +3,7 @@ import {
   REALIZED_VOLATILITY_WINDOWS, realizedVolatilityCadenceIssue, realizedVolatilityResult, rollingRealizedVolatility, volatilityCone,
   type RealizedVolatilityEstimator, type RollingRealizedVolatilityPoint, type VolatilityConeStatistics,
 } from "../shared/volatility";
-import type { SurfaceSnapshot } from "../vol-surface/model";
+import type { SurfaceExpiry, SurfaceSnapshot } from "../vol-surface/model";
 
 export interface RealizedVolatilityModel {
   symbol: string;
@@ -99,32 +99,47 @@ export interface CurrentAtmIvSnapshot {
   reference: CurrentAtmIvReference | null;
   error: string | null;
   warnings: string[];
+  /** The underlying has no option chain in the sources, so there is no IV to show and nothing failed. */
+  noOptionChain?: boolean;
 }
 
 /** A LEAPS ATM IV is not comparable with a 10 to 260 session realized cone. */
 export const MAX_CURRENT_ATM_IV_DAYS = 90;
 
-/** Use a listed expiry nearest 30 days, preserving its own observation date and tenor. */
+/**
+ * Use a listed expiry nearest 30 days, preserving its own observation date and tenor. Warnings and
+ * failures are the chosen slice's and the surface's own, not those of expiries the reference does not use.
+ */
 export function projectCurrentAtmIv(surface: SurfaceSnapshot): CurrentAtmIvSnapshot {
-  const warnings = [...surface.warnings];
-  const candidates = surface.expiries.filter((expiry) => expiry.atmIV != null
-    && Number.isFinite(expiry.atmIV) && expiry.atmIV > 0 && expiry.years > 0 && expiry.years * 365 <= MAX_CURRENT_ATM_IV_DAYS);
+  if (surface.catalogue.length === 0 && surface.failures.some((failure) => failure.expiration == null && failure.reasonCode === "NO_DATA")) {
+    return { reference: null, error: null, warnings: [], noOptionChain: true };
+  }
+  const eligible = surface.expiries.filter((expiry) => expiry.years > 0 && expiry.years * 365 <= MAX_CURRENT_ATM_IV_DAYS);
+  const usable = (expiry: SurfaceExpiry) => expiry.atmIV != null && Number.isFinite(expiry.atmIV) && expiry.atmIV > 0;
+  const distance = (expiry: SurfaceExpiry) => Math.abs(expiry.years * 365 - 30);
+  const warnings: string[] = [];
+  const candidates = eligible.filter(usable);
   const fresh = candidates.filter((expiry) => !expiry.stale && !expiry.error);
   if (fresh.length < candidates.length) warnings.push("Stale or failed ATM IV slices excluded from the current reference");
   const dated = fresh.filter((expiry) => expiry.asOf != null && Number.isFinite(Date.parse(expiry.asOf)));
   if (dated.length < fresh.length) warnings.push("Some ATM IV observations have no valid source date");
-  dated.sort((a, b) => Math.abs(a.years * 365 - 30) - Math.abs(b.years * 365 - 30) || a.expiration - b.expiration);
+  dated.sort((a, b) => distance(a) - distance(b) || a.expiration - b.expiration);
   const expiry = dated[0];
-  const errors = [...new Set(surface.failures.map((failure) => failure.message))];
   if (!expiry) {
-    return { reference: null, error: errors.join("; ") || "Current ATM IV unavailable from cleaned option quotes", warnings };
+    const errors = [...new Set(surface.failures.map((failure) => failure.message))];
+    return { reference: null, error: errors.join("; ") || "Current ATM IV unavailable from cleaned option quotes",
+      warnings: [...new Set([...eligible.flatMap((entry) => entry.warnings), ...warnings])] };
   }
   const daysToExpiry = expiry.years * 365;
+  if (eligible.some((entry) => !usable(entry) && distance(entry) < distance(expiry))) {
+    warnings.push(`Expiries nearer 30 days have no usable ATM quotes; reference uses the ${Math.round(daysToExpiry)}d expiry`);
+  }
   if (surface.spotAsOf == null) warnings.push("Underlying quote observation date unavailable");
+  const errors = [...new Set(surface.failures.filter((failure) => failure.expiration == null).map((failure) => failure.message))];
   return { reference: {
     value: expiry.atmIV!, date: new Date(expiry.asOf!),
     label: `ATM IV ${Math.round(daysToExpiry)}d`,
     daysToExpiry, expiration: expiry.expiration, source: expiry.source, stale: expiry.stale,
     ivSource: surface.settings.ivSource, spot: surface.spot, spotAsOf: surface.spotAsOf ?? null,
-  }, error: errors.join("; ") || null, warnings: [...new Set(warnings)] };
+  }, error: errors.join("; ") || null, warnings: [...new Set([...expiry.warnings, ...warnings])] };
 }

package/src/plugins/builtin/relative-rotation/client.ts

@@ -186,7 +186,8 @@ export function cachedRotation(
   return value
     ? {
         payload: value.data,
-        stale: value.stale,
+        // The pane revalidates this copy on mount; only a failed refresh makes it stale.
+        stale: false,
         refreshError: null as string | null,
       }
     : null;

package/src/plugins/builtin/research/relative-valuation-pane.tsx

@@ -1,5 +1,4 @@
 import { formatPriceEarnings } from "../../../utils/price-earnings";
-import { describeFundamentalMarketCap } from "../../../utils/market-capitalization";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { TextAttributes } from "../../../ui";
 import {
@@ -210,17 +209,11 @@ export function RelativeValuationPane({ focused, width, height }: PaneProps) {
   const rowErrors = rows.filter((row) => row.error).map((row) => `${row.symbol}: ${row.error}`);
   const status = [error, ...rowErrors, staleSymbols.length ? `Stale quotes: ${staleSymbols.join(", ")}` : null,
     missingFx ? "Market-cap FX unavailable" : null].filter(Boolean).join(" · ") || null;
-  const selectedRow = sortedRows[selectedIdx];
-  const selectedCapNotice = selectedRow?.marketCapProvenance?.kind === "fundamentals"
-    ? `${selectedRow.symbol} cap: ${describeFundamentalMarketCap(selectedRow.marketCapProvenance)}.` : undefined;
 
   usePaneNoticeFooter({
     registrationId: "relative-valuation-notices",
-    notices: [
-      ...rows.filter((row) => row.fundamentalsProvenance?.stale)
-        .map((row) => `${row.symbol}: ${RELATIVE_VALUATION_STALE_FUNDAMENTALS_NOTICE}.`),
-      ...(selectedCapNotice ? [selectedCapNotice] : []),
-    ],
+    notices: rows.filter((row) => row.fundamentalsProvenance?.stale)
+      .map((row) => `${row.symbol}: ${RELATIVE_VALUATION_STALE_FUNDAMENTALS_NOTICE}.`),
     focused,
   });
 
@@ -236,7 +229,7 @@ export function RelativeValuationPane({ focused, width, height }: PaneProps) {
       case "changePercent":
         return { text: row.changePercent != null ? formatPercentRaw(row.changePercent) : "-", color: selectedColor ?? priceColor(row.changePercent ?? 0) };
       case "marketCap":
-        return { text: formatCompact(row.marketCap ?? undefined), color: selectedColor ?? colors.textDim };
+        return { text: formatCompact(row.marketCap ?? undefined, { fixedDecimals: true }), color: selectedColor ?? colors.textDim };
       case "trailingPE":
         return { text: formatPriceEarnings(row.reportedMultiples.trailingPE), color: selectedColor ?? colors.text };
       case "forwardPE":

package/src/plugins/builtin/risk-factors/data.test.ts

@@ -25,6 +25,13 @@ for(const status of [401,403,404])test(`report ${status} cannot fall back to cac
  await expect(loadRiskReportWithClient(api,"CONTROL",2025)).rejects.toMatchObject({status});expect(store.getResource("report","CONTROL:2025",{...options,allowExpired:true})).toBeNull();
 });
 
+test("a list 404 is an empty cached list",async()=>{
+ const store=new MemoryPluginPersistence();attachRiskFactorsPersistence(store);const api=client();let calls=0;
+ api.getRiskReports=async()=>{calls++;throw new ApiRequestError("No risk factor reports for this ticker",404);};
+ await expect(loadRiskReportsWithClient(api,"CONTROL")).resolves.toMatchObject({reports:[],stale:false});
+ await loadRiskReportsWithClient(api,"CONTROL");expect(calls).toBe(1);expect(store.getResource("reports","CONTROL",options)?.value).toMatchObject({reports:[]});
+});
+
 test("transient historical refresh retains immutable source dates and expired content",async()=>{
  const store=new MemoryPluginPersistence();attachRiskFactorsPersistence(store);store.seedResource("report","CONTROL:2025",report(2025),{...options,stale:true,expired:true});
  const before=store.getResource("report","CONTROL:2025",{...options,allowExpired:true})!;const api=client();api.getRiskReport=async()=>{throw new ApiRequestError("Temporary outage",503);};

package/src/plugins/builtin/risk-factors/data.ts

@@ -96,7 +96,14 @@ function loadCached<T extends object>(
 export function loadRiskReportsWithClient(client: RiskApiClient, ticker: string, options?: { force?: boolean }): Promise<RiskReportsResult> {
   const key = ticker.trim().toUpperCase();
   return loadCached(client, LIST_KIND, key, activeListFetches, LIST_CACHE_POLICY, options?.force ?? false, async () => {
-    const payload = await client.getRiskReports(key);
+    let payload: CloudRiskReportListPayload;
+    try {
+      payload = await client.getRiskReports(key);
+    } catch (error) {
+      // The list answers 404 when no 10-K risk report is on file (20-F filers, funds).
+      if (error instanceof ApiRequestError && error.status === 404) return { company: null, reports: [] };
+      throw error;
+    }
     if (!payload || !Array.isArray(payload.reports)) throw new Error(`Risk report list unavailable for ${key}.`);
     return payload;
   });

package/src/plugins/builtin/risk-factors/pane.test.tsx

@@ -44,6 +44,9 @@ test("historical year loading and failure cannot display the previous report or
 for(const status of [503,404])test(`initial report ${status} stops loading and exposes the cause`,async()=>{
  transport(path=>path.endsWith("/CONTROL")?Response.json(list([2026])):new Response("Detail unavailable",{status}));await mount();const failed=capture(`initial-detail-${status}`);expect(failed).toContain("Detail unavailable");expect(failed).not.toContain("Loading...");expect(failed).not.toContain("[o]pen filing");cases.push({case:`initial-detail-${status}`,requests:[...requests]});
 });
+test("a ticker without a 10-K report shows the empty state, not a load error",async()=>{
+ transport(()=>Response.json({message:"No risk factor reports for this ticker"},{status:404}));await mount();const empty=capture("list-404");expect(empty).toContain("No 10-K risk factors on file for CONTROL.");expect(empty).not.toContain("Report list:");expect(empty).not.toContain("Could not load risk reports");expect(requests).toEqual(["/public/risks/CONTROL"]);
+});
 test("changing ticker while a historical report is pending cannot adopt the old security or year",async()=>{
  const pending=deferred<Response>();transport(path=>path.endsWith("/CONTROL")?Response.json(list([2026,2025])):path.endsWith("/CONTROL/2025")?pending.promise:path.endsWith("/CONTROL/2026")?Response.json(report(2026)):path.endsWith("/OTHER")?Response.json({...list([2024]),company:{...list([2024]).company,ticker:"OTHER"}}):Response.json({...report(2024),ticker:"OTHER",docUrl:"https://www.sec.gov/Archives/other-2024.htm",overview:"Only OTHER 2024 risk analysis"}));
  await mount();await click("2025 10-K");await act(async()=>selectTicker("OTHER"));await settle();const next=capture("ticker-changed");expect(next).toContain("Only OTHER 2024 risk analysis");expect(requests).not.toContain("/public/risks/OTHER/2025");pending.resolve(Response.json(report(2025)));await settle();const completed=capture("ticker-old-completion");expect(completed).toContain("Only OTHER 2024 risk analysis");expect(completed).not.toContain("Only 2025 risk analysis");await click("[o]pen filing");expect(opened.at(-1)).toBe("https://www.sec.gov/Archives/other-2024.htm");cases.push({case:"ticker-ownership",requests:[...requests],opened:[...opened]});

package/src/plugins/builtin/shared/screener-live-quotes.test.ts

@@ -97,14 +97,14 @@ describe("screener live quotes", () => {
   });
 });
 
-test("replacement snapshots clear unavailable fields and select only the qualified listing", () => {
+test("replacement snapshots clear unavailable fields, keep the listing currency and select only the qualified listing", () => {
   const rows = [{ symbol: "ACME", exchange: "NASDAQ", name: "US", currency: "USD", price: 10, change: 1, changePercent: 10, volume: 200, lastUpdated: 100 },
     { symbol: "ACME", exchange: "LSE", name: "UK", currency: "GBP", price: 8, change: 0, changePercent: 0, volume: 0, lastUpdated: 100 }];
   const targets = buildScreenerQuoteTargets(rows, "ACME:XLON");
   expect(targets.map(target => target.selected)).toEqual([false, true]);
-  const entries = new Map([[buildQuoteKey(rows[0]!), readyEntry({ symbol: "ACME", price: 12, currency: "USD", lastUpdated: 200 })]]);
+  const entries = new Map([[buildQuoteKey(rows[0]!), readyEntry({ symbol: "ACME", price: 12, currency: "", lastUpdated: 200 })]]);
   expect(overlayScreenerQuoteEntries(rows, entries)).toEqual([
-    expect.objectContaining({ price: 12, change: null, changePercent: null, volume: null, lastUpdated: 200 }), rows[1]!,
+    expect.objectContaining({ price: 12, change: null, changePercent: null, volume: null, currency: "USD", lastUpdated: 200 }), rows[1]!,
   ]);
   entries.set(buildQuoteKey(rows[0]!), readyEntry({ symbol: "ACME", price: 12, currency: "USD", lastUpdated: 50, change: 0, changePercent: 0, volume: 0 }));
   expect(overlayScreenerQuoteEntries(rows, entries)).toEqual(rows);

package/src/plugins/builtin/shared/screener-live-quotes.ts

@@ -3,6 +3,7 @@ import { publicTickerKey } from "../../../utils/exchanges";
 import type { Quote } from "../../../types/financials";
 import { buildQuoteKey, resolveEntryData } from "../../../market-data/selectors";
 import type { QueryEntry } from "../../../market-data/result-types";
+import { resolveCurrencyUnit } from "../../../utils/currency-units";
 
 const STREAM_FRESHNESS_MS = 2 * 60_000;
 const STREAM_CONNECTING_GRACE_MS = 15_000;
@@ -17,6 +18,7 @@ export interface ScreenerQuoteRow {
   currency: string;
   exchange: string;
   lastUpdated?: number;
+  previousClose?: number;
 }
 
 export interface ScreenerQuoteFreshness {
@@ -48,6 +50,18 @@ function finite(value: number | undefined): value is number {
   return typeof value === "number" && Number.isFinite(value);
 }
 
+/** Venues quote these in either the major or the minor unit (GBP or GBp). */
+const TWO_UNIT_CURRENCIES = new Set(["GBP", "ILS", "ZAR"]);
+
+/** A quote without a currency keeps the listing's, so a streamed price never
+ * loses its symbol, unless the listing's currency has two units and the
+ * quote's could be either. */
+function overlayCurrency(row: ScreenerQuoteRow, quote: Quote): string {
+  const quoted = quote.currency?.trim();
+  if (quoted) return quoted;
+  return TWO_UNIT_CURRENCIES.has(resolveCurrencyUnit(row.currency).currency) ? "" : row.currency;
+}
+
 /**
  * The last overlay of each source row. Every stream flush hands over a new
  * entries map, but most rows' quotes did not move; returning the same row
@@ -87,7 +101,8 @@ function overlayQuote<T extends ScreenerQuoteRow>(row: T, quote: Quote): T {
       ? quote.changePercent
       : null,
     volume: finite(quote.volume) && quote.volume >= 0 ? quote.volume : null,
-    currency: quote.currency?.trim() || "",
+    currency: overlayCurrency(row, quote),
+    previousClose: finite(quote.previousClose) ? quote.previousClose : undefined,
     lastUpdated: quote.lastUpdated,
   };
 }

package/src/plugins/builtin/short-volume/client.ts

@@ -84,7 +84,8 @@ const cacheKey = (symbol: string, scope: ShortVolumeScope) => `${scope}:${symbol
 export function cachedShortVolume(symbol: string, scope: ShortVolumeScope): ShortVolumeResource | null {
   const cached = shortVolumeCache.get(cacheKey(symbol, scope), { allowExpired: true });
   if (!cached) return null;
-  try { return { payload: validateShortVolume(cached.data, symbol, scope), stale: cached.stale, refreshError: null }; }
+  // The pane revalidates this copy on mount; only a failed refresh makes it stale.
+  try { return { payload: validateShortVolume(cached.data, symbol, scope), stale: false, refreshError: null }; }
   catch { return null; }
 }
 export async function loadShortVolume(symbol: string, scope: ShortVolumeScope, force = false): Promise<ShortVolumeResource> {

package/src/plugins/builtin/short-volume/pane.tsx

@@ -74,7 +74,6 @@ export function ShortVolumePane({ width, height, focused }: Pick<PaneProps, "wid
     info: data ? [
       ...(updatedAgo ? [{ id: "updated", parts: [{ text: updatedAgo, tone: "muted" as const }] }] : []),
       ...(resource.data?.stale ? [{ id: "stale", parts: [{ text: "stale", tone: "warning" as const }] }] : []),
-      ...(data.status !== "available" ? [{ id: "partial", parts: [{ text: data.status, tone: "warning" as const }] }] : []),
     ] : [],
   });
   if (!data && isCloudSessionRequired(resource.error)) return <SignInWall action="view daily short volume" needsVerification={session.needsVerification} />;

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

@@ -5,7 +5,7 @@ import type {
   HeadlessPaneLoadArgs,
 } from "../../../types/plugin";
 import { normalizeCik } from "./api";
-import { buildFundOverlap } from "./overlap";
+import { buildFundOverlap, overlapPeriod } from "./overlap";
 import { appendTickerHoldings, loadCrowding, loadTickerHoldings, type TickerHoldings } from "./signals";
 import {
   loadBrowserRows,
@@ -261,9 +261,9 @@ export function createThirteenFHeadless(
         const fund = await resolveFund(query, args, ctx, dependencies);
         const other = await resolveFund(String(args.options.compare ?? ""), args, ctx, dependencies);
         const [first, second] = await Promise.all([dependencies.loadDetail(fund.cik, fund.name, args, ctx), dependencies.loadDetail(other.cik, other.name, args, ctx)]);
-        const samePeriod = !!first.latestForm && first.latestForm.periodOfReport === second.latestForm?.periodOfReport;
+        const comparedPeriod = overlapPeriod(first, second);
         const rows = buildFundOverlap(first, second);
-        return { columns: [{ key: "ticker", header: "Ticker" }, { key: "type", header: "Type" }, { key: "issuer", header: "Issuer" }, { key: "weight", header: "First weight", align: "right", format: weight }, { key: "comparedWeight", header: "Second weight", align: "right", format: weight }], rows: rows.slice(0, limit).map(row => ({ ...row })), errors: [...(first.warnings ?? []), ...(second.warnings ?? []), ...(!samePeriod ? ["The funds have different latest reporting quarters."] : [])], metadata: { firstFund: first.name, secondFund: second.name, firstPeriod: first.latestForm?.periodOfReport ?? null, secondPeriod: second.latestForm?.periodOfReport ?? null, truncated: rows.length > limit } };
+        return { columns: [{ key: "ticker", header: "Ticker" }, { key: "type", header: "Type" }, { key: "issuer", header: "Issuer" }, { key: "weight", header: "First weight", align: "right", format: weight }, { key: "comparedWeight", header: "Second weight", align: "right", format: weight }], rows: rows.slice(0, limit).map(row => ({ ...row })), errors: [...(first.warnings ?? []), ...(second.warnings ?? []), ...(!comparedPeriod ? ["No reporting quarter is loaded for both funds."] : [])], metadata: { firstFund: first.name, secondFund: second.name, firstPeriod: first.latestForm?.periodOfReport ?? null, secondPeriod: second.latestForm?.periodOfReport ?? null, comparedPeriod, truncated: rows.length > limit, notices: comparedPeriod ? [`Quarter compared: ${comparedPeriod}`] : [] } };
       }
       if (view === "crowding") {
         const { rows: sourceRows, ...metadata } = await loadCrowding(ctx.signal);

package/src/plugins/builtin/thirteenf/model.ts

@@ -165,6 +165,15 @@ export function buildBrowserRows(options: {
   });
 }
 
+export type ThirteenFAmendmentKind = "restatement" | "new-holdings" | "unknown";
+
+/** How a 13F-HR/A combines with its period's report; null for an original filing. */
+export function amendmentKind(form: Pick<ThirteenFFormSummary, "isAmendment" | "amendmentType">): ThirteenFAmendmentKind | null {
+  if (!form.isAmendment) return null;
+  const type = form.amendmentType?.trim().toUpperCase();
+  return type === "RESTATEMENT" ? "restatement" : type === "NEW HOLDINGS" ? "new-holdings" : "unknown";
+}
+
 function browserReportTotal(
   form: ThirteenFFormSummary | undefined,
   report: ThirteenFPeriodReport | undefined,
@@ -172,7 +181,8 @@ function browserReportTotal(
 ): number | null | undefined {
   if (!form) return undefined;
   if (report?.periodOfReport === form.periodOfReport) return report.complete ? report[key] : null;
-  return !form.isAmendment || form.amendmentType?.trim().toUpperCase() === "RESTATEMENT" ? form[key] : null;
+  const kind = amendmentKind(form);
+  return kind == null || kind === "restatement" ? form[key] : null;
 }
 
 export function dedupeLatestForms(forms: ThirteenFFormSummary[]): ThirteenFFormSummary[] {
@@ -194,11 +204,11 @@ export function buildPeriodReports(forms: ThirteenFFormSummary[]): ThirteenFPeri
   const unique = [...new Map(forms.map((form) => [form.accessionNumber, form])).values()];
   for (const form of unique.sort(compareFormRecency)) {
     let report = byPeriod.get(form.periodOfReport);
-    const amendmentType = form.amendmentType?.trim().toUpperCase();
-    if (!form.isAmendment || amendmentType === "RESTATEMENT") {
+    const kind = amendmentKind(form);
+    if (kind == null || kind === "restatement") {
       report = { periodOfReport: form.periodOfReport, filings: [form], complete: true,
         tableValueTotal: form.tableValueTotal, tableEntryTotal: form.tableEntryTotal };
-    } else if (amendmentType === "NEW HOLDINGS") {
+    } else if (kind === "new-holdings") {
       report = report ?? { periodOfReport: form.periodOfReport, filings: [], complete: false,
         tableValueTotal: null, tableEntryTotal: null };
       report.filings.push(form);

package/src/plugins/builtin/thirteenf/overlap-pane.tsx

@@ -12,9 +12,15 @@ import { normalizeCik, searchThirteenFFunds } from "./api";
 import { loadFundDetail } from "./data";
 import { formatWeightMaybe } from "./format";
 import { isCikQuery } from "./model";
-import { buildFundOverlap, type FundOverlapRow } from "./overlap";
+import { buildFundOverlap, overlapPeriod, type FundOverlapRow } from "./overlap";
 import type { FundDetailData, ThirteenFFund } from "./types";
 
+/** The quarter compared, and the fund's newer latest quarter when it has one. */
+function periodDetail(data: FundDetailData | null, period: string | null): string | undefined {
+  const latest = data?.latestForm?.periodOfReport;
+  return period && latest && latest !== period ? `${period} · latest ${latest}` : latest;
+}
+
 export function FundOverlapView({ data, focused, width }: { data: FundDetailData; focused: boolean; width: number }) {
   const [query, setQuery] = usePluginPaneState<string>("overlap:query", "");
   const [target, setTarget] = usePluginPaneState<ThirteenFFund | null>("overlap:target", null);
@@ -74,16 +80,17 @@ export function FundOverlapView({ data, focused, width }: { data: FundDetailData
     if (isPlainKey(event, "/") && !target) { event.preventDefault?.(); focusSearch(); }
     if (isPlainKey(event, "m") && target) { event.preventDefault?.(); setMineOnly(value => !value); }
   });
-  const mismatch = peer && data.latestForm?.periodOfReport !== peer.latestForm?.periodOfReport;
+  const period = peer ? overlapPeriod(data, peer) : null;
+  const mismatch = peer && !period;
   usePaneStatusFooter({ registrationId: "13f-overlap", loading: loading || loadingMore, error, hints: target ? [{ id: "mine", key: "m", label: mineOnly ? "all tickers" : "mine", title: mineOnly ? "All Tickers" : "Mine Only", onPress: () => setMineOnly(value => !value) }] : [{ id: "search", key: "/", label: "search", onPress: focusSearch }] });
-  usePaneNoticeFooter({ registrationId: "13f-overlap-notice", focused, notices: [...(peer?.warnings ?? []), ...(mismatch ? ["The funds have different latest reporting quarters; overlap is unavailable."] : [])] });
+  usePaneNoticeFooter({ registrationId: "13f-overlap-notice", focused, notices: [...(peer?.warnings ?? []), ...(mismatch ? ["No reporting quarter is loaded for both funds; overlap is unavailable."] : [])] });
   const rows = useMemo(() => (peer ? buildFundOverlap(data, peer) : []).filter(row => !mineOnly || mine.has(row.ticker)).sort((a, b) => ((a[sort.id] ?? -1) - (b[sort.id] ?? -1)) * (sort.desc ? -1 : 1)), [peer, data, mineOnly, mine, sort]);
   const positionColumns: DataTableColumn[] = [{ id: "mine", label: "MINE", width: 5, align: "left" }, { id: "ticker", label: "TICKER", width: 10, align: "left" }, { id: "type", label: "TYPE", width: 6, align: "left" }, { id: "issuer", label: "ISSUER", width: Math.max(18, width - 58), align: "left" }, { id: "weight", label: "FIRST %", width: 12, align: "right" }, { id: "comparedWeight", label: "SECOND %", width: 12, align: "right" }];
   return <DataTableStackView<ThirteenFFund, DataTableColumn>
     focused={focused && !searchFocused} detailOpen={!!target} onBack={() => setTarget(null)} detailTitle={target?.name}
     detailContent={<Box flexDirection="column" flexGrow={1}>
-      <KeyValueRow label="First" value={data.name} detail={data.latestForm?.periodOfReport} />
-      <KeyValueRow label="Second" value={peer?.name ?? target?.name ?? ""} detail={peer?.latestForm?.periodOfReport} />
+      <KeyValueRow label="First" value={data.name} detail={periodDetail(data, period)} />
+      <KeyValueRow label="Second" value={peer?.name ?? target?.name ?? ""} detail={periodDetail(peer, period)} />
       <QueryBar width={width} filters={[{ id: "mine", kind: "toggle", label: "Mine", value: mineOnly, onChange: setMineOnly }]} />
       <DataTableView<FundOverlapRow, DataTableColumn> focused={focused} columns={positionColumns} items={rows} getItemKey={row => row.id}
         selection={{ kind: "id", selectedId: selectedPositionId, getId: row => row.id, onChange: setSelectedPositionId }}

package/src/plugins/builtin/thirteenf/overlap.test.ts

@@ -1,5 +1,5 @@
 import { expect, test } from "bun:test";
-import { buildFundOverlap } from "./overlap";
+import { buildFundOverlap, overlapPeriod } from "./overlap";
 import type { FundDetailData, ThirteenFFormSummary, ThirteenFHoldingRecord } from "./types";
 const form: ThirteenFFormSummary = { url: "", accessionNumber: "current", submissionType: "13F-HR", periodOfReport: "2026-06-30", filedAsOfDate: "2026-08-14", cik: "1", companyName: "Fund", tableValueTotal: 100, tableEntryTotal: 1, isAmendment: false };
 const holding = (overrides: Partial<ThirteenFHoldingRecord> = {}): ThirteenFHoldingRecord => ({ accessionNumber: "current", cik: "1", cusip: "one", ticker: "AAA", issuer: "A", titleOfClass: "COM", putCall: "", shareType: "SH", value: 20, shares: 2, investmentDiscretion: "SOLE", votingAuthoritySole: 2, votingAuthorityShared: 0, votingAuthorityNone: 0, ...overrides });
@@ -15,3 +15,15 @@ test("overlap cannot mix quarter ends and incomplete reports do not acquire weig
   const partial = detail([holding()], { latestReport: { periodOfReport: form.periodOfReport, filings: [form], complete: false, tableValueTotal: null, tableEntryTotal: null } });
   expect(buildFundOverlap(first, partial)[0]?.comparedWeight).toBeNull();
 });
+test("a fund one quarter ahead compares at the other fund's latest quarter, weighted against that report", () => {
+  const previousForm = { ...form, accessionNumber: "prior", periodOfReport: "2026-03-31", tableValueTotal: 50 };
+  const report = (source: ThirteenFFormSummary, complete = true) => ({ periodOfReport: source.periodOfReport, filings: [source], complete, tableValueTotal: source.tableValueTotal, tableEntryTotal: 1 });
+  const ahead = detail([holding({ cusip: "new" })], { previousForm, previousHoldings: [holding({ value: 10 })], latestReport: report(form), previousReport: report(previousForm) });
+  const behind = detail([holding()], { latestForm: previousForm, latestReport: report(previousForm) });
+  expect(overlapPeriod(ahead, behind)).toBe("2026-03-31");
+  expect(buildFundOverlap(ahead, behind)).toEqual([{ id: "ONE||SH", ticker: "AAA", issuer: "A", type: "SH", weight: 0.2, comparedWeight: 0.4 }]);
+  const failed = { ...ahead, previousReport: report(previousForm, false), previousHoldings: [] };
+  expect(overlapPeriod(failed, behind)).toBeNull();
+  expect(buildFundOverlap(failed, behind)).toEqual([]);
+  expect(overlapPeriod(ahead, { ...ahead, cik: "2" })).toBe("2026-06-30");
+});

package/src/plugins/builtin/thirteenf/overlap.ts

@@ -9,11 +9,39 @@ export interface FundOverlapRow {
   weight: number | null;
   comparedWeight: number | null;
 }
+
+/** Quarter ends a fund can be compared at: its latest report, and the previous one when it loaded. */
+function comparablePeriods(data: FundDetailData): string[] {
+  return [
+    data.latestForm?.periodOfReport,
+    data.previousReport?.complete !== false ? data.previousForm?.periodOfReport : undefined,
+  ].filter((period): period is string => !!period);
+}
+
+/**
+ * The latest quarter end both funds reported among their two most recent
+ * reports, so a fund that has not filed the newest quarter yet still compares.
+ */
+export function overlapPeriod(first: FundDetailData, second: FundDetailData): string | null {
+  const periods = new Set(comparablePeriods(second));
+  return comparablePeriods(first).filter(period => periods.has(period)).sort().at(-1) ?? null;
+}
+
+/** The fund's report for a period, as if it were the latest, with no prior quarter to show exits against. */
+function atPeriod(data: FundDetailData, period: string): FundDetailData | null {
+  if (data.latestForm?.periodOfReport === period) return data;
+  if (data.previousForm?.periodOfReport !== period || data.previousReport?.complete === false) return null;
+  return { ...data, latestForm: data.previousForm, latestReport: data.previousReport, latestHoldings: data.previousHoldings, previousForm: null, previousReport: undefined, previousHoldings: [] };
+}
+
 export function buildFundOverlap(first: FundDetailData, second: FundDetailData): FundOverlapRow[] {
-  if (!first.latestForm || first.latestForm.periodOfReport !== second.latestForm?.periodOfReport) return [];
+  const period = overlapPeriod(first, second);
+  const left = period ? atPeriod(first, period) : null;
+  const right = period ? atPeriod(second, period) : null;
+  if (!left || !right) return [];
   // Rows are keyed by CUSIP, option side and share type, including when ticker aliases change.
-  const peer = new Map(buildFundHoldingRows(second).filter(row => row.action !== "exit").map(row => [row.id, row]));
-  return buildFundHoldingRows(first).filter(row => row.action !== "exit" && peer.has(row.id)).map(row => ({
+  const peer = new Map(buildFundHoldingRows(right).filter(row => row.action !== "exit").map(row => [row.id, row]));
+  return buildFundHoldingRows(left).filter(row => row.action !== "exit" && peer.has(row.id)).map(row => ({
     id: row.id, ticker: row.ticker, issuer: row.issuer, type: row.putCall || row.shareType,
     weight: row.weight, comparedWeight: peer.get(row.id)!.weight,
   })).sort((a, b) => (b.weight ?? -1) - (a.weight ?? -1));

package/src/plugins/builtin/thirteenf/pane.test.tsx

@@ -248,6 +248,7 @@ describe("ThirteenFPane", () => {
 
     const holdingsFrame = testSetup!.captureCharFrame();
     expect(holdingsFrame).toContain("Holdings");
+    expect(holdingsFrame).toContain("filed 2026-05-15, restated");
     expect(holdingsFrame).toContain("AAPL");
     expect(holdingsFrame).not.toContain("Accession");
   });
@@ -271,7 +272,7 @@ describe("ThirteenFPane", () => {
     const detailFrame = testSetup!.captureCharFrame();
     expect(detailFrame).toContain("Accession");
     expect(detailFrame).toContain("0000000001-26-000001");
-    expect(detailFrame).toContain("RESTATEMENT");
+    expect(detailFrame).toContain("Restatement");
     expect(detailFrame).toContain("Alpha Capital");
     expect(detailFrame).toContain("Apple Inc.");
     expect(detailFrame).toContain("CALL");

package/src/plugins/builtin/thirteenf/pane.tsx

@@ -34,6 +34,7 @@ import {
   DEFAULT_TIMELINE_SORT,
   FUND_DETAIL_TABS,
   THIRTEENF_PANE_ID,
+  amendmentKind,
   hasComparable13FQuarter,
   browserSortFor,
   buildBrowserColumns,
@@ -520,7 +521,6 @@ export function FundDetailView({
   const currentSourceUrl = activeTab === "filings"
     ? openFiling?.url ?? selectedFiling?.url
     : selectedHoldingFiling?.url ?? latestForm?.url;
-  const statusFiling = openFiling ?? latestForm;
   useEffect(() => {
     if (holdingSelectedId && visibleHoldingRows.some((row) => row.id === holdingSelectedId)) return;
     setHoldingSelectedId(visibleHoldingRows[0]?.id ?? null);
@@ -610,7 +610,8 @@ export function FundDetailView({
   });
 
   const holdingStats: StatItem[] = [
-    { id: "reported", label: "Reported", value: data?.latestForm?.periodOfReport ?? "--", detail: `filed ${data?.latestForm?.filedAsOfDate || "--"}` },
+    { id: "reported", label: "Reported", value: data?.latestForm?.periodOfReport ?? "--",
+      detail: `filed ${data?.latestForm?.filedAsOfDate || "--"}${data?.latestForm && amendmentKind(data.latestForm) === "restatement" ? ", restated" : ""}` },
     data && hasComparable13FQuarter(data)
       ? { id: "compared", label: "Compared with", value: data.previousForm!.periodOfReport }
       : { id: "compared", label: "Compared with", value: "No prior quarter", tone: "muted" },
@@ -632,11 +633,6 @@ export function FundDetailView({
   const detailHints = useMemo<PaneHint[]>(() => hasHoldingFiling
     ? [{ id: "filing", key: "f", label: "iling", title: "Open Filing", onPress: openSelectedFilingInPane }]
     : [], [hasHoldingFiling, openSelectedFilingInPane]);
-  const detailStatusInfo = useMemo<PaneFooterSegment[]>(() => (
-    statusFiling?.isAmendment
-      ? [{ id: "amended", parts: [{ text: "amended", tone: "warning" }] }]
-      : []
-  ), [statusFiling?.isAmendment]);
   usePaneStatusLinkFooter({
     registrationId: "thirteenf-detail",
     focused,
@@ -644,7 +640,6 @@ export function FundDetailView({
     source: openFiling ? "SEC 13F" : null,
     loading: activeTab !== "overlap" && status === "loading",
     error: activeTab === "overlap" ? null : error,
-    info: activeTab === "overlap" ? [] : detailStatusInfo,
     showOpenHint: true,
     hints: detailHints,
   });
@@ -873,11 +868,19 @@ function FilingDetailView({
 
   usePaneNoticeFooter({ registrationId: "thirteenf-filing-notices", notices: [...new Set([...sourceWarnings, ...warnings])], focused });
 
+  // An untyped amendment may replace or add to the report, so only it is a caveat.
+  const kind = amendmentKind(filing);
+  const amendmentStat: StatItem | null = kind && {
+    id: "amendment",
+    label: "Amendment",
+    value: kind === "restatement" ? "Restatement" : kind === "new-holdings" ? "New holdings" : "Unknown type",
+    tone: kind === "unknown" ? "warning" : undefined,
+  };
   // The fund names the stack and `o` opens the filing, so neither repeats here.
   const summaryItems: StatItem[] = [
     { id: "filed", label: "Filed", value: filing.filedAsOfDate || "--" },
     { id: "form", label: "Form", value: filing.submissionType || "--" },
-    ...(filing.isAmendment ? [{ id: "amendment", label: "Amendment", value: filing.amendmentType ?? "amended", tone: "warning" as const }] : []),
+    ...(amendmentStat ? [amendmentStat] : []),
     { id: "cik", label: "CIK", value: filing.cik },
     { id: "accession", label: "Accession", value: filing.accessionNumber },
   ];

package/src/plugins/builtin/thirteenf/table.ts

@@ -13,7 +13,7 @@ import {
   formatShares,
   formatShortDate,
 } from "./format";
-import { positionType } from "./model";
+import { amendmentKind, positionType } from "./model";
 import type {
   FilingPositionColumn,
   FilingPositionRow,
@@ -157,6 +157,12 @@ export function renderFilingPositionCell(
   }
 }
 
+function amendmentLabel(row: FundTimelineRow): string | null {
+  const kind = amendmentKind(row);
+  if (!kind) return null;
+  return kind === "restatement" ? "Restatement" : kind === "new-holdings" ? "New holdings" : "Amendment (unknown)";
+}
+
 export function renderTimelineCell(
   row: FundTimelineRow,
   column: FundTimelineColumn,
@@ -184,8 +190,8 @@ export function renderTimelineCell(
       };
     case "form":
       return {
-        text: row.isAmendment ? row.amendmentType?.toUpperCase() === "RESTATEMENT" ? "Restatement" : row.amendmentType?.toUpperCase() === "NEW HOLDINGS" ? "New holdings" : "Amendment (unknown)" : row.submissionType,
-        color: selectedColor ?? (row.isAmendment ? colors.warning : colors.textDim),
+        text: amendmentLabel(row) ?? row.submissionType,
+        color: selectedColor ?? (amendmentKind(row) === "unknown" ? colors.warning : colors.textDim),
       };
   }
 }

package/src/plugins/builtin/ticker-detail/financials/model.ts

@@ -200,12 +200,6 @@ export function financialStatementCurrency(
 }
 
 export function financialStatementLimitations(financials: TickerFinancials | null | undefined): string[] {
-  const industry = financials?.profile?.industry ?? "";
-  const records = [financials?.fundamentals, ...(financials?.annualStatements ?? []), ...(financials?.quarterlyStatements ?? [])];
-  const hasMetric = (keys: string[]) => records.some((record) => keys.some((key) => {
-    const value = (record as Record<string, unknown> | undefined)?.[key];
-    return typeof value === "number" && Number.isFinite(value);
-  }));
   const limitations: string[] = [];
   const operatingNotice = financialOperatingSourceNotice(financials);
   if (operatingNotice) limitations.push(operatingNotice);
@@ -215,12 +209,6 @@ export function financialStatementLimitations(financials: TickerFinancials | nul
   if ([...(financials?.annualStatements ?? []), ...(financials?.quarterlyStatements ?? [])].some(row => row.unavailableFields?.includes("netIncome"))) {
     limitations.push("Parent net income is unavailable for some reported periods.");
   }
-  if (/\breit\b/i.test(industry) && !hasMetric(["fundsFromOperations", "adjustedFundsFromOperations", "ffo", "affo"])) {
-    limitations.push("FFO/AFFO are unavailable.");
-  }
-  if (/\bbanks?\b/i.test(industry) && !hasMetric(["commonEquityTier1Ratio", "cet1Ratio", "riskWeightedAssets"])) {
-    limitations.push("Bank capital measures, including CET1 and risk-weighted assets, are unavailable.");
-  }
   return limitations;
 }
 

package/src/plugins/builtin/ticker-detail/headless-schema.ts

@@ -24,7 +24,10 @@ export const paneSchemas = {
     discovery: {
       id: "financial-statements",
       aliases: ["financials", "financial statement", "income statement", "balance sheet", "cash flow statement"],
-      limitations: ["One company per invocation; use GF for cross-company metric comparisons."],
+      limitations: [
+        "One company per invocation; use GF for cross-company metric comparisons.",
+        "Excludes bank regulatory capital (CET1, risk-weighted assets) and REIT FFO/AFFO.",
+      ],
       screenshotReadiness: "ready",
     },
   },

package/src/plugins/builtin/ticker-detail/index.test.tsx

@@ -770,7 +770,7 @@ describe("TickerResearchPane", () => {
 
     const frame = testSetup.captureCharFrame();
     expect(frame).toContain("€125");
-    expect(frame).toContain("2.2B USD");
+    expect(frame).toContain("2.20B USD");
     expect(frame).toContain("Account");
     expect(frame).toContain("Qty");
     expect(frame).toContain("Avg");