diff --git a/custom_components/nvidia_shield/ha_adb_common/installed_apps.py b/custom_components/nvidia_shield/ha_adb_common/installed_apps.py
index 44ce0f5..182a993 100644
--- a/custom_components/nvidia_shield/ha_adb_common/installed_apps.py
+++ b/custom_components/nvidia_shield/ha_adb_common/installed_apps.py
@@ -5,6 +5,13 @@ fallback list: only four packages were ever offered, so a user with Wholphin,
 SmartTube, Kodi, Plex or anything else saw nothing. The device knows its own
 apps, so this module asks it.
 
+MARK — documented, not observed: the command SHAPES below are Android's own
+documentation, not a captured run. No real Shield was available when this was
+written (t57), so every fixture in ``tests/test_installed_apps.py`` is built from
+those documented shapes, and the parsers are deliberately tolerant of whitespace
+and ordering. This is the same "inferred, not observed" mark the ``state=6``
+buffering value carries in ``media_player.py``.
+
 The commands (both plain `pm`, available on Shield Experience 9 / Android 11
 with no extra permission beyond the ADB pairing this integration already has):