@talocode/tradia 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdulmuiz Adeyemo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,68 +1,160 @@
-# Tradia
+# Tradia Agentic Trading OS
 
-Local-first trading intelligence for prop firm traders.
+Agentic trading intelligence for trade proposals, risk checks, journals, performance reports and public accountability updates.
 
-## Install
+**⚠️ Not financial advice. Human review required before acting on any trade.**
 
-```bash
-npx @talocode/tradia
-```
+## Features
+
+- **Proposal Mode** — Generate structured trade proposals with invalidation and risk
+- **Risk Engine** — Position sizing, risk-reward, drawdown, exposure, revenge trading detection
+- **Journal Mode** — Create trade journal entries with lessons and discipline scores
+- **Performance Analysis** — Win rate, profit factor, expectancy, max drawdown, R-multiples
+- **Backtest Simulation** — Equity curves, win rates, drawdown analysis
+- **Public Accountability** — Generate public updates explaining trades and performance
+- **Portfolio Reports** — Account-level performance summaries
+- **CLI** — Full command-line interface for local usage
+- **API Server** — REST API for hosted and local usage
+- **SDK** — TypeScript client for Node.js applications
+- **MCP Tools** — Model Context Protocol tools for AI agent integration
+
+## Supported Markets
+
+`forex` · `crypto` · `stocks` · `indices` · `commodities` · `prop_firm_account` · `paper_account`
+
+## Supported Strategies
 
-Global install:
+`liquidity_sweep` · `trend_continuation` · `breakout_retest` · `support_resistance` · `mean_reversion` · `momentum` · `news_avoidance` · `custom`
+
+## Installation
 
 ```bash
-npm install -g @talocode/tradia
-tradia
+npm install @talocode/tradia
 ```
 
-## First run
+## CLI Usage
 
 ```bash
-tradia init
-tradia import ./trades.csv
-tradia stats
-tradia review week
-```
+# Generate a trade proposal
+tradia propose --symbol XAUUSD --market forex --strategy liquidity_sweep --balance 500 --risk 0.5 --entry 2365.5 --stop 2372 --target 2350
 
-## Storage
+# Check risk parameters
+tradia risk --balance 500 --risk 0.5 --entry 2365.5 --stop 2372 --target 2350
 
-Tradia stores data locally in `~/.tradia/`:
+# Journal a trade
+tradia journal --file trade.json
 
-- `config.json`
-- `trades.json`
-- `rules.json`
-- `reports/`
+# Run a backtest
+tradia backtest --file trades.json --balance 500 --risk 0.5
 
-No secrets, telemetry, broker connections, or paid APIs are required.
+# Generate a public accountability update
+tradia public-update --file trade-result.json
+```
 
-## CSV import
+## SDK Usage
 
-Tradia imports common broker CSV exports and normalizes them into a local trade journal. See `docs/CSV_IMPORT.md` for the supported column mapping and a sample file.
+```typescript
+import { TradiaClient } from '@talocode/tradia'
 
-## Commands
+const tradia = new TradiaClient()
+
+// Local mode (no API key required)
+const proposal = await tradia.trade.propose({
+  market: 'forex',
+  symbol: 'XAUUSD',
+  accountBalance: 500,
+  riskPercent: 0.5,
+  strategy: 'liquidity_sweep',
+  entry: 2365.5,
+  stopLoss: 2372,
+  takeProfit: 2350,
+})
+
+console.log(proposal)
+```
+
+## API Server
 
 ```bash
-tradia
-tradia --version
-tradia --help
-tradia init
-tradia import ./trades.csv
-tradia trades list
-tradia stats
-tradia mistakes
-tradia risk
-tradia review week
-tradia plan tomorrow
-tradia rules set ftmo
-tradia rules status
-tradia doctor
+# Start the server
+PORT=3070 npx tradia-server
+
+# Health check
+curl http://localhost:3070/health
+
+# Trade proposal
+curl -X POST http://localhost:3070/v1/tradia/trade/propose \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "symbol": "XAUUSD",
+    "market": "forex",
+    "accountBalance": 500,
+    "riskPercent": 0.5,
+    "entry": 2365.5,
+    "stopLoss": 2372,
+    "takeProfit": 2350
+  }'
 ```
 
-## Limitations
+## API Routes
+
+| Method | Path | Description | Credits |
+|--------|------|-------------|---------|
+| GET | `/health` | Health check | — |
+| GET | `/v1/tradia/health` | Health check | — |
+| POST | `/v1/tradia/agent/plan` | Generate agent plan | 40 |
+| POST | `/v1/tradia/market/analyze` | Analyze market context | 30 |
+| POST | `/v1/tradia/signal/evaluate` | Evaluate a signal | 30 |
+| POST | `/v1/tradia/risk/check` | Check risk parameters | 20 |
+| POST | `/v1/tradia/trade/propose` | Generate trade proposal | 40 |
+| POST | `/v1/tradia/trade/journal` | Create journal entry | 25 |
+| POST | `/v1/tradia/portfolio/report` | Portfolio report | 50 |
+| POST | `/v1/tradia/performance/analyze` | Performance analysis | 35 |
+| POST | `/v1/tradia/public-update/generate` | Public accountability update | 30 |
+| POST | `/v1/tradia/backtest/simulate` | Backtest simulation | 60 |
+| POST | `/v1/tradia/accountability/card` | Accountability card | 25 |
+| POST | `/v1/tradia/export/markdown` | Export as markdown | 5 |
+| POST | `/v1/tradia/export/json` | Export as JSON | 5 |
+
+## Talocode Cloud Usage
+
+```typescript
+import { TradiaClient } from '@talocode/tradia'
+
+const tradia = new TradiaClient({
+  apiKey: process.env.TALOCODE_API_KEY,
+  useCloud: true,
+})
+
+const proposal = await tradia.trade.propose({
+  market: 'forex',
+  symbol: 'XAUUSD',
+  accountBalance: 500,
+  riskPercent: 0.5,
+  strategy: 'liquidity_sweep',
+  entry: 2365.5,
+  stopLoss: 2372,
+  takeProfit: 2350,
+})
+```
+
+## Safety Boundaries
+
+Tradia v0.1 is **agentic trading intelligence**, not live autonomous execution.
+
+- **No real trade execution** — v0.1 does not connect to any broker
+- **No financial advice** — All outputs are educational analysis
+- **No guaranteed profits** — Past performance does not guarantee future results
+- **Human review required** — Every output requires human review before action
+- **Proposal/simulation mode only** — No live order placement
+- **Risk warnings included** — Every output includes risk disclaimers
+
+## Support
+
+Open-source Talocode products are built and maintained by Abdulmuiz Adeyemo.
+
+Sponsor the work: https://github.com/sponsors/Abdulmuiz44
+
+## License
 
-- CSV import first
-- No broker connection yet
-- No auto-trading
-- No financial advice
-- No paid APIs required
-- No cloud sync yet
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,8 @@
+export interface AuthResult {
+    authenticated: boolean;
+    apiKey?: string;
+    reason?: string;
+}
+export declare function authenticateRequest(authHeader?: string | null, xApiKey?: string | null): AuthResult;
+export declare function redactApiKey(key?: string): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/tradia/auth.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,OAAO,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,CAuBnG;AAYD,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/auth.js

@@ -0,0 +1,36 @@
+export function authenticateRequest(authHeader, xApiKey) {
+    if (process.env.TRADIA_ALLOW_LOCAL_UNAUTH === 'true' && !authHeader && !xApiKey) {
+        return { authenticated: true, reason: 'local_unauth_mode' };
+    }
+    const apiKey = extractApiKey(authHeader, xApiKey);
+    if (!apiKey) {
+        return { authenticated: false, reason: 'missing_api_key' };
+    }
+    if (process.env.TALOCODE_API_KEY && apiKey !== process.env.TALOCODE_API_KEY) {
+        return { authenticated: false, reason: 'invalid_api_key' };
+    }
+    if (!process.env.TALOCODE_API_KEY) {
+        if (process.env.TRADIA_ALLOW_LOCAL_UNAUTH === 'true') {
+            return { authenticated: true, reason: 'local_mode_with_key' };
+        }
+        return { authenticated: false, reason: 'no_api_key_configured' };
+    }
+    return { authenticated: true, apiKey };
+}
+function extractApiKey(authHeader, xApiKey) {
+    if (authHeader && authHeader.startsWith('Bearer ')) {
+        return authHeader.slice(7).trim();
+    }
+    if (xApiKey) {
+        return xApiKey.trim();
+    }
+    return undefined;
+}
+export function redactApiKey(key) {
+    if (!key)
+        return '(none)';
+    if (key.length <= 8)
+        return '****';
+    return key.slice(0, 4) + '****' + key.slice(-4);
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/tradia/auth.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,mBAAmB,CAAC,UAA0B,EAAE,OAAuB;IACrF,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;QAChF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAEjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC5E,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC5D,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,EAAE,CAAC;YACrD,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAA;QAC/D,CAAC;QACD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAA;IAClE,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACxC,CAAC;AAED,SAAS,aAAa,CAAC,UAA0B,EAAE,OAAuB;IACxE,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACnC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;IACvB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAA;IACzB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IAClC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC"}

package/dist/billing.d.ts

@@ -0,0 +1,14 @@
+import type { BillingAction } from './types.js';
+export declare class TradiaBillingError extends Error {
+    statusCode: number;
+    code: string;
+    constructor(message: string, statusCode: number, code: string);
+}
+export interface BillingResult {
+    charged: boolean;
+    credits: number;
+    action: string;
+    remaining?: number;
+}
+export declare function chargeCredits(action: BillingAction): Promise<BillingResult>;
+//# sourceMappingURL=billing.d.ts.map

package/dist/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../src/tradia/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C,qBAAa,kBAAmB,SAAQ,KAAK;IAGlC,UAAU,EAAE,MAAM;IAClB,IAAI,EAAE,MAAM;gBAFnB,OAAO,EAAE,MAAM,EACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM;CAKtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAyDjF"}

package/dist/billing.js

@@ -0,0 +1,64 @@
+import { PRICING } from './types.js';
+export class TradiaBillingError extends Error {
+    statusCode;
+    code;
+    constructor(message, statusCode, code) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = 'TradiaBillingError';
+    }
+}
+export async function chargeCredits(action) {
+    const apiKey = process.env.TALOCODE_API_KEY;
+    const baseUrl = process.env.TALOCODE_BASE_URL || 'https://api.talocode.site';
+    if (!apiKey) {
+        if (process.env.TRADIA_ALLOW_LOCAL_UNAUTH === 'true') {
+            return { charged: false, credits: 0, action };
+        }
+        throw new TradiaBillingError('TALOCODE_API_KEY is required for hosted billing', 401, 'auth_error');
+    }
+    const credits = PRICING[action] || 0;
+    try {
+        const response = await fetch(`${baseUrl}/api/v1/cloud/usage/charge`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                product: 'tradia',
+                action,
+                credits,
+            }),
+        });
+        if (response.status === 401) {
+            throw new TradiaBillingError('Invalid or missing API key', 401, 'auth_error');
+        }
+        if (response.status === 402) {
+            let body = {};
+            try {
+                body = await response.json();
+            }
+            catch { }
+            const errBody = body.error;
+            throw new TradiaBillingError(errBody?.message || 'Insufficient credits', 402, 'insufficient_credits');
+        }
+        if (!response.ok) {
+            throw new TradiaBillingError('Billing service unavailable', 502, 'billing_unavailable');
+        }
+        const body = await response.json();
+        return {
+            charged: body?.charged === true,
+            credits,
+            action,
+            remaining: typeof body?.remaining === 'number' ? body.remaining : undefined,
+        };
+    }
+    catch (err) {
+        if (err instanceof TradiaBillingError)
+            throw err;
+        throw new TradiaBillingError('Billing service unavailable', 502, 'billing_unavailable');
+    }
+}
+//# sourceMappingURL=billing.js.map

package/dist/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/tradia/billing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGlC;IACA;IAHT,YACE,OAAe,EACR,UAAkB,EAClB,IAAY;QAEnB,KAAK,CAAC,OAAO,CAAC,CAAA;QAHP,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAQ;QAGnB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AASD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAA;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,2BAA2B,CAAA;IAE5E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,EAAE,CAAC;YACrD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;QAC/C,CAAC;QACD,MAAM,IAAI,kBAAkB,CAAC,iDAAiD,EAAE,GAAG,EAAE,YAAY,CAAC,CAAA;IACpG,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEpC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,4BAA4B,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,MAAM,EAAE;aACpC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,QAAQ;gBACjB,MAAM;gBACN,OAAO;aACR,CAAC;SACH,CAAC,CAAA;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,EAAE,GAAG,EAAE,YAAY,CAAC,CAAA;QAC/E,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAI,GAA4B,EAAE,CAAA;YACtC,IAAI,CAAC;gBAAC,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACxE,MAAM,OAAO,GAAG,IAAI,CAAC,KAA4C,CAAA;YACjE,MAAM,IAAI,kBAAkB,CACzB,OAAO,EAAE,OAAkB,IAAI,sBAAsB,EACtD,GAAG,EACH,sBAAsB,CACvB,CAAA;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE,GAAG,EAAE,qBAAqB,CAAC,CAAA;QACzF,CAAC;QAEC,MAAM,IAAI,GAA4B,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAA;QACtF,OAAO;YACL,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI;YAC/B,OAAO;YACP,MAAM;YACN,SAAS,EAAE,OAAO,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAC5E,CAAA;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,kBAAkB;YAAE,MAAM,GAAG,CAAA;QAChD,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE,GAAG,EAAE,qBAAqB,CAAC,CAAA;IACzF,CAAC;AACH,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/tradia/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,269 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { TradiaClient } from './client.js';
+import { checkRiskInternal } from './risk.js';
+import { proposeTrade, simulateBacktest, journalTrade, generatePublicUpdate, generateAccountabilityCard } from './engine.js';
+const VERSION = '0.1.0';
+function printHelp() {
+    console.log(`
+Tradia Agentic Trading OS v${VERSION}
+
+Usage: tradia <command> [options]
+
+Commands:
+  agent-plan          Generate an agent trading plan
+  market-analyze      Analyze market context
+  signal              Evaluate a trading signal
+  risk                Check risk parameters
+  propose             Generate a trade proposal
+  journal             Create a trade journal entry
+  performance         Analyze trading performance
+  report              Generate a portfolio report
+  public-update       Generate a public accountability update
+  backtest            Simulate backtest on historical trades
+  accountability      Generate an accountability card
+  export-markdown     Export data as markdown
+  export-json         Export data as JSON
+  whoami              Show current configuration
+  config              Show current configuration
+  --help, -h          Show this help message
+  --version, -v       Show version
+
+Global options:
+  --cloud             Use hosted Talocode Cloud API (requires TALOCODE_API_KEY)
+  --output <file>     Write output to file
+  --format <format>   Output format: json (default) or markdown
+
+Examples:
+  tradia propose --symbol XAUUSD --market forex --strategy liquidity_sweep --balance 500 --risk 0.5 --entry 2365.5 --stop 2372 --target 2350
+  tradia risk --balance 500 --risk 0.5 --entry 2365.5 --stop 2372 --target 2350
+  tradia journal --file trade.json
+  tradia backtest --file trades.json --balance 500 --risk 0.5
+
+⚠️  Not financial advice. Human review required before acting on any trade.
+`.trim());
+}
+function printVersion() {
+    console.log(`tradia v${VERSION}`);
+}
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const parsed = {};
+    for (let i = 0; i < args.length; i++) {
+        if (args[i].startsWith('--')) {
+            const key = args[i].slice(2);
+            if (i + 1 < args.length && !args[i + 1].startsWith('--')) {
+                parsed[key] = args[i + 1];
+                i++;
+            }
+            else {
+                parsed[key] = true;
+            }
+        }
+        else if (args[i].startsWith('-') && !args[i].startsWith('--')) {
+            const shortOpts = { h: 'help', v: 'version' };
+            const key = shortOpts[args[i].slice(1)];
+            if (key)
+                parsed[key] = true;
+        }
+    }
+    return parsed;
+}
+function readJsonFile(filePath) {
+    const resolved = resolve(filePath);
+    if (!existsSync(resolved)) {
+        console.error(`File not found: ${filePath}`);
+        process.exit(1);
+    }
+    const content = readFileSync(resolved, 'utf-8');
+    return JSON.parse(content);
+}
+function outputResult(result, options) {
+    const format = options.format || 'json';
+    const outFile = options.output;
+    let output;
+    if (format === 'markdown') {
+        const r = result;
+        output = r?.result?.markdown || JSON.stringify(result, null, 2);
+    }
+    else {
+        output = JSON.stringify(result, null, 2);
+    }
+    if (outFile) {
+        writeFileSync(resolve(outFile), output, 'utf-8');
+        console.log(`Output written to ${outFile}`);
+    }
+    else {
+        console.log(output);
+    }
+}
+async function main() {
+    const [command] = process.argv.slice(2).filter(a => !a.startsWith('-'));
+    const options = parseArgs();
+    if (options.help) {
+        printHelp();
+        return;
+    }
+    if (options.version) {
+        printVersion();
+        return;
+    }
+    if (!command || command === 'help') {
+        printHelp();
+        return;
+    }
+    const useCloud = !!options.cloud || false;
+    const apiKey = process.env.TALOCODE_API_KEY;
+    const baseUrl = process.env.TALOCODE_BASE_URL || 'https://api.talocode.site';
+    const client = new TradiaClient({ apiKey, baseUrl, useCloud: useCloud && !!apiKey });
+    switch (command) {
+        case 'whoami':
+        case 'config': {
+            console.log(JSON.stringify({
+                version: VERSION,
+                apiKeyConfigured: !!process.env.TALOCODE_API_KEY,
+                apiKeyRedacted: process.env.TALOCODE_API_KEY ? process.env.TALOCODE_API_KEY.slice(0, 4) + '****' : null,
+                baseUrl: baseUrl,
+                localUnauth: process.env.TRADIA_ALLOW_LOCAL_UNAUTH === 'true',
+                cloudMode: useCloud,
+            }, null, 2));
+            break;
+        }
+        case 'agent-plan': {
+            const result = await client.agent.plan({
+                symbol: options.symbol || undefined,
+                strategy: options.strategy,
+                timeframe: options.timeframe,
+                marketContext: options.context || undefined,
+                riskPercent: options.risk ? parseFloat(options.risk) : undefined,
+                accountBalance: options.balance ? parseFloat(options.balance) : undefined,
+                mode: options.mode || 'proposal',
+            });
+            outputResult(result, options);
+            break;
+        }
+        case 'market-analyze': {
+            const result = await client.market.analyze({
+                symbol: options.symbol || 'XAUUSD',
+                timeframe: options.timeframe || '1h',
+                context: options.context || '',
+            });
+            outputResult(result, options);
+            break;
+        }
+        case 'signal': {
+            const result = await client.signal.evaluate({
+                symbol: options.symbol || 'XAUUSD',
+                strategy: options.strategy || 'custom',
+                context: options.context || '',
+                timeframe: options.timeframe || '1h',
+            });
+            outputResult(result, options);
+            break;
+        }
+        case 'risk': {
+            const balance = parseFloat(options.balance);
+            const riskPercent = parseFloat(options.risk);
+            const entry = parseFloat(options.entry);
+            const stop = parseFloat(options.stop);
+            const target = parseFloat(options.target);
+            if (isNaN(balance) || isNaN(riskPercent) || isNaN(entry) || isNaN(stop) || isNaN(target)) {
+                console.error('Usage: tradia risk --balance 500 --risk 0.5 --entry 2365.5 --stop 2372 --target 2350');
+                process.exit(1);
+            }
+            const result = checkRiskInternal({ accountBalance: balance, riskPercent, entry, stopLoss: stop, takeProfit: target });
+            outputResult({ result }, options);
+            break;
+        }
+        case 'propose': {
+            const symbol = options.symbol;
+            const market = options.market;
+            const strategy = options.strategy;
+            const balance = parseFloat(options.balance);
+            const riskPercent = parseFloat(options.risk);
+            const entry = parseFloat(options.entry);
+            const stop = parseFloat(options.stop);
+            const target = parseFloat(options.target);
+            const timeframe = options.timeframe;
+            if (!symbol || !market || isNaN(balance) || isNaN(riskPercent) || isNaN(entry) || isNaN(stop) || isNaN(target)) {
+                console.error('Usage: tradia propose --symbol XAUUSD --market forex --strategy liquidity_sweep --balance 500 --risk 0.5 --entry 2365.5 --stop 2372 --target 2350');
+                process.exit(1);
+            }
+            const result = proposeTrade({
+                symbol, market: market,
+                strategy, accountBalance: balance, riskPercent, entry, stopLoss: stop, takeProfit: target,
+                timeframe, marketContext: options.context || undefined, setupNotes: options.notes || undefined,
+            });
+            outputResult(result, options);
+            break;
+        }
+        case 'journal': {
+            const data = readJsonFile(options.file);
+            const result = journalTrade(data);
+            outputResult(result, options);
+            break;
+        }
+        case 'performance': {
+            const data = readJsonFile(options.file);
+            const trades = (data.trades || data);
+            const balance = parseFloat(options.balance) || data.startingBalance || 0;
+            const result = await client.performance.analyze({ trades, startingBalance: balance });
+            outputResult(result, options);
+            break;
+        }
+        case 'report': {
+            const data = readJsonFile(options.file);
+            const trades = (data.trades || data);
+            const balance = parseFloat(options.balance) || data.accountBalance || 0;
+            const result = await client.portfolio.report({ trades, accountBalance: balance });
+            outputResult(result, options);
+            break;
+        }
+        case 'public-update': {
+            const data = readJsonFile(options.file);
+            const result = generatePublicUpdate(data);
+            outputResult(result, options);
+            break;
+        }
+        case 'backtest': {
+            const data = readJsonFile(options.file);
+            const trades = (data.trades || data);
+            const balance = parseFloat(options.balance) || data.startingBalance || 1000;
+            const riskPercent = parseFloat(options.risk) || data.riskPercent || 0.5;
+            const result = simulateBacktest({ strategy: (data.strategy || 'custom'), trades, startingBalance: balance, riskPercent });
+            outputResult(result, options);
+            break;
+        }
+        case 'accountability': {
+            const data = readJsonFile(options.file);
+            const result = generateAccountabilityCard(data);
+            outputResult(result, options);
+            break;
+        }
+        case 'export-markdown': {
+            const data = readJsonFile(options.file);
+            const { exportMarkdown: exportMd } = await import('./engine');
+            const result = exportMd(data);
+            outputResult(result, options);
+            break;
+        }
+        case 'export-json': {
+            const data = readJsonFile(options.file);
+            const { exportJson: exportJ } = await import('./engine');
+            const result = exportJ(data);
+            outputResult(result, options);
+            break;
+        }
+        default: {
+            console.error(`Unknown command: ${command}`);
+            console.error('Run "tradia --help" for usage.');
+            process.exit(1);
+        }
+    }
+}
+main().catch((err) => {
+    console.error('Error:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map