@stubbedev/atlassian-mcp 0.2.8 → 0.2.9

package/README.md

@@ -39,7 +39,7 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 | `bitbucket_search` | Discover resources: `pull_requests` (default), `repos`, or `branches` via `resource` param; `mine=true` for your inbox |
 | `bitbucket_get_pr` | Full PR details: metadata, commits, comments, blockers, build status, and optional diff |
 | `bitbucket_mutate` | Create/update a PR, or perform lifecycle actions: `approve`, `unapprove`, `merge`, `decline` |
-| `bitbucket_comment` | Add, update, or delete a PR comment; supports inline anchors, multiline, suggestions, and BLOCKER severity |
+| `bitbucket_comment` | Add, update, or delete a PR comment; for code changes use `suggestion` so Bitbucket shows Apply suggestion (no trailing text after a suggestion block) |
 | `bitbucket_get_file` | Raw file content from Bitbucket at a branch, tag, or commit |
 | `bitbucket_pr_tasks` | Manage PR tasks (checklist items): `list`, `create`, `resolve`, `reopen`, `delete` |
 

package/dist/bitbucket.js

@@ -180,6 +180,18 @@ function validateCommentText(textValue) {
     }
     return trimmed;
 }
+function validateSuggestionPlacement(textValue) {
+    if (!textValue.includes('```suggestion'))
+        return;
+    const match = textValue.match(/```suggestion[^\n]*\n[\s\S]*?\n```/);
+    if (!match || match.index === undefined) {
+        throw new Error('Invalid suggestion block format. Use the suggestion field to post code suggestions.');
+    }
+    const trailingText = textValue.slice(match.index + match[0].length).trim();
+    if (trailingText.length > 0) {
+        throw new Error('When using ```suggestion```, do not add text after the closing code fence. Put any explanation before the suggestion block or use the suggestion field.');
+    }
+}
 export class BitbucketClient {
     baseUrl;
     headers;
@@ -810,10 +822,21 @@ export class BitbucketClient {
                 || args.multilineStartLineType !== undefined)) {
             throw new Error('Replies must target an existing comment thread only. Omit filePath/line and other anchor fields when replying.');
         }
-        let commentText = args.text;
+        if (args.text === undefined && args.suggestion === undefined) {
+            throw new Error('Either text or suggestion is required when adding a comment.');
+        }
+        let commentText = args.text ?? '';
         if (args.suggestion !== undefined) {
-            const suggestionBlock = `\`\`\`suggestion\n${args.suggestion}\n\`\`\``;
-            commentText = args.text ? `${args.text}\n\n${suggestionBlock}` : suggestionBlock;
+            const suggestion = args.suggestion.trim();
+            if (!suggestion) {
+                throw new Error('suggestion must not be empty.');
+            }
+            const suggestionBlock = `\`\`\`suggestion\n${suggestion}\n\`\`\``;
+            const prefix = (args.text ?? '').trim();
+            commentText = prefix ? `${prefix}\n\n${suggestionBlock}` : suggestionBlock;
+        }
+        else {
+            validateSuggestionPlacement(commentText);
         }
         const body = { text: validateCommentText(commentText) };
         if (args.severity)

package/dist/index.js

@@ -348,7 +348,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             },
             {
                 name: 'bitbucket_comment',
-                description: `Add, update, or delete a PR comment. action defaults to "add". For review feedback, prefer inline comments with a code suggestion. Replies MUST use commentId. Keep comments concise, no emojis. Only call proactively (without being asked) when you are a reviewer on the PR (i.e. "Viewing as" says "you are a reviewer") — never post unsolicited comments on PRs you authored.`,
+                description: `Add, update, or delete a PR comment. action defaults to "add". For code changes, ALWAYS use inline comments with suggestion when exact replacement code is available. Keep any explanatory text before the suggestion block only (never after), or Bitbucket may hide Apply suggestion. Replies MUST use commentId. Keep comments concise, no emojis. Only call proactively (without being asked) when you are a reviewer on the PR (i.e. "Viewing as" says "you are a reviewer") — never post unsolicited comments on PRs you authored.`,
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -359,7 +359,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         repo: { type: 'string', description: 'Alias for repoSlug' },
                         prId: { type: 'number', description: 'Pull request number' },
                         commentId: { type: 'number', description: 'Comment ID to reply to, update, or delete' },
-                        text: { type: 'string', description: 'Comment text. No filler, no emojis. Required for add/update.' },
+                        text: { type: 'string', description: 'Comment text for add/update. No filler, no emojis. If suggestion is used, keep this optional and brief; it is placed before the suggestion block.' },
                         filePath: { type: 'string', description: 'File path for inline comment (must pair with line)' },
                         srcPath: { type: 'string', description: 'Source path if file was renamed (optional, defaults to filePath)' },
                         line: { type: 'number', description: 'Line number to anchor inline comment (must pair with filePath)' },
@@ -367,7 +367,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         fileType: { type: 'string', enum: ['TO', 'FROM'], description: 'Diff side: TO (new, default) or FROM (old)' },
                         multilineStartLine: { type: 'number', description: 'First line of multiline anchor (pair with line as last line)' },
                         multilineStartLineType: { type: 'string', enum: ['ADDED', 'REMOVED', 'CONTEXT'], description: 'Line type for multilineStartLine' },
-                        suggestion: { type: 'string', description: 'Replacement code to suggest (strongly preferred for code changes). Requires filePath + line.' },
+                        suggestion: { type: 'string', description: 'Replacement code to suggest. Use whenever proposing a concrete code change. Posted as the final ```suggestion``` block so Apply suggestion appears. Requires filePath + line.' },
                         state: { type: 'string', enum: ['OPEN', 'RESOLVED'], description: 'Task state for BLOCKER comments (update only)' },
                         threadResolved: { type: 'boolean', description: 'Resolve/reopen normal comment thread (update only)' },
                         severity: { type: 'string', enum: ['NORMAL', 'BLOCKER'], description: 'Comment severity. BLOCKER = checklist task.' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "MCP server for self-hosted Jira and Bitbucket",
   "license": "MIT",
   "type": "module",