추론하지 말고 말해 — 어휘를 공유 안 하는 범주

# The deterministic half of muting: the reader's own list, typed in
# Settings. Learned weights catch a story that keeps coming back; a
# whole CATEGORY shares little exact vocabulary between a cricket
# report and a transfer rumour, so inference alone will always leak.
MUTED_TERMS_KEY = "muted_terms"


def apply_mutes(con, rows, profile=None) -> tuple[list[dict], int]:
    """Drop what the reader has told us they don't want.

    Returns (kept, muted_count) -- the count is returned, never
    swallowed: a shelf that quietly shrinks is a black box.
    """
    if not rows:
        return rows, 0

    declared = set(get_setting(con, MUTED_TERMS_KEY, []))   # said out loud
    profile = mute_profile(con) if profile is None else profile
    common = _common_tokens(rows)                           # DF guard

    kept = []
    for row in rows:
        toks = tokens(row)
        if declared & toks:
            continue                       # exact, instant, inspectable
        if mute_score(row, profile, skip=common) <= MUTE_THRESHOLD:
            continue                       # learned, for what wasn't named
        kept.append(row)
    return kept, len(rows) - len(kept)


# The boundary: discovery surfaces are filtered, kept ones never are.
# A saved article vanishing because a muted term appears in it would
# make the save button untrustworthy -- a far worse outcome than a
# stray headline.
MUTABLE_SHELF_KINDS = {"topic", "foryou"}      # not saved, not queued