agentation 1.0.0

data/lib/agentation/engine.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Agentation
+  class Engine < ::Rails::Engine
+    isolate_namespace Agentation
+
+    # Configure asset paths for all asset pipelines (Sprockets/Propshaft)
+    initializer "agentation.assets" do |app|
+      next unless app.config.respond_to?(:assets)
+
+      # CSS is served from app/assets/stylesheets
+      app.config.assets.paths << Engine.root.join("app/assets/stylesheets")
+
+      # ESM JavaScript is served from vendor/javascript
+      app.config.assets.paths << Engine.root.join("vendor/javascript")
+
+      # Precompile the main assets
+      app.config.assets.precompile += %w[agentation.css agentation.esm.js]
+    end
+
+    # Importmap support (Rails 7+)
+    initializer "agentation.importmap", before: "importmap" do |app|
+      next unless defined?(Importmap) && app.respond_to?(:importmap)
+
+      # Pin the ESM module
+      app.config.after_initialize do
+        app.importmap.pin "agentation", to: "agentation.esm.js" if app.importmap.respond_to?(:pin)
+      end
+    end
+
+    # Add view helpers
+    initializer "agentation.view_helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include Agentation::ViewHelpers
+      end
+    end
+  end
+end

data/lib/agentation/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Agentation
+  VERSION = "1.0.0"
+end

data/lib/agentation/view_helpers.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Agentation
+  module ViewHelpers
+    # Renders the Agentation toolbar
+    #
+    # Options:
+    #   output_detail: "compact" | "standard" | "detailed" | "forensic" (default: "standard")
+    #   annotation_color: hex color string (default: "#3c82f7")
+    #   auto_clear_after_copy: boolean (default: false)
+    #   block_interactions: boolean (default: false)
+    #   dark_mode: boolean (default: true)
+    #
+    # Example:
+    #   <%= agentation_toolbar %>
+    #   <%= agentation_toolbar(output_detail: "forensic", annotation_color: "#34C759") %>
+    #
+    def agentation_toolbar(options = {})
+      content_tag(:div, id: "agentation-root", data: {
+        agentation: true,
+        options: options.to_json
+      }) do
+        # Empty content - JavaScript initializes the toolbar
+        ""
+      end
+    end
+  end
+end

data/lib/agentation.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "agentation/version"
+require_relative "agentation/engine" if defined?(Rails::Engine)
+require_relative "agentation/view_helpers"
+
+module Agentation
+end

data/lib/generators/agentation/install_generator.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module Agentation
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Install Agentation toolbar into your Rails application"
+
+      def add_stylesheet
+        if File.exist?("app/assets/stylesheets/application.css")
+          inject_into_file "app/assets/stylesheets/application.css",
+                           " *= require agentation\n",
+                           before: " *= require_tree ."
+          say "Added agentation stylesheet to application.css", :green
+        else
+          say "Could not find application.css - please add manually:", :yellow
+          say '  @import "agentation";', :yellow
+        end
+      end
+
+      def add_javascript
+        if File.exist?("app/javascript/application.js")
+          append_to_file "app/javascript/application.js", 'import "agentation"' + "\n"
+          say "Added agentation import to application.js", :green
+        else
+          say "Could not find application.js - please add manually:", :yellow
+          say '  import "agentation"', :yellow
+        end
+      end
+
+      def add_toolbar_helper
+        layout_file = "app/views/layouts/application.html.erb"
+
+        if File.exist?(layout_file)
+          content = File.read(layout_file)
+
+          if content.include?("agentation_toolbar")
+            say "Toolbar helper already present in layout", :yellow
+          elsif content.include?("</body>")
+            inject_into_file layout_file,
+                             "    <%= agentation_toolbar %>\n",
+                             before: "  </body>"
+            say "Added agentation_toolbar helper to layout", :green
+          else
+            say "Could not find </body> tag - please add manually:", :yellow
+            say "  <%= agentation_toolbar %>", :yellow
+          end
+        else
+          say "Could not find application layout - please add manually:", :yellow
+          say "  <%= agentation_toolbar %>", :yellow
+        end
+      end
+
+      def show_instructions
+        say ""
+        say "Agentation installed successfully!", :green
+        say ""
+        say "The toolbar will appear in the bottom-right corner of your app."
+        say "Click the sparkle icon to activate annotation mode."
+        say ""
+        say "Options available:"
+        say '  <%= agentation_toolbar(output_detail: "forensic") %>'
+        say '  <%= agentation_toolbar(annotation_color: "#ff6b6b") %>'
+        say ""
+      end
+    end
+  end
+end