adaptive-lighting/docs
Alistair Galbraith cb0e552ec5 feat: add adapt_only_on_ha_turn_on to skip adapting externally turned-on lights
When a light turns on from `off` via a source outside Home Assistant — a
physical wall switch or a hub/manufacturer scene (e.g. Lutron) — and
`detect_non_ha_changes` is enabled, Adaptive Lighting adapts the light on the
resulting `off` → `on` event, overriding the brightness/color the external
source just set. Disabling `detect_non_ha_changes` avoids this but also stops
detection of manual changes to already-on lights; the two behaviors were
coupled to a single flag.

Add `adapt_only_on_ha_turn_on` (default `false`, requires `take_over_control`).
When enabled, an `off` → `on` transition with no matching HA `light.turn_on`
context is marked `manual_control` and left untouched, independent of
`detect_non_ha_changes`, decoupling the two behaviors.

The off→on guard reduces to the previous expression when the option is `false`,
so existing configurations are unaffected. Includes a parametrized regression
test, docs, and regenerated strings/services/README via
scripts/update-generated-content.

Refs #435

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-11 17:19:26 -07:00
..
advanced feat: add adapt_only_on_ha_turn_on to skip adapting externally turned-on lights 2026-07-11 17:19:26 -07:00
assets Add documentation site with Zensical framework (#1385) 2026-01-12 23:39:57 +01:00
overrides/partials/integrations/analytics Add documentation site with Zensical framework (#1385) 2026-01-12 23:39:57 +01:00
automation-examples.md Migrate to markdown-code-runner's built-in include_section() (#1417) 2026-01-26 09:01:50 +01:00
CNAME Add documentation site with Zensical framework (#1385) 2026-01-12 23:39:57 +01:00
configuration.md feat: add adapt_only_on_ha_turn_on to skip adapting externally turned-on lights 2026-07-11 17:19:26 -07:00
getting-started.md Add documentation site with Zensical framework (#1385) 2026-01-12 23:39:57 +01:00
index.md Migrate to markdown-code-runner's built-in include_section() (#1417) 2026-01-26 09:01:50 +01:00
run_markdown_code_runner.py Add documentation site with Zensical framework (#1385) 2026-01-12 23:39:57 +01:00
see-also.md Migrate to markdown-code-runner's built-in include_section() (#1417) 2026-01-26 09:01:50 +01:00
services.md Migrate to markdown-code-runner's built-in include_section() (#1417) 2026-01-26 09:01:50 +01:00
troubleshooting.md feat: add adapt_only_on_ha_turn_on to skip adapting externally turned-on lights 2026-07-11 17:19:26 -07:00