rails-ai-context 3.1.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6bdb0dcbde3c7abfab69bee14e661afc8a260fe3d00faa99ecc4becbc58a19b
-  data.tar.gz: deacfa10c6c188d0482fc82199f085b4f13cbf24b0cf06e0977074ecf67864d8
+  metadata.gz: c4dfcbb5d44af0ed1defb25731f71a4777f9e0905dd662f0e7fa3ff83a870f02
+  data.tar.gz: 8321f5166e78daa800a68c34f05b4b30eb83c6096a43d87916463d4ff7f07ee2
 SHA512:
-  metadata.gz: bf049844c52cd8b88371a352907b08c9863668424ae37f9393d72c7210501c21fcc2ea3df797e59184b603b98e723f0bd07ebb4e36503852344c27d96970a308
-  data.tar.gz: ab5cf1f7f4031d605db8f076da5544ede9c1aa48d426dc57482a45551d46741c687caaaf0e8722932d8d982c6a9af5c86f425e117a80bcb88b36d2d1d761040f
+  metadata.gz: e66d58d898c8136321ba0d7bd3e188a446f219746bbb2073f73bf9b270b7e71ff0e776afa568ab91f9abe4343e9957b066384c63d0571d68592643bf740811ea
+  data.tar.gz: fcfc393aa754c35ee729157322e58fd03d47649ddd4c1e4d68ff8e6f40c4498ab2c9375381c28e10b0016880cf0672ed030de927d432762651b32493e7a64889

data/CHANGELOG.md

@@ -5,6 +5,44 @@ 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.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/` — 32 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)
+- `lib/rails_ai_context/tools/` — 29 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,28 @@ 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` (31) 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 29 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 29 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 reversibility warnings and affected model detection via `rails_migration_advisor`
 
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (681 examples)
+bundle exec rspec           # Run specs (806 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/     # 32 introspectors (schema, models, routes, etc.)
+├── tools/             # 29 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 806 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 29 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 29 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
+## 29 Tools
 
 Every tool is **read-only** and returns structured, token-efficient data.
 
@@ -209,6 +209,11 @@ 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 |
 
 > **[Full parameter docs →](docs/GUIDE.md)**
 
@@ -221,7 +226,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 (32 introspectors)
                          ▼
 ┌─────────────────────────────────────────────────────────┐
 │  rails-ai-context                                        │
@@ -231,7 +236,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        │ │  29 tools   │ │  Same 29 tools      │
 │  .cursor/rules/   │ │  stdio/HTTP │ │  No server needed   │
 │  .github/instr... │ │  .mcp.json  │ │  rails 'ai:tool[X]' │
 └──────────────────┘ └────────────┘ └────────────────────┘
@@ -267,7 +272,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 29 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 +292,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 (31 introspectors, default) or :standard (14 core)
   # config.preset = :full
 
   # Exclude models from introspection
@@ -305,7 +310,7 @@ end
 |--------|---------|-------------|
 | **Presets & Introspectors** | | |
 | `preset` | `:full` | Introspector preset (`:full` or `:standard`) |
-| `introspectors` | 28 (full) | Array of introspector symbols |
+| `introspectors` | 31 (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 +345,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       # 806 examples
 bundle exec rubocop     # Lint
 ```
 

data/SECURITY.md

@@ -4,8 +4,10 @@
 
 | Version | Supported          |
 |---------|--------------------|
-| 3.0.x   | :white_check_mark: |
-| 2.0.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 +24,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 29 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 29 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 29 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 29 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 (31 introspectors, default) or :standard (14 core)
   config.preset = :full
 
   # Cherry-pick on top of a preset
@@ -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 (31 introspectors) — default
 
 Includes all standard introspectors plus:
 
@@ -1341,6 +1342,8 @@ 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. |
 | `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 +1435,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.
 

data/lib/rails_ai_context/configuration.rb

@@ -3,10 +3,11 @@
 module RailsAiContext
   class Configuration
     PRESETS = {
-      standard: %i[schema models routes jobs gems conventions controllers tests migrations stimulus view_templates design_tokens config],
+      standard: %i[schema models routes jobs gems conventions controllers tests migrations stimulus view_templates design_tokens config components],
       full: %i[schema models routes jobs gems conventions stimulus 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]
+               devops action_mailbox migrations seeds middleware engines multi_database
+               components accessibility performance]
     }.freeze
 
     # MCP server settings

data/lib/rails_ai_context/introspector.rb

@@ -76,6 +76,9 @@ module RailsAiContext
       when :middleware       then Introspectors::MiddlewareIntrospector.new(app)
       when :engines         then Introspectors::EngineIntrospector.new(app)
       when :multi_database  then Introspectors::MultiDatabaseIntrospector.new(app)
+      when :components      then Introspectors::ComponentIntrospector.new(app)
+      when :accessibility   then Introspectors::AccessibilityIntrospector.new(app)
+      when :performance     then Introspectors::PerformanceIntrospector.new(app)
       else
         raise ConfigurationError, "Unknown introspector: #{name}"
       end

data/lib/rails_ai_context/introspectors/accessibility_introspector.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Introspectors
+    # Scans view templates for accessibility patterns: ARIA attributes,
+    # semantic HTML elements, screen reader text, alt text, label associations.
+    class AccessibilityIntrospector
+      attr_reader :app
+
+      def initialize(app)
+        @app = app
+      end
+
+      def call
+        views = collect_view_content
+        {
+          aria_attributes: extract_aria_attributes(views),
+          roles: extract_roles(views),
+          semantic_elements: count_semantic_elements(views),
+          screen_reader_text: count_screen_reader_text(views),
+          images: analyze_images(views),
+          labels: analyze_labels(views),
+          landmarks: extract_landmarks(views),
+          summary: build_summary(views)
+        }
+      rescue => e
+        { error: e.message }
+      end
+
+      private
+
+      def root
+        app.root.to_s
+      end
+
+      def views_dir
+        File.join(root, "app/views")
+      end
+
+      def components_dir
+        File.join(root, "app/components")
+      end
+
+      def collect_view_content
+        views = []
+
+        [ views_dir, components_dir ].each do |dir|
+          next unless Dir.exist?(dir)
+
+          Dir.glob(File.join(dir, "**/*.{erb,haml,slim,html}")).each do |path|
+            content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+            views << { file: path.sub("#{root}/", ""), content: content }
+          rescue
+            next
+          end
+        end
+
+        views
+      end
+
+      def extract_aria_attributes(views)
+        attributes = Hash.new(0)
+        views.each do |view|
+          view[:content].scan(/aria-(\w+[-\w]*)/) do |attr,|
+            attributes["aria-#{attr}"] += 1
+          end
+        end
+        attributes.sort_by { |_, count| -count }.to_h
+      end
+
+      def extract_roles(views)
+        roles = Hash.new(0)
+        views.each do |view|
+          view[:content].scan(/role=["'](\w+)["']/) do |role,|
+            roles[role] += 1
+          end
+        end
+        roles.sort_by { |_, count| -count }.to_h
+      end
+
+      def count_semantic_elements(views)
+        elements = %w[nav main header footer article section aside figure figcaption details summary dialog]
+        counts = {}
+
+        all_content = views.map { |v| v[:content] }.join("\n")
+        elements.each do |el|
+          count = all_content.scan(/<#{el}[\s>]/).size
+          counts[el] = count if count > 0
+        end
+
+        counts
+      end
+
+      def count_screen_reader_text(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+
+        {
+          sr_only: all_content.scan(/\bsr-only\b/).size,
+          visually_hidden: all_content.scan(/\bvisually-hidden\b/).size,
+          aria_hidden: all_content.scan(/aria-hidden=["']true["']/).size
+        }
+      end
+
+      def analyze_images(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+
+        # Count img tags with and without alt
+        img_with_alt = all_content.scan(/<img\b[^>]*\balt=/).size
+        img_total = all_content.scan(/<img\b/).size
+        # image_tag helper always generates alt (from filename if not provided)
+        image_tag_count = all_content.scan(/image_tag\b/).size
+
+        {
+          total: img_total + image_tag_count,
+          with_alt: img_with_alt + image_tag_count,
+          missing_alt: [ img_total - img_with_alt, 0 ].max,
+          decorative: all_content.scan(/alt=["']\s*["']/).size
+        }
+      end
+
+      def analyze_labels(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+
+        {
+          label_for: all_content.scan(/<label\b[^>]*\bfor=/).size +
+                     all_content.scan(/\.label\s+:\w+/).size,
+          aria_label: all_content.scan(/aria-label=/).size,
+          aria_labelledby: all_content.scan(/aria-labelled?by=/).size,
+          aria_describedby: all_content.scan(/aria-describedby=/).size
+        }
+      end
+
+      def extract_landmarks(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+
+        landmarks = {}
+        %w[banner navigation main complementary contentinfo search form].each do |role|
+          count = all_content.scan(/role=["']#{role}["']/).size
+          landmarks[role] = count if count > 0
+        end
+
+        # Semantic elements that imply landmarks
+        { "banner" => "header", "navigation" => "nav", "main" => "main",
+          "complementary" => "aside", "contentinfo" => "footer" }.each do |role, el|
+          tag_count = all_content.scan(/<#{el}[\s>]/).size
+          landmarks[role] = (landmarks[role] || 0) + tag_count if tag_count > 0
+        end
+
+        landmarks
+      end
+
+      def build_summary(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+
+        aria_count = all_content.scan(/aria-\w+/).size
+        role_count = all_content.scan(/role=["']\w+["']/).size
+        semantic_count = %w[nav main header footer article section aside].sum { |el|
+          all_content.scan(/<#{el}[\s>]/).size
+        }
+
+        total_signals = aria_count + role_count + semantic_count
+        file_count = views.size
+
+        score = if file_count == 0
+          0
+        else
+          signals_per_file = total_signals.to_f / file_count
+          case signals_per_file
+          when 0..0.5 then 1
+          when 0.5..1.5 then 2
+          when 1.5..3 then 3
+          when 3..5 then 4
+          else 5
+          end
+        end
+
+        {
+          files_scanned: file_count,
+          total_aria_attributes: aria_count,
+          total_roles: role_count,
+          total_semantic_elements: semantic_count,
+          accessibility_score: score,
+          score_label: %w[none minimal basic good excellent][score > 0 ? score - 1 : 0]
+        }
+      end
+    end
+  end
+end

data/lib/rails_ai_context/introspectors/auth_introspector.rb

@@ -15,7 +15,8 @@ module RailsAiContext
         {
           authentication: detect_authentication,
           authorization: detect_authorization,
-          security: detect_security
+          security: detect_security,
+          devise_modules_per_model: detect_devise_modules_per_model
         }
       rescue => e
         { error: e.message }
@@ -81,6 +82,30 @@ module RailsAiContext
         security
       end
 
+      def detect_devise_modules_per_model
+        models_dir = File.join(root, "app/models")
+        return {} unless Dir.exist?(models_dir)
+
+        result = {}
+        Dir.glob(File.join(models_dir, "**/*.rb")).each do |path|
+          content = File.read(path) rescue next
+          next unless content.match?(/\bdevise\b/)
+
+          model_name = File.basename(path, ".rb").camelize
+          # Extract devise modules, handling multiline declarations with trailing commas
+          # Join continuation lines (lines starting with whitespace + colon after a line ending with comma)
+          devise_block = content.scan(/devise\s+((?:.*,\s*\n)*.*?)$/m).flatten.first
+          next unless devise_block
+
+          modules = devise_block.scan(/:(\w+)/).flatten
+          result[model_name] = modules if modules.any?
+        end
+
+        result
+      rescue
+        {}
+      end
+
       def scan_models_for(pattern)
         models_dir = File.join(root, "app/models")
         return [] unless Dir.exist?(models_dir)