edoxen 0.3.1 → 0.7.2

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/location.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Venue geography. Multi-venue meetings (e.g., a plenary week with
+  # different hotels) carry one Location per venue.
+  class Location < Lutaml::Model::Serializable
+    attribute :name, :string
+    attribute :address, :string
+    attribute :link, :string
+    attribute :phone, :string
+    attribute :note, :string
+    attribute :lat, :float
+    attribute :lon, :float
+  end
+end

data/lib/edoxen/meeting.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # A single Meeting — the event that produces Resolutions. Carries
+  # identity, time, venue, officers, agenda, schedule, deadlines, and
+  # URN links to one or more ResolutionCollection documents.
+  #
+  # Meetings and ResolutionCollections are kept as separate documents
+  # and joined by URN (Meeting.resolution_refs ↔
+  # ResolutionCollection.metadata.meeting_urn) because they have
+  # different lifetimes: agendas exist weeks before a meeting;
+  # resolutions only after adoption.
+  class Meeting < Lutaml::Model::Serializable
+    attribute :identifier, StructuredIdentifier, collection: true
+    attribute :urn, :string
+    attribute :ordinal, :integer
+    attribute :type, :string, values: Enums::MEETING_TYPE
+    attribute :status, :string, values: Enums::MEETING_STATUS
+    attribute :year, :integer
+
+    attribute :date_range, DateRange
+
+    attribute :committee, :string
+    attribute :committee_group, :string
+
+    attribute :venues, Location, collection: true
+    attribute :general_area, :string
+    attribute :city, :string
+    attribute :country_code, :string
+    attribute :virtual, :boolean
+
+    attribute :chair, Person
+    attribute :secretary, Person
+    attribute :host, :string
+    attribute :hosts, HostRef, collection: true
+
+    attribute :source_urls, SourceUrl, collection: true
+    attribute :landing_url, :string
+    attribute :registration_url, :string
+
+    attribute :agenda, Agenda
+    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
+
+    # Lookup by ISO 639-3 language code. Mirrors Resolution#in_language.
+    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
+
+    # English when available, else the first declared localization.
+    def primary_localization
+      in_language("eng", fallback: true)
+    end
+
+    # Find an agenda item by label. Returns nil when no agenda or no
+    # matching label.
+    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/meeting_collection.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Top-level container for many Meetings. Parallel to
+  # ResolutionCollection.
+  class MeetingCollection < Lutaml::Model::Serializable
+    attribute :metadata, MeetingCollectionMetadata
+    attribute :meetings, Meeting, collection: true
+
+    # Find a meeting by URN. Returns nil when no meeting matches.
+    def find_by_urn(urn)
+      meetings&.find { |m| m.urn == urn.to_s }
+    end
+
+    # Find a meeting by StructuredIdentifier components.
+    # Returns the first meeting whose any identifier matches both
+    # prefix and number.
+    def find_by_identifier(prefix:, number:)
+      meetings&.find do |meeting|
+        meeting.identifier&.any? do |id|
+          id.prefix == prefix.to_s && id.number == number.to_s
+        end
+      end
+    end
+  end
+end

data/lib/edoxen/meeting_collection_metadata.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Top-level wrapper for many Meetings in a single YAML file. Parallel
+  # to ResolutionCollection. The metadata block carries display-level
+  # info (title, source); per-meeting identity lives on each Meeting.
+  class MeetingCollectionMetadata < Lutaml::Model::Serializable
+    attribute :title, :string
+    attribute :source, :string
+  end
+end

data/lib/edoxen/meeting_localization.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Per-language content for a Meeting. Mirrors the glossarist
+  # pattern used by `Localization` for Resolutions: language-agnostic
+  # admin fields live on the parent Meeting; per-language content
+  # lives here.
+  class MeetingLocalization < Lutaml::Model::Serializable
+    attribute :language_code, :string
+    attribute :script, :string
+    attribute :title, :string
+    attribute :general_area, :string
+    attribute :practical_info, :string
+  end
+end

data/lib/edoxen/meeting_relation.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Directed link between two meetings, identified by their
+  # StructuredIdentifier. Reuses the same relation-type vocabulary
+  # pattern as ResolutionRelation.
+  class MeetingRelation < Lutaml::Model::Serializable
+    attribute :source, StructuredIdentifier
+    attribute :destination, StructuredIdentifier
+    attribute :type, :string, values: Enums::MEETING_RELATION_TYPE
+  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/person.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Identity + role + affiliation + contact. Used for meeting officers
+  # (chair, secretary, local contact) and host-ref contacts.
+  class Person < Lutaml::Model::Serializable
+    attribute :name, :string
+    attribute :role, :string
+    attribute :affiliation, :string
+    attribute :email, :string
+    attribute :phone, :string
+    attribute :orcid, :string
+  end
+end

data/lib/edoxen/reference.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # Generic document reference (used by AgendaItem.references). `kind`
+  # is a free-form discriminator (e.g., "standard", "document",
+  # "ballot", "resolution"); the schema leaves it open deliberately so
+  # new reference kinds need no schema change.
+  class Reference < Lutaml::Model::Serializable
+    attribute :ref, :string
+    attribute :kind, :string
+    attribute :title, :string
+  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

@@ -12,5 +12,19 @@ module Edoxen
     attribute :source_urls, SourceUrl, collection: true
     attribute :city, :string
     attribute :country_code, :string
+
+    # URN back-reference to the Meeting that produced this collection.
+    # Join key for the Meeting ↔ ResolutionCollection link. Optional —
+    # 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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Edoxen
+  # 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/source_url.rb

@@ -2,11 +2,15 @@
 
 module Edoxen
   # Per-language canonical source URL (e.g. one PDF per language).
-  # Carries the URL ref, its format, and the ISO 639-3 language_code the URL
-  # is the canonical source for.
+  # Carries the URL ref, its format, the ISO 639-3 language_code the URL
+  # is the canonical source for, and an optional `kind` discriminator
+  # (agenda_pdf, minutes_pdf, resolutions_pdf, ...) used by the Meeting
+  # model. Existing Resolution fixtures without `kind` still parse —
+  # the field is optional.
   class SourceUrl < Lutaml::Model::Serializable
     attribute :ref, :string
     attribute :format, :string
     attribute :language_code, :string
+    attribute :kind, :string, values: Enums::SOURCE_URL_KIND
   end
 end

data/lib/edoxen/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Edoxen
-  VERSION = "0.3.1"
+  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.
@@ -40,7 +41,29 @@ module Edoxen
   autoload :ResolutionMetadata, "edoxen/resolution_metadata"
   autoload :ResolutionCollection, "edoxen/resolution_collection"
 
+  # Meeting / Agenda side. Mirrors edoxen-model/models/meeting*.lutaml.
+  autoload :DateRange, "edoxen/date_range"
+  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"
+  autoload :MeetingCollectionMetadata, "edoxen/meeting_collection_metadata"
+  autoload :MeetingCollection, "edoxen/meeting_collection"
+
   # 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,
@@ -207,6 +207,10 @@ $defs:
       language_code:
         type: string
         pattern: "^[a-z]{3}$"
+      kind:
+        type: string
+        description: "Optional discriminator (agenda_pdf, minutes_pdf, ...)."
+        enum: [agenda_pdf, minutes_pdf, resolutions_pdf, report_pdf, register_url, landing_page]
 
   # ====================================================================
   # Top-level structures.
@@ -285,10 +289,14 @@ $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."
+      meeting_urn:
+        type: string
+        description: "URN back-reference to the Meeting that produced this collection."
 
   # ====================================================================
   # Enums. Each is referenced by its $ref name above. The schema