project-auto-wizard 0.13.3 → 0.14.0

package/src/core/wizard-labels.js

@@ -1,44 +1,49 @@
-// wizard-prompts.yml 라벨 메타 파서.
-// ⚠️ YAML 라이브러리 금지 — 라인 기반 파싱만 한다(외부 의존성 0, 형식이 조금 어긋난 사용자 파일도 읽힌다).
+// wizard-prompts.yml label metadata parser.
+// WARNING: no YAML library - line-based parsing only (zero external dependencies, and slightly malformed user files still read).
 import { join } from "node:path";
 import * as nodeFs from "node:fs";
 import { PAYLOAD } from "./paths.js";
+import { getLanguage } from "../i18n/index.js";
 
-// wizard-prompts.yml 위치 — 사용자 레포(커스텀 오버라이드용) 기준 상대경로
+// Location of wizard-prompts.yml - path relative to the user repo (for custom overrides)
 export const LABELS_FILE = ".github/config/wizard-prompts.yml";
 
-// 따옴표 감싸진 값이면 벗기고 trim ("값" → 값).
+// Strip surrounding quotes and trim ("value" -> value).
 function unquote(s) {
   const t = s.trim();
   if (t.startsWith('"') && t.endsWith('"') && t.length >= 2) return t.slice(1, -1);
   return t;
 }
 
-// wizard-prompts.yml 텍스트 → 파싱 객체 (순수 함수 — 테스트 직접 사용 가능).
-// 반환: { fields: Map<조회키, {label?,help?,example?}>, workflowNames: [{key,value}] }
-//  - 조회키: "PROJECT_NAME" 또는 "flutter.APP_ARTIFACT_NAME" (dotted 타입 오버라이드)
-//  - 구형 1줄(KEY: "라벨")은 fields의 label로 흡수 (label만 의미)
+// wizard-prompts.yml text -> parsed object (pure function - usable directly in tests).
+// Returns: { fields: Map<lookup key, {label?,help?,example?}>, workflowNames: [{key,value}] }
+//  - lookup key: "PROJECT_NAME" or "flutter.APP_ARTIFACT_NAME" (dotted per-type override)
+//  - the legacy one-liner (KEY: "label") is absorbed as the fields label (label only)
+//  - a language variant is a suffixed field (label_ko) or a suffixed names block (_workflow_names_ko);
+//    the plain field/block is the default-language text
 export function parseWizardPrompts(text) {
   const fields = new Map();
   const workflowNames = [];
-  let current = null;       // 현재 블록의 fields 엔트리 (들여쓰기 라인 소속처)
-  let inWfNames = false;    // _workflow_names 블록 내부 여부
+  let current = null;       // fields entry of the current block (owner of indented lines)
+  let inWfNames = false;    // whether inside a _workflow_names block
+  let wfLang = null;        // language of that block (null = the plain default block)
 
   for (const raw of String(text).split(/\r?\n/)) {
     const line = raw.replace(/\r$/, "");
-    if (!line.trim() || line.trim().startsWith("#")) continue; // 빈 줄·주석은 블록을 끊지 않음
+    if (!line.trim() || line.trim().startsWith("#")) continue; // blank lines and comments do not end a block
 
     if (!/^\s/.test(line)) {
-      // 최상위 키 라인 — 이전 블록 종료
+      // top-level key line - ends the previous block
       current = null; inWfNames = false;
       const m = line.match(/^([A-Za-z_][A-Za-z0-9_.\-]*):(.*)$/);
       if (!m) continue;
       const key = m[1];
       const rest = m[2].trim();
-      if (key === "_workflow_names") { inWfNames = true; continue; }
+      const wfBlock = key.match(/^_workflow_names(?:_([a-z]{2}))?$/);
+      if (wfBlock) { inWfNames = true; wfLang = wfBlock[1] ?? null; continue; }
       const entry = fields.get(key) || {};
       if (rest) {
-        // 구형 1줄: KEY: "라벨" (label로만 사용)
+        // legacy one-liner: KEY: "label" (used as label only)
         const q = rest.match(/^"([^"]*)"\s*$/);
         if (q) entry.label = q[1];
       }
@@ -47,28 +52,28 @@ export function parseWizardPrompts(text) {
       continue;
     }
 
-    // 들여쓰기 라인 — 현재 블록 소속
+    // indented line - belongs to the current block
     const m = line.match(/^\s+([A-Za-z_][A-Za-z0-9_.\-]*):\s*(.*)$/);
     if (!m) continue;
     if (inWfNames) {
-      // "  KEY: "값"" 형식만 인정
+      // only the `  KEY: "value"` form is accepted
       const q = m[2].match(/^"(.*)"\s*$/);
-      if (q) workflowNames.push({ key: m[1], value: q[1] });
+      if (q) workflowNames.push(wfLang ? { key: m[1], value: q[1], lang: wfLang } : { key: m[1], value: q[1] });
       continue;
     }
-    if (current && (m[1] === "label" || m[1] === "help" || m[1] === "example")) {
-      // 블록 내 첫 등장만 채택
+    if (current && /^(?:label|help|example)(?:_[a-z]{2})?$/.test(m[1])) {
+      // only the first occurrence in a block is taken
       if (current[m[1]] == null) current[m[1]] = unquote(m[2]);
     }
   }
   return { fields, workflowNames };
 }
 
-// wizard-prompts.yml을 찾아 읽고 파싱.
-// 번들본(payload/config)을 바탕으로 대상 프로젝트의 사용자 파일(커스텀 오버라이드)을 키 단위로 덮어쓴다.
-// WHY 병합: 사용자 파일에는 바꾸고 싶은 키만 적는 것이 자연스럽다 — 파일째 대체하면 적지 않은 나머지
-//          질문의 label/help/example과 워크플로우 표시명이 전부 사라져 KEY명만 보인다.
-// fs 주입 가능(테스트용) — 기본 node:fs.
+// Find, read and parse wizard-prompts.yml.
+// The target project's user file (custom override) is layered over the bundled copy (payload/config) key by key.
+// WHY merge: it is natural for a user file to list only the keys to change - replacing the whole file would drop the
+//          label/help/example of every unlisted question and the workflow display names, leaving only KEY names.
+// fs is injectable (for tests) - defaults to node:fs.
 export function loadWizardPrompts(targetRoot = ".", payloadRoot = "", fs = nodeFs) {
   const read = (p) => (fs.existsSync(p) ? parseWizardPrompts(fs.readFileSync(p, "utf8")) : null);
   const bundled = payloadRoot ? read(join(payloadRoot, PAYLOAD.configDir, "wizard-prompts.yml")) : null;
@@ -77,39 +82,56 @@ export function loadWizardPrompts(targetRoot = ".", payloadRoot = "", fs = nodeF
   return mergeWizardPrompts(bundled, user);
 }
 
-// 번들 + 사용자 파싱 결과 병합. 같은 키는 사용자가 적은 필드만 덮어쓴다(label만 바꾸면 help/example은 번들 유지).
+// Merge the bundled and user parse results. For the same key only fields the user wrote are overridden (changing only label keeps the bundled help/example).
 export function mergeWizardPrompts(base, override) {
   const fields = new Map([...base.fields].map(([k, v]) => [k, { ...v }]));
   for (const [key, entry] of override.fields) {
     const merged = { ...(fields.get(key) || {}) };
-    for (const [f, v] of Object.entries(entry)) if (v != null && v !== "") merged[f] = v;
+    const given = Object.entries(entry).filter(([, v]) => v != null && v !== "");
+    // A plain field written by the user must win in every language, so the bundled variants of it are dropped.
+    // This runs before any user value is applied, so the user's own variants survive whatever order they were written in.
+    for (const [f] of given) {
+      if (!/_[a-z]{2}$/.test(f)) for (const k of Object.keys(merged)) if (k.startsWith(`${f}_`)) delete merged[k];
+    }
+    for (const [f, v] of given) merged[f] = v;
     fields.set(key, merged);
   }
-  const overridden = new Set(override.workflowNames.map((w) => w.key));
-  const workflowNames = [...base.workflowNames.filter((w) => !overridden.has(w.key)), ...override.workflowNames];
+  // A plain user name replaces the bundled name of every language (the user wrote it for their own repo);
+  // a language-tagged one replaces only that language.
+  const overridden = new Set(override.workflowNames.map((w) => `${w.key}|${w.lang ?? "*"}`));
+  const isOverridden = (w) => overridden.has(`${w.key}|${w.lang ?? "*"}`) || overridden.has(`${w.key}|*`);
+  const workflowNames = [...base.workflowNames.filter((w) => !isOverridden(w)), ...override.workflowNames];
   return { fields, workflowNames };
 }
 
-// 필드 조회. field: "label" | "help" | "example".
-// 우선순위: "{type}.KEY" 블록 → "KEY" 블록(구형 1줄 포함) → 폴백(label이면 KEY명, 아니면 "").
-export function wfField(prompts, type, key, field) {
+// Field lookup. field: "label" | "help" | "example".
+// Priority: "{type}.KEY" block -> "KEY" block (including the legacy one-liner) -> fallback (KEY name for label, otherwise "").
+// Within a block the current language's variant (label_ko) comes before the plain field.
+export function wfField(prompts, type, key, field, lang = getLanguage()) {
   if (prompts && prompts.fields) {
     for (const q of [`${type}.${key}`, key]) {
-      const v = prompts.fields.get(q)?.[field];
-      if (v != null && v !== "") return v;
+      const entry = prompts.fields.get(q);
+      for (const f of [`${field}_${lang}`, field]) {
+        const v = entry?.[f];
+        if (v != null && v !== "") return v;
+      }
     }
   }
   return field === "label" ? key : "";
 }
 
-// 워크플로우 파일명 → 사람이 읽는 짧은 이름.
-// _workflow_names에서 "키가 파일명에 포함되면" 그 값 사용 — 최장 키 우선(REACT-CI vs REACT-CICD 구분).
-// 미매칭이면 .yaml/.yml 확장자만 제거해 반환.
-export function workflowDisplayName(prompts, filename) {
-  const base = String(filename).split("/").pop().split("\\").pop(); // 경로 제거
-  let best = null; let bestLen = 0;
-  for (const { key, value } of prompts?.workflowNames ?? []) {
-    if (base.includes(key) && key.length > bestLen) { best = value; bestLen = key.length; }
+// Workflow filename -> short human-readable name.
+// From _workflow_names, use the value "when the key is contained in the filename" - longest key wins (tells REACT-CI from REACT-CICD).
+// If nothing matches, return the name with only the .yaml/.yml extension removed.
+// A name tagged with the current language wins over a plain one at the same length.
+export function workflowDisplayName(prompts, filename, lang = getLanguage()) {
+  const base = String(filename).split("/").pop().split("\\").pop(); // strip the path
+  let best = null; let bestLen = 0; let bestTagged = false;
+  for (const { key, value, lang: l } of prompts?.workflowNames ?? []) {
+    if (l && l !== lang) continue;
+    if (!base.includes(key)) continue;
+    const tagged = Boolean(l);
+    if (key.length > bestLen || (key.length === bestLen && tagged && !bestTagged)) { best = value; bestLen = key.length; bestTagged = tagged; }
   }
   if (best != null) return best;
   return base.replace(/\.ya?ml$/, "");

package/src/i18n/catalog/en/cli.js

@@ -0,0 +1,50 @@
+// English messages: argument parsing, --help, entry point (bin/, src/index.js, src/cli, src/context.js).
+export default {
+  "cli.lang.invalid": "Unsupported language '{value}' ({source}). Supported: {supported}",
+  "cli.lang.defaultNotice": "Workflow messages now default to English. Use --lang ko to keep Korean.",
+  "cli.lang.missing": "--lang requires a value. Supported: {supported}",
+  "cli.lang.help": "Message language: {supported} (default: en)",
+  "cli.bin.nodeVersion": "Node.js 20.12 or later is required (current: {current})",
+  "cli.help.text": "project-auto-wizard — One command DevOps: GitHub-native release automation setup wizard\n\nUsage:\n  npx project-auto-wizard [options]\n\nOptions:\n  -m, --mode MODE          Unified mode (full | uninstall | status | doctor)\n                           Default: interactive. full = install and update\n                           uninstall = full removal (interactive checklist; with --force, opt in via --purge-*)\n                           status = check install state and drift (read-only). doctor = environment diagnosis (read-only)\n  -t, --type CSV           Project types as csv (e.g. spring,react,python)\n                           Supported: {types}\n      --project-version V  Initial version of the target (e.g. 1.0.0). Auto-detected when omitted\n      --paths \"t=p,...\"    Per-type project paths (monorepo). e.g. flutter=app,react=client\n      --main-branch B      Release branch (default: detected default branch)\n      --develop-branch B   Development branch (default: develop). Same as the release branch = trunk-based mode\n      --deploy-style STYLE           Server deploy style: simple | nginx | traefik | none (default: simple)\n      --flutter-env-mode MODE        Flutter env var mode: dart-define | dotenv (default: dart-define for new installs; existing installs keep the saved value / dotenv)\n      --flutter-store CSV            Flutter store deploy targets: android,ios | android | ios | none (default: install both)\n      --android-deploy-mode MODE     Play Store deploy mode: store_only | store_prepare | store_submit (default: store_only)\n      --ios-deploy-mode MODE         iOS deploy mode: store_only | store_prepare | store_submit (default: store_only)\n      --semver-auto / --no-semver-auto  Auto major/minor/patch bump from commit types (default: enabled)\n      --copilot / --no-copilot  Generate the AI summary with Copilot (default: off; consumes GitHub Copilot AI Credits)\n      --lang LANG          {langHelp}\n      --force              Required for full; non-interactive removal for uninstall (skips all confirmations, uses defaults)\n      --dry-run            Preview what would change without touching any file (supported by full/uninstall)\n      --purge-readme        With --mode uninstall --force, also remove the README.md version section\n      --purge-gitignore     With --mode uninstall --force, also remove the auto-added .gitignore entries\n      --purge-version       With --mode uninstall --force, also remove version.yml\n  -v, --version            Print the project-auto-wizard version\n  -h, --help               Show this help\n\nExamples:\n  npx project-auto-wizard --mode full --force --type spring,react\n  npx project-auto-wizard --mode full --force --type flutter --paths \"flutter=app\"\n  npx project-auto-wizard --mode status\n  npx project-auto-wizard --mode doctor\n  npx project-auto-wizard --mode full --force --type node --dry-run\n  npx project-auto-wizard --mode uninstall --force --purge-readme --purge-gitignore --purge-version\n",
+  "cli.args.projectVersionInvalid": "Invalid --project-version value: '{raw}' (x.y.z format, e.g. 1.0.0)",
+  "cli.args.typeUnsupported": "Unsupported type: '{type}'\nSupported types: {valid}",
+  "cli.args.typeEmpty": "The --type argument is empty",
+  "cli.args.noValue": "(none)",
+  "cli.args.deployStyleInvalid": "Invalid --deploy-style value: {value} ({choices})",
+  "cli.args.semverConflict": "--semver-auto and --no-semver-auto cannot be specified together",
+  "cli.args.copilotConflict": "--copilot and --no-copilot cannot be specified together",
+  "cli.args.pathsEmpty": "The --paths argument is empty (e.g. --paths flutter=app,react=client)",
+  "cli.args.branchEmpty": "{flag} cannot be empty",
+  "cli.args.branchInvalid": "{flag} value is not a valid branch name: '{value}'",
+  "cli.args.flagNoValue": "{flag} does not take a value (got {flag}={value})",
+  "cli.args.unknownOption": "Unknown option: {option}",
+  "cli.args.modeUnsupported": "Unsupported mode: '{mode}'\nSupported modes: interactive full uninstall status doctor",
+  "cli.args.pathsTypeUnsupported": "Unsupported type in --paths: '{type}'",
+  "cli.args.pathsRelativeOnly": "--paths accepts only paths relative to the repo: '{pair}'",
+  "cli.index.purgePrompt": "To run purge, type this repo name exactly: {repoName}\n> ",
+  "cli.index.dryRunNeedsMode": "Use --dry-run together with --mode <full|uninstall> (it is not supported in interactive mode).",
+  "cli.index.noTty": "Interactive input is not available in this environment. Specify --mode <full|uninstall> and --force.",
+  "cli.index.ignoredFlags": "Interactive mode does not use {flags}; choose them in the questions or use them with --mode full --force.",
+  "cli.index.purgeNotGit": "Not a git repository (no .git); purge can only run inside a git repository.",
+  "cli.index.deleteDevelopSkipDry": "(--delete-develop-branch given: this is a trunk-based setup (develop === main), so the real run will skip the deletion too)",
+  "cli.index.deleteDevelopTryDry": "(--delete-develop-branch given: the real run will also try to delete the local develop branch)",
+  "cli.index.purgeNeedsYes": "purge cannot run without --yes (--force cannot replace it).",
+  "cli.index.purgeGitStatusFailed": "Could not check the git status; aborting purge for safety.",
+  "cli.index.purgeDirty": "The working tree has uncommitted changes, which cannot be recovered after purge. Commit them or use --allow-dirty.",
+  "cli.index.forceRequiredNonTty": "The --force option is required in a non-interactive environment.",
+  "cli.index.purgeRepoMismatch": "The repo name you typed does not match; aborting purge.",
+  "cli.index.deleteDevelopSkip": "This is a trunk-based setup (develop === main); skipping deletion of the release branch.",
+  "cli.index.reasonUnknown": "reason unknown",
+  "cli.index.deleteDevelopFailed": "Failed to delete local branch '{branch}' ({reason}); please check it manually.",
+  "cli.index.deleteDevelopDone": "Deleted local branch '{branch}'.",
+  "cli.index.removedWorkflows": "{n} workflows",
+  "cli.index.removedScripts": "{n} scripts",
+  "cli.index.removedAppFiles": "{n} Flutter app files",
+  "cli.index.removedReadme": "README version section",
+  "cli.index.removedGitignore": "auto-added .gitignore entries",
+  "cli.index.removed": "Removed: {removed}",
+  "cli.index.forceRequired": "This mode cannot run without --force (there is no confirmation step).",
+  "cli.index.mainBranchHint": "If this is wrong, specify it with --main-branch.",
+  "cli.index.deployFallback": "{types} has no {style} zero-downtime deploy workflow, so it is installed with the single-server deploy (simple).",
+  "cli.index.aborted": "Aborted; exiting without changes.",
+};

package/src/i18n/catalog/en/commands.js

@@ -0,0 +1,187 @@
+// English messages: commands (status, doctor, dry-run, full, uninstall, purge).
+export default {
+  "cmd.status.title": "project-auto-wizard status — install state",
+  "cmd.status.notInstalled": "project-auto-wizard is not installed in this directory (no version.yml).",
+  "cmd.status.version": "Version         : {value}",
+  "cmd.status.templateVersion": "Template version: {value}",
+  "cmd.status.types": "Project types   : {value}",
+  "cmd.status.none": "(none)",
+  "cmd.status.branchMode": "Branch mode     : {mode} ({main} / {develop})",
+  "cmd.status.unsetDefaultFalse": "unset (default false)",
+  "cmd.status.options": "Options         : {value}",
+  "cmd.status.modified": "Workflow files modified by the user ({n}):",
+  "cmd.status.unmodified": "All workflow files match their install-time defaults (no modifications).",
+  "cmd.status.stale": "Old workflows not in the current version ({n}; cleaned up on the next update):",
+  "cmd.status.bucketsTitle": "If you update now:",
+  "cmd.status.bucketAuto": "  Upstream changed - auto-applicable    {n}",
+  "cmd.status.bucketLocalKept": "  Edited by me - upstream unchanged     {n}   (kept)",
+  "cmd.status.bucketConflicts": "  Changed on both sides - needs review  {n}",
+  "cmd.status.bucketRemoved": "  Deleted by me - not restored          {n}",
+  "cmd.doctor.docPath.postInstall": "/start/quickstart/#post-install",
+  "cmd.doctor.docPath.flutterStore": "/project-types/flutter/#flutter-store",
+  "cmd.doctor.install.name": "Installed",
+  "cmd.doctor.install.label": "Install status",
+  "cmd.doctor.install.purpose": "Whether the wizard is installed in this folder",
+  "cmd.doctor.install.value": "version.yml found",
+  "cmd.doctor.install.note": "Not installed in this folder yet; you can install now.",
+  "cmd.doctor.gh.purpose": "For reading repo settings",
+  "cmd.doctor.gh.notFound": "The gh CLI was not found.",
+  "cmd.doctor.gh.notFoundImpact": "Repo permissions and secrets cannot be read, so all remote checks below are skipped.",
+  "cmd.doctor.gh.notFoundAction": "Install the gh CLI from https://cli.github.com/ and run again",
+  "cmd.doctor.gh.installed": "installed",
+  "cmd.doctor.auth.name": "gh auth",
+  "cmd.doctor.auth.label": "GitHub login",
+  "cmd.doctor.auth.purpose": "Permission to read repo settings",
+  "cmd.doctor.auth.notLoggedIn": "Not logged in.",
+  "cmd.doctor.auth.impact": "Repo settings cannot be read, so all remote checks below are skipped.",
+  "cmd.doctor.auth.action": "Run `gh auth login` in a terminal",
+  "cmd.doctor.auth.ok": "authenticated",
+  "cmd.doctor.remote.name": "GitHub remote",
+  "cmd.doctor.remote.purpose": "Identify the repo to check",
+  "cmd.doctor.remote.notFound": "Could not find a GitHub owner/repo in the origin remote.",
+  "cmd.doctor.remote.impact": "It is unknown which repo to check, so all remote checks below are skipped.",
+  "cmd.doctor.remote.action": "Check with `git remote -v` that origin points to a GitHub address",
+  "cmd.doctor.perm.purpose": "Default permissions for workflows you add yourself",
+  "cmd.doctor.adminImpact": "This setting cannot be read without repo admin rights; the value itself may be fine.",
+  "cmd.doctor.perm.lookupFailed": "Could not read the setting.",
+  "cmd.doctor.perm.action": "Ask a repo admin to check Settings → Actions → General → Workflow permissions",
+  "cmd.doctor.perm.unknown": "unknown",
+  "cmd.doctor.perm.infoCurrent": "It is currently {value}; the workflows installed by the wizard each declare their own permissions, so they work as they are.",
+  "cmd.doctor.perm.infoAdvice": "A workflow you add yourself that omits permissions follows this default; raise it to Read and write only in that case.",
+  "cmd.doctor.pat.purpose": "Automatic tag and Release publishing",
+  "cmd.doctor.pat.registered": "registered",
+  "cmd.doctor.pat.note1": "Without the secret, the fallback takes over automatically and still carries through tag and Release publishing and the main deploy workflow; it only takes up to ~20 seconds longer after the actual merge.",
+  "cmd.doctor.pat.note2": "If you want it faster, you can register a PAT; issue it from an organization bot/machine account, never a personal account (scopes: repo, workflow).",
+  "cmd.doctor.pat.note3": "Register: repo Settings → Secrets and variables → Actions → New repository secret · name it WORKFLOW_PAT",
+  "cmd.doctor.merge.name": "automerge compatibility (merge commits allowed)",
+  "cmd.doctor.merge.label": "Merge commits allowed",
+  "cmd.doctor.merge.purpose": "Condition for auto-merging the release PR",
+  "cmd.doctor.merge.lookupFailed": "Could not read the setting.",
+  "cmd.doctor.merge.lookupAction": "Ask a repo admin to check Settings → General → Pull Requests",
+  "cmd.doctor.merge.allowed": "allowed",
+  "cmd.doctor.merge.disabled": "Merge commits are turned off in this repo.",
+  "cmd.doctor.merge.impact": "RELEASE-PUBLISH detects releases from the merge commit title, so the auto-merge flow may break.",
+  "cmd.doctor.merge.action1": "Repo Settings → General → Pull Requests",
+  "cmd.doctor.merge.action2": "Check Allow merge commits",
+  "cmd.doctor.copilot.on": "It is on (copilot_ai: true in version.yml).",
+  "cmd.doctor.copilot.off": "It is off (copilot_ai: false in version.yml); to turn it on, reinstall with --copilot or use the interactive 'Modify > Copilot AI summary'.",
+  "cmd.doctor.copilot.default": "It is off by default (copilot_ai: false in version.yml).",
+  "cmd.doctor.copilot.name": "Copilot AI summary",
+  "cmd.doctor.copilot.purpose": "AI release note generation (optional)",
+  "cmd.doctor.copilot.creditsOn": "GitHub Copilot AI Credits are consumed; organizations need the 'Allow use of Copilot CLI billed to the organization' policy.",
+  "cmd.doctor.copilot.creditsOff": "Turning it on consumes GitHub Copilot AI Credits; organizations need the 'Allow use of Copilot CLI billed to the organization' policy.",
+  "cmd.doctor.copilot.fallback": "When it is off or unavailable, it switches to the rule-based summary automatically, so you can leave it as is.",
+  "cmd.doctor.heading": "Environment check",
+  "cmd.doctor.details": "Details: ",
+  "cmd.doctor.summaryNone": "No problems found.",
+  "cmd.doctor.summaryFail": "Found problems in {n} item(s); some checks could not be run.",
+  "cmd.doctor.summaryWarn": "Found problems in {n} item(s).",
+  "cmd.doctor.summaryWarnNote": "You can install right now, and the {n} above can be set up later.",
+  "cmd.dryRun.header": "project-auto-wizard --dry-run (mode: {mode}) — preview, no files were changed",
+  "cmd.dryRun.uninstall.workflows": "Workflows to be removed ({n}):",
+  "cmd.dryRun.uninstall.scripts": "Scripts to be removed ({n}):",
+  "cmd.dryRun.uninstall.appFile": "Flutter app file to be removed: {file}",
+  "cmd.dryRun.uninstall.readme": "To be removed: README.md version section (AUTO-VERSION-SECTION)",
+  "cmd.dryRun.uninstall.gitignore": "To be removed: auto-added .gitignore entries",
+  "cmd.dryRun.uninstall.versionYml": "File to be removed: version.yml",
+  "cmd.dryRun.full.newFiles": "New files ({n}):",
+  "cmd.dryRun.full.changed": "Files to be changed ({n}; a conflict if the existing install is a user-modified copy):",
+  "cmd.dryRun.full.autoUpdated": "Auto-updated files ({n}; unmodified copies replaced with the latest):",
+  "cmd.dryRun.full.localKept": "Kept as-is ({n}; your edits stay, upstream is unchanged):",
+  "cmd.dryRun.full.removed": "Deleted by you, not restored ({n}):",
+  "cmd.dryRun.full.unchanged": "Identical files ({n}, no change)",
+  "cmd.dryRun.reason.cleanup": "cleanup of the previous deploy style",
+  "cmd.dryRun.reason.storeCleanup": "cleanup of deselected store workflows",
+  "cmd.dryRun.reason.staleCleanup": "cleanup of old workflows not in the current version",
+  "cmd.dryRun.cleanup.removedLine": "  - {file} ({reason})",
+  "cmd.dryRun.cleanup.backedUpLine": "  > {file} → {file}.bak ({reason}; backed up because it was modified)",
+  "cmd.dryRun.cleanup.removedHeading": "Files to be deleted ({n}):",
+  "cmd.dryRun.cleanup.backedUpHeading": "Files to be moved to .bak ({n}):",
+  "cmd.dryRun.gitignore.created": ".gitignore: will be created ({added})",
+  "cmd.dryRun.gitignore.append": ".gitignore: will add {added}",
+  "cmd.dryRun.gitignore.unchanged": ".gitignore: no change (entries already present)",
+  "cmd.dryRun.flutter.created": "Flutter store deploy files — new ({n}):",
+  "cmd.dryRun.flutter.kept": "Flutter store deploy files — existing files kept ({n}, not overwritten):",
+  "cmd.dryRun.flutter.keptLine": "  = {file} (existing file kept)",
+  "cmd.dryRun.versionYml.update": "version.yml: will be updated",
+  "cmd.dryRun.versionYml.unchanged": "version.yml: no change",
+  "cmd.dryRun.versionYml.create": "version.yml: will be created",
+  "cmd.dryRun.versionYml.note": "  (Note: for types with deploy setting questions (spring etc.), the deploy: block is not reflected in the preview, so it may look different from the real install.)",
+  "cmd.dryRun.scripts.create": "new",
+  "cmd.dryRun.scripts.overwrite": "overwrites the existing file with the new version; your own edits are lost",
+  "cmd.dryRun.scripts.unchanged": "no change",
+  "cmd.dryRun.scripts.heading": "Scripts ({dir}/, {n}; always replaced with the new version):",
+  "cmd.dryRun.readme.added": "README.md: a version section will be appended at the end",
+  "cmd.dryRun.readme.skipNoReadme": "README.md: no file, so no version section is added",
+  "cmd.dryRun.readme.skipMarker": "README.md: a version section already exists, no change",
+  "cmd.dryRun.readme.skipVersionLine": "README.md: a version line already exists, no change",
+  "cmd.dryRun.readme.other": "README.md: {status}",
+  "cmd.dryRun.baseline.update": "{path}: will be updated (reference for the next update)",
+  "cmd.dryRun.baseline.create": "{path}: will be created (reference for the next update)",
+  "cmd.full.noWritePermission": "Installation did not start because write permission is missing (no files were changed):\n{list}\nCheck the permissions and run again.",
+  "cmd.full.log.typeEvidence": "{type} (evidence: {evidence})",
+  "cmd.full.log.userChosen": "chosen by user",
+  "cmd.full.log.keepExisting": "{file} (existing file kept)",
+  "cmd.full.log.versionUnchanged": "version.yml (v{version}, code={code}, no change)",
+  "cmd.full.log.scriptOverwritten": " (differed from the existing content, overwritten with the new version)",
+  "cmd.full.log.bytecodeRemoved": "{file} (bytecode committed by an earlier version; commit the deletion too)",
+  "cmd.full.log.gitignoreExisting": ".gitignore (entries already present)",
+  "cmd.full.log.secretOptional": "{name} (optional) ← {users}",
+  "cmd.full.summary.installed": "Installed",
+  "cmd.full.summary.installedValue": "{n} files",
+  "cmd.full.summary.autoUpdated": "Auto-updated",
+  "cmd.full.summary.autoUpdatedValue": "{n} (not modified by the user)",
+  "cmd.full.summary.kept": "Kept",
+  "cmd.full.summary.keptValue": "{n} (user-modified copies)",
+  "cmd.full.summary.unchanged": "Unchanged",
+  "cmd.full.summary.unchangedValue": "{n}",
+  "cmd.full.summary.backup": "Backup replaced",
+  "cmd.full.summary.backupValue": "{n} (.bak created)",
+  "cmd.full.summary.cleanup": "Cleanup",
+  "cmd.full.summary.cleanupValue": "{removed} deleted, {backedUp} moved to .bak",
+  "cmd.full.summary.unresolved": "Unresolved",
+  "cmd.full.summary.unresolvedValue": "{n}",
+  "cmd.full.summary.unresolvedActionValue": "{n}  <- action needed",
+  "cmd.full.summary.secrets": "Required Secrets",
+  "cmd.full.summary.secretsValue": "{n}",
+  "cmd.full.summary.result": "Result",
+  "cmd.full.summary.resultWarn": "Attention ({n} unresolved)",
+  "cmd.full.notice.staleHeading": "Cleaned up old workflows not in the current version (renamed or removed files):",
+  "cmd.full.notice.staleRemoved": "   • {file} — deleted (unmodified file)",
+  "cmd.full.notice.staleBackedUp": "   • {file} → {file}.bak — backed up because you had modified it",
+  "cmd.full.notice.conflictKept": "{n} conflict(s): kept the existing files (upstream changes not applied): {files}",
+  "cmd.full.notice.conflictHint": "   To choose per file, run again in interactive mode (npx project-auto-wizard).",
+  "cmd.uninstall.gitignoreDetail": "auto-added .gitignore entries ({status})",
+  "cmd.uninstall.item.workflows": "Workflows (.github/workflows/PROJECT-*.yaml) + install records (.github/.wizard) + unmodified Flutter app files",
+  "cmd.uninstall.item.scripts": "Scripts (.github/scripts/*.py)",
+  "cmd.uninstall.item.readme": "README.md version section (AUTO-VERSION-SECTION)",
+  "cmd.uninstall.item.gitignore": "Auto-added .gitignore entries",
+  "cmd.uninstall.item.versionYml": "version.yml (all version/branch settings)",
+  "cmd.uninstall.noneSelected": "(no items selected)",
+  "cmd.uninstall.result.workflows": "Removed {n} workflows",
+  "cmd.uninstall.result.scripts": "Removed {n} scripts",
+  "cmd.uninstall.result.appFiles": "Removed {n} Flutter app files",
+  "cmd.uninstall.result.readme": "Removed the README.md version section",
+  "cmd.uninstall.result.gitignore": "Removed auto-added .gitignore entries",
+  "cmd.uninstall.result.versionYml": "Removed version.yml",
+  "cmd.uninstall.result.none": "Nothing was removed.",
+  "cmd.uninstall.flow.nothing": "Nothing to remove.",
+  "cmd.uninstall.flow.title": "Full removal",
+  "cmd.uninstall.flow.select": "Select the items to delete (Space to toggle, Enter to confirm)",
+  "cmd.uninstall.flow.cancelled": "Full removal cancelled.",
+  "cmd.uninstall.flow.plannedTitle": "Items to be deleted",
+  "cmd.uninstall.flow.confirm": "Really delete? This cannot be undone.",
+  "cmd.uninstall.flow.doneTitle": "Full removal complete",
+  "cmd.purge.headerDry": "project-auto-wizard --mode purge --dry-run — preview, no files were changed",
+  "cmd.purge.header": "project-auto-wizard --mode purge — removing the items below",
+  "cmd.purge.workflows": "Workflows ({n}):",
+  "cmd.purge.scripts": "Scripts ({n}):",
+  "cmd.purge.appFile": "Flutter app file: {file}",
+  "cmd.purge.versionYml": "File: version.yml",
+  "cmd.purge.readmeSection": "README.md: AUTO-VERSION-SECTION block",
+  "cmd.purge.gitignore": ".gitignore: auto-added entries (*.bak, *.template.yaml)",
+  "cmd.purge.gitignoreKept": ".gitignore: auto-added entries kept (they hide backup files of the workflows that were left)",
+  "cmd.purge.file": "File: {file}",
+  "cmd.purge.gitignoreLog": "auto-added .gitignore entries",
+  "cmd.purge.removedHeading": "Removed:",
+};

package/src/i18n/catalog/en/copy.js

@@ -0,0 +1,19 @@
+// English messages: copy area (src/core/copy).
+export default {
+  "copy.readme.status.added": "Appended version section to the end of README.md",
+  "copy.readme.status.skipNoReadme": "README.md not found; version section not added",
+  "copy.readme.status.skipMarker": "Version section already present; left as is",
+  "copy.readme.status.skipVersionLine": "Version line already present; left as is",
+  "copy.readme.versionHeading": "## Latest Version : v{version}",
+  "copy.readme.historyLink": "[View full version history](CHANGELOG.md)",
+  "copy.gitignore.newFileHeader": "# project-auto-wizard: backup files created during conflict handling (safe to ignore)",
+  "copy.workflows.error.noPayloadWorkflows": "Package structure error: could not find the payload/workflows folder.",
+  "copy.workflows.log.keepLocal": "{f} (upstream unchanged, keeping user-edited copy)",
+  "copy.workflows.log.autoUpdate": "{f} (not modified by user, replaced with latest)",
+  "copy.workflows.log.restore": "{f} (deleted by user, restore chosen)",
+  "copy.workflows.log.removedKept": "{f} (deleted by user, not restored)",
+  "copy.workflows.log.backup": "{filename} → {filename}.bak (user decision, replaced with new version)",
+  "copy.workflows.log.template": "{filename} kept + {templateName} created (user decision)",
+  "copy.workflows.log.skipDecided": "{filename} (user decision: keep existing, upstream changes not applied)",
+  "copy.workflows.log.skipForce": "{filename} (--force default: keep existing, upstream changes not applied)",
+};

package/src/i18n/catalog/en/core.js

@@ -0,0 +1,74 @@
+// English messages: core area (detect, paths, branches, deploy-style, flutter-*, ...).
+export default {
+  "core.detect.versionFallbackHint": "Set it with --project-version or check version.yml.",
+  "core.detect.versionFallbackWarn": "⚠️  Could not detect the version automatically, using the default 0.0.1 — {tail}",
+  "core.detect.buildNumber.pubspecMissing": "⚠️  pubspec.yaml has no build number (+N), so version_code could not be detected — using the default 1. Check your actual build number.",
+  "core.detect.buildNumber.gradleMissing": "⚠️  android/app/build.gradle has no versionCode, so version_code could not be detected — using the default 1. Check your actual build number.",
+  "core.detect.buildNumber.expoMissing": "⚠️  expo.android.versionCode is missing in app.json, so version_code could not be detected — using the default 1. Check your actual build number.",
+  "core.detectFs.monorepoWarn": "⚠️  No project files found at the root, installing as basic. Found in subfolders: {list}\n   For a monorepo, run again with --paths \"{hint}\".",
+  "core.detectFs.defaultBranchWarn": "⚠️  Could not determine the remote default branch (e.g. an empty remote repo), assuming '{fallback}' as the release branch.{hint}",
+  "core.branches.developMissing": "The remote has no '{develop}' branch — commit the installed files, push '{main}', then create it: git push origin {main}:{develop}",
+  "core.branches.confirmCreate": "The remote has no '{develop}' branch. Create it from the current HEAD and push?",
+  "core.branches.alreadyExists": "already exists",
+  "core.branches.localSkipped": "Skipped creating local branch '{develop}' ({reason})",
+  "core.branches.pushFailed": "⚠️  Failed to push branch '{develop}' — check the remote settings, then push manually (git push -u origin {develop})",
+  "core.branches.created": "Created and pushed branch '{develop}'.",
+  "core.assets.missingWorkflows": "Package structure error — payload/workflows folder not found.",
+  "core.assets.missingScripts": "Package structure error — payload/scripts folder not found.",
+  "core.branding.unknownPlaceholder": "Unknown placeholder left over: {{{name}}}",
+  "core.deploy.label.simple": "Single-server deploy — stops and restarts the container (simplest, short downtime)",
+  "core.deploy.label.nginx": "Zero-downtime deploy (Nginx) — toggles the nginx config proxy_pass port between Blue/Green",
+  "core.deploy.label.traefik": "Zero-downtime deploy (Traefik) — switches Blue/Green through Traefik routing",
+  "core.flutterOptions.storeSubmitWarning": "Choosing store_submit submits a store review automatically on every main push.",
+  "core.flutterHooks.status.envModeUnset": "unset (keeps dotenv)",
+  "core.flutterHooks.status.storeUnset": "unset (installs both)",
+  "core.flutterHooks.status.deployModeUnset": "unset (store_only)",
+  "core.flutterHooks.comment.envMode": "(how Flutter environment variables are injected)",
+  "core.flutterHooks.comment.store": "(store deploy targets)",
+  "core.flutterHooks.comment.androidDeployMode": "(Play Store deploy mode)",
+  "core.flutterHooks.comment.iosDeployMode": "(iOS deploy mode)",
+  "core.flutterHooks.err.invalidFlag": "Invalid value for {flag}: {value} ({allowed})",
+  "core.flutterHooks.noValue": "(none)",
+  "core.flutterHooks.log.storesNone": "none",
+  "core.flutterHooks.log.storesUndecided": "undecided (both)",
+  "core.flutterDoctor.row.android": "Flutter Android deploy files",
+  "core.flutterDoctor.row.ios": "Flutter iOS deploy files",
+  "core.flutterDoctor.purpose.storeFiles": "Files required for the fastlane store upload",
+  "core.flutterDoctor.value.missing": "Missing files: {files}",
+  "core.flutterDoctor.impact.missing": "Without these files the store deploy workflow fails at the fastlane step.",
+  "core.flutterDoctor.action.missing": "Run the wizard again to recreate only the missing files (existing files are not overwritten)",
+  "core.flutterDoctor.value.present": "{count} present",
+  "core.flutterDoctor.purpose.exportOptions": "iOS signing and export settings",
+  "core.flutterDoctor.value.unfilled": "Unfilled values: {left}",
+  "core.flutterDoctor.impact.unfilled": "If left unfilled, the IOS-TESTFLIGHT workflow stops at the ExportOptions.plist validation step.",
+  "core.flutterDoctor.action.unfilled": "Replace the placeholders in {path} with real values (Team ID, bundle ID, provisioning profile name)",
+  "core.flutterDoctor.value.noPlaceholder": "No placeholders",
+  "core.paths.intro.multi": "🔍 Multi-type project detected — {total} types in total",
+  "core.paths.intro.single": "🔍 {type} project detected — 1 type in total",
+  "core.paths.intro.rootDef": "💡 'Project root' = the folder that holds that type's version file (relative to the repo root)",
+  "core.paths.err.pathMissing": "The path given with --paths does not exist: '{type}={path}'",
+  "core.paths.say.explicit": "  {type} → {path} (set by --paths)",
+  "core.paths.warn.noMarker": "  ⚠️ {path} has no {type} project file ({marker}) — check that the path is correct.",
+  "core.paths.say.rootMarker": "  {type} → . ({marker} at the root)",
+  "core.paths.say.keepExisting": "  {type} → {path} (kept from existing project_paths)",
+  "core.paths.say.auto": "  {type} → {path} (auto-detected)",
+  "core.paths.err.none": "{type}: could not find a project path. Set it directly with --paths \"{type}=path\".",
+  "core.paths.err.ambiguous": "{type}: {count} path candidates make it ambiguous ({list}). Set it directly with --paths \"{type}=path\".",
+  "core.paths.found.one": "  {prog} 🔍 {type} — found {marker}",
+  "core.paths.found.location": "      Location: <repo-root>/{file}",
+  "core.paths.confirm.candidate": "  Set the {type} project root to '{cand}'? (based on {file} — choose No to enter it manually)",
+  "core.paths.found.many": "  {prog} 🔍 {type}: found {count} path candidates",
+  "core.paths.manualInput": "Enter manually",
+  "core.paths.select.root": "  Select the {type} project root",
+  "core.paths.found.none": "  ⚠️ {prog} {type}: no project found (maxdepth 3).",
+  "core.paths.prompt.base": "  Enter the {type} project root path (the folder containing {marker}, e.g. server, app — press Enter for the root",
+  "core.paths.prompt.current": ", current: {existing}",
+  "core.paths.warn.outsideRepo": "  ⚠️ '{input}' is outside the repo — enter a path relative to the repo root.",
+  "core.paths.warn.noFile": "  ⚠️ {input}/{marker} does not exist.",
+  "core.paths.confirm.useAnyway": "  Use this path anyway? (No = enter again)",
+  "core.paths.say.chosen": "  ✅ {type} → {chosen}",
+  "core.paths.summary.title": "📂 Version file path per type:",
+  "core.paths.summary.row": "   {type} → {file}",
+  "core.paths.dup.warn": "  ⚠️ Several types ({types}) point at the same file ({file}).",
+  "core.paths.dup.note": "     → sync writes the same version to all of them. This works fine, but check that it is the setup you intended.",
+};

package/src/i18n/catalog/en/core2.js

@@ -0,0 +1,15 @@
+// English messages: core area (part 2).
+export default {
+  "core.breakingCheck.confirm": "Have you reviewed the breaking changes above and want to continue?",
+  "core.breakingCheck.nonInteractive": "⚠️  There are CRITICAL breaking changes - continuing because this is a non-interactive run. Be sure to review the notes above.",
+  "core.logger.error.nameExhausted": "All log file names are in use: {base}",
+  "core.logger.warn.startFailed": "Could not start the run log: {message}",
+  "core.logger.warn.writeStopped": "Stopping run log writes: {message}",
+  "core.logger.summary.title": "=== Summary ===",
+  "core.removalExec.readmeSection": "README.md version section",
+  "core.verify.eitherSep": " or ",
+  "core.versionYml.error.templateRequired": "The version.yml.template source text is required (is payload/version.yml.template missing?)",
+  "core.versionYml.error.unknownPlaceholder": "Unknown placeholder in version.yml.template: {{{name}}}",
+  "core.versionYml.pathsComment": "Project folder per type (path relative to the repo root)",
+  "core.versionYml.deployComment": "Deploy settings remembered by the wizard (non-sensitive / editable by hand)",
+};