edoxen 0.3.1 → 0.5.0

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.5.0"
 end

data/lib/edoxen.rb

@@ -40,6 +40,22 @@ 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 :ScheduleItem, "edoxen/schedule_item"
+  autoload :Deadline, "edoxen/deadline"
+  autoload :Reference, "edoxen/reference"
+  autoload :AgendaItem, "edoxen/agenda_item"
+  autoload :Agenda, "edoxen/agenda"
+  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 :Cli, "edoxen/cli"

data/schema/edoxen.yaml

@@ -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.
@@ -289,6 +293,9 @@ $defs:
       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

data/schema/meeting.yaml

@@ -0,0 +1,358 @@
+---
+$schema: "http://json-schema.org/draft-07/schema#"
+$id: "https://github.com/metanorma/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,
+  agenda*.lutaml, etc.).
+
+  The root accepts either a single Meeting or a MeetingCollection.
+
+  Enum lists in this schema are kept in lockstep with
+  Edoxen::Enums::* (Meeting side) by
+  `spec/edoxen/schema_meeting_enum_sync_spec.rb`.
+type: object
+oneOf:
+  - $ref: "#/$defs/MeetingCollection"
+  - $ref: "#/$defs/Meeting"
+
+$defs:
+
+  # ====================================================================
+  # Reused from schema/edoxen.yaml (re-declared here so this file is
+  # self-contained — schema/meeting.yaml does not depend on
+  # schema/edoxen.yaml).
+  # ====================================================================
+
+  StructuredIdentifier:
+    type: object
+    description: "prefix + number identifier. A Meeting carries 1..*."
+    additionalProperties: false
+    required: [prefix, number]
+    properties:
+      prefix: { type: string }
+      number: { type: string }
+
+  SourceUrl:
+    type: object
+    description: "Per-language canonical source URL (PDF, page, register link)."
+    additionalProperties: false
+    required: [ref]
+    properties:
+      ref:          { type: string }
+      format:       { type: string }
+      language_code:
+        type: string
+        pattern: "^[a-z]{3}$"
+      kind:
+        $ref: "#/$defs/SourceUrlKind"
+
+  # ====================================================================
+  # Meeting-side primitive types.
+  # ====================================================================
+
+  DateRange:
+    type: object
+    description: "Start + end date pair for multi-day meetings."
+    additionalProperties: false
+    properties:
+      start:
+        type: string
+        format: date
+      end:
+        type: string
+        format: date
+
+  Location:
+    type: object
+    description: "Venue geography. Multi-venue meetings carry one Location per venue."
+    additionalProperties: false
+    properties:
+      name:    { type: string }
+      address: { type: string }
+      link:    { type: string }
+      phone:   { type: string }
+      note:    { type: string }
+      lat:     { type: number }
+      lon:     { type: number }
+
+  Person:
+    type: object
+    description: "Identity + role + affiliation + contact."
+    additionalProperties: false
+    properties:
+      name:        { type: string }
+      role:        { type: string }
+      affiliation: { type: string }
+      email:       { type: string }
+      phone:       { type: string }
+      orcid:       { type: string }
+
+  HostRef:
+    type: object
+    description: "Typed reference to an organization that hosts or co-organizes a meeting."
+    additionalProperties: false
+    required: [ref]
+    properties:
+      ref:    { type: string }
+      type:
+        $ref: "#/$defs/HostType"
+      role:   { type: string }
+      contact:
+        $ref: "#/$defs/Person"
+
+  ScheduleItem:
+    type: object
+    description: "One entry in the meeting timetable."
+    additionalProperties: false
+    properties:
+      date:
+        type: string
+        format: date
+      time:        { type: string }
+      event:       { type: string }
+      description: { type: string }
+      room:        { type: string }
+
+  Deadline:
+    type: object
+    description: "A time-bound requirement (registration, submission, etc.)."
+    additionalProperties: false
+    required: [date]
+    properties:
+      date:
+        type: string
+        format: date
+      description: { type: string }
+
+  Reference:
+    type: object
+    description: "Generic document reference (used by AgendaItem.references)."
+    additionalProperties: false
+    properties:
+      ref:   { type: string }
+      kind:  { type: string }
+      title: { type: string }
+
+  # ====================================================================
+  # Agenda side.
+  # ====================================================================
+
+  AgendaItem:
+    type: object
+    description: "One entry on an Agenda."
+    additionalProperties: false
+    properties:
+      label:       { type: string }
+      kind:
+        $ref: "#/$defs/AgendaItemKind"
+      title:       { type: string }
+      description: { type: string }
+      references:
+        type: array
+        items:
+          $ref: "#/$defs/Reference"
+      outcome:
+        $ref: "#/$defs/AgendaItemOutcome"
+      resolution_ref:
+        type: string
+        description: "URN of the resolution this item produced."
+
+  Agenda:
+    type: object
+    description: |
+      The business-order document of a Meeting. Versioned independently
+      of the Meeting via the `status` field (draft, final, amended).
+    additionalProperties: false
+    properties:
+      identifier:
+        type: array
+        items:
+          $ref: "#/$defs/StructuredIdentifier"
+      status:
+        $ref: "#/$defs/AgendaStatus"
+      source_doc: { type: string }
+      items:
+        type: array
+        items:
+          $ref: "#/$defs/AgendaItem"
+      opening_session:
+        $ref: "#/$defs/ScheduleItem"
+      closing_session:
+        $ref: "#/$defs/ScheduleItem"
+
+  # ====================================================================
+  # Meeting side.
+  # ====================================================================
+
+  MeetingRelation:
+    type: object
+    description: "Directed link between two meetings."
+    additionalProperties: false
+    required: [source, destination, type]
+    properties:
+      source:
+        $ref: "#/$defs/StructuredIdentifier"
+      destination:
+        $ref: "#/$defs/StructuredIdentifier"
+      type:
+        $ref: "#/$defs/MeetingRelationType"
+
+  MeetingLocalization:
+    type: object
+    description: "Per-language content for a Meeting."
+    additionalProperties: false
+    required: [language_code]
+    properties:
+      language_code:
+        type: string
+        pattern: "^[a-z]{3}$"
+      script:
+        type: string
+        pattern: "^[A-Z][a-z]{3}$"
+      title:          { type: string }
+      general_area:   { type: string }
+      practical_info: { type: string }
+
+  Meeting:
+    type: object
+    description: "A single Meeting (event)."
+    additionalProperties: false
+    required: [identifier, type]
+    properties:
+      identifier:
+        type: array
+        minItems: 1
+        items:
+          $ref: "#/$defs/StructuredIdentifier"
+      urn:        { type: string }
+      ordinal:    { type: integer }
+      type:
+        $ref: "#/$defs/MeetingType"
+      status:
+        $ref: "#/$defs/MeetingStatus"
+      year:       { type: integer }
+
+      date_range:
+        $ref: "#/$defs/DateRange"
+
+      committee:       { type: string }
+      committee_group: { type: string }
+
+      venues:
+        type: array
+        items:
+          $ref: "#/$defs/Location"
+      general_area:    { type: string }
+      city:            { type: string }
+      country_code:
+        type: string
+        pattern: "^[A-Z]{2}$"
+      virtual:         { type: boolean }
+
+      chair:     { $ref: "#/$defs/Person" }
+      secretary: { $ref: "#/$defs/Person" }
+      host:      { type: string }
+      hosts:
+        type: array
+        items:
+          $ref: "#/$defs/HostRef"
+
+      source_urls:
+        type: array
+        items:
+          $ref: "#/$defs/SourceUrl"
+      landing_url:      { type: string }
+      registration_url: { type: string }
+
+      agenda:
+        $ref: "#/$defs/Agenda"
+      schedule:
+        type: array
+        items:
+          $ref: "#/$defs/ScheduleItem"
+      deadlines:
+        type: array
+        items:
+          $ref: "#/$defs/Deadline"
+
+      localizations:
+        type: array
+        items:
+          $ref: "#/$defs/MeetingLocalization"
+      relations:
+        type: array
+        items:
+          $ref: "#/$defs/MeetingRelation"
+      resolution_refs:
+        type: array
+        items: { type: string }
+
+  MeetingCollectionMetadata:
+    type: object
+    description: "Display-level metadata for a MeetingCollection."
+    additionalProperties: false
+    properties:
+      title:  { type: string }
+      source: { type: string }
+
+  MeetingCollection:
+    type: object
+    description: "Top-level wrapper for many Meetings in one file."
+    additionalProperties: false
+    required: [meetings]
+    properties:
+      metadata:
+        $ref: "#/$defs/MeetingCollectionMetadata"
+      meetings:
+        type: array
+        items:
+          $ref: "#/$defs/Meeting"
+
+  # ====================================================================
+  # Enums. Each value-list must equal the matching Edoxen::Enums::*
+  # frozen array; spec/edoxen/schema_meeting_enum_sync_spec.rb enforces.
+  # ====================================================================
+
+  MeetingType:
+    type: string
+    description: "Edoxen::Enums::MEETING_TYPE."
+    enum: [plenary, working_group, task_group, ad_hoc, joint, conference_session]
+
+  MeetingStatus:
+    type: string
+    description: "Edoxen::Enums::MEETING_STATUS."
+    enum: [upcoming, completed, cancelled]
+
+  AgendaStatus:
+    type: string
+    description: "Edoxen::Enums::AGENDA_STATUS."
+    enum: [draft, final, amended, cancelled, superseded]
+
+  AgendaItemKind:
+    type: string
+    description: "Edoxen::Enums::AGENDA_ITEM_KIND."
+    enum: [numbered, unnumbered, header, opening, closing]
+
+  AgendaItemOutcome:
+    type: string
+    description: "Edoxen::Enums::AGENDA_ITEM_OUTCOME."
+    enum: [discussed, resolved, deferred, adopted, withdrawn]
+
+  HostType:
+    type: string
+    description: "Edoxen::Enums::HOST_TYPE."
+    enum: [national_body, liaison, associate, organizer]
+
+  MeetingRelationType:
+    type: string
+    description: "Edoxen::Enums::MEETING_RELATION_TYPE."
+    enum: [continues_from, continues_to, joint_with, supersedes, superseded_by, rescheduled_from, rescheduled_to]
+
+  SourceUrlKind:
+    type: string
+    description: "Edoxen::Enums::SOURCE_URL_KIND."
+    enum: [agenda_pdf, minutes_pdf, resolutions_pdf, report_pdf, register_url, landing_page]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: edoxen
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-30 00:00:00.000000000 Z
+date: 2026-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json_schemer
@@ -73,31 +73,56 @@ files:
 - Gemfile
 - README.adoc
 - Rakefile
+- TODO.meeting-agenda/01-design-decisions.md
+- TODO.meeting-agenda/02-lutaml-canonical.md
+- TODO.meeting-agenda/03-ruby-models.md
+- TODO.meeting-agenda/04-schema.md
+- TODO.meeting-agenda/05-fixtures.md
+- TODO.meeting-agenda/06-specs.md
+- TODO.meeting-agenda/07-cli.md
+- TODO.meeting-agenda/08-docs.md
+- TODO.meeting-agenda/09-verify-and-release.md
+- TODO.meeting-agenda/10-future-enhancements.md
+- TODO.meeting-agenda/README.md
 - edoxen.gemspec
 - exe/edoxen
 - lib/edoxen.rb
 - lib/edoxen/_metadata.rb.deprecated
 - lib/edoxen/action.rb
+- lib/edoxen/agenda.rb
+- lib/edoxen/agenda_item.rb
 - lib/edoxen/approval.rb
 - lib/edoxen/cli.rb
 - lib/edoxen/consideration.rb
+- lib/edoxen/date_range.rb
+- lib/edoxen/deadline.rb
 - lib/edoxen/enums.rb
 - lib/edoxen/error.rb
+- lib/edoxen/host_ref.rb
 - lib/edoxen/localization.rb
+- lib/edoxen/location.rb
 - lib/edoxen/meeting.rb
+- lib/edoxen/meeting_collection.rb
+- lib/edoxen/meeting_collection_metadata.rb
 - lib/edoxen/meeting_identifier.rb
+- lib/edoxen/meeting_localization.rb
+- lib/edoxen/meeting_relation.rb
+- lib/edoxen/person.rb
+- lib/edoxen/reference.rb
 - lib/edoxen/resolution.rb
 - lib/edoxen/resolution_collection.rb
 - lib/edoxen/resolution_date.rb
 - lib/edoxen/resolution_metadata.rb
 - lib/edoxen/resolution_relation.rb
 - lib/edoxen/resolution_set.rb
+- lib/edoxen/schedule_item.rb
 - lib/edoxen/schema_validator.rb
 - lib/edoxen/source_url.rb
 - lib/edoxen/structured_identifier.rb
 - lib/edoxen/url.rb
 - lib/edoxen/version.rb
 - schema/edoxen.yaml
+- schema/meeting.yaml
 - sig/edoxen.rbs
 homepage: https://github.com/metanorma/edoxen
 licenses: