project-auto-wizard 0.10.0 → 0.11.0

package/src/core/copy/workflows.js

@@ -4,6 +4,7 @@
 // 동기 엔진(copyWorkflows)에 hooks.decisions로 전달한다 — 기존 시그니처·force 동작 무변경.
 import { join, basename } from "node:path";
 import { deployFilter, isDeployWorkflow, activateDeployTrigger, DEFAULT_DEPLOY_STYLE, NO_DEPLOY_STYLE } from "../deploy-style.js";
+import { storeWorkflowFilter } from "../flutter-options.js";
 import { existsSync, readFileSync, writeFileSync, renameSync } from "node:fs";
 import { PATHS, PAYLOAD } from "../paths.js";
 import { exists, writeText, listYamlFiles } from "../fsutil.js";
@@ -30,6 +31,17 @@ const TRUNK_BASED_EXCLUDED = new Set([
   "PROJECT-COMMON-AUTO-CHANGELOG-CONTROL.yaml",
 ]);
 
+// 타입 루트 디렉토리에 거는 파일 필터 — "배포 안 함"의 CD 제외와 Flutter 스토어 대상 선택을 합성한다.
+// copyWorkflowsForType·surveyWorkflows·planWorkflows가 같은 함수를 써야 설치·충돌 조사·status/dry-run이
+// 서로 다른 파일 집합을 보지 않는다. flutterStore가 배열이 아니면(null=미결정, 비대화형 기본) 스토어 필터는
+// 걸지 않는다. 필터가 없어도 항상 함수를 돌려준다 — processDir은 null을 받지 못한다.
+export function buildTypeRootFilter(type, deployStyle, flutterStore) {
+  const filters = [];
+  if (deployStyle === NO_DEPLOY_STYLE) filters.push(deployFilter(deployStyle));
+  if (type === "flutter" && Array.isArray(flutterStore)) filters.push(storeWorkflowFilter(flutterStore));
+  return (filename) => filters.every((keep) => keep(filename));
+}
+
 // 한 파일에 env 치환을 적용해 대상 파일을 갱신 (.sh configure_workflow_env 등가).
 // values/useDefaults: env 계획(promptEnvPlan) 결과 — 미지정이면 기본값 경로(현행 force 동작).
 function configureEnv(targetPath, { type, projectPath = ".", repoName = "", resolvers = {}, collectAsks = null, values = new Map(), useDefaults = true }) {
@@ -143,6 +155,7 @@ function processDir(srcDir, workflowsDir, envOpts, ctx, counters, filter = () =>
 // copy_workflows 본체 (동기 — 기존 호출부 무변경).
 // context: { types:[], paths:Map, includeNexus, includeSecretBackup, force, repoName, resolvers,
 //            envValues?:Map<key,value>, envUseDefaults?:boolean }  ← env 계획(promptEnvPlan) 결과 주입점
+//            flutterStore?:string[]|null }  ← Flutter 스토어 대상 (null=필터 없음, 배열=선택된 플랫폼만)
 // hooks: { decisions?: Map<filename, 'skip'|'backup'|'template'>,   — 진짜 충돌(changed) 결정
 //          restoreRemoved?: Set<filename> }                          — 사용자가 지운 파일 중 복원할 것
 //        미지정 파일은 'skip'(현행 force 동작 100% 유지). 대화형 수집은 copyWorkflowsInteractive 참조.
@@ -270,7 +283,7 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, srcTe
 //   conflicts — 양쪽이 다 바뀐 진짜 충돌. upstreamOnly/localOnly는 자동 처리되므로 여기 없다.
 //   removed   — 우리가 깔았는데 사용자가 지운 파일. 되살리기 전에 물어봐야 한다.
 export function surveyWorkflows(context, payloadRoot, targetRoot = ".") {
-  const { types = [], paths = new Map(), includeNexus = false, repoName = "", resolvers = {} } = context;
+  const { types = [], paths = new Map(), includeNexus = false, repoName = "", resolvers = {}, flutterStore = null } = context;
   const workflowsDir = join(targetRoot, PATHS.workflowsDir);
   const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
   const deployStyle = context.deployStyle || DEFAULT_DEPLOY_STYLE;
@@ -297,7 +310,7 @@ export function surveyWorkflows(context, payloadRoot, targetRoot = ".") {
     const envOpts = { type, projectPath: paths.get(type) || ".", repoName, resolvers };
     const typeDir = join(projectTypesDir, type);
     if (exists(typeDir)) {
-      collect(typeDir, envOpts, type, () => false, deployStyle === NO_DEPLOY_STYLE ? keepDeploy : null);
+      collect(typeDir, envOpts, type, () => false, buildTypeRootFilter(type, deployStyle, flutterStore));
     }
     const serverDeployDir = join(typeDir, "server-deploy");
     if (exists(serverDeployDir) && !includeNexus && deployStyle !== NO_DEPLOY_STYLE) {
@@ -328,8 +341,9 @@ export async function copyWorkflowsInteractive(context, payloadRoot, targetRoot
 }
 
 function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters) {
-  const { includeNexus, deployStyle = "", envOptsFor, collectAsks = null, dirCtx } = ctx;
+  const { includeNexus, deployStyle = "", flutterStore = null, envOptsFor, collectAsks = null, dirCtx } = ctx;
   const keepDeploy = deployFilter(deployStyle);
+  const keepTypeRoot = buildTypeRootFilter(type, deployStyle, flutterStore);
   const { srcText, baselineTargets } = dirCtx;
   const typeDir = join(projectTypesDir, type);
   const envOpts = envOptsFor(type);
@@ -341,8 +355,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
   // 바로 있는 타입도 있다 — "배포 안 함"일 때는 타입 루트에서도 CD 파일(SIMPLE-CICD 등)을
   // 걸러야 한다. simple/nginx/traefik은 오늘과 동일하게 필터 없이 전부 복사한다.
   if (exists(typeDir)) {
-    const typeRootFilter = deployStyle === NO_DEPLOY_STYLE ? keepDeploy : undefined;
-    const c = processDir(typeDir, workflowsDir, envOpts, dirCtx, counters, typeRootFilter);
+    const c = processDir(typeDir, workflowsDir, envOpts, dirCtx, counters, keepTypeRoot);
     untouched.push(...c.unchanged, ...c.localOnly);
   }
 
@@ -374,7 +387,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
     for (const filename of listYamlFiles(srcDir)) {
       const target = join(workflowsDir, filename);
       if (srcDir === serverDeployDir && !keepDeploy(filename)) continue; // 안 고른 배포 방식
-      if (srcDir === typeDir && deployStyle === NO_DEPLOY_STYLE && !keepDeploy(filename)) continue; // 타입 루트 CD도 배제
+      if (srcDir === typeDir && !keepTypeRoot(filename)) continue; // 타입 루트: 배제된 CD·안 고른 스토어 워크플로우
       if (!existsSync(target)) continue;          // 건너뛴 파일 제외
       if (untouched.includes(filename)) continue; // unchanged/localOnly 제외
       configureEnv(target, { ...envOpts, collectAsks }); // env 계획 values/useDefaults 포함
@@ -386,7 +399,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
 // changed뿐 아니라 newFiles/unchanged까지 전부 반환한다는 점이 listWorkflowConflicts(changed만
 // 반환)와 다르다(읽기 전용 — 실제로 아무 파일도 쓰지 않는다).
 export function planWorkflows(context, payloadRoot, targetRoot = ".") {
-  const { types = [], paths = new Map(), includeNexus = false, includeSecretBackup = false, repoName = "", resolvers = {} } = context;
+  const { types = [], paths = new Map(), includeNexus = false, includeSecretBackup = false, repoName = "", resolvers = {}, flutterStore = null } = context;
   const workflowsDir = join(targetRoot, PATHS.workflowsDir);
   const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
   const deployStyle = context.deployStyle || DEFAULT_DEPLOY_STYLE;
@@ -427,8 +440,7 @@ export function planWorkflows(context, payloadRoot, targetRoot = ".") {
     const envOpts = { type, projectPath: paths.get(type) || ".", repoName, resolvers };
     const typeDir = join(projectTypesDir, type);
     if (exists(typeDir)) {
-      const typeRootFilter = deployStyle === NO_DEPLOY_STYLE ? deployFilter(deployStyle) : null;
-      merge(classify(typeDir, workflowsDir, envOpts, srcText, baseline, typeRootFilter), type);
+      merge(classify(typeDir, workflowsDir, envOpts, srcText, baseline, buildTypeRootFilter(type, deployStyle, flutterStore)), type);
     }
 
     const serverDeployDir = join(typeDir, "server-deploy");

package/src/core/detect-fs.js

@@ -116,7 +116,9 @@ export function findSpringAppYml(root, base = ".") {
 
 // 실 resolver 세트 생성 (.sh resolve_token 4종 등가) — index/interactive 공용.
 // paths: Map<type, path> (모노레포 경로).
-export function makeResolvers(root, repoName, paths) {
+// flutterOptions: resolveFlutterOptions 결과 또는 같은 필드를 가진 context (이슈 #131). null이면 Flutter 토큰이
+//   빈 값이라 템플릿 기본값(dart-define, store_only)이 그대로 남는다.
+export function makeResolvers(root, repoName, paths, flutterOptions = null) {
   const springBase = (t) => paths.get(t || "spring") || paths.get("spring") || ".";
   return {
     repo: () => repoName,
@@ -130,5 +132,11 @@ export function makeResolvers(root, repoName, paths) {
     },
     "spring-app-yml-path": (t) => findSpringAppYml(root, springBase(t)) || "",
     "flutter-root": () => paths.get("flutter") || ".",
+    // CI changes job의 경로 필터(이슈 #131) — 타입별 프로젝트 루트. 단일 레포·common은 "."(항상 변경됨으로 판정).
+    "project-path": (t) => paths.get(t) || ".",
+    // 빈 문자열이면 setEnvLine/setFallbackLine이 줄을 건너뛰어 템플릿 기본값이 남는다.
+    "flutter-env-mode": () => flutterOptions?.envMode || "",
+    "android-deploy-mode": () => flutterOptions?.androidDeployMode || "",
+    "ios-deploy-mode": () => flutterOptions?.iosDeployMode || "",
   };
 }

package/src/core/flutter-options.js

@@ -0,0 +1,118 @@
+// Flutter 옵션 (이슈 #131) — 환경변수 방식·스토어 배포 대상·배포 모드의 단일 진실.
+// 스토어 배포 대상은 deploy-style.js(배포 방식)와 같은 구조 — 값 목록, 파일 필터, 선택 해제 정리 — 를 따른다.
+import { join } from "node:path";
+import { existsSync, readFileSync, renameSync, rmSync } from "node:fs";
+import { sha256 } from "./baseline.js";
+
+// 환경변수 주입 방식. dart-define은 --dart-define-from-file, dotenv는 flutter_dotenv/envied용 .env 생성.
+// 둘을 동시에 쓰는 both는 만들지 않는다 — 환경변수를 두 곳에서 관리하게 되기 때문.
+export const ENV_MODES = ["dart-define", "dotenv"];
+export const DEFAULT_ENV_MODE = "dart-define"; // 신규 설치 기본
+export const LEGACY_ENV_MODE = "dotenv";       // 기존 설치(version.yml 있음, 저장값 없음)가 조용히 깨지지 않도록 보존
+
+export const STORE_PLATFORMS = ["android", "ios"];
+export const DEPLOY_MODES = ["store_only", "store_prepare", "store_submit"];
+export const DEFAULT_DEPLOY_MODE = "store_only";
+export const NO_STORE = "none";
+
+export const isEnvMode = (v) => ENV_MODES.includes(v);
+export const isDeployMode = (v) => DEPLOY_MODES.includes(v);
+
+// "android,ios" | "android" | "none" | "" → 배열. 항상 STORE_PLATFORMS 순서라 직렬화가 결정적이다.
+// 알 수 없는 토큰이 하나라도 있거나 문자열이 아니면 null — 호출부가 "값 없음/잘못된 값"으로 처리한다.
+export function parseStoreList(csv) {
+  if (typeof csv !== "string") return null;
+  const tokens = csv.split(",").map((t) => t.trim()).filter((t) => t !== "");
+  if (tokens.length === 0 || (tokens.length === 1 && tokens[0] === NO_STORE)) return [];
+  if (!tokens.every((t) => STORE_PLATFORMS.includes(t))) return null;
+  return STORE_PLATFORMS.filter((p) => tokens.includes(p));
+}
+
+// 저장용 직렬화 — 빈 배열은 빈 문자열이 아니라 "none"으로 적어 "선택 안 함"과 "값 없음"을 구분한다.
+export function formatStoreList(stores) {
+  const ordered = STORE_PLATFORMS.filter((p) => stores.includes(p));
+  return ordered.length ? ordered.join(",") : NO_STORE;
+}
+
+// 플랫폼별 스토어 워크플로우 (payload/workflows/flutter/ 기준 파일명).
+// FIREBASE·SELFHOSTED·TEST-APK·APP-BUILD-TRIGGER·CI는 스토어와 무관해 여기 넣지 않는다 — 항상 설치된다.
+export const STORE_WORKFLOWS = {
+  android: ["PROJECT-FLUTTER-ANDROID-PLAYSTORE-CICD.yaml"],
+  ios: ["PROJECT-FLUTTER-IOS-TESTFLIGHT.yaml", "PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT.yaml"],
+};
+
+export const isStoreWorkflow = (filename) => Object.values(STORE_WORKFLOWS).flat().includes(filename);
+
+// 파일 필터 — stores가 null이면 미결정이라 현행 동작(전부 설치)이다.
+// 배열이면 스토어 워크플로우는 선택된 플랫폼 것만 통과하고, 그 외 파일은 항상 통과한다.
+export function storeWorkflowFilter(stores) {
+  if (stores === null || stores === undefined) return () => true;
+  const allowed = new Set(STORE_PLATFORMS.filter((p) => stores.includes(p)).flatMap((p) => STORE_WORKFLOWS[p]));
+  return (filename) => !isStoreWorkflow(filename) || allowed.has(filename);
+}
+
+// 선택 해제한 스토어 워크플로우 정리 — cleanupOtherDeployWorkflows(deploy-style.js)와 같은 규칙이다.
+//   손대지 않은 것(baseline의 installed 해시와 동일) → 삭제
+//   손댄 것                                          → .bak으로 옮긴다 (내용 보존, 트리거만 죽인다)
+// 사용자 소유인 Fastfile·ExportOptions.plist는 여기서 다루지 않는다 (워크플로우 파일만 대상).
+// 반환: { removed:[], backedUp:[] }
+export function cleanupDeselectedStoreWorkflows(workflowsDir, installedFilenames, stores, baseline) {
+  const keep = storeWorkflowFilter(stores);
+  const removed = [];
+  const backedUp = [];
+
+  for (const filename of installedFilenames) {
+    if (!isStoreWorkflow(filename) || keep(filename)) continue;
+    const p = join(workflowsDir, filename);
+    if (!existsSync(p)) continue;
+
+    const known = baseline?.files?.[filename]?.installed;
+    const untouched = known && sha256(readFileSync(p, "utf8")) === known;
+    if (untouched) {
+      rmSync(p, { force: true });
+      removed.push(filename);
+    } else {
+      renameSync(p, `${p}.bak`);
+      backedUp.push(filename);
+    }
+  }
+  return { removed, backedUp };
+}
+
+// 스토어 앱 파일 (payload/flutter-app/ 기준 상대경로) — 플랫폼별 묶음.
+export const STORE_APP_FILES = {
+  android: ["android/fastlane/Fastfile.playstore"],
+  ios: ["ios/fastlane/Fastfile", "ios/ExportOptions.plist"],
+};
+
+// 선택된 플랫폼의 앱 파일 목록. stores가 null이면 전부 (현행 동작 = 둘 다 설치).
+export function storeAppFilesFor(stores) {
+  const platforms = stores === null || stores === undefined
+    ? STORE_PLATFORMS
+    : STORE_PLATFORMS.filter((p) => stores.includes(p));
+  return platforms.flatMap((p) => STORE_APP_FILES[p]);
+}
+
+const validOr = (isValid, value, fallback) => (isValid(value) ? value : fallback);
+
+// 옵션 최종 결정 — 우선순위: CLI > version.yml 저장값 > 기본값.
+//   cli      { envMode:"", stores:null|string[], androidDeployMode:"", iosDeployMode:"" } (빈값/null = 미지정)
+//   existing parseExisting() 결과 또는 null (version.yml이 없으면 신규 설치)
+//
+// - envMode 기본값: 신규 설치와 "Flutter를 새로 추가하는" 기존 설치는 dart-define, 이미 Flutter가
+//   설치돼 있던 프로젝트는 dotenv. 업데이트 한 번에 flutter_dotenv 프로젝트가 조용히 깨지지 않게
+//   하려는 것이라, 판단 기준은 "이 프로젝트에 Flutter가 이미 있었는가"다(단순 existing 존재 여부가
+//   아니다 — Spring 전용 프로젝트에 flutter 타입을 처음 추가하는 경우까지 dotenv로 묶으면 안 된다).
+// - stores: null은 "미결정" — 비대화형은 현행 동작(둘 다 설치), 대화형은 질문한다.
+// - 저장값은 유효할 때만 쓴다. version.yml은 사람이 고칠 수 있는데, 그 값이 워크플로우 표현식
+//   (`|| 'store_only'` 폴백 자리)에 그대로 들어가므로 목록 밖 문자열은 걸러야 한다.
+export function resolveFlutterOptions({ cli = {}, existing = null } = {}) {
+  const saved = existing?.options ?? {};
+  const hadFlutterAlready = Array.isArray(existing?.types) && existing.types.includes("flutter");
+  return {
+    envMode: cli.envMode || validOr(isEnvMode, saved.envMode, hadFlutterAlready ? LEGACY_ENV_MODE : DEFAULT_ENV_MODE),
+    stores: cli.stores ?? parseStoreList(saved.flutterStore),
+    androidDeployMode: cli.androidDeployMode || validOr(isDeployMode, saved.androidDeployMode, DEFAULT_DEPLOY_MODE),
+    iosDeployMode: cli.iosDeployMode || validOr(isDeployMode, saved.iosDeployMode, DEFAULT_DEPLOY_MODE),
+  };
+}

package/src/core/installed-stores.js

@@ -0,0 +1,12 @@
+// 이미 설치된 스토어 배포 워크플로우 파일명으로 플랫폼을 추론한다 (이슈 #131).
+// version.yml에 flutter_store 저장값이 없는 기존 설치가 대상이다 — 저장값이 없다고 "선택 없음"으로 보면
+// 잘 쓰던 스토어 워크플로우가 선택 해제 정리 규칙에 의해 삭제된다.
+import { existsSync, readdirSync } from "node:fs";
+import { STORE_PLATFORMS, STORE_WORKFLOWS } from "./flutter-options.js";
+
+// 반환: 스토어 워크플로우가 하나라도 설치된 플랫폼 (STORE_PLATFORMS 순서).
+export function inferInstalledStores(workflowsDir) {
+  if (!existsSync(workflowsDir)) return [];
+  const installed = new Set(readdirSync(workflowsDir));
+  return STORE_PLATFORMS.filter((platform) => STORE_WORKFLOWS[platform].some((file) => installed.has(file)));
+}

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 ]` 등가)