job-workflow 0.5.0 → 0.6.1

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

@@ -0,0 +1,111 @@
+# Generated from lib/job_workflow/monitoring/execution_view_model.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class ExecutionViewModel
+      attr_reader job_id: String
+
+      attr_reader queue_name: String?
+
+      attr_reader status: WorkflowStatus
+
+      # :  (job_id: String, queue_name: String?, status: WorkflowStatus) -> void
+      def initialize: (job_id: String, queue_name: String?, status: WorkflowStatus) -> void
+
+      # :  () -> String
+      def job_class_name: () -> String
+
+      # :  () -> Symbol
+      def workflow_status: () -> Symbol
+
+      # :  () -> Symbol?
+      def current_task_name: () -> Symbol?
+
+      # :  () -> Arguments
+      def arguments: () -> Arguments
+
+      # :  () -> Hash[untyped, untyped]
+      def filtered_arguments: () -> Hash[untyped, untyped]
+
+      # :  () -> Array[Hash[Symbol, untyped]]
+      def tasks: () -> Array[Hash[Symbol, untyped]]
+
+      # :  () -> Symbol?
+      def failed_task_name: () -> Symbol?
+
+      # :  () -> String?
+      def mission_control_job_path: () -> String?
+
+      # :  () -> Hash[Symbol, untyped]
+      def dag_layout: () -> Hash[Symbol, untyped]
+
+      # :  () -> bool
+      def running?: () -> bool
+
+      # :  () -> Hash[Symbol, untyped]
+      def to_h: () -> Hash[Symbol, untyped]
+
+      private
+
+      # :  (Symbol, Array[TaskOutput], Array[TaskJobStatus]) -> Symbol
+      def task_status: (Symbol, Array[TaskOutput], Array[TaskJobStatus]) -> Symbol
+
+      # :  (Symbol, Array[TaskOutput], Array[TaskJobStatus]) -> bool
+      def completed_task?: (Symbol, Array[TaskOutput], Array[TaskJobStatus]) -> bool
+
+      # :  (Symbol, Array[TaskJobStatus]) -> bool
+      def task_running?: (Symbol, Array[TaskJobStatus]) -> bool
+
+      # :  (Symbol) -> bool
+      def current_task_running?: (Symbol) -> bool
+
+      # :  (Task) -> Hash[Symbol, untyped]
+      def task_view_model: (Task) -> Hash[Symbol, untyped]
+
+      # :  (Task) -> Hash[Symbol, untyped]
+      def task_configuration_view: (Task) -> Hash[Symbol, untyped]
+
+      # :  (Symbol, Array[TaskOutput], Array[TaskJobStatus]) -> Hash[Symbol, untyped]
+      def task_runtime_view: (Symbol, Array[TaskOutput], Array[TaskJobStatus]) -> Hash[Symbol, untyped]
+
+      # :  (Symbol) -> [Array[TaskOutput], Array[TaskJobStatus]]
+      def task_state: (Symbol) -> [ Array[TaskOutput], Array[TaskJobStatus] ]
+
+      # :  (Task) -> Hash[Symbol, untyped]
+      def task_configuration: (Task) -> Hash[Symbol, untyped]
+
+      # :  (Task) -> Hash[Symbol, untyped]
+      def enqueue_configuration: (Task) -> Hash[Symbol, untyped]
+
+      # :  (Task) -> Array[Hash[Symbol, untyped]]
+      def output_configuration: (Task) -> Array[Hash[Symbol, untyped]]
+
+      # :  (Task) -> Hash[Symbol, untyped]
+      def retry_configuration: (Task) -> Hash[Symbol, untyped]
+
+      # :  (Task) -> Hash[Symbol, untyped]
+      def throttle_configuration: (Task) -> Hash[Symbol, untyped]
+
+      # :  (Task) -> Hash[Symbol, untyped]
+      def dependency_wait_configuration: (Task) -> Hash[Symbol, untyped]
+
+      # :  (untyped) -> untyped
+      def callable_summary: (untyped) -> untyped
+
+      # :  (untyped) -> untyped
+      def primitive_summary: (untyped) -> untyped
+
+      # :  (Array[TaskOutput], Array[TaskJobStatus]) -> Hash[Symbol, Integer]
+      def each_progress: (Array[TaskOutput], Array[TaskJobStatus]) -> Hash[Symbol, Integer]
+
+      # :  (Array[TaskOutput]) -> Array[Hash[Symbol, untyped]]
+      def task_outputs_view: (Array[TaskOutput]) -> Array[Hash[Symbol, untyped]]
+
+      # :  (Array[TaskJobStatus]) -> Array[Hash[Symbol, untyped]]
+      def sub_task_jobs_view: (Array[TaskJobStatus]) -> Array[Hash[Symbol, untyped]]
+
+      # :  (String?, Symbol?) -> String?
+      def mission_control_job_path_for: (String?, Symbol?) -> String?
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+# Generated from lib/job_workflow/monitoring/parameter_filter.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class ParameterFilter
+      # : (untyped) -> untyped
+      def self.filter: (untyped) -> untyped
+
+      # : () -> ActiveSupport::ParameterFilter
+      private def self.parameter_filter: () -> ActiveSupport::ParameterFilter
+
+      # : () -> Array[untyped]
+      private def self.filters: () -> Array[untyped]
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# Generated from lib/job_workflow/monitoring/workflow_definition.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class WorkflowDefinition
+      attr_reader job_class: singleton(DSL)
+
+      # :  (job_class: singleton(DSL)) -> void
+      def initialize: (job_class: singleton(DSL)) -> void
+
+      # :  () -> String
+      def job_class_name: () -> String
+
+      # :  () -> Integer
+      def task_count: () -> Integer
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+# Generated from lib/job_workflow/monitoring/workflow_registry.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    class WorkflowRegistry
+      # :  () -> Array[singleton(DSL)]
+      def self.all: () -> Array[singleton(DSL)]
+
+      # :  (String) -> singleton(DSL)?
+      def self.find: (String) -> singleton(DSL)?
+    end
+  end
+end

data/sig/generated/job_workflow/monitoring.rbs

@@ -0,0 +1,38 @@
+# Generated from lib/job_workflow/monitoring.rb with RBS::Inline
+
+module JobWorkflow
+  module Monitoring
+    # :  () -> Array[WorkflowDefinition]
+    def self.workflows: () -> Array[WorkflowDefinition]
+
+    # :  (String?, Symbol?) -> String?
+    def self.mission_control_job_path: (String?, Symbol?) -> String?
+
+    # :  () -> String
+    def self.resolved_base_controller_class: () -> String
+
+    # :  (untyped config) -> void
+    def self.configure_engine_config: (untyped config) -> void
+
+    # :  () -> String?
+    private def self.mission_control_job_route_path: () -> String?
+
+    # :  () -> String?
+    private def self.mission_control_application_id: () -> String?
+
+    # :  () -> String?
+    private def self.mission_control_mount_path: () -> String?
+
+    # :  (String) -> String?
+    private def self.engine_route_path: (String) -> String?
+
+    # :  (untyped) -> String?
+    private def self.normalized_route_path: (untyped) -> String?
+
+    # :  () -> untyped
+    private def self.mission_control_routes: () -> untyped
+
+    # :  () -> untyped
+    private def self.rails_routes: () -> untyped
+  end
+end

data/sig/generated/job_workflow/queue_adapters/abstract.rbs

@@ -49,14 +49,17 @@ module JobWorkflow
       # :  (String) -> Hash[String, untyped]?
       def find_job: (String) -> Hash[String, untyped]?
 
+      # :  (job_class_name: String, limit: Integer, cursor: String?) -> Hash[Symbol, untyped]
+      def fetch_root_workflow_job_page: (job_class_name: String, limit: Integer, cursor: String?) -> Hash[Symbol, untyped]
+
       # :  (Array[String]) -> Array[Hash[String, untyped]]
       def fetch_job_contexts: (Array[String]) -> Array[Hash[String, untyped]]
 
-      # :  (DSL, Numeric) -> bool
-      def reschedule_job: (DSL, Numeric) -> bool
+      # :  (_JobInterface, Numeric) -> bool
+      def reschedule_job: (_JobInterface, Numeric) -> bool
 
-      # :  (DSL) -> void
-      def persist_job_context: (DSL) -> void
+      # :  (_JobInterface) -> void
+      def persist_job_context: (_JobInterface) -> void
     end
   end
 end

data/sig/generated/job_workflow/queue_adapters/null_adapter.rbs

@@ -51,11 +51,14 @@ module JobWorkflow
       # :  (String) -> Hash[String, untyped]?
       def find_job: (String) -> Hash[String, untyped]?
 
+      # :  (job_class_name: String, limit: Integer, cursor: String?) -> Hash[Symbol, untyped]
+      def fetch_root_workflow_job_page: (job_class_name: String, limit: Integer, cursor: String?) -> Hash[Symbol, untyped]
+
       # :  (Array[String]) -> Array[Hash[String, untyped]]
       def fetch_job_contexts: (Array[String]) -> Array[Hash[String, untyped]]
 
-      # :  (DSL, Numeric) -> bool
-      def reschedule_job: (DSL, Numeric) -> bool
+      # :  (_JobInterface, Numeric) -> bool
+      def reschedule_job: (_JobInterface, Numeric) -> bool
 
       # @note Test helpers
       #

data/sig/generated/job_workflow/queue_adapters/solid_queue_adapter.rbs

@@ -82,14 +82,17 @@ module JobWorkflow
       # :  (String) -> Hash[String, untyped]?
       def find_job: (String) -> Hash[String, untyped]?
 
+      # :  (job_class_name: String, limit: Integer, cursor: String?) -> Hash[Symbol, untyped]
+      def fetch_root_workflow_job_page: (job_class_name: String, limit: Integer, cursor: String?) -> Hash[Symbol, untyped]
+
       # @note
       #   - Fetches job_workflow_context hashes for the given job IDs.
       #
       # :  (Array[String]) -> Array[Hash[String, untyped]]
       def fetch_job_contexts: (Array[String]) -> Array[Hash[String, untyped]]
 
-      # :  (DSL, Numeric) -> bool
-      def reschedule_job: (DSL, Numeric) -> bool
+      # :  (_JobInterface, Numeric) -> bool
+      def reschedule_job: (_JobInterface, Numeric) -> bool
 
       # @note
       #   - Persists the job's updated context (including task outputs) back
@@ -97,8 +100,8 @@ module JobWorkflow
       #     outputs computed during job execution would be lost because
       #     SolidQueue does not re-serialize job arguments after perform.
       #
-      # :  (DSL) -> void
-      def persist_job_context: (DSL) -> void
+      # :  (_JobInterface) -> void
+      def persist_job_context: (_JobInterface) -> void
 
       private
 
@@ -113,8 +116,17 @@ module JobWorkflow
       # :  [T] () { () -> T } -> T
       def without_query_cache: [T] () { () -> T } -> T
 
-      # :  (SolidQueue::Job, DSL, Numeric) -> bool
-      def reschedule_solid_queue_job: (SolidQueue::Job, DSL, Numeric) -> bool
+      # :  (SolidQueue::Job) -> Hash[String, untyped]
+      def normalized_job_data: (SolidQueue::Job) -> Hash[String, untyped]
+
+      # :  (job_class_name: String, cursor: String?) -> untyped
+      def root_jobs_relation: (job_class_name: String, cursor: String?) -> untyped
+
+      # :  (Array[SolidQueue::Job], limit: Integer) -> Hash[Symbol, untyped]
+      def build_page: (Array[SolidQueue::Job], limit: Integer) -> Hash[Symbol, untyped]
+
+      # :  (SolidQueue::Job, _JobInterface, Numeric) -> bool
+      def reschedule_solid_queue_job: (SolidQueue::Job, _JobInterface, Numeric) -> bool
 
       # @rbs module-self SolidQueue::ClaimedExecution
       module ClaimedExecutionPatch : SolidQueue::ClaimedExecution

data/sig/generated/job_workflow/runner.rbs

@@ -13,7 +13,7 @@ module JobWorkflow
 
     private
 
-    attr_reader job: DSL
+    attr_reader job: _JobInterface
 
     # :  () -> Workflow
     def workflow: () -> Workflow

data/sig/generated/job_workflow/sub_task_job.rbs

@@ -0,0 +1,40 @@
+# Generated from lib/job_workflow/sub_task_job.rb with RBS::Inline
+
+module JobWorkflow
+  class SubTaskJob < ActiveJob::Base
+    include ActiveJob::Continuable
+
+    # :  (context: Context) -> SubTaskJob
+    def self.from_parent_context: (context: Context) -> SubTaskJob
+
+    # :  (Context) -> void
+    private def self.validate_sub_task_context!: (Context) -> void
+
+    # :  (Hash[untyped, untyped]) -> void
+    def perform: (Hash[untyped, untyped]) -> void
+
+    # :  () -> Output
+    def output: () -> Output
+
+    attr_accessor _context: Context?
+
+    # :  () -> Hash[String, untyped]
+    def serialize: () -> Hash[String, untyped]
+
+    # :  (Hash[String, untyped]) -> void
+    def deserialize: (Hash[String, untyped]) -> void
+
+    private
+
+    attr_accessor serialized_job_workflow_context: Hash[String, untyped]?
+
+    # :  (Hash[Symbol, untyped]) -> Context
+    def build_context: (Hash[Symbol, untyped]) -> Context
+
+    # :  (job_class_name: String) -> Workflow
+    def resolve_workflow: (job_class_name: String) -> Workflow
+
+    # :  (Hash[Symbol, untyped]) -> Hash[String, untyped]
+    def extract_context_data: (Hash[Symbol, untyped]) -> Hash[String, untyped]
+  end
+end

data/sig/generated/job_workflow/task_enqueue.rbs

@@ -6,22 +6,19 @@ module JobWorkflow
 
     attr_reader queue: String?
 
-    attr_reader concurrency: Integer?
-
     # :  (true | false | ^(Context) -> bool | Hash[Symbol, untyped] | nil) -> TaskEnqueue
     def self.from_primitive_value: (true | false | ^(Context) -> bool | Hash[Symbol, untyped] | nil) -> TaskEnqueue
 
+    # : (Hash[Symbol, untyped]) -> void
+    private def self.validate_hash_keys!: (Hash[Symbol, untyped]) -> void
+
     # :  (
     #      ?condition: true | false | ^(Context) -> bool,
-    #      ?queue: String?,
-    #      ?concurrency: Integer?
+    #      ?queue: String?
     #    ) -> void
-    def initialize: (?condition: true | false | ^(Context) -> bool, ?queue: String?, ?concurrency: Integer?) -> void
+    def initialize: (?condition: true | false | ^(Context) -> bool, ?queue: String?) -> void
 
     # :  (Context) -> bool
     def should_enqueue?: (Context) -> bool
-
-    # :  () -> bool
-    def should_limits_concurrency?: () -> bool
   end
 end

data/sig/generated/job_workflow/workflow_status.rbs

@@ -13,6 +13,8 @@ module JobWorkflow
 
     attr_reader status: status_type
 
+    attr_reader completed_task_names: Array[Symbol]
+
     # :  (String) -> WorkflowStatus
     def self.find: (String) -> WorkflowStatus
 
@@ -22,8 +24,22 @@ module JobWorkflow
     # :  (Hash[String, untyped]) -> WorkflowStatus
     def self.from_job_data: (Hash[String, untyped]) -> WorkflowStatus
 
-    # :  (context: Context, job_class_name: String, status: status_type) -> void
-    def initialize: (context: Context, job_class_name: String, status: status_type) -> void
+    # :  (Hash[String, untyped]) -> Array[Symbol]
+    private def self.completed_task_names_from_job_data: (Hash[String, untyped]) -> Array[Symbol]
+
+    # :  (Hash[String, untyped], Workflow) -> Context
+    private def self.context_from_job_data: (Hash[String, untyped], Workflow) -> Context
+
+    # :  (Hash[String, untyped]) -> Hash[String, untyped]?
+    private def self.workflow_arguments_data: (Hash[String, untyped]) -> Hash[String, untyped]?
+
+    # :  (
+    #       context: Context,
+    #       job_class_name: String,
+    #       status: status_type,
+    #       ?completed_task_names: Array[Symbol]
+    #     ) -> void
+    def initialize: (context: Context, job_class_name: String, status: status_type, ?completed_task_names: Array[Symbol]) -> void
 
     # :  () -> Symbol?
     def current_task_name: () -> Symbol?

data/sig-private/job-workflow.rbs

@@ -0,0 +1,11 @@
+module JobWorkflow
+  interface _JobInterface
+    def job_id: () -> String
+    def queue_name: () -> String
+    def serialize: () -> Hash[String, untyped]
+    def _context: () -> JobWorkflow::Context?
+    def _context=: (JobWorkflow::Context) -> JobWorkflow::Context
+    def step: (Symbol, ?start: ActiveJob::Continuation::_Succ, ?isolated: bool) -> void
+            | (Symbol, ?start: ActiveJob::Continuation::_Succ, ?isolated: bool) { (ActiveJob::Continuation::Step) -> void } -> void
+  end
+end

data/sig-private/rails.rbs

@@ -0,0 +1,5 @@
+module Rails
+  class Engine
+    def self.isolate_namespace: (Module) -> void
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: job-workflow
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.1
 platform: ruby
 authors:
 - shoma07
@@ -31,13 +31,31 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".agents/instructions/coding-style.md"
+- ".agents/instructions/domain.md"
+- ".agents/instructions/environment.md"
+- ".agents/instructions/general.md"
+- ".agents/instructions/security.md"
+- ".agents/instructions/structure.md"
+- ".agents/instructions/tech-stack.md"
+- ".agents/instructions/testing.md"
+- ".agents/instructions/workflow.md"
 - ".rspec"
 - ".rubocop.yml"
+- AGENTS.md
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
 - Rakefile
 - Steepfile
+- app/controllers/job_workflow/monitoring/application_controller.rb
+- app/controllers/job_workflow/monitoring/executions_controller.rb
+- app/controllers/job_workflow/monitoring/workflows_controller.rb
+- app/views/job_workflow/monitoring/executions/index.html.erb
+- app/views/job_workflow/monitoring/executions/show.html.erb
+- app/views/job_workflow/monitoring/workflows/index.html.erb
+- app/views/layouts/job_workflow/monitoring/application.html.erb
+- config/routes.rb
 - guides/API_REFERENCE.md
 - guides/BEST_PRACTICES.md
 - guides/CACHE_STORE_INTEGRATION.md
@@ -49,6 +67,7 @@ files:
 - guides/GETTING_STARTED.md
 - guides/INSTRUMENTATION.md
 - guides/LIFECYCLE_HOOKS.md
+- guides/MONITORING_UI.md
 - guides/OPENTELEMETRY_INTEGRATION.md
 - guides/PARALLEL_PROCESSING.md
 - guides/PRODUCTION_DEPLOYMENT.md
@@ -83,6 +102,15 @@ files:
 - lib/job_workflow/instrumentation/opentelemetry_subscriber.rb
 - lib/job_workflow/job_status.rb
 - lib/job_workflow/logger.rb
+- lib/job_workflow/monitoring.rb
+- lib/job_workflow/monitoring/dag_layout.rb
+- lib/job_workflow/monitoring/engine.rb
+- lib/job_workflow/monitoring/execution_page.rb
+- lib/job_workflow/monitoring/execution_registry.rb
+- lib/job_workflow/monitoring/execution_view_model.rb
+- lib/job_workflow/monitoring/parameter_filter.rb
+- lib/job_workflow/monitoring/workflow_definition.rb
+- lib/job_workflow/monitoring/workflow_registry.rb
 - lib/job_workflow/output.rb
 - lib/job_workflow/output_def.rb
 - lib/job_workflow/queue.rb
@@ -94,6 +122,7 @@ files:
 - lib/job_workflow/runner.rb
 - lib/job_workflow/schedule.rb
 - lib/job_workflow/semaphore.rb
+- lib/job_workflow/sub_task_job.rb
 - lib/job_workflow/task.rb
 - lib/job_workflow/task_callable.rb
 - lib/job_workflow/task_context.rb
@@ -112,7 +141,9 @@ files:
 - sig-private/activejob.rbs
 - sig-private/activesupport.rbs
 - sig-private/aws.rbs
+- sig-private/job-workflow.rbs
 - sig-private/opentelemetry.rbs
+- sig-private/rails.rbs
 - sig-private/solid_queue.rbs
 - sig/generated/job-workflow.rbs
 - sig/generated/job_workflow.rbs
@@ -135,6 +166,15 @@ files:
 - sig/generated/job_workflow/instrumentation/opentelemetry_subscriber.rbs
 - sig/generated/job_workflow/job_status.rbs
 - sig/generated/job_workflow/logger.rbs
+- sig/generated/job_workflow/monitoring.rbs
+- sig/generated/job_workflow/monitoring/dag_layout.rbs
+- sig/generated/job_workflow/monitoring/engine.rbs
+- sig/generated/job_workflow/monitoring/execution_page.rbs
+- sig/generated/job_workflow/monitoring/execution_registry.rbs
+- sig/generated/job_workflow/monitoring/execution_view_model.rbs
+- sig/generated/job_workflow/monitoring/parameter_filter.rbs
+- sig/generated/job_workflow/monitoring/workflow_definition.rbs
+- sig/generated/job_workflow/monitoring/workflow_registry.rbs
 - sig/generated/job_workflow/output.rbs
 - sig/generated/job_workflow/output_def.rbs
 - sig/generated/job_workflow/queue.rbs
@@ -146,6 +186,7 @@ files:
 - sig/generated/job_workflow/runner.rbs
 - sig/generated/job_workflow/schedule.rbs
 - sig/generated/job_workflow/semaphore.rbs
+- sig/generated/job_workflow/sub_task_job.rbs
 - sig/generated/job_workflow/task.rbs
 - sig/generated/job_workflow/task_callable.rbs
 - sig/generated/job_workflow/task_context.rbs