macOS / Linux (Homebrew)```bash

Homebrew

brew install depsguard

Ou baixe manualmente via PowerShell:```powershell $zip = "$env:TEMP\depsguard.zip" Invoke-WebRequest -Uri "https://github.com/arnica/depsguard/releases/latest/download/depsguard-x86_64-pc-windows-msvc.zip" -OutFile $zip Expand-Archive -LiteralPath $zip -DestinationPath "$env:TEMP\depsguard" -Force Copy-Item "$env:TEMP\depsguard\depsguard.exe" "$HOME\AppData\Local\Microsoft\WindowsApps\depsguard.exe" -Force depsguard.exe --help

Requer uma cadeia de ferramentas Rust com cargo.

Gerenciadores de pacotes (quando publicados pelo seu fornecedor)

Se a sua organização distribui o DepsGuard via Homebrew, Scoop ou WinGet, use as instruções correspondentes. Configurar ou automatizar esses canais (PRs do Homebrew core, buckets, PRs do WinGet, segredos de CI) é documentação de mantenedores; consulte AGENTS.md na seção Release & distribution.

Lojas de aplicativos / gerenciadores de pacotes

Atualizar para a versão mais recente

Use o canal pelo qual você instalou:

Verifique sua versão instalada a qualquer momento com depsguard --version e veja a página de releases para a versão mais recente.

Compilar a partir do código-fonte```bash

git clone https://github.com/arnica/depsguard.git cd depsguard cargo build --release

Como usar

1. Instale – escolha sua plataforma acima.
2. Execute depsguard para iniciar a TUI interativa. Ela verifica seu sistema e mostra uma tabela de resultados. Pressione qualquer tecla para continuar para o seletor de correções. A descoberta de configurações no nível do repositório começa no diretório atual e busca para baixo. Use depsguard scan para um relatório somente leitura, ou depsguard --no-search para pular a busca recursiva de arquivos e verificar apenas configurações de nível de usuário.

   Nota: algumas configurações exigem uma versão mínima. Se sua versão for muito antiga, você verá: ℹ min-release-age – requires npm ≥ 11.10 (have 10.2.0). Atualize com npm install -g npm@latest e execute novamente.

3. Navegue e selecione – use ↑ ↓ para percorrer a lista (^u ^d para paginar). Pressione Espaço para ativar ou desativar uma correção. Use as teclas de filtro rápido para selecionar em massa por arquivo: a todos, n .npmrc, u uv.toml, etc. – pressione uma vez para selecionar, novamente para desmarcar, uma terceira vez para limpar o filtro. Pressione f para mostrar apenas as correções atualmente selecionadas.
4. Pré-visualize – pressione d para ver um diff do que será alterado antes de confirmar qualquer coisa.
5. Aplique – pressione Enter para aplicar as correções selecionadas. Um backup com carimbo de data/hora é criado antes de qualquer arquivo ser gravado.
6. Reexamine – o DepsGuard executa novamente a verificação automaticamente após aplicar, para que você possa confirmar que está tudo verde.
7. Restaure – execute depsguard restore a qualquer momento para reverter a partir da lista de backups. Pressione q ou Esc para sair.

O que é verificado

Localizações dos arquivos de configuração

Os arquivos de configuração de nível de usuário são lidos de suas localizações padrão (incluindo caminhos baseados em XDG quando a ferramenta os suporta). As configurações de nível de repositório são descobertas procurando a partir do diretório atual, ignorando diretórios grandes conhecidos (node_modules, .git, target, Library, .cache e outros) para que as verificações permaneçam rápidas. .npmrc, .yarnrc.yml, pnpm-workspace.yaml, configurações do Renovate e configurações do Dependabot de nível de repositório são todos pesquisados. As configurações do pnpm podem estar em ~/.npmrc (apenas pnpm <= 10; pnpm >= 11 lê apenas configurações de autenticação/registro do .npmrc), no arquivo de configuração global do pnpm (rc em pnpm <= 10, config.yaml em pnpm >= 11), ou em pnpm-workspace.yaml; o DepsGuard verifica os três locais independentemente. Para pip, uv e poetry, o DepsGuard resolve a única configuração efetiva de nível de usuário e relata apenas esse arquivo, em vez de sinalizar separadamente arquivos sombreados. pip e poetry mesclam seus arquivos de configuração por precedência (o arquivo de maior precedência que define o cooldown vence, ou a localização preferida se nenhum o fizer); uv lê um único arquivo de usuário ($XDG_CONFIG_HOME/uv/uv.toml quando XDG_CONFIG_HOME está definido, caso contrário ~/.config/uv/uv.toml) em vez de mesclar ambos. Para bun, se existirem vários arquivos de configuração de nível de usuário (por exemplo, um caminho XDG e um caminho no diretório inicial), o DepsGuard verifica cada arquivo existente separadamente. aube lê o mesmo ~/.npmrc que npm/pnpm (minimumReleaseAge, em minutos) e também é verificado nos arquivos .npmrc de nível de repositório descobertos; pip e poetry são verificados em sua configuração de nível de usuário (pip.conf / pypoetry/config.toml).

Correção de segurança urgente

Se a versão corrigida for mais nova que sua janela de cooldown, adicione uma exceção restrita, instale a correção e depois remova a exceção.

Prefira uma exceção específica ao pacote em vez de reduzir o cooldown global. Isso mantém o atraso para todas as outras dependências.

Antes de ignorar o cooldown:

1. Verifique se o CVE realmente afeta seu uso.
2. Verifique se uma versão anterior conhecida como boa já está disponível. Um rollback pode ser mais seguro.
3. Remova exceções temporárias após a atualização.

Backups e restauração

Antes de modificar um arquivo, o DepsGuard grava um backup em ~/.depsguard/backups/.

Execute depsguard restore para listar backups e restaurar um.

Como funciona```

src/ main.rs CLI args, run loop term.rs Raw mode + input (Unix termios / Windows console FFI) manager.rs Detection, scanning, recommendations fix.rs Read/write .npmrc, TOML, YAML; backup/restore ui.rs Banner, tables, selector