Add configuration and CLI foundation

docs/cli.md

@@ -1,23 +1,43 @@
 # Weatherreporter CLI
 
-`weatherreporter` currently exposes only the root help command while the
-application skeleton is being established.
+`weatherreporter` currently resolves configuration and command requests, then
+returns a not-implemented error for report generation and scheduled runs.
 
 ## Shortest Useful Command
 
 ```sh
-weatherreporter --help
+weatherreporter generate daily --date 2026-05-29 --out ./daily.md
 ```
 
+The command parses flags, loads configuration, resolves the request, and then
+stops before weather data fetching or report rendering.
+
 ## Command Overview
 
 ```text
-weatherreporter --help
+weatherreporter generate daily
+weatherreporter generate tomorrow
+weatherreporter generate three-day
+weatherreporter generate weekend
+weatherreporter generate storm --start 2026-05-29T18:00 --end 2026-05-30T06:00
+weatherreporter run morning
+weatherreporter run evening
 ```
 
-Shows the available command-line help without loading configuration or calling
-external services.
+`generate` commands resolve one report request. `run` commands resolve a
+scheduled batch request. All report and batch execution currently returns
+`not implemented` after request resolution.
 
 ## Flags
 
 - `-h`, `--help`: show help.
+- `--config PATH`: load configuration from `PATH` instead of `/usr/local/etc/weatherreporter/config.yml`.
+- `--units VALUE`: override configured Weather API units.
+- `--tz NAME`: override configured Weather API timezone.
+- `--out PATH`: override report output path or directory for `generate` commands.
+- `--date YYYY-MM-DD`: optional date for `generate daily`; defaults to the current local date in the configured timezone.
+- `--start TIME`: required start time for `generate storm`.
+- `--end TIME`: required end time for `generate storm`.
+
+Storm times accept `YYYY-MM-DDTHH:MM` in the configured timezone or RFC3339
+timestamps with explicit offsets.

docs/config.md

@@ -0,0 +1,46 @@
+# Weatherreporter Configuration
+
+Configuration is loaded from `/usr/local/etc/weatherreporter/config.yml` by
+default. Use `--config PATH` to load a different file. CLI flags override file
+values.
+
+If the default file is absent, built-in defaults are used.
+
+## Minimal Config
+
+```yaml
+weather_api:
+  base_url: https://weather.api.example.com/
+```
+
+## Production-Oriented Config
+
+See [examples/config.yml](../examples/config.yml).
+
+## Reference
+
+- `weather_api.base_url`: single Weather API endpoint base URL.
+- `weather_api.timeout`: HTTP timeout duration. Default: `10s`.
+- `weather_api.precision`: numeric precision hint. Default: `1`.
+- `weather_api.units`: Weather API units. Default: `us`.
+- `weather_api.timezone`: report timezone. Default: `Chicago`.
+- `weather_api.format`: Weather API response format. Default: `json`.
+- `missing_source.default`: one of `error`, `warn`, or `none`. Default: `warn`.
+- `missing_source.sources`: optional per-source missing-source policy overrides.
+- `scriptorium.binary`: `scriptorium` executable name. Default: `scriptorium`.
+- `scriptorium.config_path`: optional `scriptorium` config path.
+- `scriptorium.profile`: optional `scriptorium` profile.
+- `scriptorium.timeout`: subprocess timeout. Default: `2m`.
+- `scriptorium.extra_args`: optional extra arguments reserved for the adapter.
+- `workspace.root`: workspace root. Default: `workspace`.
+- `workspace.snapshots_dir`: snapshot directory under the workspace.
+- `workspace.reports_dir`: managed report directory under the workspace.
+- `workspace.data_packages_dir`: prompt input package directory under the workspace.
+- `workspace.preflight_dir`: preflight output directory under the workspace.
+- `reports.output_dir`: report output directory. Default: `reports`.
+- `reports.paths`: optional report-specific output paths.
+- `dayparts`: named daypart definitions with `start` and `end` `HH:MM` values.
+- `recent_change.temperature_degrees`: temperature change threshold.
+- `recent_change.precip_probability_points`: precipitation probability threshold.
+- `recent_change.wind_gust_miles_per_hour`: wind gust change threshold.
+- `recent_change.precip_timing_shift_minutes`: precipitation timing shift threshold.