project-auto-wizard 0.11.0 → 0.12.1

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 안에서 자동으로 동작하도록 해 개발자가 기능 구현에 집중하도록 돕는 오픈소스 도구
 
@@ -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.10.0 (2026-09-21)
+## 최신 버전 : v0.12.0 (2026-09-24)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -38,7 +36,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 자동 배치 |
 
 ### 지원 프로젝트 타입
@@ -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 문서).
 
@@ -183,18 +181,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 +207,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"]
@@ -233,9 +236,8 @@ 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            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌
       --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
       --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거
@@ -270,9 +272,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 +299,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 +311,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.1",
+  "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/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

@@ -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
 
 
@@ -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,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/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

@@ -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
@@ -44,9 +47,8 @@ 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 (서버 배포 워크플로우)
 {{FLUTTER_OPTIONS}}
 {{DEPLOY}}

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

@@ -1,12 +1,10 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # PROJECT-COMMON-AI-PR-SUMMARY.yaml
 # 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.
@@ -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
 
@@ -30,7 +27,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 +47,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 +68,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 +85,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

@@ -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:
@@ -12,8 +10,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,14 +32,15 @@
 # - 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
+# 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
 
@@ -60,7 +59,7 @@ on:
 permissions:
   contents: write
   pull-requests: write
-  models: read
+  copilot-requests: write
 
 jobs:
   changelog-and-merge:
@@ -94,6 +93,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 +162,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 +190,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 +199,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-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