various tidyups

packages/auto_lights_underhouse_entrance.yaml

@@ -1,23 +1,24 @@
-################################################################################
-# PACKAGE: Underhouse Entrance Auto Lights
-################################################################################
+#:########################################################################################:#
+# Package: Underhouse Entrance Auto Lights
+# File:    auto_lights_underhouse_entrance.yaml
+# Version: v1.2.0
+# Date:    2026-05-12
 #
-# Version:
-#   1.2 - 2026-05-12
-#     - Added fast Zigbee2MQTT FP1-style event triggers:
-#         sensor.underhouse_mmwave_sensor_x23ms_presence_event = enter
-#         sensor.underhouse_mmwave_sensor_x23ms_presence_event = approach
-#     - Keeps binary presence as a backup trigger and as the clear/off condition.
-#     - This should behave closer to the previous Node-RED automation.
+# Purpose:
+#   Replaces the Node-RED automation for the underhouse entrance lights. Uses
+#   Zigbee2MQTT mmWave event triggers (enter/approach/presence) to turn lights
+#   on instantly, then off after 400 seconds of sustained clear presence.
 #
-# Notes:
-#   - The UI may show the binary sensor as "Detected", but the YAML state is
-#     normally "on".
-#   - The presence_event sensor can react earlier than the binary presence sensor.
-#   - The event sensor is used to turn lights on quickly, but not to decide when
-#     the area is clear, because it may remain on its last event value.
+# Behaviour:
+#   - Fast Zigbee2MQTT FP1-style event triggers (enter, approach) turn lights on.
+#   - Binary presence sensor serves as a backup trigger and clearance condition.
+#   - Lights turn off 400 seconds after presence clears.
 #
-################################################################################
+# Version History:
+#   - v1.2.0 (2026-05-12): Added fast Zigbee2MQTT FP1-style event triggers and
+#     converted header to standard package format.
+#
+#:########################################################################################:#
 
 automation:
   - id: underhouse_entrance_auto_lights