"""Sense 路由（T-G0 骨架：健康检查；/v1/route 与 /v1/embeddings 在 T-G1/G5 落地）。"""
from __future__ import annotations

from fastapi import APIRouter

from gateway.sense.config import SenseConfig


def build_sense_router(cfg: SenseConfig) -> APIRouter:
    """组装 sense 面路由（唯一组装点）。"""
    router = APIRouter(prefix="/sense")

    @router.get("/health", tags=["sense"])
    async def health():
        """sense 面健康检查（含灰度状态，供看板/运维）。"""
        return {"enabled": cfg.enabled, "mode": cfg.mode,
                "embedder": cfg.embedder.base_url}

    # /v1/route（T-G5 grader）、/v1/embeddings（T-G1）、/sense/admin/*（T-G3+）后续追加。
    # 注意 /v1/route 不带 /sense 前缀——由 api.py 单独 include 一个无前缀子路由（T-G5）。
    return router