@trading-boy/cli 1.12.0 → 2.0.0

package/dist/commands/query.js

@@ -1,135 +0,0 @@
-import { Option } from 'commander';
-import chalk from 'chalk';
-import { createLogger } from '@trading-boy/core';
-import { formatConnectionError, ensureRemote } from '../utils.js';
-import { apiRequest, ApiError } from '../api-client.js';
-// ─── Logger ───
-const logger = createLogger('cli-query');
-// ─── Formatter ───
-export function formatQueryOutput(result) {
-    const lines = [];
-    // Header
-    lines.push('');
-    lines.push(chalk.bold.cyan(`  ${result.token.symbol}`) + (result.token.name ? chalk.gray(` (${result.token.name})`) : ''));
-    lines.push(chalk.gray('  ' + '─'.repeat(50)));
-    // Chains
-    if (result.token.chains.length > 0) {
-        lines.push(`  ${chalk.gray('Chains:')}     ${result.token.chains.join(', ')}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('Chains:')}     ${chalk.dim('none')}`);
-    }
-    // Narratives
-    if (result.token.narratives.length > 0) {
-        const narrs = result.token.narratives
-            .map((n) => `${n.name} ${chalk.dim(`(${n.status})`)}`)
-            .join(', ');
-        lines.push(`  ${chalk.gray('Narratives:')} ${narrs}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('Narratives:')} ${chalk.dim('none')}`);
-    }
-    lines.push('');
-    // Price
-    if (result.price.price !== null) {
-        const priceStr = `$${result.price.price.toLocaleString('en-US', {
-            minimumFractionDigits: 2,
-            maximumFractionDigits: 6,
-        })}`;
-        lines.push(`  ${chalk.gray('Price:')}      ${chalk.white.bold(priceStr)}`);
-        if (result.price.change24h !== null) {
-            const changeStr = `${result.price.change24h >= 0 ? '+' : ''}${result.price.change24h.toFixed(2)}%`;
-            const colorFn = result.price.change24h >= 0 ? chalk.green : chalk.red;
-            lines.push(`  ${chalk.gray('24h Change:')} ${colorFn(changeStr)}`);
-        }
-        else {
-            lines.push(`  ${chalk.gray('24h Change:')} ${chalk.dim('n/a')}`);
-        }
-    }
-    else {
-        lines.push(`  ${chalk.gray('Price:')}      ${chalk.dim('no data')}`);
-    }
-    // Funding rate
-    if (result.funding.fundingRate !== null) {
-        const rateStr = `${result.funding.fundingRate >= 0 ? '+' : ''}${(result.funding.fundingRate * 100).toFixed(4)}%`;
-        const colorFn = result.funding.fundingRate >= 0 ? chalk.green : chalk.red;
-        lines.push(`  ${chalk.gray('Funding:')}    ${colorFn(rateStr)}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('Funding:')}    ${chalk.dim('no perp data')}`);
-    }
-    // Whale activity
-    lines.push(`  ${chalk.gray('Whales:')}     ${result.whaleActivity.count > 0 ? chalk.yellow(String(result.whaleActivity.count)) : chalk.dim('0')} active`);
-    // Last updated
-    if (result.price.lastUpdated) {
-        const timeStr = new Date(result.price.lastUpdated).toLocaleString();
-        lines.push('');
-        lines.push(`  ${chalk.dim(`Last updated: ${timeStr}`)}`);
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-// ─── API Response → QueryResult Mapper ───
-function contextToQueryResult(pkg) {
-    return {
-        token: {
-            name: pkg.token.name ?? null,
-            symbol: pkg.token.symbol,
-            chains: Array.isArray(pkg.token.chains) ? pkg.token.chains : [],
-            narratives: Array.isArray(pkg.social?.narrativeMembership)
-                ? pkg.social.narrativeMembership.map((n) => ({ name: n.narrative, status: n.status }))
-                : [],
-        },
-        price: {
-            price: pkg.market?.price ?? null,
-            change24h: pkg.market?.priceChange24h ?? null,
-            lastUpdated: pkg._meta?.assembledAt ? new Date(pkg._meta.assembledAt) : null,
-        },
-        funding: {
-            fundingRate: pkg.market?.fundingRate ?? null,
-            lastUpdated: null,
-        },
-        whaleActivity: {
-            count: pkg.onchain?.whaleTransactions24h ?? 0,
-        },
-    };
-}
-// ─── Command Registration ───
-export function registerQueryCommand(program) {
-    program
-        .command('query <symbol>')
-        .description('Query token info, price, funding rate, and whale activity')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (symbol, options) => {
-        try {
-            // ─── Auth pre-flight ───
-            if (!(await ensureRemote()))
-                return;
-            const pkg = await apiRequest(`/api/v1/tokens/${encodeURIComponent(symbol.toUpperCase())}/context`);
-            const result = contextToQueryResult(pkg);
-            // Check if the token was actually found
-            if (result.token.name === null && result.token.chains.length === 0 && result.price.price === null) {
-                console.error(chalk.red(`Error: Token not found: ${symbol.toUpperCase()}`));
-                console.error(chalk.dim('  Check the symbol and try again. Use a symbol like SOL, JUP, or BONK.'));
-                process.exitCode = 1;
-                return;
-            }
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                console.log(formatQueryOutput(result));
-            }
-        }
-        catch (error) {
-            const message = error instanceof ApiError ? error.message : (error instanceof Error ? error.message : String(error));
-            logger.error({ error: message }, 'Query failed');
-            console.error(chalk.red(`Error: ${message}`));
-            const guidance = formatConnectionError(message);
-            if (guidance)
-                console.error(guidance);
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-}
-//# sourceMappingURL=query.js.map

package/dist/commands/replay-cmd.d.ts

@@ -1,43 +0,0 @@
-import { Command } from 'commander';
-interface ReplayTrade {
-    entryTime: string;
-    exitTime?: string;
-    direction: string;
-    setupType?: string;
-    entryPrice: number;
-    exitPrice?: number;
-    pnlPercent?: number;
-    pnlAbsolute?: number;
-    regime?: string;
-}
-interface ReplayRegimeBreakdown {
-    regime: string;
-    trades: number;
-    winRate: number;
-    avgPnlPercent: number;
-}
-interface ReplayResult {
-    jobId: string;
-    strategyId: string;
-    tokenSymbol: string;
-    from: string;
-    to: string;
-    status: 'COMPLETE' | 'FAILED';
-    error?: string;
-    summary?: {
-        totalTrades: number;
-        winRate: number;
-        avgPnlPercent: number;
-        totalPnlPercent: number;
-        maxDrawdownPercent: number;
-        sharpeRatio?: number;
-        profitFactor?: number;
-    };
-    regimeBreakdown?: ReplayRegimeBreakdown[];
-    trades?: ReplayTrade[];
-    completedAt?: string;
-}
-export declare function formatReplayResult(result: ReplayResult): string;
-export declare function registerReplayCommand(program: Command): void;
-export {};
-//# sourceMappingURL=replay-cmd.d.ts.map

package/dist/commands/replay-cmd.js

@@ -1,184 +0,0 @@
-import { Option } from 'commander';
-import chalk from 'chalk';
-import { createLogger } from '@trading-boy/core';
-import { apiRequest } from '../api-client.js';
-import { padRight, handleApiError, ensureRemote } from '../utils.js';
-// ─── Logger ───
-const logger = createLogger('cli-replay');
-// ─── Helpers ───
-function formatPercent(val) {
-    const sign = val >= 0 ? '+' : '';
-    const str = `${sign}${val.toFixed(2)}%`;
-    return val >= 0 ? chalk.green(str) : chalk.red(str);
-}
-function formatShortDate(isoString) {
-    try {
-        return new Date(isoString).toISOString().slice(0, 10);
-    }
-    catch {
-        return isoString;
-    }
-}
-// ─── Formatters ───
-export function formatReplayResult(result) {
-    const lines = [];
-    lines.push('');
-    lines.push(chalk.bold.cyan(`  Replay Results — ${result.tokenSymbol} (strategy: ${result.strategyId})`));
-    lines.push(chalk.gray('  ' + '─'.repeat(60)));
-    lines.push('');
-    if (result.status === 'FAILED') {
-        lines.push(chalk.red(`  Replay failed: ${result.error ?? 'Unknown error'}`));
-        lines.push('');
-        return lines.join('\n');
-    }
-    lines.push(`  ${chalk.gray('Period:')}           ${formatShortDate(result.from)} → ${formatShortDate(result.to)}`);
-    if (result.completedAt) {
-        lines.push(`  ${chalk.gray('Completed:')}        ${chalk.dim(new Date(result.completedAt).toISOString().slice(0, 19).replace('T', ' '))}`);
-    }
-    if (result.summary) {
-        const s = result.summary;
-        lines.push('');
-        lines.push(chalk.bold('  Summary'));
-        lines.push(`  ${chalk.gray('Total Trades:')}     ${chalk.white(String(s.totalTrades))}`);
-        lines.push(`  ${chalk.gray('Win Rate:')}         ${formatWinRate(s.winRate)}`);
-        lines.push(`  ${chalk.gray('Avg PnL %:')}        ${formatPercent(s.avgPnlPercent)}`);
-        lines.push(`  ${chalk.gray('Total PnL %:')}      ${formatPercent(s.totalPnlPercent)}`);
-        lines.push(`  ${chalk.gray('Max Drawdown:')}     ${chalk.red('-' + Math.abs(s.maxDrawdownPercent).toFixed(2) + '%')}`);
-        if (s.sharpeRatio !== undefined) {
-            const sharpeColor = s.sharpeRatio >= 1.0 ? chalk.green : s.sharpeRatio >= 0.5 ? chalk.yellow : chalk.red;
-            lines.push(`  ${chalk.gray('Sharpe Ratio:')}     ${sharpeColor(s.sharpeRatio.toFixed(2))}`);
-        }
-        if (s.profitFactor !== undefined) {
-            const pfColor = s.profitFactor >= 1.5 ? chalk.green : s.profitFactor >= 1.0 ? chalk.yellow : chalk.red;
-            lines.push(`  ${chalk.gray('Profit Factor:')}    ${pfColor(s.profitFactor.toFixed(2))}`);
-        }
-    }
-    if (result.regimeBreakdown && result.regimeBreakdown.length > 0) {
-        lines.push('');
-        lines.push(chalk.bold('  Regime Breakdown'));
-        lines.push('  ' +
-            padRight('Regime', 20) +
-            padRight('Trades', 8) +
-            padRight('Win Rate', 10) +
-            'Avg PnL %');
-        lines.push(chalk.gray('  ' + '─'.repeat(48)));
-        for (const r of result.regimeBreakdown) {
-            lines.push('  ' +
-                padRight(r.regime, 20) +
-                padRight(String(r.trades), 8) +
-                padRight(formatWinRate(r.winRate), 10) +
-                formatPercent(r.avgPnlPercent));
-        }
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-function formatWinRate(rate) {
-    const str = `${(rate * 100).toFixed(1)}%`;
-    if (rate >= 0.6)
-        return chalk.green(str);
-    if (rate >= 0.4)
-        return chalk.yellow(str);
-    return chalk.red(str);
-}
-// ─── Polling ───
-const POLL_INTERVAL_MS = 2000;
-const POLL_TIMEOUT_MS = 60000;
-async function pollReplayJob(jobId) {
-    const deadline = Date.now() + POLL_TIMEOUT_MS;
-    while (Date.now() < deadline) {
-        const status = await apiRequest(`/api/v1/replay/${encodeURIComponent(jobId)}`);
-        if (status.status === 'COMPLETE' || status.status === 'FAILED') {
-            return status;
-        }
-        // Wait before next poll
-        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
-    }
-    throw new Error(`Replay job ${jobId} did not complete within ${POLL_TIMEOUT_MS / 1000}s timeout.`);
-}
-// ─── Command Registration ───
-export function registerReplayCommand(program) {
-    program
-        .command('replay')
-        .description('Run strategy replay (backtest) over a historical period')
-        .requiredOption('--strategy <id>', 'Strategy ID')
-        .requiredOption('--token <symbol>', 'Token symbol')
-        .requiredOption('--from <date>', 'Start date (ISO-8601, e.g. 2025-01-01)')
-        .requiredOption('--to <date>', 'End date (ISO-8601, e.g. 2025-03-01)')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (options) => {
-        if (!(await ensureRemote()))
-            return;
-        // Validate dates
-        const fromDate = new Date(options.from);
-        const toDate = new Date(options.to);
-        if (isNaN(fromDate.getTime())) {
-            console.error(chalk.red(`Error: Invalid --from date: ${options.from}`));
-            process.exitCode = 1;
-            return;
-        }
-        if (isNaN(toDate.getTime())) {
-            console.error(chalk.red(`Error: Invalid --to date: ${options.to}`));
-            process.exitCode = 1;
-            return;
-        }
-        if (fromDate >= toDate) {
-            console.error(chalk.red('Error: --from must be before --to'));
-            process.exitCode = 1;
-            return;
-        }
-        // Use createSpinner for TTY-aware spinners (silent when piped)
-        const { createSpinner } = await import('../utils.js');
-        // ─── Submit replay job ───
-        let jobId;
-        const submitSpinner = (await createSpinner('Submitting replay job…')).start();
-        try {
-            const submitted = await apiRequest('/api/v1/replay', {
-                method: 'POST',
-                body: {
-                    strategyId: options.strategy,
-                    tokenSymbol: options.token.toUpperCase(),
-                    from: fromDate.toISOString(),
-                    to: toDate.toISOString(),
-                },
-            });
-            jobId = submitted.jobId;
-            submitSpinner.succeed(chalk.dim(`Job submitted: ${jobId}`));
-        }
-        catch (error) {
-            submitSpinner.fail('Failed to submit replay job');
-            handleApiError(error, 'Replay submit failed', logger);
-            return;
-        }
-        // ─── Poll until complete ───
-        const pollSpinner = (await createSpinner('Running replay…')).start();
-        let finalStatus;
-        try {
-            finalStatus = await pollReplayJob(jobId);
-            pollSpinner.stop();
-        }
-        catch (error) {
-            pollSpinner.fail('Replay timed out or encountered an error');
-            handleApiError(error, 'Replay polling failed', logger);
-            return;
-        }
-        // ─── Display results ───
-        if (!finalStatus.result) {
-            if (finalStatus.status === 'FAILED') {
-                console.error(chalk.red(`Error: Replay job failed — ${finalStatus.error ?? 'unknown error'}`));
-            }
-            else {
-                console.error(chalk.red('Error: Replay completed but returned no result data.'));
-            }
-            process.exitCode = 1;
-            return;
-        }
-        if (options.format === 'json') {
-            console.log(JSON.stringify(finalStatus.result, null, 2));
-        }
-        else {
-            console.log(formatReplayResult(finalStatus.result));
-        }
-    });
-}
-//# sourceMappingURL=replay-cmd.js.map

package/dist/commands/review.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function registerReviewCommand(journal: Command): void;
-//# sourceMappingURL=review.d.ts.map