john-slop/README.md

49 lines
1.9 KiB
Markdown

# John Slop
![version](badges/version.svg)
![tests](badges/test.svg)
![test coverage](badges/coverage.svg)
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](tasks.md).
## Quick start
Rust 1.98.1 or newer is required.
```sh
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](docs/README.md)
- [Command-line usage and current capabilities](docs/usage.md)
- [Architecture and public library API](docs/architecture.md)
- [Layered configuration](docs/configuration.md)
- [Heuristics, confidence, and applicability](docs/heuristics.md)
- [Evaluation corpus and current metrics](docs/evaluation.md)
- [Limitations and responsible interpretation](docs/limitations.md)
- [Development, tests, features, and coverage](docs/development.md)
- [Design decision records](docs/decisions/)
- [Background reading](docs/background.md)
The ordered implementation plan lives in [tasks.md](tasks.md), and contribution
rules live in [AGENTS.md](AGENTS.md).
John Slop is distributed under the [MIT license](LICENSE).