project-auto-wizard 0.1.9 → 0.1.11

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.9 (2026-08-02)
+## 최신 버전 : v0.1.11 (2026-08-03)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -75,26 +75,25 @@ flutter.APP_ARTIFACT_NAME:
 
 ### 완전 삭제(`--mode uninstall`)
 
-`npx project-auto-wizard --mode uninstall`은 `revert`보다 넓게 제거합니다 — 워크플로우·스크립트·`.coderabbit.yaml`은 물론, README.md의 `AUTO-VERSION-SECTION` 버전 섹션과 `.gitignore`에 자동 추가된 항목, `version.yml`까지 선택적으로 제거할 수 있습니다.
+`npx project-auto-wizard --mode uninstall`은 `revert`보다 넓게 제거합니다 — 워크플로우·스크립트는 물론, README.md의 `AUTO-VERSION-SECTION` 버전 섹션과 `.gitignore`에 자동 추가된 항목, `version.yml`까지 선택적으로 제거할 수 있습니다.
 
-- **대화형(TTY)**: 실제로 설치된 항목만 체크리스트로 보여줍니다. 워크플로우/스크립트/`.coderabbit.yaml`은 기본 체크, README·`.gitignore`·`version.yml`은 opt-in입니다. 선택 후 최종 확인(기본 "아니오")을 거쳐야 실제로 삭제됩니다.
-- **비대화형(`--force`)**: 워크플로우·스크립트·`.coderabbit.yaml`만 기본 삭제합니다. README·`.gitignore`·`version.yml`까지 지우려면 `--purge-readme`/`--purge-gitignore`/`--purge-version`을 함께 지정하세요.
+- **대화형(TTY)**: 실제로 설치된 항목만 체크리스트로 보여줍니다. 워크플로우·스크립트는 기본 체크, README·`.gitignore`·`version.yml`은 opt-in입니다. 선택 후 최종 확인(기본 "아니오")을 거쳐야 실제로 삭제됩니다.
+- **비대화형(`--force`)**: 워크플로우·스크립트만 기본 삭제합니다. README·`.gitignore`·`version.yml`까지 지우려면 `--purge-readme`/`--purge-gitignore`/`--purge-version`을 함께 지정하세요.
 - `--dry-run`과 함께 쓰면 무엇이 지워질지 미리 볼 수 있습니다.
 
 ```bash
 npx project-auto-wizard --mode uninstall                 # 대화형 체크리스트
-npx project-auto-wizard --mode uninstall --force         # 워크플로우·스크립트·coderabbit만 안전 삭제
+npx project-auto-wizard --mode uninstall --force         # 워크플로우·스크립트만 안전 삭제
 npx project-auto-wizard --mode uninstall --force --purge-readme --purge-gitignore --purge-version  # 완전 삭제
 ```
 
 ## API 키 0개 AI — 요약 엔진 체인
 
-릴리스 노트는 4단 엔진 체인으로 생성됩니다. **어떤 단계가 실패해도 릴리스는 절대 막히지 않습니다.**
+릴리스 노트는 3단 엔진 체인으로 생성됩니다. **상용 서드파티 서비스에 전혀 의존하지 않으며, 어떤 단계가 실패해도 릴리스는 절대 막히지 않습니다.**
 
 ```mermaid
 flowchart LR
-    A["CodeRabbit PR 요약<br/>(opt-in, 30s×10 폴링)"] -->|"미도착/미사용"| B["사용자 지정 AI<br/>(AI_API_KEY)"]
-    B -->|"키 없음/실패"| C["GitHub Models<br/>(GITHUB_TOKEN만, 무료)"]
+    B["사용자 지정 AI<br/>(AI_API_KEY)"] -->|"키 없음/실패"| C["GitHub Models<br/>(GITHUB_TOKEN만, 무료)"]
     C -->|"rate limit/실패"| D["규칙 기반 fallback<br/>(항상 성공)"]
 ```
 
@@ -133,7 +132,6 @@ npx project-auto-wizard [옵션]
       --develop-branch B   개발 브랜치 (기본: develop)
       --nexus              Nexus 라이브러리 publish 워크플로우 포함
       --secret-backup      Secret 서버 백업 워크플로우 포함
-      --coderabbit         CodeRabbit PR 요약을 릴리스 노트 1순위로
       --semver-auto        커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함, --no-semver-auto로 끔)
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌
       --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
@@ -171,7 +169,7 @@ 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 리뷰 SaaS 없이 동작하는 자체 요약봇입니다. 릴리스 브랜치(`--main-branch`)를 대상으로 하는 PR이 열릴 때 API 키 0개 AI 엔진 체인으로 요약 코멘트를 자동으로 답니다.
 
 기본 설치(pr-flow) 기준으로 일상적인 기능 PR은 `develop`을 대상으로 열리므로, 이 봇은 develop→main 릴리스 PR에서만 실제로 동작합니다 — 해당 PR에서는 `AUTO-CHANGELOG-CONTROL`이 이미 같은 엔진으로 체인지로그 요약을 생성하므로, 이 봇은 그 요약을 PR 코멘트 형태로도 남겨주는 보조 역할입니다. 릴리스 브랜치 = 개발 브랜치인 trunk-based 모드에서는 모든 PR이 곧 릴리스 대상 브랜치를 향하므로 매 PR마다 동작합니다.
 
@@ -207,7 +205,7 @@ flowchart TB
 ## 개발
 
 ```bash
-npm test          # node --test + python unittest (py 51 + node 59)
+npm test          # node --test + python unittest (node 219 + py 87)
 npm run test:node
 npm run test:py
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/payload/scripts/changelog_manager.py

@@ -5,7 +5,7 @@ changelog_manager.py
 통합 체인지로그 매니저 스크립트.
 
 서브커맨드:
-  - update-from-summary: CodeRabbit Summary Markdown을 파싱하여 CHANGELOG.json 갱신
+  - update-from-summary: 릴리즈 요약 Markdown을 파싱하여 CHANGELOG.json 갱신
   - generate-md        : CHANGELOG.json을 기반으로 CHANGELOG.md 재생성
   - export             : 특정 버전의 릴리즈 노트를 생성하여 stdout 또는 파일로 저장
   - ai-summary         : 커밋 목록으로부터 AI(또는 규칙 기반 폴백) 릴리즈 요약 생성
@@ -46,9 +46,8 @@ def _clean_summary_noise(text: str) -> str:
 
     제거 대상:
     1. HTML 주석 (<!-- ... -->)
-    2. CodeRabbit Tip 메시지
-    3. 남은 HTML 태그
-    4. 연속된 빈 줄
+    2. 남은 HTML 태그
+    3. 연속된 빈 줄
     """
     if not text:
         return text
@@ -56,15 +55,10 @@ def _clean_summary_noise(text: str) -> str:
     # 1. HTML 주석 제거
     text = re.sub(r'<!--.*?-->', '', text, flags=re.DOTALL)
 
-    # 2. CodeRabbit Tip 줄 제거
-    text = re.sub(r'^.*?✏️\s*Tip:.*$', '', text, flags=re.MULTILINE)
-    text = re.sub(r'<sub>.*?Tip:.*?</sub>', '', text, flags=re.IGNORECASE | re.DOTALL)
-    text = re.sub(r'^\s*Tip:.*$', '', text, flags=re.MULTILINE | re.IGNORECASE)
-
-    # 3. 남은 HTML 태그 제거
+    # 2. 남은 HTML 태그 제거
     text = re.sub(r'<[^>]+>', '', text)
 
-    # 4. 연속된 빈 줄 정리 (3개 이상 → 2개)
+    # 3. 연속된 빈 줄 정리 (3개 이상 → 2개)
     text = re.sub(r'\n{3,}', '\n\n', text)
 
     return text.strip()
@@ -80,27 +74,27 @@ def _make_safe_key(title: str, idx: int) -> str:
 
 def _parse_summary_markdown(md_content: str) -> dict:
     """
-    Markdown 형식의 CodeRabbit Summary 파싱.
+    릴리즈 요약 Markdown을 카테고리/항목으로 파싱.
 
     3단계 폴백 전략:
-    1. 정밀 파싱 (현재 CodeRabbit 형식)
-    2. 관대한 파싱 (형식 변형 대응)
+    1. 섹션 파싱 (AI 엔진 체인·규칙 기반 폴백이 실제로 생성하는 형식)
+    2. 관대한 파싱 (중첩 불릿 등 형식 변형 대응)
     3. 휴리스틱 파싱 (최후 수단)
 
-    예상 형식:
-    ## Summary by CodeRabbit
+    예상 형식 (_build_ai_prompt / render_fallback_md가 지정하는 형식):
+    ## [1.2.3]
 
-    * **버그 수정**
-      * OCR 입력 처리 개선
-      * 빈 콘텐츠 응답 오류 감지 강화
+    ### ✨ 기능
+    - 사용자 로그인 추가
+    - 대시보드 위젯 추가
 
-    * **Chores**
-      * 버전 0.1.39로 업그레이드
+    ### 🐛 수정
+    - 널 포인터 예외 수정
     """
-    # 1단계: 정밀 파싱
-    detected = _parse_markdown_precise(md_content)
+    # 1단계: 섹션 파싱
+    detected = _parse_markdown_sections(md_content)
     if detected:
-        print("  → 정밀 파서 성공")
+        print("  → 섹션 파서 성공")
         return detected
 
     # 2단계: 관대한 파싱
@@ -116,33 +110,51 @@ def _parse_summary_markdown(md_content: str) -> dict:
     return detected
 
 
-def _parse_markdown_precise(md_content: str) -> dict:
+# `## [1.2.3]` / `## v1.2.3` 처럼 카테고리가 아니라 릴리즈 버전을 가리키는 헤더
+_VERSION_HEADING_RE = re.compile(r'^\[?\s*v?\d+(?:\.\d+)*\s*\]?$')
+
+_HEADING_RE = re.compile(r'^\s{0,3}(#{2,6})\s+(.+?)\s*#*\s*$')
+_BULLET_RE = re.compile(r'^\s*[\*\-\+]\s+(.+?)\s*$')
+
+
+def _parse_markdown_sections(md_content: str) -> dict:
     """
-    정밀 파서: 현재 CodeRabbit 형식에 최적화.
+    섹션 파서: `### 카테고리` 헤딩 + `- 항목` 불릿 형식.
 
-    형식: * **카테고리**\n  * 항목
+    AI 엔진 체인(사용자 지정 API → GitHub Models)과 규칙 기반 폴백이
+    동일하게 생성하는 형식이므로 1순위로 시도한다.
     """
     detected: dict[str, dict] = {}
+    order: list[str] = []
+    current_key = None
 
-    # 패턴: * **카테고리** (bold, 들여쓰기 2칸)
-    pattern = r'\*\s*\*\*(.+?)\*\*\s*\n((?:\s{2}\*\s+.+(?:\n|$))*)'
-    matches = re.findall(pattern, md_content, re.MULTILINE)
-
-    for idx, (category_title, items_text) in enumerate(matches):
-        category_title = category_title.strip()
-
-        # 항목 추출: "  * 항목 내용"
-        items = re.findall(r'\s{2}\*\s+(.+)', items_text)
-        items = [item.strip() for item in items if item.strip()]
+    for line in md_content.split('\n'):
+        heading = _HEADING_RE.match(line)
+        if heading:
+            title = heading.group(2).strip()
+            # 버전 헤더(`## [1.2.3]`)는 카테고리가 아니다
+            if not title or _VERSION_HEADING_RE.match(title):
+                current_key = None
+                continue
+            key = _make_safe_key(title, len(order))
+            if key not in detected:
+                detected[key] = {'title': title, 'items': []}
+                order.append(key)
+            current_key = key
+            continue
 
-        if not category_title and not items:
+        if current_key is None:
             continue
 
-        safe_key = _make_safe_key(category_title, idx)
-        detected[safe_key] = {
-            'title': category_title,
-            'items': items,
-        }
+        bullet = _BULLET_RE.match(line)
+        if bullet:
+            item = bullet.group(1).strip()
+            if item:
+                detected[current_key]['items'].append(item)
+
+    # 헤딩만 있고 항목이 하나도 없으면 이 형식이 아니라고 보고 다음 파서로 넘긴다
+    if not any(entry['items'] for entry in detected.values()):
+        return {}
 
     return detected
 

package/payload/version.yml.template

@@ -46,6 +46,5 @@ metadata:
     options:
       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

@@ -1,6 +1,6 @@
 # ===================================================================
 # PROJECT-COMMON-AI-PR-SUMMARY.yaml
-# Self-hosted AI PR summary bot — CodeRabbit-independent alternative.
+# Self-hosted AI PR summary bot — no third-party service required.
 # ===================================================================
 #
 # Posts an AI-generated summary comment on PRs targeting the default
@@ -8,11 +8,6 @@
 # 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
@@ -46,14 +41,7 @@ jobs:
           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 }}

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

@@ -10,13 +10,9 @@
 #      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
-#      (30s x 10 polls = 5 minutes max)
-#    - 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)
+# 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)
 #    - 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.
@@ -80,15 +76,6 @@ jobs:
           git config --local user.email "action@github.com"
           git config --local user.name "GitHub Action"
 
-      - name: Read coderabbit option from version.yml
-        id: options
-        run: |
-          # scoped to the metadata: -> template: -> options: chain so an
-          # unrelated "coderabbit:" key can never hijack the value
-          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
-          echo "coderabbit option: $CODERABBIT"
-
       - name: Read semver_auto option from version.yml
         id: semver_options
         run: |
@@ -110,87 +97,6 @@ jobs:
           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'
-        run: |
-          PR_NUMBER=${{ github.event.pull_request.number }}
-
-          # The PR body can lag right after open (API replication) —
-          # retry the read up to 3 times before deciding.
-          CURRENT_BODY=""
-          for attempt in 1 2 3; do
-            CURRENT_BODY=$(curl -s -H "Authorization: token ${{ github.token }}" \
-                                "https://api.github.com/repos/${{ github.repository }}/pulls/${PR_NUMBER}" | \
-                                jq -r '.body // ""')
-            if [ -n "$CURRENT_BODY" ] && [ "$CURRENT_BODY" != "null" ]; then
-              echo "[try $attempt] body length=$(printf '%s' "$CURRENT_BODY" | wc -c)"
-              break
-            fi
-            echo "[try $attempt] body empty — possible replication lag, retrying"
-            sleep 2
-          done
-
-          if printf '%s\n' "$CURRENT_BODY" | grep -q "Summary by CodeRabbit"; then
-            # Protection: a summary already exists — never wipe it, never re-request
-            echo "Summary by CodeRabbit already present — skipping request"
-            echo "already_found=true" >> $GITHUB_OUTPUT
-          else
-            echo "already_found=false" >> $GITHUB_OUTPUT
-            echo "requesting CodeRabbit summary on PR #$PR_NUMBER"
-            curl -s -H "Authorization: token ${{ github.token }}" \
-                 -H "Content-Type: application/json" \
-                 -X POST \
-                 -d '{"body": "@coderabbitai summary"}' \
-                 "https://api.github.com/repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" > /dev/null
-            echo "CodeRabbit summary requested"
-          fi
-
-      - name: Poll PR body for CodeRabbit summary (30s x 10 polls = 5 minutes max)
-        id: poll
-        if: steps.options.outputs.coderabbit == 'true'
-        run: |
-          PR_NUMBER=${{ github.event.pull_request.number }}
-
-          if [ "${{ steps.coderabbit_request.outputs.already_found }}" = "true" ]; then
-            echo "summary already present — skipping poll"
-            curl -s -H "Authorization: token ${{ github.token }}" \
-                 "https://api.github.com/repos/${{ github.repository }}/pulls/${PR_NUMBER}" | \
-                 jq -r '.body // ""' > pr_body.md
-            echo "summary_found=true" >> $GITHUB_OUTPUT
-            exit 0
-          fi
-
-          MAX_POLLS=10
-          POLL_INTERVAL=30
-          FOUND=false
-
-          for i in $(seq 1 $MAX_POLLS); do
-            echo "[$i/$MAX_POLLS] checking PR body... ($(date '+%H:%M:%S'))"
-
-            PR_BODY=$(curl -s -H "Authorization: token ${{ github.token }}" \
-                           "https://api.github.com/repos/${{ github.repository }}/pulls/${PR_NUMBER}" | \
-                           jq -r '.body // ""')
-
-            if [ -n "$PR_BODY" ] && [ "$PR_BODY" != "null" ] && printf '%s\n' "$PR_BODY" | grep -q "Summary by CodeRabbit"; then
-              echo "CodeRabbit summary found"
-              printf '%s\n' "$PR_BODY" > pr_body.md
-              FOUND=true
-              break
-            fi
-
-            if [ "$i" -lt "$MAX_POLLS" ]; then
-              sleep $POLL_INTERVAL
-            fi
-          done
-
-          if [ "$FOUND" = "true" ]; then
-            echo "summary_found=true" >> $GITHUB_OUTPUT
-          else
-            echo "no CodeRabbit summary after 5 minutes — falling back to ai-summary"
-            echo "summary_found=false" >> $GITHUB_OUTPUT
-          fi
-
       - name: Confirm release version (bump + sync)
         id: bump
         env:
@@ -223,8 +129,7 @@ jobs:
           fi
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
 
-      - name: Generate summary with the AI engine chain (fallback path)
-        if: steps.options.outputs.coderabbit != 'true' || steps.poll.outputs.summary_found != 'true'
+      - name: Generate summary with the AI engine chain
         env:
           # PR title goes through the env block — never inline-interpolate
           # untrusted text into the shell string (quote injection).
@@ -243,8 +148,7 @@ jobs:
             --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
+          # update-from-summary reads ./pr_body.md
           cp summary.md pr_body.md
 
       - name: Update CHANGELOG from summary

package/src/cli/args.js

@@ -10,7 +10,6 @@ export function parseArgs(argv) {
     primaryType: "",
     includeNexus: null,      // null=미설정
     includeSecretBackup: null,
-    includeCodeRabbit: null, // --coderabbit / --no-coderabbit (기본 false — DESIGN-SPEC §4 질문②)
     includeSemverAuto: null,  // --semver-auto / --no-semver-auto (기본 true — 미지정 시 다운스트림에서 해석)
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     mainBranch: "",          // 릴리스 브랜치 (--main-branch). 빈값=감지된 default branch
@@ -31,7 +30,6 @@ export function parseArgs(argv) {
     keepChangelog: false,
     keepWorkflows: false,
     keepScripts: false,
-    keepCoderabbit: false,
   };
   const args = [...argv];
   while (args.length > 0) {
@@ -76,13 +74,10 @@ export function parseArgs(argv) {
       case "--keep-changelog": result.keepChangelog = true; break;
       case "--keep-workflows": result.keepWorkflows = true; break;
       case "--keep-scripts": result.keepScripts = true; break;
-      case "--keep-coderabbit": result.keepCoderabbit = true; break;
       case "--nexus": result.includeNexus = true; break;
       case "--no-nexus": result.includeNexus = false; break;
       case "--secret-backup": result.includeSecretBackup = true; break;
       case "--no-secret-backup": result.includeSecretBackup = false; break;
-      case "--coderabbit": result.includeCodeRabbit = true; break;
-      case "--no-coderabbit": result.includeCodeRabbit = false; break;
       case "--semver-auto": result.includeSemverAuto = true; break;
       case "--no-semver-auto": result.includeSemverAuto = false; break;
       case "--paths": result.pathsCsv = args.shift() ?? ""; break;

package/src/cli/help.js

@@ -18,7 +18,6 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
       --develop-branch B   개발 브랜치 (기본: develop). 릴리스 브랜치와 같으면 trunk-based 모드
       --nexus / --no-nexus            Nexus 라이브러리 publish 워크플로우 포함/제외
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
-      --coderabbit / --no-coderabbit  CodeRabbit PR 요약을 릴리스 노트 1순위로 사용 (기본: 사용 안 함)
       --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
       --force              모든 확인 생략, 비대화형 기본값 사용
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/version/workflows/revert/uninstall 전체 지원)

package/src/commands/dry-run.js

@@ -13,7 +13,7 @@ import { markerForType } from "../core/detect.js";
 function versionYmlPreview(context, payloadRoot, targetRoot) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown",
-    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false,
+    includeNexus = false, includeSecretBackup = false,
     includeSemverAuto } = context;
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
@@ -22,7 +22,6 @@ function versionYmlPreview(context, payloadRoot, targetRoot) {
     version, types, paths, pathMarkers, branch, branches: context.branches, versionCode, now, today,
     templateOptions: {
       templateVersion, includeNexus, includeSecretBackup,
-      includeCodeRabbit: includeCodeRabbit === true,
       includeSemverAuto: includeSemverAuto !== false,
       optionsDate: today,
     },
@@ -57,14 +56,12 @@ export function printDryRun(plan) {
     for (const f of r.workflows) lines.push(`  - ${f}`);
     lines.push(`제거될 스크립트 (${r.scripts.length}개):`);
     for (const f of r.scripts) lines.push(`  - ${f}`);
-    if (r.coderabbit) lines.push("제거될 파일: .coderabbit.yaml");
   } else if (plan.mode === "uninstall") {
     const u = plan.uninstall;
     lines.push(`제거될 워크플로우 (${u.workflows.length}개):`);
     for (const f of u.workflows) lines.push(`  - ${f}`);
     lines.push(`제거될 스크립트 (${u.scripts.length}개):`);
     for (const f of u.scripts) lines.push(`  - ${f}`);
-    if (u.coderabbit) lines.push("제거될 파일: .coderabbit.yaml");
     if (u.readme) lines.push("제거될 항목: README.md 버전 섹션 (AUTO-VERSION-SECTION)");
     if (u.gitignore) lines.push("제거될 항목: .gitignore 자동 추가 항목");
     if (u.versionYml) lines.push("제거될 파일: version.yml");

package/src/commands/full.js

@@ -1,5 +1,6 @@
 // full 모드 오케스트레이터 (.sh execute_integration full case 등가).
-// 복사 순서: workflows(+env 치환) → version.yml → readme → scripts → coderabbit → gitignore
+// 복사 순서: workflows(+env 치환) → version.yml → readme → scripts → gitignore(조건부)
+// gitignore는 충돌 백업 부산물(.bak/.template.yaml)이 이번 실행에서 실제로 생겼을 때만 갱신한다 — issue #7.
 // (원본의 util/issue/discussion/setup-guide/config 설치는 project-auto-wizard 스코프에서 제외 — DESIGN-SPEC §2)
 import { join } from "node:path";
 import { writeText } from "../core/fsutil.js";
@@ -10,7 +11,6 @@ import { markerForType } from "../core/detect.js";
 import { addVersionSectionToReadme } from "../core/copy/readme.js";
 import { copyWorkflows } from "../core/copy/workflows.js";
 import { copyScripts } from "../core/copy/simple.js";
-import { copyCoderabbit } from "../core/copy/coderabbit.js";
 import { ensureGitignore } from "../core/copy/gitignore.js";
 
 // context: { version, types, paths:Map, branch, versionCode, includeNexus, includeSecretBackup,
@@ -19,7 +19,7 @@ import { ensureGitignore } from "../core/copy/gitignore.js";
 export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     force = true, now, today, templateVersion = "unknown",
-    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false,
+    includeNexus = false, includeSecretBackup = false,
     includeSemverAuto } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
@@ -37,7 +37,7 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
       templateText: readVersionYmlTemplate(payloadRoot),
       version, types, paths, pathMarkers, branch, branches: context.branches, versionCode, now, today,
       deployValues,
-      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeCodeRabbit: includeCodeRabbit === true, includeSemverAuto: includeSemverAuto !== false, optionsDate: today },
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeSemverAuto: includeSemverAuto !== false, optionsDate: today },
     }));
 
   // 3. README 버전 섹션
@@ -46,9 +46,10 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   // 4. scripts (payload/scripts/*.py → .github/scripts/)
   copyScripts(payloadRoot, targetRoot);
 
-  // 5. coderabbit (opt-in true일 때만 — DESIGN-SPEC §4 질문②) / gitignore
-  if (includeCodeRabbit === true) copyCoderabbit(payloadRoot, { force }, targetRoot);
-  ensureGitignore(targetRoot);
+  // 5. gitignore — 워크플로우 충돌 처리가 .bak나 .template.yaml을 실제로 만든 경우에만 갱신한다.
+  //    충돌 없는 설치(대부분의 최초 설치)는 .gitignore를 전혀 건드리지 않는다 — issue #7.
+  const gitignoreUpdated = wfCounters.backupAdded > 0 || wfCounters.templateAdded > 0;
+  if (gitignoreUpdated) ensureGitignore(targetRoot);
 
-  return { workflows: wfCounters };
+  return { workflows: wfCounters, gitignoreUpdated };
 }

package/src/commands/interactive.js

@@ -49,7 +49,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     const ok = await io.askYesNo("마법사가 설치한 워크플로우·스크립트를 제거할까요? (version.yml·README는 보존)", false);
     if (ok !== true) { io.cancelMessage?.("되돌리기를 취소했습니다."); return 0; }
     const r = runRevert({}, payload, cwd);
-    io.note?.(`워크플로우 ${r.workflows.length}개, 스크립트 ${r.scripts.length}개 제거${r.coderabbit ? " + .coderabbit.yaml" : ""}`, "되돌리기 완료");
+    io.note?.(`워크플로우 ${r.workflows.length}개, 스크립트 ${r.scripts.length}개 제거`, "되돌리기 완료");
     io.outro?.("되돌리기를 마쳤습니다.");
     return 0;
   }
@@ -78,7 +78,6 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   // 선택 워크플로우 초기값: version.yml 저장 옵션 (.sh read_template_options L2361 등가)
   let includeNexus = existing?.options?.nexus ?? false;
   let includeSecretBackup = existing?.options?.secretBackup ?? false;
-  let includeCodeRabbit = existing?.options?.coderabbit ?? null;
   let includeSemverAuto = existing?.options?.semverAuto ?? null;
   const showOptional = mode === "full" || mode === "workflows";
   const realTty = process.stdout.isTTY === true;
@@ -97,12 +96,6 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     includeNexus = r.nexus;
     includeSecretBackup = r.secretBackup;
 
-    // 신규 질문 ② — CodeRabbit opt-in (DESIGN-SPEC §4, 기본 아니오). 저장값 있으면 재질문 생략.
-    if (includeCodeRabbit === null) {
-      const y = await io.askYesNo("CodeRabbit을 사용합니까? (PR AI 리뷰·요약을 릴리스 노트 1순위로 사용)", false);
-      includeCodeRabbit = y === true;
-    }
-
     // 신규 질문 — 자동 semver 승격 (기본 ON). 저장값 있으면 재질문 생략.
     // version.yml을 쓰지 않는 workflows 모드에서는 답변이 무의미하므로 full에서만 질문한다.
     if (mode === "full" && includeSemverAuto === null) {
@@ -110,7 +103,6 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       includeSemverAuto = y2 === true;
     }
   }
-  includeCodeRabbit = includeCodeRabbit === true;
   // 질문이 실제로 나온 경우(위 full 모드 질문) 답변을 그대로 존중.
   // 질문이 안 나온 경우(version/workflows 모드) — 기존 설치는 안전하게 false로 폴백,
   // 완전 신규 설치만 true(기존 설계) 유지 — CLI 경로(index.js)와 동일한 안전 정책.
@@ -209,7 +201,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const { now, today } = clock || utcNow();
   const ctx = createContext({
     mode, force: true, types, version, versionCode, branch, branches, paths,
-    includeNexus, includeSecretBackup, includeCodeRabbit,
+    includeNexus, includeSecretBackup,
     includeSemverAuto,
     repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
   });
@@ -247,8 +239,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
 
   // 완료 요약 (.sh print_summary L5438)
   io.summary?.({
-    mode, types, version, branches, includeCodeRabbit,
+    mode, types, version, branches,
     counters: { workflows: result?.workflows?.copied ?? 0 },
+    gitignoreUpdated: result?.gitignoreUpdated === true,
   }, cwd);
   io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
   return 0;

package/src/commands/purge.js

@@ -1,10 +1,10 @@
-// purge 모드 — revert가 지우는 전부(워크플로우·스크립트·coderabbit) + version.yml·README
+// purge 모드 — revert가 지우는 전부(워크플로우·스크립트) + version.yml·README
 // AUTO-VERSION-SECTION 블록·CHANGELOG를 추가로 제거해 설치 이전 상태로 완전히 되돌린다.
 // 개발·테스트 전용 숨김 모드 — DESIGN-SPEC purge #6.
 // develop 브랜치 삭제는 파일 삭제와 성격이 달라(실행 시점 git 상태 판단 필요) 여기 plan에는
 // 포함하지 않고 index.js의 purge 분기에서 직접 처리한다.
 import { join } from "node:path";
-import { existsSync, renameSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { PATHS } from "../core/paths.js";
 import { remove } from "../core/fsutil.js";
 import { planRevert } from "./revert.js";
@@ -12,14 +12,13 @@ import { removeVersionSectionFromReadme, hasVersionSection } from "../core/copy/
 
 const CHANGELOG_FILES = ["CHANGELOG.json", "CHANGELOG.md"];
 
-// keepFlags: { versionYml, readme, changelog, workflows, scripts, coderabbit } — true인 카테고리는 후보에서 제외.
-// 반환: { workflows, scripts, coderabbit, versionYml, readmeSection, changelog } — 아무것도 지우지 않는 순수 함수.
+// keepFlags: { versionYml, readme, changelog, workflows, scripts } — true인 카테고리는 후보에서 제외.
+// 반환: { workflows, scripts, versionYml, readmeSection, changelog } — 아무것도 지우지 않는 순수 함수.
 export function planPurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   const revertPlan = planRevert(payloadRoot, targetRoot);
   return {
     workflows: keepFlags.workflows ? [] : revertPlan.workflows,
     scripts: keepFlags.scripts ? [] : revertPlan.scripts,
-    coderabbit: keepFlags.coderabbit ? false : revertPlan.coderabbit,
     versionYml: !keepFlags.versionYml && existsSync(join(targetRoot, PATHS.versionFile)),
     readmeSection: !keepFlags.readme && hasVersionSection(targetRoot),
     changelog: keepFlags.changelog ? [] : CHANGELOG_FILES.filter((f) => existsSync(join(targetRoot, f))),
@@ -37,7 +36,6 @@ export function printPurgePlan(plan, { dryRun = false } = {}) {
   for (const f of plan.workflows) lines.push(`  - ${f}`);
   lines.push(`스크립트 (${plan.scripts.length}개):`);
   for (const f of plan.scripts) lines.push(`  - ${f}`);
-  if (plan.coderabbit) lines.push("파일: .coderabbit.yaml");
   if (plan.versionYml) lines.push("파일: version.yml");
   if (plan.readmeSection) lines.push("README.md: AUTO-VERSION-SECTION 블록");
   for (const f of plan.changelog) lines.push(`파일: ${f}`);
@@ -57,11 +55,6 @@ export function executePurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   const wfDir = join(targetRoot, PATHS.workflowsDir);
   for (const name of plan.workflows) remove(join(wfDir, name));
   for (const name of plan.scripts) remove(join(targetRoot, PATHS.scriptsDir, name));
-  if (plan.coderabbit) {
-    const cr = join(targetRoot, ".coderabbit.yaml");
-    remove(cr);
-    if (existsSync(cr + ".bak")) renameSync(cr + ".bak", cr);
-  }
   if (plan.versionYml) remove(join(targetRoot, PATHS.versionFile));
   const readmeSection = plan.readmeSection && removeVersionSectionFromReadme(targetRoot) === "removed";
   for (const f of plan.changelog) remove(join(targetRoot, f));
@@ -76,11 +69,10 @@ export function printPurgeResult(result) {
   for (const f of result.workflows) lines.push(`  - ${f}`);
   lines.push(`스크립트 (${result.scripts.length}개):`);
   for (const f of result.scripts) lines.push(`  - ${f}`);
-  if (result.coderabbit) lines.push("파일: .coderabbit.yaml");
   if (result.versionYml) lines.push("파일: version.yml");
   if (result.readmeSection) lines.push("README.md: AUTO-VERSION-SECTION 블록");
   for (const f of result.changelog) lines.push(`파일: ${f}`);
-  lines.push("(.gitignore 자동 추가 블록은 보존됩니다 — 별도 이슈에서 다룸)");
+  lines.push("(.gitignore에 추가된 백업 파일 제외 항목(*.bak/*.template.yaml)은 purge 대상에서 제외되어 그대로 보존됩니다)");
   lines.push("");
   console.log(lines.join("\n"));
 }

package/src/commands/revert.js

@@ -3,7 +3,7 @@
 // 사용자가 직접 만든 워크플로우·version.yml·README·.gitignore는 건드리지 않는다
 // (version.yml은 사용자 버전 데이터 — 제거 대상이 아니라 산출물이다).
 import { join } from "node:path";
-import { existsSync, readdirSync, readFileSync, renameSync } from "node:fs";
+import { existsSync, readdirSync } from "node:fs";
 import { PATHS, PAYLOAD } from "../core/paths.js";
 import { remove } from "../core/fsutil.js";
 
@@ -37,25 +37,14 @@ export function planRevert(payloadRoot, targetRoot = ".") {
   for (const s of ["version_manager.py", "changelog_manager.py"]) {
     if (existsSync(join(targetRoot, PATHS.scriptsDir, s))) removedScripts.push(s);
   }
-  let coderabbit = false;
-  const cr = join(targetRoot, ".coderabbit.yaml");
-  const crSrc = join(payloadRoot, "coderabbit.yaml");
-  if (existsSync(cr) && existsSync(crSrc) && readFileSync(cr, "utf8") === readFileSync(crSrc, "utf8")) {
-    coderabbit = true;
-  }
-  return { workflows: removedWf, scripts: removedScripts, coderabbit };
+  return { workflows: removedWf, scripts: removedScripts };
 }
 
-// 반환: { workflows: [...제거된 파일명], scripts: [...], coderabbit: bool } — planRevert와 동일한 형태.
+// 반환: { workflows: [...제거된 파일명], scripts: [...] } — planRevert와 동일한 형태.
 export function runRevert(context, payloadRoot, targetRoot = ".") {
   const plan = planRevert(payloadRoot, targetRoot);
   const wfDir = join(targetRoot, PATHS.workflowsDir);
   for (const name of plan.workflows) remove(join(wfDir, name));
   for (const name of plan.scripts) remove(join(targetRoot, PATHS.scriptsDir, name));
-  if (plan.coderabbit) {
-    const cr = join(targetRoot, ".coderabbit.yaml");
-    remove(cr);
-    if (existsSync(cr + ".bak")) renameSync(cr + ".bak", cr);
-  }
   return plan;
 }

package/src/commands/status.js

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

package/src/commands/uninstall.js

@@ -1,7 +1,7 @@
 // uninstall 모드 — revert(payload 파일명 일치분)보다 넓게, README/.gitignore/version.yml까지 선택적으로 제거.
 // 대화형 체크리스트 또는 --force + --purge-* 로 항목별 opt-in. revert.js는 건드리지 않고 읽기 전용으로만 재사용한다.
 import { join } from "node:path";
-import { existsSync, renameSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { PATHS } from "../core/paths.js";
 import { remove } from "../core/fsutil.js";
 import { planRevert } from "./revert.js";
@@ -9,14 +9,13 @@ import { removeVersionSectionFromReadme, hasVersionSection } from "../core/copy/
 import { removeAutoAddedEntriesFromGitignore, hasAutoAddedEntries } from "../core/copy/gitignore.js";
 import { CANCEL } from "../ui/prompts.js";
 
-// selection: { workflows, scripts, coderabbit, readme, gitignore, versionYml } (모두 boolean).
+// selection: { workflows, scripts, readme, gitignore, versionYml } (모두 boolean).
 // 반환: 위와 동일한 키의 boolean/배열 — 실제로 제거 "대상"인지 여부(순수 함수, 아무것도 지우지 않음).
 export function planUninstall(payloadRoot, targetRoot, selection) {
   const revertPlan = planRevert(payloadRoot, targetRoot);
   return {
     workflows: selection.workflows ? revertPlan.workflows : [],
     scripts: selection.scripts ? revertPlan.scripts : [],
-    coderabbit: selection.coderabbit ? revertPlan.coderabbit : false,
     readme: selection.readme ? hasVersionSection(targetRoot) : false,
     gitignore: selection.gitignore ? hasAutoAddedEntries(targetRoot) : false,
     versionYml: selection.versionYml ? existsSync(join(targetRoot, PATHS.versionFile)) : false,
@@ -29,11 +28,6 @@ export function runUninstall(context, payloadRoot, targetRoot, selection) {
   const wfDir = join(targetRoot, PATHS.workflowsDir);
   for (const name of plan.workflows) remove(join(wfDir, name));
   for (const name of plan.scripts) remove(join(targetRoot, PATHS.scriptsDir, name));
-  if (plan.coderabbit) {
-    const cr = join(targetRoot, ".coderabbit.yaml");
-    remove(cr);
-    if (existsSync(cr + ".bak")) renameSync(cr + ".bak", cr);
-  }
   // removeVersionSectionFromReadme/removeAutoAddedEntriesFromGitignore는 plan이 "제거 대상"으로
   // 판단했더라도 실제로는 안전하게 포기(skip-*)할 수 있다 — 반환 상태를 그대로 신뢰하지 않고
   // 실제 결과로 plan을 덮어써서 호출부(CLI/대화형 요약)가 거짓 성공을 보고하지 않게 한다.
@@ -48,22 +42,20 @@ export function runUninstall(context, payloadRoot, targetRoot, selection) {
 const ITEM_DEFS = [
   { key: "workflows", label: "워크플로우 (.github/workflows/PROJECT-*.yaml)" },
   { key: "scripts", label: "스크립트 (.github/scripts/*.py)" },
-  { key: "coderabbit", label: ".coderabbit.yaml" },
   { key: "readme", label: "README.md 버전 섹션 (AUTO-VERSION-SECTION)" },
   { key: "gitignore", label: ".gitignore 자동 추가 항목" },
   { key: "versionYml", label: "version.yml (버전/브랜치 설정 전체)" },
 ];
 
-// 기본 체크 상태 — 설치 시 옵션(nexus/secret-backup/coderabbit)이 opt-in인 것과 대칭으로,
-// 여기서는 "안전 삭제" 3종만 기본 체크하고 나머지(readme/gitignore/versionYml)는 opt-in.
-export const SAFE_ITEMS = ["workflows", "scripts", "coderabbit"];
+// 기본 체크 상태 — 설치 시 옵션(nexus/secret-backup)이 opt-in인 것과 대칭으로,
+// 여기서는 "안전 삭제" 2종만 기본 체크하고 나머지(readme/gitignore/versionYml)는 opt-in.
+export const SAFE_ITEMS = ["workflows", "scripts"];
 
 function detectAvailableItems(payloadRoot, targetRoot) {
   const revertPlan = planRevert(payloadRoot, targetRoot);
   const presence = {
     workflows: revertPlan.workflows.length > 0,
     scripts: revertPlan.scripts.length > 0,
-    coderabbit: revertPlan.coderabbit,
     readme: hasVersionSection(targetRoot),
     gitignore: hasAutoAddedEntries(targetRoot),
     versionYml: existsSync(join(targetRoot, PATHS.versionFile)),
@@ -74,7 +66,7 @@ function detectAvailableItems(payloadRoot, targetRoot) {
 function toSelection(checkedKeys) {
   const set = new Set(checkedKeys);
   return {
-    workflows: set.has("workflows"), scripts: set.has("scripts"), coderabbit: set.has("coderabbit"),
+    workflows: set.has("workflows"), scripts: set.has("scripts"),
     readme: set.has("readme"), gitignore: set.has("gitignore"), versionYml: set.has("versionYml"),
   };
 }
@@ -89,7 +81,6 @@ function summarizeResult(result) {
   const lines = [];
   if (result.workflows.length) lines.push(`워크플로우 ${result.workflows.length}개 제거`);
   if (result.scripts.length) lines.push(`스크립트 ${result.scripts.length}개 제거`);
-  if (result.coderabbit) lines.push(".coderabbit.yaml 제거");
   if (result.readme) lines.push("README.md 버전 섹션 제거");
   if (result.gitignore) lines.push(".gitignore 자동 추가 항목 제거");
   if (result.versionYml) lines.push("version.yml 제거");

package/src/commands/version.js

@@ -1,6 +1,7 @@
 // version 모드 (.sh execute_integration version case 등가).
-// 순서: version.yml → readme → scripts → gitignore.
-// (워크플로우 미복사 → deploy 블록 없음. util·issue·coderabbit·setup-guide는 스코프 제외.)
+// 순서: version.yml → readme → scripts.
+// (워크플로우를 복사하지 않으므로 충돌 백업 부산물이 생길 수 없다 — gitignore 갱신 대상 없음, issue #7.
+//  util·issue·setup-guide는 스코프 제외.)
 import { join } from "node:path";
 import { writeText } from "../core/fsutil.js";
 import { PATHS } from "../core/paths.js";
@@ -9,12 +10,11 @@ import { readVersionYmlTemplate } from "../core/assets.js";
 import { markerForType } from "../core/detect.js";
 import { addVersionSectionToReadme } from "../core/copy/readme.js";
 import { copyScripts } from "../core/copy/simple.js";
-import { ensureGitignore } from "../core/copy/gitignore.js";
 
 export function runVersion(context, payloadRoot, targetRoot = ".") {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown",
-    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false,
+    includeNexus = false, includeSecretBackup = false,
     includeSemverAuto } = context;
 
   const pathMarkers = new Map();
@@ -24,9 +24,8 @@ export function runVersion(context, payloadRoot, targetRoot = ".") {
     buildVersionYml({
       templateText: readVersionYmlTemplate(payloadRoot),
       version, types, paths, pathMarkers, branch, branches: context.branches, versionCode, now, today,
-      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeCodeRabbit: includeCodeRabbit === true, includeSemverAuto: includeSemverAuto !== false, optionsDate: today },
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeSemverAuto: includeSemverAuto !== false, optionsDate: today },
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(payloadRoot, targetRoot);
-  ensureGitignore(targetRoot);
 }

package/src/context.js

@@ -17,7 +17,6 @@ export function createContext(overrides = {}) {
     paths: new Map(),        // type -> path
     includeNexus: null,      // null=미설정, true/false=명시
     includeSecretBackup: null,
-    includeCodeRabbit: null, // CodeRabbit opt-in (기본 false — version.yml options.coderabbit에 기록)
     includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
     templateVersion: "",
     deployValues: new Map(), // "type.KEY" -> value

package/src/core/copy/gitignore.js

@@ -1,8 +1,17 @@
-// .gitignore 보장 (.sh ensure_gitignore + normalize/check 등가) — template_integrator.sh 3996~4111.
+// .gitignore 보장 — 마법사 자신이 만드는 충돌 백업 부산물(*.bak, *.template.yaml)만 대상으로 한다.
+// 마법사가 설치하는 것과 무관한 개인 개발환경 설정(IDE 등)은 마법사 책임 범위 밖 — issue #7.
+// 주의(의도된 트레이드오프): 이 변경 이전 버전으로 설치해 /.idea·/.claude/settings.local.json이 이미
+// 배너 블록에 남아있는 레포에서 removeAutoAddedEntriesFromGitignore()를 실행하면, 배너는 제거되지만
+// REQUIRED_ENTRIES가 더 이상 옛 항목과 일치하지 않아 그 두 줄은 지워지지 않고 배너 표시 없이 남는다.
+// 이슈 #7이 "이미 설치된 레포의 .gitignore는 소급 처리하지 않고 사용자 판단에 맡긴다"고 명시하므로
+// 별도 마이그레이션 로직을 추가하지 않는다 — 남은 항목은 무해하며 필요하면 사용자가 직접 지운다.
 import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync, rmSync } from "node:fs";
 
-const REQUIRED_ENTRIES = ["/.idea", "/.claude/settings.local.json"];
+// issue #7: 마법사가 설치하는 것과 무관한 개인 개발환경 항목(/.idea 등)은 마법사 책임 밖이므로 제거.
+// 대신 마법사 자신의 충돌 처리(workflows.js backup/template 결정)가
+// 실제로 만들어내는 부산물만 gitignore 대상으로 삼는다.
+const REQUIRED_ENTRIES = ["*.bak", "*.template.yaml"];
 
 // .sh normalize_gitignore_entry: 주석 제거·트림·앞 / 제거·앞 ./ 제거·뒤 / 제거. 빈값이면 원본.
 export function normalizeGitignoreEntry(entry) {
@@ -26,11 +35,9 @@ function entryExists(target, content) {
 }
 
 const NEW_FILE_CONTENT =
-  "# IDE Settings\n" +
-  "/.idea\n" +
-  "\n" +
-  "# Claude AI Settings\n" +
-  "/.claude/settings.local.json\n";
+  "# project-auto-wizard: 충돌 처리 시 생성되는 백업 파일 (안전하게 무시해도 됩니다)\n" +
+  "*.bak\n" +
+  "*.template.yaml\n";
 
 // 반환: {created, added:[...]}
 export function ensureGitignore(targetRoot = ".") {

package/src/core/copy/workflows.js

@@ -58,7 +58,7 @@ function classify(srcDir, workflowsDir, envOpts, srcText) {
 //            envValues?:Map<key,value>, envUseDefaults?:boolean }  ← env 계획(promptEnvPlan) 결과 주입점
 // hooks: { decisions?: Map<filename, 'skip'|'backup'|'template'> } — 기존 파일(changed) 충돌 결정.
 //        미지정 파일은 'skip'(현행 force 동작 100% 유지). 대화형 수집은 copyWorkflowsInteractive 참조.
-// 반환: {copied, skipped, templateAdded, optionalCopied}
+// 반환: {copied, skipped, templateAdded, optionalCopied, backupAdded}
 export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}) {
   const { types = [], paths = new Map(), includeNexus = false, includeSecretBackup = false, repoName = "", resolvers = {}, envValues = new Map(), envUseDefaults = true } = context;
   const decisions = hooks.decisions instanceof Map ? hooks.decisions : new Map();
@@ -66,7 +66,7 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
   const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
   if (!exists(projectTypesDir)) throw new Error("패키지 구조 오류 — payload/workflows 폴더를 찾지 못했습니다.");
 
-  const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0 };
+  const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0, backupAdded: 0 };
   const deployValues = new Map(); // Map<type, Map<key,value>> — deploy 블록용 ask 값
   counters.deployValues = deployValues;
   const srcText = makeSrcText(context.branches || null);
@@ -124,6 +124,7 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, srcTe
     renameSync(dst, dst + ".bak");
     writeText(dst, srcText(src));
     counters.copied++;
+    counters.backupAdded++;
     return;
   }
   if (decision === "template") {
@@ -213,7 +214,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
         counters.skipped++;
         continue;
       }
-      if (existsSync(dst)) renameSync(dst, dst + ".bak");
+      if (existsSync(dst)) { renameSync(dst, dst + ".bak"); counters.backupAdded++; }
       writeText(dst, body);
       counters.optionalCopied++;
       counters.copied++;

package/src/core/version-yml.js

@@ -4,10 +4,10 @@
 
 // metadata.template.options 상태머신 파싱 (.sh read_template_options L2361~2416 등가).
 // 반환: { nexus: bool|null, secretBackup: bool|null } — null=미기재.
-// 구 synology 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다.
+// 구 synology·coderabbit 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다(파싱 에러 없음).
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
-  const out = { nexus: null, secretBackup: null, coderabbit: null, semverAuto: null };
+  const out = { nexus: null, secretBackup: null, semverAuto: null };
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
   const strip = (s) => String(s).replace(/["']/g, "").trim();
   let inTemplate = false;
@@ -30,13 +30,6 @@ export function parseTemplateOptions(content) {
         if (v === "false") out.secretBackup = false;
         continue;
       }
-      m = line.match(/^\s+coderabbit:\s*(.+)/);
-      if (m) {
-        const v = strip(m[1]);
-        if (v === "true") out.coderabbit = true;
-        if (v === "false") out.coderabbit = false;
-        continue;
-      }
       m = line.match(/^\s+semver_auto:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -132,7 +125,7 @@ export function parseTemplateBranches(content) {
 //   now   = "YYYY-MM-DD HH:MM:SS" (UTC) — 결정성 위해 주입 / today = "YYYY-MM-DD"
 //   branches = { main, develop, mode } (resolveBranchConfig 결과. 없으면 branch 기반 기본값)
 //   pathMarkers = Map<type, markerFilename> (project_paths 주석용)
-//   templateOptions = { templateVersion, includeNexus, includeSecretBackup, includeCodeRabbit?, optionsDate }
+//   templateOptions = { templateVersion, includeNexus, includeSecretBackup, optionsDate }
 export function buildVersionYml({
   templateText, version, types = [], primaryType, paths = new Map(), pathMarkers = new Map(),
   branch = "main", branches = null, versionCode = 1, now, today,
@@ -144,7 +137,7 @@ export function buildVersionYml({
   const b = branches || { main: branch || "main", develop: "develop", mode: "pr-flow" };
   const {
     templateVersion = "unknown", includeNexus = false, includeSecretBackup = false,
-    includeCodeRabbit = false, includeSemverAuto = true, optionsDate = today,
+    includeSemverAuto = true, optionsDate = today,
   } = templateOptions || {};
 
   // project_paths 블록 (full-line 토큰 {{PROJECT_PATHS}} — 없으면 라인 제거)
@@ -178,7 +171,7 @@ export function buildVersionYml({
     TEMPLATE_VERSION: templateVersion,
     MAIN_BRANCH: b.main, DEVELOP_BRANCH: b.develop, BRANCH_MODE: b.mode,
     OPT_NEXUS: String(includeNexus), OPT_SECRET_BACKUP: String(includeSecretBackup),
-    OPT_CODERABBIT: String(includeCodeRabbit), OPT_SEMVER_AUTO: String(includeSemverAuto),
+    OPT_SEMVER_AUTO: String(includeSemverAuto),
   };
 
   const out = [];

package/src/index.js

@@ -103,7 +103,7 @@ export async function run(argv, {
       return 0;
     }
     const r = runRevert({}, payload, cwd);
-    console.error(`제거됨 — 워크플로우 ${r.workflows.length}개, 스크립트 ${r.scripts.length}개${r.coderabbit ? ", .coderabbit.yaml" : ""}`);
+    console.error(`제거됨 — 워크플로우 ${r.workflows.length}개, 스크립트 ${r.scripts.length}개`);
     console.error("version.yml·README·.gitignore는 보존됩니다 (사용자 데이터).");
     return 0;
   }
@@ -116,7 +116,7 @@ export async function run(argv, {
     }
     const keepFlags = {
       versionYml: opts.keepVersionYml, readme: opts.keepReadme, changelog: opts.keepChangelog,
-      workflows: opts.keepWorkflows, scripts: opts.keepScripts, coderabbit: opts.keepCoderabbit,
+      workflows: opts.keepWorkflows, scripts: opts.keepScripts,
     };
     // version.yml은 여기서 미리 읽어둔다 — (a) executePurge()가 version.yml 자체를 지울 수 있어
     // 실행 이후에는 읽을 수 없고, (b) 아래 dry-run 예고 문구도 trunk-based 여부(develop === main)를
@@ -185,7 +185,7 @@ export async function run(argv, {
   // uninstall 모드 — revert보다 넓게 README·gitignore·version.yml까지 선택적으로 제거.
   if (opts.mode === "uninstall") {
     const safeSelection = {
-      workflows: true, scripts: true, coderabbit: true,
+      workflows: true, scripts: true,
       readme: opts.purgeReadme, gitignore: opts.purgeGitignore, versionYml: opts.purgeVersion,
     };
     if (opts.dryRun) {
@@ -196,7 +196,7 @@ export async function run(argv, {
       const r = runUninstall({}, payload, cwd, safeSelection);
       const removed = [
         `워크플로우 ${r.workflows.length}개`, `스크립트 ${r.scripts.length}개`,
-        r.coderabbit && ".coderabbit.yaml", r.readme && "README 버전 섹션",
+        r.readme && "README 버전 섹션",
         r.gitignore && ".gitignore 자동 추가 항목", r.versionYml && "version.yml",
       ].filter(Boolean).join(", ");
       console.error(`제거됨 — ${removed}`);
@@ -271,7 +271,6 @@ export async function run(argv, {
     // 옵션 워크플로우: CLI 플래그 최우선 → version.yml 저장 옵션(.sh read_template_options 등가) → false
     includeNexus: opts.includeNexus ?? existing?.options?.nexus ?? false,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
-    includeCodeRabbit: opts.includeCodeRabbit ?? existing?.options?.coderabbit ?? false,
     // 기존 version.yml이 있는데 semver_auto 키가 아예 없었던 경우(신규 기능 추가 이전 설치·
     // workflows-only 재실행) 조용히 true로 켜지면 애매한 커밋 하나로 major가 승격될 위험이 있다 —
     // 기존 설치는 false로 안전하게 폴백, 완전 신규 설치만 true(기존 설계) 유지.
@@ -309,8 +308,8 @@ export async function run(argv, {
   // 완료 요약 (.sh print_summary — CLI 모드에서도 출력)
   printSummary({
     mode: opts.mode, types, version, branches,
-    includeCodeRabbit: context.includeCodeRabbit === true,
     counters: { workflows: result?.workflows?.copied ?? 0 },
+    gitignoreUpdated: result?.gitignoreUpdated === true,
   }, cwd);
   return 0;
 }

package/src/ui/summary.js

@@ -1,5 +1,5 @@
 // 완료 요약 출력 (.sh print_summary 등가). 전부 stderr.
-// ctx: { mode, types:[], version, counters:{ workflows }, branches?, includeCodeRabbit? }
+// ctx: { mode, types:[], version, counters:{ workflows }, branches? }
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { PATHS, WORKFLOW_PREFIX, WORKFLOW_COMMON_PREFIX } from "../core/paths.js";
@@ -8,7 +8,7 @@ import { listYamlFiles } from "../core/fsutil.js";
 const SEPARATOR = "────────────────────────────────────────";
 
 export function printSummary(ctx, targetRoot = ".") {
-  const { mode, types = [], version = "", counters = {}, branches = null, includeCodeRabbit = false } = ctx || {};
+  const { mode, types = [], version = "", counters = {}, branches = null, gitignoreUpdated = false } = ctx || {};
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
   const isTty = !!process.stderr.isTTY;
@@ -32,12 +32,11 @@ export function printSummary(ctx, targetRoot = ".") {
       err("  ✅ 버전 관리 시스템 (version.yml)");
       err("  ✅ README.md 자동 버전 업데이트");
       err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");
-      err("  ✅ .gitignore 필수 항목");
+      if (gitignoreUpdated) err("  ✅ .gitignore 백업 파일 제외 항목 (*.bak/*.template.yaml)");
       break;
     case "version":
       err("  ✅ 버전 관리 시스템 (version.yml)");
       err("  ✅ README.md 자동 버전 업데이트");
-      err("  ✅ .gitignore 필수 항목");
       break;
     case "workflows":
       err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");
@@ -57,8 +56,7 @@ export function printSummary(ctx, targetRoot = ".") {
   if (mode === "full" || mode === "workflows") {
     err("");
     err("릴리스 노트 요약 엔진:");
-    if (includeCodeRabbit) err("  🤖 1순위 CodeRabbit PR 요약 (opt-in) → AI_API_KEY → GitHub Models(무료) → 규칙 fallback");
-    else err("  🤖 AI_API_KEY(선택) → GitHub Models(기본·무료·API 키 불필요) → 규칙 fallback — 릴리스는 절대 막히지 않음");
+    err("  🤖 AI_API_KEY(선택) → GitHub Models(기본·무료·API 키 불필요) → 규칙 fallback — 릴리스는 절대 막히지 않음");
   }
 
   err("");

package/payload/coderabbit.yaml

@@ -1,19 +0,0 @@
-# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
-language: "ko-KR"
-early_access: false
-reviews:
-  profile: "chill"
-  request_changes_workflow: false
-  high_level_summary: true
-  poem: false
-  review_status: true
-  collapse_walkthrough: false
-  auto_review:
-    enabled: true
-    drafts: false
-    base_branches: ["main"]
-chat:
-  auto_reply: true
-issue_enrichment:
-  auto_enrich:
-    enabled: false

package/src/core/copy/coderabbit.js

@@ -1,26 +0,0 @@
-// .coderabbit.yaml 복사 (.sh copy_coderabbit_config 등가, force 경로).
-// 소스는 payload/coderabbit.yaml (npm 패키징 안전을 위해 무점 파일명으로 동봉 → 대상엔 .coderabbit.yaml).
-// Task 15에서 coderabbit opt-in true일 때만 호출하도록 재배선 예정.
-import { join } from "node:path";
-import { exists, copyFileSync } from "../fsutil.js";
-
-// 반환: 'skip-no-src' | 'copied-new' | 'overwritten-backup' | 'skip-non-tty'
-// opts: { force, tty }
-export function copyCoderabbit(payloadRoot, { force = false, tty = false } = {}, targetRoot = ".") {
-  const src = join(payloadRoot, "coderabbit.yaml");
-  if (!exists(src)) return "skip-no-src";
-  const dst = join(targetRoot, ".coderabbit.yaml");
-
-  if (exists(dst)) {
-    if (force) {
-      copyFileSync(dst, dst + ".bak"); // 백업 후 덮어쓰기
-      copyFileSync(src, dst);
-      return "overwritten-backup";
-    }
-    if (!tty) return "skip-non-tty"; // 비TTY & !force → 유지
-    // 대화형 메뉴는 SP2-C — 여기서는 force가 아니면 유지
-    return "skip-non-tty";
-  }
-  copyFileSync(src, dst); // 신규
-  return "copied-new";
-}