RubyGems - ruby_reactor - Versions diffs - 0.3.2 → 0.4.1 - Mend

ruby_reactor 0.3.2 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (74) hide show

checksums.yaml +4 -4
data/.release-please-config.json +18 -0
data/.release-please-manifest.json +3 -0
data/.tool-versions +1 -0
data/CHANGELOG.md +21 -0
data/README.md +80 -4
data/lib/ruby_reactor/context.rb +5 -2
data/lib/ruby_reactor/context_serializer.rb +56 -3
data/lib/ruby_reactor/dsl/reactor.rb +10 -1
data/lib/ruby_reactor/executor/result_handler.rb +1 -12
data/lib/ruby_reactor/executor.rb +7 -1
data/lib/ruby_reactor/map/result_enumerator.rb +4 -3
data/lib/ruby_reactor/rate_limit.rb +2 -2
data/lib/ruby_reactor/reactor.rb +11 -4
data/lib/ruby_reactor/sidekiq_workers/worker.rb +58 -1
data/lib/ruby_reactor/storage/redis_adapter.rb +10 -3
data/lib/ruby_reactor/storage/redis_locking.rb +17 -0
data/lib/ruby_reactor/utils/backtrace_location.rb +37 -0
data/lib/ruby_reactor/version.rb +1 -1
data/lib/ruby_reactor/web/api.rb +68 -8
data/lib/ruby_reactor/web/coordination_serializer.rb +180 -0
data/lib/ruby_reactor/web/public/assets/index-CCnNVQy5.css +1 -0
data/lib/ruby_reactor/web/public/assets/index-D7IBZvos.js +21 -0
data/lib/ruby_reactor/web/public/index.html +2 -2
data/lib/ruby_reactor.rb +7 -2
metadata +11 -54
data/documentation/DAG.md +0 -457
data/documentation/README.md +0 -135
data/documentation/async_reactors.md +0 -381
data/documentation/composition.md +0 -199
data/documentation/core_concepts.md +0 -676
data/documentation/data_pipelines.md +0 -230
data/documentation/examples/inventory_management.md +0 -748
data/documentation/examples/order_processing.md +0 -380
data/documentation/examples/payment_processing.md +0 -565
data/documentation/getting_started.md +0 -242
data/documentation/images/failed_order_processing.png +0 -0
data/documentation/images/payment_workflow.png +0 -0
data/documentation/interrupts.md +0 -163
data/documentation/locks_and_semaphores.md +0 -459
data/documentation/retry_configuration.md +0 -362
data/documentation/testing.md +0 -994
data/gui/.gitignore +0 -24
data/gui/README.md +0 -73
data/gui/eslint.config.js +0 -23
data/gui/index.html +0 -13
data/gui/package-lock.json +0 -5925
data/gui/package.json +0 -46
data/gui/postcss.config.js +0 -6
data/gui/public/vite.svg +0 -1
data/gui/src/App.css +0 -42
data/gui/src/App.tsx +0 -51
data/gui/src/assets/react.svg +0 -1
data/gui/src/components/DagVisualizer.tsx +0 -424
data/gui/src/components/Dashboard.tsx +0 -163
data/gui/src/components/ErrorBoundary.tsx +0 -47
data/gui/src/components/ReactorDetail.tsx +0 -135
data/gui/src/components/StepInspector.tsx +0 -492
data/gui/src/components/__tests__/DagVisualizer.test.tsx +0 -140
data/gui/src/components/__tests__/ReactorDetail.test.tsx +0 -111
data/gui/src/components/__tests__/StepInspector.test.tsx +0 -408
data/gui/src/globals.d.ts +0 -7
data/gui/src/index.css +0 -14
data/gui/src/lib/utils.ts +0 -13
data/gui/src/main.tsx +0 -14
data/gui/src/test/setup.ts +0 -11
data/gui/tailwind.config.js +0 -11
data/gui/tsconfig.app.json +0 -28
data/gui/tsconfig.json +0 -7
data/gui/tsconfig.node.json +0 -26
data/gui/vite.config.ts +0 -8
data/gui/vitest.config.ts +0 -13
data/lib/ruby_reactor/web/public/assets/index-VdeLgH9k.js +0 -19
data/lib/ruby_reactor/web/public/assets/index-_z-6BvuM.css +0 -1

data/lib/ruby_reactor/web/public/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/svg+xml" href="./vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>ui</title>
-    <script type="module" crossorigin src="./assets/index-VdeLgH9k.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-_z-6BvuM.css">
+    <script type="module" crossorigin src="./assets/index-D7IBZvos.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-CCnNVQy5.css">
   </head>
   <body>
     <div id="root"></div>

data/lib/ruby_reactor.rb CHANGED Viewed

@@ -238,13 +238,14 @@ module RubyReactor
       return backtrace if ENV["RUBY_REACTOR_DEBUG"] == "true"
       return backtrace if backtrace.nil? || backtrace.empty?
-      root_path = RubyReactor.root.to_s
+      internal_prefix = RubyReactor.internal_lib_path
       filtered = []
       filtered << backtrace.first
       internal_block = false
       backtrace[1..]&.each do |line|
-        if line.start_with?(root_path)
+        file_path, = RubyReactor::Utils::BacktraceLocation.parse(line)
+        if file_path&.start_with?(internal_prefix)
           unless internal_block
             filtered << "... [ruby-reactor-internals-redacted-trace]"
             internal_block = true
@@ -331,4 +332,8 @@ module RubyReactor
   def self.root
     Pathname.new(File.expand_path("..", __dir__))
   end
+  def self.internal_lib_path
+    File.join(root.to_s, "lib")
+  end
 end

metadata CHANGED Viewed

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby_reactor
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.1
 platform: ruby
 authors:
 - Artur
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-16 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-validation
@@ -89,57 +88,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".release-please-config.json"
+- ".release-please-manifest.json"
 - ".rspec"
 - ".rubocop.yml"
+- ".tool-versions"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - README.md
 - Rakefile
-- documentation/DAG.md
-- documentation/README.md
-- documentation/async_reactors.md
-- documentation/composition.md
-- documentation/core_concepts.md
-- documentation/data_pipelines.md
-- documentation/examples/inventory_management.md
-- documentation/examples/order_processing.md
-- documentation/examples/payment_processing.md
-- documentation/getting_started.md
-- documentation/images/failed_order_processing.png
-- documentation/images/payment_workflow.png
-- documentation/interrupts.md
-- documentation/locks_and_semaphores.md
-- documentation/retry_configuration.md
-- documentation/testing.md
-- gui/.gitignore
-- gui/README.md
-- gui/eslint.config.js
-- gui/index.html
-- gui/package-lock.json
-- gui/package.json
-- gui/postcss.config.js
-- gui/public/vite.svg
-- gui/src/App.css
-- gui/src/App.tsx
-- gui/src/assets/react.svg
-- gui/src/components/DagVisualizer.tsx
-- gui/src/components/Dashboard.tsx
-- gui/src/components/ErrorBoundary.tsx
-- gui/src/components/ReactorDetail.tsx
-- gui/src/components/StepInspector.tsx
-- gui/src/components/__tests__/DagVisualizer.test.tsx
-- gui/src/components/__tests__/ReactorDetail.test.tsx
-- gui/src/components/__tests__/StepInspector.test.tsx
-- gui/src/globals.d.ts
-- gui/src/index.css
-- gui/src/lib/utils.ts
-- gui/src/main.tsx
-- gui/src/test/setup.ts
-- gui/tailwind.config.js
-- gui/tsconfig.app.json
-- gui/tsconfig.json
-- gui/tsconfig.node.json
-- gui/vite.config.ts
-- gui/vitest.config.ts
 - lib/ruby_reactor.rb
 - lib/ruby_reactor/configuration.rb
 - lib/ruby_reactor/context.rb
@@ -210,6 +167,7 @@ files:
 - lib/ruby_reactor/template/input.rb
 - lib/ruby_reactor/template/result.rb
 - lib/ruby_reactor/template/value.rb
+- lib/ruby_reactor/utils/backtrace_location.rb
 - lib/ruby_reactor/utils/code_extractor.rb
 - lib/ruby_reactor/validation/base.rb
 - lib/ruby_reactor/validation/input_validator.rb
@@ -218,8 +176,9 @@ files:
 - lib/ruby_reactor/web/api.rb
 - lib/ruby_reactor/web/application.rb
 - lib/ruby_reactor/web/config.ru
-- lib/ruby_reactor/web/public/assets/index-VdeLgH9k.js
-- lib/ruby_reactor/web/public/assets/index-_z-6BvuM.css
+- lib/ruby_reactor/web/coordination_serializer.rb
+- lib/ruby_reactor/web/public/assets/index-CCnNVQy5.css
+- lib/ruby_reactor/web/public/assets/index-D7IBZvos.js
 - lib/ruby_reactor/web/public/index.html
 - lib/ruby_reactor/web/public/vite.svg
 - llms-full.txt
@@ -233,7 +192,6 @@ metadata:
   homepage_uri: https://github.com/arturictus/ruby_reactor
   source_code_uri: https://github.com/arturictus/ruby_reactor
   changelog_uri: https://github.com/arturictus/ruby_reactor/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -248,8 +206,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A dynamic, concurrent, dependency-resolving saga orchestrator for Ruby.
 test_files: []

data/documentation/DAG.md DELETED Viewed

@@ -1,457 +0,0 @@
-# DAG Execution and Saga Patterns in RubyReactor
-RubyReactor uses Directed Acyclic Graphs (DAGs) to manage step dependencies and implements saga patterns for reliable distributed transactions. This document explains how DAG execution works and how saga patterns ensure consistency across complex workflows.
-## Directed Acyclic Graphs (DAGs)
-A DAG is a graph with directed edges and no cycles, ensuring that step dependencies can be resolved in a deterministic order.
-### DAG Structure
-```mermaid
-graph TD
-    A[Step A] --> C[Step C]
-    B[Step B] --> C
-    C --> D[Step D]
-    C --> E[Step E]
-    D --> F[Step F]
-    E --> F
-    style A fill:#e1f5fe
-    style B fill:#e1f5fe
-    style C fill:#fff3e0
-    style D fill:#e8f5e8
-    style E fill:#e8f5e8
-    style F fill:#ffebee
-```
-**Legend:**
-- 🔵 Independent steps (can run in parallel)
-- 🟡 Dependent steps (wait for prerequisites)
-- 🟢 Ready to execute
-- 🔴 Final step
-### DAG Execution Algorithm
-```mermaid
-graph TD
-    A[Start Execution] --> B[Build Dependency Graph]
-    B --> C[Identify Ready Steps<br/>no unmet dependencies]
-    C --> D{Ready Steps<br/>Available?}
-    D -->|No| E[Execution Complete]
-    D -->|Yes| F[Execute Ready Steps<br/>in Parallel]
-    F --> G[Update Dependencies<br/>Mark steps complete]
-    G --> H[Collect Results]
-    H --> I{Execution<br/>Successful?}
-    I -->|Yes| C
-    I -->|No| J[Initiate Saga Compensation]
-    J --> K[Execution Failed]
-```
-### Dependency Resolution
-```mermaid
-graph TD
-    A[Step Dependencies] --> B[Topological Sort]
-    B --> C[Execution Order<br/>A → B → C → D]
-    C --> D[Parallel Execution<br/>Where Possible]
-    subgraph "Level 1"
-        A1[Independent Steps]
-    end
-    subgraph "Level 2"
-        B1[Steps depending on Level 1]
-    end
-    subgraph "Level 3"
-        C1[Steps depending on Level 2]
-    end
-```
-## Saga Patterns
-RubyReactor implements saga patterns to ensure consistency across distributed operations. Sagas provide transactional semantics for long-running business processes.
-### Saga Execution Flow
-```mermaid
-graph TD
-    A[Saga Initiated] --> B[Execute Step 1]
-    B --> C{Step 1<br/>Success?}
-    C -->|Yes| D[Execute Step 2]
-    C -->|No| E[Compensation Step 1]
-    D --> F{Step 2<br/>Success?}
-    F -->|Yes| G[Execute Step 3]
-    F -->|No| H[Compensate Step 2, Undo Step 1]
-    G --> I{Step 3<br/>Success?}
-    I -->|Yes| J[Saga Complete]
-    I -->|No| K[Compensate Step 3<br/>Then Undo Steps 2 and 1]
-    H --> L[Saga Failed]
-    K --> L
-    E --> L
-    style A fill:#e3f2fd
-    style J fill:#e8f5e8
-    style L fill:#ffebee
-```
-### Compensation Strategies
-#### Backward Recovery (Rollback)
-```mermaid
-graph TD
-    A[Forward Execution] --> B[Step A Success]
-    B --> C[Step B Success]
-    C --> D[Step C Fails]
-    D --> E[Start Compensation]
-    E --> F[Compensate C]
-    F --> G[Undo B]
-    G --> H[Undo A]
-    H --> I[Consistent State Restored]
-    style A fill:#e3f2fd
-    style I fill:#e8f5e8
-    style D fill:#ffebee
-```
-#### Forward Recovery (Retry)
-```mermaid
-graph TD
-    A[Step Fails] --> B{Can Retry?}
-    B -->|Yes| C[Calculate Backoff]
-    C --> D[Schedule Retry]
-    D --> E[Retry Execution]
-    E --> F{Retry<br/>Success?}
-    F -->|Yes| G[Continue Saga]
-    F -->|No| B
-    B -->|No| H[Compensation Required]
-    style G fill:#e8f5e8
-    style H fill:#ffebee
-```
-## Complex Saga Scenarios
-### Order Processing Saga
-```mermaid
-graph TD
-    A[Order Submitted] --> B[Validate Order]
-    B --> C{Valid?}
-    C -->|No| D[Saga Failed]
-    C -->|Yes| E[Reserve Inventory]
-    E --> F{Reserved?}
-    F -->|No| G[Saga Failed]
-    F -->|Yes| H[Process Payment]
-    H --> I{Payment OK?}
-    I -->|No| J[Release Inventory<br/>Compensation]
-    I -->|Yes| K[Update Order Status]
-    K --> L[Send Confirmation]
-    L --> M[Saga Complete]
-    J --> D
-    G --> D
-    style A fill:#e3f2fd
-    style M fill:#e8f5e8
-    style D fill:#ffebee
-```
-## DAG + Saga Integration
-RubyReactor combines DAG execution with saga patterns for complex workflows:
-```mermaid
-graph TD
-    subgraph "DAG Execution"
-        A1[Build Graph] --> B1[Resolve Dependencies]
-        B1 --> C1[Execute in Order]
-    end
-    subgraph "Saga Pattern"
-        D1[Monitor Execution] --> E1{Step Fails?}
-        E1 -->|No| F1[Continue]
-        E1 -->|Yes| G1[Trigger Compensation]
-    end
-    subgraph "Retry Mechanism"
-        H1[Failed Step] --> I1{Can Retry?}
-        I1 -->|Yes| J1[Requeue Job]
-        I1 -->|No| K1[Final Compensation]
-    end
-    C1 --> D1
-    G1 --> H1
-    J1 --> A1
-    style F1 fill:#e8f5e8
-    style K1 fill:#ffebee
-```
-## Execution States
-### Step States
-```mermaid
-stateDiagram-v2
-    [*] --> Pending
-    Pending --> Running
-    Running --> Completed
-    Running --> Failed
-    Failed --> Compensating
-    Compensating --> Compensated
-    Compensated --> [*]
-    Failed --> Retrying
-    Retrying --> Pending
-```
-### Saga States
-```mermaid
-stateDiagram-v2
-    [*] --> Initiated
-    Initiated --> Executing
-    Executing --> Completed
-    Executing --> Failing
-    Failing --> Compensating
-    Compensating --> Failed
-    Failed --> [*]
-    Completed --> [*]
-```
-## Error Handling Patterns
-### Cascading Compensation
-```mermaid
-graph TD
-    A[Root Cause Failure] --> B[Step N Fails]
-    B --> C[Mark Step N for Compensation]
-    C --> D[Stop Downstream Steps]
-    D --> E[Execute Compensation Chain]
-    E --> F[Step N-1 Compensation]
-    F --> G[Step N-2 Compensation]
-    G --> H[...continue to Step 1]
-    H --> I[Consistent State Achieved]
-    style A fill:#ffebee
-    style I fill:#e8f5e8
-```
-### Partial Success Handling
-```mermaid
-graph TD
-    A[Multi-Step Process] --> B[Step 1 Success]
-    B --> C[Step 2 Success]
-    C --> D[Step 3 Fails]
-    D --> E{Essential<br/>Step?}
-    E -->|Yes| F[Full Compensation Required]
-    E -->|No| G[Partial Success Acceptable]
-    G --> H[Continue with Successful Steps]
-    H --> I[Manual Intervention for Failed Step]
-    style G fill:#fff3e0
-    style I fill:#fff3e0
-```
-## Performance Considerations
-### Parallel Execution in DAGs
-```mermaid
-graph TD
-    A[Level 1<br/>Parallel Steps] --> B[Level 2<br/>Parallel Steps]
-    B --> C[Level 3<br/>Parallel Steps]
-    subgraph "Level 1 (3 steps)"
-        A1[Step A] & A2[Step B] & A3[Step C]
-    end
-    subgraph "Level 2 (2 steps)"
-        B1[Step D] & B2[Step E]
-    end
-    subgraph "Level 3 (1 step)"
-        C1[Step F]
-    end
-    A1 --> B1
-    A2 --> B1
-    A3 --> B2
-    B1 --> C1
-    B2 --> C1
-```
-### Saga Overhead
-```mermaid
-graph TD
-    A[Normal Execution] --> B[Fast Path<br/>No Compensation]
-    C[Saga Execution] --> D[State Tracking<br/>Compensation Logic]
-    D --> E[Increased Complexity]
-    A --> F[Better Performance]
-    C --> G[Reliability Benefits]
-    style F fill:#e8f5e8
-    style G fill:#e8f5e8
-```
-## Monitoring and Observability
-### Saga Metrics
-```mermaid
-graph TD
-    A[Saga Metrics] --> B[Completion Rate]
-    A --> C[Average Duration]
-    A --> D[Compensation Frequency]
-    A --> E[Retry Attempts]
-    A --> F[Failure Patterns]
-    B --> G[Business Health]
-    C --> H[Performance Monitoring]
-    D --> I[Reliability Insights]
-    E --> J[Resilience Metrics]
-    F --> K[Root Cause Analysis]
-```
-### DAG Execution Monitoring
-```mermaid
-graph TD
-    A[DAG Monitoring] --> B[Step Dependencies]
-    A --> C[Execution Order]
-    A --> D[Parallel Execution]
-    A --> E[Bottleneck Identification]
-    B --> F[Dependency Health]
-    C --> G[Execution Flow]
-    D --> H[Concurrency Optimization]
-    E --> I[Performance Tuning]
-```
-## Best Practices
-### DAG Design
-1. **Keep it Simple**: Minimize dependencies to maximize parallelism
-2. **Clear Dependencies**: Make step relationships explicit
-3. **Avoid Cycles**: Ensure DAG remains acyclic
-4. **Test Execution Order**: Verify topological sort produces expected order
-### Saga Implementation
-1. **Idempotent Operations**: Design steps to be safely retryable
-2. **Compensation Logic**: Always implement proper undo operations
-3. **State Tracking**: Maintain sufficient state for compensation
-4. **Timeout Handling**: Set appropriate timeouts for long-running sagas
-### Error Handling
-1. **Graceful Degradation**: Handle partial failures appropriately
-2. **Circuit Breakers**: Prevent cascade failures
-3. **Monitoring**: Track saga health and failure patterns
-4. **Recovery Procedures**: Document manual recovery processes
-## Implementation Examples
-### Simple DAG with Saga
-```ruby
-class OrderProcessingReactor < RubyReactor::Reactor
-  async true
-  step :validate_order do
-    run { validate_order_logic }
-  end
-  step :reserve_inventory do
-    argument :order, result(:validate_order)
-    run do |args, _context|
-      reserve_inventory_logic(args[:order])
-    end
-    compensate do
-      # Release reservation
-      release_inventory_logic
-    end
-  end
-  step :process_payment do
-    argument :inventory_result, result(:reserve_inventory)
-    run do |args, _context|
-      process_payment_logic(args[:inventory_result])
-    end
-    compensate do
-      # Refund payment
-      refund_payment_logic
-    end
-  end
-  step :confirm_order do
-    argument :payment_result, result(:process_payment)
-    run do |args, _context|
-      confirm_order_logic(args[:payment_result])
-    end
-  end
-end
-```
-### Complex DAG with Parallel Execution
-```ruby
-class ComplexWorkflowReactor < RubyReactor::Reactor
-  async true
-  # Level 1 - Independent steps
-  step :validate_input do
-    run { validate_input_logic }
-  end
-  step :check_permissions do
-    run { check_permissions_logic }
-  end
-  # Level 2 - Depends on level 1
-  step :process_data do
-    argument :validation_result, result(:validate_input)
-    argument :permissions_result, result(:check_permissions)
-    run do |args, _context|
-      process_data_logic(args[:validation_result], args[:permissions_result])
-    end
-  end
-  # Level 3 - Parallel steps depending on level 2
-  step :send_notification do
-    argument :data_result, result(:process_data)
-    run do |args, _context|
-      send_notification_logic(args[:data_result])
-    end
-  end
-  step :update_audit_log do
-    argument :data_result, result(:process_data)
-    run do |args, _context|
-      update_audit_log_logic(args[:data_result])
-    end
-  end
-  # Level 4 - Depends on level 3
-  step :cleanup do
-    argument :notification_result, result(:send_notification)
-    argument :audit_result, result(:update_audit_log)
-    run do |args, _context|
-      cleanup_logic(args[:notification_result], args[:audit_result])
-    end
-  end
-end
-```
-This DAG allows `send_notification` and `update_audit_log` to execute in parallel after `process_data` completes, demonstrating how RubyReactor maximizes concurrency while maintaining dependency ordering