@hypercli/gen 0.1.1

package/dist/template-engines/jig-engine.js

@@ -0,0 +1,173 @@
+/**
+ * Jig Template Engine
+ *
+ * Singleton module wrapping @jig-lang/jig (forked from Edge.js).
+ * Jig is purpose-built for code generation: no HTML escaping,
+ * automatic indentation management, full JS expressions in templates,
+ * and `{{ filter :: value }}` syntax.
+ */
+import { helpers } from "@hypercli/core";
+import { Edge } from "@jig-lang/jig";
+import createDebug from "debug";
+import { AiCollector } from "#ai/ai-collector";
+import { registerAiTags } from "./ai-tags.js";
+const debug = createDebug("hypergen:template:jig");
+let jig = null;
+/**
+ * Track registered globals for collision warnings.
+ * Maps global name -> source string (e.g. "kit:@kit/nextjs").
+ */
+const registeredGlobals = new Map();
+/**
+ * Get the Jig (Edge) instance, creating it if needed.
+ */
+export function getJig() {
+    if (!jig) {
+        initializeJig();
+    }
+    return jig;
+}
+/**
+ * Initialize (or reinitialize) the Jig template engine.
+ */
+export function initializeJig(config) {
+    jig = Edge.create({ cache: config?.cache ?? false });
+    registeredGlobals.clear();
+    registerFilters(jig);
+    registerAi2PassTags(jig);
+    debug("Jig template engine initialized (cache=%s)", config?.cache ?? false);
+}
+/**
+ * Render a template string with the given context.
+ */
+export async function renderTemplate(template, context) {
+    const engine = getJig();
+    try {
+        return await engine.renderRaw(template, context);
+    }
+    catch (error) {
+        throw new Error(`Jig template rendering failed: ${error.message}`);
+    }
+}
+/**
+ * Render a template string synchronously.
+ */
+export function renderTemplateSync(template, context) {
+    const engine = getJig();
+    try {
+        return engine.renderRawSync(template, context);
+    }
+    catch (error) {
+        throw new Error(`Jig template rendering failed: ${error.message}`);
+    }
+}
+/**
+ * Render a template file with the given context.
+ * The templateName is resolved against mounted disk paths.
+ */
+export async function renderFile(templateName, context) {
+    const engine = getJig();
+    try {
+        return await engine.render(templateName, context);
+    }
+    catch (error) {
+        throw new Error(`Jig file rendering failed (${templateName}): ${error.message}`);
+    }
+}
+/**
+ * Mount a directory so Jig can resolve template files from it.
+ */
+export function mountDirectory(dirPath, diskName) {
+    const engine = getJig();
+    if (diskName) {
+        engine.mount(diskName, dirPath);
+    }
+    else {
+        engine.mount(dirPath);
+    }
+    debug("Mounted directory: %s%s", dirPath, diskName ? ` as "${diskName}"` : "");
+}
+// ─── Filter Registration ──────────────────────────────────────────────
+function registerFilters(edge) {
+    const { changeCase, inflection } = helpers;
+    // Case filters — use the change-case library for correctness
+    const caseFilters = {
+        camelCase: (v) => changeCase.camelCase(v),
+        pascalCase: (v) => changeCase.pascalCase(v),
+        snakeCase: (v) => changeCase.snakeCase(v),
+        kebabCase: (v) => changeCase.paramCase(v),
+        constantCase: (v) => changeCase.constantCase(v),
+        dotCase: (v) => changeCase.dotCase(v),
+        pathCase: (v) => changeCase.pathCase(v),
+        paramCase: (v) => changeCase.paramCase(v),
+    };
+    // Inflection filters
+    const inflectionFilters = {
+        pluralize: (v) => inflection.pluralize(v),
+        singularize: (v) => inflection.singularize(v),
+    };
+    // String filters
+    const stringFilters = {
+        capitalize: (v) => helpers.capitalize(v),
+        titleize: (v) => inflection.titleize(v),
+        humanize: (v) => inflection.humanize(v),
+    };
+    const allFilters = { ...caseFilters, ...inflectionFilters, ...stringFilters };
+    for (const [name, fn] of Object.entries(allFilters)) {
+        // Register as filter: {{ name :: camelCase }}
+        edge.registerFilter(name, (input) => fn(String(input)));
+        // Register as global so {{ camelCase(name) }} also works
+        edge.global(name, (input) => fn(String(input)));
+    }
+    debug("Registered %d filters + globals", Object.keys(allFilters).length);
+}
+// ─── Helper Registration ──────────────────────────────────────────────
+/**
+ * Register helper functions as Jig globals.
+ * Warns on collision (last registration wins).
+ *
+ * @param helpers  Record of name -> function
+ * @param source   Human-readable source identifier for collision warnings
+ */
+export function registerHelpers(helpers, source) {
+    const engine = getJig();
+    for (const [name, value] of Object.entries(helpers)) {
+        if (typeof value === "function") {
+            if (registeredGlobals.has(name)) {
+                const existingSource = registeredGlobals.get(name);
+                console.warn(`Warning: Helper "${name}" from ${source ?? "unknown"} overwrites existing helper from ${existingSource}`);
+            }
+            engine.global(name, value);
+            registeredGlobals.set(name, source ?? "unknown");
+        }
+    }
+    debug("Registered %d helpers from %s", Object.keys(helpers).length, source ?? "unknown");
+}
+// ─── AI Tags (2-Pass System) ──────────────────────────────────────────
+function registerAi2PassTags(edge) {
+    try {
+        // Register @ai, @context, @prompt, @output tags
+        registerAiTags(edge);
+        // Register global runtime helpers that compiled tag code calls
+        const collector = AiCollector.getInstance();
+        edge.global("__hypergenAiCollect", (key, contexts, prompt, outputDesc, typeHint, examples, sourceFile) => {
+            collector.addEntry({
+                key,
+                contexts: contexts.filter((c) => c.trim()),
+                prompt: prompt.trim(),
+                outputDescription: outputDesc.trim(),
+                typeHint: typeHint || "",
+                examples: (examples || []).filter((e) => e.trim()).map((e) => e.trim()),
+                sourceFile: sourceFile || "unknown",
+            });
+        });
+        edge.global("__hypergenAddGlobalContext", (text) => {
+            collector.addGlobalContext(text);
+        });
+        debug("AI 2-pass tags registered");
+    }
+    catch (err) {
+        debug("@ai 2-pass tag registration failed: %s", err instanceof Error ? err.message : String(err));
+    }
+}
+//# sourceMappingURL=jig-engine.js.map

package/dist/template-engines/jig-engine.js.map

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

package/dist/utils/coerce-value.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Coerce a CLI string value to its most likely native type.
+ * Converts boolean-like strings (true/false/yes/no/1/0) to booleans
+ * and numeric strings to numbers.
+ */
+export declare function coerceValue(value: string): unknown;
+//# sourceMappingURL=coerce-value.d.ts.map

package/dist/utils/coerce-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce-value.d.ts","sourceRoot":"","sources":["../../src/utils/coerce-value.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQlD"}

package/dist/utils/coerce-value.js

@@ -0,0 +1,18 @@
+const BOOLEAN_TRUE = new Set(["true", "1", "yes"]);
+const BOOLEAN_FALSE = new Set(["false", "0", "no"]);
+/**
+ * Coerce a CLI string value to its most likely native type.
+ * Converts boolean-like strings (true/false/yes/no/1/0) to booleans
+ * and numeric strings to numbers.
+ */
+export function coerceValue(value) {
+    const lower = value.toLowerCase();
+    if (BOOLEAN_TRUE.has(lower))
+        return true;
+    if (BOOLEAN_FALSE.has(lower))
+        return false;
+    if (value !== "" && !Number.isNaN(Number(value)))
+        return Number(value);
+    return value;
+}
+//# sourceMappingURL=coerce-value.js.map

package/dist/utils/coerce-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce-value.js","sourceRoot":"","sources":["../../src/utils/coerce-value.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACnD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3C,IAAI,KAAK,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/utils/diff.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generate a colored unified diff between two strings.
+ */
+export declare function formatDiff(oldContent: string, newContent: string, options?: {
+    oldLabel?: string;
+    newLabel?: string;
+}): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/utils/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,UAAU,CACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,MAAM,CAIR"}

package/dist/utils/diff.js

@@ -0,0 +1,10 @@
+import disparity from "disparity";
+/**
+ * Generate a colored unified diff between two strings.
+ */
+export function formatDiff(oldContent, newContent, options) {
+    return disparity.unified(oldContent, newContent, {
+        paths: [options?.oldLabel ?? "existing", options?.newLabel ?? "incoming"],
+    });
+}
+//# sourceMappingURL=diff.js.map

package/dist/utils/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,UAAU,CACzB,UAAkB,EAClB,UAAkB,EAClB,OAAkD;IAElD,OAAO,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE;QAChD,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,OAAO,EAAE,QAAQ,IAAI,UAAU,CAAC;KACzE,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/global-packages.d.ts

@@ -0,0 +1,11 @@
+export interface GlobalPackage {
+    name: string;
+    path: string;
+}
+/**
+ * Get list of globally installed packages using the current engine's package manager.
+ * - If running in Bun, queries `bun pm ls -g`
+ * - Otherwise (Node), queries `npm list -g`
+ */
+export declare function getGlobalPackages(): Promise<GlobalPackage[]>;
+//# sourceMappingURL=global-packages.d.ts.map

package/dist/utils/global-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-packages.d.ts","sourceRoot":"","sources":["../../src/utils/global-packages.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAOlE"}

package/dist/utils/global-packages.js

@@ -0,0 +1,88 @@
+import { exec } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+import createDebug from "debug";
+const debug = createDebug("hypergen:utils:global-packages");
+const execAsync = promisify(exec);
+/**
+ * Get list of globally installed packages using the current engine's package manager.
+ * - If running in Bun, queries `bun pm ls -g`
+ * - Otherwise (Node), queries `npm list -g`
+ */
+export async function getGlobalPackages() {
+    const isBun = !!process.versions.bun;
+    if (isBun) {
+        return getBunGlobalPackages();
+    }
+    return getNpmGlobalPackages();
+}
+async function getNpmGlobalPackages() {
+    try {
+        // Get the global root first, as npm list json doesn't always include full paths for top level
+        const { stdout: rootStdout } = await execAsync("npm root -g");
+        const globalRoot = rootStdout.trim();
+        // Get the list in JSON format
+        const { stdout: listStdout } = await execAsync("npm list -g --depth=0 --json");
+        const list = JSON.parse(listStdout);
+        if (!list.dependencies)
+            return [];
+        return Object.keys(list.dependencies).map((name) => ({
+            name,
+            path: path.join(globalRoot, name),
+        }));
+    }
+    catch (error) {
+        debug("Failed to get npm global packages: %s", error);
+        return [];
+    }
+}
+async function getBunGlobalPackages() {
+    try {
+        // Bun doesn't output JSON for ls yet, need to parse text
+        // Output format:
+        // /path/to/global/install node_modules (count)
+        // ├── package@version
+        // └── package@version
+        const { stdout } = await execAsync("bun pm ls -g");
+        const lines = stdout.split("\n");
+        if (lines.length === 0)
+            return [];
+        // First line contains the root.
+        // Example: "/Users/user/.cache/.bun/install/global node_modules (1478)"
+        // We want the path part before " node_modules".
+        const firstLine = lines[0];
+        // Split by " node_modules" -> ["/Users/.../global", " (1478)"]
+        const rootPathPart = firstLine.split(" node_modules")[0];
+        // Based on `bun pm bin -g` vs `ls` observation, the packages are inside `node_modules` in that root
+        const globalRoot = path.join(rootPathPart.trim(), "node_modules");
+        const packages = [];
+        // Parse subsequent lines
+        for (let i = 1; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            // Lines start with ├── or └── depending on position
+            // remove tree characters
+            const cleanLine = line.replace(/^[└├]──\s*/, "");
+            // Format: name@version OR @scope/name@version
+            // We need to split name and version. Last @ is version separator.
+            const lastAtIndex = cleanLine.lastIndexOf("@");
+            if (lastAtIndex === -1)
+                continue; // Should not happen for valid output
+            const name = cleanLine.substring(0, lastAtIndex);
+            // Basic validation to avoid junk
+            if (name) {
+                packages.push({
+                    name,
+                    path: path.join(globalRoot, name),
+                });
+            }
+        }
+        return packages;
+    }
+    catch (error) {
+        debug("Failed to get bun global packages: %s", error);
+        return [];
+    }
+}
+//# sourceMappingURL=global-packages.js.map

package/dist/utils/global-packages.js.map

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

package/dist/utils/pager.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Display content in an interactive pager (less).
+ * Falls back to printing to stdout if less is not available.
+ */
+export declare function showInPager(content: string): Promise<void>;
+//# sourceMappingURL=pager.d.ts.map

package/dist/utils/pager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pager.d.ts","sourceRoot":"","sources":["../../src/utils/pager.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC1D"}

package/dist/utils/pager.js

@@ -0,0 +1,41 @@
+import { spawn } from "node:child_process";
+import { unlinkSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Display content in an interactive pager (less).
+ * Falls back to printing to stdout if less is not available.
+ */
+export function showInPager(content) {
+    const tmpFile = join(tmpdir(), `hyper-diff-${Date.now()}.txt`);
+    writeFileSync(tmpFile, content);
+    return new Promise((resolve) => {
+        // -R: interpret ANSI colors
+        // -X: don't clear screen on exit
+        // -K: allow Ctrl-C to exit
+        const child = spawn("less", ["-RXK", tmpFile], {
+            stdio: "inherit",
+            env: {
+                ...process.env,
+                LESS: "-RXK",
+            },
+        });
+        child.on("close", () => {
+            try {
+                unlinkSync(tmpFile);
+            }
+            catch { }
+            resolve();
+        });
+        child.on("error", () => {
+            // less not available — print to stdout
+            try {
+                unlinkSync(tmpFile);
+            }
+            catch { }
+            process.stdout.write(`${content}\n`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=pager.js.map

package/dist/utils/pager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pager.js","sourceRoot":"","sources":["../../src/utils/pager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/D,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEhC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,4BAA4B;QAC5B,iCAAiC;QACjC,2BAA2B;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;YAC9C,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE;gBACJ,GAAG,OAAO,CAAC,GAAG;gBACd,IAAI,EAAE,MAAM;aACZ;SACD,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC;gBACJ,UAAU,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,OAAO,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,uCAAuC;YACvC,IAAI,CAAC;gBACJ,UAAU,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;YACrC,OAAO,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/help/cookbook/info.md

@@ -0,0 +1,35 @@
+# hyper cookbook info
+
+Show detailed information about a cookbook, including its recipes and their variables. Searches all installed kits to locate the cookbook by name.
+
+## Usage
+
+`hyper cookbook info <cookbook> [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `cookbook` | Cookbook name or path — required |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output as JSON |
+
+## Examples
+
+```sh
+# Show info for a cookbook by name
+hyper cookbook info starlight
+
+# Show info using the full kit-qualified path
+hyper cookbook info @kit/starlight/docs --json
+```
+
+## Output
+
+The default output displays the cookbook's location, kit, description, and a recipe list with each recipe's variables. With `--json`, the full structure is returned as a machine-readable object.
+
+If the cookbook is not found, `hyper cookbook info` lists all available cookbooks grouped by kit.

package/help/cookbook/list.md

@@ -0,0 +1,37 @@
+# hyper cookbook list
+
+List cookbooks across all installed kits, or filter to a specific kit. Shows each cookbook's name, description, and the recipes it contains.
+
+## Usage
+
+`hyper cookbook list [kit] [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `kit` | Kit to list cookbooks from — optional, lists all if omitted |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--kit <name>`, `-k` | Filter by kit name (alternative to the positional argument) |
+| `--json` | Output as JSON |
+
+## Examples
+
+```sh
+# List all cookbooks across all installed kits
+hyper cookbook list
+
+# List cookbooks from a specific kit
+hyper cookbook list @kit/starlight
+
+# Machine-readable output
+hyper cookbook list --json
+```
+
+## Output
+
+Cookbooks are grouped by kit. Each entry shows the cookbook name, version (if set), description, and the names of recipes it contains. With `--json`, the full list is returned as an array.

package/help/gen.md

@@ -0,0 +1,26 @@
+# hyper gen
+
+Execute a recipe to generate code. Discovers recipes from installed kits, resolves recipe paths, and runs the generation pipeline.
+
+## Usage
+
+`hyper gen <recipe> [options]`
+
+## Examples
+
+```sh
+# Run a local recipe
+hyper gen ./my-recipe
+
+# Run a recipe from an installed kit
+hyper gen @kit/starlight/create
+
+# Pass variables inline
+hyper gen create-component --name=Button
+
+# Provide pre-computed AI answers
+hyper gen ./my-recipe --answers ./ai-answers.json
+
+# Shorthand: kit name + recipe path
+hyper nextjs crud update Organization
+```

package/help/recipe/run.md

@@ -0,0 +1,52 @@
+# hyper recipe run
+
+Execute a recipe to generate code. Runs the full generation pipeline including template rendering, file operations, and optional AI 2-pass generation.
+
+## Usage
+
+`hyper recipe run <recipe> [--var=value ...] [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `recipe` | Path to recipe file (`.yml` or `.yaml`) — required |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--dry` | Dry run — show what would happen without writing files |
+| `--dry-run` | Alias for `--dry` |
+| `--force`, `-f` | Overwrite existing files |
+| `--skip-prompts` | Skip all interactive prompts |
+| `--defaults` | Use default values for all prompts |
+| `--continue-on-error` | Keep running even if a step fails |
+| `--answers <file>` | Load AI answers from a JSON file (Pass 2) |
+| `--ai-mode <mode>` | AI resolution mode: `me`, `ai`, or `nobody` |
+| `--json` | Output result as JSON |
+| `--verbose`, `-v` | Verbose output |
+| `--quiet`, `-q` | Suppress output |
+
+## Examples
+
+```sh
+# Run a recipe by path
+hyper recipe run my-recipe.yml
+
+# Pass recipe variables inline
+hyper recipe run recipe.yml --name=Button --type=component
+
+# Dry run to preview file operations
+hyper recipe run recipe.yml --dry
+
+# Use pre-generated AI answers (Pass 2)
+hyper recipe run recipe.yml --answers ./ai-answers.json
+
+# Run with a specific AI mode
+hyper recipe run recipe.yml --ai-mode stdout
+```
+
+## Recipe Variables
+
+Any unknown `--flag=value` pair is treated as a recipe variable and passed directly to the template engine. For example, `--name=Button` sets the `name` variable in the recipe.

package/help/recipe/validate.md

@@ -0,0 +1,51 @@
+# hyper recipe validate
+
+Validate a recipe file's syntax and structure without executing it. Reports the recipe name, version, variable count, and step list on success.
+
+## Usage
+
+`hyper recipe validate <recipe> [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `recipe` | Path to recipe file (`.yml` or `.yaml`) — required |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--strict` | Strict validation mode |
+| `--json` | Output result as JSON |
+| `--verbose`, `-v` | Verbose output |
+| `--quiet`, `-q` | Suppress output |
+
+## Examples
+
+```sh
+# Validate a local recipe
+hyper recipe validate my-recipe.yml
+
+# Validate a recipe inside a kit
+hyper recipe validate .hyper/kits/component.yml --strict
+
+# Machine-readable output
+hyper recipe validate recipe.yml --json
+```
+
+## JSON Output
+
+With `--json`, the command outputs a structured object:
+
+```json
+{
+  "valid": true,
+  "name": "Create Component",
+  "version": "1.0.0",
+  "steps": 4,
+  "variables": 2
+}
+```
+
+On failure, `valid` is `false` and an `error` field describes the problem.