project-auto-wizard 0.9.1 → 0.11.0

package/src/core/version-yml.js

@@ -1,5 +1,8 @@
 import { DEFAULT_DEPLOY_STYLE } from "./deploy-style.js";
 import { escapeYamlDoubleQuoted } from "./wizard-env.js";
+import {
+  ENV_MODES, DEPLOY_MODES, DEFAULT_ENV_MODE, DEFAULT_DEPLOY_MODE, STORE_PLATFORMS, formatStoreList,
+} from "./flutter-options.js";
 
 // version.yml 파싱·생성 (.sh create_version_yml 등가, 전체 재생성 전략 D4).
 // ⚠️ YAML 재직렬화 금지 — 주석이 데이터.
@@ -34,12 +37,22 @@ export function parseExtraTopLevel(content) {
   return blocks;
 }
 
+// Flutter 옵션 키(이슈 #131) → 반환 필드. 값은 원문 문자열로 돌려주고, 유효성 판정은 resolveFlutterOptions 몫이다.
+const FLUTTER_OPTION_KEYS = {
+  env_mode: "envMode", flutter_store: "flutterStore",
+  android_deploy_mode: "androidDeployMode", ios_deploy_mode: "iosDeployMode",
+};
+
 // metadata.template.options 상태머신 파싱 (.sh read_template_options L2361~2416 등가).
-// 반환: { nexus: bool|null, secretBackup: bool|null } — null=미기재.
+// 반환: { nexus: bool|null, secretBackup: bool|null, semverAuto: bool|null, deployStyle: string|null,
+//         envMode/flutterStore/androidDeployMode/iosDeployMode: string|null } — null=미기재.
 // 구 synology·coderabbit 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다(파싱 에러 없음).
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
-  const out = { nexus: null, secretBackup: null, semverAuto: null, deployStyle: null };
+  const out = {
+    nexus: null, secretBackup: null, semverAuto: null, deployStyle: null,
+    envMode: null, flutterStore: null, androidDeployMode: null, iosDeployMode: null,
+  };
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
   // 인라인 주석(` # ...`)을 먼저 떼고 따옴표·공백을 정리한다. 문자열 값을 받는 키(deploy_style)는
   // 주석을 안 떼면 "simple # simple | nginx ..." 가 통째로 값이 된다.
@@ -66,6 +79,8 @@ export function parseTemplateOptions(content) {
       }
       m = line.match(/^\s+deploy_style:\s*(.+)/);
       if (m) { const v = strip(m[1]); if (v) out.deployStyle = v; continue; }
+      m = line.match(/^\s+(env_mode|flutter_store|android_deploy_mode|ios_deploy_mode):\s*(.+)/);
+      if (m) { const v = strip(m[2]); if (v) out[FLUTTER_OPTION_KEYS[m[1]]] = v; continue; }
       m = line.match(/^\s+semver_auto:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -156,10 +171,24 @@ export function parseTemplateBranches(content) {
   return out.main && out.develop && out.mode ? out : null;
 }
 
+// Flutter 옵션 블록 (전체 줄 토큰 {{FLUTTER_OPTIONS}} — Flutter 타입일 때만). options 아래 6칸 들여쓰기.
+// 값이 비었으면 워크플로우 템플릿의 기본값과 같은 값으로 채운다 — 저장값과 실제 설치 내용이 어긋나지 않게.
+// stores가 null(미결정)이면 현행 동작대로 둘 다 설치되므로 "android,ios"로 기록한다.
+function buildFlutterOptionsBlock({ envMode, stores, androidDeployMode, iosDeployMode } = {}) {
+  const quote = (v) => `"${escapeYamlDoubleQuoted(v)}"`;
+  return [
+    `      env_mode: ${quote(envMode || DEFAULT_ENV_MODE)} # ${ENV_MODES.join(" | ")} (Flutter 환경변수 주입 방식)`,
+    `      flutter_store: ${quote(formatStoreList(stores ?? STORE_PLATFORMS))} # android | ios | android,ios | none (스토어 배포 대상)`,
+    `      android_deploy_mode: ${quote(androidDeployMode || DEFAULT_DEPLOY_MODE)} # ${DEPLOY_MODES.join(" | ")} (Play Store 배포 모드)`,
+    `      ios_deploy_mode: ${quote(iosDeployMode || DEFAULT_DEPLOY_MODE)} # ${DEPLOY_MODES.join(" | ")} (iOS 배포 모드)`,
+  ].join("\n");
+}
+
 // version.yml 전체 생성 — payload/version.yml.template 렌더링.
 // opts: { templateText, version, types:[], paths:Map, pathMarkers?:Map,
 //         branch, branches?, versionCode, now, today, templateOptions?, deployValues?,
-//         extraTopLevel?:string[] }  ← 기존 version.yml의 알려지지 않은 최상위 필드 보존 (issue #20 M8)
+//         extraTopLevel?:string[],  ← 기존 version.yml의 알려지지 않은 최상위 필드 보존 (issue #20 M8)
+//         flutterOptions?:{ envMode, stores, androidDeployMode, iosDeployMode } }  ← Flutter 타입일 때만 렌더 (이슈 #131)
 //   templateText = payload/version.yml.template 원문 (readVersionYmlTemplate — 필수)
 //   now   = "YYYY-MM-DD HH:MM:SS" (UTC) — 결정성 위해 주입 / today = "YYYY-MM-DD"
 //   branches = { main, develop, mode } (resolveBranchConfig 결과. 없으면 branch 기반 기본값)
@@ -168,7 +197,7 @@ export function parseTemplateBranches(content) {
 export function buildVersionYml({
   templateText, version, types = [], paths = new Map(), pathMarkers = new Map(),
   branch = "main", branches = null, versionCode = 1, now, today,
-  templateOptions = null, deployValues = new Map(), extraTopLevel = [],
+  templateOptions = null, deployValues = new Map(), extraTopLevel = [], flutterOptions = {},
 }) {
   if (!templateText) throw new Error("version.yml.template 원문이 필요합니다 (payload/version.yml.template 누락?)");
   const typesJson = types.length ? `[${types.map((t) => `"${t}"`).join(", ")}]` : `["basic"]`;
@@ -204,6 +233,9 @@ export function buildVersionYml({
     deployBlock = rows.join("\n");
   }
 
+  // Flutter 옵션 블록 (full-line 토큰 {{FLUTTER_OPTIONS}} — Flutter 타입일 때만, 아니면 줄 제거)
+  const flutterBlock = types.includes("flutter") ? buildFlutterOptionsBlock(flutterOptions) : "";
+
   const scalars = {
     VERSION: version, VERSION_CODE: String(versionCode),
     PROJECT_TYPES: typesJson,
@@ -219,6 +251,7 @@ export function buildVersionYml({
   for (const line of String(templateText).split("\n")) {
     const t = line.trim();
     if (t === "{{PROJECT_PATHS}}") { if (pathsBlock) out.push(pathsBlock); continue; }
+    if (t === "{{FLUTTER_OPTIONS}}") { if (flutterBlock) out.push(flutterBlock); continue; }
     if (t === "{{DEPLOY}}") { if (deployBlock) out.push(deployBlock); continue; }
     out.push(line.replace(/\{\{([A-Z][A-Z0-9_]*)\}\}/g, (_, name) => {
       if (name in scalars) return scalars[name];
@@ -240,10 +273,12 @@ export function buildVersionYml({
 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,
-    includeNexus = false, includeSecretBackup = false, includeSemverAuto, deployStyle } = context;
+    includeNexus = false, includeSecretBackup = false, includeSemverAuto, deployStyle,
+    envMode, flutterStore, androidDeployMode, iosDeployMode } = context;
   return buildVersionYml({
     templateText, version, types, paths, pathMarkers, branch, branches, versionCode, now, today,
     deployValues, extraTopLevel,
+    flutterOptions: { envMode, stores: flutterStore, androidDeployMode, iosDeployMode },
     templateOptions: {
       templateVersion, includeNexus, includeSecretBackup,
       includeSemverAuto: includeSemverAuto !== false,

package/src/core/wizard-env.js

@@ -2,12 +2,13 @@
 // ⚠️ YAML 파싱/재직렬화 금지 — 라인 단위 문자열 처리 (포맷·주석 보존이 unchanged 판정 전제).
 // 실측 기준: template_integrator.sh 3282~3360, 3003~3012.
 
-// KEY 정규식: .sh는 [A-Z_]+ (대문자+언더스코어만). ask/auto 마커가 있는 라인만 대상.
-const MARKER_RE = /#\s*@wizard\s+(ask|auto):(.*)$/;
+// KEY 정규식: .sh는 [A-Z_]+ (대문자+언더스코어만). ask/auto/fallback 마커가 있는 라인만 대상.
+// fallback(이슈 #131)은 `KEY: ${{ 런타임값 || 'literal' }}` 표현식 안의 기본 리터럴을 교체하는 마커다.
+const MARKER_RE = /#\s*@wizard\s+(ask|auto|fallback):(.*)$/;
 const KEY_RE = /^(\s*)([A-Z_]+):/;
 const PATHS_ANCHOR_RE = /#\s*@wizard\s+paths-anchor/;
 
-// 한 라인을 파싱해 {indent,key,action,arg} 반환. ask/auto 마커 없으면 null.
+// 한 라인을 파싱해 {indent,key,action,arg} 반환. ask/auto/fallback 마커 없으면 null.
 export function parseWizardLine(line) {
   const marker = line.match(MARKER_RE);
   if (!marker) return null;
@@ -45,8 +46,24 @@ export function setEnvLine(line, key, value) {
   return out + cr;
 }
 
+// `KEY: ${{ a || b || 'literal' }}  # @wizard fallback:<token>` — 표현식 안의 "마지막 홑따옴표 리터럴"만 교체하고
+// 마커 주석을 제거한다. setEnvLine은 `KEY: "값"` 형태의 따옴표 값만 다루므로 GitHub 표현식은 처리하지 못한다.
+// 리터럴은 `||` 체인의 맨 끝(런타임 입력·저장소 변수가 모두 비었을 때의 기본값)이라 런타임 우선순위는 바뀌지 않는다.
+// value가 빈 문자열이면 줄을 그대로 둔다 (setEnvLine과 같은 규약 — 템플릿 기본값이 남는다).
+const WIZARD_COMMENT_RE = /[^\S\r\n]*#[^\S\r\n]*@wizard[^\S\r\n].*$/;
+const LAST_LITERAL_RE = /^(.*)'[^']*'([^']*)$/;
+export function setFallbackLine(line, value) {
+  if (value === "" || value == null) return line;
+  const cr = line.endsWith("\r") ? "\r" : "";
+  const expression = (cr ? line.slice(0, -1) : line).replace(WIZARD_COMMENT_RE, "");
+  if (!LAST_LITERAL_RE.test(expression)) return line;
+  const escaped = String(value).replaceAll("'", "''"); // GitHub 표현식 문자열 리터럴의 따옴표 이스케이프
+  return expression.replace(LAST_LITERAL_RE, (_m, head, tail) => `${head}'${escaped}'${tail}`) + cr;
+}
+
 // resolver — .sh resolve_token 등가. 값 계산은 주입된 resolvers로 위임(순수성 유지).
-// resolvers: { repo, "spring-app-yml-dir"(type), "spring-app-yml-path"(type), "flutter-root" }
+// resolvers: { repo, "spring-app-yml-dir"(type), "spring-app-yml-path"(type), "flutter-root",
+//              "project-path"(type), "flutter-env-mode", "android-deploy-mode", "ios-deploy-mode" }
 export function resolveToken(name, type, resolvers = {}) {
   const fn = resolvers[name];
   return typeof fn === "function" ? (fn(type) ?? "") : "";
@@ -80,6 +97,11 @@ export function substituteEnv(content, opts = {}) {
   for (let i = 0; i < lines.length; i++) {
     const p = parseWizardLine(lines[i]); // 이미 \r 제거된 라인
     if (!p) continue;
+    // fallback은 따옴표 값이 아니라 표현식 안 리터럴을 바꾸므로 ask/auto와 경로가 다르다.
+    if (p.action === "fallback") {
+      lines[i] = setFallbackLine(lines[i], resolveToken(p.arg, type, resolvers));
+      continue;
+    }
     let val = "";
     if (p.action === "auto") {
       val = resolveToken(p.arg, type, resolvers);

package/src/index.js

@@ -9,6 +9,7 @@ import { parseArgs, parsePathsCsv, CliError } from "./cli/args.js";
 import { HELP_TEXT } from "./cli/help.js";
 import { createContext } from "./context.js";
 import { DEFAULT_DEPLOY_STYLE, isDeployStyle } from "./core/deploy-style.js";
+import { resolveFlutterOptions } from "./core/flutter-options.js";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "./core/assets.js";
 import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber, detectMarkers } from "./core/detect-fs.js";
 import { parseExisting } from "./core/version-yml.js";
@@ -268,6 +269,16 @@ async function runInner(argv, {
     }
   }
 
+  // Flutter 옵션 — CLI 플래그 → version.yml 저장값 → 기본값(신규 dart-define, 기존 설치 dotenv 보존).
+  // Flutter 타입이 없는 프로젝트에서는 렌더·치환 단계가 전부 무시한다.
+  const flutterOptions = resolveFlutterOptions({
+    cli: {
+      envMode: opts.flutterEnvMode, stores: opts.flutterStore,
+      androidDeployMode: opts.androidDeployMode, iosDeployMode: opts.iosDeployMode,
+    },
+    existing,
+  });
+
   const context = createContext({
     mode: opts.mode, force: opts.force, types, version, versionCode, branch,
     branches,
@@ -281,13 +292,17 @@ async function runInner(argv, {
     includeSemverAuto: opts.includeSemverAuto ?? existing?.options?.semverAuto ?? (existing ? false : true),
     repoName,
     // 실 resolver 4종 (.sh resolve_token 등가)
-    resolvers: makeResolvers(cwd, repoName, paths),
+    resolvers: makeResolvers(cwd, repoName, paths, flutterOptions),
     now, today,
     // 설치 로그(#79)용 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     markers: detectMarkers(cwd, types), detectWarnings,
     deployStyle: opts.deployStyle
       || (isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : DEFAULT_DEPLOY_STYLE),
     previousTemplateVersion: existing?.templateVersion || "",
+    envMode: flutterOptions.envMode,
+    flutterStore: flutterOptions.stores,
+    androidDeployMode: flutterOptions.androidDeployMode,
+    iosDeployMode: flutterOptions.iosDeployMode,
   });
 
   context.templateVersion = readTemplateVersion();
@@ -319,7 +334,23 @@ async function runInner(argv, {
     logPath: currentLogPath(),
     legacyMdLogs: hasLegacyMdLogs(cwd),
     cleanup: result?.cleanup ?? null,
+    storeCleanup: result?.storeCleanup ?? null,
+    flutterApp: result?.flutterApp ?? null,
   });
+  // store_submit 배포 모드는 main push마다 심사를 자동 제출한다 — 비대화형에서도 같은 경고를 보여준다
+  // (대화형 경로는 ui/prompts.js#deployModeWarning을 선택 시점에 note로 보여준다).
+  // Flutter 타입이 아니거나 해당 스토어를 선택하지 않은 프로젝트에는 뜨면 안 된다 (fable5.1 Important #2).
+  const { stores } = flutterOptions;
+  const warnings = [];
+  if (types.includes("flutter") && (stores === null || stores.includes("android"))) {
+    warnings.push(prompts.deployModeWarning(flutterOptions.androidDeployMode));
+  }
+  if (types.includes("flutter") && (stores === null || stores.includes("ios"))) {
+    warnings.push(prompts.deployModeWarning(flutterOptions.iosDeployMode));
+  }
+  for (const w of warnings) {
+    if (w) console.error(`⚠️  ${w}`);
+  }
   return 0;
 }
 

package/src/ui/env-plan.js

@@ -11,6 +11,7 @@ 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 * as engine from "./readline-engine.js";
 
 const CANCEL = engine.CANCEL;
@@ -35,11 +36,12 @@ export function scopeString(usages = []) {
 // opts:
 //   resolvers    - @접두 기본값(@repo 등) 해석용 (.sh는 수집 시점에 resolve_token — 동일)
 //   includeNexus - true면 server-deploy 제외 + nexus/ 포함 (복사 엔진과 스캔 범위 일치)
+//   flutterStore - Flutter 스토어 대상(string[]|null). 배열이면 선택 해제된 스토어 워크플로우는 스캔에서 제외 (null=현행)
 //   prompts      - wizard-labels 파싱 객체 (워크플로우 표시명용, null이면 확장자 제거 폴백)
 // 반환: { keys:[], defaults:Map<key,default>, typeDefaults:Map<"type|key",default>,
 //        usages:Map<key,[{type,workflowName}]> }
 export function collectAsks(payloadRoot, types = [], opts = {}) {
-  const { resolvers = {}, includeNexus = false, includeSecretBackup = false, deployStyle = "", prompts = null } = opts;
+  const { resolvers = {}, includeNexus = false, includeSecretBackup = false, deployStyle = "", flutterStore = null, prompts = null } = opts;
   // 설치하지 않을 배포 워크플로우의 질문까지 묻지 않는다 — 질문 수는 설치 범위를 따라간다.
   const keepDeploy = deployFilter(deployStyle);
   const baseDir = join(payloadRoot, PAYLOAD.workflowsDir);
@@ -65,7 +67,8 @@ export function collectAsks(payloadRoot, types = [], opts = {}) {
     // 타입 루트 스캔에도 keepDeploy를 걸어야 CD 전용 ask 키(예: DEPLOY_PORT)가 걸러진다.
     // PR 프리뷰 자체의 ask 키(SSH_AUTH_METHOD 등)는 이 필터로는 걸러지지 않는다 — PR 프리뷰는
     // 배포 방식과 무관하게 항상 설치되는 별도 축이라 의도된 잔여 범위다.
-    units.push([type, typeDir, deployStyle === NO_DEPLOY_STYLE ? keepDeploy : null]);
+    // Flutter는 선택 해제된 스토어 워크플로우(PLAYSTORE·TESTFLIGHT)도 같은 필터로 걸러 질문 범위가 설치 범위와 같다.
+    units.push([type, typeDir, buildTypeRootFilter(type, deployStyle, flutterStore)]);
     if (includeNexus) {
       units.push([type, join(typeDir, "nexus"), null]);
     } else if (deployStyle !== NO_DEPLOY_STYLE) {
@@ -183,17 +186,17 @@ async function promptEach(io, prompts, asks, todoKeys, values, log) {
 //  - useDefaults=false → values에 담긴 키만 사용자 확정값으로 치환, 나머지는 기본값
 //    (⚠️ substituteEnv는 useDefaults=false일 때만 values를 참조하므로 이 플래그를 반드시 함께 전달)
 // 인자:
-//   payloadRoot/types/resolvers/includeNexus — collectAsks와 동일 의미
+//   payloadRoot/types/resolvers/includeNexus/flutterStore — collectAsks와 동일 의미
 //   targetRoot — wizard-prompts.yml 1차 탐색 위치(기본 ".")
 //   force      — true면 질문 없이 전부 기본값 (.sh FORCE_MODE 등가)
 //   io         — {select, multiselect, text} 주입 (기본 readline-engine). 테스트 스텁 지점.
 //   log        — 카드·안내 출력 함수 주입 (기본 stderr)
 export async function promptEnvPlan({
   payloadRoot, types = [], io = null, force = false, resolvers = {},
-  includeNexus = false, includeSecretBackup = false, deployStyle = "", targetRoot = ".", repoName = "", log = defaultLog,
+  includeNexus = false, includeSecretBackup = false, deployStyle = "", flutterStore = null, targetRoot = ".", repoName = "", log = defaultLog,
 } = {}) {
   const prompts = loadWizardPrompts(targetRoot, payloadRoot);
-  const asks = collectAsks(payloadRoot, types, { resolvers, includeNexus, includeSecretBackup, deployStyle, prompts });
+  const asks = collectAsks(payloadRoot, types, { resolvers, includeNexus, includeSecretBackup, deployStyle, flutterStore, prompts });
   const defaults = asks.defaults;
 
   // 수집 키 0개 → 질문 자체가 없음 (.sh `[ ${#WF_ASK_KEYS[@]} -eq 0 ]` 등가)

package/src/ui/prompts.js

@@ -3,6 +3,7 @@
 // 취소(ESC/Ctrl+C)는 각 함수가 CANCEL 심볼을 반환 → 호출부가 정상 종료(exit 0) 처리.
 import * as engine from "./readline-engine.js";
 import { DEPLOY_STYLES, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
+import { ENV_MODES, DEFAULT_ENV_MODE, STORE_PLATFORMS, DEPLOY_MODES, DEFAULT_DEPLOY_MODE } from "../core/flutter-options.js";
 
 export const CANCEL = engine.CANCEL;
 
@@ -33,8 +34,10 @@ export async function confirmProjectMenu() {
   });
 }
 
-// 수정 메뉴 — 어떤 항목을 고칠지. showOptional=full/workflows에서만 nexus/secret 노출.
-export async function editMenu({ showOptional = false } = {}) {
+// 수정 메뉴 항목 — showOptional=full/workflows에서만 nexus/secret 노출,
+// showFlutter=Flutter 타입일 때만 환경변수 방식/스토어 배포 대상/배포 모드 노출 (이슈 #131).
+// 라벨·순서를 테스트할 수 있도록 순수 함수로 분리했다.
+export function editMenuOptions({ showOptional = false, showFlutter = false } = {}) {
   const options = [
     { value: "type", label: "프로젝트 타입" },
     { value: "version", label: "버전" },
@@ -44,8 +47,18 @@ export async function editMenu({ showOptional = false } = {}) {
     options.push({ value: "nexus", label: "Nexus publish 포함 여부" });
     options.push({ value: "secret", label: "Secret 백업 포함 여부" });
   }
+  if (showFlutter) {
+    options.push({ value: "envMode", label: "환경변수 방식" });
+    options.push({ value: "flutterStore", label: "스토어 배포 대상" });
+    options.push({ value: "deployMode", label: "배포 모드" });
+  }
   options.push({ value: "done", label: "모두 맞음, 계속" });
-  return engine.select({ message: "어떤 항목을 수정할까요?", options });
+  return options;
+}
+
+// 수정 메뉴 — 어떤 항목을 고칠지.
+export async function editMenu({ showOptional = false, showFlutter = false } = {}) {
+  return engine.select({ message: "어떤 항목을 수정할까요?", options: editMenuOptions({ showOptional, showFlutter }) });
 }
 
 const ALL_TYPES = ["spring", "flutter", "next", "react", "react-native", "react-native-expo", "node", "python", "basic", "go"];
@@ -103,6 +116,78 @@ export async function selectDeployStyle() {
   });
 }
 
+// ── Flutter 옵션 (이슈 #131) ─────────────────────────────────────────
+// 프로젝트 타입에 flutter가 포함된 경우에만 interactive.js가 묻는다. 세 함수 모두 취소(ESC) 시 CANCEL을
+// 그대로 돌려주고, "ESC = 기본값" 처리는 호출부가 한다 (selectDeployStyle과 같은 규약).
+const ENV_MODE_LABELS = {
+  "dart-define": "dart-define (신규 설치 기본) — 시크릿을 --dart-define-from-file로 빌드에 전달, 프로젝트에 .env를 만들지 않음",
+  dotenv: "dotenv — Flutter 루트에 .env를 만들어 flutter_dotenv·envied가 읽음 (기존 설치 유지값)",
+};
+
+const STORE_LABELS = {
+  android: "Android — Google Play Store (fastlane)",
+  ios: "iOS — TestFlight / App Store Connect (fastlane)",
+};
+
+const DEPLOY_MODE_LABELS = {
+  android: {
+    store_only: "store_only — internal 트랙에 업로드 (기본)",
+    store_prepare: "store_prepare — production 트랙에 draft로 업로드 (Play Console에서 직접 출시)",
+    store_submit: "store_submit — production 심사 제출까지",
+  },
+  ios: {
+    store_only: "store_only — TestFlight 업로드 (기본)",
+    store_prepare: "store_prepare — 앱 버전·메타데이터 준비까지 (심사 제출 안 함)",
+    store_submit: "store_submit — 심사 제출까지",
+  },
+};
+
+const PLATFORM_TITLES = { android: "Android (Play Store)", ios: "iOS (TestFlight)" };
+
+// 환경변수 방식 — 시크릿 ENV_FILE(.env 형식)을 Flutter 빌드에 넘기는 방법.
+export async function selectEnvMode({ initialValue = DEFAULT_ENV_MODE } = {}) {
+  engine.note(
+    "시크릿 ENV_FILE(.env 형식)을 Flutter 빌드에 넘기는 방식입니다.\n" +
+    "dart-define은 String.fromEnvironment로 읽고, dotenv는 flutter_dotenv·envied가 .env 파일을 읽습니다.\n" +
+    "나중에 확인 화면의 '수정하기 > 환경변수 방식'에서 바꿀 수 있습니다.",
+    "환경변수 방식",
+  );
+  return engine.select({
+    message: "Flutter 환경변수는 어떤 방식으로 넘길까요?",
+    options: ENV_MODES.map((value) => ({ value, label: ENV_MODE_LABELS[value] })),
+    initialIndex: Math.max(0, ENV_MODES.indexOf(initialValue)),
+  });
+}
+
+// 스토어 배포 대상 — 고른 플랫폼의 워크플로우와 fastlane 템플릿만 설치한다. 아무것도 안 고르면 스토어 배포 없이 설치.
+export async function selectFlutterStores({ initialValues = [] } = {}) {
+  engine.note(
+    "고른 플랫폼의 스토어 배포 워크플로우와 fastlane 파일(Fastfile 등)만 설치합니다.\n" +
+    "아무것도 고르지 않으면 스토어 배포 없이 설치합니다 (Firebase·Selfhosted·Test APK·CI는 항상 설치).",
+    "스토어 배포 대상",
+  );
+  return engine.multiselect({
+    message: "스토어에 배포할 플랫폼을 선택하세요 (Space 토글, Enter 확정)",
+    options: STORE_PLATFORMS.map((value) => ({ value, label: STORE_LABELS[value] })),
+    initialValues,
+    required: false,
+  });
+}
+
+// 배포 모드 — 플랫폼별로 한 번씩 묻는다. 런타임의 저장소 변수와 workflow_dispatch 입력이 항상 이 값보다 우선한다.
+export async function selectDeployMode({ platform, initialValue = DEFAULT_DEPLOY_MODE }) {
+  return engine.select({
+    message: `${PLATFORM_TITLES[platform]} 배포 모드를 선택하세요`,
+    options: DEPLOY_MODES.map((value) => ({ value, label: DEPLOY_MODE_LABELS[platform][value] })),
+    initialIndex: Math.max(0, DEPLOY_MODES.indexOf(initialValue)),
+  });
+}
+
+// store_submit은 main push마다 심사를 제출하므로 고른 직후 한 줄로 알린다. 호출부(interactive)가 note로 출력한다.
+export function deployModeWarning(mode) {
+  return mode === "store_submit" ? "store_submit을 고르면 main push마다 심사가 자동 제출됩니다." : "";
+}
+
 // 브랜치 전략 선택 (이슈 #93). 종전에는 "릴리스 브랜치"/"개발 브랜치" 두 질문에
 // 같은 이름을 입력해야만 trunk-based가 됐는데, 그 규칙이 사전에 안내되지 않아
 // 의도치 않게 pr-flow로 흘러갔다. 전략을 먼저 명시적으로 고르게 해 이를 없앤다.

package/src/ui/status-cards.js

@@ -2,6 +2,7 @@
 // (층5의 Breaking Changes 박스는 core/breaking-check.js가 담당.
 //  원본의 층4 IDE Skills 상태는 project-auto-wizard 스코프 제외 — Agent Skills 미포함)
 import { A, paint } from "./ansi.js";
+import { DEFAULT_DEPLOY_MODE } from "../core/flutter-options.js";
 
 const GUT = paint("│", A.gray);
 const HEAD = paint("◆", A.cyan);
@@ -29,7 +30,8 @@ export function printDetectionLog({ types = [], version = "", branch = "", marke
 
 // 층3 — 프로젝트 분석 개요 카드 (.ps1 Print-ProjectAnalysis 등가+)
 export function printAnalysisCard({ mode = "", modeLabel = "", types = [], version = "", branch = "",
-  includeNexus = null, includeSecretBackup = null, paths = new Map(), showOptional = false },
+  includeNexus = null, includeSecretBackup = null, paths = new Map(), showOptional = false,
+  flutter = null, envModeDefault = "" },
   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`);
@@ -40,6 +42,16 @@ export function printAnalysisCard({ mode = "", modeLabel = "", types = [], versi
   if (showOptional) {
     row("📦", "Nexus", includeNexus === true ? paint("포함", A.green) : paint("제외", A.dim));
     row("🔐", "Secret백업", includeSecretBackup === true ? paint("포함", A.green) : paint("제외", A.dim));
+    // Flutter 옵션 (이슈 #131 fable5.1 리뷰 Important #1) — 확정 직전 화면에서도 선택값을 보여준다.
+    if (flutter && types.includes("flutter")) {
+      const stores = flutter.stores ?? [];
+      const modeParts = stores.map(
+        (p) => `${p}=${(p === "android" ? flutter.androidDeployMode : flutter.iosDeployMode) || DEFAULT_DEPLOY_MODE}`,
+      );
+      row("⚙️", "환경변수", flutter.envMode || envModeDefault);
+      row("🏬", "스토어", stores.length ? stores.join(", ") : "없음");
+      row("🚀", "배포모드", modeParts.length ? modeParts.join(" ") : "없음");
+    }
   }
   // 모노레포 경로 — 루트가 아닌 항목이 하나라도 있으면 표시
   const nonRoot = [...paths.entries()].filter(([, p]) => p && p !== ".");

package/src/ui/summary.js

@@ -8,7 +8,9 @@ const SEPARATOR = "────────────────────
 export function printSummary(ctx) {
   const { mode, types = [], version = "", versionCode = null, copiedFiles = [], branches = null, gitignoreUpdated = false,
     // 설치 후 검증·기록 (#79, #80, #81)
-    answers = [], unresolved = [], secrets = new Map(), logPath = "", legacyMdLogs = false, cleanup = null } = ctx || {};
+    answers = [], unresolved = [], secrets = new Map(), logPath = "", legacyMdLogs = false, cleanup = null,
+    // Flutter 스토어 배포 (이슈 #131) — 앱 파일 생성/유지와 스토어 선택 해제 정리 결과
+    flutterApp = null, storeCleanup = null } = ctx || {};
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 ansi.js의 공용 가드로 통일 (NO_COLOR + stderr TTY 여부)
   const enabled = colorEnabled(process.stderr);
@@ -105,10 +107,18 @@ export function printSummary(ctx) {
     err("");
   }
   // 배포 방식을 바꿔 재설치한 경우, 이전 CD를 어떻게 처리했는지 알린다 (#80).
-  if (cleanup?.removed?.length || cleanup?.backedUp?.length) {
-    err("  🧹 이전 배포 방식 정리:");
-    for (const f of cleanup.removed || []) err(`     • ${f} ${paint("삭제 (손대지 않은 파일)", A.dim, enabled)}`);
-    for (const f of cleanup.backedUp || []) err(`     • ${f} → ${f}.bak ${paint("수정하신 내용이 있어 백업", A.dim, enabled)}`);
+  printCleanup(err, enabled, "이전 배포 방식 정리", cleanup);
+  // 스토어 배포 대상을 해제한 경우도 같은 규칙으로 정리한 결과를 알린다 (#131).
+  printCleanup(err, enabled, "선택 해제한 스토어 배포 정리", storeCleanup);
+  // Fastfile·ExportOptions.plist는 사용자 소유라 없을 때만 만든다 — 만든 것과 그대로 둔 것을 나눠 보여준다 (#131).
+  const { created: appCreated = [], kept: appKept = [] } = flutterApp || {};
+  if (appCreated.length || appKept.length) {
+    err("  📱 Flutter 스토어 배포 파일:");
+    for (const f of appCreated) err(`     • ${f} ${paint("새로 생성", A.dim, enabled)}`);
+    for (const f of appKept) err(`     • ${f} ${paint("기존 파일 유지", A.dim, enabled)}`);
+    if (appCreated.some((f) => f.endsWith("ExportOptions.plist"))) {
+      err("     → ExportOptions.plist의 __TEAM_ID__ · __BUNDLE_ID__ · __PROVISIONING_PROFILE_NAME__ 을 실제 값으로 채워야 iOS 배포가 동작합니다");
+    }
     err("");
   }
   if (logPath) {
@@ -175,3 +185,12 @@ export function printSummary(ctx) {
   err(paint("📖 워크플로우 구성과 릴리스 흐름은 README를 참고하세요.", A.cyan, enabled));
   err("");
 }
+
+// 삭제·백업 정리 결과 한 블록 — 이전 배포 방식 정리와 스토어 선택 해제 정리가 같은 형식을 쓴다.
+function printCleanup(err, enabled, title, cleanup) {
+  if (!cleanup?.removed?.length && !cleanup?.backedUp?.length) return;
+  err(`  🧹 ${title}:`);
+  for (const f of cleanup.removed || []) err(`     • ${f} ${paint("삭제 (손대지 않은 파일)", A.dim, enabled)}`);
+  for (const f of cleanup.backedUp || []) err(`     • ${f} → ${f}.bak ${paint("수정하신 내용이 있어 백업", A.dim, enabled)}`);
+  err("");
+}