ratomic 0.4.0-x86_64-darwin → 0.4.1-x86_64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12215452724efab8d2f4ffa4d3db8e0f96d48386a53ffda0a6d432c30ef6e451
-  data.tar.gz: d464217952e174043daa752d5c132847d4f5754ea1c27609c4ef78c9ac83669c
+  metadata.gz: 43b29ffe2514d33c566e176390dd5faa833a274e5d57f52cd573153badc69d77
+  data.tar.gz: 855796bfaba76f6f2ab09c89f45d7e4290710e000b31fa939835cb6b5167f63e
 SHA512:
-  metadata.gz: 57e4e77864cab642f2690bbb9c49d0cb97ac6c0b3d929cb1408519fe5b73631875f79ae8cb1b111852f2605b2ff6f4ca64d6d2c2960bc6a70eab0513447b722c
-  data.tar.gz: 98ac8e2fffb0b3db13460a15b1f404469397a753209738f0e93b88bf473167ce5a2a49f88b6df60d6c38f1442f8c8a9167cf793a50956fb0ce30ca81101bd693
+  metadata.gz: f3f11e53576f4e121749b042e3a29b06d1639eb97c50bf0bd4972653c1c63d225e85cf2e5bf7cc449114409316ab0e1ddb81e33f1047f5850e4e01a2ea0e33d8
+  data.tar.gz: 48f61a1c27a45c91d0c77d7f2181ca07c8bf0561f24ca4d09d7f21bba3b97d9e1f64bbf8a7fef7696c26f376cdd490c53bbb1b8de9f9e6bb428f41af2a0a4bbf

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 ## [Unreleased]
 
+## 0.4.1
+
+### Documentation
+
+- Document the `LocalPool` factory contract.
+- Clarify ownership-transfer versus resource-locality semantics.
+- Add guidance for designing Ractor-shareable factory objects.
+- Add examples of correct and incorrect factory implementations.
+- Improve `LocalPool` API documentation and YARD comments.
+
+### Smoke Tests
+
+- Add PostgreSQL smoke tests alongside Redis smoke tests.
+- Consolidate smoke-test documentation.
+- Add captured Redis and PostgreSQL validation snapshots.
+- Document expected outcomes and interpretation of smoke-test runs.
+
+### Validation
+
+Redis and PostgreSQL smoke tests now demonstrate:
+
+- successful Thread and Ractor execution
+- no `Ractor::MovedError`
+- no `Ractor::IsolationError`
+- successful queue draining
+- preservation of live resource ownership
+- safe reuse of Redis clients and PostgreSQL connections
+
+These tests validate that `LocalPool` is a general-purpose
+resource-locality primitive for stateful network clients rather
+than a Redis-specific abstraction.
+
 ## [0.4.0] - 2026-06-10
 
 ### Added
@@ -10,6 +42,8 @@
 * Added RBS definitions for `LocalPool`.
 * Expanded API documentation and usage examples.
 
+
+
 ### Design
 
 `Ratomic::Pool` and `Ratomic::LocalPool` serve different ownership models:

data/README.md

@@ -42,8 +42,8 @@ RBS signatures are included under `sig/` for downstream type checking.
 
 ## Examples And Benchmarks
 
-- [`redis_poc`](./redis_poc) contains local Redis scripts that exercise
-  `Ratomic::Map`, `Ratomic::Counter`, and `Ratomic::LocalPool` under Thread and
+- [`smoke_tests`](./smoke_tests) contains local Redis and PostgreSQL scripts that
+  exercise `Ratomic::LocalPool` with real stateful clients under Thread and
   Ractor workloads.
 - [`pgoutput-parser`](https://github.com/kanutocd/pgoutput-parser#relation-metadata-tracking)
   uses `Ratomic::Map` for relation metadata tracking in a real CDC pipeline
@@ -313,11 +313,12 @@ leave nested internal state unusable, producing errors such as
 `LocalPool` avoids that class of bug by not moving live resources at all. Work
 moves between Ractors. Live resources stay local.
 
-#### Redis smoke-test snapshot
+#### Redis and PostgreSQL smoke-test snapshots
 
-The Redis POC includes two scripts under `redis_poc/`.
+The smoke tests live under [`smoke_tests/`](./smoke_tests/) and exercise `LocalPool` with real
+Redis clients and PostgreSQL connections.
 
-`basic_redis.rb` exercises repeated Redis operations from both Threads and
+`redis/basic_redis.rb` exercises repeated Redis operations from both Threads and
 Ractors:
 
 ```text
@@ -328,7 +329,7 @@ Ractor
 [{"one" => 42419}, {"two" => 42186}, {"three" => 42400}, {"four" => 42206}, {"five" => 42568}]
 ```
 
-`queue_redis.rb` exercises a producer/consumer Redis queue workload:
+`redis/queue_redis.rb` exercises a producer/consumer Redis queue workload:
 
 ```text
 [:start, Ractor, 2026-06-10 01:17:57.584727984 +0800]
@@ -338,15 +339,24 @@ Ractor
 [:end, 2026-06-10 01:18:02.226310862 +0800]
 ```
 
-These numbers are a smoke-test snapshot, not a formal benchmark claim. The
+`postgres/basic_postgres.rb` exercises repeated PostgreSQL upserts from both
+Threads and Ractors. `postgres/queue_postgres.rb` exercises a table-backed
+producer/consumer workload using `FOR UPDATE SKIP LOCKED`.
+
+These numbers are smoke-test snapshots, not formal benchmark claims. The
 important interpretation is:
 
 - no `Ractor::MovedError`
 - no `Ractor::IsolationError`
 - no process crash
 - all produced queue items were consumed
-- Redis queues drained to zero
-- live Redis clients remained owned by the Ractor that created them
+- Redis queues and PostgreSQL table queues drained to zero
+- live Redis clients and PostgreSQL connections remained owned by the Ractor
+  that created them
+
+Redis proves the network-client shape. PostgreSQL proves the database-connection
+shape. Together they demonstrate that `LocalPool` is not Redis-specific; it is a
+resource-locality primitive for live stateful clients.
 
 #### Inception pool
 

data/lib/ratomic/version.rb

@@ -2,5 +2,5 @@
 
 module Ratomic
   # Current gem version string.
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratomic
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: x86_64-darwin
 authors:
 - Mike Perham