Detect AI slop markers
Go to file
Dandaedre 3d78c0ca2a
Rust CI JohnSlop passed all CI checks.
Gitea/john-slop/pipeline/head This commit looks good Details
refactor(ci): centralize badge rendering
2026-10-04 01:33:47 +02:00
benches perf: add scaling benchmark suite 2026-09-29 17:36:49 +02:00
crates chore: prepare 0.1.27-rc.3 2026-09-30 20:27:41 +02:00
docs ci: publish current coverage badges 2026-10-03 03:07:43 +02:00
examples fix: width-fold fullwidth ASCII deterministically 2026-09-30 01:50:49 +02:00
fuzz chore: prepare 0.1.27-rc.8 2026-09-30 22:41:09 +02:00
scripts refactor(ci): centralize badge rendering 2026-10-04 01:33:47 +02:00
src feat: make LSP diagnostics Unicode-first 2026-09-30 02:26:52 +02:00
tests ci: publish current coverage badges 2026-10-03 03:07:43 +02:00
.gitignore ci: publish current coverage badges 2026-10-03 03:07:43 +02:00
AGENTS.md ci: publish current coverage badges 2026-10-03 03:07:43 +02:00
CHANGELOG.md chore: prepare 0.1.27-rc.8 2026-09-30 22:41:09 +02:00
CODE_OF_CONDUCT.md build: add reproducible release packaging 2026-09-29 17:44:06 +02:00
CONTRIBUTING.md build: add reproducible release packaging 2026-09-29 17:44:06 +02:00
Cargo.lock chore: prepare 0.1.27-rc.8 2026-09-30 22:41:09 +02:00
Cargo.toml chore: prepare 0.1.27-rc.8 2026-09-30 22:41:09 +02:00
Cross.toml chore: prepare 0.1.27-rc.8 2026-09-30 22:41:09 +02:00
Jenkinsfile fix(ci): escape coverage regex for Groovy 2026-10-03 14:43:18 +02:00
LICENSE
…
README.md ci: publish current coverage badges 2026-10-03 03:07:43 +02:00
SECURITY.md build: add reproducible release packaging 2026-09-29 17:44:06 +02:00
deny.toml build: reduce archive features and document dependency audit 2026-09-29 17:39:17 +02:00
release.sh fix: use repository fallback for releases 2026-09-30 21:56:12 +02:00
rust-release.toml fix: use repository fallback for releases 2026-09-30 21:56:12 +02:00
tarpaulin.toml docs: compare crate boundary tradeoffs 2026-09-29 21:32:16 +02:00
tasks.md chore: prepare 0.1.27-rc.7 2026-09-30 22:05:11 +02:00

README.md

John Slop

version tests test coverage

John Slop is a local-first linter for concrete signs of low-effort or insufficiently reviewed text and source code. It reports explainable evidence for human review; it does not prove AI authorship or identify a model.

Quickstart

With cargo-binstall available, install all three prebuilt binaries from the latest release candidate:

cargo binstall --git https://proxy.dandaedre.com/gitea/idle-org/john-slop \
  john-slop

To build from source, Rust 1.98.1 or newer is required. Install from the upstream Git repository:

cargo install --git https://proxy.dandaedre.com/gitea/idle-org/john-slop \
  --locked --all-features

Or install a checkout from its repository root:

cargo install --path . --locked --all-features

Scan a document or source directory:

john-slop path/to/document path/to/source-directory

Generate a commented config.toml in the current directory, then edit category or individual-rule switches as needed:

john-slop config init
john-slop config init-diagnostics

The second command creates a runtime rule catalog: exact-phrase and regex diagnostics can then be added without changing or recompiling the program.

Diagnostics are colored Miette reports by default. Make the command fail when a document reaches a chosen low-care evidence score with --fail-score 0..100:

john-slop --fail-score 40 path/to/document

Preview configured Unicode-to-ASCII replacements, or check them in automation:

john-slop-fmt path/to/document
john-slop-fmt --check path/to/document

Formatting is read-only unless --write is explicit. Start the editor server with john-slop-lsp; the editor guide has ready-to-use Helix and Vim configuration.

Overview

John Slop provides three binaries backed by the same configuration and source spans:

  • john-slop detects copied assistant scaffolding, generic style residue, source placeholders, tutorial narration, configured replacements, ASCII-like Unicode, and invisible or bidirectional controls.
  • john-slop-fmt previews, checks, or explicitly applies configured ASCII replacements, including the default printable-ASCII UTS #39 profile.
  • john-slop-lsp publishes Unicode diagnostics over stdio by default, offers explicit weighted or all-diagnostic opt-ins, provides quick fixes for safe replacements, and formats without writing editor-owned files.

The detector accepts UTF-8 files, directories, ZIP archives, and common ZIP-based office documents. Each finding includes its source span, stable rule ID, severity, message, and remediation help. A bounded evidence score aggregates configured signals; it is not the probability that AI wrote the content.

Analysis is local and deterministic, with no network requests or telemetry. False positives remain possible—especially in transcripts, tutorials, multilingual text, and intentional typography—so findings are prompts for review, not verdicts. Projects with multilingual text should consider the Unicode profile's non-mutating review mode before writing formatted output.

Learn progressively

Start with the guide closest to what you want to do:

  1. Use the CLI and understand exit statuses.
  2. Read or integrate the available output formats.
  3. Configure rules, replacements, and layered overrides, with commented configuration examples.
  4. Run the Rust and expected-failure examples.
  5. Connect the formatter and LSP to Helix or Vim.
  6. Understand the review-signal methodology, the heuristics and evidence score, and then the interpretation limits.

The documentation index offers the same guided path with a little more context.

Advanced topics

Architecture, the public library API, evaluation results, performance, dependency policy, design decisions, Unicode research, development, and release engineering are collected in the advanced guide.

Project

See CONTRIBUTING.md to work on the project and SECURITY.md to report a vulnerability. The ordered implementation plan lives in tasks.md, and agent contribution rules live in AGENTS.md.

John Slop is distributed under the MIT license.