@hypercli/gen 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Saulo Vallory
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @hypercli/gen
+
+Code generation engine plugin for the `hyper` CLI. Provides the recipe execution system, Jig template engine, AI 2-pass generation, and all generation commands.
+
+## Install
+
+Included automatically with `@hypercli/cli`. Can also be installed as a standalone oclif plugin.
+
+## Commands
+
+- `hyper gen <recipe>` — Execute a recipe to generate code
+- `hyper recipe list` — List available recipes
+- `hyper recipe run <file>` — Run a recipe by file path
+- `hyper recipe validate <file>` — Validate a recipe file
+- `hyper cookbook list` — List cookbooks
+- `hyper cookbook info <name>` — Show cookbook details
+
+## Documentation
+
+Full documentation at [hyperdev.saulo.engineer](https://hyperdev.saulo.engineer).
+
+## License
+
+MIT

package/dist/actions/communication.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Cross-Action Communication System
+ *
+ * Enables actions to communicate with each other and share state
+ * during execution workflows
+ */
+import { EventEmitter } from "node:events";
+export interface ActionMessage {
+    id: string;
+    source: string;
+    target?: string;
+    type: string;
+    payload: any;
+    timestamp: Date;
+    correlationId?: string;
+}
+export interface ActionState {
+    id: string;
+    action: string;
+    status: "running" | "completed" | "failed" | "paused";
+    data: Record<string, any>;
+    metadata: {
+        startTime: Date;
+        endTime?: Date;
+        duration?: number;
+        filesCreated?: string[];
+        errors?: string[];
+    };
+}
+export interface CommunicationChannel {
+    id: string;
+    name: string;
+    type: "broadcast" | "direct" | "topic";
+    subscribers: string[];
+    messageHistory: ActionMessage[];
+    persistent: boolean;
+}
+export interface StateStore {
+    actionStates: Map<string, ActionState>;
+    sharedData: Map<string, any>;
+    channels: Map<string, CommunicationChannel>;
+    eventHistory: ActionMessage[];
+}
+export interface CommunicationConfig {
+    maxMessageHistory: number;
+    maxStateHistory: number;
+    enablePersistence: boolean;
+    stateStorePath?: string;
+    channels: CommunicationChannelConfig[];
+}
+export interface CommunicationChannelConfig {
+    name: string;
+    type: "broadcast" | "direct" | "topic";
+    persistent?: boolean;
+    subscribers?: string[];
+}
+export declare class ActionCommunicationManager extends EventEmitter {
+    private store;
+    private config;
+    private messageCorrelations;
+    constructor(config?: Partial<CommunicationConfig>);
+    /**
+     * Register an action and create its initial state
+     */
+    registerAction(actionId: string, actionName: string, initialData?: Record<string, any>): void;
+    /**
+     * Update action state
+     */
+    updateActionState(actionId: string, updates: Partial<ActionState["data"]>, status?: ActionState["status"]): void;
+    /**
+     * Complete an action
+     */
+    completeAction(actionId: string, result: {
+        filesCreated?: string[];
+        message?: string;
+    }): void;
+    /**
+     * Fail an action
+     */
+    failAction(actionId: string, error: string | Error): void;
+    /**
+     * Send a message between actions
+     */
+    sendMessage(message: Omit<ActionMessage, "id"> & {
+        id?: string;
+    }): void;
+    /**
+     * Subscribe to messages for a specific action
+     */
+    subscribeToMessages(actionId: string, messageType: string, handler: (message: ActionMessage) => void): () => void;
+    /**
+     * Set shared data that can be accessed by other actions
+     */
+    setSharedData(key: string, value: any, source?: string): void;
+    /**
+     * Get shared data
+     */
+    getSharedData(key: string): any;
+    /**
+     * Get all shared data
+     */
+    getAllSharedData(): Record<string, any>;
+    /**
+     * Delete shared data
+     */
+    deleteSharedData(key: string, source?: string): boolean;
+    /**
+     * Get action state
+     */
+    getActionState(actionId: string): ActionState | undefined;
+    /**
+     * Get all action states
+     */
+    getAllActionStates(): ActionState[];
+    /**
+     * Get actions by status
+     */
+    getActionsByStatus(status: ActionState["status"]): ActionState[];
+    /**
+     * Wait for an action to complete
+     */
+    waitForAction(actionId: string, timeout?: number): Promise<ActionState>;
+    /**
+     * Create a communication channel
+     */
+    createChannel(config: CommunicationChannelConfig): void;
+    /**
+     * Subscribe to a channel
+     */
+    subscribeToChannel(channelName: string, actionId: string): void;
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribeFromChannel(channelName: string, actionId: string): void;
+    /**
+     * Get message history
+     */
+    getMessageHistory(filter?: {
+        type?: string;
+        source?: string;
+        target?: string;
+        correlationId?: string;
+        since?: Date;
+    }): ActionMessage[];
+    /**
+     * Clear communication state
+     */
+    clear(): void;
+    /**
+     * Get communication statistics
+     */
+    getStats(): {
+        activeActions: number;
+        completedActions: number;
+        failedActions: number;
+        totalMessages: number;
+        sharedDataEntries: number;
+        channels: number;
+    };
+    /**
+     * Initialize default channels
+     */
+    private initializeChannels;
+    /**
+     * Route message to appropriate channels and subscribers
+     */
+    private routeMessage;
+    /**
+     * Track correlation between messages
+     */
+    private trackCorrelation;
+    /**
+     * Trim event history to stay within limits
+     */
+    private trimEventHistory;
+    /**
+     * Trim channel message history
+     */
+    private trimChannelHistory;
+    /**
+     * Generate unique message ID
+     */
+    private generateMessageId;
+    /**
+     * Generate unique channel ID
+     */
+    private generateChannelId;
+}
+/**
+ * Get or create the global communication manager
+ */
+export declare function getCommunicationManager(config?: Partial<CommunicationConfig>): ActionCommunicationManager;
+/**
+ * Set the global communication manager
+ */
+export declare function setCommunicationManager(manager: ActionCommunicationManager): void;
+/**
+ * Clear the global communication manager
+ */
+export declare function clearCommunicationManager(): void;
+//# sourceMappingURL=communication.d.ts.map

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

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