# data/

No licensed raw records are stored in this repository.

| Path | Content | Committed? |
|---|---|---|
| `data/raw/` | nothing (raw FirstRate bars live only in the ignored scratch cache `$WP39_CACHE` on the compute node) | no |
| `data/processed/` | derived firm-quarter panel, feature tables and labels (Parquet). Derived aggregates only; still **not** committed (size, license caution) | no |
| `artifacts/manifests/` | hashed dataset manifests: dataset ids, `X-Dataset-Version`, extraction dates, row counts, SHA-256 of extracts, code SHA | yes |

Provenance rules (see `DATA_AUDIT.md`, `docs/API_INTEGRATION.md`):
- Market bars and fundamentals come from the owner's FinData OS API (`https://findata.spboucher.ai/api/v1`), a private
  lakehouse of FirstRate Data (license: private use, no redistribution of raw records).
- Earnings-release calendar rows are read from the FinData Postgres table `earnings_events` on the storage node because the
  API does not expose that dataset yet (documented exception).
- External public augmentations: SEC EDGAR `company_tickers.json` and `submissions` (CIK, SIC), Kenneth French data library
  (daily factors). Both are public, versioned by download date in the manifests.