caixanegra 0.1.0

data/app/controllers/caixanegra/api/designer/flows_controller.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  module API
+    module Designer
+      class FlowsController < ::Caixanegra::APIController
+        before_action :set_flow, only: %i[show debug_run]
+
+        def show
+          render json: @flow
+        end
+
+        def update
+          Caixanegra::Manager.set(params[:id], JSON.parse(request.body.read))
+
+          head :ok
+        end
+
+        def debug_run
+          execution = Caixanegra::Executor.new(
+            initial_carryover: initial_carryover,
+            flow_definition: @flow,
+            unit_scope: params[:unit_scope],
+            debug_mode: true
+          ).run
+
+          render json: { result: execution[:result], debug: execution[:debug] }
+        end
+
+        private
+
+        def initial_carryover
+          JSON.parse(request.body.read)
+        rescue StandardError
+          {}
+        end
+
+        def set_flow
+          @flow = Caixanegra::Manager.get(params[:id])
+        end
+      end
+    end
+  end
+end

data/app/controllers/caixanegra/api/designer/units_controller.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  module API
+    module Designer
+      class UnitsController < ::Caixanegra::APIController
+        def index
+          render json: units
+        end
+
+        private
+
+        def unit_scope
+          params[:scope].presence || nil
+        end
+
+        def units
+          @units ||= begin
+            base_units = Caixanegra.units.reject { |_, v| v.is_a? Hash }
+            scope_units = Caixanegra.units[unit_scope] if unit_scope.present?
+            all_units = base_units.merge(scope_units || {})
+
+            all_units.map do |k, v|
+              base = {
+                title: v.name,
+                type: v.type,
+                description: v.description,
+                class: k,
+                exits: v.exits&.map { |e| { name: e } },
+                inputs: v.inputs,
+                assignments: v.assignments
+              }
+
+              base[:set] = v.set if base[:set]
+
+              base
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/caixanegra/api_controller.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class APIController < ActionController::API
+  end
+end

data/app/controllers/caixanegra/application_controller.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class ApplicationController < ActionController::Base
+    protect_from_forgery with: :exception
+  end
+end

data/app/controllers/caixanegra/designer_controller.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class DesignerController < ApplicationController
+    def index
+      @mounted_path = Caixanegra::Engine.routes.find_script_name({})
+    end
+  end
+end

data/app/helpers/caixanegra/application_helper.rb

@@ -0,0 +1,4 @@
+module Caixanegra
+  module ApplicationHelper
+  end
+end

data/app/models/caixanegra/unit.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class Unit
+    attr_reader :oid
+
+    def initialize(oid, inputs = {}, mappings = {}, carry_over = {}, storage = {})
+      @oid = oid
+      @mappings = mappings
+      @inputs = inputs
+      @carry_over = carry_over.with_indifferent_access
+      @storage = storage.with_indifferent_access
+      set_mapping_defaults
+    end
+
+    def current_carry_over
+      @carry_over.dup
+    end
+
+    def current_storage
+      @storage.dup
+    end
+
+    def carry_over(value)
+      @carry_over.merge!(value) if value.is_a? Hash
+    end
+
+    def persist(value)
+      @storage.merge!(value) if value.is_a? Hash
+    end
+
+    def exit_through(exit_id)
+      {
+        exit_through: exit_id,
+        carry_over: @carry_over
+      }
+    end
+
+    def flow
+      exit_through exits.first
+    end
+
+    def input(id)
+      input_metadata = @mappings[id]
+      input_value = case input_metadata&.[](:type)
+                    when 'storage'
+                      @storage[id]
+                    when 'carryover'
+                      @carry_over[id]
+                    when 'user'
+                      input_metadata[:value]
+                    end
+
+      if input_value.present?
+        result = input_value.dup
+        input_value.to_s.scan(Regexp.new(/%(.*?)%/)) do |match|
+          match = match[0]
+          result.gsub!("%#{match}%", @carry_over[match] || '')
+        end
+        input_value.to_s.scan(Regexp.new(/@(.*?)@/)) do |match|
+          match = match[0]
+          result.gsub!("@#{match}@", @storage[match] || '')
+        end
+
+        input_value = result
+      end
+      input_value.presence || @inputs[id][:default]
+    end
+
+    def name
+      self.class.name
+    end
+
+    def description
+      self.class.description
+    end
+
+    def inputs
+      self.class.inputs || []
+    end
+
+    def exits
+      self.class.exits || []
+    end
+
+    def set
+      self.class.set || []
+    end
+
+    private
+
+    def set_mapping_defaults
+      (self.class.inputs || {}).each do |key, data|
+        next if @mappings.key? key
+
+        @mappings[key] = { type: 'carryover' }
+        @mappings[key][:value] = data[:default] if data[:default].present?
+      end
+    end
+
+    class << self
+      attr_reader :name, :description, :inputs, :exits, :assignments, :type
+
+      @type = :passthrough
+
+      def configure_name(value)
+        @name = value
+      end
+
+      def configure_description(value)
+        @description = value
+      end
+
+      def configure_type(value)
+        @type = value
+      end
+
+      def configure_exits(exits)
+        @exits = exits
+      end
+
+      def configure_inputs(inputs)
+        @inputs = inputs
+      end
+
+      def configure_assignments(assignments)
+        @assignments = assignments
+      end
+    end
+  end
+end

data/app/views/caixanegra/designer/index.html.erb

@@ -0,0 +1,109 @@
+<consts>
+  <mounted_path value="<%= @mounted_path %>" />
+</consts>
+<canvas style="position:fixed;top:0px;left:0px;"></canvas>
+<div id="execution">
+  <div id="reset">
+    <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" xml:space="preserve">
+      <g><path d="M17.1,23.8L12.4,21l2.7-4.8l1.7,1l-1.7,3.1l3,1.8L17.1,23.8z M5.7,11L4,8L1.1,9.7L0.1,8l4.7-2.8L7.5,10L5.7,11z"/></g>
+      <g><polygon points="22,6 16.5,6 16.5,4 20,4 20,0.5 22,0.5"/></g>
+      <g><path d="M15.4,21.5l-0.4-2c4-0.9,6.9-4.5,6.9-8.6c0-0.6-0.1-1.3-0.2-1.9l2-0.4c0.2,0.8,0.3,1.6,0.3,2.3	C24,16.1,20.4,20.5,15.4,21.5z"/></g>
+      <g><path d="M9.8,21.3C5.3,19.9,2.2,15.8,2.2,11c0-1.3,0.2-2.6,0.7-3.8l1.9,0.7c-0.4,1-0.6,2-0.6,3.1c0,3.9,2.5,7.2,6.1,8.4L9.8,21.3z"/></g>
+      <g><path d="M19.6,5c-1.7-1.9-4.1-3-6.6-3c-2.1,0-4.1,0.8-5.7,2.1L6,2.6C7.9,0.9,10.4,0,13,0c3.1,0,6,1.3,8.1,3.6L19.6,5z"/></g>
+    </svg>
+  </div>
+  <div id="play">
+    <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" xml:space="preserve">
+      <path d="M19,12L5,22.2V1.8L19,12z"/>
+    </svg>
+  </div>
+  <div id="configure">
+    <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" enable-background="new 0 0 24 24" xml:space="preserve">
+      <path d="M19,17h-2v-2.1c-0.4-0.1-0.7-0.2-1-0.4l-1.5,1.5l-1.4-1.4l1.5-1.5c-0.2-0.3-0.3-0.7-0.4-1H12v-2h2.1 c0.1-0.4,0.2-0.7,0.4-1l-1.5-1.5l1.4-1.4L16,7.6c0.3-0.2,0.7-0.3,1-0.4V5h2v2.1c0.4,0.1,0.7,0.2,1,0.4l1.5-1.5l1.4,1.4L21.4,9 c0.2,0.3,0.3,0.7,0.4,1H24v2h-2.1c-0.1,0.4-0.2,0.7-0.4,1l1.5,1.5l-1.4,1.4L20,14.4c-0.3,0.2-0.7,0.3-1,0.4V17z M18,9 c-1.1,0-2,0.9-2,2c0,1.1,0.9,2,2,2s2-0.9,2-2C20,9.9,19.1,9,18,9z"/>
+      <path d="M7,12H5V9.9C4.6,9.8,4.3,9.6,4,9.4l-1.5,1.5L1.1,9.5L2.6,8C2.4,7.7,2.2,7.4,2.1,7H0V5h2.1c0.1-0.4,0.2-0.7,0.4-1L1.1,2.5 l1.4-1.4L4,2.6c0.3-0.2,0.7-0.3,1-0.4V0h2v2.1c0.4,0.1,0.7,0.2,1,0.4l1.5-1.5l1.4,1.4L9.4,4c0.2,0.3,0.3,0.7,0.4,1H12v2H9.9 C9.8,7.4,9.6,7.7,9.4,8l1.5,1.5l-1.4,1.4L8,9.4C7.7,9.6,7.4,9.8,7,9.9V12z M6,4C4.9,4,4,4.9,4,6s0.9,2,2,2s2-0.9,2-2S7.1,4,6,4z"/>
+      <path d="M9,24H7v-2.1c-0.4-0.1-0.7-0.2-1-0.4l-1.5,1.5l-1.4-1.4L4.6,20c-0.2-0.3-0.3-0.7-0.4-1H2v-2h2.1c0.1-0.4,0.2-0.7,0.4-1 l-1.5-1.5l1.4-1.4L6,14.6c0.3-0.2,0.7-0.3,1-0.4V12h2v2.1c0.4,0.1,0.7,0.2,1,0.4l1.5-1.5l1.4,1.4L11.4,16c0.2,0.3,0.3,0.7,0.4,1 H14v2h-2.1c-0.1,0.4-0.2,0.7-0.4,1l1.5,1.5l-1.4,1.4L10,21.4c-0.3,0.2-0.7,0.3-1,0.4V24z M8,16c-1.1,0-2,0.9-2,2s0.9,2,2,2 s2-0.9,2-2S9.1,16,8,16z"/>
+    </svg>
+  </div>
+  <div id="console">
+    <svg version="1.1" id="XMLID_75_" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" xml:space="preserve">
+      <path d="M24,24H0V0h24V24z M2,22h20V2H6v2h16v2H2V22z M2,4h2V2H2V4z M16,16h-6v-2h6V16z M5.7,15.7l-1.4-1.4L6.6,12L4.3,9.7 l1.4-1.4L9.4,12L5.7,15.7z"/>
+    </svg>
+  </div>
+</div>
+<div id="addUnit"><span>+</span></div>
+<div id="save"><span>save</span></div>
+<div id="unitMenu"></div>
+<div id="executionConsole"></div>
+<div id="executionConfiguration">
+  <div class="section">
+    <span>initial carry-over</span>
+    <span id="clearCarryOverObject">clear</span>
+  </div>
+  <div id="carryOverObject"></div>
+</div>
+<div id="unitDebugHits">
+  <div class="content">
+    <div class="name">run hits</div>
+    <div id="debugData"></div>
+  </div>
+</div>
+<div id="unitDetail">
+  <div class="color-code"></div>
+  <div class="content">
+    <div id="unitDetailClass" class="unit-detail-headers">
+      <div class="name"></div>
+      <div class="delete">
+        <div id="toggler">
+          <svg viewBox="0 0 56 56" xmlns="http://www.w3.org/2000/svg">
+            <path d="M 44.5235 48.6602 L 46.1407 14.3945 L 48.4844 14.3945 C 49.4454 14.3945 50.2187 13.5976 50.2187 12.6367 C 50.2187 11.6758 49.4454 10.8555 48.4844 10.8555 L 38.2422 10.8555 L 38.2422 7.3398 C 38.2422 3.9883 35.9688 1.8086 32.3595 1.8086 L 23.5938 1.8086 C 19.9844 1.8086 17.7344 3.9883 17.7344 7.3398 L 17.7344 10.8555 L 7.5391 10.8555 C 6.6016 10.8555 5.7813 11.6758 5.7813 12.6367 C 5.7813 13.5976 6.6016 14.3945 7.5391 14.3945 L 9.8829 14.3945 L 11.5000 48.6836 C 11.6641 52.0586 13.8907 54.1914 17.2657 54.1914 L 38.7579 54.1914 C 42.1095 54.1914 44.3595 52.0351 44.5235 48.6602 Z M 21.4844 7.5742 C 21.4844 6.2383 22.4688 5.3008 23.8751 5.3008 L 32.1016 5.3008 C 33.5313 5.3008 34.5157 6.2383 34.5157 7.5742 L 34.5157 10.8555 L 21.4844 10.8555 Z M 17.6173 50.6758 C 16.2579 50.6758 15.2500 49.6445 15.1797 48.2852 L 13.5391 14.3945 L 42.3907 14.3945 L 40.8438 48.2852 C 40.7735 49.6680 39.7891 50.6758 38.4063 50.6758 Z M 34.9610 46.5508 C 35.7344 46.5508 36.3204 45.9180 36.3438 45.0273 L 37.0469 20.2773 C 37.0704 19.3867 36.4610 18.7305 35.6641 18.7305 C 34.9376 18.7305 34.3282 19.4102 34.3048 20.2539 L 33.6016 45.0273 C 33.5782 45.8711 34.1641 46.5508 34.9610 46.5508 Z M 21.0626 46.5508 C 21.8595 46.5508 22.4454 45.8711 22.4219 45.0273 L 21.7188 20.2539 C 21.6954 19.4102 21.0626 18.7305 20.3360 18.7305 C 19.5391 18.7305 18.9532 19.3867 18.9766 20.2773 L 19.7032 45.0273 C 19.7266 45.9180 20.2891 46.5508 21.0626 46.5508 Z M 29.4298 45.0273 L 29.4298 20.2539 C 29.4298 19.4102 28.7969 18.7305 28.0235 18.7305 C 27.2500 18.7305 26.5938 19.4102 26.5938 20.2539 L 26.5938 45.0273 C 26.5938 45.8711 27.2500 46.5508 28.0235 46.5508 C 28.7735 46.5508 29.4298 45.8711 29.4298 45.0273 Z"/>
+          </svg>
+        </div>
+        <div class="confirm-buttons">
+          <div id="confirmDelete">
+            <svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+              <path fill-rule="evenodd" clip-rule="evenodd" d="M12 22C17.5228 22 22 17.5228 22 12C22 6.47715 17.5228 2 12 2C6.47715 2 2 6.47715 2 12C2 17.5228 6.47715 22 12 22ZM10.2426 14.4142L17.3137 7.34315L18.7279 8.75736L10.2426 17.2426L6 13L7.41421 11.5858L10.2426 14.4142Z"/>
+            </svg>
+          </div>
+          <div id="cancelDelete">
+            <svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+              <path fill-rule="evenodd" clip-rule="evenodd" d="M22 12C22 17.5228 17.5228 22 12 22C6.47715 22 2 17.5228 2 12C2 6.47715 6.47715 2 12 2C17.5228 2 22 6.47715 22 12ZM15.7123 16.773L12 13.0607L8.28769 16.773L7.22703 15.7123L10.9393 12L7.22703 8.28769L8.28769 7.22703L12 10.9393L15.7123 7.22703L16.773 8.28769L13.0607 12L16.773 15.7123L15.7123 16.773Z"/>
+            </svg>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div id="unitDetailDescription"></div>
+    <div class="field">
+      <input type="text" id="unitDetailTitle" placeholder="title" />
+    </div>
+    <div id="dynamicContent"></div>
+  </div>
+</div>
+<div id="blocker">
+  <div class="information">
+    <div>caixa<span>negra</span></div>
+    <div class="message">loading your flow</div>
+  </div>
+</div>
+<div id="action_messenger">
+  <div class="icon icon-error">
+  <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 51.976 51.976" xml:space="preserve">
+    <path d="M44.373,7.603c-10.137-10.137-26.632-10.138-36.77,0c-10.138,10.138-10.137,26.632,0,36.77s26.632,10.138,36.77,0 C54.51,34.235,54.51,17.74,44.373,7.603z M36.241,36.241c-0.781,0.781-2.047,0.781-2.828,0l-7.425-7.425l-7.778,7.778 c-0.781,0.781-2.047,0.781-2.828,0c-0.781-0.781-0.781-2.047,0-2.828l7.778-7.778l-7.425-7.425c-0.781-0.781-0.781-2.048,0-2.828 c0.781-0.781,2.047-0.781,2.828,0l7.425,7.425l7.071-7.071c0.781-0.781,2.047-0.781,2.828,0c0.781,0.781,0.781,2.047,0,2.828 l-7.071,7.071l7.425,7.425C37.022,34.194,37.022,35.46,36.241,36.241z"/>
+  </svg>
+  </div>
+  <div class="icon icon-working">
+    <svg viewBox="0 -8 72 72" xmlns="http://www.w3.org/2000/svg">
+      <path d="M56.74,20.89l-1-2.31c3.33-7.53,3.11-7.75,2.46-8.41L54,6l-.42-.35h-.49c-.26,0-1,0-7.51,2.93l-2.38-1C40.09,0,39.77,0,38.87,0h-6c-.9,0-1.25,0-4.1,7.66l-2.37,1C22,6.78,19.45,5.84,18.75,5.84l-.56,0-4.58,4.49c-.7.65-.94.88,2.58,8.3l-1,2.3c-7.79,3-7.79,3.3-7.79,4.23v5.89c0,.92,0,1.25,7.82,4l1,2.29c-3.33,7.53-3.11,7.76-2.46,8.41L18,50l.42.37h.5c.25,0,1,0,7.5-3l2.38,1C31.9,56,32.21,56,33.12,56h6c.92,0,1.25,0,4.11-7.66l2.39-1c4.37,1.85,6.93,2.79,7.61,2.79l.57,0,4.62-4.52c.66-.66.89-.89-2.62-8.28l1-2.3c7.81-3,7.81-3.33,7.81-4.23V24.93C64.57,24,64.57,23.68,56.74,20.89ZM36,37.8A9.8,9.8,0,1,1,46,28,9.91,9.91,0,0,1,36,37.8Z"/>
+    </svg>
+  </div>
+  <div class="icon icon-ok">
+    <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 490.05 490.05" xml:space="preserve">
+      <g>
+        <path d="M418.275,418.275c95.7-95.7,95.7-250.8,0-346.5s-250.8-95.7-346.5,0s-95.7,250.8,0,346.5S322.675,513.975,418.275,418.275
+          z M157.175,207.575l55.1,55.1l120.7-120.6l42.7,42.7l-120.6,120.6l-42.8,42.7l-42.7-42.7l-55.1-55.1L157.175,207.575z"/>
+      </g>
+    </svg>
+  </div>
+  <div class="message"></div>
+</div>
+<%= render partial: "shared/caixanegra/js_dependencies" %>

data/app/views/layouts/caixanegra/application.html.erb

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Caixanegra</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= stylesheet_link_tag "caixanegra/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/app/views/shared/caixanegra/_js_dependencies.html.erb

@@ -0,0 +1,4 @@
+<%= javascript_include_tag("caixanegra/caixanegra.js") %>
+<%= javascript_include_tag("caixanegra/api.js") %>
+<%= javascript_include_tag("caixanegra/sabertooth.js") %>
+<%= javascript_include_tag("caixanegra/designer.js") %>

data/config/routes.rb

@@ -0,0 +1,14 @@
+Caixanegra::Engine.routes.draw do
+  get '/design/:id', to: 'designer#index'
+
+  namespace :api, constraints: { format: :json } do
+    namespace :designer do
+      resources :units, only: %i[index]
+      resources :flows, only: %i[show update] do
+        member do
+          patch :debug_run
+        end
+      end
+    end
+  end
+end

data/lib/caixanegra/engine.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  self.mattr_accessor :units
+  self.mattr_accessor :redis
+  self.units = []
+
+  def self.setup(&block)
+     yield self
+  end
+
+  class Engine < ::Rails::Engine
+    isolate_namespace Caixanegra
+
+    initializer "caixanegra.assets.precompile" do |app|
+      app.config.assets.precompile += %w[
+        caixanegra/api.js
+        caixanegra/caixanegra.js
+        caixanegra/designer.js
+        caixanegra/sabertooth.js
+        caixanegra/application.css
+      ]
+    end
+  end
+end

data/lib/caixanegra/exceptions.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class UnitScopedException < StandardError; end
+end

data/lib/caixanegra/executor.rb

@@ -0,0 +1,201 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class Executor
+    def initialize(params)
+      @initial_carryover = params[:initial_carryover] || {}
+      @flow = (params[:flow_definition] || {}).deep_symbolize_keys
+      @unit_scope = params[:unit_scope]
+      @debug_mode = params[:debug_mode] == true
+      @execution = { history: [], steps: [] }
+      @storage = {}
+    end
+
+    def run
+      run_and_report_result
+    end
+
+    private
+
+    def format_result(result)
+      return result unless @debug_mode
+
+      {
+        result: result,
+        debug: @execution
+      }
+    end
+
+    def run_and_report_result
+      log_console_entry "Started"
+      set_start_unit
+      format_result(flow_through)
+    rescue Caixanegra::UnitScopedException => e
+      log_step_exception(e)
+      log_console_entry("Unit error: #{e.message}")
+      format_result(e.message)
+    rescue => e
+      log_console_entry("Error: #{e.message}")
+      format_result(e.message)
+    end
+
+    def log_console_entry(message)
+      return unless @debug_mode
+
+      @execution[:history] << {
+        timestamp: Time.current.to_i,
+        message: message
+      }
+    end
+
+    def log_new_step(target_unit = @step_unit)
+      return unless @debug_mode
+
+      @execution[:steps] << {
+        oid: target_unit.oid,
+        in: {
+          timestamp: Time.current.to_i,
+          carry_over: target_unit.current_carry_over,
+          storage: target_unit.current_storage
+        }
+      }
+    end
+
+    def log_feeder_step(result, feeder)
+      return unless @debug_mode
+
+      {
+        oid: feeder.oid,
+        in: {
+          timestamp: Time.current.to_i,
+          carry_over: feeder.current_carry_over,
+          storage: feeder.current_storage
+        },
+        out: {
+          timestamp: Time.current.to_i,
+          result: result,
+          target_unit: @step_unit&.oid
+        }
+      }
+    end
+
+    def log_step_exception(exception)
+      return unless @debug_mode
+
+      @execution[:steps].last[:exception] = {
+        timestamp: Time.current.to_i,
+        message: exception.message,
+        backtrace: exception.backtrace
+      }
+    end
+
+    def log_step_result(result, next_unit)
+      return unless @debug_mode
+
+      @execution[:steps].last[:out] = {
+        timestamp: Time.current.to_i,
+        result: result,
+        target_unit: next_unit&.oid
+      }
+    end
+
+    def flow_through
+      while @step_unit.exits.size.nonzero?
+        feeder_steps = process_feeders
+        result = begin
+          log_console_entry("Flowing #{@step_unit.oid}")
+          result = @step_unit.flow
+          @storage.merge! @step_unit.current_storage
+          result
+        rescue => e
+          exception = Caixanegra::UnitScopedException.new(e)
+          exception.set_backtrace(e.backtrace)
+          raise exception
+        end
+        next_unit = next_unit(result)
+        log_step_result(result, next_unit)
+        @execution[:steps] += feeder_steps
+        @step_unit = next_unit
+        log_new_step
+      end
+
+      log_console_entry("Reached terminator #{@step_unit.oid}")
+
+      @step_unit.flow[:carry_over]
+    end
+
+    def map_carry_over(result, target_step: @step_unit)
+      mapped_carry_over = {}
+      exit_name = result[:exit_through]
+      carry_over = result[:carry_over].deep_symbolize_keys
+      metadata = unit_metadata(target_step.oid)
+      mapped_carry_over.merge!(carry_over) if metadata[:type] == 'passthrough'
+      exit_metadata = metadata[:exits].find { |ex| ex[:name] == exit_name.to_s }
+      (exit_metadata[:mappings] || []).each do |mapping|
+        next if mapping[:use].blank? || mapping[:as].blank?
+
+        mapped_carry_over[mapping[:as].to_sym] = carry_over.dig(
+          *(mapping[:use] || '').split('.').map(&:to_sym)
+        )
+      end
+
+      mapped_carry_over
+    end
+
+    def next_unit(result)
+      exit_name = result[:exit_through]
+      metadata = unit_metadata(@step_unit.oid)
+      log_console_entry "Next unit found through '#{exit_name}': '#{@step_unit.oid}'"
+      exit_metadata = metadata[:exits].find { |ex| ex[:name] == exit_name.to_s }
+      unit(exit_metadata[:target], map_carry_over(result))
+    end
+
+    def process_feeders
+      feeder_hits = []
+      carry_over = {}
+      @flow[:units].filter do |unit|
+        unit[:type] == 'feeder' && (unit[:exits] || []).any? { |ex| ex[:target] == @step_unit.oid }
+      end.each do |feeder|
+        feeder_instance = unit_instance(feeder)
+        log_console_entry "Flowing feeder '#{feeder_instance.oid}'"
+        result = feeder_instance.flow
+        carry_over.merge! map_carry_over(result, target_step: feeder_instance)
+        feeder_hits << log_feeder_step(result, feeder_instance)
+      end
+      @step_unit.carry_over(carry_over)
+
+      feeder_hits
+    end
+
+    def unit_metadata(oid)
+      @flow[:units].find { |u| u[:oid] == oid }
+    end
+
+    def set_start_unit
+      @step_unit = unit(@flow[:entrypoint])
+      log_console_entry "Start unit set: #{@step_unit&.oid || 'none'}"
+      @step_unit.carry_over(@initial_carryover)
+      log_new_step
+    end
+
+    def unit(oid, carry_over = {})
+      unit_instance(unit_metadata(oid), carry_over)
+    end
+
+    def unit_instance(unit_data, carry_over = {})
+      mappings = unit_data[:mappings] || {}
+      unit_class = scoped_units[unit_data[:class].to_sym]
+      inputs = unit_class.inputs
+      unit_class.new(unit_data[:oid], inputs, mappings, carry_over, @storage)
+    end
+
+    def scoped_units
+      @scoped_units ||= begin
+        base_units = Caixanegra.units.reject { |_, v| v.is_a? Hash }
+        scope_units = Caixanegra.units[@unit_scope] if @unit_scope.present?
+
+        base_units.merge(scope_units || {})
+      end
+    end
+  end
+end

data/lib/caixanegra/manager.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class Manager
+    class << self
+      def handler(flow_definition = {})
+        uid = SecureRandom.uuid.gsub("-", "")
+
+        Caixanegra.redis.multi do |pipeline|
+          pipeline.hset(:caixanegra, uid, JSON.dump(flow_definition))
+          pipeline.expire(:caixanegra, 1.hour)
+        end
+
+        uid
+      end
+
+      def destroy
+        Caixanegra.redis.hdel(:caixanegra, key)
+      end
+
+      def get(uid)
+        value = Caixanegra.redis.hget(:caixanegra, uid)
+
+        JSON.parse(value) if value.present?
+      end
+
+      def set(uid, flow_definition)
+        Caixanegra.redis.hset(:caixanegra, uid, JSON.dump(flow_definition))
+      end
+    end
+  end
+end

data/lib/caixanegra/version.rb

@@ -0,0 +1,3 @@
+module Caixanegra
+  VERSION = '0.1.0'
+end

data/lib/caixanegra.rb

@@ -0,0 +1,8 @@
+require "caixanegra/exceptions"
+require "caixanegra/engine"
+require "caixanegra/version"
+require "caixanegra/executor"
+require "caixanegra/manager"
+
+module Caixanegra  
+end