buildhive-agent 1.0.0-beta.1

package/dist/lifecycleExecutor.js

@@ -0,0 +1,230 @@
+/**
+ * Lifecycle Executor - Setup/Execute/Teardown job phases
+ *
+ * Manages the full lifecycle of a job execution:
+ *   1. Setup steps run sequentially
+ *   2. Main build command executes
+ *   3. Teardown steps ALWAYS run (even on failure)
+ */
+import { spawn } from 'child_process';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_STEP_TIMEOUT_S = 300;
+const SIGKILL_GRACE_MS = 5000;
+// ---------------------------------------------------------------------------
+// LifecycleExecutor
+// ---------------------------------------------------------------------------
+export class LifecycleExecutor {
+    /**
+     * Execute full lifecycle: setup -> main command -> teardown
+     *
+     * CRITICAL BEHAVIORS:
+     * 1. Setup steps run sequentially. If a step fails and continueOnError=false,
+     *    skip remaining setup + main command, but STILL run teardown.
+     * 2. Main command runs only if all required setup steps succeed.
+     * 3. Teardown ALWAYS runs, even if setup or main command failed.
+     * 4. Each step has its own timeout (default 300s).
+     * 5. If abortSignal fires, terminate current step and run teardown.
+     */
+    async execute(setupSteps, mainCommand, teardownSteps, options) {
+        const totalStart = Date.now();
+        const setupResults = [];
+        let executeResult;
+        const teardownResults = [];
+        let setupFailed = false;
+        let aborted = this.isAborted(options);
+        // ---- SETUP PHASE (0-30%) ----
+        const setupCount = setupSteps.length;
+        for (let i = 0; i < setupCount; i++) {
+            const step = setupSteps[i];
+            const progressBase = (i / Math.max(setupCount, 1)) * 30;
+            if (aborted || setupFailed) {
+                setupResults.push(this.skippedResult('setup', step.name));
+                continue;
+            }
+            options.onProgress?.('setup', step.name, Math.round(progressBase));
+            const result = await this.executeStep(step, 'setup', options);
+            setupResults.push(result);
+            if (result.exitCode !== 0 && !step.continueOnError) {
+                setupFailed = true;
+            }
+            aborted = this.isAborted(options);
+        }
+        options.onProgress?.('setup', 'complete', 30);
+        // ---- EXECUTE PHASE (30-90%) ----
+        if (setupFailed || aborted) {
+            executeResult = this.skippedResult('execute', mainCommand);
+        }
+        else {
+            options.onProgress?.('execute', mainCommand, 30);
+            const mainStep = {
+                name: mainCommand,
+                command: mainCommand,
+                timeout: DEFAULT_STEP_TIMEOUT_S,
+                continueOnError: false,
+            };
+            executeResult = await this.executeStep(mainStep, 'execute', options);
+            options.onProgress?.('execute', mainCommand, 90);
+        }
+        aborted = this.isAborted(options);
+        // ---- TEARDOWN PHASE (90-100%) ----
+        // Teardown ALWAYS runs fully — strip abortSignal so it cannot be cancelled.
+        const teardownOptions = { ...options, abortSignal: undefined };
+        const teardownCount = teardownSteps.length;
+        for (let i = 0; i < teardownCount; i++) {
+            const step = teardownSteps[i];
+            const progressBase = 90 + ((i / Math.max(teardownCount, 1)) * 10);
+            teardownOptions.onProgress?.('teardown', step.name, Math.round(progressBase));
+            const result = await this.executeStep(step, 'teardown', teardownOptions);
+            teardownResults.push(result);
+        }
+        options.onProgress?.('teardown', 'complete', 100);
+        const totalDurationMs = Date.now() - totalStart;
+        const overallSuccess = !setupFailed &&
+            executeResult.exitCode === 0 &&
+            !executeResult.skipped;
+        return {
+            setupResults,
+            executeResult,
+            teardownResults,
+            overallSuccess,
+            totalDurationMs,
+        };
+    }
+    /**
+     * Execute a single lifecycle step using child_process.spawn.
+     */
+    executeStep(step, phase, options) {
+        return new Promise((resolve) => {
+            const start = Date.now();
+            const timeoutMs = (step.timeout ?? DEFAULT_STEP_TIMEOUT_S) * 1000;
+            let stdout = '';
+            let stderr = '';
+            let settled = false;
+            let proc;
+            const finish = (exitCode, error) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                removeAbortListener();
+                resolve({
+                    phase: phase,
+                    stepName: step.name,
+                    exitCode,
+                    stdout,
+                    stderr,
+                    durationMs: Date.now() - start,
+                    skipped: false,
+                    error,
+                });
+            };
+            const killProc = (reason) => {
+                if (settled)
+                    return;
+                try {
+                    proc.kill('SIGTERM');
+                }
+                catch { /* already dead */ }
+                setTimeout(() => {
+                    if (!settled) {
+                        try {
+                            proc.kill('SIGKILL');
+                        }
+                        catch { /* already dead */ }
+                    }
+                }, SIGKILL_GRACE_MS);
+                // Don't finish here; let the 'close' event handle it.
+                // But set error so close handler knows what happened.
+                stderr += `\n[lifecycle] ${reason}`;
+            };
+            // Timeout handler
+            const timer = setTimeout(() => {
+                killProc(`Step timed out after ${step.timeout ?? DEFAULT_STEP_TIMEOUT_S}s`);
+                // If process doesn't close in grace period + 1s, force-resolve
+                setTimeout(() => {
+                    finish(124, `Step timed out after ${step.timeout ?? DEFAULT_STEP_TIMEOUT_S}s`);
+                }, SIGKILL_GRACE_MS + 1000);
+            }, timeoutMs);
+            // Abort signal handler
+            const onAbort = () => {
+                killProc('Aborted by signal');
+                setTimeout(() => {
+                    finish(130, 'Aborted by signal');
+                }, SIGKILL_GRACE_MS + 1000);
+            };
+            let removeAbortListener = () => { };
+            if (options.abortSignal) {
+                if (options.abortSignal.aborted) {
+                    settled = true;
+                    resolve({
+                        phase: phase,
+                        stepName: step.name,
+                        exitCode: 130,
+                        stdout: '',
+                        stderr: '',
+                        durationMs: 0,
+                        skipped: false,
+                        error: 'Aborted by signal',
+                    });
+                    return;
+                }
+                options.abortSignal.addEventListener('abort', onAbort, { once: true });
+                removeAbortListener = () => {
+                    options.abortSignal?.removeEventListener('abort', onAbort);
+                };
+            }
+            // Merge environment
+            const env = {
+                ...process.env,
+                ...(options.environment ?? {}),
+            };
+            try {
+                proc = spawn('sh', ['-c', step.command], {
+                    cwd: options.workDir,
+                    env,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+            }
+            catch (err) {
+                finish(1, err instanceof Error ? err.message : String(err));
+                return;
+            }
+            proc.stdout?.on('data', (data) => {
+                const text = data.toString();
+                stdout += text;
+                options.onLog?.(phase, step.name, text);
+            });
+            proc.stderr?.on('data', (data) => {
+                const text = data.toString();
+                stderr += text;
+                options.onLog?.(phase, step.name, text);
+            });
+            proc.on('close', (code) => {
+                finish(code ?? 1);
+            });
+            proc.on('error', (err) => {
+                finish(1, err.message);
+            });
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    skippedResult(phase, stepName) {
+        return {
+            phase,
+            stepName,
+            exitCode: -1,
+            stdout: '',
+            stderr: '',
+            durationMs: 0,
+            skipped: true,
+        };
+    }
+    isAborted(options) {
+        return options.abortSignal?.aborted ?? false;
+    }
+}
+//# sourceMappingURL=lifecycleExecutor.js.map

package/dist/lifecycleExecutor.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * BuildHive Agent - Main Entry Point
+ *
+ * Main entry point for the BuildHive agent that coordinates with the platform
+ * to execute CI jobs in isolated Docker containers.
+ *
+ * Requirements: 1.1, 1.2, 1.5, 1.6, 4.1, 4.2, 4.3, 4.4, 4.5
+ */
+/**
+ * Main function to start the BuildHive agent
+ */
+declare function main(): Promise<void>;
+export { main };
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AASH;;GAEG;AACH,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAyDnC;AAUD,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/main.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * BuildHive Agent - Main Entry Point
+ *
+ * Main entry point for the BuildHive agent that coordinates with the platform
+ * to execute CI jobs in isolated Docker containers.
+ *
+ * Requirements: 1.1, 1.2, 1.5, 1.6, 4.1, 4.2, 4.3, 4.4, 4.5
+ */
+import { BuildHiveAgent } from './agent.js';
+import { loadConfig } from './config/index.js';
+import { createLogger } from './utils/logger.js';
+import { checkStartupVersion } from './autoUpdater.js';
+const logger = createLogger('main');
+/**
+ * Main function to start the BuildHive agent
+ */
+async function main() {
+    try {
+        logger.info('Starting BuildHive Agent...');
+        // Load configuration
+        const config = await loadConfig();
+        logger.info(`Loaded configuration for agent: ${config.name}`);
+        // Check for updates before starting (Task 2.1.3)
+        // Reads version from package.json; auto-update only if config opts in
+        const { createRequire } = await import('module');
+        const require = createRequire(import.meta.url);
+        const pkg = require('../package.json');
+        await checkStartupVersion({
+            localVersion: pkg.version,
+            autoUpdate: config.enableAutoUpdates,
+        });
+        // Create and start agent with capability detection
+        const agent = await BuildHiveAgent.create(config);
+        // Handle graceful shutdown
+        const shutdown = async (signal) => {
+            logger.info(`Received ${signal}, shutting down gracefully...`);
+            try {
+                await agent.stop();
+                logger.info('Agent stopped successfully');
+                process.exit(0);
+            }
+            catch (error) {
+                logger.error('Error during shutdown:', error);
+                process.exit(1);
+            }
+        };
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        process.on('SIGQUIT', () => shutdown('SIGQUIT'));
+        // Handle uncaught exceptions
+        process.on('uncaughtException', (error) => {
+            logger.error('Uncaught exception:', error);
+            shutdown('uncaughtException').catch(() => process.exit(1));
+        });
+        process.on('unhandledRejection', (reason, promise) => {
+            logger.error('Unhandled rejection at:', promise, 'reason:', reason);
+            shutdown('unhandledRejection').catch(() => process.exit(1));
+        });
+        // Start the agent
+        await agent.start();
+        logger.info('BuildHive Agent started successfully');
+    }
+    catch (error) {
+        logger.error('Failed to start BuildHive Agent:', error);
+        process.exit(1);
+    }
+}
+// Run main function if this file is executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+export { main };
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Metrics Collector - System metrics collection and reporting
+ *
+ * Collects system performance metrics including CPU, memory, disk usage,
+ * and network statistics for monitoring and load balancing decisions.
+ *
+ * Requirements: 1.5, 1.6, 5.1, 5.2
+ */
+import { AgentConfig } from './config/types.js';
+export interface SystemMetrics {
+    cpuUsage: number;
+    memoryUsage: number;
+    diskUsage: number;
+    networkIn: number;
+    networkOut: number;
+    activeJobs: number;
+    queuedJobs: number;
+    completedJobs: number;
+    failedJobs: number;
+    timestamp: Date;
+}
+export declare class MetricsCollector {
+    private config;
+    private isRunning;
+    private metricsHistory;
+    private maxHistorySize;
+    private lastNetworkStats;
+    private jobStats;
+    constructor(config: AgentConfig);
+    /**
+     * Start metrics collection
+     */
+    start(): Promise<void>;
+    /**
+     * Stop metrics collection
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current system metrics
+     */
+    getCurrentMetrics(): Promise<SystemMetrics>;
+    /**
+     * Get metrics history
+     */
+    getMetricsHistory(): SystemMetrics[];
+    /**
+     * Update job statistics
+     */
+    updateJobStats(stats: Partial<typeof this.jobStats>): void;
+    /**
+     * Get CPU usage percentage
+     */
+    private getCpuUsage;
+    /**
+     * Get CPU times for usage calculation
+     */
+    private getCpuTimes;
+    /**
+     * Get memory usage percentage
+     */
+    private getMemoryUsage;
+    /**
+     * Get disk usage percentage
+     */
+    private getDiskUsage;
+    /**
+     * Get disk usage on Unix-like systems
+     */
+    private getDiskUsageUnix;
+    /**
+     * Get disk usage on Windows
+     */
+    private getDiskUsageWindows;
+    /**
+     * Initialize network statistics
+     */
+    private initializeNetworkStats;
+    /**
+     * Get network statistics
+     */
+    private getNetworkStats;
+    /**
+     * Read network statistics from system
+     */
+    private readNetworkStats;
+    /**
+     * Read network stats on Linux
+     */
+    private readNetworkStatsLinux;
+    /**
+     * Read network stats on macOS
+     */
+    private readNetworkStatsMacOS;
+    /**
+     * Read network stats on Windows
+     */
+    private readNetworkStatsWindows;
+    /**
+     * Add metrics to history
+     */
+    private addToHistory;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,gBAAgB,CAAyE;IACjG,OAAO,CAAC,QAAQ,CAKd;gBAEU,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC;IAyBjD;;OAEG;IACH,iBAAiB,IAAI,aAAa,EAAE;IAIpC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI;IAI1D;;OAEG;YACW,WAAW;IAwBzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;YACW,cAAc;IAc5B;;OAEG;YACW,YAAY;IAgB1B;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;YACW,mBAAmB;IAiCjC;;OAEG;YACW,sBAAsB;IAapC;;OAEG;YACW,eAAe;IAwC7B;;OAEG;YACW,gBAAgB;IAc9B;;OAEG;YACW,qBAAqB;IAwBnC;;OAEG;YACW,qBAAqB;IAwBnC;;OAEG;YACW,uBAAuB;IAwBrC;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB"}