feat: GitHub Actions artifact integration with inline HTML report

Upload HTML report with archive: false (v7) for inline preview in
Actions UI, plus full directory zip for offline review with images.

Changes:
- upload-screenshots action: v6→v7, add HTML report uploads (inline
  single-file + full directory), configurable report-path and
  retention-days inputs
- test.yml: add PR comment with link to artifact using
  peter-evans/find-comment + create-or-update-comment (avoids spam
  by updating existing comment)
- README: updated GitHub Actions section with v7 examples, archive:
  false for inline preview, PR comment snippet

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: pftg

.github/actions/upload-screenshots/action.yml

@@ -1,23 +1,51 @@
 ---
-name: 'Upload screenshots for debug'
-description: 'To reproduce the issue locally, download the screenshots from the failed test'
+name: 'Upload SnapDiff screenshots'
+description: 'Upload screenshot diffs and HTML report as CI artifacts'
 inputs:
   name:
-    description: 'Customize the name of the artifact'
+    description: 'Artifact name prefix'
     required: true
+  report-path:
+    description: 'Path to the HTML report directory'
+    default: 'tmp/snap_diff'
+  retention-days:
+    description: 'Number of days to retain artifacts'
+    default: '2'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/upload-artifact@v6
+    - name: Upload screenshot diffs
+      uses: actions/upload-artifact@v7
       with:
         name: ${{ inputs.name }}-diffs
-        retention-days: 1
-        path: |
-          test/fixtures/app/doc/screenshots/
+        retention-days: ${{ inputs.retention-days }}
+        path: test/fixtures/app/doc/screenshots/
 
-    - uses: actions/upload-artifact@v6
+    - name: Upload Capybara failure screenshots
+      uses: actions/upload-artifact@v7
       with:
         name: ${{ inputs.name }}-capybara-fails
-        retention-days: 1
-        path: |
-          tmp/capybara/screenshots-diffs/
+        retention-days: ${{ inputs.retention-days }}
+        path: tmp/capybara/screenshots-diffs/
+
+    - name: Check for HTML report
+      id: check-report
+      shell: bash
+      run: test -f "${{ inputs.report-path }}/index.html" && echo "exists=true" >> "$GITHUB_OUTPUT" || echo "exists=false" >> "$GITHUB_OUTPUT"
+
+    - name: Upload HTML report (inline preview)
+      if: steps.check-report.outputs.exists == 'true'
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}-report
+        retention-days: ${{ inputs.retention-days }}
+        path: ${{ inputs.report-path }}/index.html
+        archive: false
+
+    - name: Upload HTML report with images (full download)
+      if: steps.check-report.outputs.exists == 'true'
+      uses: actions/upload-artifact@v7
+      with:
+        name: ${{ inputs.name }}-report-full
+        retention-days: ${{ inputs.retention-days }}
+        path: ${{ inputs.report-path }}/

.github/workflows/test.yml

@@ -5,12 +5,21 @@ name: Test
 on:
   push:
     branches: [ master ]
+    paths:
+      - '**.gemfile'
+      - '**.rb'
+      - '.github/workflows/**'
+      - '.github/actions/**'
+      - 'Gemfile*'
+      - '!bin/**'
   pull_request:
     type: [ opened, synchronize, reopened, review_requested ]
     paths:
       - '**.gemfile'
       - '**.rb'
       - '.github/workflows/**'
+      - '.github/actions/**'
+      - 'Gemfile*'
       - '!bin/**'
   workflow_dispatch:
 
@@ -52,6 +61,9 @@ jobs:
     name: Functional Test
     runs-on: ubuntu-latest
     timeout-minutes: 5
+    permissions:
+      contents: read
+      pull-requests: write
 
     steps:
       - name: Checkout code
@@ -73,6 +85,29 @@ jobs:
         with:
           name: base-screenshots
 
+      - name: Find existing report comment
+        if: failure() && github.event_name == 'pull_request'
+        uses: peter-evans/find-comment@v3
+        id: find-comment
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-author: 'github-actions[bot]'
+          body-includes: 'Screenshot diffs detected'
+
+      - name: Comment PR with report link
+        if: failure() && github.event_name == 'pull_request'
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          comment-id: ${{ steps.find-comment.outputs.comment-id }}
+          issue-number: ${{ github.event.pull_request.number }}
+          edit-mode: replace
+          body: |
+            ### Screenshot diffs detected
+
+            [View HTML report](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}#artifacts) in Actions artifacts.
+
+            Click `base-screenshots-report` for inline preview, or download `base-screenshots-report-full` for images.
+
       - name: Uploading Coverage Report
         uses: actions/upload-artifact@v7
         with:

README.md

@@ -840,26 +840,63 @@ This sets up Capybara to serve static files and configures screenshot paths auto
 
 ### GitHub Actions Integration
 
-Upload the HTML report as a CI artifact so reviewers can browse screenshot diffs directly:
+Add to your test helper to enable the HTML report:
+
+```ruby
+require 'capybara_screenshot_diff/reporters/html'
+```
+
+Upload the report as a CI artifact. With `archive: false`, the HTML renders inline in the Actions UI — no download needed:
 
 ```yaml
 # .github/workflows/test.yml
 - name: Run tests
   run: bundle exec rake test
 
+# Inline preview (renders in browser, single HTML file)
 - name: Upload screenshot report
   if: failure()
-  uses: actions/upload-artifact@v4
+  uses: actions/upload-artifact@v7
+  with:
+    name: screenshot-report
+    path: tmp/snap_diff/index.html
+    archive: false
+    retention-days: 2
+
+# Full report with images (download for offline review)
+- name: Upload full screenshot report
+  if: failure()
+  uses: actions/upload-artifact@v7
   with:
-    name: screenshot-diffs
-    path: tmp/snap_diff-report/
-    retention-days: 7
+    name: screenshot-report-full
+    path: tmp/snap_diff/
+    retention-days: 2
 ```
 
-To enable the HTML report, add to your test helper:
+**Optional: PR comment with link to report**
 
-```ruby
-require 'capybara_screenshot_diff/reporters/html'
+Automatically comment on the PR with a link to the artifact:
+
+```yaml
+- name: Find existing comment
+  if: failure() && github.event_name == 'pull_request'
+  uses: peter-evans/find-comment@v3
+  id: find-comment
+  with:
+    issue-number: ${{ github.event.pull_request.number }}
+    comment-author: 'github-actions[bot]'
+    body-includes: 'Screenshot diffs detected'
+
+- name: Comment PR with report link
+  if: failure() && github.event_name == 'pull_request'
+  uses: peter-evans/create-or-update-comment@v5
+  with:
+    comment-id: ${{ steps.find-comment.outputs.comment-id }}
+    issue-number: ${{ github.event.pull_request.number }}
+    edit-mode: replace
+    body: |
+      ### Screenshot diffs detected
+      [View report](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}#artifacts)
 ```
 
 ## Troubleshooting