// 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 # 무엇을 할지만 출력 // 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. 게시 publish-forgejo-release.mjs (latest.yml Ed25519 서명 · 불변 버전 경로 · latest 피드 · 공개 URL 재검증) // 7. 푸시 chanpaca main + 태그 (origin 미러는 실패해도 경고만) // // 태그는 불변이다. 게시된 버전에 문제가 있으면 더 높은 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' 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 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 -- [--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 검증 → 푸시') 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']) // 여기까지 실패하면 버전 파일만 바뀐 상태다 — git checkout -- . 로 되돌리고 다시 실행. // ── 4. 커밋 + 태그 ── step(`커밋 + 태그 ${tag}`) gitInherit(['add', '-u']) gitInherit(['commit', '-m', `chore(release): ${tag}`]) runNode('scripts/ci/create-release-tag.mjs', []) } const tag = `v${version}` // 태그가 생긴 뒤의 실패는 --resume 으로 이어 간다. const resumeHint = '\n고친 뒤 이어 가기: npm run release -- --resume' // 이미 게시가 끝난 버전을 다시 빌드하면 바이트가 달라 불변 경로와 충돌한다 — 푸시만 남은 경우다. if (resume && (await feedHasVersion(version))) { info(`피드에 ${version} 가 이미 있습니다 — 빌드·게시를 건너뜁니다.`) } else { // ── 5. 빌드 ── step('빌드') runNode('scripts/ci/build-desktop-installer.mjs', [], {}, resumeHint) // ── 6. 게시 ── step('게시') runNode('scripts/ci/publish-forgejo-release.mjs', [], { FORGEJO_RELEASE_TAG: tag }, resumeHint) } // ── 7. 푸시 ── step('푸시') // 게시는 끝났다 — 푸시 실패는 사용자 업데이트에 영향이 없고, 손으로 다시 밀면 된다. const pushed = spawnSync('git', ['push', CANONICAL_REMOTE, 'main', tag], { cwd: root, stdio: 'inherit' }) if (pushed.status !== 0) warn(`${CANONICAL_REMOTE} 푸시 실패 — git push ${CANONICAL_REMOTE} main ${tag}`) for (const remote of MIRROR_REMOTES) { const result = spawnSync('git', ['push', remote, 'main', tag], { cwd: root, stdio: 'inherit' }) if (result.status !== 0) warn(`${remote} 미러 푸시 실패 — 나중에 git push ${remote} main ${tag}`) } step('완료') info(`${tag} 게시 완료. 기존 설치본은 다음 업데이트 확인(시작 15초 뒤, 이후 4시간마다)에 받습니다.`) info(`피드: ${FEED}/latest/latest.yml`) // ── helpers ── 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) }