배경

PR #25로 v0.2.0 GitHub Release/tag 준비 문서가 main에 merge되었고, docs/releases/v0.2.0.md에는 release 전 체크리스트와 release notes 초안이 정리되었다. 다만 templates/manifest.json은 아직 release.status: planned, checksum pending-release 상태이며, 실제 GitHub Release/tag를 canonical 배포 기준으로 만들기 전에 이 상태를 어떻게 확정할지 결정해야 한다.

GitHub Release가 적용 저장소 업데이트의 기준점이 되려면 release manifest가 "planned" 상태로 남아도 되는지, checksum을 실제 값으로 채워야 하는지, 일부 항목은 release asset 생성 이후에만 확정 가능한지 명확해야 한다.

목표

• v0.2.0 GitHub Release/tag 생성 직전 templates/manifest.json의 release 상태를 확정한다.
• checksum을 실제 값으로 채울지, pending-release를 유지할 예외가 있는지 정책을 문서화한다.
• docs/releases/v0.2.0.md에 release 생성 직전 manifest/status/checksum 판단 결과를 반영한다.
• release/tag 생성 전 검증 기준을 확정한다.

범위 - 포함

• templates/manifest.json의 release.status, root checksum, file checksum 상태 검토와 필요 수정
• checksum 산출 또는 보류 정책 문서화
• docs/releases/v0.2.0.md의 체크리스트와 승인 게이트 보강
• docs/migrations/v0.1.0-to-v0.2.0.md, README, docs/distribution-channels.md와의 release 기준 정합성 확인
• 실제 GitHub Release/tag 생성 전에 실행할 검증 명령 정리

범위 - 제외

• 승인 없는 git tag v0.2.0 생성
• 승인 없는 git push origin v0.2.0
• 승인 없는 GitHub Release publish
• npm publish 실행
• Homebrew, Docker, Codex plugin, Claude plugin 구현
• v0.3.0 범위 작업

수용 기준

• templates/manifest.json의 release 상태와 checksum 상태가 v0.2.0 GitHub Release 생성 직전 기준으로 설명 가능하다.
• checksum을 확정했다면 산출 방법과 대상 범위가 문서화되어 있다.
• checksum을 일부 또는 전체 보류했다면 보류 이유와 후속 확정 조건이 문서화되어 있다.
• docs/releases/v0.2.0.md가 release 생성 직전 maintainer 체크리스트로 사용할 수 있다.
• 실제 tag/release 생성은 작업지시자 승인 후 단계로 남아 있다.

검증 기준

• ruby -rjson -e 'JSON.parse(File.read("templates/manifest.json"))'
• rg -n 'planned|released|pending-release|checksum|v0.2.0|GitHub Release' templates/manifest.json docs/releases/v0.2.0.md docs/migrations/v0.1.0-to-v0.2.0.md README.md docs/distribution-channels.md
• git tag --list --sort=version:refname
• gh release list --repo postmelee/hyper-waterfall --limit 20
• git diff --check

참고

• 선행: v0.2.0 GitHub Release/tag 준비 #24 v0.2.0 GitHub Release/tag 준비
• PR: Task #24: v0.2.0 GitHub Release/tag 준비 #25 Task #24: v0.2.0 GitHub Release/tag 준비
• 문서: docs/releases/v0.2.0.md
• 문서: templates/manifest.json
• 문서: docs/migrations/v0.1.0-to-v0.2.0.md

마일스톤과 label 후보

• milestone: M020
  • v0.2.0 GitHub Release/tag 생성 직전의 canonical 배포 기준 확정 작업이다.
• labels: enhancement, infrastructure
  • enhancement: release 산출물 확정
  • infrastructure: 배포·업데이트 프로토콜 운영 구조

확인

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