🚀 Release: v4.0.0

[github-actions[bot]]

🚀 New Release: v4.0.0

View full release and download on GitHub

---

TaskMate v4.0.0 — the big gamification + chores release.

✨ New — Gamification

• Levels & XP with a level badge + XP progress bar on the child card (Levels / XP system #468, Show level + XP progress on the kid-facing child card #470)
• Quests / chore chains — finish each step in order for a bonus (Quests / chore chains #489)
• Daily / weekly challenges (Daily / weekly challenges #495)
• Avatar unlockables — earn avatars by level / points / streak (Avatar unlockables #492)
• Tiered celebrations — bigger moments for bigger achievements (Bigger celebration moments with tiered events #487)
• Surprise / random daily bonus (Surprise / random bonuses #455)

✨ New — Chores

• Difficulty tiers (easy/medium/hard) with a points multiplier (Chore difficulty tiers (easy/medium/hard) with configurable points multiplier #416)
• Photo / evidence proof — require a photo on completion; captured in-card and shown in the approval queue (Photo / evidence proof for chores #480, Require-photo chores: no way to attach evidence; completes without a photo #504/Photo evidence: in-card capture/upload for require_photo chores #507)
• Early-bonus / late-penalty by completion time (Late-penalty / early-bonus triggers #478)
• First-come-first-served assignment mode ([Feature]: Add a "First come, first served" assignment mode for competitive chores #401)
• Complete on behalf of a child, admin-gated ([Feature]: Allow parents to complete chores on behalf of a child from Parent Dashboard and Lovelace cards #402)
• Sibling chore swaps with parent approval (Sibling chore swaps / trades #483)
• Vacation / pause mode — pause chores and freeze streaks (Vacation / pause mode — pause chores & freeze streaks for a date range #419)
• Clone / duplicate a chore (Clone / duplicate a chore #432)
• Optional expiry date (Chore expiry (optional end date for recurring/specific-day chores) #459)
• Bulk operations — delete / enable / disable / reassign (Bulk chore operations (delete / enable-disable / reassign) #462)

✨ New — Points & Rewards

• Inter-child points gifting (parent-controlled) (Inter-child points gifting #466)
• Periodic savings interest (Interest on savings #476)
• Optional points decay (Points expiry / decay #464)
• Undo / retract applied penalties and bonuses (Undo / retract applied penalties & bonuses (v4.0 finish) #430)
• Per-period reward spending cap (Spending caps / budgets #474)
• Reward auto-restock on a daily/weekly/monthly schedule (Reward stock / auto-restock automation #457)

✨ New — Notifications & Admin

• Weekly digest summary for parents (Weekly digest notification for parents #485)
• Test-notification to verify routing (Test-notification service / send-test button #436)
• Streak-milestone notifications (Streak-milestone notifications (v4.0 finish) #427)
• Graceful fallback for non-mobile_app notify backends (Graceful fallback for non-mobile_app notify backends on actionable notifications #421)
• Badge OR-logic combinator + operators beyond >= (Badge OR-logic + operators beyond >= (v4.0 finish) #425)
• Config export / import (backup & restore) (Config export / import (backup & restore) #438)
• Admin audit log — who changed what, and when (Admin audit log — record who changed what (config changes & deletions) #423)
• More fired events: penalty / bonus / reward-approved / reward-rejected / chore-rejected (More taskmate_* automation events (penalty/bonus/reward/reject) #434)

🐛 Fixes & hardening

• Service calls now return clean validation errors instead of 500s + tracebacks (Coordinator ValueErrors surface unhandled (traceback + no clean message) on service calls #501/fix(services): surface coordinator ValueErrors as clean validation errors #502)
• Stale Lovelace resources for removed cards are deregistered — fixes 404s on every dashboard load for upgraders (Stale Lovelace resources for removed cards 404 on every dashboard load (upgraders) #505/fix(frontend): deregister retired card Lovelace resources #506)
• Pending-approval notifications now reach parents, not the completer (Pending-approval notification reaches the completer (instance-wide persistent), not the parent #508/fix(notifications): route pending-approval to parents, not the completer #509)
• Security: linked-child gate, rotation-quota enforcement, CI SHA-pinning (fix(security): linked-child gate, rotation quota enforcement, CI SHA-pinning #415); admin gate on as_parent (complete_chore service: as_parent is UI-gated only, not backend-enforced #410/fix(complete): enforce admin on as_parent in the backend service #411); graceful first-come race-loser handling (first_come race-loser completion returns HTTP 500 instead of a graceful error #405/services.yaml loaded with blocking open() on the event loop #406)
• Retire the deprecated options flow in favour of the admin panel (Retire deprecated options/configure flow in favour of admin panel #412)
• Friendlier child-undo message (fix(child-card): friendly message when a child tries to undo a chore #511)

🌐 i18n

• de / fr / nb / nn / pt / pt-BR updated across the batch, incl. photo-evidence strings (i18n: translate v4.0.0 feature batch into de/fr/nb/nn/pt/pt-BR #499, i18n: translate photo-evidence strings (de, fr, nb, nn, pt, pt-BR) #512, i18n: complete locales for the §2-§4 feature batch #472, Multi-language completeness pass (de/fr/nb/nn/pt/pt-BR) #440)

Upgrading

• HACS → TaskMate → Redownload → 4.0.0. Cards self-register (nothing to wire up).
• Notifications: for approval alerts to reach only a parent, set that parent recipient's channel to a per-person service (e.g. notify.mobile_app_*) — persistent_notification is instance-wide.

---

Upgrading

Update via HACS or by downloading the latest release and copying to /config/custom_components/taskmate/.

After updating, restart Home Assistant. Lovelace resources will update automatically on restart.

---

💬 Questions or issues with this release? Reply below or open an issue.

[cabatech]

Wow ! That's a big one with so many improvments I didn't imagine or "dare to ask"... and you know I asked a lot ! 😉
Congrats for your hard work on that and a huge thank you from my whole family ❤️