project-auto-wizard 0.10.0 → 0.12.0

package/src/cli/help.js

@@ -1,5 +1,5 @@
 // --help 텍스트.
-export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-native AI 릴리스 자동화 설치 마법사
+export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-native 릴리스 자동화 설치 마법사
 
 사용법:
   npx project-auto-wizard [옵션]
@@ -17,9 +17,14 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
       --main-branch B      릴리스 브랜치 (기본: 감지된 default branch)
       --develop-branch B   개발 브랜치 (기본: develop). 릴리스 브랜치와 같으면 trunk-based 모드
       --deploy-style STYLE           서버 배포 방식: simple | nginx | traefik | none (기본: simple)
+      --flutter-env-mode MODE        Flutter 환경변수 방식: dart-define | dotenv (기본: 신규 설치 dart-define, 기존 설치는 저장값·dotenv 유지)
+      --flutter-store CSV            Flutter 스토어 배포 대상: android,ios | android | ios | none (기본: 둘 다 설치)
+      --android-deploy-mode MODE     Play Store 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
+      --ios-deploy-mode MODE         iOS 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
       --nexus / --no-nexus            라이브러리 publish 워크플로우 포함/제외 (Nexus + GitHub Packages)
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
+      --copilot / --no-copilot  Copilot으로 AI 요약 생성 (기본: 사용 안 함, GitHub Copilot AI Credits 소비)
       --force              full 실행에 필수 (모든 확인 생략, 비대화형 기본값 사용)
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/uninstall 지원)
       --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거

package/src/commands/doctor.js

@@ -11,9 +11,13 @@
 //   ④ GitHub 설정 화면에 실제로 표시되는 문자열("Read and write permissions" 등)은 번역하지
 //      않는다. 번역하면 설명은 읽히지만 정작 화면에서 그 항목을 찾지 못한다.
 import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { join, posix } from "node:path";
 import { A, paint, colorEnabled, visualWidth } from "../ui/ansi.js";
+import { PATHS } from "../core/paths.js";
+import { parseExisting } from "../core/version-yml.js";
+import { STORE_PLATFORMS, STORE_APP_FILES, parseStoreList, storeAppFilesFor } from "../core/flutter-options.js";
+import { inferInstalledStores } from "../core/installed-stores.js";
 
 const defaultExec = (cmd, args) => spawnSync(cmd, args, { encoding: "utf8" });
 
@@ -23,6 +27,7 @@ const defaultExec = (cmd, args) => spawnSync(cmd, args, { encoding: "utf8" });
 const REPO_URL = "https://github.com/Twin-Fang/project-auto-wizard";
 export const DOC = {
   postInstall: `${REPO_URL}#post-install`,
+  flutterStore: `${REPO_URL}#flutter-store`,
 };
 
 export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
@@ -39,6 +44,9 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
       note: ["이 폴더엔 아직 설치되지 않았습니다 — 지금 설치하면 됩니다."],
     });
 
+  // Flutter 스토어 배포 파일 점검 (이슈 #131) — 로컬 파일만 보므로 gh 조회 결과와 무관하게 수행한다.
+  if (installed) for (const item of flutterStoreChecks(cwd)) add(item);
+
   const ghVersion = exec("gh", ["--version"]);
   if (ghVersion.error || ghVersion.status !== 0) {
     add({
@@ -153,16 +161,62 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   }
 
   add({
-    name: "GitHub Models 활성화", label: "GitHub Models", purpose: "AI 릴리스 노트 생성", status: "INFO",
+    name: "Copilot AI 요약", label: "Copilot AI 요약", purpose: "AI 릴리스 노트 생성(선택)", status: "INFO",
     note: [
-      "조직 정책으로 차단됐는지는 자동으로 확인할 수 없습니다 (Settings → Models).",
-      "차단돼 있어도 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.",
+      "기본은 꺼져 있습니다 (version.yml의 copilot_ai: false).",
+      "켜면 GitHub Copilot AI Credits가 소비됩니다 — 조직은 'Allow use of Copilot CLI billed to the organization' 정책이 필요합니다.",
+      "꺼져 있거나 사용할 수 없으면 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.",
     ],
   });
 
   return results;
 }
 
+const PLATFORM_ROW_NAME = { android: "Flutter Android 배포 파일", ios: "Flutter iOS 배포 파일" };
+const PLACEHOLDER_RE = /__[A-Z][A-Z0-9_]*__/g; // 감지 규칙은 ExportOptions.plist 템플릿·IOS-TESTFLIGHT 검증과 동일
+const EXPORT_OPTIONS_REL = STORE_APP_FILES.ios.find((rel) => rel.endsWith("ExportOptions.plist"));
+
+// Flutter 스토어 배포 진단 — 선택한 플랫폼의 필수 파일과 ExportOptions.plist 플레이스홀더 (이슈 #131).
+// 스토어 시크릿 등록 여부는 이번 범위 밖이다. 반환: doctor 결과 행 배열.
+function flutterStoreChecks(cwd) {
+  const existing = parseExisting(readFileSync(join(cwd, PATHS.versionFile), "utf8"));
+  if (!existing.types.includes("flutter")) return [];
+  const saved = existing.options.flutterStore == null ? null : parseStoreList(existing.options.flutterStore);
+  // 저장값 없는 기존 설치는 설치된 스토어 워크플로우로 추론한다 (interactive와 같은 규칙).
+  const stores = saved ?? inferInstalledStores(join(cwd, PATHS.workflowsDir));
+  const flutterRoot = existing.paths.get("flutter") || ".";
+  const rows = [];
+
+  for (const platform of STORE_PLATFORMS.filter((p) => stores.includes(p))) {
+    const files = storeAppFilesFor([platform]).map((rel) => posix.join(flutterRoot, rel));
+    const missing = files.filter((file) => !existsSync(join(cwd, file)));
+    const head = { name: PLATFORM_ROW_NAME[platform], purpose: "fastlane 스토어 업로드에 필요한 파일" };
+    rows.push(missing.length
+      ? {
+        ...head, status: "WARN", value: `없는 파일: ${missing.join(", ")}`,
+        impact: ["이 파일이 없으면 스토어 배포 워크플로우가 fastlane 단계에서 실패합니다."],
+        actions: ["마법사를 다시 실행하면 없는 파일만 새로 만들어 줍니다 (이미 있는 파일은 덮어쓰지 않음)"],
+        doc: DOC.flutterStore,
+      }
+      : { ...head, status: "OK", value: `${files.length}개 있음` });
+  }
+
+  const plistPath = posix.join(flutterRoot, EXPORT_OPTIONS_REL);
+  if (stores.includes("ios") && existsSync(join(cwd, plistPath))) {
+    const head = { name: "ExportOptions.plist", purpose: "iOS 서명·내보내기 설정" };
+    const left = [...new Set(readFileSync(join(cwd, plistPath), "utf8").match(PLACEHOLDER_RE) ?? [])];
+    rows.push(left.length
+      ? {
+        ...head, status: "WARN", value: `채워지지 않은 값: ${left.join(", ")}`,
+        impact: ["채우지 않으면 IOS-TESTFLIGHT 워크플로우가 ExportOptions.plist 검증 단계에서 중단됩니다."],
+        actions: [`${plistPath} 의 플레이스홀더를 실제 값(Team ID · 번들 ID · 프로비저닝 프로파일 이름)으로 바꾸세요`],
+        doc: DOC.flutterStore,
+      }
+      : { ...head, status: "OK", value: "플레이스홀더 없음" });
+  }
+  return rows;
+}
+
 const asLines = (v) => (Array.isArray(v) ? v : v ? [String(v)] : []);
 const headOf = (r) => `${r.label || r.name}${r.purpose ? ` — ${r.purpose}` : ""}`;
 

package/src/commands/dry-run.js

@@ -4,6 +4,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { PATHS } from "../core/paths.js";
 import { planWorkflows } from "../core/copy/workflows.js";
+import { planFlutterAppFiles } from "../core/copy/flutter-app.js";
 import { planUninstall } from "./uninstall.js";
 import { renderVersionYml, parseExisting } from "../core/version-yml.js";
 import { readVersionYmlTemplate } from "../core/assets.js";
@@ -33,6 +34,8 @@ export function planDryRun(mode, context, payloadRoot, targetRoot = ".") {
   return {
     mode,
     workflows: planWorkflows(context, payloadRoot, targetRoot),
+    // Flutter 스토어 배포 파일(Fastfile·ExportOptions.plist) — 이미 있는 파일은 덮어쓰지 않고 유지한다.
+    flutterApp: planFlutterAppFiles(context, payloadRoot, targetRoot),
     versionYml: versionYmlPreview(context, payloadRoot, targetRoot),
   };
 }
@@ -57,6 +60,13 @@ export function printDryRun(plan) {
       for (const f of w.changed) lines.push(`  ~ ${f.filename} [${f.type}]`);
       lines.push(`동일한 파일 (${w.unchanged.length}개, 변경 없음)`);
     }
+    if (plan.flutterApp && (plan.flutterApp.created.length || plan.flutterApp.kept.length)) {
+      const { created, kept } = plan.flutterApp;
+      lines.push(`Flutter 스토어 배포 파일 — 신규 (${created.length}개):`);
+      for (const f of created) lines.push(`  + ${f}`);
+      lines.push(`Flutter 스토어 배포 파일 — 기존 파일 유지 (${kept.length}개, 덮어쓰지 않음):`);
+      for (const f of kept) lines.push(`  = ${f} (기존 파일 유지)`);
+    }
     if (plan.versionYml) {
       lines.push(plan.versionYml.existed
         ? (plan.versionYml.changed ? "version.yml: 갱신될 예정" : "version.yml: 변경 없음")

package/src/commands/full.js

@@ -1,5 +1,5 @@
 // full 모드 오케스트레이터 (.sh execute_integration full case 등가).
-// 복사 순서: workflows(+env 치환) → version.yml → readme → scripts → gitignore(조건부)
+// 복사 순서: workflows(+env 치환) → flutter 앱 파일 → version.yml → readme → scripts → gitignore(조건부)
 // gitignore는 충돌 백업 부산물(.bak/.template.yaml)이 이번 실행에서 실제로 생겼을 때만 갱신한다 — issue #7.
 // (원본의 util/issue/discussion/setup-guide/config 설치는 project-auto-wizard 스코프에서 제외 — DESIGN-SPEC §2)
 import { join } from "node:path";
@@ -12,10 +12,12 @@ import { existingMarkerInDir } from "../core/paths-resolve.js";
 import { addVersionSectionToReadme } from "../core/copy/readme.js";
 import { copyWorkflows, computeBaselineEntries, makeSrcText } from "../core/copy/workflows.js";
 import { copyScripts } from "../core/copy/simple.js";
+import { copyFlutterAppFiles } from "../core/copy/flutter-app.js";
 import { ensureGitignore } from "../core/copy/gitignore.js";
 import { readBaseline, writeBaseline } from "../core/baseline.js";
 import { scanUnsubstituted, collectRequiredSecrets, narrowSecretsBySshAuth } from "../core/verify.js";
 import { cleanupOtherDeployWorkflows, DEFAULT_DEPLOY_STYLE } from "../core/deploy-style.js";
+import { cleanupDeselectedStoreWorkflows } from "../core/flutter-options.js";
 import { log, maskValue } from "../core/logger.js";
 
 // context: { version, types, paths:Map, branch, versionCode, includeNexus, includeSecretBackup,
@@ -47,6 +49,12 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   const wfCounters = copyWorkflows(context, payloadRoot, targetRoot, hooks);
   const deployValues = wfCounters.deployValues || new Map(); // Map<type, Map<key,value>>
 
+  // 1-1. Flutter 앱 파일(fastlane·ExportOptions) — 사용자가 값을 채워 쓰는 파일이라 없을 때만 만든다.
+  //      워크플로우 복사가 끝난 뒤에 실행한다(워크플로우가 이 파일들을 전제로 돈다).
+  const flutterApp = copyFlutterAppFiles(context, payloadRoot, targetRoot);
+  for (const f of flutterApp.created) log.info("flutter-app", "create", f);
+  for (const f of flutterApp.kept) log.info("flutter-app", "keep", `${f} (기존 파일 유지)`);
+
   // 기존 version.yml의 알려지지 않은 최상위 필드를 재생성 시 보존한다 (issue #20 M8).
   const vyPath = join(targetRoot, PATHS.versionFile);
   const extraTopLevel = existsSync(vyPath) ? parseExisting(readFileSync(vyPath, "utf8")).extraTopLevel : [];
@@ -80,7 +88,24 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
 
   for (const f of cleanup.removed || []) log.info("cleanup", "remove", `${f} (이전 배포 방식 정리)`);
   for (const f of cleanup.backedUp || []) log.info("cleanup", "backup", `${f} → ${f}.bak`);
-  const gitignoreUpdated = gitignoreUpdated0 || cleanup.backedUp.length > 0;
+
+  // 6-1. 선택 해제된 스토어 워크플로우 정리 — 스토어 대상을 줄여 재설치하면 이전 워크플로우가 남아
+  //      main push마다 계속 도는 것을 막는다. 규칙은 6과 같다(미수정 삭제, 수정본 .bak).
+  //      선택이 미결정(null)이거나 Flutter가 없으면 현행 동작 그대로 아무것도 지우지 않는다.
+  //      Fastfile·ExportOptions는 사용자 소유라 여기서 다루지 않는다.
+  const workflowsDir = join(targetRoot, PATHS.workflowsDir);
+  const storeCleanup = Array.isArray(context.flutterStore) && types.includes("flutter")
+    ? cleanupDeselectedStoreWorkflows(
+      workflowsDir,
+      existsSync(workflowsDir) ? readdirSync(workflowsDir) : [],
+      context.flutterStore,
+      previousBaseline)
+    : { removed: [], backedUp: [] };
+  for (const f of [...storeCleanup.removed, ...storeCleanup.backedUp]) delete previousBaseline?.files?.[f];
+  for (const f of storeCleanup.removed) log.info("cleanup", "remove", `${f} (선택 해제된 스토어 워크플로우 정리)`);
+  for (const f of storeCleanup.backedUp) log.info("cleanup", "backup", `${f} → ${f}.bak`);
+
+  const gitignoreUpdated = gitignoreUpdated0 || cleanup.backedUp.length > 0 || storeCleanup.backedUp.length > 0;
   if (gitignoreUpdated) ensureGitignore(targetRoot);
 
   // 7. baseline 기록 (issue #69) — 다음 업데이트에서 "누가 바꿨는지"를 가를 기준점.
@@ -122,7 +147,7 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
     ["결과", unresolved.length ? `주의 (미치환 ${unresolved.length}건)` : "OK"],
   ]);
 
-  return { workflows: wfCounters, gitignoreUpdated, unresolved, secrets, cleanup };
+  return { workflows: wfCounters, gitignoreUpdated, unresolved, secrets, cleanup, storeCleanup, flutterApp };
 }
 
 // deployValues는 Map<type, Map<key,value>> — 타입 구분 없이 첫 값만 필요할 때 쓴다.

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";
@@ -84,11 +88,27 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   let includeNexus = existing?.options?.nexus ?? false;
   let includeSecretBackup = existing?.options?.secretBackup ?? false;
   let includeSemverAuto = existing?.options?.semverAuto ?? null;
+  let includeCopilotAi = existing?.options?.copilotAi ?? null;
   // 서버 배포 방식 — 저장값(version.yml)이 있으면 재질문하지 않는다 (nexus/secret_backup과 같은 규약).
   let deployStyle = isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : "";
   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,17 +145,27 @@ 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) {
       const y2 = await io.askYesNo("자동 버전 승격을 사용하시겠습니까? (커밋 타입에 따라 major/minor/patch 자동 결정)", true);
       includeSemverAuto = y2 === true;
     }
+
+    // Copilot AI 요약 — AI Credits를 소비하므로 opt-in(기본 No). 저장값 있으면 재질문 생략.
+    if (mode === "full" && includeCopilotAi === null) {
+      const y3 = await io.askYesNo("Copilot으로 AI 요약을 생성하시겠습니까? (GitHub Copilot AI Credits가 소비되며, 사용할 수 없으면 자동으로 규칙 기반 요약으로 전환됩니다)", false);
+      includeCopilotAi = y3 === true;
+    }
   }
   // 질문이 실제로 나온 경우(위 full 모드 질문) 답변을 그대로 존중.
   // 질문이 안 나온 경우(version/workflows 모드) — 기존 설치는 안전하게 false로 폴백,
   // 완전 신규 설치만 true(기존 설계) 유지 — CLI 경로(index.js)와 동일한 안전 정책.
   includeSemverAuto = includeSemverAuto === null ? (existing ? false : true) : includeSemverAuto !== false;
+  includeCopilotAi = includeCopilotAi === true;
 
   // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
   let paths = new Map();
@@ -143,9 +173,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 +184,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 +210,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 +268,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;
@@ -243,10 +286,13 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     mode, force: true, types, version, versionCode, branch, branches, paths,
     includeNexus, includeSecretBackup,
     includeSemverAuto,
+    includeCopilotAi,
     repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
     // 설치 로그(#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 +355,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 +383,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 +393,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,9 @@ 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 copilotAiLabel = boolLabel(status.options.copilotAi ?? null);
+  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} copilot_ai=${copilotAiLabel}${flutterLabels}`);
   if (status.modifiedFiles.length) {
     lines.push("", `사용자가 수정한 워크플로우 파일 (${status.modifiedFiles.length}개):`);
     for (const f of status.modifiedFiles) lines.push(`  - ${f}`);
@@ -82,3 +91,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,13 @@ export function createContext(overrides = {}) {
     includeNexus: null,      // null=미설정, true/false=명시
     includeSecretBackup: null,
     includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
+    includeCopilotAi: null,  // null=미설정(다운스트림에서 false로 해석), true/false=명시 — Copilot AI 요약 opt-in
+    // 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;
+}