rails-ai-context 0.15.4 → 0.15.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df16cb513ad22c8fca7405fed9a9b111e7018184e1bd16cd08230dace76a9612
-  data.tar.gz: c4846d86197db0fe697b21cd23ead829a4433abfe444b0a14695433a5ab3d0f0
+  metadata.gz: 0eb46f9da0fc24418021dbb2ca4a6850017ab555ac0bbe98b589777ef30593a2
+  data.tar.gz: 5b77c8e0b1c7832c17ea84fffdc96524060fc594e4691f11a84b5e010158f925
 SHA512:
-  metadata.gz: dd8e4f99421b6efbc1b589734c03dbf3f167ec6a2779957a357f2924a9ac3bccd3d40c5c8aca442d92e9392cfed40d517b20455f7e9a9dd2f792c543c3c13928
-  data.tar.gz: f970c8cf22b53531143352ea4a8a90d615dbe7530a2a70eabd04dd7fd9e532119a803260681dbb431278ad6bfdc7103e82b487840514afd0c49b4c792e3ce8df
+  metadata.gz: 13a6f6e8e274cf47210b6cb94f160ba00e4cebe3349eb6c1e2612b4ec53561ab87d99690c9949c4eae389427bf7e80850b1c5a930283792bfa3294010303ec04
+  data.tar.gz: 5ae9e78447e0ec33496b608729be0088bf57f180a37f27690f7eaa0b6ca0a3c1a6637887a747d3de67bec808636a139be88e2b9ba72e71db0e07faa156541182

data/CHANGELOG.md

@@ -5,6 +5,35 @@ 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).
 
+## [0.15.6] - 2026-03-22
+
+### Added
+
+- **7 new configurable options** — `excluded_controllers`, `excluded_route_prefixes`, `excluded_concerns`, `excluded_filters`, `excluded_middleware`, `search_extensions`, `concern_paths` for stack-specific customization.
+- **Configurable file size limits** — `max_file_size`, `max_test_file_size`, `max_schema_file_size`, `max_view_total_size`, `max_view_file_size`, `max_search_results`, `max_validate_files` all exposed via `Configuration`.
+- **Class methods in model detail** — `rails_get_model_details` now shows class methods section.
+- **Custom validate methods** — `validate :method_name` calls extracted from source and shown in model detail.
+
+### Fixed
+
+- **Schema defaults always visible** — Null and Default columns always shown (NOT NULL marked bold). Previous token-saving logic accidentally hid critical migration data.
+- **Optional associations** — `belongs_to` with `optional: true` now shows `[optional]` flag.
+- **Concern methods inline** — shows public methods from concern source files (e.g. `PlanLimitable — can_cook?, increment_cook_count!`).
+- **MCP tool error messages** — all tools now show available values on error/not-found for AI self-correction.
+
+## [0.15.5] - 2026-03-22
+
+### Fixed
+
+- **ERB validation** — now catches missing `<% end %>` by compiling ERB to Ruby then syntax-checking the result (was only checking ERB tag syntax).
+- **Controller namespace format** — accepts both `Bonus::CrisesController` and `bonus/crises` (cross-tool consistency).
+- **Layouts discoverable** — `controller:"layouts"` now works in view tool.
+- **Validate error detail** — Ruby shows up to 5 error lines, JS shows 3 (was truncated to 1).
+- **Invalid/empty regex** — early validation with clear error messages instead of silent fail.
+- **Route count accuracy** — shows filtered count when `app_only:true`, not unfiltered total.
+- **Namespace test lookup** — supports `bonus/crises` format and flat test directories.
+- **Empty inputs** — `near:""` in edit_context and `pattern:""` in search return helpful errors.
+
 ## [0.15.4] - 2026-03-22
 
 ### Fixed

data/README.md

@@ -295,22 +295,45 @@ end
 
 | Option | Default | Description |
 |--------|---------|-------------|
+| **Presets & Introspectors** | | |
 | `preset` | `:standard` | Introspector preset (`:standard` or `:full`) |
 | `introspectors` | 13 core | Array of introspector symbols |
+| **Context Generation** | | |
 | `context_mode` | `:compact` | `:compact` (≤150 lines) or `:full` (dump everything) |
 | `claude_max_lines` | `150` | Max lines for CLAUDE.md in compact mode |
-| `max_tool_response_chars` | `120_000` | Safety cap for MCP tool responses |
-| `excluded_models` | internal Rails models | Models to skip during introspection |
-| `excluded_paths` | `node_modules tmp log vendor .git` | Paths excluded from code search |
-| `sensitive_patterns` | `.env .env.* *.key *.pem config/master.key config/credentials.yml.enc` | File patterns blocked from search and read tools |
+| `generate_root_files` | `true` | Generate root files (CLAUDE.md, etc.) — set `false` for split rules only |
+| `output_dir` | `Rails.root` | Output directory for generated context files |
+| **MCP Server** | | |
+| `server_name` | `"rails-ai-context"` | MCP server name |
+| `server_version` | gem version | MCP server version |
 | `auto_mount` | `false` | Auto-mount HTTP MCP endpoint |
 | `http_path` | `"/mcp"` | HTTP endpoint path |
 | `http_port` | `6029` | HTTP server port |
 | `http_bind` | `"127.0.0.1"` | HTTP server bind address |
 | `cache_ttl` | `30` | Cache TTL in seconds |
+| `max_tool_response_chars` | `120_000` | Safety cap for MCP tool responses |
 | `live_reload` | `:auto` | `:auto`, `true`, or `false` — MCP live reload |
 | `live_reload_debounce` | `1.5` | Debounce interval in seconds |
-| `generate_root_files` | `true` | Generate root files (CLAUDE.md, etc.) — set `false` for split rules only |
+| **Filtering & Exclusions** | | |
+| `excluded_models` | internal Rails models | Models to skip during introspection |
+| `excluded_paths` | `node_modules tmp log vendor .git` | Paths excluded from code search |
+| `sensitive_patterns` | `.env .env.* config/master.key config/credentials.yml.enc config/credentials/*.yml.enc *.pem *.key` | File patterns blocked from search and read tools |
+| `excluded_controllers` | `DeviseController` etc. | Controller classes hidden from listings |
+| `excluded_route_prefixes` | `action_mailbox/ active_storage/ rails/` etc. | Route controller prefixes hidden with app_only |
+| `excluded_concerns` | Rails/Devise/framework patterns | Regex patterns for concerns to hide |
+| `excluded_filters` | `verify_authenticity_token` etc. | Framework filter names hidden from controller output |
+| `excluded_middleware` | standard Rack/Rails middleware | Default middleware hidden from config output |
+| **File Size Limits** | | |
+| `max_file_size` | `2_000_000` | Per-file read limit for tools (bytes) |
+| `max_test_file_size` | `500_000` | Test file read limit (bytes) |
+| `max_schema_file_size` | `10_000_000` | schema.rb / structure.sql parse limit (bytes) |
+| `max_view_total_size` | `5_000_000` | Total aggregated view content for UI patterns (bytes) |
+| `max_view_file_size` | `500_000` | Per-view file during aggregation (bytes) |
+| `max_search_results` | `100` | Max search results per call |
+| `max_validate_files` | `20` | Max files per validate call |
+| **Search & Discovery** | | |
+| `search_extensions` | `rb js erb yml yaml json ts tsx vue svelte haml slim` | File extensions for Ruby fallback search |
+| `concern_paths` | `app/models/concerns app/controllers/concerns` | Where to look for concern source files |
 </details>
 
 ---

data/SECURITY.md

@@ -5,7 +5,7 @@
 | Version | Supported          |
 |---------|--------------------|
 | 0.15.x  | :white_check_mark: |
-| < 0.14  | :x:                |
+| < 0.15  | :x:                |
 
 ## Reporting a Vulnerability
 

data/docs/GUIDE.md

@@ -146,22 +146,23 @@ end
 | `app/models/AGENTS.md` | Model reference | Auto-loaded by OpenCode when reading files in `app/models/`. |
 | `app/controllers/AGENTS.md` | Controller reference | Auto-loaded by OpenCode when reading files in `app/controllers/`. |
 
-### Cursor (6 files)
+### Cursor (5 files)
 
 | File | Purpose | Notes |
 |------|---------|-------|
 | `.cursor/rules/rails-project.mdc` | Project overview | `alwaysApply: true` — loaded in every conversation. |
 | `.cursor/rules/rails-models.mdc` | Model reference | `globs: app/models/**/*.rb` — auto-attaches when editing models. |
 | `.cursor/rules/rails-controllers.mdc` | Controller reference | `globs: app/controllers/**/*.rb` — auto-attaches when editing controllers. |
-| `.cursor/rules/rails-ui-patterns.mdc` | UI patterns and design tokens | `alwaysApply: true` — loaded in every conversation. |
+| `.cursor/rules/rails-ui-patterns.mdc` | UI patterns and design tokens | `globs: app/views/**/*.erb` — loaded when editing views. |
 | `.cursor/rules/rails-mcp-tools.mdc` | MCP tool reference | `alwaysApply: true` — always available. |
 
-### Windsurf (3 files)
+### Windsurf (4 files)
 
 | File | Purpose | Notes |
 |------|---------|-------|
 | `.windsurfrules` | Main context file | Hard-capped at 5,800 chars (Windsurf's 6K limit). Truncated silently if exceeded. |
 | `.windsurf/rules/rails-context.md` | Project overview | New Windsurf rules format. |
+| `.windsurf/rules/rails-ui-patterns.md` | UI patterns and design tokens | Loaded when editing views. |
 | `.windsurf/rules/rails-mcp-tools.md` | MCP tool reference | Compact — respects 6K per-file limit. |
 
 ### GitHub Copilot (6 files)
@@ -172,7 +173,7 @@ end
 | `.github/instructions/rails-models.instructions.md` | Model context | `applyTo: app/models/**/*.rb` — loaded when editing models. |
 | `.github/instructions/rails-controllers.instructions.md` | Controller context | `applyTo: app/controllers/**/*.rb` — loaded when editing controllers. |
 | `.github/instructions/rails-context.instructions.md` | Project context and conventions | `applyTo: **/*` — loaded everywhere. |
-| `.github/instructions/rails-ui-patterns.instructions.md` | UI patterns and design tokens | `applyTo: **/*` — loaded everywhere. |
+| `.github/instructions/rails-ui-patterns.instructions.md` | UI patterns and design tokens | `applyTo: app/views/**/*.erb` — loaded when editing views. |
 | `.github/instructions/rails-mcp-tools.instructions.md` | MCP tool reference | `applyTo: **/*` — loaded everywhere. |
 
 ### Generic (1 file)
@@ -296,6 +297,8 @@ Returns model details: associations, validations, scopes, enums, callbacks, conc
 |-------|------|-------------|
 | `model` | string | Model class name (e.g. `User`). Case-insensitive. Omit for listing. |
 | `detail` | string | `summary` / `standard` (default) / `full`. Ignored when model is specified. |
+| `limit` | integer | Max models to return when listing. Default: 50. |
+| `offset` | integer | Skip models for pagination. Default: 0. |
 
 **Examples:**
 
@@ -328,6 +331,7 @@ Returns all routes: HTTP verbs, paths, controller actions, route names.
 | `detail` | string | `summary` / `standard` (default) / `full` |
 | `limit` | integer | Max routes to return. Default: 100 (standard), 200 (full). |
 | `offset` | integer | Skip routes for pagination. Default: 0. |
+| `app_only` | boolean | Filter out internal Rails routes (Active Storage, Action Mailbox, Conductor, etc.). Default: true. |
 
 **Examples:**
 
@@ -359,8 +363,11 @@ Returns controller details: actions, filters, strong params, concerns.
 
 | Param | Type | Description |
 |-------|------|-------------|
-| `controller` | string | Specific controller name (e.g. `UsersController`). Case-insensitive. |
+| `controller` | string | Specific controller name (e.g. `UsersController`, `cooks`, `bonus/crises`). Case-insensitive, flexible format. |
+| `action` | string | Specific action (e.g. `index`). Requires controller. Returns source code with applicable filters. |
 | `detail` | string | `summary` / `standard` (default) / `full`. Ignored when controller is specified. |
+| `limit` | integer | Max controllers to return when listing. Default: 50. |
+| `offset` | integer | Skip this many controllers for pagination. Default: 0. |
 
 **Examples:**
 
@@ -382,7 +389,7 @@ rails_get_controllers(detail: "full")
 
 Returns application configuration. No parameters.
 
-**Returns:** cache store, session store, timezone, middleware stack, initializers, credentials keys, current attributes.
+**Returns:** cache store, session store, timezone, queue adapter, mailer settings, custom middleware (framework defaults are filtered out), notable initializers, CurrentAttributes classes.
 
 ```
 rails_get_config()
@@ -391,20 +398,35 @@ rails_get_config()
 
 ### rails_get_test_info
 
-Returns test infrastructure details. No parameters.
+Returns test infrastructure details. Optionally filter by model or controller to find existing tests.
 
-**Returns:** test framework (rspec/minitest), factories/fixtures with locations and counts, system tests, CI config, coverage tool, test helpers.
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `model` | string | Show tests for a specific model (e.g. `User`). |
+| `controller` | string | Show tests for a specific controller (e.g. `Cooks`). |
+| `detail` | string | `summary` / `standard` (default) / `full`. |
 
 ```
 rails_get_test_info()
-  → Framework: rspec, Factories: spec/factories (12 files), CI: .github/workflows/ci.yml, ...
+  → Framework: rspec, Factories: spec/factories (12 files), CI: .github/workflows/ci.yml
+
+rails_get_test_info(model: "User")
+  → Shows spec/models/user_spec.rb test names (summary/standard) or full source (full)
 ```
 
 ### rails_get_gems
 
-Returns notable gems categorized by function. No parameters.
+Returns notable gems categorized by function.
 
-**Returns:** 70+ recognized gems grouped by category (auth, background_jobs, admin, monitoring, search, pagination, etc.) with versions and descriptions.
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `category` | string | Filter by category: `auth`, `jobs`, `frontend`, `api`, `database`, `files`, `testing`, `deploy`, `all` (default). |
+
+**Returns:** Notable gems grouped by category with descriptions.
 
 ```
 rails_get_gems()
@@ -422,6 +444,108 @@ rails_get_conventions()
   → Architecture: [MVC, Service objects, Concerns], Patterns: [STI, Polymorphism], ...
 ```
 
+### rails_get_stimulus
+
+Returns Stimulus controller details: targets, values, actions, outlets, classes.
+
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `controller` | string | Specific Stimulus controller name (e.g. `hello`, `filter-form`). Case-insensitive. |
+| `detail` | string | `summary` / `standard` (default) / `full` |
+| `limit` | integer | Max controllers to return when listing. Default: 50. |
+| `offset` | integer | Skip controllers for pagination. Default: 0. |
+
+**Examples:**
+
+```
+rails_get_stimulus()
+  → Standard: controller names with targets and actions
+
+rails_get_stimulus(detail: "summary")
+  → Names with target/action counts
+
+rails_get_stimulus(controller: "filter-form")
+  → Full detail: targets, actions, values, outlets, classes, file path
+
+rails_get_stimulus(detail: "full")
+  → All controllers with all details
+```
+
+### rails_get_view
+
+Returns view template contents, partials, and Stimulus controller references.
+
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `controller` | string | Filter views by controller name (e.g. `cooks`, `brand_profiles`). Use `layouts` for layout files. |
+| `path` | string | Specific view path relative to `app/views` (e.g. `cooks/index.html.erb`). Returns full content. |
+| `detail` | string | `summary` / `standard` (default) / `full` |
+
+**Examples:**
+
+```
+rails_get_view()
+  → Standard: all view files with partial/stimulus refs
+
+rails_get_view(controller: "cooks")
+  → All templates and partials for CooksController
+
+rails_get_view(path: "cooks/index.html.erb")
+  → Full template content
+
+rails_get_view(controller: "layouts")
+  → Layout files
+
+rails_get_view(controller: "cooks", detail: "full")
+  → Full template content for all cooks views
+```
+
+### rails_get_edit_context
+
+Returns just enough context to make a surgical Edit to a file. Returns the target area with line numbers and surrounding code.
+
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `file` | string | **Required.** File path relative to Rails root (e.g. `app/models/cook.rb`). |
+| `near` | string | **Required.** What to find — a method name, keyword, or string to locate (e.g. `scope`, `def index`). |
+| `context_lines` | integer | Lines of context above and below the match. Default: 5. |
+
+**Examples:**
+
+```
+rails_get_edit_context(file: "app/models/cook.rb", near: "scope")
+  → Code around the first scope with line numbers, expanded to full method
+
+rails_get_edit_context(file: "app/controllers/cooks_controller.rb", near: "def index")
+  → The index action source with surrounding context
+```
+
+### rails_validate
+
+Validates syntax of multiple files at once (Ruby, ERB, JavaScript).
+
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `files` | array | **Required.** File paths relative to Rails root (e.g. `["app/models/cook.rb", "app/views/cooks/index.html.erb"]`). |
+
+**Examples:**
+
+```
+rails_validate(files: ["app/models/cook.rb"])
+  → ✓ app/models/cook.rb — syntax OK
+
+rails_validate(files: ["app/models/cook.rb", "app/controllers/cooks_controller.rb", "app/views/cooks/index.html.erb"])
+  → Checks all three files, reports pass/fail for each
+```
+
 ### rails_search_code
 
 Ripgrep-powered regex search across the codebase.
@@ -431,8 +555,10 @@ Ripgrep-powered regex search across the codebase.
 | Param | Type | Description |
 |-------|------|-------------|
 | `pattern` | string | **Required.** Regex pattern to search for. |
+| `path` | string | Subdirectory to search in (e.g. `app/models`, `config`). Default: entire app. |
 | `file_type` | string | Filter by file type (e.g. `rb`, `erb`, `js`). Alphanumeric only. |
-| `max_results` | integer | Max results to return. Default: 20, max: 100. |
+| `max_results` | integer | Max results to return. Default: 30, max: 100. |
+| `context_lines` | integer | Lines of context before and after each match (like grep -C). Default: 0, max: 5. |
 
 **Examples:**
 
@@ -445,18 +571,28 @@ rails_search_code(pattern: "class.*Controller", file_type: "rb")
 
 rails_search_code(pattern: "def create", file_type: "rb", max_results: 50)
   → First 50 create methods across the codebase
+
+rails_search_code(pattern: "current_user", path: "app/controllers")
+  → Search only in app/controllers/
+
+rails_search_code(pattern: "validates", context_lines: 2)
+  → Matches with 2 lines of context before and after
 ```
 
-**Security:** Uses `Open3.capture2` with array arguments (no shell injection). Validates file_type. Blocks path traversal. Respects `excluded_paths` config.
+**Security:** Uses `Open3.capture2` with array arguments (no shell injection). Validates file_type. Blocks path traversal. Respects `excluded_paths` and `sensitive_patterns` config.
 
 ### Detail Level Summary
 
-| Level | What it returns | Default limit | Best for |
-|-------|----------------|---------------|----------|
+All tools that support `detail` use these three levels. Default limits vary by tool — schema defaults shown below:
+
+| Level | What it returns | Schema default limit | Best for |
+|-------|----------------|---------------------|----------|
 | `summary` | Names + counts | 50 | Getting the landscape, understanding what exists |
 | `standard` | Names + key details | 15 | Working context, column types, action names |
 | `full` | Everything | 5 | Deep inspection, indexes, FKs, constraints |
 
+Other tools default to higher limits (e.g. models/controllers/stimulus: 50 for all levels, routes: 100/200).
+
 ### Recommended Workflow
 
 1. **Start with `detail:"summary"`** to see what exists
@@ -617,6 +753,49 @@ RailsAiContext.configure do |config|
   # Paths to exclude from code search
   config.excluded_paths += %w[vendor/bundle]
 
+  # Sensitive file patterns blocked from search and read tools
+  # config.sensitive_patterns += %w[config/my_secret.yml]
+
+  # Controllers hidden from listings (e.g. Devise internals)
+  # config.excluded_controllers += %w[MyInternalController]
+
+  # Route prefixes hidden with app_only (e.g. admin frameworks)
+  # config.excluded_route_prefixes += %w[admin/]
+
+  # Regex patterns for concerns to hide from model output
+  # config.excluded_concerns += [/MyInternal::/]
+
+  # Framework filter names hidden from controller output
+  # config.excluded_filters += %w[my_internal_filter]
+
+  # Default middleware hidden from config output
+  # config.excluded_middleware += %w[MyMiddleware]
+
+  # --- File size limits ---
+
+  # Per-file read limit for tools (default: 2MB)
+  # config.max_file_size = 2_000_000
+
+  # Test file read limit (default: 500KB)
+  # config.max_test_file_size = 500_000
+
+  # schema.rb / structure.sql parse limit (default: 10MB)
+  # config.max_schema_file_size = 10_000_000
+
+  # Max search results per call (default: 100)
+  # config.max_search_results = 100
+
+  # Max files per validate call (default: 20)
+  # config.max_validate_files = 20
+
+  # --- Search and file discovery ---
+
+  # File extensions for Ruby fallback search
+  # config.search_extensions = %w[rb js erb yml yaml json ts tsx vue svelte haml slim]
+
+  # Where to look for concern source files
+  # config.concern_paths = %w[app/models/concerns app/controllers/concerns]
+
   # --- Live reload ---
 
   # Auto-invalidate MCP tool caches on file changes
@@ -648,6 +827,7 @@ end
 | `cache_ttl` | Integer | `30` | Cache TTL in seconds for introspection results |
 | `excluded_models` | Array | internal Rails models | Models to skip |
 | `excluded_paths` | Array | `node_modules tmp log vendor .git` | Paths excluded from code search |
+| `sensitive_patterns` | Array | `.env`, `.key`, `.pem`, credentials | File patterns blocked from search and read tools |
 | `output_dir` | String | `nil` (Rails.root) | Where to write context files |
 | `auto_mount` | Boolean | `false` | Auto-mount HTTP MCP endpoint |
 | `http_path` | String | `"/mcp"` | HTTP endpoint path |
@@ -656,7 +836,22 @@ end
 | `live_reload` | Symbol/Boolean | `:auto` | `:auto`, `true`, or `false` — enable MCP live reload |
 | `live_reload_debounce` | Float | `1.5` | Debounce interval in seconds for live reload |
 | `server_name` | String | `"rails-ai-context"` | MCP server name |
+| `server_version` | String | gem version | MCP server version |
 | `generate_root_files` | Boolean | `true` | Generate root files (CLAUDE.md, .windsurfrules, etc.) — set `false` for split rules only |
+| `max_file_size` | Integer | `2_000_000` | Per-file read limit for tools (2MB) |
+| `max_test_file_size` | Integer | `500_000` | Test file read limit (500KB) |
+| `max_schema_file_size` | Integer | `10_000_000` | schema.rb / structure.sql parse limit (10MB) |
+| `max_view_total_size` | Integer | `5_000_000` | Total aggregated view content for UI patterns (5MB) |
+| `max_view_file_size` | Integer | `500_000` | Per-view file during aggregation (500KB) |
+| `max_search_results` | Integer | `100` | Max search results per call |
+| `max_validate_files` | Integer | `20` | Max files per validate call |
+| `excluded_controllers` | Array | `DeviseController`, etc. | Controller classes hidden from listings |
+| `excluded_route_prefixes` | Array | `action_mailbox/`, `active_storage/`, etc. | Route controller prefixes hidden with `app_only` |
+| `excluded_concerns` | Array | framework regex patterns | Regex patterns for concerns to hide from model output |
+| `excluded_filters` | Array | `verify_authenticity_token`, etc. | Framework filter names hidden from controller output |
+| `excluded_middleware` | Array | standard Rails middleware | Default middleware hidden from config output |
+| `search_extensions` | Array | `rb js erb yml yaml json ts tsx vue svelte haml slim` | File extensions for Ruby fallback search |
+| `concern_paths` | Array | `app/models/concerns app/controllers/concerns` | Where to look for concern source files |
 
 ### Root file generation
 
@@ -731,7 +926,7 @@ config.preset = :full
 
 ```ruby
 # Start with standard, add specific ones
-config.introspectors += %i[views turbo auth api stimulus]
+config.introspectors += %i[views turbo auth api]
 
 # Or build from scratch
 config.introspectors = %i[schema models routes gems auth api]

data/lib/rails_ai_context/configuration.rb

@@ -60,6 +60,26 @@ module RailsAiContext
     # When false, only generates split rule files (.claude/rules/, .cursor/rules/, etc.)
     attr_accessor :generate_root_files
 
+    # File size limits (bytes) — increase for larger projects
+    attr_accessor :max_file_size          # Per-file read limit for tools (default: 2MB)
+    attr_accessor :max_test_file_size     # Test file read limit (default: 500KB)
+    attr_accessor :max_schema_file_size   # schema.rb / structure.sql parse limit (default: 10MB)
+    attr_accessor :max_view_total_size    # Total aggregated view content for UI patterns (default: 5MB)
+    attr_accessor :max_view_file_size     # Per-view file during aggregation (default: 500KB)
+    attr_accessor :max_search_results     # Max search results per call (default: 100)
+    attr_accessor :max_validate_files     # Max files per validate call (default: 20)
+
+    # Filtering — customize what's hidden from AI output
+    attr_accessor :excluded_controllers   # Controller classes hidden from listings (e.g. DeviseController)
+    attr_accessor :excluded_route_prefixes # Route controller prefixes hidden with app_only (e.g. action_mailbox/)
+    attr_accessor :excluded_concerns      # Regex patterns for concerns to hide (e.g. /Devise::Models/)
+    attr_accessor :excluded_filters       # Framework filter names hidden from controller output
+    attr_accessor :excluded_middleware     # Default middleware hidden from config output
+
+    # Search and file discovery
+    attr_accessor :search_extensions      # File extensions for Ruby fallback search (default: rb,js,erb,yml,yaml,json)
+    attr_accessor :concern_paths          # Where to look for concern source files (default: app/models/concerns)
+
     def initialize
       @server_name         = "rails-ai-context"
       @server_version      = RailsAiContext::VERSION
@@ -87,6 +107,41 @@ module RailsAiContext
       @live_reload              = :auto
       @live_reload_debounce     = 1.5
       @generate_root_files      = true
+      @max_file_size            = 2_000_000
+      @max_test_file_size       = 500_000
+      @max_schema_file_size     = 10_000_000
+      @max_view_total_size      = 5_000_000
+      @max_view_file_size       = 500_000
+      @max_search_results       = 100
+      @max_validate_files       = 20
+      @excluded_controllers     = %w[DeviseController Devise::OmniauthCallbacksController]
+      @excluded_route_prefixes  = %w[action_mailbox/ active_storage/ rails/ conductor/ devise/ turbo/]
+      @excluded_concerns        = [
+        /::Generated/,
+        /\A(ActiveRecord|ActiveModel|ActiveSupport|ActionText|ActionMailbox|ActiveStorage)/,
+        /\A(ActionDispatch|ActionController|ActionView|AbstractController)/,
+        /\A(Devise::Models|Devise::Orm|Bullet::|Turbo::|GlobalID::|Rolify::)/
+      ]
+      @excluded_filters         = %w[
+        verify_authenticity_token verify_same_origin_request
+        turbo_tracking_request_id handle_unverified_request
+        mark_for_same_origin_verification
+      ]
+      @excluded_middleware      = %w[
+        Rack::Sendfile ActionDispatch::Static ActionDispatch::Executor
+        ActionDispatch::ServerTiming Rack::Runtime
+        ActionDispatch::RequestId ActionDispatch::RemoteIp
+        Rails::Rack::Logger ActionDispatch::ShowExceptions
+        ActionDispatch::DebugExceptions ActionDispatch::Callbacks
+        ActionDispatch::Cookies ActionDispatch::Session::CookieStore
+        ActionDispatch::Flash ActionDispatch::ContentSecurityPolicy::Middleware
+        ActionDispatch::PermissionsPolicy::Middleware ActionDispatch::ActionableExceptions
+        Rack::Head Rack::ConditionalGet Rack::ETag Rack::TempfileReaper
+        ActiveRecord::Migration::CheckPending ActionDispatch::HostAuthorization
+        Rack::MethodOverride ActionDispatch::Session::AbstractSecureStore
+      ]
+      @search_extensions        = %w[rb js erb yml yaml json ts tsx vue svelte haml slim]
+      @concern_paths            = %w[app/models/concerns app/controllers/concerns]
     end
 
     def preset=(name)

data/lib/rails_ai_context/introspectors/controller_introspector.rb

@@ -9,12 +9,9 @@ module RailsAiContext
     class ControllerIntrospector
       attr_reader :app
 
-      # Framework filters inherited from ActionController::Base — suppress to reduce noise
-      FRAMEWORK_FILTERS = %w[
-        verify_authenticity_token verify_same_origin_request
-        turbo_tracking_request_id handle_unverified_request
-        mark_for_same_origin_verification
-      ].freeze
+      def excluded_filters
+        RailsAiContext.configuration.excluded_filters
+      end
 
       def initialize(app)
         @app = app
@@ -164,7 +161,7 @@ module RailsAiContext
 
         ctrl._process_action_callbacks.filter_map do |cb|
           next if cb.filter.is_a?(Proc) || cb.filter.to_s.start_with?("_")
-          next if FRAMEWORK_FILTERS.include?(cb.filter.to_s)
+          next if excluded_filters.include?(cb.filter.to_s)
 
           filter = { name: cb.filter.to_s, kind: cb.kind.to_s }
           filter[:only] = cb.instance_variable_get(:@if)&.filter_map { |c| extract_action_condition(c) }&.flatten

data/lib/rails_ai_context/introspectors/model_introspector.rb

@@ -59,6 +59,7 @@ module RailsAiContext
           table_name: model.table_name,
           associations: extract_associations(model),
           validations: extract_validations(model),
+          custom_validates: extract_custom_validates(model),
           scopes: extract_scopes(model),
           enums: extract_enums(model),
           callbacks: extract_callbacks(model),
@@ -109,6 +110,17 @@ module RailsAiContext
         []
       end
 
+      # Extract custom validate :method_name calls from source
+      # These are business-rule validators that model.validators doesn't include
+      def extract_custom_validates(model)
+        source_path = model_source_path(model)
+        return [] unless source_path && File.exist?(source_path)
+
+        File.read(source_path).scan(/^\s*validate\s+:(\w+)/).flatten
+      rescue
+        []
+      end
+
       def model_source_path(model)
         root = app.root.to_s
         underscored = model.name.underscore
@@ -156,11 +168,8 @@ module RailsAiContext
 
       def framework_concern?(name)
         return true if name.nil?
-        return true if name.include?("::Generated")
-        return true if name.match?(/\A(ActiveRecord|ActiveModel|ActiveSupport|ActionText|ActionMailbox|ActiveStorage|ActionDispatch|ActionController|ActionView|AbstractController)/)
-        return true if name.match?(/\A(Devise::Models|Devise::Orm|Bullet::|Turbo::|GlobalID::|Rolify::)/)
         return true if %w[Kernel JSON PP Marshal MessagePack].include?(name)
-        false
+        RailsAiContext.configuration.excluded_concerns.any? { |pattern| name.match?(pattern) }
       end
 
       def extract_public_class_methods(model)

data/lib/rails_ai_context/introspectors/schema_introspector.rb

@@ -150,7 +150,9 @@ module RailsAiContext
         File.join(app.root, "db", "structure.sql")
       end
 
-      MAX_SCHEMA_FILE_SIZE = 10_000_000 # 10MB safety limit for schema files
+      def max_schema_file_size
+        RailsAiContext.configuration.max_schema_file_size
+      end
 
       # Fallback: parse schema file as text when DB isn't connected.
       # Tries db/schema.rb first, then db/structure.sql.
@@ -166,7 +168,7 @@ module RailsAiContext
       end
 
       def parse_schema_rb(path)
-        return { error: "schema.rb too large (#{File.size(path)} bytes)" } if File.size(path) > MAX_SCHEMA_FILE_SIZE
+        return { error: "schema.rb too large (#{File.size(path)} bytes)" } if File.size(path) > max_schema_file_size
         content = File.read(path)
         tables = {}
         current_table = nil
@@ -209,7 +211,7 @@ module RailsAiContext
       end
 
       def parse_structure_sql(path) # rubocop:disable Metrics/MethodLength
-        return { error: "structure.sql too large (#{File.size(path)} bytes)" } if File.size(path) > MAX_SCHEMA_FILE_SIZE
+        return { error: "structure.sql too large (#{File.size(path)} bytes)" } if File.size(path) > max_schema_file_size
         content = File.read(path)
         tables = {}
 

data/lib/rails_ai_context/introspectors/view_template_introspector.rb

@@ -61,15 +61,14 @@ module RailsAiContext
         partials
       end
 
-      MAX_TOTAL_VIEW_SIZE = 5_000_000 # 5MB cap for aggregated view content
-      MAX_SINGLE_VIEW_SIZE = 500_000 # 500KB per file
-
       def collect_all_view_content(views_dir)
+        max_total = RailsAiContext.configuration.max_view_total_size
+        max_single = RailsAiContext.configuration.max_view_file_size
         content = +""
         Dir.glob(File.join(views_dir, "**", "*.{erb,haml,slim}")).each do |path|
           next if File.directory?(path)
-          next if File.size(path) > MAX_SINGLE_VIEW_SIZE
-          break if content.bytesize >= MAX_TOTAL_VIEW_SIZE
+          next if File.size(path) > max_single
+          break if content.bytesize >= max_total
           content << (File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue "")
         end
         content