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

### 2. Typosquatting (verificaciones generativas + recurso de distancia de edición)

**El ataque:** Un atacante registra `expresz` en npm — a un carácter de `express`. La IA lo genera, o un desarrollador lo escribe mal. El paquete existe, pasa la verificación de existencia e instala malware.

**Cómo sloppy-joe lo bloquea:** sloppy-joe ejecuta 10 verificaciones generativas antes de recurrir a la distancia de edición. Cada verificación generativa produce una mutación específica del nombre de la dependencia (intercambiar caracteres, colapsar repeticiones, eliminar sufijos, reordenar palabras, normalizar separadores, reemplazar homóglifos, verificar ámbitos) y prueba una coincidencia exacta con paquetes populares conocidos. Este enfoque, inspirado en la biblioteca [Typomania de la Rust Foundation](https://github.com/rustfoundation/typomania), tiene casi cero falsos positivos porque solo se activa con coincidencias exactas después de la mutación.

La distancia de edición de Levenshtein se ejecuta al final como una red de seguridad para mutaciones novedosas que ninguna verificación específica anticipó. Juntos, cubren tanto patrones de ataque conocidos (con precisión) como desconocidos (de manera amplia).```
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. Confusión de separadores

**El ataque:** `python-dateutil` vs `python_dateutil` vs `pythondateutil`. En algunos registros, estos son paquetes diferentes. Un atacante registra la variante.

**Cómo sloppy-joe lo bloquea:** Normaliza todos los separadores (`-`, `_`, `.`) antes de la comparación. Si la forma normalizada coincide con un paquete conocido, se marca.```
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. Intercambios de caracteres adyacentes

**El ataque:** `reqeust` en lugar de `request`. Dos caracteres adyacentes transpuestos — un error tipográfico común que los atacantes aprovechan.

**Cómo sloppy-joe lo bloquea:** Genera todas las variantes de intercambio adyacente del nombre de la dependencia y verifica cada una contra el corpus.```
ERROR reqeusts [similarity/char-swap]
      'reqeusts' matches 'requests' with two adjacent characters swapped.
 Fix: Use 'requests' — two characters are transposed.

### 8. Homoglifos (similitudes visuales)

**El ataque:** `rеquests` con una `е` cirílica (U+0435) en lugar de la `e` latina (U+0065). Visualmente idéntico. El nombre del paquete se ve exactamente como `requests` pero se resuelve a un paquete malicioso diferente.

**Cómo sloppy-joe lo bloquea:** Reemplaza 17 caracteres de homoglifos conocidos (cirílicos, de ancho completo, variantes de script) con sus equivalentes latinos y comprueba si el resultado coincide con un paquete conocido.```
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. Ataques de variantes de mayúsculas/minúsculas (registros sensibles a mayúsculas/minúsculas)

**El ataque:** En Go, Maven y Ruby, `Rails` y `rails` son paquetes diferentes. Un atacante registra la variante en mayúsculas.

**Cómo lo bloquea sloppy-joe:** En registros sensibles a mayúsculas/minúsculas, cualquier variante de mayúsculas/minúsculas de un paquete conocido se marca como un error. En registros insensibles a mayúsculas/minúsculas (npm, PyPI, Cargo, NuGet, PHP), las variantes de mayúsculas/minúsculas son seguras y se omiten.```
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. Suplantación de alcance (npm, PHP, Go, JVM)

**El ataque:** Un atacante registra `@typos/lodash` en npm — a un carácter de `@types/lodash`. O `larvael/framework` en Packagist — a dos caracteres de `laravel/framework`. O `github.com/gooogle/protobuf` en Go — una `o` extra. El alcance parece legítimo a simple vista. El paquete se resuelve. El malware se instala.

Esto es raro pero plausible — y "raro pero plausible" es exactamente para lo que existe sloppy-joe. El incidente de `ua-parser-js` en 2021 estaba relacionado con el alcance. Si puede ocurrirle a un paquete con millones de descargas semanales, puede ocurrirle al tuyo.

**Cómo lo bloquea sloppy-joe:** Extrae el alcance/namespace del nombre de la dependencia y lo compara contra una lista de alcances conocidos como seguros usando la distancia de edición. Funciona en npm (`@scope`), PHP (`vendor/`), Go (`github.com/org`) y 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.

wifi_eap_hammer.sh --bssid 22:6a:7d:4f:c2:4a --interface wlan0 --essid "SecureWifi" --wordlist rockyou.txt --daemon

### 13. Paquetes no canónicos (no es un ataque — una puerta de consistencia)

**El ataque:** No es un ataque — es un problema de consistencia. La IA elige `moment` porque era popular en los datos de entrenamiento, pero tu equipo usa `dayjs`. Diferentes equipos usando diferentes paquetes para la misma tarea genera deuda de mantenimiento e hinchazón de dependencias.

**Cómo lo bloquea sloppy-joe:** Tu configuración asigna cada paquete canónico a sus alternativas rechazadas. Si una dependencia coincide con una alternativa, la compilación falla.```
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. Paquetes completamente nuevos

**El ataque:** Un paquete creado ayer con 3 descargas que tiene un nombre similar a un paquete popular. Alta probabilidad de ser un typosquat o un marcador de posición para un ataque futuro.

**Cómo lo bloquea sloppy-joe:** Marca cualquier paquete creado hace menos de 30 días.```
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.

## Ecosistemas compatibles

| Ecosistema | Manifiesto | Política de archivo de bloqueo | Existencia | Metadatos | Control de antigüedad |
|-----------|----------|-----------------|:---------:|:--------:|:--------:|
| npm | package.json | `package-lock.json` o `npm-shrinkwrap.json` requerido | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| PyPI | `pyproject.toml`, `requirements*.txt`, `Pipfile`, `setup.cfg`, `setup.py` | Poetry es confiable con `poetry.lock`, uv es confiable con `uv.lock`, pip-tools con bloqueo de hash completo es confiable solo cuando el grafo de requisitos comprometido vincula `--index-url` y valores exactos permitidos de `--extra-index-url`, y los índices personalizados de Poetry/uv visibles en el repositorio solo se pueden confiar mediante la lista de permitidos exacta `trusted_indexes.pypi`; los manifiestos heredados advierten en cada ejecución a menos que `python_enforcement` sea `poetry_only` | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Cargo | Cargo.toml | `Cargo.lock` requerido | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Go | go.mod | `go.sum` requerido para dependencias externas; no requerido para stdlib-only o `replace` totalmente local | :white_check_mark: | :x: | :x: |
| Ruby | Gemfile | `Gemfile.lock` requerido | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| PHP | composer.json | `composer.lock` requerido | :white_check_mark: | :x: | :x: |
| JVM (Gradle) | build.gradle / build.gradle.kts | `gradle.lockfile` requerido | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| JVM (Maven) | pom.xml | solo advertencia: sin aplicación estricta de archivo de bloqueo | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| .NET | *.csproj | `packages.lock.json` requerido | :white_check_mark: | :x: | :x: |

Todos los ecosistemas reciben verificaciones de existencia, similitud y canónicas. Los metadatos y el control de antigüedad dependen de lo que expone la API del registro. El soporte de archivos de bloqueo permite el escaneo de dependencias transitivas y la resolución exacta de versiones donde el ecosistema proporciona un modelo de archivo de bloqueo local de proyecto confiable.

## Inicio Rápido```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`** — las claves son paquetes aprobados; los valores son alternativas rechazadas.

**`internal`** — paquetes de su organización. Omitir TODAS las comprobaciones. Cambian constantemente.

**`allowed`** — paquetes externos verificados. Omitir existencia + similitud, pero aún sujetos a la puerta de antigüedad de versión.

**`similarity_exceptions`** — supresiones exactas de paquete/candidato/generador para falsos positivos de similitud revisados. Úselo cuando un borde de similitud específico sea incorrecto pero aún desee comprobaciones normales en el paquete.

**`metadata_exceptions`** — supresiones exactas de metadatos revisados. Actualmente solo admite `metadata/maintainer-change` y requiere una coincidencia exacta de paquete/versión/publicador-anterior/publicador-actual.

Use `sloppy-joe check --review-exceptions` cuando necesite revisar bloqueos de cambio de mantenedor. El escaneo aún bloquea normalmente, pero la salida humana agrega una sección `REVIEW EXCEPTIONS` con propietarios, URL del repositorio y un fragmento `metadata_exceptions` listo para pegar. `--json` incluye los mismos datos en un campo de nivel superior `review_candidates`.

**`min_version_age_hours`** — bloquear cualquier versión publicada hace menos de esta cantidad de horas. Predeterminado: 72 (3 días). Establecer en 0 para deshabilitar. Los paquetes internos están exentos.

**`allow_legacy_npm_v1_lockfile`** — permitir `lockfileVersion: 1` archivos de bloqueo npm de npm v5/v6 en modo de confianza reducida. Predeterminado: `false`. Manténgalo desactivado a menos que esté intencionalmente atascado en npm heredado y acepte advertencias fuertes más cobertura transitiva npm de confianza reducida.

**`python_enforcement`** — controla la política de confianza de Python. `prefer_poetry` (predeterminado) confía en proyectos Poetry y proyectos uv, confía en requisitos de pip-tools completamente bloqueados por hash solo cuando el gráfico de requisitos comprometido vincula `--index-url` y cualquier valor `--extra-index-url` que no sea PyPI exactamente, y de lo contrario degrada pip-tools a confianza reducida. Manifiestos heredados como `requirements*.txt` sin hash, `Pipfile`, `setup.cfg`, `setup.py` y `pyproject.toml` que no sean de Poetry/uv advierten en cada ejecución. `poetry_only` bloquea esos flujos de trabajo Python no Poetry y requiere Poetry.

### Seguridad de la Configuración

La configuración **nunca se lee desde el directorio del proyecto**. Un agente de IA con acceso al shell podría reescribir una configuración en el repositorio para permitir lo que quiera.

Resolución de la configuración:
1. `--config /path/to/config.json` — archivo local (bandera CLI, prioridad máxima)
2. `--config https://example.com/config.json` — obtener desde URL
3. `SLOPPY_JOE_CONFIG=...` — variable de entorno (ruta de archivo o URL)
4. Sin configuración = solo comprobaciones de existencia + similitud + metadatos

Las configuraciones mal formadas **fallan duramente** con mensajes de error procesables: una configuración rota nunca retrocede silenciosamente a ninguna protección.

Consulte [CONFIG.md](https://github.com/brennhill/sloppy-joe/blob/HEAD/CONFIG.md) para obtener la referencia de formato completa, patrones de integración CI y ejemplos.

Configuración de arranque:```bash
sloppy-joe init --greenfield --ecosystem npm
sloppy-joe init --from-current
sloppy-joe init --from-current --register
sloppy-joe init --register

#### Entradas de acción

| Entrada | Descripción | Predeterminado |
|---------|-------------|----------------|
| `config` | Ruta de archivo de configuración o URL HTTPS | *(ninguno)* |
| `dir` | Directorio del proyecto a escanear | `.` |
| `type` | Ecosistema (`npm`, `pypi`, `cargo`, `go`, `ruby`, `php`, `jvm`, `dotnet`) | detección automática |
| `deep` | Habilitar comprobaciones de similitud de dependencias transitivas | `false` |
| `paranoid` | Habilitar mutaciones de bitflip | `false` |
| `args` | Argumentos CLI adicionales | *(ninguno)* |
| `version` | versión de sloppy-joe a instalar | `latest` |

#### Ejemplos```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 funciona con el framework [pre-commit](https://pre-commit.com).
Agrégalo a tu `.pre-commit-config.yaml`:```yaml
# .pre-commit-config.yaml
repos:
  - repo: https://github.com/brennhill/sloppy-joe
    rev: v1.1.0
    hooks:
      - id: sloppy-joe

O usa un simple hook de shell sin el framework:```bash
#!/bin/sh
sloppy-joe check || exit 1

Similitud ejecuta 4 fases:
- **Fase 0: Suplantación de ámbito** — verificación local, sin red. Compara el ámbito/namespace con ámbitos conocidos mediante distancia de Levenshtein.
- **Fase 1: Intra-manifiesto** — verificación local. Señala cuando dos dependencias en el mismo manifiesto son mutaciones entre sí.
- **Fase 2: Consulta al registro** — genera mutaciones, consulta por lotes al registro para verificar existencia, almacena en caché los resultados (TTL de 7 días).
- **Fase 3: Enriquecimiento de metadatos** — obtiene conteos de descargas y fechas de publicación para coincidencias, añadiendo evidencia a los informes.

Cada generador de mutaciones etiqueta su salida, por lo que el tipo de verificación reportado (ej., `similarity/homoglyph`) es determinista: el generador de mayor severidad gana cuando múltiples generadores producen el mismo candidato.

## Fiabilidad en CI

sloppy-joe está diseñado para pipelines de CI donde fallos inestables son inaceptables.

**Reintento con retroceso.** Todas las llamadas HTTP al registro reintentan 3 veces con retroceso exponencial (200ms, 400ms, 800ms) en fallos transitorios (5xx, tiempos de espera, errores de conexión). Un solo error de red no arruinará tu build.

**Fallo cerrado en errores de consulta.** Si las consultas al registro o a OSV fallan, sloppy-joe emite un error bloqueante `registry-unreachable` en lugar de saltar silenciosamente las verificaciones. El escaneo ya no depende de umbrales por ecosistema o límites de tamaño de muestra antes de bloquear.

**Caché de similitud.** Los resultados de existencia de mutaciones se almacenan en caché durante 7 días. Después del primer escaneo, la mayoría de las consultas se sirven desde la caché sin llamadas de red. Solo las dependencias nuevas activan consultas al registro.

**Resolución consciente del archivo de bloqueo.** Cuando un archivo de bloqueo compatible está presente y es confiable (`package-lock.json`, `npm-shrinkwrap.json`, `Cargo.lock`, `Gemfile.lock`, `poetry.lock` para proyectos Poetry, `uv.lock` para proyectos uv, `composer.lock`, `gradle.lockfile`, `packages.lock.json`), sloppy-joe resuelve versiones exactas a partir de él en lugar de adivinarlas a partir de rangos. Los archivos `requirements*.txt` con hash completo también pueden proporcionar versiones exactas fijadas, y se vuelven completamente confiables cuando el grafo de requerimientos comprometido vincula su propio `--index-url` y valores `--extra-index-url` exactos en lista blanca.

## Pruebas

La suite de pruebas cubre verificaciones de similitud, señales de metadatos, comportamiento de OSV, análisis y validación de configuración, resolución de archivos de bloqueo, política de pre-vuelo para manifiestos y archivos de bloqueo, formato de informes y lógica de reintentos HTTP.```bash
cargo test