projectops 4.6.0 → 4.7.0

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.6.0",
+  "version": "4.7.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/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";
@@ -41,6 +41,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
   // finally에서 기록할 때 쓰는 값 — try 안에서 확정되기 전에 취소될 수 있으므로 바깥에 둔다 (#561).
   let traceFrom = "";
   let traceTo = "";
+  // 기록 파일을 남기는 모드인지 — 모드 선택 전에 취소될 수 있어 기본값은 false.
+  let recordArtifacts = false;
+  // 기록을 남기지 않고 끝낼 경우(version/issues 모드의 정상 완주)에만 true.
+  // 취소·예외는 모드와 무관하게 남긴다 — 끊겼을 때가 "어디까지 갔는지"가 가장 궁금한 순간이다.
+  let skipRecord = false;
   if (io === prompts) trace.mirrorStart();
   try {
     // 템플릿 먼저 획득 — 배너에 실제 템플릿 버전을 표시 (.sh는 원격 version.yml fetch L4270~4280 등가)
@@ -113,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 — 이번 실행에서 개발 브랜치 존재/생성이 확인됐는지
@@ -341,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"),
@@ -378,7 +386,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
 
     // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리 (full/workflows만)
     let migrationGuidePath = null;
-    const recordArtifacts = mode === "full" || mode === "workflows";
+    recordArtifacts = mode === "full" || mode === "workflows";
     // 경로는 먼저 계산하고 실제 쓰기는 완료 화면 뒤로 미룬다 — 요약까지 터미널 미러에 담기 위함 (#561)
     const files = recordArtifacts
       ? trace.paths({ fromVersion: existing?.templateVersion || "", toVersion: templateVersion, now })
@@ -406,16 +414,12 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     }, cwd);
     io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
 
-    // 완료 화면까지 캡처한 뒤 종료하고 기록한다 (#561)
+    // 완료 화면까지 출력한 뒤 finally에서 닫는다 (#561) — 여기서 닫으면 이 아래 화면이 안 담긴다.
     trace.event("run", "end", mode || "", {
       workflowsCopied: result?.workflows?.copied ?? 0,
       workflowsSkipped: result?.workflows?.skipped ?? 0,
     });
-    if (recordArtifacts) {
-      trace.finalize({ targetRoot: cwd, fromVersion: existing?.templateVersion || "", toVersion: templateVersion, now });
-    } else {
-      trace.mirrorStop();
-    }
+    skipRecord = !recordArtifacts;
     return 0;
   } catch (err) {
     trace.event("run", "error", "interactive", {
@@ -424,9 +428,10 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     });
     throw err;
   } finally {
-    // 어떤 경로로 빠져나가든 기록을 남긴다 (#561) — 중간 취소·예외 포함.
-    // finalize는 멱등이라 정상 경로에서 이미 호출됐으면 여기서는 아무 일도 하지 않는다.
-    trace.finalize({ targetRoot: cwd, fromVersion: traceFrom, toVersion: traceTo, now: clock?.now || "" });
+    // 어떤 경로로 빠져나가든 기록을 남긴다 (#561) — 중간 취소·예외·Ctrl+C 포함.
+    // 완료 화면 출력이 try 안에 있어야 그 화면까지 미러에 담긴 채로 여기서 닫힌다.
+    if (skipRecord) trace.mirrorStop();
+    else trace.finalize({ targetRoot: cwd, fromVersion: traceFrom, toVersion: traceTo, now: clock?.now || "" });
     disarmSignals();
     remove(tempDir);
   }
@@ -443,7 +448,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,36 @@ 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에 리뷰·요약 댓글을 어떻게 받으시겠어요?");
+      const ans = await io.select({
+        message: "PR 댓글 방식을 선택하세요",
+        options: [
+          { value: "summary", label: "AI 변경 요약 (추천 · 추가 설정 불필요)" },
+          { value: "coderabbit", label: "CodeRabbit 코드 리뷰 (외부 앱 설치 필요)" },
+          { value: "both", label: "둘 다" },
+          { 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 +363,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 +421,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/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: "안내만(비대화형)" });
@@ -294,6 +298,39 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
         // 알 수 없는 모드 → .sh와 동일하게 복사 0건, 에러 아님
         break;
     }
+    // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리
+    let migrationGuidePath = null;
+    // 기록 파일 경로는 먼저 계산하고(가이드가 참조), 실제 쓰기는 완료 화면 출력 뒤로 미룬다 —
+    // 그래야 터미널 미러에 완료 화면까지 담긴다 (#561).
+    const files = recordArtifacts
+      ? trace.paths({ fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now })
+      : null;
+    if (recordArtifacts) {
+      migrationGuidePath = appendGuideEntry(cwd, {
+        now, mode: opts.mode, types, repoName,
+        templateFrom: existing?.templateVersion || "", templateTo: context.templateVersion,
+        options: { deploy: deployTarget, publish: publishTargets, secretBackup: context.includeSecretBackup, coderabbit: context.codeReviewCoderabbit, changelogProvider: context.changelogProvider, intent, semverAuto: context.semverAuto , appRelease: context.appRelease },
+        branches: { defaultBranch: branch, deployBranch: context.deployBranch || "develop", ready: null, created: null },
+        breaking: breakingReport, migrations: migrationsResult, orphans: { cleaned: [], pending: orphanPending },
+        events: trace.events, counters: { skipped: result?.workflows?.skipped ?? 0 },
+        traceFile: files?.traceFile ?? "", logFile: files?.logFile ?? "",
+      }).guidePath;
+    }
+
+    // 완료 요약 (.sh print_summary — CLI 모드에서도 출력)
+    printSummary({
+      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 모드에서만 존재)
+      logDir: files ? MIGRATION_DIR : null,   // #561 기록 위치 안내
+      logFile: files?.logFile ?? null,
+      traceFile: files?.traceFile ?? null,
+    }, cwd);
+
+    trace.event("run", "end", opts.mode || "", {
+      workflowsCopied: result?.workflows?.copied ?? 0,
+      workflowsSkipped: result?.workflows?.skipped ?? 0,
+    });
   } catch (err) {
     // 실패 원인을 로그에 남긴다 (#561) — 서버 로그처럼 사후에 바로 짚을 수 있어야 한다.
     trace.event("run", "error", opts.mode || "", {
@@ -302,53 +339,16 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     });
     throw err;
   } finally {
-    // 예외로 빠져나가도 기록을 남긴다 (#561). finalize는 멱등 — 정상 경로에서 이미
-    // 호출됐으면 여기서는 아무 일도 하지 않는다.
+    // 어떤 경로로 빠져나가든 기록을 남긴다 (#561) — 조기 return·중간 취소·예외 포함.
+    // 완료 화면 출력이 try 안에 있어야 그 화면까지 미러에 담긴 채로 여기서 닫힌다.
     if (recordArtifacts) {
       trace.finalize({ targetRoot: cwd, fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now });
+    } else {
+      trace.mirrorStop();
     }
     disarmSignals();
     remove(tempDir);
   }
 
-  // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리
-  let migrationGuidePath = null;
-  // 기록 파일 경로는 먼저 계산하고(가이드가 참조), 실제 쓰기는 완료 화면 출력 뒤로 미룬다 —
-  // 그래야 터미널 미러에 완료 화면까지 담긴다 (#561).
-  const files = recordArtifacts
-    ? trace.paths({ fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now })
-    : null;
-  if (recordArtifacts) {
-    migrationGuidePath = appendGuideEntry(cwd, {
-      now, mode: opts.mode, types, repoName,
-      templateFrom: existing?.templateVersion || "", templateTo: context.templateVersion,
-      options: { deploy: deployTarget, publish: publishTargets, secretBackup: context.includeSecretBackup, coderabbit: context.codeReviewCoderabbit, changelogProvider: context.changelogProvider, intent, semverAuto: context.semverAuto , appRelease: context.appRelease },
-      branches: { defaultBranch: branch, deployBranch: context.deployBranch || "develop", ready: null, created: null },
-      breaking: breakingReport, migrations: migrationsResult, orphans: { cleaned: [], pending: orphanPending },
-      events: trace.events, counters: { skipped: result?.workflows?.skipped ?? 0 },
-      traceFile: files?.traceFile ?? "", logFile: files?.logFile ?? "",
-    }).guidePath;
-  }
-
-  // 완료 요약 (.sh print_summary — CLI 모드에서도 출력)
-  printSummary({
-    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 모드에서만 존재)
-    logDir: files ? MIGRATION_DIR : null,   // #561 기록 위치 안내
-    logFile: files?.logFile ?? null,
-    traceFile: files?.traceFile ?? null,
-  }, cwd);
-
-  // 완료 화면까지 캡처한 뒤 종료하고 기록한다 (#561)
-  trace.event("run", "end", opts.mode || "", {
-    workflowsCopied: result?.workflows?.copied ?? 0,
-    workflowsSkipped: result?.workflows?.skipped ?? 0,
-  });
-  if (recordArtifacts) {
-    trace.finalize({ targetRoot: cwd, fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now });
-  } else {
-    trace.mirrorStop();
-  }
   return 0;
 }

package/src/ui/summary.js

@@ -131,23 +131,6 @@ export function printSummary(ctx, targetRoot = ".") {
   err("  📚 워크플로우 가이드: .github/workflows/project-types/README.md");
   // #493 — 이번 실행의 마이그레이션 기록. "뭐가 남았고 AI에게 어떻게 시키는지"가 바로 보이게 행동 유도형으로 안내.
   // 실행 기록 위치 (#561) — 무슨 일이 있었는지 나중에 확인할 자리를 알린다.
-  // 폴더가 아니라 이번 실행의 파일을 정확히 짚어준다 — 실행이 쌓이면 어느 것이 이번 건인지
-  // 모른다. 붙여넣어 바로 열 수 있는 경로가 목적이다.
-  if (ctx?.logFile || ctx?.logDir) {
-    err(`  📁 실행 로그: ${ctx.logFile || `${ctx.logDir}/`}`);
-    if (ctx.traceFile) err(`     이벤트(JSONL): ${ctx.traceFile}`);
-    err("     이번 실행에서 무엇을 어떤 근거로 정했는지 전부 기록돼 있습니다.");
-    err("     문제가 생기면 이 파일을 확인하세요 (저장소에 추적되지 않습니다).");
-    err("     💡 AI Agent에게 \"실행 로그 확인해줘\"라고 요청하면 원인을 짚어줍니다.");
-    err("");
-  }
-  if (ctx?.migrationGuidePath) {
-    err(`  🧭 마이그레이션 가이드: ${ctx.migrationGuidePath}`);
-    err("     이번 설치에서 바뀐 내용과 직접 확인해야 할 작업이 이 파일에 정리되어 있습니다.");
-    err("     💡 AI Agent(Claude, Cursor 등)에게 \"마이그레이션 가이드 확인하고");
-    err("        남은 작업 처리해줘\"라고 요청하면 이 문서를 읽고 대신 진행합니다.");
-  }
-  err("");
 
   // 설치 후 검증 결과 (#549) — 문제가 있을 때만 펼치고, 정상이면 한 줄로 압축한다.
   const verification = ctx?.verification;
@@ -215,4 +198,17 @@ export function printSummary(ctx, targetRoot = ".") {
   err(`${CYAN}📖 자세한 설정 방법은 다음 파일을 참고하세요:${NC}`);
   err("   → PROJECTOPS-SETUP-GUIDE.md");
   err("");
+  // 기록 안내는 완료 화면의 맨 끝에 둔다 (#561) — Secret 목록이 길면 위쪽은 스크롤에 묻혀
+  // 사용자가 "로그 얘기가 없다"고 느낀다. 문제가 생겼을 때 가장 먼저 찾는 것이므로 마지막 자리다.
+  if (ctx?.logFile || ctx?.logDir || ctx?.migrationGuidePath) {
+    err(`${CYAN}📁 이번 실행 기록${NC}`);
+    if (ctx?.logFile || ctx?.logDir) {
+      err(`   로그:   ${ctx.logFile || `${ctx.logDir}/`}`);
+      if (ctx.traceFile) err(`   이벤트: ${ctx.traceFile}`);
+    }
+    if (ctx?.migrationGuidePath) err(`   가이드: ${ctx.migrationGuidePath}`);
+    err("   무엇을 어떤 근거로 정했는지 전부 남아 있습니다 (저장소에 추적되지 않음).");
+    err("   💡 문제가 생기면 AI Agent에게 \"실행 로그 확인해줘\"라고 요청하세요.");
+    err("");
+  }
 }