atlas_rb 1.11.0 → 1.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58d8d5524e43dc1f14f172ea65bc1e78e55826a63c814f2ef517675d07732d08
-  data.tar.gz: 548d4cba38f7a2ef81f210612157ee36a56de6e15b5fcff367b4df1b73fda847
+  metadata.gz: 7bacb5eb215d1dd6d3df935abd82d74909ca81d1ce91f44de67f370846dbbd80
+  data.tar.gz: c6ea26efb6d7b083d2ede1455a126901bae8f446ece2997b441d7e593fdaba51
 SHA512:
-  metadata.gz: 745c494de1bd2da2a0048e2d3d562961bed6e48058b30da25dcbcdc0f9b2b7f3159c2b831508ac972a968dc6f02ee2a7f0a5cf11b85e2319277d1f200adf51f4
-  data.tar.gz: fe90db7467cdae4726357c2ba6d0d939d50c4174f1a3aa43ee8fd91adea19923fa321f53804fb52ed8db39eab22b578dadc6e542f77d54d1e1177e1effab0c53
+  metadata.gz: a9cc966ec7e7505b26ca5e5adaeacb78201b8f83c141d77a63c6ece959fce7de3c421e26274b7b943b964ad43ff32899a3da189ac4d9fdaebf43ed7cb9e5249c
+  data.tar.gz: 366a253542dfcf24f9e44ba4482c013ff426ec9b361b56636c2e2b96020a9b1ca738a93fa6f97d696b3b8bbd2e873ae761c7ceb4f8b8a5ef086bcf7c93ba2b5d

data/.version

@@ -1 +1 @@
-1.11.0
+1.11.1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.11.0)
+    atlas_rb (1.11.1)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)

data/lib/atlas_rb/work.rb

@@ -58,7 +58,10 @@ module AtlasRb
     #   omitted.
     # @return [AtlasRb::Mash] `{ "works" => [...], "pagination" => {...} }`.
     #   Each entry in `"works"` is a Work summary (`id`, `title`,
-    #   `description`, `in_progress`, `incomplete`, `incomplete_reason`).
+    #   `description`, `in_progress`, `incomplete`, `incomplete_reason`,
+    #   `handle`). `handle` is carried on the summary, not just the detail
+    #   read, so "which Works never minted?" is answerable from one page
+    #   rather than a fetch per row.
     #
     # @example Find stuck deposits
     #   AtlasRb::Work.list(in_progress: true)
@@ -220,11 +223,28 @@ module AtlasRb
     # "stuck" list.
     #
     # Idempotent on the server: calling `complete` on an already-complete
-    # Work is a no-op — Atlas simply re-saves with `in_progress: false`.
+    # Work is a no-op — Atlas re-saves with `in_progress: false`.
     # Atlas does not currently stamp a `completed_by` audit field; the
     # `nuid:` parameter is plumbed through for parity with the other
     # lifecycle bindings and in case Atlas adds completion audit later.
     #
+    # **This call also mints the Work's persistent identifier.** Atlas
+    # registers `<prefix>/<noid>` with its Handle service, pointed at the
+    # public Work page, and records it as `handle` on the Work. Two
+    # consequences for a caller:
+    #
+    # * **Minting can never fail the call.** A handle server that is down,
+    #   slow or unconfigured leaves `handle` null and the Work still
+    #   complete — never a non-2xx. So a `200` does not promise a handle:
+    #   the response body carries the Work, so check `handle` on it rather
+    #   than assuming success minted one.
+    # * **Re-completing is safe.** Atlas mints only when `handle` is empty,
+    #   and the underlying registration is keyed by handle name, so a repeat
+    #   call re-points rather than minting a second identifier.
+    #
+    # A deployment with no handle server configured mints nothing at all,
+    # which is the normal state for a stack brought up without it.
+    #
     # @param id [String] the Work ID.
     # @param nuid [String, nil] optional NUID of the acting user.
     # @param on_behalf_of [String, nil] optional NUID for the `On-Behalf-Of`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.11.1
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 2026-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday