ask-rails-harness 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b7c1f9342c45ef3d4472772717fcc6ff302b35999e74806bd8964510f729f2f
-  data.tar.gz: 017c0f1b89629f435bde77c637c96e866caffb3be86f27d99adcf6431cc79cb3
+  metadata.gz: 70e5e797b91144992c18866c357d73811226b3281955a208437eed7ae02b0b63
+  data.tar.gz: c110d660dbd193597f1bfcbae2ea5b3184f676984d4e9dc1ce9401df899d36e4
 SHA512:
-  metadata.gz: 4a3c0d99ae4b7f7725365827e4707fc56ca680bcee0fe7d0617c03bc7aa4e8c14039ee858016ad867648e4c5dec545acaec1b1b7934f6b3ed20d72d6a9d122db
-  data.tar.gz: 0b9c8b0b65b3baab555bde4c7e938c447b6b0527ea073a0abc3f9179d3ce8836e4f49221b601b20fd95446d33b40571f49f61bc25380baeba2cfe162a087b7bc
+  metadata.gz: ce9d990603fed30ed9bdf9ee20cd3087694dc7739f3751d03343f9f4d0b6a957bd9b8ba7b7146a58a45c002ef8931d26766548ed3e50aed2233acbfe16595746
+  data.tar.gz: 353fbc3c92ba503b3d6bb9732d9030c4d967279584814810768c32556b98c6584eaa5465b33eef3e0e00425f163e5a6466136aa040d8bb0342847a068c6a4959

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.3.0] — 2026-08-10
+
+### Removed
+
+- **`ReadFile`, `SearchCodebase`, `ReadRoutes` tools removed** — generic
+  file-read and grep capabilities that coding agents provide natively.
+  `RouteInspector` fully supersedes `ReadRoutes` (parsed table vs raw file,
+  including `draw`-split and engine routes). The harness now ships only
+  Rails-aware tools: `QueryDatabase`, `ReadModel`, `ReadLog`, `RunCommand`,
+  `SchemaGraph`, `RouteInspector`, `RunTests`. Skills updated to use the
+  shell `Read` tool and `RouteInspector`.
+
 ## [0.2.1] — 2026-08-10
 
 ### Fixed

data/README.md

@@ -68,15 +68,18 @@ Available settings: `default_model`, `max_turns`, `tool_concurrency`, `system_pr
 
 | Tool | What it does |
 |---|---|
-| `ReadFile` | Read any file relative to `Rails.root` |
 | `QueryDatabase` | Read-only SQL (non-SELECT rejected in production) |
 | `ReadModel` | Inspect an ActiveRecord model's columns, associations, validations |
-| `ReadRoutes` | Read `config/routes.rb` |
 | `ReadLog` | Read log files with level/search filtering |
-| `RunCommand` | Run shell commands in the app root |
-| `SearchCodebase` | Grep the codebase |
+| `RunCommand` | Run shell commands in the app root, gated by permission rules |
 | `SchemaGraph` | Full schema introspection: models, tables, columns, associations |
 | `RouteInspector` | Parsed route table with filters |
+| `RunTests` | Structured test results with failure reruns (minitest/rspec) |
+
+Generic file and search capabilities (read, grep, edit) are provided by the
+agent's native tools; the harness focuses on what only a Rails-aware layer
+can give an agent: database access, schema/model introspection, routes,
+logs, and tests — all permission-gated and audited.
 
 ## Full documentation
 

data/lib/ask/rails/harness/version.rb

@@ -3,7 +3,7 @@
 module Ask
   module Rails
     module Harness
-      VERSION = "0.2.1"
+      VERSION = "0.3.0"
     end
   end
 end

data/lib/ask/rails/harness.rb

@@ -165,10 +165,7 @@ require_relative "harness/auth"
 require_relative "harness/persistence"
 require_relative "harness/service_discovery"
 require_relative "harness/tool"
-require_relative "harness/tools/read_file"
 require_relative "harness/tools/run_command"
-require_relative "harness/tools/search_codebase"
-require_relative "harness/tools/read_routes"
 require_relative "harness/tools/query_database"
 require_relative "harness/tools/read_model"
 require_relative "harness/tools/read_log"
@@ -184,8 +181,7 @@ end
 
 # Define after all tool files are loaded so the constants resolve
 Ask::Rails::Harness::CORE_RAILS_TOOLS = [
-  Ask::Rails::Harness::Tools::ReadFile, Ask::Rails::Harness::Tools::RunCommand,
-  Ask::Rails::Harness::Tools::SearchCodebase, Ask::Rails::Harness::Tools::ReadRoutes,
+  Ask::Rails::Harness::Tools::RunCommand,
   Ask::Rails::Harness::Tools::QueryDatabase, Ask::Rails::Harness::Tools::ReadModel,
   Ask::Rails::Harness::Tools::ReadLog, Ask::Rails::Harness::Tools::SchemaGraph,
   Ask::Rails::Harness::Tools::RouteInspector, Ask::Rails::Harness::Tools::RunTests

data/lib/ask/skills/rails.deploy_pipeline/SKILL.md

@@ -15,7 +15,7 @@ RunCommand.new.call(command: "bin/rails db:migrate:status | grep 'down'")
 ```
 
 If there are pending migrations:
-1. Review them with `ReadFile.new.call(path: "db/migrate/<TIMESTAMP>_migration_name.rb")`
+1. Review them with `Read.new.call(path: Rails.root.join("db/migrate/<TIMESTAMP>_migration_name.rb").to_s)`
 2. Verify they're reversible: check `change`, `up`/`down`, or `reversible` blocks
 3. Check for data migrations (e.g., backfills) that should run separately
 4. Estimate execution time — large tables may need locking strategy
@@ -38,8 +38,8 @@ For importmap or esbuild/vite setups:
 
 ```ruby
 # Check build config
-ReadFile.new.call(path: "package.json")
-ReadFile.new.call(path: "vite.config.ts") if File.exist?("Rails.root.join('vite.config.ts')")
+Read.new.call(path: Rails.root.join("package.json").to_s)
+Read.new.call(path: Rails.root.join("vite.config.ts").to_s) if Rails.root.join("vite.config.ts").exist?
 ```
 
 ## Step 3: Review Credentials and Secrets
@@ -70,7 +70,7 @@ Glob.new.call(pattern: "app/jobs/**/*.rb")
 For any new or modified jobs:
 1. Verify the queue adapter is configured in `production.rb`
 2. Check for job retry logic that might affect rollback
-3. Review `ReadFile.new.call(path: "config/sidekiq.yml")` if using Sidekiq
+3. Review `Read.new.call(path: Rails.root.join("config/sidekiq.yml").to_s)` if using Sidekiq
 4. Verify scheduled/cron jobs if using `sidekiq-cron` or `whenever`
 
 ## Step 5: Review Production Log for Pre-deploy Issues
@@ -102,10 +102,10 @@ RunCommand.new.call(command: "bundle platform")
 Verify configuration files for the target environment:
 
 ```ruby
-ReadFile.new.call(path: "config/environments/production.rb")
-ReadFile.new.call(path: "config/database.yml")
-ReadFile.new.call(path: "config/cable.yml") if File.exist?("config/cable.yml")
-ReadFile.new.call(path: "config/storage.yml") if File.exist?("config/storage.yml")
+Read.new.call(path: Rails.root.join("config/environments/production.rb").to_s)
+Read.new.call(path: Rails.root.join("config/database.yml").to_s)
+Read.new.call(path: Rails.root.join("config/cable.yml").to_s) if Rails.root.join("config/cable.yml").exist?
+Read.new.call(path: Rails.root.join("config/storage.yml").to_s) if Rails.root.join("config/storage.yml").exist?
 ```
 
 Key production checks:

data/lib/ask/skills/rails.route_trouble/SKILL.md

@@ -6,15 +6,17 @@ description: Step-by-step methodology for debugging routing issues in Rails
 Use this skill when a route is returning 404, you're getting route matching errors,
 or routes aren't behaving as expected in a Rails application.
 
-## Step 1: Read the Routes File
+## Step 1: Inspect the Route Table
 
-Start by examining the routes configuration:
+Start by examining the parsed route table:
 
 ```ruby
-ReadRoutes.new.call
+RouteInspector.new.call
 ```
 
-This reads `config/routes.rb` — the source of truth for all route definitions.
+This returns every route with its verb, path, controller, action, and name —
+covering routes split across `draw` files and engines that a raw read of
+`config/routes.rb` would miss.
 
 Look for:
 - The overall structure (namespaced, nested, shallow routes?)
@@ -82,7 +84,7 @@ error message tells you what routes were tried before failing.
 If the route exists but the controller isn't found:
 
 ```ruby
-ReadFile.new.call(path: "app/controllers/users_controller.rb")
+Read.new.call(path: Rails.root.join("app/controllers/users_controller.rb").to_s)
 ```
 
 ## Step 5: Check Namespace and Module Nesting

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-rails-harness
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -135,10 +135,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: Rails Engine that mounts an admin AI agent at /ask. Ships 9 Rails-aware
-  tools (ReadFile, QueryDatabase, ReadModel, ReadRoutes, RouteInspector, ReadLog,
-  RunCommand, SearchCodebase, SchemaGraph), session persistence, audit logging, environment
-  permissions, and service gem discovery. Previously developed as ask-rails (0.1.0–0.11.1).
+description: Rails Engine that mounts an admin AI agent at /ask. Ships Rails-aware
+  tools (QueryDatabase, ReadModel, ReadLog, RunCommand, SchemaGraph, RouteInspector,
+  RunTests), session persistence, audit logging, environment permissions, and service
+  gem discovery. Previously developed as ask-rails (0.1.0–0.11.1).
 email:
 - kaka@myrrlabs.com
 executables: []
@@ -166,15 +166,12 @@ files:
 - lib/ask/rails/harness/service_discovery.rb
 - lib/ask/rails/harness/tool.rb
 - lib/ask/rails/harness/tools/query_database.rb
-- lib/ask/rails/harness/tools/read_file.rb
 - lib/ask/rails/harness/tools/read_log.rb
 - lib/ask/rails/harness/tools/read_model.rb
-- lib/ask/rails/harness/tools/read_routes.rb
 - lib/ask/rails/harness/tools/route_inspector.rb
 - lib/ask/rails/harness/tools/run_command.rb
 - lib/ask/rails/harness/tools/run_tests.rb
 - lib/ask/rails/harness/tools/schema_graph.rb
-- lib/ask/rails/harness/tools/search_codebase.rb
 - lib/ask/rails/harness/version.rb
 - lib/ask/skills/rails.db_debug/SKILL.md
 - lib/ask/skills/rails.deploy_pipeline/SKILL.md

data/lib/ask/rails/harness/tools/read_file.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Ask
-  module Rails
-    module Harness
-      module Tools
-        class ReadFile < Ask::Rails::Harness::Tool
-          description "Read a file from the Rails app. Paths are relative to Rails.root."
-
-          param :path, type: :string, desc: "Relative path from Rails.root", required: true
-
-          def execute(path:)
-            full_path = rails_root.join(path)
-            return Ask::Result.error(message: "File not found: #{path}") unless full_path.exist?
-
-            content = full_path.read
-            { path: path, content: content, size: content.length }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ask/rails/harness/tools/read_routes.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module Ask
-  module Rails
-    module Harness
-      module Tools
-        class ReadRoutes < Ask::Rails::Harness::Tool
-          description "Read the Rails routes from config/routes.rb"
-          def execute
-            routes_file = rails_root.join("config", "routes.rb")
-            return Ask::Result.error(message: "No routes file found") unless routes_file.exist?
-
-            content = routes_file.read
-            { content: content, size: content.length }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ask/rails/harness/tools/search_codebase.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Ask
-  module Rails
-    module Harness
-      module Tools
-        class SearchCodebase < Ask::Rails::Harness::Tool
-          description "Search the Rails codebase with grep."
-          param :pattern, type: :string, desc: "Search pattern", required: true
-          param :path, type: :string, desc: "Subdirectory to search (optional)", required: false
-
-          def execute(pattern:, path: nil)
-            search_path = (path ? rails_root.join(path) : rails_root).to_s
-            escaped_pattern = pattern.gsub("'", "'\\\\''")
-            escaped_path = search_path.gsub("'", "'\\\\''")
-            results = `cd #{rails_root} && grep -rn '#{escaped_pattern}' #{escaped_path} 2>&1 | head -50`
-            { results: results.lines.map(&:chomp), count: results.lines.count }
-          end
-        end
-      end
-    end
-  end
-end