relaton 3.0.0.pre.alpha.19 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eee3114e443e307b96ca18a96dff2a48dcb4d5b5dae424fd2ecb3ca6e57202be
-  data.tar.gz: 7208a6c3f058fca1874370a24bfe89d03516d5c4d66477d8c4160c4517717c44
+  metadata.gz: c749882e825411654761a8fa93aafe143cbcc9ff3f1ab2df213af541b423274b
+  data.tar.gz: 18424b0050827481d74048b45397610181e4b6b77f07b718bf9ab1fa589e6d6a
 SHA512:
-  metadata.gz: f8c13c3bbdbe96caa0874d0b0c4671c05fa4c6652070372b0fc55992ac3c87834a6e03bda4a7fe17945d31db33b5f1a5a99d927d8d1d203d8238a7e837c29d77
-  data.tar.gz: 3e5e49f9fdd82e5abe32bc4afb35b2baf075bc1b10aee9aad0e663f4361a0486069ff94cf3d4c066d17ccf4f32dacfac5eccad6eb1534008978d39734577dc84
+  metadata.gz: e37f88eb3fd9f0c20ae2db7bbb08fbcd54ae7b6784ab249494c39d6d56fa452940883ecb1ad5225ec27115ea6fe5a05c518ab1d143e28566a87c111d83ce2361
+  data.tar.gz: 79d5434ca258b521c473e88cd8afbd763bff52e10e46ce20ed8f3743679967bcf9cb51444eef9fd4cd21ceb11b32a830664e105eb92747378336aa91c2d63aa1

data/lib/relaton/bib/model/formattedref.rb

@@ -1,15 +1,10 @@
 module Relaton
   module Bib
     class Formattedref < LocalizedMarkedUpString
-      attribute :format, :string
-
+      # No `format` attribute: the bibdata grammar dropped it (relaton-bib
+      # #94) — an ingested format= is silently dropped, never re-emitted.
       xml do
         root "formattedref"
-        map_attribute "format", to: :format
-      end
-
-      key_value do
-        map "format", to: :format
       end
 
       # Handle plain string input from YAML/JSON deserialization
@@ -35,7 +30,7 @@ module Relaton
       def self.simple_content?(instance, format)
         return false if format == :xml
 
-        instance.format.nil? && instance.language.nil? &&
+        instance.language.nil? &&
           instance.script.nil? && instance.locale.nil?
       end
     end

data/lib/relaton/bib/model/item_shared.rb

@@ -23,10 +23,15 @@ module Relaton
         attribute :docnumber, :string
         attribute :date, Date, collection: true, initialize_empty: true
         attribute :contributor, Contributor, collection: true, initialize_empty: true
-        # Lenient ingest: some upstream corpus documents carry more than one
-        # <edition> in a bibitem (multi-edition bibdata, relaton-db#149); keep
-        # the first instead of failing the whole round-trip with
-        # CollectionTrueMissingError (lutaml-model#971, singular_tolerance).
+        # THE LAW: a bibitem has exactly one edition. A second <edition>
+        # element is always wrong output — in the one known case, the
+        # iso-10303 collection render fused the SMRL library bibdata (a
+        # different document that contains the parts) into part bibitems
+        # (relaton-db#149). The tolerance is a crash guard against that
+        # wrong output: it keeps the bibitem's own (leading) edition instead
+        # of aborting the round-trip with CollectionTrueMissingError
+        # (lutaml-model#971). The emitter fix is the real fix; this must
+        # never fire on correct data.
         attribute :edition, Edition, singular_tolerance: :first
         attribute :version, Version, collection: true, initialize_empty: true
         attribute :note, Note, collection: true, initialize_empty: true

data/lib/relaton/bsi/CLAUDE.md

@@ -32,4 +32,4 @@ Namespace: `Relaton::Bsi`. Retrieval flow:
 
 ## Testing
 
-RSpec with WebMock + VCR (cassettes in `spec/vcr_cassettes/`, record `:once`, 7-day re-record). Network is blocked via WebMock. No index fixture — BSI has no curated index; `spec/fixtures/` holds XML/YAML round-trip data.
+RSpec with WebMock + VCR (cassettes in `spec/vcr_cassettes/`, record `:once`, never auto-rerecorded). Network is blocked via WebMock. No index fixture — BSI has no curated index; `spec/fixtures/` holds XML/YAML round-trip data.

data/lib/relaton/cen/CLAUDE.md

@@ -193,7 +193,7 @@ The `:supplement_year` exclude key is a different thing and stays.
 
 ## Testing
 
-RSpec with WebMock + VCR (cassettes in `spec/vcr_cassettes/`, record `:once`, 7-day re-record). Network is blocked via WebMock. No index fixture — CEN is scraped, not indexed; `spec/fixtures/` holds XML/YAML round-trip data. The scraper is inherently brittle to portal HTML changes.
+RSpec with WebMock + VCR (cassettes in `spec/vcr_cassettes/`, record `:once`, never auto-rerecorded). Network is blocked via WebMock. No index fixture — CEN is scraped, not indexed; `spec/fixtures/` holds XML/YAML round-trip data. The scraper is inherently brittle to portal HTML changes.
 
 - `spec/cen/relaton/cen/docidentifier_spec.rb` unit-tests the three mutators over
   every identifier form the portal serves, including the two rows above that the

data/lib/relaton/doi/CLAUDE.md

@@ -36,7 +36,7 @@ Key classes in `lib/relaton/doi/`:
 ## Test Setup
 
 - **RSpec** with `expect` syntax only (monkey patching disabled)
-- **VCR** cassettes in `spec/vcr_cassettes/` record Crossref HTTP responses, re-recorded every 7 days on purpose (see root `CLAUDE.md`). Because Crossref rate-limits, **re-record this suite alone** — under parallel `rake spec` it answers 429 and the empty body gets recorded as if it were data.
+- **VCR** cassettes in `spec/vcr_cassettes/` record Crossref HTTP responses and are never auto-rerecorded (see root `CLAUDE.md`). Because Crossref rate-limits, **re-record this suite alone** — under parallel `rake spec` it answers 429 and the empty body gets recorded as if it were data.
 - **XML fixtures** in `spec/fixtures/` — expected output XML files. The `read_fixture` helper auto-substitutes today's date into `<fetched>` tags.
 - **equivalent-xml** gem for XML comparison in integration tests
 - Integration tests in `spec/relaton/doi_spec.rb` cover 40+ document types via VCR cassettes

data/lib/relaton/index/CLAUDE.md

@@ -54,7 +54,8 @@ bin/console
 4. Search matches against `:id` field (string comparison via `include?` or custom block)
 5. `save` writes index as YAML to local file
 
-With `pages_url:` (W3C, the #189 pilot) steps 2–3 change: a non-String query
+With `pages_url:` (#189; W3C piloted it, and every indexed flavor's consumer
+now uses it except JIS, NIST and Plateau, which still read the zip) steps 2–3 change: a non-String query
 goes to `ShardSource#rows` and reads one shard, and `Type#index` (a String query,
 a block-only search) is `ShardSource#whole_index`, the `<index>.zip` that the
 manifest names, read from the Pages site. No `FileIO#read`, no disk cache.
@@ -172,8 +173,8 @@ the same arguments:
 | call site | `url:` | `pubid_class:` |
 |---|---|---|
 | producer — `DataFetcher#index` | none (`file:` is CWD-relative) | **yes** — `FileIO#save` calls `to_hash` only for instances of it |
-| consumer — `Bibliography`/`HitCollection#index` | the published `.zip` | **yes** — without it the rows stay raw hashes and `Type#search` stops narrowing |
-| consumer on the Pages shards (W3C) | none; **`pages_url:`** | **yes** — a shard row is deserialized with it |
+| consumer on the zip (JIS, NIST, Plateau) — `Bibliography`/`HitCollection#index` | the published `.zip` | **yes** — without it the rows stay raw hashes and `Type#search` stops narrowing |
+| consumer on the Pages shards (all other indexed flavors) | none; **`pages_url:`** | **yes** — a shard row is deserialized with it |
 | delete — `Processor#remove_index_file` | **`true`** | **no** |
 
 The delete path is `Type#remove_file` → `FileIO#remove` →

data/lib/relaton/index/type.rb

@@ -308,14 +308,21 @@ module Relaton
       end
 
       # The query is the reference, so two identifiers take the subset match.
-      # See #search for the exact-equality escape hatch.
+      # See #search for the exact-equality escape hatch. A dated base query
+      # also resolves a wrapped record of exactly that edition (pubid#580's
+      # ruling): the undated query is the family wildcard, so the dated one
+      # names one edition, and the record embodying it answers through
+      # pubid's wrapped_edition_of? even when its printed identity is one
+      # level down ("IEC CA 01:2020" → the CSV wrapper).
       def match_item(item, id)
         if item[:id].is_a?(String)
           item[:id].include?(id.is_a?(String) ? id : id.to_s)
         elsif id.is_a?(String)
           item[:id].to_s.include?(id)
         else
-          id === item[:id]
+          id === item[:id] ||
+            (item[:id].is_a?(::Pubid::Identifier) &&
+             item[:id].wrapped_edition_of?(id))
         end
       end
     end

data/lib/relaton/isbn/CLAUDE.md

@@ -36,7 +36,7 @@ Uses `Relaton::Bib::` namespace (not the old `RelatonBib::`). Key classes: `Item
 
 ## Testing
 
-- **VCR** records HTTP interactions in `spec/vcr_cassettes/` (re-records every 7 days)
+- **VCR** records HTTP interactions in `spec/vcr_cassettes/` (never auto-rerecorded; re-record deliberately)
 - **WebMock** disables real HTTP by default
 - **SimpleCov** tracks coverage
 - Fixtures in `spec/fixtures/`

data/lib/relaton/iso/CLAUDE.md

@@ -35,4 +35,4 @@ Key dependency: `pubid-iso` gem handles ISO publication identifier parsing and c
 - **Framework:** RSpec with VCR cassettes and WebMock
 - **Network access:** fully blocked via `WebMock.disable_net_connect!`
 - **Index fixture:** `spec/fixtures/index-v1.zip` is pre-loaded into `Relaton::Index` pool in `before(:suite)` (configured in `spec/support/webmock.rb`). Run `rake spec:update_index` to refresh from relaton-data-iso.
-- **VCR:** cassettes in `spec/vcr_cassettes/`, record mode `:once`, re-record interval 7 days. Index download requests are ignored by VCR (handled by fixture instead).
+- **VCR:** cassettes in `spec/vcr_cassettes/`, record mode `:once`, never auto-rerecorded (`re_record_interval: nil`). Index download requests are ignored by VCR (handled by fixture instead).

data/lib/relaton/itu/CLAUDE.md

@@ -646,8 +646,8 @@ is gone (see **Runtime lookup**).
   `spec/itu/vcr_cassettes/itu_r_re*` cassettes back `data_crawler_r_spec.rb`, and
   each is owned by **exactly one example**. That is not stylistic: VCR re-records
   per cassette *insertion*, so a cassette shared across several examples is
-  truncated to the first example's requests the moment the 7-day
-  `re_record_interval` fires (verified — `itu_r_rec_bo` went 10 interactions → 1
+  truncated to the first example's requests the moment it is re-recorded
+  (verified — `itu_r_rec_bo` went 10 interactions → 1
   and took 15 examples down with it). If you add a crawler example, give it its
   own cassette rather than reusing one.
 
@@ -667,7 +667,7 @@ is gone (see **Runtime lookup**).
   responses. VCR ignores only `index-v2.zip` (the index comes from the fixture
   above), so the per-record `raw.githubusercontent.com/…/data/*.yaml` GETs **are**
   recorded. Re-record by deleting the file and running the suite with network
-  access; `re_record_interval` is 7 days, so a stale-cassette run refreshes them.
+  access. `re_record_interval` is nil, so a cassette never refreshes by itself.
 - **Coverage:** SimpleCov, target near 100%
 
 Round-trip tests (serialize → deserialize → compare) are the primary pattern for model classes.

data/lib/relaton/nist/CLAUDE.md

@@ -135,19 +135,16 @@ errors = schema.validate(file)
 ### HTTP Recording
 
 Tests use VCR with WebMock. Cassettes are stored in `spec/vcr_cassettes/` and
-`spec/support/vcr.rb` sets `record: :once` **with `re_record_interval: 7 days`**.
-
-**Gotcha (this bites periodically):** once a cassette is older than 7 days, the
-next run **re-records it from the live network** — so the suite is not truly
-deterministic. Two known failure modes when that fires: the NIST GitHub source
-data can drift (an author renamed, a `loc.gov` `identifier` dropped) so the
-round-tripped XML no longer matches the on-disk `spec/fixtures/*.xml` fixtures;
-and any flavor whose upstream throttles the recorder records a bad response.
-When cassettes show up mass-modified in `git status` for no code reason, that's
-the 7-day re-record firing, not a manual change. To recover: re-record cleanly
-(delete the stale cassette, run the spec) and, for the integration fixtures that
-compare full XML (`get.xml`, `hit.xml`, `hit_bibitem.xml`), regenerate them
-(delete → the spec rewrites them via `File.write … unless File.exist?`).
+`spec/support/vcr.rb` sets `record: :once` with `re_record_interval: nil`, so a
+cassette replays as committed and never re-records by itself (relaton#360).
+
+**When you re-record deliberately:** the NIST GitHub source data can drift (an
+author renamed, a `loc.gov` `identifier` dropped), so the round-tripped XML no
+longer matches the on-disk `spec/fixtures/*.xml` fixtures; and an upstream that
+throttles the recorder records a bad response. Delete the stale cassette, run
+the spec, and, for the integration fixtures that compare full XML (`get.xml`,
+`hit.xml`, `hit_bibitem.xml`), regenerate them (delete → the spec rewrites them
+via `File.write … unless File.exist?`) and read the diff.
 
 ### Test Data Stubbing
 

data/lib/relaton/version.rb

@@ -1,3 +1,3 @@
 module Relaton
-  VERSION = "3.0.0.pre.alpha.19".freeze
+  VERSION = "3.0.0".freeze
 end

data/lib/relaton/w3c/CLAUDE.md

@@ -323,7 +323,7 @@ Tests use [Jing](https://github.com/jing-trang/jing-trang) for RelaxNG validatio
 Tests use RSpec with:
 - **Round-trip tests** — YAML/XML → object → YAML/XML, verifying lossless serialization
 - **Schema validation** — XML output validated against `grammars/relaton-w3c-compile.rng`
-- **VCR** — recorded HTTP cassettes in `spec/vcr_cassettes/` (7-day re-record interval)
+- **VCR** — recorded HTTP cassettes in `spec/vcr_cassettes/` (never auto-rerecorded; re-record deliberately)
 - **WebMock** — disables external HTTP in tests
 
 Test fixtures live in `spec/fixtures/` (YAML and XML files).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton
 version: !ruby/object:Gem::Version
-  version: 3.0.0.pre.alpha.19
+  version: 3.0.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-25 00:00:00.000000000 Z
+date: 2026-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -442,14 +442,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.0.pre.alpha.59
+        version: 2.0.0.pre.alpha.62
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.0.pre.alpha.59
+        version: 2.0.0.pre.alpha.62
 - !ruby/object:Gem::Dependency
   name: yeptris
   requirement: !ruby/object:Gem::Requirement