vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1739

package/src/utils/reports/report-analysis.js

@@ -0,0 +1,218 @@
+/**
+ * Report Analysis and Statistics
+ * 
+ * Generates recommendations, statistics, and compliance metrics.
+ */
+
+const path = require('path');
+const { SIZE_CATEGORIES, LINE_DISTRIBUTION } = require('./report-types');
+
+/**
+ * Analysis and statistics utilities
+ */
+class ReportAnalysis {
+  /**
+   * Generate recommendations based on analysis data
+   */
+  static generateRecommendations(analysisData) {
+    const recommendations = [];
+    const files = analysisData.files || [];
+    
+    // Large file recommendations
+    const largeFiles = files.filter(f => f.lineCount > SIZE_CATEGORIES.LARGE.min);
+    if (largeFiles.length > 0) {
+      recommendations.push({
+        type: 'urgent',
+        title: `Refactor ${largeFiles.length} Large Files`,
+        description: `${largeFiles.length} files exceed the 555-line limit and require immediate refactoring.`,
+        files: largeFiles.map(f => f.path),
+        priority: 'high'
+      });
+    }
+
+    // Medium file recommendations
+    const mediumFiles = files.filter(f => 
+      f.lineCount >= SIZE_CATEGORIES.MEDIUM.min && f.lineCount <= SIZE_CATEGORIES.MEDIUM.max
+    );
+    if (mediumFiles.length > 0) {
+      recommendations.push({
+        type: 'planning',
+        title: `Plan Refactoring for ${mediumFiles.length} Medium Files`,
+        description: `${mediumFiles.length} files are approaching the size limit and should be planned for refactoring.`,
+        files: mediumFiles.map(f => f.path),
+        priority: 'medium'
+      });
+    }
+
+    // Package-specific recommendations
+    const packageStats = ReportAnalysis.analyzePackageStats(files);
+    for (const [pkg, stats] of Object.entries(packageStats)) {
+      if (stats.complianceRate < 80) {
+        recommendations.push({
+          type: 'package',
+          title: `Improve ${pkg} Package Compliance`,
+          description: `Package ${pkg} has ${stats.complianceRate}% compliance rate and needs attention.`,
+          files: stats.files,
+          priority: 'medium'
+        });
+      }
+    }
+
+    return recommendations;
+  }
+
+  /**
+   * Generate comprehensive statistics
+   */
+  static generateStatistics(analysisData) {
+    const files = analysisData.files || [];
+    
+    return {
+      fileSizes: ReportAnalysis.calculateSizeDistribution(files),
+      packageStats: ReportAnalysis.analyzePackageStats(files),
+      fileTypeStats: ReportAnalysis.analyzeFileTypeStats(files),
+      complexityMetrics: ReportAnalysis.calculateComplexityMetrics(files)
+    };
+  }
+
+  /**
+   * Calculate size distribution
+   */
+  static calculateSizeDistribution(files) {
+    const distribution = {};
+    
+    // Initialize distribution
+    for (const range of Object.keys(LINE_DISTRIBUTION)) {
+      distribution[range] = 0;
+    }
+
+    for (const file of files) {
+      const lines = file.lineCount;
+      for (const [range, config] of Object.entries(LINE_DISTRIBUTION)) {
+        if (lines >= config.min && lines <= config.max) {
+          distribution[range]++;
+          break;
+        }
+      }
+    }
+
+    return distribution;
+  }
+
+  /**
+   * Analyze package statistics
+   */
+  static analyzePackageStats(files) {
+    const packageStats = {};
+    
+    for (const file of files) {
+      const pkg = ReportAnalysis.extractPackageFromPath(file.path);
+      if (!packageStats[pkg]) {
+        packageStats[pkg] = {
+          totalFiles: 0,
+          totalLines: 0,
+          compliantFiles: 0,
+          files: []
+        };
+      }
+      
+      packageStats[pkg].totalFiles++;
+      packageStats[pkg].totalLines += file.lineCount;
+      packageStats[pkg].files.push(file.path);
+      
+      if (file.lineCount <= SIZE_CATEGORIES.LARGE.min) {
+        packageStats[pkg].compliantFiles++;
+      }
+    }
+
+    // Calculate compliance rates
+    for (const stats of Object.values(packageStats)) {
+      stats.complianceRate = stats.totalFiles > 0 
+        ? (stats.compliantFiles / stats.totalFiles * 100).toFixed(1)
+        : 0;
+      stats.averageLines = stats.totalFiles > 0
+        ? Math.round(stats.totalLines / stats.totalFiles)
+        : 0;
+    }
+
+    return packageStats;
+  }
+
+  /**
+   * Analyze file type statistics
+   */
+  static analyzeFileTypeStats(files) {
+    const typeStats = {};
+    
+    for (const file of files) {
+      const ext = path.extname(file.path);
+      if (!typeStats[ext]) {
+        typeStats[ext] = {
+          count: 0,
+          totalLines: 0,
+          averageLines: 0
+        };
+      }
+      
+      typeStats[ext].count++;
+      typeStats[ext].totalLines += file.lineCount;
+    }
+
+    // Calculate averages
+    for (const stats of Object.values(typeStats)) {
+      stats.averageLines = stats.count > 0
+        ? Math.round(stats.totalLines / stats.count)
+        : 0;
+    }
+
+    return typeStats;
+  }
+
+  /**
+   * Calculate complexity metrics (simplified)
+   */
+  static calculateComplexityMetrics(files) {
+    return {
+      totalComplexity: 0,
+      averageComplexity: 0,
+      complexityDistribution: {
+        low: 0,
+        medium: 0,
+        high: 0,
+        veryHigh: 0
+      }
+    };
+  }
+
+  /**
+   * Generate compliance metrics
+   */
+  static generateComplianceMetrics(validationData) {
+    const results = validationData.results || [];
+    const filesValidated = validationData.filesValidated || 0;
+    
+    const errorCount = results.filter(r => r.severity === 'error').length;
+    const warningCount = results.filter(r => r.severity === 'warning').length;
+    
+    return {
+      overallScore: filesValidated > 0 ? Math.max(0, 100 - (errorCount * 10 + warningCount * 2)) : 0,
+      fileComplianceRate: filesValidated > 0 ? ((filesValidated - errorCount) / filesValidated * 100) : 0,
+      lineComplianceRate: 0, // Would need line-level analysis
+      violationCount: errorCount,
+      lastChecked: new Date().toISOString(),
+      status: errorCount === 0 ? 'compliant' : warningCount > 0 ? 'warning' : 'non-compliant'
+    };
+  }
+
+  /**
+   * Extract package name from file path
+   */
+  static extractPackageFromPath(filePath) {
+    const match = filePath.match(/packages\/([^\/]+)/);
+    return match ? match[1] : 'root';
+  }
+}
+
+module.exports = {
+  ReportAnalysis
+};

package/src/utils/reports/report-types.js

@@ -0,0 +1,55 @@
+/**
+ * Report Types and Constants
+ * 
+ * Defines report types, output formats, and shared constants.
+ */
+
+/**
+ * Report types
+ */
+const REPORT_TYPES = {
+  ANALYSIS: 'analysis',
+  REFACTORING: 'refactoring',
+  VALIDATION: 'validation',
+  COMPLIANCE: 'compliance'
+};
+
+/**
+ * Output formats
+ */
+const OUTPUT_FORMATS = {
+  JSON: 'json',
+  MARKDOWN: 'markdown',
+  CONSOLE: 'console',
+  HTML: 'html'
+};
+
+/**
+ * File size categories for analysis
+ */
+const SIZE_CATEGORIES = {
+  SMALL: { max: 300, label: 'small' },
+  MEDIUM: { min: 301, max: 555, label: 'medium' },
+  LARGE: { min: 556, max: 800, label: 'large' },
+  XLARGE: { min: 801, label: 'xlarge' }
+};
+
+/**
+ * Line count distribution ranges
+ */
+const LINE_DISTRIBUTION = {
+  '0-100': { min: 0, max: 100 },
+  '101-200': { min: 101, max: 200 },
+  '201-300': { min: 201, max: 300 },
+  '301-400': { min: 301, max: 400 },
+  '401-500': { min: 401, max: 500 },
+  '501-555': { min: 501, max: 555 },
+  '556+': { min: 556, max: Infinity }
+};
+
+module.exports = {
+  REPORT_TYPES,
+  OUTPUT_FORMATS,
+  SIZE_CATEGORIES,
+  LINE_DISTRIBUTION
+};

package/src/utils/reports/summary-generators.js

@@ -0,0 +1,102 @@
+/**
+ * Report Summary Generators
+ * 
+ * Generates summary data for different report types.
+ */
+
+const { SIZE_CATEGORIES } = require('./report-types');
+
+/**
+ * Summary generation utilities
+ */
+class SummaryGenerators {
+  /**
+   * Generate analysis summary
+   */
+  static generateAnalysisSummary(analysisData) {
+    const files = analysisData.files || [];
+    const totalFiles = files.length;
+    const largeFiles = files.filter(f => f.lineCount > SIZE_CATEGORIES.LARGE.min).length;
+    const mediumFiles = files.filter(f => 
+      f.lineCount >= SIZE_CATEGORIES.MEDIUM.min && f.lineCount <= SIZE_CATEGORIES.MEDIUM.max
+    ).length;
+    const smallFiles = files.filter(f => f.lineCount <= SIZE_CATEGORIES.SMALL.max).length;
+    
+    const totalLines = files.reduce((sum, f) => sum + f.lineCount, 0);
+    const avgLines = totalFiles > 0 ? Math.round(totalLines / totalFiles) : 0;
+
+    return {
+      totalFiles,
+      totalLines,
+      averageLines: avgLines,
+      sizeDistribution: {
+        small: smallFiles,
+        medium: mediumFiles,
+        large: largeFiles,
+        xlarge: files.filter(f => f.lineCount > SIZE_CATEGORIES.XLARGE.min).length
+      },
+      complianceRate: totalFiles > 0 ? ((totalFiles - largeFiles) / totalFiles * 100).toFixed(1) : 0,
+      needsRefactoring: largeFiles + mediumFiles
+    };
+  }
+
+  /**
+   * Generate refactoring summary
+   */
+  static generateRefactoringSummary(refactoringData) {
+    const operations = refactoringData.operations || [];
+    const successful = operations.filter(op => op.status === 'success').length;
+    const failed = operations.filter(op => op.status === 'failed').length;
+    const skipped = operations.filter(op => op.status === 'skipped').length;
+
+    return {
+      totalOperations: operations.length,
+      successful,
+      failed,
+      skipped,
+      successRate: operations.length > 0 ? (successful / operations.length * 100).toFixed(1) : 0,
+      filesProcessed: refactoringData.filesProcessed || 0,
+      linesReduced: refactoringData.linesReduced || 0,
+      modulesCreated: refactoringData.modulesCreated || 0
+    };
+  }
+
+  /**
+   * Generate validation summary
+   */
+  static generateValidationSummary(validationData) {
+    const results = validationData.results || [];
+    const errors = results.filter(r => r.severity === 'error').length;
+    const warnings = results.filter(r => r.severity === 'warning').length;
+    const info = results.filter(r => r.severity === 'info').length;
+
+    return {
+      totalIssues: results.length,
+      errors,
+      warnings,
+      info,
+      filesValidated: validationData.filesValidated || 0,
+      passed: errors === 0
+    };
+  }
+
+  /**
+   * Generate compliance summary
+   */
+  static generateComplianceSummary(complianceData) {
+    const metrics = complianceData.metrics || {};
+    
+    return {
+      overallScore: metrics.overallScore || 0,
+      fileComplianceRate: metrics.fileComplianceRate || 0,
+      lineComplianceRate: metrics.lineComplianceRate || 0,
+      violationCount: metrics.violationCount || 0,
+      lastChecked: metrics.lastChecked || new Date().toISOString(),
+      status: metrics.status || 'unknown'
+    };
+  }
+}
+
+module.exports = {
+  SummaryGenerators
+};

package/src/utils/requirement-file-management.js

@@ -0,0 +1,157 @@
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+const { getRequirementsPath } = require('./repo-helpers.cjs');
+const { logger } = require('./logger.cjs');
+
+/**
+ * Requirement file creation and path management utilities
+ */
+
+// Default instruction text
+const DEFAULT_INSTRUCTION_TEXT = 'Follow INSTRUCTIONS.md from .vibecodingmachine directory. CRITICAL: You MUST work through ALL status stages (PREPARE → ACT → CLEAN UP → VERIFY → DONE) and set the status to DONE in the REQUIREMENTS file before stopping. DO NOT stop working until the "🚦 Current Status" section shows "DONE". The VibeCodingMachine app is running in autonomous mode and depends on you completing the requirement fully.';
+
+/**
+ * Create a default requirements file
+ * @param {string} repoPath - Repository path
+ * @returns {string} Path to created file
+ */
+function createDefaultRequirementsFile(repoPath) {
+  try {
+    const hostname = os.hostname();
+    // Use the core logic to find the .vibecodingmachine directory
+    // Note: This logic assumes we want to create it INSIDE the repo if it doesn't exist?
+    // Electron app logic was: path.join(repoPath, '.vibecodingmachine')
+    // We'll stick to that for creation.
+    const vibecodingmachineDir = path.join(repoPath, '.vibecodingmachine');
+
+    // Ensure .vibecodingmachine directory exists
+    if (!fs.existsSync(vibecodingmachineDir)) {
+      fs.mkdirSync(vibecodingmachineDir, { recursive: true });
+      logger.log('📁 Created .vibecodingmachine directory');
+    }
+
+    // Create hostname-specific requirements file
+    const requirementsFilePath = path.join(vibecodingmachineDir, `REQUIREMENTS-${hostname}.md`);
+
+    const defaultContent = `# 🌙 VibeCodingMachine – Requirements File
+
+This is a Markdown (.md) file.
+
+You should not need to modify this file, as VibeCodingMachine will modify it for you, but you can add requirements and move them around either here directly, or via AI.
+
+This file contains the requirements to complete the project. Each item in a list is a self contained requirement that should be able to stand on its own, and not require reference to other requirements. Each requirement starts in the section of requirements to complete, then it moved to the section with the current requirement being worked on. VibeCodingMachine will then, after implementing the requirement, move it to the completed requirements list in the CHANGELOG.md file, or to the section in this file for requirements that need attention. These will be available for you to review. They should have options to choose, and you decide which option to take, and VibeCodingMachine will work on that again the next time it is run.
+
+## RESPONSE FROM LAST CHAT
+
+### ONE LINE STATUS: READY
+
+### ONE LINE SUMMARY: New requirements file created
+
+### MULTILINE DETAILS: (1-20 lines max)
+
+**REQUIREMENT:**
+- Initial setup complete
+
+**ALL PHASES COMPLETED:**
+- ✅ Requirements file created
+- ✅ Ready for new requirements
+
+## 🔨 Current In Progress Requirement
+
+*No current requirement in progress*
+
+## 📋 Requirements to Complete
+
+*No requirements to complete*
+
+## ⚠️ Requirements That Need Attention
+
+*No requirements need attention*
+
+## ✅ Completed Requirements
+
+*No completed requirements yet*
+
+---
+
+*This file was automatically created by VibeCodingMachine*
+`;
+
+    fs.writeFileSync(requirementsFilePath, defaultContent, 'utf8');
+    logger.log(`📄 Created default requirements file: ${requirementsFilePath}`);
+
+    return requirementsFilePath;
+  } catch (error) {
+    logger.error('❌ Error creating default requirements file:', error);
+    throw error;
+  }
+}
+
+/**
+ * Get or create requirements file path
+ * @param {string} repoPath - Repository path
+ * @returns {Promise<string>} Path to requirements file
+ */
+async function getOrCreateRequirementsFilePath(repoPath) {
+  try {
+    const hostname = os.hostname();
+
+    // Use shared logic to find existing path first
+    let requirementsFilePath = await getRequirementsPath(repoPath, hostname);
+
+    if (requirementsFilePath && await fs.pathExists(requirementsFilePath)) {
+      return requirementsFilePath;
+    } else {
+      // Create a new hostname-specific requirements file
+      // We default to creating it inside the repo under .vibecodingmachine
+      requirementsFilePath = path.join(repoPath, '.vibecodingmachine', `REQUIREMENTS-${hostname}.md`);
+
+      const fs = require('fs-extra');
+      const defaultRequirementsContent = `# 🌙 VibeCodingMachine – Requirements File
+
+This is a Markdown (.md) file.
+
+You should not need to modify this file, as VibeCodingMachine will modify it for you, but you can add requirements and move them around either here directly, or via AI.
+
+This file contains the requirements to complete the project.  Each item in a list is a self contained requirement that should be able to stand on its own, and not require reference to other requirements.  Each requirement starts in the section of requirements to complete, then it moved to the section with the current requirement being worked on.  VibeCodingMachine will then, after implementing the requirement, move it to the completed requirements list in the CHANGELOG.md file, or to the section in this file for requirements that need attention.  These will be available for you to review.  They should have options to choose, and you decide which option to take, and VibeCodingMachine will work on that again the next time it is run.
+
+## RESPONSE FROM LAST CHAT
+
+### ONE LINE STATUS: 
+
+### ONE LINE SUMMARY: 
+
+### MULTILINE DETAILS: (1-20 lines max)
+
+## 🔨 Current In Progress Requirement
+
+- 
+
+## 🚦 Current Status
+
+PREPARE
+
+## ⏳ Requirements not yet completed
+
+- 
+
+## ✅ Verified by AI screenshot
+
+`;
+      fs.ensureDirSync(path.join(repoPath, '.vibecodingmachine'));
+      fs.writeFileSync(requirementsFilePath, defaultRequirementsContent, 'utf8');
+    }
+
+    return requirementsFilePath;
+  } catch (error) {
+    logger.error('❌ Error getting or creating requirements file path:', error);
+    throw error;
+  }
+}
+
+module.exports = {
+  DEFAULT_INSTRUCTION_TEXT,
+  createDefaultRequirementsFile,
+  getOrCreateRequirementsFilePath
+};