project-auto-wizard 0.12.2 → 0.13.1

package/src/commands/interactive-flutter.js

@@ -46,7 +46,7 @@ async function askUnsetDeployModes(io, state) {
 
 // 아직 정해지지 않은 옵션만 묻는다.
 //   envModeDefault  — 신규 설치 dart-define / 기존 설치 dotenv (동작 보존)
-//   inferredStores  — 저장값 없는 기존 설치가 이미 쓰던 스토어 (신규 설치는 [])
+//   inferredStores  — 저장값 없는 기존 설치가 이미 쓰던 스토어 (신규 설치는 CLI 기본값과 같은 전체)
 export async function askUnsetFlutterOptions(io, state, { envModeDefault, inferredStores }) {
   const next = { ...state };
   if (!next.envMode) {

package/src/commands/interactive.js

@@ -1,24 +1,28 @@
-// 대화형 마법사 (.sh interactive_mode 등가) + #446 UI 층.
+// 대화형 마법사.
 // io 주입으로 테스트 가능. 실제 실행은 src/ui/prompts.js 함수를 io로 넘긴다.
 // 새 시각 층(banner/detectionLog/analysisCard/installKind/summary)과 저수준 엔진(engineIo)은
 // io의 "옵셔널 멤버" — 스텁이 생략하면 해당 층만 건너뛰고 실행 계약은 동일하다.
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "../core/assets.js";
-import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber, detectMarkers } from "../core/detect-fs.js";
+import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectMarkers } from "../core/detect-fs.js";
 import { parseExisting } from "../core/version-yml.js";
+import { pickReleaseOptions, resolveReleaseOptions } from "../core/release-options.js";
 import { runBreakingCheck } from "../core/breaking-check.js";
 import { resolveProjectPaths } from "../core/paths-resolve.js";
-import { resolveBranchConfig, detectRemoteBranches, ensureDevelopBranch, sortBranchesForSelection } from "../core/branches.js";
+import {
+  resolveBranchConfig, detectRemoteBranches, ensureDevelopBranch, sortBranchesForSelection, isValidBranchName, developMissingNotice,
+} from "../core/branches.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
 import { surveyWorkflows } from "../core/copy/workflows.js";
-import { createContext, VALID_TYPES } from "../context.js";
-import { isDeployStyle, DEFAULT_DEPLOY_STYLE } from "../core/deploy-style.js";
+import { VALID_TYPES } from "../context.js";
+import { savedDeployStyle, resolveDeployStyle, resolveVersion, resolveVersionCode, buildInstallContext } from "./install-settings.js";
+import { isDeployStyle, DEFAULT_DEPLOY_STYLE, hasServerDeployWorkflows, hasNonstopWorkflows } from "../core/deploy-style.js";
 import { PATHS } from "../core/paths.js";
-import { resolveFlutterOptions, DEFAULT_DEPLOY_MODE } from "../core/flutter-options.js";
+import { resolveFlutterOptions, DEFAULT_DEPLOY_MODE, STORE_PLATFORMS } from "../core/flutter-options.js";
 import { inferInstalledStores } from "../core/installed-stores.js";
 import { savedFlutterState, askUnsetFlutterOptions, editFlutterOption, FLUTTER_EDIT_ITEMS } from "./interactive-flutter.js";
-import { runFull } from "./full.js";
+import { runFull, postInstallNotices } from "./full.js";
 import { runUninstallFlow } from "./uninstall.js";
 import * as prompts from "../ui/prompts.js";
 import { runStatus, printStatus } from "./status.js";
@@ -26,6 +30,9 @@ import { runDoctor, printDoctorReport } from "./doctor.js";
 import { currentLogPath, hasLegacyMdLogs } from "../core/logger.js";
 
 const CANCEL = prompts.CANCEL;
+
+const SEMVER_AUTO_QUESTION = "자동 버전 승격을 사용하시겠습니까? (커밋 타입에 따라 major/minor/patch 자동 결정)";
+const COPILOT_AI_QUESTION = "Copilot으로 AI 요약을 생성하시겠습니까? (GitHub Copilot AI Credits가 소비되며, 사용할 수 없으면 자동으로 규칙 기반 요약으로 전환됩니다)";
 const isCancel = (v) => v === CANCEL || typeof v === "symbol";
 
 // io 기본값 = 실제 prompts. 테스트는 스텁 io 주입.
@@ -37,7 +44,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   if (io.banner) io.banner({ version: templateVersion, modeLabel: "대화형 통합 마법사" });
   else io.intro?.("project-auto-wizard — 대화형 통합 마법사");
 
-  // 기존 version.yml — version/version_code/paths/옵션 보존의 단일 진실 (.sh SSoT L2208~2239)
+  // 기존 version.yml — version/version_code/paths/옵션 보존의 단일 진실
   const vyPath = join(cwd, "version.yml");
   const existing = existsSync(vyPath) ? parseExisting(readFileSync(vyPath, "utf8")) : null;
 
@@ -65,7 +72,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     return 0;
   }
 
-  // Breaking Changes 게이트 (.sh execute_integration L4415~4420 — 모든 모드 공통, 대화형은 확인 질문)
+  // Breaking Changes 게이트 (모든 모드 공통, 대화형은 확인 질문)
   const proceed = await runBreakingCheck({
     cwd, payloadRoot: payload, templateVersion,
     askYesNo: (msg, def) => io.askYesNo(msg, def),
@@ -77,17 +84,24 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   // 먼저 나와 앞선 질문에 대한 경고처럼 보였다. 안내 문구도 대화형용으로 바꾼다.
   const detectWarnings = [];
   let types = detectTypes(cwd);
-  let version = (existing?.version) || detectVersion(cwd, {
+  let version = resolveVersion({
+    cwd, existing, types,
     warn: (m) => detectWarnings.push(m),
     hint: "다음 화면의 '수정하기 > 버전'에서 바로 고칠 수 있습니다.",
   });
-  let branch = detectDefaultBranch(cwd);
+  // 경로가 확정된 뒤 모노레포 하위 폴더에서 다시 감지할지 — 저장값·직접 입력한 값은 건드리지 않는다.
+  let versionAutoDetected = !existing?.version;
+  let branch = detectDefaultBranch(cwd, {
+    warn: (m) => detectWarnings.push(m),
+    hint: "다르면 뒤의 '릴리스 브랜치' 질문에서 바꿀 수 있습니다.",
+  });
   const repoName = detectRepoName(cwd);
-  // 선택 워크플로우 초기값: version.yml 저장 옵션 (.sh read_template_options L2361 등가)
-  let includeSemverAuto = existing?.options?.semverAuto ?? null;
-  let includeCopilotAi = existing?.options?.copilotAi ?? null;
+  // 선택 워크플로우 초기값: CLI 플래그(--copilot 등) → version.yml 저장 옵션
+  // 플래그로 정한 값은 질문을 생략한다 — 비대화형과 같은 우선순위.
+  let { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi } = pickReleaseOptions(
+    { semverAuto: baseCtx?.includeSemverAuto, copilotAi: baseCtx?.includeCopilotAi }, existing);
   // 서버 배포 방식 — 저장값(version.yml)이 있으면 재질문하지 않는다 (semver_auto와 같은 규약).
-  let deployStyle = isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : "";
+  let deployStyle = savedDeployStyle(existing);
   const showOptional = mode === "full";
   const realTty = process.stdout.isTTY === true;
 
@@ -99,12 +113,21 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     envModeDefault: resolveFlutterOptions({
       cli: { envMode: "", stores: null, androidDeployMode: "", iosDeployMode: "" }, existing,
     }).envMode,
-    inferredStores: existing && flutter.stores === null ? inferInstalledStores(join(cwd, PATHS.workflowsDir)) : [],
+    // 신규 설치의 초기 선택은 CLI 기본값(--flutter-store 미지정 = 둘 다)과 같아야 한다 — 경로에 따라 설치 결과가 달라지면 안 된다.
+    inferredStores: existing && flutter.stores === null ? inferInstalledStores(join(cwd, PATHS.workflowsDir)) : [...STORE_PLATFORMS],
   };
   // 이미 정해진 값은 건너뛰므로 여러 번 불러도 같은 질문이 반복되지 않는다.
   const askFlutterOptions = async () => {
     if (types.includes("flutter")) flutter = await askUnsetFlutterOptions(io, flutter, flutterAsk);
   };
+  // 서버 배포 방식 — 서버 배포(CD) 워크플로우가 있는 타입(spring·go·python 등)일 때만 묻는다.
+  // 그 외 타입에는 설치 결과에 영향이 없는 질문이라 묻지도 기록하지도 않는다.
+  const hasServerDeploy = () => hasServerDeployWorkflows(payload, types);
+  const askDeployStyle = async () => {
+    if (isDeployStyle(deployStyle) || !hasServerDeploy()) return;
+    const picked = await io.selectDeployStyle({ nonstop: hasNonstopWorkflows(payload, types) });
+    deployStyle = isDeployStyle(picked) ? picked : DEFAULT_DEPLOY_STYLE; // ESC = 기본값
+  };
 
   // 감지 로그. markers = 실제로 존재를 확인한 파일.
   let markers = detectMarkers(cwd, types);
@@ -127,11 +150,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
 
   // 배포 방식·Flutter 옵션·semver/Copilot 질문 — 선택 항목을 묻는 경우(showOptional)만
   if (showOptional) {
-    // 서버 배포 방식.
-    if (!isDeployStyle(deployStyle)) {
-      const picked = await io.selectDeployStyle();
-      deployStyle = isDeployStyle(picked) ? picked : DEFAULT_DEPLOY_STYLE; // ESC = 기본값
-    }
+    await askDeployStyle();
 
     // Flutter 옵션 — 환경변수 방식 → 스토어 배포 대상 → 플랫폼별 배포 모드.
     await askFlutterOptions();
@@ -139,31 +158,37 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     // 신규 질문 — 자동 semver 승격 (기본 ON). 저장값 있으면 재질문 생략.
     // version.yml을 쓰지 않는 workflows 모드에서는 답변이 무의미하므로 full에서만 질문한다.
     if (mode === "full" && includeSemverAuto === null) {
-      const y2 = await io.askYesNo("자동 버전 승격을 사용하시겠습니까? (커밋 타입에 따라 major/minor/patch 자동 결정)", true);
+      const y2 = await io.askYesNo(SEMVER_AUTO_QUESTION, true);
       includeSemverAuto = y2 === true;
     }
 
     // Copilot AI 요약 — AI Credits를 소비하므로 opt-in(기본 No). 저장값 있으면 재질문 생략.
     if (mode === "full" && includeCopilotAi === null) {
-      const y3 = await io.askYesNo("Copilot으로 AI 요약을 생성하시겠습니까? (GitHub Copilot AI Credits가 소비되며, 사용할 수 없으면 자동으로 규칙 기반 요약으로 전환됩니다)", false);
+      const y3 = await io.askYesNo(COPILOT_AI_QUESTION, false);
       includeCopilotAi = y3 === true;
     }
   }
-  // 질문이 실제로 나온 경우(위 full 모드 질문) 답변을 그대로 존중.
-  // 질문이 안 나온 경우(version/workflows 모드) — 기존 설치는 안전하게 false로 폴백,
-  // 완전 신규 설치만 true(기존 설계) 유지 — CLI 경로(index.js)와 동일한 안전 정책.
-  includeSemverAuto = includeSemverAuto === null ? (existing ? false : true) : includeSemverAuto !== false;
-  includeCopilotAi = includeCopilotAi === true;
+  // 질문이 실제로 나온 경우(위 full 모드 질문) 답변을 그대로 존중하고, 안 나온 옵션만 기본값으로 채운다
+  // — CLI 경로(index.js)와 같은 함수라 같은 규칙이다.
+  ({ includeSemverAuto, includeCopilotAi } = resolveReleaseOptions(
+    { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi }, existing));
+  const showOptionToggles = mode === "full";
 
-  // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
+  // 확인/수정 루프 — ESC는 '머무르기' (명시적 '아니오'만 종료)
   let paths = new Map();
   let confirmed = false;
   while (!confirmed) {
     // 프로젝트 분석 개요 카드. 스텁엔 없음 → note 폴백.
     if (io.analysisCard) {
-      io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, showOptional, paths, flutter, envModeDefault: flutterAsk.envModeDefault });
+      io.analysisCard({
+        mode, modeLabel: modeLabel(mode), types, version, branch, showOptional, paths, flutter, envModeDefault: flutterAsk.envModeDefault,
+        options: showOptionToggles ? { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi } : null,
+      });
     } else {
-      io.note?.(summarize({ mode, types, version, branch, showOptional, flutter, envModeDefault: flutterAsk.envModeDefault }), "프로젝트 분석 결과");
+      io.note?.(summarize({
+        mode, types, version, branch, showOptional, flutter, envModeDefault: flutterAsk.envModeDefault,
+        options: showOptionToggles ? { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi } : null,
+      }), "프로젝트 분석 결과");
     }
     const choice = await io.confirmProjectMenu();
     if (choice === "cancel") { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
@@ -172,12 +197,12 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     // edit 루프
     let editing = true;
     while (editing) {
-      const what = await io.editMenu({ showFlutter: showOptional && types.includes("flutter") });
+      const what = await io.editMenu({ showFlutter: showOptional && types.includes("flutter"), showOptions: showOptionToggles });
       if (isCancel(what) || what === "done") { editing = false; break; }
       if (what === "type") {
         const t = await io.selectTypes(types);
         if (!isCancel(t) && Array.isArray(t) && t.length) {
-          // 타입 집합이 실제로 바뀌면 경로 재해석 대상으로 초기화 (.sh L1984~1992 — 정렬 집합 비교)
+          // 타입 집합이 실제로 바뀌면 경로 재해석 대상으로 초기화 (정렬 집합 비교)
           const oldSorted = [...types].sort().join(",");
           types = t.filter((x) => VALID_TYPES.includes(x));
           if ([...types].sort().join(",") !== oldSorted) paths = new Map();
@@ -185,13 +210,19 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       } else if (what === "version") {
         const v = await io.askText("새 버전 (예: 1.0.0)", version);
         if (!isCancel(v) && v !== version) {
-          // semver 형식 검증 (.sh L2010~2015)
-          if (/^\d+\.\d+\.\d+$/.test(v)) version = v;
+          // semver 형식 검증
+          if (/^\d+\.\d+\.\d+$/.test(v)) { version = v; versionAutoDetected = false; }
           else io.note?.("버전 형식이 올바르지 않습니다 (x.y.z 형태) — 기존 값을 유지합니다.", "⚠ 버전");
         }
       } else if (what === "branch") {
-        const b = await io.askText("기본 브랜치", branch);
-        if (!isCancel(b) && b) branch = b;
+        branch = await askBranchName(io, "기본 브랜치", branch, isCancel);
+      } else if (what === "semverAuto") {
+        // 저장값이 있으면 처음 질문을 건너뛰므로, 한 번 정한 값을 바꿀 수 있는 곳은 여기뿐이다.
+        const y = await io.askYesNo(SEMVER_AUTO_QUESTION, includeSemverAuto);
+        if (typeof y === "boolean") includeSemverAuto = y;
+      } else if (what === "copilotAi") {
+        const y = await io.askYesNo(COPILOT_AI_QUESTION, includeCopilotAi);
+        if (typeof y === "boolean") includeCopilotAi = y;
       } else if (FLUTTER_EDIT_ITEMS.has(what)) {
         flutter = await editFlutterOption(io, what, flutter, flutterAsk.envModeDefault);
       }
@@ -199,7 +230,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   }
 
   // 편집 루프에서 뒤늦게 flutter 타입이 추가된 경우에도 옵션을 확정한다 — 이미 정해진 값은 다시 묻지 않는다.
-  if (showOptional) await askFlutterOptions();
+  // 서버 배포 타입이 뒤늦게 추가된 경우도 같다.
+  if (showOptional) {
+    await askDeployStyle();
+    await askFlutterOptions();
+  }
   // 질문이 나오지 않은 경우(비 full 모드 등)도 동작 보존 기본값으로 채워 워크플로우 치환이 어긋나지 않게 한다.
   const flutterOptions = {
     envMode: flutter.envMode || flutterAsk.envModeDefault,
@@ -208,14 +243,17 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     iosDeployMode: flutter.iosDeployMode || DEFAULT_DEPLOY_MODE,
   };
 
-  const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지
-
-  // 신규 질문 ① — 브랜치 설정 (DESIGN-SPEC §4). full/workflows만 질문, version은 기본값 기록.
+  // 브랜치 설정. full/workflows만 질문, version은 기본값 기록.
   // 저장값(version.yml metadata.template.branches)이 있으면 재질문 없이 재사용 (업데이트 모드).
-  let branches = existing?.branches
-    ? resolveBranchConfig({ mainBranch: existing.branches.main, developBranch: existing.branches.develop, defaultBranch: branch })
+  // 이전 버전이 저장한 감지 실패 값("(unknown)" 등)이 있으면 저장값이 없는 것으로 보고 다시 묻는다.
+  const savedBranches = existing?.branches
+    && isValidBranchName(existing.branches.main) && isValidBranchName(existing.branches.develop)
+    ? existing.branches : null;
+  let branches = savedBranches
+    ? resolveBranchConfig({ mainBranch: savedBranches.main, developBranch: savedBranches.develop, defaultBranch: branch })
     : resolveBranchConfig({ defaultBranch: branch });
-  if (showOptional && !existing?.branches) {
+  let developMissing = false;
+  if (showOptional && !savedBranches) {
     const remoteBranches = await detectRemoteBranches(cwd);
     // 두 질문에 같은 이름을 입력해야만 trunk-based가 되는 암묵적 규칙 대신,
     // 전략을 먼저 명시적으로 고르게 한다. 취소/그 외 값은 기존 기본 동작과 같은 pr-flow로 폴백
@@ -230,16 +268,21 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     branches = resolveBranchConfig({ mainBranch: mainB, developBranch: devB, defaultBranch: branch });
     if (branches.mode === "trunk-based") {
       io.note?.(`릴리스 브랜치(${branches.main}) 하나만 사용하는 trunk-based 모드로 설치합니다 (RELEASE-PUBLISH 단독).`, "브랜치 모드");
-    } else if (remoteBranches.length && !remoteBranches.includes(branches.develop)) {
-      await ensureDevelopBranch({
+    } else if (!remoteBranches.length) {
+      // 원격이 없거나 비어 있으면 push할 기준이 없다 — 만들지 않았다는 사실과 방법을 알린다.
+      developMissing = true;
+      io.note?.(developMissingNotice(branches), "브랜치");
+    } else if (!remoteBranches.includes(branches.develop)) {
+      const r = await ensureDevelopBranch({
         develop: branches.develop, remoteBranches, cwd,
         confirm: (msg) => io.askYesNo(msg, true),
         log: (m) => io.note?.(m, "브랜치"),
       });
+      developMissing = r.created !== true || r.pushed === false;
     }
   }
 
-  // 경로 확정 (.sh resolve_project_paths L1362~1589 — 저장값·후보 스캔·질문)
+  // 경로 확정 (저장값·후보 스캔·질문)
   if (mode === "full") {
     paths = await resolveProjectPaths({
       root: cwd, types, paths, existingPaths: existing?.paths ?? new Map(),
@@ -249,7 +292,13 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     for (const t of types) if (t !== "basic" && !paths.has(t)) paths.set(t, existing?.paths.get(t) || ".");
   }
 
-  // @wizard env 계획 질문 (.sh wf_prompt_env_plan L3220 — full/workflows만)
+  // 모노레포는 버전·빌드 번호 파일이 타입 폴더 안에 있다 — 경로가 확정된 지금 그 폴더에서 감지한다.
+  if (versionAutoDetected && [...paths.values()].some((p) => p && p !== ".")) {
+    version = detectVersion(cwd, { types, paths, warn: () => {} });
+  }
+  const versionCode = resolveVersionCode({ cwd, existing, types, paths });
+
+  // @wizard env 계획 질문 (full/workflows만)
   const resolvers = makeResolvers(cwd, repoName, paths, flutterOptions);
   let envValues = new Map(), envUseDefaults = true, envAnswers = [];
   if (showOptional) {
@@ -264,19 +313,17 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   }
 
   const { now, today } = clock || utcNow();
-  const ctx = createContext({
-    mode, force: true, types, version, versionCode, branch, branches, paths,
-    includeSemverAuto,
-    includeCopilotAi,
-    repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
+  const ctx = buildInstallContext({
+    payload, existing, templateVersion, types,
+    // 저장값이 무중단이어도 선택한 타입에 그 방식이 없으면 단일 서버 배포가 설치된다 — 설치된 방식을 기록한다.
+    deployStyle: resolveDeployStyle({ payload, types, explicit: deployStyle, existing }),
+    flutterOptions,
+    releaseOptions: { includeSemverAuto, includeCopilotAi },
+    mode, force: true, version, versionCode, branch, branches, paths,
+    repoName, resolvers, envValues, envUseDefaults, now, today,
     // 설치 로그·완료 요약이 쓰는 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     markers, envAnswers, detectWarnings,
-    deployStyle: deployStyle || DEFAULT_DEPLOY_STYLE,
-    envMode: flutterOptions.envMode, flutterStore: flutterOptions.stores,
-    androidDeployMode: flutterOptions.androidDeployMode, iosDeployMode: flutterOptions.iosDeployMode,
-    previousTemplateVersion: existing?.templateVersion || "",
   });
-  ctx.templateVersion = templateVersion;
 
   // 사용자가 답해야 하는 것만 묻는다. baseline 3-way가 자동으로 안전한 경우를
   // 걸러내므로, 여기 오는 것은 (a) 양쪽이 다 바뀐 진짜 충돌과 (b) 사용자가 지운 파일뿐이다.
@@ -301,7 +348,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       }
     }
 
-    // (a) 진짜 충돌 3지선 — 타입당 1회 결정을 파일에 캐시 적용 (.sh L3440~3508 UX 등가)
+    // (a) 진짜 충돌 3지선 — 타입당 1회 결정을 파일에 캐시 적용
     const decisions = new Map();
     if (conflicts.length) {
       const perType = new Map();
@@ -315,7 +362,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
               { value: "template", label: "기존 유지 + 새 버전을 .template.yaml로 참고 추가" },
             ],
           });
-          perType.set(type, isCancel(sel) || sel == null ? "skip" : sel); // ESC = 건너뛰기 (.sh L3463)
+          perType.set(type, isCancel(sel) || sel == null ? "skip" : sel); // ESC = 건너뛰기
         }
         decisions.set(filename, perType.get(type));
       }
@@ -325,20 +372,26 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
 
   const result = runFull(ctx, payload, cwd, hooks);
 
-  // 완료 요약 (.sh print_summary L5438)
+  // 완료 요약
   io.summary?.({
-    mode, types, version, versionCode, branches,
+    mode, types, version, versionCode, branches, developMissing,
     copiedFiles: result?.workflows?.copiedFiles ?? [],
+    autoUpdated: result?.workflows?.autoUpdated ?? [],
     gitignoreUpdated: result?.gitignoreUpdated === true,
     answers: envAnswers,
     unresolved: result?.unresolved ?? [],
     secrets: result?.secrets ?? new Map(),
+    optionalSecrets: result?.optionalSecrets ?? new Map(),
     logPath: currentLogPath(),
     legacyMdLogs: hasLegacyMdLogs(cwd),
     cleanup: result?.cleanup ?? null,
     storeCleanup: result?.storeCleanup ?? null,
     flutterApp: result?.flutterApp ?? null,
+    readme: result?.readme ?? null,
+    scripts: result?.scripts ?? null,
   });
+  const notices = postInstallNotices(result, { interactive: true });
+  if (notices.length) io.note?.(notices.join("\n"), "이전 워크플로우 정리");
   io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
   return 0;
 }
@@ -354,17 +407,26 @@ export async function pickBranch(io, message, def, remoteBranches, isCancel) {
     options.push({ value: "__custom__", label: "직접 입력..." });
     const initialIndex = Math.max(0, options.findIndex((o) => o.value === def));
     const sel = await io.engineIo.select({ message, options, initialIndex });
-    if (sel === "__custom__") {
-      const v = await io.askText("브랜치 이름", def);
-      return isCancel(v) || !v ? def : v;
-    }
+    if (sel === "__custom__") return askBranchName(io, "브랜치 이름", def, isCancel);
     return isCancel(sel) || sel == null ? def : sel;
   }
-  const v = await io.askText(message, def);
-  return isCancel(v) || !v ? def : v;
+  return askBranchName(io, message, def, isCancel);
 }
 
-function summarize({ mode, types, version, branch, showOptional, flutter, envModeDefault }) {
+// 브랜치 이름 텍스트 입력 — 앞뒤 공백을 떼고, 비었거나 ESC면 기본값, 쓸 수 없는 이름이면 다시 묻는다.
+// 입력값이 워크플로우 트리거에 그대로 들어가므로 공백 포함 이름 등은 워크플로우가 영영 돌지 않는다.
+async function askBranchName(io, message, def, isCancel) {
+  for (;;) {
+    const v = await io.askText(message, def);
+    if (isCancel(v)) return def;
+    const name = String(v ?? "").trim();
+    if (!name) return def;
+    if (isValidBranchName(name)) return name;
+    io.note?.(`'${name}'은(는) 브랜치 이름으로 쓸 수 없습니다 (공백·특수문자·'..' 등 불가) — 다시 입력하세요.`, "⚠ 브랜치");
+  }
+}
+
+function summarize({ mode, types, version, branch, showOptional, flutter, envModeDefault, options = null }) {
   const lines = [
     `통합 모드 : ${modeLabel(mode)}`,
     `프로젝트 타입 : ${types.join(", ")}${types.length > 1 ? " (멀티)" : ""}`,
@@ -380,6 +442,10 @@ function summarize({ mode, types, version, branch, showOptional, flutter, envMod
       lines.push(`배포 모드 : ${modeParts.length ? modeParts.join(" ") : "없음"}`);
     }
   }
+  if (options) {
+    lines.push(`자동 버전 승격 : ${options.semverAuto ? "켜짐" : "꺼짐"}`);
+    lines.push(`Copilot AI 요약 : ${options.copilotAi ? "켜짐" : "꺼짐"}`);
+  }
   return lines.join("\n");
 }
 

package/src/commands/purge.js

@@ -1,29 +1,58 @@
 // purge 모드 — planRemoval이 판별하는 전부(워크플로우·스크립트) + version.yml·README
-// AUTO-VERSION-SECTION 블록·CHANGELOG를 추가로 제거해 설치 이전 상태로 완전히 되돌린다.
-// 개발·테스트 전용 숨김 모드 — DESIGN-SPEC purge #6.
+// AUTO-VERSION-SECTION 블록·.gitignore 자동 추가 항목·릴리스 워크플로우가 만든 CHANGELOG를
+// 추가로 제거해 설치 이전 상태로 완전히 되돌린다. 마법사가 만들지 않은 파일은 지우지 않는다.
+// 개발·테스트 전용 숨김 모드.
 // develop 브랜치 삭제는 파일 삭제와 성격이 달라(실행 시점 git 상태 판단 필요) 여기 plan에는
 // 포함하지 않고 index.js의 purge 분기에서 직접 처리한다.
 import { join } from "node:path";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { PATHS } from "../core/paths.js";
-import { remove } from "../core/fsutil.js";
-import { planRemoval } from "../core/removal-plan.js";
-import { removeVersionSectionFromReadme, hasVersionSection } from "../core/copy/readme.js";
-import { log } from "../core/logger.js";
+import { planRemoval, backupArtifacts } from "../core/removal-plan.js";
+import { executeRemoval } from "../core/removal-exec.js";
+import { hasVersionSection } from "../core/copy/readme.js";
+import { hasAutoAddedEntries } from "../core/copy/gitignore.js";
 
 const CHANGELOG_FILES = ["CHANGELOG.json", "CHANGELOG.md"];
 
+// changelog_manager.py가 만든 CHANGELOG인지 — 사용자가 원래 쓰던 CHANGELOG.md를 지우지 않기 위해 내용으로 가린다.
+// CHANGELOG.json은 metadata·releases 구조로, CHANGELOG.md는 generate-md가 쓰는 머리말로 판단한다.
+// JSON이 우리 것이면 MD는 릴리스마다 JSON에서 통째로 재생성되므로 함께 우리 것이다.
+function readText(targetRoot, f) {
+  try { return readFileSync(join(targetRoot, f), "utf8").replace(/\r\n/g, "\n"); } catch { return null; }
+}
+function isGeneratedChangelogJson(targetRoot) {
+  const text = readText(targetRoot, "CHANGELOG.json");
+  if (text === null) return false;
+  try {
+    const data = JSON.parse(text);
+    return !!data && typeof data.metadata === "object" && Array.isArray(data.releases);
+  } catch { return false; }
+}
+function generatedChangelogFiles(targetRoot) {
+  const jsonOurs = isGeneratedChangelogJson(targetRoot);
+  const md = readText(targetRoot, "CHANGELOG.md");
+  const mdOurs = md !== null && (jsonOurs || md.startsWith("# Changelog\n\n**현재 버전:**"));
+  return CHANGELOG_FILES.filter((f) => (f === "CHANGELOG.json" ? jsonOurs : mdOurs));
+}
+
 // keepFlags: { versionYml, readme, changelog, workflows, scripts } — true인 카테고리는 후보에서 제외.
-// 반환: { workflows, scripts, versionYml, readmeSection, changelog } — 아무것도 지우지 않는 순수 함수.
+// 반환: { workflows, scripts, versionYml, readmeSection, gitignore, changelog } — 아무것도 지우지 않는 순수 함수.
 export function planPurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   const removalPlan = planRemoval(payloadRoot, targetRoot);
+  // 워크플로우를 남기면 그 .bak/.template.yaml도 남는다 — .gitignore 항목까지 지우면 백업 파일이 git 상태에 드러난다.
+  const gitignoreKept = hasAutoAddedEntries(targetRoot) && keepFlags.workflows === true
+    && backupArtifacts(removalPlan.workflows).length > 0;
   return {
     workflows: keepFlags.workflows ? [] : removalPlan.workflows,
+    // Flutter 앱 파일의 생성 기록은 baseline에 있으므로 baseline과 같은 플래그를 따른다.
+    appFiles: keepFlags.workflows ? [] : removalPlan.appFiles,
     baseline: keepFlags.workflows ? [] : removalPlan.baseline,
     scripts: keepFlags.scripts ? [] : removalPlan.scripts,
     versionYml: !keepFlags.versionYml && existsSync(join(targetRoot, PATHS.versionFile)),
     readmeSection: !keepFlags.readme && hasVersionSection(targetRoot),
-    changelog: keepFlags.changelog ? [] : CHANGELOG_FILES.filter((f) => existsSync(join(targetRoot, f))),
+    gitignore: hasAutoAddedEntries(targetRoot) && !gitignoreKept,
+    gitignoreKept,
+    changelog: keepFlags.changelog ? [] : generatedChangelogFiles(targetRoot),
   };
 }
 
@@ -38,8 +67,11 @@ export function printPurgePlan(plan, { dryRun = false } = {}) {
   for (const f of plan.workflows) lines.push(`  - ${f}`);
   lines.push(`스크립트 (${plan.scripts.length}개):`);
   for (const f of plan.scripts) lines.push(`  - ${f}`);
+  for (const f of plan.appFiles || []) lines.push(`Flutter 앱 파일: ${f}`);
   if (plan.versionYml) lines.push("파일: version.yml");
   if (plan.readmeSection) lines.push("README.md: AUTO-VERSION-SECTION 블록");
+  if (plan.gitignore) lines.push(".gitignore: 자동 추가 항목(*.bak, *.template.yaml)");
+  if (plan.gitignoreKept) lines.push(".gitignore: 자동 추가 항목 유지 (남겨 둔 워크플로우의 백업 파일을 가리는 항목)");
   for (const f of plan.changelog) lines.push(`파일: ${f}`);
   lines.push("");
   console.log(lines.join("\n"));
@@ -49,33 +81,30 @@ export function printPurgePlan(plan, { dryRun = false } = {}) {
 // planRemoval 결과를 그대로 지우지 않는 이유: 그 목록은 항상 전체라서
 // --keep-* 로 선택적 카테고리만 보존하는 요구사항과 맞지 않는다.
 // readmeSection은 plan의 판정을 그대로 되돌려주지 않고
-// removeVersionSectionFromReadme()의 실제 반환값("removed"인지)을 반영한다 — 스펙 §6이
-// "반환값은 실제 삭제 결과를 반영"하라고 명시하기 때문에, plan과 실제 제거 조건이
+// removeVersionSectionFromReadme()의 실제 반환값("removed"인지)을 반영한다 — plan과 실제 제거 조건이
 // 이론상 어긋나는 경우에도 printPurgeResult가 거짓으로 "제거됨"을 보고하지 않는다.
 export function executePurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   const plan = planPurge(payloadRoot, targetRoot, keepFlags);
-  const wfDir = join(targetRoot, PATHS.workflowsDir);
-  for (const name of plan.workflows) { remove(join(wfDir, name)); log.info("remove", "workflow", name); }
-  for (const name of plan.scripts) { remove(join(targetRoot, PATHS.scriptsDir, name)); log.info("remove", "script", name); }
-  for (const p of plan.baseline || []) { remove(join(targetRoot, p)); log.info("remove", "metadata", p); }
-  if (plan.versionYml) { remove(join(targetRoot, PATHS.versionFile)); log.info("remove", "version", PATHS.versionFile); }
-  const readmeSection = plan.readmeSection && removeVersionSectionFromReadme(targetRoot) === "removed";
-  for (const f of plan.changelog) { remove(join(targetRoot, f)); log.info("remove", "changelog", f); }
-  return { ...plan, readmeSection };
+  const { readme, gitignore } = executeRemoval(targetRoot, { ...plan, readme: plan.readmeSection }, {
+    logOrder: ["version", "gitignore", "changelog", "readme"],
+    gitignoreDetail: (status) => (status === "removed" || status === "file-deleted" ? ".gitignore 자동 추가 항목" : null),
+  });
+  return { ...plan, readmeSection: readme, gitignore };
 }
 
 // 삭제 후 실제 제거된 목록 출력 — printPurgePlan과 완전히 동일한 형태(파일명 나열)로
-// 맞춘다 (개수만 출력하면 스펙 §5-6의 "제거된 목록 재출력" 요구를 충족하지 못함).
+// 맞춘다 (개수만 출력하면 무엇이 지워졌는지 확인할 수 없다).
 export function printPurgeResult(result) {
   const lines = ["", "제거됨:", ""];
   lines.push(`워크플로우 (${result.workflows.length}개):`);
   for (const f of result.workflows) lines.push(`  - ${f}`);
   lines.push(`스크립트 (${result.scripts.length}개):`);
   for (const f of result.scripts) lines.push(`  - ${f}`);
+  for (const f of result.appFiles || []) lines.push(`Flutter 앱 파일: ${f}`);
   if (result.versionYml) lines.push("파일: version.yml");
   if (result.readmeSection) lines.push("README.md: AUTO-VERSION-SECTION 블록");
+  if (result.gitignore) lines.push(".gitignore: 자동 추가 항목(*.bak, *.template.yaml)");
   for (const f of result.changelog) lines.push(`파일: ${f}`);
-  lines.push("(.gitignore에 추가된 백업 파일 제외 항목(*.bak/*.template.yaml)은 purge 대상에서 제외되어 그대로 보존됩니다)");
   lines.push("");
   console.log(lines.join("\n"));
 }

package/src/commands/status.js

@@ -6,6 +6,10 @@ import { planWorkflows } from "../core/copy/workflows.js";
 import { makeResolvers, detectRepoName, detectDefaultBranch } from "../core/detect-fs.js";
 import { PATHS } from "../core/paths.js";
 import { resolveFlutterOptions } from "../core/flutter-options.js";
+import { isDeployStyle, DEFAULT_DEPLOY_STYLE } from "../core/deploy-style.js";
+import { findStaleWorkflows } from "../core/removal-plan.js";
+import { readBaseline } from "../core/baseline.js";
+import { hooksFor } from "../core/types.js";
 
 // payloadRoot: 패키지 payload/ 루트. targetRoot: 상태를 확인할 대상 레포.
 export function runStatus(payloadRoot, targetRoot = ".") {
@@ -28,8 +32,13 @@ export function runStatus(payloadRoot, targetRoot = ".") {
     types: existing.types, paths: existing.paths,
     repoName, resolvers, branches: branchesForCompare,
     flutterStore: flutterOptions.stores,
+    // 설치 때 고른 배포 방식으로 비교해야 nginx·traefik CD 수정도 드리프트로 잡힌다.
+    // 빠지면 기본값(simple)으로 걸러 설치된 무중단 CD가 비교 대상에서 사라진다.
+    deployStyle: isDeployStyle(existing.options.deployStyle) ? existing.options.deployStyle : DEFAULT_DEPLOY_STYLE,
   };
   const plan = planWorkflows(context, payloadRoot, targetRoot);
+  // 현재 버전에 없는 옛 워크플로우 — 다음 업데이트에서 정리된다. 그 전까지는 옛 트리거로 계속 돈다.
+  const stale = findStaleWorkflows(payloadRoot, targetRoot, readBaseline(targetRoot));
 
   return {
     installed: true,
@@ -49,6 +58,7 @@ export function runStatus(payloadRoot, targetRoot = ".") {
       conflicts: plan.changed.map((f) => f.filename),          // 양쪽 변경 — 검토 필요
       removed: plan.removed.map((f) => f.filename),            // 내가 지웠고 복원하지 않음
     },
+    staleFiles: stale,
   };
 }
 
@@ -68,8 +78,9 @@ export function printStatus(status) {
   const boolLabel = (v) => (v === null ? "미설정(기본 false)" : v);
   const semverAutoLabel = status.options.semverAuto === null ? "미설정(기본 false)" : status.options.semverAuto;
   const copilotAiLabel = boolLabel(status.options.copilotAi ?? null);
-  const flutterLabels = status.types.includes("flutter") ? flutterOptionLabels(status.options) : "";
-  lines.push(`옵션            : semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${flutterLabels}`);
+  const typeLabels = hooksFor(status.types, "statusLabels").map(({ hook }) => hook(status.options)).join("");
+  const deployLabel = status.options.deployStyle ? ` deploy_style=${status.options.deployStyle}` : "";
+  lines.push(`옵션            : semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${deployLabel}${typeLabels}`);
   if (status.modifiedFiles.length) {
     lines.push("", `사용자가 수정한 워크플로우 파일 (${status.modifiedFiles.length}개):`);
     for (const f of status.modifiedFiles) lines.push(`  - ${f}`);
@@ -77,6 +88,11 @@ export function printStatus(status) {
     lines.push("", "모든 워크플로우 파일이 설치 시점 기본값과 동일합니다 (수정 없음).");
   }
 
+  if (status.staleFiles?.length) {
+    lines.push("", `현재 버전에 없는 이전 워크플로우 (${status.staleFiles.length}개 — 다음 업데이트에서 정리됨):`);
+    for (const f of status.staleFiles) lines.push(`  - ${f}`);
+  }
+
   // 업데이트하면 무슨 일이 일어나는지. baseline이 없는 설치는 전부 0이라 출력하지 않는다.
   const b = status.buckets || { autoUpdatable: [], localKept: [], conflicts: [], removed: [] };
   if (b.autoUpdatable.length || b.localKept.length || b.conflicts.length || b.removed.length) {
@@ -89,13 +105,3 @@ export function printStatus(status) {
   lines.push("");
   console.log(lines.join("\n"));
 }
-
-// Flutter 타입일 때만 붙는 옵션. 저장값이 없으면 그 상태에서 실제로 적용되는 동작을 함께 알린다.
-function flutterOptionLabels(options) {
-  return [
-    ` env_mode=${options.envMode ?? "미설정(dotenv 유지)"}`,
-    ` flutter_store=${options.flutterStore ?? "미설정(둘 다 설치)"}`,
-    ` android_deploy_mode=${options.androidDeployMode ?? "미설정(store_only)"}`,
-    ` ios_deploy_mode=${options.iosDeployMode ?? "미설정(store_only)"}`,
-  ].join("");
-}