rails-ai-context 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34ef5e454a22f9719cf4439c70867a4e2f9dc900d34e1cca0f4ecd723e3a3308
-  data.tar.gz: d7545c9afd73831f0f32e0808f82856e1cf48c3763308049f5ba54d453f3f452
+  metadata.gz: 485ed8bdee695a10d5fd05b9a578bb3ff55f918d5ea9d3ddd3a18ba56f03c3f7
+  data.tar.gz: 010af0cd0f8958e09856f08e6be2c54d87f75ab6ea7a1e3c2993523a15d18992
 SHA512:
-  metadata.gz: f29724289bcf91b5aeb776cfac4eec673a8bb8b02016108bab7a52f9f6f52b4fe5f3045cee43053a4b6e660619800dc8ea6f0141ed5bdd812d00898d00f9d7ef
-  data.tar.gz: 3178d4a6347de30aaf92e13b5db4d976fe6d2c0888de60b451bc187e9ae71518186c204c97f74e37d159431c2ea149d9fc19db00ab338bce44ffda6c33ef6da3
+  metadata.gz: 66aced48319fe77c7d5301ca154150db872d5ee682be94c5ae81af229901fb3ac950e932ce984f0f5c13d4dbfceae5f89bcb2fbe479c04ab38ec1a6fb605d7a2
+  data.tar.gz: 81cbff9c0f81ef41d1c1db9b9b97a6af606da9915c59214097dfe8386d7437250f4e6c470b59ca3c1dd8721bf21a458bbe6cf351313ff7a47cfaaab90fabb221

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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).
 
+## [2.0.1] - 2026-03-25
+
+### Fixed
+
+- **MCP-first mandatory workflow in all serializers** — all 6 serializer outputs (Claude, Cursor, Copilot, Windsurf, OpenCode) now use "MANDATORY, Use Before Read" language with structured workflow, anti-patterns table, and "Do NOT Bypass" rules. AI agents are explicitly instructed to never read reference files directly.
+- **27 type-safety bugs in serializers** — fixed `.keys` called on Array values (same pattern as #14) across `design_system_helper.rb`, `get_design_system.rb`, `markdown_serializer.rb`, and `stack_overview_helper.rb`.
+- **Strong params JSONB check** — no longer skips the entire check when JSONB columns exist. Plain-word params allowed (could be JSON keys), `_id` params still validated.
+- **Strong params test skip on Ruby < 3.3** — test now skips gracefully when Prism is unavailable, matching the tool's own degradation.
+- **Issue #14** — `multi_db[:databases].keys` crash on Array fixed.
+- **Search code NON_CODE_GLOBS** — excludes lock files, docs, CI configs, generated context from all searches.
+
 ## [2.0.0] - 2026-03-24
 
 ### Added

data/lib/rails_ai_context/serializers/claude_rules_serializer.rb

@@ -96,7 +96,8 @@ module RailsAiContext
         rescue; end
 
         lines << ""
-        lines << "Use MCP tools for detailed data. Start with `detail:\"summary\"`."
+        lines << "ALWAYS use MCP tools for context — do NOT read reference files directly."
+        lines << "Start with `detail:\"summary\"`. Read files ONLY when you will Edit them."
 
         lines.join("\n")
       end
@@ -294,31 +295,52 @@ module RailsAiContext
 
       def render_mcp_tools_reference # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
         lines = [
-          "# Rails MCP Tools — ALWAYS Use These First",
-          "",
-          "IMPORTANT: This project has live MCP tools that return parsed, up-to-date data.",
-          "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",
-          "",
-          "## 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",
+          "# Rails MCP Tools — MANDATORY, Use Before Read/Grep",
+          "",
+          "CRITICAL: This project has live MCP tools. You MUST use them for gathering context.",
+          "MCP tools return parsed, up-to-date, token-efficient data with line numbers.",
+          "Read files ONLY when you are about to Edit them. Never read reference files directly.",
+          "",
+          "## Mandatory Workflow — Follow This Order",
+          "",
+          "### 1. Gathering context (BEFORE writing any code)",
+          "- Exploring a feature area → `rails_analyze_feature(feature:\"...\")` — NOT Explore agents, NOT Grep",
+          "- Understanding a model → `rails_get_model_details(model:\"...\")` — NOT reading the model file",
+          "- Checking database columns → `rails_get_schema(table:\"...\")` — NOT reading db/schema.rb",
+          "- Checking routes → `rails_get_routes(controller:\"...\")` — NOT reading config/routes.rb",
+          "- Understanding a controller → `rails_get_controllers(controller:\"...\", action:\"...\")` — NOT reading the file",
+          "- Finding code patterns → `rails_search_code(pattern:\"...\")` — NOT using Grep tool",
+          "- UI patterns → `rails_get_design_system` — NOT reading view files for patterns",
+          "- Full cross-layer context → `rails_get_context(model:\"...\")` — replaces multiple Read calls",
+          "",
+          "### 2. Reading files (ONLY files you will edit)",
+          "- Read a file ONLY when you are about to Edit it (Read is required before Edit)",
+          "- For everything else — schema, routes, models, tests, patterns — use MCP tools above",
+          "",
+          "### 3. After editing (EVERY time, no exceptions)",
+          "- `rails_validate(files:[\"path/to/file.rb\", \"path/to/view.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 — 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.",
+          "## Do NOT Bypass — Anti-Patterns",
+          "| Instead of... | Use this MCP tool |",
+          "|---------------|-------------------|",
+          "| Reading db/schema.rb | `rails_get_schema(table:\"name\")` |",
+          "| Reading config/routes.rb for reference | `rails_get_routes(controller:\"name\")` |",
+          "| Reading model files for associations | `rails_get_model_details(model:\"Name\")` |",
+          "| Grep/Explore agent for code search | `rails_search_code(pattern:\"regex\")` |",
+          "| Reading test files for patterns | `rails_get_test_info(model:\"Name\")` |",
+          "| Reading controller files for context | `rails_get_controllers(controller:\"Name\")` |",
+          "| Reading JS files for Stimulus API | `rails_get_stimulus(controller:\"name\")` |",
+          "| Multiple reads to understand a feature | `rails_analyze_feature(feature:\"keyword\")` |",
+          "| ruby -c / erb / node -c after edits | `rails_validate(files:[...])` |",
+          "",
+          "## Reference-only files — NEVER read these, use MCP",
+          "- db/schema.rb → `rails_get_schema` (column types in rails-schema.md rules for quick checks)",
+          "- config/routes.rb → `rails_get_routes` (Read ONLY when adding routes)",
+          "- Model files → `rails_get_model_details` (Read ONLY when editing business logic)",
+          "- app/javascript/controllers/index.js → Stimulus auto-registers. Never read this.",
+          "- Test files → `rails_get_test_info`",
           "",
           "## Tools (25)",
           "",

data/lib/rails_ai_context/serializers/claude_serializer.rb

@@ -200,30 +200,38 @@ module RailsAiContext
         [
           "## MCP Tools (25) — 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\"`.",
+          "This project has live MCP tools. You MUST use them instead of reading reference files.",
+          "Start with `detail:\"summary\"`, then drill into specifics.",
           "",
-          "- `rails_get_schema(detail:\"summary\")` → `rails_get_schema(table:\"name\")`",
-          "- `rails_get_model_details(detail:\"summary\")` → `rails_get_model_details(model:\"Name\")`",
-          "- `rails_get_routes(detail:\"summary\")` → `rails_get_routes(controller:\"name\")`",
-          "- `rails_get_controllers(controller:\"Name\", action:\"index\")` — one action's source code",
-          "- `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\")` — tests",
-          "- `rails_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
-          "- `rails_get_design_system` — color palette, component patterns, canonical page examples",
-          "- `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",
-          "- `rails_security_scan` — Brakeman security analysis",
-          "- `rails_get_concern(name:\"Searchable\")` — concern methods and includers",
-          "- `rails_get_callbacks(model:\"User\")` — model callbacks in execution order",
-          "- `rails_get_helper_methods` — app + framework helpers",
-          "- `rails_get_service_pattern` — service object patterns and interfaces",
-          "- `rails_get_job_pattern` — background job patterns and schedules",
-          "- `rails_get_env` — environment variables and credentials keys",
-          "- `rails_get_partial_interface(path:\"shared/_form\")` — partial locals contract",
-          "- `rails_get_turbo_map` — Turbo Streams/Frames wiring",
-          "- `rails_get_context(model:\"User\")` — composite cross-layer context",
+          "### Mandatory Workflow",
+          "1. **Before exploring a feature**: `rails_analyze_feature(feature:\"...\")` — NOT Explore agents or Grep",
+          "2. **Before writing migrations**: `rails_get_schema(table:\"...\")` — NOT reading db/schema.rb",
+          "3. **Before modifying a model**: `rails_get_model_details(model:\"...\")` — NOT reading the model file",
+          "4. **Before adding routes**: `rails_get_routes(controller:\"...\")` — Read routes.rb only when you will edit it",
+          "5. **Before creating views**: `rails_get_design_system` — match existing patterns",
+          "6. **After editing ANY file**: `rails_validate(files:[...])` — no exceptions, no ruby -c / erb / node -c",
+          "",
+          "### Quick Reference",
+          "| Need | Use this MCP tool | Do NOT use |",
+          "|------|-------------------|------------|",
+          "| Column types | `rails_get_schema(table:\"x\")` | Read db/schema.rb |",
+          "| Model associations | `rails_get_model_details(model:\"X\")` | Read app/models/x.rb |",
+          "| Route paths | `rails_get_routes(controller:\"x\")` | Read config/routes.rb |",
+          "| Feature overview | `rails_analyze_feature(feature:\"x\")` | Explore agent / Grep |",
+          "| Find code | `rails_search_code(pattern:\"x\")` | Grep tool |",
+          "| Validate edits | `rails_validate(files:[...])` | ruby -c / erb / node |",
+          "| Controller logic | `rails_get_controllers(controller:\"X\", action:\"y\")` | Read controller file |",
+          "| UI patterns | `rails_get_design_system` | Read view files |",
+          "| Stimulus API | `rails_get_stimulus(controller:\"x\")` | Read JS files |",
+          "| Test patterns | `rails_get_test_info(model:\"X\")` | Read test files |",
+          "| Full context | `rails_get_context(model:\"X\")` | Multiple Read calls |",
+          "",
+          "### More Tools",
+          "- `rails_get_view(controller:\"x\")` | `rails_get_concern(name:\"X\")` | `rails_get_callbacks(model:\"X\")`",
+          "- `rails_get_helper_methods` | `rails_get_service_pattern` | `rails_get_job_pattern`",
+          "- `rails_get_env` | `rails_get_partial_interface(path:\"shared/_form\")` | `rails_get_turbo_map`",
+          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
+          "- `rails_get_edit_context(file:\"path\", near:\"keyword\")` — surgical edit helper with line numbers",
           ""
         ]
       end
@@ -256,12 +264,20 @@ module RailsAiContext
         [
           "## Rules",
           "- Follow existing patterns and conventions",
-          "- 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",
+          "",
+          "## MCP-First Rule — Do NOT Bypass",
+          "- Do NOT read db/schema.rb — use `rails_get_schema`",
+          "- Do NOT read config/routes.rb for reference — use `rails_get_routes`",
+          "- Do NOT read model files for associations/scopes — use `rails_get_model_details`",
+          "- Do NOT use Grep to search code — use `rails_search_code`",
+          "- Do NOT launch Explore agents for context — use `rails_analyze_feature`",
+          "- Do NOT read test files for patterns — use `rails_get_test_info`",
+          "- Read files ONLY when you are about to Edit them",
           ""
         ]
       end

data/lib/rails_ai_context/serializers/copilot_instructions_serializer.rb

@@ -219,36 +219,38 @@ module RailsAiContext
           "applyTo: \"**/*\"",
           "---",
           "",
-          "# Rails MCP Tools (25) — Use These First",
+          "# Rails MCP Tools (25) — MANDATORY, Use Before Read",
           "",
-          "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
-          "MCP tools return line numbers for surgical edits.",
-          "**Start with `detail:\"summary\"`, then drill into specifics.**",
+          "CRITICAL: This project has live MCP tools. You MUST use them for gathering context.",
+          "Read files ONLY when you are about to edit them. Never read reference files directly.",
+          "Start with `detail:\"summary\"`, then drill into specifics.",
           "",
-          "- `rails_get_schema(detail:\"summary\")` → `rails_get_schema(table:\"name\")`",
-          "- `rails_get_model_details(detail:\"summary\")` → `rails_get_model_details(model:\"Name\")`",
-          "- `rails_get_routes(detail:\"summary\")` → `rails_get_routes(controller:\"name\")`",
-          "- `rails_get_controllers(controller:\"Name\", action:\"index\")` — one action's source code",
-          "- `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_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
-          "- `rails_get_design_system` — color palette, components, canonical page examples",
-          "- `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",
-          "- `rails_security_scan` — Brakeman security analysis",
-          "- `rails_get_concern(name:\"Searchable\")` — concern methods and includers",
-          "- `rails_get_callbacks(model:\"User\")` — model callbacks in execution order",
-          "- `rails_get_helper_methods` — app + framework helpers",
-          "- `rails_get_service_pattern` — service object patterns and interfaces",
-          "- `rails_get_job_pattern` — background job patterns and schedules",
-          "- `rails_get_env` — environment variables and credentials keys",
-          "- `rails_get_partial_interface(path:\"shared/_form\")` — partial locals contract",
-          "- `rails_get_turbo_map` — Turbo Streams/Frames wiring",
-          "- `rails_get_context(model:\"User\")` — composite cross-layer context",
+          "## Mandatory Workflow",
+          "1. Gathering context → use MCP tools (NOT file reads, NOT grep)",
+          "2. Reading files → ONLY files you will edit",
+          "3. After editing → `rails_validate(files:[...])` every time, no exceptions",
           "",
-          "After editing: use rails_validate to check syntax. Do NOT re-read files to verify."
+          "## Do NOT Bypass",
+          "| Instead of... | Use this MCP tool |",
+          "|---------------|-------------------|",
+          "| Reading db/schema.rb | `rails_get_schema(table:\"name\")` |",
+          "| Reading config/routes.rb | `rails_get_routes(controller:\"name\")` |",
+          "| Reading model files for context | `rails_get_model_details(model:\"Name\")` |",
+          "| Grep for code patterns | `rails_search_code(pattern:\"regex\")` |",
+          "| Reading test files | `rails_get_test_info(model:\"Name\")` |",
+          "| Reading controller for context | `rails_get_controllers(controller:\"Name\", action:\"x\")` |",
+          "| Reading JS for Stimulus API | `rails_get_stimulus(controller:\"name\")` |",
+          "| Multiple reads for a feature | `rails_analyze_feature(feature:\"keyword\")` |",
+          "| ruby -c / erb / node -c | `rails_validate(files:[...])` |",
+          "",
+          "## All 25 Tools",
+          "- `rails_get_schema` | `rails_get_model_details` | `rails_get_routes` | `rails_get_controllers`",
+          "- `rails_get_view` | `rails_get_stimulus` | `rails_get_test_info` | `rails_analyze_feature`",
+          "- `rails_get_design_system` | `rails_get_edit_context` | `rails_validate` | `rails_search_code`",
+          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
+          "- `rails_get_concern` | `rails_get_callbacks` | `rails_get_helper_methods` | `rails_get_service_pattern`",
+          "- `rails_get_job_pattern` | `rails_get_env` | `rails_get_partial_interface` | `rails_get_turbo_map`",
+          "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/serializers/cursor_rules_serializer.rb

@@ -256,39 +256,41 @@ module RailsAiContext
       def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
         lines = [
           "---",
-          "description: \"Rails MCP tools (25) — use for reference files, read directly if you'll edit\"",
+          "description: \"Rails MCP tools (25) — MANDATORY, use before reading any reference files\"",
           "alwaysApply: true",
           "---",
           "",
-          "# Rails MCP Tools (25) — Use These First",
+          "# Rails MCP Tools (25) — MANDATORY, Use Before Read",
           "",
-          "Use MCP for reference files (schema, routes, tests). Read files directly if you'll edit them.",
-          "MCP tools return line numbers for surgical edits.",
+          "CRITICAL: This project has live MCP tools. You MUST use them for gathering context.",
+          "Read files ONLY when you are about to edit them. Never read reference files directly.",
           "",
-          "- `rails_get_schema(detail:\"summary\")` → `rails_get_schema(table:\"name\")`",
-          "- `rails_get_model_details(detail:\"summary\")` → `rails_get_model_details(model:\"Name\")`",
-          "- `rails_get_routes(detail:\"summary\")` → `rails_get_routes(controller:\"name\")`",
-          "- `rails_get_controllers(controller:\"Name\", action:\"index\")` — one action's source code",
-          "- `rails_get_view(controller:\"cooks\")` — view list; `rails_get_view(path:\"cooks/index.html.erb\")` — content",
-          "- `rails_get_stimulus(detail:\"summary\")` → `rails_get_stimulus(controller:\"name\")`",
-          "- `rails_get_test_info(detail:\"full\")` — fixtures, factories, helpers; `(model:\"Cook\")` — existing tests",
-          "- `rails_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
-          "- `rails_get_design_system` — color palette, components, canonical page examples",
-          "- `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",
-          "- `rails_security_scan` — Brakeman security analysis",
-          "- `rails_get_concern(name:\"Searchable\")` — concern methods and includers",
-          "- `rails_get_callbacks(model:\"User\")` — model callbacks in execution order",
-          "- `rails_get_helper_methods` — app + framework helpers",
-          "- `rails_get_service_pattern` — service object patterns and interfaces",
-          "- `rails_get_job_pattern` — background job patterns and schedules",
-          "- `rails_get_env` — environment variables and credentials keys",
-          "- `rails_get_partial_interface(path:\"shared/_form\")` — partial locals contract",
-          "- `rails_get_turbo_map` — Turbo Streams/Frames wiring",
-          "- `rails_get_context(model:\"User\")` — composite cross-layer context",
+          "## Mandatory Workflow",
+          "1. Gathering context → use MCP tools (NOT file reads, NOT grep)",
+          "2. Reading files → ONLY files you will edit (Read is required before Edit)",
+          "3. After editing → `rails_validate(files:[...])` every time, no exceptions",
           "",
-          "After editing: use rails_validate to check syntax. Do NOT re-read files to verify."
+          "## Do NOT Bypass — Anti-Patterns",
+          "| Instead of... | Use this MCP tool |",
+          "|---------------|-------------------|",
+          "| Reading db/schema.rb | `rails_get_schema(table:\"name\")` |",
+          "| Reading config/routes.rb | `rails_get_routes(controller:\"name\")` |",
+          "| Reading model files for context | `rails_get_model_details(model:\"Name\")` |",
+          "| Grep for code patterns | `rails_search_code(pattern:\"regex\")` |",
+          "| Reading test files for patterns | `rails_get_test_info(model:\"Name\")` |",
+          "| Reading controller for context | `rails_get_controllers(controller:\"Name\", action:\"x\")` |",
+          "| Reading JS for Stimulus API | `rails_get_stimulus(controller:\"name\")` |",
+          "| Multiple reads for a feature | `rails_analyze_feature(feature:\"keyword\")` |",
+          "| ruby -c / erb / node -c | `rails_validate(files:[...])` |",
+          "",
+          "## All 25 Tools",
+          "- `rails_get_schema` | `rails_get_model_details` | `rails_get_routes` | `rails_get_controllers`",
+          "- `rails_get_view` | `rails_get_stimulus` | `rails_get_test_info` | `rails_analyze_feature`",
+          "- `rails_get_design_system` | `rails_get_edit_context` | `rails_validate` | `rails_search_code`",
+          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
+          "- `rails_get_concern` | `rails_get_callbacks` | `rails_get_helper_methods` | `rails_get_service_pattern`",
+          "- `rails_get_job_pattern` | `rails_get_env` | `rails_get_partial_interface` | `rails_get_turbo_map`",
+          "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/serializers/opencode_serializer.rb

@@ -165,33 +165,39 @@ module RailsAiContext
 
       def render_mcp_guide # rubocop:disable Metrics/MethodLength
         [
-          "## MCP Tools (25) — ALWAYS Use These First",
+          "## MCP Tools (25) — MANDATORY, Use Before Read",
           "",
-          "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
-          "MCP tools return line numbers. Start with `detail:\"summary\"`.",
+          "CRITICAL: This project has live MCP tools. You MUST use them for gathering context.",
+          "Read files ONLY when you are about to edit them. Never read reference files directly.",
+          "Start with `detail:\"summary\"`, then drill into specifics.",
           "",
-          "- `rails_get_schema(detail:\"summary\")` → `rails_get_schema(table:\"name\")`",
-          "- `rails_get_model_details(detail:\"summary\")` → `rails_get_model_details(model:\"Name\")`",
-          "- `rails_get_routes(detail:\"summary\")` → `rails_get_routes(controller:\"name\")`",
-          "- `rails_get_controllers(controller:\"Name\", action:\"index\")` — one action's source code",
-          "- `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\")` — tests",
-          "- `rails_get_edit_context(file:\"path\", near:\"keyword\")` — surgical edit context with line numbers",
-          "- `rails_analyze_feature(feature:\"auth\")` — schema + models + controllers + routes for a feature",
-          "- `rails_get_design_system` — color palette, component patterns, canonical page examples",
-          "- `rails_validate(files:[...])` — batch syntax check for Ruby, ERB, JS",
-          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_search_code`",
-          "- `rails_security_scan` — Brakeman security analysis",
-          "- `rails_get_concern(name:\"Searchable\")` — concern methods and includers",
-          "- `rails_get_callbacks(model:\"User\")` — model callbacks in execution order",
-          "- `rails_get_helper_methods` — app + framework helpers",
-          "- `rails_get_service_pattern` — service object patterns and interfaces",
-          "- `rails_get_job_pattern` — background job patterns and schedules",
-          "- `rails_get_env` — environment variables and credentials keys",
-          "- `rails_get_partial_interface(path:\"shared/_form\")` — partial locals contract",
-          "- `rails_get_turbo_map` — Turbo Streams/Frames wiring",
-          "- `rails_get_context(model:\"User\")` — composite cross-layer context",
+          "### Mandatory Workflow",
+          "1. **Before exploring a feature**: `rails_analyze_feature(feature:\"...\")` — NOT file reads or grep",
+          "2. **Before writing migrations**: `rails_get_schema(table:\"...\")` — NOT reading db/schema.rb",
+          "3. **Before modifying a model**: `rails_get_model_details(model:\"...\")` — NOT reading the model file",
+          "4. **Before adding routes**: `rails_get_routes(controller:\"...\")` — Read only when you will edit",
+          "5. **Before creating views**: `rails_get_design_system` — match existing patterns",
+          "6. **After editing ANY file**: `rails_validate(files:[...])` — no exceptions",
+          "",
+          "### Do NOT Bypass",
+          "| Instead of... | Use this MCP tool |",
+          "|---------------|-------------------|",
+          "| Reading db/schema.rb | `rails_get_schema(table:\"x\")` |",
+          "| Reading model files | `rails_get_model_details(model:\"X\")` |",
+          "| Reading routes.rb | `rails_get_routes(controller:\"x\")` |",
+          "| Grep for code | `rails_search_code(pattern:\"x\")` |",
+          "| Reading test files | `rails_get_test_info(model:\"X\")` |",
+          "| Reading controller | `rails_get_controllers(controller:\"X\", action:\"y\")` |",
+          "| ruby -c / erb / node | `rails_validate(files:[...])` |",
+          "",
+          "### All 25 Tools",
+          "- `rails_get_schema` | `rails_get_model_details` | `rails_get_routes` | `rails_get_controllers`",
+          "- `rails_get_view` | `rails_get_stimulus` | `rails_get_test_info` | `rails_analyze_feature`",
+          "- `rails_get_design_system` | `rails_get_edit_context` | `rails_validate` | `rails_search_code`",
+          "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
+          "- `rails_get_concern` | `rails_get_callbacks` | `rails_get_helper_methods` | `rails_get_service_pattern`",
+          "- `rails_get_job_pattern` | `rails_get_env` | `rails_get_partial_interface` | `rails_get_turbo_map`",
+          "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call",
           ""
         ]
       end

data/lib/rails_ai_context/serializers/windsurf_rules_serializer.rb

@@ -67,34 +67,35 @@ module RailsAiContext
 
       def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
         lines = [
-          "# Rails MCP Tools (25) — Use These First",
+          "# Rails MCP Tools (25) — MANDATORY, Use Before Read",
           "",
-          "Use MCP for reference files (schema, routes, tests). Read directly if you'll edit.",
+          "CRITICAL: This project has live MCP tools. Use them for ALL context gathering.",
+          "Read files ONLY when you are about to edit them.",
           "",
-          "- rails_get_schema(detail:\"summary\") → rails_get_schema(table:\"name\")",
-          "- rails_get_model_details(detail:\"summary\") → rails_get_model_details(model:\"Name\")",
-          "- rails_get_routes(detail:\"summary\") → rails_get_routes(controller:\"name\")",
-          "- rails_get_controllers(controller:\"Name\", action:\"index\") — one action's source",
-          "- rails_get_view(controller:\"cooks\") — views; rails_get_view(path:\"file\") — content",
-          "- rails_get_stimulus(detail:\"summary\") → rails_get_stimulus(controller:\"name\")",
-          "- rails_get_test_info(detail:\"full\") — fixtures, helpers; (model:\"Cook\") — tests",
-          "- rails_analyze_feature(feature:\"auth\") — schema + models + controllers + routes for a feature",
-          "- rails_get_design_system — color palette, components, page examples",
-          "- 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",
-          "- rails_security_scan — Brakeman security analysis",
-          "- rails_get_concern(name:\"Searchable\") — concern methods and includers",
-          "- rails_get_callbacks(model:\"User\") — model callbacks in execution order",
-          "- rails_get_helper_methods — app + framework helpers",
-          "- rails_get_service_pattern — service object patterns and interfaces",
-          "- rails_get_job_pattern — background job patterns and schedules",
-          "- rails_get_env — environment variables and credentials keys",
-          "- rails_get_partial_interface(path:\"shared/_form\") — partial locals contract",
-          "- rails_get_turbo_map — Turbo Streams/Frames wiring",
-          "- rails_get_context(model:\"User\") — composite cross-layer context",
+          "Mandatory Workflow:",
+          "1. Gathering context → use MCP tools (NOT file reads)",
+          "2. Reading files → ONLY files you will edit",
+          "3. After editing → rails_validate(files:[...]) every time",
           "",
-          "After editing: use rails_validate to check syntax. Do NOT re-read files to verify."
+          "Do NOT Bypass:",
+          "- Reading db/schema.rb → rails_get_schema(table:\"name\")",
+          "- Reading config/routes.rb → rails_get_routes(controller:\"name\")",
+          "- Reading model files → rails_get_model_details(model:\"Name\")",
+          "- Grep for code → rails_search_code(pattern:\"regex\")",
+          "- Reading test files → rails_get_test_info(model:\"Name\")",
+          "- Reading controller → rails_get_controllers(controller:\"Name\", action:\"x\")",
+          "- Reading JS for Stimulus → rails_get_stimulus(controller:\"name\")",
+          "- Multiple reads for feature → rails_analyze_feature(feature:\"keyword\")",
+          "- ruby -c / erb / node -c → rails_validate(files:[...])",
+          "",
+          "All 25 Tools:",
+          "- rails_get_schema | rails_get_model_details | rails_get_routes | rails_get_controllers",
+          "- rails_get_view | rails_get_stimulus | rails_get_test_info | rails_analyze_feature",
+          "- rails_get_design_system | rails_get_edit_context | rails_validate | rails_search_code",
+          "- rails_get_config | rails_get_gems | rails_get_conventions | rails_security_scan",
+          "- rails_get_concern | rails_get_callbacks | rails_get_helper_methods | rails_get_service_pattern",
+          "- rails_get_job_pattern | rails_get_env | rails_get_partial_interface | rails_get_turbo_map",
+          "- rails_get_context(model:\"X\") — composite cross-layer context in one call"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAiContext
-  VERSION = "2.0.0"
+  VERSION = "2.0.1"
 end

data/server.json

@@ -7,11 +7,11 @@
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"
   },
-  "version": "2.0.0",
+  "version": "2.0.1",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v2.0.0/rails-ai-context-mcp.mcpb",
+      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v2.0.1/rails-ai-context-mcp.mcpb",
       "fileSha256": "dd711a0ad6c4de943ae4da94eaf59a6dc9494b9d57f726e24649ed4e2f156990",
       "transport": {
         "type": "stdio"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - crisnahine