rcrewai-rails 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7987750789244c90f421923541a2132e3aab1f6891f6b706ed42544ea4ae2507
-  data.tar.gz: 99fe0af08b0ad8f1a4c5bccf93edd2285e32f5966f6c3d93c2f152c239074ffe
+  metadata.gz: 89c254df462d78758a78ea3ac3e54c2aef26cc0126f3c0db941ae2c0ad23b607
+  data.tar.gz: '029aab1519fbb10ac847dc043cdaa1dcaed493cce784a3186ef439ad3b9206bd'
 SHA512:
-  metadata.gz: edafeb7cbf6461861bee821981911a5262d0dff09ec034cbb4cb2de123fe5a31a135e25685b7ba756931c665a908cf41e369b474aa33bb7a4beab7b99fcc17a3
-  data.tar.gz: f2edb449ac6b178e62392e809b677c103456e1ec6141e35b3dcac52b15c3254c5af0abe7e3165ba2b5f95137b87fcbcae1cf9dfc2cb0082afe3da795af470c3b
+  metadata.gz: c69a4a28cf7927140a04724cf9e2e66e05cf777c12e7e259c5cb4d5e36b3e3ed68b31d2702cb337d2be009f1789408d1e7c91047f3e77252c7f77313943a18f0
+  data.tar.gz: 7cd18030c6621e9fbad921f4f3bd3d96680796a73238b907f7cc5bd877ae1e8e53d8eacdb6b9151de7c2000d3b27ea7e068b146ca6b300742d65275076f30907

data/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.1] - 2026-09-10
+
+### Fixed
+- **Enabling checkpointing without running the 0.8 migration failed mid-run.**
+  `CrewExecutionJob` built the default `ActiveRecordCheckpointStore` without
+  checking that its table existed, so the run raised
+  `ActiveRecord::StatementInvalid: Could not find table 'rcrewai_checkpoints'`
+  partway through — after tasks had already executed and been paid for, and
+  with nothing in the message naming the cause. The job now fails up front with
+  `CheckpointTableMissing`, whose message names the migration command to run.
+  It is `discard_on`'d rather than retried, since retrying cannot fix a missing
+  table. Configuring a custom `checkpoint_store` skips the check, and nothing
+  changes when checkpointing is off (the default).
+- **The test suite was order-dependent.** `real_migrate_spec` and
+  `upgrade_migrate_spec` called `ActiveRecord::Base.establish_connection` to get
+  a scratch database for migrating. The test database is sqlite3 `":memory:"`,
+  so that discarded the pool holding Combustion's schema, and reconnecting gave
+  an empty database — every later example lost its tables. The suite passed only
+  because those specs happened to run last: under `--order random` it failed
+  ~128 of 258 examples. Migrations now run against an isolated connection via
+  `ActiveRecord::Tasks::DatabaseTasks.migration_class`, leaving the suite's own
+  connection untouched.
+- **`rails_logger_tool_spec` leaked a fake `Rails.logger`** into every example
+  that ran after it. The fake accepts exactly one argument, so unrelated specs
+  logging through the real logger raised `ArgumentError: wrong number of
+  arguments`. It is now restored after each example.
+
+### Changed
+- Specs run in random order by default (`config.order = :random`), so an example
+  that leaks global state fails immediately instead of silently depending on
+  file order. Seeds are reproducible: `bundle exec rspec --seed 1234`.
+
 ## [0.8.0] - 2026-09-10
 
 Tracks **rcrewai 0.8.0**, which is backward compatible for this engine — the
@@ -242,7 +274,8 @@ existing agents, tasks, and crews build unchanged.
 ### Changed
 - Rename generators from `rcrew_a_i` to `rcrewai` namespacing.
 
-[Unreleased]: https://github.com/gkosmo/rcrewai-rails/compare/v0.8.0...HEAD
+[Unreleased]: https://github.com/gkosmo/rcrewai-rails/compare/v0.8.1...HEAD
+[0.8.1]: https://github.com/gkosmo/rcrewai-rails/compare/v0.8.0...v0.8.1
 [0.8.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.7.1...v0.8.0
 [0.7.1]: https://github.com/gkosmo/rcrewai-rails/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.6.1...v0.7.0

data/README.md

@@ -313,6 +313,11 @@ RCrewAI::Checkpoint.lineage(store, resumed.run_id)
 Any object responding to `save`/`load`/`list`/`delete` can replace the store via
 `config.checkpoint_store`.
 
+Checkpointing needs the `rcrewai_checkpoints` table, so run the migration when
+you enable it (see [Upgrading an existing install](#upgrading-an-existing-install)).
+If the table is missing, the job raises `CheckpointTableMissing` up front rather
+than failing partway through a run.
+
 ### LLM interceptors
 
 Hooks that run around every LLM request the engine's agents make — useful for

data/app/jobs/rcrewai/rails/crew_execution_job.rb

@@ -1,9 +1,16 @@
 module RcrewAI
   module Rails
     class CrewExecutionJob < ActiveJob::Base
+      # Raised when checkpointing is enabled but its table is missing, which
+      # means the 0.8 migration has not been run.
+      class CheckpointTableMissing < StandardError; end
+
       queue_as { RcrewAI::Rails.config.job_queue_name }
 
       retry_on StandardError, wait: :exponentially_longer, attempts: 3
+      # A missing table is a configuration problem: retrying cannot fix it and
+      # only delays the error the operator needs to see.
+      discard_on CheckpointTableMissing
 
       def perform(crew, inputs = {}, batch_id: nil, resume_run_id: nil)
         execution = crew.executions.create!(
@@ -69,7 +76,24 @@ module RcrewAI
                   end
         return nil unless enabled
 
-        RcrewAI::Rails.config.checkpoint_store || ActiveRecordCheckpointStore.new
+        store = RcrewAI::Rails.config.checkpoint_store
+        return store if store
+
+        ensure_checkpoint_table!
+        ActiveRecordCheckpointStore.new
+      end
+
+      # Checkpointing was turned on but the 0.8 migration has not been run, so
+      # the default store has no table to write to. Failing here with the fix
+      # in the message beats an ActiveRecord::StatementInvalid raised partway
+      # through the run, once tasks have already been executed and paid for.
+      def ensure_checkpoint_table!
+        return if Checkpoint.table_exists?
+
+        raise CheckpointTableMissing,
+              "checkpointing is enabled but the #{Checkpoint.table_name} table does not exist. " \
+              "Run `rails rcrew_ai_rails:install:migrations && rails db:migrate` to add it, " \
+              "or set config.checkpoint_enabled = false."
       end
 
       # Translates rcrewai events into the span tree. Returns nil when

data/lib/rcrewai/rails/version.rb

@@ -1,6 +1,6 @@
 module RcrewAI
   module Rails
-    VERSION = "0.8.0"
+    VERSION = "0.8.1"
     Version = VERSION
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rcrewai-rails
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - gkosmo