rails-ai-context 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aeeb02e9069ff67b12236ae2f99f169df5b5dd48d42af344ad0734ff1a499307
-  data.tar.gz: 0d5f18c57c512747bc06fc063c9e58c95073f288df15f3d74bd0d951815fabe8
+  metadata.gz: d83d1237d476138591f50c4723cb10a4864aed5ed2e84b7059e53bff287af1db
+  data.tar.gz: 3791bba4e68364ea507050f2605096ce8dff2cacf943ddd111753b768c8152cf
 SHA512:
-  metadata.gz: dc0c90e9d22ff8348ce6eefc770ca36eac77bda624795be2813972de0f56b565180bfc974042cc7fa949718a8362c760d3db9123dc8aab294403ca9498efd8f3
-  data.tar.gz: f33d929cf59fdd217d4905a49b5043b689cb7828588ff738d9973d2e97c42f78228327d3574d276180e04663cac3f3470c7b84bc118022d9dc8890a47ff117ed
+  metadata.gz: 4e3ceb93281e5d3674aab290728357ef75d9d0c24a7d3cee05c9380333ba4d5209b13fdad85a7f015185697d09b9c9093fafc10e628d4dbc1bb897280eb5c388
+  data.tar.gz: 4a0240af3fc7a4ecc303c72107b62f5f5df88fafc189be1f3b19096895dccdd7242ce6e640f7d0f6f148aaed45af7e74f4bf717f773aee3b8cd77107f393c6b0

data/CHANGELOG.md

@@ -5,6 +5,13 @@ 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).
 
+## [1.3.1] - 2026-03-23
+
+### Fixed
+
+- **Documentation audit** — updated tool count from 14 to 15 across README, GUIDE, CONTRIBUTING, server.json. Added `rails_get_design_system` documentation section to GUIDE.md. Updated SECURITY.md supported versions. Fixed spec count in CLAUDE.md. Added `rails_get_design_system` to README tool table. Updated `rails_analyze_feature` description to reflect full-stack discovery (services, jobs, views, Stimulus, tests, related models, env deps).
+- **analyze_feature crash on complex models** — added type guards (`is_a?(Hash)`, `is_a?(Array)`) to all data access points preventing `no implicit conversion of Symbol into Integer` errors on models with many associations or complex data.
+
 ## [1.3.0] - 2026-03-23
 
 ### Added

data/CLAUDE.md

@@ -45,7 +45,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (520 examples)
+bundle exec rspec           # Run specs (522 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/             # 14 MCP tools with detail levels and pagination
+├── tools/             # 15 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

@@ -62,7 +62,7 @@ Agent: rails_validate(files:["app/models/cook.rb"], level:"rails") → catches c
 |-------|-----------------|---------------|------------|
 | **Static files** (CLAUDE.md, .cursorrules, etc.) | App overview: stack, models, gems, architecture, UI patterns, MCP tool reference | Automatically at session start | ~150 lines, zero tool calls |
 | **Split rules** (.claude/rules/, .cursor/rules/) | Deep reference: full schema with column types, all model associations/scopes, controller listings | Conditionally — only when editing relevant files | Zero when not needed |
-| **Live MCP tools** (14 tools) | Real-time queries: drill into any table, model, controller action, or view on demand. Semantic validation. | On-demand via agent tool calls | ~25-100 lines per call |
+| **Live MCP tools** (15 tools) | Real-time queries: drill into any table, model, controller action, or view on demand. Semantic validation. Design system. | On-demand via agent tool calls | ~25-100 lines per call |
 
 **Progressive disclosure:** the agent gets the map for free, reference guides when relevant, and live GPS when building.
 
@@ -72,7 +72,7 @@ Agent: rails_validate(files:["app/models/cook.rb"], level:"rails") → catches c
 
 | Setup | Tokens | What it knows |
 |-------|--------|---------------|
-| **rails-ai-context (full)** | **28,834** | 14 MCP tools + generated docs + split rules |
+| **rails-ai-context (full)** | **28,834** | 15 MCP tools + generated docs + split rules |
 | rails-ai-context CLAUDE.md only | 33,106 | Generated docs + rules, no MCP tools |
 | Normal Claude `/init` | 40,700 | Generic CLAUDE.md only |
 | No rails-ai-context | 45,477 | Nothing — discovers everything from scratch |
@@ -97,9 +97,9 @@ But token savings is the side effect. The real value:
 
 ---
 
-## 14 Live MCP Tools
+## 15 Live MCP Tools
 
-The gem exposes **14 read-only tools** via MCP that AI clients call on-demand:
+The gem exposes **15 read-only tools** via MCP that AI clients call on-demand:
 
 | Tool | What it returns |
 |------|----------------|
@@ -116,7 +116,8 @@ The gem exposes **14 read-only tools** via MCP that AI clients call on-demand:
 | `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. `level:"rails"` adds semantic checks (partials, route helpers, columns, strong params, callbacks, FK indexes, Stimulus) |
-| `rails_analyze_feature` | End-to-end feature analysis — finds matching models, controllers, routes, and views in one call |
+| `rails_analyze_feature` | Full-stack feature analysis — models, controllers, routes, services, jobs, views, Stimulus, tests, related models, env deps |
+| `rails_get_design_system` | App design system — color palette, component patterns with real HTML examples, typography, layout, responsive breakpoints |
 
 ### Smart Detail Levels
 

data/SECURITY.md

@@ -4,10 +4,9 @@
 
 | Version | Supported          |
 |---------|--------------------|
+| 1.3.x   | :white_check_mark: |
 | 1.2.x   | :white_check_mark: |
-| 1.1.x    | :white_check_mark: |
-| 1.0.x   | :white_check_mark: |
-| < 1.0   | :x:                |
+| < 1.2   | :x:                |
 
 ## Reporting a Vulnerability
 

data/docs/GUIDE.md

@@ -252,7 +252,7 @@ rails ai:context:claude           # Use this instead (no quoting needed)
 
 ## MCP Tools — Full Reference
 
-All 14 tools are **read-only** and **idempotent** — they never modify your application or database.
+All 15 tools are **read-only** and **idempotent** — they never modify your application or database.
 
 ### rails_get_schema
 
@@ -590,7 +590,7 @@ rails_search_code(pattern: "validates", context_lines: 2)
 
 ### rails_analyze_feature
 
-Analyzes a feature end-to-end: finds matching models, controllers, routes, and views in one call.
+Full-stack feature analysis: models, controllers, routes, services, jobs, views, Stimulus controllers, tests, related models, concerns, callbacks, channels, mailers, and environment dependencies in one call.
 
 **Parameters:**
 
@@ -616,7 +616,34 @@ rails_analyze_feature(feature: "orders")
   → Everything related to orders across all layers
 ```
 
-**Returns:** Markdown with sections for Models (with table, columns, indexes, FKs, associations, validations, scopes), Controllers (with actions and filters), and Routes (with verbs, paths, and route names). Each section shows match counts.
+**Returns:** Markdown with sections for Models (with columns, associations, validations, scopes, enums), Controllers (with actions and filters), Routes, Services (with methods), Jobs (with queue/retry), Views (with partials and Stimulus refs), Stimulus controllers (with targets/values/actions), Tests (with counts), Related models, Concerns, Callbacks, Channels, Mailers, and Environment dependencies. Each section shows match counts.
+
+### rails_get_design_system
+
+Returns the app's design system: color palette with semantic roles, component patterns with real HTML examples from actual views, typography scale, layout conventions, responsive breakpoints, and interactive state patterns.
+
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `detail` | string | `summary` (palette + components), `standard` (+ canonical page examples + design rules, default), `full` (+ typography, responsive, dark mode, animations, design tokens) |
+
+**Examples:**
+
+```
+rails_get_design_system()
+  → Color palette (primary, danger, success), component patterns (buttons, cards, inputs),
+    canonical page examples (form page, list page), design rules
+
+rails_get_design_system(detail: "summary")
+  → Compact: color roles + component class strings only
+
+rails_get_design_system(detail: "full")
+  → Everything: + typography scale, responsive breakpoints, interactive states,
+    dark mode patterns, animations, icon system, design tokens, shared partials
+```
+
+**Returns:** Structured design system reference. Includes real HTML/ERB snippets from the app's actual views as canonical examples, semantic color roles (primary for CTAs, danger for destructive), component variants, typography hierarchy, spacing scale, and explicit design rules for AI to follow.
 
 ### Detail Level Summary
 
@@ -746,7 +773,7 @@ RailsAiContext.configure do |config|
 end
 ```
 
-Both transports are **read-only** — they expose the same 14 tools and never modify your app.
+Both transports are **read-only** — they expose the same 15 tools and never modify your app.
 
 ---
 

data/lib/rails_ai_context/tools/analyze_feature.rb

@@ -74,10 +74,16 @@ module RailsAiContext
                 end
               end
 
-              lines << "**Associations:** #{data[:associations].map { |a| "#{a[:type]} :#{a[:name]}" }.join(', ')}" if data[:associations]&.any?
-              lines << "**Validations:** #{data[:validations].map { |v| "#{v[:kind]} on #{v[:attributes].join(', ')}" }.uniq.join('; ')}" if data[:validations]&.any?
-              lines << "**Scopes:** #{data[:scopes].join(', ')}" if data[:scopes]&.any?
-              lines << "**Enums:** #{data[:enums].map { |k, v| "#{k}: #{v.join(', ')}" }.join('; ')}" if data[:enums]&.any?
+              if data[:associations].is_a?(Array) && data[:associations].any?
+                lines << "**Associations:** #{data[:associations].select { |a| a.is_a?(Hash) }.map { |a| "#{a[:type]} :#{a[:name]}" }.join(', ')}"
+              end
+              if data[:validations].is_a?(Array) && data[:validations].any?
+                lines << "**Validations:** #{data[:validations].select { |v| v.is_a?(Hash) }.map { |v| "#{v[:kind]} on #{Array(v[:attributes]).join(', ')}" }.uniq.join('; ')}"
+              end
+              lines << "**Scopes:** #{data[:scopes].join(', ')}" if data[:scopes].is_a?(Array) && data[:scopes].any?
+              if data[:enums].is_a?(Hash) && data[:enums].any?
+                lines << "**Enums:** #{data[:enums].map { |k, v| "#{k}: #{Array(v).join(', ')}" }.join('; ')}"
+              end
             end
           else
             lines << "## Models" << "_No models matching '#{pattern}'._"
@@ -90,7 +96,7 @@ module RailsAiContext
         # --- AF: Controllers ---
         def discover_controllers(ctx, pattern, lines)
           controllers = ctx.dig(:controllers, :controllers) || {}
-          matched = controllers.select { |name, data| !data[:error] && name.downcase.include?(pattern) }
+          matched = controllers.select { |name, data| data.is_a?(Hash) && !data[:error] && name.downcase.include?(pattern) }
 
           if matched.any?
             lines << "## Controllers (#{matched.size})"
@@ -98,10 +104,10 @@ module RailsAiContext
               actions = info[:actions]&.join(", ") || "none"
               lines << "" << "### #{name}"
               lines << "- **Actions:** #{actions}"
-              filters = (info[:filters] || []).map do |f|
+              filters = (info[:filters] || []).select { |f| f.is_a?(Hash) }.map do |f|
                 label = "#{f[:kind]} #{f[:name]}"
-                label += " only: #{f[:only].join(', ')}" if f[:only]&.any?
-                label += " except: #{f[:except].join(', ')}" if f[:except]&.any?
+                label += " only: #{Array(f[:only]).join(', ')}" if f[:only]&.any?
+                label += " except: #{Array(f[:except]).join(', ')}" if f[:except]&.any?
                 label += " unless: #{f[:unless]}" if f[:unless]
                 label
               end
@@ -224,9 +230,18 @@ module RailsAiContext
           matched.each do |c|
             name = c[:name] || c[:file]&.gsub("_controller.js", "")
             lines << "" << "### #{name}"
-            lines << "- **Targets:** #{c[:targets].join(', ')}" if c[:targets]&.any?
-            lines << "- **Values:** #{c[:values].map { |v| "#{v[:name]}:#{v[:type]}" }.join(', ')}" if c[:values]&.any?
-            lines << "- **Actions:** #{c[:actions].join(', ')}" if c[:actions]&.any?
+            lines << "- **Targets:** #{Array(c[:targets]).join(', ')}" if c[:targets]&.any?
+            if c[:values]&.any?
+              val_strs = if c[:values].is_a?(Array)
+                c[:values].select { |v| v.is_a?(Hash) }.map { |v| "#{v[:name]}:#{v[:type]}" }
+              elsif c[:values].is_a?(Hash)
+                c[:values].map { |k, v| "#{k}:#{v}" }
+              else
+                []
+              end
+              lines << "- **Values:** #{val_strs.join(', ')}" if val_strs.any?
+            end
+            lines << "- **Actions:** #{Array(c[:actions]).join(', ')}" if c[:actions]&.any?
           end
           lines << ""
         end
@@ -266,7 +281,9 @@ module RailsAiContext
 
           related = {}
           matched_models.each do |name, data|
+            next unless data.is_a?(Hash)
             (data[:associations] || []).each do |a|
+              next unless a.is_a?(Hash)
               related_name = a[:class_name] || a[:name].to_s.classify
               next if matched_models.key?(related_name)
               related[related_name] ||= []
@@ -286,7 +303,9 @@ module RailsAiContext
 
           concerns = {}
           matched_models.each do |_name, data|
+            next unless data.is_a?(Hash)
             (data[:concerns] || []).each do |c|
+              next unless c.is_a?(String)
               next if c.include?("::") || %w[Kernel JSON PP].include?(c)
               concerns[c] ||= 0
               concerns[c] += 1
@@ -297,6 +316,8 @@ module RailsAiContext
           lines << "## Concerns"
           concerns.sort.each { |name, count| lines << "- **#{name}** (used by #{count} model#{'s' if count > 1})" }
           lines << ""
+        rescue
+          nil
         end
 
         # --- AF13: Callback Chains ---
@@ -305,7 +326,9 @@ module RailsAiContext
 
           callbacks = []
           matched_models.each do |name, data|
+            next unless data.is_a?(Hash)
             (data[:callbacks] || {}).each do |type, methods|
+              next unless methods.is_a?(Array)
               methods.each { |m| callbacks << "#{name}: #{type} :#{m}" }
             end
           end

data/lib/rails_ai_context/tools/validate.rb

@@ -602,17 +602,16 @@ module RailsAiContext
         model_data[:associations]&.each { |a| valid << a[:name]; valid << a[:foreign_key] if a[:foreign_key] }
         valid.merge(%w[id _destroy created_at updated_at])
 
-        # V1: Smarter JSONB skip — only skip params matching JSON column names, check the rest
-        json_column_names = table_data[:columns]
-          &.select { |c| %w[jsonb json].include?(c[:type]) }
-          &.map { |c| c[:name] }
-          &.to_set || Set.new
+        # If model has JSONB/JSON columns, permitted params likely go INTO those columns
+        # (e.g. Cook permits :product_details which is stored inside intake JSONB)
+        # Skip the entire check — too many false positives otherwise
+        has_json_columns = table_data[:columns]&.any? { |c| %w[jsonb json].include?(c[:type]) }
+        return warnings if has_json_columns
 
         visitor.permit_calls.each do |pc|
           pc[:params].each do |param|
             next if param.end_with?("_attributes") # nested attributes
             next if valid.include?(param)
-            next if json_column_names.include?(param) # param matches a JSON column, skip
             warnings << "permits :#{param} \u2014 not a column in #{table_name} table"
           end
         end

data/lib/rails_ai_context/version.rb

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

data/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.crisnahine/rails-ai-context",
   "title": "Rails AI Context",
-  "description": "Auto-expose Rails app structure to AI via MCP. Zero config, 14 read-only tools.",
+  "description": "Auto-expose Rails app structure to AI via MCP. Zero config, 15 read-only tools, design system extraction.",
   "repository": {
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - crisnahine
@@ -184,7 +184,6 @@ files:
 - CONTRIBUTING.md
 - LICENSE
 - README.md
-- ROADMAP.md
 - Rakefile
 - SECURITY.md
 - docs/GUIDE.md

data/ROADMAP.md

@@ -1,148 +0,0 @@
-# rails-ai-context — Bugs & Improvements Roadmap
-
-> Comprehensive list from 6 testing sessions, ~500+ MCP calls, 522 specs, verified on DailyContentChef (9 tables, 6 models, 18 controllers, 15 Stimulus controllers).
-> Current version: v1.2.1 (updated 2026-03-23)
-
----
-
-## Open Bugs
-
-### MCP Tools
-
-| # | Bug | Severity | Tool | Status |
-|---|-----|----------|------|--------|
-| B1 | `unless: :devise_controller?` not fully evaluated — OmniauthCallbacksController shows `authenticate_user!` | LOW | controllers | **FIXED v1.2.1** — evaluates condition at introspection time, removes filter for Devise controllers |
-| B2 | `self` appears in class methods list — Plan shows `self` as a class method alongside `free`, `pro`, `business` | LOW | model_details | Open |
-
-### Rules Serializer (generated CLAUDE.md / rules files)
-
-| # | Bug | Severity | Status |
-|---|-----|----------|--------|
-| R1 | User methods list shows ~5 of 18 — missing concern + model-defined methods | MEDIUM | **FIXED v1.2.1** — source-defined methods prioritized, Devise methods filtered |
-| R3 | `visuals_needed` shown as `string` not `string[]` in rules | MEDIUM | **FIXED v1.2.1** — array columns now render as `type[]` |
-| R4 | payments missing `paymongo_checkout_id` and `paymongo_payment_id` columns in rules | MEDIUM | **FIXED v1.2.1** — external ID columns no longer hidden |
-| R5 | users missing `paymongo_customer_id` column in rules | MEDIUM | **FIXED v1.2.1** — same fix as R4 |
-| R6 | No column defaults shown in generated rules | MEDIUM | **FIXED v1.2.1** — defaults shown inline as `(=value)` |
-
----
-
-## Improvements: `rails_analyze_feature`
-
-### Tier 1 — Core (makes the tool 10x more useful)
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| AF1 | **Services discovery** | Scan `app/services/` for classes matching the feature keyword. Show class name, line count, key method names. `feature:"cook"` → finds `ContentChefService`, `GeminiClient`, `OutputParser` | HIGH |
-| AF2 | **Jobs discovery** | Scan `app/jobs/` for matching classes. Show queue name, retry config, what service it calls. `feature:"cook"` → finds `CookJob` (queue: default, retries: 3, calls ContentChefService) | HIGH |
-| AF3 | **Views + partials discovery** | List matching views with line counts, partial renders, and Stimulus controller references. `feature:"cook"` → shows `cooks/show.html.erb (61 lines) renders: cooks/output, cooks/loading stimulus: cook-status, share` | HIGH |
-| AF4 | **Stimulus controllers discovery** | Match Stimulus controllers by name. Show targets, values, actions. `feature:"cook"` → finds `cook_status` controller with `cookId` value and `checkTimeout` action | HIGH |
-| AF5 | **Test files discovery** | List matching test files with test counts. `feature:"cook"` → shows `test/models/cook_test.rb (13 tests)`, `test/controllers/cooks_controller_test.rb (21 tests)` | HIGH |
-
-### Tier 2 — Cross-cutting intelligence
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| AF6 | **Related models via associations** | Show models connected through `belongs_to`, `has_many`. `feature:"cook"` → "Related: User (owner), BrandProfile (optional), CookShare (shares)" | MEDIUM |
-| AF7 | **Execution flow graph** | Trace the full request lifecycle: controller action → authorization check → model operation → job enqueue → service call → external API → broadcast. No other tool does this. | MEDIUM |
-| AF8 | **Permission/authorization mapping** | Map which concern methods guard which actions. `can_cook?` guards `CooksController#create`, `can_use_bonus_modes?` guards `Bonus::BaseController` | MEDIUM |
-| AF9 | **Environment dependencies** | Detect ENV vars referenced by the feature. `feature:"cook"` → requires `GEMINI_API_KEY`, Sidekiq running, Redis connected | MEDIUM |
-| AF10 | **Channel/websocket discovery** | Find `turbo_stream_from` and Action Cable subscriptions. `feature:"cook"` → uses `turbo_stream_from "cook_#{id}"` for real-time output | MEDIUM |
-
-### Tier 3 — Agent workflow optimization
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| AF11 | **Mailer/notification discovery** | Scan `app/mailers/` for matching classes and their delivery triggers | LOW |
-| AF12 | **Concern tracing** | When a feature uses concerns, list which concerns and their methods. `feature:"User"` → PlanLimitable adds 12 methods | LOW |
-| AF13 | **Callback chains** | Show before/after hooks that fire. `feature:"brand"` → `before_save :ensure_single_default` on BrandProfile | LOW |
-| AF14 | **"How to extend" hints** | Based on existing patterns, suggest where to add a new action, new validation, new partial. "To add a new cook mode: add to MODES constant (line 7), add view in bonus/" | LOW |
-
----
-
-## Improvements: `rails_get_design_system`
-
-### Tier 1 — Missing component patterns
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| DS1 | **Modal pattern** | Extract overlay + card pattern from `_share_modal.html.erb`. Show: `fixed inset-0 bg-black/50 z-40` overlay + `bg-white rounded-2xl shadow-lg max-w-md w-full p-6` card | HIGH |
-| DS2 | **Badge/tag pattern** | Extract from mode badges: `text-xs font-medium px-2.5 py-1 rounded-full bg-{color}-100 text-{color}-700`. Show color variants (indigo, green, yellow, red) | HIGH |
-| DS3 | **Status indicator pattern** | Extract from `_status_badge.html.erb`. Show as a reusable shared partial reference: `render "shared/status_badge", cook: cook` | HIGH |
-| DS4 | **Flash/toast patterns** | Extract from `_flash.html.erb`. Show success (`bg-green-50 border-green-200 text-green-700`), error (`bg-red-50 border-red-200 text-red-700`), notice variants | HIGH |
-| DS5 | **List item pattern** | Extract the repeating card-per-item layout from cook index: `bg-white rounded-xl p-5 shadow-sm border border-gray-100 flex items-center justify-between gap-4` | HIGH |
-| DS6 | **Secondary button** | Extract: `bg-gray-100 text-gray-700 px-4 py-2 rounded-xl text-sm font-semibold hover:bg-gray-200 transition cursor-pointer`. Currently only primary + danger listed | MEDIUM |
-| DS7 | **Shared partials section** | List all `app/views/shared/` partials with one-line descriptions. Agents should reuse these before creating new markup: `_flash.html.erb`, `_navbar.html.erb`, `_status_badge.html.erb`, `_upgrade_nudge.html.erb` | MEDIUM |
-
-### Tier 2 — Decision guidance
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| DS8 | **"When to use what" decision guide** | Not just class strings but rules: "Page needs a form? → Copy Form Page example. Need confirmation? → `data: { turbo_confirm: 'message' }`. Showing status? → `render 'shared/status_badge'`" | HIGH |
-| DS9 | **Loading/spinner pattern** | Extract from `_loading.html.erb`: `animate-spin` emoji + progress bar (`bg-orange-500 h-2 rounded-full animate-pulse`) | MEDIUM |
-| DS10 | **Confirmation dialog convention** | Document the Turbo Confirm pattern: `data: { turbo_confirm: "Are you sure?" }` on `button_to` for destructive actions | MEDIUM |
-| DS11 | **Form error pattern** | Show what validation errors look like: field highlighting, error message placement, `field_with_errors` wrapper behavior | MEDIUM |
-| DS12 | **Spacing system rules** | Explain WHEN to use each spacing: `space-y-3` for list items, `space-y-4` for form fields, `space-y-6` for form sections, `gap-2` for button groups, `mb-6` for section separators | LOW |
-
-### Tier 3 — Framework adaptability
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| DS13 | **Auto-detect CSS framework** | Detect Tailwind vs Bootstrap vs custom CSS/Sass. Adapt extraction strategy per framework. Currently hardcoded for Tailwind — broken for all other setups | HIGH |
-| DS14 | **Bootstrap support** | Scan ERB for Bootstrap classes (`btn-primary`, `card`, `modal`, `form-control`). Parse `_variables.scss` for custom theme. Show Bootstrap component examples from actual views | HIGH (for Bootstrap apps) |
-| DS15 | **Custom CSS/Sass support** | Parse `.scss/.css` files for class definitions. Group by file (buttons.scss → Button patterns). Detect BEM naming. Show CSS custom properties (`--color-primary`) | HIGH (for custom apps) |
-| DS16 | **Parse Tailwind `@apply` directives** | If app has `@apply` rules in CSS, extract those as named component classes | MEDIUM |
-| DS17 | **Detect DaisyUI / Flowbite / Headless UI** | If Tailwind plugin libraries are installed, include their component patterns alongside raw Tailwind | MEDIUM |
-| DS18 | **Parse `tailwind.config.js` custom theme** | Extract custom colors, fonts, spacing from the config file. Show `primary: '#FF6B00'` if customized | MEDIUM |
-| DS19 | **Animation/transition inventory** | List all `transition`, `animate-*`, `duration-*` patterns with usage context | LOW |
-| DS20 | **Icon size conventions** | Document when to use which size: `w-3.5 h-3.5` (inline with text), `w-4 h-4` (buttons), `w-5 h-5` (standalone), `w-10 h-10` (feature icons) | LOW |
-| DS21 | **Remove oklch noise from summary** | Token colors (oklch values) waste tokens in summary. Move to `detail:"full"` only. Summary should show Tailwind class names only | LOW |
-
----
-
-## Improvements: Rules Serializer
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| RS1 | **Include all concern methods** | User methods list should include all PlanLimitable methods (12+), not just 5 | HIGH — partially fixed in v1.2.1 (source methods prioritized), full concern method extraction still open |
-| RS2 | **Detect array columns** | Show `visuals_needed:string[]` not `visuals_needed:string` | ~~MEDIUM~~ **FIXED v1.2.1** |
-| RS3 | **Include all non-system columns** | payments should show `paymongo_checkout_id`, `paymongo_payment_id`. users should show `paymongo_customer_id` | ~~MEDIUM~~ **FIXED v1.2.1** |
-| RS4 | **Show column defaults** | Inline defaults: `mode:string(default:"standard")`, `status:string(default:"pending")` | ~~MEDIUM~~ **FIXED v1.2.1** |
-
----
-
-## Improvements: `rails_validate`
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| V1 | **Smarter JSONB strong params skip** | Currently skips ALL params check for models with ANY JSONB column. Could be smarter: only skip params matching JSONB column names, check the rest | LOW |
-| V2 | **Route-action check suggests fix** | When `show` action missing but route exists, suggest: "Add `def show; end` to BrandProfilesController or remove `show` from `resources :brand_profiles`" | LOW |
-
----
-
-## Improvements: `rails_get_model_details`
-
-| # | Improvement | Description | Impact |
-|---|-------------|-------------|--------|
-| MD1 | **Filter `self` from class methods** | Plan shows `self` as a class method — should be filtered out | LOW |
-
----
-
-## Summary
-
-| Category | Total | Fixed | Open | Tier 1 (HIGH) | Tier 2 (MEDIUM) | Tier 3 (LOW) |
-|----------|-------|-------|------|--------------|-----------------|--------------|
-| Open Bugs | 7 | 6 | 1 | 0 | 0 | 1 (B2) |
-| analyze_feature | 14 | 0 | 14 | 5 | 5 | 4 |
-| design_system | 21 | 0 | 21 | 9 | 6 | 6 |
-| Rules serializer | 4 | 3 | 1 | 1 (RS1 partial) | 0 | 0 |
-| validate | 2 | 0 | 2 | 0 | 0 | 2 |
-| model_details | 1 | 0 | 1 | 0 | 0 | 1 |
-| **Total** | **49** | **9** | **40** | **15** | **11** | **14** |
-
-### Killer differentiators (no other tool does these)
-
-1. **Execution flow graph** (AF7) — trace a full request from HTTP to database to broadcast in one call
-2. **"When to use what" decision guide** (DS8) — not just patterns but rules for choosing the right one
-3. **Auto-detect CSS framework** (DS13-DS15) — works for Tailwind, Bootstrap, custom CSS, any Rails app
-4. **Services + Jobs + Views + Tests in feature analysis** (AF1-AF5) — full-stack feature discovery in one call
-5. **Environment dependency detection** (AF9) — know what needs to be running before you touch a feature