rails-ai-context 3.1.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6bdb0dcbde3c7abfab69bee14e661afc8a260fe3d00faa99ecc4becbc58a19b
-  data.tar.gz: deacfa10c6c188d0482fc82199f085b4f13cbf24b0cf06e0977074ecf67864d8
+  metadata.gz: af24e6340b8328b0526c9f030d60b495f4cb1e7130b7f16cadd039e2b9912aab
+  data.tar.gz: e74d337f614f853fec1bacaff748bea4b212ed96034c22b5fd3d75326da6fc13
 SHA512:
-  metadata.gz: bf049844c52cd8b88371a352907b08c9863668424ae37f9393d72c7210501c21fcc2ea3df797e59184b603b98e723f0bd07ebb4e36503852344c27d96970a308
-  data.tar.gz: ab5cf1f7f4031d605db8f076da5544ede9c1aa48d426dc57482a45551d46741c687caaaf0e8722932d8d982c6a9af5c86f425e117a80bcb88b36d2d1d761040f
+  metadata.gz: 9e8d9261310e038cce1cc20ba21d81d203eec2d813dcf318aa3f2071da646a67dc11fd812671a0d982d6d0d234ed84c2079144be3b62863b311e09d0b12181f9
+  data.tar.gz: 3f6001ba2d788b76e4a6e7b576a9447e7eed91df1a0b689dba679a3c6fbd876db1278e7ebd70637b35bedb01e2e77b1546cf3b96d8c5d37536f1f053fd35f9d3

data/CHANGELOG.md

@@ -5,6 +5,88 @@ 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.1.0] — 2026-03-29
+
+### Added
+- New `rails_get_frontend_stack` tool: detects React/Vue/Svelte/Angular, Inertia/react-rails mounting, state management, TypeScript config, monorepo layout, package manager
+- New `FrontendFrameworkIntrospector`: parses package.json (JSON.parse with BOM-safe reading), config/vite.json, config/shakapacker.yml, tsconfig.json
+- Frontend framework detection covers patterns 3 (hybrid SPA), 4 (API+SPA), and 7 (Turbo Native)
+- API introspector: OpenAPI/Swagger spec detection, CORS config parsing, API codegen tool detection (openapi-typescript, graphql-codegen, orval)
+- Auth introspector: JWT strategy (devise-jwt, Doorkeeper config), HTTP token auth detection
+- Turbo introspector: Turbo Native detection (turbo_native_app?, native navigation patterns, native conditionals in views)
+- Gem introspector: 6 new notable gems (devise-jwt, rswag-api, rswag-ui, grape-swagger, apipie-rails, hotwire-native-rails)
+- Optional config: `frontend_paths`, `mobile_paths` (auto-detected if nil, user override for edge cases)
+- Install generator: re-install now updates `ai_tools` and `tool_mode` selections, adds missing config sections without removing existing settings
+- Install generator: prompts to remove generated files when AI tools are deselected (per-tool chooser)
+- `rails ai:context:cursor` (and other format tasks) now auto-adds the format to `config.ai_tools`
+- CLI tool_runner: warns on invalid enum values instead of silent fallback
+
+### Fixed
+- `analyze_feature` crash on nil/empty input — now returns helpful prompt
+- `analyze_feature` with nonexistent feature — returns clean "no match" instead of scaffolded empty sections
+- `migration_advisor` crash on empty/invalid action — now validates with "Did you mean?" suggestions
+- `migration_advisor` generates broken SQL with empty table/column — now validates required params
+- `migration_advisor` doesn't normalize table names — "Cook" now auto-resolves to "cooks"
+- `migration_advisor` no duplicate column/index detection — now warns on existing columns, indexes, and FKs
+- `migration_advisor` no nonexistent column detection — now warns on remove/rename/change_type/add_index for missing columns
+- `edit_context` "File not found" with no hint — now suggests full path with "Did you mean?"
+- `performance_check` model filter fails for multi-word models — "BrandProfile" now resolves to "brand_profiles"
+- `performance_check` unknown model silently ignored — now returns "not found" with suggestions
+- `turbo_map` stream filter misses dynamic broadcasts — multi-line call handling + snippet fallback + fuzzy prefix matching
+- `turbo_map` controller filter misses job broadcasts — now includes broadcasts matching filtered subscriptions' streams
+- `security_scan` wrong check name examples — added CHECK_ALIASES mapping (CheckXSS → CheckCrossSiteScripting, sql → CheckSQL, etc.)
+- `search_code` unknown match_type silently ignored — now returns error with valid values
+- `validate` unknown level silently ignored — now returns error with valid values
+- `get_view` no "Did you mean?" on wrong controller — now uses `find_closest_match`
+- `get_context` plural model name ("Cooks") produces mixed output — now normalizes via singularize/classify, fails fast when not found
+- `component_catalog` specific component returns generic "no components" — now acknowledges the input
+- `stimulus` doesn't strip `_controller` suffix — now auto-strips for lookup
+- `controller_introspector_spec` rate_limit test crashes on Rails 7.1 — split into source-parsing test (no class loading)
+
+### Changed
+- Full preset: 31 → 32 introspectors (added :frontend_frameworks)
+- Tool count: 29 → 30
+- Test count: 817 → 893
+- Install generator always writes `config.ai_tools` and `config.tool_mode` uncommented for re-install detection
+
+## [4.0.0] — 2026-03-26
+
+### Added
+
+- 4 new MCP tools: `rails_get_component_catalog`, `rails_performance_check`, `rails_dependency_graph`, `rails_migration_advisor`
+- 3 new introspectors: ComponentIntrospector (ViewComponent/Phlex), AccessibilityIntrospector (ARIA/a11y), PerformanceIntrospector (N+1/indexes)
+- ViewComponent/Phlex component catalog: props, slots, previews, sidecar assets, usage examples
+- Accessibility scanning: ARIA attributes, semantic HTML, screen reader text, alt text, landmark roles, accessibility score
+- Performance analysis: N+1 query risks, missing counter_cache, missing FK indexes, Model.all anti-patterns, eager load candidates
+- Dependency graph generation in Mermaid or text format
+- Migration code generation with reversibility warnings and affected model detection
+- Component and accessibility split rules for Claude, Cursor, Copilot, and OpenCode
+- Stimulus cross-controller composition detection
+- Stimulus import graph and complexity metrics
+- Turbo 8 morph meta and permanent element detection
+- Turbo Drive configuration scanning (data-turbo-*, preload)
+- Form builder detection (form_with, simple_form, formtastic)
+- Semantic HTML element counting
+- DaisyUI theme and component detection
+- Font loading strategy detection (@font-face, Google Fonts, system fonts)
+- CSS @layer and PostCSS plugin detection
+- Convention fingerprint with SolidQueue/SolidCache/SolidCable awareness
+- Dynamic directory detection in app/
+- Controller rate_limit and rescue_from extraction
+- Model encryption, normalizes, and generates_token_for details
+- Schema check constraints, enum types, and generated columns
+- Factory trait extraction and test count by category
+- Expanded NOTABLE_GEMS list (30+ new gems including dry-rb, Solid stack)
+- Job retry_on/discard_on and perform argument extraction
+
+### Changed
+
+- Standard preset: 13 → 14 introspectors (added :components)
+- Full preset: 28 → 31 introspectors (added :components, :accessibility, :performance)
+- Tool count: 25 → 29
+- Test count: 681 → 806 examples
+- Combustion test app expanded with Stimulus controllers, ViewComponents, accessible views, factories
+
 ## [3.1.0] - 2026-03-26
 
 ### Fixed

data/CLAUDE.md

@@ -8,8 +8,8 @@ structure to AI assistants via the Model Context Protocol (MCP).
 - `lib/rails_ai_context.rb` — Main entry point, public API (Zeitwerk autoloaded)
 - `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/` — 29 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)
-- `lib/rails_ai_context/tools/` — 25 MCP tools using the official mcp SDK
+- `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/` — 30 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)
@@ -34,24 +34,30 @@ structure to AI assistants via the Model Context Protocol (MCP).
 7. **Diff-aware** — context regeneration skips unchanged files
 8. **Per-assistant serializers** — each AI tool gets tailored output format
 9. **Zeitwerk autoloading** — files loaded on-demand, not all upfront
-10. **Introspector presets** — `:full` (28) default, `:standard` (13 core) for lightweight usage
+10. **Introspector presets** — `:full` (32) default, `:standard` (14 core) for lightweight usage
 11. **MCP auto-discovery** — `.mcp.json` generated by install generator
 12. **Compact by default** — context files ≤150 lines, MCP tools use `detail` parameter (summary/standard/full)
 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 25 built-in tools
+16. **custom_tools API** — `config.custom_tools` array lets users register additional MCP::Tool subclasses alongside the 30 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 25 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 30 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
+25. **Performance analysis** — N+1 query risks, missing counter_cache, missing FK indexes, eager load candidates via `rails_performance_check`
+26. **Migration advisor** — migration code generation with duplicate/nonexistent column warnings, reversibility flags, table name normalization via `rails_migration_advisor`
+27. **Frontend framework detection** — auto-detects React/Vue/Svelte/Angular from package.json, Vite/Shakapacker/Webpacker config, TypeScript setup, monorepo layout, package manager via `rails_get_frontend_stack`
+28. **Install generator idempotency** — re-install preserves existing config, only adds new sections, updates ai_tools/tool_mode selections, prompts per-tool file cleanup for removed tools
 
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (681 examples)
+bundle exec rspec           # Run specs (893 examples)
 bundle exec rubocop         # Lint
 ```
 

data/CONTRIBUTING.md

@@ -19,8 +19,8 @@ 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/     # 29 introspectors (schema, models, routes, etc.)
-├── tools/             # 25 MCP tools with detail levels and pagination
+├── introspectors/     # 33 introspectors (schema, models, routes, etc.)
+├── tools/             # 30 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

@@ -9,14 +9,14 @@
 
 **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 681 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 893 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 25 tools that understand your entire Rails app — via MCP server or CLI. Zero config.
+That's it. Your AI now has 30 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.
 
@@ -46,7 +46,7 @@ rails 'ai:tool[schema]' table=users
 rails 'ai:tool[analyze_feature]' feature=billing
 ```
 
-Same 25 tools. Same output. AI agents run these as shell commands. **Works in any terminal, any AI tool, any workflow.** No MCP client required.
+Same 30 tools. Same output. AI agents run these as shell commands. **Works in any terminal, any AI tool, any workflow.** No MCP client required.
 
 ---
 
@@ -170,7 +170,7 @@ Tested on a real Rails 8 app (5 models, 19 controllers, 95 routes):
 
 ---
 
-## 25 Tools
+## 30 Tools
 
 Every tool is **read-only** and returns structured, token-efficient data.
 
@@ -209,6 +209,13 @@ Every tool is **read-only** and returns structured, token-efficient data.
 | **Services & Jobs** | | | |
 | `get_service_pattern` | `rails_get_service_pattern` | `rails 'ai:tool[service_pattern]'` | Interface, dependencies, side effects, callers |
 | `get_job_pattern` | `rails_get_job_pattern` | `rails 'ai:tool[job_pattern]'` | Queue, retries, guard clauses, broadcasts, schedules |
+| **Components & Quality** | | | |
+| `get_component_catalog` | `rails_get_component_catalog` | `rails 'ai:tool[component_catalog]'` | ViewComponent/Phlex: props, slots, previews, sidecar assets, usage |
+| `performance_check` | `rails_performance_check` | `rails 'ai:tool[performance_check]'` | N+1 risks, missing indexes, counter_cache, eager load candidates |
+| `dependency_graph` | `rails_dependency_graph` | `rails 'ai:tool[dependency_graph]'` | Model/service dependency graph in Mermaid or text format |
+| `migration_advisor` | `rails_migration_advisor` | `rails 'ai:tool[migration_advisor]'` | Migration code generation with reversibility + affected models |
+| **Frontend** | | | |
+| `get_frontend_stack` | `rails_get_frontend_stack` | `rails 'ai:tool[frontend_stack]'` | React/Vue/Svelte/Angular, Inertia, TypeScript, package manager |
 
 > **[Full parameter docs →](docs/GUIDE.md)**
 
@@ -221,7 +228,7 @@ Every tool is **read-only** and returns structured, token-efficient data.
 │  Your Rails App                                          │
 │  models + schema + routes + controllers + views + jobs   │
 └────────────────────────┬────────────────────────────────┘
-                         │ introspects (29 introspectors)
+                         │ introspects (33 introspectors)
                          ▼
 ┌─────────────────────────────────────────────────────────┐
 │  rails-ai-context                                        │
@@ -231,7 +238,7 @@ Every tool is **read-only** and returns structured, token-efficient data.
          ▼                  ▼              ▼
 ┌──────────────────┐ ┌────────────┐ ┌────────────────────┐
 │  Static Files     │ │  MCP Server │ │  CLI Tools          │
-│  CLAUDE.md        │ │  25 tools   │ │  Same 25 tools      │
+│  CLAUDE.md        │ │  30 tools   │ │  Same 30 tools      │
 │  .cursor/rules/   │ │  stdio/HTTP │ │  No server needed   │
 │  .github/instr... │ │  .mcp.json  │ │  rails 'ai:tool[X]' │
 └──────────────────┘ └────────────┘ └────────────────────┘
@@ -267,7 +274,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 25 tools from the CLI |
+| `rails 'ai:tool[NAME]'` | Run any of the 30 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 |
@@ -287,7 +294,7 @@ RailsAiContext.configure do |config|
   # Tool mode: :mcp (default, MCP + CLI fallback) or :cli (CLI only)
   # config.tool_mode = :mcp
 
-  # Presets: :full (28 introspectors, default) or :standard (13 core)
+  # Presets: :full (32 introspectors, default) or :standard (14 core)
   # config.preset = :full
 
   # Exclude models from introspection
@@ -305,7 +312,7 @@ end
 |--------|---------|-------------|
 | **Presets & Introspectors** | | |
 | `preset` | `:full` | Introspector preset (`:full` or `:standard`) |
-| `introspectors` | 28 (full) | Array of introspector symbols |
+| `introspectors` | 32 (full) | 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 |
@@ -340,7 +347,7 @@ end
 ```bash
 git clone https://github.com/crisnahine/rails-ai-context.git
 cd rails-ai-context && bundle install
-bundle exec rspec       # 681 examples
+bundle exec rspec       # 893 examples
 bundle exec rubocop     # Lint
 ```
 

data/SECURITY.md

@@ -4,8 +4,11 @@
 
 | Version | Supported          |
 |---------|--------------------|
-| 3.0.x   | :white_check_mark: |
-| 2.0.x   | :white_check_mark: |
+| 4.1.x   | :white_check_mark: |
+| 4.0.x   | :white_check_mark: |
+| 3.1.x   | :white_check_mark: |
+| 3.0.x   | :x:                |
+| 2.0.x   | :x:                |
 | < 2.0   | :x:                |
 
 ## Reporting a Vulnerability
@@ -22,7 +25,7 @@ If you discover a security vulnerability in rails-ai-context, please report it r
 
 ## Security Design
 
-- All 25 MCP tools are **read-only** and never modify your application or database.
+- All 30 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

@@ -40,7 +40,7 @@ rails ai:context
 This creates:
 1. `config/initializers/rails_ai_context.rb` — configuration file
 2. `.mcp.json` — MCP auto-discovery for Claude Code and Cursor
-3. 25 context files — tailored for each AI assistant
+3. 29 context files — tailored for each AI assistant
 
 ### Existing project
 
@@ -124,7 +124,7 @@ end
 
 ## Generated Files
 
-`rails ai:context` generates **25 files** across all AI assistants:
+`rails ai:context` generates **29 files** across all AI assistants:
 
 ### Claude Code (6 files)
 
@@ -184,7 +184,7 @@ Commit **all files except `.ai-context.json`** (which is gitignored). This gives
 
 | Command | Mode | Format | Description |
 |---------|------|--------|-------------|
-| `rails ai:context` | compact | all | Generate all 25 context files |
+| `rails ai:context` | compact | all | Generate all 29 context files |
 | `rails ai:context:full` | full | all | Generate all files in full mode |
 | `rails ai:context:claude` | compact | Claude | CLAUDE.md + .claude/rules/ |
 | `rails ai:context:opencode` | compact | OpenCode | AGENTS.md + per-directory AGENTS.md |
@@ -252,7 +252,7 @@ rails ai:context:claude           # Use this instead (no quoting needed)
 
 ## CLI Tools
 
-All 25 MCP tools can be run directly from the terminal — no MCP server or AI client needed.
+All 30 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 25 tools are **read-only** and **idempotent** — they never modify your application or database.
+All 30 tools are **read-only** and **idempotent** — they never modify your application or database.
 
 ### rails_get_schema
 
@@ -996,7 +996,7 @@ All tools that support `detail` use these three levels. Default limits vary by t
 | Level | What it returns | Schema default limit | Best for |
 |-------|----------------|---------------------|----------|
 | `summary` | Names + counts | 50 | Getting the landscape, understanding what exists |
-| `standard` | Names + key details | 25 | Working context, column types, action names |
+| `standard` | Names + key details | 29 | Working context, column types, action names |
 | `full` | Everything | 10 | Deep inspection, indexes, FKs, constraints |
 
 Other tools default to higher limits (e.g. models/controllers/stimulus: 50 for all levels, routes: 100/200).
@@ -1117,7 +1117,7 @@ RailsAiContext.configure do |config|
 end
 ```
 
-Both transports are **read-only** — they expose the same 25 tools and never modify your app.
+Both transports are **read-only** — they expose the same 30 tools and never modify your app.
 
 ---
 
@@ -1128,7 +1128,7 @@ Both transports are **read-only** — they expose the same 25 tools and never mo
 RailsAiContext.configure do |config|
   # --- Introspectors ---
 
-  # Presets: :full (28 introspectors, default) or :standard (13 core)
+  # Presets: :full (32 introspectors, default) or :standard (14 core)
   config.preset = :full
 
   # Cherry-pick on top of a preset
@@ -1243,7 +1243,7 @@ end
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `preset` | Symbol | `:full` | Introspector preset (`:full` or `:standard`) |
-| `introspectors` | Array | 28 (full preset) | Which introspectors to run |
+| `introspectors` | Array | 32 (full preset) | Which introspectors to run |
 | `context_mode` | Symbol | `:compact` | `:compact` or `:full` |
 | `claude_max_lines` | Integer | `150` | Max lines for CLAUDE.md in compact mode |
 | `max_tool_response_chars` | Integer | `200_000` | Safety cap for MCP tool responses |
@@ -1300,7 +1300,7 @@ All split rules include an app overview file, so no context is lost when root fi
 
 ## Introspectors — Full List
 
-### Standard preset (13 introspectors)
+### Standard preset (14 introspectors)
 
 Core Rails structure only. Use `config.preset = :standard` for a lighter footprint.
 
@@ -1319,8 +1319,9 @@ Core Rails structure only. Use `config.preset = :standard` for a lighter footpri
 | `stimulus` | Stimulus controllers with targets, values (with types), actions, outlets, classes. Extracted from JS/TS files. |
 | `view_templates` | View file contents, partial references, Stimulus data attributes, UI pattern extraction, model field usage in partials. |
 | `design_tokens` | Auto-detects CSS framework (Tailwind v3/v4, Bootstrap, Sass, plain CSS) and extracts design tokens from config files and built CSS. |
+| `components` | ViewComponent/Phlex components: props, slots, previews, sidecar assets, usage examples. |
 
-### Full preset (28 introspectors) — default
+### Full preset (32 introspectors) — default
 
 Includes all standard introspectors plus:
 
@@ -1341,6 +1342,9 @@ Includes all standard introspectors plus:
 | `middleware` | Custom Rack middleware in app/middleware/ with detected patterns (auth, rate limiting, tenant isolation, logging). Full middleware stack. |
 | `engines` | Mounted Rails engines from routes.rb with paths and descriptions for 23+ known engines (Sidekiq::Web, Flipper::UI, PgHero, ActiveAdmin, etc.). |
 | `multi_database` | Multiple databases, replicas, sharding config, model-specific `connects_to` declarations. database.yml parsing fallback. |
+| `accessibility` | ARIA attributes, semantic HTML elements, screen reader text, alt text coverage, landmark roles, accessibility score. |
+| `performance` | N+1 query risks, missing counter_cache, missing FK indexes, Model.all anti-patterns, eager load candidates. |
+| `frontend_frameworks` | Frontend JS framework detection (React/Vue/Svelte/Angular), mounting strategy (Inertia/react-rails), TypeScript config, state management, package manager. |
 | `database_stats` | PostgreSQL approximate row counts via `pg_stat_user_tables`. **Opt-in only** — not in any preset, add manually: `config.introspectors += [:database_stats]`. |
 
 ### Using the standard preset
@@ -1432,11 +1436,11 @@ OpenCode uses **per-directory lazy-loading**: when the agent reads a file, it wa
 
 | Setup | Coverage | Notes |
 |-------|----------|-------|
-| Rails full-stack (ERB + Hotwire) | 29/29 | All introspectors relevant |
-| Rails + Inertia.js (React/Vue) | ~22/29 | Views/Turbo partially useful, backend fully covered |
-| Rails API + React/Next.js SPA | ~20/29 | Schema, models, routes, API, auth, jobs — all covered |
-| Rails API + mobile app | ~20/29 | Same as SPA — backend introspection is identical |
-| Rails engine (mountable gem) | ~15/29 | Core introspectors (schema, models, routes, gems) work |
+| Rails full-stack (ERB + Hotwire) | 32/32 | All introspectors relevant |
+| Rails + Inertia.js (React/Vue) | ~25/32 | Views/Turbo partially useful, backend fully covered |
+| Rails API + React/Next.js SPA | ~23/32 | Schema, models, routes, API, auth, jobs — all covered |
+| Rails API + mobile app | ~23/32 | Same as SPA — backend introspection is identical |
+| Rails engine (mountable gem) | ~18/32 | Core introspectors (schema, models, routes, gems) work |
 
 Frontend introspectors (views, Turbo, Stimulus, assets) degrade gracefully — they report nothing when those features aren't present.