¿Qué hace npm?
Úsalo para tareas del registro npm/cuenta: npm whoami, disponibilidad de paquetes, reserva de paquetes, publicación, comprobaciones de organizaciones y depuración de autenticación.
Autenticación
- Usa
one-passwordprimero para las reglas de secretos. - Nunca ejecutes
opdirectamente en la herramienta de shell. - Elemento principal:
npm Registry - steipete - Release AutomationenMolty. - Por defecto, usa
OP_SERVICE_ACCOUNT_TOKEN; no es necesario desbloquear el escritorio. El elemento contiene la sesión activa del registro (registry_token) además del respaldo de usuario/contraseña/TOTP. - El respaldo de escritorio
npmjssolo es explícito: pasa--account my.1password.comcuando Molty no está disponible y el usuario quiere el respaldo. Las solicitudes explícitas derelease/publishimplican consentimiento para su solicitud de desbloqueo. - Detente y pregunta si falta el elemento, la cuenta/bóveda es ambigua, las credenciales están mal formadas, npm deniega el acceso al paquete, o el paquete/versión solicitado no coincide con el destino de lanzamiento del repositorio.
- Ejecuta el trabajo de autenticación npm dentro de una única sesión persistente de tmux. Reutilízala en caso de fallo.
- Mantén la autenticación npm en un npmrc temporal; elimínalo después del comando.
- Todos los ayudantes comparten
scripts/npm-auth.sh: primero la sesión almacenadaregistry_token, luego el inicio de sesión en el registro conscripts/npm-auth-login.mjsusando un OTP de seis dígitos fresco; las sesiones de respaldo exitosas se guardan en el mismo elemento. No implementes manualmente la extracción de campos, el inicio de sesión en el registro ni la escritura de la caché. - La selección de credenciales prefiere el campo canónico
id, luegopurpose, luego una etiqueta única; las coincidencias duplicadas solo por etiqueta se rechazan (el legadonpmjspuede conservar campos con la misma etiqueta). - Para comandos ad-hoc del registro autenticados, usa
scripts/npm-service.sh -- <npm args...>; usapublish-package.shpara paquetes locales. - El piping de prompts de npm 11 es frágil; evita
printf ... | npm login --auth-type=legacy. - Evita
expectpara el inicio de sesión npm a menos que sea necesario; los registros pueden hacer eco de los prompts y es fácil equivocarse. - Prefiere la ruta de inicio de sesión API del registro del ayudante (
npm-profileloginCouch) para la automatización. - Si la forma de autenticación es ambigua o
npm whoamifalla, detente y pregunta por la etiqueta de campo exacta o la corrección de la credencial. No explores más elementos de 1Password ni inicies otra sesión de tmux.
Publicación de Paquetes
Desde la raíz del paquete, dentro de la misma sesión de tmux de autenticación:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
El ayudante verifica la identidad, rechaza una versión de paquete existente, publica con un OTP nuevo, reintenta un OTP caducado, verifica la visibilidad en el registro y limpia los archivos de autenticación.
Reserva de Paquetes
Usa scripts/reserve-packages.sh desde la misma sesión de tmux:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh package-one package-two
Qué hace:
- lee el elemento de automatización de lanzamientos de Molty una vez mediante
op - reutiliza la sesión de registro almacenada o crea una a partir de usuario/contraseña/TOTP
- publica paquetes placeholder
0.0.0con un README genérico - continúa después de fallos de publicación por paquete
- enmascara tokens/OTP en los registros
- limpia npmrc temporal/directorios de trabajo
Notas:
- npm puede rechazar nombres por ser demasiado similares a nombres ya publicados. Trátalo como un resultado de la política del registro, no como un fallo de autenticación.
- El piping de prompts de la CLI de npm es frágil en npm 11. Prefiere la ruta de inicio de sesión API del ayudante sobre
npm logincon script. - Para paquetes con ámbito,
npm viewpuede retrasarse/dar 404 incluso cuando el paquete existe. Comprueba connpm access get status <pkg>;publico un fallo de publicación que digapreviously published versionssignifica que el nombre está reservado.