@trading-boy/cli 0.1.0

package/dist/commands/decisions.js

@@ -0,0 +1,327 @@
+import { Option } from 'commander';
+import chalk from 'chalk';
+import { getConfig, createLogger } from '@trading-boy/core';
+import { Neo4jClient } from '@trading-boy/graph-db';
+import { getTradingHistory, getPerformanceSummary, } from '@trading-boy/context-engine';
+import { formatConnectionError } from '../utils.js';
+// ─── Logger ───
+const logger = createLogger('cli-decisions');
+// ─── Default Trader ───
+const DEFAULT_TRADER_ID = 'default';
+// ─── Neo4j Client Factory ───
+function createNeo4jClient() {
+    const config = getConfig();
+    return new Neo4jClient({
+        uri: config.NEO4J_URI,
+        username: config.NEO4J_USER,
+        password: config.NEO4J_PASSWORD,
+    });
+}
+// ─── Formatters ───
+/**
+ * Format a PnL value with color coding.
+ */
+function formatPnl(pnl) {
+    if (pnl === null) {
+        return chalk.dim('-');
+    }
+    const sign = pnl >= 0 ? '+' : '';
+    const str = `${sign}$${pnl.toFixed(2)}`;
+    return pnl > 0 ? chalk.green(str) : pnl < 0 ? chalk.red(str) : chalk.dim(str);
+}
+/**
+ * Format a percentage with color coding.
+ */
+function formatPercent(pct) {
+    if (pct === null) {
+        return chalk.dim('-');
+    }
+    const sign = pct >= 0 ? '+' : '';
+    const str = `${sign}${pct.toFixed(2)}%`;
+    return pct > 0 ? chalk.green(str) : pct < 0 ? chalk.red(str) : chalk.dim(str);
+}
+/**
+ * Format a win rate as a colored percentage.
+ */
+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);
+}
+/**
+ * Format milliseconds into a human-readable duration.
+ */
+function formatDuration(ms) {
+    if (ms === 0) {
+        return chalk.dim('-');
+    }
+    const hours = Math.floor(ms / (1000 * 60 * 60));
+    const days = Math.floor(hours / 24);
+    const remainingHours = hours % 24;
+    if (days > 0) {
+        return `${days}d ${remainingHours}h`;
+    }
+    if (hours > 0) {
+        return `${hours}h`;
+    }
+    const minutes = Math.floor(ms / (1000 * 60));
+    return `${minutes}m`;
+}
+/**
+ * Format a decision record row for the decisions table.
+ */
+function formatDecisionRow(d) {
+    const date = d.eventTime ? formatShortDate(d.eventTime) : '-';
+    const token = d.tokenSymbol ?? '-';
+    const setup = d.setupType ?? '-';
+    const dir = d.direction ?? '-';
+    const price = d.entryPrice !== null
+        ? `$${d.entryPrice.toFixed(2)}`
+        : d.exitPrice !== null
+            ? `$${d.exitPrice.toFixed(2)}`
+            : '-';
+    const pnl = formatPnl(d.pnlAbsolute);
+    const pnlPct = formatPercent(d.pnlPercent);
+    return ('  ' +
+        padRight(date, 14) +
+        padRight(token, 8) +
+        padRight(d.decisionType, 14) +
+        padRight(dir, 8) +
+        padRight(setup, 18) +
+        padRight(price, 12) +
+        padRight(pnl, 14) +
+        pnlPct);
+}
+/**
+ * Format the decisions list output.
+ */
+export function formatDecisionsOutput(decisions) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold.cyan('  Trade Decisions'));
+    lines.push(chalk.gray('  ' + '\u2500'.repeat(100)));
+    lines.push('');
+    if (decisions.length === 0) {
+        lines.push(`  ${chalk.dim('No trade decisions found.')}`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    // Header
+    lines.push('  ' +
+        padRight('Date', 14) +
+        padRight('Token', 8) +
+        padRight('Type', 14) +
+        padRight('Dir', 8) +
+        padRight('Setup', 18) +
+        padRight('Price', 12) +
+        padRight('PnL', 14) +
+        'PnL %');
+    lines.push('  ' + '\u2500'.repeat(100));
+    for (const d of decisions) {
+        lines.push(formatDecisionRow(d));
+    }
+    lines.push('');
+    lines.push(`  ${chalk.gray(`Total: ${decisions.length} decision(s)`)}`);
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format the stats output.
+ */
+export function formatStatsOutput(stats, label = 'Overall') {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold.cyan(`  Trading Statistics: ${label}`));
+    lines.push(chalk.gray('  ' + '\u2500'.repeat(50)));
+    lines.push('');
+    if (stats.totalTrades === 0) {
+        lines.push(`  ${chalk.dim('No completed trades with outcome data.')}`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    lines.push(`  ${chalk.gray('Total Trades:')}    ${chalk.white(String(stats.totalTrades))}`);
+    lines.push(`  ${chalk.gray('Win Rate:')}        ${formatWinRate(stats.winRate)}`);
+    lines.push(`  ${chalk.gray('Wins / Losses:')}   ${chalk.green(String(stats.wins))} / ${chalk.red(String(stats.losses))}${stats.breakeven > 0 ? ` / ${chalk.dim(String(stats.breakeven) + ' BE')}` : ''}`);
+    lines.push('');
+    lines.push(`  ${chalk.gray('Total PnL:')}       ${formatPnl(stats.totalPnl)}`);
+    lines.push(`  ${chalk.gray('Avg PnL:')}         ${formatPnl(stats.avgPnl)}`);
+    lines.push(`  ${chalk.gray('Avg PnL %:')}       ${formatPercent(stats.avgPnlPercent)}`);
+    lines.push(`  ${chalk.gray('Avg Hold Time:')}   ${formatDuration(stats.avgHoldDurationMs)}`);
+    if (stats.bestTrade) {
+        const best = stats.bestTrade;
+        lines.push('');
+        lines.push(`  ${chalk.gray('Best Trade:')}      ${chalk.green(`+$${best.pnlAbsolute.toFixed(2)}`)} ${chalk.dim(`(${best.tokenSymbol} ${best.setupType ?? ''})`).trim()}`);
+    }
+    if (stats.worstTrade) {
+        const worst = stats.worstTrade;
+        lines.push(`  ${chalk.gray('Worst Trade:')}     ${chalk.red(`$${worst.pnlAbsolute.toFixed(2)}`)} ${chalk.dim(`(${worst.tokenSymbol} ${worst.setupType ?? ''})`).trim()}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format stats grouped by setup type as a summary table.
+ */
+export function formatSetupTypeStats(statsBySetup) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold('  Performance by Setup Type:'));
+    lines.push('');
+    if (statsBySetup.size === 0) {
+        lines.push(`  ${chalk.dim('No setup type data available.')}`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    lines.push('  ' +
+        padRight('Setup', 20) +
+        padRight('Trades', 8) +
+        padRight('Win Rate', 10) +
+        padRight('Avg PnL', 12) +
+        padRight('Total PnL', 14));
+    lines.push('  ' + '\u2500'.repeat(64));
+    // Sort by total PnL descending
+    const sorted = [...statsBySetup.entries()].sort((a, b) => b[1].totalPnl - a[1].totalPnl);
+    for (const [setup, s] of sorted) {
+        lines.push('  ' +
+            padRight(setup, 20) +
+            padRight(String(s.totalTrades), 8) +
+            padRight(formatWinRate(s.winRate), 10) +
+            padRight(formatPnl(s.avgPnl), 12) +
+            formatPnl(s.totalPnl));
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Command Registration ───
+export function registerDecisionsCommand(program) {
+    // ─── decisions command ───
+    program
+        .command('decisions')
+        .description('Show trade decision history with outcomes')
+        .option('--token <symbol>', 'Filter by token symbol')
+        .option('--setup <type>', 'Filter by setup type (BREAKOUT, MOMENTUM, etc.)')
+        .option('--limit <n>', 'Maximum number of results', parseIntOption, 20)
+        .option('--trader <traderId>', 'Trader ID', DEFAULT_TRADER_ID)
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (options) => {
+        const client = createNeo4jClient();
+        try {
+            await client.connect();
+            const filters = {
+                tokenSymbol: options.token?.toUpperCase(),
+                setupType: options.setup,
+                limit: options.limit,
+            };
+            const decisions = await getTradingHistory(client, options.trader, filters);
+            if (options.format === 'json') {
+                console.log(JSON.stringify(decisions, null, 2));
+            }
+            else {
+                console.log(formatDecisionsOutput(decisions));
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error: message }, 'Failed to fetch decisions');
+            console.error(chalk.red(`Error: ${message}`));
+            const guidance = formatConnectionError(message);
+            if (guidance)
+                console.error(guidance);
+            process.exitCode = 1;
+        }
+        finally {
+            await client.disconnect();
+        }
+    });
+    // ─── stats command ───
+    program
+        .command('stats')
+        .description('Show aggregate trading statistics (win rate, avg PnL, best/worst setups)')
+        .option('--period <period>', 'Time period (e.g., 7d, 30d, 90d)', '30d')
+        .option('--trader <traderId>', 'Trader ID', DEFAULT_TRADER_ID)
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (options) => {
+        const client = createNeo4jClient();
+        try {
+            await client.connect();
+            // Parse period into start time
+            const periodMs = parsePeriod(options.period);
+            const startTime = periodMs > 0
+                ? new Date(Date.now() - periodMs)
+                : undefined;
+            const summary = await getPerformanceSummary(client, options.trader, {
+                startTime,
+            });
+            if (options.format === 'json') {
+                // Convert Map to plain object for JSON serialization
+                const bySetupType = {};
+                for (const [key, value] of summary.bySetupType) {
+                    bySetupType[key] = value;
+                }
+                console.log(JSON.stringify({ overall: summary.overall, bySetupType }, null, 2));
+            }
+            else {
+                // Overall stats
+                console.log(formatStatsOutput(summary.overall, `Last ${options.period}`));
+                // Setup type breakdown
+                if (summary.bySetupType.size > 0) {
+                    console.log(formatSetupTypeStats(summary.bySetupType));
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error: message }, 'Failed to fetch stats');
+            console.error(chalk.red(`Error: ${message}`));
+            const guidance = formatConnectionError(message);
+            if (guidance)
+                console.error(guidance);
+            process.exitCode = 1;
+        }
+        finally {
+            await client.disconnect();
+        }
+    });
+}
+// ─── Helpers ───
+function padRight(str, len) {
+    return str.length >= len ? str.slice(0, len) : str + ' '.repeat(len - str.length);
+}
+function parseIntOption(value) {
+    return parseInt(value, 10);
+}
+function formatShortDate(isoString) {
+    try {
+        return new Date(isoString).toISOString().slice(0, 10);
+    }
+    catch {
+        return isoString;
+    }
+}
+/**
+ * Parse a period string like "7d", "30d", "90d" into milliseconds.
+ */
+export function parsePeriod(period) {
+    const match = period.match(/^(\d+)([dhm])$/);
+    if (!match) {
+        return 30 * 24 * 60 * 60 * 1000; // Default 30 days
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+        case 'd':
+            return value * 24 * 60 * 60 * 1000;
+        case 'h':
+            return value * 60 * 60 * 1000;
+        case 'm':
+            return value * 60 * 1000;
+        default:
+            return 30 * 24 * 60 * 60 * 1000;
+    }
+}
+//# sourceMappingURL=decisions.js.map

package/dist/commands/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../src/commands/decisions.ts"],"names":[],"mappings":"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"}

package/dist/commands/events.d.ts

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

package/dist/commands/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkCpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqM5D"}

package/dist/commands/events.js

@@ -0,0 +1,201 @@
+import { getConfig, createLogger, EventType, Severity, } from '@trading-boy/core';
+import { Neo4jClient, createEvent, createAffectsEdge, getEventsByType, getEventsByDateRange, } from '@trading-boy/graph-db';
+import { formatConnectionError } from '../utils.js';
+// ─── Logger ───
+const logger = createLogger('cli-events');
+// ─── Neo4j Client Factory ───
+function createNeo4jClient() {
+    const config = getConfig();
+    return new Neo4jClient({
+        uri: config.NEO4J_URI,
+        username: config.NEO4J_USER,
+        password: config.NEO4J_PASSWORD,
+    });
+}
+// ─── Command Registration ───
+export function registerEventsCommand(program) {
+    const events = program
+        .command('events')
+        .description('Event management commands');
+    // ─── events add ───
+    events
+        .command('add')
+        .description('Add a manual event')
+        .requiredOption('--type <type>', `Event type (${Object.values(EventType).join(', ')})`)
+        .requiredOption('--token <symbols...>', 'Token symbol(s) affected')
+        .requiredOption('--title <title>', 'Event title')
+        .option('--date <date>', 'Scheduled date (ISO 8601 format)')
+        .option('--description <desc>', 'Event description', '')
+        .option('--severity <severity>', `Severity (${Object.values(Severity).join(', ')})`, 'MEDIUM')
+        .option('--pct <pct>', 'Unlock percentage (for TOKEN_UNLOCK events)', parseFloat)
+        .option('--recipient <recipient>', 'Recipient type (for TOKEN_UNLOCK events)')
+        .option('--protocol <protocols...>', 'Protocol name(s) affected')
+        .option('--source-url <url>', 'Source URL')
+        .action(async (options) => {
+        // Validate event type
+        if (!Object.values(EventType).includes(options.type)) {
+            console.error(`Error: Invalid event type "${options.type}". Valid types: ${Object.values(EventType).join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        // Validate severity
+        if (!Object.values(Severity).includes(options.severity)) {
+            console.error(`Error: Invalid severity "${options.severity}". Valid values: ${Object.values(Severity).join(', ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        const client = createNeo4jClient();
+        try {
+            await client.connect();
+            const tokens = options.token.map((t) => t.toUpperCase());
+            // Build metadata from optional fields
+            const metadata = {};
+            if (options.pct !== undefined) {
+                metadata.unlockPct = options.pct;
+            }
+            if (options.recipient) {
+                metadata.recipient = options.recipient;
+            }
+            const input = {
+                type: options.type,
+                title: options.title,
+                description: options.description,
+                scheduledDate: options.date ?? null,
+                occurredDate: null,
+                severity: options.severity,
+                tokensAffected: tokens,
+                sourceUrl: options.sourceUrl ?? null,
+                metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            };
+            const { id } = await createEvent(client, input);
+            // Create AFFECTS edges to tokens
+            for (const tokenSymbol of tokens) {
+                try {
+                    await createAffectsEdge(client, {
+                        eventId: id,
+                        targetLabel: 'Token',
+                        targetKey: tokenSymbol,
+                    });
+                }
+                catch {
+                    logger.warn({ tokenSymbol }, 'Token not found in graph, skipping AFFECTS edge');
+                }
+            }
+            // Create AFFECTS edges to protocols
+            if (options.protocol) {
+                for (const protocolName of options.protocol) {
+                    try {
+                        await createAffectsEdge(client, {
+                            eventId: id,
+                            targetLabel: 'Protocol',
+                            targetKey: protocolName,
+                        });
+                    }
+                    catch {
+                        logger.warn({ protocolName }, 'Protocol not found in graph, skipping AFFECTS edge');
+                    }
+                }
+            }
+            logger.info({ id }, 'Event created');
+            console.log(`Event created: id=${id}`);
+            console.log(`  Type: ${options.type}`);
+            console.log(`  Title: ${options.title}`);
+            console.log(`  Tokens: ${tokens.join(', ')}`);
+            if (options.date) {
+                console.log(`  Scheduled: ${options.date}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error: message }, 'Failed to add event');
+            console.error(`Error: ${message}`);
+            const guidance = formatConnectionError(message);
+            if (guidance)
+                console.error(guidance);
+            process.exitCode = 1;
+        }
+        finally {
+            await client.disconnect();
+        }
+    });
+    // ─── events list ───
+    events
+        .command('list')
+        .description('List events')
+        .option('--type <type>', 'Filter by event type')
+        .option('--from <date>', 'Start date (ISO 8601)')
+        .option('--to <date>', 'End date (ISO 8601)')
+        .option('--limit <n>', 'Maximum number of results', parseInt, 20)
+        .action(async (options) => {
+        const client = createNeo4jClient();
+        try {
+            await client.connect();
+            let records;
+            if (options.from && options.to) {
+                // Date range query
+                records = await getEventsByDateRange(client, options.from, options.to, { type: options.type, limit: options.limit });
+            }
+            else if (options.type) {
+                // Type query
+                records = await getEventsByType(client, options.type, { limit: options.limit });
+            }
+            else {
+                // Default: show all event types
+                // Use a far-range date query to get all events
+                records = await getEventsByDateRange(client, '2020-01-01T00:00:00Z', '2030-12-31T23:59:59Z', { limit: options.limit });
+            }
+            if (records.length === 0) {
+                console.log('No events found.');
+                return;
+            }
+            // Print formatted table
+            console.log('');
+            console.log(padRight('Type', 22) +
+                padRight('Title', 40) +
+                padRight('Severity', 10) +
+                padRight('Scheduled', 22) +
+                padRight('Tokens', 20));
+            console.log('-'.repeat(114));
+            for (const e of records) {
+                const date = e.scheduledDate
+                    ? formatDate(e.scheduledDate)
+                    : (e.occurredDate ? formatDate(e.occurredDate) + ' (occ)' : '-');
+                console.log(padRight(e.type, 22) +
+                    padRight(truncate(e.title, 38), 40) +
+                    padRight(e.severity, 10) +
+                    padRight(date, 22) +
+                    (e.tokensAffected ? e.tokensAffected.join(', ') : '-'));
+            }
+            console.log('');
+            console.log(`Total: ${records.length} event(s)`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error: message }, 'Failed to list events');
+            console.error(`Error: ${message}`);
+            const guidance = formatConnectionError(message);
+            if (guidance)
+                console.error(guidance);
+            process.exitCode = 1;
+        }
+        finally {
+            await client.disconnect();
+        }
+    });
+}
+// ─── Helpers ───
+function padRight(str, len) {
+    return str.length >= len ? str.slice(0, len) : str + ' '.repeat(len - str.length);
+}
+function truncate(str, maxLen) {
+    return str.length > maxLen ? str.slice(0, maxLen - 3) + '...' : str;
+}
+function formatDate(isoString) {
+    try {
+        return new Date(isoString).toISOString().slice(0, 10);
+    }
+    catch {
+        return isoString;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/commands/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"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"}

package/dist/commands/infra.d.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+interface ServiceHealthResult {
+    name: string;
+    healthy: boolean;
+    message: string;
+    details?: string;
+}
+export interface InfraStatusResult {
+    services: ServiceHealthResult[];
+    overallHealthy: boolean;
+}
+/**
+ * Check all infrastructure services and return a status report.
+ */
+export declare function checkInfraStatus(): Promise<InfraStatusResult>;
+/**
+ * Format the full infra status output.
+ */
+export declare function formatInfraStatus(result: InfraStatusResult): string;
+export declare function registerInfraCommand(program: Command): void;
+export {};
+//# sourceMappingURL=infra.d.ts.map

package/dist/commands/infra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infra.d.ts","sourceRoot":"","sources":["../../src/commands/infra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6FpC,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;CACzB;AA2ED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAWnE;AAWD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA6BnE;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwB3D"}