"""Vulture whitelist — items listed here are ignored during dead-code scanning.

Each entry tells vulture that the name is used even though it cannot
detect a reference.  Only add items that are genuine false positives
(signal handlers, event-listener signatures, abstract-method params,
intentional placeholder code, or params with keyword callers).
"""

# Signal handler callback — signature required by signal.signal()
signum  # noqa: F821  (repository.py)

# SQLAlchemy 'connect' event handler — signature required by the event API
connection_record  # noqa: F821  (encrypted_db.py)

# Abstract method parameters — interface contract for subclass implementations
search_data  # noqa: F821  (news/core/storage.py)
news_id  # noqa: F821  (news/core/storage.py)
vote_type  # noqa: F821  (news/core/storage.py)

# Parameters that are unused but have keyword-argument callers (cannot rename)
bypass_cache  # noqa: F821  (manager.py — callers pass bypass_cache=True)
allow_absolute  # noqa: F821  (path_validator.py — callers pass allow_absolute=False)

# Stub method parameters — will be used when implementation is completed
score_threshold  # noqa: F821  (library_rag_service.py — search_library() stub)

# Pickle protocol signature — canonical name for Unpickler.persistent_load; the
# body refuses the load regardless of value, so the arg is intentionally unused
pid  # noqa: F821  (research_library/services/faiss_safe_load.py)
