@hypercli/gen 0.1.1

package/dist/actions/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Action System Types
+ *
+ * Type definitions for the decorator-based action system
+ */
+export interface ActionMetadata {
+    name: string;
+    description?: string;
+    parameters?: ActionParameter[];
+    category?: string;
+    tags?: string[];
+    examples?: ActionExample[];
+}
+export interface ActionParameter {
+    name: string;
+    type: ParameterType;
+    required?: boolean;
+    default?: any;
+    prompt?: string;
+    description?: string;
+    validation?: ParameterValidation;
+    values?: string[];
+    min?: number;
+    max?: number;
+    pattern?: string;
+}
+export type ParameterType = "string" | "boolean" | "number" | "enum" | "array" | "object" | "file" | "directory";
+export interface ParameterValidation {
+    required?: boolean;
+    custom?: string;
+    message?: string;
+}
+export interface ActionContext {
+    variables: Record<string, any>;
+    projectRoot: string;
+    templatePath?: string;
+    logger: ActionLogger;
+    utils: ActionUtils;
+    dryRun?: boolean;
+    force?: boolean;
+    communication?: ActionCommunication;
+}
+export interface ActionCommunication {
+    actionId: string;
+    manager: any;
+    sendMessage: (type: string, payload: any, target?: string) => void;
+    getSharedData: (key: string) => any;
+    setSharedData: (key: string, value: any) => void;
+    waitForAction: (actionId: string, timeout?: number) => Promise<any>;
+    subscribeToMessages: (messageType: string, handler: (message: any) => void) => () => void;
+}
+export interface ActionResult {
+    success: boolean;
+    message?: string;
+    filesCreated?: string[];
+    filesModified?: string[];
+    filesDeleted?: string[];
+    data?: any;
+    metadata?: any;
+}
+export type ActionFunction = (context: ActionContext) => Promise<ActionResult>;
+export interface DecoratedAction {
+    metadata: ActionMetadata;
+    fn: ActionFunction;
+    module: string;
+    exported: boolean;
+}
+export interface ActionExample {
+    title: string;
+    description?: string;
+    parameters: Record<string, any>;
+    expectedResult?: Partial<ActionResult>;
+}
+export interface ActionLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    trace(message: string): void;
+}
+export interface ActionUtils {
+    fileExists(path: string): boolean;
+    readFile(path: string): string;
+    writeFile(path: string, content: string): void;
+    createDirectory(path: string): void;
+    copyFile(src: string, dest: string): void;
+    deleteFile(path: string): void;
+    globFiles(pattern: string, options?: {
+        cwd?: string;
+    }): string[];
+}
+export declare class ActionExecutionError extends Error {
+    actionName: string;
+    parameterErrors?: string[] | undefined;
+    cause?: Error | undefined;
+    constructor(message: string, actionName: string, parameterErrors?: string[] | undefined, cause?: Error | undefined);
+}
+export declare class ActionParameterError extends Error {
+    parameterName: string;
+    parameterValue: any;
+    expectedType: ParameterType;
+    constructor(message: string, parameterName: string, parameterValue: any, expectedType: ParameterType);
+}
+export interface ActionQueryOptions {
+    category?: string;
+    tags?: string[];
+    search?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/types.d.ts.map

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

package/dist/actions/types.js

@@ -0,0 +1,31 @@
+/**
+ * Action System Types
+ *
+ * Type definitions for the decorator-based action system
+ */
+// Error types
+export class ActionExecutionError extends Error {
+    actionName;
+    parameterErrors;
+    cause;
+    constructor(message, actionName, parameterErrors, cause) {
+        super(message);
+        this.actionName = actionName;
+        this.parameterErrors = parameterErrors;
+        this.cause = cause;
+        this.name = "ActionExecutionError";
+    }
+}
+export class ActionParameterError extends Error {
+    parameterName;
+    parameterValue;
+    expectedType;
+    constructor(message, parameterName, parameterValue, expectedType) {
+        super(message);
+        this.parameterName = parameterName;
+        this.parameterValue = parameterValue;
+        this.expectedType = expectedType;
+        this.name = "ActionParameterError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/actions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/actions/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqHH,cAAc;AACd,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGtC;IACA;IACS;IAJjB,YACC,OAAe,EACR,UAAkB,EAClB,eAA0B,EACjB,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,eAAU,GAAV,UAAU,CAAQ;QAClB,oBAAe,GAAf,eAAe,CAAW;QACjB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGtC;IACA;IACA;IAJR,YACC,OAAe,EACR,aAAqB,EACrB,cAAmB,EACnB,YAA2B;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,kBAAa,GAAb,aAAa,CAAQ;QACrB,mBAAc,GAAd,cAAc,CAAK;QACnB,iBAAY,GAAZ,YAAY,CAAe;QAGlC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD"}

package/dist/actions/utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Action Utilities
+ *
+ * Utilities and helpers for action implementations
+ */
+import type { ActionLogger, ActionUtils } from "./types.js";
+export declare class DefaultActionUtils implements ActionUtils {
+    fileExists(filePath: string): boolean;
+    readFile(filePath: string): string;
+    writeFile(filePath: string, content: string): void;
+    createDirectory(dirPath: string): void;
+    copyFile(src: string, dest: string): void;
+    deleteFile(filePath: string): void;
+    globFiles(pattern: string, options?: {
+        cwd?: string;
+    }): string[];
+    installPackages(packages: string[], options?: {
+        dev?: boolean;
+    }): Promise<void>;
+    runCommand(command: string, options?: {
+        cwd?: string;
+    }): Promise<string>;
+    private detectPackageManager;
+}
+export declare class ConsoleActionLogger implements ActionLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    trace(message: string): void;
+}
+/**
+ * Silent logger for testing or when output should be suppressed
+ */
+export declare class SilentActionLogger implements ActionLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    trace(message: string): void;
+}
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/actions/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI5D,qBAAa,kBAAmB,YAAW,WAAW;IACrD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKlC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMlD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKtC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM,EAAE;IAQ9D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCnF,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YAepE,oBAAoB;CAkBlC;AAED,qBAAa,mBAAoB,YAAW,YAAY;IACvD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACtD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG5B"}

package/dist/actions/utils.js

@@ -0,0 +1,144 @@
+/**
+ * Action Utilities
+ *
+ * Utilities and helpers for action implementations
+ */
+import path from "node:path";
+import createDebug from "debug";
+import execa from "execa";
+import fs from "fs-extra";
+import { glob } from "glob";
+const debug = createDebug("hyper:action:utils");
+export class DefaultActionUtils {
+    fileExists(filePath) {
+        debug("Checking file exists: %s", filePath);
+        return fs.existsSync(filePath);
+    }
+    readFile(filePath) {
+        debug("Reading file: %s", filePath);
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    writeFile(filePath, content) {
+        debug("Writing file: %s", filePath);
+        fs.ensureDirSync(path.dirname(filePath));
+        fs.writeFileSync(filePath, content, "utf-8");
+    }
+    createDirectory(dirPath) {
+        debug("Creating directory: %s", dirPath);
+        fs.ensureDirSync(dirPath);
+    }
+    copyFile(src, dest) {
+        debug("Copying file: %s -> %s", src, dest);
+        fs.ensureDirSync(path.dirname(dest));
+        fs.copySync(src, dest);
+    }
+    deleteFile(filePath) {
+        debug("Deleting file: %s", filePath);
+        fs.removeSync(filePath);
+    }
+    globFiles(pattern, options = {}) {
+        debug("Globbing pattern: %s (cwd: %s)", pattern, options.cwd || process.cwd());
+        return glob.sync(pattern, {
+            cwd: options.cwd || process.cwd(),
+            absolute: false,
+        });
+    }
+    async installPackages(packages, options = {}) {
+        debug("Installing packages: %s (dev: %s)", packages.join(", "), options.dev || false);
+        // Detect package manager
+        const packageManager = await this.detectPackageManager();
+        let args;
+        switch (packageManager) {
+            case "bun":
+                args = ["add"];
+                if (options.dev)
+                    args.push("--dev");
+                args.push(...packages);
+                break;
+            case "yarn":
+                args = ["add"];
+                if (options.dev)
+                    args.push("--dev");
+                args.push(...packages);
+                break;
+            case "pnpm":
+                args = ["add"];
+                if (options.dev)
+                    args.push("--save-dev");
+                args.push(...packages);
+                break;
+            default: // npm
+                args = ["install"];
+                if (options.dev)
+                    args.push("--save-dev");
+                args.push(...packages);
+                break;
+        }
+        await this.runCommand(`${packageManager} ${args.join(" ")}`);
+    }
+    async runCommand(command, options = {}) {
+        debug("Running command: %s (cwd: %s)", command, options.cwd || process.cwd());
+        try {
+            const result = await execa(command, {
+                shell: true,
+                cwd: options.cwd || process.cwd(),
+            });
+            return result.stdout;
+        }
+        catch (error) {
+            throw new Error(`Command failed: ${command}\n${error.message}`);
+        }
+    }
+    async detectPackageManager() {
+        const cwd = process.cwd();
+        // Check for lock files to determine package manager
+        if (await fs.pathExists(path.join(cwd, "bun.lockb"))) {
+            return "bun";
+        }
+        if (await fs.pathExists(path.join(cwd, "yarn.lock"))) {
+            return "yarn";
+        }
+        if (await fs.pathExists(path.join(cwd, "pnpm-lock.yaml"))) {
+            return "pnpm";
+        }
+        return "npm";
+    }
+}
+export class ConsoleActionLogger {
+    info(message) {
+        console.log(`ℹ️  ${message}`);
+    }
+    warn(message) {
+        console.warn(`⚠️  ${message}`);
+    }
+    error(message) {
+        console.error(`❌ ${message}`);
+    }
+    debug(message) {
+        console.log(`🐛 ${message}`);
+    }
+    trace(message) {
+        console.log(`🔍 ${message}`);
+    }
+}
+/**
+ * Silent logger for testing or when output should be suppressed
+ */
+export class SilentActionLogger {
+    info(message) {
+        // Silent
+    }
+    warn(message) {
+        // Silent
+    }
+    error(message) {
+        // Silent
+    }
+    debug(message) {
+        // Silent
+    }
+    trace(message) {
+        // Silent
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/actions/utils.js.map

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

package/dist/ai/ai-collector.d.ts

@@ -0,0 +1,52 @@
+/**
+ * AI Collector
+ *
+ * Singleton that accumulates AI block data (@ai/@context/@prompt/@output)
+ * across all templates during a single generation run.
+ *
+ * In the 2-pass system:
+ *   Pass 1 (collect mode): Templates render but @ai blocks collect their
+ *          data here instead of producing output. No files are written.
+ *   Pass 2 (answers mode): Templates resolve @ai blocks from provided
+ *          answers. Files are written normally.
+ */
+/**
+ * Data collected from a single @ai block in a template
+ */
+export interface AiBlockEntry {
+    /** JSON property name the LLM fills in (from @ai({ key })) */
+    key: string;
+    /** Rendered @context bodies within this @ai block */
+    contexts: string[];
+    /** Rendered @prompt body */
+    prompt: string;
+    /** Rendered @output body (format description) */
+    outputDescription: string;
+    /** Advisory type hint for the output (e.g. 'jsx-fragment', 'sql', 'json') */
+    typeHint: string;
+    /** Rendered @example bodies (concrete examples of expected output) */
+    examples: string[];
+    /** Which template file this block came from */
+    sourceFile: string;
+}
+/**
+ * Accumulates AI block data across all templates in a single run.
+ * Follows the same singleton pattern as AiService.
+ */
+export declare class AiCollector {
+    private static instance;
+    /** Whether we're in Pass 1 (collecting) or not */
+    collectMode: boolean;
+    private globalContexts;
+    private entries;
+    private constructor();
+    static getInstance(): AiCollector;
+    static reset(): void;
+    addGlobalContext(text: string): void;
+    addEntry(entry: AiBlockEntry): void;
+    hasEntries(): boolean;
+    getGlobalContexts(): string[];
+    getEntries(): Map<string, AiBlockEntry>;
+    clear(): void;
+}
+//# sourceMappingURL=ai-collector.d.ts.map

package/dist/ai/ai-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-collector.d.ts","sourceRoot":"","sources":["../../src/ai/ai-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IAEZ,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IAEjB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IAEnD,kDAAkD;IAClD,WAAW,UAAS;IAEpB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,OAAO,CAAmC;IAElD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,WAAW;IAOjC,MAAM,CAAC,KAAK,IAAI,IAAI;IAIpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOpC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAYnC,UAAU,IAAI,OAAO;IAIrB,iBAAiB,IAAI,MAAM,EAAE;IAI7B,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAIvC,KAAK,IAAI,IAAI;CAMb"}

package/dist/ai/ai-collector.js

@@ -0,0 +1,64 @@
+/**
+ * AI Collector
+ *
+ * Singleton that accumulates AI block data (@ai/@context/@prompt/@output)
+ * across all templates during a single generation run.
+ *
+ * In the 2-pass system:
+ *   Pass 1 (collect mode): Templates render but @ai blocks collect their
+ *          data here instead of producing output. No files are written.
+ *   Pass 2 (answers mode): Templates resolve @ai blocks from provided
+ *          answers. Files are written normally.
+ */
+import createDebug from "debug";
+const debug = createDebug("hypergen:ai:collector");
+/**
+ * Accumulates AI block data across all templates in a single run.
+ * Follows the same singleton pattern as AiService.
+ */
+export class AiCollector {
+    static instance = null;
+    /** Whether we're in Pass 1 (collecting) or not */
+    collectMode = false;
+    globalContexts = [];
+    entries = new Map();
+    constructor() { }
+    static getInstance() {
+        if (!AiCollector.instance) {
+            AiCollector.instance = new AiCollector();
+        }
+        return AiCollector.instance;
+    }
+    static reset() {
+        AiCollector.instance = null;
+    }
+    addGlobalContext(text) {
+        if (text.trim()) {
+            this.globalContexts.push(text.trim());
+            debug("Added global context (%d chars)", text.length);
+        }
+    }
+    addEntry(entry) {
+        if (this.entries.has(entry.key)) {
+            debug('Warning: duplicate AI block key "%s" — overwriting (source: %s)', entry.key, entry.sourceFile);
+        }
+        this.entries.set(entry.key, entry);
+        debug('Added AI block entry "%s" from %s', entry.key, entry.sourceFile);
+    }
+    hasEntries() {
+        return this.entries.size > 0;
+    }
+    getGlobalContexts() {
+        return [...this.globalContexts];
+    }
+    getEntries() {
+        return new Map(this.entries);
+    }
+    clear() {
+        this.globalContexts = [];
+        this.entries.clear();
+        this.collectMode = false;
+        debug("Collector cleared");
+    }
+}
+//# sourceMappingURL=ai-collector.js.map

package/dist/ai/ai-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-collector.js","sourceRoot":"","sources":["../../src/ai/ai-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,WAAW,MAAM,OAAO,CAAC;AAEhC,MAAM,KAAK,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AA4BnD;;;GAGG;AACH,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,QAAQ,GAAuB,IAAI,CAAC;IAEnD,kDAAkD;IAClD,WAAW,GAAG,KAAK,CAAC;IAEZ,cAAc,GAAa,EAAE,CAAC;IAC9B,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAElD,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC3B,WAAW,CAAC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,KAAK;QACX,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,gBAAgB,CAAC,IAAY;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,KAAK,CAAC,iCAAiC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;IACF,CAAC;IAED,QAAQ,CAAC,KAAmB;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CACJ,iEAAiE,EACjE,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,UAAU,CAChB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzE,CAAC;IAED,UAAU;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,iBAAiB;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IACjC,CAAC;IAED,UAAU;QACT,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC5B,CAAC"}