Was macht npm?
Verwendung für npm-Registry-/Kontoaufgaben: npm whoami, Paketverfügbarkeit, Paketreservierung, Veröffentlichung, Organisationschecks und Authentifizierungsdebugging.
Auth
- Verwende zuerst
one-passwordfür geheime Regeln. - Führe
opniemals direkt im Shell-Tool aus. - Primäres Item:
npm Registry - steipete - Release AutomationinMolty. - Standardmäßig
OP_SERVICE_ACCOUNT_TOKEN; kein Desktop-Entsperren. Das Item enthält die aktuelle Registry-Sitzung (registry_token) plus Benutzername/Passwort/TOTP-Fallback. - Desktop-
npmjs-Fallback nur explizit: verwende--account my.1password.com, wenn Molty nicht verfügbar ist und der Benutzer den Fallback wünscht. Expliziterelease/publish-Anfragen sind Zustimmung für dessen Entsperraufforderung. - Stoppe und frage nach, wenn das Item fehlt, das Konto/der Tresor nicht eindeutig ist, Anmeldedaten fehlerhaft sind, npm den Paketzugriff verweigert oder das angeforderte Paket/die Version nicht mit dem Release-Ziel des Repos übereinstimmt.
- Führe npm-Auth-Arbeiten innerhalb einer persistenten tmux-Sitzung aus. Nutze sie bei Fehlschlag erneut.
- Halte npm-Auth in einer temporären npmrc; lösche sie nach dem Befehl.
- Alle Helfer teilen
scripts/npm-auth.sh: zuerst gespeicherteregistry_token-Sitzung, dannscripts/npm-auth-login.mjsRegistry-Login mit einem frischen sechsstelligen OTP; erfolgreiche Fallback-Sitzungen werden zurück in dasselbe Item gecacht. Führe Feldextraktion, Registry-Login oder Cache-Schreibvorgänge nicht manuell durch. - Die Auswahl der Anmeldedaten bevorzugt kanonisches Feld
id, dannpurpose, dann ein eindeutiges Label; doppelte Label-Übereinstimmungen werden abgelehnt (Legacy-npmjskann gleichnamige Felder behalten). - Für Ad-hoc-authentifizierte Registry-Befehle verwende
scripts/npm-service.sh -- <npm args...>; verwendepublish-package.shfür ein lokales Paket. - npm 11 Prompt-Piping ist brüchig; vermeide
printf ... | npm login --auth-type=legacy. - Vermeide
expectfür npm-Login, es sei denn, es ist notwendig; Logs können Eingabeaufforderungen ausgeben und sind leicht falsch zu interpretieren. - Bevorzuge den Registry-API-Login-Pfad des Helfers (
npm-profileloginCouch) für die Automatisierung. - Wenn die Auth-Form nicht eindeutig ist oder
npm whoamifehlschlägt, stoppe und frage nach der genauen Feldbezeichnung / Korrektur der Anmeldedaten. Durchsuche keine weiteren 1Password-Items und starte keine weitere tmux-Sitzung.
Paketveröffentlichung
Vom Paketstammverzeichnis aus, innerhalb derselben Auth-tmux-Sitzung:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
Der Helfer überprüft die Identität, lehnt eine vorhandene Paketversion ab, veröffentlicht mit einem frischen OTP, wiederholt einen abgelaufenen OTP-Versuch, überprüft die Registry-Sichtbarkeit und bereinigt Auth-Dateien.
Paketreservierung
Verwende scripts/reserve-packages.sh von innerhalb derselben tmux-Sitzung:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh paket-eins paket-zwei
Was es tut:
- liest das Molty-Release-Automation-Item einmal über
op - verwendet die gespeicherte Registry-Sitzung oder erstellt eine aus Benutzername/Passwort/TOTP
- veröffentlicht
0.0.0-Platzhalterpakete mit einer generischen README - fährt nach Fehlschlägen bei der Paketveröffentlichung pro Paket fort
- schwärzt Tokens/OTPs in Logs
- bereinigt temporäre npmrc/Arbeitsverzeichnisse
Hinweise:
- npm kann Namen als zu ähnlich zu bereits veröffentlichten Namen ablehnen. Behandle das als Registry-Policy-Ergebnis, nicht als Auth-Fehler.
- npm CLI Prompt-Piping ist unter npm 11 brüchig. Bevorzuge den Registry-API-Login-Pfad des Helfers gegenüber skriptbasiertem
npm login. - Bei Scoped-Paketen kann
npm vieweine 404-Verzögerung aufweisen, selbst wenn das Paket existiert. Überprüfe mitnpm access get status <pkg>;publicoder ein Veröffentlichungsfehler, derpreviously published versionsbesagt, bedeutet, dass der Name reserviert ist.