iobroker.anomaly-detection 0.1.0

package/build/lib/detectors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/detectors.ts"],
+  "sourcesContent": ["import { clamp, type SampleSeries } from \"./model/statistics\";\n\nexport interface DetectorResult {\n\tname: \"value\" | \"context\" | \"rate\" | \"stuck\" | \"changePoint\" | \"trend\";\n\tscore: number;\n\treason: string;\n}\n\nexport function detectMadDeviation(\n\tvalue: number,\n\tseries: SampleSeries,\n\tminimumSamples: number,\n\tsensitivity: number,\n): DetectorResult | undefined {\n\tif (series.count < minimumSamples) {\n\t\treturn undefined;\n\t}\n\tconst median = series.median();\n\tconst mad = series.mad();\n\tif (median === undefined || mad === undefined) {\n\t\treturn undefined;\n\t}\n\tconst deviation = Math.abs(value - median);\n\tconst robustZ = mad === 0 ? (deviation === 0 ? 0 : Number.POSITIVE_INFINITY) : (0.6745 * deviation) / mad;\n\tconst score = robustZ === Number.POSITIVE_INFINITY ? 100 : clamp((robustZ / sensitivity) * 100, 0, 100);\n\treturn { name: \"value\", score, reason: \"Value is significantly outside the normal range for this time period\" };\n}\n\nexport function detectRateDeviation(\n\trate: number | undefined,\n\tseries: SampleSeries,\n\tminimumSamples: number,\n\tsensitivity: number,\n): DetectorResult | undefined {\n\tif (rate === undefined || !Number.isFinite(rate) || series.count < minimumSamples) {\n\t\treturn undefined;\n\t}\n\tconst median = series.median();\n\tconst mad = series.mad();\n\tif (median === undefined || mad === undefined) {\n\t\treturn undefined;\n\t}\n\tconst deviation = Math.abs(rate - median);\n\tconst robustZ = mad === 0 ? (deviation === 0 ? 0 : Number.POSITIVE_INFINITY) : (0.6745 * deviation) / mad;\n\tconst score = robustZ === Number.POSITIVE_INFINITY ? 100 : clamp((robustZ / sensitivity) * 100, 0, 100);\n\treturn { name: \"rate\", score, reason: \"Rate of change is unusually high\" };\n}\n\nexport function detectStuck(\n\trepeatedSince: number | undefined,\n\ttimestamp: number,\n\tstuckDurationMinutes: number,\n): DetectorResult | undefined {\n\tif (repeatedSince === undefined || timestamp < repeatedSince) {\n\t\treturn undefined;\n\t}\n\tconst duration = timestamp - repeatedSince;\n\tconst limit = stuckDurationMinutes * 60_000;\n\tif (limit <= 0 || duration < limit) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tname: \"stuck\",\n\t\tscore: clamp((duration / limit) * 50, 50, 100),\n\t\treason: \"Value has remained unchanged significantly longer than configured\",\n\t};\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAyC;AAQlC,SAAS,mBACf,OACA,QACA,gBACA,aAC6B;AAC7B,MAAI,OAAO,QAAQ,gBAAgB;AAClC,WAAO;AAAA,EACR;AACA,QAAM,SAAS,OAAO,OAAO;AAC7B,QAAM,MAAM,OAAO,IAAI;AACvB,MAAI,WAAW,UAAa,QAAQ,QAAW;AAC9C,WAAO;AAAA,EACR;AACA,QAAM,YAAY,KAAK,IAAI,QAAQ,MAAM;AACzC,QAAM,UAAU,QAAQ,IAAK,cAAc,IAAI,IAAI,OAAO,oBAAsB,SAAS,YAAa;AACtG,QAAM,QAAQ,YAAY,OAAO,oBAAoB,UAAM,yBAAO,UAAU,cAAe,KAAK,GAAG,GAAG;AACtG,SAAO,EAAE,MAAM,SAAS,OAAO,QAAQ,uEAAuE;AAC/G;AAEO,SAAS,oBACf,MACA,QACA,gBACA,aAC6B;AAC7B,MAAI,SAAS,UAAa,CAAC,OAAO,SAAS,IAAI,KAAK,OAAO,QAAQ,gBAAgB;AAClF,WAAO;AAAA,EACR;AACA,QAAM,SAAS,OAAO,OAAO;AAC7B,QAAM,MAAM,OAAO,IAAI;AACvB,MAAI,WAAW,UAAa,QAAQ,QAAW;AAC9C,WAAO;AAAA,EACR;AACA,QAAM,YAAY,KAAK,IAAI,OAAO,MAAM;AACxC,QAAM,UAAU,QAAQ,IAAK,cAAc,IAAI,IAAI,OAAO,oBAAsB,SAAS,YAAa;AACtG,QAAM,QAAQ,YAAY,OAAO,oBAAoB,UAAM,yBAAO,UAAU,cAAe,KAAK,GAAG,GAAG;AACtG,SAAO,EAAE,MAAM,QAAQ,OAAO,QAAQ,mCAAmC;AAC1E;AAEO,SAAS,YACf,eACA,WACA,sBAC6B;AAC7B,MAAI,kBAAkB,UAAa,YAAY,eAAe;AAC7D,WAAO;AAAA,EACR;AACA,QAAM,WAAW,YAAY;AAC7B,QAAM,QAAQ,uBAAuB;AACrC,MAAI,SAAS,KAAK,WAAW,OAAO;AACnC,WAAO;AAAA,EACR;AACA,SAAO;AAAA,IACN,MAAM;AAAA,IACN,WAAO,yBAAO,WAAW,QAAS,IAAI,IAAI,GAAG;AAAA,IAC7C,QAAQ;AAAA,EACT;AACD;",
+  "names": []
+}

package/build/lib/history-provider.js

@@ -0,0 +1,58 @@
+"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 history_provider_exports = {};
+__export(history_provider_exports, {
+  sanitizeHistory: () => sanitizeHistory
+});
+module.exports = __toCommonJS(history_provider_exports);
+function sanitizeHistory(raw, limit) {
+  if (!Number.isInteger(limit) || limit < 1) {
+    return [];
+  }
+  const entries = Array.isArray(raw) ? raw : raw && typeof raw === "object" && Array.isArray(raw.result) ? raw.result : [];
+  const byTimestamp = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (!entry || typeof entry !== "object") {
+      continue;
+    }
+    const candidate = entry;
+    const value = typeof candidate.val === "number" ? candidate.val : Number(candidate.val);
+    const timestamp = typeof candidate.ts === "number" ? candidate.ts : Number(candidate.ts);
+    if (Number.isFinite(value) && Number.isFinite(timestamp) && timestamp > 0) {
+      byTimestamp.set(timestamp, { value, timestamp });
+    }
+  }
+  const sorted = [...byTimestamp.values()].sort((left, right) => left.timestamp - right.timestamp);
+  if (sorted.length <= limit) {
+    return sorted;
+  }
+  if (limit === 1) {
+    return [sorted[0]];
+  }
+  const result = [];
+  for (let index = 0; index < limit; index++) {
+    result.push(sorted[Math.round(index * (sorted.length - 1) / (limit - 1))]);
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sanitizeHistory
+});
+//# sourceMappingURL=history-provider.js.map

package/build/lib/history-provider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/history-provider.ts"],
+  "sourcesContent": ["/** A numerical state sample returned by a history provider. */\nexport interface HistorySample {\n\tvalue: number;\n\ttimestamp: number;\n}\n\n/** Generic access contract for an ioBroker history adapter. */\nexport interface HistoryProvider {\n\tgetHistory(sourceId: string, start: number, end: number, limit: number): Promise<unknown>;\n}\n\n/**\n * Normalizes the result shapes commonly returned by ioBroker history adapters.\n * Duplicate timestamps keep the final value; evenly spaced downsampling preserves whole-range coverage.\n *\n * @param raw History response to normalize.\n * @param limit Maximum number of representative samples.\n */\nexport function sanitizeHistory(raw: unknown, limit: number): HistorySample[] {\n\tif (!Number.isInteger(limit) || limit < 1) {\n\t\treturn [];\n\t}\n\tconst entries = Array.isArray(raw)\n\t\t? raw\n\t\t: raw && typeof raw === \"object\" && Array.isArray((raw as { result?: unknown }).result)\n\t\t\t? (raw as { result: unknown[] }).result\n\t\t\t: [];\n\tconst byTimestamp = new Map<number, HistorySample>();\n\tfor (const entry of entries) {\n\t\tif (!entry || typeof entry !== \"object\") {\n\t\t\tcontinue;\n\t\t}\n\t\tconst candidate = entry as { val?: unknown; ts?: unknown };\n\t\tconst value = typeof candidate.val === \"number\" ? candidate.val : Number(candidate.val);\n\t\tconst timestamp = typeof candidate.ts === \"number\" ? candidate.ts : Number(candidate.ts);\n\t\tif (Number.isFinite(value) && Number.isFinite(timestamp) && timestamp > 0) {\n\t\t\tbyTimestamp.set(timestamp, { value, timestamp });\n\t\t}\n\t}\n\tconst sorted = [...byTimestamp.values()].sort((left, right) => left.timestamp - right.timestamp);\n\tif (sorted.length <= limit) {\n\t\treturn sorted;\n\t}\n\tif (limit === 1) {\n\t\treturn [sorted[0]];\n\t}\n\tconst result: HistorySample[] = [];\n\tfor (let index = 0; index < limit; index++) {\n\t\tresult.push(sorted[Math.round((index * (sorted.length - 1)) / (limit - 1))]);\n\t}\n\treturn result;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBO,SAAS,gBAAgB,KAAc,OAAgC;AAC7E,MAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AAC1C,WAAO,CAAC;AAAA,EACT;AACA,QAAM,UAAU,MAAM,QAAQ,GAAG,IAC9B,MACA,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAS,IAA6B,MAAM,IAClF,IAA8B,SAC/B,CAAC;AACL,QAAM,cAAc,oBAAI,IAA2B;AACnD,aAAW,SAAS,SAAS;AAC5B,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACxC;AAAA,IACD;AACA,UAAM,YAAY;AAClB,UAAM,QAAQ,OAAO,UAAU,QAAQ,WAAW,UAAU,MAAM,OAAO,UAAU,GAAG;AACtF,UAAM,YAAY,OAAO,UAAU,OAAO,WAAW,UAAU,KAAK,OAAO,UAAU,EAAE;AACvF,QAAI,OAAO,SAAS,KAAK,KAAK,OAAO,SAAS,SAAS,KAAK,YAAY,GAAG;AAC1E,kBAAY,IAAI,WAAW,EAAE,OAAO,UAAU,CAAC;AAAA,IAChD;AAAA,EACD;AACA,QAAM,SAAS,CAAC,GAAG,YAAY,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,UAAU,KAAK,YAAY,MAAM,SAAS;AAC/F,MAAI,OAAO,UAAU,OAAO;AAC3B,WAAO;AAAA,EACR;AACA,MAAI,UAAU,GAAG;AAChB,WAAO,CAAC,OAAO,CAAC,CAAC;AAAA,EAClB;AACA,QAAM,SAA0B,CAAC;AACjC,WAAS,QAAQ,GAAG,QAAQ,OAAO,SAAS;AAC3C,WAAO,KAAK,OAAO,KAAK,MAAO,SAAS,OAAO,SAAS,MAAO,QAAQ,EAAE,CAAC,CAAC;AAAA,EAC5E;AACA,SAAO;AACR;",
+  "names": []
+}

package/build/lib/history-source-resolver.js

@@ -0,0 +1,109 @@
+"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 history_source_resolver_exports = {};
+__export(history_source_resolver_exports, {
+  HistorySourceResolver: () => HistorySourceResolver,
+  isCompleteInstanceId: () => isCompleteInstanceId,
+  selectHistorySource: () => selectHistorySource
+});
+module.exports = __toCommonJS(history_source_resolver_exports);
+class HistorySourceResolver {
+  constructor(objects) {
+    this.objects = objects;
+  }
+  async resolve(configuredSourceId) {
+    const configuredObject = await this.objects.getForeignObjectAsync(configuredSourceId);
+    if (!isStateObject(configuredObject)) {
+      return [];
+    }
+    const targetId = getAliasReadTarget(configuredObject);
+    const sources = [
+      { id: configuredSourceId, object: configuredObject }
+    ];
+    if (targetId && targetId !== configuredSourceId) {
+      const targetObject = await this.objects.getForeignObjectAsync(targetId);
+      if (isStateObject(targetObject)) {
+        sources.push({ id: targetId, object: targetObject });
+      }
+    }
+    const resolved = /* @__PURE__ */ new Map();
+    for (const source of sources) {
+      for (const instanceId of enabledHistoryInstances(source.object)) {
+        if (resolved.has(instanceId) || !await this.isUsableHistoryInstance(instanceId)) {
+          continue;
+        }
+        resolved.set(instanceId, { instanceId, sourceId: source.id });
+      }
+    }
+    return [...resolved.values()].sort((left, right) => left.instanceId.localeCompare(right.instanceId));
+  }
+  async isUsableHistoryInstance(instanceId) {
+    var _a;
+    if (!isCompleteInstanceId(instanceId)) {
+      return false;
+    }
+    const instance = await this.objects.getForeignObjectAsync(`system.adapter.${instanceId}`);
+    if (!instance || instance.type !== "instance" || instance.common.enabled !== true) {
+      return false;
+    }
+    return instance.common.getHistory === true || ((_a = instance.common.supportedMessages) == null ? void 0 : _a.getHistory) === true;
+  }
+}
+function isCompleteInstanceId(value) {
+  return typeof value === "string" && /^[A-Za-z0-9_-]+\.\d+$/.test(value);
+}
+function selectHistorySource(configuredSourceId, instanceId, candidates) {
+  if (!isCompleteInstanceId(instanceId)) {
+    throw new Error(
+      `Invalid history instance '${instanceId}' configured for ${configuredSourceId}. Select a complete instance ID such as 'influxdb.0'.`
+    );
+  }
+  const source = candidates.find((candidate) => candidate.instanceId === instanceId);
+  if (!source) {
+    throw new Error(
+      `History instance '${instanceId}' is not enabled for ${configuredSourceId} or its alias target. Select a current history source.`
+    );
+  }
+  return source;
+}
+function isStateObject(object) {
+  return (object == null ? void 0 : object.type) === "state";
+}
+function getAliasReadTarget(object) {
+  var _a;
+  const aliasId = (_a = object.common.alias) == null ? void 0 : _a.id;
+  if (typeof aliasId === "string") {
+    return aliasId;
+  }
+  if (aliasId && typeof aliasId.read === "string" && aliasId.read.trim()) {
+    return aliasId.read;
+  }
+  return void 0;
+}
+function enabledHistoryInstances(object) {
+  var _a;
+  return Object.entries((_a = object.common.custom) != null ? _a : {}).filter(([instanceId, settings]) => isCompleteInstanceId(instanceId) && (settings == null ? void 0 : settings.enabled) === true).map(([instanceId]) => instanceId);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HistorySourceResolver,
+  isCompleteInstanceId,
+  selectHistorySource
+});
+//# sourceMappingURL=history-source-resolver.js.map

package/build/lib/history-source-resolver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/history-source-resolver.ts"],
+  "sourcesContent": ["export interface HistorySource {\n\tinstanceId: string;\n\tsourceId: string;\n}\n\nexport interface HistoryObjectStore {\n\tgetForeignObjectAsync(id: string): Promise<ioBroker.Object | null | undefined>;\n}\n\n/** Resolves enabled per-state history settings without querying a history database. */\nexport class HistorySourceResolver {\n\tpublic constructor(private readonly objects: HistoryObjectStore) {}\n\n\tpublic async resolve(configuredSourceId: string): Promise<HistorySource[]> {\n\t\tconst configuredObject = await this.objects.getForeignObjectAsync(configuredSourceId);\n\t\tif (!isStateObject(configuredObject)) {\n\t\t\treturn [];\n\t\t}\n\t\tconst targetId = getAliasReadTarget(configuredObject);\n\t\tconst sources: Array<{ id: string; object: ioBroker.StateObject }> = [\n\t\t\t{ id: configuredSourceId, object: configuredObject },\n\t\t];\n\t\tif (targetId && targetId !== configuredSourceId) {\n\t\t\tconst targetObject = await this.objects.getForeignObjectAsync(targetId);\n\t\t\tif (isStateObject(targetObject)) {\n\t\t\t\tsources.push({ id: targetId, object: targetObject });\n\t\t\t}\n\t\t}\n\n\t\tconst resolved = new Map<string, HistorySource>();\n\t\tfor (const source of sources) {\n\t\t\tfor (const instanceId of enabledHistoryInstances(source.object)) {\n\t\t\t\tif (resolved.has(instanceId) || !(await this.isUsableHistoryInstance(instanceId))) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\t// The configured alias is visited first, so its own history wins over its target's history.\n\t\t\t\tresolved.set(instanceId, { instanceId, sourceId: source.id });\n\t\t\t}\n\t\t}\n\t\treturn [...resolved.values()].sort((left, right) => left.instanceId.localeCompare(right.instanceId));\n\t}\n\n\tprivate async isUsableHistoryInstance(instanceId: string): Promise<boolean> {\n\t\tif (!isCompleteInstanceId(instanceId)) {\n\t\t\treturn false;\n\t\t}\n\t\tconst instance = await this.objects.getForeignObjectAsync(`system.adapter.${instanceId}`);\n\t\tif (!instance || instance.type !== \"instance\" || instance.common.enabled !== true) {\n\t\t\treturn false;\n\t\t}\n\t\treturn instance.common.getHistory === true || instance.common.supportedMessages?.getHistory === true;\n\t}\n}\n\n/** True only for a complete ioBroker adapter instance ID such as `influxdb.0`. */\nexport function isCompleteInstanceId(value: unknown): boolean {\n\treturn typeof value === \"string\" && /^[A-Za-z0-9_-]+\\.\\d+$/.test(value);\n}\n\n/** Validates a persisted selection against the currently enabled history sources. */\nexport function selectHistorySource(\n\tconfiguredSourceId: string,\n\tinstanceId: string,\n\tcandidates: readonly HistorySource[],\n): HistorySource {\n\tif (!isCompleteInstanceId(instanceId)) {\n\t\tthrow new Error(\n\t\t\t`Invalid history instance '${instanceId}' configured for ${configuredSourceId}. Select a complete instance ID such as 'influxdb.0'.`,\n\t\t);\n\t}\n\tconst source = candidates.find(candidate => candidate.instanceId === instanceId);\n\tif (!source) {\n\t\tthrow new Error(\n\t\t\t`History instance '${instanceId}' is not enabled for ${configuredSourceId} or its alias target. Select a current history source.`,\n\t\t);\n\t}\n\treturn source;\n}\n\nfunction isStateObject(object: ioBroker.Object | null | undefined): object is ioBroker.StateObject {\n\treturn object?.type === \"state\";\n}\n\nfunction getAliasReadTarget(object: ioBroker.StateObject): string | undefined {\n\tconst aliasId = object.common.alias?.id;\n\tif (typeof aliasId === \"string\") {\n\t\treturn aliasId;\n\t}\n\tif (aliasId && typeof aliasId.read === \"string\" && aliasId.read.trim()) {\n\t\treturn aliasId.read;\n\t}\n\treturn undefined;\n}\n\nfunction enabledHistoryInstances(object: ioBroker.StateObject): string[] {\n\treturn Object.entries(object.common.custom ?? {})\n\t\t.filter(([instanceId, settings]) => isCompleteInstanceId(instanceId) && settings?.enabled === true)\n\t\t.map(([instanceId]) => instanceId);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUO,MAAM,sBAAsB;AAAA,EAC3B,YAA6B,SAA6B;AAA7B;AAAA,EAA8B;AAAA,EAElE,MAAa,QAAQ,oBAAsD;AAC1E,UAAM,mBAAmB,MAAM,KAAK,QAAQ,sBAAsB,kBAAkB;AACpF,QAAI,CAAC,cAAc,gBAAgB,GAAG;AACrC,aAAO,CAAC;AAAA,IACT;AACA,UAAM,WAAW,mBAAmB,gBAAgB;AACpD,UAAM,UAA+D;AAAA,MACpE,EAAE,IAAI,oBAAoB,QAAQ,iBAAiB;AAAA,IACpD;AACA,QAAI,YAAY,aAAa,oBAAoB;AAChD,YAAM,eAAe,MAAM,KAAK,QAAQ,sBAAsB,QAAQ;AACtE,UAAI,cAAc,YAAY,GAAG;AAChC,gBAAQ,KAAK,EAAE,IAAI,UAAU,QAAQ,aAAa,CAAC;AAAA,MACpD;AAAA,IACD;AAEA,UAAM,WAAW,oBAAI,IAA2B;AAChD,eAAW,UAAU,SAAS;AAC7B,iBAAW,cAAc,wBAAwB,OAAO,MAAM,GAAG;AAChE,YAAI,SAAS,IAAI,UAAU,KAAK,CAAE,MAAM,KAAK,wBAAwB,UAAU,GAAI;AAClF;AAAA,QACD;AAEA,iBAAS,IAAI,YAAY,EAAE,YAAY,UAAU,OAAO,GAAG,CAAC;AAAA,MAC7D;AAAA,IACD;AACA,WAAO,CAAC,GAAG,SAAS,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,UAAU,KAAK,WAAW,cAAc,MAAM,UAAU,CAAC;AAAA,EACpG;AAAA,EAEA,MAAc,wBAAwB,YAAsC;AA1C7E;AA2CE,QAAI,CAAC,qBAAqB,UAAU,GAAG;AACtC,aAAO;AAAA,IACR;AACA,UAAM,WAAW,MAAM,KAAK,QAAQ,sBAAsB,kBAAkB,UAAU,EAAE;AACxF,QAAI,CAAC,YAAY,SAAS,SAAS,cAAc,SAAS,OAAO,YAAY,MAAM;AAClF,aAAO;AAAA,IACR;AACA,WAAO,SAAS,OAAO,eAAe,UAAQ,cAAS,OAAO,sBAAhB,mBAAmC,gBAAe;AAAA,EACjG;AACD;AAGO,SAAS,qBAAqB,OAAyB;AAC7D,SAAO,OAAO,UAAU,YAAY,wBAAwB,KAAK,KAAK;AACvE;AAGO,SAAS,oBACf,oBACA,YACA,YACgB;AAChB,MAAI,CAAC,qBAAqB,UAAU,GAAG;AACtC,UAAM,IAAI;AAAA,MACT,6BAA6B,UAAU,oBAAoB,kBAAkB;AAAA,IAC9E;AAAA,EACD;AACA,QAAM,SAAS,WAAW,KAAK,eAAa,UAAU,eAAe,UAAU;AAC/E,MAAI,CAAC,QAAQ;AACZ,UAAM,IAAI;AAAA,MACT,qBAAqB,UAAU,wBAAwB,kBAAkB;AAAA,IAC1E;AAAA,EACD;AACA,SAAO;AACR;AAEA,SAAS,cAAc,QAA4E;AAClG,UAAO,iCAAQ,UAAS;AACzB;AAEA,SAAS,mBAAmB,QAAkD;AAnF9E;AAoFC,QAAM,WAAU,YAAO,OAAO,UAAd,mBAAqB;AACrC,MAAI,OAAO,YAAY,UAAU;AAChC,WAAO;AAAA,EACR;AACA,MAAI,WAAW,OAAO,QAAQ,SAAS,YAAY,QAAQ,KAAK,KAAK,GAAG;AACvE,WAAO,QAAQ;AAAA,EAChB;AACA,SAAO;AACR;AAEA,SAAS,wBAAwB,QAAwC;AA9FzE;AA+FC,SAAO,OAAO,SAAQ,YAAO,OAAO,WAAd,YAAwB,CAAC,CAAC,EAC9C,OAAO,CAAC,CAAC,YAAY,QAAQ,MAAM,qBAAqB,UAAU,MAAK,qCAAU,aAAY,IAAI,EACjG,IAAI,CAAC,CAAC,UAAU,MAAM,UAAU;AACnC;",
+  "names": []
+}

package/build/lib/model/contextual-model.js

@@ -0,0 +1,98 @@
+"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 contextual_model_exports = {};
+__export(contextual_model_exports, {
+  ContextualModel: () => ContextualModel
+});
+module.exports = __toCommonJS(contextual_model_exports);
+var import_statistics = require("./statistics");
+var import_temporal_model = require("./temporal-model");
+class ContextualModel {
+  constructor(bucketMinutes, maxContexts, maxSamples = import_statistics.DEFAULT_MAX_SAMPLES, data) {
+    this.bucketMinutes = bucketMinutes;
+    this.maxContexts = maxContexts;
+    this.maxSamples = maxSamples;
+    var _a;
+    for (const [key, entry] of Object.entries((_a = data == null ? void 0 : data.contexts) != null ? _a : {})) {
+      if (this.contexts.size >= maxContexts) {
+        break;
+      }
+      this.contexts.set(key, {
+        model: new import_temporal_model.TemporalModel(bucketMinutes, maxSamples, entry.model),
+        lastUsed: Number.isFinite(entry.lastUsed) ? entry.lastUsed : 0
+      });
+    }
+  }
+  contexts = /* @__PURE__ */ new Map();
+  baseline(key, timestamp, minimumSamples, useTimeContext, useWeekdayContext) {
+    if (!key) {
+      return void 0;
+    }
+    const entry = this.contexts.get(key);
+    if (!entry || entry.model.sampleCount < minimumSamples) {
+      return void 0;
+    }
+    entry.lastUsed = timestamp;
+    return entry.model.baseline(timestamp, minimumSamples, useTimeContext, useWeekdayContext);
+  }
+  /**
+   * Returns the retained global sample count for one exact context combination.
+   *
+   * @param key Normalized context combination key.
+   */
+  sampleCount(key) {
+    var _a, _b;
+    return key ? (_b = (_a = this.contexts.get(key)) == null ? void 0 : _a.model.sampleCount) != null ? _b : 0 : 0;
+  }
+  add(key, value, timestamp, useTimeContext, useWeekdayContext) {
+    if (!key) {
+      return;
+    }
+    let entry = this.contexts.get(key);
+    if (!entry) {
+      if (this.contexts.size >= this.maxContexts) {
+        const oldest = [...this.contexts.entries()].sort(
+          ([leftKey, left], [rightKey, right]) => left.lastUsed - right.lastUsed || leftKey.localeCompare(rightKey)
+        )[0];
+        if (oldest) {
+          this.contexts.delete(oldest[0]);
+        }
+      }
+      entry = { model: new import_temporal_model.TemporalModel(this.bucketMinutes, this.maxSamples), lastUsed: timestamp };
+      this.contexts.set(key, entry);
+    }
+    entry.lastUsed = timestamp;
+    entry.model.add(value, timestamp, useTimeContext, useWeekdayContext);
+  }
+  toJSON() {
+    return {
+      contexts: Object.fromEntries(
+        [...this.contexts].map(([key, entry]) => [
+          key,
+          { model: entry.model.toJSON(), lastUsed: entry.lastUsed }
+        ])
+      )
+    };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContextualModel
+});
+//# sourceMappingURL=contextual-model.js.map

package/build/lib/model/contextual-model.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/model/contextual-model.ts"],
+  "sourcesContent": ["import { DEFAULT_MAX_SAMPLES } from \"./statistics\";\nimport { TemporalModel, type Baseline, type TemporalModelData } from \"./temporal-model\";\n\nexport interface ContextualModelEntryData {\n\tmodel: TemporalModelData;\n\tlastUsed: number;\n}\n\nexport interface ContextualModelData {\n\tcontexts: Record<string, ContextualModelEntryData>;\n}\n\n/** Bounded context-specific temporal baselines with deterministic least-recently-used eviction. */\nexport class ContextualModel {\n\tprivate readonly contexts = new Map<string, { model: TemporalModel; lastUsed: number }>();\n\n\tpublic constructor(\n\t\tprivate readonly bucketMinutes: number,\n\t\tprivate readonly maxContexts: number,\n\t\tprivate readonly maxSamples = DEFAULT_MAX_SAMPLES,\n\t\tdata?: ContextualModelData,\n\t) {\n\t\tfor (const [key, entry] of Object.entries(data?.contexts ?? {})) {\n\t\t\tif (this.contexts.size >= maxContexts) {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tthis.contexts.set(key, {\n\t\t\t\tmodel: new TemporalModel(bucketMinutes, maxSamples, entry.model),\n\t\t\t\tlastUsed: Number.isFinite(entry.lastUsed) ? entry.lastUsed : 0,\n\t\t\t});\n\t\t}\n\t}\n\n\tpublic baseline(\n\t\tkey: string | undefined,\n\t\ttimestamp: number,\n\t\tminimumSamples: number,\n\t\tuseTimeContext: boolean,\n\t\tuseWeekdayContext: boolean,\n\t): Baseline | undefined {\n\t\tif (!key) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst entry = this.contexts.get(key);\n\t\tif (!entry || entry.model.sampleCount < minimumSamples) {\n\t\t\treturn undefined;\n\t\t}\n\t\tentry.lastUsed = timestamp;\n\t\treturn entry.model.baseline(timestamp, minimumSamples, useTimeContext, useWeekdayContext);\n\t}\n\n\t/**\n\t * Returns the retained global sample count for one exact context combination.\n\t *\n\t * @param key Normalized context combination key.\n\t */\n\tpublic sampleCount(key: string | undefined): number {\n\t\treturn key ? (this.contexts.get(key)?.model.sampleCount ?? 0) : 0;\n\t}\n\n\tpublic add(\n\t\tkey: string | undefined,\n\t\tvalue: number,\n\t\ttimestamp: number,\n\t\tuseTimeContext: boolean,\n\t\tuseWeekdayContext: boolean,\n\t): void {\n\t\tif (!key) {\n\t\t\treturn;\n\t\t}\n\t\tlet entry = this.contexts.get(key);\n\t\tif (!entry) {\n\t\t\tif (this.contexts.size >= this.maxContexts) {\n\t\t\t\tconst oldest = [...this.contexts.entries()].sort(\n\t\t\t\t\t([leftKey, left], [rightKey, right]) =>\n\t\t\t\t\t\tleft.lastUsed - right.lastUsed || leftKey.localeCompare(rightKey),\n\t\t\t\t)[0];\n\t\t\t\tif (oldest) {\n\t\t\t\t\tthis.contexts.delete(oldest[0]);\n\t\t\t\t}\n\t\t\t}\n\t\t\tentry = { model: new TemporalModel(this.bucketMinutes, this.maxSamples), lastUsed: timestamp };\n\t\t\tthis.contexts.set(key, entry);\n\t\t}\n\t\tentry.lastUsed = timestamp;\n\t\tentry.model.add(value, timestamp, useTimeContext, useWeekdayContext);\n\t}\n\n\tpublic toJSON(): ContextualModelData {\n\t\treturn {\n\t\t\tcontexts: Object.fromEntries(\n\t\t\t\t[...this.contexts].map(([key, entry]) => [\n\t\t\t\t\tkey,\n\t\t\t\t\t{ model: entry.model.toJSON(), lastUsed: entry.lastUsed },\n\t\t\t\t]),\n\t\t\t),\n\t\t};\n\t}\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAoC;AACpC,4BAAqE;AAY9D,MAAM,gBAAgB;AAAA,EAGrB,YACW,eACA,aACA,aAAa,uCAC9B,MACC;AAJgB;AACA;AACA;AAnBnB;AAsBE,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,SAAQ,kCAAM,aAAN,YAAkB,CAAC,CAAC,GAAG;AAChE,UAAI,KAAK,SAAS,QAAQ,aAAa;AACtC;AAAA,MACD;AACA,WAAK,SAAS,IAAI,KAAK;AAAA,QACtB,OAAO,IAAI,oCAAc,eAAe,YAAY,MAAM,KAAK;AAAA,QAC/D,UAAU,OAAO,SAAS,MAAM,QAAQ,IAAI,MAAM,WAAW;AAAA,MAC9D,CAAC;AAAA,IACF;AAAA,EACD;AAAA,EAjBiB,WAAW,oBAAI,IAAwD;AAAA,EAmBjF,SACN,KACA,WACA,gBACA,gBACA,mBACuB;AACvB,QAAI,CAAC,KAAK;AACT,aAAO;AAAA,IACR;AACA,UAAM,QAAQ,KAAK,SAAS,IAAI,GAAG;AACnC,QAAI,CAAC,SAAS,MAAM,MAAM,cAAc,gBAAgB;AACvD,aAAO;AAAA,IACR;AACA,UAAM,WAAW;AACjB,WAAO,MAAM,MAAM,SAAS,WAAW,gBAAgB,gBAAgB,iBAAiB;AAAA,EACzF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,YAAY,KAAiC;AAxDrD;AAyDE,WAAO,OAAO,gBAAK,SAAS,IAAI,GAAG,MAArB,mBAAwB,MAAM,gBAA9B,YAA6C,IAAK;AAAA,EACjE;AAAA,EAEO,IACN,KACA,OACA,WACA,gBACA,mBACO;AACP,QAAI,CAAC,KAAK;AACT;AAAA,IACD;AACA,QAAI,QAAQ,KAAK,SAAS,IAAI,GAAG;AACjC,QAAI,CAAC,OAAO;AACX,UAAI,KAAK,SAAS,QAAQ,KAAK,aAAa;AAC3C,cAAM,SAAS,CAAC,GAAG,KAAK,SAAS,QAAQ,CAAC,EAAE;AAAA,UAC3C,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,KAAK,MACjC,KAAK,WAAW,MAAM,YAAY,QAAQ,cAAc,QAAQ;AAAA,QAClE,EAAE,CAAC;AACH,YAAI,QAAQ;AACX,eAAK,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,QAC/B;AAAA,MACD;AACA,cAAQ,EAAE,OAAO,IAAI,oCAAc,KAAK,eAAe,KAAK,UAAU,GAAG,UAAU,UAAU;AAC7F,WAAK,SAAS,IAAI,KAAK,KAAK;AAAA,IAC7B;AACA,UAAM,WAAW;AACjB,UAAM,MAAM,IAAI,OAAO,WAAW,gBAAgB,iBAAiB;AAAA,EACpE;AAAA,EAEO,SAA8B;AACpC,WAAO;AAAA,MACN,UAAU,OAAO;AAAA,QAChB,CAAC,GAAG,KAAK,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAAA,UACxC;AAAA,UACA,EAAE,OAAO,MAAM,MAAM,OAAO,GAAG,UAAU,MAAM,SAAS;AAAA,QACzD,CAAC;AAAA,MACF;AAAA,IACD;AAAA,EACD;AACD;",
+  "names": []
+}

package/build/lib/model/statistics.js

@@ -0,0 +1,78 @@
+"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 statistics_exports = {};
+__export(statistics_exports, {
+  DEFAULT_MAX_SAMPLES: () => DEFAULT_MAX_SAMPLES,
+  MODEL_SCHEMA_VERSION: () => MODEL_SCHEMA_VERSION,
+  SampleSeries: () => SampleSeries,
+  clamp: () => clamp,
+  median: () => median
+});
+module.exports = __toCommonJS(statistics_exports);
+const MODEL_SCHEMA_VERSION = 2;
+const DEFAULT_MAX_SAMPLES = 240;
+class SampleSeries {
+  constructor(maxSamples = DEFAULT_MAX_SAMPLES, values = []) {
+    this.maxSamples = maxSamples;
+    this.values = values.filter(Number.isFinite).slice(-maxSamples);
+  }
+  values;
+  add(value) {
+    if (!Number.isFinite(value)) {
+      return;
+    }
+    this.values.push(value);
+    if (this.values.length > this.maxSamples) {
+      this.values.splice(0, this.values.length - this.maxSamples);
+    }
+  }
+  get count() {
+    return this.values.length;
+  }
+  median() {
+    return median(this.values);
+  }
+  mad() {
+    const center = this.median();
+    return center === void 0 ? void 0 : median(this.values.map((value) => Math.abs(value - center)));
+  }
+  toJSON() {
+    return { values: [...this.values] };
+  }
+}
+function median(values) {
+  const finite = values.filter(Number.isFinite).sort((left, right) => left - right);
+  if (finite.length === 0) {
+    return void 0;
+  }
+  const middle = Math.floor(finite.length / 2);
+  return finite.length % 2 === 0 ? (finite[middle - 1] + finite[middle]) / 2 : finite[middle];
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_MAX_SAMPLES,
+  MODEL_SCHEMA_VERSION,
+  SampleSeries,
+  clamp,
+  median
+});
+//# sourceMappingURL=statistics.js.map

package/build/lib/model/statistics.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/model/statistics.ts"],
+  "sourcesContent": ["export const MODEL_SCHEMA_VERSION = 2;\nexport const DEFAULT_MAX_SAMPLES = 240;\n\nexport interface SampleSeriesData {\n\tvalues: number[];\n}\n\n/** A bounded sample reservoir. Keeping samples rather than raw history makes median and MAD robust and restart-safe. */\nexport class SampleSeries {\n\tprivate readonly values: number[];\n\n\tpublic constructor(\n\t\tprivate readonly maxSamples = DEFAULT_MAX_SAMPLES,\n\t\tvalues: number[] = [],\n\t) {\n\t\tthis.values = values.filter(Number.isFinite).slice(-maxSamples);\n\t}\n\n\tpublic add(value: number): void {\n\t\tif (!Number.isFinite(value)) {\n\t\t\treturn;\n\t\t}\n\t\tthis.values.push(value);\n\t\tif (this.values.length > this.maxSamples) {\n\t\t\tthis.values.splice(0, this.values.length - this.maxSamples);\n\t\t}\n\t}\n\n\tpublic get count(): number {\n\t\treturn this.values.length;\n\t}\n\n\tpublic median(): number | undefined {\n\t\treturn median(this.values);\n\t}\n\n\tpublic mad(): number | undefined {\n\t\tconst center = this.median();\n\t\treturn center === undefined ? undefined : median(this.values.map(value => Math.abs(value - center)));\n\t}\n\n\tpublic toJSON(): SampleSeriesData {\n\t\treturn { values: [...this.values] };\n\t}\n}\n\nexport function median(values: readonly number[]): number | undefined {\n\tconst finite = values.filter(Number.isFinite).sort((left, right) => left - right);\n\tif (finite.length === 0) {\n\t\treturn undefined;\n\t}\n\tconst middle = Math.floor(finite.length / 2);\n\treturn finite.length % 2 === 0 ? (finite[middle - 1] + finite[middle]) / 2 : finite[middle];\n}\n\nexport function clamp(value: number, min: number, max: number): number {\n\treturn Math.min(max, Math.max(min, value));\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAO5B,MAAM,aAAa;AAAA,EAGlB,YACW,aAAa,qBAC9B,SAAmB,CAAC,GACnB;AAFgB;AAGjB,SAAK,SAAS,OAAO,OAAO,OAAO,QAAQ,EAAE,MAAM,CAAC,UAAU;AAAA,EAC/D;AAAA,EAPiB;AAAA,EASV,IAAI,OAAqB;AAC/B,QAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC5B;AAAA,IACD;AACA,SAAK,OAAO,KAAK,KAAK;AACtB,QAAI,KAAK,OAAO,SAAS,KAAK,YAAY;AACzC,WAAK,OAAO,OAAO,GAAG,KAAK,OAAO,SAAS,KAAK,UAAU;AAAA,IAC3D;AAAA,EACD;AAAA,EAEA,IAAW,QAAgB;AAC1B,WAAO,KAAK,OAAO;AAAA,EACpB;AAAA,EAEO,SAA6B;AACnC,WAAO,OAAO,KAAK,MAAM;AAAA,EAC1B;AAAA,EAEO,MAA0B;AAChC,UAAM,SAAS,KAAK,OAAO;AAC3B,WAAO,WAAW,SAAY,SAAY,OAAO,KAAK,OAAO,IAAI,WAAS,KAAK,IAAI,QAAQ,MAAM,CAAC,CAAC;AAAA,EACpG;AAAA,EAEO,SAA2B;AACjC,WAAO,EAAE,QAAQ,CAAC,GAAG,KAAK,MAAM,EAAE;AAAA,EACnC;AACD;AAEO,SAAS,OAAO,QAA+C;AACrE,QAAM,SAAS,OAAO,OAAO,OAAO,QAAQ,EAAE,KAAK,CAAC,MAAM,UAAU,OAAO,KAAK;AAChF,MAAI,OAAO,WAAW,GAAG;AACxB,WAAO;AAAA,EACR;AACA,QAAM,SAAS,KAAK,MAAM,OAAO,SAAS,CAAC;AAC3C,SAAO,OAAO,SAAS,MAAM,KAAK,OAAO,SAAS,CAAC,IAAI,OAAO,MAAM,KAAK,IAAI,OAAO,MAAM;AAC3F;AAEO,SAAS,MAAM,OAAe,KAAa,KAAqB;AACtE,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC1C;",
+  "names": []
+}

package/build/lib/model/temporal-model.js

@@ -0,0 +1,98 @@
+"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 temporal_model_exports = {};
+__export(temporal_model_exports, {
+  TemporalModel: () => TemporalModel
+});
+module.exports = __toCommonJS(temporal_model_exports);
+var import_statistics = require("./statistics");
+class TemporalModel {
+  constructor(bucketMinutes, maxSamples = import_statistics.DEFAULT_MAX_SAMPLES, data) {
+    this.bucketMinutes = bucketMinutes;
+    this.maxSamples = maxSamples;
+    var _a, _b;
+    this.global = new import_statistics.SampleSeries(maxSamples, data == null ? void 0 : data.global.values);
+    for (const [key, series] of Object.entries((_a = data == null ? void 0 : data.timeBuckets) != null ? _a : {})) {
+      this.timeBuckets.set(key, new import_statistics.SampleSeries(maxSamples, series.values));
+    }
+    for (const [key, series] of Object.entries((_b = data == null ? void 0 : data.contextBuckets) != null ? _b : {})) {
+      this.contextBuckets.set(key, new import_statistics.SampleSeries(maxSamples, series.values));
+    }
+  }
+  global;
+  timeBuckets = /* @__PURE__ */ new Map();
+  contextBuckets = /* @__PURE__ */ new Map();
+  add(value, timestamp, useTimeContext, useWeekdayContext) {
+    this.global.add(value);
+    if (!useTimeContext) {
+      return;
+    }
+    const timeKey = this.getTimeKey(timestamp);
+    this.getOrCreate(this.timeBuckets, timeKey).add(value);
+    if (useWeekdayContext) {
+      this.getOrCreate(this.contextBuckets, `${this.getDayKey(timestamp)}:${timeKey}`).add(value);
+    }
+  }
+  baseline(timestamp, minSamples, useTimeContext, useWeekdayContext) {
+    if (useTimeContext) {
+      const timeKey = this.getTimeKey(timestamp);
+      if (useWeekdayContext) {
+        const contextual = this.contextBuckets.get(`${this.getDayKey(timestamp)}:${timeKey}`);
+        if (contextual && contextual.count >= minSamples) {
+          return { series: contextual, scope: "context" };
+        }
+      }
+      const time = this.timeBuckets.get(timeKey);
+      if (time && time.count >= minSamples) {
+        return { series: time, scope: "time" };
+      }
+    }
+    return { series: this.global, scope: "global" };
+  }
+  get sampleCount() {
+    return this.global.count;
+  }
+  toJSON() {
+    return {
+      global: this.global.toJSON(),
+      timeBuckets: Object.fromEntries([...this.timeBuckets].map(([key, value]) => [key, value.toJSON()])),
+      contextBuckets: Object.fromEntries([...this.contextBuckets].map(([key, value]) => [key, value.toJSON()]))
+    };
+  }
+  getOrCreate(map, key) {
+    let series = map.get(key);
+    if (!series) {
+      series = new import_statistics.SampleSeries(this.maxSamples);
+      map.set(key, series);
+    }
+    return series;
+  }
+  getTimeKey(timestamp) {
+    const date = new Date(timestamp);
+    return String(Math.floor((date.getHours() * 60 + date.getMinutes()) / this.bucketMinutes));
+  }
+  getDayKey(timestamp) {
+    return String(new Date(timestamp).getDay());
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TemporalModel
+});
+//# sourceMappingURL=temporal-model.js.map

package/build/lib/model/temporal-model.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/model/temporal-model.ts"],
+  "sourcesContent": ["import { DEFAULT_MAX_SAMPLES, SampleSeries, type SampleSeriesData } from \"./statistics\";\n\nexport interface TemporalModelData {\n\tglobal: SampleSeriesData;\n\ttimeBuckets: Record<string, SampleSeriesData>;\n\tcontextBuckets: Record<string, SampleSeriesData>;\n}\n\nexport interface Baseline {\n\tseries: SampleSeries;\n\tscope: \"context\" | \"time\" | \"global\";\n}\n\n/**\n * Stores only bounded samples per broad baseline, time bucket and optional day context.\n * The selection cascade avoids treating a sparse context as a reliable baseline.\n */\nexport class TemporalModel {\n\tprivate readonly global: SampleSeries;\n\tprivate readonly timeBuckets = new Map<string, SampleSeries>();\n\tprivate readonly contextBuckets = new Map<string, SampleSeries>();\n\n\tpublic constructor(\n\t\tprivate readonly bucketMinutes: number,\n\t\tprivate readonly maxSamples = DEFAULT_MAX_SAMPLES,\n\t\tdata?: TemporalModelData,\n\t) {\n\t\tthis.global = new SampleSeries(maxSamples, data?.global.values);\n\t\tfor (const [key, series] of Object.entries(data?.timeBuckets ?? {})) {\n\t\t\tthis.timeBuckets.set(key, new SampleSeries(maxSamples, series.values));\n\t\t}\n\t\tfor (const [key, series] of Object.entries(data?.contextBuckets ?? {})) {\n\t\t\tthis.contextBuckets.set(key, new SampleSeries(maxSamples, series.values));\n\t\t}\n\t}\n\n\tpublic add(value: number, timestamp: number, useTimeContext: boolean, useWeekdayContext: boolean): void {\n\t\tthis.global.add(value);\n\t\tif (!useTimeContext) {\n\t\t\treturn;\n\t\t}\n\t\tconst timeKey = this.getTimeKey(timestamp);\n\t\tthis.getOrCreate(this.timeBuckets, timeKey).add(value);\n\t\tif (useWeekdayContext) {\n\t\t\tthis.getOrCreate(this.contextBuckets, `${this.getDayKey(timestamp)}:${timeKey}`).add(value);\n\t\t}\n\t}\n\n\tpublic baseline(\n\t\ttimestamp: number,\n\t\tminSamples: number,\n\t\tuseTimeContext: boolean,\n\t\tuseWeekdayContext: boolean,\n\t): Baseline {\n\t\tif (useTimeContext) {\n\t\t\tconst timeKey = this.getTimeKey(timestamp);\n\t\t\tif (useWeekdayContext) {\n\t\t\t\tconst contextual = this.contextBuckets.get(`${this.getDayKey(timestamp)}:${timeKey}`);\n\t\t\t\tif (contextual && contextual.count >= minSamples) {\n\t\t\t\t\treturn { series: contextual, scope: \"context\" };\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst time = this.timeBuckets.get(timeKey);\n\t\t\tif (time && time.count >= minSamples) {\n\t\t\t\treturn { series: time, scope: \"time\" };\n\t\t\t}\n\t\t}\n\t\treturn { series: this.global, scope: \"global\" };\n\t}\n\n\tpublic get sampleCount(): number {\n\t\treturn this.global.count;\n\t}\n\n\tpublic toJSON(): TemporalModelData {\n\t\treturn {\n\t\t\tglobal: this.global.toJSON(),\n\t\t\ttimeBuckets: Object.fromEntries([...this.timeBuckets].map(([key, value]) => [key, value.toJSON()])),\n\t\t\tcontextBuckets: Object.fromEntries([...this.contextBuckets].map(([key, value]) => [key, value.toJSON()])),\n\t\t};\n\t}\n\n\tprivate getOrCreate(map: Map<string, SampleSeries>, key: string): SampleSeries {\n\t\tlet series = map.get(key);\n\t\tif (!series) {\n\t\t\tseries = new SampleSeries(this.maxSamples);\n\t\t\tmap.set(key, series);\n\t\t}\n\t\treturn series;\n\t}\n\n\tprivate getTimeKey(timestamp: number): string {\n\t\tconst date = new Date(timestamp);\n\t\treturn String(Math.floor((date.getHours() * 60 + date.getMinutes()) / this.bucketMinutes));\n\t}\n\n\tprivate getDayKey(timestamp: number): string {\n\t\treturn String(new Date(timestamp).getDay());\n\t}\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/lib/scoring.js

@@ -0,0 +1,57 @@
+"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 scoring_exports = {};
+__export(scoring_exports, {
+  scoreDetectors: () => scoreDetectors
+});
+module.exports = __toCommonJS(scoring_exports);
+var import_statistics = require("./model/statistics");
+const WEIGHTS = {
+  value: 0.5,
+  context: 0.5,
+  rate: 0.3,
+  stuck: 0.2,
+  changePoint: 0.45,
+  trend: 0.35
+};
+const BEHAVIOR_DETECTORS = /* @__PURE__ */ new Set(["value", "context", "changePoint", "trend"]);
+function scoreDetectors(results) {
+  if (results.length === 0) {
+    return { score: 0, reason: "Insufficient data for anomaly detection" };
+  }
+  const behavior = results.filter((result) => BEHAVIOR_DETECTORS.has(result.name));
+  const selected = [
+    ...behavior.length ? [behavior.reduce((best, result) => result.score > best.score ? result : best)] : [],
+    ...results.filter((result) => !BEHAVIOR_DETECTORS.has(result.name))
+  ];
+  const weight = selected.reduce((total, result) => total + WEIGHTS[result.name], 0);
+  const weightedScore = selected.reduce((total, result) => total + result.score * WEIGHTS[result.name], 0) / weight;
+  const strong = selected.filter((result) => result.score >= 50);
+  const score = (0, import_statistics.clamp)(weightedScore + (strong.length >= 2 ? 10 : 0), 0, 100);
+  if (score === 0) {
+    return { score, reason: "Normal" };
+  }
+  const reason = strong.length >= 2 ? "Multiple anomaly detectors agree" : selected.reduce((best, result) => result.score > best.score ? result : best).reason;
+  return { score, reason };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  scoreDetectors
+});
+//# sourceMappingURL=scoring.js.map

package/build/lib/scoring.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/scoring.ts"],
+  "sourcesContent": ["import { clamp } from \"./model/statistics\";\nimport type { DetectorResult } from \"./detectors\";\n\nexport interface ScoringResult {\n\tscore: number;\n\treason: string;\n}\n\nconst WEIGHTS: Record<DetectorResult[\"name\"], number> = {\n\tvalue: 0.5,\n\tcontext: 0.5,\n\trate: 0.3,\n\tstuck: 0.2,\n\tchangePoint: 0.45,\n\ttrend: 0.35,\n};\nconst BEHAVIOR_DETECTORS = new Set<DetectorResult[\"name\"]>([\"value\", \"context\", \"changePoint\", \"trend\"]);\n\nexport function scoreDetectors(results: readonly DetectorResult[]): ScoringResult {\n\tif (results.length === 0) {\n\t\treturn { score: 0, reason: \"Insufficient data for anomaly detection\" };\n\t}\n\tconst behavior = results.filter(result => BEHAVIOR_DETECTORS.has(result.name));\n\tconst selected = [\n\t\t...(behavior.length ? [behavior.reduce((best, result) => (result.score > best.score ? result : best))] : []),\n\t\t...results.filter(result => !BEHAVIOR_DETECTORS.has(result.name)),\n\t];\n\tconst weight = selected.reduce((total, result) => total + WEIGHTS[result.name], 0);\n\tconst weightedScore = selected.reduce((total, result) => total + result.score * WEIGHTS[result.name], 0) / weight;\n\tconst strong = selected.filter(result => result.score >= 50);\n\tconst score = clamp(weightedScore + (strong.length >= 2 ? 10 : 0), 0, 100);\n\tif (score === 0) {\n\t\treturn { score, reason: \"Normal\" };\n\t}\n\tconst reason =\n\t\tstrong.length >= 2\n\t\t\t? \"Multiple anomaly detectors agree\"\n\t\t\t: selected.reduce((best, result) => (result.score > best.score ? result : best)).reason;\n\treturn { score, reason };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAsB;AAQtB,MAAM,UAAkD;AAAA,EACvD,OAAO;AAAA,EACP,SAAS;AAAA,EACT,MAAM;AAAA,EACN,OAAO;AAAA,EACP,aAAa;AAAA,EACb,OAAO;AACR;AACA,MAAM,qBAAqB,oBAAI,IAA4B,CAAC,SAAS,WAAW,eAAe,OAAO,CAAC;AAEhG,SAAS,eAAe,SAAmD;AACjF,MAAI,QAAQ,WAAW,GAAG;AACzB,WAAO,EAAE,OAAO,GAAG,QAAQ,0CAA0C;AAAA,EACtE;AACA,QAAM,WAAW,QAAQ,OAAO,YAAU,mBAAmB,IAAI,OAAO,IAAI,CAAC;AAC7E,QAAM,WAAW;AAAA,IAChB,GAAI,SAAS,SAAS,CAAC,SAAS,OAAO,CAAC,MAAM,WAAY,OAAO,QAAQ,KAAK,QAAQ,SAAS,IAAK,CAAC,IAAI,CAAC;AAAA,IAC1G,GAAG,QAAQ,OAAO,YAAU,CAAC,mBAAmB,IAAI,OAAO,IAAI,CAAC;AAAA,EACjE;AACA,QAAM,SAAS,SAAS,OAAO,CAAC,OAAO,WAAW,QAAQ,QAAQ,OAAO,IAAI,GAAG,CAAC;AACjF,QAAM,gBAAgB,SAAS,OAAO,CAAC,OAAO,WAAW,QAAQ,OAAO,QAAQ,QAAQ,OAAO,IAAI,GAAG,CAAC,IAAI;AAC3G,QAAM,SAAS,SAAS,OAAO,YAAU,OAAO,SAAS,EAAE;AAC3D,QAAM,YAAQ,yBAAM,iBAAiB,OAAO,UAAU,IAAI,KAAK,IAAI,GAAG,GAAG;AACzE,MAAI,UAAU,GAAG;AAChB,WAAO,EAAE,OAAO,QAAQ,SAAS;AAAA,EAClC;AACA,QAAM,SACL,OAAO,UAAU,IACd,qCACA,SAAS,OAAO,CAAC,MAAM,WAAY,OAAO,QAAQ,KAAK,QAAQ,SAAS,IAAK,EAAE;AACnF,SAAO,EAAE,OAAO,OAAO;AACxB;",
+  "names": []
+}