ibd-distribution-day-monitorlisted

# IBD Distribution Day Monitor ## Purpose Detect IBD-style Distribution Days for major market ETFs (QQQ as Nasdaq proxy, SPY as S&P 500 proxy) and produce a daily market deterioration signal plus a TQQQ/QQQ exposure recommendation. Designed for post-market review. ## When to Use Invoke this skill: - Daily after the US market close. - Before increasing TQQQ exposure or rebalancing leveraged positions. - When evaluating whether an uptrend is becoming vulnerable to a correction. - As an upstream input to FTD (Follow-Through Day) detection or other market-state frameworks. Do NOT use this skill to: - Execute trades or modify orders. - Generate discretionary market predictions outside of the IBD ruleset. ## Inputs - Symbols (default: QQQ, SPY) and lookback (default 80 trading sessions). - Optional `--as-of YYYY-MM-DD` for backtesting against a historical session. - Strategy context: instrument (TQQQ or QQQ), current exposure %, base trailing stop %. - FMP API key via `--api-key`, `config.data.api_key`, or `FMP_API_KEY` env var (in that priority order). ## Core Rules A Distribution Day is detected when: 1. Today's close is at least 0.2% below yesterday's close. 2. Today's volume is greater than yesterday's volume. A Distribution Day is removed from the active count when either: - More than 25 trading sessions have elapsed since the DD. - The index has gained 5% from the DD close (using post-DD high by default; configurable to close-source). Today's DD is never invalidated im