fix: unify mypy environments for local checks and CI (#1291)

The isolated pre-commit mypy hook previously omitted runtime type information that
make mypy used, hiding errors involving dependencies such as Pydantic and Pendulum.
Makefile, pre-commit and CI now run the same full-project typing policy in the
development environment defined by uv.lock.

- Use uv run --locked --exact --extra dev and the same mypy arguments for Makefile
  and the local hook. Check all of src and tests, including on configuration-only
  changes.
- Pin Python 3.13 for local development and the pre-commit CI job, and install the
  locked pre-commit version in CI.
- Disable incremental analysis because existing Pendulum cache state changes mypy 2.3.1
  diagnostics. Document the policy, the performance tradeoff and the existing typing debt.
- Add a regression test that exercises Makefile, the hook and the CI command in a
  temporary project, accepting valid dependency types and detecting deliberate
  Pydantic/Pendulum assignment errors.

Resolve the newly detected mypy diagnostics.

- Enable the numpydantic and Pydantic mypy plugins, retaining strict Pydantic
  constructor typing with init_typed = true. Validate raw/coercible payloads through model_validate.
- Propagate concrete record, provider and time-window types through generic collections,
  factories and lookup methods. Preserve runtime field inspection and generated time-window
  documentation.
- Align Pendulum annotations with actual factory/arithmetic results while retaining Pydantic
  validation adapters at runtime. Correct optional values, array boundaries, REST handlers
  and plotting interfaces.
- Add pinned scipy-stubs and types-psutil, update uv.lock, and supply the plugins' dependencies.
- Add runtime regression coverage for validated path defaults, normalized time-series metadata,
  generic field inspection, invalid timestamps and unsupported provider imports.

Runtime and compatibility details:

- Validate path defaults as Path objects while retaining raw string defaults needed by
  migration serialization with exclude_defaults.
- Normalize feed-in tariff lists and default charge rates to NumPy arrays; reject missing
  timestamps/uninitialized values explicitly. Importing into a provider without import support
  returns HTTP 400.
- Public JSON schemas and OpenAPI structure match main (excluding the generated version).

Signed-off-by: dr-dimitry

Signed-off-by: dr-dimitry
Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>
Co-authored-by: dr-dimitri <87113560+dr-dimitri@users.noreply.github.com>
Co-authored-by: Normann <github@koldrack.com>

CONTRIBUTING.md

@@ -30,7 +30,7 @@ message style checks.
 Use `uv` to create the virtual environment and install development dependencies.
 
 ```bash
-uv sync --extra dev
+uv sync --locked --extra dev
 ```
 
 Install make to get access to helpful shortcuts (documentation generation, manual formatting, etc.).
@@ -58,16 +58,52 @@ Our code style checks use [`pre-commit`](https://pre-commit.com).
 To run formatting automatically before every commit:
 
 ```bash
-uv run pre-commit install
-uv run pre-commit install --hook-type commit-msg --hook-type pre-push
+uv run --locked --extra dev pre-commit install
+uv run --locked --extra dev pre-commit install --hook-type commit-msg --hook-type pre-push
 ```
 
 Or run them manually:
 
 ```bash
-uv run pre-commit run --all-files
+uv run --locked --extra dev pre-commit run --all-files
 ```
 
+### Static typing
+
+Use `uv` on your `PATH` and the Python version pinned in `.python-version` (also used by the
+pre-commit CI job). The supported typing entry points are:
+
+```bash
+make mypy
+uv run --locked --extra dev pre-commit run mypy --all-files
+```
+
+Both run `uv run --locked --exact --extra dev python -m mypy --config-file pyproject.toml`.
+CI runs the same local pre-commit hook. The environment includes all runtime dependencies and
+development stubs from `uv.lock`, including the type information supplied by Pydantic and Pendulum.
+`--locked` rejects an out-of-date lockfile instead of updating it, and `--exact` removes packages
+outside the selected locked dependencies. Keep the Makefile and hook commands identical.
+
+`[tool.mypy]` in `pyproject.toml` defines the policy for all of `src` and `tests`, targeting Python
+3.13 and Linux. The hook always checks this complete scope, including on configuration-only changes.
+It does not add the old mirror hook's `--ignore-missing-imports` or `--scripts-are-modules` defaults.
+Only the existing per-module missing-import exceptions in `pyproject.toml` apply.
+Incremental analysis is disabled because mypy 2.3.1 produces different Pendulum diagnostics with
+warm and empty caches. Each entry point therefore performs a full analysis; this costs time but
+keeps diagnostics independent of cache history without suppressing checks.
+
+To regression-test the entry points run:
+
+```bash
+uv run --locked --extra dev pytest -q --finalize tests/test_typingmypytoolchain.py
+```
+
+This test creates a temporary project and a fresh locked development environment and hook/type-check
+caches. It verifies valid Pydantic and Pendulum assignments, then deliberate type errors in both
+`src` and `tests`, through Makefile, a configuration-only hook run, and the CI command. All probes
+stay in the temporary project. It may download locked packages; set `UV_CACHE_DIR` to an empty
+temporary directory as well to verify without a warm package cache.
+
 ### Tests
 
 Use `pytest` to run tests locally: