projectops 4.31.5 → 4.33.1

package/src/cli/args.js

@@ -2,9 +2,12 @@
 import { existsSync, statSync, realpathSync } from "node:fs";
 import { join, relative, isAbsolute } from "node:path";
 import { VALID_TYPES } from "../context.js";
+import { SUPPORTED_LANGS, t } from "../i18n/index.js";
 
 export const DEPLOY_TARGETS = ["docker-ssh", "vercel", "none"];
 export const PUBLISH_TARGETS = ["nexus", "npm", "github-packages"];
+export const LABEL_STYLE_VALUES = ["en", "ko"];
+export const LANGUAGE_VALUES = ["en", "ko"];
 export const INTENT_VALUES = ["app", "library", "both", "none", "manual"];
 const SEMVER_RE = /^\d+\.\d+\.\d+$/;
 // 유니코드 글자·숫자 허용 (#719) — 공백·셸 메타문자는 문자 클래스에 없어 그대로 거부된다.
@@ -22,11 +25,15 @@ export function parseArgs(argv) {
     deployTarget: null,      // 배포 축 (#439): docker-ssh|vercel|none, null=미설정
     publishTargets: null,    // publish 축 (#439): 타겟 배열, null=미설정
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456): --deploy-branch, 빈 값=미지정
+    language: null,          // 레포 문구 언어 (#769): --language en|ko (화면 언어 --lang 과 다르다)
+    labelStyle: null,        // 상태 라벨 표기 (#776): --label-style en|ko
     intent: null,            // 프로젝트 성격 (#485): --intent app|library|both|none|manual, null=미설정(역추론)
     includeSecretBackup: null,
     aiPrSummary: null,   // #566 — AI 변경 요약 워크플로우 포함 여부
+    projectsSync: null,  // #716 — Projects 보드 동기화 워크플로우 포함 여부 (null=미지정)
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
+    lang: null,              // --lang en|ko (null = decided by src/i18n resolveLang)
     help: false,
     showVersion: false,      // -v/--version → projectops 패키지 버전 출력 (npm 관례)
   };
@@ -38,7 +45,7 @@ export function parseArgs(argv) {
       {
         const v = (args.shift() ?? "").trim();
         if (!MODE_VALUES.includes(v)) {
-          throw new CliError(`--mode 값은 ${MODE_VALUES.join(" | ")} 중 하나여야 합니다: '${v}'`);
+          throw new CliError(t("args.mode", { values: MODE_VALUES.join(" | "), v }));
         }
         result.mode = v;
         break;
@@ -52,7 +59,7 @@ export function parseArgs(argv) {
         // 'v1.0.0'은 사용자가 흔히 쓰는 표기라 거부하지 않고 접두사만 떼어 받는다
         const v = (args.shift() ?? "").trim().replace(/^[vV](?=\d)/, "");
         if (!SEMVER_RE.test(v)) {
-          throw new CliError(`--project-version 값은 x.y.z (예: 1.0.0) 형식이어야 합니다: '${v}'`);
+          throw new CliError(t("args.projectVersion", { v }));
         }
         result.version = v;
         break;
@@ -61,26 +68,34 @@ export function parseArgs(argv) {
         const csv = args.shift() ?? "";
         const seen = new Set();
         const types = [];
-        for (let t of csv.split(",")) {
-          t = t.replace(/\s/g, "");
-          if (t === "") continue;
-          if (seen.has(t)) continue;         // dedup
-          if (!VALID_TYPES.includes(t)) {
-            throw new CliError(`지원하지 않는 타입: '${t}'\n지원 타입: ${VALID_TYPES.join(" ")}`);
+        for (let ty of csv.split(",")) {
+          ty = ty.replace(/\s/g, "");
+          if (ty === "") continue;
+          if (seen.has(ty)) continue;         // dedup
+          if (!VALID_TYPES.includes(ty)) {
+            throw new CliError(t("args.unsupportedType", { type: ty, valid: VALID_TYPES.join(" ") }));
           }
-          seen.add(t);
-          types.push(t);
+          seen.add(ty);
+          types.push(ty);
         }
-        if (types.length === 0) throw new CliError("--type 인자가 비어 있습니다");
+        if (types.length === 0) throw new CliError(t("args.typeEmpty"));
         result.types = types;
         result.primaryType = types[0];
         break;
       }
-      case "--force": result.force = true; break;
+      case "--force": case "-y": case "--yes": result.force = true; break;
+      case "--lang": {
+        const v = (args.shift() ?? "").trim().toLowerCase();
+        if (!SUPPORTED_LANGS.includes(v)) {
+          throw new CliError(t("cli.langInvalid", { values: SUPPORTED_LANGS.join(" | "), value: v }));
+        }
+        result.lang = v;
+        break;
+      }
       case "--deploy": {
         const v = args.shift() ?? "";
         if (!DEPLOY_TARGETS.includes(v)) {
-          throw new CliError(`--deploy 값은 ${DEPLOY_TARGETS.join(" | ")} 중 하나여야 합니다: '${v}'`);
+          throw new CliError(t("args.deploy", { values: DEPLOY_TARGETS.join(" | "), v }));
         }
         result.deployTarget = v;
         break;
@@ -88,13 +103,13 @@ export function parseArgs(argv) {
       case "--publish": {
         const csv = args.shift() ?? "";
         const targets = [];
-        for (let t of csv.split(",")) {
-          t = t.replace(/\s/g, "");
-          if (t === "") continue;
-          if (!PUBLISH_TARGETS.includes(t)) {
-            throw new CliError(`--publish 값은 ${PUBLISH_TARGETS.join(" | ")} csv여야 합니다: '${t}'`);
+        for (let pt of csv.split(",")) {
+          pt = pt.replace(/\s/g, "");
+          if (pt === "") continue;
+          if (!PUBLISH_TARGETS.includes(pt)) {
+            throw new CliError(t("args.publish", { values: PUBLISH_TARGETS.join(" | "), v: pt }));
           }
-          if (!targets.includes(t)) targets.push(t);
+          if (!targets.includes(pt)) targets.push(pt);
         }
         result.publishTargets = targets;
         break;
@@ -104,7 +119,7 @@ export function parseArgs(argv) {
         const v = (args.shift() ?? "").trim();
         // 워크플로우 yaml·셸에 그대로 삽입되므로 안전한 브랜치명만 허용 (#676)
         if (v && (!BRANCH_RE.test(v) || v.includes("..") || v.endsWith("/") || v.endsWith(".lock"))) {
-          throw new CliError(`--deploy-branch 값은 글자·숫자·. _ - / 로 이루어진 브랜치명이어야 합니다: '${v}'`);
+          throw new CliError(t("args.deployBranch", { v }));
         }
         if (v) result.deployBranch = v;
         break;
@@ -113,14 +128,33 @@ export function parseArgs(argv) {
         // 프로젝트 성격 (#485). 미지정이면 --deploy/--publish에서 역추론.
         const v = (args.shift() ?? "").trim();
         if (!INTENT_VALUES.includes(v)) {
-          throw new CliError(`--intent 값은 ${INTENT_VALUES.join(" | ")} 중 하나여야 합니다: '${v}'`);
+          throw new CliError(t("args.intent", { values: INTENT_VALUES.join(" | "), v }));
         }
         result.intent = v;
         break;
       }
+      case "--language": {
+        // 레포 문구 언어 (#769). 미지정이면 version.yml 저장값 → (신규 en / 기존 ko).
+        // 화면 언어(--lang)와 다르다: 이쪽은 사용자 레포에 쓰이는 템플릿의 언어다.
+        const v = (args.shift() ?? "").trim();
+        if (!LANGUAGE_VALUES.includes(v)) {
+          throw new CliError(`--language must be one of ${LANGUAGE_VALUES.join(" | ")}: '${v}'`);
+        }
+        result.language = v;
+        break;
+      }
+      case "--label-style": {
+        // 상태 라벨 표기 (#776). 미지정이면 version.yml 저장값 → (신규 en / 기존 ko).
+        const v = (args.shift() ?? "").trim();
+        if (!LABEL_STYLE_VALUES.includes(v)) {
+          throw new CliError(`--label-style must be one of ${LABEL_STYLE_VALUES.join(" | ")}: '${v}'`);
+        }
+        result.labelStyle = v;
+        break;
+      }
       // ── deprecated alias (1 minor 유지 — #439) ──
       case "--nexus":
-        process.stderr.write("⚠️  --nexus는 deprecated입니다. --publish nexus --deploy none 을 사용하세요.\n");
+        process.stderr.write(t("args.nexusDeprecated") + "\n");
         result.publishTargets = [...new Set([...(result.publishTargets ?? []), "nexus"])];
         if (result.deployTarget === null) result.deployTarget = "none";
         break;
@@ -132,8 +166,10 @@ export function parseArgs(argv) {
       // #566 — 비대화형에서도 켜고 끌 수 있어야 한다. 없으면 자동화 환경은 선택권이 없다.
       case "--ai-summary": result.aiPrSummary = true; break;
       case "--no-ai-summary": result.aiPrSummary = false; break;
+      case "--projects-sync": result.projectsSync = true; break;
+      case "--no-projects-sync": result.projectsSync = false; break;
       case "--npm-publish":
-        process.stderr.write("⚠️  --npm-publish는 deprecated입니다. --publish npm 을 사용하세요.\n");
+        process.stderr.write(t("args.npmPublishDeprecated") + "\n");
         result.publishTargets = [...new Set([...(result.publishTargets ?? []), "npm"])];
         break;
       case "--no-npm-publish":
@@ -142,7 +178,7 @@ export function parseArgs(argv) {
       case "--paths": result.pathsCsv = args.shift() ?? ""; break;
       case "-h": case "--help": result.help = true; break;
       default:
-        throw new CliError(`알 수 없는 옵션: ${a}`);
+        throw new CliError(t("args.unknownOption", { opt: a }));
     }
   }
   return result;
@@ -166,18 +202,18 @@ export function normalizePath(p) {
 export function validatePathsMap(map, { root, types }) {
   for (const [type, p] of map) {
     if (!types.includes(type)) {
-      throw new CliError(`--paths 에 선택하지 않은 타입이 있습니다: '${type}' (선택한 타입: ${types.join(",") || "없음"})`);
+      throw new CliError(t("args.paths.unselected", { type, types: types.join(",") || t("args.paths.none") }));
     }
     if (p.startsWith("/") || /^[A-Za-z]:/.test(p) || p.split("/").includes("..")) {
-      throw new CliError(`--paths ${type}=${p} : 저장소 루트 기준 상대 경로여야 합니다 (절대경로, '..' 불가)`);
+      throw new CliError(t("args.paths.relative", { type, path: p }));
     }
     const abs = join(root, p);
     if (!existsSync(abs) || !statSync(abs).isDirectory()) {
-      throw new CliError(`--paths ${type}=${p} : 존재하지 않는 폴더입니다`);
+      throw new CliError(t("args.paths.missing", { type, path: p }));
     }
     const rel = relative(realpathSync(root), realpathSync(abs));
     if (rel.startsWith("..") || isAbsolute(rel)) {
-      throw new CliError(`--paths ${type}=${p} : 저장소 밖을 가리킵니다`);
+      throw new CliError(t("args.paths.outside", { type, path: p }));
     }
   }
 }
@@ -192,7 +228,7 @@ export function parsePathsCsv(csv) {
     const type = (eq >= 0 ? pair.slice(0, eq) : pair).trim();
     const rawPath = eq >= 0 ? pair.slice(eq + 1) : "";
     if (!VALID_TYPES.includes(type)) {
-      throw new CliError(`--paths에 지원하지 않는 타입: '${type}'`);
+      throw new CliError(t("args.paths.badType", { type }));
     }
     map.set(type, normalizePath(rawPath));
   }

package/src/cli/errors.js

@@ -1,3 +1,5 @@
+import { t } from "../i18n/index.js";
+
 // 예기치 못한 예외를 사용자가 읽을 수 있는 한 줄 오류 + 조치 안내로 바꾼다 (#672).
 // 스택 트레이스는 사용자가 고칠 수 있는 정보가 아니므로 DEBUG 환경변수가 있을 때만 노출한다.
 
@@ -8,27 +10,27 @@ export function describeError(err) {
 
   // PATH 에 git 이 없음 — spawn 계열이 ENOENT 를 던진다
   if (code === "ENOENT" && /\bgit\b/.test(`${err?.path ?? ""} ${err?.syscall ?? ""} ${msg}`)) {
-    return { message: "git 을 실행할 수 없습니다.", hint: "git 이 설치되어 있고 PATH 에 있는지 확인하세요." };
+    return { message: t("errors.git.message"), hint: t("errors.git.hint") };
   }
   // 템플릿 내려받기 실패 — execFileSync 가 "Command failed: git clone ..." 를 던진다
   if (/Command failed: git clone/.test(msg)) {
     return {
-      message: "템플릿을 내려받지 못했습니다.",
-      hint: "네트워크·프록시 설정과 GitHub 접근 가능 여부를 확인한 뒤 다시 실행하세요.",
+      message: t("errors.clone.message"),
+      hint: t("errors.clone.hint"),
     };
   }
   // 권한/읽기 전용 파일시스템
   if (code === "EACCES" || code === "EPERM" || code === "EROFS") {
     const where = err?.path ? ` (${err.path})` : "";
     return {
-      message: `파일을 쓸 수 없습니다${where}.`,
-      hint: "프로젝트 폴더와 .github 폴더의 쓰기 권한(읽기 전용 여부)을 확인하세요.",
+      message: t("errors.write.message", { where }),
+      hint: t("errors.write.hint"),
     };
   }
   if (code === "ENOSPC") {
-    return { message: "디스크 공간이 부족합니다.", hint: "공간을 확보한 뒤 다시 실행하세요." };
+    return { message: t("errors.disk.message"), hint: t("errors.disk.hint") };
   }
-  return { message: `예기치 못한 오류: ${msg}`, hint: "자세한 내용은 DEBUG=1 로 다시 실행하면 볼 수 있습니다." };
+  return { message: t("errors.unexpected.message", { msg }), hint: t("errors.unexpected.hint") };
 }
 
 // 오류를 stderr 로 출력한다. 호출부는 비0 종료코드를 돌려주면 된다.

package/src/cli/help.js

@@ -1,5 +1,45 @@
-// --help 텍스트 (.sh show_help 요약 이식).
-export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿 통합 CLI
+// --help text in each supported language. English is the default (see src/i18n).
+import { getLang } from "../i18n/index.js";
+
+const HELP_EN = `projectops — GitHub project automation template installer
+
+Usage:
+  npx projectops [options]
+
+Options:
+  -m, --mode MODE          Mode (full | version | workflows | issues | skills | doctor)
+                           doctor: diagnose the installation and repository settings (read-only)
+                           default: interactive
+  -t, --type CSV           Project types, comma separated (e.g. spring,react,python)
+                           supported: spring flutter react react-native
+                                      react-native-expo node python basic
+                           (next was merged into react: use react for Next.js)
+      --project-version V  Initial version of the target project (e.g. 1.0.0). Detected if omitted
+      --paths "t=p,..."    Per-type project paths for monorepos. e.g. flutter=app,react=client
+      --intent KIND        Project kind: app | library | both | none | manual
+                           (inferred from --deploy/--publish if omitted)
+      --label-style STYLE  Status label names: en (status: todo) | ko (legacy 작업전)
+      --language LANG      Language of the issue and PR templates written into your repo: en | ko
+      --deploy TARGET      Deployment, pick one: docker-ssh (default) | vercel | none
+      --publish CSV        Publish targets: nexus,npm,github-packages (default: none)
+      --deploy-branch NAME Head branch of the release PR (default: develop). Not the default branch
+      --secret-backup / --no-secret-backup   Include / exclude the secret backup workflow
+      --ai-summary / --no-ai-summary         Include / exclude the PR summary workflow
+      --projects-sync / --no-projects-sync   Include / exclude the GitHub Projects status sync workflow (default: off for new installs)
+      --nexus / --npm-publish  (deprecated: use --publish nexus / --publish npm)
+      --force, -y, --yes   Skip every confirmation and use non-interactive defaults
+      --lang en|ko         Display language (default: system language, pinned to en in CI and with --force)
+  -v, --version            Print the projectops version
+  -h, --help               Show this help
+
+Examples:
+  npx projectops --mode full --force --type spring,react
+  npx projectops --mode workflows --type flutter --paths "flutter=app"
+  npx projectops --mode doctor                       # diagnose settings
+  GITHUB_TOKEN=ghp_... npx projectops --mode doctor  # include repository settings
+`;
+
+const HELP_KO = `projectops — GitHub 프로젝트 자동화 템플릿 통합 CLI
 
 사용법:
   npx projectops [옵션]
@@ -16,13 +56,17 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
       --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
       --intent KIND        프로젝트 성격(#485): app | library | both | none | manual
                            (미지정 시 --deploy/--publish에서 역추론. library/none→deploy 제외, app/none→publish 제외)
+      --label-style STYLE  상태 라벨 표기: en (status: todo) | ko (기존 작업전)
+      --language LANG      레포에 쓰이는 이슈/PR 템플릿 언어: en | ko
       --deploy TARGET      배포 방식 택1: docker-ssh(기본) | vercel | none
       --publish CSV        publish 타겟 csv: nexus,npm,github-packages (기본: 없음)
       --deploy-branch NAME 릴리스 PR head 브랜치 (#456, 기본: develop). default_branch와 별개
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --ai-summary / --no-ai-summary         PR 변경 요약 워크플로우 포함/제외
+      --projects-sync / --no-projects-sync   GitHub Projects 상태 동기화 워크플로우 포함/제외 (신규 설치 기본 제외)
       --nexus / --npm-publish  (deprecated — --publish nexus / --publish npm 사용)
-      --force              모든 확인 생략, 비대화형 기본값 사용
+      --force, -y, --yes   모든 확인 생략, 비대화형 기본값 사용
+      --lang en|ko         화면 언어 (기본: 시스템 언어, CI/--force 는 en 고정)
   -v, --version            projectops 버전 출력
   -h, --help               이 도움말 표시
 
@@ -32,3 +76,7 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
   npx projectops --mode doctor                       # 설정 진단
   GITHUB_TOKEN=ghp_... npx projectops --mode doctor  # 저장소 설정까지 진단
 `;
+
+export function helpText(lang = getLang()) {
+  return lang === "ko" ? HELP_KO : HELP_EN;
+}

package/src/commands/doctor.js

@@ -19,8 +19,10 @@ import { parseExisting } from "../core/version-yml.js";
 import { verifyInstall } from "../core/verify.js";
 import { readBaseline } from "../core/baseline.js";
 import { detectRepoName } from "../core/detect-fs.js";
+import { t } from "../i18n/index.js";
 
-const PERM_PURPOSE = "자동 커밋·태그·후속 워크플로우 실행";
+// 언어 전환(withLang 등) 시점에 평가되도록 함수로 둔다
+const permPurpose = () => t("doctor.perm.purpose");
 
 // GitHub REST 호출. 실패는 예외가 아니라 {ok:false}로 돌려 진단이 중단되지 않게 한다.
 async function gh(path, token) {
@@ -57,46 +59,46 @@ export function localChecks(cwd = ".") {
   const existing = existsSync(vyPath) ? parseExisting(readFileSync(vyPath, "utf8")) : null;
 
   if (!existing) {
-    add({ name: "통합 상태", purpose: "이 폴더의 템플릿 설치 여부", status: "INFO",
-          value: "version.yml 없음",
-          detail: ["이 폴더에는 템플릿이 통합되어 있지 않습니다.",
-                   "통합하려면: npx projectops"] });
+    add({ name: t("doctor.integ.name"), purpose: t("doctor.integ.purpose"), status: "INFO",
+          value: t("doctor.integ.noVersionYml"),
+          detail: [t("doctor.integ.notIntegrated"),
+                   t("doctor.integ.howTo")] });
     return rows; // 통합 전이면 나머지 점검이 의미 없다
   }
 
-  add({ name: "통합 상태", purpose: "이 폴더의 템플릿 설치 여부", status: "OK",
-        value: `템플릿 v${existing.templateVersion || "unknown"} / 프로젝트 v${existing.version}` });
+  add({ name: t("doctor.integ.name"), purpose: t("doctor.integ.purpose"), status: "OK",
+        value: t("doctor.integ.versions", { tpl: existing.templateVersion || "unknown", proj: existing.version }) });
 
   const wfDir = join(cwd, PATHS.workflowsDir);
   const files = existsSync(wfDir)
     ? readdirSync(wfDir).filter((f) => /\.ya?ml$/.test(f))
     : [];
-  add({ name: "설치된 워크플로우", purpose: "이 저장소에서 도는 자동화", status: files.length ? "OK" : "WARN",
-        value: `${files.length}개`,
-        detail: files.length ? null : ["워크플로우가 하나도 없습니다.",
-                                       "통합 모드를 workflows 또는 full로 다시 실행해 보세요."] });
+  add({ name: t("doctor.wf.name"), purpose: t("doctor.wf.purpose"), status: files.length ? "OK" : "WARN",
+        value: t("doctor.count", { n: files.length }),
+        detail: files.length ? null : [t("doctor.wf.none"),
+                                       t("doctor.wf.noneHint")] });
 
   // 치환·Secret 판정은 설치 후 검증(#549)과 같은 모듈을 쓴다 — 두 곳에 두면 기준이 갈라진다.
   const v = verifyInstall(cwd);
   add({
-    name: "치환되지 않은 값", purpose: "배포 시점에 실패할 자리",
+    name: t("doctor.unres.name"), purpose: t("doctor.unres.purpose"),
     status: v.unresolved.length === 0 ? "OK" : "WARN",
-    value: v.unresolved.length === 0 ? "없음" : `${v.unresolved.length}건`,
+    value: v.unresolved.length === 0 ? t("doctor.none") : t("doctor.cases", { n: v.unresolved.length }),
     detail: v.unresolved.length === 0 ? null : [
-      "아래 위치에 템플릿 값이 그대로 남아 있습니다.",
+      t("doctor.unres.intro"),
       ...v.unresolved.slice(0, 8).map((u) => `  ${u.filename}:${u.line}  ${u.token}`),
-      ...(v.unresolved.length > 8 ? [`  … 외 ${v.unresolved.length - 8}건`] : []),
-      "그대로 두면 해당 워크플로우가 배포 단계에서 실패합니다. 직접 값을 채워주세요.",
+      ...(v.unresolved.length > 8 ? [t("doctor.unres.more", { n: v.unresolved.length - 8 })] : []),
+      t("doctor.unres.outro"),
     ],
   });
 
   const secretNames = [...v.secrets.keys()];
   add({
-    name: "필요한 Secret", purpose: "설치된 워크플로우가 요구하는 값",
-    status: "INFO", value: secretNames.length ? `${secretNames.length}개` : "없음",
+    name: t("doctor.sec.name"), purpose: t("doctor.sec.purpose"),
+    status: "INFO", value: secretNames.length ? t("doctor.count", { n: secretNames.length }) : t("doctor.none"),
     detail: secretNames.length ? [
-      ...secretNames.map((n) => `  ${n}  ← ${v.secrets.get(n).length}개 워크플로우`),
-      "쓰지 않는 워크플로우의 값은 등록하지 않아도 됩니다.",
+      ...secretNames.map((n) => t("doctor.sec.line", { name: n, n: v.secrets.get(n).length })),
+      t("doctor.sec.skipUnused"),
     ] : null,
   });
 
@@ -107,16 +109,16 @@ export function localChecks(cwd = ".") {
   const hasSummaryWf = files.some((f) => /AI-PR-SUMMARY|RELEASE-CHANGELOG/.test(f));
   if (hasSummaryWf) {
     add({
-      name: "AI 요약 키", purpose: "릴리스 노트를 AI로 다듬을지 (선택)",
-      status: "INFO", value: "선택 사항",
+      name: t("doctor.ai.name"), purpose: t("doctor.ai.purpose"),
+      status: "INFO", value: t("doctor.ai.optional"),
       detail: [
-        "등록하지 않아도 릴리스 노트는 나옵니다 — 커밋 내용을 분석해 만듭니다.",
-        "AI가 다듬은 문장을 원하면 아래 중 하나를 저장소 Secret에 등록하세요.",
-        "  GEMINI_API_KEY     무료 · https://aistudio.google.com/apikey",
-        "  GROQ_API_KEY       무료",
-        "  MISTRAL_API_KEY    무료",
-        "  OPENAI_API_KEY / ANTHROPIC_API_KEY   유료",
-        "등록한 것이 자동으로 쓰입니다. 별도 설정은 필요 없습니다.",
+        t("doctor.ai.l1"),
+        t("doctor.ai.l2"),
+        t("doctor.ai.gemini"),
+        t("doctor.ai.groq"),
+        t("doctor.ai.mistral"),
+        t("doctor.ai.paid"),
+        t("doctor.ai.l3"),
       ],
     });
   }
@@ -135,26 +137,26 @@ export function localChecks(cwd = ".") {
   }
   if (files.length) {
     add({
-      name: "워크플로우 권한 선언", purpose: "다른 워크플로우를 실행할 권한",
+      name: t("doctor.pd.name"), purpose: t("doctor.pd.purpose"),
       status: needsActionsWrite.length ? "WARN" : "OK",
-      value: needsActionsWrite.length ? `${needsActionsWrite.length}건 누락` : "정상",
+      value: needsActionsWrite.length ? t("doctor.pd.missing", { n: needsActionsWrite.length }) : t("doctor.ok"),
       detail: needsActionsWrite.length ? [
         ...needsActionsWrite.map((f) => `  ${f}`),
-        "다른 워크플로우를 실행하는데 permissions에 'actions: write'가 없습니다.",
-        "저장소 설정이 Read and write여도 이 선언이 없으면 API가 403을 반환합니다.",
-        "조치: 해당 파일의 permissions 블록에 'actions: write' 추가",
+        t("doctor.pd.l1"),
+        t("doctor.pd.l2"),
+        t("doctor.pd.l3"),
       ] : null,
     });
   }
 
   const baseline = readBaseline(cwd);
   add({
-    name: "업데이트 기준점", purpose: "다음 업데이트가 내 수정을 구분할 근거",
+    name: t("doctor.bl.name"), purpose: t("doctor.bl.purpose"),
     status: baseline ? "OK" : "INFO",
-    value: baseline ? `${Object.keys(baseline.files).length}개 파일 기록됨` : "없음",
+    value: baseline ? t("doctor.bl.recorded", { n: Object.keys(baseline.files).length }) : t("doctor.none"),
     detail: baseline ? null : [
-      "기준점이 없어 다음 업데이트는 변경된 파일을 모두 물어봅니다.",
-      "통합을 한 번 실행하면 기록되고, 그 다음 업데이트부터 내 수정과 템플릿 개선을 구분합니다.",
+      t("doctor.bl.l1"),
+      t("doctor.bl.l2"),
     ],
   });
 
@@ -177,27 +179,27 @@ export async function remoteChecks(slug, token, requiredSecrets = [], undeclared
 
   const perm = await gh(`/repos/${slug}/actions/permissions/workflow`, token);
   if (!perm.ok) {
-    add({ name: "Workflow permissions", purpose: PERM_PURPOSE, status: "INFO",
-          value: perm.status === 403 ? "조회 권한 없음" : "조회 실패",
-          detail: ["토큰에 저장소 관리 권한이 없어 확인하지 못했습니다.",
-                   "Settings > Actions > General > Workflow permissions 에서 직접 확인하세요."] });
+    add({ name: "Workflow permissions", purpose: permPurpose(), status: "INFO",
+          value: perm.status === 403 ? t("doctor.rm.noAccess") : t("doctor.rm.failed"),
+          detail: [t("doctor.rm.permNoAdmin"),
+                   t("doctor.rm.permCheck")] });
   } else if (perm.data?.default_workflow_permissions === "write") {
-    add({ name: "Workflow permissions", purpose: PERM_PURPOSE, status: "OK",
+    add({ name: "Workflow permissions", purpose: permPurpose(), status: "OK",
           value: "Read and write permissions" });
   } else if (undeclared.length === 0) {
     // 모든 워크플로우가 permissions 를 스스로 선언 → 저장소 기본값(read)은 실제 동작에 영향이 없다
-    add({ name: "Workflow permissions", purpose: PERM_PURPOSE, status: "INFO",
-          value: "읽기 전용 (워크플로우가 권한을 직접 선언해 영향 없음)",
-          detail: ["설치된 워크플로우가 permissions 를 모두 선언하고 있어 기본값이 읽기 전용이어도 정상 동작합니다."] });
+    add({ name: "Workflow permissions", purpose: permPurpose(), status: "INFO",
+          value: t("doctor.rm.roOk"),
+          detail: [t("doctor.rm.roOkDetail")] });
   } else {
     add({
-      name: "Workflow permissions", purpose: PERM_PURPOSE, status: "WARN",
-      value: "Read repository contents permission (읽기 전용)",
+      name: "Workflow permissions", purpose: permPurpose(), status: "WARN",
+      value: t("doctor.rm.roWarn"),
       detail: [
-        "permissions 선언이 없는 워크플로우는 저장소에 쓰거나 다른 워크플로우를 실행할 수 없습니다.",
+        t("doctor.rm.l1"),
         ...undeclared.map((f) => `  ${f}`),
-        "조치: 해당 파일에 permissions 블록을 추가하거나",
-        "      Settings > Actions > General > Workflow permissions → 'Read and write permissions' 선택",
+        t("doctor.rm.fix1"),
+        t("doctor.rm.fix2"),
       ],
     });
   }
@@ -206,13 +208,13 @@ export async function remoteChecks(slug, token, requiredSecrets = [], undeclared
   if (repo.ok) {
     const allowed = repo.data?.allow_merge_commit === true;
     add({
-      name: "merge commit 허용", purpose: "릴리스 PR 자동 머지 조건",
+      name: t("doctor.mc.name"), purpose: t("doctor.mc.purpose"),
       status: allowed ? "OK" : "WARN",
-      value: allowed ? "허용됨" : "꺼져 있음",
+      value: allowed ? t("doctor.mc.on") : t("doctor.mc.off"),
       detail: allowed ? null : [
-        "릴리스 PR 자동 머지는 merge commit 방식을 사용합니다.",
-        "꺼져 있으면 자동 머지가 실패하고 PR이 열린 채 남습니다.",
-        "조치: Settings > General > Pull Requests → 'Allow merge commits' 체크",
+        t("doctor.mc.l1"),
+        t("doctor.mc.l2"),
+        t("doctor.mc.fix"),
       ],
     });
   }
@@ -220,35 +222,35 @@ export async function remoteChecks(slug, token, requiredSecrets = [], undeclared
   if (requiredSecrets.length) {
     const sec = await gh(`/repos/${slug}/actions/secrets?per_page=100`, token);
     if (!sec.ok) {
-      add({ name: "Secret 등록 여부", purpose: "배포에 필요한 값", status: "INFO",
-            value: "조회 권한 없음",
-            detail: ["토큰에 Secret 조회 권한이 없어 확인하지 못했습니다."] });
+      add({ name: t("doctor.sr.name"), purpose: t("doctor.sr.purpose"), status: "INFO",
+            value: t("doctor.rm.noAccess"),
+            detail: [t("doctor.sr.noAccess")] });
     } else {
       const have = new Set((sec.data?.secrets || []).map((s) => s.name));
 
       // AI 요약 키가 실제로 등록돼 있는지 (#569) — 있으면 어느 서비스인지까지 보여준다.
       const AI_KEYS = { GEMINI_API_KEY: "Gemini", OPENAI_API_KEY: "OpenAI", ANTHROPIC_API_KEY: "Anthropic",
-                        GROQ_API_KEY: "Groq", MISTRAL_API_KEY: "Mistral", MODEL_API_KEY: "구 이름(서비스 자동 추정)" };
+                        GROQ_API_KEY: "Groq", MISTRAL_API_KEY: "Mistral", MODEL_API_KEY: t("doctor.air.legacy") };
       const foundAi = Object.entries(AI_KEYS).filter(([n]) => have.has(n));
       rows.push({
-        name: "AI 요약 키 등록", purpose: "릴리스 노트를 AI로 다듬을지 (선택)",
+        name: t("doctor.air.name"), purpose: t("doctor.ai.purpose"),
         status: "INFO",
-        value: foundAi.length ? foundAi.map(([n, label]) => `${n} (${label})`).join(", ") : "없음 — 커밋 분석으로 동작",
+        value: foundAi.length ? foundAi.map(([n, label]) => `${n} (${label})`).join(", ") : t("doctor.air.none"),
         detail: foundAi.length ? null : [
-          "등록하지 않아도 릴리스 노트는 정상적으로 나옵니다.",
-          "AI를 쓰려면 GEMINI_API_KEY(무료)를 등록하세요 — https://aistudio.google.com/apikey",
+          t("doctor.air.l1"),
+          t("doctor.air.l2"),
         ],
       });
       // AI 키는 위에서 따로 안내하는 선택 항목이다 — '배포에 필요한 값' 미등록 목록에 섞으면 필수처럼 읽힌다 (#723)
       const missing = requiredSecrets.filter((n) => !have.has(n) && !(n in AI_KEYS));
       add({
-        name: "Secret 등록 여부", purpose: "배포에 필요한 값",
+        name: t("doctor.sr.name"), purpose: t("doctor.sr.purpose"),
         status: missing.length ? "WARN" : "OK",
-        value: missing.length ? `${missing.length}개 미등록` : "전부 등록됨",
+        value: missing.length ? t("doctor.sr.missing", { n: missing.length }) : t("doctor.sr.all"),
         detail: missing.length ? [
           ...missing.map((n) => `  ${n}`),
-          "해당 워크플로우를 쓰지 않는다면 등록하지 않아도 됩니다.",
-          "조치: Settings > Secrets and variables > Actions > New repository secret",
+          t("doctor.sr.l1"),
+          t("doctor.sr.fix"),
         ] : null,
       });
     }
@@ -261,7 +263,7 @@ export async function remoteChecks(slug, token, requiredSecrets = [], undeclared
 const ICON = { OK: "✅", WARN: "⚠️", FAIL: "❌", INFO: "ℹ️" };
 
 export function renderRows(rows, write = (s) => process.stderr.write(s + "\n")) {
-  const head = (r) => `${r.name}${r.purpose ? ` — ${r.purpose}` : ""}`;
+  const head = (r) => `${r.name}${r.purpose ? ` - ${r.purpose}` : ""}`;
   for (const r of rows) {
     write(`${ICON[r.status] || "·"} ${head(r)}: ${r.value}`);
     // 정상 항목은 한 줄로 압축한다. 펼치는 것은 사용자가 무언가 해야 할 때뿐이다.
@@ -273,8 +275,8 @@ export function renderRows(rows, write = (s) => process.stderr.write(s + "\n"))
   const warn = rows.filter((r) => r.status === "WARN" || r.status === "FAIL").length;
   write("");
   write(warn === 0
-    ? "확인된 문제 없음."
-    : `살펴볼 항목 ${warn}건. 위 조치를 참고하세요 (쓰지 않는 기능이라면 넘어가도 됩니다).`);
+    ? t("doctor.render.clean")
+    : t("doctor.render.warn", { n: warn }));
   return warn;
 }
 
@@ -282,24 +284,24 @@ export function renderRows(rows, write = (s) => process.stderr.write(s + "\n"))
 export async function runDoctor({ cwd = ".", token = process.env.GITHUB_TOKEN || "" } = {}) {
   const write = (s) => process.stderr.write(s + "\n");
   write("");
-  write("projectops doctor — 통합 상태 및 저장소 설정 진단");
+  write(t("doctor.title"));
   write("────────────────────────────────────────");
   write("");
 
   const rows = localChecks(cwd);
   const slug = detectSlug(cwd);
   const repoName = detectRepoName(cwd);
-  rows.push({ name: "GitHub 원격", purpose: "점검 대상 저장소", status: slug ? "OK" : "INFO",
-              value: slug || `origin 없음${repoName ? ` (폴더명: ${repoName})` : ""}`,
-              detail: slug ? null : ["원격 저장소를 찾지 못해 저장소 설정은 점검하지 않습니다."] });
+  rows.push({ name: t("doctor.gh.name"), purpose: t("doctor.gh.purpose"), status: slug ? "OK" : "INFO",
+              value: slug || t("doctor.gh.noOrigin", { folder: repoName ? t("doctor.gh.folder", { name: repoName }) : "" }),
+              detail: slug ? null : [t("doctor.gh.noRemote")] });
 
   if (slug && token) {
     const v = verifyInstall(cwd);
     rows.push(...await remoteChecks(slug, token, [...v.secrets.keys()], workflowsWithoutPermissions(cwd)));
   } else if (slug) {
-    rows.push({ name: "저장소 설정 점검", purpose: "권한·머지 방식·Secret", status: "INFO",
-                value: "건너뜀 (토큰 없음)",
-                detail: ["GITHUB_TOKEN 환경변수를 주면 저장소 설정까지 점검합니다.",
+    rows.push({ name: t("doctor.skip.name"), purpose: t("doctor.skip.purpose"), status: "INFO",
+                value: t("doctor.skip.value"),
+                detail: [t("doctor.skip.l1"),
                          "  GITHUB_TOKEN=ghp_... npx projectops --mode doctor"] });
   }