# Roadmap

Open work only. Shipped behavior is described in `README.md` and `docs/`;
history lives in git.

## Stocks
- `market summary`: IHSG index and market breadth
- `market movers`: top gainers, losers, and volume
- `market sectors`: sector performance overview
- `screen query "<EXPR>"`: filter stocks by expression
- `screen presets` / `screen run <PRESET>`: built-in screener presets
  (graduate `screen` out of `stocks` only if these grow into a richer workflow)
- Multi-period financial statements (today `financials` is single-period)
- Order book (bid/offer depth): no free, login-free source exists. IDX sells
  delayed depth to vendors and Stockbit's needs a user login. Revisit if a
  permitted source appears; do not ship the closing best bid/offer as one.
- Bandarmology follow-ups: a daily series (per-session readings and the
  cumulative top-N net) and a price-move phase (quiet accumulation, markup),
  calibration of the `top_concentration_v1` thresholds across more sessions,
  and a market-wide foreign flow screen from one IDX trading summary
- News beyond MSN in `news` / `get_company` (`docs/IDX_NEWS.md`): Google News
  RSS per ticker, and IDX disclosures and exchange news through a
  maintainer-published feed

## Workflow
- `watchlist`: named symbol sets usable by other commands
- `alerts`: price alerts with a daemon
- CSV/TSV output
- Additional providers (Alpha Vantage, Twelve Data, IDX official)

## Agent integration
- JSON Schema export for command output
- Composite `analyze` command (quote, fundamentals, ownership, sentiment)

## Known limits
- `stocks broker` and `stocks bandar` show only IPOT's top 10 buyers and
  sellers, ranked by gross lots, with figures of a million and more rounded
  to one decimal.
- `stocks flow --source idx` depends on IDX's Cloudflare passing a
  curl-impersonate profile (only `curl_safari184` in October 2026) and on the
  network; the default IPOT source rounds to one decimal.
- Yahoo can return `429` from datacenter IPs; requests retry with backoff but
  can still fail.
- `stocks technical` reports the SMA200 trend as unavailable when fewer than
  200 daily candles are returned.
- MSN's `low-pe` screen returned no priced stocks on 2026-10-14 (upstream;
  other filters work).
- MSN history for IDX is price-only (`1mo`, `3mo`, `1y`); Yahoo stays the
  default OHLCV source.