akm-cli 0.1.0 → 0.1.1

package/dist/cli.js

@@ -3,6 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { defineCommand, runMain } from "citty";
 import { resolveStashDir } from "./common";
+import { generateBashCompletions, installBashCompletions } from "./completions";
 import { DEFAULT_CONFIG, getConfigPath, loadConfig, saveConfig } from "./config";
 import { getConfigValue, listConfig, setConfigValue, unsetConfigValue } from "./config-cli";
 import { ConfigError, NotFoundError, UsageError } from "./errors";
@@ -921,6 +922,38 @@ const hintsCommand = defineCommand({
         process.stdout.write(loadHints(detail));
     },
 });
+const completionsCommand = defineCommand({
+    meta: {
+        name: "completions",
+        description: "Generate or install shell completion script",
+    },
+    args: {
+        install: {
+            type: "boolean",
+            description: "Install completions to the appropriate directory",
+            default: false,
+        },
+        shell: {
+            type: "string",
+            description: "Shell type (bash)",
+            default: "bash",
+        },
+    },
+    run({ args }) {
+        if (args.shell !== "bash") {
+            throw new UsageError(`Unsupported shell: ${args.shell}. Only bash is supported.`);
+        }
+        const script = generateBashCompletions(main);
+        if (args.install) {
+            const dest = installBashCompletions(script);
+            console.error(`Completions installed to ${dest}`);
+            console.error(`Restart your shell or run:  source ${dest}`);
+        }
+        else {
+            process.stdout.write(script);
+        }
+    },
+});
 const main = defineCommand({
     meta: {
         name: "akm",
@@ -948,6 +981,7 @@ const main = defineCommand({
         registry: registryCommand,
         config: configCommand,
         hints: hintsCommand,
+        completions: completionsCommand,
     },
 });
 const CONFIG_SUBCOMMAND_SET = new Set(["path", "list", "get", "set", "unset"]);
@@ -1238,6 +1272,8 @@ akm kit                                       # Kit management (add, list, remov
 akm upgrade                                   # Upgrade akm binary
 akm upgrade --check                           # Check for updates
 akm hints                                     # Print this reference
+akm completions                               # Print bash completion script
+akm completions --install                     # Install completions
 \`\`\`
 
 ## Output Control

package/dist/completions.js

@@ -0,0 +1,137 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+// ── Known flag values ────────────────────────────────────────────────────────
+const FLAG_VALUES = {
+    "--format": ["json", "text", "yaml"],
+    "--detail": ["brief", "normal", "full"],
+    "--type": ["skill", "command", "agent", "knowledge", "script", "memory", "any"],
+    "--source": ["stash", "registry", "both"],
+    "--shell": ["bash"],
+};
+function walkCommandTree(cmd, parentPath = "") {
+    const name = cmd.meta?.name ?? "";
+    const currentPath = parentPath ? `${parentPath} ${name}` : name;
+    const result = [];
+    const subcommands = Object.keys(cmd.subCommands ?? {});
+    const flags = [];
+    if (cmd.args) {
+        for (const [flagName, arg] of Object.entries(cmd.args)) {
+            if (arg.type === "positional")
+                continue;
+            flags.push(`--${flagName}`);
+        }
+    }
+    result.push({ path: currentPath, subcommands, flags });
+    if (cmd.subCommands) {
+        for (const sub of Object.values(cmd.subCommands)) {
+            result.push(...walkCommandTree(sub, currentPath));
+        }
+    }
+    return result;
+}
+// ── Bash completion script generator ─────────────────────────────────────────
+export function generateBashCompletions(cmd) {
+    const commands = walkCommandTree(cmd);
+    const rootName = cmd.meta?.name ?? "akm";
+    // Collect global flags from root command
+    const rootInfo = commands.find((c) => c.path === rootName);
+    const globalFlags = rootInfo?.flags ?? [];
+    // Build the case blocks for subcommand completion
+    const caseBlocks = [];
+    for (const info of commands) {
+        const allFlags = [...new Set([...info.flags, ...globalFlags])];
+        if (info.subcommands.length > 0 || allFlags.length > 0) {
+            const matchPath = info.path;
+            const subcmdStr = info.subcommands.join(" ");
+            const flagStr = allFlags.join(" ");
+            caseBlocks.push(`      "${matchPath}")
+        if [[ "\${cur}" == -* ]]; then
+          COMPREPLY=( $(compgen -W "${flagStr}" -- "\${cur}") )
+        else
+          COMPREPLY=( $(compgen -W "${subcmdStr}" -- "\${cur}") )
+        fi
+        return 0
+        ;;`);
+        }
+    }
+    // Build flag-value completion cases
+    const valueCases = [];
+    for (const [flag, values] of Object.entries(FLAG_VALUES)) {
+        valueCases.push(`    ${flag})
+      COMPREPLY=( $(compgen -W "${values.join(" ")}" -- "\${cur}") )
+      return 0
+      ;;`);
+    }
+    const script = `#!/bin/bash
+# Bash completion for ${rootName}
+# Generated by ${rootName} completions
+
+_${rootName}() {
+  local cur prev words cword
+  if type _init_completion &>/dev/null; then
+    _init_completion || return
+  else
+    cur="\${COMP_WORDS[COMP_CWORD]}"
+    prev="\${COMP_WORDS[COMP_CWORD-1]}"
+    words=("\${COMP_WORDS[@]}")
+    cword=\${COMP_CWORD}
+  fi
+
+  # Complete flag values
+  case "\${prev}" in
+${valueCases.join("\n")}
+  esac
+
+  # Build the command path from COMP_WORDS
+  local cmd_path="${rootName}"
+  for (( i=1; i < cword; i++ )); do
+    case "\${words[i]}" in
+      -*) continue ;;
+      *) cmd_path="\${cmd_path} \${words[i]}" ;;
+    esac
+  done
+
+  # Complete based on current command path
+  case "\${cmd_path}" in
+${caseBlocks.join("\n")}
+  esac
+
+  return 0
+}
+
+complete -F _${rootName} ${rootName}
+`;
+    return script;
+}
+// ── Install ──────────────────────────────────────────────────────────────────
+export function installBashCompletions(script) {
+    const dest = resolveInstallPath();
+    const dir = path.dirname(dest);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(dest, script, "utf8");
+    return dest;
+}
+function resolveInstallPath() {
+    const xdgData = process.env.XDG_DATA_HOME?.trim();
+    if (xdgData) {
+        return path.join(xdgData, "bash-completion", "completions", "akm");
+    }
+    const home = os.homedir();
+    // Default XDG location
+    const defaultXdg = path.join(home, ".local", "share", "bash-completion", "completions", "akm");
+    const defaultXdgDir = path.dirname(defaultXdg);
+    if (isDir(defaultXdgDir) || isDir(path.dirname(defaultXdgDir))) {
+        return defaultXdg;
+    }
+    // Fallback
+    return path.join(home, ".bash_completion.d", "akm");
+}
+function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "CLI tool to search, open, and run extension assets from an akm stash directory.",
   "keywords": [