- Extended DocParser to parse 'alias' metadata from PHPdoc parameters
- Updated Subcommand to resolve aliases to canonical names before validation
- Modified Configurator to support single-dash short arguments (e.g., -w, -n=5)
- Added comprehensive unit tests for alias resolution
- Added Behat feature tests for argument aliases

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

- Simplify alias resolution logic with two-pass approach
- Add documentation for single-letter short argument limitation
- Improve code clarity and maintainability

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

YAML parsers interpret 'n', 'N', 'y', 'Y' as boolean values (false/true).
This caused single-letter aliases like 'n' to be parsed as false and then
converted to empty strings. Added special handling to convert boolean false
back to 'n' and boolean true to 'y', along with proper type conversion and
empty string filtering.

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

Replaces YAML-based alias metadata with a simpler inline pipe-separated
syntax in the parameter synopsis line:

  [--with-dependencies|w]
  [--verbose|v|wordy|deprecated-name]
  [--number=<number>|n]

Changes:
- SynopsisParser: Added extract_aliases() to parse pipe-separated aliases
  from tokens (| inside <> brackets is ignored), updated classify_token()
  to store aliases in $param['aliases'], updated render() to include aliases
- DocParser: Removed get_arg_aliases() (YAML-based, no longer needed) and
  get_param_or_flag_args() helper
- Subcommand: Removed $original_docparser, invoke() now builds alias map
  directly from parsed synopsis
- class-wp-cli.php: Added aliases?: string[] to PHPStan type definitions
- Feature tests: Rewritten with new pipe syntax, added help output test
- Unit tests: Rewritten for new SynopsisParser-based API

Aliases are visible in `wp help` output since the synopsis shows the full
pipe-separated parameter definition (e.g., [--verbose|v|wordy]).

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Two improvements to the alias resolution in invoke()/resolve_arg_aliases():

1. Repeating parameter merging (resolve_arg_aliases):
   - Refactored to a two-pass approach: first copy all non-alias entries,
     then process aliases
   - For repeating assoc params (e.g. [--status=<status>...|s]), alias
     values are now merged with any already-present canonical values instead
     of being silently discarded (e.g. --status=a -s=b now gives ['a','b'])
   - invoke() builds a $repeating_params map from the synopsis and passes
     it through to resolve_arg_aliases()

2. Conflict detection scope (invoke):
   - Previously built the conflict set from get_parameters(), which
     includes positional parameter names; this incorrectly flagged aliases
     that matched a positional name as conflicts
   - Now builds $assoc_flag_names from assoc/flag params only (local +
     global), so positional parameter names no longer block alias
     registration

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>