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

package/dist/steps/dashboard.js

@@ -0,0 +1,58 @@
+import { PERIODS, queries } from "@miragon/pulse-analytics-client";
+import { analyticsSettingsSchema, settingsFor } from "../settings.js";
+import { NO_NAMES } from "../bpmn-name-lookup.js";
+import { namedDashboard } from "../named-views.js";
+import { ENGINE_KEY_DECLARATION, stepEngines, stepPeriod, stepProcessKey, } from "./app-config.js";
+import { builderText } from "../builder-texts.js";
+/** The period a caller without a saved default gets — the settings schema's default. */
+const MODULE_DEFAULT_PERIOD = analyticsSettingsSchema.shape.defaultPeriod.parse(undefined);
+/**
+ * Loads the dashboard figures from Prometheus — window flows plus the live
+ * state, the same `dashboardData` as `analytics_show_dashboard`. Consumed by
+ * `analytics:dashboard`. Reads optional filter keys:
+ * - `analytics:processDefinitionKey`
+ * - `analytics:period` (1d | 3d | 7d | 14d | 30d; omitted = the caller's saved default)
+ * - `analytics:engine` (configured engine id(s); omitted = all of them)
+ */
+export const loadDashboardStep = {
+    id: "analytics:load-dashboard",
+    ...builderText("step.load-dashboard"),
+    description: "Process metrics: what happened within a time window (instances started/completed, incidents created/resolved, durations of the instances that ended) plus the live state right now (instances running, incidents open), per process definition and per (process, activity). Powers the four dashboard widgets (execution-summary-kpi, execution-performance-kpi, process-definition-breakdown, activity-bottleneck-table).",
+    dataType: "analytics:dashboard",
+    requires: [],
+    optionalKeys: [
+        {
+            key: "analytics:processDefinitionKey",
+            description: "Scope the dashboard to a single process definition (e.g. 'miraveloLeasing'). When omitted, all processes are aggregated.",
+        },
+        {
+            key: "analytics:period",
+            description: `Time window. When omitted, the caller's saved analytics default (else '${MODULE_DEFAULT_PERIOD}').`,
+            enum: [...PERIODS],
+        },
+        ENGINE_KEY_DECLARATION,
+    ],
+    produces: ["analytics:dashboardData"],
+    execute: async (context, appConfig) => {
+        // Every key is checked before the first query is sent.
+        const processDefinitionKey = stepProcessKey(context.keys);
+        const engine = stepEngines(context.keys, appConfig.engineScope);
+        const period = await stepPeriod(context.keys, appConfig.profileStore);
+        // The floor for judging the incident rate against the previous period:
+        // the caller's saved minBucketSize, like the tools'.
+        const { minBucketSize } = await settingsFor(appConfig.profileStore);
+        const data = await namedDashboard(await queries.dashboardData(appConfig.client, {
+            processDefinitionKey,
+            period,
+            engine,
+            minBucketSize,
+        }), appConfig.namesFor ?? NO_NAMES);
+        return {
+            data,
+            keys: { "analytics:dashboardData": data },
+            _app: "analytics",
+            _step: "load-dashboard",
+        };
+    },
+};
+//# sourceMappingURL=dashboard.js.map

package/dist/steps/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/steps/dashboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,cAAc,GAEf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEjD,wFAAwF;AACxF,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AAE1F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA+C;IAC3E,EAAE,EAAE,0BAA0B;IAC9B,GAAG,WAAW,CAAC,qBAAqB,CAAC;IACrC,WAAW,EACT,4ZAA4Z;IAC9Z,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE;QACZ;YACE,GAAG,EAAE,gCAAgC;YACrC,WAAW,EACT,0HAA0H;SAC7H;QACD;YACE,GAAG,EAAE,kBAAkB;YACvB,WAAW,EAAE,0EAA0E,qBAAqB,KAAK;YACjH,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;SACnB;QACD,sBAAsB;KACvB;IACD,QAAQ,EAAE,CAAC,yBAAyB,CAAC;IACrC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;QACpC,uDAAuD;QACvD,MAAM,oBAAoB,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACzD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,CAAA;QAC/D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;QACrE,uEAAuE;QACvE,qDAAqD;QACrD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QAEnE,MAAM,IAAI,GAAG,MAAM,cAAc,CAC/B,MAAM,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE;YAC5C,oBAAoB;YACpB,MAAM;YACN,MAAM;YACN,aAAa;SACd,CAAC,EACF,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAC/B,CAAA;QAED,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,EAAE,yBAAyB,EAAE,IAAI,EAAE;YACzC,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,gBAAgB;SACxB,CAAA;IACH,CAAC;CACF,CAAA"}

package/dist/steps/failure-dashboard.d.ts

@@ -0,0 +1,10 @@
+import type { PipelineStepDefinition } from "@miragon/mcp-toolkit-core";
+import { type AnalyticsAppConfig } from "./app-config.js";
+/**
+ * Loads current failure / incident state from Prometheus for the
+ * failure-dashboard widgets. Point-in-time (live state gauges), so there is no
+ * time-window input. Reads the optional `analytics:engine` key (configured
+ * engine id(s); omitted = all of them).
+ */
+export declare const loadFailureDashboardStep: PipelineStepDefinition<AnalyticsAppConfig>;
+//# sourceMappingURL=failure-dashboard.d.ts.map

package/dist/steps/failure-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-dashboard.d.ts","sourceRoot":"","sources":["../../src/steps/failure-dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAEvE,OAAO,EAAuC,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAK9F;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,sBAAsB,CAAC,kBAAkB,CAwB/E,CAAA"}

package/dist/steps/failure-dashboard.js

@@ -0,0 +1,32 @@
+import { queries } from "@miragon/pulse-analytics-client";
+import { ENGINE_KEY_DECLARATION, stepEngines } from "./app-config.js";
+import { builderText } from "../builder-texts.js";
+import { NO_NAMES } from "../bpmn-name-lookup.js";
+import { namedFailureDashboard } from "../named-views.js";
+/**
+ * Loads current failure / incident state from Prometheus for the
+ * failure-dashboard widgets. Point-in-time (live state gauges), so there is no
+ * time-window input. Reads the optional `analytics:engine` key (configured
+ * engine id(s); omitted = all of them).
+ */
+export const loadFailureDashboardStep = {
+    id: "analytics:load-failure-dashboard",
+    ...builderText("step.load-failure-dashboard"),
+    description: "The incidents open right now, grouped by incident type and process definition, plus each affected process's running instances and dead jobs. Powers the failure widgets (failure-summary-kpi, failure-rate-table, error-patterns-table).",
+    dataType: "analytics:failureDashboard",
+    requires: [],
+    optionalKeys: [ENGINE_KEY_DECLARATION],
+    produces: ["analytics:failureDashboardData"],
+    execute: async (context, appConfig) => {
+        const data = await namedFailureDashboard(await queries.failureDashboardData(appConfig.client, {
+            engine: stepEngines(context.keys, appConfig.engineScope),
+        }), appConfig.namesFor ?? NO_NAMES);
+        return {
+            data,
+            keys: { "analytics:failureDashboardData": data },
+            _app: "analytics",
+            _step: "load-failure-dashboard",
+        };
+    },
+};
+//# sourceMappingURL=failure-dashboard.js.map

package/dist/steps/failure-dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-dashboard.js","sourceRoot":"","sources":["../../src/steps/failure-dashboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAA2B,MAAM,iBAAiB,CAAA;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA+C;IAClF,EAAE,EAAE,kCAAkC;IACtC,GAAG,WAAW,CAAC,6BAA6B,CAAC;IAC7C,WAAW,EACT,0OAA0O;IAC5O,QAAQ,EAAE,4BAA4B;IACtC,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,CAAC,sBAAsB,CAAC;IACtC,QAAQ,EAAE,CAAC,gCAAgC,CAAC;IAC5C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,MAAM,qBAAqB,CACtC,MAAM,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAAC,MAAM,EAAE;YACnD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC;SACzD,CAAC,EACF,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAC/B,CAAA;QAED,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,EAAE,gCAAgC,EAAE,IAAI,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,wBAAwB;SAChC,CAAA;IACH,CAAC;CACF,CAAA"}

package/dist/steps/index.d.ts

@@ -0,0 +1,3 @@
+export { loadDashboardStep } from "./dashboard.js";
+export { loadFailureDashboardStep } from "./failure-dashboard.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/steps/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/steps/index.js

@@ -0,0 +1,3 @@
+export { loadDashboardStep } from "./dashboard.js";
+export { loadFailureDashboardStep } from "./failure-dashboard.js";
+//# sourceMappingURL=index.js.map

package/dist/steps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/steps/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/steps/steps.test.d.ts

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

package/dist/steps/steps.test.d.ts.map

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

package/dist/steps/steps.test.js

@@ -0,0 +1,153 @@
+import { describe, expect, it } from "vitest";
+import { runWithMcpRequestInfo } from "@miragon/pulse-widget-shell/server";
+import { createEngineScope } from "../engine-ids.js";
+import { analyticsModule } from "../module.js";
+import { loadDashboardStep, loadFailureDashboardStep } from "./index.js";
+/**
+ * The analytics pipeline steps run under render-view / the dashboard builder,
+ * whose step keys are free-form (`z.record(z.string(), z.unknown())`) — no
+ * schema checks them before the step does. So the steps hold the line the
+ * tools' strict inputs hold: a malformed key is refused naming the key, never
+ * read as "omitted" (which for `analytics:engine` would silently widen one
+ * engine's view to the whole fleet).
+ */
+function recordingClient() {
+    const sent = [];
+    const ch = {
+        instant: (q) => {
+            sent.push(q);
+            return Promise.resolve([]);
+        },
+    };
+    return { ch, sent };
+}
+/** A profile store holding one signed-in user's saved analytics period. */
+const profileStore = {
+    get: (key) => Promise.resolve(key === "user-7" ? { modules: { analytics: { defaultPeriod: "30d" } } } : undefined),
+};
+function setup(withProfileStore = false) {
+    const { ch, sent } = recordingClient();
+    const appConfig = {
+        client: ch,
+        engineScope: createEngineScope(["prod-a", "prod-b"]),
+        ...(withProfileStore ? { profileStore } : {}),
+    };
+    return { appConfig, sent };
+}
+const context = (keys) => ({
+    steps: {},
+    keys,
+    errors: [],
+});
+const STEPS = [
+    ["analytics:load-dashboard", loadDashboardStep],
+    ["analytics:load-failure-dashboard", loadFailureDashboardStep],
+];
+/** Every engine id the `engine_id` matchers of `promql` admit. */
+const enginesRead = (sent) => new Set(sent.flatMap((q) => [...q.matchAll(/engine_id(=~?)"([^"]*)"/g)].flatMap((m) => m[1] === "=~" ? m[2].split("|") : [m[2]])));
+describe.each(STEPS)("%s — analytics:engine", (_id, step) => {
+    it("reads the whole configured fleet when the key is omitted", async () => {
+        const { appConfig, sent } = setup();
+        const out = await step.execute(context({}), appConfig);
+        expect(out.data.engines).toEqual(["prod-a", "prod-b"]);
+        expect([...enginesRead(sent)].sort()).toEqual(["prod-a", "prod-b"]);
+    });
+    it("reads exactly the configured engine(s) the key names", async () => {
+        const { appConfig, sent } = setup();
+        const out = await step.execute(context({ "analytics:engine": "prod-b" }), appConfig);
+        expect(out.data.engines).toEqual(["prod-b"]);
+        expect([...enginesRead(sent)]).toEqual(["prod-b"]);
+    });
+    it("refuses an engine this server is not configured for, before any query", async () => {
+        const { appConfig, sent } = setup();
+        await expect(step.execute(context({ "analytics:engine": "tenant-x" }), appConfig)).rejects.toThrow('Unknown engine "tenant-x"');
+        expect(sent).toEqual([]);
+    });
+    it.each([
+        ["a number", 7],
+        ["a list with a non-string id", ["prod-a", 7]],
+        ["null", null],
+        ["an object", { id: "prod-a" }],
+    ])("refuses %s instead of widening to the fleet", async (_label, raw) => {
+        const { appConfig, sent } = setup();
+        await expect(step.execute(context({ "analytics:engine": raw }), appConfig)).rejects.toThrow(/analytics:engine must be an engine id or a list of engine ids/);
+        expect(sent).toEqual([]);
+    });
+});
+describe("the plugin wires the steps' caller lookup", () => {
+    it("hands the steps the profile store and installs the ambient request info they read", () => {
+        const patterns = [];
+        const server = {
+            tool: () => { },
+            use: (pattern) => {
+                patterns.push(pattern);
+            },
+        };
+        const plugin = analyticsModule.createPlugin({ url: "http://prometheus.invalid" }, { profileStore, engineIds: ["prod-a"] });
+        plugin.registerTools?.(server);
+        expect(plugin.appConfig.profileStore).toBe(profileStore);
+        // A step gets no handler ctx: without this middleware its caller lookup
+        // finds no identity and every saved period silently reads as the default.
+        expect(patterns).toEqual(["mcp:*"]);
+    });
+    it("hands the steps the name lookup over the injected BPMN lookup", async () => {
+        const xml = '<definitions><process id="order" name="Order fulfillment"/></definitions>';
+        const plugin = analyticsModule.createPlugin({ url: "http://prometheus.invalid" }, { profileStore, engineIds: ["prod-a"], fetchBpmnXml: () => Promise.resolve(xml) });
+        const { namesFor } = plugin.appConfig;
+        expect(await namesFor(["order"])).toEqual({
+            order: { name: "Order fulfillment", elements: {} },
+        });
+    });
+});
+describe.each(STEPS)("%s — the names behind the ids", (_id, step) => {
+    it("passes its figures through the view's name lookup", async () => {
+        const names = { order: { name: "Order fulfillment", elements: {} } };
+        const { appConfig } = setup();
+        const out = await step.execute(context({}), {
+            ...appConfig,
+            namesFor: () => Promise.resolve(names),
+        });
+        expect(out.data.names).toEqual(names);
+    });
+    it("shows ids when the server has no lookup", async () => {
+        const out = await step.execute(context({}), setup().appConfig);
+        expect(out.data.names).toEqual({});
+    });
+});
+describe("analytics:load-dashboard — analytics:period", () => {
+    // The windows read — not the hour the born-series check looks at (`[1h] offset …`).
+    const windows = (sent) => new Set(sent.flatMap((q) => [...q.matchAll(/\[(\w+)\](?!(?: @ \d+)? offset)/g)].map((m) => m[1])));
+    it("takes the caller's SAVED period when the key is omitted (N83/N116)", async () => {
+        const { appConfig, sent } = setup(true);
+        const out = await runWithMcpRequestInfo({ authUserId: "user-7" }, () => loadDashboardStep.execute(context({}), appConfig));
+        expect(out.data.period).toBe("30d");
+        expect([...windows(sent)]).toEqual(["30d"]);
+    });
+    it("falls back to the module default without a caller or a saved period", async () => {
+        const { appConfig } = setup(true);
+        const anonymous = await runWithMcpRequestInfo({}, () => loadDashboardStep.execute(context({}), appConfig));
+        const storeless = await loadDashboardStep.execute(context({}), setup().appConfig);
+        expect(anonymous.data.period).toBe("7d");
+        expect(storeless.data.period).toBe("7d");
+    });
+    it("lets an explicit period win over the saved one", async () => {
+        const { appConfig } = setup(true);
+        const out = await runWithMcpRequestInfo({ authUserId: "user-7" }, () => loadDashboardStep.execute(context({ "analytics:period": "1d" }), appConfig));
+        expect(out.data.period).toBe("1d");
+    });
+    it.each([
+        ["an unknown period", "90d"],
+        ["a number", 7],
+        ["null", null],
+    ])("refuses %s instead of substituting a default", async (_label, raw) => {
+        const { appConfig, sent } = setup();
+        await expect(loadDashboardStep.execute(context({ "analytics:period": raw }), appConfig)).rejects.toThrow(/analytics:period must be one of 1d, 3d, 7d, 14d, 30d/);
+        expect(sent).toEqual([]);
+    });
+    it("refuses a non-string process key, naming the key", async () => {
+        const { appConfig, sent } = setup();
+        await expect(loadDashboardStep.execute(context({ "analytics:processDefinitionKey": 7 }), appConfig)).rejects.toThrow(/analytics:processDefinitionKey must be a process definition key/);
+        expect(sent).toEqual([]);
+    });
+});
+//# sourceMappingURL=steps.test.js.map

package/dist/steps/steps.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.test.js","sourceRoot":"","sources":["../../src/steps/steps.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAE1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAExE;;;;;;;GAOG;AAEH,SAAS,eAAe;IACtB,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,MAAM,EAAE,GAAqB;QAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACb,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACZ,OAAO,OAAO,CAAC,OAAO,CAAe,EAAE,CAAC,CAAA;QAC1C,CAAC;KACF,CAAA;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;AACrB,CAAC;AAED,2EAA2E;AAC3E,MAAM,YAAY,GAAkB;IAClC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CACX,OAAO,CAAC,OAAO,CACb,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CACpF;CACJ,CAAA;AAED,SAAS,KAAK,CAAC,gBAAgB,GAAG,KAAK;IACrC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,eAAe,EAAE,CAAA;IACtC,MAAM,SAAS,GAAuB;QACpC,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,iBAAiB,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACpD,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAA;IACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,IAA6B,EAAmB,EAAE,CAAC,CAAC;IACnE,KAAK,EAAE,EAAE;IACT,IAAI;IACJ,MAAM,EAAE,EAAE;CACX,CAAC,CAAA;AAEF,MAAM,KAAK,GAAG;IACZ,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;IAC/C,CAAC,kCAAkC,EAAE,wBAAwB,CAAC;CACtD,CAAA;AAEV,kEAAkE;AAClE,MAAM,WAAW,GAAG,CAAC,IAAc,EAAE,EAAE,CACrC,IAAI,GAAG,CACL,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACjB,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACxD,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACzC,CACF,CACF,CAAA;AAEH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,uBAAuB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IAC1D,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;QACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;QAEtD,MAAM,CAAE,GAAG,CAAC,IAA8B,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;QACjF,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;QACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;QAEpF,MAAM,CAAE,GAAG,CAAC,IAA8B,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACvE,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;QACnC,MAAM,MAAM,CACV,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,CAAC,CACrE,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAA;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,UAAU,EAAE,CAAC,CAAC;QACf,CAAC,6BAA6B,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,MAAM,EAAE,IAAI,CAAC;QACd,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;KAChC,CAAC,CAAC,6CAA6C,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QACtE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;QACnC,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACzF,+DAA+D,CAChE,CAAA;QACD,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,GAAG,EAAE,CAAC,OAAe,EAAE,EAAE;gBACvB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACxB,CAAC;SACsB,CAAA;QACzB,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CACzC,EAAE,GAAG,EAAE,2BAA2B,EAAE,EACpC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,CACxC,CAAA;QACD,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAA;QAE9B,MAAM,CAAE,MAAM,CAAC,SAA2C,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC3F,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,GAAG,GAAG,2EAA2E,CAAA;QACvF,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CACzC,EAAE,GAAG,EAAE,2BAA2B,EAAE,EACpC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAClF,CAAA;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,SAA0C,CAAA;QACtE,MAAM,CAAC,MAAM,QAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACzC,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,EAAE;SACnD,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,+BAA+B,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IAClE,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAA;QACpE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAA;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;YAC1C,GAAG,SAAS;YACZ,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;SACvC,CAAC,CAAA;QACF,MAAM,CAAE,GAAG,CAAC,IAA2B,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,CAAA;QAC9D,MAAM,CAAE,GAAG,CAAC,IAA2B,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;IAC3D,oFAAoF;IACpF,MAAM,OAAO,GAAG,CAAC,IAAc,EAAE,EAAE,CACjC,IAAI,GAAG,CACL,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1F,CAAA;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CACrE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAClD,CAAA;QAED,MAAM,CAAE,GAAG,CAAC,IAA2B,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3D,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,EAAE,EAAE,GAAG,EAAE,CACrD,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAClD,CAAA;QACD,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,CAAA;QAEjF,MAAM,CAAE,SAAS,CAAC,IAA2B,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChE,MAAM,CAAE,SAAS,CAAC,IAA2B,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CACrE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAC5E,CAAA;QACD,MAAM,CAAE,GAAG,CAAC,IAA2B,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,mBAAmB,EAAE,KAAK,CAAC;QAC5B,CAAC,UAAU,EAAE,CAAC,CAAC;QACf,CAAC,MAAM,EAAE,IAAI,CAAC;KACf,CAAC,CAAC,8CAA8C,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QACvE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;QACnC,MAAM,MAAM,CACV,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,CAAC,CAC3E,CAAC,OAAO,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAA;QACzE,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;QACnC,MAAM,MAAM,CACV,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,gCAAgC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CACvF,CAAC,OAAO,CAAC,OAAO,CAAC,iEAAiE,CAAC,CAAA;QACpF,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tool-names.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Names of the analytics widget tools referenced from widget code, so a tool
+ * rename in `widget-tools.ts` trips a TS error at every call site (same rule
+ * as the camunda7 module's tool-names.ts).
+ */
+export declare const ANALYTICS_DASHBOARD_DATA = "analytics_dashboard_data";
+export declare const ANALYTICS_FAILURE_DASHBOARD_DATA = "analytics_failure_dashboard_data";
+export declare const ANALYTICS_BPMN_HEATMAP_DATA = "analytics_bpmn_heatmap_data";
+export declare const ANALYTICS_BPMN_XML_DATA = "analytics_bpmn_xml_data";
+export declare const ANALYTICS_ENGINE_LANDSCAPE_DATA = "analytics_engine_landscape_data";
+export declare const ANALYTICS_SETTINGS_DATA = "analytics_settings_data";
+export declare const ANALYTICS_SAVE_SETTINGS = "analytics_save_settings";
+//# sourceMappingURL=tool-names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,gCAAgC,qCAAqC,CAAA;AAGlF,eAAO,MAAM,2BAA2B,gCAAgC,CAAA;AAIxE,eAAO,MAAM,uBAAuB,4BAA4B,CAAA;AAIhE,eAAO,MAAM,+BAA+B,oCAAoC,CAAA;AAGhF,eAAO,MAAM,uBAAuB,4BAA4B,CAAA;AAChE,eAAO,MAAM,uBAAuB,4BAA4B,CAAA"}

package/dist/tool-names.js

@@ -0,0 +1,27 @@
+/**
+ * Names of the analytics widget tools referenced from widget code, so a tool
+ * rename in `widget-tools.ts` trips a TS error at every call site (same rule
+ * as the camunda7 module's tool-names.ts).
+ */
+// Per-view data-only feeds (no UI, app-only via `visibility: "app"`) backing
+// each widget's own self-fetch. A widget tool (view-bound) can't be used for
+// this: the host renders it instead of returning data to the in-widget
+// callTool().
+export const ANALYTICS_DASHBOARD_DATA = "analytics_dashboard_data";
+export const ANALYTICS_FAILURE_DASHBOARD_DATA = "analytics_failure_dashboard_data";
+// Cross-module consumers (camunda7's process-incidents flow) reference this
+// feed by raw string with graceful degradation — keep the name stable.
+export const ANALYTICS_BPMN_HEATMAP_DATA = "analytics_bpmn_heatmap_data";
+// The latest deployed diagram of a process key, for the heatmap view: never
+// inside the heat payload, so the model never reads the XML and the heat
+// values refresh without it.
+export const ANALYTICS_BPMN_XML_DATA = "analytics_bpmn_xml_data";
+// Backs the cross-engine landscape widget's self-fetch. Also referenced by
+// camunda7's cross-engine cockpit mode through the widget id (tier-2), so the
+// section disappears with the module instead of erroring.
+export const ANALYTICS_ENGINE_LANDSCAPE_DATA = "analytics_engine_landscape_data";
+// Settings section: the widget self-fetches the feed and writes via the save
+// tool; both live in settings-tools.ts.
+export const ANALYTICS_SETTINGS_DATA = "analytics_settings_data";
+export const ANALYTICS_SAVE_SETTINGS = "analytics_save_settings";
+//# sourceMappingURL=tool-names.js.map

package/dist/tool-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-names.js","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,6EAA6E;AAC7E,6EAA6E;AAC7E,uEAAuE;AACvE,cAAc;AACd,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAClE,MAAM,CAAC,MAAM,gCAAgC,GAAG,kCAAkC,CAAA;AAClF,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,CAAC,MAAM,2BAA2B,GAAG,6BAA6B,CAAA;AACxE,4EAA4E;AAC5E,yEAAyE;AACzE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAA;AAChE,2EAA2E;AAC3E,8EAA8E;AAC9E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,iCAAiC,CAAA;AAChF,6EAA6E;AAC7E,wCAAwC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAA;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-compare.d.ts","sourceRoot":"","sources":["../../src/tools/cluster-compare.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,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE7E,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAExE,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,oBAAoB,EACjC,YAAY,CAAC,EAAE,aAAa,QAe7B"}

package/dist/tools/cluster-compare.js

@@ -0,0 +1,17 @@
+import { schemas, queries } from "@miragon/pulse-analytics-client";
+import { optionalMinBucketSize, settingsFor } from "../settings.js";
+import { withEngineScope } from "../engine-ids.js";
+export function registerClusterCompareTools(register, engineScope, profileStore) {
+    register({
+        name: "analytics_cluster_compare",
+        category: "analytics",
+        description: "Pre/Post deployment correlation from metrics. Given a deployment timestamp and windows before/after, compute instance KPIs per window and the delta, using PromQL historical windows. Windows are clamped to now and the 30-day retention and reported as measured (`windowDays`, `partial`) — right after a deploy the post window holds only the elapsed time; starts compare per day. Results are flagged `suppressed` if either window has fewer than minBucketSize started or completed instances. Typical flow: commit-hash → camunda7_get_deployment → deployment.timestamp → this tool.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: { ...schemas.clusterCompareInput.shape, minBucketSize: optionalMinBucketSize },
+        handler: async (ch, args, ctx) => queries.clusterCompare(ch, {
+            ...withEngineScope(engineScope, args),
+            minBucketSize: args.minBucketSize ?? (await settingsFor(profileStore, ctx)).minBucketSize,
+        }),
+    });
+}
+//# sourceMappingURL=cluster-compare.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-compare.js","sourceRoot":"","sources":["../../src/tools/cluster-compare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAGlE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,eAAe,EAA6B,MAAM,kBAAkB,CAAA;AAI7E,MAAM,UAAU,2BAA2B,CACzC,QAAkB,EAClB,WAAiC,EACjC,YAA4B;IAE5B,QAAQ,CAAC;QACP,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,ikBAAikB;QACnkB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9E,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE;QAC3F,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAC/B,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE;YACzB,GAAG,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC;YACrC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,WAAW,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa;SAC1F,CAAC;KACL,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/element.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../src/tools/element.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,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE7E,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAExE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,oBAAoB,EACjC,YAAY,CAAC,EAAE,aAAa,QAsB7B"}

package/dist/tools/element.js

@@ -0,0 +1,25 @@
+import { schemas, queries } from "@miragon/pulse-analytics-client";
+import { optionalMinBucketSize, optionalPeriod, settingsFor } from "../settings.js";
+import { withEngineScope } from "../engine-ids.js";
+export function registerElementTools(register, engineScope, profileStore) {
+    register({
+        name: "analytics_element_bottleneck",
+        category: "analytics",
+        description: "Rank activities by execution-time contribution and incident rate over a rolling window, from process metrics. Activities with fewer than `minBucketSize` executions are suppressed. Note: queue/wait time is not available from metrics.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: {
+            ...schemas.elementBottleneckInput.shape,
+            period: optionalPeriod,
+            minBucketSize: optionalMinBucketSize,
+        },
+        handler: async (ch, args, ctx) => {
+            const settings = await settingsFor(profileStore, ctx);
+            return queries.elementBottleneck(ch, {
+                ...withEngineScope(engineScope, args),
+                period: args.period ?? settings.defaultPeriod,
+                minBucketSize: args.minBucketSize ?? settings.minBucketSize,
+            });
+        },
+    });
+}
+//# sourceMappingURL=element.js.map

package/dist/tools/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../../src/tools/element.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAGlE,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,eAAe,EAA6B,MAAM,kBAAkB,CAAA;AAI7E,MAAM,UAAU,oBAAoB,CAClC,QAAkB,EAClB,WAAiC,EACjC,YAA4B;IAE5B,QAAQ,CAAC;QACP,IAAI,EAAE,8BAA8B;QACpC,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,0OAA0O;QAC5O,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9E,WAAW,EAAE;YACX,GAAG,OAAO,CAAC,sBAAsB,CAAC,KAAK;YACvC,MAAM,EAAE,cAAc;YACtB,aAAa,EAAE,qBAAqB;SACrC;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC/B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,GAAG,CAAC,CAAA;YACrD,OAAO,OAAO,CAAC,iBAAiB,CAAC,EAAE,EAAE;gBACnC,GAAG,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC;gBACrC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,aAAa;gBAC7C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa;aAC5D,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-compare.d.ts","sourceRoot":"","sources":["../../src/tools/engine-compare.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,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE5D,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAExE,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,oBAAoB,EACjC,YAAY,CAAC,EAAE,aAAa,QAiB7B"}

package/dist/tools/engine-compare.js

@@ -0,0 +1,18 @@
+import { schemas, queries } from "@miragon/pulse-analytics-client";
+import { optionalMinBucketSize, settingsFor } from "../settings.js";
+export function registerEngineCompareTools(register, engineScope, profileStore) {
+    register({
+        name: "analytics_engine_compare",
+        category: "analytics",
+        description: "Compare ONE process definition as it runs on two configured CIB Seven engines (e.g. prod-a vs prod-b) over a shared rolling window, from metrics. processDefinitionKey is required: engines host different process mixes, so comparing their whole workloads would measure the mix rather than the engines — holding the process fixed is what makes the delta attributable. Returns per engine starts, completions, incidents per 100 starts (with activityId also at that element) and avg/p95 duration of the instances that ENDED, plus the deltas. Flagged `suppressed` when either engine has fewer than minBucketSize started or completed instances. For the unscoped cross-engine picture (what runs where, load, job backlog, which keys are deployed on several engines) use analytics_engine_landscape first; its `sharedProcessKeys` are the valid inputs here.",
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        inputSchema: { ...schemas.engineCompareInput.shape, minBucketSize: optionalMinBucketSize },
+        handler: async (ch, args, ctx) => queries.engineCompare(ch, {
+            ...args,
+            engineA: engineScope.require(args.engineA, "engineA"),
+            engineB: engineScope.require(args.engineB, "engineB"),
+            minBucketSize: args.minBucketSize ?? (await settingsFor(profileStore, ctx)).minBucketSize,
+        }),
+    });
+}
+//# sourceMappingURL=engine-compare.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-compare.js","sourceRoot":"","sources":["../../src/tools/engine-compare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAGlE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAKnE,MAAM,UAAU,0BAA0B,CACxC,QAAkB,EAClB,WAAiC,EACjC,YAA4B;IAE5B,QAAQ,CAAC;QACP,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,80BAA80B;QACh1B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9E,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE;QAC1F,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAC/B,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE;YACxB,GAAG,IAAI;YACP,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;YACrD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;YACrD,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,WAAW,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa;SAC1F,CAAC;KACL,CAAC,CAAA;AACJ,CAAC"}

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

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

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

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