glossarist 2.6.6 → 2.6.7

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glossarist
 version: !ruby/object:Gem::Version
-  version: 2.6.6
+  version: 2.6.7
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-13 00:00:00.000000000 Z
+date: 2026-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.5
+- !ruby/object:Gem::Dependency
+  name: paint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: relaton
   requirement: !ruby/object:Gem::Requirement
@@ -78,6 +92,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.5.6
+- !ruby/object:Gem::Dependency
+  name: table_tennis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: tbx
   requirement: !ruby/object:Gem::Requirement
@@ -127,7 +155,6 @@ files:
 - LICENSE.txt
 - README.adoc
 - Rakefile
-- TODO.integration/01-gcr-package-cli.md
 - config.yml
 - exe/glossarist
 - glossarist.gemspec
@@ -137,6 +164,7 @@ files:
 - lib/glossarist/bibliographic_reference.rb
 - lib/glossarist/citation.rb
 - lib/glossarist/cli.rb
+- lib/glossarist/cli/compare_command.rb
 - lib/glossarist/cli/export_command.rb
 - lib/glossarist/cli/import_command.rb
 - lib/glossarist/cli/package_command.rb
@@ -153,18 +181,23 @@ files:
 - lib/glossarist/collections/detailed_definition_collection.rb
 - lib/glossarist/collections/localization_collection.rb
 - lib/glossarist/collections/typed_collection.rb
+- lib/glossarist/comparison_result.rb
 - lib/glossarist/concept.rb
 - lib/glossarist/concept_collector.rb
+- lib/glossarist/concept_comparator.rb
 - lib/glossarist/concept_data.rb
 - lib/glossarist/concept_date.rb
+- lib/glossarist/concept_diff.rb
 - lib/glossarist/concept_document.rb
 - lib/glossarist/concept_enricher.rb
 - lib/glossarist/concept_manager.rb
+- lib/glossarist/concept_ref.rb
 - lib/glossarist/concept_reference.rb
 - lib/glossarist/concept_set.rb
 - lib/glossarist/concept_source.rb
 - lib/glossarist/concept_validator.rb
 - lib/glossarist/config.rb
+- lib/glossarist/context_configuration.rb
 - lib/glossarist/custom_locality.rb
 - lib/glossarist/dataset_validator.rb
 - lib/glossarist/designation.rb
@@ -174,6 +207,8 @@ files:
 - lib/glossarist/designation/grammar_info.rb
 - lib/glossarist/designation/graphical_symbol.rb
 - lib/glossarist/designation/letter_symbol.rb
+- lib/glossarist/designation/prefix.rb
+- lib/glossarist/designation/suffix.rb
 - lib/glossarist/designation/symbol.rb
 - lib/glossarist/detailed_definition.rb
 - lib/glossarist/error.rb
@@ -194,12 +229,38 @@ files:
 - lib/glossarist/non_verb_rep.rb
 - lib/glossarist/pronunciation.rb
 - lib/glossarist/rdf.rb
+- lib/glossarist/rdf/ext.rb
+- lib/glossarist/rdf/ext/jsonld_transform_ext.rb
+- lib/glossarist/rdf/ext/mapping_ext.rb
+- lib/glossarist/rdf/ext/mapping_rule_ext.rb
+- lib/glossarist/rdf/ext/member_rule_ext.rb
+- lib/glossarist/rdf/ext/turtle_transform_ext.rb
+- lib/glossarist/rdf/gloss_citation.rb
+- lib/glossarist/rdf/gloss_concept.rb
+- lib/glossarist/rdf/gloss_concept_date.rb
+- lib/glossarist/rdf/gloss_concept_reference.rb
+- lib/glossarist/rdf/gloss_concept_source.rb
+- lib/glossarist/rdf/gloss_designation.rb
+- lib/glossarist/rdf/gloss_detailed_definition.rb
+- lib/glossarist/rdf/gloss_grammar_info.rb
+- lib/glossarist/rdf/gloss_locality.rb
+- lib/glossarist/rdf/gloss_localized_concept.rb
+- lib/glossarist/rdf/gloss_non_verbal_rep.rb
+- lib/glossarist/rdf/gloss_pronunciation.rb
+- lib/glossarist/rdf/gloss_reference.rb
 - lib/glossarist/rdf/localized_literal.rb
 - lib/glossarist/rdf/namespaces.rb
 - lib/glossarist/rdf/namespaces/dcterms_namespace.rb
+- lib/glossarist/rdf/namespaces/glossarist_namespace.rb
+- lib/glossarist/rdf/namespaces/iso_thes_namespace.rb
+- lib/glossarist/rdf/namespaces/owl_namespace.rb
+- lib/glossarist/rdf/namespaces/prov_namespace.rb
+- lib/glossarist/rdf/namespaces/rdf_namespace.rb
 - lib/glossarist/rdf/namespaces/skos_namespace.rb
-- lib/glossarist/rdf/skos_concept.rb
-- lib/glossarist/rdf/skos_vocabulary.rb
+- lib/glossarist/rdf/namespaces/skosxl_namespace.rb
+- lib/glossarist/rdf/relationships.rb
+- lib/glossarist/rdf/v3.rb
+- lib/glossarist/rdf/v3/configuration.rb
 - lib/glossarist/reference_extractor.rb
 - lib/glossarist/reference_resolver.rb
 - lib/glossarist/register_data.rb
@@ -219,7 +280,7 @@ files:
 - lib/glossarist/sts/term_extractor.rb
 - lib/glossarist/sts/term_mapper.rb
 - lib/glossarist/transforms.rb
-- lib/glossarist/transforms/concept_to_skos_transform.rb
+- lib/glossarist/transforms/concept_to_gloss_transform.rb
 - lib/glossarist/transforms/concept_to_tbx_transform.rb
 - lib/glossarist/urn_resolver.rb
 - lib/glossarist/utilities.rb
@@ -229,6 +290,34 @@ files:
 - lib/glossarist/v1/concept.rb
 - lib/glossarist/v1/cross_references.rb
 - lib/glossarist/v1/register.rb
+- lib/glossarist/v2.rb
+- lib/glossarist/v2/citation.rb
+- lib/glossarist/v2/concept_data.rb
+- lib/glossarist/v2/concept_document.rb
+- lib/glossarist/v2/concept_ref.rb
+- lib/glossarist/v2/concept_source.rb
+- lib/glossarist/v2/configuration.rb
+- lib/glossarist/v2/detailed_definition.rb
+- lib/glossarist/v2/localized_concept.rb
+- lib/glossarist/v2/managed_concept.rb
+- lib/glossarist/v2/managed_concept_data.rb
+- lib/glossarist/v2/related_concept.rb
+- lib/glossarist/v3.rb
+- lib/glossarist/v3/bibliography_entry.rb
+- lib/glossarist/v3/bibliography_file.rb
+- lib/glossarist/v3/citation.rb
+- lib/glossarist/v3/concept_data.rb
+- lib/glossarist/v3/concept_document.rb
+- lib/glossarist/v3/concept_ref.rb
+- lib/glossarist/v3/concept_source.rb
+- lib/glossarist/v3/configuration.rb
+- lib/glossarist/v3/detailed_definition.rb
+- lib/glossarist/v3/image_entry.rb
+- lib/glossarist/v3/image_file.rb
+- lib/glossarist/v3/localized_concept.rb
+- lib/glossarist/v3/managed_concept.rb
+- lib/glossarist/v3/managed_concept_data.rb
+- lib/glossarist/v3/related_concept.rb
 - lib/glossarist/validation.rb
 - lib/glossarist/validation/asset_index.rb
 - lib/glossarist/validation/bibliography_index.rb
@@ -251,6 +340,8 @@ files:
 - lib/glossarist/validation/rules/definition_content_rule.rb
 - lib/glossarist/validation/rules/designation_status_rule.rb
 - lib/glossarist/validation/rules/designation_type_rule.rb
+- lib/glossarist/validation/rules/domain_ref_rule.rb
+- lib/glossarist/validation/rules/domain_target_rule.rb
 - lib/glossarist/validation/rules/duplicate_term_rule.rb
 - lib/glossarist/validation/rules/entry_status_rule.rb
 - lib/glossarist/validation/rules/filename_id_rule.rb
@@ -260,26 +351,40 @@ files:
 - lib/glossarist/validation/rules/language_code_format_rule.rb
 - lib/glossarist/validation/rules/language_coverage_rule.rb
 - lib/glossarist/validation/rules/language_list_rule.rb
+- lib/glossarist/validation/rules/locality_completeness_rule.rb
+- lib/glossarist/validation/rules/localization_consistency_rule.rb
 - lib/glossarist/validation/rules/localization_presence_rule.rb
+- lib/glossarist/validation/rules/model_validity_rule.rb
 - lib/glossarist/validation/rules/orphaned_bibliography_rule.rb
 - lib/glossarist/validation/rules/orphaned_images_rule.rb
 - lib/glossarist/validation/rules/orphaned_l10n_files_rule.rb
 - lib/glossarist/validation/rules/preferred_term_rule.rb
+- lib/glossarist/validation/rules/ref_shape_rule.rb
 - lib/glossarist/validation/rules/registry.rb
 - lib/glossarist/validation/rules/related_concept_cycle_rule.rb
 - lib/glossarist/validation/rules/related_concept_rule.rb
 - lib/glossarist/validation/rules/related_concept_symmetry_rule.rb
+- lib/glossarist/validation/rules/related_concept_target_rule.rb
+- lib/glossarist/validation/rules/schema_version_rule.rb
 - lib/glossarist/validation/rules/source_type_rule.rb
+- lib/glossarist/validation/rules/source_urn_format_rule.rb
 - lib/glossarist/validation/rules/terms_presence_rule.rb
+- lib/glossarist/validation/rules/uuid_format_rule.rb
 - lib/glossarist/validation/validation_issue.rb
 - lib/glossarist/validation_result.rb
 - lib/glossarist/version.rb
+- memory/project-status.md
 - relaton-bib-2.0.0.gem
 - relaton-bib-2.1.0.gem
 - relaton-cen-2.0.0.gem
 - relaton-iec-2.0.0.gem
 - relaton-iso-2.0.0.gem
 - relaton-itu-2.0.0.gem
+- scripts/migrate_dataset.rb
+- scripts/migrate_isotc204_to_v3.rb
+- scripts/migrate_isotc211_to_v3.rb
+- scripts/migrate_osgeo_to_v3.rb
+- scripts/upgrade_dataset_to_v3.rb
 homepage: https://github.com/glossarist/glossarist-ruby
 licenses:
 - BSD-2-Clause

data/TODO.integration/01-gcr-package-cli.md

@@ -1,180 +0,0 @@
-# 01 — GCR Packaging CLI with Versioning
-
-## Goal
-
-The `glossarist` Ruby gem provides the canonical way to build versioned GCR packages from concept datasets. Each glossary repo uses `glossarist package` in CI to publish GCR releases.
-
-## Current State
-
-- CLI has `package`, `upgrade`, `validate` commands (via Thor)
-- `GcrPackage.create` / `GcrPackage.load` handle ZIP I/O
-- `GcrMetadata` generates metadata with statistics
-- `SchemaMigration` handles v0→v1 harmonization
-- Missing: `shortname` and `version` fields in GcrMetadata
-- Missing: v2 format support in `PackageCommand`
-
-## Status
-
-Tasks 1–5 are **implemented** on branch `fix/gemfile-lutaml-model-substring`. Remaining: task 6 (publish gem to RubyGems).
-
-## Tasks
-
-### 1. Add `shortname` and `version` to `GcrMetadata`
-
-Edit `lib/glossarist/gcr_metadata.rb`:
-
-```ruby
-attr_accessor :shortname, :version, :title, :description, :owner, :tags,
-              :concept_count, :languages,
-              :created_at, :glossarist_version, :schema_version,
-              :statistics, :homepage, :repository, :license
-
-def initialize(attrs = {})
-  @shortname = attrs[:shortname]
-  @version = attrs[:version]
-  # ... existing fields ...
-end
-
-def self.from_concepts(concepts, register_data: nil, options: {})
-  stats = GcrStatistics.from_concepts(concepts)
-  new(
-    shortname: options[:shortname],
-    version: options[:version],
-    title: options[:title] || register_data&.dig("name"),
-    # ... existing fields ...
-  )
-end
-
-def to_h
-  h = {
-    "shortname" => shortname,
-    "version" => version,
-    "title" => title,
-    # ... existing fields ...
-  }
-  h.compact
-end
-```
-
-### 2. Add `--shortname` and `--version` CLI options
-
-Edit `lib/glossarist/cli.rb`:
-
-```ruby
-desc "package DIR", "Create a .gcr ZIP archive from a dataset"
-option :output, aliases: :o, required: true, desc: "Output .gcr file path"
-option :shortname, type: :string, required: true, desc: "Machine-readable dataset ID"
-option :version, type: :string, required: true, desc: "Semantic version (e.g. 1.0.0)"
-option :title, type: :string, desc: "Dataset title"
-option :description, type: :string, desc: "Dataset description"
-option :owner, type: :string, desc: "Dataset owner"
-option :register_yaml, type: :string, desc: "Path to register.yaml"
-option :tags, type: :array, desc: "Tags for the dataset"
-def package(dir)
-  # ...
-end
-```
-
-### 3. Add v2 format support to `PackageCommand`
-
-Edit `lib/glossarist/cli/package_command.rb`:
-
-```ruby
-def collect_concepts
-  if v1_concepts?
-    collect_v1_concepts
-  elsif v2_concepts?
-    collect_v2_concepts
-  else
-    []
-  end
-end
-
-def v1_concepts?
-  concepts_dir = File.join(@dir, "concepts")
-  File.directory?(concepts_dir) && Dir.glob(File.join(concepts_dir, "*.yaml")).any?
-end
-
-def v2_concepts?
-  File.directory?(File.join(@dir, "geolexica-v2"))
-end
-
-def collect_v2_concepts
-  collection = Glossarist::ManagedConceptCollection.new
-  manager = Glossarist::ConceptManager.new(path: File.join(@dir, "geolexica-v2"))
-  manager.load_from_files(collection: collection)
-
-  collection.map { |concept| concept_to_v1_hash(concept) }
-end
-
-def concept_to_v1_hash(concept)
-  hash = { "termid" => concept.data.id.to_s }
-  concept.localizations.each do |lang, l10n|
-    hash[lang] = localized_to_hash(l10n)
-  end
-  hash["term"] = preferred_designation(hash["eng"]&.dig("terms")) || ""
-  hash
-end
-
-def localized_to_hash(l10n)
-  h = {}
-  h["terms"] = l10n.designations.map(&:to_h) if l10n.designations.any?
-  h["definition"] = l10n.definition.map { |d| { "content" => d.content } } if l10n.definition.any?
-  h["notes"] = l10n.notes.map { |n| { "content" => n.content } } if l10n.notes.any?
-  h["examples"] = l10n.examples.map { |e| { "content" => e.content } } if l10n.examples.any?
-  h["sources"] = l10n.sources.map(&:to_h) if l10n.sources.any?
-  h["language_code"] = l10n.language_code if l10n.language_code
-  h["entry_status"] = l10n.entry_status if l10n.entry_status
-  h["dates"] = l10n.dates.map(&:to_h) if l10n.dates.any?
-  h
-end
-```
-
-### 4. Auto-derive shortname from directory name
-
-If `--shortname` is not provided, derive from:
-1. `register.yaml` → `register["shortname"]` or `register["id"]`
-2. Directory basename
-3. Raise error if none available
-
-### 5. Validate filename matches metadata
-
-In `GcrPackage.validate`, check that the filename pattern `{shortname}-{version}.gcr` matches the `shortname` and `version` in metadata.yaml.
-
-### 6. Publish gem
-
-```bash
-gem build glossarist.gemspec
-gem push glossarist-2.6.0.gem
-```
-
-## CLI Usage
-
-```bash
-# Install
-gem install glossarist
-
-# Package (v1 format)
-glossarist package ./isotc204-glossary \
-  --shortname isotc204 --version 1.0.0 \
-  -o isotc204-1.0.0.gcr \
-  --title "ISO/TC 204 ITS Vocabulary" --owner "ISO/TC 204"
-
-# Package (v2 format, auto-detected)
-glossarist package ./isotc211-glossary \
-  --shortname isotc211 --version 2.3.0 \
-  -o isotc211-2.3.0.gcr \
-  --title "ISO/TC 211 Multi-Lingual Glossary" --owner "ISO/TC 211"
-
-# Validate
-glossarist validate isotc204-1.0.0.gcr
-```
-
-## Acceptance Criteria
-
-- [x] `GcrMetadata` includes `shortname` and `version` fields
-- [x] `glossarist package --shortname X --version Y` produces `{X}-{Y}.gcr`
-- [x] `metadata.yaml` contains `shortname` and `version`
-- [x] `glossarist validate` checks metadata has required fields
-- [x] Works with both v1 (`concepts/*.yaml`) and v2 (`geolexica-v2/*.yaml`) datasets
-- [ ] Gem published to RubyGems

data/lib/glossarist/rdf/skos_concept.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-require "lutaml/turtle"
-require "lutaml/jsonld"
-
-module Glossarist
-  module Rdf
-    class SkosConcept < Lutaml::Model::Serializable
-      attribute :code, :string
-      attribute :labels, LocalizedLiteral, collection: true
-      attribute :definitions, LocalizedLiteral, collection: true
-      attribute :alt_labels, LocalizedLiteral, collection: true
-      attribute :scope_notes, LocalizedLiteral, collection: true
-      attribute :sources, :string, collection: true
-      attribute :domain, :string
-      attribute :date_accepted, :string
-
-      rdf do
-        namespace Namespaces::SkosNamespace, Namespaces::DctermsNamespace
-
-        subject { |c| "https://glossarist.org/concept/#{c.code}" }
-        type "skos:Concept"
-
-        predicate :notation,     namespace: Namespaces::SkosNamespace,
-                                 to: :code
-        predicate :prefLabel,    namespace: Namespaces::SkosNamespace,
-                                 to: :labels,       lang_tagged: true
-        predicate :definition,   namespace: Namespaces::SkosNamespace,
-                                 to: :definitions,  lang_tagged: true
-        predicate :altLabel,     namespace: Namespaces::SkosNamespace,
-                                 to: :alt_labels,   lang_tagged: true
-        predicate :scopeNote,    namespace: Namespaces::SkosNamespace,
-                                 to: :scope_notes,  lang_tagged: true
-        predicate :subject,      namespace: Namespaces::DctermsNamespace,
-                                 to: :domain
-        predicate :source,       namespace: Namespaces::DctermsNamespace,
-                                 to: :sources
-        predicate :dateAccepted, namespace: Namespaces::DctermsNamespace,
-                                 to: :date_accepted
-      end
-    end
-  end
-end

data/lib/glossarist/rdf/skos_vocabulary.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require "lutaml/turtle"
-require "lutaml/jsonld"
-
-module Glossarist
-  module Rdf
-    class SkosVocabulary < Lutaml::Model::Serializable
-      attribute :id, :string
-      attribute :title, :string
-      attribute :concepts, SkosConcept, collection: true
-
-      rdf do
-        namespace Namespaces::SkosNamespace, Namespaces::DctermsNamespace
-
-        subject { |v| "https://glossarist.org/vocab/#{v.id}" }
-        type "skos:ConceptScheme"
-
-        predicate :prefLabel, namespace: Namespaces::SkosNamespace, to: :title
-
-        members :concepts
-      end
-    end
-  end
-end

data/lib/glossarist/transforms/concept_to_skos_transform.rb

@@ -1,131 +0,0 @@
-# frozen_string_literal: true
-
-module Glossarist
-  module Transforms
-    class ConceptToSkosTransform
-      def self.transform(managed_concept, options = {})
-        new(managed_concept, options).build
-      end
-
-      def self.transform_document(concepts, options = {})
-        Rdf::SkosVocabulary.new(
-          id: options[:shortname] || "glossary",
-          title: options[:title],
-          concepts: concepts.map { |c| transform(c, options) },
-        )
-      end
-
-      def initialize(managed_concept, options = {})
-        @concept = managed_concept
-        @options = options
-      end
-
-      def build
-        Rdf::SkosConcept.new(
-          code: concept_code,
-          labels: build_labels,
-          definitions: build_definitions,
-          alt_labels: build_alt_labels,
-          scope_notes: build_scope_notes,
-          domain: build_domain,
-          sources: build_sources,
-          date_accepted: build_date_accepted,
-        )
-      end
-
-      private
-
-      attr_reader :concept, :options
-
-      def concept_code
-        concept.data&.id || concept.identifier
-      end
-
-      def build_labels
-        each_localization.filter_map do |lang, l10n|
-          term = l10n.preferred_terms&.first || l10n.terms&.first
-          next unless term
-
-          Rdf::LocalizedLiteral.new(
-            value: term.designation.to_s,
-            language_code: lang,
-          )
-        end
-      end
-
-      def build_alt_labels
-        each_localization.flat_map do |lang, l10n|
-          preferred_term = l10n.preferred_terms&.first || l10n.terms&.first
-          (l10n.terms || []).reject do |t|
-            t == preferred_term
-          end.filter_map do |term|
-            next unless term.designation
-
-            Rdf::LocalizedLiteral.new(
-              value: term.designation.to_s,
-              language_code: lang,
-            )
-          end
-        end
-      end
-
-      def build_definitions
-        each_localization.filter_map do |lang, l10n|
-          content = l10n.data&.definition&.first&.content
-          next unless content
-
-          Rdf::LocalizedLiteral.new(
-            value: content.to_s,
-            language_code: lang,
-          )
-        end
-      end
-
-      def build_scope_notes
-        each_localization.filter_map do |lang, l10n|
-          note = l10n.data&.notes&.first&.content
-          next unless note
-
-          Rdf::LocalizedLiteral.new(
-            value: note.to_s,
-            language_code: lang,
-          )
-        end
-      end
-
-      def build_domain
-        l10n = concept.localizations.first
-        l10n&.data&.domain
-      end
-
-      def build_sources
-        each_localization.flat_map do |_lang, l10n|
-          Array(l10n.data&.sources).select(&:authoritative?).filter_map do |src|
-            origin = src.origin
-            next unless origin
-
-            origin.ref || origin.text
-          end
-        end.uniq
-      end
-
-      def build_date_accepted
-        date = concept.date_accepted
-        return unless date
-
-        date.date&.iso8601
-      end
-
-      def each_localization
-        return enum_for(:each_localization) unless block_given?
-
-        concept.localizations.each do |l10n|
-          lang = l10n.language_code || l10n.data&.language_code
-          next unless lang
-
-          yield lang, l10n
-        end
-      end
-    end
-  end
-end