rails-ai-context 5.10.0 → 5.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b022525ce9aa13c5b6d5f21a46f13db5ae84dac04f346adc40eeb2b315f9fcaa
-  data.tar.gz: 9e9f7bd60ecdab6a5d1599e560762c8c7d95a8973f5d001c4573d00f55b2a594
+  metadata.gz: c3e23845bcfe323dd73111461ed349f0d35d8e8bb4bcd941a4c7ed870c749624
+  data.tar.gz: 93969c1619e875b051f414dbbb6e15390c228355354232508ae67e0edc3a59b1
 SHA512:
-  metadata.gz: 7dca71cfea9fb5106b40f5eaebd119e36bcd1cbcbdd41b8dcd8ba4b11eb802dbb647d0c90db88b4d21a98d303ed2ed42f605ca7278a245a76155fc57cb0366cf
-  data.tar.gz: baaeaa8a5eec91ba86c6aee32f5a0d459ebcc7f14c1eaec64e7110afe7368985e005b92dcdee960606525806d652cd63f5eb1092773765cbe831857cffde75a1
+  metadata.gz: a7c3d0052929d25b6ae73cbf5aa7d5019f0358b937f26ed74f494070ce8b15d86d77eca302f0ab67fd2095dec7cbe2b2dacb08443c33c0c0e0f6e2af096985d1
+  data.tar.gz: af39220ce267de5152de58df7bbcdf24ace9b570d295e40b014a8d491af0a680298761e38fa51039352407d6506776c17179680b6f5012e70ea1023cc93e7f2c

data/CHANGELOG.md

@@ -5,6 +5,63 @@ 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).
 
+## [5.11.1] — 2026-05-24
+
+### Fixed
+
+- E2E MCP HTTP protocol spec sends `initialize` once per session instead of per-test, fixing compatibility with newer `mcp` gem versions that reject duplicate initialization.
+
+## [5.11.0] — 2026-05-24
+
+### Changed — Prism AST migration: all introspectors now use structural code extraction
+
+Every introspector that scans `.rb` files has been migrated from regex-based pattern matching to Prism AST-based structural extraction. This is a zero-regression internal refactor -- all introspector outputs are verified identical via side-by-side comparison, 2257 unit tests, 119 E2E tests, and live validation against a production-scale Rails 8.1 app (39/39 introspectors, 41/41 tool invocations, 0 failures).
+
+**What changed internally:**
+
+- **`SourceIntrospector.walk(path, listener_map)`** -- new generic API that accepts any combination of listener classes or Proc factories, enabling ad-hoc AST extraction without modifying the core dispatcher. Supports both `Class` values (instantiated via `.new`) and `-> { Instance }` lambdas for configurable listeners.
+- **11 new listener classes** for patterns beyond the original 7 model-level listeners:
+  - `GenericMacroListener` -- configurable no-receiver call detector (handles most Rails DSL patterns including `self.method` calls)
+  - `ChainedCallListener` -- method calls with receivers (`.variant()`, `.includes()`, `.create()`)
+  - `VariantCallListener` -- ActiveStorage variant detection
+  - `MailboxRoutingListener` -- ActionMailbox routing + lifecycle callbacks
+  - `MiddlewareConfigListener` -- `config.middleware.use/insert_before/insert_after/unshift`
+  - `EnvAccessListener` -- `ENV["KEY"]` / `ENV.fetch("KEY")` with block-default detection
+  - `MountListener` -- `mount Engine, at: "/path"` (both keyword and hash-rocket syntax)
+  - `RakeTaskDslListener` -- `namespace`/`desc`/`task` with deps and args (handles string + symbol deps)
+  - `GemfileDslListener` -- `gem`/`group`/`source` with group-scope tracking
+  - `SchemaDslListener` -- `create_table`/`t.type`/`t.index`/`add_foreign_key`/`create_enum`/`check_constraint`
+  - `MigrationDslListener` -- `create_table`/`add_column`/`add_index`/`rename_column`/`add_reference` and 6 more actions
+- **28 introspectors converted**: ActiveStorage, ActionText, ActionMailbox, Middleware, ActiveSupport, Auth, Security, Controller (all 9 regex blocks including strong params, filters, rescue_from, rate_limit, respond_to, turbo_stream), Convention, Turbo, MultiDatabase, Performance, Job, Model, Component, View, Api, AssetPipeline, DevOps, Env, Gem, RakeTask, Engine, Seeds, Test, Schema, Config.
+- **181 regex patterns intentionally remain** in categories where Prism cannot help: non-Ruby files (JS/TS/ERB/Haml -- 78), keyword/content matching (22), config assignments (15), runtime SQL/YAML (25), and complex partial patterns (41).
+
+**What didn't change:**
+
+- All introspector output formats are identical. No consumer-facing API changes.
+- All 39 MCP tools work exactly as before.
+- Runtime reflection paths (ActiveRecord, Rails config, I18n, etc.) are untouched.
+- Non-Ruby file scanning (YAML, JSON, ERB, JS, Procfile, Dockerfile, Gemfile.lock) is untouched.
+
+**Why this matters:**
+
+- Regex scanning matches patterns in comments, strings, and dead code. AST extraction only matches actual code structure -- fewer false positives.
+- Multi-line declarations that broke regex (e.g., `devise` with 9 modules across 3 lines, `before_action` with complex `only:`/`except:` constraints) are now parsed correctly by Prism.
+- The `AstCache` provides thread-safe LRU caching of parse results, so repeated walks of the same file are free.
+- New listeners are composable -- introspectors mix and match listeners via `SourceIntrospector.walk(path, { key: Listener })` without coupling.
+
+### Fixed
+
+- Avoid false-positive route helper warnings when `rails_validate` sees locally defined Ruby methods ending in `_path` or `_url` (#83, thanks @curi).
+- Preserve newline-separated staged file names in the generated pre-commit validation hook (#83).
+
+### Tests
+
+- 2257 unit examples (up from 2154), 0 failures
+- 119 E2E examples, 0 failures
+- 47 edge-case tests for controller, auth, and security AST conversions
+- 10 listener edge-case tests (block-syntax ENV defaults, string rake deps, insert-with-index middleware, hash-rocket mounts, complex gem lines)
+- Side-by-side regression comparison: all 39 introspector outputs verified identical between old regex and new AST code
+
 ## [5.10.0] — 2026-04-20
 
 ### Added — 8 new introspectors closing RAILS_NERVOUS_SYSTEM.md gaps

data/README.md

@@ -21,7 +21,7 @@
 <br>
 [![Ruby](https://img.shields.io/badge/Ruby-3.2%20%7C%203.3%20%7C%203.4-CC342D)](https://github.com/crisnahine/rails-ai-context)
 [![Rails](https://img.shields.io/badge/Rails-7.1%20%7C%207.2%20%7C%208.0-CC0000)](https://github.com/crisnahine/rails-ai-context)
-[![Tests](https://img.shields.io/badge/Tests-2154%20passing-brightgreen)](https://github.com/crisnahine/rails-ai-context/actions)
+[![Tests](https://img.shields.io/badge/Tests-2257%20passing-brightgreen)](https://github.com/crisnahine/rails-ai-context/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 </div>

data/docs/ARCHITECTURE.md

@@ -26,7 +26,7 @@ graph TD
         subgraph engine["Introspection Engine"]
             direction LR
             I["Introspectors\n31 modules\nPresets\nCached"]
-            AST["AST Engine\nPrism\n7 listeners\nConfidence tags"]
+            AST["AST Engine\nPrism\n20 listeners\nConfidence tags"]
             H["Hydration Layer\nSchema hints\ninjected into\ntool responses"]
         end