project-auto-wizard 0.12.2 → 0.13.0

package/src/ui/env-plan.js

@@ -1,25 +1,22 @@
-// @wizard env 계획 질문 UI (.sh wf_scope_string/wf_collect_asks/_wf_print_field_card/
-// _wf_prefill_all/_wf_prefill_interactive/wf_prompt_env_plan 등가).
-// 실측 기준: template_integrator.sh 3059~3085(scope), 3087~3143(collect), 3152~3169(card),
-//           3220~3280(prompt 본체 wf_prompt_env_plan).
+// @wizard env 계획 질문 UI — ask 키 수집, 필드 카드 출력, 전부 기본값/일부만 변경 선택.
 // io 주입식 — 테스트는 {select, multiselect, text} 스텁을 넘긴다. 기본은 readline-engine 실물.
 import { join } from "node:path";
 import { readFileSync } from "node:fs";
 import { stdin, stderr } from "node:process";
-import { PAYLOAD } from "../core/paths.js";
+import { PAYLOAD, typeWorkflowDirs } from "../core/paths.js";
 import { exists, listYamlFiles } from "../core/fsutil.js";
 import { parseWizardLine, resolveToken, replaceProjectTokens } from "../core/wizard-env.js";
 import { loadWizardPrompts, wfField, workflowDisplayName } from "../core/wizard-labels.js";
-import { deployFilter, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
-import { buildTypeRootFilter } from "../core/copy/workflows.js";
+import { deployFilter, payloadWorkflowNames, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
+import { buildTypeRootFilter, readSavedDeployValues } from "../core/copy/workflows.js";
 import * as engine from "./readline-engine.js";
 
 const CANCEL = engine.CANCEL;
 
-// 진행 안내는 stderr로 출력 (.sh print_to_user가 >&2인 것과 동일 — stdout 파이프 오염 방지).
+// 진행 안내는 stderr로 출력 (stdout 파이프 오염 방지).
 const defaultLog = (s = "") => stderr.write(s + "\n");
 
-// 사용처 문자열 조립 (.sh wf_scope_string 등가).
+// 사용처 문자열 조립.
 // usages: [{type, workflowName}] — 타입이 여러 개면 타입만 "t1·t2", 하나면 "타입 name1·name2".
 export function scopeString(usages = []) {
   const types = []; const names = [];
@@ -31,18 +28,21 @@ export function scopeString(usages = []) {
   return `${types.join("·")} ${names.join("·")}`.trim();
 }
 
-// ask KEY 수집 (.sh wf_collect_asks 등가) — 실제 설치되는 워크플로우와 같은 소스를 스캔한다.
+// ask KEY 수집 — 실제 설치되는 워크플로우와 같은 소스를 스캔한다.
 // payloadRoot: 패키지 payload/ 루트. types: 설치 대상 타입 목록.
 // opts:
-//   resolvers    - @접두 기본값(@repo 등) 해석용 (.sh는 수집 시점에 resolve_token — 동일)
+//   resolvers    - @접두 기본값(@repo 등) 해석용 (수집 시점에 해석)
 //   flutterStore - Flutter 스토어 대상(string[]|null). 배열이면 선택 해제된 스토어 워크플로우는 스캔에서 제외 (null=현행)
 //   prompts      - wizard-labels 파싱 객체 (워크플로우 표시명용, null이면 확장자 제거 폴백)
+//   saved        - Map<type, Map<key,value>>: version.yml deploy 블록 저장값. 있으면 그 값을 기본값으로 보여준다
+//                  (업데이트 때 "기본값 그대로"를 고르면 설치 때 답한 값이 유지되어야 한다)
 // 반환: { keys:[], defaults:Map<key,default>, typeDefaults:Map<"type|key",default>,
 //        usages:Map<key,[{type,workflowName}]> }
 export function collectAsks(payloadRoot, types = [], opts = {}) {
-  const { resolvers = {}, deployStyle = "", flutterStore = null, prompts = null } = opts;
+  const { resolvers = {}, deployStyle = "", flutterStore = null, prompts = null, saved = new Map() } = opts;
   // 설치하지 않을 배포 워크플로우의 질문까지 묻지 않는다 — 질문 수는 설치 범위를 따라간다.
-  const keepDeploy = deployFilter(deployStyle);
+  const available = payloadWorkflowNames(payloadRoot);
+  const keepDeploy = deployFilter(deployStyle, available);
   const baseDir = join(payloadRoot, PAYLOAD.workflowsDir);
   const keys = [];
   const defaults = new Map();
@@ -55,19 +55,15 @@ export function collectAsks(payloadRoot, types = [], opts = {}) {
   const commonDir = join(baseDir, "common");
   if (exists(commonDir)) units.push(["common", commonDir, null]);
   for (const type of types) {
-    const typeDir = join(baseDir, type);
+    const [typeDir, serverDeployDir] = typeWorkflowDirs(payloadRoot, type);
     if (!exists(typeDir)) continue;
-    // 복사 엔진과 동일한 폴더 구성: 타입 직하위 + ("배포 안 함"이
-    // 아닐 때만) server-deploy. server-deploy가 있는 타입은 "none"일 때 그 폴더(PR 프리뷰
-    // 포함) 자체를 스캔에서 뺀다.
-    // go/python처럼 CD가 server-deploy 없이 타입 루트에 바로 있는 타입은, "배포 안 함"일 때
-    // 타입 루트 스캔에도 keepDeploy를 걸어야 CD 전용 ask 키(예: DEPLOY_PORT)가 걸러진다.
-    // PR 프리뷰 자체의 ask 키(SSH_AUTH_METHOD 등)는 이 필터로는 걸러지지 않는다 — PR 프리뷰는
-    // 배포 방식과 무관하게 항상 설치되는 별도 축이라 의도된 잔여 범위다.
+    // 복사 엔진과 동일한 폴더 구성: 타입 직하위 + ("배포 안 함"이 아닐 때만) server-deploy.
+    // go/python·react/next처럼 서버 배포 워크플로우가 타입 루트에 바로 있는 타입도 같은 배포 방식
+    // 필터로 거른다 — "배포 안 함"이면 CD·PR 프리뷰 전용 ask 키(DEPLOY_PORT, SSH_AUTH_METHOD 등)를 묻지 않는다.
     // Flutter는 선택 해제된 스토어 워크플로우(PLAYSTORE·TESTFLIGHT)도 같은 필터로 걸러 질문 범위가 설치 범위와 같다.
-    units.push([type, typeDir, buildTypeRootFilter(type, deployStyle, flutterStore)]);
+    units.push([type, typeDir, buildTypeRootFilter(type, deployStyle, flutterStore, available)]);
     if (deployStyle !== NO_DEPLOY_STYLE) {
-      units.push([type, join(typeDir, "server-deploy"), keepDeploy]);
+      units.push([type, serverDeployDir, keepDeploy]);
     }
   }
 
@@ -79,16 +75,19 @@ export function collectAsks(payloadRoot, types = [], opts = {}) {
       if (!content.includes("@wizard")) continue;
       const workflowName = workflowDisplayName(prompts, filename);
       for (const line of content.split(/\r?\n/)) {
-        const p = parseWizardLine(line); // KEY 정규식 [A-Z_]+ (.sh와 동일)
+        const p = parseWizardLine(line);
         if (!p || p.action !== "ask") continue;
-        // 타입별 기본값: @접두면 resolver 해석, 아니면 리터럴 (.sh _type_default 등가)
+        // 타입별 기본값: @접두면 resolver 해석, 아니면 리터럴
         const rawDefault = p.arg.startsWith("@")
           ? resolveToken(p.arg.slice(1), type, resolvers)
           : p.arg;
         // 리터럴 기본값 안에 __PROJECT_NAME__ 등이 박혀 있으면실제 repoName으로
         // 풀어준다 — substituteEnv()가 설치 파일에 적용하는 것과 동일한 치환이라야 마법사
         // 화면 표시와 실제 설치 결과가 어긋나지 않는다.
-        const typeDefault = replaceProjectTokens(rawDefault, resolveToken("repo", type, resolvers));
+        const savedValue = saved.get(type)?.get(p.key);
+        const typeDefault = savedValue != null && savedValue !== ""
+          ? savedValue
+          : replaceProjectTokens(rawDefault, resolveToken("repo", type, resolvers));
         typeDefaults.set(`${type}|${p.key}`, typeDefault);
         if (!defaults.has(p.key)) { keys.push(p.key); defaults.set(p.key, typeDefault); }
         const list = usages.get(p.key) || [];
@@ -100,7 +99,7 @@ export function collectAsks(payloadRoot, types = [], opts = {}) {
   return { keys, defaults, typeDefaults, usages };
 }
 
-// KEY가 처음 등장한 type (.sh _wf_first_type_for — 라벨 조회 시 타입 오버라이드 우선순위용)
+// KEY가 처음 등장한 type — 라벨 조회 시 타입 오버라이드 우선순위용
 function firstTypeFor(usages, key) {
   return usages.get(key)?.[0]?.type ?? "";
 }
@@ -122,7 +121,7 @@ function buildAnswers(prompts, asks, values, useDefaults) {
   });
 }
 
-// KEY 1개를 'label·사용처·설명·예시·기본값' 카드로 출력 (.sh _wf_print_field_card 등가).
+// KEY 1개를 'label·사용처·설명·예시·기본값' 카드로 출력.
 // info: { default, usages } — idx/tot 있으면 "(i/t)" 진행 표시. log 주입 가능(테스트 무음화).
 export function printFieldCard(prompts, key, info, idx = null, tot = null, log = defaultLog) {
   const t = info.usages?.[0]?.type ?? "";
@@ -146,8 +145,25 @@ function isBooleanDefault(value) {
   return value === "true" || value === "false";
 }
 
-// 지정 KEY들을 하나씩 입력받아 values에 기록 (.sh _wf_prefill_interactive 등가).
-// 빈 입력(Enter)/ESC → KEY 공통 기본값 유지 (.sh safe_read || _in="" 등가).
+// 형식이 정해진 ask 값 검증 — 잘못된 값은 설치는 통과하고 배포 단계에서야 실패하므로 입력 시점에 다시 묻는다.
+// 반환: 오류 문구(문제 없으면 "").
+export function validateAskValue(key, value) {
+  const v = String(value);
+  if (/_PORT$/.test(key)) {
+    const n = Number(v);
+    return /^\d+$/.test(v) && n >= 1 && n <= 65535 ? "" : "1~65535 사이의 숫자로 입력하세요.";
+  }
+  if (key === "SSH_AUTH_METHOD") {
+    return v === "password" || v === "key" ? "" : "password 또는 key 중 하나로 입력하세요.";
+  }
+  if (key === "JAVA_VERSION") {
+    return /^\d+(\.\d+)*$/.test(v) ? "" : "JDK 버전 숫자로 입력하세요 (예: 21, 17).";
+  }
+  return "";
+}
+
+// 지정 KEY들을 하나씩 입력받아 values에 기록.
+// 빈 입력(Enter)/ESC → KEY 공통 기본값 유지.
 async function promptEach(io, prompts, asks, todoKeys, values, log) {
   const tot = todoKeys.length;
   if (tot === 0) return;
@@ -165,8 +181,15 @@ async function promptEach(io, prompts, asks, todoKeys, values, log) {
       const answer = await io.confirm({ message: `↳ ${label} — 활성화할까요?`, initialValue: def === "true" });
       input = answer === CANCEL ? def : (answer ? "true" : "false");
     } else {
-      input = await io.text({ message: `↳ 값 입력 (Enter=기본값 «${def}» 유지):`, defaultValue: def });
-      if (input === CANCEL || input == null || input === "") input = def;
+      for (;;) {
+        input = await io.text({ message: `↳ 값 입력 (Enter=기본값 «${def}» 유지):`, defaultValue: def });
+        if (input === CANCEL || input == null) { input = def; break; }
+        input = String(input).trim();
+        if (input === "") { input = def; break; }
+        const problem = validateAskValue(key, input);
+        if (!problem) break;
+        log(`         ⚠️  '${input}' — ${problem}`);
+      }
     }
     values.set(key, input);
     log(`         → ${label} = ${input}`);
@@ -174,15 +197,15 @@ async function promptEach(io, prompts, asks, todoKeys, values, log) {
   }
 }
 
-// 배포 env 설정 계획 (.sh wf_prompt_env_plan 등가).
+// 배포 env 설정 계획.
 // 반환: { values: Map<key,value>, useDefaults: boolean, answers: [{key,label,value,isDefault,scope}] }
-//  - useDefaults=true  → 호출부는 substituteEnv에 그대로 넘기면 타입별 기본값 경로(.sh _wf_prefill_all 등가)
+//  - useDefaults=true  → 호출부는 substituteEnv에 그대로 넘기면 타입별 기본값 경로
 //  - useDefaults=false → values에 담긴 키만 사용자 확정값으로 치환, 나머지는 기본값
 //    (⚠️ substituteEnv는 useDefaults=false일 때만 values를 참조하므로 이 플래그를 반드시 함께 전달)
 // 인자:
 //   payloadRoot/types/resolvers/flutterStore — collectAsks와 동일 의미
 //   targetRoot — wizard-prompts.yml 1차 탐색 위치(기본 ".")
-//   force      — true면 질문 없이 전부 기본값 (.sh FORCE_MODE 등가)
+//   force      — true면 질문 없이 전부 기본값
 //   io         — {select, multiselect, text} 주입 (기본 readline-engine). 테스트 스텁 지점.
 //   log        — 카드·안내 출력 함수 주입 (기본 stderr)
 export async function promptEnvPlan({
@@ -190,13 +213,14 @@ export async function promptEnvPlan({
   deployStyle = "", flutterStore = null, targetRoot = ".", repoName = "", log = defaultLog,
 } = {}) {
   const prompts = loadWizardPrompts(targetRoot, payloadRoot);
-  const asks = collectAsks(payloadRoot, types, { resolvers, deployStyle, flutterStore, prompts });
+  const saved = readSavedDeployValues(targetRoot);
+  const asks = collectAsks(payloadRoot, types, { resolvers, deployStyle, flutterStore, prompts, saved });
   const defaults = asks.defaults;
 
-  // 수집 키 0개 → 질문 자체가 없음 (.sh `[ ${#WF_ASK_KEYS[@]} -eq 0 ]` 등가)
+  // 수집 키 0개 → 질문 자체가 없음
   if (asks.keys.length === 0) return { values: new Map(), useDefaults: true, answers: [] };
 
-  // 비대화형: force 또는 (io 미주입 && 비TTY) → 전부 기본값 (.sh FORCE_MODE/TTY_AVAILABLE 분기 등가)
+  // 비대화형: force 또는 (io 미주입 && 비TTY) → 전부 기본값
   // io가 주입돼 있으면(테스트/상위 마법사) TTY 여부와 무관하게 대화형으로 진행한다.
   const interactive = !force && (io != null || stdin.isTTY);
   if (!interactive) {
@@ -206,7 +230,7 @@ export async function promptEnvPlan({
 
   const ui = io ?? engine;
 
-  // 기본값 미리보기 카드 전체 출력 (.sh 3237~3251)
+  // 기본값 미리보기 카드 전체 출력
   log("");
   log("▶ 워크플로우 환경설정을 채웁니다");
   log("");
@@ -227,21 +251,21 @@ export async function promptEnvPlan({
       { value: "some", label: "③ 몇 개만 골라서 바꾸기 (고른 것만 입력 · 나머지는 기본값)" },
     ],
   });
-  // ESC/취소 → 전부 기본값 (.sh `if [ "$_rc" -ne 0 ]` 등가)
+  // ESC/취소 → 전부 기본값
   if (choice === CANCEL || choice == null || choice === "all") {
     const values = new Map(defaults);
     return { values, useDefaults: true, answers: buildAnswers(prompts, asks, values, true) };
   }
 
   // 사용자가 확정한 키만 values에 담는다 — substituteEnv(useDefaults:false)가
-  // values에 없는 키는 타입별 기본값으로 채우므로 .sh(_wf_prefill_all 후 덮어쓰기)와 등가.
+  // values에 없는 키는 타입별 기본값으로 채운다(기본값 위에 답한 값만 덮어쓰는 것과 같다).
   const values = new Map();
   if (choice === "each") {
     await promptEach(ui, prompts, asks, asks.keys, values, log);
     return { values, useDefaults: false, answers: buildAnswers(prompts, asks, values, false) };
   }
 
-  // some: 바꿀 항목만 멀티선택 → 고른 것만 입력 (.sh 3266~3277)
+  // some: 바꿀 항목만 멀티선택 → 고른 것만 입력
   const options = asks.keys.map((key) => ({
     value: key,
     label: `${wfField(prompts, firstTypeFor(asks.usages, key), key, "label")}  (기본: ${defaults.get(key)})`,
@@ -251,12 +275,12 @@ export async function promptEnvPlan({
     options,
     initialValues: [],
   });
-  // ESC/빈 선택 → 전부 기본값 (.sh: _wf_prefill_all만 수행)
+  // ESC/빈 선택 → 전부 기본값
   if (selected === CANCEL || !Array.isArray(selected) || selected.length === 0) {
     const values = new Map(defaults);
     return { values, useDefaults: true, answers: buildAnswers(prompts, asks, values, true) };
   }
-  // 수집 키 순서 유지 + WF_ASK_KEYS 멤버만 인정 (.sh _wf_prefill_interactive 필터 등가)
+  // 수집 키 순서 유지 + 수집된 키만 인정
   const todo = asks.keys.filter((k) => selected.includes(k));
   await promptEach(ui, prompts, asks, todo, values, log);
   return { values, useDefaults: false, answers: buildAnswers(prompts, asks, values, false) };

package/src/ui/prompts.js

@@ -1,8 +1,10 @@
-// 대화형 프롬프트 래핑 (.sh interactive_menu/choose_menu/ask_* 등가).
+// 대화형 프롬프트 래핑.
 // node:readline 기반 자체 엔진 사용 (@clack/prompts 는 Windows TTY에서 Enter가 멈추는 버그로 제거).
-// 취소(ESC/Ctrl+C)는 각 함수가 CANCEL 심볼을 반환 → 호출부가 정상 종료(exit 0) 처리.
+// ESC는 각 함수가 CANCEL 심볼을 반환 → 호출부가 기본값/머무르기로 해석한다.
+// Ctrl+C·Ctrl+D는 엔진이 PromptAbortError로 reject → run()이 잡아 종료코드 130으로 끝낸다.
 import * as engine from "./readline-engine.js";
 import { DEPLOY_STYLES, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
+import { TYPE_IDS } from "../core/types.js";
 import { ENV_MODES, DEFAULT_ENV_MODE, STORE_PLATFORMS, DEPLOY_MODES, DEFAULT_DEPLOY_MODE } from "../core/flutter-options.js";
 
 export const CANCEL = engine.CANCEL;
@@ -36,12 +38,17 @@ export async function confirmProjectMenu() {
 
 // 수정 메뉴 항목 — showFlutter=Flutter 타입일 때만 환경변수 방식/스토어 배포 대상/배포 모드 노출.
 // 라벨·순서를 테스트할 수 있도록 순수 함수로 분리했다.
-export function editMenuOptions({ showFlutter = false } = {}) {
+// showOptions=선택 워크플로우 토글(자동 버전 승격·Copilot) 노출 — 저장값이 있으면 처음 질문을 건너뛰므로 여기서 바꾼다.
+export function editMenuOptions({ showFlutter = false, showOptions = false } = {}) {
   const options = [
     { value: "type", label: "프로젝트 타입" },
     { value: "version", label: "버전" },
     { value: "branch", label: "기본 브랜치" },
   ];
+  if (showOptions) {
+    options.push({ value: "semverAuto", label: "자동 버전 승격" });
+    options.push({ value: "copilotAi", label: "Copilot AI 요약" });
+  }
   if (showFlutter) {
     options.push({ value: "envMode", label: "환경변수 방식" });
     options.push({ value: "flutterStore", label: "스토어 배포 대상" });
@@ -52,11 +59,12 @@ export function editMenuOptions({ showFlutter = false } = {}) {
 }
 
 // 수정 메뉴 — 어떤 항목을 고칠지.
-export async function editMenu({ showFlutter = false } = {}) {
-  return engine.select({ message: "어떤 항목을 수정할까요?", options: editMenuOptions({ showFlutter }) });
+export async function editMenu({ showFlutter = false, showOptions = false } = {}) {
+  return engine.select({ message: "어떤 항목을 수정할까요?", options: editMenuOptions({ showFlutter, showOptions }) });
 }
 
-const ALL_TYPES = ["spring", "flutter", "next", "react", "react-native", "react-native-expo", "node", "python", "basic", "go"];
+// 대화형 타입 선택지 — CLI 검증 목록(VALID_TYPES)과 같은 레지스트리에서 만든다.
+export const ALL_TYPES = TYPE_IDS;
 
 // 타입 멀티선택.
 export async function selectTypes(current = []) {
@@ -93,20 +101,22 @@ export async function confirmTypes({ types = [], markers = null } = {}) {
 // 배포 방식 선택. 서버 배포 CD 워크플로우는 서로 대체재라 하나만 쓴다.
 // 고른 것만 설치하고 push 트리거까지 켜준다 — 종전에는 넷을 다 깔고 SIMPLE만 켜져 있어,
 // 무중단을 원한 사람은 설치 후 YAML을 직접 고쳐야 했다.
-// "서버 배포 안 함"은 server-deploy 폴더 자체(PR 프리뷰 포함)를 제외한다 — 서버 배포를
+// "서버 배포 안 함"은 모든 타입에서 서버 배포 워크플로우(CD·PR 프리뷰)를 제외한다 — 서버 배포를
 // 하지 않는 프로젝트(프론트엔드 전용, 라이브러리 등)를 위한 선택지다.
-export async function selectDeployStyle() {
+// nonstop=false면(선택한 타입 어디에도 무중단 워크플로우가 없음) 고를 수 없는 무중단 선택지를 빼고 묻는다.
+export async function selectDeployStyle({ nonstop = true } = {}) {
   engine.note(
     "서버 배포 워크플로우는 서로 대체재입니다 (Nginx와 Traefik을 동시에 쓰지 않습니다).\n" +
-    "고른 방식만 설치하고 자동 실행(push 트리거)까지 켭니다. PR 프리뷰는 선택과 무관하게 함께 설치됩니다\n" +
-    "(단, server-deploy 폴더가 있는 타입(spring)은 \"서버 배포 안 함\"을 고르면 PR 프리뷰도 함께 제외됩니다).",
+    "고른 방식만 설치하고 자동 실행(push 트리거)까지 켭니다. PR 프리뷰는 배포 방식과 함께 설치되고,\n" +
+    "\"서버 배포 안 함\"을 고르면 모든 타입에서 CD와 PR 프리뷰를 함께 제외합니다.\n" +
+    "무중단 배포는 spring에만 있습니다 — 다른 타입(python·go·react·next)은 단일 서버 배포로 설치됩니다.",
     "배포 방식",
   );
   return engine.select({
     message: "서버 배포는 어떤 방식으로 할까요?",
     options: [
-      ...DEPLOY_STYLES.map((s) => ({ value: s.value, label: s.label })),
-      { value: NO_DEPLOY_STYLE, label: "서버 배포 안 함 — CD 워크플로우/배포 설정을 생성하지 않음" },
+      ...DEPLOY_STYLES.filter((s) => nonstop || s.value === "simple").map((s) => ({ value: s.value, label: s.label })),
+      { value: NO_DEPLOY_STYLE, label: "서버 배포 안 함 — CD·PR 프리뷰 워크플로우와 배포 설정을 생성하지 않음" },
     ],
   });
 }

package/src/ui/readline-engine.js

@@ -1,14 +1,40 @@
 // node:readline 기반 대화형 프롬프트 엔진 (@clack/prompts 대체).
 // WHY: @clack/prompts 1.7.0 이 Windows TTY 콘솔에서 Enter(return) 키를 처리하지 못하고
-//   멈추는 버그가 있다(실측 확정). node:readline 의 keypress 이벤트는 Windows에서 정상 동작한다.
-//   .sh/.ps1 이 자체 메뉴를 구현한 것과 동일한 접근. 외부 의존성 0 → 내부망에서도 안전.
+//   멈추는 버그가 있다. node:readline 의 keypress 이벤트는 Windows에서 정상 동작한다.
+//   메뉴를 직접 구현하면 외부 의존성 0 → 내부망에서도 안전.
 //
-// 계약: 취소(ESC/Ctrl+C)는 CANCEL 심볼 반환. 각 함수 async.
+// 계약: ESC는 CANCEL 심볼 반환(호출부가 "기본값/머무르기"로 해석). 각 함수 async.
+//       Ctrl+C·Ctrl+D·stdin 종료는 중단 — PromptAbortError로 reject해 어느 질문에서든 즉시 빠져나간다.
 import { emitKeypressEvents } from "node:readline";
 import { stdin, stdout } from "node:process";
+import { visualWidth } from "./ansi.js";
 
 export const CANCEL = Symbol("cancel");
 
+// 사용자 중단(Ctrl+C 등). ESC와 달리 기본값으로 진행하면 안 되므로 반환값이 아니라 예외로 전파한다 —
+// 호출부마다 CANCEL 해석이 달라 일부는 기본값으로 설치를 강행하거나 같은 화면을 무한히 다시 그렸다.
+// signal: 외부 신호로 중단된 경우 그 신호명("SIGINT"·"SIGTERM") — 종료 코드를 셸 관례(128+번호)에 맞춘다.
+export class PromptAbortError extends Error {
+  constructor(signal = null) {
+    super("사용자가 중단했습니다.");
+    this.name = "PromptAbortError";
+    this.signal = signal;
+  }
+}
+export const isPromptAbort = (e) => e instanceof PromptAbortError;
+
+// raw mode에서는 Ctrl+C가 SIGINT가 아니라 keypress로 들어온다. Ctrl+D도 raw mode에선 EOF가 아니다.
+const isAbortKey = (key) => key.ctrl && (key.name === "c" || key.name === "d");
+
+// 외부 신호(kill -INT·kill -TERM)는 keypress가 아니라 프로세스 신호로 온다. 리스너가 없으면 Node가 곧바로
+// 종료해 커서 숨김과 raw mode가 복구되지 않는다 — 입력 대기 중에는 키보드 Ctrl+C와 같은 중단 경로로 돌린다.
+const TERM_SIGNALS = ["SIGINT", "SIGTERM"];
+function onTermSignal(fn) {
+  const handlers = TERM_SIGNALS.map((sig) => [sig, () => fn(sig)]);
+  for (const [sig, h] of handlers) process.on(sig, h);
+  return () => { for (const [sig, h] of handlers) process.removeListener(sig, h); };
+}
+
 // ── ANSI 헬퍼 (picocolors 대체 — 의존성 0) ───────────────────────────
 const ESC = "\x1b[";
 const c = {
@@ -17,10 +43,27 @@ const c = {
 };
 // NO_COLOR(https://no-color.org)/비TTY 가드 — ansi.js와 동일한 규칙(존재 여부만 체크, 값 무관)이지만
 // 의존성 0 유지를 위해 자체 구현.
-const colorEnabled = () => process.env.NO_COLOR === undefined && !!stdout.isTTY;
+// TERM=dumb은 색상뿐 아니라 커서 이동·지우기 시퀀스도 해석하지 못한다 — 그때는 다시 그리지 않고 이어서 출력한다.
+const isDumb = () => process.env.TERM === "dumb";
+const colorEnabled = () => process.env.NO_COLOR === undefined && !!stdout.isTTY && !isDumb();
 const paint = (s, color, enabled = colorEnabled()) => (enabled ? `${color}${s}${c.reset}` : String(s));
-const hideCursor = () => stdout.write(`${ESC}?25l`);
-const showCursor = () => stdout.write(`${ESC}?25h`);
+// 커서를 숨긴 채 프로세스가 끝나면(예외·process.exit 등) 터미널 커서가 사라진 채로 남는다 — 종료 시점에 한 번 더 복구한다.
+let cursorHidden = false;
+let exitGuard = false;
+const hideCursor = () => {
+  if (isDumb()) return;
+  stdout.write(`${ESC}?25l`);
+  cursorHidden = true;
+  if (!exitGuard) {
+    exitGuard = true;
+    process.once("exit", () => { if (cursorHidden) stdout.write(`${ESC}?25h`); });
+  }
+};
+const showCursor = () => {
+  if (isDumb()) return;
+  stdout.write(`${ESC}?25h`);
+  cursorHidden = false;
+};
 
 // 심볼 (clack 톤 유지)
 const S_ACTIVE = paint("●", c.green);
@@ -31,16 +74,24 @@ const S_BAR = paint("│", c.gray);
 const S_Q = paint("◆", c.cyan);
 const S_DONE = paint("◇", c.green);
 
+// 한 줄이 터미널에서 실제로 차지하는 행 수 — 폭을 넘는 줄은 터미널이 접어서 여러 행이 된다.
+// 논리 줄 수만큼만 올라가면 접힌 윗부분이 지워지지 않고 화면에 사본이 쌓인다.
+export function physicalRows(line, columns = stdout.columns) {
+  if (!columns) return 1;
+  return Math.max(1, Math.ceil(visualWidth(line) / columns));
+}
+
 // 여러 줄 지운 뒤 커서를 블록 시작으로 되돌리는 렌더러.
-// prevLines 만큼 위로 올라가 지우고 새로 그린다.
+// 직전에 그린 물리 행 수만큼 위로 올라가 지우고 새로 그린다.
 function makeRenderer() {
   let prevLines = 0;
   return {
     render(lines) {
+      if (isDumb()) { stdout.write(lines.join("\n") + "\n"); return; }
       if (prevLines > 0) stdout.write(`${ESC}${prevLines}A`); // 위로
       stdout.write(`${ESC}0J`); // 커서 아래 전부 지우기
       stdout.write(lines.join("\n") + "\n");
-      prevLines = lines.length;
+      prevLines = lines.reduce((n, l) => n + physicalRows(l), 0);
     },
     reset() { prevLines = 0; },
   };
@@ -49,7 +100,7 @@ function makeRenderer() {
 // raw keypress 세션 공통 래퍼. onKey(str,key) → true 반환 시 종료.
 // 반환값은 finalize()가 만든다. 취소 시 CANCEL.
 function keySession(renderFn, onKey) {
-  return new Promise((resolve) => {
+  return new Promise((resolve, reject) => {
     const wasRaw = stdin.isTTY ? stdin.isRaw : false;
     emitKeypressEvents(stdin);
     if (stdin.isTTY) stdin.setRawMode(true);
@@ -59,21 +110,33 @@ function keySession(renderFn, onKey) {
     const cleanup = () => {
       stdin.removeListener("keypress", handler);
       stdin.removeListener("end", onEnd);
+      offSignal();
       if (stdin.isTTY) stdin.setRawMode(wasRaw);
       stdin.pause();
       showCursor();
     };
+    const offSignal = onTermSignal((sig) => {
+      cleanup();
+      stdout.write("\n");
+      reject(new PromptAbortError(sig));
+    });
 
-    // stdin 종료(EOF/Ctrl+D, SSH 연결 끊김 등) — 취소(ESC/Ctrl+C)와 동일하게 처리해 무한 대기를 방지한다.
+    // stdin 종료(EOF, SSH 연결 끊김 등) — 더 이상 입력이 올 수 없으므로 중단한다.
+    // CANCEL로 돌려주면 "머무르기"로 해석하는 화면에서 다시 묻다가 영원히 대기한다.
     const onEnd = () => {
       cleanup();
-      resolve(CANCEL);
+      reject(new PromptAbortError());
     };
 
     const handler = (str, key) => {
       key = key || {};
-      // 취소: Ctrl+C / Ctrl+D / ESC (raw mode에서는 Ctrl+D가 stdin "end"가 아니라 일반 keypress로 들어온다)
-      if ((key.ctrl && (key.name === "c" || key.name === "d")) || key.name === "escape") {
+      if (isAbortKey(key)) {
+        cleanup();
+        stdout.write("\n");
+        reject(new PromptAbortError());
+        return;
+      }
+      if (key.name === "escape") {
         cleanup();
         resolve(CANCEL);
         return;
@@ -190,45 +253,69 @@ export async function multiselect({ message, options, initialValues = [], requir
 // 반환: 입력 문자열(빈 입력 시 defaultValue) 또는 CANCEL.
 export async function text({ message, defaultValue = "" }) {
   if (!stdin.isTTY) return defaultValue;
-  return new Promise((resolve) => {
+  return new Promise((resolve, reject) => {
     const wasRaw = stdin.isTTY ? stdin.isRaw : false;
     emitKeypressEvents(stdin);
     if (stdin.isTTY) stdin.setRawMode(true);
     stdin.resume();
     let buf = "";
 
+    // dumb 터미널은 줄을 지울 수 없으므로 프롬프트는 한 번만 쓰고 입력 글자만 이어서 출력한다.
+    const dumb = isDumb();
+    let prevRows = 0; // 직전 프롬프트가 차지한 물리 행 수 — 긴 프롬프트는 여러 행으로 접힌다
     const prompt = () => {
-      stdout.write(`\r${ESC}0K`); // 줄 초기화
+      if (dumb) {
+        stdout.write(`${S_Q}  ${message} ${defaultValue ? `[${defaultValue}] ` : ""}`);
+        return;
+      }
+      // 커서는 접힌 마지막 행에 있으므로 첫 행까지 올라간 뒤 아래를 전부 지운다
+      stdout.write(prevRows > 1 ? `\r${ESC}${prevRows - 1}A${ESC}0J` : `\r${ESC}0J`);
       const shown = buf.length ? buf : paint(defaultValue || "", c.dim);
-      stdout.write(`${S_Q}  ${paint(message, c.bold)} ${shown}`);
+      const line = `${S_Q}  ${paint(message, c.bold)} ${shown}`;
+      stdout.write(line);
+      prevRows = physicalRows(line);
     };
 
     const cleanup = () => {
       stdin.removeListener("keypress", handler);
       stdin.removeListener("end", onEnd);
+      offSignal();
       if (stdin.isTTY) stdin.setRawMode(wasRaw);
       stdin.pause();
       stdout.write("\n");
     };
+    const offSignal = onTermSignal((sig) => {
+      cleanup();
+      reject(new PromptAbortError(sig));
+    });
 
-    // stdin 종료(EOF/Ctrl+D) — 취소와 동일하게 처리해 무한 대기를 방지한다.
+    // stdin 종료(EOF) — 더 이상 입력이 올 수 없으므로 중단한다.
     const onEnd = () => {
       cleanup();
-      resolve(CANCEL);
+      reject(new PromptAbortError());
     };
 
     const handler = (str, key) => {
       key = key || {};
-      // 취소: Ctrl+C / Ctrl+D / ESC (raw mode에서는 Ctrl+D가 stdin "end"가 아니라 일반 keypress로 들어온다)
-      if ((key.ctrl && (key.name === "c" || key.name === "d")) || key.name === "escape") { cleanup(); resolve(CANCEL); return; }
+      if (isAbortKey(key)) { cleanup(); reject(new PromptAbortError()); return; }
+      if (key.name === "escape") { cleanup(); resolve(CANCEL); return; }
       if (key.name === "return" || key.name === "enter") {
         cleanup();
         resolve(buf.length ? buf : defaultValue);
         return;
       }
-      if (key.name === "backspace") { buf = buf.slice(0, -1); prompt(); return; }
+      if (key.name === "backspace") {
+        if (dumb && buf.length) stdout.write("\b \b");
+        buf = buf.slice(0, -1);
+        if (!dumb) prompt();
+        return;
+      }
       // 일반 문자 (제어문자 제외)
-      if (str && !key.ctrl && !key.meta && str.length === 1 && str >= " ") { buf += str; prompt(); return; }
+      if (str && !key.ctrl && !key.meta && str.length === 1 && str >= " ") {
+        buf += str;
+        if (dumb) stdout.write(str); else prompt();
+        return;
+      }
     };
     stdin.on("keypress", handler);
     stdin.on("end", onEnd);

package/src/ui/status-cards.js

@@ -1,6 +1,5 @@
 // 첫 화면 상태 표시 층 — 감지 로그 · 분석 카드 · 신규/업데이트 판별
-// (Breaking Changes 박스는 core/breaking-check.js가 담당.
-//  원본의 IDE Skills 상태는 project-auto-wizard 스코프 제외 — Agent Skills 미포함)
+// (Breaking Changes 박스는 core/breaking-check.js가 담당)
 import { A, paint } from "./ansi.js";
 import { DEFAULT_DEPLOY_MODE } from "../core/flutter-options.js";
 
@@ -8,7 +7,7 @@ const GUT = paint("│", A.gray);
 const HEAD = paint("◆", A.cyan);
 const OK = paint("✓", A.green);
 
-// 감지 로그 (.ps1 감지 진행 표시 등가)
+// 감지 로그 — 무엇을 근거로 어떤 타입을 감지했는지
 // markers: Map<type, 실제 발견 파일>.
 // warnings: 감지 도중 나온 경고. 감지 함수를 먼저 호출한 뒤 박스를 그리는 구조라 경고가
 //           박스 위로 새어나가 앞선 질문에 대한 경고처럼 보였다 — 박스 안에서 출력한다.
@@ -28,10 +27,10 @@ export function printDetectionLog({ types = [], version = "", branch = "", marke
   out(`${GUT}\n`);
 }
 
-// 프로젝트 분석 개요 카드 (.ps1 Print-ProjectAnalysis 등가+)
+// 프로젝트 분석 개요 카드
 export function printAnalysisCard({ mode = "", modeLabel = "", types = [], version = "", branch = "",
   paths = new Map(), showOptional = false,
-  flutter = null, envModeDefault = "" },
+  flutter = null, envModeDefault = "", options = null },
   out = (s) => process.stderr.write(s)) {
   out(`${HEAD}  ${paint("프로젝트 분석 결과", A.bold)}\n`);
   const row = (icon, label, value) => out(`${GUT}  ${icon} ${label.padEnd(10)} ${value}\n`);
@@ -51,6 +50,12 @@ export function printAnalysisCard({ mode = "", modeLabel = "", types = [], versi
       row("🚀", "배포모드", modeParts.length ? modeParts.join(" ") : "없음");
     }
   }
+  // 선택 워크플로우 — 저장값이 있으면 질문 없이 쓰이므로 확정 전에 현재값을 보여준다.
+  if (options) {
+    const onOff = (v) => (v ? paint("켜짐", A.green) : paint("꺼짐", A.dim));
+    row("🔢", "자동승격", onOff(options.semverAuto));
+    row("🤖", "Copilot", onOff(options.copilotAi));
+  }
   // 모노레포 경로 — 루트가 아닌 항목이 하나라도 있으면 표시
   const nonRoot = [...paths.entries()].filter(([, p]) => p && p !== ".");
   if (nonRoot.length) {