feat(ci): add mypy checks to Claude PR review workflow

Claude will now run mypy on changed files and fix type annotation issues.

Author: KRRT7

.github/workflows/claude.yml

@@ -54,20 +54,28 @@ jobs:
             PR NUMBER: ${{ github.event.pull_request.number }}
             EVENT: ${{ github.event.action }}
 
-            ## STEP 1: Run prek checks and fix issues
+            ## STEP 1: Run prek and mypy checks, fix issues
 
-            First, run `uv run prek run --from-ref origin/main` to check for linting/formatting issues on files changed in this PR.
+            First, run these checks on files changed in this PR:
+            1. `uv run prek run --from-ref origin/main` - linting/formatting issues
+            2. `uv run mypy <changed_files>` - type checking issues
 
-            If there are any issues:
+            If there are prek issues:
             - For SAFE auto-fixable issues (formatting, import sorting, trailing whitespace, etc.), run `uv run prek run --from-ref origin/main` again to auto-fix them
+
+            If there are mypy issues:
+            - Fix type annotation issues (missing return types, Optional/None unions, import errors for type hints, incorrect types)
+            - Do NOT add `type: ignore` comments - always fix the root cause
+
+            After fixing issues:
             - Stage the fixed files with `git add`
-            - Commit with message "style: auto-fix linting issues"
+            - Commit with message "style: auto-fix linting issues" or "fix: resolve mypy type errors" as appropriate
             - Push the changes with `git push`
 
             Do NOT attempt to fix:
-            - Type errors that require logic changes
-            - Complex refactoring suggestions
-            - Anything that could change behavior
+            - Type errors that require logic changes or refactoring
+            - Complex generic type issues
+            - Anything that could change runtime behavior
 
             ## STEP 2: Review the PR
 
@@ -148,7 +156,7 @@ jobs:
             2. If found, UPDATE it: `gh api --method PATCH repos/${{ github.repository }}/issues/comments/<ID> -f body="<content>"`
             3. If not found, CREATE: `gh pr comment ${{ github.event.pull_request.number }} --body "<content>"`
             4. Delete any OTHER claude[bot] comments to clean up duplicates: `gh api repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/comments --jq '.[] | select(.user.login == "claude[bot]") | .id' | tail -n +2 | xargs -I {} gh api --method DELETE repos/${{ github.repository }}/issues/comments/{}`
-          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*),Bash(gh issue view:*),Bash(gh issue list:*),Bash(gh api:*),Bash(uv run prek *),Bash(uv run coverage *),Bash(uv run pytest *),Bash(git status*),Bash(git add *),Bash(git commit *),Bash(git push*),Bash(git diff *),Bash(git checkout *),Read,Glob,Grep"'
+          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*),Bash(gh issue view:*),Bash(gh issue list:*),Bash(gh api:*),Bash(uv run prek *),Bash(uv run mypy *),Bash(uv run coverage *),Bash(uv run pytest *),Bash(git status*),Bash(git add *),Bash(git commit *),Bash(git push*),Bash(git diff *),Bash(git checkout *),Read,Glob,Grep,Edit"'
           additional_permissions: |
             actions: read
         env: