project-auto-wizard 0.9.1 → 0.11.0

package/payload/workflows/spring/nexus/PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH.yml

@@ -35,6 +35,7 @@ on:
     branches: ["{{MAIN_BRANCH}}"]
     tags:
       - 'v*.*.*'
+    # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
   workflow_dispatch:
 
 concurrency:

package/payload/workflows/spring/nexus/PROJECT-SPRING-NEXUS-CI.yml

@@ -26,11 +26,39 @@ permissions:
 
 env:
   JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:@jdk
+  # 모노레포에서 이 프로젝트가 있는 하위 경로 ('.'이면 항상 검증)
+  PROJECT_PATH: "."  # @wizard auto:project-path
 
 jobs:
+  # ===================================================================
+  # 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
+  # ===================================================================
+  changes:
+    name: 변경 감지
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      project: ${{ steps.filter.outputs.project }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: 프로젝트 경로 변경 여부 판별
+        id: filter
+        if: ${{ github.event_name != 'workflow_dispatch' }}
+        uses: dorny/paths-filter@v4
+        with:
+          filters: |
+            project:
+              - '${{ env.PROJECT_PATH == '.' && '**' || format('{0}/**', env.PROJECT_PATH) }}'
+
   build-check:
     name: Build Verification
     runs-on: ubuntu-latest
+    needs: changes
+    if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
     
     steps:
     - name: Checkout Repository
@@ -318,3 +346,22 @@ jobs:
       run: |
         echo "❌ 빌드가 실패했습니다. 위의 에러 메시지를 확인해주세요."
         exit 1
+
+  # ===================================================================
+  # CI Gate (required check로 등록할 단일 job)
+  # ===================================================================
+  ci-gate:
+    name: CI Gate
+    if: ${{ always() }}
+    needs: [changes, build-check]
+    runs-on: ubuntu-latest
+    steps:
+      - name: 결과 집계
+        env:
+          RESULTS: ${{ toJSON(needs.*.result) }}
+        run: |
+          echo "needs 결과: $RESULTS"
+          if echo "$RESULTS" | grep -Eq '"(failure|cancelled)"'; then
+            echo "실패하거나 취소된 job이 있습니다."
+            exit 1
+          fi

package/payload/workflows/spring/nexus/PROJECT-SPRING-NEXUS-PUBLISH.yml

@@ -15,6 +15,7 @@ on:
     branches: ["{{MAIN_BRANCH}}"]
     tags:
       - 'v*.*.*'
+    # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
 
 concurrency:
   group: nexus-publish-${{ github.ref }}

package/payload/workflows/spring/server-deploy/PROJECT-SPRING-PR-PREVIEW.yaml

@@ -15,9 +15,9 @@
 # ===================================================================
 #
 # 🚀 사용법:
-#   @suh-lab server build    - PR/Issue 빌드 및 배포
-#   @suh-lab server destroy  - Preview 환경 삭제
-#   @suh-lab server status   - 현재 상태 확인
+#   /wizard server build    - PR/Issue 빌드 및 배포
+#   /wizard server destroy  - Preview 환경 삭제
+#   /wizard server status   - 현재 상태 확인
 #
 # 📊 리소스 네이밍 규칙:
 #   - 컨테이너: {PROJECT_NAME}-pr-{PR번호}
@@ -65,7 +65,7 @@ env:
 
   # Issue Helper 댓글 마커 (프로젝트별 수정 필요)
   # Issue 댓글에서 브랜치명을 추출할 때 사용
-  ISSUE_HELPER_MARKER: 'Guide by SUH-LAB'
+  ISSUE_HELPER_MARKER: '<!-- project-auto-wizard issue helper -->'
 
   # Health Check 설정 (프로젝트별 수정 필요)
   # - HEALTH_CHECK_PATH: HTTP Health Check 경로 (빈값이면 HTTP 체크 건너뜀)
@@ -115,7 +115,7 @@ jobs:
       is_custom_branch: ${{ steps.parse.outputs.is_custom_branch }}
     steps:
       - name: 댓글에 👀 리액션 추가
-        if: contains(github.event.comment.body, '@suh-lab') && contains(github.event.comment.body, 'server')
+        if: contains(github.event.comment.body, '/wizard') && contains(github.event.comment.body, 'server')
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
@@ -143,8 +143,8 @@ jobs:
           fi
 
           # 명령어 파싱 (브랜치 파라미터 지원)
-          # 형식: @suh-lab server <command> [브랜치명]
-          if [[ "$COMMENT" =~ @suh-lab[[:space:]]+server[[:space:]]+build([[:space:]]+([^[:space:]]+))? ]]; then
+          # 형식: /wizard server <command> [브랜치명]
+          if [[ "$COMMENT" =~ /wizard[[:space:]]+server[[:space:]]+build([[:space:]]+([^[:space:]]+))? ]]; then
             echo "command=build" >> $GITHUB_OUTPUT
             echo "is_valid=true" >> $GITHUB_OUTPUT
             if [[ -n "${BASH_REMATCH[2]}" ]]; then
@@ -155,7 +155,7 @@ jobs:
               echo "is_custom_branch=false" >> $GITHUB_OUTPUT
               echo "✅ 명령어 감지: build"
             fi
-          elif [[ "$COMMENT" =~ @suh-lab[[:space:]]+server[[:space:]]+destroy([[:space:]]+([^[:space:]]+))? ]]; then
+          elif [[ "$COMMENT" =~ /wizard[[:space:]]+server[[:space:]]+destroy([[:space:]]+([^[:space:]]+))? ]]; then
             echo "command=destroy" >> $GITHUB_OUTPUT
             echo "is_valid=true" >> $GITHUB_OUTPUT
             if [[ -n "${BASH_REMATCH[2]}" ]]; then
@@ -166,7 +166,7 @@ jobs:
               echo "is_custom_branch=false" >> $GITHUB_OUTPUT
               echo "✅ 명령어 감지: destroy"
             fi
-          elif [[ "$COMMENT" =~ @suh-lab[[:space:]]+server[[:space:]]+status([[:space:]]+([^[:space:]]+))? ]]; then
+          elif [[ "$COMMENT" =~ /wizard[[:space:]]+server[[:space:]]+status([[:space:]]+([^[:space:]]+))? ]]; then
             echo "command=status" >> $GITHUB_OUTPUT
             echo "is_valid=true" >> $GITHUB_OUTPUT
             if [[ -n "${BASH_REMATCH[2]}" ]]; then
@@ -179,7 +179,7 @@ jobs:
             fi
           else
             echo "is_valid=false" >> $GITHUB_OUTPUT
-            echo "ℹ️ @suh-lab server 명령어가 아님"
+            echo "ℹ️ /wizard server 명령어가 아님"
           fi
 
   # -----------------------------------------------------------------
@@ -292,13 +292,13 @@ jobs:
       #   env:
       #     VERTEX_SA_KEY: ${{ secrets.VERTEX_SA_KEY }}
       #   run: |
-      #     echo "$VERTEX_SA_KEY" | sed 's/\\n/\n/g' > ./Suh-Web/src/main/resources/vertex-ai-key.json
+      #     echo "$VERTEX_SA_KEY" | sed 's/\\n/\n/g' > ./<모듈명>/src/main/resources/vertex-ai-key.json
 
       # - name: "[선택] Firebase Admin SDK 생성"
       #   env:
       #     FIREBASE_KEY_JSON: ${{ secrets.FIREBASE_KEY_JSON }}
       #   run: |
-      #     echo "$FIREBASE_KEY_JSON" | sed 's/\\n/\n/g' > ./Suh-Web/src/main/resources/firebase-admin-sdk.json
+      #     echo "$FIREBASE_KEY_JSON" | sed 's/\\n/\n/g' > ./<모듈명>/src/main/resources/firebase-admin-sdk.json
 
       # =================================================================
       # ⚠️ [영역 2 끝] 프로젝트별 Secret 파일 생성 끝
@@ -606,17 +606,17 @@ jobs:
               '### 📋 명령어',
               '| 명령어 | 설명 |',
               '|--------|------|',
-              '| `@suh-lab server build` | 최신 커밋으로 재배포 |',
-              '| `@suh-lab server destroy` | Preview 환경 삭제 |',
-              '| `@suh-lab server status` | 현재 상태 확인 |',
+              '| `/wizard server build` | 최신 커밋으로 재배포 |',
+              '| `/wizard server destroy` | Preview 환경 삭제 |',
+              '| `/wizard server status` | 현재 상태 확인 |',
               '',
               '<details>',
               '<summary>🔧 고급 명령어 (다른 Issue/PR에서 제어)</summary>',
               '',
               '```',
-              `@suh-lab server build ${branchName}`,
-              `@suh-lab server destroy ${branchName}`,
-              `@suh-lab server status ${branchName}`,
+              `/wizard server build ${branchName}`,
+              `/wizard server destroy ${branchName}`,
+              `/wizard server status ${branchName}`,
               '```',
               '</details>',
               '',
@@ -693,7 +693,7 @@ jobs:
               '',
               '### 💡 다음 단계',
               '1. 위 링크에서 빌드/배포 로그를 확인하세요',
-              '2. 문제를 수정한 후 다시 시도하세요: `@suh-lab server build`',
+              '2. 문제를 수정한 후 다시 시도하세요: `/wizard server build`',
               '',
               '---',
               '*🤖 이 댓글은 PR Preview 시스템에 의해 자동 생성되었습니다.*'
@@ -1278,17 +1278,17 @@ jobs:
               '### 📋 명령어',
               '| 명령어 | 설명 |',
               '|--------|------|',
-              '| `@suh-lab server build` | 최신 커밋으로 재배포 |',
-              '| `@suh-lab server destroy` | Preview 환경 삭제 |',
-              '| `@suh-lab server status` | 현재 상태 확인 |',
+              '| `/wizard server build` | 최신 커밋으로 재배포 |',
+              '| `/wizard server destroy` | Preview 환경 삭제 |',
+              '| `/wizard server status` | 현재 상태 확인 |',
               '',
               '<details>',
               '<summary>🔧 고급 명령어 (다른 Issue/PR에서 제어)</summary>',
               '',
               '```',
-              `@suh-lab server build ${branchName}`,
-              `@suh-lab server destroy ${branchName}`,
-              `@suh-lab server status ${branchName}`,
+              `/wizard server build ${branchName}`,
+              `/wizard server destroy ${branchName}`,
+              `/wizard server status ${branchName}`,
               '```',
               '</details>',
               '',
@@ -1362,7 +1362,7 @@ jobs:
               '',
               '### 💡 다음 단계',
               '1. 위 링크에서 빌드/배포 로그를 확인하세요',
-              '2. 문제를 수정한 후 다시 시도하세요: `@suh-lab server build`',
+              '2. 문제를 수정한 후 다시 시도하세요: `/wizard server build`',
               '',
               '---',
               '*🤖 이 댓글은 Issue Preview 시스템에 의해 자동 생성되었습니다.*'
@@ -1393,7 +1393,7 @@ jobs:
     if: |
       (github.event_name == 'pull_request' && github.event.action == 'closed') ||
       (github.event_name == 'issues' && github.event.action == 'closed') ||
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@suh-lab') && contains(github.event.comment.body, 'server destroy'))
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '/wizard') && contains(github.event.comment.body, 'server destroy'))
     runs-on: ubuntu-latest
     steps:
       - name: PR/Issue 번호 가져오기
@@ -1474,7 +1474,7 @@ jobs:
               `| **컨테이너** | \`${projectName}-pr-${number}\` |`,
               '| **상태** | 삭제됨 |',
               '',
-              '다시 배포하려면: `@suh-lab server build`',
+              '다시 배포하려면: `/wizard server build`',
               '',
               '---',
               '*🤖 이 댓글은 PR/Issue Preview 시스템에 의해 자동 생성되었습니다.*'
@@ -1573,8 +1573,8 @@ jobs:
                 '### 📋 명령어',
                 '| 명령어 | 설명 |',
                 '|--------|------|',
-                '| `@suh-lab server build` | 최신 커밋으로 재배포 |',
-                '| `@suh-lab server destroy` | Preview 환경 삭제 |',
+                '| `/wizard server build` | 최신 커밋으로 재배포 |',
+                '| `/wizard server destroy` | Preview 환경 삭제 |',
                 '',
                 '---',
                 `*🤖 이 댓글은 ${contextType} Preview 시스템에 의해 자동 생성되었습니다.*`
@@ -1588,7 +1588,7 @@ jobs:
                 `| **컨테이너** | \`${projectName}-pr-${number}\` |`,
                 '| **상태** | 🔴 Not Found |',
                 '',
-                '배포하려면: `@suh-lab server build`',
+                '배포하려면: `/wizard server build`',
                 '',
                 '---',
                 `*🤖 이 댓글은 ${contextType} Preview 시스템에 의해 자동 생성되었습니다.*`
@@ -1605,7 +1605,7 @@ jobs:
   # ============================================================
   # Custom Branch Preview Jobs
   # 특정 브랜치를 지정하여 빌드/삭제/상태 확인하는 기능
-  # 명령어: @suh-lab server build <브랜치명>
+  # 명령어: /wizard server build <브랜치명>
   # ============================================================
 
   build-preview-custom-branch:
@@ -1984,9 +1984,9 @@ jobs:
               '### 📋 명령어',
               '| 명령어 | 설명 |',
               '|--------|------|',
-              `| \`@suh-lab server build ${branchName}\` | 최신 커밋으로 재배포 |`,
-              `| \`@suh-lab server destroy ${branchName}\` | Preview 환경 삭제 |`,
-              `| \`@suh-lab server status ${branchName}\` | 현재 상태 확인 |`,
+              `| \`/wizard server build ${branchName}\` | 최신 커밋으로 재배포 |`,
+              `| \`/wizard server destroy ${branchName}\` | Preview 환경 삭제 |`,
+              `| \`/wizard server status ${branchName}\` | 현재 상태 확인 |`,
               '',
               '---',
               '*🤖 이 댓글은 Preview 시스템에 의해 자동 생성되었습니다.*'
@@ -2154,7 +2154,7 @@ jobs:
               `| **브랜치** | \`${branchName}\` |`,
               `| **컨테이너** | \`${containerName}\` |`,
               '',
-              `다시 배포하려면: \`@suh-lab server build ${branchName}\``,
+              `다시 배포하려면: \`/wizard server build ${branchName}\``,
               '',
               '---',
               '*🤖 이 댓글은 Preview 시스템에 의해 자동 생성되었습니다.*'
@@ -2247,8 +2247,8 @@ jobs:
                 '### 📋 명령어',
                 '| 명령어 | 설명 |',
                 '|--------|------|',
-                `| \`@suh-lab server build ${branchName}\` | 최신 커밋으로 재배포 |`,
-                `| \`@suh-lab server destroy ${branchName}\` | Preview 환경 삭제 |`,
+                `| \`/wizard server build ${branchName}\` | 최신 커밋으로 재배포 |`,
+                `| \`/wizard server destroy ${branchName}\` | Preview 환경 삭제 |`,
                 '',
                 '---',
                 '*🤖 이 댓글은 Preview 시스템에 의해 자동 생성되었습니다.*'
@@ -2263,7 +2263,7 @@ jobs:
                 `| **컨테이너** | \`${containerName}\` |`,
                 '| **상태** | 🔴 Not Found |',
                 '',
-                `배포하려면: \`@suh-lab server build ${branchName}\``,
+                `배포하려면: \`/wizard server build ${branchName}\``,
                 '',
                 '---',
                 '*🤖 이 댓글은 Preview 시스템에 의해 자동 생성되었습니다.*'

package/src/cli/args.js

@@ -1,6 +1,9 @@
 // CLI 인자 파싱 (.sh top-level while-case 등가) — template_integrator.sh 842~920.
 import { VALID_TYPES, VALID_MODES } from "../context.js";
 import { DEPLOY_STYLES, isDeployStyle, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
+import {
+  ENV_MODES, DEPLOY_MODES, STORE_PLATFORMS, NO_STORE, isEnvMode, isDeployMode, parseStoreList,
+} from "../core/flutter-options.js";
 
 // argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
 export function parseArgs(argv) {
@@ -16,6 +19,10 @@ export function parseArgs(argv) {
     mainBranch: "",          // 릴리스 브랜치 (--main-branch). 빈값=감지된 default branch
     developBranch: "",       // 개발 브랜치 (--develop-branch). 빈값=develop
     deployStyle: "",         // 서버 배포 방식 (--deploy-style). 빈값=version.yml 저장값 → simple
+    flutterEnvMode: "",      // Flutter 환경변수 방식 (--flutter-env-mode). 빈값=저장값 → 신규 dart-define/기존 dotenv
+    flutterStore: null,      // Flutter 스토어 배포 대상 string[] (--flutter-store). null=미지정, none → []
+    androidDeployMode: "",   // Play Store 배포 모드 (--android-deploy-mode). 빈값=저장값 → store_only
+    iosDeployMode: "",       // iOS 배포 모드 (--ios-deploy-mode). 빈값=저장값 → store_only
     force: false,
     help: false,
     showVersion: false,      // -v/--version → 패키지 버전 출력 (npm 관례)
@@ -84,6 +91,36 @@ export function parseArgs(argv) {
         }
         result.deployStyle = v; break;
       }
+      case "--flutter-env-mode": {
+        const v = args.shift();
+        if (!isEnvMode(v)) {
+          throw new CliError(`--flutter-env-mode 값이 올바르지 않습니다: ${v ?? "(없음)"} (${ENV_MODES.join(" | ")})`);
+        }
+        result.flutterEnvMode = v; break;
+      }
+      case "--flutter-store": {
+        const v = args.shift();
+        // 빈 문자열은 parseStoreList가 []로 보지만, 스토어를 안 고르겠다는 뜻은 명시적인 none으로만 받는다.
+        const stores = v ? parseStoreList(v) : null;
+        if (stores === null) {
+          throw new CliError(`--flutter-store 값이 올바르지 않습니다: ${v || "(없음)"} (${[STORE_PLATFORMS.join(","), ...STORE_PLATFORMS, NO_STORE].join(" | ")})`);
+        }
+        result.flutterStore = stores; break;
+      }
+      case "--android-deploy-mode": {
+        const v = args.shift();
+        if (!isDeployMode(v)) {
+          throw new CliError(`--android-deploy-mode 값이 올바르지 않습니다: ${v ?? "(없음)"} (${DEPLOY_MODES.join(" | ")})`);
+        }
+        result.androidDeployMode = v; break;
+      }
+      case "--ios-deploy-mode": {
+        const v = args.shift();
+        if (!isDeployMode(v)) {
+          throw new CliError(`--ios-deploy-mode 값이 올바르지 않습니다: ${v ?? "(없음)"} (${DEPLOY_MODES.join(" | ")})`);
+        }
+        result.iosDeployMode = v; break;
+      }
       case "--nexus":
         if (seenFlags.has("--no-nexus")) throw new CliError("--nexus와 --no-nexus는 동시에 지정할 수 없습니다");
         seenFlags.add("--nexus"); result.includeNexus = true; break;

package/src/cli/help.js

@@ -17,6 +17,10 @@ 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 승격 (기본: 사용함)

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({
@@ -163,6 +171,51 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   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>> — 타입 구분 없이 첫 값만 필요할 때 쓴다.