릴리스 노트

Maekon은 태그/Cargo 수준에서는 SemVer, 사용자 노출 표면에서는 CalVer 를 병행합니다 — NousResearch/hermes-agent 와 동일한 패턴입니다. 빌드 날짜와 짧은 커밋 SHA 가 모든 릴리스 페이지, maekon --version, 그리고 get_app_build_info IPC 에 표시됩니다.

노출 위치	포맷
Git 태그 / Cargo.toml	SemVer만 — `v0.0.1-rc.3`
GitHub Release 제목	`Maekon v0.0.1-rc.3`
릴리스 노트 1행	`## Maekon v0.0.1-rc.3 — Released May 06, 2026`
릴리스 노트 2행	`Built: 2026-05-06 UTC · Commit: 628908505`
`maekon --version`	`maekon 0.0.1-rc.3 (build: 2026-05-06 \| commit: 628908505)`

릴리스 주기

RC 반복 — 릴리스 사이클 내 필요에 따라 (보통 stable cut 당 1-3 RC)
RC 안정화 기간 — 최종 RC 와 stable 승격 사이 약 4주
Stable 승격 — promote-stable.yml 워크플로우 (workflow_dispatch, GitHub App 인증)
고정된 주간/월간 주기는 없으며, 기능/수정 준비도에 따라 진행됩니다.

1.0 이전 계약

v1.0 이전까지 공용 API 표면(Tauri IPC, 서버 gRPC 계약, 설정 스키마)은 SemVer §4 에 따라 minor 버전 간에 깨질 수 있습니다. CHANGELOG.md 는 Conventional Commits 규약에 따라 모든 breaking change 를 BREAKING CHANGE: 로 표시합니다.

CHANGELOG

공식 changelog 는 git-cliff 가 자동 생성하며 공개 저장소의 CHANGELOG.md 에 위치합니다. 각 릴리스 페이지가 해당 섹션을 미러링합니다.

릴리스 검증

모든 자산은 .sha256 + .sig (ed25519) 를 함께 제공합니다. 검증 예시:

PUB=fPiU9KchUIXZ7qOcjJIVp+W8rsO/WI7yStD+AiNuYvw=
ARTIFACT=maekon-linux-x64.tar.gz

curl -fLO "https://github.com/pseudotop/maekon-client/releases/latest/download/$ARTIFACT"
curl -fLO "https://github.com/pseudotop/maekon-client/releases/latest/download/$ARTIFACT.sig"

python3 -c "
import base64, sys
from nacl.signing import VerifyKey
data = open(sys.argv[1], 'rb').read()
sig = base64.b64decode(open(sys.argv[1] + '.sig').read().strip())
VerifyKey(base64.b64decode('$PUB')).verify(data, sig)
print('OK')
" "$ARTIFACT"

CI에서도 동일 검증이 Release Reliability Smoke job 으로 실행됩니다.

버저닝 정책 참고

SemVer + CalVer 하이브리드의 근거는 공개 저장소의 docs/RELEASE-POLICY.md 를 참고하세요.

최신 릴리스​

릴리스 주기​

1.0 이전 계약​

CHANGELOG​

릴리스 검증​

버저닝 정책 참고​

최신 릴리스

릴리스 주기

1.0 이전 계약

CHANGELOG

릴리스 검증

버저닝 정책 참고