vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1739

package/src/models/compliance-report.js

@@ -0,0 +1,538 @@
+/**
+ * Compliance Report Data Model
+ * 
+ * Defines the structure and behavior of compliance reports for tracking
+ * file size compliance and constitutional adherence across the codebase.
+ */
+
+/**
+ * Compliance status levels
+ */
+const COMPLIANCE_STATUS = {
+  COMPLIANT: 'compliant',
+  WARNING: 'warning',
+  VIOLATION: 'violation',
+  CRITICAL: 'critical',
+  UNKNOWN: 'unknown'
+};
+
+/**
+ * Compliance categories
+ */
+const COMPLIANCE_CATEGORIES = {
+  FILE_SIZE: 'file_size',
+  CODE_STRUCTURE: 'code_structure',
+  TESTING: 'testing',
+  DOCUMENTATION: 'documentation',
+  IMPORTS: 'imports',
+  NAMING: 'naming',
+  SECURITY: 'security',
+  PERFORMANCE: 'performance'
+};
+
+/**
+ * Individual compliance issue
+ */
+class ComplianceIssue {
+  constructor(data = {}) {
+    this.id = data.id || this.generateId();
+    this.filePath = data.filePath || '';
+    this.category = data.category || COMPLIANCE_CATEGORIES.FILE_SIZE;
+    this.severity = data.severity || 'warning';
+    this.status = data.status || COMPLIANCE_STATUS.WARNING;
+    this.rule = data.rule || '';
+    this.message = data.message || '';
+    this.description = data.description || '';
+    this.suggestion = data.suggestion || '';
+    this.lineNumber = data.lineNumber || null;
+    this.columnNumber = data.columnNumber || null;
+    this.metadata = {
+      createdAt: data.createdAt || new Date().toISOString(),
+      updatedAt: data.updatedAt || new Date().toISOString(),
+      validator: data.validator || 'unknown',
+      version: data.version || '1.0.0',
+      ...data.metadata
+    };
+  }
+
+  generateId() {
+    return `issue_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+  }
+
+  update(updates = {}) {
+    Object.assign(this, updates);
+    this.metadata.updatedAt = new Date().toISOString();
+    return this;
+  }
+
+  toJSON() {
+    return {
+      id: this.id,
+      filePath: this.filePath,
+      category: this.category,
+      severity: this.severity,
+      status: this.status,
+      rule: this.rule,
+      message: this.message,
+      description: this.description,
+      suggestion: this.suggestion,
+      lineNumber: this.lineNumber,
+      columnNumber: this.columnNumber,
+      metadata: this.metadata
+    };
+  }
+
+  static fromJSON(data) {
+    return new ComplianceIssue(data);
+  }
+}
+
+/**
+ * File compliance summary
+ */
+class FileComplianceSummary {
+  constructor(data = {}) {
+    this.filePath = data.filePath || '';
+    this.totalIssues = data.totalIssues || 0;
+    this.compliantIssues = data.compliantIssues || 0;
+    this.warningIssues = data.warningIssues || 0;
+    this.violationIssues = data.violationIssues || 0;
+    this.criticalIssues = data.criticalIssues || 0;
+    this.lineCount = data.lineCount || 0;
+    this.fileSize = data.fileSize || 0;
+    this.status = data.status || COMPLIANCE_STATUS.COMPLIANT;
+    this.complianceScore = data.complianceScore || 100;
+    this.issues = (data.issues || []).map(issue => 
+      issue instanceof ComplianceIssue ? issue : ComplianceIssue.fromJSON(issue)
+    );
+    this.metadata = {
+      analyzedAt: data.analyzedAt || new Date().toISOString(),
+      analyzer: data.analyzer || 'unknown',
+      version: data.version || '1.0.0',
+      ...data.metadata
+    };
+  }
+
+  addIssue(issue) {
+    const complianceIssue = issue instanceof ComplianceIssue ? 
+      issue : new ComplianceIssue(issue);
+    
+    this.issues.push(complianceIssue);
+    this.totalIssues++;
+    
+    // Update category counts
+    switch (complianceIssue.severity) {
+      case 'critical':
+        this.criticalIssues++;
+        this.status = COMPLIANCE_STATUS.CRITICAL;
+        break;
+      case 'error':
+        this.violationIssues++;
+        if (this.status !== COMPLIANCE_STATUS.CRITICAL) {
+          this.status = COMPLIANCE_STATUS.VIOLATION;
+        }
+        break;
+      case 'warning':
+        this.warningIssues++;
+        if (this.status === COMPLIANCE_STATUS.COMPLIANT) {
+          this.status = COMPLIANCE_STATUS.WARNING;
+        }
+        break;
+      default:
+        this.compliantIssues++;
+        break;
+    }
+    
+    // Recalculate compliance score
+    this.calculateComplianceScore();
+    this.metadata.analyzedAt = new Date().toISOString();
+    
+    return this;
+  }
+
+  calculateComplianceScore() {
+    if (this.totalIssues === 0) {
+      this.complianceScore = 100;
+      return;
+    }
+
+    // Weight issues by severity
+    const weights = {
+      info: 1,
+      warning: 5,
+      error: 15,
+      critical: 30
+    };
+
+    let totalWeight = 0;
+    for (const issue of this.issues) {
+      totalWeight += weights[issue.severity] || 1;
+    }
+
+    // Calculate score (0-100)
+    const maxPossibleWeight = this.totalIssues * 30; // All critical would be worst
+    this.complianceScore = Math.max(0, 100 - (totalWeight / maxPossibleWeight * 100));
+  }
+
+  getIssuesByCategory(category) {
+    return this.issues.filter(issue => issue.category === category);
+  }
+
+  getIssuesBySeverity(severity) {
+    return this.issues.filter(issue => issue.severity === severity);
+  }
+
+  toJSON() {
+    return {
+      filePath: this.filePath,
+      totalIssues: this.totalIssues,
+      compliantIssues: this.compliantIssues,
+      warningIssues: this.warningIssues,
+      violationIssues: this.violationIssues,
+      criticalIssues: this.criticalIssues,
+      lineCount: this.lineCount,
+      fileSize: this.fileSize,
+      status: this.status,
+      complianceScore: this.complianceScore,
+      issues: this.issues.map(issue => issue.toJSON()),
+      metadata: this.metadata
+    };
+  }
+
+  static fromJSON(data) {
+    return new FileComplianceSummary(data);
+  }
+}
+
+/**
+ * Main compliance report
+ */
+class ComplianceReport {
+  constructor(data = {}) {
+    this.id = data.id || this.generateId();
+    this.title = data.title || 'Codebase Compliance Report';
+    this.description = data.description || '';
+    this.generatedAt = data.generatedAt || new Date().toISOString();
+    this.scope = data.scope || 'full'; // 'full', 'package', 'directory', 'file'
+    this.scopePath = data.scopePath || '';
+    this.version = data.version || '1.0.0';
+    
+    // Summary statistics
+    this.summary = {
+      totalFiles: data.totalFiles || 0,
+      totalIssues: data.totalIssues || 0,
+      compliantFiles: data.compliantFiles || 0,
+      warningFiles: data.warningFiles || 0,
+      violationFiles: data.violationFiles || 0,
+      criticalFiles: data.criticalFiles || 0,
+      overallComplianceScore: data.overallComplianceScore || 100,
+      totalLines: data.totalLines || 0,
+      averageLines: data.averageLines || 0,
+      largestFile: data.largestFile || null,
+      smallestFile: data.smallestFile || null,
+      ...data.summary
+    };
+    
+    // Issues by category
+    this.issuesByCategory = {};
+    for (const category of Object.values(COMPLIANCE_CATEGORIES)) {
+      this.issuesByCategory[category] = data.issuesByCategory?.[category] || 0;
+    }
+    
+    // File summaries
+    this.fileSummaries = (data.fileSummaries || []).map(summary => 
+      summary instanceof FileComplianceSummary ? summary : FileComplianceSummary.fromJSON(summary)
+    );
+    
+    // Recommendations
+    this.recommendations = data.recommendations || [];
+    
+    // Metadata
+    this.metadata = {
+      generator: data.generator || 'ComplianceReport',
+      config: data.config || {},
+      duration: data.duration || 0,
+      ...data.metadata
+    };
+  }
+
+  generateId() {
+    return `report_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+  }
+
+  addFileSummary(fileSummary) {
+    const summary = fileSummary instanceof FileComplianceSummary ? 
+      fileSummary : new FileComplianceSummary(fileSummary);
+    
+    this.fileSummaries.push(summary);
+    this.updateSummary();
+    return this;
+  }
+
+  updateSummary() {
+    // Reset counters
+    this.summary.totalFiles = this.fileSummaries.length;
+    this.summary.compliantFiles = 0;
+    this.summary.warningFiles = 0;
+    this.summary.violationFiles = 0;
+    this.summary.criticalFiles = 0;
+    this.summary.totalIssues = 0;
+    this.summary.totalLines = 0;
+    
+    // Reset category counts
+    for (const category of Object.values(COMPLIANCE_CATEGORIES)) {
+      this.issuesByCategory[category] = 0;
+    }
+    
+    let totalComplianceScore = 0;
+    let largestFile = null;
+    let smallestFile = null;
+    
+    // Aggregate from file summaries
+    for (const fileSummary of this.fileSummaries) {
+      // Count files by status
+      switch (fileSummary.status) {
+        case COMPLIANCE_STATUS.COMPLIANT:
+          this.summary.compliantFiles++;
+          break;
+        case COMPLIANCE_STATUS.WARNING:
+          this.summary.warningFiles++;
+          break;
+        case COMPLIANCE_STATUS.VIOLATION:
+          this.summary.violationFiles++;
+          break;
+        case COMPLIANCE_STATUS.CRITICAL:
+          this.summary.criticalFiles++;
+          break;
+      }
+      
+      // Aggregate issues
+      this.summary.totalIssues += fileSummary.totalIssues;
+      totalComplianceScore += fileSummary.complianceScore;
+      this.summary.totalLines += fileSummary.lineCount;
+      
+      // Track largest and smallest files
+      if (!largestFile || fileSummary.lineCount > largestFile.lineCount) {
+        largestFile = fileSummary;
+      }
+      
+      if (!smallestFile || fileSummary.lineCount < smallestFile.lineCount) {
+        smallestFile = fileSummary;
+      }
+      
+      // Aggregate issues by category
+      for (const issue of fileSummary.issues) {
+        this.issuesByCategory[issue.category] = (this.issuesByCategory[issue.category] || 0) + 1;
+      }
+    }
+    
+    // Calculate averages
+    this.summary.averageLines = this.summary.totalFiles > 0 ? 
+      Math.round(this.summary.totalLines / this.summary.totalFiles) : 0;
+    
+    this.summary.overallComplianceScore = this.summary.totalFiles > 0 ? 
+      totalComplianceScore / this.summary.totalFiles : 100;
+    
+    this.summary.largestFile = largestFile ? {
+      filePath: largestFile.filePath,
+      lineCount: largestFile.lineCount,
+      status: largestFile.status
+    } : null;
+    
+    this.summary.smallestFile = smallestFile ? {
+      filePath: smallestFile.filePath,
+      lineCount: smallestFile.lineCount,
+      status: smallestFile.status
+    } : null;
+    
+    // Update recommendations
+    this.generateRecommendations();
+  }
+
+  generateRecommendations() {
+    this.recommendations = [];
+    
+    // Critical issues
+    if (this.summary.criticalFiles > 0) {
+      this.recommendations.push({
+        priority: 'critical',
+        category: COMPLIANCE_CATEGORIES.FILE_SIZE,
+        title: `Address ${this.summary.criticalFiles} Critical Files`,
+        description: `${this.summary.criticalFiles} files have critical compliance violations requiring immediate attention.`,
+        action: 'Immediately address all critical violations',
+        affectedFiles: this.getFileSummariesByStatus(COMPLIANCE_STATUS.CRITICAL).map(s => s.filePath)
+      });
+    }
+    
+    // Violation files
+    if (this.summary.violationFiles > 0) {
+      this.recommendations.push({
+        priority: 'high',
+        category: COMPLIANCE_CATEGORIES.CODE_STRUCTURE,
+        title: `Fix ${this.summary.violationFiles} Files with Violations`,
+        description: `${this.summary.violationFiles} files have compliance violations that should be addressed.`,
+        action: 'Fix all compliance violations',
+        affectedFiles: this.getFileSummariesByStatus(COMPLIANCE_STATUS.VIOLATION).map(s => s.filePath)
+      });
+    }
+    
+    // Warning files
+    if (this.summary.warningFiles > 0) {
+      this.recommendations.push({
+        priority: 'medium',
+        category: COMPLIANCE_CATEGORIES.FILE_SIZE,
+        title: `Monitor ${this.summary.warningFiles} Files with Warnings`,
+        description: `${this.summary.warningFiles} files have warnings that should be monitored and addressed.`,
+        action: 'Review and address warning-level issues',
+        affectedFiles: this.getFileSummariesByStatus(COMPLIANCE_STATUS.WARNING).map(s => s.filePath)
+      });
+    }
+    
+    // File size issues
+    const file_size_issues = this.issuesByCategory[COMPLIANCE_CATEGORIES.FILE_SIZE];
+    if (file_size_issues > 0) {
+      this.recommendations.push({
+        priority: 'high',
+        category: COMPLIANCE_CATEGORIES.FILE_SIZE,
+        title: 'Optimize File Sizes',
+        description: `${file_size_issues} file size compliance issues detected.`,
+        action: 'Refactor files to comply with 555-line limit',
+        affectedFiles: this.getFileSummariesWithCategoryIssues(COMPLIANCE_CATEGORIES.FILE_SIZE).map(s => s.filePath)
+      });
+    }
+    
+    // Overall compliance score
+    if (this.summary.overallComplianceScore < 80) {
+      this.recommendations.push({
+        priority: 'high',
+        category: 'overall',
+        title: 'Improve Overall Compliance',
+        description: `Overall compliance score is ${this.summary.overallComplianceScore.toFixed(1)}%. Target is >90%.`,
+        action: 'Address violations to improve overall compliance',
+        affectedFiles: []
+      });
+    }
+  }
+
+  getFileSummariesByStatus(status) {
+    return this.fileSummaries.filter(summary => summary.status === status);
+  }
+
+  getFileSummariesWithCategoryIssues(category) {
+    return this.fileSummaries.filter(summary => 
+      summary.issues.some(issue => issue.category === category)
+    );
+  }
+
+  getFilesByComplianceScore(minScore = 0, maxScore = 100) {
+    return this.fileSummaries.filter(summary => 
+      summary.complianceScore >= minScore && summary.complianceScore <= maxScore
+    );
+  }
+
+  getTopViolations(limit = 10) {
+    return this.fileSummaries
+      .filter(summary => summary.status === COMPLIANCE_STATUS.VIOLATION || summary.status === COMPLIANCE_STATUS.CRITICAL)
+      .sort((a, b) => b.complianceScore - a.complianceScore)
+      .slice(0, limit);
+  }
+
+  toJSON() {
+    return {
+      id: this.id,
+      title: this.title,
+      description: this.description,
+      generatedAt: this.generatedAt,
+      scope: this.scope,
+      scopePath: this.scopePath,
+      version: this.version,
+      summary: this.summary,
+      issuesByCategory: this.issuesByCategory,
+      fileSummaries: this.fileSummaries.map(summary => summary.toJSON()),
+      recommendations: this.recommendations,
+      metadata: this.metadata
+    };
+  }
+
+  static fromJSON(data) {
+    return new ComplianceReport(data);
+  }
+
+  // Export to different formats
+  export(format = 'json') {
+    switch (format.toLowerCase()) {
+      case 'json':
+        return JSON.stringify(this.toJSON(), null, 2);
+      case 'summary':
+        return this.generateSummaryReport();
+      case 'detailed':
+        return this.generateDetailedReport();
+      default:
+        return this.toJSON();
+    }
+  }
+
+  generateSummaryReport() {
+    let report = `# ${this.title}\n\n`;
+    report += `**Generated:** ${new Date(this.generatedAt).toLocaleString()}\n`;
+    report += `**Scope:** ${this.scope} (${this.scopePath})\n`;
+    report += `**Overall Compliance Score:** ${this.summary.overallComplianceScore.toFixed(1)}%\n\n`;
+    
+    report += `## Summary\n\n`;
+    report += `- **Total Files:** ${this.summary.totalFiles}\n`;
+    report += `- **Compliant Files:** ${this.summary.compliantFiles}\n`;
+    report += `- **Warning Files:** ${this.summary.warningFiles}\n`;
+    report += `- **Violation Files:** ${this.summary.violationFiles}\n`;
+    report += `- **Critical Files:** ${this.summary.criticalFiles}\n`;
+    report += `- **Total Issues:** ${this.summary.totalIssues}\n`;
+    report += `- **Total Lines:** ${this.summary.totalLines}\n`;
+    report += `- **Average Lines:** ${this.summary.averageLines}\n\n`;
+    
+    if (this.recommendations.length > 0) {
+      report += `## Recommendations\n\n`;
+      for (const rec of this.recommendations) {
+        report += `### ${rec.title} (${rec.priority})\n`;
+        report += `${rec.description}\n\n`;
+        report += `**Action:** ${rec.action}\n\n`;
+      }
+    }
+    
+    return report;
+  }
+
+  generateDetailedReport() {
+    let report = this.generateSummaryReport();
+    
+    // Issues by category
+    report += `## Issues by Category\n\n`;
+    for (const [category, count] of Object.entries(this.issuesByCategory)) {
+      if (count > 0) {
+        report += `- **${category}:** ${count}\n`;
+      }
+    }
+    report += '\n';
+    
+    // File details
+    report += `## File Details\n\n`;
+    report += `| File | Lines | Status | Score | Issues |\n`;
+    report += `|------|------|--------|-------|--------|\n`;
+    
+    for (const fileSummary of this.fileSummaries.sort((a, b) => b.lineCount - a.lineCount)) {
+      const statusIcon = fileSummary.status === 'compliant' ? '✅' :
+                        fileSummary.status === 'warning' ? '⚠️' :
+                        fileSummary.status === 'violation' ? '❌' : '🚨';
+      
+      report += `| \`${fileSummary.filePath}\` | ${fileSummary.lineCount} | ${statusIcon} ${fileSummary.status} | ${fileSummary.complianceScore.toFixed(1)}% | ${fileSummary.totalIssues} |\n`;
+    }
+    
+    return report;
+  }
+}
+
+module.exports = {
+  ComplianceReport,
+  FileComplianceSummary,
+  ComplianceIssue,
+  COMPLIANCE_STATUS,
+  COMPLIANCE_CATEGORIES
+};