perp-cli 0.6.4 → 0.7.1

package/dist/commands/account.js

@@ -1,8 +1,7 @@
-import { PacificaAdapter } from "../exchanges/pacifica.js";
-import { HyperliquidAdapter } from "../exchanges/hyperliquid.js";
 import { makeTable, formatUsd, formatPnl, printJson, jsonOk, jsonError, symbolMatch, withJsonErrors } from "../utils.js";
 import chalk from "chalk";
 import { assessRisk } from "../risk.js";
+import { hasPacificaSdk, isDexCapable } from "../exchanges/capabilities.js";
 const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
 async function fetchExchangeSnapshot(name, getAdapter) {
     try {
@@ -96,7 +95,7 @@ function buildSummary(snapshots) {
     };
 }
 function pac(adapter) {
-    if (!(adapter instanceof PacificaAdapter))
+    if (!hasPacificaSdk(adapter))
         throw new Error("Market settings are only available on Pacifica.");
     return adapter;
 }
@@ -112,6 +111,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         try {
             if (name === "hyperliquid") {
                 const { HyperliquidSpotAdapter } = await import("../exchanges/hyperliquid-spot.js");
+                const { HyperliquidAdapter } = await import("../exchanges/hyperliquid.js");
                 const hlSpot = new HyperliquidSpotAdapter(adapter);
                 await hlSpot.init();
                 const raw = await hlSpot.getSpotBalances();
@@ -149,7 +149,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         catch { /* spot not available */ }
         // HL unified account: perp equity already includes spot USDC balance.
         // Detect by checking if adapter is HL without a dex override.
-        const isUnified = name === "hyperliquid" && !adapter.dex;
+        const isUnified = name === "hyperliquid" && (!isDexCapable(adapter) || !adapter.dex);
         const cutoff24h = Date.now() - 24 * 60 * 60 * 1000;
         const recent = fundingPayments.filter(f => f.time >= cutoff24h);
         const funding24h = recent.reduce((sum, f) => sum + Number(f.payment), 0);
@@ -368,7 +368,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                         ]);
                     }
                     // --hip3: fetch HIP-3 dex positions for HL
-                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                    if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                         const hip3 = await fetchHip3Data(adapter, a => a.getPositions());
                         for (const { dex, items } of hip3) {
                             for (const p of items) {
@@ -397,7 +397,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                     try {
                         const adapter = await getAdapterForExchange(ex);
                         grouped[ex] = await adapter.getPositions();
-                        if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                        if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                             const hip3 = await fetchHip3Data(adapter, a => a.getPositions());
                             for (const { dex, items } of hip3)
                                 grouped[`hip3:${dex}`] = items;
@@ -423,7 +423,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         const positions = await adapter.getPositions();
         // --hip3: append HIP-3 dex positions
         const hip3Positions = [];
-        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+        if (opts.hip3 && isDexCapable(adapter)) {
             hip3Positions.push(...await fetchHip3Data(adapter, a => a.getPositions()));
         }
         if (isJson()) {
@@ -494,7 +494,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                         ]);
                     }
                     // --hip3: fetch HIP-3 dex orders for HL
-                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                    if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                         const hip3 = await fetchHip3Data(adapter, a => a.getOpenOrders());
                         for (const { dex, items } of hip3) {
                             for (const o of items) {
@@ -523,7 +523,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                     try {
                         const adapter = await getAdapterForExchange(ex);
                         grouped[ex] = await adapter.getOpenOrders();
-                        if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                        if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                             const hip3 = await fetchHip3Data(adapter, a => a.getOpenOrders());
                             for (const { dex, items } of hip3)
                                 grouped[`hip3:${dex}`] = items;
@@ -549,7 +549,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         const orders = await adapter.getOpenOrders();
         // --hip3: append HIP-3 dex orders
         const hip3Orders = [];
-        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+        if (opts.hip3 && isDexCapable(adapter)) {
             hip3Orders.push(...await fetchHip3Data(adapter, a => a.getOpenOrders()));
         }
         if (isJson()) {
@@ -623,8 +623,9 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         .action(async () => {
         const adapter = await getAdapter();
         // Pacifica: use dedicated SDK endpoint
-        if (adapter instanceof PacificaAdapter) {
-            const settings = await adapter.sdk.getAccountSettings(adapter.publicKey);
+        if (hasPacificaSdk(adapter)) {
+            const sdk = adapter.sdk;
+            const settings = await sdk.getAccountSettings(adapter.publicKey);
             if (isJson())
                 return printJson(jsonOk(settings));
             if (!Array.isArray(settings) || settings.length === 0) {
@@ -902,9 +903,19 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         .command("twap-orders")
         .description("Active TWAP orders")
         .action(async () => {
-        const adapter = await getAdapter();
-        const p = pac(adapter);
-        const orders = await p.sdk.getTWAPOrders(p.publicKey);
+        let p;
+        try {
+            const adapter = await getAdapter();
+            p = pac(adapter);
+        }
+        catch (err) {
+            if (isJson())
+                return printJson(jsonError("EXCHANGE_ERROR", err instanceof Error ? err.message : String(err)));
+            console.error(chalk.red(`\n  ${err instanceof Error ? err.message : String(err)}\n`));
+            return;
+        }
+        const sdk = p.sdk;
+        const orders = await sdk.getTWAPOrders(p.publicKey);
         if (isJson())
             return printJson(jsonOk(orders));
         if (!orders || orders.length === 0) {
@@ -932,7 +943,73 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                 const exchanges = opts.exchange
                     ? opts.exchange.split(",").map(e => e.trim())
                     : [...EXCHANGES];
-                const snapshots = await Promise.all(exchanges.map(ex => fetchExchangeSnapshot(ex, getAdapterForExchange)));
+                // Fetch snapshots + funding + spot ALL in parallel
+                const fundingByExSym = new Map();
+                const spotRows = [];
+                let totalSpotValue = 0;
+                const [snapshots] = await Promise.all([
+                    // Phase 1: balance + positions + orders
+                    Promise.all(exchanges.map(ex => fetchExchangeSnapshot(ex, getAdapterForExchange))),
+                    // Phase 2: funding payments (parallel with Phase 1)
+                    Promise.allSettled(exchanges.map(async (exName) => {
+                        try {
+                            const adapter = await getAdapterForExchange(exName);
+                            const payments = await adapter.getFundingPayments(200);
+                            for (const p of payments) {
+                                const sym = p.symbol.replace("-PERP", "").toUpperCase();
+                                const key = `${exName}:${sym}`;
+                                fundingByExSym.set(key, (fundingByExSym.get(key) ?? 0) + Number(p.payment));
+                            }
+                        }
+                        catch { /* skip */ }
+                    })),
+                    // Phase 3: spot balances (parallel with Phase 1+2)
+                    Promise.allSettled(exchanges.map(async (exName) => {
+                        try {
+                            const adapter = await getAdapterForExchange(exName);
+                            if (exName === "hyperliquid") {
+                                const { HyperliquidSpotAdapter } = await import("../exchanges/hyperliquid-spot.js");
+                                const { HyperliquidAdapter } = await import("../exchanges/hyperliquid.js");
+                                const hlSpot = new HyperliquidSpotAdapter(adapter);
+                                await hlSpot.init();
+                                const bals = await hlSpot.getSpotBalances();
+                                const markets = await hlSpot.getSpotMarkets();
+                                const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
+                                for (const b of bals) {
+                                    const base = b.token.replace(/-SPOT$/i, "").toUpperCase();
+                                    if (base === "USDC" || Number(b.total) <= 0)
+                                        continue;
+                                    const price = priceMap.get(base) ?? 0;
+                                    const value = price * Number(b.total);
+                                    if (value < 1)
+                                        continue;
+                                    totalSpotValue += value;
+                                    spotRows.push([chalk.white.bold(base), chalk.gray("hyperliquid"), b.total, `$${formatUsd(price)}`, `$${formatUsd(value)}`]);
+                                }
+                            }
+                            else if (exName === "lighter") {
+                                const { LighterAdapter } = await import("../exchanges/lighter.js");
+                                const { LighterSpotAdapter } = await import("../exchanges/lighter-spot.js");
+                                const ltSpot = new LighterSpotAdapter(adapter);
+                                await ltSpot.init();
+                                const bals = await ltSpot.getSpotBalances();
+                                const markets = await ltSpot.getSpotMarkets();
+                                const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
+                                for (const b of bals) {
+                                    if (b.token === "USDC" || b.token === "USDC_SPOT" || Number(b.total) <= 0)
+                                        continue;
+                                    const price = priceMap.get(b.token.toUpperCase()) ?? 0;
+                                    const value = price * Number(b.total);
+                                    if (value < 1)
+                                        continue;
+                                    totalSpotValue += value;
+                                    spotRows.push([chalk.white.bold(b.token), chalk.gray("lighter"), b.total, `$${formatUsd(price)}`, `$${formatUsd(value)}`]);
+                                }
+                            }
+                        }
+                        catch { /* spot not available */ }
+                    })),
+                ]);
                 const summary = buildSummary(snapshots);
                 if (isJson()) {
                     return printJson(jsonOk(summary));
@@ -955,7 +1032,6 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                         chalk.green("connected"),
                     ];
                 });
-                // Totals row
                 balRows.push([
                     chalk.cyan.bold("TOTAL"),
                     chalk.cyan.bold(`$${formatUsd(summary.totalEquity)}`),
@@ -965,21 +1041,6 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                     "",
                 ]);
                 console.log(makeTable(["Exchange", "Equity", "Available", "Margin Used", "uPnL", "Status"], balRows));
-                // ── Positions + Funding ──
-                // Fetch funding per exchange in parallel
-                const fundingByExSym = new Map();
-                await Promise.allSettled(exchanges.map(async (exName) => {
-                    try {
-                        const adapter = await getAdapterForExchange(exName);
-                        const payments = await adapter.getFundingPayments(200);
-                        for (const p of payments) {
-                            const sym = p.symbol.replace("-PERP", "").toUpperCase();
-                            const key = `${exName}:${sym}`;
-                            fundingByExSym.set(key, (fundingByExSym.get(key) ?? 0) + Number(p.payment));
-                        }
-                    }
-                    catch { /* skip */ }
-                }));
                 if (summary.positions.length > 0) {
                     console.log(chalk.white.bold("\n  Open Positions"));
                     const posRows = summary.positions.map(p => {
@@ -1005,65 +1066,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                 else {
                     console.log(chalk.gray("\n  No open positions.\n"));
                 }
-                // ── Spot Holdings ──
-                const spotRows = [];
-                let totalSpotValue = 0;
-                for (const exName of exchanges) {
-                    try {
-                        const adapter = await getAdapterForExchange(exName);
-                        if (exName === "hyperliquid") {
-                            const { HyperliquidSpotAdapter } = await import("../exchanges/hyperliquid-spot.js");
-                            const hlSpot = new HyperliquidSpotAdapter(adapter);
-                            await hlSpot.init();
-                            const bals = await hlSpot.getSpotBalances();
-                            const markets = await hlSpot.getSpotMarkets();
-                            const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
-                            for (const b of bals) {
-                                const base = b.token.replace(/-SPOT$/i, "").toUpperCase();
-                                if (base === "USDC" || Number(b.total) <= 0)
-                                    continue;
-                                const price = priceMap.get(base) ?? 0;
-                                const value = price * Number(b.total);
-                                if (value < 1)
-                                    continue; // skip dust
-                                totalSpotValue += value;
-                                spotRows.push([
-                                    chalk.white.bold(base),
-                                    chalk.gray("hyperliquid"),
-                                    b.total,
-                                    `$${formatUsd(price)}`,
-                                    `$${formatUsd(value)}`,
-                                ]);
-                            }
-                        }
-                        else if (exName === "lighter") {
-                            const { LighterAdapter } = await import("../exchanges/lighter.js");
-                            const { LighterSpotAdapter } = await import("../exchanges/lighter-spot.js");
-                            const ltSpot = new LighterSpotAdapter(adapter);
-                            await ltSpot.init();
-                            const bals = await ltSpot.getSpotBalances();
-                            const markets = await ltSpot.getSpotMarkets();
-                            const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
-                            for (const b of bals) {
-                                if (b.token === "USDC" || b.token === "USDC_SPOT" || Number(b.total) <= 0)
-                                    continue;
-                                const price = priceMap.get(b.token.toUpperCase()) ?? 0;
-                                const value = price * Number(b.total);
-                                if (value < 1)
-                                    continue;
-                                totalSpotValue += value;
-                                spotRows.push([
-                                    chalk.white.bold(b.token),
-                                    chalk.gray("lighter"),
-                                    b.total,
-                                    `$${formatUsd(price)}`,
-                                    `$${formatUsd(value)}`,
-                                ]);
-                            }
-                        }
-                    }
-                    catch { /* spot not available */ }
-                }
+                // ── Spot Holdings (already fetched in parallel above) ──
                 if (spotRows.length > 0) {
                     console.log(chalk.white.bold("\n  Spot Holdings"));
                     console.log(makeTable(["Token", "Exchange", "Amount", "Price", "Value"], spotRows));

package/dist/commands/agent.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 export declare function registerAgentCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/arb/index.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../../exchanges/interface.js";
+import { type ExchangeAdapter } from "../../exchanges/index.js";
 export declare function registerArbManageCommands(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/arb/index.js

@@ -1,12 +1,12 @@
 import chalk from "chalk";
 import { makeTable, formatUsd, formatPnl, printJson, jsonOk } from "../../utils.js";
+import { SPOT_PERP_TOKEN_MAP } from "../../exchanges/index.js";
 import { readExecutionLog, logExecution } from "../../execution-log.js";
 import { toHourlyRate, computeAnnualSpread } from "../../funding.js";
 import { fetchPacificaPrices, fetchHyperliquidMeta, fetchLighterOrderBookDetails, fetchLighterFundingRates, } from "../../shared-api.js";
 import { computeBasisRisk } from "../../arb-utils.js";
 import { smartOrder } from "../../smart-order.js";
 import { removePosition as persistRemovePosition, getPositions as getArbStatePositions, loadArbState } from "../../arb-state.js";
-import { SPOT_PERP_TOKEN_MAP } from "../../exchanges/spot-interface.js";
 import { fetchAllBalances, computeRebalancePlan } from "../../rebalance.js";
 import { EXCHANGE_TO_CHAIN, getBestQuote } from "../../bridge-engine.js";
 import { computeEnhancedStats } from "../../arb-history-stats.js";

package/dist/commands/arb-auto.d.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 interface FundingSnapshot {
     symbol: string;
     pacRate: number;

package/dist/commands/arb-auto.js

@@ -1,7 +1,7 @@
 import chalk from "chalk";
 import { formatUsd, printJson, jsonOk, makeTable } from "../utils.js";
 import { computeExecutableSize } from "../liquidity.js";
-import { computeMatchedSize, computeSpotPerpMatchedSize } from "../arb/sizing.js";
+import { computeMatchedSize, computeSpotPerpMatchedSize } from "../arb/index.js";
 import { computeAnnualSpread, toHourlyRate } from "../funding.js";
 import { fetchPacificaPricesRaw, parsePacificaRaw, fetchHyperliquidMetaRaw, parseHyperliquidMetaRaw, fetchLighterOrderBookDetailsRaw, fetchLighterFundingRatesRaw, parseLighterRaw, } from "../shared-api.js";
 import { scanDexArb } from "../dex-asset-map.js";

package/dist/commands/arb.d.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 export declare function registerArbCommands(program: Command, isJson: () => boolean, getAdapterForExchange?: (exchange: string) => Promise<ExchangeAdapter>): void;
 export interface PriceSnapshot {
     symbol: string;

package/dist/commands/bot.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 export declare function registerBotCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, getAdapterFor: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/bot.js

@@ -1,14 +1,8 @@
 import chalk from "chalk";
 import { printJson, jsonOk } from "../utils.js";
-import { loadBotConfig, quickGridConfig, quickDCAConfig } from "../bot/config.js";
-import { runBot } from "../bot/engine.js";
-import { PRESETS, getPreset, getPresetsByStrategy } from "../bot/presets.js";
+import { loadBotConfig, quickGridConfig, quickDCAConfig, runBot, PRESETS, getPreset, getPresetsByStrategy } from "../bot/index.js";
 import { updateJobState } from "../jobs.js";
-import { runTWAP } from "../strategies/twap.js";
-import { runFundingArb } from "../strategies/funding-arb.js";
-import { runGrid } from "../strategies/grid.js";
-import { runDCA } from "../strategies/dca.js";
-import { runTrailingStop } from "../strategies/trailing-stop.js";
+import { runTWAP, runFundingArb, runGrid, runDCA, runTrailingStop } from "../strategies/index.js";
 export function registerBotCommands(program, getAdapter, getAdapterFor, isJson) {
     const bot = program.command("bot").description("Automated trading bots with condition monitoring & risk management");
     // ── bot start <config> ──
@@ -16,6 +10,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .command("start <config>")
         .description("Start a bot from a YAML/JSON config file")
         .option("--background", "Run in background (tmux)")
+        .option("--headless", "Run without TUI dashboard")
         .option("--job-id <id>", "Job ID (set by background runner)")
         .action(async (configPath, opts) => {
         const config = loadBotConfig(configPath);
@@ -35,8 +30,9 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         const adapter = config.strategy.type === "funding-arb"
             ? await getAdapterFor(config.exchange)
             : await getAdapter();
+        const mode = resolveOutputMode(isJson, opts.headless);
         const log = makeLog();
-        await runBot(adapter, config, opts.jobId, log);
+        await runBot(adapter, config, opts.jobId, log, undefined, mode);
     });
     // ── bot quick grid ──
     bot
@@ -50,6 +46,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .option("--max-drawdown <usd>", "Stop if drawdown exceeds ($)", "100")
         .option("--max-runtime <sec>", "Max runtime in seconds", "0")
         .option("--background", "Run in background (tmux)")
+        .option("--headless", "Run without TUI dashboard")
         .option("--job-id <id>", "Job ID")
         .action(async (symbol, opts) => {
         const adapter = await getAdapter();
@@ -84,8 +81,9 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             printBotJobStarted(config.name, job.id);
             return;
         }
+        const mode = resolveOutputMode(isJson, opts.headless);
         const log = makeLog();
-        await runBot(adapter, config, opts.jobId, log);
+        await runBot(adapter, config, opts.jobId, log, undefined, mode);
     });
     // ── bot quick dca ──
     bot
@@ -96,6 +94,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .option("--trigger-drop <pct>", "Only buy when price drops X% from recent high")
         .option("--max-drawdown <usd>", "Stop if drawdown exceeds ($)", "100")
         .option("--background", "Run in background (tmux)")
+        .option("--headless", "Run without TUI dashboard")
         .option("--job-id <id>", "Job ID")
         .action(async (symbol, side, amount, interval, opts) => {
         const adapter = await getAdapter();
@@ -129,8 +128,9 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             printBotJobStarted(config.name, job.id);
             return;
         }
+        const mode = resolveOutputMode(isJson, opts.headless);
         const log = makeLog();
-        await runBot(adapter, config, opts.jobId, log);
+        await runBot(adapter, config, opts.jobId, log, undefined, mode);
     });
     // ── bot quick arb ──
     bot
@@ -144,6 +144,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .option("--interval <sec>", "Check interval in seconds", "60")
         .option("--max-drawdown <usd>", "Stop if drawdown exceeds ($)", "200")
         .option("--background", "Run in background (tmux)")
+        .option("--headless", "Run without TUI dashboard")
         .option("--job-id <id>", "Job ID")
         .action(async (opts) => {
         const exchangeNames = opts.exchanges.split(",").map(e => e.trim());
@@ -204,8 +205,9 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             printBotJobStarted(config.name, job.id);
             return;
         }
+        const mode = resolveOutputMode(isJson, opts.headless);
         const log = makeLog();
-        await runBot(primaryAdapter, config, opts.jobId, log, adapters);
+        await runBot(primaryAdapter, config, opts.jobId, log, adapters, mode);
     });
     // ── bot preset list ──
     bot
@@ -240,6 +242,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .command("preset <name> [symbol]")
         .description("Start a bot from a preset (use 'preset-list' to see options)")
         .option("--background", "Run in background (tmux)")
+        .option("--headless", "Run without TUI dashboard")
         .option("--job-id <id>", "Job ID")
         .action(async (name, symbol, opts) => {
         const preset = getPreset(name);
@@ -287,7 +290,8 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
                 console.log(chalk.cyan.bold(`\n  Starting preset: ${chalk.white(preset.name)}`));
                 console.log(chalk.gray(`  ${preset.description}\n`));
             }
-            await runBot(primaryAdapter, config, opts.jobId, log, adapters);
+            const mode = resolveOutputMode(isJson, opts.headless);
+            await runBot(primaryAdapter, config, opts.jobId, log, adapters, mode);
             return;
         }
         // Grid / DCA presets
@@ -312,7 +316,180 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             console.log(chalk.cyan.bold(`\n  Starting preset: ${chalk.white(preset.name)}`));
             console.log(chalk.gray(`  ${preset.description}\n`));
         }
-        await runBot(adapter, config, opts.jobId, log);
+        const mode = resolveOutputMode(isJson, opts.headless);
+        await runBot(adapter, config, opts.jobId, log, undefined, mode);
+    });
+    // ── bot list-strategies ──
+    bot
+        .command("list-strategies")
+        .description("List all available trading strategies")
+        .action(async () => {
+        await import("../bot/engine.js");
+        const { listStrategies } = await import("../bot/strategy-registry.js");
+        const strategies = listStrategies();
+        if (isJson())
+            return printJson(jsonOk({ strategies }));
+        console.log(chalk.cyan.bold("\n  Available Strategies:\n"));
+        for (const s of strategies) {
+            console.log(`    ${chalk.white(s)}`);
+        }
+        console.log();
+    });
+    // ── bot apex ──
+    bot
+        .command("apex [symbol]")
+        .description("Start APEX autonomous orchestrator")
+        .option("--preset <preset>", "Preset: default, conservative, aggressive", "default")
+        .option("--max-slots <n>", "Max concurrent positions", "3")
+        .option("--daily-limit <usd>", "Daily loss limit in USD", "250")
+        .option("--headless", "Run without TUI dashboard")
+        .action(async (symbol, opts) => {
+        const adapter = await getAdapter();
+        const sym = (symbol ?? "ETH").toUpperCase();
+        const config = {
+            name: `apex-${sym.toLowerCase()}-${Date.now().toString(36)}`,
+            exchange: adapter.name,
+            symbol: sym,
+            strategy: {
+                type: "apex",
+                preset: opts.preset,
+                max_slots: parseInt(opts.maxSlots),
+            },
+            entry_conditions: [{ type: "always", value: 0 }],
+            exit_conditions: [],
+            risk: {
+                max_position_usd: 1000,
+                max_daily_loss: parseFloat(opts.dailyLimit),
+                max_drawdown: parseFloat(opts.dailyLimit) * 2,
+                pause_after_loss_sec: 300,
+                max_open_bots: 1,
+            },
+            monitor_interval_sec: 10,
+        };
+        const mode = resolveOutputMode(isJson, opts.headless);
+        const log = makeLog();
+        await runBot(adapter, config, undefined, log, undefined, mode);
+    });
+    // ── bot reflect ──
+    bot
+        .command("reflect")
+        .description("Analyze trading performance")
+        .option("--period <days>", "Analysis period in days", "7")
+        .action(async (opts) => {
+        const { readJournal } = await import("../bot/trade-journal.js");
+        const { analyzePerformance } = await import("../bot/reflect.js");
+        const periodDays = Number(opts.period);
+        const entries = readJournal({ from: Date.now() - periodDays * 86400000 });
+        const report = analyzePerformance(entries, periodDays);
+        if (isJson())
+            return printJson(jsonOk(report));
+        console.log(chalk.cyan.bold("\n  Performance Report\n"));
+        console.log(`  Period:        ${chalk.white(`${report.period.days}d`)} (${new Date(report.period.from).toLocaleDateString()} – ${new Date(report.period.to).toLocaleDateString()})`);
+        console.log(`  Total trades:  ${chalk.white(report.totalTrades)}`);
+        if (report.totalTrades === 0) {
+            console.log(chalk.gray("\n  No trades in the selected period.\n"));
+            return;
+        }
+        const wrColor = report.winRate >= 0.5 ? chalk.green : chalk.red;
+        console.log(`  Win rate:      ${wrColor((report.winRate * 100).toFixed(1) + "%")}`);
+        console.log(`  Avg win:       ${chalk.green(`$${report.avgWin.toFixed(2)}`)}`);
+        console.log(`  Avg loss:      ${chalk.red(`$${report.avgLoss.toFixed(2)}`)}`);
+        const pfColor = report.profitFactor >= 1.0 ? chalk.green : chalk.red;
+        console.log(`  Profit factor: ${pfColor(report.profitFactor === Infinity ? "∞" : report.profitFactor.toFixed(2))}`);
+        console.log(`  Fee drag:      ${chalk.yellow((report.feeDragRatio * 100).toFixed(1) + "%")}`);
+        console.log(`  Direction:     ${chalk.gray(`long ${(report.directionSplit.long * 100).toFixed(0)}% / short ${(report.directionSplit.short * 100).toFixed(0)}%`)}`);
+        if (report.bestStrategy)
+            console.log(`  Best strategy: ${chalk.green(report.bestStrategy)}`);
+        if (report.worstStrategy && report.worstStrategy !== report.bestStrategy)
+            console.log(`  Worst strategy:${chalk.red(report.worstStrategy)}`);
+        console.log(chalk.cyan.bold("\n  Suggestions:\n"));
+        for (const s of report.suggestions) {
+            console.log(`    ${chalk.white("•")} ${chalk.gray(s)}`);
+        }
+        console.log();
+    });
+    // ── bot run <strategy> <symbol> ──
+    bot
+        .command("run <strategy> [symbol]")
+        .description("Run any registered strategy (symbol optional for multi-symbol strategies like funding-auto)")
+        .option("--config <path>", "YAML/JSON config file")
+        .option("--headless", "Run without TUI dashboard")
+        .option("--param <key=value>", "Strategy parameter (repeatable)", (val, acc) => [...acc, val], [])
+        .action(async (strategyName, symbol, opts) => {
+        const sym = symbol?.toUpperCase() || "ALL";
+        // Load or build config
+        let config;
+        if (opts.config) {
+            config = loadBotConfig(opts.config);
+            // Override strategy type and symbol from CLI args
+            config.strategy = { ...config.strategy, type: strategyName };
+            config.symbol = sym;
+        }
+        else {
+            // Parse --param key=value pairs
+            const params = { type: strategyName };
+            for (const kv of opts.param) {
+                const eq = kv.indexOf("=");
+                if (eq === -1)
+                    continue;
+                const key = kv.slice(0, eq);
+                const raw = kv.slice(eq + 1);
+                // Try to coerce numbers and booleans
+                if (raw === "true")
+                    params[key] = true;
+                else if (raw === "false")
+                    params[key] = false;
+                else if (!isNaN(Number(raw)) && raw !== "")
+                    params[key] = Number(raw);
+                else
+                    params[key] = raw;
+            }
+            const adapter = await getAdapter();
+            config = {
+                name: `${strategyName}-${sym.toLowerCase()}-${Date.now().toString(36)}`,
+                exchange: adapter.name,
+                symbol: sym,
+                strategy: params,
+                entry_conditions: [{ type: "always", value: 0 }],
+                exit_conditions: [],
+                risk: {
+                    max_position_usd: 1000,
+                    max_daily_loss: 100,
+                    max_drawdown: 200,
+                    pause_after_loss_sec: 300,
+                    max_open_bots: 5,
+                },
+                monitor_interval_sec: 10,
+            };
+        }
+        // Verify strategy is registered
+        await import("../bot/engine.js");
+        const { getStrategy } = await import("../bot/strategy-registry.js");
+        if (!getStrategy(strategyName)) {
+            console.error(chalk.red(`\n  Unknown strategy: "${strategyName}"`));
+            console.error(chalk.gray(`  Run 'perp bot list-strategies' to see available strategies.\n`));
+            return;
+        }
+        const adapter = await getAdapter();
+        config.exchange = adapter.name;
+        const mode = resolveOutputMode(isJson, opts.headless);
+        const log = makeLog();
+        // Multi-exchange strategies need all adapters
+        let extraAdapters;
+        const multiExchangeStrategies = ["funding-auto", "funding-arb", "funding-arb-v2", "basis-arb", "hedge-agent"];
+        if (multiExchangeStrategies.includes(strategyName) && getAdapterFor) {
+            extraAdapters = new Map();
+            for (const ex of ["pacifica", "hyperliquid", "lighter"]) {
+                if (ex === adapter.name)
+                    continue;
+                try {
+                    const a = await getAdapterFor(ex);
+                    extraAdapters.set(ex, a);
+                }
+                catch { /* skip unavailable exchanges */ }
+            }
+        }
+        await runBot(adapter, config, undefined, log, extraAdapters, mode);
     });
     // ── bot example ──
     bot
@@ -341,6 +518,13 @@ function makeLog() {
         console.log(`${chalk.gray(ts)} ${msg}`);
     };
 }
+function resolveOutputMode(isJson, headless) {
+    if (isJson())
+        return "json";
+    if (headless)
+        return "headless";
+    return process.stdout.isTTY ? "tui" : "headless";
+}
 function printBotJobStarted(name, jobId) {
     console.log(chalk.green(`\n  Bot "${name}" started in background.`));
     console.log(`  Job ID: ${chalk.white.bold(jobId)}`);