pronto-biome 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 57ca77c94be204ad36c90e034a117d941bdc8ab3368e1e67d526c53361bdde1b
+  data.tar.gz: 71dbd07795b5b7ffa7b9e20606806d76a521d72f383506727886554fa397eac7
+SHA512:
+  metadata.gz: e1083f41cd10780e95e2c542f29484fead24417bfdfab96e2df4e89b139f7848875916e37283faaa73fcda3aaf1edfc7331f44c43a8b093487dde69e4154a639
+  data.tar.gz: c79448534bbb95e031db3a47d75e54e6a11334364545ee7205d56c9fb2abc0e6b7bb3a7ecda810984acfa74c10dbf397125a8e22454e083f832a056226ef2dbe

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-01-09
+
+### Added
+
+- Pronto runner for Biome linter
+- Support for JS, TS, JSX, TSX, JSON files
+- Configuration via `.pronto.yml` or `.pronto_biome.yml`
+- `BIOME_EXECUTABLE` environment variable

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sbastien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,104 @@
+# pronto-biome
+
+[![Gem Version](https://badge.fury.io/rb/pronto-biome.svg)](https://badge.fury.io/rb/pronto-biome)
+[![CI](https://github.com/Sbastien/pronto-biome/actions/workflows/ci.yml/badge.svg)](https://github.com/Sbastien/pronto-biome/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> [Pronto](https://github.com/prontolabs/pronto) runner for [Biome](https://biomejs.dev/) — lint only the lines you changed.
+
+---
+
+## Why pronto-biome?
+
+Traditional linters report **all errors** in modified files. This creates noise in legacy codebases and slows down code reviews.
+
+**pronto-biome** only reports errors on the **exact lines you modified**, making it perfect for:
+
+- 🎯 **Gradual adoption** — Introduce Biome without fixing thousands of pre-existing issues
+- 🔍 **Focused reviews** — See only what matters in your PR
+- 🚀 **CI integration** — Post inline comments directly on GitHub PRs
+
+---
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'pronto-biome'
+```
+
+Then install dependencies:
+
+```bash
+bundle install
+npm install -D @biomejs/biome  # or: pnpm add -D @biomejs/biome
+```
+
+---
+
+## Usage
+
+```bash
+# Lint changes since origin/main
+pronto run -c origin/main --runner biome
+
+# Lint staged changes only
+pronto run --staged --runner biome
+
+# Post comments on GitHub PR
+pronto run -c origin/main -f github_pr --runner biome
+```
+
+---
+
+## Configuration
+
+### Option 1: `.pronto.yml` (recommended)
+
+```yaml
+biome:
+  biome_executable: npx biome
+  cmd_line_opts: '--config-path=custom-biome.json'
+```
+
+### Option 2: `.pronto_biome.yml` (takes priority)
+
+```yaml
+biome_executable: ./node_modules/.bin/biome
+```
+
+### Options
+
+| Option             | Description                    | Default  |
+|--------------------|--------------------------------|----------|
+| `biome_executable` | Command to run Biome           | `biome`  |
+| `cmd_line_opts`    | Additional Biome CLI options   | *(none)* |
+
+> **Note:** File filtering is handled by Biome's own configuration (`biome.json`). Use Biome's `include`/`exclude` options to control which files are linted.
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `BIOME_EXECUTABLE` | Override the Biome executable (useful for CI/CD) |
+
+---
+
+## Requirements
+
+| Dependency | Version |
+|------------|---------|
+| Ruby | >= 3.1 |
+| Pronto | ~> 0.11.0 |
+| Biome | Any version |
+
+---
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/Sbastien/pronto-biome).
+
+## License
+
+[MIT License](LICENSE)

data/lib/pronto/biome/added_line_resolver.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Pronto
+  class Biome < Runner
+    # Finds the first added line within a given line range in a patch.
+    #
+    # When Biome reports a diagnostic spanning multiple lines, we need to
+    # find the first added line within that range to attach the Pronto message.
+    # We search from the end of the range to find the most relevant line
+    # (typically where the error actually occurs).
+    class AddedLineResolver
+      def initialize(patch)
+        @patch = patch
+        @added_lines_by_lineno = index_added_lines
+      end
+
+      # Finds the first added line within the given range.
+      # Returns nil if no added line exists in the range.
+      def find_in_range(line_range)
+        line_range.to_a.reverse_each do |lineno|
+          line = @added_lines_by_lineno[lineno]
+          return line if line
+        end
+        nil
+      end
+
+      private
+
+      def index_added_lines
+        @patch.added_lines.each_with_object({}) do |line, hash|
+          hash[line.new_lineno] = line
+        end
+      end
+    end
+  end
+end

data/lib/pronto/biome/config.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+module Pronto
+  class Biome < Runner
+    # Configuration management for pronto-biome.
+    #
+    # Configuration sources (in priority order):
+    # 1. Environment variables (highest priority)
+    # 2. .pronto_biome.yml - Runner-specific config
+    # 3. .pronto.yml under 'biome' key - Global Pronto config
+    # 4. Built-in defaults
+    #
+    # Environment variables:
+    # - BIOME_EXECUTABLE: Command to run Biome
+    #
+    # Available options:
+    # - biome_executable: Command to run Biome (default: 'biome')
+    # - cmd_line_opts: Additional CLI options for Biome
+    class Config
+      CONFIG_FILE = '.pronto_biome.yml'
+
+      attr_reader :biome_executable, :cmd_line_opts
+
+      def initialize(repo_path)
+        options = load_options(repo_path)
+
+        @biome_executable = resolve_executable(options).freeze
+        @cmd_line_opts = (options['cmd_line_opts'] || '').freeze
+
+        freeze
+      end
+
+      private
+
+      def load_options(repo_path)
+        pronto_config.merge(load_runner_config(repo_path))
+      end
+
+      # Global Pronto config from .pronto.yml
+      def pronto_config
+        Pronto::ConfigFile.new.to_h['biome'] || {}
+      end
+
+      # Runner-specific config from .pronto_biome.yml
+      def load_runner_config(repo_path)
+        config_file = File.join(repo_path, CONFIG_FILE)
+        return {} unless File.exist?(config_file)
+
+        YAML.safe_load_file(config_file, permitted_classes: [Regexp]) || {}
+      end
+
+      def resolve_executable(options)
+        ENV.fetch('BIOME_EXECUTABLE', nil) || options['biome_executable'] || 'biome'
+      end
+    end
+  end
+end

data/lib/pronto/biome/diff_parser.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Pronto
+  class Biome < Runner
+    # Parses Biome's diff structure and provides access to line numbers and changes.
+    #
+    # Biome diff structure:
+    #   {
+    #     "dictionary" => "const x = 1;\n",
+    #     "ops" => [
+    #       { "equalLines" => { "line_count" => 10 } },
+    #       { "diffOp" => { "delete" => { "range" => [0, 5] } } }
+    #     ]
+    #   }
+    class DiffParser
+      MAX_CHANGES = 3
+
+      attr_reader :first_change_line, :changes
+
+      def initialize(diagnostic)
+        @diff = diagnostic.dig('advices', 'advices', 0, 'diff')
+        @first_change_line = 1
+        @changes = []
+        @found_first_change = false
+
+        parse if valid?
+      end
+
+      def valid? = !@diff.nil? && @diff.key?('dictionary') && @diff.key?('ops')
+
+      private
+
+      def parse
+        @current_line = 1
+        @diff['ops'].each { |op| process(op) }
+      end
+
+      def process(op)
+        if (count = op.dig('equalLines', 'line_count'))
+          @current_line += count
+        elsif (range = op.dig('diffOp', 'equal', 'range'))
+          @current_line += newline_count(range)
+        elsif (range = op.dig('diffOp', 'delete', 'range'))
+          handle_change(:delete, range)
+        elsif (range = op.dig('diffOp', 'insert', 'range'))
+          handle_change(:insert, range)
+        end
+      end
+
+      def handle_change(type, range)
+        unless @found_first_change
+          @first_change_line = @current_line + 1
+          @found_first_change = true
+        end
+        record_change(type, range)
+      end
+
+      def newline_count(range)
+        text = dictionary_text(range)
+        text&.count("\n") || 0
+      end
+
+      def record_change(type, range)
+        return if @changes.size >= MAX_CHANGES
+
+        text = dictionary_text(range)
+        return unless text && !text.strip.empty?
+
+        label = type == :delete ? 'remove' : 'add'
+        change = "#{label} `#{text.inspect[1..-2]}`"
+        @changes << change unless @changes.include?(change)
+      end
+
+      def dictionary_text(range) = @diff['dictionary'][range[0]...range[1]]
+    end
+  end
+end

data/lib/pronto/biome/executor.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'open3'
+require 'shellwords'
+
+module Pronto
+  class Biome < Runner
+    # Executes Biome in batch mode and parses its JSON output.
+    #
+    # Runs Biome once on all files and groups diagnostics by file path.
+    # This is more efficient than running Biome separately for each file.
+    #
+    # Handles various edge cases:
+    # - JSON wrapped in tool output (yarn, npx, etc.)
+    # - Missing Biome executable
+    # - Invalid JSON output
+    # - Empty diagnostics
+    class Executor
+      def initialize(config, repo_path)
+        @config = config
+        @repo_path = repo_path
+        @results = nil
+      end
+
+      # Runs Biome on all given files and returns a hash of {file_path => diagnostics}.
+      # Results are cached - subsequent calls return the cached results.
+      # Returns an empty hash on any error (missing executable, invalid JSON, etc.)
+      def run(file_paths)
+        @results ||= execute_biome(file_paths)
+      end
+
+      # Returns diagnostics for a specific file path.
+      def diagnostics_for(file_path)
+        return [] unless @results
+
+        @results[file_path] || []
+      end
+
+      # Clears the result cache. Useful for testing.
+      def clear_cache
+        @results = nil
+      end
+
+      private
+
+      def execute_biome(file_paths)
+        return {} if file_paths.empty?
+
+        Dir.chdir(@repo_path) { run_and_parse(file_paths) }
+      rescue JSON::ParserError => e
+        log_warning("Failed to parse Biome output: #{e.message}")
+        {}
+      rescue Errno::ENOENT => e
+        log_warning("Biome executable not found (#{@config.biome_executable}): #{e.message}")
+        {}
+      end
+
+      def run_and_parse(file_paths)
+        stdout, stderr, status = Open3.capture3(*build_command(file_paths))
+
+        log_warning("Biome stderr: #{stderr}") if stderr && !stderr.empty?
+
+        if stdout.empty?
+          log_warning("Biome exited with code #{status.exitstatus}") unless status.success?
+          return {}
+        end
+
+        parse_output(stdout)
+      end
+
+      def build_command(file_paths)
+        [
+          *Shellwords.split(@config.biome_executable),
+          'check',
+          *Shellwords.split(@config.cmd_line_opts),
+          '--reporter=json',
+          *file_paths
+        ].reject(&:empty?)
+      end
+
+      # Parses Biome JSON output and groups diagnostics by file path.
+      #
+      # When Biome is invoked through yarn/npx, the output may include
+      # extra lines before/after the JSON. We find the JSON line by
+      # looking for a line starting with '{'.
+      def parse_output(output)
+        output.lines.each do |line|
+          next unless line.start_with?('{')
+
+          result = JSON.parse(line)
+          return group_by_file(result['diagnostics']) if result['diagnostics']
+
+          log_warning('Biome output missing diagnostics key')
+          return {}
+        end
+        {}
+      end
+
+      def group_by_file(diagnostics)
+        diagnostics.each_with_object(Hash.new { |h, k| h[k] = [] }) do |diagnostic, grouped|
+          path = diagnostic.dig('location', 'path', 'file')
+          grouped[path] << diagnostic if path
+        end
+      end
+
+      def log_warning(message) = warn "[pronto-biome] #{message}"
+    end
+  end
+end

data/lib/pronto/biome/offense.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require_relative 'diff_parser'
+
+module Pronto
+  class Biome < Runner
+    # Converts a Biome diagnostic into an offense with line range, level, and message.
+    #
+    # Biome diagnostics come in two flavors:
+    # 1. Lint errors: Have a span (byte offsets) pointing to the exact location
+    # 2. Format errors: No span, but have a diff structure showing what changed
+    class Offense
+      SEVERITY_MAP = {
+        'fatal' => :fatal,
+        'error' => :error,
+        'warning' => :warning,
+        'information' => :info,
+        'hint' => :info
+      }.freeze
+      DEFAULT_SEVERITY = :warning
+
+      attr_reader :line_range, :level, :message
+
+      def initialize(diagnostic)
+        @diagnostic = diagnostic
+        @diff_parser = nil # Lazy loaded only for format diagnostics
+        @line_range = compute_line_range
+        @level = compute_level
+        @message = compute_message
+      end
+
+      def valid? = !@line_range.nil?
+
+      private
+
+      def compute_line_range
+        if span
+          line_range_from_span
+        elsif format_diagnostic?
+          line = diff_parser.first_change_line
+          line..line
+        end
+      end
+
+      def span = @diagnostic.dig('location', 'span')
+
+      def source_code = @diagnostic.dig('location', 'sourceCode')
+
+      def format_diagnostic? = @diagnostic['category'] == 'format'
+
+      def diff_parser
+        @diff_parser ||= DiffParser.new(@diagnostic)
+      end
+
+      # Converts byte offsets to line numbers by counting newlines.
+      def line_range_from_span
+        return nil unless source_code
+
+        start_offset, end_offset = span
+        start_line = source_code[0...start_offset].count("\n") + 1
+        end_line = source_code[0...end_offset].count("\n") + 1
+
+        start_line..end_line
+      end
+
+      def compute_level = SEVERITY_MAP.fetch(@diagnostic['severity'], DEFAULT_SEVERITY)
+
+      def compute_message = format_diagnostic? ? format_message : lint_message
+
+      def lint_message
+        category = @diagnostic['category'] || ''
+        description = @diagnostic['description'] || ''
+        category.empty? ? description : "#{category}: #{description}"
+      end
+
+      def format_message
+        changes = diff_parser.changes
+        return 'File needs formatting. Run `biome check --write` to fix.' if changes.empty?
+
+        "Formatting: #{changes.join(', ')}. Run `biome check --write` to fix."
+      end
+    end
+  end
+end

data/lib/pronto/biome/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Pronto
+  module BiomeVersion
+    VERSION = '0.1.0'
+  end
+end

data/lib/pronto/biome.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'pronto'
+require_relative 'biome/version'
+require_relative 'biome/config'
+require_relative 'biome/executor'
+require_relative 'biome/offense'
+require_relative 'biome/added_line_resolver'
+
+module Pronto
+  # Pronto runner for Biome - a fast linter/formatter for JavaScript, TypeScript, and JSON.
+  #
+  # Runs Biome in batch mode on all changed files and reports diagnostics
+  # only for lines that were added in the current diff.
+  class Biome < Runner
+    def run
+      return [] if @patches.nil? || @patches.none?
+
+      patches_to_lint = @patches.select { |patch| patch.additions.positive? }
+
+      return [] if patches_to_lint.empty?
+
+      # Run Biome once on all files (batch mode)
+      # Use relative paths so Biome returns relative paths in diagnostics
+      file_paths = patches_to_lint.map { |p| p.delta.new_file[:path] }
+      executor.run(file_paths)
+
+      patches_to_lint.flat_map { |patch| inspect(patch) }.compact
+    end
+
+    private
+
+    def biome_config
+      @biome_config ||= Config.new(repo_path)
+    end
+
+    def executor
+      @executor ||= Executor.new(biome_config, repo_path)
+    end
+
+    def repo_path
+      @repo_path ||= @patches.first.repo.path
+    end
+
+    def inspect(patch)
+      # Use relative path to match Biome's output format
+      relative_path = patch.delta.new_file[:path]
+      diagnostics = executor.diagnostics_for(relative_path)
+      resolver = AddedLineResolver.new(patch)
+
+      diagnostics.flat_map do |diagnostic|
+        offense = Offense.new(diagnostic)
+        next unless offense.valid?
+
+        added_line = resolver.find_in_range(offense.line_range)
+        next unless added_line
+
+        new_message(offense, added_line)
+      end
+    end
+
+    def new_message(offense, line)
+      path = line.patch.delta.new_file[:path]
+
+      Message.new(path, line, offense.level, offense.message, nil, self.class)
+    end
+  end
+end

metadata

@@ -0,0 +1,167 @@
+--- !ruby/object:Gem::Specification
+name: pronto-biome
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sbastien
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pronto
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !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: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop-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'
+description: Pronto runner for Biome, reports only on lines changed in the diff
+email:
+- sbastien@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/pronto/biome.rb
+- lib/pronto/biome/added_line_resolver.rb
+- lib/pronto/biome/config.rb
+- lib/pronto/biome/diff_parser.rb
+- lib/pronto/biome/executor.rb
+- lib/pronto/biome/offense.rb
+- lib/pronto/biome/version.rb
+homepage: https://github.com/Sbastien/pronto-biome
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/Sbastien/pronto-biome/issues
+  changelog_uri: https://github.com/Sbastien/pronto-biome/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/Sbastien/pronto-biome
+  source_code_uri: https://github.com/Sbastien/pronto-biome
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Pronto runner for Biome linter
+test_files: []