metaschema 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab01e7082a78f755a4aab0f12f4e6d0a57fda8c2c61c8820b44d084bd35e700e
-  data.tar.gz: dde048935f730d08385f69cf32c3b56fd3e370786a716b3a643dfe68207a5c04
+  metadata.gz: 13c76286aac4a084b992310573e600bff798224156cbbfb1ec5a27b80fdf9ec8
+  data.tar.gz: 509b4a6032bec02787b65783e7ff253133b16ffebc1398bc9470f96a53403258
 SHA512:
-  metadata.gz: 34ca02dd41aa6febd4d4dd6b167633040477381366fbd2dec9c503adcd83a7588dfcc9bdfc808ac7321940292c0c5cd35dbce22b7765a6999065eb8e2be14c3e
-  data.tar.gz: d7c2da1a6bd83bbacc9d301c548a124972c1280dc1f4b3429412368dc4ed0ebfa5b871e7aa18f5abc719440bb5cbcd1282c64fcd26a0e8a924ad2eb783b8fe5b
+  metadata.gz: 6920a39f399434cbb2634f0395ae346af06bd80d95bebfba2cceba3ff08f4421cf483bc5b3078672d596b2df5b05c0d3a33afe595859e8df22052fc08b327c53
+  data.tar.gz: deaba8e56599fdab8902215b520eb7ba057b2fb82aab57126c5acea59a39b3916286dbd54d6563e4f7da7764b3a39a60c21b4f2f1d913b43d893980bf9acedb1

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-04-21 23:09:15 UTC using RuboCop version 1.86.1.
+# on 2026-04-24 02:52:57 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
@@ -11,156 +11,15 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'metaschema.gemspec'
 
-# Offense count: 21
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_argument, with_fixed_indentation
-Layout/ArgumentAlignment:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-    - 'spec/model_generator_spec.rb'
-    - 'spec/ruby_source_emitter_spec.rb'
-
-# Offense count: 10
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_element, with_fixed_indentation
-Layout/ArrayAlignment:
-  Exclude:
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 6
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: IndentationWidth.
-Layout/AssignmentIndentation:
-  Exclude:
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 74
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyleAlignWith.
 # SupportedStylesAlignWith: either, start_of_block, start_of_line
 Layout/BlockAlignment:
   Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/assembly_factory.rb'
 
-# Offense count: 71
-# This cop supports safe autocorrection (--autocorrect).
-Layout/BlockEndNewline:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 7
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowForAlignment.
-Layout/CommentIndentation:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 10
-# This cop supports safe autocorrection (--autocorrect).
-Layout/ElseAlignment:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 40
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLineAfterGuardClause:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EmptyLineBetweenMethodDefs, EmptyLineBetweenClassDefs, EmptyLineBetweenModuleDefs, DefLikeMacros, AllowAdjacentOneLineDefs, NumberOfEmptyLines.
-Layout/EmptyLineBetweenDefs:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLines:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLinesAroundMethodBody:
-  Exclude:
-    - 'lib/metaschema/metapath_evaluator.rb'
-
-# Offense count: 11
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: keyword, variable, start_of_line
-Layout/EndAlignment:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
-Layout/ExtraSpacing:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-
-# Offense count: 33
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
-# SupportedHashRocketStyles: key, separator, table
-# SupportedColonStyles: key, separator, table
-# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
-Layout/HashAlignment:
-  Exclude:
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'spec/model_generator_spec.rb'
-
-# Offense count: 33
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: normal, indented_internal_methods
-Layout/IndentationConsistency:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 174
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
-# SupportedStylesAlignWith: start_of_line, relative_to_receiver
-Layout/IndentationWidth:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 208
+# Offense count: 92
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
@@ -171,108 +30,35 @@ Layout/LineLength:
     - 'lib/metaschema/markdown_doc_generator.rb'
     - 'lib/metaschema/metapath_evaluator.rb'
     - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/assembly_factory.rb'
+    - 'lib/metaschema/model_generator/field_factory.rb'
+    - 'lib/metaschema/model_generator/services/field_deserializer.rb'
     - 'lib/metaschema/ruby_source_emitter.rb'
     - 'spec/metaschema_spec.rb'
     - 'spec/model_generator_spec.rb'
     - 'spec/ruby_source_emitter_spec.rb'
 
 # Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Layout/MultilineBlockLayout:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 5
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: aligned, indented, indented_relative_to_receiver
-Layout/MultilineMethodCallIndentation:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 7
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: aligned, indented
-Layout/MultilineOperationIndentation:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 57
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowInHeredoc.
-Layout/TrailingWhitespace:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-    - 'spec/ruby_source_emitter_spec.rb'
-
-# Offense count: 4
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
     - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/assembly_factory.rb'
 
 # Offense count: 1
 Lint/IneffectiveAccessModifier:
   Exclude:
     - 'lib/metaschema/constraint_validator.rb'
 
-# Offense count: 6
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: AllowedMethods, InferNonNilReceiver, AdditionalNilMethods.
-# AllowedMethods: instance_of?, kind_of?, is_a?, eql?, respond_to?, equal?
-# AdditionalNilMethods: present?, blank?, try, try!
-Lint/RedundantSafeNavigation:
-  Exclude:
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: IgnoreEmptyBlocks, AllowUnusedKeywordArguments.
-Lint/UnusedBlockArgument:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 10
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
 Lint/UnusedMethodArgument:
   Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
     - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: ContextCreatingMethods, MethodCreatingMethods.
-Lint/UselessAccessModifier:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-Lint/UselessAssignment:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
 
-# Offense count: 82
+# Offense count: 84
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
@@ -281,16 +67,19 @@ Metrics/AbcSize:
     - 'lib/metaschema/markdown_doc_generator.rb'
     - 'lib/metaschema/metapath_evaluator.rb'
     - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/assembly_factory.rb'
+    - 'lib/metaschema/model_generator/field_factory.rb'
+    - 'lib/metaschema/model_generator/services/field_serializer.rb'
     - 'lib/metaschema/ruby_source_emitter.rb'
     - 'lib/metaschema/type_mapper.rb'
 
-# Offense count: 15
+# Offense count: 11
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 52
+  Max: 46
 
-# Offense count: 86
+# Offense count: 87
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
@@ -299,19 +88,22 @@ Metrics/CyclomaticComplexity:
     - 'lib/metaschema/markdown_doc_generator.rb'
     - 'lib/metaschema/metapath_evaluator.rb'
     - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/assembly_factory.rb'
+    - 'lib/metaschema/model_generator/field_factory.rb'
+    - 'lib/metaschema/model_generator/services/field_deserializer.rb'
     - 'lib/metaschema/ruby_source_emitter.rb'
 
-# Offense count: 106
+# Offense count: 104
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 283
+  Max: 212
 
-# Offense count: 2
+# Offense count: 4
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 7
 
-# Offense count: 72
+# Offense count: 74
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
@@ -320,6 +112,9 @@ Metrics/PerceivedComplexity:
     - 'lib/metaschema/markdown_doc_generator.rb'
     - 'lib/metaschema/metapath_evaluator.rb'
     - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/assembly_factory.rb'
+    - 'lib/metaschema/model_generator/field_factory.rb'
+    - 'lib/metaschema/model_generator/services/field_deserializer.rb'
     - 'lib/metaschema/ruby_source_emitter.rb'
 
 # Offense count: 20
@@ -331,38 +126,22 @@ Naming/MethodParameterName:
     - 'lib/metaschema/markdown_doc_generator.rb'
     - 'lib/metaschema/metapath_evaluator.rb'
 
-# Offense count: 23
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Performance/MapCompact:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 8
-# This cop supports safe autocorrection (--autocorrect).
-Performance/StringIdentifierArgument:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Performance/StringInclude:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-
 # Offense count: 1
 RSpec/DescribeMethod:
   Exclude:
     - 'spec/model_generator_spec.rb'
 
-# Offense count: 8
+# Offense count: 15
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
-  Max: 10
+  Max: 20
+
+# Offense count: 1
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/services_spec.rb'
 
-# Offense count: 9
+# Offense count: 13
 RSpec/MultipleExpectations:
   Max: 2
 
@@ -379,190 +158,40 @@ RSpec/NoExpectationExample:
     - 'spec/metaschema_spec.rb'
 
 # Offense count: 2
-# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
-# SupportedInflectors: default, active_support
-RSpec/SpecFilePathFormat:
+RSpec/RepeatedDescription:
   Exclude:
-    - 'spec/model_generator_spec.rb'
-    - 'spec/ruby_source_emitter_spec.rb'
+    - 'spec/type_mapper_spec.rb'
 
-# Offense count: 137
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
-# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
-# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
-# FunctionalMethods: let, let!, subject, watch
-# AllowedMethods: lambda, proc, it
-Style/BlockDelimiters:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 3
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/CombinableLoops:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, SingleLineConditionsOnly, IncludeTernaryExpressions.
-# SupportedStyles: assign_to_condition, assign_inside_condition
-Style/ConditionalAssignment:
-  Exclude:
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, AllowComments.
-# SupportedStyles: empty, nil, both
-Style/EmptyElse:
-  Exclude:
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 3
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: AllowedReceivers.
-# AllowedReceivers: Thread.current
-Style/HashEachMethods:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/HashExcept:
-  Exclude:
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 16
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/IdenticalConditionalBranches:
+# Offense count: 2
+RSpec/RepeatedExample:
   Exclude:
-    - 'lib/metaschema/model_generator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
+    - 'spec/type_mapper_spec.rb'
 
 # Offense count: 3
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/MapIntoArray:
-  Exclude:
-    - 'lib/metaschema/markdown_doc_generator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/ModuleMemberExistenceCheck:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 18
-# This cop supports safe autocorrection (--autocorrect).
-Style/MultilineIfModifier:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-Style/MultilineTernaryOperator:
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
+RSpec/SpecFilePathFormat:
   Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/model_generator.rb'
+    - 'spec/model_generator_spec.rb'
+    - 'spec/ruby_source_emitter_spec.rb'
+    - 'spec/type_mapper_spec.rb'
 
 # Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowMethodComparison, ComparisonsThreshold.
-Style/MultipleComparison:
+Style/DocumentDynamicEvalDefinition:
   Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 6
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
-# SupportedStyles: predicate, comparison
-Style/NumericPredicate:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/markdown_doc_generator.rb'
-    - 'lib/metaschema/metapath_evaluator.rb'
-    - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/utils.rb'
 
 # Offense count: 1
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: respond_to_missing?
 Style/OptionalBooleanParameter:
   Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/RedundantAssignment:
-  Exclude:
-    - 'lib/metaschema/metapath_evaluator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowedMethods.
-# AllowedMethods: infinite?, nonzero?
-Style/RedundantCondition:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-Style/RedundantParentheses:
-  Exclude:
-    - 'lib/metaschema/json_schema_generator.rb'
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: implicit, explicit
-Style/RescueStandardError:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
+    - 'lib/metaschema/model_generator/field_factory.rb'
 
 # Offense count: 2
 # This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: ConvertCodeThatCanStartToReturnNil, AllowedMethods, MaxChainLength.
-# AllowedMethods: present?, blank?, presence, try, try!
-Style/SafeNavigation:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/SlicingWithRange:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowModifier.
-Style/SoleNestedConditional:
-  Exclude:
-    - 'lib/metaschema/model_generator.rb'
-
-# Offense count: 12
-# This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: Mode.
 Style/StringConcatenation:
   Exclude:
+    - 'lib/metaschema/model_generator/utils.rb'
     - 'lib/metaschema/ruby_source_emitter.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiterals:
-  Exclude:
-    - 'lib/metaschema/constraint_validator.rb'
-    - 'lib/metaschema/model_generator.rb'
-    - 'spec/ruby_source_emitter_spec.rb'

data/README.adoc

@@ -28,15 +28,16 @@ Metaschema-defined information models in the future.
 
 == Features
 
-TODO: This list is a TODO list. None of them have been completed.
-
 . Parse, build and round-trip Metaschema XML files
 . Validate Metaschema XML files against the Metaschema XML Schema
 . Generate XML (XSD) and JSON Schemas from Metaschema XML files
-. Generate Lutaml::Model (Ruby) classes that allow access and manipulation of
-  Metaschema-defined information models.
+. Generate `Lutaml::Model::Serializable` Ruby classes from Metaschema XML
+  definitions, with full XML and JSON round-trip fidelity
 . Validate Metaschema-defined information models against the Metaschema XML
   Schema
+. Support for SINGLETON_OR_ARRAY field patterns via service object pipeline
+  (FieldSerializer / FieldDeserializer)
+. UNWRAPPED XML field handling with delegate mappings
 
 == Installation
 
@@ -94,6 +95,55 @@ ms.assemblies
 # [Vendor, Computer, ...]
 ----
 
+== Model Generation
+
+The `Metaschema::ModelGenerator` generates Ruby classes from Metaschema XML
+definitions. It uses a factory-based architecture:
+
+[horizontal]
+`ModelGenerator`:: Orchestrator — handles imports, augments, and delegates to factories
+`FieldFactory`:: Creates field classes from Metaschema field definitions
+`AssemblyFactory`:: Creates assembly classes with XML and JSON mappings
+`FieldSerializer`:: Service object for normalizing field values to JSON
+`FieldDeserializer`:: Service object for denormalizing JSON values to field instances
+`CollapsiblesCollapser`:: Groups collapsible fields by shared flag values
+`Utils`:: Shared naming and utility helpers
+
+=== Generating Ruby source
+
+[source,ruby]
+----
+# Generate a single Ruby file with all classes
+source = Metaschema::ModelGenerator.to_ruby_source(
+  "oscal_complete_metaschema.xml",
+  module_name: "Oscal"
+)
+
+# Generate split files (one per class)
+files = Metaschema::ModelGenerator.to_ruby_source(
+  "oscal_complete_metaschema.xml",
+  module_name: "Oscal",
+  split: true
+)
+----
+
+=== Type System
+
+The `TypeMapper` maps Metaschema data types to Ruby/Lutaml::Model types:
+
+[horizontal]
+`string`, `token`, `uri`, etc.:: `:string`
+`integer`:: `:integer`
+`boolean`:: `:boolean`
+`date`, `date-time`:: `:date`, `:date_time`
+`markup-line`:: `Metaschema::MarkupLineDatatype`
+`markup-multiline`:: `Metaschema::MarkupMultilineDatatype`
+
+=== Dependencies
+
+* `lutaml-model ~> 0.8.0` — serialization framework
+* `moxml >= 0.1.15` — XML adapter (uses `namespace_validation_mode=` API)
+
 
 == Tests