rails-ai-context 0.8.4 → 0.8.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08211bf465556a4185faaebc25d66fffcf4bd2e54ba335708b82c5e8d81f11f2'
-  data.tar.gz: 2ab947951eb10d48acc6d674c31cea3b2ab9104a6ca9a9f6e9c409ffa1f96a7a
+  metadata.gz: 8933a659a2417ef033549547e011f90f7e3e3b1cacc8d2421802b944987869f2
+  data.tar.gz: fd39c3dc419170ca979d1c5fc3ccf59d4da66bec27ee712bfbb0ac9e1996769c
 SHA512:
-  metadata.gz: 4757bd5de1b215938543d138b4c4a077ff7d1cda9dc25164e03251acd81afe26cd65cae9855cf879950b7a77e1f8aa78fb86e9a02d2e640e10569a9a5fc2bb45
-  data.tar.gz: b2ebb6584d2886ae60c587954fdd54687c9a23a74422c395ee3d1cec063d9c499c4094ea611f1b053100b27cdaa4a47c85da006d99354437e52b6459575aab7c
+  metadata.gz: 3cb8ffb9600a47aca301bfc4d232bb3ff08f1283a66e3f2a7b0e2b205b31d91cf0b2ec6cbab43e8c7856d79191c467662cf693b74b7a26805f11a8c6c116d7f7
+  data.tar.gz: fa41c1eb1d078119a807cb5e9a6558fe3f40e6523eb1e497e9662d5454c3e756de0f39dd5a0744d3f1921c368011d4e2778fd4b460dc4918adc1f9002aa45fd5

data/CHANGELOG.md

@@ -5,6 +5,19 @@ 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).
 
+## [0.8.5] - 2026-03-19
+
+### Fixed
+
+- **Thread-safe shared tool cache** — `BaseTool.cached_context` now uses a Mutex-protected shared cache across all 9 tool subclasses. Previously, each subclass cached independently (up to 9 redundant introspections after invalidation) and had no synchronization for multi-threaded servers like Puma. ([#2](https://github.com/crisnahine/rails-ai-context/issues/2))
+- **SearchCode ripgrep total result cap** — `rg --max-count N` limits matches per file, not total. A search with `max_results: 5` against a large codebase could return hundreds of results. Now capped with `.first(max_results)` after parsing, matching the Ruby fallback behavior. ([#3](https://github.com/crisnahine/rails-ai-context/issues/3))
+- **JobIntrospector Proc queue fallback** — when a Proc-based `queue_name` raises during introspection, the queue now falls back to `"default"` instead of producing garbage like `"#<Proc:0x00007f...>"`. ([#4](https://github.com/crisnahine/rails-ai-context/issues/4))
+- **CLI `version` command crash** — `rails-ai-context version` crashed with `LoadError` due to wrong `require_relative` path (`../rails_ai_context/version` instead of `../lib/rails_ai_context/version`). ([#5](https://github.com/crisnahine/rails-ai-context/issues/5))
+
+### Documentation
+
+- **Standalone CLI documented** — the `rails-ai-context` executable (serve, context, inspect, watch, doctor, version) is now documented in README, GUIDE, and CLAUDE.md.
+
 ## [0.8.4] - 2026-03-19
 
 ### Added

data/CLAUDE.md

@@ -20,6 +20,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 - `lib/rails_ai_context/watcher.rb` — File watcher for auto-regenerating context files
 - `lib/rails_ai_context/engine.rb` — Rails Engine for auto-integration
 - `lib/generators/rails_ai_context/install/` — Install generator (creates .mcp.json, initializer, context files)
+- `exe/rails-ai-context` — Standalone Thor CLI (serve, context, inspect, watch, doctor, version)
 
 ## Key Design Decisions
 
@@ -39,7 +40,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (392 examples)
+bundle exec rspec           # Run specs (403 examples)
 bundle exec rubocop         # Lint
 ```
 

data/README.md

@@ -299,6 +299,8 @@ Frontend introspectors (views, Turbo, Stimulus, assets) degrade gracefully — t
 
 ## Commands
 
+### Rake tasks (recommended)
+
 | Command | Description |
 |---------|-------------|
 | `rails ai:context` | Generate all 20 context files (skips unchanged) |
@@ -322,6 +324,23 @@ Frontend introspectors (views, Turbo, Stimulus, assets) degrade gracefully — t
 > CONTEXT_MODE=full rails ai:context:cursor     # full dump — Cursor only
 > ```
 
+### Standalone CLI
+
+The gem also ships a `rails-ai-context` executable — an alternative to rake tasks. Useful for `.mcp.json` configs or when you prefer a shorter command.
+
+| Command | Equivalent rake task |
+|---------|---------------------|
+| `rails-ai-context serve` | `rails ai:serve` |
+| `rails-ai-context serve --transport http` | `rails ai:serve_http` |
+| `rails-ai-context context` | `rails ai:context` |
+| `rails-ai-context context --format claude` | `rails ai:context:claude` |
+| `rails-ai-context doctor` | `rails ai:doctor` |
+| `rails-ai-context watch` | `rails ai:watch` |
+| `rails-ai-context inspect` | `rails ai:inspect` |
+| `rails-ai-context version` | — |
+
+Run from your Rails app root. Use `rails-ai-context help` for all options.
+
 ---
 
 ## Works Without a Database
@@ -353,7 +372,7 @@ The gem parses `db/schema.rb` as text when no database is connected. Works in CI
 ```bash
 git clone https://github.com/crisnahine/rails-ai-context.git
 cd rails-ai-context && bundle install
-bundle exec rspec       # 392 examples
+bundle exec rspec       # 403 examples
 bundle exec rubocop     # Lint
 ```
 

data/demo_script.sh

@@ -8,7 +8,7 @@ echo 'Fetching gem metadata from https://rubygems.org...'
 sleep 0.3
 echo 'Resolving dependencies...'
 sleep 0.3
-echo 'Installing rails-ai-context 0.8.4'
+echo 'Installing rails-ai-context 0.8.5'
 echo ''
 sleep 1
 

data/docs/GUIDE.md

@@ -217,6 +217,25 @@ Commit **all files except `.ai-context.json`** (which is gitignored). This gives
 | `rails ai:watch` | Watch for file changes and auto-regenerate context files. Requires `listen` gem. |
 | `rails ai:inspect` | Print introspection summary to stdout. Useful for debugging. |
 
+### Standalone CLI
+
+The gem ships a `rails-ai-context` executable as an alternative to rake tasks. Useful for `.mcp.json` configs or when you prefer a shorter command.
+
+```bash
+rails-ai-context serve                     # Start MCP server (stdio)
+rails-ai-context serve --transport http    # Start MCP server (HTTP, port 6029)
+rails-ai-context serve --transport http --port 8080  # Custom port
+rails-ai-context context                   # Generate all context files
+rails-ai-context context --format claude   # Generate Claude files only
+rails-ai-context doctor                    # Run diagnostics
+rails-ai-context watch                     # Watch for changes
+rails-ai-context inspect                   # Print introspection JSON
+rails-ai-context version                   # Print version
+rails-ai-context help                      # Show all commands
+```
+
+Must be run from your Rails app root directory (requires `config/environment.rb`).
+
 ### Legacy command
 
 ```bash

data/exe/rails-ai-context

@@ -72,7 +72,7 @@ module RailsAiContext
 
     desc "version", "Print version"
     def version
-      require_relative "../rails_ai_context/version"
+      require_relative "../lib/rails_ai_context/version"
       puts "rails-ai-context v#{RailsAiContext::VERSION}"
     end
 

data/lib/rails_ai_context/introspectors/job_introspector.rb

@@ -30,7 +30,7 @@ module RailsAiContext
                   job.name.start_with?("ActionMailer", "ActiveStorage::", "ActionMailbox::", "Turbo::", "Sentry::")
 
           queue = job.queue_name
-          queue = queue.call rescue queue.to_s if queue.is_a?(Proc)
+          queue = begin queue.call rescue "default" end if queue.is_a?(Proc)
 
           {
             name: job.name,

data/lib/rails_ai_context/tools/base_tool.rb

@@ -8,6 +8,10 @@ module RailsAiContext
     # Inherits from the official MCP::Tool to get schema validation,
     # annotations, and protocol compliance for free.
     class BaseTool < MCP::Tool
+      # Shared cache across all tool subclasses, protected by a Mutex
+      # for thread safety in multi-threaded servers (e.g., Puma).
+      SHARED_CACHE = { mutex: Mutex.new }
+
       class << self
         # Convenience: access the Rails app and cached introspection
         def rails_app
@@ -18,31 +22,36 @@ module RailsAiContext
           RailsAiContext.configuration
         end
 
-        # Cache introspection results with TTL + fingerprint invalidation
+        # Cache introspection results with TTL + fingerprint invalidation.
+        # Uses SHARED_CACHE so all tool subclasses share one introspection
+        # result instead of each caching independently.
         def cached_context
-          now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-          ttl = RailsAiContext.configuration.cache_ttl
+          SHARED_CACHE[:mutex].synchronize do
+            now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+            ttl = RailsAiContext.configuration.cache_ttl
 
-          if @cached_context && (now - @cache_timestamp) < ttl && !Fingerprinter.changed?(rails_app, @cache_fingerprint)
-            return @cached_context
-          end
+            if SHARED_CACHE[:context] && (now - SHARED_CACHE[:timestamp]) < ttl && !Fingerprinter.changed?(rails_app, SHARED_CACHE[:fingerprint])
+              return SHARED_CACHE[:context]
+            end
 
-          @cached_context = RailsAiContext.introspect
-          @cache_timestamp = now
-          @cache_fingerprint = Fingerprinter.compute(rails_app)
-          @cached_context
+            SHARED_CACHE[:context] = RailsAiContext.introspect
+            SHARED_CACHE[:timestamp] = now
+            SHARED_CACHE[:fingerprint] = Fingerprinter.compute(rails_app)
+            SHARED_CACHE[:context]
+          end
         end
 
         def reset_cache!
-          @cached_context = nil
-          @cache_timestamp = nil
-          @cache_fingerprint = nil
+          SHARED_CACHE[:mutex].synchronize do
+            SHARED_CACHE.delete(:context)
+            SHARED_CACHE.delete(:timestamp)
+            SHARED_CACHE.delete(:fingerprint)
+          end
         end
 
-        # Reset cache on ALL registered tool subclasses at once.
-        # Used by LiveReload to invalidate everything on file change.
+        # Reset the shared cache. Used by LiveReload to invalidate on file change.
         def reset_all_caches!
-          RailsAiContext::Server::TOOLS.each(&:reset_cache!)
+          reset_cache!
         end
 
         # Helper: wrap text in an MCP::Tool::Response with safety-net truncation

data/lib/rails_ai_context/tools/search_code.rb

@@ -99,7 +99,7 @@ module RailsAiContext
         cmd << search_path
 
         output, _status = Open3.capture2(*cmd, err: File::NULL)
-        parse_rg_output(output, root)
+        parse_rg_output(output, root).first(max_results)
       rescue => e
         [ { file: "error", line_number: 0, content: e.message } ]
       end

data/lib/rails_ai_context/version.rb

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

data/server.json

@@ -7,11 +7,11 @@
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"
   },
-  "version": "0.8.4",
+  "version": "0.8.5",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v0.8.4/rails-ai-context-mcp.mcpb",
+      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v0.8.5/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: 0.8.4
+  version: 0.8.5
 platform: ruby
 authors:
 - crisnahine