coverband 6.1.6 → 6.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 032cf0d003aefa2d222472e12412e352f5059cfffc93645810692e60b3dc6602
-  data.tar.gz: b094364d6cc2dbfbc2527209f4bf03025c06199443a0b9fa0380851afe7a00ae
+  metadata.gz: e3ae4783bfea151c9e3b5d58e397467085206359b6c3446df24ad136fc067ca3
+  data.tar.gz: c7491d46394412b813447b80e21ca29e1cfe62060b54a28a14a6145a8ec5eb84
 SHA512:
-  metadata.gz: 14ce46ede0f55f2162878529c8226a022518df0a0a22c83ad323d0856fad43b99a9f694b3b629171b86872bfd16626da9772388cae5a665a5e00e1493ef81b8b
-  data.tar.gz: c394482fdfddfa2d70dab2453517f2c490e66e1b9ef463a5a097413deb41540158a13a0626a2f3c4e62fc263de3052df6d99c7c7765ddb9ae867074b5b943e94
+  metadata.gz: 2cbd8715bf8a5ea95e5705038acec36bd8549fb9ca01b99c4266919904122fb9fd81cbc3e1488d6eaa0c0bb955875c429751523843449abc0c5d01107d620085
+  data.tar.gz: f4ac2904d9cde83162aa3f1d350aeb25e337f8c86178b79668170ae00ef64df9d564e15cdd94597cb1ea6652daa244b8454cdc8c3401e14b74662527ff7ea34e

data/.github/workflows/main.yml

@@ -21,7 +21,7 @@ jobs:
         # removing jruby again to flaky
         gemfile: [ Gemfile.rails7.0, Gemfile.rails7.1, Gemfile.rails7.2, Gemfile.rails8.0 ]
         # need to add support for multiple gemfiles
-        ruby: ["3.1", "3.2", "3.3", "3.4", "ruby-head"]
+        ruby: ["3.1", "3.2", "3.3", "3.4", "4.0", "ruby-head"]
         redis-version: [4, 5, 6, 7]
         exclude:
           # Rails 8 requires ruby 3.2+.
@@ -29,8 +29,8 @@ jobs:
             ruby: '3.1'
     runs-on: ${{ matrix.os }}-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: supercharge/redis-github-action@1.8.0
+      - uses: actions/checkout@v6
+      - uses: supercharge/redis-github-action@v2
         with:
           redis-version: ${{ matrix.redis-version }}
       - uses: ruby/setup-ruby@v1
@@ -42,7 +42,7 @@ jobs:
   starndardrb:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: 3.1

data/README.md

@@ -406,6 +406,129 @@ A few folks have asked about what size of Redis is needed to run Coverband. I ha
 
 # Newer Features
 
+### MCP Server for AI Assistants
+
+Coverband includes an optional MCP (Model Context Protocol) server that allows AI assistants like Claude to query your production coverage data directly. This enables AI-powered code analysis, dead code detection, and coverage insights.
+
+#### Installation
+
+Add the MCP gem to your Gemfile:
+
+```ruby
+gem 'mcp'
+```
+
+#### Available Tools
+
+The MCP server provides the following tools:
+
+| Tool | Description |
+|------|-------------|
+| `get_coverage_summary` | Get overall coverage statistics |
+| `get_file_coverage` | Get detailed coverage for a specific file |
+| `get_uncovered_files` | List files with no coverage data |
+| `get_dead_methods` | Find methods that are never called |
+| `get_view_tracker_data` | Get view/template usage data |
+| `get_route_tracker_data` | Get route usage statistics |
+| `get_translation_tracker_data` | Get translation key usage data |
+
+#### Running the MCP Server
+
+**Standalone (stdio transport):**
+
+```bash
+bundle exec coverband-mcp
+```
+
+**With a rake task:**
+
+```bash
+bundle exec rake coverband:mcp
+```
+
+**HTTP mode (for remote access):**
+
+```bash
+COVERBAND_MCP_HTTP=true COVERBAND_MCP_PORT=9023 bundle exec rake coverband:mcp
+```
+
+#### Configuring Claude Desktop
+
+Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+**Option 1: Stdio transport (recommended for local development)**
+
+```json
+{
+  "mcpServers": {
+    "coverband": {
+      "command": "bundle",
+      "args": ["exec", "coverband-mcp"],
+      "cwd": "/path/to/your/rails/app"
+    }
+  }
+}
+```
+
+**Option 2: HTTP transport (for remote access or shared servers)**
+
+First, start the MCP server in HTTP mode:
+
+```bash
+COVERBAND_MCP_HTTP=true bundle exec rake coverband:mcp
+```
+
+Then configure Claude Desktop to connect via `mcp-remote`:
+
+```json
+{
+  "mcpServers": {
+    "coverband": {
+      "command": "npx",
+      "args": ["mcp-remote", "http://localhost:9023"]
+    }
+  }
+}
+```
+
+#### Configuring Claude Code
+
+Add a `.mcp.json` file to your project root:
+
+**Option 1: Stdio transport (recommended)**
+
+```json
+{
+  "mcpServers": {
+    "coverband": {
+      "command": "bundle",
+      "args": ["exec", "coverband-mcp"]
+    }
+  }
+}
+```
+
+**Option 2: HTTP transport**
+
+```json
+{
+  "mcpServers": {
+    "coverband": {
+      "command": "npx",
+      "args": ["mcp-remote", "http://localhost:9023"]
+    }
+  }
+}
+```
+
+#### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `COVERBAND_MCP_HTTP` | Enable HTTP transport instead of stdio | `false` |
+| `COVERBAND_MCP_PORT` | Port for HTTP server | `9023` |
+| `COVERBAND_REDIS_URL` | Redis URL for coverage data | `localhost:6379` |
+
 ### Dead Method Scanning (ruby 2.6+)
 
 Rake task that outputs dead methods based on current coverage data:

data/agents.md

@@ -0,0 +1,217 @@
+# AI Agent Guidelines for Coverband Development
+
+This document provides guidance for AI coding agents working on the Coverband project. Following these guidelines ensures code quality and consistency.
+
+## Project Overview
+
+Coverband is a Ruby gem that provides rack middleware to measure production code usage (LOC runtime usage). The project uses:
+- **Ruby**: >= 3.1
+- **Test Framework**: Minitest (version ~> 5.0)
+- **Code Style**: StandardRB
+- **CI/CD**: GitHub Actions
+
+## Testing Requirements
+
+### Running Tests
+
+All code changes MUST pass the test suite before considering work complete. The project has multiple test targets:
+
+#### Standard Test Suite
+```bash
+bundle exec rake test
+```
+This runs the main integration and unit tests located in:
+- `test/integration/**/*_test.rb`
+- `test/coverband/**/*_test.rb`
+
+#### Forked Tests
+```bash
+bundle exec rake forked_tests
+```
+Runs tests that require forked processes (Rails integration tests):
+- `test/forked/**/*_test.rb`
+
+Note: Forked tests are not supported on JRuby.
+
+#### Full Test Suite
+```bash
+bundle exec rake test:all
+```
+Runs all tests including benchmarks and memory tests.
+
+#### Default Task
+```bash
+bundle exec rake
+```
+Equivalent to `bundle exec rake test`
+
+### Test Framework Details
+
+- Uses **Minitest** with **Mocha** for mocking
+- Test files follow the pattern `*_test.rb`
+- Rails integration tests use **Capybara** for browser testing
+- Forked tests use `minitest-fork_executor` for parallel execution
+
+### Test Configuration
+
+Key test dependencies:
+- `minitest ~> 5.0` (pinned for compatibility with minitest-fork_executor)
+- `mocha` for mocking/stubbing
+- `minitest-stub-const` for constant stubbing
+- `capybara` for integration testing
+- `rack-test` for Rack testing
+
+## Code Style Requirements
+
+### StandardRB
+
+All code MUST pass StandardRB linting before considering work complete.
+
+```bash
+bundle exec standardrb --format github
+```
+
+#### Auto-fix Style Issues
+```bash
+bundle exec standardrb --fix
+```
+
+### Configuration
+
+StandardRB configuration is in `.standard.yml`:
+- Ruby version: 3.1
+- Parallel execution enabled
+- Some rules are disabled for compatibility with older Ruby versions
+- Test files have relaxed rules (see `.standard.yml` for specifics)
+
+### Common Style Requirements
+
+1. **Module Inclusions**: Add an empty line after `extend` or `include` statements
+2. **Frozen String Literals**: All Ruby files should start with `# frozen_string_literal: true`
+3. **Line Length**: Follow StandardRB defaults (no manual line length configuration needed)
+
+## AI Agent Workflow
+
+When making code changes, follow this workflow:
+
+### 1. Make Code Changes
+Implement the requested feature or bug fix.
+
+### 2. Run Tests
+```bash
+bundle exec rake test
+```
+
+If working on Rails integration or forked features:
+```bash
+bundle exec rake test:all
+```
+
+### 3. Fix Any Test Failures
+- Read test output carefully
+- Fix issues in the code
+- Re-run tests until all pass
+
+### 4. Check Code Style
+```bash
+bundle exec standardrb --format github
+```
+
+### 5. Auto-fix Style Issues (if any)
+```bash
+bundle exec standardrb --fix
+```
+
+### 6. Verify Everything Passes
+```bash
+bundle exec rake test
+bundle exec standardrb --format github
+```
+
+### 7. Only Then Consider Work Complete
+Do NOT mark work as complete or hand back to the user until:
+- ✅ All tests pass
+- ✅ StandardRB reports no violations
+
+## Common Issues and Solutions
+
+### Mocha Configuration
+- Use only Mocha 3.x compatible configuration options
+- Valid options: `stubbing_method_unnecessarily`, `stubbing_non_public_method`
+- Invalid options (removed): `stubbing_method_on_nil`, `stubbing_method_on_non_mock_object`, `stubbing_non_existent_method`
+
+### Rails Constant Checks
+When checking if Rails is defined:
+```ruby
+# ✅ Correct
+if defined?(Rails) && Rails.respond_to?(:version)
+  # ...
+end
+
+# ❌ Wrong (doesn't protect against undefined constant)
+if Rails&.respond_to?(:version)
+  # ...
+end
+```
+
+### Minitest Version
+- Must use Minitest ~> 5.0 for compatibility with `minitest-fork_executor`
+- Minitest 6.0+ is not compatible with the fork executor
+
+## CI/CD
+
+The project uses GitHub Actions for CI. On every push/PR:
+1. Tests run against multiple Ruby versions (3.1, 3.2, 3.3, 3.4, ruby-head)
+2. Tests run against multiple Rails versions (7.0, 7.1, 7.2, 8.0)
+3. Tests run against multiple Redis versions (4, 5, 6, 7)
+4. StandardRB runs separately to check code style
+
+Your local testing should match CI requirements:
+- All tests must pass
+- StandardRB must report no violations
+
+## Additional Notes
+
+- The project uses Redis as the default storage backend
+- Rails 8.0 requires Ruby 3.2+
+- Test coverage data is stored in `/tmp` during tests
+- Use `test_helper.rb` for common test setup
+- Use `rails_test_helper.rb` for Rails-specific test setup
+
+## Example Complete Workflow
+
+```bash
+# 1. Make changes to code
+vim lib/coverband/some_file.rb
+
+# 2. Run tests
+bundle exec rake test
+
+# 3. Fix any failures, re-run until passing
+bundle exec rake test
+
+# 4. Check style
+bundle exec standardrb --format github
+
+# 5. Auto-fix any style issues
+bundle exec standardrb --fix
+
+# 6. Final verification
+bundle exec rake test
+bundle exec standardrb --format github
+
+# 7. All green? Work is complete! ✅
+```
+
+## Quick Reference
+
+| Command | Purpose |
+|---------|---------|
+| `bundle exec rake` | Run main test suite (default) |
+| `bundle exec rake test` | Run main test suite |
+| `bundle exec rake forked_tests` | Run forked/Rails integration tests |
+| `bundle exec rake test:all` | Run all tests including benchmarks |
+| `bundle exec standardrb --format github` | Check code style |
+| `bundle exec standardrb --fix` | Auto-fix style issues |
+
+Remember: **Tests and style checks must pass before work is considered complete!**

data/bin/coverband-mcp

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "coverband/mcp"
+
+# Ensure Coverband is configured
+Coverband.configure unless Coverband.configured?
+
+# Security check and warning
+unless Coverband.configuration.mcp_enabled?
+  puts "❌ ERROR: MCP is not enabled for security reasons."
+  puts "To enable MCP access, configure Coverband with:"
+  puts
+  puts "Coverband.configure do |config|"
+  puts "  config.mcp_enabled = true"
+  puts "  config.mcp_password = 'your-secure-password'  # Recommended"
+  puts "  config.mcp_allowed_environments = %w[development staging production]  # As needed"
+  puts "end"
+  puts
+  puts "Or set environment variables:"
+  puts "  COVERBAND_MCP_PASSWORD=your-secure-password"
+  puts
+  puts "Current environment: #{(defined?(Rails) && Rails.respond_to?(:env) && Rails.env) || ENV["RAILS_ENV"] || ENV["RACK_ENV"] || "development"}"
+  exit 1
+end
+
+# Display security status
+puts "🔐 SECURITY STATUS:"
+if Coverband.configuration.mcp_password
+  puts "  ✅ Authentication: Enabled (password protected)"
+else
+  puts "  ⚠️  Authentication: DISABLED - Consider setting mcp_password for production use"
+end
+env = (defined?(Rails) && Rails.respond_to?(:env) && Rails.env) || ENV["RAILS_ENV"] || ENV["RACK_ENV"] || "development"
+puts "  📍 Environment: #{env}"
+puts "  🌍 Allowed environments: #{Coverband.configuration.mcp_allowed_environments.join(", ")}"
+puts
+
+# Start the MCP server with stdio transport
+server = Coverband::MCP::Server.new
+server.run_stdio

data/changes.md

@@ -1,3 +1,21 @@
+### Coverband 6.1.7
+
+* add back a running demo site
+  * source: https://github.com/danmayer/coverband_rails_example
+  * demo site: https://coverband-rails-example.onrender.com/demo
+* Feature: Added MCP (Model Context Protocol) server support for AI assistants
+  * Allows AI agents (like Claude) to securely query coverage data, find dead code, and analyze usage
+  * Includes HTTP and Stdio transports
+  * See `docs/mcp_security.md` and README for setup instructions
+* Feature: Added `Coverband::MCP::HttpHandler` for mounting MCP server in Rack apps
+* Improvement: Added `routes_tracker` alias for `route_tracker` in configuration
+* Improvement: Better error handling when Redis is not available (defaults to NullStore with a warning)
+* Improvement: Updates to `lib/coverband/utils/lines_classifier.rb` to better handle `:nocov:` markers
+* Docs: Added `agents.md` for AI contributor guidelines
+* Docs: Added `docs/mcp_security.md`
+* Fix: Logging to `$stdout` instead of `STDOUT` to avoid warnings
+* Fix: Added GitHub Issue templates and Dependabot config
+
 ### Coverband 6.1.6
 
 * Check for Rails::Engine - Stephen Wetzel

data/coverband/log.272267

@@ -0,0 +1 @@
+{"./lib/coverband/integrations/resque.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"977366ad12b0f837e4cc3daf56f0ca80","data":[null,null,1,0,0,null,null,1,0,0,0,0,null,null,1,1,1,0,null,0,null,null,null,null,1,0,0,0,null,0,null,0,0,null,null,1,null]},"./lib/coverband/reporters/web.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"2787678b2bc7efcac5241a468cb46153","data":[null,null,1,1,null,null,1,null,0,null,null,1,1,1,1,null,1,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,1,0,0,null,null,null,null,1,0,null,null,0,0,null,0,null,null,1,0,0,null,null,1,0,null,0,null,0,0,0,0,0,0,0,0,0,null,0,null,null,null,null,0,0,0,null,0,null,0,null,0,null,null,0,null,0,null,0,null,0,null,0,null,0,null,0,null,0,null,0,null,0,null,0,null,null,null,null,null,1,0,0,0,0,null,null,null,null,null,0,0,null,null,null,1,0,null,null,null,null,null,1,0,null,null,null,0,0,null,null,null,null,null,1,0,0,null,null,1,0,0,null,0,null,null,null,0,null,null,1,0,null,null,1,0,null,null,1,0,null,null,null,null,null,null,1,0,0,null,null,null,null,null,1,0,0,0,null,0,null,0,null,null,1,0,0,0,0,null,0,null,0,null,null,1,0,0,0,null,0,null,0,null,null,1,0,0,0,0,null,0,null,0,null,null,1,null,1,null,0,null,0,0,null,null,null,null,null,null,null,null,null,null,1,0,null,null,null,null]},"./lib/coverband/utils/html_formatter.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"8617750f352ca404c391010aabf5eb02","data":[null,null,1,1,1,1,1,null,null,null,null,null,1,1,1,1,null,1,0,0,0,0,0,null,null,1,0,null,null,1,0,null,null,1,0,null,null,1,0,null,null,1,0,null,0,0,null,0,null,null,null,1,null,1,0,null,null,1,0,0,null,null,0,0,null,null,null,1,0,null,null,1,0,null,null,null,1,0,null,null,1,0,null,null,1,0,null,0,0,0,null,null,1,0,null,null,1,0,null,null,1,0,0,0,0,0,null,null,1,0,null,null,null,1,0,null,0,null,null,null,1,0,null,null,null,0,null,0,null,null,1,0,0,0,0,0,0,null,0,null,null,null,1,0,0,0,0,null,0,null,null,null,1,0,0,null,0,null,null,null,null,1,0,null,null,1,0,0,null,0,null,null,null,1,0,null,null,1,0,0,null,null,1,0,0,null,0,0,null,null,null,null,null]},"./lib/coverband/utils/result.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"ff599c81f41c81e32631b763a200528c","data":[null,null,1,1,null,null,null,null,null,null,null,null,1,1,1,1,null,null,1,null,null,1,1,null,1,null,1,1,null,null,null,1,0,null,0,0,null,null,null,null,1,0,null,null,null,1,0,null,null,null,null,1,0,null,0,0,0,0,null,null,null,null,null,null,0,null,null,null,null]},"./lib/coverband/utils/file_list.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"fd392626f49763a4a541c7925509ef49","data":[null,null,null,null,null,null,null,null,null,1,1,1,null,1,0,null,0,null,null,null,1,0,null,0,null,null,null,1,0,null,0,null,null,null,1,0,null,0,null,null,null,null,1,0,null,null,null,1,0,null,null,null,null,1,0,null,0,null,null,null,null,1,0,null,null,null,null,1,0,null,0,null,null,1,0,null,null,null,null]},"./lib/coverband/utils/source_file.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"fce22b672513bddebaf353ff73650db6","data":[null,null,null,null,null,null,null,null,null,1,1,1,null,null,null,null,null,null,1,null,1,null,1,null,1,null,1,null,1,null,null,1,1,1,null,1,0,0,0,null,0,0,0,0,0,null,null,null,1,0,null,null,null,1,0,null,null,null,1,0,null,null,null,1,0,null,null,null,null,1,0,null,null,null,null,1,0,0,0,0,null,null,null,null,1,null,1,null,1,null,null,1,null,1,null,1,1,null,1,0,0,0,0,0,0,0,0,0,null,null,0,0,0,null,null,null,1,0,0,null,0,null,null,null,1,0,null,null,null,1,null,null,0,null,1,null,null,null,1,0,null,1,null,1,0,null,0,0,null,null,0,0,null,null,null,0,null,null,null,1,0,null,null,null,1,0,null,null,null,1,0,null,0,null,null,0,null,null,1,0,null,null,1,0,null,0,null,null,1,0,null,null,1,0,0,null,null,null,1,0,null,null,null,1,0,null,null,1,0,null,null,1,0,null,null,1,0,null,null,null,null,1,0,null,null,null,null,1,0,null,null,null,1,0,null,null,null,1,0,null,null,null,null,1,0,null,0,0,0,0,0,0,null,null,null,null,null,null,null,1,0,null,null,1,0,null,null,1,null,null,null,1,0,0,null,null,null,null]},"./lib/coverband/utils/lines_classifier.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"0edac53af03ce933e33845345200e4db","data":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,1,1,1,1,1,null,1,1,1,null,1,0,null,null,1,0,null,null,0,null,null,1,0,null,null,0,null,null,1,0,null,0,0,0,0,0,0,null,0,null,null,null,null,null,null]},"./lib/coverband/utils/results.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"081416e6d4a6a505e75ad15e6d574a07","data":[null,null,null,null,null,1,1,1,1,null,1,0,0,0,null,null,1,0,null,0,0,0,null,0,null,null,1,0,null,0,0,null,0,null,0,null,0,0,null,null,1,0,null,0,0,null,0,null,0,null,0,null,null,1,0,null,0,0,0,null,0,null,null,1,0,0,null,0,null,null,null,1,0,null,null,null,1,0,null,null,1,0,null,null,1,0,null,null,1,null,1,0,null,null,1,0,null,null,1,0,null,null,1,0,null,null,null,null,null,null,null,1,0,null,0,null,null,null,null]},"./lib/coverband/reporters/html_report.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"1eb64bf06752d4a576109af8bcec6c69","data":[null,null,1,1,1,1,null,null,1,0,0,null,0,0,0,null,0,null,0,0,null,0,null,null,null,1,0,null,null,null,null,1,0,null,null,1,0,null,null,1,null,1,0,null,null,null,null,null,1,0,null,null,null,null,null,null,null]},"./lib/coverband/reporters/json_report.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"4c3d2aa6266411fd5aa23a2e87f4c8cf","data":[null,null,null,null,1,1,1,1,null,null,1,0,0,0,0,0,0,0,0,null,0,null,0,0,null,0,null,null,null,1,0,null,null,1,0,0,null,null,null,null,null,0,0,null,null,null,null,null,null,0,0,null,null,null,null,null,null,0,null,null,1,null,1,0,0,0,0,0,0,null,0,null,null,null,1,0,null,0,0,null,0,null,null,null,null,0,0,0,0,0,0,null,0,0,0,null,null,null,null,0,null,null,null,null,null,null,0,0,0,0,0,0,null,0,null,null,1,null,0,null,null,null,null,null,null,null,null,null,1,0,0,null,0,null,null,null,null,null,null,null,null,null,null,0,0,null,null,null,null,null]},"./test/unique_files.rb":{"first_updated_at":1768697779,"last_updated_at":1768697779,"file_hash":"80447d67747af66d3792f3f9ec0be166","data":[null,null,1,1,1,null,1,null,1,0,0,0,0,0,0,0,null,0,0,0,null,0,0,0,null,null,1,0,0,0,null,null,1,0,null,null,1,1,0,null,null]}}

data/coverband.gemspec

@@ -31,6 +31,7 @@ Gem::Specification.new do |spec|
   }
 
   spec.add_development_dependency "benchmark-ips"
+  spec.add_development_dependency "benchmark" # Ruby 4.0+ requires explicit dependency
   spec.add_development_dependency "capybara"
   spec.add_development_dependency "m"
   spec.add_development_dependency "memory_profiler"
@@ -38,7 +39,7 @@ Gem::Specification.new do |spec|
   # note: we are also adding 'spy' as mocha doesn't want us to spy on redis calls...
   spec.add_development_dependency "spy"
   # ^^^ probably need a large test cleanup refactor
-  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest", "~> 5.0"
   spec.add_development_dependency "minitest-fork_executor"
   spec.add_development_dependency "minitest-stub-const"
   spec.add_development_dependency "mocha"
@@ -55,6 +56,7 @@ Gem::Specification.new do |spec|
   # spec.add_development_dependency "minitest-profile"
   spec.add_development_dependency "webmock"
   spec.add_development_dependency "dalli" # Default memcached adapter
+  spec.add_development_dependency "mcp" # For MCP server support testing
 
   # TODO: Remove when other production adapters exist
   # because the default configuration of redis store, we really do require

data/lib/coverband/collectors/route_tracker.rb

@@ -13,7 +13,7 @@ module Coverband
       TITLE = "Routes"
 
       def initialize(options = {})
-        if Rails&.respond_to?(:version) && Gem::Version.new(Rails.version) < Gem::Version.new("7.1.0")
+        if defined?(Rails) && Rails.respond_to?(:version) && Gem::Version.new(Rails.version) < Gem::Version.new("7.1.0")
           require_relative "../utils/rails6_ext"
         end
 

data/lib/coverband/collectors/view_tracker.rb

@@ -64,23 +64,14 @@ module Coverband
         views = redis_store.hgetall(tracker_key)
         normalized_views = {}
         views.each_pair do |view, time|
-          roots.each do |root|
-            view = view.gsub(root, "")
-          end
-          normalized_views[view] = time
+          normalized_view = normalize_path(view)
+          normalized_views[normalized_view] = time
         end
         normalized_views
       end
 
       def all_keys
-        all_views = []
-        target.each do |view|
-          roots.each do |root|
-            view = view.gsub(root, "")
-          end
-          all_views << view
-        end
-        all_views.uniq
+        target.map { |view| normalize_path(view) }.uniq
       end
 
       def unused_keys(used_views = nil)
@@ -106,9 +97,26 @@ module Coverband
           @ignore_patterns.none? { |pattern| file.match?(pattern) }
       end
 
+      def normalize_path(view)
+        normalized = view.dup
+        original_length = normalized.length
+
+        roots.each do |root|
+          normalized = normalized.gsub(root, "")
+        end
+
+        # Only remove leading slash if we actually modified the path by removing a root
+        # This ensures consistent relative paths after root removal
+        if normalized.length < original_length
+          normalized.sub(/^\//, "")
+        else
+          normalized
+        end
+      end
+
       def concrete_target
         if defined?(Rails.application)
-          Dir.glob("#{@project_directory}/**/app/{views,components}/**/*.html.{erb,haml,slim}")
+          Dir.glob("#{@project_directory}/{,packs,engines/*}/app/{views,components}/**/*.html.{erb,haml,slim}")
         else
           []
         end

data/lib/coverband/configuration.rb

@@ -14,13 +14,14 @@ module Coverband
       :view_tracker, :defer_eager_loading_data,
       :track_routes, :track_redirect_routes, :route_tracker,
       :track_translations, :translations_tracker,
-      :trackers, :csp_policy, :hide_settings
+      :trackers, :csp_policy, :hide_settings,
+      :mcp_enabled
 
     attr_writer :logger, :s3_region, :s3_bucket, :s3_access_key_id,
       :s3_secret_access_key, :password, :api_key, :service_url, :coverband_timeout, :service_dev_mode,
       :service_test_mode, :process_type, :track_views, :redis_url,
       :background_reporting_sleep_seconds, :reporting_wiggle,
-      :send_deferred_eager_loading_data, :paged_reporting
+      :send_deferred_eager_loading_data, :paged_reporting, :mcp_allowed_environments, :mcp_password
 
     attr_reader :track_gems, :ignore
 
@@ -31,19 +32,19 @@ module Coverband
     # * Perhaps detect heroku deployment ENV var opposed to tasks?
     #####
     IGNORE_TASKS = ["coverband:clear",
-                    "coverband:coverage",
-                    "coverband:coverage_server",
-                    "assets:precompile",
-                    "webpacker:compile",
-                    "db:version",
-                    "db:create",
-                    "db:drop",
-                    "db:seed",
-                    "db:setup",
-                    "db:test:prepare",
-                    "db:structure:dump",
-                    "db:structure:load",
-                    "db:version"]
+      "coverband:coverage",
+      "coverband:coverage_server",
+      "assets:precompile",
+      "webpacker:compile",
+      "db:version",
+      "db:create",
+      "db:drop",
+      "db:seed",
+      "db:setup",
+      "db:test:prepare",
+      "db:structure:dump",
+      "db:structure:load",
+      "db:version"]
 
     # Heroku when building assets runs code from a dynamic directory
     # /tmp was added to avoid coverage from /tmp/build directories during
@@ -91,6 +92,11 @@ module Coverband
       @csp_policy = false
       @hide_settings = false
 
+      # MCP (Model Context Protocol) security settings
+      @mcp_enabled = false
+      @mcp_password = nil
+      @mcp_allowed_environments = %w[development test]
+
       # coverband service settings
       @api_key = nil
       @service_url = nil
@@ -144,14 +150,40 @@ module Coverband
       @logger ||= if defined?(Rails.logger) && Rails.logger
         Rails.logger
       else
-        Logger.new(STDOUT)
+        Logger.new($stdout)
       end
     end
 
+    # Alias for backward compatibility - track_key uses :routes_tracker symbol
+    def routes_tracker
+      route_tracker
+    end
+
     def password
       @password || ENV["COVERBAND_PASSWORD"]
     end
 
+    def mcp_enabled?
+      # MCP is disabled by default and explicitly controlled
+      return false unless @mcp_enabled
+
+      # Check if current environment is allowed
+      current_env = (defined?(Rails) && Rails.respond_to?(:env) && Rails.env) ||
+        ENV["RAILS_ENV"] ||
+        ENV["RACK_ENV"] ||
+        "development"
+
+      mcp_allowed_environments.include?(current_env.to_s)
+    end
+
+    def mcp_password
+      @mcp_password || ENV["COVERBAND_MCP_PASSWORD"]
+    end
+
+    def mcp_allowed_environments
+      @mcp_allowed_environments || %w[development test]
+    end
+
     # The adjustments here either protect the redis or service from being overloaded
     # the tradeoff being the delay in when reporting data is available
     # if running your own redis increasing this number reduces load on the redis CPU
@@ -180,7 +212,14 @@ module Coverband
         require "coverband/adapters/web_service_store"
         Coverband::Adapters::WebServiceStore.new(service_url)
       else
-        Coverband::Adapters::RedisStore.new(Redis.new(url: redis_url), redis_store_options)
+        begin
+          Coverband::Adapters::RedisStore.new(Redis.new(url: redis_url), redis_store_options)
+        rescue Redis::CannotConnectError => error
+          logger.info "Redis is not available (#{error}), defaulting to NullStore"
+          logger.info "If this is intended, please explicitly configure your store: config.store = Coverband::Adapters::FileStore.new('log/coverage')"
+          require "coverband/adapters/null_store"
+          Coverband::Adapters::NullStore.new
+        end
       end
     end
 
@@ -242,7 +281,7 @@ module Coverband
       @all_root_patterns ||= all_root_paths.map { |path| /^#{path}/ }.freeze
     end
 
-    SKIPPED_SETTINGS = %w[@s3_secret_access_key @store @api_key @password]
+    SKIPPED_SETTINGS = %w[@s3_secret_access_key @store @api_key @password @mcp_password]
     def to_h
       instance_variables
         .each_with_object({}) do |var, hash|