rails-ai-context 2.0.0 → 2.0.2

data/lib/rails_ai_context/serializers/cursor_rules_serializer.rb

@@ -256,39 +256,41 @@ module RailsAiContext
       def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
         lines = [
           "---",
-          "description: \"Rails MCP tools (25) — use for reference files, read directly if you'll edit\"",
+          "description: \"Rails MCP tools (25) — MANDATORY, use before reading any reference files\"",
           "alwaysApply: true",
           "---",
           "",
-          "# Rails MCP Tools (25) — Use These First",
+          "# Rails MCP Tools (25) — MANDATORY, Use Before Read",
           "",
-          "Use MCP for reference files (schema, routes, tests). Read files directly if you'll edit them.",
-          "MCP tools return line numbers for surgical edits.",
+          "CRITICAL: This project has live MCP tools. You MUST use them for gathering context.",
+          "Read files ONLY when you are about to edit them. Never read reference files directly.",
           "",
-          "- `rails_get_schema(detail:\"summary\")` → `rails_get_schema(table:\"name\")`",
-          "- `rails_get_model_details(detail:\"summary\")` → `rails_get_model_details(model:\"Name\")`",
-          "- `rails_get_routes(detail:\"summary\")` → `rails_get_routes(controller:\"name\")`",
-          "- `rails_get_controllers(controller:\"Name\", action:\"index\")` — one action's source code",
-          "- `rails_get_view(controller:\"cooks\")` — view list; `rails_get_view(path:\"cooks/index.html.erb\")` — content",
-          "- `rails_get_stimulus(detail:\"summary\")` → `rails_get_stimulus(controller:\"name\")`",
-          "- `rails_get_test_info(detail:\"full\")` — fixtures, factories, helpers; `(model:\"Cook\")` — existing tests",
-          "- `rails_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
-          "- `rails_get_design_system` — color palette, components, canonical page examples",
-          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`",
-          "- `rails_get_edit_context(file:\"path\", near:\"keyword\")` — surgical edit context with line numbers",
-          "- `rails_validate(files:[\"path\"])` — validate Ruby, ERB, JS syntax in one call",
-          "- `rails_security_scan` — Brakeman security analysis",
-          "- `rails_get_concern(name:\"Searchable\")` — concern methods and includers",
-          "- `rails_get_callbacks(model:\"User\")` — model callbacks in execution order",
-          "- `rails_get_helper_methods` — app + framework helpers",
-          "- `rails_get_service_pattern` — service object patterns and interfaces",
-          "- `rails_get_job_pattern` — background job patterns and schedules",
-          "- `rails_get_env` — environment variables and credentials keys",
-          "- `rails_get_partial_interface(path:\"shared/_form\")` — partial locals contract",
-          "- `rails_get_turbo_map` — Turbo Streams/Frames wiring",
-          "- `rails_get_context(model:\"User\")` — composite cross-layer context",
+          "## Mandatory Workflow",
+          "1. Gathering context → use MCP tools (NOT file reads, NOT grep)",
+          "2. Reading files → ONLY files you will edit (Read is required before Edit)",
+          "3. After editing → `rails_validate(files:[...])` every time, no exceptions",
           "",
-          "After editing: use rails_validate to check syntax. Do NOT re-read files to verify."
+          "## Do NOT Bypass — Anti-Patterns",
+          "| Instead of... | Use this MCP tool |",
+          "|---------------|-------------------|",
+          "| Reading db/schema.rb | `rails_get_schema(table:\"name\")` |",
+          "| Reading config/routes.rb | `rails_get_routes(controller:\"name\")` |",
+          "| Reading model files for context | `rails_get_model_details(model:\"Name\")` |",
+          "| Grep for code patterns | `rails_search_code(pattern:\"regex\")` |",
+          "| Reading test files for patterns | `rails_get_test_info(model:\"Name\")` |",
+          "| Reading controller for context | `rails_get_controllers(controller:\"Name\", action:\"x\")` |",
+          "| Reading JS for Stimulus API | `rails_get_stimulus(controller:\"name\")` |",
+          "| Multiple reads for a 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"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/serializers/opencode_serializer.rb

@@ -165,33 +165,39 @@ module RailsAiContext
 
       def render_mcp_guide # rubocop:disable Metrics/MethodLength
         [
-          "## MCP Tools (25) — ALWAYS Use These First",
+          "## MCP Tools (25) — MANDATORY, Use Before Read",
           "",
-          "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
-          "MCP tools return line numbers. Start with `detail:\"summary\"`.",
+          "CRITICAL: This project has live MCP tools. You MUST use them for gathering context.",
+          "Read files ONLY when you are about to edit them. Never read reference files directly.",
+          "Start with `detail:\"summary\"`, then drill into specifics.",
           "",
-          "- `rails_get_schema(detail:\"summary\")` → `rails_get_schema(table:\"name\")`",
-          "- `rails_get_model_details(detail:\"summary\")` → `rails_get_model_details(model:\"Name\")`",
-          "- `rails_get_routes(detail:\"summary\")` → `rails_get_routes(controller:\"name\")`",
-          "- `rails_get_controllers(controller:\"Name\", action:\"index\")` — one action's source code",
-          "- `rails_get_view(controller:\"cooks\")` — view list; `(path:\"cooks/index.html.erb\")` — content",
-          "- `rails_get_stimulus(detail:\"summary\")` → `(controller:\"name\")` — targets, actions, values",
-          "- `rails_get_test_info(detail:\"full\")` — fixtures, factories, helpers; `(model:\"Cook\")` — tests",
-          "- `rails_get_edit_context(file:\"path\", near:\"keyword\")` — surgical edit context with line numbers",
-          "- `rails_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
-          "- `rails_get_design_system` — color palette, component patterns, canonical page examples",
-          "- `rails_validate(files:[...])` — batch syntax check for Ruby, ERB, JS",
-          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`",
-          "- `rails_security_scan` — Brakeman security analysis",
-          "- `rails_get_concern(name:\"Searchable\")` — concern methods and includers",
-          "- `rails_get_callbacks(model:\"User\")` — model callbacks in execution order",
-          "- `rails_get_helper_methods` — app + framework helpers",
-          "- `rails_get_service_pattern` — service object patterns and interfaces",
-          "- `rails_get_job_pattern` — background job patterns and schedules",
-          "- `rails_get_env` — environment variables and credentials keys",
-          "- `rails_get_partial_interface(path:\"shared/_form\")` — partial locals contract",
-          "- `rails_get_turbo_map` — Turbo Streams/Frames wiring",
-          "- `rails_get_context(model:\"User\")` — composite cross-layer context",
+          "### Mandatory Workflow",
+          "1. **Before exploring a feature**: `rails_analyze_feature(feature:\"...\")` — NOT file reads or grep",
+          "2. **Before writing migrations**: `rails_get_schema(table:\"...\")` — NOT reading db/schema.rb",
+          "3. **Before modifying a model**: `rails_get_model_details(model:\"...\")` — NOT reading the model file",
+          "4. **Before adding routes**: `rails_get_routes(controller:\"...\")` — Read only when you will edit",
+          "5. **Before creating views**: `rails_get_design_system` — match existing patterns",
+          "6. **After editing ANY file**: `rails_validate(files:[...])` — no exceptions",
+          "",
+          "### Do NOT Bypass",
+          "| Instead of... | Use this MCP tool |",
+          "|---------------|-------------------|",
+          "| Reading db/schema.rb | `rails_get_schema(table:\"x\")` |",
+          "| Reading model files | `rails_get_model_details(model:\"X\")` |",
+          "| Reading routes.rb | `rails_get_routes(controller:\"x\")` |",
+          "| Grep for code | `rails_search_code(pattern:\"x\")` |",
+          "| Reading test files | `rails_get_test_info(model:\"X\")` |",
+          "| Reading controller | `rails_get_controllers(controller:\"X\", action:\"y\")` |",
+          "| ruby -c / erb / node | `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",
           ""
         ]
       end

data/lib/rails_ai_context/serializers/windsurf_rules_serializer.rb

@@ -67,34 +67,35 @@ module RailsAiContext
 
       def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
         lines = [
-          "# Rails MCP Tools (25) — Use These First",
+          "# Rails MCP Tools (25) — MANDATORY, Use Before Read",
           "",
-          "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
+          "CRITICAL: This project has live MCP tools. Use them for ALL context gathering.",
+          "Read files ONLY when you are about to edit them.",
           "",
-          "- rails_get_schema(detail:\"summary\") → rails_get_schema(table:\"name\")",
-          "- rails_get_model_details(detail:\"summary\") → rails_get_model_details(model:\"Name\")",
-          "- rails_get_routes(detail:\"summary\") → rails_get_routes(controller:\"name\")",
-          "- rails_get_controllers(controller:\"Name\", action:\"index\") — one action's source",
-          "- rails_get_view(controller:\"cooks\") — views; rails_get_view(path:\"file\") — content",
-          "- rails_get_stimulus(detail:\"summary\") → rails_get_stimulus(controller:\"name\")",
-          "- rails_get_test_info(detail:\"full\") — fixtures, helpers; (model:\"Cook\") — tests",
-          "- rails_analyze_feature(feature:\"auth\") — schema + models + controllers + routes for a feature",
-          "- rails_get_design_system — color palette, components, page examples",
-          "- rails_get_config | rails_get_gems | rails_get_conventions | rails_search_code",
-          "- rails_get_edit_context(file:\"path\", near:\"keyword\") — surgical edit context with line numbers",
-          "- rails_validate(files:[\"path\"]) — validate Ruby, ERB, JS syntax in one call",
-          "- rails_security_scan — Brakeman security analysis",
-          "- rails_get_concern(name:\"Searchable\") — concern methods and includers",
-          "- rails_get_callbacks(model:\"User\") — model callbacks in execution order",
-          "- rails_get_helper_methods — app + framework helpers",
-          "- rails_get_service_pattern — service object patterns and interfaces",
-          "- rails_get_job_pattern — background job patterns and schedules",
-          "- rails_get_env — environment variables and credentials keys",
-          "- rails_get_partial_interface(path:\"shared/_form\") — partial locals contract",
-          "- rails_get_turbo_map — Turbo Streams/Frames wiring",
-          "- rails_get_context(model:\"User\") — composite cross-layer context",
+          "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",
           "",
-          "After editing: use rails_validate to check syntax. Do NOT re-read files to verify."
+          "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"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/tasks/rails_ai_context.rake

@@ -24,24 +24,95 @@ def apply_context_mode_override
   end
 end unless defined?(apply_context_mode_override)
 
+AI_TOOL_OPTIONS = {
+  "1" => { key: :claude,   name: "Claude Code" },
+  "2" => { key: :cursor,   name: "Cursor" },
+  "3" => { key: :copilot,  name: "GitHub Copilot" },
+  "4" => { key: :windsurf, name: "Windsurf" },
+  "5" => { key: :opencode, name: "OpenCode" }
+}.freeze unless defined?(AI_TOOL_OPTIONS)
+
+def prompt_ai_tools
+  puts ""
+  puts "Which AI tools do you use? (select all that apply)"
+  puts ""
+  AI_TOOL_OPTIONS.each { |num, info| puts "  #{num}. #{info[:name]}" }
+  puts "  a. All of the above"
+  puts ""
+  print "Enter numbers separated by commas (e.g. 1,2) or 'a' for all: "
+  input = $stdin.gets&.strip&.downcase || "a"
+
+  selected = if input == "a" || input == "all" || input.empty?
+    AI_TOOL_OPTIONS.values.map { |t| t[:key] }
+  else
+    input.split(/[\s,]+/).filter_map { |n| AI_TOOL_OPTIONS[n]&.dig(:key) }
+  end
+
+  if selected.empty?
+    puts "No tools selected — using all."
+    selected = AI_TOOL_OPTIONS.values.map { |t| t[:key] }
+  end
+
+  names = AI_TOOL_OPTIONS.values.select { |t| selected.include?(t[:key]) }.map { |t| t[:name] }
+  puts "Selected: #{names.join(', ')}"
+  selected
+end unless defined?(prompt_ai_tools)
+
+def save_ai_tools_to_initializer(tools)
+  init_path = Rails.root.join("config/initializers/rails_ai_context.rb")
+  return unless File.exist?(init_path)
+
+  content = File.read(init_path)
+  tools_line = "  config.ai_tools = %i[#{tools.join(' ')}]"
+
+  if content.include?("config.ai_tools")
+    # Replace existing ai_tools line
+    content.sub!(/^.*config\.ai_tools.*$/, tools_line)
+  elsif content.include?("RailsAiContext.configure")
+    # Insert after configure block opening
+    content.sub!(/RailsAiContext\.configure do \|config\|\n/, "RailsAiContext.configure do |config|\n#{tools_line}\n")
+  else
+    return
+  end
+
+  File.write(init_path, content)
+  puts "💾 Saved to config/initializers/rails_ai_context.rb"
+rescue
+  nil
+end unless defined?(save_ai_tools_to_initializer)
+
 namespace :ai do
-  desc "Generate AI context files (CLAUDE.md, .cursor/rules/, .windsurfrules, .github/copilot-instructions.md)"
+  desc "Generate AI context files for configured AI tools (prompts on first run)"
   task context: :environment do
     require "rails_ai_context"
 
     apply_context_mode_override
 
+    ai_tools = RailsAiContext.configuration.ai_tools
+
+    # First time — no tools configured, ask the user
+    if ai_tools.nil?
+      ai_tools = prompt_ai_tools
+      save_ai_tools_to_initializer(ai_tools) if ai_tools
+    end
+
     puts "🔍 Introspecting #{Rails.application.class.module_parent_name}..."
 
-    puts "📝 Writing context files..."
-    result = RailsAiContext.generate_context(format: :all)
+    if ai_tools.nil? || ai_tools.empty?
+      puts "📝 Writing context files for all AI tools..."
+      result = RailsAiContext.generate_context(format: :all)
+      print_result(result)
+    else
+      puts "📝 Writing context files for: #{ai_tools.map(&:to_s).join(', ')}..."
+      ai_tools.each do |fmt|
+        result = RailsAiContext.generate_context(format: fmt)
+        print_result(result)
+      end
+    end
 
-    print_result(result)
     puts ""
-    puts "Done! Your AI assistants now understand your Rails app."
-    puts "Commit these files so your whole team benefits."
-    puts ""
-    puts ASSISTANT_TABLE
+    puts "Done! Commit these files so your team benefits."
+    puts "Change AI tools: config/initializers/rails_ai_context.rb (config.ai_tools)"
   end
 
   desc "Generate AI context in a specific format (claude, cursor, windsurf, copilot, json)"

data/lib/rails_ai_context/tools/get_routes.rb

@@ -168,7 +168,19 @@ module RailsAiContext
                   ctrl_lines << "- `#{r[:verb]}` `#{r[:path]}` → #{r[:action]}#{helper_part}#{params_part}"
                 end
                 if ctrl_lines.any?
-                  lines << "## #{ctrl}"
+                  # Inline controller summary so AI doesn't need a separate get_controllers call
+                  ctrl_class = "#{ctrl.camelize}Controller"
+                  ctrl_data = cached_context.dig(:controllers, :controllers, ctrl_class)
+                  ctrl_summary = ""
+                  if ctrl_data
+                    filters = (ctrl_data[:filters] || []).map { |f| f[:name] }.first(3)
+                    formats = ctrl_data[:respond_to_formats]
+                    parts = []
+                    parts << "filters: #{filters.join(', ')}" if filters.any?
+                    parts << "formats: #{formats.join(', ')}" if formats&.any?
+                    ctrl_summary = " (#{parts.join(' | ')})" if parts.any?
+                  end
+                  lines << "## #{ctrl}#{ctrl_summary}"
                   lines.concat(ctrl_lines)
                   lines << ""
                 end

data/lib/rails_ai_context/tools/get_schema.rb

@@ -144,7 +144,19 @@ module RailsAiContext
                 hint_str = hints.any? ? " [#{hints.join(', ')}]" : ""
                 "#{c[:name]}:#{c[:type]}#{hint_str}"
               end.join(", ")
-            lines << "### #{name}"
+            # Inline model info so AI doesn't need a separate get_model_details call
+            model_info = ""
+            if model_refs.any?
+              model_refs.each do |mname|
+                md = models_data[mname]
+                next unless md.is_a?(Hash) && !md[:error]
+                assoc_count = md[:associations]&.size || 0
+                val_count = md[:validations]&.size || 0
+                model_info = " → **#{mname}** (#{assoc_count} assoc, #{val_count} val)"
+                break
+              end
+            end
+            lines << "### #{name}#{model_info}"
             lines << cols
             lines << ""
           end

data/lib/rails_ai_context/tools/get_test_info.rb

@@ -76,6 +76,11 @@ module RailsAiContext
             lines << "" << "## Test Helpers"
             data[:test_helpers].each { |h| lines << "- `#{h}`" }
           end
+
+          # Generate a test template based on app patterns
+          template = generate_test_template(data)
+          lines.concat(template) if template.any?
+
           text_response(lines.join("\n"))
 
         when "full"
@@ -210,6 +215,89 @@ module RailsAiContext
         "No test file found for #{name}. Searched: #{candidates.join(', ')}#{hint}"
       end
 
+      # Generate a test template based on the app's actual test patterns
+      private_class_method def self.generate_test_template(data)
+        lines = []
+        framework = data[:framework]
+
+        if framework&.include?("RSpec") || framework&.include?("rspec")
+          lines << "" << "## Test Template (follow this pattern for new tests)"
+          lines << "```ruby"
+          lines << "require \"rails_helper\""
+          lines << ""
+          lines << "RSpec.describe ModelName, type: :model do"
+          lines << "  describe \"validations\" do"
+          lines << "    it { is_expected.to validate_presence_of(:field) }"
+          lines << "  end"
+          lines << ""
+          lines << "  describe \"#method_name\" do"
+          lines << "    it \"does something\" do"
+          lines << "      record = create(:model_name)"
+          lines << "      expect(record.method_name).to eq(expected)"
+          lines << "    end"
+          lines << "  end"
+          lines << "end"
+          lines << "```"
+        else
+          # Detect Devise + sign_in pattern from existing tests
+          has_devise = false
+          has_sign_in = false
+          test_dir = Rails.root.join("test")
+          if Dir.exist?(test_dir)
+            Dir.glob(File.join(test_dir, "**/*_test.rb")).first(5).each do |path|
+              content = File.read(path, encoding: "UTF-8") rescue next
+              has_devise = true if content.include?("Devise::Test")
+              has_sign_in = true if content.include?("sign_in")
+            end
+          end
+
+          lines << "" << "## Test Template (follow this pattern for new tests)"
+          lines << "```ruby"
+          lines << "require \"test_helper\""
+          lines << ""
+          lines << "class ModelNameTest < ActiveSupport::TestCase"
+          lines << "  test \"should be valid with required attributes\" do"
+          lines << "    record = model_names(:fixture_name)"
+          lines << "    assert record.valid?"
+          lines << "  end"
+          lines << ""
+          lines << "  test \"should require field\" do"
+          lines << "    record = ModelName.new"
+          lines << "    assert_not record.valid?"
+          lines << "    assert_includes record.errors[:field], \"can't be blank\""
+          lines << "  end"
+          lines << "end"
+          lines << "```"
+
+          if has_devise
+            lines << ""
+            lines << "```ruby"
+            lines << "# Controller test pattern"
+            lines << "require \"test_helper\""
+            lines << ""
+            lines << "class FeatureControllerTest < ActionDispatch::IntegrationTest"
+            lines << "  include Devise::Test::IntegrationHelpers" if has_devise
+            lines << ""
+            lines << "  test \"requires authentication\" do"
+            lines << "    get feature_path"
+            lines << "    assert_response :redirect"
+            lines << "  end"
+            lines << ""
+            lines << "  test \"shows page for signed in user\" do"
+            lines << "    sign_in users(:chef_one)" if has_sign_in
+            lines << "    get feature_path"
+            lines << "    assert_response :success"
+            lines << "  end"
+            lines << "end"
+            lines << "```"
+          end
+        end
+
+        lines
+      rescue
+        []
+      end
+
       # Parse factory file to extract attributes and traits
       private_class_method def self.parse_factory_details(relative_path)
         # Try common factory locations

data/lib/rails_ai_context/tools/get_view.rb

@@ -96,12 +96,14 @@ module RailsAiContext
 
             lines << "## #{ctrl}/" unless controller && all_dirs.size == 1
             ctrl_templates.sort.each do |name, meta|
-              parts = meta[:partials]&.any? ? " renders: #{meta[:partials].join(', ')}" : ""
-              stim = meta[:stimulus]&.any? ? " stimulus: #{meta[:stimulus].join(', ')}" : ""
+              detail_parts = []
+              detail_parts << "renders: #{meta[:partials].join(', ')}" if meta[:partials]&.any?
+              detail_parts << "stimulus: #{meta[:stimulus].join(', ')}" if meta[:stimulus]&.any?
               extra = extract_view_metadata(name)
-              ivars = extra[:ivars]&.any? ? " ivars: #{extra[:ivars].join(', ')}" : ""
-              turbo = extra[:turbo]&.any? ? " turbo: #{extra[:turbo].join(', ')}" : ""
-              lines << "- #{name} (#{meta[:lines]} lines)#{parts}#{stim}#{ivars}#{turbo}"
+              detail_parts << "ivars: #{extra[:ivars].join(', ')}" if extra[:ivars]&.any?
+              detail_parts << "turbo: #{extra[:turbo].join(', ')}" if extra[:turbo]&.any?
+              details = detail_parts.any? ? " — #{detail_parts.join(' | ')}" : ""
+              lines << "- **#{name}** (#{meta[:lines]} lines)#{details}"
             end
             ctrl_partials.sort.each do |name, meta|
               fields = meta[:fields]&.any? ? " fields: #{meta[:fields].join(', ')}" : ""