pdd-cli 0.0.90__py3-none-any.whl → 0.0.118__py3-none-any.whl

pdd/server/routes/prompts.py

@@ -0,0 +1,1322 @@
+"""
+REST API endpoints for prompt analysis and preprocessing.
+
+Provides endpoints for preprocessing prompts and calculating token metrics
+without executing commands.
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import List, Optional
+
+from fastapi import APIRouter, Depends, HTTPException
+from pydantic import BaseModel, Field
+
+try:
+    from rich.console import Console
+    console = Console()
+except ImportError:
+    class Console:
+        def print(self, *args, **kwargs):
+            import builtins
+            builtins.print(*args)
+    console = Console()
+
+from ..security import PathValidator, SecurityError
+from ..token_counter import get_token_metrics
+from pdd.load_prompt_template import load_prompt_template
+
+
+# Request/Response Models
+
+class CostEstimateResponse(BaseModel):
+    """Cost estimation result."""
+    input_cost: float = Field(..., description="Estimated input cost in USD")
+    model: str = Field(..., description="Model used for estimation")
+    tokens: int = Field(..., description="Number of tokens")
+    cost_per_million: float = Field(..., description="Cost per million tokens")
+    currency: str = Field("USD", description="Currency code")
+
+
+class TokenMetricsResponse(BaseModel):
+    """Token metrics result."""
+    token_count: int = Field(..., description="Number of tokens")
+    context_limit: int = Field(..., description="Model context limit")
+    context_usage_percent: float = Field(..., description="Percentage of context used")
+    cost_estimate: Optional[CostEstimateResponse] = Field(None, description="Cost estimate if pricing available")
+
+
+class PromptAnalyzeRequest(BaseModel):
+    """Request to analyze a prompt file."""
+    path: str = Field(..., description="Path to prompt file (relative to project root)")
+    model: str = Field("claude-sonnet-4-20250514", description="Model to use for token estimation")
+    preprocess: bool = Field(True, description="Whether to preprocess the prompt")
+    content: Optional[str] = Field(None, description="Optional content to analyze instead of reading from file")
+
+
+class PromptAnalyzeResponse(BaseModel):
+    """Response from prompt analysis."""
+    raw_content: str = Field(..., description="Original prompt content")
+    processed_content: Optional[str] = Field(None, description="Preprocessed content (if requested)")
+    raw_metrics: TokenMetricsResponse = Field(..., description="Token metrics for raw content")
+    processed_metrics: Optional[TokenMetricsResponse] = Field(None, description="Token metrics for processed content")
+    preprocessing_succeeded: bool = Field(True, description="Whether preprocessing succeeded")
+    preprocessing_error: Optional[str] = Field(None, description="Preprocessing error if any")
+
+
+class SyncStatusResponse(BaseModel):
+    """Response from sync status check."""
+    status: str = Field(..., description="Sync status: in_sync, prompt_changed, code_changed, conflict, never_synced")
+    last_sync_timestamp: Optional[str] = Field(None, description="ISO timestamp of last sync")
+    last_sync_command: Optional[str] = Field(None, description="Last sync command executed")
+    prompt_modified: bool = Field(False, description="Whether prompt was modified since last sync")
+    code_modified: bool = Field(False, description="Whether code was modified since last sync")
+    fingerprint_exists: bool = Field(False, description="Whether a fingerprint exists")
+    prompt_exists: bool = Field(False, description="Whether the prompt file exists")
+    code_exists: bool = Field(False, description="Whether the code file exists")
+
+
+class ModelInfo(BaseModel):
+    """Information about an available LLM model."""
+    model: str = Field(..., description="Full model identifier (e.g., gpt-5.1-codex-mini)")
+    provider: str = Field(..., description="Model provider (e.g., OpenAI, Anthropic)")
+    input_cost: float = Field(..., description="Input cost per million tokens (USD)")
+    output_cost: float = Field(..., description="Output cost per million tokens (USD)")
+    elo: int = Field(..., description="Coding arena ELO rating")
+    context_limit: int = Field(..., description="Maximum context window size in tokens")
+    max_thinking_tokens: int = Field(0, description="Maximum thinking/reasoning tokens (0 if not supported)")
+    reasoning_type: str = Field("none", description="Reasoning type: none, effort, or budget")
+    structured_output: bool = Field(True, description="Whether the model supports structured output")
+
+
+class ModelsResponse(BaseModel):
+    """Response containing available models."""
+    models: list[ModelInfo] = Field(..., description="List of available models")
+    default_model: str = Field(..., description="Default model name")
+
+
+class MatchCheckRequest(BaseModel):
+    """Request to check prompt-code match."""
+    prompt_content: str = Field(..., description="Prompt/requirements content")
+    code_content: str = Field(..., description="Code content to evaluate")
+    strength: float = Field(0.5, description="Model strength (0-1)")
+
+
+class MatchCheckResult(BaseModel):
+    """Result from LLM match evaluation."""
+    match_score: int = Field(..., description="Match score (0-100)")
+    summary: str = Field(..., description="Summary of match analysis")
+    missing: list[str] = Field(default_factory=list, description="Missing requirements")
+    extra: list[str] = Field(default_factory=list, description="Extra code not in prompt")
+    suggestions: list[str] = Field(default_factory=list, description="Improvement suggestions")
+
+
+class MatchCheckResponse(BaseModel):
+    """Response from match check endpoint."""
+    result: MatchCheckResult = Field(..., description="Match evaluation result")
+    cost: float = Field(..., description="LLM invocation cost in USD")
+    model: str = Field(..., description="Model used for evaluation")
+
+
+# Diff Analysis Models (for detailed prompt-code diff visualization)
+
+class PromptRange(BaseModel):
+    """Line range in the prompt content."""
+    startLine: int = Field(..., description="Starting line number (1-indexed)")
+    endLine: int = Field(..., description="Ending line number (1-indexed)")
+    text: str = Field(..., description="Text excerpt from this range")
+
+
+class CodeRange(BaseModel):
+    """Line range in the code content."""
+    startLine: int = Field(..., description="Starting line number (1-indexed)")
+    endLine: int = Field(..., description="Ending line number (1-indexed)")
+    text: str = Field(..., description="Text excerpt from this range")
+
+
+class DiffSection(BaseModel):
+    """A section representing a semantic unit (requirement/feature) and its mapping."""
+    id: str = Field(..., description="Unique identifier for this section")
+    promptRange: PromptRange = Field(..., description="Line range in the prompt")
+    codeRanges: list[CodeRange] = Field(default_factory=list, description="Corresponding code ranges (can be multiple or empty)")
+    status: str = Field(..., description="Match status: matched, partial, missing, or extra")
+    matchConfidence: int = Field(..., description="Confidence score 0-100")
+    semanticLabel: str = Field(..., description="Semantic label (e.g., 'Error Handling', 'API Endpoint')")
+    notes: Optional[str] = Field("", description="Explanation of WHY this status exists")
+
+
+class LineMapping(BaseModel):
+    """Fine-grained line-level mapping between prompt and code."""
+    promptLine: int = Field(..., description="Line number in prompt (1-indexed)")
+    codeLines: list[int] = Field(default_factory=list, description="Corresponding line numbers in code")
+    matchType: str = Field(..., description="Match type: exact, semantic, partial, or none")
+
+
+class HiddenKnowledgeLocation(BaseModel):
+    """Location of hidden knowledge in code."""
+    startLine: int = Field(..., description="Starting line number (1-indexed)")
+    endLine: int = Field(..., description="Ending line number (1-indexed)")
+
+
+class HiddenKnowledge(BaseModel):
+    """Undocumented code knowledge that would be lost on regeneration."""
+    type: str = Field(..., description="Type: magic_value, algorithm_choice, edge_case, error_handling, api_contract, optimization, business_logic, assumption")
+    location: HiddenKnowledgeLocation = Field(..., description="Location in code")
+    description: str = Field(..., description="What the code knows that the prompt doesn't say")
+    regenerationImpact: str = Field(..., description="Impact: would_differ, would_fail, or might_work")
+    suggestedPromptAddition: str = Field(..., description="What to add to the prompt to capture this")
+
+
+class DiffStats(BaseModel):
+    """Aggregated statistics for the diff analysis."""
+    totalRequirements: int = Field(..., description="Total number of requirements identified in prompt")
+    matchedRequirements: int = Field(..., description="Number of fully matched requirements")
+    missingRequirements: int = Field(..., description="Number of requirements not implemented in code")
+    totalCodeFeatures: int = Field(0, description="Total number of code features/sections identified")
+    documentedFeatures: int = Field(0, description="Number of code features documented in prompt")
+    undocumentedFeatures: int = Field(0, description="Number of code features not in prompt")
+    promptToCodeCoverage: float = Field(..., description="How much of the prompt is implemented in code (0-100)")
+    codeToPromptCoverage: float = Field(0.0, description="How much of the code is documented in prompt (0-100)")
+    hiddenKnowledgeCount: int = Field(0, description="Number of hidden knowledge items found")
+    criticalGaps: int = Field(0, description="Number of critical gaps that would cause regeneration failure")
+
+
+class DiffAnalysisResult(BaseModel):
+    """Detailed diff analysis result focused on regeneration capability."""
+    overallScore: int = Field(..., description="Overall regeneration capability score 0-100")
+    canRegenerate: bool = Field(False, description="Conservative assessment: could this prompt produce working code?")
+    regenerationRisk: str = Field("high", description="Risk level: low, medium, high, or critical")
+    promptToCodeScore: int = Field(0, description="How well code implements prompt (0-100)")
+    codeToPromptScore: int = Field(0, description="How well prompt describes code (0-100)")
+    summary: str = Field(..., description="Summary of regeneration viability")
+    sections: list[DiffSection] = Field(default_factory=list, description="Prompt requirement sections with code mappings")
+    codeSections: list[DiffSection] = Field(default_factory=list, description="Code feature sections with prompt mappings")
+    hiddenKnowledge: list[HiddenKnowledge] = Field(default_factory=list, description="Undocumented code knowledge that would be lost")
+    lineMappings: list[LineMapping] = Field(default_factory=list, description="Line-level mappings")
+    stats: DiffStats = Field(..., description="Aggregated statistics")
+    missing: list[str] = Field(default_factory=list, description="Requirements in prompt but not in code")
+    extra: list[str] = Field(default_factory=list, description="Code features that would be LOST on regeneration")
+    suggestions: list[str] = Field(default_factory=list, description="Specific additions to enable regeneration")
+
+
+class DiffAnalysisRequest(BaseModel):
+    """Request for detailed prompt-code diff analysis."""
+    prompt_content: str = Field(..., description="Prompt/requirements content")
+    code_content: str = Field(..., description="Code content to analyze")
+    strength: float = Field(0.5, description="Model strength (0-1)")
+    mode: str = Field("detailed", description="Analysis mode: 'quick' or 'detailed'")
+    include_tests: bool = Field(True, description="Include test content in analysis")
+    prompt_path: Optional[str] = Field(None, description="Prompt path for auto-detecting tests")
+    code_path: Optional[str] = Field(None, description="Code path for finding associated tests")
+
+
+class DiffAnalysisResponse(BaseModel):
+    """Response from diff analysis endpoint."""
+    result: DiffAnalysisResult = Field(..., description="Detailed diff analysis result")
+    cost: float = Field(..., description="LLM invocation cost in USD")
+    model: str = Field(..., description="Model used for analysis")
+    analysisMode: str = Field(..., description="Analysis mode used")
+    cached: bool = Field(False, description="Whether result was from cache")
+    tests_included: bool = Field(False, description="Whether tests were included in analysis")
+    test_files: List[str] = Field(default_factory=list, description="Test files included in analysis")
+
+
+# Router setup
+router = APIRouter(prefix="/api/v1/prompts", tags=["prompts"])
+
+# Dependency injection placeholder
+_path_validator: Optional[PathValidator] = None
+
+
+def get_path_validator() -> PathValidator:
+    """Dependency to get the PathValidator instance."""
+    if _path_validator is None:
+        raise RuntimeError("PathValidator not configured")
+    return _path_validator
+
+
+def set_path_validator(validator: PathValidator) -> None:
+    """Configure the PathValidator instance."""
+    global _path_validator
+    _path_validator = validator
+
+
+@router.post("/analyze", response_model=PromptAnalyzeResponse)
+async def analyze_prompt(
+    request: PromptAnalyzeRequest,
+    validator: PathValidator = Depends(get_path_validator),
+):
+    """
+    Analyze a prompt file: preprocess it and calculate token metrics.
+
+    Returns both raw and processed content with their respective token counts,
+    context usage percentages, and cost estimates.
+
+    This endpoint does NOT execute any commands - it's purely for preview
+    and cost estimation before running expensive operations.
+    """
+    try:
+        abs_path = validator.validate(request.path)
+
+        # Use provided content if available, otherwise read from file
+        if request.content is not None:
+            raw_content = request.content
+            # Check content size (limit to 500KB)
+            if len(raw_content.encode('utf-8')) > 500 * 1024:
+                raise HTTPException(
+                    status_code=400,
+                    detail=f"Content too large for analysis (max 500KB)"
+                )
+        else:
+            # Read from file
+            if not abs_path.exists():
+                raise HTTPException(status_code=404, detail=f"File not found: {request.path}")
+
+            if abs_path.is_dir():
+                raise HTTPException(status_code=400, detail=f"Cannot analyze directory: {request.path}")
+
+            # Check file size (limit to 500KB for preprocessing)
+            file_size = abs_path.stat().st_size
+            if file_size > 500 * 1024:
+                raise HTTPException(
+                    status_code=400,
+                    detail=f"File too large for analysis: {file_size} bytes (max 500KB)"
+                )
+
+            # Read raw content
+            try:
+                raw_content = abs_path.read_text(encoding='utf-8')
+            except UnicodeDecodeError:
+                raise HTTPException(status_code=400, detail="File is not a valid text file")
+
+        # Calculate raw metrics
+        pricing_csv = validator.project_root / ".pdd" / "llm_model.csv"
+        raw_metrics = get_token_metrics(
+            raw_content,
+            model=request.model,
+            pricing_csv=pricing_csv if pricing_csv.exists() else None
+        )
+
+        # Preprocess if requested
+        processed_content = None
+        processed_metrics = None
+        preprocessing_succeeded = True
+        preprocessing_error = None
+
+        if request.preprocess:
+            try:
+                # Import here to avoid circular imports
+                from pdd.preprocess import preprocess
+
+                # Change to project root for relative includes to work
+                original_cwd = os.getcwd()
+                try:
+                    os.chdir(validator.project_root)
+                    processed_content = preprocess(
+                        raw_content,
+                        recursive=True,
+                        double_curly_brackets=True
+                    )
+                finally:
+                    os.chdir(original_cwd)
+
+                processed_metrics_obj = get_token_metrics(
+                    processed_content,
+                    model=request.model,
+                    pricing_csv=pricing_csv if pricing_csv.exists() else None
+                )
+                processed_metrics = TokenMetricsResponse(
+                    token_count=processed_metrics_obj.token_count,
+                    context_limit=processed_metrics_obj.context_limit,
+                    context_usage_percent=processed_metrics_obj.context_usage_percent,
+                    cost_estimate=CostEstimateResponse(**processed_metrics_obj.cost_estimate.to_dict())
+                        if processed_metrics_obj.cost_estimate else None
+                )
+            except Exception as e:
+                preprocessing_succeeded = False
+                preprocessing_error = str(e)
+                console.print(f"[yellow]Preprocessing warning: {e}[/yellow]")
+
+        # Convert raw metrics to response model
+        raw_metrics_response = TokenMetricsResponse(
+            token_count=raw_metrics.token_count,
+            context_limit=raw_metrics.context_limit,
+            context_usage_percent=raw_metrics.context_usage_percent,
+            cost_estimate=CostEstimateResponse(**raw_metrics.cost_estimate.to_dict())
+                if raw_metrics.cost_estimate else None
+        )
+
+        return PromptAnalyzeResponse(
+            raw_content=raw_content,
+            processed_content=processed_content,
+            raw_metrics=raw_metrics_response,
+            processed_metrics=processed_metrics,
+            preprocessing_succeeded=preprocessing_succeeded,
+            preprocessing_error=preprocessing_error,
+        )
+
+    except SecurityError as e:
+        raise HTTPException(status_code=403, detail=e.message)
+
+
+@router.get("/sync-status", response_model=SyncStatusResponse)
+async def get_sync_status(
+    basename: str,
+    language: str,
+    validator: PathValidator = Depends(get_path_validator),
+):
+    """
+    Get the sync status for a prompt/code pair.
+
+    Compares current file hashes with the stored fingerprint to determine
+    if the prompt and code are in sync, or if either has been modified.
+
+    Query parameters:
+        basename: The basename of the module (e.g., "calculator", "core/utils")
+        language: The programming language (e.g., "python", "typescript")
+
+    Returns:
+        SyncStatusResponse with status and modification details
+    """
+    try:
+        # Import sync utilities - these handle all the fingerprint logic
+        from pdd.sync_determine_operation import (
+            read_fingerprint,
+            get_pdd_file_paths,
+            calculate_sha256,
+        )
+
+        # Change to project root for proper path resolution
+        original_cwd = os.getcwd()
+        try:
+            os.chdir(validator.project_root)
+
+            # Get file paths for this module
+            paths = get_pdd_file_paths(basename, language)
+
+            # Check if files exist
+            prompt_exists = paths['prompt'].exists()
+            code_exists = paths['code'].exists()
+
+            # Read fingerprint (stored hash state)
+            fingerprint = read_fingerprint(basename, language)
+
+            if not fingerprint:
+                # No fingerprint - never synced
+                return SyncStatusResponse(
+                    status="never_synced",
+                    fingerprint_exists=False,
+                    prompt_exists=prompt_exists,
+                    code_exists=code_exists,
+                )
+
+            # Calculate current hashes
+            current_prompt_hash = calculate_sha256(paths['prompt']) if prompt_exists else None
+            current_code_hash = calculate_sha256(paths['code']) if code_exists else None
+
+            # Compare with fingerprint
+            prompt_modified = (
+                current_prompt_hash is not None and
+                fingerprint.prompt_hash is not None and
+                current_prompt_hash != fingerprint.prompt_hash
+            )
+            code_modified = (
+                current_code_hash is not None and
+                fingerprint.code_hash is not None and
+                current_code_hash != fingerprint.code_hash
+            )
+
+            # Determine status
+            if prompt_modified and code_modified:
+                status = "conflict"
+            elif prompt_modified:
+                status = "prompt_changed"
+            elif code_modified:
+                status = "code_changed"
+            else:
+                status = "in_sync"
+
+            return SyncStatusResponse(
+                status=status,
+                last_sync_timestamp=fingerprint.timestamp,
+                last_sync_command=fingerprint.command,
+                prompt_modified=prompt_modified,
+                code_modified=code_modified,
+                fingerprint_exists=True,
+                prompt_exists=prompt_exists,
+                code_exists=code_exists,
+            )
+
+        finally:
+            os.chdir(original_cwd)
+
+    except SecurityError as e:
+        raise HTTPException(status_code=403, detail=e.message)
+    except Exception as e:
+        console.print(f"[red]Error getting sync status: {e}[/red]")
+        raise HTTPException(status_code=500, detail=f"Error getting sync status: {str(e)}")
+
+
+@router.get("/models", response_model=ModelsResponse)
+async def get_available_models():
+    """
+    Get a list of available LLM models with their capabilities.
+
+    Returns model information including:
+    - Context limits
+    - Thinking/reasoning token capacity
+    - Pricing (input/output cost per million tokens)
+    - ELO ratings
+    """
+    try:
+        # Import here to avoid circular imports
+        from pdd.llm_invoke import _load_model_data, LLM_MODEL_CSV_PATH, DEFAULT_BASE_MODEL
+        from ..token_counter import MODEL_CONTEXT_LIMITS
+
+        # Load model data from CSV
+        model_df = _load_model_data(LLM_MODEL_CSV_PATH)
+
+        # Helper to determine context limit for a model
+        def get_context_limit(model_name: str) -> int:
+            """Get context limit based on model name."""
+            model_lower = model_name.lower()
+            for prefix, limit in MODEL_CONTEXT_LIMITS.items():
+                if prefix in model_lower:
+                    return limit
+            return MODEL_CONTEXT_LIMITS.get("default", 128000)
+
+        # Convert DataFrame to list of ModelInfo
+        models = []
+        for _, row in model_df.iterrows():
+            model_name = str(row.get('model', ''))
+            if not model_name:
+                continue
+
+            models.append(ModelInfo(
+                model=model_name,
+                provider=str(row.get('provider', 'Unknown')),
+                input_cost=float(row.get('input', 0)),
+                output_cost=float(row.get('output', 0)),
+                elo=int(row.get('coding_arena_elo', 0)),
+                context_limit=get_context_limit(model_name),
+                max_thinking_tokens=int(row.get('max_reasoning_tokens', 0)),
+                reasoning_type=str(row.get('reasoning_type', 'none')),
+                structured_output=bool(row.get('structured_output', True)),
+            ))
+
+        # Sort by ELO descending (best models first)
+        models.sort(key=lambda m: m.elo, reverse=True)
+
+        return ModelsResponse(
+            models=models,
+            default_model=DEFAULT_BASE_MODEL,
+        )
+
+    except Exception as e:
+        console.print(f"[red]Error getting available models: {e}[/red]")
+        raise HTTPException(status_code=500, detail=f"Error getting available models: {str(e)}")
+
+
+@router.post("/check-match", response_model=MatchCheckResponse)
+async def check_match(request: MatchCheckRequest):
+    """
+    Check how well code implements the requirements in a prompt using LLM judge.
+
+    Uses llm_invoke to evaluate the match between prompt requirements and code,
+    returning a score, summary, missing requirements, and suggestions.
+    """
+    try:
+        from pdd.llm_invoke import llm_invoke
+
+        judge_prompt = """You are a code review expert. Analyze how well the following code implements the requirements in the prompt.
+
+PROMPT/REQUIREMENTS:
+{prompt}
+
+CODE:
+{code}
+
+Evaluate the code against the prompt requirements and respond with a JSON object containing:
+- match_score: integer from 0-100 indicating how well the code matches the prompt
+- summary: 1-2 sentence summary of your analysis
+- missing: array of requirements from the prompt that are NOT implemented in the code
+- extra: array of code features that are NOT specified in the prompt
+- suggestions: array of improvement suggestions"""
+
+        result = llm_invoke(
+            prompt=judge_prompt,
+            input_json={"prompt": request.prompt_content, "code": request.code_content},
+            strength=request.strength,
+            temperature=0.1,
+            output_schema={
+                "type": "object",
+                "properties": {
+                    "match_score": {"type": "integer", "minimum": 0, "maximum": 100},
+                    "summary": {"type": "string"},
+                    "missing": {"type": "array", "items": {"type": "string"}},
+                    "extra": {"type": "array", "items": {"type": "string"}},
+                    "suggestions": {"type": "array", "items": {"type": "string"}}
+                },
+                "required": ["match_score", "summary"]
+            },
+            use_cloud=False,
+        )
+
+        # Parse result - it might be a string or dict depending on model
+        llm_result = result.get('result', {})
+        if isinstance(llm_result, str):
+            import json
+            llm_result = json.loads(llm_result)
+
+        return MatchCheckResponse(
+            result=MatchCheckResult(
+                match_score=llm_result.get('match_score', 0),
+                summary=llm_result.get('summary', ''),
+                missing=llm_result.get('missing', []),
+                extra=llm_result.get('extra', []),
+                suggestions=llm_result.get('suggestions', []),
+            ),
+            cost=result.get('cost', 0.0),
+            model=result.get('model_name', 'unknown'),
+        )
+
+    except Exception as e:
+        console.print(f"[red]Error checking match: {e}[/red]")
+        raise HTTPException(status_code=500, detail=f"Error checking match: {str(e)}")
+
+
+# Simple in-memory cache for diff analysis results
+_diff_cache: dict[str, tuple[DiffAnalysisResponse, float]] = {}
+_CACHE_TTL_SECONDS = 600  # 10 minutes
+
+
+def _get_cache_key(
+    prompt_content: str,
+    code_content: str,
+    mode: str,
+    include_tests: bool = False,
+    test_content: str = ""
+) -> str:
+    """Generate cache key from content hash."""
+    import hashlib
+    content = f"{prompt_content}|||{code_content}|||{mode}|||{include_tests}|||{test_content}"
+    return hashlib.sha256(content.encode()).hexdigest()
+
+
+def _get_cached_result(key: str) -> Optional[DiffAnalysisResponse]:
+    """Get cached result if not expired."""
+    import time
+    if key in _diff_cache:
+        result, timestamp = _diff_cache[key]
+        if time.time() - timestamp < _CACHE_TTL_SECONDS:
+            # Return cached result with cached flag set
+            return DiffAnalysisResponse(
+                result=result.result,
+                cost=result.cost,
+                model=result.model,
+                analysisMode=result.analysisMode,
+                cached=True,
+                tests_included=result.tests_included,
+                test_files=result.test_files,
+            )
+        else:
+            del _diff_cache[key]
+    return None
+
+
+def _cache_result(key: str, result: DiffAnalysisResponse) -> None:
+    """Cache a result."""
+    import time
+    _diff_cache[key] = (result, time.time())
+
+
+@router.post("/diff-analysis", response_model=DiffAnalysisResponse)
+async def analyze_diff(request: DiffAnalysisRequest):
+    """
+    Perform detailed diff analysis between prompt requirements and code.
+
+    Returns semantic sections with line-level mappings, showing how each
+    requirement in the prompt corresponds to code implementation.
+
+    Supports two modes:
+    - 'quick': Faster, lower-cost analysis with basic section mapping
+    - 'detailed': Full line-level mapping with higher accuracy
+
+    Results are cached for 10 minutes based on content hash.
+
+    If include_tests is True and prompt_path/code_path are provided,
+    test content will be appended to the prompt for more accurate analysis.
+    """
+    try:
+        from pdd.llm_invoke import llm_invoke
+        from pdd.construct_paths import _find_pddrc_file, _load_pddrc_config
+        from pdd.code_generator_main import _find_default_test_files
+        import json
+        import pathlib
+
+        # Process tests if requested
+        analysis_prompt = request.prompt_content
+        test_files_used: List[str] = []
+        test_content = ""
+
+        if request.include_tests and (request.prompt_path or request.code_path):
+            # Get tests_dir from .pddrc config
+            tests_dir = "tests"  # Default
+            pddrc_path = _find_pddrc_file()
+            if pddrc_path:
+                try:
+                    config = _load_pddrc_config(pddrc_path)
+                    tests_dir = config.get("tests_dir", "tests")
+                except Exception:
+                    pass
+
+            # Find test files based on code path
+            code_path = request.code_path
+            if not code_path and request.prompt_path:
+                # Try to infer code path from prompt path
+                # e.g., prompts/hello_python.prompt -> pdd/hello.py
+                prompt_path = pathlib.Path(request.prompt_path)
+                prompt_name = prompt_path.stem
+                # Remove language suffix (e.g., _python, _Python, _typescript)
+                # Case-insensitive matching
+                prompt_name_lower = prompt_name.lower()
+                for suffix in ['_python', '_typescript', '_javascript', '_rust', '_go', '_java', '_cpp', '_c', '_csharp', '_ruby', '_swift', '_kotlin']:
+                    if prompt_name_lower.endswith(suffix):
+                        prompt_name = prompt_name[:-len(suffix)]
+                        break
+                # This is a best-effort heuristic; may not always work
+
+            if code_path:
+                found_tests = _find_default_test_files(tests_dir, code_path)
+                if found_tests:
+                    test_content = "\n\n<unit_test_content>\n"
+                    test_content += "The following is the unit test content that the generated code must pass:\n"
+                    for tf in found_tests:
+                        try:
+                            with open(tf, 'r', encoding='utf-8') as f:
+                                content = f.read()
+                            test_content += f"\nFile: {pathlib.Path(tf).name}\n```python\n{content}\n```\n"
+                            test_files_used.append(tf)
+                        except Exception:
+                            pass
+                    test_content += "</unit_test_content>\n"
+                    analysis_prompt = request.prompt_content + test_content
+
+        # Check cache (includes test content in key)
+        cache_key = _get_cache_key(
+            request.prompt_content,
+            request.code_content,
+            request.mode,
+            request.include_tests,
+            test_content,
+        )
+        cached = _get_cached_result(cache_key)
+        if cached:
+            return cached
+
+        # Adjust strength based on mode
+        strength = request.strength
+        if request.mode == "quick":
+            strength = min(strength, 0.25)
+
+        # Load the LLM prompt template for bidirectional diff analysis
+        diff_prompt = load_prompt_template("prompt_code_diff_LLM")
+        if not diff_prompt:
+            raise HTTPException(
+                status_code=500,
+                detail="Failed to load prompt_code_diff_LLM.prompt template"
+            )
+
+        # Add line numbers to content (use analysis_prompt which includes tests)
+        prompt_lines = analysis_prompt.split('\n')
+        code_lines = request.code_content.split('\n')
+
+        prompt_numbered = '\n'.join(
+            f"{i+1}: {line}" for i, line in enumerate(prompt_lines)
+        )
+        code_numbered = '\n'.join(
+            f"{i+1}: {line}" for i, line in enumerate(code_lines)
+        )
+
+        # Define the output schema for bidirectional structured output
+        section_schema = {
+            "type": "object",
+            "properties": {
+                "id": {"type": "string"},
+                "promptRange": {
+                    "type": "object",
+                    "properties": {
+                        "startLine": {"type": "integer"},
+                        "endLine": {"type": "integer"},
+                        "text": {"type": "string"}
+                    },
+                    "required": ["startLine", "endLine", "text"]
+                },
+                "codeRanges": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "startLine": {"type": "integer"},
+                            "endLine": {"type": "integer"},
+                            "text": {"type": "string"}
+                        },
+                        "required": ["startLine", "endLine", "text"]
+                    }
+                },
+                "status": {"type": "string", "enum": ["matched", "partial", "missing", "extra"]},
+                "matchConfidence": {"type": "integer", "minimum": 0, "maximum": 100},
+                "semanticLabel": {"type": "string"},
+                "notes": {"type": "string", "description": "Required explanation of WHY this status exists"}
+            },
+            "required": ["id", "promptRange", "status", "matchConfidence", "semanticLabel", "notes"]
+        }
+
+        output_schema = {
+            "type": "object",
+            "properties": {
+                "overallScore": {"type": "integer", "minimum": 0, "maximum": 100},
+                "promptToCodeScore": {"type": "integer", "minimum": 0, "maximum": 100},
+                "codeToPromptScore": {"type": "integer", "minimum": 0, "maximum": 100},
+                "summary": {"type": "string"},
+                "sections": {"type": "array", "items": section_schema},
+                "codeSections": {"type": "array", "items": section_schema},
+                "lineMappings": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "promptLine": {"type": "integer"},
+                            "codeLines": {"type": "array", "items": {"type": "integer"}},
+                            "matchType": {"type": "string", "enum": ["exact", "semantic", "partial", "none"]}
+                        },
+                        "required": ["promptLine", "codeLines", "matchType"]
+                    }
+                },
+                "stats": {
+                    "type": "object",
+                    "properties": {
+                        "totalRequirements": {"type": "integer"},
+                        "matchedRequirements": {"type": "integer"},
+                        "missingRequirements": {"type": "integer"},
+                        "totalCodeFeatures": {"type": "integer"},
+                        "documentedFeatures": {"type": "integer"},
+                        "undocumentedFeatures": {"type": "integer"},
+                        "promptToCodeCoverage": {"type": "number"},
+                        "codeToPromptCoverage": {"type": "number"}
+                    },
+                    "required": ["totalRequirements", "matchedRequirements", "missingRequirements", "promptToCodeCoverage"]
+                },
+                "missing": {"type": "array", "items": {"type": "string"}},
+                "extra": {"type": "array", "items": {"type": "string"}},
+                "suggestions": {"type": "array", "items": {"type": "string"}}
+            },
+            "required": ["overallScore", "promptToCodeScore", "codeToPromptScore", "summary", "sections", "codeSections", "stats"]
+        }
+
+        result = llm_invoke(
+            prompt=diff_prompt,
+            input_json={
+                "prompt_numbered": prompt_numbered,
+                "code_numbered": code_numbered,
+            },
+            strength=strength,
+            temperature=0.1,
+            output_schema=output_schema,
+            use_cloud=False,
+        )
+
+        # Parse result
+        llm_result = result.get('result', {})
+        if isinstance(llm_result, str):
+            llm_result = json.loads(llm_result)
+
+        def parse_section(sec: dict) -> DiffSection:
+            """Helper to parse a section from LLM output."""
+            prompt_range = sec.get('promptRange', {})
+            code_ranges = [
+                CodeRange(
+                    startLine=cr.get('startLine', 1),
+                    endLine=cr.get('endLine', 1),
+                    text=cr.get('text', ''),
+                )
+                for cr in sec.get('codeRanges', [])
+            ]
+            return DiffSection(
+                id=sec.get('id', ''),
+                promptRange=PromptRange(
+                    startLine=prompt_range.get('startLine', 1),
+                    endLine=prompt_range.get('endLine', 1),
+                    text=prompt_range.get('text', ''),
+                ),
+                codeRanges=code_ranges,
+                status=sec.get('status', 'missing'),
+                matchConfidence=sec.get('matchConfidence', 0),
+                semanticLabel=sec.get('semanticLabel', ''),
+                notes=sec.get('notes'),
+            )
+
+        # Build prompt → code sections
+        sections = [parse_section(sec) for sec in llm_result.get('sections', [])]
+
+        # Build code → prompt sections
+        code_sections = [parse_section(sec) for sec in llm_result.get('codeSections', [])]
+
+        # Build line mappings
+        line_mappings = []
+        for lm in llm_result.get('lineMappings', []):
+            line_mappings.append(LineMapping(
+                promptLine=lm.get('promptLine', 1),
+                codeLines=lm.get('codeLines', []),
+                matchType=lm.get('matchType', 'none'),
+            ))
+
+        # Build stats with bidirectional coverage
+        stats_data = llm_result.get('stats', {})
+        stats = DiffStats(
+            totalRequirements=stats_data.get('totalRequirements', 0),
+            matchedRequirements=stats_data.get('matchedRequirements', 0),
+            missingRequirements=stats_data.get('missingRequirements', 0),
+            totalCodeFeatures=stats_data.get('totalCodeFeatures', 0),
+            documentedFeatures=stats_data.get('documentedFeatures', 0),
+            undocumentedFeatures=stats_data.get('undocumentedFeatures', 0),
+            promptToCodeCoverage=stats_data.get('promptToCodeCoverage', 0.0),
+            codeToPromptCoverage=stats_data.get('codeToPromptCoverage', 0.0),
+        )
+
+        # Build response with bidirectional scores
+        response = DiffAnalysisResponse(
+            result=DiffAnalysisResult(
+                overallScore=llm_result.get('overallScore', 0),
+                promptToCodeScore=llm_result.get('promptToCodeScore', 0),
+                codeToPromptScore=llm_result.get('codeToPromptScore', 0),
+                summary=llm_result.get('summary', ''),
+                sections=sections,
+                codeSections=code_sections,
+                lineMappings=line_mappings,
+                stats=stats,
+                missing=llm_result.get('missing', []),
+                extra=llm_result.get('extra', []),
+                suggestions=llm_result.get('suggestions', []),
+            ),
+            cost=result.get('cost', 0.0),
+            model=result.get('model_name', 'unknown'),
+            analysisMode=request.mode,
+            cached=False,
+            tests_included=len(test_files_used) > 0,
+            test_files=test_files_used,
+        )
+
+        # Cache the result
+        _cache_result(cache_key, response)
+
+        return response
+
+    except Exception as e:
+        console.print(f"[red]Error analyzing diff: {e}[/red]")
+        raise HTTPException(status_code=500, detail=f"Error analyzing diff: {str(e)}")
+
+
+# =============================================================================
+# Prompt Version History and Diff Analysis (Feature 1)
+# =============================================================================
+
+class PromptVersionInfo(BaseModel):
+    """Information about a prompt version from git history."""
+    commit_hash: str = Field(..., description="Git commit hash")
+    commit_date: str = Field(..., description="Commit date in ISO format")
+    commit_message: str = Field(..., description="Commit message")
+    author: str = Field(..., description="Author name")
+    prompt_content: str = Field(..., description="Prompt content at this version")
+
+
+class PromptHistoryRequest(BaseModel):
+    """Request for prompt git history."""
+    prompt_path: str = Field(..., description="Path to the prompt file")
+    limit: int = Field(10, description="Maximum number of versions to retrieve")
+
+
+class PromptHistoryResponse(BaseModel):
+    """Response with prompt versions from git history."""
+    versions: List[PromptVersionInfo] = Field(default_factory=list)
+    current_content: str = Field(..., description="Current working directory content")
+    has_uncommitted_changes: bool = Field(False, description="Whether there are uncommitted changes")
+
+
+class LinguisticChange(BaseModel):
+    """A semantic/linguistic change between prompt versions."""
+    change_type: str = Field(..., description="Type: added, removed, modified")
+    category: str = Field(..., description="Category: requirement, constraint, behavior, format")
+    description: str = Field(..., description="Description of the change")
+    old_text: Optional[str] = Field(None, description="Old text (for modified/removed)")
+    new_text: Optional[str] = Field(None, description="New text (for added/modified)")
+    impact: str = Field(..., description="Impact: breaking, enhancement, clarification")
+
+
+class PromptDiffRequest(BaseModel):
+    """Request to diff two prompt versions."""
+    prompt_path: str = Field(..., description="Path to the prompt file")
+    version_a: str = Field(..., description="First version: commit hash, 'HEAD', or 'working'")
+    version_b: str = Field(..., description="Second version: commit hash, 'HEAD', or 'working'")
+    code_path: Optional[str] = Field(None, description="Optional code path for related code diff")
+    strength: float = Field(0.5, description="Model strength (0-1) for analysis quality")
+
+
+class PromptDiffResponse(BaseModel):
+    """Response with prompt version diff analysis."""
+    prompt_a_content: str = Field(..., description="Content of version A (older)")
+    prompt_b_content: str = Field(..., description="Content of version B (newer)")
+    text_diff: str = Field(..., description="Unified text diff (old → new)")
+    linguistic_changes: List[LinguisticChange] = Field(default_factory=list)
+    code_diff: Optional[str] = Field(None, description="Code diff if code_path provided")
+    summary: str = Field(..., description="LLM-generated summary of semantic changes")
+    cost: float = Field(0.0, description="LLM analysis cost")
+    model: str = Field("", description="Model used for analysis")
+    version_a_label: str = Field("", description="Label for version A (the older version)")
+    version_b_label: str = Field("", description="Label for version B (the newer version)")
+    versions_swapped: bool = Field(False, description="Whether versions were swapped to ensure old→new order")
+
+
+def _get_git_file_at_commit(file_path: str, commit: str) -> Optional[str]:
+    """Get file content at a specific git commit."""
+    import subprocess
+    try:
+        result = subprocess.run(
+            ['git', 'show', f'{commit}:{file_path}'],
+            capture_output=True,
+            text=True,
+            cwd=Path(file_path).parent if Path(file_path).is_absolute() else None,
+        )
+        if result.returncode == 0:
+            return result.stdout
+        return None
+    except Exception:
+        return None
+
+
+def _get_git_log(file_path: str, limit: int = 10) -> List[dict]:
+    """Get git log for a file."""
+    import subprocess
+    try:
+        # Format: hash|date|message|author
+        result = subprocess.run(
+            ['git', 'log', f'-n{limit}', '--format=%H|%aI|%s|%an', '--', file_path],
+            capture_output=True,
+            text=True,
+            cwd=Path(file_path).parent if Path(file_path).is_absolute() else None,
+        )
+        if result.returncode != 0:
+            return []
+
+        commits = []
+        for line in result.stdout.strip().split('\n'):
+            if not line:
+                continue
+            parts = line.split('|', 3)
+            if len(parts) >= 4:
+                commits.append({
+                    'commit_hash': parts[0],
+                    'commit_date': parts[1],
+                    'commit_message': parts[2],
+                    'author': parts[3],
+                })
+        return commits
+    except Exception:
+        return []
+
+
+def _has_uncommitted_changes(file_path: str) -> bool:
+    """Check if file has uncommitted changes."""
+    import subprocess
+    try:
+        result = subprocess.run(
+            ['git', 'status', '--porcelain', '--', file_path],
+            capture_output=True,
+            text=True,
+            cwd=Path(file_path).parent if Path(file_path).is_absolute() else None,
+        )
+        return bool(result.stdout.strip())
+    except Exception:
+        return False
+
+
+def _get_text_diff(content_a: str, content_b: str) -> str:
+    """Generate unified diff between two strings."""
+    import difflib
+    diff = difflib.unified_diff(
+        content_a.splitlines(keepends=True),
+        content_b.splitlines(keepends=True),
+        fromfile='version_a',
+        tofile='version_b',
+    )
+    return ''.join(diff)
+
+
+def _get_commit_timestamp(file_path: str, version: str) -> Optional[str]:
+    """
+    Get ISO timestamp for a version identifier.
+
+    Returns:
+        ISO timestamp string, or None if not determinable.
+        'working' returns current time (newest).
+        'HEAD' returns HEAD commit time.
+        Commit hashes return their commit time.
+    """
+    import subprocess
+    from datetime import datetime
+
+    if version == 'working':
+        # Working directory is always the "newest" - return current time
+        return datetime.now().isoformat()
+
+    try:
+        # Get commit timestamp
+        commit = 'HEAD' if version == 'HEAD' else version
+        result = subprocess.run(
+            ['git', 'log', '-1', '--format=%aI', commit],
+            capture_output=True,
+            text=True,
+            cwd=Path(file_path).parent if Path(file_path).is_absolute() else None,
+        )
+        if result.returncode == 0 and result.stdout.strip():
+            return result.stdout.strip()
+        return None
+    except Exception:
+        return None
+
+
+def _is_version_newer(file_path: str, version_a: str, version_b: str) -> bool:
+    """
+    Determine if version_a is newer than version_b.
+
+    Returns True if version_a is newer, False otherwise.
+    """
+    ts_a = _get_commit_timestamp(file_path, version_a)
+    ts_b = _get_commit_timestamp(file_path, version_b)
+
+    if ts_a is None or ts_b is None:
+        # If we can't determine, assume the order is correct
+        return False
+
+    return ts_a > ts_b
+
+
+@router.post("/git-history", response_model=PromptHistoryResponse)
+async def get_prompt_git_history(request: PromptHistoryRequest):
+    """
+    Get git history for a prompt file.
+
+    Returns a list of versions with their content, commit info, and
+    whether there are uncommitted changes in the working directory.
+    """
+    try:
+        prompt_path = request.prompt_path
+        file_path = Path(prompt_path)
+
+        # Get current content
+        current_content = ""
+        if file_path.exists():
+            current_content = file_path.read_text(encoding='utf-8')
+
+        # Get git log
+        commits = _get_git_log(prompt_path, request.limit)
+
+        # Build version list with content
+        versions = []
+        for commit in commits:
+            content = _get_git_file_at_commit(prompt_path, commit['commit_hash'])
+            if content is not None:
+                versions.append(PromptVersionInfo(
+                    commit_hash=commit['commit_hash'],
+                    commit_date=commit['commit_date'],
+                    commit_message=commit['commit_message'],
+                    author=commit['author'],
+                    prompt_content=content,
+                ))
+
+        # Check for uncommitted changes
+        has_changes = _has_uncommitted_changes(prompt_path)
+
+        return PromptHistoryResponse(
+            versions=versions,
+            current_content=current_content,
+            has_uncommitted_changes=has_changes,
+        )
+
+    except Exception as e:
+        console.print(f"[red]Error getting git history: {e}[/red]")
+        raise HTTPException(status_code=500, detail=f"Error getting git history: {str(e)}")
+
+
+@router.post("/prompt-diff", response_model=PromptDiffResponse)
+async def get_prompt_diff(request: PromptDiffRequest):
+    """
+    Compare two prompt versions with LLM-powered linguistic analysis.
+
+    Analyzes semantic differences between prompt versions and categorizes
+    changes by type (requirement, constraint, behavior, format) and
+    impact (breaking, enhancement, clarification).
+
+    Note: Versions are automatically ordered so version_a is older and
+    version_b is newer. This ensures "added" means new content and
+    "removed" means deleted content.
+    """
+    try:
+        from pdd.llm_invoke import llm_invoke
+        import json
+
+        prompt_path = request.prompt_path
+        file_path = Path(prompt_path)
+
+        # Determine version order - we want older → newer
+        version_a = request.version_a
+        version_b = request.version_b
+        versions_swapped = False
+
+        # Check if we need to swap to ensure old → new order
+        if _is_version_newer(prompt_path, version_a, version_b):
+            # version_a is newer, so swap them
+            version_a, version_b = version_b, version_a
+            versions_swapped = True
+
+        # Create human-readable labels
+        def _version_label(v: str) -> str:
+            if v == 'working':
+                return 'Working Directory'
+            elif v == 'HEAD':
+                return 'HEAD'
+            else:
+                return v[:7]  # Short commit hash
+
+        version_a_label = _version_label(version_a)
+        version_b_label = _version_label(version_b)
+
+        # Get content for version A (older)
+        if version_a == 'working':
+            content_a = file_path.read_text(encoding='utf-8') if file_path.exists() else ""
+        elif version_a == 'HEAD':
+            content_a = _get_git_file_at_commit(prompt_path, 'HEAD') or ""
+        else:
+            content_a = _get_git_file_at_commit(prompt_path, version_a) or ""
+
+        # Get content for version B (newer)
+        if version_b == 'working':
+            content_b = file_path.read_text(encoding='utf-8') if file_path.exists() else ""
+        elif version_b == 'HEAD':
+            content_b = _get_git_file_at_commit(prompt_path, 'HEAD') or ""
+        else:
+            content_b = _get_git_file_at_commit(prompt_path, version_b) or ""
+
+        # Generate text diff (old → new)
+        text_diff = _get_text_diff(content_a, content_b)
+
+        # Get code diff if requested
+        code_diff = None
+        if request.code_path:
+            code_path = Path(request.code_path)
+            if version_a == 'working':
+                code_a = code_path.read_text(encoding='utf-8') if code_path.exists() else ""
+            elif version_a == 'HEAD':
+                code_a = _get_git_file_at_commit(request.code_path, 'HEAD') or ""
+            else:
+                code_a = _get_git_file_at_commit(request.code_path, version_a) or ""
+
+            if version_b == 'working':
+                code_b = code_path.read_text(encoding='utf-8') if code_path.exists() else ""
+            elif version_b == 'HEAD':
+                code_b = _get_git_file_at_commit(request.code_path, 'HEAD') or ""
+            else:
+                code_b = _get_git_file_at_commit(request.code_path, version_b) or ""
+
+            code_diff = _get_text_diff(code_a, code_b)
+
+        # LLM analysis for linguistic changes
+        diff_prompt = load_prompt_template("prompt_diff_LLM")
+        if not diff_prompt:
+            # Fallback: return without LLM analysis
+            return PromptDiffResponse(
+                prompt_a_content=content_a,
+                prompt_b_content=content_b,
+                text_diff=text_diff,
+                linguistic_changes=[],
+                code_diff=code_diff,
+                summary="LLM analysis unavailable (template not found)",
+                cost=0.0,
+                model="",
+                version_a_label=version_a_label,
+                version_b_label=version_b_label,
+                versions_swapped=versions_swapped,
+            )
+
+        # Define output schema for linguistic analysis
+        output_schema = {
+            "type": "object",
+            "properties": {
+                "summary": {"type": "string"},
+                "changes": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "change_type": {"type": "string", "enum": ["added", "removed", "modified"]},
+                            "category": {"type": "string", "enum": ["requirement", "constraint", "behavior", "format"]},
+                            "description": {"type": "string"},
+                            "old_text": {"type": "string"},
+                            "new_text": {"type": "string"},
+                            "impact": {"type": "string", "enum": ["breaking", "enhancement", "clarification"]},
+                        },
+                        "required": ["change_type", "category", "description", "impact"]
+                    }
+                }
+            },
+            "required": ["summary", "changes"]
+        }
+
+        result = llm_invoke(
+            prompt=diff_prompt,
+            input_json={
+                "prompt_a": content_a,
+                "prompt_b": content_b,
+                "text_diff": text_diff,
+            },
+            strength=request.strength,
+            temperature=0.1,
+            output_schema=output_schema,
+            use_cloud=False,
+        )
+
+        llm_result = result.get('result', {})
+        if isinstance(llm_result, str):
+            llm_result = json.loads(llm_result)
+
+        # Parse linguistic changes
+        linguistic_changes = []
+        for change in llm_result.get('changes', []):
+            linguistic_changes.append(LinguisticChange(
+                change_type=change.get('change_type', 'modified'),
+                category=change.get('category', 'requirement'),
+                description=change.get('description', ''),
+                old_text=change.get('old_text'),
+                new_text=change.get('new_text'),
+                impact=change.get('impact', 'clarification'),
+            ))
+
+        return PromptDiffResponse(
+            prompt_a_content=content_a,
+            prompt_b_content=content_b,
+            text_diff=text_diff,
+            linguistic_changes=linguistic_changes,
+            code_diff=code_diff,
+            summary=llm_result.get('summary', ''),
+            cost=result.get('cost', 0.0),
+            model=result.get('model_name', 'unknown'),
+            version_a_label=version_a_label,
+            version_b_label=version_b_label,
+            versions_swapped=versions_swapped,
+        )
+
+    except Exception as e:
+        console.print(f"[red]Error analyzing prompt diff: {e}[/red]")
+        raise HTTPException(status_code=500, detail=f"Error analyzing prompt diff: {str(e)}")