rails-ai-context 5.35.0 → 5.35.2

data/docs/GUIDE.md

@@ -19,7 +19,7 @@
 |:------|:------------|
 | [Quickstart](QUICKSTART.md) | Get running in 5 minutes |
 | [Copy-paste prompts](PROMPTS.md) | Let your AI tool install, change, remove or use the gem |
-| [Tools Reference](TOOLS.md) | All 45 MCP tools with parameters |
+| [Tools Reference](TOOLS.md) | All 35 MCP tools with parameters |
 | [Recipes](RECIPES.md) | Real-world workflows and examples |
 | [Custom Tools](CUSTOM_TOOLS.md) | Build your own MCP tools |
 | [Configuration](CONFIGURATION.md) | Every config option |
@@ -373,7 +373,7 @@ rails ai:context:claude           # Use this instead (no quoting needed)
 
 ## CLI Tools
 
-All 45 MCP tools can be run directly from the terminal - no MCP server or AI client needed.
+All 35 MCP tools can be run directly from the terminal - no MCP server or AI client needed.
 
 ### Rake
 
@@ -443,7 +443,7 @@ The `tool_mode` is selected during `rails generate rails_ai_context:install`.
 
 ## MCP Tools - Common Reference
 
-The 24 tools below are the ones worth reading about before you start. [Tools Reference](TOOLS.md) carries all 45 with their parameters.
+The 21 tools below are the ones worth reading about before you start. [Tools Reference](TOOLS.md) carries all 35 with their parameters.
 
 Every tool is **read-only** and **idempotent** - they never modify your application or database.
 
@@ -580,13 +580,35 @@ rails_get_controllers(detail: "full")
 
 ### rails_get_config
 
-Returns application configuration. No parameters.
+Returns the app's configuration, one section per call. `section` picks it: `app` (the default), `gems`, `frontend`, `api`, `engines`, `conventions`, `autoload`, `active_support`, `env`, `env_config` or `i18n`. Ten sections were tools of their own (`rails_get_gems`, `rails_get_env` and the rest); each answers what its tool did, and the old names still work from the CLI and over MCP.
 
-**Returns:** cache store, session store, timezone, queue adapter, mailer settings, the app's own middleware classes with their files and the rest of the stack as additions (framework defaults are filtered out), the `use` and `map` calls in `config.ru`, notable initializers, CurrentAttributes classes with the attributes they declare, their defaults and reset hooks.
+**Parameters:**
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `section` | string | Which section. Default: `app`. Required when `skip_tools` turns `app` off. |
+| `detail` | string | `summary` / `standard` (default) / `full`. Read by `frontend`, `api` and `env`. For `env`, summary is env var names only, standard groups them by source with external services, full adds per-file locations, Dockerfile vars and credentials keys. |
+| `category` | string | Read by `gems`: `auth`, `jobs`, `frontend`, `api`, `database`, `files`, `testing`, `deploy`, `monitoring`, `admin`, `pagination`, `search`, `forms`, `server`, `notifications`, `validation`, `utilities`, `services`, `payments`, `all` (default). |
+| `environment` | string | Read by `env_config`: one environment, by exact name. |
+| `locale` | string | Read by `i18n`: one locale's files and coverage. |
+| `offset`, `limit` | integer | Read by `gems`, `env_config` and `i18n`. Defaults: 0 and 50. |
+
+A parameter the asked section does not read is named in the answer as ignored.
+
+**Returns:** for `app`, cache store, session store, timezone, queue adapter, mailer settings, the app's own middleware classes with their files and the rest of the stack as additions (framework defaults are filtered out), the `use` and `map` calls in `config.ru`, notable initializers, CurrentAttributes classes with the attributes they declare, their defaults and reset hooks. `gems` groups notable gems by category; `conventions` lists architecture patterns, directory structure and config files; `env` lists environment variables grouped by purpose, external services and credentials keys, with no values.
 
 ```
 rails_get_config()
   → Cache: redis_cache_store, Session: cookie_store, TZ: UTC, ...
+
+rails_get_config(section: "gems")
+  → Auth: devise `4.9.3`, Jobs: sidekiq `7.2.1`, ...
+
+rails_get_config(section: "conventions")
+  → Architecture: [MVC, Service objects, Concerns], Patterns: [STI, Polymorphism], ...
+
+rails_get_config(section: "env", detail: "summary")
+  → Env var names grouped by category
 ```
 
 ### rails_get_test_info
@@ -609,36 +631,6 @@ rails_get_test_info(model: "User")
   → Shows spec/models/user_spec.rb test names (summary/standard) or full source (full)
 ```
 
-### rails_get_gems
-
-Returns notable gems categorized by function.
-
-**Parameters:**
-
-| Param | Type | Description |
-|-------|------|-------------|
-| `category` | string | Filter by category: `auth`, `jobs`, `frontend`, `api`, `database`, `files`, `testing`, `deploy`, `monitoring`, `admin`, `pagination`, `search`, `forms`, `server`, `notifications`, `validation`, `utilities`, `services`, `payments`, `all` (default). |
-| `limit` | integer | Max gems to return. Default: 50. |
-| `offset` | integer | Skip this many gems for pagination. Default: 0. |
-
-**Returns:** Notable gems grouped by category with descriptions.
-
-```
-rails_get_gems()
-  → Auth: devise `4.9.3`, Jobs: sidekiq `7.2.1`, ...
-```
-
-### rails_get_conventions
-
-Returns detected architecture patterns. No parameters.
-
-**Returns:** architecture patterns (MVC, service objects, STI, etc.), directory structure with file counts, config files, detected patterns.
-
-```
-rails_get_conventions()
-  → Architecture: [MVC, Service objects, Concerns], Patterns: [STI, Polymorphism], ...
-```
-
 ### rails_get_stimulus
 
 Returns Stimulus controller details: targets, values, actions, outlets, classes.
@@ -972,7 +964,7 @@ rails_get_service_pattern(detail: "full")
   → All services with methods, initialize params, side effects, and rescue blocks
 ```
 
-**Returns:** Service listing with common pattern detection (initialize+call, self.call, Result objects) or full detail including file path, initialize parameters, public methods, dependencies (other classes called), error handling (rescue blocks), side effects (database writes, email delivery, job enqueues, HTTP requests, Turbo broadcasts), and a list of files that call the service. A base class other services inherit from is named above the listing rather than counted as a service; asking for it by name still answers.
+**Returns:** Service listing with common pattern detection (initialize+call, self.call, Result objects) or full detail including file path, initialize parameters, public methods, dependencies (other classes called), error handling (rescue blocks), side effects (database writes, email delivery, job enqueues, HTTP requests, Turbo broadcasts), and a list of files that call the service. A base class other services inherit from is named above the listing and left out of the service count; asking for it by name still answers. When the service directories hold more Ruby files than the listing counts, one line says how many were left out and of which kind.
 
 ### rails_get_job_pattern
 
@@ -1000,31 +992,6 @@ rails_get_job_pattern(detail: "full")
 
 **Returns:** Job listing with queue breakdown or full detail including queue name, retry/discard configuration (retry_on, discard_on, Sidekiq options), perform method signature, guard clauses (early returns), dependencies (classes called), Turbo broadcasts, cron/recurring schedule (from sidekiq.yml or config files), side effects, and a list of files that enqueue the job.
 
-### rails_get_env
-
-Discover environment variables, external service dependencies, and credentials keys used by the app. Scans .rb, .rake, ERB views and config YAML for ENV[], .env.example, Dockerfile, the env Kamal's config/deploy.yml sets (secret names; clear values, except one holding a URL or a key-like token, or under a secret-named variable, which shows as hidden, and one an ERB tag sets, which says so), config gem setting keys, Anyway::Config attributes with their env names, external HTTP calls, and credentials keys (never values).
-
-**Parameters:**
-
-| Param | Type | Description |
-|-------|------|-------------|
-| `detail` | string | `summary` / `standard` (default) / `full`. summary: env var names only. standard: env vars grouped by source + external services. full: everything including per-file locations, Dockerfile vars, and credentials keys. |
-
-**Examples:**
-
-```
-rails_get_env()
-  → Env vars grouped by purpose (Database, Redis, AWS, etc.) + external services + credentials keys
-
-rails_get_env(detail: "summary")
-  → Env var names grouped by category
-
-rails_get_env(detail: "full")
-  → Per-file env var locations with line numbers, .env.example contents, Dockerfile ENV/ARG, external services with detection method, credentials keys, encrypted columns
-```
-
-**Returns:** Environment variables grouped by purpose (Database, Redis, AWS, Payments, Email, Monitoring, API Keys, etc.) with default values where detected. External service dependencies discovered from Gemfile gems and HTTP client calls. Credentials keys (never values). Encrypted model columns. Full detail includes per-file locations with line numbers.
-
 ### rails_get_partial_interface
 
 Analyze a partial's interface: local variables it expects, where it's rendered from, and what methods are called on each local. Use when rendering a partial, understanding what locals to pass, or refactoring partial dependencies.
@@ -1290,7 +1257,7 @@ end
 
 The endpoint is then served by your app's own server, on its address and port; `http_bind` and `http_port` configure only the standalone process.
 
-Both transports are **read-only** - they expose the same 45 tools and never modify your app.
+Both transports are **read-only** - they expose the same 35 tools and never modify your app.
 
 ### Controller Transport (Alternative)
 
@@ -1446,7 +1413,7 @@ end
 | `max_tool_response_chars` | Integer | `200_000` | Safety cap for MCP tool responses and resource payloads |
 | `cache_ttl` | Integer | `60` | Cache TTL in seconds for introspection results |
 | `custom_tools` | Array | `[]` | Additional MCP tool classes to register alongside built-in tools |
-| `skip_tools` | Array | `[]` | Built-in tool names to exclude (e.g. `%w[rails_security_scan]`) |
+| `skip_tools` | Array | `[]` | Built-in tool names to exclude (e.g. `%w[rails_security_scan]`). A custom tool with a skipped built-in's name takes its place, `rails_get_config` with its sections included |
 | `tool_mode` | Symbol | `:mcp` | `:mcp` (MCP primary + CLI fallback) or `:cli` (CLI only, no MCP server needed) |
 | `ai_tools` | Array | `nil` (all) | AI tools to generate context for: `%i[claude cursor copilot opencode codex]`. Selected during install. |
 | `excluded_models` | Array | internal Rails models | Models to skip |
@@ -1484,10 +1451,10 @@ end
 | `context_files` | Boolean | `true` | Set `false` for an MCP-only install: no CLAUDE.md, AGENTS.md, rules files or `.ai-context.json` are written |
 | `frontend_paths` | Array | `nil` (auto-detected) | Frontend directories, e.g. `["app/frontend", "../web-client"]`. One outside the app root is read for manifests only |
 | `extra_app_paths` | Array | `[]` | More app-root-relative directories that hold Rails app code. Each one's `app/models`, `app/controllers` and `app/views` are scanned |
-| `query_timeout` | Integer | `5` | `rails_query` statement timeout in seconds |
+| `query_timeout` | Number | `5` | `rails_query` statement timeout in seconds, a positive number |
 | `query_row_limit` | Integer | `100` | Max rows `rails_query` returns (1 to 1000) |
 | `query_redacted_columns` | Array | `password_digest`, `encrypted_password`, tokens, etc. | Column names `rails_query` refuses: a query naming one is rejected before it runs, and a returned column of that name comes back `[FILTERED]` |
-| `query_allowed_columns` | Array | `[]` | Column names to exempt from the built-in sensitive list |
+| `query_allowed_columns` | Array | `[]` | Column names to exempt from the built-in secret column names. It does not release an `encrypts` column |
 | `allow_query_in_production` | Boolean | `false` | Allow `rails_query` in production |
 | `log_lines` | Integer | `50` | Default number of lines `rails_read_logs` tails |
 | `instrumentation_include_arguments` | Boolean | `false` | Forward raw tool arguments in `ActiveSupport::Notifications` events |
@@ -1881,6 +1848,7 @@ config.max_tool_response_chars = 60_000
 ### Models not detected
 
 - Models must descend from `ActiveRecord::Base`, through `ApplicationRecord` or any other base class. Without a boot they must also sit in a model directory (`app/models/`, or a pack's or engine's)
+- A file in a `concerns/` directory of a model root is a model when the class its path names has a model superclass. A concern module that holds an inner class stays a concern. Without a boot, such a class is not listed when its superclass is a gem's own record base. The booted tier resolves it through the loaded class
 - Excluded models: `ApplicationRecord`, `ActiveStorage::*`, `ActionText::*`, `ActionMailbox::*`
 - Add custom exclusions: `config.excluded_models += %w[InternalModel]`
 

data/docs/INTROSPECTORS.md

@@ -228,7 +228,7 @@ Passed to `SourceIntrospector.walk(path, key => Listener)` when a specific file
 | VariantCallListener | `variant` calls (ChainedCallListener with `:variant` preset) |
 | ProcLiteralListener | Proc literals: line, source, assigned constant |
 | QueueAssignmentListener | A queue a class body assigns outside any method: Resque's `@queue = :name`, Que's `self.queue = "name"`, or a `def self.queue` returning one, a literal as its value, anything else as source |
-| HttpClientCallListener | Calls on an HTTP client constant (`Faraday`, `Net::HTTP`, `HTTParty`, `RestClient`, `HTTP`, `Excon`, `Typhoeus`, `URI.open`) with a literal URL, bare, wrapped in `URI(...)`/`URI.parse(...)` or as `url:`, and the host `Net::HTTP.start`/`.new` takes. `rails_get_env` names external services from it |
+| HttpClientCallListener | Calls on an HTTP client constant (`Faraday`, `Net::HTTP`, `HTTParty`, `RestClient`, `HTTP`, `Excon`, `Typhoeus`, `URI.open`) with a literal URL, bare, wrapped in `URI(...)`/`URI.parse(...)` or as `url:`, and the host `Net::HTTP.start`/`.new` takes. The `env` section of `rails_get_config` names external services from it |
 | ConstantReferenceListener | References to constants by last name, qualified or not (`ActiveSupport::MessageVerifier`), skipping one that only qualifies a nested constant (`MessageVerifier::InvalidSignature`) and mentions in comments or strings. Used by the ActiveSupport introspector for message verifier and encryptor usage |
 | MethodCallListener | Call sites by name or pattern anywhere in a file, inside a `def`, a lambda or a block included, with arguments, options, receiver, line, offset, the owning class or module, and `constants:` (each argument that is a constant, or builds one with `.new`, mapped to the constant's name). Used by the Turbo introspector for broadcast calls, the ActiveSupport introspector for notification subscriptions, and others |
 
@@ -279,14 +279,14 @@ same wherever it is asked. Those live as their own modules under
 | `RetryPolicy` | What a job does when it raises, as a reader would write it: the macro, its exceptions, then `attempts:` and `wait:` whatever order the source put them in |
 | `SourceCalls` | Which other classes a file hands work to, off the call nodes: the verb list, the framework receivers left out, and the call or the class alone |
 | `ServiceClasses` | Which classes under `app/services`, `app/interactions` and `app/interactors` are services and which are only the base of one, for the tool's listing and the generated files' line alike |
-| `EnvReferences` | Every ENV name the app's source reads, file by file, for `rails_get_env` and the context file's `env` section alike: `app`, `config` and `lib` Ruby, ERB and config YAML, `config.ru`, `db/seeds` and the `bin/` scripts whose shebang is Ruby, with config YAML on `sensitive_patterns` read for the names in its ERB tags only |
-| `AnywayConfigs` | Each Anyway::Config class under `config/configs` and `app/configs`, every class in a file, with the attributes its own body declares (a nested class keeps its macros) and the env name anyway_config reads each from: `env_prefix`, else `config_name`, else the name before `Config`. `rails_get_env` lists them |
+| `EnvReferences` | Every ENV name the app's source reads, file by file, for `rails_get_config`'s `env` section and the context file's `env` section alike: `app`, `config` and `lib` Ruby, ERB and config YAML, `config.ru`, `db/seeds` and the `bin/` scripts whose shebang is Ruby, with config YAML on `sensitive_patterns` read for the names in its ERB tags only |
+| `AnywayConfigs` | Each Anyway::Config class under `config/configs` and `app/configs`, every class in a file, with the attributes its own body declares (a nested class keeps its macros) and the env name anyway_config reads each from: `env_prefix`, else `config_name`, else the name before `Config`. `rails_get_config(section:"env")` lists them |
 | `GemfileGems` | The one Gemfile read, off `GemfileDslListener`: its entries with options and groups (the gems section's local gems and groups) and the gem names (every other asker), so a commented-out `gem` line is no gem anywhere; a file named by `eval_gemfile` is followed when it is inside the bundle's directory (the app root, or the directory of the Gemfile `config/boot.rb` points at), and one it cannot read is an `:unknown_gems` entry. GemLock takes the declared Ruby and the gem names from it once the gem is loaded; the walk is kept until one of the files changes. Before the boot, GemLock walks the one Gemfile with `AstWalk` instead and leaves `eval_gemfile` unread |
 | `ModuleAliases` | Which app file a bare JS import specifier names: tsconfig/jsconfig `compilerOptions.paths` followed through `extends` (relative files and installed packages), and a vite/webpack/rspack `resolve.alias` written as a literal object. The Stimulus scan uses it to tie a registration or a base class to the controller file it imports |
 | `HelperNames` | The helper methods a view can call: every method the app's helper modules define in every code root, and those of a module they `include`, found through the app's autoload roots (`lib` among them) or in its enclosing namespace's file (`CanonicalURL::Helpers` in `canonical_url.rb`). `rails_get_partial_interface` uses it so a helper call is not read as a local |
 | `Interaction` | Whether a class runs as an ActiveInteraction, following its superclass chain through the app's own sources, and the filters it takes - inherited ones first, one per name, each carrying the filters nested inside its block. See the **Interaction filter** entry in `CONTEXT.md` |
 | `RecurringSchedules` | The recurring tasks each scheduler reads from its own file: Solid Queue's `config/recurring.yml`, sidekiq-cron's `config/schedule.yml`, sidekiq-scheduler's section of `config/sidekiq.yml`, GoodJob's `config.good_job.cron` and whenever's `config/schedule.rb`. The job introspector hands it its own config walk, so a file it also reads for queue or mailer settings is walked once |
-| `AdminResources` | The models an admin gem exposes (ActiveAdmin, Trestle, Administrate, Avo, Madmin), from the folder each gem's generator writes to, with ActiveAdmin's `permit_params`. `rails_get_conventions` and `rails_analyze_feature` both ask it |
+| `AdminResources` | The models an admin gem exposes (ActiveAdmin, Trestle, Administrate, Avo, Madmin), from the folder each gem's generator writes to, with ActiveAdmin's `permit_params`. `rails_get_config(section:"conventions")` and `rails_analyze_feature` both ask it |
 | `SchemaDumpPath` | The primary database's dump file as `DatabaseTasks.schema_dump_path` names it: `database.yml`'s `schema_dump` in the configured `schema_format`, then each format's default file, and the secondary databases' dumps. Every schema reader, the doctor and the pending-migration check ask it |
 | `ApartmentConfig` | The models an Apartment initializer keeps in the shared schema (`excluded_models`), or the source of a list the file computes. The model introspector asks it to say which models get one table per tenant |
 | `SchemaReader` | What a `schema.rb` dump declares: tables, columns, defaults, indexes, foreign keys, enum types and check constraints. `SchemaReader.for(root)` answers from whichever source the app committed: `schema.rb`, `structure.sql`, or a migration replay |

data/docs/QUICKSTART.md

@@ -113,7 +113,7 @@ rails 'ai:tool[search_code]' pattern="your_method_name" match_type=trace
 rails 'ai:tool[analyze_feature]' feature=auth
 
 # 3. Get your app's actual conventions - not generic Rails patterns
-rails 'ai:tool[conventions]'
+rails 'ai:tool[config]' section=conventions
 ```
 
 ## What to do next

data/docs/RECIPES.md

@@ -138,9 +138,9 @@ AI sees the full picture: the parent controller's `authenticate_user!` filter, t
 AI sees what already exists before building anything. Then:
 
 ```
-→ rails_get_conventions()   # Your app's patterns, not generic Rails
-→ rails_get_gems()          # Sees ActionMailer, Sidekiq, etc.
-→ rails_get_schema()        # Picks the right foreign keys and types
+→ rails_get_config(section: "conventions")   # Your app's own patterns
+→ rails_get_config(section: "gems")          # Sees ActionMailer, Sidekiq, etc.
+→ rails_get_schema()                          # Picks the right foreign keys and types
 ```
 
 AI scaffolds the feature matching your app's actual patterns - not generic Rails conventions from training data.
@@ -206,7 +206,7 @@ rails_onboard(detail: "full")
 rails_dependency_graph(format: "mermaid")
 # → Visual model relationship graph
 
-rails_get_gems()
+rails_get_config(section: "gems")
 # → Every notable gem with version, category, and config location
 ```
 
@@ -306,7 +306,7 @@ rails_search_code(pattern: "include Searchable", match_type: "any")
 rails_get_component_catalog(detail: "standard")
 # → ViewComponent/Phlex: props, slots, previews, sidecar assets, usage examples
 
-rails_get_frontend_stack()
+rails_get_config(section: "frontend")
 # → React/Vue/Svelte, Hotwire, TypeScript, Vite/Webpacker
 ```
 

data/docs/RELEASING.md

@@ -32,7 +32,9 @@ pushed.
    commit anyway.
 4. **Prose that names the last version goes stale where no check can see it.**
    `docs/COMPATIBILITY.md` names the release its proof sources come from. Grep
-   the tree for the previous version before committing.
+   the tree for the previous version before committing. The repository's About
+   text on GitHub names the tool count, and no check reads it:
+   `gh repo edit --description` changes it.
 5. **The copy-paste prompts name a version floor.** `docs/PROMPTS.md` (and the
    README's copy of the recommended prompt) tells the AI tool to install
    `>= 5.35.0`, the first release with the install flags. If the release that