@windagency/valora 2.0.1

package/dist/exploration/resource-allocator.js

@@ -0,0 +1,244 @@
+/**
+ * Resource Allocator - Port, CPU, and memory allocation for explorations
+ *
+ * Manages resource allocation to prevent conflicts between parallel explorations
+ */
+export class ResourceAllocator {
+    pool;
+    constructor(portRangeStart = 3000, portRangeEnd = 3100) {
+        this.pool = {
+            allocated_containers: new Map(),
+            allocated_ports: new Set(),
+            port_range_end: portRangeEnd,
+            port_range_start: portRangeStart
+        };
+    }
+    /**
+     * Allocate resources for a worktree
+     */
+    allocate(request) {
+        const { cpu_limit: cpuLimit, exploration_id: explorationId, memory_limit: memoryLimit, worktree_index: worktreeIndex } = request;
+        // Allocate a unique port
+        const port = this.allocatePort();
+        // Generate container name
+        const containerName = `exploration-${explorationId}-${worktreeIndex}`;
+        const resources = {
+            container_name: containerName,
+            cpu_limit: cpuLimit,
+            memory_limit: memoryLimit,
+            port
+        };
+        // Track allocation
+        const allocationKey = `${explorationId}-${worktreeIndex}`;
+        this.pool.allocated_containers.set(allocationKey, resources);
+        return resources;
+    }
+    /**
+     * Allocate multiple resources for parallel worktrees
+     */
+    allocateMultiple(requests) {
+        return requests.map((request) => this.allocate(request));
+    }
+    /**
+     * Release resources for a worktree
+     */
+    release(explorationId, worktreeIndex) {
+        const allocationKey = `${explorationId}-${worktreeIndex}`;
+        const resources = this.pool.allocated_containers.get(allocationKey);
+        if (resources?.port) {
+            // Release port back to pool
+            this.pool.allocated_ports.delete(resources.port);
+        }
+        // Remove allocation
+        this.pool.allocated_containers.delete(allocationKey);
+    }
+    /**
+     * Release all resources for an exploration
+     */
+    releaseAll(explorationId) {
+        const keysToDelete = [];
+        // Find all allocations for this exploration
+        for (const [key, resources] of this.pool.allocated_containers.entries()) {
+            if (key.startsWith(`${explorationId}-`)) {
+                if (resources.port) {
+                    this.pool.allocated_ports.delete(resources.port);
+                }
+                keysToDelete.push(key);
+            }
+        }
+        // Delete allocations
+        for (const key of keysToDelete) {
+            this.pool.allocated_containers.delete(key);
+        }
+    }
+    /**
+     * Get allocated resources for a worktree
+     */
+    getAllocated(explorationId, worktreeIndex) {
+        const allocationKey = `${explorationId}-${worktreeIndex}`;
+        return this.pool.allocated_containers.get(allocationKey) ?? null;
+    }
+    /**
+     * Get all allocated resources for an exploration
+     */
+    getAllAllocated(explorationId) {
+        const resources = [];
+        for (const [key, res] of this.pool.allocated_containers.entries()) {
+            if (key.startsWith(`${explorationId}-`)) {
+                resources.push(res);
+            }
+        }
+        return resources;
+    }
+    /**
+     * Check if resources are available for N branches
+     */
+    canAllocate(branches) {
+        const availablePorts = this.getAvailablePortCount();
+        return availablePorts >= branches;
+    }
+    /**
+     * Get number of available ports
+     */
+    getAvailablePortCount() {
+        const totalPorts = this.pool.port_range_end - this.pool.port_range_start + 1;
+        const usedPorts = this.pool.allocated_ports.size;
+        return totalPorts - usedPorts;
+    }
+    /**
+     * Get allocation statistics
+     */
+    getStats() {
+        const totalPorts = this.pool.port_range_end - this.pool.port_range_start + 1;
+        const allocatedPorts = this.pool.allocated_ports.size;
+        return {
+            active_containers: this.pool.allocated_containers.size,
+            allocated_ports: allocatedPorts,
+            available_ports: totalPorts - allocatedPorts,
+            total_ports: totalPorts
+        };
+    }
+    /**
+     * Allocate a port from the pool
+     */
+    allocatePort() {
+        for (let port = this.pool.port_range_start; port <= this.pool.port_range_end; port++) {
+            if (!this.pool.allocated_ports.has(port)) {
+                this.pool.allocated_ports.add(port);
+                return port;
+            }
+        }
+        throw new Error(`No available ports in range ${this.pool.port_range_start}-${this.pool.port_range_end}. ` +
+            `All ${this.pool.allocated_ports.size} ports are allocated.`);
+    }
+    /**
+     * Validate CPU limit format
+     */
+    static validateCpuLimit(cpuLimit) {
+        // Format: "1.5" or "2" (number of CPU cores)
+        const parsed = parseFloat(cpuLimit);
+        return !isNaN(parsed) && parsed > 0 && parsed <= 64; // Max 64 cores
+    }
+    /**
+     * Validate memory limit format
+     */
+    static validateMemoryLimit(memoryLimit) {
+        // Format: "2g", "512m", "1024m"
+        const regex = /^(\d+)(m|g)$/i;
+        const match = memoryLimit.match(regex);
+        if (!match?.[1] || !match[2]) {
+            return false;
+        }
+        const value = parseInt(match[1]);
+        const unit = match[2].toLowerCase();
+        // Check reasonable limits
+        if (unit === 'm') {
+            return value >= 256 && value <= 32768; // 256MB to 32GB
+        }
+        else if (unit === 'g') {
+            return value >= 1 && value <= 32; // 1GB to 32GB
+        }
+        return false;
+    }
+    /**
+     * Convert memory limit to bytes
+     */
+    static memoryLimitToBytes(memoryLimit) {
+        const regex = /^(\d+)(m|g)$/i;
+        const match = memoryLimit.match(regex);
+        if (!match?.[1] || !match[2]) {
+            throw new Error(`Invalid memory limit format: ${memoryLimit}`);
+        }
+        const value = parseInt(match[1]);
+        const unit = match[2].toLowerCase();
+        if (unit === 'm') {
+            return value * 1024 * 1024;
+        }
+        else if (unit === 'g') {
+            return value * 1024 * 1024 * 1024;
+        }
+        throw new Error(`Invalid memory unit: ${unit}`);
+    }
+    /**
+     * Convert memory limit to megabytes
+     */
+    static memoryLimitToMB(memoryLimit) {
+        return this.memoryLimitToBytes(memoryLimit) / (1024 * 1024);
+    }
+    /**
+     * Format bytes to human-readable memory limit
+     */
+    static formatMemoryLimit(bytes) {
+        const mb = bytes / (1024 * 1024);
+        if (mb >= 1024) {
+            const gb = mb / 1024;
+            return `${Math.round(gb * 10) / 10}g`;
+        }
+        return `${Math.round(mb)}m`;
+    }
+    /**
+     * Reset the allocator (useful for testing)
+     */
+    reset() {
+        this.pool.allocated_ports.clear();
+        this.pool.allocated_containers.clear();
+    }
+    /**
+     * Reserve a specific port (for manual allocation)
+     */
+    reservePort(port) {
+        if (port < this.pool.port_range_start || port > this.pool.port_range_end) {
+            throw new Error(`Port ${port} is outside the allowed range`);
+        }
+        if (this.pool.allocated_ports.has(port)) {
+            return false; // Already allocated
+        }
+        this.pool.allocated_ports.add(port);
+        return true;
+    }
+    /**
+     * Check if a port is available
+     */
+    isPortAvailable(port) {
+        return !this.pool.allocated_ports.has(port);
+    }
+    /**
+     * Get list of allocated ports
+     */
+    getAllocatedPorts() {
+        return Array.from(this.pool.allocated_ports).sort((a, b) => a - b);
+    }
+    /**
+     * Get list of available ports
+     */
+    getAvailablePorts() {
+        const available = [];
+        for (let port = this.pool.port_range_start; port <= this.pool.port_range_end; port++) {
+            if (!this.pool.allocated_ports.has(port)) {
+                available.push(port);
+            }
+        }
+        return available;
+    }
+}
+//# sourceMappingURL=resource-allocator.js.map

package/dist/exploration/resource-allocator.js.map

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

package/dist/exploration/result-comparator.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Result Comparator - Compare and rank exploration outcomes
+ *
+ * Provides detailed comparison of different exploration results
+ */
+import type { Exploration } from '../types/exploration.types.js';
+import type { ExplorationStateManager } from './exploration-state.js';
+export interface ComparisonMetrics {
+    status: string;
+    strategy: string;
+    worktree_index: number;
+    cpu_usage_avg: number;
+    duration_seconds: number;
+    memory_usage_avg_mb: number;
+    errors_count: number;
+    progress_percentage: number;
+    stages_completed: number;
+    decisions_participated: number;
+    insights_published: number;
+    files_changed?: number;
+    lines_added?: number;
+    lines_removed?: number;
+    test_results?: TestResults;
+    overall_score: number;
+}
+export interface ComparisonReport {
+    exploration_id: string;
+    metrics: ComparisonMetrics[];
+    mode: 'parallel' | 'sequential';
+    recommendation: string;
+    summary: string;
+    task: string;
+    total_duration_ms: number;
+    winner_index?: number;
+}
+export interface RankingCriteria {
+    collaboration_weight: number;
+    performance_weight: number;
+    quality_weight: number;
+    success_weight: number;
+}
+export interface TestResults {
+    coverage_percent?: number;
+    failed: number;
+    passed: number;
+    skipped: number;
+    total: number;
+}
+export declare class ResultComparator {
+    private exploration;
+    private stateManager;
+    constructor(exploration: Exploration, stateManager: ExplorationStateManager);
+    /**
+     * Generate comprehensive comparison report
+     */
+    generateComparisonReport(): Promise<ComparisonReport>;
+    /**
+     * Collect metrics for all worktrees
+     */
+    private collectMetricsForAllWorktrees;
+    /**
+     * Collect metrics for a single worktree
+     */
+    private collectWorktreeMetrics;
+    /**
+     * Get collaboration statistics for a worktree
+     */
+    private getCollaborationStats;
+    /**
+     * Build comparison metrics object
+     */
+    private buildComparisonMetrics;
+    /**
+     * Get code metrics from git diff
+     */
+    private getCodeMetrics;
+    /**
+     * Get test results if available
+     */
+    private getTestResults;
+    /**
+     * Calculate overall score for a worktree
+     */
+    private calculateOverallScore;
+    /**
+     * Rank worktrees by overall score
+     */
+    private rankWorktrees;
+    /**
+     * Generate summary text
+     */
+    private generateSummary;
+    /**
+     * Generate recommendation
+     */
+    private generateRecommendation;
+    /**
+     * Generate detailed comparison table (for CLI output)
+     */
+    generateComparisonTable(metrics: ComparisonMetrics[]): string;
+    /**
+     * Export comparison report to JSON
+     */
+    exportToJson(outputPath: string): Promise<void>;
+    /**
+     * Export comparison report to Markdown
+     */
+    exportToMarkdown(outputPath: string): Promise<void>;
+}
+//# sourceMappingURL=result-comparator.d.ts.map

package/dist/exploration/result-comparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-comparator.d.ts","sourceRoot":"","sources":["../../src/exploration/result-comparator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,yBAAyB,CAAC;AAQhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAOnE,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IAGvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IAGzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAG3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,WAAW,CAAC;IAG3B,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;AAuBD,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAA0B;gBAElC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,uBAAuB;IAK3E;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA6B3D;;OAEG;YACW,6BAA6B;IAe3C;;OAEG;YACW,sBAAsB;IAepC;;OAEG;YACW,qBAAqB;IAuBnC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,cAAc;IA+B5B;;OAEG;YACW,cAAc;IA0C5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+C7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkD9B;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM;IA6B7D;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BzD"}