project-auto-wizard 0.9.1 → 0.11.0

package/payload/workflows/flutter/{PROJECT-FLUTTER-SUH-LAB-APP-BUILD-TRIGGER.yaml → PROJECT-FLUTTER-APP-BUILD-TRIGGER.yaml}

@@ -1,27 +1,27 @@
 # project-auto-wizard:managed-workflow
 # ===================================================================
-# Flutter 테스트 앱 빌드 트리거 워크플로우 (SUH-LAB)
+# Flutter 테스트 앱 빌드 트리거 워크플로우
 # ===================================================================
 #
 # 이 워크플로우는 PR 또는 이슈에 댓글로 빌드 명령어를 작성하면
 # Android와 iOS 테스트 앱 빌드를 자동으로 트리거합니다.
 #
 # 주요 특징:
-# - PR/이슈 댓글 감지: "@suh-lab app build / apk build / ios build" 키워드 감지 (어순 무관: build app 도 동작)
+# - PR/이슈 댓글 감지: "/wizard app build / apk build / ios build" 키워드 감지 (어순 무관: build app 도 동작)
 # - repository_dispatch 이벤트로 빌드 워크플로우 트리거
 # - PR/이슈 번호 + 빌드 횟수로 고유한 빌드 번호 생성 (예: 38700, 38701...)
 # - 브랜치명에서 이슈 번호 자동 추출 (YYYYMMDD_#이슈번호_내용 형식)
 # - 테스트 버전은 version.yml에서 동적으로 읽어 사용 (빌드 번호로 운영/테스트 구분)
 #
 # 사용 방법:
-# - PR에 댓글 작성: "@suh-lab app build" (Android + iOS 모두 빌드)
-# - PR에 댓글 작성: "@suh-lab apk build" (Android만 빌드)
-# - PR에 댓글 작성: "@suh-lab ios build" (iOS만 빌드)
-# - 이슈에 댓글 작성: 위 명령어 동일 (Guide by SUH-LAB 댓글 필요)
+# - PR에 댓글 작성: "/wizard app build" (Android + iOS 모두 빌드)
+# - PR에 댓글 작성: "/wizard apk build" (Android만 빌드)
+# - PR에 댓글 작성: "/wizard ios build" (iOS만 빌드)
+# - 이슈에 댓글 작성: 위 명령어 동일 (Issue Helper 댓글 필요)
 # - 어순은 무관: "build app" / "build apk" / "build ios"로 적어도 동일하게 동작
-# - 특정 브랜치 지정: "@suh-lab app build <브랜치명>" (명령어 뒤에 브랜치명을 적으면 해당 브랜치를 빌드)
-#   예: "@suh-lab apk build 20260609_#349_feature" → 해당 브랜치로 Android 빌드
-#   브랜치명을 생략하면 PR head 또는 이슈의 Guide by SUH-LAB 댓글 브랜치를 사용
+# - 특정 브랜치 지정: "/wizard app build <브랜치명>" (명령어 뒤에 브랜치명을 적으면 해당 브랜치를 빌드)
+#   예: "/wizard apk build 20260609_#349_feature" → 해당 브랜치로 Android 빌드
+#   브랜치명을 생략하면 PR head 또는 이슈의 Issue Helper 댓글 브랜치를 사용
 #
 # 트리거되는 워크플로우:
 # - PROJECT-FLUTTER-ANDROID-TEST-APK.yaml (event_type: build-android-app)
@@ -29,7 +29,7 @@
 #
 # ===================================================================
 
-name: PROJECT-Flutter-SUH-LAB-App-Build-Trigger
+name: PROJECT-Flutter-App-Build-Trigger
 
 on:
   issue_comment:
@@ -43,9 +43,9 @@ permissions:
 jobs:
   trigger-builds:
     name: 빌드 워크플로우 트리거
-    # @suh-lab app build / @suh-lab apk build / @suh-lab ios build 키워드 감지 (어순 무관)
+    # /wizard app build / /wizard apk build / /wizard ios build 키워드 감지 (어순 무관)
     if: |
-      contains(github.event.comment.body, '@suh-lab') &&
+      contains(github.event.comment.body, '/wizard') &&
       (
         (contains(github.event.comment.body, 'build') && contains(github.event.comment.body, 'app')) ||
         (contains(github.event.comment.body, 'apk') && contains(github.event.comment.body, 'build')) ||
@@ -93,27 +93,27 @@ jobs:
             // 어순은 양방향 지원: "{타입} build"(app/apk/ios build)와 "build {타입}"(build app 등) 모두 허용.
             // apk가 app으로 오인되지 않도록 app 토큰은 \b 단어경계로 정확히 끊는다(apk·application 제외).
             // apk/ios를 app보다 먼저 검사해, "apk build"가 app 분기로 새지 않게 한다.
-            if (comment.match(/@suh-lab[^\S\r\n]+apk[^\S\r\n]+build/) || comment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+apk/)) {
-              // @suh-lab apk build [브랜치] (또는 build apk) → Android만
+            if (comment.match(/\/wizard[^\S\r\n]+apk[^\S\r\n]+build/) || comment.match(/\/wizard[^\S\r\n]+build[^\S\r\n]+apk/)) {
+              // /wizard apk build [브랜치] (또는 build apk) → Android만
               buildAndroid = true;
               buildType = 'apk';
-              m = rawComment.match(/@suh-lab[^\S\r\n]+apk[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
-                || rawComment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+apk(?:[^\S\r\n]+(\S+))?/i);
+              m = rawComment.match(/\/wizard[^\S\r\n]+apk[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
+                || rawComment.match(/\/wizard[^\S\r\n]+build[^\S\r\n]+apk(?:[^\S\r\n]+(\S+))?/i);
               customBranch = (m && m[1]) || '';
-            } else if (comment.match(/@suh-lab[^\S\r\n]+ios[^\S\r\n]+build/) || comment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+ios/)) {
-              // @suh-lab ios build [브랜치] (또는 build ios) → iOS만
+            } else if (comment.match(/\/wizard[^\S\r\n]+ios[^\S\r\n]+build/) || comment.match(/\/wizard[^\S\r\n]+build[^\S\r\n]+ios/)) {
+              // /wizard ios build [브랜치] (또는 build ios) → iOS만
               buildIos = true;
               buildType = 'ios';
-              m = rawComment.match(/@suh-lab[^\S\r\n]+ios[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
-                || rawComment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+ios(?:[^\S\r\n]+(\S+))?/i);
+              m = rawComment.match(/\/wizard[^\S\r\n]+ios[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
+                || rawComment.match(/\/wizard[^\S\r\n]+build[^\S\r\n]+ios(?:[^\S\r\n]+(\S+))?/i);
               customBranch = (m && m[1]) || '';
-            } else if (comment.match(/@suh-lab[^\S\r\n]+app\b[^\S\r\n]+build/) || comment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+app\b/)) {
-              // @suh-lab app build [브랜치] (또는 build app) → Android + iOS 모두
+            } else if (comment.match(/\/wizard[^\S\r\n]+app\b[^\S\r\n]+build/) || comment.match(/\/wizard[^\S\r\n]+build[^\S\r\n]+app\b/)) {
+              // /wizard app build [브랜치] (또는 build app) → Android + iOS 모두
               buildAndroid = true;
               buildIos = true;
               buildType = 'app';
-              m = rawComment.match(/@suh-lab[^\S\r\n]+app\b[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
-                || rawComment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+app\b(?:[^\S\r\n]+(\S+))?/i);
+              m = rawComment.match(/\/wizard[^\S\r\n]+app\b[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
+                || rawComment.match(/\/wizard[^\S\r\n]+build[^\S\r\n]+app\b(?:[^\S\r\n]+(\S+))?/i);
               customBranch = (m && m[1]) || '';
             }
 
@@ -175,7 +175,7 @@ jobs:
             } catch (error) {
               console.log('ℹ️ PR이 아닙니다. 이슈에서 브랜치 정보를 찾습니다...');
 
-              // 2. PR이 아니면 이슈에서 "Guide by SUH-LAB" 댓글 찾기
+              // 2. PR이 아니면 이슈에서 "Issue Helper" 댓글 찾기
               sourceType = 'ISSUE';
               sourceNumber = issueNumber.toString();
               relatedIssueNumber = issueNumber.toString();
@@ -203,27 +203,27 @@ jobs:
                   per_page: 100
                 });
 
-                // "Guide by SUH-LAB" 댓글 찾기
+                // "Issue Helper" 댓글 찾기
                 const guideComment = comments.data.find(c =>
-                  c.body.includes('Guide by SUH-LAB')
+                  c.body.includes('<!-- project-auto-wizard issue helper -->')
                 );
 
                 if (!guideComment) {
-                  console.log('❌ "Guide by SUH-LAB" 댓글을 찾을 수 없습니다.');
+                  console.log('❌ "Issue Helper" 댓글을 찾을 수 없습니다.');
                   core.setOutput('found', 'false');
-                  core.setOutput('errorMessage', '이슈에서 "Guide by SUH-LAB" 댓글을 찾을 수 없습니다. 브랜치 정보가 포함된 댓글이 필요합니다.');
+                  core.setOutput('errorMessage', '이슈에서 "Issue Helper" 댓글을 찾을 수 없습니다. 브랜치 정보가 포함된 댓글이 필요합니다.');
                   return;
                 }
 
-                console.log('✅ "Guide by SUH-LAB" 댓글 발견');
+                console.log('✅ "Issue Helper" 댓글 발견');
 
                 // 브랜치명 추출 (### 브랜치 다음 ``` 블록 내용)
-                const branchMatch = guideComment.body.match(/### 브랜치\s*```\s*([\s\S]*?)\s*```/);
+                const branchMatch = guideComment.body.match(/### 브랜치(?:명)?\s*```\s*([\s\S]*?)\s*```/);
 
                 if (!branchMatch) {
                   console.log('❌ 브랜치 정보를 파싱할 수 없습니다.');
                   core.setOutput('found', 'false');
-                  core.setOutput('errorMessage', '"Guide by SUH-LAB" 댓글에서 브랜치 정보를 파싱할 수 없습니다. 댓글 형식을 확인해주세요.');
+                  core.setOutput('errorMessage', '"Issue Helper" 댓글에서 브랜치 정보를 파싱할 수 없습니다. 댓글 형식을 확인해주세요.');
                   return;
                 }
 
@@ -262,9 +262,9 @@ jobs:
 
             **해결 방법:**
             - PR에서 빌드하는 경우: PR 페이지에서 댓글을 작성해주세요.
-            - 이슈에서 빌드하는 경우: "Guide by SUH-LAB" 댓글이 있어야 합니다.
+            - 이슈에서 빌드하는 경우: "Issue Helper" 댓글이 있어야 합니다.
               - 댓글에 \`### 브랜치\` 섹션과 브랜치명이 포함되어 있어야 합니다.
-            - 또는 댓글에 브랜치명을 직접 지정할 수 있습니다: \`@suh-lab app build <브랜치명>\``;
+            - 또는 댓글에 브랜치명을 직접 지정할 수 있습니다: \`/wizard app build <브랜치명>\``;
 
             await github.rest.issues.createComment({
               owner: context.repo.owner,
@@ -329,7 +329,7 @@ jobs:
               '',
               '### 💡 확인 사항',
               '1. 브랜치가 원격 저장소에 push되었는지 확인하세요',
-              '2. "Guide by SUH-LAB" 댓글의 브랜치명이 올바른지 확인하세요',
+              '2. "Issue Helper" 댓글의 브랜치명이 올바른지 확인하세요',
               '3. 브랜치명에 오타가 없는지 확인하세요',
               '',
               `🔗 [워크플로우 로그](${runUrl})`
@@ -377,7 +377,7 @@ jobs:
               // iOS 빌드: ios 빌드 + app 공용 빌드 둘 다 카운트 (어순 무관)
               buildCount = comments.data.filter(c => {
                 const body = c.body.toLowerCase();
-                return body.includes('@suh-lab') && body.includes('build') && (
+                return body.includes('/wizard') && body.includes('build') && (
                   body.includes('ios') || body.includes('app')
                 );
               }).length;
@@ -387,7 +387,7 @@ jobs:
               // Android 빌드: apk 빌드 + app 공용 빌드 둘 다 카운트 (어순 무관)
               buildCount = comments.data.filter(c => {
                 const body = c.body.toLowerCase();
-                return body.includes('@suh-lab') && body.includes('build') && (
+                return body.includes('/wizard') && body.includes('build') && (
                   body.includes('apk') || body.includes('app')
                 );
               }).length;
@@ -397,7 +397,7 @@ jobs:
               // 전체 앱 빌드: 모든 빌드 명령어 카운트 (어순 무관)
               buildCount = comments.data.filter(c => {
                 const body = c.body.toLowerCase();
-                return body.includes('@suh-lab') && body.includes('build') && (
+                return body.includes('/wizard') && body.includes('build') && (
                   body.includes('ios') ||
                   body.includes('apk') ||
                   body.includes('app')

package/payload/workflows/flutter/PROJECT-FLUTTER-CI.yaml

@@ -32,7 +32,10 @@
 # FLUTTER_VERSION : Flutter SDK 버전
 # JAVA_VERSION    : Java 버전 (Android 빌드용)
 # XCODE_VERSION   : Xcode 버전 (iOS 빌드용)
-# ENV_FILE_PATH   : .env 파일 경로 (기본값: 루트의 .env)
+# ENV_FILE_PATH   : dotenv 모드에서 .env를 만들 경로 (Flutter 루트 기준, 기본값: .env)
+# ENV_MODE        : 환경변수 전달 방식 — dart-define(--dart-define-from-file) | dotenv(.env 파일)
+# FLUTTER_PROJECT_DIR : Flutter 루트 경로 (설치 시 자동 설정, 모노레포는 app 등)
+# PROJECT_PATH    : 변경 감지 기준 경로 (설치 시 자동 설정, "."이면 항상 실행)
 #
 # ==========================================================================================
 # 🔑 필수 GitHub Secrets
@@ -40,6 +43,8 @@
 # ENV_FILE (선택): .env 파일 내용
 #
 # ※ CI는 빌드 검증 목적이므로 서명/배포 관련 Secrets 불필요
+# ※ 모노레포에서 이 CI를 required check로 쓰려면 개별 job이 아니라 `ci-gate` 하나만 등록하세요.
+#    (경로가 바뀌지 않아 건너뛴 job은 Success로 집계되고, ci-gate가 최종 결과를 판정합니다)
 # ==========================================================================================
 
 name: PROJECT-Flutter-CI
@@ -73,6 +78,13 @@ permissions:
 # 🔧 프로젝트별 설정 (아래 값들을 수정하세요)
 # ==========================================================================================
 env:
+  # 🎯 모노레포 변경 감지 경로 (설치 시 자동 설정, 단일 레포는 ".")
+  PROJECT_PATH: "."  # @wizard auto:project-path
+  # Flutter 루트 경로(레포 루트 기준). 단일레포면 ".", 모노레포면 "app" 등 — 설치 시 자동 설정
+  FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
+  # 환경변수 전달 방식 (dart-define | dotenv) — 설치 시 선택값으로 자동 설정
+  ENV_MODE: "dart-define"  # @wizard auto:flutter-env-mode
+
   # 🎯 CI 모드 설정
   ANALYZE_ONLY: "false"     # true: analyze만 실행 (빌드 스킵), false: analyze + 빌드
 
@@ -84,18 +96,44 @@ env:
   FLUTTER_VERSION: "3.35.5"
   JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:17
   XCODE_VERSION: "26.0"
-  ENV_FILE_PATH: ".env"     # 환경변수 파일 경로 (커스터마이징 가능)
+  ENV_FILE_PATH: ".env"     # dotenv 모드에서 .env를 만들 경로 (Flutter 루트 기준, 커스터마이징 가능)
 
 concurrency:
   group: flutter-ci-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
+  # ===================================================================
+  # Job 0: 변경 감지 (PROJECT_PATH 아래가 바뀌었을 때만 이후 job 실행)
+  # ===================================================================
+  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) }}'
+
   # ===================================================================
   # Job 1: 준비 단계
   # ===================================================================
   prepare:
     name: CI 준비
+    needs: changes
+    if: ${{ (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') }}
     runs-on: ubuntu-latest
 
     outputs:
@@ -229,7 +267,11 @@ jobs:
   analyze:
     name: 코드 분석
     runs-on: ubuntu-latest
-    needs: prepare
+    needs: [changes, prepare]
+    if: ${{ (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') }}
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     outputs:
       status: ${{ steps.result.outputs.status }}
@@ -246,13 +288,20 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v7
 
-      # .env 파일 생성
-      - name: Create .env file
+      # 환경변수 준비 — ENV_MODE=dotenv면 .env 파일, dart-define이면 프로젝트 밖 임시 파일(--dart-define-from-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
 
       # Flutter 설정
       - name: Set up Flutter
@@ -271,7 +320,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-
 
       # 프로젝트 의존성 설치
@@ -317,10 +366,14 @@ jobs:
   build-android:
     name: Android 빌드
     if: |
+      (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') &&
       needs.prepare.outputs.analyze_only != 'true' &&
       needs.prepare.outputs.enable_android == 'true'
     runs-on: ubuntu-latest
-    needs: prepare
+    needs: [changes, prepare]
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     outputs:
       status: ${{ steps.result.outputs.status }}
@@ -337,13 +390,20 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v7
 
-      # .env 파일 생성
-      - name: Create .env file
+      # 환경변수 준비 — ENV_MODE=dotenv면 .env 파일, dart-define이면 프로젝트 밖 임시 파일(--dart-define-from-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
 
       # Flutter 설정
       - name: Set up Flutter
@@ -362,7 +422,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-
 
       # Gradle 캐시
@@ -372,7 +432,7 @@ jobs:
           path: |
             ~/.gradle/caches
             ~/.gradle/wrapper
-          key: ${{ runner.os }}-gradle-${{ hashFiles('**/build.gradle', '**/gradle-wrapper.properties') }}
+          key: ${{ runner.os }}-gradle-${{ hashFiles(format('{0}/android/**/build.gradle', env.FLUTTER_PROJECT_DIR), format('{0}/android/**/gradle-wrapper.properties', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: |
             ${{ runner.os }}-gradle-
 
@@ -399,7 +459,7 @@ jobs:
 
       # Gradle 셋업
       - name: Setup Gradle
-        working-directory: android
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}/android
         run: |
           chmod +x gradlew
           echo "✅ Gradle wrapper permissions set"
@@ -409,7 +469,7 @@ jobs:
         id: build
         run: |
           echo "📦 Flutter APK 빌드 시작 (debug)..."
-          flutter build apk --debug
+          flutter build apk --debug ${DART_DEFINE_FILE:+--dart-define-from-file="$DART_DEFINE_FILE"}
           echo "✅ APK 빌드 완료"
           ls -la ./build/app/outputs/flutter-apk/ || true
 
@@ -439,10 +499,14 @@ jobs:
   build-ios:
     name: iOS 빌드
     if: |
+      (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') &&
       needs.prepare.outputs.analyze_only != 'true' &&
       needs.prepare.outputs.enable_ios == 'true'
     runs-on: macos-26
-    needs: prepare
+    needs: [changes, prepare]
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     outputs:
       status: ${{ steps.result.outputs.status }}
@@ -479,13 +543,20 @@ jobs:
           echo "=== Downloading iOS platform ==="
           xcodebuild -downloadPlatform iOS
 
-      # .env 파일 생성
-      - name: Create .env file
+      # 환경변수 준비 — ENV_MODE=dotenv면 .env 파일, dart-define이면 프로젝트 밖 임시 파일(--dart-define-from-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
 
       # Flutter 설정
       - name: Set up Flutter
@@ -504,7 +575,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-
 
       # 프로젝트 의존성 설치
@@ -534,7 +605,7 @@ jobs:
         id: build
         run: |
           echo "📦 Flutter iOS 빌드 시작..."
-          flutter build ios --release --no-codesign
+          flutter build ios --release --no-codesign ${DART_DEFINE_FILE:+--dart-define-from-file="$DART_DEFINE_FILE"}
           echo "✅ iOS 빌드 완료"
 
       # 빌드 결과 기록
@@ -562,9 +633,9 @@ jobs:
   # ===================================================================
   report:
     name: 결과 보고
-    if: always() && github.event_name == 'pull_request'
+    if: always() && github.event_name == 'pull_request' && needs.changes.outputs.project == 'true'
     runs-on: ubuntu-latest
-    needs: [prepare, analyze, build-android, build-ios]
+    needs: [changes, prepare, analyze, build-android, build-ios]
 
     steps:
       - name: 최종 결과 댓글 업데이트
@@ -714,3 +785,23 @@ jobs:
             } else {
               console.log('⚠️ 댓글 ID가 없어 업데이트를 건너뜁니다.');
             }
+
+  # ===================================================================
+  # Job 6: CI Gate (required check로 등록할 단일 진입점)
+  # ===================================================================
+  # 건너뛴(skipped) job은 통과로 보고 failure/cancelled가 하나라도 있으면 실패한다.
+  ci-gate:
+    name: CI Gate
+    if: ${{ always() }}
+    needs: [changes, prepare, analyze, build-android, build-ios, report]
+    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