geneva_drive 0.7.0 → 0.9.0

data/lib/geneva_drive.rb

@@ -39,6 +39,7 @@ module GenevaDrive
   autoload :FlowControl, "geneva_drive/flow_control"
   autoload :StepDefinition, "geneva_drive/step_definition"
   autoload :ResumableStepDefinition, "geneva_drive/resumable_step_definition"
+  autoload :RemovedStepDefinition, "geneva_drive/removed_step_definition"
   autoload :StepCollection, "geneva_drive/step_collection"
   autoload :Workflow, "geneva_drive/workflow"
   autoload :StepExecution, "geneva_drive/step_execution"
@@ -49,12 +50,20 @@ module GenevaDrive
   autoload :ExceptionPolicy, "geneva_drive/exception_policy"
   autoload :JobOptions, "geneva_drive/job_options"
   autoload :CombinedExceptionPolicy, "geneva_drive/combined_exception_policy"
+  autoload :JsonColumn, "geneva_drive/json_column"
   autoload :MigrationHelpers, "geneva_drive/migration_helpers"
   autoload :TestHelpers, "geneva_drive/test_helpers"
 
+  # Dispatchers
+  autoload :ActiveJobDispatcher, "geneva_drive/dispatchers/active_job_dispatcher"
+  autoload :SidekiqDispatcher, "geneva_drive/dispatchers/sidekiq_dispatcher"
+
   # Jobs
+  autoload :StepExecutionLookup, "geneva_drive/jobs/step_execution_lookup"
   autoload :PerformStepJob, "geneva_drive/jobs/perform_step_job"
   autoload :HousekeepingJob, "geneva_drive/jobs/housekeeping_job"
+  autoload :SidekiqPerformStepJob, "geneva_drive/jobs/sidekiq_perform_step_job"
+  autoload :SidekiqHousekeepingJob, "geneva_drive/jobs/sidekiq_housekeeping_job"
 
   class << self
     # How long to keep completed workflows before cleanup.
@@ -178,6 +187,62 @@ module GenevaDrive
       Thread.current[:geneva_drive_inline_enqueue] = previous
     end
 
+    # Turns "this step execution should run" into a job: `:active_job` (the
+    # default, see ActiveJobDispatcher) or `:sidekiq` (see SidekiqDispatcher).
+    # Set it in an initializer, before any workflow class loads, since step
+    # job options are validated against it when a workflow class is defined.
+    #
+    # @example Run step jobs as native Sidekiq jobs
+    #   GenevaDrive.dispatcher = :sidekiq
+    #
+    # @return [#enqueue_step, #validate_job_options!]
+    def dispatcher
+      @dispatcher ||= GenevaDrive::ActiveJobDispatcher.new
+    end
+
+    # @param value [Symbol, #enqueue_step] `:active_job`, `:sidekiq`, or a
+    #   dispatcher object
+    # @return [void]
+    # @raise [ArgumentError] for anything else
+    def dispatcher=(value)
+      @dispatcher = case value
+      when :active_job
+        GenevaDrive::ActiveJobDispatcher.new
+      when :sidekiq
+        GenevaDrive::SidekiqDispatcher.new
+      else
+        unless value.respond_to?(:enqueue_step) && value.respond_to?(:validate_job_options!)
+          raise ArgumentError,
+            "GenevaDrive.dispatcher must be :active_job, :sidekiq, or an object responding to " \
+            "enqueue_step and validate_job_options! (got #{value.inspect})"
+        end
+        value
+      end
+    end
+
+    # Tells resumable steps running in this process to hand off at their next
+    # iteration boundary. Wired to Sidekiq's :quiet event by the engine, which
+    # fires on TSTP and at the start of every shutdown. Process-wide, unlike
+    # the thread-local flag the executor also honours.
+    #
+    # @return [void]
+    # @api private
+    def request_exit!
+      @exit_requested = true
+    end
+
+    # @return [Boolean] whether the host process asked running work to stop
+    # @api private
+    def exit_requested?
+      @exit_requested == true
+    end
+
+    # @return [void]
+    # @api private
+    def reset_exit_request!
+      @exit_requested = false
+    end
+
     # Returns true if job enqueueing should be deferred to after transaction commit.
     #
     # @return [Boolean]

data/test/dummy/config/database.yml

@@ -1,13 +1,48 @@
-# PostgreSQL configuration for GenevaDrive test suite
+<%
+  # Everything the database tasks write under db/ is adapter-specific, the
+  # schema dump above all: parallelize() builds every worker database out of
+  # that dump, and a PostgreSQL one carries jsonb columns SQLite cannot load.
+  # CI points DATABASE_URL at a different engine per leg, so each engine gets
+  # its own corner of db/ and the legs stop overwriting each other's artifacts.
+  #
+  # This has to be resolved here rather than in an initializer - db:prepare and
+  # the other database tasks hang off :load_config, which never runs those.
+  url = ENV["DATABASE_URL"]
+  adapter = if url
+    ActiveRecord::DatabaseConfigurations::ConnectionUrlResolver.new(url).to_hash[:adapter]
+  else
+    "sqlite3"
+  end
+
+  # MariaDB and MySQL are both the mysql2 adapter but do not produce the same
+  # dump - MariaDB has no JSON type - so the engine, when the runner names one,
+  # is what the artifacts get filed under.
+  engine = ENV.fetch("GENEVA_DRIVE_ENGINE", adapter)
+  artifacts = "db/#{engine}"
+
+  # The dump is keyed by Rails minor on top of that: it is written as
+  # `ActiveRecord::Schema[8.1].define`, and 7.2 refuses to load a version it
+  # has never heard of. The databases themselves are not version-specific -
+  # the migrations produce the same DDL - so only the dump gets the suffix.
+  schema_dump = "#{engine}/schema-#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}.rb"
+
+  # Rails only creates db/ itself, not the subdirectory the dump lives in.
+  require "fileutils"
+  FileUtils.mkdir_p(Rails.root.join(artifacts))
+%>
+# The test suite runs against SQLite by default so that a fresh clone can run
+# `rake` with no database server. CI - and `bin/matrix` locally - override this
+# with DATABASE_URL to also exercise PostgreSQL and MySQL.
 default: &default
-  adapter: postgresql
-  encoding: unicode
+  adapter: sqlite3
   pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
+  timeout: 5000
+  schema_dump: <%= schema_dump %>
 
 development:
   <<: *default
-  database: geneva_drive_development
+  database: storage/development.sqlite3
 
 test:
   <<: *default
-  database: geneva_drive_test
+  database: <%= artifacts %>/test.sqlite3

data/test/dummy/config/initializers/geneva_drive.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# How step jobs reach your queue.
+# - :active_job (the default) enqueues GenevaDrive::PerformStepJob through
+#   Active Job, onto whatever adapter the app uses.
+# - :sidekiq pushes GenevaDrive::SidekiqPerformStepJob, a plain Sidekiq::Job,
+#   straight through Sidekiq::Client - for apps that write Sidekiq jobs rather
+#   than Active Job ones. Schedule GenevaDrive::SidekiqHousekeepingJob then.
+#   Supports Sidekiq 7.3 and later 7.x, and 8.x.
+#
+# GenevaDrive.dispatcher = :active_job
+
+# How long to keep completed/canceled workflows before automatic deletion.
+# Set to nil to disable automatic cleanup.
+# When enabled, finished and canceled workflows older than this threshold
+# will be deleted along with their step execution records.
+#
+# GenevaDrive.delete_completed_workflows_after = 30.days
+
+# How long a step execution can be in "in_progress" state before being
+# considered stuck. This typically happens when a worker process crashes
+# mid-execution. The HousekeepingJob will recover these based on the
+# stuck_recovery_action setting.
+#
+# GenevaDrive.stuck_in_progress_threshold = 1.hour
+
+# How long a step execution can be past its scheduled_for time while
+# still in "scheduled" state before being considered stuck. This can
+# happen if jobs fail to enqueue or are lost by the queue backend.
+#
+# GenevaDrive.stuck_scheduled_threshold = 15.minutes
+
+# Action to take when recovering stuck step executions.
+# - :reattempt - Mark as recovered and schedule a retry (default)
+# - :cancel - Mark as recovered and cancel the workflow
+#
+# GenevaDrive.stuck_recovery_action = :reattempt
+
+# Maximum number of workflows/step executions to process in a single
+# housekeeping run. Prevents runaway processing if there's a large backlog.
+#
+# GenevaDrive.housekeeping_batch_size = 1000
+
+# Maximum size in bytes of a resumable step cursor once serialized to JSON.
+# The cursor is a position marker (an id, page number, or pagination token),
+# not a place to store the data being processed - it is rewritten on every
+# checkpoint and copied to every successor execution. Exceeding the limit
+# raises GenevaDrive::CursorTooLargeError. Set to nil to disable the check.
+#
+# GenevaDrive.max_cursor_size = 128.kilobytes
+
+# Maximum size in bytes of a signal payload once serialized to JSON.
+# A payload describes an event (an order id, an amount, a decision), not the
+# data the step is going to work on - that belongs on the hero. Exceeding the
+# limit raises GenevaDrive::SignalPayloadTooLargeError from Workflow#signal!,
+# before anything is persisted. Set to nil to disable the check.
+#
+# GenevaDrive.max_signal_payload_size = 128.kilobytes
+
+# How long a step execution may sit in the "waiting" state before
+# housekeeping counts it in the geneva_drive.waiting_overdue gauge.
+# Waiting indefinitely is legitimate, so this is not a timeout - it keeps
+# a stalled rendezvous from going unnoticed. Alert on the overdue gauge.
+# Set to nil to disable the gauge.
+#
+# GenevaDrive.waiting_visibility_threshold = 7.days
+
+# Whether to defer job enqueueing until after the database transaction commits.
+# In production this ensures step execution records are visible to job workers
+# before the job runs. In test environments (the default when Rails.env.test?)
+# this is set to false so that jobs are enqueued immediately — transactional
+# tests (especially with SQLite) never commit the outermost transaction, which
+# can cause after_commit callbacks to misbehave or not fire at all.
+#
+# Set to true in tests if you need strict transaction semantics for a specific
+# test suite, or if you are not using transactional tests.
+#
+# GenevaDrive.enqueue_after_commit = !Rails.env.test?

data/test/dummy/db/mysql/schema-8.1.rb

@@ -0,0 +1,95 @@
+# 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_10_25_000614) do
+  create_table "geneva_drive_signals", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
+    t.bigint "workflow_id", null: false
+    t.string "name", null: false
+    t.string "idempotency_key"
+    t.string "state", default: "pending", null: false
+    t.json "payload"
+    t.datetime "claimed_at"
+    t.datetime "consumed_at"
+    t.bigint "claimed", default: 0, null: false
+    t.bigint "consumed", default: 0, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["workflow_id", "name", "idempotency_key"], name: "index_geneva_drive_signals_dedup", unique: true
+    t.index ["workflow_id", "state"], name: "index_geneva_drive_signals_on_workflow_id_and_state"
+    t.index ["workflow_id"], name: "index_geneva_drive_signals_on_workflow_id"
+  end
+
+  create_table "geneva_drive_step_executions", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
+    t.bigint "workflow_id", null: false
+    t.string "step_name", null: false
+    t.string "state", default: "scheduled", null: false
+    t.string "outcome"
+    t.datetime "scheduled_for", null: false
+    t.datetime "started_at"
+    t.datetime "completed_at"
+    t.datetime "failed_at"
+    t.datetime "canceled_at"
+    t.datetime "skipped_at"
+    t.string "error_class_name"
+    t.text "error_message"
+    t.text "error_backtrace"
+    t.string "job_id"
+    t.text "metadata", size: :long
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.virtual "active_unique_key", type: :string, limit: 767, as: "(case when (`state` in (_utf8mb4'scheduled',_utf8mb4'in_progress')) then cast(`workflow_id` as char charset utf8mb4) else NULL end)", stored: true
+    t.datetime "finished_at"
+    t.json "cursor"
+    t.bigint "continues_from_id"
+    t.bigint "signal_id"
+    t.datetime "waiting_since"
+    t.index ["active_unique_key"], name: "index_geneva_drive_step_executions_one_active", unique: true
+    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 ["signal_id"], name: "index_geneva_drive_step_executions_on_signal_id"
+    t.index ["state", "scheduled_for"], name: "index_geneva_drive_step_executions_scheduled"
+    t.index ["state", "started_at"], name: "index_geneva_drive_step_executions_in_progress_started_at"
+    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"
+  end
+
+  create_table "geneva_drive_workflows", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
+    t.string "type", null: false
+    t.string "hero_type"
+    t.bigint "hero_id"
+    t.string "state", default: "ready", null: false
+    t.string "current_step_name"
+    t.string "next_step_name"
+    t.boolean "allow_multiple", default: false, null: false
+    t.text "metadata", size: :long
+    t.datetime "started_at"
+    t.datetime "transitioned_at"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.virtual "ongoing_unique_key", type: :string, limit: 767, as: "(case when ((`state` not in (_utf8mb4'finished',_utf8mb4'canceled')) and (`allow_multiple` = 0)) then concat(`type`,_utf8mb4'-',`hero_type`,_utf8mb4'-',`hero_id`) else NULL end)", stored: true
+    t.index ["hero_type", "hero_id"], name: "index_geneva_drive_workflows_on_hero_type_and_hero_id"
+    t.index ["ongoing_unique_key"], name: "index_geneva_drive_workflows_unique_ongoing", unique: true
+    t.index ["state"], name: "index_geneva_drive_workflows_on_state"
+    t.index ["type"], name: "index_geneva_drive_workflows_on_type"
+  end
+
+  create_table "users", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
+    t.string "email", null: false
+    t.string "name"
+    t.boolean "active", default: true
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+  end
+end

data/test/dummy/db/postgres/schema-8.1.rb

@@ -0,0 +1,99 @@
+# 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_10_25_000614) do
+  # These are extensions that must be enabled in order to support this database
+  enable_extension "pg_catalog.plpgsql"
+
+  create_table "geneva_drive_signals", force: :cascade do |t|
+    t.bigint "workflow_id", null: false
+    t.string "name", null: false
+    t.string "idempotency_key"
+    t.string "state", default: "pending", null: false
+    t.jsonb "payload"
+    t.datetime "claimed_at"
+    t.datetime "consumed_at"
+    t.bigint "claimed", default: 0, null: false
+    t.bigint "consumed", default: 0, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["workflow_id", "name", "idempotency_key"], name: "index_geneva_drive_signals_dedup", unique: true
+    t.index ["workflow_id", "state"], name: "index_geneva_drive_signals_on_workflow_id_and_state"
+    t.index ["workflow_id"], name: "index_geneva_drive_signals_on_workflow_id"
+  end
+
+  create_table "geneva_drive_step_executions", force: :cascade do |t|
+    t.bigint "workflow_id", null: false
+    t.string "step_name", null: false
+    t.string "state", default: "scheduled", null: false
+    t.string "outcome"
+    t.datetime "scheduled_for", null: false
+    t.datetime "started_at"
+    t.datetime "completed_at"
+    t.datetime "failed_at"
+    t.datetime "canceled_at"
+    t.datetime "skipped_at"
+    t.string "error_class_name"
+    t.text "error_message"
+    t.text "error_backtrace"
+    t.string "job_id"
+    t.jsonb "metadata"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.datetime "finished_at"
+    t.jsonb "cursor"
+    t.bigint "continues_from_id"
+    t.bigint "signal_id"
+    t.datetime "waiting_since"
+    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 ["signal_id"], name: "index_geneva_drive_step_executions_on_signal_id"
+    t.index ["started_at"], name: "index_geneva_drive_step_executions_in_progress_started_at", where: "((state)::text = 'in_progress'::text)"
+    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.string "type", null: false
+    t.string "hero_type"
+    t.bigint "hero_id"
+    t.string "state", default: "ready", null: false
+    t.string "current_step_name"
+    t.string "next_step_name"
+    t.boolean "allow_multiple", default: false, null: false
+    t.jsonb "metadata"
+    t.datetime "started_at"
+    t.datetime "transitioned_at"
+    t.datetime "created_at", 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.string "email", null: false
+    t.string "name"
+    t.boolean "active", default: true
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+  end
+
+  add_foreign_key "geneva_drive_signals", "geneva_drive_workflows", column: "workflow_id", on_delete: :cascade
+  add_foreign_key "geneva_drive_step_executions", "geneva_drive_workflows", column: "workflow_id", on_delete: :cascade
+end

data/test/dummy/db/sqlite/schema-7.2.rb

@@ -0,0 +1,96 @@
+# 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[7.2].define(version: 2026_10_25_090462) do
+  create_table "geneva_drive_signals", force: :cascade do |t|
+    t.integer "workflow_id", null: false
+    t.string "name", null: false
+    t.string "idempotency_key"
+    t.string "state", default: "pending", null: false
+    t.json "payload"
+    t.datetime "claimed_at"
+    t.datetime "consumed_at"
+    t.bigint "claimed", default: 0, null: false
+    t.bigint "consumed", default: 0, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["workflow_id", "name", "idempotency_key"], name: "index_geneva_drive_signals_dedup", unique: true
+    t.index ["workflow_id", "state"], name: "index_geneva_drive_signals_on_workflow_id_and_state"
+    t.index ["workflow_id"], name: "index_geneva_drive_signals_on_workflow_id"
+  end
+
+  create_table "geneva_drive_step_executions", force: :cascade do |t|
+    t.integer "workflow_id", null: false
+    t.string "step_name", null: false
+    t.string "state", default: "scheduled", null: false
+    t.string "outcome"
+    t.datetime "scheduled_for", null: false
+    t.datetime "started_at"
+    t.datetime "completed_at"
+    t.datetime "failed_at"
+    t.datetime "canceled_at"
+    t.datetime "skipped_at"
+    t.string "error_class_name"
+    t.text "error_message"
+    t.text "error_backtrace"
+    t.string "job_id"
+    t.text "metadata"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.datetime "finished_at"
+    t.json "cursor"
+    t.bigint "continues_from_id"
+    t.bigint "signal_id"
+    t.datetime "waiting_since"
+    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 ["signal_id"], name: "index_geneva_drive_step_executions_on_signal_id"
+    t.index ["started_at"], name: "index_geneva_drive_step_executions_in_progress_started_at", where: "state = 'in_progress'"
+    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 IN ('scheduled', 'in_progress')"
+  end
+
+  create_table "geneva_drive_workflows", force: :cascade do |t|
+    t.string "type", null: false
+    t.string "hero_type"
+    t.integer "hero_id"
+    t.string "state", default: "ready", null: false
+    t.string "current_step_name"
+    t.string "next_step_name"
+    t.boolean "allow_multiple", default: false, null: false
+    t.text "metadata"
+    t.datetime "started_at"
+    t.datetime "transitioned_at"
+    t.datetime "created_at", 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 NOT IN ('finished', 'canceled') AND allow_multiple = 0"
+    t.index ["type"], name: "index_geneva_drive_workflows_on_type"
+  end
+
+  create_table "users", force: :cascade do |t|
+    t.string "email", null: false
+    t.string "name"
+    t.boolean "active", default: true
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+  end
+
+  add_foreign_key "geneva_drive_signals", "geneva_drive_workflows", column: "workflow_id", on_delete: :cascade
+  add_foreign_key "geneva_drive_step_executions", "geneva_drive_workflows", column: "workflow_id", on_delete: :cascade
+end

data/test/dummy/db/sqlite/schema-8.0.rb

@@ -0,0 +1,96 @@
+# 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.0].define(version: 2026_10_25_000614) do
+  create_table "geneva_drive_signals", force: :cascade do |t|
+    t.integer "workflow_id", null: false
+    t.string "name", null: false
+    t.string "idempotency_key"
+    t.string "state", default: "pending", null: false
+    t.json "payload"
+    t.datetime "claimed_at"
+    t.datetime "consumed_at"
+    t.bigint "claimed", default: 0, null: false
+    t.bigint "consumed", default: 0, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["workflow_id", "name", "idempotency_key"], name: "index_geneva_drive_signals_dedup", unique: true
+    t.index ["workflow_id", "state"], name: "index_geneva_drive_signals_on_workflow_id_and_state"
+    t.index ["workflow_id"], name: "index_geneva_drive_signals_on_workflow_id"
+  end
+
+  create_table "geneva_drive_step_executions", force: :cascade do |t|
+    t.integer "workflow_id", null: false
+    t.string "step_name", null: false
+    t.string "state", default: "scheduled", null: false
+    t.string "outcome"
+    t.datetime "scheduled_for", null: false
+    t.datetime "started_at"
+    t.datetime "completed_at"
+    t.datetime "failed_at"
+    t.datetime "canceled_at"
+    t.datetime "skipped_at"
+    t.string "error_class_name"
+    t.text "error_message"
+    t.text "error_backtrace"
+    t.string "job_id"
+    t.text "metadata"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.datetime "finished_at"
+    t.json "cursor"
+    t.bigint "continues_from_id"
+    t.bigint "signal_id"
+    t.datetime "waiting_since"
+    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 ["signal_id"], name: "index_geneva_drive_step_executions_on_signal_id"
+    t.index ["started_at"], name: "index_geneva_drive_step_executions_in_progress_started_at", where: "state = 'in_progress'"
+    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 IN ('scheduled', 'in_progress')"
+  end
+
+  create_table "geneva_drive_workflows", force: :cascade do |t|
+    t.string "type", null: false
+    t.string "hero_type"
+    t.integer "hero_id"
+    t.string "state", default: "ready", null: false
+    t.string "current_step_name"
+    t.string "next_step_name"
+    t.boolean "allow_multiple", default: false, null: false
+    t.text "metadata"
+    t.datetime "started_at"
+    t.datetime "transitioned_at"
+    t.datetime "created_at", 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 NOT IN ('finished', 'canceled') AND allow_multiple = 0"
+    t.index ["type"], name: "index_geneva_drive_workflows_on_type"
+  end
+
+  create_table "users", force: :cascade do |t|
+    t.string "email", null: false
+    t.string "name"
+    t.boolean "active", default: true
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+  end
+
+  add_foreign_key "geneva_drive_signals", "geneva_drive_workflows", column: "workflow_id", on_delete: :cascade
+  add_foreign_key "geneva_drive_step_executions", "geneva_drive_workflows", column: "workflow_id", on_delete: :cascade
+end