"""VLM (vision-language model) analysis — stub until Phase 4b moves Qwen3-VL code."""

from fastapi import APIRouter, HTTPException, status

router = APIRouter(prefix="/vlm", tags=["vlm"])


@router.post("/analyze")
async def analyze() -> None:
    """Analyze an image with a vision-language model.

    Phase 4a: stub. Phase 4b: proxies to Spark 2 (Qwen3-VL via vLLM).
    """
    raise HTTPException(
        status_code=status.HTTP_501_NOT_IMPLEMENTED,
        detail="vlm.analyze not implemented in Phase 4a — see BTE-REFACTOR-EXECUTION-PLAN Phase 4b",
    )