@trading-boy/cli 1.12.0 → 2.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2026 Cabal Ventures. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of Cabal Ventures. Unauthorized copying, modification,
+distribution, or use of this Software, in whole or in part, is strictly
+prohibited without the express written permission of Cabal Ventures.
+
+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.
+
+---
+
+This project uses the following open-source software:
+
+Hermes Agent Framework — MIT License
+Copyright (c) Hermes Contributors
+https://github.com/hermes-ai/hermes

package/README.md

@@ -1,6 +1,6 @@
 # @trading-boy/cli
 
-Crypto context intelligence for traders and AI agents. Real-time market data, on-chain analytics, DeFi risk scoring, and an adaptive learning engine — all from the command line.
+Remote trading intelligence for traders and AI agents. Real-time market data, on-chain analytics, DeFi risk scoring, and adaptive learning outcomes — all from the command line.
 
 **Website:** [cabal.ventures](https://cabal.ventures) | **Docs:** [cabal.ventures/docs](https://cabal.ventures/docs)
 
@@ -15,20 +15,23 @@ Requires Node.js 20+.
 ## Quick Start
 
 ```bash
-# 1. Subscribe (free tier available)
+# 1. Subscribe (Starter is free; paid plans open checkout)
 trading-boy subscribe --plan starter -e you@email.com
 
-# 2. Query a token
-trading-boy query SOL
+# 2. Onboarding stores your Trading Boy API key locally.
+# Power agents with ChatGPT or your own LLM provider API key:
+trading-boy connect-chatgpt
+# or
+trading-boy config set-llm-key <your-llm-provider-api-key>
 
-# 3. Get full context intelligence
-trading-boy context SOL
+# 3. Create your first agent
+trading-boy agent create --trader-id <id> --scan-interval-human 30m
 
-# 4. Register a trader profile
-trading-boy trader register --name MyTrader
+# 4. Query a token
+trading-boy context SOL
 
 # 5. Log a trade
-trading-boy journal entry SOL --direction LONG --price 148.50 --size 500
+trading-boy journal log entry SOL --direction LONG --price 148.50 --size 500
 ```
 
 ## What You Get
@@ -46,27 +49,60 @@ trading-boy journal entry SOL --direction LONG --price 148.50 --size 500
 ## Commands
 
 ```
-trading-boy context <token>       # Full 6-layer context package
-trading-boy query <token>         # Quick price + funding summary
-trading-boy watch <token>         # Live watch mode
-trading-boy catalysts             # Upcoming events
-trading-boy risk <protocol>       # DeFi risk assessment
-trading-boy narrative list        # Active market narratives
-
-trading-boy journal entry <token> # Log a trade entry
-trading-boy journal exit <token>  # Log a trade exit
-trading-boy decisions             # View decision history
-trading-boy edge <traderId>       # Edge profile analytics
-trading-boy behavioral            # Behavioral pattern analysis
-
-trading-boy subscribe             # Subscribe via Stripe
-trading-boy login                 # Store API key
-trading-boy trader register       # Create trader profile
-trading-boy billing manage        # Manage subscription
+Core
+  trading-boy context <token>       # Full 6-layer context package
+  trading-boy query <token>         # Quick price + funding summary
+  trading-boy watch <token>         # Live watch mode
+
+Data & Analysis
+  trading-boy catalysts             # Upcoming events
+  trading-boy risk <protocol>       # DeFi risk assessment
+  trading-boy narrative list        # Active market narratives
+  trading-boy events list           # Event management
+
+Trading Journal
+  trading-boy journal log entry <token>  # Log a trade entry
+  trading-boy journal log exit <token>   # Log a trade exit
+  trading-boy decisions             # View decision history
+  trading-boy stats                 # Aggregate trading statistics
+
+Edge & Safety
+  trading-boy edge <traderId>       # Edge profile analytics
+  trading-boy edge-guard check <id> # Negative edge detection
+  trading-boy behavioral            # Behavioral pattern analysis
+  trading-boy coaching pre-trade    # AI-powered trade coaching
+  trading-boy thesis <id>           # Thesis extraction (LLM)
+
+Strategy & Benchmarking
+  trading-boy strategy list         # Manage agent strategies
+  trading-boy replay                # Backtest strategies
+  trading-boy benchmark             # Performance leaderboard
+  trading-boy suggestions list      # Optimization suggestions
+
+Account
+  trading-boy subscribe             # Subscribe via Stripe
+  trading-boy login                 # Store your Trading Boy API key
+  trading-boy connect-chatgpt       # Connect ChatGPT after Trading Boy login
+  trading-boy whoami                # Check auth status + key expiration
+  trading-boy rotate-key            # Rotate your Trading Boy API key
+  trading-boy forgot-key            # Recover key via email
+  trading-boy billing manage        # Manage subscription
+
+System
+  trading-boy trader register       # Create trader profile
+  trading-boy config show           # View API + LLM configuration
+  trading-boy config set-llm-key    # Store your LLM provider API key
+  trading-boy cron list             # Manage scheduled jobs
+  trading-boy agent create          # Create a hosted trading agent
+  trading-boy agent list            # Manage agents
 ```
 
 Run `trading-boy --help` for the full command list.
 
+## Public Package Scope
+
+The published npm package is a public, remote-only CLI. End users can manage API/LLM settings and runtime model selection, but internal infrastructure management and server environment editing are intentionally not part of the npm release surface.
+
 ## Pricing
 
 | Plan | Price | Tokens | Trades/mo |
@@ -82,10 +118,9 @@ All plans include every feature. Limits apply to traded tokens and logged trades
 Trading Boy exposes an MCP server for AI agent integration and a REST API for programmatic access.
 
 ```bash
-# Start the MCP server (for Claude, GPT, etc.)
-trading-boy mcp
-
 # REST API is hosted at https://api.cabal.ventures
+# MCP server: npx @trading-boy/mcp-server
+# CLI onboarding and first-agent setup: see docs/getting-started.md
 ```
 
 ## License

package/dist/api-client.d.ts

@@ -10,7 +10,7 @@ export declare class ApiError extends Error {
 }
 /**
  * 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).
+ * In dev mode, auth is optional for a local API server.
  */
 export declare function isDevMode(): boolean;
 export declare function resolveApiKey(flagKey?: string): Promise<string>;
@@ -22,13 +22,10 @@ export declare function apiRequest<T>(path: string, options?: {
     headers?: Record<string, string>;
 }): Promise<T>;
 /**
- * Check if the CLI should use remote API mode.
+ * Check whether the CLI has enough configuration to use the API successfully.
  *
- * 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)
+ * The public CLI always talks to the Trading Boy API, either at the default hosted
+ * endpoint or at a user-specified TRADING_BOY_API_URL.
  */
 export declare function isRemoteMode(): Promise<boolean>;
 export { redactApiKey };

package/dist/api-client.js

@@ -1,4 +1,4 @@
-import { createLogger } from '@trading-boy/core';
+import { createLogger } from './logger.js';
 import { loadCredentials, redactApiKey } from './credentials.js';
 const logger = createLogger('cli-api-client');
 // ─── Constants ───
@@ -16,7 +16,7 @@ export class ApiError extends Error {
 // ─── 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).
+ * In dev mode, auth is optional for a local API server.
  */
 export function isDevMode() {
     if (process.env.NODE_ENV !== 'development')
@@ -84,6 +84,7 @@ export async function apiRequest(path, options = {}) {
         ...(apiKey ? { 'X-API-Key': apiKey } : {}),
         ...(options.body ? { 'Content-Type': 'application/json' } : {}),
         ...options.headers,
+        'X-TB-Channel': 'cli',
     };
     const fetchOptions = {
         method: options.method ?? 'GET',
@@ -145,21 +146,15 @@ export async function apiRequest(path, options = {}) {
     }
     return (await response.json());
 }
-// ─── Remote Mode Detection ───
+// ─── API Access Detection ───
 /**
- * Check if the CLI should use remote API mode.
+ * Check whether the CLI has enough configuration to use the API successfully.
  *
- * 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)
+ * The public CLI always talks to the Trading Boy API, either at the default hosted
+ * endpoint or at a user-specified TRADING_BOY_API_URL.
  */
 export async function isRemoteMode() {
-    // Explicit env var override
-    if (process.env.TRADING_BOY_LOCAL === 'true')
-        return false;
-    // Tests always run in local mode
+    // Tests often stub auth and do not need stored credentials.
     if (process.env.NODE_ENV === 'test')
         return false;
     // If API URL is explicitly set, use remote mode