From fa374dc3c598bcd76391bfb6732648ccc97b0a02 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 30 Mar 2026 12:21:44 +0000 Subject: [PATCH 1/5] Initial plan From becd887e08210a27da0b11d495358c56dbd089dc Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 30 Mar 2026 12:24:41 +0000 Subject: [PATCH 2/5] Improve README structure details Agent-Logs-Url: https://github.com/f-marschall/HA_ProcessMining_Addon/sessions/041577d7-53d5-414a-8a65-5e0b01fae25d Co-authored-by: f-marschall <13604943+f-marschall@users.noreply.github.com> --- README.md | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e5c1366..9392dd3 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,29 @@ # HA_ProcessMining_Addon -Brings Process Mining to Home Assistant as Add-On! +Brings Process Mining to Home Assistant as an Add-on. -This repository provides Home Assistant Addon for Process Mining. +This repository is a Home Assistant deployment wrapper for the actual +[SmartHomeProcessMining](https://github.com/FelixMarschall/SmartHomeProcessMining) +application. ## Installation [![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2FFelixMarschall%2FHA_ProcessMining_Addon) -Guide for Home Assistant Addon configuration: [DOCS](../main/process_management/DOCS.md) +Guide for Home Assistant Add-on configuration: [DOCS](../main/process_management/DOCS.md) Installation without Home Assistant environment: [SmartHomeProcessMining](https://github.com/FelixMarschall/SmartHomeProcessMining) ## Project Structure -This repository depends on the submodule [SmartHomeProcessMining](https://github.com/FelixMarschall/SmartHomeProcessMining), -which can run locally and access the Home Assistant logbook remotely. +This repository mainly contains the Home Assistant add-on packaging and points to +the real application via a git submodule. -The `process_management` folder contains the Docker build files and `config.yaml` for Home Assistant. +- `process_management/`: Home Assistant add-on definition, Dockerfile, and `config.yaml`. +- `process_management/app/SmartHomeProcessMining/`: git submodule with the actual + process mining application code. +- `repository.yaml`: metadata for the Home Assistant add-on repository. +Because the application lives in the submodule, you need to initialize it when +working locally: + +```bash +git submodule update --init --recursive +``` From 721787c1117f57ed4bea704623708b91bb9feb44 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 30 Mar 2026 12:25:15 +0000 Subject: [PATCH 3/5] Fix README docs link Agent-Logs-Url: https://github.com/f-marschall/HA_ProcessMining_Addon/sessions/041577d7-53d5-414a-8a65-5e0b01fae25d Co-authored-by: f-marschall <13604943+f-marschall@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9392dd3..254565d 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ application. ## Installation [![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2FFelixMarschall%2FHA_ProcessMining_Addon) -Guide for Home Assistant Add-on configuration: [DOCS](../main/process_management/DOCS.md) +Guide for Home Assistant Add-on configuration: [DOCS](process_management/DOCS.md) Installation without Home Assistant environment: [SmartHomeProcessMining](https://github.com/FelixMarschall/SmartHomeProcessMining) From df42d2dd3689d3bb3cdbb11dbba5a2868191d487 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 30 Mar 2026 12:33:27 +0000 Subject: [PATCH 4/5] Add README motivation section Agent-Logs-Url: https://github.com/f-marschall/HA_ProcessMining_Addon/sessions/edf1d00c-b1d9-4ed4-ba51-6afba9c3a1ed Co-authored-by: f-marschall <13604943+f-marschall@users.noreply.github.com> --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 254565d..089c592 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,20 @@ This repository is a Home Assistant deployment wrapper for the actual [SmartHomeProcessMining](https://github.com/FelixMarschall/SmartHomeProcessMining) application. +## Why Process Mining on Smart Home Data? +Process mining turns event logs into understandable models of real-world behavior. +Smart homes already generate rich logs through device state changes and automations, +so you can use these techniques to: + +- Discover real routines and occupancy patterns +- Spot anomalies or inefficiencies in automation flows +- Optimize energy usage based on actual device sequences +- Visualize how daily processes evolve over time + +The motivation for this project is to bring these analytical insights to Home +Assistant users so they can understand and improve their smart home behavior +using the existing logbook data. + ## Installation [![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2FFelixMarschall%2FHA_ProcessMining_Addon) From faf769e4d7202a16118919dc75ad39113856b3d2 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 30 Mar 2026 12:34:20 +0000 Subject: [PATCH 5/5] Clarify README docs link Agent-Logs-Url: https://github.com/f-marschall/HA_ProcessMining_Addon/sessions/edf1d00c-b1d9-4ed4-ba51-6afba9c3a1ed Co-authored-by: f-marschall <13604943+f-marschall@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 089c592..e35aed7 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ using the existing logbook data. ## Installation [![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2FFelixMarschall%2FHA_ProcessMining_Addon) -Guide for Home Assistant Add-on configuration: [DOCS](process_management/DOCS.md) +Guide for Home Assistant Add-on configuration: [DOCS](./process_management/DOCS.md) Installation without Home Assistant environment: [SmartHomeProcessMining](https://github.com/FelixMarschall/SmartHomeProcessMining)