projectops 4.31.5 → 4.33.0

package/src/core/version-yml.js

@@ -3,45 +3,45 @@
 // 실측 기준: template_integrator.sh 2184~2354.
 
 const HEADER = `# ===================================================================
-# 프로젝트 버전 관리 파일
+# Project version management file
 # ===================================================================
 #
-# 이 파일은 다양한 프로젝트 타입에서 버전 정보를 중앙 관리하기 위한 파일입니다.
-# GitHub Actions 워크플로우가 이 파일을 읽어 자동으로 버전을 관리합니다.
+# This file keeps version information in one place for every project type.
+# GitHub Actions workflows read this file and manage the version automatically.
 #
-# 사용법:
-# 1. version: "1.0.0" - 사용자에게 표시되는 버전
-# 2. version_code: 1 - Play Store/App Store 빌드 번호 (1부터 자동 증가)
-# 3. project_types: 프로젝트 타입 배열 — 첫 항목이 primary
-# 4. project_paths: 타입별 프로젝트 폴더 (레포 루트 기준 상대경로, 모노레포용)
+# Usage:
+# 1. version: "1.0.0" - the version shown to users
+# 2. version_code: 1 - Play Store/App Store build number (auto-incremented from 1)
+# 3. project_types: array of project types, the first entry is the primary one
+# 4. project_paths: project folder per type (relative to the repo root, for monorepos)
 #
-# 자동 버전 업데이트:
-# - version_code: 매 빌드마다 자동으로 1씩 증가 (아래 판정과 무관)
-# - 버전 승격 폭은 metadata.template.options.semver_auto 가 정합니다
-#   semver_auto: true  -> 릴리스 구간 커밋 제목으로 판정
-#                         "제목 : feat! : 내용" 또는 "feat!:" -> major (x+1.0.0)
-#                         "제목 : feat : 내용"  또는 "feat:"  -> minor (x.y+1.0)
-#                         그 외(fix/docs/chore/refactor/test) -> patch (x.y.z+1)
-#   키 없음 / false     -> 항상 patch +1
-# - 위 판정과 무관하게 version 값을 직접 수정해도 됩니다
+# Automatic version updates:
+# - version_code: incremented by 1 on every build (independent of the rules below)
+# - How far the version is bumped is decided by metadata.template.options.semver_auto
+#   semver_auto: true  -> decided by the commit titles in the release range
+#                         "title : feat! : body" or "feat!:" -> major (x+1.0.0)
+#                         "title : feat : body"  or "feat:"  -> minor (x.y+1.0)
+#                         anything else (fix/docs/chore/refactor/test) -> patch (x.y.z+1)
+#   key missing / false -> always patch +1
+# - You may edit the version value by hand regardless of the rules above
 #
-# 프로젝트 타입별 동기화 파일:
+# Files synced per project type:
 # - spring: build.gradle (version = "x.y.z")
-# - flutter: pubspec.yaml (version: x.y.z+i, buildNumber 포함)
+# - flutter: pubspec.yaml (version: x.y.z+i, includes buildNumber)
 # - react/node: package.json ("version": "x.y.z")
-# - react-native: iOS Info.plist 또는 Android build.gradle
+# - react-native: iOS Info.plist or Android build.gradle
 # - react-native-expo: app.json (expo.version)
 # - python: pyproject.toml (version = "x.y.z")
-# - basic/기타: version.yml 파일만 사용
+# - basic/other: only this version.yml file is used
 #
-# 연관된 워크플로우:
+# Related workflows:
 # - .github/workflows/PROJECT-VERSION-CONTROL.yaml
 # - .github/workflows/PROJECT-README-VERSION-UPDATE.yaml
 # - .github/workflows/PROJECT-RELEASE-CHANGELOG.yaml
 #
-# 주의사항:
-# - project_types는 최초 설정 후 변경하지 마세요
-# - 버전은 항상 높은 버전으로 자동 동기화됩니다
+# Notes:
+# - Do not change project_types after the initial setup
+# - The version is always synced automatically to the highest one
 # ===================================================================
 `;
 
@@ -56,8 +56,8 @@ const HEADER = `# ==============================================================
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
   const out = { deploy: null, publish: null, secretBackup: null,
-                changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null, aiPrSummary: null,
-                deployBranch: null, intent: null, semverAuto: null, appRelease: null };
+                changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null, aiPrSummary: null, projectsSync: null,
+                deployBranch: null, intent: null, semverAuto: null, appRelease: null, labelStyle: null, closeOnRelease: null, language: null };
   // deploy_branch는 metadata 직속(#456) — template.options 밖이라 별도로 스캔한다.
   for (const line of String(content || "").split("\n")) {
     if (line.startsWith("#")) continue;
@@ -135,6 +135,30 @@ export function parseTemplateOptions(content) {
         out.semverAuto = m[1] === "true";
         continue;
       }
+      // 레포 문구 언어(#769) — en | ko. 미기재는 "기존 통합 레포" 신호라 호출부가 ko 로 해석한다.
+      m = line.match(/^\s+language:\s*["']?(en|ko)["']?/);
+      if (m) {
+        out.language = m[1];
+        continue;
+      }
+      // 상태 라벨 표기(#776) — en(영문 표준) | ko(기존 한글). 미기재는 "기존 통합 레포" 신호라 호출부가 ko로 해석한다.
+      m = line.match(/^\s+label_style:\s*["']?(en|ko)["']?/);
+      if (m) {
+        out.labelStyle = m[1];
+        continue;
+      }
+      // Projects 보드 동기화(#716). null(미기재)이면 호출부가 "이미 설치돼 있으면 유지, 아니면 제외"로 해석한다.
+      m = line.match(/^\s+projects_sync:\s*["']?(true|false)["']?/);
+      if (m) {
+        out.projectsSync = m[1] === "true";
+        continue;
+      }
+      // 릴리스 시 완료 이슈 닫기(#771). null(미기재)은 "기존 통합 레포" 신호 — 워크플로우가 아무것도 하지 않는다.
+      m = line.match(/^\s+close_on_release:\s*["']?(true|false)["']?/);
+      if (m) {
+        out.closeOnRelease = m[1] === "true";
+        continue;
+      }
       // 프로젝트 성격(#553) — 앱 심사로 이어지는 레포인가. 워크플로우와 스킬이 같은 값을 본다.
       m = line.match(/^\s+app_release:\s*["']?(true|false)["']?/);
       if (m) {
@@ -210,7 +234,7 @@ export function convertLegacySingularType(content) {
     return lines.join("\n");
   }
   const type = value === "next" ? "react" : value; // next 타입은 4.1.0에서 react로 흡수
-  lines[idx] = `project_types: ["${type}"]   # 멀티타입 배열 — 첫 항목이 primary, 직접 편집 가능`;
+  lines[idx] = `project_types: ["${type}"]   # array of types, first entry is primary, safe to edit by hand`;
   return lines.join("\n");
 }
 
@@ -311,11 +335,11 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   let out = HEADER + "\n";
   out += `version: "${version}"\n`;
   out += `version_code: ${versionCode}  # app build number\n`;
-  out += `project_types: ${typesJson}   # 멀티타입 배열 — 첫 항목이 primary, 직접 편집 가능\n`;
+  out += `project_types: ${typesJson}   # array of types, first entry is primary, safe to edit by hand\n`;
 
   // project_paths 블록. pathMarkers: Map<type, markerFilename> (있으면 "  type: "path"   # path/marker" 주석).
   if (paths.size) {
-    out += `project_paths:                # 타입별 프로젝트 폴더 (레포 루트 기준 상대경로)\n`;
+    out += `project_paths:                # project folder per type (relative to the repo root)\n`;
     for (const [t, p] of paths) {
       const marker = pathMarkers.get(t) || "";
       const pf = p === "." ? marker : (marker ? `${p}/${marker}` : p);
@@ -337,7 +361,7 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   if (templateOptions) {
     const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
             changelogProvider = "commit", changelogBaseUrl = "", codeReviewCoderabbit = true, aiPrSummary = true, intent = null, mode = null,
-            semverAuto = true, appRelease = null } = templateOptions;
+            semverAuto = true, appRelease = null, labelStyle = null, closeOnRelease = null, projectsSync = null, language = null } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
     // intent(프로젝트 성격, #485) — 미지정이면 deploy/publish에서 역추론해 기록 (재통합 시 진입 질문 생략용)
     const intentVal = intent || inferIntent(deployTarget, publishTargets) || "manual";
@@ -345,19 +369,27 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
     out += `    source: "projectops"\n`;
     out += `    version: "${templateVersion}"\n`;
     // mode(#502) — 이 레포에 통합된 범위. 업데이트 모드가 같은 범위를 재실행하는 기준.
-    if (mode) out += `    mode: "${mode}"   # 통합 범위(full/version/workflows) — 업데이트 모드 재실행 기준\n`;
+    if (mode) out += `    mode: "${mode}"   # install scope (full/version/workflows), used when re-running update mode\n`;
     out += `    integrated_date: "${optionsDate}"\n`;
     out += `    last_update_date: "${optionsDate}"\n`;
     out += `    options:\n`;
-    out += `      intent: "${intentVal}"   # 프로젝트 성격(app/library/both/none/manual) — 배포 질문 유도 기준\n`;
+    out += `      intent: "${intentVal}"   # project kind (app/library/both/none/manual), drives the deploy questions\n`;
     out += `      deploy: "${deployTarget}"\n`;
     out += `      publish: ${publishJson}\n`;
     out += `      secret_backup: ${includeSecretBackup}\n`;
     // semver 자동 승격(#546) — 릴리스 시 커밋 제목으로 major/minor/patch 결정. false면 항상 patch.
-    out += `      semver_auto: ${semverAuto}   # 커밋 제목으로 버전 승격 폭 결정 (false면 항상 patch)\n`;
+    out += `      semver_auto: ${semverAuto}   # decide the version bump from commit titles (false means always patch)\n`;
+    // Projects 보드 동기화(#716) — 미지정이면 키를 쓰지 않는다.
+    if (projectsSync !== null) out += `      projects_sync: ${projectsSync}   # GitHub Projects 상태 동기화 워크플로우 포함 여부\n`;
+    // 릴리스 시 완료 이슈 닫기(#771) — 미지정이면 키를 쓰지 않는다(기존 레포는 현행 유지).
+    if (closeOnRelease !== null) out += `      close_on_release: ${closeOnRelease}   # close issues labelled done when a release is merged (false or missing means do not close)\n`;
+    // 상태 라벨 표기(#776) — 미지정이면 키를 쓰지 않는다(기존 레포 무변화).
+    // 레포 문구 언어(#769) — 미지정이면 키를 쓰지 않는다(기존 레포 무변화).
+    if (language) out += `      language: ${language}   # issue/PR template language (en | ko)\n`;
+    if (labelStyle) out += `      label_style: ${labelStyle}   # status label style (en: status: todo / ko: Korean names)\n`;
     // 앱 심사 배포 레포 여부(#553) — 미지정이면 키를 쓰지 않는다(기존 레포 무변화).
     if (appRelease !== null) {
-      out += `      app_release: ${appRelease}   # 앱스토어·플레이스토어 심사로 이어지는 배포인가\n`;
+      out += `      app_release: ${appRelease}   # whether releases go through App Store / Play Store review\n`;
     }
     out += `      code_review:\n`;
     out += `        coderabbit: ${codeReviewCoderabbit}\n`;
@@ -373,7 +405,7 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   const deployTypes = [...deployValues.keys()].filter((t) => deployValues.get(t) && deployValues.get(t).size > 0);
   if (deployTypes.length) {
     out += `\n`;
-    out += `deploy:                          # 마법사가 기억하는 배포 설정 (비민감 / 직접 수정 가능)\n`;
+    out += `deploy:                          # deploy settings remembered by the wizard (non-sensitive, safe to edit by hand)\n`;
     for (const t of deployTypes) {
       out += `  ${t}:\n`;
       for (const [k, v] of deployValues.get(t)) out += `    ${k}: "${v}"\n`;

package/src/i18n/core.en.js

@@ -0,0 +1,31 @@
+// core 영역 메시지 (en). 키는 <영역>.<의미> 형식.
+export default {
+  "args.mode": "--mode must be one of {values}: '{v}'",
+  "args.projectVersion": "--project-version must look like x.y.z (e.g. 1.0.0): '{v}'",
+  "args.unsupportedType": "Unsupported type: '{type}'\nSupported types: {valid}",
+  "args.typeEmpty": "--type is empty",
+  "args.deploy": "--deploy must be one of {values}: '{v}'",
+  "args.publish": "--publish must be a csv of {values}: '{v}'",
+  "args.deployBranch": "--deploy-branch must be a branch name made of letters, digits, . _ - /: '{v}'",
+  "args.intent": "--intent must be one of {values}: '{v}'",
+  "args.nexusDeprecated": "⚠️  --nexus is deprecated. Use --publish nexus --deploy none.",
+  "args.npmPublishDeprecated": "⚠️  --npm-publish is deprecated. Use --publish npm.",
+  "args.unknownOption": "Unknown option: {opt}",
+  "args.paths.unselected": "--paths contains a type that was not selected: '{type}' (selected types: {types})",
+  "args.paths.none": "none",
+  "args.paths.relative": "--paths {type}={path} : must be a path relative to the repository root (no absolute paths, no '..')",
+  "args.paths.missing": "--paths {type}={path} : folder does not exist",
+  "args.paths.outside": "--paths {type}={path} : points outside the repository",
+  "args.paths.badType": "--paths has an unsupported type: '{type}'",
+  "errors.git.message": "Cannot run git.",
+  "errors.git.hint": "Check that git is installed and on your PATH.",
+  "errors.clone.message": "Could not download the template.",
+  "errors.clone.hint": "Check your network, proxy settings and GitHub access, then run again.",
+  "errors.write.message": "Cannot write the file{where}.",
+  "errors.write.hint": "Check write permission (and read-only status) of the project folder and the .github folder.",
+  "errors.disk.message": "Not enough disk space.",
+  "errors.disk.hint": "Free up some space and run again.",
+  "errors.unexpected.message": "Unexpected error: {msg}",
+  "errors.unexpected.hint": "Run again with DEBUG=1 for details.",
+  "run.orphanNotice": "⚠️ Workflow of an unselected type ({type}) is left behind: {file}. You can clean it up in the interactive wizard (npx projectops).",
+};

package/src/i18n/core.ko.js

@@ -0,0 +1,31 @@
+// core 영역 메시지 (ko). 키는 <영역>.<의미> 형식.
+export default {
+  "args.mode": "--mode 값은 {values} 중 하나여야 합니다: '{v}'",
+  "args.projectVersion": "--project-version 값은 x.y.z (예: 1.0.0) 형식이어야 합니다: '{v}'",
+  "args.unsupportedType": "지원하지 않는 타입: '{type}'\n지원 타입: {valid}",
+  "args.typeEmpty": "--type 인자가 비어 있습니다",
+  "args.deploy": "--deploy 값은 {values} 중 하나여야 합니다: '{v}'",
+  "args.publish": "--publish 값은 {values} csv여야 합니다: '{v}'",
+  "args.deployBranch": "--deploy-branch 값은 글자·숫자·. _ - / 로 이루어진 브랜치명이어야 합니다: '{v}'",
+  "args.intent": "--intent 값은 {values} 중 하나여야 합니다: '{v}'",
+  "args.nexusDeprecated": "⚠️  --nexus는 deprecated입니다. --publish nexus --deploy none 을 사용하세요.",
+  "args.npmPublishDeprecated": "⚠️  --npm-publish는 deprecated입니다. --publish npm 을 사용하세요.",
+  "args.unknownOption": "알 수 없는 옵션: {opt}",
+  "args.paths.unselected": "--paths 에 선택하지 않은 타입이 있습니다: '{type}' (선택한 타입: {types})",
+  "args.paths.none": "없음",
+  "args.paths.relative": "--paths {type}={path} : 저장소 루트 기준 상대 경로여야 합니다 (절대경로, '..' 불가)",
+  "args.paths.missing": "--paths {type}={path} : 존재하지 않는 폴더입니다",
+  "args.paths.outside": "--paths {type}={path} : 저장소 밖을 가리킵니다",
+  "args.paths.badType": "--paths에 지원하지 않는 타입: '{type}'",
+  "errors.git.message": "git 을 실행할 수 없습니다.",
+  "errors.git.hint": "git 이 설치되어 있고 PATH 에 있는지 확인하세요.",
+  "errors.clone.message": "템플릿을 내려받지 못했습니다.",
+  "errors.clone.hint": "네트워크·프록시 설정과 GitHub 접근 가능 여부를 확인한 뒤 다시 실행하세요.",
+  "errors.write.message": "파일을 쓸 수 없습니다{where}.",
+  "errors.write.hint": "프로젝트 폴더와 .github 폴더의 쓰기 권한(읽기 전용 여부)을 확인하세요.",
+  "errors.disk.message": "디스크 공간이 부족합니다.",
+  "errors.disk.hint": "공간을 확보한 뒤 다시 실행하세요.",
+  "errors.unexpected.message": "예기치 못한 오류: {msg}",
+  "errors.unexpected.hint": "자세한 내용은 DEBUG=1 로 다시 실행하면 볼 수 있습니다.",
+  "run.orphanNotice": "⚠️ 선택되지 않은 타입({type})의 워크플로우가 남아있습니다: {file} — 대화형 마법사(npx projectops)에서 정리할 수 있습니다.",
+};

package/src/i18n/doctor.en.js

@@ -0,0 +1,89 @@
+// doctor 영역 메시지 (en). 키는 doctor.* 형식.
+export default {
+  "doctor.perm.purpose": "Automatic commits, tags and downstream workflow runs",
+  "doctor.integ.name": "Integration status",
+  "doctor.integ.purpose": "Whether the template is installed in this folder",
+  "doctor.integ.noVersionYml": "version.yml not found",
+  "doctor.integ.notIntegrated": "The template is not integrated in this folder.",
+  "doctor.integ.howTo": "To integrate: npx projectops",
+  "doctor.integ.versions": "Template v{tpl} / Project v{proj}",
+  "doctor.wf.name": "Installed workflows",
+  "doctor.wf.purpose": "Automation running in this repository",
+  "doctor.count": "{n}",
+  "doctor.wf.none": "No workflows are installed.",
+  "doctor.wf.noneHint": "Try running again with the workflows or full mode.",
+  "doctor.unres.name": "Unresolved values",
+  "doctor.unres.purpose": "Places that will fail at deploy time",
+  "doctor.none": "None",
+  "doctor.cases": "{n} found",
+  "doctor.unres.intro": "Template values are still present at the locations below.",
+  "doctor.unres.more": "  ... and {n} more",
+  "doctor.unres.outro": "If left as is, those workflows fail at the deploy step. Fill in the values yourself.",
+  "doctor.sec.name": "Required secrets",
+  "doctor.sec.purpose": "Values the installed workflows require",
+  "doctor.sec.line": "  {name}  <- {n} workflow(s)",
+  "doctor.sec.skipUnused": "You do not need to register values for workflows you do not use.",
+  "doctor.ai.name": "AI summary key",
+  "doctor.ai.purpose": "Whether to polish release notes with AI (optional)",
+  "doctor.ai.optional": "Optional",
+  "doctor.ai.l1": "Release notes are produced even without it. They are built by analyzing commits.",
+  "doctor.ai.l2": "For AI-polished text, register one of these as a repository Secret.",
+  "doctor.ai.gemini": "  GEMINI_API_KEY     free: https://aistudio.google.com/apikey",
+  "doctor.ai.groq": "  GROQ_API_KEY       free",
+  "doctor.ai.mistral": "  MISTRAL_API_KEY    free",
+  "doctor.ai.paid": "  OPENAI_API_KEY / ANTHROPIC_API_KEY   paid",
+  "doctor.ai.l3": "Whatever you register is used automatically. No other setup is needed.",
+  "doctor.pd.name": "Workflow permission declarations",
+  "doctor.pd.purpose": "Permission to run other workflows",
+  "doctor.pd.missing": "{n} missing",
+  "doctor.ok": "OK",
+  "doctor.pd.l1": "These run other workflows but permissions has no 'actions: write'.",
+  "doctor.pd.l2": "Even if the repository setting is Read and write, the API returns 403 without this declaration.",
+  "doctor.pd.l3": "Fix: add 'actions: write' to the permissions block of each file",
+  "doctor.bl.name": "Update baseline",
+  "doctor.bl.purpose": "Basis for telling your edits apart on the next update",
+  "doctor.bl.recorded": "{n} files recorded",
+  "doctor.bl.l1": "Without a baseline, the next update asks about every changed file.",
+  "doctor.bl.l2": "Running the integration once records it; from the next update on, your edits and template improvements are told apart.",
+  "doctor.rm.noAccess": "No permission to query",
+  "doctor.rm.failed": "Query failed",
+  "doctor.rm.permNoAdmin": "The token lacks repository admin permission, so this could not be checked.",
+  "doctor.rm.permCheck": "Check it yourself at Settings > Actions > General > Workflow permissions.",
+  "doctor.rm.roOk": "Read-only (no effect because workflows declare permissions themselves)",
+  "doctor.rm.roOkDetail": "Installed workflows all declare permissions, so they work fine even when the default is read-only.",
+  "doctor.rm.roWarn": "Read repository contents permission (read-only)",
+  "doctor.rm.l1": "Workflows without a permissions declaration cannot write to the repository or run other workflows.",
+  "doctor.rm.fix1": "Fix: add a permissions block to those files, or",
+  "doctor.rm.fix2": "      choose 'Read and write permissions' at Settings > Actions > General > Workflow permissions",
+  "doctor.mc.name": "Merge commits allowed",
+  "doctor.mc.purpose": "Condition for automatic release PR merge",
+  "doctor.mc.on": "Allowed",
+  "doctor.mc.off": "Disabled",
+  "doctor.mc.l1": "Automatic release PR merge uses the merge commit method.",
+  "doctor.mc.l2": "If disabled, the automatic merge fails and the PR stays open.",
+  "doctor.mc.fix": "Fix: check 'Allow merge commits' at Settings > General > Pull Requests",
+  "doctor.sr.name": "Secret registration",
+  "doctor.sr.purpose": "Values needed for deployment",
+  "doctor.sr.noAccess": "The token lacks permission to read Secrets, so this could not be checked.",
+  "doctor.air.legacy": "legacy name (service auto-detected)",
+  "doctor.air.name": "AI summary key registration",
+  "doctor.air.none": "None (runs on commit analysis)",
+  "doctor.air.l1": "Release notes are produced normally even without it.",
+  "doctor.air.l2": "To use AI, register GEMINI_API_KEY (free): https://aistudio.google.com/apikey",
+  "doctor.sr.missing": "{n} not registered",
+  "doctor.sr.all": "All registered",
+  "doctor.sr.l1": "If you do not use those workflows, you do not need to register them.",
+  "doctor.sr.fix": "Fix: Settings > Secrets and variables > Actions > New repository secret",
+  "doctor.render.clean": "No problems found.",
+  "doctor.render.warn": "{n} item(s) to review. See the fixes above (skip them if you do not use that feature).",
+  "doctor.title": "projectops doctor: integration status and repository settings check",
+  "doctor.gh.name": "GitHub remote",
+  "doctor.gh.purpose": "Repository being checked",
+  "doctor.gh.noOrigin": "No origin{folder}",
+  "doctor.gh.folder": " (folder name: {name})",
+  "doctor.gh.noRemote": "No remote repository was found, so repository settings are not checked.",
+  "doctor.skip.name": "Repository settings check",
+  "doctor.skip.purpose": "Permissions, merge method, Secrets",
+  "doctor.skip.value": "Skipped (no token)",
+  "doctor.skip.l1": "Set the GITHUB_TOKEN environment variable to check repository settings too.",
+};

package/src/i18n/doctor.ko.js

@@ -0,0 +1,89 @@
+// doctor 영역 메시지 (ko). 키는 doctor.* 형식.
+export default {
+  "doctor.perm.purpose": "자동 커밋·태그·후속 워크플로우 실행",
+  "doctor.integ.name": "통합 상태",
+  "doctor.integ.purpose": "이 폴더의 템플릿 설치 여부",
+  "doctor.integ.noVersionYml": "version.yml 없음",
+  "doctor.integ.notIntegrated": "이 폴더에는 템플릿이 통합되어 있지 않습니다.",
+  "doctor.integ.howTo": "통합하려면: npx projectops",
+  "doctor.integ.versions": "템플릿 v{tpl} / 프로젝트 v{proj}",
+  "doctor.wf.name": "설치된 워크플로우",
+  "doctor.wf.purpose": "이 저장소에서 도는 자동화",
+  "doctor.count": "{n}개",
+  "doctor.wf.none": "워크플로우가 하나도 없습니다.",
+  "doctor.wf.noneHint": "통합 모드를 workflows 또는 full로 다시 실행해 보세요.",
+  "doctor.unres.name": "치환되지 않은 값",
+  "doctor.unres.purpose": "배포 시점에 실패할 자리",
+  "doctor.none": "없음",
+  "doctor.cases": "{n}건",
+  "doctor.unres.intro": "아래 위치에 템플릿 값이 그대로 남아 있습니다.",
+  "doctor.unres.more": "  … 외 {n}건",
+  "doctor.unres.outro": "그대로 두면 해당 워크플로우가 배포 단계에서 실패합니다. 직접 값을 채워주세요.",
+  "doctor.sec.name": "필요한 Secret",
+  "doctor.sec.purpose": "설치된 워크플로우가 요구하는 값",
+  "doctor.sec.line": "  {name}  ← {n}개 워크플로우",
+  "doctor.sec.skipUnused": "쓰지 않는 워크플로우의 값은 등록하지 않아도 됩니다.",
+  "doctor.ai.name": "AI 요약 키",
+  "doctor.ai.purpose": "릴리스 노트를 AI로 다듬을지 (선택)",
+  "doctor.ai.optional": "선택 사항",
+  "doctor.ai.l1": "등록하지 않아도 릴리스 노트는 나옵니다 — 커밋 내용을 분석해 만듭니다.",
+  "doctor.ai.l2": "AI가 다듬은 문장을 원하면 아래 중 하나를 저장소 Secret에 등록하세요.",
+  "doctor.ai.gemini": "  GEMINI_API_KEY     무료 · https://aistudio.google.com/apikey",
+  "doctor.ai.groq": "  GROQ_API_KEY       무료",
+  "doctor.ai.mistral": "  MISTRAL_API_KEY    무료",
+  "doctor.ai.paid": "  OPENAI_API_KEY / ANTHROPIC_API_KEY   유료",
+  "doctor.ai.l3": "등록한 것이 자동으로 쓰입니다. 별도 설정은 필요 없습니다.",
+  "doctor.pd.name": "워크플로우 권한 선언",
+  "doctor.pd.purpose": "다른 워크플로우를 실행할 권한",
+  "doctor.pd.missing": "{n}건 누락",
+  "doctor.ok": "정상",
+  "doctor.pd.l1": "다른 워크플로우를 실행하는데 permissions에 'actions: write'가 없습니다.",
+  "doctor.pd.l2": "저장소 설정이 Read and write여도 이 선언이 없으면 API가 403을 반환합니다.",
+  "doctor.pd.l3": "조치: 해당 파일의 permissions 블록에 'actions: write' 추가",
+  "doctor.bl.name": "업데이트 기준점",
+  "doctor.bl.purpose": "다음 업데이트가 내 수정을 구분할 근거",
+  "doctor.bl.recorded": "{n}개 파일 기록됨",
+  "doctor.bl.l1": "기준점이 없어 다음 업데이트는 변경된 파일을 모두 물어봅니다.",
+  "doctor.bl.l2": "통합을 한 번 실행하면 기록되고, 그 다음 업데이트부터 내 수정과 템플릿 개선을 구분합니다.",
+  "doctor.rm.noAccess": "조회 권한 없음",
+  "doctor.rm.failed": "조회 실패",
+  "doctor.rm.permNoAdmin": "토큰에 저장소 관리 권한이 없어 확인하지 못했습니다.",
+  "doctor.rm.permCheck": "Settings > Actions > General > Workflow permissions 에서 직접 확인하세요.",
+  "doctor.rm.roOk": "읽기 전용 (워크플로우가 권한을 직접 선언해 영향 없음)",
+  "doctor.rm.roOkDetail": "설치된 워크플로우가 permissions 를 모두 선언하고 있어 기본값이 읽기 전용이어도 정상 동작합니다.",
+  "doctor.rm.roWarn": "Read repository contents permission (읽기 전용)",
+  "doctor.rm.l1": "permissions 선언이 없는 워크플로우는 저장소에 쓰거나 다른 워크플로우를 실행할 수 없습니다.",
+  "doctor.rm.fix1": "조치: 해당 파일에 permissions 블록을 추가하거나",
+  "doctor.rm.fix2": "      Settings > Actions > General > Workflow permissions → 'Read and write permissions' 선택",
+  "doctor.mc.name": "merge commit 허용",
+  "doctor.mc.purpose": "릴리스 PR 자동 머지 조건",
+  "doctor.mc.on": "허용됨",
+  "doctor.mc.off": "꺼져 있음",
+  "doctor.mc.l1": "릴리스 PR 자동 머지는 merge commit 방식을 사용합니다.",
+  "doctor.mc.l2": "꺼져 있으면 자동 머지가 실패하고 PR이 열린 채 남습니다.",
+  "doctor.mc.fix": "조치: Settings > General > Pull Requests → 'Allow merge commits' 체크",
+  "doctor.sr.name": "Secret 등록 여부",
+  "doctor.sr.purpose": "배포에 필요한 값",
+  "doctor.sr.noAccess": "토큰에 Secret 조회 권한이 없어 확인하지 못했습니다.",
+  "doctor.air.legacy": "구 이름(서비스 자동 추정)",
+  "doctor.air.name": "AI 요약 키 등록",
+  "doctor.air.none": "없음 — 커밋 분석으로 동작",
+  "doctor.air.l1": "등록하지 않아도 릴리스 노트는 정상적으로 나옵니다.",
+  "doctor.air.l2": "AI를 쓰려면 GEMINI_API_KEY(무료)를 등록하세요 — https://aistudio.google.com/apikey",
+  "doctor.sr.missing": "{n}개 미등록",
+  "doctor.sr.all": "전부 등록됨",
+  "doctor.sr.l1": "해당 워크플로우를 쓰지 않는다면 등록하지 않아도 됩니다.",
+  "doctor.sr.fix": "조치: Settings > Secrets and variables > Actions > New repository secret",
+  "doctor.render.clean": "확인된 문제 없음.",
+  "doctor.render.warn": "살펴볼 항목 {n}건. 위 조치를 참고하세요 (쓰지 않는 기능이라면 넘어가도 됩니다).",
+  "doctor.title": "projectops doctor — 통합 상태 및 저장소 설정 진단",
+  "doctor.gh.name": "GitHub 원격",
+  "doctor.gh.purpose": "점검 대상 저장소",
+  "doctor.gh.noOrigin": "origin 없음{folder}",
+  "doctor.gh.folder": " (폴더명: {name})",
+  "doctor.gh.noRemote": "원격 저장소를 찾지 못해 저장소 설정은 점검하지 않습니다.",
+  "doctor.skip.name": "저장소 설정 점검",
+  "doctor.skip.purpose": "권한·머지 방식·Secret",
+  "doctor.skip.value": "건너뜀 (토큰 없음)",
+  "doctor.skip.l1": "GITHUB_TOKEN 환경변수를 주면 저장소 설정까지 점검합니다.",
+};

package/src/i18n/en.js

@@ -0,0 +1,141 @@
+// English messages (source of truth). Keys are grouped by area: <area>.<name>.
+import summary from "./summary.en.js";
+import doctor from "./doctor.en.js";
+import options from "./options.en.js";
+import migrate from "./migrate.en.js";
+import core from "./core.en.js";
+import ide from "./ide.en.js";
+
+export default {
+  ...summary,
+  ...doctor,
+  ...options,
+  ...migrate,
+  ...core,
+  ...ide,
+  // prompt engine hints
+  "engine.hint.select": "↑/↓ move, Enter confirm, ESC cancel",
+  "engine.hint.multiselect": "↑/↓ move, Space toggle, a all, Enter confirm, ESC cancel",
+  "engine.hint.confirm": "←/→ or y/n, Enter confirm, ESC cancel",
+  "engine.yes": "Yes",
+  "engine.no": "No",
+  "engine.none": "(none)",
+  "engine.disabled": "This item cannot be selected.",
+  "engine.required": "Select at least one.",
+  "engine.cancelled": "Cancelled.",
+
+  // main menu
+  "mode.prompt": "What would you like to install?",
+  "mode.update": "Update ({range})",
+  "mode.full": "Full install (versioning + workflows + templates)",
+  "mode.version": "Versioning only (automation system)",
+  "mode.workflows": "Workflows only (GitHub Actions build and deploy)",
+  "mode.issues": "Issue/PR templates only",
+  "mode.skills": "AI skills only (Claude, Cursor, Gemini, Codex, PI)",
+
+  // confirm and edit menus
+  "confirm.prompt": "Continue with these settings?",
+  "confirm.continue": "Yes, continue",
+  "confirm.edit": "Edit",
+  "confirm.cancel": "No, cancel",
+  "edit.prompt": "Which setting do you want to change?",
+  "edit.type": "Project type",
+  "edit.version": "Version",
+  "edit.branch": "Default branch",
+  "language.propose": "Switch the issue and PR templates in this repo to English? They are Korean now. Answer no to keep them as they are.",
+  "labelStyle.propose": "Rename Korean status labels (작업전, 작업중, ...) to English (status: todo, ...)? Issues keep their labels; Projects sync accepts both.",
+  "edit.intent": "Project kind (deployment style)",
+  "edit.deploy": "Deployment (server artifact)",
+  "edit.publish": "Library publish targets",
+  "edit.codeReview": "CodeRabbit code review",
+  "edit.changelog": "Release notes (changelog) generator",
+  "edit.releaseBranch": "Release source (development) branch",
+  "edit.secret": "Include secret backup",
+  "edit.done": "All correct, continue",
+  "types.prompt": "Select project types (Space to toggle, Enter to confirm)",
+
+  // help and errors
+  "cli.nonTty": "Interactive input is not available. Pass --mode <full|version|workflows|issues> and --force.",
+  "cli.needForce": "The --force option is required in a non-interactive environment.",
+  "cli.langInvalid": "--lang must be one of: {values} (got '{value}')",
+  "cli.langSource.flag": "--lang",
+  "cli.langSource.env": "PROJECTOPS_LANG",
+  "cli.langSource.ci": "fixed for CI/--force",
+  "cli.langSource.system": "system",
+  "cli.langSource.default": "default",
+
+  // banner
+  "banner.interactive": "Interactive installer",
+  "banner.compactMode": "({mode} mode, --force)",
+
+  // detection log and summary card
+  "detect.title": "Inspecting the project...",
+  "detect.found": "{marker} found, {type} detected",
+  "detect.foundNoMarker": "{type} detected",
+  "detect.none": "no marker files, using basic (you can change it)",
+  "detect.versionBranch": "version: v{version}, branch: {branch}",
+  "card.title": "Summary",
+  "card.type": "Type",
+  "card.typeMulti": "Types (multi)",
+  "card.version": "Version",
+  "card.branch": "Branch",
+  "card.mode": "Install mode",
+  "card.deploy": "Deploy",
+  "card.publish": "Publish",
+  "card.secret": "Secret backup",
+  "card.paths": "Paths",
+  "card.none": "none",
+  "card.included": "included",
+  "card.excluded": "excluded",
+
+  // ide status and install kind
+  "ide.title": "AI agent skills",
+  "ide.installed": "installed",
+  "ide.notInstalled": "not installed",
+  "ide.cliMissing": "CLI not found",
+  "ide.detectFailed": "detection failed",
+  "kind.update": "Update",
+  "kind.updateFrom": "template v{from} to v{to}",
+  "kind.updateWhy": "version.yml has a previous install record. 'Update' at the top of the menu re-applies your saved settings",
+  "kind.new": "New install",
+  "kind.newTemplate": "first install in this project (template v{to})",
+  "kind.newWhy": "version.yml has no previous install record, so this is treated as a new install",
+
+  // interactive flow
+  "flow.cancelInstall": "Installation cancelled.",
+  "flow.cancelBreaking": "Cancelled safely, nothing was changed.",
+  "flow.doneSkills": "AI skills installed.",
+  "flow.doneIssues": "Issue and PR templates installed.",
+  "flow.title.update": "Update, using saved settings",
+  "flow.title.summary": "Summary",
+  "flow.askVersion": "New version (e.g. 1.0.0)",
+  "flow.askBranch": "Default branch",
+  "flow.badVersion": "Invalid version format (use x.y.z). Keeping the current value.",
+  "flow.badVersionTitle": "Version",
+  "flow.askSkills": "Also install or update AI agent skills (Claude, Cursor, Gemini, Codex, PI)?",
+  "flow.done": "Done. Installed in {mode} mode.",
+  "flow.updateScope": "Update ({scope} scope)",
+  "flow.conflictsTitle": "{count} workflows changed in the new template",
+  "flow.conflictsAsk": "Back up these {count} as .bak and replace them with the new version? (your settings are kept)",
+  "flow.conflictType": "Some files differ from the existing workflows ({type}). What should happen?",
+  "flow.opt.skip": "Skip, keep the existing file (default)",
+  "flow.opt.backup": "Back up as .bak and replace with the new version",
+  "flow.opt.template": "Keep the existing file and add the new version as .template.yaml for reference",
+  "flow.orphanLine": "{file} ({type} type, not selected now)",
+  "flow.orphanTitle": "{count} workflows of unselected types found",
+  "flow.orphanAsk": "Clean up these {count}? (neutralized as .bak, restorable)",
+  "flow.orphanDone": "Orphan workflows cleaned: {ok}{failed}",
+  "flow.orphanFailed": " ({count} failed)",
+  "flow.orphanDoneTitle": "Cleanup done",
+  "sum.mode": "Install mode",
+  "sum.types": "Project types",
+  "sum.multi": " (multi)",
+  "sum.deploy": "Deploy",
+  "sum.publish": "Publish",
+  "sum.secret": "Secret backup",
+  "sum.changelog": "Changelog",
+  "sum.coderabbit": "CodeRabbit review",
+  "sum.on": "enabled",
+  "sum.off": "disabled",
+  "mode.update.short": "Update",
+};