최종 배포 채널 정합성 감사와 문서 갱신

[postmelee]

배경

npm, Homebrew, Codex, Claude 채널이 각각 검증 또는 배포되면 마지막으로 사용자에게 노출되는 문서와 실제 배포 상태가 같은지 감사해야 한다. 이 task는 M040의 최종 정리 단계로, planned 또는 PoC 표현이 실제 배포 상태와 충돌하지 않게 만든다.

마일스톤 목적과 실행 순서

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

목표

• npm, Homebrew, Codex, Claude 채널의 실제 상태를 한 번에 점검한다.
• README, release notes, distribution 문서, agent entrypoint가 실제 배포 상태와 일치하게 갱신된다.
• Docker 제외 결정을 명확히 남겨 M040 범위가 흔들리지 않게 한다.
• 후속 운영 task, 자동화 task, 보류 task를 분리해 M040 완료 조건을 정리한다.

범위 - 포함

• npm view와 npx 기준 npm 상태 재확인
• Homebrew 설치 경로와 formula 상태 재확인
• Codex plugin 배포 또는 보류 상태 확인
• Claude plugin 배포 또는 보류 상태 확인
• README, docs/distribution-channels.md, release 문서, docs/agent-entrypoint.md 정합성 점검
• 최종 사용자 설치 순서와 canonical 기준 안내 정리
• M040 완료 보고와 후속 이슈 후보 정리

범위 - 제외

• Docker image 관련 작업
• 새 배포 채널 추가
• 미완료 채널을 무리하게 public 배포하는 작업
• 자동 release pipeline 구현
• core protocol 변경

수용 기준

• 사용자 문서의 npm, Homebrew, Codex, Claude 상태가 실제 배포 상태와 일치한다.
• planned, PoC, public, 보류 같은 표현이 채널별 실제 상태와 충돌하지 않는다.
• canonical 기준이 GitHub Release/tag + templates/manifest.json + migration guide임이 유지된다.
• M040에서 완료한 항목과 후속으로 넘길 항목이 명확히 분리된다.

검증 기준

• npm view hyper-waterfall@0.2.0 version
• npx hyper-waterfall@0.2.0 --version
• Homebrew 설치 경로 smoke 또는 상태 확인
• Codex plugin 상태 확인
• Claude plugin 상태 확인
• rg -n으로 README와 docs의 npm, Homebrew, Codex, Claude, Docker, planned, PoC 표현 확인
• git diff --check

참고

• npm publish 실행과 post-publish 검증 #33
• Homebrew formula local tap smoke PoC #34
• Homebrew public tap 배포와 설치 안내 #35
• Codex/Claude plugin 공통 배포 원칙 정리 #36
• Codex plugin packaging 검증 #37
• Codex plugin 배포 후보 생성과 설치 smoke #38
• Claude plugin packaging 검증 #39
• Claude plugin 배포 후보 생성과 설치 smoke #40
• README.md
• docs/distribution-channels.md
• docs/agent-entrypoint.md

마일스톤과 label 후보

• milestone: M040. 최종 배포 상태와 사용자 문서를 맞추는 마감 단계다.
• label: documentation, infrastructure. 배포 문서 정합성과 운영 구조에 해당한다.

확인

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