project-auto-wizard 0.1.34 → 0.3.0

package/src/core/detect-fs.js

@@ -3,7 +3,7 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, basename } from "node:path";
 import { execFileSync } from "node:child_process";
-import { detectTypesFromMarkers, detectVersionFromFiles, detectBuildNumberFromFiles } from "./detect.js";
+import { detectTypesFromMarkers, detectVersionFromFiles, detectBuildNumberFromFiles, detectJdkFromFiles, resolveMarkers } from "./detect.js";
 import { parseExisting } from "./version-yml.js";
 
 const hasFile = (root) => (rel) => existsSync(join(root, rel));
@@ -28,11 +28,25 @@ export function detectTypes(root) {
 }
 
 // 버전 감지 — .sh detect_version 순서. jq는 package.json 파싱에 쓰인 적이 없어 게이트를 제거했다(이슈 #22 L4).
-export function detectVersion(root, { warn = (m) => console.error(m) } = {}) {
+// hint: 폴백 경고에 붙일 해결 방법 안내 (대화형/CLI가 다르다 — 이슈 #80).
+export function detectVersion(root, { warn = (m) => console.error(m), hint } = {}) {
   const read = readFile(root);
   const readJson = (rel) => { const c = read(rel); try { return c ? JSON.parse(c) : null; } catch { return null; } };
   const gitTag = gitOut(root, ["describe", "--tags", "--abbrev=0"]);
-  return detectVersionFromFiles({ read, readJson, gitTag, warn });
+  return detectVersionFromFiles({ read, readJson, gitTag, warn, hint });
+}
+
+// 타입별 실제 마커 파일 (이슈 #77) — 감지 로그·설치 로그가 같은 근거 파일을 인용하도록.
+export function detectMarkers(root, types = []) {
+  return resolveMarkers(types, hasFile(root));
+}
+
+// 빌드 JDK 감지 (이슈 #82) — 배포 워크플로우 JAVA_VERSION 기본값에 실측값을 쓰기 위해.
+// base: 모노레포에서 spring 프로젝트 루트 (레포 루트 기준 상대경로).
+export function detectJdk(root, base = ".") {
+  const rel = base && base !== "." ? (r) => `${base}/${r}` : (r) => r;
+  const read = readFile(root);
+  return detectJdkFromFiles({ read: (r) => read(rel(r)) });
 }
 
 // 빌드 번호 감지 — 신규 통합 시 pubspec.yaml/build.gradle/app.json에서 실제 빌드 번호를 읽는다 (이슈 #41).
@@ -65,23 +79,34 @@ export function detectRepoName(root) {
 // Spring application*.yml 탐색 (.sh resolve_spring_app_yml_dir/path L2767~2780 등가)
 // find {base} -path "*/src/main/resources/application*.yml" | head -1 의 fs 재귀 구현.
 // 반환: root 기준 상대경로 (예: "server/src/main/resources/application.yml") 또는 "".
+//
+// .yaml도 인정한다 (이슈 #81). Spring은 .yml/.yaml을 모두 공식 지원하는데 종전 정규식이
+// .yml만 봐서, application.yaml을 쓰는 프로젝트는 이 값이 빈 문자열이 되고 그 결과
+// __APPLICATION_YML_DIR__ 가 치환되지 않은 채 설치됐다.
+//
+// 같은 디렉토리에서는 프로파일 없는 기본 파일(application.yml/.yaml)을 우선한다. 파일명 정렬만
+// 쓰면 'application-dev.yml'이 'application.yml'보다 앞서(`-` < `.`) 프로파일 파일이 잡힌다.
 export function findSpringAppYml(root, base = ".") {
   const startRel = base === "." ? "" : base;
   const PRUNE = new Set(["node_modules", ".git", "build", ".gradle", "target", ".idea"]);
+  const APP_YML = /^application(-[^/]*)?\.ya?ml$/;
   let hit = "";
+  let hitIsBase = false;
   const walk = (rel, depth) => {
-    if (hit || depth > 8) return; // head -1 등가 — 첫 매치에서 중단
+    if (hitIsBase || depth > 8) return; // 기본 파일을 찾았으면 더 볼 필요가 없다
     let entries;
     try { entries = readdirSync(join(root, rel), { withFileTypes: true }); } catch { return; }
     // 정렬로 순회 순서 결정화 (find 순서 플랫폼 편차 제거)
     for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-      if (hit) return;
+      if (hitIsBase) return;
       const childRel = rel ? `${rel}/${e.name}` : e.name;
       if (e.isDirectory()) {
         if (PRUNE.has(e.name)) continue;
         walk(childRel, depth + 1);
-      } else if (/^application.*\.yml$/.test(e.name) && childRel.includes("src/main/resources/")) {
-        hit = childRel;
+      } else if (APP_YML.test(e.name) && childRel.includes("src/main/resources/")) {
+        const isBase = /^application\.ya?ml$/.test(e.name);
+        // 첫 매치는 일단 채택하고, 이후 기본 파일이 나오면 그걸로 승격한다.
+        if (!hit || isBase) { hit = childRel; hitIsBase = isBase; }
       }
     }
   };
@@ -95,6 +120,10 @@ export function makeResolvers(root, repoName, paths) {
   const springBase = (t) => paths.get(t || "spring") || paths.get("spring") || ".";
   return {
     repo: () => repoName,
+    // 빌드 JDK (이슈 #82) — 배포 워크플로우 JAVA_VERSION의 기본값. 프로젝트 툴체인을 실측한다.
+    // ⚠️ 빈 문자열을 돌려주면 setEnvLine이 그 줄을 건너뛰어 __JAVA_VERSION__이 그대로 남는다
+    //    (이슈 #81과 같은 실패 형태). 감지 실패 시 반드시 종전 기본값 21로 폴백한다.
+    jdk: (t) => detectJdk(root, springBase(t)) || "21",
     "spring-app-yml-dir": (t) => {
       const f = findSpringAppYml(root, springBase(t));
       return f ? f.split("/").slice(0, -1).join("/") : "";

package/src/core/detect.js

@@ -36,7 +36,9 @@ const VERSION_RE = /^\d+\.\d+\.\d+$/;
 
 // 버전 감지 (동작명세 §3.3) — 순서대로 첫 성공. read(relpath)=>string|null 주입.
 // package.json은 이미 Node JSON.parse로 파싱을 마친 값이므로 jq 설치 여부와 무관하게 항상 사용한다(이슈 #22 L4).
-export function detectVersionFromFiles({ read, readJson, gitTag, warn }) {
+// hint: 폴백 경고 뒤에 붙일 "그럼 어떻게 고치나" 한 줄. 대화형과 CLI가 서로 다른 방법을
+// 안내해야 하므로(이슈 #80) 호출부가 정한다. 미지정 시 CLI 문구를 쓴다.
+export function detectVersionFromFiles({ read, readJson, gitTag, warn, hint }) {
   const pkg = readJson?.("package.json");
   if (pkg?.version && VERSION_RE.test(pkg.version)) return pkg.version;
   const grab = (content, re) => {
@@ -47,14 +49,29 @@ export function detectVersionFromFiles({ read, readJson, gitTag, warn }) {
     return null;
   };
   let v;
-  if ((v = grab(read("build.gradle"), /version\s*=\s*["']?(\d+\.\d+\.\d+)/))) return v;
+  const gradleRe = /version\s*=\s*["']?(\d+\.\d+\.\d+)/;
+  // Groovy DSL과 Kotlin DSL은 같은 문법(`version = "x.y.z"`)이라 정규식을 공유한다.
+  // .kts를 빼먹으면 Kotlin DSL Spring 프로젝트가 전부 0.0.1로 초기화된다 (이슈 #77).
+  if ((v = grab(read("build.gradle"), gradleRe))) return v;
+  if ((v = grab(read("build.gradle.kts"), gradleRe))) return v;
+  if ((v = versionFromPom(read("pom.xml")))) return v;
   if ((v = grab(read("pubspec.yaml"), /^version:\s*(\d+\.\d+\.\d+)/))) return v;
   if ((v = grab(read("pyproject.toml"), /version\s*=\s*["']?(\d+\.\d+\.\d+)/))) return v;
   if (gitTag) { const t = String(gitTag).replace(/^v/, ""); if (VERSION_RE.test(t)) return t; }
-  warn?.("⚠️  버전을 자동 감지하지 못해 기본값 0.0.1을 사용합니다 — --project-version으로 직접 지정하거나 version.yml을 확인하세요.");
+  const tail = hint ?? "--project-version으로 직접 지정하거나 version.yml을 확인하세요.";
+  warn?.(`⚠️  버전을 자동 감지하지 못해 기본값 0.0.1을 사용합니다 — ${tail}`);
   return "0.0.1";
 }
 
+// Maven pom.xml의 프로젝트 버전 (이슈 #77). <parent> 블록 안의 버전은 스프링 부트 BOM 버전이라
+// 프로젝트 버전이 아니다 — 그 구간을 지운 뒤 첫 <version>을 읽는다.
+export function versionFromPom(content) {
+  if (!content) return null;
+  const body = String(content).replace(/<parent>[\s\S]*?<\/parent>/g, "");
+  const m = body.match(/<version>\s*(\d+\.\d+\.\d+)[^<]*<\/version>/);
+  return m ? m[1] : null;
+}
+
 export function markerForType(type) {
   return { flutter: "pubspec.yaml", "react-native-expo": "app.json", python: "pyproject.toml", spring: "build.gradle" }[type] || "package.json";
 }
@@ -63,6 +80,54 @@ export function extraMarkers(type) {
   return { python: ["setup.py", "requirements.txt"], spring: ["build.gradle.kts", "pom.xml"] }[type] || [];
 }
 
+// 그 타입을 감지하는 데 실제로 쓰인 파일 (이슈 #77). markerForType은 타입당 대표 파일 하나를
+// 고정 반환하므로, build.gradle.kts만 있는 레포에서도 "build.gradle 발견"이라고 출력돼
+// 같은 설치 로그 안에서 경로 확정 화면과 파일명이 어긋났다. has()로 실재하는 것을 고른다.
+// 실재하는 후보가 없으면(감지 전 화면 등) 대표 파일을 쓴다.
+export function resolveMarker(type, has) {
+  const candidates = [markerForType(type), ...extraMarkers(type)];
+  return candidates.find(has) ?? candidates[0];
+}
+
+// 빌드 JDK 감지 (이슈 #82) — 배포 워크플로우의 JAVA_VERSION 기본값이 21로 고정돼 있어
+// toolchain이 다른 프로젝트(예: 25)는 그대로 Enter를 누르면 러너 JDK와 어긋나 빌드가 깨진다.
+// 빌드 번호를 프로젝트 파일에서 읽는 detectBuildNumberFromFiles와 같은 방식으로 실측한다.
+// 반환: "21" 같은 메이저 버전 문자열, 못 찾으면 null.
+export function detectJdkFromFiles({ read }) {
+  const pick = (content, patterns) => {
+    if (!content) return null;
+    for (const re of patterns) {
+      const m = String(content).match(re);
+      // JavaVersion.VERSION_1_8 처럼 1_8 표기는 8로 정규화한다.
+      if (m) return m[1] === "1_8" ? "8" : m[1].replace("1_", "");
+    }
+    return null;
+  };
+  const gradlePatterns = [
+    /JavaLanguageVersion\.of\((\d+)\)/,                  // toolchain (Gradle 권장 표기)
+    /JavaVersion\.VERSION_(\d+(?:_\d+)?)/,               // sourceCompatibility = JavaVersion.VERSION_21
+    /(?:source|target)Compatibility\s*=?\s*["'](\d+)["']/, // sourceCompatibility = '17'
+  ];
+  let v;
+  if ((v = pick(read("build.gradle.kts"), gradlePatterns))) return v;
+  if ((v = pick(read("build.gradle"), gradlePatterns))) return v;
+  if ((v = pick(read("pom.xml"), [
+    /<java\.version>\s*(\d+(?:\.\d+)?)\s*<\/java\.version>/,
+    /<maven\.compiler\.(?:source|release)>\s*(\d+(?:\.\d+)?)\s*<\//,
+  ]))) return v.replace(/^1\./, "");
+  return null;
+}
+
+// 타입별 실제 마커 파일 맵 — 감지 로그·설치 로그가 같은 근거를 쓰도록 한 곳에서 만든다.
+export function resolveMarkers(types = [], has) {
+  const out = new Map();
+  for (const t of types) {
+    if (t === "basic") continue;
+    out.set(t, resolveMarker(t, has));
+  }
+  return out;
+}
+
 // 빌드 번호 감지 (이슈 #41) — 신규 통합 시 pubspec.yaml/build.gradle/app.json에 이미 기록된
 // 빌드 번호를 읽어 version_code가 항상 1로 초기화되는 걸 막는다. types 배열에서 먼저 매칭되는
 // 첫 타입만 사용한다(다른 감지 로직의 types[0]=primary 관례와 동일). read(rel)=>string|null,

package/src/core/install-log.js

@@ -0,0 +1,182 @@
+// 설치 로그 (이슈 #79) — 실행마다 "무엇을 어떤 값으로 설치했는지"를 레포에 한 건 남긴다.
+//
+// 왜 필요한가: version.yml에는 버전·타입·경로·브랜치·옵션만 남는다. 감지 근거, 질문별 답변,
+// 특히 환경설정 답변(도메인·포트·볼륨 경로)은 워크플로우 YAML 안으로 흩어질 뿐 한 곳에
+// 기록되지 않아, 배포가 실패했을 때 "설치할 때 뭘로 답했더라"를 역추적할 방법이 없었다.
+// 터미널 스크롤백은 에이전트가 볼 수 없고 다른 클론에도 남지 않는다.
+//
+// 위치는 .github/.wizard/ 아래 — 마법사가 이미 baseline.json을 두는 자기 메타데이터 폴더다.
+// 새 최상위 폴더를 만들 이유가 없고, 삭제 모드에서도 경계가 이 폴더 하나로 끝난다.
+import { join } from "node:path";
+import { writeText } from "./fsutil.js";
+
+export const LOG_DIR = ".github/.wizard/logs";
+
+// 값에 비밀이 들어갈 수 있는 키 — 현재 질문 항목에는 없지만(도메인·경로·포트·인증 '방식'),
+// 앞으로 추가될 때 그냥 평문으로 커밋되지 않도록 처음부터 걸어둔다. 이 파일은 커밋 대상이다.
+const SECRET_KEY_RE = /(PASSWORD|SECRET|TOKEN|KEY|CREDENTIAL)/i;
+const MASK = "***";
+
+export function maskValue(key, value) {
+  // SSH_AUTH_METHOD처럼 "방식"만 담는 키는 비밀이 아니다 — 이름에 KEY가 들어가도 마스킹하지 않는다.
+  if (key === "SSH_AUTH_METHOD") return value;
+  return SECRET_KEY_RE.test(key) ? MASK : value;
+}
+
+// "2026-08-12 18:15:30" → "20260812-181530". 파일명이 곧 정렬 키가 되도록.
+export function stampFrom(now = "") {
+  const m = String(now).match(/(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2}):(\d{2})/);
+  if (!m) return "unknown";
+  return `${m[1]}${m[2]}${m[3]}-${m[4]}${m[5]}${m[6]}`;
+}
+
+export function logFilename(now, action = "install") {
+  return `${stampFrom(now)}-${action}.md`;
+}
+
+const yamlStr = (v) => `"${String(v ?? "").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+const yamlList = (arr) => `[${(arr || []).map(yamlStr).join(", ")}]`;
+
+// 마크다운 렌더 — 상단은 기계가 읽는 front matter, 아래는 사람이 읽는 본문.
+// 에이전트가 파싱만 해도 핵심을 얻고, 사람이 열면 그대로 읽힌다.
+export function renderInstallLog(d = {}) {
+  const {
+    action = "install", at = "", templateVersion = "",
+    previousTemplateVersion = "", mode = "", types = [], markers = new Map(),
+    version = "", branch = "", branches = null, paths = new Map(),
+    options = {}, answers = [], result = {}, unresolved = [], secrets = new Map(),
+    warnings = [], cleanup = null,
+  } = d;
+
+  const L = [];
+  L.push("---");
+  L.push(`action: ${yamlStr(action)}`);
+  L.push(`at: ${yamlStr(at)}`);
+  L.push(`template_version: ${yamlStr(templateVersion)}`);
+  if (previousTemplateVersion) L.push(`previous_template_version: ${yamlStr(previousTemplateVersion)}`);
+  L.push(`mode: ${yamlStr(mode)}`);
+  L.push(`project_types: ${yamlList(types)}`);
+  L.push(`version: ${yamlStr(version)}`);
+  L.push(`default_branch: ${yamlStr(branch)}`);
+  if (branches) {
+    L.push(`branches: { main: ${yamlStr(branches.main)}, develop: ${yamlStr(branches.develop)}, mode: ${yamlStr(branches.mode)} }`);
+  }
+  L.push(`unresolved_count: ${unresolved.length}`);
+  L.push(`required_secrets: ${yamlList([...secrets.keys()])}`);
+  L.push("---");
+  L.push("");
+  L.push(`# 설치 로그 — ${at}`);
+  L.push("");
+  L.push("project-auto-wizard가 이 레포에 무엇을 설치했는지 남긴 기록입니다. 직접 편집하지 마세요.");
+  L.push("");
+
+  L.push("## 실행");
+  L.push("");
+  L.push("| 항목 | 값 |");
+  L.push("|---|---|");
+  L.push(`| 동작 | ${action === "install" ? "신규 설치" : action === "update" ? "업데이트" : action} |`);
+  L.push(`| 템플릿 버전 | ${previousTemplateVersion ? `${previousTemplateVersion} → ${templateVersion}` : templateVersion || "-"} |`);
+  L.push(`| 설치 모드 | ${mode || "-"} |`);
+  L.push("");
+
+  L.push("## 감지 결과");
+  L.push("");
+  L.push("| 항목 | 값 | 근거 |");
+  L.push("|---|---|---|");
+  for (const t of types) {
+    L.push(`| 타입 | ${t} | ${markers?.get?.(t) || "직접 선택"} |`);
+  }
+  L.push(`| 버전 | ${version} | ${d.versionSource || "자동 감지"} |`);
+  L.push(`| 브랜치 | ${branch} | git |`);
+  for (const [t, p] of paths) L.push(`| 경로 (${t}) | ${p} | |`);
+  L.push("");
+  if (warnings.length) {
+    L.push("감지 중 경고:");
+    L.push("");
+    for (const w of warnings) L.push(`- ${w}`);
+    L.push("");
+  }
+
+  L.push("## 선택 항목");
+  L.push("");
+  L.push("| 항목 | 값 |");
+  L.push("|---|---|");
+  L.push(`| 라이브러리 publish (Nexus·GitHub Packages) | ${options.nexus ? "포함" : "제외"} |`);
+  L.push(`| Secret 서버 백업 | ${options.secretBackup ? "포함" : "제외"} |`);
+  L.push(`| 자동 버전 승격 | ${options.semverAuto === false ? "사용 안 함" : "사용"} |`);
+  L.push(`| 서버 배포 방식 | ${options.deployStyle || "-"} |`);
+  L.push("");
+
+  L.push("## 환경설정 답변");
+  L.push("");
+  if (!answers.length) {
+    L.push("이 설치에서는 환경설정 질문이 없었습니다.");
+  } else {
+    L.push("`기본값` 열이 `예`면 질문에서 그대로 Enter를 누른 값입니다. 배포가 예상과 다르게 동작하면 여기부터 확인하세요.");
+    L.push("");
+    L.push("| 키 | 항목 | 값 | 기본값 | 사용처 |");
+    L.push("|---|---|---|---|---|");
+    for (const a of answers) {
+      L.push(`| \`${a.key}\` | ${a.label} | \`${maskValue(a.key, a.value)}\` | ${a.isDefault ? "예" : "아니오"} | ${a.scope || ""} |`);
+    }
+  }
+  L.push("");
+
+  L.push("## 설치 결과");
+  L.push("");
+  const sec = (title, items, fmt = (x) => `- \`${x}\``) => {
+    if (!items || !items.length) return;
+    L.push(`### ${title} (${items.length})`);
+    L.push("");
+    for (const it of items) L.push(fmt(it));
+    L.push("");
+  };
+  sec("새로 설치된 파일", result.copiedFiles);
+  sec("이전 배포 방식 정리 — 삭제", cleanup?.removed);
+  sec("이전 배포 방식 정리 — .bak 백업 (수정 내용 보존)", cleanup?.backedUp);
+  sec("건너뛴 파일", result.skippedFiles);
+  sec("백업 후 교체한 파일", result.backupFiles);
+  if (result.gitignoreUpdated) { L.push("`.gitignore`를 갱신했습니다 (충돌 백업 파일 무시 항목 추가)."); L.push(""); }
+
+  L.push("## 남은 할 일");
+  L.push("");
+  if (unresolved.length) {
+    L.push("### ⚠️ 값이 채워지지 않은 항목");
+    L.push("");
+    L.push("마법사가 값을 계산하지 못해 플레이스홀더가 그대로 남았습니다. **이 상태로는 해당 워크플로우가 정상 동작하지 않습니다.** 직접 채워 주세요.");
+    L.push("");
+    L.push("| 파일 | 줄 | 토큰 |");
+    L.push("|---|---|---|");
+    for (const u of unresolved) L.push(`| \`${u.filename}\` | ${u.line} | \`${u.token}\` |`);
+    L.push("");
+  }
+  if (secrets.size) {
+    L.push("### 등록해야 하는 GitHub Secret");
+    L.push("");
+    L.push("Settings > Secrets and variables > Actions 에서 등록합니다. 등록 전에는 해당 워크플로우가 실패합니다.");
+    L.push("");
+    L.push("| Secret | 사용하는 워크플로우 |");
+    L.push("|---|---|");
+    for (const [name, users] of secrets) L.push(`| \`${name}\` | ${users.map((u) => `\`${u}\``).join(", ")} |`);
+    L.push("");
+  }
+  if (!unresolved.length && !secrets.size) {
+    L.push("추가로 조치할 항목이 없습니다.");
+    L.push("");
+  }
+
+  return L.join("\n") + "\n";
+}
+
+// 로그 기록. 실패해도 설치 자체는 성공으로 끝나야 하므로 예외를 삼키고 null을 돌려준다 —
+// 로그를 못 남긴 것이 설치를 되돌릴 이유는 아니다.
+export function writeInstallLog(targetRoot, data = {}) {
+  try {
+    const filename = logFilename(data.at, data.action || "install");
+    const rel = `${LOG_DIR}/${filename}`;
+    writeText(join(targetRoot, rel), renderInstallLog(data));
+    return { path: rel };
+  } catch {
+    return null;
+  }
+}

package/src/core/options-ask.js

@@ -82,8 +82,11 @@ export async function askAllOptionalWorkflows({
   // ② Nexus: 각 타입의 nexus/ 폴더 (현재 spring만 존재, .sh L2719~2725)
   for (const t of types) {
     nexus = await askOptionalWorkflow({
-      dir: join(ptDir, t, "nexus"), icon: "📦", short: "Nexus 라이브러리 publish",
-      desc: "라이브러리/모듈을 Maven 저장소(Nexus)에 배포하는 워크플로우입니다. 일반 서버 배포가 아니라 라이브러리 프로젝트에만 필요합니다.",
+      // GitHub Packages publish도 같은 '라이브러리 배포' 계열이라 이 질문이 함께 관장한다 (이슈 #80).
+      // 종전에는 Nexus만 묻고 GitHub Packages는 무조건 설치돼, "라이브러리 배포 필요 없다"고
+      // 답한 사용자에게 라이브러리 배포 워크플로우가 깔렸다.
+      dir: join(ptDir, t, "nexus"), icon: "📦", short: "라이브러리 publish (Nexus · GitHub Packages)",
+      desc: "라이브러리/모듈을 Maven 저장소(Nexus)나 GitHub Packages에 배포하는 워크플로우입니다. 일반 서버 배포가 아니라 라이브러리 프로젝트에만 필요합니다. 포함하면 서버 배포 워크플로우는 설치되지 않습니다.",
       current: nexus, force, tty, io, forceAsk, say,
     });
   }

package/src/core/paths-resolve.js

@@ -9,7 +9,7 @@
 //   io.log(line)                                   → 안내 출력 (없으면 stderr)
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
-import { markerForType as baseMarkerForType, extraMarkers } from "./detect.js";
+import { markerForType as baseMarkerForType, resolveMarker } from "./detect.js";
 import { normalizePath, CliError } from "../cli/args.js";
 
 // 취소(ESC/Ctrl+C)는 CANCEL 심볼 — ui를 import하지 않고 심볼 여부로만 판정 (core→ui 역참조 방지)
@@ -24,15 +24,11 @@ export function markerForType(type) {
   return KNOWN_MARKER_TYPES.has(type) ? baseMarkerForType(type) : "";
 }
 
-// 디렉토리에 실재하는 마커 파일명 반환 — 보조 마커 포함, 없으면 대표 마커 (표시용).
+// 디렉토리에 실재하는 마커 파일명 반환 — resolveMarker의 fs 구동판.
 // (.sh existing_marker_in_dir L1232~1245: spring build.gradle/.kts/pom.xml, python pyproject/setup.py/requirements.txt)
 export function existingMarkerInDir(type, dir) {
-  const primary = markerForType(type);
-  const names = primary ? [primary, ...extraMarkers(type)] : [];
-  for (const n of names) {
-    if (existsSync(join(dir, n))) return n;
-  }
-  return primary;
+  if (!markerForType(type)) return ""; // .sh 등가: 미지 타입은 빈 문자열
+  return resolveMarker(type, (n) => existsSync(join(dir, n)));
 }
 
 // maxdepth 3 재귀 파일 탐색 — 매치 파일의 "디렉토리" 상대경로(루트는 ".")를 수집.

package/src/core/removal-plan.js

@@ -16,6 +16,7 @@
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { PATHS, PAYLOAD } from "./paths.js";
+import { BASELINE_DIR, BASELINE_PATH } from "./baseline.js";
 
 // payload/workflows/**/*.yaml 첫 줄에 심어둔 고정 마커 — 이 값이 바뀌면 과거 설치분과의 매칭이 끊긴다.
 export const MANAGED_WORKFLOW_MARKER = "# project-auto-wizard:managed-workflow";
@@ -62,8 +63,11 @@ export function planRemoval(payloadRoot, targetRoot = ".") {
     // (b) 관리 마커로 시작하는 것 — payload에서 이름이 바뀌거나 삭제된 파일도 인식 (issue #20 L12).
     for (const name of markedWorkflowNames(wfDir)) removedWf.add(name);
   }
-  for (const s of ["version_manager.py", "changelog_manager.py"]) {
+  for (const s of ["version_manager.py", "changelog_manager.py", "truncate_release_notes.py", "issue_helper.py"]) {
     if (existsSync(join(targetRoot, PATHS.scriptsDir, s))) removedScripts.push(s);
   }
-  return { workflows: [...removedWf], scripts: removedScripts };
+  // baseline은 마법사가 만든 내부 상태 파일이다 — 설치물을 지우면 함께 사라져야 한다.
+  // 남겨두면 다음 설치가 "예전에 깔았다가 사용자가 지운 파일"로 오인해 전부 removed로 분류한다.
+  const baseline = existsSync(join(targetRoot, BASELINE_PATH)) ? [BASELINE_DIR] : [];
+  return { workflows: [...removedWf], scripts: removedScripts, baseline };
 }

package/src/core/verify.js

@@ -0,0 +1,86 @@
+// 설치 후 검증 (이슈 #81, #80) — 설치된 워크플로우를 다시 읽어 "이대로 돌아가는가"를 본다.
+//
+// 왜 설치 전이 아니라 후인가: 치환은 파일 단위로 흩어져 일어나고 auto 토큰은 resolver 결과에
+// 의존한다. 최종 디스크 내용을 보는 것이 실제로 배포될 것과 같은 것을 보는 유일한 방법이다.
+import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+
+// 치환 대상이 아닌 토큰 — 워크플로우 스크립트 안의 heredoc 구분자다. 값이 아니라 문법이므로
+// 미치환 검사에서 제외한다. (예: cat <<'__SUH_FILE_CONTENT_EOF__')
+const SENTINEL_RE = /^__SUH_[A-Z0-9_]*__$/;
+const PLACEHOLDER_RE = /__[A-Z][A-Z0-9_]*__/g;
+
+// 주석으로 죽어 있는 줄 — 실행되지 않으므로 검사 대상이 아니다.
+// 템플릿에는 "[선택] ..." 예시 스텝이 통째로 주석 처리돼 들어 있는데, 이걸 세면
+// 쓰지도 않는 Secret을 "등록하세요"라고 안내하게 된다.
+const isCommented = (line) => /^\s*#/.test(line);
+
+// 미치환 플레이스홀더 스캔 (이슈 #81).
+// 종전에는 auto 토큰 계산이 실패해도(예: application.yaml을 못 찾아 경로가 빈 문자열) 그 줄을
+// 건드리지 않고 넘어가, __APPLICATION_YML_DIR__ 이 그대로 남은 워크플로우가 "설치 성공"으로
+// 끝났다. 배포 시점에야 그 이름의 디렉토리가 만들어지며 문제가 드러난다.
+//
+// 반환: [{ filename, line, token, text }] — 사람이 바로 고칠 수 있게 줄 번호까지 준다.
+export function scanUnsubstituted(workflowsDir, filenames = []) {
+  const found = [];
+  for (const filename of filenames) {
+    const p = join(workflowsDir, filename);
+    if (!existsSync(p)) continue;
+    let content;
+    try { content = readFileSync(p, "utf8"); } catch { continue; }
+    content.split(/\r?\n/).forEach((text, i) => {
+      if (isCommented(text)) return;
+      for (const token of text.match(PLACEHOLDER_RE) || []) {
+        if (SENTINEL_RE.test(token)) continue;
+        found.push({ filename, line: i + 1, token, text: text.trim() });
+      }
+    });
+  }
+  return found;
+}
+
+// GITHUB_TOKEN은 Actions가 자동 주입하므로 사용자가 등록할 대상이 아니다.
+const AUTO_SECRETS = new Set(["GITHUB_TOKEN"]);
+// 없어도 워크플로우가 도는 secret — 폴백이 문서화돼 있다. 필수와 섞어 "등록해야 동작합니다"라고
+// 하면 안내 자체를 못 믿게 되므로 분리한다.
+//   AI_API_KEY   → 없으면 GitHub Models(무료) → 규칙 fallback
+//   WORKFLOW_PAT → 없으면 GITHUB_TOKEN
+export const OPTIONAL_SECRETS = new Set(["AI_API_KEY", "WORKFLOW_PAT"]);
+const SECRET_RE = /secrets\.([A-Z][A-Z0-9_]*)/g;
+
+// 설치된 워크플로우가 요구하는 GitHub Secret 목록 (이슈 #80).
+// 완료 화면이 WORKFLOW_PAT와 권한만 안내하는 바람에, 배포 워크플로우가 실제로 필요로 하는
+// SERVER_HOST·SSH_KEY 같은 값이 하나도 안내되지 않았다. 설치 직후 상태로는 배포가 돌지 않는데
+// 그 사실이 어디에도 드러나지 않는다.
+//
+// 반환: Map<secretName, string[] 그 secret을 쓰는 파일명>
+export function collectRequiredSecrets(workflowsDir, filenames = []) {
+  const out = new Map();
+  for (const filename of filenames) {
+    const p = join(workflowsDir, filename);
+    if (!existsSync(p)) continue;
+    let content;
+    try { content = readFileSync(p, "utf8"); } catch { continue; }
+    for (const line of content.split(/\r?\n/)) {
+      if (isCommented(line)) continue;
+      for (const m of line.matchAll(SECRET_RE)) {
+        const name = m[1];
+        if (AUTO_SECRETS.has(name) || OPTIONAL_SECRETS.has(name)) continue;
+        if (!out.has(name)) out.set(name, []);
+        const users = out.get(name);
+        if (!users.includes(filename)) users.push(filename);
+      }
+    }
+  }
+  return new Map([...out.entries()].sort(([a], [b]) => a.localeCompare(b)));
+}
+
+// SSH 인증 방식에 따라 둘 중 하나만 필요한 secret — 사용자가 이미 답한 값으로 목록을 좁힌다.
+// 안 쓸 secret까지 "등록하세요"라고 하면 안내 자체를 신뢰하지 않게 된다.
+export function narrowSecretsBySshAuth(secrets, sshAuthMethod) {
+  if (!sshAuthMethod) return secrets;
+  const drop = sshAuthMethod === "key" ? "SERVER_PASSWORD" : "SSH_KEY";
+  const out = new Map(secrets);
+  out.delete(drop);
+  return out;
+}

package/src/core/version-yml.js

@@ -1,3 +1,4 @@
+import { DEFAULT_DEPLOY_STYLE } from "./deploy-style.js";
 import { escapeYamlDoubleQuoted } from "./wizard-env.js";
 
 // version.yml 파싱·생성 (.sh create_version_yml 등가, 전체 재생성 전략 D4).
@@ -38,9 +39,11 @@ export function parseExtraTopLevel(content) {
 // 구 synology·coderabbit 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다(파싱 에러 없음).
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
-  const out = { nexus: null, secretBackup: null, semverAuto: null };
+  const out = { nexus: null, secretBackup: null, semverAuto: null, deployStyle: null };
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
-  const strip = (s) => String(s).replace(/["']/g, "").trim();
+  // 인라인 주석(` # ...`)을 먼저 떼고 따옴표·공백을 정리한다. 문자열 값을 받는 키(deploy_style)는
+  // 주석을 안 떼면 "simple # simple | nginx ..." 가 통째로 값이 된다.
+  const strip = (s) => String(s).replace(/\s+#.*$/, "").replace(/["']/g, "").trim();
   let inTemplate = false;
   let inOptions = false;
   for (const line of String(content || "").split("\n")) {
@@ -61,6 +64,8 @@ export function parseTemplateOptions(content) {
         if (v === "false") out.secretBackup = false;
         continue;
       }
+      m = line.match(/^\s+deploy_style:\s*(.+)/);
+      if (m) { const v = strip(m[1]); if (v) out.deployStyle = v; continue; }
       m = line.match(/^\s+semver_auto:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -128,7 +133,9 @@ export function parseExisting(content) {
 
 // metadata.template.branches 블록 파싱. 셋 다 있어야 유효 — 아니면 null.
 export function parseTemplateBranches(content) {
-  const strip = (s) => String(s).replace(/["']/g, "").trim();
+  // 인라인 주석(` # ...`)을 먼저 떼고 따옴표·공백을 정리한다. 문자열 값을 받는 키(deploy_style)는
+  // 주석을 안 떼면 "simple # simple | nginx ..." 가 통째로 값이 된다.
+  const strip = (s) => String(s).replace(/\s+#.*$/, "").replace(/["']/g, "").trim();
   let inTemplate = false;
   let inBranches = false;
   const out = { main: "", develop: "", mode: "" };
@@ -168,7 +175,7 @@ export function buildVersionYml({
   const b = branches || { main: branch || "main", develop: "develop", mode: "pr-flow" };
   const {
     templateVersion = "unknown", includeNexus = false, includeSecretBackup = false,
-    includeSemverAuto = true, optionsDate = today,
+    includeSemverAuto = true, deployStyle = "", optionsDate = today,
   } = templateOptions || {};
 
   // project_paths 블록 (full-line 토큰 {{PROJECT_PATHS}} — 없으면 라인 제거)
@@ -205,6 +212,7 @@ export function buildVersionYml({
     MAIN_BRANCH: b.main, DEVELOP_BRANCH: b.develop, BRANCH_MODE: b.mode,
     OPT_NEXUS: String(includeNexus), OPT_SECRET_BACKUP: String(includeSecretBackup),
     OPT_SEMVER_AUTO: String(includeSemverAuto),
+    OPT_DEPLOY_STYLE: String(deployStyle || ""),
   };
 
   const out = [];
@@ -225,3 +233,22 @@ export function buildVersionYml({
   if (!text.endsWith("\n")) text += "\n";
   return text.replace(/\n{3,}$/, "\n"); // 말미 과잉 빈 줄 정리
 }
+
+// context 하나로 version.yml 최종형을 만든다 — 실제 설치(full)와 미리보기(dry-run)가
+// 같은 함수를 쓰게 해서 "미리보기와 결과가 다른" 상황을 구조적으로 막는다.
+// deployValues는 실제 설치에서만 존재한다(미리보기는 치환을 수행하지 않으므로 빈 Map).
+export function renderVersionYml(context, templateText, { pathMarkers, deployValues = new Map(), extraTopLevel = [] }) {
+  const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
+    now, today, templateVersion = "unknown", branches = null,
+    includeNexus = false, includeSecretBackup = false, includeSemverAuto, deployStyle } = context;
+  return buildVersionYml({
+    templateText, version, types, paths, pathMarkers, branch, branches, versionCode, now, today,
+    deployValues, extraTopLevel,
+    templateOptions: {
+      templateVersion, includeNexus, includeSecretBackup,
+      includeSemverAuto: includeSemverAuto !== false,
+      deployStyle: deployStyle || DEFAULT_DEPLOY_STYLE,
+      optionsDate: today,
+    },
+  });
+}

package/src/core/wizard-env.js

@@ -31,11 +31,14 @@ export function setEnvLine(line, key, value) {
   // CRLF 안전: 라인 끝 \r을 분리해 처리 후 복원 (autocrlf 프로젝트 대응)
   const cr = line.endsWith("\r") ? "\r" : "";
   const body = cr ? line.slice(0, -1) : line;
-  const escaped = escapeYamlDoubleQuoted(value);
   // 값 치환: KEY: "기존값" → KEY: "value"
+  // 홑따옴표(KEY: '기존값')도 받는다 — 템플릿에 두 표기가 섞여 있는데 겹따옴표만 보면
+  // 홑따옴표 줄의 @wizard 마커가 아무 경고 없이 무시된다(이슈 #81과 같은 실패 형태).
+  // 치환 결과는 겹따옴표로 통일하고, 값은 그에 맞게 이스케이프한다.
+  const escaped = escapeYamlDoubleQuoted(value);
   let out = body.replace(
-    new RegExp(`^(\\s*${key}:\\s*")[^"]*(")`),
-    (_m, p1, p2) => `${p1}${escaped}${p2}`,
+    new RegExp(`^(\\s*${key}:\\s*)(["'])(?:(?!\\2).)*\\2`),
+    (_m, head) => `${head}"${escaped}"`,
   );
   // 그 줄 끝 # @wizard ... 주석 제거 (앞 공백째)
   out = out.replace(/(\S)[^\S\r\n]*#[^\S\r\n]*@wizard[^\S\r\n].*$/, "$1");