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

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

docs: update all documentation to reflect current codebase state