project-auto-wizard 0.10.0 → 0.11.0

package/payload/workflows/flutter/PROJECT-FLUTTER-IOS-TESTFLIGHT.yaml

@@ -5,17 +5,14 @@
 #
 # 이 워크플로우는 Flutter iOS 앱을 빌드하여 TestFlight에 자동 배포합니다.
 #
-# ★ 마법사 우선 아키텍처 ★
-# - 빌드에 필요한 설정 파일들은 웹 마법사가 생성합니다
-# - 워크플로우는 마법사가 생성한 파일들을 그대로 사용합니다
-# - 마법사 경로: .github/util/flutter/ios-testflight-setup-wizard/index.html
-#   (브라우저에서 열어서 사용)
+# 설정 파일(ios/fastlane/Fastfile, ios/ExportOptions.plist)은 project-auto-wizard가
+# 없을 때만 설치하며, 이미 있으면 덮어쓰지 않습니다.
 #
 # 빌드 파이프라인:
 #   1. flutter build ios --no-codesign (Flutter 빌드)
 #   2. xcodebuild archive (Xcode 아카이브 생성)
 #   3. xcodebuild -exportArchive (IPA 생성, ExportOptions.plist 사용)
-#   4. fastlane deploy (마법사 생성 Fastfile 사용, DEPLOY_MODE에 따라 TestFlight/심사 제출)
+#   4. fastlane deploy (ios/fastlane/Fastfile 사용, DEPLOY_MODE에 따라 TestFlight/심사 제출)
 #
 # ===================================================================
 # 🔑 필수 GitHub Secrets
@@ -31,6 +28,8 @@
 # APP_STORE_CONNECT_API_KEY_ID: API Key ID (10자리)
 # APP_STORE_CONNECT_ISSUER_ID: Issuer ID (UUID 형식)
 # APP_STORE_CONNECT_API_KEY_BASE64: AuthKey_XXXXXX.p8 파일 (base64 인코딩)
+# IOS_BUNDLE_ID (Secret 우선, 없으면 Variable): 앱 번들 ID —
+#   store_prepare/store_submit을 쓰면 필수(비어 있으면 Fastfile이 명확한 오류로 중단)
 #
 # 📝 환경 설정 (선택):
 # ENV_FILE (선택): .env 파일 내용
@@ -40,17 +39,13 @@
 # 🛠️ 초기 설정 방법
 # ===================================================================
 #
-# 1. 웹 마법사 실행:
-#    브라우저에서 .github/util/flutter/ios-testflight-setup-wizard/index.html 열기
-#    → 필요한 정보 입력 후 설정 파일 다운로드
+# 1. GitHub Secrets 설정 (위 목록 참고)
 #
-# 2. GitHub Secrets 설정 (위 목록 참고)
-#
-# 3. 생성된 파일 커밋:
+# 2. ios/ExportOptions.plist의 플레이스홀더(팀 ID·번들 ID·프로비저닝 프로파일 이름)를 채워 커밋:
 #    git add ios/
 #    git commit -m "chore: iOS TestFlight 배포 설정"
 #
-# 4. {{MAIN_BRANCH}} 브랜치로 푸시하여 배포 시작
+# 3. {{MAIN_BRANCH}} 브랜치로 푸시하여 배포 시작
 #
 # ===================================================================
 
@@ -59,6 +54,7 @@ name: PROJECT-iOS-TestFlight-Deploy
 on:
   push:
     branches: ["{{MAIN_BRANCH}}"]
+    # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
   workflow_dispatch:
     inputs:
       deploy_mode:
@@ -76,6 +72,8 @@ on:
 # ============================================
 env:
   FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
+  # 환경변수 전달 방식 (dart-define | dotenv) — 설치 시 선택값으로 자동 설정
+  ENV_MODE: "dart-define"  # @wizard auto:flutter-env-mode
   FLUTTER_VERSION: "3.35.5"
   XCODE_VERSION: "26.0"
   PROJECT_TYPE: "flutter"
@@ -83,7 +81,7 @@ env:
   # ============================================
   # 📝 환경 파일 설정
   # ============================================
-  # .env 파일 생성 경로 (프로젝트 루트 기준)
+  # dotenv 모드에서 .env 파일을 만들 경로 (Flutter 루트 기준)
   ENV_FILE_PATH: ".env"
 
   # ============================================
@@ -94,7 +92,7 @@ env:
   # ============================================
   # 📝 배포 모드 (store_only | store_prepare | store_submit)
   # ============================================
-  DEPLOY_MODE: ${{ github.event.inputs.deploy_mode || vars.IOS_DEPLOY_MODE || 'store_only' }}
+  DEPLOY_MODE: ${{ github.event.inputs.deploy_mode || vars.IOS_DEPLOY_MODE || 'store_only' }}  # @wizard fallback:ios-deploy-mode
 
 jobs:
   prepare-build:
@@ -123,12 +121,19 @@ jobs:
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
 
-      - name: Create .env file
+      - name: Prepare env file
+        env:
+          ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
         run: |
-          cat << 'EOF' > ${{ env.ENV_FILE_PATH }}
-          ${{ secrets.ENV_FILE || secrets.ENV }}
-          EOF
-          echo "✅ ${{ env.ENV_FILE_PATH }} file created"
+          if [ "$ENV_MODE" = "dotenv" ]; then
+            printf '%s\n' "$ENV_CONTENT" > "$ENV_FILE_PATH"
+            echo "✅ $ENV_FILE_PATH file created"
+          elif [ -n "$ENV_CONTENT" ]; then
+            DART_DEFINE_FILE="$RUNNER_TEMP/dart-define.env"
+            printf '%s\n' "$ENV_CONTENT" > "$DART_DEFINE_FILE"
+            echo "DART_DEFINE_FILE=$DART_DEFINE_FILE" >> "$GITHUB_ENV"
+            echo "dart-define file prepared"
+          fi
 
       - name: Create Secrets.xcconfig file
         run: |
@@ -150,7 +155,7 @@ jobs:
         uses: actions/cache@v6
         with:
           path: ~/.pub-cache
-          key: ${{ runner.os }}-flutter-pub-${{ hashFiles('**/pubspec.lock') }}
+          key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
@@ -218,11 +223,10 @@ jobs:
         with:
           name: project-files
           path: |
-            ${{ env.ENV_FILE_PATH }}
-            ios/Flutter/Secrets.xcconfig
-            pubspec.yaml
-            lib/
-            assets/
+            ${{ env.FLUTTER_PROJECT_DIR }}/ios/Flutter/Secrets.xcconfig
+            ${{ env.FLUTTER_PROJECT_DIR }}/pubspec.yaml
+            ${{ env.FLUTTER_PROJECT_DIR }}/lib/
+            ${{ env.FLUTTER_PROJECT_DIR }}/assets/
           retention-days: 1
           if-no-files-found: error
 
@@ -271,15 +275,20 @@ jobs:
         uses: actions/download-artifact@v8
         with:
           name: project-files
-          path: .
+          path: ${{ env.FLUTTER_PROJECT_DIR }}
 
-      - name: Ensure .env file exists
+      - name: Prepare env file
+        env:
+          ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
         run: |
-          if [ ! -f "${{ env.ENV_FILE_PATH }}" ]; then
-            cat << 'EOF' > ${{ env.ENV_FILE_PATH }}
-          ${{ secrets.ENV_FILE || secrets.ENV }}
-          EOF
-            echo "✅ ${{ env.ENV_FILE_PATH }} file created (fallback)"
+          if [ "$ENV_MODE" = "dotenv" ]; then
+            printf '%s\n' "$ENV_CONTENT" > "$ENV_FILE_PATH"
+            echo "✅ $ENV_FILE_PATH file created"
+          elif [ -n "$ENV_CONTENT" ]; then
+            DART_DEFINE_FILE="$RUNNER_TEMP/dart-define.env"
+            printf '%s\n' "$ENV_CONTENT" > "$DART_DEFINE_FILE"
+            echo "DART_DEFINE_FILE=$DART_DEFINE_FILE" >> "$GITHUB_ENV"
+            echo "dart-define file prepared"
           fi
 
       - name: Set up Flutter
@@ -292,7 +301,7 @@ jobs:
         uses: actions/cache@v6
         with:
           path: ~/.pub-cache
-          key: ${{ runner.os }}-flutter-pub-${{ hashFiles('**/pubspec.lock') }}
+          key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
@@ -333,6 +342,13 @@ jobs:
           if [ ! -f "ExportOptions.plist" ]; then
             exit 1
           fi
+          # 설치기가 만든 템플릿의 플레이스홀더를 채우지 않으면 xcodebuild가 이해하기 어려운 오류로 끝난다
+          if grep -Eq '__[A-Z][A-Z0-9_]*__' ExportOptions.plist; then
+            echo "❌ ios/ExportOptions.plist에 채워지지 않은 플레이스홀더가 남아 있습니다:"
+            grep -En '__[A-Z][A-Z0-9_]*__' ExportOptions.plist
+            echo "팀 ID·번들 ID·프로비저닝 프로파일 이름으로 바꿔 커밋한 뒤 다시 실행하세요."
+            exit 1
+          fi
 
       - name: Flutter build (no codesign)
         env:
@@ -341,7 +357,8 @@ jobs:
         run: |
           flutter build ios --release --no-codesign \
             --build-name="${{ needs.prepare-build.outputs.version }}" \
-            --build-number="${{ needs.prepare-build.outputs.build_number }}"
+            --build-number="${{ needs.prepare-build.outputs.build_number }}" \
+            ${DART_DEFINE_FILE:+--dart-define-from-file="$DART_DEFINE_FILE"}
 
       - name: Create Archive
         env:
@@ -376,7 +393,7 @@ jobs:
           if-no-files-found: error
 
   # ============================================
-  # TestFlight 배포 (마법사 생성 Fastfile 사용)
+  # TestFlight 배포 (ios/fastlane/Fastfile 사용)
   # ============================================
   deploy-testflight:
     name: TestFlight 배포
@@ -414,8 +431,7 @@ jobs:
         run: |
           if [ ! -f "ios/fastlane/Fastfile" ]; then
             echo "❌ ios/fastlane/Fastfile이 없습니다!"
-            echo "웹 마법사를 실행하여 설정 파일을 생성하세요:"
-            echo "  브라우저에서 .github/util/flutter/ios-testflight-setup-wizard/index.html 열기"
+            echo "ios/fastlane/Fastfile을 저장소에 추가(커밋)하세요. 필요한 Secrets는 워크플로우 상단 주석을 참고하세요."
             exit 1
           fi
           echo "✅ Fastfile 확인됨: ios/fastlane/Fastfile"
@@ -423,8 +439,13 @@ jobs:
       - name: Install Fastlane
         working-directory: ${{ env.FLUTTER_PROJECT_DIR }}/ios
         run: |
-          # multi_json: google-apis transitive 의존성이 선언 누락한 upstream 버그 회피 (gemspec 미선언 → Gem::LoadError)
-          printf 'source "https://rubygems.org"\ngem "fastlane"\ngem "multi_json"\n' > Gemfile
+          # 저장소의 Gemfile에 fastlane이 있으면 그대로 쓴다 (Gemfile.lock 커밋 권장). 없으면 생성한다.
+          if [ -f Gemfile ] && grep -Eq "['\"]fastlane['\"]" Gemfile; then
+            echo "ℹ️ 저장소의 Gemfile을 사용합니다"
+          else
+            # multi_json: google-apis transitive 의존성이 선언 누락한 upstream 버그 회피 (gemspec 미선언 → Gem::LoadError)
+            printf 'source "https://rubygems.org"\ngem "fastlane"\ngem "multi_json"\n' > Gemfile
+          fi
           bundle install
           echo "✅ Fastlane installed (Bundler)"
 

package/payload/workflows/go/PROJECT-GO-CI.yaml

@@ -30,14 +30,42 @@ on:
 env:
   # 프로젝트 고유 식별자
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
+  # 모노레포에서 이 프로젝트가 있는 하위 경로 ('.'이면 항상 검증)
+  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: Go 빌드 검증
     runs-on: ubuntu-latest
+    needs: changes
+    if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
 
     steps:
       # 1. 소스코드 체크아웃
@@ -80,3 +108,22 @@ jobs:
           echo "  🌿 브랜치: ${{ github.ref_name }}"
           echo "  📝 커밋: ${{ github.sha }}"
           echo "  ⏰ 검증 시간: $(date '+%Y-%m-%d %H:%M:%S')"
+
+  # ===================================================================
+  # 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/next/PROJECT-NEXT-CI.yaml

@@ -37,6 +37,8 @@ env:
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
   NODE_VERSION: "20.15.0"
   ENV_FILE: ".env"
+  # 모노레포에서 이 프로젝트가 있는 하위 경로 ('.'이면 항상 검증)
+  PROJECT_PATH: "."  # @wizard auto:project-path
 
 permissions:
   contents: read
@@ -44,9 +46,35 @@ permissions:
   issues: write
 
 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:
     name: Next.js 애플리케이션 빌드
     runs-on: ubuntu-latest
+    needs: changes
+    if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
 
     steps:
       # 1. 소스코드 체크아웃
@@ -184,3 +212,22 @@ jobs:
           echo "  🕐 시간: $(date '+%Y-%m-%d %H:%M:%S UTC')"
           echo ""
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+  # ===================================================================
+  # CI Gate (required check로 등록할 단일 job)
+  # ===================================================================
+  ci-gate:
+    name: CI Gate
+    if: ${{ always() }}
+    needs: [changes, build]
+    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/python/PROJECT-PYTHON-CI.yaml

@@ -29,14 +29,42 @@ on:
 env:
   # 프로젝트 고유 식별자 (컨테이너명, 이미지명, 도메인에 사용)
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
+  # 모노레포에서 이 프로젝트가 있는 하위 경로 ('.'이면 항상 검증)
+  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: Python FastAPI 빌드 검증
     runs-on: ubuntu-latest
+    needs: changes
+    if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
 
     steps:
       # 1. 소스코드 체크아웃
@@ -77,3 +105,22 @@ jobs:
           echo "  🌿 브랜치: ${{ github.ref_name }}"
           echo "  📝 커밋: ${{ github.sha }}"
           echo "  ⏰ 검증 시간: $(date '+%Y-%m-%d %H:%M:%S')"
+
+  # ===================================================================
+  # 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/react/PROJECT-REACT-CI.yaml

@@ -36,6 +36,8 @@ env:
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
   NODE_VERSION: "20.15.0"
   ENV_FILE: ".env"
+  # 모노레포에서 이 프로젝트가 있는 하위 경로 ('.'이면 항상 검증)
+  PROJECT_PATH: "."  # @wizard auto:project-path
 
 permissions:
   contents: read
@@ -43,9 +45,35 @@ permissions:
   issues: write
 
 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:
     name: React/Next.js 애플리케이션 빌드
     runs-on: ubuntu-latest
+    needs: changes
+    if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
 
     steps:
       # 1. 소스코드 체크아웃
@@ -193,3 +221,22 @@ jobs:
             echo "❌ 빌드 중 오류가 발생했습니다."
             echo "💡 Actions 탭에서 'build-log' 아티팩트를 다운로드하여 전체 로그를 확인하세요."
           fi
+
+  # ===================================================================
+  # CI Gate (required check로 등록할 단일 job)
+  # ===================================================================
+  ci-gate:
+    name: CI Gate
+    if: ${{ always() }}
+    needs: [changes, build]
+    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-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/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 승격 (기본: 사용함)