Release Notes

All notable changes to Home Keeper are documented here. The format follows

Keep a Changelog and the project uses semantic versioning, with PEP 440 pre-release suffixes (bN/aN/rcN) for betas.

[0.24.0] - 2026-09-20

Added

• Counted wear items. Set a wear item to repeat every so many uses, or after so many months, whichever comes first. Complete its use task from an automation, a tag scan or the panel to count 1 use. (Fixes #306)
• Wear item actions. Pick the verb a wear item's task uses. The choices are Clean, Service, Renew, Sharpen, Rotate, Inspect and the default Replace.
• Wear item preview. A wear item now says what it will create before you save it. The box names each task, its schedule, and the count a use task feeds.
• Due today. Move a task's due date to today, whatever its schedule says. Home Keeper records no completion, so the recurrence is unchanged. (Fixes #312) (Thanks @joss94!)
• Task count sensors. Home Keeper gives each profile a sensor that counts the tasks it shows, and adds one more for every task it keeps. Put the overdue count on a dashboard badge, with no template. (Fixes #342)

Changed

• Appliance report. The inventory export is now the appliance report, and its button moved to Settings, Import and export, beside the backup it is not a copy of. The home_keeper.export_inventory action is now home_keeper.export_appliance_report and returns its rows under report.
• Meter task validation. A meter task now refuses a hold time and an auto-clear switch. A meter has no condition to hold, so Home Keeper used to drop both without a word.

Fixed

• Fixed schedules. A task on a fixed schedule now moves to its next occurrence when you mark it done. A task due later in the same day used to stay due today. (Fixes #331)
• Daylight saving time. A fixed schedule now keeps its time of day when the clocks change. A task set for 10am used to move to 9am each autumn.
• Snoozed fixed schedules. A task on a fixed schedule now moves to its next occurrence when you snooze it and then mark it done. It used to jump past every occurrence before the snooze date.
• Sensor hold time. A hold now counts only the time an entity reported the trigger condition. An entity that stopped reporting part way through kept its hold running, so the task opened as soon as the entity came back. (Fixes #336)
• Recipe meter progress. A recipe that meters a sensor now keeps the reading it counts from. Home Keeper reset that reading on each change to the entity list, so the task could never reach its target.
• Disabled recipes. A recipe you switch off now keeps its tasks and everything recorded on them. The tasks stop until you switch the recipe on again.
• Edited conditions. A sensor task now opens when you change its condition to one the entity already meets. It used to wait for the condition to go away and come back.
• Recipe updates. Home Keeper now runs one pass for each group of entity changes. An integration that added many entities at once made it repeat the same work for each one.
• Task names in a narrow list. A task name no longer collapses into a column of single letters when the edit drawer is open beside the list.

[0.24.0b8]

Added

• Wear item preview. A wear item now says what it will create before you save it. The box names each task, its schedule, and the count a use task feeds.

Fixed

• Task names in a narrow list. A task name no longer collapses into a column of single letters when the edit drawer is open beside the list.

[0.24.0b7]

Added

• Task count sensors. Home Keeper gives each profile a sensor that counts the tasks it shows, and adds one more for every task it keeps. Put the overdue count on a dashboard badge, with no template. (Fixes #342)

[0.24.0b6]

Changed

• Appliance report. The inventory export is now the appliance report, and its button moved to Settings, Import and export, beside the backup it is not a copy of. The home_keeper.export_inventory action is now home_keeper.export_appliance_report and returns its rows under report.

[0.24.0b5]

Changed

• Meter task validation. A meter task now refuses a hold time and an auto-clear switch. A meter has no condition to hold, so Home Keeper used to drop both without a word.

Fixed

• Sensor hold time. A hold now counts only the time an entity reported the trigger condition. An entity that stopped reporting part way through kept its hold running, so the task opened as soon as the entity came back. (Fixes #336)
• Recipe meter progress. A recipe that meters a sensor now keeps the reading it counts from. Home Keeper reset that reading on each change to the entity list, so the task could never reach its target.
• Disabled recipes. A recipe you switch off now keeps its tasks and everything recorded on them. The tasks stop until you switch the recipe on again.
• Edited conditions. A sensor task now opens when you change its condition to one the entity already meets. It used to wait for the condition to go away and come back.
• Recipe updates. Home Keeper now runs one pass for each group of entity changes. An integration that added many entities at once made it repeat the same work for each one.

[0.24.0b4]

Fixed

• Skipped wear items. Skip now holds on a counted wear item's task. The task used to come back within seconds and send its reminder again.
• Counted wear rows. A use task now shows on the dashboard card when the card groups by status. It also shows when the card looks ahead a set number of days.
• Snoozed fixed schedules. A task on a fixed schedule now moves to its next occurrence when you snooze it and then mark it done. It used to jump past every occurrence before the snooze date.
• Wear item time limits. An appliance now saves after you clear the time limit box on a wear item. The save used to fail and report an error about the whole appliance.
• Counted wear item counts. The panel now reads the same count Home Keeper acts on. A use task page reads Counting in place of a dash.

[0.24.0b3]

Added

• Counted wear items. Set a wear item to repeat every so many uses, or after so many months, whichever comes first. Complete its use task from an automation, a tag scan or the panel to count 1 use. (Fixes #306)
• Wear item actions. Pick the verb a wear item's task uses. The choices are Clean, Service, Renew, Sharpen, Rotate, Inspect and the default Replace.

[0.24.0b2]

Added

• Due today. Move a task's due date to today, whatever its schedule says. Home Keeper records no completion, so the recurrence is unchanged. (Fixes #312) (Thanks @joss94!)

[0.24.0b1]

Fixed

• Fixed schedules. A task on a fixed schedule now moves to its next occurrence when you mark it done. A task due later in the same day used to stay due today. (Fixes #331)
• Daylight saving time. A fixed schedule now keeps its time of day when the clocks change. A task set for 10am used to move to 9am each autumn.

[0.23.0] - 2026-09-11

Added

• Import and export. Settings has a new Import and export card that saves every task and appliance to one YAML file, and reads one back. Move to a new Home Assistant, or bring years of history in from another system. (Fixes #308)
• Published document schema. The import and export format has a JSON Schema on the documentation site. Every export names it, so an editor checks the file and completes the field names as you write.
• External IDs. Give a task or an appliance an external_id of your choice. An import matches on it, so running a migration script twice updates your records instead of copying them.

Fixed

• Notification triggers. A notification now states which tasks its profile selects. The 2 automatic switches are grouped as Triggers, which set the moment a notification is sent rather than its contents. (Fixes #313)
• Fully managed tasks. A task whose companion sets every field no longer shows Edit. The page names the companion instead.

[0.23.0b2]

Fixed

• Fully managed tasks. A task whose companion sets every field no longer shows Edit. The page names the companion instead.

[0.23.0b1]

Added

• Import and export. Settings has a new Import and export card that saves every task and appliance to one YAML file, and reads one back. Move to a new Home Assistant, or bring years of history in from another system. (Fixes #308)
• Published document schema. The import and export format has a JSON Schema on the documentation site. Every export names it, so an editor checks the file and completes the field names as you write.
• A stable key of your own. Give a task or an appliance an external_id of your choice. An import matches on it, so running a migration script twice updates your records instead of copying them.

Fixed

• Notification triggers. A notification now states which tasks its profile selects. The 2 automatic switches are grouped as Triggers, which set the moment a notification is sent rather than its contents. (Fixes #313)

[0.22.0] - 2026-09-08

Added

• Task and appliance search. The task list and the appliance list have a search box. It matches the name plus other details, such as an appliance's model or the companion that supplied a task. (Fixes #297)
• Notification icons and colors. In Settings → Notifications a notification can use any Material Design icon, which Android shows in the status bar. iPhone shows it on the notification, over an accent color you pick. (Fixes #293)
• Usage intervals. A metered task's history shows the usage between completions, and a summary above the list gives the average and the range. The next-due sensor reports the same figures as attributes. (Fixes #305)
• Appliance-first device chips. A task's device chip opens its appliance instead of the Home Assistant device page. The appliance list and an appliance's own page still link straight to the device.
• Aligned list rows. Task rows and appliance rows use fixed columns. A row's chips and its overdue pill begin at the same place down the whole list.
• Profile deletion guard. Home Keeper asks you to confirm before it deletes a profile. A profile that a notification uses cannot be deleted at all.

Fixed

• Phone companion rows. A companion row on a phone puts its buttons on a line of their own. Edit and Delete no longer go past the edge of the screen.

[0.21.0] - 2026-09-06

Added

• Declarative companions. Define a pattern over existing entities to create tasks automatically. Home Keeper previews the matches before it opens them. (Fixes #231)

• Declarative companion presets. Home Keeper includes pre-built companions for common integrations. Each preset also shows how to build one. (Fixes #230)

• Availability sensor tasks. A sensor task can arm when its entity goes unavailable or unknown.

• Snooze and skip. Snooze and Skip sit next to Done in the panel and on the card. A skip records a note and a person in the task history. (Fixes #268)

• Skip and snooze settings. Settings can turn off either option. 3 new services edit a recorded skip.

• Seasonal tasks. A task that repeats on a clock can run only in the months you select. (Fixes #242)

• Inline part editing. Edit and add parts directly in the Parts tab. The stock chip is now a stepper.

Changed

• Test button notifications. Test now always sends a notification. It shows a due task, or says "All caught up".

• Distant task notifications. A task that is not due soon now says how far off it is. The text used to read "Due soon" for every such task.

• Compact lists and task sub-tabs. Task and appliance rows use less space. A task's page splits into 3 sub-tabs.

Fixed

• Stale panel data. The panel kept the old view after Home Keeper reloaded. It now waits and reads again.

• Stock and Reorder-at focus. Typing the first digit into an empty box rebuilt the form and closed the keyboard. (Fixes #296)

[0.21.0b6]

Fixed

• A monitored task no longer offers Done. Pressing Done recorded a completion but did not change the task, because it still waits for its condition. The panel and the card now hide Done while a task is monitored, and a task that counts a meter keeps it. (Fixes #231)

• A task made by a recipe now opens that recipe. The task page read the recipe's name as an integration, so its button opened the wrong page and its caption named a place that does not exist. The page now shows an Edit recipe button, and its caption names the recipe to change.

• A recipe's task no longer shows Edit or Duplicate on its own page. Home Keeper rewrites the task on each run of its recipe, so a saved edit did not survive. The task page now shows only Edit recipe, and its caption names that recipe.

• A task from a recipe that auto-clears no longer offers Done. Home Keeper does not reopen the task while its condition stays true, so pressing Done by hand hid work that was still waiting. Done is now dimmed on the task, and a recipe without auto-clear keeps it.

[0.21.0b5]

Added

• Parts in the appliance edit drawer are now collapsible rows. A collapsed row shows the part's name and a one-line summary. Only 1 part opens at a time, and a new part opens itself.

• The Parts tab now has an Edit icon on each part and an Add part button. Both open the edit drawer with that part expanded and scrolled into view. Add part opens a new, empty row the same way.

• The Parts tab's "In stock" chip is now a stepper. Press − or + to move the stock by 1 spare, or by 1 completion's amount for a part measured in a unit. A typed value saves on Enter or when the box loses focus, and low-stock events and buy tasks still fire the same way.

Changed

• The task list and the appliance list are now more compact. Rows use less padding, and the chips and the Done button are smaller. On a phone, a task row uses 2 columns: task details on the left and Done on the right.

• A task's page now has the sub-tabs Schedule, Notes, and History. The page opens on Schedule, and each sub-tab has its own URL.

Fixed

• A part's Stock and Reorder-at boxes now keep focus while a user types. The first digit in an empty box rebuilt the whole form, so the drawer jumped to the top and the keyboard closed on iOS. The fields that a value reveals now appear in place, and typing never rebuilds the form. (Fixes #296)

[0.21.0b4]

Added

• The panel now supports snooze and skip on a task. The task page and each row of the task list show Snooze and Skip next to Done. Each option shows how it changes the due date. (Fixes #268)

• A dashboard card offers snooze and skip on each row. Both open the same dialogs as the panel. Home Keeper omits an option that does not apply to the task, such as skip on a blocked task.

• Home Keeper records a skip in the task history. Each entry stores a note and a person, and a user can edit or undo it like a completion. A skip is never counted as a completion, so the completion tally and the average interval do not include it.

• A snooze now offers a choice of duration. Select 1 of 4 durations, or set a date and time. The dialog shows the new due date first.

• Settings now has a Skip & snooze section that turns off either one. Both start on. Home Keeper removes the one that is off from the panel, from the card, and from the notification buttons.

• 3 services now edit the recorded skips. update_skip changes an entry, delete_skip removes one, and move_skip changes its date. skip_task accepts a note and a person, and snooze_task accepts until for an exact date and time.

Fixed

• A skip now defers a task that is measured by a meter. Such a task cleared its due date and then became due again at the next reading from the sensor. A skip now advances the meter, so the next due date is a full interval later.

• The skip and snooze events now include origin. The service descriptions stated that these events return origin to the caller, which prevents a loop. Home Keeper did not add it before this release.

[0.21.0b3]

Added

• Declarative companions: task-per-entity recipes without a separate integration. A user configures a recipe in Settings → Companions, or starts from a bundled preset for Device Pulse or firmware updates, and Home Keeper opens one task per matching entity after a live preview of the matches. (Fixes #231) (Fixes #230)

• A sensor task now supports an availability mode. The task arms when the entity reports unavailable or unknown, after an optional hold. A user can also bind one task to one entity by hand in the ordinary task form.

Fixed

• A task with a hold now falls due the moment the hold ends. The hold used to complete at the next reading from the watched entity or at the five-minute refresh. An entity that goes offline sends no more readings, which is the case an availability task waits for.

• The panel no longer shows old information right after some actions. Adding a companion or changing an option can reload Home Keeper for a moment, and a refresh right then kept the old view. The panel now waits for Home Keeper and reads again.

[0.21.0b2]

Added

• The Test button now always sends a notification. The notification shows a task when the Profile holds one, and says "All caught up" when the Profile holds none. A second button beside Test sends whichever notification Test does not.

Changed

• A notification for a task that is not due soon now says how far off it is. The text read "Due soon." for every task ahead of its due date, including one months away.

[0.21.0b1]

Added

• Give a task a season. A task that repeats on a clock can be held to the part of the year it belongs in, so fertilising every two months stops in October and comes back in April rather than falling due in the snow. Add as many windows as the task needs (spring and fall on the same task) from the task form or the home_keeper.add_task action. (Fixes #242)

[0.20.0] - 2026-09-04

Added

• Duplicate a task from its detail page. The create form opens already filled in with a copy, so a row of near-identical tasks costs one edit each. A task another integration owns keeps a greyed Duplicate that explains why, as does a buy task. (Fixes #279)

• Give a notification its own channel and urgency. A Medication notification can then make a sound during Do Not Disturb while a Batteries notification stays silent. Each notification also gets a Test button that sends it to the phone at once. (Fixes #255)

• A Profile can filter tasks by the companion that created them. One card or notification then covers a single source. A task you make yourself is never selected this way.

• The shopping-list line shows the amount to buy. A part measured in a unit reads "Buy fabric softener (500 ml)". The task keeps its own name in the panel and the calendar and the notifications. (Fixes #220)

• A Profile can exclude the shopping tasks. The new Exclude shopping switch removes the auto-created buy tasks from the tasks that a Profile selects. It is off by default, and an existing Profile is not changed.

• The Notifications page shows 3 worked automations. One resends a notification every 2 hours until the task is complete. Another sends a notification only when a person is at home.

Changed

• Each Settings card shows its save status next to its name, in place of a pop-up message. The status reads Saving… and then Saved. A save that fails shows Not saved on the card and also keeps the pop-up, which gives the reason.

Fixed

• Sending a task to a CalDAV to-do list (Nextcloud, Baikal, Radicale) no longer creates a duplicate. The duplicate was permanent: an edit afterward reached only one copy, and a delete left the other behind on the server. The same timing could also complete a recurring task twice and skip its next occurrence.

• A buy task is no longer shown as overdue work. A task with no due date is due immediately, so a buy task was shown in the Overdue section with the overdue maintenance tasks. It now has a Shopping section of its own and reads Low stock on every page.

• The Overdue filter no longer counts the shopping tasks. In the panel and on the dashboard card, Overdue now means late work only. Use the Shopping filter beside it to see the buy tasks, which a Profile still selects as before.

• A copy of a task asks for the same details as the task it came from. A task set to require a note and a photo made a copy that asked only for a note.

• Settings no longer loses an edit when you go to the next row too soon. Each row in Settings → Notifications and Settings → Profiles saves a moment after you stop typing. The first row showed Saved and then lost its value. (Fixes #255)

• The Shopping filter is kept after a page reload. The task list changed back to All each time the page was refreshed.

[0.20.0b6]

Added

• The shopping-list line shows the amount to buy. A part measured in a unit reads "Buy fabric softener (500 ml)", and a part that restocks more than 1 at a time reads "Buy air filter (×2)". A part that restocks 1 whole spare is not changed, and the task keeps its own name in the panel and the calendar and the notifications. (Fixes #220)

• A Profile can exclude the shopping tasks. The new Exclude shopping switch removes the auto-created buy tasks from the tasks that a Profile selects. It is off by default. An existing Profile is not changed.

Fixed

• A buy task is no longer shown as overdue work. A task with no due date is due immediately, so a buy task was shown in the Overdue section with the overdue maintenance tasks. It now has a Shopping section of its own, in the panel and on the dashboard card, and its status reads Low stock.

• The Shopping filter is kept after a page reload. The task list changed back to All each time the page was refreshed.

[0.20.0b5]

Changed

• Each Settings card now shows its save status next to its name, in place of a pop-up message. The status reads Saving… and then Saved. A save that fails shows Not saved on the card and also keeps the pop-up, which gives the reason.

Fixed

• Settings no longer loses an edit when you go to the next row too soon. Each row in Settings → Notifications and Settings → Profiles saves a moment after you stop typing. The first row showed Saved and then lost its value. (Fixes #255)

• The Test button now shows the correct result. In Settings → Notifications it said that no task was due after it sent the notification to the phone. (Fixes #255)

[0.20.0b4]

Added

• Profiles can filter by companion. A profile now selects or rejects tasks by the integration that created them. One card or notification can then cover a single source, and a task you create yourself is never selected.

[0.20.0b3]

Added

• Give a notification its own channel and urgency. In Settings → Notifications a notification can use its own channel name and an urgency from Quiet to Critical. A Medication notification can then make a sound during Do Not Disturb while a Batteries notification stays silent. (Fixes #255)

• Send a notification now with Test. Each notification in Settings → Notifications has a Test button that delivers it to the phone at once. Use it to check a channel or an urgency without a wait for a task to come due.

• The Notifications page shows 3 worked automations. One resends a notification every 2 hours until the task is complete. Another sends a notification only when a person is at home.

[0.20.0b2]

Added

• Duplicate a task from its page. The create form opens already filled in with a copy, so a row of near-identical tasks costs one edit each rather than a full re-entry. A task another integration owns keeps a greyed Duplicate that explains why. (Fixes #279)

[0.20.0b1]

Fixed

• Sending a task to a CalDAV to-do list (Nextcloud, Baikal, Radicale) no longer creates a duplicate. The duplicate was permanent: editing the task afterward updated only one copy and deleting it left the other behind on the server. The same timing could also complete a recurring task twice and skip its next occurrence.

[0.19.0] - 2026-09-01

Added

• Home Keeper has a new look. 0.19 is primarily a UI refresh.

Fixed

• Ready for Home Assistant 2026.9. That release reshapes the device registry and adds child devices, so Home Keeper reads both shapes and a task or appliance you attached to a device still finds it after the upgrade. (Fixes #253)

[0.19.0b8]

Fixed

• The admin panel's dropdown menus (Profile, Group by, and similar filters) are themed when open, not just when closed. Their popup list previously fell back to the browser's default grey-on-white, unreadable against a dark Home Assistant theme.

[0.19.0b7]

Changed

• Websocket completion-editing errors now report the code invalid_task instead of not_allowed. Only the machine-readable code changes; the message shown to the user is the same as before.

Fixed

• Completing a task from the panel now settles buy reminders. The panel's own completion path only refreshed, so a completed auto-buy task left its reminder sitting there until the next reload. The service, button and to-do paths already settled correctly.

• The export_inventory service now writes the CSV in your language. The service wrote English column headers while the panel's own export was already localized.

• Deleting an appliance over the websocket now runs the same cleanup as the service. The websocket handler carried its own copy of the cleanup code and could drift from the service's.

[0.19.0b6]

Changed

• The fields a recurrence choice reveals now sit under "Schedule details". The heading used to read "Because of the kind you picked", which described the form's behaviour rather than naming the fields below it.

Fixed

• home_keeper.add_task works with just a name. It needed a unit it never defaulted, so the simplest call failed. A name on its own now creates a one-off due today, and a call that passes a schedule still gets that schedule.

• Closing the edit drawer puts the keyboard back where it was. Escape, Cancel and the close button all left focus at the top of the page, so a keyboard reader who opened a form and changed their mind had to tab back to where they were.

• Escape closes the drawer again after a delete you thought better of. Opening the delete confirmation took the drawer's Escape away and cancelling never gave it back, which left the form with no keyboard way out for the rest of that edit.

• The task list's scope pills no longer answer to "Group by". A screen reader announced them with the same name as the Group by dropdown beside them, so the two controls were impossible to tell apart. They are now "Show".

• Settings says what Profiles, Notifications and Companions hold when they hold nothing. All three rows went blank on a fresh install, which is the one moment the answer matters most.

• A task kept in step with an appliance part or a synced sensor explains itself. Its page offered no Edit and no Delete and said nothing about why, so it read as a surface that had failed to finish rendering.

• The phone tab bar no longer sits live under an open edit sheet. Tapping through the sheet's overlay switched tab and discarded the form without asking.

[0.19.0b5]

Changed

• One word for keeping Home Keeper in step with something outside it: sync. The panel, the options flow and the service descriptions said "mirror" in some places and "sync" in others for the same feature. Every surface now says sync, in all sixteen languages.

• The to-do list sync reports itself as home_keeper_todo_sync. An automation matching on the old origin: home_keeper_todo_mirror needs that one string updated. Nothing else changes: the sync re-adopts the lines already on your list on its first pass.

[0.19.0b4]

Fixed

• Dialogs have their titles back. Completing a task or moving a completion date opened a panel with nothing but a close button above it, so there was no way to tell which task you were about to log. (Fixes #262)

• Buttons say how important they are again. Done, Edit, Delete and Cancel had all drifted into the same solid blue. Each action is drawn at its own weight now, and a red fill appears only where you are asked to confirm a deletion.

• A device Home Assistant no longer knows shows nothing instead of its internal id. A task that outlived its device used to display a long string of letters and numbers where the device name belongs.

• The "Managed by …" and "Connected" chips are readable again. Both were drawn as pale text on a mid-tone fill, below the contrast a label needs.

• The integration chips in a task row are quieter. They were the loudest thing on the line, which put the integration's name ahead of the task's own.

• A finished one-off looks finished however the list is grouped. Only Group by Status used to set it aside. Grouping by area left it mid-list, looking like work still to do.

• Dates read like dates. The panel showed "7/1/2026, 1:00:00 PM" for the date a task was completed, and used a different format on each screen.

[0.19.0b3]

Changed

• Edit opens beside the page you pressed it on. A task's or appliance's page now stays on screen while its form is open, instead of being replaced by the list it came from. On an appliance the list pane steps aside so the form is a second column rather than a third.

Fixed

• Picking a Settings section no longer jumps to the top of the page first. The rail now moves its mark on the page already drawn, so the scroll to that section starts from where you were reading.

[0.19.0b2]

Changed

• The panel has a new look. A task row carries its status in a coloured edge and a pill at the end of the line, and the filter row fits on one line with a count on each scope. On a phone the tabs move to the bottom of the screen and the scope pills wrap onto a second row rather than scrolling out of view.

• Editing opens in a drawer beside the list instead of a card above it. The list keeps its place, the row you are editing stays lit, and Save sits in a header that does not scroll away. Delete and History join it in a footer.

• An appliance is read next to the list it came from. Its sections are now sub-tabs (Parts, Tasks, Documents, Details, Related, History), each with an address of its own, so Back leaves a sub-tab and a sub-tab can be linked to.

• Settings names every section and what it is set to. A rail beside the sections marks which features are on and how many profiles, notifications and companions you have. On a phone it opens on an index of the six instead, and each section has an address of its own.

• The panel is easier to use with a keyboard and a screen reader. Focus stays on the control you just used instead of jumping to the top of the page, the edit sheet on a phone behaves as a dialog that Escape closes, and the filter chips, dropdowns and Settings dots now say what they are rather than showing it in colour alone.

Fixed

• The due date on a one-off task has a label again. Creating a task that happens just once showed a raw translation key above its date picker in every language.

• Text on coloured chips and buttons is readable again. The Done button, the overdue pill, the "Integration offline" chip and the selected filter were all drawn below the contrast a label needs, in one theme or the other.

• A task row on a phone no longer carries an empty line. The spacer that pushes Done to the end of a single-line row stayed in a wrapped one, where it took a whole line to itself and left a visible gap under the task name.

[0.19.0b1]

Fixed

• Ready for Home Assistant 2026.9. That release reshapes the device registry and adds child devices, so Home Keeper reads both shapes and a task or appliance you attached to a device still finds it after the upgrade. (Fixes #253)

[0.18.0] - 2026-08-29

Added

• Send tasks to your to-do lists. A Profile in Settings → Profiles mirrors the tasks it selects onto any Home Assistant to-do list (such as a Todoist project), and checking an item off there completes the task in Home Keeper. Recurring tasks add a fresh item each time they fall due, leaving the checked-off one as your record. (Fixes #239)
• Services take a task's name, not just its id. Every task_id, asset_id, part_id and document_id field now accepts the name you gave the thing, and the panel prints the id with a copy button for when two share one. Home Keeper reports an ambiguous name instead of guessing which you meant.
• Snooze a problem you can't fix right now. A task mirroring a problem sensor now accepts Snooze, and its reminders show that button instead of Mark done. Marking one done is still blocked since only the integration that owns the sensor can decide it's fixed.

Changed

• Profile status labels now spell out what's included. The choices were always cumulative, so the old Due soon already covered overdue tasks too. The new names are Overdue only, Overdue and due soon and Every scheduled task.

Fixed

• Synced problem sensors show up in Profiles again. Picking any Profile used to hide every mirrored problem sensor. (Fixes #248)
• To-do items show the right due date outside UTC. A task due at local midnight showed the previous day on todo.home_keeper_tasks while the panel showed the correct one. A wear part's last-replaced date shifted the same way when the replacement was back-dated. (Fixes #250)

[0.18.0b4]

Added

• Send tasks to your to-do lists. A Profile in Settings → Profiles mirrors the tasks it selects onto any Home Assistant to-do list (such as a Todoist project), and checking an item off there completes the task in Home Keeper. Recurring tasks add a fresh item each time they fall due, leaving the checked-off one as your record. (Fixes #239)

[0.18.0b3]

Added

• Services take a task's name, not just its id. Every task_id, asset_id, part_id and document_id field now accepts the name you gave the thing, and the panel prints the id with a copy button for when two share one. Home Keeper reports an ambiguous name instead of guessing which you meant.

[0.18.0b2]

Fixed

• To-do items show the right due date outside UTC. A task due at local midnight showed the previous day on todo.home_keeper_tasks while the panel showed the correct one. A wear part's last-replaced date shifted the same way when the replacement was back-dated. (Fixes #250)

[0.18.0b1]

Fixed

• Synced problem sensors show up in Profiles again. Picking any Profile used to hide every mirrored problem sensor. (Fixes #248)

Added

• Snooze a problem you can't fix right now. A task mirroring a problem sensor now accepts Snooze, and its reminders show that button instead of Mark done. Marking one done is still blocked since only the integration that owns the sensor can decide it's fixed.

Changed

• Profile status labels now spell out what's included. The choices were always cumulative, so the old Due soon already covered overdue tasks too. The new names are Overdue only, Overdue and due soon and Every scheduled task.

[0.17.0] - 2026-08-26

Added

• Tree view for the appliance list. A View toggle on the Appliances tab switches between the flat list and a tree that nests child devices under their parents. (Fixes #215)

Fixed

• Home Keeper no longer throws you back to your dashboard. Anything that reloaded the integration took the sidebar panel down until setup finished, and Home Assistant drops you out of a panel that vanishes under it. The panel now survives a reload. (Fixes #247)
• "Detected blocking call" warnings from Home Keeper are gone. The integration read its backend string tables on Home Assistant's event loop the first time it needed a translated message. Startup now reads them off the loop instead.

[0.17.0b1]

Added

• Tree view for the appliance list. A View toggle on the Appliances tab switches between the flat list and a tree that nests child devices under their parents. (Fixes #215)

[0.16.0] - 2026-08-25

Added

• Profiles gain exclusion filters. A Profile's filter now has an Exclude counterpart for its label, area and device pickers. An exclusion beats the include side and inherits the same way it does, so a task carrying an excluded label through its device or area is dropped too. (Fixes #214)
• Buy reminders now reach your own shopping list. Point Settings → Shopping list at a to-do list the household already uses and every auto-created "Buy {part}" reminder is put on it. It works both ways: ticking the line off at the shop completes the reminder and restocks the part, and only the lines Home Keeper added are ever managed. (Fixes #220)
• Shopping filter in the panel and dashboard card. A new "Shopping" option in the task filter bar shows only the auto-created buy tasks, and the same filter is available as filter: shopping on the dashboard card. (Fixes #220)
• Stock you measure instead of count. A spare part carries an optional stock unit and a used per completion amount, and every spare quantity now accepts decimals so fabric softener topped up a third of a bottle no longer reads as three bottles gone. Leaving both fields empty keeps the whole-spare counting from before. (Fixes #220)
• Start a usage meter somewhere other than "now". A usage/meter task's new Starting reading anchors it where the machine was actually last serviced instead of at whatever the sensor reads today, and Last completed now appears on sensor tasks too. Completing a sensor task also records what the sensor read at the time, which every history row shows and the pencil edits. (Fixes #235)
• Usage/meter tasks now count down on the overview. A meter task shows how far off it is, "in 7000 miles", rather than only "Monitored". (Threshold and state tasks, which have no interval to count down, still read "Monitored".)

Fixed

• "Mark done" on a notification works before the task is due. A notification built from a Profile set to Due soon or All shows tasks that aren't overdue yet, and its Mark done button did nothing at all when tapped. It now completes the task whenever the notification still reflects that task's current schedule. (Fixes #216)
• A finished do-once task no longer sits on the to-do list forever. Checking off a one-off task retires it everywhere else, but todo.home_keeper_tasks kept showing it unchecked with its due date gone. It now drops off the list as soon as it is done and comes back at its due date if the completion is undone. (Fixes #221)
• The dashboard card no longer breaks on an ordinary page reload. A dashboard using the Home Keeper card could show "Custom element doesn't exist: home-keeper-card" because the card reached the browser only through the page Home Assistant caches. It is now registered as a dashboard resource under Settings > Dashboards > Resources, which the frontend fetches fresh on every load and which existing installs pick up on the next restart. (Fixes #228)
• Opening Configure no longer wipes your notifications and profiles. Saving the integration's options dialog replaced the whole settings object with just the seven fields on that form, deleting every notification, every profile and every dismissed companion suggestion. The dialog now changes only its own fields.
• Undoing a meter task's completion keeps your partial progress. Deleting a usage/meter completion reset the meter to zero and left it there. It now reverts to where it was before that completion, so 3,000 of 10,000 miles goes back to 3,000. (Fixes #235)
• "Mark done" on a notification now clears an auto-buy reminder. Completing a "Buy {part}" reminder from a notification restocked the part but left the reminder standing until something else settled it. Every other way of completing it already cleared it.
• Documented that auto-clearing sensor tasks consume consumable stock. A sensor task with Clear when back to normal linked to a consumable part draws down one spare on auto-completion, the same as completing it by hand. This was always the behavior but was not mentioned in the README or the events reference.

[0.16.0b9]

Added

• Usage/meter tasks now count down on the overview. A meter task waiting for its sensor to advance used to read only "Monitored" in the task list. It now shows how far off it is, "in 7000 miles", the meter version of the "in 3 days" a time-based task shows, so you can see at a glance which of your metered jobs is closest without opening each one. (Threshold and state tasks, which have no interval to count down, still read "Monitored".)

Fixed

• Undoing a meter task's completion keeps your partial progress. Deleting a usage/meter completion (undoing an accidental "done") reset the meter to zero and left it there. It now reverts to exactly where it was before that completion: 3,000 of 10,000 miles goes back to 3,000, not zero. (Fixes #235)

[0.16.0b8]

Added

• Start a usage meter somewhere other than "now", and see the meter in your history. A usage/meter task used to anchor at whatever the sensor read the moment you created it, which starts every task for an already-serviced machine a full interval late. The task form now has a Starting reading: your odometer reads 48,000, you change the oil every 10,000 miles, and the last change was at 45,000, so you type 45,000 and the task says "3,000 of 10,000 used" straight away and comes due at 55,000. The live hint does the arithmetic as you type, including warning you if the number you typed is above what the sensor currently reads. Last completed now appears on sensor tasks too, so the calendar half of "every 10,000 miles or 12 months" starts where the meter half does instead of restarting today.

  Completing a sensor task also records what the sensor read at the time, next to the note, cost and photo. Every history row shows it, and the pencil edits it, which you need when you back-date a job you did last month and the meter has moved since. Correcting the reading on the most recent completion re-anchors the meter to match, so the history and the progress bar can't contradict each other. The figures are automatable too: usage_baseline and last_completion_reading join the task's next-due sensor attributes, and complete_task / update_completion both take a reading. (Fixes #235)

[0.16.0b7]

Added

• Stock you measure instead of count. A spare part can now carry a stock unit and a used per completion amount, and every spare quantity accepts decimals. Fabric softener topped up a third of a bottle at a time no longer reads as three bottles gone after three refills, and a part measured in millilitres or metres shows real units rather than a bare number. Set both on the part, under Stock and Reorder at. Leave them empty and a part counts whole spares and uses one per completion, exactly as before. The unit follows the amount everywhere it appears: the part's chips, a linked task's detail line, the stock control on the appliance's device page, and the unit field the stock events now carry. home_keeper.adjust_part_stock takes a decimal delta too, so -250 and -0.33 are both valid adjustments. (Fixes #220)

Fixed

• Opening Configure no longer wipes your notifications and profiles. Saving the integration's options dialog (Settings → Devices & services → Home Keeper → Configure) replaced the whole settings object with just the seven fields on that form. Every notification, every profile, and every companion suggestion you had dismissed was deleted. Notifications then stopped arriving, with nothing on screen to say why. The dialog now changes only its own fields and leaves what you set in the panel alone.

[0.16.0b6]

Fixed

• The dashboard card no longer breaks on an ordinary page reload. A dashboard using the Home Keeper card could show a configuration error reading "Custom element doesn't exist: home-keeper-card". Reloading with the browser cache disabled brought the card back, and the next normal reload broke it again. Home Keeper handed the card to the frontend in a way that only reaches the browser through the page Home Assistant caches, so a page cached before Home Keeper was installed never loaded it. The card is now registered the way every other custom card is, as a dashboard resource under Settings > Dashboards > Resources, which the frontend fetches fresh on every dashboard load. Existing installs get the entry on the next restart, and removing Home Keeper takes it away again. (Fixes #228)

[0.16.0b5]

Added

• Buy reminders now reach your own shopping list. Point Settings → Shopping list at a to-do list the household already uses. Every auto-created "Buy {part}" reminder is then put on it, so it turns up on your voice assistant and on whatever list widget lives on the fridge tablet. It works both ways. Ticking the line off at the shop completes the Home Keeper reminder and restocks the part. Completing the reminder in Home Keeper ticks the line off to match. Topping the stock up some other way removes the line, because nothing was bought. A line already ticked off is never touched. Only the lines Home Keeper added are ever managed. Leave the setting empty to turn it off. (Fixes #220)

Fixed

• "Mark done" on a notification now clears an auto-buy reminder. Completing a "Buy {part}" reminder from a notification restocked the part but left the reminder standing until something else happened to settle it, so it kept showing up as due. Every other way of completing it already cleared it.

[0.16.0b4]

Added

• Shopping filter in the panel and dashboard card. A new "Shopping" option in the task filter bar shows only the auto-created buy tasks (the ones Home Keeper generates when a part's stock hits its reorder point), so you can see at a glance what needs buying without scrolling through every task. The same filter is available as filter: shopping on the dashboard card. (Fixes #220)

Fixed

• Documented that auto-clearing sensor tasks consume consumable stock. When a sensor task with Clear when back to normal is linked to a consumable part, the auto-completion draws down one spare from stock, the same as completing by hand. This was always the behavior but was not mentioned in the README or the events reference.

[0.16.0b3]

Fixed

• A do-once task you already finished no longer sits on the to-do list forever. Checking off a one-off task (renew the passport, register the car) retires it: it goes dormant and leaves the calendar, the due-date sensors and the panel's active list, landing in the panel's Completed section with its record intact. The native todo.home_keeper_tasks list kept showing it anyway, unchecked and with its due date gone, and nothing could clear it short of deleting the task and its history. A finished one-off now drops off the to-do list as soon as it's done, and comes back at its due date if you undo the completion. Checking one off a second time (through todo.update_item, say) no longer records a second completion for work done once. (Fixes #221)

[0.16.0b2]

Fixed

• "Mark done" on a notification works before the task is due. A notification built from a Profile set to Due soon (or All) shows tasks that aren't overdue yet, and its Mark done button did nothing at all when tapped. No completion, nothing in the log, while Snooze and Skip on the same notification worked. The task then went overdue as if it had been left alone. Tapping the button now completes the task whenever it still reflects the task's current schedule. Taps that no longer do are still ignored, so completing a task somewhere else (or on a second notification covering the same task) can't push it out an extra cycle. (Fixes #216)

[0.16.0b1] - 2026-08-21

Added

• Profiles can now leave tasks out, not just let them in. A Profile's filter gains Exclude labels, Exclude areas and Exclude devices alongside the existing include pickers. They subtract from whatever the include filters selected, and they win: a task that matched everything else is still dropped if it carries an excluded label, sits in an excluded area, or hangs off an excluded device. Tag the jobs that need a tradesperson professional and exclude that one label, and you have an "everything I can do myself" list, without tagging every task that isn't a call-out. Exclusions follow the same inheritance as the include pickers, so excluding a label also drops a task that carries it only via its device or area. Because a Profile is the shared saved filter, the exclusions apply everywhere it is used: the notifications built on it, the Profile dropdown on the Tasks tab, and the dashboard card's Filter by profile. Profiles saved before this release keep working unchanged. The new pickers start empty, and an empty picker excludes nothing. (Fixes #214)

[0.15.0] - 2026-08-20

Added

• Complete a task by scanning an NFC/RFID tag. A task can now be linked to a Home Assistant tag: pick one (or type a tag ID) in the task form's new NFC/RFID tag field, stick the physical tag on the thing itself (the dog food bin, the air filter), and scanning it marks the task done. Tagged tasks show an NFC chip in the panel and on the dashboard card, and scan completions carry origin: home_keeper_tag_scan so automations can tell a tap of the tag from a tap on Done. (Fixes #211)
• Proof of presence: require the scan. A per-task Require tag scan to complete toggle blocks Done on every surface (panel, dashboard card, to-do list, device button, notifications), so checking the task off means walking over and scanning its tag. No more feeding the dog from the couch. Automations that need to complete such a task can still do it by passing the tag-scan origin to home_keeper.complete_task.

[0.14.0] - 2026-08-18

Added

• Undoing a completion now tells companion integrations which one you undid. The home_keeper_task_uncompleted event carries the removed completion's ts, and delete_completion takes the same optional origin marker complete_task already accepts. Together these let an integration that mirrors your completions (Pawsistant, for one) remove its own copy when you correct a mistaken "done", instead of leaving a pet-care entry behind that no longer matches Home Keeper. See docs/INTEGRATING.md.
• You can put a task in a room. The task form has an Area field, so a task that isn't attached to a device can still be placed: water the plants in the Living room, clean the windows in the Bedroom. A task's area has always been part of the store and the add_task / update_task services, and the panel already grouped and filtered on it, but nothing in the UI could set it. A device-less task was stuck under Unassigned for good. Choosing an area overrides the one a task would inherit from its device. Clearing it hands the task back to the device's. The task detail page now names the area it ended up in, next to the device chip. (Fixes #204)
• Sensor-based tasks can now be driven by a binary sensor, through a new State mode. Plenty of hardware never publishes a number: a robot vacuum reports water tank low, a device reports battery_almost_empty instead of a battery percentage, a leak detector reports a leak. Pick the entity, pick the state that means "this needs attention" (On and Off are offered directly for a binary_sensor), and the task arms when the sensor gets there. Previously you could select such an entity and the task would silently never fire, because only numeric readings were understood.
  • It arms on the transition into the state, not on the state being true, so a task appears once per event rather than repeating while the sensor stays on, and a restart with the sensor already on doesn't resurrect work you already did.
  • The state is matched as text, so it reaches past binary sensors: vacuum.rosie = docked or sensor.washer_status = finished work the same way.
  • The existing hold applies, for "the door has been open for 10 minutes".
• Clear when back to normal, an opt-in on State and Threshold tasks that completes the task by itself once the condition goes away, recording a completion so the history still shows it. It's off by default, so tasks keep waiting for you unless you say otherwise. A bound entity going unavailable is deliberately not treated as a recovery.

Changed

• The Home Keeper panel now requires an administrator account. Managing your home is administration, and Home Assistant reserves that for admins, so the panel follows the same rule its own Settings does. Everyone else in the household keeps the to-do list, the calendar, the device-page buttons and the dashboard card, and can still complete, snooze, skip and add tasks. The new security model page spells out where the line falls.

Security

• Saving settings and exporting the home inventory are now actually admin-only. Both were guarded in the panel's websocket API but not in the matching home_keeper.set_options / home_keeper.export_inventory services, so any signed-in user could call the service and get the same result, inventory value totals included. Both halves are gated now, and appliance changes join them.
• Appliance data no longer leaks to non-admin accounts. Reading appliances stays open, because the dashboard card needs it, but a non-admin now receives only what the card renders: documents, product links and link-type custom fields. Purchase costs, part costs, serial numbers, warranty dates and free-text custom fields are withheld.
• Notifications only go where Home Keeper says they go. Saved notifications and the target: option on home_keeper.notify accepted any notify service, so Home Keeper could be pointed at an email or chat integration it never advertised. Companion-app (mobile_app_*) targets and persistent_notification are accepted; anything else is refused, loudly when you ask for it and with a log warning when a stored one is dropped.
• Only the built panel files are published. The panel used to serve its whole frontend directory, which Home Assistant exposes before login. Installations from HACS were unaffected (the release archive never carried those files); a Git-clone install exposed the panel's source tree and dependencies.
• Links render through a scheme check, not just escaping, everywhere rather than almost everywhere. Escaping alone doesn't defuse a javascript: link, and some links reach Home Keeper from other integrations.

Fixed

• Undoing a completion that was already gone no longer announces an undo. Removing a timestamp that isn't in a task's history has always been a no-op, but the event fired anyway. It now stays silent, so a listener can't be told to drop a record that was never completed.
• docs/INTEGRATING.md said no event fires when you delete a task in Home Keeper. home_keeper_task_deleted has fired on every deletion path for a while; the lifecycle section now says so.
• Typing a name into the add-task or add-appliance form no longer sets off Home Assistant's keyboard shortcuts. The first character rebuilt the form, which took focus off the field you were typing in, so the rest of the word reached HA's global single-letter shortcuts instead: the device or entity search popped up, and sometimes Assist opened. The form now rebuilds only when the fields it shows actually change.

[0.13.0] - 2026-08-12

Fixed

• Home Keeper is compatible with Home Assistant 2026.8's device changes. Devices now belong to a single integration instead of being shared. Task and appliance entities link to the real device instead of forking a duplicate, and installs that already upgraded are repaired automatically, on the next restart. See Upgrading to Home Assistant 2026.8. (Fixes #183)

Changed

• A task on a device Home Keeper doesn't own no longer shows device triggers on that device's page. Automate on the task's own entities or its home_keeper_* event instead. Home Keeper appliances keep their device triggers.

[0.12.0] - 2026-08-10

Added

• A usage task can now come due on hours or on time, whichever comes first. Real service intervals are rarely one or the other: a nozzle wants replacing every 300 print hours or every 6 months, an oil change every 8,000 km or every 12 months, a filter every 500 run-hours or every 3 months. A usage (meter) task now takes an optional "Or every" cadence beside its target, with a Combine with choice of Whichever comes first or Both must be met. The clock runs from the last completion (or the task's creation, before the first one), so completing it resets both halves together. A machine left unused no longer escapes its calendar service: the time half is evaluated even while the bound sensor is offline, which is exactly when an unplugged appliance used to slip through.
• Usage tasks show their progress. The task page draws a meter bar with a "180 h to go" line, the meter target carries an optional unit label (prefilled from the bound sensor, so "300" reads as "300 h"), and a device-attached task's next-due sensor entity now exposes usage_consumed / usage_remaining / usage_percent / usage_target / usage_unit (plus backstop_due when a time backstop is set) for dashboards and automations.
• The time backstop is behind its own switch now. It used to be three always-visible fields whose interval doubled as its own off switch at 0, so a plain meter task showed three boxes you had to know to neutralise. Also come due on a schedule now reveals them only when you want them, and fills in a working cadence when you flip it on. Existing tasks open with the switch already set to match what they do.
• The task form now states the rule it adds up to, right above the button that saves it. A target, a unit, an "Or every" interval and a Combine-with choice together mean "every 300 h of use, or every 6 months", but nothing on the screen said that sentence until the task already existed. The form now spells it out under When it comes due, rewriting itself as you type, with the live arithmetic underneath ("reads 660 h, so first due at 760 h") in the same box rather than a second panel stacked below it. It covers every kind of task, not just metered ones, and it is produced by the same formatter that writes the task's caption afterwards, so what the form promises and what the list shows can't drift apart.
• New service set_task_meter re-anchors a usage task's baseline without recording a completion. Use it for "I did this last month, before Home Keeper was watching", or when the meter itself was replaced or zeroed. Omit baseline to anchor to the bound sensor's current reading.
• New services sign_document_url and sign_part_file_url mint a short-lived, no-auth-header-needed URL for an asset document or a part's attached file. A caller with no interactive browser session of its own (e.g. an MCP-connected agent) can now download the actual file bytes (a manual, receipt, or warranty PDF) instead of only listing that the document exists. Previously the only way to fetch a file's bytes was the sign_document_url/sign_part_file_url websocket commands, which sign using the calling connection's own identity: fine for a real browser session, but not resolvable for a caller with no such session. Both services share their signing logic with the existing websocket commands (which now sign with no caller-specific identity either, using Home Assistant's built-in read-only "Home Assistant Content" user, the same mechanism HA core uses for externally-fetchable media URLs), so browser-opened links keep working exactly as before. (Related to #161)

Fixed

• The dashboard card's recurrence filter was missing half the task types. It only offered floating, fixed and triggered, so one-off and sensor-based tasks could not be filtered at all.
• The "Welcome to Home Keeper" banner reappeared on every new browser or device. Dismissing it was stored in localStorage, which is scoped to a single browser: a different device, a private window, or a cleared site data store all brought it back. The dismissed state now persists server-side per Home Assistant user (via HA's own frontend user-data store), so dismissing it once keeps it dismissed everywhere you're signed in. (Fixes #182)

[0.11.0] - 2026-08-03

Added

• The dashboard task card can hide itself when its filter matches nothing. A new Hide card when empty toggle collapses the card out of the dashboard layout entirely, instead of showing "No tasks match this filter.", handy for a dashboard built from several per-subject cards (the dog, the car, each kid) where only the ones with something due should show.

[0.10.0] - 2026-08-02

Added

• Archive an appliance instead of deleting it. An appliance that's been replaced can now be archived: its documents, parts, metadata and maintenance history all stay intact, and its device page and entities keep working, but it's tucked out of the default Appliances list. An Active / Archived toggle switches between the two views, and an archived appliance can be restored, or permanently deleted, from its own detail page.
• The upload limit is now 100 MB (was 25 MB). Uploads are streamed straight to disk as they arrive instead of being held in memory, so a large scanned manual no longer costs Home Assistant hundreds of megabytes of RAM to accept. Peak memory is now a fixed ~1 MB buffer no matter how big the file is. Note that a reverse proxy in front of Home Assistant enforces its own body limit (nginx defaults to just 1 MB), so raise that too if you upload remotely (see the README).
• Upload progress for appliance documents and part files. Attaching a manual, receipt or photo now shows a progress bar with the percentage and byte count (manual.pdf · 42% · 4.2 MB of 10 MB), a Cancel upload button, and a "Saving…" phase for the stretch after the last byte is sent while Home Assistant stores the file. Previously a large upload gave no feedback at all. The button stayed idle and nothing moved until it finished. The upload and Save buttons are disabled while an upload is in flight, so a save can no longer race it.
• Notes render as Markdown. Every "Notes" field (on a task, on an appliance, on a part, and on each logged completion) now renders as GitHub-flavoured Markdown, so a note can carry a numbered procedure, a part number in code, a link to the manual, a small table of settings, or a > callout instead of one unformatted run of text. (Previously the task detail page didn't even preserve line breaks.) Rendering and sanitizing are done by Home Assistant's own ha-markdown component, so notes match your theme and no Markdown parser is bundled into the panel. (Fixes #163)
• Inline note editor with a live preview. A task's or an appliance's Notes card has an Edit note button that opens a full-width editor previewing the formatting as you type; the task, appliance, part, and completion edit forms gained the same live preview. The preview appears only once the text actually contains Markdown. (The inline editor previously existed only for synced problem-sensor tasks.)
• Appliances have a Notes field. A first-class free-text field for prose about the appliance ("the shut-off is the red lever above the tank"), separate from the label/value custom metadata fields, and settable via home_keeper.add_asset / home_keeper.update_asset.
• Part notes are editable and visible. Parts have always stored notes, but the panel offered no way to enter them and never showed them. They now appear in the part editor and render under the part in an appliance's Parts list.
• Quick-add a "Product link" custom field. A one-click seed (next to the existing Vendor field, in the appliance's Custom fields editor) fills in a link-typed custom field for the page you bought an appliance from. Separate from Vendor (which is free text), it renders as a clickable link on the appliance's detail page, same as any other link metadata entry. (Fixes #160)

Fixed

• Notification action buttons and text were hardcoded in English. The "Mark done"/"Snooze"/"Skip"/"Open" action buttons on actionable mobile notifications, and the notification title/body text (overdue/due-soon phrasing, the digest summary, the "All caught up" close-out), are now localized to hass.config.language across all 16 supported locales, with correct CLDR plural forms (via the new Babel dependency) for counts like "N day(s) overdue" or "N task(s) due". (Fixes #150)

• Several other user-facing strings weren't localized. A follow-up audit of the whole integration for hardcoded English text found several gaps: the websocket API's and document-upload views' error messages (e.g. "Unknown task_id", "Home Keeper is not loaded"), the problem-sensor sync's completion explanation, the Battery Notes companion suggestion's description, the inventory CSV export's column headers, and a few panel/dashboard-card runtime strings ("No tasks yet.", the load-failed banner, the "+N more" truncation caption, the quick-complete confirm dialog, and the default name for an unnamed saved profile/notification). All are now localized across the 16 supported locales, with two new drift-guard tests to keep future websocket/upload error messages from landing unlocalized again.
• Uploaded manuals and receipts couldn't be opened on mobile, and looked like dead text on desktop. On an appliance's page, tapping a document you'd uploaded (or a part's attached file) did nothing at all in the Home Assistant companion app: the link was built as a script-driven click that fetched a download URL first, and the app's browser blocks a new tab opened that late. They're now ordinary links whose URL is ready before you tap, so they open on mobile, react to hover with a pointer and underline on desktop, and support long-press "open in new tab", middle-click and keyboard activation like any other link. Document rows and the part-attachment paperclip also got a full-size touch target, so they're no longer a pixel hunt on a phone. (Fixes #164)
• Deleting a task or appliance now asks for confirmation. The Delete button on a task/appliance detail page previously looked identical to Edit and deleted immediately on click, with no way to recover the appliance's history (documents, parts, metadata). It now opens the same confirmation dialog already used elsewhere in the panel and is styled as a destructive action, so it can no longer be mistaken for Edit. (Fixes #173)

• Sending an actionable notification blocked the event loop. Building a

notification's payload resolves translated button/message strings and, for multi-day-overdue phrasing, Babel's CLDR plural rules, both of which read files from disk on first use per language. That read was happening directly on Home Assistant's event loop (from the home_keeper.notify service and the auto/walk notification paths), which Home Assistant's own blocking-call detector flags as a bug. The lookup now runs through hass.async_add_executor_job, off the event loop, like any other blocking I/O. (Fixes #150)

• A failed upload looked like nothing happened. An upload error was only ever rendered in the appliance form's error banner, which sits below the documents, metadata, parts and related-devices sections (hundreds of pixels beneath the Upload file button that triggered it), so the failure was invisible without scrolling. Upload failures now appear inline, next to the control that failed, and also fire a Home Assistant notification toast, which can't scroll out of view. The panel scrolls the error into view, and a previous failure is cleared when the next upload succeeds. (Fixes #159)
• A file over the 25 MB limit is now refused instantly. The panel checks the file's size before uploading, so an oversized file fails immediately with a message naming the file, its size and the limit, instead of being streamed to Home Assistant in full only to be rejected at the end, which on a slow connection looked like a hang.
• Better wording when an upload is cut off mid-transfer. A reverse proxy that enforces its own body limit typically closes the connection rather than replying, so the browser never sees a 413. That case is now recognized (the body stopped short) and reported as a possible proxy limit, with a link to the docs, instead of a bare "Upload failed (0)".

[0.9.0] - 2026-07-23

Added

• Notes on problem-sensor tasks — remembered for next time. When Home Keeper mirrors a device_class: problem binary sensor as a task, you can now attach a free-text note to it right from the task's detail page (Add a note → type → Save). The note is for the instructions you want next time the problem fires — the fix that worked last time, a part number, where the shut-off valve is. It sticks with that sensor: it survives the task clearing and re-arming, and even survives the mirror being removed and recreated (turning problem-sensor sync off and on, or temporarily excluding the sensor), so it reappears the next time the same problem goes off.
• Manufacturer/model/serial number for existing-device appliances. Attaching an appliance to a device you already have in Home Assistant used to offer only a device picker — none of the catalog fields a fully virtual appliance gets. Those fields (manufacturer, model, serial number, icon) are now available for existing-device appliances too, and picking a device prefills any that are still empty from the device's own registry entry — handy since not every integration reports them. Fields you've already filled in (or the device doesn't know) are never overwritten, so you can freely correct or complete what the device is missing. (Fixes #145)
• Back-date or correct a task completion. The completion dialog now has an optional Completed at date/time field (defaults to now) for logging a completion in the past — so a floating task's next-due date measures from when you actually did it, not from when you got around to logging it. The task history list also gains a move date action on each completion row to fix an already-recorded entry's timestamp after the fact, without touching its note, cost, photo, or who. Backed by a new home_keeper.move_completion service and matching websocket command; automations that already react to home_keeper_task_completed / home_keeper_task_uncompleted see a move for free. (Fixes #143)

Fixed

• The task-completion dialog's Save button was invisible. For a task set to "Ask for details" or "Require details" on completion, tapping Done opened a dialog to log a note/cost/who — but its Mark done/Save, Skip details, and Cancel buttons never rendered, in the panel or the mobile app, so there was no way to confirm or dismiss it. Home Assistant's ha-dialog component changed its internal slot API (action buttons must now be wrapped in <ha-dialog-footer>); the panel's completion dialog hadn't been updated to match. (Fixes #144)

[0.8.0] - 2026-07-04

Added

• Discover known companions from the panel. The Settings → Companions section now links out to the docs catalog of integrations and glue that work with Home Keeper, so you can browse the full list even when nothing is detected on your setup. The docs page also invites you to open a GitHub issue to suggest a companion (or glue) integration that should be listed.
• In-form help for creating tasks. The task editor now explains itself as you fill it in: every field carries concise helper text, a ? icon by the form title links straight to the docs, and sensor-based tasks gain a short primer plus a live, computed hint that reads the bound sensor and spells out what happens next — e.g. "This sensor reads 660 h now. The task becomes due at 760 h, then every 100 h after each completion." This clears up the most common confusion with usage-meter tasks: the target counts usage from the sensor's current reading, not from zero, and the count restarts after each completion.
• Product URL on replaceable parts. A part can now carry a link to where you buy it (e.g. an Amazon listing). When set, the part's name in the appliance detail page becomes a clickable link that opens the product page in a new tab, so reordering a worn or consumed part is one click away. (Fixes #118)
• Attach a file to a replaceable part. A part can now carry a single attached file (a receipt, spec sheet, or photo) alongside its product URL — upload it from the part's editor and open or remove it later, the same secure upload/storage path appliance documents already use.
• A linked task's "Consumable link" points straight at the part's product page. When a maintenance task is tied to a part that has a product URL, that link now opens the product page directly — in the panel's task detail and on the dashboard card's task row — instead of just naming the part.
• Auto-create a "buy" task when a spare part runs low. A replaceable part that tracks stock with a reorder threshold can now opt into an automatic shopping reminder: enable Auto-create buy task on the part, and whenever its stock drops to (or below) the reorder point Home Keeper adds a one-off "Buy {part}" task — on the appliance's device page, the to-do list, and the panel. The reminder clears itself once the part is restocked above the threshold (or you turn the option off). Completing the reminder restocks the part by a configurable Restock quantity (default 1), closing the low → buy → restocked loop with no automation to write.

Changed

• A task's appliance links now render as chips, inline with the rest. On the dashboard card, a task's document/metadata links, uploaded files, and a linked part's product URL previously appeared as plain blue links in a separate row below the task's chips, which read inconsistently. They now render as primary-tinted link-chips in the same chip row as the status, area, and label chips — one tidy, wrapping row — while still opening in a new tab on tap.

Fixed

• Auto-generated maintenance task names now follow your Home Assistant language. The name Home Keeper generates for a wear part (e.g. "Replace {part} ({appliance})") was always English; it's now translated into your configured language across every surface — the panel, the to-do list, the calendar, notifications, and the device pages — and updates automatically if you change the language. (Fixes #119)
• Fixed a batch of bugs found during an in-depth code review (correctness, security, and reliability), plus internal maintainability cleanups.

[0.8.0b5]

Changed

• A task's appliance links now render as chips, inline with the rest. On the dashboard card, a task's document/metadata links, uploaded files, and a linked part's product URL previously appeared as plain blue links in a separate row below the task's chips, which read inconsistently. They now render as primary-tinted link-chips in the same chip row as the status, area, and label chips — one tidy, wrapping row — while still opening in a new tab on tap.

[0.8.0b4]

Added

• Auto-create a "buy" task when a spare part runs low. A replaceable part that tracks stock with a reorder threshold can now opt into an automatic shopping reminder: enable Auto-create buy task on the part, and whenever its stock drops to (or below) the reorder point Home Keeper adds a one-off "Buy {part}" task — on the appliance's device page, the to-do list, and the panel. The reminder clears itself once the part is restocked above the threshold (or you turn the option off). Completing the reminder restocks the part by a configurable Restock quantity (default 1), closing the low → buy → restocked loop with no automation to write.

[0.8.0b3]

Added

• Product URL on replaceable parts. A part can now carry a link to where you buy it (e.g. an Amazon listing). When set, the part's name in the appliance detail page becomes a clickable link that opens the product page in a new tab, so reordering a worn or consumed part is one click away. (Fixes #118)

• Attach a file to a replaceable part. A part can now carry a single attached file (a receipt, spec sheet, or photo) alongside its product URL — upload it from the part's editor and open or remove it later, the same secure upload/storage path appliance documents already use.

• A linked task's "Consumable link" points straight at the part's product page. When a maintenance task is tied to a part that has a product URL, that link now opens the product page directly — in the panel's task detail and on the dashboard card's task row — instead of just naming the part.

Fixed

• Fixed a batch of bugs found during an in-depth code review (correctness, security, and reliability), plus internal maintainability cleanups.

[0.8.0b2]

Added

• In-form help for creating tasks. The task editor now explains itself as you fill it in: every field carries concise helper text, a ? icon by the form title links straight to the docs, and sensor-based tasks gain a short primer plus a live, computed hint that reads the bound sensor and spells out what happens next — e.g. "This sensor reads 660 h now. The task becomes due at 760 h, then every 100 h after each completion." This clears up the most common confusion with usage-meter tasks: the target counts usage from the sensor's current reading, not from zero, and the count restarts after each completion.

Fixed

• Auto-generated maintenance task names now follow your Home Assistant language. The name Home Keeper generates for a wear part (e.g. "Replace {part} ({appliance})") was always English; it's now translated into your configured language across every surface — the panel, the to-do list, the calendar, notifications, and the device pages — and updates automatically if you change the language. (Fixes #119)

[0.8.0b1]

Added

• Discover known companions from the panel. The Settings → Companions section now links out to the docs catalog of integrations and glue that work with Home Keeper, so you can browse the full list even when nothing is detected on your setup. The docs page also invites you to open a GitHub issue to suggest a companion (or glue) integration that should be listed.

[0.7.0] - 2026-06-30

Added

• Integration-provided metadata chips on tasks. Integrations can now attach compact metadata chips to any task via the task_chips field on home_keeper.add_task / update_task. Each chip carries a label, an optional mdi: icon, and an optional link URL — making contextual information (e.g. battery type, part number) immediately visible in both the sidebar panel task list and the dashboard card without cluttering the task notes.

• Richer appliance device pages. A virtual appliance's Home Assistant device page now surfaces much more of its Home Keeper data: the device-info block shows a first-class serial number (alongside make/model), each stock-tracked part gets an editable spare-stock number and a low-stock problem sensor, and the page's Visit link deep-links straight to that appliance's panel page (manuals, full inventory, history) rather than the panel root. Per-device diagnostics download is scoped to just that appliance's tasks and parts.

• Jump from the panel to an appliance's device page. The "Virtual device" chip on the Appliances list and appliance detail is now a clickable link to that appliance's Home Assistant device page (it was a static marker before).

Fixed

• Problem Sensor Sync no longer leaves empty device cards behind. When you disable Problem Sensor Sync — or exclude an individual sensor, device, area, or label — the synced task and its entities are removed as before, and now the associated device is cleaned up too: a device Home Keeper created for the synced task is removed outright, and a device owned by another integration simply loses its (now entity-less) Home Keeper association. No more orphaned, zero-entity Home Keeper devices under Settings → Devices & Services → Home Keeper.

• Device chip on a task/appliance card row now opens the device page. Clicking the device chip was hijacked by the card row's open-detail handler (it opened the task or appliance detail instead); the chip click no longer bubbles to the row.

[0.7.0b4]

Added

• Richer appliance device pages. A virtual appliance's Home Assistant device page now surfaces much more of its Home Keeper data: the device-info block shows a first-class serial number (alongside make/model), each stock-tracked part gets an editable spare-stock number and a low-stock problem sensor, and the page's Visit link deep-links straight to that appliance's panel page (manuals, full inventory, history) rather than the panel root. Per-device diagnostics download is scoped to just that appliance's tasks and parts. A task attached to a foreign device is left to its owning integration (Home Keeper only adds its per-task entities there).
• Jump from the panel to an appliance's device page. The "Virtual device" chip on the Appliances list and appliance detail is now a clickable link to that appliance's Home Assistant device page (it was a static marker before).

Fixed

• Device chip on a task/appliance card row now opens the device page. Clicking the device chip was hijacked by the card row's open-detail handler (it opened the task or appliance detail instead of navigating to the device); the chip click no longer bubbles to the row.

[0.7.0b3] - 2026-06-29

Fixed

• Problem Sensor Sync no longer leaves empty device cards behind. When you disable Problem Sensor Sync — or exclude an individual sensor, device, area, or label — the synced task and its entities are removed as before, and now the associated device is cleaned up too: a device Home Keeper created for the synced task is removed outright, and a device owned by another integration simply loses its (now entity-less) Home Keeper association. No more orphaned, zero-entity Home Keeper devices under Settings → Devices & Services → Home Keeper.

[0.7.0b2] - 2026-06-29

Added

• Integration-provided metadata chips on tasks. Integrations can now attach compact metadata chips to any task via the task_chips field on home_keeper.add_task / update_task. Each chip carries a label, an optional mdi: icon, and an optional link URL — making contextual information (e.g. battery type, part number) immediately visible in both the sidebar panel task list and the dashboard card without cluttering the task notes.

[0.7.0b1] - 2026-06-29

Internal version bump after 0.6.0 stable shipped.

[0.6.0] - 2026-06-29

This release adds consumable linking so completing a task (e.g. swapping a water filter) automatically draws down your spare stock and fires a reorder alert, appliance document shortcuts directly on dashboard card rows so a manual or parts page is one tap away, and a round of panel clarity improvements that make the task list easier to read at a glance. Highlights, for anyone upgrading from 0.5.0:

Added

• Link a task to a consumable (sensor-driven reorder). Any task can now be linked to an appliance consumable so that marking it done consumes one spare from the part's stock — and fires home_keeper_part_low_stock when you cross the reorder threshold, so an automation can add it to your shopping list. Pair it with a sensor-based task to cover the "there's no schedule — my fridge tells me when the water filter is spent" case: the sensor arms the task, and completing it (when you swap the filter) draws down inventory and signals buy more. Link from the task form's new Linked consumable picker — scoped to the consumables of the appliance the task is attached to — or with the new home_keeper.set_task_consumable service (omit the ids to unlink).

• Show appliance documents on a task's dashboard-card row. Each task can now pick which of its appliance's documents to surface directly on the dashboard task card: external document links, uploaded files (a PDF manual, a photo), and free-form metadata links (e.g. a reorder or warranty page). Choose them in the panel's task editor under Links to show on card (the picker appears once the task's appliance has documents); the card renders each as a compact chip on the task's row — a link or file opens in a new tab (an uploaded file via a short-lived signed URL) — so a manual or parts page is one tap away while you work. The selection rides the existing home_keeper.add_task / update_task services (card_links), and entries resolve live — rename or remove one on the appliance and the card follows.

Changed

• Panel clarity improvements for first-time users. Several refinements make the task list easier to read at a glance: a dismissible "Welcome to Home Keeper" banner on the Tasks tab explains the kinds of tasks you'll see; the recurrence picker now uses plain language ("Repeats after each completion", "Repeats on a fixed schedule", "Just once", "Based on a sensor") instead of internal jargon; overdue tasks show how overdue they are (e.g. "3 days overdue"); monitored tasks are labelled simply "Monitored" and a completion-blocked task shows a muted "Clears automatically" caption; sensor-synced tasks owned by Home Keeper show an "Auto-synced" chip; and the appliance editor's Custom fields and Parts & wear items sections collapse by default on a new appliance so first setup isn't a wall of fields.

• Tapping a task row on the dashboard card no longer opens an edit form. The card is now a focused do-and-glance surface: one-tap Done, add via the header +, and link chips — while editing and deleting move to the sidebar panel, where the full task editor lives.

Fixed

• The dashboard card and panel now reliably refresh after an update. Their module URLs are cache-busted by the bundle's content hash instead of the integration version, so a rebuilt frontend always loads fresh — no more stale card (or "card configuration error" in the mobile app) after upgrading, including across preview builds that reuse a version string.
• Uploaded file documents on the card now open in the mobile app. A pinned file chip is now a plain link with its URL pre-signed when the card loads, so a tap opens it natively — the Home Assistant companion app (iOS/WKWebView) was silently blocking the previous open-on-tap.
• Back navigation from a cross-view detail page now returns to the correct previous page. Navigating Appliance → device → related Task and pressing Back used to jump to the top-level Tasks tab instead of back to the appliance/device view. (Fixes #105)
• Problem Sensor Sync no longer leaves stale entities after disabling or excluding. Disabling the sync, or adding a device/entity/label exclusion, now removes the next_due sensor and overdue binary sensor that were created for the synced task — they no longer linger on the device after the task is gone. (Fixes #104)

[0.6.0b4]

Added

• Show appliance documents on a task's dashboard-card row. Each task can now pick which of its appliance's documents to surface directly on the dashboard task card: external document links, uploaded files (a PDF manual, a photo), and free-form metadata links (e.g. a reorder or warranty page). Choose them in the panel's task editor under Links to show on card (the picker appears once the task's appliance has documents); the card renders each as a compact chip on the task's row — a link or file opens in a new tab (an uploaded file via a short-lived signed URL) — so a manual or parts page is one tap away while you work. The selection rides the existing home_keeper.add_task / update_task services (card_links), and entries resolve live — rename or remove one on the appliance and the card follows.

Changed

• Tapping a task row on the dashboard card no longer opens an edit form. This made it easy to accidentally open (and delete from) a task when you only meant to mark it done. The card is now a focused do-and-glance surface: one-tap Done, add via the header +, and link chips — while editing and deleting move to the sidebar panel, where the full task editor lives.

Fixed

• The dashboard card and panel now reliably refresh after an update. Their module URLs are cache-busted by the bundle's content hash instead of the integration version, so a rebuilt frontend always loads fresh — no more stale card (or "card configuration error" in the mobile app) after upgrading, including across preview builds that reuse a version string.
• Uploaded file documents on the card now open in the mobile app. A pinned file chip is now a plain link with its URL pre-signed when the card loads, so a tap opens it natively — the Home Assistant companion app (iOS/WKWebView) was silently blocking the previous open-on-tap because it happened just after an async request. (External links were always fine.)

[0.6.0b3]

Changed

• Panel clarity pass for first-time users. Several refinements make the task list easier to read at a glance:
  • A dismissible "Welcome to Home Keeper" banner on the Tasks tab explains the kinds of tasks you'll see mixed together (recurring, monitored, and companion- contributed). Dismiss it with Got it and it stays gone.
  • The recurrence picker uses plain language — "Repeats after each completion", "Repeats on a fixed schedule", "Just once", "Based on a sensor" — instead of the "Floating / Fixed / Sensor-based" jargon.
  • Overdue cards now show how overdue they are (e.g. "3 days overdue") next to the due date, so urgency reads at a glance.
  • Monitored tasks are labelled simply "Monitored" (the "(condition-driven)" parenthetical is gone), and a completion-blocked task shows a muted "Clears automatically" caption instead of a dead, greyed-out Done button.
  • Sensor-synced tasks owned by Home Keeper itself now show an "Auto-synced" chip rather than the redundant "Managed by Home Keeper", and companion "Managed by …" chips carry the integration's icon so owner/device/status chips read distinctly.
  • The appliance "Virtual device" chip has an explanatory tooltip, and the appliance editor's advanced Custom fields and Parts & wear items sections collapse by default on an empty appliance (and remember your choice while editing), so adding a first appliance isn't a wall of fields.

[0.6.0b2]

Added

• Link a task to a consumable (sensor-driven reorder). Any task can now be linked to an appliance consumable so that marking it done consumes one spare from the part's stock — and fires home_keeper_part_low_stock when you cross the reorder threshold, so an automation can add it to your shopping list. Pair it with a sensor-based task to cover the "there's no schedule — my fridge tells me when the water filter is spent" case: the sensor arms the task, and completing it (when you swap the filter) draws down inventory and signals buy more. Link from the task form's new Linked consumable picker — scoped to the consumables of the appliance the task is attached to — or with the new home_keeper.set_task_consumable service (omit the ids to unlink). The link is independent of the auto-generated wear-part tasks, so it's never reconciled away and the task stays fully editable.

[0.6.0b1]

[0.5.0] - 2026-06-26

This release adds offline manuals & documents so appliance files are available even when a manufacturer's site isn't, profiles as named, reusable task filters you define once and use everywhere, actionable mobile notifications so each household member can complete, snooze, or skip tasks right from their phone, and standalone snooze and skip services for any automation. Highlights, for anyone upgrading from 0.4.0:

Added

• Offline manuals & documents. An appliance can now hold a list of documents — manuals, warranties, receipts — each either an external link or an uploaded file (PDF or image) stored locally on your Home Assistant instance, so the manual is there even when the manufacturer's site isn't. Manage them in the appliance's Manuals & documents editor: each existing document shows as a card with its name and details (a link's URL, or an uploaded file's filename, size and type) and Open, Edit and Remove actions — open previews it in a new tab, edit renames it (and changes a link's URL; uploaded files are rename-only). A separate Add a document area adds another link or uploads a file; you can attach link documents while first creating an appliance, before it's saved. The appliance detail page lists them, opening a file through a short-lived signed URL. Uploaded files are served by an authenticated endpoint and removed from disk when you delete the document or the appliance. New home_keeper.add_asset_document / home_keeper.update_asset_document / home_keeper.remove_asset_document services (for links — files upload from the panel) and matching websocket commands. This replaces the single appliance manual_url field; your existing manual link is migrated automatically into a document on upgrade — no action needed.
• Profiles (reusable saved filters). A Profile is a named, saved filter — status (overdue / due soon / all) plus optional labels/areas/devices — that you define once in Settings → Profiles and reuse everywhere tasks are filtered: in a notification, in the Profile dropdown on the panel's Tasks tab, and in the dashboard card editor's Filter by profile picker. New home_keeper.list_profiles service and home_keeper/get_profiles websocket command read them.
• Actionable notifications (per-person chore queues). Home Keeper can now push a mobile-app notification for what's due, with Mark done / Snooze / Skip / Open buttons that route back into Home Keeper so the schedule is recalculated correctly (completing advances recurrence; snoozing re-arms a fresh reminder). Configure notifications in Settings → Notifications: each notification references a Profile (which tasks it covers) and targets one or more companion-app devices with its own button set, snooze duration, and style (a walk that sends the first due task and advances to the next as you action it, or a single digest summary). A notification can auto-send when a task goes overdue/due-soon, or be triggered on demand with the new home_keeper.notify service — e.g. from a "Chores" calendar event — so two household members each get their own filtered list. Tapping an action emits a home_keeper_task_completed / _snoozed / _skipped event with origin: home_keeper_notification_action.
• Snooze and skip a task. The notification buttons are also standalone services: home_keeper.snooze_task (defer a task's due date by a number of hours — "remind me later") and home_keeper.skip_task (advance to the next occurrence — "skip this one") move a task's schedule without recording a completion (the maintenance log and a floating task's clock are left untouched). Each fires a home_keeper_task_snoozed / home_keeper_task_skipped event, also available as device-automation triggers.

[0.4.0] - 2026-06-22

This release adds companion discovery so integrations that work with Home Keeper surface in the panel, sensor-based tasks driven by a numeric entity rather than the clock, and device exclusions for problem-sensor sync. Highlights, for anyone upgrading from 0.3.0:

Added

• Companion discovery (Settings → Companions). Home Keeper now surfaces integrations that work with it, right in the panel. Connected companions (integrations that announce themselves — e.g. Pawsistant, or the Battery Notes bridge) get a Configure button that deep-links to their own settings. Suggested rows point you at a bridge for a popular integration you already have installed (e.g. Battery Notes) but haven't connected yet, with an Install link and a Dismiss to silence it. Two paths feed this: an integration can register itself via the new home_keeper.register_companion service (so Home Keeper never hard-codes it), and Home Keeper detects a small curated set of popular upstreams from a catalog. New home_keeper_companion_connected / home_keeper_companion_suggested events let automations react. See the Companions README section and docs/INTEGRATING.md §7.
• Sensor-based tasks. A recurrence type whose due-state is derived from a bound numeric Home Assistant entity rather than the clock, in two modes. Usage / meter generalises floating recurrence from elapsed time to elapsed sensor units — "service every 500 running hours", "oil every 15,000 km" — arming once the reading advances the chosen target since the last completion (which resets the meter; a meter reset re-anchors automatically). Threshold arms when the reading crosses a comparison against a value, with an optional hold and attribute read — "replace the filter when airflow drops below 60 %" — and re-arms only on a fresh crossing. Armed sensor tasks appear on the to-do list and fire home_keeper_task_overdue like any other; the task detail shows live meter progress. Create them in the panel or via home_keeper.add_task with a sensor mapping.
• Exclude devices from problem-sensor sync. The problem-sensor sync feature gains an Excluded devices picker (panel Settings, the options flow, and the home_keeper.set_options service) alongside the existing entity / area / label exclusions. Excluding a device leaves out every device_class: problem binary sensor that belongs to it.

Changed

• Settings tab layout. The completed one-off retention setting now lives in its own General card, separate from the Problem sensor sync card it's unrelated to.

[0.4.0b1] - 2026-06-21

Added

• Companion discovery (Settings → Companions). Home Keeper now surfaces integrations that work with it, right in the panel. Connected companions (integrations that announce themselves — e.g. Pawsistant, or the Battery Notes bridge) get a Configure button that deep-links to their own settings. Suggested rows point you at a bridge for a popular integration you already have installed (e.g. Battery Notes) but haven't connected yet, with an Install link and a Dismiss to silence it. Two paths feed this: an integration can register itself via the new home_keeper.register_companion service (so Home Keeper never hard-codes it), and Home Keeper detects a small curated set of popular upstreams from a catalog. New home_keeper_companion_connected / home_keeper_companion_suggested events let automations react. See the Companions README section and docs/INTEGRATING.md §7.
• Sensor-based tasks. A recurrence type whose due-state is derived from a bound numeric Home Assistant entity rather than the clock, in two modes. Usage / meter generalises floating recurrence from elapsed time to elapsed sensor units — "service every 500 running hours", "oil every 15,000 km" — arming once the reading advances the chosen target since the last completion (which resets the meter; a meter reset re-anchors automatically). Threshold arms when the reading crosses a comparison against a value, with an optional hold and attribute read — "replace the filter when airflow drops below 60 %" — and re-arms only on a fresh crossing. Armed sensor tasks appear on the to-do list and fire home_keeper_task_overdue like any other; the task detail shows live meter progress. Create them in the panel or via home_keeper.add_task with a sensor mapping.

[0.3.0] - 2026-06-21

This release adds three new ways to drive tasks — condition-driven triggered tasks, one-off do-once tasks, and synced problem binary sensors — a Lovelace dashboard card, rich per-completion history, a comprehensive event/automation surface, in-panel Settings, and more flexible appliances, and moves the integration onto the Platinum quality scale. Highlights, for anyone upgrading from 0.2.0:

Added

• Condition-driven (triggered) tasks. A recurrence type for maintenance that responds to a condition rather than a schedule — a battery going low, a leak, a filter past its threshold. A triggered task has no schedule: an owning integration arms it (the new home_keeper.trigger_task service, or by creating it) when the condition becomes true and clears it (complete_task) when it resolves, which records the event in history and returns the task to a dormant state. Dormant triggered tasks are invisible to the to-do list, calendar, and overdue sensors, and the panel tucks them into a collapsed "Monitored" section; armed ones read as due-now everywhere. This is the engine behind the Battery Notes glue integration.
• One-off (do-once) tasks. A recurrence type for tasks that happen once rather than on a schedule — renew a passport, register a car, replace a single item. Pick One-off on the task form and choose a due date (defaults to today); it shows on the to-do list, calendar and overdue sensors like any task until you complete it, then goes dormant and moves to a collapsed Completed section in the panel (its completion history is kept). Undoing the completion brings it back to its due date. Available to automations via home_keeper.add_task / update_task (recurrence_type: one-off with a due). A new One-off retention (days) option (Settings tab, options flow, and home_keeper.set_options) can auto-delete a completed one-off this many days after it's done; the default 0 keeps them forever.
• Sync problem binary sensors as tasks (opt-in). A new option automatically mirrors every binary_sensor with the problem device class as a Home Keeper task. The task is armed (shows as due-now on the to-do list, calendar and device page) while the sensor reports a problem and clears itself automatically once the originating integration resolves it. These synced tasks can't be completed inside Home Keeper — the underlying problem has to be fixed in real life — so the Done action is shown disabled on every surface and tapping it explains why. Each task inherits the sensor's device and area; narrow the scope with entity / area / label exclusions. Off by default.
• Dashboard task card. A resizable Lovelace card (custom:home-keeper-card) shows your tasks as a list with a one-tap Done button on each row, and opens an inline editor for adding, editing, and deleting tasks without leaving the dashboard. It is auto-registered as a resource (no manual setup) and appears in the "Add card" picker. A GUI config editor exposes filtering (by status, area, device, recurrence type, due-within horizon, and labels), sorting, status/area/device grouping, a max-items cap, and display toggles. Built entirely from Home Assistant's own components and theme variables, and it stays in sync with completions made from any other surface.
• Task labels & per-subject cards. Tasks now carry a labels field — editable in the panel/card task form and via home_keeper.add_task / update_task, and echoed on every task event. Point a card at one or more labels (e.g. dog, car, a kid's name) to get a focused list: a card per subject. The filter matches a task by its own labels or by the labels on its attached device or area.
• Per-completion metadata (note, cost, photo, who). A completion can now carry optional context: a free-form note, a cost, a photo (uploaded to Home Assistant's image store), and who did it (a person entity). Capture is a per-task setting — none (the default one-tap Done), optional (a details dialog, plus a Skip shortcut), or required (the dialog with mandatory field(s)). The panel shows each completion's note/cost/photo/who in the task history and lets you edit a past entry without changing the schedule. New home_keeper.complete_task fields and a new home_keeper.update_completion service expose this to automations; the latest completion's metadata is mirrored on the task's next due sensor attributes, and a home_keeper_task_completion_updated event fires when a past completion is edited.
• Comprehensive lifecycle events + automation-editor device triggers. Home Keeper now fires a Home Assistant bus event for every meaningful change, so you can automate on the full lifecycle instead of just completions and low-stock. New events: tasks created / updated / deleted / uncompleted / triggered and the time-based overdue and due-soon transitions; spare parts out of stock and restocked (alongside the existing low-stock); and appliances created / updated / deleted. The time and stock transitions are edge-triggered (one event per crossing) and silently baselined on restart, so a reboot never replays an "overdue" storm. Each event also shows up as a device trigger in the visual automation editor. See docs/EVENTS.md for the full catalog and example automations.
• A Settings tab in the panel. Home Keeper's integration options are now editable right in the sidebar panel — a Settings tab alongside Tasks and Appliances — so you don't have to dig through Settings → Devices & services → Configure. It mirrors the options flow and saves as you change it. The options flow still works, and a new home_keeper.set_options service exposes the same settings to automations.
• Flexible appliance metadata — custom fields. An appliance's descriptive details are now a free-form list of custom fields instead of a fixed set of inputs. Each field has a label and a type — text, link, or date — and you add as many as you like, with one-click seeds for the common ones (serial number, warranty expiry, purchase/install dates, provider, vendor, notes). A date field is display-only unless you tick Track as a sensor, which surfaces it as a date sensor on the device for automations (e.g. "warranty expiring in 30 days → notify"). Manufacturer, model, manual link, cost, icon and area remain dedicated fields, and the insurance inventory export lists each appliance's custom fields in a new Details column. Note: this changes how appliance metadata is stored — an existing appliance's old descriptive fields are not migrated; re-enter them as custom fields.
• Backdating when creating tasks and parts. The New Task form has an optional Last completed field that seeds an initial completion so a floating task's next-due is measured from when the activity actually last happened; integrations can pass the same via home_keeper.add_task's last_completed. The parts editor gains a matching Last replaced date for wear items so the maintenance task it creates starts its clock from the real replacement date. The appliance parts list was also redesigned into per-part cards (type icon/badge, cadence, last-replaced, spare-stock).
• Platinum integration quality scale. Home Keeper now declares the Platinum quality scale, with a per-rule ledger in custom_components/home_keeper/quality_scale.yaml. The codebase is fully type-checked (mypy, with py.typed) in CI.

Changed

• A wear-item replacement task with no recorded last-replaced date is now due now, not "assumed fresh". When Home Keeper derives a replacement task from an appliance wear item that has no "Last replaced" date, it now reads as due immediately (matching brand-new floating tasks) instead of scheduling the first reminder a full interval out. Backdate the part's last-replaced date (or mark the task done) to start its clock from a known point. Wear items with a recorded replacement date are unaffected.
• A spare part dropping straight to zero now fires home_keeper_part_out_of_stock, not home_keeper_part_low_stock. Out-of-stock is the more specific event and takes precedence. If an automation listened for home_keeper_part_low_stock to catch a part reaching zero, switch it to (or also listen for) home_keeper_part_out_of_stock. A part crossing into low without hitting zero still fires home_keeper_part_low_stock.
• User-facing error messages are now localizable. Errors raised by Home Keeper services and entities use Home Assistant translation keys (strings.json → exceptions) so they can be translated (English-first for now).
• Home Keeper now registers as a service-type integration (integration_type), so Home Assistant groups it accordingly in the UI.

[0.3.0b12] - 2026-06-21

Added

• Per-completion metadata (note, cost, photo, who). A completion can now carry optional context: a free-form note, a cost, a photo (uploaded to Home Assistant's image store), and who did it (a person entity). Capture is a per-task setting chosen on the task form — none (the default one-tap Done), optional (a details dialog with everything optional, plus a Skip shortcut), or required (the dialog with mandatory field(s)). The panel shows each completion's note/cost/photo/who in the task history and lets you edit a past entry without changing the schedule; the dashboard card sends a required task to the panel to capture its details. The set of required fields is stored per task (completion_required_fields) so it can later be made field-by-field configurable without a data migration. New home_keeper.complete_task fields and a new home_keeper.update_completion service expose this to automations; the latest completion's metadata is mirrored on the task's next due sensor attributes, and a home_keeper_task_completion_updated event fires when a past completion is edited.
• Platinum integration quality scale. Home Keeper now declares the Platinum quality scale, with a per-rule ledger in custom_components/home_keeper/quality_scale.yaml. The codebase is fully type-checked (mypy, with py.typed) in CI.

Changed

• Error messages are now localizable. Errors raised by Home Keeper services and entities use Home Assistant translation keys (strings.json → exceptions) so they can be translated (currently English-first across all locales, translated incrementally).
• Home Keeper now registers as a service-type integration (integration_type), so Home Assistant groups it accordingly in the UI.

Fixed

• Settings exclusions now take effect immediately. Adding a problem-sensor entity, area, or label to a skip list in the panel's Settings tab is now reflected right away: the integration reload that re-runs the problem-sensor sync is awaited before the save returns, and the panel refreshes its task list so the excluded sensor's synced task disappears (or reappears when you clear the exclusion) without needing a manual refresh or page reload.

[0.3.0b11] - 2026-06-20

Added

• Filter the dashboard card by label — one card per subject. Tag tasks with Home Assistant labels (e.g. dog, car, a kid's name) and point a Home Keeper card at one or more of them to get a focused list: a card for the dog, one for home maintenance, one for the car, one per kid. The label filter matches a task by its own labels or by the labels on its attached device or area — so a Home Keeper virtual appliance you've labelled in Settings → Devices is picked up automatically, and a subject doesn't have to map onto an HA area or device. Configure it from the card editor (Limit to labels, plus an Any/All match mode and an optional Show labels toggle that renders each task's label chips). Tasks now carry a labels field, editable in the panel/card task form and via the home_keeper.add_task / home_keeper.update_task services; the value is also echoed on every task event.

[0.3.0b10] - 2026-06-19

Changed

• A synced problem-sensor task now shows its Done button disabled instead of hiding it. Previously the action just vanished for these un-completable tasks, which read as "missing" rather than "blocked". The button is now visibly greyed, and tapping it (in the panel or the dashboard card) pops up a short explanation that the problem clears automatically once the originating integration resolves it — so it's clear why you can't mark it done here.

[0.3.0b9] - 2026-06-19

Added

• A Settings tab in the panel. Home Keeper's integration options are now editable right in the sidebar panel — a Settings tab alongside Tasks and Appliances — so you don't have to dig through Settings → Devices & services → Configure. It's a plain form mirroring the options flow (the problem-sensor sync toggle plus entity / area / label exclusions) that saves as you change it. The options flow still works, and a new home_keeper.set_options service exposes the same settings to automations.

[0.3.0b7] - 2026-06-19

Added

• Sync problem binary sensors as tasks (opt-in). A new option — Settings → Devices & services → Home Keeper → Configure — automatically mirrors every binary_sensor with the problem device class as a Home Keeper task. The task is armed (shows as due-now on the to-do list, calendar and device page) while the sensor reports a problem and clears itself automatically once the originating integration resolves it (the sensor returns to OK). These synced tasks can't be completed inside Home Keeper — the underlying problem has to be fixed in real life — so the Done action is hidden on every surface (panel, dashboard card, to-do list, device button) and the completion service/websocket reject them with an explanation. Each task inherits the sensor's device and area, so it appears on the device's page. Narrow the scope with entity / area / label exclusions in the same options screen. Syncing is off by default.

[0.3.0b6] - 2026-06-19

Added

• Comprehensive events for everything that happens — and automation-editor triggers. Home Keeper now fires a Home Assistant bus event for every meaningful change, so you can automate on the full lifecycle instead of just completions and low-stock. New events: tasks created / updated / deleted / uncompleted / triggered and the time-based overdue and due-soon transitions; spare parts out of stock and restocked (alongside the existing low-stock); and appliances created / updated / deleted. The time and stock transitions are edge-triggered (one event per crossing, never repeated every cycle) and are silently baselined on restart, so a reboot never replays an "overdue" storm. Each event also shows up as a device trigger in the visual automation editor — on a task's device or an appliance you can pick "Task became overdue" or "Spare part out of stock" without knowing the event name. The existing home_keeper_task_completed payload gains the full task spine (device/area/recurrence/next-due/enabled) on top of its long-standing fields. See the new docs/EVENTS.md for the full catalog, payloads and example automations.

Changed

• A spare part dropping straight to zero now fires home_keeper_part_out_of_stock, not home_keeper_part_low_stock. Out-of-stock is the more specific event and takes precedence. If you had an automation listening for home_keeper_part_low_stock to catch a part reaching zero, switch it to (or also listen for) home_keeper_part_out_of_stock. A part crossing into low without hitting zero still fires home_keeper_part_low_stock as before.

[0.3.0b5] - 2026-06-17

• Flexible appliance metadata — custom fields replace the fixed metadata form. An appliance's descriptive details are now a free-form list of custom fields instead of a fixed set of inputs. Each field has a label and a type — text, link, or date — and you add as many as you like, with one-click seeds for the common ones (serial number, warranty expiry, purchase/install dates, provider, vendor, notes). Links are clickable and open in the browser. A date field is display-only unless you tick Track as a sensor, which surfaces it as a date sensor on the device for automations (e.g. "warranty expiring in 30 days → notify") — so you no longer get a sensor for every date whether you use it or not. Manufacturer, model, manual link, cost, icon and area remain dedicated fields (they wire into the Home Assistant device card and the inventory export), and the insurance inventory export keeps its value totals while listing each appliance's custom fields in a new Details column. Note: this changes how appliance metadata is stored; pre-release, an existing appliance's old descriptive fields are not migrated.

• A wear-item maintenance task with no recorded replacement date is now due now, not "assumed fresh". When Home Keeper derives a replacement task from an appliance wear item that has no "Last replaced" date, it used to assume the part was fresh and schedule the first reminder a full interval out. It now reads as due immediately, matching how brand-new floating tasks behave: an unknown replacement history is surfaced now rather than hidden for a cycle. Backdate the part's last-replaced date (or mark the task done) to start its clock from a known point instead. Wear items with a recorded replacement date are unaffected.

[0.3.0b4] - 2026-06-17

• Backdate a wear item's last replacement when adding it. The parts editor now has an optional "Last replaced" date field for wear items, so the maintenance task it creates starts its clock from the real replacement date instead of from today — useful for parts you'd already replaced before tracking them in Home Keeper.
• Redesigned the appliance parts list. On an appliance's detail page, each part now reads as a card with a type icon and badge, its replacement cadence, last-replaced date, and spare-stock chips at a glance, replacing the cramped one-line summary.

[0.3.0b3] - 2026-06-17

• Dashboard task card. A new resizable Lovelace card (custom:home-keeper-card) shows your tasks as a list with a one-tap Done button on each row, and opens an inline editor for adding, editing, and deleting tasks without leaving the dashboard. It is auto-registered as a resource (no manual setup) and appears in the "Add card" picker. A GUI config editor exposes filtering (by status, area, device, recurrence type, due-within horizon), sorting, status/area/device grouping, a max-items cap, and display toggles. Built entirely from Home Assistant's own components and theme variables, and it stays in sync with completions made from any other surface.
• Fix: the card no longer spins forever when tasks fail to load. If the task fetch fails (e.g. the integration isn't set up yet, or was removed while a card is still on a dashboard), the card now shows a clear error and keeps retrying on the next update instead of an endless spinner.
• Fix: a fast double-tap of a card's Done button no longer records two completions — a completion already in flight ignores re-entrant taps.

[0.3.0b2] - 2026-06-16

• Backdate last completion when creating a task. The New Task form now includes an optional "Last completed" datetime field. Setting it seeds an initial completion entry so a floating task's next-due date is measured from when the activity actually last happened, rather than being due immediately. Useful when you first install Home Keeper and already know the last time a task was done.

[0.3.0b1] - 2026-06-16

• Condition-driven (triggered) tasks. A third recurrence type for maintenance that responds to a condition rather than a schedule — a battery going low, a leak, a filter past its threshold. A triggered task has no schedule: an owning integration arms it (the new home_keeper.trigger_task service, or by creating it) when the condition becomes true and clears it (complete_task) when it resolves, which records the event in history and returns the task to a dormant state. Dormant triggered tasks are invisible to the to-do list, calendar, and overdue sensors, and the panel tucks them into a collapsed "Monitored" section; armed ones read as due-now everywhere. This is the engine behind the Battery Notes glue integration. See docs/INTEGRATING.md §7 and docs/BATTERY_NOTES_PLAN.md.

[0.2.0] - 2026-06-16

• Managed tasks (stronger integration ownership). Integrations that create tasks can declare a managed_by block that Home Keeper acts on (unlike the opaque source): managed tasks show a "Managed by {name}" chip, lock declared fields out of the edit form, surface an optional completion prompt and a deep link back to the owning integration, and can be grouped by integration. If the owner is uninstalled or disabled, its tasks flip to "Integration offline", become deletable again, and a "Remove orphaned tasks" banner offers one-click cleanup; home_keeper.delete_task gains a force option as a last resort. See docs/INTEGRATING.md §6.

• Home inventory export (for insurance). An Export inventory button on the Appliances tab downloads a CSV — make/model/serial, purchase and warranty dates, replacement cost, and the value of spares on hand, with a grand total. Also exposed to automations as the home_keeper.export_inventory service.

• Spare-inventory tracking for parts. Any part can track a stock count and a reorder-at threshold. Completing a wear-item replacement consumes a spare, and when stock hits the threshold a home_keeper_part_low_stock event fires. The panel shows on-hand count and a Low stock chip; home_keeper.adjust_part_stock restocks or consumes spares from automations.

• Deep links & a working Back button in the panel. Tabs (/home-keeper/appliances) and detail pages (/home-keeper/tasks/<id>) are now in the URL — linkable, bookmarkable, and refresh-safe — and the browser Back button steps back inside the panel instead of leaving it.

• A brand-new floating task is due now, not a full interval away. A floating task with no completion history used to be dated one interval into the future (a chore you'd never done showed up as "due in 30 days"); it now reads as due immediately. Completing it — or seeding a "last done" date (below) — starts the clock from there. Fixed and appliance wear-part tasks are unaffected. Applies to newly-created tasks; an existing never-completed floating task keeps its current due date until next edited or completed.

• add_task accepts an optional last_completed "last done" seed. Integrations that already know when an activity last happened can pass last_completed so the first next-due is measured from that date (next_due = last_completed + interval) instead of due-now. See docs/INTEGRATING.md.

[0.2.0b2] - 2026-06-15

• A brand-new floating task is due now, not a full interval away. A floating task with no completion history used to be dated one interval into the future (a chore you'd never done showed up as "due in 30 days"). It now reads as due immediately — a task you haven't done yet is due now. Completing it (or seeding a "last done" date, below) starts the clock from there. Fixed (calendar-anchored) tasks and appliance wear-part tasks are unaffected. This applies to newly-created tasks; an existing never-completed floating task keeps its current due date until next edited or completed.

• add_task accepts an optional last_completed "last done" seed. Integrations that already know when an activity last happened can pass last_completed to seed an initial completion, so the first next-due is measured from that date (next_due = last_completed + interval) instead of due-now. See docs/INTEGRATING.md.

[0.2.0b1] - 2026-06-15

• Managed tasks (stronger integration ownership). Integrations that create tasks can now declare a managed_by block, which Home Keeper acts on (unlike the opaque source). Managed tasks show a "Managed by {name}" chip; declared fields are locked out of the edit form; and an optional completion prompt and a deep link back to the owning integration are surfaced. Tasks can also be grouped by integration. If the owning integration is uninstalled or disabled, its tasks flip to "Integration offline", become deletable again, and a "Remove orphaned tasks" banner offers one-click cleanup; home_keeper.delete_task also gains a force option as a last resort. See docs/INTEGRATING.md §6.

• Home inventory export (for insurance). A new Export inventory button on the Appliances tab downloads a CSV — make/model/serial, purchase and warranty dates, replacement cost, and the value of spares on hand, with a grand total — built from metadata you've already entered. Also available to automations as the home_keeper.export_inventory service (returns the report plus CSV).

• Spare-inventory tracking for parts. Any part can now track a stock count and a reorder-at threshold. Completing a wear-item replacement consumes one spare, and when stock drops to/below the threshold a home_keeper_part_low_stock event fires so you can automate a shopping-list add or reorder. The panel shows the on-hand count and a Low stock chip; the home_keeper.adjust_part_stock service restocks or consumes spares from automations.

• Deep links & a working Back button in the panel. The panel's view now lives in the URL — tabs (/home-keeper/appliances) and detail pages (/home-keeper/tasks/<id>) are linkable and bookmarkable, and refreshing keeps your place. The browser Back button now steps back to the previous page inside the panel (e.g. detail → list) instead of navigating away from Home Keeper entirely.

[0.1.0b5] - 2026-06-15

• Group and filter the task list. The panel's list view gains a persisted group by control — tasks by Status (overdue / due soon / later / no schedule), Area, or Device; appliances by Area — rendering collapsible sections with counts. Tasks also get quick All / Overdue / Due soon filter chips.

• Full detail pages for tasks and appliances. Tapping a row now opens a dedicated detail page instead of a history-only dialog. A task page shows its status, schedule, notes, and completion history; an appliance page gathers its metadata, parts & wear items, related tasks, subdevices, and full maintenance history (including the retained history of removed tasks) in one place. Done / Edit / Delete live on the detail page, and task rows keep a quick Done plus a red overdue accent.

[0.1.0b4] - 2026-06-15

• Completion history for tasks and appliances. Click a task to see every time it was completed — the dates, how many, and the average cadence — or click an appliance to see a timeline of all maintenance done on it across every related task. Answers "when did I last do this / when was this serviced?" at a glance.

• Appliance history outlives a deleted task. When a task that belongs to an appliance is deleted, its completion history is kept on the appliance (shown as a "removed task") so the appliance's maintenance record survives. A standalone task's history is removed with it, and deleting an appliance clears its archive.

• Undo an accidental completion. Each entry in the history view has a delete button; removing a completion re-derives the task's next due date (a floating task rewinds to the previous completion; a fixed schedule is unaffected).

• Device-page entities name themselves by task. When several Home Keeper tasks are attached to the same existing device, their per-task entities (the mark done button, next due sensor, and overdue binary sensor) used to all share the same name, so there was no way to tell which control belonged to which task. Each is now prefixed with its task name (e.g. "Replace filter: Mark done"). Self-owned task devices are unaffected (the device is already named after the task). Renaming a task now refreshes its device-page entity names (and a self-owned task device's own name) instead of leaving them stale.

• Sidebar panel device chips are now actionable. The device chip on task and appliance rows links to that device's Home Assistant page when clicked (or via keyboard), and shows the device's integration brand logo (falling back to a generic device icon when no brand image is available).

Fixed

• Wear-part tasks no longer break the calendar and sensors. A maintenance task derived from a wear part (with a "last replaced" date) computed a timezone-naive due date, which made its next due sensor, overdue binary sensor, and the whole Home Keeper calendar go unavailable. The due date is now timezone-aware, and existing affected tasks self-heal on the next reload.
• Long-running fixed-schedule tasks no longer crash. A fixed (anchored) daily/weekly task whose anchor was far in the past (a daily task left running ~1.4 years, a weekly one ~9.6 years) raised an internal error when computing its next occurrence — taking down the calendar and the next-due/overdue entities, and 500-ing the create form for a far-past anchor. Occurrences are now computed directly instead of by stepping to an iteration cap.
• Absurd intervals are rejected cleanly. A recurrence interval or wear-part replacement interval large enough to overflow date math now returns a clear validation error instead of an internal server error.
• Wear-part maintenance tasks are managed only through their part. They can no longer be deleted directly (which previously did nothing useful — the next reconcile recreated them); the panel hides edit/delete on these tasks and points you to the appliance part instead. Completing one is preserved across reconciles.
• Editing a wear part's replacement interval no longer resets the clock. The due date now re-bases off the part's last-replaced date (or its creation), so changing "every 3 months" to "every 4 months" extends the schedule instead of restarting it from today.
• A future "last replaced" date is rejected, and duplicate part identifiers are regenerated, so a part's derived task can't be silently hidden or mis-stamped.

[0.1.0b3] - 2026-06-14

• Cross-integration task contributions. Other integrations can now contribute recurring tasks to Home Keeper and stay in two-way sync — with no code dependency in either direction. A task carries an opaque, caller-namespaced source; home_keeper.add_task returns the new task_id in its service response; and Home Keeper fires a home_keeper_task_completed event (carrying source and an origin marker) on every completion — whether checked off in the to-do list, pressed on the device button, or completed via the service — so a contributor can mirror completions both ways and break loops. A new home_keeper.testing helper (an in-memory fake of the services + completion event, built on Home Keeper's own model code) plus a public docs/INTEGRATING.md make it easy for other integrations to build and test against the contract.

• Internationalization (16 languages). Home Keeper is now localized into a common set of locales — English, German, French, Spanish, Italian, Dutch, Polish, Brazilian Portuguese, Norwegian Bokmål, Swedish, Danish, Finnish, Czech, Russian, Simplified Chinese, and Catalan. The config flow, service definitions, and device-page entity names use Home Assistant's native translation system (strings.json ↔ translations/<lang>.json), and the sidebar panel ships a small dependency-free i18n module that follows your HA language (with English fallback for anything untranslated). Plural forms use the browser's Intl.PluralRules, and parity tests keep every locale in sync with the English source on both the backend and the frontend.

• Panel rebuilt on the Home Assistant design language. The admin sidebar panel now uses HA's own components throughout instead of hand-rolled markup: every form is a native ha-form (with HA's text/number/select/date fields, the searchable device & area pickers, and the mdi icon picker), task/appliance rows are ha-cards, navigation uses ha-tab-group, status shows as ha-assist-chip, and actions use ha-button/ha-icon-button. Looks and behaves like the rest of HA (theming, dark mode, mobile) — no functional changes to tasks or appliances.

[0.1.0b2] - 2026-06-14

• Appliances & virtual devices. A new Appliances tab in the panel lets you register an appliance Home Keeper provisions as a real virtual device (so multiple maintenance tasks share one device page), or attach asset metadata to an existing device from another integration. Metadata covers manufacturer/model/ serial, purchase/install/warranty-expiry dates, cost, vendor, manual link, and consumable part numbers. Date fields are exposed as date sensors on the device page so they're automatable (e.g. warranty-expiry reminders).
  • New services: add_asset, update_asset, delete_asset, list_assets, plus matching websocket commands for the panel.
  • Virtual devices are owned by the config entry, so removing Home Keeper cleans them up; deleting an appliance detaches its tasks (they become standalone).
• Structured parts & wear items. Appliances now carry a structured parts list (name, part number, vendor, cost, consumable/wear type) replacing the old free-text part-numbers string. A wear item with a replacement interval automatically creates a maintenance task on the appliance's device (to-do + calendar + mark-done button + next-due sensor), and completing it stamps the part's last replaced date.
• Subdevices & related devices. An appliance can be a subdevice of another (native HA via_device nesting), and can list arbitrary related devices — including foreign ones — surfaced in the panel.
• Tighter HA integration. area_id is validated against real HA areas; virtual devices link back to the panel via configuration_url; appliances take an optional mdi icon; and a diagnostics.py download is available for support.

[0.1.0b1] - 2026-06-13

Initial UX prototype (beta). Published as a pre-release — offered via HACS only to users who enable "Show beta versions". The stable 0.1.0 will be cut from this once the prototype settles.

• Recurrence engine supporting floating (reset-from-completion) and fixed (anchored DAILY/WEEKLY/MONTHLY schedule) tasks, with end-of-month clamping.
• Local task storage and a DataUpdateCoordinator.
• A dedicated Home Keeper sidebar panel for administration: list tasks, create/ edit with a recurrence editor, and optionally attach a task to a device.
• Native usage entities: a todo list and a calendar, plus per-task button, sensor, and binary_sensor entities that attach to a device's page when a task is linked to a device.
• Services: add_task, update_task, delete_task, complete_task, list_tasks, and matching websocket commands for the panel.
• Full test harness: pytest unit tests for the recurrence engine/model, a Docker integration suite, Playwright e2e smoke tests + screenshot capture, and vitest frontend tests. PR-merge-driven release workflow with beta/stable channels.