project-auto-wizard 0.13.3 → 0.15.0

package/README.ja.md

@@ -49,6 +49,8 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 生成されたファイルをコミットして push してください。`npx project-auto-wizard --mode doctor` は、ワークフローが依存するリポジトリ設定を確認します。
 
+メッセージの言語は英語または韓国語（`en` | `ko`）です。`--lang`、環境変数 `PROJECT_AUTO_WIZARD_LANG`、`version.yml` の `language` の順に優先されます。
+
 ## インストールされるもの
 
 | インストール対象 | 用途 |

package/README.ko.md

@@ -49,6 +49,8 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 생성된 파일을 커밋하고 push하세요. `npx project-auto-wizard --mode doctor`는 워크플로우가 의존하는 레포 설정을 점검합니다.
 
+메시지 언어는 영어 또는 한국어(`en` | `ko`)입니다. `--lang`, 환경변수 `PROJECT_AUTO_WIZARD_LANG`, `version.yml`의 `language` 순서로 우선 적용됩니다.
+
 ## 설치되는 것
 
 | 설치 항목 | 용도 |

package/README.md

@@ -21,7 +21,7 @@ Everything it installs is plain GitHub Actions in your own repository. No API ke
 </div>
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest Version : v0.13.3 (2026-09-30)
+## Latest Version : v0.15.0 (2026-09-30)
 
 [Full release history](CHANGELOG.md)
 
@@ -50,6 +50,8 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 Commit the generated files and push. `npx project-auto-wizard --mode doctor` checks the repository settings the workflows depend on.
 
+Messages are in English or Korean (`en` | `ko`). Pick one with `--lang`, the `PROJECT_AUTO_WIZARD_LANG` environment variable, or `language` in `version.yml`, in that order of precedence.
+
 ## What you get
 
 | Installed | Purpose |

package/README.zh-CN.md

@@ -49,6 +49,8 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 提交生成的文件并 push。`npx project-auto-wizard --mode doctor` 会检查工作流所依赖的仓库设置。
 
+消息语言为英语或韩语（`en` | `ko`）。可通过 `--lang`、环境变量 `PROJECT_AUTO_WIZARD_LANG` 或 `version.yml` 中的 `language` 指定，优先级依次降低。
+
 ## 安装内容
 
 | 安装项 | 用途 |

package/bin/project-auto-wizard.js

@@ -1,18 +1,32 @@
 #!/usr/bin/env node
-// project-auto-wizard CLI 엔트리 — argv를 src/index.js의 run()에 넘긴다.
+// project-auto-wizard CLI entry: passes argv to run() in src/index.js.
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { dirname, join } from "node:path";
 
+const here = dirname(fileURLToPath(import.meta.url));
 const [nodeMajor, nodeMinor] = process.versions.node.split(".").map(Number);
 if (nodeMajor < 20 || (nodeMajor === 20 && nodeMinor < 12)) {
-  console.error(`Node.js 20.12 이상이 필요합니다 (현재: ${process.versions.node})`);
+  // Plain English fallback: the message catalog may not even load on an unsupported Node.
+  let message = `Node.js 20.12 or later is required (current: ${process.versions.node})`;
+  try {
+    // Resolve the language cheaply (--lang flag -> env var) so the message matches the requested language.
+    const argv = process.argv.slice(2);
+    const at = argv.lastIndexOf("--lang");
+    const norm = (v) => String(v ?? "").trim().toLowerCase();
+    const { t, setLanguage } = await import(pathToFileURL(join(here, "..", "src", "i18n", "index.js")).href);
+    setLanguage(norm(process.env.PROJECT_AUTO_WIZARD_LANG)); // invalid values are ignored by setLanguage
+    if (at >= 0) setLanguage(norm(argv[at + 1]));
+    const inline = argv.findLast((a) => a.startsWith("--lang="));
+    if (inline) setLanguage(norm(inline.slice("--lang=".length)));
+    message = t("cli.bin.nodeVersion", { current: process.versions.node });
+  } catch { /* keep the English fallback */ }
+  console.error(message);
   process.exit(1);
 }
 
-const here = dirname(fileURLToPath(import.meta.url));
 const indexPath = join(here, "..", "src", "index.js");
 const { run } = await import(pathToFileURL(indexPath).href);
 
 const code = await run(process.argv.slice(2), { cwd: process.cwd() });
-// process.exit() 대신 exitCode — 파이프로 연결된 stdout/stderr가 끝까지 flush된 뒤 종료되게 한다.
+// Set exitCode instead of calling process.exit() so piped stdout/stderr is fully flushed before exit.
 process.exitCode = code;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.13.3",
+  "version": "0.15.0",
   "description": "One command DevOps: npx wizard that installs GitHub-native Release Automation (optional GitHub Copilot AI summaries) into any project",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   ],
   "scripts": {
     "test": "npm run test:node && npm run test:py",
-    "test:node": "node --test --test-concurrency=1",
+    "test:node": "node --test --test-concurrency=1 --import ./tests/setup-lang.mjs",
     "test:py": "node scripts/run-py-tests.mjs",
     "generate:workflows": "node scripts/generate-workflows.mjs",
     "generate:workflows:check": "node scripts/generate-workflows.mjs --check",

package/payload/config/breaking-changes.json

@@ -3,46 +3,60 @@
     {
       "severity": "warning",
       "types": ["flutter"],
-      "title": "Flutter SELFHOSTED·TEST-APK가 flutter build를 직접 실행",
-      "message": "SELFHOSTED·TEST-APK가 fastlane build 대신 flutter build apk --release를 직접 실행하고 Ruby·fastlane 설치 스텝이 사라집니다. fastlane은 스토어 배포 3종(PLAYSTORE·IOS-TESTFLIGHT·IOS-TEST-TESTFLIGHT)에서만 사용합니다."
+      "title": "Flutter SELFHOSTED and TEST-APK now run flutter build directly",
+      "message": "SELFHOSTED and TEST-APK run flutter build apk --release directly instead of fastlane build, and the Ruby/fastlane install steps are gone. fastlane is now used only by the three store deploy workflows (PLAYSTORE, IOS-TESTFLIGHT, IOS-TEST-TESTFLIGHT).",
+      "title_ko": "Flutter SELFHOSTED·TEST-APK가 flutter build를 직접 실행",
+      "message_ko": "SELFHOSTED·TEST-APK가 fastlane build 대신 flutter build apk --release를 직접 실행하고 Ruby·fastlane 설치 스텝이 사라집니다. fastlane은 스토어 배포 3종(PLAYSTORE·IOS-TESTFLIGHT·IOS-TEST-TESTFLIGHT)에서만 사용합니다."
     },
     {
       "severity": "warning",
       "types": ["flutter"],
-      "title": "Flutter 환경변수 기본 방식이 dart-define으로 변경",
-      "message": "신규 설치의 기본값이 dart-define(--dart-define-from-file)으로 바뀝니다. 기존 설치는 version.yml에 저장값이 없으면 dotenv(.env 생성)를 유지하며, 바꾸려면 마법사 '수정하기 > 환경변수 방식' 또는 --flutter-env-mode를 쓰세요."
+      "title": "Flutter env default switched to dart-define",
+      "message": "New installs default to dart-define (--dart-define-from-file). Existing installs keep dotenv (a generated .env) when version.yml has no saved value; to change it, use the wizard 'Modify > environment variable method' or --flutter-env-mode.",
+      "title_ko": "Flutter 환경변수 기본 방식이 dart-define으로 변경",
+      "message_ko": "신규 설치의 기본값이 dart-define(--dart-define-from-file)으로 바뀝니다. 기존 설치는 version.yml에 저장값이 없으면 dotenv(.env 생성)를 유지하며, 바꾸려면 마법사 '수정하기 > 환경변수 방식' 또는 --flutter-env-mode를 쓰세요."
     },
     {
       "severity": "warning",
       "types": ["flutter"],
-      "title": "Flutter 워크플로우가 FLUTTER_PROJECT_DIR 기준으로 동작",
-      "message": "FIREBASE·SELFHOSTED·CI·TEST-APK·IOS-TEST-TESTFLIGHT도 PLAYSTORE처럼 Flutter 루트(FLUTTER_PROJECT_DIR)에서 동작합니다. Flutter가 하위 폴더에 있는 모노레포는 --paths flutter=<경로>로 지정하세요."
+      "title": "Flutter workflows now run from FLUTTER_PROJECT_DIR",
+      "message": "FIREBASE, SELFHOSTED, CI, TEST-APK and IOS-TEST-TESTFLIGHT now run from the Flutter root (FLUTTER_PROJECT_DIR), like PLAYSTORE. For a monorepo where Flutter lives in a subfolder, set it with --paths flutter=<path>.",
+      "title_ko": "Flutter 워크플로우가 FLUTTER_PROJECT_DIR 기준으로 동작",
+      "message_ko": "FIREBASE·SELFHOSTED·CI·TEST-APK·IOS-TEST-TESTFLIGHT도 PLAYSTORE처럼 Flutter 루트(FLUTTER_PROJECT_DIR)에서 동작합니다. Flutter가 하위 폴더에 있는 모노레포는 --paths flutter=<경로>로 지정하세요."
     },
     {
       "severity": "warning",
       "types": ["flutter", "go", "next", "python", "react", "spring"],
-      "title": "모노레포 CI required check는 ci-gate 하나만 등록",
-      "message": "CI 워크플로우(Flutter·Go·Next·Python·React·Spring CI)는 항상 실행되고 변경이 없으면 job을 건너뜁니다. required check로 쓰려면 개별 job이 아닌 CI Gate(ci-gate) 하나만 등록하세요."
+      "title": "Register only ci-gate as the monorepo CI required check",
+      "message": "CI workflows (Flutter, Go, Next, Python, React, Spring CI) always run and skip their jobs when nothing changed. To use them as a required check, register only the CI Gate (ci-gate), not the individual jobs.",
+      "title_ko": "모노레포 CI required check는 ci-gate 하나만 등록",
+      "message_ko": "CI 워크플로우(Flutter·Go·Next·Python·React·Spring CI)는 항상 실행되고 변경이 없으면 job을 건너뜁니다. required check로 쓰려면 개별 job이 아닌 CI Gate(ci-gate) 하나만 등록하세요."
     }
   ],
   "0.12.0": [
     {
       "severity": "warning",
-      "title": "AI 요약이 GitHub Copilot opt-in으로 바뀌어 기본으로 꺼짐",
-      "message": "GitHub Models 종료로 AI 요약 엔진이 GitHub Copilot CLI로 바뀌었고, AI Credits를 소비하므로 기본값이 꺼짐(copilot_ai: false)입니다. 업데이트 후 릴리스 노트·PR 요약은 규칙 기반으로 만들어집니다. 계속 쓰려면 --copilot으로 다시 설치하거나 version.yml의 copilot_ai를 true로 바꾼 뒤 다시 실행하세요."
+      "title": "AI summary is now a GitHub Copilot opt-in and is off by default",
+      "message": "With GitHub Models retired, the AI summary engine is now GitHub Copilot CLI. It consumes AI Credits, so it defaults to off (copilot_ai: false). After updating, release notes and PR summaries are rule-based. To keep using it, reinstall with --copilot or set copilot_ai to true in version.yml and run again.",
+      "title_ko": "AI 요약이 GitHub Copilot opt-in으로 바뀌어 기본으로 꺼짐",
+      "message_ko": "GitHub Models 종료로 AI 요약 엔진이 GitHub Copilot CLI로 바뀌었고, AI Credits를 소비하므로 기본값이 꺼짐(copilot_ai: false)입니다. 업데이트 후 릴리스 노트·PR 요약은 규칙 기반으로 만들어집니다. 계속 쓰려면 --copilot으로 다시 설치하거나 version.yml의 copilot_ai를 true로 바꾼 뒤 다시 실행하세요."
     }
   ],
   "0.12.1": [
     {
       "severity": "warning",
       "types": ["spring"],
-      "title": "Spring nexus·GitHub Packages publish 옵션 제거",
-      "message": "PROJECT-SPRING-NEXUS-PUBLISH.yml·PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH.yml을 더 이상 설치하지 않고, PROJECT-SPRING-NEXUS-CI.yml은 PROJECT-SPRING-CI.yml로 바뀌어 항상 설치됩니다. 업데이트하면 손대지 않은 이전 파일은 삭제되고 수정한 파일은 .bak으로 옮겨집니다. 계속 배포하려면 .bak을 직접 관리하는 워크플로우로 옮기세요."
+      "title": "Spring nexus and GitHub Packages publish options removed",
+      "message": "PROJECT-SPRING-NEXUS-PUBLISH.yml and PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH.yml are no longer installed, and PROJECT-SPRING-NEXUS-CI.yml became PROJECT-SPRING-CI.yml, which is always installed. On update, untouched old files are deleted and modified ones are moved to .bak. To keep deploying, move the .bak into a workflow you maintain yourself.",
+      "title_ko": "Spring nexus·GitHub Packages publish 옵션 제거",
+      "message_ko": "PROJECT-SPRING-NEXUS-PUBLISH.yml·PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH.yml을 더 이상 설치하지 않고, PROJECT-SPRING-NEXUS-CI.yml은 PROJECT-SPRING-CI.yml로 바뀌어 항상 설치됩니다. 업데이트하면 손대지 않은 이전 파일은 삭제되고 수정한 파일은 .bak으로 옮겨집니다. 계속 배포하려면 .bak을 직접 관리하는 워크플로우로 옮기세요."
     },
     {
       "severity": "warning",
-      "title": "Secret 서버 백업 워크플로우(secret_backup 옵션) 제거",
-      "message": "PROJECT-COMMON-SECRET-FILE-UPLOAD.yaml을 더 이상 설치하지 않습니다. 설치해 두었다면 업데이트 때 손대지 않은 파일은 삭제되고 수정한 파일은 .bak으로 옮겨집니다. 계속 쓰려면 .bak을 직접 관리하는 워크플로우로 옮기세요."
+      "title": "Secret server backup workflow (secret_backup option) removed",
+      "message": "PROJECT-COMMON-SECRET-FILE-UPLOAD.yaml is no longer installed. If you had it, untouched files are deleted on update and modified ones are moved to .bak. To keep using it, move the .bak into a workflow you maintain yourself.",
+      "title_ko": "Secret 서버 백업 워크플로우(secret_backup 옵션) 제거",
+      "message_ko": "PROJECT-COMMON-SECRET-FILE-UPLOAD.yaml을 더 이상 설치하지 않습니다. 설치해 두었다면 업데이트 때 손대지 않은 파일은 삭제되고 수정한 파일은 .bak으로 옮겨집니다. 계속 쓰려면 .bak을 직접 관리하는 워크플로우로 옮기세요."
     }
   ]
 }

package/payload/config/wizard-prompts.yml

@@ -1,108 +1,164 @@
-# @wizard ask 마커의 사용자 질문 문구.
-# 형식 1 (구형, 지원 유지): KEY: "라벨"
-# 형식 2 (신규 블록): KEY 아래 label/help/example 들여쓰기 2칸
-# 형식 3 (타입 오버라이드): "{type}.KEY" 키로 타입별 문구 분리
-# 조회 우선순위: {type}.KEY -> KEY -> 구형 -> 폴백(KEY명)
-# 기본값/resolver는 여기 두지 않는다(@wizard 마커 소관).
+# User-facing question text for @wizard ask markers.
+# Format 1 (legacy, still supported): KEY: "label"
+# Format 2 (block): label/help/example indented by 2 spaces under KEY
+# Format 3 (type override): a "{type}.KEY" key holds type-specific text
+# Language: label/help/example are English (the default); add label_ko/help_ko/example_ko for Korean.
+#          A field with no language variant falls back to the plain field.
+# Lookup order: {type}.KEY -> KEY -> legacy -> fallback (KEY name)
+# Defaults/resolvers do not belong here (the @wizard marker owns them).
 
 PROJECT_NAME:
-  label: "서비스 식별자 (영문 슬러그)"
-  help: "Docker 컨테이너명·이미지명·배포 도메인 prefix에 그대로 사용됩니다. 소문자-하이픈 권장."
+  label: "Service identifier (English slug)"
+  label_ko: "서비스 식별자 (영문 슬러그)"
+  help: "Used as-is for the Docker container name, image name and deploy domain prefix. Lowercase with hyphens is recommended."
+  help_ko: "Docker 컨테이너명·이미지명·배포 도메인 prefix에 그대로 사용됩니다. 소문자-하이픈 권장."
   example: "my-service"
 
 flutter.APP_ARTIFACT_NAME:
-  label: "앱 산출물 이름 (영문)"
-  help: "빌드된 APK 파일명·아티팩트명·빌드 히스토리 파일명에 사용됩니다."
+  label: "App artifact name (English)"
+  label_ko: "앱 산출물 이름 (영문)"
+  help: "Used for the built APK file name, artifact name and build history file name."
+  help_ko: "빌드된 APK 파일명·아티팩트명·빌드 히스토리 파일명에 사용됩니다."
   example: "my-app"
 
 SERVICE_DOMAIN:
-  label: "서비스 도메인"
-  help: "배포 후 외부에서 접속할 운영 도메인입니다. 실제 보유한 도메인으로 바꿔야 합니다."
+  label: "Service domain"
+  label_ko: "서비스 도메인"
+  help: "The production domain the service is reached at after deploy. Replace it with a domain you actually own."
+  help_ko: "배포 후 외부에서 접속할 운영 도메인입니다. 실제 보유한 도메인으로 바꿔야 합니다."
   example: "api.example.com"
 
 JAVA_VERSION:
-  label: "빌드 JDK 버전"
-  help: "GitHub Actions 빌드 러너의 JDK 버전입니다. Spring은 보통 21, Flutter Android는 17."
+  label: "Build JDK version"
+  label_ko: "빌드 JDK 버전"
+  help: "JDK version of the GitHub Actions build runner. Usually 21 for Spring, 17 for Flutter Android."
+  help_ko: "GitHub Actions 빌드 러너의 JDK 버전입니다. Spring은 보통 21, Flutter Android는 17."
   example: "21"
 
 DEPLOY_PORT:
-  label: "외부 노출 포트"
-  help: "호스트(서버)에서 컨테이너로 연결할 포트입니다. 다른 서비스와 겹치지 않게 정하세요."
+  label: "Exposed port"
+  label_ko: "외부 노출 포트"
+  help: "The host (server) port that maps to the container. Pick one that does not clash with other services."
+  help_ko: "호스트(서버)에서 컨테이너로 연결할 포트입니다. 다른 서비스와 겹치지 않게 정하세요."
   example: "8080"
 
 ENABLE_VOLUME_MOUNT:
-  label: "볼륨 마운트 사용"
-  help: "켜면 아래 호스트/컨테이너 경로가 실제 배포에 반영되어 컨테이너에 볼륨이 마운트됩니다. 끄면(기본값) 경로를 입력해도 무시됩니다."
+  label: "Enable volume mount"
+  label_ko: "볼륨 마운트 사용"
+  help: "When on, the host/container paths below are applied to the real deploy and the volume is mounted. When off (default), the paths are ignored even if filled in."
+  help_ko: "켜면 아래 호스트/컨테이너 경로가 실제 배포에 반영되어 컨테이너에 볼륨이 마운트됩니다. 끄면(기본값) 경로를 입력해도 무시됩니다."
   example: "true"
 
 VOLUME_HOST_PATH:
-  label: "호스트(NAS) 볼륨 경로"
-  help: "서버에 데이터를 영구 저장할 실제 디렉토리 경로입니다."
+  label: "Host (NAS) volume path"
+  label_ko: "호스트(NAS) 볼륨 경로"
+  help: "The real directory on the server where data is stored permanently."
+  help_ko: "서버에 데이터를 영구 저장할 실제 디렉토리 경로입니다."
   example: "/volume1/projects/my-service"
 
 VOLUME_CONTAINER_PATH:
-  label: "컨테이너 내부 마운트 경로"
-  help: "컨테이너 안에서 위 볼륨이 보일 위치입니다."
+  label: "Container mount path"
+  label_ko: "컨테이너 내부 마운트 경로"
+  help: "Where the volume above appears inside the container."
+  help_ko: "컨테이너 안에서 위 볼륨이 보일 위치입니다."
   example: "/mnt/my-service"
 
 SSH_AUTH_METHOD:
-  label: "SSH 인증 방식"
-  help: "배포 서버 접속 방식입니다. 둘 중 하나를 그대로 입력하세요."
-  example: "password 또는 key"
+  label: "SSH authentication method"
+  label_ko: "SSH 인증 방식"
+  help: "How to connect to the deploy server. Enter one of the two values exactly."
+  help_ko: "배포 서버 접속 방식입니다. 둘 중 하나를 그대로 입력하세요."
+  example: "password or key"
+  example_ko: "password 또는 key"
 
 SSH_PORT:
-  label: "SSH 포트"
-  help: "배포 서버에서 SSH가 열려 있는 포트입니다 (일반 서버는 보통 22, NAS 등은 따로 정한 포트)."
+  label: "SSH port"
+  label_ko: "SSH 포트"
+  help: "The port SSH listens on at the deploy server (usually 22 for regular servers, a custom port for NAS and similar)."
+  help_ko: "배포 서버에서 SSH가 열려 있는 포트입니다 (일반 서버는 보통 22, NAS 등은 따로 정한 포트)."
   example: "22"
 
 BLUE_PORT:
-  label: "무중단 배포 Blue 포트"
-  help: "Blue/Green으로 번갈아 뜨는 컨테이너 중 Blue 쪽 호스트 포트입니다. 다른 서비스·Green 포트와 겹치지 않게 정하세요."
+  label: "Zero-downtime deploy Blue port"
+  label_ko: "무중단 배포 Blue 포트"
+  help: "Host port of the Blue side of the containers that alternate as Blue/Green. Must not clash with other services or the Green port."
+  help_ko: "Blue/Green으로 번갈아 뜨는 컨테이너 중 Blue 쪽 호스트 포트입니다. 다른 서비스·Green 포트와 겹치지 않게 정하세요."
   example: "8080"
 
 GREEN_PORT:
-  label: "무중단 배포 Green 포트"
-  help: "Blue/Green으로 번갈아 뜨는 컨테이너 중 Green 쪽 호스트 포트입니다. Blue 포트와 달라야 합니다."
+  label: "Zero-downtime deploy Green port"
+  label_ko: "무중단 배포 Green 포트"
+  help: "Host port of the Green side of the containers that alternate as Blue/Green. Must differ from the Blue port."
+  help_ko: "Blue/Green으로 번갈아 뜨는 컨테이너 중 Green 쪽 호스트 포트입니다. Blue 포트와 달라야 합니다."
   example: "8081"
 
 NGINX_RP_CONF:
-  label: "Nginx 리버스 프록시 설정 파일 경로"
-  help: "배포 때 proxy_pass 포트를 Blue/Green으로 바꿔 쓰는 서버의 Nginx 설정 파일입니다. 경로가 틀리면 무중단 전환이 동작하지 않습니다."
+  label: "Nginx reverse proxy config file path"
+  label_ko: "Nginx 리버스 프록시 설정 파일 경로"
+  help: "The server's Nginx config file whose proxy_pass port is switched between Blue/Green on deploy. A wrong path breaks the zero-downtime switch."
+  help_ko: "배포 때 proxy_pass 포트를 Blue/Green으로 바꿔 쓰는 서버의 Nginx 설정 파일입니다. 경로가 틀리면 무중단 전환이 동작하지 않습니다."
   example: "/etc/nginx/sites-enabled/my-service.conf"
 
 NGINX_BACKUP_DIR:
-  label: "Nginx 설정 백업 폴더"
-  help: "설정 파일을 바꾸기 전에 백업을 남길 서버의 폴더입니다."
+  label: "Nginx config backup folder"
+  label_ko: "Nginx 설정 백업 폴더"
+  help: "Server folder where a backup is kept before the config file is changed."
+  help_ko: "설정 파일을 바꾸기 전에 백업을 남길 서버의 폴더입니다."
   example: "/volume1/projects/nginx/backups"
 
 JAR_PATH:
-  label: "빌드 산출물(JAR) 경로"
-  help: "Gradle 빌드 후 PR 프리뷰 컨테이너에 넣을 JAR 파일 경로입니다 (프로젝트 루트 기준, 와일드카드 가능)."
+  label: "Build artifact (JAR) path"
+  label_ko: "빌드 산출물(JAR) 경로"
+  help: "Path of the JAR to put into the PR preview container after the Gradle build (relative to the project root, wildcards allowed)."
+  help_ko: "Gradle 빌드 후 PR 프리뷰 컨테이너에 넣을 JAR 파일 경로입니다 (프로젝트 루트 기준, 와일드카드 가능)."
   example: "build/libs/*.jar"
 
 PREVIEW_DOMAIN_SUFFIX:
-  label: "PR 프리뷰 도메인 접미사"
-  help: "PR마다 뜨는 프리뷰 서버 주소의 뒷부분입니다. 이 도메인의 와일드카드 DNS가 서버(Traefik)를 가리켜야 합니다."
+  label: "PR preview domain suffix"
+  label_ko: "PR 프리뷰 도메인 접미사"
+  help: "The trailing part of each PR preview server address. Wildcard DNS for this domain must point at the server (Traefik)."
+  help_ko: "PR마다 뜨는 프리뷰 서버 주소의 뒷부분입니다. 이 도메인의 와일드카드 DNS가 서버(Traefik)를 가리켜야 합니다."
   example: "pr.example.com"
 
 PROJECT_TARGET_DIR:
-  label: "PR 프리뷰 호스트 볼륨 경로"
-  help: "PR 프리뷰 컨테이너에 마운트할 서버의 데이터 디렉토리입니다. 비워 두면 마운트하지 않습니다."
+  label: "PR preview host volume path"
+  label_ko: "PR 프리뷰 호스트 볼륨 경로"
+  help: "Server data directory to mount into the PR preview container. Leave empty to skip mounting."
+  help_ko: "PR 프리뷰 컨테이너에 마운트할 서버의 데이터 디렉토리입니다. 비워 두면 마운트하지 않습니다."
   example: "/volume1/projects/my-service"
 
 PROJECT_MNT_DIR:
-  label: "PR 프리뷰 컨테이너 마운트 경로"
-  help: "위 호스트 볼륨이 PR 프리뷰 컨테이너 안에서 보일 위치입니다."
+  label: "PR preview container mount path"
+  label_ko: "PR 프리뷰 컨테이너 마운트 경로"
+  help: "Where the host volume above appears inside the PR preview container."
+  help_ko: "위 호스트 볼륨이 PR 프리뷰 컨테이너 안에서 보일 위치입니다."
   example: "/mnt/my-service"
 
 ISSUE_HELPER_CREATE_BRANCH:
-  label: "이슈 생성 시 브랜치 자동 생성"
-  help: "이슈가 열리면 base 브랜치 기준으로 브랜치를 자동으로 만듭니다. 원치 않으면 기본값(아니오)을 그대로 두세요."
+  label: "Auto-create a branch when an issue is opened"
+  label_ko: "이슈 생성 시 브랜치 자동 생성"
+  help: "When an issue is opened, a branch is created from the base branch automatically. Keep the default (no) if you do not want that."
+  help_ko: "이슈가 열리면 base 브랜치 기준으로 브랜치를 자동으로 만듭니다. 원치 않으면 기본값(아니오)을 그대로 두세요."
   example: "true"
 
 # workflow filename (partial match) -> human readable short name
-# wizard uses this to build "[usage]" in env questions.
+# the wizard uses this to build "[usage]" in env questions. `_workflow_names_ko` holds the Korean names.
 _workflow_names:
+  NONSTOP-NGINX: "Zero-downtime deploy (Nginx)"
+  NONSTOP-TRAEFIK: "Zero-downtime deploy (Traefik)"
+  PR-PREVIEW: "PR preview"
+  SIMPLE-CICD: "Single-server deploy"
+  REACT-CICD: "Frontend deploy"
+  REACT-CI: "Frontend build"
+  NEXT-CICD: "Frontend deploy"
+  NEXT-CI: "Frontend build"
+  PYTHON-CI: "Build check"
+  FLUTTER-ANDROID-SELFHOSTED: "Android self-hosted deploy"
+  FLUTTER-ANDROID-PLAYSTORE: "Play Store deploy"
+  FLUTTER-ANDROID-FIREBASE: "Firebase deploy"
+  ISSUE-HELPER: "Issue helper"
+
+_workflow_names_ko:
   NONSTOP-NGINX: "무중단배포(Nginx)"
   NONSTOP-TRAEFIK: "무중단배포(Traefik)"
   PR-PREVIEW: "PR 프리뷰"

package/payload/flutter-app/android/fastlane/Fastfile.playstore

@@ -1,42 +1,54 @@
 # ===================================================================
-# 이 파일은 사용자 소유입니다. 모드별 동작을 여기서 수정하세요.
+# This file is user-owned. Edit the per-mode behavior here.
 # ===================================================================
 #
-# Google Play 배포용 Fastfile 템플릿입니다.
-# PROJECT-FLUTTER-ANDROID-PLAYSTORE-CICD 워크플로우가 이 파일을 android/fastlane/Fastfile로
-# 복사한 뒤 `bundle exec fastlane deploy_internal`을 실행합니다.
-# project-auto-wizard는 이 파일이 이미 있으면 덮어쓰지 않으므로 자유롭게 수정해도 됩니다.
+# Fastfile template for Google Play deployment.
+# The PROJECT-FLUTTER-ANDROID-PLAYSTORE-CICD workflow copies this file to android/fastlane/Fastfile
+# and then runs `bundle exec fastlane deploy_internal`.
+# project-auto-wizard does not overwrite this file if it already exists, so feel free to edit it.
 #
-# 배포 모드 (워크플로우가 DEPLOY_MODE 환경변수로 전달)
-# ┌───────────────┬────────────┬──────────────────┬──────────────────────────────┐
-# │ DEPLOY_MODE   │ track      │ release_status   │ 동작                         │
-# ├───────────────┼────────────┼──────────────────┼──────────────────────────────┤
-# │ store_only    │ internal   │ completed        │ 내부 테스트 트랙에 업로드    │
-# │ store_prepare │ production │ draft            │ 프로덕션에 초안으로 업로드   │
-# │               │            │                  │ (Play Console에서 직접 출시) │
-# │ store_submit  │ production │ completed        │ 프로덕션 심사 제출까지 진행  │
-# └───────────────┴────────────┴──────────────────┴──────────────────────────────┘
-# 알 수 없는 값이나 빈 값은 store_only로 처리합니다.
+# Deploy modes (passed by the workflow via the DEPLOY_MODE environment variable)
+# +---------------+------------+----------------+-----------------------------------------+
+# | DEPLOY_MODE   | track      | release_status | Behavior                                |
+# +---------------+------------+----------------+-----------------------------------------+
+# | store_only    | internal   | completed      | Upload to the internal testing track    |
+# | store_prepare | production | draft          | Upload to production as a draft         |
+# |               |            |                | (release manually in Play Console)      |
+# | store_submit  | production | completed      | Go all the way to a production review   |
+# +---------------+------------+----------------+-----------------------------------------+
+# Unknown or empty values are treated as store_only.
 #
-# 워크플로우가 넘기는 환경변수
-#   PACKAGE_NAME          앱 패키지명 (ANDROID_PACKAGE_NAME secrets/variables)
-#   AAB_PATH              업로드할 .aab 절대경로
-#   GOOGLE_PLAY_JSON_KEY  서비스 계정 JSON 키 파일 경로
-#   VERSION_NAME          버전 이름 (Play Console의 릴리스 이름)
-#   VERSION_CODE          버전 코드 (변경 이력 파일명과 일치)
-#   DEPLOY_MODE           위 표의 배포 모드
+# Environment variables passed by the workflow
+#   PACKAGE_NAME          App package name (ANDROID_PACKAGE_NAME secrets/variables)
+#   AAB_PATH              Absolute path of the .aab to upload
+#   GOOGLE_PLAY_JSON_KEY  Path to the service account JSON key file
+#   VERSION_NAME          Version name (release name in Play Console)
+#   VERSION_CODE          Version code (matches the changelog file name)
+#   DEPLOY_MODE           Deploy mode from the table above
 #
-# 변경 이력은 워크플로우가 android/fastlane/metadata/android/ko-KR/changelogs/<VERSION_CODE>.txt
-# 로 만들어 두며, upload_to_play_store가 metadata_path 아래에서 버전 코드로 찾아 업로드합니다.
+# The workflow writes the changelog to android/fastlane/metadata/android/ko-KR/changelogs/<VERSION_CODE>.txt,
+# and upload_to_play_store finds it by version code under metadata_path.
+
+# Look up a user-facing message in the installed catalog so it follows `language` in version.yml.
+# Finds the repo root by walking up to .github/scripts/messages.py (it reads ./version.yml from there);
+# falls back to the key when the catalog is unavailable (for example when fastlane runs on a laptop).
+def paw_msg(key, **params)
+  root = Dir.pwd
+  root = File.dirname(root) until File.exist?(File.join(root, ".github", "scripts", "messages.py")) || root == File.dirname(root)
+  out = IO.popen(["python3", File.join(root, ".github", "scripts", "messages.py"), "get", key, *params.map { |k, v| "#{k}=#{v}" }], chdir: root, err: File::NULL, &:read)
+  $?.success? && !out.to_s.strip.empty? ? out.chomp : key
+rescue StandardError
+  key
+end
 
 default_platform(:android)
 
 platform :android do
-  desc "AAB를 Google Play에 업로드합니다 (DEPLOY_MODE: store_only | store_prepare | store_submit)"
+  desc "Uploads the AAB to Google Play (DEPLOY_MODE: store_only | store_prepare | store_submit)"
   lane :deploy_internal do
     package_name = ENV["PACKAGE_NAME"].to_s.strip
     if package_name.empty?
-      UI.user_error!("PACKAGE_NAME이 비어 있습니다. ANDROID_PACKAGE_NAME secrets/variables를 등록하세요. (예: com.example.app)")
+      UI.user_error!(paw_msg("fastlane.package_name_empty"))
     end
 
     aab_path = ENV["AAB_PATH"].to_s.strip
@@ -44,7 +56,7 @@ platform :android do
     version_name = ENV["VERSION_NAME"].to_s.strip
     version_code = ENV["VERSION_CODE"].to_s.strip
     if aab_path.empty? || json_key.empty? || version_name.empty? || version_code.empty?
-      UI.user_error!("AAB_PATH, GOOGLE_PLAY_JSON_KEY, VERSION_NAME, VERSION_CODE 환경변수가 모두 필요합니다. 워크플로우에서 전달하는지 확인하세요.")
+      UI.user_error!(paw_msg("fastlane.android_env_required"))
     end
 
     deploy_mode = ENV["DEPLOY_MODE"].to_s.strip
@@ -57,17 +69,17 @@ platform :android do
       when "store_only"
         ["internal", "completed"]
       else
-        UI.important("알 수 없는 DEPLOY_MODE '#{deploy_mode}' 입니다. store_only로 처리합니다.") unless deploy_mode.empty?
+        UI.important(paw_msg("fastlane.deploy_mode_unknown", deploy_mode: deploy_mode)) unless deploy_mode.empty?
         ["internal", "completed"]
       end
 
-    # lane은 Fastfile이 있는 android/fastlane 디렉토리에서 실행되므로,
-    # 워크플로우가 변경 이력을 만드는 android/fastlane/metadata/android와 같은 경로를 가리킵니다.
+    # The lane runs from the android/fastlane directory that holds this Fastfile, so this points to
+    # the same android/fastlane/metadata/android path where the workflow writes the changelog.
     metadata_path = File.expand_path("metadata/android")
     changelog_file = File.join(metadata_path, "ko-KR", "changelogs", "#{version_code}.txt")
-    UI.important("변경 이력 파일이 없습니다: #{changelog_file}") unless File.exist?(changelog_file)
+    UI.important(paw_msg("fastlane.changelog_missing", file: changelog_file)) unless File.exist?(changelog_file)
 
-    UI.message("Play 배포: DEPLOY_MODE=#{deploy_mode.inspect} → track=#{track}, release_status=#{release_status}")
+    UI.message(paw_msg("fastlane.play_deploy", deploy_mode: deploy_mode.inspect, track: track, release_status: release_status))
 
     upload_to_play_store(
       package_name: package_name,

package/payload/flutter-app/ios/ExportOptions.plist

@@ -1,16 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <!--
-  이 파일은 사용자 소유입니다. 밑줄 두 개로 감싼 자리표시자 3곳을 실제 값으로 바꾼 뒤 커밋하세요.
+  This file is user-owned. Replace the 3 placeholders wrapped in double underscores with real values, then commit.
 
-  PROJECT-FLUTTER-IOS-TESTFLIGHT / PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT 워크플로우가
-  xcodebuild -exportArchive -exportOptionsPlist ExportOptions.plist 로 IPA를 만들 때 사용합니다.
-  자리표시자가 남아 있으면 워크플로우가 중단됩니다.
-  (이 주석에는 자리표시자를 적지 않았습니다. 값을 채운 뒤에도 남아 있는지 검사하기 때문입니다.)
+  The PROJECT-FLUTTER-IOS-TESTFLIGHT / PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT workflows use it when building the IPA with
+  xcodebuild -exportArchive -exportOptionsPlist ExportOptions.plist.
+  The workflow aborts if any placeholder is left.
+  (This comment does not spell out the placeholders, because the workflow checks that none remain after you fill in the values.)
 
-    teamID                 Apple Developer Team ID (10자리, developer.apple.com 계정의 Membership)
-    provisioningProfiles   키는 앱 번들 ID (예: com.example.app),
-                           값은 프로비저닝 프로파일 이름 (GitHub Secret IOS_PROVISIONING_PROFILE_NAME 값과 같게)
+    teamID                 Apple Developer Team ID (10 characters, Membership in your developer.apple.com account)
+    provisioningProfiles   Key is the app bundle ID (e.g. com.example.app),
+                           value is the provisioning profile name (same as the GitHub Secret IOS_PROVISIONING_PROFILE_NAME)
 -->
 <plist version="1.0">
 <dict>