improve help text for --version, local flags

src/cli.mjs

@@ -1,5 +1,9 @@
 // @ts-check
 
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
 import chalk from "chalk";
 import yargs from "yargs";
 
@@ -27,6 +31,9 @@
 /** @type {import('yargs').Argv} */
 export let builtYargs;
 
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
 /**
  * @param {string|string[]} _argvInput - The command string provided by the user or test. Parsed by yargs into an argv object.
  * @param {cliContainer} _container - A built and ready for use awilix container with registered injectables.
@@ -116,9 +123,6 @@
     .completion(
       "completion",
       "Output bash/zsh script to enable shell completions. See command output for installation instructions.",
-    )
-    .completion(
-      "completion",
       async function (currentWord, argv, defaultCompletions, done) {
         // this is pretty hard to debug - if you need to, run
         // `fauna --get-yargs-completions <command> <flag> <string to match>`
@@ -137,7 +141,7 @@
           .filter((key) => previousWord === key)
           .pop();
 
         // TODO: this doesn't handle aliasing, and it needs to
         if (
           currentWord === "--profile" ||
           currentWordFlag === "profile" ||
@@ -214,5 +218,13 @@
     .alias("help", "h")
     .fail(false)
     .exitProcess(false)
-    .version();
+    .version(
+      "version",
+      "Show the fauna CLI version.",
+      JSON.parse(
+        fs.readFileSync(path.join(__dirname, "../package.json"), {
+          encoding: "utf8",
+        }),
+      ).version,
+    );
 }

src/commands/local.mjs

@@ -123,7 +123,7 @@ function buildLocalCommand(yargs) {
         default: 100,
       },
       name: {
-        describe: "The name to give the container",
+        describe: "The name to give the container.",
         type: "string",
         default: "faunadb",
       },
@@ -183,7 +183,7 @@ function buildLocalCommand(yargs) {
 
 export default {
   command: "local",
-  describe: "Start a local Fauna container",
+  describe: "Start a local Fauna container.",
   builder: buildLocalCommand,
   handler: startLocal,
 };