improve cli help: group main commands at top

[tongueroo]

This is a 🙋‍♂️ feature or enhancement.

• I've added tests (if it's a bug, feature or enhancement)
• I've adjusted the documentation (if it's a feature or enhancement)
• The test suite passes (run bundle exec rspec to verify this)

Summary

Improve the top-level terraspace -h command. Examples:

terraspace help
terraspace --help
terraspace -h

Example with output:

$ terraspace -h
Usage: terraspace COMMAND [args]

The available commands are listed below.
The primary workflow commands are given first, followed by
less common or more advanced commands.

Main Commands:

  terraspace all SUBCOMMAND  # all subcommands
  terraspace build [STACK]   # Build project.
  terraspace bundle          # Bundle with Terrafile.
  terraspace down STACK      # Destroy infrastructure stack.
  terraspace list            # List stacks and modules.
  terraspace new SUBCOMMAND  # new subcommands
  terraspace plan STACK      # Plan stack.
  terraspace seed STACK      # Build starer seed tfvars file.
  terraspace up STACK        # Deploy infrastructure stack.

Other Commands:

  terraspace check_setup             # Check setup.
  terraspace clean SUBCOMMAND        # clean subcommands
  terraspace completion *PARAMS      # Prints words for auto-completion.
  terraspace completion_script       # Generates a script that can be eval to setup auto-completion.
  terraspace console STACK           # Run console in built terraform project.
  terraspace fmt                     # Run terraform fmt
  terraspace force_unlock            # Calls terrform force-unlock
  terraspace help [COMMAND]          # Describe available commands or one specific command
  terraspace info STACK              # Get info about stack.
  terraspace init STACK              # Run init in built terraform project.
  terraspace logs [ACTION] [STACK]   # View and tail logs.
  terraspace output STACK            # Run output.
  terraspace providers STACK         # Show providers.
  terraspace refresh STACK           # Run refresh.
  terraspace show STACK              # Run show.
  terraspace state SUBCOMMAND STACK  # Run state.
  terraspace summary                 # Summarize resources.
  terraspace test                    # Run test.
  terraspace tfc SUBCOMMAND          # tfc subcommands
  terraspace validate STACK          # Validate stack.
  terraspace version                 # Prints version.

For more help on each command, you can use the -h option. Example:

    terraspace up -h

CLI Reference also available at: https://terraspace.cloud/reference/
$

How to Test

terraspace -h

Version Changes

Patch