feat: add monitoring workflow to track recent workflow failures

Author: d-oit

.github/workflows/auto-fix.yml

@@ -13,7 +13,7 @@ jobs:
   auto-fix:
     name: Auto-fix Formatting and Clippy Issues
     runs-on: ubuntu-latest
-    if: "!contains(github.event.head_commit.message, '[skip auto-fix]')"
+    if: ${{ !contains(github.event.head_commit.message, '[skip auto-fix]') }}
 
     steps:
     - uses: actions/checkout@v4
@@ -81,8 +81,8 @@ jobs:
           git add .
 
           # Create detailed commit message
-          FORMAT_NEEDED="${{ steps.check.outputs.format_needed }}"
-          CLIPPY_NEEDED="${{ steps.check.outputs.clippy_needed }}"
+          FORMAT_NEEDED="${FORMAT_NEEDED_VAR}"
+          CLIPPY_NEEDED="${CLIPPY_NEEDED_VAR}"
           COMMIT_MSG="auto-fix: apply code quality fixes [skip auto-fix]"
           if [ "$FORMAT_NEEDED" = "true" ]; then
             COMMIT_MSG="$COMMIT_MSG
@@ -101,4 +101,7 @@ jobs:
           echo "✅ Code quality fixes applied and pushed!"
         else
           echo "ℹ️ No changes were made by the auto-fix tools."
-        fi
+        fi
+      env:
+        FORMAT_NEEDED_VAR: ${{ steps.check.outputs.format_needed }}
+        CLIPPY_NEEDED_VAR: ${{ steps.check.outputs.clippy_needed }}

.github/workflows/docs.yml

@@ -3,6 +3,8 @@ name: Deploy Docs
 on:
   push:
     branches: [ main ]
+  pull_request:
+    branches: [ main ]
   workflow_dispatch:
 
 permissions:
@@ -17,6 +19,7 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
+    if: github.event_name != 'pull_request'
     steps:
     - uses: actions/checkout@v4
 
@@ -67,6 +70,7 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     needs: build
+    if: github.event_name != 'pull_request'
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
@@ -76,6 +80,9 @@ jobs:
     name: Docs Agent
     runs-on: ubuntu-latest
     if: github.event_name == 'pull_request'
+    permissions:
+      pull-requests: write
+      contents: read
     steps:
     - uses: actions/checkout@v4
 
@@ -87,6 +94,8 @@ jobs:
 
     - name: Comment on PR if docs issues
       if: failure()
-      run: gh pr comment ${{ github.event.pull_request.number }} --body "Docs agent detected issues in documentation generation."
+      run: |
+        gh pr comment $PR_NUMBER --body "Docs agent detected issues in documentation generation."
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        PR_NUMBER: ${{ github.event.pull_request.number }}