Detect AI slop markers
Go to file
Dandaedre 033be96d79
Rust CI JohnSlop passed all CI checks.
Gitea/john_slop/pipeline/head This commit looks good Details
test: complete formatter milestone
2026-09-29 16:51:44 +02:00
assets feat: harden replacement engine 2026-09-29 16:41:22 +02:00
badges test: complete formatter milestone 2026-09-29 16:51:44 +02:00
docs test: complete formatter milestone 2026-09-29 16:51:44 +02:00
examples test: cover formatter workflows 2026-09-29 16:47:13 +02:00
src docs: publish formatter contract 2026-09-29 16:49:38 +02:00
tests test: cover formatter workflows 2026-09-29 16:47:13 +02:00
.gitignore test: enforce coverage and publish badges 2026-09-29 12:53:29 +02:00
.run_status.toml test: complete formatter milestone 2026-09-29 16:51:44 +02:00
AGENTS.md test: complete configuration layer matrix 2026-09-29 13:33:20 +02:00
Cargo.lock feat: implement safe ASCII formatter 2026-09-29 16:45:01 +02:00
Cargo.toml feat: implement safe ASCII formatter 2026-09-29 16:45:01 +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: publish formatter contract 2026-09-29 16:49:38 +02:00
tarpaulin.toml test: enforce coverage and publish badges 2026-09-29 12:53:29 +02:00
tasks.md docs: publish formatter contract 2026-09-29 16:49:38 +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. The detector renders source-highlighted human diagnostics, concise records, or versioned JSON Lines. The formatter applies only configured Unicode-to-ASCII replacements, supports check/diff modes, and requires explicit opt-in for atomic file writes. The LSP is 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
cargo run --bin john-slop-fmt -- path/to/document
cargo run --bin john-slop-fmt -- --check path/to/document

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.

Formatter file mode prints transformed text without modifying the source. Use --write explicitly for atomic in-place replacement, or pipe editor buffers through john-slop-fmt over stdin/stdout.

Documentation

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

John Slop is distributed under the MIT license.