lutaml 0.10.19 → 0.11.2

data/lib/lutaml/qea/validation/package_validator.rb

@@ -1,111 +0,0 @@
-# frozen_string_literal: true
-
-module Lutaml
-  module Qea
-    module Validation
-      # Validates package structure and hierarchy
-      class PackageValidator < BaseValidator
-        def validate
-          validate_parent_references
-          validate_duplicate_names
-          validate_circular_hierarchy
-        end
-
-        private
-
-        def validate_parent_references # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
-          packages.each do |package|
-            next if package.root?
-
-            unless parent_exists?(package.parent_id)
-              package_path = resolve_package_path(package.package_id)
-              result.add_error(
-                category: :missing_reference,
-                entity_type: :package,
-                entity_id: package.package_id.to_s,
-                entity_name: package.name,
-                field: "parent_id",
-                reference: package.parent_id.to_s,
-                message: "Parent package #{package.parent_id} does not exist",
-                location: package_path,
-              )
-            end
-          end
-        end
-
-        def validate_duplicate_names # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
-          packages_by_parent = packages.group_by(&:parent_id)
-
-          packages_by_parent.each do |parent_id, sibling_packages|
-            names = sibling_packages.map(&:name)
-            duplicates = names.select { |name| names.count(name) > 1 }.uniq
-
-            duplicates.each do |dup_name|
-              dup_packages = sibling_packages.select { |p| p.name == dup_name }
-              dup_packages.each do |package|
-                package_path = resolve_package_path(package.package_id)
-                parent_path = if parent_id
-                                resolve_package_path(parent_id)
-                              else
-                                "Root"
-                              end
-                result.add_warning(
-                  category: :duplicate,
-                  entity_type: :package,
-                  entity_id: package.package_id.to_s,
-                  entity_name: package.name,
-                  field: "name",
-                  message: "Duplicate package name '#{dup_name}' " \
-                           "in parent #{parent_path}",
-                  location: package_path,
-                )
-              end
-            end
-          end
-        end
-
-        def validate_circular_hierarchy # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
-          packages.each do |package|
-            next if package.root?
-
-            path = [package.package_id]
-            current_id = package.parent_id
-
-            while current_id && !current_id.zero?
-              if path.include?(current_id)
-                package_path = resolve_package_path(package.package_id)
-                result.add_error(
-                  category: :circular_reference,
-                  entity_type: :package,
-                  entity_id: package.package_id.to_s,
-                  entity_name: package.name,
-                  field: "parent_id",
-                  message: "Circular package hierarchy detected: " \
-                           "#{path.join(' -> ')} -> #{current_id}",
-                  location: package_path,
-                )
-                break
-              end
-
-              path << current_id
-              parent = packages.find { |p| p.package_id == current_id }
-              break unless parent
-
-              current_id = parent.parent_id
-            end
-          end
-        end
-
-        def packages
-          @packages ||= context[:db_packages] || []
-        end
-
-        def parent_exists?(parent_id)
-          return true if parent_id.nil? || parent_id.zero?
-
-          packages.any? { |p| p.package_id == parent_id }
-        end
-      end
-    end
-  end
-end

data/lib/lutaml/qea/validation/validation_engine.rb

@@ -1,477 +0,0 @@
-# frozen_string_literal: true
-
-module Lutaml
-  module Qea
-    module Validation
-      # Main orchestrator for the validation system
-      # Coordinates all validators and consolidates results
-      #
-      # @example Basic usage
-      #   engine = ValidationEngine.new(document, database: db)
-      #   result = engine.validate
-      #   puts result.summary
-      #
-      # @example With specific validators
-      #   engine = ValidationEngine.new(document, database: db)
-      #   result = engine.validate(validators: [:package, :class])
-      class ValidationEngine
-        attr_reader :document, :database, :registry, :options
-
-        # Creates a new validation engine
-        #
-        # @param document [Object] The document to validate
-        # @param database [Lutaml::Qea::Database] Database connection
-        # @param options [Hash] Validation options
-        # @option options [Boolean] :strict Fail on errors
-        # @option options [Boolean] :verbose Detailed output
-        # @option options [Symbol] :min_severity Minimum severity to report
-        # @option options [Array<Symbol>] :categories Categories to check
-        def initialize(document, database: nil, **options)
-          @document = document
-          @database = database
-          @options = options
-          @registry = ValidatorRegistry.new
-          setup_default_validators
-        end
-
-        # Runs validation using two-phase architecture
-        #
-        # Phase 1: QEA Database Integrity Validation
-        # - Validates EA database schema constraints
-        # - Checks referential integrity
-        # - Detects orphaned records
-        # - Finds circular references
-        #
-        # Phase 2: UML Tree Structure Validation
-        # - Validates transformed UML document tree
-        # - Checks proper nesting
-        # - Validates duplicate names
-        # - Verifies type references
-        #
-        # @param validators [Array<Symbol>, nil] List of validators to run,
-        #   or nil to run all
-        # @return [ValidationResult]
-        def validate(validators: nil) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
-          result = ValidationResult.new
-          context = build_context
-          context[:result] = result
-
-          # Phase 1: QEA Database Validation
-          phase1_result = validate_qea_database(context, validators)
-
-          # Phase 2: UML Tree Validation
-          phase2_result = validate_uml_tree(context, validators)
-
-          # Merge results
-          phase1_result.messages.each { |msg| result.messages << msg }
-          phase2_result.messages.each { |msg| result.messages << msg }
-
-          filter_result(result)
-        end
-
-        # Validates QEA database integrity
-        #
-        # @param context [Hash] Validation context
-        # @param validators [Array<Symbol>, nil] Optional validator filter
-        # @return [ValidationResult]
-        def validate_qea_database(context, validators = nil) # rubocop:disable Metrics/MethodLength
-          result = ValidationResult.new
-          db_context = context.merge(result: result)
-
-          database_validators = %i[
-            referential_integrity
-            orphan
-            circular_reference
-            package
-          ]
-
-          validator_names = if validators
-                              (database_validators & validators)
-                            else
-                              database_validators
-                            end
-
-          validator_names.each do |name|
-            next unless @registry.registered?(name)
-
-            @registry.validate(name, db_context)
-          end
-
-          result
-        end
-
-        # Validates UML document tree structure
-        #
-        # @param context [Hash] Validation context
-        # @param validators [Array<Symbol>, nil] Optional validator filter
-        # @return [ValidationResult]
-        def validate_uml_tree(context, validators = nil) # rubocop:disable Metrics/MethodLength
-          result = ValidationResult.new
-          uml_context = context.merge(result: result)
-
-          uml_validators = %i[
-            document_structure
-            class
-            attribute
-            operation
-            association
-            diagram
-          ]
-
-          validator_names = if validators
-                              (uml_validators & validators)
-                            else
-                              uml_validators
-                            end
-
-          validator_names.each do |name|
-            next unless @registry.registered?(name)
-
-            @registry.validate(name, uml_context)
-          end
-
-          result
-        end
-
-        # Validates and displays the result
-        #
-        # @param validators [Array<Symbol>, nil] List of validators to run
-        # @param formatter [Symbol] Output format (:text, :json, :html)
-        # @return [ValidationResult]
-        def validate_and_display(validators: nil, formatter: :text)
-          result = validate(validators: validators)
-          display_result(result, formatter)
-          result
-        end
-
-        # Registers a custom validator
-        #
-        # @param name [Symbol] Validator name
-        # @param validator_class [Class] Validator class
-        # @return [void]
-        def register_validator(name, validator_class)
-          @registry.register(name, validator_class)
-        end
-
-        # Checks if validation passed (no errors)
-        #
-        # @param validators [Array<Symbol>, nil] List of validators to run
-        # @return [Boolean]
-        def valid?(validators: nil)
-          result = validate(validators: validators)
-          !result.has_errors?
-        end
-
-        private
-
-        # Sets up default validators
-        #
-        # @return [void]
-        def setup_default_validators # rubocop:disable Metrics/MethodLength
-          # Phase 1: QEA Database Integrity Validators
-          @registry.register(:referential_integrity,
-                             ReferentialIntegrityValidator)
-          @registry.register(:orphan, OrphanValidator)
-          @registry.register(:circular_reference,
-                             CircularReferenceValidator)
-          @registry.register(:package, PackageValidator)
-
-          # Phase 2: UML Tree Structure Validators
-          @registry.register(:document_structure,
-                             Lutaml::Uml::Validation::DocumentStructureValidator)
-          @registry.register(:class, ClassValidator)
-          @registry.register(:attribute, AttributeValidator)
-          @registry.register(:operation, OperationValidator)
-          @registry.register(:association, AssociationValidator)
-          @registry.register(:diagram, DiagramValidator)
-        end
-
-        # Builds validation context
-        #
-        # @return [Hash]
-        def build_context # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
-          context = {
-            document: @document,
-            database: @database,
-            options: @options,
-          }
-
-          # Extract entities from transformed document (preferred source)
-          if @document
-            context[:classes] = extract_all_classes(@document)
-            context[:packages] = extract_all_packages(@document)
-            context[:enumerations] = extract_all_enums(@document)
-            context[:data_types] = extract_all_data_types(@document)
-            context[:associations] = @document.associations || []
-          end
-
-          # Add database entities for referential integrity checks only
-          # Note: Use document entities for primary validation
-          if @database
-            context[:db_packages] = @database.packages || []
-            context[:db_objects] = @database.objects.all
-            context[:attributes] = @database.attributes || []
-            context[:operations] = @database.operations || []
-            context[:connectors] = @database.connectors || []
-            context[:diagrams] = @database.diagrams || []
-            context[:diagram_objects] = @database.diagram_objects || []
-            context[:diagram_links] = @database.diagram_links || []
-          end
-
-          context
-        end
-
-        # Extract all classes from document hierarchy
-        #
-        # @param document [Lutaml::Uml::Document]
-        # @return [Array<Lutaml::Uml::Class>]
-        def extract_all_classes(document)
-          classes = []
-
-          # Top-level classes
-          classes.concat(document.classes || [])
-
-          # Classes within packages (recursive)
-          (document.packages || []).each do |package|
-            classes.concat(extract_classes_from_package(package))
-          end
-
-          classes
-        end
-
-        # Extract classes from a package recursively
-        #
-        # @param package [Lutaml::Uml::Package]
-        # @return [Array<Lutaml::Uml::Class>]
-        def extract_classes_from_package(package)
-          classes = []
-
-          # Classes in this package
-          classes.concat(package.classes || [])
-
-          # Recursively extract from child packages
-          (package.packages || []).each do |child_package|
-            classes.concat(extract_classes_from_package(child_package))
-          end
-
-          classes
-        end
-
-        # Extract all packages from document hierarchy
-        #
-        # @param document [Lutaml::Uml::Document]
-        # @return [Array<Lutaml::Uml::Package>]
-        def extract_all_packages(document)
-          packages = []
-
-          (document.packages || []).each do |package|
-            packages << package
-            packages.concat(extract_packages_from_package(package))
-          end
-
-          packages
-        end
-
-        # Extract packages from a package recursively
-        #
-        # @param package [Lutaml::Uml::Package]
-        # @return [Array<Lutaml::Uml::Package>]
-        def extract_packages_from_package(package)
-          packages = []
-
-          (package.packages || []).each do |child_package|
-            packages << child_package
-            packages.concat(extract_packages_from_package(child_package))
-          end
-
-          packages
-        end
-
-        # Extract all enums from document hierarchy
-        #
-        # @param document [Lutaml::Uml::Document]
-        # @return [Array<Lutaml::Uml::Enum>]
-        def extract_all_enums(document)
-          enums = []
-
-          # Top-level enums
-          enums.concat(document.enums || [])
-
-          # Enums within packages (recursive)
-          (document.packages || []).each do |package|
-            enums.concat(extract_enums_from_package(package))
-          end
-
-          enums
-        end
-
-        # Extract enums from a package recursively
-        #
-        # @param package [Lutaml::Uml::Package]
-        # @return [Array<Lutaml::Uml::Enum>]
-        def extract_enums_from_package(package)
-          enums = []
-
-          # Enums in this package
-          enums.concat(package.enums || [])
-
-          # Recursively extract from child packages
-          (package.packages || []).each do |child_package|
-            enums.concat(extract_enums_from_package(child_package))
-          end
-
-          enums
-        end
-
-        # Extract all data types from document hierarchy
-        #
-        # @param document [Lutaml::Uml::Document]
-        # @return [Array<Lutaml::Uml::DataType>]
-        def extract_all_data_types(document)
-          data_types = []
-
-          # Top-level data types
-          data_types.concat(document.data_types || [])
-
-          # Data types within packages (recursive)
-          (document.packages || []).each do |package|
-            data_types.concat(extract_data_types_from_package(package))
-          end
-
-          data_types
-        end
-
-        # Extract data types from a package recursively
-        #
-        # @param package [Lutaml::Uml::Package]
-        # @return [Array<Lutaml::Uml::DataType>]
-        def extract_data_types_from_package(package)
-          data_types = []
-
-          # Data types in this package
-          data_types.concat(package.data_types || [])
-
-          # Recursively extract from child packages
-          (package.packages || []).each do |child_package|
-            data_types.concat(extract_data_types_from_package(child_package))
-          end
-
-          data_types
-        end
-
-        # Filters result based on options
-        #
-        # @param result [ValidationResult]
-        # @return [ValidationResult]
-        def filter_result(result)
-          return result unless @options[:min_severity] ||
-            @options[:categories]
-
-          filtered_result = ValidationResult.new
-
-          result.messages.each do |message|
-            next if severity_filtered?(message)
-            next if category_filtered?(message)
-
-            filtered_result.messages << message
-          end
-
-          filtered_result
-        end
-
-        # Checks if message should be filtered by severity
-        #
-        # @param message [ValidationMessage]
-        # @return [Boolean]
-        def severity_filtered?(message)
-          return false unless @options[:min_severity]
-
-          severity_levels = {
-            info: 0,
-            warning: 1,
-            error: 2,
-          }
-
-          min_level = severity_levels[@options[:min_severity]] || 0
-          message_level = severity_levels[message.severity] || 0
-
-          message_level < min_level
-        end
-
-        # Checks if message should be filtered by category
-        #
-        # @param message [ValidationMessage]
-        # @return [Boolean]
-        def category_filtered?(message)
-          return false unless @options[:categories]
-
-          !@options[:categories].include?(message.category)
-        end
-
-        # Displays validation result
-        #
-        # @param result [ValidationResult]
-        # @param formatter [Symbol] Output format
-        # @return [void]
-        def display_result(result, formatter)
-          case formatter
-          when :json
-            puts result.to_json
-          else
-            display_text_result(result)
-          end
-        end
-
-        # Displays result in text format
-        #
-        # @param result [ValidationResult]
-        # @return [void]
-        def display_text_result(result) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
-          puts "=" * 80
-          puts "VALIDATION REPORT"
-          puts "=" * 80
-          puts
-          puts result.summary
-          puts
-
-          if result.has_errors?
-            puts "ERRORS (#{result.errors.size}):"
-            puts
-            display_messages_by_category(result.errors)
-          end
-
-          if result.has_warnings?
-            puts
-            puts "WARNINGS (#{result.warnings.size}):"
-            puts
-            display_messages_by_category(result.warnings)
-          end
-
-          if result.has_info? && @options[:verbose]
-            puts
-            puts "INFO (#{result.info.size}):"
-            puts
-            display_messages_by_category(result.info)
-          end
-
-          puts "=" * 80
-        end
-
-        # Displays messages grouped by category
-        #
-        # @param messages [Array<ValidationMessage>]
-        # @return [void]
-        def display_messages_by_category(messages)
-          messages.group_by(&:category).each do |category, msgs|
-            puts "  #{category.to_s.split('_').map(&:capitalize).join(' ')} " \
-                 "(#{msgs.size}):"
-            msgs.each do |msg|
-              puts "    #{msg}"
-              puts
-            end
-          end
-        end
-      end
-    end
-  end
-end