edoxen 0.7.2 → 0.8.2

data/schema/edoxen.yaml

@@ -1,237 +1,261 @@
 ---
-$schema: "http://json-schema.org/draft-07/schema#"
-$id: "https://github.com/edoxen/edoxen/schema/edoxen.yaml"
-title: "Edoxen Resolution Collection Schema"
+"$schema": http://json-schema.org/draft-07/schema#
+"$id": https://github.com/edoxen/edoxen-model/schema/decision-collection.yaml
+title: Edoxen Decision Collection Schema
 description: |
-  Schema for validating Edoxen ResolutionCollection YAML files.
+  Schema for validating Edoxen decision-side YAML files.
+
+  Accepts three top-level document kinds via `oneOf`:
+
+    * `DecisionCollection` — the formal outcomes adopted by a Meeting.
+    * `ContactRegister` — a scoped-URN registry of Contacts.
+    * `VenueRegister`  — a scoped-URN registry of Venues.
 
   Mirrors the canonical LutaML information model in
   https://github.com/edoxen/edoxen-model/tree/main/models .
 
-  The enum constants declared under `$defs` (ActionType,
-  ConsiderationType, ApprovalType, ApprovalDegree, ResolutionType,
-  ResolutionDateType, ResolutionRelationType, UrlKind) are the
-  authoritative wire values. `spec/edoxen/schema_enum_sync_spec.rb`
-  asserts each one is character-for-character identical to the
-  corresponding `Edoxen::Enums::*` frozen array.
+  The enum constants declared under `$defs` are the authoritative wire
+  values. `spec/edoxen/schema_enum_sync_spec.rb` asserts each one is
+  character-for-character identical to the corresponding `Edoxen::Enums::*`
+  frozen array.
 
   Trade-off: json_schemer's `valid_values` is not populated when an
   `enum` is reached via `$ref`, so the validator's enum-violation
   message degrades to "value ... is not one of: (see schema)". This
   is documented in `Edoxen::SchemaValidator#format_message`.
 type: object
-additionalProperties: false
-
-properties:
-  metadata:
-    $ref: "#/$defs/ResolutionMetadata"
-  resolutions:
-    type: array
-    items:
-      $ref: "#/$defs/Resolution"
-
-required:
-  - resolutions
-
-$defs:
-
-  # ====================================================================
-  # Identifiers and references.
-  # ====================================================================
-
+oneOf:
+- "$ref": "#/$defs/DecisionCollection"
+- "$ref": "#/$defs/ContactRegister"
+- "$ref": "#/$defs/VenueRegister"
+- "$ref": "#/$defs/BodyRegister"
+"$defs":
+  DecisionCollection:
+    type: object
+    description: |
+      Top-level container for a published decision collection: metadata
+      plus the list of decisions.
+    additionalProperties: false
+    properties:
+      metadata:
+        "$ref": "#/$defs/DecisionMetadata"
+      decisions:
+        type: array
+        items:
+          "$ref": "#/$defs/Decision"
+    required:
+    - decisions
   StructuredIdentifier:
     type: object
-    description: "A resolution identifier (prefix + number). A Resolution may carry 1..* of these."
+    description: An identifier (prefix + number). A Decision carries 1..* of these.
     additionalProperties: false
-    required: [prefix, number]
+    required:
+    - prefix
+    - number
     properties:
       prefix:
         type: string
-        description: "Authority prefix, e.g. 'ISO', 'OIML', 'CIML'."
       number:
         type: string
-        description: "Resolution number issued under that prefix."
-
+  EntityRef:
+    type: object
+    description: |
+      Typed cross-reference between entities (1.0, TODO.refactor/1.0-design).
+      Exactly one of `urn`, `identifier`, or `local_ref` should be set;
+      the gem's `EntityRef#valid?` enforces this in Ruby.
+    additionalProperties: false
+    properties:
+      urn:
+        type: string
+      identifier:
+        "$ref": "#/$defs/StructuredIdentifier"
+      local_ref:
+        type: string
+      kind:
+        type: string
+      role:
+        type: string
+      note:
+        type: string
   MeetingIdentifier:
     type: object
-    description: "Identifies the meeting a Resolution belongs to."
+    description: Identifies the meeting a Decision belongs to.
     additionalProperties: false
     properties:
       venue:
         type: string
-        description: "Meeting venue name (free text)."
       date:
         type: string
         format: date
-        description: "Meeting date."
-
   Url:
     type: object
-    description: "URL with a kind (access / report) and an optional format hint."
+    description: URL with a kind (access / report) and an optional format hint.
     additionalProperties: false
-    required: [kind, ref]
+    required:
+    - kind
+    - ref
     properties:
       kind:
-        $ref: "#/$defs/UrlKind"
+        "$ref": "#/$defs/UrlKind"
       ref:
         type: string
       format:
         type: string
-
-  ResolutionRelation:
+  DecisionRelation:
     type: object
-    description: "Directed relation between two resolutions identified by their StructuredIdentifier."
+    description: Directed relation between two decisions identified by their StructuredIdentifier.
     additionalProperties: false
-    required: [source, destination, type]
+    required:
+    - source
+    - destination
+    - type
     properties:
       source:
-        $ref: "#/$defs/StructuredIdentifier"
+        "$ref": "#/$defs/StructuredIdentifier"
       destination:
-        $ref: "#/$defs/StructuredIdentifier"
+        "$ref": "#/$defs/StructuredIdentifier"
       type:
-        $ref: "#/$defs/ResolutionRelationType"
-
-  # ====================================================================
-  # Date carriers.
-  # ====================================================================
-
-  ResolutionDate:
+        "$ref": "#/$defs/DecisionRelationType"
+  DecisionDate:
     type: object
-    description: "Date with semantic kind (adoption / drafted / discussed)."
+    description: Date with semantic kind (adoption / drafted / discussed).
     additionalProperties: false
-    required: [date, type]
+    required:
+    - date
+    - type
     properties:
       date:
         type: string
         format: date
-        description: "The date itself."
       type:
-        $ref: "#/$defs/ResolutionDateType"
-
-  # ====================================================================
-  # Per-localization sub-structures. Each is owned by exactly one
-  # Language; the language_code discriminator lives on Localization.
-  # ====================================================================
-
+        "$ref": "#/$defs/DecisionDateType"
   Action:
     type: object
-    description: "A verb + one effective date + human-readable message."
+    description: A verb + one effective date + human-readable message.
     additionalProperties: false
-    required: [type, message, date_effective]
+    required:
+    - type
+    - message
+    - date_effective
     properties:
       type:
-        $ref: "#/$defs/ActionType"
+        "$ref": "#/$defs/ActionType"
       date_effective:
-        $ref: "#/$defs/ResolutionDate"
+        "$ref": "#/$defs/DecisionDate"
       message:
-        type: string
-
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
   Approval:
     type: object
-    description: "Approval record: vote type, consensus degree, date, message."
+    description: 'Approval record: vote type, consensus degree, date, message.'
     additionalProperties: false
-    required: [type, degree, date]
+    required:
+    - type
+    - degree
+    - date
     properties:
       type:
-        $ref: "#/$defs/ApprovalType"
+        "$ref": "#/$defs/ApprovalType"
       degree:
-        $ref: "#/$defs/ApprovalDegree"
+        "$ref": "#/$defs/ApprovalDegree"
       date:
-        $ref: "#/$defs/ResolutionDate"
+        "$ref": "#/$defs/DecisionDate"
       message:
-        type: string
-
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
   Consideration:
     type: object
-    description: "The basis for a Resolution: a verb + one effective date + reasoning."
+    description: 'The basis for a Decision: a verb + one effective date + reasoning.'
     additionalProperties: false
-    required: [type, message, date_effective]
+    required:
+    - type
+    - message
+    - date_effective
     properties:
       type:
-        $ref: "#/$defs/ConsiderationType"
+        "$ref": "#/$defs/ConsiderationType"
       date_effective:
-        $ref: "#/$defs/ResolutionDate"
+        "$ref": "#/$defs/DecisionDate"
       message:
-        type: string
-
-  Localization:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+  LocalizedString:
     type: object
     description: |
-      A monolingual rendering of a Resolution. Mirrors the glossarist
-      LocalizedConcept pattern: language-agnostic fields live on the
-      parent Resolution; per-language content lives here.
+      One language-specific value of a translatable String field.
+      `spelling` is an ISO 24229 spelling/conversion system code.
+      Always verbose — single-language data uses the same
+      `[{ spelling, value }]` shape as multi-language data.
     additionalProperties: false
-    required: [language_code]
+    required:
+    - spelling
+    - value
     properties:
-      language_code:
-        type: string
-        pattern: "^[a-z]{3}$"
-        description: "ISO 639-3 three-letter language code (eng, fra, deu, spa, jpn, ...)."
-      script:
-        type: string
-        pattern: "^[A-Z][a-z]{3}$"
-        description: "ISO 15924 four-letter script code (Latn, Cyrl, Hant, Arab)."
-      title:
-        type: string
-      subject:
-        type: string
-      message:
+      spelling:
         type: string
-      considering:
+      value:
         type: string
-      considerations:
-        type: array
-        items:
-          $ref: "#/$defs/Consideration"
-      approvals:
+      extensions:
         type: array
         items:
-          $ref: "#/$defs/Approval"
-      actions:
+          "$ref": "#/$defs/MeetingExtension"
+  LocalizedName:
+    type: object
+    description: |
+      One language-specific value of a translatable Name field.
+      Mirrors LocalizedString but carries a structured Name.
+    additionalProperties: false
+    required:
+    - spelling
+    - value
+    properties:
+      spelling:
+        type: string
+      value:
+        "$ref": "#/$defs/Name"
+      extensions:
         type: array
         items:
-          $ref: "#/$defs/Action"
-
+          "$ref": "#/$defs/MeetingExtension"
   SourceUrl:
     type: object
-    description: "Per-language canonical source URL (e.g. one PDF per language)."
+    description: Per-spelling canonical source URL (e.g. one PDF per language).
     additionalProperties: false
-    required: [ref, format, language_code]
+    required:
+    - ref
     properties:
       ref:
         type: string
-        description: "The URL string."
       format:
         type: string
-        description: "Document format, e.g. 'pdf', 'html'."
-      language_code:
+      spelling:
         type: string
-        pattern: "^[a-z]{3}$"
+        description: ISO 24229 spelling/conversion system code
       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.
-  # ====================================================================
-
-  Resolution:
+        "$ref": "#/$defs/SourceUrlKind"
+  Decision:
     type: object
     description: |
-      A formal Resolution. Language-agnostic admin fields live here;
-      every translatable field is wrapped inside `localizations[]`
-      (one entry per available language; at least one is required).
+      A formal Decision. 1.0: per-field Localized (every translatable
+      field carries its own spelling tag). Removed `localizations[]`.
     additionalProperties: false
-    required: [identifier, localizations]
+    required:
+    - identifier
     properties:
       identifier:
         type: array
         minItems: 1
         items:
-          $ref: "#/$defs/StructuredIdentifier"
-      type:
-        $ref: "#/$defs/ResolutionType"
+          "$ref": "#/$defs/StructuredIdentifier"
+      kind:
+        "$ref": "#/$defs/DecisionKind"
+      status:
+        "$ref": "#/$defs/DecisionStatus"
+      body_type:
+        type: string
       doi:
         type: string
       urn:
@@ -241,150 +265,1307 @@ $defs:
       dates:
         type: array
         items:
-          $ref: "#/$defs/ResolutionDate"
+          "$ref": "#/$defs/DecisionDate"
       categories:
         type: array
         items:
           type: string
       meeting:
-        $ref: "#/$defs/MeetingIdentifier"
+        "$ref": "#/$defs/MeetingIdentifier"
       relations:
         type: array
         items:
-          $ref: "#/$defs/ResolutionRelation"
+          "$ref": "#/$defs/DecisionRelation"
       urls:
         type: array
         items:
-          $ref: "#/$defs/Url"
-      localizations:
+          "$ref": "#/$defs/Url"
+      brought_by_motions:
         type: array
-        minItems: 1
         items:
-          $ref: "#/$defs/Localization"
-
-  ResolutionMetadata:
+          type: string
+      about_topics:
+        type: array
+        items:
+          type: string
+      made_in_component:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      subject:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      message:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      considering:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      considerations:
+        type: array
+        items:
+          "$ref": "#/$defs/Consideration"
+      approvals:
+        type: array
+        items:
+          "$ref": "#/$defs/Approval"
+      actions:
+        type: array
+        items:
+          "$ref": "#/$defs/Action"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  DecisionMetadata:
     type: object
-    description: "Collection-level metadata (title, meeting date, source, source URLs, host venue)."
+    description: Collection-level metadata (localized title, meeting date, source, source URLs, host venue).
     additionalProperties: false
     properties:
       title:
-        type: string
-        description: "Default title (no language). For multilingual, use `title_localized[]`."
-      title_localized:
         type: array
         items:
-          $ref: "#/$defs/Localization"
-        description: "Per-language title records (parallel pattern to Resolution#localizations)."
+          "$ref": "#/$defs/LocalizedString"
       date:
         type: string
         format: date
-        description: "Meeting date."
       source:
         type: string
-        description: "Source organization / secretariat that issued the collection."
       source_urls:
         type: array
         items:
-          $ref: "#/$defs/SourceUrl"
-        description: "Canonical URLs to the source PDFs in each available language."
+          "$ref": "#/$defs/SourceUrl"
       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, 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."
+        pattern: "^[A-Z]{2}$"
       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
-  # <-> Ruby enum sync spec asserts each value-list matches the
-  # corresponding Edoxen::Enums::* frozen array.
-  # ====================================================================
-
-  ActionType:
-    type: string
-    description: "Edoxen::Enums::ACTION_TYPE — LUTAML action.lutaml (deduped)."
-    enum:
-      - adopts
-      - thanks
-      - approves
-      - decides
-      - declares
-      - asks
-      - invites
-      - resolves
-      - confirms
-      - welcomes
-      - recommends
-      - requests
-      - congratulates
-      - instructs
-      - urges
-      - appoints
-      - calls-upon
-      - encourages
-      - affirms
-      - elects
-      - authorizes
-      - charges
-      - states
-      - remarks
-      - judges
-      - sanctions
-      - abrogates
-      - empowers
-
-  ConsiderationType:
-    type: string
-    description: "Edoxen::Enums::CONSIDERATION_TYPE — LUTAML consideration.lutaml (deduped)."
-    enum:
-      - having
-      - noting
-      - recognizing
-      - acknowledging
-      - recalling
-      - reaffirming
-      - considering
-      - taking-into-account
-      - pursuant-to
-      - bearing-in-mind
-      - emphasizing
-      - concerned
-      - accepts
-      - observing
-      - referring
-      - acting
-      - empowers
-
-  ApprovalType:
-    type: string
-    description: "Edoxen::Enums::APPROVAL_TYPE — LUTAML approval_type.lutaml."
-    enum: [affirmative, negative]
-
-  ApprovalDegree:
-    type: string
-    description: "Edoxen::Enums::APPROVAL_DEGREE — LUTAML approval_degree.lutaml."
-    enum: [unanimous, majority, minority]
-
-  ResolutionType:
-    type: string
-    description: "Edoxen::Enums::RESOLUTION_TYPE — LUTAML resolution_type.lutaml."
-    enum: [resolution, recommendation, decision, declaration]
-
-  ResolutionDateType:
-    type: string
-    description: "Edoxen::Enums::RESOLUTION_DATE_TYPE — LUTAML resolution_date_type.lutaml."
-    enum: [adoption, drafted, discussed]
-
-  ResolutionRelationType:
-    type: string
-    description: "Edoxen::Enums::RESOLUTION_RELATION_TYPE — LUTAML resolution_relation_type.lutaml."
-    enum: [annexOf, hasAnnex, updates, refines, replaces, considers]
-
-  UrlKind:
-    type: string
-    description: "Edoxen::Enums::URL_KIND."
-    enum: [access, report]
+      body_vocabulary:
+        type: array
+        items:
+          "$ref": "#/$defs/BodyVocabularyEntry"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  BodyVocabularyEntry:
+    type: object
+    description: |
+      One entry in a per-dataset body_vocabulary list. Maps a free-form
+      body_type to a short canonical value. SSOT for body_type ->
+      canonical_type resolution within the declaring collection.
+    additionalProperties: false
+    properties:
+      body_type:
+        type: string
+      canonical_type:
+        type: string
+      definition:
+        type: string
+  Motion:
+    type: object
+    description: A procedural act that brings a Decision.
+    additionalProperties: false
+    properties:
+      identifier:
+        type: string
+      urn:
+        type: string
+      text:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      mover:
+        "$ref": "#/$defs/Person"
+      seconders:
+        type: array
+        items:
+          "$ref": "#/$defs/Person"
+      status:
+        "$ref": "#/$defs/MotionStatus"
+      introduced_at:
+        type: string
+        format: date-time
+      proposed_decision:
+        type: string
+      resulting_decision:
+        type: string
+      resulting_decision_ref:
+        "$ref": "#/$defs/EntityRef"
+      votings:
+        type: array
+        items:
+          type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  VotingCounts:
+    type: object
+    description: Tally for a Voting instance.
+    additionalProperties: false
+    properties:
+      ayes:
+        type: integer
+      noes:
+        type: integer
+      abstentions:
+        type: integer
+      absent:
+        type: integer
+  Voting:
+    type: object
+    description: State machine for a single vote on a Motion.
+    additionalProperties: false
+    properties:
+      identifier:
+        type: string
+      urn:
+        type: string
+      on_motion:
+        type: string
+      status:
+        "$ref": "#/$defs/VotingStatus"
+      voting_method:
+        "$ref": "#/$defs/VotingMethod"
+      called_by:
+        "$ref": "#/$defs/Person"
+      called_at:
+        type: string
+        format: date-time
+      result_declared_at:
+        type: string
+        format: date-time
+      result:
+        "$ref": "#/$defs/VotingOutcome"
+      counts:
+        "$ref": "#/$defs/VotingCounts"
+      casting_vote:
+        "$ref": "#/$defs/VoteRecord"
+      vote_records:
+        type: array
+        items:
+          "$ref": "#/$defs/VoteRecord"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  TopicDocument:
+    type: object
+    description: 'Text-bearing document about a Topic. 1.0: per-field Localized.'
+    additionalProperties: false
+    properties:
+      identifier:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      version:
+        type: string
+      status:
+        type: string
+      url:
+        type: string
+      format:
+        type: string
+      spelling:
+        type: string
+        description: ISO 24229 spelling/conversion system code
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  TopicAsset:
+    type: object
+    description: 'Non-text resource about a Topic. 1.0: per-field Localized.'
+    additionalProperties: false
+    properties:
+      identifier:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      kind:
+        type: string
+      url:
+        type: string
+      format:
+        type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Topic:
+    type: object
+    description: 'The subject of discussion at a Meeting. 1.0: per-field Localized.'
+    additionalProperties: false
+    properties:
+      identifier:
+        type: string
+      urn:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      description:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      status:
+        "$ref": "#/$defs/TopicStatus"
+      resumption_of:
+        type: string
+      documents:
+        type: array
+        items:
+          "$ref": "#/$defs/TopicDocument"
+      assets:
+        type: array
+        items:
+          "$ref": "#/$defs/TopicAsset"
+      references:
+        type: array
+        items:
+          "$ref": "#/$defs/Reference"
+      motions:
+        type: array
+        items:
+          type: string
+      decisions:
+        type: array
+        items:
+          type: string
+      statements:
+        type: array
+        items:
+          "$ref": "#/$defs/Statement"
+      declarations:
+        type: array
+        items:
+          "$ref": "#/$defs/Declaration"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Venue:
+    type: object
+    description: |
+      Polymorphic place where a Meeting happens. `kind` discriminates
+      physical vs virtual; all fields from both subtypes live here as
+      optional siblings. 1.0: per-field Localized (name, label,
+      description, address, building, floor, room, access_notes).
+      Added `urn` (registry identity) and `ref` (reference-by-URN).
+    additionalProperties: false
+    properties:
+      ref:
+        type: string
+      local_ref:
+        type: string
+      urn:
+        type: string
+        pattern: "^urn:edoxen:venue:[^:]+:[^:]+$"
+      kind:
+        "$ref": "#/$defs/VenueKind"
+      name:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      label:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      description:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      capacity:
+        type: integer
+      url:
+        type: string
+      contact_methods:
+        type: array
+        items:
+          "$ref": "#/$defs/ContactMethod"
+      unlocode:
+        type: string
+        pattern: "^[A-Z]{2}[A-Z0-9]{3}$"
+      iata_code:
+        type: string
+        pattern: "^[A-Z]{3}$"
+      address:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      city:
+        type: string
+      country_code:
+        type: string
+        pattern: "^[A-Z]{2}$"
+      lat:
+        type: number
+      lon:
+        type: number
+      building:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      floor:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      room:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      access_notes:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      uri:
+        type: string
+      features:
+        type: array
+        items:
+          "$ref": "#/$defs/VirtualFeature"
+      passcode:
+        type: string
+      meeting_id:
+        type: string
+      dial_in_numbers:
+        type: array
+        items:
+          type: string
+      waiting_room:
+        type: boolean
+      registration_required:
+        type: boolean
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  PhysicalVenue:
+    description: Marker — Venue with kind=physical. Wire shape is identical to Venue.
+    allOf:
+    - "$ref": "#/$defs/Venue"
+  VirtualVenue:
+    description: Marker — Venue with kind=virtual. Wire shape is identical to Venue.
+    allOf:
+    - "$ref": "#/$defs/Venue"
+  RecurrenceByDay:
+    type: object
+    description: BYDAY part of a recurrence. `ordinal` is null for 'every', +1 for first, -1 for last.
+    additionalProperties: false
+    properties:
+      ordinal:
+        type: integer
+      weekday:
+        type: string
+  Recurrence:
+    type: object
+    description: Structured ISO 8601-2 §13 recurrence.
+    additionalProperties: false
+    properties:
+      freq:
+        "$ref": "#/$defs/RecurrenceFreq"
+      interval:
+        type: integer
+      count:
+        type: integer
+      until:
+        type: string
+        format: date-time
+      by_day:
+        type: array
+        items:
+          "$ref": "#/$defs/RecurrenceByDay"
+      by_month_day:
+        type: array
+        items:
+          type: integer
+      by_month:
+        type: array
+        items:
+          type: integer
+      by_week_no:
+        type: array
+        items:
+          type: integer
+      by_year_day:
+        type: array
+        items:
+          type: integer
+      by_hour:
+        type: array
+        items:
+          type: integer
+      by_minute:
+        type: array
+        items:
+          type: integer
+      by_second:
+        type: array
+        items:
+          type: integer
+      by_set_pos:
+        type: array
+        items:
+          type: integer
+      week_start:
+        type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  ExtensionAttribute:
+    type: object
+    description: |
+      One typed key/value pair within a MeetingExtension. Polymorphic on
+      value type so consumers don't re-parse strings back into Int/Float/
+      Bool/Date (1.0 tighten, TODO.refactor/1.0-design).
+    additionalProperties: false
+    properties:
+      key:
+        type: string
+      type:
+        type: string
+        enum:
+        - string
+        - integer
+        - float
+        - boolean
+        - date
+        - datetime
+      value:
+        type: string
+      intValue:
+        type: integer
+      floatValue:
+        type: number
+      booleanValue:
+        type: boolean
+      dateValue:
+        type: string
+        format: date
+      dateTimeValue:
+        type: string
+        format: date-time
+  MeetingExtension:
+    type: object
+    description: |
+      Profile-specific extension. Adopters register their namespace via
+      `profile` and discriminate via `kind`. Field semantics tightened
+      1.0 (TODO.refactor/1.0-design): `kind` is the in-profile discriminator,
+      `ref` is the URN of an external profile document, and the
+      recursive `extensions[]` slot was removed (YAGNI — use dotted
+      keys in `attributes[]` for nesting).
+    additionalProperties: false
+    properties:
+      profile:
+        type: string
+      kind:
+        type: string
+      ref:
+        type: string
+      attributes:
+        type: array
+        items:
+          "$ref": "#/$defs/ExtensionAttribute"
+  ContactMethodKind:
+    type: string
+    description: Polymorphic communication channel kind.
+    enum:
+    - phone
+    - mobile
+    - fax
+    - email
+    - url
+    - mail
+    - pager
+    - message
+    - other
+  ContactMethod:
+    type: object
+    description: |
+      One polymorphic communication channel — phone, email, fax, url,
+      mail, etc. `kind` discriminates the channel; `value` carries the
+      address/number; `label` is a free-form display hint ("Office",
+      "Front desk"). OCP: new channel kinds are added via the
+      ContactMethodKind enum (or `other` + extensions).
+    additionalProperties: false
+    properties:
+      kind:
+        "$ref": "#/$defs/ContactMethodKind"
+      value:
+        type: string
+      label:
+        type: string
+      primary:
+        type: boolean
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  ContactIdentifierKind:
+    type: string
+    description: Polymorphic external identifier scheme for a Contact.
+    enum:
+    - orcid
+    - isni
+    - wikidata
+    - ror
+    - ringgold
+    - github
+    - other
+  ContactIdentifier:
+    type: object
+    description: |
+      One polymorphic external identifier — ORCID, ISNI, Wikidata QID,
+      ROR, Ringgold, GitHub handle, etc. Replaces the hard-coded `orcid`
+      field. OCP: new identifier schemes are added via the
+      ContactIdentifierKind enum (or `other` + extensions).
+    additionalProperties: false
+    properties:
+      kind:
+        "$ref": "#/$defs/ContactIdentifierKind"
+      value:
+        type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Name:
+    type: object
+    description: |
+      Structured personal/organisational name (VCARD RFC 6350
+      conventions). `formatted` is the pre-built display string (FN);
+      the structured components (N) are stored separately for sorting,
+      indexing, or locale-aware rendering.
+    additionalProperties: false
+    properties:
+      formatted:
+        type: string
+      family:
+        type: string
+      given:
+        type: string
+      additional:
+        type: string
+      prefix:
+        type: string
+      suffix:
+        type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Contact:
+    type: object
+    description: |
+      VCARD-like abstract contact. 1.0: per-field Localized
+      (name, title, affiliation, address). Added `urn` (registry
+      identity) and `ref` (reference-by-URN).
+    additionalProperties: false
+    properties:
+      ref:
+        type: string
+      local_ref:
+        type: string
+      urn:
+        type: string
+        pattern: "^urn:edoxen:contact:[^:]+:[^:]+$"
+      name:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedName"
+      kind:
+        type: string
+      role:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      affiliation:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      contact_methods:
+        type: array
+        items:
+          "$ref": "#/$defs/ContactMethod"
+      identifiers:
+        type: array
+        items:
+          "$ref": "#/$defs/ContactIdentifier"
+      address:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Person:
+    type: object
+    description: |
+      A Contact that is specifically an individual human. Schema
+      duplicates Contact's properties because JSON-Schema draft-07
+      doesn't support `extends`. Same shape; semantically a subclass.
+    additionalProperties: false
+    properties:
+      ref:
+        type: string
+      local_ref:
+        type: string
+      urn:
+        type: string
+        pattern: "^urn:edoxen:contact:[^:]+:[^:]+$"
+      name:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedName"
+      kind:
+        type: string
+      role:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      affiliation:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      contact_methods:
+        type: array
+        items:
+          "$ref": "#/$defs/ContactMethod"
+      identifiers:
+        type: array
+        items:
+          "$ref": "#/$defs/ContactIdentifier"
+      address:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Reference:
+    type: object
+    description: Generic document reference.
+    additionalProperties: false
+    properties:
+      ref:
+        type: string
+      kind:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+  VoteRecord:
+    type: object
+    description: One vote by one person on one decision/voting.
+    additionalProperties: false
+    required:
+    - person
+    - vote
+    properties:
+      decision_ref:
+        type: string
+      voting_ref:
+        type: string
+      person:
+        "$ref": "#/$defs/Person"
+      affiliation:
+        type: string
+      vote:
+        "$ref": "#/$defs/VoteType"
+      role:
+        type: string
+      notes:
+        type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Officer:
+    type: object
+    description: A person holding a structural role in a Meeting.
+    additionalProperties: false
+    properties:
+      role:
+        "$ref": "#/$defs/OfficerRole"
+      person:
+        "$ref": "#/$defs/Person"
+      term_start:
+        type: string
+        format: date
+      term_end:
+        type: string
+        format: date
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  MeetingComponent:
+    type: object
+    description: 'Flat sub-event of a Meeting. 1.0: per-field Localized.'
+    additionalProperties: false
+    properties:
+      identifier:
+        type: string
+      urn:
+        type: string
+      kind:
+        "$ref": "#/$defs/ComponentKind"
+      body_type:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      description:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      starts_at:
+        type: string
+        format: date-time
+      ends_at:
+        type: string
+        format: date-time
+      time_label:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      venue_refs:
+        type: array
+        items:
+          type: string
+      officers:
+        type: array
+        items:
+          "$ref": "#/$defs/Officer"
+      agenda_ref:
+        type: string
+      minutes_ref:
+        type: string
+      attendance_refs:
+        type: array
+        items:
+          type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  MeetingSeries:
+    type: object
+    description: 'Parent of recurring Meeting instances. 1.0: per-field Localized.'
+    additionalProperties: false
+    properties:
+      identifier:
+        type: array
+        items:
+          "$ref": "#/$defs/StructuredIdentifier"
+      urn:
+        type: string
+      name:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      description:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      recurrence:
+        "$ref": "#/$defs/Recurrence"
+      term:
+        type: string
+      contact:
+        "$ref": "#/$defs/Contact"
+      hosts:
+        type: array
+        items:
+          "$ref": "#/$defs/HostRef"
+      kind:
+        type: string
+      meeting_refs:
+        type: array
+        items:
+          type: string
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+      body_type:
+        type: string
+  HostRef:
+    type: object
+    description: Typed reference to a hosting organization.
+    additionalProperties: false
+    required:
+    - ref
+    properties:
+      ref:
+        type: string
+      type:
+        "$ref": "#/$defs/HostType"
+      role:
+        type: string
+      contact:
+        "$ref": "#/$defs/Contact"
+  ContactRegister:
+    type: object
+    description: |
+      Registry of Contacts indexed by scoped URN. Members carry
+      `urn: urn:edoxen:contact:{scope}:{local-id}`; the collection's
+      `scope` MUST match the scope segment in member URNs.
+    additionalProperties: false
+    properties:
+      scope:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      contacts:
+        type: array
+        items:
+          "$ref": "#/$defs/Contact"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  VenueRegister:
+    type: object
+    description: 'Registry of Venues indexed by scoped URN. Mirrors ContactRegister.
+
+      '
+    additionalProperties: false
+    properties:
+      scope:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      venues:
+        type: array
+        items:
+          "$ref": "#/$defs/Venue"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  ActionType:
+    type: string
+    description: |
+      Action verb. Edoxen::Enums::ACTION_TYPE lists the canonical set
+      (28 values). The schema is permissive — adopters may use
+      body-specific verbs (e.g. "scopes", "directs", "establishes")
+      outside the canonical set. The canonical set is advisory; the
+      body_vocabulary mechanism (1.0, TODO.refactor/1.0-design) will
+      eventually map body-specific verbs to canonical types.
+  ConsiderationType:
+    type: string
+    description: |
+      Consideration verb. Edoxen::Enums::CONSIDERATION_TYPE lists the
+      canonical set. The schema is permissive — adopters may use
+      body-specific verbs outside the canonical set (same rationale as
+      ActionType).
+  ApprovalType:
+    type: string
+    description: Edoxen::Enums::APPROVAL_TYPE.
+    enum:
+    - affirmative
+    - negative
+  ApprovalDegree:
+    type: string
+    description: Edoxen::Enums::APPROVAL_DEGREE.
+    enum:
+    - unanimous
+    - majority
+    - minority
+  DecisionKind:
+    type: string
+    description: Edoxen::Enums::DECISION_KIND.
+    enum:
+    - resolution
+    - order
+    - ruling
+    - determination
+    - recommendation
+    - statement
+    - finding
+    - opinion
+    - other
+  DecisionKindCanonical:
+    type: string
+    description: |
+      Edoxen::Enums::DECISION_KIND_CANONICAL — short abstract set (1.0,
+      TODO.refactor/1.0-design). Bodies extend via `body_type` + per-dataset
+      `body_vocabulary[]`.
+    enum:
+    - decision
+    - recommendation
+    - statement
+    - finding
+    - other
+  DecisionStatus:
+    type: string
+    description: Edoxen::Enums::DECISION_STATUS.
+    enum:
+    - draft
+    - proposed
+    - under_consideration
+    - decided
+    - negatived
+    - withdrawn
+    - deferred
+  DecisionDateType:
+    type: string
+    description: Edoxen::Enums::DECISION_DATE_TYPE.
+    enum:
+    - adoption
+    - drafted
+    - discussed
+    - proposed
+    - decided
+    - negatived
+    - withdrawn
+    - published
+    - effective
+  DecisionRelationType:
+    type: string
+    description: Edoxen::Enums::DECISION_RELATION_TYPE.
+    enum:
+    - annex_of
+    - has_annex
+    - updates
+    - refines
+    - replaces
+    - considers
+    - cites
+  MotionStatus:
+    type: string
+    description: Edoxen::Enums::MOTION_STATUS.
+    enum:
+    - introduced
+    - seconded
+    - debating
+    - question_put
+    - voting
+    - carried
+    - negatived
+    - withdrawn
+    - lapsed
+  VotingStatus:
+    type: string
+    description: Edoxen::Enums::VOTING_STATUS.
+    enum:
+    - called
+    - in_progress
+    - decided
+    - withdrawn
+    - deferred
+  VotingMethod:
+    type: string
+    description: Edoxen::Enums::VOTING_METHOD.
+    enum:
+    - voice
+    - division
+    - show_of_hands
+    - roll_call
+    - electronic
+    - secret_ballot
+    - unanimous_consent
+    - consensus
+  VotingOutcome:
+    type: string
+    description: Edoxen::Enums::VOTING_OUTCOME.
+    enum:
+    - passed
+    - negatived
+    - tied
+    - withdrawn
+  TopicStatus:
+    type: string
+    description: Edoxen::Enums::TOPIC_STATUS.
+    enum:
+    - open
+    - under_discussion
+    - decided
+    - deferred
+    - withdrawn
+  VenueKind:
+    type: string
+    description: Edoxen::Enums::VENUE_KIND.
+    enum:
+    - physical
+    - virtual
+  VirtualFeature:
+    type: string
+    description: Edoxen::Enums::VIRTUAL_FEATURE.
+    enum:
+    - audio
+    - video
+    - chat
+    - phone
+    - screen
+    - feed
+  Visibility:
+    type: string
+    description: Edoxen::Enums::VISIBILITY.
+    enum:
+    - public
+    - private
+    - confidential
+  AttendanceRole:
+    type: string
+    description: Edoxen::Enums::ATTENDANCE_ROLE.
+    enum:
+    - chair
+    - required
+    - optional
+    - non_participant
+  AttendanceResponse:
+    type: string
+    description: Edoxen::Enums::ATTENDANCE_RESPONSE.
+    enum:
+    - pending
+    - confirmed
+    - declined
+    - tentative
+    - delegated
+  ComponentKind:
+    type: string
+    description: Edoxen::Enums::COMPONENT_KIND.
+    enum:
+    - track
+    - session
+    - debate
+    - breakout
+    - bof
+    - plenary_session
+    - working_group_session
+    - committee_of_the_whole
+    - keynote
+    - address
+    - statement
+    - question_time
+    - opening
+    - closing
+    - break
+    - reception
+    - registration
+    - networking
+    - other
+  ComponentKindCanonical:
+    type: string
+    description: |
+      Edoxen::Enums::COMPONENT_KIND_CANONICAL — short abstract set
+      (1.0, TODO.refactor/1.0-design).
+    enum:
+    - deliberative
+    - working
+    - ceremonial
+    - break
+    - other
+  OfficerRole:
+    type: string
+    description: Edoxen::Enums::OFFICER_ROLE.
+    enum:
+    - chair
+    - vice_chair
+    - deputy_chair
+    - secretary
+    - treasurer
+    - parliamentarian
+    - presiding_officer
+    - sergeant_at_arms
+    - other
+  RecurrenceFreq:
+    type: string
+    description: Edoxen::Enums::RECURRENCE_FREQ.
+    enum:
+    - secondly
+    - minutely
+    - hourly
+    - daily
+    - weekly
+    - monthly
+    - yearly
+  UrlKind:
+    type: string
+    description: Edoxen::Enums::URL_KIND.
+    enum:
+    - access
+    - report
+  SourceUrlKind:
+    type: string
+    description: Edoxen::Enums::SOURCE_URL_KIND.
+    enum:
+    - agenda_pdf
+    - minutes_pdf
+    - decisions_pdf
+    - report_pdf
+    - register_url
+    - landing_page
+  HostType:
+    type: string
+    description: Edoxen::Enums::HOST_TYPE.
+    enum:
+    - national_body
+    - liaison
+    - associate
+    - organizer
+  VoteType:
+    type: string
+    description: Edoxen::Enums::VOTE_TYPE.
+    enum:
+    - affirmative
+    - negative
+    - abstain
+    - absent
+    - not_applicable
+  DateTimeRange:
+    type: object
+    description: |
+      Start + end pair with sub-day precision. Parallel to DateRange;
+      use when day granularity is insufficient (e.g. a meeting that
+      ran 09:00–11:30).
+    additionalProperties: false
+    properties:
+      start:
+        type: string
+        format: date-time
+      end:
+        type: string
+        format: date-time
+  StatementKind:
+    type: string
+    description: |
+      Discriminator for the three BS 0:2006 statement types. Adding a
+      new kind is a one-line enum extension; the Statement model
+      itself never needs to change (OCP).
+    enum:
+    - statement
+    - comment
+    - standpoint
+  DeclarationKind:
+    type: string
+    description: |
+      Discriminator for the two BS 0:2006 declaration types
+      (conflict of interest, IPR).
+    enum:
+    - conflict_of_interest
+    - ipr
+  Statement:
+    type: object
+    description: |
+      One remark made by one or more meeting members on a topic or a
+      minutes section. Per-field Localized description; party is a
+      list of Person references. The `kind` discriminator separates
+      the three BS 0:2006 statement types.
+    additionalProperties: false
+    properties:
+      kind:
+        "$ref": "#/$defs/StatementKind"
+      description:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      party:
+        type: array
+        items:
+          "$ref": "#/$defs/Person"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Declaration:
+    type: object
+    description: |
+      A formal declaration (conflict of interest or IPR) made by one
+      or more meeting members. IPR-specific fields (`ipr_subject_ref`,
+      `ipr_target_ref`) are populated only when `kind == "ipr"`.
+    additionalProperties: false
+    properties:
+      kind:
+        "$ref": "#/$defs/DeclarationKind"
+      description:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      party:
+        type: array
+        items:
+          "$ref": "#/$defs/Person"
+      ipr_subject_ref:
+        "$ref": "#/$defs/EntityRef"
+      ipr_target_ref:
+        "$ref": "#/$defs/EntityRef"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  Body:
+    type: object
+    description: |
+      A committee, subcommittee, working group, or other organised body.
+      Three-tier entity resolution (ref / local_ref / inline).
+    additionalProperties: false
+    properties:
+      ref:
+        type: string
+      local_ref:
+        type: string
+      code:
+        type: string
+      name:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      kind:
+        type: string
+      parent_ref:
+        "$ref": "#/$defs/EntityRef"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"
+  BodyRegister:
+    type: object
+    description: |
+      Authoritative register of Bodies (committees, subcommittees,
+      working groups).
+    additionalProperties: false
+    properties:
+      scope:
+        type: string
+      title:
+        type: array
+        items:
+          "$ref": "#/$defs/LocalizedString"
+      bodies:
+        type: array
+        items:
+          "$ref": "#/$defs/Body"
+      extensions:
+        type: array
+        items:
+          "$ref": "#/$defs/MeetingExtension"