### Nix```bash
nix profile install github:brennhill/sloppy-joe

### 2. Typosquatting (generative checks + edit distance fallback)

**The attack:** Ein Angreifer registriert `expresz` auf npm – ein Zeichen von `express` entfernt. KI generiert es, oder ein Entwickler vertippt sich. Das Paket existiert, besteht die Existenzprüfung und installiert Schadsoftware.

**How sloppy-joe blocks it:** sloppy-joe führt 10 generative Prüfungen durch, bevor es auf die Edit-Distanz zurückfällt. Jede generative Prüfung erzeugt eine spezifische Mutation des Abhängigkeitsnamens (Zeichen tauschen, Wiederholungen zusammenfassen, Suffixe entfernen, Wörter umstellen, Trennzeichen normalisieren, Homoglyphen ersetzen, Scopes prüfen) und testet auf exakte Übereinstimmung mit bekannten populären Paketen. Dieser Ansatz, inspiriert von der [Rust Foundation's Typomania](https://github.com/rustfoundation/typomania)-Bibliothek, hat nahezu keine Fehlalarme, da er nur bei exakten Treffern nach Mutation auslöst.

Die Levenshtein-Edit-Distanz wird zuletzt als Sicherheitsnetz für neuartige Mutationen verwendet, die keine spezifische Prüfung vorhergesehen hat. Zusammen decken sie sowohl bekannte Angriffsmuster (präzise) als auch unbekannte (breit) ab.```
ERROR expresz [similarity/edit-distance]
      'expresz' is 1 character away from 'express'. This could be a typosquat.
 Fix: If you meant 'express', fix the name in your manifest.

### 4. Trennzeichen-Verwirrung

**Der Angriff:** `python-dateutil` vs `python_dateutil` vs `pythondateutil`. In manchen Registries sind dies unterschiedliche Pakete. Ein Angreifer registriert die Variante.

**Wie sloppy-joe es blockt:** Normalisiert alle Trennzeichen (`-`, `_`, `.`) vor dem Vergleich. Wenn die normalisierte Form mit einem bekannten Paket übereinstimmt, wird es markiert.```
ERROR socket_io [similarity/separator-confusion]
      'socket_io' matches 'socket.io' after normalizing separators.
 Fix: Use the canonical name 'socket.io' with the correct separators.

### 6. Benachbarte Zeichenvertauschungen

**Der Angriff:** `reqeust` anstelle von `request`. Zwei benachbarte Zeichen vertauscht — ein häufiger Tippfehler, den Angreifer ausnutzen.

**Wie sloppy-joe es blockiert:** Generiert alle Varianten mit benachbarten Vertauschungen des Abhängigkeitsnamens und prüft jede davon gegen das Korpus.```
ERROR reqeusts [similarity/char-swap]
      'reqeusts' matches 'requests' with two adjacent characters swapped.
 Fix: Use 'requests' — two characters are transposed.

### 8. Homoglyphen (optisch identisch wirkende Zeichen)

**Der Angriff:** `rеquests` mit einem kyrillischen `е` (U+0435) anstelle des lateinischen `e` (U+0065). Visuell identisch. Der Paketname sieht genauso aus wie `requests`, verweist aber auf ein anderes, bösartiges Paket.

**Wie sloppy-joe dies blockiert:** Ersetzt 17 bekannte Homoglyphenzeichen (kyrillisch, vollbreit, Schriftvarianten) durch ihre lateinischen Entsprechungen und prüft, ob das Ergebnis mit einem bekannten Paket übereinstimmt.```
ERROR rеquests [similarity/homoglyph]
      'rеquests' contains characters that look identical to 'requests'
      but are different Unicode codepoints (homoglyphs).
 Fix: Replace the lookalike characters with standard ASCII.

### 10. Angriffe mit Groß-/Kleinschreibungsvarianten (Groß-/Kleinschreibung-sensitive Registries)

**Der Angriff:** In Go, Maven und Ruby sind `Rails` und `rails` unterschiedliche Pakete. Ein Angreifer registriert die großgeschriebene Variante.

**Wie sloppy-joe dies blockiert:** In Groß-/Kleinschreibung-sensitiven Registries wird jede Groß-/Kleinschreibungsvariante eines bekannten Pakets als Fehler markiert. In Groß-/Kleinschreibung-insensitiven Registries (npm, PyPI, Cargo, NuGet, PHP) sind Groß-/Kleinschreibungsvarianten sicher und werden übersprungen.```
ERROR Rails [similarity/case-variant]
      'Rails' differs from 'rails' only in letter casing.
      On case-sensitive registries (ruby) these resolve to different packages.
 Fix: Use the exact casing 'rails' in your manifest.

### 12. Scope Squatting (npm, PHP, Go, JVM)

**Der Angriff:** Ein Angreifer registriert `@typos/lodash` auf npm – ein Zeichen Unterschied zu `@types/lodash`. Oder `larvael/framework` auf Packagist – zwei Zeichen Unterschied zu `laravel/framework`. Oder `github.com/gooogle/protobuf` in Go – ein zusätzliches `o`. Der Scope wirkt auf den ersten Blick legitim. Das Paket wird aufgelöst. Die Malware installiert sich.

Dies ist selten, aber plausibel – und genau für „selten, aber plausibel“ gibt es sloppy-joe. Der `ua-parser-js`-Vorfall im Jahr 2021 war scope-bezogen. Wenn es einem Paket mit Millionen von wöchentlichen Downloads passieren kann, kann es auch Ihrem passieren.

**Wie sloppy-joe es blockiert:** Extrahiert den Scope/Namespace aus dem Abhängigkeitsnamen und vergleicht ihn mit einer Liste bekannter guter Scopes mittels Editierdistanz. Funktioniert für npm (`@scope`), PHP (`vendor/`), Go (`github.com/org`) und JVM (`com.group`).```
ERROR @typos/lodash [similarity/scope-squatting]
      Scope '@typos' is 1 character away from the known scope '@types'.
      Scope squatting is a known supply chain attack vector.
 Fix: If you meant '@types/lodash', fix the scope in your manifest.

### 13. Nicht-kanonische Pakete (kein Angriff — ein Konsistenz-Gate)

**Der Angriff:** Kein Angriff — ein Konsistenzproblem. KI wählt `moment`, weil es in den Trainingsdaten beliebt war, aber Ihr Team verwendet `dayjs`. Verschiedene Teams, die unterschiedliche Pakete für dieselbe Aufgabe nutzen, verursachen Wartungsschulden und Abhängigkeitsaufblähung.

**Wie sloppy-joe es blockiert:** Ihre Konfiguration ordnet jedem kanonischen Paket die abgelehnten Alternativen zu. Wenn eine Abhängigkeit mit einer Alternative übereinstimmt, schlägt der Build fehl.```
ERROR moment [canonical]
      'moment' is not the approved package for this purpose.
      Your team uses 'dayjs'.
 Fix: Replace 'moment' with 'dayjs' in your manifest file.

### 15. Brandneue Pakete

**Der Angriff:** Ein Paket, das gestern erstellt wurde, 3 Downloads hat und einen Namen trägt, der einem beliebten Paket ähnelt. Hohe Wahrscheinlichkeit, dass es sich um einen Typosquat oder einen Platzhalter für einen zukünftigen Angriff handelt.

**Wie sloppy-joe es blockiert:** Markiert jedes Paket, das vor weniger als 30 Tagen erstellt wurde.```
ERROR sketchy-lib [metadata/new-package]
      'sketchy-lib' was first published 2 days ago.
      New packages are higher risk.
 Fix: Verify 'sketchy-lib' at its registry page and source repository.

---

## Unterstützte Ökosysteme

| Ökosystem | Manifest | Lockfile-Richtlinie | Existenz | Metadaten | Altersgrenze |
|-----------|----------|-----------------|:---------:|:--------:|:--------:|
| npm | package.json | `package-lock.json` oder `npm-shrinkwrap.json` erforderlich | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| PyPI | `pyproject.toml`, `requirements*.txt`, `Pipfile`, `setup.cfg`, `setup.py` | Poetry wird mit `poetry.lock` vertraut, uv mit `uv.lock`, vollständig hash-gesperrte pip-tools werden nur dann vertraut, wenn der eingecheckte Abhängigkeitsgraph `--index-url` und exakt zugelassene `--extra-index-url`-Werte bindet, und repo-sichtbare benutzerdefinierte Poetry/uv-Indizes können nur durch eine exakte Zulassungsliste `trusted_indexes.pypi` vertraut werden; bei Legacy-Manifesten erscheint bei jedem Durchlauf eine Warnung, es sei denn, `python_enforcement` ist auf `poetry_only` gesetzt | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Cargo | Cargo.toml | `Cargo.lock` erforderlich | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Go | go.mod | `go.sum` für externe Abhängigkeiten erforderlich; nicht erforderlich für reine stdlib- oder vollständig lokale `replace`-Angaben | :white_check_mark: | :x: | :x: |
| Ruby | Gemfile | `Gemfile.lock` erforderlich | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| PHP | composer.json | `composer.lock` erforderlich | :white_check_mark: | :x: | :x: |
| JVM (Gradle) | build.gradle / build.gradle.kts | `gradle.lockfile` erforderlich | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| JVM (Maven) | pom.xml | nur Warnung: keine strenge Lockfile-Durchsetzung | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| .NET | *.csproj | `packages.lock.json` erforderlich | :white_check_mark: | :x: | :x: |

Alle Ökosysteme erhalten Existenz-, Ähnlichkeits- und Kanonizitätsprüfungen. Metadaten und Altersgrenzen hängen davon ab, was die Registry-API bereitstellt. Lockfile-Unterstützung ermöglicht transitive Abhängigkeitsscans und exakte Versionsauflösung, sofern das Ökosystem ein vertrauenswürdiges, projekteigenes Lockfile-Modell bereitstellt.

## Schnellstart```bash
# Install
cargo install sloppy-joe

# Check current project (auto-detects ecosystem)
sloppy-joe check

# Check with canonical enforcement and age gate
sloppy-joe check --config /etc/sloppy-joe/config.json

# Output as JSON for CI
sloppy-joe check --json

**`canonical`** — Schlüssel sind genehmigte Pakete; Werte sind abgelehnte Alternativen.

**`internal`** — Pakete Ihrer Organisation. Überspringt ALLE Prüfungen. Diese ändern sich ständig.

**`allowed`** — geprüfte externe Pakete. Überspringt Existenz- und Ähnlichkeitsprüfungen, unterliegt jedoch weiterhin der Versionsaltersregel.

**`similarity_exceptions`** — exakte Paket-/Kandidat-/Generator-Unterdrückungen für überprüfte Ähnlichkeits-Falschpositive. Verwenden Sie dies, wenn eine bestimmte Ähnlichkeitskante falsch ist, Sie aber dennoch normale Prüfungen für das Paket wünschen.

**`metadata_exceptions`** — exakte überprüfte Metadaten-Unterdrückungen. Derzeit wird nur `metadata/maintainer-change` unterstützt und erfordert eine exakte Übereinstimmung von Paket/Version/vorherigem Herausgeber/aktuellem Herausgeber.

Verwenden Sie `sloppy-joe check --review-exceptions`, wenn Sie Maintainer-Change-Blocker überprüfen müssen. Der Scan blockiert weiterhin normal, aber die menschliche Ausgabe fügt einen Abschnitt `REVIEW EXCEPTIONS` mit Eigentümern, Repository-URL und einem einsatzbereiten `metadata_exceptions`-Snippet hinzu. `--json` enthält dieselben Daten in einem Top-Level-Feld `review_candidates`.

**`min_version_age_hours`** — blockiert jede Version, die vor weniger als dieser Anzahl von Stunden veröffentlicht wurde. Standard: 72 (3 Tage). Auf 0 setzen zum Deaktivieren. Interne Pakete sind ausgenommen.

**`allow_legacy_npm_v1_lockfile`** — erlaubt `lockfileVersion: 1` npm-Lockfiles von npm v5/v6 im Reduced-Confidence-Modus. Standard: `false`. Lassen Sie dies deaktiviert, es sei denn, Sie sind bewusst auf Legacy-npm angewiesen und akzeptieren laute Warnungen sowie reduzierte vertrauenswürdige npm-transitive Abdeckung.

**`python_enforcement`** — steuert die Python-Vertrauensrichtlinie. `prefer_poetry` (Standard) vertraut Poetry-Projekten und uv-Projekten, vertraut vollständig hash-gesperrten pip-tools-Anforderungen nur, wenn der committete Anforderungsgraph `--index-url` und alle nicht-PyPI `--extra-index-url` Werte exakt bindet, und stuft andernfalls pip-tools auf Reduced-Confidence herab. Legacy-Manifeste wie ungehashte `requirements*.txt`, `Pipfile`, `setup.cfg`, `setup.py` und nicht-Poetry/nicht-uv `pyproject.toml` warnen bei jedem Durchlauf. `poetry_only` blockiert diese nicht-Poetry Python-Workflows und erfordert Poetry.

### Konfigurationssicherheit

Die Konfiguration wird **niemals aus dem Projektverzeichnis gelesen**. Ein KI-Agent mit Shell-Zugriff könnte eine im Repository befindliche Konfiguration umschreiben, um zu erlauben, was immer er möchte.

Konfigurationsauflösung:
1. `--config /path/to/config.json` — lokale Datei (CLI-Flag, höchste Priorität)
2. `--config https://example.com/config.json` — von URL abrufen
3. `SLOPPY_JOE_CONFIG=...` — Umgebungsvariable (Dateipfad oder URL)
4. Keine Konfiguration = nur Existenz-, Ähnlichkeits- und Metadatenprüfungen

Fehlerhafte Konfigurationen **scheitern hart** mit umsetzbaren Fehlermeldungen — eine defekte Konfiguration fällt niemals stillschweigend auf keinen Schutz zurück.

Siehe [CONFIG.md](https://github.com/brennhill/sloppy-joe/blob/HEAD/CONFIG.md) für vollständiges Formatreferenz, CI-Integrationsmuster und Beispiele.

Bootstrap-Konfiguration:```bash
sloppy-joe init --greenfield --ecosystem npm
sloppy-joe init --from-current
sloppy-joe init --from-current --register
sloppy-joe init --register

#### Aktionseingaben

| Eingabe | Beschreibung | Standard |
|-------|-------------|---------|
| `config` | Konfigurationsdateipfad oder HTTPS-URL | *(keine)* |
| `dir` | Zu scannendes Projektverzeichnis | `.` |
| `type` | Ökosystem (`npm`, `pypi`, `cargo`, `go`, `ruby`, `php`, `jvm`, `dotnet`) | automatisch erkennen |
| `deep` | Aktiviert transitive Abhängigkeitsähnlichkeitsprüfungen | `false` |
| `paranoid` | Aktiviert Bitflip-Mutationen | `false` |
| `args` | Zusätzliche CLI-Argumente | *(keine)* |
| `version` | Zu installierende sloppy-joe-Version | `latest` |

#### Beispiele```yaml
# Minimal — CI-oriented scan, auto-detect ecosystem, no config
- uses: brennhill/[email protected]

# With org config from a URL
- uses: brennhill/[email protected]
  with:
    config: https://raw.githubusercontent.com/yourorg/configs/main/sloppy-joe.json

# Deep scan with paranoid mode
- uses: brennhill/[email protected]
  with:
    config: ${{ secrets.SLOPPY_JOE_CONFIG }}
    deep: true
    paranoid: true

# Scan a subdirectory, pin to a specific version
- uses: brennhill/[email protected]
  with:
    dir: ./packages/api
    version: '1.1.0'

### pre-commit

sloppy-joe arbeitet mit dem [pre-commit](https://pre-commit.com) Framework.
Fügen Sie es in Ihre `.pre-commit-config.yaml` ein:```yaml
# .pre-commit-config.yaml
repos:
  - repo: https://github.com/brennhill/sloppy-joe
    rev: v1.1.0
    hooks:
      - id: sloppy-joe

Oder verwenden Sie einen einfachen Shell-Hook ohne das Framework:```bash
#!/bin/sh
sloppy-joe check || exit 1

Ähnlichkeit durchläuft 4 Phasen:
- **Phase 0: Scope squatting** — lokale Prüfung, kein Netzwerk. Vergleicht Scope/Namespace mit bekannten guten Scopes mittels Levenshtein-Distanz.
- **Phase 1: Intra-manifest** — lokale Prüfung. Markiert, wenn zwei Abhängigkeiten im selben Manifest Mutationen voneinander sind.
- **Phase 2: Registry query** — erzeugt Mutationen, führt Batch-Abfragen in der Registry auf Existenz durch, cached Ergebnisse (7-Tage-TTL).
- **Phase 3: Metadata enrichment** — ruft Downloadzahlen und Veröffentlichungsdaten für Treffer ab, um Berichten Nachweise hinzuzufügen.

Jeder Mutationsgenerator taggt seine Ausgabe, sodass der gemeldete Prüftyp (z.B. `similarity/homoglyph`) deterministisch ist – der Generator mit der höchsten Schwere gewinnt, wenn mehrere Generatoren denselben Kandidaten erzeugen.

## CI-Zuverlässigkeit

sloppy-joe ist für CI-Pipelines konzipiert, bei denen flaky Fehler inakzeptabel sind.

**Wiederholung mit Backoff.** Alle Registry-HTTP-Aufrufe wiederholen sich 3 Mal mit exponentiellem Backoff (200ms, 400ms, 800ms) bei vorübergehenden Fehlern (5xx, Timeouts, Verbindungsfehler). Ein einzelner Netzwerkausfall bringt deinen Build nicht zum Scheitern.

**Fail-closed bei Abfragefehlern.** Wenn Registry- oder OSV-Abfragen fehlschlagen, gibt sloppy-joe einen blockierenden Fehler `registry-unreachable` aus, anstatt Prüfungen stillschweigend zu überspringen. Der Scan verlässt sich nicht mehr auf pro-Ökosystem Schwellenwerte oder Sample-Größen-Grenzen, bevor er blockiert.

**Ähnlichkeits-Cache.** Ergebnisse zur Existenz von Mutationen werden für 7 Tage zwischengespeichert. Nach dem ersten Scan werden die meisten Abfragen aus dem Cache bedient, ohne Netzwerkaufrufe. Nur neue Abhängigkeiten lösen Registry-Abfragen aus.

**Lockfile-bewusste Auflösung.** Wenn ein unterstütztes Lockfile vorhanden und vertrauenswürdig ist (`package-lock.json`, `npm-shrinkwrap.json`, `Cargo.lock`, `Gemfile.lock`, `poetry.lock` für Poetry-Projekte, `uv.lock` für uv-Projekte, `composer.lock`, `gradle.lockfile`, `packages.lock.json`), löst sloppy-joe exakte Versionen daraus auf, anstatt aus Bereichen zu raten. Vollständig hash-gesperrte `requirements*.txt` können ebenfalls exakt festgelegte Versionen liefern, und sie werden vollständig vertrauenswürdig, wenn der committete Requirements-Graph seine eigenen `--index-url` und exakt zugelassene `--extra-index-url` Werte bindet.

## Tests

Die Testsuite deckt Ähnlichkeitsprüfungen, Metadaten-Signale, OSV-Verhalten, Konfigurationsparsing und -validierung, Lockfile-Auflösung, Manifest- und Lockfile-Preflight-Richtlinien, Berichtsformatierung und HTTP-Wiederholungslogik ab.```bash
cargo test