Skip to content

Task #35: Homebrew public tap 배포와 설치 안내#47

Merged
postmelee merged 7 commits into
mainfrom
publish/task35
May 11, 2026
Merged

Task #35: Homebrew public tap 배포와 설치 안내#47
postmelee merged 7 commits into
mainfrom
publish/task35

Conversation

@postmelee

@postmelee postmelee commented May 11, 2026

Copy link
Copy Markdown
Owner

요약

  • 대상 타스크: Closes Homebrew public tap 배포와 설치 안내 #35 Homebrew public tap 배포와 설치 안내
  • 왜: Task Homebrew formula local tap smoke PoC #34 local tap smoke를 실제 macOS 사용자 설치 경로로 승격하고, public tap 공개와 안내 문서 반영을 승인 게이트 안에서 추적하기 위해서입니다.
  • 무엇: postmelee/homebrew-tap public repository와 formula 게시 결과, public tap smoke, README/docs 설치 안내, Homebrew core 등재 가능성 평가와 제출 준비 #46 Homebrew core 후속 이슈를 기록했습니다.
  • 리뷰 포인트: 현재 지원 경로가 brew install postmelee/tap/hyper-waterfall이고, brew install hyper-waterfall 단독 경로는 #46으로 분리된 점을 확인해 주세요.

변경 내역

  • Stage 1 (4091506): public tap 이름, 공개 범위, formula 위치, 외부 공개 작업 승인 조건을 정리했습니다.
  • Stage 2 (ed07abc): postmelee/homebrew-tap public repository를 만들고 Formula/hyper-waterfall.rb를 게시했습니다.
  • Stage 3 (e9f6c03): public tap 기준 install/version/doctor/brew test/cleanup smoke를 검증했습니다.
  • Stage 4 (dd92a75): README와 배포 문서에 Homebrew 설치 안내와 wrapper/canonical 경계를 반영하고 #46을 등록했습니다.
  • 최종 보고 (3d7a1f2): 수용 기준 검증, 잔여 위험, 후속 작업, 오늘할일 완료 처리를 정리했습니다.

작업 문서

핵심 리뷰 포인트

  • Homebrew formula는 public tap repository에만 공식 source를 두고, 본 저장소에는 검증 기록과 설치 안내만 남깁니다.
  • README의 즉시 설치 경로는 brew install postmelee/tap/hyper-waterfall입니다.
  • Homebrew는 npm CLI 설치 wrapper이며 GitHub Release/tag, templates/manifest.json, migration guide를 대체하지 않습니다.

검증

자동 검증

주제 검증 방법 결과 근거
산출 문서 존재 ls mydocs/plans/task_m040_35.md ... mydocs/tech/task_m040_35_homebrew_public_tap_smoke.md OK 계획서, 구현계획서, Stage 1-4 보고서, 기술 기록이 모두 존재합니다.
설치 안내와 책임 경계 `rg -n 'brew install postmelee/tap/hyper-waterfall hyper-waterfall --version hyper-waterfall doctor --repo
public smoke 근거 `rg -n '78ca46a54fa34b4251650607264b3fde132cfdfd 34dc90... brew audit --new --formula
git 품질 git diff --check, git status --short --branch OK 공백 오류 없음. 최종 커밋 후 local/task35...origin/main [ahead 7]이며 작업트리는 clean입니다.

수동/시나리오 검증

시나리오 확인 절차 결과 자료
Homebrew public tap smoke Stage 3에서 brew tap, brew audit, brew install --build-from-source, --version, doctor --repo, brew test, cleanup을 실행 OK 기술 기록
문서 안내 검토 README, Homebrew PoC 문서, 배포 채널 문서, v0.2.0 release notes 후보를 확인 OK 최종 보고서

CI/원격 검증

항목 결과 근거
public tap repository OK gh repo view postmelee/homebrew-tap --json nameWithOwner,visibility,defaultBranchRef,url,pushedAt -> PUBLIC, default branch main, pushedAt 2026-05-10T06:29:35Z
후속 이슈 #46 OK gh issue view 46 --json title,url,state,milestone,labels -> OPEN, M040, enhancement, infrastructure
base 동기화 OK git fetch origin main 후 HEAD..origin/main 추가 commit 없음

검증 한계

  • 최종 보고 단계에서는 Homebrew install을 다시 실행하지 않았습니다. Stage 3에서 실제 public tap install/test/cleanup smoke를 수행했고, 최종 단계에서는 원격 상태와 문서 근거만 재확인했습니다.
  • PR 생성 직후 GitHub Checks는 아직 별도로 확인하지 않았습니다.

관련 이슈

후속 이슈 제안

남은 리스크

  • brew install hyper-waterfall 단독 첫 설치는 아직 지원하지 않습니다. Homebrew core 등재 가능성은 #46에서 별도로 평가합니다.
  • release마다 formula url과 sha256을 갱신하는 운영 방식은 아직 자동화하지 않았습니다.
  • Homebrew node dependency는 사용자 환경에 따라 npm/npx link warning을 낼 수 있습니다.

@postmelee postmelee merged commit 5e9b1e1 into main May 11, 2026
@postmelee postmelee deleted the publish/task35 branch May 11, 2026 00:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Homebrew public tap 배포와 설치 안내

1 participant

@postmelee