Preguntas frecuentes

Lo que los desarrolladores preguntan primero

¿Sube mi código?

No. pinright envía nombres y versiones de paquetes a servicios públicos (deps.dev, OSV, los registros, jsDelivr, GitHub), nunca tu código fuente, el contenido de tus archivos ni tu entorno. El nombre de un paquete privado que revisas sí llega a esos servicios. Sin telemetría, sin cuenta. Qué va adónde

¿Qué ecosistemas cubre?

Veredictos y auditorías: npm, PyPI, Cargo, Go, RubyGems, NuGet, Maven y Gradle, Composer y GitHub Actions. El hook lee comandos de instalación de la mayoría y escrituras de manifiestos de todos menos RubyGems y NuGet. La documentación de la versión exacta cubre paquetes de npm y PyPI y repositorios de GitHub.

¿Qué pasa si un registro o una base de datos de avisos no responde?

pinright dice ok solo cuando respondieron deps.dev y OSV. Si no, el veredicto es unknown y nombra el host. El .pinright.json inicial que escribe init hace que el hook te pregunte; sin archivo de política, permite el cambio y le avisa al agente que no se pudo verificar. Una revisión que pasa de 45 segundos le pregunta a una persona. Las respuestas quedan en caché 24 horas, la documentación 7 días.

¿En qué se diferencia de Dependabot o npm audit?

Esas herramientas informan sobre dependencias que ya están en tu lockfile o tu repositorio. pinright actúa antes, mientras el agente elige la versión: nombra una versión sin avisos en la línea que usas, le da al agente la documentación de esa versión, y el hook revisa la instalación antes de que se ejecute. También revisa nombres parecidos, registros de malware y paquetes que no existen. Para CI, pinright audit y la Action auditan todo el árbol; sobre 394 lockfiles del benchmark marcaron los mismos paquetes que npm audit y pip-audit. Úsalos juntos.

¿Hace más lento a mi agente?

Un poco. El hook tardó 121 ms en la mediana con un comando que no instala nada, 358 ms con una instalación y caché caliente, y 2,4 s en frío. En el benchmark, las ejecuciones con el servidor MCP necesitaron unos 2 a 4 turnos más y de 1,5 a 2 veces el costo equivalente en API de una ejecución sin herramientas. Una instalación global arranca más rápido que npx; mira la sección Latency del README (en inglés).

¿Se puede saltar el hook?

Sí. Lee comandos y no aísla procesos. El código que llama a pip desde dentro de un programa, curl … | sh, la ofuscación fuerte y las herramientas a las que el hook no está conectado pasan sin revisión. Lo que no puede leer pregunta por defecto. Mantén un registro proxy y ejecuta los agentes en un sandbox. El modelo de amenazas en breve

¿"ok" quiere decir que un paquete está limpio?

Quiere decir que no hay ningún aviso ni registro de malware publicado para esa versión, y que el nombre no parece un error de tipeo de uno popular. pinright solo conoce los avisos publicados. Para ataques muy nuevos suma señales de cadena de suministro, y el hook bloquea dos patrones: un paquete de menos de 14 días que ejecuta scripts de instalación, y una versión que agrega scripts de instalación y viene de alguien que nunca publicó las versiones anteriores.

El hook bloqueó algo que no debía. ¿Y ahora?

Agrega el nombre a "allow" en .pinright.json para dejarlo pasar, y reporta el falso positivo con el comando exacto y la salida de pinright doctor --json. Es el reporte que más valoramos.

¿Cuánto cuesta?

Nada. Sin cuenta, sin clave, sin plan de pago. Los datos vienen de servicios públicos. El único costo son los turnos extra del agente que se describen arriba.

¿Qué licencia tiene?

MIT, de Hiper AI. Las contribuciones son bienvenidas; empieza por CONTRIBUTING.md. Preguntas: opensource@hiperai.com.