Whodunnit 🕵️

Version 1.2

22 February 2026

• Further ESPHome related refinements

• Attributes monitoring is now Domain specific

• Improved Confidence score in certain instances, for example when a Script is called by an Automation

• Removed unused code and objects

• Improved documentation, both this README.md and source code comments

• Breaking change: Replaced the inconsistent "Manual/Physical/Internal" terminology with a single unified value device (displayed as "Device"). The sensor's state previously used manual and the source_type attribute previously used physical - both must now be updated to device in any automations, templates, or dashboard cards that reference them.

• Added:

  • Now watching attributes for additional domains besides light : climate, media_player, fan, cover, water_heater, humidifier, vacuum
  • New Event: whodunnit_trigger_detected. It is fired on the HA event bus after every classification. Solves the repeated-state trigger problem (e.g. same script runs twice, light toggled on then off) where the sensor's native_value doesn't change and a standard state trigger would not fire. Payload carries all classification fields.
  • New attribute: cache_debug. A diagnostic attribute showing the cache entry that matched the last classification (matched_entry), its age at match time, and total cache size. Intended to replace the need for log dumping to diagnose misclassifications

Version 1.1.1

20 February 2026

• Bug fixes:
  • Physical button presses being silently dropped on ESPHome devices within the bleed window
  • Dashboard toggles on ESPHome devices always showing Low confidence
• General ESPHome related improvements to the detection cascade
• Added context_id to the history_log for easier event correlation

Version 1.1

19 February 2026

• Added support for more domains : climate, water_heater, valve, number, select, button, input_button, input_number, input_select, input_text, alarm_control_panel, timer
• Added attribute changes as a trigger source
• Added support for ESPHome devices
• Added support for multiple entities on a single device
• Added service status for API events such as Node-RED
• Added confidence attribute High/Medium/Low
• Added a history log in attributes
• Further refinement to the Context cascade to ensure instantaneous and more accurate identification
• Refactored the code to improve memory usage, speed, and stabilty
• Improved error logging
• Improved comments in the source code
• Rewrite of this README.md

Version 1.0

6 February 2026

• Initial release