@trading-boy/cli 1.12.0 → 2.0.0

package/dist/commands/trader.js

@@ -1,971 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { Option } from 'commander';
-import chalk from 'chalk';
-import { createLogger } from '@trading-boy/core';
-import { padRight } from '../utils.js';
-import { apiRequest, ApiError } from '../api-client.js';
-import { confirm } from '@inquirer/prompts';
-// ─── Logger ───
-const logger = createLogger('cli-trader');
-// ─── Formatters ───
-/**
- * Format a single trader record for display.
- */
-export function formatTraderOutput(trader, wallets) {
-    const lines = [];
-    lines.push('');
-    lines.push(chalk.bold.cyan('  Trader Profile'));
-    lines.push(chalk.gray('  ' + '\u2500'.repeat(50)));
-    lines.push('');
-    lines.push(`  ${chalk.gray('Name:')}              ${chalk.white(trader.name)}`);
-    lines.push(`  ${chalk.gray('ID:')}                ${chalk.dim(trader.id)}`);
-    lines.push(`  ${chalk.gray('Max Drawdown:')}      ${chalk.yellow(String(trader.riskToleranceMax ?? trader.maxDrawdownPct ?? 'n/a') + '%')}`);
-    const walletAddrs = trader.walletAddresses ?? [];
-    lines.push(`  ${chalk.gray('Wallets:')}           ${chalk.white(String(walletAddrs.length))}`);
-    if (walletAddrs.length > 0) {
-        for (const addr of walletAddrs) {
-            lines.push(`    ${chalk.dim('\u2022')} ${chalk.white(addr)}`);
-        }
-    }
-    if (wallets && wallets.length > 0) {
-        lines.push('');
-        lines.push(`  ${chalk.gray('Wallet Details:')}`);
-        for (const w of wallets) {
-            lines.push(`    ${chalk.dim('\u2022')} ${chalk.white(w.address)} ${chalk.dim(`(${w.chain})`)} ${chalk.dim(`since ${w.since}`)}`);
-        }
-    }
-    lines.push('');
-    lines.push(`  ${chalk.gray('Created:')}           ${chalk.dim(trader.createdAt)}`);
-    lines.push(`  ${chalk.gray('Updated:')}           ${chalk.dim(trader.updatedAt)}`);
-    lines.push('');
-    return lines.join('\n');
-}
-/**
- * Format a list of traders for display.
- */
-export function formatTraderListOutput(traders) {
-    const lines = [];
-    lines.push('');
-    lines.push(chalk.bold.cyan('  Registered Traders'));
-    lines.push(chalk.gray('  ' + '\u2500'.repeat(70)));
-    lines.push('');
-    if (traders.length === 0) {
-        lines.push(`  ${chalk.dim('No traders registered.')}`);
-        lines.push('');
-        lines.push(`  ${chalk.dim('Run')} ${chalk.white('trading-boy trader register --name "YourName"')} ${chalk.dim('to get started.')}`);
-        lines.push('');
-        return lines.join('\n');
-    }
-    // Header
-    lines.push('  ' +
-        padRight('Name', 20) +
-        padRight('Max DD', 10) +
-        padRight('Wallets', 10) +
-        'ID');
-    lines.push('  ' + '\u2500'.repeat(70));
-    for (const t of traders) {
-        lines.push('  ' +
-            padRight(String(t.name ?? t.id ?? ''), 20) +
-            padRight(String(t.riskToleranceMax ?? 0) + '%', 10) +
-            padRight(String(t.walletAddresses?.length ?? 0), 10) +
-            chalk.dim(t.id));
-    }
-    lines.push('');
-    lines.push(`  ${chalk.gray(`Total: ${traders.length} trader(s)`)}`);
-    lines.push('');
-    return lines.join('\n');
-}
-// ─── Command Registration ───
-export function registerTraderCommand(program) {
-    const trader = program
-        .command('trader')
-        .description('Manage trader profiles');
-    // ─── register ───
-    trader
-        .command('register')
-        .description('Register a new trader profile')
-        .requiredOption('--name <name>', 'Trader display name')
-        .option('--wallet <address>', 'Initial Solana wallet address')
-        .option('--max-drawdown <pct>', 'Max acceptable drawdown percentage', parseFloatOption)
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (options) => {
-        try {
-            const result = await apiRequest('/api/v1/traders', {
-                method: 'POST',
-                body: {
-                    name: options.name,
-                    wallet: options.wallet,
-                    maxDrawdown: options.maxDrawdown,
-                },
-            });
-            const traderId = result.name ?? result.id;
-            if (options.format === 'json') {
-                console.log(JSON.stringify({
-                    ...result,
-                    nextSteps: [
-                        `trading-boy trader soul ${traderId} --file soul.md`,
-                        `trading-boy trader purpose ${traderId} --file purpose.md`,
-                        `trading-boy trader identity ${traderId}`,
-                    ],
-                }, null, 2));
-            }
-            else {
-                console.log(formatTraderOutput(result));
-                console.log(chalk.green('  Trader registered successfully.'));
-                if (result.alias) {
-                    console.log(`  ${chalk.gray('Leaderboard alias:')} ${chalk.white(result.alias)} ${chalk.dim('(change with: trading-boy trader set-alias <name> <alias>)')}`);
-                }
-                console.log('');
-                console.log(chalk.bold('  Next: Set up your trading identity'));
-                console.log(chalk.dim('  SOUL and PURPOSE documents personalize your context — bias warnings,'));
-                console.log(chalk.dim('  scope checks, and tailored synthesis based on who you are as a trader.'));
-                console.log('');
-                console.log(`  ${chalk.gray('1.')} trading-boy trader soul ${chalk.white(traderId)} --file soul.md`);
-                console.log(`  ${chalk.gray('2.')} trading-boy trader purpose ${chalk.white(traderId)} --file purpose.md`);
-                console.log(`  ${chalk.gray('3.')} trading-boy trader identity ${chalk.white(traderId)}`);
-                console.log('');
-            }
-        }
-        catch (error) {
-            const message = error instanceof ApiError ? error.message : (error instanceof Error ? error.message : String(error));
-            logger.error({ error: message }, 'Failed to register trader');
-            console.error(chalk.red(`Error: ${message}`));
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── show ───
-    trader
-        .command('show')
-        .description('Show a trader profile by name or ID')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, options) => {
-        try {
-            const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}`);
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                const { wallets, ...traderData } = result;
-                console.log(formatTraderOutput(traderData, wallets));
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 404) {
-                console.error(chalk.yellow(`Trader not found: "${nameOrId}"`));
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                logger.error({ error: message }, 'Failed to show trader');
-                console.error(chalk.red(`Error: ${message}`));
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── list ───
-    trader
-        .command('list')
-        .description('List all registered traders')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (options) => {
-        try {
-            const result = await apiRequest('/api/v1/traders');
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                console.log(formatTraderListOutput(result.traders));
-            }
-        }
-        catch (error) {
-            const message = error instanceof ApiError ? error.message : (error instanceof Error ? error.message : String(error));
-            logger.error({ error: message }, 'Failed to list traders');
-            console.error(chalk.red(`Error: ${message}`));
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── update ───
-    trader
-        .command('update')
-        .description('Update a trader profile')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .option('--name <new-name>', 'New display name')
-        .option('--max-drawdown <pct>', 'New max acceptable drawdown percentage', parseFloatOption)
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, options) => {
-        if (options.name === undefined && options.maxDrawdown === undefined) {
-            console.error(chalk.yellow('No updates provided. Use --name or --max-drawdown.'));
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}`, {
-                method: 'PATCH',
-                body: {
-                    name: options.name,
-                    maxDrawdown: options.maxDrawdown,
-                },
-            });
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                console.log(formatTraderOutput(result));
-                console.log(chalk.green('  Trader updated successfully.'));
-                console.log('');
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 404) {
-                console.error(chalk.yellow(`Trader not found: "${nameOrId}"`));
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                logger.error({ error: message }, 'Failed to update trader');
-                console.error(chalk.red(`Error: ${message}`));
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── set-alias ───
-    const ALIAS_PATTERN = /^[a-zA-Z0-9_-]{3,30}$/;
-    trader
-        .command('set-alias')
-        .description('Set a public leaderboard alias')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .argument('<alias>', 'Leaderboard alias (3-30 chars, alphanumeric/underscores/hyphens)')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, alias, options) => {
-        const jsonMode = options.format === 'json';
-        if (!ALIAS_PATTERN.test(alias)) {
-            const msg = 'Invalid alias. Must be 3-30 characters, alphanumeric with underscores and hyphens.';
-            if (jsonMode) {
-                console.error(JSON.stringify({ error: msg }));
-            }
-            else {
-                console.error(chalk.red(`  ${msg}`));
-            }
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/alias`, { method: 'PUT', body: { alias } });
-            if (jsonMode) {
-                console.log(JSON.stringify({ alias, updated: true }));
-            }
-            else {
-                console.log('');
-                console.log(chalk.green(`  Alias updated to: ${chalk.white(alias)}`));
-                console.log('');
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 409) {
-                const msg = 'Alias already taken. Try a different name.';
-                if (jsonMode) {
-                    console.error(JSON.stringify({ error: msg }));
-                }
-                else {
-                    console.error(chalk.yellow(`  ${msg}`));
-                }
-                process.exitCode = 2;
-            }
-            else if (error instanceof ApiError && error.status === 404) {
-                const msg = `Trader not found: "${nameOrId}"`;
-                if (jsonMode) {
-                    console.error(JSON.stringify({ error: msg }));
-                }
-                else {
-                    console.error(chalk.yellow(msg));
-                }
-                process.exitCode = 2;
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                logger.error({ error: message }, 'Failed to set alias');
-                if (jsonMode) {
-                    console.error(JSON.stringify({ error: message }));
-                }
-                else {
-                    console.error(chalk.red(`Error: ${message}`));
-                }
-                process.exitCode = error instanceof ApiError ? 2 : 1;
-            }
-        }
-    });
-    // ─── preferences ───
-    trader
-        .command('preferences')
-        .description('Update notification preferences')
-        .option('--summary-time <hour>', 'Hour (0-23 UTC) to receive daily email summary', parseInt)
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (options) => {
-        if (options.summaryTime === undefined) {
-            console.error(chalk.yellow('No updates provided. Use --summary-time <hour>.'));
-            console.error(chalk.dim('  Example: trading-boy trader preferences --summary-time 14'));
-            process.exitCode = 1;
-            return;
-        }
-        if (isNaN(options.summaryTime) || options.summaryTime < 0 || options.summaryTime > 23) {
-            console.error(chalk.red('Error: --summary-time must be 0-23 (UTC hour)'));
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const result = await apiRequest('/api/v1/preferences/email', {
-                method: 'PATCH',
-                body: { summaryHourUtc: options.summaryTime },
-            });
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                console.log('');
-                console.log(chalk.green('  Email preferences updated.'));
-                console.log(`  ${chalk.gray('Email:')}         ${chalk.white(result.email)}`);
-                console.log(`  ${chalk.gray('Summary time:')}  ${chalk.white(String(result.summaryHourUtc).padStart(2, '0') + ':00 UTC')}`);
-                console.log('');
-            }
-        }
-        catch (error) {
-            const message = error instanceof ApiError ? error.message : (error instanceof Error ? error.message : String(error));
-            console.error(chalk.red(`Error: ${message}`));
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── link-wallet ───
-    trader
-        .command('link-wallet')
-        .description('Link a wallet address to a trader')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .argument('<wallet-address>', 'Solana wallet address')
-        .option('--chain <chain>', 'Blockchain name', 'solana')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, walletAddress, options) => {
-        try {
-            await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/wallets`, {
-                method: 'POST',
-                body: {
-                    address: walletAddress,
-                    chain: options.chain,
-                },
-            });
-            if (options.format === 'json') {
-                console.log(JSON.stringify({ linked: true, address: walletAddress, chain: options.chain }, null, 2));
-            }
-            else {
-                console.log('');
-                console.log(chalk.green(`  Wallet linked: ${walletAddress}`));
-                console.log('');
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 404) {
-                console.error(chalk.yellow(`Trader not found: "${nameOrId}"`));
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                logger.error({ error: message }, 'Failed to link wallet');
-                console.error(chalk.red(`Error: ${message}`));
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── soul ───
-    trader
-        .command('soul')
-        .description('Show or upload a SOUL document')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .option('--file <path>', 'Path to SOUL document file to upload')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, options) => {
-        try {
-            if (options.file) {
-                // Upload SOUL document
-                const document = readFileSync(options.file, 'utf-8');
-                const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/soul`, { method: 'PUT', body: { document } });
-                if (options.format === 'json') {
-                    console.log(JSON.stringify(result, null, 2));
-                }
-                else {
-                    console.log('');
-                    console.log(chalk.green('  SOUL document uploaded successfully.'));
-                    const parsed = result.parsed;
-                    if (parsed) {
-                        if (parsed.tradingPersonality)
-                            console.log(`  ${chalk.gray('Personality:')}  ${chalk.white(String(parsed.tradingPersonality))}`);
-                        if (parsed.riskTolerance)
-                            console.log(`  ${chalk.gray('Risk:')}         ${chalk.white(String(parsed.riskTolerance))}`);
-                        const biases = parsed.biases;
-                        if (biases && biases.length > 0) {
-                            console.log(`  ${chalk.gray('Biases:')}       ${chalk.yellow(biases.map(b => b.canonicalName).join(', '))}`);
-                        }
-                    }
-                    console.log('');
-                }
-            }
-            else {
-                // Show current SOUL document
-                const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/soul`);
-                if (options.format === 'json') {
-                    console.log(JSON.stringify(result, null, 2));
-                }
-                else {
-                    console.log('');
-                    console.log(chalk.bold.cyan('  SOUL Document'));
-                    console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
-                    console.log('');
-                    console.log(result.rawDocument.split('\n').map(l => '  ' + l).join('\n'));
-                    console.log('');
-                    console.log(`  ${chalk.gray('Updated:')} ${chalk.dim(result.updatedAt)}`);
-                    console.log('');
-                }
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 404) {
-                if (options.format === 'json') {
-                    console.log(JSON.stringify({ soul: null, message: options.file ? `Trader not found: "${nameOrId}"` : 'No SOUL document found' }));
-                }
-                else {
-                    console.error(chalk.yellow(options.file ? `Trader not found: "${nameOrId}"` : 'No SOUL document found.'));
-                }
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                if (options.format === 'json') {
-                    console.log(JSON.stringify({ error: message }));
-                }
-                else {
-                    console.error(chalk.red(`Error: ${message}`));
-                }
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── soul-wizard ───
-    trader
-        .command('soul-wizard')
-        .description('Interactive wizard to create your trading identity')
-        .argument('<name>', 'Trader name')
-        .action(async (name) => {
-        try {
-            const { runSoulWizardAndUpload } = await import('./soul-wizard.js');
-            console.log('');
-            console.log(chalk.bold.cyan('  SOUL Wizard'));
-            console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
-            console.log(chalk.dim('  Answer a few questions to generate your trading identity.'));
-            console.log('');
-            await runSoulWizardAndUpload(name);
-        }
-        catch (error) {
-            if (error instanceof Error && error.message.includes('User force closed')) {
-                console.log('');
-                return;
-            }
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error({ error: message }, 'Soul wizard failed');
-            console.error(chalk.red(`  Error: ${message}`));
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── purpose ───
-    trader
-        .command('purpose')
-        .description('Show or upload a PURPOSE document')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .option('--file <path>', 'Path to PURPOSE document file to upload')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, options) => {
-        try {
-            if (options.file) {
-                const document = readFileSync(options.file, 'utf-8');
-                const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/purpose`, { method: 'PUT', body: { document } });
-                if (options.format === 'json') {
-                    console.log(JSON.stringify(result, null, 2));
-                }
-                else {
-                    console.log('');
-                    console.log(chalk.green('  PURPOSE document uploaded successfully.'));
-                    const parsed = result.parsed;
-                    if (parsed) {
-                        if (parsed.mission)
-                            console.log(`  ${chalk.gray('Mission:')}     ${chalk.white(String(parsed.mission).slice(0, 80))}`);
-                        const scope = parsed.assetScope;
-                        if (scope && scope.length > 0) {
-                            console.log(`  ${chalk.gray('Scope:')}       ${chalk.white(scope.join(', '))}`);
-                        }
-                        if (parsed.timeHorizon)
-                            console.log(`  ${chalk.gray('Horizon:')}     ${chalk.white(String(parsed.timeHorizon))}`);
-                    }
-                    console.log('');
-                }
-            }
-            else {
-                const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/purpose`);
-                if (options.format === 'json') {
-                    console.log(JSON.stringify(result, null, 2));
-                }
-                else {
-                    console.log('');
-                    console.log(chalk.bold.cyan('  PURPOSE Document'));
-                    console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
-                    console.log('');
-                    console.log(result.rawDocument.split('\n').map(l => '  ' + l).join('\n'));
-                    console.log('');
-                    console.log(`  ${chalk.gray('Updated:')} ${chalk.dim(result.updatedAt)}`);
-                    console.log('');
-                }
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 404) {
-                if (options.format === 'json') {
-                    console.log(JSON.stringify({ purpose: null, message: options.file ? `Trader not found: "${nameOrId}"` : 'No PURPOSE document found' }));
-                }
-                else {
-                    console.error(chalk.yellow(options.file ? `Trader not found: "${nameOrId}"` : 'No PURPOSE document found.'));
-                }
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                if (options.format === 'json') {
-                    console.log(JSON.stringify({ error: message }));
-                }
-                else {
-                    console.error(chalk.red(`Error: ${message}`));
-                }
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── identity ───
-    trader
-        .command('identity')
-        .description('Show combined identity summary with bias-signal matrix')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, options) => {
-        try {
-            const traderResult = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}`);
-            // Fetch both documents (they may not exist)
-            let soulDoc = null;
-            let purposeDoc = null;
-            try {
-                soulDoc = await apiRequest(`/api/v1/traders/${encodeURIComponent(traderResult.id)}/soul`);
-            }
-            catch { /* no soul doc */ }
-            try {
-                purposeDoc = await apiRequest(`/api/v1/traders/${encodeURIComponent(traderResult.id)}/purpose`);
-            }
-            catch { /* no purpose doc */ }
-            const combined = {
-                trader: { id: traderResult.id, name: traderResult.name },
-                soul: soulDoc?.parsed ?? null,
-                purpose: purposeDoc?.parsed ?? null,
-                hasSoul: soulDoc !== null,
-                hasPurpose: purposeDoc !== null,
-            };
-            if (options.format === 'json') {
-                console.log(JSON.stringify(combined, null, 2));
-            }
-            else {
-                console.log('');
-                console.log(chalk.bold.cyan(`  Identity: ${traderResult.name}`));
-                console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
-                console.log('');
-                if (soulDoc?.parsed) {
-                    const p = soulDoc.parsed;
-                    console.log(`  ${chalk.bold('SOUL')}`);
-                    if (p.tradingPersonality)
-                        console.log(`    ${chalk.gray('Personality:')}  ${chalk.white(String(p.tradingPersonality))}`);
-                    if (p.riskTolerance)
-                        console.log(`    ${chalk.gray('Risk:')}         ${chalk.white(String(p.riskTolerance))}`);
-                    if (p.decisionStyle)
-                        console.log(`    ${chalk.gray('Decisions:')}    ${chalk.white(String(p.decisionStyle))}`);
-                    const biases = p.biases;
-                    if (biases && biases.length > 0) {
-                        console.log(`    ${chalk.gray('Biases:')}`);
-                        for (const b of biases) {
-                            const color = b.severity === 'high' ? chalk.red : b.severity === 'medium' ? chalk.yellow : chalk.dim;
-                            console.log(`      ${chalk.dim('\u2022')} ${color(b.canonicalName)} ${chalk.dim(`(${b.severity})`)}`);
-                        }
-                    }
-                }
-                else {
-                    console.log(`  ${chalk.dim('No SOUL document. Upload with: trader soul <id> --file <path>')}`);
-                }
-                console.log('');
-                if (purposeDoc?.parsed) {
-                    const p = purposeDoc.parsed;
-                    console.log(`  ${chalk.bold('PURPOSE')}`);
-                    if (p.mission)
-                        console.log(`    ${chalk.gray('Mission:')}     ${chalk.white(String(p.mission).slice(0, 100))}`);
-                    const scope = p.assetScope;
-                    if (scope && scope.length > 0)
-                        console.log(`    ${chalk.gray('Scope:')}       ${chalk.white(scope.join(', '))}`);
-                    const outOfScope = p.outOfScope;
-                    if (outOfScope && outOfScope.length > 0)
-                        console.log(`    ${chalk.gray('Out of scope:')} ${chalk.dim(outOfScope.join(', '))}`);
-                    if (p.timeHorizon)
-                        console.log(`    ${chalk.gray('Horizon:')}     ${chalk.white(String(p.timeHorizon))}`);
-                    const goals = p.goals;
-                    if (goals && goals.length > 0) {
-                        console.log(`    ${chalk.gray('Goals:')}`);
-                        for (const g of goals)
-                            console.log(`      ${chalk.dim('\u2022')} ${chalk.white(g)}`);
-                    }
-                }
-                else {
-                    console.log(`  ${chalk.dim('No PURPOSE document. Upload with: trader purpose <id> --file <path>')}`);
-                }
-                console.log('');
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 404) {
-                console.error(chalk.yellow(`Trader not found: "${nameOrId}"`));
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                console.error(chalk.red(`Error: ${message}`));
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── history ───
-    trader
-        .command('history')
-        .description('Show document revision history')
-        .argument('<name-or-id>', 'Trader name or ID')
-        .option('--type <type>', 'Filter by document type (SOUL or PURPOSE)')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (nameOrId, options) => {
-        try {
-            let url = `/api/v1/traders/${encodeURIComponent(nameOrId)}/documents/history`;
-            if (options.type)
-                url += `?type=${options.type.toUpperCase()}`;
-            const result = await apiRequest(url);
-            if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
-            }
-            else {
-                console.log('');
-                console.log(chalk.bold.cyan('  Document Revision History'));
-                console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
-                console.log('');
-                if (result.revisions.length === 0) {
-                    console.log(`  ${chalk.dim('No document revisions found.')}`);
-                }
-                else {
-                    console.log('  ' + padRight('Type', 12) + padRight('Version', 10) + 'Created');
-                    console.log('  ' + '\u2500'.repeat(50));
-                    for (const r of result.revisions) {
-                        console.log('  ' +
-                            padRight(r.documentType, 12) +
-                            padRight(`v${r.version}`, 10) +
-                            chalk.dim(r.createdAt));
-                    }
-                }
-                console.log('');
-            }
-        }
-        catch (error) {
-            if (error instanceof ApiError && error.status === 404) {
-                console.error(chalk.yellow(`Trader not found: "${nameOrId}"`));
-            }
-            else {
-                const message = error instanceof Error ? error.message : String(error);
-                console.error(chalk.red(`Error: ${message}`));
-            }
-            process.exitCode = error instanceof ApiError ? 2 : 1;
-        }
-    });
-    // ─── agent (subcommand group) ───
-    const AUTONOMY_LEVELS = ['OBSERVE_ONLY', 'SUGGEST', 'AUTO_WITH_APPROVAL', 'FULLY_AUTONOMOUS'];
-    const agent = trader
-        .command('agent')
-        .description('Manage autonomous trading agent');
-    // ─── agent status ───
-    agent
-        .command('status')
-        .description('Show agent runtime status')
-        .argument('<agent-id>', 'Agent ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (agentId, options) => {
-        const jsonMode = options.format === 'json';
-        try {
-            const result = await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/status`);
-            if (jsonMode) {
-                const safeOutput = {
-                    agentId,
-                    state: result.state,
-                    autonomyLevel: result.autonomyLevel,
-                    paused: result.paused,
-                    killed: result.killed,
-                    override: result.humanOverride,
-                    openPositions: result.openPositions ?? 0,
-                    dailyTradeCount: result.dailyTradeCount ?? 0,
-                    dailyPnlUsd: result.dailyPnlUsd ?? null,
-                    lastTransitionAt: result.lastTransitionAt ?? null,
-                    healthTimestamp: result.healthTimestamp ?? null,
-                };
-                console.log(JSON.stringify(safeOutput, null, 2));
-            }
-            else {
-                console.log('');
-                console.log(chalk.bold.cyan('  Agent Status'));
-                console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
-                console.log('');
-                console.log(`  ${chalk.gray('Agent ID:')}       ${chalk.white(agentId)}`);
-                console.log(`  ${chalk.gray('State:')}          ${formatAgentState(result.state)}`);
-                console.log(`  ${chalk.gray('Autonomy:')}       ${chalk.white(result.autonomyLevel)}`);
-                console.log(`  ${chalk.gray('Paused:')}         ${result.paused ? chalk.yellow('yes') : chalk.green('no')}`);
-                console.log(`  ${chalk.gray('Killed:')}         ${result.killed ? chalk.red('yes') : chalk.green('no')}`);
-                console.log(`  ${chalk.gray('Override:')}       ${result.humanOverride ? chalk.yellow('active') : chalk.dim('none')}`);
-                console.log(`  ${chalk.gray('Open positions:')} ${chalk.white(String(result.openPositions ?? 0))}`);
-                console.log(`  ${chalk.gray('Trades today:')}   ${chalk.white(String(result.dailyTradeCount ?? 0))}`);
-                console.log(`  ${chalk.gray('Daily PnL:')}      ${formatPnl(result.dailyPnlUsd)}`);
-                console.log('');
-            }
-        }
-        catch (error) {
-            handleAgentError(error, jsonMode, agentId, 'get agent status');
-        }
-    });
-    // ─── agent pause ───
-    agent
-        .command('pause')
-        .description('Pause the agent (stops all trading)')
-        .argument('<agent-id>', 'Agent ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (agentId, options) => {
-        const jsonMode = options.format === 'json';
-        try {
-            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/pause`, { method: 'POST' });
-            if (jsonMode) {
-                console.log(JSON.stringify({ agentId, paused: true }));
-            }
-            else {
-                console.log('');
-                console.log(chalk.yellow(`  Agent ${agentId} paused.`));
-                console.log(chalk.dim('  Resume with: trading-boy trader agent resume ' + agentId));
-                console.log('');
-            }
-        }
-        catch (error) {
-            handleAgentError(error, jsonMode, agentId, 'pause agent');
-        }
-    });
-    // ─── agent resume ───
-    agent
-        .command('resume')
-        .description('Resume a paused agent')
-        .argument('<agent-id>', 'Agent ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (agentId, options) => {
-        const jsonMode = options.format === 'json';
-        try {
-            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/resume`, { method: 'POST' });
-            if (jsonMode) {
-                console.log(JSON.stringify({ agentId, resumed: true }));
-            }
-            else {
-                console.log('');
-                console.log(chalk.green(`  Agent ${agentId} resumed.`));
-                console.log('');
-            }
-        }
-        catch (error) {
-            handleAgentError(error, jsonMode, agentId, 'resume agent');
-        }
-    });
-    // ─── agent kill ───
-    agent
-        .command('kill')
-        .description('Kill the agent permanently (until revived)')
-        .argument('<agent-id>', 'Agent ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .addOption(new Option('--force', 'Skip confirmation prompt'))
-        .action(async (agentId, options) => {
-        const jsonMode = options.format === 'json';
-        if (jsonMode && !options.force) {
-            console.error(JSON.stringify({ error: '--force is required with --format json' }));
-            process.exitCode = 1;
-            return;
-        }
-        if (!options.force) {
-            const proceed = await confirm({
-                message: `Are you sure you want to kill agent ${agentId}? This is permanent until revived.`,
-            });
-            if (!proceed) {
-                console.log(chalk.dim('  Kill cancelled.'));
-                return;
-            }
-        }
-        try {
-            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/kill`, { method: 'POST' });
-            if (jsonMode) {
-                console.log(JSON.stringify({ agentId, killed: true }));
-            }
-            else {
-                console.log('');
-                console.log(chalk.red(`  Agent ${agentId} killed.`));
-                console.log(chalk.dim('  The agent will not trade until manually revived.'));
-                console.log('');
-            }
-        }
-        catch (error) {
-            handleAgentError(error, jsonMode, agentId, 'kill agent');
-        }
-    });
-    // ─── agent autonomy ───
-    agent
-        .command('autonomy')
-        .description('Set agent autonomy level')
-        .argument('<agent-id>', 'Agent ID')
-        .argument('<level>', `Autonomy level: ${AUTONOMY_LEVELS.join(' | ')}`)
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (agentId, level, options) => {
-        const jsonMode = options.format === 'json';
-        const upperLevel = level.toUpperCase();
-        if (!AUTONOMY_LEVELS.includes(upperLevel)) {
-            const msg = `Invalid autonomy level. Must be one of: ${AUTONOMY_LEVELS.join(', ')}`;
-            if (jsonMode) {
-                console.error(JSON.stringify({ error: msg }));
-            }
-            else {
-                console.error(chalk.red(`  ${msg}`));
-            }
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/autonomy`, {
-                method: 'PUT',
-                body: { level: upperLevel },
-            });
-            if (jsonMode) {
-                console.log(JSON.stringify({ agentId, autonomyLevel: upperLevel }));
-            }
-            else {
-                console.log('');
-                console.log(chalk.green(`  Autonomy level set to: ${chalk.white(upperLevel)}`));
-                console.log('');
-            }
-        }
-        catch (error) {
-            handleAgentError(error, jsonMode, agentId, 'set autonomy');
-        }
-    });
-    // ─── agent override ───
-    agent
-        .command('override')
-        .description('Set human override (agent defers all decisions to human)')
-        .argument('<agent-id>', 'Agent ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .addOption(new Option('--force', 'Skip confirmation prompt'))
-        .action(async (agentId, options) => {
-        const jsonMode = options.format === 'json';
-        if (jsonMode && !options.force) {
-            console.error(JSON.stringify({ error: '--force is required with --format json' }));
-            process.exitCode = 1;
-            return;
-        }
-        if (!options.force) {
-            const proceed = await confirm({
-                message: `Are you sure you want to set human override for agent ${agentId}?`,
-            });
-            if (!proceed) {
-                console.log(chalk.dim('  Override cancelled.'));
-                return;
-            }
-        }
-        try {
-            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/override`, { method: 'POST' });
-            if (jsonMode) {
-                console.log(JSON.stringify({ agentId, humanOverride: true }));
-            }
-            else {
-                console.log('');
-                console.log(chalk.yellow(`  Human override set for agent ${agentId}.`));
-                console.log(chalk.dim('  The agent will defer all decisions to you.'));
-                console.log(chalk.dim('  Clear with: trading-boy trader agent clear-override ' + agentId));
-                console.log('');
-            }
-        }
-        catch (error) {
-            handleAgentError(error, jsonMode, agentId, 'set override');
-        }
-    });
-    // ─── agent clear-override ───
-    agent
-        .command('clear-override')
-        .description('Clear human override (return control to agent)')
-        .argument('<agent-id>', 'Agent ID')
-        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
-        .action(async (agentId, options) => {
-        const jsonMode = options.format === 'json';
-        try {
-            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/clear-override`, { method: 'POST' });
-            if (jsonMode) {
-                console.log(JSON.stringify({ agentId, humanOverride: false }));
-            }
-            else {
-                console.log('');
-                console.log(chalk.green(`  Human override cleared for agent ${agentId}.`));
-                console.log(chalk.dim('  The agent will resume autonomous decision-making.'));
-                console.log('');
-            }
-        }
-        catch (error) {
-            handleAgentError(error, jsonMode, agentId, 'clear override');
-        }
-    });
-}
-// ─── Agent Helpers ───
-function formatAgentState(state) {
-    const colors = {
-        'IDLE': chalk.dim,
-        'SCANNING': chalk.cyan,
-        'ANALYZING': chalk.blue,
-        'EXECUTING': chalk.yellow,
-        'PAUSED': chalk.yellow,
-        'KILLED': chalk.red,
-    };
-    return (colors[state] ?? chalk.white)(state);
-}
-function formatPnl(pnl) {
-    if (pnl === undefined || pnl === null)
-        return chalk.dim('n/a');
-    const sign = pnl >= 0 ? '+' : '';
-    const color = pnl >= 0 ? chalk.green : chalk.red;
-    return color(`${sign}$${pnl.toFixed(2)}`);
-}
-function handleAgentError(error, jsonMode, agentId, action) {
-    if (error instanceof ApiError && error.status === 404) {
-        const msg = `Agent not found: "${agentId}"`;
-        if (jsonMode) {
-            console.error(JSON.stringify({ error: msg }));
-        }
-        else {
-            console.error(chalk.yellow(msg));
-        }
-    }
-    else {
-        const message = error instanceof Error ? error.message : String(error);
-        logger.error({ error: message }, `Failed to ${action}`);
-        if (jsonMode) {
-            console.error(JSON.stringify({ error: message }));
-        }
-        else {
-            console.error(chalk.red(`Error: ${message}`));
-        }
-    }
-    process.exitCode = error instanceof ApiError ? 2 : 1;
-}
-// ─── Helpers ───
-function parseFloatOption(value) {
-    return parseFloat(value);
-}
-//# sourceMappingURL=trader.js.map