Skip to content

README.md

Latest commit

 

History

History
executable file
·
95 lines (79 loc) · 11.9 KB

README.md

File metadata and controls

executable file
·
95 lines (79 loc) · 11.9 KB
Raw

Bear Stone Smart Home
Bear Stone Smart Home Documentation

Be sure to ⭐ my configuration repo so you can keep up to date on any daily progress!

X Follow YouTube Subscribe GitHub Stars
HA Version Badge Last Commit Commit Activity

Reusable scripts that other automations call for notifications, lighting, safety responses, and Joanna/BearClaw AGENT engineer handoffs. Pass variables in; let the script do the heavy lifting.

Quick navigation

Home Assistant header

Featured files to browse

File Why it matters
YAML source: notify_engine Single entrypoint for rich push notifications.
YAML source: notify_live_activity Shared helper for tagged live activity/live update pushes and clear commands.
YAML source: send_to_logbook Generic logbook.log helper for Activity feed entries (Issue #1550).
YAML source: joanna_dispatch Shared AGENT engineer dispatch contract that routes HA-detected issues into Joanna/BearClaw remediation.
YAML source: speech_engine TTS/announcement orchestration with templated speech; speech processing can bypass LLM rewriting for exact messages and also routes garage/office Echo announcements.
YAML source: monthly_color_scene Seasonal lighting dispatcher that follows sensor.holiday_lighting_scene.
YAML source: interior_off One-call "all interior lights off" helper.

Joanna + BearClaw AGENT engineer handoff

script.joanna_dispatch is the shared handoff contract from Home Assistant automations into Joanna/BearClaw when Home Assistant detects something worth investigating or fixing.

Why we use it:

  • Keeps one message schema for remediation context (trigger_context, source, summary, entity_ids, diagnostics, request, plus optional routing hints).
  • Avoids repeating direct rest_command.bearclaw_command payload formatting in multiple packages.
  • Lets Home Assistant stay focused on detection, timing, and routing while Joanna acts as the AGENT engineer for infrastructure triage and recommended remediation.
  • Makes resolution-trigger automations easier to review, update, and audit.

What the helper normalizes before the BearClaw intake call:

  • trigger_context, source, and summary so every dispatch has traceable origin details.
  • entity_ids from either a YAML list or a comma-delimited string.
  • diagnostics from either free text or structured mappings/sequences.
  • request guardrails so Joanna defaults to investigation/recommendation, not blind resets or power-cycles.
  • domain_hint/lane_hint default to BearClaw ops routing so HA infrastructure text does not drift into another domain parser.

Current automations that kick off automated resolutions (via script.joanna_dispatch):

Automation ID Alias File
mqtt_open_repair_on_failure MQTT - Open Repair On Failure YAML source: mqtt_status
onenote_indexer_daily_delete_maintenance OneNote Indexer - Daily Delete Maintenance Request YAML source: onenote_indexer
onenote_indexer_failure_open_repair OneNote Indexer - Open Repair On Failure YAML source: onenote_indexer
infra_backup_nightly_verification Infrastructure - Backup Nightly Verification YAML source: infrastructure
infra_monthly_log_hygiene_review Infrastructure - Monthly HA Log Hygiene Review YAML source: infrastructure
infra_nebula_sync_health_dispatch Infrastructure - Nebula Sync Health Dispatch YAML source: infrastructure
infra_pihole_iot_dns_drift_dispatch Infrastructure - Pi-hole IoT DNS Drift Dispatch YAML source: infrastructure
infra_website_down_repair_and_dispatch Infrastructure - Website Down Repair And Dispatch YAML source: infrastructure
docker_state_sync_repairs_dynamic Docker State Sync - Repairs (Dynamic) YAML source: docker_infrastructure
docker_group_reconcile_weekly_joanna_review Docker Group Reconcile - Weekly Joanna Review YAML source: docker_infrastructure
docker_host_disk_pressure_monitor Docker Host Disk Pressure Monitor YAML source: infrastructure
proxmox_updates_joanna_dispatch Proxmox Updates Joanna Dispatch YAML source: proxmox
tugtainer_dispatch_joanna_for_available_updates Tugtainer - Dispatch Joanna For Available Updates YAML source: tugtainer_updates
tugtainer_dispatch_joanna_for_home_assistant_core_digest Tugtainer - Dispatch Joanna For Home Assistant Core Digest YAML source: tugtainer_updates
unifi_ap_no_clients_repair_combined Unifi AP Create Repair Issue after 5m of 0 Clients YAML source: wireless
proxmox_runtime_repairs Proxmox Runtime Repair Issues YAML source: proxmox
proxmox_disk_pressure_repairs Proxmox Disk Pressure Repair Issues YAML source: proxmox
synology_dsm_open_repair_and_dispatch Synology DSM - Open Repair And Dispatch YAML source: synology_dsm
processmonitor_disk_use_joanna_review Self Heal Disk Use Joanna Review YAML source: processmonitor
1ce3cb43-0e27-4c53-acdd-d672396f3559 Disk Use Alarm YAML source: processmonitor

Tips

  • Keep scripts generic, route data via data:/variables:, and reuse everywhere.
  • If you copy a script, rename any alias and id fields to avoid duplicates.

All of my configuration files are tested against the most stable version of home-assistant.

Still have questions on my Config?
Message me on X : Follow CCostan

Buy me a coffeeYou can buy me a coffeeBuy me a coffee

Affiliate Disclosure