1.6 KiB
John Slop
John Slop is an early-stage, local-first linter for concrete signs of low-effort or insufficiently reviewed text and source code. It reports explainable heuristics for human review; it does not prove AI authorship or identify a model.
Today, the detector reads UTF-8 files, directories, ZIP archives, and common ZIP-based office documents. Its first conservative rule family identifies configured non-ASCII hyphen-like characters and exposes safe ASCII replacement edits. Broader data-driven heuristics, terminal diagnostics, a formatter, and an LSP are planned in tasks.md.
Quick start
Rust 1.98.1 or newer is required.
cargo run --bin john-slop -- path/to/document path/to/source-directory
Use --fail-confidence 0..100 to make the detector exit with status 1 when a
document reaches a chosen evidence threshold. Confidence measures configured
signals, not the probability that AI wrote the content.
Documentation
- Documentation index
- Command-line usage and current capabilities
- Architecture and public library API
- Layered configuration
- Development, tests, features, and coverage
- Design decision records
- Background reading
The ordered implementation plan lives in tasks.md, and contribution rules live in AGENTS.md.
John Slop is distributed under the MIT license.