project-auto-wizard 0.14.0 → 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.14.0 (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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.14.0",
+  "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",

package/payload/scripts/changelog_manager.py

@@ -508,13 +508,13 @@ def _ai_assisted_minor_upgrade(unclassified_lines: list[str]) -> bool:
         try:
             return call_openai_compatible(base_url, api_key, model, prompt).strip() == 'MINOR'
         except Exception as e:
-            _warn_engine_failure(f"[warn] bump AI assist failed: {e}")
+            _warn_engine_failure("[warn] " + t("changelog.engine_bump_failed", error=e))
 
     if _copilot_enabled():
         try:
             return call_copilot_cli(prompt).strip() == 'MINOR'
         except Exception as e:
-            _warn_engine_failure(f"[warn] bump AI assist (copilot) failed: {e}")
+            _warn_engine_failure("[warn] " + t("changelog.engine_bump_copilot_failed", error=e))
     return False
 
 
@@ -866,7 +866,7 @@ def call_copilot_cli(prompt: str) -> str:
             capture_output=True, text=True, timeout=_COPILOT_TIMEOUT_SECONDS,
         )
     if result.returncode != 0:
-        raise RuntimeError(f"copilot exited with {result.returncode}: {result.stderr.strip()[:200]}")
+        raise RuntimeError(t("changelog.engine_copilot_exit", code=result.returncode, detail=result.stderr.strip()[:200]))
     return result.stdout
 
 
@@ -961,9 +961,9 @@ def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title:
                 summary_text = candidate
                 engine = "user-api"
             else:
-                failures.append(_warn_engine_failure("[warn] user-api failed: empty content in response"))
+                failures.append(_warn_engine_failure("[warn] " + t("changelog.engine_user_api_empty")))
         except Exception as e:
-            failures.append(_warn_engine_failure(f"[warn] user-api failed: {e}"))
+            failures.append(_warn_engine_failure("[warn] " + t("changelog.engine_user_api_failed", error=e)))
 
     if summary_text is None and _copilot_enabled():
         try:
@@ -972,9 +972,9 @@ def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title:
                 summary_text = candidate
                 engine = "copilot"
             else:
-                failures.append(_warn_engine_failure("[warn] copilot failed: empty or not in the requested Markdown format"))
+                failures.append(_warn_engine_failure("[warn] " + t("changelog.engine_copilot_invalid")))
         except Exception as e:
-            failures.append(_warn_engine_failure(f"[warn] copilot failed: {e}"))
+            failures.append(_warn_engine_failure("[warn] " + t("changelog.engine_copilot_failed", error=e)))
 
     if summary_text is None:
         classified = classify_commits(commit_lines)
@@ -990,7 +990,7 @@ def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title:
         # rescue-print the summary text to stderr. Keep exit code 0
         # (contract so the workflow pipeline is not cut).
         write_ok = False
-        print(f"[warn] output write failed: {e}", file=sys.stderr)
+        print("[warn] " + t("changelog.output_write_failed", error=e), file=sys.stderr)
         print(summary_text, file=sys.stderr)
 
     result = {"ok": write_ok, "engine": engine, "output": output_path}

package/payload/scripts/messages.py

@@ -1212,6 +1212,159 @@ EN = {
     "wf_version.release_publish_triggered": "RELEASE-PUBLISH workflow_dispatch trigger requested (works without WORKFLOW_PAT, recovers version drift automatically)",
     "wf_version.backmerge_conflict": "Could not automatically merge {prod} into {dev} (conflict). Merge it manually before the next release PR: {manual}",
     "wf_version.backmerge_push_failed": "Could not push to {dev} (branch protection, etc.). Merge it manually before the next release PR: {manual}",
+    # --- version_manager ---
+    "version_manager.err_yml_missing": "ERROR: version.yml not found",
+    "version_manager.warn_code_missing": "WARNING: version_code field missing, adding default value 1",
+    "version_manager.warn_code_regress": "WARNING: version_code {new_code} is lower than current {current} — writing anyway (regression?)",
+    "version_manager.warn_version_missing": "WARNING: version field missing in version.yml, adding it",
+    "version_manager.warn_spring_no_version": "WARNING: spring: {pom} has no project <version> (inherited from parent?) — skipping",
+    "version_manager.warn_spring_property": "WARNING: spring: {pom} <version> is a property ({version}) — skipping",
+    "version_manager.updated": "updated: {path}",
+    "version_manager.warn_spring_no_files": "WARNING: spring: no build.gradle(.kts) or pom.xml found under {dir} — skipping",
+    "version_manager.warn_spring_no_gradle_line": "WARNING: spring: no `version = '...'` line in {file} — skipping",
+    "version_manager.pubspec_ahead": "pubspec.yaml build number {build} is ahead of version_code {code} — adopting it",
+    "version_manager.warn_flutter_missing": "WARNING: flutter: {target} not found — skipping",
+    "version_manager.warn_target_missing": "WARNING: {target} not found — skipping",
+    "version_manager.warn_python_no_version": "WARNING: python: no version in pyproject.toml [project]/[tool.poetry] or setup.py under {dir} — skipping",
+    "version_manager.skipped_plist": "skipped: {file} — CFBundleShortVersionString references a build variable",
+    "version_manager.warn_rn_ios_missing": "WARNING: react-native: {dir} not found — skipping",
+    "version_manager.warn_rn_gradle_missing": "WARNING: react-native: {file} not found — skipping",
+    "version_manager.warn_rn_no_targets": "WARNING: react-native: no target files found under {dir}",
+    "version_manager.warn_unknown_type": "WARNING: unknown project type: {type} — skipping",
+    "version_manager.err_type": "ERROR: {type}: {error}",
+    "version_manager.readme_updated": "README.md version line -> v{version}",
+    "version_manager.warn_read_failed": "WARNING: failed reading project file for {type}: {error}",
+    "version_manager.sync_check": "Version sync check",
+    "version_manager.sync_yml_version": "  version.yml: {version}",
+    "version_manager.sync_project_version": "  project file: {version}",
+    "version_manager.sync_mismatch": "Version mismatch detected, syncing to higher version: {version}",
+    "version_manager.warn_format_invalid": "WARNING: version format invalid, cannot sync",
+    "version_manager.sync_multi": "Multi-type — reconciling all type files to version.yml version: {version}",
+    "version_manager.sync_ok": "Version already in sync: {version}",
+    "version_manager.err_invalid_version": "ERROR: invalid version format: {version}",
+    "version_manager.err_invalid_version_xyz": "ERROR: invalid version format: {version} (must be x.y.z)",
+    "version_manager.err_generic": "ERROR: {error}",
+    "version_manager.err_no_types_sync": "ERROR: version.yml has no readable project_types — cannot sync project files",
+    "version_manager.err_no_types_check": "ERROR: version.yml has no readable project_types — cannot sync versions",
+    "version_manager.err_write_failed": "failed to write version {version} to version.yml",
+    "version_manager.err_not_json": "{target} is not valid JSON ({error}) — cannot write version",
+    "version_manager.err_sync_failed": "project file sync failed for: {types}",
+    # --- changelog_engine ---
+    "changelog.engine_bump_failed": "bump AI assist failed: {error}",
+    "changelog.engine_bump_copilot_failed": "bump AI assist (copilot) failed: {error}",
+    "changelog.engine_user_api_empty": "user-api failed: empty content in response",
+    "changelog.engine_user_api_failed": "user-api failed: {error}",
+    "changelog.engine_copilot_invalid": "copilot failed: empty or not in the requested Markdown format",
+    "changelog.engine_copilot_failed": "copilot failed: {error}",
+    "changelog.engine_copilot_exit": "copilot exited with {code}: {detail}",
+    "changelog.output_write_failed": "output write failed: {error}",
+    # --- wf_common ---
+    "wf_common.copilot_ai_option": "copilot_ai option: {copilot_ai}",
+    "wf_common.semver_auto_option": "semver_auto option: {semver_auto}",
+    "wf_common.bump_level": "bump level: {bump}",
+    "wf_common.version_bump_failed": "version bump failed",
+    "wf_common.no_changes": "no changes to commit",
+    "wf_common.push_attempt": "push attempt {retry_count}/{max_retries}...",
+    "wf_common.push_failed_syncing": "push failed, syncing with remote...",
+    "wf_common.rebase_ok": "rebase ok, retrying push...",
+    "wf_common.rebase_failed": "rebase failed, manual conflict resolution required",
+    "wf_common.push_gave_up": "push failed after {max_retries} attempts",
+    # --- wf_aisum ---
+    "wf_aisum.expected_version": "expected next version: {version} (current: {current_version}, mode: {mode}, bump: {bump})",
+    "wf_aisum.comment_update_failed": "comment update failed — continuing (this workflow never blocks the PR)",
+    "wf_aisum.comment_post_failed": "comment post failed — continuing (this workflow never blocks the PR)",
+    # --- wf_changelog ---
+    "wf_changelog.pr_not_open": "PR #{pr_number} is already {state} — skipping the release pipeline",
+    "wf_changelog.pr_state": "PR #{pr_number} state: {state}",
+    "wf_changelog.commits_to_summarize": "commits to summarize: {n}",
+    "wf_changelog.version_raised": "confirmed version raised: {head_version} -> {new_version} ({bump} from {main_branch} {main_version})",
+    "wf_changelog.version_reuse_unreleased": "version already confirmed and not yet released — reusing {new_version} ({main_branch} is {main_version})",
+    "wf_changelog.version_reuse_previous": "version already confirmed by a previous run — reusing {new_version} (no re-increment)",
+    "wf_changelog.version_confirmed": "release version confirmed: {new_version} ({bump})",
+    "wf_changelog.summary_engine": "summary engine: {engine_line}",
+    "wf_changelog.comment_updated": "summary comment updated (#{comment_id})",
+    "wf_changelog.comment_update_failed": "comment update failed — continuing (this workflow never blocks the release)",
+    "wf_changelog.comment_posted": "summary comment posted",
+    "wf_changelog.comment_post_failed": "comment post failed — continuing (this workflow never blocks the release)",
+    "wf_changelog.pr_closed_skip_docs": "PR is already {pr_state} — not pushing release docs",
+    "wf_changelog.docs_pushed": "release docs pushed to {head_branch}",
+    "wf_changelog.pr_already_merged": "PR #{pr_number} is already merged",
+    "wf_changelog.automerge_enabled": "automerge enabled: {subject}",
+    "wf_changelog.automerge_unavailable": "automerge unavailable — merged directly: {subject}",
+    "wf_changelog.merge_retry": "merge attempt {attempt}/{max_attempts} failed — retrying in {wait}s",
+    "wf_changelog.merge_gave_up": "PR merge failed after {max_attempts} attempts (allow_merge_commit={allow_merge_commit}) — check branch protection rules, required checks, and token permissions",
+    # --- wf_readme ---
+    "wf_readme.not_found": "README.md not found — nothing to update, skipping",
+    "wf_readme.read_version_failed": "failed to read the current version",
+    "wf_readme.update_failed": "README.md version update failed",
+    "wf_readme.err_type": "  error type: {error_type}",
+    "wf_readme.err_current_line": "  current version line: {version_line}",
+    "wf_readme.err_header": "  extracted header: {header_part}",
+    "wf_readme.err_new_text": "  new version text: {version_text}",
+    "wf_readme.hint_formats": "Make sure the README version line matches one of:",
+    "wf_readme.hint_notes": "Notes:",
+    "wf_readme.hint_no_bold": "  - no markdown bold (**) characters",
+    "wf_readme.hint_no_regex": "  - no regex special characters (*, [, ], ^, $)",
+    "wf_readme.hint_after_colon": "  - the version must come right after the colon (:)",
+    "wf_readme.text_with_date": "version text with date: {version_text}",
+    "wf_readme.text": "version text: {version_text}",
+    "wf_readme.line_found": "version line found: {version_line}",
+    "wf_readme.line_inserting": "no version line found — inserting a new one",
+    "wf_readme.line_inserted": "default version line inserted: {version_text}",
+    "wf_readme.warn_bold": "warning: the version line contains markdown bold (**) characters",
+    "wf_readme.warn_current_line": "  current line: {version_line}",
+    "wf_readme.warn_may_break": "  this may break the version update",
+    "wf_readme.marker_added": "auto-update marker comment added",
+    "wf_readme.updated_line_detail": "  updated line: {updated_line}",
+    "wf_readme.line_updated": "version line updated: {version_text}",
+    "wf_readme.no_changes": "no changes in README.md",
+    "wf_readme.pushed": "README.md version update pushed",
+    "wf_readme.err_no_colon": "header extraction failed - no colon (:) found",
+    "wf_readme.err_sed": "sed command failed - {error}",
+    "wf_readme.err_sed_unknown": "unknown sed error",
+    "wf_readme.err_verify": "version replacement verification failed",
+    # --- wf_release ---
+    "wf_release.branch_mode": "branch mode: {mode}",
+    "wf_release.gate_open": "release gate open (mode={mode}, event={event})",
+    "wf_release.gate_closed": "not a release-confirm push in pr-flow mode — skipping",
+    "wf_release.drift_skipped": "drift guard skipped (no version.yml version or no tag yet)",
+    "wf_release.drift_error": "version.yml({file_version}) is ahead of the newest tag({latest_tag}) but no release was published — this version will never reach npm. Recover with: Actions → PROJECT-RELEASE-PUBLISH → Run workflow (workflow_dispatch bypasses this gate).",
+    "wf_release.drift_ok": "drift guard ok (version.yml={file_version}, latest tag={latest_tag})",
+    "wf_release.head_is_docs_commit": "HEAD is already this workflow's release docs commit — skipping re-increment (idempotent re-run)",
+    "wf_release.collect_since": "collecting commits since {last_tag}",
+    "wf_release.collect_all": "no previous tag — collecting the full history",
+    "wf_release.release_version": "release version: {new_version} ({bump})",
+    "wf_release.docs_pushed": "release docs pushed",
+    "wf_release.read_version_failed": "failed to read version",
+    "wf_release.tag_exists": "tag v{version} already exists — skipping tag push",
+    "wf_release.release_exists": "release v{version} already exists — nothing to publish",
+    "wf_release.publishing": "publishing release v{version}",
+    "wf_release.tag_pushed": "tag v{version} pushed",
+    "wf_release.notes_assembled": "release notes assembled ({n} bytes)",
+    "wf_release.published": "GitHub Release v{version} published",
+    # --- wf_version ---
+    "wf_version.trunk_skip": "trunk-based mode detected — RELEASE-PUBLISH owns version bumping, skipping",
+    "wf_version.confirm_skip": "release-confirm commit detected (chore(release):) — skipping safety-net bump",
+    "wf_version.release_merge_skip": "release merge detected (push contains a version.yml change) — skipping safety-net bump",
+    "wf_version.direct_push": "direct push to {main_branch} detected — running safety-net version bump",
+    "wf_version.read_current_failed": "failed to read current version",
+    "wf_version.current_version": "current version: {current_version}",
+    "wf_version.new_version": "new version: {new_version}",
+    "wf_version.project_types": "project types: {project_types}",
+    "wf_version.yml_not_found": "version.yml not found",
+    "wf_version.commits_since": "commits since {last_tag}: {n}",
+    "wf_version.no_changes_synced": "no changes to commit (already in sync)",
+    "wf_version.bump_pushed": "version bump commit pushed",
+    "wf_version.commit_failed": "commit failed",
+    "wf_version.no_develop": "branch {develop_branch} not found — nothing to back-merge",
+    "wf_version.already_contains": "{develop_branch} already contains {main_branch}",
+    "wf_version.backmerged": "safety-net bump v{new_version} merged into {develop_branch}",
+    "wf_version.push_retry": "push attempt {attempt} failed — retrying",
+    "wf_version.finished": "version-control workflow finished",
+    "wf_version.sum_skipped": "  skipped (release merge / trunk-based): {skip}",
+    "wf_version.sum_previous": "  previous version: {current_version}",
+    "wf_version.sum_new": "  new version: {new_version}",
+    "wf_version.sum_branch": "  branch: {ref_name}",
 }
 
 KO = {
@@ -2270,6 +2423,159 @@ KO = {
     "wf_version.release_publish_triggered": "RELEASE-PUBLISH workflow_dispatch 트리거 요청 완료 (WORKFLOW_PAT 없이도 동작, 이슈 #61 드리프트 자동 복구)",
     "wf_version.backmerge_conflict": "{prod}을 {dev}에 자동 병합하지 못했습니다 (충돌). 다음 릴리스 PR 전에 직접 병합하세요: {manual}",
     "wf_version.backmerge_push_failed": "{dev}에 push하지 못했습니다 (브랜치 보호 등). 다음 릴리스 PR 전에 직접 병합하세요: {manual}",
+    # --- version_manager ---
+    "version_manager.err_yml_missing": "오류: version.yml을 찾을 수 없습니다",
+    "version_manager.warn_code_missing": "경고: version_code 필드가 없어 기본값 1을 추가합니다",
+    "version_manager.warn_code_regress": "경고: version_code {new_code}이(가) 현재 값 {current}보다 낮습니다 — 그대로 기록합니다 (역행 여부 확인 필요)",
+    "version_manager.warn_version_missing": "경고: version.yml에 version 필드가 없어 추가합니다",
+    "version_manager.warn_spring_no_version": "경고: spring: {pom}에 프로젝트 <version>이 없습니다 (부모에서 상속?) — 건너뜁니다",
+    "version_manager.warn_spring_property": "경고: spring: {pom}의 <version>이 속성값({version})입니다 — 건너뜁니다",
+    "version_manager.updated": "수정됨: {path}",
+    "version_manager.warn_spring_no_files": "경고: spring: {dir} 아래에서 build.gradle(.kts)나 pom.xml을 찾지 못했습니다 — 건너뜁니다",
+    "version_manager.warn_spring_no_gradle_line": "경고: spring: {file}에 `version = '...'` 줄이 없습니다 — 건너뜁니다",
+    "version_manager.pubspec_ahead": "pubspec.yaml 빌드 번호 {build}이(가) version_code {code}보다 앞서 있어 그 값을 사용합니다",
+    "version_manager.warn_flutter_missing": "경고: flutter: {target}을(를) 찾을 수 없습니다 — 건너뜁니다",
+    "version_manager.warn_target_missing": "경고: {target}을(를) 찾을 수 없습니다 — 건너뜁니다",
+    "version_manager.warn_python_no_version": "경고: python: {dir} 아래의 pyproject.toml [project]/[tool.poetry]나 setup.py에 버전이 없습니다 — 건너뜁니다",
+    "version_manager.skipped_plist": "건너뜀: {file} — CFBundleShortVersionString이 빌드 변수를 참조합니다",
+    "version_manager.warn_rn_ios_missing": "경고: react-native: {dir}을(를) 찾을 수 없습니다 — 건너뜁니다",
+    "version_manager.warn_rn_gradle_missing": "경고: react-native: {file}을(를) 찾을 수 없습니다 — 건너뜁니다",
+    "version_manager.warn_rn_no_targets": "경고: react-native: {dir} 아래에서 대상 파일을 찾지 못했습니다",
+    "version_manager.warn_unknown_type": "경고: 알 수 없는 프로젝트 타입: {type} — 건너뜁니다",
+    "version_manager.err_type": "오류: {type}: {error}",
+    "version_manager.readme_updated": "README.md 버전 줄 -> v{version}",
+    "version_manager.warn_read_failed": "경고: {type} 프로젝트 파일을 읽지 못했습니다: {error}",
+    "version_manager.sync_check": "버전 동기화 확인",
+    "version_manager.sync_yml_version": "  version.yml: {version}",
+    "version_manager.sync_project_version": "  프로젝트 파일: {version}",
+    "version_manager.sync_mismatch": "버전 불일치를 감지해 더 높은 버전으로 맞춥니다: {version}",
+    "version_manager.warn_format_invalid": "경고: 버전 형식이 올바르지 않아 동기화할 수 없습니다",
+    "version_manager.sync_multi": "멀티 타입 — 모든 타입 파일을 version.yml 버전({version})으로 맞춥니다",
+    "version_manager.sync_ok": "이미 버전이 일치합니다: {version}",
+    "version_manager.err_invalid_version": "오류: 올바르지 않은 버전 형식: {version}",
+    "version_manager.err_invalid_version_xyz": "오류: 올바르지 않은 버전 형식: {version} (x.y.z 형식이어야 합니다)",
+    "version_manager.err_generic": "오류: {error}",
+    "version_manager.err_no_types_sync": "오류: version.yml에서 project_types를 읽을 수 없어 프로젝트 파일을 동기화할 수 없습니다",
+    "version_manager.err_no_types_check": "오류: version.yml에서 project_types를 읽을 수 없어 버전을 동기화할 수 없습니다",
+    "version_manager.err_write_failed": "version.yml에 버전 {version}을(를) 기록하지 못했습니다",
+    "version_manager.err_not_json": "{target}이(가) 올바른 JSON이 아닙니다 ({error}) — 버전을 기록할 수 없습니다",
+    "version_manager.err_sync_failed": "프로젝트 파일 동기화 실패: {types}",
+    # --- changelog_engine ---
+    "changelog.engine_bump_failed": "bump AI 보조 실패: {error}",
+    "changelog.engine_bump_copilot_failed": "bump AI 보조(copilot) 실패: {error}",
+    "changelog.engine_user_api_empty": "user-api 실패: 응답에 내용이 없습니다",
+    "changelog.engine_user_api_failed": "user-api 실패: {error}",
+    "changelog.engine_copilot_invalid": "copilot 실패: 응답이 비었거나 요청한 Markdown 형식이 아닙니다",
+    "changelog.engine_copilot_failed": "copilot 실패: {error}",
+    "changelog.engine_copilot_exit": "copilot이 종료 코드 {code}로 끝났습니다: {detail}",
+    "changelog.output_write_failed": "출력 파일 쓰기 실패: {error}",
+    # --- wf_common ---
+    "wf_common.copilot_ai_option": "copilot_ai 옵션: {copilot_ai}",
+    "wf_common.semver_auto_option": "semver_auto 옵션: {semver_auto}",
+    "wf_common.bump_level": "승격 폭: {bump}",
+    "wf_common.version_bump_failed": "버전 승격에 실패했습니다",
+    "wf_common.no_changes": "커밋할 변경 사항이 없습니다",
+    "wf_common.push_attempt": "push 시도 {retry_count}/{max_retries}...",
+    "wf_common.push_failed_syncing": "push 실패, 원격과 동기화합니다...",
+    "wf_common.rebase_ok": "rebase 성공, push를 다시 시도합니다...",
+    "wf_common.rebase_failed": "rebase 실패, 충돌을 직접 해결해야 합니다",
+    "wf_common.push_gave_up": "push가 {max_retries}회 시도 후에도 실패했습니다",
+    # --- wf_aisum ---
+    "wf_aisum.expected_version": "예상 다음 버전: {version} (현재: {current_version}, 모드: {mode}, 승격: {bump})",
+    "wf_aisum.comment_update_failed": "댓글 수정 실패 — 계속 진행합니다 (이 워크플로우는 PR을 막지 않습니다)",
+    "wf_aisum.comment_post_failed": "댓글 등록 실패 — 계속 진행합니다 (이 워크플로우는 PR을 막지 않습니다)",
+    # --- wf_changelog ---
+    "wf_changelog.pr_not_open": "PR #{pr_number}은(는) 이미 {state} 상태입니다 — 릴리스 파이프라인을 건너뜁니다",
+    "wf_changelog.pr_state": "PR #{pr_number} 상태: {state}",
+    "wf_changelog.commits_to_summarize": "요약할 커밋 수: {n}",
+    "wf_changelog.version_raised": "확정 버전을 올렸습니다: {head_version} -> {new_version} ({main_branch} {main_version} 기준 {bump})",
+    "wf_changelog.version_reuse_unreleased": "이미 확정됐고 아직 릴리스되지 않은 버전이라 {new_version}을(를) 재사용합니다 ({main_branch}는 {main_version})",
+    "wf_changelog.version_reuse_previous": "이전 실행에서 이미 확정된 버전이라 {new_version}을(를) 재사용합니다 (다시 올리지 않음)",
+    "wf_changelog.version_confirmed": "릴리스 버전 확정: {new_version} ({bump})",
+    "wf_changelog.summary_engine": "요약 엔진: {engine_line}",
+    "wf_changelog.comment_updated": "요약 댓글을 수정했습니다 (#{comment_id})",
+    "wf_changelog.comment_update_failed": "댓글 수정 실패 — 계속 진행합니다 (이 워크플로우는 릴리스를 막지 않습니다)",
+    "wf_changelog.comment_posted": "요약 댓글을 등록했습니다",
+    "wf_changelog.comment_post_failed": "댓글 등록 실패 — 계속 진행합니다 (이 워크플로우는 릴리스를 막지 않습니다)",
+    "wf_changelog.pr_closed_skip_docs": "PR이 이미 {pr_state} 상태입니다 — 릴리스 문서를 push하지 않습니다",
+    "wf_changelog.docs_pushed": "릴리스 문서를 {head_branch}에 push했습니다",
+    "wf_changelog.pr_already_merged": "PR #{pr_number}은(는) 이미 병합되었습니다",
+    "wf_changelog.automerge_enabled": "automerge 활성화: {subject}",
+    "wf_changelog.automerge_unavailable": "automerge를 쓸 수 없어 직접 병합했습니다: {subject}",
+    "wf_changelog.merge_retry": "병합 시도 {attempt}/{max_attempts} 실패 — {wait}초 후 다시 시도합니다",
+    "wf_changelog.merge_gave_up": "PR 병합이 {max_attempts}회 시도 후에도 실패했습니다 (allow_merge_commit={allow_merge_commit}) — 브랜치 보호 규칙, 필수 체크, 토큰 권한을 확인하세요",
+    # --- wf_readme ---
+    "wf_readme.not_found": "README.md가 없습니다 — 수정할 것이 없어 건너뜁니다",
+    "wf_readme.read_version_failed": "현재 버전을 읽지 못했습니다",
+    "wf_readme.update_failed": "README.md 버전 수정에 실패했습니다",
+    "wf_readme.err_type": "  오류 유형: {error_type}",
+    "wf_readme.err_current_line": "  현재 버전 줄: {version_line}",
+    "wf_readme.err_header": "  추출한 머리말: {header_part}",
+    "wf_readme.err_new_text": "  새 버전 문구: {version_text}",
+    "wf_readme.hint_formats": "README 버전 줄이 다음 중 하나와 같은 형식인지 확인하세요:",
+    "wf_readme.hint_notes": "참고:",
+    "wf_readme.hint_no_bold": "  - 마크다운 굵게(**) 문자를 쓰지 마세요",
+    "wf_readme.hint_no_regex": "  - 정규식 특수문자(*, [, ], ^, $)를 쓰지 마세요",
+    "wf_readme.hint_after_colon": "  - 버전은 콜론(:) 바로 뒤에 와야 합니다",
+    "wf_readme.text_with_date": "날짜 포함 버전 문구: {version_text}",
+    "wf_readme.text": "버전 문구: {version_text}",
+    "wf_readme.line_found": "버전 줄 발견: {version_line}",
+    "wf_readme.line_inserting": "버전 줄이 없어 새로 추가합니다",
+    "wf_readme.line_inserted": "기본 버전 줄을 추가했습니다: {version_text}",
+    "wf_readme.warn_bold": "경고: 버전 줄에 마크다운 굵게(**) 문자가 들어 있습니다",
+    "wf_readme.warn_current_line": "  현재 줄: {version_line}",
+    "wf_readme.warn_may_break": "  버전 수정이 깨질 수 있습니다",
+    "wf_readme.marker_added": "자동 갱신 표시 주석을 추가했습니다",
+    "wf_readme.updated_line_detail": "  수정된 줄: {updated_line}",
+    "wf_readme.line_updated": "버전 줄을 수정했습니다: {version_text}",
+    "wf_readme.no_changes": "README.md에 변경 사항이 없습니다",
+    "wf_readme.pushed": "README.md 버전 수정을 push했습니다",
+    "wf_readme.err_no_colon": "머리말 추출 실패 - 콜론(:)을 찾을 수 없습니다",
+    "wf_readme.err_sed": "sed 명령 실패 - {error}",
+    "wf_readme.err_sed_unknown": "알 수 없는 sed 오류",
+    "wf_readme.err_verify": "버전 교체 검증에 실패했습니다",
+    # --- wf_release ---
+    "wf_release.branch_mode": "브랜치 모드: {mode}",
+    "wf_release.gate_open": "릴리스 게이트 열림 (mode={mode}, event={event})",
+    "wf_release.gate_closed": "pr-flow 모드에서 릴리스 확정 push가 아니므로 건너뜁니다",
+    "wf_release.drift_skipped": "드리프트 검사 건너뜀 (version.yml 버전이 없거나 아직 태그가 없음)",
+    "wf_release.drift_error": "version.yml({file_version})이(가) 최신 태그({latest_tag})보다 앞서 있지만 릴리스가 발행되지 않았습니다 — 이 버전은 npm에 배포되지 않습니다. 복구: Actions → PROJECT-RELEASE-PUBLISH → Run workflow (workflow_dispatch는 이 게이트를 우회합니다).",
+    "wf_release.drift_ok": "드리프트 검사 통과 (version.yml={file_version}, 최신 태그={latest_tag})",
+    "wf_release.head_is_docs_commit": "HEAD가 이미 이 워크플로우의 릴리스 문서 커밋입니다 — 버전을 다시 올리지 않습니다 (재실행 안전)",
+    "wf_release.collect_since": "{last_tag} 이후 커밋을 수집합니다",
+    "wf_release.collect_all": "이전 태그가 없어 전체 히스토리를 수집합니다",
+    "wf_release.release_version": "릴리스 버전: {new_version} ({bump})",
+    "wf_release.docs_pushed": "릴리스 문서를 push했습니다",
+    "wf_release.read_version_failed": "버전을 읽지 못했습니다",
+    "wf_release.tag_exists": "태그 v{version}이(가) 이미 있어 태그 push를 건너뜁니다",
+    "wf_release.release_exists": "릴리스 v{version}이(가) 이미 있어 발행할 것이 없습니다",
+    "wf_release.publishing": "릴리스 v{version}을(를) 발행합니다",
+    "wf_release.tag_pushed": "태그 v{version}을(를) push했습니다",
+    "wf_release.notes_assembled": "릴리스 노트 작성 완료 ({n} 바이트)",
+    "wf_release.published": "GitHub Release v{version}을(를) 발행했습니다",
+    # --- wf_version ---
+    "wf_version.trunk_skip": "trunk-based 모드입니다 — 버전 승격은 RELEASE-PUBLISH가 맡으므로 건너뜁니다",
+    "wf_version.confirm_skip": "릴리스 확정 커밋(chore(release):)을 감지했습니다 — 안전망 버전 승격을 건너뜁니다",
+    "wf_version.release_merge_skip": "릴리스 병합을 감지했습니다 (push에 version.yml 변경 포함) — 안전망 버전 승격을 건너뜁니다",
+    "wf_version.direct_push": "{main_branch}에 직접 push를 감지했습니다 — 안전망 버전 승격을 실행합니다",
+    "wf_version.read_current_failed": "현재 버전을 읽지 못했습니다",
+    "wf_version.current_version": "현재 버전: {current_version}",
+    "wf_version.new_version": "새 버전: {new_version}",
+    "wf_version.project_types": "프로젝트 타입: {project_types}",
+    "wf_version.yml_not_found": "version.yml을 찾을 수 없습니다",
+    "wf_version.commits_since": "{last_tag} 이후 커밋: {n}개",
+    "wf_version.no_changes_synced": "커밋할 변경 사항이 없습니다 (이미 동기화됨)",
+    "wf_version.bump_pushed": "버전 승격 커밋을 push했습니다",
+    "wf_version.commit_failed": "커밋에 실패했습니다",
+    "wf_version.no_develop": "브랜치 {develop_branch}이(가) 없어 역병합할 것이 없습니다",
+    "wf_version.already_contains": "{develop_branch}이(가) 이미 {main_branch}를 포함합니다",
+    "wf_version.backmerged": "안전망 버전 승격 v{new_version}을(를) {develop_branch}에 병합했습니다",
+    "wf_version.push_retry": "push 시도 {attempt} 실패 — 다시 시도합니다",
+    "wf_version.finished": "version-control 워크플로우 종료",
+    "wf_version.sum_skipped": "  건너뜀 (릴리스 병합 / trunk-based): {skip}",
+    "wf_version.sum_previous": "  이전 버전: {current_version}",
+    "wf_version.sum_new": "  새 버전: {new_version}",
+    "wf_version.sum_branch": "  브랜치: {ref_name}",
 }
 
 CATALOG = {"en": EN, "ko": KO}