iobroker.anomaly-detection 0.1.0

package/admin/i18n/pt.json

@@ -0,0 +1,32 @@
+{
+	"Anomaly threshold": "Anomaly threshold",
+	"Context state ID": "ID do estado do contexto",
+	"Context states (maximum 3)": "Estados de contexto (máximo 3)",
+	"Enable context-aware detection": "Habilitar detecção baseada no contexto",
+	"Enable persistent level-shift detection": "Habilitar detecção persistente de mudança de nível",
+	"Enable rate-of-change detector": "Enable rate-of-change detector",
+	"Enable stuck-state detector": "Enable stuck-state detector",
+	"Enable trend detection": "Ativar detecção de tendências",
+	"Enable value deviation detector": "Enable value deviation detector",
+	"Enabled": "Enabled",
+	"History adapter instance": "History adapter instance",
+	"History availability": "History availability",
+	"History source": "History source",
+	"History training period (days)": "History training period (days)",
+	"Import existing history": "Import existing history",
+	"Initial training": "Initial training",
+	"Learn from live values only": "Learn from live values only",
+	"Maximum imported samples": "Maximum imported samples",
+	"Minimum anomaly duration (minutes)": "Minimum anomaly duration (minutes)",
+	"Minimum learned samples": "Amostras mínimas aprendidas",
+	"Monitored numerical states": "Monitored numerical states",
+	"Name": "Name",
+	"Numeric bucket width": "Largura numérica do intervalo",
+	"Sensitivity (robust z-score)": "Sensitivity (robust z-score)",
+	"Source state ID": "Source state ID",
+	"Start monitoring after history import": "Start monitoring after history import",
+	"Stuck duration (minutes)": "Stuck duration (minutes)",
+	"Time bucket size (minutes)": "Tamanho do intervalo de tempo (minutos)",
+	"Use time-of-day context": "Use time-of-day context",
+	"Use weekday context": "Use weekday context"
+}

package/admin/i18n/ru.json

@@ -0,0 +1,32 @@
+{
+	"Anomaly threshold": "Anomaly threshold",
+	"Context state ID": "Идентификатор состояния контекста",
+	"Context states (maximum 3)": "Состояния контекста (максимум 3)",
+	"Enable context-aware detection": "Включить контекстно-зависимое обнаружение",
+	"Enable persistent level-shift detection": "Включить постоянное обнаружение сдвига уровня",
+	"Enable rate-of-change detector": "Enable rate-of-change detector",
+	"Enable stuck-state detector": "Enable stuck-state detector",
+	"Enable trend detection": "Включить обнаружение тенденций",
+	"Enable value deviation detector": "Enable value deviation detector",
+	"Enabled": "Enabled",
+	"History adapter instance": "History adapter instance",
+	"History availability": "History availability",
+	"History source": "History source",
+	"History training period (days)": "History training period (days)",
+	"Import existing history": "Import existing history",
+	"Initial training": "Initial training",
+	"Learn from live values only": "Learn from live values only",
+	"Maximum imported samples": "Maximum imported samples",
+	"Minimum anomaly duration (minutes)": "Minimum anomaly duration (minutes)",
+	"Minimum learned samples": "Минимальные изученные образцы",
+	"Monitored numerical states": "Monitored numerical states",
+	"Name": "Name",
+	"Numeric bucket width": "Числовая ширина ковша",
+	"Sensitivity (robust z-score)": "Sensitivity (robust z-score)",
+	"Source state ID": "Source state ID",
+	"Start monitoring after history import": "Start monitoring after history import",
+	"Stuck duration (minutes)": "Stuck duration (minutes)",
+	"Time bucket size (minutes)": "Размер интервала времени (минуты)",
+	"Use time-of-day context": "Use time-of-day context",
+	"Use weekday context": "Use weekday context"
+}

package/admin/i18n/uk.json

@@ -0,0 +1,32 @@
+{
+	"Anomaly threshold": "Anomaly threshold",
+	"Context state ID": "Ідентифікатор стану контексту",
+	"Context states (maximum 3)": "Стани контексту (максимум 3)",
+	"Enable context-aware detection": "Увімкнути контекстне виявлення",
+	"Enable persistent level-shift detection": "Увімкнути постійне виявлення зміни рівня",
+	"Enable rate-of-change detector": "Enable rate-of-change detector",
+	"Enable stuck-state detector": "Enable stuck-state detector",
+	"Enable trend detection": "Увімкнути виявлення тенденції",
+	"Enable value deviation detector": "Enable value deviation detector",
+	"Enabled": "Enabled",
+	"History adapter instance": "History adapter instance",
+	"History availability": "History availability",
+	"History source": "History source",
+	"History training period (days)": "History training period (days)",
+	"Import existing history": "Import existing history",
+	"Initial training": "Initial training",
+	"Learn from live values only": "Learn from live values only",
+	"Maximum imported samples": "Maximum imported samples",
+	"Minimum anomaly duration (minutes)": "Minimum anomaly duration (minutes)",
+	"Minimum learned samples": "Мінімум вивчених зразків",
+	"Monitored numerical states": "Monitored numerical states",
+	"Name": "Name",
+	"Numeric bucket width": "Числова ширина відра",
+	"Sensitivity (robust z-score)": "Sensitivity (robust z-score)",
+	"Source state ID": "Source state ID",
+	"Start monitoring after history import": "Start monitoring after history import",
+	"Stuck duration (minutes)": "Stuck duration (minutes)",
+	"Time bucket size (minutes)": "Розмір інтервалу часу (хвилини)",
+	"Use time-of-day context": "Use time-of-day context",
+	"Use weekday context": "Use weekday context"
+}

package/admin/i18n/zh-cn.json

@@ -0,0 +1,32 @@
+{
+	"Anomaly threshold": "Anomaly threshold",
+	"Context state ID": "上下文状态ID",
+	"Context states (maximum 3)": "上下文状态（最多 3 个）",
+	"Enable context-aware detection": "启用上下文感知检测",
+	"Enable persistent level-shift detection": "启用持续电平转换检测",
+	"Enable rate-of-change detector": "Enable rate-of-change detector",
+	"Enable stuck-state detector": "Enable stuck-state detector",
+	"Enable trend detection": "启用趋势检测",
+	"Enable value deviation detector": "Enable value deviation detector",
+	"Enabled": "Enabled",
+	"History adapter instance": "History adapter instance",
+	"History availability": "History availability",
+	"History source": "History source",
+	"History training period (days)": "History training period (days)",
+	"Import existing history": "Import existing history",
+	"Initial training": "Initial training",
+	"Learn from live values only": "Learn from live values only",
+	"Maximum imported samples": "Maximum imported samples",
+	"Minimum anomaly duration (minutes)": "Minimum anomaly duration (minutes)",
+	"Minimum learned samples": "最小学习样本",
+	"Monitored numerical states": "Monitored numerical states",
+	"Name": "Name",
+	"Numeric bucket width": "数字桶宽度",
+	"Sensitivity (robust z-score)": "Sensitivity (robust z-score)",
+	"Source state ID": "Source state ID",
+	"Start monitoring after history import": "Start monitoring after history import",
+	"Stuck duration (minutes)": "Stuck duration (minutes)",
+	"Time bucket size (minutes)": "时间段大小（分钟）",
+	"Use time-of-day context": "Use time-of-day context",
+	"Use weekday context": "Use weekday context"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,220 @@
+{
+	"i18n": true,
+	"type": "panel",
+	"items": {
+		"sources": {
+			"type": "table",
+			"label": "Monitored numerical states",
+			"newLine": true,
+			"xs": 12,
+			"sm": 12,
+			"md": 12,
+			"lg": 12,
+			"xl": 12,
+			"uniqueColumns": ["id"],
+			"useCardFor": ["xs", "sm", "md", "lg", "xl"],
+			"titleAttribute": "id",
+			"items": [
+				{ "attr": "enabled", "type": "checkbox", "label": "Enabled", "default": true, "xs": 12 },
+				{
+					"attr": "id",
+					"type": "objectId",
+					"label": "Source state ID",
+					"types": "state",
+					"xs": 12
+				},
+				{ "attr": "name", "type": "text", "label": "Name", "default": "", "xs": 12 },
+				{
+					"attr": "initialTraining",
+					"type": "select",
+					"label": "Initial training",
+					"default": "live",
+					"xs": 6,
+					"options": [
+						{ "label": "Learn from live values only", "value": "live" },
+						{ "label": "Import existing history", "value": "history" }
+					]
+				},
+				{
+					"attr": "historyInstance",
+					"type": "selectSendTo",
+					"label": "History source (enabled compatible providers only)",
+					"default": "",
+					"xs": 6,
+					"command": "getHistoryProviders",
+					"jsonData": "{\"sourceId\": \"${data.id}\"}",
+					"alsoDependsOn": ["id"],
+					"manual": false,
+					"noTranslation": true,
+					"hidden": "data.initialTraining !== 'history'"
+				},
+				{
+					"attr": "trainingDays",
+					"type": "number",
+					"label": "History training period (days)",
+					"min": 7,
+					"max": 365,
+					"step": 1,
+					"default": 30,
+					"xs": 6,
+					"hidden": "data.initialTraining !== 'history'"
+				},
+				{
+					"attr": "maxHistorySamples",
+					"type": "number",
+					"label": "Maximum imported samples",
+					"min": 30,
+					"max": 10000,
+					"step": 10,
+					"default": 1000,
+					"xs": 6,
+					"hidden": "data.initialTraining !== 'history'"
+				},
+				{
+					"attr": "autoStartMonitoringAfterImport",
+					"type": "checkbox",
+					"label": "Start monitoring after history import",
+					"default": true,
+					"xs": 12,
+					"hidden": "data.initialTraining !== 'history'"
+				},
+				{
+					"attr": "minimumSamples",
+					"type": "number",
+					"label": "Minimum learned samples",
+					"min": 5,
+					"max": 240,
+					"step": 1,
+					"default": 30,
+					"xs": 6
+				},
+				{
+					"attr": "bucketMinutes",
+					"type": "number",
+					"label": "Time bucket size (minutes)",
+					"min": 5,
+					"max": 720,
+					"step": 5,
+					"default": 60,
+					"xs": 6
+				},
+				{
+					"attr": "sensitivity",
+					"type": "number",
+					"label": "Sensitivity (robust z-score)",
+					"min": 0.1,
+					"max": 20,
+					"step": 0.1,
+					"default": 3.5,
+					"xs": 6
+				},
+				{
+					"attr": "anomalyThreshold",
+					"type": "number",
+					"label": "Anomaly threshold",
+					"min": 1,
+					"max": 100,
+					"step": 1,
+					"default": 70,
+					"xs": 6
+				},
+				{
+					"attr": "minimumAnomalyDurationMinutes",
+					"type": "number",
+					"label": "Minimum anomaly duration (minutes)",
+					"min": 0,
+					"max": 10080,
+					"step": 1,
+					"default": 5,
+					"xs": 6
+				},
+				{
+					"attr": "enableMad",
+					"type": "checkbox",
+					"label": "Enable value deviation detector",
+					"default": true,
+					"xs": 6
+				},
+				{
+					"attr": "enableRate",
+					"type": "checkbox",
+					"label": "Enable rate-of-change detector",
+					"default": true,
+					"xs": 6
+				},
+				{
+					"attr": "enableStuck",
+					"type": "checkbox",
+					"label": "Enable stuck-state detector",
+					"default": false,
+					"xs": 6
+				},
+				{
+					"attr": "stuckDurationMinutes",
+					"type": "number",
+					"label": "Stuck duration (minutes)",
+					"min": 1,
+					"max": 10080,
+					"step": 1,
+					"default": 120,
+					"xs": 6
+				},
+				{
+					"attr": "timeContext",
+					"type": "checkbox",
+					"label": "Use time-of-day context",
+					"default": true,
+					"xs": 6
+				},
+				{
+					"attr": "weekdayContext",
+					"type": "checkbox",
+					"label": "Use weekday context",
+					"default": false,
+					"xs": 6
+				},
+				{
+					"attr": "enableContext",
+					"type": "checkbox",
+					"label": "Enable context-aware detection",
+					"default": false,
+					"xs": 6
+				},
+				{
+					"attr": "contextStates",
+					"type": "table",
+					"label": "Context states (maximum 3)",
+					"hidden": "data.enableContext !== true",
+					"xs": 12,
+					"items": [
+						{ "attr": "id", "type": "objectId", "label": "Context state ID", "types": "state", "xs": 8 },
+						{
+							"attr": "bucketWidth",
+							"type": "number",
+							"label": "Numeric bucket width",
+							"hidden": "await getObject(data.id)?.common?.type !== 'number'",
+							"min": 0.0001,
+							"max": 1000000,
+							"default": 5,
+							"xs": 4
+						}
+					]
+				},
+				{
+					"attr": "enableChangePoint",
+					"type": "checkbox",
+					"label": "Enable persistent level-shift detection",
+					"default": false,
+					"xs": 6
+				},
+				{
+					"attr": "enableTrend",
+					"type": "checkbox",
+					"label": "Enable trend detection",
+					"default": false,
+					"xs": 6
+				}
+			]
+		}
+	}
+}

package/build/lib/advanced-detectors.js

@@ -0,0 +1,149 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var advanced_detectors_exports = {};
+__export(advanced_detectors_exports, {
+  AdvancedDetectors: () => AdvancedDetectors
+});
+module.exports = __toCommonJS(advanced_detectors_exports);
+var import_statistics = require("./model/statistics");
+const MAX_RECENT = 48;
+const MIN_RECENT = 12;
+const MIN_TREND_SPAN_MS = 6 * 60 * 60 * 1e3;
+class AdvancedDetectors {
+  recentChange;
+  recentTrend;
+  candidateDirection;
+  candidateCount;
+  constructor(change, trend) {
+    this.recentChange = sanitize(change == null ? void 0 : change.recent);
+    this.recentTrend = sanitize(trend == null ? void 0 : trend.recent);
+    this.candidateDirection = change == null ? void 0 : change.candidateDirection;
+    this.candidateCount = Number.isInteger(change == null ? void 0 : change.candidateCount) ? Math.max(0, change.candidateCount) : 0;
+  }
+  observe(residual, timestamp, longMedian, longMad, enableChangePoint, enableTrend, sensitivity) {
+    if (residual === void 0 || !Number.isFinite(residual)) {
+      return { adapt: false };
+    }
+    if (enableChangePoint) {
+      append(this.recentChange, { value: residual, timestamp });
+    }
+    if (enableTrend) {
+      append(this.recentTrend, { value: residual, timestamp });
+    }
+    const changePoint = enableChangePoint ? this.detectChangePoint(longMedian, longMad, sensitivity) : void 0;
+    const trend = enableTrend ? this.detectTrend(sensitivity) : void 0;
+    return { changePoint, trend, adapt: changePoint !== void 0 };
+  }
+  toJSON() {
+    return {
+      changePoint: {
+        recent: [...this.recentChange],
+        candidateDirection: this.candidateDirection,
+        candidateCount: this.candidateCount
+      },
+      trend: { recent: [...this.recentTrend] }
+    };
+  }
+  detectChangePoint(longMedian, longMad, sensitivity) {
+    if (this.recentChange.length < MIN_RECENT || longMedian === void 0 || longMad === void 0) {
+      this.resetCandidate();
+      return void 0;
+    }
+    const recentMedian = (0, import_statistics.median)(this.recentChange.slice(-MIN_RECENT).map((sample) => sample.value));
+    if (recentMedian === void 0) {
+      return void 0;
+    }
+    const delta = recentMedian - longMedian;
+    const scale = Math.max(longMad, 1e-9);
+    const normalized = Math.abs(delta) / scale;
+    if (normalized < sensitivity) {
+      this.resetCandidate();
+      return void 0;
+    }
+    const direction = delta >= 0 ? "upward" : "downward";
+    this.candidateCount = this.candidateDirection === direction ? this.candidateCount + 1 : 1;
+    this.candidateDirection = direction;
+    if (this.candidateCount < 3) {
+      return void 0;
+    }
+    return {
+      name: "changePoint",
+      score: (0, import_statistics.clamp)(normalized / sensitivity * 80, 70, 100),
+      reason: `Persistent ${direction} level shift detected`
+    };
+  }
+  detectTrend(sensitivity) {
+    var _a, _b;
+    if (this.recentTrend.length < MIN_RECENT) {
+      return void 0;
+    }
+    const first = this.recentTrend[0];
+    const last = this.recentTrend[this.recentTrend.length - 1];
+    const span = last.timestamp - first.timestamp;
+    if (span < MIN_TREND_SPAN_MS) {
+      return void 0;
+    }
+    const slopes = [];
+    for (let left = 0; left < this.recentTrend.length; left++) {
+      for (let right = left + 1; right < this.recentTrend.length; right++) {
+        const elapsed = this.recentTrend[right].timestamp - this.recentTrend[left].timestamp;
+        if (elapsed > 0) {
+          slopes.push((this.recentTrend[right].value - this.recentTrend[left].value) / elapsed);
+        }
+      }
+    }
+    const slope = (0, import_statistics.median)(slopes);
+    const center = (_a = (0, import_statistics.median)(this.recentTrend.map((sample) => sample.value))) != null ? _a : 0;
+    const residualMad = (_b = (0, import_statistics.median)(this.recentTrend.map((sample) => Math.abs(sample.value - center)))) != null ? _b : 0;
+    if (slope === void 0) {
+      return void 0;
+    }
+    const normalized = Math.abs(slope * span) / Math.max(residualMad, 1e-9);
+    if (normalized < sensitivity) {
+      return void 0;
+    }
+    const direction = slope >= 0 ? "upward" : "downward";
+    return {
+      name: "trend",
+      score: (0, import_statistics.clamp)(normalized / sensitivity * 60, 55, 95),
+      reason: `Sustained ${direction} trend outside normal behavior`
+    };
+  }
+  resetCandidate() {
+    this.candidateDirection = void 0;
+    this.candidateCount = 0;
+  }
+}
+function append(target, value) {
+  if (target.length > 0 && value.timestamp <= target[target.length - 1].timestamp) {
+    return;
+  }
+  target.push(value);
+  if (target.length > MAX_RECENT) {
+    target.splice(0, target.length - MAX_RECENT);
+  }
+}
+function sanitize(values) {
+  return (values != null ? values : []).filter((sample) => Number.isFinite(sample.value) && Number.isFinite(sample.timestamp)).sort((left, right) => left.timestamp - right.timestamp).slice(-MAX_RECENT);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AdvancedDetectors
+});
+//# sourceMappingURL=advanced-detectors.js.map

package/build/lib/advanced-detectors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/advanced-detectors.ts"],
+  "sourcesContent": ["import { clamp, median } from \"./model/statistics\";\nimport type { DetectorResult } from \"./detectors\";\n\nexport interface TimedResidual {\n\tvalue: number;\n\ttimestamp: number;\n}\n\nexport interface ChangePointData {\n\trecent: TimedResidual[];\n\tcandidateDirection?: \"upward\" | \"downward\";\n\tcandidateCount: number;\n}\n\nexport interface TrendData {\n\trecent: TimedResidual[];\n}\n\nexport interface AdvancedEvaluation {\n\tchangePoint?: DetectorResult;\n\ttrend?: DetectorResult;\n\tadapt: boolean;\n}\n\nconst MAX_RECENT = 48;\nconst MIN_RECENT = 12;\nconst MIN_TREND_SPAN_MS = 6 * 60 * 60 * 1000;\n\n/** Maintains bounded residual windows for robust level-shift and trend evaluation. */\nexport class AdvancedDetectors {\n\tprivate recentChange: TimedResidual[];\n\tprivate recentTrend: TimedResidual[];\n\tprivate candidateDirection: \"upward\" | \"downward\" | undefined;\n\tprivate candidateCount: number;\n\n\tpublic constructor(change?: ChangePointData, trend?: TrendData) {\n\t\tthis.recentChange = sanitize(change?.recent);\n\t\tthis.recentTrend = sanitize(trend?.recent);\n\t\tthis.candidateDirection = change?.candidateDirection;\n\t\tthis.candidateCount = Number.isInteger(change?.candidateCount) ? Math.max(0, change!.candidateCount) : 0;\n\t}\n\n\tpublic observe(\n\t\tresidual: number | undefined,\n\t\ttimestamp: number,\n\t\tlongMedian: number | undefined,\n\t\tlongMad: number | undefined,\n\t\tenableChangePoint: boolean,\n\t\tenableTrend: boolean,\n\t\tsensitivity: number,\n\t): AdvancedEvaluation {\n\t\tif (residual === undefined || !Number.isFinite(residual)) {\n\t\t\treturn { adapt: false };\n\t\t}\n\t\tif (enableChangePoint) {\n\t\t\tappend(this.recentChange, { value: residual, timestamp });\n\t\t}\n\t\tif (enableTrend) {\n\t\t\tappend(this.recentTrend, { value: residual, timestamp });\n\t\t}\n\t\tconst changePoint = enableChangePoint ? this.detectChangePoint(longMedian, longMad, sensitivity) : undefined;\n\t\tconst trend = enableTrend ? this.detectTrend(sensitivity) : undefined;\n\t\treturn { changePoint, trend, adapt: changePoint !== undefined };\n\t}\n\n\tpublic toJSON(): { changePoint: ChangePointData; trend: TrendData } {\n\t\treturn {\n\t\t\tchangePoint: {\n\t\t\t\trecent: [...this.recentChange],\n\t\t\t\tcandidateDirection: this.candidateDirection,\n\t\t\t\tcandidateCount: this.candidateCount,\n\t\t\t},\n\t\t\ttrend: { recent: [...this.recentTrend] },\n\t\t};\n\t}\n\n\tprivate detectChangePoint(\n\t\tlongMedian: number | undefined,\n\t\tlongMad: number | undefined,\n\t\tsensitivity: number,\n\t): DetectorResult | undefined {\n\t\tif (this.recentChange.length < MIN_RECENT || longMedian === undefined || longMad === undefined) {\n\t\t\tthis.resetCandidate();\n\t\t\treturn undefined;\n\t\t}\n\t\tconst recentMedian = median(this.recentChange.slice(-MIN_RECENT).map(sample => sample.value));\n\t\tif (recentMedian === undefined) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst delta = recentMedian - longMedian;\n\t\tconst scale = Math.max(longMad, 1e-9);\n\t\tconst normalized = Math.abs(delta) / scale;\n\t\tif (normalized < sensitivity) {\n\t\t\tthis.resetCandidate();\n\t\t\treturn undefined;\n\t\t}\n\t\tconst direction = delta >= 0 ? \"upward\" : \"downward\";\n\t\tthis.candidateCount = this.candidateDirection === direction ? this.candidateCount + 1 : 1;\n\t\tthis.candidateDirection = direction;\n\t\tif (this.candidateCount < 3) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn {\n\t\t\tname: \"changePoint\",\n\t\t\tscore: clamp((normalized / sensitivity) * 80, 70, 100),\n\t\t\treason: `Persistent ${direction} level shift detected`,\n\t\t};\n\t}\n\n\tprivate detectTrend(sensitivity: number): DetectorResult | undefined {\n\t\tif (this.recentTrend.length < MIN_RECENT) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst first = this.recentTrend[0];\n\t\tconst last = this.recentTrend[this.recentTrend.length - 1];\n\t\tconst span = last.timestamp - first.timestamp;\n\t\tif (span < MIN_TREND_SPAN_MS) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst slopes: number[] = [];\n\t\tfor (let left = 0; left < this.recentTrend.length; left++) {\n\t\t\tfor (let right = left + 1; right < this.recentTrend.length; right++) {\n\t\t\t\tconst elapsed = this.recentTrend[right].timestamp - this.recentTrend[left].timestamp;\n\t\t\t\tif (elapsed > 0) {\n\t\t\t\t\tslopes.push((this.recentTrend[right].value - this.recentTrend[left].value) / elapsed);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tconst slope = median(slopes);\n\t\tconst center = median(this.recentTrend.map(sample => sample.value)) ?? 0;\n\t\tconst residualMad = median(this.recentTrend.map(sample => Math.abs(sample.value - center))) ?? 0;\n\t\tif (slope === undefined) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst normalized = Math.abs(slope * span) / Math.max(residualMad, 1e-9);\n\t\tif (normalized < sensitivity) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst direction = slope >= 0 ? \"upward\" : \"downward\";\n\t\treturn {\n\t\t\tname: \"trend\",\n\t\t\tscore: clamp((normalized / sensitivity) * 60, 55, 95),\n\t\t\treason: `Sustained ${direction} trend outside normal behavior`,\n\t\t};\n\t}\n\n\tprivate resetCandidate(): void {\n\t\tthis.candidateDirection = undefined;\n\t\tthis.candidateCount = 0;\n\t}\n}\n\nfunction append(target: TimedResidual[], value: TimedResidual): void {\n\tif (target.length > 0 && value.timestamp <= target[target.length - 1].timestamp) {\n\t\treturn;\n\t}\n\ttarget.push(value);\n\tif (target.length > MAX_RECENT) {\n\t\ttarget.splice(0, target.length - MAX_RECENT);\n\t}\n}\n\nfunction sanitize(values: readonly TimedResidual[] | undefined): TimedResidual[] {\n\treturn (values ?? [])\n\t\t.filter(sample => Number.isFinite(sample.value) && Number.isFinite(sample.timestamp))\n\t\t.sort((left, right) => left.timestamp - right.timestamp)\n\t\t.slice(-MAX_RECENT);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/lib/context-value.js

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var context_value_exports = {};
+__export(context_value_exports, {
+  createContextPart: () => createContextPart
+});
+module.exports = __toCommonJS(context_value_exports);
+function createContextPart(id, value, bucketWidth) {
+  if (typeof value === "boolean") {
+    return `${id}=boolean:${value}`;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    const width = bucketWidth && bucketWidth > 0 ? bucketWidth : 5;
+    const start = Math.floor(value / width) * width;
+    return `${id}=number:${start}:${start + width}`;
+  }
+  if (typeof value === "string" && value.trim() && value.length <= 96) {
+    return `${id}=string:${value}`;
+  }
+  return void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createContextPart
+});
+//# sourceMappingURL=context-value.js.map

package/build/lib/context-value.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/context-value.ts"],
+  "sourcesContent": ["/**\n * Creates a stable context-key fragment while preserving valid falsy boolean and numeric values.\n *\n * @param id Configured context state ID.\n * @param value Current context state value.\n * @param bucketWidth Optional width for numerical context buckets.\n */\nexport function createContextPart(\n\tid: string,\n\tvalue: ioBroker.StateValue | undefined,\n\tbucketWidth?: number,\n): string | undefined {\n\tif (typeof value === \"boolean\") {\n\t\treturn `${id}=boolean:${value}`;\n\t}\n\tif (typeof value === \"number\" && Number.isFinite(value)) {\n\t\tconst width = bucketWidth && bucketWidth > 0 ? bucketWidth : 5;\n\t\tconst start = Math.floor(value / width) * width;\n\t\treturn `${id}=number:${start}:${start + width}`;\n\t}\n\tif (typeof value === \"string\" && value.trim() && value.length <= 96) {\n\t\treturn `${id}=string:${value}`;\n\t}\n\treturn undefined;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,SAAS,kBACf,IACA,OACA,aACqB;AACrB,MAAI,OAAO,UAAU,WAAW;AAC/B,WAAO,GAAG,EAAE,YAAY,KAAK;AAAA,EAC9B;AACA,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GAAG;AACxD,UAAM,QAAQ,eAAe,cAAc,IAAI,cAAc;AAC7D,UAAM,QAAQ,KAAK,MAAM,QAAQ,KAAK,IAAI;AAC1C,WAAO,GAAG,EAAE,WAAW,KAAK,IAAI,QAAQ,KAAK;AAAA,EAC9C;AACA,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,KAAK,MAAM,UAAU,IAAI;AACpE,WAAO,GAAG,EAAE,WAAW,KAAK;AAAA,EAC7B;AACA,SAAO;AACR;",
+  "names": []
+}

package/build/lib/detectors.js

@@ -0,0 +1,76 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var detectors_exports = {};
+__export(detectors_exports, {
+  detectMadDeviation: () => detectMadDeviation,
+  detectRateDeviation: () => detectRateDeviation,
+  detectStuck: () => detectStuck
+});
+module.exports = __toCommonJS(detectors_exports);
+var import_statistics = require("./model/statistics");
+function detectMadDeviation(value, series, minimumSamples, sensitivity) {
+  if (series.count < minimumSamples) {
+    return void 0;
+  }
+  const median = series.median();
+  const mad = series.mad();
+  if (median === void 0 || mad === void 0) {
+    return void 0;
+  }
+  const deviation = Math.abs(value - median);
+  const robustZ = mad === 0 ? deviation === 0 ? 0 : Number.POSITIVE_INFINITY : 0.6745 * deviation / mad;
+  const score = robustZ === Number.POSITIVE_INFINITY ? 100 : (0, import_statistics.clamp)(robustZ / sensitivity * 100, 0, 100);
+  return { name: "value", score, reason: "Value is significantly outside the normal range for this time period" };
+}
+function detectRateDeviation(rate, series, minimumSamples, sensitivity) {
+  if (rate === void 0 || !Number.isFinite(rate) || series.count < minimumSamples) {
+    return void 0;
+  }
+  const median = series.median();
+  const mad = series.mad();
+  if (median === void 0 || mad === void 0) {
+    return void 0;
+  }
+  const deviation = Math.abs(rate - median);
+  const robustZ = mad === 0 ? deviation === 0 ? 0 : Number.POSITIVE_INFINITY : 0.6745 * deviation / mad;
+  const score = robustZ === Number.POSITIVE_INFINITY ? 100 : (0, import_statistics.clamp)(robustZ / sensitivity * 100, 0, 100);
+  return { name: "rate", score, reason: "Rate of change is unusually high" };
+}
+function detectStuck(repeatedSince, timestamp, stuckDurationMinutes) {
+  if (repeatedSince === void 0 || timestamp < repeatedSince) {
+    return void 0;
+  }
+  const duration = timestamp - repeatedSince;
+  const limit = stuckDurationMinutes * 6e4;
+  if (limit <= 0 || duration < limit) {
+    return void 0;
+  }
+  return {
+    name: "stuck",
+    score: (0, import_statistics.clamp)(duration / limit * 50, 50, 100),
+    reason: "Value has remained unchanged significantly longer than configured"
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectMadDeviation,
+  detectRateDeviation,
+  detectStuck
+});
+//# sourceMappingURL=detectors.js.map