- Bumped mypy's target from `python_version = 3.11` to `3.12` in `mypy.ini` to match the actual runtime (Docker images and CI both run 3.12.x; there is no 3.11 target anywhere in the repo). The stale `3.11` value made mypy validate third-party stub *syntax* against 3.11 and reject numpy's PEP 695 `type` aliases in `numpy/__init__.pyi` (`Type statement is only supported in Python 3.12 and greater [syntax]`), aborting the whole run before any project code was checked. numpy is unpinned and pulled transitively (pgvector/shapely/opencv/…) into the mypy hook env, so a routine numpy 2.4.x bump broke the `linter` job on every branch, including `main`. Both CI mypy invocations — the pre-commit hook (`mypy==2.0.0`) and the dedicated `Run mypy` step (`mypy==2.1.0`) — now pass clean (`Success: no issues found in 1425 source files`) with zero new project type errors. Updated `docs/typing/README.md` and added an in-file note in `mypy.ini` so the target is not silently lowered again.
