ci: Add GitHub Actions workflow for Python testing

Implement comprehensive CI/CD pipeline with GitHub Actions to ensure code quality and test coverage across multiple Python versions.

Workflow features:
- Multi-version testing (Python 3.9, 3.10, 3.11, 3.12, 3.13)
- Triggers on push and pull requests
- Matrix strategy for parallel execution

Quality checks:
1. Linting with Ruff
   - Fast Rust-based linter
   - Catches common errors and code smells

2. Format verification with Ruff
   - Ensures consistent code style
   - Fails if code not formatted

3. Type checking with mypy
   - Strict type validation
   - Catches type errors before runtime

4. Unit tests with pytest
   - Full test suite execution
   - Coverage reporting (XML and terminal)
   - Verbose output for debugging

5. Code coverage upload
   - Uploads to Codecov (Python 3.13 only)
   - Tracks coverage trends over time
   - Non-blocking for CI

Dependencies updated:
- Added pytest-cov for coverage reporting
- Updated to Poetry-based workflow
- Uses official GitHub Actions (v4/v5)

Benefits:
- Catch bugs before merge
- Ensure compatibility across Python versions
- Maintain code quality standards
- Track test coverage metrics
- Fast feedback loop for developers

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: cguarinosu

.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        run: poetry install
+
+      - name: Run linting with Ruff
+        run: poetry run ruff check .
+
+      - name: Run formatting check with Ruff
+        run: poetry run ruff format --check .
+
+      - name: Run type checking with mypy
+        run: poetry run mypy app/
+
+      - name: Run tests with pytest
+        run: poetry run pytest -v --cov=app --cov-report=xml --cov-report=term
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.13'
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false

pyproject.toml

@@ -16,6 +16,7 @@ pydantic-settings = "^2.6.0"
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.3.0"
 pytest-asyncio = "^0.24.0"
+pytest-cov = "^6.0.0"
 httpx = "^0.27.0"
 ruff = "^0.7.0"
 mypy = "^1.13.0"