@structured-world/gitlab-mcp 4.0.0

package/dist/services/GitLabVersionDetector.d.ts

@@ -0,0 +1,53 @@
+import { GraphQLClient } from '../graphql/client';
+export type GitLabTier = 'free' | 'premium' | 'ultimate';
+export interface GitLabFeatures {
+    workItems: boolean;
+    epics: boolean;
+    iterations: boolean;
+    roadmaps: boolean;
+    portfolioManagement: boolean;
+    advancedSearch: boolean;
+    codeReview: boolean;
+    securityDashboard: boolean;
+    complianceFramework: boolean;
+    valueStreamAnalytics: boolean;
+    customFields: boolean;
+    okrs: boolean;
+    healthStatus: boolean;
+    weight: boolean;
+    multiLevelEpics: boolean;
+    serviceDesk: boolean;
+    requirements: boolean;
+    qualityManagement: boolean;
+    timeTracking: boolean;
+    crmContacts: boolean;
+    vulnerabilities: boolean;
+    errorTracking: boolean;
+    designManagement: boolean;
+    linkedResources: boolean;
+    emailParticipants: boolean;
+}
+export interface GitLabInstanceInfo {
+    version: string;
+    tier: GitLabTier;
+    features: GitLabFeatures;
+    detectedAt: Date;
+}
+export declare class GitLabVersionDetector {
+    private client;
+    private cachedInfo;
+    private testGroupPath;
+    constructor(client: GraphQLClient);
+    getCachedInfo(): GitLabInstanceInfo | null;
+    detectInstance(): Promise<GitLabInstanceInfo>;
+    private detectVersion;
+    private detectVersionFallback;
+    private detectTier;
+    private detectTierByFeatures;
+    private determineFeatures;
+    private parseVersion;
+    private isRecentCache;
+    isFeatureAvailable(feature: keyof GitLabFeatures): boolean;
+    getTier(): GitLabTier;
+    getVersion(): string;
+}

package/dist/services/GitLabVersionDetector.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitLabVersionDetector = void 0;
+const graphql_tag_1 = require("graphql-tag");
+const fetch_1 = require("../utils/fetch");
+const logger_1 = require("../logger");
+const VERSION_QUERY = (0, graphql_tag_1.gql) `
+  query GetVersionInfo {
+    metadata {
+      version
+      revision
+      kas {
+        enabled
+        version
+      }
+      enterprise
+    }
+    currentUser {
+      id
+      username
+      name
+    }
+  }
+`;
+const LICENSE_QUERY = (0, graphql_tag_1.gql) `
+  query GetLicenseInfo {
+    currentLicense {
+      id
+      type
+      plan
+      expiresAt
+      activatedAt
+      lastSync
+      billableUsersCount
+      maximumUserCount
+      usersInLicenseCount
+    }
+  }
+`;
+const FEATURE_DETECTION_QUERY = (0, graphql_tag_1.gql) `
+  query DetectFeatures($groupPath: String!) {
+    group(fullPath: $groupPath) {
+      id
+      epicsEnabled
+      iterationsEnabled: iterationCadences(first: 1) {
+        nodes {
+          id
+        }
+      }
+      workItemTypesEnabled: workItemTypes {
+        nodes {
+          id
+          name
+        }
+      }
+    }
+  }
+`;
+class GitLabVersionDetector {
+    client;
+    cachedInfo = null;
+    testGroupPath = 'test';
+    constructor(client) {
+        this.client = client;
+    }
+    getCachedInfo() {
+        return this.cachedInfo;
+    }
+    async detectInstance() {
+        if (this.cachedInfo && this.isRecentCache(this.cachedInfo.detectedAt)) {
+            return this.cachedInfo;
+        }
+        const version = await this.detectVersion();
+        const tier = await this.detectTier();
+        const features = this.determineFeatures(version, tier);
+        this.cachedInfo = {
+            version,
+            tier,
+            features,
+            detectedAt: new Date(),
+        };
+        return this.cachedInfo;
+    }
+    async detectVersion() {
+        try {
+            const response = await this.client.request(VERSION_QUERY);
+            return response.metadata.version;
+        }
+        catch (error) {
+            logger_1.logger.warn(`Failed to detect GitLab version via GraphQL, trying alternative methods: ${error instanceof Error ? error.message : String(error)}`);
+            return await this.detectVersionFallback();
+        }
+    }
+    async detectVersionFallback() {
+        try {
+            const baseUrl = this.client.endpoint.replace('/api/graphql', '');
+            const response = await (0, fetch_1.enhancedFetch)(`${baseUrl}/api/v4/version`);
+            if (response.ok) {
+                const data = (await response.json());
+                return data.version;
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn(`Failed to detect version via REST API: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return 'unknown';
+    }
+    async detectTier() {
+        try {
+            const response = await this.client.request(LICENSE_QUERY);
+            if (response.currentLicense) {
+                const plan = response.currentLicense.plan?.toLowerCase() ?? '';
+                if (plan.includes('ultimate') || plan.includes('gold')) {
+                    return 'ultimate';
+                }
+                else if (plan.includes('premium') || plan.includes('silver')) {
+                    return 'premium';
+                }
+            }
+        }
+        catch (error) {
+            logger_1.logger.debug(`License query not available, attempting feature detection: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return await this.detectTierByFeatures();
+    }
+    async detectTierByFeatures() {
+        try {
+            const response = await this.client.request(FEATURE_DETECTION_QUERY, {
+                groupPath: this.testGroupPath,
+            });
+            const group = response.group;
+            if (group?.epicsEnabled) {
+                const hasIterations = (group.iterationsEnabled?.nodes?.length ?? 0) > 0;
+                const hasAdvancedWorkItems = group.workItemTypesEnabled?.nodes?.some((type) => ['OBJECTIVE', 'KEY_RESULT', 'REQUIREMENT'].includes(type.name)) ?? false;
+                if (hasAdvancedWorkItems) {
+                    return 'ultimate';
+                }
+                else if (hasIterations) {
+                    return 'premium';
+                }
+                else {
+                    return 'premium';
+                }
+            }
+        }
+        catch (error) {
+            logger_1.logger.debug(`Feature detection failed, assuming free tier: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return 'free';
+    }
+    determineFeatures(version, tier) {
+        const versionNumber = this.parseVersion(version);
+        const features = {
+            workItems: versionNumber >= 15.0,
+            epics: tier !== 'free' && versionNumber >= 10.2,
+            iterations: tier !== 'free' && versionNumber >= 13.1,
+            roadmaps: tier !== 'free' && versionNumber >= 10.8,
+            portfolioManagement: tier === 'ultimate' && versionNumber >= 12.0,
+            advancedSearch: tier !== 'free' && versionNumber >= 11.0,
+            codeReview: tier !== 'free' && versionNumber >= 11.0,
+            securityDashboard: tier === 'ultimate' && versionNumber >= 11.1,
+            complianceFramework: tier === 'ultimate' && versionNumber >= 13.0,
+            valueStreamAnalytics: tier !== 'free' && versionNumber >= 12.3,
+            customFields: tier === 'ultimate' && versionNumber >= 17.0,
+            okrs: tier === 'ultimate' && versionNumber >= 15.7,
+            healthStatus: tier === 'ultimate' && versionNumber >= 13.1,
+            weight: tier !== 'free' && versionNumber >= 12.0,
+            multiLevelEpics: tier === 'ultimate' && versionNumber >= 11.7,
+            serviceDesk: tier !== 'free' && versionNumber >= 9.1,
+            requirements: tier === 'ultimate' && versionNumber >= 13.1,
+            qualityManagement: tier === 'ultimate' && versionNumber >= 13.0,
+            timeTracking: tier !== 'free' && versionNumber >= 8.14,
+            crmContacts: tier === 'ultimate' && versionNumber >= 14.0,
+            vulnerabilities: tier === 'ultimate' && versionNumber >= 12.5,
+            errorTracking: tier === 'ultimate' && versionNumber >= 12.7,
+            designManagement: tier !== 'free' && versionNumber >= 12.2,
+            linkedResources: tier !== 'free' && versionNumber >= 16.5,
+            emailParticipants: tier !== 'free' && versionNumber >= 16.0,
+        };
+        return features;
+    }
+    parseVersion(version) {
+        if (!version || version === 'unknown')
+            return 0;
+        const match = version.match(/^(\d+)\.(\d+)/);
+        if (!match)
+            return 0;
+        const major = parseInt(match[1], 10);
+        const minor = parseInt(match[2], 10);
+        return major + minor / 10;
+    }
+    isRecentCache(detectedAt) {
+        const cacheLifetime = 24 * 60 * 60 * 1000;
+        return Date.now() - detectedAt.getTime() < cacheLifetime;
+    }
+    isFeatureAvailable(feature) {
+        if (!this.cachedInfo) {
+            throw new Error('Instance info not detected yet. Call detectInstance() first.');
+        }
+        return this.cachedInfo.features[feature];
+    }
+    getTier() {
+        if (!this.cachedInfo) {
+            throw new Error('Instance info not detected yet. Call detectInstance() first.');
+        }
+        return this.cachedInfo.tier;
+    }
+    getVersion() {
+        if (!this.cachedInfo) {
+            throw new Error('Instance info not detected yet. Call detectInstance() first.');
+        }
+        return this.cachedInfo.version;
+    }
+}
+exports.GitLabVersionDetector = GitLabVersionDetector;
+//# sourceMappingURL=GitLabVersionDetector.js.map

package/dist/services/GitLabVersionDetector.js.map

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

package/dist/services/SchemaIntrospector.d.ts

@@ -0,0 +1,39 @@
+import { GraphQLClient } from '../graphql/client';
+export interface FieldInfo {
+    name: string;
+    type: {
+        name: string | null;
+        kind: string;
+        ofType?: {
+            name: string | null;
+            kind: string;
+        } | null;
+    };
+}
+export interface TypeInfo {
+    name: string;
+    fields: FieldInfo[] | null;
+    enumValues?: Array<{
+        name: string;
+        description?: string;
+    }> | null;
+}
+export interface SchemaInfo {
+    workItemWidgetTypes: string[];
+    typeDefinitions: Map<string, TypeInfo>;
+    availableFeatures: Set<string>;
+}
+export declare class SchemaIntrospector {
+    private client;
+    private cachedSchema;
+    constructor(client: GraphQLClient);
+    introspectSchema(): Promise<SchemaInfo>;
+    isWidgetTypeAvailable(widgetType: string): boolean;
+    getFieldsForType(typeName: string): FieldInfo[];
+    hasField(typeName: string, fieldName: string): boolean;
+    getAvailableWidgetTypes(): string[];
+    generateSafeWidgetQuery(requestedWidgets: string[]): string;
+    private generateSafeFieldSelections;
+    getCachedSchema(): SchemaInfo | null;
+    clearCache(): void;
+}

package/dist/services/SchemaIntrospector.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaIntrospector = void 0;
+const graphql_tag_1 = require("graphql-tag");
+const logger_1 = require("../logger");
+const INTROSPECTION_QUERY = (0, graphql_tag_1.gql) `
+  query IntrospectSchema {
+    __schema {
+      types {
+        name
+        kind
+        fields {
+          name
+          type {
+            name
+            kind
+            ofType {
+              name
+              kind
+            }
+          }
+        }
+        enumValues {
+          name
+          description
+        }
+      }
+    }
+  }
+`;
+class SchemaIntrospector {
+    client;
+    cachedSchema = null;
+    constructor(client) {
+        this.client = client;
+    }
+    async introspectSchema() {
+        if (this.cachedSchema) {
+            return this.cachedSchema;
+        }
+        try {
+            logger_1.logger.debug('🔍 Introspecting GitLab GraphQL schema...');
+            const result = await this.client.request(INTROSPECTION_QUERY);
+            const types = result.__schema.types;
+            const workItemWidgetType = types.find((type) => type.name === 'WorkItemWidgetType');
+            const workItemWidgetTypes = workItemWidgetType?.enumValues?.map((value) => value.name) ?? [];
+            const typeDefinitions = new Map();
+            const relevantTypes = types.filter((type) => type.name &&
+                (type.name.startsWith('WorkItem') ||
+                    type.name.includes('Widget') ||
+                    type.name === 'AwardEmoji' ||
+                    type.name === 'Milestone' ||
+                    type.name === 'User' ||
+                    type.name === 'Label'));
+            for (const type of relevantTypes) {
+                typeDefinitions.set(type.name, {
+                    name: type.name,
+                    fields: type.fields ?? null,
+                    enumValues: type.enumValues ?? null,
+                });
+            }
+            const availableFeatures = new Set();
+            for (const widgetType of workItemWidgetTypes) {
+                availableFeatures.add(widgetType);
+            }
+            this.cachedSchema = {
+                workItemWidgetTypes,
+                typeDefinitions,
+                availableFeatures,
+            };
+            logger_1.logger.info({
+                widgetTypes: workItemWidgetTypes.length,
+                typeDefinitions: typeDefinitions.size,
+                features: availableFeatures.size,
+            }, '✅ GraphQL schema introspection completed');
+            return this.cachedSchema;
+        }
+        catch (error) {
+            logger_1.logger.warn({ err: error }, '⚠️ Schema introspection failed, using fallback schema info');
+            this.cachedSchema = {
+                workItemWidgetTypes: [
+                    'ASSIGNEES',
+                    'LABELS',
+                    'MILESTONE',
+                    'DESCRIPTION',
+                    'START_AND_DUE_DATE',
+                    'WEIGHT',
+                    'TIME_TRACKING',
+                    'HEALTH_STATUS',
+                    'COLOR',
+                    'NOTIFICATIONS',
+                    'NOTES',
+                ],
+                typeDefinitions: new Map(),
+                availableFeatures: new Set(['workItems', 'epics', 'issues']),
+            };
+            return this.cachedSchema;
+        }
+    }
+    isWidgetTypeAvailable(widgetType) {
+        if (!this.cachedSchema) {
+            throw new Error('Schema not introspected yet. Call introspectSchema() first.');
+        }
+        return this.cachedSchema.availableFeatures.has(widgetType);
+    }
+    getFieldsForType(typeName) {
+        if (!this.cachedSchema) {
+            throw new Error('Schema not introspected yet. Call introspectSchema() first.');
+        }
+        const typeInfo = this.cachedSchema.typeDefinitions.get(typeName);
+        if (typeInfo?.fields) {
+            return typeInfo.fields;
+        }
+        if (typeName === 'WorkItemWidgetAssignees') {
+            return [{ name: 'assignees', type: { name: 'UserConnection', kind: 'OBJECT' } }];
+        }
+        if (typeName === 'WorkItemWidgetLabels') {
+            return [{ name: 'labels', type: { name: 'LabelConnection', kind: 'OBJECT' } }];
+        }
+        if (typeName === 'WorkItemWidgetMilestone') {
+            return [{ name: 'milestone', type: { name: 'Milestone', kind: 'OBJECT' } }];
+        }
+        return [];
+    }
+    hasField(typeName, fieldName) {
+        const fields = this.getFieldsForType(typeName);
+        return fields.some((field) => field.name === fieldName);
+    }
+    getAvailableWidgetTypes() {
+        if (!this.cachedSchema) {
+            throw new Error('Schema not introspected yet. Call introspectSchema() first.');
+        }
+        return this.cachedSchema.workItemWidgetTypes;
+    }
+    generateSafeWidgetQuery(requestedWidgets) {
+        if (!this.cachedSchema) {
+            throw new Error('Schema not introspected yet. Call introspectSchema() first.');
+        }
+        const safeWidgets = [];
+        for (const widget of requestedWidgets) {
+            if (this.isWidgetTypeAvailable(widget)) {
+                const widgetTypeName = `WorkItemWidget${widget.charAt(0) +
+                    widget
+                        .slice(1)
+                        .toLowerCase()
+                        .replace(/_([a-z])/g, (_, letter) => letter.toUpperCase())}`;
+                const fields = this.getFieldsForType(widgetTypeName);
+                const safeFields = this.generateSafeFieldSelections(fields);
+                if (safeFields.length > 0) {
+                    safeWidgets.push(`
+            ... on ${widgetTypeName} {
+              ${safeFields.join('\n              ')}
+            }
+          `);
+                }
+            }
+        }
+        return safeWidgets.join('\n');
+    }
+    generateSafeFieldSelections(fields) {
+        const safeFields = [];
+        for (const field of fields) {
+            if (field.type.kind === 'SCALAR' || field.type.kind === 'ENUM') {
+                safeFields.push(field.name);
+            }
+            else if (field.type.kind === 'OBJECT' && field.name !== 'type') {
+                if (field.name === 'milestone') {
+                    safeFields.push(`${field.name} { id title state }`);
+                }
+                else if (field.name === 'assignees' || field.name === 'participants') {
+                    safeFields.push(`${field.name} { nodes { id username } }`);
+                }
+                else if (field.name === 'labels') {
+                    safeFields.push(`${field.name} { nodes { id title color } }`);
+                }
+            }
+        }
+        return safeFields;
+    }
+    getCachedSchema() {
+        return this.cachedSchema;
+    }
+    clearCache() {
+        this.cachedSchema = null;
+    }
+}
+exports.SchemaIntrospector = SchemaIntrospector;
+//# sourceMappingURL=SchemaIntrospector.js.map

package/dist/services/SchemaIntrospector.js.map

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

package/dist/services/ToolAvailability.d.ts

@@ -0,0 +1,18 @@
+interface ToolRequirement {
+    minVersion: number;
+    requiredTier: 'free' | 'premium' | 'ultimate';
+    notes?: string;
+}
+export declare class ToolAvailability {
+    private static toolRequirements;
+    static isToolAvailable(toolName: string): boolean;
+    static getAvailableTools(): string[];
+    static getToolRequirement(toolName: string): ToolRequirement | undefined;
+    static getUnavailableReason(toolName: string): string | null;
+    private static parseVersion;
+    private static isTierSufficient;
+    static filterToolsByAvailability(tools: string[]): string[];
+    static getToolsByTier(tier: 'free' | 'premium' | 'ultimate'): string[];
+    static getToolsByMinVersion(minVersion: number): string[];
+}
+export {};