@odeva/cli 0.0.5 → 0.0.6

package/dist/commands/app/init.js

@@ -9,6 +9,7 @@ import { withErrorHandling } from "../../lib/run.js";
 import { isValidSlug, slugify } from "../../lib/slug.js";
 import { listTemplates, renderTemplate } from "../../lib/templates.js";
 import { ui } from "../../lib/ui.js";
+import { detectShell, isCompletionInstalled } from "../autocomplete.js";
 const DEFAULT_TEMPLATE = "hono-bun";
 class AppInit extends Command {
   static description = "Scaffold a new Odeva app";
@@ -68,17 +69,23 @@ class AppInit extends Command {
         }
       });
       spinner.stop(`Wrote ${filesWritten} file${filesWritten === 1 ? "" : "s"} from template '${template}'.`);
-      p.outro(
-        [
-          ui.ok(`Created ${ui.bold(displayName)}`),
+      const outroLines = [
+        ui.ok(`Created ${ui.bold(displayName)}`),
+        "",
+        "  Next steps:",
+        `    ${ui.code(`cd ${basename(directory)}`)}`,
+        `    ${ui.code("bun install")}`,
+        `    ${ui.code("odeva app config link")}    ${ui.dim("# register on Odeva")}`,
+        `    ${ui.code("odeva app dev")}             ${ui.dim("# start local dev with a tunnel")}`
+      ];
+      const shell = detectShell();
+      if (shell && !isCompletionInstalled(shell, "odeva")) {
+        outroLines.push(
           "",
-          "  Next steps:",
-          `    ${ui.code(`cd ${basename(directory)}`)}`,
-          `    ${ui.code("bun install")}`,
-          `    ${ui.code("odeva app config link")}    ${ui.dim("# register on Odeva")}`,
-          `    ${ui.code("odeva app dev")}             ${ui.dim("# start local dev with a tunnel")}`
-        ].join("\n")
-      );
+          `  ${ui.dim("Tip:")} ${ui.code("odeva autocomplete --install")} ${ui.dim("to enable tab-completion.")}`
+        );
+      }
+      p.outro(outroLines.join("\n"));
     });
   }
   async resolveDirectory(nameArg, skipPrompts) {

package/dist/commands/autocomplete.js

@@ -1,36 +1,90 @@
-import { Args, Command } from "@oclif/core";
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
 import { CliError } from "../lib/errors.js";
 import { withErrorHandling } from "../lib/run.js";
+import { ui } from "../lib/ui.js";
 const SUPPORTED_SHELLS = ["fish", "zsh"];
 class Autocomplete extends Command {
-  static description = "Print a shell completion script for the odeva CLI";
+  static description = "Print or install a shell completion script for the odeva CLI";
   static examples = [
-    "$ odeva autocomplete fish > ~/.config/fish/completions/odeva.fish",
-    "$ odeva autocomplete zsh > ~/.odeva/_odeva  # then source it from .zshrc"
+    "$ odeva autocomplete --install                                  # detect shell and install",
+    "$ odeva autocomplete fish --install                             # explicit shell",
+    "$ odeva autocomplete fish > ~/.config/fish/completions/odeva.fish"
   ];
   static args = {
     shell: Args.string({
-      description: "Target shell",
+      description: "Target shell (auto-detected from $SHELL when omitted with --install)",
       options: [...SUPPORTED_SHELLS],
-      required: true
+      required: false
+    })
+  };
+  static flags = {
+    install: Flags.boolean({
+      description: "Write the completion script to the conventional path for the shell",
+      default: false
     })
   };
   async run() {
-    const { args } = await this.parse(Autocomplete);
+    const { args, flags } = await this.parse(Autocomplete);
     await withErrorHandling(this, async () => {
-      const shell = args.shell;
-      if (!SUPPORTED_SHELLS.includes(shell)) {
-        throw new CliError(`Unsupported shell '${shell}'.`, {
-          hint: `Supported: ${SUPPORTED_SHELLS.join(", ")}.`
+      const bin = this.config.bin;
+      const shell = args.shell ?? (flags.install ? detectShell() : void 0);
+      if (!shell) {
+        if (flags.install) {
+          throw new CliError("Couldn't detect shell from $SHELL.", {
+            hint: `Pass it explicitly: \`${bin} autocomplete <${SUPPORTED_SHELLS.join("|")}> --install\`.`
+          });
+        }
+        throw new CliError("A shell is required.", {
+          hint: `Usage: \`${bin} autocomplete <${SUPPORTED_SHELLS.join("|")}>\`. Add --install to write the script to the conventional path.`
         });
       }
-      const bin = this.config.bin;
       const tree = buildCommandTree(this.config.commands, bin);
       const script = shell === "fish" ? renderFish(bin, tree) : renderZsh(bin, tree);
-      process.stdout.write(script);
+      if (!flags.install) {
+        process.stdout.write(script);
+        return;
+      }
+      const target = completionInstallPath(shell, bin);
+      mkdirSync(dirname(target), { recursive: true });
+      writeFileSync(target, script, { mode: 420 });
+      this.log(ui.ok(`Wrote ${shell} completion to ${ui.code(target)}`));
+      if (shell === "fish") {
+        this.log(ui.dim("  Open a new fish shell \u2014 completions auto-load from this path."));
+      } else {
+        const fpathDir = dirname(target);
+        this.log("");
+        this.log("  Add this to your ~/.zshrc (if you haven't already):");
+        this.log("");
+        this.log(ui.code(`    fpath=(${fpathDir} $fpath)`));
+        this.log(ui.code(`    autoload -U compinit && compinit`));
+        this.log("");
+        this.log(ui.dim("  Then open a new zsh shell."));
+      }
     });
   }
 }
+function detectShell(env = process.env) {
+  const shell = env["SHELL"];
+  if (!shell) return null;
+  const name = basename(shell);
+  if (name === "fish" || name === "zsh") return name;
+  return null;
+}
+function completionInstallPath(shell, bin, env = process.env) {
+  const home = env["HOME"] || homedir();
+  if (shell === "fish") {
+    const config = env["XDG_CONFIG_HOME"] || join(home, ".config");
+    return join(config, "fish", "completions", `${bin}.fish`);
+  }
+  const data = env["XDG_DATA_HOME"] || join(home, ".local", "share");
+  return join(data, bin, "completions", `_${bin}`);
+}
+function isCompletionInstalled(shell, bin, env = process.env) {
+  return existsSync(completionInstallPath(shell, bin, env));
+}
 function buildCommandTree(commands, binName) {
   const root = { name: "", description: "", children: /* @__PURE__ */ new Map() };
   for (const cmd of commands) {
@@ -152,7 +206,10 @@ _${bin} "$@"
 }
 export {
   buildCommandTree,
+  completionInstallPath,
   Autocomplete as default,
+  detectShell,
+  isCompletionInstalled,
   renderFish,
   renderZsh
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@odeva/cli",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Build apps on the Odeva booking platform — scaffold, develop, deploy.",
   "license": "MIT",
   "type": "module",