/release

name: release
description: hwpjs 배포 플로우. 버전 범프, 빌드, 커밋, PR 생성, npm 배포, GitHub 릴리즈까지 전체 과정을 수행한다.
disable-model-invocation: true
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, Agent
argument-hint: [version (예: 0.1.0-rc.10)]

hwpjs 배포 플로우

`$ARGUMENTS` 버전으로 배포를 진행한다.

1. 버전 업데이트

아래 파일들의 버전을 `$ARGUMENTS`로 변경한다:

• `packages/hwpjs/package.json`
• `version` 필드
• `optionalDependencies`의 모든 `@ohah/hwpjs-*` 패키지 버전
• `packages/hwpjs/npm/*/package.json` (7개 플랫폼 패키지)
• darwin-arm64, darwin-x64, linux-x64-gnu, wasm32-wasi, win32-arm64-msvc, win32-ia32-msvc, win32-x64-msvc
• `bun.lock` 내 `@ohah/hwpjs` 관련 버전

2. 릴리스 빌드

cd packages/hwpjs && bun run build:release

이 명령은 다음을 수행한다:

• 모든 플랫폼 네이티브 바이너리 빌드 (`build:node:all`)
• WASM 파일 리네임 (`postbuild:node:all`)
• npm 디렉토리 생성 (`prepare:artifacts`)
• 빌드 아티팩트를 npm 디렉토리로 복사 (`artifacts`)
• prepublish dry-run (`prepublishOnly`)

3. 빌드 검증

빌드 완료 후 아래 아티팩트가 존재하는지 확인한다:

• `packages/hwpjs/dist/hwpjs.*.node` (6개 플랫폼)
• `packages/hwpjs/dist/hwpjs.wasm32-wasi.wasm`
• `packages/hwpjs/dist/index.js`
• `packages/hwpjs/npm/*/hwpjs.*.node` (6개)
• `packages/hwpjs/npm/wasm32-wasi/hwpjs.wasm32-wasi.wasm`
• `packages/hwpjs/dist/react-native/` (index.cjs, index.mjs)

4. 커밋 및 PR

1. main 브랜치에서 `chore/bump-version-{suffix}` 브랜치 생성 (예: `chore/bump-version-rc10`) 2. 변경된 모든 파일을 커밋: `chore: bump version to $ARGUMENTS` 3. 리모트에 push 후 PR 생성 4. PR 본문 형식:

## Summary
- 모든 npm 패키지 버전을 `{이전버전}` → `$ARGUMENTS`로 업데이트
- 로컬 빌드(`build:release`) 실행하여 빌드 아티팩트 포함

## 변경 파일
- `packages/hwpjs/package.json` (version + optionalDependencies)
- `packages/hwpjs/npm/*/package.json` (각 플랫폼 패키지 버전)
- `packages/hwpjs/dist/` (빌드 바이너리)
- `packages/hwpjs/npm/*/hwpjs.*.node` (플랫폼별 네이티브 바이너리)

5. 머지 후 릴리즈

PR이 머지된 후 진행한다: 1. main 브랜치 최신화: `git checkout main && git pull origin main --rebase` 2. 이전 버전과 비교하여 커밋 목록 확인: `git log --oneline {이전태그}..HEAD` 3. GitHub 릴리즈 생성 (`gh release create`)

• 태그: `@ohah/hwpjs@$ARGUMENTS`
• 릴리즈 노트에 Features / Bug Fixes / Chores 카테고리로 분류

6. npm 배포

cd packages/hwpjs && bash scripts/publish.sh --tag latest

배포 후 확인:

npm view @ohah/hwpjs dist-tags
npx @ohah/hwpjs@latest --version

사용자 확인 포인트

각 단계 사이에 반드시 사용자에게 확인을 받고 다음 단계로 넘어간다:

1. **버전 업데이트 후** → 변경된 파일 목록을 보여주고 빌드 진행 여부 확인 2. **빌드 완료 후** → 아티팩트 검증 결과를 보여주고 커밋/PR 진행 여부 확인 3. **PR 생성 후** → PR 링크를 공유하고 멈춤. 머지는 사용자가 직접 수행 4. **머지 확인 후** → 사용자가 머지했다고 알려주면 릴리즈 노트 초안을 보여주고 확인 5. **릴리즈 생성 후** → npm 배포 진행 여부와 태그(latest/next) 확인 6. **배포 완료 후** → `npm view` 및 `npx --version` 결과를 보여주고 최종 확인

절대 사용자 확인 없이 다음 단계로 자동 진행하지 않는다.

주의사항

• 배포(`publish`)는 사용자가 명시적으로 요청한 경우에만 수행한다
• PR 머지는 리베이스 머지를 사용한다
• pre-release 버전(rc, beta, alpha)도 사용자가 `--tag latest`를 요청하면 latest로 배포한다