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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miragon GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,85 @@
-# Temporary Holding Version
+# @miragon/pulse-analytics-client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Prometheus client and PromQL query layer for Camunda 7 / CIB Seven process analytics. It pairs a thin
+HTTP client for the Prometheus query API with a set of typed, purpose-built query functions and the
+**metrics contract** — the single source of truth for the `camunda_*` metric names and labels the
+[engine plugin](../../../../engine-plugins) emits.
+
+Used by [`@miragon/pulse-analytics-connector`](../analytics-connector) to power the `analytics_*` MCP tools, but
+usable by any project that reads Camunda process metrics from Prometheus.
+
+## Exports
+
+| Subpath     | Contents                                                                               |
+| ----------- | -------------------------------------------------------------------------------------- |
+| `.`         | Prometheus client + `METRIC_NAMES` + query re-exports                                  |
+| `./queries` | Typed PromQL query functions (performance, bottlenecks, failures, comparisons, health) |
+| `./schemas` | Zod input schemas for the query functions                                              |
+| `./widgets` | Shared widget data types for the analytics dashboards                                  |
+
+## Query functions
+
+`src/queries/` provides one composable function per analysis, each returning a typed result rather
+than a raw Prometheus matrix:
+
+- `performance` — throughput, duration percentiles over a window
+- `element` — per-activity bottleneck analysis
+- `failures` — failed / incident-bearing instances
+- `cluster-compare`, `version-compare`, `engine-compare` — side-by-side comparisons
+- `health` — live operational snapshot (running WIP, open incidents, dead jobs, backlog, alerts)
+- `dashboard` — the aggregate feed behind the analytics dashboard widget
+
+```ts
+import { createPrometheusClient } from "@miragon/pulse-analytics-client"
+import { analyzePerformance } from "@miragon/pulse-analytics-client/queries"
+
+const prom = createPrometheusClient({ url: "http://localhost:9090" })
+const perf = await analyzePerformance(prom, {
+  processDefinitionKey: "loanApproval",
+  period: "24h",
+  includeActivityBreakdown: true,
+})
+```
+
+`createPrometheusClient` also takes optional auth — `bearerToken`, or
+`username` + `password` (userinfo in `url` is moved into the Basic header) —
+extra `headers` (e.g. a tenant id) and a per-query `timeoutMs` (default
+30 000 ms). Ambiguous auth throws at construction. Query errors never carry
+the URL or a credential and truncate upstream bodies, so they are safe to show
+a model. `withCallerSignal(client, signal)` makes every query abort with the
+caller's signal as well.
+
+## Metrics contract
+
+[`metrics-contract.json`](metrics-contract.json) is the **single source of truth** for metric names
+and labels. The Kotlin plugin emits the OTEL instruments (`otelName`) that surface in Prometheus as
+`camunda_*` series (`promName`), and consumers reference them through `METRIC_NAMES`
+([`src/metric-names.ts`](src/metric-names.ts)) — **never raw strings**. Both sides are verified
+against the contract:
+
+- TypeScript: [`src/metrics-contract.test.ts`](src/metrics-contract.test.ts) (vitest) checks the
+  metric names; [`src/metrics-contract-labels.test.ts`](src/metrics-contract-labels.test.ts) runs
+  every exported query function and checks each label its PromQL names (matchers, `by`/`without`,
+  `on`/`ignoring`/`group_*`) against the labels the contract declares for that series, alert
+  rules and Grafana dashboards included
+- Kotlin: `MetricsContractTest.kt` (Gradle), incl. the millisecond bucket bounds each histogram
+  registers
+
+The contract also sets how a series is READ, and the same tests check every query, alert rule and
+dashboard panel against it. PromQL of your own uses the exported helpers:
+
+- `increaseIn(series, window)` for a counter or histogram: a series is created on its first event,
+  and `increase()`/`rate()` never count a series' first sample, so the first incident of a type at
+  an activity would read 0. A series born inside the window counts with its whole value.
+- `engineState(gauge, selector)` for a gauge: every node of a clustered engine reports the same
+  engine-wide rows, folded with `max by (<its labels>)` before anything sums them.
+- Durations are whole milliseconds (`*_duration_milliseconds`).
+
+A rename that skips the contract — or a consumer (queries, alert rules, Grafana dashboards) — fails
+one of these tests. Only attach model-bounded labels (definition key, activity id, engine id);
+never instance ids, business keys, or variable values.
+
+## Publishing
+
+Published to GitHub Packages (`npm.pkg.github.com`, restricted access) via release-please. The
+`metrics-contract.json` ships in the package so downstream consumers can validate against it.

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { createPrometheusClient, withCallerSignal, DEFAULT_PROMETHEUS_TIMEOUT_MS, type PrometheusQueryOptions, escapeLabelValue, engineMatcher, engineIdsOf, selector, PERIOD_RANGE, PERIODS, RETENTION_DAYS, type PrometheusConfig, type PrometheusClient, type PromSample, type EngineFilterInput, type Period, } from "./prometheus.js";
+export { METRIC_NAMES, GAUGE_LABELS, type MetricName, type GaugeName } from "./metric-names.js";
+export { increaseIn, engineState } from "./queries/helpers.js";
+export type { CountWindow } from "./queries/windows.js";
+export { ENGINE_ALERT_NAME_PATTERN, ENGINE_HEALTH_STATUS_RULE } from "./queries/health.js";
+export { ACTIVITY_BREAKDOWN_LIMIT } from "./queries/dashboard.js";
+export * as schemas from "./schemas/index.js";
+export * as queries from "./queries/index.js";
+export * as widgets from "./widgets.js";
+export type { CompareKpis, CompareKpiDelta, ErrorPatternRow, FailedInstancesResult, PerformanceResult, PerformanceKPI, ActivityBreakdownRow, PeriodComparisonKpi, PeriodActivityComparisonRow, PeriodComparisonResult, ElementBottleneckRow, ElementBottleneckResult, ElementHeatResult, ClusterCompareResult, ClusterCompareKpi, ClusterCompareDelta, VersionCompareResult, VersionCompareKpi, VersionCompareDelta, EngineCompareResult, EngineCompareKpi, EngineCompareDelta, EngineLandscapeResult, EngineLandscapeEngine, EngineLandscapeProcess, EngineHealthResult, HealthCount, HealthAlert, } from "./queries/index.js";
+export type { ErrorPatternItem, ProcessFailureItem, FailureDashboardData, ActivityBreakdownItem, DefinitionBreakdownItem, AnalyticsDashboardData, PreviousPeriodFlows, } from "./widgets.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,6BAA6B,EAC7B,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,MAAM,GACZ,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAI/F,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGvD,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { createPrometheusClient, withCallerSignal, DEFAULT_PROMETHEUS_TIMEOUT_MS, escapeLabelValue, engineMatcher, engineIdsOf, selector, PERIOD_RANGE, PERIODS, RETENTION_DAYS, } from "./prometheus.js";
+export { METRIC_NAMES, GAUGE_LABELS } from "./metric-names.js";
+// The reading rules of metrics-contract.json, for PromQL of your own: a
+// counter or histogram through the born-series count, a gauge folded over a
+// clustered engine's nodes.
+export { increaseIn, engineState } from "./queries/helpers.js";
+// Constants, not queries: kept out of the `queries` namespace, whose every
+// member the query scenarios enumerate.
+export { ENGINE_ALERT_NAME_PATTERN, ENGINE_HEALTH_STATUS_RULE } from "./queries/health.js";
+export { ACTIVITY_BREAKDOWN_LIMIT } from "./queries/dashboard.js";
+export * as schemas from "./schemas/index.js";
+export * as queries from "./queries/index.js";
+export * as widgets from "./widgets.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,6BAA6B,EAE7B,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,cAAc,GAMf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAmC,MAAM,mBAAmB,CAAA;AAC/F,wEAAwE;AACxE,4EAA4E;AAC5E,4BAA4B;AAC5B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAE9D,2EAA2E;AAC3E,wCAAwC;AACxC,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/dist/metric-names.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Prometheus series names for the engine-plugin metrics, mirroring
+ * `packages/connectors/analytics/analytics-client/metrics-contract.json` — the single source of
+ * truth for the Kotlin↔TS metric contract. Change the contract first; the
+ * contract test (`src/metrics-contract.test.ts`) diffs this object against the
+ * JSON, so a drift fails `pnpm test`.
+ *
+ * Histogram entries are the base series name — append `_sum` / `_count` /
+ * `_bucket` at the call site. Hand-maintained (not imported from the JSON)
+ * because the contract file lives outside the tsconfig `rootDir`.
+ */
+export declare const METRIC_NAMES: {
+    readonly processInstanceStarted: "camunda_process_instance_started_total";
+    readonly processInstanceEnded: "camunda_process_instance_ended_total";
+    readonly activityEnded: "camunda_activity_ended_total";
+    readonly userTaskCreated: "camunda_usertask_created_total";
+    readonly userTaskCompleted: "camunda_usertask_completed_total";
+    readonly incidentCreated: "camunda_incident_created_total";
+    readonly incidentResolved: "camunda_incident_resolved_total";
+    readonly processInstanceDuration: "camunda_process_instance_duration_milliseconds";
+    readonly activityDuration: "camunda_activity_duration_milliseconds";
+    readonly userTaskDuration: "camunda_usertask_duration_milliseconds";
+    readonly processInstancesRunning: "camunda_process_instances_running";
+    readonly jobsFailed: "camunda_jobs_failed";
+    readonly incidentsOpen: "camunda_incidents_open";
+    readonly jobsExecutable: "camunda_jobs_executable";
+    readonly jobsSuspended: "camunda_jobs_suspended";
+    readonly jobsDueFuture: "camunda_jobs_due_future";
+    readonly userTasksOpen: "camunda_usertasks_open";
+    readonly processDefinitionsDeployed: "camunda_process_definitions_deployed";
+    readonly externalTasksOpen: "camunda_external_tasks_open";
+};
+export type MetricName = (typeof METRIC_NAMES)[keyof typeof METRIC_NAMES];
+/** The engine-state gauges: every one is an engine-wide figure, reported alike by every node. */
+export type GaugeName = typeof METRIC_NAMES.processInstancesRunning | typeof METRIC_NAMES.jobsFailed | typeof METRIC_NAMES.incidentsOpen | typeof METRIC_NAMES.jobsExecutable | typeof METRIC_NAMES.jobsSuspended | typeof METRIC_NAMES.jobsDueFuture | typeof METRIC_NAMES.userTasksOpen | typeof METRIC_NAMES.processDefinitionsDeployed | typeof METRIC_NAMES.externalTasksOpen;
+/**
+ * The contract labels of each gauge: what makes one of its rows. A clustered
+ * engine's nodes are folded over exactly these (`max by`, contract rule 3), so
+ * node identity labels (`instance`, `job`) drop out and nothing else does. The
+ * contract test diffs this map against the JSON.
+ */
+export declare const GAUGE_LABELS: Readonly<Record<GaugeName, readonly string[]>>;
+//# sourceMappingURL=metric-names.d.ts.map

package/dist/metric-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-names.d.ts","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;CAuBf,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAA;AAEzE,iGAAiG;AACjG,MAAM,MAAM,SAAS,GACjB,OAAO,YAAY,CAAC,uBAAuB,GAC3C,OAAO,YAAY,CAAC,UAAU,GAC9B,OAAO,YAAY,CAAC,aAAa,GACjC,OAAO,YAAY,CAAC,cAAc,GAClC,OAAO,YAAY,CAAC,aAAa,GACjC,OAAO,YAAY,CAAC,aAAa,GACjC,OAAO,YAAY,CAAC,aAAa,GACjC,OAAO,YAAY,CAAC,0BAA0B,GAC9C,OAAO,YAAY,CAAC,iBAAiB,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC,CAUvE,CAAA"}

package/dist/metric-names.js

@@ -0,0 +1,53 @@
+/**
+ * Prometheus series names for the engine-plugin metrics, mirroring
+ * `packages/connectors/analytics/analytics-client/metrics-contract.json` — the single source of
+ * truth for the Kotlin↔TS metric contract. Change the contract first; the
+ * contract test (`src/metrics-contract.test.ts`) diffs this object against the
+ * JSON, so a drift fails `pnpm test`.
+ *
+ * Histogram entries are the base series name — append `_sum` / `_count` /
+ * `_bucket` at the call site. Hand-maintained (not imported from the JSON)
+ * because the contract file lives outside the tsconfig `rootDir`.
+ */
+export const METRIC_NAMES = {
+    // Counters (history-event stream)
+    processInstanceStarted: "camunda_process_instance_started_total",
+    processInstanceEnded: "camunda_process_instance_ended_total",
+    activityEnded: "camunda_activity_ended_total",
+    userTaskCreated: "camunda_usertask_created_total",
+    userTaskCompleted: "camunda_usertask_completed_total",
+    incidentCreated: "camunda_incident_created_total",
+    incidentResolved: "camunda_incident_resolved_total",
+    // Histograms in whole milliseconds (base name; `_sum`/`_count`/`_bucket` series implied)
+    processInstanceDuration: "camunda_process_instance_duration_milliseconds",
+    activityDuration: "camunda_activity_duration_milliseconds",
+    userTaskDuration: "camunda_usertask_duration_milliseconds",
+    // Gauges (point-in-time engine state)
+    processInstancesRunning: "camunda_process_instances_running",
+    jobsFailed: "camunda_jobs_failed",
+    incidentsOpen: "camunda_incidents_open",
+    jobsExecutable: "camunda_jobs_executable",
+    jobsSuspended: "camunda_jobs_suspended",
+    jobsDueFuture: "camunda_jobs_due_future",
+    userTasksOpen: "camunda_usertasks_open",
+    processDefinitionsDeployed: "camunda_process_definitions_deployed",
+    externalTasksOpen: "camunda_external_tasks_open",
+};
+/**
+ * The contract labels of each gauge: what makes one of its rows. A clustered
+ * engine's nodes are folded over exactly these (`max by`, contract rule 3), so
+ * node identity labels (`instance`, `job`) drop out and nothing else does. The
+ * contract test diffs this map against the JSON.
+ */
+export const GAUGE_LABELS = {
+    [METRIC_NAMES.processInstancesRunning]: ["process_definition_key", "engine_id"],
+    [METRIC_NAMES.jobsFailed]: ["process_definition_key", "engine_id"],
+    [METRIC_NAMES.incidentsOpen]: ["process_definition_key", "incident_type", "engine_id"],
+    [METRIC_NAMES.jobsExecutable]: ["engine_id"],
+    [METRIC_NAMES.jobsSuspended]: ["engine_id"],
+    [METRIC_NAMES.jobsDueFuture]: ["engine_id"],
+    [METRIC_NAMES.userTasksOpen]: ["status", "engine_id"],
+    [METRIC_NAMES.processDefinitionsDeployed]: ["process_definition_key", "engine_id"],
+    [METRIC_NAMES.externalTasksOpen]: ["engine_id"],
+};
+//# sourceMappingURL=metric-names.js.map

package/dist/metric-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-names.js","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,kCAAkC;IAClC,sBAAsB,EAAE,wCAAwC;IAChE,oBAAoB,EAAE,sCAAsC;IAC5D,aAAa,EAAE,8BAA8B;IAC7C,eAAe,EAAE,gCAAgC;IACjD,iBAAiB,EAAE,kCAAkC;IACrD,eAAe,EAAE,gCAAgC;IACjD,gBAAgB,EAAE,iCAAiC;IACnD,yFAAyF;IACzF,uBAAuB,EAAE,gDAAgD;IACzE,gBAAgB,EAAE,wCAAwC;IAC1D,gBAAgB,EAAE,wCAAwC;IAC1D,sCAAsC;IACtC,uBAAuB,EAAE,mCAAmC;IAC5D,UAAU,EAAE,qBAAqB;IACjC,aAAa,EAAE,wBAAwB;IACvC,cAAc,EAAE,yBAAyB;IACzC,aAAa,EAAE,wBAAwB;IACvC,aAAa,EAAE,yBAAyB;IACxC,aAAa,EAAE,wBAAwB;IACvC,0BAA0B,EAAE,sCAAsC;IAClE,iBAAiB,EAAE,6BAA6B;CACxC,CAAA;AAgBV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAmD;IAC1E,CAAC,YAAY,CAAC,uBAAuB,CAAC,EAAE,CAAC,wBAAwB,EAAE,WAAW,CAAC;IAC/E,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC,wBAAwB,EAAE,WAAW,CAAC;IAClE,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC,wBAAwB,EAAE,eAAe,EAAE,WAAW,CAAC;IACtF,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC,WAAW,CAAC;IAC5C,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,CAAC;IAC3C,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,CAAC;IAC3C,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IACrD,CAAC,YAAY,CAAC,0BAA0B,CAAC,EAAE,CAAC,wBAAwB,EAAE,WAAW,CAAC;IAClF,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC,WAAW,CAAC;CAChD,CAAA"}

package/dist/metrics-contract-labels.test.d.ts

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

package/dist/metrics-contract-labels.test.d.ts.map

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

package/dist/metrics-contract-labels.test.js

@@ -0,0 +1,169 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import { checkQueryLabels, contractCatalog, } from "./promql-labels.test-support.js";
+import { alertExpressions, dashboardQueries } from "./promql-sources.test-support.js";
+import { readingRuleViolations } from "./promql-reading-rules.test-support.js";
+import { RETENTION_DAYS } from "./prometheus.js";
+import { ENGINE_ALERT_NAME_PATTERN } from "./queries/health.js";
+import { DAY_SECONDS, nowSeconds, rangeSeconds } from "./queries/windows.js";
+import { SCENARIOS, exportedQueryFunctions, recordingClient, } from "./query-scenarios.test-support.js";
+/**
+ * Behavioural half of the metrics contract: instead of scanning source text,
+ * run every exported query function against a recording Prometheus client and
+ * check each PromQL it actually sends — every matcher label, every
+ * `by`/`without` grouping label, every `on`/`ignoring`/`group_*` label — against
+ * the labels `metrics-contract.json` declares for that series. The alert rules
+ * and Grafana dashboards go through the same checker.
+ *
+ * A text scan cannot see a label that only exists in a composed selector; this
+ * one caught `analytics_version_compare` filtering the incident counter on
+ * `process_definition_version`, a label that series never carries (#327).
+ */
+const here = (rel) => fileURLToPath(new URL(rel, import.meta.url));
+// src/ → analytics-client → analytics → connectors → packages → repo root
+const repoRoot = here("../../../../..");
+const contract = JSON.parse(readFileSync(here("../metrics-contract.json"), "utf8"));
+const alertsFile = join(repoRoot, "playground/docker/prometheus/alerts.yml");
+const dashboardsDir = join(repoRoot, "playground/docker/grafana/dashboards");
+/**
+ * Non-contract series Prometheus synthesises itself. `up` carries the scrape
+ * target labels (no target relabelling in prometheus.yml). `ALERTS` carries
+ * `alertname`/`alertstate`, each rule's static `severity` and the labels its
+ * expression yields — derived from alerts.yml below, never hand-listed, so a
+ * rule that stops aggregating by a label also drops it here.
+ */
+const UP_LABELS = ["job", "instance"];
+const ALERTS_BASE_LABELS = ["alertname", "alertstate", "severity"];
+const ruleCatalog = contractCatalog(contract.metrics, { up: { labels: UP_LABELS } });
+const alertsYaml = readFileSync(alertsFile, "utf8");
+const alertRules = alertExpressions(alertsYaml);
+const alertLabels = new Set([
+    ...ALERTS_BASE_LABELS,
+    ...alertRules.flatMap((expr) => checkQueryLabels(expr, ruleCatalog).resultLabels ?? []),
+]);
+const catalog = contractCatalog(contract.metrics, {
+    up: { labels: UP_LABELS },
+    ALERTS: { labels: [...alertLabels] },
+});
+/** Violations of one PromQL source, each prefixed with where it came from. */
+function violationsOf(origin, promql) {
+    return checkQueryLabels(promql, catalog).violations.map((v) => `${origin}: ${v}\n    ${promql}`);
+}
+describe("metrics contract — labels each query actually sends", () => {
+    it("has a scenario for every exported query function", () => {
+        expect(Object.keys(SCENARIOS).sort()).toEqual(exportedQueryFunctions().sort());
+    });
+    it.each(Object.entries(SCENARIOS))("%s names only labels its series declare", async (name, scenarios) => {
+        const violations = [];
+        let checked = 0;
+        for (const run of scenarios) {
+            const { ch, sent } = recordingClient();
+            await run(ch);
+            expect(sent.length, `${name} sent no PromQL`).toBeGreaterThan(0);
+            for (const promql of sent) {
+                violations.push(...violationsOf(name, promql));
+                checked += checkQueryLabels(promql, catalog).checkedLabels;
+            }
+        }
+        expect(violations).toEqual([]);
+        // Every query scopes by at least one label (engine, process, …) — 0
+        // here means the scenario args or the checker went blind.
+        expect(checked, `${name}: no label reference was checked`).toBeGreaterThan(0);
+    });
+});
+describe("metrics contract — labels in alert rules and dashboards", () => {
+    it("alert rule expressions name only declared labels", () => {
+        expect(alertRules.length).toBeGreaterThan(0);
+        // Every `expr:` in the file was extracted — none hides in a YAML shape
+        // (flow mapping, …) the extractor does not read.
+        expect(alertRules).toHaveLength(alertsYaml.match(/\bexpr:/g)?.length ?? 0);
+        expect(alertRules.flatMap((expr) => violationsOf("alerts.yml", expr))).toEqual([]);
+        for (const expr of alertRules) {
+            // A rule that selects no series or yields no vector was not checked —
+            // e.g. an expression that parsed as one PromQL string literal.
+            const { series, resultLabels } = checkQueryLabels(expr, catalog);
+            expect(series, `alerts.yml selects no series: ${expr}`).not.toEqual([]);
+            expect(resultLabels, `alerts.yml yields no vector: ${expr}`).toBeDefined();
+        }
+        // The rules aggregate by engine_id — `engineHealth` filters ALERTS on it.
+        expect(alertLabels.has("engine_id")).toBe(true);
+    });
+    it("every shipped alert rule is named so engineHealth recognises it as the module's own", () => {
+        // Engine-less alerts (CibSevenEngineNoMetrics) only count when their name
+        // matches — a rule outside the pattern would silently drop out of the
+        // fleet-wide verdict, and a shared Prometheus' foreign alerts must not count.
+        const names = [...alertsYaml.matchAll(/^\s*-\s*alert:\s*(\S+)\s*$/gm)].map((m) => m[1]);
+        expect(names).toHaveLength(alertRules.length);
+        const own = new RegExp(`^(?:${ENGINE_ALERT_NAME_PATTERN})$`);
+        expect(names.filter((name) => !own.test(name))).toEqual([]);
+    });
+    it("Grafana dashboard queries name only declared labels", () => {
+        const files = readdirSync(dashboardsDir).filter((f) => f.endsWith(".json"));
+        expect(files.length).toBeGreaterThan(0);
+        let expressions = 0;
+        const violations = [];
+        for (const file of files) {
+            const dashboard = JSON.parse(readFileSync(join(dashboardsDir, file), "utf8"));
+            for (const promql of dashboardQueries(dashboard)) {
+                expressions++;
+                violations.push(...violationsOf(`dashboards/${file}`, promql));
+                const { series } = checkQueryLabels(promql, catalog);
+                expect(series, `dashboards/${file} selects no series: ${promql}`).not.toEqual([]);
+            }
+        }
+        expect(expressions).toBeGreaterThan(0);
+        expect(violations).toEqual([]);
+    });
+});
+/**
+ * Contract rules 2 and 3 over every consumer: a counter or histogram is read
+ * only through the born-series count, a gauge only folded over its nodes.
+ * Queries may read plain `increase()` only over a window of an hour or less
+ * at the retention edge (`increaseIn` has no hour to check there); the alert
+ * rules and dashboards never.
+ */
+describe("metrics contract — reading rules", () => {
+    const plainIncreaseAllowed = (range, at) => {
+        const now = nowSeconds();
+        const seconds = rangeSeconds(range);
+        return seconds <= 3600 && (at ?? now) - seconds - 3600 < now - RETENTION_DAYS * DAY_SECONDS;
+    };
+    it.each(Object.entries(SCENARIOS))("%s reads counters and gauges by the rules", async (name, scenarios) => {
+        const violations = [];
+        for (const run of scenarios) {
+            const { ch, sent } = recordingClient();
+            await run(ch);
+            for (const promql of sent) {
+                violations.push(...readingRuleViolations(promql, contract.metrics, { plainIncreaseAllowed }).map((v) => `${name}: ${v}\n    ${promql}`));
+            }
+        }
+        expect(violations).toEqual([]);
+    });
+    it("alert rules read counters and gauges by the rules", () => {
+        const violations = alertRules.flatMap((expr) => readingRuleViolations(expr, contract.metrics).map((v) => `alerts.yml: ${v}\n    ${expr}`));
+        expect(violations).toEqual([]);
+    });
+    it("Grafana panels read counters and gauges by the rules", () => {
+        const violations = [];
+        for (const file of readdirSync(dashboardsDir).filter((f) => f.endsWith(".json"))) {
+            const dashboard = JSON.parse(readFileSync(join(dashboardsDir, file), "utf8"));
+            // Panel expressions only: a templating `label_values(…)` lists label
+            // values, it reads no counter or gauge value.
+            for (const promql of panelExpressions(dashboard)) {
+                violations.push(...readingRuleViolations(promql, contract.metrics).map((v) => `dashboards/${file}: ${v}\n    ${promql}`));
+            }
+        }
+        expect(violations).toEqual([]);
+    });
+});
+/** Every panel `expr` of a dashboard. */
+function panelExpressions(node) {
+    if (Array.isArray(node))
+        return node.flatMap(panelExpressions);
+    if (node === null || typeof node !== "object")
+        return [];
+    return Object.entries(node).flatMap(([key, value]) => key === "expr" && typeof value === "string" ? [value] : panelExpressions(value));
+}
+//# sourceMappingURL=metrics-contract-labels.test.js.map

package/dist/metrics-contract-labels.test.js.map

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

package/dist/metrics-contract.test.d.ts

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

package/dist/metrics-contract.test.d.ts.map

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