project-auto-wizard 0.9.1 → 0.11.0

package/src/commands/interactive-flutter.js

@@ -0,0 +1,95 @@
+// 대화형 마법사의 Flutter 옵션 질문 (이슈 #131) — 환경변수 방식 · 스토어 배포 대상 · 배포 모드.
+// 상태는 { envMode, stores, androidDeployMode, iosDeployMode } 불변 객체로 주고받는다.
+//   envMode·*DeployMode의 ""와 stores의 null = 미결정 (stores의 빈 배열 = "스토어 배포 안 함"으로 이미 결정됨).
+// 이미 결정된 값은 다시 묻지 않는다 (version.yml 저장값 재질문 생략 규약). ESC(취소)는 항상 기본값:
+// 처음 묻는 질문이면 기본값, 수정 중이면 현재값을 유지한다.
+import {
+  isEnvMode, isDeployMode, parseStoreList, STORE_PLATFORMS, DEFAULT_DEPLOY_MODE,
+} from "../core/flutter-options.js";
+import { deployModeWarning } from "../ui/prompts.js";
+
+export const FLUTTER_EDIT_ITEMS = new Set(["envMode", "flutterStore", "deployMode"]);
+
+const DEPLOY_MODE_KEY = { android: "androidDeployMode", ios: "iosDeployMode" };
+
+// STORE_PLATFORMS 순서로 정렬하고 모르는 값은 버린다 — 플랫폼별 질문 순서를 고정한다.
+const normalizeStores = (picked) => STORE_PLATFORMS.filter((platform) => picked.includes(platform));
+
+// 기존 version.yml의 저장값을 상태로 옮긴다. 잘못된 값은 저장이 없는 것으로 보고 다시 묻는다.
+export function savedFlutterState(existing) {
+  const options = existing?.options ?? {};
+  return {
+    envMode: isEnvMode(options.envMode) ? options.envMode : "",
+    stores: options.flutterStore == null ? null : parseStoreList(options.flutterStore),
+    androidDeployMode: isDeployMode(options.androidDeployMode) ? options.androidDeployMode : "",
+    iosDeployMode: isDeployMode(options.iosDeployMode) ? options.iosDeployMode : "",
+  };
+}
+
+async function askDeployMode(io, platform, initialValue) {
+  const picked = await io.selectDeployMode({ platform, initialValue });
+  const mode = isDeployMode(picked) ? picked : initialValue; // ESC = 기본값
+  const warning = deployModeWarning(mode);
+  if (warning) io.note?.(warning, "배포 모드");
+  return mode;
+}
+
+// 고른 플랫폼 중 배포 모드가 아직 없는 것만 묻는다.
+async function askUnsetDeployModes(io, state) {
+  const next = { ...state };
+  for (const platform of state.stores ?? []) {
+    const key = DEPLOY_MODE_KEY[platform];
+    if (!next[key]) next[key] = await askDeployMode(io, platform, DEFAULT_DEPLOY_MODE);
+  }
+  return next;
+}
+
+// 아직 정해지지 않은 옵션만 묻는다.
+//   envModeDefault  — 신규 설치 dart-define / 기존 설치 dotenv (동작 보존)
+//   inferredStores  — 저장값 없는 기존 설치가 이미 쓰던 스토어 (신규 설치는 [])
+export async function askUnsetFlutterOptions(io, state, { envModeDefault, inferredStores }) {
+  const next = { ...state };
+  if (!next.envMode) {
+    const picked = await io.selectEnvMode({ initialValue: envModeDefault });
+    next.envMode = isEnvMode(picked) ? picked : envModeDefault; // ESC = 기본값
+  }
+  if (next.stores === null) {
+    const picked = await io.selectFlutterStores({ initialValues: inferredStores });
+    next.stores = Array.isArray(picked) ? normalizeStores(picked) : inferredStores; // ESC = 초기 선택
+  }
+  return askUnsetDeployModes(io, next);
+}
+
+// 수정하기 메뉴에서 고른 항목 하나를 다시 묻는다. 현재값이 초기 선택이고 ESC는 현재값 유지.
+export async function editFlutterOption(io, what, state, envModeDefault) {
+  if (what === "envMode") {
+    const picked = await io.selectEnvMode({ initialValue: state.envMode || envModeDefault });
+    return isEnvMode(picked) ? { ...state, envMode: picked } : state;
+  }
+  if (what === "flutterStore") {
+    const picked = await io.selectFlutterStores({ initialValues: state.stores ?? [] });
+    if (!Array.isArray(picked)) return state;
+    const stores = normalizeStores(picked);
+    // 해제된 플랫폼의 배포 모드는 초기화한다 — 그대로 두면 재선택 시 옛 값이 남아 다시 묻지 않는다.
+    const reset = { ...state, stores };
+    for (const platform of STORE_PLATFORMS) {
+      if (!stores.includes(platform)) reset[DEPLOY_MODE_KEY[platform]] = "";
+    }
+    // 새로 추가되거나 방금 초기화된 플랫폼만 배포 모드를 묻는다 — 이미 정한 플랫폼의 모드는 그대로 둔다.
+    return askUnsetDeployModes(io, reset);
+  }
+  if (what === "deployMode") {
+    const stores = state.stores ?? [];
+    if (!stores.length) {
+      io.note?.("스토어 배포 대상을 먼저 선택하세요 ('스토어 배포 대상' 항목).", "배포 모드");
+      return state;
+    }
+    const next = { ...state };
+    for (const platform of stores) {
+      const key = DEPLOY_MODE_KEY[platform];
+      next[key] = await askDeployMode(io, platform, state[key] || DEFAULT_DEPLOY_MODE);
+    }
+    return next;
+  }
+  return state;
+}

package/src/commands/interactive.js

@@ -15,6 +15,10 @@ 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 { PATHS } from "../core/paths.js";
+import { resolveFlutterOptions, DEFAULT_DEPLOY_MODE } 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 { runUninstallFlow } from "./uninstall.js";
 import * as prompts from "../ui/prompts.js";
@@ -89,6 +93,21 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const showOptional = mode === "full";
   const realTty = process.stdout.isTTY === true;
 
+  // Flutter 옵션 (이슈 #131) — 저장값이 있으면 재질문하지 않는다 (deploy_style과 같은 규약).
+  // 저장값 없는 기존 설치는 동작 보존을 위해 dotenv를 초기 선택으로, 스토어는 설치된 워크플로우로 추론한다.
+  // 환경변수 기본값 규칙(신규=dart-define, 기존 설치·저장값 없음=dotenv)은 resolveFlutterOptions가 단일 진실이다.
+  let flutter = savedFlutterState(existing);
+  const flutterAsk = {
+    envModeDefault: resolveFlutterOptions({
+      cli: { envMode: "", stores: null, androidDeployMode: "", iosDeployMode: "" }, existing,
+    }).envMode,
+    inferredStores: existing && flutter.stores === null ? inferInstalledStores(join(cwd, PATHS.workflowsDir)) : [],
+  };
+  // 이미 정해진 값은 건너뛰므로 여러 번 불러도 같은 질문이 반복되지 않는다.
+  const askFlutterOptions = async () => {
+    if (types.includes("flutter")) flutter = await askUnsetFlutterOptions(io, flutter, flutterAsk);
+  };
+
   // 층2 — 감지 로그 (#446). markers = 실제로 존재를 확인한 파일 (이슈 #77).
   let markers = detectMarkers(cwd, types);
   io.detectionLog?.({ types, version, branch, markers, warnings: detectWarnings });
@@ -125,6 +144,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       deployStyle = isDeployStyle(picked) ? picked : DEFAULT_DEPLOY_STYLE; // ESC = 기본값
     }
 
+    // Flutter 옵션 (이슈 #131) — 환경변수 방식 → 스토어 배포 대상 → 플랫폼별 배포 모드.
+    await askFlutterOptions();
+
     // 신규 질문 — 자동 semver 승격 (기본 ON). 저장값 있으면 재질문 생략.
     // version.yml을 쓰지 않는 workflows 모드에서는 답변이 무의미하므로 full에서만 질문한다.
     if (mode === "full" && includeSemverAuto === null) {
@@ -143,9 +165,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   while (!confirmed) {
     // 층3 — 프로젝트 분석 개요 카드 (#446). 스텁엔 없음 → note 폴백.
     if (io.analysisCard) {
-      io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, includeNexus, includeSecretBackup, showOptional, paths });
+      io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, includeNexus, includeSecretBackup, showOptional, paths, flutter, envModeDefault: flutterAsk.envModeDefault });
     } else {
-      io.note?.(summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional }), "프로젝트 분석 결과");
+      io.note?.(summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional, flutter, envModeDefault: flutterAsk.envModeDefault }), "프로젝트 분석 결과");
     }
     const choice = await io.confirmProjectMenu();
     if (choice === "cancel") { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
@@ -154,7 +176,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     // edit 루프
     let editing = true;
     while (editing) {
-      const what = await io.editMenu({ showOptional });
+      const what = await io.editMenu({ showOptional, showFlutter: showOptional && types.includes("flutter") });
       if (isCancel(what) || what === "done") { editing = false; break; }
       if (what === "type") {
         const t = await io.selectTypes(types);
@@ -180,10 +202,22 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       } else if (what === "secret") {
         const y = await io.askYesNo("Secret 백업 워크플로우를 포함할까요?", includeSecretBackup);
         if (!isCancel(y)) includeSecretBackup = y === true;
+      } else if (FLUTTER_EDIT_ITEMS.has(what)) {
+        flutter = await editFlutterOption(io, what, flutter, flutterAsk.envModeDefault);
       }
     }
   }
 
+  // 편집 루프에서 뒤늦게 flutter 타입이 추가된 경우에도 옵션을 확정한다 — 이미 정해진 값은 다시 묻지 않는다.
+  if (showOptional) await askFlutterOptions();
+  // 질문이 나오지 않은 경우(비 full 모드 등)도 동작 보존 기본값으로 채워 워크플로우 치환이 어긋나지 않게 한다.
+  const flutterOptions = {
+    envMode: flutter.envMode || flutterAsk.envModeDefault,
+    stores: flutter.stores,
+    androidDeployMode: flutter.androidDeployMode || DEFAULT_DEPLOY_MODE,
+    iosDeployMode: flutter.iosDeployMode || DEFAULT_DEPLOY_MODE,
+  };
+
   const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지 (이슈 #41)
 
   // 신규 질문 ① — 브랜치 설정 (DESIGN-SPEC §4). full/workflows만 질문, version은 기본값 기록.
@@ -226,12 +260,13 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   }
 
   // @wizard env 계획 질문 (.sh wf_prompt_env_plan L3220 — full/workflows만)
-  const resolvers = makeResolvers(cwd, repoName, paths);
+  const resolvers = makeResolvers(cwd, repoName, paths, flutterOptions);
   let envValues = new Map(), envUseDefaults = true, envAnswers = [];
   if (showOptional) {
     const plan = await promptEnvPlan({
       payloadRoot: payload, types, io: io.engineIo ?? null, force: false,
       resolvers, includeNexus, includeSecretBackup, deployStyle, targetRoot: cwd, repoName,
+      flutterStore: flutterOptions.stores, // 선택 해제된 스토어 워크플로우의 ask 질문은 묻지 않는다 (D2 env-plan)
     });
     envValues = plan.values;
     envUseDefaults = plan.useDefaults;
@@ -247,6 +282,8 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     // 설치 로그(#79)·완료 요약(#80)이 쓰는 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     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;
@@ -309,6 +346,8 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     logPath: currentLogPath(),
     legacyMdLogs: hasLegacyMdLogs(cwd),
     cleanup: result?.cleanup ?? null,
+    storeCleanup: result?.storeCleanup ?? null,
+    flutterApp: result?.flutterApp ?? null,
   });
   io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
   return 0;
@@ -335,7 +374,7 @@ export async function pickBranch(io, message, def, remoteBranches, isCancel) {
   return isCancel(v) || !v ? def : v;
 }
 
-function summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional }) {
+function summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional, flutter, envModeDefault }) {
   const lines = [
     `통합 모드 : ${modeLabel(mode)}`,
     `프로젝트 타입 : ${types.join(", ")}${types.length > 1 ? " (멀티)" : ""}`,
@@ -345,6 +384,13 @@ function summarize({ mode, types, version, branch, includeNexus, includeSecretBa
   if (showOptional) {
     lines.push(`Nexus publish : ${includeNexus ? "포함" : "제외"}`);
     lines.push(`Secret 백업 : ${includeSecretBackup ? "포함" : "제외"}`);
+    if (types.includes("flutter")) {
+      const stores = flutter.stores ?? [];
+      const modeParts = stores.map((p) => `${p}=${(p === "android" ? flutter.androidDeployMode : flutter.iosDeployMode) || DEFAULT_DEPLOY_MODE}`);
+      lines.push(`환경변수 방식 : ${flutter.envMode || envModeDefault}`);
+      lines.push(`스토어 배포 대상 : ${stores.length ? stores.join(", ") : "없음"}`);
+      lines.push(`배포 모드 : ${modeParts.length ? modeParts.join(" ") : "없음"}`);
+    }
   }
   return lines.join("\n");
 }

package/src/commands/status.js

@@ -5,6 +5,7 @@ import { parseExisting } from "../core/version-yml.js";
 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";
 
 // payloadRoot: 패키지 payload/ 루트. targetRoot: 상태를 확인할 대상 레포.
 export function runStatus(payloadRoot, targetRoot = ".") {
@@ -13,7 +14,12 @@ export function runStatus(payloadRoot, targetRoot = ".") {
 
   const existing = parseExisting(readFileSync(vyPath, "utf8"));
   const repoName = detectRepoName(targetRoot);
-  const resolvers = makeResolvers(targetRoot, repoName, existing.paths);
+  // 설치 때 워크플로우에 치환된 환경변수 방식·배포 모드와 스토어 선택을 비교 기준에도 똑같이 적용한다 —
+  // 그렇지 않으면 미수정 파일이 드리프트로, 선택 해제한 스토어 워크플로우가 "삭제함"으로 오탐된다.
+  const flutterOptions = resolveFlutterOptions({
+    cli: { envMode: "", stores: null, androidDeployMode: "", iosDeployMode: "" }, existing,
+  });
+  const resolvers = makeResolvers(targetRoot, repoName, existing.paths, flutterOptions);
   // version.yml에 branches 블록이 없으면(신기능 이전 설치·수기 편집) makeSrcText(null)이
   // {{MAIN_BRANCH}}/{{DEVELOP_BRANCH}}를 치환하지 못해 모든 워크플로우가 드리프트로 오탐된다 —
   // 비교용 기본값으로 폴백(실제 저장값은 아니지만 드리프트 비교 목적에는 충분).
@@ -23,6 +29,7 @@ export function runStatus(payloadRoot, targetRoot = ".") {
     includeNexus: existing.options.nexus === true,
     includeSecretBackup: existing.options.secretBackup === true,
     repoName, resolvers, branches: branchesForCompare,
+    flutterStore: flutterOptions.stores,
   };
   const plan = planWorkflows(context, payloadRoot, targetRoot);
 
@@ -62,7 +69,8 @@ export function printStatus(status) {
   }
   const boolLabel = (v) => (v === null ? "미설정(기본 false)" : v);
   const semverAutoLabel = status.options.semverAuto === null ? "미설정(기본 false)" : status.options.semverAuto;
-  lines.push(`옵션            : nexus=${boolLabel(status.options.nexus)} secret_backup=${boolLabel(status.options.secretBackup)} semver_auto=${semverAutoLabel}`);
+  const flutterLabels = status.types.includes("flutter") ? flutterOptionLabels(status.options) : "";
+  lines.push(`옵션            : nexus=${boolLabel(status.options.nexus)} secret_backup=${boolLabel(status.options.secretBackup)} semver_auto=${semverAutoLabel}${flutterLabels}`);
   if (status.modifiedFiles.length) {
     lines.push("", `사용자가 수정한 워크플로우 파일 (${status.modifiedFiles.length}개):`);
     for (const f of status.modifiedFiles) lines.push(`  - ${f}`);
@@ -82,3 +90,13 @@ export function printStatus(status) {
   lines.push("");
   console.log(lines.join("\n"));
 }
+
+// Flutter 타입일 때만 붙는 옵션 (이슈 #131). 저장값이 없으면 그 상태에서 실제로 적용되는 동작을 함께 알린다.
+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("");
+}

package/src/context.js

@@ -27,6 +27,12 @@ export function createContext(overrides = {}) {
     includeNexus: null,      // null=미설정, true/false=명시
     includeSecretBackup: null,
     includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
+    // Flutter 옵션 (이슈 #131) — Flutter 타입이 없는 프로젝트에서는 전부 무시된다.
+    // 결정은 src/core/flutter-options.js의 resolveFlutterOptions가 한다.
+    envMode: "",             // "dart-define" | "dotenv". ""=미결정 → 템플릿 기본값(dart-define)
+    flutterStore: null,      // 스토어 배포 대상 string[] (예: ["android","ios"]). null=미결정 → 둘 다(현행 동작)
+    androidDeployMode: "",   // store_only | store_prepare | store_submit. ""=미결정 → store_only
+    iosDeployMode: "",       // 위와 동일 (iOS)
     templateVersion: "",
     deployValues: new Map(), // "type.KEY" -> value
     counters: {},

package/src/core/breaking.js

@@ -13,13 +13,17 @@ export function compareVersions(a, b) {
 // breaking-changes.json에서 current < ver <= target 범위 항목 수집.
 // ⚠️ .sh 버그 수정: target은 하드코딩 1.3.14가 아니라 실제 templateVersion을 넘긴다 (D2).
 // _ 로 시작하는 키(메타) 제외. severity critical / 그 외(warning).
+// 버전 키의 값은 항목 객체 또는 항목 객체의 배열(같은 릴리스에 고지가 여러 건일 때).
 export function collectBreaking(json, current, target) {
   const critical = [], warnings = [];
-  for (const [ver, entry] of Object.entries(json || {})) {
+  for (const [ver, value] of Object.entries(json || {})) {
     if (ver.startsWith("_")) continue;
     if (compareVersions(current, ver) < 0 && compareVersions(ver, target) <= 0) {
-      const rec = { version: ver, ...entry };
-      (entry?.severity === "critical" ? critical : warnings).push(rec);
+      // 한 릴리스에 고지가 여러 건이면 배열로 등록한다 — JSON 키(버전)는 유일해서 객체로는 한 건만 담긴다.
+      for (const entry of Array.isArray(value) ? value : [value]) {
+        const rec = { version: ver, ...entry };
+        (entry?.severity === "critical" ? critical : warnings).push(rec);
+      }
     }
   }
   return { critical, warnings };

package/src/core/copy/flutter-app.js

@@ -0,0 +1,42 @@
+// Flutter 앱 소유 파일(fastlane·ExportOptions.plist) 설치 (이슈 #131).
+// 워크플로우와 달리 사용자가 값을 채워 넣는 파일이라 "없을 때만 생성"한다 — 덮어쓰지 않고 baseline
+// 3-way도 적용하지 않는다(copyWorkflows의 secret-backup 경로와 같은 선례). 원본 갱신을 기존 사용자에게
+// 전파하는 것은 범위 밖이다.
+import { join, posix } from "node:path";
+import { existsSync } from "node:fs";
+import { copyFileSync } from "../fsutil.js";
+import { storeAppFilesFor } from "../flutter-options.js";
+
+const FLUTTER_APP_DIR = "flutter-app"; // payload/flutter-app/
+
+// 이번 실행에서 다룰 파일의 (보고용 상대경로, 원본, 목적지) 목록.
+// 대상은 Flutter 타입이 있을 때만이고, 선택된 플랫폼(context.flutterStore, null이면 둘 다)의 파일로 한정한다.
+function flutterAppTargets(context, payloadRoot, targetRoot) {
+  const { types = [], paths = new Map(), flutterStore = null } = context;
+  if (!types.includes("flutter")) return [];
+  const flutterRoot = paths.get("flutter") || ".";
+  return storeAppFilesFor(flutterStore).map((rel) => ({
+    reported: posix.join(flutterRoot, rel),
+    src: join(payloadRoot, FLUTTER_APP_DIR, rel),
+    dst: join(targetRoot, flutterRoot, rel),
+  }));
+}
+
+// 읽기 전용 — status/dry-run이 쓴다. 원본 payload는 읽지 않는다.
+export function planFlutterAppFiles(context, payloadRoot, targetRoot = ".") {
+  const result = { created: [], kept: [] };
+  for (const { reported, dst } of flutterAppTargets(context, payloadRoot, targetRoot)) {
+    (existsSync(dst) ? result.kept : result.created).push(reported);
+  }
+  return result;
+}
+
+export function copyFlutterAppFiles(context, payloadRoot, targetRoot = ".") {
+  const result = { created: [], kept: [] };
+  for (const { reported, src, dst } of flutterAppTargets(context, payloadRoot, targetRoot)) {
+    if (existsSync(dst)) { result.kept.push(reported); continue; }
+    copyFileSync(src, dst); // 부모 디렉토리 생성 + 바이트 그대로(CRLF 보존)
+    result.created.push(reported);
+  }
+  return result;
+}

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/verify.js

@@ -6,8 +6,8 @@ import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 
 // 치환 대상이 아닌 토큰 — 워크플로우 스크립트 안의 heredoc 구분자다. 값이 아니라 문법이므로
-// 미치환 검사에서 제외한다. (예: cat <<'__SUH_FILE_CONTENT_EOF__')
-const SENTINEL_RE = /^__SUH_[A-Z0-9_]*__$/;
+// 미치환 검사에서 제외한다. (예: cat <<'__WIZARD_FILE_CONTENT_EOF__')
+const SENTINEL_RE = /^__WIZARD_[A-Z0-9_]*__$/;
 const PLACEHOLDER_RE = /__[A-Z][A-Z0-9_]*__/g;
 
 // 주석으로 죽어 있는 줄 — 실행되지 않으므로 검사 대상이 아니다.