2018-02-28 23:31:46 -05:00
<h1 align="center">
2024-11-11 05:08:41 +00:00
<a name="logo" href="https://www.vCloudInfo.com/tag/iot"><img src="https://raw.githubusercontent.com/CCOSTAN/Home-AssistantConfig/master/x_profile.png" alt="Bear Stone Smart Home" width="200"></a>
2018-02-28 23:31:46 -05:00
<br>
2019-04-03 13:06:56 -04:00
Bear Stone Smart Home Documentation
2018-02-28 23:31:46 -05:00
</h1>
2019-04-03 13:06:56 -04:00
<h4 align="center">Be sure to :star: my configuration repo so you can keep up to date on any daily progress!</h4>
2025-11-23 16:46:06 -05:00
2018-02-28 23:31:46 -05:00
<div align="center">
2022-12-22 10:10:02 -05:00
2025-01-24 18:02:23 +00:00
[](https://x.com/ccostan)
2022-12-22 10:10:02 -05:00
[](https://www.youtube.com/vCloudInfo?sub_confirmation=1)
2025-11-23 16:46:06 -05:00
[](https://github.com/CCOSTAN) <br>
2024-12-24 16:58:25 +00:00
[](https://github.com/CCOSTAN/Home-AssistantConfig/blob/master/config/.HA_VERSION)
2025-11-23 16:46:06 -05:00
[](https://github.com/CCOSTAN/Home-AssistantConfig/commits/master)
[](https://github.com/CCOSTAN/Home-AssistantConfig/commits/master)
2022-12-22 10:10:02 -05:00
2018-02-28 23:31:46 -05:00
</div>
2018-12-01 19:26:51 -05:00
2026-04-22 13:54:05 -04:00
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.
2025-11-23 16:46:06 -05:00
### Quick navigation
2025-11-27 13:45:16 -05:00
- You are here: `config/script/` (scripts library)
2025-11-23 16:46:06 -05:00
- [Repo overview ](../../README.md ) | [Config index ](../README.md ) | [Automations ](../automation ) | [Scenes ](../scene ) | [Blog: Speech engine video ](https://www.vcloudinfo.com/2018/12/breaking-down-my-home-assistant-volume.html )

### Featured files to browse
| File | Why it matters |
| --- | --- |
| [notify_engine.yaml ](notify_engine.yaml ) | Single entrypoint for rich push notifications. |
2026-03-24 13:03:51 -04:00
| [notify_live_activity.yaml ](notify_live_activity.yaml ) | Shared helper for tagged live activity/live update pushes and clear commands. |
2025-12-12 16:38:24 -05:00
| [send_to_logbook.yaml ](send_to_logbook.yaml ) | Generic `logbook.log` helper for Activity feed entries (Issue #1550 ). |
2026-04-22 13:54:05 -04:00
| [joanna_dispatch.yaml ](joanna_dispatch.yaml ) | Shared AGENT engineer dispatch contract that routes HA-detected issues into Joanna/BearClaw remediation. |
2025-11-23 16:46:06 -05:00
| [speech_engine.yaml ](speech_engine.yaml ) | TTS/announcement orchestration with templated speech. |
| [monthly_color_scene.yaml ](monthly_color_scene.yaml ) | Seasonal lighting scenes used across automations. |
2026-04-22 13:54:05 -04:00
| [interior_off.yaml ](interior_off.yaml ) | One-call "all interior lights off" helper. |
2025-11-23 16:46:06 -05:00
2026-04-22 13:54:05 -04:00
### 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.
2026-03-04 16:16:40 -05:00
Why we use it:
- Keeps one message schema for remediation context (`trigger_context` , `source` , `summary` , `entity_ids` , `diagnostics` , `request` ).
- Avoids repeating direct `rest_command.bearclaw_command` payload formatting in multiple packages.
2026-04-22 13:54:05 -04:00
- Lets Home Assistant stay focused on detection, timing, and routing while Joanna acts as the AGENT engineer for infrastructure triage and recommended remediation.
2026-03-04 16:16:40 -05:00
- Makes resolution-trigger automations easier to review, update, and audit.
2026-04-22 13:54:05 -04:00
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.
2026-03-04 16:16:40 -05:00
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 | [../packages/mqtt_status.yaml ](../packages/mqtt_status.yaml ) |
| `onenote_indexer_daily_delete_maintenance` | OneNote Indexer - Daily Delete Maintenance Request | [../packages/onenote_indexer.yaml ](../packages/onenote_indexer.yaml ) |
| `onenote_indexer_failure_open_repair` | OneNote Indexer - Open Repair On Failure | [../packages/onenote_indexer.yaml ](../packages/onenote_indexer.yaml ) |
2026-04-22 17:38:08 -04:00
| `infra_backup_nightly_verification` | Infrastructure - Backup Nightly Verification | [../packages/infrastructure.yaml ](../packages/infrastructure.yaml ) |
| `infra_monthly_log_hygiene_review` | Infrastructure - Monthly HA Log Hygiene Review | [../packages/infrastructure.yaml ](../packages/infrastructure.yaml ) |
2026-03-18 10:47:14 -04:00
| `docker_state_sync_repairs_dynamic` | Docker State Sync - Repairs (Dynamic) | [../packages/docker_infrastructure.yaml ](../packages/docker_infrastructure.yaml ) |
2026-04-22 13:54:05 -04:00
| `docker_group_reconcile_weekly_joanna_review` | Docker Group Reconcile - Weekly Joanna Review | [../packages/docker_infrastructure.yaml ](../packages/docker_infrastructure.yaml ) |
2026-04-24 15:52:52 -04:00
| `docker_host_disk_pressure_monitor` | Docker Host Disk Pressure Monitor | [../packages/infrastructure.yaml ](../packages/infrastructure.yaml ) |
2026-04-22 15:33:34 -04:00
| `tugtainer_dispatch_joanna_for_available_updates` | Tugtainer - Dispatch Joanna For Available Updates | [../packages/tugtainer_updates.yaml ](../packages/tugtainer_updates.yaml ) |
| `tugtainer_dispatch_joanna_for_home_assistant_core_digest` | Tugtainer - Dispatch Joanna For Home Assistant Core Digest | [../packages/tugtainer_updates.yaml ](../packages/tugtainer_updates.yaml ) |
2026-03-04 16:16:40 -05:00
| `unifi_ap_no_clients_repair_combined` | Unifi AP Create Repair Issue after 5m of 0 Clients | [../packages/wireless.yaml ](../packages/wireless.yaml ) |
2026-04-22 15:33:34 -04:00
| `proxmox_runtime_repairs` | Proxmox Runtime Repair Issues | [../packages/proxmox.yaml ](../packages/proxmox.yaml ) |
| `proxmox_disk_pressure_repairs` | Proxmox Disk Pressure Repair Issues | [../packages/proxmox.yaml ](../packages/proxmox.yaml ) |
2026-04-22 13:54:05 -04:00
| `synology_dsm_open_repair_and_dispatch` | Synology DSM - Open Repair And Dispatch | [../packages/synology_dsm.yaml ](../packages/synology_dsm.yaml ) |
2026-04-22 15:33:34 -04:00
| `processmonitor_disk_use_joanna_review` | Self Heal Disk Use Joanna Review | [../packages/processmonitor.yaml ](../packages/processmonitor.yaml ) |
2026-04-22 13:54:05 -04:00
| `1ce3cb43-0e27-4c53-acdd-d672396f3559` | Disk Use Alarm | [../packages/processmonitor.yaml ](../packages/processmonitor.yaml ) |
2026-03-04 16:16:40 -05:00
2025-11-23 16:46:06 -05:00
### Tips
2026-04-22 13:54:05 -04:00
- Keep scripts generic, route data via `data:` /`variables:` , and reuse everywhere.
2025-11-23 16:46:06 -05:00
- 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.**
2018-12-01 19:26:51 -05:00
2018-03-17 00:56:57 -04:00
<a name="bottom" href="https://github.com/CCOSTAN/Home-AssistantConfig#logo "><img align="right" border="0" src="https://raw.githubusercontent.com/CCOSTAN/Home-AssistantConfig/master/config/www/custom_ui/floorplan/images/branding/up_arrow.png" width="25" ></a>
2018-01-01 19:00:45 -05:00
2019-08-26 11:08:54 -04:00
**Still have questions on my Config?** <br>
2025-11-23 16:46:06 -05:00
**Message me on X :** [](https://www.x.com/ccostan)
<p align="center">
<a target="_blank" href="https://www.buymeacoffee.com/vCloudInfo"><img src="https://www.buymeacoffee.com/assets/img/BMC-btn-logo.svg" alt="Buy me a coffee"><span style="margin-left:5px">You can buy me a coffee</span></a><a target="_blank" href="https://www.buymeacoffee.com/vCloudInfo"><img src="https://www.buymeacoffee.com/assets/img/BMC-btn-logo.svg" alt="Buy me a coffee"></a>
<br>
<a href="https://eepurl.com/dmXFYz"><img align="center" border="0" src="https://raw.githubusercontent.com/CCOSTAN/Home-AssistantConfig/master/config/www/custom_ui/floorplan/images/branding/email_link.png" height="50" ></a><br>
<a href="https://www.vCloudInfo.com/p/affiliate-disclosure.html">
Affiliate Disclosure
</a></p>