Restructure completion command

bin/cli.js

@@ -54,6 +54,7 @@ const sandboxesCommand = require('../commands/sandbox');
 const cmsCommand = require('../commands/cms');
 const feedbackCommand = require('../commands/feedback');
 const doctorCommand = require('../commands/doctor');
+const completionCommand = require('../commands/completion');
 
 const notifier = updateNotifier({
   pkg: { ...pkg, name: '@hubspot/cli' },
@@ -226,10 +227,10 @@ const argv = yargs
   .command(sandboxesCommand)
   .command(feedbackCommand)
   .command(doctorCommand)
+  .command(completionCommand)
   .help()
   .recommendCommands()
   .demandCommand(1, '')
-  .completion()
   .wrap(getTerminalWidth())
   .strict().argv;
 

commands/completion.ts

@@ -0,0 +1,26 @@
+// @ts-nocheck
+const yargsParser = require('yargs-parser');
+const { i18n } = require('../lib/lang');
+const { trackCommandUsage } = require('../lib/usageTracking');
+
+const i18nKey = 'commands.completion';
+
+exports.command = 'completion';
+exports.describe = i18n(`${i18nKey}.describe`);
+
+exports.handler = async () => {
+  await trackCommandUsage('completion');
+};
+
+exports.builder = yargs => {
+  const { help } = yargsParser(process.argv.slice(2));
+
+  if (!help) {
+    yargs.completion();
+  }
+
+  yargs.example([
+    ['$0 completion >> ~/.zshrc', i18n(`${i18nKey}.examples.default`)],
+  ]);
+  return yargs;
+};

lang/en.lyaml

@@ -9,6 +9,10 @@ en:
       setDefaultAccountMoved: "This command has moved. Try `hs accounts use` instead"
       loadConfigMiddleware:
         configFileExists: "A configuration file already exists at {{ configPath }}. To specify a new configuration file, delete the existing one and try again."
+    completion:
+      describe: "Enable bash completion shortcuts for commands. Concat the generated script to your .bashrc, .bash_profile, or .zshrc file."
+      examples:
+        default: "Generate shell completion scripts for the zsh shell"
     accounts:
       describe: "Commands for working with accounts."
       subcommands:

package.json

@@ -26,7 +26,8 @@
     "table": "^6.6.0",
     "tmp": "^0.2.1",
     "update-notifier": "^5.1.0",
-    "yargs": "17.7.2"
+    "yargs": "17.7.2",
+    "yargs-parser": "^21.1.1"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",