rails-ai-context 4.2.3 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5a6ff4a0b32e6be5d9109b7c603f3b7ae097cf97439f8b7a219ee374a62469d
-  data.tar.gz: f80ea797a13825703b45ced9c9f2b94544f1c00774f00cec683194a19af8d3b9
+  metadata.gz: 7cd3960b55660ccf3b1c8da3c6af0aeef18ba57a9a906f02cd136b976bf66976
+  data.tar.gz: '0185228442a21266ba75f01375d8883dc176b6b140b764e59aafa8044fa7faed'
 SHA512:
-  metadata.gz: 370160ebbbcd9bca03eb55171474b017c23235a7211f46ba5df52e64a33fdf3fa470acd38952a422ec7ccca770377d8415e8f0011a101622a15b3db1e5a98ee4
-  data.tar.gz: 07df46d61e556d7290ad8768d3ecb6fc7ef3d9498c6fe646791d12c05794bfec258f15085571ae3c09aa8b10ff517b7aa5b372964f5708ad2190675c21bacfc4
+  metadata.gz: 117c13423c12bd5e4a204290716639c5f30fcd960290c5cd3535c5b37911567f7678341bb15f5dcff88e75f6c321a740fe8c4d7adb0a5d5a5936aa2c8b679bc0
+  data.tar.gz: 101b71249f3e49a40ec0bd8417a71bd76ea7b1907b36d94abf4182ead812fd76f33e9b353c9b14f1e78de680f6a1eeebf0659097cc3ec7afe4f06e7b48bf2017

data/CHANGELOG.md

@@ -5,6 +5,22 @@ 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).
 
+## [4.3.0] — 2026-04-01
+
+### Added
+- **`rails_onboard`** — narrative app walkthrough (quick/standard/full) for new developers and AI agents: stack, data model, authentication, key flows, jobs, frontend, testing, getting started
+- **`rails_generate_test`** — generates test scaffolding matching project patterns: detects framework (RSpec/Minitest), factories vs fixtures, assertion style, Devise helpers; covers validations, associations, scopes, enums, request specs with routes
+- **`rails_diagnose`** — one-call error diagnosis: parses error → classifies (nil_reference, record_not_found, validation_failure, routing, strong_params, schema_mismatch) → gathers controller/model/schema context → shows recent git changes → pulls error logs → suggests fix
+- **`rails_review_changes`** — PR/commit review context: classifies changed files, pulls per-file context (model → schema, controller → routes, migration → affected models), detects warnings (missing indexes, removed validations, no test changes)
+- **Improved AI instructions** — workflow sequencing (step-by-step tool call order), `detail` parameter guidance, anti-patterns section, `get_context` promoted as power tool, app-specific footer rules from conventions introspector
+- **Compact tool name list** — root files (CLAUDE.md, AGENTS.md) now include all 37 tool names in a dense format that fits within the 150-line compact mode limit
+
+### Changed
+- Tool count: 33 → 37
+- Test count: 1016 → 1052
+- Root file render order: commands and rules before tool guide to prevent truncation
+- Cursor rules description: fixed stale "25 tools" → "37 tools"
+
 ## [4.2.3] — 2026-04-01
 
 ### Fixed

data/CLAUDE.md

@@ -9,7 +9,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 - `lib/rails_ai_context/configuration.rb` — User-facing config with presets (:standard, :full)
 - `lib/rails_ai_context/introspector.rb` — Orchestrates sub-introspectors
 - `lib/rails_ai_context/introspectors/` — 33 introspectors (schema, models, routes, jobs, gems, conventions, stimulus, database_stats, controllers, views, view_templates, design_tokens, turbo, i18n, config, active_storage, action_text, auth, api, tests, rake_tasks, assets, devops, action_mailbox, migrations, seeds, middleware, engines, multi_database, components, accessibility, performance, frontend_frameworks)
-- `lib/rails_ai_context/tools/` — 33 MCP tools using the official mcp SDK
+- `lib/rails_ai_context/tools/` — 37 MCP tools using the official mcp SDK
 - `lib/rails_ai_context/cli/` — CLI tool runner (`tool_runner.rb`) — executes MCP tools from rake/Thor
 - `lib/rails_ai_context/serializers/` — Output formatters (claude, claude_rules, opencode, opencode_rules, cursor_rules, copilot, copilot_instructions, rules, markdown, JSON, context_file_serializer, test_command_detection, tool_guide_helper, design_system_helper, stack_overview_helper)
 - `lib/rails_ai_context/resources.rb` — MCP resources (static data AI clients read directly)
@@ -40,12 +40,12 @@ structure to AI assistants via the Model Context Protocol (MCP).
 13. **Per-tool split rules** — `.claude/rules/`, `.cursor/rules/`, `.github/instructions/`
 14. **Section markers** — root file content wrapped in `<!-- BEGIN/END rails-ai-context -->` to preserve user content
 15. **generate_root_files toggle** — when false, skip root files (CLAUDE.md, etc.), only generate split rules
-16. **custom_tools API** — `config.custom_tools` array lets users register additional MCP::Tool subclasses alongside the 33 built-in tools
+16. **custom_tools API** — `config.custom_tools` array lets users register additional MCP::Tool subclasses alongside the 37 built-in tools
 17. **Design system extraction** — view templates analyzed for canonical examples, color palette, typography, responsive patterns, interactive states, dark mode
 18. **skip_tools API** — `config.skip_tools` array lets users exclude specific built-in tools (e.g. `%w[rails_security_scan]`)
 19. **Security scanning** — optional Brakeman integration via `rails_security_scan` tool (graceful degradation if not installed)
 20. **tool_mode config** — `:mcp` (default, MCP primary + CLI fallback) or `:cli` (CLI only, no MCP server needed). Selected during install.
-21. **CLI tool access** — all 33 MCP tools callable from terminal: `rails ai:tool[schema]`, `rails-ai-context tool schema`. Tool name resolution: `schema` → `get_schema` → `rails_get_schema`.
+21. **CLI tool access** — all 37 MCP tools callable from terminal: `rails ai:tool[schema]`, `rails-ai-context tool schema`. Tool name resolution: `schema` → `get_schema` → `rails_get_schema`.
 22. **Shared ToolGuideHelper** — serializers use a shared module for tool reference sections, rendering MCP or CLI syntax based on `tool_mode`
 23. **Component catalog** — ViewComponent/Phlex introspection: props, slots, previews, sidecar assets, usage examples via `rails_get_component_catalog`
 24. **Accessibility scanning** — ARIA attributes, semantic HTML, screen reader text, alt text, landmark roles, accessibility score via AccessibilityIntrospector
@@ -60,7 +60,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (1016 examples)
+bundle exec rspec           # Run specs (1052 examples)
 bundle exec rubocop         # Lint
 ```
 

data/CONTRIBUTING.md

@@ -20,7 +20,7 @@ The test suite uses [Combustion](https://github.com/pat/combustion) to boot a mi
 lib/rails_ai_context/
 ├── cli/               # CLI tool runner (tool_runner.rb) — executes MCP tools from rake/Thor
 ├── introspectors/     # 33 introspectors (schema, models, routes, etc.)
-├── tools/             # 33 MCP tools with detail levels and pagination
+├── tools/             # 37 MCP tools with detail levels and pagination
 ├── serializers/       # Per-assistant formatters + shared ToolGuideHelper
 ├── server.rb          # MCP server setup (stdio + HTTP)
 ├── live_reload.rb     # MCP live reload (file watcher + cache invalidation)

data/README.md

@@ -8,19 +8,19 @@
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-green)](https://registry.modelcontextprotocol.io)
 [![Ruby](https://img.shields.io/badge/Ruby-3.2%20%7C%203.3%20%7C%203.4-red)](https://github.com/crisnahine/rails-ai-context)
 [![Rails](https://img.shields.io/badge/Rails-7.1%20%7C%207.2%20%7C%208.0-red)](https://github.com/crisnahine/rails-ai-context)
-[![Tests](https://img.shields.io/badge/Tests-1016%20passing-brightgreen)](https://github.com/crisnahine/rails-ai-context/actions)
+[![Tests](https://img.shields.io/badge/Tests-1052%20passing-brightgreen)](https://github.com/crisnahine/rails-ai-context/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 **Works with:** Claude Code • Cursor • GitHub Copilot • OpenCode • Any terminal
 
-> Built by a Rails developer with 10+ years of production experience. AI assisted — the same way it assists me shipping features at work. I designed the architecture, made every decision, reviewed every line, and wrote 1016 tests. This gem exists because I understand Rails deeply enough to know exactly what AI agents get wrong and what context they need to get it right.
+> Built by a Rails developer with 10+ years of production experience. AI assisted — the same way it assists me shipping features at work. I designed the architecture, made every decision, reviewed every line, and wrote 1052 tests. This gem exists because I understand Rails deeply enough to know exactly what AI agents get wrong and what context they need to get it right.
 
 ```bash
 gem "rails-ai-context", group: :development
 rails generate rails_ai_context:install
 ```
 
-That's it. Your AI now has 33 tools that understand your entire Rails app — via MCP server or CLI. Zero config.
+That's it. Your AI now has 37 tools that understand your entire Rails app — via MCP server or CLI. Zero config.
 
 > **[Full Guide →](docs/GUIDE.md)** — every command, every parameter, every configuration option.
 
@@ -50,7 +50,7 @@ rails 'ai:tool[schema]' table=users
 rails 'ai:tool[analyze_feature]' feature=billing
 ```
 
-Same 33 tools. Same output. AI agents run these as shell commands. **Works in any terminal, any AI tool, any workflow.** No MCP client required.
+Same 37 tools. Same output. AI agents run these as shell commands. **Works in any terminal, any AI tool, any workflow.** No MCP client required.
 
 ---
 
@@ -174,7 +174,7 @@ Tested on a real Rails 8 app (5 models, 19 controllers, 95 routes):
 
 ---
 
-## 33 Tools
+## 37 Tools
 
 Every tool is **read-only** and returns structured, token-efficient data.
 
@@ -246,7 +246,7 @@ Every tool is **read-only** and returns structured, token-efficient data.
          ▼                  ▼              ▼
 ┌──────────────────┐ ┌────────────┐ ┌────────────────────┐
 │  Static Files     │ │  MCP Server │ │  CLI Tools          │
-│  CLAUDE.md        │ │  33 tools   │ │  Same 33 tools      │
+│  CLAUDE.md        │ │  37 tools   │ │  Same 37 tools      │
 │  .cursor/rules/   │ │  stdio/HTTP │ │  No server needed   │
 │  .github/instr... │ │  .mcp.json  │ │  rails 'ai:tool[X]' │
 └──────────────────┘ └────────────┘ └────────────────────┘
@@ -282,7 +282,7 @@ MCP auto-discovery: `.mcp.json` is detected automatically by Claude Code and Cur
 | Command | What it does |
 |---------|-------------|
 | `rails ai:context` | Generate context files for your AI tools |
-| `rails 'ai:tool[NAME]'` | Run any of the 33 tools from the CLI |
+| `rails 'ai:tool[NAME]'` | Run any of the 37 tools from the CLI |
 | `rails ai:tool` | List all available tools with short names |
 | `rails ai:serve` | Start MCP server (stdio) |
 | `rails ai:doctor` | Diagnostics + AI readiness score |

data/SECURITY.md

@@ -26,7 +26,7 @@ If you discover a security vulnerability in rails-ai-context, please report it r
 
 ## Security Design
 
-- All 33 MCP tools are **read-only** and never modify your application or database.
+- All 37 MCP tools are **read-only** and never modify your application or database.
 - **Sensitive file blocking** — configurable `sensitive_patterns` blocks access to `.env`, `*.key`, `*.pem`, `credentials.yml.enc` across all search and read tools. Patterns are checked in `rails_search_code`, `rails_get_edit_context`, and all new tools.
 - **Path traversal protection** — all file-reading tools validate paths with `File.realpath()` against `Rails.root` to prevent directory escape.
 - **Command injection prevention** — code search uses `Open3.capture2` with array arguments (never shell strings). The `--` flag separator prevents pattern injection.

data/docs/GUIDE.md

@@ -252,7 +252,7 @@ rails ai:context:claude           # Use this instead (no quoting needed)
 
 ## CLI Tools
 
-All 33 MCP tools can be run directly from the terminal — no MCP server or AI client needed.
+All 37 MCP tools can be run directly from the terminal — no MCP server or AI client needed.
 
 ### Rake
 
@@ -316,7 +316,7 @@ The `tool_mode` is selected during `rails generate rails_ai_context:install`.
 
 ## MCP Tools — Full Reference
 
-All 33 tools are **read-only** and **idempotent** — they never modify your application or database.
+All 37 tools are **read-only** and **idempotent** — they never modify your application or database.
 
 ### rails_get_schema
 
@@ -1117,7 +1117,7 @@ RailsAiContext.configure do |config|
 end
 ```
 
-Both transports are **read-only** — they expose the same 33 tools and never modify your app.
+Both transports are **read-only** — they expose the same 37 tools and never modify your app.
 
 ---
 

data/lib/generators/rails_ai_context/install/install_generator.rb

@@ -436,9 +436,9 @@ module RailsAiContext
         say ""
         say "Commands:", :yellow
         say "  rails ai:context         # Regenerate context files"
-        say "  rails 'ai:tool[schema]'    # Run any of the 33 tools from CLI"
+        say "  rails 'ai:tool[schema]'    # Run any of the 37 tools from CLI"
         if @tool_mode == :mcp
-          say "  rails ai:serve           # Start MCP server (33 live tools)"
+          say "  rails ai:serve           # Start MCP server (37 live tools)"
         end
         say "  rails ai:doctor          # Check AI readiness"
         say "  rails ai:inspect         # Print introspection summary"

data/lib/rails_ai_context/serializers/claude_serializer.rb

@@ -35,10 +35,10 @@ module RailsAiContext
         lines.concat(render_notable_gems)
         lines.concat(render_architecture)
         lines.concat(render_ui_patterns)
-        lines.concat(render_mcp_guide)
-        lines.concat(render_conventions)
         lines.concat(render_commands)
         lines.concat(render_footer)
+        lines.concat(render_conventions)
+        lines.concat(render_mcp_guide_compact)
 
         # Enforce max lines
         max = RailsAiContext.configuration.claude_max_lines
@@ -202,6 +202,10 @@ module RailsAiContext
         render_tools_guide
       end
 
+      def render_mcp_guide_compact
+        render_tools_guide_compact
+      end
+
       def render_conventions
         conv = context[:conventions]
         return [] unless conv.is_a?(Hash) && !conv[:error]
@@ -227,15 +231,30 @@ module RailsAiContext
       end
 
       def render_footer
-        [
-          "## Rules",
-          "- Follow existing patterns and conventions",
-          "- Match existing code style",
-          "- Run tests after changes",
-          "- Do NOT re-read files to verify edits — trust your Edit, validate syntax only",
-          "- Stimulus controllers auto-register — no manual import in controllers/index.js needed",
-          ""
-        ]
+        test_cmd = detect_test_command
+        lines = [ "## Rules" ]
+        lines << "- Run `#{test_cmd}` after changes"
+        lines << "- Do NOT re-read files to verify edits — trust your Edit, validate syntax only"
+
+        # App-specific conventions from introspection
+        conv = context[:conventions]
+        if conv.is_a?(Hash) && !conv[:error]
+          arch = conv[:architecture] || []
+          lines << "- Follow #{arch.join(' + ')} architecture" if arch.any?
+          patterns = conv[:patterns] || []
+          lines << "- Use service objects for business logic" if patterns.include?("service_objects")
+          lines << "- Use form objects for complex forms" if patterns.include?("form_objects")
+          lines << "- Use query objects for complex queries" if patterns.include?("query_objects")
+        end
+
+        # Stimulus auto-register if detected
+        stimulus = context[:stimulus]
+        if stimulus.is_a?(Hash) && !stimulus[:error] && (stimulus[:controllers]&.any? || stimulus[:total_controllers]&.positive?)
+          lines << "- Stimulus controllers auto-register — no manual import in controllers/index.js needed"
+        end
+
+        lines << ""
+        lines
       end
     end
 

data/lib/rails_ai_context/serializers/cursor_rules_serializer.rb

@@ -255,7 +255,7 @@ module RailsAiContext
       def render_mcp_tools_rule
         lines = [
           "---",
-          "description: \"Rails tools (25) — MANDATORY, use before reading any reference files\"",
+          "description: \"Rails tools (37) — MANDATORY, use before reading any reference files\"",
           "alwaysApply: true",
           "---",
           ""

data/lib/rails_ai_context/serializers/opencode_serializer.rb

@@ -35,9 +35,9 @@ module RailsAiContext
         lines.concat(render_notable_gems)
         lines.concat(render_architecture)
         lines.concat(render_ui_patterns)
-        lines.concat(render_mcp_guide)
-        lines.concat(render_conventions)
         lines.concat(render_commands)
+        lines.concat(render_conventions)
+        lines.concat(render_mcp_guide_compact)
         lines.concat(render_footer)
 
         # Enforce max lines
@@ -168,6 +168,10 @@ module RailsAiContext
         render_tools_guide
       end
 
+      def render_mcp_guide_compact
+        render_tools_guide_compact
+      end
+
       def render_conventions
         conv = context[:conventions]
         return [] unless conv.is_a?(Hash) && !conv[:error]