From 8bf02a76ff738ebc559edf4740dae82e48de1035 Mon Sep 17 00:00:00 2001
From: Carlo Costanzo <CCOSTAN@users.noreply.github.com>
Date: Tue, 24 Mar 2026 14:51:54 -0400
Subject: [PATCH] Refactor automation configurations and improve documentation

- Updated guest_mode.yaml for clarity on announcements and added issue reference.
- Enhanced night_watchdog.yaml with new conditions for vacation mode and house sitter presence.
- Improved sunset_turn_on.yaml by refining action sequences and adding vacation presence logic.
- Expanded admin_sections.yaml to include new tiles for package detection and related inputs.
- Removed obsolete media player from media_players.yaml and updated switches.yaml with new outdoor seasonal switch IDs.
- Enhanced home_modes.yaml and README.md to clarify home mode toggles and usage.
- Updated docker_infrastructure.yaml for better container outage notifications and maintenance checks.
- Enhanced LLM Vision package to include package detection and related automation triggers.
---
 .../packages/github_watched_repo_scout.yaml   | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 config/packages/github_watched_repo_scout.yaml

diff --git a/config/packages/github_watched_repo_scout.yaml b/config/packages/github_watched_repo_scout.yaml
new file mode 100644
index 00000000..77cb2666
--- /dev/null
+++ b/config/packages/github_watched_repo_scout.yaml
@@ -0,0 +1,45 @@
+######################################################################
+# @CCOSTAN - Follow Me on X
+# For more info visit https://www.vcloudinfo.com/click-here
+# Original Repo : https://github.com/CCOSTAN/Home-AssistantConfig
+# -------------------------------------------------------------------
+# GitHub Watched Repo Scout - Nightly Joanna review of watched repos
+#  Schedules Joanna to review unread watched-repo notifications for HA ideas.
+# -------------------------------------------------------------------
+# Notes: Joanna native GitHub scout logic runs in docker_17/codex_appliance.
+# Notes: Successfully processed watched-repo notifications are marked read by Joanna.
+######################################################################
+
+automation:
+  - id: github_watched_repo_scout_nightly
+    alias: GitHub Watched Repo Scout - Nightly Joanna Review
+    description: Ask Joanna nightly to review unread watched-repo GitHub notifications for Home Assistant ideas.
+    mode: single
+    trigger:
+      - platform: time
+        at: "03:15:00"
+    variables:
+      trigger_context: "HA automation github_watched_repo_scout_nightly (GitHub Watched Repo Scout - Nightly Joanna Review)"
+    action:
+      - service: script.send_to_logbook
+        data:
+          topic: "GITHUB"
+          message: "Requesting Joanna nightly watched-repo scout review."
+      - service: script.joanna_dispatch
+        data:
+          trigger_context: "{{ trigger_context }}"
+          source: "home_assistant_automation.github_watched_repo_scout_nightly"
+          summary: "Nightly GitHub watched-repo scout review for Home Assistant ideas"
+          diagnostics: >-
+            schedule=03:15:00,
+            inbox_scope=unread,
+            repo_scope=watched,
+            create_issues=true,
+            mark_read_on_success=true
+          request: >-
+            Review unread GitHub notifications from watched repositories only.
+            Look for interesting Home Assistant configuration ideas we could apply in
+            our own repo, send a concise nightly recap, create or refresh one
+            GitHub issue per strong candidate in CCOSTAN/Home-AssistantConfig, and
+            mark each watched-repo notification read only after it has been
+            processed successfully. Leave failed items unread for the next run.