bitbucket-mcp-server/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.1] - 2025-08-08

Fixed

• Improved search_code tool response formatting:
  • Added simplified formatCodeSearchOutput for cleaner AI consumption
  • Enhanced HTML entity decoding (handles ", <, >, &, /, ')
  • Improved response structure showing file paths and line numbers clearly
  • Removed HTML formatting tags for better readability

Changed

• Search results now use simplified formatter by default for better AI tool integration
• Enhanced query display to show actual search patterns used

[1.0.0] - 2025-07-25

Added

• New search_code tool for searching code across repositories:
  • Search for code snippets, functions, or any text within Bitbucket repositories
  • Supports searching within a specific repository or across all repositories in a workspace
  • File path pattern filtering with glob patterns (e.g., *.java, src/**/*.ts)
  • Returns matched lines with highlighted segments showing exact matches
  • Pagination support for large result sets
  • Currently only supports Bitbucket Server (Cloud API support planned for future)
• Added SearchHandlers class following the modular architecture pattern
• Added TypeScript interfaces for search requests and responses
• Added formatSearchResults formatter function for consistent output

Changed

• Major version bump to 1.0.0 indicating stable API with comprehensive feature set
• Enhanced documentation with search examples

[0.10.0] - 2025-07-03

Added

• New list_branch_commits tool for retrieving commit history:

  • List all commits in a specific branch with detailed information
  • Advanced filtering options:
    • since and until parameters for date range filtering (ISO date strings)
    • author parameter to filter by author email/username
    • include_merge_commits parameter to include/exclude merge commits (default: true)
    • search parameter to search in commit messages
  • Returns branch head information and paginated commit list
  • Each commit includes hash, message, author details, date, parents, and merge status
  • Supports both Bitbucket Server and Cloud APIs with appropriate parameter mapping
  • Useful for reviewing commit history, tracking changes, and analyzing branch activity

• New list_pr_commits tool for pull request commits:

  • List all commits that are part of a specific pull request
  • Returns PR title and paginated commit list
  • Simpler than branch commits - focused specifically on PR changes
  • Each commit includes same detailed information as branch commits
  • Supports pagination with limit and start parameters
  • Useful for reviewing all changes in a PR before merging

Changed

• Added new TypeScript interfaces for commit types:
  • BitbucketServerCommit and BitbucketCloudCommit for API responses
  • FormattedCommit for consistent commit representation
• Added formatter functions formatServerCommit and formatCloudCommit for unified output
• Enhanced type guards with isListBranchCommitsArgs and isListPrCommitsArgs

[0.9.1] - 2025-01-27

Fixed

• Fixed update_pull_request reviewer preservation:
  • When updating a PR without specifying reviewers, existing reviewers are now preserved
  • Previously, omitting the reviewers parameter would clear all reviewers
  • Now properly includes existing reviewers in the API request when not explicitly updating them
  • When updating reviewers, approval status is preserved for existing reviewers
  • This prevents accidentally removing reviewers when only updating PR title or description

Changed

• Updated tool documentation to clarify reviewer behavior in update_pull_request
• Enhanced README with detailed explanation of reviewer handling

[0.9.0] - 2025-01-26

Added

• Code snippet support in add_comment tool:
  • Added code_snippet parameter to find line numbers automatically using code text
  • Added search_context parameter with before and after arrays to disambiguate multiple matches
  • Added match_strategy parameter with options:
    • "strict" (default): Fails with detailed error when multiple matches found
    • "best": Auto-selects the highest confidence match
  • Returns detailed error with all occurrences when multiple matches found in strict mode
  • Particularly useful for AI-powered code review tools that analyze diffs
• Created comprehensive line matching algorithm that:
  • Parses diffs to find exact code snippets
  • Calculates confidence scores based on context matching
  • Handles added, removed, and context lines appropriately

Changed

• Enhanced add_comment tool to resolve line numbers from code snippets when line_number is not provided
• Improved error messages to include preview and suggestions for resolving ambiguous matches

[0.8.0] - 2025-01-26

Added

• Code suggestions support in add_comment tool:
  • Added suggestion parameter to add code suggestions in comments
  • Added suggestion_end_line parameter for multi-line suggestions
  • Suggestions are formatted using GitHub-style markdown ````suggestion` blocks
  • Works with both single-line and multi-line code replacements
  • Requires file_path and line_number to be specified when using suggestions
  • Compatible with both Bitbucket Cloud and Server
• Created suggestion-formatter.ts utility for formatting suggestion comments

Changed

• Enhanced add_comment tool to validate suggestion requirements
• Updated tool response to indicate when a comment contains a suggestion

[0.7.0] - 2025-01-26

Added

• Enhanced get_pull_request_diff with filtering capabilities:
  • Added include_patterns parameter to filter diff by file patterns (whitelist)
  • Added exclude_patterns parameter to exclude files from diff (blacklist)
  • Added file_path parameter to get diff for a specific file only
  • Patterns support standard glob syntax (e.g., *.js, src/**/*.res, node_modules/**)
  • Response includes filtering metadata showing total files, included/excluded counts, and excluded file list
• Added minimatch dependency for glob pattern matching
• Created DiffParser utility class for parsing and filtering unified diff format

Changed

• Modified get_pull_request_diff tool to support optional filtering without breaking existing usage
• Updated tool definition and type guards to include new optional parameters
• Enhanced documentation with comprehensive examples of filtering usage

[0.6.1] - 2025-01-26

Added

• Support for nested comment replies in Bitbucket Server
  • Added replies field to FormattedComment interface to support nested comment threads
  • Comments now include nested replies that are still relevant (not orphaned or resolved)
  • Total and active comment counts now include nested replies

Changed

• Updated comment fetching logic to handle Bitbucket Server's nested comment structure
  • Server uses comments array inside each comment object for replies
  • Cloud continues to use parent field for reply relationships
• Improved comment filtering to exclude orphaned inline comments when code has changed

Fixed

• Fixed missing comment replies in PR details - replies are now properly included in the response

[0.6.0] - 2025-01-26

Added

• Enhanced get_pull_request with active comments and file changes:
  • Fetches and displays active (unresolved) comments that need attention
  • Shows up to 20 most recent active comments with:
    • Comment text, author, and creation date
    • Inline comment details (file path and line number)
    • Comment state (OPEN/RESOLVED for Server)
  • Provides comment counts:
    • active_comment_count: Total unresolved comments
    • total_comment_count: Total comments including resolved
  • Includes file change statistics:
    • List of all modified files with lines added/removed
    • File status (added, modified, removed, renamed)
    • Summary statistics (total files, lines added/removed)
• Added new TypeScript interfaces for comments and file changes
• Added FormattedComment and FormattedFileChange types for consistent response format

Changed

• Modified handleGetPullRequest to make parallel API calls for better performance
• Enhanced error handling to gracefully continue if comment/file fetching fails

[0.5.0] - 2025-01-21

Added

• New file and directory handling tools:
  • list_directory_content - List files and directories in any repository path
    • Shows file/directory type, size, and full paths
    • Supports browsing specific branches
    • Works with both Bitbucket Server and Cloud APIs
  • get_file_content - Retrieve file content with smart truncation for large files
    • Automatic smart defaults by file type (config: 200 lines, docs: 300 lines, code: 500 lines)
    • Pagination support with start_line and line_count parameters
    • Tail functionality using negative start_line values (e.g., -50 for last 50 lines)
    • Automatic truncation for files >50KB to prevent token overload
    • Files >1MB require explicit full_content: true parameter
    • Returns metadata including file size, encoding, and last modified info
• Added FileHandlers class following existing modular architecture patterns
• Added TypeScript interfaces for file/directory entries and metadata
• Added type guards isListDirectoryContentArgs and isGetFileContentArgs

Changed

• Enhanced documentation with comprehensive examples for file handling tools

[0.4.0] - 2025-01-21

Added

• New get_branch tool for comprehensive branch information:
  • Returns detailed branch information including name, ID, and latest commit details
  • Lists all open pull requests originating from the branch with approval status
  • Optionally includes merged pull requests when include_merged_prs is true
  • Provides useful statistics like PR counts and days since last commit
  • Supports both Bitbucket Server and Cloud APIs
  • Particularly useful for checking if a branch has open PRs before deletion
• Added TypeScript interfaces for BitbucketServerBranch and BitbucketCloudBranch
• Added type guard isGetBranchArgs for input validation

Changed

• Updated documentation to include the new get_branch tool with comprehensive examples

[0.3.0] - 2025-01-06

Added

• Enhanced merge commit details in get_pull_request:
  • Added merge_commit_hash field for both Cloud and Server
  • Added merged_by field showing who performed the merge
  • Added merged_at timestamp for when the merge occurred
  • Added merge_commit_message with the merge commit message
  • For Bitbucket Server: Fetches merge details from activities API when PR is merged
  • For Bitbucket Cloud: Extracts merge information from existing response fields

Changed

• Major code refactoring for better maintainability:
  • Split monolithic index.ts into modular architecture
  • Created separate handler classes for different tool categories:
    • PullRequestHandlers for PR lifecycle operations
    • BranchHandlers for branch management
    • ReviewHandlers for code review tools
  • Extracted types into dedicated files (types/bitbucket.ts, types/guards.ts)
  • Created utility modules (utils/api-client.ts, utils/formatters.ts)
  • Centralized tool definitions in tools/definitions.ts
• Improved error handling and API client abstraction
• Better separation of concerns between Cloud and Server implementations

Fixed

• Improved handling of merge commit information retrieval failures
• Fixed API parameter passing for GET requests across all handlers (was passing config as third parameter instead of fourth)
• Updated Bitbucket Server branch listing to use /rest/api/latest/ endpoint with proper parameters
• Branch filtering now works correctly with the filterText parameter for Bitbucket Server

[0.2.0] - 2025-06-04

Added

• Complete implementation of all Bitbucket MCP tools
• Support for both Bitbucket Cloud and Server
• Core PR lifecycle tools:
  • create_pull_request - Create new pull requests
  • update_pull_request - Update PR details
  • merge_pull_request - Merge pull requests
  • list_branches - List repository branches
  • delete_branch - Delete branches
• Enhanced add_comment with inline comment support
• Code review tools:
  • get_pull_request_diff - Get PR diff/changes
  • approve_pull_request - Approve PRs
  • unapprove_pull_request - Remove approval
  • request_changes - Request changes on PRs
  • remove_requested_changes - Remove change requests
• npm package configuration for easy installation via npx

Fixed

• Author filter for Bitbucket Server (uses role.1=AUTHOR and username.1=email)
• Branch deletion handling for 204 No Content responses

Changed

• Package name to @nexus2520/bitbucket-mcp-server for npm publishing

[0.1.0] - 2025-06-03

Added

• Initial implementation with basic tools:
  • get_pull_request - Get PR details
  • list_pull_requests - List PRs with filters
• Support for Bitbucket Cloud with app passwords
• Support for Bitbucket Server with HTTP access tokens
• Authentication setup script
• Comprehensive documentation