|
Rust CI JohnSlop passed all CI checks.
Gitea/john-slop/pipeline/head This commit looks good
Details
|
||
|---|---|---|
| .. | ||
| decisions | ||
| experiments | ||
| README.md | ||
| advanced.md | ||
| architecture.md | ||
| background.md | ||
| benchmarks.md | ||
| configuration.md | ||
| dependencies.md | ||
| development.md | ||
| editors.md | ||
| evaluation.md | ||
| heuristics.md | ||
| limitations.md | ||
| output.md | ||
| releasing.md | ||
| review-signals.md | ||
| unicode-confusables.md | ||
| usage.md | ||
README.md
John Slop documentation
The root README gets you from installation to a first scan. Move through these guides as your needs grow; you do not need to understand the internals to use the tools.
Start using it
- Usage covers accepted inputs, detector options, stable exit statuses, formatter modes, and the LSP command.
- Output explains graphical Miette reports, plain human output, concise records, versioned JSON Lines, and partial input errors.
- Configuration documents source precedence, named profiles, stable-ID merges, validation, and inspection commands. Start from the commented examples.
Put it into practice
- Runnable examples demonstrate in-memory analysis, streaming path input, shared replacement planning, and an expected-failure diagnostic showcase.
- Editor setup provides working Helix (
hx) and Vim formatter and LSP configurations with validation steps. - Review signals and evidence methodology explains the research boundary, evidence tiers, and deliberately excluded proxies.
- Heuristics and evidence scoring explains what each rule contributes and how the bounded score is calculated.
- Limitations covers false positives, evasion, domain shift, score semantics, and safe interpretation.
Go deeper
The advanced guide is the single entry point for architecture, the public library API, evaluation, benchmarks, dependencies, design records, research references, development, security, and releases.
Project work is tracked in tasks.md, while contribution policy is defined in CONTRIBUTING.md and AGENTS.md.