
Protege contra ataques de supply-chain, slopsquatting e typosquatting provenientes de dependências e código.
cargo install sloppy-joe
Versões comprometidas podem usar um nome de pacote legítimo. O relatório do mantenedor do LiteLLM identifica as versões maliciosas 1.82.7 e 1.82.8 em março de 2026. O filtro padrão de 72 horas de idade de publicação do sloppy-joe pode rejeitar versões recém-publicadas quando você escaneia o grafo de dependências resolvido com
--ciou--fullantes da instalação. Trata-se de uma política de temporização, não de inspeção do payload malicioso.
Pesquisas documentam alucinações de pacotes em código gerado. O sloppy-joe verifica nomes e metadados de dependências antes da instalação; a mera existência não pode estabelecer que um pacote registrado seja seguro.
Os nomes de pacotes são limitados a 214 bytes para npm e 1.024 bytes para outros ecossistemas, a fim de limitar o trabalho de análise de erros de digitação. Nomes mais longos reportam Scan not supported (saída 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 bloqueia lockfiles que não consegue modelar ou confiar: um lockfile ausente ou desatualizado, um lockfile pnpm
anterior a 9.0, um npm lockfileVersion: 1, um bun.lockb, um lockfile sombra sob um
membro do workspace. Cada erro desse tipo indica o comando exato e a versão mínima da ferramenta.
sloppy-joe fix-lockfile [--dir D] [--type T] [--config C] [--write] [--json] planeja cada problema
como uma das seguintes classes:
| Classe | Significado |
|---|---|
fixable | O comando é executado para você, em uma cópia de rascunho privada, com scripts desabilitados |
guided | O comando manual é mostrado com o motivo de não ser automatizado (Bundler, Gradle e .NET restore executam código do repositório; Pipenv e pip-compile re-resolvem ou compilam sdists; Yarn Classic não tem modo somente-lockfile) |
human | Nenhuma correção segura: achados de integridade, origem e proveniência, pins de manifesto que divergem do lockfile, e reescritas de dependências (overrides, resolutions, patchedDependencies) |
Um candidato fixable só é gravado se mantiver todas as versões travadas, hashes de integridade e fontes
que o projeto ainda alcança, adicionar pacotes apenas para dependências diretas que o lockfile antigo não tinha,
for analisado pelo próprio parser do scanner e passar por uma nova varredura completa com check --full. O diff de versões é
impresso antes de qualquer gravação; sem --write nada no projeto muda. A ferramenta
é executada como um vetor de argumentos com um ambiente construído do zero (HOME, caches e config no
diretório de rascunho, apenas entradas absolutas de PATH fora do projeto), com timeout e sem stdin;
um projeto com superfície de execução de código para a ferramenta (um pnpmfile, plugins do Yarn, configurações de script no .npmrc, wrappers do Cargo, repositórios VCS do Composer, plugins do Poetry, uma linha toolchain do Go, dependências git ou de caminho local) é recusado antes da ferramenta ser executada. O status de saída é 0 quando nada precisava
ser corrigido ou toda correção foi verificada (e gravada com --write), 1 quando resta um problema, uma correção
foi recusada ou uma ferramenta falhou, e 2 em caso de erro de runtime. Consulte
docs/specs/fix-lockfile.md para o catálogo completo.
nix profile install github:brennhill/sloppy-joe
O flake em main fixa a versão binária publicada e os respetivos checksums.
Modos de análise:
sloppy-joe check executa a verificação local rápida. Aplica sempre a análise do manifesto, a sincronização do lockfile, a proveniência e a política de fontes não suportadas. Se o estado das dependências ou da política tiver mudado, ou se a última análise completa bem-sucedida tiver mais de 24 horas, recomenda sloppy-joe check --full.sloppy-joe check --full executa a análise online estrita e atualiza o estado registado da última análise completa bem-sucedida.sloppy-joe check --ci executa a mesma cobertura estrita que --full, com uma intenção orientada a CI.sloppy-joe check analisa todos os grupos de dependências declarados (grupos Poetry, [dependency-groups] PEP 735, incluindo include-group, dependências de desenvolvimento uv/PDM, ambientes Hatch) e todas as extras por predefinição, porque uv e Poetry instalam grupos sem flags adicionais. --python-groups e --python-extras restringem a análise aos grupos/extras indicados e emitem um aviso (resolution/python-groups-not-scanned) sobre os declarados que ficam de fora. Os marcadores de ambiente nunca removem um pacote da análise: uma dependência cujo marcador é falso para o alvo (ou que o avaliador não consegue decidir) continua a ser sujeita a verificações de política de fontes, existência, metadados e vulnerabilidades, porque outra máquina a instala. Para Poetry e uv, os marcadores apenas determinam qual a versão bloqueada que o alvo resolve; são avaliados para o host atual, a menos que passe --python-platform, --python-arch ou --python-version, e o sloppy-joe emite um aviso quando isso aconteceu implicitamente.sloppy-joe check lembra sempre para usar --ci ou --full para gating de CI e produção.