| dashboard.md |
Streamlit dashboard that reads RunDir artefacts directly and renders forecast evolution, accuracy, and WASDE-comparison charts for every commodity hindcast run on disk |
| delivery.md |
Client-facing CSV delivery subsystem — Pydantic row schemas, wide-to-long conversion, ADM aggregation, unit conversion, and S3/local export pipeline |
| detrend.md |
Detrending subsystem — three state-space detrenders (linear, Gaussian, partial-pooling) sharing a common abstract base and a single trend-axis convention; dispatched from build.py keyed on config.model.detrend |
| diagnostics.md |
Metrics computation, per-fold scoring, and rolling national vs NASS/WASDE/CONAB text reports; ADM1/ADM2 error tables; bu/ac unit conversion boundary |
| features.md |
Feature engineering subsystem — orchestrator, assembler, forecast splicing, long-range stub, and all concrete builders (yields, weather, climo, NDVI, stress) |
| lib.md |
Survey of all ~25 modules under lib/ — path anchoring, calendar, unit conversion, geo utilities, reference-data loaders, edit-and-imputation, artefact handles, and MLflow tracking helpers |
| meta_models.md |
Meta-models post-processing subsystem — BiasCorrector hierarchy, CalibrationResult (conformal calibration with save/load), four residual modes, and the run_meta_models stage orchestrator |
| orchestration.md |
Orchestration and configuration subsystem — CLI entry, Pydantic config, walk-forward runner, preflight gates, fold generation |
| plots.md |
Diagnostic plots subsystem — PlotRunner I/O orchestration, PlotRegistry/PlotSpec declarative discovery, prep modules, and all 11 plot-function modules |
| regression.md |
Regression models subsystem — AbstractRegressionImpl base contract, Ridge, PCA+Ridge, and XGBoost regressors, persistence formats, and runtime helpers |
| stages.md |
Stage modules under commodity_hindcast/stages/ — function signatures, artefact contracts, inner call sequences, and orchestrator flow for hindcast and forecast pipelines |