@rui.branco/jira-mcp 1.6.13 → 1.6.15

package/index.js

@@ -1477,7 +1477,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "jira_add_comment",
         description:
-          "Add a comment to a Jira ticket. IMPORTANT: Use @DisplayName (e.g. @Julia Pereszta) for mentions — NOT [~accountId:...] syntax. Keep comments non-technical and user-facing. Never mention git details like 'pushed to main', branch names, or technical implementation details — stakeholders don't care about that. NEVER use em dashes (—) or en dashes (–) in comments — use commas, periods, or rewrite the sentence instead.",
+          "Add a comment to a Jira ticket. IMPORTANT RULES: (1) Write comments at a HIGH LEVEL for stakeholders, product owners, and managers. Focus on WHAT was done and the business impact, NOT how it was done. Example: 'Implemented the new filtering feature for the dashboard' instead of 'Added a useEffect hook with debounced API calls to filter endpoint'. (2) NEVER mention technical details: no code, no function names, no file paths, no git branches, no commit hashes, no 'pushed to main', no framework-specific terms (React, Angular, hooks, components, etc.). (3) Use @DisplayName (e.g. @Julia Pereszta) for mentions, NOT [~accountId:...] syntax. (4) NEVER use em dashes (—) or en dashes (–), use commas, periods, or rewrite the sentence instead.",
         inputSchema: {
           type: "object",
           properties: {
@@ -2662,16 +2662,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
       }
       if (args.description) {
-        const newParagraph = {
-          type: "paragraph",
-          content: [{ type: "text", text: args.description }],
-        };
+        const adfContent = await buildCommentADF(args.description, inst);
         if (args.replaceDescription) {
           // Full replace
           fields.description = {
             version: 1,
             type: "doc",
-            content: [newParagraph],
+            content: adfContent,
           };
         } else {
           // Append to existing (default)
@@ -2680,13 +2677,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           );
           const existing = issue.fields?.description;
           if (existing && existing.content) {
-            existing.content.push(newParagraph);
+            existing.content.push(...adfContent);
             fields.description = existing;
           } else {
             fields.description = {
               version: 1,
               type: "doc",
-              content: [newParagraph],
+              content: adfContent,
             };
           }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rui.branco/jira-mcp",
-  "version": "1.6.13",
+  "version": "1.6.15",
   "description": "Jira MCP server for Claude Code - fetch tickets, search with JQL, update tickets, manage comments, change status, and get Figma designs",
   "main": "index.js",
   "bin": {