biaws-mcp 0.9.0 → 0.10.0

package/README.md

@@ -65,13 +65,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.9.0
+npx --yes biaws-mcp@0.10.0
 ```
 
 Também é possível instalá-lo explicitamente:
 
 ```bash
-npm install --global biaws-mcp@0.9.0
+npm install --global biaws-mcp@0.10.0
 biaws-mcp
 ```
 
@@ -90,7 +90,7 @@ npm start
 Em um cliente MCP, configure o comando:
 
 ```bash
-npx --yes biaws-mcp@0.9.0
+npx --yes biaws-mcp@0.10.0
 ```
 
 O fluxo recomendado é gerar a configuração completa com:
@@ -238,6 +238,36 @@ informa totais e truncamentos e não contém credenciais, endereços dos
 servidores, metadata dos runtimes, anexos nem os textos extensos da base de
 conhecimento.
 
+### Histórico de documentos
+
+- `documents_list_revisions`: consulta até 100 revisões mais recentes.
+- `documents_list_observations`: consulta até 200 observações mais recentes.
+
+Ambas exigem `documentId` e preservam a autorização da API. Esses endpoints
+não oferecem paginação.
+
+### Consultas de monitoramento
+
+- `monitoring_runtime_topology_get`: consulta a topologia monitorada.
+- `monitoring_runtime_targets_list`: lista os alvos de runtime monitorados.
+- `monitoring_metadata_profiles_list`: lista os perfis de apresentação de
+  metadados; exige leitura de runtimes no escopo de workspace.
+- `applications_monitoring_health_get`: consulta a saúde consolidada de uma
+  aplicação; `includeConfigured` inclui runtimes com monitores configurados
+  mesmo sem resultados recebidos (padrão `false`).
+- `runtime_monitoring_signals_list`: lista sinais passivos/externos por runtime,
+  período e status, com `page` (padrão 1) e `limit` (padrão 50, máximo 100).
+  Para resultados de monitores ativos, use `runtime_monitoring_results_list`.
+
+Topologia, alvos e perfis retornam o conjunto acessível fornecido pela API, sem
+paginação. As consultas usam o workspace configurado no MCP.
+
+### Auditoria
+
+- `audit_events_list`: consulta os eventos mais recentes de uma entidade, com
+  `entityType`, `entityId` e `limit` (padrão 100, máximo 200). Usa a permissão
+  de leitura e o escopo da entidade. A API não oferece paginação deste histórico.
+
 ### Issues / chamados
 
 - `issues_search`: busca issues com os mesmos filtros principais da
@@ -258,6 +288,8 @@ conhecimento.
   obrigatório.
 - `issues_import_eml`: analisa ou importa um EML enviado em Base64; `dryRun` é `true` por padrão.
 - `issues_update_state`: altera status e/ou tipo de uma issue.
+- `issues_update`: altera título, texto, tipo, status, aplicação e componentes
+  afetados. Exige ao menos um campo e preserva os campos omitidos.
 - `issues_suggest_taxonomy`: sugere taxonomias aderentes ao texto da issue.
 - `issues_classify`: grava classificação/KB em `issues.classification`.
 - `issues_by_taxonomy`: busca issues por assunto/taxonomia, incluindo todos os
@@ -265,7 +297,11 @@ conhecimento.
 
 ### Melhorias
 
-- `demands_list`: lista melhorias com filtros simples e de contexto.
+- `demands_list`: lista uma página de melhorias, com `page` (padrão 1),
+  `limit` (padrão 25, máximo 100), filtros de contexto e `collectionId`
+  (`__root__` seleciona a raiz). A resposta informa total, página e total de
+  páginas. Busca por `text` e código parcial em `code` percorre as páginas da
+  API e aplica os filtros antes da paginação do resultado.
 - `demands_get`: obtém uma melhoria estruturada.
 - `demands_create`: cria uma melhoria com dados cadastrais, especificação,
   checklist e planejamento; `applicationId` é obrigatório.
@@ -274,6 +310,19 @@ conhecimento.
 - `demands_implementation_context`: extrai contexto de especificação e tarefas para agentes de desenvolvimento.
 - `demands_add_note`: adiciona anotação a uma melhoria.
 - `demands_update_description`: atualiza a descrição sucinta da melhoria.
+- `demands_update`: altera código, título, descrição, status, prazos, estimativa
+  de jornadas, aplicação e componentes afetados. Exige ao menos um campo;
+  campos omitidos são preservados pela API.
+- `demands_update_specification`: substitui todas as seções da especificação.
+- `demands_update_checklist`: substitui todos os itens do checklist, incluindo
+  conclusão, data e comentário.
+- `demands_update_journeys`: substitui o planejamento mensal de jornadas.
+  Os meses devem estar dentro de `startDate`/`endDate` da melhoria; ajuste as
+  datas com `demands_update` primeiro. A API preenche meses do período não
+  informados com zero.
+- `demands_update_note`: altera conteúdo e, opcionalmente, data de uma nota;
+  preserva a data existente quando omitida.
+- `demands_delete_note`: exclui permanentemente uma nota da melhoria.
 - `demands_list_tasks`: lista tarefas, com filtro opcional por status.
 - `demands_create_task`: inclui uma tarefa.
 - `demands_update_task`: altera código, título, status, datas, situação, descrição ou especificação de uma tarefa.
@@ -283,6 +332,19 @@ conhecimento.
 - `demands_update_task_note`: altera uma nota de execução.
 - `demands_delete_task_note`: exclui uma nota de execução.
 
+Calendário e prazos percorrem todas as páginas de melhorias no escopo informado,
+com filtro opcional por `collectionId`. Essas consultas e a busca local de
+`demands_list` leem até 100 páginas de 100 melhorias. Ao exceder o limite, retornam
+`DEMAND_SCAN_LIMIT_EXCEEDED` e solicitam filtros mais específicos, sem devolver
+um resultado parcial como completo.
+
+As novas ferramentas de alteração aceitam `requestId` como ID ou código exato da melhoria.
+Consulte `demands_get` antes de substituir especificação, checklist ou jornadas
+para conservar os itens desejados. Arrays vazios limpam especificação e checklist;
+para jornadas, zeram o planejamento no período da melhoria. IDs de seções,
+rótulos de checklist e meses de jornadas devem ser únicos. As alterações usam
+somente a API, com as mesmas permissões, escopo e auditoria da interface.
+
 ### Anexos
 
 - `attachments_upload`: envia até dez arquivos, fornecidos em

package/package.json

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

package/src/domains/audit/service.js

@@ -0,0 +1,10 @@
+import { cleanParams, fetchJson } from "../../httpClient.js";
+
+export async function listAuditEvents(args = {}) {
+  const entityId = String(args.entityId || "").trim();
+  if (!entityId) throw new Error("entityId is required");
+  return fetchJson(
+    `/api/audit/${encodeURIComponent(args.entityType)}/${encodeURIComponent(entityId)}`,
+    cleanParams({ limit: args.limit ?? 100 }),
+  );
+}

package/src/domains/audit/tools.js

@@ -0,0 +1,43 @@
+import { listAuditEvents } from "./service.js";
+
+export const auditTools = [
+  {
+    name: "audit_events_list",
+    description:
+      "Consulta os eventos mais recentes de auditoria de uma entidade, respeitando seu escopo e permissão de leitura. Retorna até 200 eventos; a API não oferece paginação deste histórico.",
+    inputSchema: {
+      type: "object",
+      required: ["entityType", "entityId"],
+      additionalProperties: false,
+      properties: {
+        entityType: {
+          type: "string",
+          enum: [
+            "issue",
+            "demand",
+            "task",
+            "document",
+            "taxonomy",
+            "skill",
+            "application",
+            "workspace",
+            "component",
+            "integration",
+            "repository",
+            "server",
+            "deployment",
+            "runtime",
+          ],
+        },
+        entityId: {
+          type: "string",
+          minLength: 1,
+          description:
+            "ID da entidade usado pela API; códigos de melhorias não são resolvidos nesta ferramenta.",
+        },
+        limit: { type: "integer", minimum: 1, maximum: 200, default: 100 },
+      },
+    },
+    handler: listAuditEvents,
+  },
+];

package/src/domains/demands/service.js

@@ -100,17 +100,44 @@ function compactDemand(request) {
   };
 }
 
-async function readAllDemands(args = {}) {
+async function readDemandPage(args = {}, page = 1, limit = 25) {
   return fetchJson(
     "/api/requests",
     cleanParams({
       workspaceId: args.workspaceId,
       applicationId: args.applicationId,
       componentId: args.componentId,
+      collectionId: args.collectionId,
+      status: args.status,
+      page,
+      limit,
     }),
   );
 }
 
+async function readAllDemands(args = {}) {
+  const items = [];
+  let meta = {};
+  // Bound traversal without returning an apparently complete partial result.
+  for (let page = 1; page <= 100; page += 1) {
+    const payload = await readDemandPage(args, page, 100);
+    items.push(...payload.items);
+    meta = payload.meta || {};
+    const totalPages = Number(
+      meta.totalPages ?? Math.ceil(Number(meta.total) / 100),
+    );
+    if (!Number.isFinite(totalPages) || page >= totalPages) {
+      return { meta, items };
+    }
+  }
+  const error = new Error(
+    "Demand scan exceeds 100 pages; narrow the application, component, status or collection filters",
+  );
+  error.code = "DEMAND_SCAN_LIMIT_EXCEEDED";
+  error.retryable = false;
+  throw error;
+}
+
 async function readDemand(requestId) {
   const isObjectId = /^[0-9a-f]{24}$/iu.test(requestId);
   const payload = isObjectId
@@ -145,16 +172,31 @@ function journeySummaryForRequest(request) {
 }
 
 export async function listDemands(args = {}) {
-  const payload = await readAllDemands(args);
+  const page = args.page ?? 1;
+  const limit = args.limit ?? 25;
+  // Text and partial-code matching remain MCP filters; filter before paging.
+  const locallyFiltered = Boolean(args.text || args.code);
+  const payload = locallyFiltered
+    ? await readAllDemands(args)
+    : await readDemandPage(args, page, limit);
   const filtered = filterDemands(payload.items, args);
-
+  const items = locallyFiltered
+    ? filtered.slice((page - 1) * limit, page * limit)
+    : filtered;
+  const total = locallyFiltered
+    ? filtered.length
+    : (payload.meta?.total ?? filtered.length);
   return {
     meta: {
       ...payload.meta,
-      returned: filtered.length,
+      page,
+      limit,
+      total,
+      totalPages: Math.max(1, Math.ceil(total / limit)),
+      returned: items.length,
       filters: args,
     },
-    items: args.includeDetails ? filtered : filtered.map(compactDemand),
+    items: args.includeDetails ? items : items.map(compactDemand),
   };
 }
 
@@ -479,12 +521,129 @@ export async function updateDemandDescription(args = {}) {
   if (!String(args.description || "").trim())
     throw new Error("description is required");
 
-  const { request } = await readDemand(args.requestId);
+  return updateDemandFields(args, {
+    description: String(args.description).trim(),
+  });
+}
+
+function requiredText(value, field) {
+  const normalized = String(value || "").trim();
+  if (!normalized) throw new Error(`${field} is required`);
+  return normalized;
+}
+
+async function updateDemandFields(args, payload) {
+  const requestId = requiredText(args.requestId, "requestId");
+  const { request } = await readDemand(requestId);
+  if (payload.journeys) {
+    const from = String(request.startDate || "").slice(0, 7);
+    const to = String(request.endDate || "").slice(0, 7);
+    if (
+      payload.journeys.some(
+        (item) => !from || !to || item.month < from || item.month > to,
+      )
+    ) {
+      throw new Error(
+        "journeys.month must fall within the demand startDate/endDate; update its dates first",
+      );
+    }
+  }
+  // The API merges omitted fields and enforces field-specific permissions.
+  return sendJson(`/api/requests/${encodeURIComponent(request.id)}`, payload);
+}
+
+export async function updateDemand(args = {}) {
+  const fields = [
+    "clientCode",
+    "title",
+    "description",
+    "status",
+    "estimatedDeliveryDate",
+    "startDate",
+    "endDate",
+    "estimatedJourneys",
+    "applicationId",
+    "affectedComponentIds",
+  ];
+  const payload = {};
+  for (const field of fields) {
+    if (args[field] === undefined) continue;
+    payload[field] =
+      typeof args[field] === "string" ? args[field].trim() : args[field];
+    if (["title", "status", "applicationId"].includes(field)) {
+      payload[field] = requiredText(args[field], field);
+    }
+  }
+  if (!Object.keys(payload).length)
+    throw new Error("At least one update field is required");
+  if (payload.affectedComponentIds) {
+    payload.affectedComponentIds = payload.affectedComponentIds.map((id) =>
+      requiredText(id, "affectedComponentIds"),
+    );
+    assertUnique(payload.affectedComponentIds, "affectedComponentIds");
+  }
+  return updateDemandFields(args, payload);
+}
+
+function assertUnique(values, field) {
+  if (new Set(values).size !== values.length)
+    throw new Error(`${field} must be unique`);
+}
+
+export async function updateDemandSpecification(args = {}) {
+  const sections = args.specificationSections.map((section) => ({
+    ...section,
+    id: requiredText(section.id, "section.id"),
+    title: requiredText(section.title, "section.title"),
+  }));
+  assertUnique(
+    sections.map((section) => section.id),
+    "section.id",
+  );
+  return updateDemandFields(args, { specification: { sections } });
+}
+
+export async function updateDemandChecklist(args = {}) {
+  const checklist = args.checklist.map((item) => ({
+    ...item,
+    label: requiredText(item.label, "checklist.label"),
+  }));
+  assertUnique(
+    checklist.map((item) => item.label),
+    "checklist.label",
+  );
+  return updateDemandFields(args, { checklist });
+}
+
+export async function updateDemandJourneys(args = {}) {
+  assertUnique(
+    args.journeys.map((item) => item.month),
+    "journeys.month",
+  );
+  return updateDemandFields(args, { journeys: args.journeys });
+}
+
+async function readDemandNote(args) {
+  const requestId = requiredText(args.requestId, "requestId");
+  const noteId = requiredText(args.noteId, "noteId");
+  const { request } = await readDemand(requestId);
+  const note = (request.notes || []).find((item) => item.id === noteId);
+  if (!note) throw new Error(`Demand note not found: ${noteId}`);
+  return { request, note };
+}
+
+export async function updateDemandNote(args = {}) {
+  const content = requiredText(args.content, "content");
+  const { request, note } = await readDemandNote(args);
   return sendJson(
-    `/api/requests/${encodeURIComponent(request.id)}`,
-    cleanParams({
-      ...request,
-      description: String(args.description).trim(),
-    }),
+    `/api/requests/${encodeURIComponent(request.id)}/notes/${encodeURIComponent(note.id)}`,
+    { content, date: args.date ?? note.date },
+  );
+}
+
+export async function deleteDemandNote(args = {}) {
+  const { request, note } = await readDemandNote(args);
+  return deleteJson(
+    `/api/requests/${encodeURIComponent(request.id)}/notes/${encodeURIComponent(note.id)}`,
   );
 }

package/src/domains/demands/tools.js

@@ -0,0 +1,145 @@
+import {
+  deleteDemandNote,
+  updateDemand,
+  updateDemandChecklist,
+  updateDemandJourneys,
+  updateDemandNote,
+  updateDemandSpecification,
+} from "./service.js";
+
+const requestId = {
+  type: "string",
+  minLength: 1,
+  description: "ID ou código exato da melhoria.",
+};
+const date = { type: "string", description: "YYYY-MM-DD ou vazio." };
+const text = { type: "string", minLength: 1 };
+
+function tool(name, description, properties, required, handler) {
+  return {
+    name,
+    description,
+    inputSchema: {
+      type: "object",
+      required: ["requestId", ...required],
+      additionalProperties: false,
+      properties: { requestId, ...properties },
+    },
+    handler,
+  };
+}
+
+export const demandMutationTools = [
+  tool(
+    "demands_update",
+    "Atualiza dados cadastrais, status, prazos e contexto de uma melhoria. Informe pelo menos um campo; campos omitidos são preservados.",
+    {
+      clientCode: { type: "string" },
+      title: text,
+      description: { type: "string" },
+      status: {
+        ...text,
+        description:
+          "Status vigente em Configurações/Listas de Opções; validado pela API.",
+      },
+      estimatedDeliveryDate: date,
+      startDate: date,
+      endDate: date,
+      estimatedJourneys: { type: "number", minimum: 0 },
+      applicationId: text,
+      affectedComponentIds: {
+        type: "array",
+        maxItems: 100,
+        uniqueItems: true,
+        items: text,
+        description:
+          "Substitui os componentes afetados; [] remove as associações.",
+      },
+    },
+    [],
+    updateDemand,
+  ),
+  tool(
+    "demands_update_specification",
+    "Substitui todas as seções da especificação de uma melhoria, preservando os demais dados. Consulte demands_get antes de editar; [] remove todas as seções.",
+    {
+      specificationSections: {
+        type: "array",
+        maxItems: 500,
+        items: {
+          type: "object",
+          required: ["id", "title", "content", "order"],
+          additionalProperties: false,
+          properties: {
+            id: text,
+            title: text,
+            content: { type: "string", description: "Conteúdo em Markdown." },
+            order: { type: "integer", minimum: 0 },
+          },
+        },
+      },
+    },
+    ["specificationSections"],
+    updateDemandSpecification,
+  ),
+  tool(
+    "demands_update_checklist",
+    "Substitui todos os itens do checklist de uma melhoria, incluindo conclusão, data e comentário. Consulte demands_get antes de editar; [] limpa o checklist.",
+    {
+      checklist: {
+        type: "array",
+        maxItems: 1000,
+        items: {
+          type: "object",
+          required: ["label", "done"],
+          additionalProperties: false,
+          properties: {
+            label: text,
+            done: { type: "boolean" },
+            date,
+            comment: { type: "string" },
+          },
+        },
+      },
+    },
+    ["checklist"],
+    updateDemandChecklist,
+  ),
+  tool(
+    "demands_update_journeys",
+    "Substitui o planejamento mensal de jornadas da melhoria. Consulte demands_get antes de editar; a API normaliza os meses segundo o período da melhoria.",
+    {
+      journeys: {
+        type: "array",
+        maxItems: 240,
+        items: {
+          type: "object",
+          required: ["month", "plannedJourneys"],
+          additionalProperties: false,
+          properties: {
+            month: { type: "string", pattern: "^\\d{4}-(0[1-9]|1[0-2])$" },
+            plannedJourneys: { type: "number", minimum: 0 },
+            executedJourneys: { type: "number", minimum: 0, default: 0 },
+            comment: { type: "string" },
+          },
+        },
+      },
+    },
+    ["journeys"],
+    updateDemandJourneys,
+  ),
+  tool(
+    "demands_update_note",
+    "Atualiza o conteúdo de uma nota da melhoria e, opcionalmente, sua data. A data existente é preservada quando omitida.",
+    { noteId: text, content: text, date },
+    ["noteId", "content"],
+    updateDemandNote,
+  ),
+  tool(
+    "demands_delete_note",
+    "Exclui permanentemente uma nota da melhoria identificada por noteId.",
+    { noteId: text },
+    ["noteId"],
+    deleteDemandNote,
+  ),
+];

package/src/domains/issues/service.js

@@ -405,3 +405,46 @@ export async function findIssuesByTaxonomy(args = {}) {
     }),
   );
 }
+
+export async function updateIssue(args = {}) {
+  const issueId = String(args.issueId || "").trim();
+  if (!issueId) throw new Error("issueId is required");
+  const payload = {};
+  for (const field of [
+    "title",
+    "text",
+    "type",
+    "status",
+    "applicationId",
+    "affectedComponentIds",
+  ]) {
+    if (args[field] === undefined) continue;
+    const value =
+      typeof args[field] === "string" ? args[field].trim() : args[field];
+    if (typeof value === "string" && !value)
+      throw new Error(`${field} is required`);
+    payload[field] = value;
+  }
+  if (!Object.keys(payload).length)
+    throw new Error("At least one update field is required");
+  if (payload.affectedComponentIds) {
+    payload.affectedComponentIds = payload.affectedComponentIds.map((id) => {
+      const value = id.trim();
+      if (!value)
+        throw new Error("affectedComponentIds must contain nonblank IDs");
+      return value;
+    });
+    if (
+      new Set(payload.affectedComponentIds).size !==
+      payload.affectedComponentIds.length
+    ) {
+      throw new Error("affectedComponentIds must be unique");
+    }
+  }
+  return sendJson(
+    `/api/issues/${encodeURIComponent(issueId)}`,
+    payload,
+    {},
+    "PATCH",
+  );
+}

package/src/domains/knowledge/service.js

@@ -136,3 +136,17 @@ export async function loadKnowledgeContext(args = {}) {
     documents,
   };
 }
+
+function documentHistoryPath(args, suffix) {
+  const documentId = String(args.documentId || "").trim();
+  if (!documentId) throw new Error("documentId is required");
+  return `${BASE_PATH}/${encodeURIComponent(documentId)}/${suffix}`;
+}
+
+export async function listDocumentRevisions(args = {}) {
+  return fetchJson(documentHistoryPath(args, "revisions"));
+}
+
+export async function listDocumentObservations(args = {}) {
+  return fetchJson(documentHistoryPath(args, "observations"));
+}

package/src/domains/knowledge/tools.js

@@ -3,6 +3,8 @@ import {
   createDocument,
   getDocument,
   listDocumentTypes,
+  listDocumentRevisions,
+  listDocumentObservations,
   loadKnowledgeContext,
   searchDocuments,
   updateDocument,
@@ -319,6 +321,18 @@ export const knowledgeTools = [
     getDocument,
     schema({ documentId: ID }, ["documentId"]),
   ),
+  definition(
+    "documents_list_revisions",
+    "Consulta até 100 revisões mais recentes de um documento, em ordem decrescente de revisão. A API não oferece paginação deste histórico.",
+    listDocumentRevisions,
+    schema({ documentId: ID }, ["documentId"]),
+  ),
+  definition(
+    "documents_list_observations",
+    "Consulta até 200 observações mais recentes de um documento. A API não oferece paginação deste histórico.",
+    listDocumentObservations,
+    schema({ documentId: ID }, ["documentId"]),
+  ),
   definition(
     "documents_create",
     "Cria um documento usando o contrato discriminado pelo documentType. O workspace vem da configuração do MCP; applicationId e details seguem as regras de cada tipo.",

package/src/domains/monitoring/service.js

@@ -172,3 +172,37 @@ export function updateRuntimeActiveMonitor(args = {}) {
 export function archiveRuntimeActiveMonitor(args = {}) {
   return deleteJson(activeMonitorsPath(args, true));
 }
+
+export async function getMonitoringRuntimeTopology() {
+  return fetchJson("/api/monitoring/runtime-topology");
+}
+
+export async function listMonitoringRuntimeTargets() {
+  return fetchJson("/api/monitoring/runtime-targets");
+}
+
+export async function listMonitoringMetadataProfiles() {
+  return fetchJson("/api/monitoring/metadata-profiles");
+}
+
+export async function getApplicationMonitoringHealth(args = {}) {
+  const applicationId = requiredId(args, "applicationId");
+  return fetchJson(
+    `/api/monitoring/applications/${segment(applicationId)}/health`,
+    cleanParams({ includeConfigured: args.includeConfigured ?? false }),
+  );
+}
+
+export async function listRuntimeMonitoringSignals(args = {}) {
+  const runtimeReference = requiredId(args, "runtimeReference");
+  return fetchJson(
+    `/api/monitoring/runtimes/${segment(runtimeReference)}/signals`,
+    cleanParams({
+      observedFrom: args.observedFrom,
+      observedTo: args.observedTo,
+      status: args.status,
+      page: args.page ?? 1,
+      limit: args.limit ?? 50,
+    }),
+  );
+}

package/src/domains/monitoring/tools.js

@@ -7,6 +7,11 @@ import {
   createRuntimeActiveMonitor,
   deactivateMonitoringTemplate,
   getMonitoringTemplate,
+  getMonitoringRuntimeTopology,
+  listMonitoringRuntimeTargets,
+  listMonitoringMetadataProfiles,
+  getApplicationMonitoringHealth,
+  listRuntimeMonitoringSignals,
   getMonitoringTemplateContract,
   getMonitoringTemplateUsage,
   getRuntimeMonitoringHealthSummary,
@@ -62,6 +67,63 @@ const TEMPLATE_VERSION_ID_SCHEMA = schema({ templateId: ID, version: ID }, [
 ]);
 
 export const monitoringTools = [
+  definition(
+    "monitoring_runtime_topology_get",
+    "Consulta a topologia monitorada no escopo autorizado. A API retorna a árvore completa acessível sem paginação.",
+    getMonitoringRuntimeTopology,
+    schema(),
+  ),
+  definition(
+    "monitoring_runtime_targets_list",
+    "Lista os alvos de runtime monitorados no escopo autorizado. A API retorna todos os alvos acessíveis sem paginação.",
+    listMonitoringRuntimeTargets,
+    schema(),
+  ),
+  definition(
+    "monitoring_metadata_profiles_list",
+    "Lista os perfis de apresentação de metadados do workspace; exige permissão de leitura de runtimes no escopo de workspace. A API não oferece paginação.",
+    listMonitoringMetadataProfiles,
+    schema(),
+  ),
+  definition(
+    "applications_monitoring_health_get",
+    "Consulta a saúde consolidada e os detalhes de monitoramento de uma aplicação. includeConfigured inclui runtimes com monitores configurados mesmo sem resultados recebidos.",
+    getApplicationMonitoringHealth,
+    schema(
+      {
+        applicationId: ID,
+        includeConfigured: { type: "boolean", default: false },
+      },
+      ["applicationId"],
+    ),
+  ),
+  definition(
+    "runtime_monitoring_signals_list",
+    "Lista uma página de sinais passivos ou externos de um runtime, filtrados por período e status. Para incluir resultados de monitores ativos, use runtime_monitoring_results_list.",
+    listRuntimeMonitoringSignals,
+    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(
     "monitoring_templates_list",
     "Lista templates de monitoramento versionados do workspace configurado, com filtro de status e paginação.",

package/src/tools.js

@@ -11,6 +11,7 @@ import {
   summarizeIssuesForSupport,
   suggestTaxonomy,
   updateIssueState,
+  updateIssue,
   updateIssueComment,
   updateTaxonomyItem,
 } from "./domains/issues/service.js";
@@ -36,6 +37,8 @@ import { catalogTools } from "./domains/catalog/tools.js";
 import { collectionTools } from "./domains/collections/tools.js";
 import { secretTools } from "./domains/secrets/tools.js";
 import { knowledgeTools } from "./domains/knowledge/tools.js";
+import { auditTools } from "./domains/audit/tools.js";
+import { demandMutationTools } from "./domains/demands/tools.js";
 import { attachmentTools } from "./domains/attachments/tools.js";
 import { monitoringTools } from "./domains/monitoring/tools.js";
 
@@ -140,6 +143,8 @@ const tools = [
   ...secretTools,
   ...knowledgeTools,
   ...attachmentTools,
+  ...demandMutationTools,
+  ...auditTools,
   ...monitoringTools,
   {
     name: "issues_search",
@@ -165,6 +170,35 @@ const tools = [
     },
     handler: getIssueDetails,
   },
+  {
+    name: "issues_update",
+    description:
+      "Atualiza título, texto, tipo, status, aplicação e componentes afetados de uma issue. Informe ao menos um campo; campos omitidos são preservados pela API.",
+    inputSchema: {
+      type: "object",
+      required: ["issueId"],
+      additionalProperties: false,
+      properties: {
+        issueId: { type: "string", minLength: 1 },
+        title: { type: "string", minLength: 1 },
+        text: {
+          type: "string",
+          minLength: 1,
+          description: "Conteúdo em Markdown.",
+        },
+        type: { type: "string", enum: ["incident", "request"] },
+        status: { type: "string", enum: ["open", "closed"] },
+        applicationId: { type: "string", minLength: 1 },
+        affectedComponentIds: {
+          type: "array",
+          maxItems: 100,
+          uniqueItems: true,
+          items: { type: "string", minLength: 1 },
+        },
+      },
+    },
+    handler: updateIssue,
+  },
   {
     name: "issues_add_comment",
     description: "Adiciona um comentário em Markdown a uma issue existente.",
@@ -482,7 +516,7 @@ const tools = [
   {
     name: "demands_list",
     description:
-      "Lista melhorias com filtros simples por status, texto e código.",
+      "Lista uma página de melhorias por status, texto, código e coleção. Texto e código parcial são filtrados antes da paginação; consultas com esses filtros percorrem até 100 páginas da API.",
     inputSchema: {
       type: "object",
       additionalProperties: false,
@@ -491,6 +525,12 @@ const tools = [
         text: { type: "string" },
         code: { type: "string" },
         includeDetails: { type: "boolean", default: false },
+        page: { type: "integer", minimum: 1, default: 1 },
+        limit: { type: "integer", minimum: 1, maximum: 100, default: 25 },
+        collectionId: {
+          type: "string",
+          description: "ID da coleção; __root__ filtra melhorias na raiz.",
+        },
         ...KNOWLEDGE_CONTEXT_FILTER_PROPERTIES,
       },
     },
@@ -604,6 +644,10 @@ const tools = [
         fromMonth: { type: "string", description: "YYYY-MM" },
         toMonth: { type: "string", description: "YYYY-MM" },
         status: { type: "string" },
+        collectionId: {
+          type: "string",
+          description: "ID da coleção ou __root__.",
+        },
         ...KNOWLEDGE_CONTEXT_FILTER_PROPERTIES,
       },
     },
@@ -622,6 +666,10 @@ const tools = [
           type: "string",
           description: "YYYY-MM-DD. Default: hoje.",
         },
+        collectionId: {
+          type: "string",
+          description: "ID da coleção ou __root__.",
+        },
         ...KNOWLEDGE_CONTEXT_FILTER_PROPERTIES,
       },
     },

package/src/version.js

@@ -1,2 +1,2 @@
 export const SERVER_NAME = "biaws-mcp";
-export const SERVER_VERSION = "0.9.0";
+export const SERVER_VERSION = "0.10.0";