@zereight/mcp-gitlab 2.1.11 → 2.1.12

package/README.md

@@ -540,111 +540,112 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
 47. `my_issues` - List issues assigned to the authenticated user (defaults to open issues)
 48. `get_issue` - Get details of a specific issue in a GitLab project
 49. `update_issue` - Update an issue in a GitLab project
-50. `delete_issue` - Delete an issue from a GitLab project
-51. `list_todos` - List GitLab to-do items for the current user
-52. `mark_todo_done` - Mark a GitLab to-do item as done
-53. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
-54. `list_issue_links` - List all issue links for a specific issue
-55. `list_issue_discussions` - List discussions for an issue in a GitLab project
-56. `get_issue_link` - Get a specific issue link
-57. `create_issue_link` - Create an issue link between two issues
-58. `delete_issue_link` - Delete an issue link
-59. `list_namespaces` - List all namespaces available to the current user
-60. `get_namespace` - Get details of a namespace by ID or path
-61. `verify_namespace` - Verify if a namespace path exists
-62. `get_project` - Get details of a specific project
-63. `list_projects` - List projects accessible by the current user
-64. `list_project_members` - List members of a GitLab project
-65. `list_group_projects` - List projects in a GitLab group with filtering options
-66. `list_group_iterations` - List group iterations with filtering options
-67. `list_labels` - List labels for a project
-68. `get_label` - Get a single label from a project
-69. `create_label` - Create a new label in a project
-70. `update_label` - Update an existing label in a project
-71. `delete_label` - Delete a label from a project
-72. `list_pipelines` - List pipelines in a GitLab project with filtering options
-73. `get_pipeline` - Get details of a specific pipeline in a GitLab project
-74. `list_pipeline_jobs` - List all jobs in a specific pipeline
-75. `list_pipeline_trigger_jobs` - List all trigger jobs (bridges) in a specific pipeline that trigger downstream pipelines
-76. `get_pipeline_job` - Get details of a GitLab pipeline job number
-77. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job with optional pagination to limit context window usage
-78. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
-79. `validate_project_ci_lint` - Validate an existing `.gitlab-ci.yml` configuration for a project
-80. `create_pipeline` - Create a new pipeline for a branch or tag
-81. `retry_pipeline` - Retry a failed or canceled pipeline
-82. `cancel_pipeline` - Cancel a running pipeline
-83. `play_pipeline_job` - Run a manual pipeline job
-84. `retry_pipeline_job` - Retry a failed or canceled pipeline job
-85. `cancel_pipeline_job` - Cancel a running pipeline job
-86. `list_deployments` - List deployments in a GitLab project with filtering options
-87. `get_deployment` - Get details of a specific deployment in a GitLab project
-88. `list_environments` - List environments in a GitLab project
-89. `get_environment` - Get details of a specific environment in a GitLab project
-90. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
-91. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
-92. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
-93. `list_milestones` - List milestones in a GitLab project with filtering options
-94. `get_milestone` - Get details of a specific milestone
-95. `create_milestone` - Create a new milestone in a GitLab project
-96. `edit_milestone` - Edit an existing milestone in a GitLab project
-97. `delete_milestone` - Delete a milestone from a GitLab project
-98. `get_milestone_issue` - Get issues associated with a specific milestone
-99. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
-100. `promote_milestone` - Promote a milestone to the next stage
-101. `get_milestone_burndown_events` - Get burndown events for a specific milestone
-102. `list_wiki_pages` - List wiki pages in a GitLab project
-103. `get_wiki_page` - Get details of a specific wiki page
-104. `create_wiki_page` - Create a new wiki page in a GitLab project
-105. `update_wiki_page` - Update an existing wiki page in a GitLab project
-106. `delete_wiki_page` - Delete a wiki page from a GitLab project
-107. `list_group_wiki_pages` - List wiki pages in a GitLab group
-108. `get_group_wiki_page` - Get details of a specific group wiki page
-109. `create_group_wiki_page` - Create a new wiki page in a GitLab group
-110. `update_group_wiki_page` - Update an existing wiki page in a GitLab group
-111. `delete_group_wiki_page` - Delete a wiki page from a GitLab group
-112. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
-113. `list_commits` - List repository commits with filtering options
-114. `get_commit` - Get details of a specific commit
-115. `get_commit_diff` - Get changes/diffs of a specific commit
-116. `list_commit_statuses` - List statuses for a specific commit
-117. `create_commit_status` - Create or update the status of a specific commit
-118. `list_releases` - List all releases for a project
-119. `get_release` - Get a release by tag name
-120. `create_release` - Create a new release in a GitLab project
-121. `update_release` - Update an existing release in a GitLab project
-122. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
-123. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
-124. `download_release_asset` - Download a release asset file by direct asset path
-125. `list_tags` - List repository tags with filtering and pagination support
-126. `get_tag` - Get details of a specific repository tag
-127. `create_tag` - Create a new tag in the repository
-128. `delete_tag` - Delete a tag from the repository
-129. `get_tag_signature` - Get the signature of a signed tag
-130. `get_users` - Get GitLab user details by usernames
-131. `list_events` - List all events for the currently authenticated user
-132. `get_project_events` - List all visible events for a specified project
-133. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
-134. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
-135. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
-136. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
-137. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
-138. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
-139. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
-140. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
-141. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
-142. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
-143. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
-144. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
-145. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
-146. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
-147. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
-148. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
-149. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
-150. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
-151. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
-152. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
-153. `execute_graphql` - Execute a GitLab GraphQL query
-154. `list_merge_request_pipelines` - List pipelines for a merge request with pagination support
+50. `update_issue_description_patch` - Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by sending only the change instead of the full description. Supports `dry_run` to preview and `create_note` to summarize.
+51. `delete_issue` - Delete an issue from a GitLab project
+52. `list_todos` - List GitLab to-do items for the current user
+53. `mark_todo_done` - Mark a GitLab to-do item as done
+54. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
+55. `list_issue_links` - List all issue links for a specific issue
+56. `list_issue_discussions` - List discussions for an issue in a GitLab project
+57. `get_issue_link` - Get a specific issue link
+58. `create_issue_link` - Create an issue link between two issues
+59. `delete_issue_link` - Delete an issue link
+60. `list_namespaces` - List all namespaces available to the current user
+61. `get_namespace` - Get details of a namespace by ID or path
+62. `verify_namespace` - Verify if a namespace path exists
+63. `get_project` - Get details of a specific project
+64. `list_projects` - List projects accessible by the current user
+65. `list_project_members` - List members of a GitLab project
+66. `list_group_projects` - List projects in a GitLab group with filtering options
+67. `list_group_iterations` - List group iterations with filtering options
+68. `list_labels` - List labels for a project
+69. `get_label` - Get a single label from a project
+70. `create_label` - Create a new label in a project
+71. `update_label` - Update an existing label in a project
+72. `delete_label` - Delete a label from a project
+73. `list_pipelines` - List pipelines in a GitLab project with filtering options
+74. `get_pipeline` - Get details of a specific pipeline in a GitLab project
+75. `list_pipeline_jobs` - List all jobs in a specific pipeline
+76. `list_pipeline_trigger_jobs` - List all trigger jobs (bridges) in a specific pipeline that trigger downstream pipelines
+77. `get_pipeline_job` - Get details of a GitLab pipeline job number
+78. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job with optional pagination to limit context window usage
+79. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
+80. `validate_project_ci_lint` - Validate an existing `.gitlab-ci.yml` configuration for a project
+81. `create_pipeline` - Create a new pipeline for a branch or tag
+82. `retry_pipeline` - Retry a failed or canceled pipeline
+83. `cancel_pipeline` - Cancel a running pipeline
+84. `play_pipeline_job` - Run a manual pipeline job
+85. `retry_pipeline_job` - Retry a failed or canceled pipeline job
+86. `cancel_pipeline_job` - Cancel a running pipeline job
+87. `list_deployments` - List deployments in a GitLab project with filtering options
+88. `get_deployment` - Get details of a specific deployment in a GitLab project
+89. `list_environments` - List environments in a GitLab project
+90. `get_environment` - Get details of a specific environment in a GitLab project
+91. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
+92. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
+93. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
+94. `list_milestones` - List milestones in a GitLab project with filtering options
+95. `get_milestone` - Get details of a specific milestone
+96. `create_milestone` - Create a new milestone in a GitLab project
+97. `edit_milestone` - Edit an existing milestone in a GitLab project
+98. `delete_milestone` - Delete a milestone from a GitLab project
+99. `get_milestone_issue` - Get issues associated with a specific milestone
+100. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
+101. `promote_milestone` - Promote a milestone to the next stage
+102. `get_milestone_burndown_events` - Get burndown events for a specific milestone
+103. `list_wiki_pages` - List wiki pages in a GitLab project
+104. `get_wiki_page` - Get details of a specific wiki page
+105. `create_wiki_page` - Create a new wiki page in a GitLab project
+106. `update_wiki_page` - Update an existing wiki page in a GitLab project
+107. `delete_wiki_page` - Delete a wiki page from a GitLab project
+108. `list_group_wiki_pages` - List wiki pages in a GitLab group
+109. `get_group_wiki_page` - Get details of a specific group wiki page
+110. `create_group_wiki_page` - Create a new wiki page in a GitLab group
+111. `update_group_wiki_page` - Update an existing wiki page in a GitLab group
+112. `delete_group_wiki_page` - Delete a wiki page from a GitLab group
+113. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
+114. `list_commits` - List repository commits with filtering options
+115. `get_commit` - Get details of a specific commit
+116. `get_commit_diff` - Get changes/diffs of a specific commit
+117. `list_commit_statuses` - List statuses for a specific commit
+118. `create_commit_status` - Create or update the status of a specific commit
+119. `list_releases` - List all releases for a project
+120. `get_release` - Get a release by tag name
+121. `create_release` - Create a new release in a GitLab project
+122. `update_release` - Update an existing release in a GitLab project
+123. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
+124. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
+125. `download_release_asset` - Download a release asset file by direct asset path
+126. `list_tags` - List repository tags with filtering and pagination support
+127. `get_tag` - Get details of a specific repository tag
+128. `create_tag` - Create a new tag in the repository
+129. `delete_tag` - Delete a tag from the repository
+130. `get_tag_signature` - Get the signature of a signed tag
+131. `get_users` - Get GitLab user details by usernames
+132. `list_events` - List all events for the currently authenticated user
+133. `get_project_events` - List all visible events for a specified project
+134. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
+135. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
+136. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
+137. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
+138. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
+139. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
+140. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
+141. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
+142. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
+143. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
+144. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
+145. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
+146. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
+147. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
+148. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
+149. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
+150. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
+151. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
+152. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
+153. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
+154. `execute_graphql` - Execute a GitLab GraphQL query
+155. `list_merge_request_pipelines` - List pipelines for a merge request with pagination support
 
 <!-- TOOLS-END -->
 

package/build/index.js

@@ -21,17 +21,18 @@ import { createGitLabOAuthProvider } from "./oauth-proxy.js";
 import { mcpAuthRouter } from "@modelcontextprotocol/sdk/server/auth/router.js";
 import { normalizeGitLabApiUrl } from "./utils/url.js";
 import { estimateMergeCommitCount, filterDiffsByPatterns, summarizeWebhookEvents } from "./utils/helpers.js";
+import { parseSearchReplaceBlocks, applySearchReplace, applyUnifiedDiff, } from "./utils/patch-helper.js";
 import { requireBearerAuth } from "@modelcontextprotocol/sdk/server/auth/middleware/bearerAuth.js";
 import { GitLabClientPool } from "./gitlab-client-pool.js";
 import { allTools, readOnlyTools, destructiveTools, parseEnabledToolsets, parseIndividualTools, buildFeatureFlagOverrides, isToolInEnabledToolset, TOOLSET_DEFINITIONS, ALL_TOOLSET_IDS, } from "./tools/registry.js";
 import { BulkPublishDraftNotesSchema, CancelPipelineJobSchema, CancelPipelineSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, // Added
-CreateMergeRequestNoteSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, CreateMergeRequestNoteEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateRepositorySchema, CreateWikiPageSchema, CreateGroupWikiPageSchema, DeleteDraftNoteSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteProjectMilestoneSchema, DeleteWikiPageSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, EditProjectMilestoneSchema, ForkRepositorySchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetDraftNoteSchema, GetFileContentsSchema, GetIssueLinkSchema, GetIssueSchema, GetLabelSchema, GetMergeRequestDiffsSchema, GetMergeRequestSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetDeploymentSchema, GetEnvironmentSchema, GetNamespaceSchema, GitLabCiLintResultSchema, GetPipelineJobOutputSchema, GetPipelineSchema, GetProjectMilestoneSchema, GetProjectSchema, GetRepositoryTreeSchema, GetUsersSchema, GetUserSchema, GitLabUserFullSchema, WhoAmISchema, GitLabCurrentUserSchema, GetWikiPageSchema, GitLabCommitSchema, GitLabCommitStatusSchema, GitLabCompareResultSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabDiffSchema, 
+CreateMergeRequestNoteSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, CreateMergeRequestNoteEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateRepositorySchema, CreateWikiPageSchema, CreateGroupWikiPageSchema, DeleteBranchSchema, DeleteDraftNoteSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteProjectMilestoneSchema, DeleteWikiPageSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, EditProjectMilestoneSchema, ForkRepositorySchema, GetBranchDiffsSchema, GetBranchSchema, GetCommitDiffSchema, GetCommitSchema, GetDraftNoteSchema, GetFileContentsSchema, GetIssueLinkSchema, GetIssueSchema, GetLabelSchema, GetMergeRequestDiffsSchema, GetMergeRequestSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetDeploymentSchema, GetEnvironmentSchema, GetNamespaceSchema, GitLabCiLintResultSchema, GetPipelineJobOutputSchema, GetPipelineSchema, GetProjectMilestoneSchema, GetProjectSchema, GetRepositoryTreeSchema, GetUsersSchema, GetUserSchema, GitLabUserFullSchema, WhoAmISchema, GitLabCurrentUserSchema, GetWikiPageSchema, GitLabCommitSchema, GitLabCommitStatusSchema, GitLabCompareResultSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabDiffSchema, 
 // Discussion Schemas
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, 
 // Draft Notes Schemas
-GitLabDraftNoteSchema, GitLabForkSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabMilestonesSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GitLabWikiPageSchema, GroupIteration, ListCommitStatusesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListLabelsSchema, ListMergeRequestDiffsSchema, // Added
-GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, GetGroupWikiPageSchema, ListGroupWikiPagesSchema, UpdateGroupWikiPageSchema, MarkdownUploadSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalsResponseSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateLabelSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListTagsSchema, GetTagSchema, CreateTagSchema, DeleteTagSchema, GetTagSignatureSchema, GitLabTagSchema, GitLabTagSignatureSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
+GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabMilestonesSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GitLabWikiPageSchema, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListLabelsSchema, ListMergeRequestDiffsSchema, // Added
+GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, GetGroupWikiPageSchema, ListGroupWikiPagesSchema, UpdateGroupWikiPageSchema, MarkdownUploadSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalsResponseSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListTagsSchema, GetTagSchema, CreateTagSchema, DeleteTagSchema, GetTagSignatureSchema, GitLabTagSchema, GitLabTagSignatureSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
 import { randomUUID } from "node:crypto";
 import { pino } from "pino";
 const logger = pino({
@@ -6683,6 +6684,81 @@ async function handleToolCall(params) {
                     content: [{ type: "text", text: JSON.stringify(issue, null, 2) }],
                 };
             }
+            case "update_issue_description_patch": {
+                const args = UpdateIssueDescriptionPatchSchema.parse(params.arguments);
+                const { project_id, issue_iid, patch_type, patch, dry_run, create_note, allow_multiple } = args;
+                // Fetch current issue description
+                const currentIssue = await getIssue(project_id, issue_iid);
+                const currentDescription = currentIssue.description ?? "";
+                // Apply the patch
+                let result;
+                if (patch_type === "search_replace") {
+                    const blocks = parseSearchReplaceBlocks(patch);
+                    if (blocks.length === 0) {
+                        throw new Error("No valid search/replace blocks found. Expected format: <<<<<<< SEARCH\\ntext\\n=======\\nnew text\\n>>>>>>> REPLACE");
+                    }
+                    result = applySearchReplace(currentDescription, blocks, allow_multiple);
+                }
+                else {
+                    // unified_diff
+                    result = applyUnifiedDiff(currentDescription, patch);
+                }
+                // Dry-run: return preview without updating
+                if (dry_run) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    status: "preview",
+                                    dry_run: true,
+                                    changes: result.changes,
+                                    summary: result.summary,
+                                    preview: result.preview,
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                // Apply the update
+                const updatedIssue = await updateIssue(project_id, issue_iid, {
+                    description: result.description,
+                });
+                // Optionally create a note summarizing the change
+                let noteResult = null;
+                if (create_note) {
+                    try {
+                        const noteBody = `Updated issue description using patch-based tool.\n\n${result.summary}`;
+                        await createIssueNote(project_id, issue_iid, undefined, noteBody);
+                        noteResult = { status: "created" };
+                    }
+                    catch (noteError) {
+                        noteResult = {
+                            status: "failed",
+                            message: `Note creation failed: ${noteError.message ?? noteError}`,
+                        };
+                    }
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "success",
+                                changes: result.changes,
+                                summary: result.summary,
+                                note: noteResult,
+                                issue: {
+                                    iid: updatedIssue.iid,
+                                    title: updatedIssue.title,
+                                    web_url: updatedIssue.web_url,
+                                    updated_at: updatedIssue.updated_at,
+                                },
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
             case "delete_issue": {
                 const args = DeleteIssueSchema.parse(params.arguments);
                 await deleteIssue(args.project_id, args.issue_iid);
@@ -7612,6 +7688,56 @@ async function handleToolCall(params) {
                     content: [{ type: "text", text: JSON.stringify({ status: authenticated ? "ok" : "error", authenticated, gitlab_url: getEffectiveApiUrl() }) }],
                 };
             }
+            case "get_branch": {
+                const args = GetBranchSchema.parse(params.arguments);
+                const projectId = decodeURIComponent(args.project_id);
+                const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/branches/${encodeURIComponent(args.branch_name)}`);
+                const response = await fetch(url.toString(), {
+                    ...getFetchConfig(),
+                });
+                await handleGitLabError(response);
+                const data = await response.json();
+                const branch = GitLabBranchSchema.parse(data);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(branch, null, 2) }],
+                };
+            }
+            case "list_branches": {
+                const args = ListBranchesSchema.parse(params.arguments);
+                const projectId = decodeURIComponent(args.project_id);
+                const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/branches`);
+                if (args.search) {
+                    url.searchParams.append("search", args.search);
+                }
+                if (args.page) {
+                    url.searchParams.append("page", args.page.toString());
+                }
+                if (args.per_page) {
+                    url.searchParams.append("per_page", args.per_page.toString());
+                }
+                const response = await fetch(url.toString(), {
+                    ...getFetchConfig(),
+                });
+                await handleGitLabError(response);
+                const data = await response.json();
+                const branches = z.array(GitLabBranchSchema).parse(data);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(branches, null, 2) }],
+                };
+            }
+            case "delete_branch": {
+                const args = DeleteBranchSchema.parse(params.arguments);
+                const projectId = decodeURIComponent(args.project_id);
+                const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/branches/${encodeURIComponent(args.branch_name)}`);
+                const response = await fetch(url.toString(), {
+                    ...getFetchConfig(),
+                    method: "DELETE",
+                });
+                await handleGitLabError(response);
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ status: "deleted", branch: args.branch_name }, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${params.name}`);
         }

package/build/schemas.js

@@ -1472,6 +1472,37 @@ export const CreateBranchSchema = ProjectParamsSchema.extend({
     branch: z.string().describe("Name for the new branch"),
     ref: z.string().optional().describe("Source branch/commit for new branch"),
 });
+export const GetBranchSchema = ProjectParamsSchema.extend({
+    branch_name: z.string().describe("Name of the branch"),
+});
+export const ListBranchesSchema = ProjectParamsSchema.extend({
+    search: z.string().optional().describe("Search term to filter branches by name"),
+}).merge(PaginationOptionsSchema);
+export const DeleteBranchSchema = ProjectParamsSchema.extend({
+    branch_name: z.string().describe("Name of the branch to delete"),
+});
+export const GitLabBranchSchema = z.object({
+    name: z.string(),
+    commit: z.object({
+        id: z.string(),
+        short_id: z.string(),
+        title: z.string(),
+        author_name: z.string(),
+        author_email: z.string(),
+        authored_date: z.string(),
+        committer_name: z.string(),
+        committer_email: z.string(),
+        committed_date: z.string(),
+        web_url: z.string(),
+    }),
+    merged: z.boolean(),
+    protected: z.boolean(),
+    developers_can_push: z.boolean(),
+    developers_can_merge: z.boolean(),
+    can_push: z.boolean(),
+    default: z.boolean(),
+    web_url: z.string().optional(),
+});
 export const GetBranchDiffsSchema = ProjectParamsSchema.extend({
     from: z.string().describe("The base branch or commit SHA to compare from"),
     to: z.string().describe("The target branch or commit SHA to compare to"),
@@ -1839,6 +1870,22 @@ export const DeleteIssueSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     issue_iid: z.coerce.string().describe("The internal ID of the project issue"),
 });
+export const UpdateIssueDescriptionPatchSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.coerce.string().describe("The internal ID of the project issue"),
+    patch_type: z.enum(["search_replace", "unified_diff"]).describe("Type of patch format to apply"),
+    patch: z
+        .string()
+        .min(1)
+        .max(50000)
+        .describe("The patch content to apply to the issue description"),
+    dry_run: z.coerce.boolean().optional().describe("If true, preview changes without updating the issue"),
+    create_note: z.coerce.boolean().optional().describe("If true, add a note summarizing the change after update"),
+    allow_multiple: z
+        .coerce.boolean()
+        .optional()
+        .describe("For search_replace: allow multiple matches to all be replaced (default: false — fail on duplicate)"),
+});
 // Issue links related schemas
 export const GitLabIssueLinkSchema = z.object({
     source_issue: GitLabIssueSchema,

package/build/test/test-issue-description-patch.js

@@ -0,0 +1,256 @@
+/**
+ * Tests for the update_issue_description_patch tool.
+ * Tests search_replace, unified_diff, dry_run, create_note, and edge cases.
+ */
+import { describe, test, before, after } from "node:test";
+import assert from "node:assert";
+import { launchServer, cleanupServers, TransportMode, HOST, } from "./utils/server-launcher.js";
+import { MockGitLabServer, findMockServerPort, } from "./utils/mock-gitlab-server.js";
+import { CustomHeaderClient } from "./clients/custom-header-client.js";
+import { parseSearchReplaceBlocks, applySearchReplace, applyUnifiedDiff, } from "../utils/patch-helper.js";
+const MOCK_TOKEN = "glpat-patch-test-token-12345";
+// ---- Unit tests for patch helper ----
+describe("parseSearchReplaceBlocks", () => {
+    test("parses a single block", () => {
+        const blocks = parseSearchReplaceBlocks("<<<<<<< SEARCH\nold text\n=======\nnew text\n>>>>>>> REPLACE");
+        assert.strictEqual(blocks.length, 1);
+        assert.strictEqual(blocks[0].search, "old text");
+        assert.strictEqual(blocks[0].replace, "new text");
+    });
+    test("parses multiple blocks", () => {
+        const blocks = parseSearchReplaceBlocks("<<<<<<< SEARCH\nfirst\n=======\nfirst new\n>>>>>>> REPLACE\n<<<<<<< SEARCH\nsecond\n=======\nsecond new\n>>>>>>> REPLACE");
+        assert.strictEqual(blocks.length, 2);
+    });
+    test("handles empty content", () => {
+        const blocks = parseSearchReplaceBlocks("");
+        assert.strictEqual(blocks.length, 0);
+    });
+    test("ignores text outside blocks", () => {
+        const blocks = parseSearchReplaceBlocks("prefix\n<<<<<<< SEARCH\nx\n=======\ny\n>>>>>>> REPLACE\nsuffix");
+        assert.strictEqual(blocks.length, 1);
+    });
+    test("rejects malformed block with missing REPLACE marker", () => {
+        assert.throws(() => parseSearchReplaceBlocks("<<<<<<< SEARCH\nfirst\n=======\nfirst new\n>>>>>>> REPLACE\n" +
+            "<<<<<<< SEARCH\nsecond\n=======\nsecond new\n>>>>>>> TYPO"), /malformed|Marker|marker/);
+    });
+    test("rejects block with missing ======= marker", () => {
+        assert.throws(() => parseSearchReplaceBlocks("<<<<<<< SEARCH\nfoo\n\nbar\n>>>>>>> REPLACE"), /malformed|Marker|marker/);
+    });
+    test("allows prose around valid blocks", () => {
+        const blocks = parseSearchReplaceBlocks("# Some notes\n\n<<<<<<< SEARCH\nfoo\n=======\nbar\n>>>>>>> REPLACE\n\nMore context");
+        assert.strictEqual(blocks.length, 1);
+    });
+});
+describe("applySearchReplace", () => {
+    test("replaces single occurrence", () => {
+        const result = applySearchReplace("Status: In progress\nDone.", [
+            { search: "Status: In progress", replace: "Status: Done" },
+        ]);
+        assert.strictEqual(result.description, "Status: Done\nDone.");
+        assert.strictEqual(result.changes, 1);
+        assert.ok(result.summary.includes("Status: In progress"));
+        assert.ok(result.preview.includes("-Status: In progress"));
+    });
+    test("fails on no match", () => {
+        assert.throws(() => applySearchReplace("Some text.", [{ search: "Nonexistent", replace: "x" }]), /Search text not found/);
+    });
+    test("rejects empty SEARCH body", () => {
+        assert.throws(() => applySearchReplace("Some text.", [{ search: "", replace: "x" }], true), /Empty SEARCH/);
+    });
+    test("fails on duplicate without allowMultiple", () => {
+        assert.throws(() => applySearchReplace("x\ny\nx\n", [{ search: "x", replace: "z" }]), /matches 2 times/);
+    });
+    test("replaces all with allowMultiple", () => {
+        const result = applySearchReplace("x\ny\nx\n", [{ search: "x", replace: "z" }], true);
+        assert.strictEqual(result.changes, 2);
+        assert.strictEqual(result.description, "z\ny\nz\n");
+    });
+    test("fails on identical replacement", () => {
+        assert.throws(() => applySearchReplace("Keep this.", [{ search: "Keep this.", replace: "Keep this." }]), /did not change/);
+    });
+    test("preserves leading blank line in SEARCH block", () => {
+        const source = "\n\nStatus: In progress\n";
+        const result = applySearchReplace(source, [
+            { search: "\n\nStatus: In progress", replace: "\n\nStatus: Done" },
+        ]);
+        assert.strictEqual(result.description, "\n\nStatus: Done\n");
+    });
+    test("preserves leading blank line when patch starts with blank line", () => {
+        const blocks = parseSearchReplaceBlocks("<<<<<<< SEARCH\n\nfoo\n=======\n\nbar\n>>>>>>> REPLACE");
+        assert.strictEqual(blocks.length, 1);
+        assert.strictEqual(blocks[0].search, "\nfoo");
+        assert.strictEqual(blocks[0].replace, "\nbar");
+    });
+    test("replacement with leading blank line works", () => {
+        const result = applySearchReplace("Header\n\nContent\n", [
+            { search: "Content", replace: "\nNewContent" },
+        ]);
+        assert.strictEqual(result.description, "Header\n\n\nNewContent\n");
+    });
+});
+describe("applyUnifiedDiff", () => {
+    test("applies simple diff", () => {
+        const source = "Line 1\nLine 2\nLine 3\n";
+        const patch = "--- old\n+++ new\n@@ -1,3 +1,3 @@\n Line 1\n-Line 2\n+Line 2 modified\n Line 3\n";
+        const result = applyUnifiedDiff(source, patch);
+        assert.ok(result.description.includes("Line 2 modified"));
+    });
+    test("fails on non-matching diff", () => {
+        const source = "AAA\nBBB\n";
+        const patch = "--- old\n+++ new\n@@ -1,2 +1,2 @@\n-XXX\n+YYY\n BBB\n";
+        assert.throws(() => applyUnifiedDiff(source, patch), /could not be applied/);
+    });
+    test("fails on malformed patch", () => {
+        assert.throws(() => applyUnifiedDiff("text", "not a patch"), /no valid hunks/i);
+    });
+});
+// ---- Integration tests via MCP client ----
+describe("update_issue_description_patch MCP tool", () => {
+    let mockGitLab;
+    let server;
+    let client;
+    const MOCK_PORT_BASE = 9600;
+    const MCP_PORT_BASE = 3600;
+    let portCounter = 0;
+    async function launchMcp(mockGitLabUrl, extraEnv = {}) {
+        const port = MCP_PORT_BASE + portCounter++ * 10;
+        return launchServer({
+            mode: TransportMode.STREAMABLE_HTTP,
+            port,
+            timeout: 10000,
+            env: {
+                STREAMABLE_HTTP: "true",
+                REMOTE_AUTHORIZATION: "true",
+                GITLAB_API_URL: `${mockGitLabUrl}/api/v4`,
+                GITLAB_ACCESS_TOKEN: MOCK_TOKEN,
+                ...extraEnv,
+            },
+        });
+    }
+    async function getClient(port) {
+        const client = new CustomHeaderClient({
+            headers: {
+                authorization: `Bearer ${MOCK_TOKEN}`,
+            },
+        });
+        await client.connect(`http://${HOST}:${port}/mcp`);
+        return client;
+    }
+    before(async () => {
+        const mockPort = await findMockServerPort(MOCK_PORT_BASE);
+        mockGitLab = new MockGitLabServer({
+            port: mockPort,
+            validTokens: [MOCK_TOKEN],
+        });
+        await mockGitLab.start();
+        const mockGitLabUrl = mockGitLab.getUrl();
+        server = await launchMcp(mockGitLabUrl, { GITLAB_TOOLSETS: "issues" });
+        client = await getClient(server.port ?? 0);
+    });
+    after(async () => {
+        await client?.disconnect();
+        cleanupServers([server]);
+        await mockGitLab?.stop();
+    });
+    test("tool appears in tool list", async () => {
+        const result = await client.listTools();
+        const names = result.tools.map((t) => t.name);
+        assert.ok(names.includes("update_issue_description_patch"), "tool should be in list");
+    });
+    test("dry_run: search_replace returns preview without modifying", async () => {
+        // Get current description
+        const getResult = await client.callTool("get_issue", {
+            project_id: "test/project",
+            issue_iid: "1",
+        });
+        const issue = JSON.parse(getResult.content[0]?.text || "{}");
+        const originalDesc = issue.description;
+        // Dry-run
+        const result = await client.callTool("update_issue_description_patch", {
+            project_id: "test/project",
+            issue_iid: "1",
+            patch_type: "search_replace",
+            patch: `<<<<<<< SEARCH\n${originalDesc}\n=======\nShould NOT persist\n>>>>>>> REPLACE`,
+            dry_run: true,
+        });
+        const data = JSON.parse(result.content[0]?.text || "{}");
+        assert.strictEqual(data.status, "preview");
+        assert.strictEqual(data.dry_run, true);
+        assert.strictEqual(data.changes, 1);
+        // Verify NOT updated
+        const getAgain = await client.callTool("get_issue", {
+            project_id: "test/project",
+            issue_iid: "1",
+        });
+        const issueAgain = JSON.parse(getAgain.content[0]?.text || "{}");
+        assert.strictEqual(issueAgain.description, originalDesc, "should be unchanged after dry_run");
+    });
+    test("search_replace: applies the patch", async () => {
+        const result = await client.callTool("update_issue_description_patch", {
+            project_id: "test/project",
+            issue_iid: "1",
+            patch_type: "search_replace",
+            patch: `<<<<<<< SEARCH\nDescription for issue 1\n=======\nPatched description\n>>>>>>> REPLACE`,
+        });
+        const data = JSON.parse(result.content[0]?.text || "{}");
+        assert.strictEqual(data.status, "success");
+        assert.strictEqual(data.changes, 1);
+        // Verify persisted
+        const getResult = await client.callTool("get_issue", {
+            project_id: "test/project",
+            issue_iid: "1",
+        });
+        const issue = JSON.parse(getResult.content[0]?.text || "{}");
+        assert.strictEqual(issue.description, "Patched description");
+    });
+    test("create_note: note is attempted after update", async () => {
+        const result = await client.callTool("update_issue_description_patch", {
+            project_id: "test/project",
+            issue_iid: "1",
+            patch_type: "search_replace",
+            patch: `<<<<<<< SEARCH\nPatched description\n=======\nDescription with note\n>>>>>>> REPLACE`,
+            create_note: true,
+        });
+        const data = JSON.parse(result.content[0]?.text || "{}");
+        assert.strictEqual(data.status, "success");
+        assert.ok(data.note !== undefined, "note result should be present");
+    });
+    test("search_replace: fails on no match", async () => {
+        try {
+            await client.callTool("update_issue_description_patch", {
+                project_id: "test/project",
+                issue_iid: "1",
+                patch_type: "search_replace",
+                patch: `<<<<<<< SEARCH\nNonExistentText_{UNIQUE}_\n=======\nShould fail\n>>>>>>> REPLACE`,
+            });
+            assert.fail("Should have thrown");
+        }
+        catch (err) {
+            const msg = err.message ?? String(err);
+            assert.ok(msg.includes("not found"), `Error should mention 'not found': ${msg}`);
+        }
+    });
+    test("unified_diff: applies the patch", async () => {
+        // Set known state
+        await client.callTool("update_issue_description_patch", {
+            project_id: "test/project",
+            issue_iid: "1",
+            patch_type: "search_replace",
+            patch: `<<<<<<< SEARCH\nDescription with note\n=======\nLine 1\nLine 2\nLine 3\n>>>>>>> REPLACE`,
+        });
+        const result = await client.callTool("update_issue_description_patch", {
+            project_id: "test/project",
+            issue_iid: "1",
+            patch_type: "unified_diff",
+            patch: "--- old\n+++ new\n@@ -1,3 +1,3 @@\n Line 1\n-Line 2\n+Line 2 changed\n Line 3\n",
+        });
+        const data = JSON.parse(result.content[0]?.text || "{}");
+        assert.strictEqual(data.status, "success");
+        const getResult = await client.callTool("get_issue", {
+            project_id: "test/project",
+            issue_iid: "1",
+        });
+        const issue = JSON.parse(getResult.content[0]?.text || "{}");
+        assert.ok(issue.description.includes("Line 2 changed"));
+    });
+});

package/build/test/test-token-optimizations.js

@@ -389,7 +389,7 @@ describe("Policy Edge Cases", { concurrency: 1 }, () => {
     test("hiding all toolset tools leaves only discover_tools", async () => {
         const allIssueTools = [
             "create_issue", "list_issues", "my_issues", "get_issue",
-            "update_issue", "delete_issue", "create_issue_note", "update_issue_note",
+            "update_issue", "update_issue_description_patch", "delete_issue", "list_todos", "mark_todo_done", "mark_all_todos_done", "create_issue_note", "update_issue_note",
             "list_issue_links", "list_issue_discussions", "get_issue_link",
             "create_issue_link", "delete_issue_link", "create_note",
             "list_issue_emoji_reactions", "list_issue_note_emoji_reactions",

package/build/test/test-toolset-filtering.js

@@ -17,9 +17,9 @@ const MCP_PORT_BASE = 3200;
 // Known tool counts per toolset (from TOOLSET_DEFINITIONS)
 const TOOLSET_TOOL_COUNTS = {
     merge_requests: 41,
-    issues: 23,
+    issues: 24,
     repositories: 7,
-    branches: 6,
+    branches: 9,
     projects: 9,
     labels: 5,
     ci: 2,
@@ -63,7 +63,7 @@ const TOOLSET_SAMPLE_TOOLS = {
     merge_requests: ["merge_merge_request", "create_merge_request_thread", "list_draft_notes"],
     issues: ["create_issue", "list_issues", "create_note", "list_todos"],
     repositories: ["search_repositories", "get_file_contents", "push_files"],
-    branches: ["create_branch", "list_commits", "list_commit_statuses", "create_commit_status"],
+    branches: ["create_branch", "get_branch", "list_branches", "delete_branch", "list_commits", "list_commit_statuses", "create_commit_status"],
     projects: ["get_project", "list_namespaces", "list_group_iterations"],
     labels: ["list_labels", "create_label"],
     ci: ["validate_ci_lint", "validate_project_ci_lint"],
@@ -308,6 +308,7 @@ describe("Toolset Filtering", { concurrency: 1 }, () => {
         const writeIssueTools = [
             "create_issue",
             "update_issue",
+            "update_issue_description_patch",
             "delete_issue",
             "mark_todo_done",
             "mark_all_todos_done",

package/build/test/utils/mock-gitlab-server.js

@@ -13,6 +13,8 @@ export class MockGitLabServer {
     // Root-level dynamic router (for OAuth paths not under /api/v4)
     rootRouter;
     rootHandlers = new Map();
+    // In-memory store for mutable resources (issues, etc.)
+    issueStore = new Map();
     constructor(config) {
         this.config = config;
         this.app = express();
@@ -314,6 +316,12 @@ export class MockGitLabServer {
         this.app.get("/api/v4/projects/:projectId/issues/:issue_iid", (req, res) => {
             const issueIid = parseInt(req.params.issue_iid);
             const projectId = req.params.projectId;
+            const storeKey = `${projectId}:${issueIid}`;
+            const stored = this.issueStore.get(storeKey);
+            if (stored) {
+                res.json(stored);
+                return;
+            }
             res.json({
                 id: issueIid,
                 iid: issueIid,
@@ -337,6 +345,44 @@ export class MockGitLabServer {
                 milestone: null,
             });
         });
+        // PUT /api/v4/projects/:projectId/issues/:issue_iid - Update issue
+        this.app.put("/api/v4/projects/:projectId/issues/:issue_iid", (req, res) => {
+            const issueIid = parseInt(req.params.issue_iid);
+            const projectId = req.params.projectId;
+            const storeKey = `${projectId}:${issueIid}`;
+            // Build response from stored data (if previously updated) or defaults
+            const stored = this.issueStore.get(storeKey) || {};
+            const description = req.body?.description ?? stored.description ?? `Description for issue ${issueIid}`;
+            const title = req.body?.title ?? stored.title ?? `Test Issue ${issueIid}`;
+            const state = req.body?.state_event === "close" ? "closed" :
+                req.body?.state_event === "reopen" ? "opened" :
+                    (stored.state ?? "opened");
+            const updatedIssue = {
+                id: issueIid,
+                iid: issueIid,
+                project_id: projectId,
+                title,
+                description,
+                state,
+                created_at: stored.created_at ?? "2024-01-01T00:00:00Z",
+                updated_at: new Date().toISOString(),
+                closed_at: state === "closed" ? new Date().toISOString() : null,
+                web_url: `https://gitlab.mock/project/${projectId}/issues/${issueIid}`,
+                author: {
+                    id: 1,
+                    username: "test-user",
+                    name: "Test User",
+                    avatar_url: null,
+                    web_url: "https://gitlab.mock/test-user",
+                },
+                assignees: [],
+                labels: [],
+                milestone: null,
+            };
+            // Store for subsequent GET requests
+            this.issueStore.set(storeKey, updatedIssue);
+            res.json(updatedIssue);
+        });
         // Mock blob search result
         const mockBlobResults = [
             {

package/build/tools/registry.js

@@ -1,7 +1,7 @@
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { toJSONSchema } from "../utils/schema.js";
 import { USE_GITLAB_WIKI, USE_MILESTONE, USE_PIPELINE, } from "../config.js";
-import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteDraftNoteSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetDeploymentSchema, GetDraftNoteSchema, GetEnvironmentSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, GetPipelineSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListPipelinesSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListReleasesSchema, ListTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UnapproveMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateLabelSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, } from "../schemas.js";
+import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, DeleteDraftNoteSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetDeploymentSchema, GetDraftNoteSchema, GetEnvironmentSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, GetPipelineSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListPipelinesSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListReleasesSchema, ListTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UnapproveMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, } from "../schemas.js";
 // Define all available tools
 export const allTools = [
     {
@@ -84,6 +84,21 @@ export const allTools = [
         description: "Create a new branch",
         inputSchema: toJSONSchema(CreateBranchSchema),
     },
+    {
+        name: "get_branch",
+        description: "Get branch details (commit, protection status)",
+        inputSchema: toJSONSchema(GetBranchSchema),
+    },
+    {
+        name: "list_branches",
+        description: "List branches in project with search filter",
+        inputSchema: toJSONSchema(ListBranchesSchema),
+    },
+    {
+        name: "delete_branch",
+        description: "Delete branch from project",
+        inputSchema: toJSONSchema(DeleteBranchSchema),
+    },
     {
         name: "get_merge_request",
         description: "Get details of a merge request (mergeRequestIid or branchName required)",
@@ -316,6 +331,13 @@ export const allTools = [
         description: "Update an issue",
         inputSchema: toJSONSchema(UpdateIssueSchema),
     },
+    {
+        name: "update_issue_description_patch",
+        description: "Apply a patch (search/replace or unified diff) to an issue description. " +
+            "Reduces token usage by allowing small changes without sending the full description. " +
+            "Supports dry_run to preview changes and create_note to summarize updates.",
+        inputSchema: toJSONSchema(UpdateIssueDescriptionPatchSchema),
+    },
     {
         name: "delete_issue",
         description: "Delete an issue",
@@ -916,6 +938,8 @@ export const readOnlyTools = new Set([
     "get_merge_request_file_diff",
     "list_merge_request_versions",
     "get_merge_request_version",
+    "get_branch",
+    "list_branches",
     "get_branch_diffs",
     "list_merge_request_pipelines",
     "get_merge_request_note",
@@ -1020,8 +1044,10 @@ export const destructiveTools = new Set([
     "delete_issue_note_emoji_reaction",
     "delete_work_item_emoji_reaction",
     "delete_work_item_note_emoji_reaction",
+    "delete_branch",
     "merge_merge_request",
     "push_files",
+    "delete_branch",
 ]);
 // Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
 export const wikiToolNames = new Set([
@@ -1082,6 +1108,8 @@ export const TOOLSET_DEFINITIONS = [
             "approve_merge_request",
             "unapprove_merge_request",
             "get_merge_request_approval_state",
+            "get_branch",
+            "list_branches",
             "get_merge_request_conflicts",
             "list_merge_request_pipelines",
             "get_merge_request",
@@ -1130,6 +1158,7 @@ export const TOOLSET_DEFINITIONS = [
             "my_issues",
             "get_issue",
             "update_issue",
+            "update_issue_description_patch",
             "delete_issue",
             "list_todos",
             "mark_todo_done",
@@ -1168,6 +1197,9 @@ export const TOOLSET_DEFINITIONS = [
         isDefault: true,
         tools: new Set([
             "create_branch",
+            "get_branch",
+            "list_branches",
+            "delete_branch",
             "list_commits",
             "get_commit",
             "get_commit_diff",

package/build/utils/patch-helper.js

@@ -0,0 +1,145 @@
+/**
+ * Patch helper for issue description updates.
+ * Supports two patch formats:
+ * - search_replace: exact text search/replace blocks
+ * - unified_diff: standard unified diff via the `diff` library
+ */
+import { applyPatch, createTwoFilesPatch, parsePatch } from "diff";
+/**
+ * Parse a search/replace patch string into blocks.
+ * Format:
+ *   <<<<<<< SEARCH
+ *   text to find
+ *   =======
+ *   text to replace with
+ *   >>>>>>> REPLACE
+ *
+ * Supports multiple blocks.
+ */
+export function parseSearchReplaceBlocks(patch) {
+    const blocks = [];
+    // Match SEARCH...REPLACE blocks (greedy multiline)
+    const regex = /<<<<<<< SEARCH[^\S\n]*\n([\s\S]*?)=======[^\S\n]*\n([\s\S]*?)>>>>>>> REPLACE[^\S\n]*/g;
+    let match;
+    while ((match = regex.exec(patch)) !== null) {
+        let search = match[1];
+        let replace = match[2];
+        // Trim trailing newline from each side (the \n before ======= and before >>>>>>>)
+        if (search.endsWith("\n"))
+            search = search.slice(0, -1);
+        if (replace.endsWith("\n"))
+            replace = replace.slice(0, -1);
+        blocks.push({ search, replace });
+    }
+    // Detect malformed blocks: check if SEARCH/REPLACE markers exist but weren't captured
+    const searchMarkers = (patch.match(/<<<<<<<\s+SEARCH/g) || []).length;
+    const replaceMarkers = (patch.match(/>>>>>>>\s+REPLACE/g) || []).length;
+    if (searchMarkers !== blocks.length || replaceMarkers !== blocks.length) {
+        throw new Error(`Found ${searchMarkers} SEARCH marker(s) and ${replaceMarkers} REPLACE marker(s), ` +
+            `but only parsed ${blocks.length} valid block(s). ` +
+            "Some blocks may be malformed (e.g. missing ======= or >>>>>>> REPLACE). " +
+            "Each block must follow the exact format: <<<<<<< SEARCH\ntext\n=======\nnew text\n>>>>>>> REPLACE");
+    }
+    return blocks;
+}
+/**
+ * Apply search/replace blocks to source text.
+ *
+ * @param source - Current text
+ * @param blocks - Search/replace blocks
+ * @param allowMultiple - If true, replace all occurrences; if false, fail on duplicate match
+ * @returns PatchResult or throws on error
+ */
+export function applySearchReplace(source, blocks, allowMultiple = false) {
+    let current = source;
+    let totalChanges = 0;
+    const changeLines = [];
+    for (const block of blocks) {
+        // Empty SEARCH body would produce an empty regex that corrupts the description
+        if (block.search.length === 0) {
+            throw new Error("Empty SEARCH block is not allowed. " +
+                "Each SEARCH block must contain the text to find. " +
+                "Block:\n---\n" + block.replace.slice(0, 200) + "\n---");
+        }
+        // Count occurrences
+        const escapedSearch = escapeRegex(block.search);
+        const regex = new RegExp(escapedSearch, "g");
+        const occurrences = current.match(regex);
+        if (!occurrences || occurrences.length === 0) {
+            throw new Error(`Search text not found in issue description. Search block:\n---\n${block.search.slice(0, 200)}${block.search.length > 200 ? "..." : ""}\n---`);
+        }
+        if (occurrences.length > 1 && !allowMultiple) {
+            throw new Error(`Search text matches ${occurrences.length} times (expected exactly 1). ` +
+                "Use 'allow_multiple: true' to replace all occurrences.\n" +
+                `Search block:\n---\n${block.search.slice(0, 200)}${block.search.length > 200 ? "..." : ""}\n---`);
+        }
+        // Apply replacement
+        const replacement = block.replace;
+        const replaced = current.replace(regex, () => replacement);
+        // Detect no-op
+        if (replaced === current) {
+            throw new Error(`Replacement did not change the description (identical result). Search block:\n---\n${block.search.slice(0, 200)}${block.search.length > 200 ? "..." : ""}\n---`);
+        }
+        const count = occurrences.length;
+        totalChanges += count;
+        changeLines.push(`Replaced ${count} occurrence(s): "${truncate(block.search, 60)}" → "${truncate(block.replace, 60)}"`);
+        current = replaced;
+    }
+    const summary = changeLines.join("\n");
+    // Generate preview diff
+    const preview = createTwoFilesPatch("current", "updated", source, current);
+    return {
+        description: current,
+        changes: totalChanges,
+        summary,
+        preview,
+    };
+}
+/**
+ * Apply a unified diff patch to source text.
+ * Delegates to the `diff` library's applyPatch.
+ */
+export function applyUnifiedDiff(source, patch) {
+    // Validate the patch can be parsed first
+    const parsed = parsePatch(patch);
+    if (parsed.length === 0 || parsed.every((p) => p.hunks.length === 0)) {
+        throw new Error("Could not parse unified diff: no valid hunks found. " +
+            "Expected format: '--- old\\n+++ new\\n@@ -line,count +line,count @@\\n context\\n-old\\n+new\\n'");
+    }
+    const result = applyPatch(source, patch);
+    if (result === false) {
+        throw new Error("Unified diff could not be applied to the current issue description. " +
+            "The diff context may not match. Use 'dry_run: true' to debug.");
+    }
+    // Detect no-op: patch applied but nothing changed
+    if (result === source) {
+        throw new Error("Unified diff applied but did not change the issue description. " +
+            "The source text already matches the patched result.");
+    }
+    const changes = parsed.reduce((sum, p) => sum + p.hunks.reduce((hSum, h) => hSum + h.lines.filter((l) => l.startsWith("-") || l.startsWith("+")).length, 0), 0);
+    // Generate preview of what actually changed
+    const preview = createTwoFilesPatch("current", "updated", source, result);
+    // Build summary from hunk headers
+    const summaryLines = [];
+    for (const p of parsed) {
+        for (const hunk of p.hunks) {
+            const added = hunk.lines.filter((l) => l.startsWith("+")).length;
+            const removed = hunk.lines.filter((l) => l.startsWith("-")).length;
+            summaryLines.push(`Hunk at line ${hunk.oldStart}: ${removed} removed, ${added} added`);
+        }
+    }
+    return {
+        description: result,
+        changes,
+        summary: summaryLines.join("\n"),
+        preview,
+    };
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen) + "...";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.1.11",
+  "version": "2.1.12",
   "mcpName": "io.github.zereight/gitlab-mcp",
   "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
   "keywords": [
@@ -51,7 +51,7 @@
     "changelog": "auto-changelog -p",
     "test": "npm run test:all",
     "test:all": "npm run build && npm run test:mock && npm run test:live",
-    "test:mock": "node --import tsx/esm --test test/remote-auth-simple-test.ts && node --import tsx/esm --test test/mcp-oauth-tests.ts && node --import tsx/esm --test test/streamable-http-static-token-auth.test.ts && tsx test/oauth-tests.ts && tsx test/test-list-merge-requests.ts && node --import tsx/esm --test test/test-merge-request-pipelines.ts && tsx test/test-list-project-members.ts && tsx test/test-download-attachment.ts && node --import tsx/esm --test test/test-job-artifacts.ts && node --import tsx/esm --test test/test-deployment-tools.ts && node --import tsx/esm --test test/test-merge-request-approval-state-tools.ts && node --import tsx/esm --test test/test-search-code.ts && node --import tsx/esm --test test/test-tags.ts && node --import tsx/esm --test test/test-toolset-filtering.ts && node --import tsx/esm --test test/test-ci-lint.ts && node --import tsx/esm --test test/test-todos.ts && node --import tsx/esm --test test/test-auth-retry.ts && node --import tsx/esm --test test/stateless/codec.test.ts test/stateless/client-id.test.ts test/stateless/callback-proxy.test.ts test/stateless/session-id.test.ts test/stateless/session-id-integration.test.ts test/stateless/config-ttl.test.ts",
+    "test:mock": "node --import tsx/esm --test test/remote-auth-simple-test.ts && node --import tsx/esm --test test/mcp-oauth-tests.ts && node --import tsx/esm --test test/streamable-http-static-token-auth.test.ts && tsx test/oauth-tests.ts && tsx test/test-list-merge-requests.ts && node --import tsx/esm --test test/test-merge-request-pipelines.ts && tsx test/test-list-project-members.ts && tsx test/test-download-attachment.ts && node --import tsx/esm --test test/test-job-artifacts.ts && node --import tsx/esm --test test/test-deployment-tools.ts && node --import tsx/esm --test test/test-merge-request-approval-state-tools.ts && node --import tsx/esm --test test/test-search-code.ts && node --import tsx/esm --test test/test-tags.ts && node --import tsx/esm --test test/test-toolset-filtering.ts && node --import tsx/esm --test test/test-ci-lint.ts && node --import tsx/esm --test test/test-todos.ts && node --import tsx/esm --test test/test-auth-retry.ts && node --import tsx/esm --test test/test-issue-description-patch.ts && node --import tsx/esm --test test/stateless/codec.test.ts test/stateless/client-id.test.ts test/stateless/callback-proxy.test.ts test/stateless/session-id.test.ts test/stateless/session-id-integration.test.ts test/stateless/config-ttl.test.ts",
     "test:stateless": "npm run build && node --import tsx/esm --test test/stateless/codec.test.ts test/stateless/client-id.test.ts test/stateless/callback-proxy.test.ts test/stateless/session-id.test.ts test/stateless/session-id-integration.test.ts test/stateless/config-ttl.test.ts",
     "test:mcp-oauth": "npm run build && node --import tsx/esm --test test/mcp-oauth-tests.ts",
     "test:live": "node test/validate-api.js",
@@ -70,6 +70,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.2",
     "@types/node-fetch": "^2.6.12",
+    "diff": "^9.0.0",
     "express": "^5.1.0",
     "fetch-cookie": "^3.1.0",
     "form-data": "^4.0.0",