gatsby-cli error semantics Did you mean <command>? doesn't correctly convey command options given

[anthonytranDev]

Description

When gatsby y develop has been typed. The resulting stdout suggests Did you mean new ?, more precisely new being very different from develop. Doesn't accurately depict the command typed in

Steps to reproduce

Demo Project - not required
Start up a new project gatsby and type in gatsby y develop

Expected result

Did you mean develop?

Actual result

Did you mean new?

Solution Suggestions

Include the following criteria

1. Increase the accuracy of string search with a list of suggestions

// Example based on npm
$ npm istall

// Result
Did you mean one of these?
    install
    uninstall
    star

2. Notify developer that the command is wrong and throw error

// Example of incorrect yarn command entered
$ yarn a upgrade

// result
yarn run v1.13.0
error Command "a" not found.
info Visit https://yarnpkg.com/en/docs/cli/run for documentat
ion about this command.

Environment

  System:
    OS: macOS Mojave 10.14.3
    CPU: x64 Intel(R) Core(TM) i5-7567U CPU @ 3.50GHz
    Shell: 3.2.57(1)-release - /bin/bash
  Binaries:
    Node: v10.14.2 - /Users/anthonytran/.nvm/versions/node/v10.14.2/bin/node
    npx: v6.5.0 - /Users/anthonytran/.nvm/versions/node/v10.14.2/bin/npx
    Yarn: 1.13.0 - /usr/local/bin/yarn
    npm: 6.5.0 - /Users/anthonytran/.nvm/node_modules/.bin
    gatsby: 2.4.8 - /Users/anthonytran/.config/yarn/global/node_modules/gatsby-cli
  Browsers:
    Chrome: 72.0.3626.109
  npmPackages:
     dependencies
      gatsby: ^2.1.16,
      gatsby-image: ^2.0.29,
      gatsby-plugin-manifest: ^2.0.18,
      gatsby-plugin-offline: ^2.0.24,
      gatsby-plugin-react-helmet: ^3.0.6,
      gatsby-plugin-sharp: ^2.0.21,
      gatsby-source-filesystem: ^2.0.22,
      gatsby-transformer-sharp: ^2.1.14,
      prop-types: ^15.7.2,
      react: ^16.8.3,
      react-dom: ^16.8.3,
      react-helmet: ^5.2.0

File contents (if changed)

gatsby-config.js: N/A
package.json: N/A
gatsby-node.js: N/A
gatsby-browser.js: N/A
gatsby-ssr.js: N/A

[freiksenet]

I think that's a good idea (pinging @gatsbyjs/docs just to make sure). Do you want to make a PR to add this feature? Thanks a lot!

[wardpeet]

some extra info: we use yargs as a cli parser. Code can be found https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-cli/src/create-cli.js. Yargs as an option to add completion text to the cli. Currently I don't think we use it.

reference: http://yargs.js.org/docs/#api-completioncmd-description-fn

[anthonytranDev]

@freiksenet @wardpeet Just made a PR to the gatsby-cli codebase. My aim here to improve the DX for y'all.

Questions

Do I need to submit a feature request first?
Is @wardpeet the person responsible for the gatsby-cli package?

[freiksenet]

Awesome 👍 You can just create a PR. We don't really have separate responsible people per packages, everyone in Gatsby team is responsible :)

[anthonytranDev]

This issue has now been resolved. It is now part of gatsby-cli@2.4.14