lutaml-store 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ea027eecd3b29d9e1369455e835feb794173b4326a81034f67bb06b89e6adb3b
+  data.tar.gz: 74a1b77d3e644bfb92a397a0a1e51b0eb0d7a3af545543c6419c3d6a1677bd65
+SHA512:
+  metadata.gz: 3fef83d3704ef385c9f536ff73ec2681b962d56a46b1211aa7e3042119c5b0a6a2bc70a52c97edd5e791060d526981ff75beaff7d0f2cd1c40e40ea54b3dc713
+  data.tar.gz: bfe7057e1323a7396bcc71e829f26f2c44725fadee07156553a6721b29e9a31ab478b9c47d92f79deb6cd38f96f90477d2a505baa0f85b7b56f837e4be10055e

data/.github/workflows/main.yml

@@ -0,0 +1,27 @@
+name: Ruby
+
+on:
+  push:
+    branches:
+      - main
+
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    name: Ruby ${{ matrix.ruby }}
+    strategy:
+      matrix:
+        ruby:
+          - '3.3.2'
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run the default task
+        run: bundle exec rake

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+*.gem

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,10 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/.rubocop_todo.yml

@@ -0,0 +1,450 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-06-01 15:50:24 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
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'lutaml-store.gemspec'
+
+# Offense count: 14
+# 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'
+
+# Offense count: 7
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLineAfterMagicComment:
+  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'
+
+# 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'
+
+# Offense count: 13
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLinesAroundMethodBody:
+  Exclude:
+    - 'lib/lutaml/store/attribute_updater.rb'
+    - 'lib/lutaml/store/compression.rb'
+
+# Offense count: 9
+# 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:
+    - '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'
+
+# Offense count: 9
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
+# SupportedStylesAlignWith: start_of_line, relative_to_receiver
+Layout/IndentationWidth:
+  Exclude:
+    - 'lib/lutaml/store/adapter/filesystem.rb'
+    - 'lib/lutaml/store/compression.rb'
+    - 'lib/lutaml/store/integrity.rb'
+
+# Offense count: 7
+# This cop supports safe autocorrection (--autocorrect).
+Layout/RescueEnsureAlignment:
+  Exclude:
+    - 'lib/lutaml/store/adapter/filesystem.rb'
+    - 'lib/lutaml/store/compression.rb'
+
+# Offense count: 22
+# 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'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: ContextCreatingMethods, MethodCreatingMethods.
+Lint/UselessAccessModifier:
+  Exclude:
+    - 'lib/lutaml/store/compression.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
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 112
+
+# Offense count: 51
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 320
+
+# Offense count: 14
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 379
+
+# Offense count: 7
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+# Offense count: 72
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 84
+
+# Offense count: 3
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 8
+
+# Offense count: 4
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 11
+
+# Offense count: 1
+Naming/AccessorMethodName:
+  Exclude:
+    - 'lib/lutaml/store/adapter/sqlite.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:
+  Exclude:
+    - 'demo/vcard_models.rb'
+    - 'demo/vcard_store_demo.rb'
+
+# Offense count: 1
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicatePrefix:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/lutaml/store/http_header_processor.rb'
+
+# Offense count: 2
+# Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
+# SupportedStyles: snake_case, normalcase, non_integer
+# AllowedIdentifiers: TLS1_1, TLS1_2, capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
+Naming/VariableNumber:
+  Exclude:
+    - 'spec/lutaml/store/compression_spec.rb'
+
+# Offense count: 2
+Security/MarshalLoad:
+  Exclude:
+    - 'lib/lutaml/store/format/marshal_format.rb'
+
+# Offense count: 14
+# 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:
+    - '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'
+
+# 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
+# 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
+# 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
+# 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:
+  Exclude:
+    - 'spec/**/*'
+    - 'demo/vcard_store_demo.rb'
+    - 'lib/lutaml/store/adapter/memory.rb'
+    - 'lib/lutaml/store/http_cache.rb'
+
+# Offense count: 7
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantBegin:
+  Exclude:
+    - 'lib/lutaml/store/adapter/filesystem.rb'
+    - 'lib/lutaml/store/compression.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: SafeForConstants.
+Style/RedundantFetchBlock:
+  Exclude:
+    - 'spec/lutaml/store/cache_store_spec.rb'
+
+# 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:
+  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'
+
+# 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:
+  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'
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArrayLiteral:
+  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'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInHashLiteral:
+  Exclude:
+    - 'lib/lutaml/store/format.rb'
+    - 'spec/lutaml/store/key_collision_serializer_spec.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

data/CLAUDE.md

@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build & test commands
+
+```sh
+bin/setup             # Install dependencies
+bundle exec rake      # Run specs + rubocop (default task)
+bundle exec rspec     # Run all specs
+bundle exec rspec spec/lutaml/store/basic_store_spec.rb  # Run a single spec file
+bundle exec rubocop   # Lint
+```
+
+Ruby >= 3.1 required. CI uses Ruby 3.3.2.
+
+## Architecture
+
+This is a Ruby gem (`lutaml-store`) providing a store-centric database-style API for persisting LutaML Models across multiple storage backends.
+
+### Two-layer store design
+
+- **`Lutaml::Store.new(adapter:, models:)`** — the primary entry point. Returns a `DatabaseStore` instance with model registry support, CRUD operations (`save`, `fetch`, `update`, `destroy`), polymorphic model handling, composite model relationships, and dot-notation nested updates.
+
+- **`Lutaml::Store::BasicStore`** — the low-level key-value store providing `get`, `set`, `delete`, `exists?`, `all`, `keys`, and bulk operations. Wraps an adapter with optional caching, monitoring, and event emission.
+
+### Key classes in `lib/lutaml/store/`
+
+| Class | Role |
+|---|---|
+| `DatabaseStore` | High-level CRUD with model registry, composite models, polymorphism |
+| `BasicStore` | Low-level key-value store with optional cache/monitor/events |
+| `CacheStore` | TTL-aware cache store extending `BasicStore` |
+| `ModelRegistry` / `ModelRegistration` | Register models with their key fields and polymorphic config |
+| `CompositeModelHandler` | Stores nested registered models independently, restores references |
+| `AttributeUpdater` | Processes updates including dot-notation paths and block-based updates |
+| `ModelSerializer` | Single point of serialization/deserialization for Lutaml::Model objects |
+| `Config` | Parses and validates store configuration (adapter, cache, monitoring, compression) |
+
+### Storage adapters (`lib/lutaml/store/adapter/`)
+
+All inherit from `Adapter::Base`. Three backends: `Memory`, `FileSystem`, `SQLite`. The `DatabaseStore` creates the adapter internally via `BasicStore`; the adapter type is passed as `adapter: :memory`, `adapter: { type: :filesystem, path: "..." }`, etc.
+
+### HTTP caching
+
+`HttpCache` provides HTTP-aware caching with ETags, conditional requests (304), Cache-Control, and Vary header support. Used by lutaml-hal to avoid re-fetching HAL resources.
+
+### Serialization & integrity
+
+`Compression` adds gzip support. `Integrity` provides SHA256 checksums for data verification (used by the FileSystem adapter).
+
+## Conventions
+
+- Double-quoted strings (Rubocop enforced)
+- Specs use `expect` syntax (no `should`)
+- Documentation is in AsciiDoc (README.adoc, plan.adoc)
+- Error hierarchy: `Lutaml::Store::Error` → `ConfigurationError`, `BackendError`, `ModelNotRegisteredError`, `InvalidKeyError`, `PolymorphicUpdateError`, `CompositeModelError`