project-auto-wizard 0.1.6 → 0.1.7

package/README.md

@@ -16,7 +16,7 @@ npx project-auto-wizard
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.1.4 (2026-07-09)
+## 최신 버전 : v0.1.6 (2026-07-27)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -47,6 +47,32 @@ npx project-auto-wizard --mode full --force --type spring,react   # CI에서 비
 - **멀티타입**: `--type spring,react,python` — 한 레포에 여러 타입 공존
 - **모노레포**: `--paths "flutter=app,react=client"` — 타입별 서브폴더 지정 (마커 파일 자동 감지)
 
+### 질문 문구 커스터마이징
+
+마법사가 묻는 질문의 라벨·도움말·예시 문구는 `.github/config/wizard-prompts.yml`을 만들어 재정의할 수 있습니다(설치되지 않는 파일이라 직접 만들어야 합니다). 타입별로 다른 문구를 쓰고 싶으면 `{type}.KEY` 형태로 오버라이드합니다.
+
+```yaml
+PROJECT_NAME:
+  label: "프로젝트 이름이 뭔가요?"
+  help: "GitHub 레포 이름과 다르게 표시하고 싶을 때만 입력하세요."
+
+flutter.APP_ARTIFACT_NAME:
+  label: "Flutter 앱 아티팩트 이름"
+```
+
+### 타입별 워크플로우 구성
+
+`spring`/`flutter`는 아래처럼 단일 CI 이상으로 깊게 구성되어 있습니다:
+
+- **flutter**: Android(Firebase/Playstore/Selfhosted/TestAPK 배포), iOS(TestFlight/Test-TestFlight), CI, Lab 트리거까지 8종
+- **spring**: 무중단 배포 2종(Nginx/Traefik) + 단일 서버 배포 + PR 프리뷰 + Nexus publish(opt-in)
+- **react/next**: CI와 CI+CD 분리 구성
+- **python**: CI / PR 프리뷰 / SimpleCICD
+
+### 되돌리기(`--mode revert`)
+
+`npx project-auto-wizard --mode revert`는 payload가 설치한 파일명과 **정확히 일치하는 것만** 제거합니다. 사용자가 직접 만든 워크플로우, `version.yml`, `README.md`, `.gitignore`는 건드리지 않습니다. 설치 시 충돌 처리로 생성된 `.bak`/`.template.yaml` 파생 파일도 함께 정리됩니다.
+
 ## API 키 0개 AI — 요약 엔진 체인
 
 릴리스 노트는 4단 엔진 체인으로 생성됩니다. **어떤 단계가 실패해도 릴리스는 절대 막히지 않습니다.**
@@ -85,7 +111,7 @@ flowchart LR
 ```
 npx project-auto-wizard [옵션]
 
-  -m, --mode MODE          full | version | workflows  (기본: 대화형)
+  -m, --mode MODE          full | version | workflows | revert | status | doctor  (기본: 대화형)
   -t, --type CSV           spring,react,... (미지정 시 자동 감지)
       --project-version V  초기 버전 (미지정 시 자동 감지)
       --paths "t=p,..."    모노레포 타입별 경로
@@ -94,9 +120,44 @@ npx project-auto-wizard [옵션]
       --nexus              Nexus 라이브러리 publish 워크플로우 포함
       --secret-backup      Secret 서버 백업 워크플로우 포함
       --coderabbit         CodeRabbit PR 요약을 릴리스 노트 1순위로
+      --semver-auto        커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함, --no-semver-auto로 끔)
+      --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌
       --force              전 질문 생략 (CI용)
 ```
 
+## 설치 상태 확인 · 진단 · 미리보기
+
+```bash
+npx project-auto-wizard --mode status   # 설치 상태·드리프트 확인 (읽기 전용)
+npx project-auto-wizard --mode doctor   # 환경 진단 (읽기 전용, 규칙 기반)
+```
+
+| 명령 | 내용 |
+|---|---|
+| `--mode status` | 설치된 버전·타입·브랜치 모드·옵션값과, 설치 시점 대비 사용자가 직접 수정한 워크플로우 파일 목록을 보여줍니다. 네트워크 접근 없음(로컬 파일 비교만) |
+| `--mode doctor` | `version.yml` 설치 여부, `gh` CLI 설치/인증 상태, GitHub Actions workflow permissions, `WORKFLOW_PAT` secret 등록 여부, merge commit 허용 설정을 점검합니다. `gh api` 호출을 사용하므로 네트워크 접근이 발생합니다(규칙 기반 점검 — AI 진단 아님) |
+
+`--dry-run`을 어떤 모드와도 함께 쓰면 실제로 파일을 바꾸지 않고 무엇이 바뀔지만 미리 보여줍니다(`full`/`version`/`workflows`/`revert` 전체 지원):
+
+```bash
+npx project-auto-wizard --mode full --force --type node --dry-run
+```
+
+### 자동 semver 승격 (`--semver-auto`)
+
+기본적으로 켜져 있습니다. 커밋 메시지 컨벤션(`feat:` → minor, `!` 브레이킹 마커 → major, 그 외 → patch)을 기반으로 다음 버전을 자동으로 계산합니다. 분류가 애매한 커밋은 AI 엔진 체인이 patch→minor 승격 여부를 판단합니다. 끄면 기존과 동일하게 항상 patch+1입니다.
+
+```bash
+npx project-auto-wizard --semver-auto      # 기본값, 명시 지정도 가능
+npx project-auto-wizard --no-semver-auto   # 항상 patch+1 (레거시 동작)
+```
+
+### 자체 AI PR 요약봇
+
+CodeRabbit을 쓰지 않는 레포를 위한 대안입니다. `--coderabbit`을 켜지 않으면(기본값) 릴리스 브랜치(`--main-branch`)를 대상으로 하는 PR이 열릴 때 API 키 0개 AI 엔진 체인으로 요약 코멘트를 자동으로 답니다. `--coderabbit`을 켜면 CodeRabbit이 PR 요약을 전담하고 이 봇은 no-op으로 빠집니다(중복 방지, 상호 배타적).
+
+기본 설치(pr-flow) 기준으로 일상적인 기능 PR은 `develop`을 대상으로 열리므로, 이 봇은 develop→main 릴리스 PR에서만 실제로 동작합니다 — 해당 PR에서는 `AUTO-CHANGELOG-CONTROL`이 이미 같은 엔진으로 체인지로그 요약을 생성하므로, 이 봇은 그 요약을 PR 코멘트 형태로도 남겨주는 보조 역할입니다. 릴리스 브랜치 = 개발 브랜치인 trunk-based 모드에서는 모든 PR이 곧 릴리스 대상 브랜치를 향하므로 매 PR마다 동작합니다.
+
 ## 설치 후 확인할 것
 
 | 항목 | 내용 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",
@@ -18,7 +18,7 @@
   "scripts": {
     "test": "npm run test:node && npm run test:py",
     "test:node": "node --test \"tests/node/**/*.test.js\"",
-    "test:py": "python -m unittest discover -s tests/py -v"
+    "test:py": "python3 -m unittest discover -s tests/py -v"
   },
   "repository": {
     "type": "git",

package/payload/scripts/changelog_manager.py

@@ -252,6 +252,12 @@ _TIER2_BUCKET_MAP = {
 
 _FALLBACK_BUCKET_KEYS = ('feat', 'fix', 'chore', 'docs', 'refactor', 'test', 'changes')
 
+# 승격 폭 판단 전용 — 타입 뒤 `!` 마커(어떤 타입이든)는 breaking 신호.
+# BREAKING CHANGE: 본문 푸터는 지원하지 않는다(커밋 수집이 제목 한 줄만
+# 가져오는 구조라 본문에 접근 불가 — Conventional Commits 스펙 조항 13에
+# 따르면 `!` 마커 단독으로도 표준을 만족하므로 이는 표준이 허용하는 부분집합).
+_BREAKING_MARKER_RE = re.compile(r'^[a-zA-Z]+(\([^)]*\))?!:')
+
 
 def classify_commits(lines: list[str]) -> dict:
     """
@@ -335,6 +341,81 @@ def render_fallback_md(classified: dict, version: str) -> str:
     return "\n".join(lines).rstrip() + "\n"
 
 
+def classify_bump_level(lines: list[str]) -> str:
+    """커밋 제목 목록에서 semver 승격 폭을 규칙 기반으로 판단.
+
+    - 타입 뒤 `!` 마커 포함 -> major
+    - `feat:`(classify_commits의 feat 버킷과 동일 판정 기준) 포함 -> minor
+    - 그 외(매칭 실패 포함) -> patch
+    """
+    for raw_line in lines:
+        line = raw_line.strip()
+        if not line or '[skip ci]' in line or line.startswith('Merge '):
+            continue
+        if _BREAKING_MARKER_RE.match(line):
+            return 'major'
+    classified = classify_commits(lines)
+    return 'minor' if classified.get('feat') else 'patch'
+
+
+_BUMP_AI_PROMPT_PREFIX = (
+    "다음은 정해진 커밋 컨벤션을 따르지 않는 자유형식 커밋 메시지들이다.\n"
+    "이 중 사용자 대상 새로운 기능(feature) 추가로 보이는 것이 하나라도 있으면 정확히 MINOR라고만 답하고,\n"
+    "없으면 정확히 PATCH라고만 답해라. 다른 말은 절대 덧붙이지 마라.\n"
+    "커밋 목록:\n"
+)
+
+
+def _ai_assisted_minor_upgrade(unclassified_lines: list[str]) -> bool:
+    """규칙 분류가 patch일 때, 미분류 자유형식 커밋에 한해 AI에게 minor 업그레이드
+    여부만 보조 판단시킨다. AI는 절대 major를 만들 수 없다 — major는 항상 명시적
+    `!` 마커만 신뢰한다(classify_bump_level에서 이미 확정됨). 응답이 정확히
+    'MINOR'가 아니거나 호출이 실패하면 무조건 False(규칙 결과 patch 유지)."""
+    if not unclassified_lines:
+        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
+        try:
+            response = call_openai_compatible(base_url, token, model, prompt)
+            return response.strip() == 'MINOR'
+        except Exception as e:
+            print(f"[warn] bump AI assist failed: {e}", file=sys.stderr)
+            continue
+    return False
+
+
+def cmd_classify_bump(commits_file: str) -> int:
+    """커밋 목록 파일을 읽어 semver 승격 폭(major/minor/patch)을 stdout 마지막 줄에 출력.
+
+    규칙 우선(feat->minor, !마커->major, 그외->patch). 규칙 결과가 patch이고
+    분류 안 된 자유형식 커밋이 있으면, AI에게 patch->minor 업그레이드 여부만
+    보조 판단시킨다(major는 AI가 절대 만들 수 없음).
+    """
+    try:
+        with open(commits_file, 'r', encoding='utf-8') as f:
+            commit_lines = [line.rstrip('\n').rstrip('\r') for line in f]
+    except Exception:
+        commit_lines = []
+
+    bump = classify_bump_level(commit_lines)
+    if bump == 'patch':
+        classified = classify_commits(commit_lines)
+        if _ai_assisted_minor_upgrade(classified.get('changes') or []):
+            bump = 'minor'
+
+    print(bump)
+    return 0
+
+
 # ------------------------ 서브커맨드 구현부 ------------------------
 
 def cmd_update_from_summary() -> int:
@@ -580,7 +661,7 @@ _AI_DEFAULT_BASE_URL = "https://models.github.ai/inference"
 _AI_DEFAULT_MODEL = "openai/gpt-4o-mini"
 
 
-def _build_ai_prompt(commit_lines: list[str], pr_title: str | None, version: str) -> str:
+def _build_ai_prompt(commit_lines: list[str], pr_title: str | None, version: str, diff_stat: str | None = None) -> str:
     """AI에게 보낼 한국어 릴리즈 요약 프롬프트를 구성.
 
     요청하는 출력 형식은 규칙 기반 폴백 렌더러(render_fallback_md)와 동일한
@@ -596,6 +677,9 @@ def _build_ai_prompt(commit_lines: list[str], pr_title: str | None, version: str
     ]
     if pr_title:
         parts.append(f"PR 제목: {pr_title}")
+    if diff_stat and diff_stat.strip():
+        parts.append("파일별 변경 요약:")
+        parts.append(diff_stat.strip())
     parts.append("커밋 목록:")
     parts.extend(f"- {line}" for line in commit_lines)
     return "\n".join(parts)
@@ -623,7 +707,7 @@ def call_openai_compatible(base_url: str, token: str, model: str, prompt: str) -
     return body["choices"][0]["message"]["content"]
 
 
-def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title: str | None) -> int:
+def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title: str | None, diff_stat_file: str | None = None) -> int:
     """커밋 목록을 읽어 AI(우선) 또는 규칙 기반 폴백으로 릴리즈 요약을 생성."""
     try:
         with open(commits_file, 'r', encoding='utf-8') as f:
@@ -631,6 +715,14 @@ def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title:
     except Exception:
         commit_lines = []
 
+    diff_stat = None
+    if diff_stat_file:
+        try:
+            with open(diff_stat_file, 'r', encoding='utf-8') as f:
+                diff_stat = f.read()
+        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
@@ -638,7 +730,7 @@ def cmd_ai_summary(commits_file: str, version: str, output_path: str, pr_title:
 
     engine = None
     summary_text = None
-    prompt = _build_ai_prompt(commit_lines, pr_title, version)
+    prompt = _build_ai_prompt(commit_lines, pr_title, version, diff_stat)
 
     if ai_api_key:
         try:
@@ -699,6 +791,9 @@ def main(argv: list[str] | None = None) -> int:
     sub.add_parser('update-from-summary', help='PR body에서 CHANGELOG.json 갱신')
     sub.add_parser('generate-md', help='CHANGELOG.json → CHANGELOG.md 생성')
 
+    p_classify_bump = sub.add_parser('classify-bump', help='커밋 목록으로 semver 승격 폭(major/minor/patch) 판단')
+    p_classify_bump.add_argument('--commits-file', required=True, help='커밋 제목 목록 파일 (한 줄당 1개)')
+
     p_export = sub.add_parser('export', help='특정 버전 릴리즈 노트 추출')
     p_export.add_argument('--version', required=True, help='버전 번호')
     p_export.add_argument('--output', help='출력 파일 경로 (없으면 stdout)')
@@ -708,6 +803,7 @@ def main(argv: list[str] | None = None) -> int:
     p_ai_summary.add_argument('--version', required=True, help='버전 번호')
     p_ai_summary.add_argument('--output', required=True, help='요약 결과를 저장할 파일 경로')
     p_ai_summary.add_argument('--pr-title', help='PR 제목 (프롬프트 컨텍스트로 사용, 선택)')
+    p_ai_summary.add_argument('--diff-stat-file', help='git diff --stat 출력 파일 (프롬프트 컨텍스트 확장, 선택)')
 
     args = parser.parse_args(argv)
 
@@ -717,8 +813,10 @@ def main(argv: list[str] | None = None) -> int:
         return cmd_generate_md()
     if args.command == 'export':
         return cmd_export_release_notes(args.version, args.output)
+    if args.command == 'classify-bump':
+        return cmd_classify_bump(args.commits_file)
     if args.command == 'ai-summary':
-        return cmd_ai_summary(args.commits_file, args.version, args.output, args.pr_title)
+        return cmd_ai_summary(args.commits_file, args.version, args.output, args.pr_title, args.diff_stat_file)
     return 2
 
 

package/payload/scripts/version_manager.py

@@ -246,6 +246,17 @@ def increment_patch(version):
     return f"{major}.{minor}.{int(patch) + 1}"
 
 
+def increment_version(version, bump="patch"):
+    """bump: 'major'|'minor'|'patch'. 생략하면 기존과 동일하게 patch(increment_patch)로 동작."""
+    if bump == "major":
+        major, _minor, _patch = version.split(".")
+        return f"{int(major) + 1}.0.0"
+    if bump == "minor":
+        major, minor, _patch = version.split(".")
+        return f"{major}.{int(minor) + 1}.0"
+    return increment_patch(version)
+
+
 def compare_versions(v1, v2):
     """Return 1 if v1>v2, -1 if v1<v2, 0 if equal."""
     p1 = [int(x) for x in v1.split(".")]
@@ -553,7 +564,8 @@ def cmd_increment(args):
     if not validate_version(current_version):
         log(f"ERROR: invalid version format: {current_version}")
         return 1
-    new_version = increment_patch(current_version)
+    bump = getattr(args, "bump", None) or "patch"
+    new_version = increment_version(current_version, bump)
     update_all_versions(new_version)
 
     current_code = int(get_version_code())
@@ -587,7 +599,9 @@ def build_parser():
 
     sub.add_parser("get")
     sub.add_parser("get-code")
-    sub.add_parser("increment")
+    p_increment = sub.add_parser("increment")
+    p_increment.add_argument("--bump", choices=["major", "minor", "patch"], default="patch",
+                              help="승격 폭 (기본 patch — 지정 안 하면 기존 동작과 동일)")
     sub.add_parser("increment-code")
     sub.add_parser("sync")
 

package/payload/version.yml.template

@@ -2,8 +2,10 @@
 # Version format: x.y.z (semantic versioning)
 # - patch: auto-incremented by the release workflows
 # - version_code: monotonically increasing build number, bumped alongside version
-# - major/minor: NOT bumped automatically — edit this file manually
-#   (e.g., 1.0.5 -> 1.1.0 or 2.0.0)
+# - major/minor: auto-bumped when metadata.template.options.semver_auto is true
+#   (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).
 # ===
 # Supported project types: spring, flutter, next, react, react-native,
 #                          react-native-expo, node, python, basic
@@ -45,4 +47,5 @@ metadata:
       nexus: {{OPT_NEXUS}}
       secret_backup: {{OPT_SECRET_BACKUP}}
       coderabbit: {{OPT_CODERABBIT}}
+      semver_auto: {{OPT_SEMVER_AUTO}}
 {{DEPLOY}}

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

@@ -0,0 +1,98 @@
+# ===================================================================
+# PROJECT-COMMON-AI-PR-SUMMARY.yaml
+# Self-hosted AI PR summary bot — CodeRabbit-independent alternative.
+# ===================================================================
+#
+# 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).
+# The prompt includes commit subjects plus a capped `git diff --stat`.
+#
+# Mutually exclusive with CodeRabbit by design: if version.yml
+# metadata.template.options.coderabbit is true, this workflow no-ops
+# immediately — CodeRabbit already covers PR summaries, and posting
+# both on the same PR would be redundant/confusing.
+#
+# Independent from PROJECT-COMMON-AUTO-CHANGELOG-CONTROL: on release
+# PRs both workflows may call the AI engine once each, and when
+# semver_auto is on, AUTO-CHANGELOG-CONTROL's bump classification may
+# add a third AI-assisted call to resolve an ambiguous patch->minor
+# escalation (up to 3 LLM calls total). This is an accepted trade-off
+# for simplicity — GitHub Models is free-tier and rule-based fallback
+# is instant either way.
+# ===================================================================
+
+name: PROJECT-AI-PR-SUMMARY
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches: ["{{MAIN_BRANCH}}"]
+
+permissions:
+  contents: read
+  pull-requests: write
+  models: read
+
+jobs:
+  ai-pr-summary:
+    name: Post AI summary comment
+    if: github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout PR head
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.ref }}
+
+      - name: Read coderabbit option from version.yml
+        id: options
+        run: |
+          CODERABBIT=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?coderabbit:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
+          echo "coderabbit=$CODERABBIT" >> $GITHUB_OUTPUT
+
+      - name: Generate and post AI summary
+        if: steps.options.outputs.coderabbit != 'true'
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          AI_API_KEY: ${{ secrets.AI_API_KEY }}
+          AI_API_BASE_URL: ${{ vars.AI_API_BASE_URL }}
+          AI_MODEL: ${{ vars.AI_MODEL }}
+          GITHUB_TOKEN: ${{ github.token }}
+        run: |
+          PR_NUMBER=${{ github.event.pull_request.number }}
+          VERSION=$(python3 .github/scripts/version_manager.py get 2>/dev/null | tail -n 1)
+          VERSION=${VERSION:-unreleased}
+
+          git fetch origin {{MAIN_BRANCH}}
+          git log --pretty=%s "origin/{{MAIN_BRANCH}}..HEAD" > commits.txt
+          git diff --stat "origin/{{MAIN_BRANCH}}...HEAD" > _full_diff_stat.txt
+          if [ "$(wc -l < _full_diff_stat.txt)" -gt 49 ]; then
+            { head -49 _full_diff_stat.txt; tail -1 _full_diff_stat.txt; } > diff_stat.txt
+          else
+            cp _full_diff_stat.txt diff_stat.txt
+          fi
+          rm -f _full_diff_stat.txt
+
+          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
+
+          {
+            echo "🤖 **AI Summary (project-auto-wizard)**"
+            echo ""
+            cat summary.md
+          } > comment_body.md
+
+          python3 -c 'import json; print(json.dumps({"body": open("comment_body.md", encoding="utf-8").read()}))' > comment_payload.json
+
+          curl -sf -H "Authorization: token ${{ github.token }}" \
+               -H "Content-Type: application/json" \
+               -X POST \
+               -d @comment_payload.json \
+               "https://api.github.com/repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" > /dev/null \
+            || echo "comment post failed — continuing (this workflow never blocks the PR)"

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

@@ -4,7 +4,12 @@
 # ===================================================================
 #
 # Runs on release PRs ({{DEVELOP_BRANCH}} -> {{MAIN_BRANCH}}) and:
-# 1. Confirms the release version (patch +1 and sync of every version file)
+# 1. Confirms the release version and syncs every version file:
+#    - If version.yml metadata.template.options.semver_auto is true
+#      (default): classifies commits (feat -> minor, `!` marker -> major,
+#      else patch; AI-assisted patch->minor upgrade for unclassified
+#      commits) and bumps accordingly.
+#    - Otherwise: always patch+1 (legacy behavior).
 # 2. Acquires a release summary:
 #    - If version.yml metadata.template.options.coderabbit is true:
 #      requests a CodeRabbit summary comment once and polls the PR body
@@ -12,6 +17,9 @@
 #    - Otherwise (or on poll timeout): generates the summary locally with
 #      changelog_manager.py ai-summary (engine chain: user API key ->
 #      GitHub Models -> 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.
 # 3. Updates CHANGELOG.json / CHANGELOG.md and commits to the PR head
 #    branch with [skip ci]
 # 4. Enables automerge (gh pr merge --auto --merge)
@@ -81,6 +89,27 @@ jobs:
           echo "coderabbit=$CODERABBIT" >> $GITHUB_OUTPUT
           echo "coderabbit option: $CODERABBIT"
 
+      - name: Read semver_auto option from version.yml
+        id: semver_options
+        run: |
+          SEMVER_AUTO=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?semver_auto:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
+          echo "semver_auto=$SEMVER_AUTO" >> $GITHUB_OUTPUT
+          echo "semver_auto option: $SEMVER_AUTO"
+
+      - name: Collect commits since last release
+        id: collect
+        run: |
+          git fetch origin {{MAIN_BRANCH}}
+          git log --pretty=%s "origin/{{MAIN_BRANCH}}..HEAD" > commits.txt
+          git diff --stat "origin/{{MAIN_BRANCH}}...HEAD" > _full_diff_stat.txt
+          if [ "$(wc -l < _full_diff_stat.txt)" -gt 49 ]; then
+            { head -49 _full_diff_stat.txt; tail -1 _full_diff_stat.txt; } > diff_stat.txt
+          else
+            cp _full_diff_stat.txt diff_stat.txt
+          fi
+          rm -f _full_diff_stat.txt
+          echo "commits to summarize: $(wc -l < commits.txt)"
+
       - name: Request CodeRabbit summary (PR-body-init protection)
         id: coderabbit_request
         if: steps.options.outputs.coderabbit == 'true'
@@ -162,8 +191,13 @@ jobs:
             echo "summary_found=false" >> $GITHUB_OUTPUT
           fi
 
-      - name: Confirm release version (patch +1 and sync)
+      - name: Confirm release version (bump + sync)
         id: bump
+        env:
+          AI_API_KEY: ${{ secrets.AI_API_KEY }}
+          AI_API_BASE_URL: ${{ vars.AI_API_BASE_URL }}
+          AI_MODEL: ${{ vars.AI_MODEL }}
+          GITHUB_TOKEN: ${{ github.token }}
         run: |
           # Idempotency: if the PR head is already this workflow's own
           # version-confirm commit (re-run / synchronize retrigger), do not
@@ -173,13 +207,19 @@ jobs:
             NEW_VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
             echo "version already confirmed by a previous run — reusing $NEW_VERSION (no re-increment)"
           else
-            NEW_VERSION=$(python3 .github/scripts/version_manager.py increment | tail -n 1)
+            if [ "${{ steps.semver_options.outputs.semver_auto }}" = "true" ]; then
+              BUMP=$(python3 .github/scripts/changelog_manager.py classify-bump --commits-file commits.txt | tail -n 1)
+            else
+              BUMP="patch"
+            fi
+            echo "bump level: $BUMP"
+            NEW_VERSION=$(python3 .github/scripts/version_manager.py increment --bump "$BUMP" | tail -n 1)
             if [ -z "$NEW_VERSION" ]; then
               echo "version bump failed"
               exit 1
             fi
             python3 .github/scripts/version_manager.py sync
-            echo "release version confirmed: $NEW_VERSION"
+            echo "release version confirmed: $NEW_VERSION ($BUMP)"
           fi
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
 
@@ -196,15 +236,12 @@ jobs:
         run: |
           VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
 
-          git fetch origin {{MAIN_BRANCH}}
-          git log --pretty=%s "origin/{{MAIN_BRANCH}}..HEAD" > commits.txt
-          echo "commits to summarize: $(wc -l < commits.txt)"
-
           python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
             --version "$VERSION" \
             --output summary.md \
-            --pr-title "$PR_TITLE"
+            --pr-title "$PR_TITLE" \
+            --diff-stat-file diff_stat.txt
 
           # Feed the generated summary through the same channel the
           # CodeRabbit path uses: update-from-summary reads ./pr_body.md
@@ -234,7 +271,7 @@ jobs:
           VERSION="${{ steps.bump.outputs.new_version }}"
 
           # Working files must not land in the repo
-          rm -f pr_body.md summary.md commits.txt
+          rm -f pr_body.md summary.md commits.txt diff_stat.txt
 
           git add -A
 

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

@@ -13,10 +13,16 @@
 #   exits cleanly. Version + changelog were already confirmed in the PR.
 #
 # - trunk-based: every direct push to {{MAIN_BRANCH}} is a release.
-#   This job bumps the version (patch +1 and sync), summarizes the commits
-#   since the last tag with the ai-summary engine chain (user API ->
-#   GitHub Models -> rule-based fallback), updates CHANGELOG.json /
-#   CHANGELOG.md, and commits everything back with [skip ci].
+#   This job bumps the version and syncs it, summarizes the commits since
+#   the last tag with the ai-summary engine chain (user API -> GitHub
+#   Models -> rule-based fallback, diff-stat-enriched prompt), updates
+#   CHANGELOG.json / CHANGELOG.md, and commits everything back with
+#   [skip ci]. Same as pr-flow's AUTO-CHANGELOG-CONTROL:
+#   - If version.yml metadata.template.options.semver_auto is true
+#     (default): classifies commits (feat -> minor, `!` marker -> major,
+#     else patch; AI-assisted patch->minor upgrade for unclassified
+#     commits) and bumps accordingly.
+#   - Otherwise: always patch+1 (legacy behavior).
 #
 # Common tail (both modes): recovery-aware idempotency guard (tag and
 # release checked separately so a half-published release can be finished
@@ -102,6 +108,19 @@ jobs:
             echo "not a release-confirm push in pr-flow mode — skipping (clean exit)"
           fi
 
+      - name: Read semver_auto option from version.yml
+        id: semver_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 "semver_auto:" key can never hijack the value
+          SEMVER_AUTO=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?semver_auto:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
+          echo "semver_auto=$SEMVER_AUTO" >> $GITHUB_OUTPUT
+          echo "semver_auto option: $SEMVER_AUTO"
+
       - name: Trunk-based version bump + changelog
         if: >-
           steps.gate.outputs.proceed == 'true' &&
@@ -123,28 +142,48 @@ jobs:
             exit 0
           fi
 
-          NEW_VERSION=$(python3 .github/scripts/version_manager.py increment | tail -n 1)
-          if [ -z "$NEW_VERSION" ]; then
-            echo "version bump failed"
-            exit 1
-          fi
-          python3 .github/scripts/version_manager.py sync
-          echo "release version: $NEW_VERSION"
-
-          # Commits since the last tag (fall back to full history on first release)
+          # Commits (and diff-stat) since the last tag — this is "what's in
+          # this release" for trunk-based pushes. Fall back to the full
+          # history / a diff against the empty tree on the first-ever
+          # release (no previous tag to diff against).
           LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
           if [ -n "$LAST_TAG" ]; then
             echo "collecting commits since $LAST_TAG"
             git log --pretty=%s "${LAST_TAG}..HEAD" > commits.txt
+            DIFF_BASE="$LAST_TAG"
           else
             echo "no previous tag — collecting the full history"
             git log --pretty=%s > commits.txt
+            DIFF_BASE="4b825dc642cb6eb9a060e54bf8d69288fbee4904" # git empty tree hash
           fi
+          git diff --stat "${DIFF_BASE}..HEAD" > _full_diff_stat.txt
+          if [ "$(wc -l < _full_diff_stat.txt)" -gt 49 ]; then
+            { head -49 _full_diff_stat.txt; tail -1 _full_diff_stat.txt; } > diff_stat.txt
+          else
+            cp _full_diff_stat.txt diff_stat.txt
+          fi
+          rm -f _full_diff_stat.txt
+
+          if [ "${{ steps.semver_options.outputs.semver_auto }}" = "true" ]; then
+            BUMP=$(python3 .github/scripts/changelog_manager.py classify-bump --commits-file commits.txt | tail -n 1)
+          else
+            BUMP="patch"
+          fi
+          echo "bump level: $BUMP"
+
+          NEW_VERSION=$(python3 .github/scripts/version_manager.py increment --bump "$BUMP" | tail -n 1)
+          if [ -z "$NEW_VERSION" ]; then
+            echo "version bump failed"
+            exit 1
+          fi
+          python3 .github/scripts/version_manager.py sync
+          echo "release version: $NEW_VERSION ($BUMP)"
 
           python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
             --version "$NEW_VERSION" \
-            --output summary.md
+            --output summary.md \
+            --diff-stat-file diff_stat.txt
 
           # Same input channel as AUTO-CHANGELOG-CONTROL:
           # update-from-summary reads ./pr_body.md
@@ -165,7 +204,7 @@ jobs:
           python3 .github/scripts/changelog_manager.py update-from-summary
           python3 .github/scripts/changelog_manager.py generate-md
 
-          rm -f pr_body.md summary.md commits.txt
+          rm -f pr_body.md summary.md commits.txt diff_stat.txt
 
           git add -A
           if git diff --staged --quiet; then