edoxen 0.5.0 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f82e1428e5307aac53edfd1f1cdcdac401b7bae76b03ab102acf0a0a42da5382
-  data.tar.gz: 13a900902194b1420fb9fe0f9b4fd7382c30f0803770f399c58f3b5053bf763d
+  metadata.gz: 69a86986a86602665699b5598622d32a63658c302737587f68b7a9b095a471e1
+  data.tar.gz: 1201e014ac06c2e4accb00dfd00660f577f6f6464f5d7990553714b796af8314
 SHA512:
-  metadata.gz: a7e099bea2ef576a990544b0d68f527c52e99e617f8f16122f798d16638acc671468859f987d25ca2391fbd62da645e38a3e13c324127cb74a9287cf1e650cdd
-  data.tar.gz: b80c4a49ffc97adacf9871a49de120fad0725c871a2f4a4a4dd31ced9d68fa4ffb4f54c5bd6d5550eefa54b5cbbdd83f779dcc434c366a0cd9740ab6cba63376
+  metadata.gz: 7ec73b629af4dd2997fea614665347177f273569349d0221e414f9dc9b2dbb8f083b3d964675286bb9a76d449a5a4c7c2cf2981db028ebf5f0d2e54249abb77d
+  data.tar.gz: 52534618f6468c4da8effd9bcb23e978487e1857da1a9832fa8d1ed665e72324a13397657b0cb8f6c828be4ef45e9d669781a208b7135c09e97a1b833cc6c69e

data/CLAUDE.md

@@ -4,15 +4,19 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## What this gem is
 
-`edoxen` is an information model for formal resolutions and decisions
-(ISO/TC 154, CIPM, OIML, etc.). It provides:
+`edoxen` is an information model for formal proceedings — meetings,
+agendas, minutes, attendance, votes, and the resolutions adopted by
+standards bodies (ISO/TC 154, CIPM, OIML, etc.). It provides:
 
 - A set of `Lutaml::Model::Serializable` subclasses that mirror the canonical
   LutaML UML model in `../edoxen-model/models/*.lutaml`.
-- A JSON-Schema (`schema/edoxen.yaml`) used to validate real-world YAML
-  files via `SchemaValidator` (`json_schemer`).
-- A Thor CLI (`edoxen validate`, `edoxen normalize`) that wraps both the
-  schema validator and the Ruby model parser.
+- Two JSON-Schemas — `schema/edoxen.yaml` for `ResolutionCollection`
+  and `schema/meeting.yaml` for `Meeting` / `MeetingCollection` — used
+  to validate real-world YAML files via `SchemaValidator`
+  (`json_schemer`).
+- A Thor CLI that wraps both schemas and both model parsers:
+  `edoxen validate` / `edoxen normalize` for resolutions;
+  `edoxen validate-meetings` / `edoxen normalize-meetings` for meetings.
 
 ## Architecture
 

data/Gemfile

@@ -5,6 +5,10 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in edoxen.gemspec
 gemspec
 
+# Pre-release sources. Move to RubyGems once published; the gemspec
+# dep stays as `add_dependency "unlocode", "~> 0.1"` either way.
+gem "unlocodes", github: "metanorma/unlocode"
+
 gem "rake"
 gem "rspec"
 gem "rubocop"

data/README.adoc

@@ -1,26 +1,30 @@
 = Edoxen
 
-https://github.com/metanorma/edoxen[image:https://img.shields.io/github/stars/metanorma/edoxen.svg?style=social[GitHub Stars]]
-image:https://img.shields.io/github/license/metanorma/edoxen.svg[License]
-image:https://img.shields.io/github/actions/workflow/status/metanorma/edoxen/test.yml?branch=main[Build Status]
+https://github.com/edoxen/edoxen[image:https://img.shields.io/github/stars/edoxen/edoxen.svg?style=social[GitHub Stars]]
+image:https://img.shields.io/github/license/edoxen/edoxen.svg[License]
+image:https://img.shields.io/github/actions/workflow/status/edoxen/edoxen/test.yml?branch=main[Build Status]
 image:https://img.shields.io/gem/v/edoxen.svg[RubyGems Version]
 
 == Purpose
 
 Edoxen is a Ruby library for the canonical Edoxen information model of
-formal resolutions and decisions. It is built on top of the
+formal proceedings — meetings, agendas, minutes, attendance, votes,
+and the resolutions adopted by standards bodies and governance
+organisations. It is built on top of the
 https://github.com/lutaml/lutaml[ lutaml-model] serialization framework.
 
 The information model is defined in
-https://github.com/metanorma/edoxen-model/tree/main/models[ LutaML UML
+https://github.com/edoxen/edoxen-model/tree/main/models[ LutaML UML
 files] (one `.lutaml` per concept). This gem mirrors that model exactly —
 attribute declarations, enum values, and field shapes — so that anything
 you can express in LutaML you can also construct, serialize, and validate
 in Ruby.
 
 The intended users are standards organizations and governance bodies that
-need to publish structured records of formal decision-making. Real-world
-samples (ISO/TC 154, CIPM, OIML CIML) ship in `spec/fixtures/`.
+need to publish structured records of formal proceedings — the full
+lifecycle from draft agenda through adopted resolution, in any ISO 639-3
+language. Real-world samples (ISO/TC 154, CIPM, OIML CIML) ship in
+`spec/fixtures/`.
 
 == Installation
 
@@ -228,7 +232,7 @@ MeetingCollection
               ├── date_range: DateRange {start, end}
               ├── committee, committee_group
               ├── venues: Location[]   (multi-venue supported)
-              ├── general_area, city (IATA), country_code (ISO 3166-1), virtual
+              ├── general_area, city (UN/LOCODE, e.g. FRPAR), country_code (ISO 3166-1), virtual
               ├── chair, secretary: Person
               ├── host, hosts: HostRef[]   (typed: national_body/liaison/associate/organizer)
               ├── source_urls: SourceUrl[]   (with `kind` discriminator)

data/TODO.meeting-agenda/02-lutaml-canonical.md

@@ -58,4 +58,4 @@ LUTAML notation, wire names are snake_case per D7.)
 - [ ] `README.adoc` updated: new "Meeting model" section, file index
       extended.
 - [ ] Old `meeting-model.adoc` renamed to `.deprecated`.
-- [ ] Commit + PR to `metanorma/edoxen-model`.
+- [ ] Commit + PR to `edoxen/edoxen-model`.

data/TODO.meeting-agenda/09-verify-and-release.md

@@ -11,8 +11,8 @@ Land everything via PRs. Verify GHA passes. Merge. Bump edoxen minor
 
 | Repo | Branch | PRs against |
 |---|---|---|
-| `metanorma/edoxen-model` | `feat/meeting-agenda-model` | main |
-| `metanorma/edoxen` | `feat/meeting-agenda-model` | main |
+| `edoxen/edoxen-model` | `feat/meeting-agenda-model` | main |
+| `edoxen/edoxen` | `feat/meeting-agenda-model` | main |
 
 Order: edoxen-model first (canonical), then edoxen (mirror).
 
@@ -31,7 +31,7 @@ Per branch, before pushing:
 ## Post-merge
 
 - [ ] Trigger `gh workflow run release.yml --ref main -f next_version=minor`
-      on `metanorma/edoxen`.
+      on `edoxen/edoxen`.
 - [ ] Confirm new version appears on rubygems.org.
 - [ ] Confirm tag `vX.Y.Z` pushed.
 

data/TODO.meeting-agenda/README.md

@@ -25,6 +25,6 @@ work only.
 
 ## Branches
 
-- `metanorma/edoxen-model` ← `feat/meeting-agenda-model` (Phase 2)
-- `metanorma/edoxen` ← `feat/meeting-agenda-model` (Phases 3–8)
+- `edoxen/edoxen-model` ← `feat/meeting-agenda-model` (Phase 2)
+- `edoxen/edoxen` ← `feat/meeting-agenda-model` (Phases 3–8)
 - Phase 9 merges both, then releases `edoxen` as a minor bump.

data/edoxen.gemspec

@@ -39,4 +39,5 @@ Gem::Specification.new do |spec|
   spec.add_dependency "json_schemer", "~> 2.0"
   spec.add_dependency "lutaml-model", "~> 0.7"
   spec.add_dependency "thor", "~> 1.0"
+  spec.add_dependency "unlocodes", "~> 0.1"
 end

data/lib/edoxen/attendance.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # One attendance record per person. Mirrors the ParticipationStatus
+  # enum from edoxen-model/models/participation_status.lutaml.
+  # Optional `affiliation` and `notes` fields let callers annotate
+  # proxy representatives and any meeting-specific details.
+  class Attendance < Lutaml::Model::Serializable
+    attribute :person, Person
+    attribute :status, :string, values: Enums::PARTICIPATION_STATUS
+    attribute :affiliation, :string
+    attribute :proxy_for, Person
+    attribute :notes, :string
+
+    key_value do
+      map "person", to: :person
+      map "status", to: :status
+      map "affiliation", to: :affiliation
+      map "proxy_for", to: :proxy_for
+      map "notes", to: :notes
+    end
+  end
+end

data/lib/edoxen/cli.rb

@@ -166,6 +166,24 @@ module Edoxen
       end
     end
 
+    desc "unlocode CODE", "Resolve a UN/LOCODE via the canonical registry."
+    def unlocode(code)
+      entry = Edoxen::ReferenceData.find_unlocode(code)
+      if entry.nil?
+        say "No entry for #{code.upcase} in the UN/LOCODE registry.", :red
+        exit 1
+      end
+
+      say "UN/LOCODE:  #{entry.code}", :blue
+      say "  Name:      #{entry.name}"
+      say "  Country:   #{entry.country}"
+      say "  Subdiv:    #{entry.subdivision}" if entry.subdivision
+      coords = entry.coordinates
+      say "  Coords:    #{coords}" if coords
+      funcs = entry.functions.compact.map(&:to_s)
+      say "  Functions: #{funcs.join(", ")}" unless funcs.empty?
+    end
+
     private
 
     def meeting_schema_path

data/lib/edoxen/enums.rb

@@ -63,5 +63,12 @@ module Edoxen
     SOURCE_URL_KIND = %w[
       agenda_pdf minutes_pdf resolutions_pdf report_pdf register_url landing_page
     ].freeze
+
+    # P2.6 / P2.7 — Attendance and Vote records.
+    PARTICIPATION_STATUS = %w[present absent apologies observer excused].freeze
+
+    VOTE_TYPE = %w[
+      affirmative negative abstain absent not_applicable
+    ].freeze
   end
 end

data/lib/edoxen/link_checker.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Walks a directory tree of Meeting and ResolutionCollection YAML
+  # files and asserts that every cross-document URN link resolves.
+  #
+  # Invariants enforced:
+  #
+  #   * Every Meeting#urn (if set) is referenced by exactly one
+  #     ResolutionCollection#metadata.meeting_urn (if the collection
+  #     exists in the scanned directory).
+  #   * Every ResolutionCollection#metadata.meeting_urn (if set)
+  #     resolves to a Meeting whose urn matches.
+  #
+  # Use from CLI / scripts via the public `check` class method. Returns
+  # an array of `LinkError` records (empty = ok).
+  #
+  # All file IO is read-only. No edits to the YAMLs.
+  class LinkChecker
+    LinkError = Struct.new(:file, :pointer, :urn, :kind) do
+      def message
+        "#{file}: #{pointer} references #{urn} (#{kind})"
+      end
+    end
+
+    # Walk `dir` (recursive scan of *.yaml and *.yml), classify each
+    # file as Meeting or ResolutionCollection, and assert every
+    # cross-document URN resolves to a real record.
+    #
+    # @return [Array<LinkError>] empty when all links resolve.
+    def self.check(dir)
+      new(dir).check
+    end
+
+    def initialize(dir)
+      @dir = dir
+      @meetings_by_urn = {} # urn → file
+      @collections_by_meeting_urn = {} # meeting_urn → file
+    end
+
+    def check
+      require "yaml"
+
+      Dir.glob(File.join(@dir, "**", "*.{yaml,yml}")).sort.each do |file|
+        data = safe_load_yaml(file)
+        next unless data.is_a?(Hash)
+
+        if meeting_shape?(data)
+          urn = data["urn"]
+          @meetings_by_urn[urn] = file if urn
+        elsif collection_shape?(data)
+          meeting_urn = data.dig("metadata", "meeting_urn")
+          @collections_by_meeting_urn[meeting_urn] = file if meeting_urn
+        end
+      end
+
+      errors = []
+
+      # ResolutionCollection → Meeting
+      @collections_by_meeting_urn.each do |meeting_urn, file|
+        next if @meetings_by_urn.key?(meeting_urn)
+
+        errors << LinkError.new(file, "metadata.meeting_urn", meeting_urn, "no matching Meeting")
+      end
+
+      errors
+    end
+
+    private
+
+    def safe_load_yaml(file)
+      YAML.safe_load(File.read(file))
+    rescue Psych::SyntaxError, ArgumentError
+      nil
+    end
+
+    def meeting_shape?(data)
+      data["identifier"].is_a?(Array) && data.key?("type")
+    end
+
+    def collection_shape?(data)
+      data["resolutions"].is_a?(Array) || data["metadata"].is_a?(Hash)
+    end
+  end
+end

data/lib/edoxen/meeting.rb

@@ -42,6 +42,10 @@ module Edoxen
     attribute :schedule, ScheduleItem, collection: true
     attribute :deadlines, Deadline, collection: true
 
+    attribute :attendance, Attendance, collection: true
+    attribute :vote_records, VoteRecord, collection: true
+    attribute :minutes, Minutes, collection: true
+
     attribute :localizations, MeetingLocalization, collection: true
     attribute :relations, MeetingRelation, collection: true
     attribute :resolution_refs, :string, collection: true
@@ -64,5 +68,15 @@ module Edoxen
     def find_agenda_item(label)
       agenda&.find_item(label)
     end
+
+    # Resolve the meeting's UN/LOCODE via the canonical `unlocode` gem
+    # registry. Returns an `Unlocodes::Entry` (with `#name`, `#country`,
+    # `#coordinates`, `#iata`, `#functions`, etc.) or nil when the
+    # city field is empty / not in the registry.
+    def city_entry
+      return nil if city.nil? || city.to_s.empty?
+
+      Edoxen::ReferenceData.find_unlocode(city)
+    end
   end
 end

data/lib/edoxen/minutes.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # The narrative record of a Meeting — what was said, by whom, in
+  # what order, with what outcome. Mirrors
+  # edoxen-model/models/minutes.lutaml (P2.8 from
+  # TODO.meeting-agenda/10-future-enhancements.md).
+  #
+  # Distinct from Agenda (the business order drafted before the
+  # meeting) and from ResolutionCollection (the formal decisions
+  # adopted). The Minutes are the running record.
+  #
+  # Sections are typically keyed by agenda-item number so consumers
+  # can join Minutes ↔ AgendaItem ↔ Resolution by `number`/`label`.
+  class Minutes < Lutaml::Model::Serializable
+    attribute :identifier, StructuredIdentifier, collection: true
+    attribute :urn, :string
+    attribute :language_code, :string
+    attribute :script, :string
+    attribute :source_doc, :string
+    attribute :source_pages, :string
+    attribute :sections, MinutesSection, collection: true
+
+    def find_section(number)
+      return nil if number.nil?
+
+      target = number.to_s
+      sections&.find { |s| s.number.to_s == target }
+    end
+  end
+end

data/lib/edoxen/minutes_section.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # One section of a Meeting's minutes — typically tied to an agenda
+  # item by its `number` field. Carries the narrative as Markdown
+  # (the format the GLM-OCR pipeline emits) plus optional page range
+  # for provenance back to the source PDF.
+  class MinutesSection < Lutaml::Model::Serializable
+    attribute :number, :string
+    attribute :title, :string
+    attribute :narrative, :string
+    attribute :page_start, :integer
+    attribute :page_end, :integer
+    attribute :references, Reference, collection: true
+
+    def in_language(code, fallback: false)
+      match = localizations&.find { |loc| loc.language_code == code.to_s }
+      return match if match
+
+      fallback ? localizations&.first : nil
+    end
+
+    def primary_localization
+      in_language("eng", fallback: true)
+    end
+  end
+end

data/lib/edoxen/reference_data.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Built-in reference data for ISO codes used across the Edoxen model:
+  # ISO 3166-1 alpha-2 country codes, ISO 639-3 language codes, ISO
+  # 15924 script codes, and UN/LOCODEs.
+  #
+  # UN/LOCODE lookups delegate to the `unlocode` gem (the canonical
+  # Ruby registry of the UNECE UN/LOCODE dataset). The frozen
+  # ReferenceData::UNLOCODES list stays as a curated offline subset
+  # — used by specs and consumers that don't want to load the full
+  # ~100k-entry registry.
+  #
+  # Reference data sources:
+  # * https://www.iso.org/iso-3166-country-codes.html
+  # * https://iso639-3.sil.org/
+  # * https://unicode.org/iso15924/
+  # * https://unece.org/trade/cefact/unlocode-code-list-country-and-territory
+  #
+  # UN/LOCODE format: 2-letter ISO 3166-1 country code + 3-character
+  # location alphanumeric (e.g., FRPAR = Paris, France; HKHKG = Hong
+  # Kong; THCNM = Chiang Mai). UN-maintained, supersedes the
+  # airport-centric IATA city codes edoxen previously used.
+  module ReferenceData
+    # Hard require the unlocode gem. It's a declared runtime dep, so a
+    # clean install of edoxen brings it in. The bundled dataset ships
+    # 4 sample entries; full coverage requires `rake unlocodes:fetch`
+    # from the unlocode gem.
+    require "unlocodes"
+
+    # ISO 3166-1 alpha-2 — countries ISO/TC 154 / OIML / BIPM operate in.
+    # Two-letter uppercase.
+    COUNTRY_CODES = %w[
+      AE AF AR AT AU BE BG BR BY CA CH CL CN CO CY CZ DE DK EE ES FI FR
+      GB GR HK HR HU ID IE IL IN IS IT JP KE KR LK LT LU LV MT MX MY NL NO PH
+      NZ PL PT RO RS RU SA SE SG SI SK TH TN TR TW UA US VN ZA
+    ].freeze
+
+    # ISO 639-3 — languages actually used in the edoxen fixtures
+    # (eng + fra in OIML, plus the ISO official languages).
+    # Three-letter lowercase.
+    LANGUAGE_CODES = %w[
+      ara chi deu eng fra jpn rus spa zho
+    ].freeze
+
+    # ISO 15924 — scripts. Latn + Cyrl + Hant + Hans cover every script
+    # ISO and OIML resolutions are written in.
+    SCRIPT_CODES = %w[
+      Arab Cyrl Hans Hant Hang Hebr Jpan Kore Latn
+    ].freeze
+
+    # Curated offline subset of UN/LOCODEs — the cities ISO/TC 154 and
+    # OIML actually meet in plus the major transit hubs. Used by specs
+    # and consumers that don't want to load the full registry. For
+    # arbitrary lookups, use {find_unlocode}.
+    UNLOCODES = %w[
+      AUMEL ATVIE BEBRU BGSOF BRBSB CHGVA CNCAN CNHKG CNSHA CNXSZ COCTG
+      CYLCA CZPRG DEBER DEHAM DEFRA DKCPH ESMAD FIHEL FRARC FRLYS FRMRS
+      FRPAR GBLON HKHKG HUBUD IDJKT IEDUB IEORK ILTLV INDEL ISREY ITROM
+      JPTYO KEMBA KRSEL LKCMB LVRIX LULUX MYKUL NLRTM NOOSL NZAKL PHMNL
+      PLWAW PTLIS ROBUH RSBEG SESTO SGSIN SKBTS THBKK THCNM TRIST TWTPE
+      UAIEV USMIA USNYC USORL VNSGN ZACPT
+    ].freeze
+
+    # @deprecated Use {UNLOCODES}. Retained for one release to ease
+    # migration; will be removed in the next minor.
+    CITY_CODES = UNLOCODES
+
+    class << self
+      # Look up a UN/LOCODE entry via the canonical `unlocode` gem.
+      # Returns an `Unlocodes::Entry` (with `#name`, `#country`,
+      # `#coordinates`, `#iata`, `#functions`, etc.) or nil when the
+      # code is not in the registry.
+      #
+      # Requires the full UN/LOCODE dataset to be loaded. The gem
+      # ships a 4-entry sample by default; run `rake unlocodes:fetch`
+      # from the unlocode gem to populate the full ~100k-entry
+      # registry.
+      #
+      # @param code [String, #to_s] 5-character UN/LOCODE
+      # @return [Unlocodes::Entry, nil]
+      def find_unlocode(code)
+        Unlocodes.find(code.to_s.upcase)
+      end
+
+      # True when the code resolves to a real UN/LOCODE entry via the
+      # canonical registry. Use this when validating user-supplied
+      # city codes; use the schema's pattern check for cheap shape
+      # validation.
+      def unlocode_exists?(code)
+        !find_unlocode(code).nil?
+      end
+    end
+  end
+end

data/lib/edoxen/resolution_metadata.rb

@@ -18,5 +18,13 @@ module Edoxen
     # collections without a parent meeting (e.g., ad-hoc resolution
     # sets) simply omit it.
     attribute :meeting_urn, :string
+
+    # Resolve the collection's host-city UN/LOCODE via the canonical
+    # `unlocode` gem registry. Returns an `Unlocodes::Entry` or nil.
+    def city_entry
+      return nil if city.nil? || city.to_s.empty?
+
+      Edoxen::ReferenceData.find_unlocode(city)
+    end
   end
 end

data/lib/edoxen/schedule_item.rb

@@ -1,16 +1,27 @@
 # frozen_string_literal: true
 
 module Edoxen
-  # One entry in a meeting timetable. Structural fields (date, time,
-  # room) are language-agnostic; descriptive fields (event,
-  # description) live here as plain strings in v1 — see
-  # TODO.meeting-agenda/10-future-enhancements.md P2.1 for per-item
-  # localization.
+  # One entry in the meeting timetable. Structural fields (date, time,
+  # room) are language-agnostic; per-language content (event name,
+  # description) lives in `localizations[]`. Mirrors the glossarist
+  # LocalizedConcept pattern.
   class ScheduleItem < Lutaml::Model::Serializable
     attribute :date, :date
     attribute :time, :string
     attribute :event, :string
     attribute :description, :string
     attribute :room, :string
+    attribute :localizations, ScheduleItemLocalization, collection: true
+
+    def in_language(code, fallback: false)
+      match = localizations&.find { |loc| loc.language_code == code.to_s }
+      return match if match
+
+      fallback ? localizations&.first : nil
+    end
+
+    def primary_localization
+      in_language("eng", fallback: true)
+    end
   end
 end

data/lib/edoxen/schedule_item_localization.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Per-language content for a ScheduleItem. Mirrors the glossarist
+  # LocalizedConcept pattern: structural fields (date, time, room) live
+  # on the parent ScheduleItem; per-language content (event name,
+  # description) lives here.
+  class ScheduleItemLocalization < Lutaml::Model::Serializable
+    attribute :language_code, :string
+    attribute :script, :string
+    attribute :event, :string
+    attribute :description, :string
+
+    key_value do
+      map "language_code", to: :language_code
+      map "script", to: :script
+      map "event", to: :event
+      map "description", to: :description
+    end
+  end
+end

data/lib/edoxen/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Edoxen
-  VERSION = "0.5.0"
+  VERSION = "0.7.2"
 end

data/lib/edoxen/vote_record.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # A single vote on a Resolution, recorded against the meeting at
+  # which the vote was taken. Mirrors
+  # edoxen-model/models/vote_record.lutaml. Each record carries the
+  # person, their affiliation (national body / liaison / committee),
+  # and the outcome (affirmative / negative / abstain / absent /
+  # not_applicable).
+  class VoteRecord < Lutaml::Model::Serializable
+    attribute :resolution_ref, :string
+    attribute :person, Person
+    attribute :affiliation, :string
+    attribute :vote, :string, values: Enums::VOTE_TYPE
+    attribute :notes, :string
+
+    key_value do
+      map "resolution_ref", to: :resolution_ref
+      map "person", to: :person
+      map "affiliation", to: :affiliation
+      map "vote", to: :vote
+      map "notes", to: :notes
+    end
+  end
+end

data/lib/edoxen.rb

@@ -23,6 +23,7 @@ module Edoxen
   autoload :Error, "edoxen/error"
   autoload :ValidationError, "edoxen/error"
   autoload :Enums, "edoxen/enums"
+  autoload :ReferenceData, "edoxen/reference_data"
 
   # Information-model classes (one per file, one concept per class).
   # Names mirror ../edoxen-model/models/*.lutaml.
@@ -45,11 +46,16 @@ module Edoxen
   autoload :Location, "edoxen/location"
   autoload :Person, "edoxen/person"
   autoload :HostRef, "edoxen/host_ref"
+  autoload :ScheduleItemLocalization, "edoxen/schedule_item_localization"
   autoload :ScheduleItem, "edoxen/schedule_item"
   autoload :Deadline, "edoxen/deadline"
   autoload :Reference, "edoxen/reference"
   autoload :AgendaItem, "edoxen/agenda_item"
   autoload :Agenda, "edoxen/agenda"
+  autoload :Attendance, "edoxen/attendance"
+  autoload :VoteRecord, "edoxen/vote_record"
+  autoload :MinutesSection, "edoxen/minutes_section"
+  autoload :Minutes, "edoxen/minutes"
   autoload :MeetingRelation, "edoxen/meeting_relation"
   autoload :MeetingLocalization, "edoxen/meeting_localization"
   autoload :Meeting, "edoxen/meeting"
@@ -58,5 +64,6 @@ module Edoxen
 
   # Services.
   autoload :SchemaValidator, "edoxen/schema_validator"
+  autoload :LinkChecker, "edoxen/link_checker"
   autoload :Cli, "edoxen/cli"
 end

data/schema/edoxen.yaml

@@ -1,12 +1,12 @@
 ---
 $schema: "http://json-schema.org/draft-07/schema#"
-$id: "https://github.com/metanorma/edoxen/schema/edoxen.yaml"
+$id: "https://github.com/edoxen/edoxen/schema/edoxen.yaml"
 title: "Edoxen Resolution Collection Schema"
 description: |
   Schema for validating Edoxen ResolutionCollection YAML files.
 
   Mirrors the canonical LutaML information model in
-  https://github.com/metanorma/edoxen-model/tree/main/models .
+  https://github.com/edoxen/edoxen-model/tree/main/models .
 
   The enum constants declared under `$defs` (ActionType,
   ConsiderationType, ApprovalType, ApprovalDegree, ResolutionType,
@@ -289,7 +289,8 @@ $defs:
         description: "Canonical URLs to the source PDFs in each available language."
       city:
         type: string
-        description: "IATA city code (3-letter, e.g. BER, CPT, PAR) of the host city."
+        pattern: "^[A-Z]{2}[A-Z0-9]{3}$"
+        description: "UN/LOCODE of the host city (5-char: 2-letter ISO 3166-1 country + 3-char location, e.g. FRPAR, CNSHA, HKHKG). Supersedes the IATA city code."
       country_code:
         type: string
         description: "ISO 3166-1 alpha-2 country code (2-letter, e.g. DE, FR, JP) of the host country."

data/schema/meeting.yaml

@@ -1,12 +1,12 @@
 ---
 $schema: "http://json-schema.org/draft-07/schema#"
-$id: "https://github.com/metanorma/edoxen/schema/meeting.yaml"
+$id: "https://github.com/edoxen/edoxen/schema/meeting.yaml"
 title: "Edoxen Meeting Schema"
 description: |
   Schema for validating Edoxen Meeting/Agenda YAML files.
 
   Mirrors the canonical LutaML information model in
-  https://github.com/metanorma/edoxen-model/tree/main/models (meeting*.lutaml,
+  https://github.com/edoxen/edoxen-model/tree/main/models (meeting*.lutaml,
   agenda*.lutaml, etc.).
 
   The root accepts either a single Meeting or a MeetingCollection.
@@ -104,6 +104,21 @@ $defs:
       contact:
         $ref: "#/$defs/Person"
 
+  ScheduleItemLocalization:
+    type: object
+    description: "Per-language content for a ScheduleItem."
+    additionalProperties: false
+    required: [language_code]
+    properties:
+      language_code:
+        type: string
+        pattern: "^[a-z]{3}$"
+      script:
+        type: string
+        pattern: "^[A-Z][a-z]{3}$"
+      event:       { type: string }
+      description: { type: string }
+
   ScheduleItem:
     type: object
     description: "One entry in the meeting timetable."
@@ -116,6 +131,88 @@ $defs:
       event:       { type: string }
       description: { type: string }
       room:        { type: string }
+      localizations:
+        type: array
+        items:
+          $ref: "#/$defs/ScheduleItemLocalization"
+
+  Attendance:
+    type: object
+    description: "One attendance record per person at a Meeting."
+    additionalProperties: false
+    required: [person, status]
+    properties:
+      person:
+        $ref: "#/$defs/Person"
+      status:
+        $ref: "#/$defs/ParticipationStatus"
+      affiliation: { type: string }
+      proxy_for:
+        $ref: "#/$defs/Person"
+      notes: { type: string }
+
+  VoteRecord:
+    type: object
+    description: "One vote by one person on one resolution at one meeting."
+    additionalProperties: false
+    required: [resolution_ref, person, vote]
+    properties:
+      resolution_ref: { type: string }
+      person:
+        $ref: "#/$defs/Person"
+      affiliation: { type: string }
+      vote:
+        $ref: "#/$defs/VoteType"
+      notes: { type: string }
+
+  MinutesSection:
+    type: object
+    description: |
+      One section of a Meeting's minutes — typically tied to an agenda
+      item by its `number` field. Carries the narrative as Markdown
+      (the format the GLM-OCR pipeline emits) plus an optional page
+      range for provenance back to the source PDF.
+    additionalProperties: false
+    properties:
+      number:      { type: string }
+      title:       { type: string }
+      narrative:   { type: string }
+      page_start:  { type: integer }
+      page_end:    { type: integer }
+      references:
+        type: array
+        items:
+          $ref: "#/$defs/Reference"
+
+  Minutes:
+    type: object
+    description: |
+      The narrative record of a Meeting — what was said, by whom, in
+      what order, with what outcome. Distinct from Agenda (the business
+      order drafted before the meeting) and from ResolutionCollection
+      (the formal decisions adopted). The Minutes are the running
+      record. One Minutes document per language; sections are typically
+      keyed by agenda-item number so consumers can join
+      Minutes ↔ AgendaItem ↔ Resolution.
+    additionalProperties: false
+    properties:
+      identifier:
+        type: array
+        items:
+          $ref: "#/$defs/StructuredIdentifier"
+      urn:           { type: string }
+      language_code:
+        type: string
+        pattern: "^[a-z]{3}$"
+      script:
+        type: string
+        pattern: "^[A-Z][a-z]{3}$"
+      source_doc:    { type: string }
+      source_pages:  { type: string }
+      sections:
+        type: array
+        items:
+          $ref: "#/$defs/MinutesSection"
 
   Deadline:
     type: object
@@ -247,7 +344,10 @@ $defs:
         items:
           $ref: "#/$defs/Location"
       general_area:    { type: string }
-      city:            { type: string }
+      city:
+        type: string
+        pattern: "^[A-Z]{2}[A-Z0-9]{3}$"
+        description: "UN/LOCODE of the host city (5-char: 2-letter ISO 3166-1 country + 3-char location, e.g. FRPAR, HKHKG, THCNM)."
       country_code:
         type: string
         pattern: "^[A-Z]{2}$"
@@ -278,6 +378,18 @@ $defs:
         type: array
         items:
           $ref: "#/$defs/Deadline"
+      attendance:
+        type: array
+        items:
+          $ref: "#/$defs/Attendance"
+      vote_records:
+        type: array
+        items:
+          $ref: "#/$defs/VoteRecord"
+      minutes:
+        type: array
+        items:
+          $ref: "#/$defs/Minutes"
 
       localizations:
         type: array
@@ -356,3 +468,13 @@ $defs:
     type: string
     description: "Edoxen::Enums::SOURCE_URL_KIND."
     enum: [agenda_pdf, minutes_pdf, resolutions_pdf, report_pdf, register_url, landing_page]
+
+  ParticipationStatus:
+    type: string
+    description: "Edoxen::Enums::PARTICIPATION_STATUS."
+    enum: [present, absent, apologies, observer, excused]
+
+  VoteType:
+    type: string
+    description: "Edoxen::Enums::VOTE_TYPE."
+    enum: [affirmative, negative, abstain, absent, not_applicable]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: edoxen
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-01 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json_schemer
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: unlocodes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 description: |
   Edoxen provides a Ruby library for working with resolution models, allowing
   users to create, manipulate, and serialize resolution data in a structured
@@ -92,6 +106,7 @@ files:
 - lib/edoxen/agenda.rb
 - lib/edoxen/agenda_item.rb
 - lib/edoxen/approval.rb
+- lib/edoxen/attendance.rb
 - lib/edoxen/cli.rb
 - lib/edoxen/consideration.rb
 - lib/edoxen/date_range.rb
@@ -99,6 +114,7 @@ files:
 - lib/edoxen/enums.rb
 - lib/edoxen/error.rb
 - lib/edoxen/host_ref.rb
+- lib/edoxen/link_checker.rb
 - lib/edoxen/localization.rb
 - lib/edoxen/location.rb
 - lib/edoxen/meeting.rb
@@ -107,8 +123,11 @@ files:
 - lib/edoxen/meeting_identifier.rb
 - lib/edoxen/meeting_localization.rb
 - lib/edoxen/meeting_relation.rb
+- lib/edoxen/minutes.rb
+- lib/edoxen/minutes_section.rb
 - lib/edoxen/person.rb
 - lib/edoxen/reference.rb
+- lib/edoxen/reference_data.rb
 - lib/edoxen/resolution.rb
 - lib/edoxen/resolution_collection.rb
 - lib/edoxen/resolution_date.rb
@@ -116,11 +135,13 @@ files:
 - lib/edoxen/resolution_relation.rb
 - lib/edoxen/resolution_set.rb
 - lib/edoxen/schedule_item.rb
+- lib/edoxen/schedule_item_localization.rb
 - lib/edoxen/schema_validator.rb
 - lib/edoxen/source_url.rb
 - lib/edoxen/structured_identifier.rb
 - lib/edoxen/url.rb
 - lib/edoxen/version.rb
+- lib/edoxen/vote_record.rb
 - schema/edoxen.yaml
 - schema/meeting.yaml
 - sig/edoxen.rbs