project-auto-wizard 0.15.1 → 0.16.1

package/README.md

@@ -21,7 +21,7 @@ Everything it installs is plain GitHub Actions in your own repository. No API ke
 </div>
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest Version : v0.15.1 (2026-10-01)
+## Latest Version : v0.16.1 (2026-10-01)
 
 [Full release history](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "description": "One command DevOps: npx wizard that installs GitHub-native Release Automation (optional GitHub Copilot AI summaries) into any project",
   "license": "MIT",
   "type": "module",

package/payload/scripts/messages.py

@@ -1313,6 +1313,11 @@ EN = {
     "wf_changelog.pr_already_merged": "PR #{pr_number} is already merged",
     "wf_changelog.automerge_enabled": "automerge enabled: {subject}",
     "wf_changelog.automerge_unavailable": "automerge unavailable — merged directly: {subject}",
+    "wf_changelog.automerge_off": "release_automerge is off — PR renamed to \"{subject}\"; merge it yourself",
+    "wf_changelog.automerge_off_list_failed": "Could not read the comments of PR #{pr_number}; skipped the merge guidance comment to avoid a duplicate",
+    "wf_changelog.automerge_off_rename_hint": "The PR title could not be updated automatically. Before merging, set the merge commit message (or the PR title) to `{subject}` so the release is published.",
+    "wf_changelog.automerge_rename_failed": "Could not update PR #{pr_number} (title or guidance comment); the release still needs \"chore(release):\" in the merge commit message",
+    "wf_changelog.automerge_off_comment": "**Automatic merge is off** (`release_automerge: false` in `version.yml`). Wait until this workflow run has finished (it confirms the version and renames the PR), then merge this PR yourself when you are ready to release, using **Create a merge commit**. Do not use *Squash and merge* or *Rebase and merge*: the release gate reads `chore(release):` from the resulting commit message, and squashing or rebasing also rewrites the history that the next release notes are built from.",
     "wf_changelog.merge_retry": "merge attempt {attempt}/{max_attempts} failed — retrying in {wait}s",
     "wf_changelog.merge_gave_up": "PR merge failed after {max_attempts} attempts (allow_merge_commit={allow_merge_commit}) — check branch protection rules, required checks, and token permissions",
     # --- wf_readme ---
@@ -2583,6 +2588,11 @@ KO = {
     "wf_changelog.pr_already_merged": "PR #{pr_number}은(는) 이미 병합되었습니다",
     "wf_changelog.automerge_enabled": "automerge 활성화: {subject}",
     "wf_changelog.automerge_unavailable": "automerge를 쓸 수 없어 직접 병합했습니다: {subject}",
+    "wf_changelog.automerge_off": "release_automerge가 꺼져 있어 PR 제목을 \"{subject}\"로 바꿨습니다. 직접 머지하세요",
+    "wf_changelog.automerge_off_list_failed": "PR #{pr_number}의 댓글을 읽지 못해 중복을 피하려고 머지 안내 댓글을 건너뛰었습니다",
+    "wf_changelog.automerge_off_rename_hint": "PR 제목을 자동으로 바꾸지 못했습니다. 릴리스가 발행되도록 머지하기 전에 머지 커밋 메시지(또는 PR 제목)를 `{subject}`로 지정하세요.",
+    "wf_changelog.automerge_rename_failed": "PR #{pr_number}의 제목 또는 안내 댓글을 갱신하지 못했습니다. 릴리스가 되려면 머지 커밋 메시지에 \"chore(release):\"가 있어야 합니다",
+    "wf_changelog.automerge_off_comment": "**자동 머지가 꺼져 있습니다** (`version.yml`의 `release_automerge: false`). 이 워크플로우 실행이 끝난 뒤(버전 확정과 PR 제목 변경이 끝난 뒤) 릴리스할 준비가 되면 **Create a merge commit**으로 직접 머지하세요. *Squash and merge*와 *Rebase and merge*는 쓰지 마세요. 릴리스 게이트가 결과 커밋 메시지의 `chore(release):`를 읽고, squash나 rebase는 다음 릴리스 노트가 기대는 커밋 이력까지 바꿉니다.",
     "wf_changelog.merge_retry": "병합 시도 {attempt}/{max_attempts} 실패 — {wait}초 후 다시 시도합니다",
     "wf_changelog.merge_gave_up": "PR 병합이 {max_attempts}회 시도 후에도 실패했습니다 (allow_merge_commit={allow_merge_commit}) — 브랜치 보호 규칙, 필수 체크, 토큰 권한을 확인하세요",
     # --- wf_readme ---

package/payload/version.yml.template

@@ -9,6 +9,9 @@
 # - copilot_ai: opt-in (default false) — true lets the release/PR summary
 #   workflows call GitHub Copilot CLI, which consumes GitHub Copilot AI Credits.
 #   Falls back to rule-based summaries whenever Copilot is off or unavailable.
+# - release_automerge: default true — false stops the release PR (develop -> main)
+#   from being merged automatically. Merge it yourself with a merge commit
+#   (not squash or rebase); the workflow renames the PR so the release still publishes.
 # ===
 # Supported project types: spring, flutter, react, react-native,
 #                          react-native-expo, node, python, basic, go
@@ -53,6 +56,7 @@ metadata:
     options:
       semver_auto: {{OPT_SEMVER_AUTO}}
       copilot_ai: {{OPT_COPILOT_AI}}
+      release_automerge: {{OPT_RELEASE_AUTOMERGE}}
       deploy_style: "{{OPT_DEPLOY_STYLE}}" # simple | nginx | traefik | none (server deploy workflows)
 {{TYPE_OPTIONS}}
 {{DEPLOY}}

package/payload/workflows/common/PROJECT-COMMON-AUTO-CHANGELOG-CONTROL.yaml

@@ -29,6 +29,10 @@
 #    direct merge), retrying with backoff while GitHub catches up with the
 #    freshly pushed head; an already-merged PR counts as success
 #
+# With version.yml release_automerge: false, step 5 and the wait job are
+# skipped: the PR is renamed to the release-confirm subject and one guidance
+# comment asks the maintainer to merge it with a merge commit (not squash or rebase).
+#
 # The merge-commit subject carries the release-confirm pattern
 # "chore(release):" — keep in sync with PROJECT-COMMON-VERSION-CONTROL
 # and PROJECT-COMMON-RELEASE-PUBLISH.
@@ -127,6 +131,9 @@ jobs:
     needs: precheck
     if: needs.precheck.outputs.open == 'true'
     runs-on: ubuntu-latest
+    outputs:
+      # Read by wait-for-merge-and-trigger-release: with automerge off there is no merge for it to wait for
+      automerge: ${{ steps.automerge_option.outputs.release_automerge }}
     steps:
       - name: Checkout PR head
         uses: actions/checkout@v7
@@ -160,6 +167,15 @@ jobs:
           echo "copilot_ai=$COPILOT_AI" >> $GITHUB_OUTPUT
           echo "$(m wf_common.copilot_ai_option copilot_ai="$COPILOT_AI")"
 
+      - name: Read release_automerge option from version.yml
+        id: automerge_option
+        run: |
+          # Same metadata: -> template: -> options: scope as copilot_ai. A missing key means ON:
+          # installs from before the option existed already automerge, and that must not change.
+          AUTOMERGE=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?^\s+release_automerge:\s*\"?(true|false)", t, re.S|re.M); print(m.group(1) if m else "true")' 2>/dev/null || echo "true")
+          echo "release_automerge=$AUTOMERGE" >> $GITHUB_OUTPUT
+          echo "release_automerge option: $AUTOMERGE"
+
       - name: Install Copilot CLI
         if: steps.copilot_options.outputs.copilot_ai == 'true'
         continue-on-error: true
@@ -431,7 +447,49 @@ jobs:
             fi
           fi
 
+      - name: Prepare manual release merge (release_automerge=false)
+        if: steps.automerge_option.outputs.release_automerge == 'false'
+        env:
+          GH_TOKEN: ${{ secrets.WORKFLOW_PAT || github.token }}
+        run: |
+          [ -f "$GITHUB_WORKSPACE/.github/scripts/messages.py" ] || { echo "::error::messages.py is missing; rerun \`npx project-auto-wizard --mode full --force\`"; exit 1; }
+          m() { python3 "$GITHUB_WORKSPACE/.github/scripts/messages.py" get "$@"; }
+          PR_NUMBER=${{ github.event.pull_request.number }}
+          VERSION="${{ steps.bump.outputs.new_version }}"
+
+          # The PR title carries the release-confirm pattern, so a human merge commit (its message includes the PR title)
+          # still passes the RELEASE-PUBLISH gate. A failed rename only warns: the run must not fail here.
+          SUBJECT="chore(release): v${VERSION} (PR #${PR_NUMBER})"
+          # The REST endpoint is used instead of `gh pr edit`, which goes through GraphQL and can fail on token scopes.
+          RENAMED=true
+          if gh api -X PATCH "repos/${GITHUB_REPOSITORY}/pulls/${PR_NUMBER}" -f title="$SUBJECT" > /dev/null; then
+            echo "$(m wf_changelog.automerge_off subject="$SUBJECT")"
+          else
+            RENAMED=false
+            echo "::warning::$(m wf_changelog.automerge_rename_failed pr_number="$PR_NUMBER")"
+          fi
+
+          # One guidance comment per PR: re-runs (synchronize) find it by its marker and leave it alone.
+          # If the comment list cannot be read we cannot tell whether it exists, so skip rather than post a duplicate.
+          MARKER='<!-- release-automerge-off -->'
+          if ! COMMENT_IDS=$(gh api --paginate "repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/comments" \
+            --jq ".[] | select(.body | contains(\"$MARKER\")) | .id"); then
+            echo "::warning::$(m wf_changelog.automerge_off_list_failed pr_number="$PR_NUMBER")"
+          elif [ -z "$COMMENT_IDS" ]; then
+            BODY="$MARKER
+          $(m wf_changelog.automerge_off_comment)"
+            # A failed rename means the merge message will not carry the release marker unless the maintainer sets it.
+            if [ "$RENAMED" = false ]; then
+              BODY="$BODY
+
+          $(m wf_changelog.automerge_off_rename_hint subject="$SUBJECT")"
+            fi
+            gh pr comment "$PR_NUMBER" --body "$BODY" \
+              || echo "::warning::$(m wf_changelog.automerge_rename_failed pr_number="$PR_NUMBER")"
+          fi
+
       - name: Enable automerge
+        if: steps.automerge_option.outputs.release_automerge != 'false'
         env:
           # With a PAT the merge push triggers downstream workflows
           # (RELEASE-PUBLISH etc.); GITHUB_TOKEN merges do not.
@@ -503,6 +561,8 @@ jobs:
   wait-for-merge-and-trigger-release:
     name: Wait for merge and trigger RELEASE-PUBLISH (works without WORKFLOW_PAT)
     needs: changelog-and-merge
+    # Nothing merges by itself when release_automerge is false, so there is nothing to wait for.
+    if: needs.changelog-and-merge.outputs.automerge != 'false'
     runs-on: ubuntu-latest
     timeout-minutes: 35
     permissions:

package/src/cli/args.js

@@ -4,6 +4,7 @@ import { DEPLOY_STYLES, isDeployStyle, NO_DEPLOY_STYLE } from "../core/deploy-st
 import { isValidBranchName } from "../core/branches.js";
 import { TYPES, canonicalTypeId } from "../core/types.js";
 import { CliError } from "../core/errors.js";
+import { OPTIONS, defaultContextFields } from "../core/options.js";
 import { normalizePath, isRepoRelativePath } from "../core/paths.js";
 import { t, DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES, isSupportedLanguage, normalizeLanguage } from "../i18n/index.js";
 
@@ -11,6 +12,11 @@ import { t, DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES, isSupportedLanguage, normaliz
 export { CliError, normalizePath, isRepoRelativePath };
 
 // Type-specific CLI flags (type hook cliFlags): flag name -> { field, initial, parse }. Hooks are collected in type-table order.
+// --<flag> / --no-<flag> for every registry option - a new option needs no change here.
+const OPTION_CLI_FLAGS = new Map(OPTIONS.flatMap((option) => [
+  [`--${option.flag}`, { option, value: true }],
+  [`--no-${option.flag}`, { option, value: false }],
+]));
 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]));
 
@@ -22,7 +28,7 @@ const VALUE_FLAGS = new Set([
 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",
+  ...OPTIONS.flatMap((o) => [`--${o.flag}`, `--no-${o.flag}`]),
 ]);
 
 // `--name=value` -> `--name`, `value`, so the parser below only sees the space-separated form.
@@ -54,8 +60,7 @@ export function parseArgs(argv) {
     version: "",             // initial version of the target project (--project-version)
     types: [],
     primaryType: "",
-    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)
+    ...defaultContextFields(), // --<flag> / --no-<flag> per registry option (null = unset, resolved downstream)
     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
@@ -86,6 +91,13 @@ export function parseArgs(argv) {
     const a = args.shift();
     const typeFlag = TYPE_CLI_FLAG_BY_NAME.get(a);
     if (typeFlag) { result[typeFlag.field] = typeFlag.parse(args.shift()); continue; }
+    const optionFlag = OPTION_CLI_FLAGS.get(a);
+    if (optionFlag) {
+      const { option, value } = optionFlag;
+      // --<flag> and --no-<flag> together are contradictory, so reject instead of letting the last one win
+      if (seenFlags.has(`--${value ? "no-" : ""}${option.flag}`)) throw new CliError(t(option.conflictKey));
+      seenFlags.add(a); result[option.ctxField] = value; continue;
+    }
     switch (a) {
       case "-m": case "--mode":
         result.mode = args.shift() ?? ""; break;
@@ -156,18 +168,6 @@ export function parseArgs(argv) {
         }
         result.deployStyle = v; break;
       }
-      case "--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(t("cli.args.semverConflict"));
-        seenFlags.add("--no-semver-auto"); result.includeSemverAuto = false; break;
-      case "--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(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();

package/src/commands/doctor.js

@@ -172,7 +172,9 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   }
 
   // Show the actual setting: telling a user who turned it on that it is off would misrepresent the current state.
-  const copilotAi = installed ? parseExisting(readFileSync(join(cwd, "version.yml"), "utf8")).options.copilotAi : null;
+  // version.yml is read once; both option notes below use it.
+  const savedOptions = installed ? parseExisting(readFileSync(join(cwd, "version.yml"), "utf8")).options : null;
+  const copilotAi = savedOptions ? savedOptions.copilotAi : null;
   const copilotState = copilotAi === true
     ? t("cmd.doctor.copilot.on")
     : copilotAi === false
@@ -187,6 +189,17 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
     ],
   });
 
+  // release_automerge is on unless version.yml says false (a missing key also means on), so only an explicit false is reported as off.
+  // Without an install there is no saved setting to report, so the item is left out.
+  if (savedOptions) {
+    add({
+      name: t("cmd.doctor.automerge.name"), label: t("cmd.doctor.automerge.name"), purpose: t("cmd.doctor.automerge.purpose"), status: "INFO",
+      note: savedOptions.releaseAutomerge === false
+        ? [t("cmd.doctor.automerge.off"), t("cmd.doctor.automerge.offHow")]
+        : [t("cmd.doctor.automerge.on"), t("cmd.doctor.automerge.onHow")],
+    });
+  }
+
   return results;
 }
 

package/src/commands/full.js

@@ -18,6 +18,7 @@ import { readBaseline, writeBaseline, appFileHash } from "../core/baseline.js";
 import { scanUnsubstituted, classifySecrets, narrowSecretsBySshAuth } from "../core/verify.js";
 import { cleanupOtherDeployWorkflows, payloadWorkflowNames, DEFAULT_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { hooksFor } from "../core/types.js";
+import { OPTIONS } from "../core/options.js";
 import { findStaleWorkflows, cleanupStaleWorkflows } from "../core/removal-plan.js";
 import { log, maskValue } from "../core/logger.js";
 import { t } from "../i18n/index.js";
@@ -207,8 +208,9 @@ export function cleanupWorkflows(context, payloadRoot, targetRoot, baseline, { j
 // Values picked interactively converge here too, so "why was it installed like this?" can later be traced from the log alone.
 function logChoices(context, types) {
   if (context.deployStyle) log.info("option", "deploy", context.deployStyle);
-  if (context.includeSemverAuto != null) log.info("option", "semver", context.includeSemverAuto ? "on" : "off");
-  if (context.includeCopilotAi != null) log.info("option", "copilot", context.includeCopilotAi ? "on" : "off");
+  for (const o of OPTIONS) {
+    if (context[o.ctxField] != null) log.info("option", o.logLabel, context[o.ctxField] ? "on" : "off");
+  }
   for (const { hook } of hooksFor(types, "logChoices")) {
     for (const [name, value] of hook(context)) log.info("option", name, value);
   }

package/src/commands/interactive.js

@@ -8,6 +8,7 @@ import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "../core/
 import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectMarkers } from "../core/detect-fs.js";
 import { parseExisting, droppedPathLines } from "../core/version-yml.js";
 import { pickReleaseOptions, resolveReleaseOptions } from "../core/release-options.js";
+import { OPTIONS, askableOptions, explicitFromContext } from "../core/options.js";
 import { runBreakingCheck } from "../core/breaking-check.js";
 import { resolveProjectPaths } from "../core/paths-resolve.js";
 import {
@@ -32,9 +33,6 @@ import { t, getLanguage } from "../i18n/index.js";
 
 const CANCEL = prompts.CANCEL;
 
-// Resolved lazily so the text follows the language chosen at run time.
-const semverAutoQuestion = () => t("interactive.question.semverAuto");
-const copilotAiQuestion = () => t("interactive.question.copilotAi");
 const isCancel = (v) => v === CANCEL || typeof v === "symbol";
 
 // io defaults to the real prompts. Tests inject a stub io.
@@ -100,8 +98,8 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const repoName = detectRepoName(cwd);
   // Initial values of optional workflows: CLI flags (--copilot etc.) -> options saved in version.yml
   // Values set by a flag skip the question - same priority as non-interactive mode.
-  let { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi } = pickReleaseOptions(
-    { semverAuto: baseCtx?.includeSemverAuto, copilotAi: baseCtx?.includeCopilotAi }, existing);
+  // optionState: option name -> boolean|null (null = undecided; settled by resolveReleaseOptions below). Driven by the option registry.
+  const optionState = pickReleaseOptions(explicitFromContext(baseCtx ?? {}), existing);
   // Server deploy style - not asked again when a saved value (version.yml) exists (same convention as semver_auto).
   let deployStyle = savedDeployStyle(existing);
   const showOptional = mode === "full";
@@ -157,23 +155,22 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     // Flutter options - env mode -> store deploy targets -> per-platform deploy mode.
     await askFlutterOptions();
 
-    // Auto semver bump question (default ON). Skipped when a saved value exists.
-    // In workflows mode version.yml is not written and the answer is meaningless, so it is asked only in full.
-    if (mode === "full" && includeSemverAuto === null) {
-      const y2 = await io.askYesNo(semverAutoQuestion(), true);
-      includeSemverAuto = y2 === true;
-    }
-
-    // Copilot AI summary - consumes AI Credits, so opt-in (default No). Skipped when a saved value exists.
-    if (mode === "full" && includeCopilotAi === null) {
-      const y3 = await io.askYesNo(copilotAiQuestion(), false);
-      includeCopilotAi = y3 === true;
+    // Optional-workflow questions (auto semver bump default ON, Copilot AI summary default No - it consumes AI Credits).
+    // Each is skipped when a flag or a saved value exists. In workflows mode version.yml is not written and the answer
+    // is meaningless, so they are asked only in full. Options without `ask` in the registry are never asked.
+    for (const o of askableOptions()) {
+      if (mode === "full" && optionState[o.name] === null) {
+        const answer = await io.askYesNo(t(o.ask.questionKey), o.ask.initial);
+        optionState[o.name] = answer === true;
+      }
     }
   }
   // When a question was actually asked (the full-mode questions above) its answer is respected, and only options that were not asked
   // are filled with defaults - same function as the CLI path (index.js), hence the same rule.
-  ({ includeSemverAuto, includeCopilotAi } = resolveReleaseOptions(
-    { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi }, existing));
+  // Fill undecided options with defaults; keep the whole result (also the options that are never asked) so a saved
+  // value such as release_automerge: false survives an interactive reinstall.
+  const settledOptions = resolveReleaseOptions(optionState, existing);
+  for (const o of OPTIONS) optionState[o.name] = settledOptions[o.ctxField];
   const showOptionToggles = mode === "full";
 
   // Confirm/edit loop - ESC means 'stay' (only an explicit 'No' exits)
@@ -184,12 +181,12 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     if (io.analysisCard) {
       io.analysisCard({
         mode, modeLabel: modeLabel(mode), types, version, branch, showOptional, paths, flutter, envModeDefault: flutterAsk.envModeDefault,
-        options: showOptionToggles ? { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi } : null,
+        options: showOptionToggles ? { ...optionState } : null,
       });
     } else {
       io.note?.(summarize({
         mode, types, version, branch, showOptional, flutter, envModeDefault: flutterAsk.envModeDefault,
-        options: showOptionToggles ? { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi } : null,
+        options: showOptionToggles ? { ...optionState } : null,
       }), t("interactive.summary.title"));
     }
     const choice = await io.confirmProjectMenu();
@@ -218,13 +215,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
         }
       } else if (what === "branch") {
         branch = await askBranchName(io, t("interactive.edit.branchPrompt"), branch, isCancel);
-      } else if (what === "semverAuto") {
+      } else if (askableOptions().some((o) => o.name === what)) {
         // A saved value skips the first question, so this is the only place to change a value once decided.
-        const y = await io.askYesNo(semverAutoQuestion(), includeSemverAuto);
-        if (typeof y === "boolean") includeSemverAuto = y;
-      } else if (what === "copilotAi") {
-        const y = await io.askYesNo(copilotAiQuestion(), includeCopilotAi);
-        if (typeof y === "boolean") includeCopilotAi = y;
+        const o = askableOptions().find((x) => x.name === what);
+        const y = await io.askYesNo(t(o.ask.questionKey), optionState[o.name]);
+        if (typeof y === "boolean") optionState[o.name] = y;
       } else if (FLUTTER_EDIT_ITEMS.has(what)) {
         flutter = await editFlutterOption(io, what, flutter, flutterAsk.envModeDefault);
       }
@@ -323,7 +318,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     // Even if the saved value is zero-downtime, a single-server deploy is installed when the chosen types lack that style - record the style actually installed.
     deployStyle: resolveDeployStyle({ payload, types, explicit: deployStyle, existing }),
     typeOptions: flutterOptions,
-    releaseOptions: { includeSemverAuto, includeCopilotAi },
+    releaseOptions: Object.fromEntries(OPTIONS.map((o) => [o.ctxField, optionState[o.name]])),
     mode, force: true, version, versionCode, branch, branches, paths,
     repoName, resolvers, envValues, envUseDefaults, now, today,
     language: baseCtx.language ?? existing?.language ?? getLanguage(),
@@ -449,8 +444,9 @@ function summarize({ mode, types, version, branch, showOptional, flutter, envMod
     }
   }
   if (options) {
-    lines.push(t("interactive.summary.semverAuto", { value: options.semverAuto ? t("interactive.summary.on") : t("interactive.summary.off") }));
-    lines.push(t("interactive.summary.copilotAi", { value: options.copilotAi ? t("interactive.summary.on") : t("interactive.summary.off") }));
+    for (const o of askableOptions()) {
+      lines.push(t(o.ask.summaryKey, { value: options[o.name] ? t("interactive.summary.on") : t("interactive.summary.off") }));
+    }
   }
   return lines.join("\n");
 }

package/src/commands/status.js

@@ -2,6 +2,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseExisting, droppedPathLines } from "../core/version-yml.js";
+import { OPTIONS } from "../core/options.js";
 import { planWorkflows } from "../core/copy/workflows.js";
 import { makeResolvers, detectRepoName, detectDefaultBranch } from "../core/detect-fs.js";
 import { PATHS } from "../core/paths.js";
@@ -76,12 +77,12 @@ export function printStatus(status) {
   if (status.branches) {
     lines.push(t("cmd.status.branchMode", { mode: status.branches.mode, main: status.branches.main, develop: status.branches.develop }));
   }
-  const boolLabel = (v) => (v === null ? t("cmd.status.unsetDefaultFalse") : v);
-  const semverAutoLabel = status.options.semverAuto === null ? t("cmd.status.unsetDefaultFalse") : status.options.semverAuto;
-  const copilotAiLabel = boolLabel(status.options.copilotAi ?? null);
+  // An unset option is shown with the value it resolves to on this (existing) install, i.e. its legacyDefault.
+  const unsetLabel = (o) => t(o.legacyDefault ? "cmd.status.unsetDefaultTrue" : "cmd.status.unsetDefaultFalse");
+  const optionLabels = OPTIONS.map((o) => `${o.key}=${status.options[o.name] ?? unsetLabel(o)}`).join(" ");
   const typeLabels = hooksFor(status.types, "statusLabels").map(({ hook }) => hook(status.options)).join("");
   const deployLabel = status.options.deployStyle ? ` deploy_style=${status.options.deployStyle}` : "";
-  lines.push(t("cmd.status.options", { value: `semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${deployLabel}${typeLabels}` }));
+  lines.push(t("cmd.status.options", { value: `${optionLabels}${deployLabel}${typeLabels}` }));
   if (status.modifiedFiles.length) {
     lines.push("", t("cmd.status.modified", { n: status.modifiedFiles.length }));
     for (const f of status.modifiedFiles) lines.push(`  - ${f}`);

package/src/context.js

@@ -1,5 +1,6 @@
 // Wizard-wide state made explicit as a single object
 import { TYPE_IDS, allHookValues } from "./core/types.js";
+import { defaultContextFields } from "./core/options.js";
 
 // --type whitelist: the display order of the type registry (core/types.js).
 export const VALID_TYPES = TYPE_IDS;
@@ -24,8 +25,9 @@ export function createContext(overrides = {}) {
     branch: "",
     branches: null,          // { main, develop, mode: "pr-flow"|"trunk-based" } - result of resolveBranchConfig
     paths: new Map(),        // type -> path
-    includeSemverAuto: null, // null = unset (resolved to true downstream), true/false = explicit
-    includeCopilotAi: null,  // null = unset (resolved to false downstream), true/false = explicit; Copilot AI summary opt-in
+    // Release option fields (includeSemverAuto, includeCopilotAi, ...): null = unset (resolved downstream), true/false = explicit.
+    // Fields and defaults come from the option registry (core/options.js).
+    ...defaultContextFields(),
     // Type-specific option fields; all ignored in projects without that type. Fields and defaults come from the type hook (contextDefaults).
     ...allHookValues("contextDefaults"),
     language: "en",          // message language (--lang / env / version.yml), default en

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/version-yml.js

@@ -1,4 +1,5 @@
 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, canonicalTypeId, canonicalTypeIds } from "./types.js";
 import { normalizePath } from "./paths.js";
@@ -41,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
@@ -66,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
@@ -256,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 = "";
@@ -295,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 || ""),
   };
 
@@ -335,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}'",

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

@@ -8,6 +8,7 @@ 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).",
@@ -78,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/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}'",

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

@@ -8,6 +8,7 @@ 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": "모든 워크플로우 파일이 설치 시점 기본값과 동일합니다 (수정 없음).",
@@ -78,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/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

@@ -16,6 +16,7 @@ import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "./core/a
 import { detectTypes, detectDefaultBranch, detectRepoName, makeResolvers, detectMarkers } from "./core/detect-fs.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 },
     );
   }
@@ -366,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/prompts.js

@@ -6,6 +6,7 @@ import * as engine from "./readline-engine.js";
 import { t } from "../i18n/index.js";
 import { DEPLOY_STYLES, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { TYPE_IDS, typeInfo } from "../core/types.js";
+import { askableOptions } from "../core/options.js";
 import { ENV_MODES, DEFAULT_ENV_MODE, STORE_PLATFORMS, DEPLOY_MODES, DEFAULT_DEPLOY_MODE, deployModeWarning } from "../core/flutter-options.js";
 
 export const CANCEL = engine.CANCEL;
@@ -47,8 +48,7 @@ export function editMenuOptions({ showFlutter = false, showOptions = false } = {
     { value: "branch", label: t("ui.prompts.edit.branch") },
   ];
   if (showOptions) {
-    options.push({ value: "semverAuto", label: t("ui.prompts.edit.semverAuto") });
-    options.push({ value: "copilotAi", label: t("ui.prompts.edit.copilotAi") });
+    for (const o of askableOptions()) options.push({ value: o.name, label: t(o.ask.menuLabelKey) });
   }
   if (showFlutter) {
     options.push({ value: "envMode", label: t("ui.prompts.edit.envMode") });

package/src/ui/status-cards.js

@@ -3,6 +3,7 @@
 import { A, paint } from "./ansi.js";
 import { t } from "../i18n/index.js";
 import { DEFAULT_DEPLOY_MODE } from "../core/flutter-options.js";
+import { askableOptions } from "../core/options.js";
 
 const GUT = paint("│", A.gray);
 const HEAD = paint("◆", A.cyan);
@@ -59,8 +60,7 @@ export function printAnalysisCard({ mode = "", modeLabel = "", types = [], versi
   // Optional workflows - a saved value is used without asking, so show the current value before confirmation.
   if (options) {
     const onOff = (v) => (v ? paint(t("ui.status-cards.card.on"), A.green) : paint(t("ui.status-cards.card.off"), A.dim));
-    row("🔢", t("ui.status-cards.card.autoBump"), onOff(options.semverAuto));
-    row("🤖", "Copilot", onOff(options.copilotAi));
+    for (const o of askableOptions()) row(o.ask.cardIcon, t(o.ask.cardLabelKey), onOff(options[o.name]));
   }
   // Monorepo paths - shown when at least one entry is not the root
   const nonRoot = [...paths.entries()].filter(([, p]) => p && p !== ".");