
Protege contra ataques de cadena de suministro, slopsquatting y typosquatting provenientes de dependencias y código.
cargo install sloppy-joe
Las versiones comprometidas pueden usar el nombre legítimo de un paquete. El informe del mantenedor de LiteLLM identifica las versiones maliciosas 1.82.7 y 1.82.8 en marzo de 2026. La barrera predeterminada de 72 horas de antigüedad de publicación de sloppy-joe puede rechazar versiones recién publicadas cuando se escanea el grafo de dependencias resuelto con
--cio--fullantes de la instalación. Se trata de una política de temporización, no de una inspección de la carga maliciosa.
La investigación documenta alucinaciones de paquetes en código generado. sloppy-joe verifica los nombres y metadatos de las dependencias antes de la instalación; la mera existencia no puede establecer que un paquete registrado sea seguro.
Los nombres de paquetes están limitados a 214 bytes para npm y 1,024 bytes para otros ecosistemas para acotar el trabajo de análisis de errores tipográficos. Los nombres más largos informan Scan not supported (salida 2).
# Install (single static binary, no runtime dependencies)
cargo install sloppy-joe
# Or download a prebuilt binary archive from GitHub Releases
# https://github.com/brennhill/sloppy-joe/releases
# Fast local guardrail — auto-detects ecosystem from manifest files
sloppy-joe check
# Strict online scan (recommended before push / release)
sloppy-joe check --full
# Strict CI-oriented scan
sloppy-joe check --ci
# Check a specific directory
sloppy-joe check --dir ./my-project
# Check only npm dependencies
sloppy-joe check --type npm
# Python: every dependency group and extra is scanned by default.
# Narrow to the groups/extras your install actually uses (others are reported as not scanned)
sloppy-joe check --python-groups dev,test --python-version 3.12
sloppy-joe check --python-extras docs --python-platform linux --python-version 3.12
# Enforce canonical rules and org standards via config
sloppy-joe check --config /etc/sloppy-joe/config.json
# Config from a URL (useful in CI — no secrets to manage)
sloppy-joe check --config https://raw.githubusercontent.com/yourorg/security-configs/main/sloppy-joe.json
# JSON output for CI pipelines
sloppy-joe check --json
# Review exact maintainer-change exceptions with evidence
sloppy-joe check --review-exceptions
# Create and register a safe per-repo config outside the repo
sloppy-joe init --register
# Create an ecosystem-specific greenfield starter policy
sloppy-joe init --greenfield --ecosystem npm
# Print review-only bootstrap suggestions for an npm or Cargo repo
sloppy-joe init --from-current
# Or write/register those suggestions safely outside the repo
sloppy-joe init --from-current --register
# Or write a config manually to a secure path outside the repo
sloppy-joe init > /secure/location/sloppy-joe.json
# Explain every lockfile problem check blocks on, and verify the safe fixes (writes nothing)
sloppy-joe fix-lockfile
# Write the verified lockfiles (the previous file is kept as <name>.sloppy-joe.bak)
sloppy-joe fix-lockfile --write
check se bloquea ante archivos de bloqueo que no puede modelar o en los que no confía: un archivo de bloqueo ausente o desactualizado, un archivo de bloqueo de pnpm anterior a 9.0, un lockfileVersion: 1 de npm, un bun.lockb, un archivo de bloqueo en la sombra bajo un miembro del espacio de trabajo. Cada error de este tipo indica el comando exacto y la versión mínima de la herramienta.
sloppy-joe fix-lockfile [--dir D] [--type T] [--config C] [--write] [--json] planifica cada problema como uno de los siguientes:
| Clase | Significado |
|---|---|
fixable | El comando se ejecuta por ti, en una copia de trabajo privada, con los scripts deshabilitados |
guided | Se muestra el comando manual junto con el motivo por el que no está automatizado (Bundler, Gradle y la restauración de .NET ejecutan código del repositorio; Pipenv y pip-compile vuelven a resolver o compilan sdists; Yarn Classic no tiene modo de solo archivo de bloqueo) |
human | No hay una corrección segura: hallazgos de integridad, origen y procedencia, fijaciones del manifiesto que no coinciden con el archivo de bloqueo, y reescrituras de dependencias (overrides, resolutions, patchedDependencies) |
Un candidato corregible solo se escribe si conserva cada versión bloqueada, hash de integridad y origen que el proyecto aún alcanza, añade paquetes solo para dependencias directas que faltaban en el archivo de bloqueo antiguo, se analiza con el propio analizador del escáner y supera un reescaneo completo con check --full. La diferencia de versiones se imprime antes de escribir nada; sin --write nada cambia en el proyecto. La herramienta se ejecuta como un vector de argumentos con un entorno construido desde cero (HOME, cachés y configuración en el directorio de trabajo, solo entradas absolutas de PATH fuera del proyecto), un tiempo de espera y sin stdin; un proyecto con una superficie de ejecución de código para la herramienta (un pnpmfile, plugins de Yarn, ajustes de scripts en .npmrc, envoltorios de Cargo, repositorios VCS de Composer, plugins de Poetry, una línea toolchain de Go, dependencias de git o de ruta local) se rechaza antes de que se ejecute la herramienta. El estado de salida es 0 cuando no había nada que corregir o cada corrección se verificó (y se escribió con --write), 1 cuando queda un problema, se rechazó una corrección o falló una herramienta, y 2 ante un error de tiempo de ejecución. Consulta
docs/specs/fix-lockfile.md para el catálogo completo.
nix profile install github:brennhill/sloppy-joe
El flake en main fija la versión binaria publicada y sus sumas de verificación.