solid_objects 0.17.1 → 0.17.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b918d2d78f5336b1eeda97b9f59560b6ef22cb4703524fd17c368c3fcb90b8d
-  data.tar.gz: 26483ce973457d40dceb52a14bb311417e476a9bd84ce8dc5f85e814a16db9af
+  metadata.gz: 5e79dde8294572943d3d728fb8a6a5e4e334a15ee8645ccd46c0ab2914c538da
+  data.tar.gz: 82550704291588ebbdd3ea2ba0579f02807ecfa2835ce2c25202fcfdf9443cca
 SHA512:
-  metadata.gz: 0ac2d7b510bd69aad30b8b32c8330725c08e52625ceca66a0cfde34e61f316b904aa2f21705473034096560479ff94dbc8c8a072b68e0a4e852de89c182f2bcc
-  data.tar.gz: 7061098cc192a52606d2957380d8a6a6d842e8a67c2c13aad0873efcfdad691bb0783fbb5252554a896d5a2424a88d24cfb5454bdb80990c5b20a6b9c65f8847
+  metadata.gz: 22f3ad5fe3c144a424cf74936780ab2196536b1d0c46ae71c47a14aef92f6815d842f43f791f398640f63651c0be5b473f715d3a008c00992a7995d78c7cfc5a
+  data.tar.gz: e678f2c1d603407b7f6d113d7a1c440f25e4481c300a2c040873883172979621823517cf341ec3128484a2ef7d683c485d69e6dcc550dffde62826aeb6a1d6cd

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.17.2 - 2026-10-08
+
+- The README names the agent guide at the start of Installation, and the agent
+  guide says that a reminder changes state only when it runs under
+  `solid_objects start`, so a query must not compute expiry from the clock.
+- `docs/agents.md` now tells agents to install the current release instead of
+  a remembered version, says that step 5 is required before the first call,
+  shows the two arguments of `reject`, and lists four API mistakes from
+  agent-written code with the correct form. The gem description now states
+  the Ruby 3.3 and Rails 7.1 requirement, because agents in the discovery
+  evaluation claimed Rails 8.0.
+- Claim the Context7 library: `context7.json` now carries the library `url` and
+  the maintainer `public_key`.
+- Add the Context7 refresh workflow. A push to `main` that changes the README,
+  `context7.json`, `docs/`, or `examples/` asks Context7 to refresh the index.
+  It uses the `CONTEXT7_API_KEY` repository secret.
+
 ## 0.17.1 - 2026-10-08
 
 - Name the category in the gem metadata and the README: Solid Objects is a

data/README.md

@@ -44,7 +44,8 @@ And so much more.
 
 ## Installation
 
-Solid Objects requires Ruby 3.3 or newer and Rails 7.1 or newer.
+Solid Objects requires Ruby 3.3 or newer and Rails 7.1 or newer. Coding agents
+should follow the [agent guide](docs/agents.md), which gives each step in order.
 
 ```bash
 bundle add solid_objects

data/docs/agents.md

@@ -64,6 +64,12 @@ bin/rails solid_objects:doctor
 The generator adds an initializer and copies migrations into the application.
 The doctor checks the configuration, the tables, and one real actor round trip.
 
+Install the current release. `bundle add solid_objects` selects it. Do not pin
+a version that you remember from earlier work; the API changed between
+releases. The current version is on <https://rubygems.org/gems/solid_objects>.
+
+The generated policies deny every call. Do step 5 before you call an actor.
+
 The `json` gem 3.x works only with Active Support 8.1.4 or newer. On Rails
 7.1, 7.2, 8.0, or 8.1 before 8.1.4, pin `gem "json", "~> 2"` in the
 `Gemfile`. Without the pin, Active Support raises an `ArgumentError`, such as
@@ -153,11 +159,25 @@ Obey these rules in actor code:
 - Use `schedule(at:, key:)` for delayed work. A reminder is one named alarm
   for each actor and key. A new `schedule` with the same key moves the alarm.
 - Use `reject(code, message)` for a business rule failure that must not retry.
+  It takes a code and a message, for example
+  `reject(:room_full, "The room is full")`.
 - Do not write Active Record models directly in a handler. The runtime raises
   `SolidObjects::ApplicationWriteForbidden`. Use `commit_action` for a short
   write in the same database.
 - Do not call an external API in a handler. Use `emit` and an effect handler.
 - Write each handler so that it can run again. Delivery is at least once.
+- A reminder changes state only when it runs, and it runs only while
+  `solid_objects start` runs. Do not compute expiry from the clock in a query;
+  read the state that the reminder committed.
+
+Avoid these mistakes:
+
+| Mistake | Correct form |
+| --- | --- |
+| `schedule(at: deadline)` with no operation after it | `schedule(at: deadline, key: buyer).expire(buyer:)`. `schedule` stages a reminder only when you call an operation on its result |
+| `reject "room full"` | `reject(:room_full, "The room is full")` |
+| `id` inside an actor | `actor_id`. An actor has no `id` method |
+| `register_effect(:name) { \|context, arguments\| ... }` | `register_effect(:name) { \|arguments, context\| ... }`. The arguments come first |
 
 [Reminders](reminders.md) and the [architecture guide](architecture.md) give
 the full actor API.

data/examples/quickstart/README.md

@@ -46,6 +46,9 @@ bin/rails db:migrate
 bin/rails solid_objects:doctor
 ```
 
+`bundle add solid_objects` installs the current release. Do not pin an older
+version from memory; the API changed between releases.
+
 The generator writes `config/initializers/solid_objects.rb` and copies the
 migrations. The migrations add the Solid Objects tables to the application's
 existing database.

data/lib/solid_objects/version.rb

@@ -1,5 +1,5 @@
 # rbs_inline: enabled
 
 module SolidObjects
-  VERSION = "0.17.1"
+  VERSION = "0.17.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_objects
 version: !ruby/object:Gem::Version
-  version: 0.17.1
+  version: 0.17.2
 platform: ruby
 authors:
 - Lucas Carlson
@@ -280,7 +280,8 @@ description: 'Solid Objects is a SQL-backed virtual actor library for Ruby on Ra
   with durable state, ordered operations, and automatic activation. It brings the
   Cloudflare Durable Objects programming model to Rails: addressable objects with
   ordered mailboxes, fenced activation, per-object reminders, transactional effects,
-  and reactive ERB. It runs on MySQL, PostgreSQL, and SQLite without Redis.'
+  and reactive ERB. It runs on MySQL, PostgreSQL, and SQLite without Redis, and requires
+  Ruby 3.3 or newer and Rails 7.1 or newer.'
 email:
 executables:
 - solid_objects