@miragon/pulse-analytics-client 0.0.0-stage → 0.21.0

package/dist/queries/helpers.js

@@ -0,0 +1,219 @@
+import { GAUGE_LABELS, METRIC_NAMES as M } from "../metric-names.js";
+import { RETENTION_DAYS } from "../prometheus.js";
+import { DAY_SECONDS, nowSeconds, rangeSeconds } from "./windows.js";
+/** Round to one decimal place (KPI seconds / percentages). */
+export const round1 = (n) => Math.round(n * 10) / 10;
+/** Milliseconds (the duration histograms' unit) as seconds, one decimal. */
+export const secondsOf = (ms) => round1(ms / 1000);
+/** {@link secondsOf} that passes `null` (not measured) through. */
+export const secondsOrNull = (ms) => (ms === null ? null : secondsOf(ms));
+/**
+ * How long a series must have been silent before a window for it to count as
+ * born inside that window. Long enough that a scrape gap at the window's start
+ * does not pass an old series off as new (its whole history would then count).
+ */
+const BORN_LOOKBACK = "1h";
+const BORN_LOOKBACK_SECONDS = 3600;
+/**
+ * What a counter or histogram series recorded inside `w`, per series — the
+ * ONE way every query reads a counter (contract rule 2). The plugin creates a
+ * series on its first event, and `increase()` never counts a series' first
+ * sample: a rare event such as the first incident of a type at an activity
+ * would read 0. So a series that existed before the window counts its
+ * `increase()`, and a series born inside it counts its whole value.
+ * `series` is a metric name plus its selector, e.g. `camunda_x{engine_id="a"}`.
+ *
+ * The check looks at the hour before the window. Where that hour lies past
+ * the retention (the 30-day period), Prometheus has deleted it and every
+ * series would pass for new, counting its whole history; there it looks at
+ * the window's own first hour instead: a series silent then was born later.
+ * Only a window of an hour or less at the retention edge has no hour to look
+ * at and reads plain `increase()`, which can miss a series' first sample but
+ * never counts what happened before the window.
+ */
+export function increaseIn(series, w) {
+    const at = w.at === undefined ? "" : ` @ ${w.at}`;
+    const plain = `increase(${series}[${w.range}]${at})`;
+    const offset = bornCheckOffset(w);
+    if (offset === null)
+        return plain;
+    const silent = `present_over_time(${series}[${BORN_LOOKBACK}]${at} offset ${offset})`;
+    return (`((${plain} and ${silent})` +
+        ` or (max_over_time(${series}[${w.range}]${at}) unless ${silent}))`);
+}
+/**
+ * How far back from the window's end the born check's hour ends: the window's
+ * start (the hour before it), or, where that hour lies past the retention,
+ * the end of the window's first hour; `null` when the window has none.
+ */
+function bornCheckOffset(w, now = nowSeconds()) {
+    const seconds = rangeSeconds(w.range);
+    const start = (w.at ?? now) - seconds;
+    if (start - BORN_LOOKBACK_SECONDS >= now - RETENTION_DAYS * DAY_SECONDS)
+        return w.range;
+    return seconds > BORN_LOOKBACK_SECONDS ? `${seconds - BORN_LOOKBACK_SECONDS}s` : null;
+}
+/**
+ * An engine-state gauge with one row per engine-wide figure (contract rule 3):
+ * every node of a clustered engine reports the same rows, so the nodes are
+ * folded with `max` over the gauge's contract labels before anything sums them.
+ */
+export const engineState = (gauge, sel) => `max by (${GAUGE_LABELS[gauge].join(", ")})(${gauge}${sel})`;
+/**
+ * Parse an ISO datetime into epoch seconds. Throws a caller-readable error
+ * instead of letting a NaN reach PromQL as `[NaNs] @ NaN` (Prometheus would
+ * answer with an opaque parse error).
+ */
+export function parseIsoSeconds(value, field) {
+    const ms = Date.parse(value);
+    if (!Number.isFinite(ms)) {
+        throw new Error(`${field} "${value}" is not a parseable ISO datetime (expected e.g. 2026-07-01T12:00:00Z)`);
+    }
+    return Math.round(ms / 1000);
+}
+/**
+ * Value of the first sample, or 0 when the query returned no series — for
+ * COUNTS (`sum(increase(…))`), where "no series in the window" means nothing
+ * happened. Never use it for a duration or a gauge: there a missing series is
+ * "not measured", see {@link firstOrNull}.
+ */
+export const first = (s) => (s.length ? s[0].value : 0);
+/**
+ * Value of the first sample, or `null` when the query returned none — for
+ * durations and live gauges. A duration over an empty window is NaN
+ * (`0 / 0`, `histogram_quantile` over all-zero buckets), which the client
+ * drops, so "nothing ended in the window" lands here as `null`, never as a
+ * plausible 0 s. A per-key gauge without a series is 0 while the engines
+ * report and "not reported" only while they do not — decide that with
+ * {@link reportingEnginesQuery}, never from the gauge's own series.
+ */
+export const firstOrNull = (s) => (s.length ? s[0].value : null);
+/**
+ * The engine-state presence probe — one series per engine in scope that
+ * reports its state gauges. `camunda_jobs_executable` carries `engine_id`
+ * only and is registered on every tick, 0 included; the per-key gauges are
+ * not: the metrics plugin registers a row only for what exists (no incident
+ * open → no `camunda_incidents_open` series at all). So a per-key gauge
+ * without a series is a measured 0 while this probe answers, and "not
+ * reported" only while it does not. `engineSel` must hold the engine matcher
+ * alone — the gauge has no other label to match.
+ */
+export const reportingEnginesQuery = (engineSel) => engineState(M.jobsExecutable, engineSel);
+/** The engine ids the {@link reportingEnginesQuery} probe answered for, ascending. */
+export const reportingEngineIds = (samples) => [...new Set(samples.flatMap((s) => (s.metric.engine_id ? [s.metric.engine_id] : [])))].sort();
+/** The as-of stamp of a result: now, as an ISO timestamp (the instant queries evaluate at now). */
+export const asOfNow = () => new Date().toISOString();
+/**
+ * Index sample values by one label, dropping samples that miss the label.
+ * The last sample wins on duplicate label values.
+ */
+export function byLabel(samples, label) {
+    const out = {};
+    for (const s of samples) {
+        const k = s.metric[label];
+        if (k !== undefined)
+            out[k] = s.value;
+    }
+    return out;
+}
+/**
+ * `part` per 100 of `base`, one decimal — `null` when `base` is 0 (a rate of
+ * nothing is undefined, not 0 %). Incident rates divide incidents by
+ * instances; one instance can carry several incidents, so they may exceed 100.
+ */
+export function ratePct(part, base) {
+    return base > 0 ? round1((part * 100) / base) : null;
+}
+/**
+ * Percentage change from `before` to `after`, rounded to two decimals. `null`
+ * when either side is not measured or the baseline is 0 — never a −100 % from
+ * a missing value or a division by zero.
+ */
+export function pctChange(before, after) {
+    if (before === null || after === null || before === 0)
+        return null;
+    return Math.round(((after - before) / before) * 10000) / 100;
+}
+/** Percentage-point difference of two rates; `null` when either is not measured. */
+export function ppDelta(before, after) {
+    return before === null || after === null ? null : round1(after - before);
+}
+/**
+ * The shared instance-KPI PromQL block used by the dashboard, performance and
+ * compare modules: counts via {@link increaseIn} over the window, durations
+ * from the histogram (`histogram_quantile` for p50/p95, sum/count for the
+ * mean), in MILLISECONDS — the histogram's unit; callers convert. Callers pick
+ * the strings they need.
+ *
+ * The duration histogram is recorded when an instance ENDS (any end state), so
+ * every duration covers the instances that ended inside the window only —
+ * still-running long instances are not in it (survivorship), and an empty
+ * window yields no value at all.
+ */
+export function kpiQueries(scope, w) {
+    const { sel, completedSel } = scope;
+    const duration = M.processInstanceDuration;
+    return {
+        started: `sum(${increaseIn(`${M.processInstanceStarted}${sel}`, w)})`,
+        completed: `sum(${increaseIn(`${M.processInstanceEnded}${completedSel}`, w)})`,
+        incidents: `sum(${increaseIn(`${M.incidentCreated}${sel}`, w)})`,
+        avgDuration: `sum(${increaseIn(`${duration}_sum${sel}`, w)}) / sum(${increaseIn(`${duration}_count${sel}`, w)})`,
+        medianDuration: `histogram_quantile(0.5, sum by (le)(${increaseIn(`${duration}_bucket${sel}`, w)}))`,
+        p95Duration: `histogram_quantile(0.95, sum by (le)(${increaseIn(`${duration}_bucket${sel}`, w)}))`,
+    };
+}
+/**
+ * Runs the KPI block shared by the compare modules (cluster / engine /
+ * version) for one partition: five queries, plus the element-scoped incident
+ * count when `scope.elementIncidentSel` is set.
+ */
+export async function queryCompareKpis(ch, scope, w) {
+    const q = kpiQueries(scope, w);
+    const element = scope.elementIncidentSel;
+    const [total, completed, incidents, avg, p95, elementIncidents] = await Promise.all([
+        ch.instant(q.started),
+        ch.instant(q.completed),
+        ch.instant(q.incidents),
+        ch.instant(q.avgDuration),
+        ch.instant(q.p95Duration),
+        element === undefined
+            ? Promise.resolve(null)
+            : ch.instant(`sum(${increaseIn(`${M.incidentCreated}${element}`, w)})`),
+    ]);
+    const instances = Math.round(first(total));
+    const incidentCount = Math.round(first(incidents));
+    const elementCount = elementIncidents === null ? null : Math.round(first(elementIncidents));
+    return {
+        instance_count: instances,
+        completed_count: Math.round(first(completed)),
+        incident_count: incidentCount,
+        incident_rate_pct: ratePct(incidentCount, instances),
+        element_incident_count: elementCount,
+        element_incident_rate_pct: elementCount === null ? null : ratePct(elementCount, instances),
+        avg_duration_sec: secondsOrNull(firstOrNull(avg)),
+        p95_duration_sec: secondsOrNull(firstOrNull(p95)),
+    };
+}
+/**
+ * Shared delta block of the compare modules. `days` are the two windows'
+ * actual lengths; the start counts are compared per day.
+ */
+export function compareKpiDelta(baseline, other, days) {
+    const perDay = (count, d) => (d > 0 ? count / d : null);
+    return {
+        started_per_day_delta_pct: pctChange(perDay(baseline.instance_count, days.baseline), perDay(other.instance_count, days.other)),
+        incident_rate_delta_pp: ppDelta(baseline.incident_rate_pct, other.incident_rate_pct),
+        element_incident_rate_delta_pp: ppDelta(baseline.element_incident_rate_pct, other.element_incident_rate_pct),
+        avg_duration_delta_pct: pctChange(baseline.avg_duration_sec, other.avg_duration_sec),
+        p95_duration_delta_pct: pctChange(baseline.p95_duration_sec, other.p95_duration_sec),
+    };
+}
+/**
+ * Whether a comparison is below the trust threshold: a partition with fewer
+ * than `minBucketSize` started instances (the rates' base) OR fewer completed
+ * ones (the durations' sample) is noise, not a signal.
+ */
+export function belowMinBucket(partitions, minBucketSize) {
+    return partitions.some((p) => p.instance_count < minBucketSize || p.completed_count < minBucketSize);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/queries/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/queries/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,YAAY,IAAI,CAAC,EAAkB,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAoB,MAAM,cAAc,CAAA;AAEtF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAA;AAE5D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;AAE1D,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAiB,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAA;AAExF;;;;GAIG;AACH,MAAM,aAAa,GAAG,IAAI,CAAA;AAC1B,MAAM,qBAAqB,GAAG,IAAI,CAAA;AAElC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,CAAc;IACvD,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAA;IACjD,MAAM,KAAK,GAAG,YAAY,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,GAAG,CAAA;IACpD,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;IACjC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IACjC,MAAM,MAAM,GAAG,qBAAqB,MAAM,IAAI,aAAa,IAAI,EAAE,WAAW,MAAM,GAAG,CAAA;IACrF,OAAO,CACL,KAAK,KAAK,QAAQ,MAAM,GAAG;QAC3B,sBAAsB,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,YAAY,MAAM,IAAI,CACpE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,CAAc,EAAE,MAAc,UAAU,EAAE;IACjE,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,OAAO,CAAA;IACrC,IAAI,KAAK,GAAG,qBAAqB,IAAI,GAAG,GAAG,cAAc,GAAG,WAAW;QAAE,OAAO,CAAC,CAAC,KAAK,CAAA;IACvF,OAAO,OAAO,GAAG,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,qBAAqB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AACvF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAgB,EAAE,GAAW,EAAE,EAAE,CAC3D,WAAW,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,GAAG,GAAG,CAAA;AAE9D;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAa;IAC1D,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,KAAK,KAAK,wEAAwE,CAC3F,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAErE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;AAEpG,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAqB,EAAY,EAAE,CACpE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AAE/F,mGAAmG;AACnG,MAAM,CAAC,MAAM,OAAO,GAAG,GAAW,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AAE7D;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAAqB,EAAE,KAAa;IAC1D,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACzB,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAA;IACvC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAqB,EAAE,KAAoB;IACnE,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAClE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;AAC9D,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,MAAqB,EAAE,KAAoB;IACjE,OAAO,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAA;AAC1E,CAAC;AAeD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe,EAAE,CAAc;IACxD,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,KAAK,CAAA;IACnC,MAAM,QAAQ,GAAG,CAAC,CAAC,uBAAuB,CAAA;IAC1C,OAAO;QACL,OAAO,EAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,sBAAsB,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG;QACrE,SAAS,EAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,oBAAoB,GAAG,YAAY,EAAE,EAAE,CAAC,CAAC,GAAG;QAC9E,SAAS,EAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,eAAe,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG;QAChE,WAAW,EAAE,OAAO,UAAU,CAAC,GAAG,QAAQ,OAAO,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,UAAU,CAAC,GAAG,QAAQ,SAAS,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG;QAChH,cAAc,EAAE,uCAAuC,UAAU,CAAC,GAAG,QAAQ,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI;QACpG,WAAW,EAAE,wCAAwC,UAAU,CAAC,GAAG,QAAQ,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI;KACnG,CAAA;AACH,CAAC;AAyBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAoB,EACpB,KAAe,EACf,CAAc;IAEd,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,kBAAkB,CAAA;IACxC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,gBAAgB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClF,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACrB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;QACzB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;QACzB,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,eAAe,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;KAC1E,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAClD,MAAM,YAAY,GAAG,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAC3F,OAAO;QACL,cAAc,EAAE,SAAS;QACzB,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7C,cAAc,EAAE,aAAa;QAC7B,iBAAiB,EAAE,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC;QACpD,sBAAsB,EAAE,YAAY;QACpC,yBAAyB,EAAE,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC;QAC1F,gBAAgB,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,gBAAgB,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;KAClD,CAAA;AACH,CAAC;AA6BD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAoB,EACpB,KAAiB,EACjB,IAAyC;IAEzC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACvE,OAAO;QACL,yBAAyB,EAAE,SAAS,CAClC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,EAC9C,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CACzC;QACD,sBAAsB,EAAE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC;QACpF,8BAA8B,EAAE,OAAO,CACrC,QAAQ,CAAC,yBAAyB,EAClC,KAAK,CAAC,yBAAyB,CAChC;QACD,sBAAsB,EAAE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC;QACpF,sBAAsB,EAAE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC;KACrF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAkF,EAClF,aAAqB;IAErB,OAAO,UAAU,CAAC,IAAI,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,aAAa,IAAI,CAAC,CAAC,eAAe,GAAG,aAAa,CAC7E,CAAA;AACH,CAAC"}

package/dist/queries/helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=helpers.test.d.ts.map

package/dist/queries/helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.d.ts","sourceRoot":"","sources":["../../src/queries/helpers.test.ts"],"names":[],"mappings":""}

package/dist/queries/helpers.test.js

@@ -0,0 +1,53 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { increaseIn } from "./helpers.js";
+import { DAY_SECONDS, rangeSeconds } from "./windows.js";
+const NOW = Date.UTC(2026, 9, 12, 12, 0, 0);
+const NOW_SECONDS = NOW / 1000;
+beforeEach(() => {
+    vi.useFakeTimers({ toFake: ["Date"], now: NOW });
+});
+afterEach(() => {
+    vi.useRealTimers();
+});
+describe("increaseIn", () => {
+    it("counts a series born inside the window with its whole value", () => {
+        expect(increaseIn('camunda_x_total{engine_id="a"}', { range: "7d" })).toBe('((increase(camunda_x_total{engine_id="a"}[7d]) and present_over_time(camunda_x_total{engine_id="a"}[1h] offset 7d))' +
+            ' or (max_over_time(camunda_x_total{engine_id="a"}[7d]) unless present_over_time(camunda_x_total{engine_id="a"}[1h] offset 7d)))');
+    });
+    it("pins every part of a window that ends in the past", () => {
+        const at = NOW_SECONDS - 3 * DAY_SECONDS;
+        expect(increaseIn("camunda_x_total", { range: "86400s", at })).toBe(`((increase(camunda_x_total[86400s] @ ${at}) and present_over_time(camunda_x_total[1h] @ ${at} offset 86400s))` +
+            ` or (max_over_time(camunda_x_total[86400s] @ ${at}) unless present_over_time(camunda_x_total[1h] @ ${at} offset 86400s)))`);
+    });
+    it("checks the window's first hour where the hour before it lies past the retention", () => {
+        // 30 days back reaches the retention edge: the series silent in the window's
+        // first hour (30d − 1h = 2588400s before its end) were born inside it.
+        expect(increaseIn("camunda_x_total", { range: "30d" })).toBe("((increase(camunda_x_total[30d]) and present_over_time(camunda_x_total[1h] offset 2588400s))" +
+            " or (max_over_time(camunda_x_total[30d]) unless present_over_time(camunda_x_total[1h] offset 2588400s)))");
+        const at = NOW_SECONDS - 29 * DAY_SECONDS;
+        expect(increaseIn("camunda_x_total", { range: "1d", at })).toContain(`present_over_time(camunda_x_total[1h] @ ${at} offset 82800s)`);
+        // The hour before the window starts exactly at the retention edge: still that hour.
+        const edge = NOW_SECONDS - 30 * DAY_SECONDS + 3600 + DAY_SECONDS;
+        expect(increaseIn("camunda_x_total", { range: "1d", at: edge })).toContain(`present_over_time(camunda_x_total[1h] @ ${edge} offset 1d)`);
+        expect(increaseIn("camunda_x_total", { range: "1d", at: edge - 1 })).toContain(`present_over_time(camunda_x_total[1h] @ ${edge - 1} offset 82800s)`);
+    });
+    it("reads plain increase() for a window of an hour or less at the retention edge", () => {
+        const at = NOW_SECONDS - 30 * DAY_SECONDS + 1800;
+        expect(increaseIn("camunda_x_total", { range: "3600s", at })).toBe(`increase(camunda_x_total[3600s] @ ${at})`);
+    });
+    it("refuses a range it cannot measure", () => {
+        expect(() => increaseIn("camunda_x_total", { range: "1d12h" })).toThrow(/single-unit/);
+    });
+});
+describe("rangeSeconds", () => {
+    it("measures every single-unit PromQL duration", () => {
+        expect(["30s", "5m", "2h", "1d", "1w"].map(rangeSeconds)).toEqual([
+            30,
+            300,
+            7200,
+            DAY_SECONDS,
+            7 * DAY_SECONDS,
+        ]);
+    });
+});
+//# sourceMappingURL=helpers.test.js.map

package/dist/queries/helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.js","sourceRoot":"","sources":["../../src/queries/helpers.test.ts"],"names":[],"mappings":"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"}

package/dist/queries/index.d.ts

@@ -0,0 +1,19 @@
+export type { CompareKpis, CompareKpiDelta } from "./helpers.js";
+export { analyzePerformance, comparePeriods } from "./performance.js";
+export type { PerformanceResult, PerformanceKPI, ActivityBreakdownRow, PeriodComparisonKpi, PeriodActivityComparisonRow, PeriodComparisonResult, } from "./performance.js";
+export { findFailedInstances } from "./failures.js";
+export type { ErrorPatternRow, FailedInstancesResult } from "./failures.js";
+export { elementBottleneck, elementHeat } from "./element.js";
+export type { ElementBottleneckRow, ElementBottleneckResult, ElementHeatResult } from "./element.js";
+export { clusterCompare } from "./cluster-compare.js";
+export type { ClusterCompareResult, ClusterCompareKpi, ClusterCompareDelta, } from "./cluster-compare.js";
+export { versionCompare } from "./version-compare.js";
+export type { VersionCompareResult, VersionCompareKpi, VersionCompareDelta, } from "./version-compare.js";
+export { engineCompare } from "./engine-compare.js";
+export type { EngineCompareResult, EngineCompareKpi, EngineCompareDelta } from "./engine-compare.js";
+export { engineLandscape } from "./engine-landscape.js";
+export type { EngineLandscapeResult, EngineLandscapeEngine, EngineLandscapeProcess, } from "./engine-landscape.js";
+export { dashboardData, failureDashboardData } from "./dashboard.js";
+export { engineHealth } from "./health.js";
+export type { EngineHealthResult, HealthCount, HealthAlert } from "./health.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/queries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queries/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC7D,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/queries/index.js

@@ -0,0 +1,10 @@
+export { analyzePerformance, comparePeriods } from "./performance.js";
+export { findFailedInstances } from "./failures.js";
+export { elementBottleneck, elementHeat } from "./element.js";
+export { clusterCompare } from "./cluster-compare.js";
+export { versionCompare } from "./version-compare.js";
+export { engineCompare } from "./engine-compare.js";
+export { engineLandscape } from "./engine-landscape.js";
+export { dashboardData, failureDashboardData } from "./dashboard.js";
+export { engineHealth } from "./health.js";
+//# sourceMappingURL=index.js.map

package/dist/queries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queries/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AASrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAMrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAMrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAMvD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/queries/performance.d.ts

@@ -0,0 +1,103 @@
+import { type EngineFilterInput, type PrometheusClient } from "../prometheus.js";
+export interface PerformanceKPI {
+    process_definition_key: string;
+    /** Instances started in the window. */
+    total_instances: number;
+    /** Instances that ended with state COMPLETED in the window. */
+    completed: number;
+    /** Incidents created in the window — incidents, not failed instances. */
+    incident_count: number;
+    /** `incident_count` per 100 started instances (may exceed 100); null when nothing started. */
+    incident_rate_pct: number | null;
+    /** Durations of the instances that ENDED in the window; null when none did. */
+    avg_duration_sec: number | null;
+    median_duration_sec: number | null;
+    p95_duration_sec: number | null;
+}
+export interface ActivityBreakdownRow {
+    activity_id: string;
+    /** Not a metric label — resolve names from the BPMN. Always null. */
+    activity_name: null;
+    activity_type: string;
+    execution_count: number;
+    avg_duration_sec: number | null;
+    median_duration_sec: number | null;
+    p95_duration_sec: number | null;
+    total_time_sec: number;
+}
+export interface PeriodComparisonKpi {
+    period: string;
+    /** The window actually measured, after clamping to now and retention. */
+    window_from: string;
+    window_to: string;
+    window_days: number;
+    /** True when clamping cut the requested window short. */
+    partial: boolean;
+    total_instances: number;
+    /**
+     * `total_instances` per day of the window's exact length — the figure to
+     * compare across windows of different length. Always measured: a clamped
+     * window is never empty (`clampWindow` refuses one).
+     */
+    started_per_day: number;
+    completed: number;
+    incident_count: number;
+    incident_rate_pct: number | null;
+    avg_duration_sec: number | null;
+    median_sec: number | null;
+    p95_sec: number | null;
+}
+export interface PeriodActivityComparisonRow {
+    activity_id: string;
+    activity_name: null;
+    period: string;
+    executions: number;
+    avg_sec: number | null;
+    p95_sec: number | null;
+}
+/** Result of {@link analyzePerformance}. */
+export interface PerformanceResult {
+    /** The engine ids covered; `null` = every engine Prometheus holds (unscoped library call). */
+    engines: string[] | null;
+    kpi: PerformanceKPI | null;
+    activityBreakdown: ActivityBreakdownRow[];
+}
+export interface PeriodComparisonResult {
+    /** The engine ids covered; `null` = every engine Prometheus holds (unscoped library call). */
+    engines: string[] | null;
+    kpiComparison: PeriodComparisonKpi[];
+    activityComparison?: PeriodActivityComparisonRow[];
+}
+/**
+ * Process performance KPIs over a rolling window, from OTEL metrics.
+ *
+ * Counts come from {@link increaseIn} over the period; durations from the histogram
+ * (`histogram_quantile` for p50/p95, sum/count for the mean) and cover the
+ * instances that ENDED in the window — `null` when none did. `incident_count`
+ * counts incidents created (metrics carry no per-instance terminal-failure
+ * state). `kpi` is null only when the window saw no start, end or incident.
+ */
+export declare function analyzePerformance(ch: PrometheusClient, params: {
+    processDefinitionKey: string;
+    period: string;
+    includeActivityBreakdown: boolean;
+    engine?: EngineFilterInput;
+}): Promise<PerformanceResult>;
+/**
+ * Compare two explicit execution windows. Each is read as a real historical
+ * window via the PromQL `@ <end>` modifier, clamped to `[now − retention,
+ * now]` and reported with its ACTUAL bounds (`window_*`, `partial`). Windows
+ * of different length are not comparable by count, so each KPI row also
+ * carries `started_per_day`. A reversed window, or one entirely in the future
+ * or before retention, is refused.
+ */
+export declare function comparePeriods(ch: PrometheusClient, params: {
+    processDefinitionKey: string;
+    periodAFrom: string;
+    periodATo: string;
+    periodBFrom: string;
+    periodBTo: string;
+    includeActivityBreakdown: boolean;
+    engine?: EngineFilterInput;
+}): Promise<PeriodComparisonResult>;
+//# sourceMappingURL=performance.d.ts.map

package/dist/queries/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/queries/performance.ts"],"names":[],"mappings":"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"}

package/dist/queries/performance.js

@@ -0,0 +1,173 @@
+import { engineIdsOf, engineMatcher, escapeLabelValue, selector, } from "../prometheus.js";
+import { METRIC_NAMES as M } from "../metric-names.js";
+import { byLabel, first, firstOrNull, increaseIn, kpiQueries, parseIsoSeconds, ratePct, round1, secondsOf, secondsOrNull, } from "./helpers.js";
+import { clampWindow, DAY_SECONDS, daysOf, isoOf, nowSeconds, windowAt, } from "./windows.js";
+/** `{process_definition_key=..., engine_id=...}` plus any extra matchers. */
+function pdkSelector(key, engineId, ...extra) {
+    return selector(`process_definition_key="${escapeLabelValue(key)}"`, engineMatcher(engineId), ...extra);
+}
+/**
+ * Process performance KPIs over a rolling window, from OTEL metrics.
+ *
+ * Counts come from {@link increaseIn} over the period; durations from the histogram
+ * (`histogram_quantile` for p50/p95, sum/count for the mean) and cover the
+ * instances that ENDED in the window — `null` when none did. `incident_count`
+ * counts incidents created (metrics carry no per-instance terminal-failure
+ * state). `kpi` is null only when the window saw no start, end or incident.
+ */
+export async function analyzePerformance(ch, params) {
+    const range = params.period ?? "7d";
+    const q = kpiQueries({
+        sel: pdkSelector(params.processDefinitionKey, params.engine),
+        completedSel: pdkSelector(params.processDefinitionKey, params.engine, 'state="COMPLETED"'),
+    }, { range });
+    const [total, completed, incidents, avg, median, p95] = await Promise.all([
+        ch.instant(q.started),
+        ch.instant(q.completed),
+        ch.instant(q.incidents),
+        ch.instant(q.avgDuration),
+        ch.instant(q.medianDuration),
+        ch.instant(q.p95Duration),
+    ]);
+    const totalInstances = Math.round(first(total));
+    const completedCount = Math.round(first(completed));
+    const incidentCount = Math.round(first(incidents));
+    const avgMs = firstOrNull(avg);
+    const observed = totalInstances > 0 || completedCount > 0 || incidentCount > 0 || avgMs !== null;
+    const kpi = observed
+        ? {
+            process_definition_key: params.processDefinitionKey,
+            total_instances: totalInstances,
+            completed: completedCount,
+            incident_count: incidentCount,
+            incident_rate_pct: ratePct(incidentCount, totalInstances),
+            avg_duration_sec: secondsOrNull(avgMs),
+            median_duration_sec: secondsOrNull(firstOrNull(median)),
+            p95_duration_sec: secondsOrNull(firstOrNull(p95)),
+        }
+        : null;
+    let activityBreakdown = [];
+    if (params.includeActivityBreakdown) {
+        activityBreakdown = await activityBreakdownRows(ch, params.processDefinitionKey, { range }, params.engine);
+    }
+    return { engines: engineIdsOf(params.engine), kpi, activityBreakdown };
+}
+async function activityBreakdownRows(ch, key, w, engineId) {
+    const sel = pdkSelector(key, engineId);
+    const inWindow = (series) => increaseIn(series, w);
+    const [counts, sums, median, p95] = await Promise.all([
+        ch.instant(`sum by (activity_id, activity_type)(${inWindow(`${M.activityEnded}${sel}`)})`),
+        ch.instant(`sum by (activity_id)(${inWindow(`${M.activityDuration}_sum${sel}`)})`),
+        ch.instant(`histogram_quantile(0.5, sum by (activity_id, le)(${inWindow(`${M.activityDuration}_bucket${sel}`)}))`),
+        ch.instant(`histogram_quantile(0.95, sum by (activity_id, le)(${inWindow(`${M.activityDuration}_bucket${sel}`)}))`),
+    ]);
+    const sumBy = byLabel(sums, "activity_id");
+    const medianBy = byLabel(median, "activity_id");
+    const p95By = byLabel(p95, "activity_id");
+    const rows = counts.map((c) => {
+        const id = c.metric.activity_id ?? "";
+        const count = Math.round(c.value);
+        const sumMs = sumBy[id];
+        return {
+            activity_id: id,
+            activity_name: null,
+            activity_type: c.metric.activity_type ?? "",
+            execution_count: count,
+            avg_duration_sec: sumMs !== undefined && count > 0 ? secondsOf(sumMs / count) : null,
+            median_duration_sec: secondsOrNull(medianBy[id] ?? null),
+            p95_duration_sec: secondsOrNull(p95By[id] ?? null),
+            total_time_sec: secondsOf(sumMs ?? 0),
+        };
+    });
+    return rows.sort((a, b) => b.total_time_sec - a.total_time_sec).slice(0, 20);
+}
+/**
+ * Compare two explicit execution windows. Each is read as a real historical
+ * window via the PromQL `@ <end>` modifier, clamped to `[now − retention,
+ * now]` and reported with its ACTUAL bounds (`window_*`, `partial`). Windows
+ * of different length are not comparable by count, so each KPI row also
+ * carries `started_per_day`. A reversed window, or one entirely in the future
+ * or before retention, is refused.
+ */
+export async function comparePeriods(ch, params) {
+    const now = nowSeconds();
+    const a = explicitWindow("periodA", params.periodAFrom, params.periodATo, now);
+    const b = explicitWindow("periodB", params.periodBFrom, params.periodBTo, now);
+    const [kpiA, kpiB] = await Promise.all([
+        periodKpi(ch, params.processDefinitionKey, "Period A", a, params.engine),
+        periodKpi(ch, params.processDefinitionKey, "Period B", b, params.engine),
+    ]);
+    const result = {
+        engines: engineIdsOf(params.engine),
+        kpiComparison: [kpiA, kpiB],
+    };
+    if (params.includeActivityBreakdown) {
+        const [actA, actB] = await Promise.all([
+            periodActivities(ch, params.processDefinitionKey, "Period A", a, params.engine),
+            periodActivities(ch, params.processDefinitionKey, "Period B", b, params.engine),
+        ]);
+        result.activityComparison = [...actA, ...actB].sort((x, y) => x.activity_id.localeCompare(y.activity_id) || x.period.localeCompare(y.period));
+    }
+    return result;
+}
+function explicitWindow(name, from, to, now) {
+    return clampWindow(name, parseIsoSeconds(from, `${name}From`), parseIsoSeconds(to, `${name}To`), now);
+}
+async function periodKpi(ch, key, label, w, engineId) {
+    const q = kpiQueries({
+        sel: pdkSelector(key, engineId),
+        completedSel: pdkSelector(key, engineId, 'state="COMPLETED"'),
+    }, windowAt(w));
+    const [total, completed, incidents, avg, median, p95] = await Promise.all([
+        ch.instant(q.started),
+        ch.instant(q.completed),
+        ch.instant(q.incidents),
+        ch.instant(q.avgDuration),
+        ch.instant(q.medianDuration),
+        ch.instant(q.p95Duration),
+    ]);
+    const totalInstances = Math.round(first(total));
+    const incidentCount = Math.round(first(incidents));
+    return {
+        period: label,
+        window_from: isoOf(w.from),
+        window_to: isoOf(w.to),
+        window_days: daysOf(w.seconds),
+        partial: w.partial,
+        total_instances: totalInstances,
+        // From the exact length — the rounded window_days is for display: a
+        // 10-minute window is 0.01 d there (−30 %), a 5-minute one 0.00 d.
+        started_per_day: round1((totalInstances * DAY_SECONDS) / w.seconds),
+        completed: Math.round(first(completed)),
+        incident_count: incidentCount,
+        incident_rate_pct: ratePct(incidentCount, totalInstances),
+        avg_duration_sec: secondsOrNull(firstOrNull(avg)),
+        median_sec: secondsOrNull(firstOrNull(median)),
+        p95_sec: secondsOrNull(firstOrNull(p95)),
+    };
+}
+async function periodActivities(ch, key, label, w, engineId) {
+    const sel = pdkSelector(key, engineId);
+    const inWindow = (series) => increaseIn(series, windowAt(w));
+    const [counts, sums, p95] = await Promise.all([
+        ch.instant(`sum by (activity_id)(${inWindow(`${M.activityEnded}${sel}`)})`),
+        ch.instant(`sum by (activity_id)(${inWindow(`${M.activityDuration}_sum${sel}`)})`),
+        ch.instant(`histogram_quantile(0.95, sum by (activity_id, le)(${inWindow(`${M.activityDuration}_bucket${sel}`)}))`),
+    ]);
+    const sumBy = byLabel(sums, "activity_id");
+    const p95By = byLabel(p95, "activity_id");
+    return counts.map((c) => {
+        const id = c.metric.activity_id ?? "";
+        const executions = Math.round(c.value);
+        const sumMs = sumBy[id];
+        return {
+            activity_id: id,
+            activity_name: null,
+            period: label,
+            executions,
+            avg_sec: sumMs !== undefined && executions > 0 ? secondsOf(sumMs / executions) : null,
+            p95_sec: secondsOrNull(p95By[id] ?? null),
+        };
+    });
+}
+//# sourceMappingURL=performance.js.map

package/dist/queries/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/queries/performance.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,QAAQ,GAIT,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,IAAI,CAAC,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,OAAO,EACP,MAAM,EACN,SAAS,EACT,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,WAAW,EACX,WAAW,EACX,MAAM,EACN,KAAK,EACL,UAAU,EACV,QAAQ,GAGT,MAAM,cAAc,CAAA;AA6ErB,6EAA6E;AAC7E,SAAS,WAAW,CAClB,GAAW,EACX,QAA2B,EAC3B,GAAG,KAAgC;IAEnC,OAAO,QAAQ,CACb,2BAA2B,gBAAgB,CAAC,GAAG,CAAC,GAAG,EACnD,aAAa,CAAC,QAAQ,CAAC,EACvB,GAAG,KAAK,CACT,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAoB,EACpB,MAKC;IAED,MAAM,KAAK,GAAI,MAAM,CAAC,MAAiB,IAAI,IAAI,CAAA;IAC/C,MAAM,CAAC,GAAG,UAAU,CAClB;QACE,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5D,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;KAC3F,EACD,EAAE,KAAK,EAAE,CACV,CAAA;IAED,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACrB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;QACzB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;QAC5B,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;KAC1B,CAAC,CAAA;IAEF,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IACnD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,QAAQ,GAAG,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,CAAA;IAChG,MAAM,GAAG,GAA0B,QAAQ;QACzC,CAAC,CAAC;YACE,sBAAsB,EAAE,MAAM,CAAC,oBAAoB;YACnD,eAAe,EAAE,cAAc;YAC/B,SAAS,EAAE,cAAc;YACzB,cAAc,EAAE,aAAa;YAC7B,iBAAiB,EAAE,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC;YACzD,gBAAgB,EAAE,aAAa,CAAC,KAAK,CAAC;YACtC,mBAAmB,EAAE,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACvD,gBAAgB,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;SAClD;QACH,CAAC,CAAC,IAAI,CAAA;IAER,IAAI,iBAAiB,GAA2B,EAAE,CAAA;IAClD,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;QACpC,iBAAiB,GAAG,MAAM,qBAAqB,CAC7C,EAAE,EACF,MAAM,CAAC,oBAAoB,EAC3B,EAAE,KAAK,EAAE,EACT,MAAM,CAAC,MAAM,CACd,CAAA;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,EAAoB,EACpB,GAAW,EACX,CAAc,EACd,QAA2B;IAE3B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1D,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,EAAE,CAAC,OAAO,CAAC,uCAAuC,QAAQ,CAAC,GAAG,CAAC,CAAC,aAAa,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC;QAC1F,EAAE,CAAC,OAAO,CAAC,wBAAwB,QAAQ,CAAC,GAAG,CAAC,CAAC,gBAAgB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC;QAClF,EAAE,CAAC,OAAO,CACR,oDAAoD,QAAQ,CAAC,GAAG,CAAC,CAAC,gBAAgB,UAAU,GAAG,EAAE,CAAC,IAAI,CACvG;QACD,EAAE,CAAC,OAAO,CACR,qDAAqD,QAAQ,CAAC,GAAG,CAAC,CAAC,gBAAgB,UAAU,GAAG,EAAE,CAAC,IAAI,CACxG;KACF,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IACzC,MAAM,IAAI,GAA2B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpD,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAA;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,CAAA;QACvB,OAAO;YACL,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,IAAI;YACnB,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE;YAC3C,eAAe,EAAE,KAAK;YACtB,gBAAgB,EAAE,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;YACpF,mBAAmB,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;YACxD,gBAAgB,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;YAClD,cAAc,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC;SACtC,CAAA;IACH,CAAC,CAAC,CAAA;IACF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAoB,EACpB,MAQC;IAED,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;IACxB,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAC9E,MAAM,CAAC,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAC9E,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QACxE,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;KACzE,CAAC,CAAA;IACF,MAAM,MAAM,GAA2B;QACrC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;QACnC,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KAC5B,CAAA;IAED,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACrC,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;YAC/E,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;SAChF,CAAC,CAAA;QACF,MAAM,CAAC,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CACzF,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,cAAc,CACrB,IAA2B,EAC3B,IAAY,EACZ,EAAU,EACV,GAAW;IAEX,OAAO,WAAW,CAChB,IAAI,EACJ,eAAe,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC,EACpC,eAAe,CAAC,EAAE,EAAE,GAAG,IAAI,IAAI,CAAC,EAChC,GAAG,CACJ,CAAA;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,EAAoB,EACpB,GAAW,EACX,KAAa,EACb,CAAgB,EAChB,QAA2B;IAE3B,MAAM,CAAC,GAAG,UAAU,CAClB;QACE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC;QAC/B,YAAY,EAAE,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,mBAAmB,CAAC;KAC9D,EACD,QAAQ,CAAC,CAAC,CAAC,CACZ,CAAA;IACD,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACrB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;QACzB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;QAC5B,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;KAC1B,CAAC,CAAA;IACF,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAClD,OAAO;QACL,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1B,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,eAAe,EAAE,cAAc;QAC/B,oEAAoE;QACpE,mEAAmE;QACnE,eAAe,EAAE,MAAM,CAAC,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACnE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvC,cAAc,EAAE,aAAa;QAC7B,iBAAiB,EAAE,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC;QACzD,gBAAgB,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;KACzC,CAAA;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,EAAoB,EACpB,GAAW,EACX,KAAa,EACb,CAAgB,EAChB,QAA2B;IAE3B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IACpE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,EAAE,CAAC,OAAO,CAAC,wBAAwB,QAAQ,CAAC,GAAG,CAAC,CAAC,aAAa,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC;QAC3E,EAAE,CAAC,OAAO,CAAC,wBAAwB,QAAQ,CAAC,GAAG,CAAC,CAAC,gBAAgB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC;QAClF,EAAE,CAAC,OAAO,CACR,qDAAqD,QAAQ,CAAC,GAAG,CAAC,CAAC,gBAAgB,UAAU,GAAG,EAAE,CAAC,IAAI,CACxG;KACF,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAA;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,CAAA;QACvB,OAAO;YACL,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,IAAI;YACnB,MAAM,EAAE,KAAK;YACb,UAAU;YACV,OAAO,EAAE,KAAK,KAAK,SAAS,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;YACrF,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;SAC1C,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}