layered-assistant-rails 0.1.0

data/lib/generators/layered/assistant/install_generator.rb

@@ -0,0 +1,113 @@
+module Layered
+  module Assistant
+    module Generators
+      class InstallGenerator < Rails::Generators::Base
+        desc "Install layered-ui-assistant into the host application"
+
+        def self.source_root
+          Layered::Assistant::Engine.root
+        end
+
+        def verify_layered_ui_dependency
+          application_css = "app/assets/tailwind/application.css"
+          application_js = "app/javascript/application.js"
+
+          css_ok = File.exist?(application_css) && File.read(application_css).include?('@import "./layered_ui"')
+          js_ok = File.exist?(application_js) && File.read(application_js).include?('import "layered_ui"')
+
+          unless css_ok && js_ok
+            say "layered-ui-rails is not installed yet - installing now...", :yellow
+            invoke "layered:ui:install"
+          end
+        end
+
+        def copy_css
+          source_path = File.join(self.class.source_root, "app/assets/tailwind/layered/assistant/styles.css")
+          source_content = File.read(source_path)
+
+          header = <<~CSS
+            /*
+             * layered-assistant-rails v#{Layered::Assistant::VERSION}
+             *
+             * This file was automatically generated by the layered:assistant:install generator.
+             * Do not modify directly. To update, re-run: bin/rails generate layered:assistant:install
+             */
+
+          CSS
+
+          create_file "app/assets/tailwind/layered_assistant.css", header + source_content, force: true
+        end
+
+        def add_css_import
+          application_css = "app/assets/tailwind/application.css"
+
+          return unless File.exist?(application_css)
+
+          content = File.read(application_css)
+          import_line = '@import "./layered_assistant";'
+
+          return if content.include?(import_line)
+
+          # Insert after the layered_ui import (which must already be present)
+          inject_into_file application_css, "\n#{import_line}", after: '@import "./layered_ui";'
+          say "Added import to #{application_css}", :green
+        end
+
+        def add_js_import
+          application_js = "app/javascript/application.js"
+
+          return unless File.exist?(application_js)
+
+          content = File.read(application_js)
+          import_line = 'import "layered_assistant"'
+
+          return if content.include?(import_line)
+
+          # Insert after the layered_ui import (which must already be present)
+          inject_into_file application_js, "\n#{import_line}", after: 'import "layered_ui"'
+          say "Added import to #{application_js}", :green
+        end
+
+        def copy_initializer
+          initializer_path = "config/initializers/layered_assistant.rb"
+
+          return if File.exist?(initializer_path)
+
+          template_path = File.expand_path("templates/initializer.rb", __dir__)
+          create_file initializer_path, File.read(template_path)
+          say "Created #{initializer_path}", :green
+        end
+
+        def mount_engine
+          routes_file = "config/routes.rb"
+
+          return unless File.exist?(routes_file)
+
+          content = File.read(routes_file)
+          mount_line = 'mount Layered::Assistant::Engine => "/layered/assistant"'
+
+          return if content.include?("Layered::Assistant::Engine")
+
+          inject_into_file routes_file, "  #{mount_line}\n\n", after: "Rails.application.routes.draw do\n"
+          say "Mounted engine in #{routes_file}", :green
+        end
+
+        def copy_migrations
+          invoke "layered:assistant:migrations"
+        end
+
+        def show_instructions
+          say ""
+          say "layered-assistant-rails installed successfully", :green
+          say ""
+          say "Next steps:", :yellow
+          say "  1. Run bin/rails db:migrate"
+          say "  2. Configure authorization in config/initializers/layered_assistant.rb"
+          say "  3. Routes return 403 until you uncomment an authorize block"
+          say "  4. Visit /layered/assistant to get started"
+          say ""
+        end
+      end
+    end
+  end
+end

data/lib/generators/layered/assistant/migrations_generator.rb

@@ -0,0 +1,47 @@
+module Layered
+  module Assistant
+    module Generators
+      class MigrationsGenerator < Rails::Generators::Base
+        desc "Copy layered-assistant-rails migrations to the host application"
+
+        def copy_migrations
+          engine_migrations_path = Layered::Assistant::Engine.root.join("db/migrate")
+          app_migrations_path = Rails.root.join("db/migrate")
+
+          unless engine_migrations_path.exist?
+            say "No migrations found in layered-assistant-rails.", :yellow
+            return
+          end
+
+          existing_migrations = Dir[app_migrations_path.join("*.rb")].map { |f| migration_name(File.basename(f)) }
+
+          timestamp = Time.now.utc.strftime("%Y%m%d%H%M%S").to_i
+
+          Dir[engine_migrations_path.join("*.rb")].sort.each do |source|
+            basename = File.basename(source)
+            name = migration_name(basename)
+
+            if existing_migrations.include?(name)
+              say "  skip  #{name} (already exists)", :yellow
+              next
+            end
+
+            destination = app_migrations_path.join("#{timestamp}_#{name}.layered_assistant.rb")
+            content = "# This migration comes from layered_assistant (originally #{basename.split("_").first})\n" + File.read(source)
+
+            create_file destination, content
+            timestamp += 1
+          end
+        end
+
+        private
+
+        # Extract migration name without timestamp prefix
+        # e.g. "20260202074215_create_layered_assistant_providers.rb" => "create_layered_assistant_providers"
+        def migration_name(filename)
+          filename.sub(/^\d+_/, "").sub(/\.layered_assistant\.rb$/, "").sub(/\.rb$/, "")
+        end
+      end
+    end
+  end
+end

data/lib/generators/layered/assistant/templates/initializer.rb

@@ -0,0 +1,26 @@
+# Configure authorization for layered-assistant-rails.
+# All non-public engine routes return 403 Forbidden until this block is configured.
+# Uncomment one of the examples below, or write your own.
+#
+# The block runs in controller context, so you have access to request,
+# current_user, redirect_to, head, main_app, and all other controller methods.
+#
+# Once configured, visit /layered/assistant (or your mount path) to get started.
+
+# Allow all requests (no authorization):
+#
+# Layered::Assistant.authorize do
+#   # No-op: all requests permitted
+# end
+
+# Require sign-in (Devise):
+#
+# Layered::Assistant.authorize do
+#   redirect_to main_app.new_user_session_path unless user_signed_in?
+# end
+
+# Restrict to admins:
+#
+# Layered::Assistant.authorize do
+#   head :forbidden unless current_user&.admin?
+# end

data/lib/layered/assistant/engine.rb

@@ -0,0 +1,29 @@
+module Layered
+  module Assistant
+    class Engine < ::Rails::Engine
+      isolate_namespace Layered::Assistant
+
+      initializer "layered-assistant-rails.inflections", before: :set_autoload_paths do
+        ActiveSupport::Inflector.inflections do |inflect|
+          inflect.acronym "OpenAI"
+        end
+      end
+
+      initializer "layered-assistant-rails.importmap", before: "importmap" do |app|
+        app.config.importmap.paths << Engine.root.join("config/importmap.rb")
+      end
+
+      initializer "layered-assistant-rails.assets" do |app|
+        app.config.assets.paths << Engine.root.join("app/javascript")
+      end
+
+      initializer "layered-assistant-rails.helpers" do
+        ActiveSupport.on_load(:action_controller_base) do
+          helper Layered::Assistant::AccessHelper
+          helper Layered::Assistant::MessagesHelper
+          helper Layered::Assistant::PanelHelper
+        end
+      end
+    end
+  end
+end

data/lib/layered/assistant/version.rb

@@ -0,0 +1,5 @@
+module Layered
+  module Assistant
+    VERSION = "0.1.0"
+  end
+end

data/lib/layered/assistant.rb

@@ -0,0 +1,19 @@
+require "positioning"
+require "pagy"
+require "anthropic"
+require "openai"
+require "kramdown"
+require "kramdown-parser-gfm"
+require "layered-ui-rails"
+require "layered/assistant/version"
+require "layered/assistant/engine"
+
+module Layered
+  module Assistant
+    mattr_reader :authorize_block
+
+    def self.authorize(&block)
+      @@authorize_block = block
+    end
+  end
+end

data/lib/layered-assistant-rails.rb

@@ -0,0 +1 @@
+require "layered/assistant"