john-slop/README.md

1.5 KiB

John Slop

version tests test coverage

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

The ordered implementation plan lives in tasks.md, and contribution rules live in AGENTS.md.

John Slop is distributed under the MIT license.