buildhive-agent 1.0.0-beta.1

package/dist/executors/nativeExecutor.js

@@ -0,0 +1,311 @@
+/**
+ * Native Executor - Non-Docker job execution
+ *
+ * Runs build commands directly on the host OS in an isolated temp workspace.
+ * Designed for iOS/macOS builds that require native toolchains (Xcode, etc.)
+ * which are not available inside Docker containers.
+ *
+ * Security model:
+ * - Jobs run in an isolated temp directory (not the developer's workspace)
+ * - Environment variables are explicitly injected (PATH preserved)
+ * - Timeout enforcement with graceful shutdown (SIGTERM → 10s → SIGKILL)
+ */
+import { spawn } from 'child_process';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { randomUUID } from 'crypto';
+export class NativeExecutor {
+    config;
+    type = 'native';
+    tempWorkspaces = new Set();
+    constructor(config = {}) {
+        this.config = config;
+    }
+    async validate() {
+        const errors = [];
+        // 1. Check OS is macOS or Linux
+        const platform = process.platform;
+        if (platform !== 'darwin' && platform !== 'linux') {
+            errors.push(`Native execution is not supported on ${platform}. Requires macOS or Linux.`);
+        }
+        // 2. Check temp directory is writable
+        const testDir = join(tmpdir(), `buildhive-validate-${randomUUID()}`);
+        try {
+            await fs.mkdir(testDir, { recursive: true });
+            const testFile = join(testDir, 'test');
+            await fs.writeFile(testFile, 'test');
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            errors.push(`Temp directory ${tmpdir()} is not writable`);
+        }
+        // 3. Check shell is available
+        const shellAvailable = await this.checkShellAvailable();
+        if (!shellAvailable) {
+            errors.push('No supported shell found (bash or zsh)');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    async execute(options) {
+        const startTime = Date.now();
+        const timeout = options.timeout ?? this.config.defaultTimeout ?? 600_000; // 10 min default
+        // 1. Create isolated workspace
+        const workspace = join(tmpdir(), `buildhive-native-${randomUUID()}`);
+        await fs.mkdir(workspace, { recursive: true });
+        this.tempWorkspaces.add(workspace);
+        // Ensure workDir exists (may be the workspace itself or a subdirectory)
+        const workDir = options.workDir || workspace;
+        await fs.mkdir(workDir, { recursive: true });
+        let stdout = '';
+        let stderr = '';
+        let logs = '';
+        try {
+            // 2. Build environment: preserve PATH and SDK paths, merge user env
+            const environment = this.buildEnvironment(options.environment);
+            // 3. Resolve shell
+            const shell = await this.resolveShell();
+            // 4. Spawn child process
+            const result = await new Promise((resolve, reject) => {
+                const proc = spawn(shell, ['-c', options.command], {
+                    cwd: workDir,
+                    env: environment,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                let killed = false;
+                let killTimer;
+                // Timeout enforcement: SIGTERM then SIGKILL after 10s
+                const timeoutTimer = setTimeout(() => {
+                    if (!killed) {
+                        killed = true;
+                        proc.kill('SIGTERM');
+                        killTimer = setTimeout(() => {
+                            proc.kill('SIGKILL');
+                        }, 10_000);
+                    }
+                }, timeout);
+                // Abort signal handling
+                const onAbort = () => {
+                    if (!killed) {
+                        killed = true;
+                        proc.kill('SIGTERM');
+                        killTimer = setTimeout(() => {
+                            proc.kill('SIGKILL');
+                        }, 10_000);
+                    }
+                };
+                if (options.abortSignal) {
+                    options.abortSignal.addEventListener('abort', onAbort, { once: true });
+                }
+                // Stream stdout
+                proc.stdout?.on('data', (data) => {
+                    const text = data.toString();
+                    stdout += text;
+                    // Stream line by line to onLog
+                    const lines = text.split('\n');
+                    for (const line of lines) {
+                        if (line.length > 0) {
+                            logs += line + '\n';
+                            options.onLog?.(line);
+                        }
+                    }
+                });
+                // Stream stderr
+                proc.stderr?.on('data', (data) => {
+                    const text = data.toString();
+                    stderr += text;
+                    const lines = text.split('\n');
+                    for (const line of lines) {
+                        if (line.length > 0) {
+                            logs += line + '\n';
+                            options.onLog?.(line);
+                        }
+                    }
+                });
+                proc.on('close', (code) => {
+                    clearTimeout(timeoutTimer);
+                    if (killTimer)
+                        clearTimeout(killTimer);
+                    if (options.abortSignal) {
+                        options.abortSignal.removeEventListener('abort', onAbort);
+                    }
+                    if (killed && code === null) {
+                        resolve({ exitCode: 143 }); // SIGTERM exit code
+                    }
+                    else {
+                        resolve({ exitCode: code ?? 1 });
+                    }
+                });
+                proc.on('error', (err) => {
+                    clearTimeout(timeoutTimer);
+                    if (killTimer)
+                        clearTimeout(killTimer);
+                    if (options.abortSignal) {
+                        options.abortSignal.removeEventListener('abort', onAbort);
+                    }
+                    reject(err);
+                });
+            });
+            // 5. Collect artifacts
+            const artifacts = await this.collectArtifacts(workDir, options.artifactPaths || []);
+            const durationMs = Date.now() - startTime;
+            return {
+                exitCode: result.exitCode,
+                stdout,
+                stderr,
+                durationMs,
+                artifacts,
+                logs,
+            };
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            return {
+                exitCode: 1,
+                stdout,
+                stderr: stderr + (error instanceof Error ? error.message : String(error)),
+                durationMs,
+                artifacts: [],
+                logs,
+            };
+        }
+    }
+    async cleanup() {
+        const removePromises = Array.from(this.tempWorkspaces).map(async (dir) => {
+            try {
+                await fs.rm(dir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        });
+        await Promise.all(removePromises);
+        this.tempWorkspaces.clear();
+    }
+    /**
+     * Build the environment for the child process.
+     * Preserves PATH and common SDK paths from the system, then merges user-provided vars.
+     */
+    buildEnvironment(userEnv) {
+        // Start with essential system env vars
+        const base = {};
+        // Preserve PATH
+        if (process.env.PATH) {
+            base.PATH = process.env.PATH;
+        }
+        // Preserve common SDK paths
+        const sdkVars = [
+            'HOME',
+            'USER',
+            'SHELL',
+            'LANG',
+            'JAVA_HOME',
+            'ANDROID_HOME',
+            'ANDROID_SDK_ROOT',
+            'DEVELOPER_DIR', // Xcode
+            'SDKROOT',
+        ];
+        for (const key of sdkVars) {
+            if (process.env[key]) {
+                base[key] = process.env[key];
+            }
+        }
+        // Merge user-provided environment (overrides base)
+        return { ...base, ...(userEnv || {}) };
+    }
+    /**
+     * Resolve the best available shell.
+     */
+    async resolveShell() {
+        // Prefer bash, fall back to zsh, then sh
+        for (const shell of ['/bin/bash', '/bin/zsh', '/bin/sh']) {
+            try {
+                await fs.access(shell);
+                return shell;
+            }
+            catch {
+                continue;
+            }
+        }
+        return '/bin/sh';
+    }
+    /**
+     * Check if a supported shell is available.
+     */
+    async checkShellAvailable() {
+        for (const shell of ['/bin/bash', '/bin/zsh', '/bin/sh']) {
+            try {
+                await fs.access(shell);
+                return true;
+            }
+            catch {
+                continue;
+            }
+        }
+        return false;
+    }
+    /**
+     * Collect artifacts matching glob-like patterns from the workDir.
+     * Walks the directory tree and matches files against the patterns.
+     * Patterns can include ** for recursive matching and * for single-segment matching.
+     */
+    async collectArtifacts(workDir, patterns) {
+        if (patterns.length === 0) {
+            return [];
+        }
+        const allFiles = await this.walkDirectory(workDir);
+        const matched = [];
+        for (const filePath of allFiles) {
+            // Get path relative to workDir
+            const relativePath = filePath.substring(workDir.length + 1);
+            for (const pattern of patterns) {
+                if (this.matchPattern(relativePath, pattern)) {
+                    matched.push(filePath);
+                    break; // Don't add same file twice
+                }
+            }
+        }
+        return matched;
+    }
+    /**
+     * Recursively walk a directory and return all file paths.
+     */
+    async walkDirectory(dir) {
+        const files = [];
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    const subFiles = await this.walkDirectory(fullPath);
+                    files.push(...subFiles);
+                }
+                else {
+                    files.push(fullPath);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or isn't readable
+        }
+        return files;
+    }
+    /**
+     * Simple glob-like pattern matching.
+     * Supports * (any segment chars) and ** (any path depth).
+     */
+    matchPattern(filePath, pattern) {
+        // Convert glob to regex
+        const regexStr = pattern
+            .replace(/\./g, '\\.')
+            .replace(/\*\*/g, '{{GLOBSTAR}}')
+            .replace(/\*/g, '[^/]*')
+            .replace(/\{\{GLOBSTAR\}\}/g, '.*');
+        const regex = new RegExp(`^${regexStr}$`);
+        return regex.test(filePath);
+    }
+}
+//# sourceMappingURL=nativeExecutor.js.map

package/dist/executors/nativeExecutor.js.map

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

package/dist/executors/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Executor Interface Types
+ *
+ * Defines the common interface for all execution backends (Docker, Native).
+ * This abstraction allows the agent to transparently switch between
+ * Docker-based and native (non-Docker) execution.
+ */
+export interface ExecutionResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    artifacts: string[];
+    logs: string;
+}
+export interface ExecutionOptions {
+    workDir: string;
+    command: string;
+    environment?: Record<string, string>;
+    timeout?: number;
+    onLog?: (log: string) => void;
+    onProgress?: (percent: number, stage: string) => void;
+    abortSignal?: AbortSignal;
+    artifactPaths?: string[];
+}
+export interface Executor {
+    readonly type: 'docker' | 'native';
+    /** Validate the executor is available (Docker running, sandbox available, etc.) */
+    validate(): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    /** Execute a build job */
+    execute(options: ExecutionOptions): Promise<ExecutionResult>;
+    /** Cleanup after execution */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAEnC,mFAAmF;IACnF,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAE1D,0BAA0B;IAC1B,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7D,8BAA8B;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/executors/types.js

@@ -0,0 +1,9 @@
+/**
+ * Executor Interface Types
+ *
+ * Defines the common interface for all execution backends (Docker, Native).
+ * This abstraction allows the agent to transparently switch between
+ * Docker-based and native (non-Docker) execution.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/executors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/healthMonitor.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Health Monitor Module
+ *
+ * Advanced health monitoring system for the BuildHive agent including:
+ * - System resource monitoring
+ * - Performance metrics tracking
+ * - Predictive health analysis
+ * - Automated recovery actions
+ *
+ * Requirements: 6.1
+ */
+import { EventEmitter } from 'events';
+export interface HealthMetrics {
+    timestamp: Date;
+    system: {
+        cpuUsage: number;
+        memoryUsage: number;
+        diskUsage: number;
+        loadAverage: number[];
+        uptime: number;
+        networkConnections: number;
+    };
+    process: {
+        memoryUsage: NodeJS.MemoryUsage;
+        cpuUsage: NodeJS.CpuUsage;
+        uptime: number;
+        activeHandles: number;
+        activeRequests: number;
+    };
+    application: {
+        activeJobs: number;
+        jobSuccessRate: number;
+        averageJobDuration: number;
+        errorRate: number;
+        responseTime: number;
+    };
+}
+export interface HealthThresholds {
+    cpu: {
+        warning: number;
+        critical: number;
+    };
+    memory: {
+        warning: number;
+        critical: number;
+    };
+    disk: {
+        warning: number;
+        critical: number;
+    };
+    errorRate: {
+        warning: number;
+        critical: number;
+    };
+    responseTime: {
+        warning: number;
+        critical: number;
+    };
+}
+export interface HealthAlert {
+    id: string;
+    severity: 'info' | 'warning' | 'critical';
+    category: 'system' | 'process' | 'application';
+    metric: string;
+    message: string;
+    value: number;
+    threshold: number;
+    timestamp: Date;
+    resolved?: Date;
+}
+export interface HealthTrend {
+    metric: string;
+    direction: 'improving' | 'stable' | 'degrading';
+    confidence: number;
+    prediction: {
+        nextValue: number;
+        timeToThreshold?: number;
+    };
+}
+export declare class HealthMonitor extends EventEmitter {
+    private thresholds;
+    private metrics;
+    private alerts;
+    private monitoringInterval;
+    private isMonitoring;
+    private maxMetricsHistory;
+    private jobStats;
+    constructor(thresholds?: Partial<HealthThresholds>);
+    /**
+     * Start health monitoring
+     */
+    start(intervalSeconds?: number): void;
+    /**
+     * Stop health monitoring
+     */
+    stop(): void;
+    /**
+     * Get current health status
+     */
+    getCurrentHealth(): {
+        status: 'healthy' | 'warning' | 'critical';
+        metrics: HealthMetrics | null;
+        activeAlerts: HealthAlert[];
+        trends: HealthTrend[];
+        score: number;
+    };
+    /**
+     * Record job execution for health tracking
+     */
+    recordJobExecution(duration: number, success: boolean): void;
+    /**
+     * Get health history
+     */
+    getHealthHistory(hours?: number): HealthMetrics[];
+    /**
+     * Get alert history
+     */
+    getAlertHistory(hours?: number): HealthAlert[];
+    /**
+     * Update health thresholds
+     */
+    updateThresholds(newThresholds: Partial<HealthThresholds>): void;
+    /**
+     * Collect comprehensive health metrics
+     */
+    private collectMetrics;
+    /**
+     * Collect system-level metrics
+     */
+    private collectSystemMetrics;
+    /**
+     * Collect process-level metrics
+     */
+    private collectProcessMetrics;
+    /**
+     * Collect application-level metrics
+     */
+    private collectApplicationMetrics;
+    /**
+     * Analyze health and generate alerts
+     */
+    private analyzeHealth;
+    /**
+     * Check a metric against thresholds
+     */
+    private checkThreshold;
+    /**
+     * Check for memory leaks
+     */
+    private checkMemoryLeak;
+    /**
+     * Check for performance degradation
+     */
+    private checkPerformanceDegradation;
+    /**
+     * Create a new alert
+     */
+    private createAlert;
+    /**
+     * Resolve an alert
+     */
+    private resolveAlert;
+    /**
+     * Generate alert message
+     */
+    private generateAlertMessage;
+    /**
+     * Calculate trends for metrics
+     */
+    private calculateTrends;
+    /**
+     * Create trend analysis
+     */
+    private createTrend;
+    /**
+     * Get metric value from health metrics
+     */
+    private getMetricValue;
+    /**
+     * Calculate linear trend
+     */
+    private calculateLinearTrend;
+    /**
+     * Determine overall health status
+     */
+    private determineOverallStatus;
+    /**
+     * Calculate overall health score
+     */
+    private calculateHealthScore;
+    /**
+     * Trigger recovery actions for critical alerts
+     */
+    private triggerRecoveryAction;
+    /**
+     * Check for alert recovery
+     */
+    private checkForRecovery;
+    /**
+     * Recovery action implementations
+     */
+    private triggerGarbageCollection;
+    private reduceProcessingLoad;
+    private cleanupTempFiles;
+    /**
+     * System metric collection helpers
+     */
+    private getCpuUsage;
+    private getMemoryUsage;
+    private getDiskUsage;
+    private getNetworkConnections;
+}
+//# sourceMappingURL=healthMonitor.d.ts.map

package/dist/healthMonitor.d.ts.map

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