배경

M020에서 npm CLI MVP가 구현됐고 package.json version은 0.2.0이다. README와 전략 문서는 npm CLI를 편의 실행 채널로 설명하지만, 실제 npm publish 전에는 사용자가 npx hyper-waterfall을 안정 경로로 사용할 수 없다.

첫 npm 배포는 v0.2.0 GitHub Release/tag와 정합되어야 하며, publish 전에 package metadata, 포함 파일, smoke test, README 문구, release/tag 기준을 점검해야 한다.

목표

• hyper-waterfall@0.2.0 npm publish 전 검증 체크리스트를 확정한다.
• package metadata와 files 포함 범위가 CLI 실행에 충분한지 검증한다.
• npm pack 또는 동등한 로컬 검증으로 배포 산출물 구성을 확인한다.
• publish 실행 여부와 절차를 작업지시자 승인 지점으로 분리한다.

범위 - 포함

• package.json metadata와 files, bin, engines, scripts.test 점검
• npm package tarball 구성 검증
• 로컬 tarball 기반 CLI smoke 검증 방안 정리
• README의 npx hyper-waterfall 문구와 실제 publish 상태 정합성 확인
• npm publish 전/후 승인 게이트와 rollback/republish 리스크 정리

범위 - 제외

• 승인 없는 npm publish 실행
• Homebrew formula 구현
• Docker image 구현
• GitHub Release/tag 생성 자체
• CLI 기능 확장

수용 기준

• npm publish 전에 확인해야 할 파일 포함 범위와 smoke test가 명확하다.
• hyper-waterfall@0.2.0으로 배포해야 하는 이유와 v0.2.0 release/tag와의 관계가 정리된다.
• README의 npx 예시가 실제 publish 상태와 충돌하지 않는다.
• publish 실행은 별도 승인 없이 자동 수행되지 않는다.

검증 기준

• npm test
• npm pack --dry-run 또는 동등한 tarball 구성 검증
• node bin/hyper-waterfall.js --version
• node bin/hyper-waterfall.js --help
• git diff --check

참고

• 선행: npm CLI MVP로 init/update/doctor 제공 #10 npm CLI MVP
• 선행: 추가 배포 채널 확장안 검토 #11 추가 배포 채널 확장안 검토
• 문서: docs/distribution-channels.md
• 관련: v0.2.0 GitHub Release/tag 준비 이슈

마일스톤과 label 후보

• milestone: M020
  • 첫 npm 배포는 현재 framework version 0.2.0과 직접 연결되므로 M020이 적합하다.
• labels: enhancement, infrastructure
  • enhancement: npm 배포 실행 가능성 확장
  • infrastructure: 배포 채널 운영 구조

확인

• 기존 열린 이슈와 중복되지 않음을 확인했습니다.
• 이번 task에서 제외할 항목을 명시했습니다.
• 작업 시작 전 수행계획서 승인 절차가 필요함을 이해했습니다.