@windagency/valora 2.0.1

package/dist/exploration/result-comparator.js

@@ -0,0 +1,363 @@
+/**
+ * Result Comparator - Compare and rank exploration outcomes
+ *
+ * Provides detailed comparison of different exploration results
+ */
+import { exec } from 'child_process';
+import { promises as fs } from 'fs';
+import { getLogger } from '../output/logger.js';
+import * as path from 'path';
+import { promisify } from 'util';
+import { CollaborationCoordinator } from './collaboration-coordinator.js';
+const execAsync = promisify(exec);
+const logger = getLogger();
+export class ResultComparator {
+    exploration;
+    stateManager;
+    constructor(exploration, stateManager) {
+        this.exploration = exploration;
+        this.stateManager = stateManager;
+    }
+    /**
+     * Generate comprehensive comparison report
+     */
+    async generateComparisonReport() {
+        logger.info(`Generating comparison report for exploration ${this.exploration.id}`);
+        // Collect metrics for all worktrees
+        const metrics = await this.collectMetricsForAllWorktrees();
+        // Rank worktrees
+        const rankedMetrics = this.rankWorktrees(metrics);
+        // Determine winner
+        const winner = rankedMetrics.find((m) => m.status === 'completed');
+        const winnerIndex = winner?.worktree_index;
+        // Generate summary
+        const summary = this.generateSummary(rankedMetrics, winnerIndex);
+        const recommendation = this.generateRecommendation(rankedMetrics, winnerIndex);
+        return {
+            exploration_id: this.exploration.id,
+            metrics: rankedMetrics,
+            mode: this.exploration.mode,
+            recommendation,
+            summary,
+            task: this.exploration.task,
+            total_duration_ms: this.exploration.duration_ms ?? 0,
+            winner_index: winnerIndex
+        };
+    }
+    /**
+     * Collect metrics for all worktrees
+     */
+    async collectMetricsForAllWorktrees() {
+        const metrics = [];
+        for (let i = 0; i < this.exploration.worktrees.length; i++) {
+            const worktree = this.exploration.worktrees[i];
+            if (!worktree) {
+                continue;
+            }
+            const worktreeMetrics = await this.collectWorktreeMetrics(worktree, i + 1);
+            metrics.push(worktreeMetrics);
+        }
+        return metrics;
+    }
+    /**
+     * Collect metrics for a single worktree
+     */
+    async collectWorktreeMetrics(worktree, index) {
+        const duration = worktree.container_stats?.uptime_seconds ?? 0;
+        const collaborationStats = await this.getCollaborationStats(index);
+        const codeMetrics = await this.getCodeMetrics(worktree);
+        const score = this.calculateOverallScore(worktree, {
+            codeMetrics,
+            decisionsParticipated: collaborationStats.decisionsParticipated,
+            duration,
+            insightsPublished: collaborationStats.insightsPublished
+        });
+        return this.buildComparisonMetrics(worktree, index, collaborationStats, codeMetrics, score, duration);
+    }
+    /**
+     * Get collaboration statistics for a worktree
+     */
+    async getCollaborationStats(index) {
+        const sharedVolumePath = this.stateManager.getSharedVolumePath(this.exploration.id);
+        const coordinator = new CollaborationCoordinator(`${sharedVolumePath}/insights-pool.json`, `${sharedVolumePath}/decisions-pool.json`, this.exploration.id);
+        try {
+            const insights = await coordinator.getAllInsights();
+            const insightsPublished = insights.filter((i) => i.worktree_id === `worktree-${index}`).length;
+            const decisions = await coordinator.getAllDecisions();
+            const decisionsParticipated = decisions.filter((d) => Object.keys(d.votes).includes(`worktree-${index}`)).length;
+            return { decisionsParticipated, insightsPublished };
+        }
+        catch {
+            return { decisionsParticipated: 0, insightsPublished: 0 };
+        }
+    }
+    /**
+     * Build comparison metrics object
+     */
+    buildComparisonMetrics(worktree, index, collaborationStats, codeMetrics, score, duration) {
+        return {
+            cpu_usage_avg: worktree.container_stats?.cpu_usage_percent ?? 0,
+            decisions_participated: collaborationStats.decisionsParticipated,
+            duration_seconds: duration,
+            errors_count: worktree.progress.errors.length,
+            files_changed: codeMetrics?.files_changed,
+            insights_published: collaborationStats.insightsPublished,
+            lines_added: codeMetrics?.lines_added,
+            lines_removed: codeMetrics?.lines_removed,
+            memory_usage_avg_mb: worktree.container_stats?.memory_usage_mb ?? 0,
+            overall_score: score,
+            progress_percentage: worktree.progress.percentage,
+            stages_completed: worktree.progress.stages_completed.length,
+            status: worktree.status,
+            strategy: worktree.strategy ?? 'default',
+            test_results: codeMetrics?.test_results,
+            worktree_index: index
+        };
+    }
+    /**
+     * Get code metrics from git diff
+     */
+    async getCodeMetrics(worktree) {
+        try {
+            // Get git diff stats
+            const { stdout } = await execAsync(`git -C ${worktree.worktree_path} diff --shortstat ${worktree.branch_name}~1 ${worktree.branch_name}`);
+            // Parse output like: "3 files changed, 45 insertions(+), 12 deletions(-)"
+            const filesMatch = stdout.match(/(\d+) file[s]? changed/);
+            const insertionsMatch = stdout.match(/(\d+) insertion[s]?\(\+\)/);
+            const deletionsMatch = stdout.match(/(\d+) deletion[s]?\(-\)/);
+            const filesChanged = filesMatch?.[1] ? parseInt(filesMatch[1], 10) : 0;
+            const linesAdded = insertionsMatch?.[1] ? parseInt(insertionsMatch[1], 10) : 0;
+            const linesRemoved = deletionsMatch?.[1] ? parseInt(deletionsMatch[1], 10) : 0;
+            // Try to get test results if they exist
+            const testResults = await this.getTestResults(worktree);
+            return {
+                files_changed: filesChanged,
+                lines_added: linesAdded,
+                lines_removed: linesRemoved,
+                test_results: testResults
+            };
+        }
+        catch (error) {
+            logger.debug(`Could not get code metrics for worktree ${worktree.worktree_path}: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Get test results if available
+     */
+    async getTestResults(worktree) {
+        try {
+            // Try to find test results file
+            const testResultsPaths = [
+                path.join(worktree.worktree_path, 'test-results.json'),
+                path.join(worktree.worktree_path, 'coverage', 'coverage-summary.json'),
+                path.join(worktree.worktree_path, '.test-results.json')
+            ];
+            for (const testPath of testResultsPaths) {
+                try {
+                    const data = await fs.readFile(testPath, 'utf-8');
+                    const results = JSON.parse(data);
+                    // Try to parse different test result formats
+                    if (isJestTestResults(results)) {
+                        // Jest format
+                        const coveragePercent = results.coverageMap?.total?.lines?.pct;
+                        const failed = results.numFailedTests;
+                        const passed = results.numPassedTests;
+                        const skipped = results.numPendingTests;
+                        const total = results.numTotalTests;
+                        return {
+                            coverage_percent: coveragePercent,
+                            failed,
+                            passed,
+                            skipped,
+                            total
+                        };
+                    }
+                }
+                catch {
+                    // Try next path
+                }
+            }
+        }
+        catch {
+            // No test results available
+        }
+        return undefined;
+    }
+    /**
+     * Calculate overall score for a worktree
+     */
+    calculateOverallScore(worktree, additionalMetrics) {
+        let score = 0;
+        // Success status (40 points) - using status scoring map
+        const statusScores = {
+            completed: 40,
+            failed: 0,
+            running: 20
+        };
+        score += statusScores[worktree.status] ?? 0;
+        // Progress (20 points)
+        score += (worktree.progress.percentage / 100) * 20;
+        // Code quality (20 points)
+        if (additionalMetrics.codeMetrics?.test_results) {
+            const testScore = (additionalMetrics.codeMetrics.test_results.passed / additionalMetrics.codeMetrics.test_results.total) * 15;
+            score += testScore;
+            if (additionalMetrics.codeMetrics.test_results.coverage_percent) {
+                score += (additionalMetrics.codeMetrics.test_results.coverage_percent / 100) * 5;
+            }
+        }
+        // Collaboration (10 points)
+        const collaborationScore = Math.min(10, additionalMetrics.insightsPublished * 2 + additionalMetrics.decisionsParticipated * 3);
+        score += collaborationScore;
+        // Errors penalty (up to -10 points)
+        const errorsPenalty = Math.min(10, worktree.progress.errors.length * 2);
+        score -= errorsPenalty;
+        return Math.max(0, Math.min(100, score));
+    }
+    /**
+     * Rank worktrees by overall score
+     */
+    rankWorktrees(metrics, _criteria) {
+        // Sort by overall score (descending)
+        return metrics.sort((a, b) => b.overall_score - a.overall_score);
+    }
+    /**
+     * Generate summary text
+     */
+    generateSummary(metrics, winnerIndex) {
+        const completed = metrics.filter((m) => m.status === 'completed').length;
+        let summary = `Exploration completed with ${completed}/${metrics.length} successful worktrees.\n\n`;
+        if (winnerIndex) {
+            const winner = metrics.find((m) => m.worktree_index === winnerIndex);
+            if (winner) {
+                summary += `Winner: Worktree ${winnerIndex} (${winner.strategy}) with score ${winner.overall_score.toFixed(1)}/100\n`;
+                summary += `- Duration: ${winner.duration_seconds}s\n`;
+                summary += `- Progress: ${winner.progress_percentage}%\n`;
+                summary += `- Insights Published: ${winner.insights_published}\n`;
+                if (winner.test_results) {
+                    summary += `- Tests: ${winner.test_results.passed}/${winner.test_results.total} passed`;
+                    if (winner.test_results.coverage_percent) {
+                        summary += ` (${winner.test_results.coverage_percent.toFixed(1)}% coverage)`;
+                    }
+                    summary += '\n';
+                }
+            }
+        }
+        return summary;
+    }
+    /**
+     * Generate recommendation
+     */
+    generateRecommendation(metrics, winnerIndex) {
+        if (!winnerIndex) {
+            return 'No successful exploration found. Review the errors and try again with adjusted strategies.';
+        }
+        const winner = metrics.find((m) => m.worktree_index === winnerIndex);
+        if (!winner) {
+            return 'Winner not found in metrics.';
+        }
+        let recommendation = `Recommend merging Worktree ${winnerIndex} (${winner.strategy}). `;
+        // Add specific recommendations based on metrics using handler pattern
+        const scoreRecommendations = [
+            {
+                message: 'Excellent implementation with high quality and completion.',
+                threshold: 90
+            },
+            {
+                message: 'Good implementation, but consider reviewing areas for improvement.',
+                threshold: 75
+            },
+            {
+                message: 'Acceptable implementation, but significant improvements may be needed.',
+                threshold: 60
+            },
+            {
+                message: 'Low quality score. Consider additional refinement before merging or trying other approaches.',
+                threshold: 0
+            }
+        ];
+        const scoreRec = scoreRecommendations.find((rec) => winner.overall_score >= rec.threshold);
+        recommendation += scoreRec?.message ?? '';
+        // Add specific notes
+        if (winner.errors_count > 5) {
+            recommendation += ` Note: ${winner.errors_count} errors encountered during exploration.`;
+        }
+        if (winner.test_results && winner.test_results.failed > 0) {
+            recommendation += ` Warning: ${winner.test_results.failed} tests failing.`;
+        }
+        return recommendation;
+    }
+    /**
+     * Generate detailed comparison table (for CLI output)
+     */
+    generateComparisonTable(metrics) {
+        let table = '';
+        // Header
+        table += '┌─────┬──────────────┬───────────┬──────────┬──────────┬───────┐\n';
+        table += '│ WT  │   Strategy   │  Status   │ Progress │  Score   │ Tests │\n';
+        table += '├─────┼──────────────┼───────────┼──────────┼──────────┼───────┤\n';
+        // Rows
+        for (const metric of metrics) {
+            const wt = metric.worktree_index.toString().padStart(3);
+            const strategy = metric.strategy.substring(0, 12).padEnd(12);
+            const status = metric.status.padEnd(9);
+            const progress = `${metric.progress_percentage}%`.padStart(8);
+            const score = `${metric.overall_score.toFixed(1)}`.padStart(8);
+            let tests = 'N/A'.padStart(5);
+            if (metric.test_results) {
+                tests = `${metric.test_results.passed}/${metric.test_results.total}`.padStart(5);
+            }
+            table += `│ ${wt} │ ${strategy} │ ${status} │ ${progress} │ ${score} │ ${tests} │\n`;
+        }
+        table += '└─────┴──────────────┴───────────┴──────────┴──────────┴───────┘\n';
+        return table;
+    }
+    /**
+     * Export comparison report to JSON
+     */
+    async exportToJson(outputPath) {
+        const report = await this.generateComparisonReport();
+        await fs.writeFile(outputPath, JSON.stringify(report, null, 2), 'utf-8');
+        logger.info(`Comparison report exported to ${outputPath}`);
+    }
+    /**
+     * Export comparison report to Markdown
+     */
+    async exportToMarkdown(outputPath) {
+        const report = await this.generateComparisonReport();
+        let markdown = `# Exploration Comparison Report\n\n`;
+        markdown += `**Exploration ID**: ${report.exploration_id}\n`;
+        markdown += `**Task**: ${report.task}\n`;
+        markdown += `**Mode**: ${report.mode}\n`;
+        markdown += `**Duration**: ${(report.total_duration_ms / 1000).toFixed(2)}s\n\n`;
+        markdown += `## Summary\n\n${report.summary}\n\n`;
+        markdown += `## Recommendation\n\n${report.recommendation}\n\n`;
+        markdown += `## Detailed Metrics\n\n`;
+        markdown += `| WT | Strategy | Status | Progress | Score | CPU | Memory | Insights | Decisions |\n`;
+        markdown += `|----|----------|--------|----------|-------|-----|--------|----------|----------|\n`;
+        for (const metric of report.metrics) {
+            markdown += `| ${metric.worktree_index} `;
+            markdown += `| ${metric.strategy} `;
+            markdown += `| ${metric.status} `;
+            markdown += `| ${metric.progress_percentage}% `;
+            markdown += `| ${metric.overall_score.toFixed(1)} `;
+            markdown += `| ${metric.cpu_usage_avg.toFixed(1)}% `;
+            markdown += `| ${metric.memory_usage_avg_mb.toFixed(0)}MB `;
+            markdown += `| ${metric.insights_published} `;
+            markdown += `| ${metric.decisions_participated} |\n`;
+        }
+        await fs.writeFile(outputPath, markdown, 'utf-8');
+        logger.info(`Comparison report exported to ${outputPath}`);
+    }
+}
+function isJestTestResults(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj['numTotalTests'] === 'number' &&
+        typeof obj['numFailedTests'] === 'number' &&
+        typeof obj['numPassedTests'] === 'number' &&
+        typeof obj['numPendingTests'] === 'number');
+}
+//# sourceMappingURL=result-comparator.js.map

package/dist/exploration/result-comparator.js.map

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

package/dist/exploration/safety-validator.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Safety Validator - Pre-flight validation checks
+ *
+ * Performs comprehensive safety checks before starting an exploration
+ */
+import type { GitState, ResourceAvailability, SafetyValidation } from '../types/exploration.types.js';
+export interface SafetyValidatorConfig {
+    check_docker?: boolean;
+    min_disk_space_gb?: number;
+    min_memory_gb_per_branch?: number;
+    require_clean_tree?: boolean;
+    require_updated_main?: boolean;
+}
+export declare class SafetyValidator {
+    private config;
+    private repoRoot;
+    constructor(repoRoot?: string, config?: SafetyValidatorConfig);
+    /**
+     * Build configuration with defaults
+     */
+    private buildConfig;
+    /**
+     * Run all safety validations
+     */
+    validate(branches?: number): Promise<SafetyValidation>;
+    /**
+     * Run a safety check with error handling
+     */
+    private runSafetyCheck;
+    /**
+     * Check git repository state
+     */
+    private checkGitState;
+    /**
+     * Check Docker availability
+     */
+    private checkDockerAvailability;
+    /**
+     * Check resource availability
+     */
+    private checkResourceAvailability;
+    /**
+     * Check available disk space
+     */
+    private checkDiskSpace;
+    /**
+     * Get git repository state
+     */
+    getGitState(): Promise<GitState>;
+    /**
+     * Get resource availability
+     */
+    getResourceAvailability(): Promise<ResourceAvailability>;
+    /**
+     * Parse worktree paths from git worktree list output
+     */
+    private parseWorktreePaths;
+}
+//# sourceMappingURL=safety-validator.d.ts.map

package/dist/exploration/safety-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-validator.d.ts","sourceRoot":"","sources":["../../src/exploration/safety-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAe,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQ7G,MAAM,WAAW,qBAAqB;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB;IAK7D;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACG,QAAQ,CAAC,QAAQ,GAAE,MAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6B/D;;OAEG;YACW,cAAc;IAuB5B;;OAEG;YACW,aAAa;IAyC3B;;OAEG;YACW,uBAAuB;IAiDrC;;OAEG;YACW,yBAAyB;IAmCvC;;OAEG;YACW,cAAc;IAsC5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IA+CtC;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAyC9D;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAY1B"}