buildhive-agent 1.0.0-beta.1

package/dist/utils/capabilities.js

@@ -0,0 +1,200 @@
+/**
+ * Capabilities Detection
+ *
+ * Detects system capabilities for agent registration using systeminformation library
+ * for accurate cross-platform system metrics.
+ *
+ * Requirements: MVP.4.1.2
+ */
+import os from 'os';
+import si from 'systeminformation';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { createLogger } from './logger.js';
+import { scanInstalledSDKs, generateTagsFromSDKs } from './sdkScanner.js';
+const execAsync = promisify(exec);
+const logger = createLogger('capabilities');
+/**
+ * Detect system capabilities with systeminformation
+ */
+export async function detectCapabilities() {
+    logger.info('Detecting system capabilities using systeminformation...');
+    try {
+        // Gather all system information in parallel
+        const [cpu, mem, osInfo, disk, dockerVersion] = await Promise.all([
+            si.cpu(),
+            si.mem(),
+            si.osInfo(),
+            si.fsSize(),
+            detectDockerVersion(),
+        ]);
+        const capabilities = {
+            os: normalizeOsName(osInfo.platform),
+            arch: normalizeArchitecture(osInfo.arch),
+            cpuCores: cpu.physicalCores || cpu.cores,
+            memoryGB: Math.round(mem.total / (1024 * 1024 * 1024)),
+            diskSpaceGB: Math.round((disk[0]?.size || 0) / (1024 * 1024 * 1024)),
+        };
+        if (dockerVersion) {
+            capabilities.dockerVersion = dockerVersion;
+        }
+        logger.info('Detected system capabilities:', capabilities);
+        return capabilities;
+    }
+    catch (error) {
+        logger.error('Failed to detect capabilities, using fallback:', error);
+        // Fallback to basic os module if systeminformation fails
+        return detectCapabilitiesFallback();
+    }
+}
+/**
+ * Fallback capability detection using Node.js os module
+ */
+function detectCapabilitiesFallback() {
+    logger.warn('Using fallback capability detection');
+    const capabilities = {
+        os: getOperatingSystem(),
+        arch: getArchitecture(),
+        cpuCores: getCpuCores(),
+        memoryGB: getMemoryGB(),
+        diskSpaceGB: 100, // Fallback value
+    };
+    // Try to detect Docker version asynchronously
+    detectDockerVersion()
+        .then(version => {
+        if (version) {
+            capabilities.dockerVersion = version;
+        }
+    })
+        .catch(() => {
+        // Ignore errors in fallback
+    });
+    return capabilities;
+}
+/**
+ * Normalize OS name to standard format
+ */
+function normalizeOsName(platform) {
+    const normalized = platform.toLowerCase();
+    if (normalized.includes('darwin') || normalized.includes('mac')) {
+        return 'macos';
+    }
+    else if (normalized.includes('win')) {
+        return 'windows';
+    }
+    else if (normalized.includes('linux')) {
+        return 'linux';
+    }
+    return normalized;
+}
+/**
+ * Normalize architecture to standard format
+ */
+function normalizeArchitecture(arch) {
+    const normalized = arch.toLowerCase();
+    if (normalized.includes('x64') || normalized.includes('amd64')) {
+        return 'x64';
+    }
+    else if (normalized.includes('arm64') || normalized.includes('aarch64')) {
+        return 'arm64';
+    }
+    else if (normalized.includes('arm')) {
+        return 'arm';
+    }
+    return normalized;
+}
+/**
+ * Get operating system
+ */
+function getOperatingSystem() {
+    const platform = os.platform();
+    switch (platform) {
+        case 'darwin':
+            return 'macos';
+        case 'linux':
+            return 'linux';
+        case 'win32':
+            return 'windows';
+        default:
+            return platform;
+    }
+}
+/**
+ * Get system architecture
+ */
+function getArchitecture() {
+    const arch = os.arch();
+    switch (arch) {
+        case 'x64':
+            return 'x64';
+        case 'arm64':
+            return 'arm64';
+        case 'arm':
+            return 'arm';
+        default:
+            return arch;
+    }
+}
+/**
+ * Get CPU core count
+ */
+function getCpuCores() {
+    return os.cpus().length;
+}
+/**
+ * Get total memory in GB
+ */
+function getMemoryGB() {
+    const totalMemory = os.totalmem();
+    return Math.round(totalMemory / (1024 * 1024 * 1024));
+}
+/**
+ * Get available disk space in GB
+ */
+function getDiskSpaceGB() {
+    // This is a simplified implementation
+    // In a real scenario, you'd want to check the actual disk space
+    // For now, we'll return a reasonable default
+    return 100; // GB
+}
+/**
+ * Detect Docker version
+ */
+async function detectDockerVersion() {
+    try {
+        const { stdout } = await execAsync('docker --version');
+        const match = stdout.match(/Docker version ([^,\s]+)/);
+        return match ? match[1] : null;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Detect detailed capabilities including SDK/toolchain information and
+ * auto-generated tags.  This extends the basic {@link detectCapabilities}
+ * with an SDK scan and tag generation pass.
+ *
+ * @param manualTags - Optional tags supplied by the user configuration that
+ *   will be merged (and deduplicated) with auto-detected tags.
+ */
+export async function detectDetailedCapabilities(manualTags = []) {
+    logger.info('Detecting detailed capabilities (base + SDKs)...');
+    // Gather base capabilities and SDK scan in parallel
+    const [base, sdks] = await Promise.all([
+        detectCapabilities(),
+        scanInstalledSDKs(),
+    ]);
+    const autoTags = generateTagsFromSDKs(sdks);
+    // Merge platform tags (os, arch) with SDK tags and manual tags
+    const platformTags = [base.os, base.arch].filter(Boolean);
+    const allTags = [...new Set([...platformTags, ...autoTags, ...manualTags])];
+    const detailed = {
+        ...base,
+        sdks,
+        tags: allTags,
+    };
+    logger.info(`Detailed capabilities: ${allTags.length} tags generated`);
+    return detailed;
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/utils/capabilities.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Logger Utility
+ *
+ * File-based + console logging with rotation for the BuildHive agent.
+ * Writes structured JSON to ~/.buildhive/logs/buildhive-agent.log
+ * with automatic rotation (max 10MB per file, keep 5 files).
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare function createLogger(component: string, logLevel?: LogLevel): Logger;
+/** Return the path to the active log file */
+export declare function getLogFilePath(): string;
+/** Return the log directory */
+export declare function getLogDir(): string;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAkLD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAM3E;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/utils/logger.js

@@ -0,0 +1,188 @@
+/**
+ * Logger Utility
+ *
+ * File-based + console logging with rotation for the BuildHive agent.
+ * Writes structured JSON to ~/.buildhive/logs/buildhive-agent.log
+ * with automatic rotation (max 10MB per file, keep 5 files).
+ */
+import { existsSync, mkdirSync, statSync, renameSync, appendFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import os from 'os';
+// ---------------------------------------------------------------------------
+// Log file configuration
+// ---------------------------------------------------------------------------
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB
+const MAX_FILES = 5;
+let logDirReady = false;
+let _logDir = null;
+let _logFile = null;
+function getLogDirInternal() {
+    if (!_logDir)
+        _logDir = join(os.homedir(), '.buildhive', 'logs');
+    return _logDir;
+}
+function getLogFileInternal() {
+    if (!_logFile)
+        _logFile = join(getLogDirInternal(), 'buildhive-agent.log');
+    return _logFile;
+}
+function ensureLogDir() {
+    if (logDirReady)
+        return;
+    try {
+        if (!existsSync(getLogDirInternal())) {
+            mkdirSync(getLogDirInternal(), { recursive: true });
+        }
+        logDirReady = true;
+    }
+    catch {
+        // If we can't create log dir, console-only mode
+    }
+}
+function rotateIfNeeded() {
+    try {
+        const LOG_FILE = getLogFileInternal();
+        if (!existsSync(LOG_FILE))
+            return;
+        const stats = statSync(LOG_FILE);
+        if (stats.size < MAX_FILE_SIZE)
+            return;
+        // Delete oldest rotated file if it exists, then shift chain
+        const oldest = `${LOG_FILE}.${MAX_FILES}`;
+        if (existsSync(oldest)) {
+            unlinkSync(oldest);
+        }
+        for (let i = MAX_FILES - 1; i >= 1; i--) {
+            const from = `${LOG_FILE}.${i}`;
+            const to = `${LOG_FILE}.${i + 1}`;
+            if (existsSync(from)) {
+                renameSync(from, to);
+            }
+        }
+        renameSync(LOG_FILE, `${LOG_FILE}.1`);
+    }
+    catch {
+        // Rotation failure is non-fatal
+    }
+}
+// ---------------------------------------------------------------------------
+// Async write buffer — flushes every 100ms or when buffer exceeds 64KB
+// ---------------------------------------------------------------------------
+const FLUSH_INTERVAL = 100; // ms
+const FLUSH_SIZE = 64 * 1024; // 64KB
+let writeBuffer = [];
+let flushTimer = null;
+let flushing = false;
+function scheduleFlush() {
+    if (flushTimer)
+        return;
+    flushTimer = setTimeout(() => {
+        flushTimer = null;
+        flushBuffer();
+    }, FLUSH_INTERVAL);
+}
+function flushBuffer() {
+    if (flushing || writeBuffer.length === 0)
+        return;
+    flushing = true;
+    const batch = writeBuffer.join('\n') + '\n';
+    writeBuffer = [];
+    try {
+        rotateIfNeeded();
+        // Use appendFile async via import — but since we need synchronous module-level
+        // compatibility, use appendFileSync here in a non-blocking wrapper
+        // The batching itself reduces syscalls from N-per-log to 1-per-batch
+        appendFileSync(getLogFileInternal(), batch, 'utf-8');
+    }
+    catch {
+        // File write failure is non-fatal
+    }
+    finally {
+        flushing = false;
+    }
+}
+function writeToFile(entry) {
+    ensureLogDir();
+    if (!logDirReady)
+        return;
+    writeBuffer.push(entry);
+    // Flush immediately if buffer is large
+    if (writeBuffer.join('').length >= FLUSH_SIZE) {
+        flushBuffer();
+    }
+    else {
+        scheduleFlush();
+    }
+}
+// ---------------------------------------------------------------------------
+// SimpleLogger — console + file
+// ---------------------------------------------------------------------------
+class SimpleLogger {
+    component;
+    logLevel;
+    constructor(component, logLevel = 'info') {
+        this.component = component;
+        this.logLevel = logLevel;
+    }
+    debug(message, ...args) {
+        if (this.shouldLog('debug'))
+            this.emit('DEBUG', message, args);
+    }
+    info(message, ...args) {
+        if (this.shouldLog('info'))
+            this.emit('INFO', message, args);
+    }
+    warn(message, ...args) {
+        if (this.shouldLog('warn'))
+            this.emit('WARN', message, args);
+    }
+    error(message, ...args) {
+        if (this.shouldLog('error'))
+            this.emit('ERROR', message, args);
+    }
+    emit(level, message, args) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${level}] [${this.component}]`;
+        // Console output (human-readable)
+        const consoleFn = level === 'ERROR' ? console.error
+            : level === 'WARN' ? console.warn
+                : level === 'DEBUG' ? console.debug
+                    : console.info;
+        consoleFn(`${prefix} ${message}`, ...args);
+        // File output (structured JSON line)
+        const entry = {
+            ts: timestamp,
+            level,
+            component: this.component,
+            msg: message,
+        };
+        if (args.length > 0) {
+            entry.data = args.map(a => a instanceof Error ? { name: a.name, message: a.message, stack: a.stack } : a);
+        }
+        writeToFile(JSON.stringify(entry));
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.logLevel);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+const VALID_LEVELS = ['debug', 'info', 'warn', 'error'];
+export function createLogger(component, logLevel) {
+    const envLevel = process.env.BUILDHIVE_LOG_LEVEL;
+    const level = logLevel
+        || (VALID_LEVELS.includes(envLevel) ? envLevel : undefined)
+        || 'info';
+    return new SimpleLogger(component, level);
+}
+/** Return the path to the active log file */
+export function getLogFilePath() {
+    return getLogFileInternal();
+}
+/** Return the log directory */
+export function getLogDir() {
+    return getLogDirInternal();
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/sdkScanner.d.ts

@@ -0,0 +1,105 @@
+/**
+ * SDK & Toolchain Scanner
+ *
+ * Detects installed SDKs, compilers, and developer toolchains on the host
+ * machine.  Results feed into capability tags so the server can match jobs
+ * to agents that have the right tools.
+ *
+ * Design notes:
+ *  - Every detection is wrapped in try/catch so a missing tool never crashes
+ *    the scanner.
+ *  - Commands have a 5-second timeout to avoid blocking on hung processes.
+ *  - Works on macOS, Linux, and Windows (adjusts commands per platform).
+ *
+ * Requirements: MVP.4.1.2 (enhanced)
+ */
+/** Basic information about an installed SDK / tool. */
+export interface SDKInfo {
+    name: string;
+    version: string;
+    path?: string;
+    metadata?: Record<string, string>;
+}
+/** Aggregated result of scanning all known SDKs on the host. */
+export interface SDKScanResult {
+    java?: SDKInfo & {
+        javaHome: string;
+    };
+    kotlin?: SDKInfo;
+    gradle?: SDKInfo;
+    maven?: SDKInfo;
+    xcode?: SDKInfo & {
+        xcodeSelectPath: string;
+        sdks: string[];
+    };
+    androidSdk?: SDKInfo & {
+        androidHome: string;
+        apiLevels: number[];
+        buildToolsVersions: string[];
+    };
+    flutter?: SDKInfo & {
+        dartVersion: string;
+    };
+    cocoapods?: SDKInfo;
+    node?: SDKInfo & {
+        npmVersion?: string;
+    };
+    yarn?: SDKInfo;
+    pnpm?: SDKInfo;
+    python?: SDKInfo & {
+        pipVersion?: string;
+    };
+    go?: SDKInfo & {
+        gopath?: string;
+    };
+    rust?: SDKInfo & {
+        cargoVersion?: string;
+    };
+    ruby?: SDKInfo & {
+        bundlerVersion?: string;
+    };
+    dotnet?: SDKInfo;
+    docker?: SDKInfo & {
+        composeVersion?: string;
+    };
+    terraform?: SDKInfo;
+    kubectl?: SDKInfo;
+    git?: SDKInfo;
+    cmake?: SDKInfo;
+    make?: SDKInfo;
+}
+/**
+ * Run a shell command synchronously, returning trimmed stdout or `null` on
+ * failure.  Stderr is included in the output because some tools (notably
+ * `java -version`) print to stderr.
+ */
+export declare function runCmd(cmd: string, timeoutMs?: number): string | null;
+/**
+ * Extract major version number from a semver-ish string.
+ * e.g. "17.0.9" -> 17, "1.8.0_392" -> 8 (Java-specific handled externally).
+ */
+export declare function majorVersion(version: string): number;
+/**
+ * Extract major.minor from a version string.
+ * e.g. "15.4.1" -> "15.4"
+ */
+export declare function majorMinor(version: string): string;
+/**
+ * Scan the host for all known SDKs and toolchains.
+ *
+ * Each detector is independent and wrapped in try/catch so a failure in one
+ * tool never blocks detection of the others.
+ */
+export declare function scanInstalledSDKs(): Promise<SDKScanResult>;
+/**
+ * Generate capability tags from an SDK scan result.
+ *
+ * Tag conventions:
+ *  - Generic tag without version: `java`, `docker`, `xcode`
+ *  - Major-version tag: `java-17`, `node-20`, `go-1`
+ *  - For Xcode, major.minor: `xcode-15.4`
+ *  - For Android SDK, highest API level: `android-sdk-34`
+ *  - Special: `docker` (Docker available), `dind` (Docker-in-Docker capable)
+ */
+export declare function generateTagsFromSDKs(sdks: SDKScanResult): string[];
+//# sourceMappingURL=sdkScanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdkScanner.d.ts","sourceRoot":"","sources":["../../src/utils/sdkScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,uDAAuD;AACvD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAE5B,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClG,OAAO,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,EAAE,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IAGjB,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAuB,GAAG,MAAM,GAAG,IAAI,CAsBrF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlD;AAoTD;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CA+ChE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAsElE"}