iobroker.poolcontrol 1.3.32 → 1.3.34

package/README.md

@@ -36,6 +36,7 @@ It provides automation for pumps, heating, solar and photovoltaic control as wel
 
 - **Solar Control**
   - Collector on/off thresholds with hysteresis
+  - Live collector-surface delta for dashboards and scripts
   - Collector warning threshold
   - Optional speech output for warnings
   - Automatic reset logic
@@ -43,10 +44,12 @@ It provides automation for pumps, heating, solar and photovoltaic control as wel
 - **Solar Extended**
   - Separate control for external solar actuators
   - Delta on/off thresholds
+  - Live collector-pool reference delta for dashboards and scripts
   - Maximum pool temperature limits
   - Diagnostic and reason states
   - Priority and block logic
   - Status section under `solar.extended.*`
+  - Runtime changes to `solar.extended.pool_temperature_source` are applied automatically; because Solar Extended uses a cyclic check interval, calculation, control logic, and `solar.extended.collector_pool_reference_delta` may take up to approximately 60 seconds to update.
 
 - **Photovoltaic Control**
   - Pump control based on PV surplus and household consumption
@@ -184,6 +187,15 @@ It provides automation for pumps, heating, solar and photovoltaic control as wel
   - No chlorine control
   - No automatic dosing
 
+  **Two-tier bounded chemistry history**
+  - Existing samples_json states remain the 7-day, 15-minute short-term history: at most 672 samples and 64 KB each
+  - New internal daily_json states keep compact local-calendar-day aggregates with min/max/avg/last/count: at most 32 entries and 8 KB each
+  - 24h and 7d trends use samples_json; 30d trends use the last value of the matching daily aggregate
+  - Existing 24h, 7d, and 30d trend states and text/HTML/JSON reports retain their API and meaning
+  - The daily aggregates complement but do not replace raw history; valid legacy data is normalized during migration and oversized JSON is rejected before parsing
+  - Raw long-term histories belong in a dedicated ioBroker history/time-series database
+  - If an oversized states.jsonl already prevents js-controller startup, it must be repaired externally before PoolControl can run
+
   **Chemistry Tools**
   - pH Plus calculator
   - pH Minus calculator
@@ -271,6 +283,22 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.34 (2026-06-27)
+
+- **Major stability improvement:** Completely redesigned the internal chemistry history (pH, ORP and TDS) to prevent unbounded JSON state growth. This significantly reduces the risk of oversized `states.jsonl` files and potential js-controller startup failures.
+- **New two-stage history architecture:** Chemistry history now uses a compact short-term history for recent measurements together with a dedicated daily history for long-term trends. All existing 24-hour, 7-day and 30-day trend calculations and reports remain fully available.
+- **Protected history storage:** Added strict limits for chemistry history sample count and JSON size. Oversized or invalid history states are now safely detected, validated and handled before being processed.
+- **Daily aggregates introduced:** Added compact daily aggregates for pH, ORP and TDS containing minimum, maximum, average and last measurement together with the number of valid samples. This preserves long-term trend analysis without storing large raw histories.
+- **Additional safeguards:** Added size protection for the solar logbook and debug log to prevent uncontrolled state growth.
+- **Maintenance:** Updated the `@iobroker/adapter-core` dependency to the latest recommended version.
+
+### 1.3.33 (2026-06-18)
+
+- Added live delta states for standard solar and Solar Extended control:
+  - `solar.collector_surface_delta`
+  - `solar.extended.collector_pool_reference_delta`
+- Documented that runtime changes to `solar.extended.pool_temperature_source` are applied automatically, but may take up to approximately 60 seconds due to the Solar Extended cyclic check interval.
+
 ### 1.3.32 (2026-06-08)
 
 - Added circulation plausibility diagnostics for daily circulation calculations.
@@ -288,20 +316,6 @@ New features are added regularly – please refer to the changelog.
 - Cleaned up outdated Admin i18n keys.
 - Replaced native timers in AI weather helpers with ioBroker adapter timers.
 
-### 1.3.29 (2026-06-04)
-
-- Added Pool Insights V1 with observations, status evaluation and runtime i18n support.
-- Improved Pool Insights text generation and removed dependency on external summary blocks.
-- Added configurable startup power check timeout state for pump startup monitoring.
-- Fixed missing initialization of season and solar warning runtime states from adapter configuration.
-- Added admin UI information about initial configuration values and runtime datapoint control.
-
-### 1.3.28 (2026-06-03)
-
-- Added configurable startup power check timeout for pump monitoring (`pump.startup_power_check_timeout_sec`).
-- Default behavior remains unchanged (5 seconds).
-- Improved compatibility with delayed power measurements from smart plugs and power meters.
-
 ## Archived Release History
 
 For older releases and archived version history see:

package/admin/i18n/uk.json

@@ -88,12 +88,12 @@
     "Object ID Auxiliary pump 3": "Ідентифікатор об’єкта Допоміжний насос 3",
     "Object ID Collector Sensor": "Датчик збирача ідентифікаторів об’єктів",
     "Object ID Current Power (W)": "Ідентифікатор об'єкта Поточна потужність (Вт)",
-    "Object ID Flow Sensor": "Object ID Flow Sensor",
-    "Object ID Ground Sensor": "Object ID Ground Sensor",
+    "Object ID Flow Sensor": "Ідентифікатор об'єкта датчика потоку",
+    "Object ID Ground Sensor": "Ідентифікатор об'єкта датчика температури дна",
     "Object ID Heating / Heat Pump": "Ідентифікатор об'єкта Опалення / Тепловий насос",
-    "Object ID Lighting 1": "Object ID Lighting 1",
-    "Object ID Lighting 2": "Object ID Lighting 2",
-    "Object ID Lighting 3": "Object ID Lighting 3",
+    "Object ID Lighting 1": "Ідентифікатор об'єкта освітлення 1",
+    "Object ID Lighting 2": "Ідентифікатор об'єкта Освітлення 2",
+    "Object ID Lighting 3": "Ідентифікатор об'єкта Освітлення 3",
     "Object ID Outside Temperature Sensor": "Ідентифікатор об’єкта Датчик зовнішньої температури",
     "Object ID PV generation power (W)": "Ідентифікатор об'єкта Потужність генерації PV (Вт)",
     "Object ID Pressure Sensor (bar)": "Ідентифікатор об'єкта Датчик тиску (бар)",

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.32",
+    "version": "1.3.34",
     "news": {
+      "1.3.34": {
+        "en": "Improved chemistry history architecture with protected short-term and daily history, prevented oversized JSON states, added safeguards against state database growth, enhanced solar logbook/debug log protection, and updated adapter-core dependency.",
+        "de": "Chemie-Historie grundlegend verbessert: geschützte Kurzzeit- und Tageshistorie eingeführt, übergroße JSON-States verhindert, Schutz vor unkontrolliertem Wachstum der State-Datenbank ergänzt, Solar-Logbuch und Debug-Log zusätzlich abgesichert sowie adapter-core-Abhängigkeit aktualisiert.",
+        "ru": "Улучшенная архитектура истории химических процессов с защищенной краткосрочной и ежедневной историей, предотвращение чрезмерного размера состояний JSON, добавлена ​​защита от роста базы данных состояний, улучшена защита журнала солнечной энергии/журнала отладки, а также обновлена ​​зависимость от ядра адаптера.",
+        "pt": "Arquitetura de histórico químico aprimorada com histórico diário e de curto prazo protegido, prevenção de estados JSON superdimensionados, salvaguardas adicionais contra o crescimento do banco de dados estadual, proteção aprimorada de logbook solar/log de depuração e dependência atualizada do núcleo do adaptador.",
+        "nl": "Verbeterde architectuur van de chemiegeschiedenis met beschermde kortetermijn- en dagelijkse geschiedenis, voorkoming van te grote JSON-statussen, extra beveiliging tegen de groei van de staatsdatabase, verbeterde bescherming van het zonne-logboek/debug-logboek en bijgewerkte adapter-core-afhankelijkheid.",
+        "fr": "Architecture d'historique chimique améliorée avec historique protégé à court terme et quotidien, prévention des états JSON surdimensionnés, protections supplémentaires contre la croissance de la base de données d'état, protection améliorée du journal solaire/journal de débogage et dépendance mise à jour du noyau de l'adaptateur.",
+        "it": "Architettura della cronologia chimica migliorata con cronologia protetta a breve termine e giornaliera, prevenzione di stati JSON sovradimensionati, protezioni aggiuntive contro la crescita del database di stato, protezione migliorata del registro solare/registro di debug e dipendenza aggiornata del core dell'adattatore.",
+        "es": "Se mejoró la arquitectura del historial químico con historial diario y a corto plazo protegido, se evitaron estados JSON de gran tamaño, se agregaron salvaguardias contra el crecimiento de la base de datos estatal, se mejoró la protección del registro solar/registro de depuración y se actualizó la dependencia del núcleo del adaptador.",
+        "pl": "Ulepszona architektura historii chemii z chronioną historią krótkoterminową i codzienną, zapobieganie nadmiernym stanom JSON, dodane zabezpieczenia przed rozrostem bazy danych stanu, ulepszona ochrona dziennika solarnego/dziennika debugowania oraz zaktualizowana zależność od rdzenia adaptera.",
+        "uk": "Покращена архітектура хімічної історії із захищеною короткостроковою та щоденною історією, запобіганням надмірним станам JSON, доданим запобіжним засобам проти зростання бази даних стану, покращеному захисту сонячного журналу/журналу налагодження та оновленій залежності ядра адаптера.",
+        "zh-cn": "改进了化学历史架构，具有受保护的短期和每日历史记录，防止过大的 JSON 状态，增加了针对状态数据库增长的保护措施，增强了太阳能日志/调试日志保护，并更新了适配器核心依赖性。"
+      },
+      "1.3.33": {
+        "en": "Added live delta states for standard solar and Solar Extended control. Documented Solar Extended pool reference runtime update behavior.",
+        "de": "Live-Delta-Datenpunkte für Standard-Solar und Solar Extended ergänzt. Laufzeitverhalten der Solar-Extended-Poolreferenz dokumentiert.",
+        "ru": "Добавлены дельта-состояния в реальном времени для стандартного и расширенного управления солнечной энергией. Документированное поведение обновления во время выполнения ссылки на расширенный пул Solar.",
+        "pt": "Adicionados estados delta ao vivo para controle solar padrão e solar estendido. Comportamento de atualização de tempo de execução de referência do pool Solar Extended documentado.",
+        "nl": "Live deltatoestanden toegevoegd voor standaard zonne-energie en Solar Extended-regeling. Gedocumenteerd runtime-updategedrag van de Solar Extended-poolreferentie.",
+        "fr": "Ajout d'états delta en direct pour le contrôle solaire standard et solaire étendu. Comportement documenté de la mise à jour du runtime de référence du pool Solar Extended.",
+        "it": "Aggiunti stati delta live per il controllo solare standard e Solar Extended. Comportamento documentato dell'aggiornamento runtime di riferimento del pool Solar Extended.",
+        "es": "Se agregaron estados delta en vivo para control solar estándar y solar extendido. Comportamiento de actualización del tiempo de ejecución de referencia del grupo Solar Extended documentado.",
+        "pl": "Dodano stany delta na żywo dla standardowego sterowania solarnego i Solar Extended. Udokumentowane zachowanie aktualizacji środowiska uruchomieniowego referencyjnej puli Solar Extended.",
+        "uk": "Додано живі дельта-стани для стандартного сонячного та розширеного керування Solar. Задокументована поведінка оновлення середовища виконання довідкового пулу Solar Extended.",
+        "zh-cn": "为标准太阳能和太阳能扩展控制添加了实时增量状态。记录了 Solar Extended 池参考运行时更新行为。"
+      },
       "1.3.32": {
         "en": "Added circulation plausibility diagnostics. New checks detect implausible pump power, flow rates, and daily circulation jumps. Added detailed diagnostic states under circulation.plausibility to simplify troubleshooting and analysis of circulation calculations.",
         "de": "Plausibilitätsdiagnose für die Umwälzberechnung hinzugefügt. Neue Prüfungen erkennen unplausible Pumpenleistungen, Durchflusswerte und Sprünge der Tagesumwälzung. Detaillierte Diagnose-States unter circulation.plausibility erleichtern die Fehlersuche und Analyse der Umwälzberechnung.",
@@ -41,32 +67,6 @@
         "pl": "Zaktualizowano narzędzia wydania do wymaganej wersji minimalnej. Wyczyszczono nieaktualne klucze administratora i18n. Zastąpiono natywne liczniki czasu w pomocnikach pogodowych AI zegarami adaptera ioBroker.",
         "uk": "Оновлено інструмент випуску до необхідної мінімальної версії. Очищено застарілі ключі адміністратора i18n. Вбудовані таймери в помічниках погоди штучного інтелекту замінено на таймери адаптера ioBroker.",
         "zh-cn": "将发布工具更新为所需的最低版本。清理了过时的 Admin i18n 密钥。将 AI 天气助手中的本机计时器替换为 ioBroker 适配器计时器。"
-      },
-      "1.3.29": {
-        "en": "Added Pool Insights V1 with observations, status evaluation and runtime i18n support. Improved Pool Insights text generation and removed dependency on external summary blocks. Fixed missing initialization of season and solar warning runtime states from adapter configuration. Added admin UI notes explaining initial values versus runtime datapoint control.",
-        "de": "Pool Insights V1 mit Beobachtungen, Statusbewertung und Runtime-i18n hinzugefügt. Pool-Insights-Texte verbessert und die Abhängigkeit von externen Summary-Blöcken entfernt. Fehlende Initialisierung der Saison- und Solarwarnungs-States aus der Adapterkonfiguration behoben. Hinweise in der Admin-Oberfläche ergänzt, die den Unterschied zwischen Initialwerten und Runtime-Datenpunkten erläutern.",
-        "ru": "Добавлен Pool Insights V1 с наблюдениями, оценкой состояния и поддержкой i18n во время выполнения. Улучшено создание текста Pool Insights и удалена зависимость от внешних сводных блоков. Исправлена ​​отсутствующая инициализация состояний выполнения сезонных и солнечных предупреждений из конфигурации адаптера. Добавлены примечания к интерфейсу администратора, объясняющие начальные значения и контроль точек данных во время выполнения.",
-        "pt": "Adicionado Pool Insights V1 com observações, avaliação de status e suporte ao tempo de execução i18n. Geração de texto do Pool Insights aprimorada e dependência removida de blocos de resumo externos. Corrigida a falta de inicialização dos estados de tempo de execução de aviso solar e de estação na configuração do adaptador. Adicionadas notas da UI administrativa explicando os valores iniciais versus controle de ponto de dados em tempo de execução.",
-        "nl": "Pool Insights V1 toegevoegd met observaties, statusevaluatie en runtime i18n-ondersteuning. Verbeterde tekstgeneratie in Pool Insights en verwijderde de afhankelijkheid van externe samenvattingsblokken. Probleem opgelost waarbij de initialisatie van seizoens- en zonne-waarschuwingsruntimestatussen uit de adapterconfiguratie ontbreekt. Aantekeningen in de beheerdersinterface toegevoegd waarin initiële waarden versus runtime-datapuntcontrole worden uitgelegd.",
-        "fr": "Ajout de Pool Insights V1 avec observations, évaluation de l'état et prise en charge du runtime i18n. Amélioration de la génération de texte Pool Insights et suppression de la dépendance aux blocs de résumé externes. Correction de l'initialisation manquante des états d'exécution de la saison et de l'avertissement solaire dans la configuration de l'adaptateur. Ajout de notes sur l'interface utilisateur d'administration expliquant les valeurs initiales par rapport au contrôle des points de données d'exécution.",
-        "it": "Aggiunto Pool Insights V1 con osservazioni, valutazione dello stato e supporto i18n runtime. Migliorata la generazione del testo di Pool Insights e rimossa la dipendenza dai blocchi di riepilogo esterni. Risolto il problema con l'inizializzazione mancante degli stati di runtime dell'avviso stagionale e solare dalla configurazione dell'adattatore. Aggiunte note sull'interfaccia utente di amministrazione che spiegano i valori iniziali rispetto al controllo del punto dati di runtime.",
-        "es": "Se agregó Pool Insights V1 con observaciones, evaluación de estado y soporte de tiempo de ejecución i18n. Se mejoró la generación de texto de Pool Insights y se eliminó la dependencia de bloques de resumen externos. Se corrigió la falta de inicialización de los estados de tiempo de ejecución de advertencia solar y de temporada desde la configuración del adaptador. Se agregaron notas de la interfaz de usuario del administrador que explican los valores iniciales versus el control de puntos de datos en tiempo de ejecución.",
-        "pl": "Dodano usługę Pool Insights V1 z obserwacjami, oceną stanu i obsługą środowiska wykonawczego i18n. Ulepszone generowanie tekstu Pool Insights i usunięta zależność od zewnętrznych bloków podsumowań. Naprawiono brakującą inicjalizację stanów wykonawczych sezonu i ostrzeżenia słonecznego z konfiguracji adaptera. Dodano uwagi do interfejsu administratora wyjaśniające wartości początkowe w porównaniu z kontrolą punktów danych w czasie wykonywania.",
-        "uk": "Додано Pool Insights V1 із спостереженнями, оцінкою стану та підтримкою i18n під час виконання. Покращено створення тексту Pool Insights і видалено залежність від зовнішніх блоків підсумків. Виправлено відсутність ініціалізації сезону та станів попередження про сонячне світло з конфігурації адаптера. Додано примітки інтерфейсу користувача адміністратора, що пояснюють початкові значення та керування точкою даних під час виконання.",
-        "zh-cn": "添加了 Pool Insights V1，具有观察、状态评估和运行时 i18n 支持。改进了 Pool Insights 文本生成并消除了对外部摘要块的依赖。修复了适配器配置中缺少季节和太阳警告运行时状态初始化的问题。添加了管理 UI 注释，解释初始值与运行时数据点控制。"
-      },
-      "1.3.28": {
-        "en": "Added configurable startup power check timeout for pump monitoring (5-10 seconds). Improved compatibility with delayed power measurements from smart plugs and power meters.",
-        "de": "Konfigurierbares Timeout für die Leistungsprüfung nach Pumpenstart (5-10 Sekunden) hinzugefügt. Kompatibilität mit verzögert aktualisierten Leistungswerten von Smart-Steckdosen und Leistungsmessern verbessert.",
-        "ru": "Добавлен настраиваемый тайм-аут проверки мощности при запуске для мониторинга насоса (5–10 секунд). Улучшена совместимость с измерениями мощности с задержкой от интеллектуальных розеток и измерителей мощности.",
-        "pt": "Adicionado tempo limite de verificação de energia de inicialização configurável para monitoramento da bomba (5 a 10 segundos). Compatibilidade aprimorada com medições de energia atrasadas de plugues inteligentes e medidores de energia.",
-        "nl": "Configureerbare time-out voor stroomcontrole bij opstarten toegevoegd voor pompbewaking (5-10 seconden). Verbeterde compatibiliteit met vertraagde stroommetingen van slimme stekkers en stroommeters.",
-        "fr": "Ajout d'un délai d'expiration configurable pour la vérification de l'alimentation au démarrage pour la surveillance de la pompe (5 à 10 secondes). Compatibilité améliorée avec les mesures de puissance retardées des prises intelligentes et des compteurs de puissance.",
-        "it": "Aggiunto timeout configurabile del controllo dell'alimentazione all'avvio per il monitoraggio della pompa (5-10 secondi). Compatibilità migliorata con misurazioni di potenza ritardate da prese intelligenti e misuratori di potenza.",
-        "es": "Se agregó un tiempo de espera de verificación de energía de inicio configurable para el monitoreo de la bomba (5-10 segundos). Compatibilidad mejorada con mediciones de potencia retrasadas de enchufes inteligentes y medidores de potencia.",
-        "pl": "Dodano konfigurowalny limit czasu sprawdzania mocy rozruchowej dla monitorowania pompy (5-10 sekund). Poprawiona kompatybilność z opóźnionymi pomiarami mocy z inteligentnych wtyczek i mierników mocy.",
-        "uk": "Додано настроюваний тайм-аут перевірки живлення при запуску для моніторингу насоса (5-10 секунд). Покращена сумісність із затримкою вимірювання потужності від розумних розеток і лічильників.",
-        "zh-cn": "添加了用于泵监控的可配置启动电源检查超时（5-10 秒）。改进了与智能插头和功率计的延迟功率测量的兼容性。"
       }
     },
     "titleLang": {

package/lib/helpers/chemistryOrpHelper.js

@@ -2,8 +2,14 @@
 
 const { I18n } = require('@iobroker/adapter-core');
 
-const MAX_HISTORY_AGE_MS = 30 * 24 * 60 * 60 * 1000;
+const MAX_HISTORY_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+const MAX_HISTORY_SAMPLES = 672;
+const MAX_HISTORY_BYTES = 64 * 1024;
 const MIN_SAMPLE_INTERVAL_MS = 15 * 60 * 1000;
+const MAX_DAILY_HISTORY_AGE_MS = 32 * 24 * 60 * 60 * 1000;
+const MAX_DAILY_HISTORY_SAMPLES = 32;
+const MAX_DAILY_HISTORY_BYTES = 8 * 1024;
+const DAILY_REFERENCE_TOLERANCE_MS = 4 * 24 * 60 * 60 * 1000;
 
 const chemistryOrpHelper = {
     adapter: null,
@@ -167,7 +173,7 @@ const chemistryOrpHelper = {
             return;
         }
 
-        await this._processValue(source, rawValue, reason, true);
+        await this._processValue(source, rawValue, reason, source === 'manual');
     },
 
     _scheduleEvaluation(reason, delayMs = 500) {
@@ -292,7 +298,7 @@ const chemistryOrpHelper = {
         await this._updateLastValues(value, now);
 
         const history = await this._updateHistory(value, now, forceSample);
-        const trend = await this._calculateTrend(value, now, history);
+        const trend = await this._calculateTrend(value, now, history.samples, history.dailySamples);
         const phReference = await this._updatePhReference();
         const evaluation = await this._evaluateOrp(value, phReference);
 
@@ -406,16 +412,17 @@ const chemistryOrpHelper = {
 
     async _updateHistory(value, now, forceSample) {
         let samples = await this._readJsonArray('chemistry.orp.history.samples_json');
+        const dailySeedSamples = samples;
         const nowTs = now.getTime();
         const minTs = nowTs - MAX_HISTORY_AGE_MS;
 
-        samples = samples.filter(
-            sample => sample && Number(sample.ts) >= minTs && Number.isFinite(Number(sample.value)),
-        );
+        samples = samples.filter(sample => sample.ts >= minTs && sample.ts <= nowTs);
 
         const newest = samples.length ? samples[samples.length - 1] : null;
         const newestTs = newest ? Number(newest.ts) : 0;
-        const shouldStore = forceSample || !newest || nowTs - newestTs >= MIN_SAMPLE_INTERVAL_MS;
+        const withinSampleInterval = newest && nowTs - newestTs < MIN_SAMPLE_INTERVAL_MS;
+        const sameValue = newest && Number(newest.value) === value;
+        const shouldStore = !newest || !withinSampleInterval || (forceSample && !sameValue);
 
         if (shouldStore) {
             samples.push({
@@ -425,9 +432,12 @@ const chemistryOrpHelper = {
             });
         }
 
-        samples = samples.filter(sample => sample && Number(sample.ts) >= minTs);
+        samples = samples.filter(sample => sample.ts >= minTs && sample.ts <= nowTs).slice(-MAX_HISTORY_SAMPLES);
+
+        const preparedHistory = this._prepareHistoryForWrite(samples, 'chemistry.orp.history.samples_json');
+        samples = preparedHistory.samples;
 
-        await this._setString('chemistry.orp.history.samples_json', JSON.stringify(samples));
+        await this._setString('chemistry.orp.history.samples_json', preparedHistory.json);
         await this._setNumber('chemistry.orp.history.samples_count', samples.length);
 
         if (samples.length) {
@@ -443,15 +453,20 @@ const chemistryOrpHelper = {
             );
         }
 
-        return samples;
+        const dailySamples = await this._updateDailyHistory(dailySeedSamples, value, now, shouldStore);
+        return { samples, dailySamples };
     },
 
-    async _calculateTrend(currentValue, now, samples) {
+    async _calculateTrend(currentValue, now, samples, dailySamples) {
         const nowTs = now.getTime();
 
         const ref24h = this._findReferenceSample(samples, nowTs - 24 * 60 * 60 * 1000);
         const ref7d = this._findReferenceSample(samples, nowTs - 7 * 24 * 60 * 60 * 1000);
-        const ref30d = this._findReferenceSample(samples, nowTs - 30 * 24 * 60 * 60 * 1000);
+        const ref30d = this._findReferenceSample(
+            dailySamples,
+            nowTs - 30 * 24 * 60 * 60 * 1000,
+            DAILY_REFERENCE_TOLERANCE_MS,
+        );
 
         const delta24h = ref24h ? currentValue - ref24h.value : 0;
         const delta7d = ref7d ? currentValue - ref7d.value : 0;
@@ -472,7 +487,7 @@ const chemistryOrpHelper = {
         };
     },
 
-    _findReferenceSample(samples, targetTs) {
+    _findReferenceSample(samples, targetTs, toleranceMs = null) {
         if (!samples.length) {
             return null;
         }
@@ -482,7 +497,7 @@ const chemistryOrpHelper = {
 
         for (const sample of samples) {
             const ts = Number(sample.ts);
-            const value = Number(sample.value);
+            const value = Number(sample.value ?? sample.last);
 
             if (!Number.isFinite(ts) || !Number.isFinite(value)) {
                 continue;
@@ -500,7 +515,7 @@ const chemistryOrpHelper = {
             }
         }
 
-        return best;
+        return toleranceMs === null || bestDistance <= toleranceMs ? best : null;
     },
 
     _getOverallDirection(ref24h, ref7d, ref30d, delta24h, delta7d, delta30d) {
@@ -748,17 +763,264 @@ const chemistryOrpHelper = {
         return !!state?.val;
     },
 
+    async _updateDailyHistory(shortTermSamples, value, now, sampleStored) {
+        const id = 'chemistry.orp.history.daily_json';
+        let dailySamples = await this._readDailyJson(id);
+        const nowTs = now.getTime();
+        const minTs = nowTs - MAX_DAILY_HISTORY_AGE_MS;
+        const initializeFromSeeds = dailySamples.length === 0;
+
+        if (initializeFromSeeds) {
+            const legacyValueState = await this.adapter.getStateAsync('chemistry.orp.trend.reference_30d_value');
+            const legacyAtState = await this.adapter.getStateAsync('chemistry.orp.trend.reference_30d_at');
+            const legacyValue = Number(legacyValueState?.val);
+            const legacyTs = Number(legacyAtState?.val);
+
+            if (
+                Number.isFinite(legacyValue) &&
+                legacyValue >= 0 &&
+                legacyValue <= 1200 &&
+                Number.isFinite(legacyTs) &&
+                legacyTs >= minTs &&
+                legacyTs <= nowTs &&
+                !shortTermSamples.some(sample => this._dayKey(sample.ts) === this._dayKey(legacyTs))
+            ) {
+                this._addDailySample(dailySamples, legacyTs, legacyValue);
+            }
+
+            for (const sample of shortTermSamples) {
+                if (sample.ts >= minTs && sample.ts <= nowTs) {
+                    this._addDailySample(dailySamples, sample.ts, sample.value);
+                }
+            }
+            if (sampleStored) {
+                this._addDailySample(dailySamples, nowTs, value);
+            }
+        } else if (sampleStored) {
+            this._addDailySample(dailySamples, nowTs, value);
+        }
+
+        dailySamples = dailySamples
+            .filter(sample => sample.ts >= minTs && sample.ts <= nowTs)
+            .sort((a, b) => a.ts - b.ts)
+            .slice(-MAX_DAILY_HISTORY_SAMPLES);
+
+        const preparedHistory = this._prepareDailyHistoryForWrite(dailySamples, id);
+        await this._setString(id, preparedHistory.json);
+        return preparedHistory.samples;
+    },
+
+    _addDailySample(dailySamples, sampleTs, value) {
+        const day = this._dayKey(sampleTs);
+        const existing = dailySamples.find(sample => sample.day === day);
+
+        if (!existing) {
+            dailySamples.push({
+                day,
+                ts: this._dayStartTs(sampleTs),
+                min: value,
+                max: value,
+                avg: value,
+                last: value,
+                count: 1,
+            });
+            return;
+        }
+
+        existing.min = Math.min(existing.min, value);
+        existing.max = Math.max(existing.max, value);
+        existing.avg = (existing.avg * existing.count + value) / (existing.count + 1);
+        existing.last = value;
+        existing.count += 1;
+    },
+
+    async _readDailyJson(id) {
+        const state = await this.adapter.getStateAsync(id);
+        const rawValue = state?.val;
+
+        if (rawValue === null || rawValue === undefined || rawValue === '') {
+            return [];
+        }
+
+        if (typeof rawValue !== 'string') {
+            this.adapter.log.warn(`[chemistryOrpHelper] Ignoring non-string daily history state ${id}.`);
+            return [];
+        }
+
+        if (Buffer.byteLength(rawValue, 'utf8') > MAX_DAILY_HISTORY_BYTES) {
+            this.adapter.log.warn(`[chemistryOrpHelper] Ignoring oversized daily history state ${id} (> 8 KB).`);
+            return [];
+        }
+
+        try {
+            const parsed = JSON.parse(rawValue);
+            if (!Array.isArray(parsed)) {
+                return [];
+            }
+
+            const nowTs = Date.now();
+            const normalized = parsed
+                .map(sample => {
+                    const sourceTs = Number(sample?.ts);
+                    const legacyValue = Number(sample?.value);
+                    const min = Number(sample?.min ?? legacyValue);
+                    const max = Number(sample?.max ?? legacyValue);
+                    const avg = Number(sample?.avg ?? legacyValue);
+                    const last = Number(sample?.last ?? legacyValue);
+                    const count = sample?.count === undefined ? 1 : Number(sample.count);
+
+                    if (!Number.isFinite(sourceTs) || sourceTs <= 0 || sourceTs > nowTs) {
+                        return null;
+                    }
+                    if (
+                        !Number.isFinite(min) ||
+                        !Number.isFinite(max) ||
+                        !Number.isFinite(avg) ||
+                        !Number.isFinite(last) ||
+                        min < 0 ||
+                        max > 1200 ||
+                        min > max ||
+                        avg < min ||
+                        avg > max ||
+                        last < min ||
+                        last > max
+                    ) {
+                        return null;
+                    }
+                    if (!Number.isInteger(count) || count < 1 || count > 1000000) {
+                        return null;
+                    }
+
+                    return {
+                        day: this._dayKey(sourceTs),
+                        ts: this._dayStartTs(sourceTs),
+                        min,
+                        max,
+                        avg,
+                        last,
+                        count,
+                    };
+                })
+                .filter(Boolean)
+                .sort((a, b) => a.ts - b.ts);
+
+            const byDay = new Map();
+            for (const sample of normalized) {
+                if (!byDay.has(sample.day)) {
+                    byDay.set(sample.day, sample);
+                }
+            }
+            return [...byDay.values()].slice(-MAX_DAILY_HISTORY_SAMPLES);
+        } catch {
+            return [];
+        }
+    },
+
+    _prepareDailyHistoryForWrite(samples, id) {
+        let limitedSamples = samples.slice(-MAX_DAILY_HISTORY_SAMPLES);
+        let json = JSON.stringify(limitedSamples);
+        let trimmedForSize = false;
+
+        while (limitedSamples.length && Buffer.byteLength(json, 'utf8') > MAX_DAILY_HISTORY_BYTES) {
+            limitedSamples = limitedSamples.slice(1);
+            json = JSON.stringify(limitedSamples);
+            trimmedForSize = true;
+        }
+
+        if (trimmedForSize) {
+            this.adapter.log.warn(`[chemistryOrpHelper] Daily history ${id} was trimmed to stay within 8 KB.`);
+        }
+
+        if (Buffer.byteLength(json, 'utf8') > MAX_DAILY_HISTORY_BYTES) {
+            this.adapter.log.warn(`[chemistryOrpHelper] Daily history ${id} could not be limited; resetting it.`);
+            return { samples: [], json: '[]' };
+        }
+
+        return { samples: limitedSamples, json };
+    },
+
+    _dayKey(ts) {
+        const date = new Date(ts);
+        const year = String(date.getFullYear());
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        const day = String(date.getDate()).padStart(2, '0');
+        return [year, month, day].join('-');
+    },
+
+    _dayStartTs(ts) {
+        const date = new Date(ts);
+        date.setHours(0, 0, 0, 0);
+        return date.getTime();
+    },
+
     async _readJsonArray(id) {
         const state = await this.adapter.getStateAsync(id);
+        const rawValue = state?.val;
+
+        if (rawValue === null || rawValue === undefined || rawValue === '') {
+            return [];
+        }
+
+        if (typeof rawValue !== 'string') {
+            this.adapter.log.warn(`[chemistryOrpHelper] Ignoring non-string history state ${id}.`);
+            return [];
+        }
+
+        if (Buffer.byteLength(rawValue, 'utf8') > MAX_HISTORY_BYTES) {
+            this.adapter.log.warn(`[chemistryOrpHelper] Ignoring oversized history state ${id} (> 64 KB).`);
+            return [];
+        }
 
         try {
-            const parsed = JSON.parse(String(state?.val || '[]'));
-            return Array.isArray(parsed) ? parsed : [];
+            const parsed = JSON.parse(rawValue);
+            if (!Array.isArray(parsed)) {
+                return [];
+            }
+
+            const nowTs = Date.now();
+            return parsed
+                .map(sample => {
+                    const ts = Number(sample?.ts);
+                    const value = Number(sample?.value);
+                    if (!Number.isFinite(ts) || ts <= 0 || ts > nowTs) {
+                        return null;
+                    }
+                    if (!Number.isFinite(value) || value < 0 || value > 1200) {
+                        return null;
+                    }
+                    return { ts, time: this._formatDateTime(new Date(ts)), value };
+                })
+                .filter(Boolean)
+                .sort((a, b) => a.ts - b.ts)
+                .slice(-MAX_HISTORY_SAMPLES);
         } catch {
             return [];
         }
     },
 
+    _prepareHistoryForWrite(samples, id) {
+        let limitedSamples = samples.slice(-MAX_HISTORY_SAMPLES);
+        let json = JSON.stringify(limitedSamples);
+        let trimmedForSize = false;
+
+        while (limitedSamples.length && Buffer.byteLength(json, 'utf8') > MAX_HISTORY_BYTES) {
+            limitedSamples = limitedSamples.slice(1);
+            json = JSON.stringify(limitedSamples);
+            trimmedForSize = true;
+        }
+
+        if (trimmedForSize) {
+            this.adapter.log.warn(`[chemistryOrpHelper] History ${id} was trimmed to stay within 64 KB.`);
+        }
+
+        if (Buffer.byteLength(json, 'utf8') > MAX_HISTORY_BYTES) {
+            this.adapter.log.warn(`[chemistryOrpHelper] History ${id} could not be limited safely; resetting it.`);
+            return { samples: [], json: '[]' };
+        }
+
+        return { samples: limitedSamples, json };
+    },
+
     async _setString(id, value) {
         await this.adapter.setStateChangedAsync(id, { val: String(value ?? ''), ack: true });
     },