@zereight/mcp-gitlab 2.3.7 → 2.3.8-next.142

package/build/index.js

@@ -107,6 +107,7 @@ import { checkForNewVersion } from "./utils/version-check.js";
 import { assertGitLabVersionAtLeast } from "./utils/gitlab-version-gate.js";
 import { fetchWithValidatedRedirects } from "./utils/safe-redirect-fetch.js";
 import { fetchStatusBeforeDeadline } from "./utils/poll-deadline.js";
+import { getUniqueApprovalUsers, inferMergeRequestApproved, MERGE_REQUEST_DEPLOYMENT_SUMMARY_LIMIT, parseApprovalsResponse, sortDeploymentsByCreatedAtDesc, toMergeRequestDeploymentSummaryRecord, } from "./utils/merge-request-summary.js";
 import { parseGitLabVersionApiResponse, } from "./utils/gitlab-instance-version.js";
 import { buildBulkPublishDraftNotesBody, needsGitLab19_2BulkPublish, } from "./utils/bulk-publish-options.js";
 import { appendFilterParam, appendFilterParams, cleanMutuallyExclusiveIdUsernameOptions, dropBlankArrayEntries, isBlankFilterValue, LIST_MERGE_REQUESTS_ID_USERNAME_PAIRS, sanitizeToolArguments, } from "./utils/tool-args.js";
@@ -128,7 +129,7 @@ GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, 
 // Draft Notes Schemas
 GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabProtectedTagSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabMilestonesSchema, GitLabGroupMilestonesSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineScheduleSchema, GitLabPipelineScheduleVariableSchema, GitLabPipelineSchedulePlayResultSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GitLabWikiPageSchema, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, GitLabCiVariableSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListLabelsSchema, ListMergeRequestDiffsSchema, // Added
-GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListProjectRunnersSchema, GetRunnerSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListProjectMembersSchema, ListGroupMembersSchema, ListProjectMilestonesSchema, ListGroupMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, GetGroupWikiPageSchema, ListGroupWikiPagesSchema, UpdateGroupWikiPageSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalsResponseSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListTagsSchema, GetTagSchema, CreateTagSchema, DeleteTagSchema, GetTagSignatureSchema, ListProtectedTagsSchema, GetProtectedTagSchema, ProtectTagSchema, UnprotectTagSchema, GitLabTagSchema, GitLabTagSignatureSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, GitLabSnippetSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, GetMergeRequestDiscussionSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, CreateWebhookSchema, UpdateWebhookSchema, DeleteWebhookSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
+GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListProjectRunnersSchema, GetRunnerSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListProjectMembersSchema, ListGroupMembersSchema, ListProjectMilestonesSchema, ListGroupMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, GetGroupWikiPageSchema, ListGroupWikiPagesSchema, UpdateGroupWikiPageSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListTagsSchema, GetTagSchema, CreateTagSchema, DeleteTagSchema, GetTagSignatureSchema, ListProtectedTagsSchema, GetProtectedTagSchema, ProtectTagSchema, UnprotectTagSchema, GitLabTagSchema, GitLabTagSignatureSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, GitLabSnippetSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, GetMergeRequestDiscussionSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, CreateWebhookSchema, UpdateWebhookSchema, DeleteWebhookSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
 import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
 import { createLogger, flushBufferedLogs, flushStartupLogs } from "./utils/logger.js";
 const logger = createLogger();
@@ -1265,7 +1266,6 @@ const ignoredExplicitTools = [...individuallyEnabledTools].filter(name => isExpl
 if (ignoredExplicitTools.length > 0) {
     logger.warn(`GITLAB_TOOLS names ${ignoredExplicitTools.join(", ")}, but that tool is enabled only when its toolset is listed in GITLAB_TOOLSETS. The GITLAB_TOOLS entry is ignored.`);
 }
-const MERGE_REQUEST_DEPLOYMENT_SUMMARY_LIMIT = 10;
 function toAllowedGitLabApiUrl(value) {
     const trimmed = value.trim();
     if (!trimmed)
@@ -4072,58 +4072,6 @@ async function buildMergeRequestApprovalSummary(projectId, mergeRequestIid) {
         };
     }
 }
-function toMergeRequestDeploymentSummaryRecord(deployment) {
-    return {
-        id: deployment.id,
-        status: deployment.status,
-        ref: deployment.ref,
-        sha: deployment.sha,
-        created_at: deployment.created_at,
-        updated_at: deployment.updated_at,
-        finished_at: deployment.finished_at,
-        web_url: deployment.web_url,
-        environment: deployment.environment
-            ? {
-                id: deployment.environment.id,
-                name: deployment.environment.name,
-                slug: deployment.environment.slug,
-                external_url: deployment.environment.external_url,
-                state: deployment.environment.state,
-                tier: deployment.environment.tier,
-            }
-            : undefined,
-        deployable: deployment.deployable === null
-            ? null
-            : deployment.deployable
-                ? {
-                    id: deployment.deployable.id,
-                    name: deployment.deployable.name,
-                    status: deployment.deployable.status,
-                    stage: deployment.deployable.stage,
-                    web_url: deployment.deployable.web_url,
-                    pipeline: deployment.deployable.pipeline
-                        ? {
-                            id: deployment.deployable.pipeline.id,
-                            status: deployment.deployable.pipeline.status,
-                            ref: deployment.deployable.pipeline.ref,
-                            sha: deployment.deployable.pipeline.sha,
-                            web_url: deployment.deployable.pipeline.web_url,
-                        }
-                        : undefined,
-                }
-                : undefined,
-    };
-}
-function sortDeploymentsByCreatedAtDesc(deployments) {
-    return [...deployments].sort((a, b) => {
-        const aTime = Date.parse(a.created_at);
-        const bTime = Date.parse(b.created_at);
-        if (Number.isNaN(aTime) || Number.isNaN(bTime)) {
-            return b.created_at.localeCompare(a.created_at);
-        }
-        return bTime - aTime;
-    });
-}
 async function buildMergeRequestDeploymentSummary(projectId, mergeRequest) {
     const lookupSha = mergeRequest.merge_commit_sha ?? mergeRequest.diff_refs?.head_sha ?? null;
     if (!lookupSha) {
@@ -4566,43 +4514,6 @@ async function getMergeRequestApprovalsFallback(projectId, mergeRequestIid) {
     await handleGitLabError(approvalsResponse);
     return parseApprovalsResponse(await approvalsResponse.json());
 }
-/**
- * Parse the response from POST /approve and POST /unapprove endpoints.
- * These endpoints return the approvals format (approved_by contains nested
- * { user: {...} } objects), which must be converted to the flat format
- * used by GitLabMergeRequestApprovalStateSchema.
- */
-function parseApprovalsResponse(responseJson) {
-    const parsedApprovals = GitLabMergeRequestApprovalsResponseSchema.parse(responseJson);
-    const approvedByUsers = getUniqueApprovalUsers((parsedApprovals.approved_by || []).map(approvedByEntry => approvedByEntry.user));
-    const approvedByUsernames = approvedByUsers.map(user => user.username);
-    return GitLabMergeRequestApprovalStateSchema.parse({
-        approved: parsedApprovals.approved,
-        user_has_approved: parsedApprovals.user_has_approved,
-        user_can_approve: parsedApprovals.user_can_approve,
-        approved_by: approvedByUsers,
-        approved_by_usernames: approvedByUsernames,
-        source_endpoint: "approvals",
-    });
-}
-function getUniqueApprovalUsers(users) {
-    const uniqueUsers = new Map();
-    for (const user of users) {
-        if (!uniqueUsers.has(user.id)) {
-            uniqueUsers.set(user.id, user);
-        }
-    }
-    return [...uniqueUsers.values()];
-}
-function inferMergeRequestApproved(rules) {
-    if (!rules || rules.length === 0) {
-        return null;
-    }
-    if (rules.some(rule => typeof rule.approved !== "boolean")) {
-        return null;
-    }
-    return rules.every(rule => rule.approved === true);
-}
 /**
  * Create a new note (comment) on an issue or merge request
  * 📦 새로운 함수: createNote - 이슈 또는 병합 요청에 노트(댓글)를 추가하는 함수

package/build/utils/merge-request-summary.js

@@ -0,0 +1,94 @@
+// Pure helpers for the get_merge_request summaries (include_summaries) and the
+// approve/unapprove/approval state results. The functions that call GitLab
+// stay in index.ts.
+import { GitLabMergeRequestApprovalsResponseSchema, GitLabMergeRequestApprovalStateSchema, } from "../schemas.js";
+export const MERGE_REQUEST_DEPLOYMENT_SUMMARY_LIMIT = 10;
+export function toMergeRequestDeploymentSummaryRecord(deployment) {
+    return {
+        id: deployment.id,
+        status: deployment.status,
+        ref: deployment.ref,
+        sha: deployment.sha,
+        created_at: deployment.created_at,
+        updated_at: deployment.updated_at,
+        finished_at: deployment.finished_at,
+        web_url: deployment.web_url,
+        environment: deployment.environment
+            ? {
+                id: deployment.environment.id,
+                name: deployment.environment.name,
+                slug: deployment.environment.slug,
+                external_url: deployment.environment.external_url,
+                state: deployment.environment.state,
+                tier: deployment.environment.tier,
+            }
+            : undefined,
+        deployable: deployment.deployable === null
+            ? null
+            : deployment.deployable
+                ? {
+                    id: deployment.deployable.id,
+                    name: deployment.deployable.name,
+                    status: deployment.deployable.status,
+                    stage: deployment.deployable.stage,
+                    web_url: deployment.deployable.web_url,
+                    pipeline: deployment.deployable.pipeline
+                        ? {
+                            id: deployment.deployable.pipeline.id,
+                            status: deployment.deployable.pipeline.status,
+                            ref: deployment.deployable.pipeline.ref,
+                            sha: deployment.deployable.pipeline.sha,
+                            web_url: deployment.deployable.pipeline.web_url,
+                        }
+                        : undefined,
+                }
+                : undefined,
+    };
+}
+export function sortDeploymentsByCreatedAtDesc(deployments) {
+    return [...deployments].sort((a, b) => {
+        const aTime = Date.parse(a.created_at);
+        const bTime = Date.parse(b.created_at);
+        if (Number.isNaN(aTime) || Number.isNaN(bTime)) {
+            return b.created_at.localeCompare(a.created_at);
+        }
+        return bTime - aTime;
+    });
+}
+/**
+ * Parse the response from POST /approve and POST /unapprove endpoints.
+ * These endpoints return the approvals format (approved_by contains nested
+ * { user: {...} } objects), which must be converted to the flat format
+ * used by GitLabMergeRequestApprovalStateSchema.
+ */
+export function parseApprovalsResponse(responseJson) {
+    const parsedApprovals = GitLabMergeRequestApprovalsResponseSchema.parse(responseJson);
+    const approvedByUsers = getUniqueApprovalUsers((parsedApprovals.approved_by || []).map(approvedByEntry => approvedByEntry.user));
+    const approvedByUsernames = approvedByUsers.map(user => user.username);
+    return GitLabMergeRequestApprovalStateSchema.parse({
+        approved: parsedApprovals.approved,
+        user_has_approved: parsedApprovals.user_has_approved,
+        user_can_approve: parsedApprovals.user_can_approve,
+        approved_by: approvedByUsers,
+        approved_by_usernames: approvedByUsernames,
+        source_endpoint: "approvals",
+    });
+}
+export function getUniqueApprovalUsers(users) {
+    const uniqueUsers = new Map();
+    for (const user of users) {
+        if (!uniqueUsers.has(user.id)) {
+            uniqueUsers.set(user.id, user);
+        }
+    }
+    return [...uniqueUsers.values()];
+}
+export function inferMergeRequestApproved(rules) {
+    if (!rules || rules.length === 0) {
+        return null;
+    }
+    if (rules.some(rule => typeof rule.approved !== "boolean")) {
+        return null;
+    }
+    return rules.every(rule => rule.approved === true);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.3.7",
+  "version": "2.3.8-next.142",
   "mcpName": "io.github.zereight/gitlab-mcp",
   "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
   "keywords": [