dexterm-cli 0.0.0-stage → 0.1.1

package/dist/packages/cli/src/screens/social-panel.js

@@ -0,0 +1,107 @@
+// dexterm — the per-token SOCIAL panel + AI SUMMARY box (task-1330; INTEGRATIONS-DESIGN §5.2, mockups
+// social-panel-{176,120,90}.txt). Drawn by both token renderers (fixture + live) in place of the ON-CHAIN /
+// HOLDERS band when `state.tokenSocial` is on. Every post text here has been through the ingest firewall; the
+// table clips to the cell width, so a post can never overflow its row or carry an escape sequence.
+//
+// Columns by breakpoint (design §5.2): 176 age/src/author/tier/cred/vel/post/♥/⟳/dup/flag · 120 drops
+// tier/vel/⟳/dup · 90 age/author/cred/post/flag.
+import { Canvas, table, badge, breakpoint, mix, wrap, fmtAgeSec } from '../../../tui/src/index.js';
+import { fmtAgeShort, buildSummaryWindow } from '../../../data/src/index.js';
+import { socialOf, panelPosts, hiddenCounts, fmtVelocity, velocityMarks, TIER_LABEL, platformLabel, flagLabel, postText, authorRate, sourcesLine, xBadge } from "../social/view.js";
+export const SUMMARY_BOX_H = 6;
+/** Draw the SOCIAL table + AI SUMMARY into [x, x+w) × [y, y+h). Returns the rows drawn. */
+export function renderSocialPanel(c, x, y, w, h, state, opts) {
+    const t = c.theme;
+    const bp = breakpoint(c.w);
+    const feed = socialOf(state);
+    const { mint, symbol, now } = opts;
+    const sumH = h >= 14 ? SUMMARY_BOX_H : 0;
+    const listH = h - sumH;
+    if (!feed) {
+        const box = c.box(x, y, w, listH, { title: `SOCIAL · $${symbol}`, caption: 'no social feed in this mode' });
+        c.textC(box.x, box.y + 1, box.w, 'social layer needs live or fixture mode', { fg: t.muted, bg: box.bg, i: true });
+        return 0;
+    }
+    const row = feed.trendRows().find((r) => r.mint === mint) ?? null;
+    const posts = panelPosts(state, mint);
+    const hidden = hiddenCounts(feed, mint);
+    const filter = state.socialFilter ?? 'all';
+    const pph = row ? `${row.postsPerHour.toLocaleString('en-US')} posts/1h` : `${posts.length} posts`;
+    const vel = row && row.velocity !== null ? ` (${row.velocity >= 1 ? '▲' : '▼'}${fmtVelocity(row.velocity, row.velocityBasis)} vs 24h mean)` : row ? ' (new)' : '';
+    const kols = row ? ` · ${row.kolCount} KOL${row.kolCount === 1 ? '' : 's'}` : '';
+    const hid = hidden.spam ? ` · ${hidden.spam} hidden as spam` : '';
+    const inj = hidden.injection ? ` · ${hidden.injection} withheld (firewall)` : '';
+    const only = state.socialAuthor ? ` · @${state.socialAuthor} only` : '';
+    const title = `SOCIAL · $${symbol} · ${pph}${vel}${kols}${hid}${inj}${only} · ${xBadge(feed)}`;
+    const cap = `${filter === 'all' ? '' : `filter ${filter} · `}${state.socialShowSpam ? 'x=hide spam' : 'x=show hidden'} · f=filter · K=KOL lists · a=summary`;
+    const box = c.box(x, y, w, listH, { title, caption: cap });
+    const bg = box.bg;
+    const age = (p) => fmtAgeSec(Math.max(0, Math.round((now - p.t) / 1000)));
+    const credOf = (p) => feed.credibilityOfPost(p);
+    const credStyle = (n) => ({ fg: n >= 70 ? t.up : n >= 40 ? t.text : n >= 20 ? t.muted : t.down, bg });
+    const authorFg = (p) => (p.author.tier === 'kol-a' || p.author.tier === 'kol-b' ? t.accent : p.author.tier === 'src' ? t.muted : p.author.tier === 'spam' ? t.down : p.author.tier === 'own' ? t.ai : t.text);
+    const colAge = { key: 'age', label: 'age', w: 4, prio: 0, render: (cv, cx, cy, cw, p, rb) => { cv.text(cx, cy, age(p), { fg: t.dim, bg: rb }, cw); } };
+    const colSrc = { key: 'src', label: 'src', w: 5, prio: 1, render: (cv, cx, cy, cw, p, rb) => { cv.text(cx, cy, platformLabel(p.platform), { fg: p.platform === 'chain' ? t.up : t.muted, bg: rb }, cw); } };
+    const colAuthor = { key: 'author', label: 'author', w: bp === 'compact' ? 13 : 16, prio: 0, render: (cv, cx, cy, cw, p, rb) => { cv.text(cx, cy, p.author.handle, { fg: authorFg(p), bg: rb, b: p.author.tier === 'kol-a' }, cw); } };
+    const colTier = { key: 'tier', label: 'tier', w: 5, prio: 2, render: (cv, cx, cy, cw, p, rb) => { cv.text(cx, cy, TIER_LABEL[p.author.tier], { fg: p.author.tier === 'spam' ? t.down : p.author.tier.startsWith('kol') ? t.accent : t.muted, bg: rb }, cw); } };
+    const colCred = { key: 'cred', label: bp === 'compact' ? 'cr' : 'cred', w: bp === 'compact' ? 3 : 4, align: 'right', prio: 0, render: (cv, cx, cy, cw, p, rb) => { const n = credOf(p); cv.textR(cx, cy, cw, String(n), { ...credStyle(n), bg: rb }); } };
+    const colVel = { key: 'vel', label: 'vel', w: 3, prio: 3, render: (cv, cx, cy, cw, p, rb) => { const n = authorRate(feed, mint, p.author.handle, now); cv.text(cx, cy, n >= 7 ? '▲▲▲' : n >= 4 ? '▲▲' : n >= 2 ? '▲' : '·', { fg: n >= 4 ? t.warn : t.muted, bg: rb }, cw); } };
+    const colPost = { key: 'post', label: bp === 'compact' ? 'post' : 'post (firewalled, truncated)', w: 24, prio: 0, flex: true, render: (cv, cx, cy, cw, p, rb) => {
+            const txt = postText(p);
+            const fg = p.collapsed ? t.dim : p.flags.includes('injection') ? t.down : p.platform === 'chain' ? t.up : p.platform === 'news' ? t.muted : t.text;
+            cv.text(cx, cy, txt, { fg, bg: rb, i: !!p.collapsed }, cw);
+        } };
+    const colLikes = { key: 'likes', label: '♥', w: 4, align: 'right', prio: 1, render: (cv, cx, cy, cw, p, rb) => { cv.textR(cx, cy, cw, p.platform === 'x' || p.platform === 'telegram' || p.platform === 'discord' ? String(p.metrics.likes) : '', { fg: t.muted, bg: rb }); } };
+    const colReposts = { key: 'reposts', label: '⟳', w: 4, align: 'right', prio: 3, render: (cv, cx, cy, cw, p, rb) => { cv.textR(cx, cy, cw, p.platform === 'x' ? String(p.metrics.reposts) : '', { fg: t.muted, bg: rb }); } };
+    const colDup = { key: 'dup', label: 'dup', w: 3, align: 'right', prio: 2, render: (cv, cx, cy, cw, p, rb) => { cv.textR(cx, cy, cw, p.dupCount > 1 ? String(p.dupCount) : '', { fg: t.muted, bg: rb }); } };
+    const colFlag = { key: 'flag', label: bp === 'compact' ? 'fl' : 'flag', w: 5, prio: 0, render: (cv, cx, cy, cw, p, rb) => { const f = flagLabel(p); if (f)
+            badge(cv, cx, cy, f.slice(0, cw), f === 'INJ' || f === 'SPAM' || f === 'SQUAT' ? t.down : t.warn, { on: rb }); } };
+    const cols = bp === 'compact'
+        ? [colAge, colAuthor, colCred, colPost, colFlag]
+        : bp === 'standard'
+            ? [colAge, colSrc, colAuthor, colCred, colPost, colLikes, colFlag]
+            : [colAge, colSrc, colAuthor, colTier, colCred, colVel, colPost, colLikes, colReposts, colDup, colFlag];
+    if (posts.length === 0) {
+        const xs = feed.status();
+        const why = xs.xState === 'logged-out' ? 'x-stream ○ logged out · dexterm x login (your own X app) · keyless sources: news + on-chain rows'
+            : xs.xState === 'ok' ? 'x-stream ● logged in · nothing matched yet (search runs every 60 s for the open token)'
+                : `${xBadge(feed)} · ${xs.xDetail} · keyless sources: news + on-chain rows`;
+        c.textC(box.x, box.y + 1, box.w, `no posts yet · ${why}`, { fg: xs.xState === 'ok' || xs.xState === 'logged-out' ? t.muted : t.warn, bg, i: true });
+        c.text(box.x + 1, box.y, 'age  author  cred  post', { fg: t.dim, bg });
+    }
+    else {
+        table(c, box.x + 1, box.y, box.w - 2, box.h, { columns: cols, rows: posts, selected: -1, bg, zebra: false });
+    }
+    if (sumH)
+        renderSummaryBox(c, x, y + listH, w, sumH, state, feed, opts, row?.mint ?? mint, posts.length);
+    return posts.length;
+}
+function renderSummaryBox(c, x, y, w, h, state, feed, opts, mint, shown) {
+    const t = c.theme;
+    const border = mix(t.border, t.ai, 0.35);
+    const box = c.box(x, y, w, h, { title: '✦ AI SUMMARY', titleFg: t.ai, caption: 'model output, not facts', captionFg: t.dim, border });
+    const bg = box.bg;
+    const label = `✦ analyst · model output, not facts · sources: ${sourcesLine(feed)}`;
+    const win = buildSummaryWindow({ mint, symbol: opts.symbol, posts: feed.postsFor(mint, { includeInjection: true, includeSpam: true, includeHidden: true }), row: null, news: feed.newsFor(mint), ages: feed.ages(), now: opts.now, max: 40 });
+    const cached = state.socialSummaries?.get(mint) ?? null;
+    const lines = [];
+    if (cached) {
+        lines.push(`${label} · ${fmtAgeShort(opts.now - cached.at)} ago`);
+        lines.push(...cached.text.split('\n'));
+    }
+    else {
+        lines.push(label);
+        const withheld = `window: ${win.blocks.length} firewalled block${win.blocks.length === 1 ? '' : 's'} (≤ 40 newest) · withheld ${win.withheld.injection} instruction-like, ${win.withheld.spam} spam, ${win.withheld.squat} squat, ${win.withheld.hidden} near-dupes · ${shown} posts in 24 h`;
+        lines.push(withheld);
+        lines.push(state.live ? 'press  a  to ask the analyst for a ≤4-line read of this window (one claude turn, rate-limited 1 per 2 min); the reply lands in the analyst panel.' : 'fixtures: the analyst summary runs only in live mode (the window above is what it would receive — never the raw posts).');
+    }
+    let cy = box.y;
+    for (const ln of lines) {
+        for (const part of wrap(ln, box.w - 2)) {
+            if (cy >= box.y + box.h)
+                return;
+            c.text(box.x + 1, cy, part, { fg: cy === box.y ? t.ai : t.muted, bg, i: cy !== box.y }, box.w - 2);
+            cy += 1;
+        }
+    }
+}

package/dist/packages/cli/src/screens/ticket.js

@@ -0,0 +1,342 @@
+// dexterm — trade ticket screen (task-1310 T0 PAPER; task-1328 T2 LIVE). PAPER: a simulated buy/sell
+// priced from a live keyless Jupiter quote, every frame labelled PAPER. LIVE: the same ticket in LIVE
+// mode — ⏎ asks the SIGNER PROCESS to quote → build → decode → simulate and shows the PLAN (what will be
+// signed, in/out, impact as a percent, fee, route, the signer's caps verdict); Y is the keypress; the
+// signer then opens Phantom. The banner's network comes from the signer's own status (classified from
+// the RPC it talks to) — never from a flag the UI holds, so the label cannot disagree with the
+// connection. Pure renderer: the state machine + bindings live elsewhere; nothing here signs.
+import { Canvas, badge, header, footer, breakpoint, mix, isCalm, fmtPrice, fmtPriceBare, fmtAmount, fmtPct, } from '../../../tui/src/index.js';
+import { lamportsToSol, rawToTokens } from '../../../data/src/index.js';
+import { headerModel } from "../state.js";
+import { slippageBps, simFailureHint } from "../trade.js";
+function fmtSol(sol, digits = 4) {
+    const a = Math.abs(sol);
+    return `${a.toFixed(digits)} SOL`;
+}
+/**
+ * task-1368 item e: a token quantity for the ticket. `fmtAmount` keeps small amounts (0.0144 AVGOx, never "0");
+ * when the token's decimals are still unknown the number would be a guess, so say that and show the raw units.
+ */
+function tokenAmount(raw, decimals, symbol, decimalsKnown) {
+    if (!decimalsKnown)
+        return `${symbol}: decimals unknown yet (raw ${raw.toString()})`;
+    return `${fmtAmount(rawToTokens(raw, decimals))} ${symbol}`;
+}
+/** Word-wrap `text` into at most `maxLines` lines of `width` columns; the last line is cut with an ellipsis. */
+function wrapLines(text, width, maxLines) {
+    const words = text.split(/\s+/).filter((w) => w.length > 0);
+    const lines = [];
+    let cur = '';
+    for (const w of words) {
+        const next = cur ? `${cur} ${w}` : w;
+        if (next.length <= width) {
+            cur = next;
+            continue;
+        }
+        if (cur)
+            lines.push(cur);
+        cur = w.length > width ? `${w.slice(0, Math.max(1, width - 1))}…` : w;
+        if (lines.length === maxLines)
+            break;
+    }
+    if (cur && lines.length < maxLines)
+        lines.push(cur);
+    if (lines.length > maxLines)
+        lines.length = maxLines;
+    const joined = lines.join(' ');
+    if (joined.length < text.length && lines.length === maxLines) {
+        const last = lines[maxLines - 1];
+        lines[maxLines - 1] = last.length >= width - 1 ? `${last.slice(0, Math.max(1, width - 1))}…` : `${last}…`;
+    }
+    return lines;
+}
+export function renderTicket(c, state) {
+    const t = c.theme;
+    header(c, headerModel(state));
+    const bp = breakpoint(c.w);
+    // Live binding is the source of truth; the seeded demo view backs fixture/one-shot frames.
+    const view = (state.live?.ticket ? state.live.ticket.view() : state.ticket) ?? null;
+    const live = view?.live ?? null;
+    const isLive = !!live;
+    // Always-on banner strip (never hidden, any state). PAPER = warn tint; LIVE = the signer's network.
+    const bannerY = 2;
+    const net = live?.signer?.network ?? null; // the SIGNER's classified network, or unknown
+    const mainnet = net === 'mainnet';
+    const bannerColor = !isLive ? t.warn : mainnet ? t.down : t.up;
+    c.fill(0, bannerY, c.w, 1, ' ', { bg: mix(t.bg, bannerColor, mainnet ? 0.3 : 0.16) });
+    const banner = !isLive
+        ? ' ◈ PAPER TRADING — simulated · no real orders · no keys · no signing '
+        : net === null
+            ? ' ◉ LIVE — signer not reachable · nothing can be signed '
+            : mainnet
+                ? ` ⚠ LIVE · MAINNET — REAL FUNDS · caps $${live?.signer?.caps.perTradeUsd ?? '?'}/trade $${live?.signer?.caps.dailyUsd ?? '?'}/day · Phantom signs · dexterm holds no key `
+                : ` ◉ LIVE · DEVNET — real signing via Phantom · devnet funds only · dexterm holds no key `;
+    c.text(2, bannerY, banner, { fg: bannerColor, bg: mix(t.bg, bannerColor, mainnet ? 0.3 : 0.16), b: true });
+    const linked = state.live?.linkedWallet;
+    if (linked)
+        c.textR(2, bannerY, c.w - 3, `linked: ${linked.publicKey.slice(0, 4)}…${linked.publicKey.slice(-4)} `, { fg: t.muted, bg: mix(t.bg, bannerColor, mainnet ? 0.3 : 0.16) });
+    c.noRain(0, bannerY, c.w, 1);
+    if (live && (live.signer?.panic || live.signer?.ledgerLocked)) {
+        c.fill(0, bannerY + 1, c.w, 1, ' ', { bg: mix(t.bg, t.down, 0.3) });
+        c.text(2, bannerY + 1, ' ⛔ PANIC — live signing is disabled · re-enable only from a shell: dexterm wallet resume ', { fg: t.down, bg: mix(t.bg, t.down, 0.3), b: true });
+        c.noRain(0, bannerY + 1, c.w, 1);
+    }
+    if (!view) {
+        c.text(2, 4, 'Open a trade ticket from a token screen:  B buy · S sell   (L on the ticket flips PAPER ⇄ LIVE)', { fg: t.muted, bg: t.bg });
+        footer(c, [['esc', 'back'], ['P', 'positions'], ['q', 'quit']], t.name, isCalm(state.vfx));
+        return;
+    }
+    const ts = view.ticket;
+    const buy = ts.side === 'buy';
+    const sideColor = buy ? t.up : t.down;
+    const top = 4;
+    const w = Math.min(bp === 'compact' ? c.w - 2 : 78, c.w - 2);
+    const x0 = 1;
+    const h = c.h - top - 1;
+    const title = isLive ? `◉ LIVE ${live?.probe ? 'DEVNET PROBE' : `${ts.side.toUpperCase()} TICKET`}` : `◈ PAPER ${ts.side.toUpperCase()} TICKET`;
+    const caption = isLive ? `signer process · jupiter quote · phantom signs${net ? ` · ${net}` : ''}` : 'jupiter keyless quote · paper fill';
+    // task-1340: the ticket is PLAIN by construction — no heading (no chromatic split on its title) and every cell of
+    // its rect is shielded below, so no effect pass (rain, mosh, shake, scanlines, trade moments) can write a glyph, a
+    // colour or a background into it in any phase. The banner rows above it are shielded too.
+    const box = c.box(x0, top, w, h, { title, titleFg: isLive && mainnet ? t.down : sideColor, caption, captionFg: t.dim, border: mix(t.border, isLive && mainnet ? t.down : sideColor, 0.5), plain: true });
+    c.shieldRect(x0, top, w, h);
+    c.shieldRect(0, bannerY, c.w, 2);
+    const bg = box.bg;
+    const ix = box.x + 2;
+    const iw = box.w - 4;
+    let y = box.y + 1;
+    // identity + side toggle
+    let x = c.text(ix, y, `$${ts.symbol}`, { fg: t.borderFocus, bg, b: true });
+    x = c.text(x + 1, y, `${ts.mint.slice(0, 4)}…${ts.mint.slice(-4)}`, { fg: t.dim, bg });
+    x = badge(c, x + 2, y, buy ? '▲ BUY' : '▼ SELL', sideColor, { on: bg, bold: true }) + 1;
+    x = badge(c, x + 1, y, isLive ? 'LIVE' : 'PAPER', isLive ? (mainnet ? t.down : t.up) : t.warn, { on: bg, bold: true }) + 1;
+    c.textR(ix, y, iw, ts.phase === 'editing' ? '← → flip side · L paper⇄live' : '', { fg: t.dim, bg });
+    y += 2;
+    // size field
+    if (!live?.probe) {
+        const sizeUnit = buy ? (ts.sizeUnit === 'sol' ? 'SOL' : '% of balance') : '% of position';
+        field(c, ix, y, iw, bg, 'Size', `${ts.sizeInput || '—'} ${sizeUnit}`, ts.field === 'size' && ts.phase === 'editing', t);
+        y += 1;
+        field(c, ix, y, iw, bg, 'Slippage', `${slippageBps(ts)} bps`, ts.field === 'slippage' && ts.phase === 'editing', t);
+        y += 2;
+    }
+    const showPlan = isLive && live && live.plan && (ts.phase === 'plan' || ts.phase === 'signing' || ts.phase === 'filled' || ts.phase === 'refused' || ts.phase === 'error');
+    if (showPlan && live?.plan) {
+        y = renderPlan(c, ix, y, iw, bg, live, ts.decimals, ts.symbol, buy, state.now.getTime());
+    }
+    else {
+        // quote block (paper warm quote; LIVE editing shows the same keyless quote as a preview)
+        c.text(ix, y, isLive ? 'PREVIEW QUOTE (keyless; the signer re-quotes on ⏎)' : 'QUOTE', { fg: t.dim, bg });
+        c.textR(ix, y, iw, view.loading ? '· fetching…' : view.quote ? `· ${Math.max(0, Math.round((view.quoteAgeMs ?? 0) / 1000))}s ago` : view.error ? '· unavailable' : '', { fg: view.error ? t.down : t.dim, bg });
+        c.hline(box.x + 1, y + 1, box.w - 2, { fg: t.border, bg, soft: true });
+        y += 2;
+        const q = view.quote;
+        const preview = view.preview;
+        const decimalsKnown = view.decimalsKnown !== false;
+        if (q && preview) {
+            const tokenAbs = buy ? preview.tokenDelta : -preview.tokenDelta;
+            const spend = buy ? `${fmtSol(lamportsToSol(-preview.solDelta))}` : tokenAmount(tokenAbs, ts.decimals, ts.symbol, decimalsKnown);
+            const recv = buy ? tokenAmount(tokenAbs, ts.decimals, ts.symbol, decimalsKnown) : `${fmtSol(lamportsToSol(preview.solDelta))}`;
+            kv(c, ix, y++, iw, bg, 'You pay', spend, t, buy ? t.down : t.text);
+            kv(c, ix, y++, iw, bg, 'You receive', recv, t, buy && !decimalsKnown ? t.warn : t.up);
+            kv(c, ix, y++, iw, bg, 'Price', decimalsKnown ? `${fmtPriceBare(preview.priceSol)} SOL${preview.priceUsd !== null ? `  ·  ${fmtPrice(preview.priceUsd)}` : ''}` : 'per-token price needs the decimals', t, decimalsKnown ? t.text : t.warn);
+            const impact = preview.priceImpactPct;
+            kv(c, ix, y++, iw, bg, 'Price impact', impact === null ? '—' : fmtPct(impact, { sign: false }), t, impact !== null && impact > 5 ? t.down : impact !== null && impact > 1 ? t.warn : t.muted);
+            kv(c, ix, y++, iw, bg, 'Min received', buy ? tokenAmount(q.otherAmountThreshold, ts.decimals, ts.symbol, decimalsKnown) : fmtSol(lamportsToSol(q.otherAmountThreshold)), t, t.muted);
+            kv(c, ix, y++, iw, bg, isLive ? 'Est. fee' : 'Sim fee', fmtSol(lamportsToSol(preview.feeLamports), 6), t, t.muted);
+            kv(c, ix, y++, iw, bg, 'Route', q.route.length ? q.route.join(' → ') : 'direct', t, t.accent);
+        }
+        else if (view.error) {
+            c.text(ix, y++, `⚠ ${view.error}`, { fg: t.down, bg }, iw);
+        }
+        else if (live?.probe) {
+            c.text(ix, y++, 'wrap 0.001 SOL into your own WSOL account, sync, memo, close it back — fees only', { fg: t.dim, bg }, iw);
+        }
+        else {
+            c.text(ix, y++, view.loading ? 'fetching a live quote…' : 'enter a size to see a quote', { fg: t.dim, bg }, iw);
+        }
+        // task-1368 items b + c: BEFORE ⏎ on a LIVE ticket — the size in USD against the signer's caps (red when the
+        // signer would refuse it, with the size that fits), and the devnet-cannot-fill-mainnet-tokens line.
+        if (isLive && live && !live.probe && ts.phase === 'editing') {
+            const pf = live.preflight ?? null;
+            if (pf) {
+                const color = pf.over ? t.down : pf.sizeUsd === null && pf.sizeSol > 0 ? t.warn : t.muted;
+                for (const line of wrapLines(`${pf.over ? '✗ ' : ''}${pf.line}`, iw, 2))
+                    c.text(ix, y++, line, { fg: color, bg, b: pf.over }, iw);
+            }
+            if (live.devnetWarning)
+                for (const line of wrapLines(`⚠ ${live.devnetWarning}`, iw, 2))
+                    c.text(ix, y++, line, { fg: t.warn, bg, b: true }, iw);
+        }
+        y += 1;
+    }
+    // wallet line
+    c.hline(box.x + 1, y, box.w - 2, { fg: t.border, bg, soft: true });
+    y += 1;
+    if (isLive) {
+        kv(c, ix, y++, iw, bg, 'Signer', live?.signer ? `${live.signer.network.toUpperCase()} · ${live.signer.rpcHost} · pid ${live.signer.pid}` : (live?.error ?? 'not reachable'), t, live?.signer ? t.text : t.down);
+        if (live?.signer)
+            kv(c, ix, y++, iw, bg, 'Caps', `$${live.signer.caps.perTradeUsd}/trade · $${live.signer.caps.dailyUsd}/day · spent $${live.signer.spentTodayUsd.toFixed(2)} · impact ≤ ${live.signer.caps.maxPriceImpactPct}% · ≤ ${live.signer.caps.maxSolOut} SOL out`, t, t.muted);
+        kv(c, ix, y++, iw, bg, 'Wallet', live?.linked ? `${live.linked} (Phantom signs; dexterm holds no key)` : 'none linked', t, live?.linked ? t.text : t.down);
+    }
+    else {
+        kv(c, ix, y++, iw, bg, 'Paper balance', fmtSol(view.balanceSol), t, t.text);
+    }
+    if (!buy || view.positionTokens > 0)
+        kv(c, ix, y++, iw, bg, `Position`, `${fmtAmount(view.positionTokens)} ${ts.symbol}${isLive ? ' (live ledger)' : ''}`, t, t.muted);
+    y += 1;
+    // gate / receipt region
+    const gy = box.y + box.h - 3;
+    c.hline(box.x, gy - 1, box.w, { fg: mix(t.border, sideColor, 0.5), bg, soft: true });
+    const tint = mix(bg, sideColor, 0.18);
+    if (ts.phase === 'confirm') {
+        c.fill(box.x + 1, gy, box.w - 2, 2, ' ', { bg: tint });
+        if (ts.typebackRequired) {
+            c.text(ix, gy, `⚠ large order — type the size (${ts.sizeInput}) then press Y:`, { fg: t.warn, bg: tint, b: true }, iw);
+            c.text(ix, gy + 1, `▌ ${ts.typeback || ''}`, { fg: t.text, bg: tint, b: true });
+        }
+        else {
+            c.text(ix, gy, `CONFIRM PAPER ${ts.side.toUpperCase()} — press Y   (esc cancels)`, { fg: sideColor, bg: tint, b: true }, iw);
+        }
+        if (ts.message)
+            c.text(ix, gy + 1, ts.message, { fg: t.warn, bg: tint }, iw);
+    }
+    else if (ts.phase === 'planning' && live?.retryAt) {
+        // task-1368: rate limited by Jupiter — the plan is NOT dropped; countdown + r / esc.
+        const left = Math.max(0, Math.ceil((live.retryAt - state.now.getTime()) / 1000));
+        const what = (live.retryMessage ?? 'Jupiter is rate limiting this IP').replace(/; retry in \d+s$/, '');
+        c.fill(box.x + 1, gy, box.w - 2, 2, ' ', { bg: mix(bg, t.warn, 0.18) });
+        c.text(ix, gy, `⚠ ${what}, retrying in ${left}s`, { fg: t.warn, bg: mix(bg, t.warn, 0.18), b: true }, iw);
+        c.text(ix, gy + 1, 'r = retry now · esc = cancel · the plan is kept (nothing was built or signed)', { fg: t.muted, bg: mix(bg, t.warn, 0.18) }, iw);
+    }
+    else if (ts.phase === 'planning') {
+        c.text(ix, gy, 'signer: quote → build → decode → policy → simulate…   (esc cancels)', { fg: t.ai, bg, b: true }, iw);
+    }
+    else if (ts.phase === 'plan' && live?.plan) {
+        const refused = !live.plan.policy.ok || !live.plan.precheck.ok;
+        c.fill(box.x + 1, gy, box.w - 2, 2, ' ', { bg: tint });
+        if (refused) {
+            const v = !live.plan.policy.ok ? live.plan.policy : live.plan.precheck;
+            c.text(ix, gy, `✗ the signer WILL REFUSE this plan: ${v.reason ?? ''} — ${v.message ?? ''}`, { fg: t.down, bg: tint, b: true }, iw);
+            c.text(ix, gy + 1, 'esc back to editing (Y asks anyway and gets the signer\'s refusal)', { fg: t.muted, bg: tint }, iw);
+        }
+        else if (ts.typebackRequired) {
+            c.text(ix, gy, `⚠ large order — type the size (${ts.sizeInput}) then press Y to sign in Phantom:`, { fg: t.warn, bg: tint, b: true }, iw);
+            c.text(ix, gy + 1, `▌ ${ts.typeback || ''}`, { fg: t.text, bg: tint, b: true });
+        }
+        else {
+            c.text(ix, gy, `${mainnet ? '⚠ REAL FUNDS · ' : ''}Y = sign this exact plan in Phantom   (esc cancels · any other key cancels)`, { fg: mainnet ? t.down : sideColor, bg: tint, b: true }, iw);
+            c.text(ix, gy + 1, `the signer re-checks caps, verifies the signed bytes and re-simulates before it submits`, { fg: t.muted, bg: tint }, iw);
+        }
+        if (ts.message)
+            c.text(ix, gy + 1, ts.message, { fg: t.warn, bg: tint }, iw);
+    }
+    else if (ts.phase === 'signing') {
+        c.text(ix, gy, 'approve in Phantom (browser) — the signer verifies, re-simulates and submits…', { fg: t.ai, bg, b: true }, iw);
+        c.text(ix, gy + 1, 'nothing is sent until the signed bytes match the plan', { fg: t.muted, bg }, iw);
+    }
+    else if (ts.phase === 'filling') {
+        const line = view.rateLimited
+            ? '⚠ rate limited by Jupiter — retrying…   (esc cancels)'
+            : 'booking paper fill from a fresh quote…   (esc cancels)';
+        c.text(ix, gy, line, { fg: view.rateLimited ? t.warn : t.ai, bg, b: true }, iw);
+    }
+    else if (ts.phase === 'filled' && isLive && live?.outcome?.kind === 'filled') {
+        const o = live.outcome;
+        const got = live.probe ? `wrap-and-unwrap confirmed · fee ${fmtSol(lamportsToSol(BigInt(o.fill.feeLamports)), 6)}` : `${fmtAmount(rawToTokens(o.fill.side === 'buy' ? BigInt(o.fill.tokenDelta) : -BigInt(o.fill.tokenDelta), o.fill.decimals))} ${o.fill.symbol} @ ${fmtPriceBare(o.fill.priceSol)} SOL`;
+        c.text(ix, gy, `✓ LIVE ${o.network.toUpperCase()} ${live.probe ? 'PROBE' : o.fill.side.toUpperCase()} confirmed — ${got}${o.lighthouseTail ? ` · +${o.lighthouseTail} Lighthouse` : ''}`, { fg: t.up, bg, b: true }, iw);
+        c.text(ix, gy + 1, `sig ${o.signature.slice(0, 12)}…${o.signature.slice(-6)} · esc=back · P=positions`, { fg: t.muted, bg }, iw);
+    }
+    else if (ts.phase === 'filled' && view.receipt) {
+        const r = view.receipt;
+        const got = r.side === 'buy' ? `${fmtAmount(rawToTokens(r.tokenDelta, r.decimals))} ${r.symbol}` : fmtSol(lamportsToSol(r.solDelta));
+        c.text(ix, gy, `✓ PAPER ${r.side.toUpperCase()} filled — ${got} @ ${fmtPriceBare(r.priceSol)} SOL`, { fg: t.up, bg, b: true }, iw);
+        const extra = r.side === 'sell' ? `realized ${r.realizedLamports >= 0n ? '+' : ''}${fmtSol(lamportsToSol(r.realizedLamports))}` : 'cost booked to position';
+        c.text(ix, gy + 1, `${extra} · esc=back to token · P=positions`, { fg: t.muted, bg }, iw);
+    }
+    else if (ts.phase === 'refused') {
+        c.text(ix, gy, `✗ REFUSED by the signer — ${ts.message ?? 'refused'}`, { fg: t.down, bg, b: true }, iw);
+        c.text(ix, gy + 1, 'nothing was signed or sent · esc=back · any key = new ticket', { fg: t.muted, bg }, iw);
+    }
+    else if (ts.phase === 'error') {
+        const unknown = live?.outcome?.kind === 'send-unknown';
+        c.text(ix, gy, `⚠ ${ts.message ?? 'order failed'}`, { fg: t.down, bg, b: true }, iw);
+        c.text(ix, gy + 1, unknown && live?.outcome?.kind === 'send-unknown' ? `sig ${live.outcome.signature.slice(0, 12)}… · DO NOT resend · check the explorer · esc=back` : 'esc=back to token · P=positions', { fg: unknown ? t.warn : t.muted, bg }, iw);
+    }
+    else {
+        c.text(ix, gy, isLive ? `⏎ build the plan in the signer → Y signs in Phantom   ·   gate ${ts.gateOn ? 'ON' : 'off'}` : `⏎ review → Y confirm   ·   gate ${ts.gateOn ? 'ON' : 'off'} (keypress required)`, { fg: t.muted, bg }, iw);
+        if (ts.message)
+            c.text(ix, gy + 1, ts.message, { fg: t.warn, bg }, iw);
+    }
+    const keys = [['⏎', isLive ? 'plan' : 'review'], ['Y', isLive ? 'sign' : 'confirm'], ['L', isLive ? 'paper' : 'live'], ['tab', 'field'], ['←→', 'side'], ['u', 'unit']];
+    if (isLive && buy && ts.phase === 'editing' && !live?.probe)
+        keys.push(['f', 'fit cap']);
+    if (ts.phase === 'planning' && live?.retryAt)
+        keys.push(['r', 'retry now']);
+    keys.push(['esc', 'cancel'], ['P', 'positions']);
+    footer(c, keys, t.name, isCalm(state.vfx));
+}
+/** The PLAN block: everything the signer will sign, from the signer's own view. */
+function renderPlan(c, ix, y, iw, bg, live, decimals, symbol, buy, now) {
+    const t = c.theme;
+    const p = live.plan;
+    const left = Math.max(0, Math.round((p.expiresAt - now) / 1000));
+    c.text(ix, y, `PLAN · ${p.network.toUpperCase()} · ${p.kind === 'probe' ? 'devnet probe' : 'jupiter swap'}`, { fg: p.network === 'mainnet' ? t.down : t.up, bg, b: true });
+    c.textR(ix, y, iw, `expires in ${left}s · ${p.hash.slice(0, 8)}`, { fg: left < 15 ? t.warn : t.dim, bg });
+    c.hline(ix - 1, y + 1, iw + 2, { fg: t.border, bg, soft: true });
+    y += 2;
+    const inRaw = BigInt(p.amountInRaw), outRaw = BigInt(p.amountOutRaw), minRaw = BigInt(p.minOutRaw);
+    if (p.kind === 'probe') {
+        kv(c, ix, y++, iw, bg, 'Wraps', `${fmtSol(lamportsToSol(inRaw))} → your own WSOL account → back to you`, t, t.text);
+    }
+    else {
+        // The plan's decimals are the ones the order was built with (the signer echoes them back).
+        const pay = buy ? fmtSol(lamportsToSol(inRaw)) : `${fmtAmount(rawToTokens(inRaw, p.decimals ?? decimals))} ${symbol}`;
+        const recv = buy ? `${fmtAmount(rawToTokens(outRaw, p.decimals ?? decimals))} ${symbol}` : fmtSol(lamportsToSol(outRaw));
+        const min = buy ? `${fmtAmount(rawToTokens(minRaw, p.decimals ?? decimals))} ${symbol}` : fmtSol(lamportsToSol(minRaw));
+        kv(c, ix, y++, iw, bg, 'You pay', pay, t, buy ? t.down : t.text);
+        kv(c, ix, y++, iw, bg, 'You receive', recv, t, t.up);
+        kv(c, ix, y++, iw, bg, 'Min received', `${min} (${p.slippageBps} bps slippage)`, t, t.muted);
+        const impact = p.priceImpactPct;
+        kv(c, ix, y++, iw, bg, 'Price impact', impact === null ? 'unknown' : fmtPct(impact, { sign: false }), t, impact !== null && impact > 3 ? t.down : impact !== null && impact > 1 ? t.warn : t.muted);
+        kv(c, ix, y++, iw, bg, 'Route', p.route.length ? p.route.join(' → ') : 'direct', t, t.accent);
+    }
+    kv(c, ix, y++, iw, bg, 'Fee', `${fmtSol(lamportsToSol(BigInt(p.feeLamports)), 6)}${p.prioritizationFeeLamports ? ` (incl. ${p.prioritizationFeeLamports} lamports priority)` : ''}`, t, t.muted);
+    kv(c, ix, y++, iw, bg, 'Notional', p.notionalUsd !== null ? `$${p.notionalUsd.toFixed(2)} (SOL $${p.solUsd.price?.toFixed(2) ?? '?'} via ${p.solUsd.sources?.join('+') ?? '?'})` : (p.network === 'mainnet' ? `unpriced — ${p.solUsd.reason ?? ''}` : 'devnet (no USD value)'), t, p.notionalUsd === null && p.network === 'mainnet' ? t.down : t.muted);
+    if (!p.sim.ran || p.sim.ok) {
+        kv(c, ix, y++, iw, bg, 'Simulation', !p.sim.ran ? 'not run' : `ok · ${p.sim.solOutLamports !== null ? `${fmtSol(lamportsToSol(BigInt(p.sim.solOutLamports)), 6)} leaves the wallet` : 'wallet delta unknown'}`, t, p.sim.ok ? t.up : t.down);
+    }
+    else {
+        // task-1368 item f: the FULL RPC error, wrapped (it used to be cut to `invalid transaction: Tr…`), then the hint.
+        kv(c, ix, y++, iw, bg, 'Simulation', 'FAILED', t, t.down);
+        for (const line of wrapLines(p.sim.error ?? 'unknown error', iw - 2, 3))
+            c.text(ix + 2, y++, line, { fg: t.down, bg }, iw - 2);
+        const hint = simFailureHint(p, live.signer ? { perTradeUsd: live.signer.caps.perTradeUsd, dailyUsd: live.signer.caps.dailyUsd } : undefined);
+        if (hint)
+            for (const line of wrapLines(`↳ ${hint}`, iw - 2, 4))
+                c.text(ix + 2, y++, line, { fg: t.warn, bg }, iw - 2);
+    }
+    const ins = p.instructions.map((i) => `${i.program}${i.op ? `:${i.op}` : ''}`).join(' · ');
+    kv(c, ix, y++, iw, bg, 'Will sign', ins || '—', t, t.text);
+    kv(c, ix, y++, iw, bg, 'Policy', p.policy.ok ? 'swap shape ok · route bound to this plan · no fee account' : `REFUSE ${p.policy.reason}: ${p.policy.message}`, t, p.policy.ok ? t.up : t.down);
+    kv(c, ix, y++, iw, bg, 'Caps', p.precheck.ok ? 'within caps' : `REFUSE ${p.precheck.reason}: ${p.precheck.message}`, t, p.precheck.ok ? t.up : t.down);
+    return y + 1;
+}
+function field(c, x, y, w, bg, label, value, active, t) {
+    const lblW = 10;
+    c.text(x, y, label, { fg: t.dim, bg });
+    const vx = x + lblW;
+    if (active) {
+        c.fill(vx - 1, y, w - lblW + 1, 1, ' ', { bg: mix(t.bg, t.accent, 0.16) });
+        c.text(vx, y, value, { fg: t.text, bg: mix(t.bg, t.accent, 0.16), b: true });
+        c.put(vx - 1, y, '▌', { fg: t.accent, bg });
+    }
+    else {
+        c.text(vx, y, value, { fg: t.text, bg });
+    }
+}
+function kv(c, x, y, w, bg, label, value, t, valColor) {
+    const v = value.length > w - 14 ? value.slice(0, Math.max(1, w - 15)) + '…' : value;
+    c.text(x, y, label, { fg: t.muted, bg }, Math.max(0, w - v.length - 1));
+    c.textR(x, y, w, v, { fg: valColor, bg });
+}