Repolode
yowainwright

yowainwright/pastoralist

Uma CLI que registra cada override de dependência do package.json em um apêndice e verifica problemas de segurança para manter os overrides com segurança.

Estrelas
109
Forks
56
Issues abertas
1
Último commit
há 15 horas

O que é?

O Pastoralist mantém os overrides de dependências (npm overrides, pnpm overrides, Yarn resolutions, Bun overrides) atualizados ao longo do tempo. Ao executá-lo, um apêndice é adicionado ao package.json com informações sobre cada override: quais pacotes dependem dele, quando foi registrado pela primeira vez e se ainda pode ser removido.

A ferramenta é compatível com projetos npm, pnpm (incluindo pnpm-workspace.yaml no pnpm 11+), Yarn e Bun, além de lidar com monorepos usando caminhos de workspace e globs de manifests. Um comando doctor somente leitura permite pré-visualizar as alterações, e --dry-run também funciona no comando principal.

As verificações opcionais de vulnerabilidades consultam provedores como OSV (o padrão), GitHub, Snyk, npm, Socket e Spektion. Os problemas encontrados podem ser corrigidos de forma interativa ou automática, e os resultados podem ser armazenados em cache ou exportados como JSON para CI.

Recursos principais

  • 01Registra cada override no package.json, incluindo suas dependências e a data do primeiro registro.
  • 02É compatível com os formatos de override de npm, pnpm, Yarn e Bun.
  • 03Permite pré-visualizar alterações com o comando doctor somente leitura ou usando --dry-run.
  • 04Verifica vulnerabilidades usando OSV, GitHub, Snyk, npm, Socket e Spektion.
  • 05Encontra overrides não utilizados e pode remover os que foram verificados.
  • 06Gera JSON legível por máquina e retorna um código diferente de zero quando encontra problemas de segurança no modo quiet.

Casos de uso

  • Manter overrides de dependências transitivas para correções de segurança documentados e atualizados.
  • Auditar quais overrides ainda são necessários antes de removê-los.
  • Adicionar uma verificação de segurança de dependências aos pipelines de CI.
  • Manter overrides em um monorepo com vários manifests de pacotes.

Início rápido

  1. 1

    Instale a CLI global com npm

    npm install --global pastoralist
  2. 2

    Instale como dependência de desenvolvimento no seu projeto

    npm install pastoralist --save-dev
  3. 3

    Visualize as alterações com a verificação de integridade somente leitura

    npx pastoralist doctor
  4. 4

    Execute pastoralist para atualizar o apêndice de substituições

    npx pastoralist

Antes de usar

  • Provedores de verificação de segurança como GitHub, Snyk e Socket podem exigir tokens de API para uso.

Em coleções

Tópicos

Perguntas frequentes

O que é pastoralist?
Uma CLI que registra cada override de dependência do package.json em um apêndice e verifica problemas de segurança para manter os overrides com segurança. O Pastoralist mantém os overrides de dependências (npm overrides, pnpm overrides, Yarn resolutions, Bun overrides) atualizados ao longo do tempo. Ao executá-lo, um apêndice é adicionado ao package.json com informações sobre cada override: quais pacotes dependem dele, quando foi registrado pela primeira vez e se ainda pode ser removido.
pastoralist é gratuito? Qual é a licença?
pastoralist é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
pastoralist ainda é mantido?
Manutenção ativa. O último commit de pastoralist foi em 22 de out. de 2026.
Para que posso usar pastoralist?
Manter overrides de dependências transitivas para correções de segurança documentados e atualizados. Auditar quais overrides ainda são necessários antes de removê-los. Adicionar uma verificação de segurança de dependências aos pipelines de CI. Manter overrides em um monorepo com vários manifests de pacotes.
Como instalar pastoralist?
Instale a CLI global com npm: npm install --global pastoralist Instale como dependência de desenvolvimento no seu projeto: npm install pastoralist --save-dev Visualize as alterações com a verificação de integridade somente leitura: npx pastoralist doctor Execute pastoralist para atualizar o apêndice de substituições: npx pastoralist
Onde consigo pastoralist?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yowainwright/pastoralist

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados