flowengine 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 249513128d6e8c8fcd501433415e9dc78976f1a94195dc45661a51157548ced3
+  data.tar.gz: 3deeef88dae2957f36ed04afe2e001b5886ec17700989e7e9a95f5222f4d2731
+SHA512:
+  metadata.gz: b3f12e0ea863990914abe8ffad528ee53637148678c4d2fd044165b9d1c6a4454c4201bb9b208f4976db027a12380c0af786bd5a1e32fbb17109d679681276dc
+  data.tar.gz: d06bfe3f5384a8f5e674ce95dd12a1f2104b287b5db7b0c33b5f56125a65be2553deb6308223889fd78b7d545782c9621e661e1b82640c3968eadb93f3d28ce2

data/.envrc

@@ -0,0 +1,2 @@
+PATH_add bin
+PATH_add exe

data/.rubocop_todo.yml

@@ -0,0 +1,36 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-02-27 03:50:14 UTC using RuboCop version 1.85.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+# Configuration parameters: EnforcedStyle, AllowedGems.
+# SupportedStyles: Gemfile, gems.rb, gemspec
+Gemspec/DevelopmentDependencies:
+  Exclude:
+    - 'flowengine.gemspec'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 18
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 7
+
+# Offense count: 5
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: infinite?, nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/flowengine/rules/contains.rb'
+    - 'lib/flowengine/rules/equals.rb'
+    - 'lib/flowengine/rules/greater_than.rb'
+    - 'lib/flowengine/rules/less_than.rb'
+    - 'lib/flowengine/rules/not_empty.rb'

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-02-26
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Konstantin Gredeskoul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,165 @@
+# Flowengine
+
+[![RSpec](https://github.com/kigster/flowengine/actions/workflows/rspec.yml/badge.svg)](https://github.com/kigster/flowengine/actions/workflows/rspec.yml) [![RuboCop](https://github.com/kigster/flowengine/actions/workflows/rubocop.yml/badge.svg)](https://github.com/kigster/flowengine/actions/workflows/rubocop.yml)
+
+> [!IMPORTANT]
+>
+> Gem's Responsibilities
+>
+> * DSL
+> * Flow Definition
+> * AST-based Rule system
+> * Evaluator
+> * Engine runtime
+> * Validation adapter interface
+> * Graph exporter (Mermaid)
+> * Simulation runner
+> * No ActiveRecord.
+> * No Rails.
+> * No terminal code.
+
+### Proposed Gem Structure
+
+```text
+flowengine/
+├── lib/
+│   ├── flowengine.rb
+│   ├── flowengine/
+│   │   ├── definition.rb
+│   │   ├── dsl.rb
+│   │   ├── node.rb
+│   │   ├── rule_ast.rb
+│   │   ├── evaluator.rb
+│   │   ├── engine.rb
+│   │   ├── validation/
+│   │   │   ├── adapter.rb
+│   │   │   └── dry_validation_adapter.rb
+│   │   ├── graph/
+│   │   │   └── mermaid_exporter.rb
+│   │   └── simulation.rb
+├── exe/
+│   └── flowengine
+```
+
+#### Core Concepts
+
+Immutable structure representing flow graph.
+
+```ruby
+FlowEngine.define do
+  start :earnings
+
+  step :earnings do
+    type :multi_select
+    question "What are your main earnings?"
+    options %w[W2 1099 BusinessOwnership]
+
+    transition to: :business_details,
+               if: contains(:earnings, "BusinessOwnership")
+  end
+end
+```
+
+Definition compiles DSL → Node objects → AST transitions.
+
+No runtime state.
+
+#### Engine (Pure Runtime)
+
+```ruby
+engine = FlowEngine::Engine.new(definition)
+
+engine.current_step
+engine.answer(value)
+engine.finished?
+engine.answers
+```
+
+Engine stores:
+
+* current node id
+* answer hash
+* evaluator
+
+No IO.
+
+#### Rule AST (Clean & Extensible)
+
+You want AST objects, not hash blobs.
+
+```ruby
+Contains.new(:earnings, "BusinessOwnership")
+All.new(rule1, rule2)
+Equals.new(:marital_status, "Married")
+```
+
+Evaluator does polymorphic dispatch:
+
+```ruby
+rule.evaluate(context)
+```
+
+Cleaner than giant case statements.
+
+#### Validation (Dry Integration)
+
+Adapter pattern:
+
+```ruby
+class DryValidationAdapter < Adapter
+  def validate(step, input)
+    step.schema.call(input)
+  end
+end
+```
+
+Core does:
+
+```ruby
+validator.validate(step, input)
+```
+
+IMPORTANT: Core does not depend directly on dry-validation.
+
+### Examples of Mermaid Charts
+
+![Example](docs/flowengine-example.png)
+
+<details>
+  <summary>Expand to See Mermaid Sources</summary>
+
+```mermaid
+flowchart BT
+    filing_status["What is your filing status for 2025?"] --> dependents["How many dependents do you have?"]
+    dependents --> income_types["Select all income types that apply to you in 2025."]
+    income_types -- Business in income_types --> business_count["How many total businesses do you own or are a part..."]
+    income_types -- Investment in income_types --> investment_details["What types of investments do you hold?"]
+    income_types -- Rental in income_types --> rental_details["Provide details about your rental properties."]
+    income_types --> state_filing["Which states do you need to file in?"]
+    business_count -- business_count > 2 --> complex_business_info["With more than 2 businesses, please provide your p..."]
+    business_count --> business_details["How many of each business type do you own?"]
+    complex_business_info --> business_details
+    business_details -- Investment in income_types --> investment_details
+    business_details -- Rental in income_types --> rental_details
+    business_details --> state_filing
+    investment_details -- Crypto in investment_details --> crypto_details["Please describe your cryptocurrency transactions (..."]
+    investment_details -- Rental in income_types --> rental_details
+    investment_details --> state_filing
+    crypto_details -- Rental in income_types --> rental_details
+    crypto_details --> state_filing
+    rental_details --> state_filing
+    state_filing --> foreign_accounts["Do you have any foreign financial accounts (bank a..."]
+    foreign_accounts -- "foreign_accounts == yes" --> foreign_account_details["How many foreign accounts do you have?"]
+    foreign_accounts --> deduction_types["Which additional deductions apply to you?"]
+    foreign_account_details --> deduction_types
+    deduction_types -- Charitable in deduction_types --> charitable_amount["What is your total estimated charitable contributi..."]
+    deduction_types --> contact_info["Please provide your contact information (name, ema..."]
+    charitable_amount -- charitable_amount > 5000 --> charitable_documentation["For charitable contributions over $5,000, please l..."]
+    charitable_amount --> contact_info
+    charitable_documentation --> contact_info
+    contact_info --> review@{ label: "Thank you! Please review your information. Type 'c..." }
+
+    review@{ shape: rect}
+```
+
+</details>

data/Rakefile

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'timeout'
+require 'yard'
+
+def shell(*args)
+  puts "running: #{args.join(' ')}"
+  system(args.join(' '))
+end
+
+task :clean do
+  shell('rm -rf pkg/ tmp/ coverage/ doc/ ' )
+end
+
+task gem: [:build] do
+  shell('gem install pkg/*')
+end
+
+task permissions: [:clean] do
+  shell("chmod -v o+r,g+r * */* */*/* */*/*/* */*/*/*/* */*/*/*/*/*")
+  shell("find . -type d -exec chmod o+x,g+x {} \\;")
+end
+
+task build: :permissions
+
+YARD::Rake::YardocTask.new(:doc) do |t|
+  t.files = %w(lib/**/*.rb exe/*.rb - README.md LICENSE.txt)
+  t.options.unshift('--title', '"FlowEngine — DSL + AST for buildiong complex flows in Ruby."')
+  t.after = -> { exec('open doc/index.html') } if RUBY_PLATFORM =~ /darwin/
+end
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/exe/flowengine

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "flowengine"

data/justfile

@@ -0,0 +1,37 @@
+set shell := ["bash", "-c"]
+
+set dotenv-load
+
+test:
+    @bundle exec rspec
+    @bundle exec rubocop
+
+# Setup Ruby dependencies
+setup-ruby:
+    #!/usr/bin/env bash
+    [[ -d ~/.rbenv ]] || git clone https://github.com/rbenv/rbenv.git ~/.rbenv
+    [[ -d ~/.rbenv/plugins/ruby-build ]] || git clone https://github.com/rbenv/rbenv.git ~/.rbenv
+    cd ~/.rbenv/plugins/ruby-build && git pull && cd - >/dev/null
+    echo -n "Checking if Ruby $(cat .ruby-version | tr -d '\n') is already installed..."
+    rbenv install -s "$(cat .ruby-version | tr -d '\n')" >/dev/null 2>&1 && echo "yes" || echo "it wasn't, but now it is"
+    bundle check || bundle install -j 12
+
+setup: setup-ruby
+
+cli DATA SCHEMA *ARGS:
+    #!/usr/bin/env bash
+    cd .. && ./cli validate-json -f {{DATA}} -s {{SCHEMA}}
+
+validate-valid-json:
+    ./cli validate-json -f VALID-JSON/sample.json -s VALID-JSON/schema.json
+
+format:
+    @bundle exec rubocop -a
+    @bundle exec rubocop --auto-gen-config
+
+lint: 
+    @bundle exec rubocop
+
+
+check-all: lint test
+

data/lib/flowengine/definition.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  class Definition
+    attr_reader :start_step_id, :steps
+
+    def initialize(start_step_id:, nodes:)
+      @start_step_id = start_step_id
+      @steps = nodes.freeze
+      validate!
+      freeze
+    end
+
+    def start_step
+      step(start_step_id)
+    end
+
+    def step(id)
+      steps.fetch(id) { raise UnknownStepError, "Unknown step: #{id.inspect}" }
+    end
+
+    def step_ids
+      steps.keys
+    end
+
+    private
+
+    def validate!
+      raise DefinitionError, "Start step #{start_step_id.inspect} not found in nodes" unless steps.key?(start_step_id)
+    end
+  end
+end

data/lib/flowengine/dsl/flow_builder.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module DSL
+    class FlowBuilder
+      include RuleHelpers
+
+      def initialize
+        @start_step_id = nil
+        @nodes = {}
+      end
+
+      def start(step_id)
+        @start_step_id = step_id
+      end
+
+      def step(id, &)
+        builder = StepBuilder.new
+        builder.instance_eval(&)
+        @nodes[id] = builder.build(id)
+      end
+
+      def build
+        raise DefinitionError, "No start step defined" if @start_step_id.nil?
+        raise DefinitionError, "No steps defined" if @nodes.empty?
+
+        Definition.new(start_step_id: @start_step_id, nodes: @nodes)
+      end
+    end
+  end
+end

data/lib/flowengine/dsl/rule_helpers.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module DSL
+    module RuleHelpers
+      def contains(field, value)
+        Rules::Contains.new(field, value)
+      end
+
+      def equals(field, value)
+        Rules::Equals.new(field, value)
+      end
+
+      def greater_than(field, value)
+        Rules::GreaterThan.new(field, value)
+      end
+
+      def less_than(field, value)
+        Rules::LessThan.new(field, value)
+      end
+
+      def not_empty(field)
+        Rules::NotEmpty.new(field)
+      end
+
+      def all(*rules)
+        Rules::All.new(*rules)
+      end
+
+      def any(*rules)
+        Rules::Any.new(*rules)
+      end
+    end
+  end
+end

data/lib/flowengine/dsl/step_builder.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module DSL
+    class StepBuilder
+      include RuleHelpers
+
+      def initialize
+        @type = nil
+        @question = nil
+        @options = nil
+        @fields = nil
+        @transitions = []
+        @visibility_rule = nil
+      end
+
+      def type(value)
+        @type = value
+      end
+
+      def question(text)
+        @question = text
+      end
+
+      def options(list)
+        @options = list
+      end
+
+      def fields(list)
+        @fields = list
+      end
+
+      def transition(to:, if_rule: nil)
+        @transitions << Transition.new(target: to, rule: if_rule)
+      end
+
+      def visible_if(rule)
+        @visibility_rule = rule
+      end
+
+      def build(id)
+        Node.new(
+          id: id,
+          type: @type,
+          question: @question,
+          options: @options,
+          fields: @fields,
+          transitions: @transitions,
+          visibility_rule: @visibility_rule
+        )
+      end
+    end
+  end
+end

data/lib/flowengine/dsl.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "dsl/rule_helpers"
+require_relative "dsl/step_builder"
+require_relative "dsl/flow_builder"
+
+module FlowEngine
+  module DSL
+  end
+end

data/lib/flowengine/engine.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  class Engine
+    attr_reader :definition, :answers, :history, :current_step_id
+
+    def initialize(definition, validator: Validation::NullAdapter.new)
+      @definition = definition
+      @answers = {}
+      @history = []
+      @current_step_id = definition.start_step_id
+      @validator = validator
+      @history << @current_step_id
+    end
+
+    def current_step
+      return nil if finished?
+
+      definition.step(@current_step_id)
+    end
+
+    def finished?
+      @current_step_id.nil?
+    end
+
+    def answer(value)
+      raise AlreadyFinishedError, "Flow is already finished" if finished?
+
+      result = @validator.validate(current_step, value)
+      raise ValidationError, "Validation failed: #{result.errors.join(", ")}" unless result.valid?
+
+      answers[@current_step_id] = value
+      advance_step
+    end
+
+    private
+
+    def advance_step
+      node = definition.step(@current_step_id)
+      next_id = node.next_step_id(answers)
+
+      @current_step_id = next_id
+      @history << next_id if next_id
+    end
+  end
+end

data/lib/flowengine/errors.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  class Error < StandardError; end
+  class DefinitionError < Error; end
+  class UnknownStepError < Error; end
+  class EngineError < Error; end
+  class AlreadyFinishedError < EngineError; end
+  class ValidationError < EngineError; end
+end

data/lib/flowengine/evaluator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  class Evaluator
+    attr_reader :answers
+
+    def initialize(answers)
+      @answers = answers
+    end
+
+    def evaluate(rule)
+      return true if rule.nil?
+
+      rule.evaluate(answers)
+    end
+  end
+end

data/lib/flowengine/graph/mermaid_exporter.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Graph
+    class MermaidExporter
+      MAX_LABEL_LENGTH = 50
+
+      attr_reader :definition
+
+      def initialize(definition)
+        @definition = definition
+      end
+
+      def export
+        lines = ["flowchart TD"]
+
+        definition.steps.each_value do |node|
+          lines << "  #{node.id}[\"#{truncate(node.question)}\"]"
+
+          node.transitions.each do |transition|
+            label = transition.condition_label
+            lines << if label == "always"
+                       "  #{node.id} --> #{transition.target}"
+                     else
+                       "  #{node.id} -->|\"#{label}\"| #{transition.target}"
+                     end
+          end
+        end
+
+        lines.join("\n")
+      end
+
+      private
+
+      def truncate(text)
+        return "" if text.nil?
+        return text if text.length <= MAX_LABEL_LENGTH
+
+        "#{text[0, MAX_LABEL_LENGTH]}..."
+      end
+    end
+  end
+end

data/lib/flowengine/node.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  class Node
+    attr_reader :id, :type, :question, :options, :fields, :transitions, :visibility_rule
+
+    def initialize(id:, type:, question:, options: nil, fields: nil, transitions: [], visibility_rule: nil)
+      @id = id
+      @type = type
+      @question = question
+      @options = options&.freeze
+      @fields = fields&.freeze
+      @transitions = transitions.freeze
+      @visibility_rule = visibility_rule
+      freeze
+    end
+
+    def next_step_id(answers)
+      match = transitions.find { |t| t.applies?(answers) }
+      match&.target
+    end
+
+    def visible?(answers)
+      return true if visibility_rule.nil?
+
+      visibility_rule.evaluate(answers)
+    end
+  end
+end

data/lib/flowengine/rules/all.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class All < Base
+      attr_reader :rules
+
+      def initialize(*rules)
+        super()
+        @rules = rules.flatten.freeze
+        freeze
+      end
+
+      def evaluate(answers)
+        rules.all? { |rule| rule.evaluate(answers) }
+      end
+
+      def to_s
+        "(#{rules.join(" AND ")})"
+      end
+    end
+  end
+end

data/lib/flowengine/rules/any.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class Any < Base
+      attr_reader :rules
+
+      def initialize(*rules)
+        super()
+        @rules = rules.flatten.freeze
+        freeze
+      end
+
+      def evaluate(answers)
+        rules.any? { |rule| rule.evaluate(answers) }
+      end
+
+      def to_s
+        "(#{rules.join(" OR ")})"
+      end
+    end
+  end
+end

data/lib/flowengine/rules/base.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class Base
+      def evaluate(_answers)
+        raise NotImplementedError, "#{self.class}#evaluate must be implemented"
+      end
+
+      def to_s
+        raise NotImplementedError, "#{self.class}#to_s must be implemented"
+      end
+    end
+  end
+end

data/lib/flowengine/rules/contains.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class Contains < Base
+      attr_reader :field, :value
+
+      def initialize(field, value)
+        super()
+        @field = field
+        @value = value
+        freeze
+      end
+
+      def evaluate(answers)
+        Array(answers[field]).include?(value)
+      end
+
+      def to_s
+        "#{value} in #{field}"
+      end
+    end
+  end
+end

data/lib/flowengine/rules/equals.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class Equals < Base
+      attr_reader :field, :value
+
+      def initialize(field, value)
+        super()
+        @field = field
+        @value = value
+        freeze
+      end
+
+      def evaluate(answers)
+        answers[field] == value
+      end
+
+      def to_s
+        "#{field} == #{value}"
+      end
+    end
+  end
+end

data/lib/flowengine/rules/greater_than.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class GreaterThan < Base
+      attr_reader :field, :value
+
+      def initialize(field, value)
+        super()
+        @field = field
+        @value = value
+        freeze
+      end
+
+      def evaluate(answers)
+        answers[field].to_i > value
+      end
+
+      def to_s
+        "#{field} > #{value}"
+      end
+    end
+  end
+end

data/lib/flowengine/rules/less_than.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class LessThan < Base
+      attr_reader :field, :value
+
+      def initialize(field, value)
+        super()
+        @field = field
+        @value = value
+        freeze
+      end
+
+      def evaluate(answers)
+        answers[field].to_i < value
+      end
+
+      def to_s
+        "#{field} < #{value}"
+      end
+    end
+  end
+end

data/lib/flowengine/rules/not_empty.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Rules
+    class NotEmpty < Base
+      attr_reader :field
+
+      def initialize(field)
+        super()
+        @field = field
+        freeze
+      end
+
+      def evaluate(answers)
+        val = answers[field]
+        return false if val.nil?
+        return false if val.respond_to?(:empty?) && val.empty?
+
+        true
+      end
+
+      def to_s
+        "#{field} is not empty"
+      end
+    end
+  end
+end

data/lib/flowengine/transition.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  class Transition
+    attr_reader :target, :rule
+
+    def initialize(target:, rule: nil)
+      @target = target
+      @rule = rule
+      freeze
+    end
+
+    def condition_label
+      rule ? rule.to_s : "always"
+    end
+
+    def applies?(answers)
+      return true if rule.nil?
+
+      rule.evaluate(answers)
+    end
+  end
+end

data/lib/flowengine/validation/adapter.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Validation
+    class Result
+      attr_reader :errors
+
+      def initialize(valid:, errors: [])
+        @valid = valid
+        @errors = errors.freeze
+        freeze
+      end
+
+      def valid?
+        @valid
+      end
+    end
+
+    class Adapter
+      def validate(_node, _input)
+        raise NotImplementedError, "#{self.class}#validate must be implemented"
+      end
+    end
+  end
+end

data/lib/flowengine/validation/null_adapter.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  module Validation
+    class NullAdapter < Adapter
+      def validate(_node, _input)
+        Result.new(valid: true, errors: [])
+      end
+    end
+  end
+end

data/lib/flowengine/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module FlowEngine
+  VERSION = "0.1.0"
+end

data/lib/flowengine.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "flowengine/version"
+require_relative "flowengine/errors"
+require_relative "flowengine/rules/base"
+require_relative "flowengine/rules/contains"
+require_relative "flowengine/rules/equals"
+require_relative "flowengine/rules/greater_than"
+require_relative "flowengine/rules/less_than"
+require_relative "flowengine/rules/not_empty"
+require_relative "flowengine/rules/all"
+require_relative "flowengine/rules/any"
+require_relative "flowengine/evaluator"
+require_relative "flowengine/transition"
+require_relative "flowengine/node"
+require_relative "flowengine/definition"
+require_relative "flowengine/validation/adapter"
+require_relative "flowengine/validation/null_adapter"
+require_relative "flowengine/engine"
+require_relative "flowengine/dsl"
+require_relative "flowengine/graph/mermaid_exporter"
+
+module FlowEngine
+  def self.define(&)
+    builder = DSL::FlowBuilder.new
+    builder.instance_eval(&)
+    builder.build
+  end
+end

data/sig/flowengine.rbs

@@ -0,0 +1,4 @@
+module Flowengine
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: flowengine
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Konstantin Gredeskoul
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: FlowEngine provides a DSL for defining multi-step flows as directed graphs
+  with conditional branching, an AST-based rule evaluator, and a pure-Ruby runtime
+  engine. No framework dependencies.
+email:
+- kigster@gmail.com
+executables:
+- flowengine
+extensions: []
+extra_rdoc_files: []
+files:
+- ".envrc"
+- ".rubocop_todo.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- docs/flowengine-example.png
+- exe/flowengine
+- justfile
+- lib/flowengine.rb
+- lib/flowengine/definition.rb
+- lib/flowengine/dsl.rb
+- lib/flowengine/dsl/flow_builder.rb
+- lib/flowengine/dsl/rule_helpers.rb
+- lib/flowengine/dsl/step_builder.rb
+- lib/flowengine/engine.rb
+- lib/flowengine/errors.rb
+- lib/flowengine/evaluator.rb
+- lib/flowengine/graph/mermaid_exporter.rb
+- lib/flowengine/node.rb
+- lib/flowengine/rules/all.rb
+- lib/flowengine/rules/any.rb
+- lib/flowengine/rules/base.rb
+- lib/flowengine/rules/contains.rb
+- lib/flowengine/rules/equals.rb
+- lib/flowengine/rules/greater_than.rb
+- lib/flowengine/rules/less_than.rb
+- lib/flowengine/rules/not_empty.rb
+- lib/flowengine/transition.rb
+- lib/flowengine/validation/adapter.rb
+- lib/flowengine/validation/null_adapter.rb
+- lib/flowengine/version.rb
+- sig/flowengine.rbs
+homepage: https://github.com/kigster/flowengine
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/kigster/flowengine
+  source_code_uri: https://github.com/kigster/flowengine
+  changelog_uri: https://github.com/kigster/flowengine/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: A declarative flow engine for building rules-driven wizards and intake forms
+test_files: []