edoxen 0.7.2 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69a86986a86602665699b5598622d32a63658c302737587f68b7a9b095a471e1
-  data.tar.gz: 1201e014ac06c2e4accb00dfd00660f577f6f6464f5d7990553714b796af8314
+  metadata.gz: f2d36145e7d749b68340072562507ea1416890d645b36a0f7d44620f15b92561
+  data.tar.gz: af5f8fccde1aff6ecbb8d1eca57e4fd217e1bcbb99dab72fdad147eb0992c6c6
 SHA512:
-  metadata.gz: 7ec73b629af4dd2997fea614665347177f273569349d0221e414f9dc9b2dbb8f083b3d964675286bb9a76d449a5a4c7c2cf2981db028ebf5f0d2e54249abb77d
-  data.tar.gz: 52534618f6468c4da8effd9bcb23e978487e1857da1a9832fa8d1ed665e72324a13397657b0cb8f6c828be4ef45e9d669781a208b7135c09e97a1b833cc6c69e
+  metadata.gz: 906d8a9f930f5ca0f8b9e83edd3e24bf4fd409e35ba3feb4cb732e29a630153a8fa1298e3b8384d85c366bdbad210f3123ed8729cf30ca72afbbd8b8cf073f38
+  data.tar.gz: bdf81dddea8e38a8f5937713d78d32d768c4099774b5d2e148e69a422ad78c6959e2365722dfbd87ec2b46779fa4941cd2e63bb2dc74709904ddc7b603645054

data/.rubocop.yml

@@ -1,7 +1,8 @@
 inherit_from: .rubocop_todo.yml
 
 AllCops:
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 3.1
+  NewCops: enable
 
 Style/StringLiterals:
   Enabled: true
@@ -13,3 +14,27 @@ Style/StringLiteralsInInterpolation:
 
 Layout/LineLength:
   Max: 120
+
+# The LutaML parser is a self-contained state machine that lives in
+# spec/support/ only. 101 lines for the whole module (struct types +
+# state-machine + helpers) is acceptable; splitting would obscure the
+# design.
+Metrics/ModuleLength:
+  Exclude:
+    - "spec/support/lutaml_parser.rb"
+
+# RSpec top-level describe blocks routinely run past the default
+# threshold; the suite uses focused single-class spec files instead
+# of splitting for size's own sake.
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*.rb"
+
+# `Edoxen::Cli` is a thin Thor subclass: six `desc` blocks delegating
+# to `Edoxen::Cli::Batch` (the deep module that owns expand/run/summary
+# and the per-profile shape sniffers). Per-command bodies are 1–3 lines;
+# the line count is the natural cost of the command surface, not a sign
+# of god-class drift.
+Metrics/ClassLength:
+  Exclude:
+    - "lib/edoxen/cli.rb"

data/.rubocop_todo.yml

@@ -115,7 +115,7 @@ Metrics/BlockLength:
 # Offense count: 3
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 167
+  Max: 170
 
 # Offense count: 6
 # Configuration parameters: AllowedMethods, AllowedPatterns.

data/CHANGELOG.md

@@ -0,0 +1,133 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.8.1] — 2026-07-14
+
+First implementation release of **Edoxen Model 1.0**. The Ruby gem
+mirrors the canonical LutaML information model in
+[edoxen/edoxen-model](https://github.com/edoxen/edoxen-model): a
+generic meeting, agenda, motion, voting, and decision model with
+VCARD-style contacts, scoped URN registries, and per-field
+localization per ISO 24229.
+
+### Identity & Contact (VCARD-style, OCP)
+
+* `Contact` — VCARD-like abstract contact (person, organisation,
+  department, or role).
+* `Person` — inherits from `Contact` for individual humans.
+* `Name` — structured N + FN components (formatted, family, given,
+  additional, prefix, suffix).
+* `ContactMethod` — polymorphic communication channel (phone, mobile,
+  fax, email, url, mail, pager, message, other).
+* `ContactIdentifier` — polymorphic external ID (orcid, isni,
+  wikidata, ror, ringgold, github, other).
+* `Officer` — role-binding (NOT an entity): binds a Contact to a
+  Meeting or MeetingComponent with a structural role (chair,
+  secretary, treasurer, etc.).
+* `HostRef` — typed reference to a hosting organization.
+
+### Localization (per-field, ISO 24229)
+
+Every translatable field is `Localized<String/Name>[0..*]` — one
+entry per ISO 24229 `spelling` code. There is no separate
+`Localization[]` collection; each field carries its own language tags.
+
+* `LocalizedString` — `{ spelling, value: String, extensions }`.
+* `LocalizedName` — `{ spelling, value: Name, extensions }`.
+* `spelling` accepts ISO 24229 spelling-system codes
+  (`{lang}-{script}[-{country}][-{extension}]`, e.g. `zho-Hans`) AND
+  conversion-system codes (`{authority}:{source}:{target}:{identifying}`,
+  e.g. `acadsin:zho-Hani:Latn:2002`).
+* Always verbose — single-language data uses the same
+  `[{ spelling, value }]` shape as multi-language data.
+* Ruby helpers: `Contact#name_in(spelling)`, `Meeting#title_in(spelling)`,
+  `Contact#localized_value(field, spelling)`.
+
+### Scoped URN registries
+
+URN format: `urn:edoxen:{entity}:{scope}:{local-id}`. Helper:
+`Edoxen::Urn.parse`, `Edoxen::Urn.format`, `Edoxen::Urn.valid?`.
+
+* `ContactCollection` — registry of Contacts indexed by scoped URN.
+  `ContactCollection.load_stream(path)` for YAML Stream files.
+* `VenueCollection` — registry of Venues.
+* `Contact` and `Venue` gain `urn` (registry identity) and `ref`
+  (when used as a URN reference; if set, other fields are ignored).
+
+Any entity-typed field accepts either **inline data** (full object) or
+**a URN reference** (`{ ref: urn:edoxen:contact:... }`).
+
+### Meeting/Agenda side
+
+`Meeting`, `MeetingCollection`, `MeetingSeries`, `MeetingComponent`,
+`Agenda` + `AgendaItem`, `Minutes` + `MinutesSection`, `Attendance`,
+`VoteRecord`, `Venue` (polymorphic physical/virtual, flat wire shape),
+`Deadline`, `MeetingRelation`, `Recurrence` (structured ISO 8601-2 §13).
+
+### Decision side
+
+`Decision`, `DecisionCollection` + `DecisionMetadata`, `DecisionDate`,
+`Action`, `Consideration`, `Approval` (each with per-field Localized
+message), `DecisionRelation`, `SourceUrl`.
+
+### Procedural
+
+`Motion` (state machine), `Voting` + `VotingCounts`, `Topic` +
+`TopicDocument` + `TopicAsset` (cross-meeting threading via
+`resumptionOf`).
+
+### Profile mechanism (ISO 8601-2 §15)
+
+`MeetingExtension` + `ExtensionAttribute` — how adopters express
+body-specific structured data. Core stays generic.
+`BodyVocabularyEntry` — per-dataset vocabulary mapping (body_type →
+canonical_type). `EntityRef` — typed cross-reference between entities.
+
+### Schemas
+
+* `schema/edoxen.yaml` — DecisionCollection schema (decision side).
+* `schema/meeting.yaml` — Meeting / MeetingCollection / MeetingSeries
+  schema (meeting side).
+* All enums mirror `Edoxen::Enums` constants; sync specs assert
+  character-for-character equality.
+* Cross-file sync spec ensures shared `$defs` are byte-for-byte equal
+  across the two schema files.
+
+### Spec coverage
+
+* 6 lutaml ↔ Ruby / schema sync specs (316 + 314 + 60 + 630 + 30
+  examples, all green).
+* 1327 unit / fixture specs green.
+* `Edoxen::SchemaValidator`, `Edoxen::LinkChecker`, `Edoxen::Cli` all
+  exercised.
+
+### BS 0:2006 meeting-minutes integration
+
+* `Statement` — one remark by one or more members on a topic or a
+  minutes section. `kind: StatementKind` discriminates
+  `statement` / `comment` / `standpoint` (BS 0:2006 §7.6).
+* `Declaration` — formal declaration (conflict of interest, IPR).
+  `kind: DeclarationKind` discriminates. IPR declarations carry
+  typed `EntityRef` slots for `ipr_subject_ref` and `ipr_target_ref`.
+* `DateTimeRange` — sub-day precision parallel to `DateRange`.
+* `Meeting#scheduled_date_range` (renamed from `date_range`) +
+  `Meeting#occurred_date_range: DateTimeRange` +
+  `Meeting#declarations: Declaration[0..*]`.
+* `Topic#statements[]` (standing) + `Topic#declarations[]` (standing).
+* `MinutesSection#statements[]` (per-meeting) +
+  `MinutesSection#topic_ref` (URN back-link to Topic).
+* Every new translatable field is per-field Localized (ISO 24229) —
+  no scalar `String` text fields anywhere in the new surface.
+
+### References
+
+* [Edoxen Model 1.0](https://github.com/edoxen/edoxen-model) —
+  canonical LutaML information model.
+* ISO 24229 — spelling/conversion system codes.
+* VCARD (RFC 6350) — N + FN name structure.
+* ISO 8601-2 (2026) §13 for recurrence, §15 for profile mechanism.
+* iCalendar (RFC 5545/7986/5546/9253) — referenced, not duplicated.