updates

2026-10-19 20:03:46 -04:00
parent 17633d5909
commit d7f0584e17
8 changed files with 516 additions and 17 deletions
@@ -0,0 +1,87 @@
+blueprint:
+  name: NestQuest day complete celebration
+  description: 'Celebrates the moment a child clears every quest for the day: the
+    automation is driven by the nestquest_child_day_complete event, which NestQuest
+    only fires when quests were owed and all of them are complete — a zero-quest day
+    can never trigger this celebration. Once-per-child-per-day dedupe: point last_celebrated_helper
+    at ONE input_text helper (create it under Settings, Devices and Services, Helpers
+    — plain text). The automation records each celebrated child as "<child_id>:<today>"
+    inside that helper, and a child who un-completes a quest and completes it again
+    the same day is celebrated once, not twice — while a SECOND child clearing their
+    day the same date is still celebrated in full. The helper is pruned to today''s
+    entries on every celebration, so it never grows past one entry per child per day.
+    A helper that does not exist yet, or has never been set, lets the first celebration
+    through. The notification message may use the event payload''s child_name, quests_due
+    and quests_completed. The notify service is chosen by the household when importing
+    this blueprint — NestQuest never hard-codes a personal notify target.'
+  domain: automation
+  input:
+    notify_target:
+      name: Notify service
+      description: The Home Assistant notify service to call for the celebration,
+        for example notify.mobile_app_your_phone — a placeholder; pick the notify
+        service for your own device.
+      selector:
+        text:
+          multiline: false
+          multiple: false
+    celebration_message:
+      name: Celebration message
+      description: 'The message sent when a child clears every quest today. May use
+        the event payload: trigger.event.data.child_name, trigger.event.data.quests_due
+        and trigger.event.data.quests_completed.'
+      default: Legendary! {{ trigger.event.data.child_name }} cleared every quest
+        today!
+      selector:
+        text:
+          multiline: false
+          multiple: false
+    celebrate:
+      name: Send the celebration
+      description: Turn off to keep the automation installed but skip the notification
+        entirely.
+      default: true
+      selector:
+        boolean: {}
+    last_celebrated_helper:
+      name: Last-celebrated helper
+      description: A single input_text helper remembering which children were already
+        celebrated today, as "<child_id>:<date>" entries separated by commas. The
+        automation skips a child whose entry for today is already stored, and rewrites
+        the helper with only today's entries plus the new one after each celebration.
+      selector:
+        entity:
+          filter:
+          - domain:
+            - input_text
+          multiple: false
+          reorder: false
+  source_url: https://github.com/Maniacs-Mansion/NestQuest/blob/main/custom_components/nestquest/blueprints/automation/day_complete_celebration.yaml
+mode: queued
+variables:
+  celebrate: !input celebrate
+  last_celebrated_helper: !input last_celebrated_helper
+triggers:
+- trigger: event
+  event_type: nestquest_child_day_complete
+conditions:
+- condition: template
+  value_template: '{{ celebrate | bool }}'
+- condition: template
+  value_template: "{{ (trigger.event.data.child_id ~ ':' ~ now().strftime('%Y-%m-%d'))\n
+    \  not in ((states(last_celebrated_helper) or '')\n            .split(',')\n            |
+    select('ne', '')\n            | list) }}"
+actions:
+- action: !input notify_target
+  data:
+    title: NestQuest day complete
+    message: !input celebration_message
+- action: input_text.set_value
+  target:
+    entity_id: !input last_celebrated_helper
+  data:
+    value: "{%- set today = now().strftime('%Y-%m-%d') -%} {%- set ns = namespace(entries=[])
+      -%} {%- for entry in (states(last_celebrated_helper) or '').split(',') -%}\n
+      \ {%- if entry and entry.endswith(':' ~ today) -%}\n    {%- set ns.entries =
+      ns.entries + [entry] -%}\n  {%- endif -%}\n{%- endfor -%} {{ (ns.entries + [trigger.event.data.child_id
+      ~ ':' ~ today]) | join(',') }}"