soka-rails 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6730ee1778d50df9b15f89e90cae6ee7ad6e5ccad4957859ab99b328cd4d37f
-  data.tar.gz: 51d7ca5f8469231d197f74317661f02d4a9cdfa6a3ba4deb92d85928aab51bf3
+  metadata.gz: 956c0fc8a0ecef6e81f471a6674f4a0c7c5df800f720618ecf54a32c87583d1f
+  data.tar.gz: d7d16aff15e796d33c284bb77f1db2f7ff42ba61dbf3fb7f76ded2e87a0758d5
 SHA512:
-  metadata.gz: 2b5b44129a5845a5d9f4054f6b8128620767092b9db3862c715d12d9383d8d76dea3f0abe0cac00b67f91806a1247970dc9870828201795ce2d7396252435da3
-  data.tar.gz: 48beed549db55eee4f4ca2d9a20dae03ec51b6de0103dc9c4a4519d5938f64be872c2ab41cee3b88766fe32cebfd32d44268f8fb9dc741c5ceee8fb0c4f47435
+  metadata.gz: fd259ec01dcb6ba6c760685a3d1f94bf0091a9298014f696c782cf7839e182651d1e9c44457ed9505bc76a6b048ab72a9bc9b16063c43b436a5b7d48ce98ad17
+  data.tar.gz: 3383aba5cdbf64703815efe55214ad63e9ae8d8aedcd6f845c97ef4c6382cf91ba8a9cd0217c75a4fa7db38fa62507072a3550d64c8098dadfa85fd97e0585d9

data/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.2] - 2025-08-01
+
+### Fixed
+- Comment out private keyword in agent template
+- Resolve Rails autoloading issues for agents and tools
+
+### Changed
+- Add link to full changelog in release notes
+
 ## [0.0.1] - 2025-08-01
 
 ### Added

data/lib/generators/soka/agent/templates/agent.rb.tt

@@ -19,7 +19,7 @@ class <%= @agent_class_name %> < ApplicationAgent
   # after_action :your_method
   # on_error :your_method
 
-  private
+  # private
 
   # Implement your private methods here
 end

data/lib/soka/rails/railtie.rb

@@ -1,14 +1,65 @@
 # frozen_string_literal: true
 
+require 'soka'
+
 module Soka
   module Rails
     # Rails integration for Soka, configuring autoloading and initializers
+    #
+    # This Railtie ensures that Soka agents and tools can be autoloaded
+    # properly by Rails' Zeitwerk autoloader. It sets up app/soka as a
+    # root directory and collapses subdirectories to avoid namespace requirements.
+    #
+    # @example Directory structure
+    #   app/soka/
+    #   ├── agents/
+    #   │   ├── application_agent.rb  # Defines ApplicationAgent (not Agents::ApplicationAgent)
+    #   │   └── search_agent.rb       # Defines SearchAgent (not Agents::SearchAgent)
+    #   └── tools/
+    #       ├── application_tool.rb   # Defines ApplicationTool (not Tools::ApplicationTool)
+    #       └── search_tool.rb        # Defines SearchTool (not Tools::SearchTool)
     class Railtie < ::Rails::Railtie
-      # Configure autoloading - executed after Rails completes basic setup
-      initializer 'soka.setup_autoloading', before: :set_autoload_paths do |app|
-        # Add app/soka to autoload paths
-        # eager_load: true will automatically include all subdirectories
-        app.config.paths.add 'app/soka', eager_load: true
+      # Configuration for collapsed directories
+      # Users can modify this in an initializer if needed
+      config.soka_collapsed_dirs = %w[agents tools]
+
+      # Set up Zeitwerk autoloading for Soka directories
+      #
+      # This initializer runs after Rails sets up its autoloaders but before
+      # eager loading begins. It configures app/soka as a root directory
+      # and collapses specified subdirectories.
+      initializer 'soka.setup_autoloading',
+                  after: :setup_once_autoloader,
+                  before: :eager_load! do |app|
+        setup_soka_autoloading(app)
+      end
+
+      private
+
+      def setup_soka_autoloading(app)
+        soka_path = app.root.join('app/soka')
+        return unless soka_path.exist?
+
+        configure_autoloader(soka_path)
+      rescue StandardError => e
+        ::Rails.logger&.error "[Soka] Failed to configure autoloading: #{e.message}"
+        raise
+      end
+
+      def configure_autoloader(soka_path)
+        # Add app/soka as a root directory without namespace
+        # This allows classes in app/soka to be loaded at the top level
+        ::Rails.autoloaders.main.push_dir(soka_path.to_s)
+
+        # Collapse configured directories
+        # This removes the directory name from the expected constant path
+        # e.g., app/soka/agents/foo.rb defines Foo instead of Agents::Foo
+        config.soka_collapsed_dirs.each do |dir|
+          dir_path = soka_path.join(dir)
+          ::Rails.autoloaders.main.collapse(dir_path.to_s) if dir_path.exist?
+        end
+
+        ::Rails.logger&.debug "[Soka] Configured autoloading for #{soka_path}"
       end
     end
   end

data/lib/soka/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Soka
   module Rails
-    VERSION = '0.0.1'
+    VERSION = '0.0.2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: soka-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - jiunjiun