@trading-boy/cli 1.12.0 → 2.0.0

package/dist/commands/social.d.ts

@@ -1,43 +0,0 @@
-import { Command } from 'commander';
-interface TokenSentiment {
-    sentiment24h: number;
-    sentimentTrend: string;
-    signalCount24h: number;
-    topTierCount: number;
-    breakdown: {
-        tier1Avg: number | null;
-        tier2Avg: number | null;
-        tier3Avg: number | null;
-    };
-}
-interface MindshareRanking {
-    rank: number;
-    compositeScore: number;
-    txCount24h: number;
-    uniqueWallets24h: number;
-    whaleVolume24h: number;
-}
-interface TokenNarrativeRecord {
-    narrativeName: string;
-    narrativeStatus: string;
-    confidence: number;
-}
-export interface SocialSignalRecord {
-    id?: string;
-    platform: string;
-    sentiment: number;
-    authorTier: string;
-    content?: string | null;
-    authorId?: string | null;
-    authorHandle?: string | null;
-    engagementScore?: number | null;
-    extractedEntities?: string[];
-    narrativeTags?: string[];
-}
-/**
- * Format the full social query output for a token.
- */
-export declare function formatTokenSocial(tokenSymbol: string, sentiment: TokenSentiment | null, mindshare: MindshareRanking | null, narratives: TokenNarrativeRecord[], signals: SocialSignalRecord[]): string;
-export declare function registerSocialCommand(program: Command): void;
-export {};
-//# sourceMappingURL=social.d.ts.map

package/dist/commands/social.js

@@ -1,318 +0,0 @@
-import { Option } from 'commander';
-import chalk from 'chalk';
-import { createLogger, Platform, AuthorTier, } from '@trading-boy/core';
-import { formatConnectionError, padRight, truncate, colorSentiment } from '../utils.js';
-import { apiRequest, ApiError } from '../api-client.js';
-// ─── Logger ───
-const logger = createLogger('cli-social');
-// ─── Formatters ───
-/**
- * Color-code a trend direction.
- */
-function colorTrend(trend) {
-    switch (trend) {
-        case 'IMPROVING':
-            return chalk.green(trend);
-        case 'DECLINING':
-            return chalk.red(trend);
-        case 'STABLE':
-        default:
-            return chalk.yellow(trend);
-    }
-}
-/**
- * Format the full social query output for a token.
- */
-export function formatTokenSocial(tokenSymbol, sentiment, mindshare, narratives, signals) {
-    const lines = [];
-    lines.push('');
-    lines.push(chalk.bold.cyan(`  Social Overview: ${tokenSymbol}`));
-    lines.push(chalk.gray('  ' + '\u2500'.repeat(60)));
-    lines.push('');
-    // ─── Sentiment section ───
-    lines.push(chalk.bold('  Sentiment'));
-    if (sentiment) {
-        lines.push(`  ${chalk.gray('24h Sentiment:')}   ${colorSentiment(sentiment.sentiment24h)}`);
-        lines.push(`  ${chalk.gray('Trend:')}           ${colorTrend(sentiment.sentimentTrend)}`);
-        lines.push(`  ${chalk.gray('Signals (24h):')}   ${sentiment.signalCount24h}`);
-        lines.push(`  ${chalk.gray('Top Tier Count:')}  ${sentiment.topTierCount}`);
-        if (sentiment.breakdown.tier1Avg !== null) {
-            lines.push(`  ${chalk.gray('Tier 1 (Mover):')}  ${colorSentiment(sentiment.breakdown.tier1Avg)}`);
-        }
-        if (sentiment.breakdown.tier2Avg !== null) {
-            lines.push(`  ${chalk.gray('Tier 2 (Alpha):')}  ${colorSentiment(sentiment.breakdown.tier2Avg)}`);
-        }
-        if (sentiment.breakdown.tier3Avg !== null) {
-            lines.push(`  ${chalk.gray('Tier 3 (Comm.):')}  ${colorSentiment(sentiment.breakdown.tier3Avg)}`);
-        }
-    }
-    else {
-        lines.push(`  ${chalk.dim('No sentiment data available.')}`);
-    }
-    lines.push('');
-    // ─── Mindshare section ───
-    lines.push(chalk.bold('  Mindshare'));
-    if (mindshare) {
-        lines.push(`  ${chalk.gray('Rank:')}            #${mindshare.rank}`);
-        lines.push(`  ${chalk.gray('Composite Score:')} ${mindshare.compositeScore.toFixed(3)}`);
-        lines.push(`  ${chalk.gray('Tx Count (24h):')}  ${mindshare.txCount24h.toLocaleString()}`);
-        lines.push(`  ${chalk.gray('Unique Wallets:')}  ${mindshare.uniqueWallets24h.toLocaleString()}`);
-        lines.push(`  ${chalk.gray('Whale Volume:')}    $${mindshare.whaleVolume24h.toLocaleString()}`);
-    }
-    else {
-        lines.push(`  ${chalk.dim('No mindshare data available.')}`);
-    }
-    lines.push('');
-    // ─── Narratives section ───
-    lines.push(chalk.bold('  Narratives'));
-    if (narratives.length > 0) {
-        for (const n of narratives) {
-            const conf = `${(n.confidence * 100).toFixed(0)}%`;
-            lines.push(`  ${chalk.white(n.narrativeName)} ${chalk.dim(`(${n.narrativeStatus})`)} — confidence: ${conf}`);
-        }
-    }
-    else {
-        lines.push(`  ${chalk.dim('Not linked to any narratives.')}`);
-    }
-    lines.push('');
-    // ─── Recent signals section ───
-    lines.push(chalk.bold('  Recent Signals'));
-    if (signals.length > 0) {
-        for (const s of signals) {
-            const sentimentStr = colorSentiment(s.sentiment);
-            const author = s.authorHandle ?? s.authorId ?? chalk.dim('unknown');
-            const content = s.content ? truncate(s.content, 50) : '-';
-            lines.push(`  ${sentimentStr} ${chalk.dim(s.authorTier)} ${chalk.gray(author)}: ${content}`);
-        }
-    }
-    else {
-        lines.push(`  ${chalk.dim('No recent signals.')}`);
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-// ─── Command Registration ───
-export function registerSocialCommand(program) {
-    const social = program
-        .command('social')
-        .description('Social signal management commands');
-    // ─── social query ───
-    social
-        .command('query <token>')
-        .description('Show social overview for a token (sentiment, mindshare, narratives, signals)')
-        .option('--limit <n>', 'Maximum number of recent signals to show', (v) => parseInt(v, 10), 5)
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (token, options) => {
-        const tokenSymbol = token.toUpperCase();
-        try {
-            const result = await apiRequest(`/api/v1/tokens/${encodeURIComponent(tokenSymbol)}/social?limit=${options.limit}`);
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            console.log(formatTokenSocial(tokenSymbol, result.sentiment, result.mindshare, result.narratives, result.signals));
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error({ error: message }, 'Failed to query social data');
-            console.error(chalk.red(`Error: ${message}`));
-            if (!(error instanceof ApiError)) {
-                const guidance = formatConnectionError(message);
-                if (guidance)
-                    console.error(guidance);
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── social add ───
-    social
-        .command('add')
-        .description('Add a manual social signal')
-        .requiredOption('--token <symbols...>', 'Token symbol(s) mentioned')
-        .requiredOption('--sentiment <value>', 'Sentiment score (-1.0 to 1.0)', parseFloat)
-        .option('--tier <tier>', `Author tier (${Object.values(AuthorTier).join(', ')})`, 'TIER2_ALPHA')
-        .option('--platform <platform>', `Platform (${Object.values(Platform).join(', ')})`, 'TWITTER')
-        .option('--content <text>', 'Signal content / note')
-        .option('--author-id <id>', 'Author identifier')
-        .option('--author-handle <handle>', 'Author handle (e.g., @username)')
-        .option('--engagement <score>', 'Engagement score (0-100)', parseFloat)
-        .option('--narrative <narratives...>', 'Narrative name(s) to link')
-        .option('--protocol <protocols...>', 'Protocol name(s) to link')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (options) => {
-        // Validate platform
-        if (!Object.values(Platform).includes(options.platform)) {
-            console.error(`Error: Invalid platform "${options.platform}". Valid platforms: ${Object.values(Platform).join(', ')}`);
-            process.exitCode = 1;
-            return;
-        }
-        // Validate author tier
-        if (!Object.values(AuthorTier).includes(options.tier)) {
-            console.error(`Error: Invalid author tier "${options.tier}". Valid tiers: ${Object.values(AuthorTier).join(', ')}`);
-            process.exitCode = 1;
-            return;
-        }
-        // Validate sentiment range
-        if (isNaN(options.sentiment) || options.sentiment < -1 || options.sentiment > 1) {
-            console.error('Error: Sentiment must be a number between -1.0 and 1.0');
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const tokens = options.token.map((t) => t.toUpperCase());
-            const body = {
-                platform: options.platform,
-                sentiment: options.sentiment,
-                authorTier: options.tier,
-                content: options.content,
-                authorId: options.authorId,
-                authorHandle: options.authorHandle,
-                engagementScore: options.engagement,
-                extractedEntities: tokens,
-                narrativeTags: options.narrative ?? [],
-                tokenSymbol: tokens[0],
-                protocolNames: options.protocol ?? [],
-            };
-            const result = await apiRequest('/api/v1/social/signals', { method: 'POST', body });
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            if (result.duplicate) {
-                console.log(`Duplicate signal detected, existing id=${result.id}`);
-                return;
-            }
-            logger.info({ id: result.id }, 'Social signal created');
-            console.log(`Signal created: id=${result.id}`);
-            console.log(`  Platform: ${options.platform}`);
-            console.log(`  Sentiment: ${options.sentiment}`);
-            console.log(`  Tier: ${options.tier}`);
-            console.log(`  Tokens: ${tokens.join(', ')}`);
-            if (options.narrative) {
-                console.log(`  Narratives: ${options.narrative.join(', ')}`);
-            }
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error({ error: message }, 'Failed to add social signal');
-            console.error(`Error: ${message}`);
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── social list ───
-    social
-        .command('list')
-        .description('List recent social signals')
-        .option('--token <symbol>', 'Filter by token symbol')
-        .option('--platform <platform>', 'Filter by platform')
-        .option('--hours <n>', 'Time window in hours', (v) => parseInt(v, 10), 24)
-        .option('--limit <n>', 'Maximum number of results', (v) => parseInt(v, 10), 20)
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (options) => {
-        try {
-            const params = new URLSearchParams();
-            if (options.token)
-                params.set('tokenSymbol', options.token.toUpperCase());
-            if (options.platform)
-                params.set('platform', options.platform);
-            params.set('hours', String(options.hours));
-            params.set('limit', String(options.limit));
-            const records = await apiRequest(`/api/v1/social/signals?${params.toString()}`);
-            if (records.length === 0) {
-                if (options.format === 'json') {
-                    console.log(JSON.stringify([], null, 2));
-                }
-                else {
-                    console.log('No signals found.');
-                }
-                return;
-            }
-            if (options.format === 'json') {
-                console.log(JSON.stringify(records, null, 2));
-                return;
-            }
-            // Print formatted table
-            console.log('');
-            console.log(padRight('Platform', 12) +
-                padRight('Sentiment', 11) +
-                padRight('Tier', 22) +
-                padRight('Entities', 20) +
-                padRight('Content', 40));
-            console.log('-'.repeat(105));
-            for (const s of records) {
-                const sentimentStr = formatSentiment(s.sentiment);
-                const entities = s.extractedEntities
-                    ? s.extractedEntities.join(', ')
-                    : '-';
-                console.log(padRight(s.platform, 12) +
-                    padRight(sentimentStr, 11) +
-                    padRight(s.authorTier, 22) +
-                    padRight(truncate(entities, 18), 20) +
-                    truncate(s.content ?? '-', 38));
-            }
-            console.log('');
-            console.log(`Total: ${records.length} signal(s)`);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error({ error: message }, 'Failed to list signals');
-            console.error(`Error: ${message}`);
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── social sentiment ───
-    social
-        .command('sentiment')
-        .description('Show aggregated sentiment for a token')
-        .requiredOption('--token <symbol>', 'Token symbol')
-        .option('--hours <n>', 'Time window in hours', (v) => parseInt(v, 10), 24)
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (options) => {
-        try {
-            const tokenSymbol = options.token.toUpperCase();
-            // Fetch signals and compute sentiment from them
-            const params = new URLSearchParams();
-            params.set('tokenSymbol', tokenSymbol);
-            params.set('hours', String(options.hours));
-            params.set('limit', '1000');
-            const signals = await apiRequest(`/api/v1/social/signals?${params.toString()}`);
-            if (signals.length === 0) {
-                if (options.format === 'json') {
-                    console.log(JSON.stringify({ tokenSymbol, hours: options.hours, signalCount: 0, average: null, min: null, max: null }, null, 2));
-                }
-                else {
-                    console.log(`No signals found for ${tokenSymbol} in the last ${options.hours}h.`);
-                }
-                return;
-            }
-            // Compute sentiment from signals
-            const sentiments = signals.map(s => s.sentiment);
-            const avgSentiment = sentiments.reduce((a, b) => a + b, 0) / sentiments.length;
-            const minSentiment = Math.min(...sentiments);
-            const maxSentiment = Math.max(...sentiments);
-            if (options.format === 'json') {
-                console.log(JSON.stringify({ tokenSymbol, hours: options.hours, signalCount: signals.length, average: avgSentiment, min: minSentiment, max: maxSentiment }, null, 2));
-                return;
-            }
-            console.log('');
-            console.log(`Sentiment for ${tokenSymbol} (last ${options.hours}h):`);
-            console.log(`  Average:  ${formatSentiment(avgSentiment)}`);
-            console.log(`  Signals:  ${signals.length}`);
-            console.log(`  Min:      ${formatSentiment(minSentiment)}`);
-            console.log(`  Max:      ${formatSentiment(maxSentiment)}`);
-            console.log('');
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error({ error: message }, 'Failed to get sentiment');
-            console.error(`Error: ${message}`);
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-}
-// ─── Helpers ───
-function formatSentiment(value) {
-    const sign = value >= 0 ? '+' : '';
-    return `${sign}${value.toFixed(2)}`;
-}
-//# sourceMappingURL=social.js.map

package/dist/commands/soul-wizard.d.ts

@@ -1,29 +0,0 @@
-export interface SoulWizardAnswers {
-    style: string;
-    riskTolerance: string;
-    assets: string[];
-    timeHorizon: string;
-    biases: string;
-}
-/**
- * Run the interactive SOUL wizard and return the generated SOUL text.
- * Throws if user aborts (Ctrl+C).
- */
-export declare function runSoulWizard(): Promise<{
-    answers: SoulWizardAnswers;
-    soulText: string;
-}>;
-/**
- * Upload a SOUL document to the trader's profile.
- */
-export declare function uploadSoul(traderName: string, soulText: string): Promise<void>;
-/**
- * Print the generated SOUL document with chalk styling.
- */
-export declare function displaySoul(soulText: string): void;
-/**
- * Run wizard + upload + display. Used by both onboarding and standalone command.
- * Returns true if SOUL was uploaded successfully.
- */
-export declare function runSoulWizardAndUpload(traderName: string): Promise<boolean>;
-//# sourceMappingURL=soul-wizard.d.ts.map

package/dist/commands/soul-wizard.js

@@ -1,155 +0,0 @@
-// ─── SOUL Wizard ───
-//
-// Interactive wizard to generate a SOUL document from guided questions.
-// Shared between onboarding flow and standalone `trader soul-wizard` command.
-import chalk from 'chalk';
-import { apiRequest, ApiError } from '../api-client.js';
-// ─── Labels ───
-const STYLE_LABELS = {
-    aggressive_momentum: 'Aggressive Momentum',
-    conservative_value: 'Conservative Value',
-    balanced: 'Balanced',
-    degen: 'Degen / High Risk',
-    macro: 'Macro / Fundamentals',
-};
-const RISK_LABELS = {
-    low: 'Low (1-3% per trade)',
-    medium: 'Medium (3-7%)',
-    high: 'High (7-15%)',
-    degen: 'Degen (15%+)',
-};
-const ASSET_LABELS = {
-    crypto: 'Crypto',
-    commodities: 'Commodities',
-    equities: 'Equities',
-    forex: 'Forex',
-};
-const HORIZON_LABELS = {
-    scalping: 'Scalping (minutes)',
-    day: 'Day trading (hours)',
-    swing: 'Swing (days)',
-    position: 'Position (weeks+)',
-};
-// ─── Wizard ───
-/**
- * Run the interactive SOUL wizard and return the generated SOUL text.
- * Throws if user aborts (Ctrl+C).
- */
-export async function runSoulWizard() {
-    const { select, checkbox, input } = await import('@inquirer/prompts');
-    const style = await select({
-        message: 'What\'s your trading style?',
-        choices: [
-            { value: 'aggressive_momentum', name: 'Aggressive Momentum' },
-            { value: 'conservative_value', name: 'Conservative Value' },
-            { value: 'balanced', name: 'Balanced' },
-            { value: 'degen', name: 'Degen / High Risk' },
-            { value: 'macro', name: 'Macro / Fundamentals' },
-        ],
-    });
-    const riskTolerance = await select({
-        message: 'Risk tolerance?',
-        choices: [
-            { value: 'low', name: 'Low (1-3% per trade)' },
-            { value: 'medium', name: 'Medium (3-7%)' },
-            { value: 'high', name: 'High (7-15%)' },
-            { value: 'degen', name: 'Degen (15%+)' },
-        ],
-    });
-    const assets = await checkbox({
-        message: 'What assets do you trade?',
-        choices: [
-            { value: 'crypto', name: 'Crypto' },
-            { value: 'commodities', name: 'Commodities' },
-            { value: 'equities', name: 'Equities' },
-            { value: 'forex', name: 'Forex' },
-        ],
-    });
-    const timeHorizon = await select({
-        message: 'Time horizon?',
-        choices: [
-            { value: 'scalping', name: 'Scalping (minutes)' },
-            { value: 'day', name: 'Day trading (hours)' },
-            { value: 'swing', name: 'Swing (days)' },
-            { value: 'position', name: 'Position (weeks+)' },
-        ],
-    });
-    const biases = await input({
-        message: 'Any biases to watch for? (optional, press Enter to skip)',
-    });
-    const answers = { style, riskTolerance, assets, timeHorizon, biases };
-    const soulText = buildSoulDocument(answers);
-    return { answers, soulText };
-}
-// ─── SOUL Document Builder ───
-function buildSoulDocument(answers) {
-    const styleLabel = STYLE_LABELS[answers.style] ?? answers.style;
-    const riskLabel = RISK_LABELS[answers.riskTolerance] ?? answers.riskTolerance;
-    const assetLabels = answers.assets.map(a => ASSET_LABELS[a] ?? a).join(', ') || 'Not specified';
-    const horizonLabel = HORIZON_LABELS[answers.timeHorizon] ?? answers.timeHorizon;
-    const lines = [];
-    lines.push(`Trading Style: ${styleLabel}`);
-    lines.push(`Risk Tolerance: ${riskLabel}`);
-    lines.push(`Asset Classes: ${assetLabels}`);
-    lines.push(`Time Horizon: ${horizonLabel}`);
-    if (answers.biases.trim()) {
-        lines.push(`Known Biases: ${answers.biases.trim()}`);
-    }
-    lines.push('');
-    lines.push(`This trader favors ${styleLabel.toLowerCase()} approaches with ${riskLabel.toLowerCase()} risk tolerance,`);
-    lines.push(`primarily trading ${assetLabels.toLowerCase()}. They operate on a ${horizonLabel.toLowerCase()} timeframe.`);
-    if (answers.biases.trim()) {
-        lines.push(`Watch for: ${answers.biases.trim()}`);
-    }
-    return lines.join('\n');
-}
-// ─── Upload ───
-/**
- * Upload a SOUL document to the trader's profile.
- */
-export async function uploadSoul(traderName, soulText) {
-    await apiRequest(`/api/v1/traders/${encodeURIComponent(traderName)}/soul`, {
-        method: 'PUT',
-        body: { document: soulText },
-    });
-}
-// ─── Display ───
-/**
- * Print the generated SOUL document with chalk styling.
- */
-export function displaySoul(soulText) {
-    console.log('');
-    console.log(chalk.bold.cyan('  Generated SOUL Document'));
-    console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
-    console.log('');
-    for (const line of soulText.split('\n')) {
-        console.log(`  ${chalk.white(line)}`);
-    }
-    console.log('');
-}
-// ─── Combined Flow ───
-/**
- * Run wizard + upload + display. Used by both onboarding and standalone command.
- * Returns true if SOUL was uploaded successfully.
- */
-export async function runSoulWizardAndUpload(traderName) {
-    const { soulText } = await runSoulWizard();
-    displaySoul(soulText);
-    try {
-        await uploadSoul(traderName, soulText);
-        console.log(chalk.green(`  \u2713 SOUL uploaded for trader "${traderName}"`));
-        return true;
-    }
-    catch (error) {
-        if (error instanceof ApiError) {
-            console.log(chalk.yellow(`  Could not upload SOUL: ${error.message}`));
-        }
-        else {
-            const msg = error instanceof Error ? error.message : String(error);
-            console.log(chalk.yellow(`  Could not upload SOUL: ${msg}`));
-        }
-        console.log(chalk.dim('  You can upload it later: trading-boy trader soul <name> --file soul.md'));
-        return false;
-    }
-}
-//# sourceMappingURL=soul-wizard.js.map

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

@@ -1,44 +0,0 @@
-import { Command } from 'commander';
-interface AgentStrategy {
-    id: string;
-    agentId: string;
-    traderId: string;
-    tenantId: string;
-    version: number;
-    name: string;
-    tokens: string[];
-    setupTypes: string[];
-    regimeBehavior: Record<string, unknown>;
-    riskLimits: Record<string, unknown>;
-    signalWeights: Record<string, number>;
-    narrativePreferences: string[];
-    active: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-interface StrategyListResponse {
-    strategies: AgentStrategy[];
-    total: number;
-    limit: number;
-    offset: number;
-}
-interface StrategyHistoryEntry {
-    id: string;
-    strategyId: string;
-    version: number;
-    name: string;
-    tokens: string[];
-    setupTypes: string[];
-    changedAt: string;
-    changedBy?: string;
-}
-interface StrategyHistoryResponse {
-    strategyId: string;
-    history: StrategyHistoryEntry[];
-}
-export declare function formatStrategyDetail(s: AgentStrategy): string;
-export declare function formatStrategyList(response: StrategyListResponse): string;
-export declare function formatHistoryList(response: StrategyHistoryResponse): string;
-export declare function registerStrategyCommand(program: Command): void;
-export {};
-//# sourceMappingURL=strategy-cmd.d.ts.map