docs(release): v0.2.0-alpha — CHANGELOG + Release 운영 가이드
Some checks failed
Build macOS / Build & Package (macOS) (push) Failing after 5s
Build macOS / Build & Package (macOS)-1 (push) Failing after 5s

- CHANGELOG [0.2.0-alpha] 섹션 (switchboard 스타일, ## [Unreleased] 최상단 정렬,
  Added/Changed/Fixed/Removed/Internal). publish-gitlab-release.mjs가 Release 노트로 자동 추출.
- release-guide.md "Release 페이지 운영" 섹션 추가 (CHANGELOG=Release 노트,
  권장 구조, 릴리스 체크리스트, 버전 정책). switchboard 패턴 벤치마크.
- project_status: v0.2.0-alpha 릴리스 기록
This commit is contained in:
Yun Chan 2026-07-22 02:50:26 +09:00
parent b1435b0ba5
commit 38a466ea0c
3 changed files with 95 additions and 9 deletions

View file

@ -68,7 +68,36 @@ latest.yml의 url과 레지스트리 파일명이 어긋나면 업데이트 다
| macOS 서명/공증 | ❌ ad-hoc 서명 (`identity=-`, switchboard 검증 조합) — Gatekeeper가 차단하면 우클릭→열기 또는 `xattr -dr com.apple.quarantine "/Applications/D3RO Voice.app"` | Apple Developer 계정($99/년) 확보 시 switchboard의 prepare/cleanup-macos-keychain.mjs + 공증 패턴 이식. 주의: D3RO는 asarUnpack native 모듈 + ollama/sox 바이너리 다중 서명 필요 |
| macOS 자동 업데이트 | ❌ 미지원 (Squirrel.Mac이 서명 요구) | 서명 도입 후 latest-mac.yml feed 연결 |
| 업데이트 무결성 서명 | latest.yml SHA-512 (electron-builder 기본) | switchboard의 Ed25519 update-policy 매니페스트 체계 이식 검토 |
| CHANGELOG | 없음 — Release 노트는 기본 안내문 | `CHANGELOG.md` 작성 시 publish 스크립트가 해당 버전 섹션을 자동 추출 |
| CHANGELOG | ✅ v0.2.0-alpha부터 운영 | `publish-gitlab-release.mjs``## [버전]` 섹션을 Release 노트로 자동 추출. CHANGELOG를 풍부하게 = Release 페이지 품질 직결 |
## Release 페이지 운영 (v0.2.0-alpha부터)
GitLab Release 페이지는 **CHANGELOG가 단일 진실 원천**이다. 릴리스 품질을 올기려면 CHANGELOG를 잘 쓴다.
### Release 노트 = CHANGELOG 섹션 (자동)
`publish-gitlab-release.mjs``extractChangelogSection(changelog, version)`가 태그 버전(`0.2.0-alpha`)과 매칭되는 `## [0.2.0-alpha]` 섹션을 Release 노트로 추출. **CHANGELOG를 고치면 Release 노트에 자동 반영** — 릴리스 후수정해도 다음 릴리스에 반영되지 않으니 릴리스 "전"에 CHANGELOG를 확정.
### 권장 섹션 구조 (Keep a Changelog)
```
## [버전] - YYYY-MM-DD
> 다운로드 안내 (Windows exe / macOS dmg 파일명 + 자동업데이트/서명 메모)
### Added / Changed / Fixed / Removed / Internal
```
- 상단 인용 블록(`>`)에 다운로드 파일명·자동업데이트·macOS 서명 안내를 적으면 사용자가 Release 페이지에서 바로 확인.
- 내부 작업(refactor-wave 등)은 `### Internal`로 분리 — 사용자 관심사(Added/Fixed)가 위에 오도록.
### 릴리스 체크리스트
1. CHANGELOG `[버전]` 섹션 작성 (위 구조)
2. `memory/project_status.md` 최신화 (규칙 13)
3. `git tag vX.Y.Z && git push origin vX.Y.Z`
4. GitLab 파이프라인 모니터링 (package-windows / package-macos / release-create)
5. Release 페이지에서 노트·asset 링크·latest.yml 확인
6. (검증) 기존 앱에서 자동 업데이트 수신 확인
### 버전 정책
- `0.x.y-alpha`: 개발 프리릴리스 (현재 단계). 자동업데이트 feed는 alpha 체널.
- minor 범프: 대규모 재설계/정리(Midnight Glass v2, refactor-wave). patch: 버그 수정 중심.
- alpha→정식 전환은 기능·안정성 기준 충족 시 (별도 합의).
| mac x64 (Intel) | 빌드 안 함 (사이드카가 arm64 전용) | 수요 발생 시 Intel Mac runner 추가 |
## 참고 파일