Que fait npm ?
Utilisation pour les tâches relatives au registre/compte npm : npm whoami, disponibilité des paquets, réservation de paquets, publication, vérifications d'organisation et débogage de l'authentification.
Authentification
- Utilisez
one-passworden premier pour les règles secrètes. - N'exécutez jamais
opdirectement dans l'outil shell. - Élément principal :
npm Registry - steipete - Release AutomationdansMolty. - Par défaut, utilisez
OP_SERVICE_ACCOUNT_TOKEN; pas de déverrouillage du bureau. L'élément contient la session de registre active (registry_token) ainsi que le nom d'utilisateur/mot de passe/TOTP de secours. - La sauvegarde du bureau
npmjsest explicite uniquement : passez--account my.1password.comlorsque Molty est indisponible et que l'utilisateur souhaite cette sauvegarde. Les demandes explicites derelease/publishsont un consentement pour son invite de déverrouillage. - Arrêtez-vous et demandez si l'élément est manquant, le compte/coffre est ambigu, les informations d'identification sont malformées, npm refuse l'accès au paquet, ou si la version/le paquet demandé ne correspond pas à la cible de publication du dépôt.
- Exécutez le travail d'authentification npm dans une seule session tmux persistante. Réutilisez-la en cas d'échec.
- Gardez l'authentification npm dans un npmrc temporaire ; supprimez-le après la commande.
- Tous les assistants partagent
scripts/npm-auth.sh: d'abord la sessionregistry_tokenstockée, puis la connexion au registre viascripts/npm-auth-login.mjsavec un nouveau code OTP à six chiffres ; les sessions de secours réussies sont mises en cache dans le même élément. N'extrayez pas les champs, ne vous connectez pas au registre, et n'écrivez pas manuellement dans le cache. - La sélection des informations d'identification privilégie le champ canonique
id, puispurpose, puis un libellé unique ; les correspondances de libellés en double uniquement sont rejetées (lenpmjshérité peut conserver des champs avec le même libellé). - Pour les commandes de registre authentifiées ponctuelles, utilisez
scripts/npm-service.sh -- <arguments npm...>; utilisezpublish-package.shpour un paquet local. - Le pipe des invites npm 11 est fragile ; évitez
printf ... | npm login --auth-type=legacy. - Évitez
expectpour la connexion npm sauf si nécessaire ; les journaux peuvent faire écho aux invites et sont faciles à mal interpréter. - Préférez le chemin de connexion à l'API du registre de l'assistant (
npm-profileloginCouch) pour l'automatisation. - Si la forme des informations d'identification est ambiguë ou si
npm whoamiéchoue, arrêtez-vous et demandez le libellé exact du champ / la correction des informations d'identification. Ne sondez pas plus d'éléments 1Password et ne démarrez pas une autre session tmux.
Publication de paquets
Depuis la racine du paquet, dans la même session tmux d'authentification :
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
L'assistant vérifie l'identité, refuse une version de paquet déjà existante, publie avec un nouveau code OTP, réessaie en cas d'OTP expiré, vérifie la visibilité sur le registre et nettoie les fichiers d'authentification.
Réservation de paquets
Utilisez scripts/reserve-packages.sh depuis la même session tmux :
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh paquet-un paquet-deux
Ce qu'il fait :
- lit l'élément d'automatisation de publication Molty une fois via
op - réutilise la session de registre stockée ou en crée une à partir du nom d'utilisateur/mot de passe/TOTP
- publie des paquets factices
0.0.0avec un README générique - continue après les échecs de publication par paquet
- masque les jetons/OTP dans les journaux
- nettoie les dossiers npmrc/temporaires
Remarques :
- npm peut rejeter des noms comme trop similaires à des noms déjà publiés. Traitez cela comme un résultat de la politique du registre, pas comme un échec d'authentification.
- Le pipe des invites CLI npm est fragile sur npm 11. Préférez le chemin de connexion à l'API du registre de l'assistant plutôt que
npm loginscripté. - Pour les paquets avec portée,
npm viewpeut avoir un retard/404 même si le paquet existe. Vérifieznpm access get status <pkg>;publicou un échec de publication indiquantpreviously published versionssignifie que le nom est réservé.