rcrewai-rails 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e21a3a1057f9221cca3d280f2307b219d15a636995284c781404c4ed3d283fa6
-  data.tar.gz: 9b715b0cc17839eb5fb23f578905d962c4b6450d0aae2b8b1f494d549497a8b3
+  metadata.gz: ec3c830730933e9510d7749b89decd73af35f5b69e5f6f441a21d0cca9290b61
+  data.tar.gz: 698877cbbaf6cd49924144a585b5d32a4817ddd1e51307d34cd488f51ba5d0a7
 SHA512:
-  metadata.gz: 1be59f83c847e48c36b0ac61527ca9dedc61b903763be6145d6dd26354575a74d2dee3fc807a804e6f847660347c8368a28d70f33df6cb57d75d2b952b98657f
-  data.tar.gz: 0f37c9c304ef0264afeb363f07ca1b23c72045d9686869fe9325e336a79f30bc1930d08f97470a6235ad7d4dc8d1e5ebab4c78eb3de9d9ae1129ea42cb48dca8
+  metadata.gz: 94f1e5d38e34c5a8668a4c1be005d3fe4cf6e6e29353ea580de7581485262948af2824f166feb58e4903e59e3aef8dfd3eb1c3ecf8642da021b1f15e3025e89d
+  data.tar.gz: 71e6c33d7e34a248ce650556a1cb5bc900d20f282f02fccb82fe2fadd71744ea45fddb618962da777488213084f0048057817e6572f46f27320d40d685b6e14f

data/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-08-13
+
+### Fixed
+- **`rails db:migrate` raised `NameError` on 0.7.0.** The engine registers an
+  `RcrewAI` acronym inflection (Zeitwerk needs it to resolve
+  `rcrewai/rails/span.rb` to `RcrewAI::Rails::Span`), so Rails camelizes
+  `create_rcrewai_tables` to `CreateRcrewAITables` — but the shipped migrations
+  declared `CreateRcrewaiTables`. Rails resolves a migration's class from its
+  filename, so following the documented install verbatim failed. Nine migrations
+  in `db/migrate` and the install template were affected; all now declare the
+  name Rails derives. Thanks to the user who reported this from a real install.
+
+  **If you already installed 0.7.0** and renamed the class by hand, no action is
+  needed — your migration works. Otherwise, delete the copied migration, upgrade,
+  and re-run the install (or `rcrew_ai_rails:install:migrations`).
+
 ## [0.7.0] - 2026-08-13
 
 ### Added
@@ -36,6 +52,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `rcrewai >= 0.7.1` for agent-level tracing. On earlier 0.7.x versions traces
   contain only crew-level spans.
 
+### Upgrading
+- **Existing installs need two new migrations.** Do not run the install
+  generator (it creates every table and will fail on duplicates). Instead run
+  `rails rcrew_ai_rails:install:migrations && rails db:migrate` to copy only
+  what is missing: `010_create_rcrewai_spans` (the trace tree) and
+  `011_add_observation_rollups_to_rcrewai_executions` (cost/token totals). Both
+  are additive — nothing existing is altered or dropped. Observation is enabled
+  by default once the tables exist; set `config.observation_enabled = false` to
+  upgrade without turning tracing on.
+
 ## [0.6.1] - 2026-07-07
 
 ### Fixed
@@ -152,7 +178,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.7.0...HEAD
+[Unreleased]: https://github.com/gkosmo/rcrewai-rails/compare/v0.7.1...HEAD
+[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
 [0.6.1]: https://github.com/gkosmo/rcrewai-rails/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.5.1...v0.6.0

data/README.md

@@ -86,6 +86,40 @@ This will:
 - Add an initializer file for configuration
 - Mount the engine routes in `config/routes.rb`
 
+### Upgrading an existing install
+
+The install generator above is for **new** installs — it creates every table, so
+running it against an app that already has the RcrewAI tables will fail on
+duplicates.
+
+If you are already running rcrewai-rails, pull in only the migrations you are
+missing using the standard Rails engine task:
+
+```bash
+$ rails rcrew_ai_rails:install:migrations
+$ rails db:migrate
+```
+
+(The task name comes from the engine's railtie name, `rcrew_ai_rails`.)
+
+Rails copies only the migrations your app does not already have. Upgrading to
+0.7.0 from 0.6.x adds two:
+
+| Migration | Purpose |
+|---|---|
+| `010_create_rcrewai_spans` | `rcrewai_spans` and `rcrewai_span_events` — the observation engine's trace tree |
+| `011_add_observation_rollups_to_rcrewai_executions` | `total_cost_usd`, `total_tokens`, `span_count`, `error_count` on executions |
+
+Both are additive: no existing column or table is changed, and nothing is
+dropped. Existing crews, agents, tasks, and executions are unaffected, and
+observation is enabled by default once the tables exist. To upgrade the gem
+without turning tracing on, set `config.observation_enabled = false` in
+`config/initializers/rcrewai.rb` before migrating.
+
+If your schema was created by hand (the install generator did not copy a
+migration before 0.7.0, so this is likely), review the copied migrations before
+running `db:migrate` and delete any whose tables you already have.
+
 ### Manual Routes Setup
 
 If you need to mount the routes manually, add this to your `config/routes.rb`:

data/db/migrate/002_add_config_to_rcrewai_agents.rb

@@ -1,4 +1,4 @@
-class AddConfigToRcrewaiAgents < ActiveRecord::Migration[7.0]
+class AddConfigToRcrewAIAgents < ActiveRecord::Migration[7.0]
   def change
     # max_rpm and llm_config already exist on rcrewai_agents from the
     # original create table; only the 0.5.0 additions are new.

data/db/migrate/003_add_output_processing_to_rcrewai_tasks.rb

@@ -1,4 +1,4 @@
-class AddOutputProcessingToRcrewaiTasks < ActiveRecord::Migration[7.0]
+class AddOutputProcessingToRcrewAITasks < ActiveRecord::Migration[7.0]
   def change
     # output_file already exists on rcrewai_tasks from the original create
     # table; only the new 0.4/0.5 output-processing options are added here.

data/db/migrate/004_add_lifecycle_to_rcrewai_crews.rb

@@ -1,4 +1,4 @@
-class AddLifecycleToRcrewaiCrews < ActiveRecord::Migration[7.0]
+class AddLifecycleToRcrewAICrews < ActiveRecord::Migration[7.0]
   def change
     add_column :rcrewai_crews, :planning, :boolean, default: false, null: false
     add_column :rcrewai_crews, :planning_llm, :string

data/db/migrate/005_add_batch_id_to_rcrewai_executions.rb

@@ -1,4 +1,4 @@
-class AddBatchIdToRcrewaiExecutions < ActiveRecord::Migration[7.0]
+class AddBatchIdToRcrewAIExecutions < ActiveRecord::Migration[7.0]
   def change
     add_column :rcrewai_executions, :batch_id, :string
     add_index :rcrewai_executions, :batch_id

data/db/migrate/006_create_rcrewai_knowledge_sources.rb

@@ -1,4 +1,4 @@
-class CreateRcrewaiKnowledgeSources < ActiveRecord::Migration[7.0]
+class CreateRcrewAIKnowledgeSources < ActiveRecord::Migration[7.0]
   def change
     create_table :rcrewai_knowledge_sources do |t|
       t.references :owner, polymorphic: true, null: false

data/db/migrate/007_create_rcrewai_flows.rb

@@ -1,4 +1,4 @@
-class CreateRcrewaiFlows < ActiveRecord::Migration[7.0]
+class CreateRcrewAIFlows < ActiveRecord::Migration[7.0]
   def change
     create_table :rcrewai_flow_states do |t|
       t.string :state_id, null: false

data/db/migrate/008_add_consensus_agents_to_rcrewai_crews.rb

@@ -1,4 +1,4 @@
-class AddConsensusAgentsToRcrewaiCrews < ActiveRecord::Migration[7.0]
+class AddConsensusAgentsToRcrewAICrews < ActiveRecord::Migration[7.0]
   def change
     add_column :rcrewai_crews, :consensus_agents, :integer
   end

data/db/migrate/010_create_rcrewai_spans.rb

@@ -1,4 +1,4 @@
-class CreateRcrewaiSpans < ActiveRecord::Migration[7.0]
+class CreateRcrewAISpans < ActiveRecord::Migration[7.0]
   def change
     create_table :rcrewai_spans do |t|
       t.references :execution, null: false, foreign_key: { to_table: :rcrewai_executions }

data/db/migrate/011_add_observation_rollups_to_rcrewai_executions.rb

@@ -1,4 +1,4 @@
-class AddObservationRollupsToRcrewaiExecutions < ActiveRecord::Migration[7.0]
+class AddObservationRollupsToRcrewAIExecutions < ActiveRecord::Migration[7.0]
   def change
     add_column :rcrewai_executions, :total_cost_usd, :decimal, precision: 12, scale: 6
     add_column :rcrewai_executions, :total_tokens, :integer

data/lib/generators/rcrewai/rails/install/templates/create_rcrewai_tables.rb

@@ -1,4 +1,4 @@
-class CreateRcrewaiTables < ActiveRecord::Migration[7.0]
+class CreateRcrewAITables < ActiveRecord::Migration[7.0]
   def change
     create_table :rcrewai_crews do |t|
       t.string :name, null: false

data/lib/rcrewai/rails/version.rb

@@ -1,6 +1,6 @@
 module RcrewAI
   module Rails
-    VERSION = "0.7.0"
+    VERSION = "0.7.1"
     Version = VERSION
   end
 end

metadata

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