chore: codebase audit and fixes (ruff, mypy, pytest)

Fix codebase issues: linting, types, tests, and security.

Refactor: Improve code quality, security, and configuration

docs: update all documentation to reflect current codebase state