Add codecoverage cleanup

[circlecube]

Proposed changes

New cleanup workflow and examples for each reusable codecoverage workflow.

New reusable-codecoverage-cleanup.yml

• Inputs: shas (optional JSON array), prune_unreachable (boolean), squash_history (boolean).
• Optional secret: repo_token (falls back to GITHUB_TOKEN).
• Checkout: repo with fetch-depth: 0 (for reachability) and gh-pages into gh-pages/.
• Remove specific SHAs: if shas is set, deletes only top-level dirs whose names are 40-char hex.
• Prune unreachable: if prune_unreachable, lists top-level dirs in gh-pages/, treats 40-char hex names as SHAs, runs git branch -a --contains from the repo root, removes dirs for commits not in any branch.
• Commit and push: if not squashing, commits removals and pushes to gh-pages.
• Squash: if squash_history, creates an orphan commit with the current tree (including any removals), then force-pushes to gh-pages.
• Does not alter gh-pages/phpunit/ or other non-SHA paths.

New example-codecoverage-cleanup.yml

• For consumer repos: copy into .github/workflows/ (e.g. as codecoverage-cleanup.yml).
• Triggers: pull_request closed, delete (branch), and weekly schedule (Sunday 00:00 UTC).
• On PR merge: job get-merged-pr-commits calls the API for that PR’s commits, then cleanup-on-merge calls the reusable with that SHA list.
• On branch delete: calls reusable with prune_unreachable: true.
• On schedule: calls reusable with prune_unreachable: true and squash_history: true.
• Uses secrets: inherit so the reusable gets the default token (or repo_token if the consumer sets it).

New example-codecoverage.yml

• Example workflow for repos that want to use the reusable code coverage.
• Triggers: push to main, pull_request targeting main.
• Job: Calls reusable-codecoverage.yml@main with:
• php-versions: '["7.4", "8.0", "8.1", "8.2", "8.3", "8.4"]'
• coverage-php-version: '7.4'
• repository-name: 'your-repo-name' (placeholder for consumers to replace)
• minimum-coverage: 25
• mysql-version: '5.7'
• Uses secrets: inherit so the reusable gets GITHUB_TOKEN (or repo_token if set).
• Header comments explain copying to .github/workflows/, setting repository-name, and point to the cleanup example.

Updated reusable-codecoverage.yml

• Added doc comment referencing the new cleanup and the associated example workflows.

Type of Change

Production

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Dependency update
• Refactoring / housekeeping (changes to files not directly related to functionality)

Development

• Tests
• Dependency update
• Environment update / refactoring
• Documentation Update

Visual

Checklist

• I have read the CONTRIBUTING doc
• I have viewed my change in a web-browser
• Linting and tests pass locally with my changes
• I have added tests that prove my fix is effective or that my feature works
• I have added necessary documentation (if appropriate)

Further comments