asciichem 0.31.16 → 1.0.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b985064f84599e157131e30ca2ae73555383b6e273c6ea3ae561f02d52df5da
-  data.tar.gz: bb08895e055a18b16fe280b30da829666bf9f646d269f9a3b5312b61fbf86578
+  metadata.gz: 1bd4b9584ac1e0126a98efc020036d2532a9567f8f1cfb0107e66b9c15680135
+  data.tar.gz: 6c284fa95ed81aa18328046d02863f709113cb27aaaa2a9fe29a81fbe8cf6586
 SHA512:
-  metadata.gz: 12604d14213ae4bc6beba2507b6fcd27e540b32d3be966cbdc56816c844f73309e5b6518ea632441e17b7610d7321fcaf25bc2be6ba46659d2165907039c5375
-  data.tar.gz: 2676f58b2d881b8a9f321bebcaad712e165f2cc4520f419bdf7b41dab28e4330b72f278456265bd62e3c0101d953501d396435fec84c5281d1379de34637a938
+  metadata.gz: e047c4735a8ddf3a5f8c9afb36384a3b7b7f4e65be6a855bfa6b0a24bed4f5e19197f21ca30e37064809f4655d0fed5345bcf2166c087c643f10de48f5f552e3
+  data.tar.gz: db2212af6d815e7caa68facc95b636fb43f6ba7f50659d32fbc09050d7caefda4852b2664d66a364c646b8468d336a106b0d76d46357d9cc887d72d9044e66b8

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,33 @@
 All notable changes to AsciiChem are documented here.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.0.0.0] - 2026-11-13
+
+### Changed
+- **The gem renumbers onto the 1.0.0 engine.** The version scheme is
+  `{engine-semver}.{runtime-increment}`: the asciichem-rs engine is
+  1.0.0 and the gem's increment resets at the new engine major
+  (maintainer's call). The 0.31.x line was the pre-Rust gem line;
+  every future gem release derives from the engine semver. Was
+  0.31.17.
+
+## [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/benchmarks/parg_recheck.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # PARG gate + benchmark: AsciiChem::Engine.use(:parg) parses through
-# the compiled PARG artifact vendored from asciichem-parg, adapted to
+# the compiled PARG artifact vendored from asciichem-grammar, adapted to
 # the shared TransformRules. (1) gates on the shared corpus, forked
 # per case so a native crash aborts the child — reported, not fatal;
 # (2) gates on capture completeness (a grammar edit leaving a

data/lib/asciichem/engine/parg_engine.rb

@@ -15,7 +15,7 @@ end
 module AsciiChem
   module Engine
     # The PARG engine: parses through the compiled AsciiChem PARG
-    # artifact (grammar/asciichem.parg in asciichem-parg, vendored at
+    # artifact (grammar/asciichem.parg in asciichem-grammar, vendored at
     # lib/asciichem/engine/parg/asciichem.json) and adapts its parse
     # tree to the DSL shapes TransformRules consumes. The shared
     # conformance corpus passes model-identically (227/227) against
@@ -171,7 +171,7 @@ module AsciiChem
           raise NotAvailableError,
                 "vendored PARG artifact version #{version.inspect} does not match " \
                 "the engine's pinned grammar #{PARG_GRAMMAR_VERSION.inspect} — " \
-                're-vendor from asciichem-parg'
+                're-vendor from asciichem-grammar'
         end
       end
     end

data/lib/asciichem/engine.rb

@@ -5,7 +5,7 @@ module AsciiChem
   # slice 9; the maintainer's PARG-only directive). The legacy
   # parslet and DSL-parsanol engines are deleted — the checksummed
   # AsciiChem PARG artifact (vendored at engine/parg/asciichem.json,
-  # sourced from asciichem-parg) is the one grammar, and
+  # sourced from asciichem-grammar) is the one grammar, and
   # PargEngine adapts its tree to the DSL shapes TransformRules
   # consumes.
   module Engine

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 = "1.0.0.0"
 end

metadata

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