projectops 4.6.1 → 4.8.0

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.6.0 (2026-09-16)
+## 최신 버전 : v4.7.0 (2026-09-16)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.6.1",
+  "version": "4.8.0",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
   "keywords": [
     "devops",

package/src/cli/args.js

@@ -17,6 +17,7 @@ export function parseArgs(argv) {
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456): --deploy-branch, 빈 값=미지정
     intent: null,            // 프로젝트 성격 (#485): --intent app|library|both|none|manual, null=미설정(역추론)
     includeSecretBackup: null,
+    aiPrSummary: null,   // #566 — AI 변경 요약 워크플로우 포함 여부
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
     help: false,
@@ -101,6 +102,9 @@ export function parseArgs(argv) {
         break;
       case "--secret-backup": result.includeSecretBackup = true; break;
       case "--no-secret-backup": result.includeSecretBackup = false; break;
+      // #566 — 비대화형에서도 켜고 끌 수 있어야 한다. 없으면 자동화 환경은 선택권이 없다.
+      case "--ai-summary": result.aiPrSummary = true; break;
+      case "--no-ai-summary": result.aiPrSummary = false; break;
       case "--npm-publish":
         process.stderr.write("⚠️  --npm-publish는 deprecated입니다. --publish npm 을 사용하세요.\n");
         result.publishTargets = [...new Set([...(result.publishTargets ?? []), "npm"])];

package/src/cli/help.js

@@ -20,6 +20,7 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
       --publish CSV        publish 타겟 csv: nexus,npm,github-packages (기본: 없음)
       --deploy-branch NAME 릴리스 PR head 브랜치 (#456, 기본: develop). default_branch와 별개
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
+      --ai-summary / --no-ai-summary         PR 변경 요약 워크플로우 포함/제외
       --nexus / --npm-publish  (deprecated — --publish nexus / --publish npm 사용)
       --force              모든 확인 생략, 비대화형 기본값 사용
   -v, --version            projectops 버전 출력

package/src/commands/doctor.js

@@ -100,6 +100,27 @@ export function localChecks(cwd = ".") {
     ] : null,
   });
 
+  // AI 요약 키 (#569) — "등록했는데 되는 건가?"를 확인할 수단이 없었다.
+  // 로컬에서는 저장소 Secret을 읽을 수 없으므로, 어떤 이름을 쓰면 되는지와
+  // 등록하지 않아도 무방하다는 사실을 알려준다. 실제 등록 여부는 원격 점검이 본다.
+  const AI_KEY_NAMES = ["GEMINI_API_KEY", "OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GROQ_API_KEY", "MISTRAL_API_KEY"];
+  const hasSummaryWf = files.some((f) => /AI-PR-SUMMARY|RELEASE-CHANGELOG/.test(f));
+  if (hasSummaryWf) {
+    add({
+      name: "AI 요약 키", purpose: "릴리스 노트를 AI로 다듬을지 (선택)",
+      status: "INFO", value: "선택 사항",
+      detail: [
+        "등록하지 않아도 릴리스 노트는 나옵니다 — 커밋 내용을 분석해 만듭니다.",
+        "AI가 다듬은 문장을 원하면 아래 중 하나를 저장소 Secret에 등록하세요.",
+        "  GEMINI_API_KEY     무료 · https://aistudio.google.com/apikey",
+        "  GROQ_API_KEY       무료",
+        "  MISTRAL_API_KEY    무료",
+        "  OPENAI_API_KEY / ANTHROPIC_API_KEY   유료",
+        "등록한 것이 자동으로 쓰입니다. 별도 설정은 필요 없습니다.",
+      ],
+    });
+  }
+
   // 워크플로우 파일의 permissions 선언 점검 (#558).
   // 저장소 설정(Settings > Actions)은 "요청할 수 있는 최대 범위"이고, 워크플로우의
   // permissions 블록은 "실제로 요청한 범위"다. 둘은 다른 층이라 저장소 설정이 정상이어도
@@ -190,6 +211,20 @@ export async function remoteChecks(slug, token, requiredSecrets = []) {
             detail: ["토큰에 Secret 조회 권한이 없어 확인하지 못했습니다."] });
     } else {
       const have = new Set((sec.data?.secrets || []).map((s) => s.name));
+
+      // AI 요약 키가 실제로 등록돼 있는지 (#569) — 있으면 어느 서비스인지까지 보여준다.
+      const AI_KEYS = { GEMINI_API_KEY: "Gemini", OPENAI_API_KEY: "OpenAI", ANTHROPIC_API_KEY: "Anthropic",
+                        GROQ_API_KEY: "Groq", MISTRAL_API_KEY: "Mistral", MODEL_API_KEY: "구 이름(서비스 자동 추정)" };
+      const foundAi = Object.entries(AI_KEYS).filter(([n]) => have.has(n));
+      rows.push({
+        name: "AI 요약 키 등록", purpose: "릴리스 노트를 AI로 다듬을지 (선택)",
+        status: "INFO",
+        value: foundAi.length ? foundAi.map(([n, label]) => `${n} (${label})`).join(", ") : "없음 — 커밋 분석으로 동작",
+        detail: foundAi.length ? null : [
+          "등록하지 않아도 릴리스 노트는 정상적으로 나옵니다.",
+          "AI를 쓰려면 GEMINI_API_KEY(무료)를 등록하세요 — https://aistudio.google.com/apikey",
+        ],
+      });
       const missing = requiredSecrets.filter((n) => !have.has(n));
       add({
         name: "Secret 등록 여부", purpose: "배포에 필요한 값",

package/src/commands/full.js

@@ -23,8 +23,8 @@ import { verifyInstall } from "../core/verify.js";
 export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     force = true, now, today, templateVersion = "unknown",
-    deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
-    changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
+    deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, aiPrSummary = true,
+    changelogProvider = "commit", changelogBaseUrl = "", codeReviewCoderabbit = true,
     deployBranch = "", intent = null, semverAuto = true , appRelease = null } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
@@ -43,7 +43,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     buildVersionYml({
       version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
       deployValues,
-      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
+      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, aiPrSummary, optionsDate: today,
         changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent, mode: "full", semverAuto, appRelease },
     })), { version, versionCode });
 

package/src/commands/interactive.js

@@ -13,7 +13,7 @@ import { runBreakingCheck } from "../core/breaking-check.js";
 import { runMigrations } from "../core/migrations/index.js";
 import { detectOrphanWorkflows, applyOrphanCleanup } from "../core/orphan-workflows.js";
 import { resolveProjectPaths, filterExcludedTypes } from "../core/paths-resolve.js";
-import { askAllOptionalWorkflows, OPTION_AXES, applicableTargets } from "../core/options-ask.js";
+import { askAllOptionalWorkflows, OPTION_AXES, applicableTargets, migrateProvider } from "../core/options-ask.js";
 import { createRunTrace, MIGRATION_DIR } from "../core/run-trace.js";
 import { appendGuideEntry } from "../core/migration-guide.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
@@ -118,8 +118,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     let deployTarget = existing?.options?.deploy ?? "docker-ssh";
     let publishTargets = existing?.options?.publish ?? [];
     let includeSecretBackup = existing?.options?.secretBackup ?? false;
+    let aiPrSummary = existing?.options?.aiPrSummary ?? null;   // null = 아직 안 물음 (#566)
     let codeReviewCoderabbit = existing?.options?.codeReviewCoderabbit ?? true;
-    let changelogProvider = existing?.options?.changelogProvider ?? "github-ai";
+    let changelogProvider = migrateProvider(existing?.options?.changelogProvider) ?? "commit";
     let changelogBaseUrl = existing?.options?.changelogBaseUrl ?? "";
     let deployBranch = existing?.options?.deployBranch ?? "develop"; // #456
     let deployBranchReady = null; // #490 — 이번 실행에서 개발 브랜치 존재/생성이 확인됐는지
@@ -346,7 +347,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     // 고아 타입 워크플로우 정리 (#487) — 타입 변경으로 선택에서 빠진 타입의 잔존 워크플로우
     const orphanReport = { cleaned: [], pending: [] }; // #493 — 가이드 기록용
     if (mode === "full" || mode === "workflows") {
-      const orphans = detectOrphanWorkflows({ tempDir, targetRoot: cwd, selectedTypes: types });
+      const orphans = detectOrphanWorkflows({ tempDir, targetRoot: cwd, selectedTypes: types,
+        // 껐는데 남아 계속 도는 워크플로우도 함께 잡는다 (#566)
+        options: { includeSecretBackup, aiPrSummary: aiPrSummary !== false, deployTarget } });
       if (orphans.length > 0) {
         io.note?.(
           orphans.map((o) => `• ${o.filename} (${o.type} 타입 — 현재 미선택)`).join("\n"),
@@ -405,6 +408,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       mode, types, version, deployBranch, deployBranchReady, migrationGuidePath,
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
       verification: result?.verification,      // #549 설치 검증 결과
+      aiPrSummary, codeReviewCoderabbit,       // #569 — 고른 것만 안내
       logDir: files ? MIGRATION_DIR : null,    // #561 기록 위치 안내
       logFile: files?.logFile ?? null,
       traceFile: files?.traceFile ?? null,
@@ -445,7 +449,7 @@ function summarize({ mode, types, version, branch, deployTarget, publishTargets,
     lines.push(`배포 방식 : ${deployTarget || "docker-ssh"}`);
     lines.push(`Publish : ${(publishTargets ?? []).join(",") || "없음"}`);
     lines.push(`Secret 백업 : ${includeSecretBackup ? "포함" : "제외"}`);
-    lines.push(`Changelog : ${changelogProvider || "github-ai"}`);
+    lines.push(`Changelog : ${changelogProvider || "commit"}`);
     lines.push(`CodeRabbit 리뷰 : ${codeReviewCoderabbit ? "사용" : "미사용"}`);
   }
   return lines.join("\n");

package/src/commands/version.js

@@ -13,7 +13,7 @@ import { ensureGitignore } from "../core/copy/gitignore.js";
 export function runVersion(context, tempDir, targetRoot = ".") {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
-    changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
+    changelogProvider = "commit", changelogBaseUrl = "", codeReviewCoderabbit = true,
     deployBranch = "", recordMode = "version", semverAuto = true , appRelease = null } = context;
 
   const pathMarkers = new Map();

package/src/context.js

@@ -19,8 +19,9 @@ export function createContext(overrides = {}) {
     deployTarget: null,      // 'docker-ssh'(기본) | 'vercel' | 'none'
     publishTargets: null,    // ['nexus','npm','github-packages'] 부분집합
     includeSecretBackup: null,
+    aiPrSummary: null,   // #566 — AI 변경 요약 워크플로우 포함 여부
     // changelog provider 축 (#455 — null=미설정)
-    changelogProvider: null, // 'github-ai'(기본) | 'coderabbit' | 'openai' | 'gemini' | 'claude' | 'ollama' | 'commit'
+    changelogProvider: null, // 'commit'(기본) | 'coderabbit' | 'openai' | 'gemini' | 'claude' | 'ollama' | 'commit'
     changelogBaseUrl: null,  // ollama일 때만 값
     codeReviewCoderabbit: null,
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456). 빈 값=metadata.deploy_branch 미출력

package/src/core/copy/simple.js

@@ -20,8 +20,10 @@ export function copyScripts(tempDir, targetRoot = ".") {
     "dispatch_downstream.py",
     // AI PR SUMMARY 워크플로우가 요약 댓글을 작성·갱신할 때 호출 (#553).
     "pr_summary_comment.py",
+    // 릴리스 노트가 어떤 경로로 만들어졌는지 알리고, AI를 못 썼을 때 대안을 안내 (#566).
+    "changelog_notice.py",
     "changelog_providers/_common.py", "changelog_providers/ladder.py",
-    "changelog_providers/commit.py", "changelog_providers/github_ai.py",
+    "changelog_providers/commit.py", "changelog_providers/copilot.py",
     "changelog_providers/openai_compatible.py",
   ];
   let copied = 0;

package/src/core/copy/workflows.js

@@ -63,14 +63,14 @@ function classify(srcDir, workflowsDir, envOpts, baseline = null) {
 }
 
 // copy_workflows 본체 (동기 — 기존 호출부 무변경).
-// context: { types:[], paths:Map, deployTarget, publishTargets:[], includeSecretBackup, force, repoName, resolvers,
+// context: { types:[], paths:Map, deployTarget, publishTargets:[], includeSecretBackup, aiPrSummary, force, repoName, resolvers,
 //            envValues?:Map<key,value>, envUseDefaults?:boolean }  ← env 계획(promptEnvPlan) 결과 주입점
 //   deployTarget(#439 택1): 'docker-ssh'(기본) | 'vercel' | 'none' — server-deploy는 docker-ssh일 때만,
 //   common/deploy/<target>/은 해당 타겟일 때 복사. publishTargets(#439 다중): 'nexus'|'npm'|'github-packages'.
 // hooks: { decisions?: Map<filename, 'skip'|'backup'|'template'> } — 기존 파일(changed) 충돌 결정.
 // 반환: {copied, skipped, templateAdded, optionalCopied, copiedFiles[]} — copiedFiles는 실제 복사·교체된 파일명 (#473 요약용)
 export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
-  const { types = [], paths = new Map(), deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, repoName = "", resolvers = {}, envValues = new Map(), envUseDefaults = true, branch = "", deployBranch = "" } = context;
+  const { types = [], paths = new Map(), deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, aiPrSummary = true, repoName = "", resolvers = {}, envValues = new Map(), envUseDefaults = true, branch = "", deployBranch = "" } = context;
   const decisions = hooks.decisions instanceof Map ? hooks.decisions : new Map();
   const trace = hooks.trace ?? null; // #494 — 실행 트레이스 (null-safe: 미주입이면 전 이벤트 no-op)
   const workflowsDir = join(targetRoot, PATHS.workflowsDir);
@@ -164,6 +164,29 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
     }
   }
 
+  // (4.7) common/pr-summary — AI 변경 요약 (#566). 선택했을 때만 복사한다.
+  // 종전에는 common 본체에 있어 무조건 복사된 뒤 런타임에 스스로 빠졌고, 그 판단이
+  // ".coderabbit.yaml 존재"라 파일만 있고 앱이 없는 저장소에서는 아무도 요약하지 않았다.
+  const prSummaryDir = join(commonDir, "pr-summary");
+  if (exists(prSummaryDir) && aiPrSummary) {
+    for (const filename of listYamlFiles(prSummaryDir)) {
+      const src = join(prSummaryDir, filename);
+      const dst = join(workflowsDir, filename);
+      if (existsSync(dst) && isUnchanged(readFileSync(src, "utf8"), readFileSync(dst, "utf8"), envOptsFor("common"))) {
+        counters.skipped++;
+        trace?.event("copy", "skipped-unchanged", filename, { group: "pr-summary" });
+        continue;
+      }
+      const backedUp = existsSync(dst);
+      if (backedUp) renameSync(dst, dst + ".bak");
+      copyFileSync(src, dst);
+      counters.optionalCopied++;
+      counters.copied++;
+      counters.copiedFiles.push(filename);
+      trace?.event("copy", backedUp ? "replaced-bak" : "copied", filename, { group: "pr-summary" });
+    }
+  }
+
   // (5) common/secret-backup — 있으면 무조건 스킵/신규만 복사
   const secretDir = join(commonDir, "secret-backup");
   if (exists(secretDir) && includeSecretBackup) {

package/src/core/options-ask.js

@@ -92,8 +92,19 @@ export function applicableTargets(types = []) {
     publish: PUBLISH_TARGETS.filter((t) => types.some((ty) => (TYPE_PUBLISH_TARGETS[ty] ?? PUBLISH_TARGETS).includes(t))),
   };
 }
-// #455 — changelog 생성기 provider. github-ai가 기본(설정 제로). openai/gemini/claude/ollama는 openai 호환 한 갈래.
-export const CHANGELOG_PROVIDERS = ["github-ai", "coderabbit", "openai", "gemini", "claude", "ollama", "commit"];
+// changelog 생성기 provider (#455, #566에서 재정비).
+// 기본값은 commit — 외부 의존이 없어 어떤 환경에서도 결과가 나온다. AI를 쓰려면
+// MODEL_API_KEY를 등록하면 사다리가 자동으로 집어 쓴다(마법사는 묻지 않는다).
+// github-ai는 GitHub Models 종료(2026-07-30)로 제외됐다.
+export const CHANGELOG_PROVIDERS = ["copilot", "coderabbit", "openai", "gemini", "claude", "groq", "mistral", "ollama", "commit"];
+
+// 더 이상 동작하지 않는 저장값을 살아있는 값으로 옮긴다 (#566).
+// 기존 저장소가 업데이트만 돌려도 죽은 설정에서 벗어나게 하는 유일한 경로다.
+const RETIRED_PROVIDERS = { "github-ai": "commit" };
+export function migrateProvider(saved) {
+  if (saved == null) return null;
+  return RETIRED_PROVIDERS[saved] ?? saved;
+}
 
 const isCancel = (v) => typeof v === "symbol";
 
@@ -140,7 +151,7 @@ const INTENT_ASKS_PUBLISH = { library: true, both: true, manual: true, app: fals
 // current: { deploy: string|null, publish: string[]|null, secretBackup: bool|null } — CLI 명시값
 // scope: null이면 전 축(초기 통합·전체 재질문). Set/배열이면 그 축만 forceAsk 대상 (#483 수정 메뉴 격리).
 //        스코프 밖 축은 forceAsk여도 current/저장값을 그대로 유지하고 다시 묻지 않는다.
-// 반환: { deploy, publish, secretBackup, codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch }
+// 반환: { deploy, publish, secretBackup, codeReviewCoderabbit, aiPrSummary, changelogProvider, changelogBaseUrl, deployBranch }
 export async function askAllOptionalWorkflows({
   tempDir, types = [], current = {}, targetRoot = ".",
   force = false, tty = true, io = {}, forceAsk = false, defaultBranch = "", scope = null,
@@ -153,6 +164,7 @@ export async function askAllOptionalWorkflows({
   let publish = current.publish ?? null;
   let secretBackup = current.secretBackup ?? null;
   let codeReviewCoderabbit = current.codeReviewCoderabbit ?? null;
+  let aiPrSummary = current.aiPrSummary ?? null;
   let changelogProvider = current.changelogProvider ?? null;
   let changelogBaseUrl = current.changelogBaseUrl ?? null;
   let deployBranch = current.deployBranch ?? null; // #456 릴리스 PR head 브랜치
@@ -187,6 +199,7 @@ export async function askAllOptionalWorkflows({
       }
       // #455 changelog/code_review 저장값 재사용
       if (codeReviewCoderabbit === null && saved.codeReviewCoderabbit !== null) codeReviewCoderabbit = saved.codeReviewCoderabbit;
+      if (aiPrSummary === null && saved.aiPrSummary != null) aiPrSummary = saved.aiPrSummary;
       if (changelogProvider === null && saved.changelogProvider !== null) changelogProvider = saved.changelogProvider;
       if (changelogBaseUrl === null && saved.changelogBaseUrl !== null) changelogBaseUrl = saved.changelogBaseUrl;
       // #456 deploy_branch 저장값 재사용
@@ -313,19 +326,40 @@ export async function askAllOptionalWorkflows({
     }
   }
 
-  // ── code_review: CodeRabbit AI 코드 리뷰 (changelog와 무관 — #455) ──
-  if (ask("code-review") || codeReviewCoderabbit === null) {
-    if (force || !tty || typeof io.confirm !== "function") {
+  // ── pr_comment: PR에 달 리뷰·요약 (#566에서 통합) ──
+  // 종전에는 CodeRabbit 여부만 예/아니오로 물었고, AI 변경 요약은 물어보지도 않은 채
+  // 항상 복사된 뒤 런타임에 스스로 빠졌다. 그 결과 "CodeRabbit도 안 달고 요약도 안 다는"
+  // 저장소가 생겼다. 둘은 같은 자리(PR 댓글)를 놓고 경쟁하므로 한 번에 고르게 한다.
+  if (ask("code-review") || codeReviewCoderabbit === null || aiPrSummary === null) {
+    if (force || !tty || typeof io.select !== "function") {
+      // 비대화형 기본값: CodeRabbit은 별도 앱 설치가 있어야 실제로 동작하므로
+      // 자동화 환경에서 켜봐야 의미가 없다. 설정 없이 바로 도는 요약만 켠다.
       codeReviewCoderabbit = codeReviewCoderabbit ?? false;
+      aiPrSummary = aiPrSummary ?? true;
     } else {
       say("");
-      say("🤖 CodeRabbit AI 코드 리뷰를 쓸까요? (PR 올릴 때 코드 리뷰 댓글을 답니다)");
-      const ans = await io.confirm({ message: "CodeRabbit AI 코드 리뷰 사용", initialValue: false });
-      codeReviewCoderabbit = (ans === true && !isCancel(ans));
-      say(`CodeRabbit 코드 리뷰: ${codeReviewCoderabbit ? "사용" : "미사용"}`);
+      say("💬 PR에 어떤 댓글을 받으시겠어요?");
+      say("   두 가지는 하는 일이 다르고 한도도 따로라, 같이 켜도 서로 방해하지 않습니다.");
+      say("   · 변경 요약 — 무엇이 바뀌었는지 (추가 설정 없이 바로 동작)");
+      say("   · 코드 리뷰 — 버그·개선점 지적 (CodeRabbit 앱 설치 필요, 공개 저장소 무료)");
+      const ans = await io.select({
+        message: "PR 댓글 방식을 선택하세요",
+        options: [
+          { value: "both", label: "둘 다 (추천 · 무료로 쓸 수 있습니다)" },
+          { value: "summary", label: "변경 요약만 (추가 설정 불필요)" },
+          { value: "coderabbit", label: "코드 리뷰만 (CodeRabbit)" },
+          { value: "none", label: "사용 안 함" },
+        ],
+      });
+      // 취소·미응답은 추천값으로 — 다른 축과 같은 방어 패턴이다.
+      const PR_COMMENT_CHOICES = ["summary", "coderabbit", "both", "none"];
+      const pick = (!isCancel(ans) && PR_COMMENT_CHOICES.includes(ans)) ? ans : "summary";
+      codeReviewCoderabbit = pick === "coderabbit" || pick === "both";
+      aiPrSummary = pick === "summary" || pick === "both";
+      say(`PR 댓글: ${{ summary: "AI 변경 요약", coderabbit: "CodeRabbit", both: "둘 다", none: "사용 안 함" }[pick]}`);
       // #481 — "사용"만으로는 안 붙는다. 앱 설치 + 레포 접근 권한이 있어야 실제로 리뷰가 달린다.
       if (codeReviewCoderabbit) {
-        say("   ⚠️ 실제로 리뷰가 붙으려면 추가 설정이 필요합니다:");
+        say("   ⚠️ CodeRabbit은 추가 설정이 필요합니다:");
         say("      1) https://coderabbit.ai 접속 → GitHub으로 로그인");
         say("      2) CodeRabbit GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");
         say("      (이 단계를 안 하면 워크플로우는 켜져도 PR에 리뷰 댓글이 달리지 않습니다)");
@@ -333,29 +367,12 @@ export async function askAllOptionalWorkflows({
     }
   }
 
-  // ── changelog: 릴리스 노트 생성기 (기본 커서 = github-ai — #455) ──
-  if (ask("changelog") || changelogProvider === null) {
-    if (force || !tty || typeof io.select !== "function") {
-      changelogProvider = changelogProvider ?? "github-ai";
-    } else {
-      say("");
-      say("📝 릴리스 노트(changelog)는 1순위로 뭘로 만들까요?");
-      say("   GitHub AI는 설정 없이 바로 됩니다. 나머지는 나중에 GitHub Secret 등록이 필요할 수 있어요.");
-      // #481 — 하나만 골라야 하는 게 아니다. 고른 게 실패하면 자동 폴백하므로 안심하고 고르라고 안내.
-      say("   ✅ 고른 방식이 실패해도 자동으로 GitHub AI → 커밋 분석 순으로 폴백하니 릴리스 노트는 항상 생성됩니다.");
-      const ans = await io.select({
-        message: "1순위 changelog 생성기를 선택하세요 (실패 시 자동 폴백)",
-        options: [
-          { value: "github-ai", label: "GitHub AI (추천 · 설정 불필요)" },
-          { value: "coderabbit", label: "CodeRabbit" },
-          { value: "openai", label: "OpenAI 호환 API (키 등록 필요)" },
-          { value: "commit", label: "커밋 분석만 (AI 없음 · 최후 안전망)" },
-        ],
-      });
-      changelogProvider = (!isCancel(ans) && CHANGELOG_PROVIDERS.includes(ans)) ? ans : (changelogProvider ?? "github-ai");
-      say(`changelog 생성기: ${changelogProvider}`);
-    }
-  }
+  // ── changelog: 생성기를 묻지 않는다 (#566) ──
+  // 사용자의 목적은 "릴리스 노트가 잘 나오는 것"이지 provider 선택이 아니다. 무엇을 고를지
+  // 알 수 없는 질문이었고 기본값(github-ai)마저 죽어 있었다. 이제 워크플로우가 스스로
+  // 최선을 찾는다 — PR 본문 존중 → Copilot → 외부 AI(키 있으면) → 커밋 분석.
+  // 저장값은 그대로 두되 죽은 값만 살아있는 것으로 옮긴다.
+  changelogProvider = migrateProvider(changelogProvider) ?? "commit";
 
   // ollama 선택 시에만 base_url 질문 (나머지 provider는 preset base_url 자동 — #455)
   if (changelogProvider === "ollama" && (ask("changelog") || changelogBaseUrl === null || changelogBaseUrl === "")) {
@@ -408,7 +425,9 @@ export async function askAllOptionalWorkflows({
   return {
     deploy: finalDeploy, publish: finalPublish, secretBackup: secretBackup === true,
     codeReviewCoderabbit: codeReviewCoderabbit === true,
-    changelogProvider: changelogProvider ?? "github-ai",
+    // #566 — AI 변경 요약 워크플로우 포함 여부. 기본 true(추가 설정 없이 바로 동작).
+    aiPrSummary: aiPrSummary !== false,
+    changelogProvider: changelogProvider ?? "commit",
     changelogBaseUrl: changelogBaseUrl ?? "",
     deployBranch: deployBranch ?? "develop",
     deployBranchReady, // #490 — true=존재/생성 확인됨, false=거절/실패, null=확인 안 함

package/src/core/orphan-workflows.js

@@ -25,8 +25,38 @@ function typeInventory(projectTypesDir, type) {
   return files;
 }
 
-// 선택 안 된 타입의 템플릿 워크플로우가 대상 레포에 실재하면 고아로 반환.
-export function detectOrphanWorkflows({ tempDir, targetRoot = ".", selectedTypes = [] }) {
+// common/ 아래 "선택했을 때만 복사되는" 폴더들 (#566).
+// 켜면 복사 엔진이 넣어주지만, 끄면 이미 있던 파일이 그대로 남아 계속 실행됐다.
+// 축을 끈 사용자에게는 그게 곧 "껐는데 왜 도나"가 된다 — 여기서 고아로 잡는다.
+// deploy는 타겟별 폴더라 선택된 타겟만 살리고 나머지를 대상으로 삼는다.
+function commonOptionalOrphans(commonDir, opts) {
+  const { includeSecretBackup = false, aiPrSummary = true, deployTarget = "docker-ssh" } = opts;
+  const out = [];
+
+  const gated = [
+    ["secret-backup", includeSecretBackup, "secret-backup"],
+    ["pr-summary", aiPrSummary, "pr-summary"],
+  ];
+  for (const [dir, enabled, label] of gated) {
+    if (enabled) continue;
+    const d = join(commonDir, dir);
+    if (!exists(d)) continue;
+    for (const f of listYamlFiles(d)) out.push({ filename: f, type: label });
+  }
+
+  // deploy/<target> — 선택된 타겟 외 폴더는 전부 고아 후보
+  const deployRoot = join(commonDir, "deploy");
+  if (exists(deployRoot)) {
+    for (const e of readdirSync(deployRoot, { withFileTypes: true })) {
+      if (!e.isDirectory() || e.name === deployTarget) continue;
+      for (const f of listYamlFiles(join(deployRoot, e.name))) out.push({ filename: f, type: `deploy/${e.name}` });
+    }
+  }
+  return out;
+}
+
+// 선택 안 된 타입·옵션의 템플릿 워크플로우가 대상 레포에 실재하면 고아로 반환.
+export function detectOrphanWorkflows({ tempDir, targetRoot = ".", selectedTypes = [], options = null }) {
   const projectTypesDir = join(tempDir, PATHS.workflowsDir, PATHS.projectTypesDir);
   if (!exists(projectTypesDir)) return [];
   const selected = new Set(selectedTypes);
@@ -42,6 +72,14 @@ export function detectOrphanWorkflows({ tempDir, targetRoot = ".", selectedTypes
       if (existsSync(join(workflowsDir, f))) orphans.push({ filename: f, type: e.name });
     }
   }
+  // common의 조건부 폴더 — options를 준 호출부에서만 검사한다(구 호출부 동작 보존).
+  if (options) {
+    const commonDir = join(projectTypesDir, "common");
+    for (const o of commonOptionalOrphans(commonDir, options)) {
+      if (keep.has(o.filename)) continue;
+      if (existsSync(join(workflowsDir, o.filename))) orphans.push(o);
+    }
+  }
   return orphans.sort((a, b) => a.filename.localeCompare(b.filename));
 }
 

package/src/core/verify.js

@@ -68,7 +68,7 @@ const AUTO_SECRETS = new Set(["GITHUB_TOKEN"]);
 
 // 없어도 워크플로우가 도는 secret — 폴백이 문서화돼 있다. 필수와 섞어 "등록해야 동작합니다"라고
 // 하면 안내 자체를 못 믿게 되므로 분리한다.
-//   MODEL_API_KEY      → 없으면 GitHub Models(무료) → commit 규칙 fallback (#455 provider 사다리)
+//   MODEL_API_KEY      → 등록하면 외부 AI 요약, 없으면 Copilot → 커밋 분석 (#455·#566 사다리)
 //   _GITHUB_PAT_TOKEN  → 없으면 GITHUB_TOKEN으로 머지하고 후속 워크플로우를 직접 깨운다 (#551)
 export const OPTIONAL_SECRETS = new Set(["MODEL_API_KEY", "_GITHUB_PAT_TOKEN"]);
 

package/src/core/version-yml.js

@@ -56,7 +56,7 @@ const HEADER = `# ==============================================================
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
   const out = { deploy: null, publish: null, secretBackup: null,
-                changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null,
+                changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null, aiPrSummary: null,
                 deployBranch: null, intent: null, semverAuto: null, appRelease: null };
   // deploy_branch는 metadata 직속(#456) — template.options 밖이라 별도로 스캔한다.
   for (const line of String(content || "").split("\n")) {
@@ -83,6 +83,10 @@ export function parseTemplateOptions(content) {
       if (inCodeReview) {
         const cm = line.match(/^\s+coderabbit:\s*(.+)/);
         if (cm) { const v = strip(cm[1]); if (v === "true") out.codeReviewCoderabbit = true; if (v === "false") out.codeReviewCoderabbit = false; continue; }
+        // #566 — AI 변경 요약 워크플로우 포함 여부. 키가 없으면 null(미설정)로 두어
+        // 기존 저장소가 업데이트할 때 마법사가 한 번 물어볼 수 있게 한다.
+        const am = line.match(/^\s+ai_summary:\s*(.+)/);
+        if (am) { const v = strip(am[1]); if (v === "true") out.aiPrSummary = true; if (v === "false") out.aiPrSummary = false; continue; }
       }
       if (inChangelog) {
         const pm = line.match(/^\s+provider:\s*(.+)/);
@@ -313,7 +317,7 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   // template 옵션 블록 (.sh save_template_options 신규 추가 케이스). templateOptions 지정 시.
   if (templateOptions) {
     const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
-            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true, intent = null, mode = null,
+            changelogProvider = "commit", changelogBaseUrl = "", codeReviewCoderabbit = true, aiPrSummary = true, intent = null, mode = null,
             semverAuto = true, appRelease = null } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
     // intent(프로젝트 성격, #485) — 미지정이면 deploy/publish에서 역추론해 기록 (재통합 시 진입 질문 생략용)
@@ -338,6 +342,7 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
     }
     out += `      code_review:\n`;
     out += `        coderabbit: ${codeReviewCoderabbit}\n`;
+    out += `        ai_summary: ${aiPrSummary}\n`;
     out += `      changelog:\n`;
     out += `        provider: "${changelogProvider}"\n`;
     out += `        base_url: "${changelogBaseUrl}"\n`;

package/src/index.js

@@ -17,7 +17,7 @@ import { detectOrphanWorkflows } from "./core/orphan-workflows.js";
 import { createRunTrace, MIGRATION_DIR } from "./core/run-trace.js";
 import { appendGuideEntry } from "./core/migration-guide.js";
 import { resolveProjectPaths, markerForType } from "./core/paths-resolve.js";
-import { applicableTargets } from "./core/options-ask.js";
+import { applicableTargets, migrateProvider } from "./core/options-ask.js";
 import { printBannerCompact } from "./ui/banner.js";
 import { printSummary } from "./ui/summary.js";
 import { runFull } from "./commands/full.js";
@@ -197,13 +197,15 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     deployTarget,
     publishTargets,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
+    // #566 — CLI 값 우선, 없으면 저장값 보존, 그것도 없으면 true(설정 없이 바로 동작).
+    aiPrSummary: opts.aiPrSummary ?? existing?.options?.aiPrSummary ?? true,
     // #502 — version 모드가 기존 full 통합 기록(mode)을 강등하지 않도록 (full이 우세)
     recordMode: existing?.templateMode === "full" ? "full" : "version",
     // 릴리스 배포 브랜치(#456): CLI 플래그 → version.yml 저장값 → 빈 값(미출력, 스킬이 develop 폴백)
     deployBranch: opts.deployBranch || existing?.options?.deployBranch || "",
     intent,
     // changelog/code_review 축(#455): 비대화형은 저장값 → 기본값. null이 흘러 provider:"null"로 기록되던 버그 수정.
-    changelogProvider: existing?.options?.changelogProvider ?? "github-ai",
+    changelogProvider: migrateProvider(existing?.options?.changelogProvider) ?? "commit",
     changelogBaseUrl: existing?.options?.changelogBaseUrl ?? "",
     codeReviewCoderabbit: existing?.options?.codeReviewCoderabbit ?? false,
     // semver 자동 승격(#546): 저장값 → (기존 통합 레포면 false / 신규면 true).
@@ -276,7 +278,9 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     // 고아 타입 워크플로우 안내 (#487) — 비대화형은 자동 무해화 금지(배포 파이프라인일 수 있음), 안내만
     if (recordArtifacts) {
       const orphans = trace.step("orphan-scan",
-        () => detectOrphanWorkflows({ tempDir, targetRoot: cwd, selectedTypes: types }),
+        () => detectOrphanWorkflows({ tempDir, targetRoot: cwd, selectedTypes: types,
+          // 껐는데 남아 계속 도는 워크플로우도 함께 잡는다 (#566)
+          options: { includeSecretBackup: context.includeSecretBackup, aiPrSummary: context.aiPrSummary, deployTarget } }),
         { selectedTypes: types });
       orphanPending = orphans.map((o) => o.filename);
       for (const o of orphans) trace.event("orphan", "detected", o.filename, { type: o.type, action: "안내만(비대화형)" });
@@ -318,6 +322,8 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
       mode: opts.mode, types, version, deployBranch: context.deployBranch, migrationGuidePath,
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
       verification: result?.verification,   // #549 설치 후 검증 결과 (full/workflows 모드에서만 존재)
+      // #569 — 고른 것만 안내하려면 선택값이 필요하다
+      aiPrSummary: context.aiPrSummary, codeReviewCoderabbit: context.codeReviewCoderabbit,
       logDir: files ? MIGRATION_DIR : null,   // #561 기록 위치 안내
       logFile: files?.logFile ?? null,
       traceFile: files?.traceFile ?? null,

package/src/ui/summary.js

@@ -13,6 +13,7 @@ export function printSummary(ctx, targetRoot = ".") {
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
   const isTty = !!process.stderr.isTTY;
+  const BOLD = isTty ? "\u001b[1m" : "";
   const YELLOW = isTty ? "\x1b[1;33m" : "";
   const CYAN = isTty ? "\x1b[0;36m" : "";
   const NC = isTty ? "\x1b[0m" : "";
@@ -190,9 +191,32 @@ export function printSummary(ctx, targetRoot = ".") {
     err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
   }
   err("");
-  err("  3️⃣  CodeRabbit 활성화 (코드 리뷰를 켰다면)");
-  err("     → https://coderabbit.ai 로그인 → GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");
-  err("");
+  // #569 — 선택한 것만 안내한다. 끈 기능의 설정법을 보여주면 무엇을 해야 하는지 흐려진다.
+  let step = 3;
+  if (ctx?.aiPrSummary !== false) {
+    err(`  ${step}️⃣  (선택) AI가 다듬은 릴리스 노트 받기`);
+    err("     → 지금 상태로도 릴리스 노트는 나옵니다. 커밋 내용을 분석해 만들기 때문에");
+    err("        아무 설정을 하지 않아도 됩니다. 아래는 문장을 더 매끄럽게 하고 싶을 때만 하세요.");
+    err("");
+    err("     ① Google AI Studio에서 키 발급 (무료 · 신용카드 불필요 · 2분)");
+    err("        https://aistudio.google.com/apikey");
+    err("     ② 이 저장소에 등록");
+    err("        Settings > Secrets and variables > Actions > New repository secret");
+    err(`        ${BOLD}Name: GEMINI_API_KEY${NC}   Secret: 발급받은 키(AIza... 로 시작)`);
+    err("");
+    err("     💡 다른 서비스를 쓴다면 이름만 바꿔 등록하면 됩니다 — 등록한 것이 자동으로 쓰입니다.");
+    err("        OPENAI_API_KEY · ANTHROPIC_API_KEY · GROQ_API_KEY · MISTRAL_API_KEY");
+    err("");
+    step++;
+  }
+  if (ctx?.codeReviewCoderabbit === true) {
+    err(`  ${step}️⃣  CodeRabbit 활성화`);
+    err("     → https://coderabbit.ai 로그인 → GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");
+    err("     → 이 단계를 안 하면 워크플로우는 켜져도 PR에 리뷰 댓글이 달리지 않습니다");
+    err("     → 공개 저장소는 무료입니다 (시간당 3회 리뷰 제한)");
+    err("");
+    step++;
+  }
   err(SEPARATOR);
   err("");
   err(`${CYAN}📖 자세한 설정 방법은 다음 파일을 참고하세요:${NC}`);