@trading-boy/cli 1.5.1 → 1.6.1

package/dist/commands/onboarding.js

@@ -6,6 +6,7 @@
 // 3. Next steps cheat sheet
 import chalk from 'chalk';
 import { isRemoteMode, apiRequest, ApiError } from '../api-client.js';
+import { runSoulWizardAndUpload } from './soul-wizard.js';
 // ─── Onboarding Flow ───
 /**
  * Run the interactive onboarding wizard.
@@ -21,6 +22,7 @@ export async function runOnboarding() {
     console.log('');
     // ─── Step 1: Register Trader ───
     let traderRegistered = false;
+    let traderName = 'default';
     try {
         const wantsTrader = await confirm({
             message: 'Register your trader profile?',
@@ -54,6 +56,7 @@ export async function runOnboarding() {
                         console.log(chalk.dim('  This alias is public on the leaderboard. Change it anytime:'));
                         console.log(chalk.dim('  trading-boy trader set-alias <name> <new-alias>'));
                     }
+                    traderName = name.trim();
                     traderRegistered = true;
                 }
                 else {
@@ -63,6 +66,7 @@ export async function runOnboarding() {
             catch (error) {
                 if (error instanceof ApiError && error.status === 409) {
                     console.log(chalk.green('  \u2713 Trader profile already exists.'));
+                    traderName = name.trim();
                     traderRegistered = true;
                 }
                 else {
@@ -86,7 +90,7 @@ export async function runOnboarding() {
     if (traderRegistered) {
         try {
             const wantsIdentity = await confirm({
-                message: 'Set up your trading identity? (SOUL + PURPOSE documents)',
+                message: 'Set up your trading identity? (interactive SOUL wizard)',
                 default: true,
             });
             if (wantsIdentity) {
@@ -94,15 +98,19 @@ export async function runOnboarding() {
                 console.log(chalk.dim('  Your identity personalizes context — bias warnings, scope checks,'));
                 console.log(chalk.dim('  and tailored synthesis based on who you are as a trader.'));
                 console.log('');
-                console.log(`  ${chalk.gray('1.')} Create a ${chalk.white('soul.md')} file describing your trading personality, risk tolerance, and biases`);
-                console.log(`  ${chalk.gray('2.')} Create a ${chalk.white('purpose.md')} file defining your mission, asset scope, and goals`);
-                console.log(`  ${chalk.gray('3.')} Upload them:`);
-                console.log(`     ${chalk.white('trading-boy trader soul <name> --file soul.md')}`);
-                console.log(`     ${chalk.white('trading-boy trader purpose <name> --file purpose.md')}`);
-                console.log(`  ${chalk.gray('4.')} View your identity: ${chalk.white('trading-boy trader identity <name>')}`);
+                try {
+                    await runSoulWizardAndUpload(traderName);
+                }
+                catch (wizardError) {
+                    if (isUserAbort(wizardError))
+                        return;
+                    const msg = wizardError instanceof Error ? wizardError.message : String(wizardError);
+                    console.log(chalk.yellow(`  Could not complete SOUL wizard: ${msg}`));
+                    console.log(chalk.dim('  You can do this later: trading-boy trader soul-wizard <name>'));
+                }
             }
             else {
-                console.log(chalk.dim('  Skipped. Set up later: trading-boy trader soul <name> --file soul.md'));
+                console.log(chalk.dim('  Skipped. Run later: trading-boy trader soul-wizard <name>'));
             }
         }
         catch (error) {
@@ -120,14 +128,14 @@ export async function runOnboarding() {
         });
         if (wantsTelegram) {
             console.log('');
-            console.log(chalk.white('  Open Telegram and message ') + chalk.cyan.bold('@TradingBoy1_Bot'));
-            console.log(chalk.white('  Send ') + chalk.cyan('/start') + chalk.white(' to connect your account.'));
+            console.log(chalk.white('  Click to open the bot: ') + chalk.cyan.underline('https://t.me/TradingBoy1_Bot'));
+            console.log(chalk.white('  Send ') + chalk.cyan('/start') + chalk.white(' and paste your API key to connect.'));
             console.log('');
             console.log(chalk.dim('  The bot will send you a daily trading summary at 08:00 UTC.'));
-            console.log(chalk.dim('  You can also use /summary, /entry, /exit, /context, and /stats.'));
+            console.log(chalk.dim('  You can also use /summary, /agents, /positions, /pause, and /soul.'));
         }
         else {
-            console.log(chalk.dim('  Skipped. Message @TradingBoy1_Bot on Telegram anytime to connect.'));
+            console.log(chalk.dim('  Skipped. Connect anytime: ') + chalk.dim.underline('https://t.me/TradingBoy1_Bot'));
         }
     }
     catch (error) {

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

@@ -0,0 +1,29 @@
+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

@@ -0,0 +1,155 @@
+// ─── 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/subscribe.js

@@ -217,8 +217,8 @@ export function formatSubscribeSuccess(result) {
         lines.push(`  ${chalk.bold('API Key:')}  ${chalk.yellow(result.apiKey)}`);
         lines.push('');
         lines.push(chalk.dim('  ⚠️  Copy this key now — it will not be shown again.'));
-        lines.push(chalk.dim('  Use it to connect Telegram: send /start to @TradingBoy1_Bot'));
-        lines.push(chalk.dim('  and paste the key when prompted.'));
+        lines.push(chalk.dim('  Connect Telegram: ') + chalk.dim.underline('https://t.me/TradingBoy1_Bot'));
+        lines.push(chalk.dim('  Send /start and paste this key when prompted.'));
     }
     else if (result.keyPrefix) {
         lines.push(`  ${chalk.bold('Key ID:')}   ${result.keyPrefix}`);

package/dist/commands/trader.js

@@ -443,6 +443,32 @@ export function registerTraderCommand(program) {
             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')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trading-boy/cli",
-  "version": "1.5.1",
+  "version": "1.6.1",
   "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": {