ffast 0.2.4 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b5b5e27292bfe589236ccf40952b5da73f4dfc4b35df85220d9beebae7c725e
-  data.tar.gz: 6c4466b554e164c447cfb02760c5b6cd262c0f904f7ea8c35897288efa4668ec
+  metadata.gz: 95125c92ee4201a508f422f041be2a63aebe3a92a19ca303d85b1be98ab6f1e0
+  data.tar.gz: 137a7d81790b9f51aaeea271d4d803b6b33a158f7f4b9f4c8a007a23131e6f05
 SHA512:
-  metadata.gz: 0f8ccd9bcd621b69847fd1092b0fa08cada32258a2ec1f6b04654744c8930718628955698673577e4431a6fe6146da744bcb6aafdada442aa08bfe8e5ba32780
-  data.tar.gz: 263b032df9ed1ea5b8d7cd71e1bd613dc781c53fc1dd10cb8bedbe526d904543e1331bb43f345679954e7ebc404b0bdfb5f965dffd35b74c454038ba7ae0fb31
+  metadata.gz: 9b1cb25bf21ef812530856cd778b8d875df7498bc9aaa6576c215964c75dc189131f8fdb539b18eec54b8c44fc3033099b74d457135f77feeff6d5f1ebb34405
+  data.tar.gz: 256b3549dd55c412ad1a5d2d84b7d284f4fb94f10096f56a02391ae4e67f4e40894ad1816ab997f7dd08b99b36aa90b9eb68ce3101fa8bba0fb0ba7185329761

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

@@ -106,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
@@ -146,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
 

data/lib/fast/version.rb

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

data/lib/fast.rb

@@ -548,7 +548,6 @@ 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
         if expression.last == :'...' || expression.last.is_a?(Find) && expression.last.token == '...'
           expression[0...-1].each_with_index.all? do |exp, i|
@@ -774,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
@@ -785,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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ffast
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
 platform: ruby
 authors:
 - Jônatas Davi Paganini
@@ -240,33 +240,21 @@ email:
 executables:
 - fast
 - fast-experiment
+- fast-mcp
 extensions: []
 extra_rdoc_files: []
 files:
 - ".agents/fast-pattern-expert/SKILL.md"
-- ".github/workflows/release.yml"
-- ".github/workflows/ruby.yml"
-- ".gitignore"
-- ".projections.json"
-- ".rspec"
-- ".rubocop.yml"
-- ".sourcelevel.yml"
-- ".travis.yml"
 - CODE_OF_CONDUCT.md
 - Fastfile
-- Gemfile
-- Guardfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- TODO.md
 - bin/console
 - bin/fast
 - bin/fast-experiment
 - bin/fast-mcp
 - bin/setup
 - fast.gemspec
-- ideia_blog_post.md
 - lib/fast.rb
 - lib/fast/cli.rb
 - lib/fast/experiment.rb
@@ -283,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
@@ -308,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/ideia_blog_post.md

@@ -1,36 +0,0 @@
-# Empowering LLM Agents with Natural Language to Fast Patterns
-
-Today I'm excited to announce a significant set of improvements to `fast`, specifically designed to bridge the gap between human reasoning (and LLM agents) and the technical precision of Ruby AST searching.
-
-## The Problem: AST Patterns are Hard
-
-Searching through code using AST patterns is incredibly powerful, but constructing the right S-expression can be daunting. Whether you're a human or an AI agent, getting the syntax just right—especially for complex queries—often involves a lot of trial and error.
-
-## The Solution: NL-to-Fast Translation
-
-We've introduced three new tools to solve this:
-
-1.  **The `fast-pattern-expert` Skill**: A specialized Gemini CLI skill that provides deep guidance, syntax references, and few-shot examples for translating structural descriptions of Ruby code into valid `Fast` patterns.
-2.  **`validate_fast_pattern` MCP Tool**: A new tool for our Model Context Protocol (MCP) server that allows agents to verify their generated patterns before executing them.
-3.  **`--validate-pattern` CLI Flag**: A quick way for humans to check if their pattern syntax is correct, checking for balanced nesting and valid token types.
-
-### Example in Action:
-**Query:** "Find all classes that inherit from `BaseService` and have a `call` method."
-**Pattern:** `[(class _ (const nil BaseService)) (def call)]`
-
-## Robustness and Precision
-
-We've also beefed up the core of `fast`:
-- **Stricter Validation**: The `ExpressionParser` now tracks nesting levels and unconsumed tokens, providing helpful error messages instead of silently failing or returning partial matches.
-- **Improved `...` Matcher**: The `...` literal now acts as a "rest-of-children" matcher when used at the end of a pattern, making it much easier to match methods with any number of arguments.
-- **Graceful Degradation**: Multi-file scans (`.scan`) now degrade gracefully if a single file fails to parse, ensuring your reconnaissance isn't aborted by one unsupported syntax node.
-
-## A Safer Release Workflow
-
-On the operational side, I'm moving our gem release process to **GitHub Actions**. By releasing from a clean CI sandbox instead of my local machine, we ensure a much higher level of security and reproducibility. This move minimizes the risk of local environment contamination and provides a transparent, auditable path from source to RubyGems.
-
-## Release 0.2.4
-
-To celebrate these features, we are releasing version `0.2.4` today!
-
-Happy searching!

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