edoxen 0.1.1 → 0.3.0

data/schema/edoxen.yaml

@@ -1,37 +1,32 @@
-# yaml-language-server: $schema=http://json-schema.org/draft-07/schema
 ---
 $schema: "http://json-schema.org/draft-07/schema#"
 $id: "https://github.com/metanorma/edoxen/schema/edoxen.yaml"
 title: "Edoxen Resolution Collection Schema"
-description: "Schema for validating Edoxen resolution collection YAML files"
+description: |
+  Schema for validating Edoxen ResolutionCollection YAML files.
+
+  Mirrors the canonical LutaML information model in
+  https://github.com/metanorma/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.
+
+  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:
-    type: object
-    description: "Metadata about the resolution collection"
-    properties:
-      title:
-        type: string
-        description: "Title of the resolution collection"
-      date:
-        type: string
-        format: date
-        description: "Date of the meeting or collection (YYYY-MM-DD)"
-      source:
-        type: string
-        description: "Source organization or secretariat"
-      venue:
-        type: string
-        description: "Meeting venue"
-      chair:
-        type: string
-        description: "Meeting chair"
-    additionalProperties: false
-
+    $ref: "#/$defs/ResolutionMetadata"
   resolutions:
     type: array
-    description: "Array of resolutions"
     items:
       $ref: "#/$defs/Resolution"
 
@@ -39,248 +34,349 @@ required:
   - resolutions
 
 $defs:
-  Resolution:
+
+  # ====================================================================
+  # Identifiers and references.
+  # ====================================================================
+
+  StructuredIdentifier:
     type: object
-    description: "A single resolution"
+    description: "A resolution identifier (prefix + number). A Resolution may carry 1..* of these."
+    additionalProperties: false
+    required: [prefix, number]
     properties:
-      identifier:
-        oneOf:
-          - type: string
-          - type: integer
-        description: "Resolution identifier (e.g., '2019-01' or 1)"
-
-      title:
+      prefix:
         type: string
-        description: "Resolution title"
-
-      type:
+        description: "Authority prefix, e.g. 'ISO', 'OIML', 'CIML'."
+      number:
         type: string
-        enum:
-          - "resolution"
-          - "recommendation"
-          - "decision"
-          - "declaration"
-        description: "Type of resolution"
+        description: "Resolution number issued under that prefix."
 
-      category:
+  MeetingIdentifier:
+    type: object
+    description: "Identifies the meeting a Resolution belongs to."
+    additionalProperties: false
+    properties:
+      venue:
         type: string
-        description: "Resolution category"
-
-      subject:
+        description: "Meeting venue name (free text)."
+      date:
         type: string
-        description: "Subject or scope of the resolution"
-
-      dates:
-        type: array
-        items:
-          type: string
-          format: date
-        description: "Array of relevant dates"
-
-      considerations:
-        type: array
-        items:
-          $ref: "#/$defs/Consideration"
-        description: "Considerations leading to the resolution"
-
-      approvals:
-        type: array
-        items:
-          $ref: "#/$defs/Approval"
-        description: "Approval information"
-
-      actions:
-        type: array
-        items:
-          $ref: "#/$defs/Action"
-        description: "Actions taken in the resolution"
-
-      meeting:
-        $ref: "#/$defs/MeetingIdentifier"
-        description: "Meeting information"
-
-      relationships:
-        type: array
-        items:
-          $ref: "#/$defs/ResolutionRelationship"
-        description: "Relationships to other resolutions"
+        format: date
+        description: "Meeting date."
 
-    required:
-      - title
+  Url:
+    type: object
+    description: "URL with a kind (access / report) and an optional format hint."
     additionalProperties: false
+    required: [kind, ref]
+    properties:
+      kind:
+        $ref: "#/$defs/UrlKind"
+      ref:
+        type: string
+      format:
+        type: string
 
-  Consideration:
+  ResolutionRelation:
     type: object
-    description: "A consideration leading to a resolution"
+    description: "Directed relation between two resolutions identified by their StructuredIdentifier."
+    additionalProperties: false
+    required: [source, destination, type]
     properties:
+      source:
+        $ref: "#/$defs/StructuredIdentifier"
+      destination:
+        $ref: "#/$defs/StructuredIdentifier"
       type:
-        type: string
-        enum:
-          - "having"
-          - "noting"
-          - "recognizing"
-          - "acknowledging"
-          - "considering"
-          - "recalling"
-          - "welcoming"
-          - "appreciating"
-        description: "Type of consideration"
+        $ref: "#/$defs/ResolutionRelationType"
 
-      date_effective:
-        type: string
-        format: date
-        description: "Effective date of the consideration"
+  # ====================================================================
+  # Date carriers.
+  # ====================================================================
 
-      message:
+  ResolutionDate:
+    type: object
+    description: "Date with semantic kind (adoption / drafted / discussed)."
+    additionalProperties: false
+    required: [date, type]
+    properties:
+      date:
         type: string
-        description: "Consideration text"
+        format: date
+        description: "The date itself."
+      type:
+        $ref: "#/$defs/ResolutionDateType"
 
-      subject:
-        type: string
-        description: "Subject of the consideration"
+  # ====================================================================
+  # Per-localization sub-structures. Each is owned by exactly one
+  # Language; the language_code discriminator lives on Localization.
+  # ====================================================================
 
+  Action:
+    type: object
+    description: "A verb + one effective date + human-readable message."
     additionalProperties: false
+    required: [type, message, date_effective]
+    properties:
+      type:
+        $ref: "#/$defs/ActionType"
+      date_effective:
+        $ref: "#/$defs/ResolutionDate"
+      message:
+        type: string
 
   Approval:
     type: object
-    description: "Approval information for a resolution"
+    description: "Approval record: vote type, consensus degree, date, message."
+    additionalProperties: false
+    required: [type, degree, date]
     properties:
       type:
-        type: string
-        enum:
-          - "affirmative"
-          - "negative"
-        description: "Type of approval"
-
+        $ref: "#/$defs/ApprovalType"
       degree:
-        type: string
-        enum:
-          - "unanimous"
-          - "majority"
-          - "minority"
-        description: "Degree of approval"
-
+        $ref: "#/$defs/ApprovalDegree"
+      date:
+        $ref: "#/$defs/ResolutionDate"
       message:
         type: string
-        description: "Approval details"
-
-    additionalProperties: false
 
-  Action:
+  Consideration:
     type: object
-    description: "An action taken in a resolution"
+    description: "The basis for a Resolution: a verb + one effective date + reasoning."
+    additionalProperties: false
+    required: [type, message, date_effective]
     properties:
       type:
-        type: string
-        enum:
-          - "adopts"
-          - "thanks"
-          - "approves"
-          - "decides"
-          - "declares"
-          - "resolves"
-          - "requests"
-          - "recommends"
-          - "encourages"
-          - "welcomes"
-          - "notes"
-          - "confirms"
-          - "reaffirms"
-          - "withdraws"
-          - "abrogates"
-          - "establishes"
-          - "appoints"
-          - "nominates"
-          - "extends"
-          - "initiates"
-        description: "Type of action"
-
+        $ref: "#/$defs/ConsiderationType"
       date_effective:
-        type: string
-        format: date
-        description: "Effective date of the action"
-
+        $ref: "#/$defs/ResolutionDate"
       message:
         type: string
-        description: "Action text"
 
+  Localization:
+    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.
+    additionalProperties: false
+    required: [language_code]
+    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
-        description: "Subject of the action"
-
-    additionalProperties: false
+      message:
+        type: string
+      considering:
+        type: string
+      considerations:
+        type: array
+        items:
+          $ref: "#/$defs/Consideration"
+      approvals:
+        type: array
+        items:
+          $ref: "#/$defs/Approval"
+      actions:
+        type: array
+        items:
+          $ref: "#/$defs/Action"
 
-  MeetingIdentifier:
+  SourceUrl:
     type: object
-    description: "Meeting identification information"
+    description: "Per-language canonical source URL (e.g. one PDF per language)."
+    additionalProperties: false
+    required: [ref, format, language_code]
     properties:
-      venue:
+      ref:
         type: string
-        description: "Meeting venue"
-
-      date:
+        description: "The URL string."
+      format:
         type: string
-        format: date
-        description: "Meeting date"
-
-      identifier:
+        description: "Document format, e.g. 'pdf', 'html'."
+      language_code:
         type: string
-        description: "Meeting identifier"
+        pattern: "^[a-z]{3}$"
 
-    additionalProperties: false
+  # ====================================================================
+  # Top-level structures.
+  # ====================================================================
 
-  ResolutionRelationship:
+  Resolution:
     type: object
-    description: "Relationship between resolutions"
+    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).
+    additionalProperties: false
+    required: [identifier, localizations]
     properties:
+      identifier:
+        type: array
+        minItems: 1
+        items:
+          $ref: "#/$defs/StructuredIdentifier"
       type:
+        $ref: "#/$defs/ResolutionType"
+      doi:
         type: string
-        enum:
-          - "supersedes"
-          - "amends"
-          - "references"
-          - "replaces"
-          - "updates"
-        description: "Type of relationship"
-
-      target:
+      urn:
         type: string
-        description: "Target resolution identifier"
-
-      description:
+      agenda_item:
         type: string
-        description: "Description of the relationship"
-
-    additionalProperties: false
+      dates:
+        type: array
+        items:
+          $ref: "#/$defs/ResolutionDate"
+      categories:
+        type: array
+        items:
+          type: string
+      meeting:
+        $ref: "#/$defs/MeetingIdentifier"
+      relations:
+        type: array
+        items:
+          $ref: "#/$defs/ResolutionRelation"
+      urls:
+        type: array
+        items:
+          $ref: "#/$defs/Url"
+      localizations:
+        type: array
+        minItems: 1
+        items:
+          $ref: "#/$defs/Localization"
 
-  StructuredIdentifier:
+  ResolutionMetadata:
     type: object
-    description: "Structured identifier with prefix and number"
-    properties:
-      prefix:
-        type: string
-        description: "Identifier prefix"
-
-      number:
-        oneOf:
-          - type: string
-          - type: integer
-        description: "Identifier number"
-
+    description: "Collection-level metadata (title, meeting date, source, source URLs, host venue)."
     additionalProperties: false
-
-  SubjectBody:
-    type: object
-    description: "Subject body information"
     properties:
-      name:
+      title:
         type: string
-        description: "Name of the subject body"
-
-      address:
+        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)."
+      date:
         type: string
-        description: "Address of the subject body"
-
-    additionalProperties: false
-
-additionalProperties: false
+        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."
+      city:
+        type: string
+        description: "IATA city code (3-letter, e.g. BER, CPT, PAR) of the host city."
+      country_code:
+        type: string
+        description: "ISO 3166-1 alpha-2 country code (2-letter, e.g. DE, FR, JP) of the host country."
+
+  # ====================================================================
+  # 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]

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: edoxen
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-18 00:00:00.000000000 Z
+date: 2026-06-30 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: lutaml-model
   requirement: !ruby/object:Gem::Requirement
@@ -24,39 +38,64 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
-description: 'Edoxen provides a Ruby library for working with resolution models, allowing
-  users to create, manipulate, and serialize resolution data in a structured format.
-  It is built on top of the lutaml-model serialization framework, which provides a
-  flexible and extensible way to define data models and serialize them to YAML or
-  JSON formats.
-
-  '
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: |
+  Edoxen provides a Ruby library for working with resolution models, allowing
+  users to create, manipulate, and serialize resolution data in a structured
+  format. It is built on top of the lutaml-model serialization framework,
+  which provides a flexible and extensible way to define data models and
+  serialize them to YAML or JSON formats.
 email:
 - open.source@ribose.com
-executables: []
+executables:
+- edoxen
 extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - README.adoc
 - Rakefile
 - edoxen.gemspec
+- exe/edoxen
 - lib/edoxen.rb
+- lib/edoxen/_metadata.rb.deprecated
 - lib/edoxen/action.rb
 - lib/edoxen/approval.rb
+- lib/edoxen/cli.rb
 - lib/edoxen/consideration.rb
+- lib/edoxen/enums.rb
+- lib/edoxen/error.rb
+- lib/edoxen/localization.rb
 - lib/edoxen/meeting.rb
-- lib/edoxen/meeting_identfier.rb
+- lib/edoxen/meeting_identifier.rb
 - lib/edoxen/resolution.rb
 - lib/edoxen/resolution_collection.rb
 - lib/edoxen/resolution_date.rb
-- lib/edoxen/resolution_relationship.rb
+- lib/edoxen/resolution_metadata.rb
+- lib/edoxen/resolution_relation.rb
+- lib/edoxen/resolution_set.rb
+- lib/edoxen/schema_validator.rb
+- lib/edoxen/source_url.rb
 - lib/edoxen/structured_identifier.rb
-- lib/edoxen/subject_body.rb
+- lib/edoxen/url.rb
 - lib/edoxen/version.rb
 - schema/edoxen.yaml
 - sig/edoxen.rbs