Stabilize pkgcheck by gating on commit-level CI completion

[Copilot]

pkgcheck was intermittently failing on main with Package fails continuous integration checks despite passing R-CMD-check and coverage runs for the same SHA. The failure was a timing issue: pkgcheck evaluated CI status before those workflows had completed.

• Root cause addressed: CI timing race on main pushes

  • pkgcheck could run before commit-matched R-CMD-check / coverage workflows finished.
  • This produced a false negative in pkgcheck’s CI-health check.

• Workflow change: add pre-check wait gate

  • In .github/workflows/pkgcheck.yaml, added a github-script step before ropensci-review-tools/pkgcheck-action@main.
  • Scope-limited to push on refs/heads/main.
  • Polls Actions runs for the current context.sha, filtered to workflow names matching /(cmd|coverage)/i.
  • Proceeds only when those runs are completed; fails early if any conclusion is non-success; times out after 15 minutes.

• Behavioral impact

  • Removes false pkgcheck failures caused by workflow ordering.
  • Preserves strict failure semantics when required CI actually fails.

- name: Wait for CI workflows on this commit
  if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
  uses: actions/github-script@v7
  with:
    script: |
      const sha = context.sha
      const pattern = /(cmd|coverage)/i
      # poll workflow runs for this sha until completed, then enforce success