# Copyright (c) 2026 Krzysztof Rudnicki. MIT licence. """Who is in a group, according to the last listing that actually arrived. The nightly report shows a 0 next to people who said nothing, and the event log cannot supply them: somebody who has never written has no events. Only the group listing knows, and it is fetched, not stored -- so this is a cache of a live answer, deliberately held in memory. A roster persisted to the database would outlive the truth, and the failure mode of a stale roster is naming somebody who left. Kept out of ``discovery`` because that module was two lines under the 250-line cap, and because "who may the bot watch" and "who is in the room" are separate questions that happen to be answered by the same HTTP response. """ from __future__ import annotations from collections.abc import Callable from typing import Any from signal_bot.trust import identities Permitted = Callable[[dict[str, Any]], "str | None"] class RosterCache: """Each watched group's membership, from the last good listing.""" def __init__(self, own_number: str) -> None: """Wire the cache to the bot's own number, which it excludes. Args: own_number: The account's +E.164 number. The bot is a member of every group it watches, and counting itself as a silent participant would put the bot in its own report. """ self._own = own_number self._members: dict[str, frozenset[str]] = {} def remember(self, entries: list[dict[str, Any]], permitted: Permitted) -> None: """Stash the membership of every permitted group in a listing. Pending invitees are excluded: they cannot have written anything, so listing them as silent members would be wrong rather than merely noisy. """ for entry in entries: group_id = permitted(entry) if group_id is None: continue members = identities(entry, "members") - identities(entry, "pending_invites") self._members[group_id] = frozenset(members - {self._own}) def identities(self, group_id: str) -> frozenset[str]: """One group's members, or empty for a group no listing has covered. A mix of ACI uuids and +E.164 numbers -- the listing uses whichever spelling it has for a given person, which is why the event store matches on both. """ return self._members.get(group_id, frozenset())