fix: simplify CI workflow, consolidate dependency installation, and clean up comments

Author: Francisco

.github/workflows/ci.yml

@@ -29,16 +29,14 @@ jobs:
         uses: actions/cache@v4
         with:
           path: ~/.cache/pip
-          key: ${{ runner.os }}-pip-lint-${{ hashFiles('requirements.txt', 'pyproject.toml') }}
+          key: ${{ runner.os }}-pip-lint-${{ hashFiles('pyproject.toml') }}
           restore-keys: |
             ${{ runner.os }}-pip-lint-
 
-      - name: Install tools and project dependencies
+      - name: Install project and dev dependencies
         run: |
           pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install -e .
-          pip install ruff==0.4.0 black pytest
+          pip install -e ".[dev]"
 
       - name: Run Ruff Linter
         run: ruff check . --output-format=github
@@ -55,9 +53,7 @@ jobs:
           docker compose -f docker-compose.yml -f docker-compose.gpu.yml config --quiet --no-interpolate
 
   # ──────────────────────────────────────────────────────────────────────────
-  # Release — semantic versioning, changelog, and GitHub release
-  # Uses cycjimmy/semantic-release-action which correctly exposes step outputs
-  # so the publish job can gate on whether a release was actually cut.
+  # Release
   # ──────────────────────────────────────────────────────────────────────────
   release:
     name: Git Version & Changelog
@@ -100,20 +96,17 @@ jobs:
           echo "New release: v${{ steps.semantic.outputs.new_release_version }}"
 
   # ──────────────────────────────────────────────────────────────────────────
-  # Publish — build wheel and push to PyPI
-  # Only runs when semantic-release actually cut a new release
+  # Publish
   # ──────────────────────────────────────────────────────────────────────────
   publish:
     name: Build & Publish to PyPI
     runs-on: ubuntu-latest
     needs: release
     if: needs.release.outputs.new_release_published == 'true'
-
     steps:
       - name: Checkout repository at new release tag
         uses: actions/checkout@v4
         with:
-          # Check out the bumped tag so pyproject.toml already has the new version
           ref: v${{ needs.release.outputs.new_release_version }}
 
       - name: Set up Python