steroids-cli 0.4.47

package/dist/hooks/orchestrator.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Hook Orchestrator
+ *
+ * Coordinates hook execution by:
+ * 1. Loading hooks from config
+ * 2. Matching events to hooks
+ * 3. Executing matching hooks (script or webhook)
+ * 4. Logging execution results
+ * 5. Handling failures gracefully (non-blocking)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookOrchestrator = void 0;
+exports.createOrchestrator = createOrchestrator;
+const merge_js_1 = require("./merge.js");
+const script_runner_js_1 = require("./script-runner.js");
+const webhook_runner_js_1 = require("./webhook-runner.js");
+/**
+ * Hook Orchestrator
+ *
+ * Manages hook lifecycle and execution
+ */
+class HookOrchestrator {
+    hooks = [];
+    config;
+    constructor(hooks = [], config = {}) {
+        this.hooks = hooks;
+        this.config = {
+            verbose: config.verbose ?? false,
+            continueOnError: config.continueOnError ?? true,
+        };
+    }
+    /**
+     * Load hooks from configuration
+     */
+    setHooks(hooks) {
+        this.hooks = hooks;
+    }
+    /**
+     * Get all loaded hooks
+     */
+    getHooks() {
+        return [...this.hooks];
+    }
+    /**
+     * Get hooks for a specific event
+     */
+    getHooksForEvent(event) {
+        return (0, merge_js_1.filterHooksByEvent)(this.hooks, event);
+    }
+    /**
+     * Execute all hooks for an event
+     *
+     * @param event - Event name
+     * @param payload - Event payload
+     * @returns Array of execution results
+     */
+    async executeHooksForEvent(event, payload) {
+        const matchingHooks = this.getHooksForEvent(event);
+        if (matchingHooks.length === 0) {
+            return [];
+        }
+        if (this.config.verbose) {
+            console.log(`[Hooks] Executing ${matchingHooks.length} hook(s) for event: ${event}`);
+        }
+        const results = [];
+        for (const hook of matchingHooks) {
+            try {
+                // Validate hook configuration
+                const validation = (0, merge_js_1.validateHook)(hook);
+                if (!validation.valid) {
+                    const error = `Invalid hook configuration: ${validation.errors.join(', ')}`;
+                    results.push({
+                        hookName: hook.name,
+                        hookType: hook.type,
+                        success: false,
+                        duration: 0,
+                        error,
+                    });
+                    if (this.config.verbose) {
+                        console.error(`[Hooks] ${hook.name}: ${error}`);
+                    }
+                    if (!this.config.continueOnError) {
+                        break;
+                    }
+                    continue;
+                }
+                // Execute hook based on type
+                const result = await this.executeHook(hook, payload);
+                results.push(result);
+                if (this.config.verbose) {
+                    if (result.success) {
+                        console.log(`[Hooks] ${hook.name}: ✓ Success (${result.duration}ms)`);
+                    }
+                    else {
+                        console.error(`[Hooks] ${hook.name}: ✗ Failed - ${result.error}`);
+                    }
+                }
+                // Stop if continueOnError is false and hook failed
+                if (!result.success && !this.config.continueOnError) {
+                    break;
+                }
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                results.push({
+                    hookName: hook.name,
+                    hookType: hook.type,
+                    success: false,
+                    duration: 0,
+                    error: errorMsg,
+                });
+                if (this.config.verbose) {
+                    console.error(`[Hooks] ${hook.name}: ✗ Exception - ${errorMsg}`);
+                }
+                if (!this.config.continueOnError) {
+                    break;
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute a single hook
+     */
+    async executeHook(hook, payload) {
+        if (hook.type === 'script') {
+            return this.executeScriptHook(hook, payload);
+        }
+        else if (hook.type === 'webhook') {
+            return this.executeWebhookHook(hook, payload);
+        }
+        // This should never happen due to TypeScript's discriminated union
+        const _exhaustive = hook;
+        return {
+            hookName: hook.name,
+            hookType: hook.type,
+            success: false,
+            duration: 0,
+            error: `Unknown hook type: ${hook.type}`,
+        };
+    }
+    /**
+     * Execute a script hook
+     */
+    async executeScriptHook(hook, payload) {
+        const config = (0, merge_js_1.toScriptRunnerConfig)(hook);
+        const scriptResult = await (0, script_runner_js_1.executeScript)(config, payload);
+        return {
+            hookName: hook.name,
+            hookType: 'script',
+            success: scriptResult.success,
+            duration: scriptResult.duration,
+            error: scriptResult.error,
+            scriptResult,
+        };
+    }
+    /**
+     * Execute a webhook hook
+     */
+    async executeWebhookHook(hook, payload) {
+        const config = (0, merge_js_1.toWebhookRunnerConfig)(hook);
+        const webhookResult = await (0, webhook_runner_js_1.executeWebhook)(config, payload);
+        return {
+            hookName: hook.name,
+            hookType: 'webhook',
+            success: webhookResult.success,
+            duration: webhookResult.duration,
+            error: webhookResult.error,
+            webhookResult,
+        };
+    }
+    /**
+     * Validate all loaded hooks
+     *
+     * @returns Validation results for each hook
+     */
+    validateAllHooks() {
+        return this.hooks.map((hook) => {
+            const validation = (0, merge_js_1.validateHook)(hook);
+            return {
+                hook: hook.name,
+                valid: validation.valid,
+                errors: validation.errors,
+            };
+        });
+    }
+    /**
+     * Get statistics about loaded hooks
+     */
+    getStats() {
+        const stats = {
+            total: this.hooks.length,
+            enabled: 0,
+            disabled: 0,
+            byType: {},
+            byEvent: {},
+        };
+        for (const hook of this.hooks) {
+            if (hook.enabled === false) {
+                stats.disabled++;
+            }
+            else {
+                stats.enabled++;
+            }
+            stats.byType[hook.type] = (stats.byType[hook.type] || 0) + 1;
+            stats.byEvent[hook.event] = (stats.byEvent[hook.event] || 0) + 1;
+        }
+        return stats;
+    }
+}
+exports.HookOrchestrator = HookOrchestrator;
+/**
+ * Create a hook orchestrator from global and project hooks
+ *
+ * @param globalHooks - Hooks from ~/.steroids/config.yaml
+ * @param projectHooks - Hooks from .steroids/config.yaml
+ * @param config - Orchestrator configuration
+ * @returns Configured hook orchestrator
+ */
+function createOrchestrator(globalHooks, projectHooks, config) {
+    const { mergeHooks } = require('./merge.js');
+    const merged = mergeHooks(globalHooks, projectHooks);
+    return new HookOrchestrator(merged, config);
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/hooks/orchestrator.js.map

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

package/dist/hooks/payload.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Hook Payload Schemas
+ *
+ * Defines the payload structures for each hook event type.
+ * Payloads contain all context needed by hook handlers.
+ */
+import type { HookEvent } from './events';
+/**
+ * Task status values
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'review';
+/**
+ * Health status values
+ */
+export type HealthStatus = 'healthy' | 'warning' | 'critical';
+/**
+ * Dispute status values
+ */
+export type DisputeStatus = 'open' | 'resolved';
+/**
+ * Dispute type values
+ */
+export type DisputeType = 'scope' | 'quality' | 'requirements' | 'other';
+/**
+ * Dispute resolution values
+ */
+export type DisputeResolution = 'coder_wins' | 'reviewer_wins' | 'compromise' | 'escalated';
+/**
+ * Base payload structure for all events
+ */
+export interface BasePayload {
+    /** Event name that triggered this hook */
+    event: HookEvent;
+    /** ISO 8601 timestamp of when the event occurred */
+    timestamp: string;
+}
+/**
+ * Project context included in all payloads
+ */
+export interface ProjectContext {
+    /** Project name (directory name) */
+    name: string;
+    /** Absolute path to project root */
+    path: string;
+}
+/**
+ * Task data for task-related events
+ */
+export interface TaskData {
+    /** Unique task identifier */
+    id: string;
+    /** Task title/description */
+    title: string;
+    /** Current task status */
+    status: TaskStatus;
+    /** Previous status (for update events) */
+    previousStatus?: TaskStatus;
+    /** Section name the task belongs to */
+    section?: string | null;
+    /** Section ID the task belongs to */
+    sectionId?: string | null;
+    /** File where task is defined */
+    file?: string;
+    /** Line number in source file */
+    line?: number;
+    /** Original source file for synced tasks */
+    sourceFile?: string | null;
+    /** Number of times task was rejected */
+    rejectionCount?: number;
+}
+/**
+ * Section data for section-related events
+ */
+export interface SectionData {
+    /** Unique section identifier */
+    id: string;
+    /** Section name */
+    name: string;
+    /** Number of tasks in section */
+    taskCount: number;
+    /** File where section is defined */
+    file?: string;
+}
+/**
+ * Task summary for section/project completion
+ */
+export interface TaskSummary {
+    /** Task ID */
+    id: string;
+    /** Task title */
+    title: string;
+}
+/**
+ * Health data for health-related events
+ */
+export interface HealthData {
+    /** Current health score (0-100) */
+    score: number;
+    /** Previous health score (for change events) */
+    previousScore?: number;
+    /** Health status category */
+    status: HealthStatus;
+    /** List of failed check names */
+    failedChecks?: string[];
+}
+/**
+ * Dispute data for dispute-related events
+ */
+export interface DisputeData {
+    /** Unique dispute identifier */
+    id: string;
+    /** Task ID the dispute is about */
+    taskId: string;
+    /** Type of dispute */
+    type: DisputeType;
+    /** Dispute status */
+    status: DisputeStatus;
+    /** Reason for opening dispute */
+    reason: string;
+    /** Coder's position */
+    coderPosition?: string;
+    /** Reviewer's position */
+    reviewerPosition?: string;
+    /** Resolution (for resolved disputes) */
+    resolution?: DisputeResolution;
+    /** Resolution notes */
+    resolutionNotes?: string;
+    /** Who created the dispute */
+    createdBy: string;
+    /** Who resolved the dispute (if resolved) */
+    resolvedBy?: string;
+}
+/**
+ * Project summary for project completion
+ */
+export interface ProjectSummary {
+    /** Total number of tasks in project */
+    totalTasks: number;
+    /** List of files containing tasks */
+    files: string[];
+    /** Number of sections */
+    sectionCount?: number;
+}
+/**
+ * Payload for task.created event
+ */
+export interface TaskCreatedPayload extends BasePayload {
+    event: 'task.created';
+    task: TaskData;
+    project: ProjectContext;
+}
+/**
+ * Payload for task.updated event
+ */
+export interface TaskUpdatedPayload extends BasePayload {
+    event: 'task.updated';
+    task: TaskData;
+    project: ProjectContext;
+}
+/**
+ * Payload for task.completed event
+ */
+export interface TaskCompletedPayload extends BasePayload {
+    event: 'task.completed';
+    task: TaskData;
+    project: ProjectContext;
+}
+/**
+ * Payload for task.failed event
+ */
+export interface TaskFailedPayload extends BasePayload {
+    event: 'task.failed';
+    task: TaskData;
+    project: ProjectContext;
+    /** Maximum rejections reached */
+    maxRejections: number;
+}
+/**
+ * Payload for section.completed event
+ */
+export interface SectionCompletedPayload extends BasePayload {
+    event: 'section.completed';
+    section: SectionData;
+    tasks: TaskSummary[];
+    project: ProjectContext;
+}
+/**
+ * Payload for project.completed event
+ */
+export interface ProjectCompletedPayload extends BasePayload {
+    event: 'project.completed';
+    project: ProjectContext;
+    summary: ProjectSummary;
+}
+/**
+ * Payload for health.changed event
+ */
+export interface HealthChangedPayload extends BasePayload {
+    event: 'health.changed';
+    project: ProjectContext;
+    health: HealthData;
+}
+/**
+ * Payload for health.critical event
+ */
+export interface HealthCriticalPayload extends BasePayload {
+    event: 'health.critical';
+    project: ProjectContext;
+    health: HealthData;
+    /** Threshold that was violated */
+    threshold: number;
+}
+/**
+ * Payload for dispute.created event
+ */
+export interface DisputeCreatedPayload extends BasePayload {
+    event: 'dispute.created';
+    dispute: DisputeData;
+    task: TaskData;
+    project: ProjectContext;
+}
+/**
+ * Payload for dispute.resolved event
+ */
+export interface DisputeResolvedPayload extends BasePayload {
+    event: 'dispute.resolved';
+    dispute: DisputeData;
+    task: TaskData;
+    project: ProjectContext;
+}
+/**
+ * Union of all task event payloads
+ */
+export type TaskEventPayload = TaskCreatedPayload | TaskUpdatedPayload | TaskCompletedPayload | TaskFailedPayload;
+/**
+ * Union of all health event payloads
+ */
+export type HealthEventPayload = HealthChangedPayload | HealthCriticalPayload;
+/**
+ * Union of all dispute event payloads
+ */
+export type DisputeEventPayload = DisputeCreatedPayload | DisputeResolvedPayload;
+/**
+ * Union of all possible hook payloads
+ */
+export type HookPayload = TaskCreatedPayload | TaskUpdatedPayload | TaskCompletedPayload | TaskFailedPayload | SectionCompletedPayload | ProjectCompletedPayload | HealthChangedPayload | HealthCriticalPayload | DisputeCreatedPayload | DisputeResolvedPayload;
+/**
+ * Create a task.created payload
+ */
+export declare function createTaskCreatedPayload(task: TaskData, project: ProjectContext): TaskCreatedPayload;
+/**
+ * Create a task.updated payload
+ */
+export declare function createTaskUpdatedPayload(task: TaskData, project: ProjectContext): TaskUpdatedPayload;
+/**
+ * Create a task.completed payload
+ */
+export declare function createTaskCompletedPayload(task: TaskData, project: ProjectContext): TaskCompletedPayload;
+/**
+ * Create a task.failed payload
+ */
+export declare function createTaskFailedPayload(task: TaskData, project: ProjectContext, maxRejections: number): TaskFailedPayload;
+/**
+ * Create a section.completed payload
+ */
+export declare function createSectionCompletedPayload(section: SectionData, tasks: TaskSummary[], project: ProjectContext): SectionCompletedPayload;
+/**
+ * Create a project.completed payload
+ */
+export declare function createProjectCompletedPayload(project: ProjectContext, summary: ProjectSummary): ProjectCompletedPayload;
+/**
+ * Create a health.changed payload
+ */
+export declare function createHealthChangedPayload(project: ProjectContext, health: HealthData): HealthChangedPayload;
+/**
+ * Create a health.critical payload
+ */
+export declare function createHealthCriticalPayload(project: ProjectContext, health: HealthData, threshold: number): HealthCriticalPayload;
+/**
+ * Create a dispute.created payload
+ */
+export declare function createDisputeCreatedPayload(dispute: DisputeData, task: TaskData, project: ProjectContext): DisputeCreatedPayload;
+/**
+ * Create a dispute.resolved payload
+ */
+export declare function createDisputeResolvedPayload(dispute: DisputeData, task: TaskData, project: ProjectContext): DisputeResolvedPayload;
+/**
+ * Validate that a payload has required fields for its event type
+ */
+export declare function validatePayload(payload: HookPayload): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=payload.d.ts.map

package/dist/hooks/payload.d.ts.map

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