| name | publishing-pub-dev |
| description | Use when publishing a Dart package to pub.dev. Handles version bumping, CHANGELOG updates, git tagging, verification, and publishing. Triggers after implementation cycles complete or when user requests deployment. |
Publishing to pub.dev
Overview
버전 업 → CHANGELOG → 검증 → 커밋 → 태그 → 푸시 → 배포 파이프라인.
Core principle: 모든 단계가 자동화되어야 하며, dry-run 경고가 0일 때만 배포한다.
When to Use
- continuous-improvement 루프 5회마다 자동 배포 시점
- 사용자가 "publish", "deploy", "배포"라고 명시할 때
- finishing-a-development-branch 이후 배포가 필요할 때
Pre-flight Checklist
dart analyze
dart format --set-exit-if-changed .
dart test
git status --porcelain
모든 항목 통과 시에만 진행. 실패 시 수정 후 처음부터 재시도.
Version Bump Rules
| 조건 | Bump | 예시 |
|---|
| 리팩토링, dartdoc, 버그 수정, 문서 | patch | 0.0.2 → 0.0.3 |
| 새 위젯, 새 기능 | minor | 0.0.x → 0.1.0 |
| Breaking API 변경 | major | 0.x → 1.0.0 |
| continuous-improvement 5루프 누적 | patch | 자동 |
Steps
1. Version Bump
pubspec.yaml의 version 필드를 업데이트.
2. CHANGELOG Update
CHANGELOG.md 최상단에 새 항목 추가:
## X.Y.Z (YYYY-MM-DD)
- 변경 내용 1
- 변경 내용 2
항목은 git log --oneline 최근 커밋에서 추출.
3. Dry-run Verification
dart pub publish --dry-run 2>&1 | tail -5
0 warnings 확인. warnings 있으면 수정 후 Step 1부터 재시도.
4. Commit & Tag
git add -A
git commit -m "chore: publish vX.Y.Z"
git tag vX.Y.Z
5. Push
git push origin main --tags
6. Publish
dart pub publish --force
7. Verify
curl -s https://pub.dev/api/packages/radartui | grep '"version"'
Error Recovery
| 상황 | 대응 |
|---|
| dry-run warnings | 원인 수정 → patch bump → Step 1부터 재시도 |
| publish 실패 (네트워크) | 재시도 |
| publish 실패 (검증) | 원인 수정 → patch bump → Step 1부터 재시도 |
| 태그 이미 존재 | git tag -d vX.Y.Z && git push origin :refs/tags/vX.Y.Z 후 재생성 |
| pub.dev 로그인 안됨 | dart pub login 안내 후 중단 |
Red Flags
- dry-run 경고를 무시하고 배포 금지
- 태그 없이 배포 금지 (repository 검증 실패 원인)
- GitHub push 없이 배포 금지 (repository 검증 실패 원인)
dart analyze 경과가 0 issues가 아닌데 배포 금지
Quick Reference
pre-flight → version bump → changelog → dry-run → commit → tag → push → publish → verify
