# John Slop ![version](badges/version.svg) ![tests](badges/test.svg) ![test coverage](badges/coverage.svg) 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. Eleven conservative, configurable rules cover copied assistant scaffolding, generic style residue, source-code placeholders, tutorial narration, and configured non-ASCII characters. Rules retain exact source spans, apply path/content scopes, and feed a bounded, explainable confidence score. Source-highlighted terminal diagnostics, a formatter, and an LSP are planned in [tasks.md](tasks.md). ## Quick start Rust 1.98.1 or newer is required. ```sh 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](docs/README.md) - [Command-line usage and current capabilities](docs/usage.md) - [Architecture and public library API](docs/architecture.md) - [Layered configuration](docs/configuration.md) - [Heuristics, confidence, and applicability](docs/heuristics.md) - [Evaluation corpus and current metrics](docs/evaluation.md) - [Limitations and responsible interpretation](docs/limitations.md) - [Development, tests, features, and coverage](docs/development.md) - [Design decision records](docs/decisions/) - [Background reading](docs/background.md) The ordered implementation plan lives in [tasks.md](tasks.md), and contribution rules live in [AGENTS.md](AGENTS.md). John Slop is distributed under the [MIT license](LICENSE).