coatepec 0.6.0 → 0.8.0

data/lib/coatepec/test_unit/line_filtering.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Coatepec
+  module TestUnit
+    # Makes `file:LINE` selectors work regardless of the target app's Rails/
+    # Minitest pairing. Rails installs its own Rails::LineFiltering only via
+    # Rails::TestUnitRailtie, which an app generated with --skip-test never
+    # loads; and Rails 7.1's version overrides `run`, a method Minitest 6 no
+    # longer calls (it dispatches through `run_suite` and reads
+    # options[:include], not options[:filter]). So the child always extends
+    # ActiveSupport::TestCase with the one method the *running* Minitest
+    # actually calls, composing Rails::TestUnit::Runner's recorded line
+    # filters through Rails' public compose_filter. Stacking on top of
+    # Rails' own module is idempotent: CompositeFilter#derive_named_filter
+    # unwraps an existing composite via #named_filter.
+    #
+    # Exactly one method per module, never both: on Minitest 6 a class-level
+    # `run` override intercepts an unrelated 3-argument call and raises.
+    module LineFiltering
+      MT6 = Module.new do
+        def run_suite(reporter, options = {})
+          options = options.merge(include: ::Rails::TestUnit::Runner.compose_filter(self, options[:include]))
+          super(reporter, options)
+        end
+      end
+
+      MT5 = Module.new do
+        def run(reporter, options = {})
+          options = options.merge(filter: ::Rails::TestUnit::Runner.compose_filter(self, options[:filter]))
+          super(reporter, options)
+        end
+      end
+
+      def self.module_for(minitest_version)
+        minitest_version.start_with?("6") ? MT6 : MT5
+      end
+
+      # Ruby ignores a second `extend` of a module already in the singleton
+      # ancestors, so calling this more than once per process is harmless.
+      def self.install!
+        require "rails/test_unit/runner"
+        ::ActiveSupport::TestCase.extend(module_for(::Minitest::VERSION))
+      end
+    end
+  end
+end

data/lib/coatepec/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Coatepec
-  VERSION = "0.6.0"
+  VERSION = "0.8.0"
 end

data/lib/coatepec/worker/server.rb

@@ -45,6 +45,7 @@ module Coatepec
         when "flaky_check" then handle_flaky_check(args)
         when "routes" then handle_routes(args)
         when "model" then handle_model(args)
+        when "controller" then handle_controller(args)
         else
           raise Coatepec::Error.new(:internal_error, "Unknown command #{command}")
         end
@@ -63,7 +64,12 @@ module Coatepec
       end
 
       def handle_model(args)
-        Introspection::Model.new(args.transform_keys(&:to_sym)[:name]).call
+        a = args.transform_keys(&:to_sym)
+        Introspection::Model.new(a[:name], fields: a[:fields]).call
+      end
+
+      def handle_controller(args)
+        Introspection::Controller.new(args.transform_keys(&:to_sym)[:name]).call
       end
     end
   end

data/lib/coatepec/worker_manager.rb

@@ -20,10 +20,12 @@ module Coatepec
       dispatch("status", {}, timeout: 30)
     end
 
-    def run_spec(paths:, example:, seed:, fail_fast:, timeout_seconds:)
+    def run_spec(paths:, example:, seed:, fail_fast:, timeout_seconds:, include_passing: false,
+                 include_stdout: "failures")
       dispatch(
         "spec_run",
-        { paths: paths, example: example, seed: seed, fail_fast: fail_fast, timeout_seconds: timeout_seconds },
+        { paths: paths, example: example, seed: seed, fail_fast: fail_fast, timeout_seconds: timeout_seconds,
+          include_passing: include_passing, include_stdout: include_stdout },
         timeout: timeout_seconds + 10
       )
     end
@@ -40,12 +42,16 @@ module Coatepec
       )
     end
 
-    def routes(query: nil, limit: 50, offset: 0)
-      dispatch("routes", { query: query, limit: limit, offset: offset }, timeout: 30)
+    def routes(query: nil, limit: 100, offset: 0, engines: Introspection::Routes::DEFAULT_ENGINES)
+      dispatch("routes", { query: query, limit: limit, offset: offset, engines: engines }, timeout: 30)
     end
 
-    def model(name:)
-      dispatch("model", { name: name }, timeout: 30)
+    def model(name:, fields: nil)
+      dispatch("model", { name: name, fields: fields }, timeout: 30)
+    end
+
+    def controller(name:)
+      dispatch("controller", { name: name }, timeout: 30)
     end
 
     def stop

data/lib/coatepec.rb

@@ -11,8 +11,14 @@ require_relative "coatepec/worker/client"
 require_relative "coatepec/worker/rails_runtime"
 require_relative "coatepec/introspection/routes"
 require_relative "coatepec/introspection/safe_options"
+require_relative "coatepec/introspection/bounded_options"
+require_relative "coatepec/introspection/model_resolver"
 require_relative "coatepec/introspection/model"
+require_relative "coatepec/introspection/controller"
+require_relative "coatepec/spec/failure_collapser"
 require_relative "coatepec/spec/result"
+require_relative "coatepec/spec/rspec_adapter"
+require_relative "coatepec/test_unit/adapter"
 require_relative "coatepec/spec/process_strategy"
 require_relative "coatepec/spec/fork_strategy"
 require_relative "coatepec/spec/spawn_strategy"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: coatepec
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Enrique Mogollan
 bindir: exe
 cert_chain: []
-date: 2026-08-20 00:00:00.000000000 Z
+date: 2026-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -44,8 +44,9 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 description: Coatepec is a local stdio MCP sidecar that keeps an isolated Rails test
-  worker warm so coding agents can run targeted RSpec examples quickly, without exposing
-  a general Rails console.
+  worker warm so coding agents can run targeted RSpec examples quickly, check specs
+  for flakiness, and read routes, models, and controllers through structured read-only
+  Rails APIs -- without exposing a general Rails console.
 email:
 - emogollan@gmail.com
 executables:
@@ -59,13 +60,18 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- ROADMAP.md
 - Rakefile
 - exe/coatepec
 - exe/coatepec-worker
 - lib/coatepec.rb
 - lib/coatepec/cli.rb
 - lib/coatepec/errors.rb
+- lib/coatepec/introspection/bounded_options.rb
+- lib/coatepec/introspection/controller.rb
 - lib/coatepec/introspection/model.rb
+- lib/coatepec/introspection/model_resolver.rb
+- lib/coatepec/introspection/route_entries.rb
 - lib/coatepec/introspection/routes.rb
 - lib/coatepec/introspection/safe_options.rb
 - lib/coatepec/mcp.rb
@@ -74,14 +80,20 @@ files:
 - lib/coatepec/project.rb
 - lib/coatepec/project_config.rb
 - lib/coatepec/protocol.rb
+- lib/coatepec/spec/failure_collapser.rb
 - lib/coatepec/spec/flaky_checker.rb
 - lib/coatepec/spec/fork_strategy.rb
 - lib/coatepec/spec/guarded_fork_strategy.rb
 - lib/coatepec/spec/path_policy.rb
 - lib/coatepec/spec/process_strategy.rb
 - lib/coatepec/spec/result.rb
+- lib/coatepec/spec/rspec_adapter.rb
 - lib/coatepec/spec/runner.rb
 - lib/coatepec/spec/spawn_strategy.rb
+- lib/coatepec/test_unit/adapter.rb
+- lib/coatepec/test_unit/child_entry.rb
+- lib/coatepec/test_unit/json_reporter.rb
+- lib/coatepec/test_unit/line_filtering.rb
 - lib/coatepec/version.rb
 - lib/coatepec/worker/change_detector.rb
 - lib/coatepec/worker/client.rb
@@ -113,5 +125,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.6
 specification_version: 4
-summary: Run targeted RSpec examples against a warm Rails test worker over MCP
+summary: Run targeted RSpec examples and introspect Rails structure over MCP, without
+  a Rails console
 test_files: []