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

package/dist/queries/windows.js

@@ -0,0 +1,56 @@
+import { RETENTION_DAYS } from "../prometheus.js";
+export const DAY_SECONDS = 86_400;
+/** Now, in epoch seconds — the upper bound of every window. */
+export const nowSeconds = () => Math.floor(Date.now() / 1000);
+/**
+ * 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 function clampWindow(name, from, to, now = nowSeconds()) {
+    if (to <= from) {
+        throw new Error(`${name}: the window ends before it starts — swap from and to`);
+    }
+    const oldest = now - RETENTION_DAYS * DAY_SECONDS;
+    if (from >= now) {
+        throw new Error(`${name}: the window lies in the future — no metrics exist for it yet`);
+    }
+    if (to <= oldest) {
+        throw new Error(`${name}: the window lies before the ${RETENTION_DAYS}-day Prometheus retention — its metrics are gone`);
+    }
+    const clampedFrom = Math.max(from, oldest);
+    const clampedTo = Math.min(to, now);
+    return {
+        from: clampedFrom,
+        to: clampedTo,
+        seconds: clampedTo - clampedFrom,
+        partial: clampedFrom !== from || clampedTo !== to,
+    };
+}
+const UNIT_SECONDS = {
+    s: 1,
+    m: 60,
+    h: 3600,
+    d: DAY_SECONDS,
+    w: 7 * DAY_SECONDS,
+};
+/** The length of a single-unit PromQL duration (`7d`, `86400s`) in seconds. */
+export function rangeSeconds(range) {
+    const match = /^(\d+)([smhdw])$/.exec(range);
+    if (!match)
+        throw new Error(`"${range}" is not a single-unit PromQL duration such as 7d or 86400s`);
+    return Number(match[1]) * UNIT_SECONDS[match[2]];
+}
+/** The window reading exactly `w`: `<seconds>s` ending `@ <to>`. */
+export const windowAt = (w) => ({
+    range: `${w.seconds}s`,
+    at: w.to,
+});
+/** A window length in days, two decimals (a clamped window is rarely whole days). */
+export const daysOf = (seconds) => Math.round((seconds / DAY_SECONDS) * 100) / 100;
+/** ISO timestamp of an epoch-second instant. */
+export const isoOf = (seconds) => new Date(seconds * 1000).toISOString();
+//# sourceMappingURL=windows.js.map

package/dist/queries/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","sourceRoot":"","sources":["../../src/queries/windows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAA;AAEjC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;AAY7D;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,IAAY,EACZ,EAAU,EACV,MAAc,UAAU,EAAE;IAE1B,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uDAAuD,CAAC,CAAA;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,GAAG,cAAc,GAAG,WAAW,CAAA;IACjD,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,+DAA+D,CAAC,CAAA;IACzF,CAAC;IACD,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,gCAAgC,cAAc,kDAAkD,CACxG,CAAA;IACH,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IACnC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,SAAS,GAAG,WAAW;QAChC,OAAO,EAAE,WAAW,KAAK,IAAI,IAAI,SAAS,KAAK,EAAE;KAClD,CAAA;AACH,CAAC;AAaD,MAAM,YAAY,GAAqC;IACrD,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,CAAC,GAAG,WAAW;CACnB,CAAA;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5C,IAAI,CAAC,KAAK;QACR,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,6DAA6D,CAAC,CAAA;IACzF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAwC,EAAe,EAAE,CAAC,CAAC;IAClF,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,GAAG;IACtB,EAAE,EAAE,CAAC,CAAC,EAAE;CACT,CAAC,CAAA;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;AAE1F,gDAAgD;AAChD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA"}

package/dist/query-honesty.test.d.ts

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

package/dist/query-honesty.test.d.ts.map

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

package/dist/query-honesty.test.js

@@ -0,0 +1,294 @@
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
+import { RETENTION_DAYS } from "./prometheus.js";
+import * as queries from "./queries/index.js";
+import { SCENARIOS, exportedQueryFunctions, recordingClient, } from "./query-scenarios.test-support.js";
+/**
+ * Behavioural honesty guard (#336) over EVERY exported query function, on the
+ * shared scenarios (`query-scenarios.test-support.ts`):
+ *
+ * 1. Time windows — every range a PromQL reads lies inside
+ *    `[now − retention, now]`: no `@` anchor in the future, no window
+ *    reaching past the retention Prometheus still holds.
+ * 2. No data — against a Prometheus that holds nothing, each function says
+ *    "unknown"/"not measured" (null, `unknown`, empty) instead of a plausible
+ *    healthy 0: no 0 s duration, no 0 % rate, no `healthy` verdict.
+ * 3. Scope — every aggregate that takes an engine filter names the engines
+ *    it covers, so a fleet figure never reads as one engine's.
+ * 4. No placeholders — with every label present, no result carries an empty
+ *    string a query could never fill.
+ */
+const NOW = Date.parse("2026-10-09T12:00:00Z");
+const NOW_SECONDS = NOW / 1000;
+const RETENTION_SECONDS = RETENTION_DAYS * 86_400;
+beforeAll(() => {
+    vi.useFakeTimers({ toFake: ["Date"], now: NOW });
+});
+afterAll(() => {
+    vi.useRealTimers();
+});
+const UNIT_SECONDS = { s: 1, m: 60, h: 3600, d: 86_400, w: 604_800 };
+/** Every `[<n><unit>]` range of a PromQL string, with its `@ <t>` anchor (else now). */
+function windowsOf(promql) {
+    return [...promql.matchAll(/\[(\d+)([smhdw])\](?:\s*@\s*(\d+))?/g)].map((m) => {
+        const to = m[3] === undefined ? NOW_SECONDS : Number(m[3]);
+        return { from: to - Number(m[1]) * UNIT_SECONDS[m[2]], to, text: m[0] };
+    });
+}
+describe("query honesty — time windows", () => {
+    it.each(Object.entries(SCENARIOS))("%s reads only windows inside [now − retention, now]", async (_name, scenarios) => {
+        const outside = [];
+        for (const run of scenarios) {
+            const { ch, sent } = recordingClient();
+            await run(ch);
+            for (const promql of sent) {
+                for (const w of windowsOf(promql)) {
+                    if (w.to > NOW_SECONDS)
+                        outside.push(`future anchor ${w.text}: ${promql}`);
+                    if (w.from < NOW_SECONDS - RETENTION_SECONDS) {
+                        outside.push(`past retention ${w.text}: ${promql}`);
+                    }
+                    if (w.to <= w.from)
+                        outside.push(`empty window ${w.text}: ${promql}`);
+                }
+            }
+        }
+        expect(outside).toEqual([]);
+    });
+});
+/**
+ * What each function must say when Prometheus holds no data at all — a total
+ * map over the `queries` namespace, so a new export has to state its no-data
+ * shape (`pnpm typecheck`).
+ */
+const NO_DATA = {
+    analyzePerformance: (r) => {
+        expect(r.kpi).toBeNull();
+        expect(r.activityBreakdown).toEqual([]);
+    },
+    comparePeriods: (r) => {
+        for (const k of r.kpiComparison) {
+            expect(k).toMatchObject({
+                total_instances: 0,
+                incident_rate_pct: null,
+                avg_duration_sec: null,
+                median_sec: null,
+                p95_sec: null,
+            });
+        }
+    },
+    findFailedInstances: (r) => expect(r.patterns).toEqual([]),
+    elementBottleneck: (r) => expect(r.activities).toEqual([]),
+    elementHeat: (r) => expect({ frequency: r.frequency, durationSec: r.durationSec }).toEqual({
+        frequency: {},
+        durationSec: {},
+    }),
+    clusterCompare: (r) => {
+        expect(r.suppressed).toBe(true);
+        expectUnmeasuredCompare(r.kpis, r.delta);
+    },
+    versionCompare: (r) => {
+        expect(r.suppressed).toBe(true);
+        expectUnmeasuredCompare(r.kpis, r.delta);
+    },
+    engineCompare: (r) => {
+        expect(r.suppressed).toBe(true);
+        expectUnmeasuredCompare(r.kpis, r.delta);
+    },
+    engineLandscape: (r) => {
+        expect(r.engines.every((e) => !e.reporting)).toBe(true);
+        // A silent engine's counts are unknown, never a row of plausible zeros.
+        for (const e of r.engines) {
+            expect(e).toMatchObject({ runningInstances: null, openIncidents: null, executableJobs: null });
+        }
+        expect(r.totals).toMatchObject({
+            reportingEngineCount: 0,
+            runningInstances: null,
+            openIncidents: null,
+            failedJobs: null,
+        });
+    },
+    dashboardData: (r) => {
+        expect(r).toMatchObject({
+            totalCount: 0,
+            incidentRatePct: null,
+            avgDurationMs: null,
+            medianDurationMs: null,
+            p95DurationMs: null,
+            // No engine in scope reports: the live gauges are "not reported", never 0 running.
+            runningNow: null,
+            openIncidentsNow: null,
+            activityBreakdown: [],
+            activityCount: 0,
+            definitionBreakdown: [],
+        });
+        // Nothing started before either: no rate to judge against, and no verdict.
+        expect(r.previous).toMatchObject({ totalCount: 0, incidentRatePct: null, suppressed: true });
+    },
+    failureDashboardData: (r) => {
+        expect(r).toMatchObject({ totalIncidents: 0, mostAffectedProcess: null, errorPatterns: [] });
+    },
+    engineHealth: (r) => {
+        // Silence is not health.
+        expect(r.status).toBe("unknown");
+        expect(r.reportingEngines).toEqual([]);
+        expect(r.silentEngines).toEqual(r.engines ?? []);
+    },
+};
+function expectUnmeasuredCompare(kpis, delta) {
+    for (const k of kpis) {
+        // "Nothing ended" is no 0 s duration, "nothing started" no 0 % rate.
+        expect(k.avg_duration_sec).toBeNull();
+        expect(k.p95_duration_sec).toBeNull();
+        expect(k.incident_rate_pct).toBeNull();
+    }
+    // …so no delta against them either — never a −100 % from a missing value.
+    expect(Object.values(delta).every((v) => v === null)).toBe(true);
+}
+describe("query honesty — a Prometheus without data", () => {
+    it("states a no-data shape for every exported query function", () => {
+        expect(Object.keys(NO_DATA).sort()).toEqual(exportedQueryFunctions().sort());
+    });
+    it.each(Object.entries(SCENARIOS))("%s reports unknown / not measured, never a healthy zero", async (name, scenarios) => {
+        const expectNoData = NO_DATA[name];
+        for (const run of scenarios) {
+            const { ch } = recordingClient(() => []);
+            expectNoData(await run(ch));
+        }
+    });
+});
+/**
+ * The commonest live state — an engine that reports, with nothing open. The
+ * metrics plugin registers per-key gauge rows only for what exists, so with
+ * no incident open `camunda_incidents_open` has NO series at all while the
+ * engine's own presence gauges still answer. Every surface reading that state
+ * must say the same measured 0, never "not measured".
+ */
+describe("query honesty — a reporting engine with nothing open", () => {
+    it("dashboard, failure dashboard, engine health and landscape agree on 0", async () => {
+        const { ch } = recordingClient((q) => q.includes("camunda_jobs_executable") || q.includes("camunda_external_tasks_open")
+            ? [{ metric: { engine_id: "prod-a" }, value: 0 }]
+            : []);
+        const engine = "prod-a";
+        const [dashboard, failures, health, landscape] = await Promise.all([
+            queries.dashboardData(ch, { period: "7d", engine }),
+            queries.failureDashboardData(ch, { engine }),
+            queries.engineHealth(ch, { engine }),
+            queries.engineLandscape(ch, { engine }),
+        ]);
+        expect(health.status).toBe("healthy");
+        expect({
+            dashboard: dashboard.openIncidentsNow,
+            failureDashboard: failures.totalIncidents,
+            engineHealth: health.openIncidents,
+            landscape: landscape.engines.find((e) => e.engineId === engine)?.openIncidents,
+        }).toEqual({ dashboard: 0, failureDashboard: 0, engineHealth: 0, landscape: 0 });
+        expect({ dashboard: dashboard.runningNow, engineHealth: health.runningInstances }).toEqual({
+            dashboard: 0,
+            engineHealth: 0,
+        });
+    });
+});
+const FLEET = ["prod-a", "prod-b"];
+/**
+ * How each function states WHICH engines its numbers cover — a total map, so a
+ * new export has to decide. With `engine` omitted a figure is a fleet
+ * aggregate; unless the result names the engines, nobody reading it can tell
+ * one engine from the whole fleet.
+ */
+const SCOPE_ECHO = {
+    analyzePerformance: {
+        echo: (ch, engine) => queries.analyzePerformance(ch, {
+            processDefinitionKey: "invoice",
+            period: "7d",
+            includeActivityBreakdown: false,
+            engine,
+        }),
+    },
+    comparePeriods: {
+        echo: (ch, engine) => queries.comparePeriods(ch, {
+            processDefinitionKey: "invoice",
+            periodAFrom: "2026-10-01T00:00:00Z",
+            periodATo: "2026-10-02T00:00:00Z",
+            periodBFrom: "2026-10-02T00:00:00Z",
+            periodBTo: "2026-10-03T00:00:00Z",
+            includeActivityBreakdown: false,
+            engine,
+        }),
+    },
+    findFailedInstances: {
+        echo: (ch, engine) => queries.findFailedInstances(ch, { maxResults: 5, engine }),
+    },
+    elementBottleneck: {
+        echo: (ch, engine) => queries.elementBottleneck(ch, {
+            processDefinitionKey: "invoice",
+            period: "7d",
+            minBucketSize: 1,
+            maxResults: 5,
+            engine,
+        }),
+    },
+    elementHeat: {
+        exempt: "heatmap values only — its show tool and feed carry the scope in their own payload (analytics-connector engine-scope.test.ts)",
+    },
+    clusterCompare: {
+        echo: (ch, engine) => queries.clusterCompare(ch, {
+            deploymentTimestamp: "2026-10-05T00:00:00Z",
+            windowBeforeDays: 3,
+            windowAfterDays: 3,
+            minBucketSize: 1,
+            engine,
+        }),
+    },
+    versionCompare: {
+        echo: (ch, engine) => queries.versionCompare(ch, {
+            processDefinitionKey: "invoice",
+            versionA: 1,
+            versionB: 2,
+            windowDays: 7,
+            minBucketSize: 1,
+            engine,
+        }),
+    },
+    engineCompare: { exempt: "partitions by exactly engineA and engineB, both echoed" },
+    engineLandscape: { exempt: "lists every engine it covers, one row each" },
+    dashboardData: {
+        echo: (ch, engine) => queries.dashboardData(ch, { period: "7d", engine }),
+    },
+    failureDashboardData: {
+        echo: (ch, engine) => queries.failureDashboardData(ch, { engine }),
+    },
+    engineHealth: { echo: (ch, engine) => queries.engineHealth(ch, { engine }) },
+};
+describe("query honesty — every aggregate names the engines it covers", () => {
+    it.each(Object.entries(SCOPE_ECHO))("%s", async (_name, rule) => {
+        if ("exempt" in rule)
+            return;
+        const { ch } = recordingClient();
+        expect((await rule.echo(ch, FLEET)).engines).toEqual(FLEET);
+        // Unscoped library call: `null` = every engine Prometheus holds — never a
+        // made-up list, never silently absent.
+        expect((await rule.echo(ch, [])).engines).toBeNull();
+    });
+});
+/** Every path in `value` whose value is the empty string. */
+function emptyStrings(value, path = "$") {
+    if (value === "")
+        return [path];
+    if (Array.isArray(value))
+        return value.flatMap((v, i) => emptyStrings(v, `${path}[${i}]`));
+    if (value && typeof value === "object") {
+        return Object.entries(value).flatMap(([k, v]) => emptyStrings(v, `${path}.${k}`));
+    }
+    return [];
+}
+describe("query honesty — no placeholder fields", () => {
+    it.each(Object.entries(SCENARIOS))("%s fills every string field it returns", async (_name, scenarios) => {
+        for (const run of scenarios) {
+            // Every sample carries every label, so an empty string can only be a
+            // field no query fills — a placeholder posing as data.
+            const { ch } = recordingClient();
+            expect(emptyStrings(await run(ch))).toEqual([]);
+        }
+    });
+});
+//# sourceMappingURL=query-honesty.test.js.map

package/dist/query-honesty.test.js.map

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

package/dist/query-scenarios.test-support.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Test support shared by the behavioural query guards — never imported by
+ * runtime code. One recording Prometheus client plus a representative
+ * argument set for EVERY exported query function, so each guard runs the
+ * same calls:
+ *
+ * - `metrics-contract-labels.test.ts` (#327) checks every label each sent
+ *   PromQL names against the metrics contract;
+ * - `query-honesty.test.ts` (#336) checks the time window each PromQL reads
+ *   and the shape each function returns when Prometheus has no data.
+ */
+import type { PrometheusClient, PromSample } from "./prometheus.js";
+import * as queries from "./queries/index.js";
+/** One representative sample carrying every label a query may group or join on. */
+export declare const REPRESENTATIVE_SAMPLE: PromSample;
+export interface RecordingClient {
+    ch: PrometheusClient;
+    /** Every instant PromQL string, in the order it was sent. */
+    sent: string[];
+}
+/**
+ * PrometheusClient that records every instant PromQL string and answers each
+ * one with `answer` — by default a single {@link REPRESENTATIVE_SAMPLE}, so the
+ * result mapping runs too (a function that only queries further after
+ * non-empty data still gets there). Pass `() => []` for a Prometheus that
+ * holds no data at all.
+ */
+export declare function recordingClient(answer?: (query: string) => PromSample[]): RecordingClient;
+export type Scenario = (ch: PrometheusClient) => Promise<unknown>;
+/**
+ * ISO timestamp `days` before now (whole days, at call time — so a guard that
+ * pins the clock sees windows relative to ITS now). Scenario windows must sit
+ * inside the retention or the query refuses them.
+ */
+export declare const isoDaysAgo: (days: number) => string;
+/**
+ * Representative argument sets for EVERY exported query function — typed as a
+ * total map over the `queries` namespace, so a new export without a scenario
+ * fails `pnpm typecheck` (and the runtime check in each guard). Between them
+ * the sets switch on every optional matcher: engine filter (single and multi),
+ * element scope, incident type, process scope present and absent, the
+ * breakdowns.
+ */
+export declare const SCENARIOS: {
+    [K in keyof typeof queries]: Scenario[];
+};
+/** The exported query functions, by name — what the scenario map must cover. */
+export declare function exportedQueryFunctions(): string[];
+//# sourceMappingURL=query-scenarios.test-support.d.ts.map

package/dist/query-scenarios.test-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-scenarios.test-support.d.ts","sourceRoot":"","sources":["../src/query-scenarios.test-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAE7C,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,UAWnC,CAAA;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,gBAAgB,CAAA;IACpB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,EAAkC,GACtE,eAAe,CAWjB;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,EAAE,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,WAA2D,CAAA;AAElG;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE;KAAG,CAAC,IAAI,MAAM,OAAO,OAAO,GAAG,QAAQ,EAAE;CAqGhE,CAAA;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAIjD"}

package/dist/query-scenarios.test-support.js

@@ -0,0 +1,146 @@
+import * as queries from "./queries/index.js";
+/** One representative sample carrying every label a query may group or join on. */
+export const REPRESENTATIVE_SAMPLE = {
+    metric: {
+        engine_id: "prod-a",
+        process_definition_key: "invoice",
+        activity_id: "Task_check",
+        activity_type: "serviceTask",
+        incident_type: "failedJob",
+        alertname: "CibSevenDeadJobs",
+        severity: "warning",
+    },
+    value: 1,
+};
+/**
+ * PrometheusClient that records every instant PromQL string and answers each
+ * one with `answer` — by default a single {@link REPRESENTATIVE_SAMPLE}, so the
+ * result mapping runs too (a function that only queries further after
+ * non-empty data still gets there). Pass `() => []` for a Prometheus that
+ * holds no data at all.
+ */
+export function recordingClient(answer = () => [REPRESENTATIVE_SAMPLE]) {
+    const sent = [];
+    return {
+        ch: {
+            instant: (query) => {
+                sent.push(query);
+                return Promise.resolve(answer(query));
+            },
+        },
+        sent,
+    };
+}
+/**
+ * ISO timestamp `days` before now (whole days, at call time — so a guard that
+ * pins the clock sees windows relative to ITS now). Scenario windows must sit
+ * inside the retention or the query refuses them.
+ */
+export const isoDaysAgo = (days) => new Date(Date.now() - days * 86_400_000).toISOString();
+/**
+ * Representative argument sets for EVERY exported query function — typed as a
+ * total map over the `queries` namespace, so a new export without a scenario
+ * fails `pnpm typecheck` (and the runtime check in each guard). Between them
+ * the sets switch on every optional matcher: engine filter (single and multi),
+ * element scope, incident type, process scope present and absent, the
+ * breakdowns.
+ */
+export const SCENARIOS = {
+    analyzePerformance: [
+        (ch) => queries.analyzePerformance(ch, {
+            processDefinitionKey: "invoice",
+            period: "7d",
+            includeActivityBreakdown: true,
+            engine: "prod-a",
+        }),
+    ],
+    comparePeriods: [
+        (ch) => queries.comparePeriods(ch, {
+            processDefinitionKey: "invoice",
+            periodAFrom: isoDaysAgo(14),
+            periodATo: isoDaysAgo(7),
+            periodBFrom: isoDaysAgo(7),
+            periodBTo: isoDaysAgo(0),
+            includeActivityBreakdown: true,
+            engine: ["prod-a", "prod-b"],
+        }),
+    ],
+    findFailedInstances: [
+        (ch) => queries.findFailedInstances(ch, {
+            processDefinitionKey: "invoice",
+            incidentType: "failedJob",
+            maxResults: 10,
+            engine: "prod-a",
+        }),
+        (ch) => queries.findFailedInstances(ch, { maxResults: 10 }),
+    ],
+    elementBottleneck: [
+        (ch) => queries.elementBottleneck(ch, {
+            processDefinitionKey: "invoice",
+            period: "7d",
+            minBucketSize: 1,
+            maxResults: 10,
+            engine: "prod-a",
+        }),
+    ],
+    elementHeat: [
+        (ch) => queries.elementHeat(ch, { processDefinitionKey: "invoice", period: "7d", engine: "a" }),
+    ],
+    clusterCompare: [
+        (ch) => queries.clusterCompare(ch, {
+            processDefinitionKey: "invoice",
+            activityId: "Task_check",
+            deploymentTimestamp: isoDaysAgo(10),
+            windowBeforeDays: 7,
+            windowAfterDays: 7,
+            minBucketSize: 1,
+            engine: "prod-a",
+        }),
+        // A recent deployment: the post-deploy window reaches past now.
+        (ch) => queries.clusterCompare(ch, {
+            deploymentTimestamp: isoDaysAgo(2),
+            windowBeforeDays: 7,
+            windowAfterDays: 7,
+            minBucketSize: 1,
+        }),
+    ],
+    versionCompare: [
+        (ch) => queries.versionCompare(ch, {
+            processDefinitionKey: "invoice",
+            versionA: 1,
+            versionB: 2,
+            windowDays: 14,
+            minBucketSize: 1,
+            engine: ["prod-a", "prod-b"],
+        }),
+    ],
+    engineCompare: [
+        (ch) => queries.engineCompare(ch, {
+            processDefinitionKey: "invoice",
+            engineA: "prod-a",
+            engineB: "prod-b",
+            windowDays: 14,
+            activityId: "Task_check",
+            minBucketSize: 1,
+        }),
+    ],
+    engineLandscape: [
+        (ch) => queries.engineLandscape(ch),
+        (ch) => queries.engineLandscape(ch, { engine: ["prod-a", "prod-b"] }),
+    ],
+    dashboardData: [
+        (ch) => queries.dashboardData(ch, { processDefinitionKey: "invoice", period: "7d" }),
+        (ch) => queries.dashboardData(ch, { period: "1d", engine: "prod-a" }),
+    ],
+    failureDashboardData: [(ch) => queries.failureDashboardData(ch, { engine: "prod-a" })],
+    engineHealth: [
+        (ch) => queries.engineHealth(ch, {}),
+        (ch) => queries.engineHealth(ch, { engine: "prod-a" }),
+        (ch) => queries.engineHealth(ch, { engine: ["prod-a", "prod-b"], includeFleetAlerts: true }),
+    ],
+};
+/** The exported query functions, by name — what the scenario map must cover. */
+export function exportedQueryFunctions() {
+    return Object.keys(queries).filter((k) => typeof queries[k] === "function");
+}
+//# sourceMappingURL=query-scenarios.test-support.js.map

package/dist/query-scenarios.test-support.js.map

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

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

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const clusterCompareInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    processDefinitionKey: z.ZodOptional<z.ZodString>;
+    activityId: z.ZodOptional<z.ZodString>;
+    deploymentTimestamp: z.ZodString;
+    windowBeforeDays: z.ZodDefault<z.ZodNumber>;
+    windowAfterDays: z.ZodDefault<z.ZodNumber>;
+    minBucketSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=cluster-compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-compare.d.ts","sourceRoot":"","sources":["../../src/schemas/cluster-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,mBAAmB;;;;;;;;iBAiC9B,CAAA"}

package/dist/schemas/cluster-compare.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { engineFilterShape, isoDatetimeString } from "./shared.js";
+export const clusterCompareInput = z.object({
+    processDefinitionKey: z
+        .string()
+        .optional()
+        .describe("Restrict to a single process definition (optional)"),
+    activityId: z
+        .string()
+        .optional()
+        .describe("Also count the incidents at this BPMN element (element_incident_*; optional)"),
+    deploymentTimestamp: isoDatetimeString.describe("Deployment timestamp (ISO datetime). Pulled from camunda7_get_deployment."),
+    windowBeforeDays: z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .default(7)
+        .describe("Window size before the deployment, in days (max 30 — Prometheus retention)"),
+    windowAfterDays: z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .default(7)
+        .describe("Window size after the deployment, in days (max 30); clamped to now"),
+    minBucketSize: z
+        .number()
+        .int()
+        .min(1)
+        .default(10)
+        .describe("Minimum started and completed instances per window before results are trusted"),
+    ...engineFilterShape,
+});
+//# sourceMappingURL=cluster-compare.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-compare.js","sourceRoot":"","sources":["../../src/schemas/cluster-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,mBAAmB,EAAE,iBAAiB,CAAC,QAAQ,CAC7C,2EAA2E,CAC5E;IACD,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,4EAA4E,CAAC;IACzF,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,GAAG,iBAAiB;CACrB,CAAC,CAAA"}