@trading-boy/cli 1.12.0 → 2.0.0

package/dist/commands/context.js

@@ -1,405 +0,0 @@
-import { Option } from 'commander';
-import chalk from 'chalk';
-import { createLogger } from '@trading-boy/core';
-import { formatConnectionError, colorChange, colorSentiment, colorRiskScore, formatUsd, ensureRemote } from '../utils.js';
-import { apiRequest, ApiError } from '../api-client.js';
-// ─── Logger ───
-const logger = createLogger('cli-context');
-// ─── Formatters ───
-/**
- * Format the market section of a ContextPackage.
- */
-export function formatMarketSection(market) {
-    const lines = [];
-    lines.push(chalk.bold('  Market'));
-    if (!market) {
-        lines.push(`  ${chalk.dim('No market data available.')}`);
-        return lines.join('\n');
-    }
-    const priceStr = formatUsd(market.price);
-    lines.push(`  ${chalk.gray('Price:')}               ${chalk.white.bold(priceStr)}`);
-    lines.push(`  ${chalk.gray('24h Change:')}          ${colorChange(market.priceChange24h)}`);
-    lines.push(`  ${chalk.gray('Volume (24h):')}        ${formatUsd(market.volume24h)}`);
-    lines.push(`  ${chalk.gray('Market Cap:')}          ${formatUsd(market.marketCap)}`);
-    if (market.fundingRate !== null) {
-        const rateStr = `${market.fundingRate >= 0 ? '+' : ''}${(market.fundingRate * 100).toFixed(4)}%`;
-        const colorFn = market.fundingRate >= 0 ? chalk.green : chalk.red;
-        lines.push(`  ${chalk.gray('Funding Rate:')}        ${colorFn(rateStr)}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('Funding Rate:')}        ${chalk.dim('no perp data')}`);
-    }
-    if (market.openInterest !== null) {
-        lines.push(`  ${chalk.gray('Open Interest:')}       ${formatUsd(market.openInterest)}`);
-    }
-    if (market.openInterestChange24h !== null) {
-        lines.push(`  ${chalk.gray('OI Change (24h):')}     ${colorChange(market.openInterestChange24h)}`);
-    }
-    return lines.join('\n');
-}
-/**
- * Format the onchain section of a ContextPackage.
- */
-export function formatOnchainSection(onchain) {
-    const lines = [];
-    lines.push(chalk.bold('  On-Chain'));
-    if (!onchain) {
-        lines.push(`  ${chalk.dim('No on-chain data available.')}`);
-        return lines.join('\n');
-    }
-    if (onchain.mvrvZscore !== null) {
-        lines.push(`  ${chalk.gray('MVRV Z-Score:')}        ${chalk.white(onchain.mvrvZscore.toFixed(2))}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('MVRV Z-Score:')}        ${chalk.dim('n/a')}`);
-    }
-    if (onchain.sopr !== null) {
-        lines.push(`  ${chalk.gray('SOPR:')}                ${chalk.white(onchain.sopr.toFixed(4))}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('SOPR:')}                ${chalk.dim('n/a')}`);
-    }
-    const netflowStr = onchain.exchangeNetflow24h >= 0 ? `+${formatUsd(onchain.exchangeNetflow24h)}` : `-${formatUsd(Math.abs(onchain.exchangeNetflow24h))}`;
-    const netflowColor = onchain.exchangeNetflow24h >= 0 ? chalk.red : chalk.green;
-    lines.push(`  ${chalk.gray('Exchange Netflow:')}    ${netflowColor(netflowStr)}`);
-    lines.push(`  ${chalk.gray('Whale Txns (24h):')}    ${chalk.yellow(String(onchain.whaleTransactions24h))}`);
-    lines.push(`  ${chalk.gray('Active Addr Trend:')}   ${chalk.white(onchain.activeAddressesTrend)}`);
-    return lines.join('\n');
-}
-/**
- * Format the DeFi risk section of a ContextPackage.
- */
-export function formatRiskSection(defiRisk) {
-    const lines = [];
-    lines.push(chalk.bold('  DeFi Risk'));
-    if (!defiRisk) {
-        lines.push(`  ${chalk.dim('No DeFi risk data available.')}`);
-        return lines.join('\n');
-    }
-    lines.push(`  ${chalk.gray('Risk Score:')}          ${colorRiskScore(defiRisk.riskScore)}`);
-    lines.push(`  ${chalk.gray('TVL Trend:')}           ${chalk.white(defiRisk.protocolTvlTrend)}`);
-    if (defiRisk.dependencyChain.length > 0) {
-        lines.push(`  ${chalk.gray('Dependencies:')}`);
-        for (const dep of defiRisk.dependencyChain) {
-            const crit = `${(dep.criticality * 100).toFixed(0)}%`;
-            lines.push(`    ${chalk.dim('\u2022')} ${dep.name} ${chalk.dim(`(${dep.type})`)} criticality: ${crit}`);
-        }
-    }
-    if (defiRisk.concentrationRisks.length > 0) {
-        lines.push(`  ${chalk.gray('Concentration Risks:')}`);
-        for (const risk of defiRisk.concentrationRisks) {
-            lines.push(`    ${chalk.red('\u26A0')} ${risk}`);
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Format the catalysts section of a ContextPackage.
- */
-export function formatCatalystsSection(catalysts) {
-    const lines = [];
-    lines.push(chalk.bold('  Catalysts'));
-    if (!catalysts) {
-        lines.push(`  ${chalk.dim('No catalyst data available.')}`);
-        return lines.join('\n');
-    }
-    // Upcoming events
-    if (catalysts.upcomingEvents.length > 0) {
-        lines.push(`  ${chalk.gray('Upcoming Events:')}`);
-        for (const event of catalysts.upcomingEvents.slice(0, 5)) {
-            const date = event.scheduledDate
-                ? new Date(event.scheduledDate).toISOString().slice(0, 10)
-                : 'TBD';
-            lines.push(`    ${chalk.dim('\u2022')} ${chalk.white(date)} ${event.title ?? event.type} ${chalk.dim(`(${event.severity})`)}`);
-        }
-        if (catalysts.upcomingEvents.length > 5) {
-            lines.push(`    ${chalk.dim(`... and ${catalysts.upcomingEvents.length - 5} more`)}`);
-        }
-    }
-    else {
-        lines.push(`  ${chalk.gray('Upcoming Events:')}    ${chalk.dim('none')}`);
-    }
-    // Unlock pressure
-    const unlock = catalysts.unlockPressure;
-    if (unlock.nextUnlockDate) {
-        const unlockDate = new Date(unlock.nextUnlockDate).toISOString().slice(0, 10);
-        const pctStr = unlock.nextUnlockPct !== null
-            ? `${unlock.nextUnlockPct.toFixed(2)}%`
-            : 'unknown %';
-        lines.push(`  ${chalk.gray('Next Unlock:')}         ${unlockDate} (${pctStr}) ${chalk.dim(`[${unlock.materiality}]`)}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('Next Unlock:')}         ${chalk.dim('none scheduled')}`);
-    }
-    return lines.join('\n');
-}
-/**
- * Format the social section of a ContextPackage.
- */
-export function formatSocialSection(social) {
-    const lines = [];
-    lines.push(chalk.bold('  Social'));
-    if (!social) {
-        lines.push(`  ${chalk.dim('No social data available.')}`);
-        return lines.join('\n');
-    }
-    lines.push(`  ${chalk.gray('Sentiment (24h):')}     ${colorSentiment(social.sentiment24h)}`);
-    lines.push(`  ${chalk.gray('Sentiment Trend:')}     ${chalk.white(social.sentimentTrend)}`);
-    if (social.mindshareRank !== null) {
-        lines.push(`  ${chalk.gray('Mindshare Rank:')}      #${social.mindshareRank}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('Mindshare Rank:')}      ${chalk.dim('n/a')}`);
-    }
-    if (social.narrativeMembership.length > 0) {
-        lines.push(`  ${chalk.gray('Narratives:')}`);
-        for (const n of social.narrativeMembership) {
-            const conf = `${(n.membership * 100).toFixed(0)}%`;
-            lines.push(`    ${chalk.dim('\u2022')} ${n.narrative} ${chalk.dim(`(${n.status})`)} confidence: ${conf}`);
-        }
-    }
-    if (social.notableMentions.length > 0) {
-        lines.push(`  ${chalk.gray('Notable Mentions:')}`);
-        for (const mention of social.notableMentions.slice(0, 3)) {
-            const truncated = mention.length > 60 ? mention.slice(0, 57) + '...' : mention;
-            lines.push(`    ${chalk.dim('\u2022')} ${truncated}`);
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Format the synthesis section of a ContextPackage.
- */
-export function formatSynthesisSection(synthesis) {
-    const lines = [];
-    lines.push(chalk.bold('  Synthesis'));
-    if (!synthesis) {
-        lines.push(`  ${chalk.dim('No synthesis available.')}`);
-        return lines.join('\n');
-    }
-    lines.push(`  ${chalk.gray('Regime:')}              ${chalk.white.bold(synthesis.regime)}`);
-    if (synthesis.regimeSummary) {
-        lines.push(`  ${chalk.gray('Regime Summary:')}      ${chalk.white(synthesis.regimeSummary)}`);
-    }
-    lines.push(`  ${chalk.gray('Signal Confluence:')}   ${chalk.white(synthesis.signalConfluence)}`);
-    if (synthesis.outlook) {
-        lines.push(`  ${chalk.gray('Outlook:')}             ${chalk.white(synthesis.outlook)}`);
-    }
-    if (synthesis.confidenceAssessment) {
-        lines.push(`  ${chalk.gray('Confidence:')}          ${chalk.white(synthesis.confidenceAssessment)}`);
-    }
-    if (synthesis.detectedSignals.length > 0) {
-        lines.push(`  ${chalk.gray('Detected Signals:')}`);
-        for (const signal of synthesis.detectedSignals) {
-            const confStr = `${(signal.confidence * 100).toFixed(0)}%`;
-            lines.push(`    ${chalk.dim('\u2022')} ${chalk.white(signal.type)} ${chalk.dim(`(${confStr})`)} ${signal.description}`);
-        }
-    }
-    if (synthesis.keyRisks.length > 0) {
-        lines.push(`  ${chalk.gray('Key Risks:')}`);
-        for (const risk of synthesis.keyRisks) {
-            lines.push(`    ${chalk.red('\u26A0')} ${risk}`);
-        }
-    }
-    if (synthesis.keyOpportunities.length > 0) {
-        lines.push(`  ${chalk.gray('Opportunities:')}`);
-        for (const opp of synthesis.keyOpportunities) {
-            lines.push(`    ${chalk.green('\u2713')} ${opp}`);
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Format the _meta section of a ContextPackage.
- */
-export function formatMetaSection(meta) {
-    const lines = [];
-    lines.push(chalk.bold('  Meta'));
-    lines.push(`  ${chalk.gray('Assembled At:')}       ${chalk.dim(meta.assembledAt)}`);
-    lines.push(`  ${chalk.gray('Cached:')}              ${meta.cached ? chalk.green('yes') : chalk.dim('no')}`);
-    lines.push(`  ${chalk.gray('Cache TTL:')}           ${chalk.dim(`${meta.cacheTtlMs}ms`)}`);
-    if (meta.missingLayers.length > 0) {
-        lines.push(`  ${chalk.gray('Missing Layers:')}     ${chalk.yellow(meta.missingLayers.join(', '))}`);
-    }
-    else {
-        lines.push(`  ${chalk.gray('Missing Layers:')}     ${chalk.green('none')}`);
-    }
-    if (Object.keys(meta.dataFreshness).length > 0) {
-        lines.push(`  ${chalk.gray('Data Freshness:')}`);
-        for (const [layer, ts] of Object.entries(meta.dataFreshness)) {
-            const freshStr = ts ?? 'n/a';
-            lines.push(`    ${chalk.dim(layer)}: ${chalk.dim(freshStr)}`);
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Format a full AssembledContextPackage for colored terminal output.
- */
-export function formatContextOutput(pkg) {
-    const lines = [];
-    // Header
-    lines.push('');
-    lines.push(chalk.bold.cyan(`  Context Package: ${pkg.token.symbol}`) + (pkg.token.name ? chalk.gray(` (${pkg.token.name})`) : ''));
-    lines.push(chalk.gray('  ' + '\u2500'.repeat(60)));
-    // Token summary
-    const chains = Array.isArray(pkg.token.chains) ? pkg.token.chains : [];
-    const tags = Array.isArray(pkg.token.narrativeTags) ? pkg.token.narrativeTags : [];
-    lines.push(`  ${chalk.gray('Chains:')}              ${chains.length > 0 ? chains.join(', ') : chalk.dim('none')}`);
-    lines.push(`  ${chalk.gray('Narrative Tags:')}      ${tags.length > 0 ? tags.join(', ') : chalk.dim('none')}`);
-    lines.push(`  ${chalk.gray('Timestamp:')}           ${chalk.dim(pkg.timestamp)}`);
-    lines.push('');
-    // Sections
-    lines.push(formatMarketSection(pkg.market));
-    lines.push('');
-    lines.push(formatOnchainSection(pkg.onchain));
-    lines.push('');
-    lines.push(formatRiskSection(pkg.defiRisk));
-    lines.push('');
-    lines.push(formatCatalystsSection(pkg.catalysts));
-    lines.push('');
-    lines.push(formatSocialSection(pkg.social));
-    lines.push('');
-    lines.push(formatSynthesisSection(pkg.synthesis));
-    lines.push('');
-    lines.push(formatMetaSection(pkg._meta));
-    lines.push('');
-    return lines.join('\n');
-}
-// ─── Historical Context Helpers ───
-function formatHistoricalHeader(symbol, snapshotTime) {
-    return chalk.bold.cyan(`  Historical Context: ${symbol}`) +
-        chalk.gray(` (snapshot: ${snapshotTime})`);
-}
-export function formatSnapshotRange(snapshots, symbol) {
-    const lines = [];
-    lines.push('');
-    lines.push(chalk.bold.cyan(`  Context History: ${symbol}`));
-    lines.push(chalk.gray('  ' + '\u2500'.repeat(60)));
-    lines.push(`  ${chalk.gray('Snapshots:')} ${snapshots.length}`);
-    lines.push('');
-    if (snapshots.length === 0) {
-        lines.push(`  ${chalk.dim('No snapshots found in the requested range.')}`);
-        lines.push('');
-        return lines.join('\n');
-    }
-    lines.push(`  ${chalk.gray('Time'.padEnd(26))} ${chalk.gray('Regime'.padEnd(16))} ${chalk.gray('Price'.padEnd(14))} ${chalk.gray('Sentiment')}`);
-    lines.push(chalk.gray('  ' + '\u2500'.repeat(60)));
-    for (const snap of snapshots) {
-        const time = snap.time.slice(0, 19).replace('T', ' ');
-        const regime = snap.regime ?? snap.context.synthesis?.regime ?? 'unknown';
-        const price = snap.context.market?.price != null ? formatUsd(snap.context.market.price) : 'n/a';
-        const sentiment = snap.context.social?.sentiment24h != null
-            ? colorSentiment(snap.context.social.sentiment24h)
-            : chalk.dim('n/a');
-        lines.push(`  ${chalk.white(time.padEnd(26))} ${chalk.white(regime.padEnd(16))} ${price.padEnd(14)} ${sentiment}`);
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-function buildHistoryQueryParams(options) {
-    const params = new URLSearchParams();
-    if (options.at)
-        params.set('timestamp', new Date(options.at).toISOString());
-    if (options.from)
-        params.set('from', new Date(options.from).toISOString());
-    if (options.to)
-        params.set('to', new Date(options.to).toISOString());
-    if (options.interval)
-        params.set('interval', options.interval);
-    if (options.traderId)
-        params.set('traderId', options.traderId);
-    return params.toString();
-}
-// ─── Command Registration ───
-export function registerContextCommand(program) {
-    program
-        .command('context <symbol>')
-        .description('Assemble and display a full ContextPackage for a token')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .option('--at <date>', 'Fetch historical context at a specific date/time (e.g., 2026-01-15 or 2026-01-15T12:00:00Z)')
-        .option('--from <date>', 'Start of time range for context history')
-        .option('--to <date>', 'End of time range for context history')
-        .addOption(new Option('--interval <interval>', 'Sampling interval for range queries').choices(['15m', '1h', '4h', '1d']))
-        .option('--trader-id <id>', 'Trader ID for personalized context')
-        .action(async (symbol, options) => {
-        try {
-            // ─── Auth pre-flight ───
-            if (!(await ensureRemote()))
-                return;
-            // ─── Validate range options ───
-            if ((options.from && !options.to) || (!options.from && options.to)) {
-                console.error(chalk.red('Error: Both --from and --to must be provided for range queries.'));
-                process.exitCode = 1;
-                return;
-            }
-            if (options.at && (options.from || options.to)) {
-                console.error(chalk.red('Error: Cannot use --at with --from/--to. Use either point-in-time or range query.'));
-                process.exitCode = 1;
-                return;
-            }
-            if (options.interval && !options.from) {
-                console.error(chalk.red('Error: --interval requires --from and --to.'));
-                process.exitCode = 1;
-                return;
-            }
-            if (options.at) {
-                // Point-in-time historical query
-                const qs = buildHistoryQueryParams(options);
-                const data = await apiRequest(`/api/v1/tokens/${encodeURIComponent(symbol.toUpperCase())}/context/at?${qs}`);
-                if (options.format === 'json') {
-                    console.log(JSON.stringify(data, null, 2));
-                }
-                else {
-                    console.log('');
-                    console.log(formatHistoricalHeader(data.symbol, data.snapshotTime));
-                    console.log(formatContextOutput(data.context));
-                }
-            }
-            else if (options.from && options.to) {
-                // Range query
-                const qs = buildHistoryQueryParams(options);
-                const data = await apiRequest(`/api/v1/tokens/${encodeURIComponent(symbol.toUpperCase())}/context/history?${qs}`);
-                if (options.format === 'json') {
-                    console.log(JSON.stringify(data, null, 2));
-                }
-                else {
-                    console.log(formatSnapshotRange(data.snapshots, data.symbol));
-                }
-            }
-            else {
-                // Live context
-                const traderQs = options.traderId ? `?traderId=${encodeURIComponent(options.traderId)}` : '';
-                const pkg = await apiRequest(`/api/v1/tokens/${encodeURIComponent(symbol.toUpperCase())}/context${traderQs}`);
-                // Check if the token was actually found
-                if (pkg.token.name == null && (!Array.isArray(pkg.token.chains) || pkg.token.chains.length === 0) && pkg.market?.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(pkg, null, 2));
-                }
-                else {
-                    console.log(formatContextOutput(pkg));
-                }
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 422) {
-                console.error(chalk.red('Error: This feature requires a subscription. Run `trading-boy subscribe` to get started.'));
-                process.exitCode = 2;
-                return;
-            }
-            const message = error instanceof ApiError ? error.message : (error instanceof Error ? error.message : String(error));
-            logger.error({ error: message }, 'Context assembly failed');
-            console.error(chalk.red(`Error: ${message}`));
-            const guidance = formatConnectionError(message);
-            if (guidance)
-                console.error(guidance);
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-}
-//# sourceMappingURL=context.js.map

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

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