pgbus 0.19.3 → 0.20.0

data/config/locales/sv.yml

@@ -140,6 +140,11 @@ sv:
         throughput: Genomströmning
         throughput_detail: jobb/min under de senaste %{minutes} min
         throughput_unavailable: kräver jobbstatistik (rails g pgbus:add_job_stats)
+        workflows: Arbetsflöden
+        workflows_attention:
+          one: "%{count} behöver uppmärksamhet"
+          other: "%{count} behöver uppmärksamhet"
+        workflows_detail: pågående (%{paused} pausade)
       verdict:
         links:
           dlq: Dead letters
@@ -723,6 +728,7 @@ sv:
         processes: Processer
         queues: Köer
         recurring: Återkommande
+        workflows: Arbetsflöden
       return_to_app: Tillbaka till appen
       title: Pgbus-instrumentpanel
       toggle_dark_mode: Växla mörkt läge
@@ -1023,3 +1029,439 @@ sv:
         disabled: Uppgift inaktiverad
         enabled: Uppgift aktiverad
         failed: Kunde inte ändra uppgift
+    workflow_insights:
+      back_to_classes: Alla arbetsflödesklasser
+      back_to_runs: Alla arbetsflödeskörningar
+      bad_request: 'Felaktig begäran: %{reason}'
+      capped: 'Begränsat till workflow_retention (%{retention}): slutförda och avbrutna körningar äldre än så raderas.'
+      few_samples:
+        one: n=%{count}, få mätvärden
+        other: n=%{count}, få mätvärden
+      index:
+        description: 'Hur varje arbetsflödesklass gick under %{window}: körningarna som pågår nu, körningarna som avslutades och hur lång tid en körning tar från start till slut.'
+        empty_hint: 'Definiera en underklass till Pgbus::Workflow och starta en körning: YourWorkflow.start!(subject, **arguments).'
+        empty_title: Ingen arbetsflödesklass har körts än.
+        headers:
+          attention: Behöver åtgärd
+          cancelled: Avbrutna
+          duration_p50: Varaktighet p50
+          duration_p95: Varaktighet p95
+          finished: Slutförda
+          ongoing: Pågående
+          paused: Pausade
+          workflow_class: Arbetsflödesklass
+        title: Arbetsflödesinsikter
+      links:
+        at_step: "%{status} körningar vid %{step}"
+        attention: körningar av %{workflow} som behöver åtgärd
+        cancelled: körningar av %{workflow} som avbröts i fönstret
+        cancelled_bucket: körningar som avbröts under perioden
+        finished: körningar av %{workflow} som slutfördes i fönstret
+        finished_bucket: körningar som slutfördes under perioden
+        ongoing: pågående körningar av %{workflow}
+        paused: pausade körningar av %{workflow}
+        started: körningar av %{workflow} som startade i fönstret
+        started_bucket: körningar som startade under perioden
+      not_found:
+        hint: Ingen underklass till Pgbus::Workflow och ingen körning heter %{workflow} (eller så misslyckades läsningen, se loggen).
+        title: Okänd arbetsflödesklass
+      not_loaded: Definitionen är inte laddad
+      not_loaded_hint: 'Klassen laddas inte längre i appen: stegen kommer från körningarnas rader, i den ordning körningarna nådde dem.'
+      percentile: "%{name} %{value}"
+      removed_in_flight:
+        one: "%{count} körning på borttaget steg %{step}"
+        other: "%{count} körningar på borttaget steg %{step}"
+      show:
+        by_revision:
+          all_steps: Alla steg
+          caption: 'Samma siffror för de fem senaste appversionerna som avslutade ett försök i fönstret, nyast först: en försämring efter en driftsättning syns som en rad.'
+          empty: Inget försök i det här fönstret registrerade en appversion (config.app_revision).
+          headers:
+            attempts: Försök
+            failed: Misslyckade
+            reattempted: Nya försök
+            revision: Version
+            run_time: Körtid
+            skipped: Överhoppade
+            step: Steg
+          seen_html: sedd %{from} till %{to}
+          title: Per appversion
+          worse: upp från %{rate} på %{revision}
+        charts:
+          durations:
+            between: "%{from}–%{to}"
+            caption:
+              one: Hur lång tid den %{count} körning som slutfördes i fönstret tog, från start till slut.
+              other: Hur lång tid de %{count} körningar som slutfördes i fönstret tog, från start till slut.
+            headers:
+              range: Varaktighet
+              runs: Körningar
+            over: "%{from} eller mer"
+            title: Varaktighet från start till slut
+            under: under %{to}
+          series:
+            cancelled: Avbrutna
+            finished: Slutförda
+            runs: Körningar
+            started: Startade
+          throughput:
+            caption: 'Körningar som startade, slutfördes och avbröts per %{bucket} under %{window}: %{started} startade, %{finished} slutförda, %{cancelled} avbrutna.'
+            headers:
+              cancelled: Avbrutna
+              finished: Slutförda
+              from: Från
+              started: Startade
+            title: Körningar per %{bucket}
+        description: 'Under %{window}: var körningarna är nu, hur varje steg presterar och var körningar stannar.'
+        funnel:
+          caption:
+            one: 'Av den %{count} körning som startade i fönstret: hur många som nådde varje steg och var den är nu.'
+            other: 'Av de %{count} körningar som startade i fönstret: hur många som nådde varje steg och var var och en är nu.'
+          empty: Ingen körning startade i det här fönstret.
+          headers:
+            now_here: Nu vid steget
+            reached: Nådde
+            share: Av startade
+            step: Steg
+          here:
+            cancelled:
+              one: "%{count} avbruten"
+              other: "%{count} avbrutna"
+            finished:
+              one: "%{count} slutförd"
+              other: "%{count} slutförda"
+            paused:
+              one: "%{count} pausad"
+              other: "%{count} pausade"
+            performing:
+              one: "%{count} körs"
+              other: "%{count} körs"
+            ready:
+              one: "%{count} schemalagd"
+              other: "%{count} schemalagda"
+            waiting:
+              one: "%{count} väntar"
+              other: "%{count} väntar"
+          title: Tratt
+        pipeline:
+          attempts:
+            one: "%{count} försök"
+            other: "%{count} försök"
+          caption: 'Varje steg i ordning: körningarna som står vid det nu, och hur dess försök som avslutades i fönstret gick.'
+          empty: 'Inga steg än: ingen körning av klassen har ett steg i fönstret och ingen pågår.'
+          failed: Misslyckade
+          kinds:
+            fan_out: Fan-out
+            removed: Borttaget
+            signal: Väntar på en signal
+            undeclared: Inte i definitionen
+          live:
+            paused: Pausade
+            performing: Körs
+            ready: Schemalagda
+            waiting: Väntar
+          now_label: Körningar vid steget nu
+          pickup: Upphämtning
+          reattempted: Nya försök
+          run_time: Körtid
+          skipped: Överhoppade
+          step_link: Pågående körningar vid %{step}
+          title: Pipeline
+          window_label: Försök som avslutades i fönstret
+        summary:
+          attention: Behöver åtgärd
+          cancelled: Avbrutna
+          duration: Varaktighet p50
+          finished: Slutförda
+          ongoing: Pågående
+          started: Startade
+      window_label: Tidsfönster
+      windows:
+        1h: den senaste timmen
+        24h: de senaste 24 timmarna
+        30d: de senaste 30 dagarna
+        7d: de senaste 7 dagarna
+    workflows:
+      actions:
+        bulk_cancel: Avbryt alla
+        bulk_resume: Återuppta alla
+        cancel: Avbryt
+        rerun: Kör om
+        resume: Återuppta
+        resume_at: Återuppta vid steg
+        run_now: Kör nu
+        signal: Skicka signal
+        skip_step: Hoppa över steg
+      attempt: försök %{attempt}
+      attention:
+        at_step_html: vid %{step}
+        back: "← Arbetsflöden"
+        cancel_all:
+          one: Avbryt alla %{count}
+          other: Avbryt alla %{count}
+        confirm:
+          cancel:
+            one: Avbryta körningen som har fastnat vid %{step}?
+            other: Avbryta alla %{count} körningar som har fastnat vid %{step}?
+          cancel_error:
+            one: Avbryta körningen som har fastnat vid %{step} på grund av %{error}?
+            other: Avbryta alla %{count} körningar som har fastnat vid %{step} på grund av %{error}?
+          resume:
+            one: Återuppta körningen som är pausad vid %{step}?
+            other: Återuppta alla %{count} körningar som är pausade vid %{step}?
+          resume_error:
+            one: Återuppta körningen som är pausad vid %{step} på grund av %{error}?
+            other: Återuppta alla %{count} körningar som är pausade vid %{step} på grund av %{error}?
+        description: Pågående körningar som väntar på en person, grupperade efter vad som stoppade dem. När orsaken är åtgärdad, agera på hela gruppen.
+        empty_hint: Ingen pågående körning är pausad, har fastnat, är försenad eller har väntat längre än workflow_waiting_visibility_threshold.
+        empty_title: Inget behöver uppmärksamhet.
+        first_seen_html: första gången %{time}
+        headers:
+          actions: Åtgärder
+          reason: Orsak
+          runs: Körningar
+          seen: Sedd
+          workflow: Arbetsflöde
+        last_seen_html: senast %{time}
+        only_class_html: Endast %{workflow}.
+        reasons:
+          overdue: 'Försenad: förfallen men inte hämtad'
+          paused_error: Pausad på grund av ett fel
+          paused_manual: Pausad för hand
+          stalled: 'Har fastnat: dess worker svarar inte längre'
+          waiting_overdue: Väntar för länge
+        resume_all:
+          one: Återuppta alla %{count}
+          other: Återuppta alla %{count}
+        show_all: Visa alla klasser
+        show_runs: Visa körningar
+        title: Behöver uppmärksamhet
+      audit:
+        by: "%{event} av %{actor}"
+        empty: Inga händelser registrerade.
+        headers:
+          what: Vad hände
+          when: När
+        title: Granskningslogg
+        with_reason: "%{sentence}: %{reason}"
+        with_step: "%{sentence} (%{step} #%{attempt})"
+      bad_request: 'Ogiltig förfrågan: %{reason}'
+      confirm:
+        cancel: Avbryta det här arbetsflödet? Dess öppna steg avbryts och det körs inte igen.
+        rerun: Starta det här arbetsflödet igen som en ny körning, med samma ämne och argument?
+        resume: Återuppta det här arbetsflödet?
+        resume_at: Återuppta det här arbetsflödet vid det valda steget? Dess öppna steg avbryts först.
+        run_now: Köra det schemalagda steget nu i stället för att vänta?
+        signal: Skicka den här signalen till arbetsflödet?
+        skip_step: Hoppa över steget som det här arbetsflödet väntar på och gå till nästa?
+      events:
+        cancelled: Avbruten
+        fan_out_finished: Fan-out slutförd
+        fan_out_opened: Fan-out öppnad
+        finished: Slutförd
+        late_completion_ignored: Sen slutförning ignorerad
+        paused: Pausad
+        rerun: Omkörd
+        rescheduled: Omschemalagd
+        resumed: Återupptagen
+        run_now: Kör nu
+        signal_claimed: Signal upptagen
+        signal_received: Signal mottagen
+        stall_detected: Stopp upptäckt
+        started: Startad
+        step_completed: Steg slutfört
+        step_failed: Steg misslyckades
+        step_reattempted: Steg försökt igen
+        step_scheduled: Steg schemalagt
+        step_skipped: Steg överhoppat
+        step_started: Steg startat
+        step_waiting: Steg väntar
+        wait_timed_out: Väntan tog slut
+      filters:
+        apply: Använd filter
+        clear: Rensa
+        created_from: Skapad från
+        created_to: Skapad till
+        ended_from: Avslutad från
+        ended_to: Avslutad till
+        error_class: Felklass
+        step: Aktuellt steg
+        subject_id: Ämnes-ID
+        subject_type: Ämnestyp
+        workflow_class: Arbetsflödesklass
+        workflow_id: Arbetsflödes-ID
+      flash:
+        bad_group: Den gruppen är inte giltig.
+        bulk_cancel:
+          one: Avbröt %{count}.
+          other: Avbröt %{count}.
+        bulk_cancel_skipped: Avbröt %{count}; %{skipped} hade redan gått vidare.
+        bulk_failed: "%{count} kunde inte ändras: %{reason}"
+        bulk_more: 'Fler körningar kan vänta: tryck igen för nästa %{cap}.'
+        bulk_resume:
+          one: Återupptog %{count}.
+          other: Återupptog %{count}.
+        bulk_resume_skipped: Återupptog %{count}; %{skipped} hade redan gått vidare.
+        cancel: Arbetsflödet avbröts.
+        choose_step: Välj ett steg att återuppta vid.
+        failed:
+          not_allowed: 'Inte utfört: körningen är nu %{status}.'
+          not_found: Det arbetsflödet finns inte längre.
+          other: "%{action} misslyckades: %{reason}"
+        payload_not_object: 'Inte skickad: payload är inte ett JSON-objekt.'
+        payload_too_large: 'Inte skickad: payload är över %{limit} byte.'
+        rerun: En ny körning startades.
+        resume: Arbetsflödet återupptogs.
+        resume_at: Arbetsflödet återupptogs vid %{step}.
+        run_now: Det schemalagda steget körs nu.
+        signal: Signalen %{name} skickades.
+        signal_duplicate: Signalen %{name} har redan levererats med den här nyckeln; inget nytt skickades.
+        signal_name_missing: 'Inte skickad: signalen behöver ett namn.'
+        skip_step: Steget hoppades över.
+      headers:
+        current_step: Aktuellt steg
+        last_activity: Senaste aktivitet
+        started: Startad
+        status: Status
+        subject: Ämne
+        workflow: Arbetsflöde
+      index:
+        attention_link:
+          one: Behöver uppmärksamhet (%{count})
+          other: Behöver uppmärksamhet (%{count})
+        description: 'Varaktiga körningar i flera steg: vad var och en gör och vad som händer härnäst.'
+        empty_hint: Välj en annan status eller rensa filtren. En körning startar med YourWorkflow.start!(subject, **arguments).
+        empty_title: Inga arbetsflöden matchar.
+        insights_link: Insikter per klass
+        status_label: Filtrera på status
+        title: Arbetsflöden
+      next:
+        cancelled_html: Avbruten %{ago}.
+        due_html: 'Redo: %{step} skulle ha körts %{ago} och väntar på en worker.'
+        finished_html: Slutförd %{ago}.
+        overdue_html: 'Försenad: %{step} skulle ha körts %{ago}; städningen skickar det igen.'
+        paused_error_html: 'Pausad vid %{step}: %{error} — återuppta eller avbryt.'
+        paused_manual_html: Pausad vid %{step} — återuppta eller avbryt.
+        performing_attempt_html: Kör %{step} (försök %{attempt}).
+        performing_html: Kör %{step}.
+        ready_html: 'Redo: %{step} körs härnäst.'
+        scheduled_html: 'Schemalagd: %{step} körs %{time}.'
+        unknown_html: 'Status: %{status}.'
+        waiting_batch_html: Väntar på gruppen %{batch} (%{done} av %{total} jobb klara).
+        waiting_signal_html: Väntar på signalen %{signal} sedan %{ago}.
+        waiting_signal_timeout_html: Väntar på signalen %{signal} sedan %{ago}. Väntan tar slut %{time}.
+        waiting_step_html: Väntar på %{step}.
+      not_found:
+        hint: Det kan ha avslutats och tagits bort efter workflow_retention, eller så kunde databasen inte läsas (se loggen).
+        title: Arbetsflödet hittades inte
+      outcomes:
+        cancelled: avbrutet
+        completed: slutfört
+        finished_early: avslutade körningen i förtid
+        paused: pausade körningen
+        reattempted: försökt igen
+        skipped: hoppat över
+      resume:
+        carry_on: 'Återuppta: fortsätt med %{step}'
+        continue: 'Återuppta: fortsätt med %{step}'
+        finish: 'Återuppta: avsluta körningen'
+        resend: 'Återuppta: skicka %{step} igen'
+        retry: 'Återuppta: försök %{step} igen'
+        rewait: 'Återuppta: vänta på %{step} igen'
+      show:
+        actions: Åtgärder
+        arguments: Argument
+        back: "← Arbetsflöden"
+        cancelled_at: Avbruten
+        class_missing: "%{workflow_class} är inte laddad i den här processen: körningen kan fortfarande avbrytas, men inte återupptas."
+        definition_outdated: 'Den här körningen startade på en äldre definition av %{workflow_class}: dess steg har ändrats sedan start.'
+        details: Detaljer
+        finished_at: Slutförd
+        no_arguments: Den här körningen har inga argument.
+        paused_at: Pausad
+        reason_hint: Sparas i granskningsloggen, bredvid vem som gjorde det.
+        reason_label: Orsak (valfri)
+        rerun_of: Omkörning av
+        reruns: Omkörd som
+        resume_at_label: Steg att återuppta vid
+      signal:
+        hint: Ett steg som väntar på den vaknar direkt; annars ligger den väntande tills ett steg tar den.
+        name: Signalnamn
+        payload: Payload (JSON)
+        send: Skicka signal
+        title: Skicka en signal
+      signal_statuses:
+        claimed: Upptagen
+        consumed: Förbrukad
+        pending: Väntande
+      signals:
+        empty: Inga signaler har levererats till den här körningen.
+        headers:
+          claimed: Upptagen
+          consumed: Förbrukad
+          idempotency_key: Idempotensnyckel
+          name: Signal
+          received: Mottagen
+          status: Status
+        payload: Payload
+        title: Signaler
+      statuses:
+        cancelled: Avbruten
+        finished: Slutförd
+        gone: borta
+        paused: Pausad
+        performing: Körs
+        ready: Redo
+        scheduled: Schemalagd
+        waiting: Väntar
+      step_statuses:
+        cancelled: Avbrutet
+        completed: Slutfört
+        failed: Misslyckat
+        in_progress: Körs
+        scheduled: Schemalagt
+        skipped: Hoppat över
+        waiting: Väntar
+      steps:
+        batch: grupp %{batch}
+        caused_by: Orsakad av %{error}
+        empty: Inga försök ännu.
+        headers:
+          finished: Slutförd
+          queued: Köad
+          ran: Körde
+          scheduled: Schemalagd
+          started: Startad
+          status: Status
+          step: Steg
+          waited: Väntade
+          worker: Worker
+        revision: revision %{revision}
+        show_backtrace: Visa backtrace
+        title: Försök
+        waiting_for: väntar sedan %{duration}
+        waits_for_html: väntar på %{signal}
+      tabs:
+        all: Alla
+        cancelled: Avbrutna
+        finished: Slutförda
+        ongoing: Pågående
+        paused: Pausade
+        performing: Körs
+        ready: Redo
+        waiting: Väntar
+      timeline:
+        caption: 'Varje försök, äldst överst: väntade (dess väntetid), köad (förfallen, ännu inte hämtad), körde (färgad efter utfall) och väntar (på en signal eller sin grupp), med pauserna på en egen rad. Försökstabellen nedan visar samma tider.'
+        empty: Inga försök ännu.
+        paused_period_html: Pausad %{from} i %{duration}
+        paused_row: Pausad
+        series:
+          paused: Pausad
+          queued: Köad
+          ran_cancelled: Körde, avbröts
+          ran_failed: Körde, misslyckades
+          ran_ok: Körde
+          ran_open: Körs
+          waited: Väntade
+          waiting: Väntar
+        title: Tidslinje

data/config/routes.rb

@@ -53,6 +53,32 @@ Pgbus::Engine.routes.draw do
   end
 
   resources :batches, only: %i[index show]
+
+  # The workflow insights (issue #549), declared before the workflows
+  # resource so /workflows/definitions is never read as a workflow_id. The
+  # class name is a constant path: OrderWorkflow or Billing::OrderWorkflow.
+  get "workflows/definitions", to: "workflow_definitions#index", as: :workflow_definitions
+  get "workflows/definitions/:workflow_class", to: "workflow_definitions#show", as: :workflow_definition,
+                                               constraints: { workflow_class: /[A-Z][A-Za-z0-9_]*(::[A-Z][A-Za-z0-9_]*)*/ }
+
+  # attention is a collection route, declared before the member routes so
+  # /workflows/attention is never read as a workflow_id.
+  resources :workflows, only: %i[index show], param: :workflow_id do
+    collection do
+      get :attention
+      post :bulk_resume
+      post :bulk_cancel
+    end
+    member do
+      post :resume
+      post :resume_at
+      post :run_now
+      post :signal
+      post :rerun
+      post :cancel
+      post :skip_step
+    end
+  end
   resources :processes, only: [:index]
 
   resources :events, only: %i[index show] do

data/lib/generators/pgbus/add_workflow_signals_generator.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+require_relative "migration_path"
+
+module Pgbus
+  module Generators
+    class AddWorkflowSignalsGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      include MigrationPath
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Add waiting workflow steps (fan_out, wait_for: signals, wait timeouts) to an installation " \
+           "that ran pgbus:add_workflows before them: the pgbus_workflow_signals table and five step columns"
+
+      class_option :database,
+                   type: :string,
+                   default: nil,
+                   desc: "Use a separate database for pgbus tables (e.g. --database=pgbus)"
+
+      def create_migration_file
+        migration_template "add_workflow_signals.rb.erb",
+                           File.join(pgbus_migrate_path, "add_pgbus_workflow_signals.rb")
+      end
+
+      def display_post_install
+        say ""
+        say "Pgbus workflow signals installed!", :green
+        say ""
+        say "Next steps:"
+        say "  1. Run: rails db:migrate#{migrate_command_suffix}"
+        say "  2. Restart pgbus: bin/pgbus start"
+        say ""
+        say "Wait for an outside event, or for a group of jobs:"
+        say "  step :capture, wait_for: :payment_confirmed, wait_timeout: 2.days do"
+        say "    PaymentGateway.capture(subject, received_signal.payload[\"amount\"])"
+        say "  end"
+        say ""
+        say "  fan_out :notify_vendors do |b|"
+        say "    b.add(*subject.vendors.map { |vendor| NotifyVendorJob.new(vendor.id) })"
+        say "  end"
+        say ""
+        say "  workflow.signal!(:payment_confirmed, payload: { amount: 42 }, idempotency_key: event_id)"
+        say ""
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::Migration.current_version}]"
+      end
+    end
+  end
+end

data/lib/generators/pgbus/add_workflows_generator.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+require_relative "migration_path"
+
+module Pgbus
+  module Generators
+    class AddWorkflowsGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      include MigrationPath
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Add the workflow tables (pgbus_workflows, pgbus_workflow_steps, pgbus_workflow_events) " \
+           "to an existing Pgbus installation"
+
+      class_option :database,
+                   type: :string,
+                   default: nil,
+                   desc: "Use a separate database for pgbus tables (e.g. --database=pgbus)"
+
+      def create_migration_file
+        migration_template "add_workflows.rb.erb",
+                           File.join(pgbus_migrate_path, "add_pgbus_workflows.rb")
+      end
+
+      def display_post_install
+        say ""
+        say "Pgbus workflows installed!", :green
+        say ""
+        say "Next steps:"
+        say "  1. Run: rails db:migrate#{migrate_command_suffix}"
+        say "  2. Restart pgbus: bin/pgbus start"
+        say ""
+        say "Define a workflow:"
+        say "  class SignupWorkflow < Pgbus::Workflow"
+        say "    step :welcome do"
+        say "      WelcomeMailer.with(user: subject).welcome.deliver_later"
+        say "    end"
+        say "  end"
+        say ""
+        say "  SignupWorkflow.start!(user)"
+        say ""
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::Migration.current_version}]"
+      end
+    end
+  end
+end

data/lib/generators/pgbus/templates/add_workflow_signals.rb.erb

@@ -0,0 +1,51 @@
+class AddPgbusWorkflowSignals < ActiveRecord::Migration<%= migration_version %>
+  # Waiting workflow steps (fan_out, wait_for: signals, wait timeouts) for an
+  # installation that ran pgbus:add_workflows before them. if_not_exists
+  # throughout, so pgbus:update can queue it on a half-migrated schema.
+  def up
+    add_column :pgbus_workflow_steps, :batch_id, :string, if_not_exists: true # fan_out: the batch this step waits on
+    add_column :pgbus_workflow_steps, :wait_for, :string, if_not_exists: true # the signal a parked step waits for
+    add_column :pgbus_workflow_steps, :signal_id, :bigint, if_not_exists: true # the signal it claimed
+    add_column :pgbus_workflow_steps, :waiting_since, :datetime, if_not_exists: true
+    add_column :pgbus_workflow_steps, :timeout_at, :datetime, if_not_exists: true # waiting_since + wait_timeout:
+    add_index :pgbus_workflow_steps, :batch_id,
+      name: "idx_pgbus_workflow_steps_batch", if_not_exists: true
+    add_index :pgbus_workflow_steps, [:status, :timeout_at],
+      name: "idx_pgbus_workflow_steps_timeout", if_not_exists: true
+
+    # One row per signal delivered to a run (Pgbus::WorkflowSignal):
+    # pending → claimed → consumed.
+    create_table :pgbus_workflow_signals, if_not_exists: true do |t|
+      t.string :workflow_id, null: false
+      t.string :name, null: false
+      t.jsonb :payload, null: false, default: {}
+      t.string :idempotency_key
+      t.string :status, null: false, default: "pending"
+      t.bigint :claimed_by_step_id
+      t.datetime :created_at, null: false
+      t.datetime :claimed_at
+      t.datetime :consumed_at
+    end
+
+    add_index :pgbus_workflow_signals, [:workflow_id, :idempotency_key],
+      unique: true, where: "idempotency_key IS NOT NULL",
+      name: "idx_pgbus_workflow_signals_idempotency", if_not_exists: true
+    add_index :pgbus_workflow_signals, [:workflow_id, :name, :status],
+      name: "idx_pgbus_workflow_signals_pending", if_not_exists: true
+    add_index :pgbus_workflow_signals, [:workflow_id, :status, :claimed_by_step_id],
+      name: "idx_pgbus_workflow_signals_claimed", if_not_exists: true
+    add_foreign_key :pgbus_workflow_signals, :pgbus_workflows,
+      column: :workflow_id, primary_key: :workflow_id, on_delete: :cascade, if_not_exists: true
+  end
+
+  def down
+    drop_table :pgbus_workflow_signals, if_exists: true
+    remove_index :pgbus_workflow_steps, name: "idx_pgbus_workflow_steps_timeout", if_exists: true
+    remove_index :pgbus_workflow_steps, name: "idx_pgbus_workflow_steps_batch", if_exists: true
+    remove_column :pgbus_workflow_steps, :timeout_at, if_exists: true
+    remove_column :pgbus_workflow_steps, :waiting_since, if_exists: true
+    remove_column :pgbus_workflow_steps, :signal_id, if_exists: true
+    remove_column :pgbus_workflow_steps, :wait_for, if_exists: true
+    remove_column :pgbus_workflow_steps, :batch_id, if_exists: true
+  end
+end