@bloomai/cli 0.1.5 → 0.1.7

package/README.md

@@ -37,7 +37,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
 ### Core Research
 | Command | What it does | Example |
 |---------|-------------|---------|
-| `info` | Company fundamentals, ratings, peers | `bloom info AAPL MSFT` |
+| `info` (alias: `quote`) | Company fundamentals, ratings, peers, current price | `bloom info AAPL MSFT` |
 | `news` | Recent news headlines | `bloom news AAPL --limit 5` |
 | `price` | Historical price data | `bloom price AAPL --timeframes 1d,1m,1y` |
 | `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
 | Command | What it does | Example |
 |---------|-------------|---------|
 | `dcf` | Discounted cash flow valuation | `bloom dcf AAPL` |
-| `risk` | Risk factors from SEC 10-K filings | `bloom risk AAPL` |
+| `risk` | Risk factors from the latest ingested SEC 10-K (rows carry `filingDate`; warns when over ~15 months old) | `bloom risk AAPL` |
 | `ratings` | Analyst grades & price targets | `bloom ratings AAPL` |
 | `short-interest` | Short interest history | `bloom short-interest AAPL` |
 | `holders` | Institutional & mutual fund holders | `bloom holders AAPL` |
@@ -79,6 +79,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
 | `sectors` | Sector performance across time periods | `bloom sectors` |
 | `screen` | Filter stocks by metrics | `bloom screen "market_cap > 100B" "pe_ratio < 25"` |
 | `collections` | Curated stock lists by theme | `bloom collections --section VALUE` |
+| `collection-returns` | Returns for given collections | `bloom collection-returns --ids 113 --timerange 1y` |
 
 ### Corporate Events
 | Command | What it does | Example |
@@ -101,11 +102,15 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
 
 ## Global Flags
 
-Every command supports:
+Every command supports these, before or after the subcommand (`bloom --debug peers AAPL` or `bloom peers AAPL --debug`):
 - `-o, --output <file>` — write to file instead of stdout
-- `-f, --format json|csv|table` — output format (default: json)
+- `-f, --format json|csv|table|markdown` — output format (default: table in a terminal, json when piped or with `-o`); other values are rejected
 - `-q, --quiet` — suppress headers, data only
 - `--raw` — raw API response
+- `--no-cache` — bypass the disk cache
+- `--debug` — show requests and cache hits on stderr
+
+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.
 
 ## Common Patterns
 
@@ -234,6 +239,7 @@ bloom sectors
 
 ## Tips
 
+- **Every command has `--help` with examples.** Run `bloom <command> --help` to see usage patterns, available options, and practical examples.
 - Use `-o` to download data to files, then `jq` to extract. Saves context tokens.
 - Batch multiple tickers: `bloom info AAPL MSFT GOOG` (up to 10).
 - Use `bloom screen` first to narrow your universe, then deep-dive with other commands.

package/SKILL.md

@@ -13,7 +13,7 @@ export BLOOM_API_KEY=<your-key>
 
 ```bash
 # 1. Find what you need
-bloom info AAPL                              # fundamentals, ratings, peers
+bloom info AAPL                              # fundamentals, ratings, peers (`bloom quote` is an alias)
 bloom info AAPL --fields basic_metadata,bottom_line_ratings  # specific sections only
 
 # 2. Download to files for analysis
@@ -39,6 +39,7 @@ jq '.data[] | select(.revenue_growth > 0.1)' /tmp/bloom/aapl-revenue.json
 | `sentiment` | Market mood (AAII, Fear&Greed, VIX) | `bloom sentiment` |
 | `market` | Market map, sectors, movers | `bloom market --type top_movers` |
 | `collections` | Curated stock lists by theme | `bloom collections --section VALUE` |
+| `collection-returns` | Returns for given collections | `bloom collection-returns --ids 113 --timerange 1y` |
 | `screen` | Filter stocks by metrics | `bloom screen "market_cap > 100B" "pe_ratio < 25"` |
 | `earnings` | Earnings history & estimates | `bloom earnings AAPL` |
 | `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
 
 ## Global Flags
 
-Every command supports:
+Every command supports these, before or after the subcommand (`bloom --debug peers AAPL` or `bloom peers AAPL --debug`):
 - `-o, --output <file>` — write to file instead of stdout
-- `-f, --format json|csv|table` — output format (default: json)
+- `-f, --format json|csv|table|markdown` — output format (default: table in a terminal, json when piped or with `-o`); other values are rejected
 - `-q, --quiet` — suppress headers, data only
 - `--raw` — raw API response
+- `--no-cache` — bypass the disk cache
+- `--debug` — show requests and cache hits on stderr
+
+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.
 
 ## Common Patterns