meta_workflows 0.7.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afd80be43cbf526411e03bbf7ced8c539b12d81e82d19b2e805dc2a85045aa83
-  data.tar.gz: 4ce850bc8e751d2271ea049724bce5ddbf82d55b9d83749e7d06cfb1d0aebb2c
+  metadata.gz: 40e3769944f241f922ada44ee68481751bd2becd8c287972522c179d7dbe2696
+  data.tar.gz: 45f4723223484bd4a5fd6fd2eedfdb4da12044b2986ac3facf2bf10df62c8671
 SHA512:
-  metadata.gz: 4fda18b86bf518cfbace011470987b8aa6fb7d1ebbfbb8e95933498736a6792b9c90183a8e820a2868ed8a34dab8cb0a32e194f054315d6bfbbdd4f6c067feb6
-  data.tar.gz: 45148c5baac802a9c4c330206724b4e8a867df7886a2fc984b9f5b5854a14d926336492c88c0e0f718f84a3d0b8973373f682eaf20d628929dd03d7bc4c5a9ee
+  metadata.gz: f36ae90ac276a1777b229d30bff8a77d4e216dc68b5b8ae7d2c407bc6692c25b1f2a5823e2607ef3825f579751bc8c8fb28874cc9f62c26fa4c209beadc7de0c
+  data.tar.gz: 9f17625cd21f52316b04923c87e6e7edf7ca1d651bbb7ce7b4dcce53f9e2e5b6cb67ce3acb7a40f747abf9cb46727e3a34f0f040f1075aa4b79dfbdd717c6116

data/README.md

@@ -112,6 +112,34 @@ Or install it yourself as:
 gem install meta_workflows
 ```
 
+## Git Hooks with Overcommit
+
+This project uses Overcommit to manage Git hooks. The hooks are configured to run various code quality and security checks before commits and pushes:
+
+- **Pre-commit**:
+    - RuboCop: Checks for code style violations
+    
+- **Pre-push**:
+    - RuboCop: Performs a more thorough code style check
+    - BundleAudit: Scans for vulnerable gems
+    - Brakeman: Scans for security vulnerabilities
+
+To set up the git hooks, run:
+
+```shell
+bundle install
+bundle exec rake app:git:setup_hooks
+```
+
+If you need to bypass the hooks temporarily, you can use:
+
+```shell
+git commit --no-verify
+git push --no-verify
+```
+
+> **Note:** While bypassing hooks can be useful in specific scenarios, we recommend fixing issues rather than bypassing checks regularly.
+
 ## Setup
 
 ### 1. Database Setup
@@ -496,3 +524,72 @@ For detailed information about the MetaWorkflows system:
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## 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.
+
+### Tray Placement Overview
+
+| Tray  | Placement      | Description                                 |
+|:-----:|:--------------|:--------------------------------------------|
+| Beta  | Left sidebar   | Optional collapsible sidebar on the left    |
+| Alpha | Center/main    | Main content area (always visible)          |
+| Gamma | Right sidebar  | Optional collapsible sidebar on the right   |
+| Delta | Bottom tray    | Optional collapsible tray at the bottom     |
+
+### How It Works
+- The tray system is controlled by a `TrayConfigurable` concern included in your controllers.
+- By default, all trays are hidden. You must explicitly set `visible: true` for any tray you want to show.
+- The engine's layout will automatically respect your tray configuration.
+
+### Enabling and Configuring Trays
+
+1. **Include the Concern in Your ApplicationController:**
+
+   ```ruby
+   class ApplicationController < ActionController::Base
+     include TrayConfigurable
+     before_action :configure_trays
+   end
+   ```
+
+2. **Override Tray Settings in Any Controller:**
+
+   ```ruby
+   class PostsController < ApplicationController
+     def configure_trays
+       super
+       tray_config[:beta][:visible] = true      # Show Beta (left) tray
+       tray_config[:gamma][:visible] = false    # Hide Gamma (right) tray
+       tray_config[:delta][:collapsible] = false # Make Delta (bottom) tray not collapsible
+     end
+   end
+   ```
+
+3. **Default Behavior:**
+   - All trays are hidden unless set to `visible: true`.
+   - Trays are collapsible by default; set `collapsible: false` to disable collapsing.
+
+4. **Layout:**
+   - The engine's layout (`app/views/layouts/meta_workflows/application.html.erb`) will automatically render trays based on your configuration.
+
+### Example: Show Only the Left Tray
+
+```ruby
+class DashboardController < ApplicationController
+  def configure_trays
+    super
+    tray_config[:beta][:visible] = true
+    tray_config[:gamma][:visible] = false
+    tray_config[:delta][:visible] = false
+  end
+end
+```
+
+### Notes
+- The tray system is available in both the engine and the dummy app for development/testing.
+- You can override tray configuration per controller or per action as needed.
+- The main content area (Alpha tray) is always visible and holds your page content.
+
+For more advanced usage or to contribute improvements, see the tray logic in `TrayConfigurable` and the engine layout file.

data/app/assets/javascripts/meta_workflows/controllers/tray_controller.js

@@ -0,0 +1,109 @@
+import { Controller } from "@hotwired/stimulus"
+
+function getCookie(name) {
+  const value = `; ${document.cookie}`;
+  const parts = value.split(`; ${name}=`);
+  if (parts.length !== 2) return null;
+  return parts.pop().split(';').shift();
+}
+
+function setCookie(name, value) {
+  document.cookie = `${name}=${value}; path=/; max-age=31536000`;
+}
+
+function chevronDirection(tray, expanded) {
+  if (tray === "beta") return expanded ? "fa-chevron-left" : "fa-chevron-right";
+  if (tray === "gamma") return expanded ? "fa-chevron-right" : "fa-chevron-left";
+  if (tray === "delta") return expanded ? "fa-chevron-down" : "fa-chevron-up";
+  return "";
+}
+
+export default class extends Controller {
+  static values = { name: String }
+  static targets = ["content", "chevron"]
+
+  connect() {
+    // Load state from cookies
+    const savedState = getCookie(`tray_${this.nameValue}`);
+    if (savedState === "collapsed") {
+      this.expanded = false;
+    } else {
+      this.expanded = true;
+    }
+    this.updateTray();
+    // Set chevron direction from cookie if present
+    const chevron = this.hasChevronTarget ? this.chevronTarget : null;
+    if (chevron) {
+      const chevronCookie = getCookie(`chevron_${this.nameValue}`);
+      if (chevronCookie) {
+        chevron.classList.remove("fa-chevron-left", "fa-chevron-right", "fa-chevron-up", "fa-chevron-down");
+        chevron.classList.add(chevronCookie);
+      }
+    }
+  }
+
+  toggle() {
+    this.expanded = !this.expanded;
+    // Save state to cookies
+    setCookie(`tray_${this.nameValue}`, this.expanded ? "expanded" : "collapsed");
+    // Save chevron direction to cookies
+    setCookie(`chevron_${this.nameValue}`, chevronDirection(this.nameValue, this.expanded));
+    this.updateTray();
+  }
+
+  updateTray() {
+    // Only update chevron if it exists (tray is collapsible)
+    const hasChevron = this.hasChevronTarget;
+    if (this.nameValue === "delta") {
+      if (this.expanded) {
+        this.element.classList.remove("collapsed");
+        this.element.classList.add("h-[200px]");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-up");
+          this.chevronTarget.classList.add("fa-chevron-down");
+        }
+      } else {
+        this.element.classList.remove("h-[200px]");
+        this.element.classList.add("collapsed");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-down");
+          this.chevronTarget.classList.add("fa-chevron-up");
+        }
+      }
+    } else if (this.nameValue === "beta") {
+      // Beta: open=left, collapsed=right
+      if (this.expanded) {
+        this.element.classList.remove("collapsed");
+        this.element.classList.add("w-[300px]");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-right");
+          this.chevronTarget.classList.add("fa-chevron-left");
+        }
+      } else {
+        this.element.classList.remove("w-[300px]");
+        this.element.classList.add("collapsed");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-left");
+          this.chevronTarget.classList.add("fa-chevron-right");
+        }
+      }
+    } else if (this.nameValue === "gamma") {
+      // Gamma: open=right, collapsed=left
+      if (this.expanded) {
+        this.element.classList.remove("collapsed");
+        this.element.classList.add("w-[300px]");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-left");
+          this.chevronTarget.classList.add("fa-chevron-right");
+        }
+      } else {
+        this.element.classList.remove("w-[300px]");
+        this.element.classList.add("collapsed");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-right");
+          this.chevronTarget.classList.add("fa-chevron-left");
+        }
+      }
+    }
+  }
+} 

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

@@ -158,4 +158,61 @@
     em {
       font-style: italic;
     }
-  }
+  }
+
+/* Tray Animations */
+.tray-container {
+  transition: all 500ms ease-in-out;
+}
+
+/* Beta Tray (Left) */
+.beta-tray {
+  transition: width 500ms ease-in-out;
+}
+
+.beta-tray.collapsed {
+  width: 70px;
+}
+
+.beta-tray.collapsed .tray-content {
+  opacity: 0;
+  transform: translateX(1rem);
+  pointer-events: none;
+}
+
+/* Gamma Tray (Right) */
+.gamma-tray {
+  transition: width 500ms ease-in-out;
+}
+
+.gamma-tray.collapsed {
+  width: 70px;
+}
+
+.gamma-tray.collapsed .tray-content {
+  opacity: 0;
+  transform: translateX(-1rem);
+  pointer-events: none;
+}
+
+/* Delta Tray (Bottom) */
+.delta-tray {
+  transition: height 500ms ease-in-out;
+}
+
+.delta-tray.collapsed {
+  height: 50px;
+}
+
+.delta-tray.collapsed .tray-content {
+  opacity: 0;
+  transform: translateY(1rem);
+  pointer-events: none;
+}
+
+/* Common content transitions */
+.tray-content {
+  transition: opacity 500ms ease-in-out, transform 500ms ease-in-out;
+  opacity: 1;
+  transform: translate(0);
+}

data/app/controllers/concerns/tray_configurable.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module TrayConfigurable
+  extend ActiveSupport::Concern
+
+  included do
+    helper_method :tray_config
+  end
+
+  def tray_config
+    @tray_config ||= {
+      beta: {
+        visible: false,
+        collapsible: true
+      },
+      gamma: {
+        visible: false,
+        collapsible: true
+      },
+      delta: {
+        visible: false,
+        collapsible: true
+      }
+    }
+  end
+
+  # Override in controllers to customize tray configuration
+  def configure_trays
+    # Example:
+    # tray_config[:beta][:visible] = true
+    # tray_config[:gamma][:collapsible] = false
+  end
+end

data/app/controllers/meta_workflows/application_controller.rb

@@ -4,6 +4,15 @@ module MetaWorkflows
   class ApplicationController < ActionController::Base
     protect_from_forgery with: :exception
 
+    include TrayConfigurable
+    before_action :configure_trays
+
+    def configure_trays
+      super
+      tray_config[:beta][:visible] = false
+      tray_config[:gamma][:visible] = false
+      tray_config[:delta][:visible] = false
+    end
     # Add any MetaWorkflows-specific controller functionality here
     # This ensures proper engine isolation
   end

data/app/helpers/meta_workflows/meta_workflows_helper.rb

@@ -37,5 +37,23 @@ module MetaWorkflows
         'Happy with this, or want changes?'
       ].sample
     end
+
+    def tray_state(tray)
+      (cookies['tray_'] && cookies['tray_'][tray.to_s]) || cookies["tray_#{tray}"] || 'expanded'
+    end
+
+    def chevron_direction(tray)
+      state = tray_state(tray)
+      case tray.to_s
+      when 'beta'
+        state == 'collapsed' ? 'fa-chevron-right' : 'fa-chevron-left'
+      when 'gamma'
+        state == 'collapsed' ? 'fa-chevron-left' : 'fa-chevron-right'
+      when 'delta'
+        state == 'collapsed' ? 'fa-chevron-up' : 'fa-chevron-down'
+      else
+        ''
+      end
+    end
   end
 end

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

@@ -1,17 +1,16 @@
 <!DOCTYPE html>
 <html>
-<head>
-  <title>Meta workflows</title>
-  <%= csrf_meta_tags %>
-  <%= csp_meta_tag %>
+  <head>
+    <title>Meta Workflows</title>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
 
-  <%= yield :head %>
+    <%= stylesheet_link_tag    "meta_workflows/application", media: "all" %>
+    <%= javascript_include_tag "meta_workflows/application" %>
+  </head>
 
-  <%= stylesheet_link_tag    "meta_workflows/application", media: "all" %>
-</head>
-<body>
-
-<%= yield %>
-
-</body>
+  <body>
+    <%= render 'layouts/meta_workflows/flash' %>
+    <%= yield %>
+  </body>
 </html>

data/db/migrate/20250613213159_add_error_fields_to_workflow_steps.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class AddErrorFieldsToWorkflowSteps < ActiveRecord::Migration[7.2]
   def change
     add_column :meta_workflows_workflow_steps, :error_message, :text

data/db/migrate/20250618175439_add_call_id_and_status_to_meta_workflows_tool_calls.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class AddCallIdAndStatusToMetaWorkflowsToolCalls < ActiveRecord::Migration[7.2]
+  def change
+    add_column :meta_workflows_tool_calls, :call_id, :string
+    add_column :meta_workflows_tool_calls, :status, :string
+  end
+end

data/lib/meta_workflows/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MetaWorkflows
-  VERSION = '0.7.0'
+  VERSION = '0.8.1'
 end

data/lib/tasks/git_hooks.rake

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+namespace :git do
+  desc 'Set up git hooks using Overcommit'
+  task setup_hooks: :environment do
+    puts 'Setting up git hooks with Overcommit...'
+
+    system('bundle exec overcommit --install') || abort('Failed to install Overcommit hooks')
+    system('bundle exec overcommit --sign') || abort('Failed to sign Overcommit hooks')
+    puts 'Git hooks have been set up successfully!'
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meta_workflows
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Leonid Medovyy
@@ -9,28 +9,22 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-16 00:00:00.000000000 Z
+date: 2025-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '9.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '9.0'
 - !ruby/object:Gem::Dependency
   name: sidekiq
   requirement: !ruby/object:Gem::Requirement
@@ -131,8 +125,10 @@ files:
 - app/assets/javascripts/meta_workflows/controllers/loading_phrases_controller.js
 - app/assets/javascripts/meta_workflows/controllers/redirect_controller.js
 - app/assets/javascripts/meta_workflows/controllers/response_scroll_controller.js
+- app/assets/javascripts/meta_workflows/controllers/tray_controller.js
 - app/assets/javascripts/meta_workflows_manifest.js
 - app/assets/stylesheets/meta_workflows/application.css
+- app/controllers/concerns/tray_configurable.rb
 - app/controllers/meta_workflows/application_controller.rb
 - app/controllers/meta_workflows/debug_controller.rb
 - app/controllers/meta_workflows/humans_controller.rb
@@ -177,6 +173,7 @@ files:
 - db/migrate/20250530220737_create_meta_workflows_tool_calls.rb
 - db/migrate/20250530220750_create_meta_workflows_workflow_steps.rb
 - db/migrate/20250613213159_add_error_fields_to_workflow_steps.rb
+- db/migrate/20250618175439_add_call_id_and_status_to_meta_workflows_tool_calls.rb
 - lib/meta_workflows.rb
 - lib/meta_workflows/asset_installer.rb
 - lib/meta_workflows/configuration.rb
@@ -186,16 +183,17 @@ files:
 - lib/services/meta_workflows/application_service.rb
 - lib/services/meta_workflows/meta_workflow_service.rb
 - lib/services/meta_workflows/updaters/meta_service.rb
+- lib/tasks/git_hooks.rake
 - lib/tasks/meta_workflows_tasks.rake
-homepage: https://github.com/strongmind/meta_workflows
+homepage: https://github.com/strongmind/meta-workflows
 licenses:
 - None
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/strongmind/meta_workflows
-  source_code_uri: https://github.com/strongmind/meta_workflows
-  changelog_uri: https://github.com/strongmind/meta_workflows/blob/main/CHANGELOG.md
-  documentation_uri: https://github.com/strongmind/meta_workflows/blob/main/README.md
+  homepage_uri: https://github.com/strongmind/meta-workflows
+  source_code_uri: https://github.com/strongmind/meta-workflows
+  changelog_uri: https://github.com/strongmind/meta-workflows/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/strongmind/meta-workflows/blob/main/README.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -212,7 +210,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: A Rails engine for managing AI-powered meta workflows