Detect AI slop markers
Go to file
Dandaedre 0428cd8a9a
feat: expose typed finding diagnostics
2026-09-29 15:48:58 +02:00
assets feat: expose typed finding diagnostics 2026-09-29 15:48:58 +02:00
badges test: complete heuristic detection milestone 2026-09-29 15:34:30 +02:00
docs feat: expose typed finding diagnostics 2026-09-29 15:48:58 +02:00
src feat: expose typed finding diagnostics 2026-09-29 15:48:58 +02:00
tests test: add reviewed heuristic corpus 2026-09-29 15:31:46 +02:00
.gitignore test: enforce coverage and publish badges 2026-09-29 12:53:29 +02:00
.run_status.toml test: complete heuristic detection milestone 2026-09-29 15:34:30 +02:00
AGENTS.md test: complete configuration layer matrix 2026-09-29 13:33:20 +02:00
Cargo.lock feat: scope heuristics by content and path 2026-09-29 15:26:29 +02:00
Cargo.toml feat: scope heuristics by content and path 2026-09-29 15:26:29 +02:00
Jenkinsfile test: enforce coverage and publish badges 2026-09-29 12:53:29 +02:00
LICENSE Initial commit 2025-12-03 18:42:17 +01:00
README.md docs: define detector limitations 2026-09-29 15:32:39 +02:00
tarpaulin.toml test: enforce coverage and publish badges 2026-09-29 12:53:29 +02:00
tasks.md feat: expose typed finding diagnostics 2026-09-29 15:48:58 +02:00

README.md

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

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.