Add Cloudflare Pages deploy & OAuth middleware

Add a GitHub Actions workflow to auto-generate and deploy the SPECTRA dashboard to Cloudflare Pages, and introduce GitHub OAuth protection for the site. New files: deploy-dashboard.yml (workflow), site/_middleware.js (OAuth/session handling), site/access-denied.html (UI), site/functions/auth/callback.js (placeholder), and a dark theme stylesheet. Also update site index, scripts, styles and spectra.config.json, expand documentation index and agent guidance (proactive tool usage / screenshot handling), and add a git tag Bash command to .claude settings. These changes enable automated deployments and optional repository-restricted access to the dashboard via configurable environment variables.

Author: angelovstanton

.claude/settings.local.json

@@ -103,7 +103,8 @@
       "Bash(cp dashboard-site/access-denied.html \"C:/SourceCode/Spectra_Demo/dashboard-site/\")",
       "Bash(git status:*)",
       "Bash(for branch:*)",
-      "Bash(git ls-tree:*)"
+      "Bash(git ls-tree:*)",
+      "Bash(git tag:*)"
     ]
   }
 }

test_app_documentation/.github/agents/spectra-execution.agent.md

@@ -86,6 +86,18 @@ Users may use single-letter shortcuts for speed:
 - **b** = BLOCKED (ask for reason)
 - **s** = SKIP (ask for reason)
 
+## Proactive Tool Usage
+
+### After a FAILED Result
+After recording a FAILED result with `advance_test_case`:
+1. Ask: "Would you like to attach a screenshot of the failure?"
+2. If yes: guide them to provide base64 image data, then call `save_screenshot`
+3. If the user provides a multi-line failure description, call `add_test_note` to store the full details separately from the one-line notes in `advance_test_case`
+
+### Progress Summaries
+- Call `get_execution_summary` every 5 completed tests to show a mid-run progress snapshot
+- Call `get_execution_summary` immediately when the user asks "how are we doing?", "status?", "progress?", or similar
+
 ## Bug Logging (Azure DevOps MCP)
 
 When a test fails and user confirms bug creation:
@@ -102,7 +114,7 @@ When a test fails and user confirms bug creation:
 
 ## Screenshot Handling
 
-When user provides a screenshot or mentions taking one:
+After any FAILED or BLOCKED result, proactively ask the user if they want to attach a screenshot as evidence. When user provides a screenshot or mentions taking one:
 
 1. Call `save_screenshot` with the base64-encoded image data and test handle
 2. Optionally include a caption describing what the screenshot shows

test_app_documentation/.github/workflows/deploy-dashboard.yml

@@ -0,0 +1,89 @@
+# SPECTRA Dashboard Auto-Deployment
+#
+# Automatically regenerates and deploys the SPECTRA dashboard to Cloudflare Pages
+# when test files, documentation, execution data, or configuration change.
+#
+# Required GitHub Secrets:
+#   CLOUDFLARE_API_TOKEN  - Cloudflare API token with "Edit Cloudflare Pages" permissions
+#   CLOUDFLARE_ACCOUNT_ID - Your Cloudflare account ID
+#
+# Required Cloudflare Pages Environment Variables:
+#   GITHUB_CLIENT_ID      - GitHub OAuth App client ID (for authentication)
+#   GITHUB_CLIENT_SECRET  - GitHub OAuth App client secret
+#   ALLOWED_REPOS         - Comma-separated org/repo list (e.g., "myorg/myrepo")
+#   SESSION_SECRET        - Random string for cookie signing
+#   AUTH_ENABLED          - Set to "true" to enable authentication
+#
+# For full setup instructions, see docs/deployment/cloudflare-pages-setup.md
+
+name: Deploy SPECTRA Dashboard
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'tests/**'
+      - '.execution/**'
+      - 'docs/**'
+      - 'spectra.config.json'
+
+  workflow_dispatch:
+
+concurrency:
+  group: dashboard-deploy
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    name: Generate and Deploy Dashboard
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0'
+
+      - name: Install SPECTRA CLI
+        run: dotnet tool install -g spectra-cli
+
+      - name: Run coverage analysis with auto-linking
+        run: spectra ai analyze --coverage --auto-link
+        continue-on-error: true
+
+      - name: Generate dashboard
+        run: spectra dashboard --output ./site
+
+      - name: Copy Cloudflare Pages functions (OAuth middleware)
+        run: |
+          if [ -d "dashboard-site/functions" ]; then
+            cp -r dashboard-site/functions ./site/functions
+          fi
+
+      - name: Read project name from config
+        id: config
+        run: |
+          PROJECT_NAME=$(jq -r '.dashboard.cloudflare_project_name // "spectra-dashboard"' spectra.config.json 2>/dev/null || echo "spectra-dashboard")
+          echo "project_name=$PROJECT_NAME" >> "$GITHUB_OUTPUT"
+
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy ./site --project-name=${{ steps.config.outputs.project_name }}
+
+      - name: Post deployment summary
+        run: |
+          echo "## Dashboard Deployed" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "The SPECTRA dashboard has been updated and deployed." >> $GITHUB_STEP_SUMMARY
+          echo "**Project:** ${{ steps.config.outputs.project_name }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Trigger:** ${{ github.event_name }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Commit:** \`${{ github.sha }}\`" >> $GITHUB_STEP_SUMMARY