project-auto-wizard 0.11.0 → 0.12.0

package/README.md

@@ -1,6 +1,6 @@
 # project-auto-wizard
 
-> **One command DevOps** — `npx` 한 줄로 어떤 프로젝트든 GitHub-native AI 릴리스 자동화를 설치하는 마법사
+> **One command DevOps** — `npx` 한 줄로 어떤 프로젝트든 GitHub-native 릴리스 자동화(GitHub Copilot AI 요약은 선택)를 설치하는 마법사
 
 - 새 프로젝트를 시작하면 코드를 작성하기 전부터 버전 관리, 배포 자동화, 변경 기록 작성처럼 먼저 정해야 할 일이 많다. project-auto-wizard는 이 준비 과정을 명령 한 번으로 구성하고, 프로젝트 상태 관리가 GitHub 안에서 자동으로 동작하도록 해 개발자가 기능 구현에 집중하도록 돕는 오픈소스 도구
 
@@ -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.10.0 (2026-09-21)
+## 최신 버전 : v0.11.0 (2026-09-23)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -38,7 +38,7 @@ npx project-auto-wizard --mode full --force --type spring,react   # CI에서 비
 | 축 | 내용 |
 |---|---|
 | ① **npx 마법사** | 마커 파일로 프로젝트 타입 자동 감지 — **10타입 + 멀티타입 + 모노레포 경로**까지. 질문은 최소한만 |
-| ② **GitHub-native AI Release Automation** | 릴리스 PR을 열면: 버전 확정 → **AI가 릴리스 노트 작성** → CHANGELOG 갱신 → automerge → tag + GitHub Release. **API 키 0개** (GitHub Models) |
+| ② **GitHub-native Release Automation** | 릴리스 PR을 열면: 버전 확정 → **릴리스 노트 작성**(기본은 규칙 기반, GitHub Copilot AI는 선택) → CHANGELOG 갱신 → automerge → tag + GitHub Release. **API 키 0개** |
 | ③ **타입별 CI/CD 워크플로우** | Spring(무중단 배포 포함)·Flutter(스토어 배포)·React·Next·Python·Go 등 타입에 맞는 GitHub Actions 자동 배치 |
 
 ### 지원 프로젝트 타입
@@ -183,18 +183,23 @@ npx project-auto-wizard --mode uninstall --force         # 워크플로우·스
 npx project-auto-wizard --mode uninstall --force --purge-readme --purge-gitignore --purge-version  # 완전 삭제
 ```
 
-## API 키 0개 AI — 요약 엔진 체인
+## 요약 엔진 체인
 
-릴리스 노트는 3단 엔진 체인으로 생성됩니다. **상용 서드파티 서비스에 전혀 의존하지 않으며, 어떤 단계가 실패해도 릴리스는 절대 막히지 않습니다.**
+릴리스 노트는 3단 엔진 체인으로 생성됩니다. **어떤 단계가 실패해도 릴리스는 절대 막히지 않습니다.**
+
+> GitHub Models는 2026-07-30에 종료되어 더 이상 사용하지 않습니다.
 
 ```mermaid
 flowchart LR
-    B["사용자 지정 AI<br/>(AI_API_KEY)"] -->|"키 없음/실패"| C["GitHub Models<br/>(GITHUB_TOKEN만, 무료)"]
-    C -->|"rate limit/실패"| D["규칙 기반 fallback<br/>(항상 성공)"]
+    B["사용자 지정 AI<br/>(AI_API_KEY + AI_API_BASE_URL + AI_MODEL)"] -->|"미설정/실패"| C["GitHub Copilot CLI<br/>(선택, GITHUB_TOKEN)"]
+    C -->|"꺼짐/사용 불가/실패"| D["규칙 기반 fallback<br/>(항상 성공)"]
 ```
 
-- 기본값은 **GitHub Models** — Actions의 `GITHUB_TOKEN` + `permissions: models: read`만으로 동작. **비용 0, 설정 0.**
-- `AI_API_KEY`/`AI_API_BASE_URL`/`AI_MODEL` secret으로 OpenAI-호환 엔드포인트(Groq, Gemini 호환 모드, Ollama 등) 교체 가능.
+- 기본값은 **규칙 기반 요약**입니다. 설치 마법사에서 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`로 바꿀 수 있습니다.
+- 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. 커밋 컨벤션이 없어도 동작.
 
 ## 릴리스 흐름
@@ -204,7 +209,7 @@ flowchart LR
     subgraph pr-flow ["pr-flow (기본)"]
         D1[develop push] --> PR[develop→main 릴리스 PR]
         PR --> V["버전 확정 (patch+1)"]
-        V --> AI[AI 릴리스 노트]
+        V --> AI[릴리스 노트]
         AI --> CL[CHANGELOG.json/md 갱신]
         CL --> AM[automerge]
         AM --> TAG["tag vX.Y.Z + GitHub Release"]
@@ -236,6 +241,7 @@ npx project-auto-wizard [옵션]
       --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            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌
       --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
       --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거
@@ -270,9 +276,10 @@ npx project-auto-wizard --mode doctor   # 환경 진단 (읽기 전용, 규칙
       secret이 없어도 폴백이 자동으로 이어받아 태그·Release까지 진행됩니다 — 실제 병합 후 최대 ~20초 정도 더 걸릴 뿐입니다.
       속도를 더 원한다면 PAT을 등록할 수 있습니다 — 반드시 개인 계정이 아닌 조직 bot/machine 계정으로 발급하세요 (scopes: repo, workflow).
       등록: 레포 Settings → Secrets and variables → Actions → New repository secret · 이름은 WORKFLOW_PAT
-  [i] GitHub Models — AI 릴리스 노트 생성
-      조직 정책으로 차단됐는지는 자동으로 확인할 수 없습니다 (Settings → Models).
-      차단돼 있어도 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.
+  [i] Copilot AI 요약 — AI 릴리스 노트 생성(선택)
+      기본은 꺼져 있습니다 (version.yml의 copilot_ai: false).
+      켜면 GitHub Copilot AI Credits가 소비됩니다 — 조직은 'Allow use of Copilot CLI billed to the organization' 정책이 필요합니다.
+      꺼져 있거나 사용할 수 없으면 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.
 
   ✓ 문제를 찾지 못했습니다.
 ```
@@ -296,7 +303,7 @@ npx project-auto-wizard --no-semver-auto   # 항상 patch+1 (레거시 동작)
 
 ### 자체 AI PR 요약봇
 
-상용 PR 리뷰 SaaS 없이 동작하는 자체 요약봇입니다. 릴리스 브랜치(`--main-branch`)를 대상으로 하는 PR이 열릴 때 API 키 0개 AI 엔진 체인으로 요약 코멘트를 자동으로 답니다.
+상용 PR 리뷰 SaaS 없이 동작하는 자체 요약봇입니다. 릴리스 브랜치(`--main-branch`)를 대상으로 하는 PR이 열릴 때 요약 엔진 체인(기본은 규칙 기반, Copilot은 선택)으로 요약 코멘트를 자동으로 답니다.
 
 기본 설치(pr-flow) 기준으로 일상적인 기능 PR은 `develop`을 대상으로 열리므로, 이 봇은 develop→main 릴리스 PR에서만 실제로 동작합니다 — 해당 PR에서는 `AUTO-CHANGELOG-CONTROL`이 이미 같은 엔진으로 체인지로그 요약을 생성하므로, 이 봇은 그 요약을 PR 코멘트 형태로도 남겨주는 보조 역할입니다. 릴리스 브랜치 = 개발 브랜치인 trunk-based 모드에서는 모든 PR이 곧 릴리스 대상 브랜치를 향하므로 매 PR마다 동작합니다.
 
@@ -308,7 +315,7 @@ npx project-auto-wizard --no-semver-auto   # 항상 patch+1 (레거시 동작)
 |---|---|
 | **`WORKFLOW_PAT` secret** (선택 — 속도 최적화용) | 없어도 `GITHUB_TOKEN` 폴백이 automerge부터 Release 발행까지 자동으로 이어갑니다(실제 병합 후 최대 ~20초 추가). 더 빠르게 하고 싶다면 Settings → Secrets → Actions에 `WORKFLOW_PAT` (scopes: `repo`, `workflow`) 등록 — 반드시 개인 계정이 아닌 조직 bot/machine 계정으로 발급하세요 |
 | **Workflow permissions** | Settings → Actions → Workflow permissions: **Read and write** |
-| **GitHub Models** | 기본 활성 — 별도 설정 불필요. 조직 정책으로 차단된 경우 자동으로 규칙 fallback |
+| **Copilot AI 요약** (선택) | 기본 꺼짐. 켜려면 마법사에서 선택하거나 `version.yml`의 `copilot_ai`를 `true`로 — AI Credits가 소비되며 조직은 "Allow use of Copilot CLI billed to the organization" 정책이 필요합니다. 사용할 수 없으면 자동으로 규칙 fallback |
 
 ## 설계 원칙
 

package/package.json

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

package/payload/scripts/changelog_manager.py

@@ -27,7 +27,9 @@ import html
 import json
 import os
 import re
+import subprocess
 import sys
+import tempfile
 import traceback
 import urllib.error
 import urllib.request
@@ -123,7 +125,7 @@ def _parse_markdown_sections(md_content: str) -> dict:
     """
     섹션 파서: `### 카테고리` 헤딩 + `- 항목` 불릿 형식.
 
-    AI 엔진 체인(사용자 지정 API → GitHub Models)과 규칙 기반 폴백이
+    AI 엔진 체인(사용자 지정 API → Copilot CLI)과 규칙 기반 폴백이
     동일하게 생성하는 형식이므로 1순위로 시도한다.
     """
     detected: dict[str, dict] = {}
@@ -389,21 +391,19 @@ def _ai_assisted_minor_upgrade(unclassified_lines: list[str]) -> bool:
         return False
     prompt = _BUMP_AI_PROMPT_PREFIX + "\n".join(f"- {line}" for line in unclassified_lines)
 
-    ai_api_key = os.environ.get('AI_API_KEY')
-    github_token = os.environ.get('GITHUB_TOKEN')
-    candidates = [
-        (ai_api_key, os.environ.get('AI_API_BASE_URL') or _AI_DEFAULT_BASE_URL, os.environ.get('AI_MODEL') or _AI_DEFAULT_MODEL),
-        (github_token, _AI_DEFAULT_BASE_URL, _AI_DEFAULT_MODEL),
-    ]
-    for token, base_url, model in candidates:
-        if not token:
-            continue
+    settings = _user_api_settings()
+    if settings:
+        api_key, base_url, model = settings
         try:
-            response = call_openai_compatible(base_url, token, model, prompt)
-            return response.strip() == 'MINOR'
+            return call_openai_compatible(base_url, api_key, model, prompt).strip() == 'MINOR'
         except Exception as e:
             print(f"[warn] bump AI assist failed: {e}", file=sys.stderr)
-            continue
+
+    if _copilot_enabled():
+        try:
+            return call_copilot_cli(prompt).strip() == 'MINOR'
+        except Exception as e:
+            print(f"[warn] bump AI assist (copilot) failed: {e}", file=sys.stderr)
     return False
 
 
@@ -694,8 +694,67 @@ def cmd_export_release_notes(version: str, output_path: str | None) -> int:
 
 # ------------------------ ai-summary 엔진 체인 ------------------------
 
-_AI_DEFAULT_BASE_URL = "https://models.github.ai/inference"
-_AI_DEFAULT_MODEL = "openai/gpt-4o-mini"
+_COPILOT_DEFAULT_MODEL = "claude-haiku-4.5"
+_COPILOT_TIMEOUT_SECONDS = 90
+
+
+def _user_api_settings() -> tuple[str, str, str] | None:
+    """사용자 지정 AI 티어 설정. AI_API_KEY와 AI_API_BASE_URL, AI_MODEL이 모두 있어야 한다.
+
+    키만 있고 URL·모델이 비어 있으면 그 키를 어디로도 보내지 않고 경고 후 건너뛴다
+    (종료된 기본 엔드포인트으로 사용자 키가 흘러가던 문제 방지)."""
+    api_key = os.environ.get('AI_API_KEY')
+    if not api_key:
+        return None
+    base_url = os.environ.get('AI_API_BASE_URL')
+    model = os.environ.get('AI_MODEL')
+    if not base_url or not model:
+        print(
+            "::warning::AI_API_KEY가 설정됐지만 AI_API_BASE_URL/AI_MODEL이 없어 사용자 API 티어를 건너뜁니다",
+            file=sys.stderr,
+        )
+        return None
+    return api_key, base_url, model
+
+
+def _copilot_enabled() -> bool:
+    """version.yml의 copilot_ai가 켜져 있고(워크플로우가 COPILOT_AI로 전달) 토큰이 있을 때만 True."""
+    return os.environ.get('COPILOT_AI', '').strip().lower() == 'true' and bool(os.environ.get('GITHUB_TOKEN'))
+
+
+def call_copilot_cli(prompt: str) -> str:
+    """Copilot CLI를 텍스트 생성 전용으로 호출해 응답 텍스트를 반환.
+
+    프롬프트에 필요한 정보가 이미 다 들어 있으므로 에이전트 기능은 전부 막는다:
+    빈 임시 디렉터리에서 실행하고, 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,
+            ],
+            cwd=workdir, stdin=subprocess.DEVNULL,
+            capture_output=True, text=True, timeout=_COPILOT_TIMEOUT_SECONDS,
+        )
+    if result.returncode != 0:
+        raise RuntimeError(f"copilot exited with {result.returncode}: {result.stderr.strip()[:200]}")
+    return result.stdout
+
+
+def _is_valid_copilot_summary(text: str) -> bool:
+    """프롬프트가 요구한 Markdown 형식인지 최소한만 검사한다.
+
+    섹션 헤딩('### ')이 하나도 없거나 코드펜스로 시작하는(통째로 감싼) 응답은 릴리스 노트로
+    쓰지 않는다."""
+    stripped = text.strip()
+    if not stripped or stripped.startswith('```'):
+        return False
+    return any(line.startswith('### ') for line in stripped.splitlines())
 
 
 def _build_ai_prompt(commit_lines: list[str], pr_title: str | None, version: str, diff_stat: str | None = None) -> str:
@@ -760,16 +819,13 @@ def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title:
         except Exception:
             diff_stat = None
 
-    ai_api_key = os.environ.get('AI_API_KEY')
-    ai_base_url = os.environ.get('AI_API_BASE_URL') or _AI_DEFAULT_BASE_URL
-    ai_model = os.environ.get('AI_MODEL') or _AI_DEFAULT_MODEL
-    github_token = os.environ.get('GITHUB_TOKEN')
-
     engine = None
     summary_text = None
     prompt = _build_ai_prompt(commit_lines, pr_title, version, diff_stat)
 
-    if ai_api_key:
+    settings = _user_api_settings()
+    if settings:
+        ai_api_key, ai_base_url, ai_model = settings
         try:
             candidate = call_openai_compatible(ai_base_url, ai_api_key, ai_model, prompt)
             if candidate and candidate.strip():
@@ -780,19 +836,16 @@ def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title:
         except Exception as e:
             print(f"[warn] user-api failed: {e}", file=sys.stderr)
 
-    if summary_text is None and github_token:
+    if summary_text is None and _copilot_enabled():
         try:
-            # GitHub Models는 자체 모델 카탈로그만 서빙한다 — 사용자 API용으로
-            # AI_MODEL이 오버라이드돼 있어도 여기서는 기본 모델을 쓴다
-            # (커스텀 모델명은 models.github.ai에서 404).
-            candidate = call_openai_compatible(_AI_DEFAULT_BASE_URL, github_token, _AI_DEFAULT_MODEL, prompt)
-            if candidate and candidate.strip():
+            candidate = call_copilot_cli(prompt)
+            if _is_valid_copilot_summary(candidate):
                 summary_text = candidate
-                engine = "github-models"
+                engine = "copilot"
             else:
-                print("[warn] github-models failed: empty content in response", file=sys.stderr)
+                print("[warn] copilot failed: empty or not in the requested Markdown format", file=sys.stderr)
         except Exception as e:
-            print(f"[warn] github-models failed: {e}", file=sys.stderr)
+            print(f"[warn] copilot failed: {e}", file=sys.stderr)
 
     if summary_text is None:
         classified = classify_commits(commit_lines)

package/payload/version.yml.template

@@ -6,6 +6,9 @@
 #   (default) — feat: commits bump minor, a `!` breaking marker on any commit
 #   type bumps major. Set semver_auto: false to always patch-bump instead
 #   (then edit major/minor manually, e.g., 1.0.5 -> 1.1.0 or 2.0.0).
+# - copilot_ai: opt-in (default false) — true lets the release/PR summary
+#   workflows call GitHub Copilot CLI, which consumes GitHub Copilot AI Credits.
+#   Falls back to rule-based summaries whenever Copilot is off or unavailable.
 # ===
 # Supported project types: spring, flutter, next, react, react-native,
 #                          react-native-expo, node, python, basic, go
@@ -47,6 +50,7 @@ metadata:
       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 (서버 배포 워크플로우)
 {{FLUTTER_OPTIONS}}
 {{DEPLOY}}

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

@@ -4,9 +4,9 @@
 # Self-hosted AI PR summary bot — no third-party service required.
 # ===================================================================
 #
-# Posts an AI-generated summary comment on PRs targeting the default
-# branch, using the same zero-API-key engine chain as the release
-# changelog (user API key -> GitHub Models -> rule-based fallback).
+# Posts a summary comment on PRs targeting the default branch, using the
+# same engine chain as the release changelog (user API key -> Copilot CLI,
+# opt-in via version.yml copilot_ai -> rule-based fallback).
 # The prompt includes commit subjects plus a capped `git diff --stat`.
 #
 # On release PRs (head branch == {{DEVELOP_BRANCH}}) this job is skipped.
@@ -30,7 +30,11 @@ on:
 permissions:
   contents: read
   pull-requests: write
-  models: read
+  copilot-requests: write
+
+concurrency:
+  group: ai-pr-summary-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
 
 jobs:
   ai-pr-summary:
@@ -46,6 +50,20 @@ jobs:
           fetch-depth: 0
           ref: ${{ github.event.pull_request.head.ref }}
 
+      - name: Read copilot_ai option from version.yml
+        id: copilot_options
+        run: |
+          # scoped to the metadata: -> template: -> options: chain so an
+          # unrelated "copilot_ai:" key can never hijack the value
+          COPILOT_AI=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?copilot_ai:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
+          echo "copilot_ai=$COPILOT_AI" >> $GITHUB_OUTPUT
+          echo "copilot_ai option: $COPILOT_AI"
+
+      - name: Install Copilot CLI
+        if: steps.copilot_options.outputs.copilot_ai == 'true'
+        continue-on-error: true
+        run: npm install -g @github/copilot@1.0.88
+
       - name: Generate and post AI summary
         env:
           PR_TITLE: ${{ github.event.pull_request.title }}
@@ -53,6 +71,8 @@ jobs:
           AI_API_BASE_URL: ${{ vars.AI_API_BASE_URL }}
           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)
@@ -68,17 +88,20 @@ jobs:
           fi
           rm -f _full_diff_stat.txt
 
-          python3 .github/scripts/changelog_manager.py ai-summary \
+          SUMMARY_RESULT=$(python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
             --version "$VERSION" \
             --output summary.md \
             --pr-title "$PR_TITLE" \
-            --diff-stat-file diff_stat.txt
+            --diff-stat-file diff_stat.txt | tail -n 1)
+          ENGINE=$(python3 -c 'import json,sys; print(json.loads(sys.argv[1]).get("engine") or "unknown")' "$SUMMARY_RESULT" 2>/dev/null || echo "unknown")
 
           {
-            echo "🤖 **AI Summary (project-auto-wizard)**"
+            echo "📋 **PR Summary (project-auto-wizard)**"
             echo ""
             cat summary.md
+            echo ""
+            echo "<sub>engine: ${ENGINE}</sub>"
           } > comment_body.md
 
           python3 -c 'import json; print(json.dumps({"body": open("comment_body.md", encoding="utf-8").read()}))' > comment_payload.json

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

@@ -12,8 +12,8 @@
 #      commits) and bumps accordingly.
 #    - Otherwise: always patch+1 (legacy behavior).
 # 2. Generates the release summary locally with changelog_manager.py
-#    ai-summary (engine chain: user API key -> GitHub Models -> rule-based
-#    fallback; always succeeds, no third-party service involved)
+#    ai-summary (engine chain: user API key -> Copilot CLI, opt-in via
+#    version.yml copilot_ai -> rule-based fallback; always succeeds)
 #    - The AI prompt includes commit subjects plus a capped
 #      `git diff --stat` (file-level change summary, no diff body)
 #      for richer context without token-cost blowup.
@@ -34,8 +34,10 @@
 # - secrets.WORKFLOW_PAT: PAT used for the merge. Without it the merge is
 #   performed with GITHUB_TOKEN, and GitHub will NOT trigger downstream
 #   {{MAIN_BRANCH}}-push workflows (e.g. RELEASE-PUBLISH) for that merge.
-# - secrets.AI_API_KEY (+ vars.AI_API_BASE_URL / vars.AI_MODEL): preferred
-#   summary engine. Falls back to GitHub Models, then to rule-based.
+# - 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),
+#   then to rule-based.
 #
 # Issue #90: without WORKFLOW_PAT, a wait-for-merge-and-trigger-release job
 # polls until the automerge actually lands, then wakes RELEASE-PUBLISH via
@@ -60,7 +62,7 @@ on:
 permissions:
   contents: write
   pull-requests: write
-  models: read
+  copilot-requests: write
 
 jobs:
   changelog-and-merge:
@@ -94,6 +96,20 @@ jobs:
           echo "semver_auto=$SEMVER_AUTO" >> $GITHUB_OUTPUT
           echo "semver_auto option: $SEMVER_AUTO"
 
+      - name: Read copilot_ai option from version.yml
+        id: copilot_options
+        run: |
+          # scoped to the metadata: -> template: -> options: chain so an
+          # unrelated "copilot_ai:" key can never hijack the value
+          COPILOT_AI=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?copilot_ai:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
+          echo "copilot_ai=$COPILOT_AI" >> $GITHUB_OUTPUT
+          echo "copilot_ai option: $COPILOT_AI"
+
+      - name: Install Copilot CLI
+        if: steps.copilot_options.outputs.copilot_ai == 'true'
+        continue-on-error: true
+        run: npm install -g @github/copilot@1.0.88
+
       - name: Collect commits since last release
         id: collect
         run: |
@@ -149,6 +165,8 @@ jobs:
           AI_API_BASE_URL: ${{ vars.AI_API_BASE_URL }}
           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
@@ -175,6 +193,7 @@ jobs:
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
 
       - name: Generate summary with the AI engine chain
+        id: summary
         env:
           # PR title goes through the env block — never inline-interpolate
           # untrusted text into the shell string (quote injection).
@@ -183,28 +202,37 @@ jobs:
           AI_API_BASE_URL: ${{ vars.AI_API_BASE_URL }}
           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)
 
-          python3 .github/scripts/changelog_manager.py ai-summary \
+          SUMMARY_RESULT=$(python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
             --version "$VERSION" \
             --output summary.md \
             --pr-title "$PR_TITLE" \
-            --diff-stat-file diff_stat.txt
+            --diff-stat-file diff_stat.txt | tail -n 1)
+          ENGINE=$(python3 -c 'import json,sys; print(json.loads(sys.argv[1]).get("engine") or "unknown")' "$SUMMARY_RESULT" 2>/dev/null || echo "unknown")
+          echo "summary engine: $ENGINE"
+          echo "engine=$ENGINE" >> $GITHUB_OUTPUT
 
           # update-from-summary reads ./pr_body.md
           cp summary.md pr_body.md
 
       - name: Post AI summary comment
         continue-on-error: true
+        env:
+          ENGINE: ${{ steps.summary.outputs.engine }}
         run: |
           PR_NUMBER=${{ github.event.pull_request.number }}
 
           {
-            echo "🤖 **AI Summary (project-auto-wizard)**"
+            echo "📋 **PR Summary (project-auto-wizard)**"
             echo ""
             cat summary.md
+            echo ""
+            echo "<sub>engine: ${ENGINE:-unknown}</sub>"
           } > comment_body.md
 
           python3 -c 'import json; print(json.dumps({"body": open("comment_body.md", encoding="utf-8").read()}))' > comment_payload.json

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

@@ -59,7 +59,7 @@ on:
 
 permissions:
   contents: write
-  models: read
+  copilot-requests: write
 
 jobs:
   release:
@@ -160,6 +160,28 @@ jobs:
           echo "semver_auto=$SEMVER_AUTO" >> $GITHUB_OUTPUT
           echo "semver_auto option: $SEMVER_AUTO"
 
+      - name: Read copilot_ai option from version.yml
+        id: copilot_options
+        if: >-
+          steps.gate.outputs.proceed == 'true' &&
+          steps.mode.outputs.mode == 'trunk-based' &&
+          github.event_name == 'push'
+        run: |
+          # scoped to the metadata: -> template: -> options: chain so an
+          # unrelated "copilot_ai:" key can never hijack the value
+          COPILOT_AI=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?copilot_ai:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
+          echo "copilot_ai=$COPILOT_AI" >> $GITHUB_OUTPUT
+          echo "copilot_ai option: $COPILOT_AI"
+
+      - name: Install Copilot CLI
+        if: >-
+          steps.gate.outputs.proceed == 'true' &&
+          steps.mode.outputs.mode == 'trunk-based' &&
+          github.event_name == 'push' &&
+          steps.copilot_options.outputs.copilot_ai == 'true'
+        continue-on-error: true
+        run: npm install -g @github/copilot@1.0.88
+
       - name: Trunk-based version bump + changelog
         if: >-
           steps.gate.outputs.proceed == 'true' &&
@@ -170,6 +192,8 @@ jobs:
           AI_API_BASE_URL: ${{ vars.AI_API_BASE_URL }}
           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/src/cli/args.js

@@ -15,6 +15,7 @@ export function parseArgs(argv) {
     includeNexus: null,      // null=미설정
     includeSecretBackup: null,
     includeSemverAuto: null,  // --semver-auto / --no-semver-auto (기본 true — 미지정 시 다운스트림에서 해석)
+    includeCopilotAi: null,   // --copilot / --no-copilot (기본 false — AI Credits를 소비하는 opt-in)
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     mainBranch: "",          // 릴리스 브랜치 (--main-branch). 빈값=감지된 default branch
     developBranch: "",       // 개발 브랜치 (--develop-branch). 빈값=develop
@@ -139,6 +140,12 @@ export function parseArgs(argv) {
       case "--no-semver-auto":
         if (seenFlags.has("--semver-auto")) throw new CliError("--semver-auto와 --no-semver-auto는 동시에 지정할 수 없습니다");
         seenFlags.add("--no-semver-auto"); result.includeSemverAuto = false; break;
+      case "--copilot":
+        if (seenFlags.has("--no-copilot")) throw new CliError("--copilot과 --no-copilot은 동시에 지정할 수 없습니다");
+        seenFlags.add("--copilot"); result.includeCopilotAi = true; break;
+      case "--no-copilot":
+        if (seenFlags.has("--copilot")) throw new CliError("--copilot과 --no-copilot은 동시에 지정할 수 없습니다");
+        seenFlags.add("--no-copilot"); result.includeCopilotAi = false; break;
       case "--paths": result.pathsCsv = args.shift() ?? ""; break;
       case "--main-branch": {
         const v = args.shift();

package/src/cli/help.js

@@ -1,5 +1,5 @@
 // --help 텍스트.
-export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-native AI 릴리스 자동화 설치 마법사
+export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-native 릴리스 자동화 설치 마법사
 
 사용법:
   npx project-auto-wizard [옵션]
@@ -24,6 +24,7 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
       --nexus / --no-nexus            라이브러리 publish 워크플로우 포함/제외 (Nexus + GitHub Packages)
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
+      --copilot / --no-copilot  Copilot으로 AI 요약 생성 (기본: 사용 안 함, GitHub Copilot AI Credits 소비)
       --force              full 실행에 필수 (모든 확인 생략, 비대화형 기본값 사용)
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/uninstall 지원)
       --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거

package/src/commands/doctor.js

@@ -161,10 +161,11 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   }
 
   add({
-    name: "GitHub Models 활성화", label: "GitHub Models", purpose: "AI 릴리스 노트 생성", status: "INFO",
+    name: "Copilot AI 요약", label: "Copilot AI 요약", purpose: "AI 릴리스 노트 생성(선택)", status: "INFO",
     note: [
-      "조직 정책으로 차단됐는지는 자동으로 확인할 수 없습니다 (Settings → Models).",
-      "차단돼 있어도 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.",
+      "기본은 꺼져 있습니다 (version.yml의 copilot_ai: false).",
+      "켜면 GitHub Copilot AI Credits가 소비됩니다 — 조직은 'Allow use of Copilot CLI billed to the organization' 정책이 필요합니다.",
+      "꺼져 있거나 사용할 수 없으면 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.",
     ],
   });
 

package/src/commands/interactive.js

@@ -88,6 +88,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   let includeNexus = existing?.options?.nexus ?? false;
   let includeSecretBackup = existing?.options?.secretBackup ?? false;
   let includeSemverAuto = existing?.options?.semverAuto ?? null;
+  let includeCopilotAi = existing?.options?.copilotAi ?? null;
   // 서버 배포 방식 — 저장값(version.yml)이 있으면 재질문하지 않는다 (nexus/secret_backup과 같은 규약).
   let deployStyle = isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : "";
   const showOptional = mode === "full";
@@ -153,11 +154,18 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       const y2 = await io.askYesNo("자동 버전 승격을 사용하시겠습니까? (커밋 타입에 따라 major/minor/patch 자동 결정)", true);
       includeSemverAuto = y2 === true;
     }
+
+    // Copilot AI 요약 — AI Credits를 소비하므로 opt-in(기본 No). 저장값 있으면 재질문 생략.
+    if (mode === "full" && includeCopilotAi === null) {
+      const y3 = await io.askYesNo("Copilot으로 AI 요약을 생성하시겠습니까? (GitHub Copilot AI Credits가 소비되며, 사용할 수 없으면 자동으로 규칙 기반 요약으로 전환됩니다)", false);
+      includeCopilotAi = y3 === true;
+    }
   }
   // 질문이 실제로 나온 경우(위 full 모드 질문) 답변을 그대로 존중.
   // 질문이 안 나온 경우(version/workflows 모드) — 기존 설치는 안전하게 false로 폴백,
   // 완전 신규 설치만 true(기존 설계) 유지 — CLI 경로(index.js)와 동일한 안전 정책.
   includeSemverAuto = includeSemverAuto === null ? (existing ? false : true) : includeSemverAuto !== false;
+  includeCopilotAi = includeCopilotAi === true;
 
   // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
   let paths = new Map();
@@ -278,6 +286,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     mode, force: true, types, version, versionCode, branch, branches, paths,
     includeNexus, includeSecretBackup,
     includeSemverAuto,
+    includeCopilotAi,
     repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
     // 설치 로그(#79)·완료 요약(#80)이 쓰는 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     markers, envAnswers, detectWarnings,

package/src/commands/status.js

@@ -69,8 +69,9 @@ export function printStatus(status) {
   }
   const boolLabel = (v) => (v === null ? "미설정(기본 false)" : v);
   const semverAutoLabel = status.options.semverAuto === null ? "미설정(기본 false)" : status.options.semverAuto;
+  const copilotAiLabel = boolLabel(status.options.copilotAi ?? null);
   const flutterLabels = status.types.includes("flutter") ? flutterOptionLabels(status.options) : "";
-  lines.push(`옵션            : nexus=${boolLabel(status.options.nexus)} secret_backup=${boolLabel(status.options.secretBackup)} semver_auto=${semverAutoLabel}${flutterLabels}`);
+  lines.push(`옵션            : nexus=${boolLabel(status.options.nexus)} secret_backup=${boolLabel(status.options.secretBackup)} semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${flutterLabels}`);
   if (status.modifiedFiles.length) {
     lines.push("", `사용자가 수정한 워크플로우 파일 (${status.modifiedFiles.length}개):`);
     for (const f of status.modifiedFiles) lines.push(`  - ${f}`);

package/src/context.js

@@ -27,6 +27,7 @@ export function createContext(overrides = {}) {
     includeNexus: null,      // null=미설정, true/false=명시
     includeSecretBackup: null,
     includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
+    includeCopilotAi: null,  // null=미설정(다운스트림에서 false로 해석), true/false=명시 — Copilot AI 요약 opt-in
     // Flutter 옵션 (이슈 #131) — Flutter 타입이 없는 프로젝트에서는 전부 무시된다.
     // 결정은 src/core/flutter-options.js의 resolveFlutterOptions가 한다.
     envMode: "",             // "dart-define" | "dotenv". ""=미결정 → 템플릿 기본값(dart-define)

package/src/core/verify.js

@@ -43,7 +43,7 @@ export function scanUnsubstituted(workflowsDir, filenames = []) {
 const AUTO_SECRETS = new Set(["GITHUB_TOKEN"]);
 // 없어도 워크플로우가 도는 secret — 폴백이 문서화돼 있다. 필수와 섞어 "등록해야 동작합니다"라고
 // 하면 안내 자체를 못 믿게 되므로 분리한다.
-//   AI_API_KEY   → 없으면 GitHub Models(무료) → 규칙 fallback
+//   AI_API_KEY   → 없으면 Copilot(opt-in, copilot_ai) → 규칙 fallback
 //   WORKFLOW_PAT → 없으면 GITHUB_TOKEN
 export const OPTIONAL_SECRETS = new Set(["AI_API_KEY", "WORKFLOW_PAT"]);
 const SECRET_RE = /secrets\.([A-Z][A-Z0-9_]*)/g;

package/src/core/version-yml.js

@@ -44,13 +44,13 @@ const FLUTTER_OPTION_KEYS = {
 };
 
 // metadata.template.options 상태머신 파싱 (.sh read_template_options L2361~2416 등가).
-// 반환: { nexus: bool|null, secretBackup: bool|null, semverAuto: bool|null, deployStyle: string|null,
+// 반환: { nexus: bool|null, secretBackup: bool|null, semverAuto: bool|null, copilotAi: bool|null, deployStyle: string|null,
 //         envMode/flutterStore/androidDeployMode/iosDeployMode: string|null } — null=미기재.
 // 구 synology·coderabbit 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다(파싱 에러 없음).
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
   const out = {
-    nexus: null, secretBackup: null, semverAuto: null, deployStyle: null,
+    nexus: null, secretBackup: null, semverAuto: null, copilotAi: null, deployStyle: null,
     envMode: null, flutterStore: null, androidDeployMode: null, iosDeployMode: null,
   };
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
@@ -88,6 +88,13 @@ export function parseTemplateOptions(content) {
         if (v === "false") out.semverAuto = false;
         continue;
       }
+      m = line.match(/^\s+copilot_ai:\s*(.+)/);
+      if (m) {
+        const v = strip(m[1]);
+        if (v === "true") out.copilotAi = true;
+        if (v === "false") out.copilotAi = false;
+        continue;
+      }
       // 들여쓰기 0~4칸의 다른 키 → options 섹션 종료 (.sh L2404~2408)
       if (/^\s{0,4}[a-z_]+:/.test(line)) { inOptions = false; inTemplate = false; }
     }
@@ -204,7 +211,7 @@ export function buildVersionYml({
   const b = branches || { main: branch || "main", develop: "develop", mode: "pr-flow" };
   const {
     templateVersion = "unknown", includeNexus = false, includeSecretBackup = false,
-    includeSemverAuto = true, deployStyle = "", optionsDate = today,
+    includeSemverAuto = true, includeCopilotAi = false, deployStyle = "", optionsDate = today,
   } = templateOptions || {};
 
   // project_paths 블록 (full-line 토큰 {{PROJECT_PATHS}} — 없으면 라인 제거)
@@ -244,6 +251,7 @@ export function buildVersionYml({
     MAIN_BRANCH: b.main, DEVELOP_BRANCH: b.develop, BRANCH_MODE: b.mode,
     OPT_NEXUS: String(includeNexus), OPT_SECRET_BACKUP: String(includeSecretBackup),
     OPT_SEMVER_AUTO: String(includeSemverAuto),
+    OPT_COPILOT_AI: String(includeCopilotAi),
     OPT_DEPLOY_STYLE: String(deployStyle || ""),
   };
 
@@ -273,7 +281,7 @@ export function buildVersionYml({
 export function renderVersionYml(context, templateText, { pathMarkers, deployValues = new Map(), extraTopLevel = [] }) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown", branches = null,
-    includeNexus = false, includeSecretBackup = false, includeSemverAuto, deployStyle,
+    includeNexus = false, includeSecretBackup = false, includeSemverAuto, includeCopilotAi, deployStyle,
     envMode, flutterStore, androidDeployMode, iosDeployMode } = context;
   return buildVersionYml({
     templateText, version, types, paths, pathMarkers, branch, branches, versionCode, now, today,
@@ -282,6 +290,7 @@ export function renderVersionYml(context, templateText, { pathMarkers, deployVal
     templateOptions: {
       templateVersion, includeNexus, includeSecretBackup,
       includeSemverAuto: includeSemverAuto !== false,
+      includeCopilotAi: includeCopilotAi === true,
       deployStyle: deployStyle || DEFAULT_DEPLOY_STYLE,
       optionsDate: today,
     },

package/src/index.js

@@ -290,6 +290,8 @@ async function runInner(argv, {
     // workflows-only 재실행) 조용히 true로 켜지면 애매한 커밋 하나로 major가 승격될 위험이 있다 —
     // 기존 설치는 false로 안전하게 폴백, 완전 신규 설치만 true(기존 설계) 유지.
     includeSemverAuto: opts.includeSemverAuto ?? existing?.options?.semverAuto ?? (existing ? false : true),
+    // Copilot AI 요약은 AI Credits를 소비하는 opt-in — 신규·기존 설치 모두 명시하지 않으면 false다.
+    includeCopilotAi: opts.includeCopilotAi ?? existing?.options?.copilotAi ?? false,
     repoName,
     // 실 resolver 4종 (.sh resolve_token 등가)
     resolvers: makeResolvers(cwd, repoName, paths, flutterOptions),

package/src/ui/summary.js

@@ -29,7 +29,7 @@ export function printSummary(ctx) {
     case "full":
       err("  ✅ 버전 관리 시스템 (version.yml)");
       err("  ✅ README.md 자동 버전 업데이트");
-      err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");
+      err("  ✅ GitHub Actions 워크플로우 (릴리스 자동화 포함)");
       if (gitignoreUpdated) err("  ✅ .gitignore 백업 파일 제외 항목 (*.bak/*.template.yaml)");
       break;
     case "version":
@@ -37,7 +37,7 @@ export function printSummary(ctx) {
       err("  ✅ README.md 자동 버전 업데이트");
       break;
     case "workflows":
-      err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");
+      err("  ✅ GitHub Actions 워크플로우 (릴리스 자동화 포함)");
       break;
   }
 
@@ -48,13 +48,13 @@ export function printSummary(ctx) {
     if (branches.mode === "trunk-based") {
       err(`  🌿 ${branches.main} 단일 브랜치 (trunk-based) — RELEASE-PUBLISH 하나가 버전확정→체인지로그→tag→Release를 순차 처리`);
     } else {
-      err(`  🌿 개발 ${branches.develop} → 릴리스 ${branches.main} (pr-flow) — 릴리스 PR에서 버전확정·AI 체인지로그·automerge`);
+      err(`  🌿 개발 ${branches.develop} → 릴리스 ${branches.main} (pr-flow) — 릴리스 PR에서 버전확정·체인지로그·automerge`);
     }
   }
   if (mode === "full" || mode === "workflows") {
     err("");
     err("릴리스 노트 요약 엔진:");
-    err("  🤖 AI_API_KEY(선택) → GitHub Models(기본·무료·API 키 불필요) → 규칙 fallback — 릴리스는 절대 막히지 않음");
+    err("  🤖 AI_API_KEY(선택) → Copilot(선택·AI Credits 소비, 기본 꺼짐) → 규칙 fallback — 릴리스는 절대 막히지 않음");
   }
 
   err("");