O que npm faz?
Use para tarefas de registro/ conta npm: npm whoami, disponibilidade de pacotes, reserva de pacotes, publicação, verificações de organização e depuração de autenticação.
Autenticação
- Use
one-passwordprimeiro para regras secretas. - Nunca execute
opdiretamente na ferramenta de shell. - Item principal:
npm Registry - steipete - Release AutomationemMolty. - Padrão para
OP_SERVICE_ACCOUNT_TOKEN; sem desbloqueio de desktop. O item carrega a sessão de registro ativa (registry_token) além de nome de usuário/senha/TOTP como fallback. - Fallback de desktop
npmjsé explícito somente: passe--account my.1password.comquando o Molty não estiver disponível e o usuário quiser o fallback. Solicitações explícitas derelease/publishsão consentimento para seu prompt de desbloqueio. - Pare e pergunte se o item estiver faltando, a conta/cofre for ambíguo, as credenciais estiverem malformadas, o npm negar acesso ao pacote, ou o pacote/versão solicitado não corresponder ao alvo de release do repositório.
- Execute trabalhos de autenticação npm dentro de uma sessão tmux persistente. Reutilize-a em caso de falha.
- Mantenha a autenticação npm em um npmrc temporário; exclua-o após o comando.
- Todos os helpers compartilham
scripts/npm-auth.sh: sessãoregistry_tokenarmazenada primeiro, depois login no registro comscripts/npm-auth-login.mjse um OTP novo de seis dígitos; sessões de fallback bem-sucedidas são armazenadas em cache no mesmo item. Não implemente manualmente extração de campos, login no registro ou escrita de cache. - A seleção de credenciais prefere o campo canônico
id, depoispurpose, depois um rótulo único; correspondências de rótulo duplicado são rejeitadas (onpmjslegado pode reter campos com o mesmo rótulo). - Para comandos de registro autenticados ad-hoc, use
scripts/npm-service.sh -- <npm args...>; usepublish-package.shpara um pacote local. - O piping de prompt do npm 11 é frágil; evite
printf ... | npm login --auth-type=legacy. - Evite
expectpara login npm, a menos que necessário; logs podem ecoar prompts e são fáceis de errar. - Prefira o caminho de login da API de registro do helper (
npm-profileloginCouch) para automação. - Se a forma de autenticação for ambígua ou
npm whoamifalhar, pare e pergunte pelo rótulo exato do campo / correção de credencial. Não investigue mais itens do 1Password ou inicie outra sessão tmux.
Publicação de Pacotes
A partir da raiz do pacote, dentro da mesma sessão tmux de autenticação:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
O helper verifica a identidade, recusa uma versão de pacote já existente, publica com um novo OTP, tenta novamente um OTP expirado, verifica a visibilidade no registro e limpa arquivos de autenticação.
Reserva de Pacotes
Use scripts/reserve-packages.sh dentro da mesma sessão tmux:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh package-one package-two
O que faz:
- lê o item de automação de release do Molty uma vez via
op - reutiliza a sessão de registro armazenada ou cria uma a partir de nome de usuário/senha/TOTP
- publica pacotes placeholder
0.0.0com um README genérico - continua após falhas de publicação por pacote
- oculta tokens/OTP nos logs
- limpa npmrc/diretórios temporários
Notas:
- O npm pode rejeitar nomes como muito semelhantes a nomes já publicados. Trate isso como um resultado da política do registro, não como uma falha de autenticação.
- O piping de prompt da CLI npm é frágil no npm 11. Prefira o caminho de login da API de registro do helper em vez de
npm logincom script. - Para pacotes com escopo,
npm viewpode atrasar/retornar 404 mesmo quando o pacote existe. Verifiquenpm access get status <pkg>;publicou uma falha de publicação dizendopreviously published versionssignifica que o nome está reservado.