@trading-boy/cli 1.2.19 → 1.3.0

package/dist/commands/cron-cmd.js

@@ -0,0 +1,341 @@
+// ─── Cron CLI Commands ───
+//
+// tb cron create  — Create a new cron job
+// tb cron list    — List cron jobs
+// tb cron show    — Show a single job
+// tb cron pause   — Pause a job
+// tb cron resume  — Resume a paused job
+// tb cron delete  — Delete a job
+// tb cron run     — Trigger immediate execution
+// tb cron history — View execution history
+import { Option } from 'commander';
+import chalk from 'chalk';
+import { createLogger } from '@trading-boy/core';
+import { isRemoteMode, apiRequest, ApiError } from '../api-client.js';
+import { padRight } from '../utils.js';
+const logger = createLogger('cli-cron');
+// ─── Error Handler ───
+function handleApiError(error, context) {
+    if (error instanceof ApiError) {
+        switch (error.status) {
+            case 401:
+                console.error(chalk.red('Error: API key invalid or expired. Run `trading-boy login` to re-authenticate.'));
+                break;
+            case 403:
+                console.error(chalk.red('Error: Subscription inactive. Run `trading-boy billing manage` to update your billing.'));
+                break;
+            case 404:
+                console.error(chalk.red(`Error: Not found — ${error.message}`));
+                break;
+            case 429:
+                console.error(chalk.red(`Error: Limit reached — ${error.message}`));
+                break;
+            default:
+                console.error(chalk.red(`Error: ${error.message}`));
+        }
+    }
+    else {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error({ error: message }, context);
+        console.error(chalk.red(`Error: ${message}`));
+    }
+    process.exitCode = error instanceof ApiError ? 2 : 1;
+}
+async function ensureRemote() {
+    if (!(await isRemoteMode())) {
+        console.error(chalk.yellow('Cron commands require a remote API connection.'));
+        console.error(chalk.dim('  Run: trading-boy login'));
+        process.exitCode = 1;
+        return false;
+    }
+    return true;
+}
+// ─── Formatters ───
+function formatShortDate(isoString) {
+    if (!isoString)
+        return chalk.dim('—');
+    try {
+        return new Date(isoString).toISOString().slice(0, 19).replace('T', ' ');
+    }
+    catch {
+        return isoString;
+    }
+}
+function formatStatus(status) {
+    switch (status) {
+        case 'active': return chalk.green('active');
+        case 'paused': return chalk.yellow('paused');
+        case 'deleted': return chalk.red('deleted');
+        case 'completed': return chalk.green('completed');
+        case 'failed': return chalk.red('failed');
+        case 'running': return chalk.cyan('running');
+        default: return status;
+    }
+}
+// ─── Command Registration ───
+export function registerCronCommand(program) {
+    const cron = program
+        .command('cron')
+        .description('Manage scheduled cron jobs');
+    // ── create ──────────────────────────────────────────────────────────────────
+    cron
+        .command('create')
+        .description('Create a new cron job')
+        .requiredOption('--schedule <schedule>', 'Schedule: "every 15m", "daily at 9am EST", or cron expression')
+        .requiredOption('--type <type>', 'Job type: price_alert, custom_prompt, market_scan, portfolio_check, context_refresh')
+        .option('--name <name>', 'Job name (auto-generated if omitted)')
+        .option('--tokens <symbols>', 'Comma-separated token symbols (for market_scan)')
+        .option('--condition <condition>', 'Price condition, e.g. "BTC > 100000" (for price_alert)')
+        .option('--prompt <prompt>', 'Prompt text (for custom_prompt)')
+        .option('--delivery <channel>', 'Delivery channel: telegram, email, stream, silent', 'silent')
+        .option('--delivery-target <target>', 'Delivery target (chat ID, email address)')
+        .option('--timezone <tz>', 'Timezone (IANA name or abbreviation)')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (options) => {
+        if (!(await ensureRemote()))
+            return;
+        // Build config from options
+        const config = {};
+        if (options.tokens)
+            config.tokens = options.tokens.split(',').map((t) => t.trim().toUpperCase());
+        if (options.condition) {
+            // Extract token symbol from condition for price_alert
+            const match = options.condition.match(/^(\w+)\s/);
+            if (match)
+                config.tokenSymbol = match[1].toUpperCase();
+            config.condition = options.condition;
+        }
+        if (options.prompt)
+            config.prompt = options.prompt;
+        const name = options.name ?? `${options.type}: ${options.schedule}`;
+        try {
+            const result = await apiRequest('/api/v1/cron', {
+                method: 'POST',
+                body: {
+                    name,
+                    schedule: options.schedule,
+                    type: options.type,
+                    config,
+                    delivery: options.delivery,
+                    deliveryTarget: options.deliveryTarget,
+                    timezone: options.timezone,
+                },
+            });
+            if (options.format === 'json') {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log('');
+                console.log(chalk.green('  Cron job created'));
+                console.log(`  ${chalk.gray('ID:')}       ${result.id}`);
+                console.log(`  ${chalk.gray('Name:')}     ${result.name}`);
+                console.log(`  ${chalk.gray('Schedule:')} ${result.schedule} → ${chalk.dim(result.cronExpression)}`);
+                console.log(`  ${chalk.gray('Timezone:')} ${result.timezone}`);
+                console.log(`  ${chalk.gray('Type:')}     ${result.type}`);
+                console.log(`  ${chalk.gray('Next run:')} ${formatShortDate(result.nextRunAt)}`);
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleApiError(error, 'Cron create failed');
+        }
+    });
+    // ── list ────────────────────────────────────────────────────────────────────
+    cron
+        .command('list')
+        .description('List cron jobs')
+        .option('--status <status>', 'Filter by status: active, paused')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (options) => {
+        if (!(await ensureRemote()))
+            return;
+        try {
+            const query = options.status ? `?status=${options.status}` : '';
+            const result = await apiRequest(`/api/v1/cron${query}`);
+            if (options.format === 'json') {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (result.jobs.length === 0) {
+                console.log(chalk.dim('  No cron jobs found'));
+                return;
+            }
+            console.log('');
+            console.log('  ' +
+                padRight('Name', 30) +
+                padRight('Type', 16) +
+                padRight('Schedule', 20) +
+                padRight('Status', 10) +
+                padRight('Runs', 6) +
+                'Next Run');
+            console.log(chalk.gray('  ' + '─'.repeat(100)));
+            for (const job of result.jobs) {
+                console.log('  ' +
+                    padRight(job.name.slice(0, 28), 30) +
+                    padRight(job.type, 16) +
+                    padRight(job.schedule.slice(0, 18), 20) +
+                    padRight(formatStatus(job.status), 10) +
+                    padRight(String(job.runCount), 6) +
+                    formatShortDate(job.nextRunAt));
+            }
+            console.log('');
+            console.log(chalk.dim(`  ${result.count} job(s)`));
+            console.log('');
+        }
+        catch (error) {
+            handleApiError(error, 'Cron list failed');
+        }
+    });
+    // ── show ────────────────────────────────────────────────────────────────────
+    cron
+        .command('show <jobId>')
+        .description('Show details of a cron job')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (jobId, options) => {
+        if (!(await ensureRemote()))
+            return;
+        try {
+            const result = await apiRequest(`/api/v1/cron/${encodeURIComponent(jobId)}`);
+            if (options.format === 'json') {
+                console.log(JSON.stringify(result.job, null, 2));
+                return;
+            }
+            const job = result.job;
+            console.log('');
+            console.log(chalk.bold.cyan(`  Cron Job — ${job.name}`));
+            console.log(chalk.gray('  ' + '─'.repeat(50)));
+            console.log(`  ${chalk.gray('ID:')}          ${job.id}`);
+            console.log(`  ${chalk.gray('Status:')}      ${formatStatus(job.status)}`);
+            console.log(`  ${chalk.gray('Type:')}        ${job.type}`);
+            console.log(`  ${chalk.gray('Schedule:')}    ${job.schedule} → ${chalk.dim(job.cronExpression)}`);
+            console.log(`  ${chalk.gray('Timezone:')}    ${job.timezone}`);
+            console.log(`  ${chalk.gray('Delivery:')}    ${job.delivery}${job.deliveryTarget ? ` → ${job.deliveryTarget}` : ''}`);
+            console.log(`  ${chalk.gray('Run count:')}   ${job.runCount}`);
+            console.log(`  ${chalk.gray('Last run:')}    ${formatShortDate(job.lastRunAt)}`);
+            console.log(`  ${chalk.gray('Next run:')}    ${formatShortDate(job.nextRunAt)}`);
+            console.log(`  ${chalk.gray('Created:')}     ${formatShortDate(job.createdAt)}`);
+            console.log('');
+        }
+        catch (error) {
+            handleApiError(error, 'Cron show failed');
+        }
+    });
+    // ── pause ───────────────────────────────────────────────────────────────────
+    cron
+        .command('pause <jobId>')
+        .description('Pause a cron job')
+        .action(async (jobId) => {
+        if (!(await ensureRemote()))
+            return;
+        try {
+            await apiRequest(`/api/v1/cron/${encodeURIComponent(jobId)}`, {
+                method: 'PATCH',
+                body: { status: 'paused' },
+            });
+            console.log(chalk.green(`  Job ${jobId} paused`));
+        }
+        catch (error) {
+            handleApiError(error, 'Cron pause failed');
+        }
+    });
+    // ── resume ──────────────────────────────────────────────────────────────────
+    cron
+        .command('resume <jobId>')
+        .description('Resume a paused cron job')
+        .action(async (jobId) => {
+        if (!(await ensureRemote()))
+            return;
+        try {
+            await apiRequest(`/api/v1/cron/${encodeURIComponent(jobId)}`, {
+                method: 'PATCH',
+                body: { status: 'active' },
+            });
+            console.log(chalk.green(`  Job ${jobId} resumed`));
+        }
+        catch (error) {
+            handleApiError(error, 'Cron resume failed');
+        }
+    });
+    // ── delete ──────────────────────────────────────────────────────────────────
+    cron
+        .command('delete <jobId>')
+        .description('Delete a cron job')
+        .action(async (jobId) => {
+        if (!(await ensureRemote()))
+            return;
+        try {
+            await apiRequest(`/api/v1/cron/${encodeURIComponent(jobId)}`, {
+                method: 'DELETE',
+            });
+            console.log(chalk.green(`  Job ${jobId} deleted`));
+        }
+        catch (error) {
+            handleApiError(error, 'Cron delete failed');
+        }
+    });
+    // ── run ─────────────────────────────────────────────────────────────────────
+    cron
+        .command('run <jobId>')
+        .description('Trigger immediate execution of a cron job')
+        .action(async (jobId) => {
+        if (!(await ensureRemote()))
+            return;
+        try {
+            await apiRequest(`/api/v1/cron/${encodeURIComponent(jobId)}/run`, {
+                method: 'POST',
+            });
+            console.log(chalk.green(`  Job ${jobId} execution triggered`));
+        }
+        catch (error) {
+            handleApiError(error, 'Cron run failed');
+        }
+    });
+    // ── history ─────────────────────────────────────────────────────────────────
+    cron
+        .command('history <jobId>')
+        .description('View execution history for a cron job')
+        .option('--limit <n>', 'Number of runs to show', '20')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (jobId, options) => {
+        if (!(await ensureRemote()))
+            return;
+        try {
+            const limit = parseInt(options.limit, 10) || 20;
+            const result = await apiRequest(`/api/v1/cron/${encodeURIComponent(jobId)}/history?limit=${limit}`);
+            if (options.format === 'json') {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (result.runs.length === 0) {
+                console.log(chalk.dim('  No execution history'));
+                return;
+            }
+            console.log('');
+            console.log('  ' +
+                padRight('Time', 22) +
+                padRight('Status', 12) +
+                padRight('Tokens', 8) +
+                padRight('Delivered', 10) +
+                'Result');
+            console.log(chalk.gray('  ' + '─'.repeat(90)));
+            for (const run of result.runs) {
+                const summary = run.error
+                    ? chalk.red(run.error.slice(0, 40))
+                    : (run.resultSummary?.slice(0, 40) ?? chalk.dim('—'));
+                console.log('  ' +
+                    padRight(formatShortDate(run.time), 22) +
+                    padRight(formatStatus(run.status), 12) +
+                    padRight(String(run.tokensUsed), 8) +
+                    padRight(run.delivered ? chalk.green('yes') : chalk.dim('no'), 10) +
+                    summary);
+            }
+            console.log('');
+            console.log(chalk.dim(`  ${result.count} run(s)`));
+            console.log('');
+        }
+        catch (error) {
+            handleApiError(error, 'Cron history failed');
+        }
+    });
+}
+//# sourceMappingURL=cron-cmd.js.map

package/dist/commands/trader.js

@@ -424,11 +424,21 @@ export function registerTraderCommand(program) {
         }
         catch (error) {
             if (error instanceof ApiError && error.status === 404) {
-                console.error(chalk.yellow(options.file ? `Trader not found: "${nameOrId}"` : 'No SOUL document found.'));
+                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);
-                console.error(chalk.red(`Error: ${message}`));
+                if (options.format === 'json') {
+                    console.log(JSON.stringify({ error: message }));
+                }
+                else {
+                    console.error(chalk.red(`Error: ${message}`));
+                }
             }
             process.exitCode = error instanceof ApiError ? 2 : 1;
         }
@@ -484,11 +494,21 @@ export function registerTraderCommand(program) {
         }
         catch (error) {
             if (error instanceof ApiError && error.status === 404) {
-                console.error(chalk.yellow(options.file ? `Trader not found: "${nameOrId}"` : 'No PURPOSE document found.'));
+                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);
-                console.error(chalk.red(`Error: ${message}`));
+                if (options.format === 'json') {
+                    console.log(JSON.stringify({ error: message }));
+                }
+                else {
+                    console.error(chalk.red(`Error: ${message}`));
+                }
             }
             process.exitCode = error instanceof ApiError ? 2 : 1;
         }

package/dist/commands/watch.js

@@ -1,3 +1,4 @@
+import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
 import { formatContextOutput } from './context.js';
@@ -61,6 +62,7 @@ export function registerWatchCommand(program) {
         .description('Watch token data with periodic refresh')
         .option('-i, --interval <seconds>', 'Refresh interval in seconds', (v) => parseInt(v, 10))
         .option('-c, --context', 'Watch full ContextPackage (default interval: 60s)')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (symbol, options) => {
         const useContext = options.context === true;
         const defaultInterval = useContext ? DEFAULT_CONTEXT_INTERVAL_SECONDS : DEFAULT_INTERVAL_SECONDS;
@@ -71,8 +73,22 @@ export function registerWatchCommand(program) {
             return;
         }
         const mode = useContext ? 'context' : 'query';
+        const isJson = options.format === 'json';
         logger.info({ symbol, intervalSeconds, mode }, 'Starting watch mode');
-        const state = startWatchLoop(symbol, intervalSeconds, renderCycleRemote);
+        const renderFn = isJson
+            ? async (sym) => {
+                try {
+                    const pkg = await apiRequest(`/api/v1/tokens/${encodeURIComponent(sym.toUpperCase())}/context`);
+                    console.log(JSON.stringify({ watchedAt: new Date().toISOString(), symbol: sym.toUpperCase(), ...pkg }, null, 2));
+                    return pkg;
+                }
+                catch (error) {
+                    console.log(JSON.stringify({ error: error instanceof Error ? error.message : String(error), timestamp: new Date().toISOString() }));
+                    return null;
+                }
+            }
+            : renderCycleRemote;
+        const state = startWatchLoop(symbol, intervalSeconds, renderFn);
         // Clean exit on SIGINT (Ctrl+C)
         const cleanup = () => {
             logger.info('Watch mode stopped by user');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trading-boy/cli",
-  "version": "1.2.19",
+  "version": "1.3.0",
   "description": "Trading Boy CLI — crypto context intelligence for traders and AI agents. Query real-time prices, funding rates, whale activity, and DeFi risk for 100+ Solana tokens and 229 Hyperliquid perpetuals.",
   "homepage": "https://cabal.ventures",
   "repository": {
@@ -53,7 +53,7 @@
     "qrcode-terminal": "~0.12.0"
   },
   "devDependencies": {
-    "@trading-boy/core": "workspace:~1.2.0",
+    "@trading-boy/core": "workspace:*",
     "esbuild": "~0.27.4",
     "typescript": "^5.7.0"
   }