Bear Stone Smart Home Documentation

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

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

• You are here: config/script/ (scripts library)
• Repo overview | Config index | Automations | Scenes |

Featured files to browse

File	Why it matters
	Single entrypoint for rich push notifications.
	Shared helper for tagged live activity/live update pushes and clear commands.
	Generic logbook.log helper for Activity feed entries (Issue #1550).
	Shared AGENT engineer dispatch contract that routes HA-detected issues into Joanna/BearClaw remediation.
	TTS/announcement orchestration with templated speech; speech processing can bypass LLM rewriting for exact messages and also routes garage/office Echo announcements.
	Seasonal lighting dispatcher that follows sensor.holiday_lighting_scene.
	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
onenote_indexer_daily_delete_maintenance	OneNote Indexer - Daily Delete Maintenance Request
onenote_indexer_failure_open_repair	OneNote Indexer - Open Repair On Failure
infra_backup_nightly_verification	Infrastructure - Backup Nightly Verification
infra_monthly_log_hygiene_review	Infrastructure - Monthly HA Log Hygiene Review
infra_nebula_sync_health_dispatch	Infrastructure - Nebula Sync Health Dispatch
infra_pihole_iot_dns_drift_dispatch	Infrastructure - Pi-hole IoT DNS Drift Dispatch
infra_website_down_repair_and_dispatch	Infrastructure - Website Down Repair And Dispatch
docker_state_sync_repairs_dynamic	Docker State Sync - Repairs (Dynamic)
docker_group_reconcile_weekly_joanna_review	Docker Group Reconcile - Weekly Joanna Review
docker_host_disk_pressure_monitor	Docker Host Disk Pressure Monitor
proxmox_updates_joanna_dispatch	Proxmox Updates Joanna Dispatch
tugtainer_dispatch_joanna_for_available_updates	Tugtainer - Dispatch Joanna For Available Updates
tugtainer_dispatch_joanna_for_home_assistant_core_digest	Tugtainer - Dispatch Joanna For Home Assistant Core Digest
unifi_ap_no_clients_repair_combined	Unifi AP Create Repair Issue after 5m of 0 Clients
proxmox_runtime_repairs	Proxmox Runtime Repair Issues
proxmox_disk_pressure_repairs	Proxmox Disk Pressure Repair Issues
synology_dsm_open_repair_and_dispatch	Synology DSM - Open Repair And Dispatch
processmonitor_disk_use_joanna_review	Self Heal Disk Use Joanna Review
1ce3cb43-0e27-4c53-acdd-d672396f3559	Disk Use Alarm

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 :

You can buy me a coffee

Affiliate Disclosure