feat(zero_shot): enhance evaluation pipeline with rerun-judge and cha… (#63)

* feat(zero_shot): enhance evaluation pipeline with rerun-judge and chart improvements

- Add --rerun-judge flag to re-run pairwise evaluation with different judge model
- Enhance chart_generator with additional visualization options
- Update schema with new configuration options
- Improve zero_shot_pipeline with better checkpoint management
- Fix minor issue in openai_chat_model

* fix: address code review comments

- Use model.lower() for case-insensitive model name matching in openai_chat_model.py
- Consolidate rerun_judge and fresh flag handling logic in __main__.py

Author: XiaoBoAI

cookbooks/zero_shot_evaluation/__main__.py

@@ -5,6 +5,7 @@
     python -m cookbooks.zero_shot_evaluation --config config.yaml
     python -m cookbooks.zero_shot_evaluation --config config.yaml --save
     python -m cookbooks.zero_shot_evaluation --config config.yaml --queries_file queries.json --save
+    python -m cookbooks.zero_shot_evaluation --config config.yaml --rerun-judge --save
 """
 
 import asyncio
@@ -28,6 +29,43 @@ def _load_queries_from_file(queries_file: str) -> List[GeneratedQuery]:
     return queries
 
 
+def _clear_judge_results(output_dir: str) -> bool:
+    """Clear only comparison results to re-run with new judge model.
+
+    Keeps queries, responses, and rubrics intact.
+    Only removes comparison_details.json and resets checkpoint to RUBRICS_GENERATED.
+
+    Returns:
+        True if successfully cleared, False if no checkpoint exists
+    """
+    output_path = Path(output_dir)
+    checkpoint_file = output_path / "checkpoint.json"
+    details_file = output_path / "comparison_details.json"
+
+    if not checkpoint_file.exists():
+        logger.warning("No checkpoint found, nothing to clear")
+        return False
+
+    # Remove comparison details
+    if details_file.exists():
+        details_file.unlink()
+        logger.info(f"Removed {details_file}")
+
+    # Update checkpoint to RUBRICS_GENERATED stage
+    with open(checkpoint_file, "r", encoding="utf-8") as f:
+        checkpoint = json.load(f)
+
+    checkpoint["stage"] = "rubrics_generated"
+    checkpoint["evaluated_pairs"] = 0
+    checkpoint["total_pairs"] = 0
+
+    with open(checkpoint_file, "w", encoding="utf-8") as f:
+        json.dump(checkpoint, f, indent=2, ensure_ascii=False)
+
+    logger.info("Reset checkpoint to RUBRICS_GENERATED stage (will re-run pairwise evaluation)")
+    return True
+
+
 async def _run_evaluation(
     config_path: str,
     output_dir: Optional[str] = None,
@@ -67,6 +105,7 @@ def main(
     queries_file: Optional[str] = None,
     save: bool = False,
     fresh: bool = False,
+    rerun_judge: bool = False,
 ) -> None:
     """Zero-shot evaluation CLI with checkpoint support.
 
@@ -76,6 +115,8 @@ def main(
         queries_file: Path to pre-generated queries JSON (skip query generation)
         save: Whether to save results to file
         fresh: Start fresh, ignore any existing checkpoint
+        rerun_judge: Re-run only pairwise evaluation with new judge model
+                     (keeps queries, responses, and rubrics)
 
     Examples:
         # Normal run (auto-resumes from checkpoint)
@@ -86,6 +127,9 @@ def main(
 
         # Start fresh, ignore checkpoint
         python -m cookbooks.zero_shot_evaluation --config config.yaml --fresh --save
+
+        # Re-run with new judge model (keeps queries/responses/rubrics)
+        python -m cookbooks.zero_shot_evaluation --config config.yaml --rerun-judge --save
     """
     config_path = Path(config)
     if not config_path.exists():
@@ -98,15 +142,27 @@ def main(
             logger.error(f"Queries file not found: {queries_file}")
             return
 
-    logger.info(f"Starting zero-shot evaluation with config: {config}")
-    if queries_file:
-        logger.info(f"Using pre-generated queries from: {queries_file}")
-    if fresh:
+    # Load config to get output_dir
+    loaded_config = load_config(str(config_path))
+    effective_output_dir = output_dir or loaded_config.output.output_dir
+
+    # Handle rerun_judge and fresh flags
+    if rerun_judge:
+        if fresh:
+            logger.warning("--rerun-judge and --fresh are mutually exclusive, using --rerun-judge")
+        logger.info("Re-running pairwise evaluation with new judge model...")
+        if not _clear_judge_results(effective_output_dir):
+            logger.info("No previous results found, will run full evaluation")
+    elif fresh:
         logger.info("Starting fresh (ignoring checkpoint)")
     else:
         logger.info("Resume mode enabled (will continue from checkpoint if exists)")
 
-    asyncio.run(_run_evaluation(str(config_path), output_dir, queries_file, save, resume=not fresh))
+    logger.info(f"Starting zero-shot evaluation with config: {config}")
+    if queries_file:
+        logger.info(f"Using pre-generated queries from: {queries_file}")
+
+    asyncio.run(_run_evaluation(str(config_path), output_dir, queries_file, save, resume=not fresh or rerun_judge))
 
 
 if __name__ == "__main__":