d3ro-voice/scripts/ci/release-desktop.mjs

338 lines
15 KiB
JavaScript

// scripts/ci/release-desktop.mjs
// 데스크톱 릴리스 한 줄 명령 — 버전 올리기부터 기존 사용자 자동 업데이트까지.
//
// npm run release -- patch # 1.9.0 → 1.9.1 (fix)
// npm run release -- minor # 1.9.0 → 1.10.0 (feat)
// npm run release -- 2.0.0 # 직접 지정
// npm run release -- minor --dry-run # 무엇을 할지만 출력
// node --env-file-if-exists=.env scripts/ci/release-desktop.mjs minor --with-runtime
// — 새 사이드카/portable을 먼저 게시한 뒤 설치본을 게시한다.
// npm run release -- --resume # 빌드/게시/푸시 중 실패했을 때 같은 버전으로 이어서
//
// 단계 (실패하면 거기서 멈추고, --resume 으로 이어 간다):
// 1. 점검 main 브랜치 · 깨끗한 작업 트리 · Forgejo 토큰 · 서명 키 짝 · 태그 미사용
// 2. 버전 product-version.json + sync-version --write + CHANGELOG 섹션(없으면 커밋 제목으로 초안)
// 3. 게이트 typecheck · version:check · release:metadata
// 4. 커밋 + annotated 태그 (로컬 생성)
// 5. 빌드 build-desktop-installer.mjs
// 6. 푸시 chanpaca main + annotated 태그 (Forgejo Release 가 옛 main 에 가짜 태그를 만들지 않도록 게시 전에 푸시)
// 7. 게시 publish-forgejo-release.mjs (latest.yml Ed25519 서명 · 불변 버전 경로 · latest 피드 · 공개 URL 재검증)
//
// 태그는 불변이다. 게시된 버전에 문제가 있으면 더 높은 patch 로 다시 낸다.
import { spawnSync } from 'node:child_process'
import { existsSync, readFileSync, writeFileSync } from 'node:fs'
import { dirname, join } from 'node:path'
import { fileURLToPath } from 'node:url'
import { loadSigningKey, publicPemOf } from './lib/update-manifest-signature.mjs'
import { saveReleaseArtifacts, verifyReleaseArtifacts } from './lib/release-artifacts.mjs'
const root = join(dirname(fileURLToPath(import.meta.url)), '..', '..')
const args = process.argv.slice(2)
const dryRun = args.includes('--dry-run')
const resume = args.includes('--resume')
const withRuntime = args.includes('--with-runtime')
const bumpArg = args.find((arg) => !arg.startsWith('--'))
const CANONICAL_REMOTE = 'chanpaca'
const MIRROR_REMOTES = ['origin']
const FEED = 'https://git.chanpaca.net/api/packages/yunchan/generic/d3ro-voice'
const versionPath = join(root, 'release', 'product-version.json')
const changelogPath = join(root, 'CHANGELOG.md')
if (!resume && !bumpArg) {
fail('사용법: npm run release -- <patch|minor|major|X.Y.Z> [--dry-run] 또는 npm run release -- --resume')
}
// ── 1. 점검 ──
step('점검')
const branch = git(['rev-parse', '--abbrev-ref', 'HEAD'])
if (branch !== 'main') fail(`main 브랜치에서만 릴리스합니다 (현재 ${branch}).`)
if (!process.env.FORGEJO_TOKEN && !(process.env.FORGEJO_USERNAME && process.env.FORGEJO_PASSWORD)) {
fail('FORGEJO_TOKEN 이 없습니다 — 루트 .env 를 확인하세요.')
}
const repoPublicKey = readFileSync(join(root, 'release', 'desktop-update-public.pem'), 'utf8')
if (publicPemOf(loadSigningKey()).trim() !== repoPublicKey.trim()) {
fail('D3RO_UPDATE_SIGNING_KEY 가 release/desktop-update-public.pem 과 짝이 아닙니다.')
}
const dirty = git(['status', '--porcelain'])
if (dirty && !dryRun) fail(`작업 트리가 깨끗하지 않습니다 — 먼저 커밋하세요:\n${dirty}`)
const current = readJson(versionPath)
let version = current.version
if (resume) {
const tag = `v${version}`
if (!git(['tag', '--list', tag])) fail(`${tag} 태그가 없습니다 — 이어 갈 릴리스가 없습니다.`)
if (git(['rev-parse', `${tag}^{commit}`]) !== git(['rev-parse', 'HEAD'])) {
fail(`HEAD 가 ${tag} 가 아닙니다 — 태그 이후 커밋이 있으면 새 버전으로 릴리스하세요.`)
}
info(`${tag} 이어서 진행 (빌드 → 게시 → 푸시)`)
} else {
version = nextVersion(current.version, bumpArg)
const tag = `v${version}`
if (git(['tag', '--list', tag])) fail(`${tag} 태그가 이미 있습니다. 실패한 릴리스를 이어 가려면 --resume.`)
if (spawnGit(['ls-remote', '--exit-code', '--tags', CANONICAL_REMOTE, tag]).status === 0) {
fail(`${CANONICAL_REMOTE} 에 ${tag} 가 이미 있습니다.`)
}
if (await feedHasVersion(version)) fail(`피드에 ${version} 가 이미 게시돼 있습니다.`)
// ── 2. 버전 ──
step(`버전 ${current.version} → ${version}`)
const changelog = readFileSync(changelogPath, 'utf8')
const releaseDate = todayKst()
const notes = changelog.includes(`## [${version}] - `) ? null : draftNotes(current.version)
if (dryRun) {
info(notes ? `CHANGELOG 초안:\n${notes}` : 'CHANGELOG 섹션 있음')
info('단계: 커밋·태그 → 빌드 → 푸시 → 게시(서명) → 공개 URL 검증')
if (withRuntime) info('런타임 포함: 사이드카 재빌드 → portable/runtime 게시 → 설치본 게시')
info('dry-run — 아무것도 바꾸지 않았습니다.')
process.exit(0)
}
writeFileSync(
versionPath,
`${JSON.stringify({ ...current, version, ...mobileBuildNumbers(version), releaseDate }, null, 2)}\n`,
)
if (notes) {
insertChangelogSection(version, releaseDate, notes)
} else {
// 손으로 쓴 섹션의 날짜만 오늘로 맞춘다.
writeFileSync(
changelogPath,
changelog.replace(new RegExp(`## \\[${escapeRegExp(version)}\\] - \\d{4}-\\d{2}-\\d{2}`), `## [${version}] - ${releaseDate}`),
)
}
ensurePlayChangelogs(mobileBuildNumbers(version).androidVersionCode)
runNode('scripts/ci/sync-version.mjs', ['--write'])
// ── 3. 게이트 ──
step('게이트')
runNpm(['run', 'version:check'])
runNpm(['run', 'release:metadata'])
runNpm(['run', 'typecheck'])
// 여기까지 실패하면 버전 파일이 바뀐 상태다. 변경과 실패 증거를 보존하고 원인을 복구한다.
// ── 4. 커밋 + 태그 ──
step(`커밋 + 태그 ${tag}`)
gitInherit(['add', '-u'])
gitInherit(['commit', '-m', `chore(release): ${tag}`])
runNode('scripts/ci/create-release-tag.mjs', [])
}
const tag = `v${version}`
const tagCommit = git(['rev-parse', `${tag}^{commit}`])
const releaseDir = join(root, 'apps', 'desktop', 'release', version)
const artifactIdentity = { version, tagCommit, withRuntime }
const hasCheckpoint = existsSync(join(releaseDir, 'release-artifacts.json'))
// 태그가 생긴 뒤의 실패는 --resume 으로 이어 간다.
const resumeHint = `\n고친 뒤 이어 가기: node --env-file-if-exists=.env scripts/ci/release-desktop.mjs --resume${withRuntime ? ' --with-runtime' : ''}`
// 이미 게시가 끝난 버전을 다시 빌드하면 바이트가 달라 불변 경로와 충돌한다 — 푸시만 남은 경우다.
if (resume && !hasCheckpoint && !withRuntime && (await feedHasVersion(version))) {
info(`피드에 ${version} 가 이미 있습니다 — 빌드·게시를 건너뜁니다.`)
pushToRemotes(tag, tagCommit)
} else {
// ── 5. 빌드 ──
if (resume && hasCheckpoint) {
step('보존 산출물 검증')
await verifyReleaseArtifacts(releaseDir, artifactIdentity)
info('태그·해시가 일치하는 원본 산출물을 재사용합니다.')
} else {
if (existsSync(releaseDir)) {
fail(`기존 산출물을 보존합니다: ${releaseDir}\n검증 가능한 release-artifacts.json이 없습니다. 원본 산출물을 조사·복구한 뒤 재개하세요.`)
}
step('빌드')
runNode('scripts/ci/build-desktop-installer.mjs', [], {}, resumeHint)
if (withRuntime) {
runNpm(['run', 'sidecar:build', '--workspace=@d3ro/desktop'])
runNode('scripts/ci/verify-sidecar-bundle.mjs', ['--smoke'], {}, resumeHint)
runNode('scripts/ci/build-portable.mjs', ['--release-artifacts-only'], {}, resumeHint)
}
// 첫 업로드 전에 원본 바이트와 태그를 기록한다. 재개 시 재빌드하지 않는다.
await saveReleaseArtifacts(releaseDir, artifactIdentity)
}
// 런타임을 요구하는 앱을 먼저 게시하면 기존 사용자의 모델 로드가 막힌다.
// 기존 portable 게시기는 부품 해시를 검증하고 runtime 인덱스를 마지막에 게시한다.
if (withRuntime) {
step('런타임 선행 게시')
// 게시기는 동일 바이트를 건너뛰고 누락된 파일과 latest 별칭을 복구한다.
runNode('scripts/ci/publish-portable-release.mjs', [], {}, resumeHint)
}
// ── 6. 푸시 ──
// Forgejo Release 생성 API(POST /releases)는 원격에 태그가 아직 없으면 target_commitish 에
// lightweight 태그를 만들어 버려 뒤이은 annotated 태그 푸시가 'already exists' 로 실패한다(GAP-REL-14).
// 따라서 게시 전에 main 과 annotated 태그를 먼저 정본 원격(chanpaca)에 푸시한다.
pushToRemotes(tag, tagCommit)
// ── 7. 게시 ──
step('게시')
runNode(
'scripts/ci/publish-forgejo-release.mjs',
[],
{ FORGEJO_RELEASE_TAG: tag, FORGEJO_TARGET_COMMITISH: tagCommit },
resumeHint,
)
}
step('완료')
info(`${tag} 게시 완료. 기존 설치본은 다음 업데이트 확인(시작 15초 뒤, 이후 4시간마다)에 받습니다.`)
info(`피드: ${FEED}/latest/latest.yml`)
// ── helpers ──
function pushToRemotes(releaseTag, expectedCommit) {
step('푸시')
const pushed = spawnSync('git', ['push', CANONICAL_REMOTE, 'main', releaseTag], { cwd: root, stdio: 'inherit' })
if (pushed.status !== 0) {
fail(`${CANONICAL_REMOTE} 푸시 실패 — git push ${CANONICAL_REMOTE} main ${releaseTag}${resumeHint}`)
}
const deref = git(['ls-remote', CANONICAL_REMOTE, `refs/tags/${releaseTag}^{}`]).split(/\s+/)[0]
const direct = git(['ls-remote', CANONICAL_REMOTE, `refs/tags/${releaseTag}`]).split(/\s+/)[0]
const remoteCommit = deref || direct
if (remoteCommit && remoteCommit !== expectedCommit) {
fail(
`${CANONICAL_REMOTE} 의 ${releaseTag} 태그 커밋(${remoteCommit})이 로컬(${expectedCommit})과 다릅니다.`,
)
}
for (const remote of MIRROR_REMOTES) {
const result = spawnSync('git', ['push', remote, 'main', releaseTag], { cwd: root, stdio: 'inherit' })
if (result.status !== 0) warn(`${remote} 미러 푸시 실패 — 나중에 git push ${remote} main ${releaseTag}`)
}
}
function nextVersion(from, bump) {
const [major, minor, patch] = from.split('.').map(Number)
if (bump === 'patch') return `${major}.${minor}.${patch + 1}`
if (bump === 'minor') return `${major}.${minor + 1}.0`
if (bump === 'major') return `${major + 1}.0.0`
if (/^\d+\.\d+\.\d+$/.test(bump)) {
const [a, b, c] = bump.split('.').map(Number)
if (a * 1e8 + b * 1e4 + c <= major * 1e8 + minor * 1e4 + patch) fail(`${bump} 는 ${from} 보다 높아야 합니다.`)
return bump
}
fail(`알 수 없는 버전 지정: ${bump} (patch|minor|major|X.Y.Z)`)
}
/** 1.9.0 → 1090000 (기존 규칙: major*1e6 + minor*1e4 + patch*1e2) */
function mobileBuildNumbers(next) {
const [major, minor, patch] = next.split('.').map(Number)
const code = major * 1_000_000 + minor * 10_000 + patch * 100
return { androidVersionCode: code, iosBuildNumber: code }
}
function draftNotes(previous) {
const subjects = git(['log', '--no-merges', '--format=%s', `v${previous}..HEAD`]).split('\n').filter(Boolean)
const groups = { Added: [], Fixed: [], Changed: [] }
for (const subject of subjects) {
const match = subject.match(/^(\w+)(?:\([^)]*\))?!?:\s*(.+)$/)
const type = match?.[1]
const text = match?.[2] ?? subject
if (type === 'feat') groups.Added.push(text)
else if (type === 'fix') groups.Fixed.push(text)
else if (type === 'perf' || type === 'refactor') groups.Changed.push(text)
}
const body = Object.entries(groups)
.filter(([, items]) => items.length > 0)
.map(([heading, items]) => `### ${heading}\n${items.map((item) => `- ${item}`).join('\n')}`)
.join('\n\n')
return body || '### Changed\n- Maintenance release.'
}
function insertChangelogSection(next, date, notes) {
const text = readFileSync(changelogPath, 'utf8')
const anchor = text.search(/\n## \[\d+\.\d+\.\d+\]/)
const section =
`\n## [${next}] - ${date}\n\n` +
'> Published from an annotated tag. Installer and update metadata are served by the\n' +
'> canonical Forgejo feed; no binaries are committed to this repository.\n\n' +
`${notes}\n`
writeFileSync(changelogPath, anchor === -1 ? `${text.trimEnd()}\n${section}` : `${text.slice(0, anchor)}\n${section}${text.slice(anchor)}`)
}
/**
* 모바일과 버전을 같이 쓰므로 release:metadata 가 새 versionCode 의 Play '새 기능' 문구를 요구한다.
* 데스크톱만 내는 릴리스면 일반 문구로 채운다 — 모바일을 실제로 낼 때 고쳐 쓴다.
*/
function ensurePlayChangelogs(versionCode) {
const texts = {
'ko-KR': '안정성과 성능을 개선했습니다.',
'en-US': 'Stability and performance improvements.',
}
for (const [locale, text] of Object.entries(texts)) {
const path = join(root, 'apps', 'mobile-rn', 'metadata', 'android', locale, 'changelogs', `${versionCode}.txt`)
if (!existsSync(path)) {
writeFileSync(path, `${text}\n`)
gitInherit(['add', path])
}
}
}
async function feedHasVersion(next) {
const response = await fetch(`${FEED}/${next}/latest.yml`, { cache: 'no-store' }).catch(() => null)
return Boolean(response?.ok)
}
function todayKst() {
return new Date(Date.now() + 9 * 3600_000).toISOString().slice(0, 10)
}
function escapeRegExp(value) {
return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
}
function readJson(path) {
return JSON.parse(readFileSync(path, 'utf8'))
}
function spawnGit(commandArgs) {
return spawnSync('git', commandArgs, { cwd: root, encoding: 'utf8' })
}
function git(commandArgs) {
const result = spawnGit(commandArgs)
if (result.status !== 0 && !(commandArgs[0] === 'tag' && commandArgs[1] === '--list')) {
fail(`git ${commandArgs.join(' ')} 실패: ${result.stderr?.trim() || `exit ${result.status}`}`)
}
return (result.stdout ?? '').trim()
}
function gitInherit(commandArgs) {
const result = spawnSync('git', commandArgs, { cwd: root, stdio: 'inherit' })
if (result.status !== 0) fail(`git ${commandArgs.join(' ')} 실패 (exit ${result.status ?? 'null'})`)
}
function runNpm(commandArgs) {
info(`$ npm ${commandArgs.join(' ')}`)
const result = spawnSync('npm', commandArgs, { cwd: root, stdio: 'inherit', shell: process.platform === 'win32' })
if (result.status !== 0) fail(`npm ${commandArgs.join(' ')} 실패 (exit ${result.status ?? 'null'})`)
}
function runNode(relativePath, scriptArgs, env = {}, hint = '') {
info(`$ node ${relativePath} ${scriptArgs.join(' ')}`)
const result = spawnSync(process.execPath, [join(root, relativePath), ...scriptArgs], {
cwd: root,
stdio: 'inherit',
env: { ...process.env, ...env },
})
if (result.status !== 0) fail(`${relativePath} 실패 (exit ${result.status ?? 'null'})${hint}`)
}
function step(name) {
process.stdout.write(`\n[release] ── ${name} ──\n`)
}
function info(message) {
process.stdout.write(`[release] ${message}\n`)
}
function warn(message) {
process.stdout.write(`[release] 경고: ${message}\n`)
}
function fail(message) {
process.stderr.write(`[release] ${message}\n`)
process.exit(1)
}