@trading-boy/cli 0.1.0

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,20 @@
+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);
+}
+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>;
+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,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBrE;AAID,wBAAgB,UAAU,IAAI,MAAM,CAEnC;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,CAyDZ;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/api-client.js

@@ -0,0 +1,81 @@
+import { createLogger } from '@trading-boy/core';
+import { loadCredentials, redactApiKey } from './credentials.js';
+const logger = createLogger('cli-api-client');
+// ─── Constants ───
+const DEFAULT_API_BASE = 'http://localhost:3003';
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'ApiError';
+    }
+}
+// ─── 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.');
+}
+// ─── API Base URL ───
+export function getApiBase() {
+    return process.env.TRADING_BOY_API_URL || DEFAULT_API_BASE;
+}
+// ─── API Request ───
+export async function apiRequest(path, options = {}) {
+    const apiKey = options.apiKey ?? (await resolveApiKey());
+    const apiBase = getApiBase();
+    const url = `${apiBase}${path}`;
+    const headers = {
+        'X-API-Key': apiKey,
+        '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');
+    const response = await fetch(url, fetchOptions);
+    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);
+        }
+        throw new ApiError(`API error: ${response.status}`, response.status, body);
+    }
+    return (await response.json());
+}
+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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,MAAM,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE9C,oBAAoB;AAEpB,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AASjD,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAU;QAG9B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,6BAA6B;AAE7B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB;IAClD,wCAAwC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;IACvC,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;AACxF,CAAC;AAED,uBAAuB;AAEvB,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,gBAAgB,CAAC;AAC7D,CAAC;AAED,sBAAsB;AAEtB,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,UAKI,EAAE;IAEN,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IAEhC,MAAM,OAAO,GAA2B;QACtC,WAAW,EAAE,MAAM;QACnB,cAAc,EAAE,kBAAkB;QAClC,GAAG,OAAO,CAAC,OAAO;KACnB,CAAC;IAEF,MAAM,YAAY,GAAgB;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,OAAO;KACR,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC;IAElE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEhD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,yEAAyE,EACzE,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,iFAAiF,EACjF,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,IAAI,QAAQ,CAChB,6BAA6B,UAAU,IAAI,IAAI,IAAI,EACnD,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,cAAc,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;AACtC,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

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":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,SAAS,IAAI,OAAO,CAyCnC;AAID,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}

package/dist/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+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';
+// ─── CLI Setup ───
+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('0.1.0');
+    // ─── 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);
+    // Authentication & billing
+    registerLoginCommand(program);
+    registerLogoutCommand(program);
+    registerWhoamiCommand(program);
+    registerBillingCommand(program);
+    registerSubscribeCommand(program);
+    // System management
+    registerConfigCommand(program);
+    registerInfraCommand(program);
+    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 isDirectRun = process.argv[1]?.endsWith('cli.js') || process.argv[1]?.endsWith('cli.ts');
+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,33 @@
+import { Command } from 'commander';
+import { type ChainVerificationResult, type VerifiableDecision } from '@trading-boy/core';
+import { type DecisionEventRecord } from '@trading-boy/graph-db';
+/**
+ * Convert a DecisionEventRecord (string eventTime) to a VerifiableDecision
+ * (Date eventTime) required by the core verifyChain function.
+ */
+export declare function toVerifiableDecision(record: DecisionEventRecord): VerifiableDecision;
+export interface AuditVerifyResult {
+    valid: boolean;
+    chainLength: number;
+    verifiedCount: number;
+    breakPoint?: {
+        index: number;
+        decisionId: string;
+        decisionType: string;
+        eventTime: string;
+    };
+}
+/**
+ * Build a human-readable audit result from chain verification output.
+ *
+ * @param verification - Core chain verification result
+ * @param decisions - The original decision records (for break point details)
+ * @returns Structured audit result
+ */
+export declare function buildAuditResult(verification: ChainVerificationResult, decisions: DecisionEventRecord[]): AuditVerifyResult;
+/**
+ * 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,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAwB/B;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAepF;AAID,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;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,uBAAuB,EACrC,SAAS,EAAE,mBAAmB,EAAE,GAC/B,iBAAiB,CAuBnB;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,CA4C3D"}

package/dist/commands/audit.js

@@ -0,0 +1,135 @@
+import chalk from 'chalk';
+import { getConfig, createLogger, verifyChain, } from '@trading-boy/core';
+import { Neo4jClient, getDecisionChain, } from '@trading-boy/graph-db';
+import { formatConnectionError } from '../utils.js';
+// ─── Logger ───
+const logger = createLogger('cli-audit');
+// ─── Default Trader ───
+const DEFAULT_TRADER_ID = 'default';
+// ─── Neo4j Client Factory ───
+function createNeo4jClient() {
+    const config = getConfig();
+    return new Neo4jClient({
+        uri: config.NEO4J_URI,
+        username: config.NEO4J_USER,
+        password: config.NEO4J_PASSWORD,
+    });
+}
+// ─── Record → VerifiableDecision Conversion ───
+/**
+ * Convert a DecisionEventRecord (string eventTime) to a VerifiableDecision
+ * (Date eventTime) required by the core verifyChain function.
+ */
+export function toVerifiableDecision(record) {
+    return {
+        decisionType: record.decisionType,
+        tokenSymbol: record.tokenSymbol,
+        eventTime: new Date(record.eventTime),
+        direction: record.direction,
+        entryPrice: record.entryPrice,
+        exitPrice: record.exitPrice,
+        size: record.size,
+        thesis: record.thesis,
+        confidence: record.confidence,
+        actor: record.actor,
+        hash: record.hash,
+        previousHash: record.previousHash,
+    };
+}
+/**
+ * Build a human-readable audit result from chain verification output.
+ *
+ * @param verification - Core chain verification result
+ * @param decisions - The original decision records (for break point details)
+ * @returns Structured audit result
+ */
+export function buildAuditResult(verification, decisions) {
+    if (verification.valid) {
+        return {
+            valid: true,
+            chainLength: decisions.length,
+            verifiedCount: decisions.length,
+        };
+    }
+    const breakIndex = verification.brokenAt;
+    const broken = decisions[breakIndex];
+    return {
+        valid: false,
+        chainLength: decisions.length,
+        verifiedCount: breakIndex,
+        breakPoint: {
+            index: breakIndex,
+            decisionId: broken.id,
+            decisionType: broken.decisionType,
+            eventTime: broken.eventTime,
+        },
+    };
+}
+// ─── 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)
+        .action(async (options) => {
+        const client = createNeo4jClient();
+        try {
+            await client.connect();
+            const decisions = await getDecisionChain(client, options.trader);
+            if (decisions.length === 0) {
+                console.log('No decisions found for trader.');
+                return;
+            }
+            const startTime = performance.now();
+            const verifiable = decisions.map(toVerifiableDecision);
+            const verification = verifyChain(verifiable);
+            const elapsed = performance.now() - startTime;
+            const result = buildAuditResult(verification, decisions);
+            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}`);
+            const guidance = formatConnectionError(message);
+            if (guidance)
+                console.error(guidance);
+            process.exitCode = 1;
+        }
+        finally {
+            await client.disconnect();
+        }
+    });
+}
+//# 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,40 @@
+import { Command } from 'commander';
+import type { BehavioralProfile, PatternCostAnalysis } from '@trading-boy/context-engine';
+/**
+ * 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;
+/**
+ * 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;
+//# 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;AAW5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAwB1F;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD;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,CA+HhE"}