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

package/dist/promql-sources.test-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promql-sources.test-support.js","sourceRoot":"","sources":["../src/promql-sources.test-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,uFAAuF;AACvF,MAAM,YAAY,GAAG,iCAAiC,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,8EAA8E;QAC9E,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACxD,IAAI,CAAC,KAAK;YAAE,SAAQ;QACpB,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,KAAK,CAAA;QACjC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAClB,iFAAiF;QACjF,MAAM,YAAY,GAAa,EAAE,CAAA;QACjC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YACzB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,SAAQ;YAChC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM;gBAAE,MAAK;YACpE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAChC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC1B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;YACrC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;YACxB,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC9D,IAAI,KAAK,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAA;QAC3E,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAChD,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAW,CAAA;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAA;QACxE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC9D,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IACxD,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA;aAC9D,IAAI,GAAG,KAAK,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;aACnC,IAAI,GAAG,KAAK,OAAO;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,8FAA8F;AAC9F,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,EAAE,GAAG,sCAAsC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAClE,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAA;IAClB,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACvF,IAAI,EAAE,KAAK,cAAc,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,6EAA6E;IAC7E,+DAA+D;IAC/D,MAAM,WAAW,GAAG,IAAI,IAAI,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChF,IAAI,WAAW;QAAE,OAAO,CAAC,aAAa,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClF,MAAM,IAAI,KAAK,CAAC,0EAA0E,KAAK,EAAE,CAAC,CAAA;AACpG,CAAC"}

package/dist/promql-sources.test.d.ts

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

package/dist/promql-sources.test.d.ts.map

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

package/dist/promql-sources.test.js

@@ -0,0 +1,93 @@
+import { describe, expect, it } from "vitest";
+import { checkQueryLabels, contractCatalog } from "./promql-labels.test-support.js";
+import { alertExpressions, dashboardQueries } from "./promql-sources.test-support.js";
+/**
+ * The extractors feeding alert rules and Grafana dashboards into the label
+ * guard (`metrics-contract-labels.test.ts`). A shape they skip, or pass on
+ * still quoted, is a shape the guard never checks — these cases pin that each
+ * one is read or rejected, never silently dropped.
+ */
+const catalog = contractCatalog([
+    { promName: "backlog", type: "gauge", labels: ["engine_id"] },
+    { promName: "started_total", type: "counter", labels: ["engine_id", "state"] },
+]);
+describe("alertExpressions", () => {
+    it.each([
+        ["plain", "    expr: sum by (engine_id) (backlog) > 0"],
+        ["single-quoted", "    expr: 'sum by (engine_id) (backlog) > 0'"],
+        ["double-quoted", '    expr: "sum by (engine_id) (backlog) > 0"'],
+        ["a list item", "  - expr: sum by (engine_id) (backlog) > 0"],
+        ["a literal block", "    expr: |\n      sum by (engine_id) (backlog)\n\n        > 0"],
+        ["a folded block", "    expr: >-\n      sum by (engine_id)\n      (backlog) > 0"],
+        ["a plain multi-line scalar", "    expr: sum by (engine_id)\n      (backlog) > 0"],
+        ["a quoted multi-line scalar", "    expr: 'sum by (engine_id)\n      (backlog) > 0'"],
+    ])("reads %s expr as the PromQL it denotes", (_shape, yaml) => {
+        const [expr] = alertExpressions(`${yaml}\n    for: 5m\n`);
+        expect(expr.replace(/\s+/g, " ")).toBe("sum by (engine_id) (backlog) > 0");
+    });
+    it("unescapes quotes inside quoted scalars", () => {
+        expect(alertExpressions(`    expr: 'backlog{engine_id=''a''}'`)).toEqual([
+            "backlog{engine_id='a'}",
+        ]);
+        expect(alertExpressions(`    expr: "backlog{engine_id=\\"a\\"}"`)).toEqual([
+            'backlog{engine_id="a"}',
+        ]);
+    });
+    it("lets the checker see the labels of a quoted rule", () => {
+        // Left quoted, this parsed as one PromQL string literal: no violation,
+        // zero labels checked — the guard passed without looking.
+        const [expr] = alertExpressions(`    expr: 'sum by (foo) (backlog{bar="x"}) > 0'`);
+        const result = checkQueryLabels(expr, catalog);
+        expect(result.series).toEqual(["backlog"]);
+        expect(result.violations).toHaveLength(2);
+    });
+    it("stops each value at the next key and returns every rule", () => {
+        const yaml = [
+            "groups:",
+            "  - name: g",
+            "    rules:",
+            "      - alert: A",
+            "        expr: backlog > 1",
+            "        for: 5m",
+            "      - alert: B",
+            "        expr: |",
+            "          started_total > 2",
+            "        labels:",
+            "          severity: warning",
+        ].join("\n");
+        expect(alertExpressions(yaml)).toEqual(["backlog > 1", "started_total > 2"]);
+    });
+    it.each([
+        ["an unterminated single quote", "    expr: 'backlog > 0"],
+        ["a comment after the closing quote", "    expr: 'backlog > 0' # why"],
+        ["an escape outside the JSON subset", '    expr: "backlog \\e > 0"'],
+        ["an empty value", "    expr:\n    for: 5m"],
+    ])("throws on %s instead of passing it on", (_shape, yaml) => {
+        expect(() => alertExpressions(yaml)).toThrow(/alerts\.yml/);
+    });
+});
+describe("dashboardQueries", () => {
+    it("collects panel exprs from any depth", () => {
+        const dashboard = { panels: [{ targets: [{ expr: "backlog" }, { expr: "started_total" }] }] };
+        expect(dashboardQueries(dashboard)).toEqual(["backlog", "started_total"]);
+    });
+    it.each([
+        ["label_values(started_total, engine_id)", "count by (engine_id)(started_total)"],
+        [
+            'label_values(started_total{engine_id=~"$engine",state="COMPLETED"}, engine_id)',
+            'count by (engine_id)(started_total{engine_id=~"$engine",state="COMPLETED"})',
+        ],
+        ["query_result(sum by (engine_id) (backlog))", "sum by (engine_id) (backlog)"],
+    ])("rewrites the templating query %s", (query, promql) => {
+        // Both the plain string and the newer `{ query: { query } }` object form.
+        expect(dashboardQueries({ templating: { list: [{ query }] } })).toEqual([promql]);
+        expect(dashboardQueries({ templating: { list: [{ query: { query } }] } })).toEqual([promql]);
+    });
+    it("ignores templating queries that name no label", () => {
+        expect(dashboardQueries({ list: [{ query: "a,b,c" }, { query: "label_names()" }] })).toEqual([]);
+    });
+    it.each(["label_values(engine_id)", "label_values(started_total, )", "query_result()"])("throws on the unreadable templating query %s instead of skipping it", (query) => {
+        expect(() => dashboardQueries({ query })).toThrow(/unsupported Grafana templating query/);
+    });
+});
+//# sourceMappingURL=promql-sources.test.js.map

package/dist/promql-sources.test.js.map

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

package/dist/queries/as-of.test.d.ts

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

package/dist/queries/as-of.test.d.ts.map

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

package/dist/queries/as-of.test.js

@@ -0,0 +1,80 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { clusterCompare } from "./cluster-compare.js";
+import { dashboardData, failureDashboardData } from "./dashboard.js";
+import { elementHeat } from "./element.js";
+import { engineCompare } from "./engine-compare.js";
+import { engineLandscape } from "./engine-landscape.js";
+import { versionCompare } from "./version-compare.js";
+/**
+ * U7: every view result says when its figures were read (`asOf`, the "Stand"
+ * a widget shows next to the period and the engine set), and the dashboard
+ * names the engines in scope that report metrics, so a view can say how many
+ * of them send none. Neither is a guess: `asOf` is the evaluation time of the
+ * instant queries, `reportingEngines` the presence probe's answer.
+ */
+const NOW = "2026-10-10T12:32:00.000Z";
+beforeEach(() => {
+    vi.useFakeTimers({ toFake: ["Date"] });
+    vi.setSystemTime(new Date(NOW));
+});
+afterEach(() => vi.useRealTimers());
+/** A client that answers the engine presence probe for `reporting` and nothing else. */
+function client(reporting = []) {
+    return {
+        instant: vi.fn((q) => Promise.resolve(q.includes("camunda_jobs_executable")
+            ? reporting.map((engine_id) => ({ metric: { engine_id }, value: 1 }))
+            : [])),
+    };
+}
+describe("asOf — when the figures were read", () => {
+    it("stamps every view result with the query time", async () => {
+        const results = await Promise.all([
+            dashboardData(client(), { period: "7d" }),
+            failureDashboardData(client(), {}),
+            versionCompare(client(), {
+                processDefinitionKey: "order",
+                versionA: 1,
+                versionB: 2,
+                windowDays: 14,
+                minBucketSize: 10,
+            }),
+            engineCompare(client(), {
+                processDefinitionKey: "order",
+                engineA: "prod-a",
+                engineB: "prod-b",
+                windowDays: 14,
+                minBucketSize: 10,
+            }),
+            engineLandscape(client(), { engine: ["prod-a"] }),
+            elementHeat(client(), { processDefinitionKey: "order", period: "7d" }),
+        ]);
+        for (const result of results)
+            expect(result.asOf).toBe(NOW);
+    });
+    it("stamps a deployment comparison with the `now` its windows were clamped to", async () => {
+        const res = await clusterCompare(client(), {
+            deploymentTimestamp: "2026-10-08T12:00:00Z",
+            windowBeforeDays: 7,
+            windowAfterDays: 7,
+            minBucketSize: 10,
+        });
+        expect(res.asOf).toBe(NOW);
+        // The post-deployment window ends at that same `now`.
+        expect(res.partial).toBe(true);
+    });
+});
+describe("reportingEngines — which engines in scope send metrics", () => {
+    it("lists the engines the presence probe answered for, ascending and once each", async () => {
+        const res = await dashboardData(client(["prod-c", "prod-a", "prod-c"]), {
+            period: "7d",
+            engine: ["prod-a", "prod-b", "prod-c"],
+        });
+        expect(res.reportingEngines).toEqual(["prod-a", "prod-c"]);
+    });
+    it("is empty when no engine in scope reports, and skips a series without an engine id", async () => {
+        const instant = vi.fn((q) => Promise.resolve(q.includes("camunda_jobs_executable") ? [{ metric: {}, value: 1 }] : []));
+        expect((await dashboardData({ instant }, { period: "7d" })).reportingEngines).toEqual([]);
+        expect((await dashboardData(client(), { period: "7d" })).reportingEngines).toEqual([]);
+    });
+});
+//# sourceMappingURL=as-of.test.js.map

package/dist/queries/as-of.test.js.map

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

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

@@ -0,0 +1,62 @@
+import { type EngineFilterInput, type PrometheusClient } from "../prometheus.js";
+import { type CompareKpiDelta, type CompareKpis } from "./helpers.js";
+export interface ClusterCompareKpi extends CompareKpis {
+    period: "before" | "after";
+    window_from: string;
+    window_to: string;
+    /** The window's ACTUAL length in days, after clamping to now and retention. */
+    window_days: number;
+}
+export type ClusterCompareDelta = CompareKpiDelta;
+export interface ClusterCompareResult {
+    /** The engine ids covered; `null` = every engine Prometheus holds (unscoped library call). */
+    engines: string[] | null;
+    processDefinitionKey: string | null;
+    activityId: string | null;
+    deploymentTimestamp: string;
+    /** The window lengths asked for, in whole days (the tool inputs). */
+    requestedWindowDays: {
+        before: number;
+        after: number;
+    };
+    /** The ACTUAL window lengths in days — what was measured, not what was asked for. */
+    windowDays: {
+        before: number;
+        after: number;
+    };
+    /**
+     * True when a window is shorter than requested: the post-deploy window
+     * reaches past now (a recent deployment) or the baseline past retention.
+     */
+    partial: boolean;
+    minBucketSize: number;
+    suppressed: boolean;
+    kpis: ClusterCompareKpi[];
+    delta: ClusterCompareDelta;
+    /**
+     * When the figures were read from Prometheus (ISO timestamp): the "Stand"
+     * a view shows. Optional only for payloads recorded before it existed.
+     */
+    asOf?: string;
+}
+/**
+ * Pre/Post deployment comparison from OTEL metrics. Each window is queried with
+ * the PromQL `@ <end>` modifier so the before/after split is exact, and both
+ * windows are clamped to `[now − retention, now]`: right after a deployment the
+ * post-deploy window holds only the elapsed hours, and is reported as exactly
+ * that (`window_days`, `partial`) rather than as the requested span. Instance
+ * counts are compared PER DAY, so windows of different length compare fairly.
+ *
+ * `incident_count`/`incident_rate_pct` cover every activity; with `activityId`
+ * the `element_incident_*` fields add the count at that element.
+ */
+export declare function clusterCompare(ch: PrometheusClient, params: {
+    processDefinitionKey?: string;
+    activityId?: string;
+    deploymentTimestamp: string;
+    windowBeforeDays: number;
+    windowAfterDays: number;
+    minBucketSize: number;
+    engine?: EngineFilterInput;
+}): Promise<ClusterCompareResult>;
+//# sourceMappingURL=cluster-compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-compare.d.ts","sourceRoot":"","sources":["../../src/queries/cluster-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;AAWrB,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAA;CACpB;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,GAAG,IAAI,CAAA;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qEAAqE;IACrE,mBAAmB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACtD,qFAAqF;IACrF,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,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;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,gBAAgB,EACpB,MAAM,EAAE;IACN,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B,GACA,OAAO,CAAC,oBAAoB,CAAC,CAiD/B"}

package/dist/queries/cluster-compare.js

@@ -0,0 +1,70 @@
+import { engineIdsOf, engineMatcher, escapeLabelValue, selector, } from "../prometheus.js";
+import { belowMinBucket, compareKpiDelta, parseIsoSeconds, queryCompareKpis, } from "./helpers.js";
+import { DAY_SECONDS, clampWindow, daysOf, isoOf, nowSeconds, windowAt, } from "./windows.js";
+/**
+ * Pre/Post deployment comparison from OTEL metrics. Each window is queried with
+ * the PromQL `@ <end>` modifier so the before/after split is exact, and both
+ * windows are clamped to `[now − retention, now]`: right after a deployment the
+ * post-deploy window holds only the elapsed hours, and is reported as exactly
+ * that (`window_days`, `partial`) rather than as the requested span. Instance
+ * counts are compared PER DAY, so windows of different length compare fairly.
+ *
+ * `incident_count`/`incident_rate_pct` cover every activity; with `activityId`
+ * the `element_incident_*` fields add the count at that element.
+ */
+export async function clusterCompare(ch, params) {
+    const minBucket = Math.max(1, Math.floor(params.minBucketSize));
+    const before = Math.max(1, Math.floor(params.windowBeforeDays));
+    const after = Math.max(1, Math.floor(params.windowAfterDays));
+    const deployTs = parseIsoSeconds(params.deploymentTimestamp, "deploymentTimestamp");
+    const now = nowSeconds();
+    if (deployTs >= now) {
+        throw new Error("deploymentTimestamp lies in the future (or is now) — there is no post-deployment window to compare yet");
+    }
+    const beforeWin = clampWindow("the pre-deployment window", deployTs - before * DAY_SECONDS, deployTs, now);
+    const afterWin = clampWindow("the post-deployment window", deployTs, deployTs + after * DAY_SECONDS, now);
+    const [b, a] = await Promise.all([
+        windowKpi(ch, params, "before", beforeWin),
+        windowKpi(ch, params, "after", afterWin),
+    ]);
+    return {
+        engines: engineIdsOf(params.engine),
+        processDefinitionKey: params.processDefinitionKey ?? null,
+        activityId: params.activityId ?? null,
+        deploymentTimestamp: params.deploymentTimestamp,
+        requestedWindowDays: { before, after },
+        windowDays: { before: b.window_days, after: a.window_days },
+        partial: beforeWin.partial || afterWin.partial,
+        minBucketSize: minBucket,
+        suppressed: belowMinBucket([b, a], minBucket),
+        kpis: [b, a],
+        // The windows were clamped to this `now`: the figures are as of it.
+        asOf: new Date(now * 1000).toISOString(),
+        // Exact lengths, not the rounded `window_days`: a 2 h window is 0.083 d.
+        delta: compareKpiDelta(b, a, {
+            baseline: beforeWin.seconds / DAY_SECONDS,
+            other: afterWin.seconds / DAY_SECONDS,
+        }),
+    };
+}
+async function windowKpi(ch, params, period, win) {
+    const engine = engineMatcher(params.engine);
+    const keyMatcher = params.processDefinitionKey
+        ? `process_definition_key="${escapeLabelValue(params.processDefinitionKey)}"`
+        : undefined;
+    const kpis = await queryCompareKpis(ch, {
+        sel: selector(keyMatcher, engine),
+        completedSel: selector(keyMatcher, `state="COMPLETED"`, engine),
+        elementIncidentSel: params.activityId
+            ? selector(keyMatcher, `activity_id="${escapeLabelValue(params.activityId)}"`, engine)
+            : undefined,
+    }, windowAt(win));
+    return {
+        period,
+        ...kpis,
+        window_from: isoOf(win.from),
+        window_to: isoOf(win.to),
+        window_days: daysOf(win.seconds),
+    };
+}
+//# sourceMappingURL=cluster-compare.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,81 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { clusterCompare } from "./cluster-compare.js";
+import { clusterCompareInput } from "../schemas/cluster-compare.js";
+const NOW = "2026-03-20T12:00:00.000Z";
+const NOW_SEC = Date.parse(NOW) / 1000;
+const DAY = 86_400;
+const DEPLOY = "2026-03-10T12:00:00.000Z";
+const DEPLOY_SEC = Date.parse(DEPLOY) / 1000;
+beforeEach(() => {
+    vi.useFakeTimers({ toFake: ["Date"], now: Date.parse(NOW) });
+});
+afterEach(() => {
+    vi.useRealTimers();
+});
+const constant = (value) => vi.fn(async () => [{ metric: {}, value }]);
+const base = { windowBeforeDays: 7, windowAfterDays: 7, minBucketSize: 10 };
+describe("clusterCompare", () => {
+    it("anchors both windows at exact epoch seconds via the @ modifier", async () => {
+        const instant = constant(20);
+        const res = await clusterCompare({ instant }, { ...base, deploymentTimestamp: DEPLOY });
+        const queries = instant.mock.calls.map((c) => c[0]);
+        expect(queries.some((q) => q.includes(`[${7 * DAY}s] @ ${DEPLOY_SEC}`))).toBe(true);
+        expect(queries.some((q) => q.includes(`[${7 * DAY}s] @ ${DEPLOY_SEC + 7 * DAY}`))).toBe(true);
+        expect(queries.every((q) => !q.includes("NaN"))).toBe(true);
+        expect(res.kpis[0].window_to).toBe(DEPLOY);
+        expect(res.kpis[1].window_from).toBe(DEPLOY);
+        expect(res).toMatchObject({ windowDays: { before: 7, after: 7 }, partial: false });
+    });
+    it("clamps the post-deploy window to now and reports what was measured (N79)", async () => {
+        // Deployed 2 h ago: a "+7d" window would reach 7 days into the future and
+        // compare 2 h of data against 7 full days.
+        const deployedSec = NOW_SEC - 2 * 3600;
+        const instant = constant(20);
+        const res = await clusterCompare({ instant }, { ...base, deploymentTimestamp: new Date(deployedSec * 1000).toISOString() });
+        const queries = instant.mock.calls.map((c) => c[0]);
+        expect(queries.some((q) => q.includes(`[${2 * 3600}s] @ ${NOW_SEC}`))).toBe(true);
+        expect(queries.every((q) => !/@ (\d+)/.test(q) || Number(/@ (\d+)/.exec(q)[1]) <= NOW_SEC)).toBe(true);
+        expect(res.kpis[1].window_to).toBe(NOW);
+        expect(res.windowDays).toEqual({ before: 7, after: 0.08 });
+        expect(res.partial).toBe(true);
+        // 20 starts in 2 h vs 20 in 7 d: per day that is a massive rise, not "+0 %".
+        expect(res.delta.started_per_day_delta_pct).toBeGreaterThan(8000);
+    });
+    it("clamps the baseline to the retention", async () => {
+        const instant = constant(20);
+        const res = await clusterCompare({ instant }, { ...base, windowBeforeDays: 14, deploymentTimestamp: "2026-02-25T12:00:00.000Z" });
+        // now − 30 d = 2026-02-18T12:00Z: the 14-day baseline keeps only 7 days.
+        expect(res.kpis[0].window_from).toBe("2026-02-18T12:00:00.000Z");
+        expect(res.windowDays.before).toBe(7);
+        expect(res.partial).toBe(true);
+    });
+    it.each([
+        ["in the future", "2026-03-21T12:00:00.000Z", /lies in the future/],
+        ["exactly now", NOW, /lies in the future \(or is now\)/],
+        ["before the retention", "2026-01-01T00:00:00.000Z", /before the 30-day Prometheus retention/],
+    ])("refuses a deployment %s before any PromQL is sent", async (_label, ts, message) => {
+        const instant = vi.fn(async () => []);
+        await expect(clusterCompare({ instant }, { ...base, deploymentTimestamp: ts })).rejects.toThrow(message);
+        expect(instant).not.toHaveBeenCalled();
+    });
+    it("rejects an unparsable deploymentTimestamp before any PromQL is sent", async () => {
+        const instant = vi.fn(async () => []);
+        await expect(clusterCompare({ instant }, { ...base, deploymentTimestamp: "last week" })).rejects.toThrow(/deploymentTimestamp "last week" is not a parseable ISO datetime/);
+        expect(instant).not.toHaveBeenCalled();
+    });
+});
+describe("clusterCompareInput", () => {
+    it("accepts ISO datetimes including the engine's local-offset format", () => {
+        expect(clusterCompareInput.safeParse({ deploymentTimestamp: DEPLOY }).success).toBe(true);
+        expect(clusterCompareInput.safeParse({ deploymentTimestamp: "2026-03-10T14:00:00.000+0200" })
+            .success).toBe(true);
+    });
+    it("rejects non-datetime strings at the tool boundary", () => {
+        const res = clusterCompareInput.safeParse({ deploymentTimestamp: "last week" });
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues[0].message).toMatch(/parseable ISO datetime/);
+        }
+    });
+});
+//# sourceMappingURL=cluster-compare.test.js.map

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

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

package/dist/queries/dashboard.d.ts

@@ -0,0 +1,60 @@
+import { type EngineFilterInput, type Period, type PrometheusClient } from "../prometheus.js";
+import type { AnalyticsDashboardData, FailureDashboardData } from "../widgets.js";
+/**
+ * How many (process, activity) rows the activity breakdown carries: the top
+ * ones by total time. The result says how many there were in all
+ * (`activityCount`), so a view calls the list what it is ("Top 20 by total
+ * time") instead of showing an unexplained count.
+ */
+export declare const ACTIVITY_BREAKDOWN_LIMIT = 20;
+/**
+ * Aggregated dashboard KPIs + activity / definition breakdowns, from the
+ * engine's process metrics. Shared by the dashboard pipeline step and the
+ * `analytics_show_dashboard` widget tool. Two kinds of figures, never mixed:
+ *
+ * - FLOWS within the window (`period`): starts, completions, incidents created
+ *   and resolved, and the durations of the instances that ended — counted over
+ *   the range with {@link increaseIn}. Durations are null when nothing ended; `incidentRatePct` is null
+ *   when nothing started.
+ * - LIVE STATE right now: `runningNow` / `openIncidentsNow` from the state
+ *   gauges (`camunda_process_instances_running`, `camunda_incidents_open`) —
+ *   the same numbers the failure dashboard, engine health and the landscape
+ *   read, independent of the window. A counter difference within the window
+ *   is no substitute: it misses every instance started before the window.
+ *   The gauges have rows only for what exists, so whether a missing series is
+ *   0 or "not reported" (null) is decided by the engine presence probe
+ *   ({@link reportingEnginesQuery}): null only while no engine in scope reports.
+ *
+ * The activity breakdown groups by (process, activity): BPMN ids are only
+ * unique within one model, so `StartEvent_1` of two processes are two rows.
+ * The result echoes its scope (process key, period, engines).
+ *
+ * `previous` holds the starts and incidents of the window right before the
+ * period: the reference an incident rate is judged against (a rate on its
+ * own says nothing about whether it is high). It is null when that window
+ * lies wholly before the Prometheus retention (a 30-day period), and
+ * `suppressed` when either window started fewer than `minBucketSize`
+ * instances: a change of a rate over a handful of starts is noise.
+ */
+export declare function dashboardData(ch: PrometheusClient, params: {
+    processDefinitionKey?: string;
+    period: Period;
+    engine?: EngineFilterInput;
+    /** The floor per window for judging the rate's change (the caller's saved `minBucketSize`); default 10. */
+    minBucketSize?: number;
+}): Promise<AnalyticsDashboardData>;
+/**
+ * Current failure / incident state, from the live state gauges
+ * (`camunda_incidents_open`, `camunda_jobs_failed`, `camunda_process_instances_running`).
+ *
+ * Point-in-time ("what is failing now"), so it is robust regardless of how the
+ * data arrived — unlike a rate window over `incident_created`, which reads zero
+ * on backdated/bulk-imported history. Per process: instances running now, dead
+ * jobs, open incidents and open incidents per 100 running instances. Groups
+ * are (process, incident type) — the gauge carries no message, activity id,
+ * timestamps or instance ids, so the rows carry none either.
+ */
+export declare function failureDashboardData(ch: PrometheusClient, params: {
+    engine?: EngineFilterInput;
+}): Promise<FailureDashboardData>;
+//# sourceMappingURL=dashboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/queries/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,MAAM,EACX,KAAK,gBAAgB,EAEtB,MAAM,kBAAkB,CAAA;AAezB,OAAO,KAAK,EAEV,sBAAsB,EAGtB,oBAAoB,EAGrB,MAAM,eAAe,CAAA;AAEtB;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAY1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,gBAAgB,EACpB,MAAM,EAAE;IACN,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GACA,OAAO,CAAC,sBAAsB,CAAC,CAyHjC;AAkID;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,gBAAgB,EACpB,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACrC,OAAO,CAAC,oBAAoB,CAAC,CAuD/B"}