|
|
||
|---|---|---|
| assets | ||
| badges | ||
| docs | ||
| src | ||
| tests | ||
| .gitignore | ||
| .run_status.toml | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Jenkinsfile | ||
| LICENSE | ||
| README.md | ||
| tarpaulin.toml | ||
| tasks.md | ||
README.md
John Slop
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
- Documentation index
- Command-line usage and current capabilities
- Architecture and public library API
- Layered configuration
- Heuristics, confidence, and applicability
- Evaluation corpus and current metrics
- Limitations and responsible interpretation
- Development, tests, features, and coverage
- Design decision records
- Background reading
The ordered implementation plan lives in tasks.md, and contribution rules live in AGENTS.md.
John Slop is distributed under the MIT license.