@nalinsahani/wealtharena-cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @nalinsahani/wealtharena-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Wealth Arena CLI (`wa`) — unified terminal interface for quantitative trading, options analysis, and automated AI agents (`claude code`, `opencode`, `gemini cli`).
+
+## Quick Start
+
+### Zero-Install via Bun (Blazing Fast ~15ms)
+```bash
+bunx @nalinsahani/wealtharena-cli --json market quote --symbol NSE:NIFTY50-INDEX
+```
+
+### Zero-Install via Node / NPX
+```bash
+npx -y @nalinsahani/wealtharena-cli --json market quote --symbol NSE:NIFTY50-INDEX
+```
+
+### Global Install
+```bash
+npm install -g @nalinsahani/wealtharena-cli
+wa --json me
+```
+
+## Features
+- **Deterministic JSON output**: Pass `--json` anywhere for machine-readable JSON envelopes.
+- **Fail-closed live gate**: Paper trading is free; live trading refuses without `--live --yes` and margin verification.
+- **AI Agent Native**: Automatic `X-AI-Actor` and `X-AI-Session` tracking with database audit logs.

package/bin/mcp.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+/**
+ * Wealth Arena Model Context Protocol (MCP) Server
+ * Lightweight, zero-external-dependency JSON-RPC stdio server compatible with Node.js and Bun.
+ * Exposes Wealth Arena tools directly to Claude Code, Gemini CLI, Cursor, and OpenCode.
+ */
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+const readline = require('readline');
+
+// Locate the companion wa launcher
+const waLauncher = path.join(__dirname, 'wa.js');
+
+function callWa(args) {
+  const fullArgs = [waLauncher, '--json', ...args];
+  const proc = spawnSync(process.execPath, fullArgs, {
+    encoding: 'utf8',
+    env: { ...process.env, WA_AI: '1', WA_ACTOR: 'mcp-server' },
+  });
+  return {
+    status: proc.status,
+    stdout: proc.stdout || '',
+    stderr: proc.stderr || '',
+  };
+}
+
+const TOOLS = [
+  {
+    name: 'wa_market_quote',
+    description: 'Fetch real-time market quote (LTP, change, volume, prev close) for a broker symbol.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: { type: 'string', description: 'Broker symbol (e.g. "NSE:NIFTY50-INDEX", "NSE:SBIN-EQ")' },
+      },
+      required: ['symbol'],
+    },
+  },
+  {
+    name: 'wa_chain_snapshot',
+    description: 'Fetch option chain snapshot for an underlying asset with Greeks, strikes, and filters.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: { type: 'string', description: 'Underlying symbol (e.g. "NIFTY", "BANKNIFTY")' },
+        strikes: { type: 'string', description: 'Strike count on each side of ATM (default "10")' },
+        expiry: { type: 'string', description: 'Expiry date or "all" (empty = nearest)' },
+      },
+      required: ['symbol'],
+    },
+  },
+  {
+    name: 'wa_broker_status',
+    description: 'Check broker connectivity status (fyers, zerodha, indmoney, or all).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        broker: { type: 'string', description: 'Broker name: "fyers" | "zerodha" | "indmoney" | "all"' },
+      },
+    },
+  },
+  {
+    name: 'wa_paper_margin',
+    description: 'Check paper trading simulation margin and buying power.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+  {
+    name: 'wa_halt_status',
+    description: 'Check whether the emergency trading halt circuit breaker is active.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+  {
+    name: 'wa_live_margin',
+    description: 'Check live broker collateral and available trading margin.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+];
+
+function handleToolCall(name, params) {
+  let cliArgs = [];
+  switch (name) {
+    case 'wa_market_quote':
+      cliArgs = ['market', 'quote', '--symbol', params.symbol];
+      break;
+    case 'wa_chain_snapshot':
+      cliArgs = ['chain', 'snapshot', '--symbol', params.symbol];
+      if (params.strikes) cliArgs.push('--strikes', params.strikes);
+      if (params.expiry) cliArgs.push('--expiry', params.expiry);
+      break;
+    case 'wa_broker_status':
+      cliArgs = ['broker', 'status'];
+      if (params.broker) cliArgs.push('--broker', params.broker);
+      break;
+    case 'wa_paper_margin':
+      cliArgs = ['paper', 'margin'];
+      break;
+    case 'wa_halt_status':
+      cliArgs = ['halt', 'status'];
+      break;
+    case 'wa_live_margin':
+      cliArgs = ['live', 'margin'];
+      break;
+    default:
+      return { isError: true, content: [{ type: 'text', text: `Unknown tool: ${name}` }] };
+  }
+
+  const res = callWa(cliArgs);
+  const textOutput = res.stdout.trim() || res.stderr.trim();
+  return {
+    isError: res.status !== 0,
+    content: [{ type: 'text', text: textOutput }],
+  };
+}
+
+// JSON-RPC stdio protocol loop
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  terminal: false,
+});
+
+function sendResponse(id, result, error) {
+  const resp = { jsonrpc: '2.0', id };
+  if (error) {
+    resp.error = error;
+  } else {
+    resp.result = result;
+  }
+  process.stdout.write(JSON.stringify(resp) + '\n');
+}
+
+rl.on('line', (line) => {
+  if (!line.trim()) return;
+  let req;
+  try {
+    req = JSON.parse(line);
+  } catch (err) {
+    sendResponse(null, null, { code: -32700, message: 'Parse error' });
+    return;
+  }
+
+  const { id, method, params } = req;
+
+  switch (method) {
+    case 'initialize':
+      sendResponse(id, {
+        protocolVersion: '2024-11-05',
+        capabilities: { tools: {} },
+        serverInfo: { name: 'wealtharena-mcp', version: '0.1.0' },
+      });
+      break;
+
+    case 'notifications/initialized':
+      // Notification, no response needed
+      break;
+
+    case 'ping':
+      sendResponse(id, {});
+      break;
+
+    case 'tools/list':
+      sendResponse(id, { tools: TOOLS });
+      break;
+
+    case 'tools/call':
+      if (!params || !params.name) {
+        sendResponse(id, null, { code: -32602, message: 'Invalid params: tool name required' });
+        return;
+      }
+      const toolRes = handleToolCall(params.name, params.arguments || {});
+      sendResponse(id, toolRes);
+      break;
+
+    default:
+      if (id !== undefined && id !== null) {
+        sendResponse(id, null, { code: -32601, message: `Method not found: ${method}` });
+      }
+      break;
+  }
+});

package/bin/wa.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+/**
+ * Wealth Arena CLI Launcher
+ * Cross-runtime launcher supporting Node.js (npx) and Bun (bunx).
+ * Spawns the pre-compiled native Go binary for the host platform with zero compilation overhead.
+ */
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+const platform = os.platform(); // 'linux', 'darwin', 'win32'
+const arch = os.arch();         // 'x64', 'arm64'
+
+const binaryName = platform === 'win32' ? 'wa.exe' : 'wa';
+const targetName = `wa-${platform}-${arch}` + (platform === 'win32' ? '.exe' : '');
+const pkgName = `@nalinsahani/wealtharena-cli-${platform}-${arch}`;
+
+let binaryPath = null;
+
+// 1. Try resolving from platform-specific optionalDependency
+try {
+  binaryPath = require.resolve(`${pkgName}/bin/${binaryName}`);
+} catch {
+  // Not installed as a platform dependency package, check local paths
+}
+
+// 2. Check local dist/bin directory (development / local builds)
+if (!binaryPath || !fs.existsSync(binaryPath)) {
+  const localDist = path.join(__dirname, '..', '..', 'dist', 'bin', targetName);
+  if (fs.existsSync(localDist)) {
+    binaryPath = localDist;
+  }
+}
+
+// 3. Check adjacent root binary (fallback)
+if (!binaryPath || !fs.existsSync(binaryPath)) {
+  const rootBin = path.join(__dirname, '..', '..', binaryName);
+  if (fs.existsSync(rootBin)) {
+    binaryPath = rootBin;
+  }
+}
+
+if (!binaryPath || !fs.existsSync(binaryPath)) {
+  console.error(`[wa] Error: Native binary not found for platform ${platform}-${arch}.`);
+  console.error(`[wa] Expected platform package: ${pkgName} or local binary at dist/bin/${targetName}`);
+  process.exit(1);
+}
+
+// 4. Ensure binary is executable (on unix systems)
+if (platform !== 'win32') {
+  try {
+    fs.chmodSync(binaryPath, 0o755);
+  } catch {
+    // best-effort
+  }
+}
+
+// 5. Transparently spawn the Go binary, forwarding args, stdio, and exit code
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+process.exit(result.status ?? (result.signal ? 1 : 0));

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@nalinsahani/wealtharena-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Wealth Arena trading & market CLI for traders and AI agents",
+  "bin": {
+    "wa": "./bin/wa.js",
+    "wa-mcp": "./bin/mcp.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "@nalinsahani/wealtharena-cli-darwin-arm64": "0.1.0",
+    "@nalinsahani/wealtharena-cli-darwin-x64": "0.1.0",
+    "@nalinsahani/wealtharena-cli-linux-arm64": "0.1.0",
+    "@nalinsahani/wealtharena-cli-linux-x64": "0.1.0",
+    "@nalinsahani/wealtharena-cli-win32-x64": "0.1.0"
+  },
+  "keywords": [
+    "trading",
+    "cli",
+    "fyers",
+    "zerodha",
+    "market-data",
+    "options",
+    "ai-agent",
+    "opencode",
+    "claude-code"
+  ],
+  "author": "Nalin Sahani",
+  "license": "UNLICENSED"
+}