gt-release

name	gt-release
description	Release a QA-verified Korean game patch using the platform adapter's exact contract, deterministic hashes, runtime evidence, notes, and cleanup evidence; for NSW build or patch packaging, consume the canonical ZIP produced by gt-nsw-build.

gt-release — 통합 QA 이후: 배포용 파일 생성

검증 완료된 패치를 배포 가능한 패키지로 만든다.

$GT_HOME = 지식 베이스 루트. Codex에서는 이 스킬이 설치된 플러그인 루트(상위에 .codex-plugin/, skills/, common/이 있는 디렉터리)로 해석하고, Claude Code 플러그인에서는 ${CLAUDE_PLUGIN_ROOT}를 사용한다. 플러그인 외 수동 설치는 지원하지 않는다. 시작 전에 $GT_HOME/common/preflight-checks.md를 읽고 플랫폼 릴리스 계약·QA 승인·현재 canonical staging을 확인한다. 작업 중 문서와 실제의 괴리·막힌 지점·우회법을 발견하면 즉시 프로젝트 HANDOFF.md에 기록한다 ($GT_HOME/common/handoff-rules.md).

입력 조건

• gt-qa 완료 기준 전 항목 통과. runtime_policy는 중간 실행 빈도만 조절하며 릴리스의 최종 런타임 게이트를 생략하지 않는다. 50_test/RELEASE_RUNTIME_QA.json이 현재 최종 build에 대해 공식 사이트 배포용 릴리즈의 MCP 없는 직접 실행을 증명하고 npm run runtime:validate를 통과해야 한다. PENDING_RUNTIME이면 릴리스는 BLOCKED다.
• text_status=review_ready, font_status=verified, image_scope=required이면 image_status=review_ready; image_scope=N/A이면 이미지 단계 생략 사유와 0건 근거가 PROJECT.md/QA 보고서에 기록됨
• 플랫폼 어댑터 로드: $GT_HOME/platforms/<platform>/release.md
• PROJECT.md에 플랫폼 어댑터의 exact release path, filename, archive root, version ledger가 기록됨
• HANDOFF.md의 open 항목·cleanup 계획·세션 상태가 릴리스 파일과 충돌하지 않음

절대 규칙

• 배포물에 원본 게임 데이터를 포함하지 않는다. 패치는 변경분만 담는 형태여야 한다 (NSW: LayeredFS 모드 폴더, SFC: IPS/BPS 델타 패치, PS1/PS2: xdelta 등 델타 패치, Steam/PC: PATCH_MANIFEST.tsv로 재배포 허용이 증명된 map/plugin/font/config/delta overlay).
• 콘솔 키·펌웨어·롬 파일은 어떤 형태로도 포함 금지.
• 공통 스킬은 게임명·날짜·버전이 붙은 파일명을 임의로 선택하지 않는다. 정확한 경로·파일명· ZIP 루트는 플랫폼 어댑터와 PROJECT.md의 계약을 그대로 사용한다.
• 플랫폼 계약이 없거나 문서끼리 다른 이름·폴더·루트를 가리키면 패키징하지 말고 BLOCKED와 HANDOFF.md 기록을 남긴다.
• 사용자가 NSW에서 빌드 생성 또는 패치 생성이라고 하면 전담 gt-nsw-build로 라우팅한다. 이 스킬은 그 결과를 받아 정식 릴리스 게이트를 계속 수행한다. 진단 폴더·버전/candidate 하위 폴더·delta 적용기 패키지를 대신 만들지 않는다.
• NSW의 exact 결과는 40_build/releases/<BASE_TITLE_ID>.zip 하나이며 내부 root는 <BASE_TITLE_ID>/romfs/<패치파일>이다. 입력은 40_build/layeredfs/<BASE_TITLE_ID>/romfs/ 하나뿐이다. romfs/ 단독 root, <UPDATE_TITLE_ID>.zip, *.gldelta, apply_patch.py, NSP/XCI/키가 있으면 실패한다.

절차

1. 패키징: 플랫폼 어댑터의 배포 규격에 따라 패키지 생성.

   • 결정적 빌드: 같은 입력 → 바이트 동일 ZIP (타임스탬프 고정)
   • 파일명·출력 폴더·ZIP 루트: 플랫폼 어댑터의 canonical 규칙을 그대로 사용하고 수동 rename하지 않는다.
   • 패키지의 SHA-256 해시 기록
   • NSW는 gt-nsw-build에 위임해 다음 공용 명령으로 생성·재검증한다. 프로젝트별 임의 ZIP 코드로 우회하지 않는다.

     npm run release:package:nsw -- --project-root "<타이틀 루트>/_work/<BASE_TITLE_ID>" --replace
   npm run release:validate:nsw -- --project-root "<타이틀 루트>/_work/<BASE_TITLE_ID>"
   

   • Steam/PC는 platforms/steam/release.md의 공용 패키저로 40_build/overlay/와 PATCH_MANIFEST.tsv를 검증해 patch/ root의 canonical ZIP을 만든다.

     npm run release:package:steam -- --project-root "<install-root>/_work/<steam-APP_ID|pc-slug>"
     npm run release:validate:steam -- --project-root "<install-root>/_work/<steam-APP_ID|pc-slug>"
     

2. 설치 가이드 작성: INSTALL.md — 대상 게임 버전/리전, 설치 경로, 적용 방법, 제거 방법, 알려진 제한사항. 플랫폼별 설치법(에뮬레이터 모드 폴더/실기 적용)을 사용자 눈높이로.

3. 릴리스 노트: RELEASE_NOTES.md — 버전, 번역 범위(텍스트 %/이미지 % 또는 image_scope=N/A와 근거), 시험 환경(에뮬레이터·펌웨어 버전), 미번역/보류 항목, 크레딧.

4. 최종 검증: 패키지를 깨끗한 mod 환경에 풀어 적용한 뒤, 플랫폼 allowlist의 공식 사이트 배포용 릴리즈 에뮬레이터를 MCP 없이 직접 실행해 타이틀 화면과 인게임·한글·폰트· 저장/불러오기·조건부 이미지를 시험한다. 현재 package/build/mod/binary/log/캡처 hash로 RELEASE_RUNTIME_QA.json을 갱신하고 npm run runtime:validate를 다시 통과시킨다.

5. 아카이브: 릴리스 패키지·해시·증거를 플랫폼 어댑터가 지정한 canonical 경로에 보관. PROJECT.md의 상태는 모든 필수 QA·런타임/하드웨어 정책·체크섬 동기화가 끝난 뒤에만 released로 갱신한다. 버전은 canonical ZIP 파일명과 분리된 원장에서 관리한다.

6. 완료 후 정리: gt-project-cleanup 또는 npm run project:cleanup -- --project-root "<타이틀 루트>/_work/<프로젝트 ID>"로 Handoff·manifest 기반 CLEANUP_PLAN.json과 CLEANUP_INSTRUCTIONS.md를 먼저 생성한다. 계획의 exact 파일을 approved=true로 표시한 --apply는 cleanup archive로 이동하고 영구 삭제하지 않는다. 아카이브·프로젝트 전체 재검토 보고서를 사용자에게 상세히 전달한 뒤 같은 turn에서 멈춘다. 이후 사용자가 별도 요청으로 승인한 경우에만 현재 trash-plan SHA-256과 --trash --user-confirmed-trash로 아카이브 파일을 운영체제 휴지통에 보낸다. 휴지통 실패 시 영구 삭제로 폴백하지 않는다. 단순한 tmp glob 삭제, active 세션 삭제, 릴리스·QA·cleanup 증거 삭제는 금지한다. 상태 변경 시 로 재검토하고 승인을 초기화한다.

산출물

파일	내용
<adapter release path>/<canonical>.zip	배포 패키지 (+ SHA-256). NSW: <BASE_TITLE_ID>/romfs/; Steam/PC: patch/ + root PATCH_MANIFEST.tsv
<adapter release path>/INSTALL.md	설치 가이드
<adapter release path>/RELEASE_NOTES.md	릴리스 노트

완료 기준

• 패키지에 원본 게임 데이터·키 미포함 확인 (내용물 전수 목록 검사)
• 깨끗한 환경 적용 스모크 테스트 통과 (증거 보존)
• 공식 사이트 배포용 릴리즈를 직접 실행했고 mcp_used=false, URL·버전·바이너리 SHA-256·현재 build/mod/evidence가 검증됨
• npm run runtime:validate 및 플랫폼 구조 검증(NSW project:validate -- --strict, Steam/PC project:validate:steam -- --strict) 통과; MCP-only 결과나 PENDING_RUNTIME으로 릴리스하지 않음
• INSTALL.md / RELEASE_NOTES.md 완비, 해시 기록
• Handoff 기반 cleanup plan·지시서가 생성되고 보존 anchor와 승인 allowlist가 검증됨
• 승인된 정리를 적용했다면 plan SHA-256·아카이브 경로·전수 재검토·사용자 상세 보고가 기록됨
• 이후 별도 승인으로 휴지통 이동했다면 trash-plan SHA-256·backend·원래 아카이브 경로·TRASH_RECEIPT.json·플랫폼 구조 검증 결과가 기록됨
• canonical 파일명·경로·ZIP root·파일 allowlist가 어댑터 계약과 exact 일치
• NSW이면 release:validate:nsw가 entry 경로·CRC-32·SHA-256과 canonical RomFS를 전수 대조해 통과
• 공식 배포 릴리즈 런타임·하드웨어 상태와 released 판정이 서로 혼동되지 않음