rails-ai-context 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2116ee4ebdfbdfeeef7e91c6a4ebd9d618a84ed182cdc1d012b90c362b2a6cf
-  data.tar.gz: e1a084f0f348a1c549c123aa305e75c51eb45632c1c46dec396c1e6f36b3dc4e
+  metadata.gz: f4f1bb24cd5ba8134913a1ac5ba7bbf28720a89aa1b80d9673692389d329a2ea
+  data.tar.gz: bc7afb4e33a1e2935beefa4e0bdefc879b7b1d486a9d8b694040d51abd764a9e
 SHA512:
-  metadata.gz: 2d919dc0670b50c31496866b354f215413828af302cd4d63089577d64a3253f1e5150a326ef29de16d32a29a30b3ada440a16ca1500284109e92aceb4904014b
-  data.tar.gz: f12682e40ce7733d1dd068fd47055ba74b40e474735dea7633ae38ae6b403d8027cfae89eb5ab3eab4e3d44f9acc10253148b467267305a22bd2e482f39b177d
+  metadata.gz: 92889b3f4f6be035241beb7cc8cd95633d44867b6c4b3e0c1e6bc2bc461c51ae649e91f49a07fa32d6d55ed22af408f271a4c744a7ceb8e970355ef2289b7d25
+  data.tar.gz: 8d4d623a38995ebf0b31dd673e4bfb80fb459b5ce16169562b7a1b3e0ffba2c6f2549f0508ae000c256e7eddc290cdaf234604f2eba70b302c9f0e8c9f59d4c8

data/CHANGELOG.md

@@ -5,6 +5,68 @@ 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.13.0] - 2026-03-20
+
+### Added
+
+- **`rails_validate` MCP tool** — batch syntax validation for Ruby, ERB, and JavaScript files. Replaces separate `ruby -c`, ERB check, and `node -c` calls. Returns pass/fail for each file with error details. Uses `Open3.capture2e` (no shell execution). Falls back to brace-matching when Node.js is unavailable.
+- **Model constants extraction** — introspects `STATUSES = %w[...]` style constants and includes them in model context.
+- **Global before_actions in controller rules** — OpenCode AGENTS.md now shows ApplicationController before_actions.
+- **Service objects and jobs listed** — OpenCode controller AGENTS.md now lists service objects and background jobs.
+- **Validate spec** — 8 tests covering happy path, syntax errors, path traversal, MAX_FILES, unsupported types.
+
+### Security
+
+- **Validate tool uses Open3 array form** — no shell execution for `ruby -c`, ERB compilation, or `node -c`. Fixed critical shell quoting bug in ERB validation that caused it to always fail.
+- **File size limit** on JavaScript fallback validation (2MB).
+- **`which node` check uses array form** — `system("which", "node")` instead of shell string.
+
+### Fixed
+
+- ERB validation was broken due to shell quoting bug (backticks + nested quotes). Replaced with `Open3.capture2e("ruby", "-e", script, ARGV[0])`.
+- Rubocop offenses in validate.rb (18 spacing issues auto-corrected).
+
+## [0.12.0] - 2026-03-20
+
+### Added
+
+- **Design Token Introspector** — auto-detects CSS framework and extracts tokens from Tailwind v3/v4, Bootstrap/Sass, plain CSS custom properties, Webpacker-era stylesheets, and ViewComponent sidecar CSS. Tested across 8 CSS setups. Added to standard preset.
+- **`rails_get_edit_context` MCP tool** — purpose-built for surgical edits. Returns code around a match point with line numbers. Replaces the Read + Edit workflow with a single call.
+- **Line numbers in action source** — `rails_get_controllers(action: "index")` now returns start/end line numbers for targeted editing.
+- **Model file structure** — `rails_get_model_details(model: "Cook")` now returns line ranges for each section (associations, validations, scopes, etc.).
+
+### Changed
+
+- **MCP instructions updated** — "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit." Prevents unnecessary double-reads.
+- **UI pattern extractor rewritten** — semantic labels (primary/secondary/danger), deduplication, 12+ component types, color scheme + radius + form layout extraction, framework-agnostic.
+- **Schema rules include column types** — `status:string, intake:jsonb` instead of just names. Also shows foreign keys, indexes, and enum values.
+- **View standard detail enhanced** — shows partial fields, helper methods, and shared partials.
+
+### Security
+
+- **File.realpath symlink protection** on all file-reading tools (get_view, get_edit_context, get_test_info, search_code).
+- **File size limits** — 2MB on controllers/models/views, 500KB on test files.
+- **Ripgrep flag injection prevention** — `--` separator before user pattern.
+- **Nil guards** on all component rendering across 10 serializers.
+- **Non-greedy regex** — ReDoS prevention in card/input/label pattern matching.
+- **UTF-8 encoding safety** — all File.read calls handle binary/non-UTF-8 files gracefully.
+
+### Fixed
+
+- Off-by-one in model structure section line ranges.
+- Stimulus sort crash on nil controller name.
+- Secondary button picking up disabled states (`cursor-not-allowed`).
+- Progress bars misclassified as badges.
+- Input detection picking up alert divs instead of actual inputs.
+
+## [0.11.0] - 2026-03-20
+
+### Added
+
+- **UI pattern extraction** — scans all views for repeated CSS class patterns. Detects buttons, cards, inputs, labels, badges, links, headings, flashes, alerts. Added to ALL serializers (root files + split rules for Claude, Cursor, Windsurf, Copilot, OpenCode).
+- **View partial structure** — `rails_get_view(detail: "standard")` shows model fields and helper methods used by each partial.
+- **Schema column names** — `.claude/rules/rails-schema.md` shows key column names with types, foreign keys, indexes, and enum values. Keeps polymorphic `_type`, STI `type`, and soft-delete `deleted_at` columns.
+
 ## [0.10.0] - 2026-03-19
 
 ### Added

data/CLAUDE.md

@@ -9,7 +9,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 - `lib/rails_ai_context/configuration.rb` — User-facing config with presets (:standard, :full)
 - `lib/rails_ai_context/introspector.rb` — Orchestrates sub-introspectors
 - `lib/rails_ai_context/introspectors/` — 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/` — 12 MCP tools using the official mcp SDK
+- `lib/rails_ai_context/tools/` — 13 MCP tools using the official mcp SDK
 - `lib/rails_ai_context/serializers/` — Output formatters (claude, claude_rules, opencode, cursor_rules, windsurf, windsurf_rules, copilot, copilot_instructions, rules, markdown, JSON)
 - `lib/rails_ai_context/resources.rb` — MCP resources (static data AI clients read directly)
 - `lib/rails_ai_context/server.rb` — MCP server configuration (stdio + HTTP transports)
@@ -42,7 +42,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (481 examples)
+bundle exec rspec           # Run specs (491 examples)
 bundle exec rubocop         # Lint
 ```
 

data/CONTRIBUTING.md

@@ -19,7 +19,7 @@ The test suite uses [Combustion](https://github.com/pat/combustion) to boot a mi
 ```
 lib/rails_ai_context/
 ├── introspectors/     # 29 introspectors (schema, models, routes, etc.)
-├── tools/             # 12 MCP tools with detail levels and pagination
+├── tools/             # 13 MCP tools with detail levels and pagination
 ├── serializers/       # Per-assistant formatters (claude, opencode, cursor, windsurf, copilot, JSON)
 ├── server.rb          # MCP server setup (stdio + HTTP)
 ├── live_reload.rb     # MCP live reload (file watcher + cache invalidation)

data/README.md

@@ -27,7 +27,7 @@ Same task — *"Add status and date range filters to the Cooks index page"* —
 
 | Setup | Tokens | Saved | What it knows |
 |-------|--------|-------|---------------|
-| **rails-ai-context (full)** | **28,834** | **37%** | 12 MCP tools + generated docs + rules |
+| **rails-ai-context (full)** | **28,834** | **37%** | 13 MCP tools + generated docs + rules |
 | rails-ai-context CLAUDE.md only | 33,106 | 27% | Generated docs + rules, no MCP tools |
 | Normal Claude `/init` | 40,700 | 11% | Generic CLAUDE.md only |
 | No rails-ai-context at all | 45,477 | baseline | Nothing — discovers everything from scratch |
@@ -95,9 +95,9 @@ The install generator creates `.mcp.json` for auto-discovery — Claude Code and
 
 ---
 
-## 12 Live MCP Tools
+## 13 Live MCP Tools
 
-The gem exposes **12 read-only tools** via MCP that AI clients call on-demand:
+The gem exposes **13 read-only tools** via MCP that AI clients call on-demand:
 
 | Tool | What it returns |
 |------|----------------|
@@ -113,6 +113,7 @@ The gem exposes **12 read-only tools** via MCP that AI clients call on-demand:
 | `rails_get_view` | View templates, partials, Stimulus references |
 | `rails_get_stimulus` | Stimulus controllers — targets, values, actions, outlets |
 | `rails_get_edit_context` | Surgical edit helper — returns code around a match with line numbers |
+| `rails_validate` | Batch syntax validation for Ruby, ERB, and JavaScript files |
 
 ### Smart Detail Levels
 
@@ -352,10 +353,10 @@ Works with every Rails architecture — auto-detects what's relevant:
 | Setup | Coverage | Notes |
 |-------|----------|-------|
 | Rails full-stack (ERB + Hotwire) | 29/29 | All introspectors relevant |
-| Rails + Inertia.js (React/Vue) | ~22/27 | Views/Turbo partially useful, backend fully covered |
-| Rails API + React/Next.js SPA | ~20/27 | Schema, models, routes, API, auth, jobs — all covered |
-| Rails API + mobile app | ~20/27 | Same as SPA — backend introspection is identical |
-| Rails engine (mountable gem) | ~15/27 | Core introspectors (schema, models, routes, gems) work |
+| 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 |
 
 Frontend introspectors (views, Turbo, Stimulus, assets) degrade gracefully — they report nothing when those features aren't present.
 
@@ -390,7 +391,7 @@ The gem parses `db/schema.rb` as text when no database is connected. Works in CI
 ```bash
 git clone https://github.com/crisnahine/rails-ai-context.git
 cd rails-ai-context && bundle install
-bundle exec rspec       # 481 examples
+bundle exec rspec       # 491 examples
 bundle exec rubocop     # Lint
 ```
 

data/demo_script.sh

@@ -8,7 +8,7 @@ echo 'Fetching gem metadata from https://rubygems.org...'
 sleep 0.3
 echo 'Resolving dependencies...'
 sleep 0.3
-echo 'Installing rails-ai-context 0.12.0'
+echo 'Installing rails-ai-context 0.13.0'
 echo ''
 sleep 1
 

data/docs/GUIDE.md

@@ -246,7 +246,7 @@ rails ai:context:claude           # Use this instead (no quoting needed)
 
 ## MCP Tools — Full Reference
 
-All 12 tools are **read-only** and **idempotent** — they never modify your application or database.
+All 13 tools are **read-only** and **idempotent** — they never modify your application or database.
 
 ### rails_get_schema
 
@@ -568,7 +568,7 @@ RailsAiContext.configure do |config|
 end
 ```
 
-Both transports are **read-only** — they expose the same 12 tools and never modify your app.
+Both transports are **read-only** — they expose the same 13 tools and never modify your app.
 
 ---
 
@@ -673,7 +673,7 @@ All split rules include an app overview file, so no context is lost when root fi
 
 ## Introspectors — Full List
 
-### Standard preset (9 introspectors)
+### Standard preset (12 introspectors)
 
 These run by default. Fast and cover core Rails structure.
 
@@ -689,7 +689,7 @@ These run by default. Fast and cover core Rails structure.
 | `tests` | Test framework (rspec/minitest), factories/fixtures with locations and counts, system tests, CI config files, coverage tool, test helpers, VCR cassettes. |
 | `migrations` | Total count, schema version, pending migrations, recent migration history with detected actions (create_table, add_column, etc.), migration statistics. |
 
-### Full preset (29 introspectors)
+### Full preset (28 introspectors)
 
 Includes all standard introspectors plus:
 
@@ -813,10 +813,10 @@ 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/27 | Views/Turbo partially useful, backend fully covered |
-| Rails API + React/Next.js SPA | ~20/27 | Schema, models, routes, API, auth, jobs — all covered |
-| Rails API + mobile app | ~20/27 | Same as SPA — backend introspection is identical |
-| Rails engine (mountable gem) | ~15/27 | Core introspectors (schema, models, routes, gems) work |
+| 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 |
 
 Frontend introspectors (views, Turbo, Stimulus, assets) degrade gracefully — they report nothing when those features aren't present.
 

data/lib/rails_ai_context/introspectors/model_introspector.rb

@@ -179,6 +179,12 @@ module RailsAiContext
         macros[:serialize] = source.scan(/\bserialize\s+:(\w+)/).flatten if source.match?(/\bserialize\s+:/)
         macros[:store] = source.scan(/\bstore(?:_accessor)?\s+:(\w+)/).flatten if source.match?(/\bstore(?:_accessor)?\s+:/)
 
+        # Constants with value lists (e.g. STATUSES = %w[pending completed])
+        constants = source.scan(/\b([A-Z][A-Z_]+)\s*=\s*%[wi]\[([^\]]+)\]/).map do |name, values|
+          { name: name, values: values.split }
+        end
+        macros[:constants] = constants if constants.any?
+
         # Delegations
         delegations = source.scan(/\bdelegate\s+(.+?),\s*to:\s*:(\w+)/m).map do |methods_str, target|
           { methods: methods_str.scan(/:(\w+)/).flatten, to: target }

data/lib/rails_ai_context/serializers/claude_rules_serializer.rb

@@ -77,6 +77,19 @@ module RailsAiContext
           (conv[:architecture] || []).first(5).each { |p| lines << "- #{p}" }
         end
 
+        # ApplicationController before_actions — apply to all controllers
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          app_ctrl_file = File.join(root, "app", "controllers", "application_controller.rb")
+          if File.exist?(app_ctrl_file)
+            source = File.read(app_ctrl_file)
+            before_actions = source.scan(/before_action\s+:(\w+)/).flatten
+            if before_actions.any?
+              lines << "" << "**Global before_actions:** #{before_actions.join(', ')}"
+            end
+          end
+        rescue; end
+
         lines << ""
         lines << "Use MCP tools for detailed data. Start with `detail:\"summary\"`."
 
@@ -92,8 +105,8 @@ module RailsAiContext
         lines = [
           "# Database Tables (#{tables.size})",
           "",
-          "DO NOT read db/schema.rb directly. Use the `rails_get_schema` MCP tool instead.",
-          "Call with `detail:\"summary\"` first, then `table:\"name\"` for specifics.",
+          "All columns with types are listed below — no need to read db/schema.rb.",
+          "For indexes, foreign keys, or constraints, use `rails_get_schema(table:\"name\")`.",
           ""
         ]
 
@@ -118,8 +131,7 @@ module RailsAiContext
             true
           end
 
-          col_sample = key_cols.first(10).map { |c| "#{c[:name]}:#{c[:type]}" }
-          col_sample << "..." if key_cols.size > 10
+          col_sample = key_cols.map { |c| "#{c[:name]}:#{c[:type]}" }
           col_str = col_sample.any? ? " — #{col_sample.join(', ')}" : ""
 
           # Foreign keys
@@ -158,8 +170,8 @@ module RailsAiContext
         lines = [
           "# ActiveRecord Models (#{models.size})",
           "",
-          "DO NOT read model files to check associations/validations. Use `rails_get_model_details` MCP tool instead.",
-          "Call with `detail:\"summary\"` first, then `model:\"Name\"` for specifics.",
+          "Check this file first for associations, scopes, constants, and validations.",
+          "If you need more detail (callbacks, methods, business logic), use `rails_get_model_details(model:\"Name\")` or Read the file directly.",
           ""
         ]
 
@@ -172,6 +184,39 @@ module RailsAiContext
           line += " (table: #{table})" if table
           line += " — #{assocs} assocs, #{vals} validations"
           lines << line
+
+          # Include app-specific concerns (filter out Rails/gem internals)
+          noise = %w[GeneratedAssociationMethods GeneratedAttributeMethods Kernel PP ObjectMixin
+                     GlobalID Bullet ActionText Turbo ActiveStorage JSON]
+          concerns = (data[:concerns] || []).select { |c|
+            !noise.any? { |n| c.include?(n) } && !c.start_with?("Devise") && !c.include?("::")
+          }
+          lines << "  concerns: #{concerns.join(', ')}" if concerns.any?
+
+          # Include scopes so agents know available query methods
+          scopes = data[:scopes] || []
+          lines << "  scopes: #{scopes.join(', ')}" if scopes.any?
+
+          # Include app-specific instance methods (filter out Rails-generated ones)
+          generated_patterns = %w[build_ create_ reload_ reset_ _changed? _previously_changed?
+                                  _ids _ids= _before_last_save _before_type_cast _came_from_user?
+                                  _for_database _in_database _was]
+          methods = (data[:instance_methods] || []).reject { |m|
+            generated_patterns.any? { |p| m.include?(p) } || m.end_with?("=")
+          }.first(10)
+          lines << "  methods: #{methods.join(', ')}" if methods.any?
+
+          # Include constants (e.g. STATUSES, MODES) so agents know valid values
+          constants = data[:constants] || []
+          constants.each do |c|
+            lines << "  #{c[:name]}: #{c[:values].join(', ')}"
+          end
+
+          # Include enums so agents know valid values
+          enums = data[:enums] || {}
+          enums.each do |attr, values|
+            lines << "  #{attr}: #{values.join(', ')}"
+          end
         end
 
         lines.join("\n")
@@ -210,6 +255,45 @@ module RailsAiContext
           lines << "- Grid: #{fl[:grid]}" if fl[:grid]
         end
 
+        # Shared partials — so agents reuse them instead of recreating
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          shared_dir = File.join(root, "app", "views", "shared")
+          if Dir.exist?(shared_dir)
+            partials = Dir.glob(File.join(shared_dir, "_*.html.erb"))
+              .map { |f| File.basename(f) }
+              .sort
+            if partials.any?
+              lines << "" << "## Shared partials (app/views/shared/)"
+              partials.each { |p| lines << "- #{p}" }
+            end
+          end
+        rescue; end
+
+        # Helpers — so agents use existing helpers instead of creating new ones
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          helper_file = File.join(root, "app", "helpers", "application_helper.rb")
+          if File.exist?(helper_file)
+            helper_methods = File.read(helper_file).scan(/def\s+(\w+)/).flatten
+            if helper_methods.any?
+              lines << "" << "## Helpers (ApplicationHelper)"
+              lines << helper_methods.map { |m| "- #{m}" }.join("\n")
+            end
+          end
+        rescue; end
+
+        # Stimulus controllers — so agents reuse existing controllers
+        stim = context[:stimulus]
+        if stim.is_a?(Hash) && !stim[:error]
+          controllers = stim[:controllers] || []
+          if controllers.any?
+            names = controllers.map { |c| c[:name] || c[:file]&.gsub("_controller.js", "") }.compact.sort
+            lines << "" << "## Stimulus controllers"
+            lines << names.join(", ")
+          end
+        end
+
         lines.join("\n")
       end
 
@@ -218,26 +302,30 @@ module RailsAiContext
           "# Rails MCP Tools — ALWAYS Use These First",
           "",
           "IMPORTANT: This project has live MCP tools that return parsed, up-to-date data.",
-          "ALWAYS use these tools BEFORE reading files like db/schema.rb, config/routes.rb, or model source files.",
-          "The tools return structured, token-efficient summaries. Reading raw files wastes tokens and may be stale.",
+          "Use these tools for reference-only files (schema, routes, tests). For files you will edit, Read them directly.",
+          "The tools return structured, token-efficient summaries with line numbers.",
           "",
           "## When to use MCP tools vs Read",
           "- Use MCP for files you WON'T edit (schema, routes, understanding context)",
           "- For files you WILL edit, just Read them directly — you need Read before Edit anyway",
           "- Use MCP for orientation (summary calls) on large codebases",
           "- Skip MCP when CLAUDE.md + rules already have the info you need",
+          "- Do NOT call rails_get_model_details if CLAUDE.md already shows the model's associations and column types",
+          "- Do NOT call rails_get_stimulus just to check if Stimulus exists — CLAUDE.md confirms it",
           "",
-          "## MCP tools return line numbers — use for surgical edits",
-          "- `rails_get_controllers(action:\"index\")` returns source with line numbers",
-          "- `rails_get_model_details(model:\"Cook\")` returns file structure with line ranges",
-          "- `rails_get_view(path:\"cooks/index.html.erb\")` returns full template",
+          "## After editing — ALWAYS use rails_validate (not Bash)",
+          "- `rails_validate(files:[\"app/models/cook.rb\", \"app/controllers/cooks_controller.rb\", \"app/views/cooks/index.html.erb\"])` — one call checks all",
+          "- Do NOT run `ruby -c`, `erb` checks, or `node -c` separately — use rails_validate instead",
+          "- Do NOT re-read files to verify edits. Trust your Edit and validate syntax only.",
           "",
-          "## Reference-only files — ALWAYS use MCP instead of Read",
-          "- DO NOT read db/schema.rb — use `rails_get_schema` instead",
-          "- DO NOT read config/routes.rb — use `rails_get_routes` instead",
-          "- DO NOT read test files for patterns — use `rails_get_test_info(detail:\"full\")` instead",
+          "## Reference-only files — check rules first, then MCP or Read if needed",
+          "- db/schema.rb — column names and types are in rails-schema.md rules. Read only if you need constraints/defaults.",
+          "- config/routes.rb — use `rails_get_routes` for reference. Read directly if you'll add routes.",
+          "- Model files — scopes, constants, enums are in rails-models.md rules. Read for business logic/methods.",
+          "- app/javascript/controllers/index.js — Stimulus auto-registers controllers. No need to read.",
+          "- Test files — use `rails_get_test_info(detail:\"full\")` for patterns.",
           "",
-          "## Tools (12)",
+          "## Tools (13)",
           "",
           "**rails_get_schema** — database tables, columns, indexes, foreign keys",
           "- `rails_get_schema(detail:\"summary\")` — all tables with column counts",
@@ -271,6 +359,9 @@ module RailsAiContext
           "**rails_get_edit_context** — surgical edit helper with line numbers",
           "- `rails_get_edit_context(file:\"app/models/cook.rb\", near:\"scope\")` — returns code around match with line numbers",
           "",
+          "**rails_validate** — syntax checker for edited files",
+          "- `rails_validate(files:[\"app/models/cook.rb\"])` — checks Ruby, ERB, JS syntax in one call",
+          "",
           "**rails_get_config** — cache store, session, timezone, middleware, initializers",
           "**rails_get_gems** — notable gems categorized by function",
           "**rails_get_conventions** — architecture patterns, directory structure",

data/lib/rails_ai_context/serializers/claude_serializer.rb

@@ -122,6 +122,14 @@ module RailsAiContext
           line += " (#{assoc_count}a, #{val_count}v)" if assoc_count > 0 || val_count > 0
           line += " — #{top_assocs}" if top_assocs && !top_assocs.empty?
           lines << line
+          scopes = (data[:scopes] || [])
+          constants = (data[:constants] || [])
+          if scopes.any? || constants.any?
+            extras = []
+            extras << "scopes: #{scopes.join(', ')}" if scopes.any?
+            constants.each { |c| extras << "#{c[:name]}: #{c[:values].join(', ')}" }
+            lines << "  #{extras.join(' | ')}"
+          end
         end
         lines << "- _...#{models.size - max_show} more (use `rails_get_model_details` tool)_" if models.size > max_show
         lines << ""
@@ -155,6 +163,30 @@ module RailsAiContext
         lines = [ "## Architecture" ]
         arch.each { |p| lines << "- #{p}" }
         patterns.first(8).each { |p| lines << "- #{p}" }
+
+        # List service objects and jobs from conventions directory_structure
+        dir_struct = conv[:directory_structure] || {}
+
+        if dir_struct["app/services"]
+          begin
+            root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+            service_files = Dir.glob(File.join(root, "app", "services", "*.rb"))
+              .map { |f| File.basename(f, ".rb").camelize }
+              .reject { |s| s == "ApplicationService" }
+            lines << "" << "**Services:** #{service_files.join(', ')}" if service_files.any?
+          rescue; end
+        end
+
+        if dir_struct["app/jobs"]
+          begin
+            root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+            job_files = Dir.glob(File.join(root, "app", "jobs", "*.rb"))
+              .map { |f| File.basename(f, ".rb").camelize }
+              .reject { |j| j == "ApplicationJob" }
+            lines << "**Jobs:** #{job_files.join(', ')}" if job_files.any?
+          rescue; end
+        end
+
         lines << ""
         lines
       end
@@ -193,7 +225,7 @@ module RailsAiContext
 
       def render_mcp_guide # rubocop:disable Metrics/MethodLength
         [
-          "## MCP Tools (12) — ALWAYS Use These First",
+          "## MCP Tools (13) — ALWAYS Use These First",
           "",
           "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
           "MCP tools return line numbers. Start with `detail:\"summary\"`.",
@@ -206,6 +238,7 @@ module RailsAiContext
           "- `rails_get_stimulus(detail:\"summary\")` → `(controller:\"name\")` — targets, actions, values",
           "- `rails_get_test_info(detail:\"full\")` — fixtures, factories, helpers; `(model:\"Cook\")` — tests",
           "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`",
+          "- `rails_validate(files:[\"path/to/file.rb\"])` — validate Ruby, ERB, JS syntax in one call",
           ""
         ]
       end
@@ -240,6 +273,9 @@ module RailsAiContext
           "- Use the MCP tools to check schema before writing migrations",
           "- Match existing code style",
           "- Run tests after changes",
+          "- After editing, ALWAYS use `rails_validate(files:[...])` — do NOT use separate ruby -c / erb / node -c calls",
+          "- Do NOT re-read files to verify edits — trust your Edit, validate syntax only",
+          "- Stimulus controllers auto-register — no manual import in controllers/index.js needed",
           ""
         ]
       end

data/lib/rails_ai_context/serializers/copilot_instructions_serializer.rb

@@ -78,6 +78,41 @@ module RailsAiContext
           (conv[:architecture] || []).first(5).each { |p| lines << "- #{p}" }
         end
 
+        # List service objects
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          services_dir = File.join(root, "app", "services")
+          if Dir.exist?(services_dir)
+            service_files = Dir.glob(File.join(services_dir, "*.rb"))
+              .map { |f| File.basename(f, ".rb").camelize }
+              .reject { |s| s == "ApplicationService" }
+            lines << "- Services: #{service_files.join(', ')}" if service_files.any?
+          end
+        rescue; end
+
+        # List jobs
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          jobs_dir = File.join(root, "app", "jobs")
+          if Dir.exist?(jobs_dir)
+            job_files = Dir.glob(File.join(jobs_dir, "*.rb"))
+              .map { |f| File.basename(f, ".rb").camelize }
+              .reject { |j| j == "ApplicationJob" }
+            lines << "- Jobs: #{job_files.join(', ')}" if job_files.any?
+          end
+        rescue; end
+
+        # ApplicationController before_actions
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          app_ctrl = File.join(root, "app", "controllers", "application_controller.rb")
+          if File.exist?(app_ctrl)
+            source = File.read(app_ctrl)
+            before_actions = source.scan(/before_action\s+:(\w+)/).flatten
+            lines << "" << "**Global before_actions:** #{before_actions.join(', ')}" if before_actions.any?
+          end
+        rescue; end
+
         lines << ""
         lines << "Use MCP tools for detailed data. Start with `detail:\"summary\"`."
 
@@ -95,7 +130,7 @@ module RailsAiContext
           "",
           "# ActiveRecord Models (#{models.size})",
           "",
-          "Use `rails_get_model_details` MCP tool for full details.",
+          "Check here first for scopes, constants, associations. Read model files for business logic/methods.",
           ""
         ]
 
@@ -103,6 +138,14 @@ module RailsAiContext
           data = models[name]
           assocs = (data[:associations] || []).size
           lines << "- #{name} (#{assocs} associations)"
+          scopes = (data[:scopes] || [])
+          constants = (data[:constants] || [])
+          if scopes.any? || constants.any?
+            extras = []
+            extras << "scopes: #{scopes.join(', ')}" if scopes.any?
+            constants.each { |c| extras << "#{c[:name]}: #{c[:values].join(', ')}" }
+            lines << "  #{extras.join(' | ')}"
+          end
         end
 
         lines << "- ...#{models.size - 30} more" if models.size > 30
@@ -151,6 +194,43 @@ module RailsAiContext
         ]
         components.first(15).each { |c| next unless c[:label] && c[:classes]; lines << "- #{c[:label]}: `#{c[:classes]}`" }
 
+        # Shared partials
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          shared_dir = File.join(root, "app", "views", "shared")
+          if Dir.exist?(shared_dir)
+            partials = Dir.glob(File.join(shared_dir, "_*.html.erb")).map { |f| File.basename(f) }.sort
+            if partials.any?
+              lines << "" << "## Shared partials"
+              partials.each { |p| lines << "- #{p}" }
+            end
+          end
+        rescue; end
+
+        # Helpers
+        begin
+          root = defined?(Rails) ? Rails.root.to_s : Dir.pwd
+          helper_file = File.join(root, "app", "helpers", "application_helper.rb")
+          if File.exist?(helper_file)
+            helper_methods = File.read(helper_file).scan(/def\s+(\w+)/).flatten
+            if helper_methods.any?
+              lines << "" << "## Helpers (ApplicationHelper)"
+              helper_methods.each { |m| lines << "- #{m}" }
+            end
+          end
+        rescue; end
+
+        # Stimulus controllers
+        stim = context[:stimulus]
+        if stim.is_a?(Hash) && !stim[:error]
+          controllers = stim[:controllers] || []
+          if controllers.any?
+            names = controllers.map { |c| c[:name] || c[:file]&.gsub("_controller.js", "") }.compact.sort
+            lines << "" << "## Stimulus controllers"
+            lines << names.join(", ")
+          end
+        end
+
         lines.join("\n")
       end
 
@@ -160,7 +240,7 @@ module RailsAiContext
           "applyTo: \"**/*\"",
           "---",
           "",
-          "# Rails MCP Tools (12) — Use These First",
+          "# Rails MCP Tools (13) — Use These First",
           "",
           "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
           "MCP tools return line numbers for surgical edits.",
@@ -173,7 +253,11 @@ module RailsAiContext
           "- `rails_get_view(controller:\"cooks\")` — view list; `(path:\"cooks/index.html.erb\")` — content",
           "- `rails_get_stimulus(detail:\"summary\")` → `(controller:\"name\")` — targets, actions, values",
           "- `rails_get_test_info(detail:\"full\")` — fixtures, factories, helpers; `(model:\"Cook\")` — existing tests",
-          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`"
+          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`",
+          "- `rails_get_edit_context(file:\"path\", near:\"keyword\")` — surgical edit context with line numbers",
+          "- `rails_validate(files:[\"path\"])` — validate Ruby, ERB, JS syntax in one call",
+          "",
+          "After editing: use rails_validate to check syntax. Do NOT re-read files to verify."
         ]
 
         lines.join("\n")