sonicop 26.8.101

data/Cargo.toml

@@ -0,0 +1,40 @@
+[package]
+name = "sonicop"
+version = "26.8.101"
+edition = "2024"
+rust-version = "1.85"
+description = "A fast, native RuboCop-compatible Ruby linter and formatter"
+license = "MIT"
+repository = "https://github.com/owayo/sonicop"
+readme = "README.md"
+keywords = ["ruby", "rubocop", "linter", "formatter"]
+categories = ["command-line-utilities", "development-tools"]
+
+[[bin]]
+name = "sonicop"
+path = "src/main.rs"
+
+[dependencies]
+anyhow = "1.0.104"
+clap = { version = "4.6.4", features = ["derive", "wrap_help"] }
+globset = "0.4.19"
+ignore = "0.4.31"
+rayon = "1.12.0"
+regex = "1.13.1"
+serde = { version = "1.0.229", features = ["derive"] }
+serde_json = "1.0.151"
+serde_yaml_ng = "0.10"
+shell-words = "1.1.1"
+tempfile = "3.27.0"
+tree-sitter = "0.26.11"
+tree-sitter-ruby = { git = "https://github.com/owayo/tree-sitter-ruby.git", rev = "88a64c6c37c4c23d8d4d804c4ef9c4eca3c88b96" }
+unicode-width = "0.2.2"
+ureq = { version = "3.4", default-features = false, features = ["native-tls"] }
+
+[dev-dependencies]
+assert_cmd = "2.2.2"
+
+[profile.release]
+lto = "thin"
+codegen-units = 1
+strip = true

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/).