@bloomai/cli 0.1.6 → 0.1.7

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.
Files changed (4) hide show
  1. package/README.md +9 -4
  2. package/SKILL.md +8 -3
  3. package/dist/index.js +1372 -312
  4. package/package.json +9 -5
package/README.md CHANGED
@@ -37,7 +37,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
37
37
  ### Core Research
38
38
  | Command | What it does | Example |
39
39
  |---------|-------------|---------|
40
- | `info` | Company fundamentals, ratings, peers | `bloom info AAPL MSFT` |
40
+ | `info` (alias: `quote`) | Company fundamentals, ratings, peers, current price | `bloom info AAPL MSFT` |
41
41
  | `news` | Recent news headlines | `bloom news AAPL --limit 5` |
42
42
  | `price` | Historical price data | `bloom price AAPL --timeframes 1d,1m,1y` |
43
43
  | `financials` | Revenue, margins, cash flow | `bloom financials AAPL --type revenue` |
@@ -53,7 +53,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
53
53
  | Command | What it does | Example |
54
54
  |---------|-------------|---------|
55
55
  | `dcf` | Discounted cash flow valuation | `bloom dcf AAPL` |
56
- | `risk` | Risk factors from SEC 10-K filings | `bloom risk AAPL` |
56
+ | `risk` | Risk factors from the latest ingested SEC 10-K (rows carry `filingDate`; warns when over ~15 months old) | `bloom risk AAPL` |
57
57
  | `ratings` | Analyst grades & price targets | `bloom ratings AAPL` |
58
58
  | `short-interest` | Short interest history | `bloom short-interest AAPL` |
59
59
  | `holders` | Institutional & mutual fund holders | `bloom holders AAPL` |
@@ -79,6 +79,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
79
79
  | `sectors` | Sector performance across time periods | `bloom sectors` |
80
80
  | `screen` | Filter stocks by metrics | `bloom screen "market_cap > 100B" "pe_ratio < 25"` |
81
81
  | `collections` | Curated stock lists by theme | `bloom collections --section VALUE` |
82
+ | `collection-returns` | Returns for given collections | `bloom collection-returns --ids 113 --timerange 1y` |
82
83
 
83
84
  ### Corporate Events
84
85
  | Command | What it does | Example |
@@ -101,11 +102,15 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
101
102
 
102
103
  ## Global Flags
103
104
 
104
- Every command supports:
105
+ Every command supports these, before or after the subcommand (`bloom --debug peers AAPL` or `bloom peers AAPL --debug`):
105
106
  - `-o, --output <file>` — write to file instead of stdout
106
- - `-f, --format json|csv|table` — output format (default: json)
107
+ - `-f, --format json|csv|table|markdown` — output format (default: table in a terminal, json when piped or with `-o`); other values are rejected
107
108
  - `-q, --quiet` — suppress headers, data only
108
109
  - `--raw` — raw API response
110
+ - `--no-cache` — bypass the disk cache
111
+ - `--debug` — show requests and cache hits on stderr
112
+
113
+ Invalid values exit 1 with an error instead of being silently replaced: `--limit` must be a whole number >= 1, `earnings-calendar --days` must be 1-90, `financials --type` must be one of the listed chart types, and `portfolio` holdings must be a JSON object of symbol to numeric weight.
109
114
 
110
115
  ## Common Patterns
111
116
 
package/SKILL.md CHANGED
@@ -13,7 +13,7 @@ export BLOOM_API_KEY=<your-key>
13
13
 
14
14
  ```bash
15
15
  # 1. Find what you need
16
- bloom info AAPL # fundamentals, ratings, peers
16
+ bloom info AAPL # fundamentals, ratings, peers (`bloom quote` is an alias)
17
17
  bloom info AAPL --fields basic_metadata,bottom_line_ratings # specific sections only
18
18
 
19
19
  # 2. Download to files for analysis
@@ -39,6 +39,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
39
39
  | `sentiment` | Market mood (AAII, Fear&Greed, VIX) | `bloom sentiment` |
40
40
  | `market` | Market map, sectors, movers | `bloom market --type top_movers` |
41
41
  | `collections` | Curated stock lists by theme | `bloom collections --section VALUE` |
42
+ | `collection-returns` | Returns for given collections | `bloom collection-returns --ids 113 --timerange 1y` |
42
43
  | `screen` | Filter stocks by metrics | `bloom screen "market_cap > 100B" "pe_ratio < 25"` |
43
44
  | `earnings` | Earnings history & estimates | `bloom earnings AAPL` |
44
45
  | `technicals` | RSI, MAs, patterns, options flow | `bloom technicals AAPL` |
@@ -63,11 +64,15 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
63
64
 
64
65
  ## Global Flags
65
66
 
66
- Every command supports:
67
+ Every command supports these, before or after the subcommand (`bloom --debug peers AAPL` or `bloom peers AAPL --debug`):
67
68
  - `-o, --output <file>` — write to file instead of stdout
68
- - `-f, --format json|csv|table` — output format (default: json)
69
+ - `-f, --format json|csv|table|markdown` — output format (default: table in a terminal, json when piped or with `-o`); other values are rejected
69
70
  - `-q, --quiet` — suppress headers, data only
70
71
  - `--raw` — raw API response
72
+ - `--no-cache` — bypass the disk cache
73
+ - `--debug` — show requests and cache hits on stderr
74
+
75
+ Invalid values exit 1 with an error instead of being silently replaced: `--limit` must be a whole number >= 1, `earnings-calendar --days` must be 1-90, `financials --type` must be one of the listed chart types, and `portfolio` holdings must be a JSON object of symbol to numeric weight.
71
76
 
72
77
  ## Common Patterns
73
78