codereview-aia 0.1.3 → 0.2.0

package/dist/analysis/FindingsExtractor.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview Findings Extractor for Code Reviews
+ *
+ * This service extracts, categorizes, and analyzes findings from code review
+ * results. It provides utilities for grading, recommendation generation,
+ * and finding prioritization.
+ */
+/**
+ * Categorized findings from code review
+ */
+export interface CategorizedFindings {
+    high: Set<string>;
+    medium: Set<string>;
+    low: Set<string>;
+}
+/**
+ * Grade information with justification
+ */
+export interface GradeInfo {
+    grade: string;
+    justification: string;
+}
+/**
+ * Service for extracting and analyzing findings from code reviews
+ */
+export declare class FindingsExtractor {
+    /**
+     * Extract findings from review passes
+     * @param passes Array of review results with content
+     * @returns Categorized findings
+     */
+    extractFindingsFromPasses(passes: Array<{
+        content: string;
+    }>): CategorizedFindings;
+    /**
+     * Extract individual issue texts from content
+     * @param content Review content
+     * @returns Array of issue descriptions
+     */
+    extractIssueTexts(content: string): string[];
+    /**
+     * Check if an issue is high priority
+     * @param issue Issue text (lowercase)
+     * @returns True if high priority
+     */
+    private isHighPriority;
+    /**
+     * Check if an issue is medium priority
+     * @param issue Issue text (lowercase)
+     * @returns True if medium priority
+     */
+    private isMediumPriority;
+    /**
+     * Calculate grade based on findings for a specific category
+     * @param findings Categorized findings
+     * @param category Category name (for logging)
+     * @returns Grade information
+     */
+    calculateGrade(findings: CategorizedFindings, category: string): GradeInfo;
+    /**
+     * Calculate overall grade based on findings
+     * @param findings Categorized findings
+     * @returns Overall grade string
+     */
+    calculateOverallGrade(findings: CategorizedFindings): string;
+    /**
+     * Get justification for grade
+     * @param findings Categorized findings
+     * @param category Category name
+     * @returns Grade justification string
+     */
+    getGradeJustification(findings: CategorizedFindings, category: string): string;
+    /**
+     * Generate recommendations based on findings
+     * @param findings Categorized findings
+     * @param hasErrors Whether there are compilation errors
+     * @returns Array of recommendation strings
+     */
+    generateRecommendations(findings: CategorizedFindings, hasErrors: boolean): string[];
+    /**
+     * Check if findings contain security-related issues
+     * @param findings Categorized findings
+     * @returns True if security issues are present
+     */
+    private hasSecurityIssues;
+    /**
+     * Check if findings contain performance-related issues
+     * @param findings Categorized findings
+     * @returns True if performance issues are present
+     */
+    private hasPerformanceIssues;
+    /**
+     * Check if findings contain testing-related issues
+     * @param findings Categorized findings
+     * @returns True if testing issues are present
+     */
+    private hasTestingIssues;
+    /**
+     * Format findings for display in reports
+     * @param findings Categorized findings
+     * @param maxPerCategory Maximum items to show per category
+     * @returns Formatted findings string
+     */
+    formatFindings(findings: CategorizedFindings, maxPerCategory?: number): string;
+}

package/dist/analysis/FindingsExtractor.js

@@ -0,0 +1,363 @@
+"use strict";
+/**
+ * @fileoverview Findings Extractor for Code Reviews
+ *
+ * This service extracts, categorizes, and analyzes findings from code review
+ * results. It provides utilities for grading, recommendation generation,
+ * and finding prioritization.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FindingsExtractor = void 0;
+const logger_1 = __importDefault(require("../utils/logger"));
+/**
+ * Service for extracting and analyzing findings from code reviews
+ */
+class FindingsExtractor {
+    /**
+     * Extract findings from review passes
+     * @param passes Array of review results with content
+     * @returns Categorized findings
+     */
+    extractFindingsFromPasses(passes) {
+        const highPriorityFindings = new Set();
+        const mediumPriorityFindings = new Set();
+        const lowPriorityFindings = new Set();
+        for (const pass of passes) {
+            if (!pass.content)
+                continue;
+            const issueTexts = this.extractIssueTexts(pass.content);
+            for (const issue of issueTexts) {
+                const lowerIssue = issue.toLowerCase();
+                // Categorize by priority keywords
+                if (this.isHighPriority(lowerIssue)) {
+                    highPriorityFindings.add(issue);
+                }
+                else if (this.isMediumPriority(lowerIssue)) {
+                    mediumPriorityFindings.add(issue);
+                }
+                else {
+                    lowPriorityFindings.add(issue);
+                }
+            }
+        }
+        logger_1.default.debug(`Extracted findings: ${highPriorityFindings.size} high, ${mediumPriorityFindings.size} medium, ${lowPriorityFindings.size} low`);
+        return {
+            high: highPriorityFindings,
+            medium: mediumPriorityFindings,
+            low: lowPriorityFindings,
+        };
+    }
+    /**
+     * Extract individual issue texts from content
+     * @param content Review content
+     * @returns Array of issue descriptions
+     */
+    extractIssueTexts(content) {
+        const issues = [];
+        // Extract bullet points and numbered items
+        const bulletRegex = /^[\s]*[-*•]\s+(.+)$/gm;
+        const numberedRegex = /^[\s]*\d+\.\s+(.+)$/gm;
+        const dashRegex = /^[\s]*-\s+(.+)$/gm;
+        let match;
+        // Extract bullet points
+        while ((match = bulletRegex.exec(content)) !== null) {
+            const issue = match[1].trim();
+            if (issue.length > 10) {
+                // Filter out very short items
+                issues.push(issue);
+            }
+        }
+        // Extract numbered items
+        while ((match = numberedRegex.exec(content)) !== null) {
+            const issue = match[1].trim();
+            if (issue.length > 10) {
+                issues.push(issue);
+            }
+        }
+        // Extract dash items (alternative format)
+        while ((match = dashRegex.exec(content)) !== null) {
+            const issue = match[1].trim();
+            if (issue.length > 10) {
+                issues.push(issue);
+            }
+        }
+        // Remove duplicates
+        return [...new Set(issues)];
+    }
+    /**
+     * Check if an issue is high priority
+     * @param issue Issue text (lowercase)
+     * @returns True if high priority
+     */
+    isHighPriority(issue) {
+        const highPriorityKeywords = [
+            'security',
+            'vulnerability',
+            'critical',
+            'error',
+            'bug',
+            'crash',
+            'memory leak',
+            'sql injection',
+            'xss',
+            'csrf',
+            'injection',
+            'authentication',
+            'authorization',
+            'privilege escalation',
+            'data breach',
+            'sensitive data',
+            'password',
+            'token',
+            'deadlock',
+            'race condition',
+            'null pointer',
+            'buffer overflow',
+        ];
+        return highPriorityKeywords.some((keyword) => issue.includes(keyword));
+    }
+    /**
+     * Check if an issue is medium priority
+     * @param issue Issue text (lowercase)
+     * @returns True if medium priority
+     */
+    isMediumPriority(issue) {
+        const mediumPriorityKeywords = [
+            'warning',
+            'deprecated',
+            'inefficient',
+            'refactor',
+            'improve',
+            'optimization',
+            'maintainability',
+            'readability',
+            'complexity',
+            'duplication',
+            'coupling',
+            'cohesion',
+            'design pattern',
+            'architecture',
+            'structure',
+            'organization',
+            'naming',
+            'documentation',
+            'comment',
+            'test coverage',
+            'error handling',
+        ];
+        return mediumPriorityKeywords.some((keyword) => issue.includes(keyword));
+    }
+    /**
+     * Calculate grade based on findings for a specific category
+     * @param findings Categorized findings
+     * @param category Category name (for logging)
+     * @returns Grade information
+     */
+    calculateGrade(findings, category) {
+        const totalIssues = findings.high.size + findings.medium.size + findings.low.size;
+        let grade;
+        let justification;
+        if (findings.high.size > 5) {
+            grade = 'D';
+            justification = `Multiple critical issues (${findings.high.size}) require immediate attention`;
+        }
+        else if (findings.high.size > 2) {
+            grade = 'C';
+            justification = `Several critical issues (${findings.high.size}) need to be addressed`;
+        }
+        else if (findings.high.size > 0) {
+            grade = 'C+';
+            justification = `Some critical issues (${findings.high.size}) present`;
+        }
+        else if (findings.medium.size > 10) {
+            grade = 'C+';
+            justification = `Many medium-priority issues (${findings.medium.size}) affect code quality`;
+        }
+        else if (findings.medium.size > 5) {
+            grade = 'B';
+            justification = `Several medium-priority issues (${findings.medium.size}) could be improved`;
+        }
+        else if (findings.medium.size > 2) {
+            grade = 'B+';
+            justification = `Some medium-priority issues (${findings.medium.size}) noted`;
+        }
+        else if (totalIssues > 5) {
+            grade = 'A-';
+            justification = `Minor issues (${totalIssues}) but overall good quality`;
+        }
+        else if (totalIssues > 0) {
+            grade = 'A';
+            justification = `Very few issues (${totalIssues}), high quality code`;
+        }
+        else {
+            grade = 'A+';
+            justification = 'Excellent code quality with no significant issues';
+        }
+        logger_1.default.debug(`Grade for ${category}: ${grade} (${justification})`);
+        return { grade, justification };
+    }
+    /**
+     * Calculate overall grade based on findings
+     * @param findings Categorized findings
+     * @returns Overall grade string
+     */
+    calculateOverallGrade(findings) {
+        const gradeInfo = this.calculateGrade(findings, 'overall');
+        return gradeInfo.grade;
+    }
+    /**
+     * Get justification for grade
+     * @param findings Categorized findings
+     * @param category Category name
+     * @returns Grade justification string
+     */
+    getGradeJustification(findings, category) {
+        const gradeInfo = this.calculateGrade(findings, category);
+        return gradeInfo.justification;
+    }
+    /**
+     * Generate recommendations based on findings
+     * @param findings Categorized findings
+     * @param hasErrors Whether there are compilation errors
+     * @returns Array of recommendation strings
+     */
+    generateRecommendations(findings, hasErrors) {
+        const recommendations = [];
+        if (hasErrors) {
+            recommendations.push('Fix compilation errors before proceeding with other improvements');
+        }
+        if (findings.high.size > 0) {
+            recommendations.push(`Address ${findings.high.size} high-priority security and critical issues immediately`);
+            if (findings.high.size > 3) {
+                recommendations.push('Consider conducting a security audit given the number of critical issues');
+            }
+        }
+        if (findings.medium.size > 8) {
+            recommendations.push(`Review and address ${findings.medium.size} medium-priority maintainability issues`);
+            recommendations.push('Consider refactoring to improve code structure and maintainability');
+        }
+        else if (findings.medium.size > 3) {
+            recommendations.push(`Address ${findings.medium.size} medium-priority issues to improve code quality`);
+        }
+        if (findings.low.size > 15) {
+            recommendations.push(`Consider addressing ${findings.low.size} low-priority style and minor issues`);
+            recommendations.push('Implement automated linting and formatting tools');
+        }
+        else if (findings.low.size > 8) {
+            recommendations.push(`Review ${findings.low.size} low-priority issues when time permits`);
+        }
+        // Add positive recommendations for good code
+        if (findings.high.size === 0 && findings.medium.size < 3) {
+            recommendations.push('Code quality is good. Continue following current best practices.');
+            if (findings.low.size === 0) {
+                recommendations.push('Excellent code quality. Consider sharing best practices with the team.');
+            }
+        }
+        // Add specific recommendations based on issue types
+        if (this.hasSecurityIssues(findings)) {
+            recommendations.push('Implement security code review process and security testing');
+        }
+        if (this.hasPerformanceIssues(findings)) {
+            recommendations.push('Consider performance profiling and optimization');
+        }
+        if (this.hasTestingIssues(findings)) {
+            recommendations.push('Improve test coverage and add more comprehensive tests');
+        }
+        return recommendations;
+    }
+    /**
+     * Check if findings contain security-related issues
+     * @param findings Categorized findings
+     * @returns True if security issues are present
+     */
+    hasSecurityIssues(findings) {
+        const allFindings = [...findings.high, ...findings.medium, ...findings.low];
+        const securityKeywords = [
+            'security',
+            'vulnerability',
+            'injection',
+            'xss',
+            'csrf',
+            'authentication',
+        ];
+        return allFindings.some((finding) => securityKeywords.some((keyword) => finding.toLowerCase().includes(keyword)));
+    }
+    /**
+     * Check if findings contain performance-related issues
+     * @param findings Categorized findings
+     * @returns True if performance issues are present
+     */
+    hasPerformanceIssues(findings) {
+        const allFindings = [...findings.high, ...findings.medium, ...findings.low];
+        const performanceKeywords = [
+            'performance',
+            'slow',
+            'inefficient',
+            'optimization',
+            'memory',
+            'cpu',
+        ];
+        return allFindings.some((finding) => performanceKeywords.some((keyword) => finding.toLowerCase().includes(keyword)));
+    }
+    /**
+     * Check if findings contain testing-related issues
+     * @param findings Categorized findings
+     * @returns True if testing issues are present
+     */
+    hasTestingIssues(findings) {
+        const allFindings = [...findings.high, ...findings.medium, ...findings.low];
+        const testingKeywords = [
+            'test',
+            'coverage',
+            'mock',
+            'assertion',
+            'unit test',
+            'integration test',
+        ];
+        return allFindings.some((finding) => testingKeywords.some((keyword) => finding.toLowerCase().includes(keyword)));
+    }
+    /**
+     * Format findings for display in reports
+     * @param findings Categorized findings
+     * @param maxPerCategory Maximum items to show per category
+     * @returns Formatted findings string
+     */
+    formatFindings(findings, maxPerCategory = 5) {
+        const sections = [];
+        if (findings.high.size > 0) {
+            sections.push(`**High Priority (${findings.high.size}):**`);
+            sections.push(...Array.from(findings.high)
+                .slice(0, maxPerCategory)
+                .map((f) => `- ${f}`));
+            if (findings.high.size > maxPerCategory) {
+                sections.push(`- ... and ${findings.high.size - maxPerCategory} more`);
+            }
+            sections.push('');
+        }
+        if (findings.medium.size > 0) {
+            sections.push(`**Medium Priority (${findings.medium.size}):**`);
+            sections.push(...Array.from(findings.medium)
+                .slice(0, maxPerCategory)
+                .map((f) => `- ${f}`));
+            if (findings.medium.size > maxPerCategory) {
+                sections.push(`- ... and ${findings.medium.size - maxPerCategory} more`);
+            }
+            sections.push('');
+        }
+        if (findings.low.size > 0) {
+            sections.push(`**Low Priority (${findings.low.size}):**`);
+            sections.push(...Array.from(findings.low)
+                .slice(0, Math.min(maxPerCategory, 3))
+                .map((f) => `- ${f}`));
+            if (findings.low.size > 3) {
+                sections.push(`- ... and ${findings.low.size - 3} more`);
+            }
+        }
+        return sections.join('\n');
+    }
+}
+exports.FindingsExtractor = FindingsExtractor;
+//# sourceMappingURL=FindingsExtractor.js.map

package/dist/analysis/FindingsExtractor.js.map

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

package/dist/analysis/ai-detection/analyzers/BaseAnalyzer.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview Base analyzer class for AI detection patterns.
+ *
+ * This module provides the abstract base class that all specific analyzers extend,
+ * ensuring consistent interface and common functionality across different analysis types.
+ */
+import type { CodeSubmission, DetectedPattern, DetectionConfig, PatternDetectionResult } from '../types/DetectionTypes';
+/**
+ * Abstract base class for all AI detection analyzers
+ */
+export declare abstract class BaseAnalyzer {
+    protected config: DetectionConfig;
+    protected startTime: number;
+    /**
+     * Create a new base analyzer
+     * @param config Detection configuration
+     */
+    constructor(config: DetectionConfig);
+    /**
+     * Analyze the submission for AI-generated patterns
+     * @param submission Code submission to analyze
+     * @returns Analysis result specific to this analyzer
+     */
+    abstract analyze(submission: CodeSubmission): Promise<any>;
+    /**
+     * Get the analyzer name
+     * @returns Analyzer identifier
+     */
+    abstract getAnalyzerName(): string;
+    /**
+     * Check if this analyzer is enabled in configuration
+     * @returns True if analyzer should run
+     */
+    isEnabled(): boolean;
+    /**
+     * Start timing analysis
+     */
+    protected startTimer(): void;
+    /**
+     * Get elapsed time since timer start
+     * @returns Elapsed time in milliseconds
+     */
+    protected getElapsedTime(): number;
+    /**
+     * Create a detected pattern object
+     * @param id Pattern identifier
+     * @param name Human-readable name
+     * @param confidence Confidence level
+     * @param score Numerical score
+     * @param description Pattern description
+     * @param evidenceData Supporting evidence
+     * @returns Detected pattern object
+     */
+    protected createDetectedPattern(id: string, name: string, confidence: 'high' | 'medium' | 'low', score: number, description: string, evidenceData: Record<string, any>): DetectedPattern;
+    /**
+     * Create a pattern detection result
+     * @param detected Whether pattern was detected
+     * @param score Confidence score
+     * @param evidence Supporting evidence
+     * @returns Pattern detection result
+     */
+    protected createPatternResult(detected: boolean, score: number, evidence?: Record<string, any>): PatternDetectionResult;
+    /**
+     * Calculate uniformity of a numeric array
+     * Used for detecting suspiciously uniform patterns in code
+     * @param values Array of numeric values
+     * @returns Uniformity score from 0.0 to 1.0 (higher = more uniform)
+     */
+    protected calculateUniformity(values: number[]): number;
+    /**
+     * Calculate variance of a numeric array
+     * @param values Array of numeric values
+     * @param mean Pre-calculated mean (optional)
+     * @returns Variance value
+     */
+    protected calculateVariance(values: number[], mean?: number): number;
+    /**
+     * Extract sections from markdown or text content
+     * @param content Text content to analyze
+     * @returns Array of section headers found
+     */
+    protected extractSections(content: string): string[];
+    /**
+     * Count badges in markdown content
+     * @param content Markdown content
+     * @returns Number of badges found
+     */
+    protected countBadges(content: string): number;
+    /**
+     * Count generic phrases that suggest AI generation
+     * @param content Text content to analyze
+     * @returns Number of generic phrases found
+     */
+    protected countGenericPhrases(content: string): number;
+    /**
+     * Validate that a score is within valid range
+     * @param score Score to validate
+     * @returns Clamped score between 0.0 and 1.0
+     */
+    protected validateScore(score: number): number;
+    /**
+     * Check if analysis should timeout
+     * @returns True if analysis has exceeded time limit
+     */
+    protected shouldTimeout(): boolean;
+    /**
+     * Create timeout error
+     * @returns Error object for timeout
+     */
+    protected createTimeoutError(): Error;
+}