gloomberb 0.17.4 → 0.17.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.17.4",
+  "version": "0.17.5",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",

package/patches/electrobun@1.18.1.patch

@@ -53,6 +53,86 @@ index c26c2c977ee1fc25a8dc144b85bac8626a45f572..8920a2905380228c23cba66c20d9bfd1
  			frame: {
  				width: this.frame.width,
  				height: this.frame.height,
+diff --git a/dist/api/bun/core/Updater.ts b/dist/api/bun/core/Updater.ts
+index 39daf6d341780af8e30c2c50327162863f5977ec..bf4a4b615f84904759d4bcd57be0d899c9464a5f 100644
+--- a/dist/api/bun/core/Updater.ts
++++ b/dist/api/bun/core/Updater.ts
+@@ -132,6 +132,19 @@ let updateInfo: {
+ 	error: string;
+ };
+ 
++// Where updates are fetched from when it is not the channel and baseUrl that
++// version.json names. Only the download URLs read it: the app data folder and
++// the "dev" check keep the installed build's own channel.
++let updateSource: { channel: string; baseUrl: string } | null = null;
++
++function updateSourceChannel(): string {
++	return updateSource?.channel ?? localInfo.channel;
++}
++
++function updateSourceBaseUrl(): string {
++	return updateSource?.baseUrl ?? localInfo.baseUrl;
++}
++
+ function cleanupExtractionFolder(
+ 	extractionFolder: string,
+ 	keepTarHash: string,
+@@ -176,6 +189,12 @@ const Updater = {
+ 		onStatusChangeCallback = callback;
+ 	},
+ 
++	// Checks and downloads from `source` (a channel prefix and the URL its
++	// files sit under) until it is set again; null goes back to version.json.
++	setUpdateSource: (source: { channel: string; baseUrl: string } | null) => {
++		updateSource = source;
++	},
++
+ 	// todo: allow switching channels, by default will check the current channel
+ 	checkForUpdate: async () => {
+ 		emitStatus("checking", "Checking for updates...");
+@@ -196,11 +215,11 @@ const Updater = {
+ 
+ 		const cacheBuster = Math.random().toString(36).substring(7);
+ 		const platformPrefix = getPlatformPrefix(
+-			localInfo.channel,
++			updateSourceChannel(),
+ 			currentOS,
+ 			currentArch,
+ 		);
+-		const updateInfoUrl = `${localInfo.baseUrl.replace(/\/+$/, "")}/${platformPrefix}-update.json?${cacheBuster}`;
++		const updateInfoUrl = `${updateSourceBaseUrl().replace(/\/+$/, "")}/${platformPrefix}-update.json?${cacheBuster}`;
+ 
+ 		try {
+ 			const updateInfoResponse = await fetch(updateInfoUrl);
+@@ -329,11 +348,11 @@ const Updater = {
+ 
+ 				// check if there's a patch file for it
+ 				const platformPrefix = getPlatformPrefix(
+-					localInfo.channel,
++					updateSourceChannel(),
+ 					currentOS,
+ 					currentArch,
+ 				);
+-				const patchUrl = `${localInfo.baseUrl.replace(/\/+$/, "")}/${platformPrefix}-${currentHash}.patch`;
++				const patchUrl = `${updateSourceBaseUrl().replace(/\/+$/, "")}/${platformPrefix}-${currentHash}.patch`;
+ 				emitStatus(
+ 					"fetching-patch",
+ 					`Checking for patch: ${currentHash.slice(0, 8)}`,
+@@ -612,12 +631,12 @@ const Updater = {
+ 
+ 				const cacheBuster = Math.random().toString(36).substring(7);
+ 				const platformPrefix = getPlatformPrefix(
+-					localInfo.channel,
++					updateSourceChannel(),
+ 					currentOS,
+ 					currentArch,
+ 				);
+ 				const tarballName = getTarballFileName(appFileName, currentOS);
+-				const urlToLatestTarball = `${localInfo.baseUrl.replace(/\/+$/, "")}/${platformPrefix}-${tarballName}`;
++				const urlToLatestTarball = `${updateSourceBaseUrl().replace(/\/+$/, "")}/${platformPrefix}-${tarballName}`;
+ 				const prevVersionCompressedTarballPath = join(
+ 					appDataFolder,
+ 					"self-extraction",
 diff --git a/dist/api/bun/proc/native.ts b/dist/api/bun/proc/native.ts
 index f0f6c2532ba2eb467ec1d452a25c835b6db72661..ae77cf58d32392ad4cc8e2103ac7ed27baae8bea 100644
 --- a/dist/api/bun/proc/native.ts

package/src/api-client/data.ts

@@ -953,8 +953,11 @@ export class CloudDataApi {
   async getCloudSec13F(
     path: string,
     params: Record<string, string | number | undefined> = {},
+    options?: { signal?: AbortSignal },
   ): Promise<unknown> {
-    return this.request<unknown>(cloudSec13FPath(path, params));
+    return this.request<unknown>(cloudSec13FPath(path, params), {
+      signal: options?.signal,
+    });
   }
 
   /**

package/src/api-client/research-activity.ts

@@ -28,7 +28,10 @@ export type ResearchActivity =
   | "onboarding_signed_in"
   | "onboarding_pro_viewed"
   | "onboarding_completed"
-  | "onboarding_skipped";
+  | "onboarding_skipped"
+  // The first action of a web visitor counted in the first-screen experiment,
+  // in that first session. Keep in sync with the server's list.
+  | "first_screen_engaged";
 export type ResearchFeature =
   | "overview"
   | "chart"
@@ -451,7 +454,10 @@ function webExperimentAttribution(): { experiments?: string } {
  * visitors on term.gloom.sh with an analytics id (no Do Not Track or Global
  * Privacy Control) and not driven by automation are asked. See web-experiments.ts.
  */
-export function exposeWebExperiment(experiment: string): Promise<string | null> {
+export function exposeWebExperiment(
+  experiment: string,
+  { placement, signal }: { placement?: string; signal?: AbortSignal } = {},
+): Promise<string | null> {
   if (!researchTelemetryAllowed()) return Promise.resolve(null);
   if (getCurrentPluginTarget() !== "web") return Promise.resolve(null);
   try {
@@ -468,7 +474,8 @@ export function exposeWebExperiment(experiment: string): Promise<string | null>
         attribution: attributionPayload(),
         experiment: key,
         variant,
-      }),
+        ...(placement && ACTIVITY_ID.test(placement) ? { placement } : {}),
+      }, signal),
     });
   } catch {
     return Promise.resolve(null);

package/src/app/pane-runtime/ticker-open-runtime.ts

@@ -21,6 +21,7 @@ import type { DataProvider } from "../../types/data-provider";
 import type { PinTickerOptions } from "../../types/plugin";
 import {
   resolveTickerOpenTarget,
+  tickerOpenFailureMessage,
   type TickerOpenTarget,
 } from "../../tickers/open-target";
 import { AmbiguousTickerError, findExactTickerSearchMatch } from "../../tickers/search";
@@ -73,7 +74,7 @@ export function useAppTickerOpenRuntime({
         tickerRepository,
       });
       if (!target && canPresentFeedback()) {
-        pluginRegistry.notify({ body: `Could not open ${rawSymbol}.`, type: "error" });
+        pluginRegistry.notify({ body: tickerOpenFailureMessage(rawSymbol), type: "error" });
       }
       return target;
     } catch (err) {

package/src/app/runtime/update.ts

@@ -7,13 +7,17 @@ import {
   canRestartToApply,
   canSelfUpdate,
   checkForUpdateDetailed,
+  discardStagedUpdate,
   performUpdate,
   type ReleaseInfo,
   type UpdateCheckResult,
   type UpdateProgress,
 } from "../../updater";
+import { resolveUpdateChannel, stagedUpdateFitsChannel } from "../../updater/channel";
+import type { UpdateChannel } from "../../types/config";
 import { VERSION } from "../../version";
 import { debugLog } from "../../utils/debug-log";
+import { isPrereleaseVersion } from "../../utils/semver";
 import { reportCrash } from "../../telemetry/crash-reports";
 import { runAutomated } from "../../telemetry/usage-counts";
 
@@ -41,6 +45,7 @@ export function useAppUpdateRuntime({
   pluginRegistry,
   stateRef,
   updateAvailable,
+  updateChannel = "stable",
   updateCheckInProgress,
   updateProgress,
 }: {
@@ -50,6 +55,8 @@ export function useAppUpdateRuntime({
   pluginRegistry: PluginRegistry;
   stateRef: { current: AppState };
   updateAvailable: ReleaseInfo | null;
+  /** The channel in effect (`resolveUpdateChannel`); a change checks again at once. */
+  updateChannel?: UpdateChannel;
   updateCheckInProgress: boolean;
   updateProgress: unknown;
 }): {
@@ -97,7 +104,8 @@ export function useAppUpdateRuntime({
     // failed check like any other: the hourly one must not end as an
     // unhandled rejection, and a manual one must clear its progress state.
     // The timeout is still reported, as it was when it went unhandled.
-    const result = await checkForUpdateDetailed(VERSION).catch((error: unknown): UpdateCheckResult => {
+    const channel = resolveUpdateChannel(stateRef.current.config);
+    const result = await checkForUpdateDetailed(VERSION, channel).catch((error: unknown): UpdateCheckResult => {
       const message = error instanceof Error ? error.message : "";
       if (message.startsWith("RPC request timed out")) {
         reportCrash(error, { kind: "unhandled-rejection" });
@@ -123,7 +131,7 @@ export function useAppUpdateRuntime({
 
     if (result.kind === "current") {
       dispatch({ type: "SET_UPDATE_AVAILABLE", release: null });
-      dispatch({ type: "SET_UPDATE_NOTICE", notice: `Already on v${VERSION}` });
+      dispatch({ type: "SET_UPDATE_NOTICE", notice: result.notice ?? `Already on v${VERSION}` });
       return;
     }
 
@@ -147,6 +155,44 @@ export function useAppUpdateRuntime({
     return () => { clearInterval(interval); };
   }, [enabled, isDetachedWindow, runUpdateCheck]);
 
+  // A channel switch checks again at once and says what it found: nightly
+  // starts on today's build, stable says when this nightly build stays. An
+  // update already downloading or waiting for a restart is left to the effect
+  // below, which takes it back once it is ready if the channel rules it out.
+  const checkedChannelRef = useRef(updateChannel);
+  useEffect(() => {
+    if (!enabled || isDetachedWindow || checkedChannelRef.current === updateChannel) return;
+    checkedChannelRef.current = updateChannel;
+    if (updateInFlight(stateRef.current.updateProgress)) return;
+    // What the other channel offered, or how its download failed, is not this one's answer.
+    if (stateRef.current.updateProgress) dispatch({ type: "SET_UPDATE_PROGRESS", progress: null });
+    dispatch({ type: "SET_UPDATE_AVAILABLE", release: null });
+    void runUpdateCheck(true);
+  }, [dispatch, enabled, isDetachedWindow, runUpdateCheck, stateRef, updateChannel]);
+
+  // A downloaded update the channel does not allow (a nightly build waiting
+  // for a restart after the switch back to stable, or one that finished
+  // downloading after it) is taken back rather than installed by the restart,
+  // and stable checks again.
+  const discardingRef = useRef(false);
+  useEffect(() => {
+    if (!enabled || isDetachedWindow || discardingRef.current) return;
+    const { updateProgress: progress, updateAvailable: staged } = stateRef.current;
+    if (progress?.phase !== "ready" || stagedUpdateFitsChannel(staged, updateChannel)) return;
+    discardingRef.current = true;
+    void discardStagedUpdate().then((error) => {
+      discardingRef.current = false;
+      if (error) {
+        updateLog.warn("could not take back the staged update", { error, version: staged?.version });
+        dispatch({ type: "SET_UPDATE_NOTICE", notice: `Could not take back v${staged?.version ?? "?"}: ${error}` });
+        return;
+      }
+      dispatch({ type: "SET_UPDATE_PROGRESS", progress: null });
+      dispatch({ type: "SET_UPDATE_AVAILABLE", release: null });
+      void runUpdateCheck(true);
+    });
+  }, [dispatch, enabled, isDetachedWindow, runUpdateCheck, stateRef, updateAvailable, updateChannel, updateProgress]);
+
   // First launch on a new version: show that release's notes, then remember the version.
   useEffect(() => {
     if (!enabled || isDetachedWindow) return;
@@ -156,7 +202,8 @@ export function useAppUpdateRuntime({
     const nextConfig = { ...config, lastLaunchedVersion: VERSION };
     dispatch({ type: "SET_CONFIG", config: nextConfig });
     void saveConfigImmediately(nextConfig).catch(() => {});
-    if (!isUpgrade) return;
+    // Nightly builds come daily and the changelog lists stable releases only.
+    if (!isUpgrade || isPrereleaseVersion(VERSION)) return;
     // Opened by the app, not the user: usage counts leave it out.
     void runAutomated(() => pluginRegistry.createPaneFromTemplateAsync("changelog-pane", {
       values: { version: VERSION },

package/src/app.tsx

@@ -50,6 +50,7 @@ import { bindPluginRegistryRuntimeAccess } from "./app/runtime/plugin-bindings";
 import { useAppStartupRuntime } from "./app/runtime/startup";
 import { useTickerRefreshRuntime } from "./app/runtime/ticker-refresh";
 import { useAppUpdateRuntime } from "./app/runtime/update";
+import { resolveUpdateChannel } from "./updater/channel";
 import { createCoreSyncContributors } from "./sync/core-contributors";
 import { useCloudSyncRuntime } from "./sync/react";
 import { RemoteControlHost, type RemoteControlAdapter } from "./remote/app-host";
@@ -278,6 +279,7 @@ function AppInner({
     pluginRegistry,
     stateRef,
     updateAvailable: state.updateAvailable,
+    updateChannel: resolveUpdateChannel(state.config),
     updateCheckInProgress: state.updateCheckInProgress,
     updateProgress: state.updateProgress,
   });

package/src/ask-gloom/pane-context.ts

@@ -41,7 +41,7 @@ function scalarArgs(source: ArgSource, privateFields: PaneSharePrivateFields | u
  * that opens this pane (a chart opened with `GP` stays `GP`), else the first
  * template that opens it.
  */
-function functionCode(registry: Pick<PluginRegistry, "paneTemplates">, paneType: string, title: string): string | null {
+export function functionCode(registry: Pick<PluginRegistry, "paneTemplates">, paneType: string, title: string): string | null {
   const prefixes = [...registry.paneTemplates.values()]
     .filter((template) => template.paneId === paneType && template.shortcut?.prefix)
     .map((template) => template.shortcut!.prefix.toUpperCase());
@@ -50,6 +50,16 @@ function functionCode(registry: Pick<PluginRegistry, "paneTemplates">, paneType:
   return prefixes[0] ?? null;
 }
 
+/**
+ * A pane named by its function and what it shows, such as `DES AAPL`: its
+ * title, led by its function code unless the title already starts with it.
+ */
+export function paneFunctionLabel(pane: { title: string; code: string | null; paneType: string }): string {
+  const title = pane.title.trim() || pane.paneType;
+  if (!pane.code) return title;
+  return title.split(/\s+/)[0]?.toUpperCase() === pane.code ? title : `${pane.code} ${title}`;
+}
+
 export interface PaneAttachmentSource {
   registry: Pick<PluginRegistry, "paneTemplates" | "brokers" | "getPanePluginId" | "getBrokerPluginId">;
   pane: Pick<ResolvedPane, "instance" | "def">;

package/src/cli/commands/overview.ts

@@ -428,7 +428,7 @@ async function runFred(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
     }),
   }, {
     dateKey: "date",
-    empty: fredEmptyMessage(startDate, latest),
+    empty: fredEmptyMessage(startDate, latest == null ? null : exportRow(latest)),
     ...(notes.length ? { footnote: notes.join("\n"), exportNotes: notes } : {}),
     exportIdentity: { symbolOrSeries: seriesId, currencyOrUnit: unit, interval },
     textColumns: [
@@ -486,7 +486,7 @@ async function runYieldCurve(rawArgs: string[], ctx: Parameters<CliCommandDef["e
         key: "changeBasisPoints",
         header: "1D bp",
         align: "right",
-        format: (value) => typeof value === "number" ? formatBasisPoints(value / 100) : "-",
+        format: (value) => typeof value === "number" ? formatBasisPoints(value / 100, 1) : "-",
       },
       { key: "date", header: "Date" },
       { key: "seriesId", header: "Series" },

package/src/cli/commands/system.ts

@@ -4,6 +4,7 @@ import { saveConfig } from "../../data/config/store";
 import { builtinPluginGroupMembers } from "../../plugins/ownership";
 import type { AppConfig, TelemetryConfig } from "../../types/config";
 import { canonicalTimeZone } from "../../utils/utc-time";
+import { NIGHTLY_CHANNEL_SUMMARY, parseUpdateChannel, withUpdateChannel } from "../../updater/channel";
 import type { CliCommandDef } from "../../types/plugin";
 import { resolveCliDataDir, withCliServices, withConfigData } from "../context";
 import { CLI_COMMAND_GROUPS } from "../help";
@@ -33,6 +34,8 @@ const STAR_PROMPT_CONFIG_KEY = "starPrompt.enabled";
 const TIMEZONE_CONFIG_KEY = "timezone";
 /** What `config set timezone` takes to go back to UTC alone. */
 const NO_TIMEZONE = "none";
+/** Stable releases, or nightly builds as well. */
+const UPDATE_CHANNEL_CONFIG_KEY = "updates.channel";
 const EDITABLE_CONFIG_KEYS = [
   "baseCurrency",
   "refreshIntervalMinutes",
@@ -41,6 +44,7 @@ const EDITABLE_CONFIG_KEYS = [
   ...Object.keys(TELEMETRY_CONFIG_KEYS),
   STAR_PROMPT_CONFIG_KEY,
   TIMEZONE_CONFIG_KEY,
+  UPDATE_CHANNEL_CONFIG_KEY,
 ];
 
 function isTelemetryConfigKey(key: string): key is TelemetryConfigKey {
@@ -219,6 +223,7 @@ export function createSystemCliCommands(): CliCommandDef[] {
         "config set telemetry.usage false",
         "config set starPrompt.enabled false",
         "config set timezone <Region/City>|none",
+        "config set updates.channel stable|nightly",
         "config get keybindings",
         "config set keybindings.actions.<action> <keys>|null|default",
         "config set keybindings.commands.<keys> <command>|null",
@@ -236,6 +241,11 @@ export function createSystemCliCommands(): CliCommandDef[] {
         lines: [
           `theme takes one of these ids, or its name as config themes lists it: ${getThemeIds().join(", ")}.`,
         ],
+      }, {
+        title: "Release channel",
+        lines: [
+          `The app updates itself from stable releases. With updates.channel nightly (Release Channel in the command bar) it also installs the nightly build: ${NIGHTLY_CHANNEL_SUMMARY}. Back on stable, a nightly build stays until a newer stable release is out. GLOOMBERB_UPDATE_CHANNEL overrides the setting for one run; npm and Bun installs always follow stable.`,
+        ],
       }],
       examples: [
         "config",
@@ -287,6 +297,7 @@ export function createSystemCliCommands(): CliCommandDef[] {
           "telemetry.attention": context.config.telemetry?.attention === true,
           [STAR_PROMPT_CONFIG_KEY]: context.config.starPrompt?.enabled !== false,
           [TIMEZONE_CONFIG_KEY]: context.config.timezone ?? null,
+          [UPDATE_CHANNEL_CONFIG_KEY]: context.config.updates?.channel ?? "stable",
         };
 
         if (action === "list") {
@@ -347,11 +358,16 @@ export function createSystemCliCommands(): CliCommandDef[] {
           if ((isTelemetryConfigKey(key) || key === STAR_PROMPT_CONFIG_KEY) && value !== "true" && value !== "false") {
             ctx.fail(`Usage: gloomberb config set ${key} true|false`);
           }
+          if (key === UPDATE_CHANNEL_CONFIG_KEY && !parseUpdateChannel(value)) {
+            ctx.fail(`Usage: gloomberb config set ${key} stable|nightly`);
+          }
           // A display name may come unquoted: config set theme White Phosphor.
           const parsedValue = key === "theme"
             ? requireThemeId(args.slice(2).join(" "))
             : key === TIMEZONE_CONFIG_KEY
               ? parseTimezoneSetting(value)
+              : key === UPDATE_CHANNEL_CONFIG_KEY
+              ? parseUpdateChannel(value)
               : key === "refreshIntervalMinutes"
               ? Number(value)
               : isBooleanConfigKey(key)
@@ -363,7 +379,9 @@ export function createSystemCliCommands(): CliCommandDef[] {
               ? { ...context.config, starPrompt: { ...context.config.starPrompt, enabled: parsedValue as boolean } }
               : key === TIMEZONE_CONFIG_KEY
                 ? withTimezone(context.config, parsedValue as string | null)
-                : { ...context.config, [key]: parsedValue };
+                : key === UPDATE_CHANNEL_CONFIG_KEY
+                  ? withUpdateChannel(context.config, parsedValue as "stable" | "nightly")
+                  : { ...context.config, [key]: parsedValue };
           if (!ctx.cliOptions.dryRun) await saveConfig(nextConfig);
           ctx.printResult({
             data: {

package/src/cli/glossary.ts

@@ -2,7 +2,7 @@ import { cliStyles, cliTerminalWidth, renderDefinitions, renderSection, wrapText
 
 /**
  * Plain-words meanings of the rates, auction, energy, perpetual-futures, portfolio,
- * fund, short interest, quote-board, futures and economic-calendar terms the functions
+ * fund, short interest, quote-board, futures (basis, contango, roll yield) and economic-calendar terms the functions
  * show in their rows, headers and footers.
  * `catalog glossary` lists them, `catalog explain <term>` prints one, and
  * `fn <function> --explain` and `portfolio show --explain` follow a report with
@@ -301,10 +301,11 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
       + "The funding rate keeps its price close to the asset it tracks.",
   },
   {
-    term: "Funding rate", aliases: ["funding", "funding payment", "funding fee", "funding 8h"], functions: ["PERP"],
-    shown: ["Funding %/int", "Funding 8h", "Paid %/int"],
+    term: "Funding rate", aliases: ["funding", "funding payment", "funding fee", "funding 8h", "funding apr", "apr"], functions: ["PERP"],
+    shown: ["Funding %/int", "Funding 8h", "Paid %/int", "APR %"],
     definition: "A regular payment between the two sides of a perpetual contract, set to pull its price toward the asset's. "
-      + "Positive means longs pay shorts, negative means shorts pay longs.",
+      + "Positive means longs pay shorts, negative means shorts pay longs, so a basis trade (long spot, short the perpetual) collects it when positive. "
+      + "APR % is the current 8h rate × 3 × 365: a simple annualisation of the rate now, not funding actually paid.",
   },
   {
     term: "Open interest", short: "OI", aliases: ["open interest usd"], functions: ["PERP"],
@@ -473,6 +474,35 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
     definition: "A futures contract's official price for the day, set by its exchange from trading near the close. "
       + "The day's change and margin are measured from it, and it can differ from the last trade. FUT's PREV is the previous one.",
   },
+  // Futures basis and curve shape (CTM, FUT, PERP).
+  {
+    term: "Futures basis", aliases: ["basis", "basis trade", "cash and carry", "cash-and-carry", "vs spot", "spot spread"],
+    functions: ["CTM", "FUT", "PERP"], shown: ["Vs Spot", "VS SPOT"],
+    definition: "The gap between a futures price and the spot price of what it tracks, in percent: positive when the future costs more, negative when it costs less. "
+      + "It closes by expiry. A basis trade buys spot and sells the future to earn it. A perpetual has no expiry, so its funding rate plays that part.",
+  },
+  {
+    term: "Annualised basis", aliases: ["annualized basis", "ann basis", "ann. basis", "basis annualised"], functions: ["CTM", "PERP"], shown: ["Ann Basis", "ANN BASIS"],
+    definition: "The basis restated as a yearly rate, so contracts of different length compare with each other and with a perpetual's funding APR: "
+      + "(Last / spot - 1) × 365 / days to expiry, simple rather than compounded, on the latest trade against the spot quote. "
+      + "Inside 30 days a few basis points of spot noise move it by whole points: 10 bp is about ±2 points at 18 days to expiry.",
+  },
+  {
+    term: "Contango", aliases: ["contango curve", "upward curve"], functions: ["CTM", "FUT"], shown: ["contango", "Contango"],
+    definition: "A futures curve that slopes up: each contract costs more than the one before it, and the future trades above spot. "
+      + "A long rolling into the next contract pays that difference, a short earns it, and the basis closes as expiry nears.",
+  },
+  {
+    term: "Backwardation", aliases: ["backwardation curve", "downward curve", "inverted futures curve"], functions: ["CTM", "FUT"], shown: ["backwardation", "Backwardation"],
+    definition: "A futures curve that slopes down: later contracts cost less than nearer ones, and the future trades below spot, often when the asset is scarce now. "
+      + "A long rolling into the next contract earns that difference, a short pays it.",
+  },
+  {
+    term: "Roll yield", aliases: ["roll", "roll return", "annualised roll yield", "annualized roll yield", "ann roll yield", "ann. roll yield"], functions: ["CTM", "FUT"],
+    shown: ["Ann. roll yield", "Annualized Roll Yield"],
+    definition: "What a long future earns or loses as it is rolled into the next contract. CTM's annualised roll yield is the front price over the next contract's "
+      + "less 1, scaled to a year: (front / next - 1) × 365 / days between the two. It is positive in backwardation and negative in contango.",
+  },
   // The economic calendar (ECO).
   {
     term: "Actual", aliases: ["actual release", "actual value"], functions: ["ECO"], shown: ["ACTUAL", "Actual"],

package/src/cli/index.ts

@@ -251,6 +251,12 @@ function createCoreCliCommands(
       help: {
         group: CLI_COMMAND_GROUPS.plugins,
         usage: ["update [name]"],
+        sections: [{
+          title: "Updating Gloomberb itself",
+          lines: [
+            "The app updates itself from stable releases. config set updates.channel nightly adds the nightly build of main; see gloomberb help config.",
+          ],
+        }],
         examples: ["update", "update gloom-tv"],
       },
       execute: async (args) => {

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

@@ -756,7 +756,7 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     bloomberg: ["GLCO"],
   },
   CTM: {
-    summary: "A futures root's listed contracts as a curve against a week and a month ago, with roll yield, contango or backwardation, and each contract's price, open interest and volume. Takes a FUT root, VX or a CME crypto root (BTC, ETH, SOL, XRP), which also shows each contract's premium to spot and annualised basis against the USD pair quote.",
+    summary: "A futures root's listed contracts as a curve against a week and a month ago, with roll yield, contango or backwardation, and each contract's price, open interest and volume. Takes a FUT root, VX or a CME crypto root (BTC, ETH, SOL, XRP), which also shows each contract's premium to spot and annualised basis against the USD pair quote: Ann Basis = (Last / spot - 1) × 365 / days to expiry, simple actual/365.",
     usage: ["CTM GC", "CTM BTC"],
     keys: [key("d", "ate"), key("c", "urrent"), STEP],
     data: same("Delayed, usually 10 minutes; VIX at settlement"),

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

@@ -48,7 +48,8 @@ const US_EXCHANGE_TIME_ZONE = "America/New_York";
 /**
  * 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.
+ * such as an index publisher or a futures exchange; an index quote that states
+ * none is placed on the sessions it carries. Null when none of them says.
  */
 function venueSession(exchange: string, marketState: string | undefined, now: number, calendar?: QuoteIndexSession): VenueSession | null {
   if (isAlwaysOpenExchange(exchange)) return { state: "always" };
@@ -68,8 +69,22 @@ function venueSession(exchange: string, marketState: string | undefined, now: nu
   }
   if (marketState === "REGULAR") return { state: "open" };
   const stated = marketState === "PRE" ? "pre-market" : marketState === "POST" ? "after-hours" : marketState && CLOSED_STATES.has(marketState) ? "closed" : null;
-  if (!stated) return null;
-  return calendar ? { state: stated, ...quotedSessions(calendar, now) } : { state: stated };
+  if (!calendar) return stated ? { state: stated } : null;
+  const state = stated ?? quotedState(calendar, now);
+  return state ? { state, ...quotedSessions(calendar, now) } : null;
+}
+
+/**
+ * Where an index quote's own sessions put the market now, for a quote that
+ * states no session. Before the open it is pre-market on the day of the open,
+ * as the venue calendars have it, and closed on any earlier day (a weekend, a holiday).
+ */
+function quotedState({ timeZone, current, regular }: QuoteIndexSession, now: number): ReportMarketState | null {
+  if (now >= current.end) return "closed";
+  if (now >= current.start) return "open";
+  // A regular session still running is not today's: the sessions disagree, so say nothing.
+  if (regular.some((window) => window.end > now)) return null;
+  return zonedDateKey(now, timeZone) === zonedDateKey(current.start, timeZone) ? "pre-market" : "closed";
 }
 
 /**

package/src/components/chart/composite/format.ts

@@ -500,6 +500,13 @@ export function formatCompositeCursorAxisDate(
 
 const MONTH_NAMES = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
 
+/** A dataset observation's day as the axis words it, `Oct 4`, with the year when the chart ends in another. */
+export function formatCompositeDatasetDate(date: Date, endTime: number | undefined): string {
+  const text = `${MONTH_NAMES[date.getUTCMonth()]} ${date.getUTCDate()}`;
+  const endYear = endTime === undefined ? null : new Date(endTime).getUTCFullYear();
+  return endYear === null || endYear === date.getUTCFullYear() ? text : `${text} ${date.getUTCFullYear()}`;
+}
+
 /**
  * When a value carried under the cursor was observed: its time when it is
  * from the cursor's own day, else its date (`Sep 2`, with the year when that

package/src/components/chart/composite/legend.tsx

@@ -5,7 +5,13 @@ import { CANONICAL_EXCHANGE_ALIASES } from "../../../utils/exchanges";
 import { displayWidth, formatPercentRaw, truncateToDisplayWidth } from "../../../utils/format";
 import type { ResolvedSeries } from "../../../time-series/types";
 import { consumeChartMouseEvent, type ChartMouseEvent } from "../core/pointer";
-import { formatCompositeCarriedStamp, formatCompositePointDetails, formatCompositeSeriesValue, seriesPriceReference } from "./format";
+import {
+  formatCompositeCarriedStamp,
+  formatCompositeDatasetDate,
+  formatCompositePointDetails,
+  formatCompositeSeriesValue,
+  seriesPriceReference,
+} from "./format";
 import type { CompositeChartProps, CompositeChartScene } from "./types";
 import { seriesCueCssBackground, type SeriesLineCue } from "./series-cues";
 
@@ -45,15 +51,6 @@ function axisPriceReference(scene: CompositeChartScene | null, series: ResolvedS
   return own;
 }
 
-const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
-
-/** `Oct 4`, the axis's own wording, with the year when the chart ends in another. */
-function legendDateText(date: Date, endTime: number | undefined): string {
-  const text = `${MONTHS[date.getUTCMonth()]} ${date.getUTCDate()}`;
-  const endYear = endTime === undefined ? null : new Date(endTime).getUTCFullYear();
-  return endYear === null || endYear === date.getUTCFullYear() ? text : `${text} ${date.getUTCFullYear()}`;
-}
-
 /**
  * A dataset's values arrive days late, so the legend dates them. Idle, one
  * date leads the legend when it is every value's; otherwise, and under the
@@ -72,7 +69,7 @@ function legendValueDates(
     valued += 1;
     if (entry.observationKind === "dataset" && cursorValue.point) dates.set(entry.id, cursorValue.point.date);
   }
-  const text = new Map([...dates].map(([id, date]) => [id, legendDateText(date, scene?.endTime)] as const));
+  const text = new Map([...dates].map(([id, date]) => [id, formatCompositeDatasetDate(date, scene?.endTime)] as const));
   const cursorDate = scene?.cursorDate;
   if (cursorDate) {
     const cursorDay = cursorDate.toISOString().slice(0, 10);

package/src/components/command-bar/commands/direct/index.ts

@@ -29,6 +29,9 @@ import { parseWindowModeCommandArg } from "../../layout-items";
 import type { CommandBarRoute } from "../../workflow/types";
 import { recordFunctionOpen } from "../../../../telemetry/usage-counts";
 import { reportTelemetryConfig } from "../../../../telemetry/live-config";
+import { NIGHTLY_CHANNEL_SUMMARY, withUpdateChannel } from "../../../../updater/channel";
+import { isPrereleaseVersion } from "../../../../utils/semver";
+import { VERSION } from "../../../../version";
 
 type NotifyFn = (body: string, options?: { type?: "info" | "success" | "error" }) => void;
 
@@ -373,6 +376,50 @@ export function runDirectCommandAction(options: {
       void onCheckForUpdates?.();
       closeAll({ revertThemePreview: false });
       return;
+    case "release-channel": {
+      // The runtime checks again as soon as the channel changes.
+      const setChannel = (channel: "stable" | "nightly") => {
+        const nextConfig = withUpdateChannel(getState().config, channel);
+        dispatch({ type: "SET_CONFIG", config: nextConfig });
+        persistConfig(nextConfig);
+        notify(`${t(command.label)}: ${channel}`, { type: "success" });
+      };
+      // The saved setting flips; GLOOMBERB_UPDATE_CHANNEL still wins for the run it is set on.
+      // Back to stable asks too, to say a nightly build already running stays.
+      if (state.config.updates?.channel === "nightly") {
+        openInlineConfirm({
+          confirmId: "switch-to-stable",
+          title: "Switch to Stable?",
+          body: [
+            isPrereleaseVersion(VERSION)
+              ? "Updates come from stable releases only. This nightly build stays until a newer stable release is out."
+              : "Updates come from stable releases only.",
+          ],
+          confirmLabel: "Switch to Stable",
+          cancelLabel: "Stay on Nightly",
+          tone: "default",
+          onConfirm: async () => { setChannel("stable"); },
+        });
+        return;
+      }
+      openInlineConfirm({
+        confirmId: "switch-to-nightly",
+        title: "Switch to Nightly?",
+        body: [
+          `Nightly is ${NIGHTLY_CHANNEL_SUMMARY}. Stable releases still reach you when they are newer.`,
+          isPrereleaseVersion(VERSION)
+            ? "Switch back to Stable at any time."
+            : "Switch back to Stable at any time: the nightly build stays until a newer stable release is out.",
+        ],
+        confirmLabel: "Switch to Nightly",
+        cancelLabel: "Stay on Stable",
+        tone: "default",
+        // An opt-in to builds that can break: a stray Enter stays on stable.
+        defaultAction: "cancel",
+        onConfirm: async () => { setChannel("nightly"); },
+      });
+      return;
+    }
     case "theme":
       setRootThemeBaseId(getState().config.theme);
       setRootQuery(arg ? `TH ${arg}` : "TH ");