job-workflow 0.5.0 → 0.6.1

data/lib/job_workflow/sub_task_job.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module JobWorkflow
+  class SubTaskJob < ActiveJob::Base
+    include ActiveJob::Continuable
+
+    class << self
+      #:  (context: Context) -> SubTaskJob
+      def from_parent_context(context:)
+        validate_sub_task_context!(context)
+
+        new_context = context.dup
+        job = new(context.arguments.to_h)
+        new_context._job = job
+        job._context = new_context
+        task = new_context._task_context.task || (raise "task is not set")
+        return job if task.enqueue.queue.nil?
+
+        job.set(queue: task.enqueue.queue)
+      end
+
+      private
+
+      #:  (Context) -> void
+      def validate_sub_task_context!(context)
+        task_context = context._task_context
+        raise ArgumentError, "task_context.task is required" if task_context.task.nil?
+        raise ArgumentError, "task_context.parent_job_id is required" if task_context.parent_job_id.nil?
+      end
+    end
+
+    #:  (Hash[untyped, untyped]) -> void
+    def perform(arguments)
+      payload = arguments.symbolize_keys
+      self._context = build_context(payload)
+      Runner.new(context: _context).run
+    end
+
+    #:  () -> Output
+    def output
+      context = _context
+      raise "context is not set." if context.nil?
+
+      context.output
+    end
+
+    attr_accessor :_context #: Context?
+
+    #:  () -> Hash[String, untyped]
+    def serialize
+      super.merge({ "job_workflow_context" => _context&.serialize || serialized_job_workflow_context }.compact)
+    end
+
+    #:  (Hash[String, untyped]) -> void
+    def deserialize(job_data)
+      super
+      self.serialized_job_workflow_context = job_data["job_workflow_context"]
+    end
+
+    private
+
+    attr_accessor :serialized_job_workflow_context #: Hash[String, untyped]?
+
+    #:  (Hash[Symbol, untyped]) -> Context
+    def build_context(payload)
+      context_data = extract_context_data(payload)
+      parent_job_id = context_data.fetch("task_context").fetch("parent_job_id")
+      parent_job_data = QueueAdapter.current.find_job(parent_job_id)
+      raise WorkflowStatus::NotFoundError, "Workflow with job_id '#{parent_job_id}' not found" if parent_job_data.nil?
+
+      workflow = resolve_workflow(parent_job_data.fetch("class_name"))
+      Context.deserialize(context_data.merge("job" => self, "workflow" => workflow))
+             ._update_arguments(payload.except(:job_workflow_context))
+    end
+
+    #:  (job_class_name: String) -> Workflow
+    def resolve_workflow(job_class_name)
+      job_class = JobWorkflow::DSL._included_classes.to_a.reverse.find { |klass| klass.name == job_class_name }
+      job_class ||= job_class_name.safe_constantize
+      raise NameError, "uninitialized constant #{job_class_name}" if job_class.nil?
+
+      job_class._workflow
+    end
+
+    #:  (Hash[Symbol, untyped]) -> Hash[String, untyped]
+    def extract_context_data(payload)
+      context_data = serialized_job_workflow_context || payload[:job_workflow_context]
+      raise "job_workflow_context is not set." if context_data.nil?
+
+      context_data.deep_stringify_keys
+    end
+  end
+end

data/lib/job_workflow/task_enqueue.rb

@@ -4,7 +4,6 @@ module JobWorkflow
   class TaskEnqueue
     attr_reader :condition #: true | false | ^(Context) -> bool
     attr_reader :queue #: String?
-    attr_reader :concurrency #: Integer?
 
     class << self
       #:  (true | false | ^(Context) -> bool | Hash[Symbol, untyped] | nil) -> TaskEnqueue
@@ -13,26 +12,39 @@ module JobWorkflow
         when TrueClass, FalseClass, Proc
           new(condition: value)
         when Hash
+          validate_hash_keys!(value)
+
           new(
             condition: value.fetch(:condition, !value.empty?),
-            queue: value[:queue],
-            concurrency: value[:concurrency]
+            queue: value[:queue]
           )
         else
           new
         end
       end
+
+      private
+
+      #: (Hash[Symbol, untyped]) -> void
+      def validate_hash_keys!(value)
+        unsupported_keys = value.keys - %i[condition queue]
+        return if unsupported_keys.empty?
+
+        if unsupported_keys == %i[concurrency]
+          raise ArgumentError, "enqueue does not support :concurrency; use throttle instead"
+        end
+
+        raise ArgumentError, "enqueue supports only :condition and :queue"
+      end
     end
 
     #:  (
     #     ?condition: true | false | ^(Context) -> bool,
-    #     ?queue: String?,
-    #     ?concurrency: Integer?
+    #     ?queue: String?
     #   ) -> void
-    def initialize(condition: false, queue: nil, concurrency: nil)
+    def initialize(condition: false, queue: nil)
       @condition = condition
       @queue = queue
-      @concurrency = concurrency
     end
 
     #:  (Context) -> bool
@@ -41,10 +53,5 @@ module JobWorkflow
 
       !!condition
     end
-
-    #:  () -> bool
-    def should_limits_concurrency?
-      !!condition && !concurrency.nil? && QueueAdapter.current.supports_concurrency_limits?
-    end
   end
 end

data/lib/job_workflow/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JobWorkflow
-  VERSION = "0.5.0" # : String
+  VERSION = "0.6.1" # : String
 end

data/lib/job_workflow/workflow_status.rb

@@ -10,6 +10,7 @@ module JobWorkflow
     attr_reader :context #: Context
     attr_reader :job_class_name #: String
     attr_reader :status #: status_type
+    attr_reader :completed_task_names #: Array[Symbol]
 
     class << self
       #:  (String) -> WorkflowStatus
@@ -24,6 +25,7 @@ module JobWorkflow
       def find_by(job_id:)
         data = QueueAdapter.current.find_job(job_id)
         return if data.nil?
+        return if data["class_name"] == JobWorkflow::SubTaskJob.name
 
         WorkflowStatus.from_job_data(data)
       end
@@ -33,23 +35,57 @@ module JobWorkflow
         job_class_name = data["class_name"]
         job_class = job_class_name.constantize
         workflow = job_class._workflow
+        context = context_from_job_data(data, workflow)
+
+        new(
+          context:,
+          job_class_name:,
+          status: data["status"],
+          completed_task_names: completed_task_names_from_job_data(data)
+        )
+      end
+
+      private
+
+      #:  (Hash[String, untyped]) -> Array[Symbol]
+      def completed_task_names_from_job_data(data)
+        Array(data.dig("continuation", "completed")).map(&:to_sym)
+      end
 
+      #:  (Hash[String, untyped], Workflow) -> Context
+      def context_from_job_data(data, workflow)
         context_data = data["job_workflow_context"] || data["arguments"]&.first&.dig("job_workflow_context")
         context = if context_data
                     Context.deserialize(context_data.merge("workflow" => workflow))
                   else
                     Context.from_hash({ workflow: })
                   end
+        serialized_arguments = workflow_arguments_data(data)
+        return context if serialized_arguments.nil?
+
+        context._update_arguments(ActiveJob::Arguments.deserialize([serialized_arguments]).first)
+      end
+
+      #:  (Hash[String, untyped]) -> Hash[String, untyped]?
+      def workflow_arguments_data(data)
+        serialized_arguments = data["arguments"]&.first
+        return if serialized_arguments.nil? || serialized_arguments.key?("job_workflow_context")
 
-        new(context:, job_class_name:, status: data["status"])
+        serialized_arguments
       end
     end
 
-    #:  (context: Context, job_class_name: String, status: status_type) -> void
-    def initialize(context:, job_class_name:, status:)
+    #:  (
+    #      context: Context,
+    #      job_class_name: String,
+    #      status: status_type,
+    #      ?completed_task_names: Array[Symbol]
+    #    ) -> void
+    def initialize(context:, job_class_name:, status:, completed_task_names: [])
       @context = context #: Context
       @job_class_name = job_class_name #: String
       @status = status #: Symbol
+      @completed_task_names = completed_task_names
     end
 
     #:  () -> Symbol?

data/lib/job_workflow.rb

@@ -31,6 +31,7 @@ require_relative "job_workflow/task"
 require_relative "job_workflow/task_graph"
 require_relative "job_workflow/schedule"
 require_relative "job_workflow/dsl"
+require_relative "job_workflow/sub_task_job"
 require_relative "job_workflow/runner"
 require_relative "job_workflow/workflow_status"
 require_relative "job_workflow/workflow"
@@ -44,6 +45,7 @@ require_relative "job_workflow/output_def"
 require_relative "job_workflow/task_output"
 require_relative "job_workflow/output"
 require_relative "job_workflow/queue"
+require_relative "job_workflow/monitoring"
 require_relative "job_workflow/auto_scaling"
 # :nocov:
 require_relative "job_workflow/railtie" if defined?(Rails::Railtie)

data/rbs_collection.lock.yaml

@@ -6,7 +6,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: activerecord
@@ -14,7 +14,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: activesupport
@@ -22,7 +22,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: base64
@@ -34,7 +34,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: concurrent-ruby
@@ -42,7 +42,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: connection_pool
@@ -50,7 +50,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: date
@@ -74,7 +74,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: i18n
@@ -82,7 +82,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: json
@@ -98,7 +98,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: monitor
@@ -138,7 +138,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: stringio
@@ -162,7 +162,7 @@ gems:
   source:
     type: git
     name: ruby/gem_rbs_collection
-    revision: 81fa8bd0617286078617a62b6a3229cebfd4af23
+    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: uri

data/sig/generated/job_workflow/context.rbs

@@ -25,9 +25,9 @@ module JobWorkflow
     #      task_context: TaskContext,
     #      output: Output,
     #      job_status: JobStatus,
-    #      ?job: DSL?
+    #      ?job: _JobInterface?
     #    ) -> void
-    def initialize: (workflow: Workflow, arguments: Arguments, task_context: TaskContext, output: Output, job_status: JobStatus, ?job: DSL?) -> void
+    def initialize: (workflow: Workflow, arguments: Arguments, task_context: TaskContext, output: Output, job_status: JobStatus, ?job: _JobInterface?) -> void
 
     # :  () -> Hash[String, untyped]
     def serialize: () -> Hash[String, untyped]
@@ -44,11 +44,11 @@ module JobWorkflow
     # :  () -> void
     def checkpoint!: () -> void
 
-    # :  (DSL) -> void
-    def _job=: (DSL) -> void
+    # :  (_JobInterface) -> void
+    def _job=: (_JobInterface) -> void
 
-    # :  () -> DSL?
-    def _job: () -> DSL?
+    # :  () -> _JobInterface?
+    def _job: () -> _JobInterface?
 
     # :  () -> String
     def job_id: () -> String
@@ -115,7 +115,7 @@ module JobWorkflow
 
     private
 
-    attr_accessor job: DSL?
+    attr_accessor job: _JobInterface?
 
     attr_writer workflow: Workflow
 

data/sig/generated/job_workflow/instrumentation/opentelemetry_subscriber.rbs

@@ -19,7 +19,6 @@ module JobWorkflow
     # @note This subscriber requires the opentelemetry-api gem to be installed.
     #   If not available, subscription will be silently skipped.
     class OpenTelemetrySubscriber
-      # rubocop:disable Metrics/ClassLength
       module Attributes
         JOB_NAME: String
 

data/sig/generated/job_workflow/instrumentation.rbs

@@ -63,26 +63,26 @@ module JobWorkflow
       DRY_RUN_EXECUTE: untyped
     end
 
-    # :  (DSL) { () -> untyped } -> untyped
-    def self.instrument_workflow: (DSL) { () -> untyped } -> untyped
+    # :  (_JobInterface) { () -> untyped } -> untyped
+    def self.instrument_workflow: (_JobInterface) { () -> untyped } -> untyped
 
-    # :  (DSL, Task, Context) { () -> untyped } -> untyped
-    def self.instrument_task: (DSL, Task, Context) { () -> untyped } -> untyped
+    # :  (_JobInterface, Task, Context) { () -> untyped } -> untyped
+    def self.instrument_task: (_JobInterface, Task, Context) { () -> untyped } -> untyped
 
-    # :  (DSL, Task, String) -> void
-    def self.notify_task_skip: (DSL, Task, String) -> void
+    # :  (_JobInterface, Task, String) -> void
+    def self.notify_task_skip: (_JobInterface, Task, String) -> void
 
-    # :  (DSL, Task, Integer) -> void
-    def self.notify_task_enqueue: (DSL, Task, Integer) -> void
+    # :  (_JobInterface, Task, Integer) -> void
+    def self.notify_task_enqueue: (_JobInterface, Task, Integer) -> void
 
     # :  (Task, Context, String, Integer, Float, StandardError) -> void
     def self.notify_task_retry: (Task, Context, String, Integer, Float, StandardError) -> void
 
-    # :  (DSL, Task) { () -> untyped } -> untyped
-    def self.instrument_dependent_wait: (DSL, Task) { () -> untyped } -> untyped
+    # :  (_JobInterface, Task) { () -> untyped } -> untyped
+    def self.instrument_dependent_wait: (_JobInterface, Task) { () -> untyped } -> untyped
 
-    # :  (DSL, Task, Numeric, Integer) -> void
-    def self.notify_dependent_reschedule: (DSL, Task, Numeric, Integer) -> void
+    # :  (_JobInterface, Task, Numeric, Integer) -> void
+    def self.notify_dependent_reschedule: (_JobInterface, Task, Numeric, Integer) -> void
 
     # :  (Semaphore) { () -> untyped } -> untyped
     def self.instrument_throttle: (Semaphore) { () -> untyped } -> untyped
@@ -99,32 +99,32 @@ module JobWorkflow
     # :  (String, Hash[Symbol, untyped]) { () -> untyped } -> untyped
     def self.instrument_custom: (String, Hash[Symbol, untyped]) { () -> untyped } -> untyped
 
-    # :  (DSL, Context, Symbol?, Integer, bool) { () -> untyped } -> untyped
-    def self.instrument_dry_run: (DSL, Context, Symbol?, Integer, bool) { () -> untyped } -> untyped
+    # :  (_JobInterface, Context, Symbol?, Integer, bool) { () -> untyped } -> untyped
+    def self.instrument_dry_run: (_JobInterface, Context, Symbol?, Integer, bool) { () -> untyped } -> untyped
 
     # :  (String, Hash[Symbol, untyped]) ?{ () -> untyped } -> untyped
     private def self.instrument: (String, Hash[Symbol, untyped]) ?{ () -> untyped } -> untyped
 
-    # :  (DSL) -> Hash[Symbol, untyped]
-    private def self.build_workflow_payload: (DSL) -> Hash[Symbol, untyped]
+    # :  (_JobInterface) -> Hash[Symbol, untyped]
+    private def self.build_workflow_payload: (_JobInterface) -> Hash[Symbol, untyped]
 
-    # :  (DSL, Task, Context) -> Hash[Symbol, untyped]
-    private def self.build_task_payload: (DSL, Task, Context) -> Hash[Symbol, untyped]
+    # :  (_JobInterface, Task, Context) -> Hash[Symbol, untyped]
+    private def self.build_task_payload: (_JobInterface, Task, Context) -> Hash[Symbol, untyped]
 
-    # :  (DSL, Task, String) -> Hash[Symbol, untyped]
-    private def self.build_task_skip_payload: (DSL, Task, String) -> Hash[Symbol, untyped]
+    # :  (_JobInterface, Task, String) -> Hash[Symbol, untyped]
+    private def self.build_task_skip_payload: (_JobInterface, Task, String) -> Hash[Symbol, untyped]
 
-    # :  (DSL, Task, Integer) -> Hash[Symbol, untyped]
-    private def self.build_task_enqueue_payload: (DSL, Task, Integer) -> Hash[Symbol, untyped]
+    # :  (_JobInterface, Task, Integer) -> Hash[Symbol, untyped]
+    private def self.build_task_enqueue_payload: (_JobInterface, Task, Integer) -> Hash[Symbol, untyped]
 
     # :  (Task, Context, String, Integer, Float, StandardError) -> Hash[Symbol, untyped]
     private def self.build_task_retry_payload: (Task, Context, String, Integer, Float, StandardError) -> Hash[Symbol, untyped]
 
-    # :  (DSL, Task) -> Hash[Symbol, untyped]
-    private def self.build_dependent_payload: (DSL, Task) -> Hash[Symbol, untyped]
+    # :  (_JobInterface, Task) -> Hash[Symbol, untyped]
+    private def self.build_dependent_payload: (_JobInterface, Task) -> Hash[Symbol, untyped]
 
-    # :  (DSL, Task, Numeric, Integer) -> Hash[Symbol, untyped]
-    private def self.build_dependent_reschedule_payload: (DSL, Task, Numeric, Integer) -> Hash[Symbol, untyped]
+    # :  (_JobInterface, Task, Numeric, Integer) -> Hash[Symbol, untyped]
+    private def self.build_dependent_reschedule_payload: (_JobInterface, Task, Numeric, Integer) -> Hash[Symbol, untyped]
 
     # :  (Semaphore) -> Hash[Symbol, untyped]
     private def self.build_throttle_payload: (Semaphore) -> Hash[Symbol, untyped]
@@ -132,7 +132,7 @@ module JobWorkflow
     # :  (String) -> Hash[Symbol, untyped]
     private def self.build_queue_payload: (String) -> Hash[Symbol, untyped]
 
-    # :  (DSL, Context, Symbol?, Integer, bool) -> Hash[Symbol, untyped]
-    private def self.build_skip_in_dry_run_payload: (DSL, Context, Symbol?, Integer, bool) -> Hash[Symbol, untyped]
+    # :  (_JobInterface, Context, Symbol?, Integer, bool) -> Hash[Symbol, untyped]
+    private def self.build_skip_in_dry_run_payload: (_JobInterface, Context, Symbol?, Integer, bool) -> Hash[Symbol, untyped]
   end
 end

data/sig/generated/job_workflow/job_status.rbs

@@ -33,12 +33,15 @@ module JobWorkflow
     # :  (TaskJobStatus) -> void
     def update_task_job_status: (TaskJobStatus) -> void
 
-    # :  (task_name: Symbol, jobs: Array[DSL]) -> void
-    def update_task_job_statuses_from_jobs: (task_name: Symbol, jobs: Array[DSL]) -> void
+    # :  (task_name: Symbol, jobs: Array[_JobInterface]) -> void
+    def update_task_job_statuses_from_jobs: (task_name: Symbol, jobs: Array[_JobInterface]) -> void
 
     # :  (Symbol) -> void
     def update_task_job_statuses_from_db: (Symbol) -> void
 
+    # :  () -> void
+    def refresh_from_db!: () -> void
+
     private
 
     attr_accessor task_job_statuses: Hash[Symbol, Array[TaskJobStatus]]

data/sig/generated/job_workflow/monitoring/dag_layout.rbs

@@ -0,0 +1,80 @@
+# Generated from lib/job_workflow/monitoring/dag_layout.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class DagLayout
+      NODE_WIDTH: ::Integer
+
+      NODE_HEIGHT: ::Integer
+
+      COLUMN_GAP: ::Integer
+
+      ROW_GAP: ::Integer
+
+      PADDING: ::Integer
+
+      LABEL_LIMIT: ::Integer
+
+      # :  (tasks: Array[Hash[Symbol, untyped]]) -> void
+      def initialize: (tasks: Array[Hash[Symbol, untyped]]) -> void
+
+      # :  () -> Hash[Symbol, untyped]
+      def to_h: () -> Hash[Symbol, untyped]
+
+      private
+
+      attr_reader tasks: Array[Hash[Symbol, untyped]]
+
+      # :  (Array[Hash[Symbol, untyped]]) -> void
+      def validate_tasks!: (Array[Hash[Symbol, untyped]]) -> void
+
+      # :  (Hash[Symbol, untyped], Hash[Symbol, bool]) -> void
+      def validate_dependencies!: (Hash[Symbol, untyped], Hash[Symbol, bool]) -> void
+
+      # :  () -> Array[Hash[Symbol, untyped]]
+      def nodes: () -> Array[Hash[Symbol, untyped]]
+
+      # :  () -> Array[Hash[Symbol, untyped]]
+      def edges: () -> Array[Hash[Symbol, untyped]]
+
+      # :  () -> Hash[Symbol, Hash[Symbol, Integer]]
+      def node_positions: () -> Hash[Symbol, Hash[Symbol, Integer]]
+
+      # :  (Hash[Symbol, untyped], Hash[Symbol, Hash[Symbol, Integer]]) -> Integer
+      def dependency_column: (Hash[Symbol, untyped], Hash[Symbol, Hash[Symbol, Integer]]) -> Integer
+
+      # :  (Symbol, Symbol) -> Hash[Symbol, untyped]
+      def edge_view: (Symbol, Symbol) -> Hash[Symbol, untyped]
+
+      # :  (Hash[Symbol, untyped], Hash[Symbol, untyped]) -> String
+      def edge_path: (Hash[Symbol, untyped], Hash[Symbol, untyped]) -> String
+
+      # :  (Symbol) -> Hash[Symbol, untyped]
+      def node_view: (Symbol) -> Hash[Symbol, untyped]
+
+      # :  () -> Integer
+      def canvas_width: () -> Integer
+
+      # :  () -> Integer
+      def canvas_height: () -> Integer
+
+      # :  (Integer) -> Integer
+      def x_for: (Integer) -> Integer
+
+      # :  (Integer) -> Integer
+      def y_for: (Integer) -> Integer
+
+      # :  (Symbol) -> String
+      def truncate_label: (Symbol) -> String
+
+      # :  (Hash[Symbol, untyped]) -> String?
+      def node_meta_label: (Hash[Symbol, untyped]) -> String?
+
+      # :  () -> String
+      def root_task_label: () -> String
+
+      # :  (Hash[Symbol, Integer]) -> String
+      def each_progress_label: (Hash[Symbol, Integer]) -> String
+    end
+  end
+end

data/sig/generated/job_workflow/monitoring/engine.rbs

@@ -0,0 +1,8 @@
+# Generated from lib/job_workflow/monitoring/engine.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/sig/generated/job_workflow/monitoring/execution_page.rbs

@@ -0,0 +1,14 @@
+# Generated from lib/job_workflow/monitoring/execution_page.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class ExecutionPage
+      attr_reader executions: Array[ExecutionViewModel]
+
+      attr_reader next_cursor: String?
+
+      # :  (executions: Array[ExecutionViewModel], next_cursor: String?) -> void
+      def initialize: (executions: Array[ExecutionViewModel], next_cursor: String?) -> void
+    end
+  end
+end

data/sig/generated/job_workflow/monitoring/execution_registry.rbs

@@ -0,0 +1,21 @@
+# Generated from lib/job_workflow/monitoring/execution_registry.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class ExecutionRegistry
+      DEFAULT_LIMIT: ::Integer
+
+      # :  (job_class_name: String, ?limit: Integer, ?cursor: String?) -> ExecutionPage
+      def self.page_for: (job_class_name: String, ?limit: Integer, ?cursor: String?) -> ExecutionPage
+
+      # :  (String) -> ExecutionViewModel?
+      def self.find: (String) -> ExecutionViewModel?
+
+      # :  (Hash[String, untyped], ?hydrate_sub_tasks: bool) -> ExecutionViewModel?
+      private def self.build_view_model: (Hash[String, untyped], ?hydrate_sub_tasks: bool) -> ExecutionViewModel?
+
+      # :  (WorkflowStatus) -> void
+      private def self.hydrate_sub_task_state: (WorkflowStatus) -> void
+    end
+  end
+end