* **Goal:** Make dotenv/env usage consistent and well-documented. * **Acceptance criteria:** * Document precedence (env vars vs defaults vs provided dict). * Add ergonomic helpers if missing; otherwise add functional API wrappers.