meta_workflows 0.8.24 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba1784b378c470dc10b2f863925448fa1990867e7c922e3fcdac70cf5a7225a9
-  data.tar.gz: d79449ffdd2dd4fa309d4cda8b510f49f10a697729e0491c64097aa087af672d
+  metadata.gz: 50ae604291373e74675fbac7838bb9cbbdcef8beb635a07ac40f06c89f784a75
+  data.tar.gz: cefff5fe7d2a949941dee57e2a642e7eb54d2eaec220a489e252799fb8888f1c
 SHA512:
-  metadata.gz: 43105946578bb6897d6c07762cf4af0ec9456c2d9ac839645c39592fb814d2b7ca44f913b60038c0d43e359d8f5acb876dbaa87f581890d9d0b636d0aec51d05
-  data.tar.gz: 5bc47a299ef97e9a73a3425fcbde25a6c079a026803b92f706b6bbafe7a8e066cc4c29c8034f6c6af4b40990fa2908019a07ef82ac596c6c0dffc525cc70cc5e
+  metadata.gz: ec4974b30bfe8c3c17fbd779228e2bdf469ba86fd808fcfdfa792b4bad5419591e919d23570a42c70aedc06c68021321174a33d91faaf1b935eced1aa5504072
+  data.tar.gz: 940604b1494c067ead7d9dbf6da6be88b10538e59bba4551e90a575ac070ff6fe882134a170e0f1d4f2045d2a9cffb75a3116fc010d3591361bbd74666e4efb5

data/README.md

@@ -518,13 +518,44 @@ For development contributions:
 
 For detailed information about the MetaWorkflows system:
 - [Setup Guide](https://strongmind.atlassian.net/wiki/spaces/MW/pages/3929833507) - Configuration and workflow setup
-- [File Structure Guide](https://strongmind.atlassian.net/wiki/spaces/MW/pages/3930521627) - Complete file organization reference
-- [Dummy App Guide](https://strongmind.atlassian.net/wiki/spaces/MW/pages/3941072927) - Test application documentation
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
+## Styling Setup
+
+To apply or customize the styles for the `meta_workflows` engine, follow these steps:
+
+### 1. Where to Add Your Styles
+
+- All styles should be placed in this file:  
+  `app/assets/stylesheets/meta_workflows/application.css`
+
+### 2. How to Copy the Stylesheet
+
+- To bring the stylesheet into your app (host app or dummy app), run this command from your terminal:
+
+  ```bash
+  rails meta_workflows:install:assets
+  ```
+
+### 3.  Location in Dummy App
+
+- If you're using the dummy app (located at `spec/dummy`), the stylesheet will be copied to:
+`spec/dummy/app/assets/stylesheets/meta_workflows/application.css`.
+
+### 4. ⚠️ Important Note
+
+- Do not edit the copied stylesheet in the dummy app (spec/dummy/...) directly.
+- Changes made there will not carry over to the host app and will be overwritten if you re-run the install:assets task.
+
+### 5. Avoid Using Tailwind's Custom Properties
+
+- **Do not use Tailwind’s custom properties (CSS variables)** in your styles.
+- These properties **won’t be compiled** because the layout files are accessed directly from the engine.
+- As a result, the host app doesn’t recognize that it needs to compile them, and the styles will not work as expected.
+
 ## Tray System (Sidebar, Bottom, and Main Content Trays)
 
 MetaWorkflows provides a flexible tray system for building modern, multi-pane layouts. The tray system supports left (Beta), right (Gamma), and bottom (Delta) trays, as well as a main content area (Alpha). Each tray can be shown, hidden, or made collapsible on a per-controller or per-page basis.

data/app/assets/stylesheets/meta_workflows/application.css

@@ -1,165 +1,200 @@
-/* AI Generated Content */
+/* Meta Workflows Styles Installed in Main App */
 .meta-workflows.chat {
-    display: flex;
-    flex-direction: column;
-    gap: 1.5rem;
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  color: var(--slate-800);
+  font-size: 1.125rem;
+  line-height: 1.75;
+
+  h1 {
+    color: var(--slate-800);
+    font-weight: 600;
+    margin-bottom: 0.5rem;
+    font-size: 1.875rem;
+    line-height: 1.25;
+  }
+
+  h2 {
     color: var(--slate-800);
+    font-weight: 600;
+    margin-bottom: 0.5rem;
+    font-size: 1.5rem;
+    line-height: 1.25;
+  }
+
+  h3 {
+    color: var(--slate-800);
+    font-weight: 600;
+    margin-bottom: 0.5rem;
+    font-size: 1.25rem;
+    line-height: 1.25;
+  }
+
+  h4 {
+    color: var(--slate-800);
+    font-weight: 600;
+    margin-bottom: 0.5rem;
     font-size: 1.125rem;
-    line-height: 1.75;
-  
-    h1 {
-      color: var(--slate-800);
-      font-weight: 600;
-      margin-bottom: 0.5rem;
-      font-size: 1.875rem;
-      line-height: 1.25;
-    }
-  
-    h2 {
-      color: var(--slate-800);
-      font-weight: 600;
-      margin-bottom: 0.5rem;
-      font-size: 1.5rem;
-      line-height: 1.25;
-    }
-  
-    h3 {
-      color: var(--slate-800);
-      font-weight: 600;
-      margin-bottom: 0.5rem;
+    line-height: 1.25;
+  }
+
+  h5 {
+    color: var(--slate-800);
+    font-weight: 600;
+    margin-bottom: 0.5rem;
+    font-size: 1rem;
+    line-height: 1.25;
+  }
+
+  h6 {
+    color: var(--slate-800);
+    font-weight: 600;
+    margin-bottom: 0.5rem;
+    font-size: 0.875rem;
+    line-height: 1.25;
+  }
+
+  /* combined list styles */
+  ul,
+  ol {
+    display: flex;
+    flex-direction: column;
+    gap: .5rem;
+    padding-left: 0;
+    list-style-type: none;
+
+    li {
+      display: flex;
+      padding: 1rem 1.375rem;
+      border: 1px solid var(--slate-300);
+      border-radius: 0.875rem;
+      background-color: white;
       font-size: 1.25rem;
-      line-height: 1.25;
-    }
-  
-    h4 {
-      color: var(--slate-800);
-      font-weight: 600;
-      margin-bottom: 0.5rem;
-      font-size: 1.125rem;
-      line-height: 1.25;
-    }
-  
-    h5 {
-      color: var(--slate-800);
-      font-weight: 600;
-      margin-bottom: 0.5rem;
-      font-size: 1rem;
-      line-height: 1.25;
-    }
-  
-    h6 {
-      color: var(--slate-800);
       font-weight: 600;
-      margin-bottom: 0.5rem;
-      font-size: 0.875rem;
-      line-height: 1.25;
-    }
-  
-    /* Combined list styles */
-    ul,
-    ol {
-      display: flex;
-      flex-direction: column;
-      gap: .5rem;
-      padding-left: 0;
-      list-style-type: none;
-  
-      li {
-        display: flex;
-        padding: 1rem 1.375rem;
-        border: 1px solid var(--slate-300);
-        border-radius: 0.875rem;
-        background-color: white;
-        font-size: 1.25rem;
-        font-weight: 600;
-        line-height: 1.375;
-  
-        &::before {
-          display: none;
-        }
-      }
-    }
-  
-    /* Ordered list specific styles */
-    ol {
-      counter-reset: list-counter;
-  
-      li::before {
-        content: counter(list-counter) ".";
-        counter-increment: list-counter;
-        display: inline-block;
-        width: 1.5em;
-        margin-right: 0.5em;
-        color: var(--slate-400);
-      }
-    }
-  
-    a {
-      color: #2563eb;
-      text-decoration: underline;
-  
-      &:hover {
-        color: #1d4ed8;
+      line-height: 1.375;
+
+      &::before {
+        display: none;
       }
     }
-  
-    pre {
-      background-color: #f9fafb;
-      padding: 1rem;
-      border-radius: 0.5rem;
-      overflow-x: auto;
-      margin: 1rem 0;
-    }
-  
-    code {
-      background-color: #f9fafb;
-      padding: 0.125rem 0.375rem;
-      border-radius: 0.25rem;
-      font-size: 0.875rem;
-      font-family: ui-monospace, monospace;
-    }
-  
-    blockquote {
-      border-left: 4px solid #e5e7eb;
-      padding-left: 1rem;
-      font-style: italic;
-      color: #374151;
-      margin: 1rem 0;
-    }
-  
-    table {
-      width: 100%;
-      border-collapse: collapse;
-      margin: 1rem 0;
-    }
-  
-    th,
-    td {
-      border: 1px solid #e5e7eb;
-      padding: 0.5rem;
-      text-align: left;
-    }
-  
-    th {
-      background-color: #f9fafb;
-      font-weight: 600;
-    }
-  
-    img {
-      border-radius: 0.5rem;
-      margin: 1rem 0;
-    }
-  
-    strong {
-      font-weight: 600;
-      color: var(--slate-800);
+  }
+
+  /* ordered list specific styles */
+  ol {
+    counter-reset: list-counter;
+
+    li::before {
+      content: counter(list-counter) ".";
+      counter-increment: list-counter;
+      display: inline-block;
+      width: 1.5em;
+      margin-right: 0.5em;
+      color: var(--slate-400);
     }
-  
-    em {
-      font-style: italic;
+  }
+
+  a {
+    color: #2563eb;
+    text-decoration: underline;
+
+    &:hover {
+      color: #1d4ed8;
     }
   }
 
+  pre {
+    background-color: #f9fafb;
+    padding: 1rem;
+    border-radius: 0.5rem;
+    overflow-x: auto;
+    margin: 1rem 0;
+  }
+
+  code {
+    background-color: #f9fafb;
+    padding: 0.125rem 0.375rem;
+    border-radius: 0.25rem;
+    font-size: 0.875rem;
+    font-family: ui-monospace, monospace;
+  }
+
+  blockquote {
+    border-left: 4px solid #e5e7eb;
+    padding-left: 1rem;
+    font-style: italic;
+    color: #374151;
+    margin: 1rem 0;
+  }
+
+  table {
+    width: 100%;
+    border-collapse: collapse;
+    margin: 1rem 0;
+  }
+
+  th,
+  td {
+    border: 1px solid #e5e7eb;
+    padding: 0.5rem;
+    text-align: left;
+  }
+
+  th {
+    background-color: #f9fafb;
+    font-weight: 600;
+  }
+
+  img {
+    border-radius: 0.5rem;
+    margin: 1rem 0;
+  }
+
+  strong {
+    font-weight: 600;
+    color: var(--slate-800);
+  }
+
+  em {
+    font-style: italic;
+  }
+}
+
+
+/* Lexi Chat Component Heights */
+.lexi-chat-container {
+  height: 95vh;
+}
+
+.lexi-chat-container-full {
+  height: 100vh;
+}
+
+.lexi-avatar-large {
+  height: 375px;
+}
+
+.lexi-avatar-medium {
+  height: 300px;
+}
+
+.lexi-input-container {
+  height: 335px;
+}
+
+/* Lexi Chat Component Constraints */
+.lexi-input-max-height {
+  max-height: 200px;
+}
+
+.lexi-textarea-min-height {
+  min-height: 35px;
+}
+
+.lexi-message-max-width {
+  max-width: 80%;
+}
+
 /* Tray Animations */
 .tray-container {
   transition: all 500ms ease-in-out;
@@ -212,7 +247,58 @@
 
 /* Common content transitions */
 .tray-content {
-  transition: opacity 500ms ease-in-out, transform 500ms ease-in-out;
+  transition: opacity 300ms ease-in-out, transform 500ms ease-in-out;
   opacity: 1;
   transform: translate(0);
-}
+}
+
+/* Lexi Tray Overrides */
+.gamma-tray.lexi-tray.collapsed {
+  width: 0px; /* Completely hide the tray */
+  border: none; /* Remove border when collapsed */
+  overflow: visible; /* Allow avatar to show outside tray bounds */
+}
+
+.gamma-tray.lexi-tray.collapsed .tray-content {
+  opacity: 0;
+  transform: translateX(-1rem);
+  pointer-events: none;
+}
+
+/* Fast fade out when collapsing */
+.gamma-tray.lexi-tray.collapsed .tray-content {
+  transition: opacity 200ms ease-in-out, transform 500ms ease-in-out;
+}
+
+/* Delayed fade in when expanding - wait for width animation to mostly complete */
+.gamma-tray.lexi-tray:not(.collapsed) .tray-content {
+  transition: opacity 200ms ease-in-out 300ms, transform 500ms ease-in-out;
+}
+
+/* Hide standard collapse button when Lexi tray is collapsed */
+.gamma-tray.lexi-tray.collapsed > button[data-action="click->tray#toggle"]:not(.lexi-floating-avatar) {
+  display: none;
+}
+
+/* Show floating Lexi avatar button when collapsed - with delay to avoid overlap */
+.gamma-tray.lexi-tray.collapsed .lexi-floating-avatar {
+  display: block !important;
+  opacity: 0;
+  animation: lexi-avatar-appear 200ms ease-in-out 400ms forwards;
+}
+
+@keyframes lexi-avatar-appear {
+  from {
+    opacity: 0;
+    transform: scale(0.8);
+  }
+  to {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+/* Hide floating avatar when tray is expanded */
+.gamma-tray.lexi-tray:not(.collapsed) .lexi-floating-avatar {
+  display: none !important;
+}

data/app/controllers/meta_workflows/base_debug_controller.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  class BaseDebugController < MetaWorkflows::ApplicationController
+    include MetaWorkflows::DebugHelper
+
+    layout 'meta_workflows/application'
+
+    # Apply authentication only in production environment
+    before_action :authenticate_with_basic_auth, if: :production_environment?
+
+    # Skip CSRF protection for this debug interface
+    skip_before_action :verify_authenticity_token
+
+    protected
+
+    def authenticate_with_basic_auth
+      return unless production_environment?
+      return unless authentication_required?
+
+      authenticate_or_request_with_http_basic do |username, password|
+        username == ENV.fetch('SIDEKIQ_USER', nil) &&
+          password == ENV.fetch('SIDEKIQ_PASSWORD', nil)
+      end
+    end
+
+    private
+
+    def production_environment?
+      Rails.env.production?
+    end
+
+    def authentication_required?
+      ENV['SIDEKIQ_USER'].present? && ENV['SIDEKIQ_PASSWORD'].present?
+    end
+
+    def paginate_collection(collection)
+      # Use Kaminari if available, otherwise limit to 25 records
+      if defined?(Kaminari) && collection.respond_to?(:page)
+        collection.page(params[:page]).per(25)
+      else
+        collection.limit(25).offset(((params[:page]&.to_i || 1) - 1) * 25)
+      end
+    end
+  end
+end

data/app/controllers/meta_workflows/debug_controller.rb

@@ -1,17 +1,7 @@
 # frozen_string_literal: true
 
 module MetaWorkflows
-  class DebugController < MetaWorkflows::ApplicationController
-    include MetaWorkflows::DebugHelper
-
-    layout 'meta_workflows/debug'
-
-    # Apply authentication only in production environment
-    before_action :authenticate_with_basic_auth, if: :production_environment?
-
-    # Skip CSRF protection for this debug interface
-    skip_before_action :verify_authenticity_token
-
+  class DebugController < MetaWorkflows::BaseDebugController
     def index
       redirect_to workflows_path
     end
@@ -66,36 +56,5 @@ module MetaWorkflows
         format.html { redirect_to execution_path(@execution), alert: t('meta_workflows.export_only_json') }
       end
     end
-
-    protected
-
-    def authenticate_with_basic_auth
-      return unless production_environment?
-      return unless authentication_required?
-
-      authenticate_or_request_with_http_basic do |username, password|
-        username == ENV.fetch('SIDEKIQ_USER', nil) &&
-          password == ENV.fetch('SIDEKIQ_PASSWORD', nil)
-      end
-    end
-
-    private
-
-    def production_environment?
-      Rails.env.production?
-    end
-
-    def authentication_required?
-      ENV['SIDEKIQ_USER'].present? && ENV['SIDEKIQ_PASSWORD'].present?
-    end
-
-    def paginate_collection(collection)
-      # Use Kaminari if available, otherwise limit to 25 records
-      if defined?(Kaminari) && collection.respond_to?(:page)
-        collection.page(params[:page]).per(25)
-      else
-        collection.limit(25).offset(((params[:page]&.to_i || 1) - 1) * 25)
-      end
-    end
   end
 end

data/app/controllers/meta_workflows/workflow_imports_controller.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  class WorkflowImportsController < MetaWorkflows::BaseDebugController
+    def new
+      # Show the import form
+    end
+
+    def create
+      result = perform_import
+      return unless result
+
+      handle_import_result(result)
+    end
+
+    def bulk
+      import_service = MetaWorkflows::WorkflowImportService.new
+      result = import_service.import_from_directory
+
+      if result.success?
+        data = result.data
+        flash[:notice] = data[:message]
+      else
+        flash[:alert] = result.error
+      end
+
+      redirect_to workflows_path
+    end
+
+    private
+
+    def perform_import
+      import_service = MetaWorkflows::WorkflowImportService.new
+
+      case params[:import_type]
+      when 'file'
+        handle_file_import(import_service)
+      when 'text'
+        handle_text_import(import_service)
+      when 'directory'
+        import_service.import_from_directory
+      else
+        flash[:alert] = 'Please provide either a file, YAML text, or select directory import'
+        render :new
+        nil
+      end
+    end
+
+    def handle_file_import(import_service)
+      if params[:workflow_file].present?
+        import_service.import_from_file(params[:workflow_file])
+      else
+        flash[:alert] = 'Please provide either a file, YAML text, or select directory import'
+        render :new
+        nil
+      end
+    end
+
+    def handle_text_import(import_service)
+      if params[:workflow_name].present? && params[:yaml_content].present?
+        import_service.import_from_yaml_text(params[:workflow_name], params[:yaml_content])
+      else
+        flash[:alert] = 'Please provide either a file, YAML text, or select directory import'
+        render :new
+        nil
+      end
+    end
+
+    def handle_import_result(result)
+      if result.success?
+        import_result = result.data
+        flash[:notice] = success_message(import_result)
+        redirect_to workflows_path
+      else
+        flash[:alert] = result.error
+        render :new
+      end
+    end
+
+    def success_message(import_result)
+      action = import_result[:action] == 'created' ? 'imported' : 'updated'
+      "Workflow '#{import_result[:workflow_name]}' #{action} successfully!"
+    end
+  end
+end

data/app/services/meta_workflows/application_service.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  class ApplicationService
+    def self.call(...)
+      new(...).call
+    end
+
+    protected
+
+    def success(data = nil)
+      ServiceResult.new(success: true, data: data)
+    end
+
+    def failure(error = nil)
+      ServiceResult.new(success: false, error: error)
+    end
+  end
+
+  # Simple result object for service responses
+  class ServiceResult
+    attr_reader :data, :error
+
+    def initialize(success:, data: nil, error: nil)
+      @success = success
+      @data = data
+      @error = error
+    end
+
+    def success?
+      @success
+    end
+
+    def failure?
+      !@success
+    end
+  end
+end