gloomberb 0.16.3 → 0.16.4

package/src/cli/pane-functions/function-help.ts

@@ -21,6 +21,9 @@ export interface FunctionHelpKey {
   label: string;
 }
 
+/** A function Free cannot fully open: Pro only, or a limited preview on Free. */
+export type FunctionAccess = "pro" | "preview";
+
 /** How fresh the function's data is on each plan, in the words a pane footer uses. */
 export interface FunctionFreshness {
   free: string;
@@ -36,14 +39,21 @@ export interface FunctionHelp {
   keys: readonly FunctionHelpKey[];
   /** Null when the function shows no market data (settings, your own notes). */
   data: FunctionFreshness | null;
+  /**
+   * What Free gets: `pro` when only Pro opens it, `preview` when Free sees a
+   * limited preview of the same data. Absent when Free gets the whole
+   * function, even where Pro makes it fresher.
+   */
+  access?: FunctionAccess;
   /** The Bloomberg mnemonics it stands in for; empty when Bloomberg has none. */
   bloomberg: readonly string[];
-  /** The docs entry when it is filed under another mnemonic (BTST under BT). */
+  /** The docs entry when it is filed under another mnemonic (BTST under BT), or the full URL of a page of its own. */
   docs?: string;
 }
 
-/** The docs page's anchor for a mnemonic, as the page builds heading ids. */
+/** The docs page's anchor for a mnemonic, as the page builds heading ids, or a full docs URL as is. */
 export function functionDocsUrl(code: string): string {
+  if (code.startsWith("https://")) return code;
   const anchor = code.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
   return anchor ? `${FUNCTION_DOCS_URL}#${anchor}` : FUNCTION_DOCS_URL;
 }
@@ -222,8 +232,9 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["EQS"],
   },
   OMON: {
-    summary: "Calls and puts by expiry with bid, ask, volume, open interest, implied volatility and Greeks.",
-    usage: ["OMON NVDA"],
+    summary: "Calls and puts by expiry with bid, ask, spread, volume, open interest, implied volatility, Greeks, extrinsic per year and a put's cost as a percent of spot. "
+      + "The Strikes filter lists every strike, a count either side of the money, or a delta band such as .70 to .90 for deep in-the-money LEAPS.",
+    usage: ["OMON NVDA", "gloomberb fn OMON NVDA --expiration 2028-01-21"],
     keys: [key("c", "alc"), key("a", "dd to OSA"), key("s", "urface")],
     data: OPTIONS,
     bloomberg: ["OMON"],
@@ -251,21 +262,23 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["OVME", "OVML"],
   },
   OSA: {
-    summary: "Build a multi-leg options position and value it at any spot, date and vol shift: payoff, P&L grid, breakevens and Greeks. European pricing, so no early exercise.",
-    usage: ["OSA AAPL"],
+    summary: "Build a multi-leg options position and value it at any spot, date and vol shift: payoff, P&L grid, breakevens and Greeks. European pricing, so no early exercise. "
+      + "With a NAV and a budget in bps it sizes the position as a hedge: contracts, premium, notional protected and coverage of an equity sleeve.",
+    usage: ["OSA AAPL", "gloomberb fn OSA AAPL --strategy vertical --expiration 2027-01-15",
+      "gloomberb fn OSA SPY --strategy put --strike 700 --expiration 2027-01-15 --nav 100m --budget-bps 50 --sleeve 100m"],
     keys: [key("a", "dd leg"), key("c", "hain"), key("d", "ate"), key("v", "ol shift")],
     data: OPTIONS,
     bloomberg: ["OSA"],
   },
   OVDV: {
     summary: "The implied volatility surface fitted from option quotes: 3D sheet, table, smiles, ATM term structure, 25-delta skew and forwards, live or on stored daily closes.",
-    usage: ["OVDV NVDA"],
+    usage: ["OVDV NVDA", "gloomberb fn OVDV NVDA --tab skew --expiration 2027-01-15"],
     keys: [key("v", "iew"), key("c", "hain"), key("m", "ore expiries"), key("t", " stored dates")],
     data: { free: `${DELAYED}; stored dates at the close`, pro: "Real-time; stored dates at the close" },
     bloomberg: ["OVDV"],
   },
   HIVG: {
-    summary: "Daily 30- and 90-day at-the-money implied vol since February 2024 against realized vol, with each measure's 52-week rank and percentile.",
+    summary: "Daily 30-day, 90-day and one-year at-the-money implied vol since February 2024 against realized vol, with each measure's 52-week rank and percentile.",
     usage: ["HIVG AAPL"],
     keys: [key("s", "urface")],
     data: IV_DAILY,
@@ -322,7 +335,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: [],
   },
   VCA: {
-    summary: "IV rank, term slope, skew and IV against realized vol for up to 60 US tickers, flagged rich or cheap against each name's own year. Alone it screens index and sector ETFs.",
+    summary: "IV rank, one-year IV and its percentile, term slope, skew and IV against realized vol for up to 60 US tickers, flagged rich or cheap against each name's own year. Alone it screens index and sector ETFs.",
     usage: ["VCA", "VCA NVDA, AAPL, TSLA"],
     keys: [OPEN],
     data: IV_DAILY,
@@ -386,7 +399,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["DVD"],
   },
   SI: {
-    summary: "FINRA short interest settlements with shares short, days to cover and average daily volume over time.",
+    summary: "FINRA short interest settlements with shares short, days to cover and average daily volume over time. Daily volume is the other tab.",
     usage: ["SI AAPL"],
     keys: [key("v", "iew"), STEP],
     data: same("Twice a month, as FINRA publishes"),
@@ -400,9 +413,9 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: [],
   },
   SIV: {
-    summary: "FINRA daily off-exchange short volume as a share of volume, against its one-year range. Not short interest; SI has that.",
+    summary: "The short interest pane on Daily volume: FINRA off-exchange short volume as a share of volume, against its one-year range.",
     usage: ["SIV TSLA"],
-    keys: [STEP, OPEN_SOURCE],
+    keys: [key("v", "iew"), STEP, OPEN_SOURCE],
     data: same("Daily, the evening after each session"),
     bloomberg: [],
   },
@@ -411,6 +424,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["DIAG NVDA"],
     keys: [OPEN_SOURCE],
     data: { free: "A preview of the latest report, verified email", pro: "The full report, rerun on demand" },
+    access: "preview",
     bloomberg: [],
   },
   RISK: {
@@ -418,6 +432,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["RISK TSLA"],
     keys: [key("y", "ear"), key("o", "pen filing")],
     data: pro(AS_FILED.pro),
+    access: "pro",
     bloomberg: [],
   },
   EXEC: {
@@ -425,6 +440,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["EXEC NVDA"],
     keys: [key("y", "ear"), key("o", "pen filing")],
     data: pro(AS_FILED.pro),
+    access: "pro",
     bloomberg: ["MGMT"],
   },
   EK: {
@@ -432,6 +448,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["EK NVDA"],
     keys: [key("o", "pen filing")],
     data: pro(AS_FILED.pro),
+    access: "pro",
     bloomberg: ["CF"],
   },
   CALLS: {
@@ -439,6 +456,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["CALLS", "CALLS NVDA"],
     keys: [OPEN, key("/", "find"), OPEN_SOURCE],
     data: pro("Within hours of the call"),
+    access: "pro",
     bloomberg: ["EVT"],
   },
   JOBS: {
@@ -446,6 +464,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["JOBS", "JOBS NVDA"],
     keys: [key("1-4", " section"), key("o", "pen role"), key("c", "areers site")],
     data: pro("Daily"),
+    access: "pro",
     bloomberg: [],
   },
   SRCH: {
@@ -453,6 +472,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["SRCH data center capex"],
     keys: [SEARCH, key("Ctrl+S", " save search"), key("a", "lerts")],
     data: pro("As calls, stories and filings arrive"),
+    access: "pro",
     bloomberg: ["NSE"],
   },
   COVN: {
@@ -460,6 +480,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["COVN FICO"],
     keys: [TABS, OPEN, OPEN_SOURCE, key("f", "a"), key("m", "aturities")],
     data: { free: "As filed; three supported rows per section", pro: "As filed; all covenants, evidence and revisions" },
+    access: "preview",
     bloomberg: ["CAST"],
   },
   CRDOC: {
@@ -467,6 +488,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["CRDOC FICO", "COVN AAPL"],
     keys: [TABS, OPEN, OPEN_SOURCE, key("d", "es"), key("f", "a"), key("m", "aturities"), key("c", "ds")],
     data: { free: "As filed; three rows per section with supporting evidence", pro: "As filed; all stored terms, revisions and risk screens" },
+    access: "preview",
     bloomberg: ["CAST", "DDIS"],
   },
   ATTN: {
@@ -474,6 +496,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["ATTN", "ATTN 6758:JPX"],
     keys: [OPEN, key("e", "vidence"), key("d", "es"), key("g", "raph"), key("n", "ews")],
     data: { free: "Three published rows per section and the latest history point", pro: "All published rows and hourly history; minimum one-hour publication lag" },
+    access: "preview",
     bloomberg: [],
   },
   HIRE: {
@@ -481,6 +504,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["HIRE", "HIRE NET", "HIRE 0700:HKEX"],
     keys: [TABS, OPEN, key("e", "vidence"), key("o", "pen source"), key("d", "es"), key("g", "raph")],
     data: { free: "Latest values and three rows per section", pro: "Weekly history, all stored observations and evidence" },
+    access: "preview",
     bloomberg: [],
   },
   APPS: {
@@ -488,6 +512,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["APPS", "APPS META", "APPS 0700:HKEX"],
     keys: [TABS, OPEN, key("e", "vidence"), key("o", "pen source"), key("d", "es"), key("g", "raph")],
     data: { free: "Latest values and three rows per section", pro: "Daily observations, full history, countries and evidence" },
+    access: "preview",
     bloomberg: [],
   },
   CATL: {
@@ -495,6 +520,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["CATL", "CATL PFE", "CATL NOVN:SIX"],
     keys: [TABS, OPEN, OPEN_SOURCE, key("a", "lert"), key("d", "es")],
     data: { free: "Three events with primary-source evidence", pro: "All stored events, revision history and local alerts" },
+    access: "preview",
     bloomberg: [],
   },
   LITI: {
@@ -502,6 +528,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["LITI AAPL", "LITI MSFT"],
     keys: [TABS, OPEN, OPEN_SOURCE, key("t", "o calendar")],
     data: { free: "Three company events with evidence", pro: "All stored company dockets and history" },
+    access: "preview",
     bloomberg: ["LITI"],
   },
   KPIS: {
@@ -509,6 +536,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["KPIS CRM", "KPIS 005930:KRX"],
     keys: [TABS, OPEN, key("e", "vidence"), OPEN_SOURCE],
     data: { free: "Pro dataset; fixed latest preview with evidence", pro: "As disclosed; all stored observations and history" },
+    access: "preview",
     bloomberg: [],
   },
   GUIDE: {
@@ -516,6 +544,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["GUIDE DAL", "GUIDE CRM"],
     keys: [TABS, OPEN, key("e", "vidence"), OPEN_SOURCE],
     data: { free: "Pro dataset; fixed latest preview with evidence", pro: "As issued; full guidance history and actual matches" },
+    access: "preview",
     bloomberg: [],
   },
   EXPO: {
@@ -523,6 +552,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["EXPO AAPL=60% NVDA=40%", "EXPO PORT:portfolio-id", "EXPO WATCH:watchlist-id"],
     keys: [TABS, OPEN, key("s", "cenario and holdings"), key("e", "vidence"), key("a", "ll company disclosures"), key("v", "isibility"), key("o", "pen source")],
     data: { free: "One holding and one-hop evidence preview", pro: "Full holdings and up to four-hop paths, as filed" },
+    access: "preview",
     bloomberg: ["PORT", "SPLC"],
   },
   SPLC: {
@@ -530,6 +560,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["SPLC NVDA", "SUPPLY AAPL", "SPLC 005930.KS", "SPLC 8035.T"],
     keys: [OPEN, key("e", "vidence"), key("d", "es"), key("g", "raph")],
     data: { free: "Three relationships per role with evidence and a one-hop graph preview", pro: "Full evidence tiers, one-to-four-hop graphs and ranked paths" },
+    access: "preview",
     bloomberg: ["SPLC"],
   },
   AWARDS: {
@@ -537,6 +568,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["AWARDS", "AWARDS LMT", "AWARDS BA.:LSE"],
     keys: [TABS, OPEN, SEARCH, key("e", "vidence"), key("o", "pen source"), key("d", "es"), key("f", "a"), key("g", "raph"), key("s", "plc"), key("c", "alendar")],
     data: { free: "Pro preview: three rows per section", pro: "All collected awards, history, revisions and relationships" },
+    access: "preview",
     bloomberg: [],
   },
   SEG: {
@@ -544,6 +576,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["SEG AAPL"],
     keys: [],
     data: { free: "First two lines, about five weeks after each filing", pro: "Every line, about five weeks after each filing" },
+    access: "preview",
     bloomberg: [],
   },
   TAS: {
@@ -591,7 +624,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
   ASKG: {
     summary: "Ask a question about what is on screen and watch the tools Gloom runs to answer it.",
     usage: ["ASKG why is NVDA down today"],
-    keys: [key("n", "ew conversation"), key("t", "ickers"), key("o", "pen pane")],
+    keys: [key("n", "ew conversation"), key("g", "ood answer"), key("b", "ad answer"), key("t", "ickers"), key("o", "pen pane")],
     data: null,
     bloomberg: ["ASKB"],
   },
@@ -691,7 +724,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["IMAP"],
   },
   FXC: {
-    summary: "A cross-rate matrix for the major currencies, or for any of 45 chosen in its settings.",
+    summary: "A cross-rate matrix for the major currencies, or for any of 45 chosen in its settings or with --currencies from the command line (gloomberb fn FXC --currencies USD,ZAR,NGN).",
     usage: ["FXC"],
     keys: [],
     data: FX,
@@ -702,6 +735,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["PERP", "PERP BTC", "PERP TSLA"],
     keys: [TABS, OPEN, SEARCH, key("e", "vidence"), key("a", "lert")],
     data: { free: "A fixed preview and any one market's latest values", pro: "Every market, full rankings and stored history; source timestamps retained" },
+    access: "preview",
     bloomberg: [],
   },
   CRYP: {
@@ -751,6 +785,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["POWER", "POWER NEE"],
     keys: [SEARCH, key("o", "pen source"), key("d", "es"), key("f", "a"), key("g", "raph"), key("s", "plc"), key("c", "ompute"), key("t", "BO")],
     data: { free: "Three rows per section; limited history", pro: "Snapshots as public registers update; coverage by region" },
+    access: "preview",
     bloomberg: [],
   },
   GPU: {
@@ -758,6 +793,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["GPU", "GPU H100", "GPU B200"],
     keys: [key("t", "BO")],
     data: same("Hourly asks and AWS spot; other published prices every 6 or 24 hours"),
+    access: "preview",
     bloomberg: [],
   },
   NGS: {
@@ -794,6 +830,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     usage: ["FLOW"],
     keys: [OPEN],
     data: pro(REAL_TIME),
+    access: "pro",
     bloomberg: ["FLOW"],
   },
   HALT: {
@@ -876,8 +913,8 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["CRD"],
   },
   AUCT: {
-    summary: "Bill, note, bond and TIPS auction results: high rate, bid-to-cover, indirect share and size, with the auctions announced next.",
-    usage: ["AUCT", "AUCT 10-year"],
+    summary: "Bill, note, bond and TIPS auction results: high rate, stop-out versus average, bid-to-cover, indirect, direct and dealer takedown and size, with the auctions announced next. Searchable by benchmark (10Y) or CUSIP; history reaches back 10 years.",
+    usage: ["AUCT", "AUCT 10Y", "AUCT 91282CRF0"],
     keys: [SEARCH, key("f", "ilter"), OPEN],
     data: same("Daily, after each auction"),
     bloomberg: ["AUCT"],
@@ -897,16 +934,16 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["CDS"],
   },
   CDX: {
-    summary: "CDX IG, HY and EM with iTraxx Main and Crossover on the run: the 5Y level, 1D and 1W moves, 1Y percentile and the day's print count. IG and iTraxx in spread, HY and EM in price.",
+    summary: "CDX IG, HY and EM with iTraxx Main and Crossover on the run: the 5Y level, 1D and 1W moves, 1Y percentile and the day's print count. IG and iTraxx in spread, HY and EM in price. Sovereign CDS is the other tab.",
     usage: ["CDX"],
-    keys: [OPEN],
+    keys: [TABS, OPEN],
     data: same("Delayed, as trades are disseminated"),
     bloomberg: ["CDX"],
   },
   SOVR: {
-    summary: "Sovereign 5Y CDS ranked by the month's move, beside the local currency's move against the dollar, with each country's year of history.",
+    summary: "The CDS pane on Sovereign: 5Y CDS ranked by the month's move, beside the local currency's move against the dollar, with each country's year of history.",
     usage: ["SOVR"],
-    keys: [OPEN],
+    keys: [TABS, OPEN],
     data: same("Delayed, as trades are disseminated"),
     bloomberg: ["SOVR", "WCDS"],
   },
@@ -1127,6 +1164,14 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     data: null,
     bloomberg: [],
   },
+  MCP: {
+    summary: "Connects Claude Code, Codex, Cursor or any MCP client to Gloom's research tools: the command to copy, or a key to create.",
+    usage: ["MCP"],
+    keys: [key("c", "opy"), key("←/→", " client"), key("k", "ey")],
+    data: null,
+    bloomberg: [],
+    docs: "https://gloom.sh/docs/mcp",
+  },
   BR: {
     summary: "Broker profiles, account sync and connection status. Every broker is a plugin you install first.",
     usage: ["BR"],
@@ -1179,9 +1224,9 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: [],
   },
   PL: {
-    summary: "The plugin directory: install from GitHub, and enable or disable the plugins you have.",
+    summary: "What Gloomberb is made of: switch built-ins on and off, one by one or with a starter pack, and install plugins from GitHub.",
     usage: ["PL"],
-    keys: [key("i", "nstall"), key("e", "nable"), key("s", "etup"), SEARCH],
+    keys: [key("e", "nable"), key("a", " packs"), key("i", "nstall"), SEARCH],
     data: null,
     bloomberg: [],
   },

package/src/cli/pane-functions/headless.ts

@@ -18,7 +18,7 @@ import type {
   HeadlessSeriesResult,
   HeadlessSnapshotResult,
 } from "../../types/plugin";
-import { cliStyles, renderSection, renderStats, renderTable } from "../../utils/cli-output";
+import { cliStyles, renderSection, renderStats, renderTable, wrapToTerminal } from "../../utils/cli-output";
 import { humanizeCliKey } from "../result";
 import {
   exportEntriesTable,
@@ -382,6 +382,7 @@ function renderRows(
       header: humanizeCliKey(column.header),
       align: column.align,
       width: column.width,
+      shrink: column.shrink,
     })),
     rows.map((row) => columns.map((column) => {
       const value = row[column.key];
@@ -559,8 +560,8 @@ function reportTitle(
 /** One message stays on the label's line; several each get a line of their own, so none runs into the next. */
 function renderMessages(label: string, messages: readonly string[]): string[] {
   return messages.length === 1
-    ? [cliStyles.warning(`${label}: ${messages[0]}`)]
-    : [cliStyles.warning(`${label}:`), ...messages.map((message) => `  ${message}`)];
+    ? [cliStyles.warning(wrapToTerminal(`${label}: ${messages[0]}`))]
+    : [cliStyles.warning(`${label}:`), ...messages.map((message) => wrapToTerminal(`  ${message}`))];
 }
 
 /**
@@ -603,7 +604,7 @@ export function renderHeadlessPaneText(
   }
   if (result.notes?.length) lines.push("", ...renderMessages("Notes", result.notes));
   if (result.errors?.length) lines.push("", ...renderMessages("Errors", result.errors));
-  return [lines.join("\n").trimEnd(), "", cliStyles.muted(formatFreshnessLine(freshness))].join("\n");
+  return [lines.join("\n").trimEnd(), "", cliStyles.muted(wrapToTerminal(formatFreshnessLine(freshness)))].join("\n");
 }
 
 function resultRowCount(definition: HeadlessPaneDefinition, result: HeadlessPaneResult): number {

package/src/cli/pane-functions/index.ts

@@ -118,6 +118,7 @@ export async function runPaneScreenshot(args: string[], ctx: CliCommandContext)
         theme: parsed.theme,
         scale: parsed.scale,
         watermark: parsed.watermark,
+        statusLine: parsed.status !== false,
         options: parsed.options,
       });
       if (parsed.requireBotSafe && !result.usable) {
@@ -137,7 +138,9 @@ export async function runPaneScreenshot(args: string[], ctx: CliCommandContext)
             ["Rows", String(data.rowCount)],
             ["Status", issues.length > 0 ? cliStyles.warning(issues.join(", ")) : cliStyles.success("complete")],
           ];
+          if (data.render.statusLine) stats.push(["Status line", data.render.statusLine]);
           if (data.unusableReason) stats.push(["Reason", data.unusableReason]);
+          if (data.notices?.length) stats.push(["Notes", data.notices.join(" ")]);
           if (data.unavailableSymbols.length > 0) stats.push(["No data for", data.unavailableSymbols.join(", ")]);
           if (data.render.emptyStateMarkers.length > 0) stats.push(["Empty states", data.render.emptyStateMarkers.join(", ")]);
           if (data.render.missingExpectedText.length > 0) stats.push(["Missing text", data.render.missingExpectedText.join(", ")]);

package/src/cli/pane-functions/market-session.ts

@@ -0,0 +1,133 @@
+import { canonicalExchange, isUsListingExchange } from "../../utils/exchanges";
+import {
+  activeUsMarketSession,
+  isAlwaysOpenExchange,
+  isRegularSessionTime,
+  latestRegularSessionClose,
+  latestRegularSessionOpen,
+  nextRegularSessionOpen,
+} from "../../market-data/market/freshness";
+import { currentFxClosureStart } from "../../utils/fx-market-hours";
+import { zonedDateKey } from "../../utils/zoned-date-time";
+import type { ReportTime } from "../../utils/utc-time";
+
+/** Where the venues behind a quote report stand, as a report says it after the delay. */
+type ReportMarketState = "open" | "pre-market" | "after-hours" | "closed";
+
+export interface ReportMarket {
+  state: ReportMarketState;
+  /** While no venue is in its regular session: the next regular open of the first to open, when its calendar is known. */
+  reopensAt?: string;
+  /** That open's date at its venue, so a Monday open in Sydney reads Monday. */
+  reopensOn?: string;
+}
+
+/** One dated row of a quote report: the venue it trades on and the session its source reports. */
+export interface SessionObservation {
+  exchange: string;
+  marketState?: string;
+  time: ReportTime | null;
+}
+
+interface VenueSession {
+  state: ReportMarketState | "always";
+  next?: { date: string; open: number };
+  /** The latest regular session that has closed: its local date and open. */
+  last?: { date: string; open: number | null };
+  timeZone?: string;
+}
+
+const CLOSED_STATES = new Set(["CLOSED", "PREPRE", "POSTPOST"]);
+
+/**
+ * A venue's session now, from its calendar (weekends and published holidays),
+ * or from the state its source reports when the app has no calendar for it,
+ * such as an index publisher or a futures exchange. Null when neither says.
+ */
+function venueSession(exchange: string, marketState: string | undefined, now: number): VenueSession | null {
+  if (isAlwaysOpenExchange(exchange)) return { state: "always" };
+  const next = nextRegularSessionOpen(exchange, now);
+  if (next) {
+    const { timeZone } = next;
+    const latestClose = latestRegularSessionClose(exchange, now);
+    const last = latestClose ? { date: latestClose.date, open: latestRegularSessionOpen(exchange, latestClose.close) } : undefined;
+    if (isRegularSessionTime(exchange, now)) return { state: "open", timeZone };
+    if (isUsListingExchange(exchange)) {
+      const today = zonedDateKey(now, timeZone);
+      const session = activeUsMarketSession(now);
+      if (session === "PRE" && next.date === today) return { state: "pre-market", next, last, timeZone };
+      if (session === "POST" && last?.date === today) return { state: "after-hours", next, last, timeZone };
+    }
+    return { state: "closed", next, last, timeZone };
+  }
+  if (marketState === "REGULAR") return { state: "open" };
+  if (marketState === "PRE") return { state: "pre-market" };
+  if (marketState === "POST") return { state: "after-hours" };
+  if (marketState && CLOSED_STATES.has(marketState)) return { state: "closed" };
+  return null;
+}
+
+/** The venue spot FX pairs trade on. It has no session calendar here; its week is in `fx-market-hours`. */
+const FX_VENUE = "CCY";
+const DAY_MS = 24 * 60 * 60_000;
+
+/**
+ * The newest observation is its venue's latest close: the venue has not
+ * opened since, and the print is from that session's day, after its open (an
+ * after-hours print of that day counts). Returns that session's local date.
+ */
+function closeDateOf(observation: SessionObservation, session: VenueSession, now: number): string | null {
+  const time = observation.time;
+  if (!time || time.dateOnly) return null;
+  // FX closes once a week, Friday 17:00 New York time, and its trading day turns
+  // at 17:00: a print from that last day, or a quiet tick over the weekend, is
+  // that Friday's close, not the day it happens to be stamped with.
+  const weekClose = canonicalExchange(observation.exchange) === FX_VENUE ? currentFxClosureStart(now) : null;
+  if (weekClose != null) return time.time >= weekClose - DAY_MS ? zonedDateKey(weekClose - 1, "America/New_York") : null;
+  if (session.last && session.timeZone) {
+    if (session.last.open != null && time.time < session.last.open) return null;
+    return zonedDateKey(time.time, session.timeZone) === session.last.date ? session.last.date : null;
+  }
+  // No calendar: the source says the session is over, and the print is dated in UTC.
+  return session.state === "closed" && !session.last ? new Date(time.time).toISOString().slice(0, 10) : null;
+}
+
+/**
+ * Where the markets behind a quote report stand now, and whether the newest
+ * observation is a close. Null market when the venues disagree (Tokyo open,
+ * New York closed), trade around the clock, or none can be placed; a report
+ * then says nothing rather than guess.
+ */
+export function reportMarketSession(
+  observations: readonly SessionObservation[],
+  now: number,
+): { market: ReportMarket | null; closeDate: string | null } {
+  const sessions = new Map<string, VenueSession>();
+  let newest: { observation: SessionObservation; session: VenueSession } | null = null;
+  for (const observation of observations) {
+    const exchange = canonicalExchange(observation.exchange);
+    if (!exchange) continue;
+    const key = `${exchange}:${observation.marketState ?? ""}`;
+    const session = sessions.get(key) ?? venueSession(exchange, observation.marketState, now);
+    if (!session) continue;
+    sessions.set(key, session);
+    if (observation.time && (!newest || observation.time.time > (newest.observation.time?.time ?? -Infinity))) {
+      newest = { observation, session };
+    }
+  }
+  const states = new Set([...sessions.values()].map((session) => session.state));
+  if (states.size !== 1 || states.has("always")) return { market: null, closeDate: null };
+  const state = [...states][0] as ReportMarketState;
+  const reopen = state === "closed" || state === "pre-market"
+    ? [...sessions.values()].reduce<{ date: string; open: number } | null>((first, session) => (
+      session.next && (!first || session.next.open < first.open) ? session.next : first
+    ), null)
+    : null;
+  return {
+    market: {
+      state,
+      ...(reopen ? { reopensAt: new Date(reopen.open).toISOString(), reopensOn: reopen.date } : {}),
+    },
+    closeDate: (state === "closed" || state === "pre-market") && newest ? closeDateOf(newest.observation, newest.session, now) : null,
+  };
+}

package/src/cli/pane-functions/options.ts

@@ -32,6 +32,8 @@ export interface ParsedPaneFunctionArgs {
   scale: number;
   /** Small label drawn in the pane title bar, e.g. a domain; null draws nothing. */
   watermark: string | null;
+  /** A screenshot carries its dated status line in the pane footer; `--no-status` sets this false. */
+  status?: boolean;
   requireBotSafe: boolean;
   /** The listing a one-ticker function's argument named, once `applyListingArgument` has resolved it. */
   listing?: ListingArg;
@@ -67,7 +69,7 @@ export function parseArgumentsOption(value: string): Record<string, string> {
   return pairs;
 }
 
-export function parsePaneFunctionArgs(args: string[], globalOptions: { limit?: number } = {}): ParsedPaneFunctionArgs {
+export function parsePaneFunctionArgs(args: string[], globalOptions: { limit?: number; tail?: number } = {}): ParsedPaneFunctionArgs {
   const positionals: string[] = [];
   const options: Record<string, string | true> = {};
   let outputPath: string | null = null;
@@ -76,6 +78,7 @@ export function parsePaneFunctionArgs(args: string[], globalOptions: { limit?: n
   let theme: string | null = null;
   let scale = 1;
   let watermark: string | null = null;
+  let status = true;
   let requireBotSafe = false;
 
   for (let index = 0; index < args.length; index += 1) {
@@ -94,6 +97,11 @@ export function parsePaneFunctionArgs(args: string[], globalOptions: { limit?: n
     const equalsIndex = raw.indexOf("=");
     const key = equalsIndex >= 0 ? raw.slice(0, equalsIndex) : raw;
     const inlineValue = equalsIndex >= 0 ? raw.slice(equalsIndex + 1) : undefined;
+    // A switch: the token after it is the function's argument, never its value.
+    if (normalizeOptionKey(key) === "noStatus" && inlineValue === undefined) {
+      status = false;
+      continue;
+    }
     const next = args[index + 1];
     const nextValue = inlineValue === undefined && next && !next.startsWith("--") ? args[++index] : true;
     const value: string | true = inlineValue ?? nextValue ?? true;
@@ -118,6 +126,7 @@ export function parsePaneFunctionArgs(args: string[], globalOptions: { limit?: n
       scale = parseScale(value);
     } else if (normalizedKey === "watermark" && value !== true) {
       watermark = value.trim() || null;
+
     } else if (normalizedKey === "arguments" && value !== true) {
       Object.assign(options, parseArgumentsOption(value));
     } else {
@@ -127,10 +136,12 @@ export function parsePaneFunctionArgs(args: string[], globalOptions: { limit?: n
 
   const target = positionals[0]?.trim() ?? "";
   const arg = positionals.slice(1).join(" ").trim();
-  // The outer CLI parser consumes --limit before fn/shot sees its arguments.
-  // Restore it for the pane's own schema and loader, including bounds checks.
+  // The outer CLI parser consumes --limit and --tail before fn/shot sees its arguments.
+  // Restore them for the pane's own schema and loader, including bounds checks,
+  // so a function without a tail option says so instead of ignoring it.
   if (globalOptions.limit != null) options.limit = String(globalOptions.limit);
-  return { target, arg, options, outputPath, width, height, theme, scale, watermark, requireBotSafe };
+  if (globalOptions.tail != null) options.tail = String(globalOptions.tail);
+  return { target, arg, options, outputPath, width, height, theme, scale, watermark, status, requireBotSafe };
 }
 
 export function parsePaneCatalogArgs(args: string[]): ParsedPaneCatalogArgs {