요약

• 대상 타스크: Closes Homebrew core 등재 가능성 평가와 제출 준비 #46 Homebrew core 등재 가능성 평가와 제출 준비
• 왜: brew install hyper-waterfall 단독 경로를 지원하려면 Homebrew core 등재가 필요하므로, public tap smoke 통과 결과와 core readiness를 분리해 판단하기 위해서입니다.
• 무엇: Homebrew 공식 기준, 현재 formula와 repository gap, core 제출 보류 판단, public tap 유지 안내를 문서화했습니다.
• 리뷰 포인트: 이번 PR은 Homebrew core PR을 만들지 않고, 현재 지원 경로를 brew install postmelee/tap/hyper-waterfall로 유지하는 결론이 타당한지 확인해 주세요.

변경 내역

• Stage 1 (1d0b2ca): Homebrew core 기준, public tap과 core 차이, 조사 항목을 고정했습니다.
• Stage 2 (4a06d72): 현재 public tap formula, GitHub 지표, npm metadata, Homebrew audit/install/test 결과를 gap matrix로 정리했습니다.
• Stage 3 (88c0573): core 제출 보류 판단을 README와 배포 문서에 반영했습니다.
• 최종 보고 (28f0d51): 수용 기준 검증, 잔여 위험, 후속 작업, 오늘할일 완료 처리를 정리했습니다.

작업 문서

• 수행 계획서: task_m040_46.md
• 구현 계획서: task_m040_46_impl.md
• 기술 기록: task_m040_46_homebrew_core_review.md
• 최종 보고서: task_m040_46_report.md

핵심 리뷰 포인트

• Homebrew core 제출 판단은 보류입니다. 현재 지표는 stars 14, forks 3, watchers 0이며, non-author usage와 x86_64 macOS/Linux 검증 근거도 부족합니다.
• 현재 사용자-facing Homebrew 설치 경로는 brew install postmelee/tap/hyper-waterfall입니다.
• Homebrew formula는 npm CLI 설치 wrapper이며 GitHub Release/tag, templates/manifest.json, migration guide를 대체하지 않습니다.

검증

자동 검증

수동/시나리오 검증

CI/원격 검증

검증 한계

• 최종 보고 단계에서는 Homebrew install을 다시 실행하지 않았습니다. Stage 2에서 brew audit --new --formula, brew install --build-from-source, hyper-waterfall --version, doctor --repo, brew test, cleanup을 수행했고, 최종 단계에서는 문서 정합성과 수용 기준을 재확인했습니다.
• x86_64 macOS와 x86_64 Linux 검증은 아직 수행하지 않았습니다. 이는 core 제출 재검토 전 선행 작업입니다.
• PR 생성 직후 GitHub Checks는 아직 별도로 확인하지 않았습니다.

관련 이슈

• Homebrew public tap 배포와 설치 안내 #35

후속 이슈 제안

• Homebrew core 제출 재검토: notability 또는 non-author usage 증거 확보, x86_64 macOS/Linux build/test 증거 확보, formula test 보강 후 별도 진행
• Homebrew public tap 운영 자동화: release마다 formula URL, version, SHA256 갱신 검증

남은 리스크

• brew install hyper-waterfall 단독 첫 설치는 아직 지원하지 않습니다.
• Homebrew 정책과 notability 판단은 바뀔 수 있으므로 core 제출 재검토 직전 공식 문서와 repository 지표를 다시 확인해야 합니다.
• public tap formula 운영은 유지해야 하며, release마다 URL/version/SHA256 갱신 누락 위험이 남아 있습니다.