cov-loupe 3.0.0

data/spec/version_spec.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'CovLoupe::VERSION' do
+  describe 'constant existence' do
+    it 'defines a VERSION constant' do
+      expect(CovLoupe.const_defined?(:VERSION)).to be true
+    end
+
+    it 'exposes VERSION as a non-empty string' do
+      expect(CovLoupe::VERSION).to be_a(String)
+      expect(CovLoupe::VERSION).not_to be_empty
+    end
+
+    it 'is frozen (immutable)' do
+      expect(CovLoupe::VERSION).to be_frozen
+    end
+  end
+
+  describe 'semantic versioning compliance' do
+    let(:version) { CovLoupe::VERSION }
+    # Simplified semantic versioning regex
+    # Preserves key semver rules: no leading zeros on numeric parts, optional prerelease/build metadata
+    let(:semver_regex) do
+      %r{\A
+        (?<major>0|[1-9]\d*)\.
+        (?<minor>0|[1-9]\d*)\.
+        (?<patch>0|[1-9]\d*)
+        (?:[.-](?<prerelease>[0-9A-Za-z.-]+))?
+        (?:\+(?<buildmetadata>[0-9A-Za-z.-]+))?
+      \z}x
+    end
+
+    it 'follows semantic versioning format (accepting hyphen or dot pre-release separator)' do
+      expect(version).to match(semver_regex)
+    end
+
+    it 'has valid major.minor.patch core version' do
+      match = version.match(semver_regex)
+      expect(match).not_to be_nil, "VERSION '#{version}' does not match semantic versioning format"
+
+      major = match[:major].to_i
+      minor = match[:minor].to_i
+      patch = match[:patch].to_i
+
+      expect(major).to be >= 0
+      expect(minor).to be >= 0
+      expect(patch).to be >= 0
+    end
+
+    context 'when version has prerelease identifier' do
+      let(:prerelease_version) { '9.9.9-rc.1' }
+
+      before do
+        stub_const('CovLoupe::VERSION', prerelease_version)
+      end
+
+      it 'has valid prerelease format' do
+        match = version.match(semver_regex)
+        prerelease = match[:prerelease]
+        expect(prerelease).not_to be_empty
+        expect(prerelease).not_to start_with('.')
+        expect(prerelease).not_to end_with('.')
+      end
+    end
+
+    context 'when version has build metadata' do
+      let(:build_metadata_version) { '9.9.9+build.42' }
+
+      before do
+        stub_const('CovLoupe::VERSION', build_metadata_version)
+      end
+
+      it 'has valid build metadata format' do
+        match = version.match(semver_regex)
+        buildmetadata = match[:buildmetadata]
+        expect(buildmetadata).not_to be_empty
+        expect(buildmetadata).to match(/\A[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*\z/)
+      end
+    end
+  end
+
+  describe 'version consistency' do
+    it 'is accessible via require path' do
+      expect { CovLoupe::VERSION }.not_to raise_error
+    end
+
+    it 'matches the version referenced in gemspec' do
+      gemspec_path = File.expand_path('../cov-loupe.gemspec', __dir__)
+      gemspec_content = File.read(gemspec_path)
+
+      version_line = gemspec_content.lines.find { |line| line.include?('spec.version') }
+      expect(version_line).not_to be_nil, 'Could not find version line in gemspec'
+      expect(version_line).to include('CovLoupe::VERSION')
+    end
+  end
+
+  describe 'current version sanity check' do
+    it 'is not the initial 0.0.0 version' do
+      # Ensure this is a real release, not an uninitialized version
+      expect(CovLoupe::VERSION).not_to eq('0.0.0')
+    end
+  end
+
+  describe 'standalone version file load' do
+    it 'defines the module and VERSION constant when only version.rb is loaded' do
+      original_version = CovLoupe::VERSION
+
+      stub_const('CovLoupe', Module.new do
+        class << self
+          attr_accessor :default_log_file, :active_log_file
+        end
+      end)
+
+      version_path = File.expand_path('../lib/cov_loupe/version.rb', __dir__)
+      load version_path
+
+      expect(Object.const_defined?(:CovLoupe)).to be true
+      expect(CovLoupe::VERSION).to eq(original_version)
+    end
+  end
+end

data/spec/version_tool_spec.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'cov_loupe/tools/version_tool'
+
+RSpec.describe CovLoupe::Tools::VersionTool do
+  let(:server_context) { instance_double('ServerContext').as_null_object }
+
+  before do
+    setup_mcp_response_stub
+  end
+
+  describe '.call' do
+    it 'returns a text payload with the version string when called without arguments' do
+      response = described_class.call(server_context: server_context)
+      item = response.payload.first
+      expect(item[:type] || item['type']).to eq('text')
+      text = item['text']
+      expect(text).to eq("CovLoupe version: #{CovLoupe::VERSION}")
+    end
+
+    it 'includes the exact version constant value' do
+      response = described_class.call(server_context: server_context)
+      item = response.payload.first
+      text = item['text']
+      expect(text).to include(CovLoupe::VERSION)
+    end
+
+    it 'matches the expected format exactly' do
+      expected_format = "CovLoupe version: #{CovLoupe::VERSION}"
+      response = described_class.call(server_context: server_context)
+      item = response.payload.first
+      text = item['text']
+      expect(text).to eq(expected_format)
+    end
+
+    it 'returns an MCP::Tool::Response object' do
+      response = described_class.call(server_context: server_context)
+      expect(response).to be_a(MCP::Tool::Response)
+    end
+
+    it 'has a single payload item' do
+      response = described_class.call(server_context: server_context)
+      expect(response.payload).to be_an(Array)
+      expect(response.payload.size).to eq(1)
+    end
+
+    context 'when error_mode is specified' do
+      it 'accepts error_mode parameter without affecting output' do
+        response = described_class.call(error_mode: 'off', server_context: server_context)
+        item = response.payload.first
+        text = item['text']
+        expect(text).to eq("CovLoupe version: #{CovLoupe::VERSION}")
+      end
+
+      it 'accepts error_mode "log" (default)' do
+        response = described_class.call(error_mode: 'log', server_context: server_context)
+        item = response.payload.first
+        expect(item[:type] || item['type']).to eq('text')
+      end
+
+      it 'accepts error_mode "debug"' do
+        response = described_class.call(error_mode: 'debug', server_context: server_context)
+        item = response.payload.first
+        expect(item[:type] || item['type']).to eq('text')
+      end
+    end
+
+    context 'when additional arguments are passed' do
+      it 'ignores additional arguments gracefully' do
+        response = described_class.call(
+          server_context: server_context,
+          extra_arg: 'value',
+          another: { nested: 'data' }
+        )
+        item = response.payload.first
+        text = item['text']
+        expect(text).to eq("CovLoupe version: #{CovLoupe::VERSION}")
+      end
+    end
+
+    context 'when an error occurs' do
+      it 'handles VERSION constant access errors and returns structured error response' do
+        # Force an error by hiding VERSION so const_missing is triggered
+        hide_const('CovLoupe::VERSION')
+        allow(CovLoupe).to receive(:const_missing).with(:VERSION)
+          .and_raise(StandardError, 'Version access error')
+
+        response = described_class.call(error_mode: 'log', server_context: server_context)
+
+        # Should return error response in MCP format
+        expect(response).to be_a(MCP::Tool::Response)
+        item = response.payload.first
+        expect(item[:type] || item['type']).to eq('text')
+
+        error_text = item['text']
+        expect(error_text).to include('Error')
+      end
+
+      it 'handles errors in the response creation process' do
+        # Force an error by mocking string interpolation to fail
+        version_obj = double('VERSION')
+        allow(version_obj).to receive(:to_s).and_raise(StandardError, 'String conversion error')
+
+        # Replace VERSION with our mock object
+        stub_const('CovLoupe::VERSION', version_obj)
+
+        response = described_class.call(error_mode: 'log', server_context: server_context)
+
+        # Should return error response in MCP format via the rescue block
+        expect(response).to be_a(MCP::Tool::Response)
+        item = response.payload.first
+        expect(item[:type] || item['type']).to eq('text')
+
+        error_text = item['text']
+        expect(error_text).to include('Error')
+      end
+
+      it 'respects error_mode setting when handling errors' do
+        # Force an error using a mock VERSION that raises an exception
+        version_obj = double('VERSION')
+        allow(version_obj).to receive(:to_s).and_raise(StandardError, 'Version error')
+        stub_const('CovLoupe::VERSION', version_obj)
+
+        # Test error_mode 'off' (should be silent but still return structured response)
+        response = described_class.call(error_mode: 'off', server_context: server_context)
+        expect(response).to be_a(MCP::Tool::Response)
+        item = response.payload.first
+        expect(item[:type] || item['type']).to eq('text')
+
+        # Test error_mode 'debug' (should include more detail)
+        response = described_class.call(error_mode: 'debug', server_context: server_context)
+        expect(response).to be_a(MCP::Tool::Response)
+        item = response.payload.first
+        expect(item[:type] || item['type']).to eq('text')
+        error_text = item['text']
+        expect(error_text).to include('Error')
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,290 @@
+--- !ruby/object:Gem::Specification
+name: cov-loupe
+version: !ruby/object:Gem::Version
+  version: 3.0.0
+platform: ruby
+authors:
+- Keith R. Bennett
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  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: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.21'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.21'
+    - - "<"
+      - !ruby/object:Gem::Version
+        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:
+- keithrbennett@gmail.com
+executables:
+- cov-loupe
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- docs/dev/ARCHITECTURE.md
+- docs/dev/BRANCH_ONLY_COVERAGE.md
+- docs/dev/DEVELOPMENT.md
+- docs/dev/README.md
+- docs/dev/RELEASING.md
+- docs/dev/arch-decisions/001-x-arch-decision.md
+- docs/dev/arch-decisions/002-x-arch-decision.md
+- docs/dev/arch-decisions/003-x-arch-decision.md
+- docs/dev/arch-decisions/004-x-arch-decision.md
+- docs/dev/arch-decisions/005-x-arch-decision.md
+- docs/dev/arch-decisions/README.md
+- docs/dev/presentations/cov-loupe-presentation.md
+- docs/fixtures/demo_project/README.md
+- docs/user/ADVANCED_USAGE.md
+- docs/user/CLI_FALLBACK_FOR_LLMS.md
+- docs/user/CLI_USAGE.md
+- docs/user/ERROR_HANDLING.md
+- docs/user/EXAMPLES.md
+- docs/user/INSTALLATION.md
+- docs/user/LIBRARY_API.md
+- docs/user/MCP_INTEGRATION.md
+- docs/user/README.md
+- docs/user/TROUBLESHOOTING.md
+- docs/user/V2-BREAKING-CHANGES.md
+- exe/cov-loupe
+- lib/cov_loupe.rb
+- lib/cov_loupe/app_config.rb
+- lib/cov_loupe/app_context.rb
+- lib/cov_loupe/base_tool.rb
+- lib/cov_loupe/cli.rb
+- lib/cov_loupe/commands/base_command.rb
+- lib/cov_loupe/commands/command_factory.rb
+- lib/cov_loupe/commands/detailed_command.rb
+- lib/cov_loupe/commands/list_command.rb
+- lib/cov_loupe/commands/raw_command.rb
+- lib/cov_loupe/commands/summary_command.rb
+- lib/cov_loupe/commands/totals_command.rb
+- lib/cov_loupe/commands/uncovered_command.rb
+- lib/cov_loupe/commands/validate_command.rb
+- lib/cov_loupe/commands/version_command.rb
+- lib/cov_loupe/config_parser.rb
+- lib/cov_loupe/constants.rb
+- lib/cov_loupe/coverage_reporter.rb
+- lib/cov_loupe/error_handler.rb
+- lib/cov_loupe/error_handler_factory.rb
+- lib/cov_loupe/errors.rb
+- lib/cov_loupe/formatters.rb
+- lib/cov_loupe/formatters/source_formatter.rb
+- lib/cov_loupe/mcp_server.rb
+- lib/cov_loupe/mode_detector.rb
+- lib/cov_loupe/model.rb
+- lib/cov_loupe/option_normalizers.rb
+- lib/cov_loupe/option_parser_builder.rb
+- lib/cov_loupe/option_parsers/env_options_parser.rb
+- lib/cov_loupe/option_parsers/error_helper.rb
+- lib/cov_loupe/path_relativizer.rb
+- lib/cov_loupe/predicate_evaluator.rb
+- lib/cov_loupe/presenters/base_coverage_presenter.rb
+- lib/cov_loupe/presenters/coverage_detailed_presenter.rb
+- lib/cov_loupe/presenters/coverage_raw_presenter.rb
+- lib/cov_loupe/presenters/coverage_summary_presenter.rb
+- lib/cov_loupe/presenters/coverage_uncovered_presenter.rb
+- lib/cov_loupe/presenters/project_coverage_presenter.rb
+- lib/cov_loupe/presenters/project_totals_presenter.rb
+- lib/cov_loupe/resolvers/coverage_line_resolver.rb
+- lib/cov_loupe/resolvers/resolver_factory.rb
+- lib/cov_loupe/resolvers/resultset_path_resolver.rb
+- lib/cov_loupe/resultset_loader.rb
+- lib/cov_loupe/staleness_checker.rb
+- lib/cov_loupe/table_formatter.rb
+- lib/cov_loupe/tools/all_files_coverage_tool.rb
+- lib/cov_loupe/tools/coverage_detailed_tool.rb
+- lib/cov_loupe/tools/coverage_raw_tool.rb
+- lib/cov_loupe/tools/coverage_summary_tool.rb
+- lib/cov_loupe/tools/coverage_table_tool.rb
+- lib/cov_loupe/tools/coverage_totals_tool.rb
+- lib/cov_loupe/tools/help_tool.rb
+- lib/cov_loupe/tools/uncovered_lines_tool.rb
+- lib/cov_loupe/tools/validate_tool.rb
+- lib/cov_loupe/tools/version_tool.rb
+- lib/cov_loupe/util.rb
+- lib/cov_loupe/version.rb
+- spec/MCP_INTEGRATION_TESTS_README.md
+- spec/TIMESTAMPS.md
+- spec/all_files_coverage_tool_spec.rb
+- spec/app_config_spec.rb
+- spec/base_tool_spec.rb
+- spec/cli/show_default_report_spec.rb
+- spec/cli_enumerated_options_spec.rb
+- spec/cli_error_spec.rb
+- spec/cli_format_spec.rb
+- spec/cli_json_options_spec.rb
+- spec/cli_source_spec.rb
+- spec/cli_spec.rb
+- spec/cli_table_spec.rb
+- spec/cli_usage_spec.rb
+- spec/commands/base_command_spec.rb
+- spec/commands/command_factory_spec.rb
+- spec/commands/detailed_command_spec.rb
+- spec/commands/list_command_spec.rb
+- spec/commands/raw_command_spec.rb
+- spec/commands/summary_command_spec.rb
+- spec/commands/totals_command_spec.rb
+- spec/commands/uncovered_command_spec.rb
+- spec/commands/validate_command_spec.rb
+- spec/commands/version_command_spec.rb
+- spec/constants_spec.rb
+- spec/cov_loupe/formatters/source_formatter_spec.rb
+- spec/cov_loupe/formatters_spec.rb
+- spec/cov_loupe/presenters/base_coverage_presenter_spec.rb
+- spec/cov_loupe_model_spec.rb
+- spec/cov_loupe_module_spec.rb
+- spec/cov_loupe_opts_spec.rb
+- spec/coverage_reporter_spec.rb
+- spec/coverage_table_tool_spec.rb
+- spec/coverage_totals_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/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/presenters/project_totals_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/formatted_command_examples.rb
+- spec/shared_examples/mcp_tool_text_json_response.rb
+- spec/spec_helper.rb
+- spec/staleness_checker_spec.rb
+- spec/staleness_more_spec.rb
+- spec/support/cli_helpers.rb
+- spec/support/control_flow_helpers.rb
+- spec/support/fake_mcp.rb
+- spec/support/io_helpers.rb
+- spec/support/mcp_helpers.rb
+- spec/support/mcp_runner.rb
+- spec/support/mocking_helpers.rb
+- spec/table_format_spec.rb
+- spec/tools/validate_tool_spec.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/cov-loupe
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message: |
+  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+  ┃ V3.0.0 - GEM RENAMED: simplecov-mcp → cov-loupe                         ┃
+  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+  ┃                                                                         ┃
+  ┃ This gem has been renamed! If upgrading from simplecov-mcp:             ┃
+  ┃                                                                         ┃
+  ┃  • Executable: simplecov-mcp → cov-loupe                                ┃
+  ┃  • Environment: SIMPLECOV_MCP_OPTS → COV_LOUPE_OPTS                     ┃
+  ┃  • Log file: simplecov_mcp.log → cov_loupe.log                          ┃
+  ┃  • Alias: smcp → clp (in documentation)                                 ┃
+  ┃                                                                         ┃
+  ┃ Module name (CovLoupe) and require path (cov_loupe) unchanged.          ┃
+  ┃                                                                         ┃
+  ┃ Uninstall old gem: gem uninstall simplecov-mcp                          ┃
+  ┃                                                                         ┃
+  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+  ┃ V2.0.0 BREAKING CHANGES (if upgrading from v1.x)                        ┃
+  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+  ┃                                                                         ┃
+  ┃  • Options must now come BEFORE subcommands                             ┃
+  ┃  • --stale renamed to --staleness (-S still works)                      ┃
+  ┃  • --json replaced with --format json                                   ┃
+  ┃  • Error modes renamed: 'on' → 'log', 'trace' → 'debug'                 ┃
+  ┃  • --success-predicate moved to 'validate' subcommand                   ┃
+  ┃  • Default sort order changed from ascending to descending              ┃
+  ┃                                                                         ┃
+  ┃ See docs/user/V2-BREAKING-CHANGES.md for complete migration guide.      ┃
+  ┃                                                                         ┃
+  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: MCP server + CLI for SimpleCov coverage data
+test_files: []