project-auto-wizard 0.1.25 → 0.1.32

package/README.md

@@ -17,7 +17,7 @@ npx project-auto-wizard
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.1.24 (2026-08-06)
+## 최신 버전 : v0.1.30 (2026-08-08)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.25",
+  "version": "0.1.32",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/payload/scripts/changelog_manager.py

@@ -433,12 +433,9 @@ def cmd_classify_bump(commits_file: str) -> int:
 def cmd_update_from_summary() -> int:
     """pr_body.md에서 Markdown을 파싱하여 CHANGELOG.json 갱신."""
     version = os.environ.get('VERSION')
-    project_type = os.environ.get('PROJECT_TYPE')
-    # 멀티타입 — PROJECT_TYPES(csv) env가 있으면 배열로, 없으면 단수 키 fallback
+    # PROJECT_TYPES(csv)가 유일한 입력 — 단수 PROJECT_TYPE 폴백은 제거됐다 (issue #62)
     project_types_csv = os.environ.get('PROJECT_TYPES', '')
     project_types = [t.strip() for t in project_types_csv.split(',') if t.strip()]
-    if not project_types and project_type:
-        project_types = [project_type]
     today = os.environ.get('TODAY')
     pr_number_raw = os.environ.get('PR_NUMBER')
     timestamp = os.environ.get('TIMESTAMP')
@@ -482,8 +479,7 @@ def cmd_update_from_summary() -> int:
         # 릴리즈 데이터 생성
         new_release = {
             "version": version,
-            "project_type": project_type,      # 기존 단수 키 — 유지 (하위 호환)
-            "project_types": project_types,    # 신규 멀티타입 배열
+            "project_types": project_types,
             "date": today,
             "pr_number": pr_number,
             "raw_summary": raw_summary,
@@ -510,7 +506,6 @@ def cmd_update_from_summary() -> int:
                 "metadata": {
                     "lastUpdated": timestamp,
                     "currentVersion": version,
-                    "projectType": project_type,
                     "projectTypes": project_types,
                     "totalReleases": 0,
                 },
@@ -525,7 +520,6 @@ def cmd_update_from_summary() -> int:
 
         changelog_data["metadata"]["lastUpdated"] = timestamp
         changelog_data["metadata"]["currentVersion"] = version
-        changelog_data["metadata"]["projectType"] = project_type
         changelog_data["metadata"]["projectTypes"] = project_types
         changelog_data["metadata"]["totalReleases"] = len(changelog_data.get("releases", [])) + 1
         changelog_data.setdefault("releases", []).insert(0, new_release)

package/payload/scripts/version_manager.py

@@ -146,21 +146,22 @@ def get_current_version():
     return read_scalar_key("version", "0.0.0")
 
 
-def get_project_type():
-    return read_scalar_key("project_type", "basic")
-
-
 def get_project_types_csv():
     """Return project_types as a list. Supports both:
       project_types: ["a", "b"]
       project_types:
         - "a"
         - "b"
-    Returns [] if key absent (legacy single-type mode)."""
+    Returns [] if the key is absent — project_types is the single source of
+    truth (issue #62), so callers must treat [] as a hard error rather than
+    falling back to a singular key."""
     text = read_text()
 
-    # Inline array form: project_types: ["a", "b"]
-    m = re.search(r'^project_types:[ \t]*\[(.*?)\][ \t]*$', text, re.MULTILINE)
+    # Inline array form: project_types: ["a", "b"]  # trailing comment allowed
+    # The template always appends "# first entry is primary", so anchoring at
+    # end-of-line made this branch never match — every install silently fell
+    # through to the singular key instead (issue #62).
+    m = re.search(r'^project_types:[ \t]*\[(.*?)\][ \t]*(?:#.*)?$', text, re.MULTILINE)
     if m:
         inner = m.group(1)
         items = re.findall(r'"([^"]*)"|\'([^\']*)\'', inner)
@@ -174,7 +175,8 @@ def get_project_types_csv():
     m = re.search(r'^project_types:[ \t]*\n((?:[ \t]+-[ \t]*.*\n?)+)', text, re.MULTILINE)
     if m:
         block = m.group(1)
-        types = re.findall(r'-\s*["\']?([^"\'\n]+?)["\']?\s*$', block, re.MULTILINE)
+        # trailing comments are allowed on list items too
+        types = re.findall(r'-[ \t]*["\']?([^"\'#\n]+?)["\']?[ \t]*(?:#.*)?$', block, re.MULTILINE)
         return [t.strip() for t in types if t.strip()]
 
     return []
@@ -221,6 +223,13 @@ def get_version_code():
 
 
 def set_version_code(new_code):
+    current = read_scalar_key("version_code", None)
+    if current not in (None, "", "null"):
+        try:
+            if int(new_code) < int(current):
+                log(f"WARNING: version_code {new_code} is lower than current {current} — writing anyway (regression?)")
+        except ValueError:
+            pass
     text = read_text()
     pattern = re.compile(r'^version_code:[ \t]*.*$', re.MULTILINE)
     replacement = f'version_code: {new_code}  # app build number'
@@ -423,7 +432,9 @@ def sync_for_type(project_type, new_version, version_code_getter):
 def sync_all_project_files(new_version):
     types = get_project_types_csv()
     if not types:
-        types = [get_project_type()]
+        # No silent fallback: an unreadable project_types used to degrade to
+        # "basic" and skip every sync without a word (issue #62).
+        raise SystemExit("ERROR: version.yml has no readable project_types — cannot sync project files")
     for t in types:
         sync_for_type(t, new_version, get_version_code)
 
@@ -503,7 +514,10 @@ def get_project_file_version(project_type):
 
 def sync_versions():
     yml_version = get_current_version()
-    primary_type = get_project_type()
+    types = get_project_types_csv()
+    if not types:
+        raise SystemExit("ERROR: version.yml has no readable project_types — cannot sync versions")
+    primary_type = types[0]
     project_version = get_project_file_version(primary_type)
 
     log("Version sync check")

package/payload/version.yml.template

@@ -10,7 +10,7 @@
 # Supported project types: spring, flutter, next, react, react-native,
 #                          react-native-expo, node, python, basic
 # Multi-type projects: list every type in the project_types array
-#   -> project_type (singular) always mirrors project_types[0] — do not edit it directly
+#   -> the first entry is the primary type (project_types is the single source of truth)
 # Monorepo paths: project_paths maps each type to its subdir relative to the repo root
 #   (e.g., flutter: "app", react: "client"). Omitted -> repo root.
 #
@@ -27,7 +27,6 @@
 version: "{{VERSION}}"
 version_code: {{VERSION_CODE}} # app build number
 project_types: {{PROJECT_TYPES}} # first entry is primary
-project_type: "{{PROJECT_TYPE}}" # auto-mirror of project_types[0] — do not edit directly
 {{PROJECT_PATHS}}
 metadata:
   last_updated: "{{NOW}}"

package/payload/workflows/common/PROJECT-COMMON-AUTO-CHANGELOG-CONTROL.yaml

@@ -156,13 +156,11 @@ jobs:
         run: |
           # note: `grep | sed || echo default` never fires the default (the
           # pipeline exits with sed's 0) — default via ${var:-} instead
-          PROJECT_TYPE=$(grep "^project_type:" version.yml 2>/dev/null | sed 's/project_type: *"\([^"]*\)".*/\1/')
-          PROJECT_TYPE=${PROJECT_TYPE:-unknown}
           PROJECT_TYPES=$(grep "^project_types:" version.yml 2>/dev/null | sed -E 's/.*\[([^]]*)\].*/\1/' | tr -d '" ')
-          PROJECT_TYPES=${PROJECT_TYPES:-$PROJECT_TYPE}
+          PROJECT_TYPES=${PROJECT_TYPES:-unknown}
 
           export VERSION="${{ steps.bump.outputs.new_version }}"
-          export PROJECT_TYPE PROJECT_TYPES
+          export PROJECT_TYPES
           export TODAY=$(date '+%Y-%m-%d')
           export PR_NUMBER="${{ github.event.pull_request.number }}"
           export TIMESTAMP=$(date '+%Y-%m-%dT%H:%M:%SZ')

package/payload/workflows/common/PROJECT-COMMON-RELEASE-PUBLISH.yaml

@@ -192,13 +192,11 @@ jobs:
 
           # note: `grep | sed || echo default` never fires the default (the
           # pipeline exits with sed's 0) — default via ${var:-} instead
-          PROJECT_TYPE=$(grep "^project_type:" version.yml 2>/dev/null | sed 's/project_type: *"\([^"]*\)".*/\1/')
-          PROJECT_TYPE=${PROJECT_TYPE:-unknown}
           PROJECT_TYPES=$(grep "^project_types:" version.yml 2>/dev/null | sed -E 's/.*\[([^]]*)\].*/\1/' | tr -d '" ')
-          PROJECT_TYPES=${PROJECT_TYPES:-$PROJECT_TYPE}
+          PROJECT_TYPES=${PROJECT_TYPES:-unknown}
 
           export VERSION="$NEW_VERSION"
-          export PROJECT_TYPE PROJECT_TYPES
+          export PROJECT_TYPES
           export TODAY=$(date '+%Y-%m-%d')
           export TIMESTAMP=$(date '+%Y-%m-%dT%H:%M:%SZ')
 

package/payload/workflows/common/PROJECT-COMMON-VERSION-CONTROL.yaml

@@ -114,21 +114,16 @@ jobs:
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
           echo "new version: $NEW_VERSION"
 
-      - name: Read project type
+      - name: Read project types
         id: project_info
         if: steps.release_guard.outputs.skip != 'true'
         run: |
           if [ -f "version.yml" ]; then
-            PROJECT_TYPE=$(grep "^project_type:" version.yml | sed 's/project_type: *"\([^"]*\)".*/\1/' || echo "unknown")
-            PROJECT_TYPES=$(grep "^project_types:" version.yml 2>/dev/null | sed -E 's/.*\[([^]]*)\].*/\1/' | tr -d '" ' || echo "")
-            if [ -z "$PROJECT_TYPES" ]; then
-              PROJECT_TYPES="$PROJECT_TYPE"
-            fi
-            echo "project_type=$PROJECT_TYPE" >> $GITHUB_OUTPUT
+            PROJECT_TYPES=$(grep "^project_types:" version.yml 2>/dev/null | sed -E 's/.*\[([^]]*)\].*/\1/' | tr -d '" ')
+            PROJECT_TYPES=${PROJECT_TYPES:-unknown}
             echo "project_types=$PROJECT_TYPES" >> $GITHUB_OUTPUT
-            echo "project type: $PROJECT_TYPE (types: $PROJECT_TYPES)"
+            echo "project types: $PROJECT_TYPES"
           else
-            echo "project_type=unknown" >> $GITHUB_OUTPUT
             echo "project_types=unknown" >> $GITHUB_OUTPUT
             echo "version.yml not found"
           fi

package/payload/workflows/flutter/PROJECT-FLUTTER-ANDROID-FIREBASE-CICD.yaml

@@ -112,7 +112,11 @@ jobs:
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
-        run: flutter pub get
+        run: |
+          flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
       # version_manager.py를 사용하여 현재 버전 정보 가져오기
       - name: 현재 버전 정보 가져오기
@@ -265,7 +269,11 @@ jobs:
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
-        run: flutter pub get
+        run: |
+          flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
       - name: Set up Java
         uses: actions/setup-java@v5
@@ -328,6 +336,9 @@ jobs:
           echo "🔄 Flutter clean 및 의존성 재설치..."
           flutter clean
           flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
           # local.properties에 버전 정보 추가 (Flutter 플래그가 무시되는 문제 해결)
           echo "🔧 local.properties에 버전 정보 설정..."

package/payload/workflows/flutter/PROJECT-FLUTTER-ANDROID-PLAYSTORE-CICD.yaml

@@ -47,7 +47,7 @@ env:
   PROJECT_TYPE: "flutter"
   # Flutter 루트 경로(레포 루트 기준). 단일레포면 ".", 모노레포면 "app" 등.
   # 통합 시점에 integrator의 flutter-root resolver가 project_paths.flutter 값으로 1회 치환.
-  FLUTTER_ROOT: "."  # @wizard auto:flutter-root
+  FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
   # 배포 모드 (store_only | store_prepare | store_submit)
   DEPLOY_MODE: ${{ github.event.inputs.deploy_mode || vars.ANDROID_DEPLOY_MODE || 'store_only' }}
 
@@ -57,7 +57,7 @@ jobs:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: ${{ env.FLUTTER_ROOT }}
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
     # CHANGELOG 워크플로우가 성공한 경우에만 실행
     if: ${{ github.event.workflow_run.conclusion == 'success' || github.event_name != 'workflow_run' }}
 
@@ -97,7 +97,11 @@ jobs:
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
-        run: flutter pub get
+        run: |
+          flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
       # version_manager.py를 사용하여 현재 버전 정보 가져오기
       - name: 현재 버전 정보 가져오기
@@ -167,6 +171,7 @@ jobs:
           name: release-notes
           path: final_release_notes.txt
           retention-days: 1
+          if-no-files-found: error
 
       # 프로젝트 파일들을 아티팩트로 업로드
       # .env는 보안상 아티팩트에 포함하지 않고, 각 job에서 secrets로 재생성
@@ -179,6 +184,7 @@ jobs:
             lib/
             assets/
           retention-days: 1
+          if-no-files-found: error
 
   build-android:
     name: Android AAB 빌드
@@ -186,7 +192,7 @@ jobs:
     needs: prepare-build
     defaults:
       run:
-        working-directory: ${{ env.FLUTTER_ROOT }}
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     steps:
       - name: Checkout repository
@@ -255,7 +261,11 @@ jobs:
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
-        run: flutter pub get
+        run: |
+          flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
       - name: Set up Java
         uses: actions/setup-java@v5
@@ -318,6 +328,9 @@ jobs:
           echo "🔄 Flutter clean 및 의존성 재설치..."
           flutter clean
           flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
           # local.properties에 버전 정보 추가 (Flutter 플래그가 무시되는 문제 해결)
           echo "🔧 local.properties에 버전 정보 설정..."
@@ -503,8 +516,9 @@ jobs:
         uses: actions/upload-artifact@v7
         with:
           name: android-aab
-          path: ${{ env.FLUTTER_ROOT }}/build/app/outputs/bundle/release/app-release.aab
+          path: ${{ env.FLUTTER_PROJECT_DIR }}/build/app/outputs/bundle/release/app-release.aab
           retention-days: 1
+          if-no-files-found: error
 
   deploy-playstore:
     name: Play Store 내부 테스트 배포
@@ -512,7 +526,7 @@ jobs:
     needs: [prepare-build, build-android]
     defaults:
       run:
-        working-directory: ${{ env.FLUTTER_ROOT }}
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     steps:
       - name: Checkout repository
@@ -533,7 +547,7 @@ jobs:
         uses: actions/download-artifact@v8
         with:
           name: android-aab
-          path: ${{ env.FLUTTER_ROOT }}/build/app/outputs/bundle/release/
+          path: ${{ env.FLUTTER_PROJECT_DIR }}/build/app/outputs/bundle/release/
 
       # 릴리즈 노트 다운로드
       - name: Download release notes
@@ -549,7 +563,7 @@ jobs:
           ruby-version: "3.4.1"
 
       - name: Install Fastlane
-        working-directory: ${{ env.FLUTTER_ROOT }}/android
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}/android
         run: |
           # multi_json: google-apis transitive 의존성이 선언 누락한 upstream 버그 회피 (gemspec 미선언 → Gem::LoadError)
           printf 'source "https://rubygems.org"\ngem "fastlane"\ngem "multi_json"\n' > Gemfile
@@ -650,7 +664,7 @@ jobs:
 
           if [ -f "$GITHUB_WORKSPACE/final_release_notes.txt" ]; then
             # Google Play release notes 한도(500 글자)에 맞춰 절단 (마진 두어 480자)
-            # final_release_notes.txt·truncate 스크립트는 레포 루트 기준 — working-directory가 FLUTTER_ROOT이므로 절대경로 사용
+            # final_release_notes.txt·truncate 스크립트는 레포 루트 기준 — working-directory가 FLUTTER_PROJECT_DIR이므로 절대경로 사용
             bash "$GITHUB_WORKSPACE/.github/scripts/truncate_release_notes.sh" "$GITHUB_WORKSPACE/final_release_notes.txt" 480 char
             cp "$GITHUB_WORKSPACE/final_release_notes.txt" "$CHANGELOG_DIR/${VERSION_CODE}.txt"
             echo "✅ Changelog 준비 완료 (버전 코드: $VERSION_CODE)"

package/payload/workflows/flutter/PROJECT-FLUTTER-ANDROID-SELFHOSTED-CICD.yaml

@@ -134,6 +134,9 @@ jobs:
       - name: Install dependencies
         run: |
           flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
           echo "Dependencies installed"
           ls -la
 

package/payload/workflows/flutter/PROJECT-FLUTTER-ANDROID-TEST-APK.yaml

@@ -333,11 +333,11 @@ jobs:
           KEY_PASSWORD: ${{ secrets.RELEASE_KEY_PASSWORD }}
         run: |
           cat > android/key.properties << EOF
-storeFile=keystore/key.jks
-storePassword=$STORE_PASSWORD
-keyAlias=$KEY_ALIAS
-keyPassword=$KEY_PASSWORD
-EOF
+          storeFile=keystore/key.jks
+          storePassword=$STORE_PASSWORD
+          keyAlias=$KEY_ALIAS
+          keyPassword=$KEY_PASSWORD
+          EOF
           echo "✅ key.properties 생성 완료"
 
       # google-services.json 생성 (선택적)
@@ -388,6 +388,9 @@ EOF
       - name: Install dependencies
         run: |
           flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
           echo "✅ Dependencies installed"
 
       # Gradle 셋업
@@ -634,24 +637,24 @@ EOF
           BUILD_DATE=$(date '+%Y-%m-%d %H:%M:%S')
 
           cat > build-info.txt << EOF
-테스트 APK 빌드 정보
+          테스트 APK 빌드 정보
 
-빌드 번호: #$BUILD_NUMBER
-EOF
+          빌드 번호: #$BUILD_NUMBER
+          EOF
 
           if [ -n "$PR_NUMBER" ]; then
             cat >> build-info.txt << EOF
-PR 번호: #$PR_NUMBER
-EOF
+          PR 번호: #$PR_NUMBER
+          EOF
           fi
 
           cat >> build-info.txt << EOF
-브랜치: $BRANCH_NAME
-커밋: $COMMIT_SHORT
-전체 커밋 해시: $COMMIT_SHA
-빌드 날짜: $BUILD_DATE
+          브랜치: $BRANCH_NAME
+          커밋: $COMMIT_SHORT
+          전체 커밋 해시: $COMMIT_SHA
+          빌드 날짜: $BUILD_DATE
 
-EOF
+          EOF
 
           # 이슈 정보가 있으면 추가
           if [ -n "${{ needs.prepare-test-build.outputs.issue_number }}" ]; then
@@ -660,11 +663,11 @@ EOF
             ISSUE_URL="${{ needs.prepare-test-build.outputs.issue_url }}"
 
             cat >> build-info.txt << EOF
-관련 이슈:
-- #$ISSUE_NUMBER: $ISSUE_TITLE
-- URL: $ISSUE_URL
+          관련 이슈:
+          - #$ISSUE_NUMBER: $ISSUE_TITLE
+          - URL: $ISSUE_URL
 
-EOF
+          EOF
           fi
 
           echo "📋 빌드 정보 파일 생성 완료:"
@@ -674,13 +677,13 @@ EOF
       - name: Create build metadata file
         run: |
           cat > build-metadata.json << EOF
-{
-  "pr_number": "${{ needs.prepare-test-build.outputs.pr_number }}",
-  "build_number": "${{ needs.prepare-test-build.outputs.build_number }}",
-  "issue_number": "${{ needs.prepare-test-build.outputs.issue_number }}",
-  "branch_name": "${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
-}
-EOF
+          {
+            "pr_number": "${{ needs.prepare-test-build.outputs.pr_number }}",
+            "build_number": "${{ needs.prepare-test-build.outputs.build_number }}",
+            "issue_number": "${{ needs.prepare-test-build.outputs.issue_number }}",
+            "branch_name": "${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
+          }
+          EOF
           cat build-metadata.json
 
       # APK와 빌드 정보를 아티팩트로 업로드 (브랜치명 포함)

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

@@ -278,6 +278,9 @@ jobs:
       - name: Install dependencies
         run: |
           flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
           echo "✅ Dependencies installed"
 
       # Flutter Analyze 실행
@@ -377,6 +380,9 @@ jobs:
       - name: Install dependencies
         run: |
           flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
           echo "✅ Dependencies installed"
 
       # Java 설정
@@ -398,12 +404,12 @@ jobs:
           chmod +x gradlew
           echo "✅ Gradle wrapper permissions set"
 
-      # APK 빌드
+      # APK 빌드 (CI는 빌드 검증 목적이므로 서명 불필요한 debug 빌드 사용)
       - name: Build APK
         id: build
         run: |
-          echo "📦 Flutter APK 빌드 시작..."
-          flutter build apk --release
+          echo "📦 Flutter APK 빌드 시작 (debug)..."
+          flutter build apk --debug
           echo "✅ APK 빌드 완료"
           ls -la ./build/app/outputs/flutter-apk/ || true
 
@@ -456,6 +462,23 @@ jobs:
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
 
+      - name: Install iOS device platform
+        env:
+          # xcode-select만으로는 서브프로세스에 전파되지 않아 명시적으로 지정
+          DEVELOPER_DIR: /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
+        run: |
+          echo "=== iPhoneOS.platform check ==="
+          ls "$DEVELOPER_DIR/Platforms/iPhoneOS.platform/" 2>/dev/null && echo "iPhoneOS.platform EXISTS" || echo "iPhoneOS.platform NOT FOUND"
+          echo "=== Installing MobileDevice packages ==="
+          sudo installer -pkg /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Resources/Packages/MobileDevice.pkg -target /
+          sudo installer -pkg /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Resources/Packages/MobileDeviceDevelopment.pkg -target /
+          echo "=== Accepting Xcode license ==="
+          sudo xcodebuild -license accept
+          echo "=== Initializing Xcode components ==="
+          xcrun simctl list >/dev/null 2>&1 || true
+          echo "=== Downloading iOS platform ==="
+          xcodebuild -downloadPlatform iOS
+
       # .env 파일 생성
       - name: Create .env file
         run: |
@@ -488,6 +511,9 @@ jobs:
       - name: Install dependencies
         run: |
           flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
           echo "✅ Dependencies installed"
 
       # Ruby 및 CocoaPods 설정

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

@@ -319,13 +319,13 @@ jobs:
           echo "commit_hash=$COMMIT_SHORT" >> $GITHUB_OUTPUT
 
           cat > final_release_notes.txt << EOF
-테스트 빌드 #$BUILD_NUMBER
+          테스트 빌드 #$BUILD_NUMBER
 
-브랜치: $BRANCH_NAME
-커밋: $COMMIT_SHORT
-날짜: $BUILD_DATE
+          브랜치: $BRANCH_NAME
+          커밋: $COMMIT_SHORT
+          날짜: $BUILD_DATE
 
-EOF
+          EOF
 
           # 이슈 정보가 있으면 추가
           if [ -n "${{ steps.issue_info.outputs.issue_number }}" ]; then
@@ -334,11 +334,11 @@ EOF
             ISSUE_URL="${{ steps.issue_info.outputs.issue_url }}"
 
             cat >> final_release_notes.txt << EOF
-관련 이슈:
-- #$ISSUE_NUMBER: $ISSUE_TITLE
-- URL: $ISSUE_URL
+          관련 이슈:
+          - #$ISSUE_NUMBER: $ISSUE_TITLE
+          - URL: $ISSUE_URL
 
-EOF
+          EOF
           fi
 
           echo "📋 생성된 릴리즈 노트:"
@@ -542,7 +542,11 @@ EOF
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
-        run: flutter pub get
+        run: |
+          flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -618,13 +622,13 @@ EOF
       - name: Create build metadata file
         run: |
           cat > build-metadata.json << EOF
-{
-  "pr_number": "${{ needs.prepare-test-build.outputs.pr_number }}",
-  "build_number": "${{ needs.prepare-test-build.outputs.build_number }}",
-  "issue_number": "${{ needs.prepare-test-build.outputs.issue_number }}",
-  "branch_name": "${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
-}
-EOF
+          {
+            "pr_number": "${{ needs.prepare-test-build.outputs.pr_number }}",
+            "build_number": "${{ needs.prepare-test-build.outputs.build_number }}",
+            "issue_number": "${{ needs.prepare-test-build.outputs.issue_number }}",
+            "branch_name": "${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
+          }
+          EOF
           cat build-metadata.json
 
       - name: Upload IPA artifact

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

@@ -75,7 +75,7 @@ on:
 # 🔧 프로젝트별 설정 (아래 값들을 수정하세요)
 # ============================================
 env:
-  FLUTTER_ROOT: "."  # @wizard auto:flutter-root
+  FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
   FLUTTER_VERSION: "3.35.5"
   XCODE_VERSION: "26.0"
   PROJECT_TYPE: "flutter"
@@ -102,7 +102,7 @@ jobs:
     runs-on: macos-26
     defaults:
       run:
-        working-directory: ${{ env.FLUTTER_ROOT }}
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
     if: ${{ github.event.workflow_run.conclusion == 'success' || github.event_name != 'workflow_run' }}
 
     outputs:
@@ -154,7 +154,11 @@ jobs:
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
-        run: flutter pub get
+        run: |
+          flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -207,6 +211,7 @@ jobs:
           name: release-notes
           path: final_release_notes.txt
           retention-days: 1
+          if-no-files-found: error
 
       - name: Upload project files
         uses: actions/upload-artifact@v7
@@ -219,6 +224,7 @@ jobs:
             lib/
             assets/
           retention-days: 1
+          if-no-files-found: error
 
   # ============================================
   # iOS 빌드 (xcodebuild 직접 사용)
@@ -228,7 +234,7 @@ jobs:
     runs-on: macos-26
     defaults:
       run:
-        working-directory: ${{ env.FLUTTER_ROOT }}
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
     needs: prepare-build
 
     steps:
@@ -290,7 +296,11 @@ jobs:
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
-        run: flutter pub get
+        run: |
+          flutter pub get
+          if grep -q "build_runner" pubspec.yaml; then
+            dart run build_runner build --delete-conflicting-outputs
+          fi
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -361,8 +371,9 @@ jobs:
         uses: actions/upload-artifact@v7
         with:
           name: ios-ipa
-          path: ${{ env.FLUTTER_ROOT }}/ios/build/ipa/*.ipa
+          path: ${{ env.FLUTTER_PROJECT_DIR }}/ios/build/ipa/*.ipa
           retention-days: 1
+          if-no-files-found: error
 
   # ============================================
   # TestFlight 배포 (마법사 생성 Fastfile 사용)
@@ -372,7 +383,7 @@ jobs:
     runs-on: macos-26
     defaults:
       run:
-        working-directory: ${{ env.FLUTTER_ROOT }}
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
     needs: [prepare-build, build-ios]
 
     steps:
@@ -391,7 +402,7 @@ jobs:
         uses: actions/download-artifact@v8
         with:
           name: ios-ipa
-          path: ${{ env.FLUTTER_ROOT }}/ios/build/ipa/
+          path: ${{ env.FLUTTER_PROJECT_DIR }}/ios/build/ipa/
 
       - name: Download release notes
         uses: actions/download-artifact@v8
@@ -410,7 +421,7 @@ jobs:
           echo "✅ Fastfile 확인됨: ios/fastlane/Fastfile"
 
       - name: Install Fastlane
-        working-directory: ${{ env.FLUTTER_ROOT }}/ios
+        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
@@ -424,14 +435,14 @@ jobs:
           SKIP_WAITING_FOR_BUILD_PROCESSING: ${{ env.SKIP_WAITING_FOR_BUILD_PROCESSING }}
         run: |
           # IPA 절대경로 탐색
-          IPA_PATH=$(find "$GITHUB_WORKSPACE/${FLUTTER_ROOT}/ios/build/ipa" -name "*.ipa" | head -1)
+          IPA_PATH=$(find "$GITHUB_WORKSPACE/${FLUTTER_PROJECT_DIR}/ios/build/ipa" -name "*.ipa" | head -1)
           echo "📦 Found IPA at: $IPA_PATH"
 
           if [ ! -f "$IPA_PATH" ]; then
             echo "❌ IPA 파일을 찾을 수 없습니다!"; ls -la ios/build/ipa/ || true; exit 1
           fi
 
-          # Release notes 준비 (final_release_notes.txt·truncate 스크립트는 레포 루트 기준 — working-directory가 FLUTTER_ROOT이므로 절대경로 사용)
+          # Release notes 준비 (final_release_notes.txt·truncate 스크립트는 레포 루트 기준 — working-directory가 FLUTTER_PROJECT_DIR이므로 절대경로 사용)
           if [ -f "$GITHUB_WORKSPACE/final_release_notes.txt" ]; then
             # App Store Connect "What to Test" 한도(4000 바이트)에 맞춰 절단 (마진 두어 3800byte)
             bash "$GITHUB_WORKSPACE/.github/scripts/truncate_release_notes.sh" "$GITHUB_WORKSPACE/final_release_notes.txt" 3800 byte

package/src/commands/interactive.js

@@ -5,7 +5,7 @@
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "../core/assets.js";
-import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers } from "../core/detect-fs.js";
+import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber } from "../core/detect-fs.js";
 import { parseExisting } from "../core/version-yml.js";
 import { runBreakingCheck } from "../core/breaking-check.js";
 import { resolveProjectPaths } from "../core/paths-resolve.js";
@@ -85,7 +85,6 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   let version = (existing?.version) || detectVersion(cwd);
   let branch = detectDefaultBranch(cwd);
   const repoName = detectRepoName(cwd);
-  const versionCode = existing?.versionCode ?? 1; // 기존 빌드번호 보존
   // 선택 워크플로우 초기값: version.yml 저장 옵션 (.sh read_template_options L2361 등가)
   let includeNexus = existing?.options?.nexus ?? false;
   let includeSecretBackup = existing?.options?.secretBackup ?? false;
@@ -166,6 +165,8 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     }
   }
 
+  const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지 (이슈 #41)
+
   // 신규 질문 ① — 브랜치 설정 (DESIGN-SPEC §4). full/workflows만 질문, version은 기본값 기록.
   // 저장값(version.yml metadata.template.branches)이 있으면 재질문 없이 재사용 (업데이트 모드).
   let branches = existing?.branches
@@ -250,7 +251,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
 
   // 완료 요약 (.sh print_summary L5438)
   io.summary?.({
-    mode, types, version, branches,
+    mode, types, version, versionCode, branches,
     copiedFiles: result?.workflows?.copiedFiles ?? [],
     gitignoreUpdated: result?.gitignoreUpdated === true,
   });

package/src/core/detect-fs.js

@@ -3,7 +3,7 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, basename } from "node:path";
 import { execFileSync } from "node:child_process";
-import { detectTypesFromMarkers, detectVersionFromFiles } from "./detect.js";
+import { detectTypesFromMarkers, detectVersionFromFiles, detectBuildNumberFromFiles } from "./detect.js";
 import { parseExisting } from "./version-yml.js";
 
 const hasFile = (root) => (rel) => existsSync(join(root, rel));
@@ -35,6 +35,13 @@ export function detectVersion(root, { warn = (m) => console.error(m) } = {}) {
   return detectVersionFromFiles({ read, readJson, gitTag, warn });
 }
 
+// 빌드 번호 감지 — 신규 통합 시 pubspec.yaml/build.gradle/app.json에서 실제 빌드 번호를 읽는다 (이슈 #41).
+export function detectBuildNumber(root, { types = [], warn = (m) => console.error(m) } = {}) {
+  const read = readFile(root);
+  const readJson = (rel) => { const c = read(rel); try { return c ? JSON.parse(c) : null; } catch { return null; } };
+  return detectBuildNumberFromFiles({ types, read, readJson, warn });
+}
+
 // 기본 브랜치 감지 — symbolic-ref → remote show → main.
 export function detectDefaultBranch(root) {
   let b = gitOut(root, ["symbolic-ref", "refs/remotes/origin/HEAD"]);

package/src/core/detect.js

@@ -62,3 +62,42 @@ export function markerForType(type) {
 export function extraMarkers(type) {
   return { python: ["setup.py", "requirements.txt"], spring: ["build.gradle.kts", "pom.xml"] }[type] || [];
 }
+
+// 빌드 번호 감지 (이슈 #41) — 신규 통합 시 pubspec.yaml/build.gradle/app.json에 이미 기록된
+// 빌드 번호를 읽어 version_code가 항상 1로 초기화되는 걸 막는다. types 배열에서 먼저 매칭되는
+// 첫 타입만 사용한다(다른 감지 로직의 types[0]=primary 관례와 동일). read(rel)=>string|null,
+// readJson(rel)=>object|null 로 주입.
+export function detectBuildNumberFromFiles({ types = [], read, readJson, warn }) {
+  const tryFlutter = () => {
+    const content = read("pubspec.yaml");
+    if (content == null) return null;
+    const m = content.match(/^version:\s*\d+\.\d+\.\d+\+(\d+)/m);
+    if (m) return parseInt(m[1], 10);
+    warn?.("⚠️  pubspec.yaml에 빌드 번호(+N)가 없어 version_code를 감지하지 못했습니다 — 기본값 1을 사용합니다. 실제 빌드 번호를 확인하세요.");
+    return null;
+  };
+  const tryReactNative = () => {
+    const content = read("android/app/build.gradle");
+    if (content == null) return null;
+    // 앵커 + m 플래그로 한 줄 전체가 "versionCode N"인 라인만 매칭 — 주석 처리된
+    // "// versionCode 2"나 다른 블록의 versionCode 참조에 오매칭되지 않도록 함.
+    const m = content.match(/^\s*versionCode\s+(\d+)\s*$/m);
+    if (m) return parseInt(m[1], 10);
+    warn?.("⚠️  android/app/build.gradle에 versionCode가 없어 version_code를 감지하지 못했습니다 — 기본값 1을 사용합니다. 실제 빌드 번호를 확인하세요.");
+    return null;
+  };
+  const tryExpo = () => {
+    const data = readJson?.("app.json");
+    if (data == null) return null;
+    const code = data?.expo?.android?.versionCode;
+    if (Number.isInteger(code)) return code;
+    warn?.("⚠️  app.json의 expo.android.versionCode가 없어 version_code를 감지하지 못했습니다 — 기본값 1을 사용합니다. 실제 빌드 번호를 확인하세요.");
+    return null;
+  };
+  for (const t of types) {
+    if (t === "flutter") return tryFlutter();
+    if (t === "react-native") return tryReactNative();
+    if (t === "react-native-expo") return tryExpo();
+  }
+  return null;
+}

package/src/core/version-yml.js

@@ -5,6 +5,9 @@ import { escapeYamlDoubleQuoted } from "./wizard-env.js";
 // 레이아웃 단일 진실 = payload/version.yml.template (호출부가 templateText로 주입).
 
 // version.yml.template이 아는 최상위 키 — 이 밖의 최상위 키는 사용자가 직접 추가한 것으로 간주한다.
+// "project_type"(단수)은 더 이상 렌더하지 않는 레거시 키지만 이 집합에는 남겨둔다 (issue #62):
+// 빼면 기존 파일의 단수 줄이 "사용자가 추가한 필드"로 오인돼 재생성 때 되살아난다. 아는 키로
+// 둬야 재통합 시 흡수되어 사라진다.
 const KNOWN_TOP_LEVEL_KEYS = new Set([
   "version", "version_code", "project_types", "project_type", "project_paths", "metadata", "deploy",
 ]);
@@ -147,7 +150,7 @@ export function parseTemplateBranches(content) {
 }
 
 // version.yml 전체 생성 — payload/version.yml.template 렌더링.
-// opts: { templateText, version, types:[], primaryType?, paths:Map, pathMarkers?:Map,
+// opts: { templateText, version, types:[], paths:Map, pathMarkers?:Map,
 //         branch, branches?, versionCode, now, today, templateOptions?, deployValues?,
 //         extraTopLevel?:string[] }  ← 기존 version.yml의 알려지지 않은 최상위 필드 보존 (issue #20 M8)
 //   templateText = payload/version.yml.template 원문 (readVersionYmlTemplate — 필수)
@@ -156,13 +159,12 @@ export function parseTemplateBranches(content) {
 //   pathMarkers = Map<type, markerFilename> (project_paths 주석용)
 //   templateOptions = { templateVersion, includeNexus, includeSecretBackup, optionsDate }
 export function buildVersionYml({
-  templateText, version, types = [], primaryType, paths = new Map(), pathMarkers = new Map(),
+  templateText, version, types = [], paths = new Map(), pathMarkers = new Map(),
   branch = "main", branches = null, versionCode = 1, now, today,
   templateOptions = null, deployValues = new Map(), extraTopLevel = [],
 }) {
   if (!templateText) throw new Error("version.yml.template 원문이 필요합니다 (payload/version.yml.template 누락?)");
   const typesJson = types.length ? `[${types.map((t) => `"${t}"`).join(", ")}]` : `["basic"]`;
-  const primary = primaryType || types[0] || "basic";
   const b = branches || { main: branch || "main", develop: "develop", mode: "pr-flow" };
   const {
     templateVersion = "unknown", includeNexus = false, includeSecretBackup = false,
@@ -197,7 +199,7 @@ export function buildVersionYml({
 
   const scalars = {
     VERSION: version, VERSION_CODE: String(versionCode),
-    PROJECT_TYPES: typesJson, PROJECT_TYPE: primary,
+    PROJECT_TYPES: typesJson,
     NOW: now, TODAY: today || optionsDate, DEFAULT_BRANCH: branch,
     TEMPLATE_VERSION: templateVersion,
     MAIN_BRANCH: b.main, DEVELOP_BRANCH: b.develop, BRANCH_MODE: b.mode,

package/src/index.js

@@ -9,7 +9,7 @@ import { parseArgs, parsePathsCsv, CliError } from "./cli/args.js";
 import { HELP_TEXT } from "./cli/help.js";
 import { createContext } from "./context.js";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "./core/assets.js";
-import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers } from "./core/detect-fs.js";
+import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber } from "./core/detect-fs.js";
 import { parseExisting } from "./core/version-yml.js";
 import { runBreakingCheck } from "./core/breaking-check.js";
 import { resolveProjectPaths } from "./core/paths-resolve.js";
@@ -237,7 +237,7 @@ export async function run(argv, {
   const types = opts.types.length ? opts.types : detectTypes(cwd);
   // version: 기존 version.yml 최우선(SSoT — 재실행 시 덮어쓰기 방지) → CLI 지정 → 파일 감지
   const version = (existing?.version) || opts.version || detectVersion(cwd);
-  const versionCode = existing?.versionCode ?? 1; // 기존 빌드번호 보존 (.sh L2208~2221)
+  const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지 (.sh L2208~2221, 이슈 #41)
   const branch = detectDefaultBranch(cwd);
   const repoName = detectRepoName(cwd);
   // 경로 확정 (.sh resolve_project_paths 비대화형 경로 — --paths 우선 → 저장값 → 후보 1개 자동 → 에러)
@@ -314,7 +314,7 @@ export async function run(argv, {
 
   // 완료 요약 (.sh print_summary — CLI 모드에서도 출력)
   printSummary({
-    mode: opts.mode, types, version, branches,
+    mode: opts.mode, types, version, versionCode, branches,
     copiedFiles: result?.workflows?.copiedFiles ?? [],
     gitignoreUpdated: result?.gitignoreUpdated === true,
   });

package/src/ui/summary.js

@@ -6,7 +6,7 @@ import { paint, A, colorEnabled } from "./ansi.js";
 const SEPARATOR = "────────────────────────────────────────";
 
 export function printSummary(ctx) {
-  const { mode, types = [], version = "", copiedFiles = [], branches = null, gitignoreUpdated = false } = ctx || {};
+  const { mode, types = [], version = "", versionCode = null, copiedFiles = [], branches = null, gitignoreUpdated = false } = ctx || {};
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 ansi.js의 공용 가드로 통일 (NO_COLOR + stderr TTY 여부)
   const enabled = colorEnabled(process.stderr);
@@ -56,6 +56,10 @@ export function printSummary(ctx) {
   err("");
   err("추가된 파일:");
   err(`  📄 version.yml (버전: ${version}, 타입: ${types.join(",")})`);
+  const BUILD_NUMBER_TYPES = new Set(["flutter", "react-native", "react-native-expo"]);
+  if (versionCode != null && types.some((t) => BUILD_NUMBER_TYPES.has(t))) {
+    err(`     빌드 번호: ${versionCode}`);
+  }
   err("  📝 README.md (버전 섹션 추가)");
   err("");
   err("추가된 워크플로우:");