@johanwistbacka/node-red-contrib-sw-light 0.1.4 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 0.1.8 — 2026-09-30
+
+- Simplify Adaptive Lighting to an On/Off checkbox with collapsed advanced profile selection.
+- Use the supported color-only `adaptive_lighting.apply` action with a fresh provider calculation, only after automatic OFF → ON on CT-capable lights. SW Light retains brightness, maximum, override protection and transitions.
+- Explicit message colors and manual commands suppress adaptation; already-on brightness changes do not reapply it. Add `msg.adaptive_lighting` opt-in/out.
+- Discover only unique exact `configuration.lights` matches. Missing, ambiguous, unavailable, running and RGB sleep profiles fall back with structured warnings. Non-CT lights retain normal ON.
+- Require the HA profile main switch off for one-shot ownership. Preserve inactive legacy nodes; migrate former optional-apply opt-in.
+- Document inspected upstream API/source, two-action timing limitations and the exact live verification sequence.
+- Full syntax/editor/example check and 42 tests passed, including all 3 isolated published-provider integration tests. No live HA/device verification or publication.
+
+## 0.1.7 — local default threshold adjustment
+
+- Sets the runtime/editor default manual override threshold to 98% (HA brightness 250 or above), retaining the 94% automatic maximum.
+- Updates example flows and documentation. Existing saved thresholds remain unchanged.
+- Verifies the new default boundary and release below threshold; preserves explicit 100% threshold coverage.
+- No npm publication.
+
+## 0.1.6 — local HA state normalization fix
+
+- Omits null/non-array observed HA color attributes instead of spreading them, preventing `a[k] is not iterable` during observation and commands.
+- Keeps valid color arrays as independent copies; retains brightness and manual override behavior.
+- Adds null/non-array normalization coverage and exercises all three override regressions with null HA color attributes.
+- Full checks and isolated Node-RED/HA contrib integration: 33 tests passed. No npm publication; physical-device verification pending.
+
+## 0.1.5 — local override fix candidate
+
+- Starts per-light HA observation after flow startup, before the first input.
+- Retries temporary provider initialization failures without freezing the node; preserves the shared-client/readiness adapter.
+- Fixes idle OFF nodes missing external brightness changes: observed 255 activates override, observed 204 releases the default threshold, and explicit manual OFF bypasses the guard.
+- Adds real-adapter regressions for automatic 94% → external 100% → suppressed OFF, external 80% release, manual OFF, and entity isolation.
+- Full suite including isolated Node-RED/HA contrib 0.80.3 integration: 32 tests passed. Physical-device verification of this candidate is pending. No npm publication.
+
 ## 0.1.4 — scoped distribution candidate
 
 - Changes npm identity to `@johanwistbacka/node-red-contrib-sw-light`.

package/README.md

@@ -1,4 +1,4 @@
-# SW Light — v0.1.4
+# SW Light — v0.1.8
 
 A reusable Node-RED node for one Home Assistant `light.*` entity. Select an
 existing HA server, select a light, deploy in a **development** environment,
@@ -14,8 +14,9 @@ and integration only. With a fixed Action, a normal timestamp Inject is enough.
 
 The permanent npm package name is `@johanwistbacka/node-red-contrib-sw-light`.
 The Node-RED type stays `sw-light` and its display name stays **SW Light**.
-The scoped package starts at version 0.1.4; version numbers are independent
-for each npm package name. No runtime/editor or HA integration behavior changes.
+The scoped package started at version 0.1.4; version numbers are independent
+for each npm package name. Version 0.1.5 fixes observation before the first command; 0.1.6 also tolerates
+null/non-array observed HA color attributes.
 
 If upgrading from the old unscoped `node-red-contrib-sw-light`, export your
 flows first. Remove the old package from the Node-RED user directory before
@@ -25,7 +26,7 @@ or, with Node-RED stopped, run these commands in its user directory:
 
 ```sh
 npm uninstall node-red-contrib-sw-light
-npm install @johanwistbacka/node-red-contrib-sw-light@0.1.4
+npm install @johanwistbacka/node-red-contrib-sw-light@0.1.8
 ```
 
 Restart Node-RED and reload the editor. Existing flow nodes retain type
@@ -51,7 +52,7 @@ are enabled. Test with a development light before relying on this node.
 After this version is published, install it in your Node-RED user directory:
 
 ```sh
-npm install @johanwistbacka/node-red-contrib-sw-light@0.1.4
+npm install @johanwistbacka/node-red-contrib-sw-light@0.1.8
 ```
 
 After publication, the current development release is available under npm latest:
@@ -74,7 +75,7 @@ For edits, use npm's local directory installation/link or reinstall an archive
 created with `npm pack`. Restart the isolated Node-RED runtime after changes.
 There is no build step or additional runtime dependency.
 
-The current development release uses the normal SemVer version `0.1.4` and
+The current development release uses the normal SemVer version `0.1.8` and
 npm tag `latest` for Node-RED compatibility. This version remains experimental;
 it is not a SemVer prerelease. Every installation/publication candidate needs a
 unique version. Use `npm version patch --no-git-tag-version` for the next normal
@@ -86,7 +87,7 @@ After publication, submit the package through the
 [Node-RED Flow Library](https://flows.nodered.org/add/node), or request a refresh
 if it is already listed.
 
-## Temporary runtime diagnostics in 0.1.4
+## Temporary runtime diagnostics in 0.1.8
 
 This build logs `[SW Light debug]` at construction and on the first input,
 then when the relevant structure/readiness changes. It reports version,
@@ -96,7 +97,7 @@ It never logs server IDs, entity IDs, credentials, hosts, full objects or state
 snapshots. Provider initialization errors are reduced to a generic message.
 
 After installation, restart Node-RED and verify a log line containing
-`[SW Light debug] version=0.1.4`. Inject once and retain the prefixed lines,
+`[SW Light debug] version=0.1.8`. Inject once and retain the prefixed lines,
 along with any error/stack. Those lines distinguish missing configuration,
 a missing provider client and a connected client with unexpected methods.
 The real installation problem remains unverified until this build is tested
@@ -119,11 +120,10 @@ there is no `require.cache` scan or search for alternate package copies.
 | On/off transition | 1s each | Sent only with light transition capability |
 | Manual override | Enabled | Pause automatic commands while override is active |
 | Detection | Brightness threshold + flag | Alternative: explicit flag only |
-| Threshold | 100% | Lamp brightness at/above this value activates override |
-| Color mode | Adaptive Lighting | No configured color sent during ordinary ON |
-| Adaptive discovery | Enabled | Unique membership match in switch attributes |
-| Adaptive apply on ON | Disabled | Optional color-only `adaptive_lighting.apply` |
-| Respect adaptive manual control | Enabled | Skip apply when light is manually controlled |
+| Threshold | 98% | Lamp brightness at/above this value activates override |
+| Color mode | Keep current | Normal behavior and fallback |
+| Adaptive Lighting | Off | Current temperature once on automatic OFF → ON |
+| Advanced profile | Automatic | Unique exact light membership; explicit selection if ambiguous |
 
 Require `minimum <= on brightness <= automatic maximum`. When threshold
 detection is enabled, automatic maximum must be below the threshold.
@@ -180,6 +180,7 @@ validated**, even those that lose precedence.
 | `rgbww_color`, `rgbw_color`, `rgb_color` | Arrays of 5, 4, 3 integer bytes 0–255 |
 | `hs_color`, `xy_color`, `color_name` | [0–360,0–100], [0–1,0–1], HA color name |
 | `transition` | 0–3600 seconds |
+| `adaptive_lighting` | Boolean; overrides Adaptive Lighting for one command |
 
 The complete color precedence follows the table top to bottom. `color_name`
 is passed to HA for name resolution/validation, only on a color-capable lamp.
@@ -210,15 +211,21 @@ This hard guard requires brightness exactly **255/255**, so 94%, 95%, 99% and
 is disabled or set to explicit-only. Lowering the light below 255 allows
 automatic control again unless an additional configured override is active.
 
-Threshold detection observes HA state, not requested brightness. The configured
-threshold is converted to a byte; default 100% means exactly 255, not 254 rounded
-for display. With defaults, automation uses 1–94%, and observed 100% activates
+Threshold detection observes HA state, not requested brightness. Each node starts
+its state subscription after flow startup, before its first command, and retries
+temporary provider initialization failures. This includes separate ON/OFF nodes
+for the same physical light. The configured
+threshold is converted to a byte; default 98% means brightness 250 or above.
+With defaults, automation uses 1–94%, and observed brightness at/above this threshold activates
 override. It pauses **all automatic commands**, including ON, OFF, toggle and
 brightness zero, so an automatic ON cannot accidentally lower and release a
 manual setting. A manually lowered observed brightness releases the threshold
 flag. OFF releases all flags. Missing/unknown/unavailable state preserves flags
 and rejects commands.
 
+Existing nodes retain their saved threshold. Change a saved 100% threshold to
+98% manually to use the new default behavior.
+
 An explicit latch is independent of the threshold. It persists until explicit
 release or observed OFF. A release flag clears both flags for its command;
 subsequent threshold observations can reactivate override. Flags are in memory,
@@ -228,49 +235,112 @@ detection. `source` is the v0.1 command-origin contract.
 
 ## Adaptive Lighting
 
-Ordinary ON in Adaptive mode sends brightness and supported transition, **no
-color or temperature**. Adaptive Lighting retains ownership of color. A message
-color explicitly overrides that behavior for one command, and suppresses optional
-apply even when the color is unsupported and filtered.
-
-Manual switch selection takes precedence. Discovery uses the light's exact
-membership in `attributes.configuration.lights` or `attributes.lights` on
-switch entities with adaptive-like attributes. It only selects one unique
-candidate; it does not infer names or configure HA. This is best-effort attribute
-discovery, not a registry-backed guarantee that a switch belongs to the integration.
-No actual installation was available for validating its attribute schema.
-Use the switch picker/manual entity ID when discovery fails or is ambiguous.
-
-Optional apply runs **after** successful turn-on, only for an enabled selected
-switch, without explicit message color. It calls `adaptive_lighting.apply` with
-`adapt_brightness: false`, `adapt_color: true`, `turn_on_lights: false`. It respects
-`manual_control` / `manual_control_color` lists by default and never clears them,
-turns on an adaptive switch or changes integration settings. No discovery is
-required when apply is disabled: the ordinary HA light action works on its own.
-An apply failure emits output 2 with `phase: "adaptive_apply"` and
-`light_service_completed: true`; the successful light result still emits.
-
-Adaptive Lighting may interpret explicit brightness commands as manual control
-depending on its own `take_over_control` and related settings. Its background
-brightness adaptation may also exceed this node's maximum; the ceiling only
-applies to **SW Light's outgoing commands**. Configure the integration's own
-brightness limits/ownership in your dev environment and test that combination.
-SW Light never repeatedly corrects brightness or fights its adaptation.
-
-## Test the updated 0.1.4 in your HA Node-RED installation
+The primary editor control is **Adaptive Lighting: On / Off** (off for new nodes).
+Color mode independently defines normal/fallback color behavior; the default is
+Keep current. Advanced profile selection is collapsed. Discovery selects only
+one exact light-membership match in a main switch's `configuration.lights`.
+No entity names or undocumented `lights` attributes are guessed. Configuration
+attributes must be exposed in HA (`include_config_in_attributes`) for discovery;
+otherwise select the main switch explicitly. Multiple matches never choose the
+first profile. Group membership expansion is not performed.
+
+Keep the selected Adaptive Lighting **main switch OFF** to use its calculation
+without continuous control or ON interception. The supported `adaptive_lighting.apply`
+action works with that switch off and calculates fresh values for every call.
+SW Light never toggles that switch, changes profile settings, clears manual
+control or starts a continuous adaptation loop. Choose a profile using
+color-temperature sleep color; RGB sleep profiles are rejected with a warning.
+
+Precedence for each command:
+
+1. Explicit message color/temperature wins, including unsupported color that
+   is omitted with an event. It always suppresses Adaptive Lighting.
+2. Otherwise, Adaptive Lighting runs only after a successful automatic OFF → ON
+   service, on a color-temperature-capable light.
+3. Otherwise, normal configured SW Light color behavior applies.
+4. Keep current/lamp default omit color and leave normal HA/device behavior.
+
+`msg.adaptive_lighting` (boolean) overrides the checkbox for that command.
+Brightness, automatic maximum, override protection and fade stay with SW Light.
+An already-ON brightness command, manual command, OFF or zero-brightness command
+never invokes Adaptive Lighting. Configured fixed color still follows normal
+SW Light behavior on these commands. Legacy adaptive flows with optional apply
+already enabled retain their opt-in; former inactive adaptive flows stay off.
+Legacy discover/respect-manual controls are retired.
+
+After `light.turn_on`, SW Light calls `adaptive_lighting.apply` for exactly one
+light with `adapt_brightness: false`, `adapt_color: true`, `prefer_rgb_color: false`,
+`turn_on_lights: true`, and the SW Light command transition (0 if unsupported).
+The true flag avoids silently skipping color when HA has not yet observed the
+successful ON. Adaptive Lighting clamps temperature to the light's range.
+The two actions are not atomic: a brief initial/default color may be visible,
+and an external OFF between them can race with the second action. Service
+acknowledgement reports an accepted action, not physical temperature confirmation.
+
+Missing/unavailable/ambiguous/running profiles, a missing apply action or its
+failure emit output 2 `warning`, with `phase: "adaptive_apply"`, structured
+`reason`, and `light_service_completed: true`. Normal ON and output 1 survive,
+retaining the configured color fallback. Non-CT lights emit `unsupported` and
+still turn on without temperature parameters. A running HA profile or other
+external automation can still alter lights independently; turn those off for
+this ownership model. SW Light cannot cancel their behavior.
+
+Investigation: [upstream apply documentation](https://adaptive-lighting.nijho.lt/services/)
+and [source inspected on 2026-09-30](https://github.com/basnijholt/adaptive-lighting/blob/283fec08ae7d34901d13c32e91fb001f92395fe7/custom_components/adaptive_lighting/switch.py).
+The main switch exposes last calculated `color_temp_kelvin` when on, but null
+when off; reading that cache cannot deliver the requested fresh calculation.
+`apply` recalculates in `prepare_adaptation_data` even while off. No dedicated
+read-only temperature calculation service is exposed. Calculations remain in
+Adaptive Lighting, including sun/time and sleep settings.
+
+### Real-world verification
+
+1. Install the local 0.1.8 archive, restart Node-RED, and verify its startup
+   version. Use a test light with `color_temp` support. Connect both outputs to Debug.
+2. In HA, expose the profile's configuration attributes for automatic discovery
+   (or select it under Advanced). Keep its main switch off, use color-temperature
+   sleep color, and disable any other automatic controllers for this test light.
+3. In SW Light select Action On, brightness/max 94%, Keep current, Adaptive Lighting
+   On. Turn the light off in HA and wait until Node-RED observes OFF. Trigger ON.
+4. Verify `adaptive.applied: true` and brightness 239/255 (about 93.7%). After the
+   fade, inspect HA light state and physically check the light. To get a comparison
+   value while the profile is off, call HA's `adaptive_lighting.apply` yourself
+   with the same profile/light, brightness false, color true, RGB preference false,
+   turn-on true and transition 0; verify the light's temperature stays the same
+   (allow calculation changes around a time boundary and device rounding).
+5. Turn the light off and wait for OFF. Repeat at another time, or toggle the
+   profile's sleep-mode helper with a distinct configured sleep temperature.
+   Trigger ON; verify the new value rather than the previous temperature is used.
+   Restore the sleep helper after testing.
+6. While ON, send another automatic ON with `brightness_pct: 80`. Verify brightness
+   changes and `adaptive.applied: false`; with Keep current, temperature stays put.
+7. From OFF, send ON with `color_temp_kelvin: 3000`, then a supported explicit
+   color command. Verify each wins and no adaptive action runs. Try a manual ON
+   and verify the same suppression.
+8. Set brightness to 100% externally. Automatic OFF must remain blocked. Lower
+   below the configured threshold and verify OFF works again.
+9. Test missing/ambiguous profiles, the main switch ON, and a non-CT light. Confirm
+   normal ON plus the corresponding warning/unsupported event. Redeploy/reconnect
+   and verify fresh discovery, safe observation and no duplicate adaptive calls.
+
+Actual Adaptive Lighting version, exposed configuration, sleep behavior, lamp
+latency/rounding and the two-action race still require verification on your HA
+installation. Automated tests mock that service boundary, not its algorithm.
+
+## Test the updated 0.1.8 in your HA Node-RED installation
 
 1. Save/export your current test flow. Transfer the rebuilt local
-   `johanwistbacka-node-red-contrib-sw-light-0.1.4.tgz` to the Node-RED host. Check that HA contrib
+   `johanwistbacka-node-red-contrib-sw-light-0.1.8.tgz` to the Node-RED host. Check that HA contrib
    is 0.80.3; do not upgrade it for this task.
 2. In a terminal for that Node-RED instance, find **User directory** in its
    startup log. Change to that directory (not a global npm directory) and run
-   `npm install ./johanwistbacka-node-red-contrib-sw-light-0.1.4.tgz --ignore-scripts --no-audit --no-fund`.
+   `npm install ./johanwistbacka-node-red-contrib-sw-light-0.1.8.tgz --ignore-scripts --no-audit --no-fund`.
    Use the add-on's supported local package installation mechanism if its terminal
    does not expose that user directory/npm. Restart Node-RED/the Node-RED add-on
    and reload the editor so the updated runtime and HTML are both loaded.
 3. Add a timestamp Inject directly into SW Light. Choose your **existing HA
    server**, one `light.*` entity, Action **On**, and the desired On brightness
-   (94% by default). Keep optional Adaptive apply disabled for this basic test.
+   (94% by default). Keep Adaptive Lighting off for this basic test.
    Remove downstream HA Action nodes; leave outputs unconnected or use Debug.
 4. Deploy. SW Light constructs without resolving HA and initially shows
    `HA NOT READY`. With the light OFF, click Inject: the light should turn on at the
@@ -279,7 +349,7 @@ SW Light never repeatedly corrects brightness or fights its adaptation.
 5. Set the lamp to 100% manually in HA (verify attribute `brightness: 255`).
    Try On, Off and Toggle: no automatic light service should run, and the node
    should show `MANUAL · 100% · BLOCK ...`. Lower the light manually to 94%, 95%
-   or 99%, then retry; automatic control should resume with default override settings.
+   then retry; automatic control should resume with default override settings.
 6. Select **From msg** and use Inject properties `action` (string) with `on`,
    `off` and `toggle`. Also test `auto_light.action` when top-level action is
    absent. A missing/invalid action should show an error, emit output 2, and
@@ -310,13 +380,14 @@ Output 1 follows successful light service acknowledgement:
     "service_data": { "brightness": 115, "transition": 1 },
     "ignored_conflicts": [], "state_confirmation": "last_observed",
     "observed_at": "2026-09-30T10:00:00Z",
-    "adaptive": { "entity_id": null, "active": false, "manual_control": false, "state": null }
+    "adaptive": { "entity_id": null, "active": false, "state": null, "candidates": [], "applied": false, "reason": "not_requested" }
   }
 }
 ```
 
-`adaptive_lighting` means **configured mode**. `adaptive.active` means a resolved
-switch is ON. `adaptive.applied` is present when optional apply is evaluated.
+`adaptive_lighting` means the command's effective enablement (message overrides node).
+`adaptive.active` means a resolved profile is available with its main switch OFF.
+`adaptive.applied` reports successful action acknowledgement, not measured Kelvin.
 The state is the **last observed HA snapshot**, possibly preceding the action
 or an unfinished transition. Service acknowledgement does not confirm a physical
 lamp change. No requested value is fabricated as observed state. The first input
@@ -357,7 +428,7 @@ Output 2 has a stable versioned event envelope:
 ```
 
 Types: `manual_override`, `override_released`, `unavailable`, `unsupported`,
-`error`. Details include `reason`, `parameters`, `message`, `phase` as applicable.
+`warning`, `error`. Details include `reason`, `parameters`, `message`, `phase` as applicable.
 Unsupported parameters are omitted and the supported action still runs.
 Blocked commands emit only output 2. Invalid input and transport failures also
 call Node-RED `done(error)` for Catch-node handling. Connection/state events have
@@ -381,7 +452,7 @@ npm pack --dry-run
 Run these checks from the source checkout; test tooling is not included in the npm package.
 Tests use Node's built-in test runner without HA or npm dependencies. They cover
 numeric ranges, precedence, max/min, manual override, color translation,
-unsupported capabilities, adaptive discovery/manual control, runtime outputs,
+unsupported capabilities, one-shot adaptive discovery/fallback, runtime outputs,
 async errors, reconnect readiness and listener cleanup. The source checkout retains a separate development integration report; it is
 excluded from the public npm package. Importable examples are in `examples/`; select your
 own HA server and light before deploying them in a dev instance.
@@ -395,14 +466,14 @@ own HA server and light before deploying them in a dev instance.
 - A v0.1 raw state subscription receives all state changes and filters locally;
   one is created per SW Light node. It is removed on close, and HA's websocket
   resubscription handles reconnects. Sharing subscriptions is a v0.2 improvement.
-- Adaptive attributes are not standardized. Existing manual-control detection
-  and automatic brightness ownership require testing with the actual integration.
+- Adaptive discovery requires exposed configuration and exact light membership.
+  Use Advanced selection when discovery is unavailable; verify the installed profile.
 - Keep current depends on HA/device behavior. Color gamut correction and XY to
   other color-space conversion are not implemented. ON/OFF lights remain usable
   without brightness/color capabilities.
 
 Before live use, test server selection/autocomplete, each lamp capability,
-external brightness changes, threshold/explicit release, adaptive takeover,
+external brightness changes, threshold/explicit release, adaptive one-shot behavior,
 long transitions, deletion/unavailability, reconnect and repeated redeployment
 in your real editor with a development light. No live deployment, global config
 change, npm publication or GitHub release is part of this implementation.

package/examples/basic.json

@@ -139,7 +139,8 @@
         "sw-example-basic-events"
       ]
     ],
-    "action": "msg"
+    "action": "msg",
+    "overrideThreshold": 98
   },
   {
     "id": "sw-example-basic-result",

package/examples/manual-adaptive.json

@@ -11,7 +11,7 @@
     "type": "comment",
     "z": "sw-example-manual-adaptive",
     "name": "Select HA server + light in SW Light before deploy",
-    "info": "Adaptive apply is off by default. Select your Adaptive Lighting switch and enable optional color-only apply if desired.",
+    "info": "Adaptive Lighting is off by default. Enable the checkbox for automatic OFF to ON; keep the HA profile main switch off. Advanced selection is only needed when discovery is ambiguous or unavailable.",
     "x": 350,
     "y": 60,
     "wires": []
@@ -193,7 +193,8 @@
         "sw-example-manual-adaptive-events"
       ]
     ],
-    "action": "msg"
+    "action": "msg",
+    "overrideThreshold": 98
   },
   {
     "id": "sw-example-manual-adaptive-result",

package/lib/adaptive.js

@@ -2,38 +2,48 @@
 
 const { fault } = require('./light');
 
-function lights(state) {
-    const a = state?.attributes || {};
-    const list = a.configuration?.lights ?? a.lights;
-    return Array.isArray(list) ? list : [];
+// Main Adaptive Lighting switches expose configuration.lights in upstream
+// extra_state_attributes. Auxiliary switches do not. Never infer entity names.
+function candidates(c, states) {
+    return Object.values(states).filter(s => s.entity_id?.startsWith('switch.') &&
+        Array.isArray(s.attributes?.configuration?.lights) &&
+        s.attributes.configuration.lights.includes(c.entityId)).map(s => s.entity_id);
 }
 function select(c, states) {
     if (c.adaptiveEntity) return c.adaptiveEntity;
-    if (!c.adaptiveDiscover) return null;
-    const candidates = Object.values(states).filter(s => s.entity_id?.startsWith('switch.') &&
-        lights(s).includes(c.entityId) &&
-        (s.attributes?.configuration || Array.isArray(s.attributes?.manual_control)));
-    return candidates.length === 1 ? candidates[0].entity_id : null;
+    const matches = candidates(c, states);
+    return matches.length === 1 ? matches[0] : null;
 }
 function inspect(c, states) {
-    const entityId = select(c, states), state = entityId ? states[entityId] : null;
-    const a = state?.attributes || {};
-    // Conservatively respect either color-specific or aggregate manual control.
-    const manual = [a.manual_control, a.manual_control_color].some(list => Array.isArray(list) && list.includes(c.entityId));
-    return { entity_id: entityId, active: c.colorMode === 'adaptive' && state?.state === 'on',
-        manual_control: manual, state: state?.state ?? null };
+    const matches = candidates(c, states), entityId = select(c, states);
+    const state = entityId ? states[entityId] : null;
+    return { entity_id: entityId, active: c.adaptiveEnabled && state?.state === 'off',
+        state: state?.state ?? null, candidates: matches };
 }
 async function apply(adapter, c, command) {
-    if (c.colorMode !== 'adaptive' || !c.adaptiveApply || !command.turningOn || command.explicitColor) return { applied: false };
+    if (!command.adaptiveEnabled || !command.offToOn || command.source !== 'automatic' || command.explicitColor) {
+        return { applied: false, reason: 'not_requested' };
+    }
+    if (!command.supportsTemperature) return { applied: false, reason: 'unsupported_color_temperature' };
     const info = inspect(c, adapter.states());
-    if (!info.entity_id) throw fault('Select an Adaptive Lighting switch; discovery found no unique match', 'unsupported');
-    if (!info.active) return { applied: false, reason: 'switch_not_on' };
-    if (c.adaptiveRespectManual && info.manual_control) return { applied: false, reason: 'manual_control' };
-    if (!adapter.services()?.adaptive_lighting?.apply) throw fault('Adaptive Lighting apply service is unavailable', 'unsupported');
+    const fail = (reason, message) => {
+        const error = fault(message, 'warning'); error.reason = reason; throw error;
+    };
+    if (!info.entity_id) fail(info.candidates.length > 1 ? 'ambiguous_configuration' : 'configuration_missing',
+        'Adaptive Lighting: no unique profile for this light; select a profile under Advanced.');
+    if (!['on', 'off'].includes(info.state)) fail('profile_unavailable', 'Adaptive Lighting profile is unavailable.');
+    // A running profile can intercept ON and continuously adapt brightness/color.
+    // One-shot apply also works with the main switch off, without installing listeners.
+    if (info.state !== 'off') fail('profile_running', 'Turn off the Adaptive Lighting main switch to use it as a one-shot profile.');
+    const configuration = adapter.states()[info.entity_id]?.attributes?.configuration;
+    if (configuration?.sleep_rgb_or_color_temp === 'rgb_color') fail('profile_uses_rgb',
+        'Adaptive Lighting profile uses RGB sleep color; choose a color-temperature sleep profile.');
+    if (!adapter.services()?.adaptive_lighting?.apply) fail('service_unavailable', 'Adaptive Lighting apply action is unavailable.');
     await adapter.call('adaptive_lighting', 'apply', {
         entity_id: info.entity_id, lights: [c.entityId], adapt_brightness: false,
-        adapt_color: true, turn_on_lights: false
+        adapt_color: true, prefer_rgb_color: false, turn_on_lights: true,
+        transition: command.data.transition ?? 0
     });
-    return { applied: true };
+    return { applied: true, entity_id: info.entity_id };
 }
-module.exports = { select, inspect, apply };
+module.exports = { candidates, select, inspect, apply };

package/lib/light.js

@@ -3,10 +3,9 @@
 const DEFAULTS = Object.freeze({
     action: 'msg',
     brightnessPct: 94, autoMaxPct: 94, minPct: 1, transitionOn: 1,
-    transitionOff: 1, manualOverride: true, overrideThreshold: 100,
-    overrideStrategy: 'threshold', colorMode: 'adaptive', kelvin: 2700,
-    mired: 370, fixedColor: '#ffffff', adaptiveEntity: '',
-    adaptiveDiscover: true, adaptiveApply: false, adaptiveRespectManual: true
+    transitionOff: 1, manualOverride: true, overrideThreshold: 98,
+    overrideStrategy: 'threshold', adaptiveEnabled: false, colorMode: 'keep', kelvin: 2700,
+    mired: 370, fixedColor: '#ffffff', adaptiveEntity: ''
 });
 const COLOR_KEYS = ['color_temp_kelvin', 'color_temp', 'rgbww_color', 'rgbw_color',
     'rgb_color', 'hs_color', 'xy_color', 'color_name'];
@@ -34,6 +33,11 @@ function boolean(value, name) {
 }
 function config(raw) {
     const c = { ...DEFAULTS, ...raw };
+    if (own(raw, 'adaptiveApply')) boolean(raw.adaptiveApply, 'adaptiveApply');
+    // Preserve opt-in from legacy flows; inactive legacy adaptive mode stays off.
+    c.adaptiveEnabled = own(raw, 'adaptiveEnabled') ? boolean(raw.adaptiveEnabled, 'adaptiveEnabled') :
+        raw.colorMode === 'adaptive' && boolean(raw.adaptiveApply ?? false, 'adaptiveApply');
+    if (c.colorMode === 'adaptive') c.colorMode = 'keep';
     if (!['on', 'off', 'toggle', 'msg'].includes(c.action)) throw fault('Invalid configured action');
     for (const key of ['brightnessPct', 'autoMaxPct', 'minPct', 'overrideThreshold']) {
         c[key] = number(c[key], key, key === 'minPct' || key === 'overrideThreshold' ? 1 : 0, 100);
@@ -42,9 +46,7 @@ function config(raw) {
         throw fault('Require minPct <= brightnessPct <= autoMaxPct');
     }
     for (const key of ['transitionOn', 'transitionOff']) c[key] = number(c[key], key, 0, 3600);
-    for (const key of ['manualOverride', 'adaptiveDiscover', 'adaptiveApply', 'adaptiveRespectManual']) {
-        c[key] = boolean(c[key], key);
-    }
+    c.manualOverride = boolean(c.manualOverride, 'manualOverride');
     if (c.manualOverride && c.overrideStrategy === 'threshold' && c.autoMaxPct >= c.overrideThreshold) {
         throw fault('Automatic maximum must be below the manual override threshold');
     }
@@ -138,6 +140,7 @@ function resolveAction(c, msg) {
 function plan(c, msg, state, overrideActive) {
     const action = resolveAction(c, msg);
     const source = msg.source ?? 'automatic';
+    const adaptiveEnabled = own(msg, 'adaptive_lighting') ? boolean(msg.adaptive_lighting, 'adaptive_lighting') : c.adaptiveEnabled;
     if (!['automatic', 'manual'].includes(source)) throw fault('msg.source must be automatic or manual');
     const turningOn = action === 'on' || (action === 'toggle' && state.state === 'off');
     const cap = capabilities(state), data = {}, unsupported = [];
@@ -180,8 +183,9 @@ function plan(c, msg, state, overrideActive) {
         for (const key of Object.keys(data)) if (key !== 'transition') delete data[key];
         if (!own(msg, 'transition') && cap.transition) data.transition = c.transitionOff;
     }
-    return { action, source, service: turningOn && !zero ? 'turn_on' : 'turn_off',
-        turningOn: turningOn && !zero, data, unsupported,
+    return { action, source, adaptiveEnabled, service: turningOn && !zero ? 'turn_on' : 'turn_off',
+        turningOn: turningOn && !zero, offToOn: turningOn && !zero && state.state === 'off',
+        supportsTemperature: cap.modes.includes('color_temp'), data, unsupported,
         blocked: source === 'automatic' && overrideActive,
         explicitColor: colors.length > 0,
         ignoredConflicts: [...bKeys.slice(1), ...colors.slice(1).map(([key]) => key)] };
@@ -192,7 +196,7 @@ function normalized(state, override, adaptive, action) {
         brightness: a.brightness ?? null, brightness_pct: Number.isFinite(a.brightness) ? Math.round(pct(a.brightness) * 10) / 10 : null,
         color_mode: a.color_mode ?? null, color_temp_kelvin: a.color_temp_kelvin ?? (a.color_temp ? Math.round(1000000 / a.color_temp) : null),
         color_temp: a.color_temp ?? null,
-        color: Object.fromEntries(['rgb_color','rgbw_color','rgbww_color','hs_color','xy_color'].filter(k => a[k] !== undefined).map(k => [k, [...a[k]]])),
+        color: Object.fromEntries(['rgb_color','rgbw_color','rgbww_color','hs_color','xy_color'].filter(k => Array.isArray(a[k])).map(k => [k, [...a[k]]])),
         manual_override: override, adaptive_lighting: adaptive, action,
         observed_at: state?.last_updated ?? null };
 }

package/nodes/sw-light.html

@@ -26,20 +26,31 @@
             minPct: { value: 1, validate: numeric('minPct') },
             transitionOn: { value: 1, validate: numeric('transitionOn') },
             transitionOff: { value: 1, validate: numeric('transitionOff') },
-            manualOverride: { value: true }, overrideThreshold: { value: 100, validate: numeric('overrideThreshold') },
-            overrideStrategy: { value: 'threshold' }, colorMode: { value: 'adaptive' },
+            manualOverride: { value: true }, overrideThreshold: { value: 98, validate: numeric('overrideThreshold') },
+            overrideStrategy: { value: 'threshold' }, colorMode: { value: 'keep' },
+            adaptiveEnabled: { value: false },
             kelvin: { value: 2700, validate: numeric('kelvin') }, mired: { value: 370, validate: numeric('mired') },
             fixedColor: { value: '#ffffff', validate: v => /^#[0-9a-f]{6}$/i.test(v) },
             adaptiveEntity: { value: '', validate: v => !v || /^switch\.[a-z0-9_]+$/.test(v) },
-            adaptiveDiscover: { value: true }, adaptiveApply: { value: false }, adaptiveRespectManual: { value: true }
         },
         oneditprepare: function () {
+            if (this.colorMode === 'adaptive') {
+                $('#node-input-colorMode').val('keep');
+                $('#node-input-adaptiveEnabled').prop('checked', this.adaptiveApply === true);
+            }
             let states = {}, request, generation = 0;
             const entity = $('#node-input-entityId'), adaptive = $('#node-input-adaptiveEntity');
+            function modesForLight() { return states[entity.val()]?.attributes?.supported_color_modes || []; }
             function update() {
                 const mode = $('#node-input-colorMode').val();
                 $('.sw-color-row').hide();
                 $('.sw-color-' + mode).show();
+                $('.sw-adaptive-row').toggle($('#node-input-adaptiveEnabled').prop('checked'));
+                const profiles = Object.values(states).filter(s => s.entity_id.startsWith('switch.') &&
+                    Array.isArray(s.attributes?.configuration?.lights) && s.attributes.configuration.lights.includes(entity.val()));
+                $('#sw-adaptive-info').text(modesForLight().includes('color_temp') ?
+                    (profiles.length === 1 ? 'Profile found. Keep its main switch off for one-shot use.' :
+                        'No unique profile found. Select a profile under Advanced.') : 'This light has no known color-temperature support. Normal ON still works.');
                 $('.sw-override-row').toggle($('#node-input-manualOverride').prop('checked'));
                 $('.sw-threshold-row').toggle($('#node-input-manualOverride').prop('checked') && $('#node-input-overrideStrategy').val() === 'threshold');
                 const s = states[entity.val()], modes = s && s.attributes && s.attributes.supported_color_modes;
@@ -52,6 +63,7 @@
                 return function (req, respond) {
                     const term = req.term.toLowerCase();
                     respond(Object.values(states).filter(s => s.entity_id.startsWith(domain + '.') &&
+                        (domain !== 'switch' || s.attributes?.configuration) &&
                         (s.entity_id.toLowerCase().includes(term) || String(s.attributes.friendly_name || '').toLowerCase().includes(term)))
                         .slice(0,100).map(s => ({ label: (s.attributes.friendly_name || s.entity_id) + ' (' + s.entity_id + ')', value: s.entity_id })));
                 };
@@ -71,12 +83,12 @@
                     .fail(function (_xhr, status) { if (status !== 'abort' && token === generation) $('#sw-capabilities').text('Server must be deployed and connected. Entity IDs can also be entered directly.'); });
             }
             $('#node-input-server').on('change.swLight', load);
-            $('#node-input-colorMode, #node-input-manualOverride, #node-input-overrideStrategy, #node-input-entityId').on('change.swLight', update);
+            $('#node-input-colorMode, #node-input-adaptiveEnabled, #node-input-manualOverride, #node-input-overrideStrategy, #node-input-entityId').on('change.swLight', update);
             entity.on('focus.swLight', function () { entity.autocomplete('search', entity.val()); });
             adaptive.on('focus.swLight', function () { adaptive.autocomplete('search', adaptive.val()); });
             this._swCleanup = function () {
                 generation++; if (request) request.abort();
-                $('#node-input-server, #node-input-colorMode, #node-input-manualOverride, #node-input-overrideStrategy, #node-input-entityId, #node-input-adaptiveEntity').off('.swLight');
+                $('#node-input-server, #node-input-colorMode, #node-input-adaptiveEnabled, #node-input-manualOverride, #node-input-overrideStrategy, #node-input-entityId, #node-input-adaptiveEntity').off('.swLight');
                 entity.autocomplete('destroy'); adaptive.autocomplete('destroy');
                 delete this._swCleanup;
             };
@@ -108,15 +120,16 @@
         <p class="sw-override-row">Automatic commands pause during override. Manual commands use <code>msg.source = "manual"</code>.</p>
     </fieldset>
     <fieldset><legend>Color</legend>
-        <div class="form-row"><label for="node-input-colorMode">Mode</label><select id="node-input-colorMode"><option value="adaptive">Adaptive Lighting</option><option value="keep">Keep current</option><option value="kelvin">Fixed Kelvin</option><option value="mired">Fixed mired</option><option value="default">Lamp default</option><option value="color">Fixed color</option></select></div>
+        <div class="form-row"><label for="node-input-colorMode">Mode</label><select id="node-input-colorMode"><option value="keep">Keep current</option><option value="kelvin">Fixed Kelvin</option><option value="mired">Fixed mired</option><option value="default">Lamp default</option><option value="color">Fixed color</option></select></div>
         <div class="form-row sw-color-row sw-color-kelvin"><label for="node-input-kelvin">Kelvin</label><input id="node-input-kelvin" type="number" min="1000" max="40000"></div>
         <div class="form-row sw-color-row sw-color-mired"><label for="node-input-mired">Mired</label><input id="node-input-mired" type="number" min="25" max="1000" step="0.1"></div>
         <div class="form-row sw-color-row sw-color-color"><label for="node-input-fixedColor">Color</label><input id="node-input-fixedColor" type="color"></div>
-        <div class="form-row sw-color-row sw-color-adaptive"><label for="node-input-adaptiveEntity">Adaptive switch</label><input id="node-input-adaptiveEntity" type="text" placeholder="Optional switch.entity_id"></div>
-        <div class="form-row sw-color-row sw-color-adaptive"><label for="node-input-adaptiveDiscover">Discover</label><input id="node-input-adaptiveDiscover" type="checkbox" style="width:auto"> From a unique light membership match</div>
-        <div class="form-row sw-color-row sw-color-adaptive"><label for="node-input-adaptiveApply">Apply on turn-on</label><input id="node-input-adaptiveApply" type="checkbox" style="width:auto"> Color only</div>
-        <div class="form-row sw-color-row sw-color-adaptive"><label for="node-input-adaptiveRespectManual">Respect manual</label><input id="node-input-adaptiveRespectManual" type="checkbox" style="width:auto"></div>
-        <p class="sw-color-row sw-color-adaptive">Ordinary turn-on sends no color. Adaptive Lighting owns color adaptation. Apply is optional and never clears its manual control.</p>
+        <div class="form-row"><label for="node-input-adaptiveEnabled">Adaptive Lighting</label><input id="node-input-adaptiveEnabled" type="checkbox" style="width:auto"> On / Off</div>
+        <p class="sw-adaptive-row" id="sw-adaptive-info"></p>
+        <details class="sw-adaptive-row"><summary>Advanced: profile selection</summary>
+            <div class="form-row"><label for="node-input-adaptiveEntity">Profile</label><input id="node-input-adaptiveEntity" type="text" placeholder="Automatic (unique light membership)"></div>
+            <p>Select only when automatic discovery is unavailable or ambiguous. The profile's main switch must be off.</p>
+        </details>
     </fieldset>
 </script>
 
@@ -125,8 +138,8 @@
     <h3>Inputs</h3>
     <dl class="message-properties"><dt>action <span class="property-type">string</span></dt><dd>Required with From msg: <code>on</code>, <code>off</code>, or <code>toggle</code>. Falls back to <code>msg.auto_light.action</code> when msg.action is absent. Fixed Action settings ignore message actions.</dd><dt class="optional">source <span class="property-type">string</span></dt><dd><code>automatic</code> (default) or <code>manual</code>.</dd><dt class="optional">brightness_pct <span class="property-type">number</span></dt><dd>0–100. Automatic brightness is capped at the configured maximum.</dd><dt class="optional">transition <span class="property-type">number</span></dt><dd>Fade seconds, 0–3600, if supported.</dd><dt class="optional">manual_override <span class="property-type">boolean</span></dt><dd>Latch/release override with <code>source: "manual"</code>.</dd></dl>
     <h3>Outputs</h3><ol><li>Original message plus <code>msg.sw_light</code>: last observed HA state, action, service data, and override/adaptive information.</li><li>Original message plus <code>msg.sw_light_event</code>: version, type, entity_id, timestamp, and details.</li></ol>
-    <h3>Details</h3><p>Default on brightness/max 94%, minimum 1%, fade 1s. ON at 100% (brightness 255) always blocks automatic ON, OFF and Toggle. 94%, 95% and 99% do not trigger this guard. Optional threshold/explicit overrides can also pause automation. Lowering brightness below the threshold releases its flag; turning off releases all override flags. Manual commands bypass the automatic maximum. Explicit flags require explicit release or off.</p>
+    <h3>Details</h3><p>Default on brightness/max 94%, minimum 1%, fade 1s. ON at 100% (brightness 255) always blocks automatic ON, OFF and Toggle. 94%, 95% and 99% do not trigger this guard. Threshold detection defaults to 98% (brightness 250 or above) and pauses automatic commands; explicit overrides can also pause automation. Lowering brightness below the threshold releases its flag; turning off releases all override flags. Manual commands bypass the automatic maximum. Explicit flags require explicit release or off.</p>
     <p>Top-level message properties override configuration. Brightness precedence: percent, byte, percent step, byte step. Color precedence: Kelvin, mired, RGBWW, RGBW, RGB, HS, XY, name. Invalid values produce errors; unsupported parameters emit an event and are omitted.</p>
-    <p>Adaptive mode sends no configured color. An explicit message color takes precedence and suppresses optional adaptive apply for that command. Keep current and lamp default both omit configured color and leave HA/device behavior in control.</p>
+    <p>Adaptive Lighting applies current color temperature once after automatic OFF → ON, with SW Light brightness and fade. Explicit message color wins; already-on brightness changes and manual commands never apply it. A unique profile is discovered automatically; Advanced selects a fallback. Keep its main switch off to prevent continuous control. Use a profile with color-temperature sleep color; RGB sleep profiles fall back with a warning. <code>msg.adaptive_lighting</code> overrides the checkbox for one command. Missing, ambiguous or running profiles emit a warning and retain normal configured color behavior. Keep current and lamp default both omit configured color and leave HA/device behavior in control.</p>
     <p>Requires HA contrib 0.80.3. See package README for full contracts, examples and compatibility limitations.</p>
 </script>

package/nodes/sw-light.js

@@ -11,7 +11,7 @@ module.exports = function register(RED, adapterFactory = createAdapter) {
         const node = this;
         node.log?.(`[SW Light debug] version=${require('../package.json').version} constructor=created serverIdPresent=${Boolean(raw.server)}`);
         let c, detector, adapter, closed = false, lastAvailability;
-        let queue = Promise.resolve(), startup = Promise.resolve();
+        let queue = Promise.resolve(), startup = Promise.resolve(), observerTimer;
         const protectedAtFullBrightness = state => state?.state === 'on' && state.attributes?.brightness === 255;
         const overrideActive = state => detector.active || protectedAtFullBrightness(state);
         function event(type, detail = {}, msg = {}, send = node.send.bind(node)) {
@@ -34,11 +34,11 @@ module.exports = function register(RED, adapterFactory = createAdapter) {
                 if (lastAvailability !== availability) event('unavailable', { reason: availability });
             } else {
                 const active = overrideActive(state);
-                const info = light.normalized(state, active, c.colorMode === 'adaptive', 'state_changed');
+                const info = light.normalized(state, active, c.adaptiveEnabled, 'state_changed');
                 let text = active ? 'MANUAL' : `AUTO · ${info.state.toUpperCase()}`;
                 if (info.state === 'on' && info.brightness_pct !== null) text += ` · ${info.brightness_pct}%`;
                 if (info.state === 'on' && info.color_temp_kelvin) text += ` · ${info.color_temp_kelvin}K`;
-                if (info.state === 'on' && c.colorMode === 'adaptive') text += ' · adaptive';
+                if (info.state === 'on' && c.adaptiveEnabled) text += ' · adaptive';
                 node.status({ fill: active ? 'yellow' : info.state === 'on' ? 'green' : 'grey', shape: 'dot', text });
             }
             lastAvailability = availability;
@@ -60,12 +60,26 @@ module.exports = function register(RED, adapterFactory = createAdapter) {
             });
             connection(adapter.connected());
         }
+        function startObserving() {
+            if (closed || node.swLightError) return;
+            startup = Promise.resolve().then(async () => {
+                if (!adapter) startAdapter();
+                if (adapter.resolve) await adapter.resolve();
+            }).catch(error => {
+                if (closed) return;
+                event(error.eventType || 'error', { message: error.message, phase: 'state_subscription' });
+                observerTimer = setTimeout(startObserving, 1000);
+                observerTimer.unref?.();
+            });
+        }
         try {
             c = light.config(raw);
             detector = new light.Override(c);
-            // No HA module/client resolution during Flow.start. Startup order
-            // cannot permanently disable this node; first input resolves HA.
+            // Defer provider resolution until after Flow.start. Observe even
+            // before this node's first command; retry temporary startup failures.
             node.status({ fill: 'red', shape: 'ring', text: 'HA NOT READY' });
+            observerTimer = setTimeout(startObserving, 0);
+            observerTimer.unref?.();
         } catch (error) {
             node.status({ fill: 'red', shape: 'ring', text: 'CONFIG ERROR' });
             node.error(error.message);
@@ -107,15 +121,23 @@ module.exports = function register(RED, adapterFactory = createAdapter) {
                     serviceCompleted = true;
                     if (closed) { done(); return; }
                     let adaptiveResult;
-                    try { adaptiveResult = await adaptive.apply(adapter, c, command); }
-                    catch (error) { event(error.eventType || 'error', { message: error.message, phase: 'adaptive_apply', light_service_completed: true }, msg, send); }
+                    try {
+                        adaptiveResult = await adaptive.apply(adapter, c, command);
+                        if (adaptiveResult.reason === 'unsupported_color_temperature') event('unsupported',
+                            { phase: 'adaptive_apply', reason: adaptiveResult.reason, light_service_completed: true }, msg, send);
+                    }
+                    catch (error) {
+                        adaptiveResult = { applied: false, reason: error.reason || 'apply_failed' };
+                        event('warning', { message: error.message, reason: adaptiveResult.reason,
+                            phase: 'adaptive_apply', light_service_completed: true }, msg, send);
+                    }
                     if (closed) { done(); return; }
                     const current = adapter.state(c.entityId);
                     observe(current);
-                    send([{ ...msg, sw_light: { ...light.normalized(current, overrideActive(current), c.colorMode === 'adaptive', command.service),
+                    send([{ ...msg, sw_light: { ...light.normalized(current, overrideActive(current), command.adaptiveEnabled, command.service),
                         entity_id: c.entityId, source: command.source, requested_action: command.action,
                         service_data: command.data, ignored_conflicts: command.ignoredConflicts,
-                        state_confirmation: 'last_observed', adaptive: { ...adaptive.inspect(c, adapter.states()), ...adaptiveResult } } }, null]);
+                        state_confirmation: 'last_observed', adaptive: { ...adaptive.inspect({ ...c, adaptiveEnabled: command.adaptiveEnabled }, adapter.states()), ...adaptiveResult } } }, null]);
                     const level = command.data.brightness === undefined ? '' : ` · ${Math.round(light.pct(command.data.brightness))}%`;
                     node.status({ fill: command.source === 'manual' ? 'yellow' : command.turningOn ? 'green' : 'grey', shape: 'dot',
                         text: `${command.source === 'manual' ? 'MANUAL' : 'AUTO'} · ${command.turningOn ? 'ON' : 'OFF'}${level}` });
@@ -132,6 +154,7 @@ module.exports = function register(RED, adapterFactory = createAdapter) {
         });
         node.on('close', (_removed, done) => {
             closed = true;
+            clearTimeout(observerTimer);
             Promise.resolve().then(() => adapter?.close()).then(() => startup).catch(() => {}).finally(() => done());
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johanwistbacka/node-red-contrib-sw-light",
-  "version": "0.1.4",
+  "version": "0.1.8",
   "description": "Home Assistant light control with automatic brightness limits and manual override",
   "license": "MIT",
   "keywords": [