project-auto-wizard 0.13.3 → 0.15.0

package/src/commands/doctor.js

@@ -1,14 +1,14 @@
-// doctor 명령 — 로컬 환경 진단(읽기 전용, 규칙 기반). gh CLI에 위임해 원격 상태를 점검한다.
+// doctor command: local environment diagnosis (read-only, rule-based). Delegates to the gh CLI to check remote state.
 //
-// 출력 설계 — `flutter doctor` 패턴을 차용한다.
-//   ① 항목 라벨에 purpose("무엇을 위한 설정인지")를 병기한다. `WORKFLOW_PAT`만 보고는 그게
-//      자기 릴리스 흐름의 무엇을 담당하는지 알 수 없다 — flutter의
-//      `Android toolchain - develop for Android devices`와 같은 이유다.
-//   ② 도구가 "설치해도 된다/안 된다"를 판정하지 않는다. 발견한 사실(문제 N개)만 진술하고
-//      그게 자신에게 문제인지는 사용자가 판단한다.
-//   ③ 문제 항목만 `현상 → 영향 → 조치 → 문서` 4단으로 펼치고, 정상 항목은 한 줄로 압축한다.
-//   ④ GitHub 설정 화면에 실제로 표시되는 문자열("Read and write permissions" 등)은 번역하지
-//      않는다. 번역하면 설명은 읽히지만 정작 화면에서 그 항목을 찾지 못한다.
+// Output design, borrowed from the `flutter doctor` pattern.
+//   1. Each item label carries its purpose ("what this setting is for"). `WORKFLOW_PAT` alone does not tell
+//      what it does in the release flow, the same reason flutter prints
+//      `Android toolchain - develop for Android devices`.
+//   2. The tool never judges "OK to install / not OK". It only states the facts found (N problems) and
+//      leaves it to the user whether they matter.
+//   3. Only problem items unfold into 4 levels (symptom -> impact -> action -> docs); healthy items collapse to one line.
+//   4. Strings actually shown in the GitHub settings UI ("Read and write permissions", etc.) are not
+//      translated: a translation reads well but then the item cannot be found on the real screen.
 import { spawnSync } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -16,33 +16,32 @@ import { A, paint, colorEnabled, visualWidth } from "../ui/ansi.js";
 import { PATHS } from "../core/paths.js";
 import { parseExisting } from "../core/version-yml.js";
 import { hooksFor } from "../core/types.js";
+import { t } from "../i18n/index.js";
 
 const defaultExec = (cmd, args) => spawnSync(cmd, args, { encoding: "utf8" });
 
-// 해결 가이드 링크. 문서 사이트 페이지 안의 영문 HTML 앵커를 가리킨다 — 한글 헤딩
-// 자동 앵커는 URL 인코딩되어 터미널에서 알아볼 수 없게 깨진다.
-// 진단 출력이 한국어이므로 한국어 페이지(/ko/)로 연결한다.
+// Resolution guide links. They point at English HTML anchors inside the docs site pages: auto-generated
+// anchors from non-Latin headings get URL-encoded and become unreadable in a terminal.
+// Getters so the link follows the output language (the localized page path comes from the catalog).
 export const DOCS_SITE_URL = "https://twin-fang.github.io/project-auto-wizard";
 export const DOC = {
-  postInstall: `${DOCS_SITE_URL}/ko/start/quickstart/#post-install`,
-  flutterStore: `${DOCS_SITE_URL}/ko/project-types/flutter/#flutter-store`,
+  get postInstall() { return `${DOCS_SITE_URL}${t("cmd.doctor.docPath.postInstall")}`; },
+  get flutterStore() { return `${DOCS_SITE_URL}${t("cmd.doctor.docPath.flutterStore")}`; },
 };
 
 export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   const results = [];
-  // name은 항목 식별자(테스트·프로그램 참조용), label은 화면 표기용. label 생략 시 name을 쓴다.
+  // name is the item identifier (for tests/programmatic reference), label is for display. Falls back to name when label is omitted.
   const add = (item) => { results.push({ actions: [], ...item }); return results; };
 
   const installed = existsSync(join(cwd, "version.yml"));
-  // 미설치는 문제가 아니다 — doctor는 설치 "전에" 돌려보는 것이 정상 사용 경로다.
+  // Not installed is not a problem: running doctor "before" installing is the normal usage path.
+  const installItem = { name: t("cmd.doctor.install.name"), label: t("cmd.doctor.install.label"), purpose: t("cmd.doctor.install.purpose") };
   add(installed
-    ? { name: "설치 여부", label: "설치 상태", purpose: "이 폴더의 마법사 설치 여부", status: "OK", value: "version.yml 있음" }
-    : {
-      name: "설치 여부", label: "설치 상태", purpose: "이 폴더의 마법사 설치 여부", status: "INFO",
-      note: ["이 폴더엔 아직 설치되지 않았습니다 — 지금 설치하면 됩니다."],
-    });
+    ? { ...installItem, status: "OK", value: t("cmd.doctor.install.value") }
+    : { ...installItem, status: "INFO", note: [t("cmd.doctor.install.note")] });
 
-  // 타입별 로컬 파일 점검(예: Flutter 스토어 배포 파일) — 로컬 파일만 보므로 gh 조회 결과와 무관하게 수행한다.
+  // Per-type local file checks (e.g. Flutter store deploy files): only local files are read, so this runs regardless of the gh lookup results.
   if (installed) {
     const existing = parseExisting(readFileSync(join(cwd, PATHS.versionFile), "utf8"));
     for (const { hook } of hooksFor(existing.types, "doctorChecks")) {
@@ -53,41 +52,41 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   const ghVersion = exec("gh", ["--version"]);
   if (ghVersion.error || ghVersion.status !== 0) {
     add({
-      name: "gh CLI", purpose: "레포 설정 조회용", status: "WARN",
-      value: "gh CLI를 찾을 수 없습니다.",
-      impact: ["레포 권한·secret 설정을 조회할 수 없어 아래 원격 점검을 모두 건너뜁니다."],
-      actions: ["https://cli.github.com/ 에서 gh CLI를 설치한 뒤 다시 실행하세요"],
+      name: "gh CLI", purpose: t("cmd.doctor.gh.purpose"), status: "WARN",
+      value: t("cmd.doctor.gh.notFound"),
+      impact: [t("cmd.doctor.gh.notFoundImpact")],
+      actions: [t("cmd.doctor.gh.notFoundAction")],
     });
     return results;
   }
   add({
-    name: "gh CLI", purpose: "레포 설정 조회용", status: "OK",
-    value: (ghVersion.stdout || "").split("\n")[0] || "설치됨",
+    name: "gh CLI", purpose: t("cmd.doctor.gh.purpose"), status: "OK",
+    value: (ghVersion.stdout || "").split("\n")[0] || t("cmd.doctor.gh.installed"),
   });
 
   const auth = exec("gh", ["auth", "status"]);
   const authOk = !auth.error && auth.status === 0;
   if (!authOk) {
     add({
-      name: "gh 인증", label: "GitHub 로그인", purpose: "레포 설정 조회 권한", status: "FAIL",
-      value: "로그인되어 있지 않습니다.",
-      impact: ["레포 설정을 읽을 수 없어 아래 원격 점검을 모두 건너뜁니다."],
-      actions: ["터미널에서 `gh auth login` 실행"],
+      name: t("cmd.doctor.auth.name"), label: t("cmd.doctor.auth.label"), purpose: t("cmd.doctor.auth.purpose"), status: "FAIL",
+      value: t("cmd.doctor.auth.notLoggedIn"),
+      impact: [t("cmd.doctor.auth.impact")],
+      actions: [t("cmd.doctor.auth.action")],
     });
     return results;
   }
-  add({ name: "gh 인증", label: "GitHub 로그인", purpose: "레포 설정 조회 권한", status: "OK", value: "인증됨" });
+  add({ name: t("cmd.doctor.auth.name"), label: t("cmd.doctor.auth.label"), purpose: t("cmd.doctor.auth.purpose"), status: "OK", value: t("cmd.doctor.auth.ok") });
 
   const remote = exec("git", ["-C", cwd, "remote", "get-url", "origin"]);
   const url = remote.status === 0 ? (remote.stdout || "").trim() : "";
-  // 레포 이름에는 점이 올 수 있다(user.github.io, next.js) — 끝의 .git만 떼어낸다.
+  // Repo names may contain dots (user.github.io, next.js); strip only the trailing .git.
   const match = url.match(/github\.com[:/]([^/]+)\/([^/]+?)(\.git)?\/?$/);
   if (!match) {
     add({
-      name: "GitHub 원격", purpose: "점검 대상 레포 식별", status: "WARN",
-      value: "origin 리모트에서 GitHub owner/repo를 찾지 못했습니다.",
-      impact: ["어느 레포를 점검해야 할지 알 수 없어 아래 원격 점검을 모두 건너뜁니다."],
-      actions: ["`git remote -v`로 origin이 GitHub 주소를 가리키는지 확인하세요"],
+      name: t("cmd.doctor.remote.name"), purpose: t("cmd.doctor.remote.purpose"), status: "WARN",
+      value: t("cmd.doctor.remote.notFound"),
+      impact: [t("cmd.doctor.remote.impact")],
+      actions: [t("cmd.doctor.remote.action")],
     });
     return results;
   }
@@ -95,30 +94,30 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
 
   const perm = exec("gh", ["api", `repos/${owner}/${repo}/actions/permissions/workflow`, "--jq", ".default_workflow_permissions"]);
   const permValue = (perm.stdout || "").trim();
-  // 이 값은 "워크플로우가 permissions를 생략했을 때 적용되는 기본값"이지 상한이 아니다.
-  // 마법사가 설치하는 워크플로우는 전부 자체 permissions를 선언하므로(회귀 가드:
-  // tests/node/payload-workflow-permissions.test.js) read여도 정상 동작한다 — 이 레포 자체가
-  // read인데 VERSION-CONTROL이 버전 커밋 push에 성공하는 것이 그 증거다.
-  const PERM_PURPOSE = "직접 추가한 워크플로우의 기본 권한";
+  // This value is the "default applied when a workflow omits permissions", not an upper bound.
+  // Every workflow the wizard installs declares its own permissions (regression guard:
+  // tests/node/payload-workflow-permissions.test.js), so it works even with read; this repo itself is
+  // read and VERSION-CONTROL still succeeds in pushing the version commit, which is the proof.
+  const PERM_PURPOSE = t("cmd.doctor.perm.purpose");
   if (perm.status !== 0) {
-    // 조회 실패는 오진이 아니라 실제로 정보를 얻지 못한 상태다 — 관리자 확인이라는 조치가 있다.
+    // A failed lookup is not a misdiagnosis but a real lack of information; the action is to ask an admin.
     add({
       name: "Workflow permissions", purpose: PERM_PURPOSE, status: "WARN",
-      value: "설정을 조회하지 못했습니다.",
-      impact: ["레포 관리자 권한이 없으면 이 설정은 조회되지 않습니다 — 값 자체는 정상일 수 있습니다."],
-      actions: ["레포 관리자에게 Settings → Actions → General → Workflow permissions 값을 확인하세요"],
+      value: t("cmd.doctor.perm.lookupFailed"),
+      impact: [t("cmd.doctor.adminImpact")],
+      actions: [t("cmd.doctor.perm.action")],
       doc: DOC.postInstall,
     });
   } else if (permValue === "write") {
     add({ name: "Workflow permissions", purpose: PERM_PURPOSE, status: "OK", value: "Read and write" });
   } else {
-    // 조치가 필요 없으므로 WARN이 아니라 INFO다. 경고로 띄우면 없는 장애를 알리고
-    // 불필요한 권한 상향을 유도해 최소 권한 원칙에 역행한다.
+    // No action is needed, so this is INFO rather than WARN. A warning would announce a nonexistent problem
+    // and push users toward an unnecessary permission increase, against the least-privilege principle.
     add({
       name: "Workflow permissions", purpose: PERM_PURPOSE, status: "INFO",
       note: [
-        `현재 ${permValue || "확인불가"} 입니다 — 마법사가 설치한 워크플로우는 각자 권한을 선언하므로 그대로 동작합니다.`,
-        "직접 추가한 워크플로우에서 permissions를 생략했다면 이 기본값을 따르므로, 그때만 Read and write로 올리세요.",
+        t("cmd.doctor.perm.infoCurrent", { value: permValue || t("cmd.doctor.perm.unknown") }),
+        t("cmd.doctor.perm.infoAdvice"),
       ],
     });
   }
@@ -126,63 +125,65 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   const secrets = exec("gh", ["secret", "list", "--repo", `${owner}/${repo}`]);
   const hasPat = secrets.status === 0 && (secrets.stdout || "").split("\n").some((l) => l.startsWith("WORKFLOW_PAT"));
   add(hasPat
-    ? { name: "WORKFLOW_PAT secret", label: "WORKFLOW_PAT", purpose: "자동 태그·Release 발행", status: "OK", value: "등록됨" }
+    ? { name: "WORKFLOW_PAT secret", label: "WORKFLOW_PAT", purpose: t("cmd.doctor.pat.purpose"), status: "OK", value: t("cmd.doctor.pat.registered") }
     : {
-      // 조치가 필요 없으므로 WARN이 아니라 INFO다 — 위 Workflow permissions 항목과 동일 이유:
-      // 폴백(wait-for-merge-and-trigger-release / Trigger NPM-PUBLISH)이 GITHUB_TOKEN만으로
-      // 파이프라인을 끝까지 이어가므로, 없는 장애를 경고로 띄우지 않는다.
-      name: "WORKFLOW_PAT secret", label: "WORKFLOW_PAT", purpose: "자동 태그·Release 발행", status: "INFO",
-      note: [
-        "secret이 없어도 폴백이 자동으로 이어받아 태그·Release 발행과 main 배포 워크플로우 실행까지 진행됩니다 — 실제 병합 후 최대 ~20초 정도 더 걸릴 뿐입니다.",
-        "속도를 더 원한다면 PAT을 등록할 수 있습니다 — 반드시 개인 계정이 아닌 조직 bot/machine 계정으로 발급하세요 (scopes: repo, workflow).",
-        "등록: 레포 Settings → Secrets and variables → Actions → New repository secret · 이름은 WORKFLOW_PAT",
-      ],
+      // No action is needed, so this is INFO rather than WARN, for the same reason as the Workflow permissions
+      // item above: the fallback (wait-for-merge-and-trigger-release / Trigger NPM-PUBLISH) carries the
+      // pipeline through to the end with GITHUB_TOKEN alone, so a nonexistent problem is not raised as a warning.
+      name: "WORKFLOW_PAT secret", label: "WORKFLOW_PAT", purpose: t("cmd.doctor.pat.purpose"), status: "INFO",
+      note: [t("cmd.doctor.pat.note1"), t("cmd.doctor.pat.note2"), t("cmd.doctor.pat.note3")],
     });
 
   const mergeSettings = exec("gh", ["api", `repos/${owner}/${repo}`, "--jq", ".allow_merge_commit"]);
   const automergeOk = mergeSettings.status === 0 && mergeSettings.stdout.trim() === "true";
+  const mergeItem = { name: t("cmd.doctor.merge.name"), label: t("cmd.doctor.merge.label"), purpose: t("cmd.doctor.merge.purpose") };
   if (mergeSettings.status !== 0) {
     add({
-      name: "automerge 호환성(merge commit 허용)", label: "merge commit 허용", purpose: "릴리스 PR 자동 머지 조건", status: "WARN",
-      value: "설정을 조회하지 못했습니다.",
-      impact: ["레포 관리자 권한이 없으면 이 설정은 조회되지 않습니다 — 값 자체는 정상일 수 있습니다."],
-      actions: ["레포 관리자에게 Settings → General → Pull Requests 설정을 확인하세요"],
+      ...mergeItem, status: "WARN",
+      value: t("cmd.doctor.merge.lookupFailed"),
+      impact: [t("cmd.doctor.adminImpact")],
+      actions: [t("cmd.doctor.merge.lookupAction")],
       doc: DOC.postInstall,
     });
   } else if (automergeOk) {
-    add({ name: "automerge 호환성(merge commit 허용)", label: "merge commit 허용", purpose: "릴리스 PR 자동 머지 조건", status: "OK", value: "허용됨" });
+    add({ ...mergeItem, status: "OK", value: t("cmd.doctor.merge.allowed") });
   } else {
     add({
-      name: "automerge 호환성(merge commit 허용)", label: "merge commit 허용", purpose: "릴리스 PR 자동 머지 조건", status: "WARN",
-      value: "이 레포는 merge commit이 꺼져 있습니다.",
-      impact: ["RELEASE-PUBLISH가 머지 커밋 제목으로 릴리스를 감지하므로 자동 머지 흐름이 어긋날 수 있습니다."],
+      ...mergeItem, status: "WARN",
+      value: t("cmd.doctor.merge.disabled"),
+      impact: [t("cmd.doctor.merge.impact")],
       actions: [
-        "레포 Settings → General → Pull Requests",
-        "Allow merge commits 체크",
+        t("cmd.doctor.merge.action1"),
+        t("cmd.doctor.merge.action2"),
       ],
       doc: DOC.postInstall,
     });
   }
 
-  // 실제 설정값을 보여준다 — 켜 둔 사용자에게 "꺼져 있다"고 안내하면 현재 상태를 오해하게 된다.
+  // Show the actual setting: telling a user who turned it on that it is off would misrepresent the current state.
   const copilotAi = installed ? parseExisting(readFileSync(join(cwd, "version.yml"), "utf8")).options.copilotAi : null;
   const copilotState = copilotAi === true
-    ? "켜져 있습니다 (version.yml의 copilot_ai: true)."
+    ? t("cmd.doctor.copilot.on")
     : copilotAi === false
-      ? "꺼져 있습니다 (version.yml의 copilot_ai: false) — 켜려면 --copilot으로 다시 설치하거나 대화형 '수정하기 > Copilot AI 요약'을 쓰세요."
-      : "기본은 꺼져 있습니다 (version.yml의 copilot_ai: false).";
+      ? t("cmd.doctor.copilot.off")
+      : t("cmd.doctor.copilot.default");
   add({
-    name: "Copilot AI 요약", label: "Copilot AI 요약", purpose: "AI 릴리스 노트 생성(선택)", status: "INFO",
+    name: t("cmd.doctor.copilot.name"), label: t("cmd.doctor.copilot.name"), purpose: t("cmd.doctor.copilot.purpose"), status: "INFO",
     note: [
       copilotState,
-      `${copilotAi === true ? "" : "켜면 "}GitHub Copilot AI Credits가 소비됩니다 — 조직은 'Allow use of Copilot CLI billed to the organization' 정책이 필요합니다.`,
-      "꺼져 있거나 사용할 수 없으면 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.",
+      t(copilotAi === true ? "cmd.doctor.copilot.creditsOn" : "cmd.doctor.copilot.creditsOff"),
+      t("cmd.doctor.copilot.fallback"),
     ],
   });
 
   return results;
 }
 
+// Exit code for the CLI: 0 when every item is OK/INFO, 1 when any WARN or FAIL item was found.
+// Warnings and errors are not split: both mean "something the workflows rely on needs attention",
+// and a script that wants to tolerate warnings can ignore the code (`|| true`).
+export const doctorExitCode = (results) => (results.some((r) => r.status === "WARN" || r.status === "FAIL") ? 1 : 0);
+
 const asLines = (v) => (Array.isArray(v) ? v : v ? [String(v)] : []);
 const headOf = (r) => `${r.label || r.name}${r.purpose ? ` — ${r.purpose}` : ""}`;
 
@@ -192,9 +193,9 @@ export function printDoctorReport(results, { out = (s) => console.log(s), color
   const problems = results.filter((r) => r.status === "WARN" || r.status === "FAIL");
   const infos = results.filter((r) => r.status === "INFO");
 
-  const lines = ["", `${p("◆", A.cyan)}  ${p("환경 진단", A.bold)} ${p("— project-auto-wizard doctor", A.dim)}`, ""];
+  const lines = ["", `${p("◆", A.cyan)}  ${p(t("cmd.doctor.heading"), A.bold)} ${p("— project-auto-wizard doctor", A.dim)}`, ""];
 
-  // 정상 — 한 줄씩. 값은 라벨 폭에 맞춰 우측으로 정렬한다(CJK 2칸 계산은 visualWidth에 위임).
+  // Healthy items: one line each. Values are aligned to the label width (double-width CJK counting is delegated to visualWidth).
   if (oks.length) {
     const width = Math.max(...oks.map((r) => visualWidth(headOf(r))));
     for (const r of oks) {
@@ -205,18 +206,18 @@ export function printDoctorReport(results, { out = (s) => console.log(s), color
     lines.push("");
   }
 
-  // 문제 — 현상 → 영향 → 조치 → 문서 순으로 펼친다.
+  // Problems: unfold as symptom -> impact -> action -> docs.
   for (const r of problems) {
     const fail = r.status === "FAIL";
     lines.push(`  ${p(fail ? "[✗]" : "[!]", fail ? A.red : A.yellow)} ${p(headOf(r), A.bold)}`);
     if (r.value) lines.push(`      ${p(fail ? "✗" : "✗", fail ? A.red : A.yellow)} ${r.value}`);
     for (const l of asLines(r.impact)) lines.push(`        ${p(l, A.dim)}`);
     for (const a of asLines(r.actions)) lines.push(`      ${p("→", A.cyan)} ${a}`);
-    if (r.doc) lines.push(`      ${p("→", A.cyan)} 자세히: ${p(r.doc, A.dim)}`);
+    if (r.doc) lines.push(`      ${p("→", A.cyan)} ${t("cmd.doctor.details")}${p(r.doc, A.dim)}`);
     lines.push("");
   }
 
-  // 참고 — 조치가 필요 없는 안내.
+  // Notes: guidance that needs no action.
   for (const r of infos) {
     lines.push(`  ${p("[i]", A.gray)} ${headOf(r)}`);
     for (const l of asLines(r.note)) lines.push(`      ${p(l, A.dim)}`);
@@ -227,15 +228,15 @@ export function printDoctorReport(results, { out = (s) => console.log(s), color
   out(lines.join("\n"));
 }
 
-// 요약 — "설치해도 된다"는 판정 대신 발견한 사실만 말한다(flutter doctor의 마지막 줄과 같은 태도).
+// Summary: states only the facts found instead of an "OK to install" verdict (same stance as flutter doctor's last line).
 function summaryLine(problems, p) {
-  if (!problems.length) return `  ${p("✓", A.green)} 문제를 찾지 못했습니다.`;
+  if (!problems.length) return `  ${p("✓", A.green)} ${t("cmd.doctor.summaryNone")}`;
   const n = problems.length;
   if (problems.some((r) => r.status === "FAIL")) {
-    return `  ${p("✗", A.red)} ${n}개 항목에서 문제를 찾았습니다 — 일부 점검은 실행하지 못했습니다.`;
+    return `  ${p("✗", A.red)} ${t("cmd.doctor.summaryFail", { n })}`;
   }
   return [
-    `  ${p("!", A.yellow)} ${n}개 항목에서 문제를 찾았습니다.`,
-    `    설치 자체는 지금 진행할 수 있고, 위 ${n}개는 나중에 설정해도 됩니다.`,
+    `  ${p("!", A.yellow)} ${t("cmd.doctor.summaryWarn", { n })}`,
+    `    ${t("cmd.doctor.summaryWarnNote", { n })}`,
   ].join("\n");
 }

package/src/commands/dry-run.js

@@ -1,5 +1,5 @@
-// --dry-run 미리보기 — 실제 파일을 쓰지 않고 무엇이 바뀔지 계산한다.
-// full/uninstall 두 모드 지원 (부분 설치·되돌리기 모드 제거).
+// --dry-run preview: computes what would change without writing any file.
+// Supports the full/uninstall modes (partial-install and revert modes were removed).
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { PATHS } from "../core/paths.js";
@@ -14,6 +14,7 @@ import { planVersionSection } from "../core/copy/readme.js";
 import { BASELINE_PATH, readBaseline } from "../core/baseline.js";
 import { cleanupWorkflows } from "./full.js";
 import { planGitignore } from "../core/copy/gitignore.js";
+import { t } from "../i18n/index.js";
 
 function versionYmlPreview(context, payloadRoot, targetRoot) {
   const { paths = new Map() } = context;
@@ -24,35 +25,36 @@ function versionYmlPreview(context, payloadRoot, targetRoot) {
   const existingRaw = existsSync(vyPath) ? readFileSync(vyPath, "utf8") : null;
   const extraTopLevel = existingRaw !== null ? parseExisting(existingRaw).extraTopLevel : [];
 
-  // 실제 설치와 같은 렌더 함수를 쓴다 — 각자 조립하면 옵션이 늘 때마다 미리보기가 어긋난다.
+  // Use the same render function as the real install; assembling separately drifts the preview whenever an option is added.
   const wouldBe = renderVersionYml(context, readVersionYmlTemplate(payloadRoot), {
     pathMarkers, extraTopLevel,
   });
-  // 실제 설치와 같은 기준으로 비교한다 — 시각 줄만 다르면 설치도 파일을 다시 쓰지 않는다.
+  // Compare by the same rule as the real install: if only the timestamp lines differ, the install does not rewrite the file either.
   return { existed: existingRaw !== null, changed: existingRaw === null || !sameIgnoringTimestamps(existingRaw, wouldBe) };
 }
 
-// mode: "full" | "uninstall". 읽기 전용 — 아무 파일도 쓰지 않는다.
+// mode: "full" | "uninstall". Read-only: writes no file.
 export function planDryRun(mode, context, payloadRoot, targetRoot = ".") {
   if (mode === "uninstall") {
     return { mode, uninstall: planUninstall(payloadRoot, targetRoot, context.uninstallSelection) };
   }
   const workflows = planWorkflows(context, payloadRoot, targetRoot);
-  // 실제 실행과 같은 정리 판정을 파일을 건드리지 않고 돌린다 — 배포 방식 변경·스토어 해제로 지워지거나
-  // .bak으로 옮겨질 파일이 미리보기에서 빠지면 안 된다. 비대화형 실행이 새로 쓰는 파일은 신규·자동 갱신분이다.
+  // Run the same cleanup decision as the real run without touching files: files deleted or moved to .bak by a
+  // deploy style change or a store deselection must not be missing from the preview. Files a non-interactive
+  // run writes anew are the new and auto-updated ones.
   const justWritten = [...workflows.newFiles, ...workflows.upstreamOnly].map((f) => f.filename);
   const cleanup = cleanupWorkflows(context, payloadRoot, targetRoot, readBaseline(targetRoot), { justWritten, dryRun: true });
-  // .bak이 생기면 실제 실행은 .gitignore에 백업 파일 항목을 보장한다. 비대화형 충돌은 기존 유지라 .bak을 만들지 않는다.
+  // When a .bak appears, the real run ensures a backup-file entry in .gitignore. Non-interactive conflicts keep the existing file, so no .bak is made.
   const backedUp = Object.values(cleanup).some((r) => r.backedUp.length > 0);
   return {
     mode,
     workflows,
     cleanup,
     gitignore: backedUp ? planGitignore(targetRoot) : null,
-    // Flutter 스토어 배포 파일(Fastfile·ExportOptions.plist) — 이미 있는 파일은 덮어쓰지 않고 유지한다.
+    // Flutter store deploy files (Fastfile, ExportOptions.plist): existing files are kept, not overwritten.
     flutterApp: planTypeAppFiles(context, payloadRoot, targetRoot),
     versionYml: versionYmlPreview(context, payloadRoot, targetRoot),
-    // 실제 설치가 함께 바꾸는 파일 — 특히 기존 파일을 덮어쓰는 스크립트는 미리 보여줘야 한다.
+    // Files the real install also changes; scripts that overwrite existing files in particular must be shown in advance.
     scripts: planScripts(payloadRoot, targetRoot),
     readme: planVersionSection(targetRoot),
     baselineExists: existsSync(join(targetRoot, BASELINE_PATH)),
@@ -60,74 +62,93 @@ export function planDryRun(mode, context, payloadRoot, targetRoot = ".") {
 }
 
 export function printDryRun(plan) {
-  const lines = ["", `project-auto-wizard --dry-run (mode: ${plan.mode}) — 미리보기, 실제 파일은 바뀌지 않았습니다`, ""];
+  const lines = ["", t("cmd.dryRun.header", { mode: plan.mode }), ""];
   if (plan.mode === "uninstall") {
     const u = plan.uninstall;
-    lines.push(`제거될 워크플로우 (${u.workflows.length}개):`);
+    lines.push(t("cmd.dryRun.uninstall.workflows", { n: u.workflows.length }));
     for (const f of u.workflows) lines.push(`  - ${f}`);
-    lines.push(`제거될 스크립트 (${u.scripts.length}개):`);
+    lines.push(t("cmd.dryRun.uninstall.scripts", { n: u.scripts.length }));
     for (const f of u.scripts) lines.push(`  - ${f}`);
-    for (const f of u.appFiles || []) lines.push(`제거될 Flutter 앱 파일: ${f}`);
-    if (u.readme) lines.push("제거될 항목: README.md 버전 섹션 (AUTO-VERSION-SECTION)");
-    if (u.gitignore) lines.push("제거될 항목: .gitignore 자동 추가 항목");
-    if (u.versionYml) lines.push("제거될 파일: version.yml");
+    for (const f of u.appFiles || []) lines.push(t("cmd.dryRun.uninstall.appFile", { file: f }));
+    if (u.readme) lines.push(t("cmd.dryRun.uninstall.readme"));
+    if (u.gitignore) lines.push(t("cmd.dryRun.uninstall.gitignore"));
+    if (u.versionYml) lines.push(t("cmd.dryRun.uninstall.versionYml"));
   } else {
     if (plan.workflows) {
       const w = plan.workflows;
-      lines.push(`신규 파일 (${w.newFiles.length}개):`);
+      lines.push(t("cmd.dryRun.full.newFiles", { n: w.newFiles.length }));
       for (const f of w.newFiles) lines.push(`  + ${f.filename} [${f.type}]`);
-      lines.push(`변경될 파일 (${w.changed.length}개, 기존 설치가 사용자 수정본이면 충돌):`);
+      lines.push(t("cmd.dryRun.full.changed", { n: w.changed.length }));
       for (const f of w.changed) lines.push(`  ~ ${f.filename} [${f.type}]`);
-      lines.push(`동일한 파일 (${w.unchanged.length}개, 변경 없음)`);
+      lines.push(t("cmd.dryRun.full.unchanged", { n: w.unchanged.length }));
+      // Buckets that exist only with a baseline. The real run acts on each of them, so the preview lists them too
+      // (only when non-empty, so installs without a baseline print exactly as before).
+      if (w.upstreamOnly?.length) {
+        lines.push(t("cmd.dryRun.full.autoUpdated", { n: w.upstreamOnly.length }));
+        for (const f of w.upstreamOnly) lines.push(`  ~ ${f.filename} [${f.type}]`);
+      }
+      if (w.localOnly?.length) {
+        lines.push(t("cmd.dryRun.full.localKept", { n: w.localOnly.length }));
+        for (const f of w.localOnly) lines.push(`  = ${f.filename} [${f.type}]`);
+      }
+      if (w.removed?.length) {
+        lines.push(t("cmd.dryRun.full.removed", { n: w.removed.length }));
+        for (const f of w.removed) lines.push(`  - ${f.filename} [${f.type}]`);
+      }
     }
     if (plan.cleanup) {
-      const reasons = { cleanup: "이전 배포 방식 정리", storeCleanup: "선택 해제된 스토어 워크플로우 정리", staleCleanup: "현재 버전에 없는 이전 워크플로우 정리" };
+      const reasons = {
+        cleanup: t("cmd.dryRun.reason.cleanup"), storeCleanup: t("cmd.dryRun.reason.storeCleanup"), staleCleanup: t("cmd.dryRun.reason.staleCleanup"),
+      };
       const removed = [];
       const backedUp = [];
       for (const [key, reason] of Object.entries(reasons)) {
-        for (const f of plan.cleanup[key]?.removed || []) removed.push(`  - ${f} (${reason})`);
-        for (const f of plan.cleanup[key]?.backedUp || []) backedUp.push(`  > ${f} → ${f}.bak (${reason}, 수정본이라 백업)`);
+        for (const f of plan.cleanup[key]?.removed || []) removed.push(t("cmd.dryRun.cleanup.removedLine", { file: f, reason }));
+        for (const f of plan.cleanup[key]?.backedUp || []) backedUp.push(t("cmd.dryRun.cleanup.backedUpLine", { file: f, reason }));
       }
-      if (removed.length) lines.push(`삭제될 파일 (${removed.length}개):`, ...removed);
-      if (backedUp.length) lines.push(`.bak으로 옮겨질 파일 (${backedUp.length}개):`, ...backedUp);
+      if (removed.length) lines.push(t("cmd.dryRun.cleanup.removedHeading", { n: removed.length }), ...removed);
+      if (backedUp.length) lines.push(t("cmd.dryRun.cleanup.backedUpHeading", { n: backedUp.length }), ...backedUp);
     }
     if (plan.gitignore) {
       const g = plan.gitignore;
       lines.push(g.created
-        ? `.gitignore: 새로 생성될 예정 (${g.added.join(", ")})`
-        : g.added.length ? `.gitignore: ${g.added.join(", ")} 추가될 예정` : ".gitignore: 변경 없음 (이미 있는 항목)");
+        ? t("cmd.dryRun.gitignore.created", { added: g.added.join(", ") })
+        : g.added.length ? t("cmd.dryRun.gitignore.append", { added: g.added.join(", ") }) : t("cmd.dryRun.gitignore.unchanged"));
     }
     if (plan.flutterApp && (plan.flutterApp.created.length || plan.flutterApp.kept.length)) {
       const { created, kept } = plan.flutterApp;
-      lines.push(`Flutter 스토어 배포 파일 — 신규 (${created.length}개):`);
+      lines.push(t("cmd.dryRun.flutter.created", { n: created.length }));
       for (const f of created) lines.push(`  + ${f}`);
-      lines.push(`Flutter 스토어 배포 파일 — 기존 파일 유지 (${kept.length}개, 덮어쓰지 않음):`);
-      for (const f of kept) lines.push(`  = ${f} (기존 파일 유지)`);
+      lines.push(t("cmd.dryRun.flutter.kept", { n: kept.length }));
+      for (const f of kept) lines.push(t("cmd.dryRun.flutter.keptLine", { file: f }));
     }
     if (plan.versionYml) {
       lines.push(plan.versionYml.existed
-        ? (plan.versionYml.changed ? "version.yml: 갱신될 예정" : "version.yml: 변경 없음")
-        : "version.yml: 새로 생성될 예정");
-      // dry-run은 프롬프트 없이 읽기 전용으로 동작하므로 @wizard ask 배포 설정 값을 계산할 수 없다.
-      // spring 등 deploy 블록이 있는 타입은 실제 설치 결과와 미리보기가 다를 수 있음을 안내한다.
-      lines.push("  (참고: 배포 설정 질문이 있는 타입(spring 등)은 deploy: 블록이 미리보기에 반영되지 않아 실제 설치와 다르게 보일 수 있습니다.)");
+        ? (plan.versionYml.changed ? t("cmd.dryRun.versionYml.update") : t("cmd.dryRun.versionYml.unchanged"))
+        : t("cmd.dryRun.versionYml.create"));
+      // dry-run runs read-only without prompts, so it cannot compute @wizard ask deploy settings.
+      // For types with a deploy block (spring etc.) say the preview may differ from the real install.
+      lines.push(t("cmd.dryRun.versionYml.note"));
     }
     if (plan.scripts) {
       const mark = { create: "+", overwrite: "~", unchanged: "=" };
-      const note = { create: "새로 생성", overwrite: "기존 파일을 새 버전으로 덮어씀 — 직접 고친 내용은 사라집니다", unchanged: "변경 없음" };
-      lines.push(`스크립트 (${PATHS.scriptsDir}/, ${plan.scripts.length}개 — 항상 새 버전으로 교체):`);
+      const note = {
+        create: t("cmd.dryRun.scripts.create"), overwrite: t("cmd.dryRun.scripts.overwrite"), unchanged: t("cmd.dryRun.scripts.unchanged"),
+      };
+      lines.push(t("cmd.dryRun.scripts.heading", { dir: PATHS.scriptsDir, n: plan.scripts.length }));
       for (const s of plan.scripts) lines.push(`  ${mark[s.action]} ${s.name} (${note[s.action]})`);
     }
     if (plan.readme) {
       lines.push({
-        added: "README.md: 끝에 버전 섹션이 추가될 예정",
-        "skip-no-readme": "README.md: 파일이 없어 버전 섹션을 추가하지 않음",
-        "skip-marker": "README.md: 이미 버전 섹션이 있어 변경 없음",
-        "skip-version-line": "README.md: 이미 버전 줄이 있어 변경 없음",
-      }[plan.readme] || `README.md: ${plan.readme}`);
+        added: t("cmd.dryRun.readme.added"),
+        "skip-no-readme": t("cmd.dryRun.readme.skipNoReadme"),
+        "skip-marker": t("cmd.dryRun.readme.skipMarker"),
+        "skip-version-line": t("cmd.dryRun.readme.skipVersionLine"),
+        "heading-updated": t("cmd.dryRun.readme.headingUpdated"),
+      }[plan.readme] || t("cmd.dryRun.readme.other", { status: plan.readme }));
     }
     if (plan.baselineExists !== undefined) {
-      lines.push(`${BASELINE_PATH}: ${plan.baselineExists ? "갱신될 예정" : "새로 생성될 예정"} (다음 업데이트의 비교 기준)`);
+      lines.push(t(plan.baselineExists ? "cmd.dryRun.baseline.update" : "cmd.dryRun.baseline.create", { path: BASELINE_PATH }));
     }
   }
   lines.push("");