@spfunctions/cli 1.4.3 → 1.4.5

package/dist/commands/agent.js

@@ -67,7 +67,7 @@ const C = {
     zinc800: rgb(39, 39, 42), // #27272a
     red: rgb(239, 68, 68), // #ef4444
     amber: rgb(245, 158, 11), // #f59e0b
-    white: rgb(255, 255, 255),
+    white: rgb(255, 255, 255), // #ffffff
     bgZinc900: bgRgb(24, 24, 27), // #18181b
     bgZinc800: bgRgb(39, 39, 42), // #27272a
 };
@@ -196,18 +196,56 @@ function createHeaderBar(piTui) {
         }
     };
 }
-/** Footer bar: model | tokens | exchange status | trading status | /help */
+/** Combined footer bar: thesis info (line 1) + model/exchange (line 2) */
 function createFooterBar(piTui) {
     const { truncateToWidth, visibleWidth } = piTui;
     return class FooterBar {
+        // Thesis info (was HeaderBar)
+        thesisId = '';
+        confidence = 0;
+        confidenceDelta = 0;
+        pnlDollars = 0;
+        positionCount = 0;
+        edgeCount = 0;
+        topEdge = '';
+        // Model info
         tokens = 0;
         cost = 0;
         toolCount = 0;
         modelName = '';
         tradingEnabled = false;
-        exchangeOpen = null; // null = unknown
+        exchangeOpen = null;
         cachedWidth;
         cachedLines;
+        setFromContext(ctx, positions) {
+            this.thesisId = (ctx.thesisId || '').slice(0, 8);
+            this.confidence = typeof ctx.confidence === 'number'
+                ? Math.round(ctx.confidence * 100)
+                : (typeof ctx.confidence === 'string' ? Math.round(parseFloat(ctx.confidence) * 100) : 0);
+            this.confidenceDelta = ctx.lastEvaluation?.confidenceDelta
+                ? Math.round(ctx.lastEvaluation.confidenceDelta * 100)
+                : 0;
+            this.edgeCount = (ctx.edges || []).length;
+            const edges = ctx.edges || [];
+            if (edges.length > 0) {
+                const top = [...edges].sort((a, b) => Math.abs(b.edge || b.edgeSize || 0) - Math.abs(a.edge || a.edgeSize || 0))[0];
+                const name = (top.market || top.marketTitle || top.marketId || '').slice(0, 20);
+                const edge = top.edge || top.edgeSize || 0;
+                this.topEdge = `${name} ${edge > 0 ? '+' : ''}${Math.round(edge)}\u00A2`;
+            }
+            if (positions && positions.length > 0) {
+                this.positionCount = positions.length;
+                this.pnlDollars = positions.reduce((sum, p) => sum + (p.unrealized_pnl || 0), 0) / 100;
+            }
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
+        updateConfidence(newConf, delta) {
+            this.confidence = Math.round(newConf * 100);
+            this.confidenceDelta = Math.round(delta * 100);
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
         invalidate() {
             this.cachedWidth = undefined;
             this.cachedLines = undefined;
@@ -220,31 +258,43 @@ function createFooterBar(piTui) {
             if (this.cachedLines && this.cachedWidth === width)
                 return this.cachedLines;
             this.cachedWidth = width;
-            const tokStr = this.tokens >= 1000
-                ? `${(this.tokens / 1000).toFixed(1)}k`
-                : `${this.tokens}`;
+            // Line 1: thesis info
+            const id = C.emerald(this.thesisId);
+            const arrow = this.confidenceDelta > 0 ? '\u25B2' : this.confidenceDelta < 0 ? '\u25BC' : '\u2500';
+            const arrowColor = this.confidenceDelta > 0 ? C.emerald : this.confidenceDelta < 0 ? C.red : C.zinc600;
+            const deltaStr = this.confidenceDelta !== 0 ? ` (${this.confidenceDelta > 0 ? '+' : ''}${this.confidenceDelta})` : '';
+            const conf = arrowColor(`${arrow} ${this.confidence}%${deltaStr}`);
+            let pnl = '';
+            if (this.positionCount > 0) {
+                const pnlStr = this.pnlDollars >= 0
+                    ? C.emerald(`+$${this.pnlDollars.toFixed(2)}`)
+                    : C.red(`-$${Math.abs(this.pnlDollars).toFixed(2)}`);
+                pnl = C.zinc600(`${this.positionCount} pos `) + pnlStr;
+            }
+            const edges = C.zinc600(`${this.edgeCount} edges`);
+            const top = this.topEdge ? C.zinc400(this.topEdge) : '';
+            const sep = C.zinc600(' \u2502 ');
+            const line1Parts = [id, conf, pnl, edges, top].filter(Boolean);
+            let line1 = C.bgZinc800(' ' + truncateToWidth(line1Parts.join(sep), width - 2, '') + ' ');
+            const l1vw = visibleWidth(line1);
+            if (l1vw < width)
+                line1 += C.bgZinc800(' '.repeat(width - l1vw));
+            // Line 2: model + exchange
             const model = C.zinc600(this.modelName.split('/').pop() || this.modelName);
+            const tokStr = this.tokens >= 1000 ? `${(this.tokens / 1000).toFixed(1)}k` : `${this.tokens}`;
             const tokens = C.zinc600(`${tokStr} tok`);
-            const exchange = this.exchangeOpen === true
-                ? C.emerald('OPEN')
-                : this.exchangeOpen === false
-                    ? C.red('CLOSED')
-                    : C.zinc600('...');
-            const trading = this.tradingEnabled
-                ? C.amber('\u26A1 trading')
-                : C.zinc600('\u26A1 read-only');
+            const exchange = this.exchangeOpen === true ? C.emerald('OPEN') : this.exchangeOpen === false ? C.red('CLOSED') : C.zinc600('...');
+            const trading = this.tradingEnabled ? C.amber('\u26A1 trading') : C.zinc600('\u26A1 read-only');
             const help = C.zinc600('/help');
-            const sep = C.zinc600(' \u2502 ');
             const leftText = [model, tokens, exchange, trading].join(sep);
             const lw = visibleWidth(leftText);
             const rw = visibleWidth(help);
             const gap = Math.max(1, width - lw - rw - 2);
-            let line = C.bgZinc900(' ' + leftText + ' '.repeat(gap) + help + ' ');
-            const lineVw = visibleWidth(line);
-            if (lineVw < width) {
-                line = line + C.bgZinc900(' '.repeat(width - lineVw));
-            }
-            this.cachedLines = [line];
+            let line2 = C.bgZinc900(' ' + leftText + ' '.repeat(gap) + help + ' ');
+            const l2vw = visibleWidth(line2);
+            if (l2vw < width)
+                line2 += C.bgZinc900(' '.repeat(width - l2vw));
+            this.cachedLines = [line1, line2];
             return this.cachedLines;
         }
     };
@@ -340,6 +390,76 @@ function renderPositions(positions) {
         : `  Total P&L: ${C.red(bold(`-$${Math.abs(parseFloat(totalDollars)).toFixed(2)}`))}`);
     return lines.join('\n');
 }
+// ─── Thesis selector (arrow keys + enter, like Claude Code) ─────────────────
+async function selectThesis(theses) {
+    return new Promise((resolve) => {
+        let selected = 0;
+        const items = theses.map((t) => {
+            const conf = typeof t.confidence === 'number' ? Math.round(t.confidence * 100) : 0;
+            const title = (t.rawThesis || t.thesis || t.title || '').slice(0, 55);
+            return { id: t.id, conf, title };
+        });
+        const write = process.stdout.write.bind(process.stdout);
+        // Use alternate screen buffer for clean rendering (like Claude Code)
+        write('\x1b[?1049h'); // enter alternate screen
+        write('\x1b[?25l'); // hide cursor
+        function render() {
+            write('\x1b[H\x1b[2J'); // cursor home + clear screen
+            write('\n  \x1b[2mSelect thesis\x1b[22m\n\n');
+            for (let i = 0; i < items.length; i++) {
+                const item = items[i];
+                const sel = i === selected;
+                const cursor = sel ? '\x1b[38;2;16;185;129m › \x1b[39m' : '   ';
+                const id = sel ? `\x1b[38;2;16;185;129m${item.id.slice(0, 8)}\x1b[39m` : `\x1b[38;2;55;55;60m${item.id.slice(0, 8)}\x1b[39m`;
+                const conf = `\x1b[38;2;55;55;60m${item.conf}%\x1b[39m`;
+                const title = sel ? `\x1b[38;2;160;160;165m${item.title}\x1b[39m` : `\x1b[38;2;80;80;88m${item.title}\x1b[39m`;
+                write(`${cursor}${id}  ${conf}  ${title}\n`);
+            }
+            write(`\n  \x1b[38;2;55;55;60m↑↓ navigate · enter select\x1b[39m`);
+        }
+        render();
+        if (process.stdin.isTTY)
+            process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const onKey = (key) => {
+            const buf = Buffer.from(key);
+            if (buf[0] === 0x1b && buf[1] === 0x5b && buf[2] === 0x41) {
+                selected = (selected - 1 + items.length) % items.length;
+                render();
+            }
+            else if (buf[0] === 0x1b && buf[1] === 0x5b && buf[2] === 0x42) {
+                selected = (selected + 1) % items.length;
+                render();
+            }
+            else if (key === 'k') {
+                selected = (selected - 1 + items.length) % items.length;
+                render();
+            }
+            else if (key === 'j') {
+                selected = (selected + 1) % items.length;
+                render();
+            }
+            else if (key === '\r' || key === '\n') {
+                cleanup();
+                resolve(items[selected].id);
+            }
+            else if (buf[0] === 0x03) {
+                cleanup();
+                process.exit(0);
+            }
+        };
+        function cleanup() {
+            process.stdin.removeListener('data', onKey);
+            if (process.stdin.isTTY)
+                process.stdin.setRawMode(false);
+            process.stdin.pause();
+            write('\x1b[?25h'); // show cursor
+            write('\x1b[?1049l'); // exit alternate screen — restores original content
+        }
+        process.stdin.on('data', onKey);
+    });
+}
 // ─── Main command ────────────────────────────────────────────────────────────
 async function agentCommand(thesisId, opts) {
     // ── Validate API keys ──────────────────────────────────────────────────────
@@ -373,17 +493,42 @@ async function agentCommand(thesisId, opts) {
         }
     }
     const sfClient = new client_js_1.SFClient();
-    // ── Resolve thesis ID ──────────────────────────────────────────────────────
+    // ── Resolve thesis ID (interactive selection if needed) ─────────────────────
     let resolvedThesisId = thesisId;
     if (!resolvedThesisId) {
         const data = await sfClient.listTheses();
-        const theses = data.theses || data;
-        const active = theses.find((t) => t.status === 'active');
-        if (!active) {
-            console.error('No active thesis. Create one first: sf create "..."');
-            process.exit(1);
+        const theses = (data.theses || data);
+        const active = theses.filter((t) => t.status === 'active');
+        if (active.length === 0) {
+            if (!process.stdin.isTTY) {
+                console.error('No active thesis. Create one first: sf create "..."');
+                process.exit(1);
+            }
+            // No theses — offer to create one
+            console.log('\n  No active theses found.\n');
+            const readline = await import('readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise(resolve => rl.question('  Enter a thesis to create (or press Enter to exit):\n  > ', resolve));
+            rl.close();
+            if (!answer.trim()) {
+                process.exit(0);
+            }
+            console.log('\n  Creating thesis...\n');
+            const result = await sfClient.createThesis(answer.trim(), true);
+            resolvedThesisId = result.id;
+            console.log(`  ✓ Created: ${result.id?.slice(0, 8)}\n`);
+        }
+        else if (active.length === 1) {
+            resolvedThesisId = active[0].id;
+        }
+        else if (process.stdin.isTTY && !opts?.noTui) {
+            // Multiple theses — interactive arrow key selector (TUI only)
+            resolvedThesisId = await selectThesis(active);
+        }
+        else {
+            // Non-interactive (--plain, telegram, piped) — use first active
+            resolvedThesisId = active[0].id;
         }
-        resolvedThesisId = active.id;
     }
     // ── Fetch initial context ──────────────────────────────────────────────────
     let latestContext = await sfClient.getContext(resolvedThesisId);
@@ -400,7 +545,6 @@ async function agentCommand(thesisId, opts) {
     const { Agent } = piAgent;
     // ── Component class factories (need piTui ref) ─────────────────────────────
     const MutableLine = createMutableLine(piTui);
-    const HeaderBar = createHeaderBar(piTui);
     const FooterBar = createFooterBar(piTui);
     // ── Model setup ────────────────────────────────────────────────────────────
     const rawModelName = opts?.model || 'anthropic/claude-sonnet-4.6';
@@ -479,8 +623,11 @@ async function agentCommand(thesisId, opts) {
         },
     };
     // ── Build components ───────────────────────────────────────────────────────
-    const headerBar = new HeaderBar();
-    // Fetch positions for header P&L (non-blocking, best-effort)
+    // No header bar — all info in footer (2 lines)
+    const footerBar = new FooterBar();
+    footerBar.modelName = currentModelName;
+    footerBar.tradingEnabled = (0, config_js_1.loadConfig)().tradingEnabled || false;
+    // Fetch positions for footer P&L (non-blocking, best-effort)
     let initialPositions = null;
     try {
         initialPositions = await (0, kalshi_js_1.getPositions)();
@@ -495,10 +642,7 @@ async function agentCommand(thesisId, opts) {
         }
     }
     catch { /* positions not available, fine */ }
-    headerBar.setFromContext(latestContext, initialPositions || undefined);
-    const footerBar = new FooterBar();
-    footerBar.modelName = currentModelName;
-    footerBar.tradingEnabled = (0, config_js_1.loadConfig)().tradingEnabled || false;
+    footerBar.setFromContext(latestContext, initialPositions || undefined);
     // Fetch exchange status for footer (non-blocking)
     fetch('https://api.elections.kalshi.com/trade-api/v2/exchange/status', { headers: { 'Accept': 'application/json' } })
         .then(r => r.json())
@@ -537,13 +681,7 @@ async function agentCommand(thesisId, opts) {
     tui.addChild(bottomSpacer);
     // Focus on editor
     tui.setFocus(editor);
-    // ── Overlays (pinned header + footer) ──────────────────────────────────────
-    const headerOverlay = tui.showOverlay(headerBar, {
-        row: 0,
-        col: 0,
-        width: '100%',
-        nonCapturing: true,
-    });
+    // ── Footer overlay (2-line: thesis info + model/exchange) ──────────────────
     const footerOverlay = tui.showOverlay(footerBar, {
         anchor: 'bottom-left',
         width: '100%',
@@ -598,7 +736,7 @@ async function agentCommand(thesisId, opts) {
             execute: async (_toolCallId, params) => {
                 const ctx = await sfClient.getContext(params.thesisId);
                 latestContext = ctx;
-                headerBar.setFromContext(ctx, initialPositions || undefined);
+                footerBar.setFromContext(ctx, initialPositions || undefined);
                 tui.requestRender();
                 return {
                     content: [{ type: 'text', text: JSON.stringify(ctx, null, 2) }],
@@ -636,13 +774,13 @@ async function agentCommand(thesisId, opts) {
                     addSystemText(color(`  ${arrow} Confidence ${prev}% \u2192 ${now}% (${delta > 0 ? '+' : ''}${Math.round(delta * 100)})`));
                     addSpacer();
                     // Update header
-                    headerBar.updateConfidence(result.evaluation.newConfidence, delta);
+                    footerBar.updateConfidence(result.evaluation.newConfidence, delta);
                     tui.requestRender();
                 }
                 // Refresh context after eval
                 try {
                     latestContext = await sfClient.getContext(params.thesisId);
-                    headerBar.setFromContext(latestContext, initialPositions || undefined);
+                    footerBar.setFromContext(latestContext, initialPositions || undefined);
                     tui.requestRender();
                 }
                 catch { }
@@ -671,8 +809,8 @@ async function agentCommand(thesisId, opts) {
                     const matched = series
                         .filter((s) => keywords.every((kw) => (s.title || '').toLowerCase().includes(kw) ||
                         (s.ticker || '').toLowerCase().includes(kw)))
-                        .filter((s) => parseFloat(s.volume_fp || '0') > 1000)
-                        .sort((a, b) => parseFloat(b.volume_fp || '0') - parseFloat(a.volume_fp || '0'))
+                        .filter((s) => parseFloat(s.volume_24h_fp || s.volume_fp || '0') > 0)
+                        .sort((a, b) => parseFloat(b.volume_24h_fp || b.volume_fp || '0') - parseFloat(a.volume_24h_fp || a.volume_fp || '0'))
                         .slice(0, 15);
                     result = matched;
                 }
@@ -1037,15 +1175,14 @@ async function agentCommand(thesisId, opts) {
             execute: async () => {
                 const { theses } = await sfClient.listTheses();
                 const activeTheses = (theses || []).filter((t) => t.status === 'active' || t.status === 'monitoring');
+                const results = await Promise.allSettled(activeTheses.map(async (t) => {
+                    const ctx = await sfClient.getContext(t.id);
+                    return (ctx.edges || []).map((e) => ({ ...e, thesisId: t.id }));
+                }));
                 const allEdges = [];
-                for (const t of activeTheses) {
-                    try {
-                        const ctx = await sfClient.getContext(t.id);
-                        for (const edge of (ctx.edges || [])) {
-                            allEdges.push({ ...edge, thesisId: t.id });
-                        }
-                    }
-                    catch { /* skip inaccessible theses */ }
+                for (const r of results) {
+                    if (r.status === 'fulfilled')
+                        allEdges.push(...r.value);
                 }
                 allEdges.sort((a, b) => Math.abs(b.edge || b.edgeSize || 0) - Math.abs(a.edge || a.edgeSize || 0));
                 const top10 = allEdges.slice(0, 10).map((e) => ({
@@ -1283,7 +1420,7 @@ When the conversation produces a concrete trade idea (specific contract, directi
 - Extract hard conditions (specific prices in cents) into entryBelow/stopLoss/takeProfit.
 - Put fuzzy conditions into softConditions (e.g. "only if n3 > 60%", "spread < 3¢").
 - Put the full reasoning into rationale.
-- After creating, confirm the strategy details and mention that sf runtime --dangerous can execute it.
+- After creating, confirm the strategy details.
 - If the user says "change the stop loss on T150 to 30", use update_strategy.
 
 ## Trading status
@@ -1327,7 +1464,32 @@ ${ctx.lastEvaluation?.summary ? `Latest evaluation summary: ${ctx.lastEvaluation
         const saved = loadSession(resolvedThesisId);
         if (saved?.messages?.length > 0) {
             try {
-                agent.replaceMessages(saved.messages);
+                // Clean corrupted messages: empty content, missing role, broken alternation
+                const filtered = saved.messages.filter((m) => {
+                    if (!m.role)
+                        return false;
+                    if (Array.isArray(m.content) && m.content.length === 0)
+                        return false;
+                    if (m.role === 'assistant' && !m.content && !m.tool_calls?.length)
+                        return false;
+                    return true;
+                });
+                // Fix alternation: ensure user → assistant → user → assistant
+                // Drop consecutive messages of the same role (keep first)
+                const cleaned = [];
+                for (const m of filtered) {
+                    const lastRole = cleaned.length > 0 ? cleaned[cleaned.length - 1].role : null;
+                    if (m.role === lastRole && m.role !== 'tool') {
+                        // Skip consecutive same-role (except tool messages which can follow each other)
+                        continue;
+                    }
+                    cleaned.push(m);
+                }
+                // Ensure conversation doesn't end with user message (API needs assistant reply)
+                if (cleaned.length > 0 && cleaned[cleaned.length - 1].role === 'user') {
+                    cleaned.pop();
+                }
+                agent.replaceMessages(cleaned);
                 // Always update system prompt with fresh context
                 agent.setSystemPrompt(systemPrompt);
                 sessionRestored = true;
@@ -1601,7 +1763,7 @@ ${ctx.lastEvaluation?.summary ? `Latest evaluation summary: ${ctx.lastEvaluation
                         addSystemText(C.emerald(`Switched to ${resolvedThesisId.slice(0, 8)}`) + C.zinc400(' (new session)'));
                     }
                     // Update header
-                    headerBar.setFromContext(newContext, initialPositions || undefined);
+                    footerBar.setFromContext(newContext, initialPositions || undefined);
                     chatContainer.clear();
                     addSystemText(buildWelcomeDashboard(newContext, initialPositions));
                 }
@@ -1812,7 +1974,20 @@ Output a structured summary. Be concise but preserve every important detail —
                 return true;
             }
             case '/clear': {
-                chatContainer.clear();
+                // Don't use chatContainer.clear() — it breaks pi-tui layout.
+                // Instead, remove children one by one and add a fresh spacer
+                // so the container still has content for layout calculations.
+                const children = [...chatContainer.children || []];
+                for (const child of children) {
+                    try {
+                        chatContainer.removeChild(child);
+                    }
+                    catch { /* ignore */ }
+                }
+                addSpacer();
+                isProcessing = false;
+                pendingPrompt = null;
+                tui.setFocus(editor);
                 tui.requestRender();
                 return true;
             }
@@ -2065,7 +2240,7 @@ Output a structured summary. Be concise but preserve every important detail —
             }
             addSpacer();
             // Update header
-            headerBar.setFromContext({ ...latestContext, confidence: delta.confidence, lastEvaluation: { confidenceDelta: delta.confidenceDelta } }, initialPositions || undefined);
+            footerBar.setFromContext({ ...latestContext, confidence: delta.confidence, lastEvaluation: { confidenceDelta: delta.confidenceDelta } }, initialPositions || undefined);
             tui.requestRender();
             // Auto-trigger agent
             isProcessing = true;
@@ -2400,15 +2575,14 @@ async function runPlainTextAgent(params) {
             execute: async () => {
                 const { theses } = await sfClient.listTheses();
                 const activeTheses = (theses || []).filter((t) => t.status === 'active' || t.status === 'monitoring');
+                const results = await Promise.allSettled(activeTheses.map(async (t) => {
+                    const ctx = await sfClient.getContext(t.id);
+                    return (ctx.edges || []).map((e) => ({ ...e, thesisId: t.id }));
+                }));
                 const allEdges = [];
-                for (const t of activeTheses) {
-                    try {
-                        const ctx = await sfClient.getContext(t.id);
-                        for (const edge of (ctx.edges || [])) {
-                            allEdges.push({ ...edge, thesisId: t.id });
-                        }
-                    }
-                    catch { /* skip inaccessible theses */ }
+                for (const r of results) {
+                    if (r.status === 'fulfilled')
+                        allEdges.push(...r.value);
                 }
                 allEdges.sort((a, b) => Math.abs(b.edge || b.edgeSize || 0) - Math.abs(a.edge || a.edgeSize || 0));
                 const top10 = allEdges.slice(0, 10).map((e) => ({
@@ -2615,7 +2789,7 @@ async function runPlainTextAgent(params) {
         tools.push({
             name: 'place_order',
             label: 'Place Order',
-            description: 'Place a buy or sell order on Kalshi. Executes directly (no confirmation prompt in plain mode).',
+            description: 'Place a buy or sell order on Kalshi. Shows preview and asks for confirmation.',
             parameters: Type.Object({
                 ticker: Type.String({ description: 'Market ticker e.g. KXWTIMAX-26DEC31-T135' }),
                 side: Type.String({ description: 'yes or no' }),
@@ -2626,9 +2800,22 @@ async function runPlainTextAgent(params) {
             }),
             execute: async (_id, p) => {
                 const { createOrder } = await import('../kalshi.js');
+                const readline = await import('readline');
                 const priceCents = p.price_cents ? Math.round(Number(p.price_cents)) : undefined;
                 const maxCost = ((priceCents || 99) * p.count / 100).toFixed(2);
-                process.stderr.write(`  Order: ${p.action.toUpperCase()} ${p.count}x ${p.ticker} ${p.side.toUpperCase()} @ ${priceCents ? priceCents + '\u00A2' : 'market'} (max $${maxCost})\n`);
+                const preview = `  Order: ${p.action.toUpperCase()} ${p.count}x ${p.ticker} ${p.side.toUpperCase()} @ ${priceCents ? priceCents + '\u00A2' : 'market'} (max $${maxCost})`;
+                process.stderr.write(preview + '\n');
+                // Reject if stdin is piped (non-TTY) — too dangerous to auto-execute trades
+                if (!process.stdin.isTTY) {
+                    return { content: [{ type: 'text', text: 'Order rejected: trading requires interactive terminal (stdin is piped). Use TUI mode for trading.' }], details: {} };
+                }
+                // Confirm in plain mode via readline
+                const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+                const answer = await new Promise(resolve => rl.question('  Execute? (y/n) ', resolve));
+                rl.close();
+                if (!answer.toLowerCase().startsWith('y')) {
+                    return { content: [{ type: 'text', text: 'Order cancelled by user.' }], details: {} };
+                }
                 try {
                     const result = await createOrder({
                         ticker: p.ticker,

package/dist/commands/dashboard.d.ts

@@ -1,11 +1,14 @@
 /**
- * sf dashboard — Portfolio overview
+ * sf dashboard — Commander entry point
  *
- * One-screen summary: theses, positions, risk exposure, top unpositioned edges.
- * Uses existing APIs + local Kalshi positions.
+ * Three modes:
+ *   --json   → dump current state as JSON
+ *   --once   → one-time formatted print (no interactive TUI)
+ *   default  → launch interactive TUI dashboard
  */
 export declare function dashboardCommand(opts?: {
     json?: boolean;
+    once?: boolean;
     apiKey?: string;
     apiUrl?: string;
 }): Promise<void>;