buildhive-agent 1.0.0-beta.1

package/dist/enhancedJobExecutor.js

@@ -0,0 +1,223 @@
+/**
+ * Enhanced Job Executor
+ *
+ * Orchestrates the full enhanced pipeline with recipe awareness:
+ *   1. Acceptance check (should we accept this job?)
+ *   2. Resource governance check (do we have resources?)
+ *   3. Recipe detection (what kind of project is this?)
+ *   4. Recipe application (merge recipe config into job)
+ *   5. Executor selection (Docker vs Native)
+ *   6. Cache setup (mount cache volumes)
+ *   7. Lifecycle execution (setup -> build -> teardown)
+ *   8. Cache save (update metadata)
+ *   9. Result reporting
+ *
+ * This module does NOT modify the existing JobExecutor. It wraps
+ * the new subsystems (RecipeRegistry, CacheManager, AcceptanceChecker,
+ * ResourceGovernor, ExecutorFactory, LifecycleExecutor) into a single
+ * cohesive pipeline.
+ */
+import { ExecutorFactory } from './executors/executorFactory.js';
+import { LifecycleExecutor } from './lifecycleExecutor.js';
+const defaultSnapshotProvider = () => ({
+    cpuPercent: 10,
+    memoryPercent: 30,
+    diskFreeGB: 50,
+    activeJobs: 0,
+});
+// ---------------------------------------------------------------------------
+// EnhancedJobExecutor
+// ---------------------------------------------------------------------------
+export class EnhancedJobExecutor {
+    recipeRegistry;
+    cacheManager;
+    acceptanceChecker;
+    resourceGovernor;
+    config;
+    lifecycleExecutor;
+    snapshotProvider;
+    constructor(recipeRegistry, cacheManager, acceptanceChecker, resourceGovernor, config, snapshotProvider) {
+        this.recipeRegistry = recipeRegistry;
+        this.cacheManager = cacheManager;
+        this.acceptanceChecker = acceptanceChecker;
+        this.resourceGovernor = resourceGovernor;
+        this.config = config;
+        this.lifecycleExecutor = new LifecycleExecutor();
+        this.snapshotProvider = snapshotProvider ?? defaultSnapshotProvider;
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    async executeJob(job, callbacks) {
+        const startTime = Date.now();
+        const allLogs = [];
+        const log = (msg) => {
+            allLogs.push(msg);
+            callbacks?.onLog?.(msg);
+        };
+        // ---- Step 1: Acceptance check ----
+        callbacks?.onProgress?.(5, 'acceptance-check');
+        log('[enhanced] Checking acceptance rules...');
+        const recipeName = job.recipe ?? undefined;
+        const candidate = {
+            recipe: recipeName,
+            repository: job.repository,
+            requiresDocker: (job.executionMode ?? this.config.executionMode) === 'docker',
+        };
+        const acceptance = this.acceptanceChecker.shouldAccept(candidate);
+        if (!acceptance.accepted) {
+            log(`[enhanced] Job rejected by acceptance checker: ${acceptance.reason}`);
+            return this.rejectionResult(acceptance.reason, startTime, allLogs);
+        }
+        // ---- Step 2: Resource governance check ----
+        callbacks?.onProgress?.(10, 'resource-check');
+        log('[enhanced] Checking resource availability...');
+        const snapshot = this.snapshotProvider();
+        const resourceDecision = this.resourceGovernor.canAcceptJob(snapshot);
+        if (!resourceDecision.allowed) {
+            log(`[enhanced] Job rejected by resource governor: ${resourceDecision.reason}`);
+            return this.rejectionResult(resourceDecision.reason, startTime, allLogs);
+        }
+        // ---- Step 3: Recipe detection ----
+        callbacks?.onProgress?.(15, 'recipe-detection');
+        log('[enhanced] Detecting recipe...');
+        let recipe;
+        if (job.recipe) {
+            // Explicit recipe override
+            recipe = this.recipeRegistry.get(job.recipe);
+            if (recipe) {
+                log(`[enhanced] Using explicit recipe: ${recipe.name}`);
+            }
+            else {
+                log(`[enhanced] Explicit recipe "${job.recipe}" not found, proceeding without recipe`);
+            }
+        }
+        else {
+            // Auto-detect
+            const matches = await this.recipeRegistry.detectRecipe(job.workDir);
+            if (matches.length > 0) {
+                recipe = matches[0].recipe;
+                log(`[enhanced] Auto-detected recipe: ${recipe.name} (confidence: ${matches[0].confidence})`);
+            }
+            else {
+                log('[enhanced] No recipe detected, using job defaults');
+            }
+        }
+        // ---- Step 4: Apply recipe overrides ----
+        callbacks?.onProgress?.(20, 'recipe-apply');
+        const effectiveDockerImage = recipe?.dockerImage ?? job.dockerImage;
+        const effectiveEnv = {
+            ...(recipe?.environment ?? {}),
+            ...(job.environment ?? {}),
+        };
+        const effectiveBuildCommand = job.buildCommand || recipe?.defaultBuildCommand || 'echo "No build command"';
+        const setupSteps = recipe?.setup ?? [];
+        const teardownSteps = recipe?.teardown ?? [];
+        const effectiveArtifacts = job.artifacts ?? recipe?.artifacts?.paths ?? [];
+        const effectiveMode = job.executionMode ?? recipe?.executionMode ?? this.config.executionMode;
+        if (recipe) {
+            log(`[enhanced] Recipe applied: dockerImage=${effectiveDockerImage}, env keys=[${Object.keys(effectiveEnv).join(',')}]`);
+        }
+        // ---- Step 5: Executor selection ----
+        callbacks?.onProgress?.(25, 'executor-selection');
+        const executor = ExecutorFactory.create({
+            mode: effectiveMode,
+            dockerAvailable: this.config.dockerAvailable,
+            jobRequirements: {
+                requiredOS: recipe?.requiredOS,
+                executionMode: effectiveMode,
+            },
+        });
+        const executionMode = executor.type;
+        log(`[enhanced] Selected executor: ${executionMode}`);
+        // ---- Step 6: Cache setup ----
+        callbacks?.onProgress?.(30, 'cache-setup');
+        let cacheMounts = [];
+        let cacheHit = false;
+        if (recipe?.cache) {
+            log('[enhanced] Setting up cache volumes...');
+            cacheMounts = this.cacheManager.generateVolumeMounts(recipe.cache);
+            // A cache "hit" means we already have entries for these paths
+            cacheHit = cacheMounts.length > 0;
+            log(`[enhanced] Generated ${cacheMounts.length} cache volume mounts`);
+        }
+        // ---- Step 7: Lifecycle execution ----
+        callbacks?.onProgress?.(35, 'lifecycle-execution');
+        log('[enhanced] Starting lifecycle execution...');
+        let lifecycleResult;
+        try {
+            lifecycleResult = await this.lifecycleExecutor.execute(setupSteps, effectiveBuildCommand, teardownSteps, {
+                workDir: job.workDir,
+                environment: effectiveEnv,
+                onProgress: (phase, step, progress) => {
+                    // Map lifecycle progress (0-100) into the 35-95 range
+                    const mappedProgress = 35 + Math.round(progress * 0.6);
+                    callbacks?.onProgress?.(mappedProgress, `${phase}:${step}`);
+                },
+                onLog: (_phase, _step, logLine) => {
+                    log(logLine);
+                },
+            });
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            log(`[enhanced] Lifecycle execution error: ${errorMsg}`);
+            return {
+                success: false,
+                exitCode: 1,
+                logs: allLogs.join('\n'),
+                artifacts: [],
+                durationMs: Date.now() - startTime,
+                recipe: recipe?.name,
+                cacheHit,
+                executionMode,
+                rejection: undefined,
+            };
+        }
+        // ---- Step 8: Cache save ----
+        callbacks?.onProgress?.(96, 'cache-save');
+        if (recipe?.cache) {
+            log('[enhanced] Saving cache metadata...');
+            try {
+                await this.cacheManager.saveMetadata();
+            }
+            catch (error) {
+                log(`[enhanced] Cache save warning: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // ---- Step 9: Result reporting ----
+        callbacks?.onProgress?.(100, 'complete');
+        const success = lifecycleResult.overallSuccess;
+        log(`[enhanced] Job ${job.id} ${success ? 'completed successfully' : 'failed'} (duration: ${lifecycleResult.totalDurationMs}ms)`);
+        return {
+            success,
+            exitCode: lifecycleResult.executeResult.exitCode,
+            logs: allLogs.join('\n'),
+            artifacts: effectiveArtifacts,
+            durationMs: Date.now() - startTime,
+            recipe: recipe?.name,
+            cacheHit,
+            executionMode,
+            lifecycleResults: {
+                setupResults: lifecycleResult.setupResults,
+                teardownResults: lifecycleResult.teardownResults,
+            },
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    rejectionResult(reason, startTime, logs) {
+        return {
+            success: false,
+            exitCode: -1,
+            logs: logs.join('\n'),
+            artifacts: [],
+            durationMs: Date.now() - startTime,
+            cacheHit: false,
+            executionMode: 'docker',
+            rejection: { reason },
+        };
+    }
+}
+//# sourceMappingURL=enhancedJobExecutor.js.map

package/dist/enhancedJobExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedJobExecutor.js","sourceRoot":"","sources":["../src/enhancedJobExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAmB,MAAM,wBAAwB,CAAC;AA0D5E,MAAM,uBAAuB,GAA6B,GAAG,EAAE,CAAC,CAAC;IAC/D,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,CAAC;CACd,CAAC,CAAC;AAEH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,OAAO,mBAAmB;IAKpB;IACA;IACA;IACA;IACA;IARF,iBAAiB,CAAoB;IACrC,gBAAgB,CAA2B;IAEnD,YACU,cAA8B,EAC9B,YAA0B,EAC1B,iBAAoC,EACpC,gBAAkC,EAClC,MAAiC,EACzC,gBAA2C;QALnC,mBAAc,GAAd,cAAc,CAAgB;QAC9B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,WAAM,GAAN,MAAM,CAA2B;QAGzC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACjD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,IAAI,uBAAuB,CAAC;IACtE,CAAC;IAED,0EAA0E;IAC1E,aAAa;IACb,0EAA0E;IAE1E,KAAK,CAAC,UAAU,CACd,GAAuB,EACvB,SAAgC;QAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE;YAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC;QAEF,qCAAqC;QACrC,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC/C,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAE/C,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC;QAC3C,MAAM,SAAS,GAAiB;YAC9B,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,cAAc,EAAE,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ;SAC9E,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzB,GAAG,CAAC,kDAAkD,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,MAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACtE,CAAC;QAED,8CAA8C;QAC9C,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC9C,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACzC,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,GAAG,CAAC,iDAAiD,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;YAChF,OAAO,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,MAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5E,CAAC;QAED,qCAAqC;QACrC,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAChD,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAEtC,IAAI,MAA0B,CAAC;QAE/B,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,2BAA2B;YAC3B,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,qCAAqC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,+BAA+B,GAAG,CAAC,MAAM,wCAAwC,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,cAAc;YACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC3B,GAAG,CAAC,oCAAoC,MAAM,CAAC,IAAI,iBAAiB,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;YAChG,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,mDAAmD,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;QAE5C,MAAM,oBAAoB,GAAG,MAAM,EAAE,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC;QACpE,MAAM,YAAY,GAA2B;YAC3C,GAAG,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC;YAC9B,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;SAC3B,CAAC;QACF,MAAM,qBAAqB,GAAG,GAAG,CAAC,YAAY,IAAI,MAAM,EAAE,mBAAmB,IAAI,yBAAyB,CAAC;QAC3G,MAAM,UAAU,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC7C,MAAM,kBAAkB,GAAG,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;QAC3E,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,MAAM,EAAE,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAE9F,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,0CAA0C,oBAAoB,eAAe,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3H,CAAC;QAED,uCAAuC;QACvC,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAElD,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC;YACtC,IAAI,EAAE,aAAa;YACnB,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe;YAC5C,eAAe,EAAE;gBACf,UAAU,EAAE,MAAM,EAAE,UAAU;gBAC9B,aAAa,EAAE,aAAa;aAC7B;SACF,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC;QAEpC,GAAG,CAAC,iCAAiC,aAAa,EAAE,CAAC,CAAC;QAEtD,gCAAgC;QAChC,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAC3C,IAAI,WAAW,GAAuB,EAAE,CAAC;QACzC,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,GAAG,CAAC,wCAAwC,CAAC,CAAC;YAC9C,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,8DAA8D;YAC9D,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;YAClC,GAAG,CAAC,wBAAwB,WAAW,CAAC,MAAM,sBAAsB,CAAC,CAAC;QACxE,CAAC;QAED,wCAAwC;QACxC,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC;QACnD,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAElD,IAAI,eAAgC,CAAC;QAErC,IAAI,CAAC;YACH,eAAe,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CACpD,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb;gBACE,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,WAAW,EAAE,YAAY;gBACzB,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACpC,sDAAsD;oBACtD,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;oBACvD,SAAS,EAAE,UAAU,EAAE,CAAC,cAAc,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBAChC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACf,CAAC;aACF,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxE,GAAG,CAAC,yCAAyC,QAAQ,EAAE,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,CAAC;gBACX,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,MAAM,EAAE,MAAM,EAAE,IAAI;gBACpB,QAAQ;gBACR,aAAa;gBACb,SAAS,EAAE,SAAS;aACrB,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,GAAG,CAAC,qCAAqC,CAAC,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,SAAS,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC;QAC/C,GAAG,CAAC,kBAAkB,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,QAAQ,eAAe,eAAe,CAAC,eAAe,KAAK,CAAC,CAAC;QAElI,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,eAAe,CAAC,aAAa,CAAC,QAAQ;YAChD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,SAAS,EAAE,kBAAkB;YAC7B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,MAAM,EAAE,MAAM,EAAE,IAAI;YACpB,QAAQ;YACR,aAAa;YACb,gBAAgB,EAAE;gBAChB,YAAY,EAAE,eAAe,CAAC,YAAY;gBAC1C,eAAe,EAAE,eAAe,CAAC,eAAe;aACjD;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,kBAAkB;IAClB,0EAA0E;IAElE,eAAe,CACrB,MAAc,EACd,SAAiB,EACjB,IAAc;QAEd,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC;YACZ,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,QAAQ,EAAE,KAAK;YACf,aAAa,EAAE,QAAQ;YACvB,SAAS,EAAE,EAAE,MAAM,EAAE;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/executors/executorFactory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Executor Factory
+ *
+ * Selects the appropriate executor (Docker or Native) based on
+ * configuration, job requirements, and system capabilities.
+ */
+import { Executor } from './types.js';
+import { NativeExecutionConfig } from '../config/types.js';
+export interface ExecutorFactoryConfig {
+    mode: 'docker' | 'native' | 'auto';
+    nativeConfig?: NativeExecutionConfig;
+    dockerAvailable?: boolean;
+    jobRequirements?: {
+        requiredOS?: string;
+        executionMode?: string;
+    };
+}
+/**
+ * Marker class representing the Docker executor type.
+ * The actual Docker executor implementation lives in docker.ts / jobExecutor.ts.
+ * This stub is used for factory selection only, avoiding a hard dependency on dockerode.
+ */
+export declare class DockerExecutorStub implements Executor {
+    readonly type: "docker";
+    validate(): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    execute(): Promise<never>;
+    cleanup(): Promise<void>;
+}
+export declare class ExecutorFactory {
+    /**
+     * Create the appropriate executor for a job.
+     *
+     * Selection logic:
+     * 1. If job explicitly requests 'native' -> NativeExecutor
+     * 2. If job explicitly requests 'docker' -> DockerExecutorStub
+     * 3. If mode is 'auto':
+     *    a. If job requires macOS-only tools (xcode, ios) -> NativeExecutor
+     *    b. If Docker is available -> DockerExecutorStub
+     *    c. Else -> NativeExecutor (fallback)
+     */
+    static create(config: ExecutorFactoryConfig): Executor;
+}
+//# sourceMappingURL=executorFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executorFactory.d.ts","sourceRoot":"","sources":["../../src/executors/executorFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAIzD,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAOzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,qBAAa,eAAe;IAC1B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,QAAQ;CAkDvD"}

package/dist/executors/executorFactory.js

@@ -0,0 +1,80 @@
+/**
+ * Executor Factory
+ *
+ * Selects the appropriate executor (Docker or Native) based on
+ * configuration, job requirements, and system capabilities.
+ */
+import { NativeExecutor } from './nativeExecutor.js';
+/**
+ * Marker class representing the Docker executor type.
+ * The actual Docker executor implementation lives in docker.ts / jobExecutor.ts.
+ * This stub is used for factory selection only, avoiding a hard dependency on dockerode.
+ */
+export class DockerExecutorStub {
+    type = 'docker';
+    async validate() {
+        return { valid: true, errors: [] };
+    }
+    async execute() {
+        throw new Error('DockerExecutorStub.execute() should not be called directly. ' +
+            'Use the full DockerManager-based JobExecutor for Docker execution.');
+    }
+    async cleanup() {
+        // no-op
+    }
+}
+export class ExecutorFactory {
+    /**
+     * Create the appropriate executor for a job.
+     *
+     * Selection logic:
+     * 1. If job explicitly requests 'native' -> NativeExecutor
+     * 2. If job explicitly requests 'docker' -> DockerExecutorStub
+     * 3. If mode is 'auto':
+     *    a. If job requires macOS-only tools (xcode, ios) -> NativeExecutor
+     *    b. If Docker is available -> DockerExecutorStub
+     *    c. Else -> NativeExecutor (fallback)
+     */
+    static create(config) {
+        const { mode, nativeConfig, dockerAvailable, jobRequirements } = config;
+        // Check if job explicitly requests an execution mode
+        const jobMode = jobRequirements?.executionMode;
+        if (jobMode === 'native' || mode === 'native') {
+            return new NativeExecutor({
+                allowedPaths: nativeConfig?.allowedPaths,
+                userIsolation: nativeConfig?.userIsolation,
+                sandboxProfile: nativeConfig?.sandboxProfile,
+            });
+        }
+        if (jobMode === 'docker' || mode === 'docker') {
+            return new DockerExecutorStub();
+        }
+        // Auto mode: inspect job requirements
+        if (mode === 'auto') {
+            // macOS-only tools require native execution
+            const requiredOS = jobRequirements?.requiredOS?.toLowerCase() ?? '';
+            if (requiredOS === 'macos' ||
+                requiredOS === 'darwin' ||
+                requiredOS === 'ios') {
+                return new NativeExecutor({
+                    allowedPaths: nativeConfig?.allowedPaths,
+                    userIsolation: nativeConfig?.userIsolation,
+                    sandboxProfile: nativeConfig?.sandboxProfile,
+                });
+            }
+            // Prefer Docker when available
+            if (dockerAvailable !== false) {
+                return new DockerExecutorStub();
+            }
+            // Fallback to native
+            return new NativeExecutor({
+                allowedPaths: nativeConfig?.allowedPaths,
+                userIsolation: nativeConfig?.userIsolation,
+                sandboxProfile: nativeConfig?.sandboxProfile,
+            });
+        }
+        // Default: Docker
+        return new DockerExecutorStub();
+    }
+}
+//# sourceMappingURL=executorFactory.js.map

package/dist/executors/executorFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executorFactory.js","sourceRoot":"","sources":["../../src/executors/executorFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAarD;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,QAAiB,CAAC;IAElC,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,KAAK,CACb,8DAA8D;YAC9D,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACX,QAAQ;IACV,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IAC1B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CAAC,MAA6B;QACzC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;QAExE,qDAAqD;QACrD,MAAM,OAAO,GAAG,eAAe,EAAE,aAAa,CAAC;QAE/C,IAAI,OAAO,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,IAAI,cAAc,CAAC;gBACxB,YAAY,EAAE,YAAY,EAAE,YAAY;gBACxC,aAAa,EAAE,YAAY,EAAE,aAAa;gBAC1C,cAAc,EAAE,YAAY,EAAE,cAAc;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC,CAAC;QAED,sCAAsC;QACtC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,4CAA4C;YAC5C,MAAM,UAAU,GAAG,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACpE,IACE,UAAU,KAAK,OAAO;gBACtB,UAAU,KAAK,QAAQ;gBACvB,UAAU,KAAK,KAAK,EACpB,CAAC;gBACD,OAAO,IAAI,cAAc,CAAC;oBACxB,YAAY,EAAE,YAAY,EAAE,YAAY;oBACxC,aAAa,EAAE,YAAY,EAAE,aAAa;oBAC1C,cAAc,EAAE,YAAY,EAAE,cAAc;iBAC7C,CAAC,CAAC;YACL,CAAC;YAED,+BAA+B;YAC/B,IAAI,eAAe,KAAK,KAAK,EAAE,CAAC;gBAC9B,OAAO,IAAI,kBAAkB,EAAE,CAAC;YAClC,CAAC;YAED,qBAAqB;YACrB,OAAO,IAAI,cAAc,CAAC;gBACxB,YAAY,EAAE,YAAY,EAAE,YAAY;gBACxC,aAAa,EAAE,YAAY,EAAE,aAAa;gBAC1C,cAAc,EAAE,YAAY,EAAE,cAAc;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,kBAAkB;QAClB,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;CACF"}

package/dist/executors/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Executors barrel export
+ */
+export { Executor, ExecutionResult, ExecutionOptions } from './types.js';
+export { NativeExecutor, NativeExecutorConfig } from './nativeExecutor.js';
+export { ExecutorFactory, ExecutorFactoryConfig, DockerExecutorStub, } from './executorFactory.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/executors/index.js

@@ -0,0 +1,6 @@
+/**
+ * Executors barrel export
+ */
+export { NativeExecutor } from './nativeExecutor.js';
+export { ExecutorFactory, DockerExecutorStub, } from './executorFactory.js';
+//# sourceMappingURL=index.js.map

package/dist/executors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,eAAe,EAEf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/executors/nativeExecutor.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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 { Executor, ExecutionOptions, ExecutionResult } from './types.js';
+export interface NativeExecutorConfig {
+    allowedPaths?: string[];
+    userIsolation?: boolean;
+    sandboxProfile?: string;
+    defaultTimeout?: number;
+}
+export declare class NativeExecutor implements Executor {
+    private config;
+    readonly type: "native";
+    private tempWorkspaces;
+    constructor(config?: NativeExecutorConfig);
+    validate(): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    execute(options: ExecutionOptions): Promise<ExecutionResult>;
+    cleanup(): Promise<void>;
+    /**
+     * Build the environment for the child process.
+     * Preserves PATH and common SDK paths from the system, then merges user-provided vars.
+     */
+    private buildEnvironment;
+    /**
+     * Resolve the best available shell.
+     */
+    private resolveShell;
+    /**
+     * Check if a supported shell is available.
+     */
+    private checkShellAvailable;
+    /**
+     * 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.
+     */
+    private collectArtifacts;
+    /**
+     * Recursively walk a directory and return all file paths.
+     */
+    private walkDirectory;
+    /**
+     * Simple glob-like pattern matching.
+     * Supports * (any segment chars) and ** (any path depth).
+     */
+    private matchPattern;
+}
+//# sourceMappingURL=nativeExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nativeExecutor.d.ts","sourceRoot":"","sources":["../../src/executors/nativeExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOzE,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,cAAe,YAAW,QAAQ;IAIjC,OAAO,CAAC,MAAM;IAH1B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,cAAc,CAA0B;gBAE5B,MAAM,GAAE,oBAAyB;IAE/C,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAgCzD,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6I5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;YACW,YAAY;IAa1B;;OAEG;YACW,mBAAmB;IAYjC;;;;OAIG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,aAAa;IAqB3B;;;OAGG;IACH,OAAO,CAAC,YAAY;CAWrB"}