biaws-mcp 0.3.0 → 0.4.0

package/README.md

@@ -213,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.3.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/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.3.0";
+export const SERVER_VERSION = "0.4.0";