core/explain.py

def explain(query: str, excerpt: str) -> str:
    q = query.lower()
    hits = excerpt.lower().count(q)

    return (
        f"This document mentions '{query}' {hits} time(s). "
        "Results are ranked by simple frequency within released text. "
        "This does not imply factual verification."
    )