@palmyr/cli 1.3.0 → 1.4.0

package/dist/cli.js

@@ -1636,6 +1636,8 @@ async function main() {
                             { name: 'brief', description: 'Show thesis + PnL brief for a position', hint: '<CA>' },
                             { name: 'doctor', description: 'Health check for the wallet-trading subsystem', hint: '[--wallet <ref>]' },
                             { name: 'smoke-test', description: 'End-to-end validation of wallet trading on Solana + Base', hint: '--wallet <ref> [--chain solana|base|all]' },
+                            { name: 'readiness', description: 'Go/no-go autonomous-trading readiness — sign, gas, quotes, daemon, open positions', hint: '--wallet <ref>' },
+                            { name: 'live-test', description: 'Execute tiny real round trips on Solana + Base, verify no leftover positions', hint: '--wallet <ref> --budget Nusdc [--chain ...]' },
                             { name: 'daemon', description: 'Auto-monitor positions for trigger-based exits', hint: 'tick | start [--auto] | stop | status' },
                             { name: 'triggers', description: 'List pending trigger fires from the daemon', hint: '[--ca X] [--since ISO] [--clear]' },
                             { name: 'trading-keystore', description: 'Encrypted BIP39 keystore for HD-derived trading wallets', hint: 'init | list | status | derive | export' },
@@ -2501,9 +2503,12 @@ async function main() {
                             : (readPosition('solana', ca) ?? readPosition('base', ca));
                         if (!p)
                             err(`Position not found: ${ca}`, EXIT.NOT_FOUND);
-                        const unit = p.chain === 'solana' ? 'SOL' : 'ETH';
-                        const realized = p.chain === 'solana' ? p.pnl.realizedSol : p.pnl.realizedEth;
-                        const unrealized = p.chain === 'solana' ? p.pnl.unrealizedSol : p.pnl.unrealizedEth;
+                        // Canonical asset-tagged PnL — reflects what the position was
+                        // actually funded in (USDC-funded positions report USDC, not the
+                        // chain native asset).
+                        const unit = p.pnl.realized?.asset ?? (p.chain === 'solana' ? 'SOL' : 'ETH');
+                        const realized = p.pnl.realized?.amount ?? 0;
+                        const unrealized = p.pnl.unrealized?.amount ?? 0;
                         if (!AGENT_MODE) {
                             console.log();
                             section('Position');
@@ -2548,15 +2553,11 @@ async function main() {
                             if (p.sells.length > 0) {
                                 console.log();
                                 section(`Sells (${p.sells.length})`);
-                                if (p.chain === 'solana') {
-                                    for (const s of p.sells) {
-                                        console.log(`  ${t.muted}${s.time}${t.reset}  ${s.tokensIn} → ${s.solOut} (realized ${s.realizedSol >= 0 ? '+' : ''}${s.realizedSol.toFixed(6)} SOL) — ${s.reason}`);
-                                    }
-                                }
-                                else {
-                                    for (const s of p.sells) {
-                                        console.log(`  ${t.muted}${s.time}${t.reset}  ${s.tokensIn} → ${s.ethOut} (realized ${s.realizedEth >= 0 ? '+' : ''}${s.realizedEth.toFixed(6)} ETH) — ${s.reason}`);
-                                    }
+                                for (const s of p.sells) {
+                                    const outDisplay = s.output?.display ?? '?';
+                                    const r = s.realized?.amount ?? 0;
+                                    const ru = s.realized?.asset ?? unit;
+                                    console.log(`  ${t.muted}${s.time}${t.reset}  ${s.tokensIn} → ${outDisplay} (realized ${r >= 0 ? '+' : ''}${r.toFixed(6)} ${ru}) — ${s.reason}`);
                                 }
                             }
                             console.log();
@@ -2623,7 +2624,8 @@ async function main() {
                             if (!AGENT_MODE) {
                                 const tag = baseResult.dryRun ? `${t.warn}[dry-run]${t.reset} ` : '';
                                 const protTag = baseResult.protectedExec ? ` ${t.accent}[protected]${t.reset}` : '';
-                                const pnlColor = baseResult.realizedEth >= 0 ? t.success : t.error;
+                                const realizedAmt = baseResult.realized.amount;
+                                const pnlColor = realizedAmt >= 0 ? t.success : t.error;
                                 const closedTag = baseResult.positionStatus === 'closed' ? ` ${t.muted}[closed]${t.reset}` : '';
                                 console.log(`\n  ${t.success}${icon.success} ${tag}Base sell executed${protTag}${closedTag}${t.reset}`);
                                 if (baseResult.approvalTxHash) {
@@ -2631,11 +2633,11 @@ async function main() {
                                 }
                                 console.log(`  ${t.muted}tx:${t.reset}        ${baseResult.txHash}`);
                                 console.log(`  ${t.muted}sold:${t.reset}      ${baseResult.tokensIn} tokens (${percent}%)`);
-                                console.log(`  ${t.muted}received:${t.reset}  ${baseResult.ethOut}`);
+                                console.log(`  ${t.muted}received:${t.reset}  ${baseResult.output.display}`);
                                 {
-                                    const unit = baseResult.outputAsset ?? 'ETH';
+                                    const unit = baseResult.realized.asset;
                                     const decimals = unit === 'USDC' ? 2 : 6;
-                                    console.log(`  ${t.muted}realized:${t.reset}  ${pnlColor}${baseResult.realizedEth >= 0 ? '+' : ''}${baseResult.realizedEth.toFixed(decimals)} ${unit}${t.reset}`);
+                                    console.log(`  ${t.muted}realized:${t.reset}  ${pnlColor}${realizedAmt >= 0 ? '+' : ''}${realizedAmt.toFixed(decimals)} ${unit}${t.reset}`);
                                 }
                                 console.log(`  ${t.muted}reason:${t.reset}    ${reason}`);
                                 if (baseResult.protectedExec) {
@@ -2672,21 +2674,22 @@ async function main() {
                         if (!AGENT_MODE) {
                             const tag = result.dryRun ? `${t.warn}[dry-run]${t.reset} ` : '';
                             const protTag = result.protectedExec ? ` ${t.accent}[protected]${t.reset}` : '';
-                            const pnlColor = result.realizedSol >= 0 ? t.success : t.error;
+                            const realizedAmt = result.realized.amount;
+                            const pnlColor = realizedAmt >= 0 ? t.success : t.error;
                             const closedTag = result.positionStatus === 'closed' ? ` ${t.muted}[closed]${t.reset}` : '';
                             console.log(`\n  ${t.success}${icon.success} ${tag}Sell executed${protTag}${closedTag}${t.reset}`);
                             console.log(`  ${t.muted}tx:${t.reset}        ${result.txSignature}`);
                             console.log(`  ${t.muted}sold:${t.reset}      ${result.tokensIn} tokens (${percent}%)`);
-                            console.log(`  ${t.muted}received:${t.reset}  ${result.solOut}`);
+                            console.log(`  ${t.muted}received:${t.reset}  ${result.output.display}`);
                             console.log(`  ${t.muted}slippage:${t.reset}  ${result.slippageBpsUsed}bps (${result.slippageSource})`);
                             if (result.protectedExec) {
                                 console.log(`  ${t.muted}tip:${t.reset}       ${result.tipLamports} lamports (Jito)`);
                             }
                             console.log(`  ${t.muted}fee:${t.reset}       ${result.feeLamports} lamports`);
                             {
-                                const unit = result.outputAsset ?? 'SOL';
+                                const unit = result.realized.asset;
                                 const decimals = unit === 'USDC' ? 2 : 6;
-                                console.log(`  ${t.muted}realized:${t.reset}  ${pnlColor}${result.realizedSol >= 0 ? '+' : ''}${result.realizedSol.toFixed(decimals)} ${unit}${t.reset}`);
+                                console.log(`  ${t.muted}realized:${t.reset}  ${pnlColor}${realizedAmt >= 0 ? '+' : ''}${realizedAmt.toFixed(decimals)} ${unit}${t.reset}`);
                             }
                             console.log(`  ${t.muted}reason:${t.reset}    ${reason}`);
                             if (result.forensics && result.forensics.flag === 'suspect-mev') {
@@ -3020,14 +3023,19 @@ async function main() {
                         const p = readPosition(inferredChain, ca, scopedAddr);
                         if (!p)
                             err(`Position not found: ${ca}`, EXIT.NOT_FOUND);
+                        // `--evaluate` degrades gracefully: a missing ANTHROPIC_API_KEY or
+                        // a model-API failure must NOT take down the whole brief. We surface
+                        // the LLM error as `llmError` so agents can branch on it, and still
+                        // print the deterministic brief fields.
                         let llm;
+                        let llmError;
                         if (evaluate) {
                             const { evaluateBriefWithLLM } = await import('./wallet-brief-llm.js');
                             try {
                                 llm = await evaluateBriefWithLLM(p);
                             }
                             catch (e) {
-                                err(e.message || 'brief --evaluate failed', EXIT.GENERAL);
+                                llmError = e?.message ?? 'brief --evaluate failed';
                             }
                         }
                         if (!AGENT_MODE) {
@@ -3042,11 +3050,11 @@ async function main() {
                             console.log();
                             section('Current');
                             const pnlColor = p.pnl.unrealizedPct >= 0 ? t.success : t.error;
-                            // Brief is now chain-aware — read canonical asset-tagged pnl
-                            // fields rather than the Solana-specific `realizedSol` / `unrealizedSol`.
-                            const realizedAmt = p.pnl.realized?.amount ?? (p.chain === 'solana' ? p.pnl.realizedSol : p.pnl.realizedEth);
+                            // Canonical asset-tagged pnl — normalizePosition guarantees these
+                            // exist on read, including back-fill from legacy on-disk fields.
+                            const realizedAmt = p.pnl.realized?.amount ?? 0;
                             const realizedAsset = p.pnl.realized?.asset ?? (p.chain === 'solana' ? 'SOL' : 'ETH');
-                            const unrealizedAmt = p.pnl.unrealized?.amount ?? (p.chain === 'solana' ? p.pnl.unrealizedSol : p.pnl.unrealizedEth);
+                            const unrealizedAmt = p.pnl.unrealized?.amount ?? 0;
                             const unrealizedAsset = p.pnl.unrealized?.asset ?? realizedAsset;
                             kv('Realized', `${realizedAmt >= 0 ? '+' : ''}${realizedAmt.toFixed(6)} ${realizedAsset}`);
                             console.log(`  ${t.muted}Unrealized:${t.reset}  ${pnlColor}${unrealizedAmt >= 0 ? '+' : ''}${unrealizedAmt.toFixed(6)} ${unrealizedAsset} (${p.pnl.unrealizedPct.toFixed(2)}%)${t.reset}`);
@@ -3060,6 +3068,10 @@ async function main() {
                                 console.log(`  ${t.muted}Reasoning:${t.reset}       ${llm.reasoning}`);
                                 console.log(`  ${t.muted}Watch for:${t.reset}       ${llm.watchFor}`);
                             }
+                            else if (llmError) {
+                                console.log();
+                                console.log(`  ${t.warn}LLM eval skipped: ${llmError}${t.reset}`);
+                            }
                             else {
                                 console.log();
                                 console.log(`  ${t.muted}Add --evaluate for an LLM thesis-health check.${t.reset}`);
@@ -3077,6 +3089,7 @@ async function main() {
                                 pnl: p.pnl,
                                 sellsCount: p.sells.length,
                                 llm,
+                                llmError,
                             });
                         }
                         break;
@@ -3175,6 +3188,111 @@ async function main() {
                             process.exit(EXIT.GENERAL);
                         break;
                     }
+                    case 'readiness': {
+                        const readyWalletRef = flags.wallet || undefined;
+                        if (!readyWalletRef)
+                            err('--wallet required. Use a vault wallet name/id or `trading:N`.', EXIT.BAD_INPUT);
+                        const { runWalletReadiness } = await import('./wallet-readiness.js');
+                        const report = await runWalletReadiness({ walletRef: readyWalletRef });
+                        if (AGENT_MODE) {
+                            print(report);
+                            if (!report.safeForAutonomousTrading)
+                                process.exit(EXIT.GENERAL);
+                            break;
+                        }
+                        console.log();
+                        section('Wallet readiness');
+                        kv('Wallet', report.wallet);
+                        if (report.solanaAddress)
+                            kv('Solana', report.solanaAddress);
+                        if (report.evmAddress)
+                            kv('EVM', report.evmAddress);
+                        kv('Verdict', report.safeForAutonomousTrading
+                            ? `${t.success}safe for autonomous trading${t.reset}`
+                            : `${t.error}NOT safe — see failing checks${t.reset}`);
+                        if (report.balances.solana)
+                            kv('SOL balance', `${report.balances.solana.sol.toFixed(6)} SOL`);
+                        if (report.balances.base)
+                            kv('ETH balance', `${report.balances.base.eth.toFixed(8)} ETH`);
+                        kv('Open positions', `solana=${report.openPositions.solana} base=${report.openPositions.base}`);
+                        kv('Daemon', report.daemon.running
+                            ? `${t.success}running${t.reset} (pid ${report.daemon.pid}${report.daemon.autoExecute ? ', auto-execute' : ''})`
+                            : `${t.warn}not running${t.reset}`);
+                        console.log();
+                        section('Checks');
+                        for (const c of report.checks) {
+                            const dot = c.status === 'pass' ? `${t.success}✓${t.reset}`
+                                : c.status === 'warn' ? `${t.warn}!${t.reset}`
+                                    : c.status === 'skip' ? `${t.muted}-${t.reset}`
+                                        : `${t.error}✗${t.reset}`;
+                            const tail = [c.value !== undefined ? String(c.value) : null, c.message].filter(Boolean).join(' — ');
+                            console.log(`  ${dot} ${c.name}${tail ? `: ${tail}` : ''}`);
+                        }
+                        console.log();
+                        if (!report.safeForAutonomousTrading)
+                            process.exit(EXIT.GENERAL);
+                        break;
+                    }
+                    case 'live-test': {
+                        const liveWalletRef = flags.wallet || undefined;
+                        if (!liveWalletRef)
+                            err('--wallet required. Use a vault wallet name/id or `trading:N`.', EXIT.BAD_INPUT);
+                        const budgetRaw = flags.budget;
+                        if (!budgetRaw)
+                            err('--budget required, e.g. --budget 1usdc (caps total trade exposure).', EXIT.BAD_INPUT);
+                        const budgetMatch = (budgetRaw ?? '').trim().match(/^(\d+(?:\.\d+)?)\s*usdc$/i);
+                        if (!budgetMatch)
+                            err(`--budget must be in USDC (e.g. "0.5usdc", "1usdc"), got "${budgetRaw}".`, EXIT.BAD_INPUT);
+                        const budgetUsdc = Number(budgetMatch[1]);
+                        const liveChainFlag = (flags.chain || 'all').toLowerCase();
+                        if (liveChainFlag !== 'solana' && liveChainFlag !== 'base' && liveChainFlag !== 'all') {
+                            err(`--chain must be solana, base, or all (got ${liveChainFlag})`, EXIT.BAD_INPUT);
+                        }
+                        const { runWalletLiveTest } = await import('./wallet-live-test.js');
+                        let report;
+                        try {
+                            report = await runWalletLiveTest({
+                                walletRef: liveWalletRef,
+                                budgetUsdc,
+                                chain: liveChainFlag,
+                            });
+                        }
+                        catch (e) {
+                            err(e.message || 'live-test failed', EXIT.GENERAL);
+                        }
+                        if (AGENT_MODE) {
+                            print(report);
+                            if (!report.safeForAutonomousTrading)
+                                process.exit(EXIT.GENERAL);
+                            break;
+                        }
+                        console.log();
+                        section('Wallet live-test');
+                        kv('Wallet', report.wallet);
+                        kv('Budget', `${report.budgetUsdc.toFixed(6)} USDC (per leg ${report.perLegUsdc.toFixed(6)} USDC)`);
+                        kv('Verdict', report.safeForAutonomousTrading
+                            ? `${t.success}safe for autonomous trading${t.reset}`
+                            : `${t.error}NOT safe — see failing legs${t.reset}`);
+                        kv('Total realized', `${report.totalRealizedUsdc >= 0 ? '+' : ''}${report.totalRealizedUsdc.toFixed(6)} USDC`);
+                        kv('Open positions after', String(report.openPositionsAfter));
+                        console.log();
+                        section('Legs');
+                        for (const leg of report.legs) {
+                            const dot = leg.status === 'pass' ? `${t.success}✓${t.reset}`
+                                : leg.status === 'skip' ? `${t.muted}-${t.reset}`
+                                    : `${t.error}✗${t.reset}`;
+                            const realizedStr = leg.realized
+                                ? `; realized ${leg.realized.amount >= 0 ? '+' : ''}${leg.realized.amount.toFixed(6)} ${leg.realized.asset}`
+                                : '';
+                            const txStr = leg.txHash ? ` (${leg.txHash.slice(0, 10)}…)` : '';
+                            const detail = [leg.message, leg.durationMs !== undefined ? `${leg.durationMs}ms` : null].filter(Boolean).join(' — ');
+                            console.log(`  ${dot} ${leg.chain}/${leg.name}${txStr}${realizedStr}${detail ? `: ${detail}` : ''}`);
+                        }
+                        console.log();
+                        if (!report.safeForAutonomousTrading)
+                            process.exit(EXIT.GENERAL);
+                        break;
+                    }
                     case 'daemon': {
                         const sub = positional[0];
                         if (!sub)