mirror of
https://github.com/CCOSTAN/Home-AssistantConfig.git
synced 2026-04-25 17:53:00 +00:00
ae2850fe54
- Added a mandatory resolution policy to the YAML verifier documentation, emphasizing the need for immediate resolution of findings. - Introduced a new `CENTRAL_SCRIPT` finding type to identify scripts defined in `config/packages` but called from multiple YAML files. - Updated the verifier script to collect and report on central script usage, including recommendations for moving definitions to appropriate locations. - Refactored various automations to utilize the new `script.joanna_dispatch` for improved context handling and remediation requests. - Enhanced existing automations with additional conditions and variables for better control and monitoring of actions. - Updated README files to reflect new features and improvements across packages.
71 lines
5.2 KiB
Markdown
Executable File
71 lines
5.2 KiB
Markdown
Executable File
<h1 align="center">
|
||
<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>
|
||
<br>
|
||
Bear Stone Smart Home Documentation
|
||
</h1>
|
||
<h4 align="center">Be sure to :star: my configuration repo so you can keep up to date on any daily progress!</h4>
|
||
|
||
<div align="center">
|
||
|
||
[](https://x.com/ccostan)
|
||
[](https://www.youtube.com/vCloudInfo?sub_confirmation=1)
|
||
[](https://github.com/CCOSTAN) <br>
|
||
[](https://github.com/CCOSTAN/Home-AssistantConfig/blob/master/config/.HA_VERSION)
|
||
[](https://github.com/CCOSTAN/Home-AssistantConfig/commits/master)
|
||
[](https://github.com/CCOSTAN/Home-AssistantConfig/commits/master)
|
||
|
||
</div>
|
||
|
||
Reusable scripts that other automations call for notifications, lighting, and safety responses. Pass variables in; let the script do the heavy lifting.
|
||
|
||
### Quick navigation
|
||
- You are here: `config/script/` (scripts library)
|
||
- [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. |
|
||
| [send_to_logbook.yaml](send_to_logbook.yaml) | Generic `logbook.log` helper for Activity feed entries (Issue #1550). |
|
||
| [joanna_dispatch.yaml](joanna_dispatch.yaml) | Shared BearClaw/Joanna dispatch schema for automation remediation requests. |
|
||
| [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. |
|
||
| [interior_off.yaml](interior_off.yaml) | One-call <20>all interior lights off<66> helper. |
|
||
|
||
### Joanna + BearClaw automated resolution flow
|
||
`script.joanna_dispatch` is the shared handoff contract from Home Assistant automations to BearClaw/Joanna.
|
||
|
||
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.
|
||
- Makes resolution-trigger automations easier to review, update, and audit.
|
||
|
||
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) |
|
||
| `unifi_ap_no_clients_repair_combined` | Unifi AP Create Repair Issue after 5m of 0 Clients | [../packages/wireless.yaml](../packages/wireless.yaml) |
|
||
|
||
### Tips
|
||
- Keep scripts generic<69>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.**
|
||
|
||
<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>
|
||
|
||
**Still have questions on my Config?** <br>
|
||
**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>
|