Fix global runtime parameters rejected as "unknown" when used with an alias

[Copilot]

Since WP-CLI v2.13, Runner::set_alias() incorrectly copies CLI-specified global runtime params (e.g. url, path) into $this->assoc_args when an alias defines the same key. Subcommand::validate_args() then rejects them as "unknown" since they are not in the command's local synopsis.

# Fails — alias present alongside --url:
wp @dev --url=https://example.com search-replace 'example.com' 'example.test'
# Error: Parameter errors:
#  unknown --url parameter

Changes

• patches/fix-runner-set-alias.php — Patches Runner::set_alias() in the installed wp-cli/wp-cli vendor to skip global runtime parameter keys (queried from WP_CLI::get_configurator()->get_spec()) when deciding what to copy into $this->assoc_args. Keys are cached in a static variable. The script is idempotent (via an embedded marker) and emits a STDERR notice when the target code is not found, indicating the upstream has already fixed this.

• composer.json — Registers post-install-cmd / post-update-cmd hooks to apply the patch automatically after composer install / composer update.

• features/search-replace.feature — Adds a Behat regression test covering wp @alias --url=... search-replace (with and without --dry-run).

• phpcs.xml.dist — Excludes patches/ from PHPCS; it is build tooling, not plugin code.

The patch is a temporary shim. It should be removed once the fix lands in wp-cli/wp-cli upstream.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!