geneva_drive 0.7.0 → 0.9.0

data/test/dummy/db/sqlite/schema-8.1.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.1].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

data/test/dummy/db/sqlite3/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/sqlite3/schema-8.1.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.1].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_install/db/migrate/20260217112949_create_geneva_drive_workflows.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+# license: LGPLv3.0
+
+class CreateGenevaDriveWorkflows < ActiveRecord::Migration[7.2]
+  include GenevaDrive::MigrationHelpers
+
+  def change
+    create_table :geneva_drive_workflows, **geneva_drive_table_options do |t|
+      # Core identification (STI)
+      t.string :type, null: false, index: true
+
+      # Polymorphic association to the hero of the workflow
+      t.string :hero_type, null: false
+      t.column :hero_id, geneva_drive_key_type, null: false
+
+      # State machine
+      t.string :state, null: false, default: "ready", index: true
+
+      # Current position in workflow
+      t.string :current_step_name
+      t.string :next_step_name
+
+      # Multiple workflows of same type for same hero
+      t.boolean :allow_multiple, default: false, null: false
+
+      # Timestamps
+      t.datetime :started_at
+      t.datetime :transitioned_at
+
+      t.timestamps
+    end
+
+    # Polymorphic index
+    add_index :geneva_drive_workflows, [:hero_type, :hero_id]
+
+    reversible do |direction|
+      direction.up { create_db_specific_indices }
+    end
+  end
+
+  def create_db_specific_indices
+    # Database-specific uniqueness constraint for ongoing workflows
+    # Ensures only one ongoing workflow per (type, hero) unless allow_multiple is true
+    adapter = connection.adapter_name.downcase
+    if adapter.include?("postgresql")
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_workflows_unique_ongoing
+        ON geneva_drive_workflows (type, hero_type, hero_id)
+        WHERE state NOT IN ('finished', 'canceled') AND allow_multiple = false;
+      SQL
+    elsif adapter.include?("mysql")
+      execute <<-SQL
+        ALTER TABLE geneva_drive_workflows
+        ADD COLUMN ongoing_unique_key VARCHAR(767)
+        AS (
+          CASE
+            WHEN state NOT IN ('finished', 'canceled') AND allow_multiple = 0
+            THEN CONCAT(type, '-', hero_type, '-', hero_id)
+            ELSE NULL
+          END
+        ) STORED;
+      SQL
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_workflows_unique_ongoing
+        ON geneva_drive_workflows (ongoing_unique_key);
+      SQL
+    elsif adapter.include?("sqlite")
+      execute <<-SQL
+        CREATE UNIQUE INDEX index_geneva_drive_workflows_unique_ongoing
+        ON geneva_drive_workflows (type, hero_type, hero_id)
+        WHERE state NOT IN ('finished', 'canceled') AND allow_multiple = 0;
+      SQL
+    end
+  end
+end

data/test/dummy_install/db/migrate/20260217112950_create_geneva_drive_step_executions.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+# license: LGPLv3.0
+
+class CreateGenevaDriveStepExecutions < ActiveRecord::Migration[7.2]
+  include GenevaDrive::MigrationHelpers
+
+  def change
+    key_type = geneva_drive_key_type
+
+    create_table :geneva_drive_step_executions, **geneva_drive_table_options do |t|
+      # Link to workflow (cascade delete when workflow is deleted)
+      t.references :workflow,
+        null: false,
+        foreign_key: {to_table: :geneva_drive_workflows, on_delete: :cascade},
+        index: true,
+        type: key_type
+
+      # Which step this execution represents
+      t.string :step_name, null: false
+
+      # Execution state machine
+      t.string :state, null: false, default: "scheduled", index: true
+
+      # Outcome for audit purposes
+      t.string :outcome
+
+      # Scheduling
+      t.datetime :scheduled_for, null: false, index: true
+
+      # Execution tracking (individual timestamps for audit trail)
+      t.datetime :started_at
+      t.datetime :completed_at
+      t.datetime :failed_at
+      t.datetime :canceled_at
+      t.datetime :skipped_at
+
+      # Error tracking
+      t.string :error_class_name
+      t.text :error_message
+      t.text :error_backtrace
+
+      # Job tracking (for debugging)
+      t.string :job_id
+
+      t.timestamps
+    end
+
+    # Index for finding scheduled executions
+    add_index :geneva_drive_step_executions,
+      [:state, :scheduled_for],
+      name: "index_geneva_drive_step_executions_scheduled"
+
+    # Index for workflow execution history
+    add_index :geneva_drive_step_executions, [:workflow_id, :created_at]
+
+    # Index for common query patterns
+    add_index :geneva_drive_step_executions, [:workflow_id, :state]
+
+    reversible do |direction|
+      direction.up { create_db_specific_indices }
+    end
+  end
+
+  def create_db_specific_indices
+    # Database-specific uniqueness constraint for active step executions
+    # Ensures only one active (scheduled/in_progress) step per workflow
+    adapter = connection.adapter_name.downcase
+    if adapter.include?("postgresql")
+      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
+        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
+        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/20260217112951_add_finished_at_to_geneva_drive_step_executions.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# license: LGPLv3.0
+
+class AddFinishedAtToGenevaDriveStepExecutions < ActiveRecord::Migration[7.2]
+  def change
+    add_column :geneva_drive_step_executions, :finished_at, :datetime
+
+    add_index :geneva_drive_step_executions, :finished_at
+
+    reversible do |direction|
+      direction.up do
+        # Backfill finished_at from existing timestamp columns.
+        # Uses COALESCE to pick the first non-null value.
+        execute <<-SQL.squish
+          UPDATE geneva_drive_step_executions
+          SET finished_at = COALESCE(completed_at, failed_at, canceled_at, skipped_at)
+          WHERE finished_at IS NULL
+            AND (completed_at IS NOT NULL
+              OR failed_at IS NOT NULL
+              OR canceled_at IS NOT NULL
+              OR skipped_at IS NOT NULL)
+        SQL
+      end
+    end
+  end
+end

data/test/dummy_install/db/migrate/20260217112952_add_error_class_name_to_geneva_drive_step_executions.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# license: LGPLv3.0
+
+class AddErrorClassNameToGenevaDriveStepExecutions < ActiveRecord::Migration[7.2]
+  def change
+    add_column :geneva_drive_step_executions, :error_class_name, :string, if_not_exists: true
+  end
+end