chutney 3.11.2 → 3.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec37ccd0377c50adf8968133abf55a2e6ffe76f5e6388d24681cd2c9aa925244
-  data.tar.gz: 793ca207c66e94d4c48d8f5f752880730e06cc043c8d1ff0b3db972663fb33de
+  metadata.gz: 4bb70911d762cb65f7bf9787409241481d5bb6b36544c4d9cb0544ed441ab1f4
+  data.tar.gz: 25b3aea992da920ba631c4020dec0f80facac6279687bc7b1855aa65fe511bcb
 SHA512:
-  metadata.gz: 16e1f2824bd0183a4d7bf3d383713bdad718abd335f075190fdcdc4a671ac4b272f27f5bf63fe4561fd0a266ee104957d12acd18ca89c3a46783ac2689ce77c3
-  data.tar.gz: bea0fa1997bf1d06a776dceb8d6d4e0ed31d384cc84a076ffc958077caa0f078fd8f42b7b950047821f7b9f29e8b930b481943bd2b3a05e8967d47fb12f493e4
+  metadata.gz: 94edc0b29066f55cc5c1e8badbe9a336ec23415edd92c3ab7a8ef64f7246c59515ec020d6342793ae8cb46bb6e82c51962e08cab7942c718caf93339cd060da2
+  data.tar.gz: 4324c6dd20acc5062b6e7022e2d79e86267f3e7c63b5a5924b327d07ffa4abf571e4d99edeabbfb9a0f312f61d46e3c6ccfb36c0b60d6c7697e9bcbce9968730

data/.gitignore

@@ -11,6 +11,7 @@ Gemfile.lock
 # rspec failure tracking
 .rspec_status
 .idea/
+.vscode/
 
 .DS_Store
 

data/chutney.gemspec

@@ -51,6 +51,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'amatch', '~> 0.4.0'
   spec.add_dependency 'cuke_modeler', '~> 3.21'
   spec.add_dependency 'i18n', '>= 1.8.2', '< 1.15.0'
+  spec.add_dependency 'fast-mcp', '~> 1.5'
   spec.add_dependency 'language_server-protocol', '~> 3.17'
   spec.add_dependency 'pastel', '~> 0.7'
   spec.add_dependency 'tty-pie', '~> 0.3'

data/exe/chutney-mcp

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# MCP (Model Context Protocol) server for Chutney
+# This executable provides a FastMCP server that exposes Chutney's Gherkin linting
+# capabilities as a tool that can be used by MCP clients
+
+require 'chutney'
+require 'fast_mcp'
+
+# ChutneyTool provides Gherkin file linting functionality via MCP
+# It wraps Chutney's linting capabilities in a FastMCP tool format
+class ChutneyTool < FastMcp::Tool
+  tool_name 'Chutney'
+  description 'Lint your Cuxumber Gherkin BDD files and make sure they follow standards and best practice'
+
+  # Define the required arguments for the tool
+  # file_path: Absolute path to the Gherkin feature file to be linted
+  arguments do
+    required(:file_path).filled(:string).description('An ABSULTE file path to the gherking file to lint')
+  end
+
+  # Main execution method that performs the Gherkin file linting
+  # @param file_path [String] Absolute path to the Gherkin file
+  # @return [Hash] Analysis report containing linting results
+  def call(file_path:)
+    # Validate that an absolute path was provided
+    raise 'Relative path given, absolute path require' unless File.absolute_path?(file_path)
+
+    # Verify the file exists before attempting to lint it
+    raise 'File not found' unless File.exist?(file_path)
+
+    # Create a new Chutney linter instance and analyze the file
+    linter = Chutney::ChutneyLint.new(file_path)
+    report = linter.analyse
+
+    # Return the analysis report as a hash for MCP consumption
+    report.to_h
+  end
+end
+
+# Initialize and configure the MCP server
+# The server exposes Chutney functionality to MCP clients
+server = FastMcp::Server.new(name: 'chutney', version: Chutney::VERSION)
+
+# Register the ChutneyTool with the server
+server.register_tool(ChutneyTool)
+
+# Start the MCP server to begin accepting client connections
+server.start

data/lib/chutney/formatter/pie_formatter.rb

@@ -64,7 +64,7 @@ module Chutney
     def put_summary
       pastel = Pastel.new
       print "#{files.count} features inspected, "
-      if files_with_issues.count.zero?
+      if files_with_issues.none?
         puts pastel.green('all taste delicious')
       else
         puts pastel.red("#{files_with_issues.count} taste nasty")

data/lib/chutney/formatter/rainbow_formatter.rb

@@ -37,7 +37,7 @@ module Chutney
 
     def put_summary
       print "#{files.count} features inspected, "
-      if files_with_issues.count.zero?
+      if files_with_issues.none?
         puts @pastel.green('all taste delicious')
       else
         puts @pastel.red("#{files_with_issues.count} taste nasty")

data/lib/chutney/formatter.rb

@@ -14,7 +14,7 @@ module Chutney
     end
 
     def files_with_issues
-      results.filter { |_k, v| v.any? { |r| r[:issues].count.positive? } }
+      results.filter { |_k, v| v.any? { |r| r[:issues].any? } }
     end
   end
 end

data/lib/chutney/issue.rb

@@ -6,6 +6,7 @@ module Chutney
   # entity value class for issues
   class Issue
     include Term::ANSIColor
+
     attr_reader :name, :references, :description
 
     def initialize(name, references, description = nil)

data/lib/chutney/linter/inconsistent_quoting.rb

@@ -14,7 +14,7 @@ module Chutney
       quoted_params = parameters.group_by(&:quotation_mark)
       single_quoted = quoted_params[%(')] || []
       double_quoted = quoted_params[%(")] || []
-      return unless single_quoted.count.positive? && double_quoted.count.positive?
+      return unless single_quoted.any? && double_quoted.any?
 
       add_issue(
         I18n.t('linters.inconsistent_quoting',

data/lib/chutney/linter/same_scenario.rb

@@ -3,6 +3,10 @@
 module Chutney
   # Rule to find all the duplicated scenarios
   class SameScenario < Linter
+    def self.reset
+      @dictionary = nil
+    end
+
     def self.dictionary
       @dictionary ||= Hash.new { |hash, key| hash[key] = [] }
     end

data/lib/chutney/linter.rb

@@ -128,9 +128,7 @@ module Chutney
       off_switch = element.tags
                           .map(&:name)
                           .then { |tags| tags || [] }
-                          .filter { |tag_name| tag_name == "@disable#{linter_name}" }
-                          .count
-                          .positive?
+                          .any? { |tag_name| tag_name == "@disable#{linter_name}" }
       off_switch ||= off_switch?(feature) unless element == feature
       off_switch
     end

data/lib/chutney/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Chutney
-  VERSION = '3.11.2'
+  VERSION = '3.12.0'
 end

data/lib/chutney.rb

@@ -60,6 +60,7 @@ module Chutney
   # gherkin linter
   class ChutneyLint
     extend Forwardable
+
     attr_accessor :verbose
     attr_reader :files, :results
 

data/lib/config/locales/en.yml

@@ -56,7 +56,7 @@ en:
       missing_action: >-
         This scenario is missing an action step -- it does not have a 'When'.
     missing_example_name: >-
-      You have a scenerio with more than one example table, at least one of which is
+      You have a scenario with more than one example table, at least one of which is
       unnamed or has a duplicate name.
       You should give your example tables clear and meaningful names when you have more than one.
     missing_example_table: >-

data/usechutney.com/_data/navigation.yml

@@ -116,3 +116,5 @@ sidebar:
     children:
       - title: "Language server"
         url: /docs/language-server/
+      - title: "LLM integration"
+        url: /docs/mcp/

data/usechutney.com/docs/mcp/index.md

@@ -0,0 +1,37 @@
+---
+title: "Chutney MCP Server"
+layout: single
+permalink: /docs/mcp/
+---
+
+{: .notice}
+Since v3.12.0
+
+Chutney now ships with a Model Context Protocol (MCP) server for easy integration with AI LLMs, afterall if they're helping author gherkin, it should be tasty.
+
+The command to start the MCP is 
+
+```bash
+chutney-mcp
+```
+
+The MCP is STDIO based server.
+
+### VS Code integration example
+
+To set it up for a particular repository, create a file called `.vscode/mcp.json` in the root of your project. Add this block (or modify the `servers` section if you already have this file) to look like:
+
+```json
+{
+  "servers": {
+    "chutney": {
+    "type": "stdio",
+      "command": "chutney-mcp",
+      "args": []
+    }
+  },
+  "inputs": []
+}
+```
+
+Then, in your copilot chat, click on tools and make sure the MCP is enabled, then click on the discover tools button and copilot will be able to use chutney.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chutney
 version: !ruby/object:Gem::Version
-  version: 3.11.2
+  version: 3.12.0
 platform: ruby
 authors:
 - Nigel Brookes-Thomas
@@ -60,6 +60,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 1.15.0
+- !ruby/object:Gem::Dependency
+  name: fast-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: language_server-protocol
   requirement: !ruby/object:Gem::Requirement
@@ -111,6 +125,7 @@ email:
 executables:
 - chutney
 - chutney-lsp
+- chutney-mcp
 extensions: []
 extra_rdoc_files: []
 files:
@@ -142,6 +157,7 @@ files:
 - examples/emoji.feature
 - exe/chutney
 - exe/chutney-lsp
+- exe/chutney-mcp
 - img/chutney.svg
 - img/formatters.png
 - img/happy_chutney.png
@@ -215,6 +231,7 @@ files:
 - usechutney.com/docs/disabling-rules/index.md
 - usechutney.com/docs/installing/index.md
 - usechutney.com/docs/language-server/index.md
+- usechutney.com/docs/mcp/index.md
 - usechutney.com/docs/rules/avoid-colons-at-start-of-names/index.md
 - usechutney.com/docs/rules/avoid-comma-in-tags/index.md
 - usechutney.com/docs/rules/avoid-full-stops/index.md