biaws-mcp 0.2.0 → 0.3.0

package/README.md

@@ -17,8 +17,9 @@ O servidor separa os domínios:
 - `attachments_*`: envio, download, classificação e exclusão de arquivos de
   chamados, melhorias, tarefas e procedimentos.
 - `secrets_*`: consulta e registro de metadados de segredos, sem acesso aos valores.
-- `monitoring_templates_*` e `runtime_active_monitors_*`: administração
-  versionada de templates e configuração de monitoramentos ativos dos runtimes.
+- `monitoring_templates_*`, `runtime_active_monitors_*` e
+  `runtime_monitoring_results_list`: administração versionada de templates,
+  configuração de monitores e consulta do histórico dos runtimes.
 - `resource_collections_*` e `*_move_to_collection`: organização hierárquica
   de aplicações, regras, decisões, procedimentos, segredos, skills e servidores.
 
@@ -65,13 +66,13 @@ O pacote público expõe o executável `biaws-mcp`. Clientes configurados pelo C
 usam uma versão fixada por meio do cache local do npm:
 
 ```bash
-npx --yes biaws-mcp@0.2.0
+npx --yes biaws-mcp@0.3.0
 ```
 
 Também é possível instalá-lo explicitamente:
 
 ```bash
-npm install --global biaws-mcp@0.2.0
+npm install --global biaws-mcp@0.3.0
 biaws-mcp
 ```
 
@@ -90,7 +91,7 @@ npm start
 Em um cliente MCP, configure o comando:
 
 ```bash
-npx --yes biaws-mcp@0.2.0
+npx --yes biaws-mcp@0.3.0
 ```
 
 O fluxo recomendado é gerar a configuração completa com:
@@ -163,6 +164,18 @@ Monitoramentos ativos são configurados por referência pública ou ID do runtim
 - `runtime_active_monitors_update`;
 - `runtime_active_monitors_archive`.
 
+`runtime_monitoring_results_list` consulta o histórico unificado de observações
+ativas, passivas e manuais. `observedFrom` e `observedTo` aceitam uma data
+`YYYY-MM-DD` ou um instante ISO 8601; datas sem horário preservam a semântica de
+dia inteiro no limite final.
+
+`runtime_monitoring_health_summary` consulta períodos extensos sem transferir
+todo o histórico. A tool agrega uma série por monitoramento, preserva o pior
+estado observado em cada intervalo e escolhe uma resolução compatível com
+`maxPoints` (50 a 1.000). Sem intervalo explícito, resume os últimos 30 dias.
+Use o resumo para tendências e `runtime_monitoring_results_list` para abrir os
+eventos detalhados dos intervalos relevantes.
+
 As tools não aceitam `workspaceId`; o escopo vem exclusivamente de
 `BIAWS_WORKSPACE_ID`. Configurações REST podem referenciar segredos apenas por
 identificadores públicos em `headerRefs`; valores de credenciais não pertencem

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "biaws-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Servidor MCP de domínio para o Bondia Workspaces",
   "license": "Apache-2.0",
   "repository": {

package/src/domains/monitoring/service.js

@@ -34,6 +34,16 @@ function activeMonitorsPath(args, monitor = false) {
   return monitor ? `${base}/${segment(requiredId(args, "monitorId"))}` : base;
 }
 
+function runtimeMonitoringTimelinePath(args) {
+  const runtimeReference = requiredId(args, "runtimeReference");
+  return `/api/monitoring/runtimes/${segment(runtimeReference)}/timeline`;
+}
+
+function runtimeMonitoringHealthSummaryPath(args) {
+  const runtimeReference = requiredId(args, "runtimeReference");
+  return `/api/monitoring/runtimes/${segment(runtimeReference)}/health-summary`;
+}
+
 function payload(args, omitted) {
   const excluded = new Set(omitted);
   const result = Object.fromEntries(
@@ -115,6 +125,32 @@ export function listRuntimeActiveMonitors(args = {}) {
   );
 }
 
+export function listRuntimeMonitoringResults(args = {}) {
+  return fetchJson(
+    runtimeMonitoringTimelinePath(args),
+    cleanParams({
+      observedFrom: args.observedFrom,
+      observedTo: args.observedTo,
+      status: args.status,
+      page: args.page,
+      limit: args.limit,
+    }),
+  );
+}
+
+export function getRuntimeMonitoringHealthSummary(args = {}) {
+  return fetchJson(
+    runtimeMonitoringHealthSummaryPath(args),
+    cleanParams({
+      observedFrom: args.observedFrom,
+      observedTo: args.observedTo,
+      status: args.status,
+      resolution: args.resolution,
+      maxPoints: args.maxPoints,
+    }),
+  );
+}
+
 export function createRuntimeActiveMonitor(args = {}) {
   return sendJson(
     activeMonitorsPath(args),

package/src/domains/monitoring/tools.js

@@ -9,8 +9,10 @@ import {
   getMonitoringTemplate,
   getMonitoringTemplateContract,
   getMonitoringTemplateUsage,
+  getRuntimeMonitoringHealthSummary,
   listMonitoringTemplates,
   listRuntimeActiveMonitors,
+  listRuntimeMonitoringResults,
   previewMonitoringTemplate,
   updateRuntimeActiveMonitor,
   validateMonitoringTemplateSample,
@@ -134,6 +136,69 @@ export const monitoringTools = [
     archiveMonitoringTemplate,
     TEMPLATE_VERSION_ID_SCHEMA,
   ),
+  definition(
+    "runtime_monitoring_results_list",
+    "Lista resultados históricos unificados de monitoramento de um runtime, com filtros por instante inicial, instante final e status.",
+    listRuntimeMonitoringResults,
+    schema(
+      {
+        runtimeReference: ID,
+        observedFrom: {
+          type: "string",
+          description:
+            "Data (YYYY-MM-DD) ou instante ISO 8601 inicial, inclusivo",
+        },
+        observedTo: {
+          type: "string",
+          description:
+            "Data (YYYY-MM-DD, incluindo o dia inteiro) ou instante ISO 8601 final, inclusivo",
+        },
+        status: {
+          type: "string",
+          enum: ["unknown", "healthy", "degraded", "unavailable", "stopped"],
+        },
+        page: { type: "integer", minimum: 1, default: 1 },
+        limit: { type: "integer", minimum: 1, maximum: 100, default: 50 },
+      },
+      ["runtimeReference"],
+    ),
+  ),
+  definition(
+    "runtime_monitoring_health_summary",
+    "Resume a evolução temporal da saúde de um runtime em séries agregadas por monitor, preservando o pior estado de cada intervalo e limitando a quantidade de pontos.",
+    getRuntimeMonitoringHealthSummary,
+    schema(
+      {
+        runtimeReference: ID,
+        observedFrom: {
+          type: "string",
+          description:
+            "Data (YYYY-MM-DD) ou instante ISO 8601 inicial; o padrão cobre 30 dias antes do limite final",
+        },
+        observedTo: {
+          type: "string",
+          description:
+            "Data (YYYY-MM-DD, incluindo o dia inteiro) ou instante ISO 8601 final; o padrão é o instante atual",
+        },
+        status: {
+          type: "string",
+          enum: ["unknown", "healthy", "degraded", "unavailable", "stopped"],
+        },
+        resolution: {
+          type: "string",
+          enum: ["auto", "1m", "5m", "15m", "1h", "6h", "1d", "7d", "30d"],
+          default: "auto",
+        },
+        maxPoints: {
+          type: "integer",
+          minimum: 50,
+          maximum: 1000,
+          default: 400,
+        },
+      },
+      ["runtimeReference"],
+    ),
+  ),
   definition(
     "runtime_active_monitors_list",
     "Lista os monitoramentos ativos configurados para um runtime acessível no workspace selecionado.",

package/src/version.js

@@ -1,2 +1,2 @@
 export const SERVER_NAME = "biaws-mcp";
-export const SERVER_VERSION = "0.2.0";
+export const SERVER_VERSION = "0.3.0";