biaws-mcp 0.2.0 → 0.4.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
@@ -200,6 +213,10 @@ conhecimento.
 - `issues_search`: busca issues com os mesmos filtros principais da
   `biaws-api`, inclusive por workspace, aplicação e componente afetado.
 - `issues_get`: obtém uma issue com comentários e metadados dos anexos.
+- `issues_add_comment`: adiciona um comentário em Markdown a uma issue
+  existente; a autoria é atribuída pela identidade autenticada na API.
+- `issues_update_comment`: atualiza o conteúdo e, opcionalmente, a data de um
+  comentário existente, preservando sua autoria original.
 - `issues_get_classification_catalog`: obtém a árvore taxonômica e os grupos de tags válidos; opcionalmente inclui listas achatadas de IDs e caminhos.
 - `issues_create_taxonomy_item`: inclui um item na raiz ou sob outro item,
   opcionalmente configurando seu escopo por aplicações.

package/package.json

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

package/src/domains/issues/service.js

@@ -130,6 +130,34 @@ export async function getIssueDetails(args = {}) {
   return fetchJson(`/api/issues/${encodeURIComponent(args.issueId)}`);
 }
 
+export async function addIssueComment(args = {}) {
+  const issueId = String(args.issueId || "").trim();
+  const text = String(args.text || "").trim();
+  if (!issueId) throw new Error("issueId is required");
+  if (!text) throw new Error("text is required");
+
+  return sendJson(
+    `/api/issues/${encodeURIComponent(issueId)}/comments`,
+    cleanParams({ text, date: args.date }),
+    {},
+    "POST",
+  );
+}
+
+export async function updateIssueComment(args = {}) {
+  const issueId = String(args.issueId || "").trim();
+  const commentId = String(args.commentId || "").trim();
+  const text = String(args.text || "").trim();
+  if (!issueId) throw new Error("issueId is required");
+  if (!commentId) throw new Error("commentId is required");
+  if (!text) throw new Error("text is required");
+
+  return sendJson(
+    `/api/issues/${encodeURIComponent(issueId)}/comments/${encodeURIComponent(commentId)}`,
+    cleanParams({ text, date: args.date }),
+  );
+}
+
 export async function getIssueClassificationCatalog(args = {}) {
   const payload = await fetchJson(
     "/api/issues/taxonomy",

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/tools.js

@@ -1,4 +1,5 @@
 import {
+  addIssueComment,
   classifyIssue,
   createTaxonomyItem,
   createIssue,
@@ -10,6 +11,7 @@ import {
   summarizeIssuesForSupport,
   suggestTaxonomy,
   updateIssueState,
+  updateIssueComment,
   updateTaxonomyItem,
 } from "./domains/issues/service.js";
 import {
@@ -156,6 +158,58 @@ const tools = [
     },
     handler: getIssueDetails,
   },
+  {
+    name: "issues_add_comment",
+    description: "Adiciona um comentário em Markdown a uma issue existente.",
+    inputSchema: {
+      type: "object",
+      required: ["issueId", "text"],
+      additionalProperties: false,
+      properties: {
+        issueId: { type: "string", minLength: 1 },
+        text: {
+          type: "string",
+          minLength: 1,
+          description: "Conteúdo do comentário em Markdown.",
+        },
+        date: {
+          type: "string",
+          description:
+            "Data do comentário em formato aceito pela API; usa o momento atual quando omitida.",
+        },
+      },
+    },
+    handler: addIssueComment,
+  },
+  {
+    name: "issues_update_comment",
+    description:
+      "Atualiza o conteúdo e, opcionalmente, a data de um comentário de issue.",
+    inputSchema: {
+      type: "object",
+      required: ["issueId", "commentId", "text"],
+      additionalProperties: false,
+      properties: {
+        issueId: { type: "string", minLength: 1 },
+        commentId: {
+          type: "string",
+          minLength: 1,
+          description: "ID do comentário retornado por issues_get.",
+        },
+        text: {
+          type: "string",
+          minLength: 1,
+          description: "Novo conteúdo do comentário em Markdown.",
+        },
+        date: {
+          type: "string",
+          description:
+            "Nova data do comentário; usa o momento atual quando omitida.",
+        },
+      },
+    },
+    handler: updateIssueComment,
+  },
   {
     name: "issues_get_classification_catalog",
     description:

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.4.0";