biaws-mcp 0.1.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.
 
@@ -34,15 +35,15 @@ a URL e a credencial da instância, mas não seleciona o workspace.
 
 Por padrão, a API é buscada em `http://127.0.0.1:3100`. Para apontar para outro endereço, use uma das variáveis:
 
-- `ISSUE_API_URL`
-- `ISSUE_API_BASE_URL`
-- `VITE_ISSUE_API_URL`
+- `BIAWS_API_URL`
+- `BIAWS_API_BASE_URL`
+- `VITE_BIAWS_API_URL`
 
-Defina obrigatoriamente `ISSUE_API_KEY`. O bootstrap open source cria uma
+Defina obrigatoriamente `BIAWS_API_KEY`. O bootstrap open source cria uma
 identidade técnica e grava sua chave no `.env` local; uma chave também pode ser
 criada manualmente pela UI. O MCP a envia como `Authorization: Bearer`.
 
-Defina `ISSUE_WORKSPACE_ID` no bloco `env` do servidor MCP local ao projeto. O
+Defina `BIAWS_WORKSPACE_ID` no bloco `env` do servidor MCP local ao projeto. O
 MCP preserva esse valor mesmo ao carregar `BIAWS_ENV_FILE` e o envia como
 `X-Biaws-Workspace-Id`; argumentos das tools não ampliam esse escopo. A chave
 precisa pertencer ao workspace — selecionar o ID não concede permissões.
@@ -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.1.0
+npx --yes biaws-mcp@0.3.0
 ```
 
 Também é possível instalá-lo explicitamente:
 
 ```bash
-npm install --global biaws-mcp@0.1.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.1.0
+npx --yes biaws-mcp@0.3.0
 ```
 
 O fluxo recomendado é gerar a configuração completa com:
@@ -163,8 +164,20 @@ 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
-`ISSUE_WORKSPACE_ID`. Configurações REST podem referenciar segredos apenas por
+`BIAWS_WORKSPACE_ID`. Configurações REST podem referenciar segredos apenas por
 identificadores públicos em `headerRefs`; valores de credenciais não pertencem
 ao MCP. Templates são permitidos somente para o provider REST. Para preparar um
 monitor antes de provisionar o executor, crie-o com `enabled: false`.
@@ -307,7 +320,7 @@ Este MCP não expõe uma ferramenta genérica de armazenamento. As escritas disp
 
 O MCP não acessa MongoDB, não executa shell, SSH, deploy ou sincronização Git e
 não recebe valores de senhas, tokens, chaves privadas, kubeconfig ou connection
-strings. A `ISSUE_API_KEY` é a única credencial do processo e
+strings. A `BIAWS_API_KEY` é a única credencial do processo e
 é usada exclusivamente no cabeçalho HTTP.
 
 Erros da API mantêm o status e o código funcional para que o agente diferencie

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "biaws-mcp",
-  "version": "0.1.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/httpClient.js

@@ -9,13 +9,13 @@ const RETRYABLE_STATUSES = new Set([429, 502, 503, 504]);
 
 function readBaseUrl() {
   const explicit =
-    process.env.ISSUE_API_URL ||
-    process.env.ISSUE_API_BASE_URL ||
-    process.env.VITE_ISSUE_API_URL;
+    process.env.BIAWS_API_URL ||
+    process.env.BIAWS_API_BASE_URL ||
+    process.env.VITE_BIAWS_API_URL;
   if (explicit) return explicit.replace(/\/$/u, "");
 
-  const host = process.env.ISSUE_API_HOST || process.env.HOST || "127.0.0.1";
-  const port = process.env.ISSUE_API_PORT || process.env.PORT || "3100";
+  const host = process.env.BIAWS_API_HOST || process.env.HOST || "127.0.0.1";
+  const port = process.env.BIAWS_API_PORT || process.env.PORT || "3100";
   return `http://${host}:${port}`;
 }
 
@@ -47,8 +47,8 @@ function buildUrl(path, params = {}) {
 }
 
 function authenticationHeaders() {
-  const apiKey = String(process.env.ISSUE_API_KEY || "").trim();
-  const workspaceId = String(process.env.ISSUE_WORKSPACE_ID || "").trim();
+  const apiKey = String(process.env.BIAWS_API_KEY || "").trim();
+  const workspaceId = String(process.env.BIAWS_WORKSPACE_ID || "").trim();
   return {
     Accept: "application/json",
     ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),

package/src/index.js

@@ -12,7 +12,7 @@ const TOOL_DIR = path.resolve(
 
 // O workspace pertence à configuração do projeto/cliente MCP. O arquivo da
 // instância fornece URL e credencial, mas não pode mudar esse escopo.
-loadEnv(TOOL_DIR, { preserve: ["ISSUE_WORKSPACE_ID"] });
+loadEnv(TOOL_DIR, { preserve: ["BIAWS_WORKSPACE_ID"] });
 
 function writeMessage(message) {
   process.stdout.write(`${JSON.stringify(message)}\n`);

package/src/version.js

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