fraim 2.0.177 → 2.0.180

package/dist/src/services/provider-service.js

@@ -0,0 +1,215 @@
+"use strict";
+// Server-side provider service
+// This is the single source of truth for provider definitions
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.providerService = exports.ProviderService = void 0;
+// Provider Registry - Server-side single source of truth
+const PROVIDERS = {
+    github: {
+        id: 'github',
+        name: 'GitHub',
+        displayName: 'GitHub',
+        description: 'GitHub repository and issue management',
+        capabilities: ['code', 'issues', 'integrated'],
+        docsUrl: 'https://github.com/settings/tokens',
+        setupInstructions: 'Run "fraim add-provider github" — your IDE handles OAuth automatically on first use',
+        mcpServer: {
+            type: 'http',
+            url: 'https://api.githubcopilot.com/mcp/'
+        }
+    },
+    gitlab: {
+        id: 'gitlab',
+        name: 'GitLab',
+        displayName: 'GitLab',
+        description: 'GitLab repository and issue management',
+        capabilities: ['code', 'issues', 'integrated'],
+        docsUrl: 'https://gitlab.com/-/profile/personal_access_tokens',
+        setupInstructions: 'Create a Personal Access Token at https://gitlab.com/-/profile/personal_access_tokens with api scope',
+        mcpServer: {
+            type: 'http',
+            url: 'https://gitlab.com/api/v4/mcp',
+            authHeaderTemplate: 'Bearer {token}'
+        }
+    },
+    ado: {
+        id: 'ado',
+        name: 'Azure DevOps',
+        displayName: 'Azure DevOps',
+        description: 'Azure DevOps repository and work item management',
+        capabilities: ['code', 'issues', 'integrated'],
+        configRequirements: [
+            {
+                key: 'organization',
+                displayName: 'Azure DevOps Organization',
+                description: 'Your Azure DevOps organization name (for example, contoso)',
+                required: true,
+                type: 'string',
+                cliOptionName: 'organization'
+            }
+        ],
+        docsUrl: 'https://dev.azure.com',
+        setupInstructions: 'Create a Personal Access Token in Azure DevOps with Code (Read & Write) and Work Items (Read & Write) scopes',
+        mcpServer: {
+            type: 'stdio',
+            command: 'npx',
+            args: ['-y', '@azure-devops/mcp', '{config.organization}', '--authentication', 'envvar'],
+            envTemplate: {
+                ADO_MCP_AUTH_TOKEN: '{token}'
+            }
+        }
+    },
+    jira: {
+        id: 'jira',
+        name: 'Jira',
+        displayName: 'Jira',
+        description: 'Jira issue tracking and project management',
+        capabilities: ['issues'],
+        configRequirements: [
+            {
+                key: 'baseUrl',
+                displayName: 'Jira Base URL',
+                description: 'Your Jira instance URL (e.g., yourcompany.atlassian.net)',
+                required: true,
+                type: 'url',
+                cliOptionName: 'url',
+                validation: {
+                    pattern: '^https?://.*',
+                    errorMessage: 'Must be a valid URL'
+                }
+            },
+            {
+                key: 'email',
+                displayName: 'Email',
+                description: 'Your Jira account email address',
+                required: true,
+                type: 'email',
+                validation: {
+                    pattern: '^[^@]+@[^@]+\\.[^@]+$',
+                    errorMessage: 'Must be a valid email address'
+                }
+            }
+        ],
+        docsUrl: 'https://id.atlassian.com/manage-profile/security/api-tokens',
+        setupInstructions: 'Create an API Token at https://id.atlassian.com/manage-profile/security/api-tokens',
+        mcpServer: {
+            type: 'stdio',
+            command: 'uvx',
+            args: ['mcp-atlassian'],
+            envTemplate: {
+                JIRA_URL: '{config.baseUrl}',
+                JIRA_USERNAME: '{config.email}',
+                JIRA_API_TOKEN: '{token}'
+            }
+        }
+    }
+};
+class ProviderService {
+    /**
+     * Get all providers with computed hasAdditionalConfig
+     */
+    getAllProviders() {
+        return Object.values(PROVIDERS).map(provider => ({
+            ...provider,
+            hasAdditionalConfig: (provider.configRequirements?.length || 0) > 0
+        }));
+    }
+    /**
+     * Get a specific provider by ID with computed hasAdditionalConfig
+     */
+    getProvider(id) {
+        const provider = PROVIDERS[id];
+        if (!provider)
+            return null;
+        return {
+            ...provider,
+            hasAdditionalConfig: (provider.configRequirements?.length || 0) > 0
+        };
+    }
+    /**
+     * Get all provider IDs
+     */
+    getAllProviderIds() {
+        return Object.keys(PROVIDERS);
+    }
+    /**
+     * Check if a provider ID is valid
+     */
+    isValidProviderId(id) {
+        return id in PROVIDERS;
+    }
+    /**
+     * Get providers with a specific capability
+     */
+    getProvidersWithCapability(capability) {
+        return this.getAllProviders().filter(provider => provider.capabilities.includes(capability));
+    }
+    /**
+     * Check if a provider has a specific capability
+     */
+    providerHasCapability(providerId, capability) {
+        const provider = this.getProvider(providerId);
+        return provider ? provider.capabilities.includes(capability) : false;
+    }
+    /**
+     * Get config requirements for a provider
+     */
+    getProviderConfigRequirements(providerId) {
+        const provider = this.getProvider(providerId);
+        return provider?.configRequirements || [];
+    }
+    /**
+     * Check if a provider requires additional config
+     */
+    requiresAdditionalConfig(providerId) {
+        const requirements = this.getProviderConfigRequirements(providerId);
+        return requirements.length > 0;
+    }
+    /**
+     * Validate provider config against requirements
+     */
+    validateProviderConfig(providerId, config) {
+        const requirements = this.getProviderConfigRequirements(providerId);
+        const errors = [];
+        for (const req of requirements) {
+            const value = config[req.key];
+            // Check required fields
+            if (req.required && !value) {
+                errors.push({
+                    field: req.key,
+                    message: `${req.displayName} is required`
+                });
+                continue;
+            }
+            // Validate pattern if provided
+            if (value && req.validation?.pattern) {
+                const regex = new RegExp(req.validation.pattern);
+                if (!regex.test(value)) {
+                    errors.push({
+                        field: req.key,
+                        message: req.validation.errorMessage || `Invalid ${req.displayName}`
+                    });
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Get provider schema (for CLI to render prompts)
+     */
+    getProviderSchema(providerId) {
+        const provider = this.getProvider(providerId);
+        if (!provider)
+            return null;
+        return {
+            providerId,
+            configRequirements: provider.configRequirements || []
+        };
+    }
+}
+exports.ProviderService = ProviderService;
+// Export singleton instance
+exports.providerService = new ProviderService();