Files
hermes-agent/tests/plugins/platforms/matrix/test_dm_classification_doc.py
chelsealong f45ed8e4ec docs(matrix): document the <=2-member DM auto-classification and its config bypass
_resolve_room_identity() classifies any room with <=2 joined members as a DM
regardless of m.direct or an explicit room name, so those rooms silently
bypass MATRIX_ALLOWED_ROOMS, MATRIX_FREE_RESPONSE_ROOMS, and
MATRIX_REQUIRE_MENTION, and use DM threading instead of
MATRIX_AUTO_THREAD/MATRIX_SESSION_SCOPE. This was previously only visible in
an inline code comment, not in the env-var docs an operator would read.

Fixes #114733
2026-09-20 10:42:25 -07:00

17 lines
809 B
Python

"""The module docstring documents env vars near MATRIX_ALLOWED_ROOMS/MATRIX_REQUIRE_MENTION/
MATRIX_AUTO_THREAD as if they applied uniformly to rooms, but _resolve_room_identity classifies
any room with <=2 joined members as a DM regardless of m.direct or an explicit room name, which
silently bypasses those settings (#114733). Assert the docstring actually says so."""
from plugins.platforms.matrix import adapter
def test_module_docstring_covers_member_count_dm_classification():
doc = adapter.__doc__
assert "<=2 joined members" in doc
assert "MATRIX_ALLOWED_ROOMS" in doc.split("Note:", 1)[1]
assert "MATRIX_FREE_RESPONSE_ROOMS" in doc.split("Note:", 1)[1]
assert "MATRIX_REQUIRE_MENTION" in doc.split("Note:", 1)[1]
assert "MATRIX_DM_AUTO_THREAD" in doc.split("Note:", 1)[1]