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

package/dist/tools/engine-compare.test.js

@@ -0,0 +1,166 @@
+import { describe, expect, it } from "vitest";
+import { z } from "zod";
+import { increaseIn } from "@miragon/pulse-analytics-client";
+import { createEngineScope } from "../engine-ids.js";
+import { registerEngineCompareTools } from "./engine-compare.js";
+const scope = createEngineScope(["prod-a", "prod-b"]);
+const register = (r, store) => registerEngineCompareTools(r, scope, store);
+/** Registrar stand-in that captures each tool's full config instead of an MCPServer. */
+function captureConfigs(registerModule) {
+    const configs = new Map();
+    const register = Object.assign((config) => {
+        configs.set(config.name, config);
+    }, { getRegisteredTools: () => [] });
+    registerModule(register);
+    return configs;
+}
+function captureHandlers(registerModule) {
+    const configs = captureConfigs(registerModule);
+    return new Map([...configs].map(([name, c]) => [name, c.handler]));
+}
+/** PrometheusClient that records every instant PromQL string and returns no samples. */
+function recordingClient() {
+    const queries = [];
+    return {
+        client: {
+            instant: (query) => {
+                queries.push(query);
+                return Promise.resolve([]);
+            },
+        },
+        queries,
+    };
+}
+/** The five KPI queries per engine — no duplicate incident query without an element (N85). */
+function kpiQueries(sel, completedSel, range) {
+    const count = (series) => increaseIn(series, { range });
+    const duration = "camunda_process_instance_duration_milliseconds";
+    return [
+        `sum(${count(`camunda_process_instance_started_total${sel}`)})`,
+        `sum(${count(`camunda_process_instance_ended_total${completedSel}`)})`,
+        `sum(${count(`camunda_incident_created_total${sel}`)})`,
+        `sum(${count(`${duration}_sum${sel}`)}) / sum(${count(`${duration}_count${sel}`)})`,
+        `histogram_quantile(0.95, sum by (le)(${count(`${duration}_bucket${sel}`)}))`,
+    ];
+}
+describe("analytics_engine_compare PromQL", () => {
+    it("partitions every query by engine_id and applies the shared window", async () => {
+        const handlers = captureHandlers(register);
+        const { client, queries } = recordingClient();
+        const key = 'process_definition_key="order"';
+        await handlers.get("analytics_engine_compare")(client, {
+            processDefinitionKey: "order",
+            engineA: "prod-a",
+            engineB: "prod-b",
+            windowDays: 14,
+            minBucketSize: 10,
+        });
+        expect(queries).toEqual([
+            ...kpiQueries(`{${key},engine_id="prod-a"}`, `{${key},state="COMPLETED",engine_id="prod-a"}`, "14d"),
+            ...kpiQueries(`{${key},engine_id="prod-b"}`, `{${key},state="COMPLETED",engine_id="prod-b"}`, "14d"),
+        ]);
+    });
+    it("scopes to processDefinitionKey everywhere and activityId only on the incident query", async () => {
+        const handlers = captureHandlers(register);
+        const { client, queries } = recordingClient();
+        await handlers.get("analytics_engine_compare")(client, {
+            engineA: "prod-a",
+            engineB: "prod-b",
+            windowDays: 7,
+            processDefinitionKey: "order",
+            activityId: "Task_check",
+            minBucketSize: 1,
+        });
+        const key = 'process_definition_key="order"';
+        // Five KPI queries per engine plus the element-scoped incident count.
+        expect(queries).toHaveLength(12);
+        expect(queries.every((q) => q.includes(key))).toBe(true);
+        const elementScoped = queries.filter((q) => q.includes('activity_id="Task_check"'));
+        const incidents = (engine) => `sum(${increaseIn(`camunda_incident_created_total{${key},activity_id="Task_check",engine_id="${engine}"}`, { range: "7d" })})`;
+        expect(elementScoped).toEqual([incidents("prod-a"), incidents("prod-b")]);
+    });
+    it("refuses an engine this server is not configured for, before any query (N138)", async () => {
+        const handlers = captureHandlers(register);
+        const { client, queries } = recordingClient();
+        await expect(handlers.get("analytics_engine_compare")(client, {
+            processDefinitionKey: "order",
+            engineA: "prod-a",
+            engineB: "tenant-x",
+            windowDays: 7,
+        })).rejects.toThrow(/Unknown engine "tenant-x" in engineB/);
+        expect(queries).toEqual([]);
+    });
+    it("reads 'nothing ended' as an unmeasured duration and suppresses its delta (N78)", async () => {
+        const handlers = captureHandlers(register);
+        // Both engines started 40 instances; only prod-a has completed any — prod-b
+        // has no duration sample at all.
+        const client = {
+            instant: (q) => Promise.resolve(q.includes("duration_milliseconds") && q.includes("prod-b")
+                ? []
+                : [{ metric: {}, value: q.includes("duration_milliseconds") ? 30_000 : 40 }]),
+        };
+        const result = (await handlers.get("analytics_engine_compare")(client, {
+            processDefinitionKey: "order",
+            engineA: "prod-a",
+            engineB: "prod-b",
+            windowDays: 7,
+            minBucketSize: 1,
+        }));
+        expect(result.kpis[1]).toMatchObject({ avg_duration_sec: null, p95_duration_sec: null });
+        // Never a −100 % from a missing value.
+        expect(result.delta).toMatchObject({
+            avg_duration_delta_pct: null,
+            p95_duration_delta_pct: null,
+        });
+    });
+    it("prefers an explicit minBucketSize over the resolved setting", async () => {
+        const handlers = captureHandlers(register);
+        const { client } = recordingClient();
+        const explicit = (await handlers.get("analytics_engine_compare")(client, {
+            processDefinitionKey: "order",
+            engineA: "prod-a",
+            engineB: "prod-b",
+            windowDays: 7,
+            minBucketSize: 3,
+        }));
+        const fallback = (await handlers.get("analytics_engine_compare")(client, {
+            processDefinitionKey: "order",
+            engineA: "prod-a",
+            engineB: "prod-b",
+            windowDays: 7,
+        }));
+        // "explicit arg > saved setting > schema default": without a store or a
+        // resolvable profile key the registrar path lands on the schema default.
+        expect(explicit.minBucketSize).toBe(3);
+        expect(fallback.minBucketSize).toBe(10);
+    });
+});
+describe("analytics_engine_compare registration", () => {
+    const config = captureConfigs(register).get("analytics_engine_compare");
+    it("registers under the analytics category as a read-only external read", () => {
+        expect(config.category).toBe("analytics");
+        // toolsets.test.ts derives admin-only status from these; a read that lost
+        // `readOnlyHint` would silently change the toolset surface.
+        expect(config.annotations).toEqual({
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        });
+    });
+    it("tells the model why the process scope is mandatory", () => {
+        // The description is the only place a model learns that an unscoped
+        // engine-vs-engine comparison measures the process mix — losing it turns
+        // the tool back into the apples-to-oranges comparison it replaced.
+        expect(config.description).toContain("processDefinitionKey is required");
+        expect(config.description).toContain("process mixes");
+        expect(config.description).toContain("analytics_engine_landscape");
+    });
+    it("requires processDefinitionKey at the schema boundary", () => {
+        const parsed = z.object(config.inputSchema).safeParse({
+            engineA: "prod-a",
+            engineB: "prod-b",
+        });
+        expect(parsed.success).toBe(false);
+    });
+});
+//# sourceMappingURL=engine-compare.test.js.map

package/dist/tools/engine-compare.test.js.map

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

package/dist/tools/engine-landscape.d.ts

@@ -0,0 +1,7 @@
+import type { PrometheusClient } from "@miragon/pulse-analytics-client";
+import type { createToolRegistrar } from "@miragon/mcp-toolkit-core/tools";
+import { type AnalyticsEngineScope } from "../engine-ids.js";
+type Register = ReturnType<typeof createToolRegistrar<PrometheusClient>>;
+export declare function registerEngineLandscapeTools(register: Register, engineScope: AnalyticsEngineScope): void;
+export {};
+//# sourceMappingURL=engine-landscape.d.ts.map

package/dist/tools/engine-landscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-landscape.d.ts","sourceRoot":"","sources":["../../src/tools/engine-landscape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAC1E,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE7E,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAExE,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,oBAAoB,QAWlC"}

package/dist/tools/engine-landscape.js

@@ -0,0 +1,13 @@
+import { schemas, queries } from "@miragon/pulse-analytics-client";
+import { withEngineScope } from "../engine-ids.js";
+export function registerEngineLandscapeTools(register, engineScope) {
+    register({
+        name: "analytics_engine_landscape",
+        category: "analytics",
+        description: "Cross-engine overview of the process landscape: which process definitions run on which engine (the inventory matrix), the absolute load per engine (running instances, open incidents, failed jobs), and the engine-owned job backlog (executable/suspended/future-due jobs, open external tasks). Reports counts, not rates, on purpose — engines host different process mixes, so a per-engine failure rate or average duration measures the mix rather than the engine. The backlog gauges carry no process label and therefore DO compare across engines. Returns `sharedProcessKeys`: the definitions deployed on more than one engine, the only sound inputs for analytics_engine_compare. Covers the server's configured engines (omitted engine = all of them); an engine reporting no metrics at all comes back with `reporting: false`.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: schemas.engineLandscapeInput.shape,
+        handler: async (ch, args) => queries.engineLandscape(ch, withEngineScope(engineScope, args)),
+    });
+}
+//# sourceMappingURL=engine-landscape.js.map

package/dist/tools/engine-landscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-landscape.js","sourceRoot":"","sources":["../../src/tools/engine-landscape.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,EAAE,eAAe,EAA6B,MAAM,kBAAkB,CAAA;AAI7E,MAAM,UAAU,4BAA4B,CAC1C,QAAkB,EAClB,WAAiC;IAEjC,QAAQ,CAAC;QACP,IAAI,EAAE,4BAA4B;QAClC,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,mzBAAmzB;QACrzB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9E,WAAW,EAAE,OAAO,CAAC,oBAAoB,CAAC,KAAK;QAC/C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,EAAE,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;KAC7F,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/engine-landscape.test.d.ts

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

package/dist/tools/engine-landscape.test.d.ts.map

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

package/dist/tools/engine-landscape.test.js

@@ -0,0 +1,110 @@
+import { describe, expect, it } from "vitest";
+import { z } from "zod";
+import { createEngineScope } from "../engine-ids.js";
+import { registerEngineLandscapeTools } from "./engine-landscape.js";
+/** The engines this server is configured for — prod-c reports nothing. */
+const scope = createEngineScope(["prod-a", "prod-b", "prod-c"]);
+const register = (r) => registerEngineLandscapeTools(r, scope);
+/** Registrar stand-in that captures each tool's full config instead of an MCPServer. */
+function captureConfigs(registerModule) {
+    const configs = new Map();
+    const register = Object.assign((config) => {
+        configs.set(config.name, config);
+    }, { getRegisteredTools: () => [] });
+    registerModule(register);
+    return configs;
+}
+function captureHandlers(registerModule) {
+    const configs = captureConfigs(registerModule);
+    return new Map([...configs].map(([name, c]) => [name, c.handler]));
+}
+/** Records every PromQL string and answers with a two-engine landscape. */
+function recordingClient() {
+    const queries = [];
+    const cell = (engine_id, process_definition_key, value) => ({
+        metric: { engine_id, process_definition_key },
+        value,
+    });
+    return {
+        client: {
+            instant: (query) => {
+                queries.push(query);
+                if (query.includes("process_definitions_deployed")) {
+                    return Promise.resolve([cell("prod-a", "order", 1), cell("prod-b", "onboarding", 1)]);
+                }
+                if (query.includes("process_instances_running")) {
+                    return Promise.resolve([cell("prod-a", "order", 5)]);
+                }
+                return Promise.resolve([]);
+            },
+        },
+        queries,
+    };
+}
+describe("analytics_engine_landscape", () => {
+    it("builds the inventory matrix and issues one node-folded query per metric", async () => {
+        const handlers = captureHandlers(register);
+        const { client, queries } = recordingClient();
+        const result = (await handlers.get("analytics_engine_landscape")(client, {}));
+        // Engine omitted = the configured fleet: the silent prod-c stays visible.
+        expect(result.engines.map((e) => e.engineId)).toEqual(["prod-a", "prod-b", "prod-c"]);
+        expect(result.engines[0].runningInstances).toBe(5);
+        // Each engine runs its own definition — nothing to compare like-for-like.
+        expect(result.sharedProcessKeys).toEqual([]);
+        const sel = '{engine_id=~"prod-a|prod-b|prod-c"}';
+        // Every gauge folded over its own labels first: a clustered engine's
+        // nodes report the same engine-wide rows.
+        const byKey = (gauge, labels = "process_definition_key, engine_id") => `sum by (engine_id, process_definition_key)(max by (${labels})(${gauge}${sel}))`;
+        expect(queries).toEqual([
+            byKey("camunda_process_definitions_deployed"),
+            byKey("camunda_process_instances_running"),
+            byKey("camunda_incidents_open", "process_definition_key, incident_type, engine_id"),
+            byKey("camunda_jobs_failed"),
+            `max by (engine_id)(camunda_jobs_executable${sel})`,
+            `max by (engine_id)(camunda_jobs_suspended${sel})`,
+            `max by (engine_id)(camunda_jobs_due_future${sel})`,
+            `max by (engine_id)(camunda_external_tasks_open${sel})`,
+        ]);
+    });
+    it("applies the engine filter and keeps a non-reporting engine visible", async () => {
+        const handlers = captureHandlers(register);
+        const { client, queries } = recordingClient();
+        const result = (await handlers.get("analytics_engine_landscape")(client, {
+            engine: ["prod-a", "prod-c"],
+        }));
+        expect(queries.every((q) => q.includes('{engine_id=~"prod-a|prod-c"}'))).toBe(true);
+        expect(result.engines.find((e) => e.engineId === "prod-c")).toMatchObject({ reporting: false });
+    });
+    it("never lists another tenant's engine from a shared Prometheus (N138)", async () => {
+        const handlers = captureHandlers(register);
+        const { client, queries } = recordingClient();
+        await expect(handlers.get("analytics_engine_landscape")(client, { engine: ["prod-a", "tenant-x"] })).rejects.toThrow(/Unknown engine "tenant-x"/);
+        expect(queries).toEqual([]);
+    });
+});
+describe("analytics_engine_landscape registration", () => {
+    const config = captureConfigs(register).get("analytics_engine_landscape");
+    it("registers under the analytics category as a read-only external read", () => {
+        expect(config.category).toBe("analytics");
+        expect(config.annotations).toEqual({
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        });
+    });
+    it("tells the model that counts — not per-engine rates — are the point", () => {
+        // Without this the model would divide the counts back into per-engine
+        // rates and compare them, which is exactly the confound the view exists
+        // to avoid.
+        expect(config.description).toContain("counts, not rates");
+        expect(config.description).toContain("process mixes");
+        expect(config.description).toContain("sharedProcessKeys");
+    });
+    it("accepts an engine list or nothing at all", () => {
+        const schema = z.object(config.inputSchema);
+        expect(schema.safeParse({}).success).toBe(true);
+        expect(schema.safeParse({ engine: ["prod-a", "prod-b"] }).success).toBe(true);
+        expect(schema.safeParse({ engine: "prod-a" }).success).toBe(true);
+    });
+});
+//# sourceMappingURL=engine-landscape.test.js.map

package/dist/tools/engine-landscape.test.js.map

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

package/dist/tools/failures.d.ts

@@ -0,0 +1,7 @@
+import type { PrometheusClient } from "@miragon/pulse-analytics-client";
+import type { createToolRegistrar } from "@miragon/mcp-toolkit-core/tools";
+import { type AnalyticsEngineScope } from "../engine-ids.js";
+type Register = ReturnType<typeof createToolRegistrar<PrometheusClient>>;
+export declare function registerFailureTools(register: Register, engineScope: AnalyticsEngineScope): void;
+export {};
+//# sourceMappingURL=failures.d.ts.map

package/dist/tools/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../src/tools/failures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAC1E,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE7E,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAExE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,QAWzF"}

package/dist/tools/failures.js

@@ -0,0 +1,13 @@
+import { schemas, queries } from "@miragon/pulse-analytics-client";
+import { withEngineScope } from "../engine-ids.js";
+export function registerFailureTools(register, engineScope) {
+    register({
+        name: "analytics_find_failed_instances",
+        category: "analytics",
+        description: "List currently-open incident patterns from process metrics, grouped by incident type and process definition (point-in-time — what is failing right now; no message, activity or timestamps). Use for counts across engines; for the actual failed instances (ids, messages) use camunda7_list_incidents, for past ones camunda7_query_historic_incidents.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: schemas.findFailedInstancesInput.shape,
+        handler: async (ch, args) => queries.findFailedInstances(ch, withEngineScope(engineScope, args)),
+    });
+}
+//# sourceMappingURL=failures.js.map

package/dist/tools/failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.js","sourceRoot":"","sources":["../../src/tools/failures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,EAAE,eAAe,EAA6B,MAAM,kBAAkB,CAAA;AAI7E,MAAM,UAAU,oBAAoB,CAAC,QAAkB,EAAE,WAAiC;IACxF,QAAQ,CAAC;QACP,IAAI,EAAE,iCAAiC;QACvC,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,2VAA2V;QAC7V,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9E,WAAW,EAAE,OAAO,CAAC,wBAAwB,CAAC,KAAK;QACnD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAC1B,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;KACtE,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/health.d.ts

@@ -0,0 +1,7 @@
+import type { PrometheusClient } from "@miragon/pulse-analytics-client";
+import type { createToolRegistrar } from "@miragon/mcp-toolkit-core/tools";
+import type { AnalyticsEngineScope } from "../engine-ids.js";
+type Register = ReturnType<typeof createToolRegistrar<PrometheusClient>>;
+export declare function registerHealthTools(register: Register, engineScope: AnalyticsEngineScope): void;
+export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/tools/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE5D,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAExE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,QAqBxF"}

package/dist/tools/health.js

@@ -0,0 +1,23 @@
+import { ENGINE_HEALTH_STATUS_RULE, schemas, queries } from "@miragon/pulse-analytics-client";
+export function registerHealthTools(register, engineScope) {
+    register({
+        name: "analytics_engine_health",
+        category: "analytics",
+        description: "Live operational health of the CIB Seven engine(s), from Prometheus state gauges: running WIP, open incidents by type, dead jobs (retries exhausted), executable/suspended job backlog, open/unassigned user tasks, external-task backlog, deployed definitions, and which alert rules are firing/pending. " +
+            "Names the engines judged and the silent ones (`silentEngines`: their counts read 0 because nothing arrives). " +
+            `Status: ${ENGINE_HEALTH_STATUS_RULE} ` +
+            "Use for fleet-wide or metric-based health; for one engine's live incident clusters use camunda7_show_engine_health.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: schemas.engineHealthInput.shape,
+        handler: async (ch, args) => {
+            const engines = engineScope.resolve(args.engine);
+            // The module's engine-less alerts (a collector outage) only count for a
+            // verdict over the whole configured fleet.
+            return queries.engineHealth(ch, {
+                engine: engines,
+                includeFleetAlerts: engineScope.coversFleet(engines),
+            });
+        },
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/tools/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAM7F,MAAM,UAAU,mBAAmB,CAAC,QAAkB,EAAE,WAAiC;IACvF,QAAQ,CAAC;QACP,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,6SAA6S;YAC7S,+GAA+G;YAC/G,WAAW,yBAAyB,GAAG;YACvC,qHAAqH;QACvH,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9E,WAAW,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK;QAC5C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAChD,wEAAwE;YACxE,2CAA2C;YAC3C,OAAO,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE;gBAC9B,MAAM,EAAE,OAAO;gBACf,kBAAkB,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC;aACrD,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/health.test.d.ts

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

package/dist/tools/health.test.d.ts.map

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

package/dist/tools/health.test.js

@@ -0,0 +1,119 @@
+import { describe, expect, it } from "vitest";
+import { ENGINE_HEALTH_STATUS_RULE, } from "@miragon/pulse-analytics-client";
+import { createEngineScope } from "../engine-ids.js";
+import { registerHealthTools } from "./health.js";
+/** The fleet this server is configured for. */
+const scope = createEngineScope(["prod-a", "prod-b"]);
+/** Registrar stand-in that captures the tool's config instead of an MCPServer. */
+function captureConfig() {
+    const configs = [];
+    const register = Object.assign((config) => configs.push(config), {
+        getRegisteredTools: () => [],
+    });
+    registerHealthTools(register, scope);
+    return configs[0];
+}
+/** PrometheusClient that records every instant PromQL string and answers via `answer`. */
+function recordingClient(answer = () => []) {
+    const queries = [];
+    const client = {
+        instant: (query) => {
+            queries.push(query);
+            return Promise.resolve(answer(query));
+        },
+    };
+    return { client, queries };
+}
+const run = (client, args) => captureConfig().handler(client, args, {});
+/** Prometheus where only `prod-a` reports its engine-state gauges (when the selector admits it). */
+const onlyProdAReports = (query) => query.includes("prod-a") &&
+    (query.includes("camunda_jobs_executable") || query.includes("camunda_external_tasks_open"))
+    ? [{ metric: { engine_id: "prod-a" }, value: 0 }]
+    : [];
+describe("analytics_engine_health — engine scope (N138)", () => {
+    it("with engine omitted, judges exactly the configured fleet — never every engine Prometheus holds", async () => {
+        const { client, queries } = recordingClient();
+        const result = await run(client, {});
+        expect(result.engines).toEqual(["prod-a", "prod-b"]);
+        expect(queries.every((q) => q.includes('engine_id=~"prod-a|prod-b"'))).toBe(true);
+    });
+    it("refuses an engine id this server is not configured for, before any query", async () => {
+        const { client, queries } = recordingClient();
+        await expect(run(client, { engine: "tenant-x" })).rejects.toThrow(/Unknown engine "tenant-x".*configured engines: prod-a, prod-b/);
+        expect(queries).toEqual([]);
+    });
+});
+describe("analytics_engine_health — verdict (N76)", () => {
+    it("reads a Prometheus without any metrics of the fleet as unknown, never healthy", async () => {
+        const { client } = recordingClient();
+        const result = await run(client, {});
+        expect(result.status).toBe("unknown");
+        expect(result.silentEngines).toEqual(["prod-a", "prod-b"]);
+    });
+    it("reads a silent engine as unknown, not as an idle healthy one", async () => {
+        const { client } = recordingClient(onlyProdAReports);
+        const result = await run(client, { engine: "prod-b" });
+        expect(result).toMatchObject({
+            status: "unknown",
+            engines: ["prod-b"],
+            reportingEngines: [],
+            silentEngines: ["prod-b"],
+        });
+    });
+    it("degrades the fleet verdict while one configured engine is silent", async () => {
+        const { client } = recordingClient(onlyProdAReports);
+        const result = await run(client, {});
+        expect(result).toMatchObject({
+            status: "degraded",
+            reportingEngines: ["prod-a"],
+            silentEngines: ["prod-b"],
+        });
+    });
+});
+describe("analytics_engine_health — alerts (N76)", () => {
+    const alertQueries = (queries) => queries.filter((q) => q.includes("ALERTS"));
+    it("scopes one engine's verdict to that engine's alerts only", async () => {
+        const { client, queries } = recordingClient();
+        await run(client, { engine: "prod-a" });
+        expect(alertQueries(queries)).toEqual([
+            'ALERTS{alertstate="firing",engine_id="prod-a"}',
+            'ALERTS{alertstate="pending",engine_id="prod-a"}',
+        ]);
+    });
+    it.each([
+        ["engine omitted", {}, "prod-a|prod-b"],
+        ["every configured engine named", { engine: ["prod-b", "prod-a"] }, "prod-b|prod-a"],
+    ])("adds the module's own engine-less alerts to a verdict over the whole fleet (%s)", async (_case, args, ids) => {
+        const { client, queries } = recordingClient();
+        await run(client, args);
+        expect(alertQueries(queries)[0]).toBe(`ALERTS{alertstate="firing",engine_id=~"${ids}"} or ` +
+            'ALERTS{alertstate="firing",alertname=~"CibSeven.+",engine_id=""}');
+    });
+    it("never lets a foreign critical alert in a shared Prometheus decide the verdict", async () => {
+        // A critical alert of somebody else's rule, carrying no engine_id: the
+        // scoped selector cannot match it, so it never reaches the verdict.
+        const { client, queries } = recordingClient(onlyProdAReports);
+        const result = await run(client, { engine: "prod-a" });
+        expect(alertQueries(queries).some((q) => !q.includes('engine_id="prod-a"'))).toBe(false);
+        expect(result.status).toBe("healthy");
+    });
+});
+/**
+ * #340: two health tools judge different data by different rules — each
+ * states its own in the description AND the result, and routes to the other.
+ */
+describe("analytics_engine_health verdict labeling", () => {
+    it("carries the status rule — including the unknown verdict — in every result", async () => {
+        const { client } = recordingClient();
+        const result = await run(client, {});
+        expect(result.statusRule).toBe(ENGINE_HEALTH_STATUS_RULE);
+        expect(ENGINE_HEALTH_STATUS_RULE).toMatch(/^From Prometheus, over the engines in scope: unknown when none of them reports metrics;/);
+    });
+    it("states the rule, the engine scope and the routing to camunda7_show_engine_health", () => {
+        const { description } = captureConfig();
+        expect(description).toContain(`Status: ${ENGINE_HEALTH_STATUS_RULE}`);
+        expect(description).toContain("the silent ones (`silentEngines`");
+        expect(description).toContain("Use for fleet-wide or metric-based health; for one engine's live incident clusters use camunda7_show_engine_health.");
+    });
+});
+//# sourceMappingURL=health.test.js.map

package/dist/tools/health.test.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,18 @@
+import type { MCPServer } from "mcp-use";
+import type { PrometheusClient } from "@miragon/pulse-analytics-client";
+import type { ProfileSource } from "../server-locale.js";
+import type { AnalyticsEngineScope } from "../engine-ids.js";
+/**
+ * `profileStore` feeds the saved analytics defaults (`modules.analytics`) into
+ * every tool that takes `period`/`minBucketSize` — the same "explicit arg >
+ * saved setting > schema default" resolution as the widget tools, so the
+ * settings contract holds across the whole tool surface. The handlers pass the
+ * ctx the registrar hands them to `settingsFor`, so the caller resolves
+ * exactly like the settings tools' own (`resolveProfileKey`).
+ *
+ * `engineScope` holds the server's configured engine ids: every tool resolves
+ * its `engine` argument through it (omitted = all of them), so no query ever
+ * reads an engine this server is not configured for (`engine-ids.ts`).
+ */
+export declare function registerTools(server: MCPServer, client: PrometheusClient, engineScope: AnalyticsEngineScope, profileStore?: ProfileSource): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAU5D;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,oBAAoB,EACjC,YAAY,CAAC,EAAE,aAAa,GAC3B,IAAI,CAYN"}

package/dist/tools/index.js

@@ -0,0 +1,35 @@
+import { createToolRegistrar } from "@miragon/mcp-toolkit-core/tools";
+import { registerPerformanceTools } from "./performance.js";
+import { registerFailureTools } from "./failures.js";
+import { registerElementTools } from "./element.js";
+import { registerClusterCompareTools } from "./cluster-compare.js";
+import { registerVersionCompareTools } from "./version-compare.js";
+import { registerEngineCompareTools } from "./engine-compare.js";
+import { registerEngineLandscapeTools } from "./engine-landscape.js";
+import { registerHealthTools } from "./health.js";
+/**
+ * `profileStore` feeds the saved analytics defaults (`modules.analytics`) into
+ * every tool that takes `period`/`minBucketSize` — the same "explicit arg >
+ * saved setting > schema default" resolution as the widget tools, so the
+ * settings contract holds across the whole tool surface. The handlers pass the
+ * ctx the registrar hands them to `settingsFor`, so the caller resolves
+ * exactly like the settings tools' own (`resolveProfileKey`).
+ *
+ * `engineScope` holds the server's configured engine ids: every tool resolves
+ * its `engine` argument through it (omitted = all of them), so no query ever
+ * reads an engine this server is not configured for (`engine-ids.ts`).
+ */
+export function registerTools(server, client, engineScope, profileStore) {
+    // Strict input: an unknown (e.g. misnamed) key is a tool error naming the
+    // valid keys instead of a silently dropped filter (#329).
+    const register = createToolRegistrar(server, client, { strictInput: true });
+    registerPerformanceTools(register, engineScope, profileStore);
+    registerFailureTools(register, engineScope);
+    registerElementTools(register, engineScope, profileStore);
+    registerClusterCompareTools(register, engineScope, profileStore);
+    registerVersionCompareTools(register, engineScope, profileStore);
+    registerEngineCompareTools(register, engineScope, profileStore);
+    registerEngineLandscapeTools(register, engineScope);
+    registerHealthTools(register, engineScope);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAIrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,MAAwB,EACxB,WAAiC,EACjC,YAA4B;IAE5B,0EAA0E;IAC1E,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3E,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IAC7D,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAC3C,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IACzD,2BAA2B,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IAChE,2BAA2B,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IAChE,0BAA0B,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IAC/D,4BAA4B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IACnD,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;AAC5C,CAAC"}