[schlessera]

First step towards running the WP-CLI maintenance and release chores mainly through agents, with humans as the fallback. The tooling assumed a human at a terminal: someone who had exported a token, could read prose output, would answer prompts, and would notice when something silently went wrong. This PR removes those assumptions without changing what the commands are for. Planning releases, the release plan/apply flow and the human-only signing step for the bundle come in follow-up PRs.

Credentials are picked up automatically. The login of the GitHub CLI is used first, because it is what maintainers already have set up. GH_TOKEN and GITHUB_TOKEN are the fallback. Requests run under the maintainer's own identity on purpose, so there is no separate bot account to manage. Write requests fail before they reach GitHub when there are no credentials, so nothing is left half-done.

wp maintenance doctor checks the setup. An agent can run it before doing anything and know whether it can proceed: which credentials and account are in use, scopes, remaining rate limit, and which tools are missing.

Output that can be parsed. release-notes, contrib-list and the milestones-* commands gain a JSON format, and failed API requests report a stable error code with a hint. The markdown and HTML output stays the same, apart from the fixes below.

No full install needed. wp-cli.yml now loads the commands through a small autoloader, so any wp executable can run them from this folder. Release work then needs WP-CLI, git and gh, not 50 clones and a WordPress install.

Work in progress is left alone. composer install and composer update used to switch every clone to its default branch and pull. Now a clone that has uncommitted changes or is on another branch is only fetched. Agents run these commands routinely, and should never disturb someone's checkout. Git failures are now reported instead of ignored.

Bugs fixed along the way. These came out of an audit, and most would mislead an agent without anyone noticing:

• replace-label --delete crashed after relabelling. It also only looked at the first 100 open issues, so the delete would have stripped the label from every closed issue.
• Release notes and contributor lists counted pull requests that were closed without being merged, and credited bots.
• release generate skipped every remaining milestone of a repository once one milestone was skipped.
• release close-released --all only covered the bundle.
• Bundle-wide release notes and contributor lists failed on wp-cli/mustangostang-spyc, whose repository is wp-cli/spyc.
• contrib-list <repo> and release-notes <repo> without a milestone did not work as documented.
• milestones-after depended on the order the API happened to return milestones in.
• foreach-bundle lost argument quoting.
• The unused fetch-org script is removed; .maintenance/clone-all-repositories.sh replaced it.

The new pure logic has unit tests. The commands were also run against the live API: bundle-wide notes and contributors for 3.0.0, and the credential fallbacks with gh, with a token, and with neither. The README is regenerated by the existing workflow after merge.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

❌ Patch coverage is 18.99314% with 354 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
.maintenance/src/GitHub.php	27.21%	123 Missing ⚠️
.maintenance/src/Doctor_Command.php	0.00%	70 Missing ⚠️
.maintenance/src/Release_Notes.php	30.58%	59 Missing ⚠️
.maintenance/src/Contrib_List_Command.php	0.00%	27 Missing ⚠️
.maintenance/src/Milestones_Since_Command.php	0.00%	19 Missing ⚠️
.maintenance/src/Release_Command.php	0.00%	19 Missing ⚠️
.maintenance/src/Release_Notes_Command.php	0.00%	19 Missing ⚠️
.maintenance/src/Milestones_After_Command.php	52.94%	8 Missing ⚠️
.maintenance/src/Release_Date_Command.php	0.00%	5 Missing ⚠️
.maintenance/src/Replace_Label_Command.php	0.00%	4 Missing ⚠️
... and 1 more

📢 Thoughts on this report? Let us know!