chore: add ruff linter, fix mypy errors, and write README

- Add ruff linter configuration to pyproject.toml with modern Python 3.12 rules
- Add ruff~=0.9.4 to dev dependencies
- Fix all mypy type errors (Optional[] hints, Token types, Any returns)
- Auto-fix 54 ruff issues (import sorting, Optional -> X | None syntax)
- Create ProjectMeta dataclass for single source of truth from pyproject.toml
- Write comprehensive README.md with setup, config, and development docs
- Update main.py to use settings.app_description from pyproject.toml

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

This commit is contained in:

jpmschweitzer

2026-01-09 22:58:24 +01:00

co-authored by

Claude Opus 4.5

parent 34b68621c6

commit 667e2ca8e4

13 changed files with 289 additions and 65 deletions

requirements-dev.txt

View File

@@ -15,3 +15,6 @@ pip-audit~=2.9.0
 # Type checking
 mypy~=1.19.1
 # Linting and formatting
 ruff~=0.9.4