node-red-contrib-knx-ultimate 7.1.4 → 8.0.2

package/nodes/knxUltimate-config.js

@@ -31,10 +31,6 @@ let NODE_VERSION = 'unknown'
 try { NODE_VERSION = require('../package.json').version } catch (e) { /* empty */ }
 let KNX_ENGINE_VERSION = 'unknown'
 try { KNX_ENGINE_VERSION = require('knxultimate/package.json').version } catch (e) { /* empty */ }
-let MATTER_PACKAGE_VERSION = 'unknown'
-let Specification = { REVISION: 'unknown' }
-try { MATTER_PACKAGE_VERSION = require('@matter/main').version } catch (e) { /* empty */ }
-try { Specification = require('@matter/model').Specification } catch (e) { /* empty */ }
 
 // DATAPONT MANIPULATION HELPERS
 // ####################
@@ -204,7 +200,7 @@ const resolveHostAddress = async (hostname, lookup = dns.lookup) => {
 module.exports = (RED) => {
   // Log node and KNXUltimate engine versions once, at Node-RED startup.
   try {
-    RED.log.info(`KNXUltimate: node-red-contrib-knx-ultimate v${NODE_VERSION} (KNXUltimate engine v${KNX_ENGINE_VERSION}, Matter protocol ${Specification.REVISION}, matter.js v${MATTER_PACKAGE_VERSION})`)
+    RED.log.info(`KNXUltimate: node-red-contrib-knx-ultimate v${NODE_VERSION} (KNXUltimate engine v${KNX_ENGINE_VERSION})`)
   } catch (e) { /* empty */ }
 
   function knxUltimateConfigNode (config) {
@@ -1515,19 +1511,6 @@ module.exports = (RED) => {
                   }
                   _input.setNodeStatus({ fill: 'green', shape: 'dot', text: 'RAW', payload: _evt, GA: _dest, dpt: '', devicename: _src })
                   _input.handleSend(msg)
-                } else
-                // 21/10/2024 check wether is a HUE device
-                if (_input.type.includes('knxUltimateHue')) {
-                  const msg = {
-                    knx: {
-                      event: _evt,
-                      destination: _dest,
-                      rawValue: _rawValue,
-                      repeated: isRepeated,
-                      repeat: isRepeated
-                    }
-                  }
-                  _input.handleSend(msg)
                 } else if (_input.hasOwnProperty('isSceneController')) { // 19/03/2020 in the middle of coronavirus. Whole italy is red zone, closed down. Scene Controller implementation
                   // 12/08/2020 Check wether is a learn (save) command or a activate (play) command.
                   if (_dest === _input.topic || _dest === _input.topicSave) {

package/nodes/knxUltimate.html

@@ -1173,12 +1173,6 @@ return msg;`
 </script>
 
 <script type="text/html" data-template-name="knxUltimate">
-    <div class="form-row knx-ultimate-v8-upgrade-row">
-        <button type="button" class="red-ui-button knx-ultimate-v8-upgrade-button" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button_title">
-            <i class="fa fa-arrow-circle-up" aria-hidden="true"></i>
-            <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button"></span>
-        </button>
-    </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -1279,6 +1273,7 @@ return msg;`
                         </label>
                         <select id="node-input-buttonMode" style="width:220px;">
                             <option value="toggle" data-i18n="knxUltimate.button.mode_toggle"></option>
+                            <option value="read" data-i18n="knxUltimate.button.mode_read"></option>
                             <option value="value" data-i18n="knxUltimate.button.mode_value"></option>
                         </select>
                     </div>

package/nodes/knxUltimateIoTBridge.html

@@ -958,12 +958,6 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateIoTBridge">
-    <div class="form-row knx-ultimate-v8-upgrade-row">
-        <button type="button" class="red-ui-button knx-ultimate-v8-upgrade-button" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button_title">
-            <i class="fa fa-arrow-circle-up" aria-hidden="true"></i>
-            <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button"></span>
-        </button>
-    </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -1075,14 +1069,6 @@
 </script>
 
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 # MQTT Home Assistant - IoT
 
 Configure bidirectional maps between KNX group addresses and IoT backends such as MQTT, REST APIs or Modbus registers. Each mapping can scale values, format payloads and define single direction behaviour.

package/nodes/knxUltimateLegacyMigration.js

@@ -0,0 +1,75 @@
+'use strict'
+
+// Runtime-only placeholders for node types removed in KNX Ultimate 8. Keeping
+// the types registered lets Node-RED start the rest of each flow after a direct
+// upgrade. There is deliberately no matching editor HTML: the editor imports
+// these entries as `unknown`, retaining the saved object in `_orig` for the
+// version 8 recovery plugin to convert.
+module.exports = function (RED) {
+  const utilityTypes = [
+    'knxUltimateAlerter',
+    'knxUltimateAutoResponder',
+    'knxUltimateDateTime',
+    'knxUltimateWatchDog',
+    'knxUltimateGlobalContext',
+    'knxUltimateLogger',
+    'knxUltimateStaircase',
+    'knxUltimateGarage',
+    'knxUltimateSceneController',
+    'knxUltimateLoadControl',
+    'knxUltimateHATranslator'
+  ]
+  const hueTypes = [
+    'hue-config',
+    'knxUltimateHueController',
+    'knxUltimateHueLight',
+    'knxUltimateHuePlug',
+    'knxUltimateHueButton',
+    'knxUltimateHueTapDial',
+    'knxUltimateHueMotion',
+    'knxUltimateHueAreaMotion',
+    'knxUltimateHueCameraMotion',
+    'knxUltimateHueContactSensor',
+    'knxUltimateHueLightSensor',
+    'knxUltimateHueTemperatureSensor',
+    'knxUltimateHueHumiditySensor',
+    'knxUltimateHueScene',
+    'knxUltimateHueBattery',
+    'knxUltimateHueZigbeeConnectivity',
+    'knxUltimateHuedevice_software_update'
+  ]
+  const matterTypes = [
+    'matter-config',
+    'matterbridge-config',
+    'knxUltimateMatterControllerDevice',
+    'knxUltimateMatterBridge',
+    'knxUltimateMatterLight'
+  ]
+  const aiTypes = [
+    'knxUltimateAI',
+    'knxUltimateAIHomeAssistant'
+  ]
+  const credentials = {
+    'hue-config': {
+      username: { type: 'password' },
+      clientkey: { type: 'password' }
+    },
+    knxUltimateAI: {
+      llmApiKey: { type: 'password' }
+    },
+    knxUltimateMatterControllerDevice: {
+      doorLockPin: { type: 'password' }
+    }
+  }
+
+  function register (type) {
+    function LegacyMigrationPlaceholder (config) {
+      RED.nodes.createNode(this, config)
+      if (typeof this.status === 'function') this.status({ fill: 'yellow', shape: 'ring', text: 'migration required' })
+    }
+    if (credentials[type]) RED.nodes.registerType(type, LegacyMigrationPlaceholder, { credentials: credentials[type] })
+    else RED.nodes.registerType(type, LegacyMigrationPlaceholder)
+  }
+
+  utilityTypes.concat(hueTypes, matterTypes, aiTypes).forEach(register)
+}

package/nodes/knxUltimateMultiRouting.html

@@ -55,12 +55,6 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateMultiRouting">
-    <div class="form-row knx-ultimate-v8-upgrade-row">
-        <button type="button" class="red-ui-button knx-ultimate-v8-upgrade-button" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button_title">
-            <i class="fa fa-arrow-circle-up" aria-hidden="true"></i>
-            <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button"></span>
-        </button>
-    </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -134,4 +128,4 @@
         <label for="node-input-tunnelMaxSessions"><i class="fa fa-users"></i> <span data-i18n="knxUltimateMultiRouting.properties.tunnelMaxSessions"></span></label>
         <input type="text" id="node-input-tunnelMaxSessions" placeholder="1">
     </div>
-</script>
+</script>

package/nodes/knxUltimateRouterFilter.html

@@ -58,12 +58,6 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateRouterFilter">
-    <div class="form-row knx-ultimate-v8-upgrade-row">
-        <button type="button" class="red-ui-button knx-ultimate-v8-upgrade-button" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button_title">
-            <i class="fa fa-arrow-circle-up" aria-hidden="true"></i>
-            <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button"></span>
-        </button>
-    </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -141,4 +135,4 @@
         <label for="node-input-srcRewriteRules"><i class="fa fa-random"></i> <span data-i18n="knxUltimateRouterFilter.properties.srcRewriteRules"></span></label>
         <textarea style="width:100%; height:90px;" id="node-input-srcRewriteRules" data-i18n="[placeholder]knxUltimateRouterFilter.placeholder.srcRewriteRules"></textarea>
     </div>
-</script>
+</script>

package/nodes/knxUltimateUtility.html

@@ -288,12 +288,6 @@
 </style>
 
 <script type="text/html" data-template-name="knxUltimateUtility">
-    <div class="form-row knx-ultimate-v8-upgrade-row">
-        <button type="button" class="red-ui-button knx-ultimate-v8-upgrade-button" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button_title">
-            <i class="fa fa-arrow-circle-up" aria-hidden="true"></i>
-            <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button"></span>
-        </button>
-    </div>
   <div class="form-row" id="knx-utility-migration-row" style="display:none">
     <button type="button" class="red-ui-button knx-utility-migrate-flow" data-i18n="[title]knxUltimateUtility.migration_button_title"><i class="fa fa-exchange"></i> <span data-i18n="knxUltimateUtility.migration_button"></span></button>
   </div>

package/nodes/knxUltimateViewer.html

@@ -113,12 +113,6 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateViewer">
-    <div class="form-row knx-ultimate-v8-upgrade-row">
-        <button type="button" class="red-ui-button knx-ultimate-v8-upgrade-button" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button_title">
-            <i class="fa fa-arrow-circle-up" aria-hidden="true"></i>
-            <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button"></span>
-        </button>
-    </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/locales/de/knxUltimate-config.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimate-config">
-### Upgrade auf KNX Ultimate 8
-
-Version 7 zeigt oben in diesem Editor eine kleine Schaltfläche **Auf v8 aktualisieren**. Sie lädt eine Flow-Sicherung herunter, installiert die benötigten HUE-/Matter-Pakete, konvertiert kompatible Knoten, führt ein vollständiges Deploy aus, prüft die gespeicherten Flows und installiert Version 8. Starten Sie den Node-RED-Dienst anschließend wie aufgefordert neu; nur den Browser neu zu laden genügt nicht. Bisherige KNX-AI-Knoten stoppen den automatischen Vorgang.
-
-[Vollständige Upgrade-Anleitung](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/de-Upgrade-to-v8)
-
-<br/>
-
 # KNX Gateway Konfiguration
 
 Dieser Node stellt die Verbindung zu deinem KNX/IP-Gateway her.

package/nodes/locales/de/knxUltimate.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimate">
-### Upgrade auf KNX Ultimate 8
-
-Version 7 zeigt oben in diesem Editor eine kleine Schaltfläche **Auf v8 aktualisieren**. Sie lädt eine Flow-Sicherung herunter, installiert die benötigten HUE-/Matter-Pakete, konvertiert kompatible Knoten, führt ein vollständiges Deploy aus, prüft die gespeicherten Flows und installiert Version 8. Starten Sie den Node-RED-Dienst anschließend wie aufgefordert neu; nur den Browser neu zu laden genügt nicht. Bisherige KNX-AI-Knoten stoppen den automatischen Vorgang.
-
-[Vollständige Upgrade-Anleitung](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/de-Upgrade-to-v8)
-
-<br/>
-
 ## KNX-ULTIMATE GERÄTE-NODE EINSTELLUNGEN
 
 Dieser Node steuert eine KNX-Gruppenadresse und ist der am häufigsten verwendete.

package/nodes/locales/de/knxUltimateIoTBridge.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-### Upgrade auf KNX Ultimate 8
-
-Version 7 zeigt oben in diesem Editor eine kleine Schaltfläche **Auf v8 aktualisieren**. Sie lädt eine Flow-Sicherung herunter, installiert die benötigten HUE-/Matter-Pakete, konvertiert kompatible Knoten, führt ein vollständiges Deploy aus, prüft die gespeicherten Flows und installiert Version 8. Starten Sie den Node-RED-Dienst anschließend wie aufgefordert neu; nur den Browser neu zu laden genügt nicht. Bisherige KNX-AI-Knoten stoppen den automatischen Vorgang.
-
-[Vollständige Upgrade-Anleitung](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/de-Upgrade-to-v8)
-
-<br/>
-
 # MQTT Home Assistant - IoT
 
 Erstellen Sie bidirektionale Brücken zwischen KNX-Gruppenadressen und IoT-Kanälen (MQTT-Themen, REST-Endpunkte, Modbus-Register). Jede Zuordnung kann Werte skalieren, Payloads formatieren und Metadaten für nachgelagerte Nodes bereitstellen.

package/nodes/locales/de/knxUltimateMultiRouting.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMultiRouting">
-### Upgrade auf KNX Ultimate 8
-
-Version 7 zeigt oben in diesem Editor eine kleine Schaltfläche **Auf v8 aktualisieren**. Sie lädt eine Flow-Sicherung herunter, installiert die benötigten HUE-/Matter-Pakete, konvertiert kompatible Knoten, führt ein vollständiges Deploy aus, prüft die gespeicherten Flows und installiert Version 8. Starten Sie den Node-RED-Dienst anschließend wie aufgefordert neu; nur den Browser neu zu laden genügt nicht. Bisherige KNX-AI-Knoten stoppen den automatischen Vorgang.
-
-[Vollständige Upgrade-Anleitung](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/de-Upgrade-to-v8)
-
-<br/>
-
 Dieser Node dient dazu, **mehrere KNX-Ultimate-Gateways** (mehrere `knxUltimate-config`) über Node-RED Verbindungen zu koppeln.
 
 Er gibt für jedes Telegramm vom KNX-Bus des ausgewählten Gateways ein Objekt mit **RAW-Telegramm-Informationen** (APDU + cEMI-Hex + Adressen) aus.

package/nodes/locales/de/knxUltimateRouterFilter.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateRouterFilter">
-### Upgrade auf KNX Ultimate 8
-
-Version 7 zeigt oben in diesem Editor eine kleine Schaltfläche **Auf v8 aktualisieren**. Sie lädt eine Flow-Sicherung herunter, installiert die benötigten HUE-/Matter-Pakete, konvertiert kompatible Knoten, führt ein vollständiges Deploy aus, prüft die gespeicherten Flows und installiert Version 8. Starten Sie den Node-RED-Dienst anschließend wie aufgefordert neu; nur den Browser neu zu laden genügt nicht. Bisherige KNX-AI-Knoten stoppen den automatischen Vorgang.
-
-[Vollständige Upgrade-Anleitung](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/de-Upgrade-to-v8)
-
-<br/>
-
 Filtert RAW-Telegramm-Objekte (typischerweise vom **KNX Multi Routing** Node), bevor sie an ein anderes Gateway weitergeleitet werden.
 
 ## Muster-Syntax

package/nodes/locales/de/knxUltimateUtility.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateUtility">
-### Upgrade auf KNX Ultimate 8
-
-Version 7 zeigt oben in diesem Editor eine kleine Schaltfläche **Auf v8 aktualisieren**. Sie lädt eine Flow-Sicherung herunter, installiert die benötigten HUE-/Matter-Pakete, konvertiert kompatible Knoten, führt ein vollständiges Deploy aus, prüft die gespeicherten Flows und installiert Version 8. Starten Sie den Node-RED-Dienst anschließend wie aufgefordert neu; nur den Browser neu zu laden genügt nicht. Bisherige KNX-AI-Knoten stoppen den automatischen Vorgang.
-
-[Vollständige Upgrade-Anleitung](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/de-Upgrade-to-v8)
-
-<br/>
-
 # KNX Utility
 
 Wählen Sie für jeden KNX Utility-Knoten eine Funktion. Funktionen am KNX-Bus benötigen ein Gateway; Home Assistant Translator verarbeitet Nachrichten direkt. Editor, Symbol und Ports passen sich der Funktion an. KNX Device bleibt der zentrale KNX-Knoten.

package/nodes/locales/de/knxUltimateUtility.json

@@ -50,7 +50,22 @@
       "flow_conflict": "Ein anderer Editor hat die Flow-Revision geändert. Die automatische Konvertierung wurde lokal zurückgenommen. Prüfen oder exportieren Sie bereits vorhandene lokale Änderungen und laden Sie den Editor neu, bevor Sie es erneut versuchen.",
       "persistence_uncertain": "Node-RED hat das Speichern der Flows nicht bestätigt. Es wurde kein automatischer Rollback durchgeführt. Laden Sie den Editor neu und prüfen Sie die gespeicherten Flows, bevor Sie es erneut versuchen.",
       "flows_persisted": "Die konvertierten Flows wurden gespeichert, aber KNX Ultimate 8 wurde nicht installiert. Führen Sie kein weiteres Deploy aus. Beheben Sie den gemeldeten Fehler, laden Sie den Editor neu und drücken Sie die Update-Schaltfläche erneut:",
-      "failed": "Das automatische Update wurde sicher beendet. KNX Ultimate 8 wurde nicht aktiviert:"
+      "failed": "Das automatische Update wurde sicher beendet. KNX Ultimate 8 wurde nicht aktiviert:",
+      "recovery_title": "Migration von KNX Ultimate 8 abschließen",
+      "recovery_summary": "Nach der Installation von KNX Ultimate 8 wurden Legacy-Knoten gefunden. Zu konvertierende Knoten/Konfigurationen: KNX Utility {{utility}}, HUE {{hue}}, Matter {{matter}}.",
+      "recovery_confirm": "Zuerst wird eine JSON-Sicherung aller Flows heruntergeladen. Danach werden die erforderlichen HUE-/Matter-Pakete installiert und alle aktuellen Editor-Änderungen bereitgestellt. KNX Ultimate selbst wird nicht neu installiert. IDs, Verdrahtung, Konfigurationsreferenzen, Zugangsdaten und Matter-Speicher bleiben erhalten. Der aktuell geöffnete Knoteneditor wird geschlossen; noch nicht im Formular gespeicherte Änderungen werden verworfen.",
+      "recovery_start": "Sichern und Migration abschließen",
+      "recovery_complete_title": "Migration von KNX Ultimate 8 abgeschlossen",
+      "recovery_complete": "{{total}} Legacy-Knoten/Konfigurationen wurden konvertiert. Die gespeicherten Flows sind jetzt mit KNX Ultimate 8 kompatibel. Laden Sie den Editor neu, bevor Sie weitere Änderungen vornehmen.",
+      "recovery_reload": "Editor neu laden",
+      "recovery_standalone_restart_required": "Ein Update der HUE-/Matter-Pakete ist bereit. Starten Sie den Node-RED-Dienst neu, laden Sie den Editor neu und starten Sie anschließend die Migrationswiederherstellung erneut. Es wurden keine Flows geändert.",
+      "recovery_module_install_uncertain": "Ein Paketvorgang läuft möglicherweise noch. Starten Sie den Node-RED-Dienst neu, laden Sie den Editor neu und starten Sie die Migrationswiederherstellung erneut. Stellen Sie vor dem Neustart keine Flows bereit.",
+      "recovery_flows_persisted": "Die konvertierten Flows wurden gespeichert, die Überprüfung wurde jedoch nicht abgeschlossen. Stellen Sie keine weiteren Änderungen bereit. Laden Sie den Editor neu und prüfen Sie die gespeicherten Flows, bevor Sie die Migrationswiederherstellung erneut starten:",
+      "recovery_failed": "Die automatische Migration wurde sicher beendet:",
+      "recovery_notice_title": "Migration von KNX Ultimate 8 erforderlich",
+      "recovery_notice": "Legacy-Knoten sind noch vorhanden: KNX Utility {{utility}}, HUE {{hue}}, Matter {{matter}}, AI {{ai}}. Schließen Sie die geschützte Migration ab, bevor Sie Flows bearbeiten oder bereitstellen.",
+      "recovery_notice_button": "Migration abschließen",
+      "later": "Später"
     },
     "locale": "de",
     "function": "Funktion",

package/nodes/locales/de/knxUltimateViewer.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateViewer">
-### Upgrade auf KNX Ultimate 8
-
-Version 7 zeigt oben in diesem Editor eine kleine Schaltfläche **Auf v8 aktualisieren**. Sie lädt eine Flow-Sicherung herunter, installiert die benötigten HUE-/Matter-Pakete, konvertiert kompatible Knoten, führt ein vollständiges Deploy aus, prüft die gespeicherten Flows und installiert Version 8. Starten Sie den Node-RED-Dienst anschließend wie aufgefordert neu; nur den Browser neu zu laden genügt nicht. Bisherige KNX-AI-Knoten stoppen den automatischen Vorgang.
-
-[Vollständige Upgrade-Anleitung](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/de-Upgrade-to-v8)
-
-<br/>
-
 # KNX Viewer
 
 KNX Viewer zeigt Zustandsänderungen von Gruppenadressen (GA) in einer einfachen Tabelle, ähnlich einem auf das Wesentliche beschränkten ETS-Monitor.

package/nodes/locales/en/knxUltimate-config.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimate-config">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 # KNX Gateway Configuration
 
 <p>This node connects to your KNX gateway, whether it is an IP interface/router or a TP/FT1.2 serial adapter.</p>

package/nodes/locales/en/knxUltimate.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimate">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 ## KNX-ULTIMATE DEVICE NODE SETTINGS
 
 <p>This node lets you control a KNX Group Address, this is the most used node.  

package/nodes/locales/en/knxUltimateIoTBridge.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 # MQTT Home Assistant - IoT
 
 Create bidirectional bridges between KNX group addresses and IoT channels (MQTT topics, REST endpoints, Modbus registers). Each mapping can scale values, stringify payloads and expose metadata for downstream nodes.

package/nodes/locales/en/knxUltimateMultiRouting.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMultiRouting">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 This node is used to **bridge multiple KNX Ultimate gateways** (multiple `knxUltimate-config`) using Node-RED wires.
 
 It outputs **RAW telegram information** (APDU + cEMI hex + addresses) for every telegram received from the KNX bus of the selected gateway.

package/nodes/locales/en/knxUltimateRouterFilter.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateRouterFilter">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 Filters RAW telegram objects (typically produced by **KNX Multi Routing**) before they are forwarded to another gateway.
 
 ## Pattern syntax

package/nodes/locales/en/knxUltimateUtility.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateUtility">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 # KNX Utility
 
 Select one function for each KNX Utility node. Functions that use the KNX bus require a gateway; Home Assistant Translator works directly on messages. The editor, icon and ports follow the selected function. KNX Device remains the main KNX node.

package/nodes/locales/en/knxUltimateUtility.json

@@ -50,7 +50,22 @@
       "flow_conflict": "Another editor changed the flow revision. The automatic conversion was rolled back locally. Review or export any pre-existing local changes, then reload the editor before trying again.",
       "persistence_uncertain": "Node-RED did not confirm the flow save. No automatic rollback was applied. Reload the editor and review the saved flows before trying again.",
       "flows_persisted": "The converted flows were saved, but KNX Ultimate 8 was not installed. Do not deploy more changes. Resolve the reported error, reload the editor and press the upgrade button again:",
-      "failed": "Automatic upgrade stopped safely. KNX Ultimate 8 was not activated:"
+      "failed": "Automatic upgrade stopped safely. KNX Ultimate 8 was not activated:",
+      "recovery_title": "Complete KNX Ultimate 8 migration",
+      "recovery_summary": "Legacy nodes were found after KNX Ultimate 8 was installed. Nodes/configurations to convert: KNX Utility {{utility}}, HUE {{hue}}, Matter {{matter}}.",
+      "recovery_confirm": "A JSON backup of all flows will download first. The required HUE/Matter packages will then be installed and all current editor changes deployed. KNX Ultimate itself will not be reinstalled. IDs, wiring, configuration references, credentials and Matter storage are preserved. The current node editor will close and discard edits not yet saved in this form.",
+      "recovery_start": "Back up and complete migration",
+      "recovery_complete_title": "KNX Ultimate 8 migration completed",
+      "recovery_complete": "Converted {{total}} legacy nodes/configurations. The saved flows are now compatible with KNX Ultimate 8. Reload the editor before making further changes.",
+      "recovery_reload": "Reload editor",
+      "recovery_standalone_restart_required": "A HUE/Matter package update is ready. Restart the Node-RED service, reload the editor, then start the migration recovery again. No flows were changed.",
+      "recovery_module_install_uncertain": "A package operation may still be running. Restart the Node-RED service, reload the editor and start the migration recovery again. Do not deploy flows before restarting.",
+      "recovery_flows_persisted": "The converted flows were saved, but verification did not complete. Do not deploy more changes. Reload the editor and review the saved flows before starting migration recovery again:",
+      "recovery_failed": "Automatic migration stopped safely:",
+      "recovery_notice_title": "KNX Ultimate 8 migration required",
+      "recovery_notice": "Legacy nodes are still present: KNX Utility {{utility}}, HUE {{hue}}, Matter {{matter}}, AI {{ai}}. Complete the protected migration before editing or deploying flows.",
+      "recovery_notice_button": "Complete migration",
+      "later": "Later"
     },
     "locale": "en",
     "function": "Function",

package/nodes/locales/en/knxUltimateViewer.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateViewer">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required HUE/Matter packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
 # KNX Viewer
 
 KNX Viewer shows group address (GA) state changes in a simple table, similar to a minimal ETS monitor.

package/nodes/locales/es/knxUltimate-config.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimate-config">
-### Actualizar a KNX Ultimate 8
-
-La versión 7 muestra un pequeño botón **Actualizar a v8** en la parte superior de este editor. Descarga una copia de los flujos, instala los paquetes HUE/Matter necesarios, convierte los nodos compatibles, realiza un Deploy completo, verifica los flujos guardados e instala la versión 8. Reinicia después el servicio Node-RED cuando se indique; recargar solo el navegador no es suficiente. Los nodos antiguos KNX AI detienen la operación automática.
-
-[Guía completa de actualización](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/es-Upgrade-to-v8)
-
-<br/>
-
 # Configuración de la puerta de enlace KNX
 
 <p> Este nodo se conecta a su puerta de enlace KNX/IP. </p>

package/nodes/locales/es/knxUltimate.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimate">
-### Actualizar a KNX Ultimate 8
-
-La versión 7 muestra un pequeño botón **Actualizar a v8** en la parte superior de este editor. Descarga una copia de los flujos, instala los paquetes HUE/Matter necesarios, convierte los nodos compatibles, realiza un Deploy completo, verifica los flujos guardados e instala la versión 8. Reinicia después el servicio Node-RED cuando se indique; recargar solo el navegador no es suficiente. Los nodos antiguos KNX AI detienen la operación automática.
-
-[Guía completa de actualización](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/es-Upgrade-to-v8)
-
-<br/>
-
 ## Configuración del nodo del dispositivo KNX-Ulimidad
 
 <p> Este nodo le permite controlar una dirección de grupo KNX, este es el nodo más utilizado.

package/nodes/locales/es/knxUltimateIoTBridge.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-### Actualizar a KNX Ultimate 8
-
-La versión 7 muestra un pequeño botón **Actualizar a v8** en la parte superior de este editor. Descarga una copia de los flujos, instala los paquetes HUE/Matter necesarios, convierte los nodos compatibles, realiza un Deploy completo, verifica los flujos guardados e instala la versión 8. Reinicia después el servicio Node-RED cuando se indique; recargar solo el navegador no es suficiente. Los nodos antiguos KNX AI detienen la operación automática.
-
-[Guía completa de actualización](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/es-Upgrade-to-v8)
-
-<br/>
-
 # MQTT Home Assistant - IoT
 
 Crea puentes bidireccionales entre direcciones de grupo KNX y canales IoT (topics MQTT, endpoints REST, registros Modbus). Cada mapeo puede escalar valores, formatear payloads y exponer metadatos para los nodos posteriores.

package/nodes/locales/es/knxUltimateMultiRouting.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMultiRouting">
-### Actualizar a KNX Ultimate 8
-
-La versión 7 muestra un pequeño botón **Actualizar a v8** en la parte superior de este editor. Descarga una copia de los flujos, instala los paquetes HUE/Matter necesarios, convierte los nodos compatibles, realiza un Deploy completo, verifica los flujos guardados e instala la versión 8. Reinicia después el servicio Node-RED cuando se indique; recargar solo el navegador no es suficiente. Los nodos antiguos KNX AI detienen la operación automática.
-
-[Guía completa de actualización](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/es-Upgrade-to-v8)
-
-<br/>
-
 Este nodo se utiliza para **interconectar varios gateways KNX Ultimate** (varios `knxUltimate-config`) mediante cables de Node-RED.
 
 En la salida emite un objeto con información **RAW del telegrama** (APDU + cEMI en hex + direcciones) para cada telegrama recibido del bus KNX del gateway seleccionado.

package/nodes/locales/es/knxUltimateRouterFilter.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateRouterFilter">
-### Actualizar a KNX Ultimate 8
-
-La versión 7 muestra un pequeño botón **Actualizar a v8** en la parte superior de este editor. Descarga una copia de los flujos, instala los paquetes HUE/Matter necesarios, convierte los nodos compatibles, realiza un Deploy completo, verifica los flujos guardados e instala la versión 8. Reinicia después el servicio Node-RED cuando se indique; recargar solo el navegador no es suficiente. Los nodos antiguos KNX AI detienen la operación automática.
-
-[Guía completa de actualización](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/es-Upgrade-to-v8)
-
-<br/>
-
 Filtra objetos de telegramas RAW (normalmente producidos por **KNX Multi Routing**) antes de reenviarlos a otro gateway.
 
 ## Sintaxis de patrones

package/nodes/locales/es/knxUltimateUtility.html

@@ -1,12 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateUtility">
-### Actualizar a KNX Ultimate 8
-
-La versión 7 muestra un pequeño botón **Actualizar a v8** en la parte superior de este editor. Descarga una copia de los flujos, instala los paquetes HUE/Matter necesarios, convierte los nodos compatibles, realiza un Deploy completo, verifica los flujos guardados e instala la versión 8. Reinicia después el servicio Node-RED cuando se indique; recargar solo el navegador no es suficiente. Los nodos antiguos KNX AI detienen la operación automática.
-
-[Guía completa de actualización](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/es-Upgrade-to-v8)
-
-<br/>
-
 # KNX Utility
 
 Selecciona una función para cada nodo KNX Utility. Las funciones que usan el bus KNX requieren una pasarela; Home Assistant Translator procesa directamente los mensajes. El editor, el icono y los puertos se adaptan a la función seleccionada. KNX Device sigue siendo el nodo KNX principal.

package/nodes/locales/es/knxUltimateUtility.json

@@ -50,7 +50,22 @@
       "flow_conflict": "Otro editor cambió la revisión de los flujos. La conversión automática se revirtió localmente. Revisa o exporta los cambios locales previos y vuelve a cargar el editor antes de intentarlo de nuevo.",
       "persistence_uncertain": "Node-RED no confirmó el guardado de los flujos. No se aplicó ninguna reversión automática. Vuelve a cargar el editor y revisa los flujos guardados antes de intentarlo de nuevo.",
       "flows_persisted": "Los flujos convertidos se guardaron, pero KNX Ultimate 8 no se instaló. No realices más Deploy. Corrige el error indicado, vuelve a cargar el editor y pulsa de nuevo el botón de actualización:",
-      "failed": "La actualización automática se detuvo de forma segura. KNX Ultimate 8 no se activó:"
+      "failed": "La actualización automática se detuvo de forma segura. KNX Ultimate 8 no se activó:",
+      "recovery_title": "Completar la migración de KNX Ultimate 8",
+      "recovery_summary": "Se encontraron nodos heredados después de instalar KNX Ultimate 8. Nodos/configuraciones que se convertirán: KNX Utility {{utility}}, HUE {{hue}}, Matter {{matter}}.",
+      "recovery_confirm": "Primero se descargará una copia de seguridad JSON de todos los flows. Después se instalarán los paquetes HUE/Matter necesarios y se desplegarán todos los cambios actuales del editor. KNX Ultimate no se reinstalará. Se conservan los ID, el cableado, las referencias de configuración, las credenciales y el almacenamiento de Matter. El editor del nodo abierto se cerrará y se descartarán los cambios que aún no se hayan guardado en este formulario.",
+      "recovery_start": "Crear copia y completar la migración",
+      "recovery_complete_title": "Migración de KNX Ultimate 8 completada",
+      "recovery_complete": "Se convirtieron {{total}} nodos/configuraciones heredados. Los flows guardados ya son compatibles con KNX Ultimate 8. Vuelve a cargar el editor antes de realizar más cambios.",
+      "recovery_reload": "Recargar editor",
+      "recovery_standalone_restart_required": "Hay una actualización de los paquetes HUE/Matter preparada. Reinicia el servicio Node-RED, vuelve a cargar el editor y ejecuta de nuevo la recuperación de la migración. No se modificó ningún flow.",
+      "recovery_module_install_uncertain": "Es posible que todavía haya una operación de paquetes en curso. Reinicia el servicio Node-RED, vuelve a cargar el editor y ejecuta de nuevo la recuperación de la migración. No despliegues flows antes de reiniciar.",
+      "recovery_flows_persisted": "Los flows convertidos se guardaron, pero la verificación no terminó. No despliegues más cambios. Vuelve a cargar el editor y revisa los flows guardados antes de ejecutar de nuevo la recuperación de la migración:",
+      "recovery_failed": "La migración automática se detuvo de forma segura:",
+      "recovery_notice_title": "Se requiere la migración de KNX Ultimate 8",
+      "recovery_notice": "Todavía hay nodos heredados: KNX Utility {{utility}}, HUE {{hue}}, Matter {{matter}}, AI {{ai}}. Completa la migración protegida antes de editar o desplegar flows.",
+      "recovery_notice_button": "Completar la migración",
+      "later": "Más tarde"
     },
     "locale": "es",
     "function": "Función",
@@ -89,7 +104,7 @@
       "2": "Último dispositivo en alerta"
     },
     "variable_name": "Nombre de variable",
-    "variable_name_description": "Solo letras (A–Z, a–z). Este nombre determina las variables globales <nombre>_READ y <nombre>_WRITE.",
+    "variable_name_description": "Solo letras (A-Z, a-z). Este nombre determina las variables globales <nombre>_READ y <nombre>_WRITE.",
     "logger_outputs": {
       "0": "XML de diagnóstico ETS",
       "1": "Contador de telegramas"