atlas_rb 1.27.3 → 1.27.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57da54874f04fe2d2b07757c8c062fe5a4e95aae8d843de69ed7bd53158b8122
-  data.tar.gz: af25098d8000917fac7e65121fc575dd38460ed23c2515e6309d2d230c9389ce
+  metadata.gz: 98ed27c0812607ce56681c0dd9b3ab4c17fc1224c7e3c36bf0aa5b4deb7527e9
+  data.tar.gz: 401ebcc7d93621d999c2b6441f0e470ee6b68c2081e0eb104e5f059330310004
 SHA512:
-  metadata.gz: 228ce5a5c9c2746628bea89760fd5b623d017a3511e2d8f59ce22401aa58499a2e82500da0fd76ba12dacd5e3d5fd772694f717b7312e98b0c2b8fec43c94ca2
-  data.tar.gz: 3b92e9cf2b59e766276a7654fa2769d5339b9b511f146aa429692b8f7d84dfa3a96b5575659b6ee923d64bc3b08bc1291f8245de75922b419ba9b276629a7043
+  metadata.gz: 604f5e4183097244b9759cbf0caf188abf45ca936a7f9a07f3a476a4cb05dee0aa23f65357114bbdd9525e85d2c6ae746f0dba330f05cc4f3b978ae077778900
+  data.tar.gz: e9d53ba6883acc6decc743d4e480a682918c7f6db19e550e97d5455836a31250a29430ba846df03fab075cd410cff11b6c01ffe257522898c47c9f27d708b723

data/.version

@@ -1 +1 @@
-1.27.3
+1.27.4

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.27.4
+
+Requires an Atlas that serves `GET /works/:id/health_check` (0.6.232 or later).
+
+### Added — `AtlasRb::Work.health_check`
+
+Reads a Work's green/yellow/red health grade and the findings behind it, each
+with a severity, a machine-readable code, the NOID it is about and a message.
+Atlas never re-hashes the bytes for this call, so `fixity_checked` is always
+false. Admin and devolved-admin tiers only; anyone else gets a
+`ResourceError` with status 403. `nil` on a 404.
+
 ## 1.27.3
 
 ### Changed — `Metrics.latency` documentation

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.27.3)
+    atlas_rb (1.27.4)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)
@@ -16,24 +16,24 @@ GEM
     base64 (0.3.0)
     connection_pool (2.5.5)
     diff-lcs (1.6.1)
-    faraday (2.14.4)
-      faraday-net_http (>= 2.0, < 3.5)
+    faraday (2.15.0)
+      faraday-net_http (>= 2.0, < 3.6)
       json
       logger
     faraday-follow_redirects (0.3.0)
       faraday (>= 1, < 3)
     faraday-multipart (1.2.0)
       multipart-post (~> 2.0)
-    faraday-net_http (3.4.4)
+    faraday-net_http (3.5.0)
       net-http (~> 0.5)
     faraday-net_http_persistent (2.3.1)
       faraday (~> 2.5)
       net-http-persistent (>= 4.0.4, < 5)
     faraday-retry (2.4.0)
       faraday (~> 2.0)
-    hashie (5.1.0)
+    hashie (5.2.0)
       logger
-    json (3.0.2)
+    json (3.1.0)
     jwt (2.10.3)
       base64
     logger (1.7.0)

data/lib/atlas_rb/work.rb

@@ -512,6 +512,48 @@ module AtlasRb
       end
     end
 
+    # Grade a Work's health green, yellow or red.
+    #
+    # Wraps `GET /works/<id>/health_check` (Atlas 0.6.232 or later). `grade` is
+    # `"green"` (viable), `"yellow"` (broken or degraded, nothing lost, so
+    # repairable in place) or `"red"` (bytes missing or corrupt, so it needs a
+    # restore or a re-deposit). Each of `findings` carries `severity`
+    # (`"advisory"`, `"repairable"` or `"fatal"`), a machine-readable `code`,
+    # the `subject` NOID it is about and a `message`. The codes are an open
+    # vocabulary: show one you do not recognise rather than failing on it.
+    #
+    # Atlas never re-hashes the bytes for this call, so `fixity_checked` is
+    # always `false`: a green means nothing is missing, not that the bytes
+    # were verified. Atlas allows it for the admin and devolved-admin tiers
+    # only; edit rights on the Work do not reach it.
+    #
+    # @param id [String] the Work ID.
+    # @param nuid [String, nil] optional acting user's NUID. On the relay-signing
+    #   path it is signed into the assertion `sub`; on the BYO-JWT (`ATLAS_JWT`)
+    #   path it is ignored (identity lives in the token).
+    # @param on_behalf_of [String, nil] optional NUID for the `On-Behalf-Of`
+    #   header. Falls through to {AtlasRb.config}.default_on_behalf_of when
+    #   omitted.
+    # @return [AtlasRb::Mash, nil] the report: `noid`, `grade`,
+    #   `fixity_checked` and `findings`.
+    #
+    #   `nil` when Atlas answers `404` — no such Work, or, with a misconfigured
+    #   `ATLAS_URL`, the route is not Atlas's at all.
+    # @raise [AtlasRb::ResourceError] on any non-2xx other than `404` / `410`
+    #   (a `403` for a caller below the delegate tier, a `5xx`, a proxy's
+    #   `503`), carrying Atlas's status and body so the failure is attributable
+    #   at the boundary.
+    # @example Show what needs repair
+    #   report = AtlasRb::Work.health_check("w-789", nuid: admin_nuid)
+    #   report.findings.reject { |f| f.severity == "advisory" }.each do |f|
+    #     puts "#{f.severity} #{f.code}: #{f.message}"
+    #   end
+    def self.health_check(id, nuid: nil, on_behalf_of: nil)
+      read_body(connection({}, nuid, on_behalf_of: on_behalf_of).get("#{ROUTE}#{id}/health_check")) do |body|
+        AtlasRb::Mash.new(body)
+      end
+    end
+
     # List a Work's page FileSets in order, each with its assets.
     #
     # Wraps `GET /works/<id>/file_sets` — the ordered, grouped sibling of

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.27.3
+  version: 1.27.4
 platform: ruby
 authors:
 - David Cliff
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -136,7 +135,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-description:
 email:
 - david.g.cliff@gmail.com
 executables: []
@@ -191,12 +189,10 @@ files:
 - lib/atlas_rb/version.rb
 - lib/atlas_rb/work.rb
 - sig/atlas_rb.rbs
-homepage:
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'false'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -211,8 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby gem for Atlas API.
 test_files: []