@hypercli/cli 0.1.1

package/dist/autocomplete/completions/shared.js

@@ -0,0 +1,89 @@
+/**
+ * Base class for shell completion script generators.
+ * Contains shared logic for extracting commands and topics from oclif config.
+ */
+export class CompletionScriptBase {
+    config;
+    commands;
+    topics;
+    _coTopics;
+    constructor(config) {
+        this.config = config;
+        this.topics = this.getTopics();
+        this.commands = this.getCommands();
+    }
+    get coTopics() {
+        if (this._coTopics)
+            return this._coTopics;
+        const coTopics = [];
+        for (const topic of this.topics) {
+            for (const cmd of this.commands) {
+                if (topic.name === cmd.id) {
+                    coTopics.push(topic.name);
+                }
+            }
+        }
+        this._coTopics = coTopics;
+        return this._coTopics;
+    }
+    getCommands() {
+        const cmds = [];
+        for (const p of this.config.getPluginsList()) {
+            for (const c of p.commands) {
+                if (c.hidden)
+                    continue;
+                const summary = this.sanitizeSummary(c.summary ?? c.description);
+                const { flags } = c;
+                cmds.push({
+                    flags: flags,
+                    id: c.id,
+                    summary,
+                });
+                for (const a of c.aliases) {
+                    cmds.push({
+                        flags: flags,
+                        id: a,
+                        summary,
+                    });
+                    const split = a.split(":");
+                    let topic = split[0];
+                    for (let i = 0; i < split.length - 1; i++) {
+                        if (!this.topics.some((t) => t.name === topic)) {
+                            this.topics.push({
+                                description: `${topic.replaceAll(":", " ")} commands`,
+                                name: topic,
+                            });
+                        }
+                        topic += `:${split[i + 1]}`;
+                    }
+                }
+            }
+        }
+        return cmds;
+    }
+    getTopics() {
+        const topics = this.config.topics
+            .filter((topic) => {
+            const hasChild = this.config.topics.some((subTopic) => subTopic.name.includes(`${topic.name}:`));
+            return hasChild;
+        })
+            .sort((a, b) => {
+            if (a.name < b.name)
+                return -1;
+            if (a.name > b.name)
+                return 1;
+            return 0;
+        })
+            .map((t) => {
+            const description = t.description
+                ? this.sanitizeSummary(t.description)
+                : `${t.name.replaceAll(":", " ")} commands`;
+            return {
+                description,
+                name: t.name,
+            };
+        });
+        return topics;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/autocomplete/completions/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/autocomplete/completions/shared.ts"],"names":[],"mappings":"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"}

package/dist/autocomplete/completions/types.d.ts

@@ -0,0 +1,20 @@
+export interface CommandCompletion {
+    id: string;
+    summary: string;
+    flags: Record<string, FlagCompletion>;
+}
+export interface FlagCompletion {
+    name: string;
+    type: "option" | "boolean";
+    summary?: string;
+    description?: string;
+    char?: string;
+    multiple?: boolean;
+    options?: string[];
+    hidden?: boolean;
+}
+export interface TopicCompletion {
+    name: string;
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/autocomplete/completions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/autocomplete/completions/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB"}

package/dist/autocomplete/completions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/autocomplete/completions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/autocomplete/completions/types.ts"],"names":[],"mappings":""}

package/dist/autocomplete/completions/zsh.d.ts

@@ -0,0 +1,15 @@
+import { CompletionScriptBase } from "./shared.js";
+import type { FlagCompletion } from "./types.js";
+export default class ZshCompWithSpaces extends CompletionScriptBase {
+    generate(): string;
+    genZshFlagArgumentsBlock(flags: Record<string, FlagCompletion> | undefined, options?: {
+        skipFiles?: boolean;
+    }): string;
+    genZshTopicCompFun(id: string): string;
+    genZshValuesBlock(subArgs: {
+        id: string;
+        summary: string;
+    }[]): string;
+    sanitizeSummary(summary: string | undefined): string;
+}
+//# sourceMappingURL=zsh.d.ts.map

package/dist/autocomplete/completions/zsh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.d.ts","sourceRoot":"","sources":["../../../src/autocomplete/completions/zsh.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,oBAAoB;IAClE,QAAQ,IAAI,MAAM;IA4FlB,wBAAwB,CACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,SAAS,EACjD,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,MAAM;IAqDT,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IA4ItC,iBAAiB,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,MAAM;IASrE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;CAWpD"}

package/dist/autocomplete/completions/zsh.js

@@ -0,0 +1,276 @@
+import { format } from "node:util";
+import { CompletionScriptBase } from "./shared.js";
+const argTemplate = '        "%s")\n          %s\n        ;;\n';
+export default class ZshCompWithSpaces extends CompletionScriptBase {
+    generate() {
+        const firstArgs = [];
+        for (const t of this.topics) {
+            if (!t.name.includes(":"))
+                firstArgs.push({
+                    id: t.name,
+                    summary: t.description,
+                });
+        }
+        for (const c of this.commands) {
+            if (!firstArgs.some((a) => a.id === c.id) && !c.id.includes(":"))
+                firstArgs.push({
+                    id: c.id,
+                    summary: c.summary,
+                });
+        }
+        const mainArgsCaseBlock = () => {
+            let caseBlock = "case $line[1] in\n";
+            for (const arg of firstArgs) {
+                if (this.coTopics.includes(arg.id)) {
+                    caseBlock += `${arg.id})\n  _${this.config.bin}_${arg.id}\n  ;;\n`;
+                }
+                else {
+                    const cmd = this.commands.find((c) => c.id === arg.id);
+                    if (cmd) {
+                        if (Object.keys(cmd.flags).length > 0) {
+                            caseBlock += `${arg.id})\n${this.genZshFlagArgumentsBlock(cmd.flags)} ;; \n`;
+                        }
+                    }
+                    else {
+                        caseBlock += `${arg.id})\n  _${this.config.bin}_${arg.id}\n  ;;\n`;
+                    }
+                }
+            }
+            caseBlock += `*)\n  _${this.config.bin}_dynamic \${words[@]:1}\n  ;;\n`;
+            caseBlock += "esac\n";
+            return caseBlock;
+        };
+        return `#compdef ${this.config.bin}
+${this.config.binAliases?.map((a) => `compdef ${a}=${this.config.bin}`).join("\n") ?? ""}
+
+# Dynamic completion helper - calls ${this.config.bin} autocomplete generate for kit/cookbook/recipe completion
+# Output format: "name\tdescription" or just "name" per line
+_${this.config.bin}_dynamic() {
+  local -a completions
+  local output
+  output=$(${this.config.bin} autocomplete generate -- "$@" 2>/dev/null)
+  if [[ -n "$output" ]]; then
+    while IFS= read -r line; do
+      [[ -z "$line" ]] && continue
+      # Convert "name\tdescription" to "name:description" for _describe
+      if [[ "$line" == *$'\t'* ]]; then
+        local name="\${line%%	*}"
+        local desc="\${line#*	}"
+        completions+=("\${name}:\${desc}")
+      else
+        completions+=("\${line}")
+      fi
+    done <<< "$output"
+    _describe "completions" completions
+    return 0
+  fi
+  return 1
+}
+
+${this.topics.map((t) => this.genZshTopicCompFun(t.name)).join("\n")}
+
+_${this.config.bin}() {
+  local context state state_descr line
+  typeset -A opt_args
+
+  _arguments -C "1: :->cmds" "*::arg:->args"
+
+  case "$state" in
+    cmds)
+      ${this.genZshValuesBlock(firstArgs)}
+      _${this.config.bin}_dynamic \${words[@]:1}
+    ;;
+    args)
+      ${mainArgsCaseBlock()}
+    ;;
+  esac
+}
+
+_${this.config.bin}
+`;
+    }
+    genZshFlagArgumentsBlock(flags, options) {
+        if (!flags) {
+            const filesSpec = options?.skipFiles ? "" : ' "*: :_files';
+            return `_arguments -S \\\n --help"[Show help for command]"${filesSpec}`;
+        }
+        const flagNames = Object.keys(flags);
+        let argumentsBlock = "_arguments -S \\\n";
+        for (const flagName of flagNames) {
+            const f = flags[flagName];
+            if (f.hidden)
+                continue;
+            const flagSummary = this.sanitizeSummary(f.summary ?? f.description);
+            let flagSpec = "";
+            if (f.type === "option") {
+                if (f.char) {
+                    if (f.multiple) {
+                        flagSpec += `"*"{-${f.char},--${f.name}}`;
+                    }
+                    else {
+                        flagSpec += `"(-${f.char} --${f.name})"{-${f.char},--${f.name}}`;
+                    }
+                    flagSpec += `"[${flagSummary}]`;
+                    flagSpec += f.options ? `:${f.name} options:(${f.options?.join(" ")})"` : ':file:_files"';
+                }
+                else {
+                    if (f.multiple) {
+                        flagSpec += '"*"';
+                    }
+                    flagSpec += `--${f.name}"[${flagSummary}]:`;
+                    flagSpec += f.options ? `${f.name} options:(${f.options.join(" ")})"` : 'file:_files"';
+                }
+            }
+            else if (f.char) {
+                flagSpec += `"(-${f.char} --${f.name})"{-${f.char},--${f.name}}"[${flagSummary}]"`;
+            }
+            else {
+                flagSpec += `--${f.name}"[${flagSummary}]"`;
+            }
+            flagSpec += " \\\n";
+            argumentsBlock += flagSpec;
+        }
+        argumentsBlock += '--help"[Show help for command]"';
+        if (!options?.skipFiles) {
+            argumentsBlock += ' \\\n"*: :_files"';
+        }
+        return argumentsBlock;
+    }
+    genZshTopicCompFun(id) {
+        const coTopics = [];
+        for (const topic of this.topics) {
+            for (const cmd of this.commands) {
+                if (topic.name === cmd.id) {
+                    coTopics.push(topic.name);
+                }
+            }
+        }
+        const flagArgsTemplate = '        "%s")\n          %s\n        ;;\n';
+        const dynamicBin = `_${this.config.bin}_dynamic`;
+        const underscoreSepId = id.replaceAll(":", "_");
+        const depth = id.split(":").length;
+        const isCotopic = coTopics.includes(id);
+        if (isCotopic) {
+            const compFuncName = `${this.config.bin}_${underscoreSepId}`;
+            const coTopicCompFunc = `_${compFuncName}() {
+  _${compFuncName}_flags() {
+    local context state state_descr line
+    typeset -A opt_args
+
+    ${this.genZshFlagArgumentsBlock(this.commands.find((c) => c.id === id)?.flags)}
+  }
+
+  local context state state_descr line
+  typeset -A opt_args
+
+  _arguments -C "1: :->cmds" "*: :->args"
+
+  case "$state" in
+    cmds)
+      if [[ "\${words[CURRENT]}" == -* ]]; then
+        _${compFuncName}_flags
+      else
+%s
+      fi
+      ;;
+    args)
+      case $line[1] in
+%s
+      *)
+        _${compFuncName}_flags
+        _${this.config.bin}_dynamic ${id.replaceAll(":", " ")} $line[1] \${words[CURRENT]}
+      ;;
+      esac
+      ;;
+  esac
+}
+`;
+            const subArgs = [];
+            let argsBlock = "";
+            for (const t of this.topics.filter((t) => t.name.startsWith(`${id}:`) && t.name.split(":").length === depth + 1)) {
+                const subArg = t.name.split(":")[depth];
+                subArgs.push({
+                    id: subArg,
+                    summary: t.description,
+                });
+                argsBlock += format(argTemplate, subArg, `_${this.config.bin}_${underscoreSepId}_${subArg}`);
+            }
+            for (const c of this.commands.filter((c) => c.id.startsWith(`${id}:`) && c.id.split(":").length === depth + 1)) {
+                if (coTopics.includes(c.id))
+                    continue;
+                const subArg = c.id.split(":")[depth];
+                subArgs.push({
+                    id: subArg,
+                    summary: c.summary,
+                });
+                const flagsBlock = this.genZshFlagArgumentsBlock(c.flags, { skipFiles: true });
+                const dynamicCall = `${dynamicBin} ${id.replaceAll(":", " ")} ${subArg} \${words[CURRENT]}`;
+                argsBlock += format(flagArgsTemplate, subArg, `${flagsBlock}\n          ${dynamicCall}`);
+            }
+            return format(coTopicCompFunc, this.genZshValuesBlock(subArgs), argsBlock);
+        }
+        let argsBlock = "";
+        const subArgs = [];
+        for (const t of this.topics.filter((t) => t.name.startsWith(`${id}:`) && t.name.split(":").length === depth + 1)) {
+            const subArg = t.name.split(":")[depth];
+            subArgs.push({
+                id: subArg,
+                summary: t.description,
+            });
+            argsBlock += format(argTemplate, subArg, `_${this.config.bin}_${underscoreSepId}_${subArg}`);
+        }
+        for (const c of this.commands.filter((c) => c.id.startsWith(`${id}:`) && c.id.split(":").length === depth + 1)) {
+            if (coTopics.includes(c.id))
+                continue;
+            const subArg = c.id.split(":")[depth];
+            subArgs.push({
+                id: subArg,
+                summary: c.summary,
+            });
+            const flagsBlock = this.genZshFlagArgumentsBlock(c.flags, { skipFiles: true });
+            const dynamicCall = `${dynamicBin} ${id.replaceAll(":", " ")} ${subArg} \${words[CURRENT]}`;
+            argsBlock += format(flagArgsTemplate, subArg, `${flagsBlock}\n          ${dynamicCall}`);
+        }
+        const topicCompFunc = `_${this.config.bin}_${underscoreSepId}() {
+  local context state state_descr line
+  typeset -A opt_args
+
+  _arguments -C "1: :->cmds" "*::arg:->args"
+
+  case "$state" in
+    cmds)
+%s
+      _${this.config.bin}_dynamic ${id.replaceAll(":", " ")} \${words[CURRENT]}
+      ;;
+    args)
+      case $line[1] in
+%s
+      *)
+        _${this.config.bin}_dynamic ${id.replaceAll(":", " ")} $line[1] \${words[CURRENT]}
+      ;;
+      esac
+      ;;
+  esac
+}
+`;
+        return format(topicCompFunc, this.genZshValuesBlock(subArgs), argsBlock);
+    }
+    genZshValuesBlock(subArgs) {
+        let valuesBlock = '_values "completions" \\\n';
+        for (const subArg of subArgs) {
+            valuesBlock += `"${subArg.id}[${subArg.summary}]" \\\n`;
+        }
+        return valuesBlock;
+    }
+    sanitizeSummary(summary) {
+        if (summary === undefined) {
+            return "";
+        }
+        return summary
+            .replace(/<%= config\.bin %>/g, this.config.bin)
+            .replaceAll(/(["`])/g, "\\\\\\$1")
+            .replaceAll(/([[\]])/g, "\\\\$1")
+            .split("\n")[0];
+    }
+}
+//# sourceMappingURL=zsh.js.map

package/dist/autocomplete/completions/zsh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh.js","sourceRoot":"","sources":["../../../src/autocomplete/completions/zsh.ts"],"names":[],"mappings":"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"}

package/dist/autocomplete/dynamic/cache.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Dynamic Cache Manager
+ *
+ * Scans installed kits and builds a JSON cache of all completable
+ * kit/cookbook/recipe/variable paths. The cache is invalidated when
+ * the kit manifest is newer than the cache file.
+ */
+import type { DynamicCache } from "./types.js";
+export declare class DynamicCacheManager {
+    private readonly cacheDir;
+    private readonly projectRoot;
+    private readonly cachePath;
+    private readonly manifestPath;
+    constructor(cacheDir: string, projectRoot: string);
+    /**
+     * Load the cache from disk. Returns null if the cache file is missing
+     * or stale (manifest.json has been modified more recently).
+     */
+    load(): DynamicCache | null;
+    /**
+     * Rebuild the cache by scanning all installed kits, their cookbooks,
+     * recipes, and recipe variables.
+     */
+    rebuild(): Promise<DynamicCache>;
+    /**
+     * Extract the description from a recipe.yml file.
+     */
+    private extractRecipeDescription;
+    /**
+     * Extract variable definitions from a recipe.yml file.
+     * Reads only the `variables` section to avoid loading the full recipe engine.
+     */
+    private extractVariables;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/autocomplete/dynamic/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/autocomplete/dynamic/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAMnE,qBAAa,mBAAmB;IAK9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAL7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGpB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM;IAMrC;;;OAGG;IACH,IAAI,IAAI,YAAY,GAAG,IAAI;IA2B3B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IA0DtC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CA4CxB"}

package/dist/autocomplete/dynamic/cache.js

@@ -0,0 +1,163 @@
+/**
+ * Dynamic Cache Manager
+ *
+ * Scans installed kits and builds a JSON cache of all completable
+ * kit/cookbook/recipe/variable paths. The cache is invalidated when
+ * the kit manifest is newer than the cache file.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { discoverCookbooksInKit, discoverKits, discoverRecipesInCookbook, getDefaultKitSearchDirs, } from "@hypercli/core";
+import createDebug from "debug";
+import yaml from "js-yaml";
+const debug = createDebug("hypercli:autocomplete:cache");
+const CACHE_FILENAME = "dynamic-cache.json";
+export class DynamicCacheManager {
+    cacheDir;
+    projectRoot;
+    cachePath;
+    manifestPath;
+    constructor(cacheDir, projectRoot) {
+        this.cacheDir = cacheDir;
+        this.projectRoot = projectRoot;
+        this.cachePath = path.join(cacheDir, CACHE_FILENAME);
+        this.manifestPath = path.join(projectRoot, ".hyper", "kits", "manifest.json");
+    }
+    /**
+     * Load the cache from disk. Returns null if the cache file is missing
+     * or stale (manifest.json has been modified more recently).
+     */
+    load() {
+        if (!fs.existsSync(this.cachePath)) {
+            debug("Cache file not found: %s", this.cachePath);
+            return null;
+        }
+        // Staleness check: if manifest.json exists and is newer than cache, invalidate
+        if (fs.existsSync(this.manifestPath)) {
+            const manifestMtime = fs.statSync(this.manifestPath).mtimeMs;
+            const cacheMtime = fs.statSync(this.cachePath).mtimeMs;
+            if (manifestMtime > cacheMtime) {
+                debug("Cache is stale (manifest newer than cache)");
+                return null;
+            }
+        }
+        try {
+            const raw = fs.readFileSync(this.cachePath, "utf-8");
+            const cache = JSON.parse(raw);
+            debug("Loaded cache built at %s with %d kits", cache.builtAt, cache.kits.length);
+            return cache;
+        }
+        catch (err) {
+            debug("Failed to read/parse cache: %s", err);
+            return null;
+        }
+    }
+    /**
+     * Rebuild the cache by scanning all installed kits, their cookbooks,
+     * recipes, and recipe variables.
+     */
+    async rebuild() {
+        debug("Rebuilding dynamic cache for project: %s", this.projectRoot);
+        const searchDirs = getDefaultKitSearchDirs(this.projectRoot);
+        const kitsMap = await discoverKits(searchDirs);
+        const cache = {
+            builtAt: new Date().toISOString(),
+            kits: [],
+            cookbooks: {},
+            recipes: {},
+            variables: {},
+        };
+        for (const [kitName, parsedKit] of kitsMap) {
+            cache.kits.push({
+                name: kitName,
+                description: parsedKit.config.description,
+            });
+            cache.cookbooks[kitName] = [];
+            const cookbookGlobs = parsedKit.config.cookbooks ?? ["./cookbooks/*/cookbook.yml"];
+            const cookbooksMap = await discoverCookbooksInKit(parsedKit.dirPath, cookbookGlobs);
+            for (const [cookbookName, parsedCookbook] of cookbooksMap) {
+                cache.cookbooks[kitName].push({
+                    name: cookbookName,
+                    description: parsedCookbook.config.description,
+                });
+                const recipeKey = `${kitName}:${cookbookName}`;
+                cache.recipes[recipeKey] = [];
+                const recipeGlobs = parsedCookbook.config.recipes ?? ["./*/recipe.yml"];
+                const recipesMap = await discoverRecipesInCookbook(parsedCookbook.dirPath, recipeGlobs);
+                for (const [recipeName, recipeYmlPath] of recipesMap) {
+                    const vars = this.extractVariables(recipeYmlPath);
+                    const recipeDesc = this.extractRecipeDescription(recipeYmlPath);
+                    cache.recipes[recipeKey].push({
+                        name: recipeName,
+                        description: recipeDesc,
+                    });
+                    const varKey = `${kitName}:${cookbookName}:${recipeName}`;
+                    cache.variables[varKey] = vars;
+                }
+            }
+        }
+        // Ensure cache directory exists and write
+        fs.mkdirSync(this.cacheDir, { recursive: true });
+        fs.writeFileSync(this.cachePath, JSON.stringify(cache, null, 2), "utf-8");
+        debug("Cache rebuilt: %d kits, written to %s", cache.kits.length, this.cachePath);
+        return cache;
+    }
+    /**
+     * Extract the description from a recipe.yml file.
+     */
+    extractRecipeDescription(recipeYmlPath) {
+        try {
+            const content = fs.readFileSync(recipeYmlPath, "utf-8");
+            const parsed = yaml.load(content);
+            if (parsed && typeof parsed === "object" && typeof parsed.description === "string") {
+                return parsed.description;
+            }
+        }
+        catch {
+            // Ignore parse errors — some recipe files have Jig templates in YAML
+        }
+        return undefined;
+    }
+    /**
+     * Extract variable definitions from a recipe.yml file.
+     * Reads only the `variables` section to avoid loading the full recipe engine.
+     */
+    extractVariables(recipeYmlPath) {
+        try {
+            const content = fs.readFileSync(recipeYmlPath, "utf-8");
+            const parsed = yaml.load(content);
+            if (!parsed || typeof parsed !== "object" || !parsed.variables) {
+                return [];
+            }
+            const vars = parsed.variables;
+            const completions = [];
+            for (const [name, def] of Object.entries(vars)) {
+                if (!def || typeof def !== "object")
+                    continue;
+                const completion = {
+                    name,
+                    type: typeof def.type === "string" ? def.type : "string",
+                };
+                if (typeof def.description === "string") {
+                    completion.description = def.description;
+                }
+                if (!completion.description && typeof def.prompt === "string") {
+                    completion.description = def.prompt;
+                }
+                if (Array.isArray(def.values)) {
+                    completion.values = def.values.map(String);
+                }
+                if (typeof def.position === "number") {
+                    completion.position = def.position;
+                }
+                completions.push(completion);
+            }
+            return completions;
+        }
+        catch (err) {
+            debug("Failed to extract variables from %s: %s", recipeYmlPath, err);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/autocomplete/dynamic/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/autocomplete/dynamic/cache.ts"],"names":[],"mappings":"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"}