project-auto-wizard 0.1.6 → 0.1.8

package/payload/workflows/common/PROJECT-COMMON-RELEASE-PUBLISH.yaml

@@ -13,10 +13,16 @@
 #   exits cleanly. Version + changelog were already confirmed in the PR.
 #
 # - trunk-based: every direct push to {{MAIN_BRANCH}} is a release.
-#   This job bumps the version (patch +1 and sync), summarizes the commits
-#   since the last tag with the ai-summary engine chain (user API ->
-#   GitHub Models -> rule-based fallback), updates CHANGELOG.json /
-#   CHANGELOG.md, and commits everything back with [skip ci].
+#   This job bumps the version and syncs it, summarizes the commits since
+#   the last tag with the ai-summary engine chain (user API -> GitHub
+#   Models -> rule-based fallback, diff-stat-enriched prompt), updates
+#   CHANGELOG.json / CHANGELOG.md, and commits everything back with
+#   [skip ci]. Same as pr-flow's AUTO-CHANGELOG-CONTROL:
+#   - If version.yml metadata.template.options.semver_auto is true
+#     (default): classifies commits (feat -> minor, `!` marker -> major,
+#     else patch; AI-assisted patch->minor upgrade for unclassified
+#     commits) and bumps accordingly.
+#   - Otherwise: always patch+1 (legacy behavior).
 #
 # Common tail (both modes): recovery-aware idempotency guard (tag and
 # release checked separately so a half-published release can be finished
@@ -102,6 +108,19 @@ jobs:
             echo "not a release-confirm push in pr-flow mode — skipping (clean exit)"
           fi
 
+      - name: Read semver_auto option from version.yml
+        id: semver_options
+        if: >-
+          steps.gate.outputs.proceed == 'true' &&
+          steps.mode.outputs.mode == 'trunk-based' &&
+          github.event_name == 'push'
+        run: |
+          # scoped to the metadata: -> template: -> options: chain so an
+          # unrelated "semver_auto:" key can never hijack the value
+          SEMVER_AUTO=$(python3 -c 'import re; t=open("version.yml",encoding="utf-8").read(); m=re.search(r"metadata:.*?template:.*?options:.*?semver_auto:\s*\"?(true|false)", t, re.S); print(m.group(1) if m else "false")' 2>/dev/null || echo "false")
+          echo "semver_auto=$SEMVER_AUTO" >> $GITHUB_OUTPUT
+          echo "semver_auto option: $SEMVER_AUTO"
+
       - name: Trunk-based version bump + changelog
         if: >-
           steps.gate.outputs.proceed == 'true' &&
@@ -123,28 +142,48 @@ jobs:
             exit 0
           fi
 
-          NEW_VERSION=$(python3 .github/scripts/version_manager.py increment | tail -n 1)
-          if [ -z "$NEW_VERSION" ]; then
-            echo "version bump failed"
-            exit 1
-          fi
-          python3 .github/scripts/version_manager.py sync
-          echo "release version: $NEW_VERSION"
-
-          # Commits since the last tag (fall back to full history on first release)
+          # Commits (and diff-stat) since the last tag — this is "what's in
+          # this release" for trunk-based pushes. Fall back to the full
+          # history / a diff against the empty tree on the first-ever
+          # release (no previous tag to diff against).
           LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
           if [ -n "$LAST_TAG" ]; then
             echo "collecting commits since $LAST_TAG"
             git log --pretty=%s "${LAST_TAG}..HEAD" > commits.txt
+            DIFF_BASE="$LAST_TAG"
           else
             echo "no previous tag — collecting the full history"
             git log --pretty=%s > commits.txt
+            DIFF_BASE="4b825dc642cb6eb9a060e54bf8d69288fbee4904" # git empty tree hash
           fi
+          git diff --stat "${DIFF_BASE}..HEAD" > _full_diff_stat.txt
+          if [ "$(wc -l < _full_diff_stat.txt)" -gt 49 ]; then
+            { head -49 _full_diff_stat.txt; tail -1 _full_diff_stat.txt; } > diff_stat.txt
+          else
+            cp _full_diff_stat.txt diff_stat.txt
+          fi
+          rm -f _full_diff_stat.txt
+
+          if [ "${{ steps.semver_options.outputs.semver_auto }}" = "true" ]; then
+            BUMP=$(python3 .github/scripts/changelog_manager.py classify-bump --commits-file commits.txt | tail -n 1)
+          else
+            BUMP="patch"
+          fi
+          echo "bump level: $BUMP"
+
+          NEW_VERSION=$(python3 .github/scripts/version_manager.py increment --bump "$BUMP" | tail -n 1)
+          if [ -z "$NEW_VERSION" ]; then
+            echo "version bump failed"
+            exit 1
+          fi
+          python3 .github/scripts/version_manager.py sync
+          echo "release version: $NEW_VERSION ($BUMP)"
 
           python3 .github/scripts/changelog_manager.py ai-summary \
             --commits-file commits.txt \
             --version "$NEW_VERSION" \
-            --output summary.md
+            --output summary.md \
+            --diff-stat-file diff_stat.txt
 
           # Same input channel as AUTO-CHANGELOG-CONTROL:
           # update-from-summary reads ./pr_body.md
@@ -165,7 +204,7 @@ jobs:
           python3 .github/scripts/changelog_manager.py update-from-summary
           python3 .github/scripts/changelog_manager.py generate-md
 
-          rm -f pr_body.md summary.md commits.txt
+          rm -f pr_body.md summary.md commits.txt diff_stat.txt
 
           git add -A
           if git diff --staged --quiet; then

package/src/cli/args.js

@@ -11,12 +11,17 @@ export function parseArgs(argv) {
     includeNexus: null,      // null=미설정
     includeSecretBackup: null,
     includeCodeRabbit: null, // --coderabbit / --no-coderabbit (기본 false — DESIGN-SPEC §4 질문②)
+    includeSemverAuto: null,  // --semver-auto / --no-semver-auto (기본 true — 미지정 시 다운스트림에서 해석)
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     mainBranch: "",          // 릴리스 브랜치 (--main-branch). 빈값=감지된 default branch
     developBranch: "",       // 개발 브랜치 (--develop-branch). 빈값=develop
     force: false,
     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) {
@@ -49,12 +54,18 @@ export function parseArgs(argv) {
         break;
       }
       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;
       case "--no-secret-backup": result.includeSecretBackup = false; break;
       case "--coderabbit": result.includeCodeRabbit = true; break;
       case "--no-coderabbit": result.includeCodeRabbit = false; break;
+      case "--semver-auto": result.includeSemverAuto = true; break;
+      case "--no-semver-auto": result.includeSemverAuto = false; break;
       case "--paths": result.pathsCsv = args.shift() ?? ""; break;
       case "--main-branch": result.mainBranch = args.shift() ?? ""; break;
       case "--develop-branch": result.developBranch = args.shift() ?? ""; break;

package/src/cli/help.js

@@ -5,8 +5,10 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
   npx project-auto-wizard [옵션]
 
 옵션:
-  -m, --mode MODE          통합 모드 (full | version | workflows | revert)
+  -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
                                  react-native-expo node python basic
@@ -17,11 +19,20 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
       --nexus / --no-nexus            Nexus 라이브러리 publish 워크플로우 포함/제외
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --coderabbit / --no-coderabbit  CodeRabbit PR 요약을 릴리스 노트 1순위로 사용 (기본: 사용 안 함)
+      --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
       --force              모든 확인 생략, 비대화형 기본값 사용
+      --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               이 도움말 표시
 
 예시:
   npx project-auto-wizard --mode full --force --type spring,react
   npx project-auto-wizard --mode workflows --type flutter --paths "flutter=app"
+  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/doctor.js

@@ -0,0 +1,73 @@
+// doctor 명령 — 로컬 환경 진단(읽기 전용, 규칙 기반). gh CLI에 위임해 원격 상태를 점검한다.
+// AI 진단은 포함하지 않는다(스펙 §4에서 검토 후 기각 — 복잡도 대비 이득 낮음).
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+
+const defaultExec = (cmd, args) => spawnSync(cmd, args, { encoding: "utf8" });
+
+export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
+  const results = [];
+  const add = (name, status, detail) => { results.push({ name, status, detail }); return results; };
+
+  const installed = existsSync(join(cwd, "version.yml"));
+  add("설치 여부", installed ? "OK" : "WARN",
+    installed ? "version.yml 발견" : "이 디렉터리에 project-auto-wizard가 설치되어 있지 않습니다 (version.yml 없음)");
+
+  const ghVersion = exec("gh", ["--version"]);
+  if (ghVersion.error || ghVersion.status !== 0) {
+    add("gh CLI", "WARN", "gh CLI를 찾을 수 없습니다 — 원격 점검을 건너뜁니다 (https://cli.github.com/ 설치 권장)");
+    return results;
+  }
+  add("gh CLI", "OK", (ghVersion.stdout || "").split("\n")[0] || "설치됨");
+
+  const auth = exec("gh", ["auth", "status"]);
+  const authOk = !auth.error && auth.status === 0;
+  add("gh 인증", authOk ? "OK" : "FAIL", authOk ? "인증됨" : "`gh auth login`이 필요합니다");
+  if (!authOk) return results;
+
+  const remote = exec("git", ["-C", cwd, "remote", "get-url", "origin"]);
+  const url = remote.status === 0 ? (remote.stdout || "").trim() : "";
+  const match = url.match(/github\.com[:/]([^/]+)\/([^/.]+?)(\.git)?$/);
+  if (!match) {
+    add("GitHub 원격", "WARN", "origin 리모트에서 GitHub owner/repo를 확인하지 못했습니다");
+    return results;
+  }
+  const [, owner, repo] = match;
+
+  const perm = exec("gh", ["api", `repos/${owner}/${repo}/actions/permissions/workflow`, "--jq", ".default_workflow_permissions"]);
+  const permValue = (perm.stdout || "").trim();
+  add("Workflow permissions", perm.status === 0 && permValue === "write" ? "OK" : "WARN",
+    perm.status === 0
+      ? `현재값: ${permValue || "확인불가"} (Settings → Actions → General → Workflow permissions: Read and write 권장)`
+      : "조회 실패 — repo 관리자 권한이 필요할 수 있습니다");
+
+  const secrets = exec("gh", ["secret", "list", "--repo", `${owner}/${repo}`]);
+  const hasPat = secrets.status === 0 && (secrets.stdout || "").split("\n").some((l) => l.startsWith("WORKFLOW_PAT"));
+  add("WORKFLOW_PAT secret", hasPat ? "OK" : "WARN",
+    hasPat
+      ? "등록됨"
+      : "미등록 — automerge 후 후속 워크플로우(tag/Release)가 트리거되지 않을 수 있습니다. Settings → Secrets → Actions에 등록 (scopes: repo, workflow)");
+
+  const mergeSettings = exec("gh", ["api", `repos/${owner}/${repo}`, "--jq", ".allow_merge_commit"]);
+  const automergeOk = mergeSettings.status === 0 && mergeSettings.stdout.trim() === "true";
+  add("automerge 호환성(merge commit 허용)", automergeOk ? "OK" : "WARN",
+    mergeSettings.status === 0
+      ? (automergeOk
+        ? "머지 커밋 허용됨"
+        : "이 레포는 merge commit이 비활성화되어 있습니다 — automerge/RELEASE-PUBLISH가 머지 커밋 subject를 감지하는 방식과 충돌할 수 있습니다. Settings → General → Pull Requests → Allow merge commits 활성화 권장")
+      : "조회 실패 — repo 관리자 권한이 필요할 수 있습니다");
+
+  add("GitHub Models 활성화", "INFO",
+    "자동 확인 불가 — Settings → Models에서 조직 정책으로 차단되지 않았는지 직접 확인하세요 (차단 시 규칙 기반 fallback으로 자동 전환됩니다)");
+
+  return results;
+}
+
+export function printDoctorReport(results) {
+  const icon = { OK: "✅", WARN: "⚠️ ", FAIL: "❌", INFO: "ℹ️ " };
+  const lines = ["", "project-auto-wizard doctor — 환경 진단 결과", ""];
+  for (const r of results) lines.push(`${icon[r.status] || "  "} [${r.status}] ${r.name} — ${r.detail}`);
+  lines.push("");
+  console.log(lines.join("\n"));
+}

package/src/commands/dry-run.js

@@ -0,0 +1,91 @@
+// --dry-run 미리보기 — 실제 파일을 쓰지 않고 무엇이 바뀔지 계산한다.
+// 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";
+
+function versionYmlPreview(context, payloadRoot, targetRoot) {
+  const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
+    now, today, templateVersion = "unknown",
+    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false,
+    includeSemverAuto } = context;
+  const pathMarkers = new Map();
+  for (const [t] of paths) pathMarkers.set(t, markerForType(t));
+  const wouldBe = buildVersionYml({
+    templateText: readVersionYmlTemplate(payloadRoot),
+    version, types, paths, pathMarkers, branch, branches: context.branches, versionCode, now, today,
+    templateOptions: {
+      templateVersion, includeNexus, includeSecretBackup,
+      includeCodeRabbit: includeCodeRabbit === true,
+      includeSemverAuto: includeSemverAuto !== false,
+      optionsDate: today,
+    },
+  });
+  const vyPath = join(targetRoot, PATHS.versionFile);
+  const existing = existsSync(vyPath) ? readFileSync(vyPath, "utf8") : null;
+  return { existed: existing !== null, changed: existing !== wouldBe };
+}
+
+// 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") {
+    result.workflows = planWorkflows(context, payloadRoot, targetRoot);
+  }
+  if (mode === "full" || mode === "version") {
+    result.versionYml = versionYmlPreview(context, payloadRoot, targetRoot);
+  }
+  return result;
+}
+
+export function printDryRun(plan) {
+  const lines = ["", `project-auto-wizard --dry-run (mode: ${plan.mode}) — 미리보기, 실제 파일은 바뀌지 않았습니다`, ""];
+  if (plan.mode === "revert") {
+    const r = plan.revert;
+    lines.push(`제거될 워크플로우 (${r.workflows.length}개):`);
+    for (const f of r.workflows) lines.push(`  - ${f}`);
+    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;
+      lines.push(`신규 파일 (${w.newFiles.length}개):`);
+      for (const f of w.newFiles) lines.push(`  + ${f.filename} [${f.type}]`);
+      lines.push(`변경될 파일 (${w.changed.length}개, 기존 설치가 사용자 수정본이면 충돌):`);
+      for (const f of w.changed) lines.push(`  ~ ${f.filename} [${f.type}]`);
+      lines.push(`동일한 파일 (${w.unchanged.length}개, 변경 없음)`);
+    }
+    if (plan.versionYml) {
+      lines.push(plan.versionYml.existed
+        ? (plan.versionYml.changed ? "version.yml: 갱신될 예정" : "version.yml: 변경 없음")
+        : "version.yml: 새로 생성될 예정");
+      // dry-run은 프롬프트 없이 읽기 전용으로 동작하므로 @wizard ask 배포 설정 값을 계산할 수 없다.
+      // spring 등 deploy 블록이 있는 타입은 실제 설치 결과와 미리보기가 다를 수 있음을 안내한다.
+      lines.push("  (참고: 배포 설정 질문이 있는 타입(spring 등)은 deploy: 블록이 미리보기에 반영되지 않아 실제 설치와 다르게 보일 수 있습니다.)");
+    }
+  }
+  lines.push("");
+  console.log(lines.join("\n"));
+}

package/src/commands/full.js

@@ -19,7 +19,8 @@ import { ensureGitignore } from "../core/copy/gitignore.js";
 export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     force = true, now, today, templateVersion = "unknown",
-    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false } = context;
+    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false,
+    includeSemverAuto } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
   const pathMarkers = new Map();
@@ -36,7 +37,7 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
       templateText: readVersionYmlTemplate(payloadRoot),
       version, types, paths, pathMarkers, branch, branches: context.branches, versionCode, now, today,
       deployValues,
-      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeCodeRabbit: includeCodeRabbit === true, optionsDate: today },
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeCodeRabbit: includeCodeRabbit === true, includeSemverAuto: includeSemverAuto !== false, optionsDate: today },
     }));
 
   // 3. README 버전 섹션

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,
@@ -70,6 +79,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   let includeNexus = existing?.options?.nexus ?? false;
   let includeSecretBackup = existing?.options?.secretBackup ?? false;
   let includeCodeRabbit = existing?.options?.coderabbit ?? null;
+  let includeSemverAuto = existing?.options?.semverAuto ?? null;
   const showOptional = mode === "full" || mode === "workflows";
   const realTty = process.stdout.isTTY === true;
 
@@ -92,8 +102,19 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       const y = await io.askYesNo("CodeRabbit을 사용합니까? (PR AI 리뷰·요약을 릴리스 노트 1순위로 사용)", false);
       includeCodeRabbit = y === true;
     }
+
+    // 신규 질문 — 자동 semver 승격 (기본 ON). 저장값 있으면 재질문 생략.
+    // version.yml을 쓰지 않는 workflows 모드에서는 답변이 무의미하므로 full에서만 질문한다.
+    if (mode === "full" && includeSemverAuto === null) {
+      const y2 = await io.askYesNo("자동 버전 승격을 사용하시겠습니까? (커밋 타입에 따라 major/minor/patch 자동 결정)", true);
+      includeSemverAuto = y2 === true;
+    }
   }
   includeCodeRabbit = includeCodeRabbit === true;
+  // 질문이 실제로 나온 경우(위 full 모드 질문) 답변을 그대로 존중.
+  // 질문이 안 나온 경우(version/workflows 모드) — 기존 설치는 안전하게 false로 폴백,
+  // 완전 신규 설치만 true(기존 설계) 유지 — CLI 경로(index.js)와 동일한 안전 정책.
+  includeSemverAuto = includeSemverAuto === null ? (existing ? false : true) : includeSemverAuto !== false;
 
   // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
   let paths = new Map();
@@ -189,6 +210,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const ctx = createContext({
     mode, force: true, types, version, versionCode, branch, branches, paths,
     includeNexus, includeSecretBackup, includeCodeRabbit,
+    includeSemverAuto,
     repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
   });
   ctx.templateVersion = templateVersion;

package/src/commands/revert.js

@@ -18,43 +18,44 @@ function payloadWorkflowNames(payloadRoot) {
   return names;
 }
 
-// 반환: { workflows: [...제거된 파일명], scripts: [...], coderabbit: bool }
-export function runRevert(context, payloadRoot, targetRoot = ".") {
+// payload에 존재하는 파일명과 정확히 일치하는 것만 제거 대상으로 계획한다.
+// 아무것도 지우지 않는 순수 함수 — --dry-run과 status류 기능에서 재사용.
+export function planRevert(payloadRoot, targetRoot = ".") {
   const removedWf = [];
   const removedScripts = [];
-
-  // 1. 워크플로우 — payload 파일명 일치분 + 마법사가 만든 .template.yaml/.bak 파생본
   const wfDir = join(targetRoot, PATHS.workflowsDir);
   const names = payloadWorkflowNames(payloadRoot);
   if (existsSync(wfDir)) {
     for (const name of names) {
       const p = join(wfDir, name);
-      if (existsSync(p)) { remove(p); removedWf.push(name); }
+      if (existsSync(p)) removedWf.push(name);
       const templateName = (name.endsWith(".yaml") ? name.slice(0, -".yaml".length) : name) + ".template.yaml";
-      const tp = join(wfDir, templateName);
-      if (existsSync(tp)) { remove(tp); removedWf.push(templateName); }
-      const bp = p + ".bak";
-      if (existsSync(bp)) { remove(bp); removedWf.push(name + ".bak"); }
+      if (existsSync(join(wfDir, templateName))) removedWf.push(templateName);
+      if (existsSync(p + ".bak")) removedWf.push(name + ".bak");
     }
   }
-
-  // 2. 스크립트 — payload가 설치한 2종만
   for (const s of ["version_manager.py", "changelog_manager.py"]) {
-    const p = join(targetRoot, PATHS.scriptsDir, s);
-    if (existsSync(p)) { remove(p); removedScripts.push(s); }
+    if (existsSync(join(targetRoot, PATHS.scriptsDir, s))) removedScripts.push(s);
   }
-
-  // 3. .coderabbit.yaml — payload 원본과 바이트 일치할 때만 제거 (사용자 자체 파일 보호).
-  //    설치 시 백업(.bak)이 있으면 복원한다.
   let coderabbit = false;
   const cr = join(targetRoot, ".coderabbit.yaml");
   const crSrc = join(payloadRoot, "coderabbit.yaml");
-  if (existsSync(cr) && existsSync(crSrc)
-    && readFileSync(cr, "utf8") === readFileSync(crSrc, "utf8")) {
-    remove(cr);
+  if (existsSync(cr) && existsSync(crSrc) && readFileSync(cr, "utf8") === readFileSync(crSrc, "utf8")) {
     coderabbit = true;
-    if (existsSync(cr + ".bak")) renameSync(cr + ".bak", cr);
   }
-
   return { workflows: removedWf, scripts: removedScripts, coderabbit };
 }
+
+// 반환: { workflows: [...제거된 파일명], scripts: [...], coderabbit: bool } — planRevert와 동일한 형태.
+export function runRevert(context, payloadRoot, targetRoot = ".") {
+  const plan = planRevert(payloadRoot, targetRoot);
+  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);
+  }
+  return plan;
+}

package/src/commands/status.js

@@ -0,0 +1,64 @@
+// status 명령 — 읽기 전용 설치 상태 확인. 네트워크 접근 없음(로컬 파일 비교만).
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseExisting } from "../core/version-yml.js";
+import { planWorkflows } from "../core/copy/workflows.js";
+import { makeResolvers, detectRepoName, detectDefaultBranch } from "../core/detect-fs.js";
+import { PATHS } from "../core/paths.js";
+
+// payloadRoot: 패키지 payload/ 루트. targetRoot: 상태를 확인할 대상 레포.
+export function runStatus(payloadRoot, targetRoot = ".") {
+  const vyPath = join(targetRoot, PATHS.versionFile);
+  if (!existsSync(vyPath)) return { installed: false };
+
+  const existing = parseExisting(readFileSync(vyPath, "utf8"));
+  const repoName = detectRepoName(targetRoot);
+  const resolvers = makeResolvers(targetRoot, repoName, existing.paths);
+  // version.yml에 branches 블록이 없으면(신기능 이전 설치·수기 편집) makeSrcText(null)이
+  // {{MAIN_BRANCH}}/{{DEVELOP_BRANCH}}를 치환하지 못해 모든 워크플로우가 드리프트로 오탐된다 —
+  // 비교용 기본값으로 폴백(실제 저장값은 아니지만 드리프트 비교 목적에는 충분).
+  const branchesForCompare = existing.branches || { main: detectDefaultBranch(targetRoot) || "main", develop: "develop", mode: "pr-flow" };
+  const context = {
+    types: existing.types, paths: existing.paths,
+    includeNexus: existing.options.nexus === true,
+    includeSecretBackup: existing.options.secretBackup === true,
+    repoName, resolvers, branches: branchesForCompare,
+  };
+  const plan = planWorkflows(context, payloadRoot, targetRoot);
+
+  return {
+    installed: true,
+    version: existing.version,
+    templateVersion: existing.templateVersion,
+    types: existing.types,
+    branches: existing.branches,
+    options: existing.options,
+    modifiedFiles: plan.changed.map((f) => f.filename),
+  };
+}
+
+export function printStatus(status) {
+  const lines = ["", "project-auto-wizard status — 설치 상태", ""];
+  if (!status.installed) {
+    lines.push("이 디렉터리에 project-auto-wizard가 설치되어 있지 않습니다 (version.yml 없음).", "");
+    console.log(lines.join("\n"));
+    return;
+  }
+  lines.push(`버전            : ${status.version}`);
+  lines.push(`템플릿 버전      : ${status.templateVersion}`);
+  lines.push(`프로젝트 타입    : ${status.types.join(", ") || "(없음)"}`);
+  if (status.branches) {
+    lines.push(`브랜치 모드      : ${status.branches.mode} (${status.branches.main} / ${status.branches.develop})`);
+  }
+  const boolLabel = (v) => (v === null ? "미설정(기본 false)" : v);
+  const semverAutoLabel = status.options.semverAuto === null ? "미설정(기본 false)" : status.options.semverAuto;
+  lines.push(`옵션            : nexus=${boolLabel(status.options.nexus)} secret_backup=${boolLabel(status.options.secretBackup)} coderabbit=${boolLabel(status.options.coderabbit)} semver_auto=${semverAutoLabel}`);
+  if (status.modifiedFiles.length) {
+    lines.push("", `사용자가 수정한 워크플로우 파일 (${status.modifiedFiles.length}개):`);
+    for (const f of status.modifiedFiles) lines.push(`  - ${f}`);
+  } else {
+    lines.push("", "모든 워크플로우 파일이 설치 시점 기본값과 동일합니다 (수정 없음).");
+  }
+  lines.push("");
+  console.log(lines.join("\n"));
+}