feat: POC for allowing flexible command taxonomy

[mdonnalley]

Allowing flexible command taxonomy if the flexibleTaxonomy property in the oclif config is set to true

Examples

~/repos/salesforcecli/cli [main] : bin/dev run container function start --help
Build and run a Salesforce Function in a container.

USAGE
  $ sf run container function start [-p <value>] [-b <value>] [--clear-cache] [--no-pull] [-e <value>] [--network <value>] [-v]

~/repos/salesforcecli/cli [main] : bin/dev function run container start --help
Build and run a Salesforce Function in a container.

USAGE
  $ sf function run container start [-p <value>] [-b <value>] [--clear-cache] [--no-pull] [-e <value>] [--network <value>] [-v]

~/repos/salesforcecli/cli [main] : bin/dev plugins inspect @oclif/plugin-help
└─ @oclif/plugin-help
   ├─ version 5.1.10
   ├─ homepage https://github.com/oclif/plugin-help
   ├─ location /Users/mdonnalley/repos/salesforcecli/cli/node_modules/@oclif/plugin-help
   ├─ commands
   │  └─ help
   └─ dependencies
      └─ @oclif/core ^1.0.10 => 1.3.4

~/repos/salesforcecli/cli [main] : bin/dev inspect plugins @oclif/plugin-help
└─ @oclif/plugin-help
   ├─ version 5.1.10
   ├─ homepage https://github.com/oclif/plugin-help
   ├─ location /Users/mdonnalley/repos/salesforcecli/cli/node_modules/@oclif/plugin-help
   ├─ commands
   │  └─ help
   └─ dependencies
      └─ @oclif/core ^1.0.10 => 1.3.4

[peternhale]

@mdonnalley comments please for future generations

[RodEsp]

QA

Almost everything looks good except for the last two issue listed about topic help no longer showing up.

This was all tested using test-cli, expand this for command structure.

The `command_incomplete` hook just prints out the matches using console.log().

✔️ Run .\bin\dev.cmd hello -> Get error saying missing required arg
✔️ Run .\bin\dev.cmd hello Tester -> Get error saying missing required flag
✔️ Run .\bin\dev.cmd hello Tester -f Me -> Get successful command output

✔️ .\bin\dev.cmd hello world and .\bin\dev.cmd world hello have same behavior

✔️ .\bin\dev.cmd one nested and .\bin\dev.cmd nested one have same behavior

✔️ .\bin\dev.cmd two nested and .\bin\dev.cmd nested two have same behavior

✔️ .\bin\dev.cmd nested correctly passes the matched commands to the hook

✔️ .\bin\dev.cmd nested -n correctly matches the command with that flag

❌ Topics help is no longer displayed when just running a topic

Expected, this is what you get with flexibleTaxonomy set to false:

Actual, with flexibleTaxonomy set to true:

And it's even worse without a hook set:

❌ --help flag no longer works on topics either with or without a hook enabled.

With hook:

Without hook:

[RodEsp]

QA - Round 2

This was all tested using test-cli, expand this for command structure.

The `command_incomplete` hook just prints out the matches using console.log().

Every ✔️ from previous QA is still ✔️.
✔️ --help flag works as expected on topics

The below behavior is still happening but it is FAD. The docs will now reflect that users must implement a command_incomplete hook when using flexibleTaxonomy.
✔️ Topics help is no longer displayed when just running a topic

With flexibleTaxonomy set to true, and the hook described above:

Without a hook set:

Changes addressed