배경

Homebrew local tap smoke가 통과하면 실제 macOS 사용자 설치 경로를 공개할 수 있다. 이 task는 public tap 저장소와 formula 공개, 설치 안내 문서 반영을 별도 승인 게이트로 추적한다.

마일스톤 목적과 실행 순서

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. 최종 배포 채널 정합성 감사와 문서 갱신

목표

• Homebrew public tap 이름, 공개 범위, 운영 책임을 확정한다.
• 작업지시자 승인 후 public tap에 hyper-waterfall formula를 게시한다.
• 공개 설치 명령과 canonical 책임 경계를 README 또는 release notes에 반영한다.
• 공개 설치 경로에서 brew install, hyper-waterfall --version, doctor smoke를 확인한다.

범위 - 포함

• public tap 저장소 이름과 공개 범위 결정
• formula push 전 승인 게이트 기록
• public tap formula 게시 또는 게시 절차 문서화
• brew tap, brew install, brew test 공개 경로 smoke
• README, release notes, 또는 배포 채널 문서의 Homebrew 설치 안내 갱신 판단
• Homebrew가 npm CLI wrapper이며 canonical 기준이 아님을 문서에 명시

범위 - 제외

• formula 자동 갱신 pipeline 구현
• Docker image 관련 작업
• Codex/Claude plugin packaging
• npm package publish 실행
• manifest나 migration guide를 formula 내부로 복제하는 작업

수용 기준

• 승인된 public tap 경로가 존재하거나, 배포 보류 사유가 명확히 기록된다.
• 공개 설치 명령이 실제로 동작한다.
• 설치된 hyper-waterfall --version이 0.2.0을 출력한다.
• hyper-waterfall doctor --repo .가 read-only로 실행된다.
• 문서가 Homebrew를 canonical 기준이 아닌 설치 wrapper로 설명한다.

검증 기준

• brew tap 공개 경로 확인
• brew install 공개 경로 smoke
• hyper-waterfall --version
• hyper-waterfall doctor --repo .
• brew test 가능 여부 확인
• README 또는 release notes의 설치 안내 grep
• git diff --check

참고

• Homebrew formula/tap PoC #23
• npm publish 실행과 post-publish 검증 #33
• Homebrew formula local tap smoke PoC #34
• docs/homebrew-formula-tap-poc.md
• docs/distribution-channels.md

마일스톤과 label 후보

• milestone: M040. Homebrew를 PoC에서 실제 공개 배포 후보로 올리는 단계다.
• label: enhancement, infrastructure. 배포 채널 실행과 운영 구조에 해당한다.

확인

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