Enhance YAML configuration files with improved documentation and new features

- Updated home_stats.yaml with detailed descriptions for home status automation.
- Expanded vacuum.yaml to include new input helpers and automation scripts for managing vacuum cleaning schedules and states.
- Refined speech_engine.yaml to clarify usage and functionality for sending notifications.
- Modified briefing.yaml to include a new macro for reporting cleaned rooms by the vacuum.

These changes aim to improve clarity, usability, and functionality across the automation scripts and configurations.

config/automation/Speech/home_stats.yaml

@@ -1,5 +1,12 @@
 ######################################################################
-##  Some home facts when we get back home from being away.
+# @CCOSTAN - Follow Me on X
+# For more info visit https://www.vcloudinfo.com/click-here
+# Original Repo : https://github.com/CCOSTAN/Home-AssistantConfig
+# -------------------------------------------------------------------
+# Home Stats Automation - arrival briefing with weather and safety checks
+#  Announces key home status after family returns or on manual trigger.
+# -------------------------------------------------------------------
+# Notes: Waits for garage doors to close before speaking.
 ######################################################################
 - alias: 'Home Stats'
   id: f98e1ef4-051b-4214-908d-d8b35f076a3e
@@ -30,4 +37,3 @@
         call_outside_weather: 1
         call_garage_check: 1
         call_window_check: 1
-        call_light_check: 1