lutaml-store 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea027eecd3b29d9e1369455e835feb794173b4326a81034f67bb06b89e6adb3b
-  data.tar.gz: 74a1b77d3e644bfb92a397a0a1e51b0eb0d7a3af545543c6419c3d6a1677bd65
+  metadata.gz: 9a51b678ada3133e9dec69b021b81f2f306f96839da6f6d3c6095542b4f1c518
+  data.tar.gz: 8157f4106efe708cc4b868ffa174004729e3e22a8a94ec519add41407d0c11a6
 SHA512:
-  metadata.gz: 3fef83d3704ef385c9f536ff73ec2681b962d56a46b1211aa7e3042119c5b0a6a2bc70a52c97edd5e791060d526981ff75beaff7d0f2cd1c40e40ea54b3dc713
-  data.tar.gz: bfe7057e1323a7396bcc71e829f26f2c44725fadee07156553a6721b29e9a31ab478b9c47d92f79deb6cd38f96f90477d2a505baa0f85b7b56f837e4be10055e
+  metadata.gz: 639dcd3e75e7ec3c40128cf28c036aff3e003ab9db3460266260587c386aea5495bbe244376caef15b5555f541ff3715ce738b2ec93e501d622fafa290016881
+  data.tar.gz: 6942bb83e1ab2edb1c0a10afcdd7014baceb3c02319fc82714d54234e0a012105a3046adb76c09f12d9e861b9ea53b108bcfdb874836db81e8a08461d0237083

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-06-01 15:50:24 UTC using RuboCop version 1.86.2.
+# on 2026-06-03 01:47:04 UTC using RuboCop version 1.86.2.
 # 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,68 +11,40 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'lutaml-store.gemspec'
 
-# Offense count: 14
+# Offense count: 15
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, IndentationWidth.
 # SupportedStyles: with_first_argument, with_fixed_indentation
 Layout/ArgumentAlignment:
   Exclude:
-    - 'lib/lutaml/store/compression.rb'
-    - 'spec/lutaml/store/anti_pattern_spec.rb'
-    - 'spec/lutaml/store/lutaml_model_integration_spec.rb'
-    - 'spec/lutaml/store/model_serializer_spec.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLineAfterGuardClause:
-  Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
     - 'lib/lutaml/store/attribute_updater.rb'
+    - 'lib/lutaml/store/http_cache.rb'
+    - 'lib/lutaml/store/model_registry.rb'
+    - 'spec/lutaml/store/package_store_spec.rb'
+    - 'spec/lutaml/store/package_transport/directory_transport_spec.rb'
+    - 'spec/lutaml/store/package_transport/zip_transport_spec.rb'
 
-# Offense count: 7
+# Offense count: 8
 # This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLineAfterMagicComment:
+Layout/EmptyLineAfterGuardClause:
   Exclude:
-    - 'demo/pottery_class_demo.rb'
-    - 'lib/lutaml/store/http_cache_config.rb'
-    - 'lib/lutaml/store/http_cache_entry.rb'
-    - 'lib/lutaml/store/http_header_processor.rb'
-    - 'spec/lutaml/store/http_cache_entry_spec.rb'
-    - 'spec/lutaml/store/http_cache_spec.rb'
-    - 'spec/lutaml/store/http_header_processor_spec.rb'
+    - 'lib/lutaml/store/package_transport.rb'
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EmptyLineBetweenMethodDefs, EmptyLineBetweenClassDefs, EmptyLineBetweenModuleDefs, DefLikeMacros, AllowAdjacentOneLineDefs, NumberOfEmptyLines.
-Layout/EmptyLineBetweenDefs:
-  Exclude:
-    - 'lib/lutaml/store/compression.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
 Layout/EmptyLines:
   Exclude:
-    - 'lib/lutaml/store/adapter/memory.rb'
-    - 'lib/lutaml/store/cache.rb'
-    - 'lib/lutaml/store/compression.rb'
-    - 'lib/lutaml/store/monitor.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: empty_lines, no_empty_lines
-Layout/EmptyLinesAroundBlockBody:
-  Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
+    - 'lib/lutaml/store/package_store.rb'
 
-# Offense count: 13
+# Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLinesAroundMethodBody:
+# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
+Layout/ExtraSpacing:
   Exclude:
-    - 'lib/lutaml/store/attribute_updater.rb'
-    - 'lib/lutaml/store/compression.rb'
+    - 'lib/lutaml/store/package_store.rb'
+    - 'lib/lutaml/store/package_transport.rb'
 
-# Offense count: 9
+# Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
 # SupportedHashRocketStyles: key, separator, table
@@ -80,125 +52,73 @@ Layout/EmptyLinesAroundMethodBody:
 # SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
 Layout/HashAlignment:
   Exclude:
-    - 'spec/lutaml/store/lutaml_model_integration_spec.rb'
-    - 'spec/lutaml/store/model_serializer_spec.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: normal, indented_internal_methods
-Layout/IndentationConsistency:
-  Exclude:
-    - 'lib/lutaml/store/attribute_updater.rb'
-    - 'lib/lutaml/store/integrity.rb'
+    - 'spec/lutaml/store/package_transport/directory_transport_spec.rb'
+    - 'spec/lutaml/store/package_transport/zip_transport_spec.rb'
 
-# Offense count: 9
+# Offense count: 13
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
-# SupportedStylesAlignWith: start_of_line, relative_to_receiver
-Layout/IndentationWidth:
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: aligned, indented, indented_relative_to_receiver
+Layout/MultilineMethodCallIndentation:
   Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
-    - 'lib/lutaml/store/compression.rb'
-    - 'lib/lutaml/store/integrity.rb'
+    - 'lib/lutaml/store/package_store.rb'
+    - 'lib/lutaml/store/package_transport.rb'
 
-# Offense count: 7
+# Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
-Layout/RescueEnsureAlignment:
+# Configuration parameters: EnforcedStyleInsidePipes.
+# SupportedStylesInsidePipes: space, no_space
+Layout/SpaceAroundBlockParameters:
   Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
-    - 'lib/lutaml/store/compression.rb'
+    - 'lib/lutaml/store/package_store.rb'
+    - 'lib/lutaml/store/package_transport.rb'
 
-# Offense count: 22
+# Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowInHeredoc.
 Layout/TrailingWhitespace:
   Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
     - 'lib/lutaml/store/attribute_updater.rb'
-    - 'lib/lutaml/store/compression.rb'
-    - 'spec/lutaml/store/lutaml_model_integration_spec.rb'
-    - 'spec/lutaml/store/model_serializer_spec.rb'
-
-# Offense count: 2
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: AllowSafeAssignment.
-Lint/AssignmentInCondition:
-  Exclude:
-    - 'lib/lutaml/store/http_header_processor.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-Lint/RedundantRequireStatement:
-  Exclude:
-    - 'lib/lutaml/store/adapter/memory.rb'
-    - 'lib/lutaml/store/cache.rb'
-    - 'lib/lutaml/store/monitor.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: IgnoreEmptyBlocks, AllowUnusedKeywordArguments.
-Lint/UnusedBlockArgument:
-  Exclude:
-    - 'lib/lutaml/store/adapter/sqlite.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
-# NotImplementedExceptions: NotImplementedError
-Lint/UnusedMethodArgument:
-  Exclude:
     - 'lib/lutaml/store/http_cache.rb'
-    - 'lib/lutaml/store/monitor.rb'
+    - 'lib/lutaml/store/model_registry.rb'
 
 # Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: ContextCreatingMethods, MethodCreatingMethods.
-Lint/UselessAccessModifier:
+Lint/IneffectiveAccessModifier:
   Exclude:
-    - 'lib/lutaml/store/compression.rb'
+    - 'lib/lutaml/store/package_store.rb'
 
-# Offense count: 7
-# This cop supports safe autocorrection (--autocorrect).
-Lint/UselessAssignment:
-  Exclude:
-    - 'lib/lutaml/store/http_cache.rb'
-    - 'spec/lutaml/store/cache_store_spec.rb'
-    - 'spec/lutaml/store/http_cache_hal_integration_spec.rb'
-    - 'spec/lutaml/store/http_cache_spec.rb'
-
-# Offense count: 23
+# Offense count: 30
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
   Max: 112
 
-# Offense count: 51
+# Offense count: 56
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 320
+  Max: 315
 
-# Offense count: 14
+# Offense count: 17
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
   Max: 379
 
-# Offense count: 7
+# Offense count: 10
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
-  Max: 10
+  Max: 11
 
-# Offense count: 72
+# Offense count: 82
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 84
 
-# Offense count: 3
+# Offense count: 4
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 8
 
-# Offense count: 4
+# Offense count: 6
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
   Max: 11
@@ -208,13 +128,14 @@ Naming/AccessorMethodName:
   Exclude:
     - 'lib/lutaml/store/adapter/sqlite.rb'
 
-# Offense count: 3
+# Offense count: 12
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
   Exclude:
     - 'demo/vcard_models.rb'
     - 'demo/vcard_store_demo.rb'
+    - 'lib/lutaml/store/package_transport.rb'
 
 # Offense count: 1
 # Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
@@ -240,7 +161,15 @@ Security/MarshalLoad:
   Exclude:
     - 'lib/lutaml/store/format/marshal_format.rb'
 
-# Offense count: 14
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: separated, grouped
+Style/AccessorGrouping:
+  Exclude:
+    - 'lib/lutaml/store/package_store.rb'
+
+# Offense count: 2
 # 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
@@ -249,95 +178,36 @@ Security/MarshalLoad:
 # AllowedMethods: lambda, proc, it
 Style/BlockDelimiters:
   Exclude:
-    - 'spec/lutaml/store/compression_spec.rb'
-    - 'spec/lutaml/store/file_io_spec.rb'
-    - 'spec/lutaml/store/integrity_spec.rb'
-    - 'spec/lutaml/store/model_serializer_spec.rb'
+    - 'spec/lutaml/store/package_definition_spec.rb'
+    - 'spec/lutaml/store/package_transport/directory_transport_spec.rb'
 
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Keywords, RequireColon.
-# Keywords: TODO, FIXME, OPTIMIZE, HACK, REVIEW, NOTE
-Style/CommentAnnotation:
-  Exclude:
-    - 'spec/lutaml/store/compression_spec.rb'
-    - 'spec/lutaml/store/config_enhanced_spec.rb'
-    - 'spec/lutaml/store/store_spec.rb'
-
-# Offense count: 29
+# Offense count: 34
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Enabled: false
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: compact, expanded
-Style/EmptyMethod:
-  Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
-
-# Offense count: 7
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: always, always_true, never
-Style/FrozenStringLiteralComment:
-  Exclude:
-    - '**/*.arb'
-    - 'demo/pottery_class_demo.rb'
-    - 'lib/lutaml/store/http_cache_config.rb'
-    - 'lib/lutaml/store/http_cache_entry.rb'
-    - 'lib/lutaml/store/http_header_processor.rb'
-    - 'spec/lutaml/store/http_cache_entry_spec.rb'
-    - 'spec/lutaml/store/http_cache_spec.rb'
-    - 'spec/lutaml/store/http_header_processor_spec.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: MinBodyLength, AllowConsecutiveConditionals.
-Style/GuardClause:
-  Exclude:
-    - 'lib/lutaml/store/attribute_updater.rb'
-
-# Offense count: 6
+# Offense count: 2
 # This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: AllowedReceivers.
 # AllowedReceivers: Thread.current
 Style/HashEachMethods:
   Exclude:
-    - 'demo/vcard_store_demo.rb'
     - 'lib/lutaml/store/cache_store.rb'
     - 'lib/lutaml/store/database_store.rb'
-    - 'lib/lutaml/store/http_cache.rb'
 
-# Offense count: 9
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-Style/IfUnlessModifier:
-  Exclude:
-    - 'lib/lutaml/store/attribute_updater.rb'
-    - 'lib/lutaml/store/cache.rb'
-    - 'lib/lutaml/store/http_cache.rb'
-    - 'lib/lutaml/store/integrity.rb'
-    - 'lib/lutaml/store/model_registry.rb'
-    - 'lib/lutaml/store/monitor.rb'
-
-# Offense count: 3
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
-# SupportedStyles: predicate, comparison
-Style/NumericPredicate:
+Style/KeywordParametersOrder:
   Exclude:
-    - 'spec/**/*'
-    - 'demo/vcard_store_demo.rb'
-    - 'lib/lutaml/store/adapter/memory.rb'
-    - 'lib/lutaml/store/http_cache.rb'
+    - 'lib/lutaml/store/package_definition.rb'
 
-# Offense count: 7
+# Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
-Style/RedundantBegin:
+Style/MultilineIfModifier:
   Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
-    - 'lib/lutaml/store/compression.rb'
+    - 'lib/lutaml/store/attribute_updater.rb'
+    - 'lib/lutaml/store/http_cache.rb'
+    - 'lib/lutaml/store/model_registry.rb'
 
 # Offense count: 2
 # This cop supports unsafe autocorrection (--autocorrect-all).
@@ -348,103 +218,37 @@ Style/RedundantFetchBlock:
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, AllowInnerSlashes.
-# SupportedStyles: slashes, percent_r, mixed
-Style/RegexpLiteral:
-  Exclude:
-    - 'lib/lutaml/store/adapter/filesystem.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/RescueModifier:
-  Exclude:
-    - 'demo/vcard_models.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: implicit, explicit
-Style/RescueStandardError:
+Style/RedundantRegexpEscape:
   Exclude:
-    - 'demo/vcard_models.rb'
-    - 'lib/lutaml/store/adapter/filesystem.rb'
-    - 'lib/lutaml/store/integrity.rb'
-
-# Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: RequireEnglish, EnforcedStyle.
-# SupportedStyles: use_perl_names, use_english_names, use_builtin_english_names
-Style/SpecialGlobalVars:
-  Exclude:
-    - 'demo/vcard_store_demo.rb'
-
-# Offense count: 4
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: Mode.
-Style/StringConcatenation:
-  Exclude:
-    - 'demo/vcard_store_demo.rb'
-    - 'lib/lutaml/store/format/jsonl.rb'
+    - 'lib/lutaml/store/package_transport.rb'
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiterals:
-  Exclude:
-    - 'lib/lutaml/store/compression.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiteralsInInterpolation:
-  Exclude:
-    - 'lib/lutaml/store/compression.rb'
-
-# Offense count: 9
-# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyleForMultiline.
 # SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInArguments:
+Style/TrailingCommaInArrayLiteral:
   Exclude:
-    - 'spec/lutaml/store/file_io_spec.rb'
-    - 'spec/lutaml/store/import_spec.rb'
-    - 'spec/lutaml/store/key_collision_serializer_spec.rb'
-    - 'spec/lutaml/store/load_save_spec.rb'
+    - 'spec/lutaml/store/format/yamls_spec.rb'
 
-# Offense count: 8
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyleForMultiline.
 # SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInArrayLiteral:
+Style/TrailingCommaInHashLiteral:
   Exclude:
-    - 'spec/lutaml/store/file_io_spec.rb'
-    - 'spec/lutaml/store/format_round_trip_spec.rb'
-    - 'spec/lutaml/store/import_spec.rb'
-    - 'spec/lutaml/store/load_save_spec.rb'
-    - 'spec/lutaml/store/lutaml_model_integration_spec.rb'
+    - 'lib/lutaml/store/package_store.rb'
 
 # Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleForMultiline.
-# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
-Style/TrailingCommaInHashLiteral:
+# Configuration parameters: ExactNameMatch, AllowPredicates, AllowDSLWriters, IgnoreClassMethods, AllowedMethods.
+# AllowedMethods: to_ary, to_a, to_c, to_enum, to_h, to_hash, to_i, to_int, to_io, to_open, to_path, to_proc, to_r, to_regexp, to_str, to_s, to_sym
+Style/TrivialAccessors:
   Exclude:
-    - 'lib/lutaml/store/format.rb'
-    - 'spec/lutaml/store/key_collision_serializer_spec.rb'
+    - 'lib/lutaml/store/package_store.rb'
 
 # Offense count: 5
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: WordRegex.
-# SupportedStyles: percent, brackets
-Style/WordArray:
-  EnforcedStyle: percent
-  MinSize: 4
-
-# Offense count: 7
-# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
-  Max: 161
+  Max: 148

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    lutaml-store (0.1.1)
+    lutaml-store (0.2.0)
       lutaml-model (~> 0.8.15)
+      rubyzip (~> 2.3)
 
 GEM
   remote: https://rubygems.org/
@@ -27,6 +28,7 @@ GEM
     erb (6.0.4)
     ffi (1.17.4)
     ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
     io-console (0.8.2)
     irb (1.18.0)
       pp (>= 0.6.0)
@@ -57,6 +59,8 @@ GEM
       racc (~> 1.4)
     nokogiri (1.19.3-arm64-darwin)
       racc (~> 1.4)
+    nokogiri (1.19.3-x86_64-linux-gnu)
+      racc (~> 1.4)
     ostruct (0.6.3)
     paint (2.3.0)
     parallel (2.1.0)
@@ -140,6 +144,7 @@ GEM
 
 PLATFORMS
   arm64-darwin-23
+  x86_64-linux
 
 DEPENDENCIES
   irb
@@ -166,19 +171,21 @@ CHECKSUMS
   erb (6.0.4) sha256=38e3803694be357fe2bfe312487c74beaf9fb4e5beb3e22498952fe1645b95d9
   ffi (1.17.4) sha256=bcd1642e06f0d16fc9e09ac6d49c3a7298b9789bcb58127302f934e437d60acf
   ffi (1.17.4-arm64-darwin) sha256=19071aaf1419251b0a46852abf960e77330a3b334d13a4ab51d58b31a937001b
+  ffi (1.17.4-x86_64-linux-gnu) sha256=9d3db14c2eae074b382fa9c083fe95aec6e0a1451da249eab096c34002bc752d
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
   irb (1.18.0) sha256=de9454a0703a54704b9811a5ef31a60c86949fbf4013fcf244fabc7c775248e3
   json (2.19.5) sha256=218a18553e4801d579ca7e0f5bc72bafd776d7397238a1fb4e74db5b0a812c59
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
   liquid (5.12.0) sha256=5a3c2c2430cd925d21c53e4ed9abea52cd0a9da53b541422f81dee79aca2a673
-  lutaml-model (0.8.15)
-  lutaml-store (0.1.1)
+  lutaml-model (0.8.15) sha256=8ee4181197c0dbfef4bcc0d4c63f783c33b8187f6fddeedf68bb0cd854959ca6
+  lutaml-store (0.2.0)
   memo_wise (1.13.0) sha256=30220c38c4cef410849bc73553c58664dc2c91c6379e4a1df22aea02358b716b
   mini_portile2 (2.8.9) sha256=0cd7c7f824e010c072e33f68bc02d85a00aeb6fce05bb4819c03dfd3c140c289
-  moxml (0.1.23)
+  moxml (0.1.23) sha256=d78a4f9c075973603d9b941908f2cac16a1f74de6f6d8247d7b44ecbe3322b3a
   nokogiri (1.19.3) sha256=78312cbac32a40c812780d9678221b79d51288eec00054c1a8d15f7ce05960e8
   nokogiri (1.19.3-arm64-darwin) sha256=71b9bd424b1b7abc18b05052a1a3cfd3627abdca62be280854cc411791357e42
+  nokogiri (1.19.3-x86_64-linux-gnu) sha256=2f5078620fe12e83669b5b17311b32532a8153d02eee7ad06948b926d6080976
   ostruct (0.6.3) sha256=95a2ed4a4bd1d190784e666b47b2d3f078e4a9efda2fccf18f84ddc6538ed912
   paint (2.3.0) sha256=327d623e4038619d5bd99ae5db07973859cd78400c7f0329eea283cef8e83be5
   parallel (2.1.0) sha256=b35258865c2e31134c5ecb708beaaf6772adf9d5efae28e93e99260877b09356

data/TODO.impl/1-lutaml-hal-migration.md

@@ -40,21 +40,57 @@ have been eliminated from `lib/lutaml/hal/`.
 - **lutaml-store**: 248 examples, 1 pre-existing failure (vary header spec) + 25 pre-existing failures in HTTP cache integration specs
 - **Anti-patterns in lib code**: 0 `instance_variable_set/get`, 0 `send`, 0 `respond_to?`
 
-## Remaining (future work)
-
-### Phase 1: Unify caching through lutaml-store
-
-Create `HalStore` as a thin wrapper around `Lutaml::Store` for HAL-specific
-caching. Remove `SimpleCacheStore` (replaced by lutaml-store memory adapter).
-Remove `Client`'s `@cache` Hash. Simplify `CacheManager`.
-
-### Phase 2: Register ID tracking as proper attribute
-
-Replace `_global_register_id` instance variable with a proper
-`Lutaml::Model::Serializable` attribute on `Resource`. Make embedded data a
-proper attribute. Eliminates `Hal::REGISTER_ID_ATTR_NAME` constant.
-
-### Phase 3: Store HAL resources as registered models
-
-Register HAL resource classes with lutaml-store's model registry for direct
-CRUD operations instead of wrapping them in `CacheEntry`.
+## Implemented in lutaml-hal#15
+
+The realized-object cache (relaton/w3c_api#11) is working and opt-in
+(`ModelRegister.new(..., cache: {...})`; no config keeps the previous
+behavior). Delivered across four commits on `rt-add-lutaml-store`:
+
+### Phase 1: Make caching work / unify through lutaml-store — done (adapted)
+
+- The cache path was crashing; fixed: require `lutaml/store` (so its autoloads
+  resolve), route `Link#realize` through the public `cache_manager` API, add
+  `Client#get_by_url_with_headers`, remove `Client`'s legacy `@cache` Hash,
+  make HTTP-aware caching explicit opt-in.
+- **Deviation:** instead of a `HalStore` wrapper, `CacheManager` uses
+  lutaml-store's `CacheStore` directly for persistent adapters and keeps
+  `SimpleCacheStore` for the in-memory adapter (so cache hits avoid
+  serialization). `SimpleCacheStore` was therefore retained, not removed.
+
+### Phase 2: Register ID / embedded data as proper attributes — done
+
+- Dropped the `Hal::REGISTER_ID_ATTR_NAME` constant and all dynamic
+  `instance_variable_get/set("@#{...}")`; `Resource`/`Link`/`LinkSet` use
+  `attr_accessor :_global_register_id`, embedded data is an `attr_accessor`.
+- Also removed the remaining `register.send(:private_method)` calls from
+  `Link` by making `ModelRegister#find_matching_model_class` public.
+
+### Phase 3: Persistence + URL keying — done (alternative to model-registry)
+
+- **URL keying:** `CacheManager` canonicalizes relative URLs to absolute before
+  keying, so a resource fetched by endpoint path and the same resource realized
+  from an absolute link href share one entry (the core repeated-realize fix).
+- **Persistence — decision:** rather than registering HAL resource classes in
+  lutaml-store's model registry, `CacheEntry` gained a JSON storage form
+  (records the model class + lutaml-model JSON). With a `filesystem`/`sqlite`
+  adapter the cache persists via `Lutaml::Store::CacheStore` and rebuilds models
+  on retrieval. This keeps the cache shape (`URL => entry`) and was chosen over
+  the model-registry approach, whose `fetch(model:, key:)` API fits poorly with
+  a heterogeneous URL→object lookup. Note: persisted entries require **named**
+  resource classes with explicit `key_value` mappings.
+
+## Still remaining
+
+### HTTP-aware response cache (deferred)
+
+Backing the HTTP-aware mode with lutaml-store's `HttpCache` (ETag / 304
+revalidation against a cached response) is left as scaffolding
+(`create_http_cache` / `*_http_cache` in `CacheManager`). It needs a realized
+model to be reconstructed from a cached response (i.e. knowing the resource
+class at read time) and is not required for the realized-object caching in #11.
+
+### Release coordination
+
+lutaml-hal#15 depends on lutaml-store via a `path:` Gemfile entry. lutaml-store
+needs a tagged release before lutaml-hal can depend on a published version and
+the PR can ship.