project-auto-wizard 0.1.6 → 0.1.7

package/src/cli/args.js

@@ -11,12 +11,14 @@ 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 공통)
   };
   const args = [...argv];
   while (args.length > 0) {
@@ -49,12 +51,15 @@ export function parseArgs(argv) {
         break;
       }
       case "--force": result.force = true; break;
+      case "--dry-run": result.dryRun = 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,9 @@ 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 | status | doctor)
                            기본: interactive (대화형). revert = 설치물 제거(되돌리기)
+                           status = 설치 상태·드리프트 확인(읽기 전용). doctor = 환경 진단(읽기 전용)
   -t, --type CSV           프로젝트 타입 csv (예: spring,react,python)
                            지원: spring flutter next react react-native
                                  react-native-expo node python basic
@@ -17,11 +18,16 @@ 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 전체 지원)
   -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
 `;

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,77 @@
+// --dry-run 미리보기 — 실제 파일을 쓰지 않고 무엇이 바뀔지 계산한다.
+// full/version/workflows/revert 4개 모드 전체 지원.
+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 { 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". 읽기 전용 — 아무 파일도 쓰지 않는다.
+export function planDryRun(mode, context, payloadRoot, targetRoot = ".") {
+  if (mode === "revert") return { mode, revert: planRevert(payloadRoot, targetRoot) };
+
+  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.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

@@ -70,6 +70,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 +93,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 +201,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"));
+}

package/src/commands/version.js

@@ -14,7 +14,8 @@ import { ensureGitignore } from "../core/copy/gitignore.js";
 export function runVersion(context, payloadRoot, targetRoot = ".") {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown",
-    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false } = context;
+    includeNexus = false, includeSecretBackup = false, includeCodeRabbit = false,
+    includeSemverAuto } = context;
 
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
@@ -23,7 +24,7 @@ export function runVersion(context, payloadRoot, targetRoot = ".") {
     buildVersionYml({
       templateText: readVersionYmlTemplate(payloadRoot),
       version, types, paths, pathMarkers, branch, branches: context.branches, versionCode, now, today,
-      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeCodeRabbit: includeCodeRabbit === true, optionsDate: today },
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeCodeRabbit: includeCodeRabbit === true, includeSemverAuto: includeSemverAuto !== false, optionsDate: today },
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(payloadRoot, targetRoot);

package/src/context.js

@@ -18,6 +18,7 @@ export function createContext(overrides = {}) {
     includeNexus: null,      // null=미설정, true/false=명시
     includeSecretBackup: null,
     includeCodeRabbit: null, // CodeRabbit opt-in (기본 false — version.yml options.coderabbit에 기록)
+    includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
     templateVersion: "",
     deployValues: new Map(), // "type.KEY" -> value
     counters: {},

package/src/core/copy/workflows.js

@@ -231,3 +231,59 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
     }
   }
 }
+
+// 전체 워크플로우 분류(common + 타입별 + server-deploy + nexus opt-in) — status/dry-run 공용.
+// listWorkflowConflicts와 달리 common 디렉토리도 포함하고, changed뿐 아니라
+// newFiles/unchanged까지 전부 반환한다(읽기 전용 — 실제로 아무 파일도 쓰지 않는다).
+export function planWorkflows(context, payloadRoot, targetRoot = ".") {
+  const { types = [], paths = new Map(), includeNexus = false, includeSecretBackup = false, repoName = "", resolvers = {} } = context;
+  const workflowsDir = join(targetRoot, PATHS.workflowsDir);
+  const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
+  const srcText = makeSrcText(context.branches || null);
+  const branchMode = context.branches?.mode || "pr-flow";
+  const plan = { newFiles: [], unchanged: [], changed: [] };
+
+  const merge = (result, type, excluded = null) => {
+    for (const bucket of ["newFiles", "unchanged", "changed"]) {
+      for (const filename of result[bucket]) {
+        if (excluded && excluded.has(filename)) continue;
+        plan[bucket].push({ filename, type });
+      }
+    }
+  };
+
+  const commonDir = join(projectTypesDir, "common");
+  if (exists(commonDir)) {
+    const envOpts = { type: "common", projectPath: ".", repoName, resolvers };
+    merge(classify(commonDir, workflowsDir, envOpts, srcText), "common",
+      branchMode === "trunk-based" ? TRUNK_BASED_EXCLUDED : null);
+  }
+
+  // secret-backup은 copyWorkflows처럼 신규 파일만 대상(기존 파일은 절대 덮어쓰지 않는 규약) —
+  // classify()의 changed 판정과 무관하게, 여기서도 존재 여부만으로 new/unchanged를 가른다.
+  const secretDir = join(commonDir, "secret-backup");
+  if (exists(secretDir) && includeSecretBackup) {
+    for (const filename of listYamlFiles(secretDir)) {
+      const dst = join(workflowsDir, filename);
+      plan[existsSync(dst) ? "unchanged" : "newFiles"].push({ filename, type: "common" });
+    }
+  }
+
+  for (const type of types) {
+    const envOpts = { type, projectPath: paths.get(type) || ".", repoName, resolvers };
+    const typeDir = join(projectTypesDir, type);
+    if (exists(typeDir)) merge(classify(typeDir, workflowsDir, envOpts, srcText), type);
+
+    const serverDeployDir = join(typeDir, "server-deploy");
+    if (exists(serverDeployDir) && !includeNexus) {
+      merge(classify(serverDeployDir, workflowsDir, envOpts, srcText), type);
+    }
+
+    const nexusDir = join(typeDir, "nexus");
+    if (exists(nexusDir) && includeNexus) {
+      merge(classify(nexusDir, workflowsDir, envOpts, srcText), type);
+    }
+  }
+
+  return plan;
+}

package/src/core/version-yml.js

@@ -7,7 +7,7 @@
 // 구 synology 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다.
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
-  const out = { nexus: null, secretBackup: null, coderabbit: null };
+  const out = { nexus: null, secretBackup: null, coderabbit: null, semverAuto: null };
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
   const strip = (s) => String(s).replace(/["']/g, "").trim();
   let inTemplate = false;
@@ -37,6 +37,13 @@ export function parseTemplateOptions(content) {
         if (v === "false") out.coderabbit = false;
         continue;
       }
+      m = line.match(/^\s+semver_auto:\s*(.+)/);
+      if (m) {
+        const v = strip(m[1]);
+        if (v === "true") out.semverAuto = true;
+        if (v === "false") out.semverAuto = false;
+        continue;
+      }
       // 들여쓰기 0~4칸의 다른 키 → options 섹션 종료 (.sh L2404~2408)
       if (/^\s{0,4}[a-z_]+:/.test(line)) { inOptions = false; inTemplate = false; }
     }
@@ -137,7 +144,7 @@ export function buildVersionYml({
   const b = branches || { main: branch || "main", develop: "develop", mode: "pr-flow" };
   const {
     templateVersion = "unknown", includeNexus = false, includeSecretBackup = false,
-    includeCodeRabbit = false, optionsDate = today,
+    includeCodeRabbit = false, includeSemverAuto = true, optionsDate = today,
   } = templateOptions || {};
 
   // project_paths 블록 (full-line 토큰 {{PROJECT_PATHS}} — 없으면 라인 제거)
@@ -171,7 +178,7 @@ export function buildVersionYml({
     TEMPLATE_VERSION: templateVersion,
     MAIN_BRANCH: b.main, DEVELOP_BRANCH: b.develop, BRANCH_MODE: b.mode,
     OPT_NEXUS: String(includeNexus), OPT_SECRET_BACKUP: String(includeSecretBackup),
-    OPT_CODERABBIT: String(includeCodeRabbit),
+    OPT_CODERABBIT: String(includeCodeRabbit), OPT_SEMVER_AUTO: String(includeSemverAuto),
   };
 
   const out = [];

package/src/index.js

@@ -20,6 +20,9 @@ import { runVersion } from "./commands/version.js";
 import { runWorkflows } from "./commands/workflows.js";
 import { runRevert } from "./commands/revert.js";
 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";
 
 // 패키지 버전 읽기 (-v/--version 출력용). src/../package.json.
 function readPkgVersion() {
@@ -58,6 +61,11 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
 
   // 대화형 모드 — 인자 없이 실행 or --mode interactive
   if (opts.mode === "interactive") {
+    // --dry-run은 대화형 모드에서 조용히 무시되면 안 됨(실제 설치가 진행돼버림) — 명시 에러로 차단.
+    if (opts.dryRun) {
+      console.error("--dry-run은 --mode <full|version|workflows|revert>와 함께 사용하세요 (대화형 모드에서는 지원하지 않습니다).");
+      return 1;
+    }
     if (!process.stdout.isTTY) {
       console.error("대화형 입력이 불가능한 환경입니다. --mode <full|version|workflows|revert> 와 --force 를 지정하세요.");
       return 1;
@@ -67,17 +75,33 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
 
   // revert 모드 — payload 유래 파일 제거 (감지·질문 불필요, --force 게이트만)
   if (opts.mode === "revert") {
-    if (!opts.force && !process.stdout.isTTY) {
+    // --dry-run은 파일을 쓰지 않으므로 --force 게이트를 우회한다 (status/doctor와 동일한 안전성).
+    if (!opts.force && !opts.dryRun && !process.stdout.isTTY) {
       console.error("비대화형 환경에서는 --force 옵션이 필요합니다.");
       return 1;
     }
+    if (opts.dryRun) {
+      printDryRun(planDryRun("revert", {}, payload, cwd));
+      return 0;
+    }
     const r = runRevert({}, payload, cwd);
     console.error(`제거됨 — 워크플로우 ${r.workflows.length}개, 스크립트 ${r.scripts.length}개${r.coderabbit ? ", .coderabbit.yaml" : ""}`);
     console.error("version.yml·README·.gitignore는 보존됩니다 (사용자 데이터).");
     return 0;
   }
+  // status 모드 — 읽기 전용, TTY/--force 무관하게 항상 동작
+  if (opts.mode === "status") {
+    printStatus(runStatus(payload, cwd));
+    return 0;
+  }
+  // doctor 모드 — 읽기 전용, TTY/--force 무관하게 항상 동작
+  if (opts.mode === "doctor") {
+    printDoctorReport(runDoctor(cwd));
+    return 0;
+  }
   // 명시 모드인데 --force 없으면 (비대화형 CLI는 --force 필요)
-  if (!opts.force && !process.stdout.isTTY) {
+  // --dry-run은 파일을 쓰지 않으므로 --force 게이트를 우회한다 (status/doctor와 동일한 안전성).
+  if (!opts.force && !opts.dryRun && !process.stdout.isTTY) {
     console.error("비대화형 환경에서는 --force 옵션이 필요합니다.");
     return 1;
   }
@@ -107,7 +131,7 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
   });
   // pr-flow에서 develop이 원격에 없으면 자동 생성+push (--force 비대화형 — 질문 없음).
   // 원격 목록을 못 읽는 환경(git 없음·origin 없음)은 remoteBranches=[]지만 push 실패를 조용히 보고.
-  if (branches.mode === "pr-flow") {
+  if (branches.mode === "pr-flow" && !opts.dryRun) {
     const remoteBranches = await detectRemoteBranches(cwd);
     if (remoteBranches.length && !remoteBranches.includes(branches.develop)) {
       await ensureDevelopBranch({
@@ -127,6 +151,10 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
     includeNexus: opts.includeNexus ?? existing?.options?.nexus ?? false,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
     includeCodeRabbit: opts.includeCodeRabbit ?? existing?.options?.coderabbit ?? false,
+    // 기존 version.yml이 있는데 semver_auto 키가 아예 없었던 경우(신규 기능 추가 이전 설치·
+    // workflows-only 재실행) 조용히 true로 켜지면 애매한 커밋 하나로 major가 승격될 위험이 있다 —
+    // 기존 설치는 false로 안전하게 폴백, 완전 신규 설치만 true(기존 설계) 유지.
+    includeSemverAuto: opts.includeSemverAuto ?? existing?.options?.semverAuto ?? (existing ? false : true),
     repoName,
     // 실 resolver 4종 (.sh resolve_token 등가)
     resolvers: makeResolvers(cwd, repoName, paths),
@@ -142,6 +170,11 @@ export async function run(argv, { cwd = process.cwd(), payloadRoot, clock } = {}
   const proceed = await runBreakingCheck({ cwd, payloadRoot: payload, templateVersion: context.templateVersion });
   if (!proceed) return 0;
 
+  if (opts.dryRun) {
+    printDryRun(planDryRun(opts.mode, context, payload, cwd));
+    return 0;
+  }
+
   let result = null;
   switch (opts.mode) {
     case "full": result = runFull(context, payload, cwd); break;