feat: offer to run a suggested command when the typed name is not found

[paulbalandan]

Description

When a command name is not found, spark already lists the closest matches. On an interactive run it now also offers to run one of them.

Single match:

$ php spark cache:clea

Command "cache:clea" not found.

Run "cache:clear" instead? [y, n]: y
Cache cleared using the "file" driver.

Several matches:

$ php spark clear

Command "clear" not found.

Select a command to run instead:
  [0]  cache:clear
  [1]  debugbar:clear
  [2]  logs:clear
  [3]  none of these

[0, 1, 2, 3]: 0
Cache cleared using the "file" driver.

Declining (n, or none of these) runs nothing and exits with EXIT_ERROR. The chosen command receives the original arguments and options.

Non-interactive runs (--no-interaction / -N, piped input, or a NullInputOutput sink) are unchanged:

$ php spark cache:clea -N

Command "cache:clea" not found.

Did you mean this?
    cache:clear

Note: Commands::getCommandAlternatives() is now public (recorded under Method Scope Changes).

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value (without duplication)
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[neznaika0]

Nice feature

[michalsn]

Looks good!

I think we should also mention the method's visibility change in the upgrade notes. Something short, like:

If you extend CodeIgniter\CLI\Commands and override getCommandAlternatives(), change the override's visibility from protected to public.

[paulbalandan]

Looks good!

I think we should also mention the method's visibility change in the upgrade notes. Something short, like:

If you extend CodeIgniter\CLI\Commands and override getCommandAlternatives(), change the override's visibility from protected to public.

Added

[michalsn]

Thank you!