배경

#23에서 Homebrew formula/tap PoC 설계가 완료됐다. npm publish가 완료되면 registry tarball URL과 SHA256을 기준으로 formula 초안을 만들고 macOS local tap smoke까지 검증해야 한다. 이 task는 public tap 배포 전의 기술 검증 단계다.

마일스톤 목적과 실행 순서

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

목표

• publish된 hyper-waterfall@0.2.0 npm tarball의 SHA256을 확인한다.
• docs/homebrew-formula-tap-poc.md 기준의 formula 초안을 실제 Homebrew local tap에서 검증한다.
• brew audit, install, hyper-waterfall --version, doctor smoke를 통해 public tap 전 위험을 줄인다.

범위 - 포함

• npm tarball URL과 SHA256 확인
• Homebrew formula 초안 작성 또는 local tap 검증용 formula 준비
• brew audit --new --formula 또는 적용 가능한 audit 명령 실행
• local tap에서 brew install --build-from-source smoke
• 설치된 hyper-waterfall --version과 hyper-waterfall doctor --repo . 확인
• formula가 manifest, migration guide, checksum 정책을 복제하지 않는지 검토
• local smoke 결과와 public 배포 전 남은 위험 기록

범위 - 제외

• public tap 저장소 생성 또는 formula push
• README에 public Homebrew 설치 안내 추가
• release마다 formula를 갱신하는 자동화 구현
• Docker image 관련 작업
• npm publish 실행 자체

수용 기준

• npm tarball SHA256이 재현 가능하게 기록된다.
• local tap formula가 hyper-waterfall@0.2.0 CLI를 설치한다.
• hyper-waterfall --version이 0.2.0을 출력한다.
• hyper-waterfall doctor --repo .가 실행되고 파일을 수정하지 않는다.
• public tap 배포 가능 여부와 보류 조건이 최종 보고서에 정리된다.

검증 기준

• npm view hyper-waterfall@0.2.0 dist.tarball
• tarball SHA256 확인 명령
• brew audit --new --formula 또는 해당 Homebrew 버전에서 가능한 audit 명령
• brew install --build-from-source local tap smoke
• hyper-waterfall --version
• hyper-waterfall doctor --repo .
• brew test 가능 여부 확인
• git diff --check

참고

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

마일스톤과 label 후보

• milestone: M040. npm publish 이후 Homebrew 실제 smoke 검증 단계다.
• label: enhancement, infrastructure. 배포 채널 검증과 저장소 운영 흐름에 해당한다.

확인

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