배경

docs/releases/v0.2.0-npm-publish.md에서 hyper-waterfall@0.2.0 publish 전 검증 절차가 정리됐다. 이제 실제 npm registry publish와 publish 후 npm view/npx 검증을 별도 task로 추적한다. Homebrew formula smoke의 선행 조건이므로 M040의 첫 번째 실행 항목이다.

마일스톤 목적과 실행 순서

M040은 Docker를 제외하고 npm, Homebrew, Codex, Claude 채널의 v0.2.0 최종 배포 가능 상태를 만든다.

실행 순서:

1. npm publish 실행과 post-publish 검증
2. Homebrew formula local tap smoke PoC
3. Homebrew public tap 배포와 설치 안내
4. Codex/Claude plugin 공통 배포 원칙 정리
5. Codex plugin packaging 검증
6. Codex plugin 배포 후보 생성과 설치 smoke
7. Claude plugin packaging 검증
8. Claude plugin 배포 후보 생성과 설치 smoke
9. 최종 배포 채널 정합성 감사와 문서 갱신

목표

• v0.2.0 GitHub Release/tag, package.json version, templates/manifest.json 기준의 정합성을 publish 직전에 재확인한다.
• npm test, npm pack --dry-run, local tarball smoke를 publish 직전에 다시 통과시킨다.
• 작업지시자의 별도 명시 승인 후 hyper-waterfall@0.2.0을 npm registry에 publish한다.
• publish 후 npm view와 npx hyper-waterfall@0.2.0 smoke로 registry 상태를 확인한다.

범위 - 포함

• docs/releases/v0.2.0-npm-publish.md의 publish 전 승인 게이트 재확인
• npm whoami, npm view hyper-waterfall@0.2.0 version, npm pack --dry-run, local tarball smoke
• npm publish 실행 전 별도 승인 요청
• publish 후 npm view hyper-waterfall@0.2.0 version, dist.tarball, gitHead, dist-tags 확인
• publish 후 npx hyper-waterfall@0.2.0 --version, --help 확인
• 결과 보고서에 publish commit, npm gitHead, registry URL, smoke 결과 기록

범위 - 제외

• Homebrew formula 작성과 tap 배포
• Codex/Claude plugin packaging
• Docker image 관련 작업
• 자동 release pipeline 구현
• npm 2FA OTP 또는 maintainer 비밀값 기록

수용 기준

• hyper-waterfall@0.2.0이 npm registry에서 조회된다.
• npx hyper-waterfall@0.2.0 --version이 0.2.0을 출력한다.
• npx hyper-waterfall@0.2.0 --help가 init, update, doctor와 canonical 기준 안내를 출력한다.
• publish 전후 검증 결과와 승인 지점이 최종 보고서에 남아 있다.
• 이미 동일 version이 존재하면 publish를 중단하고 상태 조사로 전환한다.

검증 기준

• npm test
• npm pack --dry-run
• local tarball install smoke
• npm whoami
• npm view hyper-waterfall@0.2.0 version
• npm view hyper-waterfall@0.2.0 dist.tarball
• npm view hyper-waterfall@0.2.0 gitHead
• npm view hyper-waterfall dist-tags --json
• npx hyper-waterfall@0.2.0 --version
• npx hyper-waterfall@0.2.0 --help
• git diff --check

참고

• npm publish 준비와 배포 전 검증 정리 #21
• v0.2.0 GitHub Release/tag 생성 #30
• docs/releases/v0.2.0-npm-publish.md
• docs/distribution-channels.md

마일스톤과 label 후보

• milestone: M040. 최종 배포 채널 실행 묶음이다.
• label: enhancement, infrastructure. 실제 배포 실행과 저장소 운영 흐름에 해당한다.

확인

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