dexterm-cli 0.1.5 → 0.1.6

package/dist/packages/cli/src/live/screens/token-live.js

@@ -14,11 +14,12 @@ import { renderScanWhy, renderScanTicker } from "../../scan/ui.js";
 import { drawCoin, imagesOn } from "../../screens/coin.js";
 import { COIN_HERO_W, COIN_HERO_H } from '../../../../tui/src/index.js';
 import { renderSocialPanel } from "../../screens/social-panel.js";
+import { brainFor, factsFromView, renderBrainPanel } from "../../screens/brain.js";
 import { launchIntelCells, holderTags } from "../intel.js";
 import { devBookOf, devRows } from "../dev-history.js";
 import { EX_POOL_TAGS } from '../../../../data/src/index.js';
 import { layoutFor } from "../../custom.js";
-import { chartMode, priceModeOf, mcapAt, positionPriceCells } from "../../display.js";
+import { chartMode, chartTitle, priceModeOf, chartAxisOf, mcapAt, positionPriceCells } from "../../display.js";
 const dash = '—';
 const EX_POOL_TAG_SET = EX_POOL_TAGS;
 /** task-1367 holder-class badge colours: venues/escrows accent, the creator/linked warn, the rest muted. */
@@ -87,13 +88,13 @@ export function renderTokenLive(c, state, v) {
     const shownPx = livePx ?? v.price;
     // task-1366: mcap mode leads with the market cap (the live price × the polled supply ratio) and keeps the price beside it;
     // without a supply it shows the price and says so.
-    const cm = chartMode(priceModeOf(state), v.price, v.mcap);
-    if (cm.kind === 'mcap' && shownPx !== null) {
-        x = c.text(x0, y, fmtMcap(mcapAt(shownPx, cm.scale)), { fg: t.text, bg: t.bg, b: true });
+    const pm = chartMode(priceModeOf(state), v.price, v.mcap);
+    if (pm.kind === 'mcap' && shownPx !== null) {
+        x = c.text(x0, y, fmtMcap(mcapAt(shownPx, pm.scale)), { fg: t.text, bg: t.bg, b: true });
         x = c.text(x + 1, y, `(${fmtPrice(shownPx)})`, { fg: t.dim, bg: t.bg });
     }
     else
-        x = c.text(x0, y, shownPx === null ? dash : fmtPrice(shownPx), { fg: cm.label && shownPx !== null ? t.warn : t.text, bg: t.bg, b: true });
+        x = c.text(x0, y, shownPx === null ? dash : fmtPrice(shownPx), { fg: pm.label && shownPx !== null ? t.warn : t.text, bg: t.bg, b: true });
     if (state.live?.fastLane)
         x = badge(c, x + 1, y, liveBadge, liveBadge === 'LIVE' ? t.up : t.muted, { on: t.bg });
     const deltas = [['5m', v.chg.m5], ['1h', v.chg.h1], ['6h', v.chg.h6], ['24h', v.chg.h24]];
@@ -131,7 +132,9 @@ export function renderTokenLive(c, state, v) {
     const chartH = Math.max(10, Math.floor((bottom - y - posH) * lay.chartFrac));
     const cp = v.panels.candles;
     const chartCap = clip(cp.state === 'ok' || cp.fetchedAt !== null ? `ohlcv: geckoterminal${cp.stale || cp.state === 'error' ? ' · stale' : ''}` : panelCaption(cp, now, 'ohlcv unavailable'), 40);
-    const cb = c.box(0, y, mainW, chartH, { title: cm.label ? (cm.kind === 'mcap' ? `${v.symbol} ${cm.label} · ${v.interval}` : `${v.symbol}/USD · ${cm.label} · ${v.interval}`) : `${v.symbol}/USD · ${v.interval}`, caption: chartCap, captionFg: cp.state === 'error' && cp.fetchedAt === null ? t.warn : undefined });
+    // task-1472: the chart's Y axis is its own setting (default MARKET CAP, `A` toggles); the header above keeps `$`.
+    const cm = chartMode(chartAxisOf(state), v.price, v.mcap);
+    const cb = c.box(0, y, mainW, chartH, { title: chartTitle(v.symbol, v.interval, cm), caption: chartCap, captionFg: cp.state === 'error' && cp.fetchedAt === null ? t.warn : undefined });
     // timeframe tabs sit on the top border, left of the caption (same spot as the fixture screen)
     let tx = cb.x + cb.w - 2 - (chartCap.length + 4) - INTERVALS.reduce((s, f) => s + f.length + 1, 0);
     for (const f of INTERVALS)
@@ -142,9 +145,12 @@ export function renderTokenLive(c, state, v) {
         c.textC(cb.x, cb.y + Math.floor(cb.h / 2), cb.w, cp.state === 'loading' ? 'loading candles…' : `no candles · ${cp.reason ?? 'source did not answer'}`, { fg: t.muted, bg: cb.bg, i: true });
     y += chartH;
     if (prow && src) {
-        positionPanel(c, 0, y, mainW, prow, held?.kind ?? src.kind, priceModeOf(state), cm.scale);
+        positionPanel(c, 0, y, mainW, prow, held?.kind ?? src.kind, priceModeOf(state), pm.scale);
         y += posH;
     }
+    // task-1473: what the ON-CHAIN band derived this frame, for the brain view's vetting list (null under SOCIAL)
+    let brainTop10 = null;
+    let brainDev = null;
     // ---- task-1330: the SOCIAL panel (`s`) replaces the ON-CHAIN / HOLDERS band; the chart + position stay.
     if (state.tokenSocial) {
         renderSocialPanel(c, 0, y, mainW, bottom - y, state, { mint: v.mint, symbol: v.symbol, now });
@@ -182,9 +188,11 @@ export function renderTokenLive(c, state, v) {
         // 0.1.5 dev history (task-1425): the creator's recorded track record from the local recorder (keyless). The rugs
         // row sits with the other rug signals; launches / bag-exit / linked wallets follow the safety list.
         const book = devBookOf(state);
-        const devAll = book ? devRows(book.forMint(v.mint, v.devAddress ?? null, state.live?.intel?.analysis(v.mint) ?? null)) : [];
+        const devAll = book ? devRows(book.forMint(v.mint, v.devAddress ?? null, state.live?.intel?.analysis(v.mint) ?? null, state.live?.intel?.entry(v.mint)?.at ?? null), now) : [];
         const devHead = devAll.slice(0, 1);
         const devTail = devAll.slice(1);
+        brainTop10 = tags.top10 ? tags.top10.exPool : v.top10;
+        brainDev = (devHead[0] ? [`${devHead[0][0]}: ${devHead[0][1]}`, devHead[0][2]] : v.devMints === null ? null : [`${v.devMints} mints by dev (jup)`, v.devMints > 3 ? 'warn' : 'ok']);
         const sniperRow = [cells.snipers.text, cells.snipers.level];
         const bundleRow = [cells.bundle.text, cells.bundle.level];
         const rows = [
@@ -201,7 +209,7 @@ export function renderTokenLive(c, state, v) {
             ['GoPlus', ...goplusRow(v)],
             ...devTail,
         ];
-        for (const [label, val0, lvl] of rows) {
+        for (const [label, val0, lvl] of fitRows(rows, sb.y + sb.h - sy)) {
             if (sy >= sb.y + sb.h)
                 break;
             const color = lvl === 'ok' ? t.up : lvl === 'warn' ? t.warn : lvl === 'bad' ? t.down : t.dim;
@@ -327,8 +335,15 @@ export function renderTokenLive(c, state, v) {
             }
         }
     }
-    if (showAi)
-        analystPlaceholder(c, mainW, top, aiW, bottom - top, v, state);
+    if (showAi) {
+        // task-1473: in an auto mode (following an agent / AI scan) the panel is the BRAIN VIEW; otherwise the analyst
+        const facts = factsFromView(v, { top10: brainTop10, dev: brainDev, larpVerdict: state.larpByMint?.get(v.mint)?.verdict ?? null, price: shownPx });
+        const brain = brainFor(state, facts, isCalm(state.vfx), state.live?.scanMeterLabel?.() ?? '');
+        if (brain)
+            renderBrainPanel(c, mainW, top, aiW, bottom - top, brain.model, brain.opts);
+        else
+            analystPlaceholder(c, mainW, top, aiW, bottom - top, v, state);
+    }
     const watched = state.live?.watch?.has(v.mint) ? 'unwatch' : 'watch';
     // task-1311: `i` asks claude about this token (chat), `a` runs the paid dossier on demand, `y`
     // copies the full contract address.
@@ -402,6 +417,21 @@ function positionPanel(c, x, y, w, r, kind, mode = 'price', supply = null) {
 function clip(s, max) {
     return s.length > max ? s.slice(0, Math.max(1, max - 1)) + '…' : s;
 }
+/**
+ * task-1463: the ON-CHAIN rows for a panel `space` lines tall. When they all fit they are returned unchanged. When
+ * they do not, a short panel must not drop a red flag silently (e.g. `Dev rugs 2/3`, the last rows of the list):
+ * bad rows are kept first, then warn rows, then the rest in order, the kept rows stay in their order, and the last
+ * line says how many rows are hidden.
+ */
+export function fitRows(rows, space) {
+    if (rows.length <= space || space <= 0)
+        return rows;
+    const slots = space - 1;
+    const rank = (l) => (l === 'bad' ? 0 : l === 'warn' ? 1 : 2);
+    const keep = new Set(rows.map((r, i) => [rank(r[2]), i]).sort((a, b) => a[0] - b[0] || a[1] - b[1]).slice(0, slots).map(([, i]) => i));
+    const hidden = rows.length - keep.size;
+    return [...rows.filter((_, i) => keep.has(i)), [`+${hidden} rows hidden`, 'taller window', 'na']];
+}
 /** Token amounts up to trillions (fmtNum stops at B). */
 function fmtAmt(n) {
     if (n >= 1e12)

package/dist/packages/cli/src/live/screens/watchlist-live.js

@@ -89,7 +89,7 @@ export function renderWatchlistLive(c, state, live) {
             } });
     }
     if (rows.length)
-        table(c, box.x + 1, box.y, box.w - 2, box.h, { columns: promoteMcap(cols, mode), rows, selected: sel, bg: box.bg });
+        table(c, box.x + 1, box.y, box.w - 2, box.h, { columns: promoteMcap(cols, mode), rows, selected: sel, bg: box.bg, rowKey: (r) => r.entry.mint });
     else
         c.textC(box.x, box.y + Math.min(3, Math.floor(box.h / 2)), box.w, 'watchlist is empty · press w on any token (screener, new pairs, token screen) to add it', { fg: t.muted, bg: box.bg, i: true });
     const y2 = top + listH;

package/dist/packages/cli/src/live/trade.js

@@ -669,6 +669,8 @@ export function positionRow(h, tickUsd, solUsd) {
 }
 /** How long a `held()` lookup is reused before re-reading the ledger (the render loop calls it per frame). */
 export const HELD_MEMO_MS = 250;
+/** task-1473 r2: how long the open-mints list is reused (a ledger read; the chip samples it every tick). */
+export const OPEN_MINTS_MEMO_MS = 1000;
 /** Minimum spacing of the token screen's automatic mark pass for a held coin missing SOL/USD or a mark. */
 export const HELD_AUTOMARK_MS = 30_000;
 /** Live PAPER positions + PnL: marks held tokens from the keyless price feed. */
@@ -738,6 +740,22 @@ export class PositionsLive {
         }
         return v;
     }
+    /** task-1473 r2: mints of the open paper positions (the AI-scan PnL chip), memoised OPEN_MINTS_MEMO_MS. */
+    openMints() {
+        const now = this.now();
+        if (this.openMemo && now - this.openMemo.at >= 0 && now - this.openMemo.at < OPEN_MINTS_MEMO_MS)
+            return this.openMemo.v;
+        let v = [];
+        try {
+            v = this.wallet.positions().filter((p) => p.tokensRaw > 0n).map((p) => p.mint);
+        }
+        catch {
+            v = [];
+        }
+        this.openMemo = { at: now, v };
+        return v;
+    }
+    openMemo = null;
     /**
      * Mark held tokens in SOL. Prices come from DexScreener (its own fast 300 rpm bucket), not the
      * keyless `jupiter` bucket the screener feed and quotes share — so a mark never queues behind them.
@@ -917,6 +935,8 @@ export class LivePositions {
         this.memo.set(mint, { at: now, v });
         return v;
     }
+    /** task-1473 r2: mints of the open live positions (the AI-scan PnL chip). Memoised with positions(). */
+    openMints() { return this.positions().filter((p) => p.tokensRaw > 0n).map((p) => p.mint); }
     /** Forget memoised reads (after a fill). */
     invalidate() { this.memo.clear(); this.rowsMemo = null; }
 }
@@ -936,6 +956,8 @@ export class CombinedPositions {
         return p;
     }
     solUsd() { return this.paper.solUsd() ?? this.live?.solUsd() ?? null; }
+    /** task-1473 r2: every open mint, live first (the AI-scan PnL chip picks one). */
+    openMints() { return [...new Set([...(this.live?.openMints() ?? []), ...this.paper.openMints()])]; }
 }
 function msg(e) {
     return e instanceof Error ? e.message : String(e);

package/dist/packages/cli/src/main.js

@@ -25,7 +25,7 @@ import { parseMintTarget, parseCoinTarget, resolveCoinTarget, isBareOpen } from
 import { THEMES, isThemeName, DEFAULT_THEME, THEME_NAMES, Flusher, ENTER_SCREEN, LEAVE_SCREEN, DEFAULT_KEYMAP, Keymap, nextTheme, parseKeys, keyId, detectColorDepth, parseColorDepth, blinkFrame, blinkFrames, stepVfx, pulse, isCalm, fxBusy, blendActivity, ImageLayer, queryTerminal, resolveProtocol, fireMoment, fireInflight, clearInflight, skipMoment, momentKindFor, playMoment, soundOn, breakpoint, fmtUsd as fmtUsdTui, } from '../../tui/src/index.js';
 import { resolveRpcUrl, redactSecrets, defaultDbPath, extraRpcUrls, wsUrlFor, SOLANA_PUBLIC_RPC_WS, parseHttpUrl, validateAnalystAction, ACTION_RATE, ACTION_TIER, configChangeForAction, ImageService, encodePng, SummaryLimiter, buildSummaryWindow, KolStore, Cache, PackError, normalizeHandle, terminalSafe } from '../../data/src/index.js';
 import { Recorder, recorderEnabled, MaintenanceSchedule } from '../../recorder/src/index.js';
-import { makeFixtureState, makeFeedState, syncFeed, renderFrame, isScreenKey, activityFor, SCREEN_NAMES, analystKey, syncAnalyst, pinNewpairsSelection, ANALYST_TAB_KEY, computeNarrativeView, newPlansUi, plansService, plansRows, newFollowsUi, copyService, copyAutoService, MIRROR_DEFAULT_CAP_USD } from "./state.js";
+import { makeFixtureState, makeFeedState, syncFeed, renderFrame, isScreenKey, activityFor, SCREEN_NAMES, analystKey, syncAnalyst, pinNewpairsSelection, ANALYST_TAB_KEY, computeNarrativeView, newPlansUi, plansService, plansRows, newFollowsUi, copyService, copyAutoService, MIRROR_DEFAULT_CAP_USD, pnlChipFor } from "./state.js";
 import { mulberry32, tick, spawnPair, shock } from "./fixtures.js";
 import { createLiveFeed, createReplayFeed } from "./feed.js";
 import { LiveContext, INTERVALS, WATCH_REFRESH_MS, POSITIONS_REFRESH_MS, popupBubbleVM } from "./live/index.js";
@@ -39,7 +39,9 @@ import { parseFilter } from "./screener/filter.js";
 import { screenerView, setFilter, setSort, setPreset, stepPreset, clampSelection, openFilterEditor, openSortMenu, filterEditorKey, sortMenuKey, } from "./screener/view.js";
 import { readBootState, bootPlan, recordBoot, bootTrace, dextermHome } from "./boot-state.js";
 import { socialOf, kolOf, trendingRows, kolRows, nextSocialFilter, feedsPopupModel } from "./social/view.js";
-import { TokenPopups, tokenDetailVMFromView } from "./popup.js";
+import { TokenPopups, tokenDetailVMFromView, currentPositionFills } from "./popup.js";
+import { OwnPnlTracker } from "./screens/pnl-chip.js";
+import { positionRow } from "./live/trade.js";
 import { widgetPage, widgetEnabled, syncWidgetPopups } from "./widgets.js";
 import { recordLarpVerdict } from "./larp-record.js";
 import { rulesUiOf, rulesTick, rulesMove, beginRuleInput, saveRuleInput, dryRunNow, removeSelectedRule, toggleSelectedRule, dismissSelectedProposal, actOnSelectedProposal, RULE_INPUT_MAX } from "./rules.js";
@@ -53,7 +55,7 @@ import { resolveAnalystResults } from "./analyst/results.js";
 import { parseScanCommand, SCAN_FLAGS, checkScanFlag, SCAN_HELP } from "./scan/command.js";
 import { parseWalletCommand, WALLET_HELP } from "./wallet-command.js";
 import { X_HELP } from "./x-cmd.js";
-import { makeScanUi, MODE_LABEL, SCAN_ACTION_TYPES, SCAN_TICK_MS, SCAN_RECOMPUTE_MS } from "./scan/ui.js";
+import { makeScanUi, scanLog, MODE_LABEL, SCAN_ACTION_TYPES, SCAN_TICK_MS, SCAN_RECOMPUTE_MS } from "./scan/ui.js";
 import { buildObservations, observeSig } from "./scan/observe.js";
 import { cleanText } from "./screener/rows.js";
 import { resolveImagesConfig } from "./images-config.js";
@@ -62,7 +64,8 @@ import { VoiceController, selectStt, selectTts, SayTts, voiceStyleDefaults } fro
 import { LivePlanExecutor, defaultPlansJournalPath } from '../../data/src/trade/plans/index.js';
 import { isWalletAddress, shortAddr, buildMirror, leaderSoldSince, autoSizeCap } from '../../data/src/trade/copy/index.js';
 import { FOLLOW_INPUT_MAX } from "./screens/follows.js";
-import { isPriceMode, configPriceMode, togglePriceMode, priceModeOf, planLevels } from "./display.js";
+import { HUD_MIN_H, hudAnimating } from "./screens/agent-hud.js";
+import { isPriceMode, configPriceMode, togglePriceMode, priceModeOf, planLevels, configChartAxis, setChartAxis, chartAxisOf } from "./display.js";
 import { VERSION } from "./version.js";
 import { initCustom, planWorkspace, planPopupOpens, findWorkspace, nextWorkspaceName, workspaceSlots, saveWorkspace, themeFor, themeByName, cycleTheme, themeNames, CHORD_TTL_MS, MAX_WORKSPACE_NAME } from "./custom.js";
 import { DEFAULT_WORKSPACE, MORNING_HUD, applyAndJournal, policyCheck } from '../../custom/src/index.js';
@@ -124,19 +127,35 @@ export function buildScreenState(state) {
     const sc = state.screener;
     // The screener and the Analyst-tab coin list both show the filtered/sorted screener view, so the
     // selection + visible rows must come from that same view (task-1313); other screens use the raw pool.
-    const rows = state.screen === 'screener' || state.screen === 'analyst' ? screenerView(sc) : sc.rows;
+    // The new-pairs screen shows the live PumpPortal list (task-1443 capture r2: it used to report the screener pool
+    // here, so an agent watching new pairs could not read what was on screen or what was highlighted).
+    const newPairs = state.screen === 'newpairs' && live ? live.newpairs.list() : null;
+    const rows = state.screen === 'screener' || state.screen === 'analyst' ? screenerView(sc) : newPairs ?? sc.rows;
     const toRow = (r) => {
         const x = r;
         if (!x?.mint)
             return null;
         return { mint: x.mint, symbol: x.symbol ?? '', priceUsd: x.price ?? null, chg1h: x.chg?.h1 ?? null, chg24h: x.chg?.h24 ?? null, liq: x.liq ?? null, vol24: x.vol24 ?? null };
     };
-    const visible = rows.slice(0, 12).map(toRow).filter((r) => r !== null);
+    const toNewPairRow = (r) => {
+        const x = r;
+        if (!x?.mint)
+            return null;
+        return {
+            mint: x.mint, symbol: x.symbol ?? '', priceUsd: x.price ?? null, chg1h: x.chg?.h1 ?? null, chg24h: null, liq: x.liq ?? null, vol24: x.vol ?? null,
+            ageSec: Number.isFinite(x.createdAt) ? Math.max(0, Math.round((Date.now() - x.createdAt) / 1000)) : null,
+            mcap: x.mcap ?? null, chg5m: x.chg?.m5 ?? null, bonding: x.bonding ?? null, buys: x.buys ?? null, sells: x.sells ?? null,
+        };
+    };
+    const mapRow = newPairs ? toNewPairRow : toRow;
+    const visible = rows.slice(0, 12).map(mapRow).filter((r) => r !== null);
     let selected = null;
     if (state.screen === 'token' && live?.token?.view)
         selected = { mint: live.token.view.mint, symbol: live.token.view.symbol };
     else {
-        const r = toRow(rows[state.selected || 0]);
+        // Same pick as the new-pairs screen's own highlight (selectedMint first, then the cursor row).
+        const hit = newPairs && state.selectedMint ? newPairs.find((x) => x.mint === state.selectedMint) : undefined;
+        const r = mapRow(hit ?? rows[state.selected || 0]);
         if (r)
             selected = { mint: r.mint, symbol: r.symbol };
     }
@@ -267,7 +286,7 @@ export function shouldDrawFrame(g) {
         return true;
     if (g.calm)
         return g.onTick;
-    if (g.fxBusy)
+    if (g.fxBusy || g.hud)
         return true;
     return g.frame % g.idleEvery === 0;
 }
@@ -306,6 +325,8 @@ export const HELP = `dexterm ${VERSION} (live: screener, token, new pairs, watch
   --record FILE             save every live response (and the PumpPortal session) to FILE (replay it with --replay)
   --spectate-mcp            follow an MCP agent's allowed navigation in this terminal; Ctrl+P pauses, Ctrl+K stops,
                             and any normal user keypress takes control (refused actions never move the UI)
+  --spectate-thoughts FILE  (with --spectate-mcp) stream the agent's own words into the thought ribbon from a JSONL
+                            file it writes (e.g. claude -p --output-format stream-json); display only, scrubbed
   --agent-paper MANDATE_ID  (experimental, with --spectate-mcp) let that MCP agent PAPER-trade inside a mandate you
                             armed: simulated fills only, never signs or sends, never raises a cap; Ctrl+P / Ctrl+K /
                             any key also pause, stop or take over its paper trading
@@ -419,7 +440,7 @@ export function parseArgs(argv) {
         sound: false,
         trade: [], live: true,
         workspace: null, priceMode: null,
-        spectateMcp: false, agentPaper: null,
+        spectateMcp: false, spectateThoughts: null, agentPaper: null,
         help: false, version: false, unknown: [],
     };
     for (let i = 0; i < argv.length; i++) {
@@ -611,6 +632,8 @@ export function parseArgs(argv) {
         // task-1421: follow an agent driving over MCP (the running terminal moves with it; a read-only stream opens).
         else if (k === '--spectate-mcp')
             a.spectateMcp = true;
+        else if (k === '--spectate-thoughts')
+            a.spectateThoughts = str();
         // task-1443: agent PAPER trading inside a mandate the user armed (validated against the plans journal at start).
         else if (k === '--agent-paper') {
             const s = str();
@@ -655,6 +678,8 @@ export function parseArgs(argv) {
         throw new Error('--scan needs live data or a recording (drop --fixtures)');
     if (a.scan && a.screen)
         throw new Error('--scan is interactive (drop --screen)');
+    if (a.spectateThoughts && !a.spectateMcp)
+        throw new Error('--spectate-thoughts needs --spectate-mcp (the thought ribbon is part of the follow view)');
     if (a.agentPaper && !a.spectateMcp)
         throw new Error('--agent-paper needs --spectate-mcp (every agent paper trade must be visible in this terminal)');
     if (a.agentPaper && a.db === ':memory:')
@@ -1127,6 +1152,7 @@ export async function main(argv, io = process, proc = process) {
         for (const e of state.custom.themeErrors)
             io.stderr.write(`dexterm: ${e}\n`);
         state.priceMode = args.priceMode ?? configPriceMode(state.custom.config); // task-1366: --price-mode wins for the run
+        state.chartAxis = configChartAxis(state.custom.config); // task-1472: default MARKET CAP, `A` toggles + saves
         if (args.workspace) {
             const r = switchWorkspace(state, args.workspace, []);
             if (!r.ok) {
@@ -2471,6 +2497,9 @@ export function applyAction(state, action, stack) {
         case 'display.priceMode':
             state.pendingToast = togglePriceMode(state);
             break; // task-1366: display only, persisted
+        case 'display.chartAxis':
+            state.pendingToast = setChartAxis(state);
+            break; // task-1472: both charts' Y axis, display only, persisted
         case 'theme.next':
             state.theme = state.custom ? cycleTheme(state.custom, state.theme) : nextTheme(state.theme);
             break; // task-1358: user themes join the cycle
@@ -2634,6 +2663,7 @@ export function scanCommand(state, cmd, stack, now = Date.now()) {
             if (!e.start(now))
                 return `AI scan is already on (${MODE_LABEL[e.mode]})`;
             live.scanMeter = scanMeterOf(e, now);
+            scanLog(scan, now, 'start', '', `scan on · observe-only · locks at score ≥ ${e.cfg.minScore} · liquidity ≥ $${Math.round(e.cfg.minLiqUsd / 1000)}K`);
             return `AI scan ON · observe-only · warming up ${e.cfg.warmupS}s · locks at score ≥ ${e.cfg.minScore} · ai ≤ ${e.cfg.maxAiPerHour}/h · Z stop`;
         case 'off': {
             if (!e.on)
@@ -2641,6 +2671,7 @@ export function scanCommand(state, cmd, stack, now = Date.now()) {
             stopTurn();
             const was = e.lock?.symbol;
             e.stop(now);
+            scanLog(scan, now, 'stop', was ?? '', was ? 'scan stopped · released' : 'scan stopped');
             live.scanMeter = null;
             scan.returnTo = null;
             return `AI scan stopped${was ? ` (released ${sym(was)})` : ''}`;
@@ -2653,6 +2684,7 @@ export function scanCommand(state, cmd, stack, now = Date.now()) {
             const locked = e.lock;
             stopTurn();
             e.resume(now);
+            scanLog(scan, now, 'release', locked?.symbol ?? '', `released · cooling down ${Math.round(e.cfg.coinCooldownS / 60)}m · watching for the next coin`);
             live.scanMeter = scanMeterOf(e, now);
             // back from the coin the lock pulled up to where the user was, so the ticker is in view
             if (locked && state.screen === 'token' && live.token?.view.mint === locked.mint)
@@ -2995,6 +3027,61 @@ export function applyAnalystAction(state, raw, stack) {
     times.push(now);
     return { ok: true, label: res.label };
 }
+/**
+ * task-1466: the price this terminal itself shows for a coin, to mark the followed agent's open PAPER position (the
+ * HUD's live PnL): the open token's push price (LIVE) or polled price, else the screener row's price. null if the
+ * terminal has no price for it. Never the agent's own number.
+ */
+export function markPriceFor(state, mint) {
+    const live = state.live;
+    if (live?.token?.view.mint === mint) {
+        const px = (live.badgeFor(mint) === 'LIVE' ? live.livePrice(mint) : null) ?? live.token.view.price;
+        if (typeof px === 'number' && Number.isFinite(px) && px > 0)
+            return px;
+    }
+    const row = state.screener.rows.find((r) => r.mint === mint);
+    if (row && typeof row.price === 'number' && Number.isFinite(row.price) && row.price > 0)
+        return row.price;
+    // task-1473: the held coin scrolled out of the list (run25): its fast-lane push price (the held mint is pinned there)
+    const fast = live?.livePrice(mint) ?? null;
+    return typeof fast === 'number' && Number.isFinite(fast) && fast > 0 ? fast : null;
+}
+let ownOpenedMemo = null;
+/**
+ * task-1473 r2: the user's OWN held position for the AI-scan PnL chip, marked with this terminal's own price (same
+ * task-1323 position row the token screen uses): the scan's locked coin when held, else the open token, else the
+ * first open mint (live first). null when flat. Reads the ledgers only (memoised); never trades, sizes or signs.
+ */
+export function ownHeldSample(state, now) {
+    const live = state.live;
+    if (!live)
+        return null;
+    const src = live.positionSource;
+    const open = src.openMints();
+    if (open.length === 0)
+        return null;
+    const prefer = [state.scan?.engine.lock?.mint, live.token?.view.mint].filter((m) => !!m);
+    const mint = prefer.find((m) => open.includes(m)) ?? open[0];
+    const held = src.held(mint);
+    if (!held)
+        return null;
+    const r = positionRow(held, markPriceFor(state, mint), state.sol?.price ?? src.solUsd());
+    if (!ownOpenedMemo || ownOpenedMemo.mint !== mint || now - ownOpenedMemo.at > 5000) {
+        let t = null;
+        try {
+            t = currentPositionFills([...(live.livePositions?.records(200, mint) ?? []), ...live.wallet.trades(500).filter((x) => x.mint === mint)])[0]?.t ?? null;
+        }
+        catch {
+            t = null;
+        }
+        ownOpenedMemo = { mint, at: now, t };
+    }
+    return {
+        mint, symbol: held.symbol, kind: held.kind === 'live' ? 'live' : 'paper',
+        entryUsd: r.avgEntryUsd, markUsd: r.priceUsd, pnlPct: r.unrealizedPct, pnlUsd: r.unrealizedUsd,
+        openedAt: ownOpenedMemo.t, targetUsd: r.targetUsd,
+    };
+}
 /**
  * task-1421: move the REAL terminal to mirror an agent's navigation (follow mode, on the owner's own
  * machine). This is the same VIEW-ONLY navigation the analyst / go-to path uses — open a token, switch
@@ -3912,6 +3999,7 @@ export function interactive(state, io, depth, args, proc = process) {
         // task-1421: the MCP follow session (set below when `--spectate-mcp` is on). Declared here so the quit /
         // terminal-guard teardown closures can stop it.
         let followSession = null;
+        let lastHudMark = null; // task-1466: the last terminal price that marked the agent's PAPER position
         // task-1443: `--agent-paper <mandate-id>` (with --spectate-mcp) lets that agent PAPER-trade inside the mandate.
         const agentPaper = args.spectateMcp && args.agentPaper ? new AgentPaperSwitch({ env: io.env, mandateId: args.agentPaper, db: args.db ?? defaultDbPath(io.env) }) : null;
         // Idle economy (task-1303, retuned for task-1319 AC3): between events the ambient rain redraws at
@@ -4142,13 +4230,20 @@ export function interactive(state, io, depth, args, proc = process) {
                     }
                     scheduleDraw();
                 },
-                onStatus: (line) => { say(line, 'ai', 4); scheduleDraw(); },
+                // task-1466: the HUD dock says what the agent did; the toast is only the fallback for a terminal too short for it.
+                onStatus: (line) => { if (size()[1] < HUD_MIN_H)
+                    say(line, 'ai', 4); scheduleDraw(); },
                 onEvent: () => scheduleDraw(),
                 onControl: agentPaper ? (st) => agentPaper.control(st) : undefined,
                 snapshot: () => followSnapshot(state),
+                thoughtsFile: args.spectateThoughts ?? undefined,
             });
+            // task-1466 spectator v2: the agent HUD (phase rail, heartbeat, thought ribbon, call timeline, the PAPER
+            // execution moment, pause / kill) draws over this terminal while it follows. Calm mode = reduced motion.
+            state.agentHud = { story: followSession.story, clock: () => Date.now(), dataLabel: args.replay ? 'REPLAY DATA' : null };
             void followSession.start();
-            say('following agents over MCP · ctrl+p pause · ctrl+k stop · any key takes over', 'ai', 6);
+            if (size()[1] < HUD_MIN_H)
+                say('following agents over MCP · ctrl+p pause · ctrl+k stop · any key takes over', 'ai', 6);
             if (agentPaper)
                 say(agentPaper.start(), 'ai', 8);
         }
@@ -4256,6 +4351,7 @@ export function interactive(state, io, depth, args, proc = process) {
                 scan.blocked.push(type);
                 if (scan.blocked.length > 6)
                     scan.blocked.shift();
+                scanLog(scan, Date.now(), 'blocked', scan.engine.lock?.symbol ?? '', `blocked analyst action "${type}" · observe-only`);
             }
             scanSay(`AI scan blocked analyst action "${type}" · observe-only (${error})`, 'warn', 5);
             scheduleDraw();
@@ -4287,6 +4383,7 @@ export function interactive(state, io, depth, args, proc = process) {
                 state.aiFocused = false;
                 state.aiScroll = 0;
                 state.aiRevealAll = false;
+                scanLog(scan, Date.now(), 'lock', d.symbol, `locked · score ${d.score} · ${d.hits.map((h) => h.reason).join(' · ')}`);
                 startScanSession(d.mint, d.symbol, d.question, `AI scan · score ${d.score} · ${d.hits.map((h) => h.id).join(' + ')} → short read`);
                 syncAnalyst(state);
                 live.syncFastSet();
@@ -4304,6 +4401,7 @@ export function interactive(state, io, depth, args, proc = process) {
             const sess = scan.session;
             if (!sess)
                 return;
+            scanLog(scan, Date.now(), 'refresh', d.symbol, `moved: ${d.moved.join(', ')} · refreshing the read`);
             sess.ask(d.question, scanScreenState(state, d.mint, d.symbol), `AI scan refresh · ${d.moved.join(' · ')}`);
             if (state.analyst === sess) {
                 state.aiScroll = 0;
@@ -4342,7 +4440,8 @@ export function interactive(state, io, depth, args, proc = process) {
                 return;
             if (scan.session?.busy)
                 scan.session.interrupt();
-            scan.engine.cancelAnalysis(Date.now());
+            if (scan.engine.cancelAnalysis(Date.now()))
+                scanLog(scan, Date.now(), 'cancel', scan.engine.lock?.symbol ?? '', 'analysis cancelled by you · coin held, nothing else locks');
             if (live)
                 live.scanMeter = scanMeterOf(scan.engine, Date.now());
             scanSay(`analysis cancelled · scan holds $${cleanText(scan.engine.lock?.symbol ?? '', 12)} · R resume scan · Z stop`, 'ai', 5);
@@ -4428,6 +4527,10 @@ export function interactive(state, io, depth, args, proc = process) {
                         solUsd: () => state.sol?.price ?? live.positions.solUsd(),
                         imagePath: (v) => popupImagePath(state, v.image),
                         priceMode: () => priceModeOf(state), // task-1366
+                        chartAxis: () => chartAxisOf(state), // task-1472: the popup's Y axis
+                        setChartAxis: (a) => { say(setChartAxis(state, a), 'info', 3); if (!done)
+                            draw(); }, // task-1472: the popup's MCAP | PRICE control
+                        pnlChip: () => pnlChipFor(state, state.agentHud?.clock() ?? Date.now()), // task-1473 r2: the chip on the chart popup
                     } : null,
                 });
             }
@@ -6199,6 +6302,36 @@ export function interactive(state, io, depth, args, proc = process) {
                     }
                     // market → rain: EMA on activity every tick, mood from the data every 4 s unless an event holds it
                     blendActivity(v, activityFor(state), v.frame % (tickEvery * 8) === 0 && v.frame >= moodHoldUntil);
+                    // task-1466: the agent's open PAPER position is marked with this terminal's own live price (the HUD's PnL).
+                    // Only a NEW price marks (a 10 s-old view price must not overwrite a fresher one a tool result carried).
+                    if (followSession && state.live && state.live.heldMint !== followSession.story.heldMint) {
+                        state.live.heldMint = followSession.story.heldMint;
+                        state.live.syncFastSet();
+                    } // task-1473
+                    if (followSession) {
+                        const held = followSession.story.heldMint;
+                        const px = held ? markPriceFor(state, held) : null;
+                        if (held && px !== null && px !== lastHudMark) {
+                            followSession.story.mark(held, px, Date.now());
+                            lastHudMark = px;
+                        }
+                    }
+                    // task-1473 r2: AI scan mode + the user's OWN held position → the PnL chip (band row, dock, chart popup)
+                    if (state.scan?.engine.on && state.live) {
+                        state.ownPnl ??= new OwnPnlTracker();
+                        state.ownPnl.update(ownHeldSample(state, Date.now()), Date.now());
+                        if (!followSession && state.live.heldMint !== state.ownPnl.mint) {
+                            state.live.heldMint = state.ownPnl.mint;
+                            state.live.syncFastSet();
+                        } // run25: pin it
+                    }
+                    else if (state.ownPnl?.mint) {
+                        state.ownPnl.update(null, 0);
+                        if (!followSession && state.live?.heldMint) {
+                            state.live.heldMint = null;
+                            state.live.syncFastSet();
+                        }
+                    }
                 }
                 if (state.ai && state.ai.phase === 'thinking') {
                     state.ai.ticks += 1;
@@ -6228,6 +6361,7 @@ export function interactive(state, io, depth, args, proc = process) {
                 aiLive: !!(state.ai && state.ai.phase !== 'done'),
                 awake: v.frame < wakeUntil,
                 fxBusy: fxBusy(v),
+                hud: followSession !== null && hudAnimating(followSession.story.view(Date.now()), Date.now()),
                 frame: v.frame,
                 idleEvery,
             }))