"""日志路由：查询内存日志缓冲，供 /logs 页面消费。

分层语义：
- debug：详细（ffmpeg 命令、模型加载/卸载、转写逐段、翻译逐批进度）
- info：简略（仅任务阶段转换，如 "任务 N [transcribing 55%]"）
- warning / error：更详细，error 含完整 traceback
"""

from __future__ import annotations

from fastapi import APIRouter, Query

from ..services.log_buffer import get_log_buffer

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


@router.get("", summary="查询日志（按级别过滤）")
def get_logs(
    level: str = Query("info", pattern="^(debug|info|warning|error)$",
                       description="最小级别：debug=详细, info=简略, error=仅错误"),
    tail: int = Query(200, ge=1, le=2000, description="最多返回条数"),
) -> dict:
    records = get_log_buffer().get_records(level=level, tail=tail)
    return {"level": level, "tail": tail, "count": len(records), "logs": records}


@router.delete("", summary="清空日志缓冲")
def clear_logs() -> dict:
    get_log_buffer().clear()
    return {"status": "cleared"}