feat(circadian): pre-warm capability auto-detection + new flow card

Adds a wizard step during pairing that briefly cycles each light to
detect which of dim/light_temperature/light_hue/light_saturation can be
safely pre-set while off. Per-capability results stored in
config.devices[].prewarmSupport and respected by applyTargetToDevice;
the master prewarmBeforeOn toggle now serves as fallback for untested
caps only. Re-test available from Repair on each managed light.

Probe uses makeCapabilityInstance for realtime onoff/value tracking
(getDevice cache was not reliable after setCapabilityValue), with
ensureOff() that retries up to 3 times and verifies via realtime state
before continuing to the next capability test.

Candidate filter now includes virtualClass==='light' (catches Hue/Z2M
sockets) and any device with a setable dim/temp/hue/saturation cap
(catches Z-Wave dimmer modules).

New flow action clg_turn_on_member with autocomplete dropdown of group
members; sets temp/colour/dim then onoff in one step to avoid the
brief flash at the previous brightness on lamps without pre-warm.

i18n strings for all new UI in 11 locales.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Tiwas

HOMEY_COMMUNITY_LISTING.md

@@ -1,11 +1,11 @@
 URL: https://community.homey.app/t/app-smart-components-toolkit-was-boolean-toolbox-create-advanced-logic-with-simple-formulas/143906
 
-Title: [APP] Smart (Components) Toolkit (was: Boolean Toolbox) - Create advanced logic with simple formulas
+Title: [APP] Smart (Components) Toolkit (was: Boolean Toolbox) - Create advanced logic with simple formulas [v1.9.2 stable / **v1.10.2 test — NEW: Circadian pre-warm auto-detection**]
 
 Content:
 ![xlarge|690x483](upload://iSxhJPUltgcgPQ7gy4z5iisCv5F.jpeg)
 
-# Smart (Components) Toolkit — v1.9.2 stable / **v1.10.0 test**
+# Smart (Components) Toolkit — v1.9.2 stable / **v1.10.2 test**
 
 > **📚 Full Documentation:** https://tiwas.github.io/SmartComponentsToolkit/
 
@@ -15,10 +15,18 @@ Replace complex flow networks with powerful logic devices controlled by dynamic
 
 ---
 
-## 🧪 New in test (v1.10.0): Circadian Light Group
+## 🧪 New in test (v1.10.2): Circadian Light Group
 
 A virtual **light device** that adjusts brightness and color temperature for a group of real lights — automatically following a circadian rhythm. Available now in the [test channel](https://homey.app/a/no.tiwas.booleantoolbox/test/) only; the stable channel still ships v1.9.2 without this device.
 
+### 🆕 New in v1.10.2
+
+- **Pre-warm auto-detection during pairing.** A new wizard step tests each light by briefly cycling it off, pre-setting `dim` / `light_temperature` / `light_hue` / `light_saturation`, then turning back on to verify the value persisted. Each capability is marked ✓/✗ per device. No more guessing whether a lamp tolerates pre-warming — and no more turning lights on with the wrong colour.
+- **Re-test from Repair.** Each managed light has a "Test pre-warm" button so you can re-run the test after firmware updates or when adding new devices.
+- **Smarter candidate filter.** Lights registered as `socket` with `virtualClass: light` (Hue/Z2M-bridged lamps) and Z-Wave dimmer modules with a `dim` capability are now picked up automatically.
+- **New flow action: "Turn on light at current circadian level."** Pick any member of the group from a dropdown — the action sets temperature/colour and dim, then turns the light on, all in one step. Avoids the brief flash at the previous brightness for lamps that don't support pre-warming.
+- **Master "Prewarm before on" toggle** is now a fallback for untested capabilities only; tested capabilities use the actual test result.
+
 **Why use it?**
 - Bright cool light during the day, warm dim light in the evening, deep red at night to preserve melatonin and night vision.
 - Works at any latitude — pick clock times, solar events, or lux-sensor thresholds per phase.
@@ -46,17 +54,17 @@ Choose how the device knows how bright it is outside:
 - **Open-Meteo / MET.no** (radiation-based estimate)
 - **External value** pushed from a Flow
 
-### 24 new flow cards
+### 25 new flow cards
 
 **Triggers**: phase changed, red mode started/ended, paused/resumed, turned on/off, target changed, error, outdoor light requested. Plus an **app-level "Solar event occurred"** card with all 14 events + offset, usable from any flow.
 
 **Conditions**: is in phase, red mode active, is paused, is on.
 
-**Actions**: pause (sec/min/hour), pause until time, pause until solar event, resume, turn on/off/toggle, set red threshold, **apply temporary state** (override dim/temp/saturation/red — restored on next tick, perfect for testing or quick "moods"), **force red mode** (with optional duration), apply now, set outdoor lux.
+**Actions**: pause (sec/min/hour), pause until time, pause until solar event, resume, turn on/off/toggle, set red threshold, **apply temporary state** (override dim/temp/saturation/red — restored on next tick, perfect for testing or quick "moods"), **force red mode** (with optional duration), apply now, set outdoor lux, **turn on light at current circadian level** (pick any group member from dropdown).
 
 <a href="https://tiwas.github.io/SmartComponentsToolkit/docs/circadian-light-group.html" target="_blank">→ Read full Circadian Light Group guide</a>
 
-<a href="https://homey.app/a/no.tiwas.booleantoolbox/test/" target="_blank">→ Install v1.10.0 test version</a>
+<a href="https://homey.app/a/no.tiwas.booleantoolbox/test/" target="_blank">→ Install v1.10.2 test version</a>
 
 ---
 
@@ -125,7 +133,7 @@ THEN: Wait until coffee machine temperature ≥ 90°C (timeout 5 min)
 ## Installation and Links
 
 * **Homey App Store (stable v1.9.2):** <a href="https://homey.app/en-no/app/no.tiwas.booleantoolbox/" target="_blank">Install Smart (Components) Toolkit</a>
-* **Test channel (v1.10.0 — Circadian Light Group):** <a href="https://homey.app/a/no.tiwas.booleantoolbox/test/" target="_blank">Install test version</a>
+* **Test channel (v1.10.2 — Circadian Light Group + pre-warm auto-detection):** <a href="https://homey.app/a/no.tiwas.booleantoolbox/test/" target="_blank">Install test version</a>
 * **GitHub Repo:** <a href="https://github.com/tiwas/SmartComponentsToolkit" target="_blank">github.com/tiwas/SmartComponentsToolkit</a>
 * **Online Emulator:** <a href="https://tiwas.github.io/SmartComponentsToolkit/tools/emulator.html" target="_blank">Boolean Logic Emulator</a>
 * **Formula Builder:** <a href="https://tiwas.github.io/SmartComponentsToolkit/tools/formula-builder.html" target="_blank">Formula Builder</a>

no.tiwas.booleantoolbox/.homeychangelog.json

@@ -49,5 +49,11 @@
   },
   "1.10.0": {
     "en": "Circadian Light Group - control lights to suit your circadian needs"
+  },
+  "1.10.1": {
+    "en": "Added translations"
+  },
+  "1.10.2": {
+    "en": "More user config options + test capabilities"
   }
 }

no.tiwas.booleantoolbox/.homeycompose/flow/actions/clg_turn_on_member.json

@@ -0,0 +1,30 @@
+{
+  "id": "clg_turn_on_member",
+  "title": {
+    "en": "Turn on light at current circadian level",
+    "no": "Slå på lys med gjeldende dognrytmeniva"
+  },
+  "hint": {
+    "en": "Sets temperature/color and dim, then turns the light on. Avoids the brief flash at the previous brightness.",
+    "no": "Setter temperatur/farge og dim, deretter skrur lyset paa. Unngaar kort blink ved forrige lysstyrke."
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    },
+    {
+      "type": "autocomplete",
+      "name": "member",
+      "title": {
+        "en": "Light",
+        "no": "Lys"
+      }
+    }
+  ],
+  "titleFormatted": {
+    "en": "Turn on [[member]] at current circadian level",
+    "no": "Slå på [[member]] med gjeldende dognrytmeniva"
+  }
+}

no.tiwas.booleantoolbox/drivers/circadian-light-group/device.js

@@ -349,15 +349,17 @@ class CircadianLightGroupDevice extends Homey.Device {
     const maxDim = Number.isFinite(Number(item.maxDim)) ? Number(item.maxDim) : 1;
     const canUseRed = item.redModeAllowed !== false;
     const mode = target.mode === 'color' && canUseRed ? 'color' : 'temperature';
+    const prewarm = item.prewarmSupport || {};
+    const prewarmAllowed = (capId) => isOn || prewarm[capId] !== false;
 
     if (caps.light_mode?.setable && caps.light_mode.value !== mode) {
       result.push(['light_mode', mode]);
     }
 
     if (mode === 'color' && caps.light_hue?.setable && caps.light_saturation?.setable) {
-      result.push(['light_hue', target.hue]);
-      result.push(['light_saturation', target.saturation]);
-    } else if (caps.light_temperature?.setable) {
+      if (prewarmAllowed('light_hue')) result.push(['light_hue', target.hue]);
+      if (prewarmAllowed('light_saturation')) result.push(['light_saturation', target.saturation]);
+    } else if (caps.light_temperature?.setable && prewarmAllowed('light_temperature')) {
       const temperature = item.invertTemperature === true ? 1 - target.temperature : target.temperature;
       result.push(['light_temperature', clamp(temperature)]);
     }
@@ -489,6 +491,59 @@ class CircadianLightGroupDevice extends Homey.Device {
     };
   }
 
+  async onFlowTurnOnMember(args) {
+    const memberId = args.member?.id;
+    if (!memberId) throw new Error('No light selected');
+
+    const config = this.getConfig();
+    const item = (Array.isArray(config.devices) ? config.devices : []).find(d => d.id === memberId);
+    if (!item) throw new Error('Light is not a member of this group');
+
+    let outdoor;
+    try {
+      outdoor = await this.outdoorProvider.getOutdoorLight(config.outdoorLight || {});
+    } catch (error) {
+      outdoor = await this.outdoorProvider.getAstronomical(config.outdoorLight || {}, new Date(), 'fallback');
+    }
+    const geo = this.getGeo();
+    const luxCrossings = await this.getStoreValue('luxCrossings') || {};
+    const target = calculateTarget(config.profile || {}, outdoor, new Date(), { ...geo, luxCrossings });
+    this.applyOverridesToTarget(target);
+
+    const apiDevice = await this.homey.app.api.devices.getDevice({ id: item.id });
+    const caps = apiDevice.capabilitiesObj || {};
+
+    const minDim = Number.isFinite(Number(item.minDim)) ? Number(item.minDim) : 0.05;
+    const maxDim = Number.isFinite(Number(item.maxDim)) ? Number(item.maxDim) : 1;
+    const canUseRed = item.redModeAllowed !== false;
+    const mode = target.mode === 'color' && canUseRed ? 'color' : 'temperature';
+
+    const writes = [];
+    if (caps.light_mode?.setable && caps.light_mode.value !== mode) {
+      writes.push(['light_mode', mode]);
+    }
+    if (mode === 'color' && caps.light_hue?.setable && caps.light_saturation?.setable) {
+      writes.push(['light_hue', target.hue]);
+      writes.push(['light_saturation', target.saturation]);
+    } else if (caps.light_temperature?.setable) {
+      const temperature = item.invertTemperature === true ? 1 - target.temperature : target.temperature;
+      writes.push(['light_temperature', clamp(temperature)]);
+    }
+    if (caps.dim?.setable) {
+      writes.push(['dim', clamp(target.dim, minDim, maxDim)]);
+    }
+
+    for (const [capability, value] of writes) {
+      await apiDevice.setCapabilityValue(capability, value);
+      await new Promise(resolve => setTimeout(resolve, APPLY_CAPABILITY_DELAY));
+    }
+
+    if (caps.onoff?.setable && caps.onoff.value !== true) {
+      await apiDevice.setCapabilityValue('onoff', true);
+    }
+    return true;
+  }
+
   // ---- Flow action handlers ----
 
   async onFlowApplyNow() {

no.tiwas.booleantoolbox/drivers/circadian-light-group/driver.compose.json

@@ -43,6 +43,9 @@
     {
       "id": "select_devices"
     },
+    {
+      "id": "test_capabilities"
+    },
     {
       "id": "edit_configuration"
     }
@@ -83,7 +86,8 @@
       { "id": "clg_toggle" },
       { "id": "clg_set_red_threshold" },
       { "id": "clg_apply_state" },
-      { "id": "clg_force_red_mode" }
+      { "id": "clg_force_red_mode" },
+      { "id": "clg_turn_on_member" }
     ]
   }
 }