project-auto-wizard 0.15.0 → 0.16.0

package/src/core/options.js

@@ -0,0 +1,88 @@
+// Option registry - one declaration per boolean release option; CLI flags, value resolution, version.yml parse/render
+// and status/log lines are all derived from it (same idea as core/types.js for project types).
+// Adding an option means adding one entry here; see ADDING-AN-OPTION.md.
+//
+// default       : value on a new install when neither a flag nor a saved value exists
+// legacyDefault : value on an existing install (version.yml present) whose file lacks this key
+//   semver_auto    - false: an install from before the feature must not silently turn on and let one ambiguous commit bump major
+//   copilot_ai     - false: opt-in because it consumes AI Credits
+//   release_automerge - true for both: automerge is what every existing install already does, so a missing key means ON
+// conflictKey   : i18n key of the error thrown when --<flag> and --no-<flag> are both given (catalog lives in src/i18n)
+// logLabel      : label used by the install log line ("option <logLabel> on|off")
+// ask           : present only for options the interactive wizard asks about / lists in the edit menu
+//   { questionKey, initial, menuLabelKey, summaryKey, cardIcon, cardLabelKey } (all i18n keys except initial/cardIcon)
+// Keys only - this module never imports the i18n layer, so core stays free of UI dependencies.
+export const OPTIONS = Object.freeze([
+  {
+    key: "semver_auto", name: "semverAuto", ctxField: "includeSemverAuto",
+    flag: "semver-auto", default: true, legacyDefault: false,
+    conflictKey: "cli.args.semverConflict", logLabel: "semver",
+    ask: {
+      questionKey: "interactive.question.semverAuto", initial: true,
+      menuLabelKey: "ui.prompts.edit.semverAuto", summaryKey: "interactive.summary.semverAuto",
+      cardIcon: "🔢", cardLabelKey: "ui.status-cards.card.autoBump",
+    },
+  },
+  {
+    key: "copilot_ai", name: "copilotAi", ctxField: "includeCopilotAi",
+    flag: "copilot", default: false, legacyDefault: false,
+    conflictKey: "cli.args.copilotConflict", logLabel: "copilot",
+    ask: {
+      questionKey: "interactive.question.copilotAi", initial: false,
+      menuLabelKey: "ui.prompts.edit.copilotAi", summaryKey: "interactive.summary.copilotAi",
+      cardIcon: "🤖", cardLabelKey: "ui.status-cards.card.copilot",
+    },
+  },
+  {
+    // No `ask`: the wizard never asks about it - the flag or version.yml is the control (default ON).
+    key: "release_automerge", name: "releaseAutomerge", ctxField: "includeReleaseAutomerge",
+    flag: "release-automerge", default: true, legacyDefault: true,
+    conflictKey: "cli.args.releaseAutomergeConflict", logLabel: "release-automerge",
+  },
+]);
+
+export const optionByKey = (key) => OPTIONS.find((o) => o.key === key);
+
+// version.yml template variable name, e.g. semver_auto -> OPT_SEMVER_AUTO
+export const optionVar = (o) => `OPT_${o.key.toUpperCase()}`;
+
+// Context fields (includeX) -> explicit-value map (name -> boolean|null)
+export function explicitFromContext(ctx = {}) {
+  return Object.fromEntries(OPTIONS.map((o) => [o.name, ctx[o.ctxField] ?? null]));
+}
+
+// The option fields of a context/opts object only (what the interactive wizard receives as its starting values)
+export function optionContextFields(ctx = {}) {
+  return Object.fromEntries(OPTIONS.map((o) => [o.ctxField, ctx[o.ctxField]]));
+}
+
+// Context defaults: null = not decided yet
+export function defaultContextFields() {
+  return Object.fromEntries(OPTIONS.map((o) => [o.ctxField, null]));
+}
+
+// Only explicit and saved values are applied - null means undecided (interactive mode uses it to decide whether to ask).
+export function pickOptionValues(explicit = {}, existing = null) {
+  return Object.fromEntries(
+    OPTIONS.map((o) => [o.name, explicit[o.name] ?? existing?.options?.[o.name] ?? null]),
+  );
+}
+
+// Final values keyed by context field - undecided options get default (new install) or legacyDefault (existing install).
+export function resolveOptionValues(explicit = {}, existing = null) {
+  const picked = pickOptionValues(explicit, existing);
+  return Object.fromEntries(
+    OPTIONS.map((o) => {
+      const v = picked[o.name];
+      return [o.ctxField, v === null ? (existing ? o.legacyDefault : o.default) : v === true];
+    }),
+  );
+}
+
+// Values for rendering version.yml: a context field that is unset (null/undefined) falls back to the option's default.
+export function renderValues(ctx = {}) {
+  return Object.fromEntries(OPTIONS.map((o) => [o.ctxField, (ctx[o.ctxField] ?? o.default) === true]));
+}
+
+// Options the interactive wizard asks about (those declaring `ask`).
+export const askableOptions = () => OPTIONS.filter((o) => o.ask);

package/src/core/release-options.js

@@ -1,23 +1,6 @@
-// Value-decision rules for the release options (semver_auto, copilot_ai), shared by non-interactive (index.js) and interactive (interactive.js) modes.
-// Priority: explicit value (CLI flag, prompt answer), then the value saved in version.yml, then the default.
-// Keeping separate copies per path would install the same repo with different settings depending on how it was run.
-
-// Reflects only explicit and saved values. null means not decided yet (interactive mode uses it to decide whether to ask).
-export function pickReleaseOptions(explicit = {}, existing = null) {
-  return {
-    semverAuto: explicit.semverAuto ?? existing?.options?.semverAuto ?? null,
-    copilotAi: explicit.copilotAi ?? existing?.options?.copilotAi ?? null,
-  };
-}
-
-// Final values: fills undecided options with defaults.
-// semver_auto: true only for fresh installs. If an existing install whose version.yml lacked the key (installed
-//   before the feature existed) were switched on silently, one ambiguous commit could promote a major bump, so it stays false.
-// copilot_ai: an opt-in that consumes AI credits, so it is false for both new and existing installs unless stated.
-export function resolveReleaseOptions(explicit = {}, existing = null) {
-  const { semverAuto, copilotAi } = pickReleaseOptions(explicit, existing);
-  return {
-    includeSemverAuto: semverAuto === null ? !existing : semverAuto !== false,
-    includeCopilotAi: copilotAi === true,
-  };
-}
+// Value-decision rules for the release options (semver_auto, copilot_ai, ...), shared by non-interactive (index.js) and
+// interactive (interactive.js) modes. The rules themselves live in the option registry (core/options.js); this file keeps
+// the existing import path and names.
+// Priority: explicit value (CLI flag / prompt answer) -> saved value in version.yml -> default. Keeping one implementation
+// stops the same repo from being installed with different settings depending on how the wizard was run.
+export { pickOptionValues as pickReleaseOptions, resolveOptionValues as resolveReleaseOptions } from "./options.js";

package/src/core/types.js

@@ -11,6 +11,8 @@ import { flutterHooks } from "./flutter-hooks.js";
 //                      "package": detected by a package.json dependency key (packageDep)
 //                      "package-fallback": package.json exists but none of the above matched
 //                      absent: not auto-detected (basic is the result when nothing was detected).
+//   extraPackageDeps   Other dependency keys that also classify a project as this type (e.g. next -> react).
+//   displayName        Human-readable name shown next to the id in interactive choices (optional).
 //   detectOrder        Evaluation order within the same detectBy. The earlier rule wins (an expo app also has a react-native dependency).
 //   versionSources     File keys to read the version from at install (sources in detect.js); read first in this order for the primary type.
 //   buildNumberSource  File key to read the mobile build number from (detectBuildNumberFromFiles in detect.js).
@@ -51,16 +53,11 @@ export const TYPES = [
     hooks: flutterHooks,
   },
   {
-    id: "next",
-    markers: ["package.json"],
-    detectBy: "package", packageDep: "next", detectOrder: 3,
-    versionSources: ["packageJson"],
-    singleServerCd: "PROJECT-NEXT-CICD.yaml",
-  },
-  {
+    // Next.js projects are React projects: same package.json version handling and the same CI/CD workflows.
     id: "react",
+    displayName: "React / Next.js",
     markers: ["package.json"],
-    detectBy: "package", packageDep: "react", detectOrder: 4,
+    detectBy: "package", packageDep: "react", extraPackageDeps: ["next"], detectOrder: 3,
     versionSources: ["packageJson"],
     singleServerCd: "PROJECT-REACT-CICD.yaml",
   },
@@ -109,6 +106,16 @@ export const TYPES = [
 // Type used when nothing was detected
 export const FALLBACK_TYPE = "basic";
 
+// Names that were once separate types and are now accepted as an alias of another one.
+// Every input that can carry a type name (--type, --paths, version.yml) goes through canonicalTypeId(),
+// so the rest of the code only ever sees registry ids and version.yml is rewritten with the canonical name.
+export const TYPE_ALIASES = Object.freeze({ next: "react" });
+
+export const canonicalTypeId = (name) => TYPE_ALIASES[name] ?? name;
+
+// Canonical ids of a type list with duplicates removed (react,next -> react), keeping the first occurrence's position.
+export const canonicalTypeIds = (names) => [...new Set(names.map(canonicalTypeId))];
+
 const BY_ID = new Map(TYPES.map((t) => [t.id, t]));
 
 // Unknown types give undefined; callers decide their own defaults.

package/src/core/version-yml.js

@@ -1,6 +1,8 @@
 import { DEFAULT_DEPLOY_STYLE } from "./deploy-style.js";
+import { OPTIONS, optionVar, renderValues } from "./options.js";
 import { escapeYamlDoubleQuoted } from "./wizard-env.js";
-import { hooksFor, mergeHookResults, allHookValues } from "./types.js";
+import { hooksFor, mergeHookResults, allHookValues, canonicalTypeId, canonicalTypeIds } from "./types.js";
+import { normalizePath } from "./paths.js";
 import { DEFAULT_LANGUAGE, isSupportedLanguage, normalizeLanguage } from "../i18n/languages.js";
 // Aliased: `t` is used as a local variable name (type, trimmed line) throughout this file.
 import { t as tr } from "../i18n/index.js";
@@ -40,15 +42,17 @@ export function parseExtraTopLevel(content) {
 
 // Type-specific option key -> returned field (type hook savedOptionKeys). The value is returned as the raw string; validity is up to the type hook's resolveOptions.
 const TYPE_OPTION_KEYS = allHookValues("savedOptionKeys");
+const OPTION_BY_KEY = new Map(OPTIONS.map((o) => [o.key, o]));
+const OPTION_LINE = new RegExp(`^\\s+(${OPTIONS.map((o) => o.key).join("|")}):\\s*(.+)`);
 const TYPE_OPTION_LINE = new RegExp(`^\\s+(${Object.keys(TYPE_OPTION_KEYS).join("|")}):\\s*(.+)`);
 
 // State-machine parse of metadata.template.options.
-// Returns: { semverAuto: bool|null, copilotAi: bool|null, deployStyle: string|null,
+// Returns: { <one bool|null per registry option, e.g. semverAuto/copilotAi>, deployStyle: string|null,
 //         type-specific option fields (e.g. envMode/flutterStore/androidDeployMode/iosDeployMode): string|null } - null = not written.
 // Other keys such as the old synology/coderabbit ones hit no branch and are naturally ignored (no parse error).
 export function parseTemplateOptions(content) {
   const out = {
-    semverAuto: null, copilotAi: null, deployStyle: null,
+    ...Object.fromEntries(OPTIONS.map((o) => [o.name, null])), deployStyle: null,
     ...Object.fromEntries(Object.values(TYPE_OPTION_KEYS).map((field) => [field, null])),
   };
   // Value normalization: strip quotes + trim
@@ -65,18 +69,12 @@ export function parseTemplateOptions(content) {
       if (m) { const v = strip(m[1]); if (v) out.deployStyle = v; continue; }
       m = line.match(TYPE_OPTION_LINE);
       if (m) { const v = strip(m[2]); if (v) out[TYPE_OPTION_KEYS[m[1]]] = v; continue; }
-      m = line.match(/^\s+semver_auto:\s*(.+)/);
-      if (m) {
-        const v = strip(m[1]);
-        if (v === "true") out.semverAuto = true;
-        if (v === "false") out.semverAuto = false;
-        continue;
-      }
-      m = line.match(/^\s+copilot_ai:\s*(.+)/);
-      if (m) {
-        const v = strip(m[1]);
-        if (v === "true") out.copilotAi = true;
-        if (v === "false") out.copilotAi = false;
+      // Boolean options come from the registry; a value other than true/false is left null (= not written).
+      const optionLine = line.match(OPTION_LINE);
+      if (optionLine) {
+        const v = strip(optionLine[2]);
+        if (v === "true") out[OPTION_BY_KEY.get(optionLine[1]).name] = true;
+        if (v === "false") out[OPTION_BY_KEY.get(optionLine[1]).name] = false;
         continue;
       }
       // another key indented 0-4 spaces -> end of the options section
@@ -88,6 +86,21 @@ export function parseTemplateOptions(content) {
   return out;
 }
 
+// User-facing lines for entries parseExisting() folded away: what is kept, what drops out, and how to keep the other folder.
+// finalPaths (Map<type, folder>) is the folder set the run will actually write; without it the saved winner is assumed.
+// The message follows the real outcome, so an explicit --paths choice is never told the opposite.
+export function droppedPathLines(droppedPaths = [], finalPaths = null) {
+  return droppedPaths.flatMap((d) => {
+    const final = finalPaths?.get(d.type) ?? d.kept;
+    const same = (x) => normalizePath(x) === normalizePath(final);
+    const lost = same(d.kept) ? d.path : same(d.path) ? d.kept : `${d.kept}, ${d.path}`;
+    const lines = [tr("core.versionYml.pathMerged", { keptName: d.keptName, kept: d.kept, name: d.name, path: d.path, type: d.type, final, lost })];
+    // The re-run hint only makes sense when the saved winner is what stays.
+    if (same(d.kept)) lines.push(tr("core.versionYml.pathMergedHint", { type: d.type, path: d.path }));
+    return lines;
+  });
+}
+
 // Extract values from an existing version.yml (line-based, avoids false hits on comment lines).
 export function parseExisting(content) {
   const text = String(content || "");
@@ -107,21 +120,45 @@ export function parseExisting(content) {
   // project_types: ["a","b"]
   const typesRaw = line(/^project_types:\s*(\[[^\]]*\])/);
   let types = [];
-  if (typesRaw) types = [...typesRaw.matchAll(/"([^"]+)"/g)].map((m) => m[1]);
+  // Old names (next) are read as their current type so every later step, including the rewrite, only sees canonical ids.
+  if (typesRaw) types = canonicalTypeIds([...typesRaw.matchAll(/"([^"]+)"/g)].map((m) => m[1]));
   // language: "en" - only supported values count; a hand-edited unknown value is treated as unset
   const langRaw = normalizeLanguage((line(/^language:\s*(.+)/) || "").replace(/\s+#.*$/, "").replace(/["']/g, ""));
   const language = isSupportedLanguage(langRaw) ? langRaw : null;
   // project_paths block: `  type: "path"`
   const paths = new Map();
+  // Entries folded into another entry of the same canonical type with a different folder (react: client + next: web).
+  // A type holds one folder, so these are lost on rewrite; callers surface them instead of dropping them silently.
+  const droppedPaths = [];
+  const pathNames = new Map(); // canonical id -> the name the kept folder was written under
   let inPaths = false;
   for (const l of text.split("\n")) {
     if (/^project_paths:/.test(l)) { inPaths = true; continue; }
     if (inPaths) {
       const m = l.match(/^\s+([a-z-]+):\s*"([^"]*)"/);
-      if (m) paths.set(m[1], m[2]);
+      // The first entry wins when an old name and its current name are both present.
+      if (m) {
+        const id = canonicalTypeId(m[1]);
+        if (!paths.has(id)) { paths.set(id, m[2]); pathNames.set(id, m[1]); }
+        else if (normalizePath(paths.get(id)) !== normalizePath(m[2])) droppedPaths.push({ type: id, keptName: pathNames.get(id), kept: paths.get(id), name: m[1], path: m[2] });
+      }
       else if (/^\S/.test(l)) inPaths = false; // end of indentation -> end of block
     }
   }
+  // A name listed in project_types without a project_paths entry lives at the repo root, so when it shares a
+  // canonical type with a name that has a folder, the root is the folder that drops out.
+  if (typesRaw) {
+    const names = [...new Set([...typesRaw.matchAll(/"([^"]+)"/g)].map((m) => m[1]))];
+    const written = new Set(text.split("\n").map((l) => l.match(/^\s+([a-z-]+):\s*"/)?.[1]).filter(Boolean));
+    for (const id of new Set(names.map(canonicalTypeId))) {
+      const group = names.filter((n) => canonicalTypeId(n) === id);
+      if (group.length < 2 || !paths.has(id)) continue;
+      for (const n of group) {
+        if (written.has(n) || normalizePath(paths.get(id)) === ".") continue;
+        droppedPaths.push({ type: id, keptName: pathNames.get(id), kept: paths.get(id), name: n, path: "." });
+      }
+    }
+  }
   // version inside the template: block
   let templateVersion = "";
   let inTemplate = false;
@@ -138,7 +175,7 @@ export function parseExisting(content) {
   // metadata.template.branches - main/develop/mode (to skip re-asking in update mode)
   const branches = parseTemplateBranches(text);
   return {
-    version, versionCode, types, language, paths, templateVersion, options, branches,
+    version, versionCode, types, language, paths, droppedPaths, templateVersion, options, branches,
     deploy: parseDeployBlock(text), extraTopLevel: parseExtraTopLevel(text),
   };
 }
@@ -157,9 +194,15 @@ export function parseDeployBlock(content) {
     if (!inDeploy) continue;
     if (/^\S/.test(l)) { inDeploy = false; continue; } // next top-level key -> end of block
     const t = l.match(/^ {2}([a-z][a-z-]*):\s*(?:#.*)?$/);
-    if (t) { current = new Map(); out.set(t[1], current); continue; }
+    if (t) {
+      // An old type name shares the block of its current name; keys already present there win.
+      const id = canonicalTypeId(t[1]);
+      current = out.get(id) ?? new Map();
+      out.set(id, current);
+      continue;
+    }
     const kv = l.match(/^ {4}([A-Za-z_][A-Za-z0-9_]*):\s*"((?:[^"\\]|\\.)*)"/);
-    if (kv && current) current.set(kv[1], kv[2].replace(/\\(["\\])/g, "$1"));
+    if (kv && current && !current.has(kv[1])) current.set(kv[1], kv[2].replace(/\\(["\\])/g, "$1"));
   }
   return out;
 }
@@ -210,8 +253,9 @@ export function buildVersionYml({
   const b = branches || { main: branch || "main", develop: "develop", mode: "pr-flow" };
   const {
     templateVersion = "unknown",
-    includeSemverAuto = true, includeCopilotAi = false, deployStyle = "", optionsDate = today,
+    deployStyle = "", optionsDate = today,
   } = templateOptions || {};
+  const optionValues = renderValues(templateOptions || {});
 
   // project_paths block (full-line token {{PROJECT_PATHS}} - line removed when absent)
   let pathsBlock = "";
@@ -249,8 +293,7 @@ export function buildVersionYml({
     NOW: now, TODAY: today || optionsDate, DEFAULT_BRANCH: branch,
     TEMPLATE_VERSION: templateVersion,
     MAIN_BRANCH: b.main, DEVELOP_BRANCH: b.develop, BRANCH_MODE: b.mode,
-    OPT_SEMVER_AUTO: String(includeSemverAuto),
-    OPT_COPILOT_AI: String(includeCopilotAi),
+    ...Object.fromEntries(OPTIONS.map((o) => [optionVar(o), String(optionValues[o.ctxField])])),
     OPT_DEPLOY_STYLE: String(deployStyle || ""),
   };
 
@@ -289,15 +332,14 @@ export function sameIgnoringTimestamps(a, b) {
 export function renderVersionYml(context, templateText, { pathMarkers, deployValues = new Map(), extraTopLevel = [] }) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown", branches = null, language,
-    includeSemverAuto, includeCopilotAi, deployStyle } = context;
+    deployStyle } = context;
   return buildVersionYml({
     templateText, version, types, paths, pathMarkers, branch, branches, versionCode, now, today,
     deployValues, extraTopLevel, language,
     typeOptions: mergeHookResults(types, "optionsFromContext", context),
     templateOptions: {
       templateVersion,
-      includeSemverAuto: includeSemverAuto !== false,
-      includeCopilotAi: includeCopilotAi === true,
+      ...renderValues(context),
       // null = a type with no server deploy workflow, so the deploy style is meaningless (record omitted)
       deployStyle: deployStyle === null ? null : (deployStyle || DEFAULT_DEPLOY_STYLE),
       optionsDate: today,

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

@@ -5,7 +5,7 @@ export default {
   "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.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      --release-automerge / --no-release-automerge  Merge the release PR automatically (default: enabled; off = you merge it yourself)\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",
@@ -13,6 +13,7 @@ export default {
   "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.releaseAutomergeConflict": "--release-automerge and --no-release-automerge 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}'",
@@ -20,6 +21,7 @@ export default {
   "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.pathsDuplicateType": "--paths lists '{type}' twice with different folders (next is the old name of react); keep one entry",
   "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).",

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

@@ -8,10 +8,13 @@ export default {
   "cmd.status.none": "(none)",
   "cmd.status.branchMode": "Branch mode     : {mode} ({main} / {develop})",
   "cmd.status.unsetDefaultFalse": "unset (default false)",
+  "cmd.status.unsetDefaultTrue": "unset (default true)",
   "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.missingScripts": "Warning: {n} installed script(s) missing from {dir}/ (workflows call them and will fail at run time):",
+  "cmd.status.missingScriptsFix": "  Restore them with: npx project-auto-wizard --mode full --force",
   "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)",
@@ -24,6 +27,12 @@ export default {
   "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.scripts.name": "Installed scripts",
+  "cmd.doctor.scripts.label": "Installed scripts",
+  "cmd.doctor.scripts.purpose": "Scripts the installed workflows call",
+  "cmd.doctor.scripts.missing": "Missing from .github/scripts/: {files}",
+  "cmd.doctor.scripts.impact": "Workflow steps that call them stop with a clear error (messages.py is missing) instead of carrying on.",
+  "cmd.doctor.scripts.action": "Restore them with: npx project-auto-wizard --mode full --force",
   "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.",
@@ -70,6 +79,12 @@ export default {
   "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.automerge.name": "Release PR automerge",
+  "cmd.doctor.automerge.purpose": "Whether the release PR merges by itself",
+  "cmd.doctor.automerge.on": "It is on (release_automerge: true in version.yml, or the key is absent).",
+  "cmd.doctor.automerge.onHow": "To merge the release PR yourself, reinstall with --no-release-automerge or set release_automerge: false in version.yml.",
+  "cmd.doctor.automerge.off": "It is off (release_automerge: false in version.yml); the workflow prepares the release PR but does not merge it.",
+  "cmd.doctor.automerge.offHow": "Merge the release PR yourself with a merge commit (not squash or rebase) so the release still publishes; --release-automerge turns it back on.",
   "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: ",

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

@@ -1,6 +1,9 @@
 // English messages: core area (part 2).
 export default {
   "core.breakingCheck.confirm": "Have you reviewed the breaking changes above and want to continue?",
+  "core.versionYml.pathMergedTitle": "One folder per type",
+  "core.versionYml.pathMerged": "version.yml lists '{keptName}' (folder {kept}) and '{name}' (folder {path}) separately, but they are now the same type and only one folder per type is managed. Keeping {type}={final}; {lost} drops out of CI and version sync.",
+  "core.versionYml.pathMergedHint": "To manage {path} instead, rerun with --paths {type}={path}; to keep both, add a hand-written CI workflow for the dropped folder.",
   "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}",

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

@@ -20,6 +20,7 @@ export default {
   "ui.status-cards.card.on": "on",
   "ui.status-cards.card.off": "off",
   "ui.status-cards.card.autoBump": "Auto-bump",
+  "ui.status-cards.card.copilot": "Copilot",
   "ui.status-cards.card.paths": "Paths",
   "ui.status-cards.kind.update": "{title} — template {from} → {to}",
   "ui.status-cards.kind.updateTitle": "Update",

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

@@ -5,7 +5,7 @@ export default {
   "cli.lang.missing": "--lang 값이 필요합니다. 지원 언어: {supported}",
   "cli.lang.help": "메시지 언어: {supported} (기본: en)",
   "cli.bin.nodeVersion": "Node.js 20.12 이상이 필요합니다 (현재: {current})",
-  "cli.help.text": "project-auto-wizard — One command DevOps: GitHub-native 릴리스 자동화 설치 마법사\n\n사용법:\n  npx project-auto-wizard [옵션]\n\n옵션:\n  -m, --mode MODE          통합 모드 (full | uninstall | status | doctor)\n                           기본: interactive (대화형). full = 설치 및 업데이트\n                           uninstall = 완전 삭제(대화형 체크리스트, --force 시 --purge-*로 opt-in)\n                           status = 설치 상태·드리프트 확인(읽기 전용). doctor = 환경 진단(읽기 전용)\n  -t, --type CSV           프로젝트 타입 csv (예: spring,react,python)\n                           지원: {types}\n      --project-version V  통합 대상의 초기 버전 (예: 1.0.0). 미지정 시 자동 감지\n      --paths \"t=p,...\"    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client\n      --main-branch B      릴리스 브랜치 (기본: 감지된 default branch)\n      --develop-branch B   개발 브랜치 (기본: develop). 릴리스 브랜치와 같으면 trunk-based 모드\n      --deploy-style STYLE           서버 배포 방식: simple | nginx | traefik | none (기본: simple)\n      --flutter-env-mode MODE        Flutter 환경변수 방식: dart-define | dotenv (기본: 신규 설치 dart-define, 기존 설치는 저장값·dotenv 유지)\n      --flutter-store CSV            Flutter 스토어 배포 대상: android,ios | android | ios | none (기본: 둘 다 설치)\n      --android-deploy-mode MODE     Play Store 배포 모드: store_only | store_prepare | store_submit (기본: store_only)\n      --ios-deploy-mode MODE         iOS 배포 모드: store_only | store_prepare | store_submit (기본: store_only)\n      --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)\n      --copilot / --no-copilot  Copilot으로 AI 요약 생성 (기본: 사용 안 함, GitHub Copilot AI Credits 소비)\n      --lang LANG          {langHelp}\n      --force              full 실행에 필수, uninstall은 비대화형 삭제 (모든 확인 생략, 기본값 사용)\n      --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/uninstall 지원)\n      --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거\n      --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거\n      --purge-version       --mode uninstall --force 시 version.yml도 제거\n  -v, --version            project-auto-wizard 버전 출력\n  -h, --help               이 도움말 표시\n\n예시:\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.help.text": "project-auto-wizard — One command DevOps: GitHub-native 릴리스 자동화 설치 마법사\n\n사용법:\n  npx project-auto-wizard [옵션]\n\n옵션:\n  -m, --mode MODE          통합 모드 (full | uninstall | status | doctor)\n                           기본: interactive (대화형). full = 설치 및 업데이트\n                           uninstall = 완전 삭제(대화형 체크리스트, --force 시 --purge-*로 opt-in)\n                           status = 설치 상태·드리프트 확인(읽기 전용). doctor = 환경 진단(읽기 전용)\n  -t, --type CSV           프로젝트 타입 csv (예: spring,react,python)\n                           지원: {types}\n      --project-version V  통합 대상의 초기 버전 (예: 1.0.0). 미지정 시 자동 감지\n      --paths \"t=p,...\"    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client\n      --main-branch B      릴리스 브랜치 (기본: 감지된 default branch)\n      --develop-branch B   개발 브랜치 (기본: develop). 릴리스 브랜치와 같으면 trunk-based 모드\n      --deploy-style STYLE           서버 배포 방식: simple | nginx | traefik | none (기본: simple)\n      --flutter-env-mode MODE        Flutter 환경변수 방식: dart-define | dotenv (기본: 신규 설치 dart-define, 기존 설치는 저장값·dotenv 유지)\n      --flutter-store CSV            Flutter 스토어 배포 대상: android,ios | android | ios | none (기본: 둘 다 설치)\n      --android-deploy-mode MODE     Play Store 배포 모드: store_only | store_prepare | store_submit (기본: store_only)\n      --ios-deploy-mode MODE         iOS 배포 모드: store_only | store_prepare | store_submit (기본: store_only)\n      --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)\n      --copilot / --no-copilot  Copilot으로 AI 요약 생성 (기본: 사용 안 함, GitHub Copilot AI Credits 소비)\n      --release-automerge / --no-release-automerge  릴리스 PR 자동 머지 (기본: 사용함, 끄면 직접 머지)\n      --lang LANG          {langHelp}\n      --force              full 실행에 필수, uninstall은 비대화형 삭제 (모든 확인 생략, 기본값 사용)\n      --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/uninstall 지원)\n      --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거\n      --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거\n      --purge-version       --mode uninstall --force 시 version.yml도 제거\n  -v, --version            project-auto-wizard 버전 출력\n  -h, --help               이 도움말 표시\n\n예시:\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": "--project-version 값이 올바르지 않습니다: '{raw}' (x.y.z 형식, 예: 1.0.0)",
   "cli.args.typeUnsupported": "지원하지 않는 타입: '{type}'\n지원 타입: {valid}",
   "cli.args.typeEmpty": "--type 인자가 비어 있습니다",
@@ -13,6 +13,7 @@ export default {
   "cli.args.deployStyleInvalid": "--deploy-style 값이 올바르지 않습니다: {value} ({choices})",
   "cli.args.semverConflict": "--semver-auto와 --no-semver-auto는 동시에 지정할 수 없습니다",
   "cli.args.copilotConflict": "--copilot과 --no-copilot은 동시에 지정할 수 없습니다",
+  "cli.args.releaseAutomergeConflict": "--release-automerge와 --no-release-automerge는 동시에 지정할 수 없습니다",
   "cli.args.pathsEmpty": "--paths 인자가 비어 있습니다 (예: --paths flutter=app,react=client)",
   "cli.args.branchEmpty": "{flag}에 빈 값을 지정할 수 없습니다",
   "cli.args.branchInvalid": "{flag} 값이 브랜치 이름으로 올바르지 않습니다: '{value}'",
@@ -20,6 +21,7 @@ export default {
   "cli.args.unknownOption": "알 수 없는 옵션: {option}",
   "cli.args.modeUnsupported": "지원하지 않는 모드: '{mode}'\n지원 모드: interactive full uninstall status doctor",
   "cli.args.pathsTypeUnsupported": "--paths에 지원하지 않는 타입: '{type}'",
+  "cli.args.pathsDuplicateType": "--paths에 '{type}'이 서로 다른 폴더로 두 번 지정됨 (next는 react의 이전 이름입니다): 한 항목만 남기세요",
   "cli.args.pathsRelativeOnly": "--paths는 레포 안의 상대경로만 지정할 수 있습니다: '{pair}'",
   "cli.index.purgePrompt": "purge를 실행하려면 정확히 이 레포명을 입력하세요: {repoName}\n> ",
   "cli.index.dryRunNeedsMode": "--dry-run은 --mode <full|uninstall>와 함께 사용하세요 (대화형 모드에서는 지원하지 않습니다).",

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

@@ -8,10 +8,13 @@ export default {
   "cmd.status.none": "(없음)",
   "cmd.status.branchMode": "브랜치 모드      : {mode} ({main} / {develop})",
   "cmd.status.unsetDefaultFalse": "미설정(기본 false)",
+  "cmd.status.unsetDefaultTrue": "미설정(기본 true)",
   "cmd.status.options": "옵션            : {value}",
   "cmd.status.modified": "사용자가 수정한 워크플로우 파일 ({n}개):",
   "cmd.status.unmodified": "모든 워크플로우 파일이 설치 시점 기본값과 동일합니다 (수정 없음).",
   "cmd.status.stale": "현재 버전에 없는 이전 워크플로우 ({n}개 — 다음 업데이트에서 정리됨):",
+  "cmd.status.missingScripts": "경고: 설치된 스크립트 {n}개가 {dir}/ 에 없습니다 (워크플로우가 호출하므로 실행 시 실패합니다):",
+  "cmd.status.missingScriptsFix": "  복구: npx project-auto-wizard --mode full --force",
   "cmd.status.bucketsTitle": "지금 업데이트하면:",
   "cmd.status.bucketAuto": "  업스트림 변경 — 자동 적용 가능   {n}",
   "cmd.status.bucketLocalKept": "  내가 수정 · 업스트림 그대로      {n}   (유지)",
@@ -24,6 +27,12 @@ export default {
   "cmd.doctor.install.purpose": "이 폴더의 마법사 설치 여부",
   "cmd.doctor.install.value": "version.yml 있음",
   "cmd.doctor.install.note": "이 폴더엔 아직 설치되지 않았습니다 — 지금 설치하면 됩니다.",
+  "cmd.doctor.scripts.name": "설치된 스크립트",
+  "cmd.doctor.scripts.label": "설치된 스크립트",
+  "cmd.doctor.scripts.purpose": "설치된 워크플로우가 호출하는 스크립트",
+  "cmd.doctor.scripts.missing": ".github/scripts/ 에 없음: {files}",
+  "cmd.doctor.scripts.impact": "이 스크립트를 호출하는 스텝은 누락을 알리는 오류(messages.py is missing)로 명확히 실패합니다.",
+  "cmd.doctor.scripts.action": "복구: npx project-auto-wizard --mode full --force",
   "cmd.doctor.gh.purpose": "레포 설정 조회용",
   "cmd.doctor.gh.notFound": "gh CLI를 찾을 수 없습니다.",
   "cmd.doctor.gh.notFoundImpact": "레포 권한·secret 설정을 조회할 수 없어 아래 원격 점검을 모두 건너뜁니다.",
@@ -70,6 +79,12 @@ export default {
   "cmd.doctor.copilot.purpose": "AI 릴리스 노트 생성(선택)",
   "cmd.doctor.copilot.creditsOn": "GitHub Copilot AI Credits가 소비됩니다 — 조직은 'Allow use of Copilot CLI billed to the organization' 정책이 필요합니다.",
   "cmd.doctor.copilot.creditsOff": "켜면 GitHub Copilot AI Credits가 소비됩니다 — 조직은 'Allow use of Copilot CLI billed to the organization' 정책이 필요합니다.",
+  "cmd.doctor.automerge.name": "릴리스 PR 자동 머지",
+  "cmd.doctor.automerge.purpose": "릴리스 PR이 스스로 머지되는지",
+  "cmd.doctor.automerge.on": "켜져 있습니다 (version.yml의 release_automerge: true, 또는 키가 없음).",
+  "cmd.doctor.automerge.onHow": "릴리스 PR을 직접 머지하려면 --no-release-automerge로 다시 설치하거나 version.yml의 release_automerge를 false로 바꾸세요.",
+  "cmd.doctor.automerge.off": "꺼져 있습니다 (version.yml의 release_automerge: false) — 워크플로우가 릴리스 PR을 준비만 하고 머지하지 않습니다.",
+  "cmd.doctor.automerge.offHow": "릴리스가 정상 배포되도록 머지 커밋으로 직접 머지하세요(squash·rebase 금지). 다시 켜려면 --release-automerge를 쓰세요.",
   "cmd.doctor.copilot.fallback": "꺼져 있거나 사용할 수 없으면 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.",
   "cmd.doctor.heading": "환경 진단",
   "cmd.doctor.details": "자세히: ",

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

@@ -1,6 +1,9 @@
 // 한국어 메시지: core 영역 (2부).
 export default {
   "core.breakingCheck.confirm": "위 호환성 변경을 확인했고 계속 진행할까요?",
+  "core.versionYml.pathMergedTitle": "타입당 폴더 하나",
+  "core.versionYml.pathMerged": "version.yml 에 '{keptName}'(폴더 {kept})과 '{name}'(폴더 {path})이 따로 적혀 있지만 이제 같은 타입이라 타입당 폴더 하나만 관리합니다. {type}={final} 를 유지하고, {lost} 는 CI·버전 동기화에서 빠집니다.",
+  "core.versionYml.pathMergedHint": "{path} 를 대신 관리하려면 --paths {type}={path} 로 다시 실행하세요. 둘 다 유지하려면 빠진 폴더용 CI 워크플로우를 직접 추가하세요.",
   "core.breakingCheck.nonInteractive": "⚠️  CRITICAL 호환성 변경이 있습니다 — 비대화형 실행이라 계속 진행합니다. 위 내용을 꼭 확인하세요.",
   "core.logger.error.nameExhausted": "로그 파일 이름이 모두 사용 중입니다: {base}",
   "core.logger.warn.startFailed": "실행 로그를 시작하지 못했습니다: {message}",

package/src/i18n/catalog/ko/ui.js

@@ -20,6 +20,7 @@ export default {
   "ui.status-cards.card.on": "켜짐",
   "ui.status-cards.card.off": "꺼짐",
   "ui.status-cards.card.autoBump": "자동승격",
+  "ui.status-cards.card.copilot": "Copilot",
   "ui.status-cards.card.paths": "경로",
   "ui.status-cards.kind.update": "{title} — 템플릿 {from} → {to}",
   "ui.status-cards.kind.updateTitle": "업데이트",

package/src/index.js

@@ -14,8 +14,9 @@ import { hooksFor, mergeHookResults } from "./core/types.js";
 import { PATHS } from "./core/paths.js";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "./core/assets.js";
 import { detectTypes, detectDefaultBranch, detectRepoName, makeResolvers, detectMarkers } from "./core/detect-fs.js";
-import { parseExisting } from "./core/version-yml.js";
+import { parseExisting, droppedPathLines } from "./core/version-yml.js";
 import { resolveReleaseOptions } from "./core/release-options.js";
+import { explicitFromContext, optionContextFields } from "./core/options.js";
 import { runBreakingCheck } from "./core/breaking-check.js";
 import { resolveProjectPaths } from "./core/paths-resolve.js";
 import {
@@ -149,7 +150,7 @@ async function runInner(argv, {
     // The log file is created on the first write, so viewing only status/doctor from the menu leaves nothing behind.
     startLog("install");
     return await runInteractive(
-      { includeSemverAuto: opts.includeSemverAuto, includeCopilotAi: opts.includeCopilotAi, language },
+      { ...optionContextFields(opts), language },
       { cwd, payloadRoot: payload, clock },
     );
   }
@@ -316,6 +317,9 @@ async function runInner(argv, {
     throw e;
   }
 
+  // Warn against the final folders (an explicit --paths may keep the other one). The dry-run preview prints its own notice.
+  if (!opts.dryRun) for (const line of droppedPathLines(existing?.droppedPaths, paths)) console.error(`⚠️  ${line}`);
+
   // version: existing version.yml first (SSoT; prevents overwriting on re-run) -> CLI value -> file detection.
   // Non-interactive, so the fallback notice uses the CLI wording (--project-version) as is.
   // Detect after paths are confirmed so a monorepo subfolder's version and build number are read.
@@ -363,7 +367,7 @@ async function runInner(argv, {
     payload, existing, templateVersion: readTemplateVersion(), types, deployStyle: chosenDeployStyle,
     typeOptions,
     // Options: CLI flag first -> saved version.yml option -> default (same rule as interactive)
-    releaseOptions: resolveReleaseOptions({ semverAuto: opts.includeSemverAuto, copilotAi: opts.includeCopilotAi }, existing),
+    releaseOptions: resolveReleaseOptions(explicitFromContext(opts), existing),
     mode: opts.mode, force: opts.force, version, versionCode, branch,
     branches,
     paths,

package/src/ui/env-plan.js

@@ -59,7 +59,7 @@ export function collectAsks(payloadRoot, types = [], opts = {}) {
     const [typeDir, serverDeployDir] = typeWorkflowDirs(payloadRoot, type);
     if (!exists(typeDir)) continue;
     // Same folder layout as the copy engine: type root + server-deploy (only when deploy is not "none").
-    // Types such as go/python and react/next keep server deploy workflows directly in the type root; they go
+    // Types such as go, python and react keep server deploy workflows directly in the type root; they go
     // through the same deploy-style filter - with "no deploy", CD/PR-preview ask keys (DEPLOY_PORT, SSH_AUTH_METHOD, ...) are not asked.
     // Flutter also filters out deselected store workflows (PLAYSTORE, TESTFLIGHT) so the question scope equals the install scope.
     units.push([type, typeDir, buildTypeRootFilter(type, deployStyle, flutterStore, available)]);