"""Quota guard skeleton backed by control-plane limits."""

from __future__ import annotations

from typing import Any


class QuotaGuard:
    """Read effective limits and block over-quota activity later."""

    def describe_limits(self, *, tenant: dict[str, Any] | None, app_id: str | None) -> dict[str, Any]:
        return {
            "tenant_id": (tenant or {}).get("tenant_id"),
            "app_id": app_id,
            "status": "unknown",
        }

    def check(self, *, tenant: dict[str, Any] | None, app_id: str | None) -> None:
        """Placeholder for quota enforcement.

        The initial platform layer only exposes the hook. Concrete business
        logic can be introduced later once control-plane policies are defined.
        """
        return None