@miragon/pulse-analytics-client 0.0.0-bootstrap.0 → 0.21.0

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

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

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

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

package/dist/queries/performance.test.js

@@ -0,0 +1,265 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { analyzePerformance, comparePeriods } from "./performance.js";
+const v = (value) => ({ metric: {}, value });
+/** Mock Prometheus client that dispatches canned samples by the PromQL it sees (durations in ms). */
+function mockClient() {
+    const instant = vi.fn(async (q) => {
+        if (q.includes("camunda_activity_ended_total")) {
+            return [
+                { metric: { activity_id: "A", activity_type: "serviceTask" }, value: 10 },
+                { metric: { activity_id: "B", activity_type: "userTask" }, value: 4 },
+            ];
+        }
+        if (q.includes("camunda_activity_duration_milliseconds_sum")) {
+            return [
+                { metric: { activity_id: "A" }, value: 100_000 },
+                { metric: { activity_id: "B" }, value: 10_000 },
+            ];
+        }
+        if (q.includes("histogram_quantile(0.5, sum by (activity_id, le)")) {
+            // B's buckets did not move: no median for it.
+            return [{ metric: { activity_id: "A" }, value: 9_000 }];
+        }
+        if (q.includes("activity_id, le")) {
+            return [
+                { metric: { activity_id: "A" }, value: 15_000 },
+                { metric: { activity_id: "B" }, value: 5_000 },
+            ];
+        }
+        if (q.includes("histogram_quantile(0.5"))
+            return [v(8_000)];
+        if (q.includes("histogram_quantile(0.95"))
+            return [v(20_000)];
+        if (q.includes("incident_created"))
+            return [v(5)];
+        if (q.includes('state="COMPLETED"'))
+            return [v(40)];
+        if (q.includes("started_total"))
+            return [v(50)];
+        if (q.includes("duration_milliseconds_sum"))
+            return [v(10_040)]; // avg = sum/count expression
+        return [];
+    });
+    const ch = { instant };
+    return { ch, instant };
+}
+describe("analyzePerformance", () => {
+    it("maps counts, incidents and rounded durations into the KPI", async () => {
+        const { ch } = mockClient();
+        const res = await analyzePerformance(ch, {
+            processDefinitionKey: "order",
+            period: "7d",
+            includeActivityBreakdown: true,
+        });
+        expect(res.kpi).toEqual({
+            process_definition_key: "order",
+            total_instances: 50,
+            completed: 40,
+            incident_count: 5,
+            incident_rate_pct: 10,
+            avg_duration_sec: 10, // 10.04 rounded to one decimal
+            median_duration_sec: 8,
+            p95_duration_sec: 20,
+        });
+        // Ranked by total time; names degrade to null on metrics; the median is
+        // computed from the histogram, null where the buckets did not move.
+        expect(res.activityBreakdown).toEqual([
+            {
+                activity_id: "A",
+                activity_name: null,
+                activity_type: "serviceTask",
+                execution_count: 10,
+                avg_duration_sec: 10,
+                median_duration_sec: 9,
+                p95_duration_sec: 15,
+                total_time_sec: 100,
+            },
+            {
+                activity_id: "B",
+                activity_name: null,
+                activity_type: "userTask",
+                execution_count: 4,
+                avg_duration_sec: 2.5,
+                median_duration_sec: null,
+                p95_duration_sec: 5,
+                total_time_sec: 10,
+            },
+        ]);
+    });
+    it("returns a null KPI (no fabricated zeros) when the window saw nothing", async () => {
+        const instant = vi.fn(async () => []);
+        const res = await analyzePerformance({ instant }, { processDefinitionKey: "order", period: "7d", includeActivityBreakdown: false });
+        expect(res.kpi).toBeNull();
+        expect(res.activityBreakdown).toEqual([]);
+    });
+    it("keeps the KPI when instances ended but none started, with an unmeasured rate", async () => {
+        const instant = vi.fn(async (q) => q.includes('state="COMPLETED"')
+            ? [v(3)]
+            : q.includes("duration_milliseconds_sum")
+                ? [v(60_000)]
+                : []);
+        const res = await analyzePerformance({ instant }, { processDefinitionKey: "order", period: "1d", includeActivityBreakdown: false });
+        expect(res.kpi).toMatchObject({
+            total_instances: 0,
+            completed: 3,
+            incident_rate_pct: null,
+            avg_duration_sec: 60,
+            p95_duration_sec: null,
+        });
+    });
+    it("skips the breakdown queries when includeActivityBreakdown is false", async () => {
+        const { ch, instant } = mockClient();
+        await analyzePerformance(ch, {
+            processDefinitionKey: "order",
+            period: "7d",
+            includeActivityBreakdown: false,
+        });
+        const queries = instant.mock.calls.map((c) => c[0]);
+        expect(queries).toHaveLength(6);
+        expect(queries.some((q) => q.includes("camunda_activity_"))).toBe(false);
+    });
+});
+describe("comparePeriods", () => {
+    const NOW = "2026-02-05T00:00:00Z";
+    const NOW_SEC = Date.parse(NOW) / 1000;
+    const PERIOD_A = { from: "2026-01-10T00:00:00Z", to: "2026-01-11T00:00:00Z" };
+    const PERIOD_B = { from: "2026-02-01T00:00:00Z", to: "2026-02-03T00:00:00Z" };
+    const AT_A = `@ ${Date.parse(PERIOD_A.to) / 1000}`;
+    const base = {
+        processDefinitionKey: "order",
+        periodAFrom: PERIOD_A.from,
+        periodATo: PERIOD_A.to,
+        periodBFrom: PERIOD_B.from,
+        periodBTo: PERIOD_B.to,
+        includeActivityBreakdown: false,
+    };
+    beforeEach(() => {
+        vi.useFakeTimers({ toFake: ["Date"], now: Date.parse(NOW) });
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("labels both windows and resolves each KPI from its own historical window", async () => {
+        const instant = vi.fn(async (q) => {
+            const count = q.includes(AT_A) ? 10 : 30;
+            // count / 10 seconds, in ms
+            if (q.includes("histogram_quantile"))
+                return [v(count * 100)];
+            if (q.includes("duration_milliseconds_sum"))
+                return [v(count * 100)];
+            if (q.includes("incident_created"))
+                return [v(1)];
+            if (q.includes('state="COMPLETED"'))
+                return [v(count - 2)];
+            return [v(count)];
+        });
+        const res = await comparePeriods({ instant }, base);
+        expect(res.activityComparison).toBeUndefined();
+        expect(res.kpiComparison).toEqual([
+            {
+                period: "Period A",
+                window_from: "2026-01-10T00:00:00.000Z",
+                window_to: "2026-01-11T00:00:00.000Z",
+                window_days: 1,
+                partial: false,
+                total_instances: 10,
+                started_per_day: 10,
+                completed: 8,
+                incident_count: 1,
+                incident_rate_pct: 10,
+                avg_duration_sec: 1,
+                median_sec: 1,
+                p95_sec: 1,
+            },
+            {
+                period: "Period B",
+                window_from: "2026-02-01T00:00:00.000Z",
+                window_to: "2026-02-03T00:00:00.000Z",
+                window_days: 2,
+                partial: false,
+                total_instances: 30,
+                // Twice the window: per day, B runs 1.5× A — not 3×.
+                started_per_day: 15,
+                completed: 28,
+                incident_count: 1,
+                incident_rate_pct: 3.3,
+                avg_duration_sec: 3,
+                median_sec: 3,
+                p95_sec: 3,
+            },
+        ]);
+    });
+    it.each([
+        // [label, window, starts, true starts per day]
+        ["10 minutes", ["2026-02-01T00:00:00Z", "2026-02-01T00:10:00Z"], 4, 576],
+        ["1 hour", ["2026-02-01T00:00:00Z", "2026-02-01T01:00:00Z"], 24, 576],
+        // Rounded to 0.00 days this window used to read as "not measured".
+        ["5 minutes", ["2026-02-01T00:00:00Z", "2026-02-01T00:05:00Z"], 3, 864],
+    ])("rates a %s window's starts per day from its exact length, not the rounded window_days", async (_label, [from, to], starts, perDay) => {
+        const instant = vi.fn(async (q) => q.includes("started_total") && !q.includes(AT_A) ? [v(starts)] : []);
+        const res = await comparePeriods({ instant }, { ...base, periodBFrom: from, periodBTo: to });
+        expect(res.kpiComparison[1].started_per_day).toBe(perDay);
+    });
+    it("clamps a window reaching past now and flags it partial (N79)", async () => {
+        const sent = [];
+        const instant = (q) => {
+            sent.push(q);
+            return Promise.resolve([v(1)]);
+        };
+        const res = await comparePeriods({ instant }, { ...base, periodBFrom: "2026-02-04T00:00:00Z", periodBTo: "2026-02-11T00:00:00Z" });
+        expect(res.kpiComparison[1]).toMatchObject({
+            window_to: "2026-02-05T00:00:00.000Z",
+            window_days: 1,
+            partial: true,
+        });
+        const anchors = sent.map((q) => Number(/@ (\d+)/.exec(q)?.[1]));
+        expect(anchors.every((at) => at <= NOW_SEC)).toBe(true);
+    });
+    it.each([
+        ["reversed", "2026-02-03T00:00:00Z", "2026-02-01T00:00:00Z", /ends before it starts/],
+        ["empty", "2026-02-01T00:00:00Z", "2026-02-01T00:00:00Z", /ends before it starts/],
+        ["in the future", "2026-02-06T00:00:00Z", "2026-02-07T00:00:00Z", /lies in the future/],
+        ["before retention", "2025-11-01T00:00:00Z", "2025-11-02T00:00:00Z", /30-day/],
+    ])("refuses a %s window before any PromQL is sent", async (_label, from, to, message) => {
+        const instant = vi.fn(async () => []);
+        await expect(comparePeriods({ instant }, { ...base, periodBFrom: from, periodBTo: to })).rejects.toThrow(message);
+        expect(instant).not.toHaveBeenCalled();
+    });
+    it("rejects unparsable period timestamps before any PromQL is sent", async () => {
+        const instant = vi.fn(async () => []);
+        await expect(comparePeriods({ instant }, { ...base, periodAFrom: "last week" })).rejects.toThrow(/periodAFrom "last week" is not a parseable ISO datetime/);
+        expect(instant).not.toHaveBeenCalled();
+    });
+    it("sorts the optional activity comparison by activity id, then period", async () => {
+        const instant = vi.fn(async (q) => {
+            if (q.includes("camunda_activity_ended_total")) {
+                return [
+                    { metric: { activity_id: "B" }, value: 2 },
+                    { metric: { activity_id: "A" }, value: 4 },
+                ];
+            }
+            if (q.includes("camunda_activity_duration_milliseconds_sum")) {
+                return [{ metric: { activity_id: "A" }, value: 8_000 }];
+            }
+            if (q.includes("activity_id, le")) {
+                return [{ metric: { activity_id: "A" }, value: 3_000 }];
+            }
+            return [];
+        });
+        const res = await comparePeriods({ instant }, { ...base, includeActivityBreakdown: true });
+        expect(res.activityComparison.map((r) => [
+            r.activity_id,
+            r.period,
+            r.executions,
+            r.avg_sec,
+            r.p95_sec,
+        ])).toEqual([
+            ["A", "Period A", 4, 2, 3],
+            ["A", "Period B", 4, 2, 3],
+            // No duration series for B: unmeasured, not 0 s.
+            ["B", "Period A", 2, null, null],
+            ["B", "Period B", 2, null, null],
+        ]);
+    });
+});
+//# sourceMappingURL=performance.test.js.map

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

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

package/dist/queries/version-compare.d.ts

@@ -0,0 +1,41 @@
+import { type EngineFilterInput, type PrometheusClient } from "../prometheus.js";
+import { type CompareKpiDelta, type CompareKpis } from "./helpers.js";
+/** One version's KPIs. */
+export interface VersionCompareKpi extends CompareKpis {
+    version: number;
+    bucket: "versionA" | "versionB";
+}
+export type VersionCompareDelta = CompareKpiDelta;
+export interface VersionCompareResult {
+    /** The engine ids covered; `null` = every engine Prometheus holds (unscoped library call). */
+    engines: string[] | null;
+    processDefinitionKey: string;
+    versionA: number;
+    versionB: number;
+    windowDays: number;
+    minBucketSize: number;
+    suppressed: boolean;
+    kpis: VersionCompareKpi[];
+    delta: VersionCompareDelta;
+    /**
+     * When the figures were read from Prometheus (ISO timestamp): the "Stand"
+     * a view shows. Optional only for payloads recorded before it existed.
+     */
+    asOf?: string;
+}
+/**
+ * Side-by-side comparison of two deployed process definition versions, from
+ * the engine metrics. Versions are a metric label (`process_definition_version`)
+ * on the process-instance AND the incident series, so instance counts,
+ * completions, incidents and durations are an exact partition over a shared
+ * rolling window. The comparison is process-wide: there is no element scope.
+ */
+export declare function versionCompare(ch: PrometheusClient, params: {
+    processDefinitionKey: string;
+    versionA: number;
+    versionB: number;
+    windowDays: number;
+    minBucketSize: number;
+    engine?: EngineFilterInput;
+}): Promise<VersionCompareResult>;
+//# sourceMappingURL=version-compare.d.ts.map

package/dist/queries/version-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.d.ts","sourceRoot":"","sources":["../../src/queries/version-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAA;AAErB,0BAA0B;AAC1B,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;CAChC;AAED,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAA;AAEjD,MAAM,WAAW,oBAAoB;IACnC,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACxB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,iBAAiB,EAAE,CAAA;IACzB,KAAK,EAAE,mBAAmB,CAAA;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,gBAAgB,EACpB,MAAM,EAAE;IACN,oBAAoB,EAAE,MAAM,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B,GACA,OAAO,CAAC,oBAAoB,CAAC,CAyB/B"}

package/dist/queries/version-compare.js

@@ -0,0 +1,44 @@
+import { engineIdsOf, engineMatcher, escapeLabelValue, selector, } from "../prometheus.js";
+import { asOfNow, belowMinBucket, compareKpiDelta, queryCompareKpis, } from "./helpers.js";
+/**
+ * Side-by-side comparison of two deployed process definition versions, from
+ * the engine metrics. Versions are a metric label (`process_definition_version`)
+ * on the process-instance AND the incident series, so instance counts,
+ * completions, incidents and durations are an exact partition over a shared
+ * rolling window. The comparison is process-wide: there is no element scope.
+ */
+export async function versionCompare(ch, params) {
+    const minBucket = Math.max(1, Math.floor(params.minBucketSize));
+    const windowDays = Math.max(1, Math.floor(params.windowDays));
+    const versionA = Math.max(1, Math.floor(params.versionA));
+    const versionB = Math.max(1, Math.floor(params.versionB));
+    const range = `${windowDays}d`;
+    const asOf = asOfNow();
+    const [a, b] = await Promise.all([
+        versionKpi(ch, params, "versionA", versionA, range),
+        versionKpi(ch, params, "versionB", versionB, range),
+    ]);
+    return {
+        asOf,
+        engines: engineIdsOf(params.engine),
+        processDefinitionKey: params.processDefinitionKey,
+        versionA,
+        versionB,
+        windowDays,
+        minBucketSize: minBucket,
+        suppressed: belowMinBucket([a, b], minBucket),
+        kpis: [a, b],
+        delta: compareKpiDelta(a, b, { baseline: windowDays, other: windowDays }),
+    };
+}
+async function versionKpi(ch, params, bucket, version, range) {
+    const engine = engineMatcher(params.engine);
+    const key = `process_definition_key="${escapeLabelValue(params.processDefinitionKey)}"`;
+    const ver = `process_definition_version="${version}"`;
+    const kpis = await queryCompareKpis(ch, {
+        sel: selector(key, ver, engine),
+        completedSel: selector(key, ver, `state="COMPLETED"`, engine),
+    }, { range });
+    return { version, bucket, ...kpis };
+}
+//# sourceMappingURL=version-compare.js.map

package/dist/queries/version-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.js","sourceRoot":"","sources":["../../src/queries/version-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,QAAQ,GAGT,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,OAAO,EACP,cAAc,EACd,eAAe,EACf,gBAAgB,GAGjB,MAAM,cAAc,CAAA;AA4BrB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAoB,EACpB,MAOC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAA;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzD,MAAM,KAAK,GAAG,GAAG,UAAU,GAAG,CAAA;IAC9B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;IAEtB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/B,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC;QACnD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC;KACpD,CAAC,CAAA;IAEF,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;QACnC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,aAAa,EAAE,SAAS;QACxB,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACZ,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;KAC1E,CAAA;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,EAAoB,EACpB,MAAoE,EACpE,MAA+B,EAC/B,OAAe,EACf,KAAa;IAEb,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,GAAG,GAAG,2BAA2B,gBAAgB,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAA;IACvF,MAAM,GAAG,GAAG,+BAA+B,OAAO,GAAG,CAAA;IACrD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CACjC,EAAE,EACF;QACE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,CAAC;KAC9D,EACD,EAAE,KAAK,EAAE,CACV,CAAA;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAA;AACrC,CAAC"}

package/dist/queries/version-compare.test.d.ts

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

package/dist/queries/version-compare.test.d.ts.map

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

package/dist/queries/version-compare.test.js

@@ -0,0 +1,162 @@
+import { describe, expect, it, vi } from "vitest";
+import { versionCompare } from "./version-compare.js";
+import { increaseIn } from "./helpers.js";
+const v = (value) => ({ metric: {}, value });
+/** Mock Prometheus client with distinct canned KPIs per process_definition_version. */
+function mockClient(byVersion) {
+    const answer = (q) => {
+        const version = /process_definition_version="(\d+)"/.exec(q)?.[1] ?? "";
+        const kpi = byVersion[version];
+        if (!kpi)
+            return [];
+        if (q.includes("histogram_quantile"))
+            return [v(kpi.p95)];
+        if (q.includes("duration_milliseconds_sum"))
+            return [v(kpi.avg)];
+        if (q.includes("incident_created"))
+            return [v(kpi.incidents)];
+        if (q.includes('state="COMPLETED"'))
+            return [v(kpi.completed)];
+        return [v(kpi.started)];
+    };
+    const instant = vi.fn((q) => Promise.resolve(answer(q)));
+    const ch = { instant };
+    return { ch, instant, sent: () => instant.mock.calls.map((c) => c[0]) };
+}
+const base = {
+    processDefinitionKey: "order",
+    versionA: 1,
+    versionB: 2,
+    windowDays: 14,
+    minBucketSize: 10,
+};
+const versions = {
+    "1": { started: 99.6, completed: 80.4, incidents: 5, avg: 10_040, p95: 20_000 },
+    "2": { started: 50, completed: 40, incidents: 4, avg: 12_060, p95: 30_000 },
+};
+describe("versionCompare", () => {
+    it("partitions the process-instance and incident series by version", async () => {
+        const { ch, sent } = mockClient(versions);
+        await versionCompare(ch, { ...base, engine: "prod-a" });
+        const sel = (ver, extra = "") => `{process_definition_key="order",process_definition_version="${ver}"${extra},engine_id="prod-a"}`;
+        const w = { range: "14d" };
+        const count = (series) => increaseIn(series, w);
+        const duration = "camunda_process_instance_duration_milliseconds";
+        const queries = (ver) => [
+            `sum(${count(`camunda_process_instance_started_total${sel(ver)}`)})`,
+            `sum(${count(`camunda_process_instance_ended_total${sel(ver, ',state="COMPLETED"')}`)})`,
+            `sum(${count(`camunda_incident_created_total${sel(ver)}`)})`,
+            `sum(${count(`${duration}_sum${sel(ver)}`)}) / sum(${count(`${duration}_count${sel(ver)}`)})`,
+            `histogram_quantile(0.95, sum by (le)(${count(`${duration}_bucket${sel(ver)}`)}))`,
+        ];
+        expect(sent()).toEqual([...queries(1), ...queries(2)]);
+    });
+    it("reports instance, completion, incident and duration KPIs per version", async () => {
+        const { ch } = mockClient(versions);
+        const res = await versionCompare(ch, base);
+        expect(res.kpis).toEqual([
+            {
+                version: 1,
+                bucket: "versionA",
+                instance_count: 100,
+                completed_count: 80,
+                incident_count: 5,
+                incident_rate_pct: 5,
+                element_incident_count: null,
+                element_incident_rate_pct: null,
+                avg_duration_sec: 10,
+                p95_duration_sec: 20,
+            },
+            {
+                version: 2,
+                bucket: "versionB",
+                instance_count: 50,
+                completed_count: 40,
+                incident_count: 4,
+                incident_rate_pct: 8,
+                element_incident_count: null,
+                element_incident_rate_pct: null,
+                avg_duration_sec: 12.1,
+                p95_duration_sec: 30,
+            },
+        ]);
+        expect(res.delta).toEqual({
+            started_per_day_delta_pct: -50,
+            incident_rate_delta_pp: 3,
+            element_incident_rate_delta_pp: null,
+            avg_duration_delta_pct: 21,
+            p95_duration_delta_pct: 50,
+        });
+    });
+    it("echoes the request and has no element scope", async () => {
+        const { ch } = mockClient(versions);
+        const res = await versionCompare(ch, base);
+        expect(res).toMatchObject({
+            processDefinitionKey: "order",
+            versionA: 1,
+            versionB: 2,
+            windowDays: 14,
+            minBucketSize: 10,
+            suppressed: false,
+        });
+        expect(res).not.toHaveProperty("activityId");
+    });
+    it("returns null deltas on a zero baseline instead of dividing by zero", async () => {
+        const { ch } = mockClient({ "2": versions["2"] });
+        const res = await versionCompare(ch, { ...base, minBucketSize: 1 });
+        // No series for v1 at all: unmeasured, never a 0 s duration.
+        expect(res.kpis[0]).toMatchObject({ instance_count: 0, avg_duration_sec: null });
+        expect(res.delta.started_per_day_delta_pct).toBeNull();
+        expect(res.delta.avg_duration_delta_pct).toBeNull();
+        expect(res.delta.p95_duration_delta_pct).toBeNull();
+        expect(res.suppressed).toBe(true);
+    });
+    it.each([
+        [{ "1": 50, "2": 50 }, 50, false],
+        [{ "1": 49, "2": 50 }, 50, true],
+        [{ "1": 50, "2": 49 }, 50, true],
+    ])("suppresses below minBucketSize per version (%j, min %i)", async (counts, min, expected) => {
+        const canned = (started) => ({
+            started,
+            completed: started,
+            incidents: 0,
+            avg: 1,
+            p95: 1,
+        });
+        const { ch } = mockClient({ "1": canned(counts["1"]), "2": canned(counts["2"]) });
+        const res = await versionCompare(ch, { ...base, minBucketSize: min });
+        expect(res.suppressed).toBe(expected);
+    });
+    it("floors and clamps the numeric inputs to sane minimums", async () => {
+        const { ch, sent } = mockClient(versions);
+        const res = await versionCompare(ch, {
+            ...base,
+            versionA: 0,
+            versionB: 2.9,
+            windowDays: 0.5,
+            minBucketSize: 0,
+        });
+        expect(res).toMatchObject({ versionA: 1, versionB: 2, windowDays: 1, minBucketSize: 1 });
+        expect(res.kpis.map((k) => k.version)).toEqual([1, 2]);
+        expect(sent().every((q) => q.includes("[1d]"))).toBe(true);
+        const floored = await versionCompare(ch, { ...base, windowDays: 7.9, minBucketSize: 2.7 });
+        expect(floored).toMatchObject({ windowDays: 7, minBucketSize: 2 });
+    });
+    it("escapes the key and applies a multi-engine filter to every query", async () => {
+        const { ch, sent } = mockClient(versions);
+        await versionCompare(ch, {
+            ...base,
+            processDefinitionKey: 'my"key',
+            engine: ["prod-a", "prod-b"],
+        });
+        expect(sent()).toHaveLength(10);
+        expect(sent().every((q) => q.includes('process_definition_key="my\\"key"'))).toBe(true);
+        expect(sent().every((q) => q.includes('engine_id=~"prod-a|prod-b"'))).toBe(true);
+    });
+    it("aggregates across engines when no engine filter is given", async () => {
+        const { ch, sent } = mockClient(versions);
+        await versionCompare(ch, base);
+        expect(sent().some((q) => q.includes("engine_id"))).toBe(false);
+    });
+});
+//# sourceMappingURL=version-compare.test.js.map

package/dist/queries/version-compare.test.js.map

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

package/dist/queries/windows.d.ts

@@ -0,0 +1,40 @@
+export declare const DAY_SECONDS = 86400;
+/** Now, in epoch seconds — the upper bound of every window. */
+export declare const nowSeconds: () => number;
+/** An explicit time window after clamping, in epoch seconds. */
+export interface ClampedWindow {
+    from: number;
+    to: number;
+    /** Actual length after clamping — always > 0 ({@link clampWindow} refuses an empty window). */
+    seconds: number;
+    /** True when clamping cut the requested window short (it reached past now or retention). */
+    partial: boolean;
+}
+/**
+ * Holds `[from, to]` inside `[now − RETENTION_DAYS, now]`: Prometheus answers
+ * a future `@` with whatever exists so far and a pre-retention one with
+ * nothing, so an unclamped window silently reads a fraction of its span while
+ * being reported at full length. Refuses what no clamp can repair — a
+ * reversed or empty window, one entirely in the future or entirely before
+ * retention — with a message naming `name`.
+ */
+export declare function clampWindow(name: string, from: number, to: number, now?: number): ClampedWindow;
+/**
+ * A window counters are read over: a PromQL duration, optionally pinned to the
+ * instant it ends at (`@`). Without `at` it ends now.
+ */
+export interface CountWindow {
+    /** PromQL duration, e.g. `7d` or `86400s`. */
+    range: string;
+    /** Epoch seconds the window ends at; now when absent. */
+    at?: number;
+}
+/** The length of a single-unit PromQL duration (`7d`, `86400s`) in seconds. */
+export declare function rangeSeconds(range: string): number;
+/** The window reading exactly `w`: `<seconds>s` ending `@ <to>`. */
+export declare const windowAt: (w: Pick<ClampedWindow, "seconds" | "to">) => CountWindow;
+/** A window length in days, two decimals (a clamped window is rarely whole days). */
+export declare const daysOf: (seconds: number) => number;
+/** ISO timestamp of an epoch-second instant. */
+export declare const isoOf: (seconds: number) => string;
+//# sourceMappingURL=windows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../src/queries/windows.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,QAAS,CAAA;AAEjC,+DAA+D;AAC/D,eAAO,MAAM,UAAU,cAAsC,CAAA;AAE7D,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,MAAqB,GACzB,aAAa,CAqBf;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAUD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,oEAAoE;AACpE,eAAO,MAAM,QAAQ,GAAI,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC,KAAG,WAGlE,CAAA;AAEF,qFAAqF;AACrF,eAAO,MAAM,MAAM,GAAI,SAAS,MAAM,WAAoD,CAAA;AAE1F,gDAAgD;AAChD,eAAO,MAAM,KAAK,GAAI,SAAS,MAAM,WAA2C,CAAA"}