- 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>

…tation

- Renamed all test methods in ArgAliasTest.php from camelCase to snake_case
  to match existing test conventions in the codebase
- Enhanced documentation for YAML boolean value handling to explain the
  behavior more clearly, including the note that 'n'/'N' become 'n' and
  'y'/'Y' become 'y'
- Added new test case for YAML boolean handling to verify correct behavior
- Mentioned that users can quote aliases in YAML to avoid boolean interpretation

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

Refactored get_arg_aliases() to use a single-pass state machine instead of
calling get_param_or_flag_args() for each parameter, which itself iterates
over all doc comment lines. This eliminates the nested loop pattern and
improves performance from O(n²) to O(n) where n is the number of doc lines.

Key changes:
- Parse doc comment in a single pass using state machine
- Track current parameter and YAML block state
- Preserve indentation in YAML blocks for correct parsing
- Process aliases when YAML block ends

This is especially beneficial for commands with many parameters and
extensive documentation, where the nested iteration could cause
noticeable performance issues during command loading.

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

Modified resolve_arg_aliases() to accept pre-computed aliases as a parameter
instead of fetching them internally. In invoke(), compute the alias map once
via get_arg_aliases() and reuse it for both assoc_args and extra_args.

This eliminates duplicate parsing of the PHPDoc and ensures consistent debug
output, improving performance when both argument arrays need resolution.

Also updated test_get_arg_aliases_yaml_boolean_handling to use quoted YAML
values ('n' and 'y' instead of unquoted) to work with the recent removal of
special boolean handling.

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

Re-added the special case handling for YAML boolean values that was
previously removed. This is necessary because YAML 1.1 interprets
single letters 'n', 'N', 'y', 'Y' as booleans (false/true), which
when cast to strings become empty or '1', breaking alias registration.

Without this handling, aliases like `alias: n` fail to work because:
1. YAML parses 'n' as boolean false
2. (string)false becomes ''
3. Empty string is filtered out, no alias registered

The fix converts boolean false back to 'n' and boolean true back to 'y',
allowing common single-letter aliases to work without requiring quotes.

This fixes the failing Behat test for `-n=42` alias usage.

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