Add codereview_env/graders/grader_utils.py

codereview_env/graders/grader_utils.py

@@ -0,0 +1,33 @@
+from typing import List, Optional
+from codereview_env.models import GroundTruthIssue, Action
+
+def keyword_overlap(body: str, keywords: List[str]) -> float:
+    """Returns 0.0–1.0 confidence score based on keyword coverage."""
+    if not body or not keywords:
+        return 0.5  # Neutral credit for missing body or keywords
+    
+    body_lower = body.lower()
+    hits = sum(1 for kw in keywords if kw.lower() in body_lower)
+    
+    # Roadmap logic: min(1.0, hits / max(4, len(keywords) * 0.6))
+    threshold = max(4, len(keywords) * 0.6)
+    return min(1.0, hits / threshold)
+
+def find_best_match(action: Action, ground_truth: List[GroundTruthIssue], already_matched: set) -> Optional[GroundTruthIssue]:
+    """Line-number match (exact-ish) OR category+file match."""
+    for gt in ground_truth:
+        if gt.id in already_matched:
+            continue
+        
+        # Line number match within 3 lines
+        line_match = (action.line_number is not None and 
+                      abs(action.line_number - gt.line_number) <= 3)
+        
+        # Category and filename match
+        cat_match = (action.category == gt.category and 
+                     action.filename == gt.filename)
+        
+        if line_match or cat_match:
+            return gt
+            
+    return None