sonicop 26.8.101-aarch64-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b1298b2be973ee50f74c784c1d35d4f0b6a7fdb015bd8ac9d8677d07fb88ba0c
+  data.tar.gz: 3baadbdd3a5d6f10099820bc6b4d0cd890080b119b634b3c8dda391edb509e6d
+SHA512:
+  metadata.gz: 39960db7a2d0ef1d1f30e0687a5a0f0a1c58333f1ed2516339b866c43beb5b62c82928e3fd47fcdd971648bcef5dbe00c248a4003ff5bb0114f504b6c3bbdf55
+  data.tar.gz: 3cdd38531491001e03abb895f4af8600999c9f267031c59d21a7b113c762adfd2ff5c997377dc16579898dc0b51dc0684f418a1f8c1fd01dc8099b66aaf705e0

data/CONFORMANCE.md

@@ -0,0 +1,109 @@
+# RuboCop conformance
+
+Snapshot date: 2026-08-10  
+Reference: RuboCop 1.89.0  
+Corpus: the complete 1,759-file RuboCop source tree  
+Configuration: RuboCop 1.89.0 built-in defaults (`--force-default-config`)
+
+The bundled `config/default.yml` records the upstream version it was vendored from in its header.
+Re-fetch it with `scripts/sync_default_yml.sh <rubocop-version>`.
+
+The comparison covers every cop Sonicop implemented at the snapshot date, listed verbatim in the
+`cops` variable of the command below. Each JSON offense is normalized by path, cop, line, column,
+length, severity, correctability, and message. Run `sonicop --show-cops` for the current set.
+
+| Result | Count |
+|---|---:|
+| Reference offense locations | 4,052 |
+| Sonicop offense locations | 4,052 |
+| Matching locations | 4,052 |
+| False positives | **0** |
+| False negatives | **0** |
+| Location recall | **100%** |
+| Message/severity/correctability differences at matching locations | **0** |
+
+All offenses from the implemented cops match RuboCop by location, message, severity, and
+correctability. This includes RuboCop's source-line indexing for metric cops, line-length
+correctability and exemptions, directive lexing around heredocs, and target-version syntax errors.
+
+Run the harness against a local RuboCop and corpus. It defaults to `rubocop` on `PATH`
+(`gem install rubocop`) as the reference and `./target/release/sonicop` (`make release`) as the
+candidate, so both only need `--reference` / `--candidate` when they live elsewhere — for example
+`--reference "bundle exec rubocop"` inside a bundled project:
+
+```bash
+cops="Layout/EmptyLineAfterMagicComment,Layout/EndOfLine,Layout/LineLength,Layout/SpaceAfterComma,Layout/SpaceAroundOperators,Layout/SpaceInsideParens,Layout/TrailingEmptyLines,Layout/TrailingWhitespace,Lint/DuplicateMethods,Lint/Syntax,Lint/UnusedBlockArgument,Lint/UselessAssignment,Metrics/BlockLength,Metrics/ClassLength,Metrics/MethodLength,Metrics/ModuleLength,Metrics/ParameterLists,Naming/AsciiIdentifiers,Naming/ConstantName,Naming/MethodName,Naming/VariableName,Security/Eval,Style/FrozenStringLiteralComment,Style/HashSyntax,Style/NumericLiterals,Style/RedundantReturn,Style/Semicolon,Style/StringLiterals"
+
+scripts/conformance_diff.sh \
+  --force-default-config \
+  --cop "${cops}" \
+  -- /path/to/rubocop
+```
+
+`Lint/Syntax` is also run independently over the corpus. The latest owayo tree-sitter grammar
+accepts the modern syntax in all 1,759 files, while Sonicop resolves Ruby 2.6 from the corpus
+gemspec and applies a post-parse syntax feature gate. Its four fatal offenses, including the legacy
+parser recovery diagnostics, exactly match RuboCop.
+
+## Limits of this measurement
+
+The 100% above is a property of *this corpus*, not a general accuracy claim. RuboCop's own source
+tree is RuboCop-clean and stylistically uniform, so entire classes of input never occur in it and
+the comparison cannot exercise them. A cop that is never triggered contributes nothing to the
+match count, and its absence is indistinguishable from agreement.
+
+Two implemented cops are confirmed to produce **zero offenses on both sides** over this corpus, so
+this run says nothing about them:
+
+| Cop | Offenses in this corpus | Verified elsewhere |
+|---|---:|---|
+| `Layout/TrailingEmptyLines` | 0 | Diverges on line, column, length, and message for a file ending in a blank line |
+| `Naming/AsciiIdentifiers` | 0 | Rails contains exactly two occurrences; both diverge on message casing |
+
+Running the same harness over application code rather than linter source surfaces divergences this
+corpus does not. Treat a clean run on any single corpus as evidence about that corpus.
+
+Two properties of the harness itself also bound what a run can tell you:
+
+- Only the cops passed to `--cop` are compared. Cops that RuboCop reports and Sonicop has not
+  implemented show up as false negatives, which is expected rather than a defect.
+- RuboCop emits **only** `Lint/Syntax` for a file it considers fatally unparseable and suppresses
+  every other cop for that file, while Sonicop keeps inspecting it. Whenever the two disagree
+  about syntax validity — most easily triggered by a `TargetRubyVersion` the source does not
+  satisfy — the false-positive count is dominated by that single behaviour rather than by cop
+  logic. Check the reference output for `"severity": "fatal"` before reading a large false-positive
+  count as a cop problem.
+
+Closing these gaps properly means migrating RuboCop's own spec suite, which exercises each cop
+against inputs written to break it. Until that lands, this document records what was measured, not
+an upper bound on what could differ.
+
+## Rails configuration and scale
+
+Rails source snapshot: `adf307b03b4241cbc0ed3821faf3b153ca6cd5cd` (Rails 8.2.0.alpha).
+The reference process uses RuboCop 1.89.0 with the five plugins declared by Rails:
+rubocop-minitest 0.40.0, rubocop-packaging 0.6.0, rubocop-performance 1.26.1,
+rubocop-rails 2.36.0, and rubocop-md 2.0.4.
+
+This corpus exercises `AllCops/DisabledByDefault`, external plugin cops, recursive excludes,
+hidden paths, and the inherited `guides/.rubocop.yml` configuration.
+
+| Compatibility check | RuboCop | Sonicop | Result |
+|---|---:|---:|---|
+| Ruby target files from repository root | 3,453 | 3,453 | Exact paths and order |
+| Enabled cops for `activerecord/lib/active_record.rb` | 107 | 107 | Exact names and order |
+| Enabled cops for a file under `guides/` | 102 | 102 | Exact names and order |
+| Full-tree false positives | — | 0 | Pass |
+
+RuboCop also discovers 75 Markdown targets through rubocop-md. Markdown extraction is outside
+Sonicop's current parser scope, so those files are removed before comparing `-L` output.
+
+The full 3,453-Ruby-file offense comparison reports 10 reference locations and no Sonicop
+locations: zero false positives and 10 visible false negatives. The missing locations are three
+`Style/RedundantPercentQ`, two `Lint/RedundantCopDisableDirective`, two
+`Layout/IndentationWidth`, two unsupported `Lint/DuplicateMethods` cases, and one
+`Lint/Debugger`. Artifacts: `/tmp/sonicop-conformance-rails-full-2`.
+
+On the 402-file `activerecord/lib` subset, a warmed single run with cache and color disabled took
+4.37 seconds for RuboCop and 0.35 seconds for Sonicop (`/usr/bin/time -p`): approximately
+**12.5x faster** on the validation machine.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yohei
+
+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/NOTICE

@@ -0,0 +1,7 @@
+Sonicop includes and adapts configuration data from RuboCop 1.89.0.
+RuboCop is Copyright (c) 2012-26 Bozhidar Batsov and contributors,
+licensed under the MIT License. See licenses/RUBOCOP.txt.
+
+Sonicop links to owayo/tree-sitter-ruby, derived from tree-sitter-ruby.
+tree-sitter-ruby is Copyright (c) 2016 Rob Rix and contributors,
+licensed under the MIT License. See licenses/TREE_SITTER_RUBY.txt.

data/README.ja.md

@@ -0,0 +1,161 @@
+<h1 align="center">
+  <img src="docs/images/sonicop_logo_header.png" width="600" alt="Sonicop">
+</h1>
+
+<p align="center">
+  <strong>Rust で実装した高速なネイティブ RuboCop 互換 Ruby リンター／フォーマッター。</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/owayo/sonicop/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/owayo/sonicop/actions/workflows/ci.yml/badge.svg?branch=main"></a>
+  <a href="https://rubygems.org/gems/sonicop"><img alt="Gem Version" src="https://img.shields.io/gem/v/sonicop"></a>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/owayo/sonicop"></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ja.md">日本語</a>
+</p>
+
+---
+
+## 概要
+
+Sonicop は、Ruby プロセスを起動せずに動作する高速な Rust 製 Ruby リンター／フォーマッターです。
+既存の `.rubocop.yml` をそのまま利用でき、サブディレクトリごとの設定、設定の継承、対象ファイルの
+Include／Exclude、severity、自動修正設定にも対応しています。
+
+最新の Ruby 構文へ追従する
+[owayo/tree-sitter-ruby](https://github.com/owayo/tree-sitter-ruby) を使い、ファイルを並列に検査して
+修正をアトミックに適用します。RuboCop 1.89 互換の CLI と JSON 出力により、既存のエディタや
+CI へ最小限の変更で導入できます。
+
+## 主な機能
+
+Layout、Lint、Metrics、Naming、Security、Style の各部門の Cop を実装しています。
+実装済みの Cop はリリースごとに増えるため、一覧はバイナリ自身が正本です。
+
+```bash
+# 認識済み Cop と実装状況の一覧
+sonicop --show-cops
+```
+
+RuboCop 1.89 の全 609 Cop を同梱設定として認識します。実装済み Cop は検査を実行し、
+認識済みで未実装の Cop は既存設定を壊さず `--debug` で一覧表示します。本家にも存在しない
+Cop 名だけをエラーにし、必要なら `--ignore-unrecognized-cops` で続行できます。
+
+## インストール
+
+```bash
+gem install sonicop
+```
+
+Linux、macOS、Windows 向けの platform gem にはネイティブ実行ファイルが含まれます。
+対応する platform gem がない環境では、source gem がインストール時に Cargo でビルドします。
+
+最新版のソースから直接インストールすることもできます。
+
+```bash
+cargo install --git https://github.com/owayo/sonicop
+```
+
+## 使い方
+
+```bash
+# 現在のプロジェクトを検査
+sonicop
+
+# Cop／部門を選択
+sonicop --only Layout,Style/StringLiterals app spec
+
+# 安全な自動修正／全自動修正
+sonicop -a
+sonicop -A
+
+# RuboCop 互換形状の JSON
+sonicop --format json
+
+# 認識済み Cop と実装状況
+sonicop --show-cops
+```
+
+主な互換オプションは `-l`、`-x`、`--only`、`--except`、`-s/--stdin`、
+`-P/--parallel`、`-f/--format`、`-a/--autocorrect`、`-A/--autocorrect-all`、
+`-L/--list-target-files`、`-c/--config`、`-v/--version`、`-V/--verbose-version` です。
+
+### 設定
+
+対象ファイルごとに `.rubocop.yml` を解決するため、1 回の実行でもサブディレクトリ設定が
+適用されます。ローカル／HTTPS の `inherit_from`、`inherit_gem`、`inherit_mode`、
+`AllCops/DisabledByDefault`、`Include`／`Exclude`、Cop ごとの `Enabled`、`Exclude`、
+`Severity`、`Safe`、`SafeAutoCorrect` と設定値に対応します。宣言されたプラグイン由来の
+Cop は「認識済み・未実装」として受理し、Ruby プラグインコード自体は実行しません。
+
+```yaml
+inherit_from: .rubocop_todo.yml
+
+Layout/LineLength:
+  Max: 100
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+```
+
+既存コマンドとの互換性を保つため、server/LSP/MCP、plugin、cache 系の引数も受理します。
+未対応の機能を要求する引数は互換 no-op として stderr に明示します。現在、サーバートランスポート、
+Ruby プラグイン実行、キャッシュ再利用、カスタム Cop、実装済み以外の Cop は実行しません。
+
+### 適合性
+
+実装済み Cop は、正規化した JSON offense を使って RuboCop 1.89 との一致を検証済みです。
+本家の全 1,759 ファイルを本家既定設定で検査した現在のスナップショットは、参照 4,052 件中
+4,052 件すべての位置が一致（**recall 100%**）し、**誤検出とメタデータ差もともに 0 件**です。コマンド、比較範囲、測定結果は
+[CONFORMANCE.md](CONFORMANCE.md) にまとめています。Rails では Ruby 対象 3,453 ファイルと
+ルート／`guides/` の有効 Cop 一覧が完全一致し、全体の誤検出は 0 件です。Active Record
+402 ファイルの無キャッシュ実行は本家比で約 12.5 倍高速でした。
+
+## 開発
+
+入口は `make` に一本化しています。`make help` で全ターゲットを確認できます。gem 配布の
+タスクは Rakefile 側にあり、`make` から呼び出します。
+
+```bash
+make build   # デバッグビルド
+make check   # fmt、clippy、Rust テスト、Ruby ラッパーテスト、バージョン整合
+make gem     # source gem
+```
+
+### Cop の追加
+
+Cop は `src/rules/<部門>/<cop>.rs` の 1 ファイルで、公開するのは `check(context, offenses)` の
+1 関数だけです。登録は部門の `mod.rs` に 1 行を足します。
+
+```rust
+department_rules! {
+    "Layout";
+    line_length => ("LineLength", Convention),
+}
+```
+
+Cop 名と既定 severity を書くのはこの 1 行だけです。Cop 本体では名前は暗黙で、
+`context.setting("Max")` が `Layout/LineLength: Max` を読み、`context.offense(message, range)` が
+その Cop の名前と設定済み severity で報告します。Cop が自分の名前を 2 度書ける設計では、
+レジストリと食い違っても型検査では捕まりません。
+
+全ノード走査より `context.nodes_of("kind")` を優先してください。Cop は全ファイルに対して走るため、
+Cop ごとの全走査はファイル規模ではなく Cop 数に比例して重くなります。
+
+バージョンの正本は `Cargo.toml` です。`lib/sonicop/version.rb` は `make version-sync` で
+生成してコミットします（gemspec がパッケージ時に読むため）。両者が食い違うと CI が落ちます。
+
+`config/default.yml` は上流 RuboCop から取り込んだものです。再取得は
+`scripts/sync_default_yml.sh <rubocop-version>` で行い、由来のバージョンがファイル先頭に
+記録されます。
+
+依存更新には `depup --install` を使います。Ruby grammar は再現可能性のため `Cargo.toml` で
+fork のコミットを固定しています。
+
+## ライセンス
+
+[MIT](LICENSE)。同梱する RuboCop 既定設定とパーサー依存の著作権表示は
+[NOTICE](NOTICE) および [`licenses/`](licenses/) に収録しています。

data/README.md

@@ -0,0 +1,173 @@
+<h1 align="center">
+  <img src="docs/images/sonicop_logo_header.png" width="600" alt="Sonicop">
+</h1>
+
+<p align="center">
+  <strong>A fast, native RuboCop-compatible Ruby linter and formatter written in Rust.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/owayo/sonicop/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/owayo/sonicop/actions/workflows/ci.yml/badge.svg?branch=main"></a>
+  <a href="https://rubygems.org/gems/sonicop"><img alt="Gem Version" src="https://img.shields.io/gem/v/sonicop"></a>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/owayo/sonicop"></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ja.md">日本語</a>
+</p>
+
+---
+
+## Overview
+
+Sonicop is a fast Ruby linter and formatter that runs as a native executable without starting a
+Ruby process. Existing `.rubocop.yml` files work as-is, including nested configuration,
+inheritance, file inclusion and exclusion, severity, and autocorrect settings.
+
+It uses the actively maintained
+[owayo/tree-sitter-ruby](https://github.com/owayo/tree-sitter-ruby) grammar, inspects files in
+parallel, and applies corrections atomically. Its RuboCop 1.89-compatible CLI and JSON output fit
+existing editor and CI integrations with minimal changes.
+
+## Features
+
+Sonicop implements cops in the Layout, Lint, Metrics, Naming, Security, and Style departments.
+The implemented set grows with each release, so the binary itself is the authoritative list:
+
+```bash
+# Every recognized cop and its implementation status
+sonicop --show-cops
+```
+
+The bundled upstream configuration recognizes all 609 RuboCop 1.89 cops. Implemented cops run
+normally; recognized but not-yet-implemented cops remain configuration-compatible and are
+reported by `--debug`. Truly unknown cop names still fail validation unless
+`--ignore-unrecognized-cops` is supplied.
+
+## Installation
+
+```bash
+gem install sonicop
+```
+
+Platform gems include native executables for Linux, macOS, and Windows. When a prebuilt platform
+gem is unavailable, the source gem builds the executable with Cargo during installation.
+
+You can also install the latest source directly:
+
+```bash
+cargo install --git https://github.com/owayo/sonicop
+```
+
+## Usage
+
+```bash
+# Inspect the current project
+sonicop
+
+# Select cops or departments
+sonicop --only Layout,Style/StringLiterals app spec
+
+# Safe correction / all correction
+sonicop -a
+sonicop -A
+
+# RuboCop-shaped JSON
+sonicop --format json
+
+# Editor input
+printf '%s\n' 'value=10000' | sonicop --stdin example.rb --format json
+
+# List recognized cops and their implementation status
+sonicop --show-cops
+```
+
+Key compatibility flags include `-l`, `-x`, `--only`, `--except`, `-s/--stdin`, `-P/--parallel`,
+`-f/--format`, `-a/--autocorrect`, `-A/--autocorrect-all`, `-L/--list-target-files`,
+`-c/--config`, `-v/--version`, and `-V/--verbose-version`.
+
+### Configuration
+
+Sonicop resolves `.rubocop.yml` from each target file, so nested configurations apply within one
+run. Local and HTTPS `inherit_from`, `inherit_gem`, `inherit_mode`,
+`AllCops/DisabledByDefault`, `Include`, and `Exclude`, plus per-cop `Enabled`, `Exclude`,
+`Severity`, `Safe`, `SafeAutoCorrect`, and cop settings are supported. Cops supplied by declared
+plugins are accepted as recognized-but-unimplemented without executing Ruby plugin code.
+
+```yaml
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  Exclude:
+    - "vendor/**/*"
+
+Layout/LineLength:
+  Max: 100
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+```
+
+The CLI accepts RuboCop's server/LSP/MCP, plugin, and cache flags to keep existing command lines
+parse-compatible. These flags are reported as compatibility no-ops when they request unsupported
+functionality. Sonicop does not currently provide server transports, Ruby plugin execution, cache
+reuse, custom Ruby cops, or cops outside the implemented set.
+
+### Conformance
+
+The implemented cops are verified against RuboCop 1.89 using normalized JSON offenses.
+On RuboCop's complete 1,759-file source tree with the upstream default configuration, the current
+snapshot matches all 4,052 reference offense locations (**100% recall**) with **zero false
+positives and zero metadata differences**. On Rails, all 3,453 Ruby target paths and the root/nested enabled-cop lists match
+exactly, the full tree has zero false positives, and the 402-file Active Record subset runs about
+12.5x faster without cache. See [CONFORMANCE.md](CONFORMANCE.md) for the commands, scope, and
+measurements.
+
+## Development
+
+`make` is the single entry point; `make help` lists every target. The Rakefile holds the gem
+packaging tasks that `make` delegates to.
+
+```bash
+make build   # debug build
+make check   # fmt, clippy, Rust tests, Ruby wrapper tests, version consistency
+make gem     # source gem
+```
+
+### Adding a cop
+
+A cop is one file under `src/rules/<department>/<cop>.rs` exposing a single
+`check(context, offenses)`, plus one line in that department's `mod.rs`:
+
+```rust
+department_rules! {
+    "Layout";
+    line_length => ("LineLength", Convention),
+}
+```
+
+That line is the only place the cop's name and default severity are written. Inside the cop the
+name stays implicit: `context.setting("Max")` reads `Layout/LineLength: Max`, and
+`context.offense(message, range)` reports under the cop's own name at its configured severity. A
+cop that spelled its name a second time could disagree with the registry, and nothing in the type
+system would catch it.
+
+Prefer `context.nodes_of("kind")` over walking every node: each cop runs on every file, so a full
+walk per cop is what makes inspection scale with the registry rather than with the file.
+
+`Cargo.toml` is the single source of truth for the version. `lib/sonicop/version.rb` is generated
+from it by `make version-sync` and committed, because the gemspec reads it at package time. CI
+fails when the two disagree.
+
+`config/default.yml` is vendored from upstream RuboCop; re-fetch it with
+`scripts/sync_default_yml.sh <rubocop-version>`, which records the source version in the file
+header.
+
+Dependencies are updated with `depup --install`. The Ruby grammar dependency is pinned to an exact
+fork commit in `Cargo.toml` for reproducible builds.
+
+## License
+
+[MIT](LICENSE). The bundled RuboCop default configuration and parser dependency retain their
+upstream notices in [NOTICE](NOTICE) and [`licenses/`](licenses/).