feat(ci): persist pyscn analyze report and post PR comment

Add pyscn analyze --html report generation + upload-artifact so full
reports survive past the job. On pull_request runs (same-repo only,
so forked-PR tokens don't hit a permissions error), pipe the JSON
report through jq into a PR comment via gh.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HL1T9zdfnCg1dcTcDfDRSt

Author: dlstadther

.github/workflows/tests.yml

@@ -28,6 +28,9 @@ jobs:
 
   lint:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
     steps:
       - uses: actions/checkout@v4
 
@@ -50,6 +53,33 @@ jobs:
       - name: Quality check with pyscn
         run: make lint-quality
 
+      - name: Generate pyscn report
+        if: always()
+        run: make lint-quality-report
+
+      - name: Upload pyscn report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: pyscn-report
+          path: .pyscn/reports/*.html
+
+      - name: Comment pyscn summary on PR
+        if: >-
+          always() &&
+          github.event_name == 'pull_request' &&
+          github.event.pull_request.head.repo.full_name == github.repository
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          uv run pyscn analyze --json --output - . | jq -r '
+            "## pyscn report\n" +
+            "- **Health Score:** " + (.summary.health_score | tostring) + " / 100 (" + .summary.grade + ")\n" +
+            "- Complexity: " + (.summary.complexity_score | tostring) + "\n" +
+            "- Dead code: " + (.summary.dead_code_score | tostring) + "\n"
+          ' > comment.md
+          gh pr comment "${{ github.event.pull_request.number }}" --body-file comment.md
+
   type-check:
     runs-on: ubuntu-latest
     steps:

Makefile

@@ -53,6 +53,9 @@ lint-docstrings:
 lint-quality:
 	uv run pyscn check .
 
+lint-quality-report:
+	uv run pyscn analyze --no-open --html .
+
 type:
 	uv run pyrefly check