배경

GitHub Release와 Skill 기반 업데이트 프로토콜이 정립되면, npm CLI는 사용자가 같은 프로토콜을 더 쉽게 실행하는 배포 채널이 될 수 있다. CLI는 배포 프로토콜을 대체하는 것이 아니라 init, update, doctor 명령으로 manifest 검증과 적용 절차를 자동화하는 얇은 실행 계층이어야 한다.

목표

• npx hyper-waterfall init으로 신규 적용 준비를 실행한다.
• npx hyper-waterfall update로 현재 버전과 최신 버전 차이를 확인하고 업데이트 작업을 준비한다.
• npx hyper-waterfall doctor로 적용 저장소의 manifest/version/symlink/template 상태를 점검한다.
• npm 패키징 범위와 CLI MVP의 비목표를 명확히 한다.

범위 - 포함

• npm 패키지 구조 초안 추가
• CLI 명령 init, update, doctor의 MVP 동작 정의와 최소 구현
• README에 npm 사용 예시 추가
• manifest/version 정책과 CLI의 책임 경계 문서화
• 로컬 검증 명령 추가

범위 - 제외

• Homebrew/Docker/plugin 배포
• 완전한 자동 충돌 병합
• GitHub Actions 업데이트 봇
• npm publish 자동화

수용 기준

• npx 또는 로컬 package script로 init, update, doctor 명령의 MVP를 실행할 수 있다.
• CLI가 manifest/version 파일을 읽고 사람에게 다음 조치를 안내한다.
• CLI가 사용자 수정 파일을 무단 덮어쓰지 않는다.
• README가 npm을 "편의 실행 채널"로 설명하고 canonical 배포 단위와 혼동하지 않는다.

검증 기준

• 패키지 메타데이터 검증
• CLI help 출력 확인
• init, update, doctor 최소 경로 실행 확인
• README에서 npx hyper-waterfall init, update, doctor 참조 확인
• git diff --check

참고

• 선행: manifest/migration 정책, install/update Skill, update PR workflow
• M020 로드맵 4단계: npm CLI로 init/update/doctor 제공

마일스톤과 label 후보

• milestone: M020 - 배포 채널 MVP 작업이므로 선택
• labels: enhancement, infrastructure
  • enhancement: CLI 기능 추가
  • infrastructure: 배포·검증 실행 채널 추가