"""供 mypy 检查：显式类型收窄与可替换接口。"""
from typing import Protocol


class Reader(Protocol):
    def read(self) -> str: ...


def parse_limit(raw: object) -> int:
    if not isinstance(raw, str):
        raise ValueError("limit must be text")
    if len(raw) > 3 or not raw.isascii() or not raw.isdecimal():
        raise ValueError("invalid ASCII digits")
    value = int(raw)
    if not 1 <= value <= 100:
        raise ValueError("limit out of range")
    return value


def first_level(reader: Reader) -> str:
    return reader.read().split(" ", 1)[0]


class MemoryReader:
    def read(self) -> str:
        return "INFO boot"


assert first_level(MemoryReader()) == "INFO"
assert parse_limit("007") == 7
