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

package/src/messages/de.sweep.ts

@@ -0,0 +1,244 @@
+import type { MessageCatalog } from "@miragon/mcp-toolkit-core"
+import { plural } from "./plural.js"
+
+/**
+ * German catalog of the analytics widgets, same keys as `en.sweep.ts`. It
+ * follows brand-tone fully: du, AI (never KI), CIB seven, no dash as a
+ * connector, errors say what happened and what you can do, and the terms of
+ * GLOSSARY.md ("Incident", never "Vorfall"). `brand-gates.test.ts` and
+ * `glossary.test.ts` check it. Merged into the catalogs in index.ts.
+ */
+export const deSweep: MessageCatalog = {
+  "aActivityType.boundaryEvent": "Grenzereignis",
+  "aActivityType.businessRuleTask": "Business-Rule-Task",
+  "aActivityType.callActivity": "Call Activity",
+  "aActivityType.endEvent": "Endereignis",
+  "aActivityType.eventBasedGateway": "Ereignisbasiertes Gateway",
+  "aActivityType.exclusiveGateway": "Exklusives Gateway",
+  "aActivityType.inclusiveGateway": "Inklusives Gateway",
+  "aActivityType.intermediateEvent": "Zwischenereignis",
+  "aActivityType.manualTask": "Manueller Task",
+  "aActivityType.parallelGateway": "Paralleles Gateway",
+  "aActivityType.receiveTask": "Receive-Task",
+  "aActivityType.scriptTask": "Script-Task",
+  "aActivityType.sendTask": "Send-Task",
+  "aActivityType.serviceTask": "Service-Task",
+  "aActivityType.startEvent": "Startereignis",
+  "aActivityType.subProcess": "Teilprozess",
+  "aActivityType.task": "Task",
+  "aActivityType.userTask": "User-Task",
+  "aBottleneck.colActivity": "Aktivität",
+  "aBottleneck.colAvg": "Durchschn.",
+  "aBottleneck.colExecutions": "Ausführungen",
+  "aBottleneck.colP95": "P95",
+  "aBottleneck.colTotalTime": "Gesamtzeit",
+  "aBottleneck.emptyHint":
+    "Wähl einen längeren Zeitraum oder prüf, ob die Engines Metriken melden.",
+  "aBottleneck.emptyState": "In diesem Zeitraum hat keine Aktivität geendet",
+  "aBottleneck.heading": "Aktivitäten nach Gesamtzeit",
+  "aBottleneck.headingTop": "Top {count} nach Gesamtzeit",
+  "aBottleneck.tableLabel": "Aktivitäten je Prozess, sortiert nach gesamter Ausführungszeit",
+  "aBottleneck.topNote": plural(
+    "count",
+    "Die Aktivität mit der meisten Gesamtzeit, von {total}.",
+    "Die {count} Aktivitäten mit der meisten Gesamtzeit, von {total}.",
+  ),
+  "aClusterCompare.afterLabel": "Nachher",
+  "aClusterCompare.beforeLabel": "Vorher",
+  "aClusterCompare.deployBadge": "Deployment: {timestamp}",
+  "aClusterCompare.elementBadge": "Element: {activityId}",
+  "aClusterCompare.incompleteData":
+    "Für eine Seite des Vergleichs fehlen die Kennzahlen. Wähl längere Zeiträume um das Deployment.",
+  "aClusterCompare.insufficientSignal": plural(
+    "minBucketSize",
+    "Zu wenig Daten: weniger als 1 Instanz je Seite",
+    "Zu wenig Daten: weniger als {minBucketSize} Instanzen je Seite",
+  ),
+  "aClusterCompare.noData":
+    "Für dieses Deployment gibt es keine Kennzahlen. Prüf den Zeitpunkt oder wähl längere Zeiträume.",
+  "aClusterCompare.partialBadge": "Zeitraum gekürzt",
+  "aClusterCompare.period": "{before} davor, {after} danach",
+  "aClusterCompare.tableLabel": "Kennzahlen vor und nach dem Deployment",
+  "aClusterCompare.title": "Vor und nach dem Deployment",
+  "aCommon.days": plural("count", "1 Tag", "{count} Tage"),
+  "aCommon.hours": plural("count", "1 Stunde", "{count} Stunden"),
+  "aCommon.loadError": "Die Kennzahlen konnten nicht geladen werden.",
+  "aCommon.minutes": plural("count", "1 Minute", "{count} Minuten"),
+  "aCommon.underOneMinute": "unter 1 Minute",
+  "aComparison.deltaBetter": "besser",
+  "aComparison.deltaColumnHeader": "Änderung",
+  "aComparison.deltaNotReliable": "nicht belastbar",
+  "aComparison.deltaWorse": "schlechter",
+  "aComparison.metricAvgDuration": "Durchschnittliche Dauer",
+  "aComparison.metricColumnHeader": "Kennzahl",
+  "aComparison.metricElementIncidentRate": "Incidents je 100 Starts am Element",
+  "aComparison.metricIncidentRate": "Incidents je 100 Starts",
+  "aComparison.metricP95Duration": "P95-Dauer",
+  "aComparison.metricStarted": "Starts (Änderung je Tag)",
+  "aComparison.valueUnavailable": "nicht gemessen",
+  "aDefBreakdown.colAvgDuration": "Durchschn. Dauer",
+  "aDefBreakdown.colCompleted": "Abgeschlossen",
+  "aDefBreakdown.colIncidents": "Neue Incidents",
+  "aDefBreakdown.colProcess": "Prozess",
+  "aDefBreakdown.colRunningNow": "Laufen gerade",
+  "aDefBreakdown.colStarted": "Gestartet",
+  "aDefBreakdown.emptyHint":
+    "Wähl einen längeren Zeitraum oder prüf, ob die Engines Metriken melden.",
+  "aDefBreakdown.emptyState": "In diesem Zeitraum ist kein Prozess gestartet oder gelaufen",
+  "aDefBreakdown.heading": "Nach Prozessdefinition",
+  "aDefBreakdown.tableLabel": "Starts, Abschlüsse, laufende Instanzen und Incidents je Prozess",
+  "aEngineCompare.elementBadge": "Element: {id}",
+  "aEngineCompare.emptyIncomplete":
+    "Eine Engine hat für diesen Prozess keine Kennzahlen geliefert. Prüf, ob beide Engines ihn ausführen, oder wähl einen längeren Zeitraum.",
+  "aEngineCompare.emptyNoData":
+    "Für diesen Prozess gibt es auf diesen Engines keine Kennzahlen. Prüf, ob beide Engines ihn ausführen, oder wähl einen längeren Zeitraum.",
+  "aEngineCompare.enginesBadge": "{engineA} → {engineB}",
+  "aEngineCompare.suppressed": plural(
+    "min",
+    "Zu wenig Daten: weniger als 1 Instanz je Engine",
+    "Zu wenig Daten: weniger als {min} Instanzen je Engine",
+  ),
+  "aEngineCompare.tableLabel": "Kennzahlen eines Prozesses auf zwei Engines",
+  "aEngineCompare.title": "Engine-Vergleich",
+  "aErrorPatterns.columnAi": "Übergabe an den Chat",
+  "aErrorPatterns.columnCount": "Offen",
+  "aErrorPatterns.columnIncidentType": "Incident-Typ",
+  "aErrorPatterns.columnProcess": "Prozess",
+  "aErrorPatterns.emptyDescription": "Gerade ist kein Incident offen.",
+  "aErrorPatterns.emptyNoPatterns": "Gerade gibt es keine offenen Incident-Gruppen.",
+  "aErrorPatterns.emptyTitle": "Keine offenen Incidents",
+  "aErrorPatterns.heading": "Offene Incidents nach Typ",
+  "aErrorPatterns.tableAriaLabel": "Offene Incidents nach Incident-Typ und Prozess",
+  "aExecPerf.avgDuration": "Durchschn. Dauer",
+  "aExecPerf.headerLabel": "Ausführungsleistung",
+  "aExecPerf.incidentRate": "Incidents je 100 Starts",
+  "aExecPerf.median": "Median",
+  "aExecPerf.p95": "P95",
+  "aExecPerf.previous": "Vorperiode: {value}",
+  "aExecPerf.previousJudged": "Vorperiode: {value}, {verdict}",
+  "aExecPerf.previousNoStarts": "Vorperiode: keine Starts",
+  "aExecSummary.cellCompleted": "Abgeschlossen",
+  "aExecSummary.cellIncidentsCreated": "Neue Incidents",
+  "aExecSummary.cellOpenIncidentsNow": "Offene Incidents jetzt",
+  "aExecSummary.cellRunningNow": "Laufen gerade",
+  "aExecSummary.cellStarted": "Gestartet",
+  "aExecSummary.headerExecutionSummary": "Ausführungsübersicht",
+  "aExecSummary.title": "Prozessanalyse",
+  "aFailureRate.colAi": "Übergabe an den Chat",
+  "aFailureRate.colDeadJobs": "Jobs ohne Versuche",
+  "aFailureRate.colIncidentRate": "Incidents je 100 laufende Instanzen",
+  "aFailureRate.colOpenIncidents": "Offene Incidents",
+  "aFailureRate.colProcess": "Prozess",
+  "aFailureRate.colRunningNow": "Laufen gerade",
+  "aFailureRate.emptyState": "Gerade hat kein Prozess offene Incidents.",
+  "aFailureRate.heading": "Offene Incidents nach Prozess",
+  "aFailureRate.tableLabel": "Offene Incidents je 100 laufende Instanzen nach Prozessdefinition",
+  "aFailureSummary.mostAffected": "Am stärksten betroffen",
+  "aFailureSummary.mostAffectedNone": "Kein Prozess",
+  "aFailureSummary.summaryAriaLabel": "Zusammenfassung der Fehleranalyse",
+  "aFailureSummary.title": "Fehleranalyse",
+  "aFailureSummary.totalIncidents": "Offene Incidents",
+  "aFailureSummary.uniqueErrorPatterns": "Incident-Gruppen",
+  "aFigure.noRate": "Keine laufende Instanz gemeldet: keine Quote",
+  "aFigure.notReported": "Keine Engine meldet diesen Wert: unbekannt",
+  "aFigure.nothingEnded": "In diesem Zeitraum ist nichts beendet: keine Dauer",
+  "aHeatmap.bpmnNoCamunda7":
+    "Das Diagramm ist hier nicht verfügbar: Ohne das camunda7-Modul kann Analytics keine BPMN-Dateien laden. Frag im Chat stattdessen nach den Kennzahlen je Aktivität.",
+  "aHeatmap.bpmnNotLoaded":
+    "Das Diagramm konnte nicht geladen werden: Keine Engine dieser Ansicht hat es geliefert. Prüf, ob die Engines erreichbar sind und der Prozess bereitgestellt ist, oder frag im Chat nach den Kennzahlen je Aktivität.",
+  "aHeatmap.bpmnUnavailable":
+    "Das Diagramm konnte nicht geladen werden. Frag im Chat stattdessen nach den Kennzahlen je Aktivität.",
+  "aHeatmap.diagramAria": "BPMN-Diagramm mit der Ausführungshäufigkeit je Element als Heatmap",
+  "aHeatmap.duration": "Dauer",
+  "aHeatmap.durationLegend": "Durchschnittliche Dauer je Element",
+  "aHeatmap.errorHint": "Frag im Chat noch mal nach der Heatmap.",
+  "aHeatmap.errorTitle": "Das Diagramm konnte nicht gezeichnet werden.",
+  "aHeatmap.frequency": "Häufigkeit",
+  "aHeatmap.frequencyLegend": "Ausführungen je Element",
+  "aHeatmap.less": "Weniger",
+  "aHeatmap.more": "Mehr",
+  "aHeatmap.noData":
+    "Für diesen Prozess gibt es keine Heatmap-Daten. Prüf den Prozessschlüssel oder wähl einen längeren Zeitraum.",
+  "aHeatmap.noHeat": "In diesem Zeitraum ist kein Element gelaufen. Wähl einen längeren Zeitraum.",
+  "aHeatmap.title": "BPMN-Heatmap",
+  "aHeatmap.window": "Zeitraum:",
+  "aLandscape.colCompare": "Engine-Vergleich",
+  "aLandscape.colDueFuture": "Später fällig",
+  "aLandscape.colEngine": "Engine",
+  "aLandscape.colExecutable": "Ausführbare Jobs",
+  "aLandscape.colExternalTasks": "External Tasks",
+  "aLandscape.colFailedJobs": "Jobs ohne Versuche",
+  "aLandscape.colIncidents": "Incidents",
+  "aLandscape.colProcess": "Prozessdefinition",
+  "aLandscape.colProcesses": "Definitionen",
+  "aLandscape.colRunning": "Laufend",
+  "aLandscape.colSuspended": "Ausgesetzte Jobs",
+  "aLandscape.compareLabel": "„{key}“ im Chat zwischen seinen Engines vergleichen",
+  "aLandscape.emptyEngines":
+    "Keine Engine meldet Metriken. Prüf, ob das Metrik-Plugin auf den Engines läuft und Prometheus sie abfragt.",
+  "aLandscape.emptyProcesses":
+    "Keine Engine meldet eine Prozessdefinition. Prüf, ob die Engines Metriken melden.",
+  "aLandscape.engines.hint": "absolute Last und Job-Rückstand",
+  "aLandscape.engines.tableLabel": "Last und Job-Rückstand je Engine",
+  "aLandscape.engines.title": "Je Engine",
+  "aLandscape.exclusiveSuffix": "({count} nur hier)",
+  "aLandscape.groupBacklog": "Job-Rückstand, über Engines vergleichbar",
+  "aLandscape.groupLoad": "Last (absolut)",
+  "aLandscape.heading": "Engine-übergreifende Übersicht",
+  "aLandscape.headingHint": "Was wo läuft. Keine Rangliste der Engines.",
+  "aLandscape.kpiEngines": "Engines",
+  "aLandscape.kpiEnginesSilent": "{count} ohne Metriken",
+  "aLandscape.kpiIncidents": "Offene Incidents",
+  "aLandscape.kpiProcesses": "Prozessdefinitionen",
+  "aLandscape.kpiProcessesShared": "{count} auf mehreren Engines",
+  "aLandscape.kpiRunning": "Laufende Instanzen",
+  "aLandscape.legendNotDeployed":
+    "Eine leere Zelle heißt: Der Prozess ist auf dieser Engine nicht bereitgestellt.",
+  "aLandscape.matrix.hint": "laufende Instanzen je Engine",
+  "aLandscape.matrix.tableLabel": "Prozessdefinitionen nach Engine",
+  "aLandscape.matrix.title": "Was wo läuft",
+  "aLandscape.mixNote":
+    "Auf den Engines laufen unterschiedliche Prozesse. Fehlerquoten und Laufzeiten einer Engine beschreiben deshalb ihren Prozess-Mix und nicht die Engine selbst, also zeigt diese Ansicht absolute Zahlen. Kennzahlen vergleichen kannst du nur für Definitionen, die auf mehr als einer Engine laufen.",
+  "aLandscape.noMetrics": "keine Metriken",
+  "aLandscape.notDeployed": "auf dieser Engine nicht bereitgestellt",
+  "aLandscape.sharedBadge": plural("count", "auf 1 Engine", "auf {count} Engines"),
+  "aLandscape.silentNote": plural(
+    "count",
+    "Keine Spalte für {engines}: Diese Engine meldet keine Metriken.",
+    "Keine Spalten für {engines}: Diese Engines melden keine Metriken.",
+  ),
+  "aLandscape.unknown": "Keine Metriken von dieser Engine: Wert unbekannt",
+  "aSettings.heading": "Analyse-Einstellungen",
+  "aSettings.loadError": "Die Einstellungen konnten nicht geladen werden.",
+  "aSettings.minBucket": "Mindestgröße für Vergleiche",
+  "aSettings.minBucket.help":
+    "So viele Instanzen braucht jede Seite eines Vergleichs, bevor er eine Bewertung zeigt.",
+  "aSettings.minBucket.invalid": "Gib eine ganze Zahl ab 1 ein.",
+  "aSettings.period": "Standard-Zeitraum",
+  "aSettings.period.help": "Gilt, wenn du Analysen ohne Zeitraum anfragst.",
+  "aSettings.readOnly":
+    "Diese Verbindung kann keine Einstellungen speichern. Ändern kannst du sie, wenn du dich über eine Verbindung mit dem Analytics-Toolset standard anmeldest.",
+  "aSettings.readOnlyTitle": "Nur lesen",
+  "aSettings.save": "Speichern",
+  "aSettings.saveError":
+    "Die Einstellungen konnten nicht gespeichert werden. Deine Eingaben sind noch da, versuch es noch mal.",
+  "aSettings.saveFailed":
+    "Speichern hat nicht geklappt: {reason}. Deine Eingaben sind noch da, versuch es noch mal.",
+  "aSettings.savedToast": "Einstellungen gespeichert",
+  "aSettings.saveFailedToast": "Einstellungen konnten nicht gespeichert werden",
+  "aSettings.saving": "Wird gespeichert…",
+  "aSettings.section": "Standardwerte",
+  "aSettings.subtitle": "Standardwerte für Analysen, die einen Wert offenlassen.",
+  "aVersionCompare.badgeInsufficientSignal": plural(
+    "min",
+    "Zu wenig Daten: weniger als 1 Instanz je Version",
+    "Zu wenig Daten: weniger als {min} Instanzen je Version",
+  ),
+  "aVersionCompare.emptyIncomplete":
+    "Für eine Version fehlen die Kennzahlen. Prüf die Versionsnummern oder wähl einen längeren Zeitraum.",
+  "aVersionCompare.emptyNoData":
+    "Für diese Versionen gibt es in diesem Zeitraum keine Instanzen. Prüf die Versionsnummern oder wähl einen längeren Zeitraum.",
+  "aVersionCompare.tableLabel": "Kennzahlen zweier Prozessversionen",
+  "aVersionCompare.title": "Versionsvergleich",
+  "aVersionCompare.versionsBadge": "v{versionA} → v{versionB}",
+}

package/src/messages/en.ask-ai.ts

@@ -0,0 +1,34 @@
+/**
+ * The analytics Ask-AI hand-off intents (#338): the SHORT task each widget
+ * hands to the agent as the user's message. Static text on purpose — no
+ * parameters, no data, no tool names: ids, on-screen numbers, engine text and
+ * the deployment's tools are added by `askAiPrompt` (ids inlined only when
+ * id-shaped, engine text fenced as untrusted data, tools filtered by the live
+ * surface). Generic rules (never compare a rate across engines, `suppressed`
+ * means noise) live in the module's server instructions, not here.
+ *
+ * Posted in the user's name, so it reads like a person asking: plain words,
+ * no dash as a connector, the guardrail ending ("Change nothing.") kept.
+ */
+export const enAskAi = {
+  "askAi.clusterCompare":
+    "Interpret this comparison before and after a deployment in three or four sentences. Is it a real regression or noise? Which metric, and which element, drives it? Recommend one action: roll back, stop further rollouts, or accept.",
+  "askAi.engineCompare":
+    "Interpret this comparison of one process on two engines in three or four sentences. Does the second engine really run it worse, or is it noise? Which metric drives the gap? Recommend one action.",
+  "askAi.versionCompare":
+    "Interpret this version comparison in three or four sentences. Is the new version really worse, or is it noise? Which element drives it? Recommend one action: move running instances back, stop the rollout, or accept.",
+  "askAi.landscapeCompare":
+    "Compare this process between the two engines. Show the comparison side by side, say on which engine it runs better and whether the gap is significant, and recommend one action. Recommend only.",
+  "askAi.executionSummary":
+    "Assess the process analytics on screen. Is it healthy or getting worse? What most likely causes the incidents, and which next step helps most? Keep it short.",
+  "askAi.activityBottleneck":
+    "Explain why this activity is a bottleneck: long executions or sheer volume, waiting or working for its type. Tell me what to look at next. Change nothing.",
+  "askAi.failureSummary":
+    "Sort the open incidents by urgency. Group them by their likely common cause, tell a systemic outage from isolated bugs in single processes, and rank what I should fix first. Check it against the live state. Analysis only.",
+  "askAi.failureRate":
+    "Explain what drives the open incidents of this process. Is it a regression (recent periods, or the periods around a deployment), and which activity fails most? Change nothing.",
+  "askAi.errorPattern":
+    "Find the cause of this group of open incidents. Read their messages and the failing activity, then name the likely cause, whether it is temporary or systemic, and the fix you recommend. Change nothing.",
+} satisfies Record<string, string>
+
+export type AnalyticsAskAiKey = keyof typeof enAskAi

package/src/messages/en.builder.ts

@@ -0,0 +1,76 @@
+import type { MessageCatalog } from "@miragon/mcp-toolkit-core"
+
+/**
+ * English names for the view builder (toolkit 2.8): how the palette, the
+ * canvas, the data sources and the props sheet show analytics' widgets,
+ * pipeline steps and props fields to people (`src/builder-texts.ts` reads
+ * them into the definitions). A title is the thing's name in a few words, a
+ * summary one plain sentence; the definitions' `description`s stay the
+ * model's text. Merged into the catalogs in index.ts and held to the voice
+ * and the glossary like the widget texts.
+ */
+export const enBuilder: MessageCatalog = {
+  "builder.app.title": "Analytics",
+
+  "builder.widget.execution-summary-kpi.title": "Execution metrics",
+  "builder.widget.execution-summary-kpi.summary":
+    "Instances started and completed and incidents created in the period, plus what is running right now.",
+  "builder.widget.execution-performance-kpi.title": "Execution performance",
+  "builder.widget.execution-performance-kpi.summary":
+    "Average, median and p95 duration of the instances that ended in the period, and incidents per 100 starts.",
+  "builder.widget.process-definition-breakdown.title": "By process definition",
+  "builder.widget.process-definition-breakdown.summary":
+    "Starts, completions, incidents, running instances and average duration per process definition.",
+  "builder.widget.activity-bottleneck-table.title": "Activities by total time",
+  "builder.widget.activity-bottleneck-table.summary":
+    "The activities that take the most time in the period, across all processes.",
+  "builder.widget.failure-summary-kpi.title": "Failure analysis",
+  "builder.widget.failure-summary-kpi.summary":
+    "Open incidents right now, their groups by type and process, and the process hit hardest.",
+  "builder.widget.error-patterns-table.title": "Open incidents by type",
+  "builder.widget.error-patterns-table.summary":
+    "The incidents open right now, grouped by type and process definition.",
+  "builder.widget.failure-rate-table.title": "Open incidents by process",
+  "builder.widget.failure-rate-table.summary":
+    "Per process: running instances, jobs without retries, open incidents and incidents per 100 running instances.",
+  "builder.widget.cluster-compare.title": "Before and after the deployment",
+  "builder.widget.cluster-compare.summary":
+    "Instance metrics before and after a deployment, side by side.",
+  "builder.widget.version-compare.title": "Version comparison",
+  "builder.widget.version-compare.summary":
+    "The metrics of two versions of one process side by side.",
+  "builder.widget.engine-compare.title": "Engine comparison",
+  "builder.widget.engine-compare.summary":
+    "The metrics of one process on two engines side by side.",
+  "builder.widget.engine-landscape.title": "Cross-engine landscape",
+  "builder.widget.engine-landscape.summary":
+    "What runs where, the load per engine and the job backlog, as counts across all engines.",
+  "builder.widget.bpmn-heatmap.title": "BPMN heatmap",
+  "builder.widget.bpmn-heatmap.summary":
+    "The diagram with how often each element ran or how long it took.",
+  "builder.widget.settings.title": "Analytics settings",
+  "builder.widget.settings.summary": "Your default period and the minimum size of a comparison.",
+
+  "builder.step.load-dashboard.title": "Process analytics",
+  "builder.step.load-dashboard.summary":
+    "Reads the execution metrics of the period and the state right now from Prometheus.",
+  "builder.step.load-failure-dashboard.title": "Failure analysis",
+  "builder.step.load-failure-dashboard.summary":
+    "Reads the open incidents and the jobs without retries right now from Prometheus.",
+
+  "builder.field.dashboard.processDefinitionKey.title": "Process definition key",
+  "builder.field.dashboard.processDefinitionKey.summary":
+    "Narrows the metrics to one process definition. Without it, all processes.",
+  "builder.field.dashboard.period.title": "Period",
+  "builder.field.dashboard.period.summary":
+    "The period the widget loads when no data source provides one.",
+  "builder.field.dashboard.engine.title": "Engines",
+  "builder.field.dashboard.engine.summary":
+    "The engines to read from. Without them, all configured engines.",
+  "builder.field.failure.engine.title": "Engines",
+  "builder.field.failure.engine.summary":
+    "The engines to read from. Without them, all configured engines.",
+  "builder.field.engineLandscape.engine.title": "Engines",
+  "builder.field.engineLandscape.engine.summary":
+    "The engines in the landscape. Without them, all configured engines.",
+}

package/src/messages/en.server.ts

@@ -0,0 +1,39 @@
+import type { MessageCatalog } from "@miragon/mcp-toolkit-core"
+
+/**
+ * English model-facing analytics tool summaries (aSum.*). Hand-editable; the
+ * model may quote them, so they follow the catalog voice rules too (no dash
+ * as a connector).
+ */
+export const enServer: MessageCatalog = {
+  "aSum.bpmnHeatmap":
+    'BPMN heatmap for "{key}" over {period}{engines}: heat values for {elementCount} element(s){fallbackNote}.',
+  "aSum.bpmnHeatmapNoXml":
+    "; no BPMN XML available, so the view has the heat values but no diagram",
+  "aSum.clusterCompare":
+    "Pre/post deployment comparison{scope}{engines} around {deploymentTimestamp} (measured -{before}d / +{after}d{partial}): {delta}{suppressed}.",
+  "aSum.clusterComparePartial":
+    ", partial: a window was cut short at now or at the retention; starts compare per day",
+  "aSum.dashboard":
+    "Analytics dashboard{scope} over {period}{engines}: within the period {totalCount} instance(s) started, {completedCount} completed, {incidentsCreated} incident(s) created ({incidentRatePct} per 100 started); right now {runningNow} running, {openIncidentsNow} incident(s) open.",
+  "aSum.engineCompare":
+    'Engine comparison of process "{key}" on "{engineA}" vs "{engineB}" over {windowDays}d: {delta}{suppressed}.',
+  "aSum.engineLandscape":
+    "Cross-engine landscape: {engineCount} engine(s) ({reportingEngineCount} reporting metrics), {processKeyCount} process definition(s), {runningInstances} running instance(s), {openIncidents} open incident(s).{shared}",
+  "aSum.engineScopeFleet": " across all {count} configured engines ({ids}), aggregated",
+  "aSum.engineScopeOne": ' on engine "{id}"',
+  "aSum.engineScopeSubset": " across engines {ids}, aggregated",
+  "aSum.failureDashboard":
+    "Failure dashboard{engines}: {totalIncidents} incident(s) open right now in {uniqueErrorPatterns} group(s) by incident type and process{mostAffected}.",
+  "aSum.mostAffectedProcess": '; most affected process: "{key}"',
+  "aSum.scopeForProcess": ' for "{key}"',
+  "aSum.sharedKeys":
+    " Deployed on several engines (the only sound engine-vs-engine comparisons): {keys}.",
+  "aSum.settings":
+    "Analytics settings: default period {period}, min bucket size {minBucketSize}.{changeHint}",
+  "aSum.settingsChangeHint": " Change via analytics_save_settings.",
+  "aSum.settingsSaved":
+    "Analytics settings saved: default period {period}, min bucket size {minBucketSize}.",
+  "aSum.versionCompare":
+    'Version comparison for "{key}" v{versionA} vs v{versionB} over {windowDays}d{engines}: {delta}{suppressed}.',
+}

package/src/messages/en.sweep.ts

@@ -0,0 +1,240 @@
+import type { MessageCatalog } from "@miragon/mcp-toolkit-core"
+import { plural } from "./plural.js"
+
+/**
+ * English catalog of the analytics widgets. String templates use {name}
+ * placeholders interpolated by createTranslator; counted messages are
+ * `plural(…)` and take the count formatted for the view's locale. The voice
+ * rules (sentence case, active, no dash as a connector) and the terms of
+ * GLOSSARY.md are checked by `brand-gates.test.ts` and `glossary.test.ts`.
+ * Merged into the catalogs in index.ts.
+ */
+export const enSweep: MessageCatalog = {
+  "aActivityType.boundaryEvent": "Boundary event",
+  "aActivityType.businessRuleTask": "Business rule task",
+  "aActivityType.callActivity": "Call activity",
+  "aActivityType.endEvent": "End event",
+  "aActivityType.eventBasedGateway": "Event-based gateway",
+  "aActivityType.exclusiveGateway": "Exclusive gateway",
+  "aActivityType.inclusiveGateway": "Inclusive gateway",
+  "aActivityType.intermediateEvent": "Intermediate event",
+  "aActivityType.manualTask": "Manual task",
+  "aActivityType.parallelGateway": "Parallel gateway",
+  "aActivityType.receiveTask": "Receive task",
+  "aActivityType.scriptTask": "Script task",
+  "aActivityType.sendTask": "Send task",
+  "aActivityType.serviceTask": "Service task",
+  "aActivityType.startEvent": "Start event",
+  "aActivityType.subProcess": "Subprocess",
+  "aActivityType.task": "Task",
+  "aActivityType.userTask": "User task",
+  "aBottleneck.colActivity": "Activity",
+  "aBottleneck.colAvg": "Avg",
+  "aBottleneck.colExecutions": "Executions",
+  "aBottleneck.colP95": "P95",
+  "aBottleneck.colTotalTime": "Total time",
+  "aBottleneck.emptyHint": "Choose a longer period or check that the engines report metrics.",
+  "aBottleneck.emptyState": "No activity ended in this period",
+  "aBottleneck.heading": "Activities by total time",
+  "aBottleneck.headingTop": "Top {count} by total time",
+  "aBottleneck.tableLabel": "Activities per process, sorted by total execution time",
+  "aBottleneck.topNote": plural(
+    "count",
+    "The activity with the most total time, of {total}.",
+    "The {count} activities with the most total time, of {total}.",
+  ),
+  "aClusterCompare.afterLabel": "After",
+  "aClusterCompare.beforeLabel": "Before",
+  "aClusterCompare.deployBadge": "Deployment: {timestamp}",
+  "aClusterCompare.elementBadge": "Element: {activityId}",
+  "aClusterCompare.incompleteData":
+    "One side of the comparison returned no figures. Choose longer periods around the deployment.",
+  "aClusterCompare.insufficientSignal": plural(
+    "minBucketSize",
+    "Too little data: fewer than 1 instance per side",
+    "Too little data: fewer than {minBucketSize} instances per side",
+  ),
+  "aClusterCompare.noData":
+    "There are no figures for this deployment. Check the timestamp or choose longer periods.",
+  "aClusterCompare.partialBadge": "Period cut short",
+  "aClusterCompare.period": "{before} before, {after} after",
+  "aClusterCompare.tableLabel": "Metrics before and after the deployment",
+  "aClusterCompare.title": "Before and after the deployment",
+  "aCommon.days": plural("count", "1 day", "{count} days"),
+  "aCommon.hours": plural("count", "1 hour", "{count} hours"),
+  "aCommon.loadError": "Could not load the figures.",
+  "aCommon.minutes": plural("count", "1 minute", "{count} minutes"),
+  "aCommon.underOneMinute": "under 1 minute",
+  "aComparison.deltaBetter": "better",
+  "aComparison.deltaColumnHeader": "Change",
+  "aComparison.deltaNotReliable": "not reliable",
+  "aComparison.deltaWorse": "worse",
+  "aComparison.metricAvgDuration": "Avg duration",
+  "aComparison.metricColumnHeader": "Metric",
+  "aComparison.metricElementIncidentRate": "Incidents per 100 starts at the element",
+  "aComparison.metricIncidentRate": "Incidents per 100 starts",
+  "aComparison.metricP95Duration": "P95 duration",
+  "aComparison.metricStarted": "Starts (change per day)",
+  "aComparison.valueUnavailable": "not measured",
+  "aDefBreakdown.colAvgDuration": "Avg duration",
+  "aDefBreakdown.colCompleted": "Completed",
+  "aDefBreakdown.colIncidents": "New incidents",
+  "aDefBreakdown.colProcess": "Process",
+  "aDefBreakdown.colRunningNow": "Running now",
+  "aDefBreakdown.colStarted": "Started",
+  "aDefBreakdown.emptyHint": "Choose a longer period or check that the engines report metrics.",
+  "aDefBreakdown.emptyState": "No process started or ran in this period",
+  "aDefBreakdown.heading": "By process definition",
+  "aDefBreakdown.tableLabel": "Starts, completions, running instances and incidents per process",
+  "aEngineCompare.elementBadge": "Element: {id}",
+  "aEngineCompare.emptyIncomplete":
+    "One engine returned no figures for this process. Check that both engines run it, or choose a longer period.",
+  "aEngineCompare.emptyNoData":
+    "There are no figures for this process on these engines. Check that both engines run it, or choose a longer period.",
+  "aEngineCompare.enginesBadge": "{engineA} → {engineB}",
+  "aEngineCompare.suppressed": plural(
+    "min",
+    "Too little data: fewer than 1 instance per engine",
+    "Too little data: fewer than {min} instances per engine",
+  ),
+  "aEngineCompare.tableLabel": "Metrics of one process on two engines",
+  "aEngineCompare.title": "Engine comparison",
+  "aErrorPatterns.columnAi": "Chat hand-off",
+  "aErrorPatterns.columnCount": "Open",
+  "aErrorPatterns.columnIncidentType": "Incident type",
+  "aErrorPatterns.columnProcess": "Process",
+  "aErrorPatterns.emptyDescription": "No incident is open right now.",
+  "aErrorPatterns.emptyNoPatterns": "There are no open incident groups right now.",
+  "aErrorPatterns.emptyTitle": "No open incidents",
+  "aErrorPatterns.heading": "Open incidents by type",
+  "aErrorPatterns.tableAriaLabel": "Open incidents by incident type and process",
+  "aExecPerf.avgDuration": "Avg duration",
+  "aExecPerf.headerLabel": "Execution performance",
+  "aExecPerf.incidentRate": "Incidents per 100 starts",
+  "aExecPerf.median": "Median",
+  "aExecPerf.p95": "P95",
+  "aExecPerf.previous": "Previous period: {value}",
+  "aExecPerf.previousJudged": "Previous period: {value}, {verdict}",
+  "aExecPerf.previousNoStarts": "Previous period: no starts",
+  "aExecSummary.cellCompleted": "Completed",
+  "aExecSummary.cellIncidentsCreated": "New incidents",
+  "aExecSummary.cellOpenIncidentsNow": "Open incidents now",
+  "aExecSummary.cellRunningNow": "Running now",
+  "aExecSummary.cellStarted": "Started",
+  "aExecSummary.headerExecutionSummary": "Execution summary",
+  "aExecSummary.title": "Process analytics",
+  "aFailureRate.colAi": "Chat hand-off",
+  "aFailureRate.colDeadJobs": "Jobs without retries",
+  "aFailureRate.colIncidentRate": "Incidents per 100 running instances",
+  "aFailureRate.colOpenIncidents": "Open incidents",
+  "aFailureRate.colProcess": "Process",
+  "aFailureRate.colRunningNow": "Running now",
+  "aFailureRate.emptyState": "No process has open incidents right now.",
+  "aFailureRate.heading": "Open incidents by process",
+  "aFailureRate.tableLabel": "Open incidents per 100 running instances by process definition",
+  "aFailureSummary.mostAffected": "Most affected",
+  "aFailureSummary.mostAffectedNone": "No process",
+  "aFailureSummary.summaryAriaLabel": "Failure analysis summary",
+  "aFailureSummary.title": "Failure analysis",
+  "aFailureSummary.totalIncidents": "Open incidents",
+  "aFailureSummary.uniqueErrorPatterns": "Incident groups",
+  "aFigure.noRate": "No running instance reported: no rate",
+  "aFigure.notReported": "No engine reports this figure: unknown",
+  "aFigure.nothingEnded": "Nothing ended in this period: no duration",
+  "aHeatmap.bpmnNoCamunda7":
+    "The diagram is not available here: without the camunda7 module, analytics cannot load BPMN files. Ask in the chat for the figures per activity instead.",
+  "aHeatmap.bpmnNotLoaded":
+    "Could not load the diagram: no engine in this view returned it. Check that the engines are reachable and the process is deployed, or ask in the chat for the figures per activity.",
+  "aHeatmap.bpmnUnavailable":
+    "Could not load the diagram. Ask in the chat for the figures per activity instead.",
+  "aHeatmap.diagramAria": "BPMN diagram with the execution heat per element",
+  "aHeatmap.duration": "Duration",
+  "aHeatmap.durationLegend": "Average duration per element",
+  "aHeatmap.errorHint": "Ask in the chat to show the heatmap again.",
+  "aHeatmap.errorTitle": "Could not draw the diagram.",
+  "aHeatmap.frequency": "Frequency",
+  "aHeatmap.frequencyLegend": "Executions per element",
+  "aHeatmap.less": "Less",
+  "aHeatmap.more": "More",
+  "aHeatmap.noData":
+    "There are no heatmap figures for this process. Check the process key or choose a longer period.",
+  "aHeatmap.noHeat": "No element ran in this period. Choose a longer period.",
+  "aHeatmap.title": "BPMN heatmap",
+  "aHeatmap.window": "Period:",
+  "aLandscape.colCompare": "Compare across engines",
+  "aLandscape.colDueFuture": "Due later",
+  "aLandscape.colEngine": "Engine",
+  "aLandscape.colExecutable": "Executable jobs",
+  "aLandscape.colExternalTasks": "External tasks",
+  "aLandscape.colFailedJobs": "Jobs without retries",
+  "aLandscape.colIncidents": "Incidents",
+  "aLandscape.colProcess": "Process definition",
+  "aLandscape.colProcesses": "Definitions",
+  "aLandscape.colRunning": "Running",
+  "aLandscape.colSuspended": "Suspended jobs",
+  "aLandscape.compareLabel": "Compare “{key}” across its engines in chat",
+  "aLandscape.emptyEngines":
+    "No engine reports metrics. Check that the metrics plugin runs on the engines and that Prometheus scrapes them.",
+  "aLandscape.emptyProcesses":
+    "No engine reports a process definition. Check that the engines report metrics.",
+  "aLandscape.engines.hint": "absolute load and job backlog",
+  "aLandscape.engines.tableLabel": "Load and job backlog per engine",
+  "aLandscape.engines.title": "Per engine",
+  "aLandscape.exclusiveSuffix": "({count} only here)",
+  "aLandscape.groupBacklog": "Job backlog, comparable across engines",
+  "aLandscape.groupLoad": "Load (absolute)",
+  "aLandscape.heading": "Cross-engine landscape",
+  "aLandscape.headingHint": "What runs where. Not a ranking of the engines.",
+  "aLandscape.kpiEngines": "Engines",
+  "aLandscape.kpiEnginesSilent": "{count} without metrics",
+  "aLandscape.kpiIncidents": "Open incidents",
+  "aLandscape.kpiProcesses": "Process definitions",
+  "aLandscape.kpiProcessesShared": "{count} on several engines",
+  "aLandscape.kpiRunning": "Running instances",
+  "aLandscape.legendNotDeployed": "An empty cell means the process is not deployed on that engine.",
+  "aLandscape.matrix.hint": "running instances per engine",
+  "aLandscape.matrix.tableLabel": "Process definitions by engine",
+  "aLandscape.matrix.title": "What runs where",
+  "aLandscape.mixNote":
+    "Engines run different processes, so their failure rates and durations describe the process mix, not the engine. This view therefore shows counts. You can compare metrics only for definitions that run on more than one engine.",
+  "aLandscape.noMetrics": "no metrics",
+  "aLandscape.notDeployed": "not deployed on this engine",
+  "aLandscape.sharedBadge": plural("count", "on 1 engine", "on {count} engines"),
+  "aLandscape.silentNote": plural(
+    "count",
+    "No column for {engines}: this engine sends no metrics.",
+    "No columns for {engines}: these engines send no metrics.",
+  ),
+  "aLandscape.unknown": "No metrics from this engine: figure unknown",
+  "aSettings.heading": "Analytics settings",
+  "aSettings.loadError": "Could not load the settings.",
+  "aSettings.minBucket": "Minimum size for comparisons",
+  "aSettings.minBucket.help":
+    "How many instances each side of a comparison needs before it shows a verdict.",
+  "aSettings.minBucket.invalid": "Enter a whole number of 1 or more.",
+  "aSettings.period": "Default period",
+  "aSettings.period.help": "Applies when you ask for analytics without naming a period.",
+  "aSettings.readOnly":
+    "This connection can't save settings. To change them, sign in through a connection with the analytics toolset standard.",
+  "aSettings.readOnlyTitle": "Read only",
+  "aSettings.save": "Save",
+  "aSettings.saveError": "Could not save the settings. Your entries are still here, so try again.",
+  "aSettings.saveFailed": "Saving failed: {reason}. Your entries are still here, so try again.",
+  "aSettings.savedToast": "Settings saved",
+  "aSettings.saveFailedToast": "Couldn't save the settings",
+  "aSettings.saving": "Saving…",
+  "aSettings.section": "Analytics defaults",
+  "aSettings.subtitle": "Defaults for analytics requests that leave a value open.",
+  "aVersionCompare.badgeInsufficientSignal": plural(
+    "min",
+    "Too little data: fewer than 1 instance per version",
+    "Too little data: fewer than {min} instances per version",
+  ),
+  "aVersionCompare.emptyIncomplete":
+    "One version returned no figures. Check the version numbers or choose a longer period.",
+  "aVersionCompare.emptyNoData":
+    "There are no instances of these versions in this period. Check the version numbers or choose a longer period.",
+  "aVersionCompare.tableLabel": "Metrics of two process versions",
+  "aVersionCompare.title": "Version comparison",
+  "aVersionCompare.versionsBadge": "v{versionA} → v{versionB}",
+}