eit-market-data

Use when building, validating, or debugging KR snapshot bundles and the daily batch flow. Trigger on build_kr_snapshot.py, run_daily_batch.py, snapshot.json, manifest.json, summary.json, GitHub Actions daily-market-data.yml, ci_safe profile behavior, or eit-research bundle loading.

Use when official KRX-backed pykrx paths fail in eit-market-data. Trigger on KRX login changes, `KrxAuthRequired`, `LOGOUT`, `400`, `KeyError('지수명')`, empty KRX index or listing frames, pykrx dataframe column errors like missing `종가`/`BPS`/`PER`, browser cookie/profile issues, or when scripts/krx_login.py and src/eit_market_data/kr/krx_auth.py need to be modified or debugged.

Use before running Korean market-data collection, bundle export, or daily batch commands in eit-market-data. Trigger when the user wants to run or debug preflight, crawl_kr_data_pykrx.py (official raw collection), `crawl_kr_data_fallback.py` (legacy FnGuide repair path), `crawl_kr_data.py` (legacy authenticated recovery), build_kr_snapshot.py, run_daily_batch.py, GitHub Actions data jobs, or local environment setup. Also use when validating API keys, package installation, output directories, or batch readiness.

Use whenever modifying SnapshotBuilder, provider fetch methods, bundle export/load logic, date filters, or any code that could leak future information into snapshots or backtests. Trigger on look-ahead bias concerns, as_of propagation, report_date handling, benchmark joins, sector map timing, or changes to snapshot schemas and validation.

Use when adding or changing market-data providers, provider factories, optional dependencies, scripts that call providers, or tests around DART, ECOS, FDR, pykrx, and snapshot assembly. Trigger on changes under src/eit_market_data/, pyproject optional dependencies, provider protocols, or new market-data fields and adapters.