ffast 0.2.3 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da30bc7abc983e2ac54c1c4d1f454878d75dce0dd285a0e245d6ed54d73e4040
-  data.tar.gz: f286ce93d5ce2970d1c3a528d423bf8b8ed9239140f798f895a67e0aa1b8e2d2
+  metadata.gz: 95125c92ee4201a508f422f041be2a63aebe3a92a19ca303d85b1be98ab6f1e0
+  data.tar.gz: 137a7d81790b9f51aaeea271d4d803b6b33a158f7f4b9f4c8a007a23131e6f05
 SHA512:
-  metadata.gz: 83c218849cd4a9184b34f9d760d537cae650fe8a96428aa83fdeff12ed6afc57129fff3ce4a0c6d6924225e178f80c114afb021e19ca41bc2677c85b0668ee99
-  data.tar.gz: 6d4499e8a11398c3f9bc8a04adcd5efd65ef1b385c9bc37370edc31f9375b8d844e8ed61981e33831b2b83961edd4245059a38167c2f7a5ffbc52dd49acb9fff
+  metadata.gz: 9b1cb25bf21ef812530856cd778b8d875df7498bc9aaa6576c215964c75dc189131f8fdb539b18eec54b8c44fc3033099b74d457135f77feeff6d5f1ebb34405
+  data.tar.gz: 256b3549dd55c412ad1a5d2d84b7d284f4fb94f10096f56a02391ae4e67f4e40894ad1816ab997f7dd08b99b36aa90b9eb68ce3101fa8bba0fb0ba7185329761

data/.agents/fast-pattern-expert/SKILL.md

@@ -0,0 +1,71 @@
+# Skill: Fast Pattern Expert
+
+You are an expert in constructing and translating natural language queries into `Fast` AST patterns for Ruby.
+
+## Core Expertise
+- Translating structural descriptions of Ruby code into S-expression based AST patterns.
+- Understanding the Ruby AST (Prism/Parser based).
+- Navigating and searching codebases semantically using `Fast`.
+
+## Syntax Reference
+- `(node_type ...)` : Search for a node of a specific type.
+- `_` : Matches any non-nil node/value.
+- `nil` : Matches exactly `nil`.
+- `...` : When last in a list, matches zero or more remaining children. Elsewhere, matches a node with children.
+- `^` : Navigate to the parent node.
+- `$` : Capture the matched node or value.
+- `{type1 type2}` : Union (OR) - matches if any internal expression matches.
+- `[expr1 expr2]` : Intersection (AND) - matches only if all internal expressions match.
+- `!expr` : Negation (NOT) - matches if the expression does not match.
+- `?expr` : Maybe - matches if the node is nil or matches the expression.
+- `\1`, `\2` : Backreference to previous captures.
+- `#custom_method` : Call a custom Ruby method for validation.
+- `.instance_method?` : Call an instance method on the node for validation (e.g., `.odd?`).
+
+## Common Ruby AST Nodes
+- `(def name (args) body)` : Method definition.
+- `(defs receiver name (args) body)` : Singleton method definition.
+- `(send receiver method_name args...)` : Method call.
+- `(class name superclass body)` : Class definition.
+- `(module name body)` : Module definition.
+- `(const scope name)` : Constant reference (scope is nil for top-level).
+- `(casgn scope name value)` : Constant assignment.
+- `(lvar name)` : Local variable read.
+- `(lvasgn name value)` : Local variable assignment.
+- `(ivar name)` : Instance variable read.
+- `(ivasgn name value)` : Instance variable assignment.
+- `(hash (pair key value)...)` : Hash literal.
+- `(array elements...)` : Array literal.
+
+## Translation Examples
+
+### Methods
+- "Find all methods named 'process'" -> `(def process)`
+- "Find methods with at least 3 arguments" -> `(def _ (args _ _ _ ...))`
+- "Find singleton methods (self.method)" -> `(defs ...)`
+- "Find methods that call 'super'" -> `(def _ _ (send nil :super ...))`
+
+### Classes & Modules
+- "Find classes inheriting from ApplicationController" -> `(class _ (const nil ApplicationController))`
+- "Find classes defined inside the 'User' namespace" -> `(class (const (const nil User) _) ...)`
+- "Find modules that include 'Enumerable'" -> `(module _ (begin < (send nil include (const nil Enumerable)) ...))`
+
+### Method Calls
+- "Find all calls to 'User.find'" -> `(send (const nil User) find ...)`
+- "Find calls to 'where' with a hash argument" -> `(send _ where (hash ...))`
+- "Find calls to 'exit' or 'abort'" -> `(send nil {exit abort} ...)`
+
+### Variables & Constants
+- "Find where the 'DEBUG' constant is assigned" -> `(casgn nil DEBUG)`
+- "Find all uses of instance variable '@user'" -> `(ivar @user)`
+- "Find assignments to '@user'" -> `(ivasgn @user)`
+
+## Strategy for Complex Queries
+1. **Identify the anchor node**: What is the primary structure? (e.g., a method definition, a specific call).
+2. **Describe children**: What must be true about its arguments or body?
+3. **Use Union/Intersection**: Combine multiple constraints using `{}` or `[]`.
+4. **Capture if needed**: Use `$` if you only want a specific part of the match.
+5. **Validate**: Always use `validate_fast_pattern` if available to check syntax.
+
+## AST Triage
+If you are unsure of the AST structure for a piece of code, use `Fast.ast("your code snippet")` or `Fast.ast_from_file` to see the s-expression representation. This is the most reliable way to build a pattern.

data/Fastfile

@@ -15,7 +15,7 @@ version_file = Dir['lib/*/version.rb'].first
 Fast.shortcut(:version, '(casgn nil VERSION (str _))', version_file)
 
 # Show all classes that inherits Fast::Find
-Fast.shortcut(:finders, '(class ... (const nil Find)', 'lib')
+Fast.shortcut(:finders, '(class ... (const nil Find))', 'lib')
 
 # You can run shortcuts appending a dot to the shortcut.
 #   $ fast .version
@@ -23,13 +23,13 @@ Fast.shortcut(:finders, '(class ... (const nil Find)', 'lib')
 #   VERSION = '0.1.2'
 
 # Simple shortcut that I used often to show how the expression parser works
-Fast.shortcut(:parser, '(class (const nil ExpressionParser)', 'lib/fast.rb')
-Fast.shortcut(:sql_parser, '(def parse', 'lib/fast/sql.rb')
+Fast.shortcut(:parser, '(class (const nil ExpressionParser))', 'lib/fast.rb')
+Fast.shortcut(:sql_parser, '(def parse ...)', 'lib/fast/sql.rb')
 
 # Use `fast .bump_version` to rewrite the version file
 Fast.shortcut :bump_version do
   new_version = nil
-  rewrite_file('(casgn nil VERSION (str _)', version_file) do |node|
+  rewrite_file('(casgn nil VERSION (str _))', version_file) do |node|
     target = node.children.last.loc.expression
     pieces = target.source.split('.').map(&:to_i)
     pieces.reverse.each_with_index do |fragment, i|

data/README.md

@@ -12,20 +12,6 @@ the code was written without an AST.
 
 Check out the official documentation: https://jonatas.github.io/fast.
 
-## Documentation locally
-
-The documentation site is built with MkDocs Material and a few Markdown
-extensions. To run it locally:
-
-```bash
-python3 -m venv .venv
-source .venv/bin/activate
-python3 -m pip install -r requirements-docs.txt
-mkdocs serve
-```
-
-Then open `http://127.0.0.1:8000`.
-
 ## Token Syntax for `find` in AST
 
 The current version of Fast covers the following token elements:
@@ -694,6 +680,20 @@ code("a = 1") # => s(:lvasgn, s(:int, 1))
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Documentation locally
+
+The documentation site is built with MkDocs Material and a few Markdown
+extensions. To run it locally:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python3 -m pip install -r requirements-docs.txt
+mkdocs serve
+```
+
+Then open `http://127.0.0.1:8000`.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/jonatas/fast. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

data/fast.gemspec

@@ -17,7 +17,8 @@ Gem::Specification.new do |spec|
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|experiments|examples|features|docs|assets|stylesheets|site)/})
+    f.match(%r{^(test|spec|experiments|examples|features|docs|assets|stylesheets|site)/}) ||
+      f.match(%r{^(\.git|\.github|\.travis|\.sourcelevel|\.rubocop|\.projections|\.rspec|Gemfile|Rakefile|Guardfile|mkdocs|requirements-docs|TODO|ideia_blog_post)})
   end
 
   spec.post_install_message = <<~THANKS
@@ -39,8 +40,8 @@ Gem::Specification.new do |spec|
   THANKS
 
   spec.bindir        = 'bin'
-  spec.executables   = %w[fast fast-experiment]
-  spec.require_paths = %w[lib experiments]
+  spec.executables   = %w[fast fast-experiment fast-mcp]
+  spec.require_paths = %w[lib]
 
   spec.add_dependency 'coderay'
   spec.add_dependency 'parallel'

data/lib/fast/cli.rb

@@ -12,6 +12,12 @@ require 'ostruct'
 # It defines #report and #highlight functions that can be used to pretty print
 # code and results from the search.
 module Fast
+  module SymbolExtension
+    def loc
+      OpenStruct.new(expression: OpenStruct.new(line: 0))
+    end
+  end
+
   module_function
 
   # Highligh some source code based on the node.
@@ -20,19 +26,19 @@ module Fast
   # @param colorize [Boolean] skips `CodeRay` processing when false.
   # @param level [Integer] defines the max depth to print the AST.
   def highlight(node, show_sexp: false, colorize: true, sql: false, level: nil)
-      output =
-        if node.respond_to?(:loc) && !show_sexp
-          if level
-            Fast.fold_source(node, level: level)
-          else
-            wrap_source_range(node).source
-          end
-        elsif show_sexp && level && Fast.ast_node?(node)
-          Fast.fold_ast(node, level: level).to_s
-        elsif show_sexp
-          node.to_s
+    output =
+      if node.respond_to?(:loc) && !show_sexp
+        if level
+          Fast.fold_source(node, level: level)
         else
-          node
+          wrap_source_range(node).source
+        end
+      elsif show_sexp && level && Fast.ast_node?(node)
+        Fast.fold_ast(node, level: level).to_s
+      elsif show_sexp
+        node.to_s
+      else
+        node.to_s
       end
     return output unless colorize
 
@@ -78,6 +84,9 @@ module Fast
   #   Fast.report(result, file: 'file.rb')
   def report(result, show_link: false, show_permalink: false, show_sexp: false, file: nil, headless: false, bodyless: false, colorize: true, level: nil) # rubocop:disable Metrics/ParameterLists
     if file
+      if result.is_a?(Symbol) && !result.respond_to?(:loc)
+        result.extend(SymbolExtension)
+      end
       line = result.loc.expression.line if Fast.ast_node?(result) && result.respond_to?(:loc)
       if show_link
         puts(result.link)
@@ -97,8 +106,23 @@ module Fast
       args = args.dup
       args = replace_args_with_shortcut(args) if shortcut_name_from(args)
       @colorize = STDOUT.isatty
-      option_parser.parse! args
+      @headless = false
+      @bodyless = false
+      @captures = false
+      @parallel = false
+      @debug = false
+      @sql = false
+      @level = nil
+      @show_sexp = false
+      @help = false
+      @similar = false
+      @from_code = false
+      @show_link = false
+      @show_permalink = false
+      @files = []
+      option_parser.parse!(args)
       @pattern, @files = extract_pattern_and_files(args)
+      puts "DEBUG: pattern=#{@pattern.inspect} files=#{@files.inspect}" if @debug
 
       @sql ||= @files.any? && @files.all? { |file| file.end_with?('.sql') }
       require 'fast/sql' if @sql
@@ -137,7 +161,7 @@ module Fast
           @sql = true
         end
 
-        opts.on('--captures', 'Print only captures of the patterns and skip node results') do
+        opts.on('-c', '--captures', 'Print only captures of the patterns and skip node results') do
           @captures = true
         end
 
@@ -166,6 +190,16 @@ module Fast
           @from_code = true
         end
 
+        opts.on('--validate-pattern PATTERN', 'Validate a node pattern') do |pattern|
+          begin
+            Fast.expression(pattern)
+            puts "Pattern is valid."
+          rescue StandardError => e
+            puts "Invalid pattern: #{e.message}"
+          end
+          exit
+        end
+
         opts.on_tail('--version', 'Show version') do
           puts Fast::VERSION
           exit

data/lib/fast/mcp_server.rb

@@ -10,6 +10,17 @@ module Fast
   # Implements the Model Context Protocol (MCP) server over STDIO.
   class McpServer
     TOOLS = [
+      {
+        name: 'validate_fast_pattern',
+        description: 'Validate a Fast AST pattern. Returns true if valid, or a specific syntax error message if invalid.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            pattern: { type: 'string', description: 'Fast AST pattern to validate.' }
+          },
+          required: ['pattern']
+        }
+      },
       {
         name: 'search_ruby_ast',
         description: 'Search Ruby files using a Fast AST pattern. Returns file, line range, and source. Use show_ast=true only when you need the s-expression.',
@@ -146,8 +157,14 @@ module Fast
       args      = params['arguments'] || {}
       show_ast  = args['show_ast'] || false
 
+      if args['pattern'] && !args['pattern'].start_with?('(', '{', '[') && !args['pattern'].match?(/^[a-z_]+$/)
+        raise "Invalid Fast AST pattern: '#{args['pattern']}'. Did you mean to use an s-expression like '(#{args['pattern']})'?"
+      end
+
       result =
         case tool_name
+        when 'validate_fast_pattern'
+          execute_validate_pattern(args['pattern'])
         when 'search_ruby_ast'
           execute_search(args['pattern'], args['paths'], show_ast: show_ast)
         when 'ruby_method_source'
@@ -170,6 +187,13 @@ module Fast
       write_error(id, -32603, 'Tool execution failed', e.message)
     end
 
+    def execute_validate_pattern(pattern)
+      Fast.expression(pattern)
+      { valid: true }
+    rescue StandardError => e
+      { valid: false, error: e.message }
+    end
+
     def execute_search(pattern, paths, show_ast: false)
       results = []
       on_result = ->(file, matches) do

data/lib/fast/prism_adapter.rb

@@ -135,8 +135,12 @@ module Fast
         build_node(:sym, [node.unescaped], node, source, buffer_name)
       when Prism::StringNode
         build_node(:str, [node.unescaped], node, source, buffer_name)
+      when Prism::XStringNode
+        build_node(:xstr, [node.unescaped], node, source, buffer_name)
       when Prism::InterpolatedStringNode
         build_node(:dstr, node.parts.filter_map { |part| adapt(part, source, buffer_name) }, node, source, buffer_name)
+      when Prism::InterpolatedXStringNode
+        build_node(:dxstr, node.parts.filter_map { |part| adapt(part, source, buffer_name) }, node, source, buffer_name)
       when Prism::InterpolatedSymbolNode
         build_node(:dsym, node.parts.filter_map { |part| adapt(part, source, buffer_name) }, node, source, buffer_name)
       when Prism::ArrayNode
@@ -183,6 +187,8 @@ module Fast
         build_node(:if, [adapt(node.predicate, source, buffer_name), adapt(node.statements, source, buffer_name), adapt(node.consequent, source, buffer_name)], node, source, buffer_name)
       when Prism::UnlessNode
         build_node(:if, [adapt(node.predicate, source, buffer_name), adapt(node.consequent, source, buffer_name), adapt(node.statements, source, buffer_name)], node, source, buffer_name)
+      when Prism::RescueModifierNode
+        build_node(:rescue, [adapt(node.expression, source, buffer_name), build_node(:resbody, [nil, nil, adapt(node.rescue_expression, source, buffer_name)], node, source, buffer_name), nil], node, source, buffer_name)
       when Prism::CaseNode
         children = [adapt(node.predicate, source, buffer_name)]
         children.concat(node.conditions.map { |condition| adapt(condition, source, buffer_name) })
@@ -231,10 +237,10 @@ module Fast
       return build_node(:args, [], nil, source, buffer_name) unless node
 
       children = []
-      children.concat(node.requireds.map { |child| build_node(:arg, [child.name], child, source, buffer_name) }) if node.respond_to?(:requireds)
-      children.concat(node.optionals.map { |child| build_node(:optarg, [child.name, adapt(child.value, source, buffer_name)], child, source, buffer_name) }) if node.respond_to?(:optionals)
+      children.concat(node.requireds.map { |child| adapt_required_parameter(child, source, buffer_name) }) if node.respond_to?(:requireds)
+      children.concat(node.optionals.map { |child| build_node(:optarg, [parameter_name(child), adapt(child.value, source, buffer_name)], child, source, buffer_name) }) if node.respond_to?(:optionals)
       children << build_node(:restarg, [parameter_name(node.rest)], node.rest, source, buffer_name) if node.respond_to?(:rest) && node.rest
-      children.concat(node.posts.map { |child| build_node(:arg, [child.name], child, source, buffer_name) }) if node.respond_to?(:posts)
+      children.concat(node.posts.map { |child| adapt_required_parameter(child, source, buffer_name) }) if node.respond_to?(:posts)
       children.concat(node.keywords.map { |child| adapt_keyword_parameter(child, source, buffer_name) }) if node.respond_to?(:keywords)
       children << build_node(:kwrestarg, [parameter_name(node.keyword_rest)], node.keyword_rest, source, buffer_name) if node.respond_to?(:keyword_rest) && node.keyword_rest
       children << build_node(:blockarg, [parameter_name(node.block)], node.block, source, buffer_name) if node.respond_to?(:block) && node.block
@@ -248,14 +254,25 @@ module Fast
       adapt_parameters(params, source, buffer_name)
     end
 
+    def adapt_required_parameter(child, source, buffer_name)
+      if child.is_a?(Prism::MultiTargetNode)
+        mlhs_children = child.lefts.map { |c| adapt_required_parameter(c, source, buffer_name) }
+        mlhs_children << build_node(:restarg, [parameter_name(child.rest)], child.rest, source, buffer_name) if child.respond_to?(:rest) && child.rest
+        mlhs_children.concat(child.rights.map { |c| adapt_required_parameter(c, source, buffer_name) }) if child.respond_to?(:rights)
+        build_node(:mlhs, mlhs_children, child, source, buffer_name)
+      else
+        build_node(:arg, [parameter_name(child)], child, source, buffer_name)
+      end
+    end
+
     def adapt_keyword_parameter(node, source, buffer_name)
       case node
       when Prism::RequiredKeywordParameterNode
-        build_node(:kwarg, [node.name], node, source, buffer_name)
+        build_node(:kwarg, [parameter_name(node)], node, source, buffer_name)
       when Prism::OptionalKeywordParameterNode
-        build_node(:kwoptarg, [node.name, adapt(node.value, source, buffer_name)], node, source, buffer_name)
+        build_node(:kwoptarg, [parameter_name(node), adapt(node.value, source, buffer_name)], node, source, buffer_name)
       else
-        build_node(:arg, [node.name], node, source, buffer_name)
+        build_node(:arg, [parameter_name(node)], node, source, buffer_name)
       end
     end
 

data/lib/fast/scan.rb

@@ -25,10 +25,14 @@ module Fast
     def scan
       files = Fast.ruby_files_from(*@locations)
       grouped = files.each_with_object(Hash.new { |hash, key| hash[key] = [] }) do |file, memo|
-        entries = flatten_entries(Fast.summary(IO.read(file), file: file, command_name: @command_name).outline)
-        next if entries.empty?
+        begin
+          entries = flatten_entries(Fast.summary(IO.read(file), file: file, command_name: @command_name).outline)
+          next if entries.empty?
 
-        memo[classify(file, entries)] << [file, entries]
+          memo[classify(file, entries)] << [file, entries]
+        rescue StandardError => e
+          warn "Error scanning #{file}: #{e.message}" if Fast.debugging
+        end
       end
 
       print_grouped(grouped)

data/lib/fast/summary.rb

@@ -21,7 +21,12 @@ module Fast
         if unsupported_template?
           nil
         elsif code_or_ast.is_a?(String)
-          Fast.parse_ruby(code_or_ast, buffer_name: file || '(string)')
+          begin
+            Fast.parse_ruby(code_or_ast, buffer_name: file || '(string)')
+          rescue StandardError => e
+            warn "Error parsing #{file || 'source'}: #{e.message}" if Fast.debugging
+            nil
+          end
         else
           code_or_ast
         end

data/lib/fast/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fast
-  VERSION = '0.2.3'
+  VERSION = '0.2.6'
 end

data/lib/fast.rb

@@ -220,12 +220,24 @@ module Fast
     # @return [Hash[String, Array]] with files and results
     def group_results(group_files, locations, parallel: true)
       files = ruby_files_from(*locations)
-      if parallel
-        require 'parallel' unless defined?(Parallel)
-        Parallel.map(files, &group_files)
-      else
-        files.map(&group_files)
-      end.compact.inject(&:merge!)
+      results =
+        if parallel
+          require 'parallel' unless defined?(Parallel)
+          Parallel.map(files) do |file|
+            group_files.call(file)
+          rescue StandardError => e
+            warn "Error processing #{file}: #{e.message}" if Fast.debugging
+            nil
+          end
+        else
+          files.map do |file|
+            group_files.call(file)
+          rescue StandardError => e
+            warn "Error processing #{file}: #{e.message}" if Fast.debugging
+            nil
+          end
+        end
+      results.compact.inject(&:merge!) || {}
     end
 
     # Capture elements from searches in files. Keep in mind you need to use `$`
@@ -275,7 +287,11 @@ module Fast
     end
 
     def expression(string)
-      ExpressionParser.new(string).parse
+      parser = ExpressionParser.new(string)
+      res = parser.parse
+      raise SyntaxError, parser.error_message if parser.tokens_left?
+
+      res
     end
 
     attr_accessor :debugging
@@ -444,6 +460,7 @@ module Fast
     # @param expression [String]
     def initialize(expression)
       @tokens = expression.scan TOKENIZER
+      @nesting = []
     end
 
     # rubocop:disable Metrics/CyclomaticComplexity
@@ -451,22 +468,43 @@ module Fast
     # rubocop:disable Metrics/MethodLength
     def parse
       case (token = next_token)
-      when '(' then parse_until_peek(')')
-      when '{' then Any.new(parse_until_peek('}'))
-      when '[' then All.new(parse_until_peek(']'))
+      when '('
+        @nesting << ')'
+        parse_until_peek(')')
+      when '{'
+        @nesting << '}'
+        Any.new(parse_until_peek('}'))
+      when '['
+        @nesting << ']'
+        All.new(parse_until_peek(']'))
+      when ')', '}', ']'
+        raise SyntaxError, "Unexpected token: #{token}"
       when /^"/ then FindString.new(token[1..-2])
       when /^#\w/ then MethodCall.new(token[1..])
       when /^\.\w[\w\d_]+\?/ then InstanceMethodCall.new(token[1..])
       when '$' then Capture.new(parse)
-      when '!' then (@tokens.any? ? Not.new(parse) : Find.new(token))
+      when '!' then (@tokens.any? && !closing_token?(@tokens.first) ? Not.new(parse) : Find.new(token))
       when '?' then Maybe.new(parse)
       when '^' then Parent.new(parse)
       when '\\' then FindWithCapture.new(parse)
       when /^%\d/ then FindFromArgument.new(token[1..])
+      when nil then nil
       else Find.new(token)
       end
     end
 
+    def tokens_left?
+      @tokens.any? || @nesting.any?
+    end
+
+    def error_message
+      if @tokens.any?
+        "Unconsumed tokens after parsing: #{@tokens.join(' ')}"
+      elsif @nesting.any?
+        "Unclosed nesting: expected #{@nesting.reverse.join(', ')}"
+      end
+    end
+
     # rubocop:enable Metrics/CyclomaticComplexity
     # rubocop:enable Metrics/AbcSize
     # rubocop:enable Metrics/MethodLength
@@ -477,10 +515,19 @@ module Fast
       @tokens.shift
     end
 
+    def closing_token?(token)
+      [')', '}', ']'].include?(token)
+    end
+
     def parse_until_peek(token)
       list = []
       list << parse until @tokens.empty? || @tokens.first == token
-      next_token
+      last = next_token
+      if last == token
+        @nesting.pop
+      else
+        raise SyntaxError, "Expected #{token} but got #{last || 'end of string'}"
+      end
       list
     end
   end
@@ -501,10 +548,15 @@ module Fast
       case expression
       when Proc then expression.call(node)
       when Find then expression.match?(node)
-      when Symbol then compare_symbol_or_head(expression, node)
       when Enumerable
-        expression.each_with_index.all? do |exp, i|
-          match_recursive(exp, i.zero? ? node : node.children[i - 1])
+        if expression.last == :'...' || expression.last.is_a?(Find) && expression.last.token == '...'
+          expression[0...-1].each_with_index.all? do |exp, i|
+            match_recursive(exp, i.zero? ? node : node.children[i - 1])
+          end
+        else
+          expression.each_with_index.all? do |exp, i|
+            match_recursive(exp, i.zero? ? node : node.children[i - 1])
+          end
         end
       else
         node == expression
@@ -721,7 +773,7 @@ module Fast
   #   Fast.expression("{int float}")
   class Any < Find
     def match?(node)
-      token.any? { |expression| Fast.match?(expression, node) }
+      token.any? { |expression| !!Fast.match?(expression, node) }
     end
 
     def to_s
@@ -732,7 +784,7 @@ module Fast
   # Intersect expressions. Works like a **AND** operator.
   class All < Find
     def match?(node)
-      token.all? { |expression| expression.match?(node) }
+      token.all? { |expression| !!expression.match?(node) }
     end
 
     def to_s
@@ -798,10 +850,17 @@ module Fast
 
     # @return [true] if all children matches with tail
     def match_tail?(tail, child)
-      tail.each_with_index.all? do |token, i|
-        prepare_token(token)
-        token.is_a?(Array) ? match?(token, child[i]) : token.match?(child[i])
-      end && find_captures
+      if tail.last.is_a?(Find) && tail.last.token == '...'
+        tail[0...-1].each_with_index.all? do |token, i|
+          prepare_token(token)
+          token.is_a?(Array) ? match?(token, child[i]) : token.match?(child[i])
+        end && find_captures
+      else
+        tail.each_with_index.all? do |token, i|
+          prepare_token(token)
+          token.is_a?(Array) ? match?(token, child[i]) : token.match?(child[i])
+        end && find_captures
+      end
     end
 
     # Look recursively into @param expression to check if the expression is have

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ffast
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.6
 platform: ruby
 authors:
 - Jônatas Davi Paganini
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-03-30 00:00:00.000000000 Z
+date: 2026-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: coderay
@@ -240,25 +240,15 @@ email:
 executables:
 - fast
 - fast-experiment
+- fast-mcp
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/release.yml"
-- ".github/workflows/ruby.yml"
-- ".gitignore"
-- ".projections.json"
-- ".rspec"
-- ".rubocop.yml"
-- ".sourcelevel.yml"
-- ".travis.yml"
+- ".agents/fast-pattern-expert/SKILL.md"
 - CODE_OF_CONDUCT.md
 - Fastfile
-- Gemfile
-- Guardfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- TODO.md
 - bin/console
 - bin/fast
 - bin/fast-experiment
@@ -281,8 +271,6 @@ files:
 - lib/fast/sql/rewriter.rb
 - lib/fast/summary.rb
 - lib/fast/version.rb
-- mkdocs.yml
-- requirements-docs.txt
 homepage: https://jonatas.github.io/fast/
 licenses:
 - MIT
@@ -306,7 +294,6 @@ post_install_message: |2+
 rdoc_options: []
 require_paths:
 - lib
-- experiments
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.github/workflows/release.yml

@@ -1,27 +0,0 @@
-name: Release Gem
-
-on:
-  push:
-    tags:
-      - 'v*' # Triggers when a new tag like v0.2.0 is pushed
-
-jobs:
-  release:
-    name: Build and Release
-    runs-on: ubuntu-22.04
-    permissions:
-      contents: read     # Required to checkout the code
-      id-token: write    # Required for RubyGems Trusted Publishing
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.3'
-          bundler-cache: true
-
-      - name: Publish to RubyGems
-        uses: rubygems/release-gem@v1

data/.github/workflows/ruby.yml

@@ -1,34 +0,0 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
-# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
-
-name: Ruby
-
-on:
-  push:
-    branches: [ "master" ]
-  pull_request:
-    branches: [ "master" ]
-
-permissions:
-  contents: read
-
-jobs:
-  test:
-    runs-on: ubuntu-22.04
-    strategy:
-      matrix:
-        ruby-version: ['3.0', '3.1', '3.2', '3.3']
-
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby-version }}
-        bundler-cache: true
-    - name: Run tests
-      run: bundle exec rake

data/.gitignore

@@ -1,14 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/site/
-/spec/reports/
-/tmp/
-.venv/
-
-# rspec failure tracking
-.rspec_status

data/.projections.json

@@ -1,4 +0,0 @@
-{
-  "README.md": { "type": "readme" },
-  "lib/*.rb": { "type": "lib", "alternate": "spec/{}_spec.rb" }
-}

data/.rspec

@@ -1,2 +0,0 @@
---format documentation
---color

data/.rubocop.yml

@@ -1,160 +0,0 @@
-# This is the configuration used to check the rubocop source code.
-
-require:
-  - rubocop-rspec
-  - rubocop-performance
-
-AllCops:
-  Exclude:
-    - 'tmp/**/*'
-    - 'examples/*'
-  TargetRubyVersion: 2.6
-
-Layout/LineLength:
-  Enabled: false
-
-Layout/EmptyLinesAroundAttributeAccessor:
-  Enabled: false
-
-Layout/SpaceAroundMethodCallOperator:
-  Enabled: false
-
-Lint/BinaryOperatorWithIdenticalOperands:
-  Enabled: true
-
-Lint/DuplicateElsifCondition:
-  Enabled: false
-
-Lint/DuplicateRescueException:
-  Enabled: false
-
-Lint/EmptyConditionalBody:
-  Enabled: false
-
-Lint/FloatComparison:
-  Enabled: false
-
-Lint/MissingSuper:
-  Enabled: false
-
-Lint/OutOfRangeRegexpRef:
-  Enabled: false
-
-Lint/SelfAssignment:
-  Enabled: false
-
-Lint/TopLevelReturnWithArgument:
-  Enabled: false
-
-Lint/UnreachableLoop:
-  Enabled: false
-
-
-Lint/DeprecatedOpenSSLConstant:
-  Enabled: false
-
-Lint/MixedRegexpCaptureTypes:
-  Enabled: false
-
-Lint/RaiseException:
-  Enabled: true
-
-Lint/StructNewOverride:
-  Enabled: true
-
-Style/AccessorGrouping:
-  Enabled: false
-
-Style/ArrayCoercion:
-  Enabled: false
-
-Style/BisectedAttrAccessor:
-  Enabled: true
-
-Style/CaseLikeIf:
-  Enabled: true
-
-Style/ExplicitBlockArgument:
-  Enabled: false
-
-Style/ExponentialNotation:
-  Enabled: true
-
-Style/GlobalStdStream:
-  Enabled: false
-
-Style/HashAsLastArrayItem:
-  Enabled: false
-
-Style/HashLikeCase:
-  Enabled: true
-
-Style/OptionalBooleanParameter:
-  Enabled: true
-
-Style/RedundantAssignment:
-  Enabled: true
-
-Style/RedundantFetchBlock:
-  Enabled: true
-
-Style/RedundantFileExtensionInRequire:
-  Enabled: true
-
-Style/SingleArgumentDig:
-  Enabled: true
-
-Style/StringConcatenation:
-  Enabled: true
-
-Style/RedundantRegexpCharacterClass:
-  Enabled: false
-
-Style/RedundantRegexpEscape:
-  Enabled: false
-
-Style/SlicingWithRange:
-  Enabled: true
-
-Metrics/BlockLength:
-  Exclude:
-    - 'spec/**/*'
-    - 'fast.gemspec'
-
-Lint/InterpolationCheck:
-  Exclude:
-    - 'spec/**/*'
-
-Metrics/MethodLength:
-  CountComments: false  # count full line comments?
-  Max: 12
-
-Metrics/ModuleLength:
-  Enabled: false
-
-Layout/MultilineMethodCallIndentation:
-  EnforcedStyle: 'indented'
-
-RSpec/NestedGroups:
-  Max: 4
-
-RSpec/ExampleLength:
-  Max: 20
-
-RSpec/MultipleExpectations:
-  Enabled: false
-
-RSpec/DescribedClass:
-  Enabled: false
-
-RSpec/ImplicitSubject:
-  Enabled: false
-
-Style/HashEachMethods:
-  Enabled: true
-
-Style/HashTransformKeys:
-  Enabled: true
-
-Style/HashTransformValues:
-  Enabled: true

data/.sourcelevel.yml

@@ -1,2 +0,0 @@
-pull_requests:
-  comments: false

data/.travis.yml

@@ -1,18 +0,0 @@
-sudo: false
-language: ruby
-env:
-  global:
-    - CC_TEST_REPORTER_ID=cf3977cb8c335147723d765c91877e0506ba43e56a22a0dc5b83d7fb969cf5e4
-rvm:
-  - 2.6.3
-before_install:
-  gem install bundler -v 2.1.4
-before_script:
-  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
-  - chmod +x ./cc-test-reporter
-  - ./cc-test-reporter before-build
-after_script:
-  - ./cc-test-reporter after-build -t simplecov --exit-code $TRAVIS_TEST_RESULT
-script:
-  - bundle exec rubocop --fail-level warning --display-only-fail-level-offenses
-  - bundle exec rspec

data/Gemfile

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in fast.gemspec
-gemspec

data/Guardfile

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-# A sample Guardfile
-# More info at https://github.com/guard/guard#readme
-
-## Uncomment and set this to only include directories you want to watch
-# directories %w(app lib config test spec features) \
-#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
-
-## Note: if you are using the `directories` clause above and you are not
-## watching the project directory ('.'), then you will want to move
-## the Guardfile to a watched dir and symlink it back, e.g.
-#
-#  $ mkdir config
-#  $ mv Guardfile config/
-#  $ ln -s config/Guardfile .
-#
-# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
-
-guard 'livereload' do
-  watch(%r{lib/.+\.rb$})
-end
-
-guard :rspec, cmd: 'bundle exec rspec' do
-  require 'guard/rspec/dsl'
-  dsl = Guard::RSpec::Dsl.new(self)
-
-  # Feel free to open issues for suggestions and improvements
-
-  # RSpec files
-  rspec = dsl.rspec
-  watch(rspec.spec_helper) { rspec.spec_dir }
-  watch(rspec.spec_support) { rspec.spec_dir }
-  watch(rspec.spec_files)
-
-  # Ruby files
-  ruby = dsl.ruby
-  dsl.watch_spec_files_for(ruby.lib_files)
-end

data/Rakefile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new(:spec)
-
-task default: :spec

data/TODO.md

@@ -1,3 +0,0 @@
-- [ ] Add matcher diagnostics. Allow check details of each matcher in the three
-- [ ] Split stuff into files and add tests for each class
-- [ ] Validate expressions and raise errors for invalid expressions

data/mkdocs.yml

@@ -1,51 +0,0 @@
-site_name: Fast
-repo_url: https://github.com/jonatas/fast
-edit_uri: edit/master/docs/
-
-extra:
-  analytics:
-    provider: google
-    property: G-YKZDZDNRG2
-
-theme:
-  name: material
-  palette:
-    primary: indigo
-    accent: pink
-  logo: assets/logo.png
-  favicon: assets/favicon.png
-extra_css:
-  - stylesheets/custom.css
-
-plugins:
-  - search
-
-markdown_extensions:
-  - admonition
-  - pymdownx.details
-  - pymdownx.superfences
-  - pymdownx.tabbed:
-      alternate_style: true
-  - toc:
-      permalink: true
-nav:
-  - Introduction: index.md
-  - Walkthrough: walkthrough.md
-  - Syntax: syntax.md
-  - Command Line: command_line.md
-  - Experiments: experiments.md
-  - Shortcuts: shortcuts.md
-  - Git Integration: git.md
-  - Fast for LLMs and Agents: agents.md
-  - MCP Server Tutorial: mcp_tutorial.md
-  - Code Similarity: similarity_tutorial.md
-  - LLM/Agent Feature TODOs: llm_features.md
-  - Pry Integration: pry-integration.md
-  - Editors' Integration: editors-integration.md
-  - Research: research.md
-  - Ideas: ideas.md
-  - Videos: videos.md
-  - SQL:
-    - Intro: sql/index.md
-    - Shortcuts: sql/shortcuts.md
-    - About: sql-support.md

data/requirements-docs.txt

@@ -1,3 +0,0 @@
-mkdocs>=1.6,<2.0
-mkdocs-material>=9.5,<10.0
-pymdown-extensions>=10.0,<11.0