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/script/speech_engine.yaml

@@ -1,20 +1,23 @@
-######################################################################################################
-###Script to send notifications to the ChromeCast Audios during normal hours and only when we are home! (Current target: living room Chromecasts only; use Alexa notify/announce services for other rooms.) Call like this:
-  # action:
-    # service: script.speech_engine
-    # data:
-    #   value1:
-    #   call_no_announcement:
-    #   call_dark_outside:
-    #   call_window_check:
-    #   call_garage_check:
-    #   call_garbage_day
-    #   call_light_check
-    #   call_inside_weather
-    #   call_outside_weather
-# Follow me on https://www.vcloudinfo.com/click-here
+######################################################################
+# @CCOSTAN - Follow Me on X
+# For more info visit https://www.vcloudinfo.com/click-here
 # Original Repo : https://github.com/CCOSTAN/Home-AssistantConfig
-######################################################################################################
+# -------------------------------------------------------------------
+# Speech Engine Script - queued announcements to Chromecast targets
+#  Sends templated speech briefings to media players when family/guests are home.
+# -------------------------------------------------------------------
+# Notes: Optional call_* flags control sections (dark_outside, window/garage checks, garbage day, inside/outside weather). Defaults to living room Chromecast if no media_player is provided.
+######################################################################
+# Usage example:
+#   service: script.speech_engine
+#   data:
+#     call_no_announcement: 1
+#     call_dark_outside: 1
+#     call_window_check: 1
+#     call_garage_check: 1
+#     call_garbage_day: 1
+#     call_inside_weather: 1
+#     call_outside_weather: 1
 
 # Define the "speech_engine" script
 speech_engine: