Homebrew core 등재 가능성 평가와 제출 준비

[postmelee]

배경

Task #35에서 postmelee/tap/hyper-waterfall public tap 경로를 만들고, public tap 기준 brew install, hyper-waterfall --version, doctor, brew test smoke를 통과했다.

현재 사용자는 다음 명령으로 한 줄 설치할 수 있다.

brew install postmelee/tap/hyper-waterfall

하지만 아무 tap도 추가하지 않은 사용자가 기대하는 가장 짧은 Homebrew 설치 명령은 다음 형태다.

brew install hyper-waterfall

이 명령을 첫 설치부터 보장하려면 formula가 Homebrew의 기본 저장소인 homebrew/core에 등재되어야 한다. 이는 postmelee/homebrew-tap 운영과 별개로 Homebrew core의 acceptability, formula style, 지원 플랫폼, notability, 유지보수 책임, 리뷰 절차를 검토해야 하는 작업이다.

목표

• hyper-waterfall formula의 Homebrew core 등재 가능성을 평가한다.
• Homebrew core acceptability 기준과 현재 프로젝트 상태의 gap을 정리한다.
• core 제출이 가능하다고 판단되면 제출 전 준비 항목과 PR 계획을 문서화한다.
• core 제출이 부적절하거나 시기상조라면, public tap 경로를 기본 안내로 유지하는 이유를 명확히 기록한다.

범위 - 포함

• Homebrew 공식 문서의 homebrew/core formula 요구사항 확인
• 현재 hyper-waterfall@0.2.0 formula와 core 요구사항 대조
• GitHub stars/forks/watchers 같은 self-submitted software notability 요건 확인
• macOS/Linux 지원 범위, test block, dependency, npm tarball wrapper 정책 검토
• brew install hyper-waterfall 단독 명령을 달성하기 위한 선택지 정리
• 필요 시 Homebrew core PR 제출 전 checklist 작성

범위 - 제외

• 작업지시자 승인 없는 Homebrew core PR 생성
• postmelee/homebrew-tap 삭제 또는 force push
• formula 자동 갱신 pipeline 구현
• npm package 재배포
• GitHub Release/tag 재생성
• Homebrew core reviewer와의 외부 커뮤니케이션을 승인 없이 진행

수용 기준

• brew install hyper-waterfall 첫 설치 지원이 tap만으로 가능한지, core 등재가 필요한지 명확히 설명된다.
• Homebrew core 등재 가능/보류 판단과 근거가 문서화된다.
• 현재 formula가 core 요구사항과 충돌하는 지점이 있으면 항목별로 정리된다.
• core 제출을 진행할 경우 필요한 사전 작업과 승인 게이트가 분리된다.
• core 제출을 보류할 경우 #35에서 만든 brew install postmelee/tap/hyper-waterfall 안내를 유지하는 이유가 정리된다.

검증 기준

• Homebrew 공식 문서 링크와 확인일을 기록한다.
• brew audit --new --formula 또는 core 제출 후보 기준 audit 명령을 기록한다.
• brew install --build-from-source와 brew test의 현재 통과 여부를 Homebrew public tap 배포와 설치 안내 #35 결과와 대조한다.
• git diff --check

참고

• Homebrew public tap 배포와 설치 안내 #35
• docs/homebrew-formula-tap-poc.md
• mydocs/tech/task_m040_35_homebrew_public_tap_smoke.md
• https://docs.brew.sh/Acceptable-Formulae
• https://docs.brew.sh/Taps
• https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap

마일스톤과 label 후보

• milestone 후보: M040
• 선택 이유: M040은 v0.2.0 최종 배포 채널 정합성 감사와 Homebrew tap 작업을 포함한다. core 등재 검토는 Homebrew public tap 배포와 설치 안내 #35 public tap 배포의 후속 배포 채널 승격 판단이다.
• label 후보: enhancement, infrastructure
• 선택 이유: 사용자 설치 UX 개선이므로 enhancement, Homebrew 배포 채널 운영 구조 검토이므로 infrastructure.

확인

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