@bloomai/cli 0.1.0 → 0.1.1

package/src/commands/options.ts

@@ -1,35 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions, parseIntSafe } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-export function registerOptionsCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("options-history")
-      .description("Options sentiment evolution over time")
-      .argument("<symbol>", "Ticker symbol")
-      .option("--days <n>", "Lookback days (7-90)", "30")
-      .option("--weekly", "Use weekly sampling (default)")
-      .option("--daily", "Use daily data")
-      .option("--greeks", "Include advanced Greeks analysis")
-  ).action(
-    async (
-      symbol: string,
-      opts: OutputOptions & {
-        days: string;
-        weekly?: boolean;
-        daily?: boolean;
-        greeks?: boolean;
-      }
-    ) => {
-      const data = await callTool("analyze_options_history", {
-        symbol: symbol.toUpperCase(),
-        lookback_days: parseIntSafe(opts.days, 30),
-        weekly_sampling: opts.weekly ?? !opts.daily,
-        include_greeks_analysis: !!opts.greeks,
-      });
-      outputResult(data, opts);
-    }
-  );
-}

package/src/commands/portfolio.ts

@@ -1,28 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-export function registerPortfolioCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("portfolio")
-      .description("Portfolio risk-return analysis")
-      .argument("<holdings>", 'JSON holdings, e.g. \'{"AAPL":0.3,"MSFT":0.7}\'')
-      .option("--strategy <s>", "Investment strategy context")
-  ).action(async (holdingsStr: string, opts: OutputOptions & { strategy?: string }) => {
-    let holdings: Record<string, number>;
-    try {
-      holdings = JSON.parse(holdingsStr);
-    } catch {
-      console.error('Error: Invalid JSON for holdings. Use format: \'{"AAPL":0.3,"MSFT":0.7}\'');
-      process.exit(1);
-    }
-
-    const args: Record<string, unknown> = { holdings };
-    if (opts.strategy) args.strategy = opts.strategy;
-
-    const data = await callTool("analyze_portfolio", args);
-    outputResult(data, opts);
-  });
-}

package/src/commands/position.ts

@@ -1,44 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions, parseIntSafe } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-export function registerPositionCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("position-size")
-      .description("Kelly criterion position sizing")
-      .requiredOption("--bull <n>", "Expected bull return (decimal, e.g. 0.6)")
-      .requiredOption("--bear <n>", "Expected bear return (decimal, e.g. -0.15)")
-      .requiredOption("--conviction <n>", "Conviction level 1-10")
-      .requiredOption("--value <n>", "Portfolio value in dollars")
-      .option("--symbol <s>", "Optional symbol for valuation context")
-  ).action(
-    async (
-      opts: OutputOptions & {
-        bull: string;
-        bear: string;
-        conviction: string;
-        value: string;
-        symbol?: string;
-      }
-    ) => {
-      const bullReturn = parseFloat(opts.bull);
-      const bearReturn = parseFloat(opts.bear);
-      const portfolioValue = parseFloat(opts.value);
-      if (isNaN(bullReturn)) { console.error("Error: --bull must be a decimal number (e.g. 0.6)"); process.exit(1); }
-      if (isNaN(bearReturn)) { console.error("Error: --bear must be a decimal number (e.g. -0.15)"); process.exit(1); }
-      if (isNaN(portfolioValue)) { console.error("Error: --value must be a number"); process.exit(1); }
-      const args: Record<string, unknown> = {
-        bull_return: bullReturn,
-        bear_return: bearReturn,
-        conviction: parseIntSafe(opts.conviction, 5),
-        portfolio_value: portfolioValue,
-      };
-      if (opts.symbol) args.symbol = opts.symbol.toUpperCase();
-
-      const data = await callTool("calculate_position_size", args);
-      outputResult(data, opts);
-    }
-  );
-}

package/src/commands/price.ts

@@ -1,76 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions, makeTable } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-export function registerPriceCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("price")
-      .description("Historical price data")
-      .argument("<symbol>", "Ticker symbol")
-      .option("--timeframes <tf>", "Comma-separated: 1d,1w,1m,3m,6m,ytd,1y,2y,5y", "1d,1m,1y")
-      .option("--ohlc", "Include full OHLC data")
-  ).action(async (symbol: string, opts: OutputOptions & { timeframes: string; ohlc?: boolean }) => {
-    const data = await callTool("get_price_charts", {
-      symbol: symbol.toUpperCase(),
-      timeframes: opts.timeframes.split(",").map((t) => t.trim()),
-      include_ohlc: !!opts.ohlc,
-    });
-    outputResult(data, opts, (d, o) => formatPrices(d, o));
-  });
-}
-
-function formatPrices(data: unknown, opts: OutputOptions): string {
-  if (!data || typeof data !== "object") return String(data);
-  const obj = data as Record<string, unknown>;
-  const sections: string[] = [];
-
-  for (const [tf, val] of Object.entries(obj)) {
-    if (tf === "symbol" || tf === "timestamp" || tf === "source" || tf === "type") continue;
-    if (!val || typeof val !== "object") continue;
-
-    const tfData = val as Record<string, unknown>;
-    let points: Record<string, unknown>[] = [];
-
-    if (Array.isArray(tfData)) {
-      points = tfData as Record<string, unknown>[];
-    } else if (tfData.data && Array.isArray(tfData.data)) {
-      points = tfData.data as Record<string, unknown>[];
-    } else if (tfData.prices && Array.isArray(tfData.prices)) {
-      points = tfData.prices as Record<string, unknown>[];
-    } else {
-      // Fallback: find the first array of objects (skip primitive arrays)
-      for (const v of Object.values(tfData)) {
-        if (Array.isArray(v) && v.length > 0 && typeof v[0] === "object" && v[0] !== null) {
-          points = v as Record<string, unknown>[];
-          break;
-        }
-      }
-    }
-
-    if (points.length === 0) continue;
-
-    sections.push(`\n--- ${tf.toUpperCase()} (${points.length} points) ---`);
-
-    const show = points.length <= 12 ? points : [
-      ...points.slice(0, 5),
-      { date: "...", price: "..." } as Record<string, unknown>,
-      ...points.slice(-5),
-    ];
-
-    const rows = show.map((p) => [
-      String(p.date ?? p.datetime ?? p.timestamp ?? ""),
-      String(p.price ?? p.close ?? ""),
-      p.open != null ? String(p.open) : "",
-      p.high != null ? String(p.high) : "",
-      p.low != null ? String(p.low) : "",
-      p.volume != null ? String(p.volume) : "",
-    ]);
-
-    const headers = ["Date", "Price", "Open", "High", "Low", "Volume"];
-    sections.push(makeTable(headers, rows, opts));
-  }
-
-  return sections.join("\n") || JSON.stringify(data, null, 2);
-}

package/src/commands/screen.ts

@@ -1,77 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions, makeTable, parseIntSafe } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-export function registerScreenCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("screen")
-      .description("Quantitative stock screener")
-      .argument("<filters...>", 'Filter expressions, e.g. "market_cap > 10B" "pe_ratio < 25"')
-      .option("--or", "Use OR logic (default: AND)")
-      .option("--limit <n>", "Max results", "50")
-      .option("--symbols <s>", "Comma-separated symbols to filter from")
-      .option("--fields <f>", "Comma-separated fields (use * for all)")
-  ).action(
-    async (
-      filters: string[],
-      opts: OutputOptions & {
-        or?: boolean;
-        limit: string;
-        symbols?: string;
-        fields?: string;
-      }
-    ) => {
-      const args: Record<string, unknown> = {
-        filter_expressions: filters,
-        and_query: !opts.or,
-        limit: parseIntSafe(opts.limit, 50),
-      };
-      if (opts.symbols) {
-        args.symbols = opts.symbols.split(",").map((s) => s.trim().toUpperCase());
-      }
-      if (opts.fields) {
-        args.fields = opts.fields.split(",").map((f) => f.trim());
-      }
-      const data = await callTool("filter_stocks", args);
-      outputResult(data, opts, (d, o) => formatScreen(d, o));
-    }
-  );
-}
-
-function formatScreen(data: unknown, opts: OutputOptions): string {
-  if (!data || typeof data !== "object") return String(data);
-  const obj = data as Record<string, unknown>;
-
-  let stocks: Record<string, unknown>[] = [];
-  if (Array.isArray(data)) {
-    stocks = data as Record<string, unknown>[];
-  } else {
-    for (const val of Object.values(obj)) {
-      if (Array.isArray(val) && val.length > 0) {
-        stocks = val as Record<string, unknown>[];
-        break;
-      }
-    }
-  }
-
-  if (stocks.length === 0) return "(no matches)";
-
-  const headers = Object.keys(stocks[0]).filter(
-    (k) => !k.startsWith("_") && k !== "id"
-  );
-  const rows = stocks.map((s) =>
-    headers.map((h) => {
-      const v = s[h];
-      if (typeof v === "number") {
-        if (Math.abs(v) >= 1e9) return `${(v / 1e9).toFixed(1)}B`;
-        if (Math.abs(v) >= 1e6) return `${(v / 1e6).toFixed(1)}M`;
-        return v.toFixed(2);
-      }
-      return String(v ?? "");
-    })
-  );
-
-  return makeTable(headers, rows, opts);
-}

package/src/commands/sentiment.ts

@@ -1,51 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-const SECTIONS = [
-  "aaii_sentiment",
-  "cnn_fear_greed",
-  "volatility_analysis",
-  "momentum_analysis",
-];
-
-export function registerSentimentCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("sentiment")
-      .description("Market mood: AAII, Fear&Greed, VIX, momentum")
-      .option("--sections <s>", "Comma-separated: " + SECTIONS.join(","))
-  ).action(async (opts: OutputOptions & { sections?: string }) => {
-    const args: Record<string, unknown> = {};
-    if (opts.sections) {
-      args.sections = opts.sections.split(",").map((s) => s.trim());
-    }
-    const data = await callTool("get_market_sentiment", args);
-    outputResult(data, opts, (d) => formatSentiment(d));
-  });
-}
-
-function formatSentiment(data: unknown): string {
-  if (!data || typeof data !== "object") return String(data);
-  const obj = data as Record<string, unknown>;
-  const lines: string[] = [];
-
-  for (const [section, val] of Object.entries(obj)) {
-    if (section === "timestamp" || section === "source") continue;
-    if (!val || typeof val !== "object") continue;
-    lines.push(`\n=== ${section.replace(/_/g, " ").toUpperCase()} ===`);
-    for (const [k, v] of Object.entries(val as Record<string, unknown>)) {
-      if (v && typeof v === "object" && !Array.isArray(v)) {
-        lines.push(`  ${k}:`);
-        for (const [ik, iv] of Object.entries(v as Record<string, unknown>)) {
-          lines.push(`    ${ik}: ${iv}`);
-        }
-      } else {
-        lines.push(`  ${k}: ${v}`);
-      }
-    }
-  }
-
-  return lines.join("\n") || JSON.stringify(data, null, 2);
-}

package/src/commands/technicals.ts

@@ -1,25 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-const SECTIONS = ["technical_indicators", "options_analysis", "insider_activity"];
-
-export function registerTechnicalsCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("technicals")
-      .description("RSI, MAs, patterns, options flow, insider trades")
-      .argument("<symbols...>", "Ticker symbols (up to 5)")
-      .option("--sections <s>", "Comma-separated: " + SECTIONS.join(","))
-  ).action(async (symbols: string[], opts: OutputOptions & { sections?: string }) => {
-    const args: Record<string, unknown> = {
-      symbols: symbols.map((s) => s.toUpperCase()).slice(0, 5),
-    };
-    if (opts.sections) {
-      args.sections = opts.sections.split(",").map((s) => s.trim());
-    }
-    const data = await callTool("analyze_technicals", args);
-    outputResult(data, opts);
-  });
-}

package/src/commands/trades.ts

@@ -1,41 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-export function registerTradesCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("trades")
-      .description("AI trade evaluation")
-      .argument("<trades...>", 'Trade descriptions: "Buy AAPL 30% because..." "Sell MSFT 20% because..."')
-  ).action(async (tradeStrs: string[], opts: OutputOptions) => {
-    const trades = tradeStrs.map(parseTrade);
-    const data = await callTool("analyze_trades", { trades });
-    outputResult(data, opts);
-  });
-}
-
-function parseTrade(str: string): Record<string, unknown> {
-  const match = str.match(
-    /^(buy|sell|hold)\s+([A-Z]+)\s+(\d+)%?\s+(?:because\s+)?(.+)$/i
-  );
-  if (match) {
-    return {
-      action: match[1].toLowerCase(),
-      symbol: match[2].toUpperCase(),
-      portfolio_weight: parseInt(match[3], 10) / 100,
-      thesis: match[4],
-    };
-  }
-
-  try {
-    return JSON.parse(str);
-  } catch {
-    console.error(
-      `Error: Could not parse trade "${str}"\n` +
-        'Format: "Buy AAPL 30% because thesis" or JSON object'
-    );
-    process.exit(1);
-  }
-}

package/src/commands/transcript.ts

@@ -1,69 +0,0 @@
-import { Command } from "commander";
-import { callTool } from "../api.js";
-import { outputResult, OutputOptions, makeTable, parseIntSafe } from "../format.js";
-import { addGlobalOptions } from "../global-opts.js";
-
-export function registerTranscriptCommand(program: Command): void {
-  addGlobalOptions(
-    program
-      .command("transcript")
-      .description("Search earnings call transcripts")
-      .argument("<symbol>", "Ticker symbol")
-      .argument("<keywords...>", "Keywords to search (OR logic)")
-      .option("--quarter <q>", 'Fiscal quarter, e.g. "Q1 2024"')
-      .option("--max <n>", "Max results", "10")
-  ).action(
-    async (
-      symbol: string,
-      keywords: string[],
-      opts: OutputOptions & { quarter?: string; max: string }
-    ) => {
-      const args: Record<string, unknown> = {
-        symbol: symbol.toUpperCase(),
-        keywords,
-        max_results: parseIntSafe(opts.max, 10),
-      };
-      if (opts.quarter) args.fiscal_quarter = opts.quarter;
-
-      const data = await callTool("search_transcript", args);
-      outputResult(data, opts, (d, o) => formatTranscript(d, o));
-    }
-  );
-}
-
-function formatTranscript(data: unknown, opts: OutputOptions): string {
-  if (!data || typeof data !== "object") return String(data);
-  const obj = data as Record<string, unknown>;
-
-  let matches: Record<string, unknown>[] = [];
-  if (Array.isArray(data)) {
-    matches = data as Record<string, unknown>[];
-  } else {
-    for (const val of Object.values(obj)) {
-      if (Array.isArray(val) && val.length > 0) {
-        matches = val as Record<string, unknown>[];
-        break;
-      }
-      // Check one level deeper (e.g. transcript_search_results.matches)
-      if (val && typeof val === "object" && !Array.isArray(val)) {
-        for (const nested of Object.values(val as Record<string, unknown>)) {
-          if (Array.isArray(nested) && nested.length > 0) {
-            matches = nested as Record<string, unknown>[];
-            break;
-          }
-        }
-      }
-      if (matches.length > 0) break;
-    }
-  }
-
-  if (matches.length === 0) return "(no matches)";
-
-  const rows = matches.map((m) => [
-    String(m.speaker || m.name || ""),
-    String(m.role || m.title || ""),
-    String(m.content_with_highlights || m.text || m.content || m.exact_quote || m.quote || "").slice(0, 120),
-  ]);
-
-  return makeTable(["Speaker", "Role", "Text"], rows, opts);
-}

package/src/format.ts

@@ -1,179 +0,0 @@
-import Table from "cli-table3";
-import { writeFileSync, mkdirSync } from "node:fs";
-import { dirname } from "node:path";
-
-export interface OutputOptions {
-  format?: "json" | "csv" | "table";
-  output?: string;
-  quiet?: boolean;
-  raw?: boolean;
-}
-
-export function resolveFormat(opts: OutputOptions): "json" | "csv" | "table" {
-  if (opts.format) return opts.format;
-  if (opts.output || !process.stdout.isTTY) return "json";
-  return "table";
-}
-
-export function outputResult(
-  data: unknown,
-  opts: OutputOptions,
-  tableFormatter?: (data: unknown, opts: OutputOptions) => string
-): void {
-  if (opts.raw) {
-    emit(JSON.stringify(data, null, 2), opts);
-    return;
-  }
-
-  const fmt = resolveFormat(opts);
-
-  if (fmt === "json") {
-    emit(JSON.stringify(data, null, 2), opts);
-    return;
-  }
-
-  if (fmt === "csv") {
-    emit(toCSV(data), opts);
-    return;
-  }
-
-  // table format
-  if (tableFormatter) {
-    emit(tableFormatter(data, opts), opts);
-  } else {
-    emit(autoTable(data, opts), opts);
-  }
-}
-
-function emit(content: string, opts: OutputOptions): void {
-  if (opts.output) {
-    mkdirSync(dirname(opts.output), { recursive: true });
-    writeFileSync(opts.output, content + "\n");
-    if (!opts.quiet) {
-      console.error(`Written to ${opts.output}`);
-    }
-  } else {
-    console.log(content);
-  }
-}
-
-function toCSV(data: unknown): string {
-  const rows = toRows(data);
-  if (rows.length === 0) return "";
-  const headers = Object.keys(rows[0]);
-  const lines = [headers.join(",")];
-  for (const row of rows) {
-    lines.push(
-      headers
-        .map((h) => {
-          const val = String(row[h] ?? "");
-          return val.includes(",") || val.includes('"') || val.includes("\n")
-            ? `"${val.replace(/"/g, '""')}"`
-            : val;
-        })
-        .join(",")
-    );
-  }
-  return lines.join("\n");
-}
-
-function toRows(data: unknown): Record<string, unknown>[] {
-  const flatten = (v: unknown) => flattenObj(v);
-  if (Array.isArray(data)) return data.map(flatten);
-  if (data && typeof data === "object") {
-    const obj = data as Record<string, unknown>;
-    // Prefer arrays of objects over arrays of primitives
-    for (const key of Object.keys(obj)) {
-      const val = obj[key];
-      if (
-        Array.isArray(val) &&
-        val.length > 0 &&
-        typeof val[0] === "object" &&
-        val[0] !== null
-      ) {
-        return val.map(flatten);
-      }
-    }
-    // Fallback: any non-empty array
-    for (const key of Object.keys(obj)) {
-      if (Array.isArray(obj[key]) && (obj[key] as unknown[]).length > 0) {
-        return (obj[key] as unknown[]).map(flatten);
-      }
-    }
-    return [flattenObj(obj)];
-  }
-  return [{ value: data }];
-}
-
-function flattenObj(
-  obj: unknown,
-  prefix = ""
-): Record<string, unknown> {
-  if (!obj || typeof obj !== "object") return { value: obj };
-  const result: Record<string, unknown> = {};
-  for (const [k, v] of Object.entries(obj as Record<string, unknown>)) {
-    const key = prefix ? `${prefix}.${k}` : k;
-    if (v && typeof v === "object" && !Array.isArray(v)) {
-      Object.assign(result, flattenObj(v, key));
-    } else if (Array.isArray(v)) {
-      if (v.length <= 3) {
-        result[key] = v
-          .map((item) =>
-            item && typeof item === "object" ? JSON.stringify(item) : String(item)
-          )
-          .join(", ");
-      } else {
-        result[key] = `[${v.length} items]`;
-      }
-    } else {
-      result[key] = v;
-    }
-  }
-  return result;
-}
-
-export function autoTable(data: unknown, opts?: OutputOptions): string {
-  const rows = toRows(data);
-  if (rows.length === 0) return "(no data)";
-
-  const headers = Object.keys(rows[0]);
-  const table = new Table({
-    head: opts?.quiet ? [] : headers,
-    style: { head: ["cyan"] },
-    wordWrap: true,
-  });
-
-  for (const row of rows) {
-    table.push(headers.map((h) => truncate(String(row[h] ?? ""), 80)));
-  }
-
-  return table.toString();
-}
-
-export function makeTable(
-  headers: string[],
-  rows: string[][],
-  opts?: { quiet?: boolean }
-): string {
-  const table = new Table({
-    head: opts?.quiet ? [] : headers,
-    style: { head: ["cyan"] },
-    wordWrap: true,
-  });
-  for (const row of rows) {
-    table.push(row);
-  }
-  return table.toString();
-}
-
-function truncate(s: string, max: number): string {
-  return s.length > max ? s.slice(0, max - 1) + "…" : s;
-}
-
-/**
- * Parse a string as an integer, returning `fallback` if the result is NaN.
- */
-export function parseIntSafe(value: string, fallback: number): number {
-  const n = parseInt(value, 10);
-  return Number.isNaN(n) ? fallback : n;
-}

package/src/global-opts.ts

@@ -1,9 +0,0 @@
-import { Command } from "commander";
-
-export function addGlobalOptions(cmd: Command): Command {
-  return cmd
-    .option("-o, --output <file>", "Write output to file")
-    .option("-f, --format <fmt>", "Output format: json, csv, table")
-    .option("-q, --quiet", "Suppress headers, data only")
-    .option("--raw", "Raw JSON from API");
-}