refactor: optimize contributor workflow to use check_suite (#4819)

* refactor: use check_suite instead of check_run for contributor workflow

The contributors workflow was triggering after every individual check
completion. By switching to the check_suite event, it will now only
run once after all checks in a suite have completed, reducing
unnecessary workflow runs.

Changes:
- Changed trigger from check_run to check_suite
- Updated condition logic to handle check_suite event payload
- Updated script to extract PR number from check_suite.pull_requests

Signed-off-by: Mark Phelps <[email protected]>

* refactor: only run contributor workflow on check suite failure

Updated the workflow to only trigger when the check suite fails,
avoiding unnecessary runs when all checks pass successfully.

Signed-off-by: Mark Phelps <[email protected]>

* refactor: rename job to check-dco

Signed-off-by: Mark Phelps <[email protected]>

---------

Signed-off-by: Mark Phelps <[email protected]>

Author: markphelps

.github/workflows/contributors.yml

@@ -3,7 +3,7 @@ name: Contributor Assistant
 on:
   pull_request_target:
     types: [opened]
-  check_run:
+  check_suite:
     types: [completed]
 
 permissions:
@@ -12,15 +12,14 @@ permissions:
   checks: read
 
 jobs:
-  post-dco-comment:
+  check-dco:
     runs-on: ubuntu-latest
-    # Only run for PR opened events or when DCO check specifically fails
+    # Only run for PR opened events or when check suite completes with failure
     if: |
-      github.event_name == 'pull_request_target' || 
-      (github.event_name == 'check_run' && 
-       github.event.check_run.name == 'DCO' && 
-       github.event.check_run.conclusion == 'failure' &&
-       github.event.check_run.pull_requests[0] != null)
+      github.event_name == 'pull_request_target' ||
+      (github.event_name == 'check_suite' &&
+       github.event.check_suite.conclusion == 'failure' &&
+       github.event.check_suite.pull_requests[0] != null)
     steps:
       - name: Get Pull Request and Check DCO Status
         id: check_dco
@@ -29,16 +28,16 @@ jobs:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             let prNumber;
-            
+
             // Get PR number based on event type
             if (context.eventName === 'pull_request_target') {
               prNumber = context.issue.number;
-            } else if (context.eventName === 'check_run') {
-              const pulls = context.payload.check_run.pull_requests;
+            } else if (context.eventName === 'check_suite') {
+              const pulls = context.payload.check_suite.pull_requests;
               if (pulls && pulls.length > 0) {
                 prNumber = pulls[0].number;
               } else {
-                console.log('No PR associated with this check run');
+                console.log('No PR associated with this check suite');
                 return;
               }
             }