hyraft-rule 0.1.0.alpha1

data/hyraft-rule.gemspec

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require_relative "lib/hyraft/rule/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "hyraft-rule"
+  spec.version = Hyraft::Rule::VERSION
+  spec.authors = ["Demjhon Silver"]
+
+
+  spec.summary = "Hyraft Rule - Command system for Hyraft applications"
+  spec.description = "A standalone command system with migrations for Hyraft applications"
+  spec.homepage = "https://github.com/demjhonsilver/hyraft-rule"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.4.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  # Manual file listing without git dependency
+# In hyraft-rule.gemspec - update the files section
+  spec.files = [
+    "exe/hyraft-rule",
+    "exe/hyraft-rule-db",
+    "exe/hyr-rule",
+    "exe/hyr-rule-db",
+    "lib/hyraft/rule.rb",
+    "lib/hyraft/rule/version.rb",
+    "lib/hyraft/rule/command.rb",
+    "lib/hyraft/rule/engine/source_command.rb",
+    "lib/hyraft/rule/engine/circuit_command.rb",
+    "lib/hyraft/rule/engine/port_command.rb",
+    "lib/hyraft/rule/adapter_request/web_adapter_command.rb",
+    "lib/hyraft/rule/adapter_request/remove_adapter_command.rb",
+    "lib/hyraft/rule/adapter_exhaust/data_gateway_command.rb", 
+    "lib/hyraft/rule/assemble_command.rb", 
+    "lib/hyraft/rule/disassemble_command.rb", 
+     "lib/hyraft/rule/template_command.rb", 
+    "LICENSE.txt",
+    "README.md",
+    "CHANGELOG.md",
+    "hyraft-rule.gemspec"
+  ]
+  
+  spec.bindir = "exe"
+  spec.executables = ["hyraft-rule", "hyraft-rule-db", "hyr-rule", "hyr-rule-db"]
+  spec.require_paths = ["lib"]
+
+
+  
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+end

data/lib/hyraft/rule/adapter_exhaust/data_gateway_command.rb

@@ -0,0 +1,132 @@
+# lib/hyraft/rule/adapter_exhaust/data_gateway_command.rb
+# frozen_string_literal: true
+
+require 'fileutils'
+
+module Hyraft
+  module Rule
+    module AdapterExhaust
+      class DataGatewayCommand
+        def self.start(args)
+          new(args).execute
+        end
+
+        def initialize(args)
+          @gateway_name = args[0]
+          @table_name = extract_table_name(@gateway_name)
+          @target_dir = args[1] || "."
+        end
+
+        def execute
+          return show_usage unless @gateway_name
+
+          filename = "sequel_#{@table_name}_gateway.rb"
+          gateway_dir = File.join(@target_dir, "adapter-exhaust/data-gateway")
+          full_path = File.join(gateway_dir, filename)
+
+          FileUtils.mkdir_p(gateway_dir)
+          File.write(full_path, gateway_template)
+
+          puts "✓ Created gateway: #{full_path}"
+          puts "Table name: #{@table_name}"
+          puts "Port Adapter: #{port_class_name}"
+          puts "Resource: #{source_class_name}"
+        end
+
+        private
+
+        def extract_table_name(gateway_name)
+          gateway_name.sub(/_(gateway)?$/, '')
+        end
+
+        def port_class_name
+          "#{@table_name.capitalize}GatewayPort"
+        end
+
+        def gateway_class_name
+          "Sequel#{@table_name.capitalize}Gateway"
+        end
+
+        def source_class_name
+          @table_name.end_with?('s') ? @table_name[0..-2].capitalize : @table_name.capitalize
+        end
+
+        def source_variable_name
+          @table_name.end_with?('s') ? @table_name[0..-2] : @table_name
+        end
+
+        def show_usage
+          puts "Usage: hyraft-rule data-gateway <gateway_name> [target_dir]"
+          puts ""
+          puts "Examples:"
+          puts "  hyraft-rule data-gateway articles"
+          puts "  hyraft-rule data-gateway users"
+          puts "  hyraft-rule data-gateway products"
+          puts ""
+          puts "This creates: adapter-exhaust/data-gateway/sequel_<name>_gateway.rb"
+        end
+
+        def gateway_template
+          port_name = port_class_name
+          gateway_name = gateway_class_name
+          source_name = source_class_name
+          source_var = source_variable_name
+          
+          <<~RUBY
+            require_root 'engine/port/#{@table_name}_gateway_port'
+            require_root 'engine/source/#{source_var}'
+            require_root 'infra/database/sequel_connection'
+
+            class #{gateway_name} < #{port_name}
+              def initialize
+                @db = SequelConnection.db
+                @#{@table_name} = @db[:#{@table_name}]
+              end
+
+              def save(#{source_var})
+                if #{source_var}.id && find(#{source_var}.id)
+                  @#{@table_name}.where(id: #{source_var}.id.to_i).update(
+                    # Add update fields here
+                    updated_at: Time.now
+                  )
+                else
+                  id = @#{@table_name}.insert(
+                    # Add insert fields here
+                    created_at: Time.now,
+                    updated_at: Time.now
+                  )
+                  #{source_var}.id = id.to_s
+                end
+                #{source_var}
+              end
+
+              def all
+                @#{@table_name}.order(Sequel.desc(:created_at)).all.map { |row| map_row_to_#{source_var}(row) }
+              end
+
+              def find(id)
+                row = @#{@table_name}.where(id: id.to_i).first
+                row && map_row_to_#{source_var}(row)
+              end
+
+              def delete(id)
+                @#{@table_name}.where(id: id.to_i).delete
+              end
+
+              private
+
+              def map_row_to_#{source_var}(row)
+                #{source_name}.new(
+                  id: row[:id].to_s,
+                  # Add entity attributes here
+                  created_at: row[:created_at],
+                  updated_at: row[:updated_at]
+                )
+              end
+            end
+          RUBY
+        end
+      end
+    end
+  end
+end

data/lib/hyraft/rule/adapter_request/remove_adapter_command.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+
+module Hyraft
+  module Rule
+    class RemoveAdapterCommand
+      def self.start(args)
+        new(args).execute
+      end
+
+      def initialize(args)
+        @adapter_input = args[0]  # "admin-app/users" or "api-app/products"
+        @target_dir = args[1] || "."
+        parse_adapter_input
+      end
+
+      def execute
+        return show_manifest unless @adapter_name
+
+        puts "\e[33m🗑️  Removing adapter: '#{@app_folder}/#{@adapter_name}'\e[0m"
+        
+        remove_adapter_only
+        
+        puts "\e[32m✅ Adapter removed: '#{@app_folder}/#{@adapter_name}'\e[0m"
+        puts "\e[36mNote: Engine layer and other adapters preserved\e[0m"
+      end
+
+      private
+
+      def parse_adapter_input
+        return unless @adapter_input
+
+        if @adapter_input.include?('/')
+          @app_folder, @adapter_name = @adapter_input.split('/', 2)
+        else
+          puts "❌ Error: Please specify app folder (e.g., admin-app/users)"
+          exit 1
+        end
+      end
+
+      def remove_adapter_only
+        # Only remove the specific web adapter
+        adapter_path = "adapter-intake/#{@app_folder}/request/#{@adapter_name.downcase}_web_adapter.rb"
+        delete_file(adapter_path)
+      end
+
+      def delete_file(relative_path)
+        full_path = File.join(@target_dir, relative_path)
+        if File.exist?(full_path)
+          File.delete(full_path)
+          puts "   ✓ Deleted: #{relative_path}"
+        else
+          puts "   ⚠️  Not found: #{relative_path}"
+        end
+      end
+
+      def show_manifest
+        puts "Hyraft Remove Adapter"
+        puts "Usage: hyraft-rule remove-adapter <folder>/<adapter_name> [target_dir]"
+        puts ""
+        puts "Examples:"
+        puts "  hyraft-rule remove-adapter admin-app/users"
+        puts "  hyraft-rule remove-adapter api-app/products"
+        puts "  hyraft-rule remove-adapter mobile-app/categories"
+        puts ""
+        puts "This command only removes the web adapter, preserving:"
+        puts "  • Engine layer (sources, circuits, ports)"
+        puts "  • Data gateway"
+        puts "  • Other app adapters"
+        puts ""
+        puts "Use 'hyraft-rule disassemble' to remove entire resource"
+      end
+    end
+  end
+end

data/lib/hyraft/rule/adapter_request/web_adapter_command.rb

@@ -0,0 +1,211 @@
+# lib/hyraft/rule/adapter_request/web_adapter_command.rb
+
+require 'fileutils'
+
+module Hyraft
+  module Rule
+    module AdapterRequest
+      class WebAdapterCommand
+        def self.start(args)
+          input = args[0]
+          return show_usage unless input
+
+          if input.include?('/')
+            folder_name, adapter_name = input.split('/', 2)
+          else
+            folder_name = "web-app"
+            adapter_name = input
+          end
+
+          target_dir = args[1] || "."
+          adapters_dir = File.join(target_dir, "adapter-intake", folder_name, "request")
+          full_path = File.join(adapters_dir, "#{adapter_name.downcase}_web_adapter.rb")
+
+          FileUtils.mkdir_p(adapters_dir)
+          File.write(full_path, web_adapter_template(adapter_name, folder_name))
+
+          puts "\e[94m✓ Created web adapter: #{full_path}\e[0m"
+          puts "\e[38;5;214mApp folder name: #{folder_name}, Adapter: #{adapter_name}\e[0m"
+        end
+
+        private
+
+        def self.show_usage
+          puts "Usage: hyraft-rule web-adapter [folder_name/]<AdapterName> [target_dir]"
+          puts ""
+          puts "Examples:"
+          puts "  hyraft-rule web-adapter Articles"
+          puts "  hyraft-rule web-adapter admin/Users"
+          puts "  hyraft-rule web-adapter api-app/Products"
+          puts "  hyraft-rule web-adapter mobile/Categories"
+          puts ""
+          puts "Default folder: web-app"
+        end
+
+        def self.web_adapter_template(adapter_name, folder_name = "web-app")
+          singular_name = adapter_name.downcase.chomp('s')
+          adapter_class_name = adapter_name.split('_').map(&:capitalize).join  # "articles" → "Articles"
+          plural_name = singular_name + 's'
+          circuit_name = "#{adapter_class_name}Circuit"
+          gateway_name = "Sequel#{adapter_class_name}Gateway"
+
+          <<~RUBY
+require_root 'engine/circuit/#{plural_name}_circuit'
+require_root 'adapter-exhaust/data-gateway/sequel_#{plural_name}_gateway'
+
+class #{adapter_class_name}WebAdapter
+  def initialize
+    gateway = #{gateway_name}.new
+    @#{plural_name} = #{circuit_name}.new(gateway)
+  end
+
+  # GET /#{plural_name}
+  def index(request)
+    #{plural_name} = @#{plural_name}.list || []
+    
+    {
+      status: 200,
+      locals: { 
+        #{plural_name}: #{plural_name}
+      },
+      display: 'pages/#{plural_name}/index.hyr'
+    }
+  end
+
+  # GET /#{plural_name}/:id
+  def show(request)
+    id = request.params['route_params'].first
+    #{singular_name} = @#{plural_name}.find(id)
+
+    if #{singular_name}
+      {
+        status: 200,
+        locals: { 
+          #{singular_name}: #{singular_name}
+        },
+        display: 'pages/#{plural_name}/show.hyr'
+      }
+    else
+      not_found_response(request)
+    end
+  end
+
+  # GET /#{plural_name}/new - Show create form
+  def new(request)
+    {
+      status: 200,
+      locals: {},
+      display: 'pages/#{plural_name}/new.hyr'
+    }
+  end
+
+  # POST /#{plural_name} - Create #{singular_name}
+  def create(request)
+    data = request.params['data'] || {}
+    
+    # TODO: Add validation for required fields
+    # Example:
+    # if data['title'] && data['content']
+    #   article = @articles.create(
+    #     title: data['title'],
+    #     content: data['content']
+    #   )
+    #   
+    #   {
+    #     status: 303,
+    #     headers: { 'Location' => "/articles" },
+    #     locals: {}
+    #   }
+    # else
+    #   {
+    #     status: 422,
+    #     locals: { 
+    #       error: "Title and content are required"
+    #     },
+    #     display: 'pages/articles/new.hyr'
+    #   }
+    # end
+    
+  end
+
+  # GET /#{plural_name}/:id/edit - Show edit form
+  def edit(request)
+    id = request.params['route_params'].first
+    #{singular_name} = @#{plural_name}.find(id)
+    
+    if #{singular_name}
+      {
+        status: 200,
+        locals: { 
+          #{singular_name}: #{singular_name}
+        },
+        display: 'pages/#{plural_name}/edit.hyr'
+      }
+    else
+      not_found_response(request)
+    end
+  end
+
+  # PUT /#{plural_name}/:id - Update #{singular_name}
+  def update(request)
+    id = request.params['route_params'].first
+    data = request.params['data'] || {}
+    
+    # TODO: Implement update logic
+    # Example:
+    # updated_#{singular_name} = @#{plural_name}.update(
+    #   id: id,
+    #   title: data['title'],
+    #   content: data['content']
+    # )
+    
+    if updated_#{singular_name}
+      {
+        status: 303,
+        headers: { 'Location' => "/#{plural_name}" },
+        locals: {}
+      }
+    else
+      {
+        status: 422,
+        locals: { 
+          #{singular_name}: @#{plural_name}.find(id),
+          error: "Failed to update #{singular_name}" 
+        },
+        display: 'pages/#{plural_name}/edit.hyr'
+      }
+    end
+  end
+
+  # DELETE /#{plural_name}/:id - Delete #{singular_name}
+  def delete(request)
+    id = request.params['route_params'].first
+    @#{plural_name}.delete(id)
+    
+    {
+      status: 303,
+      headers: { 'Location' => "/#{plural_name}" },
+      locals: {}
+    }
+  end
+
+  private
+
+  def not_found_response(request)
+    {
+      status: 404,
+      locals: { 
+        error: "#{singular_name.capitalize} not found",
+        back_url: '/#{plural_name}',  
+        back_text: 'Back to #{adapter_name}'  
+      },
+      display: 'pages/#{plural_name}/404.hyr'
+    }
+  end
+end
+          RUBY
+        end
+      end
+    end
+  end
+end

data/lib/hyraft/rule/assemble_command.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+
+module Hyraft
+  module Rule
+    class AssembleCommand
+      def self.start(args)
+        new(args).execute
+      end
+
+      def initialize(args)
+        @resource_input = args[0]  # Can be "users" or "admin-app/users"
+        @target_dir = args[1] || "."
+        parse_resource_input
+      end
+
+      def execute
+        return show_manifest unless @resource_name
+
+        puts "\e[35m🔧 Hyraft Assembly: Assembling '#{@resource_name}' resource\e[0m"
+        puts "\e[36mApp Folder: #{@app_folder}\e[0m" if @app_folder != "web-app"
+        
+        assemble_engine_layer  
+        assemble_adapter_layer
+        
+        puts "\e[32m✅ Assembly Complete: '#{@resource_name}' resource assembled\e[0m"
+        puts "\e[36mNext steps:\e[0m"
+        puts "  ⚡ Implement business logic in circuits" 
+        puts "  🌐 Connect web adapters to router"
+        puts "  📊 Create database table manually"
+      end
+
+      private
+
+      def parse_resource_input
+        return unless @resource_input
+
+        if @resource_input.include?('/')
+          @app_folder, @resource_name = @resource_input.split('/', 2)
+        else
+          @app_folder = "web-app"
+          @resource_name = @resource_input
+        end
+      end
+
+      def assemble_engine_layer
+        puts "\e[34m⚡ Assembling Engine Layer...\e[0m"
+        
+        # Check if engine files already exist
+        singular_name = @resource_name.end_with?('s') ? @resource_name[0..-2].capitalize : @resource_name.capitalize
+        source_path = File.join(@target_dir, "engine/source/#{singular_name.downcase}.rb")
+        circuit_path = File.join(@target_dir, "engine/circuit/#{@resource_name.downcase}_circuit.rb")
+        port_path = File.join(@target_dir, "engine/port/#{@resource_name.downcase}_gateway_port.rb")
+        
+        if File.exist?(source_path) || File.exist?(circuit_path) || File.exist?(port_path)
+          puts "   ⚠️  Engine files already exist - skipping engine layer"
+          return
+        end
+        
+        # Pass singular name for source, plural for others
+        SourceCommand.start([singular_name, @target_dir])
+        CircuitCommand.start(["#{@resource_name.capitalize}Circuit", @target_dir])
+        PortCommand.start(["#{@resource_name.capitalize}GatewayPort", @target_dir])
+      end
+
+      def assemble_adapter_layer
+        puts "\e[34m🔌 Assembling Adapter Layer...\e[0m"
+        # Pass folder/resource format to web adapter command
+        AdapterRequest::WebAdapterCommand.start(["#{@app_folder}/#{@resource_name}", @target_dir])
+        AdapterExhaust::DataGatewayCommand.start([@resource_name, @target_dir])
+
+        # Generate templates as well
+        puts "\e[34m📝 Generating Templates...\e[0m"
+        TemplateCommand.start(["#{@app_folder}/#{@resource_name}", @target_dir])
+
+      end
+
+      def show_manifest
+        puts "Hyraft Assembly Manifest"
+        puts "Usage: hyraft-rule assemble [folder/]<resource_name> [target_dir]"
+        puts ""
+        puts "Examples:"
+        puts "  hyraft-rule assemble articles                    # Default: web-app/articles"
+        puts "  hyraft-rule assemble users                       # Default: web-app/users"
+        puts "  hyraft-rule assemble admin-app/users             # Creates: admin-app/users"
+        puts "  hyraft-rule assemble api/products                # Creates: api/products"
+        puts "  hyraft-rule assemble mobile/categories           # Creates: mobile/categories"
+        puts ""
+        puts "Assembly Components:"
+        puts "  ⚡ Engine Layer → Sources + Circuits + Ports"
+        puts "  🔌 Adapter Layer → Web Adapters + Data Gateways"
+        puts ""
+        puts "Note: Database migrations must be created separately"
+      end
+    end
+  end
+end

data/lib/hyraft/rule/command.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Hyraft
+  module Rule
+    class Command
+      def self.start(argv)
+        new(argv).execute
+      end
+
+      def initialize(argv)
+        @argv = argv
+        @command = argv[0]
+        @args = argv[1..-1]
+      end
+
+      def execute
+        case @command
+        when "migrate"
+          MigrationCommand.start(@args)
+        when "source"
+          SourceCommand.start(@args)
+        when "circuit"
+          CircuitCommand.start(@args)
+        when "port"
+          PortCommand.start(@args)
+        when "web-adapter"
+          AdapterRequest::WebAdapterCommand.start(@args)
+        when "data-gateway"
+          AdapterExhaust::DataGatewayCommand.start(@args)
+        when "assemble"
+          AssembleCommand.start(@args)
+        when "disassemble"  
+          DisassembleCommand.start(@args)
+        when "template" 
+          TemplateCommand.start(@args)
+        when "remove-adapter", "rm-adapter"
+          require 'hyraft/rule/adapter_request/remove_adapter_command'
+          RemoveAdapterCommand.start(@args)
+        when "version", "-v", "--version"
+          puts "Hyraft Rule version #{VERSION}"
+        when "help", "-h", "h", "--help", nil
+          show_help
+        else
+          puts "Unknown command: #{@command}"
+          show_help
+        end
+      end
+
+      private
+
+      def show_help
+        puts "Hyraft Rule - Command System for Hyraft Applications"
+        puts ""
+        puts "Commands:"
+        puts "  source           Generate source files"
+        puts "  circuit          Generate circuit files"
+        puts "  port             Generate port files"
+        puts "  web-adapter      Generate web adapter files"
+        puts "  data-gateway     Generate data gateway files"
+        puts "  template         Generate .hyr template files"
+        puts "  assemble         Assemble Engine + Adapters for a resource"
+        puts "  disassemble      Remove assembled Engine + Adapters for a resource"
+        puts "  remove-adapter   Remove specific adapter only (preserves engine)"
+        puts "  version          Show version information"
+        puts "  help             Show this help message"
+        puts ""
+        puts "Run 'hyr-rule <command>"
+        puts "Run 'hyraft-rule <command>"
+        puts ""
+        puts ""
+        puts "Database Commands:"
+        puts "Run 'hyr-rule-db <command>"
+        puts "Run 'hyraft-rule-db <command>"
+        puts ""
+        puts ""
+      end
+    end
+  end
+end