codereview-aia 0.1.3 → 0.1.4

package/dist/strategies/CodingTestReviewStrategy.d.ts

@@ -0,0 +1,194 @@
+/**
+ * @fileoverview Coding test review strategy implementation.
+ *
+ * This module implements the coding test review strategy for evaluating candidate submissions
+ * against assignment requirements using configurable scoring criteria and evaluation frameworks.
+ */
+import type { ApiClientConfig } from '../core/ApiClientSelector';
+import type { FileInfo, ReviewOptions, ReviewResult } from '../types/review';
+import type { ProjectDocs } from '../utils/projectDocs';
+import { BaseReviewStrategy } from './ReviewStrategy';
+/**
+ * Configuration interface for coding test evaluation
+ */
+export interface CodingTestConfig {
+    /** Assignment specification */
+    assignment?: {
+        title?: string;
+        description?: string;
+        requirements?: string[];
+        difficulty?: 'junior' | 'mid' | 'senior' | 'lead' | 'architect';
+        timeLimit?: number;
+        type?: 'coding-challenge' | 'take-home' | 'live-coding' | 'code-review';
+    };
+    /** Evaluation criteria with weights */
+    criteria?: Record<string, number> & {
+        correctness?: number;
+        codeQuality?: number;
+        architecture?: number;
+        performance?: number;
+        testing?: number;
+        documentation?: number;
+        errorHandling?: number;
+        security?: number;
+    };
+    /** Scoring configuration */
+    scoring?: {
+        system?: 'numeric' | 'letter' | 'pass-fail' | 'custom';
+        maxScore?: number;
+        passingThreshold?: number;
+        breakdown?: boolean;
+    };
+    /** Feedback configuration */
+    feedback?: {
+        level?: 'basic' | 'detailed' | 'comprehensive';
+        includeExamples?: boolean;
+        includeSuggestions?: boolean;
+        includeResources?: boolean;
+    };
+    /** Technical constraints */
+    constraints?: {
+        allowedLibraries?: string[];
+        forbiddenPatterns?: string[];
+        targetLanguage?: string;
+        framework?: string;
+        nodeVersion?: string;
+        memoryLimit?: number;
+        executionTimeout?: number;
+    };
+    /** AI detection configuration */
+    aiDetection?: {
+        enabled?: boolean;
+        threshold?: number;
+        analyzers?: ('git' | 'documentation' | 'structural' | 'statistical' | 'linguistic')[];
+        includeInReport?: boolean;
+        failOnDetection?: boolean;
+    };
+}
+/**
+ * Strategy for coding test assessment and evaluation
+ */
+export declare class CodingTestReviewStrategy extends BaseReviewStrategy {
+    private config;
+    private aiDetectionEngine?;
+    /**
+     * Create a new coding test review strategy
+     * @param config Coding test configuration or options for loading configuration
+     */
+    constructor(config?: CodingTestConfig | {
+        fromFile?: string;
+        fromUrl?: string;
+    });
+    /**
+     * Execute the coding test review strategy
+     * @param files Files to review
+     * @param projectName Project name
+     * @param projectDocs Project documentation
+     * @param options Review options
+     * @param apiClientConfig API client configuration
+     * @returns Promise resolving to the review result
+     */
+    execute(files: FileInfo[], projectName: string, projectDocs: ProjectDocs | null, options: ReviewOptions, apiClientConfig: ApiClientConfig): Promise<ReviewResult>;
+    /**
+     * Initialize configuration from various sources
+     * @param config Configuration or loading options
+     * @returns Initialized configuration
+     */
+    private initializeConfig;
+    /**
+     * Normalize and validate configuration
+     * @param config Input configuration
+     * @returns Normalized configuration
+     */
+    private normalizeConfig;
+    /**
+     * Validate that criteria weights sum to 100
+     * @param criteria Criteria configuration
+     */
+    private validateCriteriaWeights;
+    /**
+     * Merge CLI options with configuration
+     * @param options Review options
+     * @returns Merged configuration
+     */
+    private mergeOptionsWithConfig;
+    /**
+     * Determine if CI data should be collected
+     * @param files Files being reviewed
+     * @param options Review options
+     * @returns True if CI data should be collected
+     */
+    private shouldCollectCIData;
+    /**
+     * Enhance options with coding test context
+     * @param options Original options
+     * @param config Effective configuration
+     * @returns Enhanced options
+     */
+    private enhanceOptionsWithCodingTestContext;
+    /**
+     * Build assignment context prompt
+     * @param assignment Assignment configuration
+     * @returns Assignment context prompt
+     */
+    private buildAssignmentContextPrompt;
+    /**
+     * Build criteria context prompt
+     * @param criteria Criteria configuration
+     * @returns Criteria context prompt
+     */
+    private buildCriteriaContextPrompt;
+    /**
+     * Build scoring context prompt
+     * @param scoring Scoring configuration
+     * @returns Scoring context prompt
+     */
+    private buildScoringContextPrompt;
+    /**
+     * Build feedback instructions prompt
+     * @param feedback Feedback configuration
+     * @returns Feedback instructions prompt
+     */
+    private buildFeedbackInstructionsPrompt;
+    /**
+     * Build constraints context prompt
+     * @param constraints Constraints configuration
+     * @returns Constraints context prompt
+     */
+    private buildConstraintsContextPrompt;
+    /**
+     * Format criterion name for display
+     * @param criterion Criterion key
+     * @returns Formatted criterion name
+     */
+    private formatCriterionName;
+    /**
+     * Enhance result with coding test metadata
+     * @param result Original result
+     * @param config Configuration used
+     * @returns Enhanced result
+     */
+    private enhanceResultWithCodingTestMetadata;
+    /**
+     * Initialize AI detection engine with merged configuration
+     * @param config Effective configuration after merging options
+     */
+    private initializeAIDetectionWithConfig;
+    /**
+     * Initialize AI detection engine if enabled (legacy method - kept for compatibility)
+     */
+    private initializeAIDetection;
+    /**
+     * Build AI detection context prompt
+     * @param aiDetectionResult AI detection analysis result
+     * @param config AI detection configuration
+     * @returns AI detection context prompt
+     */
+    private buildAIDetectionContextPrompt;
+    /**
+     * Calculate risk level based on confidence score
+     * @param confidenceScore Confidence score from 0.0 to 1.0
+     * @returns Risk level
+     */
+    private calculateRiskLevel;
+}