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>

tests/conftest.py

@@ -14,7 +14,7 @@ from contextlib import contextmanager
 from fnmatch import fnmatch
 from http import HTTPStatus
 from pathlib import Path
-from typing import Generator, Optional, Union
+from typing import Callable, Generator, Optional, Union, cast
 from unittest.mock import PropertyMock, patch
 
 import pandas as pd
@@ -377,7 +377,7 @@ def config_eos_factory(
         # Check user data directory pathes (config_default_dirs[-1] == data_default_dir_user)
         assert config_eos.general.data_folder_path == data_folder_path
         assert config_eos.general.data_output_subpath == Path("output")
-        assert config_eos.cache.subpath == "cache"
+        assert config_eos.cache.subpath == Path("cache")
         assert config_eos.cache.path() == config_default_dirs[-1] / "data/cache"
         assert config_eos.logging.file_path == config_default_dirs[-1] / "data/output/eos.log"
 
@@ -446,7 +446,7 @@ def cleanup_eos_eosdash(
     pids: list[int] = []
     for _ in range(int(server_timeout / 3)):
         for conn in psutil.net_connections(kind="inet"):
-            if conn.laddr.port == port and conn.pid is not None:
+            if conn.laddr and conn.laddr.port == port and conn.pid is not None:
                 try:
                     process = psutil.Process(conn.pid)
                     cmdline = process.as_dict(attrs=["cmdline"])["cmdline"]
@@ -497,7 +497,7 @@ def cleanup_eos_eosdash(
     pids = []
     for _ in range(int(server_timeout / 3)):
         for conn in psutil.net_connections(kind="inet"):
-            if conn.laddr.port in (eosdash_port, 8504, 8555) and conn.pid is not None:
+            if conn.laddr and conn.laddr.port in (eosdash_port, 8504, 8555) and conn.pid is not None:
                 try:
                     process = psutil.Process(conn.pid)
                     cmdline = process.as_dict(attrs=["cmdline"])["cmdline"]
@@ -766,5 +766,5 @@ def set_other_timezone():
     yield _set_timezone
 
     # Restore the original timezone
-    pendulum.set_local_timezone(original_timezone)
+    cast(Callable[[pendulum.Timezone | pendulum.FixedTimezone], None], pendulum.set_local_timezone)(original_timezone)
     assert pendulum.local_timezone() == original_timezone