dexterm-cli 0.1.5 → 0.1.6

package/dist/packages/popup/src/pages/chart-lib.js

@@ -180,22 +180,43 @@
     if (a >= 1e3) return `${s}$${(a / 1e3).toFixed(1)}K`;
     return `${s}$${a.toFixed(0)}`;
   }
-  // ---- task-1366 market cap (mirrors @dexterm/tui fmtMcapBare: K/M/B/T, ≤ 3 significant digits, never 1000K)
-  const MC_UNITS = ['', 'K', 'M', 'B', 'T'];
-  function fmtMcapAxis(n) {
+  // ---- task-1472 the one chart number formatter (mirrors @dexterm/tui fmtCompact, parity-tested): lowercase k, then
+  // M/B/T; one decimal while < 10 of the unit, none after; the unit is promoted after rounding (999 900 → 1M); below 1
+  // the subscript price form (0.0₅493): never scientific notation. `extra` (0..3) keeps two axis ticks apart.
+  const CU = ['', 'k', 'M', 'B', 'T'];
+  const trimZeros = (t) => (t.includes('.') ? t.replace(/0+$/, '').replace(/\.$/, '') : t);
+  function tinyBare(p) {
+    if (p >= 0.01) return p.toFixed(4);
+    const m = p.toFixed(12).match(/^0\.(0*)(\d+)/);
+    if (!m) return String(p);
+    const zeros = m[1].length;
+    const digits = m[2].replace(/0+$/, '').slice(0, 4) || '0';
+    if (zeros < 3) return `0.${m[1]}${digits}`;
+    return `0.0${String(zeros).split('').map((c) => SUB[Number(c)]).join('')}${digits}`;
+  }
+  function fmtCompact(n, extra = 0) {
     if (!fin(n)) return '—';
+    if (n === 0) return '0';
     const sign = n < 0 ? '-' : '';
-    let a = Math.abs(n);
-    if (a === 0) return '0';
-    if (a < 1) return sign + String(Number(a.toPrecision(2)));
-    let u = 0;
-    while (u < MC_UNITS.length - 1 && a >= 1000) { a /= 1000; u++; }
-    let r = Number(a.toPrecision(3));
-    if (r >= 1000 && u < MC_UNITS.length - 1) { r = Number((r / 1000).toPrecision(3)); u++; }
-    return `${sign}${r >= 1000 ? String(Math.round(r)) : String(r)}${MC_UNITS[u]}`;
+    const a = Math.abs(n);
+    if (a < 1) return sign + trimZeros(tinyBare(a));
+    const x = Math.max(0, Math.min(3, Math.floor(extra) || 0));
+    const round = (q) => Number(q.toFixed((q < 10 ? 1 : 0) + x));
+    let u = 0, v = a;
+    while (u < CU.length - 1 && v >= 1000) { v /= 1000; u++; }
+    let r = round(v);
+    if (r >= 1000 && u < CU.length - 1) { u++; r = round(r / 1000); }
+    return `${sign}${trimZeros(r.toFixed((r < 10 ? 1 : 0) + x))}${CU[u]}`;
+  }
+  /** `$4.9k`, `-$1.2k` (volume pane, legend volume). */
+  function fmtCompactUsd(n, extra = 0) {
+    const b = fmtCompact(n, extra);
+    return b === '—' ? b : b.startsWith('-') ? `-$${b.slice(1)}` : `$${b}`;
   }
+  /** task-1366 name kept: the mcap axis label is now the compact formatter. */
+  const fmtMcapAxis = (n) => fmtCompact(n);
   const MCAP_LABEL = 'mcap (current supply)';
-  const MCAP_FALLBACK = 'supply unknown · showing price';
+  const MCAP_FALLBACK = 'price (mcap unavailable)'; // task-1472: the card's wording (was 'supply unknown · showing price')
   /**
    * How the page shows numbers for a VM: `mcap` (with the supply multiplier) only when the terminal is in mcap mode AND
    * sent a usable supply; mcap mode without one is `price` + a visible note. Never invents a supply.
@@ -207,7 +228,7 @@
     if (supply) return { mode: 'mcap', supply, label: MCAP_LABEL, key: `mcap:${Number(supply.toPrecision(4))}` };
     return { mode: 'price', supply: null, label: wantMcap ? MCAP_FALLBACK : null, key: wantMcap ? 'price:fallback' : 'price' };
   }
-  /** The Y-axis / crosshair label formatter for a display: mcap = price × supply in K/M/B, else the price label. */
+  /** The Y-axis / crosshair label formatter for a display: mcap = price × supply in compact k/M/B, else the price label. */
   function axisFormatter(d) {
     if (d && d.mode === 'mcap' && fin(d.supply)) { const s = d.supply; return (p) => fmtMcapAxis(p * s); }
     return fmtAxis;
@@ -225,7 +246,7 @@
     const chg = base > 0 ? (bar.close - base) / base : null;
     const f = axisFormatter(display);
     const mc = !!display && display.mode === 'mcap';
-    return { o: f(bar.open), h: f(bar.high), l: f(bar.low), c: mc ? `${f(bar.close)} (${fmtPrice(bar.close)})` : f(bar.close), v: fmtUsd(bar.volume), chg: fmtPct(chg), up: bar.close >= bar.open };
+    return { o: f(bar.open), h: f(bar.high), l: f(bar.low), c: mc ? `${f(bar.close)} (${fmtPrice(bar.close)})` : f(bar.close), v: fmtCompactUsd(bar.volume), chg: fmtPct(chg), up: bar.close >= bar.open };
   }
 
   /** Index of the bar at `time` (binary search), or -1. */
@@ -257,6 +278,6 @@
     return bars[i].time + f * (bars[i + 1].time - bars[i].time);
   }
 
-  const api = { setTzOffset, chartTime, INTERVALS, PERIOD_MS, INDICATORS, STYLES, SCALES, toBars, mergeTail, ema, sma, vwap, volumes, barTimeOf, tapeMarkers, fillMarkers, priceFormatFor, fmtPrice, fmtAxis, fmtUsd, fmtPct, fmtSol, legendFor, fmtMcapAxis, displayOf, axisFormatter, MCAP_LABEL, MCAP_FALLBACK, indexOfTime, logicalOf, timeOfLogical };
+  const api = { setTzOffset, chartTime, INTERVALS, PERIOD_MS, INDICATORS, STYLES, SCALES, toBars, mergeTail, ema, sma, vwap, volumes, barTimeOf, tapeMarkers, fillMarkers, priceFormatFor, fmtPrice, fmtAxis, fmtUsd, fmtPct, fmtSol, legendFor, fmtMcapAxis, fmtCompact, fmtCompactUsd, displayOf, axisFormatter, MCAP_LABEL, MCAP_FALLBACK, indexOfTime, logicalOf, timeOfLogical };
   root.DTChart = Object.freeze(api);
 })(typeof window !== 'undefined' ? window : globalThis);

package/dist/packages/popup/src/pages/chart.css

@@ -48,3 +48,12 @@
 /* LWC attribution logo: the library injects this exact rule too (allowed by CSP hash); repeated here so the
    logo stays positioned even if a future build changes its inline style text. */
 a#tv-attr-logo { position: absolute; left: 10px; bottom: 10px; height: 19px; width: 35px; margin: 0; padding: 0; border: 0; z-index: 3; }
+/* task-1473 r2: the persistent POSITION PnL chip (the held coin, which need not be the charted coin). Display only. */
+.pnlchip { display: flex; flex-wrap: nowrap; gap: 0; padding: 2px 10px; font-size: 11px; white-space: nowrap; overflow: hidden; border-bottom: 1px solid var(--border); background: rgba(255,45,240,.07); color: var(--muted); }
+.pnlchip .seg + .seg::before { content: ' │ '; color: var(--border); }
+.pnlchip .head { color: var(--pump); font-weight: 700; }
+.pnlchip .pnl { font-weight: 700; }
+.pnlchip .pnl.up, .pnlchip .peak.up { color: var(--up); } .pnlchip .pnl.down, .pnlchip .peak.down { color: var(--down); }
+.pnlchip .dd { color: var(--warn); }
+.pnlchip .pnl.flash { background: var(--up); color: var(--bg, #000); padding: 0 3px; border-radius: 2px; }
+@media (prefers-reduced-motion: reduce) { .pnlchip .pnl.flash { background: none; color: var(--up); padding: 0; } }

package/dist/packages/popup/src/pages/chart.html

@@ -23,6 +23,8 @@
   <div id="toolbar" class="toolbar">
     <span class="grp" id="tf"></span>
     <span class="sep"></span>
+    <span class="grp" id="axis"></span>
+    <span class="sep"></span>
     <span class="grp" id="styles"></span>
     <span class="sep"></span>
     <span class="grp" id="scales"></span>
@@ -31,6 +33,7 @@
     <span class="sep"></span>
     <span class="grp" id="draws"></span>
   </div>
+  <div id="pnlchip" class="pnlchip" hidden title="position PnL (display only)"></div>
   <div id="banner" class="banner" hidden></div>
   <div class="stage">
     <canvas id="rain"></canvas>
@@ -44,7 +47,7 @@
     <div id="pos-cells" class="pos-cells"></div>
   </div>
   <div id="foot" class="foot">
-    <span class="keys">1–6 tf · c style · a/l/p scale · e ema · w vwap · m vol·ma · v vol · b tape · h/t draw · f fit · esc close</span>
+    <span class="keys">1–6 tf · A/y mcap⇄price · c style · a/l/p scale · e ema · w vwap · m vol·ma · v vol · b tape · h/t draw · f fit · esc close</span>
     <span class="attr" title="TradingView Lightweight Charts v__LWC_VERSION__ (Apache-2.0), self-hosted"><span id="notice">__LWC_NOTICE__</span> · <a id="tv-link" href="https://www.tradingview.com/" target="_blank" rel="noopener noreferrer">https://www.tradingview.com/</a></span>
   </div>
 </div>

package/dist/packages/popup/src/pages/chart.js

@@ -12,6 +12,7 @@
   const $ = (id) => document.getElementById(id);
   const titleEl = $('title'), legendEl = $('legend'), liveEl = $('live'), bannerEl = $('banner'), hintEl = $('hint');
   const posEl = $('pos'), posTitleEl = $('pos-title'), posCapEl = $('pos-cap'), posCellsEl = $('pos-cells');
+  const chipEl = $('pnlchip');
   const imgSlot = $('coin-img-slot');
   const chartEl = $('chart'), drawCv = $('draw'), dctx = drawCv.getContext('2d');
   const STALE_MS = 20_000;
@@ -57,7 +58,7 @@
     if (type === 2) return String(d.getUTCDate());
     return `${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}`;
   }
-  const volFmt = (v) => C.fmtUsd(v);
+  const volFmt = (v) => C.fmtCompactUsd(v); // task-1472: volume stays USD, compact k/M
 
   // ---------------------------------------------------------------- chart + series
   const chart = L.createChart(chartEl, {
@@ -80,7 +81,7 @@
     handleScroll: { mouseWheel: true, pressedMouseMove: true, horzTouchDrag: true, vertTouchDrag: false },
     handleScale: { axisPressedMouseMove: { time: true, price: true }, axisDoubleClickReset: true, mouseWheel: true, pinch: true },
   });
-  // task-1366: the axis formatter follows the terminal's price mode (mcap = price × the current supply, K/M/B)
+  // task-1366/1472: the axis formatter follows the terminal's chart axis (mcap = price × the current supply, compact k/M/B)
   const pricePF = (p) => ({ type: 'custom', formatter: C.axisFormatter(S.display), minMove: C.priceFormatFor(p).minMove });
   // Keep the position levels (entry / stop / target) and the live price in view: autoscale widens to include them
   // when they are within 3× of the last close (a far-away level would squash the candles; its row cell still shows it).
@@ -159,13 +160,16 @@
   DT.onTheme(applyChartTheme);
 
   // ---------------------------------------------------------------- toolbar (buttons built with textContent only)
-  const btns = { tf: new Map(), styles: new Map(), scales: new Map(), inds: new Map(), draws: new Map() };
+  const btns = { tf: new Map(), axis: new Map(), styles: new Map(), scales: new Map(), inds: new Map(), draws: new Map() };
   function mkBtn(group, id, label, title, onClick) {
     const b = document.createElement('button'); b.type = 'button'; b.className = 'tb'; b.textContent = label; b.title = title;
     b.addEventListener('click', (e) => { e.preventDefault(); onClick(); });
     $(group).appendChild(b); btns[group].set(id, b); return b;
   }
   C.INTERVALS.forEach((iv, i) => mkBtn('tf', iv, iv, `timeframe ${iv} (${i + 1})`, () => requestInterval(iv)));
+  // task-1472: MCAP | PRICE asks the terminal to switch (and save) the chart axis; the next VM re-labels the page
+  mkBtn('axis', 'mcap', 'MCAP', 'Y axis: market cap (A / y toggles; saved by the terminal)', () => setAxis('mcap'));
+  mkBtn('axis', 'price', 'PRICE', 'Y axis: USD price (A / y toggles; saved by the terminal)', () => setAxis('price'));
   mkBtn('styles', 'candles', 'candles', 'candlesticks (c cycles)', () => setStyle('candles', true));
   mkBtn('styles', 'line', 'line', 'line (c cycles)', () => setStyle('line', true));
   mkBtn('styles', 'area', 'area', 'area (c cycles)', () => setStyle('area', true));
@@ -183,6 +187,8 @@
   mkBtn('draws', 'x', '✕ clear', 'clear drawings (x; backspace = undo last)', () => clearDrawings());
   function syncToolbar() {
     for (const [iv, b] of btns.tf) { b.classList.toggle('on', iv === S.interval); b.classList.toggle('pending', iv === S.pendingInterval && iv !== S.interval); }
+    const ax = S.vm && S.vm.priceMode === 'mcap' ? 'mcap' : 'price';
+    for (const [k, b] of btns.axis) b.classList.toggle('on', k === ax);
     for (const [k, b] of btns.styles) b.classList.toggle('on', k === S.style);
     for (const [k, b] of btns.scales) b.classList.toggle('on', k === S.scale);
     for (const [k, b] of btns.inds) b.classList.toggle('on', S.ind.has(k));
@@ -196,6 +202,11 @@
     S.pendingInterval = iv; S.reqAt = performance.now(); syncToolbar();
     DT.send({ type: 'event', name: 'chart.interval', payload: { interval: iv } });
   }
+  /** task-1472: ask the terminal for a Y axis; nothing changes here until its next VM carries the new mode. */
+  function setAxis(axis) {
+    if (axis !== 'mcap' && axis !== 'price') return;
+    DT.send({ type: 'event', name: 'chart.axis', payload: { axis } });
+  }
   function setStyle(st, user) {
     if (!C.STYLES.includes(st) || st === S.style) return;
     S.style = st;
@@ -397,6 +408,23 @@
     }
   }
 
+  // task-1473 r2: the POSITION PnL chip (formatted terminal-side; textContent only, display only)
+  function renderChip() {
+    const chip = S.vm && S.vm.chip;
+    if (!chipEl) return;
+    if (!chip || !Array.isArray(chip.segments) || !chip.segments.length) { chipEl.hidden = true; return; }
+    chipEl.hidden = false;
+    while (chipEl.firstChild) chipEl.removeChild(chipEl.firstChild);
+    const tone = ['up', 'down'].includes(chip.tone) ? chip.tone : '';
+    for (const sg of chip.segments.slice(0, 8)) {
+      const id = ['head', 'pnl', 'peak', 'px', 'held', 'dd', 'tp'].includes(sg.id) ? sg.id : 'x';
+      let cls = `seg ${id}`;
+      if (id === 'pnl') cls += ` ${tone}${chip.newPeak ? ' flash' : ''}`;
+      if (id === 'peak') cls += ` ${/^peak −/.test(String(sg.text)) ? 'down' : 'up'}`;
+      chipEl.appendChild(el('span', cls, String(sg.text).slice(0, 48)));
+    }
+  }
+
   // ---------------------------------------------------------------- incoming view models
   function onData(vm) {
     if (!vm || typeof vm !== 'object') return;
@@ -409,7 +437,7 @@
     // task-1366: a mode / supply change re-labels the axis in place (the bars are prices either way)
     const disp = C.displayOf(vm);
     if (disp.key !== S.display.key) { S.display = disp; applyPriceFormat(); }
-    if (tail && (!vm.seriesKey || vm.seriesKey !== S.key)) { S.vm = { ...vm, candles: [] }; renderHeader(); renderPosition(); renderOverlays(); return; }
+    if (tail && (!vm.seriesKey || vm.seriesKey !== S.key)) { S.vm = { ...vm, candles: [] }; renderHeader(); renderPosition(); renderChip(); renderOverlays(); return; }
     const intervalChanged = vm.interval !== S.interval;
     S.interval = vm.interval;
     const answered = S.pendingInterval === vm.interval ? S.reqAt : null;
@@ -425,7 +453,7 @@
       if (intervalChanged || S.key !== prevKey) S.fitNext = true;
       renderFull();
     }
-    renderHeader(); renderLegend(S.hover); renderDataBanner(); renderPosition(); syncToolbar(); renderLive();
+    renderHeader(); renderLegend(S.hover); renderDataBanner(); renderPosition(); renderChip(); syncToolbar(); renderLive();
     // rain mood follows direction (gold on a pump, red-shift on a dump), as in the v1 HUD; chg is in percent
     const dir = vm.chg ? (vm.chg.h24 ?? vm.chg.h1 ?? 0) : 0;
     if (rain) { rain.setMood(dir > 1 ? 'rainPump' : dir < -1 ? 'rainDump' : 'rain'); rain.setActivity(Math.min(1, 0.4 + Math.abs(dir) / 100)); rain.setSources([String(vm.symbol || ''), String(vm.mint || '').slice(0, 6)]); }
@@ -514,6 +542,7 @@
     const n = parseInt(k, 10);
     if (n >= 1 && n <= 6) { requestInterval(C.INTERVALS[n - 1]); return; }
     switch (k) {
+      case 'A': case 'y': setAxis(S.vm && S.vm.priceMode === 'mcap' ? 'price' : 'mcap'); break; // task-1472
       case 'c': setStyle(C.STYLES[(C.STYLES.indexOf(S.style) + 1) % C.STYLES.length], true); break;
       case 'a': setScale('auto', true); break;
       case 'l': setScale(S.scale === 'log' ? 'auto' : 'log', true); break;

package/dist/packages/popup/src/pages/spectator.css

@@ -43,3 +43,48 @@
 .spec-act-age { color: var(--warn); }
 
 .spec-foot-redact { color: var(--up); font-weight: 600; }
+
+/* task-1466 spectator v2: the agent story (phase rail + heartbeat, thought ribbon, call timeline, vetting + PAPER cards) */
+.spec-story { display: flex; flex-direction: column; gap: 8px; margin-bottom: 10px; font: 12px ui-monospace, Menlo, monospace; }
+.spec-rail { display: flex; flex-wrap: wrap; align-items: center; gap: 4px; }
+.spec-heart { width: 10px; height: 10px; border-radius: 50%; background: var(--down); margin-right: 6px; box-shadow: 0 0 8px var(--down); animation: spec-beat 1s infinite ease-out; }
+.spec-heart.still { animation: none; background: var(--warn); box-shadow: none; }
+.spec-heart.dead { animation: none; background: var(--dim); box-shadow: none; }
+@keyframes spec-beat { 0% { transform: scale(1.35); opacity: 1; } 30% { transform: scale(0.9); opacity: 0.7; } 100% { transform: scale(1); opacity: 0.85; } }
+.spec-bpm { color: var(--muted); margin-right: 8px; min-width: 44px; }
+.spec-phase { padding: 2px 8px; border-radius: 4px; color: var(--dim); border: 1px solid transparent; letter-spacing: 0.05em; }
+.spec-phase.done { color: var(--muted); }
+.spec-phase.on { color: #000; background: var(--accent); font-weight: 700; box-shadow: 0 0 12px color-mix(in srgb, var(--accent) 60%, transparent); }
+.spec-phase.on.p-vetting { background: var(--borderFocus); box-shadow: 0 0 12px color-mix(in srgb, var(--borderFocus) 60%, transparent); }
+.spec-phase.on.p-sizing { background: var(--warn); }
+.spec-phase.on.p-executing { background: var(--up); }
+.spec-phase.on.p-holding { background: var(--pump); }
+.spec-phase.on.p-exiting { background: var(--ai, var(--accent)); }
+.spec-sep { color: var(--border); }
+.spec-paper { margin-left: auto; padding: 1px 6px; border-radius: 4px; background: var(--warn); color: #000; font-weight: 700; }
+.spec-ctlstate { padding: 1px 6px; border-radius: 4px; font-weight: 700; color: #000; }
+.spec-ctlstate.paused { background: var(--warn); }
+.spec-ctlstate.takeover { background: var(--accent); }
+.spec-ctlstate.killed { background: var(--down); color: #fff; }
+.spec-ribbon { padding: 6px 8px; border-left: 3px solid var(--ai, var(--accent)); background: color-mix(in srgb, var(--panel) 85%, transparent); color: var(--text); min-height: 1.4em; }
+.spec-ribbon.ours { border-left-color: var(--border); color: var(--muted); font-style: italic; }
+.spec-ribbon-who { color: var(--ai, var(--accent)); margin-right: 6px; font-style: normal; }
+.spec-timeline { display: flex; align-items: flex-start; gap: 0; overflow: hidden; justify-content: flex-end; }
+.spec-node { display: flex; flex-direction: column; align-items: center; gap: 2px; padding: 0 2px; }
+.spec-node-l { color: var(--text); white-space: nowrap; }
+.spec-node.paper .spec-node-l { color: var(--warn); font-weight: 700; }
+.spec-chip { font-size: 10px; padding: 0 5px; border-radius: 3px; background: color-mix(in srgb, var(--up) 18%, transparent); color: var(--up); }
+.spec-chip.slow { background: color-mix(in srgb, var(--warn) 18%, transparent); color: var(--warn); }
+.spec-chip.fail, .spec-chip.refused { background: color-mix(in srgb, var(--down) 22%, transparent); color: var(--down); }
+.spec-link { color: var(--border); align-self: flex-start; margin-top: 1px; }
+.spec-cards { display: flex; flex-wrap: wrap; gap: 8px; }
+.spec-card { flex: 1 1 220px; border: 1px solid var(--border); border-radius: 6px; padding: 6px 8px; background: color-mix(in srgb, var(--panel) 85%, transparent); }
+.spec-card-h { color: #000; background: var(--borderFocus); font-weight: 700; padding: 0 6px; border-radius: 3px; display: inline-block; margin-bottom: 4px; }
+.spec-card.trade .spec-card-h { background: var(--pump); }
+.spec-check { margin-right: 8px; color: var(--dim); }
+.spec-check.ok { color: var(--up); font-weight: 600; }
+.spec-big { font-size: 30px; font-weight: 800; letter-spacing: 0.02em; line-height: 1.1; }
+.spec-big.up { color: var(--up); text-shadow: 0 0 14px color-mix(in srgb, var(--up) 45%, transparent); }
+.spec-big.down { color: var(--down); }
+.spec-kv { color: var(--muted); }
+.spec-kv b { color: var(--text); font-weight: 600; }

package/dist/packages/popup/src/pages/spectator.html

@@ -12,6 +12,7 @@
 <div id="hud" class="hud">
   <div id="drag" class="drag"><span class="mark">✦</span><span id="title" class="title">dexterm · WATCH THE AGENT COOK</span><span id="status" class="status">connecting…</span><button id="close" class="close" type="button" aria-label="close">✕</button></div>
   <div class="stage"><canvas id="rain"></canvas><div class="body">
+    <div id="story" class="spec-story"></div>
     <div id="screen" class="spec-screen"></div>
     <div id="agents" class="spec-agents"></div>
     <div class="spec-activity-head">agent activity</div>

package/dist/packages/popup/src/pages/spectator.js

@@ -14,8 +14,77 @@
 
   let vm = null;
 
+  const pctS = (p) => (p == null ? '—' : `${p >= 0 ? '+' : '−'}${Math.abs(p * 100).toFixed(1)}%`);
+  const px = (n) => (n == null ? '—' : n >= 1 ? `$${n.toFixed(4)}` : `$${Number(n.toPrecision(3))}`);
+  const fmtMs = (ms) => (ms == null ? '·' : ms < 1000 ? `${Math.round(ms)}ms` : `${(ms / 1000).toFixed(1)}s`);
+  const CHECKS = ['price', 'tape', 'chart', 'holders', 'rug', 'dev', 'larp', 'verdict'];
+
+  // task-1466 spectator v2: the agent story above the activity list (textContent only; strings redacted TUI-side).
+  function renderStory(st) {
+    const host = $('story'); host.textContent = '';
+    if (!st) return;
+    const rail = el('div', 'spec-rail');
+    const heart = el('span', 'spec-heart' + (st.control === 'killed' ? ' dead' : st.control !== 'running' ? ' still' : ''));
+    if (st.bpm > 0) heart.style.animationDuration = `${(60 / st.bpm).toFixed(2)}s`;
+    rail.appendChild(heart);
+    rail.appendChild(el('span', 'spec-bpm', st.control === 'killed' ? '— bpm' : `${st.bpm} bpm`));
+    const ai = st.rail.indexOf(st.phase);
+    st.rail.forEach((p, i) => {
+      if (i) rail.appendChild(el('span', 'spec-sep', '─'));
+      const on = i === ai && st.control !== 'killed';
+      rail.appendChild(el('span', 'spec-phase p-' + p + (on ? ' on' : i < ai ? ' done' : ''), (on ? '▸' : '') + p.toUpperCase() + (on && st.sub ? ` · ${st.sub}` : '')));
+    });
+    if (st.control !== 'running') rail.appendChild(el('span', 'spec-ctlstate ' + st.control, st.control === 'killed' ? '■ KILLED' : st.control === 'paused' ? '❚❚ PAUSED' : 'YOU ARE DRIVING'));
+    rail.appendChild(el('span', 'spec-paper', 'PAPER'));
+    host.appendChild(rail);
+    const th = (st.thoughts || []).slice().reverse();
+    const agentT = th.find((x) => x.source === 'agent');
+    const ours = th.find((x) => x.source === 'dexterm');
+    const pick = agentT && (!ours || agentT.t >= ours.t - 1500 || Date.now() - agentT.t < 9000) ? agentT : ours || agentT;
+    const rib = el('div', 'spec-ribbon' + (pick && pick.source === 'dexterm' ? ' ours' : ''));
+    if (pick) { if (pick.source === 'agent') rib.appendChild(el('span', 'spec-ribbon-who', '❯')); rib.appendChild(el('span', '', pick.text)); }
+    else rib.appendChild(el('span', 'spec-dim', 'the agent has not said anything yet'));
+    host.appendChild(rib);
+    const tl = el('div', 'spec-timeline');
+    (st.nodes || []).slice(-14).forEach((n, i) => {
+      if (i) tl.appendChild(el('span', 'spec-link', '──'));
+      const node = el('div', 'spec-node' + (n.paper ? ' paper' : ''));
+      node.appendChild(el('span', 'spec-node-l', `${n.status === 'refused' ? '✗' : n.paper ? '■' : '●'} ${n.label}${n.count > 1 ? ` ×${n.count}` : ''}`));
+      node.appendChild(el('span', 'spec-chip ' + n.status, n.status === 'refused' ? 'refused' : fmtMs(n.ms)));
+      tl.appendChild(node);
+    });
+    host.appendChild(tl);
+    const cards = el('div', 'spec-cards');
+    if (st.focus) {
+      const c = el('div', 'spec-card');
+      c.appendChild(el('span', 'spec-card-h', `VETTING $${st.focus.symbol}`));
+      const row = el('div');
+      for (const k of CHECKS) row.appendChild(el('span', 'spec-check' + (st.focus.checks.includes(k) ? ' ok' : ''), `${st.focus.checks.includes(k) ? '✓' : '·'}${k}`));
+      c.appendChild(row);
+      if (st.focus.larpFlags != null) c.appendChild(el('div', 'spec-kv', `LARP evidence: ${st.focus.larpFlags} flag${st.focus.larpFlags === 1 ? '' : 's'} (not a verdict)`));
+      if (st.focus.verdict) c.appendChild(el('div', 'spec-kv', `verdict ${st.focus.verdict}${st.focus.rug != null ? ` · rug heuristic ${Math.round(st.focus.rug * 100)}%` : ''}`));
+      cards.appendChild(c);
+    }
+    if (st.arc) {
+      const a = st.arc;
+      const c = el('div', 'spec-card trade');
+      c.appendChild(el('span', 'spec-card-h', `PAPER · $${a.symbol} · ${a.stage === 'closed' ? 'RESULT' : a.stage === 'open' ? 'HOLDING' : a.stage === 'refused' ? 'REFUSED' : 'TICKET'}`));
+      const big = a.stage === 'closed' ? a.resultPct : a.pnlPct;
+      if (big != null) c.appendChild(el('div', 'spec-big ' + (big >= 0 ? 'up' : 'down'), pctS(big)));
+      const kv = el('div', 'spec-kv');
+      kv.textContent = [a.sizeUsd != null ? `size $${a.sizeUsd.toFixed(2)}` : null, a.entryUsd != null ? `entry ${px(a.entryUsd)}` : null, a.markUsd != null && a.stage !== 'closed' ? `mark ${px(a.markUsd)}` : null,
+        a.peakPct != null ? `peak ${pctS(a.peakPct)}` : null, a.exits ? `exits ${a.exits}` : null, a.realizedSol != null ? `realized ${a.realizedSol >= 0 ? '+' : ''}${a.realizedSol.toFixed(4)} SOL` : null,
+        a.refusal ? `refused: ${a.refusal}` : null].filter(Boolean).join(' · ');
+      c.appendChild(kv);
+      c.appendChild(el('div', 'spec-dim', 'simulated paper trade · not a result'));
+      cards.appendChild(c);
+    }
+    if (cards.childNodes.length) host.appendChild(cards);
+  }
+
   function render() {
     if (!vm) return;
+    renderStory(vm.story || null);
 
     const scr = $('screen'); scr.textContent = '';
     const s = vm.screen || {};

package/dist/packages/popup/src/protocol.js

@@ -28,4 +28,6 @@ export const CHART_INDICATORS = ['ema9', 'ema21', 'vwap', 'volma', 'volume', 'ta
 export const CHART_STYLES = ['candles', 'line', 'area'];
 /** Price-scale mode: auto (normal, autoscaled), logarithmic, percent (from the first visible bar). */
 export const CHART_SCALES = ['auto', 'log', 'percent'];
+/** task-1472: what the chart's Y axis shows (the popup's MCAP | PRICE control / `A` ask the terminal to switch). */
+export const CHART_AXES = ['mcap', 'price'];
 export const PROTOCOL_VERSION = 'dexterm-popup/1';

package/dist/packages/popup/src/server.js

@@ -26,7 +26,7 @@ import { createHash, randomBytes, timingSafeEqual } from 'node:crypto';
 import { readFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
-import { PROTOCOL_VERSION, CHART_INTERVALS, CHART_INDICATORS, CHART_STYLES, CHART_SCALES, WIDGET_TOPICS, WIDGET_HTML_MAX } from "./protocol.js";
+import { PROTOCOL_VERSION, CHART_INTERVALS, CHART_INDICATORS, CHART_STYLES, CHART_SCALES, CHART_AXES, WIDGET_TOPICS, WIDGET_HTML_MAX } from "./protocol.js";
 import { auditWidgetHtml, inlineHashes, normalizeWidgetHtml } from "./widget-html.js";
 const here = path.dirname(fileURLToPath(import.meta.url));
 const PAGES_DIR = path.join(here, 'pages');
@@ -48,6 +48,8 @@ export const POPUP_EVENTS = new Set([
     'event:popup.close-request', 'event:popup.focus', 'event:popup.drag',
     // task-1325 chart v2 requests (payloads validated by validateEventPayload below)
     'event:chart.interval', 'event:chart.indicator', 'event:chart.style', 'event:chart.scale', 'event:chart.painted',
+    // task-1472: the chart's Y axis (market cap ⇄ price): a display preference the terminal saves, nothing else
+    'event:chart.axis',
     // task-1345 agent roster: per-agent pause / kick, by agent name (the only writes this popup can send)
     'event:roster.pause', 'event:roster.resume', 'event:roster.kick',
     // task-1355 order plans: cancel a plan by id (the ONLY write the plans popup can send — never arm/cap/sign)
@@ -94,6 +96,8 @@ export function validateEventPayload(name, payload) {
             return oneOf(CHART_STYLES, p.style) ? { style: p.style } : null;
         case 'chart.scale':
             return oneOf(CHART_SCALES, p.scale) ? { scale: p.scale } : null;
+        case 'chart.axis':
+            return oneOf(CHART_AXES, p.axis) ? { axis: p.axis } : null;
         case 'chart.painted':
             return (p.kind === 'first' || p.kind === 'data') && finiteIn(p.ms, 0, 600_000) && finiteIn(p.sentAt, 0, 1e15)
                 ? { kind: p.kind, ms: p.ms, sentAt: p.sentAt } : null;

package/dist/packages/recorder/src/dev-history.js

@@ -38,7 +38,7 @@ export function queryDevHistory(db, q) {
         creator: q.creator, status: 'unknown', asOf, source: DEV_HISTORY_SOURCE,
         launches: { n: 0, newestT: null, ageSec: null },
         labelled: { n: 0, rug: 0, dead: 0, fade: 0, flat: 0, runner: 0, horizon: '72h preferred', tier: 'keyless-proxy', newestT: null, ageSec: null },
-        rugRate: null, badRate: null, devExit: { n: 0, medianMin: null, within60m: 0 }, serialRugger: false, recent: [],
+        rugRate: null, badRate: null, devExit: { n: 0, medianMin: null, within60m: 0, newestT: null, ageSec: null }, serialRugger: false, recent: [],
     };
     let links;
     try {
@@ -56,6 +56,7 @@ export function queryDevHistory(db, q) {
     const counts = { rug: 0, dead: 0, fade: 0, flat: 0, runner: 0 };
     let labelledN = 0, labelledNewest = null;
     const exits = [];
+    let exitNewest = null;
     const launches = [];
     for (const l of links) {
         const firstT = Number(l.first_t);
@@ -93,6 +94,7 @@ export function queryDevHistory(db, q) {
                     const from = createdAt ?? Number(series[held].t);
                     devExitMin = Math.max(0, (Number(out.t) - from) / 60_000);
                     exits.push(devExitMin);
+                    exitNewest = Math.max(exitNewest ?? 0, Number(out.t));
                 }
             }
         }
@@ -109,12 +111,14 @@ export function queryDevHistory(db, q) {
         labelled: { ...empty.labelled, n: labelledN, ...counts, newestT: labelledNewest, ageSec: labelledNewest === null ? null : Math.max(0, Math.round((asOf - labelledNewest) / 1000)) },
         rugRate: labelledN ? counts.rug / labelledN : null,
         badRate: labelledN ? (counts.rug + counts.dead) / labelledN : null,
-        devExit: { n: exits.length, medianMin: median(exits), within60m: exits.filter((m) => m <= 60).length },
+        devExit: { n: exits.length, medianMin: median(exits), within60m: exits.filter((m) => m <= 60).length, newestT: exitNewest, ageSec: exitNewest === null ? null : Math.max(0, Math.round((asOf - exitNewest) / 1000)) },
         serialRugger: counts.rug >= SERIAL_RUGGER_MIN,
         recent: launches,
     };
 }
-const ago = (sec) => sec === null ? 'age unknown' : sec < 3600 ? `${Math.max(1, Math.round(sec / 60))}m ago` : sec < 172800 ? `${Math.round(sec / 3600)}h ago` : `${Math.round(sec / 86400)}d ago`;
+/** Compact age for a panel cell: `5m`, `3h`, `40d`; `age ?` when unknown. */
+export const ageShort = (sec) => sec === null ? 'age ?' : sec < 3600 ? `${Math.max(1, Math.round(sec / 60))}m` : sec < 172800 ? `${Math.round(sec / 3600)}h` : `${Math.round(sec / 86400)}d`;
+const ago = (sec) => sec === null ? 'age unknown' : `${ageShort(sec)} ago`;
 /**
  * The one-line summary every surface shows (DEV panel, rug-signal row, MCP note): counts with the sample size and
  * the age, or `unknown` with why. Plain wording: a risk flag from observed history, never "rug confirmed" or "safe".

package/dist/packages/tui/src/canvas.js

@@ -66,6 +66,11 @@ export class Canvas {
      */
     images;
     imageMode;
+    /**
+     * task-1466: where each keyed list row was drawn (a table with `rowKey`, e.g. a screener row by mint), so an
+     * overlay drawn later (the agent HUD's row glow / cursor) can find the row on screen. Not emitted anywhere.
+     */
+    rowMarks;
     constructor(w, h, theme) {
         this.w = w;
         this.h = h;
@@ -82,6 +87,7 @@ export class Canvas {
         this.shields = [];
         this.images = [];
         this.imageMode = 'cells';
+        this.rowMarks = [];
     }
     idx(x, y) { return y * this.w + x; }
     /** Copy every buffer of `src` (same size) into this canvas. */
@@ -97,6 +103,7 @@ export class Canvas {
         this.shields = src.shields.slice();
         this.images = src.images.slice();
         this.imageMode = src.imageMode;
+        this.rowMarks = src.rowMarks.slice();
     }
     put(x, y, ch, st = {}) {
         if (x < 0 || y < 0 || x >= this.w || y >= this.h)

package/dist/packages/tui/src/fmt.js

@@ -119,6 +119,59 @@ export function fmtMcap(n) {
         return bare;
     return bare.startsWith('-') ? `-$${bare.slice(1)}` : `$${bare}`;
 }
+/**
+ * task-1472: THE chart number formatter (Y axis, crosshair/legend, last-value tag, volume): compact with a LOWERCASE k
+ * for thousands, then M, B, T. One decimal while the value is below 10 of its unit, none after, trailing `.0` dropped:
+ * 4930 → 4.9k, 42100 → 42k, 487000 → 487k, 1.23e6 → 1.2M, 4.8e7 → 48M, 1.3e9 → 1.3B, 999 → 999. The unit is promoted
+ * AFTER rounding, so 999 900 reads 1M (never 1000k). Below 1 it is the subscript price form (0.0000123 → 0.0₄123):
+ * never scientific notation, never a long run of zeros. `extra` (0..3) adds decimals when an axis needs them to keep
+ * two neighbouring ticks apart (see compactDecimalsFor). No currency symbol; fmtCompactUsd adds the `$`.
+ */
+export function fmtCompact(n, extra = 0) {
+    if (n == null || !Number.isFinite(n))
+        return '—';
+    if (n === 0)
+        return '0';
+    const sign = n < 0 ? '-' : '';
+    const a = Math.abs(n);
+    if (a < 1)
+        return sign + trimZeros(fmtPriceBare(a));
+    const units = ['', 'k', 'M', 'B', 'T'];
+    const x = Math.max(0, Math.min(3, Math.floor(extra)));
+    const round = (q) => Number(q.toFixed((q < 10 ? 1 : 0) + x));
+    let u = 0, v = a;
+    while (u < units.length - 1 && v >= 1000) {
+        v /= 1000;
+        u++;
+    }
+    let r = round(v);
+    if (r >= 1000 && u < units.length - 1) {
+        u++;
+        r = round(r / 1000);
+    }
+    return `${sign}${trimZeros(r.toFixed((r < 10 ? 1 : 0) + x))}${units[u]}`;
+}
+/** USD form of fmtCompact: `$4.9k`, `$48M`, `-$1.2k`. */
+export function fmtCompactUsd(n, extra = 0) {
+    const bare = fmtCompact(n, extra);
+    if (bare === '—')
+        return bare;
+    return bare.startsWith('-') ? `-$${bare.slice(1)}` : `$${bare}`;
+}
+/**
+ * task-1472: the extra decimals (0..3) fmtCompact needs so that axis ticks `step` apart around `around` never print
+ * the same label (a 48.1M–48.6M range would otherwise read 48M on every tick). 0 for a normal memecoin range.
+ */
+export function compactDecimalsFor(around, step) {
+    if (!Number.isFinite(around) || !Number.isFinite(step) || step <= 0 || Math.abs(around) < 1)
+        return 0;
+    for (let x = 0; x < 3; x++) {
+        const a = fmtCompact(around, x);
+        if (a !== fmtCompact(around + step, x) && a !== fmtCompact(around - step, x))
+            return x;
+    }
+    return 3;
+}
 export function fmtPct(n, { sign = true, digits = 1 } = {}) {
     if (n == null || Number.isNaN(n))
         return '—';

package/dist/packages/tui/src/keymap.js

@@ -268,6 +268,10 @@ export const DEFAULT_KEYMAP = new Keymap([
     // the open coin. (`P` is already the global positions key, so chart uses `C`.) Collision-free with the
     // token screen's other capitals (B/S trade, W/X/T/L links, V vet).
     { keys: ['C'], action: 'popup.chart', label: 'chart popup', screen: 'token' },
+    // task-1472: `A` (axis) on the token screen flips the chart Y axis MARKET CAP ⇄ PRICE (both charts; saved as
+    // display.chartAxis). Free capital on the token screen (A is only auto-mirror on the follows screen); deliberately
+    // not Y, which confirms inside the PAPER ticket and the modals. The chart popup uses the same `A`.
+    { keys: ['A'], action: 'display.chartAxis', label: 'chart axis mcap ⇄ price', screen: 'token' },
     // task-1359: `I` on the token screen opens/toggles the TOKEN-DETAIL HUD (identity, market, risk, snipers/bundled
     // from the wallet-intel scan); `M` on the trending screen opens/toggles the FEEDS HUD (the keyless social feed +
     // official news, newest first; ⏎ in the window opens that coin here). Both are read-only windows. `I` is unused

package/dist/packages/tui/src/widgets.js

@@ -5,7 +5,7 @@
 // background (hard cells); glow is only ever applied to neighbouring blank cells or to bg tints.
 import { Canvas } from "./canvas.js";
 import { mix, luminance } from "./color.js";
-import { fmtUsd, fmtPct, fmtNum, fmtPrice, fmtAgeSec, shortAddr, clamp } from "./fmt.js";
+import { fmtUsd, fmtPct, fmtNum, fmtPrice, fmtPriceBare, fmtCompactUsd, compactDecimalsFor, fmtAgeSec, shortAddr, clamp } from "./fmt.js";
 import { launchpadColor } from "./theme.js";
 export const BLOCKS = '▁▂▃▄▅▆▇█';
 // braille dot bits: column 0 rows 0..3, column 1 rows 0..3 (row 0 = top)
@@ -107,6 +107,7 @@ export function brailleLine(c, x, y, w, h, values, opts = {}) {
                 c.put(x + col, y + r, String.fromCharCode(0x2800 + bits), { fg: neon(color, col / (w - 1), bg), bg, soft: true });
         }
 }
+/** task-1472: the price axis never prints scientific notation: subscript zeros below 0.01 (0.0₅493), like fmtPrice. */
 function fmtPriceAxis(p) {
     if (p >= 1000)
         return p.toFixed(0);
@@ -114,7 +115,7 @@ function fmtPriceAxis(p) {
         return p.toFixed(3);
     if (p >= 0.001)
         return p.toFixed(5);
-    return p.toExponential(2);
+    return fmtPriceBare(p);
 }
 /**
  * Candlestick chart with right-hand price axis, last-price tag, volume strip and time axis.
@@ -137,7 +138,6 @@ export function candleChart(c, x, y, w, h, candles, opts = {}) {
     // task-1366: the bars are laid out in price units either way (identical glyphs); only the labels are scaled
     const s = opts.scale && Number.isFinite(opts.scale) && opts.scale > 0 ? opts.scale : 1;
     const baseFmt = opts.axisFmt ?? fmtPriceAxis;
-    const fmtAxis = s === 1 ? baseFmt : (p) => baseFmt(p * s);
     let lo = Infinity, hi = -Infinity, vmax = 0;
     for (const k of data) {
         lo = Math.min(lo, k.l);
@@ -152,6 +152,9 @@ export function candleChart(c, x, y, w, h, candles, opts = {}) {
     const gridStyle = { fg: mix(bg, t.border, 0.9), bg, soft: true };
     const labelStyle = { fg: t.muted, bg };
     const ticks = Math.max(2, Math.min(6, Math.floor(plotH / 3)));
+    // task-1472: one more decimal only when two neighbouring ticks would otherwise print the same compact label
+    const extra = opts.axisFmt ? compactDecimalsFor(((hi + lo) / 2) * s, (range / ticks) * s) : 0;
+    const fmtAxis = (p) => baseFmt(p * s, extra);
     for (let i = 0; i <= ticks; i++) {
         const row = Math.round((i / ticks) * (plotH - 1));
         const price = hi - (row / (plotH - 1)) * range;
@@ -245,7 +248,7 @@ export function candleChart(c, x, y, w, h, candles, opts = {}) {
             }
         }
         c.text(x + plotW + 1, vy, 'vol', labelStyle);
-        c.text(x + plotW + 1, vy + 1, fmtUsd(last.v, { digits: 1 }), { fg: t.text, bg });
+        c.text(x + plotW + 1, vy + 1, fmtCompactUsd(last.v), { fg: t.text, bg }); // task-1472: volume stays USD, compact k/M
     }
     const ty = y + h - 1;
     const labels = Math.max(2, Math.floor(plotW / 18));
@@ -386,6 +389,8 @@ export function table(c, x, y, w, h, spec) {
         const selected = ri === spec.selected;
         const rowBg = selected ? t.selBg : (r % 2 === 1 && spec.zebra !== false ? mix(bg, t.panelAlt, 1) : bg);
         c.fill(x, ry, w, 1, ' ', { bg: rowBg });
+        if (spec.rowKey)
+            c.rowMarks.push({ key: spec.rowKey(row), x, y: ry, w });
         if (selected)
             c.put(x - 1 >= 0 ? x - 1 : x, ry, '▎', { fg: t.accent, bg: rowBg, soft: true });
         cx = x;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dexterm-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "mcpName": "io.github.dexterm-xyz/dexterm",
   "description": "dexterm: terminal DEX screener with a local Claude CLI analyst",
   "author": "The dexterm authors",