Unify /search and /search/fuzzy under a mode param; add OpenAPI response models

fix: use module-scoped con fixture to avoid repeated LOAD spatial overhead

Add ruff.toml and fix lint errors (imports, type hints, formatting)

Fix ruff formatting across all source and test files

Add mypy type checking to CI and fix type errors

add unit tests and CI workflow