배경

현재 package.json과 templates/manifest.json은 framework version 0.2.0을 가리키며, manifest의 planned tag는 v0.2.0이다. 그러나 원격 Git tag와 GitHub Release는 아직 존재하지 않는다.

Hyper-Waterfall의 canonical 배포 기준은 GitHub Release/tag + templates/manifest.json + migration guide이므로, npm publish나 Homebrew PoC 전에 v0.2.0 release/tag 준비와 검증을 M020에서 마무리해야 한다.

목표

• v0.2.0 GitHub Release/tag 생성 전 체크리스트를 확정한다.
• templates/manifest.json의 frameworkVersion, plannedTag, baselineTag, checksum 상태를 검토한다.
• docs/migrations/v0.1.0-to-v0.2.0.md가 release 기준으로 충분한지 확인한다.
• release/tag 생성 여부와 생성 시점을 작업지시자 승인 지점으로 분리한다.

범위 - 포함

• v0.2.0 release/tag 준비 체크리스트 작성 또는 문서 보강
• manifest JSON parse와 version/tag 필드 검증
• migration guide 필수 섹션과 v0.1.0 -> v0.2.0 경로 검증
• npm publish 준비 이슈와의 의존 관계 정리
• release notes 초안 또는 포함 항목 후보 정리

범위 - 제외

• 승인 없는 Git tag 생성
• 승인 없는 GitHub Release publish
• npm publish 실행
• Homebrew, Docker, plugin 구현
• v0.3.0 범위 작업

수용 기준

• v0.2.0 release/tag를 만들기 전에 확인할 항목이 명확하다.
• manifest, migration guide, README, npm package version의 0.2.0 기준이 서로 충돌하지 않는다.
• release/tag 생성이 canonical 배포 단위라는 설명이 유지된다.
• 실제 release/tag 생성은 작업지시자 승인 후에만 진행된다.

검증 기준

• ruby -rjson -e 'JSON.parse(File.read("templates/manifest.json"))'
• rg -n '0.2.0|v0.2.0|plannedTag|baselineTag|GitHub Release|manifest|migration' templates/manifest.json 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 --limit 20
• git diff --check

참고

• 선행: GitHub Release + manifest + migration guide 도입 #7 GitHub Release + manifest + migration guide 도입
• 선행: npm CLI MVP로 init/update/doctor 제공 #10 npm CLI MVP
• 선행: 추가 배포 채널 확장안 검토 #11 추가 배포 채널 확장안 검토
• 문서: docs/migrations/v0.1.0-to-v0.2.0.md
• 문서: templates/manifest.json

마일스톤과 label 후보

• milestone: M020
  • v0.2.0 release/tag 준비는 M020의 canonical 배포 기준 마무리 작업이다.
• labels: enhancement, infrastructure
  • enhancement: release/tag 산출물 준비
  • infrastructure: 배포·업데이트 프로토콜 운영 구조

확인

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