rigid_workflow 1.0.0

data/app/views/rigid_workflow/runs/index.html.erb

@@ -0,0 +1,113 @@
+<div class="p-6 space-y-6">
+  <div class="flex items-center justify-between">
+    <div>
+      <%= link_to  overview_path, class: "text-sm text-gray-500 hover:text-gray-700 mb-2 block" do %>
+       Rigid Workflow »
+      <% end %>
+      <h1 class="text-3xl font-bold text-gray-900"><%= action_name.humanize %></h1>
+    </div>
+  </div>
+
+  <div class="flex items-center justify-between my-4">
+    <div class="text-sm text-gray-500"><%= page_entries_info @runs %></div>
+
+  <% if @runs.total_count > @runs.size %>
+    <div class="text-sm">
+      <%= paginate @runs %>
+    </div>
+  <% end %>
+  </div>
+
+  <div class="bg-white rounded-xl border border-gray-200 overflow-hidden relative" data-controller="selection">
+    <%= form_with url: runs_bulk_action_path, method: :post, data: { selection_target: "actionForm" } do |f| %>
+      <!-- Floating Action Bar -->
+      <div data-selection-target="actionBar" class="hidden absolute mt-1 ml-10 flex items-center shadow-lg border border-gray-200 rounded-lg overflow-hidden bg-white z-10">
+        <%= hidden_field_tag :bulk_action, "", data: { selection_target: "action" } %>
+        <div class="flex items-center divide-x divide-gray-200">
+          <button type="button" data-action="click->selection#submitBulk" data-type="retry" data-selection-target="actionButton" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white hover:bg-gray-50 flex items-center gap-2">
+            Retry <span data-selection-target="count" data-type="retry" class="ml-1 px-1.5 py-0.5 text-xs bg-gray-200 rounded-full">0</span>
+          </button>
+          <button type="button" data-action="click->selection#submitBulk" data-type="cancel" data-selection-target="actionButton" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white hover:bg-gray-50 flex items-center gap-2">
+            Cancel <span data-selection-target="count" data-type="cancel" class="ml-1 px-1.5 py-0.5 text-xs bg-gray-200 rounded-full">0</span>
+          </button>
+          <button type="button" disabled class="hidden px-4 py-2 text-sm font-medium text-gray-400 bg-gray-100 flex items-center gap-2" data-selection-target="noActions">
+            No actions
+          </button>
+          <button type="button" data-action="click->selection#deselectAll" class="px-2 py-2 text-gray-400 hover:text-gray-600">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/></svg>
+          </button>
+        </div>
+      </div>
+
+      <div class="overflow-x-auto">
+        <table class="w-full">
+          <thead class="bg-gray-50 border-b border-gray-200 ">
+            <tr>
+              <th class="px-4 py-3 text-left"><input type="checkbox" data-selection-target="selectAll" data-action="change->selection#toggleAll" class="cursor-default rounded border-gray-300 text-blue-600 focus:ring-blue-500" <%= 'disabled' if @runs.empty? %>></th>
+              <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Run ID</th>
+              <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Workflow</th>
+              <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Status</th>
+              <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Iters</th>
+              <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Started</th>
+              <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Duration</th>
+              <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Created</th>
+            </tr>
+          </thead>
+          <tbody class="bg-white divide-y divide-gray-200">
+            <% if @runs.any? %>
+              <% @runs.each do |run| %>
+                <tr class="cursor-pointer hover:bg-gray-50" data-actions="<%= run_actions_for(run.status) %>" data-id="<%= run.id %>" data-url="<%= runs_show_path(run) %>">
+                  <td class="px-4 py-4 text-left"><input type="checkbox" name="ids[]" data-selection-target="row" data-action="change->selection#toggleRow" class="cursor-default row-checkbox rounded border-gray-300 text-blue-600 focus:ring-blue-500" value="<%= run.id %>"></td>
+                  <td class="px-4 py-4 whitespace-nowrap text-xs font-mono text-gray-500 select-all"><%= run.id.to_s[0..12] %></td>
+                  <td class="px-4 py-4 whitespace-nowrap text-sm font-medium text-gray-900 select-all"><%= run.workflow_class %></td>
+                  <td class="px-4 py-4 whitespace-nowrap">
+                    <span class="<%= {
+                'pending' => 'bg-gray-100 text-gray-700',
+                'running' => 'bg-blue-100 text-blue-700',
+                'completed' => 'bg-green-100 text-green-700',
+                'failed' => 'bg-red-100 text-red-700',
+                'compensating' => 'bg-orange-100 text-orange-700'
+              }[run.status.to_s] || 'bg-gray-100 text-gray-700' %> px-2 py-1 rounded-full text-xs font-medium capitalize"><%= run.status %></span>
+                  </td>
+                  <td class="px-4 py-4 whitespace-nowrap text-sm text-gray-500"><%= run.iterations %></td>
+                  <td class="px-4 py-4 whitespace-nowrap text-sm text-gray-500"><%= format_datetime(run.started_at)  %></td>
+                  <td class="px-4 py-4 whitespace-nowrap text-sm text-gray-500"><%= format_duration(run.duration) %></td>
+                  <td class="px-4 py-4 whitespace-nowrap text-sm text-gray-500"><%= relative_time_in_words(run.created_at) %></td>
+                </tr>
+              <% end %>
+            <% else %>
+              <tr>
+                <td colspan="9" class="px-4 py-4 text-sm text-center text-gray-500">Nothing to see</td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% end %>
+  </div>
+
+  <% if @runs.total_count >= 20 %>
+  <div class="flex items-center justify-between my-4">
+    <div class="text-sm text-gray-500"><%= page_entries_info @runs %></div>
+
+    <% if @runs.total_count > @runs.size %>
+      <div class="text-sm">
+        <%= paginate @runs %>
+      </div>
+    <% end %>
+  </div>
+  <% end %>
+</div>
+
+<script>
+  document.addEventListener("turbo:load", () => {
+    const rows = document.querySelectorAll("tr[data-url]");
+    rows.forEach(row => {
+      row.addEventListener("click", (e) => {
+        if (e.target.type !== 'checkbox') {
+          window.location.href = row.dataset.url;
+        }
+      });
+    });
+  });
+</script>

data/app/views/rigid_workflow/runs/show.html.erb

@@ -0,0 +1,130 @@
+<div class="p-6 space-y-6">
+  <div class="flex items-center justify-between">
+    <div>
+      <%= link_to overview_path, class: "text-sm text-gray-500 hover:text-gray-700 mb-2 block" do %>
+       Rigid Workflow »
+      <% end %>
+      <h1 class="text-3xl font-bold text-gray-900"><%= @run.workflow_class %> <%= content_tag(:code, @run.id.to_s[0..12], class:"font-mono select-all") %></h1>
+    </div>
+    <div class="flex items-center" data-controller="selection">
+      <%= form_with url: runs_bulk_action_path, method: :post, data: { selection_target: "actionForm" }, class: "inline" do |f| %>
+        <% available_actions = run_actions_for(@run.status).split(",").map(&:strip) %>
+        <%= hidden_field_tag :bulk_action, "", data: { selection_target: "action" } %>
+        <%= hidden_field_tag "ids[]", @run.id, data: { selection_target: "actionIds" } %>
+        <div class="flex items-center shadow-lg border border-gray-200 rounded-lg overflow-hidden">
+          <button type="button" data-action="click->selection#submitBulk" data-type="retry" data-selection-target="actionButton" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white hover:bg-gray-50 border-r border-gray-200 <%= 'opacity-50 cursor-not-allowed' unless available_actions.include?("retry") %>" <%= "disabled" unless available_actions.include?("retry") %>>
+            Retry
+          </button>
+          <button type="button" data-action="click->selection#submitBulk" data-type="cancel" data-selection-target="actionButton" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white hover:bg-gray-50 <%= 'opacity-50 cursor-not-allowed' unless available_actions.include?("cancel") %>" <%= "disabled" unless available_actions.include?("cancel") %>>
+            Cancel
+          </button>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="bg-white p-4 border border-gray-300 rounded-lg">
+    <h2 class="text-lg font-semibold text-gray-900 mb-4">Run Details</h2>
+    <div class="grid grid-flow-col grid-rows-4 gap-4">
+      <% %w[created_at started_at finished_at updated_at duration id workflow_class version params status iterations].each do |key| %>
+        <% 
+          value = if @run.respond_to?(key)
+                    @run.send(key)
+                  elsif @run.attributes.key?(key)
+                    @run.attributes[key]
+                  else
+                    @run.try(key.to_sym)
+                  end
+        %>
+        <% next if value.nil? %>
+        <div class="space-y-1">
+          <p class="text-xs font-medium text-gray-400 uppercase"><%= key.humanize %></p>
+          <p class="text-sm text-gray-800">
+            <%= format_attribute(key, value) %>
+          </p>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="bg-white p-4 border border-gray-300 rounded-lg">
+    <h2 class="text-lg font-semibold text-gray-900 mb-4">Steps History</h2>
+    <% if @run.steps.any? %>
+      <% @run.steps.order(:id).each do |step| %>
+        <div class="mb-2 pb-2 border-b border-gray-100 last:border-0">
+          <div class="flex items-center justify-between">
+            <h3 class="font-medium text-gray-900">
+              <%= step.step_name %>
+              <span class="text-sm font-normal text-gray-500 ml-2"><%= step.activity_class %></span>
+            </h3>
+            <span class="<%= step.completed? ? 'bg-green-100 text-green-700' : step.failed? ? 'bg-red-100 text-red-700' : 'bg-blue-100 text-blue-700' %> px-2 py-1 rounded-full text-xs font-medium capitalize">
+              <%= step.status %>
+            </span>
+          </div>
+
+          <% if step.attempts.any? %>
+            <div class="mt-2 space-y-1">
+              <% step.attempts.order(:attempt_number).each do |attempt| %>
+                <div class="ml-4 px-3 py-1.5 bg-gray-50 rounded text-xs leading-tight">
+                  <div>
+                    <span class="font-medium">Attempt #<%= attempt.attempt_number %></span>
+                    <span class="<%= attempt.completed? ? 'text-green-600' : attempt.failed? ? 'text-red-600' : 'text-blue-600' %> ml-2"><%= attempt.status %></span>
+                    <% if attempt.started_at %>
+                      <span class="text-gray-400 ml-2">Started: <%= format_datetime(attempt.started_at) %></span>
+                    <% end %>
+                    <% if attempt.finished_at %>
+                      <span class="text-gray-400 ml-2">Finished: <%= format_datetime(attempt.finished_at) %></span>
+                    <% end %>
+                  </div>
+                  <% if attempt.error_details.present? %>
+                    <div class="text-red-500">
+                      <strong>Error:</strong> <%= attempt.error_details["message"] %>
+                    </div>
+                  <% end %>
+                </div>
+              <% end %>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    <% else %>
+      <p class="text-gray-500 text-sm">No steps recorded for this run.</p>
+    <% end %>
+  </div>
+
+  <div data-controller="workflow-viz" 
+       data-workflow-viz-run-id-value="<%= @run.id %>"
+       class="w-full border border-gray-300 rounded-lg bg-white p-4">
+    <div data-workflow-viz-target="chart" class="w-full"></div>
+
+    <!-- Templates -->
+    <template data-workflow-viz-target="stepDetailTemplate">
+      <h3 class="text-md font-semibold text-gray-900 mb-2">Step: <span data-field="name"></span></h3>
+      <div class="grid grid-cols-2 gap-4">
+        <p class="text-sm"><span class="font-medium text-gray-500">Started:</span> <span data-field="started"></span></p>
+        <p class="text-sm"><span class="font-medium text-gray-500">Finished:</span> <span data-field="finished"></span></p>
+        <p class="text-sm"><span class="font-medium text-gray-500">Status:</span> <span data-field="status"></span></p>
+        <p class="text-sm text-red-500 col-span-2 hidden" data-field="error-container"><span class="font-medium">Error:</span> <span data-field="error"></span></p>
+      </div>
+    </template>
+
+    <template data-workflow-viz-target="signalDetailTemplate">
+      <h3 class="text-md font-semibold text-gray-900 mb-2"><span data-field="type"></span>: <span data-field="name"></span></h3>
+      <div class="grid grid-cols-2 gap-4">
+        <p class="text-sm"><span class="font-medium text-gray-500">Started:</span> <span data-field="started"></span></p>
+        <p class="text-sm"><span class="font-medium text-gray-500">Finished:</span> <span data-field="finished"></span></p>
+        <p class="text-sm text-red-500 col-span-2 hidden" data-field="error-container"><span class="font-medium">Error:</span> <span data-field="error"></span></p>
+      </div>
+    </template>
+
+    <template data-workflow-viz-target="listItemTemplate">
+      <div class="border-b border-gray-100 py-2 flex items-center justify-between">
+        <div>
+          <span class="text-sm font-medium text-gray-900" data-field="name"></span>
+          <span class="text-xs text-gray-500 ml-2" data-field="type"></span>
+        </div>
+        <div class="text-sm text-gray-600" data-field="status"></div>
+      </div>
+    </template>
+  </div>
+</div>

data/app/views/rigid_workflow/workflows/index.html.erb

@@ -0,0 +1,82 @@
+
+<div class="p-6 space-y-6">
+  <div class="flex items-center justify-between">
+    <div>
+      <%= link_to overview_path, class: "text-sm text-gray-500 hover:text-gray-700 mb-2 block" do %>
+       Rigid Workflow »
+      <% end %>
+      <h1 class="text-3xl font-bold text-gray-900">Overview</h1>
+    </div>
+  </div>
+  <div class="bg-white rounded-xl border border-gray-200 overflow-hidden relative" data-controller="selection">
+    <!-- Floating Action Bar -->
+    <div data-selection-target="actionBar" class="hidden absolute mt-1 ml-10 flex items-center shadow-lg border border-gray-200 rounded-lg overflow-hidden bg-white z-10">
+      <%= form_with url: "#", method: :post, data: { selection_target: "actionForm" } do |f| %>
+        <div class="flex items-center divide-x divide-gray-200">
+          <button type="button" data-action="click->selection#deselectAll" class="px-2 py-2 text-gray-400 hover:text-gray-600">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/></svg>
+          </button>
+        </div>
+      <% end %>
+    </div>
+
+    <div class="overflow-x-auto">
+      <table class="w-full">
+        <thead class="bg-gray-50 border-b border-gray-200">
+          <tr>
+            <th class="px-4 py-3 text-left"><input type="checkbox" data-selection-target="selectAll" data-action="change->selection#toggleAll" class="cursor-default rounded border-gray-300 text-blue-600 focus:ring-blue-500"></th>
+            <th class="px-4 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Workflow</th>
+            <th class="px-4 py-3 text-center text-xs font-medium text-gray-500 uppercase tracking-wider">Completed</th>
+            <th class="px-4 py-3 text-center text-xs font-medium text-gray-500 uppercase tracking-wider">Active</th>
+            <th class="px-4 py-3 text-center text-xs font-medium text-gray-500 uppercase tracking-wider">Pending</th>
+            <th class="px-4 py-3 text-center text-xs font-medium text-gray-500 uppercase tracking-wider">Failed</th>
+            <th class="px-4 py-3 text-center text-xs font-medium text-gray-500 uppercase tracking-wider">Success %</th>
+            <th class="px-4 py-3 text-center text-xs font-medium text-gray-500 uppercase tracking-wider">Duration P50</th>
+          </tr>
+        </thead>
+        <tbody class="bg-white divide-y divide-gray-200">
+          <% total_completed = 0; total_active = 0; total_pending = 0; total_failed = 0 %>
+          <% @stats.each do |stat| %>
+            <% stat = stat.with_indifferent_access %>
+            <% total_completed += stat[:completed_runs].to_i %>
+            <% total_active += stat[:active_runs].to_i %>
+            <% total_pending += stat[:pending_runs].to_i %>
+            <% total_failed += stat[:failed_runs].to_i %>
+            <tr>
+              <td class="px-4 py-4 whitespace-nowrap"><input type="checkbox" data-selection-target="row" data-action="change->selection#toggleRow" class="cursor-default rounded border-gray-300 text-gray-600 focus:ring-gray-500" value="<%= stat[:workflow_class] %>"></td>
+              <td class="px-4 py-4 whitespace-nowrap text-sm font-medium text-gray-900"><%= stat[:workflow_class] %></td>
+              <td class="px-4 py-4 text-center whitespace-nowrap text-sm">
+                <%= link_to number_with_delimiter(stat[:completed_runs]), completed_runs_path(workflow: stat[:workflow_class]), class: "text-gray-600 hover:text-gray-800" %>
+              </td>
+              <td class="px-4 py-4 text-center whitespace-nowrap text-sm">
+                <%= link_to number_with_delimiter(stat[:active_runs]), active_runs_path(workflow: stat[:workflow_class]), class: "text-gray-600 hover:text-gray-800" %>
+              </td>
+              <td class="px-4 py-4 text-center whitespace-nowrap text-sm">
+                <%= link_to number_with_delimiter(stat[:pending_runs]), pending_runs_path(workflow: stat[:workflow_class]), class: "text-gray-600 hover:text-gray-800" %>
+              </td>
+              <td class="px-4 py-4 text-center whitespace-nowrap text-sm">
+                <%= link_to number_with_delimiter(stat[:failed_runs]), failed_runs_path(workflow: stat[:workflow_class]), class: "text-gray-600 hover:text-gray-800" %>
+              </td>
+              <td class="px-4 py-4 text-center whitespace-nowrap text-sm"><%= stat[:success_rate].to_f.round(1) %>%</td>
+              <td class="px-4 py-4 text-center whitespace-nowrap text-sm"><%= stat[:p50_duration] ? format_duration(ActiveSupport::Duration.parse(stat[:p50_duration])) : "-" %></td>
+            </tr>
+          <% end %>
+        </tbody>
+        <tfoot class="bg-gray-50 border-t border-gray-200">
+          <tr>
+            <td class="px-4 py-4"></td>
+            <td class="px-4 py-4"></td>
+            <td class="px-4 py-4 text-center text-sm font-bold text-gray-900"><%= number_with_delimiter(total_completed) %></td>
+            <td class="px-4 py-4 text-center text-sm font-bold text-gray-900"><%= number_with_delimiter(total_active) %></td>
+            <td class="px-4 py-4 text-center text-sm font-bold text-gray-900"><%= number_with_delimiter(total_pending) %></td>
+            <td class="px-4 py-4 text-center text-sm font-bold text-gray-900"><%= number_with_delimiter(total_failed) %></td>
+            <td class="px-4 py-4 text-center text-sm font-bold text-gray-900">
+              <% total_runs = total_completed + total_failed %>
+              <%= total_runs > 0 ? number_to_percentage(100.0 * total_completed / total_runs, precision: 1) : 0 %>
+            </td>
+            <td class="px-4 py-4"></td>
+          </tr>
+        </tfoot>
+      </table>
+    </div>
+  </div>

data/config/importmap.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+pin "@hotwired/turbo-rails", to: "turbo.min.js"
+pin "@hotwired/stimulus", to: "stimulus.min.js"
+pin "@hotwired/stimulus-loading", to: "stimulus-loading.js"
+pin "local-time", to: "local-time.es2017-esm.js"
+
+pin "rigid_workflow/application", to: "rigid_workflow/application.js"
+pin_all_from RigidWorkflow::Engine.root.join(
+               "app/javascript/rigid_workflow/controllers"
+             ),
+             under: "rigid_workflow/controllers"

data/config/routes.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+return if RigidWorkflow::Engine.routes.named_routes.names.include?(:overview)
+
+RigidWorkflow::Engine.routes.draw do
+  get "/" => "workflows#index", :as => :overview
+
+  scope :runs do
+    get "/" => "runs#index", :as => :runs
+    get "/pending" => "runs#pending_runs", :as => :pending_runs
+    get "/active" => "runs#active_runs", :as => :active_runs
+    get "/completed" => "runs#completed_runs", :as => :completed_runs
+    get "/failed" => "runs#failed_runs", :as => :failed_runs
+    get "/:id" => "runs#show", :as => :runs_show
+    post "/bulk_action" => "runs#bulk_action", :as => :runs_bulk_action
+  end
+end

data/lib/generators/rigid_workflow/activity_generator.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module RigidWorkflow
+  module Generators
+    # Generates a new activity class file.
+    class ActivityGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      def create_activity_file
+        template "activity.rb.erb",
+                 File.join("app/workflows/activities", "#{file_name}.rb")
+      end
+    end
+  end
+end

data/lib/generators/rigid_workflow/install_generator.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/migration"
+
+module RigidWorkflow
+  module Generators
+    # Installs RigidWorkflow into a Rails application.
+    # Generates initializer, routes, and optional migrations.
+    class InstallGenerator < ::Rails::Generators::Base
+      include Rails::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :with_migrations,
+                   type: :boolean,
+                   default: true,
+                   desc: "Generate migrations"
+
+      # Standard Rails migration timestamp format
+      def self.next_migration_number(dirname)
+        next_num = Time.now.utc.strftime("%Y%m%d%H%M%S").to_i
+        current_num = current_migration_number(dirname)
+        next_num <= current_num ? (current_num + 1).to_s : next_num.to_s
+      end
+
+      def install
+        template "initializer.rb.erb", "config/initializers/rigid_workflow.rb"
+        route "mount RigidWorkflow::Engine => '/admin/rigid_workflow'"
+
+        if options[:with_migrations]
+          migration_template(
+            "migration.rb.erb",
+            "db/migrate/create_rigid_workflow_tables.rb"
+          )
+        end
+
+        display_success_message
+      end
+
+      private
+
+      # Accessible inside your migration.rb.erb as <%= migration_version %>
+      def migration_version
+        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+      end
+
+      def display_success_message
+        say "\nRigidWorkflow installed successfully!", :green
+        say "\nNext steps:"
+        say "  1. Run: rails db:migrate"
+        say "  2. Define your workflow in app/workflows/"
+        say "  3. Start workflow: MyWorkflow(param: 1)"
+        say ""
+      end
+    end
+  end
+end

data/lib/generators/rigid_workflow/templates/activity.rb.erb

@@ -0,0 +1,6 @@
+class <%= class_name %>Activity < RigidWorkflow::Activity
+  def perform(**args)
+    # TODO: Implement activity logic
+    { result: 'success' }
+  end
+end

data/lib/generators/rigid_workflow/templates/initializer.rb.erb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# RigidWorkflow Configuration
+#
+# This initializer configures RigidWorkflow's behavior. All options have
+# sensible defaults - only configure what you need to override.
+#
+# SECURITY: The admin_controller is REQUIRED for authentication.
+# The engine's admin UI has NO built-in authentication.
+# Set this to a controller that already enforces authentication
+# (e.g., Admin::BaseController with Devise, or your custom admin controller).
+# The engine's ApplicationController will inherit from this class.
+# Without this, all workflow data is publicly accessible when mounted.
+RigidWorkflow.configure do |config|
+  # The controller to use for the admin UI. Inherit from your admin base controller
+  # to automatically apply authentication/authorization.
+  config.admin_controller = "MyAdminController"
+
+  # Maximum retry attempts for failed activities.
+  config.max_attempts = 3
+
+  # Base delay for exponential backoff retries (in seconds).
+  config.retry_delay = 15.seconds
+end

data/lib/generators/rigid_workflow/templates/migration.rb.erb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+class CreateRigidWorkflowTables < ActiveRecord::Migration[<%= migration_version.delete("[]") %>]
+  def change
+    create_table :rigid_workflow_runs, id: :string, if_not_exists: true do |t|
+      t.string :workflow_class, null: false
+      t.integer :version, default: 1, null: false
+      t.json :params, default: {}
+      t.json :memory, default: {}
+      t.string :status, default: "pending", null: false
+      t.integer :iterations, default: 0
+      t.datetime :started_at
+      t.datetime :finished_at
+      t.timestamps
+    end
+
+    add_index :rigid_workflow_runs, :workflow_class, if_not_exists: true
+    add_index :rigid_workflow_runs, :status, if_not_exists: true
+
+    create_table :rigid_workflow_steps, id: :string, if_not_exists: true do |t|
+      t.string :rigid_workflow_run_id, null: false
+      t.string :step_name, null: false
+      t.string :activity_class, null: false
+      t.json :input, default: {}
+      t.json :output, default: {}
+      t.json :error_details
+      t.string :status, default: "pending", null: false
+      t.integer :attempt, default: 1
+      t.integer :max_attempts, default: 3
+      t.datetime :started_at
+      t.datetime :finished_at
+      t.datetime :failed_at
+      t.datetime :scheduled_at
+      t.timestamps
+    end
+
+    add_index :rigid_workflow_steps, :rigid_workflow_run_id, if_not_exists: true
+    add_index :rigid_workflow_steps, :step_name, if_not_exists: true
+    add_index :rigid_workflow_steps, [:rigid_workflow_run_id, :step_name], unique: true, if_not_exists: true
+
+    create_table :rigid_workflow_signals, id: :string, if_not_exists: true do |t|
+      t.string :rigid_workflow_run_id, null: false
+      t.string :name, null: false
+      t.json :payload, default: {}
+      t.datetime :received_at
+      t.datetime :canceled_at
+      t.datetime :expires_at
+      t.timestamps
+    end
+
+    add_index :rigid_workflow_signals, :rigid_workflow_run_id, if_not_exists: true
+    add_index :rigid_workflow_signals, [:rigid_workflow_run_id, :name], unique: true, if_not_exists: true
+  end
+end

data/lib/generators/rigid_workflow/templates/workflow.rb.erb

@@ -0,0 +1,6 @@
+class <%= class_name %>Workflow < RigidWorkflow::Workflow
+  def run
+    # TODO: Define steps
+    # step :my_step, MyActivity
+  end
+end

data/lib/generators/rigid_workflow/workflow_generator.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module RigidWorkflow
+  module Generators
+    # Generates a new workflow class file.
+    class WorkflowGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      def create_workflow_file
+        template "workflow.rb.erb",
+                 File.join("app/workflows", "#{file_name}.rb")
+      end
+    end
+  end
+end

data/lib/rigid_workflow/activity.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module RigidWorkflow
+  # Base class for all activities.
+  # Activities represent a single, idempotent unit of work within a workflow.
+  class Activity
+    class_attribute :configs, default: { force_async: false }
+
+    # Forces all instances of this activity to run asynchronously.
+    # @param value [Boolean]
+    def self.force_async(value)
+      self.configs = self.configs.merge(force_async: value)
+      self
+    end
+
+    # @return [Boolean] Whether this activity is forced to run asynchronously
+    def self.force_async?
+      self.configs[:force_async] == true
+    end
+
+    # @api private
+    def initialize(step)
+      @workflow_run_id = step.rigid_workflow_run_id
+      @step_name = step.step_name
+      @step = step
+    end
+
+    # The main activity logic. Must be implemented by subclasses.
+    # @param args [Hash] Keyword arguments passed from the workflow step input
+    # @return [Object] The result of the activity, which will be persisted
+    def perform(**args)
+      return if Rails.env.test? && !RigidWorkflow.config.logging?
+      raise NotImplementedError, "Subclass must implement #perform"
+    end
+
+    # Logs a message associated with this activity execution.
+    # @param message [String]
+    def log(message, severity: Logger::INFO)
+      return if !RigidWorkflow.config.logging? && Rails.env.test?
+
+      puts message unless Rails.env.test?
+      Rails.logger.log(
+        severity,
+        "[#{@workflow_run_id.to_s[0..12]}][#{@step_name}] #{message}"
+      )
+    end
+
+    # Called during compensation to undo this activity's side effects.
+    # @step is available with full access to output/input via current_attempt.
+    # Override in subclasses. Default does nothing.
+    def compensate
+    end
+  end
+end

data/lib/rigid_workflow/engine.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module RigidWorkflow
+  # Rails engine for RigidWorkflow.
+  # Provides the plugin infrastructure for integrating with Rails applications.
+  class Engine < ::Rails::Engine
+    isolate_namespace RigidWorkflow
+
+    # Zeitwerk handles autoloading and reloading of the app/ but not the lib/.
+    initializer "rigid_workflow.zeitwerk" do
+      Rails.autoloaders.main.push_dir(Engine.root.join("lib/rigid_workflow"), namespace: RigidWorkflow)
+    end
+
+    initializer "rigid_workflow.assets" do |app|
+      app.config.assets.paths << root.join("app/assets/stylesheets")
+      app.config.assets.paths << root.join("app/javascript")
+    end
+
+    initializer "rigid_workflow.importmap", before: "importmap" do |app|
+      if app.config.respond_to?(:importmap)
+        app.config.importmap.paths << root.join("config/importmap.rb")
+
+        if Rails.env.development?
+          app.config.importmap.cache_sweepers << Engine.root.join(
+            "app/javascript"
+          )
+        end
+      end
+    end
+
+    initializer "rigid_workflow.assets.precompile" do |app|
+      app.config.assets.precompile += %w[rigid_workflow/application.css]
+    end
+  end
+end