close_encounters 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67adeb4fe53671ebcc9e37f040245dd7650ec3afc83433e13415c290617ee356
-  data.tar.gz: e7afee308898aa7a25cf3ddfaa652369c74fdb074c014054ee37438babe0b714
+  metadata.gz: be9653e9826ea4a3ba675cc0a35c68eb9ff77404e8ae5569a2834682b4800a61
+  data.tar.gz: 8d61d965ce13c0e67a960bc90a4ace544ad215aa6d58f7c28c04a140258f6ab9
 SHA512:
-  metadata.gz: e0131dcd0a979e6bf3583fe3b90c91b597defbf0f660b8bfaaf2f8d2988a3b1714177148a6cec10078f1a69b8175de7c27d6bccc29523001264ca8c6f667e381
-  data.tar.gz: 117c8347983b35986897f55920c4d8472be867598901ca2e83bbf51f2560f083e8c6b9e27559f67c327faa66cbde30b93c1cdb19abd1e9356e792411992ff385
+  metadata.gz: 8f279069dfbdaa9aff1e4802d15950dbc03f6ad411bcb174f4935efb4a2bbe245cf920c6cd00a522365c8a45c56202ae5a06568a67ba6fdc4965ed101586bdba
+  data.tar.gz: 207655591aedb84b5cbf5b0e5a5c78e4d7239f3dd00d57978a46c227b3aca59cb52c89c99137adb46e0d7e50412785063b86579edc252b6428ded9c81e21333e

data/CHANGELOG.md

@@ -5,18 +5,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.2.4] - 2026-04-06
+
 ## [0.2.3] - 2025-09-08
 
 ### Fixed
 
 - Fix duplicate event creation in `scan` method when status and verification state are unchanged
-
-## [0.2.2] - 2025-09-04
-
-### Changed
-
-- Update handling of the same status for multiple requests when creating events.
-
-### Fixed
-
-- Ensure that status is an integer when creating events and comparing results.

data/README.md

@@ -67,5 +67,9 @@ Or install it yourself as:
 $ gem install close_encounters
 ```
 
+## Releasing
+
+This project is managed with [Reissue](https://github.com/SOFware/reissue). Releases are automated via the [shared release workflow](https://github.com/SOFware/reissue/blob/main/.github/workflows/SHARED_WORKFLOW_README.md). Trigger a release by running the "Release gem to RubyGems.org" workflow from the Actions tab.
+
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -20,6 +20,7 @@ require "reissue/gem"
 
 Reissue::Task.create :reissue do |task|
   task.version_file = "lib/close_encounters/version.rb"
+  task.push_finalize = :branch
 end
 
 require "standard/rake"

data/lib/close_encounters/version.rb

@@ -1,3 +1,3 @@
 module CloseEncounters
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 end

data/lib/close_encounters.rb

@@ -41,17 +41,30 @@ module CloseEncounters
     end
   end
 
+  VERIFIED_SIGNATURE = "ok"
+  UNVERIFIED_SIGNATURE = "unverified"
+
   # Record a verification of a contact with a third party service where the
   # verification is a callable which must also respond to to_s.
   #
+  # The verifier may return:
+  #   * true / :ok           — response is verified
+  #   * false / nil          — response failed verification (generic)
+  #   * any other value      — failed verification with a distinguishing
+  #                            "signature" (e.g. "missing:user.email").
+  #                            Stable signatures let scan suppress repeated
+  #                            identical failures while still recording when
+  #                            the failure mode changes meaningfully.
+  #
   # Creates a new event if:
-  # 1. The status has changed from the last recorded status
-  # 2. OR the status is in the verify_scan list AND verification fails
+  # 1. The status has changed from the last recorded status, OR
+  # 2. The status is in the verify_scan list AND the verification signature
+  #    differs from the last recorded signature.
   #
   # @param name [String] the name of the service
   # @param status [Integer] the HTTP status of the contact
   # @param response [String] the response object
-  # @param verifier [Proc] the verification callable which must also respond to to_s
+  # @param verifier [#call, #to_s] the verification callable
   def scan(name, status:, response:, verifier:)
     service = ParticipantService.find_by!(name:)
     status = status.to_i # Ensure status is always an integer
@@ -59,23 +72,38 @@ module CloseEncounters
     service.with_lock do
       last_event = service.events.newest.first
       last_status = last_event&.status
-      last_verified = last_event&.verified?
 
-      # Calculate current verification result
-      verified = verifier.call(response)
+      signature = signature_for(verifier.call(response))
+      verified = (signature == VERIFIED_SIGNATURE)
+      last_signature = signature_for_event(last_event)
+
+      metadata = {verified:, signature:, verification: verifier.to_s}
 
-      # Create a new event if:
-      # 1. Status has changed OR
-      # 2. Status is in verify_scan_statuses AND verified flag has changed
       if last_status != status
-        # Status changed, always create new event
-        service.events.create!(status:, response:, metadata: {verified:, verification: verifier.to_s})
-      elsif verify_scan_statuses.include?(status) && last_verified != verified
-        # Status same but verification result changed for a monitored status
-        service.events.create!(status:, response:, metadata: {verified:, verification: verifier.to_s})
+        service.events.create!(status:, response:, metadata:)
+      elsif verify_scan_statuses.include?(status) && last_signature != signature
+        service.events.create!(status:, response:, metadata:)
       end
     end
   end
+
+  # Normalize a verifier return value into a stable signature string.
+  def signature_for(result)
+    case result
+    when true, :ok then VERIFIED_SIGNATURE
+    when false, nil then UNVERIFIED_SIGNATURE
+    else result.to_s
+    end
+  end
+
+  # Read the signature off a previously stored event, falling back to the
+  # legacy verified flag for events created before signatures existed.
+  def signature_for_event(event)
+    return nil unless event
+    stored = event.metadata.to_h["signature"]
+    return stored if stored
+    event.verified? ? VERIFIED_SIGNATURE : UNVERIFIED_SIGNATURE
+  end
   alias_method :verify, :scan
   module_function :verify
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: close_encounters
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Jim Gay
@@ -142,7 +142,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Close Encounters of the Third Party
 test_files: []