project-auto-wizard 0.1.8 → 0.1.9

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.9 (2026-08-02)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "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/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 자동 추가 블록은 보존됩니다 — 별도 이슈에서 다룸)");
+  lines.push("");
+  console.log(lines.join("\n"));
+}

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/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/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") {