glossarist 2.5.0 → 2.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a0f63a8b75f3e01fdceeaadbadac4359e59721396224ba34932f17b49f631b6
-  data.tar.gz: d674b921051ca918c0d08ae57953ae8f7c92c66e57d2ad55ad128a93f8bbcfa0
+  metadata.gz: 37d088868a3cacb2d02ec05fb6498cc3b053e8663e3e23e20f8b5ac0f5687dd2
+  data.tar.gz: bb1a08101aaaa0400332b9d4bb4c10383386a30e2b5624a612c5abbc1d23ca12
 SHA512:
-  metadata.gz: abf0fdfa59b35dd22c412e21ba4b84bde7e24aa7e36ddba608deef1d5ead0f6c5f1ae462be05a1c30cfa38ca824471b77ed9b89ef5bfdcacd692e9dc6122cd5b
-  data.tar.gz: 937ad7ae0b777b9b882f0806292c2b5578d0c91e1e4b1cc1127c40e4caa51ef662539570f235224e4ebcc61fa9a749bc7a272a88bbf29aece1ba28a4c404220b
+  metadata.gz: df4af9ceee95f45084e27d38d4430040f1f9620b7a71f6a669c1db508b6bb99a14440238289c81dc273d2de792fed42fb3615960b1f831c9bae0722245d5ef03
+  data.tar.gz: edf63cb34ed349a15870412f078bf576326cdb62614d730650779f782452fa24c6de682b156e0ad1a9b7fce5a9a76b6fd803c41a5f092af0e8c84a430c78d10f

data/.gitignore

@@ -21,3 +21,4 @@ localcache
 
 .vscode
 
+TODO*

data/.rubocop_todo.yml

@@ -1,125 +1,23 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-03-24 03:31:43 UTC using RuboCop version 1.86.0.
+# on 2026-05-04 09:39:17 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: 1
-# This cop supports safe autocorrection (--autocorrect).
-Gemspec/RequireMFA:
-  Exclude:
-    - 'glossarist.gemspec'
-
 # Offense count: 1
 Gemspec/RequiredRubyVersion:
   Exclude:
     - 'glossarist.gemspec'
 
-# Offense count: 13
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_argument, with_fixed_indentation
-Layout/ArgumentAlignment:
-  Exclude:
-    - 'lib/glossarist/concept.rb'
-    - 'lib/glossarist/concept_data.rb'
-    - 'lib/glossarist/concept_manager.rb'
-    - 'lib/glossarist/designation/grammar_info.rb'
-    - 'lib/glossarist/managed_concept.rb'
-    - 'spec/features/v2_serialization_spec.rb'
-    - 'spec/unit/locality_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: either, start_of_block, start_of_line
-Layout/BlockAlignment:
-  Exclude:
-    - 'spec/features/v2_serialization_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Layout/BlockEndNewline:
-  Exclude:
-    - 'spec/features/v2_serialization_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Layout/ClosingParenthesisIndentation:
-  Exclude:
-    - 'spec/features/multi_content_yaml_serialization_spec.rb'
-    - 'spec/features/v2_serialization_spec.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: consistent, consistent_relative_to_receiver, special_for_inner_method_call, special_for_inner_method_call_in_parentheses
-Layout/FirstArgumentIndentation:
-  Exclude:
-    - 'spec/features/multi_content_yaml_serialization_spec.rb'
-    - 'spec/features/v2_serialization_spec.rb'
-
-# Offense count: 10
-# 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:
-    - 'exe/glossarist'
-    - 'lib/glossarist/concept_data.rb'
-    - 'lib/glossarist/designation/grammar_info.rb'
-    - 'spec/unit/locality_spec.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: normal, indented_internal_methods
-Layout/IndentationConsistency:
-  Exclude:
-    - 'glossarist.gemspec'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
-# SupportedStylesAlignWith: start_of_line, relative_to_receiver
-Layout/IndentationWidth:
-  Exclude:
-    - 'spec/features/v2_serialization_spec.rb'
-
-# Offense count: 90
+# Offense count: 196
 # 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: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: symmetrical, new_line, same_line
-Layout/MultilineMethodCallBraceLayout:
-  Exclude:
-    - 'spec/features/multi_content_yaml_serialization_spec.rb'
-    - 'spec/features/v2_serialization_spec.rb'
-
-# Offense count: 20
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowInHeredoc.
-Layout/TrailingWhitespace:
-  Exclude:
-    - 'exe/glossarist'
-    - 'lib/glossarist/concept.rb'
-    - 'lib/glossarist/concept_data.rb'
-    - 'lib/glossarist/concept_manager.rb'
-    - 'lib/glossarist/designation/grammar_info.rb'
-    - 'lib/glossarist/managed_concept.rb'
-    - 'spec/features/v2_serialization_spec.rb'
-    - 'spec/unit/locality_spec.rb'
-
 # Offense count: 1
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -132,53 +30,72 @@ Lint/DuplicateMethods:
   Exclude:
     - 'lib/glossarist/managed_concept.rb'
 
-# Offense count: 3
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Lint/NonAtomicFileOperation:
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
   Exclude:
-    - 'lib/glossarist/concept_manager.rb'
+    - 'lib/glossarist/dataset_validator.rb'
 
-# Offense count: 4
+# Offense count: 18
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
+    - 'lib/glossarist/cli/package_command.rb'
+    - 'lib/glossarist/cli/validate_command.rb'
     - 'lib/glossarist/concept_manager.rb'
+    - 'lib/glossarist/gcr_metadata.rb'
+    - 'lib/glossarist/gcr_package.rb'
+    - 'lib/glossarist/reference_extractor.rb'
+    - 'lib/glossarist/reference_resolver.rb'
+    - 'lib/glossarist/resolution_adapter/local.rb'
+    - 'lib/glossarist/schema_migration.rb'
     - 'lib/glossarist/utilities/uuid.rb'
+    - 'spec/unit/concept_collector_spec.rb'
 
-# Offense count: 2
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 28
+
+# Offense count: 15
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
+    - 'lib/glossarist/concept_validator.rb'
     - 'lib/glossarist/designation/expression.rb'
+    - 'lib/glossarist/gcr_metadata.rb'
     - 'lib/glossarist/managed_concept.rb'
+    - 'lib/glossarist/reference_extractor.rb'
+    - 'lib/glossarist/reference_resolver.rb'
+    - 'lib/glossarist/resolution_adapter/local.rb'
+    - 'lib/glossarist/schema_migration.rb'
 
-# Offense count: 9
+# Offense count: 31
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 19
+  Max: 42
 
-# Offense count: 1
+# Offense count: 12
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
+    - 'lib/glossarist/concept_validator.rb'
     - 'lib/glossarist/designation/expression.rb'
+    - 'lib/glossarist/gcr_metadata.rb'
+    - 'lib/glossarist/reference_extractor.rb'
+    - 'lib/glossarist/reference_resolver.rb'
+    - 'lib/glossarist/resolution_adapter/local.rb'
+    - 'lib/glossarist/schema_migration.rb'
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Performance/StringIdentifierArgument:
-  Exclude:
-    - 'spec/unit/collection_spec.rb'
-
-# Offense count: 3
-# 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:
+# Offense count: 6
+# 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:
-    - 'spec/features/v2_serialization_spec.rb'
+    - 'lib/glossarist/schema_migration.rb'
 
 # Offense count: 6
 # This cop supports safe autocorrection (--autocorrect).
@@ -188,28 +105,15 @@ Style/FormatStringToken:
   EnforcedStyle: unannotated
 
 # Offense count: 1
-# This cop supports unsafe autocorrection (--autocorrect-all).
-Style/MapIntoArray:
+# Configuration parameters: AllowedClasses.
+Style/OneClassPerFile:
   Exclude:
-    - 'spec/unit/collection_spec.rb'
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/glossarist.rb'
 
 # Offense count: 1
 # Configuration parameters: Max.
 Style/SafeNavigationChainLength:
   Exclude:
     - 'lib/glossarist/managed_concept.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiterals:
-  Exclude:
-    - 'glossarist.gemspec'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Style/SuperArguments:
-  Exclude:
-    - 'lib/glossarist/designation/base.rb'
-    - 'lib/glossarist/designation/expression.rb'

data/CLAUDE.md

@@ -15,9 +15,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 Glossarist is a Ruby gem implementing the [Glossarist concept model](https://github.com/glossarist/concept-model) (ISO 10241-1). It provides classes for managing terminology glossaries with multi-language support, serialization to/from YAML, and bibliography integration via Relaton.
 
-### Core Model Hierarchy
+All model classes use `Lutaml::Model::Serializable` for serialization.
 
-All model classes use `Lutaml::Model::Serializable` for serialization. Key classes:
+### Core Model Hierarchy
 
 - **`ManagedConceptCollection`** (`managed_concept_collection.rb`) — top-level enumerable collection of ManagedConcepts. Entry point for loading/saving glossaries via `ConceptManager`.
 - **`ManagedConcept`** (`managed_concept.rb`) — a managed concept with `ManagedConceptData` (groups, localized_concepts map, sources), related concepts, dates, and status. Delegates localization via `add_l10n`/`localization(lang)`.
@@ -26,9 +26,13 @@ All model classes use `Lutaml::Model::Serializable` for serialization. Key class
 - **`ConceptData`** (`concept_data.rb`) — the data payload inside `Concept`: definition, terms, examples, notes, sources, language_code. Uses `DetailedDefinition` collections for definition/examples/notes.
 - **`ManagedConceptData`** (`managed_concept_data.rb`) — the data payload inside `ManagedConcept`: id, localized_concepts hash (lang_code => uuid), groups, sources.
 
+### UUID Generation
+
+Concepts use deterministic UUID v5 (SHA-1) derived from their serialized YAML content and the OID namespace (`Utilities::UUID`). This means a concept's UUID is stable across sessions as long as its data doesn't change.
+
 ### Designation (STI-like pattern)
 
-`Designation::Base` (`designation/base.rb`) uses a self-referencing factory pattern (`of_yaml`) that dispatches to subclasses based on `type` field: `Expression`, `Symbol`, `Abbreviation`, `GraphicalSymbol`, `LetterSymbol`. The mapping is in `SERIALIZED_TYPES`.
+`Designation::Base` (`designation/base.rb`) uses a self-referencing factory pattern (`of_yaml`) that dispatches to subclasses based on `type` field: `Expression`, `Symbol`, `Abbreviation`, `GraphicalSymbol`, `LetterSymbol`. The bi-directional mapping is in `SERIALIZED_TYPES` (`designation.rb`).
 
 ### YAML Serialization
 
@@ -46,14 +50,36 @@ All model classes use `Lutaml::Model::Serializable` for serialization. Key class
 
 ### Collections
 
-`collections/` contains `BibliographyCollection` (extends `Relaton::Db` for bibliography caching), `AssetCollection`, `Collection` (base enumerable), and `DesignationCollection`.
+Custom collection classes in `collections/` extend `Lutaml::Model::Collection`:
+- **`LocalizationCollection`** — keyed by `language_code`, used for `ManagedConceptData#localizations`.
+- **`DetailedDefinitionCollection`**, **`ConceptSourceCollection`** — typed collections for ConceptData fields.
+- **`BibliographyCollection`** — extends `Relaton::Db` for bibliography caching with cache version checking.
+- **`AssetCollection`**, **`Collection`** (base enumerable), **`DesignationCollection`**.
+
+### GCR Packaging
+
+Three classes handle glossary concept registry (GCR) ZIP packages:
+- **`GcrPackage`** (`gcr_package.rb`) — creates/loads/validates ZIP archives containing `metadata.yaml`, `register.yaml`, and `concepts/*.yaml` entries.
+- **`GcrMetadata`** (`gcr_metadata.rb`) — package metadata (shortname, version, languages, statistics). Built from concepts via `GcrMetadata.from_concepts`.
+- **`GcrStatistics`** (`gcr_statistics.rb`) — computes stats (total concepts, languages, concepts by status) from concept data.
+- **`SchemaMigration`** (`schema_migration.rb`) — migrates concepts from v0 (legacy IEV format) to v1, normalizing definitions, dates, entry statuses, and extracting inline references.
+- **`ValidationResult`** (`validation_result.rb`) — simple errors/warnings container for package validation.
+
+### CLI
+
+The `exe/glossarist` executable uses Thor. Currently provides `generate_latex` which converts concepts to LaTeX glossary entries via `ConceptSet`.
 
 ### Dependencies
 
 - `lutaml-model` (~> 0.8) — serialization framework (YAML/XML)
 - `relaton` (>= 2.0.0, < 3) — bibliography database integration
-- `thor` — CLI commands (e.g., `glossarist generate_latex`)
+- `thor` — CLI commands
 
-## Branch Notes
+## Gemfile Notes
 
-The `lutaml-model-0.8` branch upgrades from an earlier lutaml-model to 0.8, which requires explicit types on all attributes. Some upstream relaton-* gems (cen, ieee) haven't been updated yet; a compatibility patch is in `bibliography_collection.rb` that prepends `RelatonRegistryPatch` to gracefully skip incompatible backends.
+The Gemfile overrides relaton gems from git branches for lutaml-model 0.8 compatibility:
+- 5 repos use `fix/lutaml-model-0.8` branches (relaton-bib, relaton-iso, relaton-3gpp, relaton-bipm, relaton-bsi)
+- 5 repos use `lutaml-integration` branches (relaton-calconnect, relaton-ccsds, relaton-cen, relaton-iec, relaton-itu)
+- Released 2.0.0 gems have untyped lutaml-model attributes that fail with 0.8+
+- relaton-bib 2.1.0 is released but sub-gems pin `~> 2.0.0`, blocking 2.1.0 adoption until upstream updates constraints
+- Remove git overrides once relaton gems release versions with lutaml-model 0.8 support

data/Gemfile

@@ -5,7 +5,7 @@ source "https://rubygems.org"
 gemspec
 
 gem "canon"
-gem "lutaml-model", github: "lutaml/lutaml-model", ref: "main"
+gem "lutaml-model", "~> 0.8.0"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
 gem "rubocop"
@@ -13,21 +13,22 @@ gem "rubocop-performance"
 gem "rubocop-rake"
 gem "rubocop-rspec"
 
-# Use lutaml-model 0.8 compatible branches for all relaton gems.
-# These branches add explicit types to all lutaml-model attributes,
-# which is required by lutaml-model 0.8+.
-# TODO: Remove these once relaton gems release versions with lutaml-model 0.8 support.
-%w[
-  relaton relaton-bib relaton-iso
-  relaton-3gpp relaton-bipm relaton-bsi relaton-calconnect
-  relaton-ccsds relaton-cen relaton-cie relaton-doi relaton-ecma
-  relaton-etsi relaton-gb relaton-iana relaton-iec relaton-ieee
-  relaton-ietf relaton-iho relaton-isbn relaton-itu relaton-jis
-  relaton-nist relaton-oasis relaton-ogc relaton-omg relaton-plateau
-  relaton-un relaton-w3c relaton-xsf
-].each do |g|
-  ref = g == "relaton-bib" ? "upd-lutaml-model-to-0-8-0" : "upd-lutaml-model-to-0.8.0"
-  gem g, github: "relaton/#{g}", ref: ref
-end
-
-gemspec
+# Override relaton gems with lutaml-model 0.8 compatible versions.
+# Released 2.0.0 gems have untyped lutaml-model attributes that fail with 0.8+.
+# fix/lutaml-model-0.8 branches keep version 2.0.0 (compatible) + lutaml-model ~> 0.8.
+# lutaml-integration branches also have typed attributes and work with relaton-bib ~> 2.0.0.
+# TODO: Remove once relaton gems release versions with lutaml-model 0.8 support.
+gem "relaton-3gpp", github: "relaton/relaton-3gpp",
+                    branch: "fix/lutaml-model-0.8"
+gem "relaton-bib", github: "relaton/relaton-bib", branch: "fix/lutaml-model-0.8"
+gem "relaton-bipm", github: "relaton/relaton-bipm",
+                    branch: "fix/lutaml-model-0.8"
+gem "relaton-bsi", github: "relaton/relaton-bsi", branch: "fix/lutaml-model-0.8"
+gem "relaton-calconnect", github: "relaton/relaton-calconnect",
+                          branch: "lutaml-integration"
+gem "relaton-ccsds", github: "relaton/relaton-ccsds",
+                     branch: "lutaml-integration"
+gem "relaton-cen", github: "relaton/relaton-cen", branch: "lutaml-integration"
+gem "relaton-iec", github: "relaton/relaton-iec", branch: "lutaml-integration"
+gem "relaton-iso", github: "relaton/relaton-iso", branch: "fix/lutaml-model-0.8"
+gem "relaton-itu", github: "relaton/relaton-itu", branch: "lutaml-integration"