Configuration and commands

Configuration and commands for sigstar. Collect market, on-chain, news and macro data, and explain, forecast and alert on crypto price moves from every angle.

sigstar init writes a commented sigstar.yml; every key is optional and the defaults are the ones in that file. The main parts:

warehouse: the DuckDB file (default warehouse.duckdb).
history: daily_days (90) and hourly_days (7) for the first collection.
assets: per asset, each venue's own market name (coinbase: BTC-USD, kraken: XBTUSD, binance: BTCUSDT, binance_futures: BTCUSDT, okx_swap: BTC-USDT-SWAP), its GDELT query, its headline keywords, its chainstar chains, and onchain: prices and dex_tokens (lists of {chain, token}, by address; native for ETH, SOL and BTC as chainstar keys them). Leave a venue out to skip it. Listing assets: replaces the defaults.
topics: market-wide news topics (defaults sec and stablecoin), each with a GDELT query and keywords; each becomes news_<topic>_volume_z and _tone_z features.
sources: licence_mode (personal or commercial); enabled: true/false per source; GDELT headline settings; RSS feeds; FRED series.
chainstar: warehouse (or SIGSTAR_CHAINSTAR_WAREHOUSE), and the stablecoins to count, by chain and contract address.
analysis: z-score window (30 days), anomaly threshold (3), driver threshold (2), on-chain coverage tolerance (0.1), forecast horizon (7 days), backtest origins (20).
alerts: rules file and log file. report: output folder.

Environment variables: SIGSTAR_FRED_API_KEY, SIGSTAR_ALERT_WEBHOOK_URL, SIGSTAR_CHAINSTAR_WAREHOUSE.

Commands

Command	What it does
`sigstar init`	Writes `sigstar.yml` and an example `sigstar-rules.yml` (never overwrites without `--force`).
`sigstar collect [--source NAME ...]`	Fetches what is new from every enabled source, or only the named ones (`coinbase, kraken, binance, binance_futures, okx, fear_greed, gdelt, rss, fred`).
`sigstar build`	Builds the dbt staging views and marts and runs the data tests.
`sigstar explain ASSET [--date D] [--top N --start D --end D] [--json]`	The move and what coincided with it, ranked, with evidence.
`sigstar relationships [--benchmark BTC]`	Correlations, betas, lead/lag, Granger tests, volatility regimes.
`sigstar anomalies [--days 7] [--threshold 3]`	Features far from their own recent history.
`sigstar forecast [ASSET ...] [--target price\|volatility\|volume]`	Forecasts with their backtest error against naive.
`sigstar alerts [--date D] [--no-webhook]`	Evaluates your rules, logs and sends new alerts.
`sigstar report [--window 90]`	Writes the daily brief (Markdown + HTML).
`sigstar run [--skip-collect]`	collect, build, alerts, report: the one to schedule.
`sigstar doctor`	Licence mode, config, keys (set or not), each source's reachability and robots.txt (or why it is off), terms notes, chainstar (with or without prices), dbt.

Global options go before the command: --config PATH, --debug.