project-auto-wizard 0.1.8 → 0.1.10

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.7 (2026-07-29)
+## 최신 버전 : v0.1.10 (2026-08-02)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

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

package/src/cli/args.js

@@ -22,6 +22,16 @@ export function parseArgs(argv) {
     purgeReadme: false,       // --purge-readme: uninstall --force 시 README 버전 섹션도 제거
     purgeGitignore: false,    // --purge-gitignore: uninstall --force 시 .gitignore 자동 추가 항목도 제거
     purgeVersion: false,      // --purge-version: uninstall --force 시 version.yml도 제거
+    // purge 전용 플래그 (숨김 모드 — HELP_TEXT에는 노출하지 않는다).
+    yes: false,               // --yes: purge 실행 확인 (필수, --force로 대체 불가)
+    allowDirty: false,        // --allow-dirty: git 작업트리 dirty 상태에서도 강행
+    deleteDevelopBranch: false, // --delete-develop-branch: 로컬 develop 브랜치까지 삭제
+    keepVersionYml: false,
+    keepReadme: false,
+    keepChangelog: false,
+    keepWorkflows: false,
+    keepScripts: false,
+    keepCoderabbit: false,
   };
   const args = [...argv];
   while (args.length > 0) {
@@ -58,6 +68,15 @@ export function parseArgs(argv) {
       case "--purge-readme": result.purgeReadme = true; break;
       case "--purge-gitignore": result.purgeGitignore = true; break;
       case "--purge-version": result.purgeVersion = true; break;
+      case "--yes": result.yes = true; break;
+      case "--allow-dirty": result.allowDirty = true; break;
+      case "--delete-develop-branch": result.deleteDevelopBranch = true; break;
+      case "--keep-version-yml": result.keepVersionYml = true; break;
+      case "--keep-readme": result.keepReadme = true; break;
+      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;

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 → coderabbit → 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";
@@ -46,9 +47,13 @@ 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. coderabbit (opt-in true일 때만 — DESIGN-SPEC §4 질문②)
+  const coderabbitResult = includeCodeRabbit === true ? copyCoderabbit(payloadRoot, { force }, targetRoot) : null;
 
-  return { workflows: wfCounters };
+  // 6. gitignore — 워크플로우/coderabbit 충돌 처리가 .bak나 .template.yaml을 실제로 만든 경우에만 갱신한다.
+  //    충돌 없는 설치(대부분의 최초 설치)는 .gitignore를 전혀 건드리지 않는다 — issue #7.
+  const gitignoreUpdated = wfCounters.backupAdded > 0 || wfCounters.templateAdded > 0 || coderabbitResult === "overwritten-backup";
+  if (gitignoreUpdated) ensureGitignore(targetRoot);
+
+  return { workflows: wfCounters, gitignoreUpdated };
 }

package/src/commands/interactive.js

@@ -249,6 +249,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   io.summary?.({
     mode, types, version, branches, includeCodeRabbit,
     counters: { workflows: result?.workflows?.copied ?? 0 },
+    gitignoreUpdated: result?.gitignoreUpdated === true,
   }, cwd);
   io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
   return 0;

package/src/commands/purge.js

@@ -0,0 +1,86 @@
+// purge 모드 — revert가 지우는 전부(워크플로우·스크립트·coderabbit) + 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 { PATHS } from "../core/paths.js";
+import { remove } from "../core/fsutil.js";
+import { planRevert } from "./revert.js";
+import { removeVersionSectionFromReadme, hasVersionSection } from "../core/copy/readme.js";
+
+const CHANGELOG_FILES = ["CHANGELOG.json", "CHANGELOG.md"];
+
+// keepFlags: { versionYml, readme, changelog, workflows, scripts, coderabbit } — true인 카테고리는 후보에서 제외.
+// 반환: { workflows, scripts, coderabbit, 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))),
+  };
+}
+
+// 삭제 전 요약 출력 — dry-run 미리보기와 실제 실행 전 요약 양쪽에서 재사용한다.
+export function printPurgePlan(plan, { dryRun = false } = {}) {
+  const lines = ["",
+    dryRun
+      ? "project-auto-wizard --mode purge --dry-run — 미리보기, 실제 파일은 바뀌지 않았습니다"
+      : "project-auto-wizard --mode purge — 아래 항목을 제거합니다",
+    ""];
+  lines.push(`워크플로우 (${plan.workflows.length}개):`);
+  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}`);
+  lines.push("");
+  console.log(lines.join("\n"));
+}
+
+// 실제 삭제 수행 — planPurge()와 동일 shape을 반환하되 실제로 제거된 항목을 반영한다.
+// runRevert()를 통째로 호출하지 않는 이유: runRevert는 항상 전체를 지우므로
+// --keep-* 로 선택적 카테고리만 보존하는 요구사항과 맞지 않는다.
+// H3 (Fable 검토): readmeSection은 plan의 판정을 그대로 되돌려주지 않고
+// removeVersionSectionFromReadme()의 실제 반환값("removed"인지)을 반영한다 — 스펙 §6이
+// "반환값은 실제 삭제 결과를 반영"하라고 명시하기 때문에, plan과 실제 제거 조건이
+// 이론상 어긋나는 경우에도 printPurgeResult가 거짓으로 "제거됨"을 보고하지 않는다.
+export function executePurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
+  const plan = planPurge(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));
+  return { ...plan, readmeSection };
+}
+
+// 삭제 후 실제 제거된 목록 출력 — printPurgePlan과 완전히 동일한 형태(파일명 나열)로
+// 맞춘다 (M3, Fable 검토: 개수만 출력하면 스펙 §5-6의 "제거된 목록 재출력" 요구를 충족하지 못함).
+export function printPurgeResult(result) {
+  const lines = ["", "제거됨:", ""];
+  lines.push(`워크플로우 (${result.workflows.length}개):`);
+  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에 추가된 백업 파일 제외 항목(*.bak/*.template.yaml)은 purge 대상에서 제외되어 그대로 보존됩니다)");
+  lines.push("");
+  console.log(lines.join("\n"));
+}

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.
+// (워크플로우/coderabbit을 복사하지 않으므로 충돌 백업 부산물이 생길 수 없다 — gitignore 갱신 대상 없음, issue #7.
+//  util·issue·coderabbit·setup-guide는 스코프 제외.)
 import { join } from "node:path";
 import { writeText } from "../core/fsutil.js";
 import { PATHS } from "../core/paths.js";
@@ -9,7 +10,6 @@ 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,
@@ -28,5 +28,4 @@ export function runVersion(context, payloadRoot, targetRoot = ".") {
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(payloadRoot, targetRoot);
-  ensureGitignore(targetRoot);
 }

package/src/core/branches.js

@@ -5,7 +5,7 @@
 import { execFile } from "node:child_process";
 
 // 기본 exec — git 명령 실행. 반환 {code, stdout, stderr}. 테스트는 mock 주입.
-function defaultExec(cmd, args, { cwd } = {}) {
+export function defaultExec(cmd, args, { cwd } = {}) {
   return new Promise((resolve) => {
     execFile(cmd, args, { cwd, windowsHide: true }, (err, stdout, stderr) => {
       resolve({ code: err ? (err.code ?? 1) : 0, stdout: String(stdout), stderr: String(stderr) });

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 결정, coderabbit.js 덮어쓰기 백업)가
+// 실제로 만들어내는 부산물만 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/readme.js

@@ -2,7 +2,7 @@
 import { join } from "node:path";
 import { existsSync, readFileSync, appendFileSync, writeFileSync } from "node:fs";
 
-const MARKER = "<!-- AUTO-VERSION-SECTION";
+export const MARKER = "<!-- AUTO-VERSION-SECTION";
 // ## (최신 버전|최신버전|Version|버전) : vX.Y.Z (대소문자 무시)
 const VERSION_LINE_RE = /##\s*(최신\s*버전|최신버전|Version|버전)\s*:\s*v[0-9]+\.[0-9]+\.[0-9]+/i;
 

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/index.js

@@ -4,6 +4,7 @@
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { readFileSync, existsSync } from "node:fs";
+import { createInterface } from "node:readline/promises";
 import { parseArgs, parsePathsCsv, CliError } from "./cli/args.js";
 import { HELP_TEXT } from "./cli/help.js";
 import { createContext } from "./context.js";
@@ -12,7 +13,7 @@ import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeRe
 import { parseExisting } from "./core/version-yml.js";
 import { runBreakingCheck } from "./core/breaking-check.js";
 import { resolveProjectPaths } from "./core/paths-resolve.js";
-import { resolveBranchConfig, detectRemoteBranches, ensureDevelopBranch } from "./core/branches.js";
+import { resolveBranchConfig, detectRemoteBranches, ensureDevelopBranch, defaultExec } from "./core/branches.js";
 import { printBannerCompact } from "./ui/banner.js";
 import { printSummary } from "./ui/summary.js";
 import { runFull } from "./commands/full.js";
@@ -25,6 +26,7 @@ import { runInteractive } from "./commands/interactive.js";
 import { runStatus, printStatus } from "./commands/status.js";
 import { runDoctor, printDoctorReport } from "./commands/doctor.js";
 import { planDryRun, printDryRun } from "./commands/dry-run.js";
+import { planPurge, executePurge, printPurgePlan, printPurgeResult } from "./commands/purge.js";
 
 // 패키지 버전 읽기 (-v/--version 출력용). src/../package.json.
 function readPkgVersion() {
@@ -45,10 +47,24 @@ function utcNow(date = new Date()) {
   return { now: `${d} ${t}`, today: d };
 }
 
-// run(argv, opts) → exitCode. opts: { cwd, payloadRoot?, clock? }
+// purge TTY 확인 — 실제 stdin에서 한 줄 입력을 받는다 (테스트는 promptRepoName 주입으로 대체).
+async function defaultPromptRepoName(repoName) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    return await rl.question(`purge를 실행하려면 정확히 이 레포명을 입력하세요: ${repoName}\n> `);
+  } finally {
+    rl.close();
+  }
+}
+
+// run(argv, opts) → exitCode. opts: { cwd, payloadRoot?, clock?, exec?, promptRepoName? }
 //   payloadRoot: 테스트 픽스처 주입점 (기본: 패키지 동봉 payload/)
 //   clock: {now, today} 주입 (기본 현재 UTC).
-export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}) {
+//   exec/promptRepoName: purge 모드 안전장치 게이트용 주입점 (기본 실제 구현, 테스트는 mock 주입).
+export async function run(argv, {
+  cwd = process.cwd(), payloadRoot, clock,
+  exec = defaultExec, promptRepoName = defaultPromptRepoName,
+} = {}) {
   let opts;
   try {
     opts = parseArgs(argv);
@@ -91,6 +107,80 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
     console.error("version.yml·README·.gitignore는 보존됩니다 (사용자 데이터).");
     return 0;
   }
+  // purge 모드 — 마법사가 만든 모든 산출물을 지워 설치 이전 상태로 완전히 되돌린다.
+  // 개발·테스트 전용 숨김 모드 — --help/대화형 메뉴에 노출하지 않는다 (issue #6).
+  if (opts.mode === "purge") {
+    if (!existsSync(join(cwd, ".git"))) {
+      console.error("git 레포가 아닙니다(.git 없음) — purge는 git 레포 안에서만 실행할 수 있습니다.");
+      return 1;
+    }
+    const keepFlags = {
+      versionYml: opts.keepVersionYml, readme: opts.keepReadme, changelog: opts.keepChangelog,
+      workflows: opts.keepWorkflows, scripts: opts.keepScripts, coderabbit: opts.keepCoderabbit,
+    };
+    // version.yml은 여기서 미리 읽어둔다 — (a) executePurge()가 version.yml 자체를 지울 수 있어
+    // 실행 이후에는 읽을 수 없고, (b) 아래 dry-run 예고 문구도 trunk-based 여부(develop === main)를
+    // 알아야 실제 실행 시 삭제를 건너뛸지 미리 알릴 수 있기 때문에, 두 지점보다 앞서 읽어야 한다.
+    const vyPath = join(cwd, "version.yml");
+    const existing = existsSync(vyPath) ? parseExisting(readFileSync(vyPath, "utf8")) : null;
+    if (opts.dryRun) {
+      printPurgePlan(planPurge(payload, cwd, keepFlags), { dryRun: true });
+      // M4 (Fable 검토): develop 브랜치 삭제는 plan에 포함되지 않으므로(§6 — git 상태는 실행 시점에만
+      // 판단 가능) 별도로 예고하지 않으면 dry-run 미리보기가 유일한 파괴적 동작을 사용자에게 숨기게 된다.
+      if (opts.deleteDevelopBranch) {
+        const developBranch = existing?.branches?.develop || "develop";
+        if (existing?.branches?.main && developBranch === existing.branches.main) {
+          console.log("(--delete-develop-branch 지정됨: trunk-based 구성(develop === main)이라 실제 실행 시에도 삭제를 건너뜁니다)");
+        } else {
+          console.log("(--delete-develop-branch 지정됨: 실제 실행 시 로컬 develop 브랜치도 삭제를 시도합니다)");
+        }
+      }
+      return 0;
+    }
+    if (!opts.yes) {
+      console.error("--yes 없이는 purge를 실행할 수 없습니다 (--force로 대체할 수 없습니다).");
+      return 1;
+    }
+    const st = await exec("git", ["status", "--porcelain"], { cwd });
+    if (st.code !== 0) {
+      console.error("git 상태를 확인할 수 없습니다 — 안전을 위해 purge를 중단합니다.");
+      return 1;
+    }
+    if (!opts.allowDirty && st.stdout.trim() !== "") {
+      console.error("작업트리에 커밋되지 않은 변경 사항이 있습니다 — purge 후 복구할 수 없습니다. 커밋하거나 --allow-dirty를 사용하세요.");
+      return 1;
+    }
+    if (!opts.force) {
+      if (!process.stdout.isTTY) {
+        console.error("비대화형 환경에서는 --force 옵션이 필요합니다.");
+        return 1;
+      }
+      const repoName = detectRepoName(cwd);
+      const typed = await promptRepoName(repoName);
+      if (typed !== repoName) {
+        console.error("입력한 레포명이 일치하지 않습니다 — purge를 중단합니다.");
+        return 1;
+      }
+    }
+    const plan = planPurge(payload, cwd, keepFlags);
+    printPurgePlan(plan, { dryRun: false });
+    const result = executePurge(payload, cwd, keepFlags);
+    printPurgeResult(result);
+    if (opts.deleteDevelopBranch) {
+      const developBranch = existing?.branches?.develop || "develop";
+      if (existing?.branches?.main && developBranch === existing.branches.main) {
+        console.error("trunk-based 구성(develop === main)입니다 — 릴리스 브랜치 삭제는 건너뜁니다.");
+      } else {
+        const br = await exec("git", ["branch", "-d", developBranch], { cwd });
+        if (br.code !== 0) {
+          console.error(`⚠️  로컬 '${developBranch}' 브랜치 삭제 실패 (${(br.stderr || "").trim() || "이유 확인 불가"}) — 수동으로 확인하세요.`);
+        } else {
+          console.error(`로컬 '${developBranch}' 브랜치를 삭제했습니다.`);
+        }
+      }
+    }
+    return 0;
+  }
 
   // uninstall 모드 — revert보다 넓게 README·gitignore·version.yml까지 선택적으로 제거.
   if (opts.mode === "uninstall") {
@@ -221,6 +311,7 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
     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

@@ -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, includeCodeRabbit = false, 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 릴리스 자동화 포함)");