Detect AI slop markers
Go to file
Dandaedre 0cb7ec3011
test: complete LSP milestone
2026-09-29 17:16:08 +02:00
assets feat: harden replacement engine 2026-09-29 16:41:22 +02:00
badges test: complete LSP milestone 2026-09-29 17:16:08 +02:00
docs test: complete LSP milestone 2026-09-29 17:16:08 +02:00
examples docs: publish LSP usage guides 2026-09-29 17:14:04 +02:00
src docs: publish LSP usage guides 2026-09-29 17:14:04 +02:00
tests test: cover LSP protocol workflows 2026-09-29 17:11:22 +02:00
.gitignore test: enforce coverage and publish badges 2026-09-29 12:53:29 +02:00
.run_status.toml test: complete LSP milestone 2026-09-29 17:16:08 +02:00
AGENTS.md test: complete configuration layer matrix 2026-09-29 13:33:20 +02:00
Cargo.lock test: cover LSP protocol workflows 2026-09-29 17:11:22 +02:00
Cargo.toml test: cover LSP protocol workflows 2026-09-29 17:11:22 +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 LSP usage guides 2026-09-29 17:14:04 +02:00
tarpaulin.toml test: enforce coverage and publish badges 2026-09-29 12:53:29 +02:00
tasks.md test: cover LSP protocol workflows 2026-09-29 17:11:22 +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 stdio LSP publishes those same replacement findings and versioned quick fixes in editors without writing files.

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
cargo run --bin john-slop-lsp

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.

Editors start john-slop-lsp over stdio. It tracks open snapshots with full document synchronization, reports configured ASCII replacements, and offers quick fixes whose result matches the formatter. See the editor guide for Helix and Vim setup.

Documentation

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

John Slop is distributed under the MIT license.