geneva_drive 0.7.0 → 0.8.0

data/test/dummy_install/db/migrate/20260217112953_add_resumable_step_support_to_geneva_drive_step_executions.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+# license: LGPLv3.0
+
+class AddResumableStepSupportToGenevaDriveStepExecutions < ActiveRecord::Migration[7.2]
+  def change
+    # Use database-native JSON type:
+    # - PostgreSQL: jsonb (indexed, efficient, supports containment queries)
+    # - MySQL 5.7+: json (native validation and storage)
+    # - SQLite: json (Rails handles as TEXT with serialization)
+    adapter = connection.adapter_name.downcase
+    if adapter.include?("postgresql")
+      add_column :geneva_drive_step_executions, :cursor, :jsonb
+    else
+      add_column :geneva_drive_step_executions, :cursor, :json
+    end
+
+    add_column :geneva_drive_step_executions, :completed_iterations, :integer, default: 0, null: false
+
+    reversible do |direction|
+      direction.up { update_unique_index_for_suspended_state }
+      direction.down { restore_original_unique_index }
+    end
+  end
+
+  private
+
+  def update_unique_index_for_suspended_state
+    # Update unique constraint to include 'suspended' as an active state.
+    # The constraint ensures only one active step execution per workflow.
+    adapter = connection.adapter_name.downcase
+
+    if adapter.include?("postgresql")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress', 'suspended');
+      SQL
+    elsif adapter.include?("mysql")
+      # Drop the old generated column and index
+      execute <<-SQL
+        DROP INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions;
+      SQL
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        DROP COLUMN active_unique_key;
+      SQL
+      # Create new generated column including suspended state
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        ADD COLUMN active_unique_key VARCHAR(767)
+        AS (
+          CASE
+            WHEN state IN ('scheduled', 'in_progress', 'suspended')
+            THEN CAST(workflow_id AS CHAR)
+            ELSE NULL
+          END
+        ) STORED;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (active_unique_key);
+      SQL
+    elsif adapter.include?("sqlite")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress', 'suspended');
+      SQL
+    end
+  end
+
+  def restore_original_unique_index
+    # Restore original unique constraint without 'suspended' state
+    adapter = connection.adapter_name.downcase
+
+    if adapter.include?("postgresql")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress');
+      SQL
+    elsif adapter.include?("mysql")
+      execute <<-SQL
+        DROP INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions;
+      SQL
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        DROP COLUMN active_unique_key;
+      SQL
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        ADD COLUMN active_unique_key VARCHAR(767)
+        AS (
+          CASE
+            WHEN state IN ('scheduled', 'in_progress')
+            THEN CAST(workflow_id AS CHAR)
+            ELSE NULL
+          END
+        ) STORED;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (active_unique_key);
+      SQL
+    elsif adapter.include?("sqlite")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress');
+      SQL
+    end
+  end
+end

data/test/dummy_install/db/migrate/20260217112954_add_chained_step_executions_to_geneva_drive_step_executions.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+# license: LGPLv3.0
+
+class AddChainedStepExecutionsToGenevaDriveStepExecutions < ActiveRecord::Migration[7.2]
+  include GenevaDrive::MigrationHelpers
+
+  def change
+    # Add continues_from_id to link chained step executions.
+    # Match the primary key type (bigint or uuid) of the step_executions table.
+    # No foreign key constraint — SQLite rewrites the table on add_foreign_key,
+    # which can destroy data.
+    add_column :geneva_drive_step_executions, :continues_from_id, geneva_drive_key_type
+    add_index :geneva_drive_step_executions, :continues_from_id
+
+    # Remove completed_iterations - it's unnecessary bookkeeping
+    remove_column :geneva_drive_step_executions, :completed_iterations, :integer
+
+    # Remove 'suspended' state - executions now complete and spawn successors
+    reversible do |direction|
+      direction.up do
+        # Convert any suspended executions to completed
+        execute <<-SQL
+          UPDATE geneva_drive_step_executions
+          SET state = 'completed'
+          WHERE state = 'suspended';
+        SQL
+
+        # Update unique constraint: only scheduled and in_progress are active
+        update_unique_index_without_suspended
+      end
+
+      direction.down do
+        restore_suspended_unique_index
+      end
+    end
+  end
+
+  private
+
+  def update_unique_index_without_suspended
+    adapter = connection.adapter_name.downcase
+
+    if adapter.include?("postgresql")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress');
+      SQL
+    elsif adapter.include?("mysql")
+      execute <<-SQL
+        DROP INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions;
+      SQL
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        DROP COLUMN active_unique_key;
+      SQL
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        ADD COLUMN active_unique_key VARCHAR(767)
+        AS (
+          CASE
+            WHEN state IN ('scheduled', 'in_progress')
+            THEN CAST(workflow_id AS CHAR)
+            ELSE NULL
+          END
+        ) STORED;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (active_unique_key);
+      SQL
+    elsif adapter.include?("sqlite")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress');
+      SQL
+    end
+  end
+
+  def restore_suspended_unique_index
+    adapter = connection.adapter_name.downcase
+
+    if adapter.include?("postgresql")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress', 'suspended');
+      SQL
+    elsif adapter.include?("mysql")
+      execute <<-SQL
+        DROP INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions;
+      SQL
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        DROP COLUMN active_unique_key;
+      SQL
+      execute <<-SQL
+        ALTER TABLE geneva_drive_step_executions
+        ADD COLUMN active_unique_key VARCHAR(767)
+        AS (
+          CASE
+            WHEN state IN ('scheduled', 'in_progress', 'suspended')
+            THEN CAST(workflow_id AS CHAR)
+            ELSE NULL
+          END
+        ) STORED;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (active_unique_key);
+      SQL
+    elsif adapter.include?("sqlite")
+      execute <<-SQL
+        DROP INDEX IF EXISTS index_geneva_drive_step_executions_one_active;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_step_executions_one_active
+        ON geneva_drive_step_executions (workflow_id)
+        WHERE state IN ('scheduled', 'in_progress', 'suspended');
+      SQL
+    end
+  end
+end

data/test/dummy_install/db/schema.rb

@@ -0,0 +1,75 @@
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# This file is the source Rails uses to define your schema when running `bin/rails
+# db:schema:load`. When creating a new database, `bin/rails db:schema:load` tends to
+# be faster and is potentially less error prone than running all of your
+# migrations from scratch. Old migrations may fail to apply correctly if those
+# migrations use external dependencies or application code.
+#
+# It's strongly recommended that you check this file into your version control system.
+
+ActiveRecord::Schema[8.1].define(version: 2026_02_17_112954) do
+  # These are extensions that must be enabled in order to support this database
+  enable_extension "pg_catalog.plpgsql"
+
+  create_table "geneva_drive_step_executions", force: :cascade do |t|
+    t.datetime "canceled_at"
+    t.datetime "completed_at"
+    t.bigint "continues_from_id"
+    t.datetime "created_at", null: false
+    t.jsonb "cursor"
+    t.text "error_backtrace"
+    t.string "error_class_name"
+    t.text "error_message"
+    t.datetime "failed_at"
+    t.datetime "finished_at"
+    t.string "job_id"
+    t.string "outcome"
+    t.datetime "scheduled_for", null: false
+    t.datetime "skipped_at"
+    t.datetime "started_at"
+    t.string "state", default: "scheduled", null: false
+    t.string "step_name", null: false
+    t.datetime "updated_at", null: false
+    t.bigint "workflow_id", null: false
+    t.index ["continues_from_id"], name: "index_geneva_drive_step_executions_on_continues_from_id"
+    t.index ["finished_at"], name: "index_geneva_drive_step_executions_on_finished_at"
+    t.index ["scheduled_for"], name: "index_geneva_drive_step_executions_on_scheduled_for"
+    t.index ["state", "scheduled_for"], name: "index_geneva_drive_step_executions_scheduled"
+    t.index ["state"], name: "index_geneva_drive_step_executions_on_state"
+    t.index ["workflow_id", "created_at"], name: "idx_on_workflow_id_created_at_af16a14fb2"
+    t.index ["workflow_id", "state"], name: "index_geneva_drive_step_executions_on_workflow_id_and_state"
+    t.index ["workflow_id"], name: "index_geneva_drive_step_executions_on_workflow_id"
+    t.index ["workflow_id"], name: "index_geneva_drive_step_executions_one_active", unique: true, where: "((state)::text = ANY ((ARRAY['scheduled'::character varying, 'in_progress'::character varying])::text[]))"
+  end
+
+  create_table "geneva_drive_workflows", force: :cascade do |t|
+    t.boolean "allow_multiple", default: false, null: false
+    t.datetime "created_at", null: false
+    t.string "current_step_name"
+    t.bigint "hero_id", null: false
+    t.string "hero_type", null: false
+    t.string "next_step_name"
+    t.datetime "started_at"
+    t.string "state", default: "ready", null: false
+    t.datetime "transitioned_at"
+    t.string "type", null: false
+    t.datetime "updated_at", null: false
+    t.index ["hero_type", "hero_id"], name: "index_geneva_drive_workflows_on_hero_type_and_hero_id"
+    t.index ["state"], name: "index_geneva_drive_workflows_on_state"
+    t.index ["type", "hero_type", "hero_id"], name: "index_geneva_drive_workflows_unique_ongoing", unique: true, where: "(((state)::text <> ALL ((ARRAY['finished'::character varying, 'canceled'::character varying])::text[])) AND (allow_multiple = false))"
+    t.index ["type"], name: "index_geneva_drive_workflows_on_type"
+  end
+
+  create_table "users", force: :cascade do |t|
+    t.boolean "active", default: true
+    t.datetime "created_at", null: false
+    t.string "email", null: false
+    t.string "name"
+    t.datetime "updated_at", null: false
+  end
+
+  add_foreign_key "geneva_drive_step_executions", "geneva_drive_workflows", column: "workflow_id", on_delete: :cascade
+end