New apps Added

custom_components/taskmate/todo.py

@@ -0,0 +1,80 @@
+"""Todo platform — each child's outstanding chores as a native HA to-do list (FEAT-8).
+
+Exposes one TodoListEntity per child, listing the chores they still need to do
+today (via the shared get_due_chores_for_child). Checking an item off completes
+the chore, so the native HA to-do card and voice assistants can drive TaskMate
+without the custom cards.
+"""
+from __future__ import annotations
+
+from homeassistant.components.todo import (
+    TodoItem,
+    TodoItemStatus,
+    TodoListEntity,
+    TodoListEntityFeature,
+)
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.core import HomeAssistant, callback
+from homeassistant.helpers.entity import DeviceInfo
+from homeassistant.helpers.entity_platform import AddEntitiesCallback
+from homeassistant.helpers.update_coordinator import CoordinatorEntity
+
+from .const import DOMAIN
+from .coordinator import TaskMateCoordinator
+
+
+async def async_setup_entry(
+    hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
+) -> None:
+    """Set up a to-do list per child, adding new children as they appear."""
+    coordinator: TaskMateCoordinator = hass.data[DOMAIN][entry.entry_id]
+    tracked: set[str] = set()
+
+    @callback
+    def _add_new() -> None:
+        new = []
+        for child in coordinator.data.get("children", []):
+            if child.id not in tracked:
+                new.append(TaskMateChildTodoList(coordinator, entry, child))
+                tracked.add(child.id)
+        if new:
+            async_add_entities(new)
+
+    _add_new()
+    entry.async_on_unload(coordinator.async_add_listener(_add_new))
+
+
+class TaskMateChildTodoList(CoordinatorEntity, TodoListEntity):
+    """A child's outstanding chores as a to-do list."""
+
+    _attr_supported_features = TodoListEntityFeature.UPDATE_TODO_ITEM
+
+    def __init__(self, coordinator, entry, child) -> None:
+        super().__init__(coordinator)
+        self._entry = entry
+        self._child_id = child.id
+        self._attr_unique_id = f"{entry.entry_id}_{child.id}_todo"
+        self._attr_name = child.name
+
+    @property
+    def device_info(self) -> DeviceInfo:
+        return DeviceInfo(
+            identifiers={(DOMAIN, self._entry.entry_id)},
+            name="TaskMate",
+            manufacturer="TaskMate",
+            model="Family Chore Manager",
+        )
+
+    @property
+    def todo_items(self) -> list[TodoItem]:
+        if not self.coordinator.get_child(self._child_id):
+            return []
+        return [
+            TodoItem(summary=chore.name, uid=chore.id, status=TodoItemStatus.NEEDS_ACTION)
+            for chore in self.coordinator.get_due_chores_for_child(self._child_id)
+        ]
+
+    async def async_update_todo_item(self, item: TodoItem) -> None:
+        """Checking an item off completes the chore for this child."""
+        if item.status == TodoItemStatus.COMPLETED and item.uid:
+            await self.coordinator.async_complete_chore(item.uid, self._child_id)