WIP: add Circadian Light Group driver and run_test.ps1 helper

Adds new circadian-light-group driver with capabilities, flow cards,
pairing views, profile/outdoor-light libs, locale strings across all
languages, and a PowerShell helper to run "homey app run --remote"
that waits for a keypress before closing on exit.

Author: Tiwas

no.tiwas.booleantoolbox/.homeycompose/capabilities/clg_paused.json

@@ -0,0 +1,14 @@
+{
+  "type": "boolean",
+  "title": {
+    "en": "Paused",
+    "no": "Pauset"
+  },
+  "desc": {
+    "en": "True when circadian light adjustments are paused.",
+    "no": "Sann naar dognrytmejustering av lys er pauset."
+  },
+  "getable": true,
+  "setable": true,
+  "uiComponent": "toggle"
+}

no.tiwas.booleantoolbox/.homeycompose/capabilities/measure_outdoor_lux.json

@@ -0,0 +1,18 @@
+{
+  "type": "number",
+  "title": {
+    "en": "Outdoor Computed Lux",
+    "no": "Beregnet utendors lux"
+  },
+  "desc": {
+    "en": "The outdoor light value currently used by the circadian profile.",
+    "no": "Utelystallet som brukes av dognrytmeprofilen."
+  },
+  "getable": true,
+  "setable": false,
+  "uiComponent": "sensor",
+  "units": {
+    "en": "lx"
+  },
+  "decimals": 0
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "clg_apply_now",
+  "title": {
+    "en": "Apply current circadian profile",
+    "no": "Bruk gjeldende dognrytmeprofil"
+  },
+  "hint": {
+    "en": "Immediately applies the current circadian target to lights that are already on.",
+    "no": "Bruker gjeldende dognrytmemal umiddelbart paa lys som allerede er paa."
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    }
+  ],
+  "titleFormatted": {
+    "en": "Apply current circadian profile",
+    "no": "Bruk gjeldende dognrytmeprofil"
+  }
+}

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

@@ -0,0 +1,34 @@
+{
+  "id": "clg_pause",
+  "title": {
+    "en": "Pause circadian light group",
+    "no": "Pause dognrytme-lysgruppe"
+  },
+  "hint": {
+    "en": "Pauses automatic adjustments. Use minutes 0 to pause until resumed manually.",
+    "no": "Pauser automatiske justeringer. Bruk 0 minutter for pause til manuell gjenopptakelse."
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    },
+    {
+      "type": "number",
+      "name": "minutes",
+      "title": {
+        "en": "Minutes",
+        "no": "Minutter"
+      },
+      "placeholder": {
+        "en": "0",
+        "no": "0"
+      }
+    }
+  ],
+  "titleFormatted": {
+    "en": "Pause circadian light group for [[minutes]] minutes",
+    "no": "Pause dognrytme-lysgruppe i [[minutes]] minutter"
+  }
+}

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

@@ -0,0 +1,18 @@
+{
+  "id": "clg_resume",
+  "title": {
+    "en": "Resume circadian light group",
+    "no": "Gjenoppta dognrytme-lysgruppe"
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    }
+  ],
+  "titleFormatted": {
+    "en": "Resume circadian light group",
+    "no": "Gjenoppta dognrytme-lysgruppe"
+  }
+}

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

@@ -0,0 +1,54 @@
+{
+  "id": "clg_set_external_lux",
+  "title": {
+    "en": "Set outdoor computed lux",
+    "no": "Sett beregnet utendors lux"
+  },
+  "hint": {
+    "en": "Pushes an externally computed outdoor light value into the Circadian Light Group.",
+    "no": "Sender en eksternt beregnet utelysverdi til dognrytme-lysgruppen."
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    },
+    {
+      "type": "number",
+      "name": "lux",
+      "title": {
+        "en": "Outdoor computed lux",
+        "no": "Beregnet utendors lux"
+      }
+    },
+    {
+      "type": "number",
+      "name": "valid_minutes",
+      "title": {
+        "en": "Valid for minutes",
+        "no": "Gyldig i minutter"
+      },
+      "placeholder": {
+        "en": "15",
+        "no": "15"
+      }
+    },
+    {
+      "type": "text",
+      "name": "source",
+      "title": {
+        "en": "Source",
+        "no": "Kilde"
+      },
+      "placeholder": {
+        "en": "my-weather-flow",
+        "no": "min-vaerflow"
+      }
+    }
+  ],
+  "titleFormatted": {
+    "en": "Set outdoor computed lux to [[lux]] from [[source]] for [[valid_minutes]] minutes",
+    "no": "Sett beregnet utendors lux til [[lux]] fra [[source]] i [[valid_minutes]] minutter"
+  }
+}

no.tiwas.booleantoolbox/.homeycompose/flow/triggers/clg_error_occurred.json

@@ -0,0 +1,24 @@
+{
+  "id": "clg_error_occurred",
+  "title": {
+    "en": "Circadian light group error occurred",
+    "no": "Feil oppstod i dognrytme-lysgruppe"
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    }
+  ],
+  "tokens": [
+    {
+      "name": "error",
+      "type": "string",
+      "title": {
+        "en": "Error",
+        "no": "Feil"
+      }
+    }
+  ]
+}

no.tiwas.booleantoolbox/.homeycompose/flow/triggers/clg_outdoor_light_requested.json

@@ -0,0 +1,18 @@
+{
+  "id": "clg_outdoor_light_requested",
+  "title": {
+    "en": "Outdoor light value requested",
+    "no": "Utelysverdi forespurt"
+  },
+  "hint": {
+    "en": "Use this trigger with the 'Set outdoor computed lux' action when outdoorLight.provider is external_value.",
+    "no": "Bruk denne triggeren sammen med handlingen 'Sett beregnet utendors lux' naar outdoorLight.provider er external_value."
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    }
+  ]
+}

no.tiwas.booleantoolbox/.homeycompose/flow/triggers/clg_target_changed.json

@@ -0,0 +1,48 @@
+{
+  "id": "clg_target_changed",
+  "title": {
+    "en": "Circadian target changed",
+    "no": "Dognrytmemal endret"
+  },
+  "args": [
+    {
+      "type": "device",
+      "name": "device",
+      "filter": "driver_id=circadian-light-group"
+    }
+  ],
+  "tokens": [
+    {
+      "name": "phase",
+      "type": "string",
+      "title": {
+        "en": "Phase",
+        "no": "Fase"
+      }
+    },
+    {
+      "name": "dim",
+      "type": "number",
+      "title": {
+        "en": "Dim",
+        "no": "Dim"
+      }
+    },
+    {
+      "name": "temperature",
+      "type": "number",
+      "title": {
+        "en": "Temperature",
+        "no": "Temperatur"
+      }
+    },
+    {
+      "name": "outdoor_lux",
+      "type": "number",
+      "title": {
+        "en": "Outdoor lux",
+        "no": "Utendors lux"
+      }
+    }
+  ]
+}

no.tiwas.booleantoolbox/CircadianProfile.test.js

@@ -0,0 +1,50 @@
+'use strict';
+
+const { calculateTarget } = require('./lib/CircadianProfile');
+const { createOutdoorValue, estimateAstronomicalLux, estimateLuxFromRadiation, isFreshOutdoorValue } = require('./lib/OutdoorLightProvider');
+
+describe('CircadianProfile', () => {
+  test('returns day settings during the day plateau', () => {
+    const target = calculateTarget({}, null, new Date('2026-04-30T12:00:00'));
+
+    expect(target.phase).toBe('day');
+    expect(target.mode).toBe('temperature');
+    expect(target.dim).toBeCloseTo(1, 2);
+    expect(target.temperature).toBeCloseTo(0.85, 2);
+  });
+
+  test('uses red color mode at night', () => {
+    const target = calculateTarget({}, null, new Date('2026-04-30T23:30:00'));
+
+    expect(target.phase).toBe('night');
+    expect(target.mode).toBe('color');
+    expect(target.hue).toBe(0);
+    expect(target.saturation).toBe(1);
+  });
+
+  test('outdoor lux increases dim within configured limits', () => {
+    const dark = calculateTarget({}, { outdoorComputedLux: 0 }, new Date('2026-04-30T12:00:00'));
+    const bright = calculateTarget({}, { outdoorComputedLux: 20000 }, new Date('2026-04-30T12:00:00'));
+
+    expect(dark.outdoorDimFactor).toBeLessThan(bright.outdoorDimFactor);
+    expect(bright.dim).toBe(1);
+  });
+});
+
+describe('OutdoorLightProvider helpers', () => {
+  test('creates expiring external values', () => {
+    const value = createOutdoorValue(173, 'test', 15);
+
+    expect(value.outdoorComputedLux).toBe(173);
+    expect(value.source).toBe('test');
+    expect(isFreshOutdoorValue(value)).toBe(true);
+  });
+
+  test('estimates more lux from more radiation', () => {
+    expect(estimateLuxFromRadiation(200, 0)).toBeGreaterThan(estimateLuxFromRadiation(50, 0));
+  });
+
+  test('astronomical lux is zero-ish during night', () => {
+    expect(estimateAstronomicalLux(new Date('2026-01-15T00:00:00'), 60)).toBe(0);
+  });
+});