rails-ai-context 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06aa759cd0c6214756b038ed582232f6b6b1e997c35bda3c69b5bb3288c9ae6c
-  data.tar.gz: 44f40ae646ad5706747f35c7ffb03aa36ccb4be65a205aaad989d5081c446fbb
+  metadata.gz: dc7244d020376cc416232a1cbbc0a287866dc4243b9566e4fa2d50d556e5a1c6
+  data.tar.gz: 5251eb33ca4d3f72803e3acc77d272a4ec038c9a367390752db463195126675a
 SHA512:
-  metadata.gz: 34dbfb450c700d0f3520b3e345e38beea105acdc1775e5a1e2b3c68bbd337325f21ef22c4d493a47142a01bf258f07ce1409e7b3933396136954e82be93962e6
-  data.tar.gz: b1bb5feb20affb165a194a2cbcd39be37caac1b8b2552a2a528a30114c2d2dc450e61f962d9b9d98b7acc24a7b2b0329b41dde6a677b713c85ec102046f9e0a3
+  metadata.gz: ddda0c23e18344f9b95d4ff2b0e5ce9dba9c247a2915a1337226f98fb1ef2ab83b07370e2baf26bbb25261241baf75ccf40c952dd03cae4d6b6004c93398c14f
+  data.tar.gz: 790dc32dffed8275469eaebae74491dcaa0dbc2b979e53fc8e959b889c69c2eec6982304a1d0d39e22900e79a0214743cf616a8f4e70bea8a4797be679be9c9c

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2026-03-23
+
+### Added
+
+- **Full-preset stack overview in all serializers** — compact mode now surfaces summary lines for auth, Hotwire/Turbo, API, I18n, ActiveStorage, ActionText, assets, engines, and multi-database in generated context files (CLAUDE.md, AGENTS.md, .windsurfrules, and all split rules). Previously this data was only available via MCP tools.
+- **`rails_analyze_feature` in all tool reference sections** — the 14th tool (added in v1.0.0) was missing from serializer output. Now listed in all generated files across Claude, Cursor, Windsurf, Copilot, and OpenCode formats.
+
+### Fixed
+
+- **Tool count corrected from 13 to 14** across all serializers to reflect `rails_analyze_feature` added in v1.0.0.
+
 ## [1.1.0] - 2026-03-23
 
 ### Changed

data/SECURITY.md

@@ -4,7 +4,7 @@
 
 | Version | Supported          |
 |---------|--------------------|
-| 1.1.x   | :white_check_mark: |
+| 1.1.x    | :white_check_mark: |
 | 1.0.x   | :white_check_mark: |
 | < 1.0   | :x:                |
 

data/lib/rails_ai_context/serializers/claude_rules_serializer.rb

@@ -5,6 +5,8 @@ module RailsAiContext
     # Generates .claude/rules/ files for Claude Code auto-discovery.
     # These provide quick-reference lists without bloating CLAUDE.md.
     class ClaudeRulesSerializer
+      include StackOverviewHelper
+
       attr_reader :context
 
       def initialize(context)
@@ -77,6 +79,8 @@ module RailsAiContext
           (conv[:architecture] || []).first(5).each { |p| lines << "- #{p}" }
         end
 
+        lines.concat(full_preset_stack_lines)
+
         # ApplicationController before_actions — apply to all controllers
         begin
           root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
@@ -342,7 +346,7 @@ module RailsAiContext
           "- app/javascript/controllers/index.js — Stimulus auto-registers controllers. No need to read.",
           "- Test files — use `rails_get_test_info(detail:\"full\")` for patterns.",
           "",
-          "## Tools (13)",
+          "## Tools (14)",
           "",
           "**rails_get_schema** — database tables, columns, indexes, foreign keys",
           "- `rails_get_schema(detail:\"summary\")` — all tables with column counts",
@@ -380,6 +384,9 @@ module RailsAiContext
           "**rails_validate** — syntax checker for edited files",
           "- `rails_validate(files:[\"app/models/cook.rb\"])` — checks Ruby, ERB, JS syntax in one call",
           "",
+          "**rails_analyze_feature** — combined schema + models + controllers + routes for a feature area",
+          "- `rails_analyze_feature(feature:\"authentication\")` — one call gets everything related to a feature",
+          "",
           "**rails_get_config** — cache store, session, timezone, middleware, initializers",
           "**rails_get_gems** — notable gems categorized by function",
           "**rails_get_conventions** — architecture patterns, directory structure",

data/lib/rails_ai_context/serializers/claude_serializer.rb

@@ -7,6 +7,7 @@ module RailsAiContext
     # In :full mode, delegates to MarkdownSerializer with behavioral rules.
     class ClaudeSerializer
       include TestCommandDetection
+      include StackOverviewHelper
 
       attr_reader :context
 
@@ -79,16 +80,6 @@ module RailsAiContext
           lines << "- Routes: #{routes[:total_routes]} across #{app_ctrls.size} controllers"
         end
 
-        auth = context[:auth]
-        if auth.is_a?(Hash) && !auth[:error]
-          parts = []
-          parts << "Devise" if auth.dig(:authentication, :devise)&.any?
-          parts << "Rails 8 auth" if auth.dig(:authentication, :rails_auth)
-          parts << "Pundit" if auth.dig(:authorization, :pundit)&.any?
-          parts << "CanCanCan" if auth.dig(:authorization, :cancancan)
-          lines << "- Auth: #{parts.join(' + ')}" if parts.any?
-        end
-
         jobs = context[:jobs]
         if jobs.is_a?(Hash) && !jobs[:error]
           job_count = jobs[:jobs]&.size || 0
@@ -107,6 +98,8 @@ module RailsAiContext
           lines << "- Migrations: #{migrations[:total]} total, #{pending&.size || 0} pending"
         end
 
+        lines.concat(full_preset_stack_lines)
+
         lines << ""
         lines
       end
@@ -232,7 +225,7 @@ module RailsAiContext
 
       def render_mcp_guide # rubocop:disable Metrics/MethodLength
         [
-          "## MCP Tools (13) — ALWAYS Use These First",
+          "## MCP Tools (14) — ALWAYS Use These First",
           "",
           "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
           "MCP tools return line numbers. Start with `detail:\"summary\"`.",
@@ -244,6 +237,7 @@ module RailsAiContext
           "- `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_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
           "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`",
           "- `rails_validate(files:[\"path/to/file.rb\"])` — validate Ruby, ERB, JS syntax in one call",
           ""

data/lib/rails_ai_context/serializers/copilot_instructions_serializer.rb

@@ -5,6 +5,8 @@ module RailsAiContext
     # Generates .github/instructions/*.instructions.md files with applyTo frontmatter
     # for GitHub Copilot path-specific instructions.
     class CopilotInstructionsSerializer
+      include StackOverviewHelper
+
       attr_reader :context
 
       def initialize(context)
@@ -79,6 +81,8 @@ module RailsAiContext
           (conv[:architecture] || []).first(5).each { |p| lines << "- #{arch_labels[p] || p}" }
         end
 
+        lines.concat(full_preset_stack_lines)
+
         # List service objects
         begin
           root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
@@ -241,7 +245,7 @@ module RailsAiContext
           "applyTo: \"**/*\"",
           "---",
           "",
-          "# Rails MCP Tools (13) — Use These First",
+          "# Rails MCP Tools (14) — Use These First",
           "",
           "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
           "MCP tools return line numbers for surgical edits.",
@@ -254,6 +258,7 @@ module RailsAiContext
           "- `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\")` — existing tests",
+          "- `rails_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
           "- `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",

data/lib/rails_ai_context/serializers/copilot_serializer.rb

@@ -7,6 +7,7 @@ module RailsAiContext
     # In :full mode, delegates to MarkdownSerializer with Copilot header.
     class CopilotSerializer
       include TestCommandDetection
+      include StackOverviewHelper
 
       attr_reader :context
 
@@ -44,6 +45,8 @@ module RailsAiContext
           lines << "- Routes: #{routes[:total_routes]} across #{(routes[:by_controller] || {}).size} controllers"
         end
 
+        lines.concat(full_preset_stack_lines)
+
         # Gems by category
         gems = context[:gems]
         if gems.is_a?(Hash) && !gems[:error]

data/lib/rails_ai_context/serializers/cursor_rules_serializer.rb

@@ -6,6 +6,8 @@ module RailsAiContext
     # Each file is focused, <50 lines, with YAML frontmatter.
     # .cursorrules is deprecated by Cursor; this is the recommended format.
     class CursorRulesSerializer
+      include StackOverviewHelper
+
       attr_reader :context
 
       def initialize(context)
@@ -87,6 +89,8 @@ module RailsAiContext
           (conv[:architecture] || []).first(5).each { |p| lines << "- #{arch_labels[p] || p}" }
         end
 
+        lines.concat(full_preset_stack_lines)
+
         # List service objects
         begin
           root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
@@ -269,7 +273,7 @@ module RailsAiContext
           "alwaysApply: true",
           "---",
           "",
-          "# Rails MCP Tools (13) — Use These First",
+          "# Rails MCP Tools (14) — Use These First",
           "",
           "Use MCP for reference files (schema, routes, tests). Read files directly if you'll edit them.",
           "MCP tools return line numbers for surgical edits.",
@@ -281,6 +285,7 @@ module RailsAiContext
           "- `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_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",

data/lib/rails_ai_context/serializers/opencode_serializer.rb

@@ -7,6 +7,7 @@ module RailsAiContext
     # In :full mode, delegates to MarkdownSerializer with OpenCode header.
     class OpencodeSerializer
       include TestCommandDetection
+      include StackOverviewHelper
 
       attr_reader :context
 
@@ -78,16 +79,6 @@ module RailsAiContext
           lines << "- Routes: #{routes[:total_routes]} across #{app_ctrls.size} controllers"
         end
 
-        auth = context[:auth]
-        if auth.is_a?(Hash) && !auth[:error]
-          parts = []
-          parts << "Devise" if auth.dig(:authentication, :devise)&.any?
-          parts << "Rails 8 auth" if auth.dig(:authentication, :rails_auth)
-          parts << "Pundit" if auth.dig(:authorization, :pundit)&.any?
-          parts << "CanCanCan" if auth.dig(:authorization, :cancancan)
-          lines << "- Auth: #{parts.join(" + ")}" if parts.any?
-        end
-
         jobs = context[:jobs]
         if jobs.is_a?(Hash) && !jobs[:error]
           job_count = jobs[:jobs]&.size || 0
@@ -106,6 +97,8 @@ module RailsAiContext
           lines << "- Migrations: #{migrations[:total]} total, #{pending&.size || 0} pending"
         end
 
+        lines.concat(full_preset_stack_lines)
+
         lines << ""
         lines
       end
@@ -186,7 +179,7 @@ module RailsAiContext
 
       def render_mcp_guide # rubocop:disable Metrics/MethodLength
         [
-          "## MCP Tools (13) — ALWAYS Use These First",
+          "## MCP Tools (14) — ALWAYS Use These First",
           "",
           "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
           "MCP tools return line numbers. Start with `detail:\"summary\"`.",
@@ -199,6 +192,7 @@ module RailsAiContext
           "- `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_validate(files:[...])` — batch syntax check for Ruby, ERB, JS",
           "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`",
           ""

data/lib/rails_ai_context/serializers/stack_overview_helper.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Serializers
+    # Shared helper for rendering stack overview lines from full-preset introspectors.
+    # Include in any serializer that has a `context` reader and renders a project overview.
+    module StackOverviewHelper
+      # Returns an array of summary lines for full-preset introspectors.
+      # Each line is only added if the introspector returned meaningful data.
+      def full_preset_stack_lines(ctx = context)
+        lines = []
+
+        auth = ctx[:auth]
+        if auth.is_a?(Hash) && !auth[:error]
+          parts = []
+          parts << "Devise" if auth.dig(:authentication, :devise)&.any?
+          parts << "Rails 8 auth" if auth.dig(:authentication, :rails_auth)
+          parts << "Pundit" if auth.dig(:authorization, :pundit)&.any?
+          parts << "CanCanCan" if auth.dig(:authorization, :cancancan)
+          lines << "- Auth: #{parts.join(' + ')}" if parts.any?
+        end
+
+        turbo = ctx[:turbo]
+        if turbo.is_a?(Hash) && !turbo[:error]
+          parts = []
+          parts << "#{(turbo[:frames] || []).size} frames" if turbo[:frames]&.any?
+          parts << "#{(turbo[:streams] || []).size} streams" if turbo[:streams]&.any?
+          parts << "broadcasts" if turbo[:broadcasts]&.any?
+          lines << "- Hotwire: #{parts.join(', ')}" if parts.any?
+        end
+
+        api = ctx[:api]
+        if api.is_a?(Hash) && !api[:error]
+          parts = []
+          parts << "API-only" if api[:api_only]
+          parts << "#{(api[:versions] || []).size} versions" if api[:versions]&.any?
+          parts << "GraphQL" if api[:graphql]&.any?
+          parts << api[:serializer_library] if api[:serializer_library]
+          lines << "- API: #{parts.join(', ')}" if parts.any?
+        end
+
+        i18n_data = ctx[:i18n]
+        if i18n_data.is_a?(Hash) && !i18n_data[:error]
+          locales = i18n_data[:available_locales] || []
+          lines << "- I18n: #{locales.size} locales (#{locales.first(5).join(', ')})" if locales.size > 1
+        end
+
+        storage = ctx[:active_storage]
+        if storage.is_a?(Hash) && !storage[:error] && storage[:attachments]&.any?
+          lines << "- Storage: ActiveStorage (#{storage[:attachments].size} models with attachments)"
+        end
+
+        action_text = ctx[:action_text]
+        if action_text.is_a?(Hash) && !action_text[:error] && action_text[:rich_text_fields]&.any?
+          lines << "- RichText: ActionText (#{action_text[:rich_text_fields].size} fields)"
+        end
+
+        assets = ctx[:assets]
+        if assets.is_a?(Hash) && !assets[:error]
+          parts = []
+          parts << assets[:pipeline] if assets[:pipeline]
+          parts << assets[:js_bundler] if assets[:js_bundler]
+          parts << assets[:css_framework] if assets[:css_framework]
+          lines << "- Assets: #{parts.join(', ')}" if parts.any?
+        end
+
+        engines = ctx[:engines]
+        if engines.is_a?(Hash) && !engines[:error] && engines[:mounted]&.any?
+          names = engines[:mounted].map { |e| e[:name] || e[:engine] }.compact.first(5)
+          lines << "- Engines: #{names.join(', ')}" if names.any?
+        end
+
+        multi_db = ctx[:multi_database]
+        if multi_db.is_a?(Hash) && !multi_db[:error] && multi_db[:databases]&.size.to_i > 1
+          lines << "- Databases: #{multi_db[:databases].size} (#{multi_db[:databases].keys.first(3).join(', ')})"
+        end
+
+        lines
+      end
+    end
+  end
+end

data/lib/rails_ai_context/serializers/windsurf_rules_serializer.rb

@@ -101,7 +101,7 @@ module RailsAiContext
 
       def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
         lines = [
-          "# Rails MCP Tools (13) — Use These First",
+          "# Rails MCP Tools (14) — Use These First",
           "",
           "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
           "",
@@ -112,6 +112,7 @@ module RailsAiContext
           "- 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_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",

data/lib/rails_ai_context/serializers/windsurf_serializer.rb

@@ -6,6 +6,7 @@ module RailsAiContext
     # Always produces compact output regardless of context_mode.
     class WindsurfSerializer
       include TestCommandDetection
+      include StackOverviewHelper
 
       MAX_CHARS = 5_800 # Leave buffer below 6K limit
 
@@ -42,6 +43,8 @@ module RailsAiContext
         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]
@@ -165,6 +168,7 @@ module RailsAiContext
         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_validate(files:[\"path\"])"
         lines << "Start with detail:\"summary\", then drill into specifics."
         lines << ""

data/lib/rails_ai_context/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAiContext
-  VERSION = "1.1.0"
+  VERSION = "1.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - crisnahine
@@ -240,6 +240,7 @@ files:
 - lib/rails_ai_context/serializers/opencode_rules_serializer.rb
 - lib/rails_ai_context/serializers/opencode_serializer.rb
 - 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