mcp-adr-analysis-server 2.1.9 → 2.1.19

package/dist/src/tools/llm-database-management-tool.d.ts

@@ -0,0 +1,62 @@
+/**
+ * LLM-Managed Database Management Tool
+ *
+ * Provides LLM-driven database operations with research-driven approach
+ */
+import type { ToolContext } from '../types/tool-context.js';
+/**
+ * LLM-managed database operations with research-driven approach
+ *
+ * @description Executes database operations using LLM to research best practices,
+ * generate appropriate commands, and execute them. Supports PostgreSQL, MongoDB, Redis, MySQL, and MariaDB.
+ *
+ * @param {Object} args - Database management configuration parameters
+ * @param {string} args.database - Database type (postgresql, mongodb, redis, mysql, mariadb)
+ * @param {string} args.action - Action to perform
+ * @param {Object} [args.parameters] - Action parameters
+ * @param {string} args.llmInstructions - LLM instructions for command generation
+ * @param {boolean} [args.researchFirst] - Research best approach first (default: true)
+ * @param {string} [args.projectPath] - Path to project root (defaults to cwd)
+ * @param {string} [args.adrDirectory] - ADR directory relative to project (defaults to 'docs/adrs')
+ *
+ * @returns {Promise<any>} Database operation results with LLM analysis
+ *
+ * @throws {McpAdrError} When required parameters are missing or operation fails
+ *
+ * @example
+ * ```typescript
+ * // PostgreSQL database creation
+ * const result = await llmDatabaseManagement({
+ *   database: 'postgresql',
+ *   action: 'create_database',
+ *   parameters: { dbName: 'myapp', owner: 'myuser' },
+ *   llmInstructions: 'Create a secure database with proper permissions'
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // MongoDB collection optimization
+ * const result = await llmDatabaseManagement({
+ *   database: 'mongodb',
+ *   action: 'optimize_collection',
+ *   parameters: { collection: 'users', indexFields: ['email', 'created_at'] },
+ *   llmInstructions: 'Optimize for read-heavy workloads with proper indexing'
+ * });
+ * ```
+ *
+ * @since 2.1.0
+ * @category Database Management
+ * @category LLM
+ * @mcp-tool
+ */
+export declare function llmDatabaseManagement(args: {
+    database: 'postgresql' | 'mongodb' | 'redis' | 'mysql' | 'mariadb';
+    action: string;
+    parameters?: Record<string, any>;
+    llmInstructions: string;
+    researchFirst?: boolean;
+    projectPath?: string;
+    adrDirectory?: string;
+}, context?: ToolContext): Promise<any>;
+//# sourceMappingURL=llm-database-management-tool.d.ts.map

package/dist/src/tools/llm-database-management-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-database-management-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/llm-database-management-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IACJ,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,EACD,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,GAAG,CAAC,CAmHd"}

package/dist/src/tools/llm-database-management-tool.js

@@ -0,0 +1,203 @@
+/**
+ * LLM-Managed Database Management Tool
+ *
+ * Provides LLM-driven database operations with research-driven approach
+ */
+import { McpAdrError } from '../types/index.js';
+import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
+/**
+ * LLM-managed database operations with research-driven approach
+ *
+ * @description Executes database operations using LLM to research best practices,
+ * generate appropriate commands, and execute them. Supports PostgreSQL, MongoDB, Redis, MySQL, and MariaDB.
+ *
+ * @param {Object} args - Database management configuration parameters
+ * @param {string} args.database - Database type (postgresql, mongodb, redis, mysql, mariadb)
+ * @param {string} args.action - Action to perform
+ * @param {Object} [args.parameters] - Action parameters
+ * @param {string} args.llmInstructions - LLM instructions for command generation
+ * @param {boolean} [args.researchFirst] - Research best approach first (default: true)
+ * @param {string} [args.projectPath] - Path to project root (defaults to cwd)
+ * @param {string} [args.adrDirectory] - ADR directory relative to project (defaults to 'docs/adrs')
+ *
+ * @returns {Promise<any>} Database operation results with LLM analysis
+ *
+ * @throws {McpAdrError} When required parameters are missing or operation fails
+ *
+ * @example
+ * ```typescript
+ * // PostgreSQL database creation
+ * const result = await llmDatabaseManagement({
+ *   database: 'postgresql',
+ *   action: 'create_database',
+ *   parameters: { dbName: 'myapp', owner: 'myuser' },
+ *   llmInstructions: 'Create a secure database with proper permissions'
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // MongoDB collection optimization
+ * const result = await llmDatabaseManagement({
+ *   database: 'mongodb',
+ *   action: 'optimize_collection',
+ *   parameters: { collection: 'users', indexFields: ['email', 'created_at'] },
+ *   llmInstructions: 'Optimize for read-heavy workloads with proper indexing'
+ * });
+ * ```
+ *
+ * @since 2.1.0
+ * @category Database Management
+ * @category LLM
+ * @mcp-tool
+ */
+export async function llmDatabaseManagement(args, context) {
+    const { database, action, parameters = {}, llmInstructions, researchFirst = true, projectPath, adrDirectory, } = args;
+    if (!database || !action || !llmInstructions) {
+        throw new McpAdrError('Database, action, and llmInstructions are required', 'MISSING_REQUIRED_PARAMS');
+    }
+    try {
+        context?.info(`🗄️ Initializing ${database} database management for: ${action}`);
+        context?.report_progress(0, 100);
+        // Initialize research orchestrator
+        const orchestrator = new ResearchOrchestrator(projectPath, adrDirectory);
+        let researchResult = null;
+        if (researchFirst) {
+            context?.info('📚 Researching best practices and optimization strategies...');
+            context?.report_progress(20, 100);
+            // Step 1: Research the best approach
+            const researchQuery = `
+How to ${action} in ${database}?
+Best practices for ${database} ${action}
+${database} ${action} documentation and examples
+Performance optimization for ${database} ${action}
+Security considerations for ${database} ${action}
+${llmInstructions}
+`;
+            researchResult = await orchestrator.answerResearchQuestion(researchQuery);
+        }
+        // Step 2: Generate command using LLM
+        context?.info('🤖 Generating database commands with LLM guidance...');
+        context?.report_progress(50, 100);
+        const command = await generateDatabaseCommand({
+            database,
+            action,
+            parameters,
+            research: researchResult,
+            instructions: llmInstructions,
+        });
+        // Step 3: Execute the command (simulated for now)
+        context?.info(`🗄️ Executing ${database} operation...`);
+        context?.report_progress(80, 100);
+        const executionResult = await executeDatabaseCommand(command);
+        context?.info('✅ Database operation complete!');
+        context?.report_progress(100, 100);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `# LLM-Managed Database Operation
+
+## Operation Details
+- **Database**: ${database}
+- **Action**: ${action}
+- **Parameters**: ${JSON.stringify(parameters, null, 2)}
+
+## LLM Instructions
+${llmInstructions}
+
+${researchResult
+                        ? `
+## Research Results
+- **Confidence**: ${(researchResult.confidence * 100).toFixed(1)}%
+- **Sources**: ${researchResult.metadata.sourcesQueried.join(', ')}
+- **Research Summary**: ${researchResult.answer}
+
+`
+                        : ''}
+
+## Generated Command
+\`\`\`sql
+${command.generated}
+\`\`\`
+
+## Execution Result
+${executionResult.success ? '✅ Success' : '❌ Failed'}
+${executionResult.output ? `\n\`\`\`\n${executionResult.output}\n\`\`\`` : ''}
+
+## LLM Analysis
+${command.analysis || 'No analysis available'}
+
+## Metadata
+- **Command Confidence**: ${(command.confidence * 100).toFixed(1)}%
+- **Timestamp**: ${new Date().toISOString()}
+- **Research-Driven**: ${researchFirst ? 'Yes' : 'No'}
+`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Database management operation failed: ${error instanceof Error ? error.message : String(error)}`, 'DATABASE_MANAGEMENT_ERROR');
+    }
+}
+/**
+ * Generate database command using LLM
+ */
+async function generateDatabaseCommand(context) {
+    // const { loadAIConfig, getAIExecutor } = await import('../config/ai-config.js');
+    // const aiConfig = loadAIConfig();
+    // const executor = getAIExecutor();
+    // const prompt = `
+    // Generate a ${context.database} command for the following operation:
+    //
+    // Action: ${context.action}
+    // Parameters: ${JSON.stringify(context.parameters, null, 2)}
+    // Instructions: ${context.instructions}
+    //
+    // ${context.research ? `
+    // Research Context:
+    // - Confidence: ${(context.research.confidence * 100).toFixed(1)}%
+    // - Sources: ${context.research.metadata.sourcesQueried.join(', ')}
+    // - Key Findings: ${context.research.answer}
+    // ` : ''}
+    //
+    // Database Context:
+    // ${getDatabaseContext(context.database)}
+    //
+    // Generate the appropriate command (SQL, CLI, or API call) and provide analysis of the approach.
+    // `;
+    // TODO: Implement LLM command generation when AI executor is available
+    // const result = await executor.executeStructuredPrompt(prompt, {
+    //   type: 'object',
+    //   properties: {
+    //     command: { type: 'string' },
+    //     confidence: { type: 'number' },
+    //     analysis: { type: 'string' }
+    //   }
+    // });
+    // return {
+    //   generated: result.data.command || '-- Command generation failed',
+    //   confidence: result.data.confidence || 0.5,
+    //   analysis: result.data.analysis || 'No analysis available'
+    // };
+    // Placeholder implementation
+    return {
+        generated: `-- LLM command generation for ${context.database} ${context.action} not yet implemented`,
+        confidence: 0.3,
+        analysis: 'LLM command generation is not yet available. This is a placeholder implementation.',
+    };
+}
+/**
+ * Execute database command (simulated for now)
+ */
+async function executeDatabaseCommand(command) {
+    // For now, simulate command execution
+    // In a real implementation, this would execute the actual database command
+    return {
+        success: command.confidence > 0.7,
+        output: `Simulated execution of: ${command.generated}\n\nThis is a simulation. In production, this would execute the actual database command.`,
+    };
+}
+// Database context functions will be used when LLM integration is complete
+//# sourceMappingURL=llm-database-management-tool.js.map

package/dist/src/tools/llm-database-management-tool.js.map

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

package/dist/src/tools/llm-web-search-tool.d.ts

@@ -0,0 +1,59 @@
+/**
+ * LLM-Managed Web Search Tool
+ *
+ * Uses Firecrawl for cross-platform web search with LLM-driven query optimization
+ */
+import type { ToolContext } from '../types/tool-context.js';
+/**
+ * LLM-managed web search using Firecrawl for cross-platform support
+ *
+ * @description Executes intelligent web search using Firecrawl with LLM-driven
+ * query optimization and content relevance scoring. Supports RHEL, Ubuntu, and macOS.
+ *
+ * @param {Object} args - Web search configuration parameters
+ * @param {string} args.query - The search query to execute
+ * @param {number} [args.maxResults] - Maximum results to return (default: 5)
+ * @param {boolean} [args.includeContent] - Include full content (default: true)
+ * @param {string} [args.llmInstructions] - LLM instructions for search optimization
+ * @param {string} [args.projectPath] - Path to project root (defaults to cwd)
+ * @param {string} [args.adrDirectory] - ADR directory relative to project (defaults to 'docs/adrs')
+ *
+ * @returns {Promise<any>} Web search results with LLM analysis
+ *
+ * @throws {McpAdrError} When query is empty or search fails
+ *
+ * @example
+ * ```typescript
+ * // Basic web search
+ * const result = await llmWebSearch({
+ *   query: 'Red Hat OpenShift best practices'
+ * });
+ *
+ * console.log(result.results); // Array of search results
+ * console.log(result.llmAnalysis); // LLM analysis of results
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Advanced search with LLM instructions
+ * const result = await llmWebSearch({
+ *   query: 'Kubernetes security hardening',
+ *   maxResults: 10,
+ *   llmInstructions: 'Focus on enterprise security practices and compliance requirements'
+ * });
+ * ```
+ *
+ * @since 2.1.0
+ * @category Web Search
+ * @category LLM
+ * @mcp-tool
+ */
+export declare function llmWebSearch(args: {
+    query: string;
+    maxResults?: number;
+    includeContent?: boolean;
+    llmInstructions?: string;
+    projectPath?: string;
+    adrDirectory?: string;
+}, context?: ToolContext): Promise<any>;
+//# sourceMappingURL=llm-web-search-tool.d.ts.map

package/dist/src/tools/llm-web-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-web-search-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/llm-web-search-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,EACD,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,GAAG,CAAC,CAiGd"}

package/dist/src/tools/llm-web-search-tool.js

@@ -0,0 +1,165 @@
+/**
+ * LLM-Managed Web Search Tool
+ *
+ * Uses Firecrawl for cross-platform web search with LLM-driven query optimization
+ */
+import { McpAdrError } from '../types/index.js';
+import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
+/**
+ * LLM-managed web search using Firecrawl for cross-platform support
+ *
+ * @description Executes intelligent web search using Firecrawl with LLM-driven
+ * query optimization and content relevance scoring. Supports RHEL, Ubuntu, and macOS.
+ *
+ * @param {Object} args - Web search configuration parameters
+ * @param {string} args.query - The search query to execute
+ * @param {number} [args.maxResults] - Maximum results to return (default: 5)
+ * @param {boolean} [args.includeContent] - Include full content (default: true)
+ * @param {string} [args.llmInstructions] - LLM instructions for search optimization
+ * @param {string} [args.projectPath] - Path to project root (defaults to cwd)
+ * @param {string} [args.adrDirectory] - ADR directory relative to project (defaults to 'docs/adrs')
+ *
+ * @returns {Promise<any>} Web search results with LLM analysis
+ *
+ * @throws {McpAdrError} When query is empty or search fails
+ *
+ * @example
+ * ```typescript
+ * // Basic web search
+ * const result = await llmWebSearch({
+ *   query: 'Red Hat OpenShift best practices'
+ * });
+ *
+ * console.log(result.results); // Array of search results
+ * console.log(result.llmAnalysis); // LLM analysis of results
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Advanced search with LLM instructions
+ * const result = await llmWebSearch({
+ *   query: 'Kubernetes security hardening',
+ *   maxResults: 10,
+ *   llmInstructions: 'Focus on enterprise security practices and compliance requirements'
+ * });
+ * ```
+ *
+ * @since 2.1.0
+ * @category Web Search
+ * @category LLM
+ * @mcp-tool
+ */
+export async function llmWebSearch(args, context) {
+    const { query, maxResults = 5, includeContent = true, llmInstructions, projectPath, adrDirectory, } = args;
+    if (!query || query.trim().length === 0) {
+        throw new McpAdrError('Query parameter is required and cannot be empty', 'INVALID_QUERY');
+    }
+    try {
+        context?.info(`🌐 Initializing web search for: ${query}`);
+        context?.report_progress(0, 100);
+        // Initialize research orchestrator with Firecrawl
+        const orchestrator = new ResearchOrchestrator(projectPath, adrDirectory);
+        // Enhance query with LLM instructions if provided
+        context?.info('🤖 Optimizing search query with LLM guidance...');
+        context?.report_progress(25, 100);
+        let enhancedQuery = query;
+        if (llmInstructions) {
+            enhancedQuery = `${query}\n\nLLM Instructions: ${llmInstructions}`;
+        }
+        // Perform web search using research orchestrator
+        context?.info('🔍 Executing web search with Firecrawl...');
+        context?.report_progress(50, 100);
+        const researchResult = await orchestrator.answerResearchQuestion(enhancedQuery);
+        // Extract web search results
+        const webSearchSource = researchResult.sources.find(source => source.type === 'web_search');
+        const webResults = webSearchSource?.data?.results || [];
+        // Limit results
+        const limitedResults = webResults.slice(0, maxResults);
+        // Generate LLM analysis of results
+        context?.info('📊 Analyzing search results with LLM...');
+        context?.report_progress(75, 100);
+        const llmAnalysis = await generateLLMAnalysis(query, limitedResults, llmInstructions);
+        context?.info('✅ Web search complete!');
+        context?.report_progress(100, 100);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `# LLM-Managed Web Search Results
+
+## Query
+${query}
+
+${llmInstructions ? `## LLM Instructions\n${llmInstructions}\n` : ''}
+
+## Search Results (${limitedResults.length} found)
+
+${limitedResults
+                        .map((result, index) => `
+### ${index + 1}. ${result.title}
+- **URL**: ${result.url}
+- **Relevance**: ${(result.relevance * 100).toFixed(1)}%
+- **Content**: ${includeContent ? result.content?.substring(0, 500) + '...' : 'Content available'}
+
+---
+`)
+                        .join('\n')}
+
+## LLM Analysis
+${llmAnalysis}
+
+## Search Metadata
+- **Provider**: Firecrawl
+- **Total Results**: ${webResults.length}
+- **Returned Results**: ${limitedResults.length}
+- **Confidence**: ${(researchResult.confidence * 100).toFixed(1)}%
+- **Timestamp**: ${new Date().toISOString()}
+`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Web search failed: ${error instanceof Error ? error.message : String(error)}`, 'WEB_SEARCH_ERROR');
+    }
+}
+/**
+ * Generate LLM analysis of search results
+ */
+async function generateLLMAnalysis(_query, _results, _instructions) {
+    // TODO: Implement LLM analysis when AI executor is available
+    // const { loadAIConfig, getAIExecutor } = await import('../config/ai-config.js');
+    // const aiConfig = loadAIConfig();
+    // const executor = getAIExecutor();
+    // const prompt = `
+    // Analyze these web search results for the query: "${query}"
+    //
+    // ${instructions ? `Additional Instructions: ${instructions}` : ''}
+    //
+    // Search Results:
+    // ${results.map((result, index) => `
+    // ${index + 1}. ${result.title}
+    // URL: ${result.url}
+    // Relevance: ${(result.relevance * 100).toFixed(1)}%
+    // Content Preview: ${result.content?.substring(0, 300)}...
+    // `).join('\n')}
+    //
+    // Provide analysis covering:
+    // 1. Overall quality and relevance of results
+    // 2. Key insights and findings
+    // 3. Gaps or missing information
+    // 4. Recommendations for further research
+    // 5. Summary of most valuable sources
+    //
+    // Keep analysis concise but comprehensive.
+    // `;
+    // const result = await executor.executeStructuredPrompt(prompt, {
+    //   type: 'object',
+    //   properties: {
+    //     analysis: { type: 'string' }
+    //   }
+    // });
+    // return result.data.analysis || 'Analysis unavailable';
+    return 'LLM analysis is not yet available. Results are available but require manual review.';
+}
+//# sourceMappingURL=llm-web-search-tool.js.map

package/dist/src/tools/llm-web-search-tool.js.map

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

package/dist/src/tools/mcp-planning-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-planning-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/mcp-planning-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAu2CH;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAgCzD"}
+{"version":3,"file":"mcp-planning-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/mcp-planning-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA02CH;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAgCzD"}

package/dist/src/tools/mcp-planning-tool.js

@@ -113,7 +113,11 @@ const ProjectPlanSchema = z.object({
         riskAssessmentInterval: z.string().default('weekly'),
         progressUpdateFrequency: z.string().default('daily'),
     })
-        .default({}),
+        .default(() => ({
+        autoPhaseTransition: false,
+        riskAssessmentInterval: 'weekly',
+        progressUpdateFrequency: 'daily',
+    })),
 });
 // Operation schemas
 const CreateProjectSchema = z.object({
@@ -334,7 +338,10 @@ async function createProject(args) {
     if (importFromAdrs) {
         try {
             const { discoverAdrsInDirectory } = await import('../utils/adr-discovery.js');
-            const discoveryResult = await discoverAdrsInDirectory(join(projectPath, 'docs/adrs'), true, projectPath);
+            const discoveryResult = await discoverAdrsInDirectory(join(projectPath, 'docs/adrs'), projectPath, {
+                includeContent: true,
+                includeTimeline: false,
+            });
             // Link relevant ADRs to phases
             for (const phase of projectPhases) {
                 const relatedAdrs = discoveryResult.adrs.filter((adr) => adr.title.toLowerCase().includes(phase.name.toLowerCase()) ||
@@ -1221,7 +1228,7 @@ export async function mcpPlanning(args) {
     }
     catch (error) {
         if (error instanceof z.ZodError) {
-            throw new McpAdrError(`Validation error: ${error.errors.map(e => e.message).join(', ')}`, 'VALIDATION_ERROR');
+            throw new McpAdrError(`Validation error: ${error.issues.map(e => e.message).join(', ')}`, 'VALIDATION_ERROR');
         }
         throw error;
     }