@gloom-sh/terminal 0.19.2 → 0.19.3

package/src/components/layout/pane/footer/model.ts

@@ -30,6 +30,12 @@ export interface PaneFooterSegment {
    * data a source delivers late: build it with {@link delayedFooterSegment}.
    */
   icon?: "warning" | "clock";
+  /**
+   * A few characters the desktop draws after `icon`, in the footer's muted
+   * tone, so the segment reads without hovering: a delay's `15m`. The
+   * terminal's `parts` already carry it (`◷15m`).
+   */
+  iconText?: string;
   /**
    * The segment only dates the pane's data (`as of 2026-10-05`). A `gloomberb
    * shot` whose status line already dates that data leaves it out, so the
@@ -51,6 +57,14 @@ export interface PaneFooterSegment {
    * warning.
    */
   capture?: boolean;
+  /**
+   * The segment only says how long ago the pane's data loaded (`5m ago`,
+   * `fetched just now`), relative to the moment it is read: build it with
+   * {@link ageFooterSegment}. A row too narrow for every segment leaves it out
+   * first, whole, before anything else shortens or is cut, so the source and
+   * the date stay.
+   */
+  age?: boolean;
   /**
    * When the copy the pane shows was saved, on the saved-copy segment
    * ({@link savedCopyFooterSegment}). The footer draws that segment first,
@@ -75,10 +89,11 @@ export interface PaneFooterSegment {
 const DELAYED_FOOTER_GLYPH = "◷";
 
 /**
- * The footer's one form for data a source delivers late: a yellow clock with
- * `detail` in its tooltip on the desktop, and the clock with the delay
- * (`◷15m`) in the terminal, which has no tooltip, so it takes a few cells
- * rather than a phrase. `onPress` makes it a button, such as an upgrade.
+ * The footer's one form for data a source delivers late: a yellow clock and
+ * the delay (`15m`) on the desktop, with `detail` in its tooltip, and the
+ * clock with the delay (`◷15m`) in the terminal, which has no tooltip, so it
+ * takes a few cells rather than a phrase. Without a known delay the desktop
+ * draws the clock alone. `onPress` makes it a button, such as an upgrade.
  */
 export function delayedFooterSegment({
   id,
@@ -101,6 +116,7 @@ export function delayedFooterSegment({
     label: detail,
     title: detail,
     parts: [{ text: `${DELAYED_FOOTER_GLYPH}${delay ?? ""}`, tone: "warning" }],
+    ...(delay ? { iconText: delay } : {}),
     ...(onPress ? { onPress } : {}),
     ...(quoteStatus ? { quoteStatus } : {}),
   };
@@ -127,6 +143,19 @@ export function savedCopyFooterSegment(id: string, savedAt: number, now = Date.n
   };
 }
 
+/**
+ * The footer's one form for how long ago the pane's data loaded: `5m ago`,
+ * or `fetched 5m ago` with a `verb`. A narrow row leaves it out first (`age`).
+ */
+export function ageFooterSegment(ago: string, { id = "updated", verb, tone = "muted" }: {
+  id?: string;
+  /** Said before the age: `fetched`, `checked`, `updated`. */
+  verb?: string;
+  tone?: PaneFooterPart["tone"];
+} = {}): PaneFooterSegment {
+  return { id, age: true, parts: [{ text: verb ? `${verb} ${ago}` : ago, tone }] };
+}
+
 /**
  * The saved-copy segment of a pane showing several answers (a list and the
  * report it opens): the oldest of the copies among `savedAts` (ms), or no
@@ -317,7 +346,8 @@ function trimTrailing(info: PaneFooterSegment[], width: number, keep: number): P
 }
 
 /**
- * The info segments as they fit `width`: segments with `variants` step down
+ * The info segments as they fit `width`: an `age` (`5m ago`) is left out
+ * first, so the source and the date outlast it; then segments with `variants` step down
  * together, one variant at a time, until the row fits or none is left; beside
  * the hints, the trailing status that still does not fit is then cut or left
  * out (trimTrailing). A status after every segment with shorter forms gives
@@ -328,6 +358,10 @@ function trimTrailing(info: PaneFooterSegment[], width: number, keep: number): P
  * so a frame that fits its own status line sees it overflow.
  */
 export function fitPaneFooterInfo(info: PaneFooterSegment[], width: number, { besideHints = true }: { besideHints?: boolean } = {}): PaneFooterSegment[] {
+  // How long ago the data loaded goes first, whole: a cut age (`fetched just`) says nothing.
+  if (infoTextWidth(info) > width && info.some((segment) => segment.age)) {
+    return fitPaneFooterInfo(info.filter((segment) => !segment.age), width, { besideHints });
+  }
   if (!besideHints) return stepDownTogether(info, width);
   const lastWithVariants = info.findLastIndex((segment) => (segment.variants?.length ?? 0) > 0);
   if (lastWithVariants >= 0 && lastWithVariants < info.length - 1 && infoTextWidth(info) > width) {
@@ -539,6 +573,7 @@ export function samePaneFooterRegistration(
         && !!segment.onPress === !!other.onPress
         && segment.disabled === other.disabled
         && segment.savedCopyAt === other.savedCopyAt
+        && segment.age === other.age
         && sameFooterParts(segment.parts, other.parts)
         && (segment.variants?.length ?? 0) === (other.variants?.length ?? 0)
         && (segment.variants ?? []).every((variant, variantIndex) => sameFooterParts(variant, other.variants![variantIndex]!));

package/src/components/market-board/index.tsx

@@ -215,9 +215,10 @@ export interface StatChartDetailProps {
 export function StatChartDetail({ items, width, height, empty, emptySubject, emptyTitle, renderChart }: StatChartDetailProps) {
   return (
     <Box flexDirection="column" width={width} height={height}>
-      <StatGrid items={items} width={width} />
+      {/* A figure wraps only into rows the chart's least leaves, so the detail never spills. */}
+      <StatGrid items={items} width={width} maxLines={height - 3} />
       <PaneStatusBody empty={empty} subject={emptySubject} emptyTitle={emptyTitle}>
-        {renderChart(Math.max(3, height - statGridRows(items, width)))}
+        {renderChart(Math.max(3, height - statGridRows(items, width, undefined, { maxLines: height - 3 })))}
       </PaneStatusBody>
     </Box>
   );

package/src/components/onboarding/desks-step.tsx

@@ -1,14 +1,19 @@
 import { Box, useUiCapabilities } from "../../ui";
 import { t } from "../../i18n";
 import { DESKS, deskFunctions, type DeskKey } from "../../layout/desks";
+import { MAX_DESK_PICKS } from "../../layout/desk-keys";
 import { ToggleList } from "../toggle-list";
 
-/** Ticks or unticks a desk; the ticked ones keep the order they were ticked in. */
-export function toggleDeskChoice(chosen: readonly DeskKey[], key: DeskKey): DeskKey[] {
-  return chosen.includes(key) ? chosen.filter((entry) => entry !== key) : [...chosen, key];
+/**
+ * Ticks or unticks a desk; the ticked ones keep the order they were ticked
+ * in. A fourth tick is ignored: untick one first.
+ */
+export function toggleDeskChoice(chosen: DeskKey[], key: DeskKey): DeskKey[] {
+  if (chosen.includes(key)) return chosen.filter((entry) => entry !== key);
+  return chosen.length < MAX_DESK_PICKS ? [...chosen, key] : chosen;
 }
 
-/** "What do you trade?": one checkbox per desk, with the functions it opens. */
+/** "What do you trade most?": one checkbox per desk, with the functions it opens. */
 export function DesksStep({
   chosen,
   cursor,
@@ -21,6 +26,7 @@ export function DesksStep({
   onToggle: (key: DeskKey) => void;
 }) {
   const desktop = useUiCapabilities().nativePaneChrome === true;
+  const full = chosen.length >= MAX_DESK_PICKS;
   return (
     <Box flexDirection="column" flexShrink={0} paddingX={desktop ? 0 : 2} style={desktop ? { marginTop: 14 } : undefined}>
       <ToggleList
@@ -28,6 +34,8 @@ export function DesksStep({
           id: desk.key,
           label: t(desk.label),
           enabled: chosen.includes(desk.key),
+          // Once three are ticked, the rest wait until one is unticked.
+          disabled: full && !chosen.includes(desk.key),
           detail: deskFunctions(desk).join(" "),
         }))}
         selectedIdx={cursor}

package/src/components/onboarding/first-run-workspace.ts

@@ -8,6 +8,8 @@ import {
   type SavedLayout,
 } from "../../types/config";
 import type { TickerMetadata, TickerRecord } from "../../types/ticker";
+import { MAX_DESK_PICKS, type DeskKey } from "../../layout/desk-keys";
+import { DESKS, isDeskKey } from "../../layout/desks";
 
 /**
  * The watchlist a first run lands with: the two index ETFs and the names most
@@ -211,13 +213,88 @@ export function buildFirstRunLayout({
   };
 }
 
-/** Replaces the Home layout with the first-run workspace and makes it active. */
-export function applyFirstRunLayout(config: AppConfig, home: SavedLayout): AppConfig {
-  const layouts = config.layouts.length > 0 ? [home, ...config.layouts.slice(1)] : [home];
+/**
+ * The ids of the layouts onboarding makes. Running it again finds its own
+ * layouts by these and replaces them, so it never adds a copy; a layout
+ * without one is the user's.
+ */
+const ONBOARDING_HOME_LAYOUT_ID = "onboarding:home";
+const ONBOARDING_LAYOUT_ID_PREFIX = "onboarding:";
+const ONBOARDING_DESK_LAYOUT_ID_PREFIX = `${ONBOARDING_LAYOUT_ID_PREFIX}desk:`;
+
+export function onboardingDeskLayoutId(desk: DeskKey): string {
+  return `${ONBOARDING_DESK_LAYOUT_ID_PREFIX}${desk}`;
+}
+
+function isOnboardingLayout(layout: SavedLayout): boolean {
+  return layout.id?.startsWith(ONBOARDING_LAYOUT_ID_PREFIX) === true;
+}
+
+/**
+ * Takes back the layouts setup made before it tagged them, so a run from
+ * Settings rebuilds them in place instead of copying them. Such a profile
+ * has setup's Home first and its desks right after it, under the desks'
+ * names. A first layout not called Home is the user's, and so is
+ * everything after the desks.
+ */
+function adoptUntaggedSetupLayouts(config: AppConfig): AppConfig {
+  const [first, ...rest] = config.layouts;
+  if (!first || first.name !== "Home" || config.layouts.some(isOnboardingLayout)) return config;
+  const desks: SavedLayout[] = [];
+  for (const layout of rest) {
+    const key = DESKS.find((desk) => desk.name === layout.name)?.key;
+    if (!key || desks.length >= MAX_DESK_PICKS || desks.some((desk) => desk.id === onboardingDeskLayoutId(key))) break;
+    desks.push({ ...layout, id: onboardingDeskLayoutId(key) });
+  }
+  return {
+    ...config,
+    layouts: [{ ...first, id: ONBOARDING_HOME_LAYOUT_ID }, ...desks, ...rest.slice(desks.length)],
+  };
+}
+
+/** The desks setup made that are still tabs, in tab order: what a run from Settings starts with ticked. */
+export function setupDeskPicks(config: AppConfig): DeskKey[] {
+  const picks: DeskKey[] = [];
+  for (const layout of adoptUntaggedSetupLayouts(config).layouts) {
+    const key = layout.id?.startsWith(ONBOARDING_DESK_LAYOUT_ID_PREFIX)
+      ? layout.id.slice(ONBOARDING_DESK_LAYOUT_ID_PREFIX.length)
+      : null;
+    if (isDeskKey(key) && !picks.includes(key)) picks.push(key);
+  }
+  return picks.slice(0, MAX_DESK_PICKS);
+}
+
+/**
+ * Puts the first-run workspace in place and makes Home active: Home, then a
+ * tab per picked desk. The layouts an earlier run made are replaced where
+ * they stood, and a desk not picked this time goes with them; a first run
+ * replaces the stock Home it starts with. Every other layout is the user's
+ * and keeps its place and content. A run from Settings (`rerun`) also
+ * rebuilds what setup made before it tagged its layouts, and with none of
+ * setup's left it puts Home first, replacing nothing.
+ */
+export function applyFirstRunLayout(
+  config: AppConfig,
+  home: SavedLayout,
+  desks: ReadonlyArray<SavedLayout & { id: string }> = [],
+  { rerun = false }: { rerun?: boolean } = {},
+): AppConfig {
+  const { layouts: current } = rerun ? adoptUntaggedSetupLayouts(config) : config;
+  const earlier = current.findIndex(isOnboardingLayout);
+  const users = current.filter((layout) => !isOnboardingLayout(layout));
+  // Everything before the first layout onboarding made is the user's, so its index holds.
+  const at = earlier >= 0 ? earlier : 0;
+  const kept = earlier >= 0 || rerun ? users : users.slice(1);
+  const layouts = [
+    ...kept.slice(0, at),
+    { ...home, id: ONBOARDING_HOME_LAYOUT_ID },
+    ...desks,
+    ...kept.slice(at),
+  ];
   return {
     ...config,
     layouts,
     layout: home.layout,
-    activeLayoutIndex: 0,
+    activeLayoutIndex: at,
   };
 }

package/src/components/onboarding/onboarding-frame.tsx

@@ -359,7 +359,8 @@ export function OnboardingHeader({
   }
 
   // Progress, not navigation: three segments, the current one lit, the ones
-  // behind it filled. A filled segment is still a way back.
+  // behind it filled. A filled segment is a way back unless the wizard marks
+  // it unavailable: a step done for good stays filled and is not offered again.
   const activeIndex = sections.findIndex((section) => section.id === active);
   return (
     <Box flexDirection="row" alignItems="flex-start" justifyContent="space-between" minWidth={0}>

package/src/components/onboarding/onboarding-keyboard.ts

@@ -58,7 +58,7 @@ export function useOnboardingKeyboard({
   submitAccountField, backPortfolio, continuePortfolio, setPortfolioOptionIdx, activeBrokerFields,
   brokerFieldIdx, setBrokerSelectIdx, brokerChoices, openBrokerGuide, chosenDesks, finishDesks,
   setDeskCursor, deskCursor, setChosenDesks, continueAccount, skipSetup, primaryUpgradeAction,
-  setBillingInterval, keybindings, dialogOpen, commandBarOpen, saveProgressInBackground,
+  setBillingInterval, keybindings, dialogOpen, commandBarOpen, saveProgressInBackground, goBack,
 }: {
   stage: OnboardingStage;
   progress: OnboardingProgress;
@@ -102,6 +102,8 @@ export function useOnboardingKeyboard({
   dialogOpen: boolean;
   commandBarOpen: boolean;
   saveProgressInBackground: (patch: Partial<OnboardingProgress> & Pick<OnboardingProgress, "stage">, baseConfig?: AppConfig | undefined) => void;
+  /** Back on the card: to the step the user came from. */
+  goBack: () => void;
 }) {
   const activeSection: OnboardingSectionId = stage === "portfolio" || stage === "desks"
     ? "portfolio"
@@ -128,7 +130,8 @@ export function useOnboardingKeyboard({
 
     const handled = ((): boolean => {
       if (isPlainKey(event, "f10")) {
-        if (stage === "portfolio" || stage === "desks" || isBrokerCommitting) return true;
+        // The first run needs a holding; a run from Settings can be left as it was.
+        if (isBrokerCommitting || ((stage === "portfolio" || stage === "desks") && !progress.rerun)) return true;
         if (stage === "upgrade" && !planAccess.hasProAccess) continueFree();
         else void finish(true);
         return true;
@@ -234,7 +237,7 @@ export function useOnboardingKeyboard({
           continueAccount();
         } else if (escape) {
           if (account.accountSub === "qr" || account.accountSub === "login") account.returnToAccountForm();
-          else goToSection("portfolio");
+          else goBack();
         } else if (letter(BROWSER_SIGN_IN_KEY) && accountForm) {
           account.beginQrSignIn();
         } else if (letter(SKIP_SETUP_KEY)) {
@@ -251,7 +254,7 @@ export function useOnboardingKeyboard({
         if (enter) {
           primaryUpgradeAction();
         } else if (escape) {
-          goToSection("cloud");
+          goBack();
         } else if (!planAccess.hasProAccess && letter(KEEP_FREE_KEY)) {
           continueFree();
         } else if (!planAccess.hasProAccess && (isPlainKey(event, "left") || letter("h"))) {
@@ -266,7 +269,7 @@ export function useOnboardingKeyboard({
 
       if (stage === "ready") {
         if (enter) void finish();
-        else if (escape) goToSection(progress.accountStatus === "signed-in" ? "pro" : "cloud");
+        else if (escape) goBack();
         else return false;
         return true;
       }

package/src/components/onboarding/onboarding-wizard.tsx

@@ -20,7 +20,7 @@ import { t, tf } from "../../i18n";
 import { useAppLanguage } from "../../i18n/react";
 import type { PluginRegistry } from "../../plugins/registry";
 import { formatCloudPrice, monthsFreeYearly } from "../../account/billing";
-import { proStepCopy, proStepRealtimeTitle } from "../../account/upgrade-dialog";
+import { proStepCopy } from "../../account/upgrade-dialog";
 import { Button, SegmentedControl, terminalButtonColumns } from "../ui";
 import { AccountStep, PortfolioStep } from "./onboarding-steps";
 import {
@@ -41,7 +41,7 @@ import { useOnboardingAccount } from "./wizard-account";
 import { useOnboardingBrokerSync } from "./wizard-broker-sync";
 import { useOnboardingPositions } from "./wizard-positions";
 import { DesksStep, toggleDeskChoice } from "./desks-step";
-import { getOnboardingProgress } from "./wizard-model";
+import { getOnboardingProgress, isOnboardingWorkspaceBuilt, previousOnboardingStage } from "./wizard-model";
 import {
   useOnboardingKeyboard,
   SKIP_SETUP_KEY,
@@ -86,7 +86,22 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
   const config = useAppSelector((state) => state.config);
   const progress = getOnboardingProgress(config);
   const stage = progress.stage;
+  const workspaceBuilt = isOnboardingWorkspaceBuilt(progress);
+  /** Opened again from Settings: any step can be left, and the first-run funnel is not told. */
+  const rerun = progress.rerun === true;
   const researchOpenedRef = useRef<string | null>(null);
+  /** The stages the user came through, oldest first, for Back to retrace. */
+  const visitedRef = useRef<OnboardingStage[]>([]);
+  const shownStageRef = useRef(stage);
+  const backTargetRef = useRef<OnboardingStage | null>(null);
+  useEffect(() => {
+    const left = shownStageRef.current;
+    if (left === stage) return;
+    shownStageRef.current = stage;
+    const back = backTargetRef.current === stage;
+    backTargetRef.current = null;
+    if (!back) visitedRef.current = [...visitedRef.current, left];
+  }, [stage]);
   const [editingField, setEditingField] = useState(false);
   /** The added position the keyboard acts on once no field is being typed in. */
   const [positionCursorSymbol, setPositionCursorSymbol] = useState<string | null>(null);
@@ -109,7 +124,7 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
   // bar, so an unread inbox never stalls the first session.
   const account = useOnboardingAccount({
     nextStep: () => {
-      recordResearchActivity("onboarding_signed_in");
+      if (!rerun) recordResearchActivity("onboarding_signed_in");
       saveProgressInBackground({ stage: "upgrade", accountStatus: "signed-in" });
     },
     setEditingField,
@@ -127,12 +142,12 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
 
   useEffect(() => {
     const activity = STAGE_ACTIVITY[stage];
-    if (activity) recordResearchActivity(activity);
-  }, [stage]);
+    if (activity && !rerun) recordResearchActivity(activity);
+  }, [rerun, stage]);
 
   useEffect(() => {
-    if (stage === "portfolio" && positionCount > 0) recordResearchActivity("onboarding_position_added");
-  }, [positionCount, stage]);
+    if (stage === "portfolio" && positionCount > 0 && !rerun) recordResearchActivity("onboarding_position_added");
+  }, [positionCount, rerun, stage]);
 
   // The portfolio step opens straight into the ticker field.
   useEffect(() => {
@@ -197,8 +212,8 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
   useEffect(() => {
     if (stage !== "research" || !progress.tickerSymbol || researchOpenedRef.current === progress.tickerSymbol) return;
     researchOpenedRef.current = progress.tickerSymbol;
-    recordResearchActivity("ticker_saved");
-  }, [stage, progress.tickerSymbol]);
+    if (!rerun) recordResearchActivity("ticker_saved");
+  }, [rerun, stage, progress.tickerSymbol]);
   const movePositionCursor = useCallback((delta: number) => {
     if (positionCursorIndex < 0) return;
     const next = Math.max(0, Math.min(positionCount - 1, positionCursorIndex + delta));
@@ -239,16 +254,17 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
     : null;
   const helpFocused = focusedInstance?.paneId === "help";
   const {
-    offer, pricing, billingInterval, setBillingInterval, planAccess, primaryUpgradeAction, continueFree, personalTickers,
+    offer, pricing, billingInterval, setBillingInterval, planAccess, primaryUpgradeAction, continueFree,
   } = useOnboardingUpgrade({
     stage, progress, saveProgressInBackground, persistProgress,
-    shown: !helpFocused && !dialogOpen && !commandBarOpen,
   });
 
   const goToSection = useCallback((section: OnboardingSectionId) => {
     if (finishingRef.current || isBrokerCommitting) return;
     setEditingField(false);
     if (section === "portfolio") {
+      // Done for good once the workspace is built: picking it again would build it twice.
+      if (workspaceBuilt) return;
       setPortfolioSub("positions");
       saveProgressInBackground({ stage: "portfolio" });
       return;
@@ -260,10 +276,22 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
     if (planAccess.signedIn) {
       saveProgressInBackground({ stage: "upgrade", accountStatus: "signed-in" });
     }
-  }, [isBrokerCommitting, planAccess.signedIn, saveProgressInBackground]);
+  }, [isBrokerCommitting, planAccess.signedIn, saveProgressInBackground, workspaceBuilt]);
+
+  /** Back and Esc: to the step the user came from, never one that is done for good. */
+  const goBack = useCallback(() => {
+    if (finishingRef.current || isBrokerCommitting) return;
+    const back = previousOnboardingStage(progress, visitedRef.current, { pro: planAccess.hasProAccess });
+    if (!back) return;
+    visitedRef.current = back.visited;
+    backTargetRef.current = back.stage;
+    setEditingField(false);
+    if (back.stage === "portfolio") setPortfolioSub("positions");
+    saveProgressInBackground({ stage: back.stage });
+  }, [isBrokerCommitting, planAccess.hasProAccess, progress, saveProgressInBackground]);
 
   const sectionAvailability: Partial<Record<OnboardingSectionId, boolean>> = {
-    portfolio: !isBrokerCommitting,
+    portfolio: !isBrokerCommitting && !workspaceBuilt,
     // The workspace is built when the desks are picked, so that step comes first.
     cloud: !isBrokerCommitting && stage !== "desks" && (stage === "account" || stage === "upgrade" || stage === "ready" || !!progress.tickerSymbol),
     pro: !isBrokerCommitting && planAccess.signedIn && (
@@ -282,7 +310,7 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
     submitAccountField, backPortfolio, continuePortfolio, setPortfolioOptionIdx, activeBrokerFields,
     brokerFieldIdx, setBrokerSelectIdx, brokerChoices, openBrokerGuide, chosenDesks, finishDesks,
     setDeskCursor, deskCursor, setChosenDesks, continueAccount, skipSetup, primaryUpgradeAction,
-    setBillingInterval, keybindings, dialogOpen, commandBarOpen, saveProgressInBackground,
+    setBillingInterval, keybindings, dialogOpen, commandBarOpen, saveProgressInBackground, goBack,
   });
 
   return {
@@ -295,7 +323,7 @@ function useOnboardingWizard({ pluginRegistry, importBrokerPositions, onComplete
     openBrokerConnect, continueFromPositions, backPortfolio, continuePortfolio, chosenDesks, deskCursor,
     setDeskCursor, setChosenDesks, buildingDesks, finishDesks, account, viewportWidth, viewportHeight, continueAccount,
     offer, planAccess, pricing, billingInterval, setBillingInterval, continueFree, primaryUpgradeAction,
-    personalTickers,
+    goBack, rerun,
   };
 }
 
@@ -310,7 +338,7 @@ export function OnboardingWizard(props: OnboardingWizardProps) {
     openBrokerConnect, continueFromPositions, backPortfolio, continuePortfolio, chosenDesks, deskCursor,
     setDeskCursor, setChosenDesks, buildingDesks, finishDesks, account, viewportWidth, viewportHeight, continueAccount,
     offer, planAccess, pricing, billingInterval, setBillingInterval, continueFree, primaryUpgradeAction,
-    personalTickers,
+    goBack, rerun,
   } = useOnboardingWizard(props);
 
   if (helpFocused) {
@@ -387,7 +415,8 @@ export function OnboardingWizard(props: OnboardingWizardProps) {
           onDismiss={skipSetup}
           dismissing={isFinishing}
           dismissDisabled={isBrokerCommitting}
-          showDismiss={false}
+          // The first run needs a holding; a run from Settings can be left as it was.
+          showDismiss={rerun}
         />
         <OnboardingTitle
           step={desktop ? undefined : t("PORTFOLIO")}
@@ -467,12 +496,14 @@ export function OnboardingWizard(props: OnboardingWizardProps) {
           onNavigate={goToSection}
           onDismiss={skipSetup}
           dismissing={isFinishing}
-          showDismiss={false}
+          dismissDisabled={buildingDesks}
+          showDismiss={rerun}
         />
         <OnboardingTitle
           step={desktop ? undefined : t("DESKS")}
-          title={t("What do you trade?")}
-          description={t("Each one adds a ready-made desk as a tab.")}
+          title={t("What do you trade most?")}
+          // A line of its own: the picks guide the workspace, they do not limit it.
+          description={`${t("Pick up to 3; each adds a ready-made tab.")}\n${t("Everything else is one search away.")}`}
         />
         {/* Not allowed to shrink: on a short window the card scrolls instead of the list running under the buttons. */}
         <DesksStep
@@ -594,7 +625,7 @@ export function OnboardingWizard(props: OnboardingWizardProps) {
           <OnboardingButton
             label="Back"
             variant="ghost"
-            onPress={account.accountSub === "qr" || account.accountSub === "login" ? account.returnToAccountForm : () => goToSection("portfolio")}
+            onPress={account.accountSub === "qr" || account.accountSub === "login" ? account.returnToAccountForm : goBack}
           />
           {account.accountSub !== "qr" ? (
             <OnboardingButton
@@ -621,7 +652,7 @@ export function OnboardingWizard(props: OnboardingWizardProps) {
       : proCopy.note;
     // Ranked: the data itself first, then what reads it.
     const features = [
-      { title: proStepRealtimeTitle(personalTickers), description: t("Free is 15 minutes behind on quotes and 12 hours on news.") },
+      { title: t("Real-time market data"), description: t("Free is 15 minutes behind on quotes and 12 hours on news.") },
       { title: t("MCP server"), description: t("Claude Code, Codex or Cursor call Gloom's research tools.") },
       { title: t("Ask Gloom"), description: t("Answers cite filings, calls and news.") },
       { title: t("Earnings calls"), description: t("Transcripts, summaries, guidance and scores.") },
@@ -734,7 +765,7 @@ export function OnboardingWizard(props: OnboardingWizardProps) {
         <OnboardingButton
           label="Back"
           variant="ghost"
-          onPress={() => goToSection(progress.accountStatus === "signed-in" ? "pro" : "cloud")}
+          onPress={goBack}
         />
         <OnboardingButton
           label={isFinishing ? "Opening workspace..." : "Start exploring"}

package/src/components/onboarding/portfolio-step/positions-panel.tsx

@@ -7,6 +7,8 @@ import { formatMarketPrice } from "../../../market-data/market/format";
 import { getRegularSessionDisplay } from "../../../market-data/market/status";
 import { formatPercentRaw } from "../../../utils/format";
 import { Button, NumberField, TextField } from "../../ui";
+import { DelayedMark } from "../../ui/delayed-mark";
+import { useFreeQuoteDelay } from "../../../api-client/plan-access";
 import { ONBOARDING_DESKTOP } from "../onboarding-frame";
 import {
   POSITION_FIELDS,
@@ -31,7 +33,7 @@ const FIELD_LABELS: Record<PositionFieldId, string> = {
 const FIELD_PLACEHOLDERS: Record<Exclude<PositionFieldId, "currency">, string> = {
   ticker: "e.g. AAPL",
   shares: "optional",
-  avgCost: "current price",
+  avgCost: "last price",
 };
 
 /** A field's label; the size counts contracts once the symbol is a future. */
@@ -47,6 +49,8 @@ function fieldPlaceholder(field: PositionFieldId, state: OnboardingPositionsStat
 /** Company name and last price for the symbol being typed, or why it will not resolve. */
 function PreviewLine({ preview, error }: Pick<OnboardingPositionsState, "preview" | "error">) {
   const colors = useThemeColors();
+  // Signed out or free, the price is the delayed one, and says so.
+  const delay = useFreeQuoteDelay(preview.status === "ready" ? preview.quote : null);
   if (error) return <Text fg={colors.negative} wrapText>{error}</Text>;
   if (preview.status === "idle") return null;
   if (preview.status === "checking") {
@@ -58,11 +62,12 @@ function PreviewLine({ preview, error }: Pick<OnboardingPositionsState, "preview
   const price = headline?.price;
   const change = headline?.changePercent;
   return (
-    <Box flexDirection="row" minWidth={0} overflow="hidden">
+    <Box flexDirection="row" alignItems="center" minWidth={0} overflow="hidden">
       <Text fg={colors.text} attributes={TextAttributes.BOLD}>{preview.symbol}</Text>
       {preview.name ? <Text fg={colors.textDim}>{`  ${preview.name}`}</Text> : null}
       {price != null ? <Text fg={colors.text}>{`  ${formatMarketPrice(price, { maxWidth: 12 })}`}</Text> : null}
       {change != null ? <Text fg={shownPriceColor(change, 2, colors)}>{` ${formatPercentRaw(change)}`}</Text> : null}
+      {price != null && delay != null ? <Box flexShrink={0} paddingLeft={1}><DelayedMark minutes={delay} /></Box> : null}
       {preview.duplicate ? <Text fg={colors.textMuted}>{t("  already added")}</Text> : null}
     </Box>
   );

package/src/components/onboarding/run-setup-again.ts

@@ -0,0 +1,24 @@
+import { useCallback } from "react";
+import { useAppDispatch, useAppStateRef } from "../../state/app/context";
+import { saveConfigImmediately } from "../../state/config-save-scheduler";
+import type { OnboardingProgress } from "../../types/config";
+
+/**
+ * Settings' Run Setup Again: setup from its first step, on what the user has.
+ * The holdings are the portfolio's own, and the desks setup made start
+ * ticked; finishing rebuilds setup's layouts in place and leaves the user's
+ * alone. `open` shows the wizard once the progress is saved; without it
+ * (a host that cannot run setup) there is nothing to run.
+ */
+export function useRunSetupAgain(open: (() => void) | undefined): (() => Promise<void>) | undefined {
+  const dispatch = useAppDispatch();
+  const stateRef = useAppStateRef();
+  const run = useCallback(async () => {
+    if (!open) return;
+    const progress: OnboardingProgress = { version: 1, stage: "portfolio", rerun: true };
+    await saveConfigImmediately({ ...stateRef.current.config, onboardingComplete: false, onboardingProgress: progress });
+    dispatch({ type: "SET_ONBOARDING_STATE", complete: false, progress });
+    open();
+  }, [dispatch, open, stateRef]);
+  return open ? run : undefined;
+}