project-auto-wizard 0.12.0 → 0.12.2

package/README.md

@@ -8,8 +8,6 @@
 npx project-auto-wizard
 ```
 
-<!-- TODO: 30초 데모 GIF (docs/assets/demo.gif) -->
-<!-- TODO: 3분 데모 YouTube 링크 -->
 
 [![CI](https://github.com/Twin-Fang/project-auto-wizard/actions/workflows/CI.yaml/badge.svg)](https://github.com/Twin-Fang/project-auto-wizard/actions/workflows/CI.yaml)
 [![npm](https://img.shields.io/npm/v/project-auto-wizard)](https://www.npmjs.com/package/project-auto-wizard)
@@ -17,7 +15,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.11.0 (2026-09-23)
+## 최신 버전 : v0.12.1 (2026-09-26)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -67,7 +65,7 @@ flutter.APP_ARTIFACT_NAME:
 `spring`/`flutter`는 아래처럼 단일 CI 이상으로 깊게 구성되어 있습니다:
 
 - **flutter**: Android(Firebase/Playstore/Selfhosted/TestAPK 배포), iOS(TestFlight/Test-TestFlight), CI, Lab 트리거까지 8종 — 스토어 배포(Play Store·TestFlight)는 고른 플랫폼만 설치되고 fastlane 파일도 함께 생성됩니다. 환경변수 방식·배포 모드 등 자세한 내용은 아래 "Flutter 워크플로우 상세"를 참고하세요.
-- **spring**: 서버 배포 1종(단일 서버 / 무중단 Nginx / 무중단 Traefik / 배포 안 함 중 택1) + PR 프리뷰 + 라이브러리 publish 2종(Nexus·GitHub Packages, `--nexus` opt-in)
+- **spring**: 서버 배포 1종(단일 서버 / 무중단 Nginx / 무중단 Traefik / 배포 안 함 중 택1) + PR 프리뷰 + CI
   - 서버 배포 워크플로우는 **서로 대체재**라 하나만 설치합니다. 대화형에서 고르면 그것만 깔리고 **`push` 트리거까지 켜진 채로** 설치됩니다. 비대화형은 `--deploy-style simple|nginx|traefik|none` (기본: `simple`).
   - 고른 방식은 `version.yml`에 기록되므로 다시 실행해도 묻지 않습니다. 방식을 바꾸면 **이전 워크플로우를 마법사가 정리합니다** — 손대지 않은 파일은 삭제하고, 수정한 파일은 `.bak`으로 옮겨 내용을 보존합니다. 남겨두면 배포가 두 번 돕니다.
   - PR 프리뷰는 배포 방식과 무관한 별개 축이라 선택과 관계없이 함께 설치됩니다 (단, `none`을 고르면 PR 프리뷰도 함께 제외됩니다 — 서버 배포 자체를 하지 않는 프로젝트를 위한 선택지입니다).
@@ -144,7 +142,7 @@ flutter.APP_ARTIFACT_NAME:
 **모노레포와 `ci-gate`**
 
 - `--paths flutter=app`처럼 Flutter 하위 폴더를 지정하면 모든 Flutter 워크플로우가 그 폴더(`FLUTTER_PROJECT_DIR`)를 기준으로 동작하고, main push로 도는 배포 워크플로우(`PLAYSTORE`·`IOS-TESTFLIGHT`·`SELFHOSTED`·`FIREBASE`)는 `app/**`가 바뀔 때만 실행됩니다(Spring 등 다른 타입과 같은 `paths` 필터).
-- CI 워크플로우(Flutter·Go·Next·Python·React·Spring NEXUS-CI)는 `push`·`pull_request`에서 항상 실행되고, 첫 job `changes`가 변경 파일을 판별해 나머지 job을 건너뜁니다(건너뛴 job은 Success). 마지막 job `ci-gate`는 항상 실행되어 필수 job이 모두 success 또는 skipped이면 통과하고 failure·cancelled가 하나라도 있으면 실패합니다.
+- CI 워크플로우(Flutter·Go·Next·Python·React·Spring CI)는 `push`·`pull_request`에서 항상 실행되고, 첫 job `changes`가 변경 파일을 판별해 나머지 job을 건너뜁니다(건너뛴 job은 Success). 마지막 job `ci-gate`는 항상 실행되어 필수 job이 모두 success 또는 skipped이면 통과하고 failure·cancelled가 하나라도 있으면 실패합니다.
 - 브랜치 보호 규칙의 required status check에는 개별 job이 아니라 **`CI Gate`(`ci-gate`) 하나만** 등록하세요. 경로 필터로 워크플로우 자체를 건너뛰면 required check가 Pending에 머물러 머지가 막히지만, job을 건너뛰는 방식은 그렇지 않기 때문입니다.
 - 워크플로우 `paths` 필터는 태그 push에 적용되지 않습니다(GitHub 문서).
 
@@ -197,7 +195,7 @@ flowchart LR
 
 - 기본값은 **규칙 기반 요약**입니다. 설치 마법사에서 Copilot을 켜면(`--copilot`, `version.yml`의 `copilot_ai: true`) Actions의 `GITHUB_TOKEN` + `permissions: copilot-requests: write`로 Copilot CLI가 요약을 생성합니다 — 별도 API 키는 필요 없습니다.
 - **Copilot은 GitHub Copilot AI Credits를 소비합니다.** 개인 저장소는 저장소 소유자의 Copilot 좌석에, 조직 저장소는 조직에 과금되며 조직은 "Allow use of Copilot CLI billed to the organization" 정책을 켜야 합니다. 사용할 수 없으면 자동으로 규칙 기반 요약으로 전환됩니다. PR에 푸시할 때마다 요약이 새로 생성되므로 그만큼 크레딧이 소비됩니다.
-- Copilot 모델은 저비용 소형 모델(`claude-haiku-4.5`)로 고정되어 있고, 저장소 변수 `COPILOT_MODEL`로 바꿀 수 있습니다.
+- Copilot은 항상 `auto` 모델 선택으로 호출됩니다. Copilot Free·Student 계정은 모델명을 직접 지정하는 호출이 거부되고 `auto`만 허용되기 때문에, 모델을 바꾸는 옵션은 제공하지 않습니다.
 - GitHub은 Copilot CLI를 `run` 스텝에서 직접 호출하기보다 Agentic Workflows를 쓰라고 권고하지만, 이 프로젝트는 직접 호출을 택했습니다. 프롬프트 입력이 PR 제목·커밋 메시지·`git diff --stat`뿐이고, 빈 임시 디렉터리에서 shell/write/url 도구와 내장 MCP를 모두 막은 텍스트 생성 전용으로 호출하며, 포크 PR은 기존 가드로 건너뛰어 프롬프트 인젝션 위험을 낮췄기 때문입니다.
 - `AI_API_KEY`(**Secret**)와 `AI_API_BASE_URL`·`AI_MODEL`(**Variables**)을 **모두** 설정하면 OpenAI-호환 엔드포인트(Groq, Gemini 호환 모드, Ollama 등)를 최우선으로 사용합니다. 셋 중 하나라도 없으면 이 단계는 건너뜁니다.
 - 규칙 fallback 3단: 프로젝트 컨벤션 → Conventional Commits → 무형식 bullet. 커밋 컨벤션이 없어도 동작.
@@ -238,8 +236,6 @@ npx project-auto-wizard [옵션]
       --flutter-store CSV      Flutter 스토어 배포 대상: android,ios,none (미지정 시 둘 다 설치)
       --android-deploy-mode M  Play Store 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
       --ios-deploy-mode M      iOS 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
-      --nexus              라이브러리 publish 워크플로우 포함 (Nexus + GitHub Packages)
-      --secret-backup      Secret 서버 백업 워크플로우 포함
       --semver-auto        커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함, --no-semver-auto로 끔)
       --copilot            Copilot으로 AI 요약 생성 (기본: 사용 안 함, GitHub Copilot AI Credits 소비, --no-copilot으로 끔)
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "One command DevOps: npx wizard that installs GitHub-native Release Automation (optional GitHub Copilot AI summaries) into any project",
   "license": "MIT",
   "type": "module",

package/payload/config/breaking-changes.json

@@ -18,7 +18,7 @@
     {
       "severity": "warning",
       "title": "모노레포 CI required check는 ci-gate 하나만 등록",
-      "message": "CI 워크플로우(Flutter·Go·Next·Python·React·Spring NEXUS-CI)는 항상 실행되고 변경이 없으면 job을 건너뜁니다. required check로 쓰려면 개별 job이 아닌 CI Gate(ci-gate) 하나만 등록하세요."
+      "message": "CI 워크플로우(Flutter·Go·Next·Python·React·Spring CI)는 항상 실행되고 변경이 없으면 job을 건너뜁니다. required check로 쓰려면 개별 job이 아닌 CI Gate(ci-gate) 하나만 등록하세요."
     }
   ]
 }

package/payload/scripts/changelog_manager.py

@@ -464,7 +464,7 @@ 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_TYPES(csv)가 유일한 입력 — 단수 PROJECT_TYPE 폴백은 제거됐다 (issue #62)
+    # PROJECT_TYPES(csv)가 유일한 입력 — 단수 PROJECT_TYPE 폴백은 제거됐다
     project_types_csv = os.environ.get('PROJECT_TYPES', '')
     project_types = [t.strip() for t in project_types_csv.split(',') if t.strip()]
     today = os.environ.get('TODAY')
@@ -694,7 +694,8 @@ def cmd_export_release_notes(version: str, output_path: str | None) -> int:
 
 # ------------------------ ai-summary 엔진 체인 ------------------------
 
-_COPILOT_DEFAULT_MODEL = "claude-haiku-4.5"
+# Copilot Free/Student 계정은 모델명 지정이 거부되고 auto 모델 선택만 허용된다 (#153).
+_COPILOT_MODEL = "auto"
 _COPILOT_TIMEOUT_SECONDS = 90
 
 
@@ -729,14 +730,13 @@ def call_copilot_cli(prompt: str) -> str:
     빈 임시 디렉터리에서 실행하고, shell/write/url 도구를 거부하며, 내장 MCP와
     커스텀 지침 로딩을 끈다.
     실패(비정상 종료·타임아웃·CLI 없음)는 예외로 올려 호출부가 fallback한다."""
-    model = os.environ.get('COPILOT_MODEL') or _COPILOT_DEFAULT_MODEL
     with tempfile.TemporaryDirectory() as workdir:
         result = subprocess.run(
             [
                 'copilot', '-p', prompt, '-s',
                 '--no-ask-user', '--no-color', '--no-custom-instructions', '--disable-builtin-mcps',
                 '--deny-tool=shell', '--deny-tool=write', '--deny-tool=url',
-                '--model', model,
+                '--model', _COPILOT_MODEL,
             ],
             cwd=workdir, stdin=subprocess.DEVNULL,
             capture_output=True, text=True, timeout=_COPILOT_TIMEOUT_SECONDS,

package/payload/scripts/version_manager.py

@@ -160,7 +160,7 @@ def get_project_types_csv():
     # 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).
+    # through to the singular key instead.
     m = re.search(r'^project_types:[ \t]*\[(.*?)\][ \t]*(?:#.*)?$', text, re.MULTILINE)
     if m:
         inner = m.group(1)
@@ -435,7 +435,7 @@ def sync_all_project_files(new_version):
     types = get_project_types_csv()
     if not types:
         # No silent fallback: an unreadable project_types used to degrade to
-        # "basic" and skip every sync without a word (issue #62).
+        # "basic" and skip every sync without a word.
         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)

package/payload/version.yml.template

@@ -47,8 +47,6 @@ metadata:
       develop: "{{DEVELOP_BRANCH}}"
       mode: "{{BRANCH_MODE}}" # pr-flow | trunk-based
     options:
-      nexus: {{OPT_NEXUS}}
-      secret_backup: {{OPT_SECRET_BACKUP}}
       semver_auto: {{OPT_SEMVER_AUTO}}
       copilot_ai: {{OPT_COPILOT_AI}}
       deploy_style: "{{OPT_DEPLOY_STYLE}}" # simple | nginx | traefik | none (서버 배포 워크플로우)

package/payload/workflows/common/PROJECT-COMMON-AI-PR-SUMMARY.yaml

@@ -1,8 +1,6 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # PROJECT-COMMON-AI-PR-SUMMARY.yaml
 # Self-hosted AI PR summary bot — no third-party service required.
-# ===================================================================
 #
 # Posts a summary comment on PRs targeting the default branch, using the
 # same engine chain as the release changelog (user API key -> Copilot CLI,
@@ -18,7 +16,6 @@
 # that commit is pushed with GITHUB_TOKEN, which GitHub does not use
 # to retrigger pull_request events, so there would be no later run to
 # correct it.
-# ===================================================================
 
 name: PROJECT-AI-PR-SUMMARY
 
@@ -72,7 +69,6 @@ jobs:
           AI_MODEL: ${{ vars.AI_MODEL }}
           GITHUB_TOKEN: ${{ github.token }}
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
-          COPILOT_MODEL: ${{ vars.COPILOT_MODEL }}
         run: |
           PR_NUMBER=${{ github.event.pull_request.number }}
           VERSION=$(python3 .github/scripts/version_manager.py get 2>/dev/null | tail -n 1)

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

@@ -1,8 +1,6 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # PROJECT-COMMON-AUTO-CHANGELOG-CONTROL.yaml
 # Release PR pipeline: version confirm + AI changelog + automerge
-# ===================================================================
 #
 # Runs on release PRs ({{DEVELOP_BRANCH}} -> {{MAIN_BRANCH}}) and:
 # 1. Confirms the release version and syncs every version file:
@@ -36,14 +34,13 @@
 #   {{MAIN_BRANCH}}-push workflows (e.g. RELEASE-PUBLISH) for that merge.
 # - secrets.AI_API_KEY (+ vars.AI_API_BASE_URL / vars.AI_MODEL, all three
 #   required together): preferred summary engine. Falls back to Copilot CLI
-#   (only when version.yml copilot_ai is true; optional vars.COPILOT_MODEL),
+#   (only when version.yml copilot_ai is true; always uses auto model selection),
 #   then to rule-based.
 #
-# Issue #90: without WORKFLOW_PAT, a wait-for-merge-and-trigger-release job
+# Without WORKFLOW_PAT, a wait-for-merge-and-trigger-release job
 # polls until the automerge actually lands, then wakes RELEASE-PUBLISH via
 # workflow_dispatch — GITHUB_TOKEN can always trigger that event, unlike
 # the push/release events blocked by GitHub's anti-recursion policy.
-# ===================================================================
 
 name: PROJECT-AUTO-CHANGELOG-CONTROL
 
@@ -166,7 +163,6 @@ jobs:
           AI_MODEL: ${{ vars.AI_MODEL }}
           GITHUB_TOKEN: ${{ github.token }}
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
-          COPILOT_MODEL: ${{ vars.COPILOT_MODEL }}
         run: |
           # Idempotency: if the PR head is already this workflow's own
           # version-confirm commit (re-run / synchronize retrigger), do not
@@ -203,7 +199,6 @@ jobs:
           AI_MODEL: ${{ vars.AI_MODEL }}
           GITHUB_TOKEN: ${{ github.token }}
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
-          COPILOT_MODEL: ${{ vars.COPILOT_MODEL }}
         run: |
           VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
 

package/payload/workflows/common/PROJECT-COMMON-ISSUE-HELPER.yaml

@@ -1,18 +1,15 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # PROJECT-COMMON-ISSUE-HELPER.yaml
 # 이슈 생성/제목 수정 시 브랜치명·커밋 메시지를 댓글로 안내
-# ===================================================================
 #
 # 이슈가 열리거나(opened) 제목이 수정되면(edited + 제목 변경),
 # 정규화된 브랜치명과 커밋 메시지를 이슈 댓글로 생성/갱신한다.
 # ISSUE_HELPER_CREATE_BRANCH=true로 바꾸면 브랜치도 함께 생성한다
 # (기본값은 false — 이슈를 열 때마다 브랜치가 자동 생성되는 것을
-# 막기 위해 옵트인으로 전환됨, project-auto-wizard#68).
+# 막기 위해 옵트인으로 전환됨).
 #
 # 로직 본체는 .github/scripts/issue_helper.py (Chuseok22/github-issue-helper의
-# Python 재작성, 동일 작성자 — project-auto-wizard#68).
-# ===================================================================
+# Python 재작성, 동일 작성자).
 
 name: PROJECT-ISSUE-HELPER
 
@@ -23,7 +20,7 @@ on:
 # contents는 항상 write로 고정한다. ISSUE_HELPER_CREATE_BRANCH="true"일 때
 # git/refs API로 브랜치를 생성하려면 write가 필요한데, 이 값은 @wizard ask로
 # 설치 후에도 사용자가 직접 켤 수 있어(마법사 재실행 없이) 그 시점에 맞춰
-# permissions를 조건부로 올릴 방법이 없다 — project-auto-wizard#118.
+# permissions를 조건부로 올릴 방법이 없다.
 permissions:
   issues: write
   contents: write

package/payload/workflows/common/PROJECT-COMMON-README-VERSION-UPDATE.yaml

@@ -1,13 +1,10 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # PROJECT-COMMON-README-VERSION-UPDATE.yaml
 # Automatic README version update workflow
-# ===================================================================
 #
 # On every push to {{MAIN_BRANCH}} this workflow reads the latest version
 # via version_manager.py and rewrites the version section of README.md.
 #
-# ===================================================================
 # How it works:
 # 1. Triggered by a push to {{MAIN_BRANCH}}
 # 2. Reads the latest version via version_manager.py
@@ -41,7 +38,6 @@
 # afterwards with a [skip ci] commit that does not re-trigger this
 # workflow, so the README stays one version behind until the next
 # release/push. Run this workflow manually (workflow_dispatch) to catch up.
-# ===================================================================
 
 name: README VERSION UPDATE
 
@@ -112,9 +108,7 @@ jobs:
           RELEASE_DATE="${{ steps.version_info.outputs.release_date }}"
           SHOW_DATE="${{ env.SHOW_DATE }}"
 
-          # ---------------------------------------------------------
           # Error message helper
-          # ---------------------------------------------------------
           print_error_message() {
             local error_type="$1"
             local version_line="$2"
@@ -184,9 +178,7 @@ jobs:
           else
             # Update the existing version line
 
-            # ---------------------------------------------------------
             # Validate the line format
-            # ---------------------------------------------------------
             if [[ "$VERSION_LINE" =~ \*\* ]]; then
               echo ""
               echo "warning: the version line contains markdown bold (**) characters"
@@ -212,9 +204,7 @@ jobs:
               LINE_NUMBER=$((LINE_NUMBER + 1))
             fi
 
-            # ---------------------------------------------------------
             # Extract the header part (up to the colon)
-            # ---------------------------------------------------------
             HEADER_PART=$(printf '%s\n' "$VERSION_LINE" | sed 's/\(.*:\).*/\1 /')
 
             if [ -z "$HEADER_PART" ] || [[ "$HEADER_PART" == "$VERSION_LINE" ]]; then
@@ -222,9 +212,7 @@ jobs:
               exit 1
             fi
 
-            # ---------------------------------------------------------
             # Replace by line number (avoids regex special-char issues)
-            # ---------------------------------------------------------
             NEW_LINE="${HEADER_PART}${VERSION_TEXT}"
 
             # Escape sed replacement metacharacters (backslash, & and the

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

@@ -1,8 +1,6 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # PROJECT-COMMON-RELEASE-PUBLISH.yaml
 # Tag + GitHub Release publisher (dual-mode)
-# ===================================================================
 #
 # Publishes a git tag (vX.Y.Z) and a GitHub Release for every release
 # that lands on {{MAIN_BRANCH}}. Two branch modes, read from version.yml
@@ -38,13 +36,12 @@
 # previous run failed after the version was confirmed but before the
 # release was created). The idempotency guard keeps it safe to re-run.
 #
-# Issue #90: this file and its self-copy (.github/workflows/) intentionally
+# This file and its self-copy (.github/workflows/) intentionally
 # differ by one step — the self-copy also triggers NPM-PUBLISH via
 # workflow_dispatch right after the release is created. NPM-PUBLISH.yaml is
 # a repo-only workflow (not shipped in payload), so wiring that dispatch
 # here would make every wizard-installed repo call a workflow that doesn't
 # exist for them on every release.
-# ===================================================================
 
 name: PROJECT-RELEASE-PUBLISH
 
@@ -117,7 +114,7 @@ jobs:
 
           echo "not a release-confirm push in pr-flow mode — skipping"
 
-          # Drift guard (issue #61): skipping is normal, but a version.yml that
+          # Drift guard: skipping is normal, but a version.yml that
           # has run ahead of the newest tag is not — it means the version was
           # bumped without a release, so npm silently stays behind. Six versions
           # (0.1.26~0.1.31) went missing this way with every workflow green.
@@ -193,7 +190,6 @@ jobs:
           AI_MODEL: ${{ vars.AI_MODEL }}
           GITHUB_TOKEN: ${{ github.token }}
           COPILOT_AI: ${{ steps.copilot_options.outputs.copilot_ai }}
-          COPILOT_MODEL: ${{ vars.COPILOT_MODEL }}
         run: |
           # Idempotency: on a re-run of a failed job the checked-out HEAD may
           # already be this workflow's own docs commit — never bump twice.

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

@@ -1,8 +1,6 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # PROJECT-COMMON-VERSION-CONTROL.yaml
 # Safety-net automatic version bump
-# ===================================================================
 #
 # [Safety net] Only when a direct push (one that did not go through a
 # release PR) lands on {{MAIN_BRANCH}} (production), this workflow bumps
@@ -20,11 +18,9 @@
 # Release-confirm pattern: "chore(release):" — keep in sync with
 # PROJECT-COMMON-AUTO-CHANGELOG-CONTROL and PROJECT-COMMON-RELEASE-PUBLISH.
 #
-# Issue #90 / #61: after pushing the safety-net bump, this workflow also
-# triggers RELEASE-PUBLISH via workflow_dispatch so the drift it used to
-# only detect (issue #61) is now auto-recovered instead of requiring a
-# manual re-run.
-# ===================================================================
+# After pushing the safety-net bump, this workflow also triggers
+# RELEASE-PUBLISH via workflow_dispatch so a version drift is
+# auto-recovered instead of requiring a manual re-run.
 
 name: PROJECT-VERSION-CONTROL
 

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

@@ -1,7 +1,5 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Flutter Android Firebase App Distribution 배포
-# ===================================================================
 #
 # {{MAIN_BRANCH}} 브랜치 푸시 시 Android AAB를 빌드하고
 # Firebase App Distribution에 자동 배포합니다.
@@ -9,44 +7,36 @@
 # PlayStore CICD와 동일한 빌드 과정(AAB + 버전 검증)을 거친 후
 # Play Store 대신 Firebase App Distribution에 업로드합니다.
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 #
-# 🔐 Release Keystore:
+# Release Keystore:
 # RELEASE_KEYSTORE_BASE64: 서명용 keystore (base64)
 # RELEASE_KEYSTORE_PASSWORD: keystore 비밀번호
 # RELEASE_KEY_ALIAS: key alias
 # RELEASE_KEY_PASSWORD: key 비밀번호
 #
-# 🔥 Firebase:
+# Firebase:
 # FIREBASE_SERVICE_ACCOUNT_JSON_BASE64: Firebase 서비스 계정 JSON (base64)
 #
-# 📝 환경 설정 (선택):
+# 환경 설정 (선택):
 # ENV_FILE 또는 ENV: .env 파일 내용 (둘 중 하나, ENV_FILE 우선)
 # GOOGLE_SERVICES_JSON: Firebase google-services.json
 #
 # ※ 위 Secrets는 저장소 Settings → Secrets and variables → Actions에 등록하세요.
 #    FIREBASE_APP_ID·FIREBASE_TESTER_GROUP은 아래 env 섹션 값을 직접 수정합니다.
 #
-# ===================================================================
-#
-# 🔧 프로젝트별 설정 (env 섹션에서 수정)
-# ===================================================================
+# 프로젝트별 설정 (env 섹션에서 수정)
 # APP_ARTIFACT_NAME       : 프로젝트 이름
 # FLUTTER_VERSION    : Flutter SDK 버전
 # JAVA_VERSION       : Java 버전
 # FIREBASE_APP_ID    : Firebase 앱 ID (Firebase Console에서 확인)
 # FIREBASE_TESTER_GROUP : Firebase 테스터 그룹명
-# ===================================================================
 #
-# 🛠️ 사전 설정:
+# 사전 설정:
 # 1. Firebase Console → App Distribution → 테스터 그룹 생성
 # 2. Firebase 서비스 계정 JSON 생성 (base64 인코딩)
 # 3. GitHub Secrets에 FIREBASE_SERVICE_ACCOUNT_JSON_BASE64 등록
 # 4. env 섹션의 FIREBASE_APP_ID, FIREBASE_TESTER_GROUP 수정
-#
-# ===================================================================
 
 name: PROJECT-FLUTTER-ANDROID-FIREBASE-APPDIST-CICD
 
@@ -57,9 +47,7 @@ on:
   workflow_dispatch:
 
 env:
-  # ============================================
-  # 🔧 프로젝트별 설정 (아래 값들을 수정하세요)
-  # ============================================
+  # 프로젝트별 설정 (아래 값들을 수정하세요)
   # 프로젝트 이름
   APP_ARTIFACT_NAME: "__APP_ARTIFACT_NAME__"  # @wizard ask:@repo
   # Flutter/Java 버전
@@ -133,7 +121,6 @@ jobs:
             dart run build_runner build --delete-conflicting-outputs
           fi
 
-      # version_manager.py를 사용하여 현재 버전 정보 가져오기
       - name: 현재 버전 정보 가져오기
         id: current_version
         working-directory: ${{ github.workspace }}   # version_manager.py가 레포 루트 version.yml을 읽어야 함
@@ -161,7 +148,6 @@ jobs:
           echo "TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')" >> $GITHUB_ENV
           echo "PROJECT_TYPE=${{ env.PROJECT_TYPE }}" >> $GITHUB_ENV
 
-      # CHANGELOG.json에서 릴리즈 노트 추출 - changelog_manager.py 사용
       - name: 릴리즈 노트 생성
         id: release_notes
         working-directory: ${{ github.workspace }}   # CHANGELOG.json·changelog_manager.py·final_release_notes.txt(upload 짝)는 레포 루트 기준
@@ -194,7 +180,6 @@ jobs:
             echo "v$VERSION 업데이트" > final_release_notes.txt
           fi
 
-      # 릴리즈 노트를 아티팩트로 업로드
       - name: Upload release notes
         uses: actions/upload-artifact@v7
         with:
@@ -232,7 +217,6 @@ jobs:
       - name: Pull latest changes
         run: git pull origin main
 
-      # 프로젝트 파일들 다운로드
       - name: Download project files
         uses: actions/download-artifact@v8
         with:
@@ -254,7 +238,6 @@ jobs:
             echo "dart-define file prepared"
           fi
 
-      # Release Keystore 설정
       - name: Setup Release Keystore
         run: |
           mkdir -p android/app/keystore
@@ -262,7 +245,6 @@ jobs:
           echo "✅ Release Keystore 생성 완료"
           ls -la android/app/keystore/
 
-      # key.properties 생성 (Release 서명 정보)
       - name: Create key.properties
         run: |
           cat > android/key.properties << EOF
@@ -274,7 +256,6 @@ jobs:
           echo "✅ key.properties 생성 완료"
           cat android/key.properties
 
-      # Google-services.json 생성
       - name: Create Google-services.json
         run: |
           cat << 'EOF' > android/app/google-services.json
@@ -318,7 +299,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-gradle-
 
-      # Android build.gradle.kts 수정 (release 서명 설정)
       - name: Configure Android build for release
         run: |
           # build.gradle.kts에 release 서명 설정이 없으면 추가
@@ -331,7 +311,6 @@ jobs:
       # pubspec.yaml은 x.y.z 형식 그대로 유지
       # Flutter build 명령어의 --build-name, --build-number 플래그가 pubspec.yaml을 오버라이드함
 
-      # Flutter build appbundle (AAB 생성)
       - name: Build Android App Bundle (AAB)
         run: |
           VERSION_NAME="${{ needs.prepare-build.outputs.version }}"
@@ -547,7 +526,6 @@ jobs:
           echo "📱 파일 크기: $(du -h "$AAB_FILE" | cut -f1)"
           echo "=========================================="
 
-      # AAB 파일을 아티팩트로 업로드
       - name: Upload AAB artifact
         uses: actions/upload-artifact@v7
         with:
@@ -567,21 +545,18 @@ jobs:
           ref: main
           fetch-depth: 0
 
-      # AAB 파일 다운로드
       - name: Download AAB artifact
         uses: actions/download-artifact@v8
         with:
           name: android-aab
           path: ${{ env.FLUTTER_PROJECT_DIR }}/build/app/outputs/bundle/release/
 
-      # 릴리즈 노트 다운로드
       - name: Download release notes
         uses: actions/download-artifact@v8
         with:
           name: release-notes
           path: .
 
-      # Firebase 서비스 계정 설정
       - name: Setup Firebase credentials file
         run: |
           echo "${{ secrets.FIREBASE_SERVICE_ACCOUNT_JSON_BASE64 }}" | base64 --decode > firebase-service-account.json
@@ -595,7 +570,6 @@ jobs:
             python3 ./.github/scripts/truncate_release_notes.py final_release_notes.txt 4000 char
           fi
 
-      # Firebase App Distribution에 AAB 업로드
       - name: Upload to Firebase App Distribution
         id: firebase_upload
         uses: wzieba/Firebase-Distribution-Github-Action@v1
@@ -611,7 +585,6 @@ jobs:
         if: always()
         run: rm -f firebase-service-account.json
 
-      # 성공 알림
       - name: Notify Firebase Upload Success
         if: success()
         run: |