project-auto-wizard 0.13.2 → 0.14.0

package/src/commands/purge.js

@@ -1,9 +1,9 @@
-// purge 모드 — planRemoval이 판별하는 전부(워크플로우·스크립트) + version.yml·README
-// AUTO-VERSION-SECTION 블록·.gitignore 자동 추가 항목·릴리스 워크플로우가 만든 CHANGELOG를
-// 추가로 제거해 설치 이전 상태로 완전히 되돌린다. 마법사가 만들지 않은 파일은 지우지 않는다.
-// 개발·테스트 전용 숨김 모드.
-// develop 브랜치 삭제는 파일 삭제와 성격이 달라(실행 시점 git 상태 판단 필요) 여기 plan에는
-// 포함하지 않고 index.js의 purge 분기에서 직접 처리한다.
+// purge mode: on top of everything planRemoval identifies (workflows, scripts), also removes version.yml, the README
+// AUTO-VERSION-SECTION block, auto-added .gitignore entries and the CHANGELOG created by the release
+// workflow, restoring the pre-install state completely. Files the wizard did not create are never deleted.
+// Hidden development/testing mode.
+// Deleting the develop branch differs in nature from deleting files (it needs a run-time git state
+// judgment), so it is not part of this plan and is handled directly in the purge branch of index.js.
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { PATHS } from "../core/paths.js";
@@ -11,12 +11,17 @@ import { planRemoval, backupArtifacts } from "../core/removal-plan.js";
 import { executeRemoval } from "../core/removal-exec.js";
 import { hasVersionSection } from "../core/copy/readme.js";
 import { hasAutoAddedEntries } from "../core/copy/gitignore.js";
+import { t } from "../i18n/index.js";
 
 const CHANGELOG_FILES = ["CHANGELOG.json", "CHANGELOG.md"];
 
-// changelog_manager.py가 만든 CHANGELOG인지 — 사용자가 원래 쓰던 CHANGELOG.md를 지우지 않기 위해 내용으로 가린다.
-// CHANGELOG.json은 metadata·releases 구조로, CHANGELOG.md는 generate-md가 쓰는 머리말로 판단한다.
-// JSON이 우리 것이면 MD는 릴리스마다 JSON에서 통째로 재생성되므로 함께 우리 것이다.
+// Whether the CHANGELOG was created by changelog_manager.py: judged by content so a CHANGELOG.md the user
+// wrote themselves is not deleted. CHANGELOG.json is recognized by its metadata/releases structure, and
+// CHANGELOG.md by the header generate-md writes. If the JSON is ours, the MD is regenerated wholesale from
+// the JSON on every release, so it is ours too.
+// The header's label may be localized by the script, so both the Korean and English wording are accepted
+// (the Korean label is written as escapes to keep this source free of Hangul).
+const GENERATED_MD_HEADER = /^# Changelog\n\n\*\*(?:\uD604\uC7AC \uBC84\uC804|Current version):\*\*/;
 function readText(targetRoot, f) {
   try { return readFileSync(join(targetRoot, f), "utf8").replace(/\r\n/g, "\n"); } catch { return null; }
 }
@@ -31,20 +36,20 @@ function isGeneratedChangelogJson(targetRoot) {
 function generatedChangelogFiles(targetRoot) {
   const jsonOurs = isGeneratedChangelogJson(targetRoot);
   const md = readText(targetRoot, "CHANGELOG.md");
-  const mdOurs = md !== null && (jsonOurs || md.startsWith("# Changelog\n\n**현재 버전:**"));
+  const mdOurs = md !== null && (jsonOurs || GENERATED_MD_HEADER.test(md));
   return CHANGELOG_FILES.filter((f) => (f === "CHANGELOG.json" ? jsonOurs : mdOurs));
 }
 
-// keepFlags: { versionYml, readme, changelog, workflows, scripts } — true인 카테고리는 후보에서 제외.
-// 반환: { workflows, scripts, versionYml, readmeSection, gitignore, changelog } — 아무것도 지우지 않는 순수 함수.
+// keepFlags: { versionYml, readme, changelog, workflows, scripts }: categories set to true are excluded from the candidates.
+// Returns { workflows, scripts, versionYml, readmeSection, gitignore, changelog }: a pure function that deletes nothing.
 export function planPurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   const removalPlan = planRemoval(payloadRoot, targetRoot);
-  // 워크플로우를 남기면 그 .bak/.template.yaml도 남는다 — .gitignore 항목까지 지우면 백업 파일이 git 상태에 드러난다.
+  // If the workflows stay, so do their .bak/.template.yaml; removing the .gitignore entries too would surface the backup files in git status.
   const gitignoreKept = hasAutoAddedEntries(targetRoot) && keepFlags.workflows === true
     && backupArtifacts(removalPlan.workflows).length > 0;
   return {
     workflows: keepFlags.workflows ? [] : removalPlan.workflows,
-    // Flutter 앱 파일의 생성 기록은 baseline에 있으므로 baseline과 같은 플래그를 따른다.
+    // The creation record of Flutter app files lives in the baseline, so they follow the same flag as the baseline.
     appFiles: keepFlags.workflows ? [] : removalPlan.appFiles,
     baseline: keepFlags.workflows ? [] : removalPlan.baseline,
     scripts: keepFlags.scripts ? [] : removalPlan.scripts,
@@ -56,55 +61,55 @@ export function planPurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   };
 }
 
-// 삭제 전 요약 출력 — dry-run 미리보기와 실제 실행 전 요약 양쪽에서 재사용한다.
+// Summary printed before deletion; reused by both the dry-run preview and the summary before a real run.
 export function printPurgePlan(plan, { dryRun = false } = {}) {
   const lines = ["",
     dryRun
-      ? "project-auto-wizard --mode purge --dry-run — 미리보기, 실제 파일은 바뀌지 않았습니다"
-      : "project-auto-wizard --mode purge — 아래 항목을 제거합니다",
+      ? t("cmd.purge.headerDry")
+      : t("cmd.purge.header"),
     ""];
-  lines.push(`워크플로우 (${plan.workflows.length}개):`);
+  lines.push(t("cmd.purge.workflows", { n: plan.workflows.length }));
   for (const f of plan.workflows) lines.push(`  - ${f}`);
-  lines.push(`스크립트 (${plan.scripts.length}개):`);
+  lines.push(t("cmd.purge.scripts", { n: plan.scripts.length }));
   for (const f of plan.scripts) lines.push(`  - ${f}`);
-  for (const f of plan.appFiles || []) lines.push(`Flutter 앱 파일: ${f}`);
-  if (plan.versionYml) lines.push("파일: version.yml");
-  if (plan.readmeSection) lines.push("README.md: AUTO-VERSION-SECTION 블록");
-  if (plan.gitignore) lines.push(".gitignore: 자동 추가 항목(*.bak, *.template.yaml)");
-  if (plan.gitignoreKept) lines.push(".gitignore: 자동 추가 항목 유지 (남겨 둔 워크플로우의 백업 파일을 가리는 항목)");
-  for (const f of plan.changelog) lines.push(`파일: ${f}`);
+  for (const f of plan.appFiles || []) lines.push(t("cmd.purge.appFile", { file: f }));
+  if (plan.versionYml) lines.push(t("cmd.purge.versionYml"));
+  if (plan.readmeSection) lines.push(t("cmd.purge.readmeSection"));
+  if (plan.gitignore) lines.push(t("cmd.purge.gitignore"));
+  if (plan.gitignoreKept) lines.push(t("cmd.purge.gitignoreKept"));
+  for (const f of plan.changelog) lines.push(t("cmd.purge.file", { file: f }));
   lines.push("");
   console.log(lines.join("\n"));
 }
 
-// 실제 삭제 수행 — planPurge()와 동일 shape을 반환하되 실제로 제거된 항목을 반영한다.
-// planRemoval 결과를 그대로 지우지 않는 이유: 그 목록은 항상 전체라서
-// --keep-* 로 선택적 카테고리만 보존하는 요구사항과 맞지 않는다.
-// readmeSection은 plan의 판정을 그대로 되돌려주지 않고
-// removeVersionSectionFromReadme()의 실제 반환값("removed"인지)을 반영한다 — plan과 실제 제거 조건이
-// 이론상 어긋나는 경우에도 printPurgeResult가 거짓으로 "제거됨"을 보고하지 않는다.
+// Performs the actual deletion: returns the same shape as planPurge() but reflecting what was really removed.
+// Why the planRemoval result is not deleted as is: that list is always the full set, which does not fit
+// the requirement to preserve selected categories via --keep-*.
+// readmeSection does not echo the plan's decision but reflects the actual return value of
+// removeVersionSectionFromReadme() (whether it was "removed"), so even if the plan and the real removal
+// condition theoretically diverge, printPurgeResult never falsely reports "removed".
 export function executePurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   const plan = planPurge(payloadRoot, targetRoot, keepFlags);
   const { readme, gitignore } = executeRemoval(targetRoot, { ...plan, readme: plan.readmeSection }, {
     logOrder: ["version", "gitignore", "changelog", "readme"],
-    gitignoreDetail: (status) => (status === "removed" || status === "file-deleted" ? ".gitignore 자동 추가 항목" : null),
+    gitignoreDetail: (status) => (status === "removed" || status === "file-deleted" ? t("cmd.purge.gitignoreLog") : null),
   });
   return { ...plan, readmeSection: readme, gitignore };
 }
 
-// 삭제 후 실제 제거된 목록 출력 — printPurgePlan과 완전히 동일한 형태(파일명 나열)로
-// 맞춘다 (개수만 출력하면 무엇이 지워졌는지 확인할 수 없다).
+// Prints the list actually removed after deletion, in exactly the same form as printPurgePlan (file names
+// listed); printing only counts would not show what was deleted.
 export function printPurgeResult(result) {
-  const lines = ["", "제거됨:", ""];
-  lines.push(`워크플로우 (${result.workflows.length}개):`);
+  const lines = ["", t("cmd.purge.removedHeading"), ""];
+  lines.push(t("cmd.purge.workflows", { n: result.workflows.length }));
   for (const f of result.workflows) lines.push(`  - ${f}`);
-  lines.push(`스크립트 (${result.scripts.length}개):`);
+  lines.push(t("cmd.purge.scripts", { n: result.scripts.length }));
   for (const f of result.scripts) lines.push(`  - ${f}`);
-  for (const f of result.appFiles || []) lines.push(`Flutter 앱 파일: ${f}`);
-  if (result.versionYml) lines.push("파일: version.yml");
-  if (result.readmeSection) lines.push("README.md: AUTO-VERSION-SECTION 블록");
-  if (result.gitignore) lines.push(".gitignore: 자동 추가 항목(*.bak, *.template.yaml)");
-  for (const f of result.changelog) lines.push(`파일: ${f}`);
+  for (const f of result.appFiles || []) lines.push(t("cmd.purge.appFile", { file: f }));
+  if (result.versionYml) lines.push(t("cmd.purge.versionYml"));
+  if (result.readmeSection) lines.push(t("cmd.purge.readmeSection"));
+  if (result.gitignore) lines.push(t("cmd.purge.gitignore"));
+  for (const f of result.changelog) lines.push(t("cmd.purge.file", { file: f }));
   lines.push("");
   console.log(lines.join("\n"));
 }

package/src/commands/status.js

@@ -1,4 +1,4 @@
-// status 명령 — 읽기 전용 설치 상태 확인. 네트워크 접근 없음(로컬 파일 비교만).
+// status command: read-only install state check. No network access (local file comparison only).
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseExisting } from "../core/version-yml.js";
@@ -9,32 +9,33 @@ import { isDeployStyle, DEFAULT_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { findStaleWorkflows } from "../core/removal-plan.js";
 import { readBaseline } from "../core/baseline.js";
 import { hooksFor, mergeHookResults } from "../core/types.js";
+import { t } from "../i18n/index.js";
 
-// payloadRoot: 패키지 payload/ 루트. targetRoot: 상태를 확인할 대상 레포.
+// payloadRoot: the package's payload/ root. targetRoot: the repo whose state is checked.
 export function runStatus(payloadRoot, targetRoot = ".") {
   const vyPath = join(targetRoot, PATHS.versionFile);
   if (!existsSync(vyPath)) return { installed: false };
 
   const existing = parseExisting(readFileSync(vyPath, "utf8"));
   const repoName = detectRepoName(targetRoot);
-  // 설치 때 워크플로우에 치환된 환경변수 방식·배포 모드와 스토어 선택을 비교 기준에도 똑같이 적용한다 —
-  // 그렇지 않으면 미수정 파일이 드리프트로, 선택 해제한 스토어 워크플로우가 "삭제함"으로 오탐된다.
+  // Apply the env mode, deploy mode and store selection substituted into the workflows at install time to the
+  // comparison as well; otherwise unmodified files show up as drift and deselected store workflows as "deleted".
   const typeOptions = mergeHookResults(existing.types, "resolveOptions", { existing });
   const resolvers = makeResolvers(targetRoot, repoName, existing.paths, typeOptions);
-  // version.yml에 branches 블록이 없으면(신기능 이전 설치·수기 편집) makeSrcText(null)이
-  // {{MAIN_BRANCH}}/{{DEVELOP_BRANCH}}를 치환하지 못해 모든 워크플로우가 드리프트로 오탐된다 —
-  // 비교용 기본값으로 폴백(실제 저장값은 아니지만 드리프트 비교 목적에는 충분).
+  // Without a branches block in version.yml (install predating the feature, or hand-edited), makeSrcText(null)
+  // cannot substitute {{MAIN_BRANCH}}/{{DEVELOP_BRANCH}} and every workflow is falsely reported as drift, so
+  // fall back to defaults for the comparison (not the real saved values, but enough for drift detection).
   const branchesForCompare = existing.branches || { main: detectDefaultBranch(targetRoot) || "main", develop: "develop", mode: "pr-flow" };
   const context = {
     types: existing.types, paths: existing.paths,
     repoName, resolvers, branches: branchesForCompare,
     ...mergeHookResults(existing.types, "contextFields", typeOptions),
-    // 설치 때 고른 배포 방식으로 비교해야 nginx·traefik CD 수정도 드리프트로 잡힌다.
-    // 빠지면 기본값(simple)으로 걸러 설치된 무중단 CD가 비교 대상에서 사라진다.
+    // Compare using the deploy style chosen at install so nginx/traefik CD edits are caught as drift too.
+    // If omitted, the default (simple) filters out the installed zero-downtime CD from the comparison.
     deployStyle: isDeployStyle(existing.options.deployStyle) ? existing.options.deployStyle : DEFAULT_DEPLOY_STYLE,
   };
   const plan = planWorkflows(context, payloadRoot, targetRoot);
-  // 현재 버전에 없는 옛 워크플로우 — 다음 업데이트에서 정리된다. 그 전까지는 옛 트리거로 계속 돈다.
+  // Old workflows absent from the current version are cleaned up on the next update; until then they keep running on the old triggers.
   const stale = findStaleWorkflows(payloadRoot, targetRoot, readBaseline(targetRoot));
 
   return {
@@ -44,60 +45,59 @@ export function runStatus(payloadRoot, targetRoot = ".") {
     types: existing.types,
     branches: existing.branches,
     options: existing.options,
-    // 사용자가 손댄 파일 = 진짜 충돌(changed) + 업스트림은 그대로인데 내가 고친 것(localOnly).
-    // baseline이 없으면 localOnly는 항상 비어 있어 종전과 동일하게 동작한다.
+    // Files the user touched = real conflicts (changed) + upstream unchanged but locally edited (localOnly).
+    // Without a baseline localOnly is always empty, so behavior is the same as before.
     modifiedFiles: [...plan.changed, ...plan.localOnly].map((f) => f.filename),
-    // 업데이트 시 무슨 일이 일어날지 미리 보여주는 버킷들 — 판단 재료가 없어 사용자가
-    // 직접 git diff를 떠야 했던 문제를 없앤다.
+    // Buckets that preview what an update would do, so users no longer have to run git diff themselves for lack of information.
     buckets: {
-      autoUpdatable: plan.upstreamOnly.map((f) => f.filename), // 질문 없이 최신으로 교체됨
-      localKept: plan.localOnly.map((f) => f.filename),        // 질문 없이 내 수정본 유지됨
-      conflicts: plan.changed.map((f) => f.filename),          // 양쪽 변경 — 검토 필요
-      removed: plan.removed.map((f) => f.filename),            // 내가 지웠고 복원하지 않음
+      autoUpdatable: plan.upstreamOnly.map((f) => f.filename), // replaced with the latest without asking
+      localKept: plan.localOnly.map((f) => f.filename),        // local edit kept without asking
+      conflicts: plan.changed.map((f) => f.filename),          // changed on both sides; needs review
+      removed: plan.removed.map((f) => f.filename),            // deleted by the user and not restored
     },
     staleFiles: stale,
   };
 }
 
 export function printStatus(status) {
-  const lines = ["", "project-auto-wizard status — 설치 상태", ""];
+  const lines = ["", t("cmd.status.title"), ""];
   if (!status.installed) {
-    lines.push("이 디렉터리에 project-auto-wizard가 설치되어 있지 않습니다 (version.yml 없음).", "");
+    lines.push(t("cmd.status.notInstalled"), "");
     console.log(lines.join("\n"));
     return;
   }
-  lines.push(`버전            : ${status.version}`);
-  lines.push(`템플릿 버전      : ${status.templateVersion}`);
-  lines.push(`프로젝트 타입    : ${status.types.join(", ") || "(없음)"}`);
+  lines.push(t("cmd.status.version", { value: status.version }));
+  lines.push(t("cmd.status.templateVersion", { value: status.templateVersion }));
+  lines.push(t("cmd.status.types", { value: status.types.join(", ") || t("cmd.status.none") }));
   if (status.branches) {
-    lines.push(`브랜치 모드      : ${status.branches.mode} (${status.branches.main} / ${status.branches.develop})`);
+    lines.push(t("cmd.status.branchMode", { mode: status.branches.mode, main: status.branches.main, develop: status.branches.develop }));
   }
-  const boolLabel = (v) => (v === null ? "미설정(기본 false)" : v);
-  const semverAutoLabel = status.options.semverAuto === null ? "미설정(기본 false)" : status.options.semverAuto;
+  const boolLabel = (v) => (v === null ? t("cmd.status.unsetDefaultFalse") : v);
+  const semverAutoLabel = status.options.semverAuto === null ? t("cmd.status.unsetDefaultFalse") : status.options.semverAuto;
   const copilotAiLabel = boolLabel(status.options.copilotAi ?? null);
   const typeLabels = hooksFor(status.types, "statusLabels").map(({ hook }) => hook(status.options)).join("");
   const deployLabel = status.options.deployStyle ? ` deploy_style=${status.options.deployStyle}` : "";
-  lines.push(`옵션            : semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${deployLabel}${typeLabels}`);
+  lines.push(t("cmd.status.options", { value: `semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${deployLabel}${typeLabels}` }));
   if (status.modifiedFiles.length) {
-    lines.push("", `사용자가 수정한 워크플로우 파일 (${status.modifiedFiles.length}개):`);
+    lines.push("", t("cmd.status.modified", { n: status.modifiedFiles.length }));
     for (const f of status.modifiedFiles) lines.push(`  - ${f}`);
   } else {
-    lines.push("", "모든 워크플로우 파일이 설치 시점 기본값과 동일합니다 (수정 없음).");
+    lines.push("", t("cmd.status.unmodified"));
   }
 
   if (status.staleFiles?.length) {
-    lines.push("", `현재 버전에 없는 이전 워크플로우 (${status.staleFiles.length}개 — 다음 업데이트에서 정리됨):`);
+    lines.push("", t("cmd.status.stale", { n: status.staleFiles.length }));
     for (const f of status.staleFiles) lines.push(`  - ${f}`);
   }
 
-  // 업데이트하면 무슨 일이 일어나는지. baseline이 없는 설치는 전부 0이라 출력하지 않는다.
+  // What an update would do. Installs without a baseline are all zeros, so nothing is printed.
   const b = status.buckets || { autoUpdatable: [], localKept: [], conflicts: [], removed: [] };
   if (b.autoUpdatable.length || b.localKept.length || b.conflicts.length || b.removed.length) {
-    lines.push("", "지금 업데이트하면:");
-    lines.push(`  업스트림 변경 — 자동 적용 가능   ${String(b.autoUpdatable.length).padStart(3)}`);
-    lines.push(`  내가 수정 · 업스트림 그대로      ${String(b.localKept.length).padStart(3)}   (유지)`);
-    lines.push(`  양쪽 변경 — 검토 필요            ${String(b.conflicts.length).padStart(3)}`);
-    lines.push(`  내가 삭제함 — 복원 안 함         ${String(b.removed.length).padStart(3)}`);
+    lines.push("", t("cmd.status.bucketsTitle"));
+    lines.push(t("cmd.status.bucketAuto", { n: String(b.autoUpdatable.length).padStart(3) }));
+    lines.push(t("cmd.status.bucketLocalKept", { n: String(b.localKept.length).padStart(3) }));
+    lines.push(t("cmd.status.bucketConflicts", { n: String(b.conflicts.length).padStart(3) }));
+    lines.push(t("cmd.status.bucketRemoved", { n: String(b.removed.length).padStart(3) }));
   }
   lines.push("");
   console.log(lines.join("\n"));

package/src/commands/uninstall.js

@@ -1,6 +1,6 @@
-// uninstall 모드 — 마법사가 설치한 파일(planRemoval 판별분)에 더해 README/.gitignore/version.yml까지
-// 선택적으로 제거한다. 대화형 체크리스트 또는 --force + --purge-* 로 항목별 opt-in.
-// core/removal-plan.js는 읽기 전용으로만 재사용한다(아무것도 지우지 않는 순수 함수).
+// uninstall mode: removes the files the wizard installed (as identified by planRemoval) and, optionally,
+// README/.gitignore/version.yml too. Per-item opt-in via the interactive checklist or --force + --purge-*.
+// core/removal-plan.js is only reused read-only (a pure function that deletes nothing).
 import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { PATHS } from "../core/paths.js";
@@ -9,20 +9,21 @@ import { executeRemoval } from "../core/removal-exec.js";
 import { hasVersionSection } from "../core/copy/readme.js";
 import { hasAutoAddedEntries } from "../core/copy/gitignore.js";
 import { CANCEL } from "../ui/prompts.js";
+import { t } from "../i18n/index.js";
 
-// selection: { workflows, scripts, readme, gitignore, versionYml } (모두 boolean).
-// 반환: 위와 동일한 키의 boolean/배열 — 실제로 제거 "대상"인지 여부(순수 함수, 아무것도 지우지 않음).
+// selection: { workflows, scripts, readme, gitignore, versionYml } (all booleans).
+// Returns: boolean/array values under the same keys, telling what is actually a removal "target" (pure function, deletes nothing).
 export function planUninstall(payloadRoot, targetRoot, selection) {
   const removalPlan = planRemoval(payloadRoot, targetRoot);
   return {
     workflows: selection.workflows ? removalPlan.workflows : [],
-    // baseline은 워크플로우 해시 기록 — 워크플로우를 지우면 함께 사라져야 한다.
-    // Flutter 앱 파일의 생성 기록도 baseline에만 있으므로 같은 항목으로 묶는다.
+    // baseline records the workflow hashes, so it must disappear together with the workflows.
+    // The creation record of Flutter app files also lives only in the baseline, so it goes under the same item.
     appFiles: selection.workflows ? removalPlan.appFiles : [],
     baseline: selection.workflows ? removalPlan.baseline : [],
     scripts: selection.scripts ? removalPlan.scripts : [],
     readme: selection.readme ? hasVersionSection(targetRoot) : false,
-    // 워크플로우를 남기면 그 백업 파일(.bak 등)도 남는다 — .gitignore 항목을 지우면 git 상태에 드러나므로 유지한다.
+    // If the workflows stay, so do their backup files (.bak etc.); removing the .gitignore entries would surface them in git status, so keep them.
     gitignore: selection.gitignore
       ? hasAutoAddedEntries(targetRoot) && (selection.workflows || backupArtifacts(removalPlan.workflows).length === 0)
       : false,
@@ -30,29 +31,30 @@ export function planUninstall(payloadRoot, targetRoot, selection) {
   };
 }
 
-// 반환: planUninstall과 동일한 형태 — 실제로 제거된 항목.
+// Returns: the same shape as planUninstall, the items actually removed.
 export function runUninstall(context, payloadRoot, targetRoot, selection) {
   const plan = planUninstall(payloadRoot, targetRoot, selection);
   const { readme, gitignore } = executeRemoval(targetRoot, plan, {
     logOrder: ["readme", "gitignore", "version"],
-    gitignoreDetail: (status) => `.gitignore 자동 추가 항목 (${status})`,
+    gitignoreDetail: (status) => t("cmd.uninstall.gitignoreDetail", { status }),
   });
   return { ...plan, readme, gitignore };
 }
 
-// ── 대화형 체크리스트 흐름 ────────────────────────────────────────────
-const ITEM_DEFS = [
-  // .github/.wizard 에는 baseline.json과 설치 로그(.wizard/logs)가 함께 들어 있다 —
-  // 워크플로우를 지우면 함께 사라지므로 라벨에 명시한다.
-  // Flutter 앱 파일은 마법사가 만들고 사용자가 수정하지 않은 것만 함께 지운다.
-  { key: "workflows", label: "워크플로우 (.github/workflows/PROJECT-*.yaml) + 설치 기록 (.github/.wizard) + 수정하지 않은 Flutter 앱 파일" },
-  { key: "scripts", label: "스크립트 (.github/scripts/*.py)" },
-  { key: "readme", label: "README.md 버전 섹션 (AUTO-VERSION-SECTION)" },
-  { key: "gitignore", label: ".gitignore 자동 추가 항목" },
-  { key: "versionYml", label: "version.yml (버전/브랜치 설정 전체)" },
+// ── Interactive checklist flow ────────────────────────────────────────
+// Built lazily: labels are translated at use time, after the language is resolved.
+const itemDefs = () => [
+  // .github/.wizard holds baseline.json and the install logs (.wizard/logs); they disappear together
+  // with the workflows, so the label says so.
+  // Flutter app files are removed too, but only those the wizard created and the user did not modify.
+  { key: "workflows", label: t("cmd.uninstall.item.workflows") },
+  { key: "scripts", label: t("cmd.uninstall.item.scripts") },
+  { key: "readme", label: t("cmd.uninstall.item.readme") },
+  { key: "gitignore", label: t("cmd.uninstall.item.gitignore") },
+  { key: "versionYml", label: t("cmd.uninstall.item.versionYml") },
 ];
 
-// 기본 체크 상태 — "안전 삭제" 2종만 기본 체크하고 나머지(readme/gitignore/versionYml)는 opt-in.
+// Default checked state: only the two "safe delete" items are checked; the rest (readme/gitignore/versionYml) are opt-in.
 export const SAFE_ITEMS = ["workflows", "scripts"];
 
 function detectAvailableItems(payloadRoot, targetRoot) {
@@ -64,7 +66,7 @@ function detectAvailableItems(payloadRoot, targetRoot) {
     gitignore: hasAutoAddedEntries(targetRoot),
     versionYml: existsSync(join(targetRoot, PATHS.versionFile)),
   };
-  return ITEM_DEFS.filter((d) => presence[d.key]).map((d) => ({ value: d.key, label: d.label }));
+  return itemDefs().filter((d) => presence[d.key]).map((d) => ({ value: d.key, label: d.label }));
 }
 
 function toSelection(checkedKeys) {
@@ -76,51 +78,51 @@ function toSelection(checkedKeys) {
 }
 
 function summarizeSelection(selection) {
-  const labelOf = Object.fromEntries(ITEM_DEFS.map((d) => [d.key, d.label]));
+  const labelOf = Object.fromEntries(itemDefs().map((d) => [d.key, d.label]));
   const chosen = Object.keys(selection).filter((k) => selection[k]).map((k) => `- ${labelOf[k]}`);
-  return chosen.length ? chosen.join("\n") : "(선택된 항목 없음)";
+  return chosen.length ? chosen.join("\n") : t("cmd.uninstall.noneSelected");
 }
 
 function summarizeResult(result) {
   const lines = [];
-  if (result.workflows.length) lines.push(`워크플로우 ${result.workflows.length}개 제거`);
-  if (result.scripts.length) lines.push(`스크립트 ${result.scripts.length}개 제거`);
-  if (result.appFiles?.length) lines.push(`Flutter 앱 파일 ${result.appFiles.length}개 제거`);
-  if (result.readme) lines.push("README.md 버전 섹션 제거");
-  if (result.gitignore) lines.push(".gitignore 자동 추가 항목 제거");
-  if (result.versionYml) lines.push("version.yml 제거");
-  return lines.length ? lines.join("\n") : "제거된 항목이 없습니다.";
+  if (result.workflows.length) lines.push(t("cmd.uninstall.result.workflows", { n: result.workflows.length }));
+  if (result.scripts.length) lines.push(t("cmd.uninstall.result.scripts", { n: result.scripts.length }));
+  if (result.appFiles?.length) lines.push(t("cmd.uninstall.result.appFiles", { n: result.appFiles.length }));
+  if (result.readme) lines.push(t("cmd.uninstall.result.readme"));
+  if (result.gitignore) lines.push(t("cmd.uninstall.result.gitignore"));
+  if (result.versionYml) lines.push(t("cmd.uninstall.result.versionYml"));
+  return lines.length ? lines.join("\n") : t("cmd.uninstall.result.none");
 }
 
-// io 계약: engineIo.multiselect({message,options,initialValues}), askYesNo(msg,def),
-// note(text,title)?, cancelMessage(text)? — src/ui/prompts.js가 실물, 테스트는 스텁 주입.
-// preset: CLI의 --purge-* 플래그 { readme, gitignore, versionYml } — 체크리스트 초기 선택에 반영한다.
+// io contract: engineIo.multiselect({message,options,initialValues}), askYesNo(msg,def),
+// note(text,title)?, cancelMessage(text)? - src/ui/prompts.js is the real one, tests inject stubs.
+// preset: the CLI --purge-* flags { readme, gitignore, versionYml }, reflected in the checklist's initial selection.
 export async function runUninstallFlow(payloadRoot, targetRoot, io, preset = {}) {
   const available = detectAvailableItems(payloadRoot, targetRoot);
   if (available.length === 0) {
-    io.note?.("제거할 항목이 없습니다.", "완전 삭제");
+    io.note?.(t("cmd.uninstall.flow.nothing"), t("cmd.uninstall.flow.title"));
     return null;
   }
 
   const checked = await io.engineIo.multiselect({
-    message: "삭제할 항목을 선택하세요 (Space 토글, Enter 확정)",
+    message: t("cmd.uninstall.flow.select"),
     options: available,
     initialValues: available.map((o) => o.value).filter((v) => SAFE_ITEMS.includes(v) || preset[v] === true),
   });
   if (checked === CANCEL || !Array.isArray(checked) || checked.length === 0) {
-    io.cancelMessage?.("완전 삭제를 취소했습니다.");
+    io.cancelMessage?.(t("cmd.uninstall.flow.cancelled"));
     return null;
   }
 
   const selection = toSelection(checked);
-  io.note?.(summarizeSelection(selection), "삭제 예정 항목");
-  const ok = await io.askYesNo("정말 삭제할까요? 되돌릴 수 없습니다.", false);
+  io.note?.(summarizeSelection(selection), t("cmd.uninstall.flow.plannedTitle"));
+  const ok = await io.askYesNo(t("cmd.uninstall.flow.confirm"), false);
   if (ok !== true) {
-    io.cancelMessage?.("완전 삭제를 취소했습니다.");
+    io.cancelMessage?.(t("cmd.uninstall.flow.cancelled"));
     return null;
   }
 
   const result = runUninstall({}, payloadRoot, targetRoot, selection);
-  io.note?.(summarizeResult(result), "완전 삭제 완료");
+  io.note?.(summarizeResult(result), t("cmd.uninstall.flow.doneTitle"));
   return result;
 }

package/src/context.js

@@ -1,19 +1,19 @@
-// 마법사 전역 상태를 하나의 객체로 명시화
+// Wizard-wide state made explicit as a single object
 import { TYPE_IDS, allHookValues } from "./core/types.js";
 
-// --type 화이트리스트 — 타입 레지스트리(core/types.js)의 표시 순서 그대로.
+// --type whitelist: the display order of the type registry (core/types.js).
 export const VALID_TYPES = TYPE_IDS;
 
-// --mode 화이트리스트 — 알 수 없는 값은 부수효과(브랜치 조회 등) 이전에 즉시 거부해야 한다.
-// purge는 --help/대화형 메뉴에 노출하지 않는 숨김 모드이지만 검증 대상에는 포함한다.
-// version/workflows(부분 설치)와 revert는 제거됐다 — 부분 설치는 설치 시점 baseline을
-// 반쪽만 갱신해 업데이트 판정을 흐리고, revert는 uninstall의 부분집합이었다.
+// --mode whitelist: unknown values must be rejected before any side effect (branch lookup, etc.).
+// purge is a hidden mode (not in --help or the interactive menu) but is still validated.
+// version/workflows (partial install) and revert were removed: a partial install refreshes the
+// install-time baseline only halfway and blurs update detection, and revert was a subset of uninstall.
 export const VALID_MODES = [
   "interactive", "full",
   "uninstall", "status", "doctor", "purge",
 ];
 
-export const DEFAULT_VERSION = "0.0.0"; // 패키지 버전 읽기 실패 시 폴백 (배너용 — breaking 비교엔 안 씀)
+export const DEFAULT_VERSION = "0.0.0"; // fallback when reading the package version fails (banner only; not used for breaking comparison)
 
 export function createContext(overrides = {}) {
   return {
@@ -22,12 +22,13 @@ export function createContext(overrides = {}) {
     types: [],
     version: "",
     branch: "",
-    branches: null,          // { main, develop, mode: "pr-flow"|"trunk-based" } — resolveBranchConfig 결과
+    branches: null,          // { main, develop, mode: "pr-flow"|"trunk-based" } - result of resolveBranchConfig
     paths: new Map(),        // type -> path
-    includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
-    includeCopilotAi: null,  // null=미설정(다운스트림에서 false로 해석), true/false=명시 — Copilot AI 요약 opt-in
-    // 타입 전용 옵션 필드 — 해당 타입이 없는 프로젝트에서는 전부 무시된다. 필드와 기본값은 타입 훅(contextDefaults)이 정한다.
+    includeSemverAuto: null, // null = unset (resolved to true downstream), true/false = explicit
+    includeCopilotAi: null,  // null = unset (resolved to false downstream), true/false = explicit; Copilot AI summary opt-in
+    // Type-specific option fields; all ignored in projects without that type. Fields and defaults come from the type hook (contextDefaults).
     ...allHookValues("contextDefaults"),
+    language: "en",          // message language (--lang / env / version.yml), default en
     templateVersion: "",
     deployValues: new Map(), // "type.KEY" -> value
     counters: {},

package/src/core/assets.js

@@ -1,19 +1,20 @@
-// payload 자산 해석 — 네트워크 접근 0 (구 acquireTemplate/git clone 대체).
-// 마법사가 설치하는 모든 자산은 npm 패키지에 동봉된 payload/ 가 단일 진실이다.
-// npx 글로벌 캐시에서 실행돼도 import.meta.url 기준으로 패키지 내 payload를 정확히 가리킨다.
+// Payload asset resolution: zero network access (replaces the old acquireTemplate/git clone).
+// The payload/ bundled in the npm package is the single source of truth for every asset the wizard installs.
+// Even when run from the npx global cache, import.meta.url points precisely at the payload inside the package.
 import { fileURLToPath } from "node:url";
 import { join } from "node:path";
 import { readFileSync } from "node:fs";
 import { exists, readText, listYamlFiles } from "./fsutil.js";
 import { DEFAULT_VERSION } from "../context.js";
+import { t } from "../i18n/index.js";
 
-// 패키지 내 payload/ 절대경로. 테스트·픽스처는 인자 주입으로 대체 가능.
+// Absolute path of payload/ inside the package. Tests and fixtures can substitute it by argument injection.
 export function resolvePayloadRoot() {
   return fileURLToPath(new URL("../../payload/", import.meta.url));
 }
 
-// 마법사(=템플릿) 버전 — 패키지 package.json의 version.
-// 구 readTemplateVersion(tempDir/version.yml)과 동일한 소비처(배너·breaking 비교·version.yml 기록)를 채운다.
+// Wizard (= template) version: the version in the package's package.json.
+// Serves the same consumers as the former readTemplateVersion(tempDir/version.yml): banner, breaking-change comparison, version.yml record.
 export function readTemplateVersion() {
   try {
     const pkgPath = fileURLToPath(new URL("../../package.json", import.meta.url));
@@ -24,23 +25,23 @@ export function readTemplateVersion() {
   }
 }
 
-// payload/workflows/common 직하위 yaml 목록.
+// List of yaml files directly under payload/workflows/common.
 export function listCommonWorkflows(payloadRoot = resolvePayloadRoot()) {
   return listYamlFiles(join(payloadRoot, "workflows", "common"));
 }
 
-// payload 구조 자가 점검 — 필수 폴더 누락 시 명확히 실패 (배포 패키징 오류 조기 발견).
+// Payload structure self-check: fails clearly when a required folder is missing (catches packaging errors early).
 export function assertPayload(payloadRoot = resolvePayloadRoot()) {
   if (!exists(join(payloadRoot, "workflows"))) {
-    throw new Error("패키지 구조 오류 — payload/workflows 폴더를 찾지 못했습니다.");
+    throw new Error(t("core.assets.missingWorkflows"));
   }
   if (!exists(join(payloadRoot, "scripts"))) {
-    throw new Error("패키지 구조 오류 — payload/scripts 폴더를 찾지 못했습니다.");
+    throw new Error(t("core.assets.missingScripts"));
   }
   return payloadRoot;
 }
 
-// payload/version.yml.template 원문.
+// Raw text of payload/version.yml.template.
 export function readVersionYmlTemplate(payloadRoot = resolvePayloadRoot()) {
   const p = join(payloadRoot, "version.yml.template");
   return exists(p) ? readText(p) : null;