lutaml 0.10.15 → 0.10.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb62e96e62545c49b005e89cc972bc7dfb9510dbd9867831db9b6f4ab0bbcc40
-  data.tar.gz: 3975abff3b9a8e54714a76209d5917ed1bcf291baf9dcdf405c658d211934714
+  metadata.gz: 330cf6a6d4021d51bfb8ee166e4f6dce5697ed5fff82cdc6043a6d304d7e853d
+  data.tar.gz: 4bd730f3e5a2ae0427d2157bb862788ddd516280d86b9f791ec3e46473710dac
 SHA512:
-  metadata.gz: a09b2b6074e7fb3fa04d2084b16c35ac5f9c115708ac8f50efaac08b5999cd21613053df9eebe487a714c361317e4411de2ecc8d2286b8100e3fe23102854265
-  data.tar.gz: 6d6c1dd06afac86c94ba1047087914b59b95d09e11308482f90bb3b99b4b65633eb443a565200842f07ce51064b14e2441a4406f408697a8fe55ef67ce33c9eb
+  metadata.gz: b1cf1135be7d630644fbf782c1070231a54c0c3341b8c1be7c688a4d3c29d2aa34c26ef900f056c8d50f9c10b674e0470d46646de49b5386de51896e45a79ee3
+  data.tar.gz: 5b716ba1f4bd818a81f7fd54567add05c1ed0682fb407379db5d086fc8c636586e5a162480b821a23be4977d31ebe986be61531851faad122ddf0c74785bd59c

data/.rubocop_todo.yml

@@ -1,24 +1,21 @@
 # This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2026-05-13 02:18:49 UTC using RuboCop version 1.86.1.
+# `rubocop --auto-gen-config --no-offense-counts`
+# on 2026-05-13 08:26:11 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 155
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 1
 Lint/BinaryOperatorWithIdenticalOperands:
   Exclude:
     - 'spec/lutaml/qea/lookup_tables_spec.rb'
 
-# Offense count: 15
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
 Lint/ConstantDefinitionInBlock:
@@ -29,14 +26,12 @@ Lint/ConstantDefinitionInBlock:
     - 'spec/lutaml/model_transformations_spec.rb'
     - 'spec/lutaml/uml_repository/presenters/presenter_factory_spec.rb'
 
-# Offense count: 2
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
     - 'lib/lutaml/uml/model_helpers.rb'
     - 'lib/lutaml/uml_repository/queries/package_query.rb'
 
-# Offense count: 4
 # Configuration parameters: AllowComments, AllowEmptyLambdas.
 Lint/EmptyBlock:
   Exclude:
@@ -45,7 +40,6 @@ Lint/EmptyBlock:
     - 'spec/lutaml/uml_repository/package_exporter_spec.rb'
     - 'spec/lutaml/uml_repository/repository_spec.rb'
 
-# Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowComments.
 Lint/EmptyConditionalBody:
@@ -53,18 +47,15 @@ Lint/EmptyConditionalBody:
     - 'spec/integration/qea_xmi_equivalency_spec.rb'
     - 'spec/lutaml/qea/verification/equivalence_integration_spec.rb'
 
-# Offense count: 4
 Lint/IneffectiveAccessModifier:
   Exclude:
     - 'lib/lutaml/uml_repository/repository_enhanced.rb'
 
-# Offense count: 1
 # Configuration parameters: AllowedParentClasses.
 Lint/MissingSuper:
   Exclude:
     - 'lib/lutaml/uml_repository/lazy_repository.rb'
 
-# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
@@ -72,24 +63,24 @@ Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/lutaml/cli/uml/export_command.rb'
 
-# Offense count: 3
 Lint/UselessConstantScoping:
   Exclude:
     - 'lib/lutaml/cli/interactive_shell.rb'
+    - 'lib/lutaml/cli/uml/diagram_command.rb'
     - 'lib/lutaml/qea/factory/ea_to_uml_factory.rb'
+    - 'lib/lutaml/uml_repository/static_site/generator.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/inheritance_resolver.rb'
 
-# Offense count: 8
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
     - 'lib/lutaml/cli/interactive_shell/query_commands.rb'
+    - 'lib/lutaml/cli/uml/diagram_command.rb'
     - 'lib/lutaml/qea/factory/generalization_builder.rb'
     - 'lib/lutaml/uml_repository/exporters/markdown/class_page_builder.rb'
     - 'lib/lutaml/uml_repository/queries/search_query.rb'
     - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
-    - 'lib/lutaml/xmi/liquid_drops/klass_drop.rb'
 
-# Offense count: 4
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
@@ -98,24 +89,20 @@ Metrics/CyclomaticComplexity:
     - 'lib/lutaml/uml_repository/queries/search_query.rb'
     - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
 
-# Offense count: 48
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 18
+  Max: 17
 
-# Offense count: 4
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 7
 
-# Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
     - 'lib/lutaml/qea/factory/ea_to_uml_factory.rb'
     - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
 
-# Offense count: 3
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
@@ -124,7 +111,6 @@ Naming/MethodParameterName:
     - 'lib/lutaml/uml_repository/static_site/generator.rb'
     - 'spec/lutaml/parsers/serialize_xmi_to_liquid_spec.rb'
 
-# Offense count: 3
 # Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
 # AllowedMethods: call
 # WaywardPredicates: infinite?, nonzero?
@@ -133,30 +119,25 @@ Naming/PredicateMethod:
     - 'lib/lutaml/qea/factory/document_builder.rb'
     - 'spec/lutaml/xmi/liquid_drops/nil_safety_spec.rb'
 
-# Offense count: 2
 # Configuration parameters: MinSize.
 Performance/CollectionLiteralInLoop:
   Exclude:
     - 'spec/lutaml/qea/infrastructure/table_reader_spec.rb'
     - 'spec/lutaml/uml_repository/index_builder_spec.rb'
 
-# Offense count: 2
 Performance/MapMethodChain:
   Exclude:
     - 'lib/lutaml/cli/output_formatter.rb'
     - 'lib/lutaml/qea/models/ea_diagram_link.rb'
 
-# Offense count: 5
 RSpec/AnyInstance:
   Exclude:
     - 'spec/lutaml/uml_repository/static_site/generator_spec.rb'
 
-# Offense count: 1
 RSpec/BeforeAfterAll:
   Exclude:
     - 'spec/lutaml/qea/verification/comprehensive_equivalence_spec.rb'
 
-# Offense count: 24
 # Configuration parameters: Prefixes, AllowedPatterns.
 # Prefixes: when, with, without
 RSpec/ContextWording:
@@ -174,42 +155,35 @@ RSpec/ContextWording:
     - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
     - 'spec/lutaml/xml/parsers/xml_spec.rb'
 
-# Offense count: 22
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
 
-# Offense count: 649
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 30
 
-# Offense count: 7
 # This cop supports safe autocorrection (--autocorrect).
 RSpec/ExpectActual:
   Exclude:
     - 'spec/lutaml/qea/diagram_support_spec.rb'
     - 'spec/lutaml/qea/services/configuration_spec.rb'
 
-# Offense count: 1
 RSpec/ExpectInLet:
   Exclude:
     - 'spec/lutaml/ea/diagram/svg_accuracy_spec.rb'
 
-# Offense count: 90
 RSpec/ExpectOutput:
   Exclude:
     - 'spec/lutaml/cli/interactive_shell_spec.rb'
     - 'spec/lutaml/cli/package_commands_spec.rb'
 
-# Offense count: 5
 # Configuration parameters: Max, AllowedIdentifiers, AllowedPatterns.
 RSpec/IndexedLet:
   Exclude:
     - 'spec/lutaml/qea/repositories/base_repository_spec.rb'
     - 'spec/lutaml/qea/repositories/object_repository_spec.rb'
 
-# Offense count: 15
 RSpec/LeakyConstantDeclaration:
   Exclude:
     - 'spec/lutaml/model_transformations/format_registry_spec.rb'
@@ -218,12 +192,10 @@ RSpec/LeakyConstantDeclaration:
     - 'spec/lutaml/model_transformations_spec.rb'
     - 'spec/lutaml/uml_repository/presenters/presenter_factory_spec.rb'
 
-# Offense count: 1
 RSpec/LeakyLocalVariable:
   Exclude:
     - 'spec/lutaml/ea/diagram/svg_accuracy_spec.rb'
 
-# Offense count: 11
 # Configuration parameters: EnforcedStyle.
 # SupportedStyles: have_received, receive
 RSpec/MessageSpies:
@@ -233,21 +205,17 @@ RSpec/MessageSpies:
     - 'spec/lutaml/uml_repository/presenters/diagram_presenter_spec.rb'
     - 'spec/lutaml/uml_repository/repository_spec.rb'
 
-# Offense count: 39
 RSpec/MultipleExpectations:
   Max: 7
 
-# Offense count: 149
 # Configuration parameters: AllowSubject.
 RSpec/MultipleMemoizedHelpers:
   Max: 11
 
-# Offense count: 33
 # Configuration parameters: AllowedGroups.
 RSpec/NestedGroups:
   Max: 4
 
-# Offense count: 2
 # Configuration parameters: AllowedPatterns.
 # AllowedPatterns: ^expect_, ^assert_
 RSpec/NoExpectationExample:
@@ -255,7 +223,6 @@ RSpec/NoExpectationExample:
     - 'spec/lutaml/qea/verification/comprehensive_equivalence_spec.rb'
     - 'spec/lutaml/uml_repository/static_site/generator_spec.rb'
 
-# Offense count: 12
 RSpec/RepeatedExample:
   Exclude:
     - 'spec/lutaml/cli/package_commands_spec.rb'
@@ -263,12 +230,10 @@ RSpec/RepeatedExample:
     - 'spec/lutaml/qea/validation/validation_engine_spec.rb'
     - 'spec/lutaml/uml_repository/static_site/data_transformer_spec.rb'
 
-# Offense count: 2
 RSpec/RepeatedExampleGroupDescription:
   Exclude:
     - 'spec/lutaml/uml/parsers/dsl_spec.rb'
 
-# Offense count: 4
 # Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
 # SupportedInflectors: default, active_support
 RSpec/SpecFilePathFormat:
@@ -278,40 +243,20 @@ RSpec/SpecFilePathFormat:
     - 'spec/lutaml/parsers/serialize_xmi_to_liquid_spec.rb'
     - 'spec/lutaml/uml_repository/web_ui/app_spec.rb'
 
-# Offense count: 3
-Security/Eval:
-  Exclude:
-    - 'spec/lutaml/cli/uml/search_command_spec.rb'
-
-# Offense count: 2
 Security/MarshalLoad:
   Exclude:
     - 'lib/lutaml/uml_repository/package_loader.rb'
 
-# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
 Style/ComparableClamp:
   Exclude:
     - 'lib/lutaml/cli/enhanced_formatter.rb'
 
-# Offense count: 2
-Style/DocumentDynamicEvalDefinition:
-  Exclude:
-    - 'spec/lutaml/cli/uml/search_command_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Style/EvalWithLocation:
-  Exclude:
-    - 'spec/lutaml/cli/uml/search_command_spec.rb'
-
-# Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
 Style/PartitionInsteadOfDoubleSelect:
   Exclude:
     - 'lib/lutaml/qea/factory/generalization_builder.rb'
 
-# Offense count: 3
 # Configuration parameters: Max.
 Style/SafeNavigationChainLength:
   Exclude:

data/CLAUDE.md

@@ -0,0 +1,38 @@
+# CLAUDE.md — Lutaml Project
+
+## Project Overview
+Lutaml is a Ruby gem for parsing and transforming UML models from multiple formats (XMI, QEA/EA, DSL). It provides a CLI, interactive shell, static site generator, web UI, and model transformation pipeline.
+
+## Testing Constraints
+
+**CRITICAL: Do NOT run the full test suite at once.** It will crash due to memory. Run targeted subsets:
+- `bundle exec rspec spec/lutaml/cli/` — CLI specs
+- `bundle exec rspec spec/lutaml/qea/` — QEA parser specs
+- `bundle exec rspec spec/lutaml/uml_repository/` — UML repository specs
+- `bundle exec rspec spec/lutaml/uml/` — UML model specs
+- `bundle exec rspec spec/lutaml/parsers/` — Parser specs
+- `bundle exec rspec spec/lutaml/formatter/` — Formatter specs
+- Combine at most 2-3 suites at a time for targeted verification.
+
+## Code Quality Rules
+- Never use `send` (breaks encapsulation). Use `public_send` only when dynamic dispatch is truly necessary.
+- Never use `respond_to?` (poor typing). Use `is_a?` for type checks.
+- Extract god methods into focused helpers.
+- Keep files under ~300 lines. Extract into modules/classes when growing.
+- DRY: consolidate duplicated patterns (especially `format_definition`, index building, metadata construction).
+- Never commit TODO tracking files to git.
+
+## Architecture
+- `lib/lutaml/uml/` — UML domain models (Class, Association, Package, etc.)
+- `lib/lutaml/uml_repository/` — Repository pattern over UML documents (queries, presenters, exporters, SPA)
+- `lib/lutaml/qea/` — EA .qea SQLite parser and factory
+- `lib/lutaml/xmi/` — XMI XML parsing
+- `lib/lutaml/converter/` — Format converters (XMI→UML, DSL→UML)
+- `lib/lutaml/cli/` — Thor CLI commands
+- `lib/lutaml/model_transformations/` — Format-agnostic transformation pipeline
+- `lib/lutaml/ea/` — EA diagram SVG rendering
+
+## CI Notes
+- Ignore Ruby 3.4 ubuntu failures (performance-related, not code issues)
+- Ignore macOS job slowness (GitHub Actions is slow for macOS)
+- Windows tempfile Permission denied errors are pre-existing flakiness

data/lib/lutaml/cli/interactive_shell/help_display.rb

@@ -60,42 +60,44 @@ module Lutaml
           end
         end
 
+        HELP_TEXT = <<~HELP
+          Available Commands:
+
+          Navigation:
+            cd PATH           Change to package path
+            pwd               Print current path
+            ls [PATH]         List packages
+            tree [PATH]       Show package tree
+            up                Go to parent package
+            root              Go to ModelRoot
+            back              Go to previous location
+
+          Query:
+            find CLASS        Find class (fuzzy search)
+            show class QNAME  Show class details
+            show package PATH Show package details
+            show NUMBER       Show numbered result
+            search QUERY      Full-text search
+            ? QUERY           Alias for search
+
+          Bookmarks:
+            bookmark add NAME  Bookmark current location
+            bookmark list      List bookmarks
+            bookmark go NAME   Jump to bookmark
+            bookmark rm NAME   Remove bookmark
+            bm NAME            Quick jump
+
+          Utilities:
+            help [COMMAND]    Show help
+            history           Show command history
+            clear             Clear screen
+            config            Show configuration
+            stats             Show statistics
+            exit, quit, q     Exit shell
+        HELP
+
         def display_general_help
-          puts <<~HELP
-            #{OutputFormatter.colorize('Available Commands:', :cyan)}
-
-            #{OutputFormatter.colorize('Navigation:', :yellow)}
-              cd PATH           Change to package path
-              pwd               Print current path
-              ls [PATH]         List packages
-              tree [PATH]       Show package tree
-              up                Go to parent package
-              root              Go to ModelRoot
-              back              Go to previous location
-
-            #{OutputFormatter.colorize('Query:', :yellow)}
-              find CLASS        Find class (fuzzy search)
-              show class QNAME  Show class details
-              show package PATH Show package details
-              show NUMBER       Show numbered result
-              search QUERY      Full-text search
-              ? QUERY           Alias for search
-
-            #{OutputFormatter.colorize('Bookmarks:', :yellow)}
-              bookmark add NAME  Bookmark current location
-              bookmark list      List bookmarks
-              bookmark go NAME   Jump to bookmark
-              bookmark rm NAME   Remove bookmark
-              bm NAME            Quick jump
-
-            #{OutputFormatter.colorize('Utilities:', :yellow)}
-              help [COMMAND]    Show help
-              history           Show command history
-              clear             Clear screen
-              config            Show configuration
-              stats             Show statistics
-              exit, quit, q     Exit shell
-          HELP
+          puts OutputFormatter.colorize(HELP_TEXT, :cyan)
         end
 
         def display_command_help(command)