project-auto-wizard 0.1.25 → 0.1.31

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.31",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/payload/scripts/version_manager.py

@@ -221,6 +221,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'

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/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("추가된 워크플로우:");