@tradingboy/cli 0.3.8

package/README.md

@@ -0,0 +1,8 @@
+# @trading-boy/cli
+
+Command-line interface for Trading Boy, built with Commander.js.
+
+## Structure
+
+- **index.ts** — CLI entry point and command registration
+- **commands/** — Individual command implementations

package/dist/api-client.d.ts

@@ -0,0 +1,35 @@
+import { redactApiKey } from './credentials.js';
+export interface ApiResponse<T> {
+    data: T;
+    status: number;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, body?: unknown | undefined);
+}
+/**
+ * Dev mode: TRADING_BOY_API_URL points to localhost AND NODE_ENV=development.
+ * In dev mode, auth is not required (local API server runs without API keys).
+ */
+export declare function isDevMode(): boolean;
+export declare function resolveApiKey(flagKey?: string): Promise<string>;
+export declare function getApiBase(): string;
+export declare function apiRequest<T>(path: string, options?: {
+    method?: string;
+    body?: unknown;
+    apiKey?: string;
+    headers?: Record<string, string>;
+}): Promise<T>;
+/**
+ * Check if the CLI should use remote API mode.
+ *
+ * Remote mode activates when the user has an API key (from `login` or env var).
+ * In remote mode, commands route through the REST API instead of direct DB connections.
+ *
+ * Local/dev mode: direct DB connections (requires NEO4J_URI, TIMESCALE_HOST, etc.)
+ * Remote mode: HTTP requests to TRADING_BOY_API_URL (defaults to https://api.cabal.ventures)
+ */
+export declare function isRemoteMode(): Promise<boolean>;
+export { redactApiKey };
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUjE,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,QAAS,SAAQ,KAAK;aAGf,MAAM,EAAE,MAAM;aACd,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC;AAID;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAUnC;AAID,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBrE;AAwBD,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAID,wBAAsB,UAAU,CAAC,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,GACL,OAAO,CAAC,CAAC,CAAC,CA6EZ;AAID;;;;;;;;GAQG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAerD;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/api-client.js

@@ -0,0 +1,165 @@
+import { createLogger } from '@trading-boy/core';
+import { loadCredentials, redactApiKey } from './credentials.js';
+const logger = createLogger('cli-api-client');
+// ─── Constants ───
+const DEFAULT_API_BASE = 'https://api.cabal.ventures';
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'ApiError';
+    }
+}
+// ─── Dev Mode Detection ───
+/**
+ * Dev mode: TRADING_BOY_API_URL points to localhost AND NODE_ENV=development.
+ * In dev mode, auth is not required (local API server runs without API keys).
+ */
+export function isDevMode() {
+    if (process.env.NODE_ENV !== 'development')
+        return false;
+    const url = process.env.TRADING_BOY_API_URL;
+    if (!url)
+        return false;
+    try {
+        const parsed = new URL(url);
+        return parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1' || parsed.hostname === '::1';
+    }
+    catch {
+        return false;
+    }
+}
+// ─── API Key Resolution ───
+export async function resolveApiKey(flagKey) {
+    // Priority: env var > flag > stored key
+    const envKey = process.env.TRADING_BOY_API_KEY;
+    if (envKey) {
+        logger.debug('Using API key from TRADING_BOY_API_KEY env var');
+        return envKey;
+    }
+    if (flagKey) {
+        logger.debug('Using API key from --api-key flag');
+        return flagKey;
+    }
+    const stored = await loadCredentials();
+    if (stored?.apiKey) {
+        logger.debug('Using stored API key');
+        return stored.apiKey;
+    }
+    throw new Error('Not authenticated. Run `trading-boy login` to set up your API key.');
+}
+// ─── HTTPS Warning ───
+let httpsWarningShown = false;
+function warnIfInsecure(url) {
+    if (httpsWarningShown)
+        return;
+    try {
+        const parsed = new URL(url);
+        const isLocalhost = parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1' || parsed.hostname === '::1';
+        if (parsed.protocol === 'http:' && !isLocalhost) {
+            httpsWarningShown = true;
+            logger.warn({ url: parsed.origin }, 'API connection is not using HTTPS — credentials may be transmitted in plaintext');
+            // Also print to stderr so CLI users see it
+            process.stderr.write(`\x1b[33mWarning: API URL ${parsed.origin} is not using HTTPS. Your API key may be sent in plaintext.\nSet TRADING_BOY_API_URL to an https:// endpoint for production use.\x1b[0m\n`);
+        }
+    }
+    catch {
+        // Invalid URL — will fail at fetch time
+    }
+}
+// ─── API Base URL ───
+export function getApiBase() {
+    const base = process.env.TRADING_BOY_API_URL || DEFAULT_API_BASE;
+    warnIfInsecure(base);
+    return base;
+}
+// ─── API Request ───
+export async function apiRequest(path, options = {}) {
+    const dev = isDevMode();
+    const apiKey = dev ? undefined : (options.apiKey ?? (await resolveApiKey()));
+    const apiBase = getApiBase();
+    const url = `${apiBase}${path}`;
+    const headers = {
+        ...(apiKey ? { 'X-API-Key': apiKey } : {}),
+        ...(options.body ? { 'Content-Type': 'application/json' } : {}),
+        ...options.headers,
+    };
+    const fetchOptions = {
+        method: options.method ?? 'GET',
+        headers,
+    };
+    if (options.body) {
+        fetchOptions.body = JSON.stringify(options.body);
+    }
+    logger.debug({ url, method: fetchOptions.method }, 'API request');
+    let response;
+    try {
+        response = await fetch(url, fetchOptions);
+    }
+    catch (error) {
+        // Network-level failures (connection refused, DNS errors, timeouts)
+        const msg = error instanceof Error ? error.message : String(error);
+        const lower = msg.toLowerCase();
+        if (lower.includes('econnrefused') || lower.includes('fetch failed') || lower.includes('enotfound') || lower.includes('connection refused')) {
+            throw new ApiError(`Cannot connect to API at ${apiBase}. The server may be offline or unreachable.\n` +
+                '  → Check your connection or try again later.\n' +
+                '  → If self-hosting, ensure the API is running: pnpm start:api', 0);
+        }
+        throw new ApiError(`Network error: ${msg}`, 0);
+    }
+    if (response.status === 401) {
+        throw new ApiError('API key invalid or expired. Run `trading-boy login` to re-authenticate.', 401);
+    }
+    if (response.status === 403) {
+        throw new ApiError('Subscription inactive. Run `trading-boy billing manage` to update your billing.', 403);
+    }
+    if (response.status === 429) {
+        const retryAfter = response.headers.get('Retry-After');
+        throw new ApiError(`Rate limited. Retry after ${retryAfter ?? '60'}s.`, 429);
+    }
+    if (!response.ok) {
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch {
+            body = await response.text().catch(() => null);
+        }
+        const errorMessage = (body && typeof body === 'object' && 'error' in body && typeof body.error === 'string')
+            ? body.error
+            : `API error: ${response.status}`;
+        throw new ApiError(errorMessage, response.status, body);
+    }
+    return (await response.json());
+}
+// ─── Remote Mode Detection ───
+/**
+ * Check if the CLI should use remote API mode.
+ *
+ * Remote mode activates when the user has an API key (from `login` or env var).
+ * In remote mode, commands route through the REST API instead of direct DB connections.
+ *
+ * Local/dev mode: direct DB connections (requires NEO4J_URI, TIMESCALE_HOST, etc.)
+ * Remote mode: HTTP requests to TRADING_BOY_API_URL (defaults to https://api.cabal.ventures)
+ */
+export async function isRemoteMode() {
+    // Explicit env var override
+    if (process.env.TRADING_BOY_LOCAL === 'true')
+        return false;
+    // Tests always run in local mode
+    if (process.env.NODE_ENV === 'test')
+        return false;
+    // If API URL is explicitly set, use remote mode
+    if (process.env.TRADING_BOY_API_URL)
+        return true;
+    // If API key is available (env or stored), use remote mode
+    if (process.env.TRADING_BOY_API_KEY)
+        return true;
+    const stored = await loadCredentials();
+    return !!stored?.apiKey;
+}
+export { redactApiKey };
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+export declare function createCli(): Command;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CpC,wBAAgB,SAAS,IAAI,OAAO,CA0FnC;AAID,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}

package/dist/cli.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+// Suppress pino INFO logs in CLI — only show warnings and errors
+if (!process.env.LOG_LEVEL) {
+    process.env.LOG_LEVEL = 'warn';
+}
+// Tell the logger to write to stderr so stdout stays clean for piping
+process.env.TRADING_BOY_CLI = '1';
+// TTY detection: when piped, disable colors and spinners for machine-parseable output
+if (!process.stdout.isTTY) {
+    process.env.FORCE_COLOR = '0'; // Ensure chalk strips ANSI codes
+    process.env.NO_COLOR = '1'; // Standard no-color convention (https://no-color.org)
+}
+import { Command } from 'commander';
+import { registerQueryCommand } from './commands/query.js';
+import { registerWatchCommand } from './commands/watch.js';
+import { registerCatalystsCommand } from './commands/catalysts.js';
+import { registerRiskCommand } from './commands/risk.js';
+import { registerDecisionsCommand } from './commands/decisions.js';
+import { registerTraderCommand } from './commands/trader.js';
+import { registerBehavioralCommand } from './commands/behavioral.js';
+import { registerSocialCommand } from './commands/social.js';
+import { registerNarrativeCommand } from './commands/narratives.js';
+import { registerEventsCommand } from './commands/events.js';
+import { registerJournalCommand } from './commands/journal.js';
+import { registerAuditCommand } from './commands/audit.js';
+import { registerContextCommand } from './commands/context.js';
+import { registerConfigCommand } from './commands/config-cmd.js';
+import { registerInfraCommand } from './commands/infra.js';
+import { registerLoginCommand } from './commands/login.js';
+import { registerLogoutCommand } from './commands/logout.js';
+import { registerWhoamiCommand } from './commands/whoami.js';
+import { registerBillingCommand } from './commands/billing.js';
+import { registerSubscribeCommand } from './commands/subscribe.js';
+import { registerEdgeCommand } from './commands/edge-cmd.js';
+import { registerEdgeGuardCommand } from './commands/edge-guard-cmd.js';
+import { registerCoachingCommand } from './commands/coaching-cmd.js';
+import { registerThesisCommand } from './commands/thesis-cmd.js';
+import { registerStrategyCommand } from './commands/strategy-cmd.js';
+import { registerReplayCommand } from './commands/replay-cmd.js';
+import { registerBenchmarkCommand } from './commands/benchmark-cmd.js';
+import { registerSuggestionsCommand } from './commands/suggestions-cmd.js';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+// ─── CLI Setup ───
+function getVersion() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = resolve(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    return pkg.version;
+}
+export function createCli() {
+    const program = new Command();
+    program
+        .name('trading-boy')
+        .description('Trading Boy — Crypto context graph system for traders and agentic trading systems')
+        .version(getVersion());
+    // ─── Register all commands ───
+    // Primary: context assembly
+    registerContextCommand(program);
+    // Data queries
+    registerQueryCommand(program);
+    registerWatchCommand(program);
+    registerCatalystsCommand(program);
+    registerRiskCommand(program);
+    registerSocialCommand(program);
+    registerNarrativeCommand(program);
+    // Trading journal & decisions
+    registerJournalCommand(program);
+    registerDecisionsCommand(program);
+    registerTraderCommand(program);
+    registerBehavioralCommand(program);
+    registerAuditCommand(program);
+    registerEventsCommand(program);
+    // Edge analysis & safety
+    registerEdgeCommand(program);
+    registerEdgeGuardCommand(program);
+    // Authentication & billing
+    registerLoginCommand(program);
+    registerLogoutCommand(program);
+    registerWhoamiCommand(program);
+    registerBillingCommand(program);
+    registerSubscribeCommand(program);
+    // Learning & coaching
+    registerCoachingCommand(program);
+    registerThesisCommand(program);
+    // Strategy, replay & benchmark
+    registerStrategyCommand(program);
+    registerReplayCommand(program);
+    registerBenchmarkCommand(program);
+    registerSuggestionsCommand(program);
+    // System management
+    registerConfigCommand(program);
+    registerInfraCommand(program);
+    // ─── Custom grouped help display (P1-5) ───
+    const GROUPS = {
+        'Core': ['context', 'query', 'watch'],
+        'Data & Analysis': ['catalysts', 'risk', 'social', 'narrative', 'events'],
+        'Trading Journal': ['journal', 'decisions', 'stats', 'trader', 'behavioral', 'audit'],
+        'Edge & Safety': ['edge', 'edge-guard', 'coaching', 'thesis'],
+        'Strategy & Benchmarking': ['strategy', 'replay', 'benchmark', 'suggestions'],
+        'Account': ['login', 'logout', 'whoami', 'billing', 'subscribe'],
+        'System': ['config', 'infra'],
+    };
+    program.addHelpText('before', '');
+    program.addHelpText('after', () => {
+        const commands = program.commands;
+        const cmdMap = new Map(commands.map((c) => [c.name(), c]));
+        const pad = 18;
+        const lines = ['', 'Command Groups:'];
+        const grouped = new Set();
+        for (const [groupName, cmdNames] of Object.entries(GROUPS)) {
+            const groupCmds = cmdNames.filter((n) => cmdMap.has(n));
+            if (groupCmds.length === 0)
+                continue;
+            lines.push(`\n  ${groupName}:`);
+            for (const name of groupCmds) {
+                const c = cmdMap.get(name);
+                lines.push(`    ${name.padEnd(pad)}${c.description() || ''}`);
+                grouped.add(name);
+            }
+        }
+        return lines.join('\n');
+    });
+    return program;
+}
+// ─── Main Entry Point ───
+export async function main() {
+    const program = createCli();
+    await program.parseAsync(process.argv);
+}
+// Auto-execute when run directly (not during test imports)
+const scriptName = process.argv[1] ?? '';
+const isDirectRun = scriptName.endsWith('cli.js') ||
+    scriptName.endsWith('cli.ts') ||
+    scriptName.endsWith('/trading-boy');
+if (isDirectRun) {
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/audit.d.ts

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+export interface AuditVerifyResult {
+    valid: boolean;
+    chainLength: number;
+    verifiedCount: number;
+    breakPoint?: {
+        index: number;
+        decisionId: string;
+        decisionType: string;
+        eventTime: string;
+    };
+}
+/**
+ * Format audit verification output with chalk styling.
+ */
+export declare function formatAuditVerifyOutput(result: AuditVerifyResult, elapsedMs: number): string;
+export declare function registerAuditCommand(program: Command): void;
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAgB5C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAwB5F;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC3D"}

package/dist/commands/audit.js

@@ -0,0 +1,73 @@
+import { Option } from 'commander';
+import chalk from 'chalk';
+import { createLogger } from '@trading-boy/core';
+import { formatConnectionError } from '../utils.js';
+import { apiRequest, ApiError } from '../api-client.js';
+// ─── Logger ───
+const logger = createLogger('cli-audit');
+// ─── Default Trader ───
+const DEFAULT_TRADER_ID = 'default';
+// ─── Formatter ───
+/**
+ * Format audit verification output with chalk styling.
+ */
+export function formatAuditVerifyOutput(result, elapsedMs) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold.cyan('  Audit Verification'));
+    lines.push(chalk.gray('  ' + '\u2500'.repeat(50)));
+    lines.push('');
+    if (result.valid) {
+        lines.push(`  ${chalk.green('\u2713')} ${chalk.green('Chain integrity verified')}`);
+        lines.push(`  ${chalk.gray('Decisions verified:')}  ${chalk.white(String(result.verifiedCount))}`);
+        lines.push(`  ${chalk.gray('Chain length:')}        ${chalk.white(String(result.chainLength))}`);
+    }
+    else {
+        lines.push(`  ${chalk.red('\u2717')} ${chalk.red(`Chain integrity BROKEN at decision ${result.breakPoint.index}`)}`);
+        lines.push(`  ${chalk.gray('Decision ID:')}   ${chalk.white(result.breakPoint.decisionId)}`);
+        lines.push(`  ${chalk.gray('Type:')}          ${chalk.white(result.breakPoint.decisionType)}`);
+        lines.push(`  ${chalk.gray('Event time:')}    ${chalk.white(result.breakPoint.eventTime)}`);
+        lines.push(`  ${chalk.gray('Verified:')}      ${chalk.yellow(`${result.verifiedCount} of ${result.chainLength}`)} decisions`);
+    }
+    lines.push(`  ${chalk.dim(`Elapsed: ${elapsedMs.toFixed(2)}ms`)}`);
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Command Registration ───
+export function registerAuditCommand(program) {
+    const audit = program
+        .command('audit')
+        .description('Audit and integrity verification commands');
+    // ─── audit verify ───
+    audit
+        .command('verify')
+        .description('Verify the integrity of the decision hash chain')
+        .option('--trader <traderId>', 'Trader ID', DEFAULT_TRADER_ID)
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (options) => {
+        try {
+            const startTime = performance.now();
+            const result = await apiRequest(`/api/v1/audit/verify?traderId=${encodeURIComponent(options.trader)}`);
+            const elapsed = performance.now() - startTime;
+            if (options.format === 'json') {
+                console.log(JSON.stringify({ ...result, elapsedMs: Number(elapsed.toFixed(2)) }, null, 2));
+            }
+            else {
+                console.log(formatAuditVerifyOutput(result, elapsed));
+            }
+            logger.debug({ elapsed: elapsed.toFixed(2) + 'ms' }, 'Chain verification complete');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error: message }, 'Failed to verify chain');
+            console.error(`Error: ${message}`);
+            if (!(error instanceof ApiError)) {
+                const guidance = formatConnectionError(message);
+                if (guidance)
+                    console.error(guidance);
+            }
+            process.exitCode = error instanceof ApiError ? 2 : 1;
+        }
+    });
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/behavioral.d.ts

@@ -0,0 +1,73 @@
+import { Command } from 'commander';
+/**
+ * Parse a period string like "30d", "7d", "90d" into days.
+ * Returns default 30 if the string cannot be parsed.
+ */
+export declare function parsePeriodDays(period: string): number;
+/** Behavioral pattern enum values (kept local to avoid context-engine dep) */
+declare const BehavioralPatternValues: {
+    readonly REVENGE_TRADING: "REVENGE_TRADING";
+    readonly FOMO_ENTRY: "FOMO_ENTRY";
+    readonly OVERTRADING: "OVERTRADING";
+    readonly STOP_VIOLATION: "STOP_VIOLATION";
+    readonly TILT_CASCADE: "TILT_CASCADE";
+};
+type BehavioralPatternValue = (typeof BehavioralPatternValues)[keyof typeof BehavioralPatternValues];
+interface BehavioralProfile {
+    traderId: string;
+    period: string;
+    revengeTradeCount: number;
+    fomoEntryCount: number;
+    overtradingDays: number;
+    stopViolationCount: number;
+    tiltCascadeCount: number;
+    commitmentHonorRate: number;
+    overallScore: number;
+}
+interface PatternCostEntry {
+    pattern: BehavioralPatternValue;
+    occurrences: number;
+    totalCost: number;
+    winRate: number;
+}
+interface PatternCostAnalysis {
+    entries: PatternCostEntry[];
+    totalBehavioralCost: number;
+    baselineWinRate: number;
+    totalPnl: number;
+    pnlWithoutBehavioralTrades: number;
+}
+/**
+ * Color-code a behavioral health score.
+ * 0-30: green (healthy), 31-60: yellow (watch), 61+: red (concerning)
+ */
+export declare function colorScore(score: number): string;
+/**
+ * Format a commitment honor rate as a colored percentage.
+ */
+export declare function colorHonorRate(rate: number): string;
+/**
+ * Return the label for a behavioral health score.
+ */
+export declare function scoreLabel(score: number): string;
+/**
+ * Format a full behavioral profile as a human-readable string.
+ */
+export declare function formatBehavioralProfile(profile: BehavioralProfile): string;
+/**
+ * Format a list of decisions with behavioral flags.
+ */
+export declare function formatBehavioralFlags(decisions: Array<{
+    id: string;
+    eventTime: string;
+    tokenSymbol: string;
+    decisionType: string;
+    behavioralFlags: string[];
+}>): string;
+/**
+ * Format a pattern cost analysis as a human-readable table.
+ */
+export declare function formatCostAnalysis(analysis: PatternCostAnalysis, period: string): string;
+export declare function registerBehavioralCommand(program: Command): void;
+export {};
+//# sourceMappingURL=behavioral.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"behavioral.d.ts","sourceRoot":"","sources":["../../src/commands/behavioral.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAgB5C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD;AAID,8EAA8E;AAC9E,QAAA,MAAM,uBAAuB;;;;;;CAMnB,CAAC;AAEX,KAAK,sBAAsB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAErG,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,sBAAsB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAoD1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC,GACD,MAAM,CA0CR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA6DxF;AA8CD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8HhE"}