Repolode
yowainwright

yowainwright/pastoralist

CLI que registra cada override de dependencias de package.json en un apéndice y busca problemas de seguridad para mantenerlos de forma segura.

Estrellas
109
Forks
56
Issues abiertos
1
Último commit
hace 15 horas

¿Qué es?

Pastoralist mantiene actualizados los overrides de dependencias (npm overrides, pnpm overrides, Yarn resolutions y Bun overrides). Al ejecutarlo, añade un apéndice a package.json que indica, para cada override, qué paquetes dependen de él, cuándo se registró por primera vez y si todavía se puede eliminar.

La herramienta admite proyectos de npm, pnpm (incluido pnpm-workspace.yaml en pnpm 11 o posterior), Yarn y Bun, y gestiona monorepos mediante rutas de workspace y patrones glob de manifiestos. Un comando doctor de solo lectura permite previsualizar los cambios, y el comando principal admite --dry-run.

Las comprobaciones de vulnerabilidades son opcionales y se ejecutan con proveedores como OSV (el predeterminado), GitHub, Snyk, npm, Socket y Spektion. Los hallazgos se pueden corregir de forma interactiva o aplicar automáticamente, y los resultados se pueden guardar en caché o generar en formato JSON para CI.

Funciones clave

  • 01Registra cada override en package.json junto con sus dependencias y la fecha en que se registró por primera vez.
  • 02Admite los formatos de override de npm, pnpm, Yarn y Bun.
  • 03Permite previsualizar los cambios con un comando doctor de solo lectura o con --dry-run.
  • 04Busca vulnerabilidades con OSV, GitHub, Snyk, npm, Socket y Spektion.
  • 05Detecta overrides sin usar y puede eliminar los que se hayan verificado.
  • 06Genera JSON legible por máquinas y, en modo silencioso, devuelve un código de salida distinto de cero si encuentra problemas de seguridad.

Casos de uso

  • Documentar y mantener actualizados los overrides de dependencias transitivas para corregir problemas de seguridad.
  • Auditar qué overrides siguen siendo necesarios antes de eliminarlos.
  • Añadir una comprobación de seguridad de dependencias a los pipelines de CI.
  • Mantener overrides en un monorepo con varios manifiestos de paquetes.

Inicio rápido

  1. 1

    Instala la CLI global con npm

    npm install --global pastoralist
  2. 2

    Instálala como dependencia de desarrollo en tu proyecto

    npm install pastoralist --save-dev
  3. 3

    Previsualiza los cambios con la comprobación de estado de solo lectura

    npx pastoralist doctor
  4. 4

    Ejecuta pastoralist para actualizar el apéndice de sobrescrituras

    npx pastoralist

Antes de usarlo

  • Es posible que necesites tokens de API para usar proveedores de análisis de seguridad como GitHub, Snyk y Socket.

En colecciones

Temas

Preguntas frecuentes

¿Qué es pastoralist?
CLI que registra cada override de dependencias de package.json en un apéndice y busca problemas de seguridad para mantenerlos de forma segura. Pastoralist mantiene actualizados los overrides de dependencias (npm overrides, pnpm overrides, Yarn resolutions y Bun overrides). Al ejecutarlo, añade un apéndice a package.json que indica, para cada override, qué paquetes dependen de él, cuándo se registró por primera vez y si todavía se puede eliminar.
¿pastoralist es gratuito? ¿Qué licencia tiene?
pastoralist es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿pastoralist sigue mantenido?
Mantenimiento activo. El último commit de pastoralist fue el 22 oct 2026.
¿Para qué puedo usar pastoralist?
Documentar y mantener actualizados los overrides de dependencias transitivas para corregir problemas de seguridad. Auditar qué overrides siguen siendo necesarios antes de eliminarlos. Añadir una comprobación de seguridad de dependencias a los pipelines de CI. Mantener overrides en un monorepo con varios manifiestos de paquetes.
¿Cómo se instala pastoralist?
Instala la CLI global con npm: npm install --global pastoralist Instálala como dependencia de desarrollo en tu proyecto: npm install pastoralist --save-dev Previsualiza los cambios con la comprobación de estado de solo lectura: npx pastoralist doctor Ejecuta pastoralist para actualizar el apéndice de sobrescrituras: npx pastoralist
¿Dónde consigo pastoralist?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/yowainwright/pastoralist

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados