npm은(는) 무엇을 하나요?
npm 레지스트리/계정 작업에 사용: npm whoami, 패키지 가용성, 패키지 예약, 게시, 조직 확인 및 인증 디버깅.
인증
- 보안 규칙을 위해
one-password를 먼저 사용하십시오. - 셸 도구에서
op를 직접 실행하지 마십시오. - 기본 항목:
Molty내npm Registry - steipete - Release Automation. - 기본값:
OP_SERVICE_ACCOUNT_TOKEN; 데스크톱 잠금 해제 없음. 항목에는 작업 중인 레지스트리 세션(registry_token)과 사용자 이름/비밀번호/TOTP 폴백이 포함됩니다. - 데스크톱
npmjs폴백은 명시적일 때만 사용: Molty를 사용할 수 없고 사용자가 폴백을 원할 때--account my.1password.com을 전달하십시오. 명시적release/publish요청은 잠금 해제 프롬프트에 대한 동의로 간주됩니다. - 항목이 없거나, 계정/금고가 모호하거나, 자격 증명 형식이 잘못되었거나, npm이 패키지 접근을 거부하거나, 요청한 패키지/버전이 저장소 릴리스 대상과 일치하지 않으면 중지하고 질문하십시오.
- 하나의 지속적 tmux 세션 내에서 npm 인증 작업을 실행하십시오. 실패 시 재사용하십시오.
- npm 인증을 임시 npmrc에 보관하고 명령 후 삭제하십시오.
- 모든 헬퍼는
scripts/npm-auth.sh를 공유합니다: 저장된registry_token세션을 먼저 사용한 후,scripts/npm-auth-login.mjs를 통한 신규 6자리 OTP로 레지스트리 로그인; 성공한 폴백 세션은 동일한 항목에 캐시됩니다. 필드 추출, 레지스트리 로그인 또는 캐시 쓰기를 직접 구현하지 마십시오. - 자격 증명 선택은 정식 필드
id를 우선시하고, 그 다음purpose, 그 다음 고유 레이블을 사용합니다. 중복 레이블만 일치하는 경우는 거부됩니다(레거시npmjs는 동일한 레이블의 필드를 유지할 수 있음). - 임시 인증된 레지스트리 명령의 경우
scripts/npm-service.sh -- <npm 인수...>를 사용하십시오. 로컬 패키지의 경우publish-package.sh를 사용하십시오. - npm 11 프롬프트 파이핑은 깨지기 쉽습니다.
printf ... | npm login --auth-type=legacy를 피하십시오. - 필요하지 않으면 npm 로그인에
expect를 사용하지 마십시오. 로그가 프롬프트를 에코할 수 있고 잘못되기 쉽습니다. - 자동화를 위해 헬퍼의 레지스트리 API 로그인 경로(
npm-profileloginCouch)를 선호하십시오. - 인증 형식이 모호하거나
npm whoami가 실패하면 중지하고 정확한 필드 레이블/자격 증명 수정을 요청하십시오. 더 이상 1Password 항목을 탐색하거나 다른 tmux 세션을 시작하지 마십시오.
패키지 게시
동일한 인증 tmux 세션 내에서 패키지 루트에서:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
헬퍼는 ID를 확인하고, 기존 패키지 버전을 거부하며, 새 OTP로 게시하고, 만료된 OTP를 한 번 재시도하며, 레지스트리 가시성을 확인하고, 인증 파일을 정리합니다.
패키지 예약
동일한 tmux 세션 내에서 scripts/reserve-packages.sh 사용:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh package-one package-two
기능:
- Molty 릴리스-자동화 항목을
op를 통해 한 번 읽습니다. - 저장된 레지스트리 세션을 재사용하거나 사용자 이름/비밀번호/TOTP로 생성합니다.
- 일반 README와 함께
0.0.0플레이스홀더 패키지를 게시합니다. - 패키지별 게시 실패 후에도 계속 진행합니다.
- 로그에서 토큰/OTP를 수정합니다.
- 임시 npmrc/작업 디렉터리를 정리합니다.
참고:
- npm은 이미 게시된 이름과 너무 유사한 이름을 거부할 수 있습니다. 이를 인증 실패가 아닌 레지스트리 정책 결과로 처리하십시오.
- npm 11에서 npm CLI 프롬프트 파이핑은 깨지기 쉽습니다. 스크립트된
npm login보다 헬퍼의 레지스트리 API 로그인 경로를 선호하십시오. - 범위 패키지의 경우
npm view가 패키지가 존재하더라도 지연되거나 404를 반환할 수 있습니다.npm access get status <pkg>를 확인하십시오;public또는previously published versions라는 게시 실패는 이름이 예약되었음을 의미합니다.