perp-cli 0.11.0 → 0.12.0

package/dist/commands/pnl.d.ts

@@ -1,12 +0,0 @@
-/**
- * PnL Tracker CLI commands.
- *
- * perp pnl snapshot  — take one-time equity snapshots across exchanges
- * perp pnl track     — continuous equity tracking (foreground)
- * perp pnl daily     — daily PnL breakdown table
- * perp pnl weekly    — weekly PnL breakdown table
- * perp pnl summary   — performance summary (Sharpe, drawdown, win rate)
- */
-import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
-export declare function registerPnlCommands(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/pnl.js

@@ -1,243 +0,0 @@
-/**
- * PnL Tracker CLI commands.
- *
- * perp pnl snapshot  — take one-time equity snapshots across exchanges
- * perp pnl track     — continuous equity tracking (foreground)
- * perp pnl daily     — daily PnL breakdown table
- * perp pnl weekly    — weekly PnL breakdown table
- * perp pnl summary   — performance summary (Sharpe, drawdown, win rate)
- */
-import chalk from "chalk";
-import { printJson, jsonOk, jsonError, makeTable, formatUsd, formatPnl, withJsonErrors } from "../utils.js";
-import { saveEquitySnapshot, readEquityHistory, computePnlMetrics, computeDailyPnl, aggregateWeekly, } from "../equity-tracker.js";
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
-function parseSince(since) {
-    if (!since)
-        return undefined;
-    const match = since.match(/^(\d+)(h|d|w)$/);
-    if (match) {
-        const [, num, unit] = match;
-        const ms = { h: 3600000, d: 86400000, w: 604800000 }[unit] ?? 86400000;
-        return new Date(Date.now() - parseInt(num) * ms);
-    }
-    return new Date(since);
-}
-/** Take equity snapshot for given adapters. */
-async function takeSnapshot(getAdapterForExchange, exchanges) {
-    const ts = new Date().toISOString();
-    const snaps = [];
-    const results = await Promise.allSettled(exchanges.map(async (ex) => {
-        const adapter = await getAdapterForExchange(ex);
-        const [balance, positions] = await Promise.all([
-            adapter.getBalance(),
-            adapter.getPositions(),
-        ]);
-        const snap = {
-            ts,
-            exchange: ex,
-            equity: Number(balance.equity),
-            available: Number(balance.available),
-            marginUsed: Number(balance.marginUsed),
-            unrealizedPnl: Number(balance.unrealizedPnl),
-            positionCount: positions.filter(p => Number(p.size) > 0).length,
-        };
-        saveEquitySnapshot(snap);
-        return snap;
-    }));
-    for (const r of results) {
-        if (r.status === "fulfilled")
-            snaps.push(r.value);
-    }
-    return snaps;
-}
-export function registerPnlCommands(program, getAdapterForExchange, isJson) {
-    const pnl = program.command("pnl").description("Equity snapshot tracking & time-series performance (Sharpe, drawdown)");
-    // ── pnl snapshot ──
-    pnl
-        .command("snapshot")
-        .description("Take equity snapshot across all exchanges")
-        .option("--exchanges <list>", "Comma-separated exchange list", EXCHANGES.join(","))
-        .action(async (opts) => {
-        await withJsonErrors(isJson(), async () => {
-            const exchanges = opts.exchanges.split(",").map(e => e.trim());
-            const snaps = await takeSnapshot(getAdapterForExchange, exchanges);
-            if (isJson()) {
-                printJson(jsonOk({ snapshots: snaps }));
-            }
-            else {
-                const total = snaps.reduce((s, sn) => s + sn.equity, 0);
-                console.log(chalk.cyan.bold("Equity Snapshot\n"));
-                for (const s of snaps) {
-                    console.log(`  ${s.exchange.padEnd(14)} $${formatUsd(s.equity)}  ` +
-                        `avail $${formatUsd(s.available)}  ` +
-                        `uPnL ${formatPnl(s.unrealizedPnl)}  ` +
-                        `pos: ${s.positionCount}`);
-                }
-                console.log(`\n  ${"Total".padEnd(14)} $${formatUsd(total)}`);
-                console.log(chalk.gray(`\n  Saved at ${snaps[0]?.ts ?? "—"}`));
-            }
-        });
-    });
-    // ── pnl track ──
-    pnl
-        .command("track")
-        .description("Continuously track equity (foreground)")
-        .option("--interval <sec>", "Snapshot interval in seconds", "300")
-        .option("--exchanges <list>", "Comma-separated exchange list", EXCHANGES.join(","))
-        .action(async (opts) => {
-        const intervalMs = parseInt(opts.interval) * 1000;
-        const exchanges = opts.exchanges.split(",").map(e => e.trim());
-        console.log(chalk.cyan(`PnL tracker started — snapshot every ${opts.interval}s for [${exchanges.join(", ")}]`));
-        console.log(chalk.gray("Press Ctrl+C to stop\n"));
-        const controller = new AbortController();
-        process.on("SIGINT", () => controller.abort());
-        // Initial snapshot
-        const snaps = await takeSnapshot(getAdapterForExchange, exchanges);
-        const total = snaps.reduce((s, sn) => s + sn.equity, 0);
-        console.log(`${chalk.gray(new Date().toLocaleTimeString())} Total equity: $${formatUsd(total)}`);
-        while (!controller.signal.aborted) {
-            await new Promise((resolve) => {
-                const timer = setTimeout(resolve, intervalMs);
-                controller.signal.addEventListener("abort", () => { clearTimeout(timer); resolve(); }, { once: true });
-            });
-            if (controller.signal.aborted)
-                break;
-            try {
-                const s = await takeSnapshot(getAdapterForExchange, exchanges);
-                const t = s.reduce((sum, sn) => sum + sn.equity, 0);
-                const delta = t - total;
-                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ` +
-                    `Total: $${formatUsd(t)}  ${formatPnl(delta)}`);
-            }
-            catch (err) {
-                console.error(chalk.red(`Snapshot error: ${err instanceof Error ? err.message : err}`));
-            }
-        }
-    });
-    // ── pnl daily ──
-    pnl
-        .command("daily")
-        .description("Daily PnL breakdown")
-        .option("--exchange <name>", "Single exchange filter")
-        .option("--days <n>", "Number of days to show", "14")
-        .option("--since <period>", "Time range (e.g. 7d, 2w, 30d)")
-        .action(async (opts) => {
-        await withJsonErrors(isJson(), async () => {
-            const since = parseSince(opts.since) ?? new Date(Date.now() - parseInt(opts.days) * 86400000);
-            const snapshots = readEquityHistory({ exchange: opts.exchange, since });
-            if (snapshots.length === 0) {
-                if (isJson()) {
-                    printJson(jsonError("NO_DATA", "No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
-                }
-                else {
-                    console.log(chalk.yellow("No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
-                }
-                return;
-            }
-            const daily = computeDailyPnl(snapshots, opts.exchange);
-            if (isJson()) {
-                printJson(jsonOk({ daily }));
-            }
-            else {
-                console.log(chalk.cyan.bold(`Daily PnL${opts.exchange ? ` (${opts.exchange})` : ""}\n`));
-                const head = ["Date", "Start", "End", "PnL", "PnL %"];
-                const rows = daily.map(d => [
-                    d.date,
-                    `$${formatUsd(d.startEquity)}`,
-                    `$${formatUsd(d.endEquity)}`,
-                    formatPnl(d.pnl),
-                    `${d.pnlPct >= 0 ? "+" : ""}${d.pnlPct.toFixed(2)}%`,
-                ]);
-                console.log(makeTable(head, rows));
-            }
-        });
-    });
-    // ── pnl weekly ──
-    pnl
-        .command("weekly")
-        .description("Weekly PnL breakdown")
-        .option("--exchange <name>", "Single exchange filter")
-        .option("--weeks <n>", "Number of weeks to show", "8")
-        .option("--since <period>", "Time range (e.g. 4w, 8w)")
-        .action(async (opts) => {
-        await withJsonErrors(isJson(), async () => {
-            const since = parseSince(opts.since) ?? new Date(Date.now() - parseInt(opts.weeks) * 7 * 86400000);
-            const snapshots = readEquityHistory({ exchange: opts.exchange, since });
-            if (snapshots.length === 0) {
-                if (isJson()) {
-                    printJson(jsonError("NO_DATA", "No equity snapshots found."));
-                }
-                else {
-                    console.log(chalk.yellow("No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
-                }
-                return;
-            }
-            const daily = computeDailyPnl(snapshots, opts.exchange);
-            const weekly = aggregateWeekly(daily);
-            if (isJson()) {
-                printJson(jsonOk({ weekly }));
-            }
-            else {
-                console.log(chalk.cyan.bold(`Weekly PnL${opts.exchange ? ` (${opts.exchange})` : ""}\n`));
-                const head = ["Week", "Start", "End", "PnL", "PnL %"];
-                const rows = weekly.map(w => [
-                    w.date,
-                    `$${formatUsd(w.startEquity)}`,
-                    `$${formatUsd(w.endEquity)}`,
-                    formatPnl(w.pnl),
-                    `${w.pnlPct >= 0 ? "+" : ""}${w.pnlPct.toFixed(2)}%`,
-                ]);
-                console.log(makeTable(head, rows));
-            }
-        });
-    });
-    // ── pnl summary ──
-    pnl
-        .command("summary")
-        .description("Performance summary — Sharpe, drawdown, win rate")
-        .option("--exchange <name>", "Single exchange filter")
-        .option("--since <period>", "Time range (e.g. 7d, 30d, 12w)")
-        .action(async (opts) => {
-        await withJsonErrors(isJson(), async () => {
-            const since = parseSince(opts.since);
-            const snapshots = readEquityHistory({ exchange: opts.exchange, since });
-            if (snapshots.length === 0) {
-                if (isJson()) {
-                    printJson(jsonError("NO_DATA", "No equity snapshots found."));
-                }
-                else {
-                    console.log(chalk.yellow("No equity snapshots found. Run 'perp pnl snapshot' or 'perp pnl track' first."));
-                }
-                return;
-            }
-            const metrics = computePnlMetrics(snapshots, opts.exchange);
-            if (isJson()) {
-                printJson(jsonOk({
-                    ...metrics,
-                    dailyReturns: undefined, // omit large array from JSON
-                    dailyCount: metrics.dailyReturns.length,
-                }));
-            }
-            else {
-                console.log(chalk.cyan.bold(`Performance Summary${opts.exchange ? ` (${opts.exchange})` : ""}\n`));
-                console.log(`  Period:          ${metrics.period.from} → ${metrics.period.to} (${metrics.period.days} days)`);
-                console.log(`  Total Return:    ${formatPnl(metrics.totalReturn)} (${metrics.totalReturnPct >= 0 ? "+" : ""}${metrics.totalReturnPct.toFixed(2)}%)`);
-                console.log(`  Peak Equity:     $${formatUsd(metrics.peakEquity)}`);
-                console.log(`  Avg Daily PnL:   ${formatPnl(metrics.avgDailyPnl)}`);
-                console.log();
-                console.log(`  Sharpe Ratio:    ${metrics.sharpeRatio >= 0 ? chalk.green(metrics.sharpeRatio.toFixed(2)) : chalk.red(metrics.sharpeRatio.toFixed(2))}`);
-                console.log(`  Max Drawdown:    ${chalk.red(`$${formatUsd(metrics.maxDrawdown)}`)} (${chalk.red(`-${metrics.maxDrawdownPct.toFixed(2)}%`)})`);
-                console.log(`  Current DD:      $${formatUsd(metrics.currentDrawdown)} (-${metrics.currentDrawdownPct.toFixed(2)}%)`);
-                console.log();
-                console.log(`  Win Days:        ${chalk.green(String(metrics.winDays))} / ${metrics.winDays + metrics.lossDays}`);
-                console.log(`  Win Rate:        ${metrics.winRate.toFixed(1)}%`);
-                if (metrics.bestDay) {
-                    console.log(`  Best Day:        ${metrics.bestDay.date}  ${formatPnl(metrics.bestDay.pnl)}`);
-                }
-                if (metrics.worstDay) {
-                    console.log(`  Worst Day:       ${metrics.worstDay.date}  ${formatPnl(metrics.worstDay.pnl)}`);
-                }
-            }
-        });
-    });
-}

package/dist/commands/run.d.ts

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

package/dist/commands/run.js

@@ -1,202 +0,0 @@
-import { printJson, jsonOk } from "../utils.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 chalk from "chalk";
-export function registerRunCommands(program, getAdapter, getAdapterFor, isJson) {
-    const run = program.command("run").description("Run a strategy (foreground or as background job target)");
-    run
-        .command("twap <symbol> <side> <size> <duration>")
-        .description("Run client-side TWAP (splits market orders over time)")
-        .option("-s, --slices <n>", "Number of slices (default: auto)")
-        .option("--job-id <id>", "Job ID (set automatically for background jobs)")
-        .action(async (symbol, side, size, duration, opts) => {
-        const s = side.toLowerCase();
-        if (s !== "buy" && s !== "sell") {
-            console.error(chalk.red("Side must be buy or sell"));
-            process.exit(1);
-        }
-        const adapter = await getAdapter();
-        const params = {
-            symbol: symbol.toUpperCase(),
-            side: s,
-            totalSize: parseFloat(size),
-            durationSec: parseInt(duration),
-            slices: opts.slices ? parseInt(opts.slices) : undefined,
-        };
-        const log = (msg) => {
-            const ts = new Date().toLocaleTimeString();
-            console.log(`${chalk.gray(ts)} ${msg}`);
-        };
-        const result = await runTWAP(adapter, params, opts.jobId, log);
-        if (isJson())
-            printJson(jsonOk(result));
-        if (opts.jobId) {
-            updateJobState(opts.jobId, { status: "done" });
-        }
-    });
-    run
-        .command("funding-arb")
-        .description("Run funding rate arbitrage monitor/executor")
-        .option("--min-spread <pct>", "Min annual spread % to enter", "10")
-        .option("--close-spread <pct>", "Close when spread drops below (%)", "5")
-        .option("--size <size>", "Position size per leg (base amount)", "0.01")
-        .option("--size-usd <usd>", "Position size per leg in USD (alternative)")
-        .option("--symbols <list>", "Comma-separated symbol filter")
-        .option("--interval <sec>", "Check interval in seconds", "60")
-        .option("--auto-execute", "Actually place trades (default: monitor only)")
-        .option("--max-positions <n>", "Max simultaneous positions", "3")
-        .option("--exchanges <list>", "Comma-separated exchanges to use", "pacifica,hyperliquid,lighter")
-        .option("--auto-rebalance", "Trigger rebalance alerts when exchange balance is low")
-        .option("--rebalance-threshold <usd>", "Rebalance when available < this ($)", "100")
-        .option("--max-drawdown <usd>", "Close all positions if total uPnL exceeds this loss ($)")
-        .option("--job-id <id>", "Job ID (set automatically for background jobs)")
-        .action(async (opts) => {
-        const exchangeNames = opts.exchanges.split(",").map((e) => e.trim());
-        const adapters = new Map();
-        for (const name of exchangeNames) {
-            try {
-                const a = await getAdapterFor(name);
-                adapters.set(name, a);
-            }
-            catch {
-                if (!isJson())
-                    console.log(chalk.yellow(`  Skipping ${name} (no credentials)`));
-            }
-        }
-        if (adapters.size < 2) {
-            console.error(chalk.red("Need at least 2 exchanges for arbitrage. Set credentials for 2+ exchanges."));
-            process.exit(1);
-        }
-        const params = {
-            minSpread: parseFloat(opts.minSpread),
-            closeSpread: parseFloat(opts.closeSpread),
-            size: opts.size,
-            sizeUsd: opts.sizeUsd ? parseFloat(opts.sizeUsd) : undefined,
-            symbols: opts.symbols ? opts.symbols.split(",").map((s) => s.trim().toUpperCase()) : undefined,
-            intervalSec: parseInt(opts.interval),
-            autoExecute: opts.autoExecute ?? false,
-            maxPositions: parseInt(opts.maxPositions),
-            autoRebalance: opts.autoRebalance ?? false,
-            rebalanceThreshold: parseFloat(opts.rebalanceThreshold),
-            maxDrawdown: opts.maxDrawdown ? parseFloat(opts.maxDrawdown) : undefined,
-        };
-        const log = (msg) => {
-            const ts = new Date().toLocaleTimeString();
-            console.log(`${chalk.gray(ts)} ${msg}`);
-        };
-        await runFundingArb(adapters, params, opts.jobId, log);
-    });
-    // ── Grid Bot ──
-    run
-        .command("grid <symbol>")
-        .description("Run grid trading bot (places limit orders across a price range)")
-        .requiredOption("--upper <price>", "Upper price bound")
-        .requiredOption("--lower <price>", "Lower price bound")
-        .option("--grids <n>", "Number of grid lines", "10")
-        .option("--size <size>", "Total position size (base)", "0.1")
-        .option("--side <side>", "Grid bias: long, short, neutral", "neutral")
-        .option("--leverage <n>", "Leverage to set")
-        .option("--interval <sec>", "Check interval in seconds", "10")
-        .option("--max-runtime <sec>", "Max runtime in seconds (0 = forever)", "0")
-        .option("--trailing-stop <pct>", "Stop if equity drops by this % from peak")
-        .option("--job-id <id>", "Job ID (set automatically for background jobs)")
-        .action(async (symbol, opts) => {
-        const side = opts.side.toLowerCase();
-        if (side !== "long" && side !== "short" && side !== "neutral") {
-            console.error(chalk.red("Side must be long, short, or neutral"));
-            process.exit(1);
-        }
-        const adapter = await getAdapter();
-        const params = {
-            symbol: symbol.toUpperCase(),
-            side: side,
-            upperPrice: parseFloat(opts.upper),
-            lowerPrice: parseFloat(opts.lower),
-            grids: parseInt(opts.grids),
-            totalSize: parseFloat(opts.size),
-            leverage: opts.leverage ? parseInt(opts.leverage) : undefined,
-            intervalSec: parseInt(opts.interval),
-            maxRuntime: parseInt(opts.maxRuntime),
-            trailingStop: opts.trailingStop ? parseFloat(opts.trailingStop) : undefined,
-        };
-        const log = (msg) => {
-            const ts = new Date().toLocaleTimeString();
-            console.log(`${chalk.gray(ts)} ${msg}`);
-        };
-        const result = await runGrid(adapter, params, opts.jobId, log);
-        if (isJson())
-            printJson(jsonOk(result));
-        if (opts.jobId) {
-            updateJobState(opts.jobId, { status: "done" });
-        }
-    });
-    // ── DCA (Dollar Cost Averaging) ──
-    run
-        .command("dca <symbol> <side> <amount> <interval>")
-        .description("Run DCA strategy (periodic market orders at fixed intervals)")
-        .option("--orders <n>", "Total number of orders (0 = unlimited)", "0")
-        .option("--price-limit <price>", "Stop buying above / selling below this price")
-        .option("--max-runtime <sec>", "Max runtime in seconds (0 = forever)", "0")
-        .option("--job-id <id>", "Job ID (set automatically for background jobs)")
-        .action(async (symbol, side, amount, interval, opts) => {
-        const s = side.toLowerCase();
-        if (s !== "buy" && s !== "sell") {
-            console.error(chalk.red("Side must be buy or sell"));
-            process.exit(1);
-        }
-        const adapter = await getAdapter();
-        const params = {
-            symbol: symbol.toUpperCase(),
-            side: s,
-            amountPerOrder: parseFloat(amount),
-            intervalSec: parseInt(interval),
-            totalOrders: parseInt(opts.orders),
-            priceLimit: opts.priceLimit ? parseFloat(opts.priceLimit) : undefined,
-            maxRuntime: parseInt(opts.maxRuntime),
-        };
-        const log = (msg) => {
-            const ts = new Date().toLocaleTimeString();
-            console.log(`${chalk.gray(ts)} ${msg}`);
-        };
-        const result = await runDCA(adapter, params, opts.jobId, log);
-        if (isJson())
-            printJson(jsonOk(result));
-        if (opts.jobId) {
-            updateJobState(opts.jobId, { status: "done" });
-        }
-    });
-    // ── Trailing Stop ──
-    run
-        .command("trailing-stop <symbol>")
-        .description("Run client-side trailing stop (monitors price, closes position when trail % hit)")
-        .requiredOption("--trail <pct>", "Trail percentage")
-        .option("--interval <sec>", "Check interval in seconds", "5")
-        .option("--activation <price>", "Only start trailing after price reaches this level")
-        .option("--job-id <id>", "Job ID (set automatically for background jobs)")
-        .action(async (symbol, opts) => {
-        const sym = symbol.toUpperCase();
-        const trailPct = parseFloat(opts.trail);
-        const intervalSec = parseInt(opts.interval);
-        const activationPrice = opts.activation ? parseFloat(opts.activation) : undefined;
-        const adapter = await getAdapter();
-        const log = (msg) => {
-            const ts = new Date().toLocaleTimeString();
-            console.log(`${chalk.gray(ts)} ${msg}`);
-        };
-        const result = await runTrailingStop(adapter, {
-            symbol: sym,
-            trailPct,
-            intervalSec,
-            activationPrice,
-        }, opts.jobId, log);
-        if (isJson())
-            printJson(jsonOk(result));
-        if (opts.jobId) {
-            updateJobState(opts.jobId, { status: "done" });
-        }
-    });
-}

package/dist/commands/stream.d.ts

@@ -1,5 +0,0 @@
-import { Command } from "commander";
-import { type Network } from "../pacifica/index.js";
-import type { Exchange } from "../config.js";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
-export declare function registerStreamCommands(program: Command, getNetwork: () => Network, getExchange: () => Exchange, getAdapter?: () => Promise<ExchangeAdapter>): void;

package/dist/commands/stream.js

@@ -1,200 +0,0 @@
-import { PacificaWSClient } from "../pacifica/index.js";
-import chalk from "chalk";
-import { formatUsd, formatPercent } from "../utils.js";
-/** Create an HL or Lighter market feed, connected and ready. */
-async function getMarketFeed(exchange) {
-    const { createMarketFeed } = await import("../ws/market-feed.js");
-    const feed = createMarketFeed(exchange);
-    await feed.connect();
-    process.on("SIGINT", () => { feed.close(); process.exit(0); });
-    return feed;
-}
-export function registerStreamCommands(program, getNetwork, getExchange, getAdapter) {
-    const stream = program.command("stream").description("Live WebSocket streams (Ctrl+C to stop)");
-    // ── stream prices ──
-    stream
-        .command("prices")
-        .description("Stream live prices")
-        .action(async () => {
-        const exchange = getExchange();
-        if (exchange === "pacifica") {
-            const ws = new PacificaWSClient({ network: getNetwork() });
-            await ws.connect();
-            ws.subscribe("prices");
-            ws.on("prices", (msg) => {
-                const data = msg;
-                const d = data.data ?? data;
-                if (Array.isArray(d)) {
-                    d.forEach((p) => {
-                        const mark = Number(p.mark ?? p.m ?? 0);
-                        const funding = Number(p.funding ?? p.f ?? 0);
-                        const sym = String(p.symbol ?? p.s ?? "").padEnd(10);
-                        console.log(`${chalk.white.bold(sym)} $${formatUsd(mark)}  ${formatPercent(funding)}`);
-                    });
-                }
-            });
-            console.log(chalk.cyan("Streaming pacifica prices... (Ctrl+C to stop)\n"));
-        }
-        else {
-            const feed = await getMarketFeed(exchange);
-            feed.subscribePrices();
-            feed.on("prices", (updates) => {
-                for (const p of updates) {
-                    const sym = p.symbol.padEnd(10);
-                    console.log(`${chalk.white.bold(sym)} $${formatUsd(p.mid)}`);
-                }
-            });
-            console.log(chalk.cyan(`Streaming ${exchange} prices... (Ctrl+C to stop)\n`));
-        }
-        await new Promise(() => { }); // keep alive
-    });
-    // ── stream book ──
-    stream
-        .command("book <symbol>")
-        .description("Stream orderbook updates")
-        .action(async (symbol) => {
-        const exchange = getExchange();
-        const sym = symbol.toUpperCase();
-        if (exchange === "pacifica") {
-            const ws = new PacificaWSClient({ network: getNetwork() });
-            await ws.connect();
-            ws.subscribe("book", { symbol: sym });
-            ws.on("book", (msg) => {
-                const data = msg;
-                console.log(`${chalk.cyan(new Date().toLocaleTimeString())} ${JSON.stringify(data.data ?? data)}`);
-            });
-        }
-        else {
-            const feed = await getMarketFeed(exchange);
-            feed.subscribeBook(sym);
-            feed.on("book", (data) => {
-                const topBids = data.bids.slice(0, 5).map(([p, s]) => `${p}x${s}`).join(" ");
-                const topAsks = data.asks.slice(0, 5).map(([p, s]) => `${p}x${s}`).join(" ");
-                console.log(`${chalk.cyan(new Date().toLocaleTimeString())} ${chalk.green("BID")} ${topBids}  ${chalk.red("ASK")} ${topAsks}`);
-            });
-        }
-        console.log(chalk.cyan(`Streaming ${sym} orderbook on ${exchange}... (Ctrl+C to stop)\n`));
-        await new Promise(() => { });
-    });
-    // ── stream trades ──
-    stream
-        .command("trades <symbol>")
-        .description("Stream live trades")
-        .action(async (symbol) => {
-        const exchange = getExchange();
-        const sym = symbol.toUpperCase();
-        if (exchange === "pacifica") {
-            const ws = new PacificaWSClient({ network: getNetwork() });
-            await ws.connect();
-            ws.subscribe("trades", { symbol: sym });
-            ws.on("trades", (msg) => {
-                const data = msg;
-                const d = (data.data ?? data);
-                const side = String(d.side ?? d.d ?? "");
-                const price = String(d.price ?? d.p ?? "");
-                const amount = String(d.amount ?? d.a ?? "");
-                const color = side === "bid" || side === "buy" ? chalk.green : chalk.red;
-                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${color(side === "bid" ? "BUY " : "SELL")} $${formatUsd(price)} x ${amount}`);
-            });
-        }
-        else {
-            const feed = await getMarketFeed(exchange);
-            feed.subscribeTrades(sym);
-            feed.on("trade", (t) => {
-                const color = t.side === "buy" ? chalk.green : chalk.red;
-                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${color(t.side === "buy" ? "BUY " : "SELL")} $${formatUsd(t.price)} x ${t.size}`);
-            });
-        }
-        console.log(chalk.cyan(`Streaming ${sym} trades on ${exchange}... (Ctrl+C to stop)\n`));
-        await new Promise(() => { });
-    });
-    // ── stream bbo ──
-    stream
-        .command("bbo <symbol>")
-        .description("Stream best bid/offer")
-        .action(async (symbol) => {
-        const exchange = getExchange();
-        const sym = symbol.toUpperCase();
-        if (exchange === "pacifica") {
-            const ws = new PacificaWSClient({ network: getNetwork() });
-            await ws.connect();
-            ws.subscribe("bbo", { symbol: sym });
-            ws.on("bbo", (msg) => {
-                const data = msg.data ?? msg;
-                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${JSON.stringify(data)}`);
-            });
-        }
-        else {
-            // BBO derived from orderbook (HL/Lighter don't have dedicated BBO channel)
-            const feed = await getMarketFeed(exchange);
-            feed.subscribeBook(sym);
-            feed.on("book", (data) => {
-                const bid = data.bids[0] ?? ["—", "—"];
-                const ask = data.asks[0] ?? ["—", "—"];
-                console.log(`${chalk.gray(new Date().toLocaleTimeString())} ${chalk.green("bid")} ${bid[0]} (${bid[1]})  ${chalk.red("ask")} ${ask[0]} (${ask[1]})`);
-            });
-        }
-        console.log(chalk.cyan(`Streaming ${sym} BBO on ${exchange}... (Ctrl+C to stop)\n`));
-        await new Promise(() => { });
-    });
-    // ── stream candle ──
-    stream
-        .command("candle <symbol> <interval>")
-        .description("Stream candlestick data")
-        .action(async (symbol, interval) => {
-        const exchange = getExchange();
-        const sym = symbol.toUpperCase();
-        if (exchange === "pacifica") {
-            const ws = new PacificaWSClient({ network: getNetwork() });
-            await ws.connect();
-            ws.subscribe("candle", { symbol: sym, interval });
-            ws.on("candle", (msg) => {
-                const data = msg.data ?? msg;
-                const d = data;
-                console.log(`${chalk.gray(new Date().toLocaleTimeString())} O:$${formatUsd(String(d.o ?? ""))} H:$${formatUsd(String(d.h ?? ""))} L:$${formatUsd(String(d.l ?? ""))} C:$${formatUsd(String(d.c ?? ""))} V:${d.v ?? ""}`);
-            });
-        }
-        else {
-            const feed = await getMarketFeed(exchange);
-            feed.subscribeCandle(sym, interval);
-            feed.on("candle", (d) => {
-                console.log(`${chalk.gray(new Date().toLocaleTimeString())} O:$${formatUsd(d.o)} H:$${formatUsd(d.h)} L:$${formatUsd(d.l)} C:$${formatUsd(d.c)} V:${d.v}`);
-            });
-        }
-        console.log(chalk.cyan(`Streaming ${sym} ${interval} candles on ${exchange}... (Ctrl+C to stop)\n`));
-        await new Promise(() => { });
-    });
-    // ── stream events ── (unified account events as NDJSON, already exchange-agnostic)
-    if (getAdapter) {
-        stream
-            .command("events")
-            .description("Stream account events as NDJSON (positions, orders, balance, liquidation warnings)")
-            .option("--interval <ms>", "Polling interval in milliseconds", "5000")
-            .option("--liq-warn <pct>", "Liquidation warning distance %", "10")
-            .option("--log-positions", "Log position lifecycle events to ~/.perp/positions.jsonl")
-            .action(async (opts) => {
-            const adapter = await getAdapter();
-            const { startEventStream } = await import("../event-stream.js");
-            console.error(chalk.cyan(`Streaming ${adapter.name} events... (Ctrl+C to stop)\n`));
-            if (opts.logPositions) {
-                console.error(chalk.gray("  Position logging enabled → ~/.perp/positions.jsonl\n"));
-            }
-            const controller = new AbortController();
-            process.on("SIGINT", () => controller.abort());
-            let onEvent = (event) => {
-                // NDJSON: one JSON per line to stdout
-                process.stdout.write(JSON.stringify(event) + "\n");
-            };
-            if (opts.logPositions) {
-                const { attachPositionLogger } = await import("../position-history.js");
-                onEvent = attachPositionLogger(onEvent);
-            }
-            await startEventStream(adapter, {
-                intervalMs: parseInt(opts.interval),
-                liquidationWarningPct: parseFloat(opts.liqWarn),
-                onEvent,
-                signal: controller.signal,
-            });
-        });
-    }
-}