[ci] Dispatch tests after wiki pointer commits

Author: coisa

.github/workflows/wiki-preview.yml

@@ -37,6 +37,7 @@ jobs:
     name: Update Wiki Preview
     runs-on: ubuntu-latest
     permissions:
+      actions: write
       contents: write
       pull-requests: read
 
@@ -110,6 +111,13 @@ jobs:
           pull: "--rebase --autostash"
           push: true
 
+      - name: Dispatch tests for wiki pointer commit
+        if: steps.submodule_status.outputs.changed == 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          HEAD_REF: ${{ github.event.pull_request.head.ref }}
+        run: gh workflow run tests.yml --ref "${HEAD_REF}" -f max-outdated=-1
+
       - uses: ./.dev-tools-actions/.github/actions/summary/write
         with:
           markdown: |
@@ -118,3 +126,4 @@ jobs:
             - Preview branch: `${{ env.WIKI_PREVIEW_BRANCH }}`
             - Submodule pointer changed: `${{ steps.submodule_status.outputs.changed }}`
             - Parent repository pointer commit result: `${{ steps.submodule_status.outputs.changed == 'true' && 'updated' || 'unchanged' }}`
+            - Tests dispatch result: `${{ steps.submodule_status.outputs.changed == 'true' && 'requested' || 'not needed' }}`

.github/workflows/wiki.yml

@@ -11,6 +11,7 @@ concurrency:
 jobs:
   preview:
     permissions:
+      actions: write
       contents: write
       pull-requests: read
     uses: ./.github/workflows/wiki-preview.yml

CHANGELOG.md

@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Keep required PHPUnit matrix checks reporting after workflow-managed `.github/wiki` pointer commits by running the pull-request test workflow without top-level path filters and aligning the packaged consumer test wrapper (#230)
 - Ignore intentional Composer Dependency Analyser shadow dependency findings by default while adding `dependencies --show-shadow-dependencies` for audits (#233)
+- Dispatch the required test workflow after wiki preview automation updates a pull-request `.github/wiki` pointer, avoiding permanently pending required checks on bot-authored pointer commits (#230)
 
 ## [1.21.0] - 2026-04-24
 

docs/advanced/branch-protection-and-bot-commits.rst

@@ -99,9 +99,15 @@ updates on PR branches while keeping ``main`` protected.
 Required test checks must still report for workflow-managed pointer commits.
 The tests workflow therefore triggers on every pull request update without
 top-level path filters. This ensures GitHub always creates the required
-``Run Tests`` matrix checks for the latest pull request head, including bot
-commits that only refresh ``.github/wiki``. Test workflow concurrency cancels
-older in-progress runs for the same pull request so the newest commit owns the
+``Run Tests`` matrix checks for ordinary pull request updates.
+
+Workflow-managed ``.github/wiki`` pointer commits need one extra step. GitHub
+does not start another ``pull_request`` or ``push`` workflow run for commits
+pushed with the built-in workflow token. After the wiki preview workflow commits
+a parent-repository pointer update, it explicitly dispatches ``tests.yml`` for
+the pull request head branch so the newest bot-authored commit receives the
+required ``Run Tests`` matrix checks. Test workflow concurrency cancels older
+in-progress runs for the same pull request so the newest commit owns the
 required check contexts.
 
 At a high level, the workflows need permission to read repository contents,
@@ -128,8 +134,9 @@ distinguish open pull requests from closed or merged ones before deleting
 
 ``wiki.yml`` is now preview-only, so its called workflow keeps
 ``contents: write`` for wiki preview commits and parent-repository submodule
-pointer updates, while retaining ``pull-requests: read`` to inspect pull
-request metadata safely.
+pointer updates, ``actions: write`` to dispatch ``tests.yml`` after bot-authored
+pointer commits, and ``pull-requests: read`` to inspect pull request metadata
+safely.
 
 ``wiki-maintenance-entry.yml`` and ``wiki-maintenance.yml`` keep
 ``contents: write`` for wiki publication and cleanup tasks, and

resources/github-actions/wiki.yml

@@ -5,6 +5,7 @@ on:
     types: [opened, synchronize, reopened]
 
 permissions:
+  actions: write
   contents: write
   pull-requests: read
 
@@ -15,6 +16,7 @@ concurrency:
 jobs:
   preview:
     permissions:
+      actions: write
       contents: write
       pull-requests: read
     # Pull-request wiki previews live here. Publication and preview cleanup are