rails-ai-context 5.10.0 → 5.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b022525ce9aa13c5b6d5f21a46f13db5ae84dac04f346adc40eeb2b315f9fcaa
-  data.tar.gz: 9e9f7bd60ecdab6a5d1599e560762c8c7d95a8973f5d001c4573d00f55b2a594
+  metadata.gz: 21293efcd236f2ea0b04dd95564369f21e071a0373e71343caa740db9a2eb9f1
+  data.tar.gz: 0b9487187d0af78dc5e3fdd02f6f0910a132c69d306d0472ee98174baa9773d4
 SHA512:
-  metadata.gz: 7dca71cfea9fb5106b40f5eaebd119e36bcd1cbcbdd41b8dcd8ba4b11eb802dbb647d0c90db88b4d21a98d303ed2ed42f605ca7278a245a76155fc57cb0366cf
-  data.tar.gz: baaeaa8a5eec91ba86c6aee32f5a0d459ebcc7f14c1eaec64e7110afe7368985e005b92dcdee960606525806d652cd63f5eb1092773765cbe831857cffde75a1
+  metadata.gz: '016190a6a753c61f7363a7ad61855c153ef2a9c0d98e2ffb95dd164a1c1310deb9a8963b9afed5ff2c12d12644a93470d2d1d38bb510ddda69579e77f8941755'
+  data.tar.gz: 730deb817f8800b7468d4dd09e0af68c1a1429e4475c19e05eefc77d1e2728a246e2e4e2ba04249685de7a9b70c6248742773225d75df2b13d5e2fcd73694307

data/CHANGELOG.md

@@ -5,6 +5,57 @@ 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.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