@ekho/gitlab-mcp 1.1.0

package/dist/groups/security_policies/tools.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { safe } from '../../shared/handlers.js';
+import { GROUP_SECURITY_POLICIES, POLICY_SYNC_STATUS, PROJECT_SECURITY_POLICIES, } from './queries.js';
+export function registerSecurityPolicyTools(server, ctx) {
+    server.tool('security_policy_list_project', 'List security policies attached to a project (scan execution, approval, pipeline execution).', { project_path: z.string() }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({
+            query: PROJECT_SECURITY_POLICIES,
+            variables: { fullPath: args.project_path },
+        });
+        if (!data.project)
+            throw new Error(`Project "${args.project_path}" not found.`);
+        return data.project;
+    }));
+    server.tool('security_policy_list_group', 'List security policies attached to a group.', { group_path: z.string() }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({
+            query: GROUP_SECURITY_POLICIES,
+            variables: { fullPath: args.group_path },
+        });
+        if (!data.group)
+            throw new Error(`Group "${args.group_path}" not found.`);
+        return data.group;
+    }));
+    server.tool('security_policy_sync_status', 'Get sync status of security policy YAML for a project or group (errors per policy type).', {
+        project_path: z.string().optional(),
+        group_path: z.string().optional(),
+    }, async (args) => safe(async () => {
+        if (!args.project_path && !args.group_path) {
+            throw new Error('Provide either project_path or group_path.');
+        }
+        const data = await ctx.graphql.query({
+            query: POLICY_SYNC_STATUS,
+            variables: {
+                projectPath: args.project_path,
+                groupPath: args.group_path,
+            },
+        });
+        return data.securityPoliciesSyncStatus;
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/security_policies/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/security_policies/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAEhD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,2BAA2B,CAAC,MAAiB,EAAE,GAAgB;IAC7E,MAAM,CAAC,IAAI,CACT,8BAA8B,EAC9B,8FAA8F,EAC9F,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAC5B,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAA8B;YAChE,KAAK,EAAE,yBAAyB;YAChC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE;SAC3C,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,YAAY,cAAc,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B,6CAA6C,EAC7C,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAC1B,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAA4B;YAC9D,KAAK,EAAE,uBAAuB;YAC9B,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE;SACzC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,UAAU,cAAc,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,6BAA6B,EAC7B,0FAA0F,EAC1F;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAA0C;YAC5E,KAAK,EAAE,kBAAkB;YACzB,SAAS,EAAE;gBACT,WAAW,EAAE,IAAI,CAAC,YAAY;gBAC9B,SAAS,EAAE,IAAI,CAAC,UAAU;aAC3B;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,0BAA0B,CAAC;IACzC,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/groups/security_reports/queries.d.ts

@@ -0,0 +1 @@
+export declare const PIPELINE_SECURITY_FINDINGS = "\n  query PipelineSecurityFindings(\n    $fullPath: ID!\n    $pipelineIid: ID!\n    $first: Int\n    $after: String\n    $reportType: [SecurityReportTypeEnum!]\n    $severity: [VulnerabilitySeverity!]\n    $scanner: [String!]\n    $state: [VulnerabilityState!]\n  ) {\n    project(fullPath: $fullPath) {\n      pipeline(iid: $pipelineIid) {\n        id\n        securityReportFindings(\n          first: $first\n          after: $after\n          reportType: $reportType\n          severity: $severity\n          scanner: $scanner\n          state: $state\n        ) {\n          pageInfo {\n            endCursor\n            hasNextPage\n          }\n          nodes {\n            uuid\n            title\n            description\n            state\n            severity\n            reportType\n            scanner {\n              name\n              vendor\n            }\n            identifiers {\n              externalType\n              externalId\n              name\n              url\n            }\n            location {\n              ... on VulnerabilityLocationSast {\n                file\n                startLine\n                endLine\n              }\n              ... on VulnerabilityLocationDependencyScanning {\n                file\n                dependency {\n                  package {\n                    name\n                  }\n                  version\n                }\n              }\n              ... on VulnerabilityLocationContainerScanning {\n                image\n                operatingSystem\n              }\n              ... on VulnerabilityLocationSecretDetection {\n                file\n                startLine\n                endLine\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n";

package/dist/groups/security_reports/queries.js

@@ -0,0 +1,75 @@
+export const PIPELINE_SECURITY_FINDINGS = /* GraphQL */ `
+  query PipelineSecurityFindings(
+    $fullPath: ID!
+    $pipelineIid: ID!
+    $first: Int
+    $after: String
+    $reportType: [SecurityReportTypeEnum!]
+    $severity: [VulnerabilitySeverity!]
+    $scanner: [String!]
+    $state: [VulnerabilityState!]
+  ) {
+    project(fullPath: $fullPath) {
+      pipeline(iid: $pipelineIid) {
+        id
+        securityReportFindings(
+          first: $first
+          after: $after
+          reportType: $reportType
+          severity: $severity
+          scanner: $scanner
+          state: $state
+        ) {
+          pageInfo {
+            endCursor
+            hasNextPage
+          }
+          nodes {
+            uuid
+            title
+            description
+            state
+            severity
+            reportType
+            scanner {
+              name
+              vendor
+            }
+            identifiers {
+              externalType
+              externalId
+              name
+              url
+            }
+            location {
+              ... on VulnerabilityLocationSast {
+                file
+                startLine
+                endLine
+              }
+              ... on VulnerabilityLocationDependencyScanning {
+                file
+                dependency {
+                  package {
+                    name
+                  }
+                  version
+                }
+              }
+              ... on VulnerabilityLocationContainerScanning {
+                image
+                operatingSystem
+              }
+              ... on VulnerabilityLocationSecretDetection {
+                file
+                startLine
+                endLine
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+//# sourceMappingURL=queries.js.map

package/dist/groups/security_reports/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/groups/security_reports/queries.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEvD,CAAC"}

package/dist/groups/security_reports/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerSecurityReportTools(server: McpServer, ctx: ToolContext): void;

package/dist/groups/security_reports/tools.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { safe } from '../../shared/handlers.js';
+import { PIPELINE_SECURITY_FINDINGS } from './queries.js';
+const ReportType = z.enum([
+    'sast',
+    'dependency_scanning',
+    'container_scanning',
+    'dast',
+    'secret_detection',
+    'coverage_fuzzing',
+    'api_fuzzing',
+    'cluster_image_scanning',
+]);
+const Severity = z.enum(['info', 'unknown', 'low', 'medium', 'high', 'critical']);
+const State = z.enum(['detected', 'confirmed', 'resolved', 'dismissed']);
+export function registerSecurityReportTools(server, ctx) {
+    server.tool('security_report_findings_pipeline', 'List security findings produced by a pipeline (SAST/DAST/DepScan/SecretDetect/etc.).', {
+        project_path: z.string(),
+        pipeline_iid: z.union([z.string(), z.number()]),
+        first: z.number().int().positive().max(100).optional(),
+        after: z.string().optional(),
+        report_type: z.array(ReportType).optional(),
+        severity: z.array(Severity).optional(),
+        scanner: z.array(z.string()).optional(),
+        state: z.array(State).optional(),
+    }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({
+            query: PIPELINE_SECURITY_FINDINGS,
+            variables: {
+                fullPath: args.project_path,
+                pipelineIid: String(args.pipeline_iid),
+                first: args.first ?? 20,
+                after: args.after,
+                reportType: args.report_type?.map((t) => t.toUpperCase()),
+                severity: args.severity?.map((s) => s.toUpperCase()),
+                scanner: args.scanner,
+                state: args.state?.map((s) => s.toUpperCase()),
+            },
+        });
+        if (!data.project)
+            throw new Error(`Project "${args.project_path}" not found.`);
+        if (!data.project.pipeline) {
+            throw new Error(`Pipeline iid=${args.pipeline_iid} not found.`);
+        }
+        return {
+            items: data.project.pipeline.securityReportFindings.nodes,
+            page_info: data.project.pipeline.securityReportFindings.pageInfo,
+        };
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/security_reports/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/security_reports/tools.ts"],"names":[],"mappings":"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"}

package/dist/groups/snippets/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerSnippetTools(server: McpServer, ctx: ToolContext): void;

package/dist/groups/snippets/tools.js

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+import { PaginationArgs, ProjectIdArg } from '../../shared/args.js';
+import { safe } from '../../shared/handlers.js';
+import { resolveProjectId } from '../../shared/ids.js';
+const Visibility = z.enum(['private', 'internal', 'public']);
+const SnippetFileInput = z.object({
+    action: z.enum(['create', 'update', 'delete', 'move']),
+    file_path: z.string(),
+    previous_path: z.string().optional(),
+    content: z.string().optional(),
+});
+export function registerSnippetTools(server, ctx) {
+    // -- personal snippets ------------------------------------------------
+    server.tool('snippet_list_personal', 'List the current user\'s personal snippets.', PaginationArgs, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ path: '/snippets', query: args });
+        return res.data;
+    }));
+    server.tool('snippet_list_public', 'List all public snippets (paginated).', PaginationArgs, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ path: '/snippets/public', query: args });
+        return res.data;
+    }));
+    server.tool('snippet_get', 'Get a single personal snippet.', { snippet_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ path: `/snippets/${args.snippet_id}` });
+        return res.data;
+    }));
+    server.tool('snippet_create', 'Create a personal snippet. Use `files` for multi-file or `content`+`file_name` for single-file.', {
+        title: z.string(),
+        description: z.string().optional(),
+        visibility: Visibility.optional(),
+        files: z.array(SnippetFileInput).optional(),
+        content: z.string().optional().describe('Single-file shortcut.'),
+        file_name: z.string().optional().describe('Single-file shortcut.'),
+    }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ method: 'POST', path: '/snippets', body: args });
+        return res.data;
+    }));
+    server.tool('snippet_update', 'Update a personal snippet.', {
+        snippet_id: z.number().int().positive(),
+        title: z.string().optional(),
+        description: z.string().optional(),
+        visibility: Visibility.optional(),
+        files: z.array(SnippetFileInput).optional(),
+        content: z.string().optional(),
+        file_name: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const { snippet_id, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'PUT',
+            path: `/snippets/${snippet_id}`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('snippet_delete', 'Delete a personal snippet.', { snippet_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/snippets/${args.snippet_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    server.tool('snippet_raw', 'Get raw content of a personal snippet (or a specific file inside it).', {
+        snippet_id: z.number().int().positive(),
+        ref: z.string().optional().describe('Required when file_path is given.'),
+        file_path: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const path = args.file_path === undefined
+            ? `/snippets/${args.snippet_id}/raw`
+            : `/snippets/${args.snippet_id}/files/${args.ref ?? 'main'}/${encodeURIComponent(args.file_path)}/raw`;
+        const res = await ctx.rest.request({ path });
+        return typeof res.data === 'string' ? res.data : String(res.data ?? '');
+    }));
+    // -- project snippets -------------------------------------------------
+    server.tool('snippet_list_project', 'List snippets in a project.', { ...ProjectIdArg, ...PaginationArgs }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...rest } = args;
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}/snippets`,
+            query: rest,
+        });
+        return res.data;
+    }));
+    server.tool('snippet_get_project', 'Get a snippet in a project.', { ...ProjectIdArg, snippet_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}/snippets/${args.snippet_id}`,
+        });
+        return res.data;
+    }));
+    server.tool('snippet_create_project', 'Create a snippet in a project.', {
+        ...ProjectIdArg,
+        title: z.string(),
+        description: z.string().optional(),
+        visibility: Visibility.optional(),
+        files: z.array(SnippetFileInput).optional(),
+        content: z.string().optional(),
+        file_name: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/projects/${projectId}/snippets`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('snippet_update_project', 'Update a snippet in a project.', {
+        ...ProjectIdArg,
+        snippet_id: z.number().int().positive(),
+        title: z.string().optional(),
+        description: z.string().optional(),
+        visibility: Visibility.optional(),
+        files: z.array(SnippetFileInput).optional(),
+        content: z.string().optional(),
+        file_name: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, snippet_id, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'PUT',
+            path: `/projects/${projectId}/snippets/${snippet_id}`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('snippet_delete_project', 'Delete a snippet in a project.', { ...ProjectIdArg, snippet_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/projects/${projectId}/snippets/${args.snippet_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    server.tool('snippet_raw_project', 'Get raw content of a project snippet (optionally a single file).', {
+        ...ProjectIdArg,
+        snippet_id: z.number().int().positive(),
+        ref: z.string().optional(),
+        file_path: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const path = args.file_path === undefined
+            ? `/projects/${projectId}/snippets/${args.snippet_id}/raw`
+            : `/projects/${projectId}/snippets/${args.snippet_id}/files/${args.ref ?? 'main'}/${encodeURIComponent(args.file_path)}/raw`;
+        const res = await ctx.rest.request({ path });
+        return typeof res.data === 'string' ? res.data : String(res.data ?? '');
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/snippets/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/snippets/tools.ts"],"names":[],"mappings":"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"}

package/dist/groups/statistics/queries.d.ts

@@ -0,0 +1,2 @@
+export declare const INSTANCE_STATISTICS = "\n  query InstanceStatistics {\n    metadata {\n      version\n      revision\n      kas {\n        enabled\n        version\n      }\n      enterprise\n    }\n  }\n";
+export declare const RUNNER_USAGE_NAMESPACES = "\n  query RunnerUsage($runnerType: CiRunnerType, $fullPath: ID, $fromDate: Date, $toDate: Date) {\n    ciMinutesUsageNamespace: namespace(fullPath: $fullPath) {\n      id\n      additionalPurchasedStorageSize\n      rootStorageStatistics {\n        storageSize\n        repositorySize\n        lfsObjectsSize\n        buildArtifactsSize\n        packagesSize\n        wikiSize\n        snippetsSize\n        uploadsSize\n      }\n    }\n  }\n";

package/dist/groups/statistics/queries.js

@@ -0,0 +1,32 @@
+export const INSTANCE_STATISTICS = /* GraphQL */ `
+  query InstanceStatistics {
+    metadata {
+      version
+      revision
+      kas {
+        enabled
+        version
+      }
+      enterprise
+    }
+  }
+`;
+export const RUNNER_USAGE_NAMESPACES = /* GraphQL */ `
+  query RunnerUsage($runnerType: CiRunnerType, $fullPath: ID, $fromDate: Date, $toDate: Date) {
+    ciMinutesUsageNamespace: namespace(fullPath: $fullPath) {
+      id
+      additionalPurchasedStorageSize
+      rootStorageStatistics {
+        storageSize
+        repositorySize
+        lfsObjectsSize
+        buildArtifactsSize
+        packagesSize
+        wikiSize
+        snippetsSize
+        uploadsSize
+      }
+    }
+  }
+`;
+//# sourceMappingURL=queries.js.map

package/dist/groups/statistics/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/groups/statistics/queries.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;;;;;;;;;;;;CAYhD,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;CAiBpD,CAAC"}

package/dist/groups/statistics/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerStatisticsTools(server: McpServer, ctx: ToolContext): void;

package/dist/groups/statistics/tools.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { GroupIdArg, ProjectIdArg } from '../../shared/args.js';
+import { safe } from '../../shared/handlers.js';
+import { resolveGroupId, resolveProjectId } from '../../shared/ids.js';
+import { RUNNER_USAGE_NAMESPACES } from './queries.js';
+export function registerStatisticsTools(server, ctx) {
+    server.tool('project_storage_breakdown', 'Storage breakdown for a project (repo size, LFS, packages, artifacts, snippets, wiki, uploads).', { ...ProjectIdArg }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}`,
+            query: { statistics: true },
+        });
+        // Return only the statistics block to keep the response focused.
+        const data = res.data;
+        return { statistics: data.statistics, namespace: data.namespace };
+    }));
+    server.tool('group_storage_breakdown', 'Storage breakdown for a group (root namespace stats).', { ...GroupIdArg }, async (args) => safe(async () => {
+        const groupId = resolveGroupId(ctx.config, args.group_id);
+        const data = await ctx.graphql.query({
+            query: RUNNER_USAGE_NAMESPACES,
+            variables: { fullPath: decodeURIComponent(groupId) },
+        });
+        return data.ciMinutesUsageNamespace;
+    }));
+    server.tool('ci_minutes_usage_namespace', 'Get current CI compute minutes usage for a namespace (gitlab.com).', {
+        namespace_path: z.string().describe('Group full path; user namespace also supported.'),
+    }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            path: '/usage_data/track_event',
+            query: { namespace_path: args.namespace_path },
+        });
+        return res.data;
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/statistics/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/statistics/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,GAAgB;IACzE,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,iGAAiG,EACjG,EAAE,GAAG,YAAY,EAAE,EACnB,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YACjC,IAAI,EAAE,aAAa,SAAS,EAAE;YAC9B,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SAC5B,CAAC,CAAC;QACH,iEAAiE;QACjE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAqD,CAAC;QACvE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACpE,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,uDAAuD,EACvD,EAAE,GAAG,UAAU,EAAE,EACjB,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAEjC;YACD,KAAK,EAAE,uBAAuB;YAC9B,SAAS,EAAE,EAAE,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE;SACrD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,uBAAuB,CAAC;IACtC,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B,oEAAoE,EACpE;QACE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;KACvF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YACjC,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE;SAC/C,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/groups/tags/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerTagTools(server: McpServer, ctx: ToolContext): void;

package/dist/groups/tags/tools.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { PaginationArgs, ProjectIdArg } from '../../shared/args.js';
+import { safe } from '../../shared/handlers.js';
+import { resolveProjectId } from '../../shared/ids.js';
+const TagAccessLevel = z.number().int();
+const TagAccessRule = z.object({
+    user_id: z.number().int().optional(),
+    group_id: z.number().int().optional(),
+    access_level: TagAccessLevel.optional(),
+});
+export function registerTagTools(server, ctx) {
+    server.tool('tag_list', 'List repository tags.', {
+        ...ProjectIdArg,
+        order_by: z.enum(['name', 'updated', 'version']).optional(),
+        sort: z.enum(['asc', 'desc']).optional(),
+        search: z.string().optional(),
+        ...PaginationArgs,
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...rest } = args;
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}/repository/tags`,
+            query: rest,
+        });
+        return res.data;
+    }));
+    server.tool('tag_get', 'Get a single tag by name.', { ...ProjectIdArg, tag_name: z.string() }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}/repository/tags/${encodeURIComponent(args.tag_name)}`,
+        });
+        return res.data;
+    }));
+    server.tool('tag_create', 'Create a new tag at a ref. Optionally annotates (with message).', {
+        ...ProjectIdArg,
+        tag_name: z.string(),
+        ref: z.string(),
+        message: z.string().optional().describe('When present, creates annotated tag.'),
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/projects/${projectId}/repository/tags`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('tag_delete', 'Delete a tag.', { ...ProjectIdArg, tag_name: z.string() }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/projects/${projectId}/repository/tags/${encodeURIComponent(args.tag_name)}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    server.tool('protected_tag_list', 'List protected tags.', { ...ProjectIdArg, ...PaginationArgs }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...rest } = args;
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}/protected_tags`,
+            query: rest,
+        });
+        return res.data;
+    }));
+    server.tool('protected_tag_get', 'Get a single protected tag (supports wildcards).', { ...ProjectIdArg, name: z.string() }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}/protected_tags/${encodeURIComponent(args.name)}`,
+        });
+        return res.data;
+    }));
+    server.tool('protected_tag_protect', 'Protect a tag (or wildcard) so only allowed users/groups can create it.', {
+        ...ProjectIdArg,
+        name: z.string(),
+        create_access_level: TagAccessLevel.optional(),
+        allowed_to_create: z.array(TagAccessRule).optional(),
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/projects/${projectId}/protected_tags`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('protected_tag_unprotect', 'Remove protection from a tag.', { ...ProjectIdArg, name: z.string() }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/projects/${projectId}/protected_tags/${encodeURIComponent(args.name)}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/tags/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/tags/tools.ts"],"names":[],"mappings":"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"}

package/dist/groups/todos/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerTodoTools(server: McpServer, ctx: ToolContext): void;