v0.2.0

[BrendanAnnable]

HAEO v0.2.0 Release Notes

Highlights

⚡ 5-50x Faster Optimization — The optimization engine has been significantly improved, responding much faster to forecast updates and configuration changes.

🔌 Expanded Forecast Sources — New extractors for EMHASS and Flow Power, plus improved Amber2MQTT pricing using advanced_price_predicted.

🔧 More Flexible Configuration — All configuration now supports being driven by either external entities or internal configurable entities. This allows all HAEO configuration to be driven by automations.

🎯 Grid Cost Tracking — New sensors show exactly how much you will be spending on grid imports and earning from exports, with forecasted costs across your optimization horizon.

---

⚠️ Breaking Changes

Input entities changed from sensor to number

HAEO's input entities (grid pricing, battery capacity, grid power limits etc.) have changed from sensor.* to number.*. This allows users to adjust these values directly in the UI.

Migration: Update any automations, dashboards, or templates that reference HAEO input entities to use the new number. prefix instead of sensor..

e.g. sensor.grid_export_price -> number.grid_export_price

---

User-Facing Changes

This release adds grid cost tracking with three new sensors (grid_cost_import, grid_cost_export, grid_cost_net) that show cumulative energy costs with forecasted values across your optimization horizon.

We've expanded forecast source support with new extractors for EMHASS and Flow Power, plus improved Amber2MQTT pricing using the advanced_price_predicted attribute.

Configuration is now more flexible with entity-first flows that let you select sensors directly rather than choosing between modes. You can also control which entities HAEO manages versus which come from external sources. Optional configuration entities now always appear in the UI (disabled when not configured) for better discoverability.

Several bug fixes improve reliability, particularly around entity data loading race conditions during startup.

---

Developer-Facing Changes

The optimization layer has been completely refactored to a declarative architecture using TrackedParam descriptors and @constraint/@cost decorators. This enables warm start support by the linear optimizer HiGHS, where only changed constraints are rebuilt between optimization cycles, resulting in 5-50x faster optimization depending on what parameters changed.

A new BatteryBalanceConnection model element enables lossless energy redistribution between battery sections. Battery fill ordering now uses explicit balance connection constraints instead of cost-based hints, providing guaranteed ordering behavior.

The schema system has been simplified, moving from a reflection-based registry to individual schema.py files per element type with Annotated field defaults. Config data creation and device registration patterns have been unified across all element types.

Testing infrastructure has improved with network topology visualization for scenario tests, deterministic graph rendering, and the ability to use constant values in scenarios instead of requiring entity mocks.

---

Contributors

Thanks to our contributors for this release:

• @TrentHouliston
• @BrendanAnnable
• @cabberley (first contribution! 🎉)

---

Full Changelog

What's Changed

• Add network topology graph visualization to test scenarios by @TrentHouliston in Add network topology graph visualization to test scenarios #88
• Refactor the optimiser to use a declarative structure that reuses past results by @TrentHouliston in Refactor the optimiser to use a declarative structure that reuses past results #112
• Swap to using explicit ordering connections to make better battery decisions by @TrentHouliston in Swap to using explicit ordering connections to make better battery decisions #142
• Implement BatteryBalanceConnection for energy redistribution between battery sections by @TrentHouliston in Implement BatteryBalanceConnection for energy redistribution between battery sections #156
• Update instructions to use meta-rules for maintaining instruction and rule files by @TrentHouliston in Add path-specific instruction files table to copilot instructions #158
• Move field defaults from registry to Annotated types by @TrentHouliston in Move field defaults from registry to Annotated types #159
• Add analytics by @BrendanAnnable in Add analytics #162
• Swap to using zensical to build the documentation by @TrentHouliston in Swap to using zensical to build the documentation instead of mkdocs #163
• Simplify the schema system from reflection to individual files by @TrentHouliston in Simplify the schema system from reflection to individual files #166
• Update instructions for python by @TrentHouliston in Add code review guidelines to improve feedback quality and focus #167
• Separate the inputs to load and update independently by @TrentHouliston in Separate the inputs to load and update independently #168
• Bump the npm group across 1 directory with 4 updates by @dependabot in Bump softprops/action-gh-release from 2.2.2 to 2.5.0 in the github-actions group #169
• Change the scenarios to be able to use constant values instead of entities by @TrentHouliston in Change the scenarios to be able to use constant values instead of entities to make it easier to make scenarios #170
• Make all configuration entities always show up, but disable those that are optional by @TrentHouliston in Make all configuration entities always show up, but disable those that are optional #171
• Update the flows to perform two steps by @TrentHouliston in Update the flows to perform two steps #172
• Update instructions for python by @TrentHouliston in Rename the cursor files to RULE.mdc rather than RULE.md #176
• Update instructions by @TrentHouliston in Add a documentation update reusable prompt to the code #180
• Simplify grid configuration by @BrendanAnnable in Simplify grid configuration #181
• Add configurable entity sentinel by @BrendanAnnable in Add configurable entity sentinel #182
• Update instructions by @TrentHouliston in Add prompts for coverage and linting #185
• Add a costs sensor to show how much is actually being spent from the grid connection by @TrentHouliston in Add a costs sensor to show how much is actually being spent from the grid connection #186
• Add actual value tests to the extractors by @TrentHouliston in Add actual value tests to the extractors rather than just counting the number of outputs #187
• Simplify element configuration by @BrendanAnnable in Simplify element configuration #190
• Update AEMO NEM link by @cabberley in Update AEMO NEM link to GitHub repository #191
• Await entity data loading in platform setup by @TrentHouliston in Await entity data loading in platform setup #192
• Add fence post loading for energy boundary values by @TrentHouliston in Add fence post loading for energy boundary values #193
• Update documentation deployment workflow by @TrentHouliston in Update documentation deployment workflow to trigger on release events and fetch latest release tag #196
• Add EMHASS extractor and test data for energy management forecasts by @TrentHouliston in Add EMHASS extractor and test data for energy management forecasts #197
• Unify config data creation by @BrendanAnnable in Unify config data creation #198
• Amber2MQTT: Use advanced price predicted by @BrendanAnnable in Amber2MQTT: Use advanced price predicted #199
• Configuration flow fixes by @BrendanAnnable in Configuration flow fixes #201
• Revert schema changes by @BrendanAnnable in Revert schema changes #200
• Revert device id changes by @BrendanAnnable in Revert device id changes #204
• Consolidate device creation by @BrendanAnnable in Consolidate device creation #205
• Fix loading race condition by @BrendanAnnable in Fix loading race condition #206
• Fix config flow storing self-referential entity IDs by @TrentHouliston in Fix config flow storing self-referential entity IDs #210
• Use async_on_remove for callback cleanup by @TrentHouliston in Use async_on_remove for callback cleanup #211
• Fix reconfiguration by @BrendanAnnable in Fix reconfiguration #213
• Make scenario topology visualizations deterministic by @BrendanAnnable in Make scenario topology visualizations deterministic #215
• Unload the integration when we have a timeout error by @TrentHouliston in Unload the integration when we have a timeout error #216
• Switch entity selector to use inclusion by @BrendanAnnable in Switch entity selector to use inclusion #217
• Update pyright to version 1.1.408 and enhance CI workflow by @TrentHouliston in Update pyright to version 1.1.408 and enhance CI workflow for better linting and validation #219
• Stabilise the hash so the topology images don't keep changing by @TrentHouliston in Stabilise the hash so the topology images don't keep changing #220
• Add Flow Power extractor by @TrentHouliston in Add Flow Power extractor #221
• Make the grid sensor be the cumulative total by @TrentHouliston in Make the grid sensor be the cumulative total #222

New Contributors

• @cabberley made their first contribution in Update AEMO NEM link to GitHub repository #191

Full Changelog: https://github.com/TrentHouliston/haeo/compare/v0.1.0...v0.2.0

---

This discussion was created from the release v0.2.0.