iev 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a539da108086dd1fb862d1d99d6763a3d32015a921ef580018ac9671660b0b68
-  data.tar.gz: af0e1813cae179dd69da3a9e8fde6e8d275e34d59949bd43a0642a171988f311
+  metadata.gz: f5d3397238922342cdb3fb6b5adcf8fa969d2b3d6510742485d7d2a20b1d1a12
+  data.tar.gz: 6a82e64e1201a9a2f04cff66d024de1b23643030ce6e37f26ef09bb2ad334b10
 SHA512:
-  metadata.gz: c93e2479cccfbe56b37b1d1cd604a3b327258abd8c50f9b99e2091abe7e4e714aa8e44c49f9e886d11483ec80e8e2325ce78f0598e8b34fdeb4fe7442b0e0d32
-  data.tar.gz: 28c5084f7a75106feee144201b75b642217674438f14a48c216a1069ed1b5d0abe822d137afb6671303bc1a407689ec236c4b2ff5abe2c0626e3a34f1ec35b34
+  metadata.gz: be3b984bd46c791580a73644e88dccca4b98b708ce0e28c50f72e822abb609573455201b633d0e4d791b9271cdecb20a555b11cc674dda46bde90fcf7eaccb74
+  data.tar.gz: e56796a853c58aae578dd5c4fe3fbaf3e18115e1a08e22feb7d5f876d9521dee4d27fb734fb05baa12e297b1dc9ac89b67197cad0b51695b2224c3fdb622f3a5

data/.rubocop.yml

@@ -1,6 +1,7 @@
 # Auto-generated by Cimas: Do not edit it manually!
 # See https://github.com/metanorma/cimas
 inherit_from:
+  - .rubocop_todo.yml
   - https://raw.githubusercontent.com/riboseinc/oss-guides/main/ci/rubocop.yml
 
 # local repo-specific modifications

data/.rubocop_todo.yml

@@ -1,65 +1,142 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-11-14 11:14:05 UTC using RuboCop version 1.81.7.
+# on 2026-06-13 04:18:23 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: 43
+# Offense count: 1
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'iev.gemspec'
+
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'spec/iev/exporter_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith.
+# SupportedStylesAlignWith: either, start_of_block, start_of_line
+Layout/BlockAlignment:
+  Exclude:
+    - 'spec/iev/exporter_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/BlockEndNewline:
+  Exclude:
+    - 'spec/iev/exporter_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
+# SupportedStylesAlignWith: start_of_line, relative_to_receiver
+Layout/IndentationWidth:
+  Exclude:
+    - 'spec/iev/exporter_spec.rb'
+
+# Offense count: 65
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
-  Exclude:
-    - 'iev.gemspec'
-    - 'lib/iev/cli/command.rb'
-    - 'lib/iev/cli/command_helper.rb'
-    - 'lib/iev/db_cache.rb'
-    - 'lib/iev/source_parser.rb'
-    - 'spec/acceptance/db2yaml_spec.rb'
-    - 'spec/acceptance/xlsx2yaml_spec.rb'
-    - 'spec/iev_spec.rb'
+  Enabled: false
 
-# Offense count: 7
+# Offense count: 19
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
     - 'lib/iev/source_parser.rb'
-    - 'lib/iev/term_builder.rb'
+    - 'lib/iev/utilities.rb'
 
 # Offense count: 1
 Lint/MixedRegexpCaptureTypes:
   Exclude:
     - 'lib/iev/term_builder.rb'
 
-# Offense count: 10
+# Offense count: 2
+Lint/ShadowedException:
+  Exclude:
+    - 'lib/iev/source_parser.rb'
+
+# Offense count: 26
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
+    - 'lib/iev/cli/command.rb'
+    - 'lib/iev/cli/command_helper.rb'
     - 'lib/iev/converter/mathml_to_asciimath.rb'
     - 'lib/iev/db_writer.rb'
+    - 'lib/iev/exporter.rb'
+    - 'lib/iev/scraper/page_parser.rb'
     - 'lib/iev/source_parser.rb'
+    - 'lib/iev/subject_area_concepts.rb'
+    - 'lib/iev/subject_areas.rb'
     - 'lib/iev/term_builder.rb'
+    - 'lib/iev/utilities.rb'
+    - 'spec/iev/supersession_parser_spec.rb'
 
-# Offense count: 5
+# Offense count: 15
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
-    - 'lib/iev.rb'
     - 'lib/iev/converter/mathml_to_asciimath.rb'
+    - 'lib/iev/exporter.rb'
+    - 'lib/iev/scraper/page_parser.rb'
     - 'lib/iev/source_parser.rb'
+    - 'lib/iev/subject_areas.rb'
     - 'lib/iev/term_builder.rb'
+    - 'lib/iev/utilities.rb'
 
-# Offense count: 20
+# Offense count: 36
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 74
+  Max: 73
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 7
 
-# Offense count: 3
+# Offense count: 8
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
-    - 'lib/iev.rb'
     - 'lib/iev/converter/mathml_to_asciimath.rb'
+    - 'lib/iev/exporter.rb'
+    - 'lib/iev/scraper/page_parser.rb'
+    - 'lib/iev/subject_areas.rb'
     - 'lib/iev/term_builder.rb'
+
+# Offense count: 1
+# 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:
+    - 'lib/iev/subject_areas.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/iev/exporter_spec.rb'
+
+# Offense count: 5
+# 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:
+    - 'lib/iev/exporter.rb'
+    - 'spec/iev/exporter_spec.rb'

data/CLAUDE.md

@@ -27,15 +27,23 @@ This is a Ruby gem (`iev`) for working with the International Electrotechnical V
 
 ### Key Modules
 
-- `TermBuilder` — the core converter that turns a spreadsheet row into a `Glossarist::LocalizedConcept`. Handles definition splitting (notes/examples extraction), term designation parsing, and source parsing.
+- `TermBuilder` — the core converter that turns a spreadsheet row into a `Glossarist::LocalizedConcept`. Handles definition splitting (notes/examples extraction), term designation parsing, and source parsing. Sets `ConceptData#domain` to section/area title text (not URI).
 - `SourceParser` — parses the SOURCE column from IEV exports, normalizing references (CEI→IEC, UIT→ITU, etc.) and extracting ref/clause/relationship using extensive regex matching.
-- `TermAttrsParser` — parses the TERMATTRIBUTE field (gender, plurality, part of speech, geographical area, abbreviations).
+- `TermAttrsParser` — parses the TERMATTRIBUTE field (gender, plurality, part of speech, geographical area, usage_info).
 - `SupersessionParser` — parses the REPLACES field for deprecated term relationships.
 - `SubjectAreas` — manages the IEV subject area/section hierarchy. Bundled `data/subject_areas.yaml` contains the area/section tree. URI scheme: `area-{code}` and `section-{code}`.
-- `SubjectAreaConcepts` — builds area and section hierarchy concepts with `ConceptReference.domain()` objects in `ManagedConceptData#domains`, `broader`/`narrower` relations, and `ConceptData#domain` references.
-- `Exporter` — full export pipeline (Excel/SQLite → Glossarist YAML). Assigns domain `ConceptReference` objects via `domain_references_for`.
+- `SubjectAreaConcepts` — builds area and section hierarchy concepts. Uses `ConceptReference` with proper `ref_type` per `ConceptReferenceType`: `"domain"` for thematic area classification, `"section"` for structural section membership. Sets `ConceptData#domain` to area title text.
+- `Exporter` — full export pipeline (Excel/SQLite → Glossarist YAML). Assigns domain and section `ConceptReference` objects via `domain_references_for`. Uses `Glossarist::DatasetRegister` model for `register.yaml`. Sets `schema_version: "3"` on all exported concepts.
 - `Converter::MathmlToAsciimath` — converts MathML markup to AsciiMath using Plurimath.
-- `Utilities` — HTML processing: converts IEV cross-references (`<a href=IEV...>`) to `{{term, IEV:code}}` format, handles figures, images, bold tags, and newline normalization.
+- `Utilities` — HTML processing: converts IEV cross-references (`<a href=IEV...>`) to `{{URN, term}}` format (ID first, display text last), handles figures, images, bold tags, and newline normalization.
+
+### Domain/Section Model
+
+Per the concept model's `ConceptReferenceType`:
+- `"domain"` — thematic/subject-area classification (area level, e.g. "103")
+- `"section"` — structural section membership (section level, e.g. "103-01")
+
+Each concept's `ManagedConceptData#domains` contains both refs. `ConceptData#domain` (a `LocalizedString`) holds the section/area title text. The `ManagedConcept#related` array holds `broader`/`narrower` relationships for the hierarchy tree.
 
 ### Configuration
 
@@ -47,7 +55,11 @@ This is a Ruby gem (`iev`) for working with the International Electrotechnical V
 ## Key Conventions
 
 - Ruby >= 3.1.0 required
+- All constants live under `Iev::` namespace (e.g. `Iev::IEV_SOURCE`, not top-level `IEV_SOURCE`)
+- `Iev.config` / `Iev.configure` / `Iev.reset_config!` are defined directly in `lib/iev.rb` — they must be available at load time without triggering autoload
 - `plurimath` and `unitsml` are optional runtime dependencies — loaded with `rescue LoadError`, so the `DataSource`/`Db` APIs work without them
 - The IEV Excel export format is specific to IEC-internal use; column structure is documented in README.adoc
 - Language codes: the spreadsheet uses ISO 639-1 (2-char like "en"), internally converted to ISO 639-2/3 (3-char like "eng") via `Iso639Code` and `DataConversions`
 - `DataConversions` is a refinement (`using DataConversions`) that adds `.sanitize` and `.decode_html` methods to String
+- `IevCode` is the single source of truth for IEV code decomposition — always use it instead of manual `split("-")` parsing
+- Schema version 3: all exported concepts use `schema_version: "3"`, which supports `annotations`, V3 concept sources, and structured references

data/Gemfile

@@ -2,6 +2,14 @@
 
 source "https://rubygems.org"
 
+# Use local glossarist-ruby when available for development.
+# Otherwise falls back to released gem (requires >= 2.8.2 for tags support).
+if File.directory?(File.expand_path("../glossarist-ruby", __dir__))
+  gem "glossarist", path: "../glossarist-ruby"
+else
+  gem "glossarist", ">= 2.8.2"
+end
+
 gem "benchmark"
 gem "canon"
 gem "openssl"

data/README.adoc

@@ -228,7 +228,7 @@ There are these data types inside the term attribute field. Make sure you split
 We need to parse out all NOTEs and EXAMPLEs and normalize them.
 
 For all `This links to <a href=IEV112-01-01>quantity</a>`, we parse them and replace with:
-`This links to {{quantity, IEV:112-01-01}}`.
+`This links to {{IEV:112-01-01, quantity}}`.
 
 e.g.
 
@@ -300,9 +300,9 @@ notes:
 
 [source,yaml]
 ----
-definition: {{quantity, IEV:112-01-01}} which keeps the same value under particular circumstances, or which results from theoretical considerations
+definition: {{IEV:112-01-01, quantity}} which keeps the same value under particular circumstances, or which results from theoretical considerations
 examples:
-  - {{time constant, IEV:103-05-26}}, equilibrium constant for a chemical reaction, {{fundamental physical constant, IEV:112-03-09}}.
+  - {{IEV:103-05-26, time constant}}, equilibrium constant for a chemical reaction, {{IEV:112-03-09, fundamental physical constant}}.
 ----
 
 
@@ -582,6 +582,10 @@ of columns during export:
 | Derived from `IEVREF`
 | The IEVREF pattern `AAA-BB-CC` is split. Creates two `ConceptReference` objects with `ref_type: "domain"` and `source: "urn:iec:std:iec:60050"` (IEC URN per IEC URN specification): `area-AAA` and `section-AAA-BB`. For example, `103-01-02` produces `area-103` + `section-103-01`.
 
+| `ManagedConceptData#tags`
+| Derived from `IEVREF`
+| Plain string tags for grouping and filtering. Derived from the IEV subject area hierarchy: includes the area title (e.g. `"Mathematics - Functions"`) and section title (e.g. `"General concepts"`).
+
 | `LocalizedConcept#classification`
 | `SYNONYM1STATUS`
 | Maps localized classification values: Chinese/Russian/Spanish `"admitido"` to `"admitted"`, various forms of `"preferred"` similarly; other values lowercased as-is.
@@ -749,6 +753,9 @@ data:
     - concept_id: section-103-01
       source: urn:iec:std:iec:60050
       ref_type: domain
+  tags:
+    - "Mathematics - Functions"
+    - "General concepts"
 ----
 
 The `ref_type: domain` distinguishes domain references from other

data/iev.gemspec

@@ -22,14 +22,15 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = Gem::Requirement.new(">= 3.2.0")
 
   spec.add_dependency "creek", "~> 2.6"
-  spec.add_dependency "glossarist", "~> 2.6", ">= 2.6.7"
   spec.add_dependency "ferrum", "~> 0.15"
+  spec.add_dependency "glossarist", ">= 2.8.2"
+  spec.add_dependency "lutaml-model", "~> 0.8.0"
   spec.add_dependency "nokogiri", "~> 1.19"
   spec.add_dependency "plurimath"
-  spec.add_dependency "lutaml-model", "~> 0.8.0"
   spec.add_dependency "relaton", ">= 2.0.0", "< 3"
   spec.add_dependency "sequel", "~> 5.40"
   spec.add_dependency "sqlite3", "~> 1.7"
   spec.add_dependency "thor", "~> 1.0"
   spec.add_dependency "unitsml"
+  spec.metadata["rubygems_mfa_required"] = "true"
 end

data/lib/iev/cli/command.rb

@@ -142,14 +142,15 @@ module Iev
         summary
       end
 
-      desc "subject_areas", "Fetch IEV subject areas and sections from Electropedia."
+      desc "subject_areas",
+           "Fetch IEV subject areas and sections from Electropedia."
       option :output, desc: "Output YAML file (default: stdout)", aliases: :o
       option :refresh, type: :boolean, default: false,
                        desc: "Force re-fetch even if cached"
       def subject_areas
         if options[:refresh]
           cache_path = File.join(Iev.config.cache_dir, "subject_areas.yaml")
-          FileUtils.rm_f(cache_path) if File.exist?(cache_path)
+          FileUtils.rm_f(cache_path)
         end
 
         result = Iev::SubjectAreas.fetch

data/lib/iev/cli/ui.rb

@@ -12,12 +12,12 @@ module Iev
     module Ui
       module_function
 
-      def debug(*args)
-        Helper.cli_out(:debug, *args)
+      def debug(*)
+        Helper.cli_out(:debug, *)
       end
 
-      def warn(*args)
-        Helper.cli_out(:warn, *args)
+      def warn(*)
+        Helper.cli_out(:warn, *)
       end
 
       # Prints progress message which will be replaced on next call.
@@ -52,7 +52,7 @@ module Iev
 
         def cli_out(level, *args)
           topic = args[0].is_a?(Symbol) ? args.shift : nil
-          message = args.map(&:to_s).join(" ").chomp
+          message = args.join(" ").chomp
           ui_tag = Thread.current[:iev_ui_tag]
 
           return unless should_out?(level, topic)

data/lib/iev/config.rb

@@ -9,23 +9,9 @@ module Iev
     attr_accessor :data_path, :cache_dir, :remote_base_url
 
     def initialize
-      @data_path = ENV["IEV_DATA_PATH"]
+      @data_path = ENV.fetch("IEV_DATA_PATH", nil)
       @cache_dir = ENV["IEV_CACHE_DIR"] || File.join(Dir.tmpdir, "iev-cache")
       @remote_base_url = DEFAULT_REMOTE_BASE_URL
     end
   end
-
-  class << self
-    def config
-      @config ||= Config.new
-    end
-
-    def configure
-      yield(config) if block_given?
-    end
-
-    def reset_config!
-      @config = nil
-    end
-  end
 end

data/lib/iev/data_source.rb

@@ -63,7 +63,8 @@ module Iev
         path = File.join(data_path, "concept-#{code}.yaml")
         return nil unless File.exist?(path)
 
-        YAML.safe_load(File.read(path, encoding: "utf-8"), permitted_classes: [Date, Time])
+        YAML.safe_load(File.read(path, encoding: "utf-8"),
+                       permitted_classes: [Date, Time])
       end
 
       def from_remote(code)
@@ -101,7 +102,8 @@ module Iev
         cache_path = cache_file_path(filename)
         return nil unless File.exist?(cache_path)
 
-        YAML.safe_load(File.read(cache_path, encoding: "utf-8"), permitted_classes: [Date, Time])
+        YAML.safe_load(File.read(cache_path, encoding: "utf-8"),
+                       permitted_classes: [Date, Time])
       end
 
       def write_cache(filename, data)

data/lib/iev/db_writer.rb

@@ -6,6 +6,7 @@
 module Iev
   class DbWriter
     include Cli::Ui
+
     using DataConversions
 
     attr_reader :db

data/lib/iev/exporter.rb

@@ -57,6 +57,7 @@ module Iev
       add_subject_area_concepts(collection) if @include_areas
       build_section_narrower_relations(collection) if @include_areas
       save_collection(collection)
+      save_register
       elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time
 
       @stats = {
@@ -140,11 +141,16 @@ module Iev
         term = TermBuilder.build_from(row)
         next unless term
 
+        # Parse IevCode once per concept — used by all helpers below.
+        code = IevCode.new(term.id)
+
         concept = concept_index[term.id] ||= begin
           c = Glossarist::ManagedConcept.new(data: { "id" => term.id })
           c.uuid = term.id
-          c.data.domains = domain_references_for(term.id)
-          add_section_broader(c, term.id)
+          c.schema_version = "3"
+          c.data.domains = domain_references_for(code)
+          c.data.tags = tags_for(code)
+          add_section_broader(c, code)
           collection.store(c)
           c
         end
@@ -169,34 +175,97 @@ module Iev
       collection.save_grouped_concepts_to_files(concepts_dir.to_s)
     end
 
-    def localized_count(collection)
-      collection.sum { |c| c.localized_concepts.count }
+    def save_register
+      areas = SubjectAreas.all
+      sections = build_section_tree(areas)
+
+      register = Glossarist::DatasetRegister.new(
+        schema_type: "glossarist",
+        schema_version: "3",
+        id: "iev",
+        ref: "IEC 60050:2011",
+        year: 2011,
+        urn: IEV_SOURCE,
+        urn_aliases: ["#{IEV_SOURCE}*"],
+        status: "current",
+        owner: "IEC",
+        source_repo: "https://github.com/glossarist/iev-data",
+        tags: %w[electrotechnical vocabulary iec],
+        languages: %w[eng fra],
+        language_order: %w[eng fra],
+        ordering: "systematic",
+        sections: sections,
+      )
+
+      register_path = output_dir.expand_path.join("register.yaml")
+      FileUtils.mkdir_p(register_path.dirname)
+      File.write(register_path, register.to_yaml, encoding: "utf-8")
+      puts "Written register.yaml with #{sections.length} areas" if $stdout.tty?
     end
 
-    IEV_SOURCE = "urn:iec:std:iec:60050"
+    def build_section_tree(areas)
+      areas.sort_by { |a| a.code.to_i }.map do |area|
+        children = area.sections.sort_by do |s|
+          s.code.split("-").map(&:to_i)
+        end.map do |sec|
+          Glossarist::Section.new(
+            id: sec.code,
+            names: { "eng" => sec.title },
+          )
+        end
 
-    def domain_references_for(ievref)
-      code = IevCode.new(ievref.to_s)
-      refs = []
-      if code.area_code
-        refs << Glossarist::ConceptReference.new(
-          concept_id: code.area_uri,
-          source: IEV_SOURCE,
-          ref_type: "domain",
+        Glossarist::Section.new(
+          id: area.code,
+          names: { "eng" => area.title },
+          children: children.empty? ? nil : children,
         )
       end
+    end
+
+    def localized_count(collection)
+      collection.sum { |c| c.localized_concepts.count }
+    end
+
+    # Build domain ConceptReferences for a concept.
+    #
+    # Per the concept model, ConceptReferenceType distinguishes:
+    #   - "domain"  → thematic/subject-area classification (area level)
+    #   - "section" → structural section membership (section level)
+    #
+    # Every concept gets both: a "domain" ref to its area and a "section"
+    # ref to its section. Concepts with only an area code (no section)
+    # get only a "domain" ref.
+    #
+    # @param code [IevCode] pre-parsed IEV code
+    # @return [Array<Glossarist::ConceptReference>]
+    def domain_references_for(code)
+      refs = []
+
+      # Domain reference: thematic classification at the area level
+      refs << domain_ref(code.area_uri)
+
+      # Section reference: structural membership in the section
       if code.section_code
-        refs << Glossarist::ConceptReference.new(
-          concept_id: code.section_uri,
-          source: IEV_SOURCE,
-          ref_type: "domain",
-        )
+        refs << section_ref(code.section_uri)
       end
+
       refs
     end
 
-    def add_section_broader(concept, ievref)
-      code = IevCode.new(ievref.to_s)
+    # @param code [IevCode] pre-parsed IEV code
+    # @return [Array<String>]
+    def tags_for(code)
+      tags = []
+      area = SubjectAreas.find_area(code.area_code)
+      tags << area.title if area
+      section = code.section_code && SubjectAreas.find_section(code.section_code)
+      tags << section.title if section
+      tags
+    end
+
+    # @param concept [Glossarist::ManagedConcept]
+    # @param code [IevCode] pre-parsed IEV code
+    def add_section_broader(concept, code)
       return unless code.section_uri
 
       concept.related ||= []
@@ -249,7 +318,9 @@ module Iev
 
       concept.related ||= []
       related.each do |r|
-        next if concept.related.any? { |er| er.type == r.type && er.ref&.id == r.ref&.id }
+        next if concept.related.any? do |er|
+          er.type == r.type && er.ref&.id == r.ref&.id
+        end
 
         concept.related << r
       end
@@ -263,5 +334,19 @@ module Iev
       status = term.entry_status
       concept.status = status if status && !status.empty?
     end
+
+    # --- ConceptReference factory helpers ---
+
+    def domain_ref(concept_id)
+      ref = Glossarist::ConceptReference.domain(concept_id)
+      ref.source = IEV_SOURCE
+      ref
+    end
+
+    def section_ref(concept_id)
+      ref = Glossarist::ConceptReference.section(concept_id)
+      ref.source = IEV_SOURCE
+      ref
+    end
   end
 end

data/lib/iev/iso_639_code.rb

@@ -6,7 +6,8 @@
 module Iev
   # @todo This needs to be rewritten.
   class Iso639Code
-    COUNTRY_CODES = YAML.safe_load(IO.read(File.join(__dir__, "iso_639_2.yaml")), permitted_classes: [Symbol]).freeze
+    COUNTRY_CODES = YAML.safe_load_file(File.join(__dir__,
+                                                  "iso_639_2.yaml"), permitted_classes: [Symbol]).freeze
     # rubocop:disable Style/MutableConstant
     THREE_CHAR_MEMO = {} # Memoization cache, must be mutable
     # rubocop:enable Style/MutableConstant

data/lib/iev/relaton_db.rb

@@ -36,7 +36,7 @@ module Iev
       rescue StandardError
         raise unless curr_attempt <= attempts
 
-        sleep(2**curr_attempt * 0.1)
+        sleep((2**curr_attempt) * 0.1)
         curr_attempt += 1
         retry
       end