node-red-contrib-knx-ultimate 6.3.32 → 6.4.1

package/CHANGELOG.md

@@ -6,6 +6,15 @@
 
 # CHANGELOG
 
+**Version 6.4.1** - September 2026<br/>
+
+- **KNX AI — safe Cerebrum startup delivery**: corrected the RedBot Telegram envelope used by startup and other proactive messages after a Node-RED restart. Its synthetic chat context now fulfils RedBot's synchronous context contract instead of returning `undefined`, preventing `chat-platform` from raising an uncaught `sourceCode` error and terminating Node-RED. Saved RedBot adapter code is hardened at runtime as well. Schedule persistence now passes the generated Markdown filename to the atomic writer under the correct `filePath` key, removing the accompanying undefined-path warning.<br/>
+- **KNX AI — Cerebrum (BETA)**: renamed the Web Assistant area to Cerebrum and introduced a passive home-automation intelligence layer that studies KNX telegrams, useful Node-RED flow events and the registered HUE, Matter and Home Assistant adapters. Cerebrum maintains bounded current-state and observation context locally, learns only repeated patterns spanning distinct days and asks the occupant for confirmation or correction through the Assistant output before a habit can become predictive. Confirmed habits remain subject to the exact ETS/DPT permissions: group addresses marked read-only are never written.<br/>
+- **Cerebrum — Home Assistant adapter**: added the `Cerebrum Home Assistant` node and the shared runtime registry. When Node-RED is running as a Home Assistant add-on, Setup Doctor detects whether the required `ha-api` round trip is present and tells the user to add it when missing. Entity states, events and service capabilities are exposed to Cerebrum through bounded, vendor-neutral records without retaining raw messages, secrets or binary payloads.<br/>
+- **Cerebrum — supervised startup**: every KNX AI node now asks its configured model to generate a short startup reassurance on the Assistant output. The message carries `msg.boot = true` for simple flow filtering and falls back to a localized deterministic notice if the provider is unavailable.<br/>
+- **KNX AI Web — Cerebrum workspace and readable memory**: reorganized the Web navigation into Cerebrum submenus, removed the separate KNX AI node selector and bound the workspace directly to the node that opened it. Cerebrum Memory now offers an editable authoritative JSON view and a read-only simplified view; AI Chat Learning offers the equivalent editable native `.knxctx` view and localized simplified view. Copy follows the visible representation, while save, restore, download and concurrency checks continue to protect the complete authoritative files.<br/>
+- **Cerebrum — complete import/export**: the Settings page now contains only import/export and its versioned backup includes AI configuration, chat learning, home memory, schedules and the readable schedules companion file, with validation and rollback-safe restoration.<br/>
+
 **Version 6.3.32** - August 2026<br/>
 
 - **KNX AI**: AI-first chat with complete cloud ETS context, selectable local windows and guided retrieval; selected ETS access is now the sole read/write authority, with no neutral role.<br/>

package/nodes/knxUltimateAI.html

@@ -873,7 +873,7 @@
                         .text(String(prompt.text))
                         .on("click", function (evt) {
                             evt.preventDefault();
-                            openKnxAiWebPage("assistant", String(prompt.text));
+                            openKnxAiWebPage("cerebrum", String(prompt.text));
                         })
                         .appendTo($prompts);
                 });
@@ -1004,7 +1004,7 @@
                     homeMemory: t("knxUltimateAI.messages.chatContextFileHomeMemory", "Bounded learned home memory only; AI Education remains in the node property."),
                     schedules: t("knxUltimateAI.messages.chatContextFileSchedules", "Authoritative structured plans and reminders for this node."),
                     schedulesReadable: t("knxUltimateAI.messages.chatContextFileSchedulesReadable", "Human-readable plans and reminders generated from the scheduler state."),
-                    assistantConfig: t("knxUltimateAI.messages.chatContextFileAssistantConfig", "Persistent web Assistant configuration and semantic areas for this node."),
+                    assistantConfig: t("knxUltimateAI.messages.chatContextFileAssistantConfig", "Persistent Cerebrum configuration and semantic areas for this node."),
                     lastChatPrompt: t("knxUltimateAI.messages.chatContextFileLastChatPrompt", "Temporary local copy of the latest system and user messages sent to the chat model; overwritten on every chat request.")
                 };
                 (Array.isArray(overview.files) ? overview.files : []).forEach(function (item) {
@@ -1082,10 +1082,14 @@
                 const params = new URLSearchParams();
                 if (nodeId) params.set("nodeId", nodeId);
                 if (view === "chat-learning") {
-                    params.set("tab", "settings");
-                    params.set("settingsTab", "learning");
-                } else if (view === "assistant") {
-                    params.set("tab", "assistant");
+                    params.set("tab", "cerebrum");
+                    params.set("cerebrumTab", "learning");
+                } else if (view === "cerebrum-memory") {
+                    params.set("tab", "cerebrum");
+                    params.set("cerebrumTab", "memory");
+                } else if (view === "cerebrum") {
+                    params.set("tab", "cerebrum");
+                    params.set("cerebrumTab", "conversation");
                     if (prompt) params.set("prompt", String(prompt));
                 }
                 const accessToken = resolveAccessToken();
@@ -1105,6 +1109,11 @@
                 openKnxAiWebPage("chat-learning");
             });
 
+            $("#knx-ai-open-cerebrum-memory").on("click", function (evt) {
+                evt.preventDefault();
+                openKnxAiWebPage("cerebrum-memory");
+            });
+
             const setRefreshModelsBusy = (busy) => {
                 const $button = $("#knx-ai-refreshModels");
                 $button.prop("disabled", !!busy);
@@ -1590,6 +1599,11 @@
                 <button type="button" class="red-ui-button" id="knx-ai-open-chat-learning">
                     <i class="fa fa-external-link"></i> <span data-i18n="knxUltimateAI.buttons.openChatLearning"></span>
                 </button>
+                <h4 style="margin-top:14px;"><i class="fa fa-database"></i> <span data-i18n="knxUltimateAI.sections.cerebrumMemory"></span></h4>
+                <p class="knx-ai-chat-learning-link-copy" data-i18n="knxUltimateAI.messages.cerebrumMemoryOpenHint"></p>
+                <button type="button" class="red-ui-button" id="knx-ai-open-cerebrum-memory">
+                    <i class="fa fa-external-link"></i> <span data-i18n="knxUltimateAI.buttons.openCerebrumMemory"></span>
+                </button>
             </div>
             <div id="knx-ai-detected-adapters-panel">
                 <h4><i class="fa fa-puzzle-piece"></i> <span data-i18n="knxUltimateAI.sections.detectedAdapters"></span></h4>