Homebrew formula/tap PoC

[postmelee]

배경

#11 추가 배포 채널 전략에서 Homebrew는 P1 후보로 정리됐다. macOS 개발자는 brew install 또는 tap 기반 흐름에 익숙하므로, npm CLI 이후 설치 발견성과 업데이트 경험을 개선할 수 있다.

다만 Homebrew formula가 canonical 기준을 대체해서는 안 된다. 실제 구현은 v0.2.0 GitHub Release/tag와 npm package 또는 release asset 전략이 안정된 뒤 PoC로 검증해야 한다.

목표

• Homebrew formula/tap PoC의 최소 범위를 확정한다.
• hyper-waterfall CLI 설치, --version, doctor smoke 검증 경로를 정의한다.
• formula가 GitHub Release/tag, manifest, migration guide 기준을 대체하지 않도록 책임 경계를 정리한다.
• tap 저장소, 본 저장소 formula, npm package wrapper, release asset wrapper 중 어떤 접근을 PoC로 볼지 비교한다.

범위 - 포함

• Homebrew formula/tap PoC 설계
• macOS 설치/검증 시나리오 정의
• version, checksum, release asset 또는 npm package 참조 방식 비교
• hyper-waterfall --version과 doctor smoke 검증 계획
• 운영 비용과 보류 조건 정리

범위 - 제외

• v0.2.0 GitHub Release/tag 생성
• npm publish 실행
• 자동 release pipeline 구현
• Docker image 구현
• Codex/Claude plugin 구현
• 승인 없는 Homebrew tap 공개 배포

수용 기준

• Homebrew가 해결하는 사용자 문제와 비목표가 명확하다.
• PoC에서 검증할 설치 경로와 smoke 명령이 명확하다.
• formula가 canonical 기준을 대체하지 않고 CLI 실행 수단으로만 동작한다는 경계가 드러난다.
• 실제 public 배포 여부는 별도 승인 지점으로 남는다.

검증 기준

• rg -n 'Homebrew|formula|tap|GitHub Release|manifest|migration|canonical|doctor|version' docs README.md package.json
• Homebrew PoC 문서 또는 산출물 존재 확인
• git diff --check

참고

• 선행: 추가 배포 채널 확장안 검토 #11 추가 배포 채널 확장안 검토
• 문서: docs/distribution-channels.md
• 의존: v0.2.0 GitHub Release/tag 준비
• 의존: npm publish 준비와 배포 전 검증 정리

마일스톤과 label 후보

• milestone: M030
  • Homebrew는 v0.2.0 release/npm 기준이 안정된 뒤의 배포 채널 PoC이므로 M030이 적합하다.
• labels: enhancement, infrastructure
  • enhancement: 새로운 배포 실행 채널 PoC
  • infrastructure: 배포 채널 운영 구조

확인

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