various tidyups

packages/health_checks.yaml

@@ -1,3 +1,30 @@
+#:########################################################################################:#
+# Package: Node-RED Health Checks
+# File:    health_checks.yaml
+# Version: v1.2.0
+# Date:    2025-08-25
+#
+# Purpose:
+#   Monitors the Node-RED Panda instance through independent HTTP and MQTT health
+#   signals and combines them into one connectivity status.
+#
+# Behaviour:
+#   - Polls the HTTP health endpoint every 30 seconds with a three-second timeout.
+#   - Tracks the MQTT birth/will topic with QoS 1 and a 180-second expiry.
+#   - Reports the combined check as available when either source is available.
+#   - Reports the combined check as connected when either source is connected.
+#
+# Dependencies:
+#   - Reachability of the configured Node-RED HTTP health endpoint.
+#   - Home Assistant MQTT integration and the Node-RED birth/will publisher.
+#
+# Version History:
+#   - v1.2.0 (2025-08-25): Reduced MQTT expiry to 180 seconds and clarified the
+#     combined HTTP/MQTT sensor name.
+#   - v1.1.0 (2025-08-22): Split HTTP and MQTT probes and added a combined sensor.
+#   - v1.0.0 (2025-08-21): Initial Node-RED health-check package.
+#:########################################################################################:#
+
 # ---- HTTP health probe ----
 binary_sensor:
   - platform: rest