glossarist 2.8.12 → 2.8.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 284d64ec4a9bac75c0639dd3254a715e881d46949240f430db9d6322cec09379
-  data.tar.gz: a349a57dba2f2e5b79c93561dcfa2fd54ee1627326d66b3cf2d6b66cbcca2f3c
+  metadata.gz: 807c7a2aface582e6a1dfb6c4dd63f09c51d7429274597d8b7ee48d63282b7a9
+  data.tar.gz: 5af5e853bb00cec098806db6dbbe03b91dd5177a06388f4e9d79255dbf43cc2e
 SHA512:
-  metadata.gz: 270a84779887cf795087a0fb56f923240b26c028bef18c6b436b5129cfcc0985a020e9ab5b2ce2b2b6e5f472f75de7c79546d56fe0a94465f068d3f5ee28617a
-  data.tar.gz: 1411213954c8fbbdb95bc9e5c4bc8455d55edf4df1944714dcd8a0ffac4733d64ed16bd32ae6c259691739dda04418fe9bcf91ba2af04451505a0b0d61168c55
+  metadata.gz: 4020f1eabf8c0915ef3463e646abc71929d71ebe1fedbf0691ef008581b68c8c6913f9a908612fc2863e2c495bdc4ef643a4390ac6a2bf3dde4b7441b172bfdd
+  data.tar.gz: 69a9f82209f07c81bb8f7a68fdb1e556b3cc4d7180630f99f88f889ce84e81d37e18b9d643b8b35aaed4f0391f890841c51c468a0da4edc96ace4d22d1859f95

data/lib/glossarist/dataset_register.rb

@@ -56,6 +56,37 @@ module Glossarist
       nil
     end
 
+    # Returns all ancestor section IDs for a given section, from immediate
+    # parent up to the root. Implements the cascading membership semantics:
+    # a concept in section "3.1.1" is also a member of "3.1" and "3".
+    # (concept-model: gloss:hasChildSection / gloss:hasParentSection are
+    # owl:TransitiveProperty.)
+    def section_ancestor_ids(target_id)
+      @section_parent_index ||= build_section_parent_index
+      @section_parent_index[target_id] || []
+    end
+
+    # Returns all section IDs that a concept belongs to, including
+    # transitive ancestor sections (cascading membership).
+    #
+    # Resolution order (concept-model convention):
+    # 1. Explicit domains[] entries with ref_type: "section"
+    # 2. Term-ID-prefix derivation fallback (longest registered prefix)
+    #
+    # @param concept [ManagedConcept, #data] the concept to resolve
+    # @return [Array<String>] section IDs, child-first then ancestors
+    def concept_section_ids(concept)
+      explicit = explicit_section_ids(concept)
+      ids = explicit.empty? ? derive_section_ids_from_id(concept) : explicit
+      ids.flat_map { |id| [id] + section_ancestor_ids(id) }.uniq
+    end
+
+    # Returns true if the given section ID exists anywhere in the section
+    # tree (root or descendant).
+    def section_exists?(target_id)
+      !section_by_id(target_id).nil?
+    end
+
     def self.from_file(path)
       return nil unless File.exist?(path)
 
@@ -68,5 +99,53 @@ module Glossarist
 
       from_file(register_path)
     end
+
+    private
+
+    # Build a flat child→[ancestor_ids] index by walking the section tree.
+    # Ancestors are ordered immediate-parent-first (closest section first).
+    # @example for sections [{id:"3", children:[{id:"3.1"}]}]:
+    #   { "3.1" => ["3"] }
+    def build_section_parent_index
+      index = {}
+      walk_section_tree(sections, []) do |section, ancestors|
+        index[section.id] = ancestors.reverse unless ancestors.empty?
+      end
+      index
+    end
+
+    def walk_section_tree(nodes, ancestors, &block)
+      Array(nodes).each do |section|
+        yield section, ancestors
+        child_ancestors = ancestors + [section.id]
+        walk_section_tree(section.children, child_ancestors, &block)
+      end
+    end
+
+    def explicit_section_ids(concept)
+      domains = concept.respond_to?(:data) ? concept.data&.domains : nil
+      Array(domains).select { |d| d.ref_type == "section" }
+        .filter_map(&:concept_id)
+    end
+
+    # Term-ID-prefix derivation: when a concept has no explicit section
+    # domains, derive section membership from its identifier using the
+    # longest registered section prefix.
+    # @example "103-01-01" with section "103" registered → ["103"]
+    def derive_section_ids_from_id(concept)
+      concept_id = concept.respond_to?(:data) ? concept.data&.id : nil
+      return [] unless concept_id
+
+      all_section_ids = collect_all_section_ids
+      all_section_ids.select { |sid| concept_id.start_with?("#{sid}-", "#{sid}.") }
+        .max_by(&:length)
+        &.then { |sid| [sid] } || []
+    end
+
+    def collect_all_section_ids
+      ids = []
+      walk_section_tree(sections, []) { |section, _| ids << section.id }
+      ids
+    end
   end
 end

data/lib/glossarist/validation/rules/dataset_context.rb

@@ -31,6 +31,13 @@ module Glossarist
           nil
         end
 
+        # Loads the dataset's register.yaml as a DatasetRegister (with
+        # hierarchical sections, urn, ordering). Returns nil if no
+        # register.yaml exists or it uses the legacy format.
+        def dataset_register
+          @dataset_register ||= load_dataset_register
+        end
+
         def bibliography_index
           @bibliography_index ||= BibliographyIndex.build_from_concepts(
             concepts, dataset_path: @path
@@ -98,6 +105,13 @@ module Glossarist
           end
           index
         end
+
+        def load_dataset_register
+          reg_path = File.join(@path, "register.yaml")
+          return nil unless File.exist?(reg_path)
+
+          DatasetRegister.from_file(reg_path)
+        end
       end
     end
   end

data/lib/glossarist/validation/rules/domain_ref_rule.rb

@@ -27,6 +27,21 @@ module Glossarist
                 suggestion: "Provide at least concept_id or urn for the domain reference",
               )
             end
+
+            next unless domain.ref_type == "section" && domain.concept_id
+
+            register = context.collection_context.dataset_register
+            next unless register
+
+            unless register.section_exists?(domain.concept_id)
+              issues << issue(
+                "domain #{idx + 1} references section '#{domain.concept_id}' " \
+                "that does not exist in register.yaml",
+                location: fname,
+                suggestion: "Add section '#{domain.concept_id}' to " \
+                            "register.yaml or fix the reference",
+              )
+            end
           end
 
           issues

data/lib/glossarist/version.rb

@@ -4,5 +4,5 @@
 #
 
 module Glossarist
-  VERSION = "2.8.12"
+  VERSION = "2.8.13"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glossarist
 version: !ruby/object:Gem::Version
-  version: 2.8.12
+  version: 2.8.13
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-15 00:00:00.000000000 Z
+date: 2026-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model