various tidyups

packages/appliance_status_mqttfeed.yaml

@@ -1,3 +1,29 @@
+#:########################################################################################:#
+# Package: Appliance Activity Feed Sensors
+# File:    appliance_status_mqttfeed.yaml
+# Version: v1.2.0
+# Date:    2026-07-20
+#
+# Purpose:
+#   Provides MQTT sensors for appliance, vehicle-charger, and tool-charger
+#   completion messages published to the household activity feed.
+#
+# Dependencies:
+#   - Home Assistant MQTT integration and broker connectivity.
+#   - External publishers or the announcement router must publish completion
+#     payloads to the configured activity-feed topics.
+#
+# Known Limitation:
+#   - sensor.washer_finished has device_class timestamp and therefore requires
+#     an ISO 8601 timestamp. P013-F018 records that the current router may publish
+#     a time-only payload, which is not valid for this device class.
+#
+# Version History:
+#   - v1.2.0 (2026-07-20): Added the downstairs dishwasher completion sensor.
+#   - v1.1.0 (2025-05-18): Set the washer completion sensor as a timestamp.
+#   - v1.0.0 (2023-10-20): Added the initial MQTT activity-feed sensors.
+#:########################################################################################:#
+
 mqtt:
   sensor:
     - unique_id: washing_machine_finished