project-auto-wizard 0.13.3 → 0.14.0

package/src/cli/args.js

@@ -1,52 +1,87 @@
-// CLI 인자 파싱.
+// CLI argument parsing.
 import { VALID_TYPES, VALID_MODES } from "../context.js";
 import { DEPLOY_STYLES, isDeployStyle, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { isValidBranchName } from "../core/branches.js";
 import { TYPES } from "../core/types.js";
 import { CliError } from "../core/errors.js";
 import { normalizePath, isRepoRelativePath } from "../core/paths.js";
+import { t, DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES, isSupportedLanguage, normalizeLanguage } from "../i18n/index.js";
 
-// 기존 import 경로(cli/args.js) 호환 — 정의는 core에 있다.
+// Kept for the existing import path (cli/args.js); the definitions live in core.
 export { CliError, normalizePath, isRepoRelativePath };
 
-// 타입 전용 CLI 플래그(타입 훅 cliFlags) — 플래그 이름 → { field, initial, parse }. 훅은 타입 표 순서대로 모은다.
+// Type-specific CLI flags (type hook cliFlags): flag name -> { field, initial, parse }. Hooks are collected in type-table order.
 export const TYPE_CLI_FLAGS = TYPES.flatMap((t) => t.hooks?.cliFlags ?? []);
 const TYPE_CLI_FLAG_BY_NAME = new Map(TYPE_CLI_FLAGS.map((f) => [f.flag, f]));
 
-// argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
+// Options that consume a value, and options that are plain switches. Needed to expand `--name=value`.
+const VALUE_FLAGS = new Set([
+  "--mode", "--project-version", "--type", "--lang", "--deploy-style", "--paths", "--main-branch", "--develop-branch",
+  ...TYPE_CLI_FLAGS.map((f) => f.flag),
+]);
+const SWITCH_FLAGS = new Set([
+  "--version", "--help", "--force", "--dry-run", "--purge-readme", "--purge-gitignore", "--purge-version", "--yes", "--allow-dirty",
+  "--delete-develop-branch", "--keep-version-yml", "--keep-readme", "--keep-changelog", "--keep-workflows", "--keep-scripts",
+  "--semver-auto", "--no-semver-auto", "--copilot", "--no-copilot",
+]);
+
+// `--name=value` -> `--name`, `value`, so the parser below only sees the space-separated form.
+// Only the first "=" splits, so `--paths=flutter=app` keeps its value intact. A switch given a value is an error
+// (silently ignoring it would hide a typo); an unknown name is left as-is and reported by the parser.
+// The token after a value option is that option's value and is never expanded.
+function expandInlineValues(argv) {
+  const out = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    const eq = a.startsWith("--") ? a.indexOf("=") : -1;
+    if (eq < 0) {
+      out.push(a);
+      if (VALUE_FLAGS.has(a) && i + 1 < argv.length) out.push(argv[++i]);
+      continue;
+    }
+    const name = a.slice(0, eq);
+    if (VALUE_FLAGS.has(name)) out.push(name, a.slice(eq + 1));
+    else if (SWITCH_FLAGS.has(name)) throw new CliError(t("cli.args.flagNoValue", { flag: name, value: a.slice(eq + 1) }));
+    else out.push(a);
+  }
+  return out;
+}
+
+// argv (process.argv.slice(2)) -> parse result. Throws on error (the caller exits with 1).
 export function parseArgs(argv) {
   const result = {
     mode: "interactive",
-    version: "",             // 통합 대상 프로젝트의 초기 버전 (--project-version)
+    version: "",             // initial version of the target project (--project-version)
     types: [],
     primaryType: "",
-    includeSemverAuto: null,  // --semver-auto / --no-semver-auto (기본 true — 미지정 시 다운스트림에서 해석)
-    includeCopilotAi: null,   // --copilot / --no-copilot (기본 false — AI Credits를 소비하는 opt-in)
-    pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
-    mainBranch: "",          // 릴리스 브랜치 (--main-branch). 빈값=감지된 default branch
-    developBranch: "",       // 개발 브랜치 (--develop-branch). 빈값=develop
-    deployStyle: "",         // 서버 배포 방식 (--deploy-style). 빈값=version.yml 저장값 → simple
-    // 타입 전용 플래그 필드(예: Flutter 환경변수 방식·스토어 대상·배포 모드) — 미지정 값은 타입 훅이 정한다.
+    includeSemverAuto: null,  // --semver-auto / --no-semver-auto (default true; resolved downstream when unset)
+    includeCopilotAi: null,   // --copilot / --no-copilot (default false; opt-in because it consumes AI Credits)
+    pathsCsv: "",            // raw "flutter=app,react=client" (normalized in the resolve step)
+    mainBranch: "",          // release branch (--main-branch). empty = detected default branch
+    developBranch: "",       // development branch (--develop-branch). empty = develop
+    deployStyle: "",         // server deploy style (--deploy-style). empty = saved version.yml value -> simple
+    // Type-specific flag fields (e.g. Flutter env mode, store targets, deploy mode); unset values are decided by the type hook.
     ...Object.fromEntries(TYPE_CLI_FLAGS.map((f) => [f.field, f.initial])),
+    lang: "",                // message language (--lang). empty = env var -> saved version.yml value -> en
     force: false,
     help: false,
-    showVersion: false,      // -v/--version → 패키지 버전 출력 (npm 관례)
-    dryRun: false,        // --dry-run: 실제 변경 없이 미리보기만 (full/uninstall)
-    purgeReadme: false,       // --purge-readme: uninstall --force 시 README 버전 섹션도 제거
-    purgeGitignore: false,    // --purge-gitignore: uninstall --force 시 .gitignore 자동 추가 항목도 제거
-    purgeVersion: false,      // --purge-version: uninstall --force 시 version.yml도 제거
-    // purge 전용 플래그 (숨김 모드 — HELP_TEXT에는 노출하지 않는다).
-    yes: false,               // --yes: purge 실행 확인 (필수, --force로 대체 불가)
-    allowDirty: false,        // --allow-dirty: git 작업트리 dirty 상태에서도 강행
-    deleteDevelopBranch: false, // --delete-develop-branch: 로컬 develop 브랜치까지 삭제
+    showVersion: false,      // -v/--version -> print the package version (npm convention)
+    dryRun: false,        // --dry-run: preview only, no changes (full/uninstall)
+    purgeReadme: false,       // --purge-readme: also remove the README version section on uninstall --force
+    purgeGitignore: false,    // --purge-gitignore: also remove auto-added .gitignore entries on uninstall --force
+    purgeVersion: false,      // --purge-version: also remove version.yml on uninstall --force
+    // purge-only flags (hidden mode; not shown in the help text).
+    yes: false,               // --yes: confirms purge (required; --force cannot replace it)
+    allowDirty: false,        // --allow-dirty: proceed even with a dirty git working tree
+    deleteDevelopBranch: false, // --delete-develop-branch: also delete the local develop branch
     keepVersionYml: false,
     keepReadme: false,
     keepChangelog: false,
     keepWorkflows: false,
     keepScripts: false,
   };
-  const args = [...argv];
-  const seenFlags = new Set(); // --semver-auto/--copilot류 상호 모순 플래그 검증용
+  const args = expandInlineValues(argv);
+  const seenFlags = new Set(); // for validating mutually exclusive flags such as --semver-auto/--copilot
   while (args.length > 0) {
     const a = args.shift();
     const typeFlag = TYPE_CLI_FLAG_BY_NAME.get(a);
@@ -55,14 +90,14 @@ export function parseArgs(argv) {
       case "-m": case "--mode":
         result.mode = args.shift() ?? ""; break;
       case "-v": case "--version":
-        // npm 관례: -v/--version 은 패키지 버전 출력. (초기 버전 지정은 --project-version)
+        // npm convention: -v/--version prints the package version (use --project-version for the initial version).
         result.showVersion = true; break;
       case "--project-version": {
-        // 릴리스 워크플로우(version_manager)는 x.y.z만 올릴 수 있다 — 흔한 v 접두사는 떼고 받는다.
+        // The release workflow (version_manager) can only bump x.y.z, so accept the common v prefix and strip it.
         const raw = (args.shift() ?? "").trim();
         const v = raw.replace(/^v/i, "");
         if (!/^\d+\.\d+\.\d+$/.test(v)) {
-          throw new CliError(`--project-version 값이 올바르지 않습니다: '${raw}' (x.y.z 형식, 예: 1.0.0)`);
+          throw new CliError(t("cli.args.projectVersionInvalid", { raw }));
         }
         result.version = v; break;
       }
@@ -70,21 +105,32 @@ 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 name of csv.split(",")) {
+          name = name.replace(/\s/g, "");
+          if (name === "") continue;
+          if (seen.has(name)) continue;      // dedup
+          if (!VALID_TYPES.includes(name)) {
+            throw new CliError(t("cli.args.typeUnsupported", { type: name, valid: VALID_TYPES.join(" ") }));
           }
-          seen.add(t);
-          types.push(t);
+          seen.add(name);
+          types.push(name);
         }
-        if (types.length === 0) throw new CliError("--type 인자가 비어 있습니다");
+        if (types.length === 0) throw new CliError(t("cli.args.typeEmpty"));
         result.types = types;
         result.primaryType = types[0];
         break;
       }
+      case "--lang": {
+        // Errors here always use the default language (en) so they stay stable regardless of the provisional language.
+        const supported = SUPPORTED_LANGUAGES.join(", ");
+        const raw = args.shift();
+        const v = normalizeLanguage(raw);
+        if (!v) throw new CliError(t("cli.lang.missing", { supported }, DEFAULT_LANGUAGE));
+        if (!isSupportedLanguage(v)) {
+          throw new CliError(t("cli.lang.invalid", { value: String(raw).trim(), source: "--lang", supported }, DEFAULT_LANGUAGE));
+        }
+        result.lang = v; break;
+      }
       case "--force": result.force = true; break;
       case "--dry-run": result.dryRun = true; break;
       case "--purge-readme": result.purgeReadme = true; break;
@@ -101,50 +147,50 @@ export function parseArgs(argv) {
       case "--deploy-style": {
         const v = args.shift();
         if (!isDeployStyle(v)) {
-          throw new CliError(`--deploy-style 값이 올바르지 않습니다: ${v ?? "(없음)"} (${[...DEPLOY_STYLES.map((s) => s.value), NO_DEPLOY_STYLE].join(" | ")})`);
+          throw new CliError(t("cli.args.deployStyleInvalid", {
+            value: v ?? t("cli.args.noValue"), choices: [...DEPLOY_STYLES.map((s) => s.value), NO_DEPLOY_STYLE].join(" | "),
+          }));
         }
         result.deployStyle = v; break;
       }
       case "--semver-auto":
-        if (seenFlags.has("--no-semver-auto")) throw new CliError("--semver-auto와 --no-semver-auto는 동시에 지정할 수 없습니다");
+        if (seenFlags.has("--no-semver-auto")) throw new CliError(t("cli.args.semverConflict"));
         seenFlags.add("--semver-auto"); result.includeSemverAuto = true; break;
       case "--no-semver-auto":
-        if (seenFlags.has("--semver-auto")) throw new CliError("--semver-auto와 --no-semver-auto는 동시에 지정할 수 없습니다");
+        if (seenFlags.has("--semver-auto")) throw new CliError(t("cli.args.semverConflict"));
         seenFlags.add("--no-semver-auto"); result.includeSemverAuto = false; break;
       case "--copilot":
-        if (seenFlags.has("--no-copilot")) throw new CliError("--copilot과 --no-copilot은 동시에 지정할 수 없습니다");
+        if (seenFlags.has("--no-copilot")) throw new CliError(t("cli.args.copilotConflict"));
         seenFlags.add("--copilot"); result.includeCopilotAi = true; break;
       case "--no-copilot":
-        if (seenFlags.has("--copilot")) throw new CliError("--copilot과 --no-copilot은 동시에 지정할 수 없습니다");
+        if (seenFlags.has("--copilot")) throw new CliError(t("cli.args.copilotConflict"));
         seenFlags.add("--no-copilot"); result.includeCopilotAi = false; break;
       case "--paths": {
-        // 값이 없는데 조용히 자동 감지로 넘어가면 사용자가 지정했다고 믿은 경로와 다르게 설치된다.
+        // Silently falling back to auto-detection would install to paths other than the ones the user thinks they set.
         const v = (args.shift() ?? "").trim();
-        if (!v) throw new CliError("--paths 인자가 비어 있습니다 (예: --paths flutter=app,react=client)");
+        if (!v) throw new CliError(t("cli.args.pathsEmpty"));
         result.pathsCsv = v; break;
       }
       case "--main-branch": case "--develop-branch": {
         const v = (args.shift() ?? "").trim();
-        if (!v) throw new CliError(`${a}에 빈 값을 지정할 수 없습니다`);
-        // 워크플로우 트리거·셸 명령에 그대로 치환되는 값이라 쓸 수 없는 이름은 설치 전에 거부한다.
-        if (!isValidBranchName(v)) throw new CliError(`${a} 값이 브랜치 이름으로 올바르지 않습니다: '${v}'`);
+        if (!v) throw new CliError(t("cli.args.branchEmpty", { flag: a }));
+        // The value is substituted into workflow triggers and shell commands, so reject unusable names before installing.
+        if (!isValidBranchName(v)) throw new CliError(t("cli.args.branchInvalid", { flag: a, value: v }));
         if (a === "--main-branch") result.mainBranch = v; else result.developBranch = v;
         break;
       }
       case "-h": case "--help": result.help = true; break;
       default:
-        throw new CliError(`알 수 없는 옵션: ${a}`);
+        throw new CliError(t("cli.args.unknownOption", { option: a }));
     }
   }
   if (!VALID_MODES.includes(result.mode)) {
-    throw new CliError(
-      `지원하지 않는 모드: '${result.mode}'\n지원 모드: interactive full uninstall status doctor`
-    );
+    throw new CliError(t("cli.args.modeUnsupported", { mode: result.mode }));
   }
   return result;
 }
 
-// "flutter=app,react=client" → Map<type, normalizedPath>. 타입 검증(무효 → throw).
+// "flutter=app,react=client" -> Map<type, normalizedPath>. Validates types (invalid -> throw).
 export function parsePathsCsv(csv) {
   const map = new Map();
   if (!csv) return map;
@@ -154,11 +200,11 @@ export function parsePathsCsv(csv) {
     const type = (eq >= 0 ? pair.slice(0, eq) : pair).replace(/\s/g, "");
     const rawPath = eq >= 0 ? pair.slice(eq + 1) : "";
     if (!VALID_TYPES.includes(type)) {
-      throw new CliError(`--paths에 지원하지 않는 타입: '${type}'`);
+      throw new CliError(t("cli.args.pathsTypeUnsupported", { type }));
     }
     const path = normalizePath(rawPath);
     if (!isRepoRelativePath(path)) {
-      throw new CliError(`--paths는 레포 안의 상대경로만 지정할 수 있습니다: '${type}=${rawPath.trim()}'`);
+      throw new CliError(t("cli.args.pathsRelativeOnly", { pair: `${type}=${rawPath.trim()}` }));
     }
     map.set(type, path);
   }

package/src/cli/help.js

@@ -1,6 +1,7 @@
 import { TYPE_IDS } from "../core/types.js";
+import { t, getLanguage, SUPPORTED_LANGUAGES } from "../i18n/index.js";
 
-// 지원 타입 목록 — 레지스트리 순서대로 한 줄 40자 안쪽에서 줄바꿈하고, 이어지는 줄은 "지원: " 뒤에 맞춘다.
+// Supported type list: wrapped at 40 characters per line in registry order; continuation lines align after the "Supported:" label.
 function typeListLines(width = 40) {
   const lines = [];
   for (const id of TYPE_IDS) {
@@ -11,43 +12,9 @@ function typeListLines(width = 40) {
   return lines.join(`\n${" ".repeat(33)}`);
 }
 
-// --help 텍스트.
-export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-native 릴리스 자동화 설치 마법사
-
-사용법:
-  npx project-auto-wizard [옵션]
-
-옵션:
-  -m, --mode MODE          통합 모드 (full | uninstall | status | doctor)
-                           기본: interactive (대화형). full = 설치 및 업데이트
-                           uninstall = 완전 삭제(대화형 체크리스트, --force 시 --purge-*로 opt-in)
-                           status = 설치 상태·드리프트 확인(읽기 전용). doctor = 환경 진단(읽기 전용)
-  -t, --type CSV           프로젝트 타입 csv (예: spring,react,python)
-                           지원: ${typeListLines()}
-      --project-version V  통합 대상의 초기 버전 (예: 1.0.0). 미지정 시 자동 감지
-      --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
-      --main-branch B      릴리스 브랜치 (기본: 감지된 default branch)
-      --develop-branch B   개발 브랜치 (기본: develop). 릴리스 브랜치와 같으면 trunk-based 모드
-      --deploy-style STYLE           서버 배포 방식: simple | nginx | traefik | none (기본: simple)
-      --flutter-env-mode MODE        Flutter 환경변수 방식: dart-define | dotenv (기본: 신규 설치 dart-define, 기존 설치는 저장값·dotenv 유지)
-      --flutter-store CSV            Flutter 스토어 배포 대상: android,ios | android | ios | none (기본: 둘 다 설치)
-      --android-deploy-mode MODE     Play Store 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
-      --ios-deploy-mode MODE         iOS 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
-      --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
-      --copilot / --no-copilot  Copilot으로 AI 요약 생성 (기본: 사용 안 함, GitHub Copilot AI Credits 소비)
-      --force              full 실행에 필수, uninstall은 비대화형 삭제 (모든 확인 생략, 기본값 사용)
-      --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/uninstall 지원)
-      --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
-      --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거
-      --purge-version       --mode uninstall --force 시 version.yml도 제거
-  -v, --version            project-auto-wizard 버전 출력
-  -h, --help               이 도움말 표시
-
-예시:
-  npx project-auto-wizard --mode full --force --type spring,react
-  npx project-auto-wizard --mode full --force --type flutter --paths "flutter=app"
-  npx project-auto-wizard --mode status
-  npx project-auto-wizard --mode doctor
-  npx project-auto-wizard --mode full --force --type node --dry-run
-  npx project-auto-wizard --mode uninstall --force --purge-readme --purge-gitignore --purge-version
-`;
+// --help text. Built lazily because the language is only resolved after import time;
+// `lang` lets callers (docs checks) render a specific language regardless of the current one.
+export const helpText = (lang = getLanguage()) => t("cli.help.text", {
+  types: typeListLines(),
+  langHelp: t("cli.lang.help", { supported: SUPPORTED_LANGUAGES.join(" | ") }, lang),
+}, lang);