@bloomai/cli 0.1.8 → 0.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -17,6 +17,7 @@ export BLOOM_API_KEY=<your-key>
17
17
 
18
18
  ```bash
19
19
  # 1. Find what you need
20
+ bloom feed --limit 5 # Bloom's curated stories worth researching
20
21
  bloom info AAPL # fundamentals, ratings, peers
21
22
  bloom info AAPL --fields basic_metadata,bottom_line_ratings # specific sections only
22
23
 
@@ -37,6 +38,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
37
38
  ### Core Research
38
39
  | Command | What it does | Example |
39
40
  |---------|-------------|---------|
41
+ | `feed` | Bloom's shared discovery feed, in ranked order | `bloom feed --limit 5 --format json` |
40
42
  | `info` (alias: `quote`) | Company fundamentals, ratings, peers, current price | `bloom info AAPL MSFT` |
41
43
  | `news` | Recent news headlines | `bloom news AAPL --limit 5` |
42
44
  | `price` | Historical price data | `bloom price AAPL --timeframes 1d,1m,1y` |
@@ -49,6 +51,11 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
49
51
  | `transcript` | Search earnings call transcripts | `bloom transcript AAPL "AI" "services"` |
50
52
  | `compare` | Side-by-side stock comparison | `bloom compare AAPL MSFT GOOG` |
51
53
 
54
+ `bloom feed` reads the latest eligible prepared stories each time. It defaults
55
+ to 10 stories (range: 1–50). The JSON output includes the headline, available
56
+ summary, tickers, timestamps, and a link to the Bloom story for each item.
57
+ Results are shared across users and available with a Bloom MCP API key.
58
+
52
59
  ### Valuation & Risk
53
60
  | Command | What it does | Example |
54
61
  |---------|-------------|---------|
@@ -132,7 +139,7 @@ done
132
139
  ### Screen → Deep Dive
133
140
  ```bash
134
141
  # Find cheap large-caps
135
- bloom screen "market_cap > 50B" "pe_ratio < 20" "dividend_yield > 2" -o /tmp/bloom/screened.json
142
+ bloom screen "market_cap > 50B" "pe_ratio < 20" "dividend_yield > 2%" -o /tmp/bloom/screened.json
136
143
 
137
144
  # Get the tickers
138
145
  tickers=$(jq -r '.results[].symbol' /tmp/bloom/screened.json | head -5 | tr '\n' ' ')
package/SKILL.md CHANGED
@@ -13,6 +13,7 @@ export BLOOM_API_KEY=<your-key>
13
13
 
14
14
  ```bash
15
15
  # 1. Find what you need
16
+ bloom feed --limit 5 --format json # shortlist of developments selected by Bloom
16
17
  bloom info AAPL # fundamentals, ratings, peers (`bloom quote` is an alias)
17
18
  bloom info AAPL --fields basic_metadata,bottom_line_ratings # specific sections only
18
19
 
@@ -32,6 +33,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
32
33
 
33
34
  | Command | What it does | Example |
34
35
  |---------|-------------|---------|
36
+ | `feed` | Curated stories in Bloom's shared discovery order | `bloom feed --limit 5 --format json` |
35
37
  | `info` | Company fundamentals, ratings, peers | `bloom info AAPL MSFT` |
36
38
  | `news` | Recent news headlines | `bloom news AAPL --limit 5` |
37
39
  | `price` | Historical price data | `bloom price AAPL --timeframes 1d,1m,1y` |
@@ -55,6 +57,13 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
55
57
  | `search` | Web search via Serper (Google) | `bloom search "nvidia earnings Q1 2026"` |
56
58
  | `scrape` | Scrape a web page via Firecrawl | `bloom scrape https://example.com` |
57
59
 
60
+ For “what should I pay attention to?”, start with `bloom feed` or call the Bloom
61
+ MCP tool `get_feed` with `{"limit": 5}`. Both default to 10 stories and allow
62
+ 1–50. Keep the returned order. Summarize the development using the headline
63
+ and any available summary, and cite its `story_url`. These are leads for
64
+ research. If `items` is empty, report that no prepared stories are available.
65
+ On error, report that Bloom's feed could not be read.
66
+
58
67
  ## Environment Variables
59
68
 
60
69
  | Variable | Required for | Description |
@@ -95,7 +104,7 @@ done
95
104
  ### Screen → Deep Dive
96
105
  ```bash
97
106
  # Find cheap large-caps
98
- bloom screen "market_cap > 50B" "pe_ratio < 20" "dividend_yield > 2" -o /tmp/bloom/screened.json
107
+ bloom screen "market_cap > 50B" "pe_ratio < 20" "dividend_yield > 2%" -o /tmp/bloom/screened.json
99
108
 
100
109
  # Get the tickers
101
110
  tickers=$(jq -r '.results[].symbol' /tmp/bloom/screened.json | head -5 | tr '\n' ' ')
package/dist/index.js CHANGED
@@ -347,7 +347,7 @@ async function verifyApiKey(apiKey) {
347
347
  }
348
348
  return "unverified";
349
349
  }
350
- async function callTool(toolName, args) {
350
+ async function callTool(toolName, args, signal) {
351
351
  const apiKey = requireApiKey();
352
352
  requestId++;
353
353
  const mcpUrl = `${_apiBase}/mcp/`;
@@ -369,7 +369,8 @@ async function callTool(toolName, args) {
369
369
  Authorization: `Bearer ${apiKey}`,
370
370
  "Content-Type": "application/json"
371
371
  },
372
- body: JSON.stringify(body)
372
+ body: JSON.stringify(body),
373
+ signal
373
374
  });
374
375
  const elapsed = Math.round(performance.now() - start);
375
376
  debugLog(`\u2190 ${res.status} (${elapsed}ms)`);
@@ -716,6 +717,9 @@ var BloomClient = class _BloomClient {
716
717
  async getMarketBriefing() {
717
718
  return callTool("get_market_briefing", {});
718
719
  }
720
+ async getFeed(limit) {
721
+ return callTool("get_feed", { limit }, AbortSignal.timeout(15e3));
722
+ }
719
723
  // --- Sentiment ---
720
724
  async getSentiment(sections) {
721
725
  const args = {};
@@ -1111,6 +1115,37 @@ function registerBriefingCommand(program2) {
1111
1115
  });
1112
1116
  }
1113
1117
 
1118
+ // src/commands/feed.ts
1119
+ var MAX_STORIES = 50;
1120
+ function registerFeedCommand(program2) {
1121
+ addGlobalOptions(
1122
+ program2.command("feed").description("Bloom's curated investment discovery feed").option("--limit <n>", `Max stories (1\u2013${MAX_STORIES})`, "10")
1123
+ ).action(async (opts) => {
1124
+ const limit = parseIntArg(opts.limit, "--limit", 1, MAX_STORIES);
1125
+ const data = await BloomClient.instance().getFeed(limit);
1126
+ if (!data || typeof data !== "object" || !("items" in data) || !Array.isArray(data.items)) {
1127
+ throw new BloomError("Unexpected feed response from Bloom.");
1128
+ }
1129
+ const items = data.items;
1130
+ const rowsOnly = !opts.raw && (opts.format === "csv" || opts.format === "markdown");
1131
+ outputResult(rowsOnly ? items : data, opts, () => formatFeed(items));
1132
+ });
1133
+ }
1134
+ function terminalText(value) {
1135
+ return typeof value === "string" ? value.replace(new RegExp("\\p{Cc}+", "gu"), " ").trim() : "";
1136
+ }
1137
+ function formatFeed(items) {
1138
+ const stories = items.flatMap((item) => {
1139
+ if (!item || typeof item !== "object" || !("headline" in item)) return [];
1140
+ const headline = terminalText(item.headline);
1141
+ if (!headline) return [];
1142
+ const summary = "summary" in item ? terminalText(item.summary) : "";
1143
+ const url = "story_url" in item ? terminalText(item.story_url) : "";
1144
+ return [[headline, summary, url].filter(Boolean).join("\n")];
1145
+ });
1146
+ return stories.join("\n\n") || "No stories in the feed.";
1147
+ }
1148
+
1114
1149
  // src/commands/sentiment.ts
1115
1150
  var SECTIONS = [
1116
1151
  "aaii_sentiment",
@@ -2034,7 +2069,7 @@ function formatDcf(data, symbol) {
2034
2069
  // src/commands/holders.ts
2035
2070
  function registerHoldersCommand(program2) {
2036
2071
  addGlobalOptions(
2037
- program2.command("holders").description("Institutional holders of a stock").argument("<symbol>", "Ticker symbol")
2072
+ program2.command("holders").description("Institutional and mutual fund holders of a stock").argument("<symbol>", "Ticker symbol")
2038
2073
  ).addHelpText("after", `
2039
2074
  Examples:
2040
2075
  $ bloom holders AAPL Top institutional holders of Apple
@@ -2046,15 +2081,49 @@ Examples:
2046
2081
  });
2047
2082
  }
2048
2083
  function formatHolders(data) {
2049
- if (!Array.isArray(data) || data.length === 0) return "(no holders data)";
2050
- const rows = data.map((h) => [
2051
- String(h.holder ?? "-"),
2052
- fmtNum2(h.shares),
2053
- h.dateReported ? String(h.dateReported).slice(0, 10) : "-",
2054
- h.change != null ? String(h.change) : "-",
2055
- h.weightPercent != null ? `${Number(h.weightPercent).toFixed(2)}%` : "-"
2056
- ]);
2057
- return makeTable(["Holder", "Shares", "Date", "Change", "Weight %"], rows);
2084
+ const obj = data ?? {};
2085
+ const parts = [];
2086
+ const s = obj.institutional_summary;
2087
+ if (s) {
2088
+ parts.push(
2089
+ `INSTITUTIONAL OWNERSHIP (13F, quarter ending ${String(s.date ?? "-")})
2090
+ ` + makeTable(
2091
+ ["Owned %", "Change (pts)", "Holders", "Holder change", "New", "Closed"],
2092
+ [[
2093
+ fmtPct(s.ownershipPercent),
2094
+ fmtPct(s.ownershipPercentChange),
2095
+ fmtNum2(s.investorsHolding),
2096
+ String(s.investorsHoldingChange ?? "-"),
2097
+ String(s.newPositions ?? "-"),
2098
+ String(s.closedPositions ?? "-")
2099
+ ]]
2100
+ )
2101
+ );
2102
+ }
2103
+ if (Array.isArray(obj.institutional) && obj.institutional.length > 0) {
2104
+ const rows = obj.institutional.map((h) => [
2105
+ String(h.investorName ?? "-"),
2106
+ fmtNum2(h.sharesNumber),
2107
+ fmtPct(h.changeInSharesNumberPercentage),
2108
+ fmtPct(h.ownership)
2109
+ ]);
2110
+ parts.push("TOP INSTITUTIONS\n" + makeTable(["Holder", "Shares", "Change %", "Owned %"], rows));
2111
+ }
2112
+ if (Array.isArray(obj.mutual_fund) && obj.mutual_fund.length > 0) {
2113
+ const rows = obj.mutual_fund.map((h) => [
2114
+ String(h.holder ?? "-"),
2115
+ fmtNum2(h.shares),
2116
+ h.dateReported ? String(h.dateReported).slice(0, 10) : "-",
2117
+ fmtNum2(h.change)
2118
+ ]);
2119
+ parts.push("TOP MUTUAL FUNDS\n" + makeTable(["Fund", "Shares", "Date", "Change"], rows));
2120
+ }
2121
+ return parts.length > 0 ? parts.join("\n\n") : "(no holders data)";
2122
+ }
2123
+ function fmtPct(v) {
2124
+ if (v == null) return "-";
2125
+ const n = Number(v);
2126
+ return isNaN(n) ? String(v) : `${n.toFixed(2)}%`;
2058
2127
  }
2059
2128
  function fmtNum2(v) {
2060
2129
  if (v == null) return "-";
@@ -2069,11 +2138,10 @@ function fmtNum2(v) {
2069
2138
  // src/commands/short-interest.ts
2070
2139
  function registerShortInterestCommand(program2) {
2071
2140
  addGlobalOptions(
2072
- program2.command("short-interest").description("Short interest history").argument("<symbol>", "Ticker symbol").option("--limit <n>", "Number of records", "10")
2141
+ program2.command("short-interest").description("Latest short interest as % of float").argument("<symbol>", "Ticker symbol").option("--limit <n>", "Number of records", "10")
2073
2142
  ).addHelpText("after", `
2074
2143
  Examples:
2075
- $ bloom short-interest GME Short interest history for GameStop
2076
- $ bloom short-interest AMC --limit 20 Last 20 short interest records
2144
+ $ bloom short-interest GME Latest short interest for GameStop
2077
2145
  `).action(async (symbol, opts) => {
2078
2146
  const sym = symbol.toUpperCase();
2079
2147
  const limit = parseIntArg(opts.limit, "--limit");
@@ -2084,14 +2152,12 @@ Examples:
2084
2152
  function formatShort(data) {
2085
2153
  if (!Array.isArray(data) || data.length === 0) return "(no short interest data)";
2086
2154
  const rows = data.map((r) => [
2087
- String(r.date ?? "-"),
2088
- fmtNum3(r.shortInterest),
2089
- String(r.daysToCover ?? r.daysTocover ?? "-"),
2090
- String(r.shortInterestRatio ?? "-"),
2091
- fmtNum3(r.shortPriorMonthInterest ?? r.shortPriorMonth),
2092
- r.changePercent != null ? `${Number(r.changePercent).toFixed(2)}%` : "-"
2155
+ String(r.symbol ?? "-"),
2156
+ r.short_percent_float != null ? `${Number(r.short_percent_float).toFixed(2)}%` : "-",
2157
+ fmtNum3(r.shares_float),
2158
+ String(r.source ?? "-")
2093
2159
  ]);
2094
- return makeTable(["Date", "Short Interest", "Days to Cover", "Short Ratio", "Prior Month", "Change %"], rows);
2160
+ return makeTable(["Symbol", "Short % Float", "Float", "Source"], rows);
2095
2161
  }
2096
2162
  function fmtNum3(v) {
2097
2163
  if (v == null) return "-";
@@ -2302,12 +2368,22 @@ Examples:
2302
2368
  const result = await BloomClient.instance().getRatings(sym, limit);
2303
2369
  outputResult(result, opts, () => {
2304
2370
  const obj = result;
2305
- return formatRatings(obj.grades, obj.estimates);
2371
+ return formatRatings(obj.consensus, obj.grades, obj.estimates);
2306
2372
  });
2307
2373
  });
2308
2374
  }
2309
- function formatRatings(grades, estimates) {
2375
+ function formatRatings(consensus, grades, estimates) {
2310
2376
  const parts = [];
2377
+ if (consensus && typeof consensus === "object") {
2378
+ const c = consensus;
2379
+ const keys = ["strongBuy", "buy", "hold", "sell", "strongSell"];
2380
+ parts.push(
2381
+ "ANALYST CONSENSUS\n" + makeTable(
2382
+ ["Strong Buy", "Buy", "Hold", "Sell", "Strong Sell", "Consensus"],
2383
+ [[...keys.map((k) => String(c[k] ?? "-")), String(c.consensus ?? "-")]]
2384
+ )
2385
+ );
2386
+ }
2311
2387
  if (Array.isArray(grades) && grades.length > 0) {
2312
2388
  const rows = grades.map((g) => [
2313
2389
  String(g.date ?? "-").slice(0, 10),
@@ -2379,7 +2455,7 @@ function fmtMoney(n) {
2379
2455
  if (n >= 1e3) return `$${(n / 1e3).toFixed(1)}K`;
2380
2456
  return `$${n.toFixed(0)}`;
2381
2457
  }
2382
- function fmtPct(n, signed = false) {
2458
+ function fmtPct2(n, signed = false) {
2383
2459
  const v = (n * 100).toFixed(1);
2384
2460
  return signed && n >= 0 ? `+${v}%` : `${v}%`;
2385
2461
  }
@@ -2392,10 +2468,10 @@ function renderText(data) {
2392
2468
  const s = data.summary;
2393
2469
  const headerParts = [fmtMoney(s.total_value)];
2394
2470
  if (s.ytd_return !== null && s.ytd_return !== void 0) {
2395
- headerParts.push(`${fmtPct(s.ytd_return, true)} YTD`);
2471
+ headerParts.push(`${fmtPct2(s.ytd_return, true)} YTD`);
2396
2472
  }
2397
2473
  if (s.vs_spy !== null && s.vs_spy !== void 0) {
2398
- headerParts.push(`${fmtPct(s.vs_spy, true)} SPY`);
2474
+ headerParts.push(`${fmtPct2(s.vs_spy, true)} SPY`);
2399
2475
  }
2400
2476
  lines.push("");
2401
2477
  lines.push(" " + headerParts.join(" \u2022 "));
@@ -2408,7 +2484,7 @@ function renderText(data) {
2408
2484
  lines.push("");
2409
2485
  for (const sec of data.concentration.by_sector) {
2410
2486
  const name = sec.name.padEnd(14);
2411
- lines.push(` ${name} ${bar(sec.pct)} ${fmtPct(sec.pct)}`);
2487
+ lines.push(` ${name} ${bar(sec.pct)} ${fmtPct2(sec.pct)}`);
2412
2488
  }
2413
2489
  lines.push("");
2414
2490
  lines.push(" " + data.concentration.insight);
@@ -2433,7 +2509,7 @@ function renderText(data) {
2433
2509
  const r = data.risk;
2434
2510
  if (r.volatility && r.volatility.value != null) {
2435
2511
  lines.push(
2436
- ` Volatility ${r.volatility.label.padEnd(8)} ${fmtPct(r.volatility.value)}`
2512
+ ` Volatility ${r.volatility.label.padEnd(8)} ${fmtPct2(r.volatility.value)}`
2437
2513
  );
2438
2514
  }
2439
2515
  if (r.correlation_spy != null) {
@@ -2443,7 +2519,7 @@ function renderText(data) {
2443
2519
  );
2444
2520
  }
2445
2521
  if (r.max_drawdown != null) {
2446
- lines.push(` Max drawdown ${fmtPct(r.max_drawdown)}`);
2522
+ lines.push(` Max drawdown ${fmtPct2(r.max_drawdown)}`);
2447
2523
  }
2448
2524
  if (r.sharpe != null) {
2449
2525
  lines.push(` Sharpe ${r.sharpe.toFixed(2)}`);
@@ -2484,8 +2560,8 @@ function renderMarkdown(data) {
2484
2560
  lines.push("# Portfolio Analytics");
2485
2561
  lines.push("");
2486
2562
  const hp = [`**${fmtMoney(s.total_value)}**`];
2487
- if (s.ytd_return != null) hp.push(`${fmtPct(s.ytd_return, true)} YTD`);
2488
- if (s.vs_spy != null) hp.push(`${fmtPct(s.vs_spy, true)} SPY`);
2563
+ if (s.ytd_return != null) hp.push(`${fmtPct2(s.ytd_return, true)} YTD`);
2564
+ if (s.vs_spy != null) hp.push(`${fmtPct2(s.vs_spy, true)} SPY`);
2489
2565
  lines.push(hp.join(" \u2022 "));
2490
2566
  lines.push("");
2491
2567
  lines.push(`> ${s.headline_insight}`);
@@ -2495,7 +2571,7 @@ function renderMarkdown(data) {
2495
2571
  lines.push("| Sector | Allocation | Value |");
2496
2572
  lines.push("|---|---|---|");
2497
2573
  for (const sec of data.concentration.by_sector) {
2498
- lines.push(`| ${sec.name} | ${fmtPct(sec.pct)} | ${fmtMoney(sec.value)} |`);
2574
+ lines.push(`| ${sec.name} | ${fmtPct2(sec.pct)} | ${fmtMoney(sec.value)} |`);
2499
2575
  }
2500
2576
  lines.push("");
2501
2577
  lines.push(data.concentration.insight);
@@ -2516,9 +2592,9 @@ function renderMarkdown(data) {
2516
2592
  lines.push("## Risk");
2517
2593
  lines.push("");
2518
2594
  const r = data.risk;
2519
- if (r.volatility && r.volatility.value != null) lines.push(`- Volatility: ${r.volatility.label} (${fmtPct(r.volatility.value)})`);
2595
+ if (r.volatility && r.volatility.value != null) lines.push(`- Volatility: ${r.volatility.label} (${fmtPct2(r.volatility.value)})`);
2520
2596
  if (r.correlation_spy != null) lines.push(`- Correlation to SPY: ${r.correlation_spy.toFixed(2)}`);
2521
- if (r.max_drawdown != null) lines.push(`- Max drawdown: ${fmtPct(r.max_drawdown)}`);
2597
+ if (r.max_drawdown != null) lines.push(`- Max drawdown: ${fmtPct2(r.max_drawdown)}`);
2522
2598
  if (r.sharpe != null) lines.push(`- Sharpe: ${r.sharpe.toFixed(2)}`);
2523
2599
  lines.push("");
2524
2600
  lines.push(r.insight);
@@ -2774,7 +2850,7 @@ Examples:
2774
2850
  var program = new Command3();
2775
2851
  var __dirname = path.dirname(fileURLToPath(import.meta.url));
2776
2852
  var pkgPath = path.join(__dirname, "..", "package.json");
2777
- var compiledVersion = "0.1.8".length > 0 ? "0.1.8" : void 0;
2853
+ var compiledVersion = "0.1.10".length > 0 ? "0.1.10" : void 0;
2778
2854
  var envVersion = process.env.BLOOM_CLI_VERSION ?? process.env.npm_package_version;
2779
2855
  var fallbackVersion = compiledVersion ?? "unknown";
2780
2856
  var cliVersion = envVersion ?? fallbackVersion;
@@ -2833,6 +2909,7 @@ registerRiskCommand(program);
2833
2909
  registerDrawdownCommand(program);
2834
2910
  registerMacroCommand(program);
2835
2911
  registerBriefingCommand(program);
2912
+ registerFeedCommand(program);
2836
2913
  registerSectorsCommand(program);
2837
2914
  registerDcfCommand(program);
2838
2915
  registerHoldersCommand(program);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bloomai/cli",
3
- "version": "0.1.8",
3
+ "version": "0.1.10",
4
4
  "description": "CLI tool for Bloom financial data - download market data to files for analysis",
5
5
  "repository": {
6
6
  "type": "git",
@@ -35,7 +35,7 @@
35
35
  },
36
36
  "devDependencies": {
37
37
  "@types/node": "^22.13.0",
38
- "tsup": "^8.5.1",
38
+ "tsup": "^9.0.0",
39
39
  "typescript": "^5.7.0"
40
40
  }
41
41
  }