asciichem 0.31.16 → 0.31.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b985064f84599e157131e30ca2ae73555383b6e273c6ea3ae561f02d52df5da
-  data.tar.gz: bb08895e055a18b16fe280b30da829666bf9f646d269f9a3b5312b61fbf86578
+  metadata.gz: 96ad0bea754dd62a7b5b92f44cf87d1446a7afc1594634f903fd744c7c7c0326
+  data.tar.gz: 00d721ea5ba129cbd6f6b606167469178c83ec17ca53ecf1749160d337ea5639
 SHA512:
-  metadata.gz: 12604d14213ae4bc6beba2507b6fcd27e540b32d3be966cbdc56816c844f73309e5b6518ea632441e17b7610d7321fcaf25bc2be6ba46659d2165907039c5375
-  data.tar.gz: 2676f58b2d881b8a9f321bebcaad712e165f2cc4520f419bdf7b41dab28e4330b72f278456265bd62e3c0101d953501d396435fec84c5281d1379de34637a938
+  metadata.gz: a4d8d30b7b44a9b4b8ac460708a38e5eaf122a90a3d53c387bda976390eab2e41cf6750742c88755d5147119fa15f58758f4a55c9f846165b21b7ec0986a6bc3
+  data.tar.gz: c3e7da0afbcd8f8cce91335c6f722fc797af05d461952b743913e4e12066c25962a3add7db9deca81e7baccde11ac3fcd5b662f1c6bd787b722f608d84b459d7

data/.github/workflows/ci.yml

@@ -9,7 +9,7 @@ env:
   # Hermetic CI: the corpus ref is pinned, never floating. Bump this
   # one line deliberately with each corpus release (the tag carries
   # what changed).
-  CORPUS_REF: v0.8.0
+  CORPUS_REF: v0.11.0
 
 jobs:
   test:

data/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to AsciiChem are documented here.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.31.17] - 2026-11-13
+
+### Added
+- The resolver clock seam: `resolve_all` and every adapter accept a
+  `now:` ISO-8601 UTC timestamp (nil = the wall clock) that pins
+  `retrievedAt` — recorded-fixture runs and the citation goldens that
+  consume them compare byte-stably. Mirrors the asciichem-py seam of
+  the same name.
+
+### Changed
+- The conformance runner gates the corpus 0.11.0 parity families
+  (linter-expectations with engine posture + node matching, resolver
+  replay, citation byte-goldens, the 22 CLI contracts); the CI
+  corpus pin moves v0.8.0 → v0.11.0. Claims matrix: linter 27 run +
+  3 posture skips, resolver 6/6, citation 4/4 byte-equal, CLI 22/22
+  (asciichem-ruby#159).
+
 ## [0.31.16] - 2026-11-12
 
 ### Changed

data/lib/asciichem/resolver/adapter.rb

@@ -41,7 +41,11 @@ module AsciiChem
 
       # Cache-aware resolution. `fetch` must answer #get(url) -> body
       # String (NetFetch by default; specs inject recorded responses).
-      def resolve(value:, convention:, fetch: nil, cache: nil, refresh: false)
+      # `now` pins the retrieval clock (an ISO-8601 UTC string) for
+      # recorded-fixture runs — the shared corpus pins `retrievedAt`
+      # so replayed records compare byte-stably; nil means the wall
+      # clock.
+      def resolve(value:, convention:, fetch: nil, cache: nil, refresh: false, now: nil)
         cache ||= Cache.default
         fetch ||= NetFetch.new
         key = cache.key_for(self.class.source_name, convention, value)
@@ -51,22 +55,22 @@ module AsciiChem
           return cached if cached
         end
 
-        substance = fetch_record(value: value, convention: convention, fetch: fetch)
-          .tap { |s| s&.identifiers&.each { |i| i.provenance ||= default_provenance } }
+        substance = fetch_record(value: value, convention: convention, fetch: fetch, now: now)
+          .tap { |s| s&.identifiers&.each { |i| i.provenance ||= default_provenance(now) } }
         cache.write(key, substance) if substance
         substance
       end
 
       # Not-found is nil, not an error — sources legitimately answer
       # "unknown substance" during multi-source resolution.
-      def fetch_record(**)
+      def fetch_record(value:, convention:, fetch:, now: nil)
         raise NotImplementedError
       end
 
-      def default_provenance
+      def default_provenance(now: nil)
         Provenance.new(
           source: self.class.source_name,
-          retrieved_at: Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ"),
+          retrieved_at: now || Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ"),
           attribution: attribution
         )
       end

data/lib/asciichem/resolver/common_chemistry.rb

@@ -43,7 +43,7 @@ module AsciiChem
         @api_key = api_key
       end
 
-      def fetch_record(value:, convention:, fetch:)
+      def fetch_record(value:, convention:, fetch:, now: nil)
         headers = {
           "Accept" => "application/json",
           "x-origin" => ORIGIN
@@ -55,7 +55,7 @@ module AsciiChem
         data = JSON.parse(body)
         return nil if data.empty?
 
-        substance_from(data)
+        substance_from(data, now)
       rescue JSON::ParserError => e
         raise Error, "common_chemistry returned malformed JSON: #{e.message}"
       end
@@ -71,8 +71,8 @@ module AsciiChem
           (File.read(KEY_FILE).strip if File.readable?(KEY_FILE))
       end
 
-      def substance_from(data)
-        provenance = default_provenance
+      def substance_from(data, now)
+        provenance = default_provenance(now: now)
         identifiers = [Identifier.new(value: data["rn"], convention: "cas",
                                       provenance: provenance)]
         add_identifier(identifiers, data, "inchikey", "inchikey", provenance)

data/lib/asciichem/resolver/opsin.rb

@@ -27,11 +27,11 @@ module AsciiChem
       BASE = 'https://opsin.ch.cam.ac.uk/opsin'
       private_constant :BASE
 
-      def fetch_record(value:, convention: nil, fetch:)
+      def fetch_record(value:, convention: nil, fetch:, now: nil)
         body = fetch.get("#{BASE}/#{CGI.escape(value.to_s)}.smiles")
         return nil unless body
 
-        substance_from(body.strip)
+        substance_from(body.strip, now)
       rescue StandardError => e
         raise Error, "opsin request failed: #{e.message}"
       end
@@ -42,10 +42,10 @@ module AsciiChem
 
       private
 
-      def substance_from(smiles)
+      def substance_from(smiles, now)
         return nil if smiles.empty?
 
-        provenance = default_provenance
+        provenance = default_provenance(now: now)
         Substance.new(
           preferred_name: nil,
           identifiers: [Identifier.new(value: smiles, convention: 'canonical-smiles',

data/lib/asciichem/resolver/pubchem.rb

@@ -26,14 +26,14 @@ module AsciiChem
                       MolecularWeight IUPACName InChI InChIKey].freeze
       private_constant :BASE, :PROPERTIES
 
-      def fetch_record(value:, convention:, fetch:)
+      def fetch_record(value:, convention:, fetch:, now: nil)
         body = fetch.get(url_for(value, convention))
         return nil unless body
 
         props = JSON.parse(body).dig("PropertyTable", "Properties", 0)
         return nil unless props
 
-        substance_from(props)
+        substance_from(props, now)
       rescue JSON::ParserError => e
         raise Error, "pubchem returned malformed JSON: #{e.message}"
       end
@@ -53,8 +53,8 @@ module AsciiChem
         "#{BASE}/#{namespace}/#{CGI.escape(value.to_s)}/property/#{PROPERTIES.join(',')}/JSON"
       end
 
-      def substance_from(props)
-        provenance = default_provenance
+      def substance_from(props, now)
+        provenance = default_provenance(now: now)
         identifiers = []
         identifiers << Identifier.new(value: props["CID"].to_s, convention: "pubchem-cid", provenance: provenance) if props["CID"]
         add_identifier(identifiers, props, "InChIKey", "inchikey", provenance)

data/lib/asciichem/resolver.rb

@@ -48,15 +48,16 @@ module AsciiChem
       # entries dropped). Sources answer in registration order. A
       # source-level failure (HTTP error, rejected request) skips that
       # source — one dead or key-gated endpoint must not poison the
-      # others; callers see what answered.
-      def resolve_all(value:, convention:, sources: nil, fetch: nil, cache: nil, refresh: false)
+      # others; callers see what answered. `now` pins the retrieval
+      # clock for recorded-fixture runs (the adapters' seam).
+      def resolve_all(value:, convention:, sources: nil, fetch: nil, cache: nil, refresh: false, now: nil)
         selected = sources ? Array(sources).map { |s| self[s] } : adapters.values
         selected.filter_map do |adapter_class|
           adapter = adapter_class.new
           next unless adapter.supports?(convention)
 
           begin
-            adapter.resolve(value: value, convention: convention, fetch: fetch, cache: cache, refresh: refresh)
+            adapter.resolve(value: value, convention: convention, fetch: fetch, cache: cache, refresh: refresh, now: now)
           rescue AsciiChem::Error
             nil
           end

data/lib/asciichem/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AsciiChem
-  VERSION = "0.31.16"
+  VERSION = "0.31.17"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciichem
 version: !ruby/object:Gem::Version
-  version: 0.31.16
+  version: 0.31.17
 platform: ruby
 authors:
 - Ribose Inc.