rails-ai-context 2.0.4 → 3.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 2.0.4
+  version: 3.0.0
 platform: ruby
 authors:
 - crisnahine
@@ -167,7 +167,7 @@ description: |
   conventions connect. 25 live MCP tools let agents query structure on demand with
   semantic validation that catches cross-file errors (wrong columns, missing
   partials, broken routes) before code runs. Auto-generates context files for
-  Claude Code, Cursor, Windsurf, GitHub Copilot, and OpenCode. Zero config.
+  Claude Code, Cursor, GitHub Copilot, and OpenCode. Zero config.
 email:
 - crisjosephnahine@gmail.com
 executables:
@@ -192,6 +192,7 @@ files:
 - lib/generators/rails_ai_context/install/install_generator.rb
 - lib/rails-ai-context.rb
 - lib/rails_ai_context.rb
+- lib/rails_ai_context/cli/tool_runner.rb
 - lib/rails_ai_context/configuration.rb
 - lib/rails_ai_context/doctor.rb
 - lib/rails_ai_context/engine.rb
@@ -243,8 +244,7 @@ files:
 - lib/rails_ai_context/serializers/rules_serializer.rb
 - lib/rails_ai_context/serializers/stack_overview_helper.rb
 - lib/rails_ai_context/serializers/test_command_detection.rb
-- lib/rails_ai_context/serializers/windsurf_rules_serializer.rb
-- lib/rails_ai_context/serializers/windsurf_serializer.rb
+- lib/rails_ai_context/serializers/tool_guide_helper.rb
 - lib/rails_ai_context/server.rb
 - lib/rails_ai_context/tasks/rails_ai_context.rake
 - lib/rails_ai_context/tools/analyze_feature.rb

data/lib/rails_ai_context/serializers/windsurf_rules_serializer.rb

@@ -1,111 +0,0 @@
-# frozen_string_literal: true
-
-module RailsAiContext
-  module Serializers
-    # Generates .windsurf/rules/*.md files in the new Windsurf rules format.
-    # Each file is hard-capped at 5,800 characters (within Windsurf's 6K limit).
-    class WindsurfRulesSerializer
-      include DesignSystemHelper
-
-      MAX_CHARS_PER_FILE = 5_800
-
-      attr_reader :context
-
-      def initialize(context)
-        @context = context
-      end
-
-      def call(output_dir)
-        rules_dir = File.join(output_dir, ".windsurf", "rules")
-        FileUtils.mkdir_p(rules_dir)
-
-        written = []
-        skipped = []
-
-        files = {
-          "rails-context.md" => render_context_rule,
-          "rails-ui-patterns.md" => render_ui_patterns_rule,
-          "rails-mcp-tools.md" => render_mcp_tools_rule
-        }
-
-        files.each do |filename, content|
-          next unless content
-          # Enforce Windsurf's 6K limit
-          content = content[0...MAX_CHARS_PER_FILE] if content.length > MAX_CHARS_PER_FILE
-
-          filepath = File.join(rules_dir, filename)
-          if File.exist?(filepath) && File.read(filepath) == content
-            skipped << filepath
-          else
-            File.write(filepath, content)
-            written << filepath
-          end
-        end
-
-        { written: written, skipped: skipped }
-      end
-
-      private
-
-      def render_context_rule
-        # Reuse WindsurfSerializer content
-        WindsurfSerializer.new(context).call
-      end
-
-      def render_ui_patterns_rule
-        vt = context[:view_templates]
-        return nil unless vt.is_a?(Hash) && !vt[:error]
-        components = vt.dig(:ui_patterns, :components) || []
-        return nil if components.empty?
-
-        # Compact design system for Windsurf's character budget
-        lines = render_design_system(context, max_lines: 25)
-        return nil if lines.empty?
-
-        lines.join("\n")
-      end
-
-      def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
-        lines = [
-          "# Rails MCP Tools (25) — MANDATORY, Use Before Read",
-          "",
-          "CRITICAL: This project has live MCP tools. Use them for ALL context gathering.",
-          "Read files ONLY when you are about to edit them.",
-          "",
-          "Mandatory Workflow:",
-          "1. Gathering context → use MCP tools (NOT file reads)",
-          "2. Reading files → ONLY files you will edit",
-          "3. After editing → rails_validate(files:[...]) every time",
-          "",
-          "Do NOT Bypass:",
-          "- Reading db/schema.rb → rails_get_schema(table:\"name\")",
-          "- Reading config/routes.rb → rails_get_routes(controller:\"name\")",
-          "- Reading model files → rails_get_model_details(model:\"Name\")",
-          "- Grep for code → rails_search_code(pattern:\"regex\")",
-          "- Reading test files → rails_get_test_info(model:\"Name\")",
-          "- Reading controller → rails_get_controllers(controller:\"Name\", action:\"x\")",
-          "- Reading JS for Stimulus → rails_get_stimulus(controller:\"name\")",
-          "- Multiple reads for feature → rails_analyze_feature(feature:\"keyword\")",
-          "- ruby -c / erb / node -c → rails_validate(files:[...])",
-          "",
-          "All 25 Tools:",
-          "- rails_get_schema | rails_get_model_details | rails_get_routes | rails_get_controllers",
-          "- rails_get_view | rails_get_stimulus | rails_get_test_info | rails_analyze_feature",
-          "- rails_get_design_system | rails_get_edit_context | rails_validate | rails_search_code",
-          "- rails_get_config | rails_get_gems | rails_get_conventions | rails_security_scan",
-          "- rails_get_concern | rails_get_callbacks | rails_get_helper_methods | rails_get_service_pattern",
-          "- rails_get_job_pattern | rails_get_env | rails_get_partial_interface | rails_get_turbo_map",
-          "- rails_get_context(model:\"X\") — composite cross-layer context in one call",
-          "",
-          "Power Features:",
-          "- rails_search_code(pattern:\"method\", match_type:\"trace\") — trace: definition + source + siblings + callers + tests",
-          "- rails_get_concern(name:\"X\", detail:\"full\") — concern methods with source code",
-          "- rails_analyze_feature — full-stack with inherited filters, route helpers, test gaps",
-          "- rails_get_schema — columns, indexes, defaults, encrypted hints, orphaned table warnings"
-        ]
-
-        lines.join("\n")
-      end
-    end
-  end
-end

data/lib/rails_ai_context/serializers/windsurf_serializer.rb

@@ -1,160 +0,0 @@
-# frozen_string_literal: true
-
-module RailsAiContext
-  module Serializers
-    # Generates .windsurfrules within Windsurf's hard 6,000 character limit.
-    # Always produces compact output regardless of context_mode.
-    class WindsurfSerializer
-      include TestCommandDetection
-      include StackOverviewHelper
-      include DesignSystemHelper
-
-      MAX_CHARS = 5_800 # Leave buffer below 6K limit
-
-      attr_reader :context
-
-      def initialize(context)
-        @context = context
-      end
-
-      def call
-        content = render
-        # HARD enforce character limit — Windsurf silently truncates
-        if content.length > MAX_CHARS
-          content = content[0...MAX_CHARS]
-          content += "\n\n# Use MCP tools for full details."
-        end
-        content
-      end
-
-      private
-
-      def render
-        lines = []
-        lines << "# #{context[:app_name]} — Rails #{context[:rails_version]}"
-        lines << ""
-
-        # Stack (very compact)
-        schema = context[:schema]
-        lines << "Database: #{schema[:adapter]}, #{schema[:total_tables]} tables" if schema && !schema[:error]
-
-        models = context[:models]
-        lines << "Models: #{models.size}" if models.is_a?(Hash) && !models[:error]
-
-        routes = context[:routes]
-        lines << "Routes: #{routes[:total_routes]}" if routes && !routes[:error]
-
-        lines.concat(full_preset_stack_lines)
-
-        # Gems (one line per category)
-        gems = context[:gems]
-        if gems.is_a?(Hash) && !gems[:error]
-          notable = gems[:notable_gems] || gems[:notable] || gems[:detected] || []
-          grouped = notable.group_by { |g| g[:category]&.to_s || "other" }
-          grouped.first(6).each do |cat, gem_list|
-            lines << "#{cat}: #{gem_list.map { |g| g[:name] }.first(4).join(', ')}"
-          end
-        end
-
-        lines << ""
-
-        # Key models (names only — character budget is tight)
-        if models.is_a?(Hash) && !models[:error] && models.any?
-          lines << "# Key models"
-          models.keys.sort.first(20).each do |name|
-            data = models[name]
-            lines << "- #{name}"
-            scopes = (data[:scopes] || [])
-            constants = (data[:constants] || [])
-            if scopes.any? || constants.any?
-              extras = []
-              extras << "scopes: #{scopes.join(', ')}" if scopes.any?
-              constants.each { |c| extras << "#{c[:name]}: #{c[:values].join(', ')}" }
-              lines << "  #{extras.join(' | ')}"
-            end
-          end
-          lines << "- ...#{models.size - 20} more" if models.size > 20
-          lines << ""
-        end
-
-        # Architecture
-        conv = context[:conventions]
-        if conv.is_a?(Hash) && !conv[:error]
-          arch = conv[:architecture] || []
-          if arch.any?
-            arch_labels = RailsAiContext::Tools::GetConventions::ARCH_LABELS rescue {}
-            lines << "# Architecture"
-            arch.first(5).each { |p| lines << "- #{arch_labels[p] || p}" }
-          end
-        end
-
-        # List service objects
-        begin
-          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
-          services_dir = File.join(root, "app", "services")
-          if Dir.exist?(services_dir)
-            service_files = Dir.glob(File.join(services_dir, "*.rb"))
-              .map { |f| File.basename(f, ".rb").camelize }
-              .reject { |s| s == "ApplicationService" }
-            lines << "Services: #{service_files.join(', ')}" if service_files.any?
-          end
-        rescue; end
-
-        # List jobs
-        begin
-          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
-          jobs_dir = File.join(root, "app", "jobs")
-          if Dir.exist?(jobs_dir)
-            job_files = Dir.glob(File.join(jobs_dir, "*.rb"))
-              .map { |f| File.basename(f, ".rb").camelize }
-              .reject { |j| j == "ApplicationJob" }
-            lines << "Jobs: #{job_files.join(', ')}" if job_files.any?
-          end
-        rescue; end
-
-        # ApplicationController before_actions
-        begin
-          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
-          app_ctrl = File.join(root, "app", "controllers", "application_controller.rb")
-          if File.exist?(app_ctrl)
-            source = File.read(app_ctrl)
-            before_actions = source.scan(/before_action\s+:([\w!?]+)/).flatten
-            lines << "Global before_actions: #{before_actions.join(', ')}" if before_actions.any?
-          end
-        rescue; end
-
-        lines << ""
-
-        # Design System (compact — character budget is tight)
-        ds_lines = render_design_system(context, max_lines: 15)
-        lines.concat(ds_lines) if ds_lines.any?
-
-        # MCP tools — compact but complete (character budget is tight)
-        lines << "# MCP Tools (detail:\"summary\"|\"standard\"|\"full\")"
-        lines << "- rails_get_schema(table:\"name\"|detail:\"summary\"|limit:N|offset:N)"
-        lines << "- rails_get_model_details(model:\"Name\"|detail:\"summary\")"
-        lines << "- rails_get_routes(controller:\"name\"|detail:\"summary\"|limit:N|offset:N)"
-        lines << "- rails_get_controllers(controller:\"Name\"|detail:\"summary\")"
-        lines << "- rails_get_config — cache, session, middleware"
-        lines << "- rails_get_test_info — framework, factories, CI"
-        lines << "- rails_get_gems — categorized gems"
-        lines << "- rails_get_conventions — architecture patterns"
-        lines << "- rails_search_code(pattern:\"regex\"|file_type:\"rb\"|max_results:N)"
-        lines << "- rails_get_edit_context(file:\"path\"|near:\"keyword\")"
-        lines << "- rails_analyze_feature(feature:\"auth\") — combined context for a feature"
-        lines << "- rails_get_design_system — color palette, components, page examples"
-        lines << "- rails_validate(files:[\"path\"])"
-        lines << "Start with detail:\"summary\", then drill into specifics."
-        lines << ""
-        lines << "# Rules"
-        lines << "- Follow existing patterns"
-        lines << "- Check schema via MCP before writing migrations"
-        lines << "- Run `#{detect_test_command}` after changes"
-        lines << "- After editing: use rails_validate, do NOT re-read files to verify"
-        lines << "- Stimulus controllers auto-register — no manual import needed"
-
-        lines.join("\n")
-      end
-    end
-  end
-end