project-auto-wizard 0.1.7 → 0.1.8

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.6 (2026-07-27)
+## 최신 버전 : v0.1.7 (2026-07-29)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -73,6 +73,20 @@ flutter.APP_ARTIFACT_NAME:
 
 `npx project-auto-wizard --mode revert`는 payload가 설치한 파일명과 **정확히 일치하는 것만** 제거합니다. 사용자가 직접 만든 워크플로우, `version.yml`, `README.md`, `.gitignore`는 건드리지 않습니다. 설치 시 충돌 처리로 생성된 `.bak`/`.template.yaml` 파생 파일도 함께 정리됩니다.
 
+### 완전 삭제(`--mode uninstall`)
+
+`npx project-auto-wizard --mode uninstall`은 `revert`보다 넓게 제거합니다 — 워크플로우·스크립트·`.coderabbit.yaml`은 물론, README.md의 `AUTO-VERSION-SECTION` 버전 섹션과 `.gitignore`에 자동 추가된 항목, `version.yml`까지 선택적으로 제거할 수 있습니다.
+
+- **대화형(TTY)**: 실제로 설치된 항목만 체크리스트로 보여줍니다. 워크플로우/스크립트/`.coderabbit.yaml`은 기본 체크, README·`.gitignore`·`version.yml`은 opt-in입니다. 선택 후 최종 확인(기본 "아니오")을 거쳐야 실제로 삭제됩니다.
+- **비대화형(`--force`)**: 워크플로우·스크립트·`.coderabbit.yaml`만 기본 삭제합니다. README·`.gitignore`·`version.yml`까지 지우려면 `--purge-readme`/`--purge-gitignore`/`--purge-version`을 함께 지정하세요.
+- `--dry-run`과 함께 쓰면 무엇이 지워질지 미리 볼 수 있습니다.
+
+```bash
+npx project-auto-wizard --mode uninstall                 # 대화형 체크리스트
+npx project-auto-wizard --mode uninstall --force         # 워크플로우·스크립트·coderabbit만 안전 삭제
+npx project-auto-wizard --mode uninstall --force --purge-readme --purge-gitignore --purge-version  # 완전 삭제
+```
+
 ## API 키 0개 AI — 요약 엔진 체인
 
 릴리스 노트는 4단 엔진 체인으로 생성됩니다. **어떤 단계가 실패해도 릴리스는 절대 막히지 않습니다.**
@@ -111,7 +125,7 @@ flowchart LR
 ```
 npx project-auto-wizard [옵션]
 
-  -m, --mode MODE          full | version | workflows | revert | status | doctor  (기본: 대화형)
+  -m, --mode MODE          full | version | workflows | revert | uninstall | status | doctor  (기본: 대화형)
   -t, --type CSV           spring,react,... (미지정 시 자동 감지)
       --project-version V  초기 버전 (미지정 시 자동 감지)
       --paths "t=p,..."    모노레포 타입별 경로
@@ -122,6 +136,9 @@ npx project-auto-wizard [옵션]
       --coderabbit         CodeRabbit PR 요약을 릴리스 노트 1순위로
       --semver-auto        커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함, --no-semver-auto로 끔)
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌
+      --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
+      --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거
+      --purge-version       --mode uninstall --force 시 version.yml도 제거
       --force              전 질문 생략 (CI용)
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "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

@@ -19,6 +19,9 @@ export function parseArgs(argv) {
     help: false,
     showVersion: false,      // -v/--version → 패키지 버전 출력 (npm 관례)
     dryRun: false,        // --dry-run: 실제 변경 없이 미리보기만 (full/version/workflows/revert 공통)
+    purgeReadme: false,       // --purge-readme: uninstall --force 시 README 버전 섹션도 제거
+    purgeGitignore: false,    // --purge-gitignore: uninstall --force 시 .gitignore 자동 추가 항목도 제거
+    purgeVersion: false,      // --purge-version: uninstall --force 시 version.yml도 제거
   };
   const args = [...argv];
   while (args.length > 0) {
@@ -52,6 +55,9 @@ export function parseArgs(argv) {
       }
       case "--force": result.force = true; break;
       case "--dry-run": result.dryRun = true; break;
+      case "--purge-readme": result.purgeReadme = true; break;
+      case "--purge-gitignore": result.purgeGitignore = true; break;
+      case "--purge-version": result.purgeVersion = true; break;
       case "--nexus": result.includeNexus = true; break;
       case "--no-nexus": result.includeNexus = false; break;
       case "--secret-backup": result.includeSecretBackup = true; break;

package/src/cli/help.js

@@ -5,8 +5,9 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
   npx project-auto-wizard [옵션]
 
 옵션:
-  -m, --mode MODE          통합 모드 (full | version | workflows | revert | status | doctor)
+  -m, --mode MODE          통합 모드 (full | version | workflows | revert | uninstall | status | doctor)
                            기본: interactive (대화형). revert = 설치물 제거(되돌리기)
+                           uninstall = 완전 삭제(대화형 체크리스트, --force 시 --purge-*로 opt-in)
                            status = 설치 상태·드리프트 확인(읽기 전용). doctor = 환경 진단(읽기 전용)
   -t, --type CSV           프로젝트 타입 csv (예: spring,react,python)
                            지원: spring flutter next react react-native
@@ -20,7 +21,10 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
       --coderabbit / --no-coderabbit  CodeRabbit PR 요약을 릴리스 노트 1순위로 사용 (기본: 사용 안 함)
       --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
       --force              모든 확인 생략, 비대화형 기본값 사용
-      --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/version/workflows/revert 전체 지원)
+      --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/version/workflows/revert/uninstall 전체 지원)
+      --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
+      --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거
+      --purge-version       --mode uninstall --force 시 version.yml도 제거
   -v, --version            project-auto-wizard 버전 출력
   -h, --help               이 도움말 표시
 
@@ -30,4 +34,5 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
   npx project-auto-wizard --mode status
   npx project-auto-wizard --mode doctor
   npx project-auto-wizard --mode full --force --type node --dry-run
+  npx project-auto-wizard --mode uninstall --force --purge-readme --purge-gitignore --purge-version
 `;

package/src/commands/dry-run.js

@@ -1,10 +1,11 @@
 // --dry-run 미리보기 — 실제 파일을 쓰지 않고 무엇이 바뀔지 계산한다.
-// full/version/workflows/revert 4개 모드 전체 지원.
+// full/version/workflows/revert/uninstall 5개 모드 전체 지원.
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { PATHS } from "../core/paths.js";
 import { planWorkflows } from "../core/copy/workflows.js";
 import { planRevert } from "./revert.js";
+import { planUninstall } from "./uninstall.js";
 import { buildVersionYml } from "../core/version-yml.js";
 import { readVersionYmlTemplate } from "../core/assets.js";
 import { markerForType } from "../core/detect.js";
@@ -31,9 +32,12 @@ function versionYmlPreview(context, payloadRoot, targetRoot) {
   return { existed: existing !== null, changed: existing !== wouldBe };
 }
 
-// mode: "full" | "version" | "workflows" | "revert". 읽기 전용 — 아무 파일도 쓰지 않는다.
+// mode: "full" | "version" | "workflows" | "revert" | "uninstall". 읽기 전용 — 아무 파일도 쓰지 않는다.
 export function planDryRun(mode, context, payloadRoot, targetRoot = ".") {
   if (mode === "revert") return { mode, revert: planRevert(payloadRoot, targetRoot) };
+  if (mode === "uninstall") {
+    return { mode, uninstall: planUninstall(payloadRoot, targetRoot, context.uninstallSelection) };
+  }
 
   const result = { mode };
   if (mode === "full" || mode === "workflows") {
@@ -54,6 +58,16 @@ export function printDryRun(plan) {
     lines.push(`제거될 스크립트 (${r.scripts.length}개):`);
     for (const f of r.scripts) lines.push(`  - ${f}`);
     if (r.coderabbit) lines.push("제거될 파일: .coderabbit.yaml");
+  } else if (plan.mode === "uninstall") {
+    const u = plan.uninstall;
+    lines.push(`제거될 워크플로우 (${u.workflows.length}개):`);
+    for (const f of u.workflows) lines.push(`  - ${f}`);
+    lines.push(`제거될 스크립트 (${u.scripts.length}개):`);
+    for (const f of u.scripts) lines.push(`  - ${f}`);
+    if (u.coderabbit) lines.push("제거될 파일: .coderabbit.yaml");
+    if (u.readme) lines.push("제거될 항목: README.md 버전 섹션 (AUTO-VERSION-SECTION)");
+    if (u.gitignore) lines.push("제거될 항목: .gitignore 자동 추가 항목");
+    if (u.versionYml) lines.push("제거될 파일: version.yml");
   } else {
     if (plan.workflows) {
       const w = plan.workflows;

package/src/commands/interactive.js

@@ -18,6 +18,7 @@ import { runFull } from "./full.js";
 import { runVersion } from "./version.js";
 import { runWorkflows } from "./workflows.js";
 import { runRevert } from "./revert.js";
+import { runUninstallFlow } from "./uninstall.js";
 import * as prompts from "../ui/prompts.js";
 
 const CANCEL = prompts.CANCEL;
@@ -53,6 +54,14 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     return 0;
   }
 
+  // uninstall 모드 — 대화형 체크리스트로 항목별 opt-in 후 삭제. 감지·breaking 게이트 불필요.
+  // runUninstallFlow는 취소/항목없음 시 null을 반환한다 — 그때는 완료 outro를 찍지 않는다.
+  if (mode === "uninstall") {
+    const result = await runUninstallFlow(payload, cwd, io);
+    if (result) io.outro?.("완전 삭제를 마쳤습니다.");
+    return 0;
+  }
+
   // Breaking Changes 게이트 (.sh execute_integration L4415~4420 — 모든 모드 공통, 대화형은 확인 질문)
   const proceed = await runBreakingCheck({
     cwd, payloadRoot: payload, templateVersion,

package/src/commands/uninstall.js

@@ -0,0 +1,129 @@
+// uninstall 모드 — revert(payload 파일명 일치분)보다 넓게, README/.gitignore/version.yml까지 선택적으로 제거.
+// 대화형 체크리스트 또는 --force + --purge-* 로 항목별 opt-in. revert.js는 건드리지 않고 읽기 전용으로만 재사용한다.
+import { join } from "node:path";
+import { existsSync, renameSync } from "node:fs";
+import { PATHS } from "../core/paths.js";
+import { remove } from "../core/fsutil.js";
+import { planRevert } from "./revert.js";
+import { removeVersionSectionFromReadme, hasVersionSection } from "../core/copy/readme.js";
+import { removeAutoAddedEntriesFromGitignore, hasAutoAddedEntries } from "../core/copy/gitignore.js";
+import { CANCEL } from "../ui/prompts.js";
+
+// selection: { workflows, scripts, coderabbit, readme, gitignore, versionYml } (모두 boolean).
+// 반환: 위와 동일한 키의 boolean/배열 — 실제로 제거 "대상"인지 여부(순수 함수, 아무것도 지우지 않음).
+export function planUninstall(payloadRoot, targetRoot, selection) {
+  const revertPlan = planRevert(payloadRoot, targetRoot);
+  return {
+    workflows: selection.workflows ? revertPlan.workflows : [],
+    scripts: selection.scripts ? revertPlan.scripts : [],
+    coderabbit: selection.coderabbit ? revertPlan.coderabbit : false,
+    readme: selection.readme ? hasVersionSection(targetRoot) : false,
+    gitignore: selection.gitignore ? hasAutoAddedEntries(targetRoot) : false,
+    versionYml: selection.versionYml ? existsSync(join(targetRoot, PATHS.versionFile)) : false,
+  };
+}
+
+// 반환: planUninstall과 동일한 형태 — 실제로 제거된 항목.
+export function runUninstall(context, payloadRoot, targetRoot, selection) {
+  const plan = planUninstall(payloadRoot, targetRoot, selection);
+  const wfDir = join(targetRoot, PATHS.workflowsDir);
+  for (const name of plan.workflows) remove(join(wfDir, name));
+  for (const name of plan.scripts) remove(join(targetRoot, PATHS.scriptsDir, name));
+  if (plan.coderabbit) {
+    const cr = join(targetRoot, ".coderabbit.yaml");
+    remove(cr);
+    if (existsSync(cr + ".bak")) renameSync(cr + ".bak", cr);
+  }
+  // removeVersionSectionFromReadme/removeAutoAddedEntriesFromGitignore는 plan이 "제거 대상"으로
+  // 판단했더라도 실제로는 안전하게 포기(skip-*)할 수 있다 — 반환 상태를 그대로 신뢰하지 않고
+  // 실제 결과로 plan을 덮어써서 호출부(CLI/대화형 요약)가 거짓 성공을 보고하지 않게 한다.
+  const readmeRemoved = plan.readme && removeVersionSectionFromReadme(targetRoot) === "removed";
+  const gitignoreStatus = plan.gitignore ? removeAutoAddedEntriesFromGitignore(targetRoot) : null;
+  const gitignoreRemoved = gitignoreStatus === "removed" || gitignoreStatus === "file-deleted";
+  if (plan.versionYml) remove(join(targetRoot, PATHS.versionFile));
+  return { ...plan, readme: readmeRemoved, gitignore: gitignoreRemoved };
+}
+
+// ── 대화형 체크리스트 흐름 ────────────────────────────────────────────
+const ITEM_DEFS = [
+  { key: "workflows", label: "워크플로우 (.github/workflows/PROJECT-*.yaml)" },
+  { key: "scripts", label: "스크립트 (.github/scripts/*.py)" },
+  { key: "coderabbit", label: ".coderabbit.yaml" },
+  { key: "readme", label: "README.md 버전 섹션 (AUTO-VERSION-SECTION)" },
+  { key: "gitignore", label: ".gitignore 자동 추가 항목" },
+  { key: "versionYml", label: "version.yml (버전/브랜치 설정 전체)" },
+];
+
+// 기본 체크 상태 — 설치 시 옵션(nexus/secret-backup/coderabbit)이 opt-in인 것과 대칭으로,
+// 여기서는 "안전 삭제" 3종만 기본 체크하고 나머지(readme/gitignore/versionYml)는 opt-in.
+export const SAFE_ITEMS = ["workflows", "scripts", "coderabbit"];
+
+function detectAvailableItems(payloadRoot, targetRoot) {
+  const revertPlan = planRevert(payloadRoot, targetRoot);
+  const presence = {
+    workflows: revertPlan.workflows.length > 0,
+    scripts: revertPlan.scripts.length > 0,
+    coderabbit: revertPlan.coderabbit,
+    readme: hasVersionSection(targetRoot),
+    gitignore: hasAutoAddedEntries(targetRoot),
+    versionYml: existsSync(join(targetRoot, PATHS.versionFile)),
+  };
+  return ITEM_DEFS.filter((d) => presence[d.key]).map((d) => ({ value: d.key, label: d.label }));
+}
+
+function toSelection(checkedKeys) {
+  const set = new Set(checkedKeys);
+  return {
+    workflows: set.has("workflows"), scripts: set.has("scripts"), coderabbit: set.has("coderabbit"),
+    readme: set.has("readme"), gitignore: set.has("gitignore"), versionYml: set.has("versionYml"),
+  };
+}
+
+function summarizeSelection(selection) {
+  const labelOf = Object.fromEntries(ITEM_DEFS.map((d) => [d.key, d.label]));
+  const chosen = Object.keys(selection).filter((k) => selection[k]).map((k) => `- ${labelOf[k]}`);
+  return chosen.length ? chosen.join("\n") : "(선택된 항목 없음)";
+}
+
+function summarizeResult(result) {
+  const lines = [];
+  if (result.workflows.length) lines.push(`워크플로우 ${result.workflows.length}개 제거`);
+  if (result.scripts.length) lines.push(`스크립트 ${result.scripts.length}개 제거`);
+  if (result.coderabbit) lines.push(".coderabbit.yaml 제거");
+  if (result.readme) lines.push("README.md 버전 섹션 제거");
+  if (result.gitignore) lines.push(".gitignore 자동 추가 항목 제거");
+  if (result.versionYml) lines.push("version.yml 제거");
+  return lines.length ? lines.join("\n") : "제거된 항목이 없습니다.";
+}
+
+// io 계약: engineIo.multiselect({message,options,initialValues}), askYesNo(msg,def),
+// note(text,title)?, cancelMessage(text)? — src/ui/prompts.js가 실물, 테스트는 스텁 주입.
+export async function runUninstallFlow(payloadRoot, targetRoot, io) {
+  const available = detectAvailableItems(payloadRoot, targetRoot);
+  if (available.length === 0) {
+    io.note?.("제거할 항목이 없습니다.", "완전 삭제");
+    return null;
+  }
+
+  const checked = await io.engineIo.multiselect({
+    message: "삭제할 항목을 선택하세요 (Space 토글, Enter 확정)",
+    options: available,
+    initialValues: available.map((o) => o.value).filter((v) => SAFE_ITEMS.includes(v)),
+  });
+  if (checked === CANCEL || !Array.isArray(checked) || checked.length === 0) {
+    io.cancelMessage?.("완전 삭제를 취소했습니다.");
+    return null;
+  }
+
+  const selection = toSelection(checked);
+  io.note?.(summarizeSelection(selection), "삭제 예정 항목");
+  const ok = await io.askYesNo("정말 삭제할까요? 되돌릴 수 없습니다.", false);
+  if (ok !== true) {
+    io.cancelMessage?.("완전 삭제를 취소했습니다.");
+    return null;
+  }
+
+  const result = runUninstall({}, payloadRoot, targetRoot, selection);
+  io.note?.(summarizeResult(result), "완전 삭제 완료");
+  return result;
+}

package/src/core/copy/gitignore.js

@@ -1,6 +1,6 @@
 // .gitignore 보장 (.sh ensure_gitignore + normalize/check 등가) — template_integrator.sh 3996~4111.
 import { join } from "node:path";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, rmSync } from "node:fs";
 
 const REQUIRED_ENTRIES = ["/.idea", "/.claude/settings.local.json"];
 
@@ -53,3 +53,55 @@ export function ensureGitignore(targetRoot = ".") {
   writeFileSync(p, content);
   return { created: false, added: toAdd };
 }
+
+// ensureGitignore가 기존 파일에 배너 블록을 추가할 때 항상 이 정확한 시퀀스로 시작한다
+// (빈 줄 하나 + 3줄 배너). 배너 직후, REQUIRED_ENTRIES와 일치하는 라인이 연속되는 동안만
+// "마법사가 추가한 항목"이다 — 그 뒤에 사용자가 나중에 추가한 항목은 절대 건드리지 않는다.
+const BANNER =
+  "\n" +
+  "# ====================================================================\n" +
+  "# project-auto-wizard: Auto-added entries\n" +
+  "# ====================================================================\n";
+
+// .gitignore에 마법사가 추가한 항목이 있는지 확인 (체크리스트 노출 판단용).
+// 두 케이스: (1) 원래 없던 파일을 통째로(또는 그 뒤에 사용자가 이어 쓴 형태로) 새로 만든 경우
+// (2) 기존 파일에 배너 블록을 붙인 경우.
+export function hasAutoAddedEntries(targetRoot = ".") {
+  const p = join(targetRoot, ".gitignore");
+  if (!existsSync(p)) return false;
+  const content = readFileSync(p, "utf8");
+  return content.startsWith(NEW_FILE_CONTENT) || content.includes(BANNER);
+}
+
+// 반환: 'removed' | 'file-deleted' | 'skip-no-gitignore' | 'skip-not-found'
+export function removeAutoAddedEntriesFromGitignore(targetRoot = ".") {
+  const p = join(targetRoot, ".gitignore");
+  if (!existsSync(p)) return "skip-no-gitignore";
+  const content = readFileSync(p, "utf8");
+
+  // 원래 파일이 없었는데 마법사가 통째로 만든 경우 — 그 뒤에 사용자가 이어서 추가한 내용만 보존.
+  if (content.startsWith(NEW_FILE_CONTENT)) {
+    const remainder = content.slice(NEW_FILE_CONTENT.length);
+    if (remainder === "") {
+      rmSync(p);
+      return "file-deleted";
+    }
+    writeFileSync(p, remainder);
+    return "removed";
+  }
+
+  // 기존 파일에 배너 블록이 붙은 경우 — 배너 직후 REQUIRED_ENTRIES와 일치하는 라인이 연속되는
+  // 동안만 제거하고, 그 뒤(사용자가 나중에 추가한 항목)는 그대로 둔다.
+  const idx = content.indexOf(BANNER);
+  if (idx === -1) return "skip-not-found";
+  const afterBanner = idx + BANNER.length;
+  const lines = content.slice(afterBanner).split("\n");
+  let consumed = 0;
+  for (const line of lines) {
+    const isKnownEntry = REQUIRED_ENTRIES.some((e) => normalizeGitignoreEntry(line) === normalizeGitignoreEntry(e));
+    if (!isKnownEntry) break;
+    consumed += line.length + 1; // +1: split이 삼킨 "\n"
+  }
+  writeFileSync(p, content.slice(0, idx) + content.slice(afterBanner + consumed));
+  return "removed";
+}

package/src/core/copy/readme.js

@@ -1,6 +1,6 @@
 // README 버전 섹션 추가 (.sh add_version_section_to_readme 등가) — template_integrator.sh 2145~2181.
 import { join } from "node:path";
-import { existsSync, readFileSync, appendFileSync } from "node:fs";
+import { existsSync, readFileSync, appendFileSync, writeFileSync } from "node:fs";
 
 const MARKER = "<!-- AUTO-VERSION-SECTION";
 // ## (최신 버전|최신버전|Version|버전) : vX.Y.Z (대소문자 무시)
@@ -28,3 +28,54 @@ export function addVersionSectionToReadme(version, targetRoot = ".") {
   appendFileSync(p, section);
   return "added";
 }
+
+// addVersionSectionToReadme가 항상 파일 맨 끝에 붙이는 접두/접미 시퀀스.
+// 접두(SECTION_PREFIX)가 있으면 마법사가 append한 "블록"이다 — 이 블록은 항상 SECTION_TAIL
+// 라인으로 끝나므로, 그 지점까지만 잘라내야 그 뒤에 사용자가 나중에 덧붙인 내용(라이선스 절 등)을
+// 지우지 않는다("파일 끝까지" 자르면 사용자 콘텐츠가 소실된다).
+const SECTION_PREFIX = "\n---\n\n" + MARKER;
+const SECTION_TAIL = "[전체 버전 기록 보기](CHANGELOG.md)\n";
+// PROJECT-COMMON-README-VERSION-UPDATE.yaml(설치되는 CI)은 설치 시점에 이미 사용자가 자기 버전
+// 라인을 갖고 있던 README(addVersionSectionToReadme가 'skip-version-line'으로 건너뛴 경우)에는
+// '---' 구분자 없이 마커 주석 한 줄만 그 버전 라인 위에 끼워넣는다. 이 경우 버전 라인 자체는
+// 사용자 소유이므로 지우지 않고 마커 주석 한 줄만 제거한다.
+const MARKER_LINE = "<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n";
+
+// README.md에 마법사(또는 설치된 CI)가 추가한 흔적이 있는지 확인 (체크리스트 노출 판단용).
+export function hasVersionSection(targetRoot = ".") {
+  const p = join(targetRoot, "README.md");
+  if (!existsSync(p)) return false;
+  const content = readFileSync(p, "utf8");
+  return content.includes(SECTION_PREFIX) || content.includes(MARKER_LINE);
+}
+
+// 반환: 'removed' | 'skip-no-readme' | 'skip-no-marker' | 'skip-unexpected-format'
+export function removeVersionSectionFromReadme(targetRoot = ".") {
+  const p = join(targetRoot, "README.md");
+  if (!existsSync(p)) return "skip-no-readme";
+  const content = readFileSync(p, "utf8");
+
+  const idx = content.indexOf(SECTION_PREFIX);
+  if (idx !== -1) {
+    // 마법사가 append한 전체 블록 케이스 — SECTION_TAIL 라인까지만 잘라내고 그 이후는 보존한다.
+    // tail을 못 찾거나(사용자가 그 줄을 지웠다면), 위저드 블록치고 너무 먼 곳에서 발견되면
+    // (사용자가 같은 문구를 자기 문서 어딘가로 옮겨 적은 경우) 그 사이 사용자 콘텐츠까지
+    // 지워버릴 수 있으므로 어디까지가 "마법사 구간"인지 확신할 수 없어 안전하게 포기한다.
+    // 위저드 블록은 버전 문자열이 길어져도 수백 바이트를 넘지 않는다.
+    const MAX_SECTION_LENGTH = 300;
+    const tailIdx = content.indexOf(SECTION_TAIL, idx);
+    if (tailIdx === -1 || tailIdx > idx + MAX_SECTION_LENGTH) return "skip-unexpected-format";
+    const cutEnd = tailIdx + SECTION_TAIL.length;
+    writeFileSync(p, content.slice(0, idx) + content.slice(cutEnd));
+    return "removed";
+  }
+
+  const markerIdx = content.indexOf(MARKER_LINE);
+  if (markerIdx !== -1) {
+    // CI가 사용자의 기존 버전 라인 위에 마커만 끼워넣은 케이스 — 버전 라인은 건드리지 않는다.
+    writeFileSync(p, content.slice(0, markerIdx) + content.slice(markerIdx + MARKER_LINE.length));
+    return "removed";
+  }
+
+  return "skip-no-marker";
+}

package/src/index.js

@@ -19,6 +19,8 @@ import { runFull } from "./commands/full.js";
 import { runVersion } from "./commands/version.js";
 import { runWorkflows } from "./commands/workflows.js";
 import { runRevert } from "./commands/revert.js";
+import { runUninstall, runUninstallFlow } from "./commands/uninstall.js";
+import * as prompts from "./ui/prompts.js";
 import { runInteractive } from "./commands/interactive.js";
 import { runStatus, printStatus } from "./commands/status.js";
 import { runDoctor, printDoctorReport } from "./commands/doctor.js";
@@ -63,11 +65,11 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
   if (opts.mode === "interactive") {
     // --dry-run은 대화형 모드에서 조용히 무시되면 안 됨(실제 설치가 진행돼버림) — 명시 에러로 차단.
     if (opts.dryRun) {
-      console.error("--dry-run은 --mode <full|version|workflows|revert>와 함께 사용하세요 (대화형 모드에서는 지원하지 않습니다).");
+      console.error("--dry-run은 --mode <full|version|workflows|revert|uninstall>와 함께 사용하세요 (대화형 모드에서는 지원하지 않습니다).");
       return 1;
     }
     if (!process.stdout.isTTY) {
-      console.error("대화형 입력이 불가능한 환경입니다. --mode <full|version|workflows|revert> 와 --force 를 지정하세요.");
+      console.error("대화형 입력이 불가능한 환경입니다. --mode <full|version|workflows|revert|uninstall> 와 --force 를 지정하세요.");
       return 1;
     }
     return await runInteractive({}, { cwd, payloadRoot: payload, clock });
@@ -89,6 +91,35 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
     console.error("version.yml·README·.gitignore는 보존됩니다 (사용자 데이터).");
     return 0;
   }
+
+  // uninstall 모드 — revert보다 넓게 README·gitignore·version.yml까지 선택적으로 제거.
+  if (opts.mode === "uninstall") {
+    const safeSelection = {
+      workflows: true, scripts: true, coderabbit: true,
+      readme: opts.purgeReadme, gitignore: opts.purgeGitignore, versionYml: opts.purgeVersion,
+    };
+    if (opts.dryRun) {
+      printDryRun(planDryRun("uninstall", { uninstallSelection: safeSelection }, payload, cwd));
+      return 0;
+    }
+    if (opts.force) {
+      const r = runUninstall({}, payload, cwd, safeSelection);
+      const removed = [
+        `워크플로우 ${r.workflows.length}개`, `스크립트 ${r.scripts.length}개`,
+        r.coderabbit && ".coderabbit.yaml", r.readme && "README 버전 섹션",
+        r.gitignore && ".gitignore 자동 추가 항목", r.versionYml && "version.yml",
+      ].filter(Boolean).join(", ");
+      console.error(`제거됨 — ${removed}`);
+      return 0;
+    }
+    if (!process.stdout.isTTY) {
+      console.error("비대화형 환경에서는 --force 옵션이 필요합니다.");
+      return 1;
+    }
+    await runUninstallFlow(payload, cwd, prompts);
+    return 0;
+  }
+
   // status 모드 — 읽기 전용, TTY/--force 무관하게 항상 동작
   if (opts.mode === "status") {
     printStatus(runStatus(payload, cwd));

package/src/ui/prompts.js

@@ -14,6 +14,7 @@ export async function selectMode() {
       { value: "version", label: "버전 관리만 — 버전 자동 증가·동기화 시스템만 설치" },
       { value: "workflows", label: "워크플로우만 — 빌드·배포 GitHub Actions만 설치" },
       { value: "revert", label: "되돌리기 — 마법사가 설치한 워크플로우·스크립트 제거" },
+      { value: "uninstall", label: "완전 삭제 — 마법사가 설치·수정한 모든 항목 제거(확인 후, README·gitignore·version.yml 포함)" },
     ],
   });
 }