simplecov-mcp 0.3.0 → 1.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simplecov-mcp
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Keith R. Bennett
@@ -13,64 +13,36 @@ dependencies:
   name: mcp
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.3'
 - !ruby/object:Gem::Dependency
-  name: awesome_print
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.2
+        version: '0.21'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.9.2
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0.21'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.21'
+        version: '1.0'
 description: Provides an MCP (Model Context Protocol) server and a CLI to inspect
   SimpleCov coverage, including per-file summaries and uncovered lines.
 email:
@@ -80,59 +52,144 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
 - README.md
+- docs/ADVANCED_USAGE.md
+- docs/ARCHITECTURE.md
+- docs/BRANCH_ONLY_COVERAGE.md
+- docs/CLI_USAGE.md
+- docs/DEVELOPMENT.md
+- docs/ERROR_HANDLING.md
+- docs/EXAMPLES.md
+- docs/INSTALLATION.md
+- docs/LIBRARY_API.md
+- docs/MCP_INTEGRATION.md
+- docs/TROUBLESHOOTING.md
+- docs/arch-decisions/001-x-arch-decision.md
+- docs/arch-decisions/002-x-arch-decision.md
+- docs/arch-decisions/003-x-arch-decision.md
+- docs/arch-decisions/004-x-arch-decision.md
+- docs/arch-decisions/005-x-arch-decision.md
+- docs/arch-decisions/README.md
+- docs/presentations/simplecov-mcp-presentation.md
 - exe/simplecov-mcp
-- lib/simple_cov/mcp.rb
-- lib/simple_cov_mcp.rb
-- lib/simple_cov_mcp/base_tool.rb
-- lib/simple_cov_mcp/cli.rb
-- lib/simple_cov_mcp/error_handler.rb
-- lib/simple_cov_mcp/error_handler_factory.rb
-- lib/simple_cov_mcp/errors.rb
-- lib/simple_cov_mcp/mcp_server.rb
-- lib/simple_cov_mcp/model.rb
-- lib/simple_cov_mcp/staleness_checker.rb
-- lib/simple_cov_mcp/tools/all_files_coverage_tool.rb
-- lib/simple_cov_mcp/tools/coverage_detailed_tool.rb
-- lib/simple_cov_mcp/tools/coverage_raw_tool.rb
-- lib/simple_cov_mcp/tools/coverage_summary_tool.rb
-- lib/simple_cov_mcp/tools/coverage_table_tool.rb
-- lib/simple_cov_mcp/tools/help_tool.rb
-- lib/simple_cov_mcp/tools/uncovered_lines_tool.rb
-- lib/simple_cov_mcp/tools/version_tool.rb
-- lib/simple_cov_mcp/util.rb
-- lib/simple_cov_mcp/version.rb
 - lib/simplecov_mcp.rb
+- lib/simplecov_mcp/app_context.rb
+- lib/simplecov_mcp/base_tool.rb
+- lib/simplecov_mcp/cli.rb
+- lib/simplecov_mcp/cli_config.rb
+- lib/simplecov_mcp/commands/base_command.rb
+- lib/simplecov_mcp/commands/command_factory.rb
+- lib/simplecov_mcp/commands/detailed_command.rb
+- lib/simplecov_mcp/commands/list_command.rb
+- lib/simplecov_mcp/commands/raw_command.rb
+- lib/simplecov_mcp/commands/summary_command.rb
+- lib/simplecov_mcp/commands/uncovered_command.rb
+- lib/simplecov_mcp/commands/version_command.rb
+- lib/simplecov_mcp/constants.rb
+- lib/simplecov_mcp/error_handler.rb
+- lib/simplecov_mcp/error_handler_factory.rb
+- lib/simplecov_mcp/errors.rb
+- lib/simplecov_mcp/formatters/source_formatter.rb
+- lib/simplecov_mcp/mcp_server.rb
+- lib/simplecov_mcp/mode_detector.rb
+- lib/simplecov_mcp/model.rb
+- lib/simplecov_mcp/option_normalizers.rb
+- lib/simplecov_mcp/option_parser_builder.rb
+- lib/simplecov_mcp/option_parsers/env_options_parser.rb
+- lib/simplecov_mcp/option_parsers/error_helper.rb
+- lib/simplecov_mcp/path_relativizer.rb
+- lib/simplecov_mcp/presenters/base_coverage_presenter.rb
+- lib/simplecov_mcp/presenters/coverage_detailed_presenter.rb
+- lib/simplecov_mcp/presenters/coverage_raw_presenter.rb
+- lib/simplecov_mcp/presenters/coverage_summary_presenter.rb
+- lib/simplecov_mcp/presenters/coverage_uncovered_presenter.rb
+- lib/simplecov_mcp/presenters/project_coverage_presenter.rb
+- lib/simplecov_mcp/resolvers/coverage_line_resolver.rb
+- lib/simplecov_mcp/resolvers/resolver_factory.rb
+- lib/simplecov_mcp/resolvers/resultset_path_resolver.rb
+- lib/simplecov_mcp/resultset_loader.rb
+- lib/simplecov_mcp/staleness_checker.rb
+- lib/simplecov_mcp/tools/all_files_coverage_tool.rb
+- lib/simplecov_mcp/tools/coverage_detailed_tool.rb
+- lib/simplecov_mcp/tools/coverage_raw_tool.rb
+- lib/simplecov_mcp/tools/coverage_summary_tool.rb
+- lib/simplecov_mcp/tools/coverage_table_tool.rb
+- lib/simplecov_mcp/tools/help_tool.rb
+- lib/simplecov_mcp/tools/uncovered_lines_tool.rb
+- lib/simplecov_mcp/tools/version_tool.rb
+- lib/simplecov_mcp/util.rb
+- lib/simplecov_mcp/version.rb
+- spec/MCP_INTEGRATION_TESTS_README.md
+- spec/TIMESTAMPS.md
 - spec/all_files_coverage_tool_spec.rb
 - spec/base_tool_spec.rb
+- spec/cli/show_default_report_spec.rb
+- spec/cli_config_spec.rb
+- spec/cli_enumerated_options_spec.rb
 - spec/cli_error_spec.rb
 - spec/cli_source_spec.rb
 - spec/cli_spec.rb
+- spec/cli_success_predicate_spec.rb
 - spec/cli_table_spec.rb
 - spec/cli_usage_spec.rb
-- spec/coverage_detailed_tool_spec.rb
-- spec/coverage_raw_tool_spec.rb
-- spec/coverage_summary_tool_spec.rb
+- spec/commands/base_command_spec.rb
+- spec/commands/command_factory_spec.rb
+- spec/commands/detailed_command_spec.rb
+- spec/commands/raw_command_spec.rb
+- spec/commands/summary_command_spec.rb
+- spec/commands/uncovered_command_spec.rb
+- spec/constants_spec.rb
 - spec/coverage_table_tool_spec.rb
 - spec/error_handler_spec.rb
+- spec/error_mode_spec.rb
+- spec/errors_edge_cases_spec.rb
 - spec/errors_stale_spec.rb
+- spec/file_based_mcp_tools_spec.rb
 - spec/fixtures/project1/lib/bar.rb
 - spec/fixtures/project1/lib/foo.rb
 - spec/help_tool_spec.rb
-- spec/legacy_shim_spec.rb
+- spec/integration_spec.rb
+- spec/logging_fallback_spec.rb
+- spec/mcp_logging_spec.rb
+- spec/mcp_server_integration_spec.rb
 - spec/mcp_server_spec.rb
+- spec/mode_detector_spec.rb
+- spec/model_error_handling_spec.rb
 - spec/model_staleness_spec.rb
+- spec/option_normalizers_spec.rb
+- spec/option_parsers/env_options_parser_spec.rb
+- spec/option_parsers/error_helper_spec.rb
+- spec/path_relativizer_spec.rb
+- spec/presenters/coverage_detailed_presenter_spec.rb
+- spec/presenters/coverage_raw_presenter_spec.rb
+- spec/presenters/coverage_summary_presenter_spec.rb
+- spec/presenters/coverage_uncovered_presenter_spec.rb
+- spec/presenters/project_coverage_presenter_spec.rb
+- spec/resolvers/coverage_line_resolver_spec.rb
+- spec/resolvers/resolver_factory_spec.rb
+- spec/resolvers/resultset_path_resolver_spec.rb
+- spec/resultset_loader_spec.rb
+- spec/shared_examples/README.md
+- spec/shared_examples/coverage_presenter_examples.rb
+- spec/shared_examples/file_based_mcp_tools.rb
+- spec/shared_examples/mcp_tool_text_json_response.rb
+- spec/simple_cov_mcp_module_spec.rb
 - spec/simplecov_mcp_model_spec.rb
+- spec/simplecov_mcp_opts_spec.rb
 - spec/spec_helper.rb
+- spec/staleness_checker_spec.rb
 - spec/staleness_more_spec.rb
-- spec/uncovered_lines_tool_spec.rb
+- spec/support/mcp_runner.rb
+- spec/tools_error_handling_spec.rb
 - spec/util_spec.rb
 - spec/version_spec.rb
 - spec/version_tool_spec.rb
 homepage: https://github.com/keithrbennett/simplecov-mcp
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -147,7 +204,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: MCP server + CLI for SimpleCov coverage data
 test_files: []

data/lib/simple_cov/mcp.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-# Back-compat shim: load new path
-require 'simple_cov_mcp'
-
-# Only when requiring this legacy path, expose SimpleCov::Mcp as an alias
-module SimpleCov
-  Mcp = SimpleCovMcp
-end

data/lib/simple_cov_mcp/base_tool.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-require 'mcp'
-require_relative 'errors'
-require_relative 'error_handler'
-
-module SimpleCovMcp
-  class BaseTool < ::MCP::Tool
-      INPUT_SCHEMA = {
-        type: 'object',
-        additionalProperties: false,
-        properties: {
-          path: {
-            type: 'string',
-            description: 'Repo-relative or absolute path to the file whose coverage data you need.',
-            examples: ['lib/simple_cov_mcp/model.rb']
-          },
-          root: {
-            type: 'string',
-            description: 'Project root used to resolve relative paths (defaults to current workspace).',
-            default: '.'
-          },
-          resultset: {
-            type: 'string',
-            description: 'Path to the SimpleCov .resultset.json file (absolute or relative to root).'
-          },
-          stale: {
-            type: 'string',
-            description: "How to handle missing/outdated coverage data. 'off' skips checks; 'error' raises.",
-            enum: %w[off error],
-            default: 'off'
-          }
-        },
-        required: ['path']
-      }
-      def self.input_schema_def = INPUT_SCHEMA
-
-      # Handle errors consistently across all MCP tools
-      # Returns an MCP::Tool::Response with appropriate error message
-      def self.handle_mcp_error(error, tool_name)
-        # Normalize to a SimpleCovMcp::Error so we can handle/log uniformly
-        normalized = error.is_a?(SimpleCovMcp::Error) ? error : SimpleCovMcp.error_handler.convert_standard_error(error)
-        log_mcp_error(normalized, tool_name)
-        ::MCP::Tool::Response.new([{ type: 'text', text: "Error: #{normalized.user_friendly_message}" }])
-      end
-
-      # Respond with JSON as a resource to avoid clients mutating content types.
-      # The resource embeds the JSON string with a clear MIME type.
-      def self.respond_json(payload, name: 'data.json', pretty: false)
-        json = pretty ? JSON.pretty_generate(payload) : JSON.generate(payload)
-        ::MCP::Tool::Response.new([
-          {
-            'type' => 'resource',
-            'resource' => {
-              'mimeType' => 'application/json',
-              'text' => json,
-              'name' => name
-            }
-          }
-        ])
-      end
-
-      private
-
-      def self.log_mcp_error(error, tool_name)
-        # Access the error handler's log_error method via send to bypass visibility
-        SimpleCovMcp.error_handler.send(:log_error, error, tool_name)
-      end
-  end
-end